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
106 lines
3.0 KiB
Python
106 lines
3.0 KiB
Python
#!/usr/bin/env python3
|
|
"""
|
|
Main build script for DBAL
|
|
Builds both TypeScript and C++ implementations
|
|
"""
|
|
|
|
import subprocess
|
|
import sys
|
|
from pathlib import Path
|
|
import argparse
|
|
|
|
|
|
def build_typescript(root_dir: Path) -> bool:
|
|
"""Build TypeScript implementation"""
|
|
print("\n=== Building TypeScript Implementation ===")
|
|
ts_dir = root_dir / 'ts'
|
|
|
|
try:
|
|
subprocess.run(['npm', 'install'], cwd=ts_dir, check=True)
|
|
subprocess.run(['npm', 'run', 'build'], cwd=ts_dir, check=True)
|
|
print("✓ TypeScript build complete")
|
|
return True
|
|
except subprocess.CalledProcessError as e:
|
|
print(f"✗ TypeScript build failed: {e}", file=sys.stderr)
|
|
return False
|
|
|
|
|
|
def build_cpp(root_dir: Path, build_type: str = 'Release') -> bool:
|
|
"""Build C++ implementation"""
|
|
print("\n=== Building C++ Implementation ===")
|
|
cpp_dir = root_dir / 'cpp'
|
|
build_dir = cpp_dir / 'build'
|
|
|
|
try:
|
|
build_dir.mkdir(exist_ok=True)
|
|
|
|
subprocess.run([
|
|
'cmake',
|
|
'..',
|
|
f'-DCMAKE_BUILD_TYPE={build_type}'
|
|
], cwd=build_dir, check=True)
|
|
|
|
subprocess.run([
|
|
'cmake',
|
|
'--build',
|
|
'.',
|
|
'--parallel'
|
|
], cwd=build_dir, check=True)
|
|
|
|
print("✓ C++ build complete")
|
|
return True
|
|
except subprocess.CalledProcessError as e:
|
|
print(f"✗ C++ build failed: {e}", file=sys.stderr)
|
|
return False
|
|
|
|
|
|
def codegen(root_dir: Path) -> bool:
|
|
"""Run code generation"""
|
|
print("\n=== Running Code Generation ===")
|
|
codegen_script = root_dir / 'tools' / 'codegen' / 'gen_types.py'
|
|
|
|
try:
|
|
subprocess.run(['python3', str(codegen_script)], check=True)
|
|
print("✓ Code generation complete")
|
|
return True
|
|
except subprocess.CalledProcessError as e:
|
|
print(f"✗ Code generation failed: {e}", file=sys.stderr)
|
|
return False
|
|
|
|
|
|
def main():
|
|
parser = argparse.ArgumentParser(description='Build DBAL implementations')
|
|
parser.add_argument('--skip-ts', action='store_true', help='Skip TypeScript build')
|
|
parser.add_argument('--skip-cpp', action='store_true', help='Skip C++ build')
|
|
parser.add_argument('--skip-codegen', action='store_true', help='Skip code generation')
|
|
parser.add_argument('--build-type', default='Release', choices=['Debug', 'Release'],
|
|
help='C++ build type')
|
|
args = parser.parse_args()
|
|
|
|
root_dir = Path(__file__).parent.parent
|
|
|
|
print("DBAL Build System")
|
|
print("=" * 60)
|
|
|
|
success = True
|
|
|
|
if not args.skip_codegen:
|
|
success = codegen(root_dir) and success
|
|
|
|
if not args.skip_ts:
|
|
success = build_typescript(root_dir) and success
|
|
|
|
if not args.skip_cpp:
|
|
success = build_cpp(root_dir, args.build_type) and success
|
|
|
|
if success:
|
|
print("\n✓ Build complete!")
|
|
return 0
|
|
else:
|
|
print("\n✗ Build failed", file=sys.stderr)
|
|
return 1
|
|
|
|
|
|
if __name__ == '__main__':
|
|
sys.exit(main())
|