mirror of
https://github.com/johndoe6345789/metabuilder.git
synced 2026-04-25 06:14:59 +00:00
johndoe6345789
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
95 lines
2.4 KiB
YAML
95 lines
2.4 KiB
YAML
error_codes:
|
|
NOT_FOUND:
|
|
code: 404
|
|
message: "Resource not found"
|
|
description: "The requested entity does not exist"
|
|
http_status: 404
|
|
|
|
CONFLICT:
|
|
code: 409
|
|
message: "Resource conflict"
|
|
description: "The operation conflicts with existing data (e.g., duplicate key)"
|
|
http_status: 409
|
|
|
|
UNAUTHORIZED:
|
|
code: 401
|
|
message: "Authentication required"
|
|
description: "User must be authenticated to access this resource"
|
|
http_status: 401
|
|
|
|
FORBIDDEN:
|
|
code: 403
|
|
message: "Access forbidden"
|
|
description: "User does not have permission to perform this operation"
|
|
http_status: 403
|
|
|
|
VALIDATION_ERROR:
|
|
code: 422
|
|
message: "Validation failed"
|
|
description: "Input data failed validation checks"
|
|
http_status: 422
|
|
fields:
|
|
- field: string
|
|
error: string
|
|
|
|
RATE_LIMIT_EXCEEDED:
|
|
code: 429
|
|
message: "Rate limit exceeded"
|
|
description: "Too many requests in a given time window"
|
|
http_status: 429
|
|
retry_after: integer
|
|
|
|
INTERNAL_ERROR:
|
|
code: 500
|
|
message: "Internal server error"
|
|
description: "An unexpected error occurred"
|
|
http_status: 500
|
|
|
|
TIMEOUT:
|
|
code: 504
|
|
message: "Operation timeout"
|
|
description: "The operation took too long to complete"
|
|
http_status: 504
|
|
|
|
DATABASE_ERROR:
|
|
code: 503
|
|
message: "Database unavailable"
|
|
description: "Cannot connect to database"
|
|
http_status: 503
|
|
|
|
CAPABILITY_NOT_SUPPORTED:
|
|
code: 501
|
|
message: "Feature not supported"
|
|
description: "The backend does not support this operation"
|
|
http_status: 501
|
|
|
|
SANDBOX_VIOLATION:
|
|
code: 403
|
|
message: "Sandbox security violation"
|
|
description: "Operation attempted to access restricted resources"
|
|
http_status: 403
|
|
security_incident: true
|
|
|
|
MALICIOUS_CODE_DETECTED:
|
|
code: 403
|
|
message: "Malicious code detected"
|
|
description: "Input contains potentially harmful code"
|
|
http_status: 403
|
|
security_incident: true
|
|
|
|
error_handling:
|
|
retry_strategy:
|
|
retryable_codes: [TIMEOUT, DATABASE_ERROR]
|
|
max_retries: 3
|
|
backoff: exponential
|
|
initial_delay_ms: 100
|
|
max_delay_ms: 5000
|
|
|
|
logging:
|
|
always_log: [INTERNAL_ERROR, SANDBOX_VIOLATION, MALICIOUS_CODE_DETECTED]
|
|
include_stack_trace: [INTERNAL_ERROR, DATABASE_ERROR]
|
|
|
|
security:
|
|
audit_required: [SANDBOX_VIOLATION, MALICIOUS_CODE_DETECTED, UNAUTHORIZED]
|
|
alert_admin: [SANDBOX_VIOLATION, MALICIOUS_CODE_DETECTED]
|