@quadnix/octo-build 0.0.17 → 0.2.0

package/dist/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/index.d.ts

@@ -0,0 +1,25 @@
+import Generator, { type BaseOptions } from 'yeoman-generator';
+/**
+ * @internal
+ */
+export default class extends Generator {
+    private readonly packageName;
+    private readonly projectRootDir;
+    private readonly resourceName;
+    /**
+     * @internal
+     */
+    constructor(args: string[], opts: BaseOptions);
+    /**
+     * @internal
+     */
+    end(): void;
+    /**
+     * @internal
+     */
+    initializing(): Promise<void>;
+    /**
+     * @internal
+     */
+    writing(): Promise<void>;
+}

package/dist/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/index.js

@@ -0,0 +1,71 @@
+import { readdir, stat } from 'fs/promises';
+import { join, resolve } from 'path';
+import Generator, {} from 'yeoman-generator';
+import { ProjectIndexUtility } from '../../../../../utilities/project-index/project-index.utility.js';
+import { StringUtility } from '../../../../../utilities/string/string.utility.js';
+/**
+ * @internal
+ */
+export default class extends Generator {
+    /**
+     * @internal
+     */
+    constructor(args, opts) {
+        super(args, opts);
+        this.resourceName = args[0];
+        this.packageName = args[1];
+        this.projectRootDir = args[2];
+    }
+    /**
+     * @internal
+     */
+    end() {
+        const targetPath = resolve(join(this.projectRootDir, 'src', 'resources', this.resourceName));
+        this.log('✅ Your terraform resource has been generated successfully!');
+        this.log(`📁 Resource created at: ${targetPath}`);
+        ProjectIndexUtility.addImport(this.projectRootDir, `./resources/${this.resourceName}/index.js`);
+        this.log('📦 Next steps:');
+        this.log(`   Address all "Fix me" in generated files`);
+    }
+    /**
+     * @internal
+     */
+    async initializing() {
+        const targetPath = resolve(join(this.projectRootDir, 'src', 'resources', this.resourceName));
+        // Check if directory already exists and is not empty.
+        let targetPathStat;
+        try {
+            targetPathStat = await stat(targetPath);
+        }
+        catch (error) {
+            if (error.code !== 'ENOENT') {
+                throw error;
+            }
+        }
+        if (targetPathStat?.isDirectory()) {
+            const files = await readdir(targetPath);
+            if (files.length > 0) {
+                throw new Error(`Directory '${targetPath}' already exists and is not empty!`);
+            }
+        }
+        // Set the destination root to the resource directory.
+        this.destinationRoot(targetPath);
+    }
+    /**
+     * @internal
+     */
+    async writing() {
+        const templateData = {
+            packageName: this.packageName,
+            resourceName: this.resourceName,
+            resourceNamePascal: StringUtility.toPascalCase(this.resourceName),
+        };
+        // Create the terraform resource file.
+        this.fs.copyTpl(this.templatePath('resources/resource/resource.ts.ejs'), this.destinationPath(`${this.resourceName}.resource.ts`), templateData);
+        // Create schema file.
+        this.fs.copyTpl(this.templatePath('resources/resource/index.schema.ts.ejs'), this.destinationPath('index.schema.ts'), templateData);
+        // Create index.ts
+        this.fs.copyTpl(this.templatePath('resources/resource/index.ts.ejs'), this.destinationPath('index.ts'), templateData);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../../src/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/index.ts"],"names":[],"mappings":"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"}

package/dist/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/templates/resources/resource/index.schema.ts.ejs

@@ -0,0 +1,43 @@
+import { BaseResourceSchema, Schema, Validate } from '@quadnix/octo';
+
+export class <%= resourceNamePascal %>Schema extends BaseResourceSchema {
+  @Validate({
+    destruct: (value: <%= resourceNamePascal %>Schema['properties']): string[] => [
+      // Fix me: Add properties for validation.
+    ],
+    options: { minLength: 1 },
+  })
+  override properties = Schema<{
+    // Fix me: Add resource properties.
+  }>();
+
+  @Validate({
+    destruct: (value: <%= resourceNamePascal %>Schema['response']): string[] => {
+      const subjects: string[] = [];
+      // Fix me: Add a check per response key below.
+      if (value.SomeId) {
+        subjects.push(value.SomeId);
+      }
+      return subjects;
+    },
+    options: { minLength: 1 },
+  })
+  /**
+   * One key per Terraform output exposed in `toHCL()`. Each is emitted as an
+   * `output "${resourceId}-${key}"` and is how other resources and modules consume this resource,
+   * via `terraform.getRef(this, 'SomeId')`.
+   *
+   * The value passed to `Schema<...>()` is that key's **default**, and it is not decoration: it
+   * becomes the key's terragrunt `mock_outputs` entry, which is what a consumer plans against
+   * before this resource has been applied. Make each one a syntactically valid example of the real
+   * thing - a plausible ARN, a plausible id - because a consumer's `plan` runs the provider's own
+   * parsing over it. Without a default the mock falls back to the literal `mock-<outputName>`, and
+   * any consumer whose attribute must parse as an ARN or an id fails to plan.
+   */
+  override response = Schema<{
+    // Fix me: Rename, and add one entry per output.
+    SomeId?: string;
+  }>({
+    SomeId: 'some-0123456789abcdef0',
+  });
+}

package/dist/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/templates/resources/resource/index.ts.ejs

@@ -0,0 +1 @@
+export { <%= resourceNamePascal %> } from './<%= resourceName %>.resource.js';

package/dist/commands/create-terraform-resource/generator-octo-terraform-resource-template/generators/app/templates/resources/resource/resource.ts.ejs

@@ -0,0 +1,83 @@
+import {
+  ATerraformResource,
+  Diff,
+  DiffAction,
+  DiffUtility,
+  Resource,
+  type TerraformModuleScope,
+} from '@quadnix/octo';
+import { <%= resourceNamePascal %>Schema } from './index.schema.js';
+
+/**
+ * A Terraform-managed resource. Its lifecycle (create / update / delete) is handled by Terraform
+ * via `toHCL()`, which Octo invokes automatically while generating Terraform files.
+ *
+ * Terraform resources cannot have resource actions — registering one throws. For a resource whose
+ * lifecycle runs outside Terraform (SDK calls, scripts), use `create-external-resource` instead.
+ */
+@Resource<<%= resourceNamePascal %>>('<%= packageName %>', '<%= resourceName %>', <%= resourceNamePascal %>Schema)
+export class <%= resourceNamePascal %> extends ATerraformResource<<%= resourceNamePascal %>Schema, <%= resourceNamePascal %>> {
+  declare properties: <%= resourceNamePascal %>Schema['properties'];
+  declare response: <%= resourceNamePascal %>Schema['response'];
+
+  constructor(resourceId: string, properties: <%= resourceNamePascal %>Schema['properties'], parents: []) {
+    super(resourceId, properties, parents);
+  }
+
+  /**
+   * Declares what a property change does to the real resource.
+   *
+   * The default emits a granular in-place `UPDATE`, which is wrong for any attribute the provider
+   * marks force-new: Terraform would recreate the resource while Octo reported an update, and
+   * `octo validate` would flag the recreate as unexplained because there is no reason string to
+   * show. Returning `REPLACE` states the recreate up front, and the reason is what validate prints.
+   *
+   * Fix me: list the force-new attributes in the reason. If some properties are updatable in place
+   * and others are not, compare them separately and emit `REPLACE` only for the force-new ones.
+   */
+  override async diffProperties(previous: <%= resourceNamePascal %>): Promise<Diff[]> {
+    if (!DiffUtility.isObjectDeepEquals(previous.properties, this.properties)) {
+      return [
+        new Diff(
+          this,
+          DiffAction.REPLACE,
+          'resourceId',
+          this.getContext(),
+          'Fix me: <attribute> is force-new on <terraform_resource_type>; a change recreates the resource',
+        ),
+      ];
+    }
+
+    return [];
+  }
+
+  override async toHCL(terraform: TerraformModuleScope): Promise<void> {
+    // The `as` cast is load-bearing: without it `this` stays polymorphic, the scope's response type
+    // resolves against `this` rather than this schema, and `output()` below does not typecheck.
+    const octoResource = terraform.addOctoTerraformResource(this as <%= resourceNamePascal %>, {
+      // Fix me: bind to the provider this resource deploys into (accountId + regionId of a registered provider).
+      provider: { accountId: 'Fix me', regionId: 'Fix me' },
+    });
+
+    const tfResource = octoResource.addTerraformResource(
+      // Fix me: set the Terraform resource type (e.g. 'aws_vpc').
+      'terraform_resource_type',
+      this.resourceId,
+      {
+        // Fix me: set Terraform attributes. Reference a parent's output via
+        // terraform.getRef(this.parents[0], 'SomeResponseKey').
+      },
+    );
+
+    // One entry per key declared on the schema's `response`. The two must agree: a key declared and
+    // not emitted here makes `octo commit` throw "missing terraform outputs" after a real apply,
+    // which is the most expensive place to find out.
+    octoResource.output({
+      SomeId: terraform.raw(`${tfResource.address}.id`),
+    });
+
+    if (Object.keys(this.tags).length > 0) {
+      tfResource.attribute('tags', this.tags);
+    }
+  }
+}

package/dist/commands/create-terraform-resource/index.d.ts

@@ -0,0 +1 @@
+export { createTerraformResourceCommand } from './create-terraform-resource.command.js';

package/dist/commands/create-terraform-resource/index.js

@@ -0,0 +1,2 @@
+export { createTerraformResourceCommand } from './create-terraform-resource.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/create-terraform-resource/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/create-terraform-resource/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,8BAA8B,EAAE,MAAM,wCAAwC,CAAC"}

package/dist/commands/generate/generate.command.d.ts

@@ -0,0 +1,16 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+type GenerateCommandArguments = {
+    outputDir: string;
+};
+/**
+ * Step 1 of the octo lifecycle. See `Octo.generate()`.
+ *
+ * The state is refreshed before octo boots, because booting is what reads it.
+ */
+export declare const generateCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<GenerateCommandArguments>) => Promise<void>;
+};
+export {};

