@chaim-tools/cdk-lib 0.1.0

package/lib/lambda-handler/package.json

@@ -0,0 +1,14 @@
+{
+  "name": "chaim-lambda-handler",
+  "version": "1.0.0",
+  "description": "Lambda handler for Chaim CDK custom resource",
+  "main": "index.js",
+  "type": "commonjs",
+  "dependencies": {
+    "@types/node": "^20.0.0",
+    "@aws-sdk/client-secrets-manager": "^3.0.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  }
+}

package/lib/services/ingestion-service.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Chaim Ingestion Service
+ *
+ * Provides utilities for Chaim SaaS ingestion.
+ * The actual HTTP requests are made by the Lambda handler at runtime.
+ * This service provides compile-time types and configuration utilities.
+ */
+import { CHAIM_ENDPOINTS } from '../config/chaim-endpoints';
+/**
+ * Configuration for Chaim ingestion API.
+ */
+export interface IngestionConfig {
+    /** Base URL for Chaim API */
+    readonly baseUrl: string;
+    /** Request timeout in milliseconds */
+    readonly timeoutMs: number;
+    /** Number of retry attempts */
+    readonly retryAttempts: number;
+}
+/**
+ * Default ingestion configuration.
+ */
+export declare const DEFAULT_INGESTION_CONFIG: IngestionConfig;
+/**
+ * Chaim ingestion API endpoints.
+ * Re-exported from centralized config for backwards compatibility.
+ */
+export declare const INGESTION_ENDPOINTS: {
+    readonly PRESIGN: "/ingest/presign";
+};
+/**
+ * IngestionService provides utilities for Chaim SaaS ingestion.
+ *
+ * The actual HTTP requests are made by the Lambda handler at runtime.
+ * This service provides compile-time types and configuration.
+ */
+export declare class IngestionService {
+    /**
+     * Get ingestion configuration from environment or defaults.
+     */
+    static getConfig(): IngestionConfig;
+    /**
+     * Build full URL for an ingestion endpoint.
+     */
+    static buildUrl(endpoint: keyof typeof CHAIM_ENDPOINTS, baseUrl?: string): string;
+    /**
+     * Compute HMAC-SHA256 signature for request body.
+     */
+    static computeSignature(body: string, secret: string): string;
+}

package/lib/services/ingestion-service.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * Chaim Ingestion Service
+ *
+ * Provides utilities for Chaim SaaS ingestion.
+ * The actual HTTP requests are made by the Lambda handler at runtime.
+ * This service provides compile-time types and configuration utilities.
+ */
+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.IngestionService = exports.INGESTION_ENDPOINTS = exports.DEFAULT_INGESTION_CONFIG = void 0;
+const crypto = __importStar(require("crypto"));
+const chaim_endpoints_1 = require("../config/chaim-endpoints");
+/**
+ * Default ingestion configuration.
+ */
+exports.DEFAULT_INGESTION_CONFIG = {
+    baseUrl: chaim_endpoints_1.DEFAULT_CHAIM_API_BASE_URL,
+    timeoutMs: chaim_endpoints_1.DEFAULT_REQUEST_TIMEOUT_MS,
+    retryAttempts: 3,
+};
+/**
+ * Chaim ingestion API endpoints.
+ * Re-exported from centralized config for backwards compatibility.
+ */
+exports.INGESTION_ENDPOINTS = chaim_endpoints_1.CHAIM_ENDPOINTS;
+/**
+ * IngestionService provides utilities for Chaim SaaS ingestion.
+ *
+ * The actual HTTP requests are made by the Lambda handler at runtime.
+ * This service provides compile-time types and configuration.
+ */
+class IngestionService {
+    /**
+     * Get ingestion configuration from environment or defaults.
+     */
+    static getConfig() {
+        return {
+            baseUrl: process.env.CHAIM_API_BASE_URL || exports.DEFAULT_INGESTION_CONFIG.baseUrl,
+            timeoutMs: parseInt(process.env.CHAIM_API_TIMEOUT || String(exports.DEFAULT_INGESTION_CONFIG.timeoutMs), 10),
+            retryAttempts: parseInt(process.env.CHAIM_RETRY_ATTEMPTS || String(exports.DEFAULT_INGESTION_CONFIG.retryAttempts), 10),
+        };
+    }
+    /**
+     * Build full URL for an ingestion endpoint.
+     */
+    static buildUrl(endpoint, baseUrl) {
+        const base = baseUrl || exports.DEFAULT_INGESTION_CONFIG.baseUrl;
+        return base + chaim_endpoints_1.CHAIM_ENDPOINTS[endpoint];
+    }
+    /**
+     * Compute HMAC-SHA256 signature for request body.
+     */
+    static computeSignature(body, secret) {
+        return crypto.createHmac('sha256', secret).update(body).digest('hex');
+    }
+}
+exports.IngestionService = IngestionService;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5nZXN0aW9uLXNlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmljZXMvaW5nZXN0aW9uLXNlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6IjtBQUFBOzs7Ozs7R0FNRzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFFSCwrQ0FBaUM7QUFDakMsK0RBSW1DO0FBZ0JuQzs7R0FFRztBQUNVLFFBQUEsd0JBQXdCLEdBQW9CO0lBQ3ZELE9BQU8sRUFBRSw0Q0FBMEI7SUFDbkMsU0FBUyxFQUFFLDRDQUEwQjtJQUNyQyxhQUFhLEVBQUUsQ0FBQztDQUNqQixDQUFDO0FBRUY7OztHQUdHO0FBQ1UsUUFBQSxtQkFBbUIsR0FBRyxpQ0FBZSxDQUFDO0FBRW5EOzs7OztHQUtHO0FBQ0gsTUFBYSxnQkFBZ0I7SUFDM0I7O09BRUc7SUFDSCxNQUFNLENBQUMsU0FBUztRQUNkLE9BQU87WUFDTCxPQUFPLEVBQUUsT0FBTyxDQUFDLEdBQUcsQ0FBQyxrQkFBa0IsSUFBSSxnQ0FBd0IsQ0FBQyxPQUFPO1lBQzNFLFNBQVMsRUFBRSxRQUFRLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxpQkFBaUIsSUFBSSxNQUFNLENBQUMsZ0NBQXdCLENBQUMsU0FBUyxDQUFDLEVBQUUsRUFBRSxDQUFDO1lBQ3BHLGFBQWEsRUFBRSxRQUFRLENBQUMsT0FBTyxDQUFDLEdBQUcsQ0FBQyxvQkFBb0IsSUFBSSxNQUFNLENBQUMsZ0NBQXdCLENBQUMsYUFBYSxDQUFDLEVBQUUsRUFBRSxDQUFDO1NBQ2hILENBQUM7SUFDSixDQUFDO0lBRUQ7O09BRUc7SUFDSCxNQUFNLENBQUMsUUFBUSxDQUFDLFFBQXNDLEVBQUUsT0FBZ0I7UUFDdEUsTUFBTSxJQUFJLEdBQUcsT0FBTyxJQUFJLGdDQUF3QixDQUFDLE9BQU8sQ0FBQztRQUN6RCxPQUFPLElBQUksR0FBRyxpQ0FBZSxDQUFDLFFBQVEsQ0FBQyxDQUFDO0lBQzFDLENBQUM7SUFFRDs7T0FFRztJQUNILE1BQU0sQ0FBQyxnQkFBZ0IsQ0FBQyxJQUFZLEVBQUUsTUFBYztRQUNsRCxPQUFPLE1BQU0sQ0FBQyxVQUFVLENBQUMsUUFBUSxFQUFFLE1BQU0sQ0FBQyxDQUFDLE1BQU0sQ0FBQyxJQUFJLENBQUMsQ0FBQyxNQUFNLENBQUMsS0FBSyxDQUFDLENBQUM7SUFDeEUsQ0FBQztDQUNGO0FBMUJELDRDQTBCQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQ2hhaW0gSW5nZXN0aW9uIFNlcnZpY2VcbiAqIFxuICogUHJvdmlkZXMgdXRpbGl0aWVzIGZvciBDaGFpbSBTYWFTIGluZ2VzdGlvbi5cbiAqIFRoZSBhY3R1YWwgSFRUUCByZXF1ZXN0cyBhcmUgbWFkZSBieSB0aGUgTGFtYmRhIGhhbmRsZXIgYXQgcnVudGltZS5cbiAqIFRoaXMgc2VydmljZSBwcm92aWRlcyBjb21waWxlLXRpbWUgdHlwZXMgYW5kIGNvbmZpZ3VyYXRpb24gdXRpbGl0aWVzLlxuICovXG5cbmltcG9ydCAqIGFzIGNyeXB0byBmcm9tICdjcnlwdG8nO1xuaW1wb3J0IHtcbiAgREVGQVVMVF9DSEFJTV9BUElfQkFTRV9VUkwsXG4gIENIQUlNX0VORFBPSU5UUyxcbiAgREVGQVVMVF9SRVFVRVNUX1RJTUVPVVRfTVMsXG59IGZyb20gJy4uL2NvbmZpZy9jaGFpbS1lbmRwb2ludHMnO1xuXG4vKipcbiAqIENvbmZpZ3VyYXRpb24gZm9yIENoYWltIGluZ2VzdGlvbiBBUEkuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSW5nZXN0aW9uQ29uZmlnIHtcbiAgLyoqIEJhc2UgVVJMIGZvciBDaGFpbSBBUEkgKi9cbiAgcmVhZG9ubHkgYmFzZVVybDogc3RyaW5nO1xuXG4gIC8qKiBSZXF1ZXN0IHRpbWVvdXQgaW4gbWlsbGlzZWNvbmRzICovXG4gIHJlYWRvbmx5IHRpbWVvdXRNczogbnVtYmVyO1xuXG4gIC8qKiBOdW1iZXIgb2YgcmV0cnkgYXR0ZW1wdHMgKi9cbiAgcmVhZG9ubHkgcmV0cnlBdHRlbXB0czogbnVtYmVyO1xufVxuXG4vKipcbiAqIERlZmF1bHQgaW5nZXN0aW9uIGNvbmZpZ3VyYXRpb24uXG4gKi9cbmV4cG9ydCBjb25zdCBERUZBVUxUX0lOR0VTVElPTl9DT05GSUc6IEluZ2VzdGlvbkNvbmZpZyA9IHtcbiAgYmFzZVVybDogREVGQVVMVF9DSEFJTV9BUElfQkFTRV9VUkwsXG4gIHRpbWVvdXRNczogREVGQVVMVF9SRVFVRVNUX1RJTUVPVVRfTVMsXG4gIHJldHJ5QXR0ZW1wdHM6IDMsXG59O1xuXG4vKipcbiAqIENoYWltIGluZ2VzdGlvbiBBUEkgZW5kcG9pbnRzLlxuICogUmUtZXhwb3J0ZWQgZnJvbSBjZW50cmFsaXplZCBjb25maWcgZm9yIGJhY2t3YXJkcyBjb21wYXRpYmlsaXR5LlxuICovXG5leHBvcnQgY29uc3QgSU5HRVNUSU9OX0VORFBPSU5UUyA9IENIQUlNX0VORFBPSU5UUztcblxuLyoqXG4gKiBJbmdlc3Rpb25TZXJ2aWNlIHByb3ZpZGVzIHV0aWxpdGllcyBmb3IgQ2hhaW0gU2FhUyBpbmdlc3Rpb24uXG4gKiBcbiAqIFRoZSBhY3R1YWwgSFRUUCByZXF1ZXN0cyBhcmUgbWFkZSBieSB0aGUgTGFtYmRhIGhhbmRsZXIgYXQgcnVudGltZS5cbiAqIFRoaXMgc2VydmljZSBwcm92aWRlcyBjb21waWxlLXRpbWUgdHlwZXMgYW5kIGNvbmZpZ3VyYXRpb24uXG4gKi9cbmV4cG9ydCBjbGFzcyBJbmdlc3Rpb25TZXJ2aWNlIHtcbiAgLyoqXG4gICAqIEdldCBpbmdlc3Rpb24gY29uZmlndXJhdGlvbiBmcm9tIGVudmlyb25tZW50IG9yIGRlZmF1bHRzLlxuICAgKi9cbiAgc3RhdGljIGdldENvbmZpZygpOiBJbmdlc3Rpb25Db25maWcge1xuICAgIHJldHVybiB7XG4gICAgICBiYXNlVXJsOiBwcm9jZXNzLmVudi5DSEFJTV9BUElfQkFTRV9VUkwgfHwgREVGQVVMVF9JTkdFU1RJT05fQ09ORklHLmJhc2VVcmwsXG4gICAgICB0aW1lb3V0TXM6IHBhcnNlSW50KHByb2Nlc3MuZW52LkNIQUlNX0FQSV9USU1FT1VUIHx8IFN0cmluZyhERUZBVUxUX0lOR0VTVElPTl9DT05GSUcudGltZW91dE1zKSwgMTApLFxuICAgICAgcmV0cnlBdHRlbXB0czogcGFyc2VJbnQocHJvY2Vzcy5lbnYuQ0hBSU1fUkVUUllfQVRURU1QVFMgfHwgU3RyaW5nKERFRkFVTFRfSU5HRVNUSU9OX0NPTkZJRy5yZXRyeUF0dGVtcHRzKSwgMTApLFxuICAgIH07XG4gIH1cblxuICAvKipcbiAgICogQnVpbGQgZnVsbCBVUkwgZm9yIGFuIGluZ2VzdGlvbiBlbmRwb2ludC5cbiAgICovXG4gIHN0YXRpYyBidWlsZFVybChlbmRwb2ludDoga2V5b2YgdHlwZW9mIENIQUlNX0VORFBPSU5UUywgYmFzZVVybD86IHN0cmluZyk6IHN0cmluZyB7XG4gICAgY29uc3QgYmFzZSA9IGJhc2VVcmwgfHwgREVGQVVMVF9JTkdFU1RJT05fQ09ORklHLmJhc2VVcmw7XG4gICAgcmV0dXJuIGJhc2UgKyBDSEFJTV9FTkRQT0lOVFNbZW5kcG9pbnRdO1xuICB9XG5cbiAgLyoqXG4gICAqIENvbXB1dGUgSE1BQy1TSEEyNTYgc2lnbmF0dXJlIGZvciByZXF1ZXN0IGJvZHkuXG4gICAqL1xuICBzdGF0aWMgY29tcHV0ZVNpZ25hdHVyZShib2R5OiBzdHJpbmcsIHNlY3JldDogc3RyaW5nKTogc3RyaW5nIHtcbiAgICByZXR1cm4gY3J5cHRvLmNyZWF0ZUhtYWMoJ3NoYTI1NicsIHNlY3JldCkudXBkYXRlKGJvZHkpLmRpZ2VzdCgnaGV4Jyk7XG4gIH1cbn1cbiJdfQ==

package/lib/services/os-cache-paths.d.ts

@@ -0,0 +1,52 @@
+/**
+ * Get the default base directory for Chaim snapshots based on OS.
+ * - macOS/Linux: ~/.chaim/cache/snapshots
+ * - Windows: %LOCALAPPDATA%/chaim/cache/snapshots (or homedir fallback)
+ */
+export declare function getDefaultSnapshotBaseDir(): string;
+/**
+ * Get the snapshot base directory, respecting CHAIM_SNAPSHOT_DIR override.
+ */
+export declare function getSnapshotBaseDir(): string;
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+export declare function ensureDirExists(dir: string): void;
+/**
+ * Normalize account ID - handles CDK tokens and unresolved values.
+ */
+export declare function normalizeAccountId(accountId: string | undefined): string;
+/**
+ * Normalize region - handles CDK tokens and unresolved values.
+ */
+export declare function normalizeRegion(region: string | undefined): string;
+/**
+ * Normalize a resource name by removing CDK tokens and special characters.
+ * Used for generating file paths.
+ *
+ * IMPORTANT: Preserves double underscores (__) as they are used as delimiters
+ * in resource IDs (format: {resourceName}__{entityName}).
+ */
+export declare function normalizeResourceName(name: string): string;
+/**
+ * Parameters for constructing snapshot paths.
+ */
+export interface SnapshotPathParams {
+    accountId: string;
+    region: string;
+    stackName: string;
+    datastoreType: string;
+    resourceId: string;
+}
+/**
+ * Get the directory path for LOCAL snapshots.
+ */
+export declare function getSnapshotDir(params: Omit<SnapshotPathParams, 'resourceId'>): string;
+/**
+ * Get the full path to a LOCAL snapshot file.
+ */
+export declare function getLocalSnapshotPath(params: SnapshotPathParams): string;
+/**
+ * Write a LOCAL snapshot to the OS cache.
+ */
+export declare function writeLocalSnapshot(params: SnapshotPathParams, snapshot: object): string;

package/lib/services/os-cache-paths.js

@@ -0,0 +1,123 @@
+"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.writeLocalSnapshot = exports.getLocalSnapshotPath = exports.getSnapshotDir = exports.normalizeResourceName = exports.normalizeRegion = exports.normalizeAccountId = exports.ensureDirExists = exports.getSnapshotBaseDir = exports.getDefaultSnapshotBaseDir = void 0;
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const fs = __importStar(require("fs"));
+/**
+ * Get the default base directory for Chaim snapshots based on OS.
+ * - macOS/Linux: ~/.chaim/cache/snapshots
+ * - Windows: %LOCALAPPDATA%/chaim/cache/snapshots (or homedir fallback)
+ */
+function getDefaultSnapshotBaseDir() {
+    if (process.platform === 'win32') {
+        const localAppData = process.env.LOCALAPPDATA ?? os.homedir();
+        return path.join(localAppData, 'chaim', 'cache', 'snapshots');
+    }
+    return path.join(os.homedir(), '.chaim', 'cache', 'snapshots');
+}
+exports.getDefaultSnapshotBaseDir = getDefaultSnapshotBaseDir;
+/**
+ * Get the snapshot base directory, respecting CHAIM_SNAPSHOT_DIR override.
+ */
+function getSnapshotBaseDir() {
+    return process.env.CHAIM_SNAPSHOT_DIR ?? getDefaultSnapshotBaseDir();
+}
+exports.getSnapshotBaseDir = getSnapshotBaseDir;
+/**
+ * Ensure a directory exists, creating it recursively if needed.
+ */
+function ensureDirExists(dir) {
+    fs.mkdirSync(dir, { recursive: true });
+}
+exports.ensureDirExists = ensureDirExists;
+/**
+ * Normalize account ID - handles CDK tokens and unresolved values.
+ */
+function normalizeAccountId(accountId) {
+    if (!accountId || accountId.includes('${Token') || accountId.includes('${AWS::')) {
+        return 'unknown';
+    }
+    return accountId;
+}
+exports.normalizeAccountId = normalizeAccountId;
+/**
+ * Normalize region - handles CDK tokens and unresolved values.
+ */
+function normalizeRegion(region) {
+    if (!region || region.includes('${Token') || region.includes('${AWS::')) {
+        return 'unknown';
+    }
+    return region;
+}
+exports.normalizeRegion = normalizeRegion;
+/**
+ * Normalize a resource name by removing CDK tokens and special characters.
+ * Used for generating file paths.
+ *
+ * IMPORTANT: Preserves double underscores (__) as they are used as delimiters
+ * in resource IDs (format: {resourceName}__{entityName}).
+ */
+function normalizeResourceName(name) {
+    // Replace CDK tokens with 'token'
+    let normalized = name.replace(/\$\{Token\[[^\]]+\]\}/g, 'token');
+    // Replace special characters with underscores (except existing underscores)
+    normalized = normalized.replace(/[^a-zA-Z0-9_-]/g, '_');
+    // Remove triple-or-more consecutive underscores, but PRESERVE double underscores (__)
+    // This is important because __ is used as delimiter in resource IDs
+    normalized = normalized.replace(/_{3,}/g, '__');
+    // Trim leading/trailing underscores
+    return normalized.replace(/^_|_$/g, '');
+}
+exports.normalizeResourceName = normalizeResourceName;
+/**
+ * Get the directory path for LOCAL snapshots.
+ */
+function getSnapshotDir(params) {
+    return path.join(getSnapshotBaseDir(), 'aws', normalizeAccountId(params.accountId), normalizeRegion(params.region), params.stackName, params.datastoreType);
+}
+exports.getSnapshotDir = getSnapshotDir;
+/**
+ * Get the full path to a LOCAL snapshot file.
+ */
+function getLocalSnapshotPath(params) {
+    // Normalize resource ID to avoid special characters in path
+    const normalizedResourceId = normalizeResourceName(params.resourceId);
+    return path.join(getSnapshotDir(params), `${normalizedResourceId}.json`);
+}
+exports.getLocalSnapshotPath = getLocalSnapshotPath;
+/**
+ * Write a LOCAL snapshot to the OS cache.
+ */
+function writeLocalSnapshot(params, snapshot) {
+    const dir = getSnapshotDir(params);
+    ensureDirExists(dir);
+    const filePath = getLocalSnapshotPath(params);
+    fs.writeFileSync(filePath, JSON.stringify(snapshot, null, 2), 'utf-8');
+    return filePath;
+}
+exports.writeLocalSnapshot = writeLocalSnapshot;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoib3MtY2FjaGUtcGF0aHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmljZXMvb3MtY2FjaGUtcGF0aHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSx1Q0FBeUI7QUFDekIsMkNBQTZCO0FBQzdCLHVDQUF5QjtBQUV6Qjs7OztHQUlHO0FBQ0gsU0FBZ0IseUJBQXlCO0lBQ3ZDLElBQUksT0FBTyxDQUFDLFFBQVEsS0FBSyxPQUFPLEVBQUU7UUFDaEMsTUFBTSxZQUFZLEdBQUcsT0FBTyxDQUFDLEdBQUcsQ0FBQyxZQUFZLElBQUksRUFBRSxDQUFDLE9BQU8sRUFBRSxDQUFDO1FBQzlELE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxZQUFZLEVBQUUsT0FBTyxFQUFFLE9BQU8sRUFBRSxXQUFXLENBQUMsQ0FBQztLQUMvRDtJQUNELE9BQU8sSUFBSSxDQUFDLElBQUksQ0FBQyxFQUFFLENBQUMsT0FBTyxFQUFFLEVBQUUsUUFBUSxFQUFFLE9BQU8sRUFBRSxXQUFXLENBQUMsQ0FBQztBQUNqRSxDQUFDO0FBTkQsOERBTUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLGtCQUFrQjtJQUNoQyxPQUFPLE9BQU8sQ0FBQyxHQUFHLENBQUMsa0JBQWtCLElBQUkseUJBQXlCLEVBQUUsQ0FBQztBQUN2RSxDQUFDO0FBRkQsZ0RBRUM7QUFFRDs7R0FFRztBQUNILFNBQWdCLGVBQWUsQ0FBQyxHQUFXO0lBQ3pDLEVBQUUsQ0FBQyxTQUFTLENBQUMsR0FBRyxFQUFFLEVBQUUsU0FBUyxFQUFFLElBQUksRUFBRSxDQUFDLENBQUM7QUFDekMsQ0FBQztBQUZELDBDQUVDO0FBRUQ7O0dBRUc7QUFDSCxTQUFnQixrQkFBa0IsQ0FBQyxTQUE2QjtJQUM5RCxJQUFJLENBQUMsU0FBUyxJQUFJLFNBQVMsQ0FBQyxRQUFRLENBQUMsU0FBUyxDQUFDLElBQUksU0FBUyxDQUFDLFFBQVEsQ0FBQyxTQUFTLENBQUMsRUFBRTtRQUNoRixPQUFPLFNBQVMsQ0FBQztLQUNsQjtJQUNELE9BQU8sU0FBUyxDQUFDO0FBQ25CLENBQUM7QUFMRCxnREFLQztBQUVEOztHQUVHO0FBQ0gsU0FBZ0IsZUFBZSxDQUFDLE1BQTBCO0lBQ3hELElBQUksQ0FBQyxNQUFNLElBQUksTUFBTSxDQUFDLFFBQVEsQ0FBQyxTQUFTLENBQUMsSUFBSSxNQUFNLENBQUMsUUFBUSxDQUFDLFNBQVMsQ0FBQyxFQUFFO1FBQ3ZFLE9BQU8sU0FBUyxDQUFDO0tBQ2xCO0lBQ0QsT0FBTyxNQUFNLENBQUM7QUFDaEIsQ0FBQztBQUxELDBDQUtDO0FBRUQ7Ozs7OztHQU1HO0FBQ0gsU0FBZ0IscUJBQXFCLENBQUMsSUFBWTtJQUNoRCxrQ0FBa0M7SUFDbEMsSUFBSSxVQUFVLEdBQUcsSUFBSSxDQUFDLE9BQU8sQ0FBQyx3QkFBd0IsRUFBRSxPQUFPLENBQUMsQ0FBQztJQUNqRSw0RUFBNEU7SUFDNUUsVUFBVSxHQUFHLFVBQVUsQ0FBQyxPQUFPLENBQUMsaUJBQWlCLEVBQUUsR0FBRyxDQUFDLENBQUM7SUFDeEQsc0ZBQXNGO0lBQ3RGLG9FQUFvRTtJQUNwRSxVQUFVLEdBQUcsVUFBVSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsSUFBSSxDQUFDLENBQUM7SUFDaEQsb0NBQW9DO0lBQ3BDLE9BQU8sVUFBVSxDQUFDLE9BQU8sQ0FBQyxRQUFRLEVBQUUsRUFBRSxDQUFDLENBQUM7QUFDMUMsQ0FBQztBQVZELHNEQVVDO0FBYUQ7O0dBRUc7QUFDSCxTQUFnQixjQUFjLENBQUMsTUFBOEM7SUFDM0UsT0FBTyxJQUFJLENBQUMsSUFBSSxDQUNkLGtCQUFrQixFQUFFLEVBQ3BCLEtBQUssRUFDTCxrQkFBa0IsQ0FBQyxNQUFNLENBQUMsU0FBUyxDQUFDLEVBQ3BDLGVBQWUsQ0FBQyxNQUFNLENBQUMsTUFBTSxDQUFDLEVBQzlCLE1BQU0sQ0FBQyxTQUFTLEVBQ2hCLE1BQU0sQ0FBQyxhQUFhLENBQ3JCLENBQUM7QUFDSixDQUFDO0FBVEQsd0NBU0M7QUFFRDs7R0FFRztBQUNILFNBQWdCLG9CQUFvQixDQUFDLE1BQTBCO0lBQzdELDREQUE0RDtJQUM1RCxNQUFNLG9CQUFvQixHQUFHLHFCQUFxQixDQUFDLE1BQU0sQ0FBQyxVQUFVLENBQUMsQ0FBQztJQUN0RSxPQUFPLElBQUksQ0FBQyxJQUFJLENBQ2QsY0FBYyxDQUFDLE1BQU0sQ0FBQyxFQUN0QixHQUFHLG9CQUFvQixPQUFPLENBQy9CLENBQUM7QUFDSixDQUFDO0FBUEQsb0RBT0M7QUFFRDs7R0FFRztBQUNILFNBQWdCLGtCQUFrQixDQUFDLE1BQTBCLEVBQUUsUUFBZ0I7SUFDN0UsTUFBTSxHQUFHLEdBQUcsY0FBYyxDQUFDLE1BQU0sQ0FBQyxDQUFDO0lBQ25DLGVBQWUsQ0FBQyxHQUFHLENBQUMsQ0FBQztJQUVyQixNQUFNLFFBQVEsR0FBRyxvQkFBb0IsQ0FBQyxNQUFNLENBQUMsQ0FBQztJQUM5QyxFQUFFLENBQUMsYUFBYSxDQUFDLFFBQVEsRUFBRSxJQUFJLENBQUMsU0FBUyxDQUFDLFFBQVEsRUFBRSxJQUFJLEVBQUUsQ0FBQyxDQUFDLEVBQUUsT0FBTyxDQUFDLENBQUM7SUFFdkUsT0FBTyxRQUFRLENBQUM7QUFDbEIsQ0FBQztBQVJELGdEQVFDIiwic291cmNlc0NvbnRlbnQiOlsiaW1wb3J0ICogYXMgb3MgZnJvbSAnb3MnO1xuaW1wb3J0ICogYXMgcGF0aCBmcm9tICdwYXRoJztcbmltcG9ydCAqIGFzIGZzIGZyb20gJ2ZzJztcblxuLyoqXG4gKiBHZXQgdGhlIGRlZmF1bHQgYmFzZSBkaXJlY3RvcnkgZm9yIENoYWltIHNuYXBzaG90cyBiYXNlZCBvbiBPUy5cbiAqIC0gbWFjT1MvTGludXg6IH4vLmNoYWltL2NhY2hlL3NuYXBzaG90c1xuICogLSBXaW5kb3dzOiAlTE9DQUxBUFBEQVRBJS9jaGFpbS9jYWNoZS9zbmFwc2hvdHMgKG9yIGhvbWVkaXIgZmFsbGJhY2spXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBnZXREZWZhdWx0U25hcHNob3RCYXNlRGlyKCk6IHN0cmluZyB7XG4gIGlmIChwcm9jZXNzLnBsYXRmb3JtID09PSAnd2luMzInKSB7XG4gICAgY29uc3QgbG9jYWxBcHBEYXRhID0gcHJvY2Vzcy5lbnYuTE9DQUxBUFBEQVRBID8/IG9zLmhvbWVkaXIoKTtcbiAgICByZXR1cm4gcGF0aC5qb2luKGxvY2FsQXBwRGF0YSwgJ2NoYWltJywgJ2NhY2hlJywgJ3NuYXBzaG90cycpO1xuICB9XG4gIHJldHVybiBwYXRoLmpvaW4ob3MuaG9tZWRpcigpLCAnLmNoYWltJywgJ2NhY2hlJywgJ3NuYXBzaG90cycpO1xufVxuXG4vKipcbiAqIEdldCB0aGUgc25hcHNob3QgYmFzZSBkaXJlY3RvcnksIHJlc3BlY3RpbmcgQ0hBSU1fU05BUFNIT1RfRElSIG92ZXJyaWRlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gZ2V0U25hcHNob3RCYXNlRGlyKCk6IHN0cmluZyB7XG4gIHJldHVybiBwcm9jZXNzLmVudi5DSEFJTV9TTkFQU0hPVF9ESVIgPz8gZ2V0RGVmYXVsdFNuYXBzaG90QmFzZURpcigpO1xufVxuXG4vKipcbiAqIEVuc3VyZSBhIGRpcmVjdG9yeSBleGlzdHMsIGNyZWF0aW5nIGl0IHJlY3Vyc2l2ZWx5IGlmIG5lZWRlZC5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGVuc3VyZURpckV4aXN0cyhkaXI6IHN0cmluZyk6IHZvaWQge1xuICBmcy5ta2RpclN5bmMoZGlyLCB7IHJlY3Vyc2l2ZTogdHJ1ZSB9KTtcbn1cblxuLyoqXG4gKiBOb3JtYWxpemUgYWNjb3VudCBJRCAtIGhhbmRsZXMgQ0RLIHRva2VucyBhbmQgdW5yZXNvbHZlZCB2YWx1ZXMuXG4gKi9cbmV4cG9ydCBmdW5jdGlvbiBub3JtYWxpemVBY2NvdW50SWQoYWNjb3VudElkOiBzdHJpbmcgfCB1bmRlZmluZWQpOiBzdHJpbmcge1xuICBpZiAoIWFjY291bnRJZCB8fCBhY2NvdW50SWQuaW5jbHVkZXMoJyR7VG9rZW4nKSB8fCBhY2NvdW50SWQuaW5jbHVkZXMoJyR7QVdTOjonKSkge1xuICAgIHJldHVybiAndW5rbm93bic7XG4gIH1cbiAgcmV0dXJuIGFjY291bnRJZDtcbn1cblxuLyoqXG4gKiBOb3JtYWxpemUgcmVnaW9uIC0gaGFuZGxlcyBDREsgdG9rZW5zIGFuZCB1bnJlc29sdmVkIHZhbHVlcy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5vcm1hbGl6ZVJlZ2lvbihyZWdpb246IHN0cmluZyB8IHVuZGVmaW5lZCk6IHN0cmluZyB7XG4gIGlmICghcmVnaW9uIHx8IHJlZ2lvbi5pbmNsdWRlcygnJHtUb2tlbicpIHx8IHJlZ2lvbi5pbmNsdWRlcygnJHtBV1M6OicpKSB7XG4gICAgcmV0dXJuICd1bmtub3duJztcbiAgfVxuICByZXR1cm4gcmVnaW9uO1xufVxuXG4vKipcbiAqIE5vcm1hbGl6ZSBhIHJlc291cmNlIG5hbWUgYnkgcmVtb3ZpbmcgQ0RLIHRva2VucyBhbmQgc3BlY2lhbCBjaGFyYWN0ZXJzLlxuICogVXNlZCBmb3IgZ2VuZXJhdGluZyBmaWxlIHBhdGhzLlxuICogXG4gKiBJTVBPUlRBTlQ6IFByZXNlcnZlcyBkb3VibGUgdW5kZXJzY29yZXMgKF9fKSBhcyB0aGV5IGFyZSB1c2VkIGFzIGRlbGltaXRlcnNcbiAqIGluIHJlc291cmNlIElEcyAoZm9ybWF0OiB7cmVzb3VyY2VOYW1lfV9fe2VudGl0eU5hbWV9KS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIG5vcm1hbGl6ZVJlc291cmNlTmFtZShuYW1lOiBzdHJpbmcpOiBzdHJpbmcge1xuICAvLyBSZXBsYWNlIENESyB0b2tlbnMgd2l0aCAndG9rZW4nXG4gIGxldCBub3JtYWxpemVkID0gbmFtZS5yZXBsYWNlKC9cXCRcXHtUb2tlblxcW1teXFxdXStcXF1cXH0vZywgJ3Rva2VuJyk7XG4gIC8vIFJlcGxhY2Ugc3BlY2lhbCBjaGFyYWN0ZXJzIHdpdGggdW5kZXJzY29yZXMgKGV4Y2VwdCBleGlzdGluZyB1bmRlcnNjb3JlcylcbiAgbm9ybWFsaXplZCA9IG5vcm1hbGl6ZWQucmVwbGFjZSgvW15hLXpBLVowLTlfLV0vZywgJ18nKTtcbiAgLy8gUmVtb3ZlIHRyaXBsZS1vci1tb3JlIGNvbnNlY3V0aXZlIHVuZGVyc2NvcmVzLCBidXQgUFJFU0VSVkUgZG91YmxlIHVuZGVyc2NvcmVzIChfXylcbiAgLy8gVGhpcyBpcyBpbXBvcnRhbnQgYmVjYXVzZSBfXyBpcyB1c2VkIGFzIGRlbGltaXRlciBpbiByZXNvdXJjZSBJRHNcbiAgbm9ybWFsaXplZCA9IG5vcm1hbGl6ZWQucmVwbGFjZSgvX3szLH0vZywgJ19fJyk7XG4gIC8vIFRyaW0gbGVhZGluZy90cmFpbGluZyB1bmRlcnNjb3Jlc1xuICByZXR1cm4gbm9ybWFsaXplZC5yZXBsYWNlKC9eX3xfJC9nLCAnJyk7XG59XG5cbi8qKlxuICogUGFyYW1ldGVycyBmb3IgY29uc3RydWN0aW5nIHNuYXBzaG90IHBhdGhzLlxuICovXG5leHBvcnQgaW50ZXJmYWNlIFNuYXBzaG90UGF0aFBhcmFtcyB7XG4gIGFjY291bnRJZDogc3RyaW5nO1xuICByZWdpb246IHN0cmluZztcbiAgc3RhY2tOYW1lOiBzdHJpbmc7XG4gIGRhdGFzdG9yZVR5cGU6IHN0cmluZztcbiAgcmVzb3VyY2VJZDogc3RyaW5nO1xufVxuXG4vKipcbiAqIEdldCB0aGUgZGlyZWN0b3J5IHBhdGggZm9yIExPQ0FMIHNuYXBzaG90cy5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldFNuYXBzaG90RGlyKHBhcmFtczogT21pdDxTbmFwc2hvdFBhdGhQYXJhbXMsICdyZXNvdXJjZUlkJz4pOiBzdHJpbmcge1xuICByZXR1cm4gcGF0aC5qb2luKFxuICAgIGdldFNuYXBzaG90QmFzZURpcigpLFxuICAgICdhd3MnLFxuICAgIG5vcm1hbGl6ZUFjY291bnRJZChwYXJhbXMuYWNjb3VudElkKSxcbiAgICBub3JtYWxpemVSZWdpb24ocGFyYW1zLnJlZ2lvbiksXG4gICAgcGFyYW1zLnN0YWNrTmFtZSxcbiAgICBwYXJhbXMuZGF0YXN0b3JlVHlwZVxuICApO1xufVxuXG4vKipcbiAqIEdldCB0aGUgZnVsbCBwYXRoIHRvIGEgTE9DQUwgc25hcHNob3QgZmlsZS5cbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIGdldExvY2FsU25hcHNob3RQYXRoKHBhcmFtczogU25hcHNob3RQYXRoUGFyYW1zKTogc3RyaW5nIHtcbiAgLy8gTm9ybWFsaXplIHJlc291cmNlIElEIHRvIGF2b2lkIHNwZWNpYWwgY2hhcmFjdGVycyBpbiBwYXRoXG4gIGNvbnN0IG5vcm1hbGl6ZWRSZXNvdXJjZUlkID0gbm9ybWFsaXplUmVzb3VyY2VOYW1lKHBhcmFtcy5yZXNvdXJjZUlkKTtcbiAgcmV0dXJuIHBhdGguam9pbihcbiAgICBnZXRTbmFwc2hvdERpcihwYXJhbXMpLFxuICAgIGAke25vcm1hbGl6ZWRSZXNvdXJjZUlkfS5qc29uYFxuICApO1xufVxuXG4vKipcbiAqIFdyaXRlIGEgTE9DQUwgc25hcHNob3QgdG8gdGhlIE9TIGNhY2hlLlxuICovXG5leHBvcnQgZnVuY3Rpb24gd3JpdGVMb2NhbFNuYXBzaG90KHBhcmFtczogU25hcHNob3RQYXRoUGFyYW1zLCBzbmFwc2hvdDogb2JqZWN0KTogc3RyaW5nIHtcbiAgY29uc3QgZGlyID0gZ2V0U25hcHNob3REaXIocGFyYW1zKTtcbiAgZW5zdXJlRGlyRXhpc3RzKGRpcik7XG4gIFxuICBjb25zdCBmaWxlUGF0aCA9IGdldExvY2FsU25hcHNob3RQYXRoKHBhcmFtcyk7XG4gIGZzLndyaXRlRmlsZVN5bmMoZmlsZVBhdGgsIEpTT04uc3RyaW5naWZ5KHNuYXBzaG90LCBudWxsLCAyKSwgJ3V0Zi04Jyk7XG4gIFxuICByZXR1cm4gZmlsZVBhdGg7XG59XG4iXX0=

