@chaim-tools/cdk-lib 0.1.0

package/lib/services/snapshot-cleanup.js

@@ -0,0 +1,220 @@
+"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.pruneOldSnapshots = exports.pruneStackSnapshots = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os_cache_paths_1 = require("./os-cache-paths");
+/**
+ * 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
+ */
+function pruneStackSnapshots(options) {
+    const { stackName, verbose = false } = options;
+    const result = {
+        deletedCount: 0,
+        skippedCount: 0,
+        deletedPaths: [],
+        errors: [],
+    };
+    if (!stackName) {
+        result.errors.push('stackName is required for pruneStackSnapshots');
+        return result;
+    }
+    const accountId = (0, os_cache_paths_1.normalizeAccountId)(options.accountId);
+    const region = (0, os_cache_paths_1.normalizeRegion)(options.region);
+    const stackDir = path.join((0, os_cache_paths_1.getSnapshotBaseDir)(), 'aws', accountId, region, stackName);
+    if (!fs.existsSync(stackDir)) {
+        if (verbose) {
+            console.log(`[Chaim] No snapshots found for stack: ${stackName}`);
+        }
+        return result;
+    }
+    if (verbose) {
+        console.log(`[Chaim] Pruning snapshots for stack: ${stackName}`);
+        console.log(`[Chaim] Path: ${stackDir}`);
+    }
+    try {
+        // Recursively delete stack directory
+        const snapshotFiles = collectSnapshotFiles(stackDir);
+        for (const filePath of snapshotFiles) {
+            try {
+                fs.unlinkSync(filePath);
+                result.deletedCount++;
+                result.deletedPaths.push(filePath);
+                if (verbose) {
+                    console.log(`[Chaim]   Deleted: ${path.relative(stackDir, filePath)}`);
+                }
+            }
+            catch (error) {
+                result.errors.push(`Failed to delete ${filePath}: ${error}`);
+                result.skippedCount++;
+            }
+        }
+        // Clean up empty directories
+        cleanEmptyDirectories(stackDir);
+        if (verbose) {
+            console.log(`[Chaim] Deleted ${result.deletedCount} snapshot(s)`);
+        }
+    }
+    catch (error) {
+        result.errors.push(`Failed to prune stack snapshots: ${error}`);
+    }
+    return result;
+}
+exports.pruneStackSnapshots = pruneStackSnapshots;
+/**
+ * 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
+ */
+function pruneOldSnapshots(options = {}) {
+    const { olderThanDays = 30, dryRun = false, verbose = false, } = options;
+    const result = {
+        deletedCount: 0,
+        skippedCount: 0,
+        deletedPaths: [],
+        errors: [],
+    };
+    const baseDir = (0, os_cache_paths_1.getSnapshotBaseDir)();
+    const now = Date.now();
+    const cutoffMs = olderThanDays * 24 * 60 * 60 * 1000;
+    if (verbose) {
+        console.log(`[Chaim] Scanning for snapshots older than ${olderThanDays} days...`);
+        console.log(`[Chaim] Base directory: ${baseDir}`);
+        if (dryRun) {
+            console.log(`[Chaim] DRY RUN - no files will be deleted`);
+        }
+    }
+    if (!fs.existsSync(baseDir)) {
+        if (verbose) {
+            console.log(`[Chaim] Snapshot directory does not exist: ${baseDir}`);
+        }
+        return result;
+    }
+    try {
+        const allSnapshots = collectSnapshotFiles(baseDir);
+        for (const filePath of allSnapshots) {
+            try {
+                const stats = fs.statSync(filePath);
+                const ageMs = now - stats.mtimeMs;
+                if (ageMs > cutoffMs) {
+                    const ageDays = Math.floor(ageMs / (24 * 60 * 60 * 1000));
+                    if (dryRun) {
+                        result.skippedCount++;
+                        if (verbose) {
+                            console.log(`[Chaim] Would delete (${ageDays} days old): ${filePath}`);
+                        }
+                    }
+                    else {
+                        fs.unlinkSync(filePath);
+                        result.deletedCount++;
+                        result.deletedPaths.push(filePath);
+                        if (verbose) {
+                            console.log(`[Chaim] Deleted (${ageDays} days old): ${filePath}`);
+                        }
+                    }
+                }
+            }
+            catch (error) {
+                result.errors.push(`Failed to process ${filePath}: ${error}`);
+                result.skippedCount++;
+            }
+        }
+        // Clean up empty directories (only if not dry run)
+        if (!dryRun) {
+            cleanEmptyDirectories(baseDir);
+        }
+        if (verbose) {
+            if (dryRun) {
+                console.log(`[Chaim] Would delete ${result.skippedCount} snapshot(s)`);
+            }
+            else {
+                console.log(`[Chaim] Deleted ${result.deletedCount} snapshot(s)`);
+            }
+        }
+    }
+    catch (error) {
+        result.errors.push(`Failed to prune old snapshots: ${error}`);
+    }
+    return result;
+}
+exports.pruneOldSnapshots = pruneOldSnapshots;
+/**
+ * Recursively collect all .json snapshot files in a directory.
+ */
+function collectSnapshotFiles(dir) {
+    const files = [];
+    if (!fs.existsSync(dir)) {
+        return files;
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    for (const entry of entries) {
+        const fullPath = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            files.push(...collectSnapshotFiles(fullPath));
+        }
+        else if (entry.isFile() && entry.name.endsWith('.json')) {
+            files.push(fullPath);
+        }
+    }
+    return files;
+}
+/**
+ * Recursively remove empty directories.
+ */
+function cleanEmptyDirectories(dir) {
+    if (!fs.existsSync(dir)) {
+        return;
+    }
+    const entries = fs.readdirSync(dir, { withFileTypes: true });
+    // First, recursively clean subdirectories
+    for (const entry of entries) {
+        if (entry.isDirectory()) {
+            const fullPath = path.join(dir, entry.name);
+            cleanEmptyDirectories(fullPath);
+        }
+    }
+    // Now check if directory is empty and remove it
+    const remainingEntries = fs.readdirSync(dir);
+    if (remainingEntries.length === 0) {
+        try {
+            fs.rmdirSync(dir);
+        }
+        catch {
+            // Ignore errors (directory might not be empty or might be in use)
+        }
+    }
+}
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic25hcHNob3QtY2xlYW51cC5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy9zZXJ2aWNlcy9zbmFwc2hvdC1jbGVhbnVwLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0FBQUEsdUNBQXlCO0FBQ3pCLDJDQUE2QjtBQUM3QixxREFBMkY7QUF1RTNGOzs7Ozs7OztHQVFHO0FBQ0gsU0FBZ0IsbUJBQW1CLENBQUMsT0FBdUI7SUFDekQsTUFBTSxFQUFFLFNBQVMsRUFBRSxPQUFPLEdBQUcsS0FBSyxFQUFFLEdBQUcsT0FBTyxDQUFDO0lBQy9DLE1BQU0sTUFBTSxHQUFrQjtRQUM1QixZQUFZLEVBQUUsQ0FBQztRQUNmLFlBQVksRUFBRSxDQUFDO1FBQ2YsWUFBWSxFQUFFLEVBQUU7UUFDaEIsTUFBTSxFQUFFLEVBQUU7S0FDWCxDQUFDO0lBRUYsSUFBSSxDQUFDLFNBQVMsRUFBRTtRQUNkLE1BQU0sQ0FBQyxNQUFNLENBQUMsSUFBSSxDQUFDLCtDQUErQyxDQUFDLENBQUM7UUFDcEUsT0FBTyxNQUFNLENBQUM7S0FDZjtJQUVELE1BQU0sU0FBUyxHQUFHLElBQUEsbUNBQWtCLEVBQUMsT0FBTyxDQUFDLFNBQVMsQ0FBQyxDQUFDO0lBQ3hELE1BQU0sTUFBTSxHQUFHLElBQUEsZ0NBQWUsRUFBQyxPQUFPLENBQUMsTUFBTSxDQUFDLENBQUM7SUFFL0MsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FDeEIsSUFBQSxtQ0FBa0IsR0FBRSxFQUNwQixLQUFLLEVBQ0wsU0FBUyxFQUNULE1BQU0sRUFDTixTQUFTLENBQ1YsQ0FBQztJQUVGLElBQUksQ0FBQyxFQUFFLENBQUMsVUFBVSxDQUFDLFFBQVEsQ0FBQyxFQUFFO1FBQzVCLElBQUksT0FBTyxFQUFFO1lBQ1gsT0FBTyxDQUFDLEdBQUcsQ0FBQyx5Q0FBeUMsU0FBUyxFQUFFLENBQUMsQ0FBQztTQUNuRTtRQUNELE9BQU8sTUFB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QixDQUFDLEdBQVc7SUFDeEMsSUFBSSxDQUFDLEVBQUUsQ0FBQyxVQUFVLENBQUMsR0FBRyxDQUFDLEVBQUU7UUFDdkIsT0FBTztLQUNSO0lBRUQsTUFBTSxPQUFPLEdBQUcsRUFBRSxDQUFDLFdBQVcsQ0FBQyxHQUFHLEVBQUUsRUFBRSxhQUFhLEVBQUUsSUFBSSxFQUFFLENBQUMsQ0FBQztJQUU3RCwwQ0FBMEM7SUFDMUMsS0FBSyxNQUFNLEtBQUssSUFBSSxPQUFPLEVBQUU7UUFDM0IsSUFBSSxLQUFLLENBQUMsV0FBVyxFQUFFLEVBQUU7WUFDdkIsTUFBTSxRQUFRLEdBQUcsSUFBSSxDQUFDLElBQUksQ0FBQyxHQUFHLEVBQUUsS0FBSyxDQUFDLElBQUksQ0FBQyxDQUFDO1lBQzVDLHFCQUFxQixDQUFDLFFBQVEsQ0FBQyxDQUFDO1NBQ2pDO0tBQ0Y7SUFFRCxnREFBZ0Q7SUFDaEQsTUFBTSxnQkFBZ0IsR0FBRyxFQUFFLENBQUMsV0FBVyxDQUFDLEdBQUcsQ0FBQyxDQUFDO0lBQzdDLElBQUksZ0JBQWdCLENBQUMsTUFBTSxLQUFLLENBQUMsRUFBRTtRQUNqQyxJQUFJO1lBQ0YsRUFBRSxDQUFDLFNBQVMsQ0FBQyxHQUFHLENBQUMsQ0FBQztTQUNuQjtRQUFDLE1BQU07WUFDTixrRUFBa0U7U0FDbkU7S0FDRjtBQUNILENBQUMiLCJzb3VyY2VzQ29udGVudCI6WyJpbXBvcnQgKiBhcyBmcyBmcm9tICdmcyc7XG5pbXBvcnQgKiBhcyBwYXRoIGZyb20gJ3BhdGgnO1xuaW1wb3J0IHsgZ2V0U25hcHNob3RCYXNlRGlyLCBub3JtYWxpemVBY2NvdW50SWQsIG5vcm1hbGl6ZVJlZ2lvbiB9IGZyb20gJy4vb3MtY2FjaGUtcGF0aHMnO1xuXG4vKipcbiAqIE9wdGlvbnMgZm9yIHNuYXBzaG90IGNsZWFudXAgb3BlcmF0aW9ucy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDbGVhbnVwT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBBV1MgYWNjb3VudCBJRCB0byBzY29wZSBjbGVhbnVwLlxuICAgKiBJZiB1bmRlZmluZWQsIG9wZXJhdGVzIG9uICd1bmtub3duJyBhY2NvdW50IChmb3IgbG9jYWwgZGV2KS5cbiAgICovXG4gIGFjY291bnRJZD86IHN0cmluZztcblxuICAvKipcbiAgICogQVdTIHJlZ2lvbiB0byBzY29wZSBjbGVhbnVwLlxuICAgKiBJZiB1bmRlZmluZWQsIG9wZXJhdGVzIG9uICd1bmtub3duJyByZWdpb24gKGZvciBsb2NhbCBkZXYpLlxuICAgKi9cbiAgcmVnaW9uPzogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBDREsgc3RhY2sgbmFtZSB0byBzY29wZSBjbGVhbnVwLlxuICAgKiBSRVFVSVJFRCBmb3IgUFJVTkVfU1RBQ0sgb3BlcmF0aW9ucy5cbiAgICovXG4gIHN0YWNrTmFtZTogc3RyaW5nO1xuXG4gIC8qKlxuICAgKiBJZiB0cnVlLCBsb2cgY2xlYW51cCBvcGVyYXRpb25zIHRvIGNvbnNvbGUuXG4gICAqIERlZmF1bHQ6IGZhbHNlXG4gICAqL1xuICB2ZXJib3NlPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBPcHRpb25zIGZvciBUVEwtYmFzZWQgY2xlYW51cC5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUVExDbGVhbnVwT3B0aW9ucyB7XG4gIC8qKlxuICAgKiBEZWxldGUgc25hcHNob3RzIG9sZGVyIHRoYW4gdGhpcyBtYW55IGRheXMuXG4gICAqIERlZmF1bHQ6IDMwIGRheXNcbiAgICovXG4gIG9sZGVyVGhhbkRheXM/OiBudW1iZXI7XG5cbiAgLyoqXG4gICAqIElmIHRydWUsIHBlcmZvcm0gYSBkcnkgcnVuIHdpdGhvdXQgZGVsZXRpbmcgZmlsZXMuXG4gICAqIERlZmF1bHQ6IGZhbHNlXG4gICAqL1xuICBkcnlSdW4/OiBib29sZWFuO1xuXG4gIC8qKlxuICAgKiBJZiB0cnVlLCBsb2cgY2xlYW51cCBvcGVyYXRpb25zIHRvIGNvbnNvbGUuXG4gICAqIERlZmF1bHQ6IGZhbHNlXG4gICAqL1xuICB2ZXJib3NlPzogYm9vbGVhbjtcbn1cblxuLyoqXG4gKiBSZXN1bHQgb2YgYSBjbGVhbnVwIG9wZXJhdGlvbi5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBDbGVhbnVwUmVzdWx0IHtcbiAgLyoqIE51bWJlciBvZiBzbmFwc2hvdHMgZGVsZXRlZCAqL1xuICBkZWxldGVkQ291bnQ6IG51bWJlcjtcblxuICAvKiogTnVtYmVyIG9mIHNuYXBzaG90cyBmb3VuZCBidXQgbm90IGRlbGV0ZWQgKGRyeSBydW4gb3IgZXJyb3JzKSAqL1xuICBza2lwcGVkQ291bnQ6IG51bWJlcjtcblxuICAvKiogUGF0aHMgb2YgZGVsZXRlZCBzbmFwc2hvdCBmaWxlcyAqL1xuICBkZWxldGVkUGF0aHM6IHN0cmluZ1tdO1xuXG4gIC8qKiBFcnJvcnMgZW5jb3VudGVyZWQgZHVyaW5nIGNsZWFudXAgKi9cbiAgZXJyb3JzOiBzdHJpbmdbXTtcbn1cblxuLyoqXG4gKiBEZWxldGUgYWxsIHNuYXBzaG90cyBmb3IgYSBzcGVjaWZpYyBzdGFjay5cbiAqIFxuICogVGhpcyBpcyB0aGUgUFJVTkVfU1RBQ0sgYmVoYXZpb3IgLSBzY29wZWQgdG8gYSBzaW5nbGUgc3RhY2sgb25seS5cbiAqIERlbGV0ZXM6IH4vLmNoYWltL2NhY2hlL3NuYXBzaG90cy9hd3Mve2FjY291bnR9L3tyZWdpb259L3tzdGFja05hbWV9L1xuICogXG4gKiBAcGFyYW0gb3B0aW9ucyAtIENsZWFudXAgb3B0aW9uc1xuICogQHJldHVybnMgQ2xlYW51cCByZXN1bHQgc3VtbWFyeVxuICovXG5leHBvcnQgZnVuY3Rpb24gcHJ1bmVTdGFja1NuYXBzaG90cyhvcHRpb25zOiBDbGVhbnVwT3B0aW9ucyk6IENsZWFudXBSZXN1bHQge1xuICBjb25zdCB7IHN0YWNrTmFtZSwgdmVyYm9zZSA9IGZhbHNlIH0gPSBvcHRpb25zO1xuICBjb25zdCByZXN1bHQ6IENsZWFudXBSZXN1bHQgPSB7XG4gICAgZGVsZXRlZENvdW50OiAwLFxuICAgIHNraXBwZWRDb3VudDogMCxcbiAgICBkZWxldGVkUGF0aHM6IFtdLFxuICAgIGVycm9yczogW10sXG4gIH07XG5cbiAgaWYgKCFzdGFja05hbWUpIHtcbiAgICByZXN1bHQuZXJyb3JzLnB1c2goJ3N0YWNrTmFtZSBpcyByZXF1aXJlZCBmb3IgcHJ1bmVTdGFja1NuYXBzaG90cycpO1xuICAgIHJldHVybiByZXN1bHQ7XG4gIH1cblxuICBjb25zdCBhY2NvdW50SWQgPSBub3JtYWxpemVBY2NvdW50SWQob3B0aW9ucy5hY2NvdW50SWQpO1xuICBjb25zdCByZWdpb24gPSBub3JtYWxpemVSZWdpb24ob3B0aW9ucy5yZWdpb24pO1xuXG4gIGNvbnN0IHN0YWNrRGlyID0gcGF0aC5qb2luKFxuICAgIGdldFNuYXBzaG90QmFzZURpcigpLFxuICAgICdhd3MnLFxuICAgIGFjY291bnRJZCxcbiAgICByZWdpb24sXG4gICAgc3RhY2tOYW1lXG4gICk7XG5cbiAgaWYgKCFmcy5leGlzdHNTeW5jKHN0YWNrRGlyKSkge1xuICAgIGlmICh2ZXJib3NlKSB7XG4gICAgICBjb25zb2xlLmxvZyhgW0NoYWltXSBObyBzbmFwc2hvdHMgZm91bmQgZm9yIHN0YWNrOiAke3N0YWNrTmFtZX1gKTtcbiAgICB9XG4gICAgcmV0dXJuIHJlc3VsdDtcbiAgfVxuXG4gIGlmICh2ZXJib3NlKSB7XG4gICAgY29uc29sZS5sb2coYFtDaGFpbV0gUHJ1bmluZyBzbmFwc2hvdHMgZm9yIHN0YWNrOiAke3N0YWNrTmFtZX1gKTtcbiAgICBjb25zb2xlLmxvZyhgW0NoYWltXSBQYXRoOiAke3N0YWNrRGlyfWApO1xuICB9XG5cbiAgdHJ5IHtcbiAgICAvLyBSZWN1cnNpdmVseSBkZWxldGUgc3RhY2sgZGlyZWN0b3J5XG4gICAgY29uc3Qgc25hcHNob3RGaWxlcyA9IGNvbGxlY3RTbmFwc2hvdEZpbGVzKHN0YWNrRGlyKTtcbiAgICBcbiAgICBmb3IgKGNvbnN0IGZpbGVQYXRoIG9mIHNuYXBzaG90RmlsZXMpIHtcbiAgICAgIHRyeSB7XG4gICAgICAgIGZzLnVubGlua1N5bmMoZmlsZVBhdGgpO1xuICAgICAgICByZXN1bHQuZGVsZXRlZENvdW50Kys7XG4gICAgICAgIHJlc3VsdC5kZWxldGVkUGF0aHMucHVzaChmaWxlUGF0aCk7XG4gICAgICAgIFxuICAgICAgICBpZiAodmVyYm9zZSkge1xuICAgICAgICAgIGNvbnNvbGUubG9nKGBbQ2hhaW1dICAgRGVsZXRlZDogJHtwYXRoLnJlbGF0aXZlKHN0YWNrRGlyLCBmaWxlUGF0aCl9YCk7XG4gICAgICAgIH1cbiAgICAgIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgICAgIHJlc3VsdC5lcnJvcnMucHVzaChgRmFpbGVkIHRvIGRlbGV0ZSAke2ZpbGVQYXRofTogJHtlcnJvcn1gKTtcbiAgICAgICAgcmVzdWx0LnNraXBwZWRDb3VudCsrO1xuICAgICAgfVxuICAgIH1cblxuICAgIC8vIENsZWFuIHVwIGVtcHR5IGRpcmVjdG9yaWVzXG4gICAgY2xlYW5FbXB0eURpcmVjdG9yaWVzKHN0YWNrRGlyKTtcblxuICAgIGlmICh2ZXJib3NlKSB7XG4gICAgICBjb25zb2xlLmxvZyhgW0NoYWltXSBEZWxldGVkICR7cmVzdWx0LmRlbGV0ZWRDb3VudH0gc25hcHNob3QocylgKTtcbiAgICB9XG4gIH0gY2F0Y2ggKGVycm9yKSB7XG4gICAgcmVzdWx0LmVycm9ycy5wdXNoKGBGYWlsZWQgdG8gcHJ1bmUgc3RhY2sgc25hcHNob3RzOiAke2Vycm9yfWApO1xuICB9XG5cbiAgcmV0dXJuIHJlc3VsdDtcbn1cblxuLyoqXG4gKiBEZWxldGUgc25hcHNob3RzIG9sZGVyIHRoYW4gYSBzcGVjaWZpZWQgYWdlIChUVEwgY2xlYW51cCkuXG4gKiBcbiAqIFRoaXMgaXMgYSBtYWludGVuYW5jZSBvcGVyYXRpb24gdGhhdCBjYW4gYmUgcnVuIHBlcmlvZGljYWxseVxuICogdG8gY2xlYW4gdXAgdmVyeSBvbGQgc25hcHNob3RzIGFjcm9zcyBhbGwgc3RhY2tzLlxuICogXG4gKiBAcGFyYW0gb3B0aW9ucyAtIFRUTCBjbGVhbnVwIG9wdGlvbnNcbiAqIEByZXR1cm5zIENsZWFudXAgcmVzdWx0IHN1bW1hcnlcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHBydW5lT2xkU25hcHNob3RzKG9wdGlvbnM6IFRUTENsZWFudXBPcHRpb25zID0ge30pOiBDbGVhbnVwUmVzdWx0IHtcbiAgY29uc3Qge1xuICAgIG9sZGVyVGhhbkRheXMgPSAzMCxcbiAgICBkcnlSdW4gPSBmYWxzZSxcbiAgICB2ZXJib3NlID0gZmFsc2UsXG4gIH0gPSBvcHRpb25zO1xuXG4gIGNvbnN0IHJlc3VsdDogQ2xlYW51cFJlc3VsdCA9IHtcbiAgICBkZWxldGVkQ291bnQ6IDAsXG4gICAgc2tpcHBlZENvdW50OiAwLFxuICAgIGRlbGV0ZWRQYXRoczogW10sXG4gICAgZXJyb3JzOiBbXSxcbiAgfTtcblxuICBjb25zdCBiYXNlRGlyID0gZ2V0U25hcHNob3RCYXNlRGlyKCk7XG4gIGNvbnN0IG5vdyA9IERhdGUubm93KCk7XG4gIGNvbnN0IGN1dG9mZk1zID0gb2xkZXJUaGFuRGF5cyAqIDI0ICogNjAgKiA2MCAqIDEwMDA7XG5cbiAgaWYgKHZlcmJvc2UpIHtcbiAgICBjb25zb2xlLmxvZyhgW0NoYWltXSBTY2FubmluZyBmb3Igc25hcHNob3RzIG9sZGVyIHRoYW4gJHtvbGRlclRoYW5EYXlzfSBkYXlzLi4uYCk7XG4gICAgY29uc29sZS5sb2coYFtDaGFpbV0gQmFzZSBkaXJlY3Rvcnk6ICR7YmFzZURpcn1gKTtcbiAgICBpZiAoZHJ5UnVuKSB7XG4gICAgICBjb25zb2xlLmxvZyhgW0NoYWltXSBEUlkgUlVOIC0gbm8gZmlsZXMgd2lsbCBiZSBkZWxldGVkYCk7XG4gICAgfVxuICB9XG5cbiAgaWYgKCFmcy5leGlzdHNTeW5jKGJhc2VEaXIpKSB7XG4gICAgaWYgKHZlcmJvc2UpIHtcbiAgICAgIGNvbnNvbGUubG9nKGBbQ2hhaW1dIFNuYXBzaG90IGRpcmVjdG9yeSBkb2VzIG5vdCBleGlzdDogJHtiYXNlRGlyfWApO1xuICAgIH1cbiAgICByZXR1cm4gcmVzdWx0O1xuICB9XG5cbiAgdHJ5IHtcbiAgICBjb25zdCBhbGxTbmFwc2hvdHMgPSBjb2xsZWN0U25hcHNob3RGaWxlcyhiYXNlRGlyKTtcblxuICAgIGZvciAoY29uc3QgZmlsZVBhdGggb2YgYWxsU25hcHNob3RzKSB7XG4gICAgICB0cnkge1xuICAgICAgICBjb25zdCBzdGF0cyA9IGZzLnN0YXRTeW5jKGZpbGVQYXRoKTtcbiAgICAgICAgY29uc3QgYWdlTXMgPSBub3cgLSBzdGF0cy5tdGltZU1zO1xuXG4gICAgICAgIGlmIChhZ2VNcyA+IGN1dG9mZk1zKSB7XG4gICAgICAgICAgY29uc3QgYWdlRGF5cyA9IE1hdGguZmxvb3IoYWdlTXMgLyAoMjQgKiA2MCAqIDYwICogMTAwMCkpO1xuICAgICAgICAgIFxuICAgICAgICAgIGlmIChkcnlSdW4pIHtcbiAgICAgICAgICAgIHJlc3VsdC5za2lwcGVkQ291bnQrKztcbiAgICAgICAgICAgIGlmICh2ZXJib3NlKSB7XG4gICAgICAgICAgICAgIGNvbnNvbGUubG9nKGBbQ2hhaW1dIFdvdWxkIGRlbGV0ZSAoJHthZ2VEYXlzfSBkYXlzIG9sZCk6ICR7ZmlsZVBhdGh9YCk7XG4gICAgICAgICAgICB9XG4gICAgICAgICAgfSBlbHNlIHtcbiAgICAgICAgICAgIGZzLnVubGlua1N5bmMoZmlsZVBhdGgpO1xuICAgICAgICAgICAgcmVzdWx0LmRlbGV0ZWRDb3VudCsrO1xuICAgICAgICAgICAgcmVzdWx0LmRlbGV0ZWRQYXRocy5wdXNoKGZpbGVQYXRoKTtcbiAgICAgICAgICAgIFxuICAgICAgICAgICAgaWYgKHZlcmJvc2UpIHtcbiAgICAgICAgICAgICAgY29uc29sZS5sb2coYFtDaGFpbV0gRGVsZXRlZCAoJHthZ2VEYXlzfSBkYXlzIG9sZCk6ICR7ZmlsZVBhdGh9YCk7XG4gICAgICAgICAgICB9XG4gICAgICAgICAgfVxuICAgICAgICB9XG4gICAgICB9IGNhdGNoIChlcnJvcikge1xuICAgICAgICByZXN1bHQuZXJyb3JzLnB1c2goYEZhaWxlZCB0byBwcm9jZXNzICR7ZmlsZVBhdGh9OiAke2Vycm9yfWApO1xuICAgICAgICByZXN1bHQuc2tpcHBlZENvdW50Kys7XG4gICAgICB9XG4gICAgfVxuXG4gICAgLy8gQ2xlYW4gdXAgZW1wdHkgZGlyZWN0b3JpZXMgKG9ubHkgaWYgbm90IGRyeSBydW4pXG4gICAgaWYgKCFkcnlSdW4pIHtcbiAgICAgIGNsZWFuRW1wdHlEaXJlY3RvcmllcyhiYXNlRGlyKTtcbiAgICB9XG5cbiAgICBpZiAodmVyYm9zZSkge1xuICAgICAgaWYgKGRyeVJ1bikge1xuICAgICAgICBjb25zb2xlLmxvZyhgW0NoYWltXSBXb3VsZCBkZWxldGUgJHtyZXN1bHQuc2tpcHBlZENvdW50fSBzbmFwc2hvdChzKWApO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgY29uc29sZS5sb2coYFtDaGFpbV0gRGVsZXRlZCAke3Jlc3VsdC5kZWxldGVkQ291bnR9IHNuYXBzaG90KHMpYCk7XG4gICAgICB9XG4gICAgfVxuICB9IGNhdGNoIChlcnJvcikge1xuICAgIHJlc3VsdC5lcnJvcnMucHVzaChgRmFpbGVkIHRvIHBydW5lIG9sZCBzbmFwc2hvdHM6ICR7ZXJyb3J9YCk7XG4gIH1cblxuICByZXR1cm4gcmVzdWx0O1xufVxuXG4vKipcbiAqIFJlY3Vyc2l2ZWx5IGNvbGxlY3QgYWxsIC5qc29uIHNuYXBzaG90IGZpbGVzIGluIGEgZGlyZWN0b3J5LlxuICovXG5mdW5jdGlvbiBjb2xsZWN0U25hcHNob3RGaWxlcyhkaXI6IHN0cmluZyk6IHN0cmluZ1tdIHtcbiAgY29uc3QgZmlsZXM6IHN0cmluZ1tdID0gW107XG5cbiAgaWYgKCFmcy5leGlzdHNTeW5jKGRpcikpIHtcbiAgICByZXR1cm4gZmlsZXM7XG4gIH1cblxuICBjb25zdCBlbnRyaWVzID0gZnMucmVhZGRpclN5bmMoZGlyLCB7IHdpdGhGaWxlVHlwZXM6IHRydWUgfSk7XG5cbiAgZm9yIChjb25zdCBlbnRyeSBvZiBlbnRyaWVzKSB7XG4gICAgY29uc3QgZnVsbFBhdGggPSBwYXRoLmpvaW4oZGlyLCBlbnRyeS5uYW1lKTtcblxuICAgIGlmIChlbnRyeS5pc0RpcmVjdG9yeSgpKSB7XG4gICAgICBmaWxlcy5wdXNoKC4uLmNvbGxlY3RTbmFwc2hvdEZpbGVzKGZ1bGxQYXRoKSk7XG4gICAgfSBlbHNlIGlmIChlbnRyeS5pc0ZpbGUoKSAmJiBlbnRyeS5uYW1lLmVuZHNXaXRoKCcuanNvbicpKSB7XG4gICAgICBmaWxlcy5wdXNoKGZ1bGxQYXRoKTtcbiAgICB9XG4gIH1cblxuICByZXR1cm4gZmlsZXM7XG59XG5cbi8qKlxuICogUmVjdXJzaXZlbHkgcmVtb3ZlIGVtcHR5IGRpcmVjdG9yaWVzLlxuICovXG5mdW5jdGlvbiBjbGVhbkVtcHR5RGlyZWN0b3JpZXMoZGlyOiBzdHJpbmcpOiB2b2lkIHtcbiAgaWYgKCFmcy5leGlzdHNTeW5jKGRpcikpIHtcbiAgICByZXR1cm47XG4gIH1cblxuICBjb25zdCBlbnRyaWVzID0gZnMucmVhZGRpclN5bmMoZGlyLCB7IHdpdGhGaWxlVHlwZXM6IHRydWUgfSk7XG5cbiAgLy8gRmlyc3QsIHJlY3Vyc2l2ZWx5IGNsZWFuIHN1YmRpcmVjdG9yaWVzXG4gIGZvciAoY29uc3QgZW50cnkgb2YgZW50cmllcykge1xuICAgIGlmIChlbnRyeS5pc0RpcmVjdG9yeSgpKSB7XG4gICAgICBjb25zdCBmdWxsUGF0aCA9IHBhdGguam9pbihkaXIsIGVudHJ5Lm5hbWUpO1xuICAgICAgY2xlYW5FbXB0eURpcmVjdG9yaWVzKGZ1bGxQYXRoKTtcbiAgICB9XG4gIH1cblxuICAvLyBOb3cgY2hlY2sgaWYgZGlyZWN0b3J5IGlzIGVtcHR5IGFuZCByZW1vdmUgaXRcbiAgY29uc3QgcmVtYWluaW5nRW50cmllcyA9IGZzLnJlYWRkaXJTeW5jKGRpcik7XG4gIGlmIChyZW1haW5pbmdFbnRyaWVzLmxlbmd0aCA9PT0gMCkge1xuICAgIHRyeSB7XG4gICAgICBmcy5ybWRpclN5bmMoZGlyKTtcbiAgICB9IGNhdGNoIHtcbiAgICAgIC8vIElnbm9yZSBlcnJvcnMgKGRpcmVjdG9yeSBtaWdodCBub3QgYmUgZW1wdHkgb3IgbWlnaHQgYmUgaW4gdXNlKVxuICAgIH1cbiAgfVxufVxuIl19