package/dist/commands/generate/generate.command.js

@@ -0,0 +1,35 @@
+import { resolve } from 'path';
+import { Container, StateManagementService } from '@quadnix/octo';
+import { OctoUtility } from '../../utilities/octo/octo.utility.js';
+/**
+ * Step 1 of the octo lifecycle. See `Octo.generate()`.
+ *
+ * The state is refreshed before octo boots, because booting is what reads it.
+ */
+export const generateCommand = {
+    builder: (yargs) => {
+        return yargs.option('outputDir', {
+            alias: 'o',
+            demandOption: true,
+            description: 'Directory to write the generated Terragrunt module folders into. Folders are overwritten in place, never ' +
+                'wiped; a deleted module leaves an emptied folder so a later apply destroys its resources.',
+            type: 'string',
+        });
+    },
+    command: 'generate',
+    describe: 'Step 1: generate Terragrunt module folders representing the full desired infrastructure.',
+    handler: async (argv) => {
+        const { outputDir } = argv;
+        await OctoUtility.runCommand('generate', async () => {
+            await OctoUtility.bootStateProvider();
+            await (await Container.getInstance().get(StateManagementService)).refreshState();
+            const { app, octo } = await OctoUtility.bootOcto();
+            const resolvedOutputDir = resolve(process.cwd(), outputDir);
+            await octo.generate(app, { outputDir: resolvedOutputDir });
+            // Nothing is printed here. The listeners report what was written and that the mode finished,
+            // on stderr, and failures reach stderr via `reportError`. Generate has no output of its own, so
+            // stdout stays empty.
+        });
+    },
+};
+//# sourceMappingURL=generate.command.js.map