package/lib/services/schema-service.d.ts

@@ -0,0 +1,11 @@
+import { SchemaData } from '@chaim-tools/chaim-bprint-spec';
+export declare class SchemaService {
+    /**
+     * Validates that the schema file path exists and has a .bprint extension
+     */
+    static validateSchemaPath(schemaPath: string): void;
+    /**
+     * Reads and parses the schema file using our local validator based on the official spec
+     */
+    static readSchema(schemaPath: string): SchemaData;
+}

package/lib/services/schema-service.js

@@ -0,0 +1,67 @@
+"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.SchemaService = void 0;
+const fs = __importStar(require("fs"));
+const chaim_bprint_spec_1 = require("@chaim-tools/chaim-bprint-spec");
+class SchemaService {
+    /**
+     * Validates that the schema file path exists and has a .bprint extension
+     */
+    static validateSchemaPath(schemaPath) {
+        if (!schemaPath) {
+            throw new Error('Schema path is required');
+        }
+        if (!schemaPath.endsWith('.bprint')) {
+            throw new Error('Schema file must have a .bprint extension');
+        }
+        if (!fs.existsSync(schemaPath)) {
+            throw new Error(`Schema file not found: ${schemaPath}`);
+        }
+    }
+    /**
+     * Reads and parses the schema file using our local validator based on the official spec
+     */
+    static readSchema(schemaPath) {
+        try {
+            const content = fs.readFileSync(schemaPath, 'utf-8');
+            const rawSchema = JSON.parse(content);
+            // Use the official chaim-bprint-spec validator
+            return (0, chaim_bprint_spec_1.validateSchema)(rawSchema);
+        }
+        catch (error) {
+            if (error instanceof SyntaxError) {
+                throw new Error(`Invalid JSON in schema file: ${schemaPath}`);
+            }
+            // Re-throw validation errors with context
+            if (error instanceof Error) {
+                throw new Error(`Schema validation failed for ${schemaPath}: ${error.message}`);
+            }
+            throw error;
+        }
+    }
+}
+exports.SchemaService = SchemaService;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic2NoZW1hLXNlcnZpY2UuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvc2VydmljZXMvc2NoZW1hLXNlcnZpY2UudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7QUFBQSx1Q0FBeUI7QUFDekIsc0VBQTRFO0FBRTVFLE1BQWEsYUFBYTtJQUN4Qjs7T0FFRztJQUNILE1BQU0sQ0FBQyxrQkFBa0IsQ0FBQyxVQUFrQjtRQUMxQyxJQUFJLENBQUMsVUFBVSxFQUFFO1lBQ2YsTUFBTSxJQUFJLEtBQUssQ0FBQyx5QkFBeUIsQ0FBQyxDQUFDO1NBQzVDO1FBRUQsSUFBSSxDQUFDLFVBQVUsQ0FBQyxRQUFRLENBQUMsU0FBUyxDQUFDLEVBQUU7WUFDbkMsTUFBTSxJQUFJLEtBQUssQ0FBQywyQ0FBMkMsQ0FBQyxDQUFDO1NBQzlEO1FBRUQsSUFBSSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsVUFBVSxDQUFDLEVBQUU7WUFDOUIsTUFBTSxJQUFJLEtBQUssQ0FBQywwQkFBMEIsVUFBVSxFQUFFLENBQUMsQ0FBQztTQUN6RDtJQUNILENBQUM7SUFFRDs7T0FFRztJQUNILE1BQU0sQ0FBQyxVQUFVLENBQUMsVUFBa0I7UUFDbEMsSUFBSTtZQUNGLE1BQU0sT0FBTyxHQUFHLEVBQUUsQ0FBQyxZQUFZLENBQUMsVUFBVSxFQUFFLE9BQU8sQ0FBQyxDQUFDO1lBQ3JELE1BQU0sU0FBUyxHQUFHLElBQUksQ0FBQyxLQUFLLENBQUMsT0FBTyxDQUFDLENBQUM7WUFFdEMsK0NBQStDO1lBQy9DLE9BQU8sSUFBQSxrQ0FBYyxFQUFDLFNBQVMsQ0FBQyxDQUFDO1NBQ2xDO1FBQUMsT0FBTyxLQUFLLEVBQUU7WUFDZCxJQUFJLEtBQUssWUFBWSxXQUFXLEVBQUU7Z0JBQ2hDLE1BQU0sSUFBSSxLQUFLLENBQUMsZ0NBQWdDLFVBQVUsRUFBRSxDQUFDLENBQUM7YUFDL0Q7WUFDRCwwQ0FBMEM7WUFDMUMsSUFBSSxLQUFLLFlBQVksS0FBSyxFQUFFO2dCQUMxQixNQUFNLElBQUksS0FBSyxDQUFDLGdDQUFnQyxVQUFVLEtBQUssS0FBSyxDQUFDLE9BQU8sRUFBRSxDQUFDLENBQUM7YUFDakY7WUFDRCxNQUFNLEtBQUssQ0FBQztTQUNiO0lBQ0gsQ0FBQztDQUNGO0FBdkNELHNDQXVDQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCAqIGFzIGZzIGZyb20gJ2ZzJztcbmltcG9ydCB7IFNjaGVtYURhdGEsIHZhbGlkYXRlU2NoZW1hIH0gZnJvbSAnQGNoYWltLXRvb2xzL2NoYWltLWJwcmludC1zcGVjJztcblxuZXhwb3J0IGNsYXNzIFNjaGVtYVNlcnZpY2Uge1xuICAvKipcbiAgICogVmFsaWRhdGVzIHRoYXQgdGhlIHNjaGVtYSBmaWxlIHBhdGggZXhpc3RzIGFuZCBoYXMgYSAuYnByaW50IGV4dGVuc2lvblxuICAgKi9cbiAgc3RhdGljIHZhbGlkYXRlU2NoZW1hUGF0aChzY2hlbWFQYXRoOiBzdHJpbmcpOiB2b2lkIHtcbiAgICBpZiAoIXNjaGVtYVBhdGgpIHtcbiAgICAgIHRocm93IG5ldyBFcnJvcignU2NoZW1hIHBhdGggaXMgcmVxdWlyZWQnKTtcbiAgICB9XG5cbiAgICBpZiAoIXNjaGVtYVBhdGguZW5kc1dpdGgoJy5icHJpbnQnKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdTY2hlbWEgZmlsZSBtdXN0IGhhdmUgYSAuYnByaW50IGV4dGVuc2lvbicpO1xuICAgIH1cblxuICAgIGlmICghZnMuZXhpc3RzU3luYyhzY2hlbWFQYXRoKSkge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKGBTY2hlbWEgZmlsZSBub3QgZm91bmQ6ICR7c2NoZW1hUGF0aH1gKTtcbiAgICB9XG4gIH1cblxuICAvKipcbiAgICogUmVhZHMgYW5kIHBhcnNlcyB0aGUgc2NoZW1hIGZpbGUgdXNpbmcgb3VyIGxvY2FsIHZhbGlkYXRvciBiYXNlZCBvbiB0aGUgb2ZmaWNpYWwgc3BlY1xuICAgKi9cbiAgc3RhdGljIHJlYWRTY2hlbWEoc2NoZW1hUGF0aDogc3RyaW5nKTogU2NoZW1hRGF0YSB7XG4gICAgdHJ5IHtcbiAgICAgIGNvbnN0IGNvbnRlbnQgPSBmcy5yZWFkRmlsZVN5bmMoc2NoZW1hUGF0aCwgJ3V0Zi04Jyk7XG4gICAgICBjb25zdCByYXdTY2hlbWEgPSBKU09OLnBhcnNlKGNvbnRlbnQpO1xuICAgICAgXG4gICAgICAvLyBVc2UgdGhlIG9mZmljaWFsIGNoYWltLWJwcmludC1zcGVjIHZhbGlkYXRvclxuICAgICAgcmV0dXJuIHZhbGlkYXRlU2NoZW1hKHJhd1NjaGVtYSk7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIGlmIChlcnJvciBpbnN0YW5jZW9mIFN5bnRheEVycm9yKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihgSW52YWxpZCBKU09OIGluIHNjaGVtYSBmaWxlOiAke3NjaGVtYVBhdGh9YCk7XG4gICAgICB9XG4gICAgICAvLyBSZS10aHJvdyB2YWxpZGF0aW9uIGVycm9ycyB3aXRoIGNvbnRleHRcbiAgICAgIGlmIChlcnJvciBpbnN0YW5jZW9mIEVycm9yKSB7XG4gICAgICAgIHRocm93IG5ldyBFcnJvcihgU2NoZW1hIHZhbGlkYXRpb24gZmFpbGVkIGZvciAke3NjaGVtYVBhdGh9OiAke2Vycm9yLm1lc3NhZ2V9YCk7XG4gICAgICB9XG4gICAgICB0aHJvdyBlcnJvcjtcbiAgICB9XG4gIH1cbn1cbiJdfQ==

