@quadnix/octo 0.0.30 → 0.2.0

package/dist/overlays/overlay.schema.d.ts

@@ -1,10 +1,30 @@
 import type { BaseAnchorSchema } from './anchor.schema.js';
 /**
+ * The schema every overlay schema extends.
+ *
+ * An overlay schema narrows `properties` to the fields the overlay carries.
+ *
+ * @example
+ * ```ts
+ * export class MyOverlaySchema extends BaseOverlaySchema {
+ *   override properties = Schema<{ subnetName: string }>();
+ * }
+ * ```
+ *
  * @group Overlays
  */
 export declare class BaseOverlaySchema {
+    /**
+     * The anchors this overlay was built from, i.e. the models it joins.
+     */
     anchors: BaseAnchorSchema[];
+    /**
+     * The ID of the overlay, unique across the infrastructure.
+     */
     overlayId: string;
+    /**
+     * The properties of the overlay.
+     */
     properties: {
         [key: string]: unknown;
     };

package/dist/overlays/overlay.schema.js

@@ -1,11 +1,31 @@
 import { Schema } from '../functions/schema/schema.js';
 /**
+ * The schema every overlay schema extends.
+ *
+ * An overlay schema narrows `properties` to the fields the overlay carries.
+ *
+ * @example
+ * ```ts
+ * export class MyOverlaySchema extends BaseOverlaySchema {
+ *   override properties = Schema<{ subnetName: string }>();
+ * }
+ * ```
+ *
  * @group Overlays
  */
 export class BaseOverlaySchema {
     constructor() {
+        /**
+         * The anchors this overlay was built from, i.e. the models it joins.
+         */
         this.anchors = Schema();
+        /**
+         * The ID of the overlay, unique across the infrastructure.
+         */
         this.overlayId = Schema();
+        /**
+         * The properties of the overlay.
+         */
         this.properties = Schema();
     }
 }

package/dist/overlays/overlay.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"overlay.schema.js","sourceRoot":"","sources":["../../src/overlays/overlay.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAGvD;;GAEG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACE,YAAO,GAAG,MAAM,EAAsB,CAAC;QAEvC,cAAS,GAAG,MAAM,EAAU,CAAC;QAE7B,eAAU,GAAG,MAAM,EAA8B,CAAC;IACpD,CAAC;CAAA"}
+{"version":3,"file":"overlay.schema.js","sourceRoot":"","sources":["../../src/overlays/overlay.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAGvD;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,iBAAiB;IAA9B;QACE;;WAEG;QACH,YAAO,GAAG,MAAM,EAAsB,CAAC;QAEvC;;WAEG;QACH,cAAS,GAAG,MAAM,EAAU,CAAC;QAE7B;;WAEG;QACH,eAAU,GAAG,MAAM,EAA8B,CAAC;IACpD,CAAC;CAAA"}

package/dist/resources/resource-action.interface.d.ts

@@ -1,11 +1,37 @@
-import type { ResourceSchema, UnknownResource } from '../app.type.js';
+import type { UnknownResource } from '../app.type.js';
 import type { Diff } from '../functions/diff/diff.js';
+import type { ANodeAction } from '../functions/node/node-action.abstract.js';
 /**
+ * A resource action creates, updates, or destroys one piece of real infrastructure.
+ *
+ * Actions belong to *external* resources - the ones Octo drives itself through a cloud provider's
+ * SDK. A resource whose lifecycle terraform manages ({@link ATerraformResource}) must not have one;
+ * registering an action for it throws.
+ *
+ * The class extends {@link ANodeAction}, which gives it the container and `log()`. Register it with
+ * {@link Action}, and a {@link Factory} to construct it.
+ *
  * @group Resources
+ *
+ * @see Definition of [Actions](/docs/fundamentals/actions).
  */
-export interface IResourceAction<T extends UnknownResource> {
+export interface IResourceAction<T extends UnknownResource> extends ANodeAction {
+    /**
+     * How long the action may run before Octo aborts it.
+     *
+     * @defaultValue `90000`
+     */
     actionTimeoutInMs?: number;
+    /**
+     * Whether this action handles the given diff.
+     * Typically a check on the diff's resource, field, and action.
+     */
     filter(diff: Diff): boolean;
+    /**
+     * Performs the change against the cloud provider.
+     *
+     * @returns What the provider reported back, which Octo records as the resource's `response`.
+     * Return nothing when the action has no output, e.g. a delete.
+     */
     handle(diff: Diff): Promise<T['response']> | Promise<void>;
-    mock?(diff: Diff, capture: Partial<ResourceSchema<T>['response']>): Promise<T['response']> | Promise<void>;
 }

package/dist/resources/resource-data.repository.d.ts

@@ -8,29 +8,91 @@ export declare class ResourceDataRepository {
     private oldResources;
     private newResources;
     private dirtyResources;
+    /**
+     * @internal
+     */
     constructor(actualResources: UnknownResource[], oldResources: UnknownResource[], newResources: UnknownResource[]);
+    /**
+     * @internal
+     */
     addActualResource(resource: UnknownResource): void;
+    /**
+     * @internal
+     */
     addNewResource(resource: UnknownResource): void;
+    /**
+     * @internal
+     */
     diff(): Promise<Diff[]>;
+    /**
+     * @internal
+     */
     diffDirty(): Promise<Diff[]>;
+    /**
+     * @internal
+     */
     diffValidate(): Diff[];
+    /**
+     * @internal
+     */
     ensureDiffsNotOperatingOnDirtyResources(diffs: Diff[]): void;
+    /**
+     * @internal
+     */
     getActualResourceByContext(context: string): UnknownResource | undefined;
-    getNewResourceByContext(context: string): UnknownResource | undefined;
+    /**
+     * @internal
+     */
     getActualResourcesByProperties(filters?: {
         key: string;
         value: any;
     }[]): UnknownResource[];
+    /**
+     * @internal
+     */
+    getNewResourceByContext(context: string): UnknownResource | undefined;
+    /**
+     * @internal
+     */
     getNewResourcesByProperties(filters?: {
         key: string;
         value: any;
     }[]): UnknownResource[];
+    /**
+     * @internal
+     */
     removeNewResource(resource: UnknownResource): void;
+    /**
+     * Marks the new (desired) resource graph as applied: the actual graph becomes the new graph and
+     * nothing is dirty. Used by terraform commit, where terraform has already applied the desired
+     * state.
+     *
+     * `excludeResourceContexts` names resources a partial commit could not confirm. They are left out
+     * of the actual graph, so the next run plans to create them again - which terraform reconciles
+     * against its own state as a no-op if they do exist. Recording less than reality is recoverable;
+     * recording more is not.
+     *
+     * `retainResourceContexts` names resources whose deletion did not run. Each is carried over from
+     * the graph being replaced, along with the parents it needs to deserialize with, and joins both
+     * graphs: the actual graph records it as still present, and the new graph is what the next run
+     * diffs against, which is what plans its deletion again.
+     */
+    syncActualToNew(excludeResourceContexts?: Set<string>, retainResourceContexts?: Set<string>): void;
+    /**
+     * Collects the named resources out of the actual graph, closed over their parents.
+     *
+     * A resource deserializes by de-referencing every parent it names, so a resource is only worth
+     * keeping when the graph keeps the parents above it too.
+     */
+    private collectWithParents;
 }
 /**
  * @internal
  */
 export declare class ResourceDataRepositoryFactory {
     private static instance;
+    /**
+     * @internal
+     */
     static create(forceNew?: boolean, actualResources?: UnknownResource[], oldResources?: UnknownResource[], newResources?: UnknownResource[]): Promise<ResourceDataRepository>;
 }

package/dist/resources/resource-data.repository.js

@@ -4,7 +4,7 @@ var __decorate = (this && this.__decorate) || function (decorators, target, key,
     else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
     return c > 3 && r && Object.defineProperty(target, key, r), r;
 };
-import { NodeType } from '../app.type.js';
+import { MatchingResource, NodeType } from '../app.type.js';
 import { Factory } from '../decorators/factory.decorator.js';
 import { DiffsOnDirtyResourcesTransactionError, ResourceError } from '../errors/index.js';
 import { Diff, DiffAction } from '../functions/diff/diff.js';
@@ -12,6 +12,9 @@ import { Diff, DiffAction } from '../functions/diff/diff.js';
  * @internal
  */
 export class ResourceDataRepository {
+    /**
+     * @internal
+     */
     constructor(actualResources, oldResources, newResources) {
         this.actualResources = actualResources;
         this.oldResources = oldResources;
@@ -29,6 +32,9 @@ export class ResourceDataRepository {
             }
         }
     }
+    /**
+     * @internal
+     */
     addActualResource(resource) {
         if (resource.constructor.NODE_TYPE !== NodeType.RESOURCE) {
             throw new ResourceError('Adding non-resource node!', resource);
@@ -42,6 +48,9 @@ export class ResourceDataRepository {
             throw new ResourceError('Resource in actual already exists!', resource);
         }
     }
+    /**
+     * @internal
+     */
     addNewResource(resource) {
         if (resource.constructor.NODE_TYPE !== NodeType.RESOURCE) {
             throw new ResourceError('Adding non-resource node!', resource);
@@ -60,6 +69,9 @@ export class ResourceDataRepository {
             resource.cloneResponseInPlace(this.oldResources[oIndex]);
         }
     }
+    /**
+     * @internal
+     */
     async diff() {
         const oldResources = this.oldResources.reduce((accumulator, current) => ({ ...accumulator, [current.getContext()]: current }), {});
         const newResources = this.newResources.reduce((accumulator, current) => ({ ...accumulator, [current.getContext()]: current }), {});
@@ -94,6 +106,9 @@ export class ResourceDataRepository {
         }
         return diffs;
     }
+    /**
+     * @internal
+     */
     async diffDirty() {
         const actualResources = this.actualResources.reduce((accumulator, current) => ({ ...accumulator, [current.getContext()]: current }), {});
         const newResources = this.newResources.reduce((accumulator, current) => ({ ...accumulator, [current.getContext()]: current }), {});
@@ -128,6 +143,9 @@ export class ResourceDataRepository {
         }
         return diffs;
     }
+    /**
+     * @internal
+     */
     diffValidate() {
         const diffs = [];
         for (const resource of this.actualResources) {
@@ -135,23 +153,41 @@ export class ResourceDataRepository {
         }
         return diffs;
     }
+    /**
+     * @internal
+     */
     ensureDiffsNotOperatingOnDirtyResources(diffs) {
         if (diffs.some((d) => this.dirtyResources.some((dr) => d.node.hasAncestor(dr)))) {
             throw new DiffsOnDirtyResourcesTransactionError('Cannot operate diff on dirty resources!', diffs, this.dirtyResources);
         }
     }
+    /**
+     * @internal
+     */
     getActualResourceByContext(context) {
         return this.actualResources.find((r) => r.getContext() === context);
     }
-    getNewResourceByContext(context) {
-        return this.newResources.find((r) => r.getContext() === context);
-    }
+    /**
+     * @internal
+     */
     getActualResourcesByProperties(filters = []) {
         return this.actualResources.filter((r) => filters.every((c) => r.properties[c.key] === c.value));
     }
+    /**
+     * @internal
+     */
+    getNewResourceByContext(context) {
+        return this.newResources.find((r) => r.getContext() === context);
+    }
+    /**
+     * @internal
+     */
     getNewResourcesByProperties(filters = []) {
         return this.newResources.filter((r) => filters.every((c) => r.properties[c.key] === c.value));
     }
+    /**
+     * @internal
+     */
     removeNewResource(resource) {
         if (resource.constructor.NODE_TYPE !== NodeType.RESOURCE) {
             throw new ResourceError('Removing non-resource node!', resource);
@@ -164,11 +200,65 @@ export class ResourceDataRepository {
             this.newResources.splice(rIndex, 1);
         }
     }
+    /**
+     * Marks the new (desired) resource graph as applied: the actual graph becomes the new graph and
+     * nothing is dirty. Used by terraform commit, where terraform has already applied the desired
+     * state.
+     *
+     * `excludeResourceContexts` names resources a partial commit could not confirm. They are left out
+     * of the actual graph, so the next run plans to create them again - which terraform reconciles
+     * against its own state as a no-op if they do exist. Recording less than reality is recoverable;
+     * recording more is not.
+     *
+     * `retainResourceContexts` names resources whose deletion did not run. Each is carried over from
+     * the graph being replaced, along with the parents it needs to deserialize with, and joins both
+     * graphs: the actual graph records it as still present, and the new graph is what the next run
+     * diffs against, which is what plans its deletion again.
+     */
+    syncActualToNew(excludeResourceContexts = new Set(), retainResourceContexts = new Set()) {
+        for (const resource of this.collectWithParents(retainResourceContexts)) {
+            const rIndex = this.newResources.findIndex((r) => r.getContext() === resource.getContext());
+            if (rIndex === -1) {
+                this.newResources.push(resource);
+            }
+            else if (this.newResources[rIndex].isMarkedDeleted()) {
+                this.newResources[rIndex] = resource;
+            }
+        }
+        this.actualResources = this.newResources.filter((r) => !excludeResourceContexts.has(r.getContext()));
+        this.dirtyResources = [];
+    }
+    /**
+     * Collects the named resources out of the actual graph, closed over their parents.
+     *
+     * A resource deserializes by de-referencing every parent it names, so a resource is only worth
+     * keeping when the graph keeps the parents above it too.
+     */
+    collectWithParents(resourceContexts) {
+        const collected = new Map();
+        const contextsToProcess = [...resourceContexts];
+        while (contextsToProcess.length > 0) {
+            const context = contextsToProcess.shift();
+            if (collected.has(context)) {
+                continue;
+            }
+            const resource = this.actualResources.find((r) => r.getContext() === context);
+            if (!resource) {
+                continue;
+            }
+            collected.set(context, resource);
+            contextsToProcess.push(...resource.parents.map((p) => (p instanceof MatchingResource ? p.getActual() : p).getContext()));
+        }
+        return [...collected.values()];
+    }
 }
 /**
  * @internal
  */
 let ResourceDataRepositoryFactory = class ResourceDataRepositoryFactory {
+    /**
+     * @internal
+     */
     static async create(forceNew = false, actualResources = [], oldResources = [], newResources = []) {
         if (!this.instance) {
             this.instance = new ResourceDataRepository(actualResources, oldResources, newResources);

package/dist/resources/resource-data.repository.js.map

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

package/dist/resources/resource.abstract.d.ts

@@ -5,16 +5,104 @@ import { ANode } from '../functions/node/node.abstract.js';
 import type { IResource } from './resource.interface.js';
 import type { BaseResourceSchema } from './resource.schema.js';
 /**
+ * The base class of every resource - the nodes that describe actual cloud infrastructure.
+ *
+ * Where a model says *what you want*, a resource says *what exists*. Resources are never constructed
+ * by you directly; a model action declares them, and Octo diffs the declared graph against the last
+ * committed one to decide what to create, update, or destroy.
+ *
+ * A resource is identified by its `resourceId`, configured by its `properties`, and reports back
+ * through its `response` once the infrastructure exists. The ID it is created with is its
+ * `localResourceId`, which only has to be unique within its `scope`: where the node creating the
+ * resource sits in the model graph. Octo makes the `resourceId` from the two.
+ *
+ * Most resources extend {@link ATerraformResource} rather than this class.
+ *
  * @group Resources
+ *
+ * @see Definition of [Resources](/docs/fundamentals/resources).
  */
 export declare abstract class AResource<S extends BaseResourceSchema, T extends UnknownResource> extends ANode<S, T> implements IResource<S, T> {
-    readonly resourceId: S['resourceId'];
+    readonly localResourceId: S['localResourceId'];
     readonly properties: S['properties'];
-    private _deleteMarker;
+    /**
+     * Whether destroying a resource of this class loses data octo cannot put back. Set by {@link Resource}.
+     *
+     * @internal
+     */
+    static readonly DESTROY_LOSES_DATA: boolean;
+    /**
+     * The names this class declares unique, each by the properties whose values form its domain. Set by
+     * {@link Resource}.
+     *
+     * @internal
+     */
+    static readonly UNIQUE_PROPERTIES: {
+        path: string;
+        within: string[];
+    }[];
+    /**
+     * The scope every resource constructed now is created in. The transaction sets it around each model
+     * action.
+     */
+    private static constructionScope;
+    /**
+     * The resources this one is built on top of. A parent is always created before its children,
+     * and destroyed after them.
+     */
     readonly parents: (MatchingResource<BaseResourceSchema> | UnknownResource)[];
+    /**
+     * What the cloud provider reported back about this resource, e.g. an ARN or a generated ID.
+     * It is empty until the resource has actually been created, and is what other resources read
+     * when they need to reference this one.
+     */
     readonly response: S['response'];
+    /**
+     * The contexts of the models this resource is placed under, sorted. Octo derives it from the node
+     * whose action created the resource; a resource created outside a model action has an empty scope.
+     */
+    readonly scope: string[];
+    /**
+     * The tags applied to this resource. See {@link Octo.registerTags} to set them in bulk.
+     */
     readonly tags: S['tags'];
-    protected constructor(resourceId: S['resourceId'], properties: S['properties'], parents?: (MatchingResource<BaseResourceSchema> | UnknownResource)[]);
+    /**
+     * The ID of the resource, unique across the infrastructure: its `localResourceId`, followed by a
+     * hash of its scope when it has one.
+     */
+    get resourceId(): S['resourceId'];
+    private _deleteMarker;
+    /**
+     * @param localResourceId The ID of the resource, unique within its scope.
+     * @param properties The desired configuration of the resource.
+     * @param parents The resources this one is built on top of.
+     * @throws {@link ResourceError} If the resource ID is not alphanumeric with `-`, `_`, or `/`.
+     */
+    protected constructor(localResourceId: S['localResourceId'], properties: S['properties'], parents?: (MatchingResource<BaseResourceSchema> | UnknownResource)[]);
+    /**
+     * @internal
+     */
+    static cloneResource<T extends UnknownResource>(sourceResource: T, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<T>;
+    /**
+     * Constructs resources in the given scope.
+     *
+     * @internal
+     */
+    static constructInScope<R>(scope: string[], construct: () => R): R;
+    /**
+     * Runs a model action, so every resource it constructs is created in the given scope.
+     * Model actions run one at a time, which is what makes the scope safe to hold statically.
+     *
+     * @internal
+     */
+    static runInScope<R>(scope: string[], run: () => Promise<R>): Promise<R>;
+    /**
+     * @internal
+     */
+    static unSynth<S extends BaseResourceSchema, T>(deserializationClass: any, resource: S, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<T>;
+    /**
+     * @internal
+     */
     addChild(onField: keyof T | string, child: UnknownResource, toField: string): {
         childToParentDependency: Dependency;
         parentToChildDependency: Dependency;
@@ -30,20 +118,59 @@ export declare abstract class AResource<S extends BaseResourceSchema, T extends
         thatToThisDependency: Dependency;
         thisToThatDependency: Dependency;
     };
+    /**
+     * @internal
+     */
     clonePropertiesInPlace(sourceResource: T): void;
-    static cloneResource<T extends UnknownResource>(sourceResource: T, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<T>;
+    /**
+     * @internal
+     */
     cloneResourceInPlace(sourceResource: T, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<void>;
+    /**
+     * @internal
+     */
     cloneResponseInPlace(sourceResource: UnknownResource): void;
+    /**
+     * @internal
+     */
     cloneTagsInPlace(sourceResource: UnknownResource): void;
+    /**
+     * @internal
+     */
     diff(previous: T): Promise<Diff[]>;
+    /**
+     * @internal
+     */
     diffInverse(diff: Diff, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<void>;
+    /**
+     * @internal
+     */
     diffProperties(previous: T): Promise<Diff[]>;
+    /**
+     * @internal
+     */
     diffTags(previous: T): Promise<Diff<UnknownResource, DiffValueTypeTagUpdate>[]>;
+    /**
+     * Splits one diff into the diffs a resource action will actually receive.
+     *
+     * Override it when a single change on this resource has to be applied as several ordered steps.
+     * The default returns the diff unchanged.
+     */
     diffUnpack(diff: Diff): Diff[];
+    /**
+     * To find this resource's parents whose properties match every given filter.
+     *
+     * @param filters Each filter is a property `key` the parent must carry with the given `value`.
+     */
     findParentsByProperty(filters: {
         key: string;
         value: unknown;
     }[]): UnknownResource[];
+    /**
+     * To find this resource's parents whose tags match every given filter.
+     *
+     * @param filters Each filter is a tag `key` the parent must carry with the given `value`.
+     */
     findParentsByTag(filters: {
         key: string;
         value: string;
@@ -52,18 +179,48 @@ export declare abstract class AResource<S extends BaseResourceSchema, T extends
      * @deprecated Boundary is not supported in resources!
      */
     getBoundaryMembers(): UnknownResource[];
+    /**
+     * The properties whose change means an external resource has to be run again. Terraform hashes
+     * them into the trigger of the `null_resource` that stands in for the resource, which is how it
+     * decides to call back.
+     *
+     * A resource that overrides {@link diffProperties} to ignore a property must exclude that property
+     * here too. The two answer the same question, and terraform plans a replacement for any property
+     * only this one covers, which octo then reports no change for.
+     */
+    getExternalTriggerProperties(): Partial<S['properties']>;
     /**
      * @deprecated Siblings are not supported in resources!
      */
     getSiblings(): {
         [p: string]: Dependency[];
     };
+    /**
+     * @internal
+     */
     isDeepEquals(other?: UnknownResource): boolean;
+    /**
+     * Whether this resource is marked for deletion, and will leave the graph at the end of the transaction.
+     */
     isMarkedDeleted(): boolean;
-    merge(previous: AResource<S, T>): AResource<S, T>;
+    /**
+     * To mark this resource for deletion. It leaves the graph at the end of the transaction.
+     *
+     * @param force Removes the resource even if other resources still depend on it.
+     * @throws {@link RemoveResourceError} If the resource still has children, and `force` is not set.
+     */
     remove(force?: boolean): void;
+    /**
+     * @internal
+     */
     setContext(): string;
+    /**
+     * To record what the cloud provider reported back about this resource.
+     * Keys absent from `response` are left as they were.
+     */
     setResponse(response: S['response']): void;
+    /**
+     * @internal
+     */
     synth(): S;
-    static unSynth<S extends BaseResourceSchema, T>(deserializationClass: any, resource: S, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<T>;
 }