package/lib/types/base-binder-props.d.ts

@@ -0,0 +1,32 @@
+import { TableBindingConfig } from './table-binding-config';
+/**
+ * Base properties shared by all Chaim data store binders.
+ */
+export interface BaseBinderProps {
+    /** Path to the .bprint schema file (JSON format) */
+    readonly schemaPath: string;
+    /**
+     * Binding configuration (appId, credentials, failureMode).
+     *
+     * For single-table design, create one config and share across all entity bindings.
+     *
+     * @example
+     * ```typescript
+     * const config = new TableBindingConfig(
+     *   'my-app',
+     *   ChaimCredentials.fromSecretsManager('chaim/api-credentials')
+     * );
+     *
+     * new ChaimDynamoDBBinder(this, 'UserBinding', {
+     *   schemaPath: './schemas/user.bprint',
+     *   table: usersTable,
+     *   config,
+     * });
+     * ```
+     */
+    readonly config: TableBindingConfig;
+}
+/**
+ * Validate binder props.
+ */
+export declare function validateBinderProps(props: BaseBinderProps): void;

package/lib/types/base-binder-props.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateBinderProps = void 0;
+/**
+ * Validate binder props.
+ */
+function validateBinderProps(props) {
+    if (!props.schemaPath || props.schemaPath.trim() === '') {
+        throw new Error('schemaPath is required and cannot be empty');
+    }
+    if (!props.config) {
+        throw new Error('config is required. Create a TableBindingConfig with your appId and credentials.');
+    }
+    // TableBindingConfig validates itself in its constructor
+}
+exports.validateBinderProps = validateBinderProps;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiYmFzZS1iaW5kZXItcHJvcHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvYmFzZS1iaW5kZXItcHJvcHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBK0JBOztHQUVHO0FBQ0gsU0FBZ0IsbUJBQW1CLENBQUMsS0FBc0I7SUFDeEQsSUFBSSxDQUFDLEtBQUssQ0FBQyxVQUFVLElBQUksS0FBSyxDQUFDLFVBQVUsQ0FBQyxJQUFJLEVBQUUsS0FBSyxFQUFFLEVBQUU7UUFDdkQsTUFBTSxJQUFJLEtBQUssQ0FBQyw0Q0FBNEMsQ0FBQyxDQUFDO0tBQy9EO0lBRUQsSUFBSSxDQUFDLEtBQUssQ0FBQyxNQUFNLEVBQUU7UUFDakIsTUFBTSxJQUFJLEtBQUssQ0FBQyxrRkFBa0YsQ0FBQyxDQUFDO0tBQ3JHO0lBRUQseURBQXlEO0FBQzNELENBQUM7QUFWRCxrREFVQyIsInNvdXJjZXNDb250ZW50IjpbImltcG9ydCB7IFRhYmxlQmluZGluZ0NvbmZpZyB9IGZyb20gJy4vdGFibGUtYmluZGluZy1jb25maWcnO1xuXG4vKipcbiAqIEJhc2UgcHJvcGVydGllcyBzaGFyZWQgYnkgYWxsIENoYWltIGRhdGEgc3RvcmUgYmluZGVycy5cbiAqL1xuZXhwb3J0IGludGVyZmFjZSBCYXNlQmluZGVyUHJvcHMge1xuICAvKiogUGF0aCB0byB0aGUgLmJwcmludCBzY2hlbWEgZmlsZSAoSlNPTiBmb3JtYXQpICovXG4gIHJlYWRvbmx5IHNjaGVtYVBhdGg6IHN0cmluZztcblxuICAvKiogXG4gICAqIEJpbmRpbmcgY29uZmlndXJhdGlvbiAoYXBwSWQsIGNyZWRlbnRpYWxzLCBmYWlsdXJlTW9kZSkuXG4gICAqIFxuICAgKiBGb3Igc2luZ2xlLXRhYmxlIGRlc2lnbiwgY3JlYXRlIG9uZSBjb25maWcgYW5kIHNoYXJlIGFjcm9zcyBhbGwgZW50aXR5IGJpbmRpbmdzLlxuICAgKiBcbiAgICogQGV4YW1wbGVcbiAgICogYGBgdHlwZXNjcmlwdFxuICAgKiBjb25zdCBjb25maWcgPSBuZXcgVGFibGVCaW5kaW5nQ29uZmlnKFxuICAgKiAgICdteS1hcHAnLFxuICAgKiAgIENoYWltQ3JlZGVudGlhbHMuZnJvbVNlY3JldHNNYW5hZ2VyKCdjaGFpbS9hcGktY3JlZGVudGlhbHMnKVxuICAgKiApO1xuICAgKiBcbiAgICogbmV3IENoYWltRHluYW1vREJCaW5kZXIodGhpcywgJ1VzZXJCaW5kaW5nJywge1xuICAgKiAgIHNjaGVtYVBhdGg6ICcuL3NjaGVtYXMvdXNlci5icHJpbnQnLFxuICAgKiAgIHRhYmxlOiB1c2Vyc1RhYmxlLFxuICAgKiAgIGNvbmZpZyxcbiAgICogfSk7XG4gICAqIGBgYFxuICAgKi9cbiAgcmVhZG9ubHkgY29uZmlnOiBUYWJsZUJpbmRpbmdDb25maWc7XG59XG5cbi8qKlxuICogVmFsaWRhdGUgYmluZGVyIHByb3BzLlxuICovXG5leHBvcnQgZnVuY3Rpb24gdmFsaWRhdGVCaW5kZXJQcm9wcyhwcm9wczogQmFzZUJpbmRlclByb3BzKTogdm9pZCB7XG4gIGlmICghcHJvcHMuc2NoZW1hUGF0aCB8fCBwcm9wcy5zY2hlbWFQYXRoLnRyaW0oKSA9PT0gJycpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoJ3NjaGVtYVBhdGggaXMgcmVxdWlyZWQgYW5kIGNhbm5vdCBiZSBlbXB0eScpO1xuICB9XG5cbiAgaWYgKCFwcm9wcy5jb25maWcpIHtcbiAgICB0aHJvdyBuZXcgRXJyb3IoJ2NvbmZpZyBpcyByZXF1aXJlZC4gQ3JlYXRlIGEgVGFibGVCaW5kaW5nQ29uZmlnIHdpdGggeW91ciBhcHBJZCBhbmQgY3JlZGVudGlhbHMuJyk7XG4gIH1cblxuICAvLyBUYWJsZUJpbmRpbmdDb25maWcgdmFsaWRhdGVzIGl0c2VsZiBpbiBpdHMgY29uc3RydWN0b3Jcbn1cbiJdfQ==

