@chaim-tools/chaim 0.1.0

package/dist/services/snapshot-discovery.js

@@ -0,0 +1,249 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || function (mod) {
+    if (mod && mod.__esModule) return mod;
+    var result = {};
+    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
+    __setModuleDefault(result, mod);
+    return result;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSnapshotDirPath = exports.resolveAllSnapshots = exports.resolveSnapshot = exports.getLatestSnapshot = exports.listSnapshots = exports.discoverSnapshots = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os_cache_paths_1 = require("./os-cache-paths");
+/**
+ * Parse a resource ID into its components.
+ * Format: {resourceName}__{entityName}[__N]
+ *
+ * @param resourceId - Resource ID to parse
+ * @returns Parsed components or null if invalid format
+ */
+function parseResourceId(resourceId) {
+    const parts = resourceId.split('__');
+    if (parts.length < 2) {
+        return null;
+    }
+    return {
+        resourceName: parts[0],
+        entityName: parts[1],
+        suffix: parts.length > 2 ? parts.slice(2).join('__') : undefined,
+    };
+}
+/**
+ * Recursively discover all LOCAL snapshot files in the OS cache.
+ *
+ * Directory structure:
+ *   aws/{accountId}/{region}/{stackName}/{datastoreType}/{resourceId}.json
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param options - Discovery options for filtering
+ * @returns Array of snapshot file info, sorted by capturedAt descending (newest first)
+ */
+function discoverSnapshots(snapshotDir, options = {}) {
+    const baseDir = snapshotDir ?? (0, os_cache_paths_1.getSnapshotBaseDir)();
+    const snapshots = [];
+    const { stackName: filterStack } = options;
+    const awsDir = path.join(baseDir, 'aws');
+    if (!fs.existsSync(awsDir)) {
+        return [];
+    }
+    // Scan accounts
+    const accounts = safeReadDir(awsDir);
+    for (const accountId of accounts) {
+        const accountDir = path.join(awsDir, accountId);
+        if (!fs.statSync(accountDir).isDirectory())
+            continue;
+        // Scan regions
+        const regions = safeReadDir(accountDir);
+        for (const region of regions) {
+            const regionDir = path.join(accountDir, region);
+            if (!fs.statSync(regionDir).isDirectory())
+                continue;
+            // Scan stacks
+            const stacks = safeReadDir(regionDir);
+            for (const stackName of stacks) {
+                // Apply stack filter if provided
+                if (filterStack && stackName !== filterStack)
+                    continue;
+                const stackDir = path.join(regionDir, stackName);
+                if (!fs.statSync(stackDir).isDirectory())
+                    continue;
+                // Scan data store types
+                const datastores = safeReadDir(stackDir);
+                for (const datastoreType of datastores) {
+                    const datastoreDir = path.join(stackDir, datastoreType);
+                    if (!fs.statSync(datastoreDir).isDirectory())
+                        continue;
+                    // Scan snapshot files
+                    const files = safeReadDir(datastoreDir);
+                    for (const file of files) {
+                        if (!file.endsWith('.json'))
+                            continue;
+                        const filePath = path.join(datastoreDir, file);
+                        const stat = fs.statSync(filePath);
+                        if (!stat.isFile())
+                            continue;
+                        // Parse filename
+                        const resourceId = file.slice(0, -5); // Remove .json
+                        const parsed = parseResourceId(resourceId);
+                        if (!parsed)
+                            continue;
+                        // Read capturedAt from payload for sorting
+                        let capturedAt;
+                        try {
+                            const content = fs.readFileSync(filePath, 'utf-8');
+                            const payload = JSON.parse(content);
+                            capturedAt = new Date(payload.capturedAt || stat.mtime);
+                        }
+                        catch {
+                            capturedAt = stat.mtime; // Fallback to mtime
+                        }
+                        snapshots.push({
+                            filePath,
+                            accountId,
+                            region,
+                            stackName,
+                            datastoreType,
+                            resourceId,
+                            resourceName: parsed.resourceName,
+                            entityName: parsed.entityName,
+                            capturedAt,
+                        });
+                    }
+                }
+            }
+        }
+    }
+    // Sort by capturedAt descending (newest first)
+    snapshots.sort((a, b) => b.capturedAt.getTime() - a.capturedAt.getTime());
+    return snapshots;
+}
+exports.discoverSnapshots = discoverSnapshots;
+/**
+ * Safely read a directory, returning empty array if it doesn't exist.
+ */
+function safeReadDir(dir) {
+    try {
+        if (!fs.existsSync(dir)) {
+            return [];
+        }
+        return fs.readdirSync(dir);
+    }
+    catch {
+        return [];
+    }
+}
+/**
+ * List all snapshot files with optional stack filtering.
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param stackName - Optional stack name filter
+ * @returns Array of snapshot file info, sorted by capturedAt descending (newest first)
+ */
+function listSnapshots(snapshotDir, stackName) {
+    return discoverSnapshots(snapshotDir, { stackName });
+}
+exports.listSnapshots = listSnapshots;
+/**
+ * Get the latest snapshot matching the given options.
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param options - Discovery options for filtering
+ * @returns The latest snapshot file info, or undefined if none found
+ */
+function getLatestSnapshot(snapshotDir, options = {}) {
+    const snapshots = discoverSnapshots(snapshotDir, options);
+    return snapshots[0]; // Already sorted by capturedAt descending
+}
+exports.getLatestSnapshot = getLatestSnapshot;
+/**
+ * Resolve which snapshot to use based on the requested options.
+ *
+ * Selection logic:
+ * 1. Find all snapshots matching filter (--stack if provided)
+ * 2. Select the newest by capturedAt
+ * 3. If none found, return undefined
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param stackName - Optional stack name filter
+ * @returns Resolved snapshot info, or undefined if no snapshot found
+ */
+function resolveSnapshot(snapshotDir, stackName) {
+    const snapshotInfo = getLatestSnapshot(snapshotDir, { stackName });
+    if (!snapshotInfo) {
+        return undefined;
+    }
+    // Read and parse the snapshot file
+    const content = fs.readFileSync(snapshotInfo.filePath, 'utf-8');
+    const snapshot = JSON.parse(content);
+    return {
+        filePath: snapshotInfo.filePath,
+        snapshot,
+        stackName: snapshotInfo.stackName,
+        accountId: snapshotInfo.accountId,
+        region: snapshotInfo.region,
+        datastoreType: snapshotInfo.datastoreType,
+        resourceName: snapshotInfo.resourceName,
+        entityName: snapshotInfo.entityName,
+    };
+}
+exports.resolveSnapshot = resolveSnapshot;
+/**
+ * Resolve all snapshots matching the given options.
+ * Used for multi-entity generation.
+ *
+ * @param snapshotDir - Base snapshot directory (defaults to OS cache)
+ * @param options - Discovery options for filtering
+ * @returns Array of resolved snapshots, or empty array if none found
+ */
+function resolveAllSnapshots(snapshotDir, options = {}) {
+    const snapshotInfos = discoverSnapshots(snapshotDir, options);
+    return snapshotInfos.map((info) => {
+        const content = fs.readFileSync(info.filePath, 'utf-8');
+        const snapshot = JSON.parse(content);
+        return {
+            filePath: info.filePath,
+            snapshot,
+            stackName: info.stackName,
+            accountId: info.accountId,
+            region: info.region,
+            datastoreType: info.datastoreType,
+            resourceName: info.resourceName,
+            entityName: info.entityName,
+        };
+    });
+}
+exports.resolveAllSnapshots = resolveAllSnapshots;
+/**
+ * Get the full path to the snapshot directory.
+ *
+ * @param snapshotDir - Snapshot directory (relative or absolute, or undefined for OS cache)
+ * @returns Absolute path to the snapshot directory
+ */
+function getSnapshotDirPath(snapshotDir) {
+    if (!snapshotDir) {
+        return (0, os_cache_paths_1.getSnapshotBaseDir)();
+    }
+    if (path.isAbsolute(snapshotDir)) {
+        return snapshotDir;
+    }
+    return path.join(process.cwd(), snapshotDir);
+}
+exports.getSnapshotDirPath = getSnapshotDirPath;
+//# sourceMappingURL=snapshot-discovery.js.map

package/dist/services/snapshot-discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-discovery.js","sourceRoot":"","sources":["../../src/services/snapshot-discovery.ts"],"names":[],"mappings":"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"}

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Type definitions for chaim-cli.
+ *
+ * These types match the snapshot format produced by chaim-cdk and
+ * provide type safety for snapshot consumption and code generation.
+ */
+export { PrimaryKey, SchemaField, SchemaData, Annotations, GSIMetadata, LSIMetadata, BaseDataStoreMetadata, DynamoDBMetadata, DataStoreMetadata, StackContext, StableIdentity, LocalSnapshotPayload, TableMetadata, } from './snapshot-payload';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAEL,UAAU,EACV,WAAW,EACX,UAAU,EACV,WAAW,EAGX,WAAW,EACX,WAAW,EACX,qBAAqB,EACrB,gBAAgB,EAChB,iBAAiB,EAGjB,YAAY,EACZ,cAAc,EAGd,oBAAoB,EAGpB,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Type definitions for chaim-cli.
+ *
+ * These types match the snapshot format produced by chaim-cdk and
+ * provide type safety for snapshot consumption and code generation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/dist/types/snapshot-payload.d.ts

@@ -0,0 +1,205 @@
+/**
+ * Type definitions for LOCAL snapshot payloads produced by chaim-cdk.
+ *
+ * These types match the snapshot format written to the OS cache by chaim-cdk.
+ * The CLI reads these snapshots to generate DTOs and mapper clients.
+ */
+/**
+ * Primary key configuration for the entity.
+ */
+export interface PrimaryKey {
+    partitionKey: string;
+    sortKey?: string;
+}
+/**
+ * Field definition in the entity schema.
+ */
+export interface SchemaField {
+    name: string;
+    type: 'string' | 'number' | 'boolean' | 'timestamp';
+    required?: boolean;
+    default?: string | number | boolean;
+    enum?: string[];
+    description?: string;
+}
+/**
+ * Annotations for schema metadata.
+ */
+export interface Annotations {
+    pii?: boolean;
+    retention?: string;
+    encryption?: string;
+}
+/**
+ * Complete schema data from a .bprint file.
+ * Schema v1.1 - flattened structure (no nested entity object).
+ */
+export interface SchemaData {
+    schemaVersion: number;
+    entityName: string;
+    description: string;
+    primaryKey: PrimaryKey;
+    fields: SchemaField[];
+    annotations?: Annotations;
+}
+/**
+ * Global Secondary Index metadata
+ */
+export interface GSIMetadata {
+    indexName: string;
+    partitionKey: string;
+    sortKey?: string;
+    projectionType: 'ALL' | 'KEYS_ONLY' | 'INCLUDE';
+    nonKeyAttributes?: string[];
+}
+/**
+ * Local Secondary Index metadata
+ */
+export interface LSIMetadata {
+    indexName: string;
+    sortKey: string;
+    projectionType: 'ALL' | 'KEYS_ONLY' | 'INCLUDE';
+    nonKeyAttributes?: string[];
+}
+/**
+ * Base metadata interface for all data store types.
+ */
+export interface BaseDataStoreMetadata {
+    /** Data store type identifier */
+    type: string;
+    /** AWS ARN of the data store resource */
+    arn: string;
+    /** Resource name */
+    name: string;
+    /** AWS region */
+    region: string;
+    /** AWS account ID */
+    account: string;
+    /** Encryption key ARN (if configured) */
+    encryptionKeyArn?: string;
+}
+/**
+ * DynamoDB table metadata captured during binding.
+ */
+export interface DynamoDBMetadata extends BaseDataStoreMetadata {
+    type: 'dynamodb';
+    /** Table name */
+    tableName: string;
+    /** Table ARN */
+    tableArn: string;
+    /** Partition key attribute name */
+    partitionKey: string;
+    /** Sort key attribute name (if composite key) */
+    sortKey?: string;
+    /** Global Secondary Indexes */
+    globalSecondaryIndexes?: GSIMetadata[];
+    /** Local Secondary Indexes */
+    localSecondaryIndexes?: LSIMetadata[];
+    /** TTL attribute name (if enabled) */
+    ttlAttribute?: string;
+    /** Whether DynamoDB Streams is enabled */
+    streamEnabled?: boolean;
+    /** Stream view type (if streams enabled) */
+    streamViewType?: string;
+    /** Billing mode */
+    billingMode?: 'PAY_PER_REQUEST' | 'PROVISIONED';
+}
+/**
+ * Union type for all supported data store metadata.
+ */
+export type DataStoreMetadata = DynamoDBMetadata;
+/**
+ * Stack context captured during CDK synthesis.
+ */
+export interface StackContext {
+    /** AWS account ID (may be 'unknown' if unresolved at synth time) */
+    account: string;
+    /** AWS region (may be 'unknown' if unresolved at synth time) */
+    region: string;
+    /** CloudFormation stack ID */
+    stackId: string;
+    /** CloudFormation stack name */
+    stackName: string;
+}
+/**
+ * Stable identity for collision detection.
+ * Uses synth-stable fields only (no tokens).
+ */
+export interface StableIdentity {
+    /** Application ID (user input, always stable) */
+    appId: string;
+    /** CDK stack name */
+    stackName: string;
+    /** Data store type (e.g., 'dynamodb') */
+    datastoreType: string;
+    /** Entity name from schema */
+    entityName: string;
+    /** Best available stable resource key */
+    stableResourceKey: string;
+}
+/**
+ * LOCAL snapshot payload written to OS cache during CDK synthesis.
+ *
+ * This is the primary snapshot type used for CLI code generation.
+ * Written at synth-time (runs for both `cdk synth` and `cdk deploy`).
+ */
+export interface LocalSnapshotPayload {
+    /**
+     * Action type for this snapshot.
+     * - UPSERT: Create or update entity metadata (default)
+     * - DELETE: Mark entity as deleted
+     *
+     * If omitted, defaults to 'UPSERT' for backward compatibility.
+     */
+    action?: 'UPSERT' | 'DELETE';
+    /** Cloud provider */
+    provider: 'aws';
+    /** AWS account ID (may be 'unknown' if unresolved at synth) */
+    accountId: string;
+    /** AWS region (may be 'unknown' if unresolved at synth) */
+    region: string;
+    /** CDK stack name */
+    stackName: string;
+    /** Data store type (e.g., 'dynamodb') */
+    datastoreType: string;
+    /** User-provided display label for the resource */
+    resourceName: string;
+    /** Generated resource ID: {resourceName}__{entityName}[__N] */
+    resourceId: string;
+    /** Stable identity for collision detection */
+    identity: StableIdentity;
+    /** Application ID from ChaimBinder props */
+    appId: string;
+    /** Validated .bprint schema data (null for DELETE actions) */
+    schema: SchemaData | null;
+    /** Data store metadata (DynamoDB, Aurora, etc.) */
+    dataStore: DataStoreMetadata;
+    /** CDK stack context */
+    context: StackContext;
+    /** ISO 8601 timestamp of snapshot creation */
+    capturedAt: string;
+}
+/**
+ * Table metadata object passed to the Java generator.
+ *
+ * IMPORTANT: This is a plain object with properties, NOT getter functions.
+ * The JavaGenerator serializes this to JSON via JSON.stringify(), and arrow
+ * functions are not JSON-serializable (they get stripped).
+ */
+export interface TableMetadata {
+    /** Table name */
+    tableName: string;
+    /** Table ARN */
+    tableArn: string;
+    /** AWS region */
+    region: string;
+    /** Partition key attribute name */
+    partitionKey: string;
+    /** Sort key attribute name (if composite key) */
+    sortKey?: string;
+    /** Global Secondary Indexes */
+    globalSecondaryIndexes?: GSIMetadata[];
+    /** Local Secondary Indexes */
+    localSecondaryIndexes?: LSIMetadata[];
+}
+//# sourceMappingURL=snapshot-payload.d.ts.map

package/dist/types/snapshot-payload.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-payload.d.ts","sourceRoot":"","sources":["../../src/types/snapshot-payload.ts"],"names":[],"mappings":"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"}

package/dist/types/snapshot-payload.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Type definitions for LOCAL snapshot payloads produced by chaim-cdk.
+ *
+ * These types match the snapshot format written to the OS cache by chaim-cdk.
+ * The CLI reads these snapshots to generate DTOs and mapper clients.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=snapshot-payload.js.map

package/dist/types/snapshot-payload.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"snapshot-payload.js","sourceRoot":"","sources":["../../src/types/snapshot-payload.ts"],"names":[],"mappings":";AAAA;;;;;GAKG"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "@chaim-tools/chaim",
+  "version": "0.1.0",
+  "description": "Schema-driven code generation tool for DynamoDB - Pure TypeScript CLI",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "shared/scripts",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "chaim": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "npm run build:cli",
+    "build:cli": "tsc",
+    "setup": "./shared/scripts/setup.sh",
+    "clean": "rm -rf dist",
+    "test": "vitest",
+    "lint": "eslint . --ext .ts",
+    "lint:fix": "eslint . --ext .ts --fix",
+    "dev": "ts-node src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "chaim",
+    "cli",
+    "code-generation",
+    "dynamodb",
+    "schema",
+    "typescript"
+  ],
+  "author": "Chaim Builder",
+  "license": "Apache-2.0",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/chaim-tools/chaim-cli.git"
+  },
+  "bugs": {
+    "url": "https://github.com/chaim-tools/chaim-cli/issues"
+  },
+  "homepage": "https://github.com/chaim-tools/chaim-cli#readme",
+  "dependencies": {
+    "@aws-sdk/client-sts": "^3.883.0",
+    "@chaim-tools/chaim-bprint-spec": "workspace:^0.2.0",
+    "@chaim-tools/client-java": "workspace:^0.1.0",
+    "chalk": "^4.1.2",
+    "commander": "^11.0.0",
+    "ora": "^5.4.1"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.0.0",
+    "ts-node": "^10.9.0",
+    "typescript": "~5.0.0",
+    "vitest": "^1.0.0"
+  }
+}

