@quadnix/octo 0.0.30 → 0.2.0

package/dist/models/execution/execution.model.d.ts

@@ -11,7 +11,7 @@ import { ExecutionSchema } from './execution.schema.js';
  * @example
  * ```ts
  * const deployment = new Deployment('v1');
- * const environment = new Environment('qa');
+ * const environment = new Environment('staging');
  * const subnet = new Subnet(region, 'private');
  * const execution = new Execution(deployment, environment, subnet);
  * ```
@@ -22,13 +22,31 @@ import { ExecutionSchema } from './execution.schema.js';
  */
 export declare class Execution extends AModel<ExecutionSchema, Execution> {
     readonly environmentVariables: Map<string, string>;
-    constructor(deployment: Deployment, environment: Environment, subnet: Subnet);
     /**
      * An `executionId` is a unique identifier for this execution.
      * - Format of executionId is `{serverKey}-{deploymentTag}-{regionId}-{environmentName}-{subnetName}`
      */
     get executionId(): string;
+    /**
+     * All three parents claim the new execution as their child, so the graph is complete on construction.
+     *
+     * @param deployment The deployment whose code this execution runs.
+     * @param environment The environment this execution runs in.
+     * @param subnet The subnet this execution is placed in.
+     * @throws {@link ModelError} If the environment and subnet are in different regions, or an
+     * identical execution already exists.
+     */
+    constructor(deployment: Deployment, environment: Environment, subnet: Subnet);
+    /**
+     * @internal
+     */
+    static unSynth(execution: ExecutionSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Execution>;
+    /**
+     * @internal
+     */
     setContext(): string | undefined;
+    /**
+     * @internal
+     */
     synth(): ExecutionSchema;
-    static unSynth(execution: ExecutionSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Execution>;
 }

package/dist/models/execution/execution.model.js

@@ -25,7 +25,7 @@ import { ExecutionSchema } from './execution.schema.js';
  * @example
  * ```ts
  * const deployment = new Deployment('v1');
- * const environment = new Environment('qa');
+ * const environment = new Environment('staging');
  * const subnet = new Subnet(region, 'private');
  * const execution = new Execution(deployment, environment, subnet);
  * ```
@@ -35,6 +35,34 @@ import { ExecutionSchema } from './execution.schema.js';
  * @see Definition of [Default Models](/docs/fundamentals/models#default-models).
  */
 let Execution = Execution_1 = class Execution extends AModel {
+    /**
+     * An `executionId` is a unique identifier for this execution.
+     * - Format of executionId is `{serverKey}-{deploymentTag}-{regionId}-{environmentName}-{subnetName}`
+     */
+    get executionId() {
+        const parents = this.getParents();
+        const deployment = parents['deployment'][0].to;
+        const server = deployment.getParents()['server'][0].to;
+        const environment = parents['environment'][0].to;
+        const region = environment.getParents()['region'][0].to;
+        const subnet = parents['subnet'][0].to;
+        return [
+            server.serverKey,
+            deployment.deploymentTag,
+            region.regionId,
+            environment.environmentName,
+            subnet.subnetName,
+        ].join('-');
+    }
+    /**
+     * All three parents claim the new execution as their child, so the graph is complete on construction.
+     *
+     * @param deployment The deployment whose code this execution runs.
+     * @param environment The environment this execution runs in.
+     * @param subnet The subnet this execution is placed in.
+     * @throws {@link ModelError} If the environment and subnet are in different regions, or an
+     * identical execution already exists.
+     */
     constructor(deployment, environment, subnet) {
         super();
         this.environmentVariables = new Map();
@@ -62,24 +90,23 @@ let Execution = Execution_1 = class Execution extends AModel {
         subnet.addChild('subnetId', this, 'executionId');
     }
     /**
-     * An `executionId` is a unique identifier for this execution.
-     * - Format of executionId is `{serverKey}-{deploymentTag}-{regionId}-{environmentName}-{subnetName}`
+     * @internal
      */
-    get executionId() {
-        const parents = this.getParents();
-        const deployment = parents['deployment'][0].to;
-        const server = deployment.getParents()['server'][0].to;
-        const environment = parents['environment'][0].to;
-        const region = environment.getParents()['region'][0].to;
-        const subnet = parents['subnet'][0].to;
-        return [
-            server.serverKey,
-            deployment.deploymentTag,
-            region.regionId,
-            environment.environmentName,
-            subnet.subnetName,
-        ].join('-');
+    static async unSynth(execution, deReferenceContext) {
+        const [deployment, environment, subnet] = (await Promise.all([
+            deReferenceContext(execution.deployment.context),
+            deReferenceContext(execution.environment.context),
+            deReferenceContext(execution.subnet.context),
+        ]));
+        const newExecution = new Execution_1(deployment, environment, subnet);
+        for (const [key, value] of Object.entries(execution.environmentVariables)) {
+            newExecution.environmentVariables.set(key, value);
+        }
+        return newExecution;
     }
+    /**
+     * @internal
+     */
     setContext() {
         const parents = this.getParents();
         const deployment = parents['deployment']?.[0]?.to;
@@ -95,6 +122,9 @@ let Execution = Execution_1 = class Execution extends AModel {
             subnet.getContext(),
         ].join(',');
     }
+    /**
+     * @internal
+     */
     synth() {
         const parents = this.getParents();
         const deployment = parents['deployment'][0]['to'];
@@ -107,18 +137,6 @@ let Execution = Execution_1 = class Execution extends AModel {
             subnet: { context: subnet.getContext() },
         };
     }
-    static async unSynth(execution, deReferenceContext) {
-        const [deployment, environment, subnet] = (await Promise.all([
-            deReferenceContext(execution.deployment.context),
-            deReferenceContext(execution.environment.context),
-            deReferenceContext(execution.subnet.context),
-        ]));
-        const newExecution = new Execution_1(deployment, environment, subnet);
-        for (const [key, value] of Object.entries(execution.environmentVariables)) {
-            newExecution.environmentVariables.set(key, value);
-        }
-        return newExecution;
-    }
 };
 Execution = Execution_1 = __decorate([
     Model('@octo', 'execution', ExecutionSchema),

package/dist/models/execution/execution.model.js.map

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

package/dist/models/execution/execution.schema.d.ts

@@ -1,9 +1,17 @@
 import type { IModelReference } from '../model.interface.js';
 /**
+ * Schema of the {@link Execution} model.
+ *
  * @group Models/Execution
  */
 export declare class ExecutionSchema {
+    /**
+     * The deployment whose code this execution runs.
+     */
     deployment: IModelReference;
+    /**
+     * The environment this execution runs in.
+     */
     environment: IModelReference;
     /**
      * A set of environment variables to be passed to the Docker container.
@@ -13,5 +21,8 @@ export declare class ExecutionSchema {
     environmentVariables: {
         [key: string]: string;
     };
+    /**
+     * The subnet this execution is placed in. It must belong to the same region as the environment.
+     */
     subnet: IModelReference;
 }

package/dist/models/execution/execution.schema.js

@@ -10,11 +10,19 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { Validate } from '../../decorators/validate.decorator.js';
 import { Schema } from '../../functions/schema/schema.js';
 /**
+ * Schema of the {@link Execution} model.
+ *
  * @group Models/Execution
  */
 export class ExecutionSchema {
     constructor() {
+        /**
+         * The deployment whose code this execution runs.
+         */
         this.deployment = Schema();
+        /**
+         * The environment this execution runs in.
+         */
         this.environment = Schema();
         /**
          * A set of environment variables to be passed to the Docker container.
@@ -22,6 +30,9 @@ export class ExecutionSchema {
          * option while running a Docker container.
          */
         this.environmentVariables = Schema();
+        /**
+         * The subnet this execution is placed in. It must belong to the same region as the environment.
+         */
         this.subnet = Schema();
     }
 }

package/dist/models/execution/execution.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"execution.schema.js","sourceRoot":"","sources":["../../../src/models/execution/execution.schema.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG1D;;GAEG;AACH,MAAM,OAAO,eAAe;IAA5B;QACE,eAAU,GAAG,MAAM,EAAmB,CAAC;QAEvC,gBAAW,GAAG,MAAM,EAAmB,CAAC;QAExC;;;;WAIG;QAOH,yBAAoB,GAAG,MAAM,EAA6B,CAAC;QAE3D,WAAM,GAAG,MAAM,EAAmB,CAAC;IACrC,CAAC;CAAA;AAHC;IANC,QAAQ,CAAC;QACR,QAAQ,EAAE,CAAC,KAAgC,EAAY,EAAE;YACvD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE;KAC/E,CAAC;;6DACyD"}
+{"version":3,"file":"execution.schema.js","sourceRoot":"","sources":["../../../src/models/execution/execution.schema.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG1D;;;;GAIG;AACH,MAAM,OAAO,eAAe;IAA5B;QACE;;WAEG;QACH,eAAU,GAAG,MAAM,EAAmB,CAAC;QAEvC;;WAEG;QACH,gBAAW,GAAG,MAAM,EAAmB,CAAC;QAExC;;;;WAIG;QAOH,yBAAoB,GAAG,MAAM,EAA6B,CAAC;QAE3D;;WAEG;QACH,WAAM,GAAG,MAAM,EAAmB,CAAC;IACrC,CAAC;CAAA;AANC;IANC,QAAQ,CAAC;QACR,QAAQ,EAAE,CAAC,KAAgC,EAAY,EAAE;YACvD,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QAC5B,CAAC;QACD,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE;KAC/E,CAAC;;6DACyD"}

package/dist/models/filesystem/filesystem.model.d.ts

@@ -2,12 +2,38 @@ import type { UnknownModel } from '../../app.type.js';
 import { AModel } from '../model.abstract.js';
 import { FilesystemSchema } from './filesystem.schema.js';
 /**
+ * A Filesystem model is a network filesystem shared by the executions of a region.
+ * It exists so that state which must outlive a container - uploads, caches, shared data - has somewhere to live.
+ *
+ * A filesystem belongs to one {@link Region}. Mounting it into a {@link Subnet} is the job of a module,
+ * e.g. `AwsSimpleSubnetModule` via its `localFilesystems` input.
+ *
+ * @example
+ * ```ts
+ * const filesystem = new Filesystem('shared-uploads');
+ * region.addFilesystem(filesystem);
+ * ```
+ *
  * @group Models/Filesystem
+ *
+ * @see Definition of [Default Models](/docs/fundamentals/models#default-models).
  */
 export declare class Filesystem extends AModel<FilesystemSchema, Filesystem> {
     readonly filesystemName: string;
+    /**
+     * @param filesystemName The name of the filesystem, unique within its region.
+     */
     constructor(filesystemName: string);
+    /**
+     * @internal
+     */
+    static unSynth(filesystem: FilesystemSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Filesystem>;
+    /**
+     * @internal
+     */
     setContext(): string | undefined;
+    /**
+     * @internal
+     */
     synth(): FilesystemSchema;
-    static unSynth(filesystem: FilesystemSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Filesystem>;
 }

package/dist/models/filesystem/filesystem.model.js

@@ -13,13 +13,40 @@ import { Model } from '../../decorators/model.decorator.js';
 import { AModel } from '../model.abstract.js';
 import { FilesystemSchema } from './filesystem.schema.js';
 /**
+ * A Filesystem model is a network filesystem shared by the executions of a region.
+ * It exists so that state which must outlive a container - uploads, caches, shared data - has somewhere to live.
+ *
+ * A filesystem belongs to one {@link Region}. Mounting it into a {@link Subnet} is the job of a module,
+ * e.g. `AwsSimpleSubnetModule` via its `localFilesystems` input.
+ *
+ * @example
+ * ```ts
+ * const filesystem = new Filesystem('shared-uploads');
+ * region.addFilesystem(filesystem);
+ * ```
+ *
  * @group Models/Filesystem
+ *
+ * @see Definition of [Default Models](/docs/fundamentals/models#default-models).
  */
 let Filesystem = Filesystem_1 = class Filesystem extends AModel {
+    /**
+     * @param filesystemName The name of the filesystem, unique within its region.
+     */
     constructor(filesystemName) {
         super();
         this.filesystemName = filesystemName;
     }
+    /**
+     * @internal
+     */
+    static async unSynth(filesystem, deReferenceContext) {
+        assert(!!deReferenceContext);
+        return new Filesystem_1(filesystem.filesystemName);
+    }
+    /**
+     * @internal
+     */
     setContext() {
         const parents = this.getParents();
         const region = parents['region']?.[0]?.to;
@@ -28,15 +55,14 @@ let Filesystem = Filesystem_1 = class Filesystem extends AModel {
         }
         return [`${this.constructor.NODE_NAME}=${this.filesystemName}`, region.getContext()].join(',');
     }
+    /**
+     * @internal
+     */
     synth() {
         return {
             filesystemName: this.filesystemName,
         };
     }
-    static async unSynth(filesystem, deReferenceContext) {
-        assert(!!deReferenceContext);
-        return new Filesystem_1(filesystem.filesystemName);
-    }
 };
 Filesystem = Filesystem_1 = __decorate([
     Model('@octo', 'filesystem', FilesystemSchema),

package/dist/models/filesystem/filesystem.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.model.js","sourceRoot":"","sources":["../../../src/models/filesystem/filesystem.model.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;GAEG;AAEI,IAAM,UAAU,kBAAhB,MAAM,UAAW,SAAQ,MAAoC;IAGlE,YAAY,cAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAEQ,UAAU;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,GAAI,IAAI,CAAC,WAAiC,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAC9G,GAAG,CACJ,CAAC;IACJ,CAAC;IAEQ,KAAK;QACZ,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,OAAO,CAC3B,UAA4B,EAC5B,kBAA8D;QAE9D,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAE7B,OAAO,IAAI,YAAU,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;CACF,CAAA;AAjCY,UAAU;IADtB,KAAK,CAAa,OAAO,EAAE,YAAY,EAAE,gBAAgB,CAAC;;GAC9C,UAAU,CAiCtB"}
+{"version":3,"file":"filesystem.model.js","sourceRoot":"","sources":["../../../src/models/filesystem/filesystem.model.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAE1D;;;;;;;;;;;;;;;;GAgBG;AAEI,IAAM,UAAU,kBAAhB,MAAM,UAAW,SAAQ,MAAoC;IAGlE;;OAEG;IACH,YAAY,cAAsB;QAChC,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACvC,CAAC;IAED;;OAEG;IACH,MAAM,CAAU,KAAK,CAAC,OAAO,CAC3B,UAA4B,EAC5B,kBAA8D;QAE9D,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAE7B,OAAO,IAAI,YAAU,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC;IACnD,CAAC;IAED;;OAEG;IACM,UAAU;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC1C,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,GAAI,IAAI,CAAC,WAAiC,CAAC,SAAS,IAAI,IAAI,CAAC,cAAc,EAAE,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAC9G,GAAG,CACJ,CAAC;IACJ,CAAC;IAED;;OAEG;IACM,KAAK;QACZ,OAAO;YACL,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IACJ,CAAC;CACF,CAAA;AA7CY,UAAU;IADtB,KAAK,CAAa,OAAO,EAAE,YAAY,EAAE,gBAAgB,CAAC;;GAC9C,UAAU,CA6CtB"}

package/dist/models/filesystem/filesystem.schema.d.ts

@@ -1,6 +1,11 @@
 /**
+ * Schema of the {@link Filesystem} model.
+ *
  * @group Models/Filesystem
  */
 export declare class FilesystemSchema {
+    /**
+     * The name of the filesystem, unique within its {@link Region}.
+     */
     filesystemName: string;
 }

package/dist/models/filesystem/filesystem.schema.js

@@ -10,10 +10,15 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { Validate } from '../../decorators/validate.decorator.js';
 import { Schema } from '../../functions/schema/schema.js';
 /**
+ * Schema of the {@link Filesystem} model.
+ *
  * @group Models/Filesystem
  */
 export class FilesystemSchema {
     constructor() {
+        /**
+         * The name of the filesystem, unique within its {@link Region}.
+         */
         this.filesystemName = Schema();
     }
 }

package/dist/models/filesystem/filesystem.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"filesystem.schema.js","sourceRoot":"","sources":["../../../src/models/filesystem/filesystem.schema.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D;;GAEG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QAEE,mBAAc,GAAG,MAAM,EAAU,CAAC;IACpC,CAAC;CAAA;AADC;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,EAAE,CAAC;;wDAC3D"}
+{"version":3,"file":"filesystem.schema.js","sourceRoot":"","sources":["../../../src/models/filesystem/filesystem.schema.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,OAAO,gBAAgB;IAA7B;QACE;;WAEG;QAEH,mBAAc,GAAG,MAAM,EAAU,CAAC;IACpC,CAAC;CAAA;AADC;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,6BAA6B,EAAE,EAAE,CAAC;;wDAC3D"}

package/dist/models/image/image.model.d.ts

@@ -2,13 +2,14 @@ import type { UnknownModel } from '../../app.type.js';
 import { AModel } from '../model.abstract.js';
 import { ImageSchema } from './image.schema.js';
 /**
- * An Image model represents a Docker image, to either build, or run, your microservices.
+ * An Image model represents a Docker image, to either build, or run, your services.
+ * Images belong to an {@link Account}: an image is used only inside the account it sits in, and is
+ * linked to each of its regions it is published into.
  *
  * @example
  * ```ts
- * const image = new Image('nginx', '2.4', { dockerfilePath: './Dockerfile' });
- *
- * const image = new Image('docker/hello-world', '1.0', { dockerfilePath: './Dockerfile' });
+ * const image = new Image('nginx', '2.4');
+ * account.addImage(image);
  * ```
  *
  * @group Models/Image
@@ -19,8 +20,21 @@ export declare class Image extends AModel<ImageSchema, Image> {
     readonly imageFamily: string;
     readonly imageId: string;
     readonly imageName: string;
+    /**
+     * @param imageFamily The repository name shared by all versions of this image.
+     * @param imageName The version or tag of this image within its family.
+     */
     constructor(imageFamily: string, imageName: string);
+    /**
+     * @internal
+     */
+    static unSynth(image: ImageSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Image>;
+    /**
+     * @internal
+     */
     setContext(): string | undefined;
+    /**
+     * @internal
+     */
     synth(): ImageSchema;
-    static unSynth(image: ImageSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Image>;
 }

package/dist/models/image/image.model.js

@@ -13,13 +13,14 @@ import { Model } from '../../decorators/model.decorator.js';
 import { AModel } from '../model.abstract.js';
 import { ImageSchema } from './image.schema.js';
 /**
- * An Image model represents a Docker image, to either build, or run, your microservices.
+ * An Image model represents a Docker image, to either build, or run, your services.
+ * Images belong to an {@link Account}: an image is used only inside the account it sits in, and is
+ * linked to each of its regions it is published into.
  *
  * @example
  * ```ts
- * const image = new Image('nginx', '2.4', { dockerfilePath: './Dockerfile' });
- *
- * const image = new Image('docker/hello-world', '1.0', { dockerfilePath: './Dockerfile' });
+ * const image = new Image('nginx', '2.4');
+ * account.addImage(image);
  * ```
  *
  * @group Models/Image
@@ -27,20 +28,37 @@ import { ImageSchema } from './image.schema.js';
  * @see Definition of [Default Models](/docs/fundamentals/models#default-models).
  */
 let Image = Image_1 = class Image extends AModel {
+    /**
+     * @param imageFamily The repository name shared by all versions of this image.
+     * @param imageName The version or tag of this image within its family.
+     */
     constructor(imageFamily, imageName) {
         super();
         this.imageFamily = imageFamily;
         this.imageId = `${imageFamily}/${imageName}`;
         this.imageName = imageName;
     }
+    /**
+     * @internal
+     */
+    static async unSynth(image, deReferenceContext) {
+        assert(!!deReferenceContext);
+        return new Image_1(image.imageFamily, image.imageName);
+    }
+    /**
+     * @internal
+     */
     setContext() {
         const parents = this.getParents();
-        const app = parents['app']?.[0]?.to;
-        if (!app) {
+        const account = parents['account']?.[0]?.to;
+        if (!account) {
             return undefined;
         }
-        return [`${this.constructor.NODE_NAME}=${this.imageId}`, app.getContext()].join(',');
+        return [`${this.constructor.NODE_NAME}=${this.imageId}`, account.getContext()].join(',');
     }
+    /**
+     * @internal
+     */
     synth() {
         return {
             imageFamily: this.imageFamily,
@@ -48,10 +66,6 @@ let Image = Image_1 = class Image extends AModel {
             imageName: this.imageName,
         };
     }
-    static async unSynth(image, deReferenceContext) {
-        assert(!!deReferenceContext);
-        return new Image_1(image.imageFamily, image.imageName);
-    }
 };
 Image = Image_1 = __decorate([
     Model('@octo', 'image', ImageSchema),

package/dist/models/image/image.model.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.model.js","sourceRoot":"","sources":["../../../src/models/image/image.model.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AAEI,IAAM,KAAK,aAAX,MAAM,KAAM,SAAQ,MAA0B;IAOnD,YAAY,WAAmB,EAAE,SAAiB;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,GAAG,WAAW,IAAI,SAAS,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAEQ,UAAU;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,GAAG,GAAG,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QACpC,IAAI,CAAC,GAAG,EAAE,CAAC;YACT,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,GAAI,IAAI,CAAC,WAA4B,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,GAAG,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACzG,CAAC;IAEQ,KAAK;QACZ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;IAED,MAAM,CAAU,KAAK,CAAC,OAAO,CAC3B,KAAkB,EAClB,kBAA8D;QAE9D,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAE7B,OAAO,IAAI,OAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;CACF,CAAA;AAvCY,KAAK;IADjB,KAAK,CAAQ,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC;;GAC/B,KAAK,CAuCjB"}
+{"version":3,"file":"image.model.js","sourceRoot":"","sources":["../../../src/models/image/image.model.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,OAAO,EAAE,MAAM,IAAI,MAAM,EAAE,MAAM,QAAQ,CAAC;AAE1C,OAAO,EAAE,KAAK,EAAE,MAAM,qCAAqC,CAAC;AAC5D,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAEhD;;;;;;;;;;;;;;GAcG;AAEI,IAAM,KAAK,aAAX,MAAM,KAAM,SAAQ,MAA0B;IAOnD;;;OAGG;IACH,YAAY,WAAmB,EAAE,SAAiB;QAChD,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;QAC/B,IAAI,CAAC,OAAO,GAAG,GAAG,WAAW,IAAI,SAAS,EAAE,CAAC;QAC7C,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;IAC7B,CAAC;IAED;;OAEG;IACH,MAAM,CAAU,KAAK,CAAC,OAAO,CAC3B,KAAkB,EAClB,kBAA8D;QAE9D,MAAM,CAAC,CAAC,CAAC,kBAAkB,CAAC,CAAC;QAE7B,OAAO,IAAI,OAAK,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC;IACvD,CAAC;IAED;;OAEG;IACM,UAAU;QACjB,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC;QAC5C,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,OAAO,CAAC,GAAI,IAAI,CAAC,WAA4B,CAAC,SAAS,IAAI,IAAI,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC7G,CAAC;IAED;;OAEG;IACM,KAAK;QACZ,OAAO;YACL,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC;IACJ,CAAC;CACF,CAAA;AApDY,KAAK;IADjB,KAAK,CAAQ,OAAO,EAAE,OAAO,EAAE,WAAW,CAAC;;GAC/B,KAAK,CAoDjB"}

package/dist/models/image/image.schema.d.ts

@@ -1,12 +1,20 @@
 /**
+ * Schema of the {@link Image} model.
+ *
  * @group Models/Image
  */
 export declare class ImageSchema {
+    /**
+     * The family this image belongs to, i.e. the repository name shared by all of its versions.
+     */
     imageFamily: string;
     /**
      * An imageId is the unique identifier for this image.
      * - Format of imageId is `{imageFamily}/{imageName}`
      */
     imageId: string;
+    /**
+     * The name of this image within its family, i.e. its version or tag.
+     */
     imageName: string;
 }

package/dist/models/image/image.schema.js

@@ -10,16 +10,24 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { Validate } from '../../decorators/validate.decorator.js';
 import { Schema } from '../../functions/schema/schema.js';
 /**
+ * Schema of the {@link Image} model.
+ *
  * @group Models/Image
  */
 export class ImageSchema {
     constructor() {
+        /**
+         * The family this image belongs to, i.e. the repository name shared by all of its versions.
+         */
         this.imageFamily = Schema();
         /**
          * An imageId is the unique identifier for this image.
          * - Format of imageId is `{imageFamily}/{imageName}`
          */
         this.imageId = Schema();
+        /**
+         * The name of this image within its family, i.e. its version or tag.
+         */
         this.imageName = Schema();
     }
 }

package/dist/models/image/image.schema.js.map

@@ -1 +1 @@
-{"version":3,"file":"image.schema.js","sourceRoot":"","sources":["../../../src/models/image/image.schema.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D;;GAEG;AACH,MAAM,OAAO,WAAW;IAAxB;QAEE,gBAAW,GAAG,MAAM,EAAU,CAAC;QAE/B;;;WAGG;QACH,YAAO,GAAG,MAAM,EAAU,CAAC;QAG3B,cAAS,GAAG,MAAM,EAAU,CAAC;IAC/B,CAAC;CAAA;AAVC;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAAE,CAAC;;gDAClE;AAS/B;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,EAAE,CAAC;;8CACnE"}
+{"version":3,"file":"image.schema.js","sourceRoot":"","sources":["../../../src/models/image/image.schema.ts"],"names":[],"mappings":";;;;;;;;;AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,wCAAwC,CAAC;AAClE,OAAO,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE1D;;;;GAIG;AACH,MAAM,OAAO,WAAW;IAAxB;QACE;;WAEG;QAEH,gBAAW,GAAG,MAAM,EAAU,CAAC;QAE/B;;;WAGG;QACH,YAAO,GAAG,MAAM,EAAU,CAAC;QAE3B;;WAEG;QAEH,cAAS,GAAG,MAAM,EAAU,CAAC;IAC/B,CAAC;CAAA;AAbC;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,iCAAiC,EAAE,EAAE,CAAC;;gDAClE;AAY/B;IADC,QAAQ,CAAC,EAAE,OAAO,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,EAAE,KAAK,EAAE,gCAAgC,EAAE,EAAE,CAAC;;8CACnE"}

package/dist/models/model-action.interface.d.ts

@@ -1,18 +1,31 @@
 import type { ActionOutputs, EnhancedModuleSchema, UnknownModule } from '../app.type.js';
 import type { Diff } from '../functions/diff/diff.js';
 /**
- * Model Actions are translation functions between Diff and underlying resources.
- * These actions can translate a specific type of Diff into individual resources.
+ * A model action translates a change in intent into resources.
+ *
+ * Octo diffs your models, and for every {@link Diff} it produces it asks each registered action
+ * whether the diff is its concern. The actions that accept it declare the resources that change
+ * has to bring about. This is the only place a model becomes infrastructure.
+ *
+ * Register the class with {@link Action}, and a {@link Factory} to construct it.
  *
  * @group Models
+ *
+ * @see Definition of [Actions](/docs/fundamentals/actions).
  */
 export interface IModelAction<T extends UnknownModule> {
     /**
-     * This function determines if the handle is applicable to the diff.
+     * Whether this action handles the given diff.
+     * Typically a check on the diff's node, field, and action.
      */
     filter(diff: Diff): boolean;
     /**
-     * This function contains the logic to apply the diff(s) to the underlying infrastructure.
+     * Declares the resources this diff calls for.
+     *
+     * @param diff The diff that passed {@link IModelAction.filter}.
+     * @param actionInputs The module's inputs, metadata, and the nodes it produced.
+     * @param actionOutputs The resources declared so far by earlier actions in this transaction.
+     * @returns `actionOutputs`, with this action's resources added.
      */
     handle(diff: Diff, actionInputs: EnhancedModuleSchema<T>, actionOutputs: ActionOutputs): Promise<ActionOutputs>;
 }