declastruct 1.0.0 → 1.1.0

package/dist/.test/assets/providers/demo.provider.d.ts

@@ -0,0 +1,32 @@
+import { DomainEntity } from 'domain-objects';
+import { DeclastructDao } from '../../../domain.objects/DeclastructDao';
+import { DeclastructProvider } from '../../../domain.objects/DeclastructProvider';
+/**
+ * .what = demo resource for integration testing
+ */
+interface DemoResource {
+    exid: string;
+    name: string;
+}
+declare class DemoResource extends DomainEntity<DemoResource> implements DemoResource {
+    static unique: readonly ["exid"];
+}
+/**
+ * .what = demo provider with on-disk persistence
+ * .why = enables full integration testing with real CRUD operations
+ */
+export declare const demoProvider: DeclastructProvider<{
+    DemoResource: DeclastructDao<DemoResource, typeof DemoResource, any>;
+}, {}>;
+/**
+ * .what = generates a sample DemoResource with automatic unique ID
+ * .why = simplifies test resource creation without managing IDs manually
+ * .note = use resource.clone({ name: 'New Name' }) to update properties while keeping same exid
+ */
+export declare const genSampleDemoResource: (input: {
+    name: string;
+}) => import("domain-objects/dist/manipulation/immute/withImmute").WithImmute<DemoResource>;
+/**
+ * .what = export DemoResource class for test usage
+ */
+export { DemoResource };

package/dist/.test/assets/providers/demo.provider.js

@@ -0,0 +1,101 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DemoResource = exports.genSampleDemoResource = exports.demoProvider = void 0;
+const domain_objects_1 = require("domain-objects");
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const uuid_fns_1 = require("uuid-fns");
+const DeclastructProvider_1 = require("../../../domain.objects/DeclastructProvider");
+class DemoResource extends domain_objects_1.DomainEntity {
+}
+exports.DemoResource = DemoResource;
+DemoResource.unique = ['exid'];
+/**
+ * .what = resolves file path for a resource on disk
+ * .why = centralizes file naming logic
+ */
+const getResourceFilePath = (id) => {
+    return (0, path_1.resolve)(process.cwd(), `.test/demo/provider/.temp/${id}.json`);
+};
+/**
+ * .what = demo DAO with on-disk JSON persistence
+ * .why = provides real persistence for integration tests
+ */
+const demoDao = {
+    get: {
+        byUnique: async (input) => {
+            const filePath = getResourceFilePath(input.exid);
+            // check if file exists
+            if (!(0, fs_1.existsSync)(filePath))
+                return null;
+            // read and parse file
+            const json = await (0, promises_1.readFile)(filePath, 'utf-8');
+            const data = JSON.parse(json);
+            return DemoResource.as(data);
+        },
+        byRef: async (ref) => {
+            // extract exid from ref
+            const exid = ref.exid;
+            if (!exid)
+                return null;
+            return demoDao.get.byUnique({ exid }, {});
+        },
+    },
+    set: {
+        finsert: async (resource) => {
+            const filePath = getResourceFilePath(resource.exid);
+            // write resource to disk
+            await (0, promises_1.writeFile)(filePath, JSON.stringify(resource, null, 2), 'utf-8');
+            return resource;
+        },
+        upsert: async (resource) => {
+            const filePath = getResourceFilePath(resource.exid);
+            // write resource to disk (overwrite if exists)
+            await (0, promises_1.writeFile)(filePath, JSON.stringify(resource, null, 2), 'utf-8');
+            return resource;
+        },
+        delete: async (ref) => {
+            const resource = await demoDao.get.byRef(ref, {});
+            if (!resource)
+                return;
+            const filePath = getResourceFilePath(resource.exid);
+            // remove file if it exists
+            if ((0, fs_1.existsSync)(filePath)) {
+                await (0, promises_1.rm)(filePath);
+            }
+        },
+    },
+};
+/**
+ * .what = demo provider with on-disk persistence
+ * .why = enables full integration testing with real CRUD operations
+ */
+exports.demoProvider = new DeclastructProvider_1.DeclastructProvider({
+    name: 'demo-provider',
+    daos: { DemoResource: demoDao },
+    context: {},
+    hooks: {
+        beforeAll: async () => {
+            // ensure temp directory exists
+            const tempDir = (0, path_1.resolve)(process.cwd(), '.test/demo/provider/.temp');
+            if (!(0, fs_1.existsSync)(tempDir)) {
+                await (0, promises_1.mkdir)(tempDir, { recursive: true });
+            }
+        },
+        afterAll: async () => { },
+    },
+});
+/**
+ * .what = generates a sample DemoResource with automatic unique ID
+ * .why = simplifies test resource creation without managing IDs manually
+ * .note = use resource.clone({ name: 'New Name' }) to update properties while keeping same exid
+ */
+const genSampleDemoResource = (input) => {
+    return DemoResource.as({
+        exid: (0, uuid_fns_1.getUuid)(),
+        name: input.name,
+    });
+};
+exports.genSampleDemoResource = genSampleDemoResource;
+//# sourceMappingURL=demo.provider.js.map