package/lib/types/credentials.d.ts

@@ -0,0 +1,57 @@
+/**
+ * Interface for Chaim API credentials.
+ * Use ChaimCredentials factory methods to create instances.
+ */
+export interface IChaimCredentials {
+    /** The type of credential configuration */
+    readonly credentialType: 'secretsManager' | 'direct';
+    /** Secret name in AWS Secrets Manager (only for secretsManager type) */
+    readonly secretName?: string;
+    /** API key for direct authentication (only for direct type) */
+    readonly apiKey?: string;
+    /** API secret for direct authentication (only for direct type) */
+    readonly apiSecret?: string;
+}
+/**
+ * Factory class for creating Chaim API credentials.
+ *
+ * @example
+ * ```typescript
+ * // Using AWS Secrets Manager (recommended for production)
+ * const credentials = ChaimCredentials.fromSecretsManager('chaim/api-credentials');
+ *
+ * // Using direct API keys (for development/testing)
+ * const credentials = ChaimCredentials.fromApiKeys(
+ *   process.env.CHAIM_API_KEY!,
+ *   process.env.CHAIM_API_SECRET!
+ * );
+ * ```
+ */
+export declare class ChaimCredentials {
+    /**
+     * Create credentials from AWS Secrets Manager.
+     *
+     * The secret must contain JSON with `apiKey` and `apiSecret` fields:
+     * ```json
+     * {
+     *   "apiKey": "your-chaim-api-key",
+     *   "apiSecret": "your-chaim-api-secret"
+     * }
+     * ```
+     *
+     * @param secretName - The name or ARN of the secret in AWS Secrets Manager
+     * @returns Credentials configured to use Secrets Manager
+     */
+    static fromSecretsManager(secretName: string): IChaimCredentials;
+    /**
+     * Create credentials from direct API key and secret.
+     *
+     * Note: For production deployments, prefer `fromSecretsManager()` to avoid
+     * exposing credentials in CDK code or environment variables.
+     *
+     * @param apiKey - The Chaim API key
+     * @param apiSecret - The Chaim API secret
+     * @returns Credentials configured with direct API keys
+     */
+    static fromApiKeys(apiKey: string, apiSecret: string): IChaimCredentials;
+}