package/lib/services/snapshot-cleanup.d.ts

@@ -0,0 +1,78 @@
+/**
+ * Options for snapshot cleanup operations.
+ */
+export interface CleanupOptions {
+    /**
+     * AWS account ID to scope cleanup.
+     * If undefined, operates on 'unknown' account (for local dev).
+     */
+    accountId?: string;
+    /**
+     * AWS region to scope cleanup.
+     * If undefined, operates on 'unknown' region (for local dev).
+     */
+    region?: string;
+    /**
+     * CDK stack name to scope cleanup.
+     * REQUIRED for PRUNE_STACK operations.
+     */
+    stackName: string;
+    /**
+     * If true, log cleanup operations to console.
+     * Default: false
+     */
+    verbose?: boolean;
+}
+/**
+ * Options for TTL-based cleanup.
+ */
+export interface TTLCleanupOptions {
+    /**
+     * Delete snapshots older than this many days.
+     * Default: 30 days
+     */
+    olderThanDays?: number;
+    /**
+     * If true, perform a dry run without deleting files.
+     * Default: false
+     */
+    dryRun?: boolean;
+    /**
+     * If true, log cleanup operations to console.
+     * Default: false
+     */
+    verbose?: boolean;
+}
+/**
+ * Result of a cleanup operation.
+ */
+export interface CleanupResult {
+    /** Number of snapshots deleted */
+    deletedCount: number;
+    /** Number of snapshots found but not deleted (dry run or errors) */
+    skippedCount: number;
+    /** Paths of deleted snapshot files */
+    deletedPaths: string[];
+    /** Errors encountered during cleanup */
+    errors: string[];
+}
+/**
+ * Delete all snapshots for a specific stack.
+ *
+ * This is the PRUNE_STACK behavior - scoped to a single stack only.
+ * Deletes: ~/.chaim/cache/snapshots/aws/{account}/{region}/{stackName}/
+ *
+ * @param options - Cleanup options
+ * @returns Cleanup result summary
+ */
+export declare function pruneStackSnapshots(options: CleanupOptions): CleanupResult;
+/**
+ * Delete snapshots older than a specified age (TTL cleanup).
+ *
+ * This is a maintenance operation that can be run periodically
+ * to clean up very old snapshots across all stacks.
+ *
+ * @param options - TTL cleanup options
+ * @returns Cleanup result summary
+ */
+export declare function pruneOldSnapshots(options?: TTLCleanupOptions): CleanupResult;