package/dist/commands/generate/generate.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.command.js","sourceRoot":"","sources":["../../../src/commands/generate/generate.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAC/B,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMnE;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE;QAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,WAAW,EAAE;YAC/B,KAAK,EAAE,GAAG;YACV,YAAY,EAAE,IAAI;YAClB,WAAW,EACT,2GAA2G;gBAC3G,2FAA2F;YAC7F,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,UAAU;IACnB,QAAQ,EAAE,0FAA0F;IACpG,OAAO,EAAE,KAAK,EAAE,IAAkD,EAAiB,EAAE;QACnF,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC;QAE3B,MAAM,WAAW,CAAC,UAAU,CAAC,UAAU,EAAE,KAAK,IAAI,EAAE;YAClD,MAAM,WAAW,CAAC,iBAAiB,EAAE,CAAC;YACtC,MAAM,CAAC,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC,CAAC,YAAY,EAAE,CAAC;YAEjF,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;YAEnD,MAAM,iBAAiB,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,SAAS,CAAC,CAAC;YAC5D,MAAM,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,iBAAiB,EAAE,CAAC,CAAC;YAE3D,6FAA6F;YAC7F,gGAAgG;YAChG,sBAAsB;QACxB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/commands/generate/index.d.ts

@@ -0,0 +1 @@
+export { generateCommand } from './generate.command.js';