package/lib/types/credentials.js

@@ -0,0 +1,83 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChaimCredentials = void 0;
+/**
+ * Internal implementation for Secrets Manager credentials.
+ */
+class SecretsManagerCredentials {
+    credentialType = 'secretsManager';
+    secretName;
+    constructor(secretName) {
+        if (!secretName || secretName.trim() === '') {
+            throw new Error('secretName is required and cannot be empty');
+        }
+        this.secretName = secretName;
+    }
+}
+/**
+ * Internal implementation for direct API credentials.
+ */
+class DirectCredentials {
+    credentialType = 'direct';
+    apiKey;
+    apiSecret;
+    constructor(apiKey, apiSecret) {
+        if (!apiKey || apiKey.trim() === '') {
+            throw new Error('apiKey is required and cannot be empty');
+        }
+        if (!apiSecret || apiSecret.trim() === '') {
+            throw new Error('apiSecret is required and cannot be empty');
+        }
+        this.apiKey = apiKey;
+        this.apiSecret = apiSecret;
+    }
+}
+/**
+ * Factory class for creating Chaim API credentials.
+ *
+ * @example
+ * ```typescript
+ * // Using AWS Secrets Manager (recommended for production)
+ * const credentials = ChaimCredentials.fromSecretsManager('chaim/api-credentials');
+ *
+ * // Using direct API keys (for development/testing)
+ * const credentials = ChaimCredentials.fromApiKeys(
+ *   process.env.CHAIM_API_KEY!,
+ *   process.env.CHAIM_API_SECRET!
+ * );
+ * ```
+ */
+class ChaimCredentials {
+    /**
+     * Create credentials from AWS Secrets Manager.
+     *
+     * The secret must contain JSON with `apiKey` and `apiSecret` fields:
+     * ```json
+     * {
+     *   "apiKey": "your-chaim-api-key",
+     *   "apiSecret": "your-chaim-api-secret"
+     * }
+     * ```
+     *
+     * @param secretName - The name or ARN of the secret in AWS Secrets Manager
+     * @returns Credentials configured to use Secrets Manager
+     */
+    static fromSecretsManager(secretName) {
+        return new SecretsManagerCredentials(secretName);
+    }
+    /**
+     * Create credentials from direct API key and secret.
+     *
+     * Note: For production deployments, prefer `fromSecretsManager()` to avoid
+     * exposing credentials in CDK code or environment variables.
+     *
+     * @param apiKey - The Chaim API key
+     * @param apiSecret - The Chaim API secret
+     * @returns Credentials configured with direct API keys
+     */
+    static fromApiKeys(apiKey, apiSecret) {
+        return new DirectCredentials(apiKey, apiSecret);
+    }
+}
+exports.ChaimCredentials = ChaimCredentials;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiY3JlZGVudGlhbHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi9zcmMvdHlwZXMvY3JlZGVudGlhbHMudHMiXSwibmFtZXMiOltdLCJtYXBwaW5ncyI6Ijs7O0FBa0JBOztHQUVHO0FBQ0gsTUFBTSx5QkFBeUI7SUFDYixjQUFjLEdBQUcsZ0JBQXlCLENBQUM7SUFDM0MsVUFBVSxDQUFTO0lBRW5DLFlBQVksVUFBa0I7UUFDNUIsSUFBSSxDQUFDLFVBQVUsSUFBSSxVQUFVLENBQUMsSUFBSSxFQUFFLEtBQUssRUFBRSxFQUFFO1lBQzNDLE1BQU0sSUFBSSxLQUFLLENBQUMsNENBQTRDLENBQUMsQ0FBQztTQUMvRDtRQUNELElBQUksQ0FBQyxVQUFVLEdBQUcsVUFBVSxDQUFDO0lBQy9CLENBQUM7Q0FDRjtBQUVEOztHQUVHO0FBQ0gsTUFBTSxpQkFBaUI7SUFDTCxjQUFjLEdBQUcsUUFBaUIsQ0FBQztJQUNuQyxNQUFNLENBQVM7SUFDZixTQUFTLENBQVM7SUFFbEMsWUFBWSxNQUFjLEVBQUUsU0FBaUI7UUFDM0MsSUFBSSxDQUFDLE1BQU0sSUFBSSxNQUFNLENBQUMsSUFBSSxFQUFFLEtBQUssRUFBRSxFQUFFO1lBQ25DLE1BQU0sSUFBSSxLQUFLLENBQUMsd0NBQXdDLENBQUMsQ0FBQztTQUMzRDtRQUNELElBQUksQ0FBQyxTQUFTLElBQUksU0FBUyxDQUFDLElBQUksRUFBRSxLQUFLLEVBQUUsRUFBRTtZQUN6QyxNQUFNLElBQUksS0FBSyxDQUFDLDJDQUEyQyxDQUFDLENBQUM7U0FDOUQ7UUFDRCxJQUFJLENBQUMsTUFBTSxHQUFHLE1BQU0sQ0FBQztRQUNyQixJQUFJLENBQUMsU0FBUyxHQUFHLFNBQVMsQ0FBQztJQUM3QixDQUFDO0NBQ0Y7QUFFRDs7Ozs7Ozs7Ozs7Ozs7R0FjRztBQUNILE1BQWEsZ0JBQWdCO0lBQzNCOzs7Ozs7Ozs7Ozs7O09BYUc7SUFDSSxNQUFNLENBQUMsa0JBQWtCLENBQUMsVUFBa0I7UUFDakQsT0FBTyxJQUFJLHlCQUF5QixDQUFDLFVBQVUsQ0FBQyxDQUFDO0lBQ25ELENBQUM7SUFFRDs7Ozs7Ozs7O09BU0c7SUFDSSxNQUFNLENBQUMsV0FBVyxDQUFDLE1BQWMsRUFBRSxTQUFpQjtRQUN6RCxPQUFPLElBQUksaUJBQWlCLENBQUMsTUFBTSxFQUFFLFNBQVMsQ0FBQyxDQUFDO0lBQ2xELENBQUM7Q0FDRjtBQWhDRCw0Q0FnQ0MiLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIEludGVyZmFjZSBmb3IgQ2hhaW0gQVBJIGNyZWRlbnRpYWxzLlxuICogVXNlIENoYWltQ3JlZGVudGlhbHMgZmFjdG9yeSBtZXRob2RzIHRvIGNyZWF0ZSBpbnN0YW5jZXMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgSUNoYWltQ3JlZGVudGlhbHMge1xuICAvKiogVGhlIHR5cGUgb2YgY3JlZGVudGlhbCBjb25maWd1cmF0aW9uICovXG4gIHJlYWRvbmx5IGNyZWRlbnRpYWxUeXBlOiAnc2VjcmV0c01hbmFnZXInIHwgJ2RpcmVjdCc7XG5cbiAgLyoqIFNlY3JldCBuYW1lIGluIEFXUyBTZWNyZXRzIE1hbmFnZXIgKG9ubHkgZm9yIHNlY3JldHNNYW5hZ2VyIHR5cGUpICovXG4gIHJlYWRvbmx5IHNlY3JldE5hbWU/OiBzdHJpbmc7XG5cbiAgLyoqIEFQSSBrZXkgZm9yIGRpcmVjdCBhdXRoZW50aWNhdGlvbiAob25seSBmb3IgZGlyZWN0IHR5cGUpICovXG4gIHJlYWRvbmx5IGFwaUtleT86IHN0cmluZztcblxuICAvKiogQVBJIHNlY3JldCBmb3IgZGlyZWN0IGF1dGhlbnRpY2F0aW9uIChvbmx5IGZvciBkaXJlY3QgdHlwZSkgKi9cbiAgcmVhZG9ubHkgYXBpU2VjcmV0Pzogc3RyaW5nO1xufVxuXG4vKipcbiAqIEludGVybmFsIGltcGxlbWVudGF0aW9uIGZvciBTZWNyZXRzIE1hbmFnZXIgY3JlZGVudGlhbHMuXG4gKi9cbmNsYXNzIFNlY3JldHNNYW5hZ2VyQ3JlZGVudGlhbHMgaW1wbGVtZW50cyBJQ2hhaW1DcmVkZW50aWFscyB7XG4gIHB1YmxpYyByZWFkb25seSBjcmVkZW50aWFsVHlwZSA9ICdzZWNyZXRzTWFuYWdlcicgYXMgY29uc3Q7XG4gIHB1YmxpYyByZWFkb25seSBzZWNyZXROYW1lOiBzdHJpbmc7XG5cbiAgY29uc3RydWN0b3Ioc2VjcmV0TmFtZTogc3RyaW5nKSB7XG4gICAgaWYgKCFzZWNyZXROYW1lIHx8IHNlY3JldE5hbWUudHJpbSgpID09PSAnJykge1xuICAgICAgdGhyb3cgbmV3IEVycm9yKCdzZWNyZXROYW1lIGlzIHJlcXVpcmVkIGFuZCBjYW5ub3QgYmUgZW1wdHknKTtcbiAgICB9XG4gICAgdGhpcy5zZWNyZXROYW1lID0gc2VjcmV0TmFtZTtcbiAgfVxufVxuXG4vKipcbiAqIEludGVybmFsIGltcGxlbWVudGF0aW9uIGZvciBkaXJlY3QgQVBJIGNyZWRlbnRpYWxzLlxuICovXG5jbGFzcyBEaXJlY3RDcmVkZW50aWFscyBpbXBsZW1lbnRzIElDaGFpbUNyZWRlbnRpYWxzIHtcbiAgcHVibGljIHJlYWRvbmx5IGNyZWRlbnRpYWxUeXBlID0gJ2RpcmVjdCcgYXMgY29uc3Q7XG4gIHB1YmxpYyByZWFkb25seSBhcGlLZXk6IHN0cmluZztcbiAgcHVibGljIHJlYWRvbmx5IGFwaVNlY3JldDogc3RyaW5nO1xuXG4gIGNvbnN0cnVjdG9yKGFwaUtleTogc3RyaW5nLCBhcGlTZWNyZXQ6IHN0cmluZykge1xuICAgIGlmICghYXBpS2V5IHx8IGFwaUtleS50cmltKCkgPT09ICcnKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ2FwaUtleSBpcyByZXF1aXJlZCBhbmQgY2Fubm90IGJlIGVtcHR5Jyk7XG4gICAgfVxuICAgIGlmICghYXBpU2VjcmV0IHx8IGFwaVNlY3JldC50cmltKCkgPT09ICcnKSB7XG4gICAgICB0aHJvdyBuZXcgRXJyb3IoJ2FwaVNlY3JldCBpcyByZXF1aXJlZCBhbmQgY2Fubm90IGJlIGVtcHR5Jyk7XG4gICAgfVxuICAgIHRoaXMuYXBpS2V5ID0gYXBpS2V5O1xuICAgIHRoaXMuYXBpU2VjcmV0ID0gYXBpU2VjcmV0O1xuICB9XG59XG5cbi8qKlxuICogRmFjdG9yeSBjbGFzcyBmb3IgY3JlYXRpbmcgQ2hhaW0gQVBJIGNyZWRlbnRpYWxzLlxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiAvLyBVc2luZyBBV1MgU2VjcmV0cyBNYW5hZ2VyIChyZWNvbW1lbmRlZCBmb3IgcHJvZHVjdGlvbilcbiAqIGNvbnN0IGNyZWRlbnRpYWxzID0gQ2hhaW1DcmVkZW50aWFscy5mcm9tU2VjcmV0c01hbmFnZXIoJ2NoYWltL2FwaS1jcmVkZW50aWFscycpO1xuICpcbiAqIC8vIFVzaW5nIGRpcmVjdCBBUEkga2V5cyAoZm9yIGRldmVsb3BtZW50L3Rlc3RpbmcpXG4gKiBjb25zdCBjcmVkZW50aWFscyA9IENoYWltQ3JlZGVudGlhbHMuZnJvbUFwaUtleXMoXG4gKiAgIHByb2Nlc3MuZW52LkNIQUlNX0FQSV9LRVkhLFxuICogICBwcm9jZXNzLmVudi5DSEFJTV9BUElfU0VDUkVUIVxuICogKTtcbiAqIGBgYFxuICovXG5leHBvcnQgY2xhc3MgQ2hhaW1DcmVkZW50aWFscyB7XG4gIC8qKlxuICAgKiBDcmVhdGUgY3JlZGVudGlhbHMgZnJvbSBBV1MgU2VjcmV0cyBNYW5hZ2VyLlxuICAgKlxuICAgKiBUaGUgc2VjcmV0IG11c3QgY29udGFpbiBKU09OIHdpdGggYGFwaUtleWAgYW5kIGBhcGlTZWNyZXRgIGZpZWxkczpcbiAgICogYGBganNvblxuICAgKiB7XG4gICAqICAgXCJhcGlLZXlcIjogXCJ5b3VyLWNoYWltLWFwaS1rZXlcIixcbiAgICogICBcImFwaVNlY3JldFwiOiBcInlvdXItY2hhaW0tYXBpLXNlY3JldFwiXG4gICAqIH1cbiAgICogYGBgXG4gICAqXG4gICAqIEBwYXJhbSBzZWNyZXROYW1lIC0gVGhlIG5hbWUgb3IgQVJOIG9mIHRoZSBzZWNyZXQgaW4gQVdTIFNlY3JldHMgTWFuYWdlclxuICAgKiBAcmV0dXJucyBDcmVkZW50aWFscyBjb25maWd1cmVkIHRvIHVzZSBTZWNyZXRzIE1hbmFnZXJcbiAgICovXG4gIHB1YmxpYyBzdGF0aWMgZnJvbVNlY3JldHNNYW5hZ2VyKHNlY3JldE5hbWU6IHN0cmluZyk6IElDaGFpbUNyZWRlbnRpYWxzIHtcbiAgICByZXR1cm4gbmV3IFNlY3JldHNNYW5hZ2VyQ3JlZGVudGlhbHMoc2VjcmV0TmFtZSk7XG4gIH1cblxuICAvKipcbiAgICogQ3JlYXRlIGNyZWRlbnRpYWxzIGZyb20gZGlyZWN0IEFQSSBrZXkgYW5kIHNlY3JldC5cbiAgICpcbiAgICogTm90ZTogRm9yIHByb2R1Y3Rpb24gZGVwbG95bWVudHMsIHByZWZlciBgZnJvbVNlY3JldHNNYW5hZ2VyKClgIHRvIGF2b2lkXG4gICAqIGV4cG9zaW5nIGNyZWRlbnRpYWxzIGluIENESyBjb2RlIG9yIGVudmlyb25tZW50IHZhcmlhYmxlcy5cbiAgICpcbiAgICogQHBhcmFtIGFwaUtleSAtIFRoZSBDaGFpbSBBUEkga2V5XG4gICAqIEBwYXJhbSBhcGlTZWNyZXQgLSBUaGUgQ2hhaW0gQVBJIHNlY3JldFxuICAgKiBAcmV0dXJucyBDcmVkZW50aWFscyBjb25maWd1cmVkIHdpdGggZGlyZWN0IEFQSSBrZXlzXG4gICAqL1xuICBwdWJsaWMgc3RhdGljIGZyb21BcGlLZXlzKGFwaUtleTogc3RyaW5nLCBhcGlTZWNyZXQ6IHN0cmluZyk6IElDaGFpbUNyZWRlbnRpYWxzIHtcbiAgICByZXR1cm4gbmV3IERpcmVjdENyZWRlbnRpYWxzKGFwaUtleSwgYXBpU2VjcmV0KTtcbiAgfVxufVxuXG4iXX0=

