@quadnix/octo 0.0.30 → 0.1.0

package/dist/modules/module.abstract.d.ts

@@ -4,14 +4,57 @@ import type { ModelActionHook } from '../functions/hook/model-action.hook.js';
 import type { ResourceActionHook } from '../functions/hook/resource-action.hook.js';
 import type { IModule } from './module.interface.js';
 /**
+ * The base class of every module - the unit you actually assemble infrastructure from.
+ *
+ * A module takes typed inputs, and produces models, overlays, and anchors. It is the reusable piece:
+ * you publish one, someone else loads it with {@link Octo.loadModule} and their own inputs, and the
+ * models it built become available to the modules that run after it.
+ *
+ * Everything a module needs from another module it finds by schema - see
+ * {@link AModel.getAnchorsMatchingSchema} - so modules compose without importing each other's classes.
+ *
+ * @example
+ * ```ts
+ * @Module<MyModule>('@example', MyModuleSchema)
+ * export class MyModule extends AModule<MyModuleSchema, MyRegion> {
+ *   async onInit(inputs: MyModuleSchema): Promise<MyRegion> { ... }
+ * }
+ * ```
+ *
  * @group Modules
+ *
+ * @see Definition of [Modules](/docs/fundamentals/modules).
  */
 export declare abstract class AModule<S, T extends UnknownModel> implements IModule<S, T> {
     static readonly MODULE_PACKAGE: string;
     static readonly MODULE_SCHEMA: ModuleSchema<AModule<any, any>>;
+    /**
+     * The ID this module was loaded under. It scopes everything the module produces, so the same
+     * module class can be loaded more than once.
+     */
     readonly moduleId: string;
+    /**
+     * @param moduleId The ID this module is loaded under.
+     */
     constructor(moduleId: string);
+    /**
+     * Builds this module's infrastructure. It is where you construct models, attach anchors,
+     * and create overlays.
+     *
+     * Validate inputs here and throw a [ModuleError](/api/octo/class/ModuleError) on anything you
+     * cannot satisfy - failing in `onInit` costs nothing, while failing later costs a half-built stack.
+     *
+     * @param inputs The inputs this module was loaded with, already validated against its schema.
+     * @returns The nodes this module produced. Return them all, including overlays - they are what
+     * later modules resolve against.
+     */
     abstract onInit(inputs: S): Promise<T | UnknownModel[]>;
+    /**
+     * To hook custom behavior into Octo's lifecycle for the duration of this module.
+     * Override it to return the callbacks you want run.
+     *
+     * @see Techniques for [Hooks](/docs/techniques/hooks).
+     */
     registerHooks(): {
         postCommitHooks?: Parameters<CommitHook['collectHooks']>[0]['postHooks'];
         postModelActionHooks?: Parameters<ModelActionHook['collectHooks']>[0]['postHooks'];
@@ -20,5 +63,13 @@ export declare abstract class AModule<S, T extends UnknownModel> implements IMod
         preModelActionHooks?: Parameters<ModelActionHook['collectHooks']>[0]['preHooks'];
         preResourceActionHooks?: Parameters<ResourceActionHook['collectHooks']>[0]['preHooks'];
     };
+    /**
+     * To derive values that both {@link AModule.onInit} and this module's actions need - typically
+     * facts resolved from another module's anchors, such as an account ID or a region's availability
+     * zones. Override it, and the returned object is handed to every action of this module as
+     * `actionInputs.metadata`.
+     *
+     * @param inputs The inputs this module was loaded with.
+     */
     registerMetadata(inputs: S): Promise<Record<string, unknown>>;
 }

package/dist/modules/module.abstract.js