package/dist/commands/generate/index.js

@@ -0,0 +1,2 @@
+export { generateCommand } from './generate.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/generate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/generate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/commands/get-response/get-response.command.d.ts

@@ -0,0 +1,18 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+type GetResponseCommandArguments = {
+    resourceId: string;
+};
+/**
+ * Prints a resource's recorded response as JSON.
+ *
+ * Terraform's `data "external"` runs this on every plan and every apply of a folder holding an
+ * external resource; it is not a step you run yourself. It reads octo state and nothing else - no
+ * modules are composed and no cloud is called, so it is safe at plan time and costs one file read.
+ */
+export declare const getResponseCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<GetResponseCommandArguments>) => Promise<void>;
+};
+export {};

package/dist/commands/get-response/get-response.command.js

@@ -0,0 +1,39 @@
+import { Container, StateManagementService } from '@quadnix/octo';
+import { OctoUtility } from '../../utilities/octo/octo.utility.js';
+/**
+ * Prints a resource's recorded response as JSON.
+ *
+ * Terraform's `data "external"` runs this on every plan and every apply of a folder holding an
+ * external resource; it is not a step you run yourself. It reads octo state and nothing else - no
+ * modules are composed and no cloud is called, so it is safe at plan time and costs one file read.
+ */
+export const getResponseCommand = {
+    builder: (yargs) => {
+        return yargs.option('resourceId', {
+            demandOption: true,
+            description: 'The id of the resource whose response should be printed.',
+            type: 'string',
+        });
+    },
+    command: 'get-response',
+    describe: "Print a resource's recorded response. Invoked by Terraform for an external resource.",
+    handler: async (argv) => {
+        const { resourceId } = argv;
+        try {
+            await OctoUtility.bootStateProvider();
+            const stateManagementService = await Container.getInstance().get(StateManagementService);
+            const response = await stateManagementService.getResourceResponse(resourceId);
+            if (!response) {
+                throw new Error(`No response recorded for resource "${resourceId}"! ` +
+                    'Octo records one when the resource is applied, and commits it with the rest of the run.');
+            }
+            // stdout carries ONLY the response JSON - terraform's `data "external"` consumes it.
+            process.stdout.write(JSON.stringify(response));
+        }
+        catch (error) {
+            OctoUtility.reportError(error);
+            process.exit(1);
+        }
+    },
+};
+//# sourceMappingURL=get-response.command.js.map

package/dist/commands/get-response/get-response.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-response.command.js","sourceRoot":"","sources":["../../../src/commands/get-response/get-response.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE;QAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,YAAY,EAAE;YAChC,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,0DAA0D;YACvE,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,cAAc;IACvB,QAAQ,EAAE,sFAAsF;IAChG,OAAO,EAAE,KAAK,EAAE,IAAqD,EAAiB,EAAE;QACtF,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAE5B,IAAI,CAAC;YACH,MAAM,WAAW,CAAC,iBAAiB,EAAE,CAAC;YACtC,MAAM,sBAAsB,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YAEzF,MAAM,QAAQ,GAAG,MAAM,sBAAsB,CAAC,mBAAmB,CAAC,UAAU,CAAC,CAAC;YAC9E,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CACb,sCAAsC,UAAU,KAAK;oBACnD,yFAAyF,CAC5F,CAAC;YACJ,CAAC;YAED,qFAAqF;YACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACjD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAC/B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;CACF,CAAC"}