package/dist/.test/assets/providers/demo.provider.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"demo.provider.js","sourceRoot":"","sources":["../../../../src/.test/assets/providers/demo.provider.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/apply.d.ts

@@ -0,0 +1,9 @@
+#!/usr/bin/env tsx
+/**
+ * .what = executes the apply command to apply an infrastructure change plan
+ * .why = provides CLI interface for applying infrastructure changes
+ * .note = loads plan from file and wish file from plan.wish.uri
+ */
+export declare const executeApplyCommand: ({ planFilePath, }: {
+    planFilePath: string;
+}) => Promise<void>;

package/dist/contract/cli/apply.integration.test.js

@@ -0,0 +1,148 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const uuid_fns_1 = require("uuid-fns");
+const DeclastructPlan_1 = require("../../domain.objects/DeclastructPlan");
+const apply_1 = require("./apply");
+const plan_1 = require("./plan");
+/**
+ * .what = creates an isolated wish file for a test
+ * .why = ensures stable resources within a single test while maintaining test isolation
+ */
+const createIsolatedWishFile = async () => {
+    const tempDir = (0, path_1.resolve)(process.cwd(), '.test/.temp');
+    const wishPath = (0, path_1.resolve)(tempDir, `wish-${(0, uuid_fns_1.getUuid)()}.ts`);
+    // ensure temp directory exists
+    if (!(0, fs_1.existsSync)(tempDir)) {
+        await (0, promises_1.mkdir)(tempDir, { recursive: true });
+    }
+    const exid1 = (0, uuid_fns_1.getUuid)();
+    const exid2 = (0, uuid_fns_1.getUuid)();
+    const wishContent = `
+import { DomainEntity } from 'domain-objects';
+import { DeclastructProvider } from '../../src/domain.objects/DeclastructProvider';
+import { DemoResource, demoProvider } from '../../src/.test/assets/providers/demo.provider';
+
+export const getResources = async (): Promise<DomainEntity<any>[]> => {
+  return [
+    DemoResource.as({ exid: '${exid1}', name: 'First Resource' }),
+    DemoResource.as({ exid: '${exid2}', name: 'Second Resource' }),
+  ];
+};
+
+export const getProviders = async (): Promise<DeclastructProvider<any, any>[]> => {
+  return [demoProvider];
+};
+`;
+    await (0, promises_1.writeFile)(wishPath, wishContent, 'utf-8');
+    return wishPath;
+};
+describe('executeApplyCommand', () => {
+    const planFilePath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/apply.test.json');
+    afterEach(async () => {
+        // cleanup plan file after each test
+        if ((0, fs_1.existsSync)(planFilePath)) {
+            await (0, promises_1.rm)(planFilePath);
+        }
+    });
+    it('should apply changes from a valid plan file', async () => {
+        // create isolated wish file for this test
+        const wishFilePath = await createIsolatedWishFile();
+        // first generate a plan
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // verify plan was created
+        expect((0, fs_1.existsSync)(planFilePath)).toBe(true);
+        // now apply the plan
+        await (0, apply_1.executeApplyCommand)({ planFilePath });
+        // verify plan still exists after apply
+        expect((0, fs_1.existsSync)(planFilePath)).toBe(true);
+        // read plan to verify structure
+        const planJson = await (0, promises_1.readFile)(planFilePath, 'utf-8');
+        const plan = new DeclastructPlan_1.DeclastructPlan(JSON.parse(planJson));
+        // verify plan has changes
+        expect(plan.changes.length).toBe(2);
+    });
+    it('should throw when plan file does not exist', async () => {
+        const nonexistentPlanPath = (0, path_1.resolve)(__dirname, 'nonexistent-plan.json');
+        await expect((0, apply_1.executeApplyCommand)({ planFilePath: nonexistentPlanPath })).rejects.toThrow('Plan file not found');
+    });
+    it('should throw when wish file referenced in plan does not exist', async () => {
+        // create plan with invalid wish path
+        const invalidPlan = {
+            hash: 'test-hash',
+            createdAt: new Date().toISOString(),
+            wish: { uri: '/nonexistent/wish.ts' },
+            changes: [],
+        };
+        await (0, promises_1.writeFile)(planFilePath, JSON.stringify(invalidPlan, null, 2));
+        await expect((0, apply_1.executeApplyCommand)({ planFilePath })).rejects.toThrow();
+    });
+    it('should throw when wish file does not export getProviders', async () => {
+        const badWishPath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/bad-apply-wish.ts');
+        // create bad wish file
+        await (0, promises_1.writeFile)(badWishPath, 'export const foo = "bar";', 'utf-8');
+        // create plan pointing to bad wish
+        const invalidPlan = {
+            hash: 'test-hash',
+            createdAt: new Date().toISOString(),
+            wish: { uri: badWishPath },
+            changes: [],
+        };
+        await (0, promises_1.writeFile)(planFilePath, JSON.stringify(invalidPlan, null, 2));
+        await expect((0, apply_1.executeApplyCommand)({ planFilePath })).rejects.toThrow('Wish file must export getProviders() function');
+        // cleanup
+        await (0, promises_1.rm)(badWishPath);
+    });
+    it('should successfully apply multiple CREATE actions', async () => {
+        // create isolated wish file for this test
+        const wishFilePath = await createIsolatedWishFile();
+        // generate plan
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // spy on console to verify logging
+        const logSpy = jest.spyOn(console, 'info');
+        // apply changes
+        await (0, apply_1.executeApplyCommand)({ planFilePath });
+        // verify success logging occurred
+        const logCalls = logSpy.mock.calls.map((call) => call.join(' '));
+        const successLogs = logCalls.filter((log) => log.includes('✔'));
+        // should have logged success for each CREATE action
+        expect(successLogs.length).toBeGreaterThan(0);
+        // cleanup spy
+        logSpy.mockRestore();
+    });
+    it('should handle KEEP actions without errors', async () => {
+        // create isolated wish file for this test
+        const wishFilePath = await createIsolatedWishFile();
+        // generate initial plan
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // apply changes
+        await (0, apply_1.executeApplyCommand)({ planFilePath });
+        // generate new plan (should now show KEEP actions)
+        await (0, promises_1.rm)(planFilePath);
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // read new plan
+        const planJson = await (0, promises_1.readFile)(planFilePath, 'utf-8');
+        const plan = new DeclastructPlan_1.DeclastructPlan(JSON.parse(planJson));
+        // verify we have KEEP actions
+        const keepActions = plan.changes.filter((c) => c.action === 'KEEP');
+        expect(keepActions.length).toBe(2);
+        // apply again (should handle KEEP without errors)
+        await (0, apply_1.executeApplyCommand)({ planFilePath });
+    });
+    it('should throw when plan is stale', async () => {
+        // create isolated wish file for this test
+        const wishFilePath = await createIsolatedWishFile();
+        // generate initial plan
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // modify the plan's hash to make it stale
+        const planJson = await (0, promises_1.readFile)(planFilePath, 'utf-8');
+        const plan = JSON.parse(planJson);
+        plan.hash = 'stale-hash-that-wont-match';
+        await (0, promises_1.writeFile)(planFilePath, JSON.stringify(plan, null, 2));
+        // applying stale plan should throw
+        await expect((0, apply_1.executeApplyCommand)({ planFilePath })).rejects.toThrow('plan is stale');
+    });
+});
+//# sourceMappingURL=apply.integration.test.js.map

package/dist/contract/cli/apply.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply.integration.test.js","sourceRoot":"","sources":["../../../src/contract/cli/apply.integration.test.ts"],"names":[],"mappings":"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"}

package/dist/contract/cli/apply.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env tsx
+"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;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.executeApplyCommand = void 0;
+const bottleneck_1 = __importDefault(require("bottleneck"));
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const helpful_errors_1 = require("helpful-errors");
+const path_1 = require("path");
+const DeclastructPlan_1 = require("../../domain.objects/DeclastructPlan");
+const applyChanges_1 = require("../../domain.operations/apply/applyChanges");
+const log = console;
+/**
+ * .what = executes the apply command to apply an infrastructure change plan
+ * .why = provides CLI interface for applying infrastructure changes
+ * .note = loads plan from file and wish file from plan.wish.uri
+ */
+const executeApplyCommand = async ({ planFilePath, }) => {
+    // resolve path
+    const resolvedPlanPath = (0, path_1.resolve)(process.cwd(), planFilePath);
+    // validate plan file exists
+    if (!(0, fs_1.existsSync)(resolvedPlanPath)) {
+        throw new helpful_errors_1.BadRequestError(`Plan file not found: ${resolvedPlanPath}`);
+    }
+    log.info('🌊 declastruct apply');
+    log.info(`   plan: ${resolvedPlanPath}`);
+    log.info('');
+    // load plan from file
+    const planJson = await (0, promises_1.readFile)(resolvedPlanPath, 'utf-8');
+    const plan = new DeclastructPlan_1.DeclastructPlan(JSON.parse(planJson));
+    // import wish file from plan
+    const wishPath = plan.wish.uri;
+    const wish = await Promise.resolve(`${wishPath}`).then(s => __importStar(require(s)));
+    // validate exports
+    if (typeof wish.getProviders !== 'function') {
+        throw new helpful_errors_1.BadRequestError('Wish file must export getProviders() function');
+    }
+    if (typeof wish.getResources !== 'function') {
+        throw new helpful_errors_1.BadRequestError('Wish file must export getResources() function');
+    }
+    // get resources and providers from wish file
+    const resources = await wish.getResources();
+    const providers = await wish.getProviders();
+    // initialize providers
+    log.info('✨ start providers...');
+    await Promise.all(providers.map((p) => p.hooks.beforeAll()));
+    // create context
+    const context = {
+        bottleneck: new bottleneck_1.default({ maxConcurrent: 1 }),
+        log,
+    };
+    // apply changes (logs emitted in real-time by applyChanges)
+    log.info('🪄 apply changes...');
+    log.info('');
+    const result = await (0, applyChanges_1.applyChanges)({ plan, resources, providers }, context);
+    // cleanup providers
+    log.info('✨ stop providers...');
+    await Promise.all(providers.map((p) => p.hooks.afterAll()));
+    // log summary
+    log.info('');
+    log.info(`🌊 applied ${result.appliedChanges.length} changes`);
+};
+exports.executeApplyCommand = executeApplyCommand;
+//# sourceMappingURL=apply.js.map

package/dist/contract/cli/apply.js.map

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

package/dist/contract/cli/invoke.d.ts

@@ -0,0 +1,8 @@
+/**
+ * .what = invokes CLI commands based on user input
+ * .why = provides global entry point for declastruct CLI
+ * .note = uses commander for argument parsing and help text
+ */
+export declare const invoke: ({ args }: {
+    args: string[];
+}) => Promise<void>;

package/dist/contract/cli/invoke.js

@@ -0,0 +1,58 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.invoke = void 0;
+const commander_1 = require("commander");
+const package_json_1 = __importDefault(require("../../../package.json"));
+const apply_1 = require("./apply");
+const plan_1 = require("./plan");
+const log = console;
+/**
+ * .what = invokes CLI commands based on user input
+ * .why = provides global entry point for declastruct CLI
+ * .note = uses commander for argument parsing and help text
+ */
+const invoke = async ({ args }) => {
+    const program = new commander_1.Command();
+    program
+        .name('declastruct')
+        .description('Declarative resource structure control')
+        .version(package_json_1.default.version);
+    program
+        .command('plan')
+        .description('Generate a change plan from a wish file')
+        .requiredOption('--wish <file>', 'Path to wish file')
+        .requiredOption('--into <file>', 'Path to output plan file')
+        .action(async (options) => {
+        try {
+            await (0, plan_1.executePlanCommand)({
+                wishFilePath: options.wish,
+                planFilePath: options.into,
+            });
+        }
+        catch (error) {
+            log.error('✖ Error during plan:', error);
+            process.exit(1);
+        }
+    });
+    program
+        .command('apply')
+        .description('Apply changes from a plan file')
+        .requiredOption('--plan <file>', 'Path to plan file')
+        .action(async (options) => {
+        try {
+            await (0, apply_1.executeApplyCommand)({
+                planFilePath: options.plan,
+            });
+        }
+        catch (error) {
+            log.error('✖ Error during apply:', error);
+            process.exit(1);
+        }
+    });
+    await program.parseAsync(args, { from: 'user' });
+};
+exports.invoke = invoke;
+//# sourceMappingURL=invoke.js.map

package/dist/contract/cli/invoke.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"invoke.js","sourceRoot":"","sources":["../../../src/contract/cli/invoke.ts"],"names":[],"mappings":";;;;;;AAAA,yCAAoC;AAEpC,yEAAwC;AACxC,mCAA8C;AAC9C,iCAA4C;AAE5C,MAAM,GAAG,GAAG,OAAO,CAAC;AAEpB;;;;GAIG;AACI,MAAM,MAAM,GAAG,KAAK,EAAE,EAAE,IAAI,EAAsB,EAAiB,EAAE;IAC1E,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;IAE9B,OAAO;SACJ,IAAI,CAAC,aAAa,CAAC;SACnB,WAAW,CAAC,wCAAwC,CAAC;SACrD,OAAO,CAAC,sBAAG,CAAC,OAAO,CAAC,CAAC;IAExB,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,yCAAyC,CAAC;SACtD,cAAc,CAAC,eAAe,EAAE,mBAAmB,CAAC;SACpD,cAAc,CAAC,eAAe,EAAE,0BAA0B,CAAC;SAC3D,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,IAAA,yBAAkB,EAAC;gBACvB,YAAY,EAAE,OAAO,CAAC,IAAI;gBAC1B,YAAY,EAAE,OAAO,CAAC,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,sBAAsB,EAAE,KAAK,CAAC,CAAC;YACzC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,OAAO;SACJ,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,gCAAgC,CAAC;SAC7C,cAAc,CAAC,eAAe,EAAE,mBAAmB,CAAC;SACpD,MAAM,CAAC,KAAK,EAAE,OAAO,EAAE,EAAE;QACxB,IAAI,CAAC;YACH,MAAM,IAAA,2BAAmB,EAAC;gBACxB,YAAY,EAAE,OAAO,CAAC,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,GAAG,CAAC,KAAK,CAAC,uBAAuB,EAAE,KAAK,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC,CAAC,CAAC;IAEL,MAAM,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;AACnD,CAAC,CAAC;AAzCW,QAAA,MAAM,UAyCjB"}