package/shared/scripts/setup.sh

@@ -0,0 +1,47 @@
+#!/bin/bash
+
+echo "🚀 Setting up Chaim CLI (TypeScript)"
+
+# Check if Node.js is installed
+if ! command -v node &> /dev/null; then
+    echo "❌ Node.js is not installed. Please install Node.js v18 or higher."
+    exit 1
+fi
+
+# Check Node.js version
+NODE_VERSION=$(node -v | cut -d'v' -f2 | cut -d'.' -f1)
+if [ "$NODE_VERSION" -lt 18 ]; then
+    echo "❌ Node.js version 18 or higher is required. Current version: $(node -v)"
+    exit 1
+fi
+
+echo "✅ Node.js version: $(node -v)"
+
+# Install dependencies
+echo "📦 Installing CLI dependencies..."
+cd cli && npm install
+
+# Build the TypeScript CLI
+echo "🔨 Building TypeScript CLI..."
+npm run build
+
+# Build Java modules (for code generation)
+echo "☕ Building Java modules..."
+cd ../java
+if [ -f "gradlew" ]; then
+    ./gradlew :schema-core:build
+    ./gradlew :codegen-java:build
+    ./gradlew :cdk-integration:build
+else
+    echo "⚠️  Gradle wrapper not found. Please install Gradle and run:"
+    echo "   gradle :schema-core:build"
+    echo "   gradle :codegen-java:build"
+    echo "   gradle :cdk-integration:build"
+fi
+
+echo "✅ Setup complete!"
+echo ""
+echo "Usage:"
+echo "  ./cli/dist/index.js generate --stack MyStack --package com.example"
+echo "  ./cli/dist/index.js validate ./shared/examples/user.bprint"
+echo "  ./cli/dist/index.js doctor"