package/dist/commands/get-response/index.d.ts

@@ -0,0 +1 @@
+export { getResponseCommand } from './get-response.command.js';

package/dist/commands/get-response/index.js

@@ -0,0 +1,2 @@
+export { getResponseCommand } from './get-response.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/get-response/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/get-response/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/commands/lock/index.d.ts

@@ -0,0 +1 @@
+export { lockCommand } from './lock.command.js';

package/dist/commands/lock/index.js

@@ -0,0 +1,2 @@
+export { lockCommand } from './lock.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/lock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/lock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/commands/lock/lock.command.d.ts

@@ -0,0 +1,18 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+type LockCommandArguments = {
+    lockId?: string;
+};
+/**
+ * Takes the app lock, which `apply` and `commit` both require. With `--lockId`, resumes the run
+ * already holding that lock, which is how a run that died is finished.
+ *
+ * The lock id is the only thing printed on stdout, so a shell can capture it:
+ * `LOCK_ID=$(octo lock)`. Everything else goes to stderr.
+ */
+export declare const lockCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<LockCommandArguments>) => Promise<void>;
+};
+export {};

package/dist/commands/lock/lock.command.js

@@ -0,0 +1,31 @@
+import { Container, StateManagementService } from '@quadnix/octo';
+import chalk from 'chalk';
+import { OctoUtility } from '../../utilities/octo/octo.utility.js';
+/**
+ * Takes the app lock, which `apply` and `commit` both require. With `--lockId`, resumes the run
+ * already holding that lock, which is how a run that died is finished.
+ *
+ * The lock id is the only thing printed on stdout, so a shell can capture it:
+ * `LOCK_ID=$(octo lock)`. Everything else goes to stderr.
+ */
+export const lockCommand = {
+    builder: (yargs) => {
+        return yargs.option('lockId', {
+            demandOption: false,
+            description: 'Resume the run holding this lock ID instead of taking a new lock. Stop that run first.',
+            type: 'string',
+        });
+    },
+    command: 'lock',
+    describe: 'Take the app state lock, printing its ID. Required before apply and commit.',
+    handler: async (argv) => {
+        await OctoUtility.runCommand('lock', async () => {
+            await OctoUtility.bootStateProvider();
+            const stateManagementService = await Container.getInstance().get(StateManagementService);
+            const { lockId } = await stateManagementService.lockApp(argv.lockId);
+            console.error(chalk.green(argv.lockId ? 'App lock is resumed.' : 'App is locked.'));
+            console.log(lockId);
+        });
+    },
+};
+//# sourceMappingURL=lock.command.js.map

package/dist/commands/lock/lock.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lock.command.js","sourceRoot":"","sources":["../../../src/commands/lock/lock.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE;QAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC5B,YAAY,EAAE,KAAK;YACnB,WAAW,EAAE,wFAAwF;YACrG,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,MAAM;IACf,QAAQ,EAAE,6EAA6E;IACvF,OAAO,EAAE,KAAK,EAAE,IAA8C,EAAiB,EAAE;QAC/E,MAAM,WAAW,CAAC,UAAU,CAAC,MAAM,EAAE,KAAK,IAAI,EAAE;YAC9C,MAAM,WAAW,CAAC,iBAAiB,EAAE,CAAC;YACtC,MAAM,sBAAsB,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YAEzF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,sBAAsB,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAErE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC;YACpF,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACtB,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/commands/run-action/index.d.ts

@@ -0,0 +1 @@
+export { runActionCommand } from './run-action.command.js';

package/dist/commands/run-action/index.js

@@ -0,0 +1,2 @@
+export { runActionCommand } from './run-action.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/run-action/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/run-action/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/commands/run-action/run-action.command.d.ts

@@ -0,0 +1,12 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+type RunActionCommandArguments = {
+    input?: string[];
+    resourceId: string;
+};
+export declare const runActionCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<RunActionCommandArguments>) => Promise<void>;
+};
+export {};

package/dist/commands/run-action/run-action.command.js