package/lib/types/data-store-metadata.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Base metadata interface for all data store types.
+ * Each data store binder extends this with store-specific fields.
+ */
+export interface BaseDataStoreMetadata {
+    /** Data store type identifier */
+    readonly type: string;
+    /** AWS region */
+    readonly region: string;
+    /** Encryption key ARN (if configured) */
+    readonly encryptionKeyArn?: string;
+}
+/**
+ * DynamoDB table metadata captured during binding.
+ *
+ * Note: Removed duplicate fields from v1.1:
+ * - arn (use tableArn instead - globally unique)
+ * - name (use tableName instead)
+ * - account (use top-level accountId instead)
+ */
+export interface DynamoDBMetadata extends BaseDataStoreMetadata {
+    readonly type: 'dynamodb';
+    /** Table name */
+    readonly tableName: string;
+    /** Table ARN (globally unique identifier) */
+    readonly tableArn: string;
+    /** Partition key attribute name */
+    readonly partitionKey: string;
+    /** Sort key attribute name (if composite key) */
+    readonly sortKey?: string;
+    /** Global Secondary Indexes */
+    readonly globalSecondaryIndexes?: GSIMetadata[];
+    /** Local Secondary Indexes */
+    readonly localSecondaryIndexes?: LSIMetadata[];
+    /** TTL attribute name (if enabled) */
+    readonly ttlAttribute?: string;
+    /** Whether DynamoDB Streams is enabled */
+    readonly streamEnabled?: boolean;
+    /** Stream view type (if streams enabled) */
+    readonly streamViewType?: string;
+    /** Billing mode */
+    readonly billingMode?: 'PAY_PER_REQUEST' | 'PROVISIONED';
+}
+/**
+ * Global Secondary Index metadata
+ */
+export interface GSIMetadata {
+    readonly indexName: string;
+    readonly partitionKey: string;
+    readonly sortKey?: string;
+    readonly projectionType: 'ALL' | 'KEYS_ONLY' | 'INCLUDE';
+    readonly nonKeyAttributes?: string[];
+}
+/**
+ * Local Secondary Index metadata
+ */
+export interface LSIMetadata {
+    readonly indexName: string;
+    readonly sortKey: string;
+    readonly projectionType: 'ALL' | 'KEYS_ONLY' | 'INCLUDE';
+    readonly nonKeyAttributes?: string[];
+}
+/**
+ * Union type for all supported data store metadata.
+ * Extend this union as new data stores are added.
+ */
+export type DataStoreMetadata = DynamoDBMetadata;