package/dist/contract/cli/plan.d.ts

@@ -0,0 +1,10 @@
+#!/usr/bin/env tsx
+/**
+ * .what = executes the plan command to generate an infrastructure change plan
+ * .why = provides CLI interface for planning infrastructure changes
+ * .note = requires wish file with getResources() and getProviders() exports
+ */
+export declare const executePlanCommand: ({ wishFilePath, planFilePath, }: {
+    wishFilePath: string;
+    planFilePath: string;
+}) => Promise<void>;

package/dist/contract/cli/plan.integration.test.js

@@ -0,0 +1,107 @@
+"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 });
+const fs_1 = require("fs");
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+const DeclastructPlan_1 = require("../../domain.objects/DeclastructPlan");
+const plan_1 = require("./plan");
+describe('executePlanCommand', () => {
+    const wishFilePath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/wish.fixture.ts');
+    const planFilePath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/plan.test.json');
+    afterEach(async () => {
+        // cleanup plan file after each test
+        if ((0, fs_1.existsSync)(planFilePath)) {
+            await (0, promises_1.rm)(planFilePath);
+        }
+    });
+    it('should generate a plan file with changes based on wish file', async () => {
+        // execute plan command
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // verify plan file was created
+        expect((0, fs_1.existsSync)(planFilePath)).toBe(true);
+        // read and parse plan
+        const planJson = await (0, promises_1.readFile)(planFilePath, 'utf-8');
+        const plan = new DeclastructPlan_1.DeclastructPlan(JSON.parse(planJson));
+        // verify plan structure
+        expect(plan.hash).toBeDefined();
+        expect(plan.createdAt).toBeDefined();
+        expect(plan.wish.uri).toBe(wishFilePath);
+        expect(plan.changes.length).toBe(2);
+        // verify changes are all CREATE (no remote state)
+        plan.changes.forEach((change) => {
+            expect(change.action).toBe('CREATE');
+            expect(change.forResource.class).toBe('DemoResource');
+            expect(change.state.desired).toBeDefined();
+            expect(change.state.remote).toBeNull();
+        });
+        // verify slugs exist and are unique
+        const slugs = plan.changes.map((c) => c.forResource.slug);
+        expect(slugs.length).toBe(2);
+        expect(slugs[0]).toBeDefined();
+        expect(slugs[1]).toBeDefined();
+        expect(slugs[0]).not.toBe(slugs[1]);
+    });
+    it('should throw when wish file does not exist', async () => {
+        const nonexistentWishPath = (0, path_1.resolve)(__dirname, 'nonexistent.ts');
+        await expect((0, plan_1.executePlanCommand)({
+            wishFilePath: nonexistentWishPath,
+            planFilePath,
+        })).rejects.toThrow('Wish file not found');
+    });
+    it('should throw when wish file does not export getResources', async () => {
+        const badWishPath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/bad-wish.ts');
+        // create bad wish file
+        const { writeFile } = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await writeFile(badWishPath, 'export const getProviders = async () => [];', 'utf-8');
+        await expect((0, plan_1.executePlanCommand)({ wishFilePath: badWishPath, planFilePath })).rejects.toThrow('Wish file must export getResources() function');
+        // cleanup
+        await (0, promises_1.rm)(badWishPath);
+    });
+    it('should throw when wish file does not export getProviders', async () => {
+        const badWishPath = (0, path_1.resolve)(process.cwd(), 'src/.test/assets/bad-wish2.ts');
+        // create bad wish file
+        const { writeFile } = await Promise.resolve().then(() => __importStar(require('fs/promises')));
+        await writeFile(badWishPath, 'export const getResources = async () => [];', 'utf-8');
+        await expect((0, plan_1.executePlanCommand)({ wishFilePath: badWishPath, planFilePath })).rejects.toThrow('Wish file must export getProviders() function');
+        // cleanup
+        await (0, promises_1.rm)(badWishPath);
+    });
+    it('should detect KEEP action when resource already exists remotely', async () => {
+        // first run - create resources
+        await (0, plan_1.executePlanCommand)({ wishFilePath, planFilePath });
+        // read first plan
+        const firstPlanJson = await (0, promises_1.readFile)(planFilePath, 'utf-8');
+        const firstPlan = new DeclastructPlan_1.DeclastructPlan(JSON.parse(firstPlanJson));
+        // verify all CREATE
+        expect(firstPlan.changes.every((c) => c.action === 'CREATE')).toBe(true);
+        // cleanup and run again
+        await (0, promises_1.rm)(planFilePath);
+        // Note: In a real integration test, we would need to actually apply the changes
+        // to populate remote state. For now, this test just verifies the basic flow.
+        // A more complete test would require mocking or actual provider state.
+    });
+});
+//# sourceMappingURL=plan.integration.test.js.map

package/dist/contract/cli/plan.integration.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plan.integration.test.js","sourceRoot":"","sources":["../../../src/contract/cli/plan.integration.test.ts"],"names":[],"mappings":"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"}