@@ -0,0 +1,40 @@
+import { OctoUtility } from '../../utilities/octo/octo.utility.js';
+export const runActionCommand = {
+    builder: (yargs) => {
+        return yargs
+            .option('resourceId', {
+            demandOption: true,
+            description: 'The id of the resource whose action should run.',
+            type: 'string',
+        })
+            .option('input', {
+            array: true,
+            default: [],
+            description: 'Parent response input, as <parentResourceId>.<responseKey>=<value>. Repeatable.',
+            type: 'string',
+        });
+    },
+    command: 'run-action',
+    describe: 'Run a single resource action. Invoked by Terraform mid-apply for an external resource.',
+    handler: async (argv) => {
+        const { input, resourceId } = argv;
+        await OctoUtility.runCommand('run-action', async () => {
+            const inputs = {};
+            for (const entry of input ?? []) {
+                const separatorIndex = entry.indexOf('=');
+                if (separatorIndex < 0) {
+                    throw new Error(`Invalid --input "${entry}"! Expected <parentResourceId>.<responseKey>=<value>.`);
+                }
+                inputs[entry.slice(0, separatorIndex)] = entry.slice(separatorIndex + 1);
+            }
+            const { app, octo } = await OctoUtility.bootOcto();
+            const result = await octo.runAction(app, {
+                inputs,
+                resourceId,
+            });
+            // stdout carries ONLY the response JSON — terraform's `data "external"` consumes it.
+            process.stdout.write(JSON.stringify(result.response));
+        });
+    },
+};
+//# sourceMappingURL=run-action.command.js.map

package/dist/commands/run-action/run-action.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-action.command.js","sourceRoot":"","sources":["../../../src/commands/run-action/run-action.command.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAOnE,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE;QAC7B,OAAO,KAAK;aACT,MAAM,CAAC,YAAY,EAAE;YACpB,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,iDAAiD;YAC9D,IAAI,EAAE,QAAQ;SACf,CAAC;aACD,MAAM,CAAC,OAAO,EAAE;YACf,KAAK,EAAE,IAAI;YACX,OAAO,EAAE,EAAE;YACX,WAAW,EAAE,iFAAiF;YAC9F,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,YAAY;IACrB,QAAQ,EAAE,wFAAwF;IAClG,OAAO,EAAE,KAAK,EAAE,IAAmD,EAAiB,EAAE;QACpF,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,IAAI,CAAC;QAEnC,MAAM,WAAW,CAAC,UAAU,CAAC,YAAY,EAAE,KAAK,IAAI,EAAE;YACpD,MAAM,MAAM,GAA2B,EAAE,CAAC;YAC1C,KAAK,MAAM,KAAK,IAAI,KAAK,IAAI,EAAE,EAAE,CAAC;gBAChC,MAAM,cAAc,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;gBAC1C,IAAI,cAAc,GAAG,CAAC,EAAE,CAAC;oBACvB,MAAM,IAAI,KAAK,CAAC,oBAAoB,KAAK,uDAAuD,CAAC,CAAC;gBACpG,CAAC;gBACD,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,cAAc,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,cAAc,GAAG,CAAC,CAAC,CAAC;YAC3E,CAAC;YAED,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,CAAC;YAEnD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE;gBACvC,MAAM;gBACN,UAAU;aACX,CAAC,CAAC;YAEH,qFAAqF;YACrF,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/commands/unlock/index.d.ts

@@ -0,0 +1 @@
+export { unlockCommand } from './unlock.command.js';

package/dist/commands/unlock/index.js

@@ -0,0 +1,2 @@
+export { unlockCommand } from './unlock.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/unlock/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/unlock/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/commands/unlock/unlock.command.d.ts

@@ -0,0 +1,18 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+type UnlockCommandArguments = {
+    lockId: string;
+};
+/**
+ * Finishes a run as it stands and releases its lock.
+ *
+ * A successful `commit` releases its own lock, so this is for a run that will not reach one - a run
+ * that never applied, or one somebody finished by hand. With a remote state provider, releasing
+ * seals what the run wrote.
+ */
+export declare const unlockCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<UnlockCommandArguments>) => Promise<void>;
+};
+export {};

package/dist/commands/unlock/unlock.command.js