package/lib/types/data-store-metadata.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+// Future: | AuroraMetadata | RDSMetadata | DocumentDBMetadata;
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZGF0YS1zdG9yZS1tZXRhZGF0YS5qcyIsInNvdXJjZVJvb3QiOiIiLCJzb3VyY2VzIjpbIi4uLy4uL3NyYy90eXBlcy9kYXRhLXN0b3JlLW1ldGFkYXRhLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7O0FBbUZBLCtEQUErRCIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogQmFzZSBtZXRhZGF0YSBpbnRlcmZhY2UgZm9yIGFsbCBkYXRhIHN0b3JlIHR5cGVzLlxuICogRWFjaCBkYXRhIHN0b3JlIGJpbmRlciBleHRlbmRzIHRoaXMgd2l0aCBzdG9yZS1zcGVjaWZpYyBmaWVsZHMuXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgQmFzZURhdGFTdG9yZU1ldGFkYXRhIHtcbiAgLyoqIERhdGEgc3RvcmUgdHlwZSBpZGVudGlmaWVyICovXG4gIHJlYWRvbmx5IHR5cGU6IHN0cmluZztcblxuICAvKiogQVdTIHJlZ2lvbiAqL1xuICByZWFkb25seSByZWdpb246IHN0cmluZztcblxuICAvKiogRW5jcnlwdGlvbiBrZXkgQVJOIChpZiBjb25maWd1cmVkKSAqL1xuICByZWFkb25seSBlbmNyeXB0aW9uS2V5QXJuPzogc3RyaW5nO1xufVxuXG4vKipcbiAqIER5bmFtb0RCIHRhYmxlIG1ldGFkYXRhIGNhcHR1cmVkIGR1cmluZyBiaW5kaW5nLlxuICogXG4gKiBOb3RlOiBSZW1vdmVkIGR1cGxpY2F0ZSBmaWVsZHMgZnJvbSB2MS4xOlxuICogLSBhcm4gKHVzZSB0YWJsZUFybiBpbnN0ZWFkIC0gZ2xvYmFsbHkgdW5pcXVlKVxuICogLSBuYW1lICh1c2UgdGFibGVOYW1lIGluc3RlYWQpXG4gKiAtIGFjY291bnQgKHVzZSB0b3AtbGV2ZWwgYWNjb3VudElkIGluc3RlYWQpXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgRHluYW1vREJNZXRhZGF0YSBleHRlbmRzIEJhc2VEYXRhU3RvcmVNZXRhZGF0YSB7XG4gIHJlYWRvbmx5IHR5cGU6ICdkeW5hbW9kYic7XG5cbiAgLyoqIFRhYmxlIG5hbWUgKi9cbiAgcmVhZG9ubHkgdGFibGVOYW1lOiBzdHJpbmc7XG5cbiAgLyoqIFRhYmxlIEFSTiAoZ2xvYmFsbHkgdW5pcXVlIGlkZW50aWZpZXIpICovXG4gIHJlYWRvbmx5IHRhYmxlQXJuOiBzdHJpbmc7XG5cbiAgLyoqIFBhcnRpdGlvbiBrZXkgYXR0cmlidXRlIG5hbWUgKi9cbiAgcmVhZG9ubHkgcGFydGl0aW9uS2V5OiBzdHJpbmc7XG5cbiAgLyoqIFNvcnQga2V5IGF0dHJpYnV0ZSBuYW1lIChpZiBjb21wb3NpdGUga2V5KSAqL1xuICByZWFkb25seSBzb3J0S2V5Pzogc3RyaW5nO1xuXG4gIC8qKiBHbG9iYWwgU2Vjb25kYXJ5IEluZGV4ZXMgKi9cbiAgcmVhZG9ubHkgZ2xvYmFsU2Vjb25kYXJ5SW5kZXhlcz86IEdTSU1ldGFkYXRhW107XG5cbiAgLyoqIExvY2FsIFNlY29uZGFyeSBJbmRleGVzICovXG4gIHJlYWRvbmx5IGxvY2FsU2Vjb25kYXJ5SW5kZXhlcz86IExTSU1ldGFkYXRhW107XG5cbiAgLyoqIFRUTCBhdHRyaWJ1dGUgbmFtZSAoaWYgZW5hYmxlZCkgKi9cbiAgcmVhZG9ubHkgdHRsQXR0cmlidXRlPzogc3RyaW5nO1xuXG4gIC8qKiBXaGV0aGVyIER5bmFtb0RCIFN0cmVhbXMgaXMgZW5hYmxlZCAqL1xuICByZWFkb25seSBzdHJlYW1FbmFibGVkPzogYm9vbGVhbjtcblxuICAvKiogU3RyZWFtIHZpZXcgdHlwZSAoaWYgc3RyZWFtcyBlbmFibGVkKSAqL1xuICByZWFkb25seSBzdHJlYW1WaWV3VHlwZT86IHN0cmluZztcblxuICAvKiogQmlsbGluZyBtb2RlICovXG4gIHJlYWRvbmx5IGJpbGxpbmdNb2RlPzogJ1BBWV9QRVJfUkVRVUVTVCcgfCAnUFJPVklTSU9ORUQnO1xufVxuXG4vKipcbiAqIEdsb2JhbCBTZWNvbmRhcnkgSW5kZXggbWV0YWRhdGFcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBHU0lNZXRhZGF0YSB7XG4gIHJlYWRvbmx5IGluZGV4TmFtZTogc3RyaW5nO1xuICByZWFkb25seSBwYXJ0aXRpb25LZXk6IHN0cmluZztcbiAgcmVhZG9ubHkgc29ydEtleT86IHN0cmluZztcbiAgcmVhZG9ubHkgcHJvamVjdGlvblR5cGU6ICdBTEwnIHwgJ0tFWVNfT05MWScgfCAnSU5DTFVERSc7XG4gIHJlYWRvbmx5IG5vbktleUF0dHJpYnV0ZXM/OiBzdHJpbmdbXTtcbn1cblxuLyoqXG4gKiBMb2NhbCBTZWNvbmRhcnkgSW5kZXggbWV0YWRhdGFcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBMU0lNZXRhZGF0YSB7XG4gIHJlYWRvbmx5IGluZGV4TmFtZTogc3RyaW5nO1xuICByZWFkb25seSBzb3J0S2V5OiBzdHJpbmc7XG4gIHJlYWRvbmx5IHByb2plY3Rpb25UeXBlOiAnQUxMJyB8ICdLRVlTX09OTFknIHwgJ0lOQ0xVREUnO1xuICByZWFkb25seSBub25LZXlBdHRyaWJ1dGVzPzogc3RyaW5nW107XG59XG5cbi8qKlxuICogVW5pb24gdHlwZSBmb3IgYWxsIHN1cHBvcnRlZCBkYXRhIHN0b3JlIG1ldGFkYXRhLlxuICogRXh0ZW5kIHRoaXMgdW5pb24gYXMgbmV3IGRhdGEgc3RvcmVzIGFyZSBhZGRlZC5cbiAqL1xuZXhwb3J0IHR5cGUgRGF0YVN0b3JlTWV0YWRhdGEgPSBEeW5hbW9EQk1ldGFkYXRhO1xuLy8gRnV0dXJlOiB8IEF1cm9yYU1ldGFkYXRhIHwgUkRTTWV0YWRhdGEgfCBEb2N1bWVudERCTWV0YWRhdGE7XG5cblxuIl19