@@ -1,14 +1,50 @@
 import { strict as assert } from 'assert';
 /**
+ * The base class of every module - the unit you actually assemble infrastructure from.
+ *
+ * A module takes typed inputs, and produces models, overlays, and anchors. It is the reusable piece:
+ * you publish one, someone else loads it with {@link Octo.loadModule} and their own inputs, and the
+ * models it built become available to the modules that run after it.
+ *
+ * Everything a module needs from another module it finds by schema - see
+ * {@link AModel.getAnchorsMatchingSchema} - so modules compose without importing each other's classes.
+ *
+ * @example
+ * ```ts
+ * @Module<MyModule>('@example', MyModuleSchema)
+ * export class MyModule extends AModule<MyModuleSchema, MyRegion> {
+ *   async onInit(inputs: MyModuleSchema): Promise<MyRegion> { ... }
+ * }
+ * ```
+ *
  * @group Modules
+ *
+ * @see Definition of [Modules](/docs/fundamentals/modules).
  */
 export class AModule {
+    /**
+     * @param moduleId The ID this module is loaded under.
+     */
     constructor(moduleId) {
         this.moduleId = moduleId;
     }
+    /**
+     * To hook custom behavior into Octo's lifecycle for the duration of this module.
+     * Override it to return the callbacks you want run.
+     *
+     * @see Techniques for [Hooks](/docs/techniques/hooks).
+     */
     registerHooks() {
         return {};
     }
+    /**
+     * To derive values that both {@link AModule.onInit} and this module's actions need - typically
+     * facts resolved from another module's anchors, such as an account ID or a region's availability
+     * zones. Override it, and the returned object is handed to every action of this module as
+     * `actionInputs.metadata`.
+     *
+     * @param inputs The inputs this module was loaded with.
+     */
     async registerMetadata(inputs) {
         assert(!!inputs);
         return {};

package/dist/modules/module.abstract.js.map

@@ -1 +1 @@
-{"version":3,"file":"module.abstract.js","sourceRoot":"","sources":["../../src/modules/module.abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAC;AAO1C;;GAEG;AACH,MAAM,OAAgB,OAAO;IAO3B,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAID,aAAa;QAQX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAS;QAC9B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}
+{"version":3,"file":"module.abstract.js","sourceRoot":"","sources":["../../src/modules/module.abstract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAC;AAO1C;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,OAAgB,OAAO;IAW3B;;OAEG;IACH,YAAY,QAAgB;QAC1B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAeD;;;;;OAKG;IACH,aAAa;QAQX,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;OAOG;IACH,KAAK,CAAC,gBAAgB,CAAC,MAAS;QAC9B,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QACjB,OAAO,EAAE,CAAC;IACZ,CAAC;CACF"}

package/dist/modules/module.container.d.ts

@@ -16,16 +16,43 @@ export declare class ModuleContainer {
     private readonly inputService;
     private readonly overlayDataRepository;
     private modules;
+    /**
+     * @internal
+     */
     constructor(eventService: EventService, inputService: InputService, overlayDataRepository: OverlayDataRepository);
+    /**
+     * @internal
+     */
     apply(): Promise<{
         [key: string]: unknown;
     }>;
+    /**
+     * @internal
+     */
     getMetadata(module: Constructable<UnknownModule> | string): ModuleContainer['modules'][0] | undefined;
+    /**
+     * @internal
+     */
     getMetadataIndex(module: Constructable<UnknownModule> | string): number;
+    /**
+     * @internal
+     */
     getModuleInstanceInputKeys(moduleId: string): string[];
+    /**
+     * @internal
+     */
     load<M extends UnknownModule>(module: Constructable<M> | string, moduleId: string, inputs: ModuleSchemaInputs<M>): void;
+    /**
+     * @internal
+     */
     order(modules: (Constructable<UnknownModule> | string)[]): void;
+    /**
+     * @internal
+     */
     register(module: Constructable<UnknownModule>, properties: ModuleOptions): void;
+    /**
+     * @internal
+     */
     registerHooks({ postCommitHooks, postModelActionHooks, postResourceActionHooks, preCommitHooks, preModelActionHooks, preResourceActionHooks, }?: {
         postCommitHooks?: Parameters<CommitHook['collectHooks']>[0]['postHooks'];
         postModelActionHooks?: Parameters<ModelActionHook['collectHooks']>[0]['postHooks'];
@@ -34,7 +61,13 @@ export declare class ModuleContainer {
         preModelActionHooks?: Parameters<ModelActionHook['collectHooks']>[0]['preHooks'];
         preResourceActionHooks?: Parameters<ResourceActionHook['collectHooks']>[0]['preHooks'];
     }): void;
+    /**
+     * @internal
+     */
     reset(): void;
+    /**
+     * @internal
+     */
     unload(module: Constructable<UnknownModule>): void;
 }
 /**
@@ -42,6 +75,9 @@ export declare class ModuleContainer {
  */
 export declare class ModuleContainerFactory {
     private static instance;
+    /**
+     * @internal
+     */
     static create(forceNew?: boolean): Promise<ModuleContainer>;
 }
 export {};

package/dist/modules/module.container.js

@@ -20,12 +20,18 @@ import { InputService } from '../services/input/input.service.js';
  * @internal
  */
 export class ModuleContainer {
+    /**
+     * @internal
+     */
     constructor(eventService, inputService, overlayDataRepository) {
         this.eventService = eventService;
         this.inputService = inputService;
         this.overlayDataRepository = overlayDataRepository;
         this.modules = [];
     }
+    /**
+     * @internal
+     */
     async apply() {
         const result = {};
         for (const moduleMetadata of this.modules) {
@@ -95,14 +101,23 @@ export class ModuleContainer {
         }
         return result;
     }
+    /**
+     * @internal
+     */
     getMetadata(module) {
         const index = this.getMetadataIndex(module);
         return index === -1 ? undefined : this.modules[index];
     }
+    /**
+     * @internal
+     */
     getMetadataIndex(module) {
         const moduleName = typeof module === 'string' ? module : `${module.MODULE_PACKAGE}/${module.name}`;
         return this.modules.findIndex((m) => `${m.properties.packageName}/${m.module.name}` === moduleName);
     }
+    /**
+     * @internal
+     */
     getModuleInstanceInputKeys(moduleId) {
         const moduleIndex = this.modules.findIndex((m) => m.instances.findIndex((i) => i.moduleId === moduleId) !== -1);
         if (moduleIndex === -1) {
@@ -110,6 +125,9 @@ export class ModuleContainer {
         }
         return this.modules[moduleIndex].instances.find((i) => i.moduleId === moduleId).inputKeys;
     }
+    /**
+     * @internal
+     */
     load(module, moduleId, inputs) {
         const moduleName = typeof module === 'string' ? module : `${module.MODULE_PACKAGE}/${module.name}`;
         const m = this.getMetadata(module);
@@ -129,6 +147,9 @@ export class ModuleContainer {
             this.inputService.registerInput(moduleId, key, JSON.parse(JSON.stringify(value)));
         }
     }
+    /**
+     * @internal
+     */
     order(modules) {
         this.modules.sort((a, b) => {
             const aIndex = modules.findIndex((m) => {
@@ -142,12 +163,18 @@ export class ModuleContainer {
             return aIndex - bIndex;
         });
     }
+    /**
+     * @internal
+     */
     register(module, properties) {
         const moduleName = `${module.MODULE_PACKAGE}/${module.name}`;
         if (!this.modules.some((m) => `${m.properties.packageName}/${m.module.name}` === moduleName)) {
             this.modules.push({ hidden: true, instances: [], module, properties });
         }
     }
+    /**
+     * @internal
+     */
     registerHooks({ postCommitHooks, postModelActionHooks, postResourceActionHooks, preCommitHooks, preModelActionHooks, preResourceActionHooks, } = {}) {
         CommitHook.getInstance().collectHooks({ postHooks: postCommitHooks, preHooks: preCommitHooks });
         ModelActionHook.getInstance().collectHooks({
@@ -159,12 +186,18 @@ export class ModuleContainer {
             preHooks: preResourceActionHooks,
         });
     }
+    /**
+     * @internal
+     */
     reset() {
         for (const m of this.modules) {
             m.hidden = true;
             m.instances = [];
         }
     }
+    /**
+     * @internal
+     */
     unload(module) {
         const m = this.getMetadata(module);
         if (m) {
@@ -176,6 +209,9 @@ export class ModuleContainer {
  * @internal
  */
 let ModuleContainerFactory = class ModuleContainerFactory {
+    /**
+     * @internal
+     */
     static async create(forceNew = false) {
         const [eventService, inputService, overlayDataRepository] = await Promise.all([
             Container.getInstance().get(EventService),

package/dist/modules/module.container.js.map

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

package/dist/modules/test-module.container.d.ts

@@ -1,7 +1,8 @@
-import type { Constructable, ModuleOutput, ModuleSchemaInputs, UnknownAnchor, UnknownModel, UnknownModule } from '../app.type.js';
+import type { Constructable, ModuleSchemaInputs, UnknownAnchor, UnknownModel, UnknownModule } from '../app.type.js';
+import { type Container } from '../functions/container/container.js';
 import type { DiffMetadata } from '../functions/diff/diff-metadata.js';
 import { Octo } from '../main.js';
-import type { App } from '../models/app/app.model.js';
+import type { ValidateReport } from '../modes/validate.mode.js';
 import type { BaseAnchorSchema } from '../overlays/anchor.schema.js';
 import type { BaseResourceSchema } from '../resources/resource.schema.js';
 import type { IStateProvider } from '../services/state-management/state-provider.interface.js';
@@ -9,6 +10,11 @@ import { create } from '../utilities/test-helpers/test-models.js';
 import { createTestOverlays } from '../utilities/test-helpers/test-overlays.js';
 import { createResources, createTestResources } from '../utilities/test-helpers/test-resources.js';
 /**
+ * One module to load into a {@link TestModuleContainer} run.
+ *
+ * Set `hidden` to register the module without running it - use it for a module a test needs
+ * present but not applied, e.g. one that is only there to be found by a schema lookup.
+ *
  * @group Modules
  */
 export type TestModule<M extends UnknownModule> = {
@@ -18,39 +24,147 @@ export type TestModule<M extends UnknownModule> = {
     type: Constructable<M>;
 };
 /**
+ * The harness for testing a module.
+ *
+ * It runs your module through the real Octo lifecycle against an in-memory state provider, and hands
+ * back everything a test needs to assert on: the model and resource transactions, the generated HCL,
+ * and the resource responses. Create it inside a {@link TestContainer} so each test file is isolated.
+ *
+ * @example
+ * ```ts
+ * const container = await TestContainer.create({ mocks: [] }, { factoryTimeoutInMs: 500 });
+ * const testModuleContainer = new TestModuleContainer(container);
+ * await testModuleContainer.initialize();
+ *
+ * const generator = testModuleContainer.runModules([
+ *   { inputs: { name: 'test-app' }, moduleId: 'app', type: SimpleAppModule },
+ * ]);
+ * const { modelTransaction } = (await generator.next()).value;
+ * ```
+ *
  * @group Modules
  */
 export declare class TestModuleContainer {
-    readonly octo: Octo;
+    private readonly container;
+    private readonly octo;
+    private previousHcl;
     private stateProvider;
-    constructor();
-    commit(app: App, { appLockId, enableResourceCapture, filterByModuleIds, skipResourceTransaction, }?: {
-        appLockId?: string;
-        enableResourceCapture?: boolean;
-        filterByModuleIds?: string[];
-        skipResourceTransaction?: boolean;
-    }): Promise<{
-        modelDiffs: DiffMetadata[][];
-        modelTransaction: DiffMetadata[][];
-        resourceDiffs: DiffMetadata[][];
-        resourceTransaction: DiffMetadata[][];
-    }>;
+    /**
+     * @param container The {@link TestContainer} this run resolves its services from.
+     */
+    constructor(container: Container);
+    /**
+     * To seed resources that already exist, as though the given module had produced them.
+     * Use it to stand up the prerequisites a module under test expects to find.
+     */
+    createResources(moduleId: string, args: Parameters<typeof createResources>[0], options?: Parameters<typeof createResources>[1]): Promise<ReturnType<typeof createResources>>;
+    /**
+     * To build a throwaway anchor for a test double, without declaring an anchor class.
+     */
     createTestAnchor<S extends BaseAnchorSchema & {
         parentInstance: UnknownModel;
     }>(anchorId: string, properties: S['properties'], parent: S['parentInstance']): UnknownAnchor;
+    /**
+     * To seed models, as though the given module had produced them.
+     * Each model gets a no-op action, so the models appear in a transaction without doing any work.
+     */
     createTestModels(moduleId: string, args: Parameters<typeof create>[0]): Promise<ReturnType<typeof create>>;
+    /**
+     * To seed overlays, as though the given module had produced them.
+     * An overlay given no actions gets a no-op one.
+     */
     createTestOverlays(moduleId: string, args: Parameters<typeof createTestOverlays>[0]): Promise<ReturnType<typeof createTestOverlays>>;
-    createResources(moduleId: string, args: Parameters<typeof createResources>[0], options?: Parameters<typeof createResources>[1]): Promise<ReturnType<typeof createResources>>;
+    /**
+     * To seed resources, as though the given module had produced them.
+     * A resource given no actions gets a no-op one, unless terraform owns it.
+     */
     createTestResources<S extends BaseResourceSchema[]>(moduleId: string, args: Parameters<typeof createTestResources<S>>[0], options?: Parameters<typeof createTestResources>[1]): Promise<ReturnType<typeof createTestResources<S>>>;
-    mapTransactionActions(transaction: DiffMetadata[][]): string[][];
+    /**
+     * Reduces a transaction's diffs, model or resource, to a stable digest you can snapshot:
+     * `+ <context>` (create), `- <context>` (delete), `^ <context>` (replace), `* <context>` (update).
+     *
+     * A diff is classified exactly as {@link Octo.validate} aggregates it, so a digest and a validate
+     * report of the same transaction never disagree. Only an add/delete of a `resourceId` creates or
+     * destroys a resource; an add/delete on any other field changes a resource that stays -
+     * re-pointing a `parent`, most commonly - and reads as an update.
+     *
+     * The digest has one entry per diff, not per resource, so a resource may appear more than once.
+     */
+    digestDiffs(diffs: DiffMetadata[][]): string[];
+    /**
+     * Boots Octo for the test. Call it once, before running any module.
+     *
+     * @param stateProvider Defaults to an in-memory {@link TestStateProvider}. Only the local and test
+     * providers are accepted - a test must never write to shared state.
+     * @param initializeInContainer Factories to resolve at boot. See {@link Octo.initialize}.
+     * @param excludeInContainer Factories to unregister at boot. See {@link Octo.initialize}.
+     */
     initialize(stateProvider?: IStateProvider, initializeInContainer?: Parameters<typeof Octo.prototype.initialize>[1], excludeInContainer?: Parameters<typeof Octo.prototype.initialize>[2]): Promise<void>;
-    orderModules(modules: (Constructable<UnknownModule> | string)[]): Promise<void>;
-    registerCapture<S extends BaseResourceSchema>(resourceContext: string, response: Partial<S['response']>): void;
-    runModule<M extends UnknownModule>(module: TestModule<M>): Promise<{
-        [key: string]: ModuleOutput<M>;
-    }>;
-    runModules<M extends UnknownModule>(modules: TestModule<M>[]): Promise<{
-        [key: string]: ModuleOutput<M>;
-    }>;
+    /**
+     * Whether the committed resource state matches the previous one, i.e. whether the last run
+     * settled without leaving a pending change.
+     */
+    isResourceStateEqual(): Promise<boolean>;
+    /**
+     * Reduces a transaction to the names of the actions it ran, in order. Snapshot it to assert that
+     * a change triggered the actions you expected.
+     */
+    mapTransactionActions(transaction: DiffMetadata[][]): string[][];
+    /**
+     * See {@link Octo.registerHooks}.
+     */
+    registerHooks(...args: Parameters<Octo['registerHooks']>): ReturnType<Octo['registerHooks']>;
+    /**
+     * See {@link Octo.registerTags}.
+     */
+    registerTags(...args: Parameters<Octo['registerTags']>): ReturnType<Octo['registerTags']>;
+    /**
+     * See {@link Octo.registerTerraformConfig}. Required before a run that generates terraform.
+     */
+    registerTerraformConfig(...args: Parameters<Octo['registerTerraformConfig']>): ReturnType<Octo['registerTerraformConfig']>;
+    /**
+     * See {@link Octo.registerTerraformProvider}. Required before a run that generates terraform.
+     */
+    registerTerraformProvider(...args: Parameters<Octo['registerTerraformProvider']>): ReturnType<Octo['registerTerraformProvider']>;
+    /**
+     * Tears down the composed graph - models, overlays, inputs, and modules - so the next
+     * {@link TestModuleContainer.runModules} composes fresh. Call it in your test teardown.
+     */
     reset(): Promise<void>;
+    /**
+     * Runs the given modules through Octo's lifecycle, and yields the result once.
+     *
+     * How far the lifecycle goes is set by `terraformTarget`, and this is the choice that decides what
+     * the test costs:
+     * - `'skip'` - composes and commits in memory. No terraform, no cloud. This is a unit test.
+     * - `'plan'` - generates the module folders and runs `terraform plan` against them.
+     * - `'apply'` - generates, plans, applies, and commits. **This creates real infrastructure.**
+     *
+     * @param modules The modules to load, in order.
+     * @param options `filterByModuleIds` narrows the run to those modules; `outputDir` is where the
+     * terraform folders are written, defaulting to a temporary directory.
+     */
+    runModules<M extends UnknownModule>(modules: TestModule<M> | TestModule<M>[], { filterByModuleIds, outputDir, terraformTarget, }?: {
+        filterByModuleIds?: string[];
+        outputDir?: string;
+        terraformTarget?: 'apply' | 'plan' | 'skip';
+    }): AsyncGenerator<{
+        hclDiff: string;
+        hclRender: string;
+        modelTransaction: DiffMetadata[][];
+        resourceDiffs: DiffMetadata[][];
+        resourceTransaction: DiffMetadata[][];
+        responses: {
+            [resourceContext: string]: unknown;
+        };
+        validateReport: ValidateReport | undefined;
+        warnings: {
+            message: string;
+            moduleId?: string;
+        }[];
+    }>;
+    /**
+     * Persists the run's state, so a later run in the same test diffs against it.
+     */
+    private commit;
 }