@quadnix/octo-build 0.1.0 → 0.2.0

package/dist/utilities/octo/octo.utility.js

@@ -1,144 +1,178 @@
 import { existsSync } from 'fs';
 import { delimiter, dirname, resolve } from 'path';
-import { Container, Octo, StateManagementService } from '@quadnix/octo';
+import { CommandFailedEvent, CommandFinishedEvent, CommandStartedEvent, Container, Octo, StateManagementService, } from '@quadnix/octo';
 import chalk from 'chalk';
 import { YamlDefinitionUtility } from '../definition/yaml/yaml-definition.utility.js';
 /**
- * The absolute path of the definition file, from `OCTO_DEFINITION_FILE_PATH`.
- *
- * @throws If the variable is unset, or names a file that does not exist.
+ * Boots octo the way every lifecycle command does, from the definition file `OCTO_DEFINITION_FILE_PATH`
+ * names, and reports what went wrong when a command fails.
  */
-function resolveDefinitionFilePath() {
-    const fromEnv = process.env.OCTO_DEFINITION_FILE_PATH;
-    if (!fromEnv) {
-        throw new Error(`Environment variable "OCTO_DEFINITION_FILE_PATH" is not set! Set it to the path of your Octo definition YAML file.`);
-    }
-    const definitionFilePath = resolve(process.cwd(), fromEnv);
-    if (!existsSync(definitionFilePath)) {
-        throw new Error(`Octo definition file not found at "${definitionFilePath}"!`);
-    }
-    return definitionFilePath;
-}
-/**
- * Boots only the state provider the definition names, without loading a single module.
- *
- * `apply` is a terraform action rather than an octo mode, so it has no reason to compose a model
- * graph - but terraform state is checked out of the state provider and back into it around every
- * terraform command, so the provider still has to be there.
- */
-export async function bootStateProvider() {
-    const definition = new YamlDefinitionUtility(resolveDefinitionFilePath());
-    const stateProvider = definition.resolveStateProvider();
-    await Container.getInstance().get(StateManagementService, {
-        args: [stateProvider.type],
-    });
-}
-/**
- * @param quietStdout Keeps **stdout** free of everything but the command's own output. Set by
- * `run-action`, whose stdout is consumed by terraform's `data "external"` as JSON.
- *
- * It does not disable listeners — it routes them to stderr, so that the SDK resource-action path,
- * the only place resource actions actually execute, stays observable.
- */
-export async function bootOcto({ quietStdout = false } = {}) {
-    const definition = new YamlDefinitionUtility(resolveDefinitionFilePath());
-    const hooks = await definition.resolveHooks();
-    const imports = await definition.resolveImports();
-    const listeners = await definition.resolveListeners({ logDestination: quietStdout ? 'stderr' : 'stdout' });
-    const modules = definition.resolveModules(imports);
-    const stateProvider = definition.resolveStateProvider();
-    const tags = definition.resolveTags();
-    const terraformOptions = definition.resolveTerraformOptions();
-    if (!quietStdout) {
-        console.log(chalk.green('Definition file is valid and all modules were successfully imported.'));
-    }
-    // Initialize.
-    const octo = new Octo();
-    await octo.initialize(stateProvider.type, listeners.map((l) => ({
-        options: {
-            args: l.args,
-            metadata: l.metadata,
-        },
-        type: l.type,
-    })));
-    // Register hooks.
-    octo.registerHooks(hooks);
-    // Register terraform config + providers.
-    octo.registerTerraformConfig({
-        minTerraformVersion: terraformOptions.requiredVersion,
-        providers: terraformOptions.requiredProviders,
-    });
-    for (const provider of terraformOptions.providers) {
-        octo.registerTerraformProvider(provider.providerType, provider.accountId, provider.regionId, provider.spec, {
-            accountName: provider.accountName,
-            setRegionAttribute: provider.setRegionAttribute,
+export class OctoUtility {
+    /**
+     * Boots octo with every listener, hook, module and terraform provider the definition lists, and
+     * composes the app. Prints nothing, so stdout carries only the command's own output.
+     */
+    static async bootOcto() {
+        const definition = new YamlDefinitionUtility(OctoUtility.resolveDefinitionFilePath());
+        const hooks = await definition.resolveHooks();
+        const imports = await definition.resolveImports();
+        const listeners = await definition.resolveListeners();
+        const modules = definition.resolveModules(imports);
+        const stateProvider = definition.resolveStateProvider();
+        const tags = definition.resolveTags();
+        const terraformOptions = definition.resolveTerraformOptions();
+        // Initialize.
+        const octo = new Octo();
+        await octo.initialize(stateProvider.type, listeners.map((l) => ({
+            options: {
+                args: l.args,
+                metadata: l.metadata,
+            },
+            type: l.type,
+        })));
+        // Register hooks.
+        octo.registerHooks(hooks);
+        // Register terraform config + providers.
+        octo.registerTerraformConfig({
+            minTerraformVersion: terraformOptions.requiredVersion,
+            providers: terraformOptions.requiredProviders,
         });
+        for (const provider of terraformOptions.providers) {
+            octo.registerTerraformProvider(provider.providerType, provider.accountId, provider.regionId, provider.spec, {
+                accountName: provider.accountName,
+                setRegionAttribute: provider.setRegionAttribute,
+            });
+        }
+        // Load modules.
+        for (const moduleDefinition of modules) {
+            octo.loadModule(moduleDefinition.moduleClass, moduleDefinition.moduleId, moduleDefinition.moduleInputs);
+        }
+        octo.orderModules(modules.map((m) => m.moduleClass));
+        // Compose.
+        await octo.compose();
+        const app = octo.getRootModel();
+        // Register tags. A module-scoped tag names a module that only exists once compose has run it.
+        octo.registerTags(tags);
+        return { app, octo };
     }
-    // Load modules.
-    for (const moduleDefinition of modules) {
-        octo.loadModule(moduleDefinition.moduleClass, moduleDefinition.moduleId, moduleDefinition.moduleInputs);
+    /**
+     * Boots only the state provider the definition names, without loading a single module, and returns
+     * how often terraform state is checked into it during a terraform command. Loads every listener the definition lists.
+     *
+     * `apply` is a terraform action rather than an octo mode, so it has no reason to compose a model
+     * graph - but terraform state is checked out of the state provider and back into it around every
+     * terraform command, so the provider still has to be there, and terraform's output reaches the
+     * terminal only through the listeners.
+     */
+    static async bootStateProvider() {
+        const definition = new YamlDefinitionUtility(OctoUtility.resolveDefinitionFilePath());
+        const stateProvider = definition.resolveStateProvider();
+        await Container.getInstance().get(StateManagementService, {
+            args: [stateProvider.type],
+        });
+        for (const listener of await definition.resolveListeners()) {
+            await Container.getInstance().get(listener.type, {
+                args: listener.args,
+                metadata: listener.metadata,
+            });
+        }
+        return { stateCheckInIntervalInMs: definition.resolveStateCheckInIntervalInMs() };
     }
-    octo.orderModules(modules.map((m) => m.moduleClass));
-    // Compose.
-    await octo.compose();
-    const app = octo.getRootModel();
-    // Register tags. A module-scoped tag names a module that only exists once compose has run it.
-    octo.registerTags(tags);
-    return { app, octo };
-}
-/**
- * Makes the environment survive the trip into terraform's `local-exec`.
- *
- * An external resource shells back out to `octo` from the terraform that terragrunt runs -
- * `run-action` from its `local-exec` provisioner, `get-response` from its `data "external"` - and
- * those commands inherit this process's environment. Two things about it are wrong by default, and
- * both fail only after real infrastructure exists:
- *
- * - **`octo` is a bare binary name**, resolved through `PATH`. Invoking a binary by path -
- *   `node_modules/.bin/octo apply` - does not put its directory on `PATH` for child processes, so
- *   the callback dies with `octo: command not found`. The generated app runs the flow through
- *   package scripts, and `npm run` does put that directory on `PATH`, but running the binary
- *   directly is still supported and has to work the same. The project's bin directory is prepended
- *   here, and the directory this CLI is running from after it, so a globally installed or linked
- *   octo still wins over nothing at all.
- * - **`OCTO_DEFINITION_FILE_PATH` is usually relative** (`octo.yaml` - the package scripts set
- *   exactly that), and terraform runs `local-exec` with a terragrunt cache directory as its cwd,
- *   where that resolves to nothing. It is made absolute here, against the cwd the user actually
- *   invoked from.
- */
-export function prepareCallbackEnvironment() {
-    const definitionFilePath = process.env.OCTO_DEFINITION_FILE_PATH;
-    if (definitionFilePath) {
-        process.env.OCTO_DEFINITION_FILE_PATH = resolve(process.cwd(), definitionFilePath);
+    /**
+     * Makes the environment survive the trip into terraform's `local-exec`.
+     *
+     * An external resource shells back out to `octo` from the terraform that terragrunt runs -
+     * `run-action` from its `local-exec` provisioner, `get-response` from its `data "external"` - and
+     * those commands inherit this process's environment. Two things about it are wrong by default, and
+     * both fail only after real infrastructure exists:
+     *
+     * - **`octo` is a bare binary name**, resolved through `PATH`. Invoking a binary by path -
+     *   `node_modules/.bin/octo apply` - does not put its directory on `PATH` for child processes, so
+     *   the callback dies with `octo: command not found`. The generated app runs the flow through
+     *   package scripts, and `npm run` does put that directory on `PATH`, but running the binary
+     *   directly is still supported and has to work the same. The project's bin directory is prepended
+     *   here, and the directory this CLI is running from after it, so a globally installed or linked
+     *   octo still wins over nothing at all.
+     * - **`OCTO_DEFINITION_FILE_PATH` is usually relative** (`octo.yaml` - the package scripts set
+     *   exactly that), and terraform runs `local-exec` with a terragrunt cache directory as its cwd,
+     *   where that resolves to nothing. It is made absolute here, against the cwd the user actually
+     *   invoked from.
+     */
+    static prepareCallbackEnvironment() {
+        const definitionFilePath = process.env.OCTO_DEFINITION_FILE_PATH;
+        if (definitionFilePath) {
+            process.env.OCTO_DEFINITION_FILE_PATH = resolve(process.cwd(), definitionFilePath);
+        }
+        const binDirectories = [resolve(process.cwd(), 'node_modules', '.bin'), dirname(process.argv[1] ?? '')].filter((directory) => directory && existsSync(directory));
+        const pathEntries = (process.env.PATH ?? '').split(delimiter).filter(Boolean);
+        process.env.PATH = [...binDirectories.filter((d) => !pathEntries.includes(d)), ...pathEntries].join(delimiter);
     }
-    const binDirectories = [resolve(process.cwd(), 'node_modules', '.bin'), dirname(process.argv[1] ?? '')].filter((directory) => directory && existsSync(directory));
-    const pathEntries = (process.env.PATH ?? '').split(delimiter).filter(Boolean);
-    process.env.PATH = [...binDirectories.filter((d) => !pathEntries.includes(d)), ...pathEntries].join(delimiter);
-}
-/**
- * Prints an octo error to stderr, including the properties it carries - the diff that matched no
- * action, most of all - which a bare stack trace would hide.
- */
-export function reportError(error) {
-    console.error(chalk.red(error.stack));
-    for (const errorProperty of Object.getOwnPropertyNames(error) || []) {
-        if (errorProperty !== 'message' && errorProperty !== 'stack') {
-            // Serialized rather than interpolated: the properties worth attaching to an octo error are
-            // objects - the diff that matched no action, most of all - and `${}` renders those as
-            // "[object Object]", which hides the only thing that would identify the node and field.
-            const value = error[errorProperty];
-            const renderedValue = value !== null && typeof value === 'object' ? JSON.stringify(value, undefined, 2) : String(value);
-            console.error(chalk.red(`${errorProperty}: ${renderedValue}`));
+    /**
+     * Prints an octo error to stderr, including the properties it carries - the diff that matched no
+     * action, most of all - which a bare stack trace would hide.
+     */
+    static reportError(error) {
+        console.error(chalk.red(error.stack));
+        for (const errorProperty of Object.getOwnPropertyNames(error) || []) {
+            if (errorProperty !== 'message' && errorProperty !== 'stack') {
+                // Serialized rather than interpolated: the properties worth attaching to an octo error are
+                // objects - the diff that matched no action, most of all - and `${}` renders those as
+                // "[object Object]", which hides the only thing that would identify the node and field.
+                const value = error[errorProperty];
+                const renderedValue = value !== null && typeof value === 'object' ? JSON.stringify(value, undefined, 2) : String(value);
+                console.error(chalk.red(`${errorProperty}: ${renderedValue}`));
+            }
+        }
+        const failures = error.failures || [];
+        if (failures.length > 0) {
+            console.error('\n');
+            console.error(chalk.red('FAILURES'));
+            console.error(chalk.red('========'));
+        }
+        for (let i = 0; i < failures.length; i++) {
+            console.error(chalk.red(`${i + 1}. ${failures[i]}`));
         }
     }
-    const failures = error.failures || [];
-    if (failures.length > 0) {
-        console.error('\n');
-        console.error(chalk.red('FAILURES'));
-        console.error(chalk.red('========'));
+    /**
+     * Runs one lifecycle command: announces it, runs `body`, and exits with 1 after reporting what it
+     * threw. The command's end is announced, and awaited by listeners such as the journal, before the
+     * process exits.
+     */
+    static async runCommand(command, body) {
+        const eventService = (await Container.getInstance().get('EventService'));
+        const startedAt = Date.now();
+        eventService.emit(new CommandStartedEvent(undefined, { command }));
+        // Run the command, announcing how it ended.
+        try {
+            await body();
+        }
+        catch (error) {
+            await eventService.emitAndWait(new CommandFailedEvent(undefined, {
+                command,
+                durationInMs: Date.now() - startedAt,
+                error: error instanceof Error ? error : new Error(String(error)),
+            }));
+            OctoUtility.reportError(error);
+            process.exit(1);
+            return;
+        }
+        await eventService.emitAndWait(new CommandFinishedEvent(undefined, { command, durationInMs: Date.now() - startedAt }));
     }
-    for (let i = 0; i < failures.length; i++) {
-        console.error(chalk.red(`${i + 1}. ${failures[i]}`));
+    /**
+     * The absolute path of the definition file, from `OCTO_DEFINITION_FILE_PATH`.
+     *
+     * @throws If the variable is unset, or names a file that does not exist.
+     */
+    static resolveDefinitionFilePath() {
+        const fromEnv = process.env.OCTO_DEFINITION_FILE_PATH;
+        if (!fromEnv) {
+            throw new Error(`Environment variable "OCTO_DEFINITION_FILE_PATH" is not set! Set it to the path of your Octo definition YAML file.`);
+        }
+        const definitionFilePath = resolve(process.cwd(), fromEnv);
+        if (!existsSync(definitionFilePath)) {
+            throw new Error(`Octo definition file not found at "${definitionFilePath}"!`);
+        }
+        return definitionFilePath;
     }
 }
 //# sourceMappingURL=octo.utility.js.map

package/dist/utilities/octo/octo.utility.js.map

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

package/package.json

@@ -6,8 +6,8 @@
     "url": "https://github.com/quadnix/octo/issues"
   },
   "dependencies": {
-    "@quadnix/octo": "~0.1.0",
-    "@quadnix/octo-event-listeners": "~0.1.0",
+    "@quadnix/octo": "~0.2.0",
+    "@quadnix/octo-event-listeners": "~0.2.0",
     "ajv": "~8.17.1",
     "chalk": "~5.5.0",
     "js-yaml": "~4.1.0",
@@ -80,12 +80,14 @@
   },
   "type": "module",
   "types": "./dist/index.d.ts",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "scripts": {
     "build": "rimraf dist && tsc -p tsconfig.build.json && pnpm run copy-assets && chmod +x ./dist/index.js",
     "check:circular-dependency": "dpdm --no-tree --exit-code circular:1 --no-warning ./dist/index.js",
+    "check:types": "tsc --noEmit -p tsconfig.json",
     "copy-assets": "copyfiles -u 1 \"src/**/*.{ejs,json}\" dist/",
     "format": "prettier --write \"src/**/*.ts\" \"test/**/*.ts\"",
+    "format:check": "prettier --check \"src/**/*.ts\" \"test/**/*.ts\"",
     "lint": "eslint .",
     "lint:fix": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
     "test": "NODE_OPTIONS=--experimental-vm-modules jest --testRegex=\"\\.spec.ts$\"",