@@ -0,0 +1,35 @@
+import { Container, StateManagementService } from '@quadnix/octo';
+import chalk from 'chalk';
+import { OctoUtility } from '../../utilities/octo/octo.utility.js';
+/**
+ * Finishes a run as it stands and releases its lock.
+ *
+ * A successful `commit` releases its own lock, so this is for a run that will not reach one - a run
+ * that never applied, or one somebody finished by hand. With a remote state provider, releasing
+ * seals what the run wrote.
+ */
+export const unlockCommand = {
+    builder: (yargs) => {
+        return yargs.option('lockId', {
+            demandOption: true,
+            description: 'The lock ID to release, as printed by `octo lock`.',
+            type: 'string',
+        });
+    },
+    command: 'unlock',
+    describe: 'Finish a run as it stands, releasing its app state lock.',
+    handler: async (argv) => {
+        const { lockId } = argv;
+        await OctoUtility.runCommand('unlock', async () => {
+            await OctoUtility.bootStateProvider();
+            const stateManagementService = await Container.getInstance().get(StateManagementService);
+            if (!(await stateManagementService.getAppLock())) {
+                console.error(chalk.green('App is already unlocked.'));
+                return;
+            }
+            await stateManagementService.unlockApp(lockId);
+            console.error(chalk.green(`App was unlocked, releasing lock ID "${lockId}".`));
+        });
+    },
+};
+//# sourceMappingURL=unlock.command.js.map

package/dist/commands/unlock/unlock.command.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"unlock.command.js","sourceRoot":"","sources":["../../../src/commands/unlock/unlock.command.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAClE,OAAO,KAAK,MAAM,OAAO,CAAC;AAE1B,OAAO,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAMnE;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG;IAC3B,OAAO,EAAE,CAAC,KAAW,EAAQ,EAAE;QAC7B,OAAO,KAAK,CAAC,MAAM,CAAC,QAAQ,EAAE;YAC5B,YAAY,EAAE,IAAI;YAClB,WAAW,EAAE,oDAAoD;YACjE,IAAI,EAAE,QAAQ;SACf,CAAC,CAAC;IACL,CAAC;IACD,OAAO,EAAE,QAAQ;IACjB,QAAQ,EAAE,0DAA0D;IACpE,OAAO,EAAE,KAAK,EAAE,IAAgD,EAAiB,EAAE;QACjF,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC;QAExB,MAAM,WAAW,CAAC,UAAU,CAAC,QAAQ,EAAE,KAAK,IAAI,EAAE;YAChD,MAAM,WAAW,CAAC,iBAAiB,EAAE,CAAC;YACtC,MAAM,sBAAsB,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;YAEzF,IAAI,CAAC,CAAC,MAAM,sBAAsB,CAAC,UAAU,EAAE,CAAC,EAAE,CAAC;gBACjD,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC,CAAC;gBACvD,OAAO;YACT,CAAC;YAED,MAAM,sBAAsB,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;YAC/C,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,wCAAwC,MAAM,IAAI,CAAC,CAAC,CAAC;QACjF,CAAC,CAAC,CAAC;IACL,CAAC;CACF,CAAC"}

package/dist/commands/validate/index.d.ts

@@ -0,0 +1 @@
+export { validateCommand } from './validate.command.js';

package/dist/commands/validate/index.js

@@ -0,0 +1,2 @@
+export { validateCommand } from './validate.command.js';
+//# sourceMappingURL=index.js.map

package/dist/commands/validate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/validate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/commands/validate/validate.command.d.ts

@@ -0,0 +1,17 @@
+import type { ArgumentsCamelCase, Argv } from 'yargs';
+type ValidateCommandArguments = {
+    terraformBinary?: string;
+    terragruntBinary?: string;
+    terragruntDir: string;
+    timeoutInMs?: number;
+};
+/**
+ * Step 2 of the octo lifecycle. See `Octo.validate()`.
+ */
+export declare const validateCommand: {
+    builder: (yargs: Argv) => Argv;
+    command: string;
+    describe: string;
+    handler: (argv: ArgumentsCamelCase<ValidateCommandArguments>) => Promise<void>;
+};
+export {};