package/lib/types/failure-mode.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Behavior when schema ingestion fails during deployment.
+ */
+export declare enum FailureMode {
+    /**
+     * Log errors but return SUCCESS to CloudFormation.
+     * Deployment continues even if ingestion fails.
+     * This is the default.
+     */
+    BEST_EFFORT = "BEST_EFFORT",
+    /**
+     * Return FAILED to CloudFormation on any ingestion error.
+     * WARNING: Deployment will roll back if ingestion fails.
+     */
+    STRICT = "STRICT"
+}

package/lib/types/failure-mode.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FailureMode = void 0;
+/**
+ * Behavior when schema ingestion fails during deployment.
+ */
+var FailureMode;
+(function (FailureMode) {
+    /**
+     * Log errors but return SUCCESS to CloudFormation.
+     * Deployment continues even if ingestion fails.
+     * This is the default.
+     */
+    FailureMode["BEST_EFFORT"] = "BEST_EFFORT";
+    /**
+     * Return FAILED to CloudFormation on any ingestion error.
+     * WARNING: Deployment will roll back if ingestion fails.
+     */
+    FailureMode["STRICT"] = "STRICT";
+})(FailureMode = exports.FailureMode || (exports.FailureMode = {}));
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiZmFpbHVyZS1tb2RlLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3R5cGVzL2ZhaWx1cmUtbW9kZS50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiOzs7QUFBQTs7R0FFRztBQUNILElBQVksV0FhWDtBQWJELFdBQVksV0FBVztJQUNyQjs7OztPQUlHO0lBQ0gsMENBQTJCLENBQUE7SUFFM0I7OztPQUdHO0lBQ0gsZ0NBQWlCLENBQUE7QUFDbkIsQ0FBQyxFQWJXLFdBQVcsR0FBWCxtQkFBVyxLQUFYLG1CQUFXLFFBYXRCIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBCZWhhdmlvciB3aGVuIHNjaGVtYSBpbmdlc3Rpb24gZmFpbHMgZHVyaW5nIGRlcGxveW1lbnQuXG4gKi9cbmV4cG9ydCBlbnVtIEZhaWx1cmVNb2RlIHtcbiAgLyoqXG4gICAqIExvZyBlcnJvcnMgYnV0IHJldHVybiBTVUNDRVNTIHRvIENsb3VkRm9ybWF0aW9uLlxuICAgKiBEZXBsb3ltZW50IGNvbnRpbnVlcyBldmVuIGlmIGluZ2VzdGlvbiBmYWlscy5cbiAgICogVGhpcyBpcyB0aGUgZGVmYXVsdC5cbiAgICovXG4gIEJFU1RfRUZGT1JUID0gJ0JFU1RfRUZGT1JUJyxcblxuICAvKipcbiAgICogUmV0dXJuIEZBSUxFRCB0byBDbG91ZEZvcm1hdGlvbiBvbiBhbnkgaW5nZXN0aW9uIGVycm9yLlxuICAgKiBXQVJOSU5HOiBEZXBsb3ltZW50IHdpbGwgcm9sbCBiYWNrIGlmIGluZ2VzdGlvbiBmYWlscy5cbiAgICovXG4gIFNUUklDVCA9ICdTVFJJQ1QnLFxufVxuXG4iXX0=