mirror of
https://github.com/johndoe6345789/metabuilder.git
synced 2026-05-02 17:55:07 +00:00
git
49f40177b5
README.md
LICENSE
AGENTS.md
api/ # Language-agnostic contract (source of truth)
schema/
entities/ # Entity definitions (conceptual models)
user.yaml
session.yaml
...
operations/ # CRUD + domain operations (semantic, not SQL)
user.ops.yaml
...
errors.yaml # Standard error codes (conflict, not_found, etc.)
capabilities.yaml # Feature flags per backend (tx, joins, ttl, etc.)
idl/
dbal.proto # Optional: RPC/IPC contract if needed
dbal.fbs # Optional: FlatBuffers schema if you prefer
versioning/
compat.md # Compatibility rules across TS/C++
common/ # Shared test vectors + fixtures + golden results
fixtures/
seed/
datasets/
golden/
query_results/
contracts/
conformance_cases.yaml
ts/ # Development implementation in TypeScript
package.json
tsconfig.json
src/
index.ts # Public entrypoint (creates client)
core/
client.ts # DBAL client facade
types.ts # TS types mirroring api/schema
errors.ts # Error mapping to api/errors.yaml
validation/ # Runtime validation (zod/io-ts/etc.)
input.ts
output.ts
capabilities.ts # Capability negotiation
telemetry/
logger.ts
metrics.ts
tracing.ts
adapters/ # Backend implementations (TS)
prisma/
index.ts
prisma_client.ts # Wraps Prisma client (server-side only)
mapping.ts # DB <-> entity mapping, select shaping
migrations/ # Optional: Prisma migration helpers
sqlite/
index.ts
sqlite_driver.ts
schema.ts
migrations/
mongodb/
index.ts
mongo_driver.ts
schema.ts
query/ # Query builder / AST (no backend leakage)
ast.ts
builder.ts
normalize.ts
optimize.ts
runtime/
config.ts # DBAL config (env, URLs, pool sizes)
secrets.ts # Secret loading boundary (server-only)
util/
assert.ts
retry.ts
backoff.ts
time.ts
tests/
unit/
integration/
conformance/ # Runs common/contract vectors on TS adapters
harness/
setup.ts
cpp/ # Production implementation in C++
CMakeLists.txt
include/
dbal/
dbal.hpp # Public API
client.hpp # Facade
types.hpp # Entity/DTO types
errors.hpp
capabilities.hpp
telemetry.hpp
query/
ast.hpp
builder.hpp
normalize.hpp
adapters/
adapter.hpp # Adapter interface
sqlite/
sqlite_adapter.hpp
mongodb/
mongodb_adapter.hpp
prisma/
prisma_adapter.hpp # Usually NOT direct; see note below
util/
expected.hpp
result.hpp
uuid.hpp
src/
client.cpp
errors.cpp
capabilities.cpp
telemetry.cpp
query/
ast.cpp
builder.cpp
normalize.cpp
adapters/
sqlite/
sqlite_adapter.cpp
sqlite_pool.cpp
sqlite_migrations.cpp
mongodb/
mongodb_adapter.cpp
mongo_pool.cpp
prisma/
prisma_adapter.cpp # See note below (often an RPC bridge)
util/
uuid.cpp
backoff.cpp
tests/
unit/
integration/
conformance/ # Runs common/contract vectors on C++ adapters
harness/
main.cpp
backends/ # Backend-specific assets not tied to one lang
sqlite/
schema.sql
migrations/
mongodb/
indexes.json
prisma/
schema.prisma
migrations/
tools/ # Codegen + build helpers (prefer Python)
codegen/
gen_types.py # api/schema -> ts/core/types.ts and cpp/types.hpp
gen_errors.py
gen_capabilities.py
conformance/
run_all.py # runs TS + C++ conformance suites
dev/
lint.py
format.py
scripts/ # Cross-platform entrypoints (Python per your pref)
build.py
test.py
conformance.py
package.py
dist/ # Build outputs (gitignored)
.github/
workflows/
ci.yml
.gitignore
.editorconfig
81 lines
2.2 KiB
TypeScript
81 lines
2.2 KiB
TypeScript
export enum DBALErrorCode {
|
|
NOT_FOUND = 404,
|
|
CONFLICT = 409,
|
|
UNAUTHORIZED = 401,
|
|
FORBIDDEN = 403,
|
|
VALIDATION_ERROR = 422,
|
|
RATE_LIMIT_EXCEEDED = 429,
|
|
INTERNAL_ERROR = 500,
|
|
TIMEOUT = 504,
|
|
DATABASE_ERROR = 503,
|
|
CAPABILITY_NOT_SUPPORTED = 501,
|
|
SANDBOX_VIOLATION = 403,
|
|
MALICIOUS_CODE_DETECTED = 403,
|
|
}
|
|
|
|
export class DBALError extends Error {
|
|
constructor(
|
|
public code: DBALErrorCode,
|
|
message: string,
|
|
public details?: Record<string, unknown>
|
|
) {
|
|
super(message)
|
|
this.name = 'DBALError'
|
|
}
|
|
|
|
static notFound(message = 'Resource not found'): DBALError {
|
|
return new DBALError(DBALErrorCode.NOT_FOUND, message)
|
|
}
|
|
|
|
static conflict(message = 'Resource conflict'): DBALError {
|
|
return new DBALError(DBALErrorCode.CONFLICT, message)
|
|
}
|
|
|
|
static unauthorized(message = 'Authentication required'): DBALError {
|
|
return new DBALError(DBALErrorCode.UNAUTHORIZED, message)
|
|
}
|
|
|
|
static forbidden(message = 'Access forbidden'): DBALError {
|
|
return new DBALError(DBALErrorCode.FORBIDDEN, message)
|
|
}
|
|
|
|
static validationError(message: string, fields?: Array<{field: string, error: string}>): DBALError {
|
|
return new DBALError(DBALErrorCode.VALIDATION_ERROR, message, { fields })
|
|
}
|
|
|
|
static rateLimitExceeded(retryAfter?: number): DBALError {
|
|
return new DBALError(
|
|
DBALErrorCode.RATE_LIMIT_EXCEEDED,
|
|
'Rate limit exceeded',
|
|
{ retryAfter }
|
|
)
|
|
}
|
|
|
|
static internal(message = 'Internal server error'): DBALError {
|
|
return new DBALError(DBALErrorCode.INTERNAL_ERROR, message)
|
|
}
|
|
|
|
static timeout(message = 'Operation timeout'): DBALError {
|
|
return new DBALError(DBALErrorCode.TIMEOUT, message)
|
|
}
|
|
|
|
static databaseError(message = 'Database unavailable'): DBALError {
|
|
return new DBALError(DBALErrorCode.DATABASE_ERROR, message)
|
|
}
|
|
|
|
static capabilityNotSupported(feature: string): DBALError {
|
|
return new DBALError(
|
|
DBALErrorCode.CAPABILITY_NOT_SUPPORTED,
|
|
`Feature not supported: ${feature}`
|
|
)
|
|
}
|
|
|
|
static sandboxViolation(message: string): DBALError {
|
|
return new DBALError(DBALErrorCode.SANDBOX_VIOLATION, message)
|
|
}
|
|
|
|
static maliciousCode(message: string): DBALError {
|
|
return new DBALError(DBALErrorCode.MALICIOUS_CODE_DETECTED, message)
|
|
}
|
|
}
|