@quadnix/octo 0.0.30 → 0.2.0

package/dist/main.js

@@ -10,102 +10,221 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 import { strict as assert } from 'assert';
 import { EnableHook } from './decorators/enable-hook.decorator.js';
 import { TransactionError } from './errors/index.js';
+import { CommitModeCompletedEvent, ModeFailedEvent, ModeFinishedEvent, ModeStartedEvent, TerraformFoldersWrittenEvent, ValidateModeCompletedEvent, } from './events/index.js';
 import { Container } from './functions/container/container.js';
 import { DiffMetadata } from './functions/diff/diff-metadata.js';
 import { App } from './models/app/app.model.js';
+import { applyModelTransaction } from './modes/apply-transaction.js';
+import { commit as runCommit } from './modes/commit.mode.js';
+import { generate as runGenerate } from './modes/generate.mode.js';
+import { runAction as runRunAction } from './modes/run-action.mode.js';
+import { validate as runValidate } from './modes/validate.mode.js';
 import { ModuleContainer } from './modules/module.container.js';
-import { OverlayDataRepository, OverlayDataRepositoryFactory } from './overlays/overlay-data.repository.js';
-import { BaseResourceSchema } from './resources/resource.schema.js';
-import { CaptureService } from './services/capture/capture.service.js';
+import { EventService } from './services/event/event.service.js';
 import { InputService } from './services/input/input.service.js';
 import { SchemaTranslationService } from './services/schema-translation/schema-translation.service.js';
 import { ModelSerializationService } from './services/serialization/model/model-serialization.service.js';
 import { ResourceSerializationService } from './services/serialization/resource/resource-serialization.service.js';
 import { StateManagementService, StateManagementServiceFactory, } from './services/state-management/state-management.service.js';
-import { TransactionService } from './services/transaction/transaction.service.js';
+import { TerraformService } from './services/terraform/terraform.service.js';
 /**
+ * The entry point to Octo.
+ *
+ * You describe infrastructure by loading modules, and Octo turns that description into terraform,
+ * checks what terraform intends to do, and records what it did. That is the lifecycle, and it is
+ * always these four steps:
+ *
+ * 1. {@link Octo.generate} - write the terraform module folders for the infrastructure you described.
+ * 2. {@link Octo.validate} - correlate terraform's plans with your intent, and report the difference.
+ * 3. `terraform apply` - see {@link TerraformUtility}. Octo does not do this for you.
+ * 4. {@link Octo.commit} - record the applied result back into Octo's state.
+ *
+ * Splitting them is deliberate: nothing is applied until you have seen a report of what would change,
+ * and each step is a separate process, so a CI pipeline can gate between them.
+ *
+ * @example
+ * ```ts
+ * const octo = new Octo();
+ * await octo.initialize(new LocalStateProvider('./infrastructure'));
+ *
+ * octo.registerTerraformConfig({ providers: { aws: { source: 'hashicorp/aws' } } });
+ * octo.registerTerraformProvider('aws', '1234567890', 'us-east-1');
+ *
+ * octo.loadModule(SimpleAppModule, 'app-module', { name: 'my-app' });
+ * await octo.compose();
+ *
+ * await octo.generate(octo.getRootModel(), { outputDir: './infrastructure/terraform' });
+ * ```
+ *
  * @group Main
+ *
+ * @see Definition of [Modules](/docs/fundamentals/modules).
  */
 export class Octo {
-    constructor() {
-        this.modelStateFileName = 'models.json';
-        this.actualResourceStateFileName = 'resources-actual.json';
-        this.oldResourceStateFileName = 'resources-old.json';
-    }
-    async *beginTransaction(app, { appLockId = undefined, enableResourceCapture = false, enableResourceValidation = false, yieldModelDiffs = false, yieldModelTransaction = false, yieldResourceDiffs = false, yieldResourceTransaction = false, } = {}) {
-        const diffs = await app.diff();
-        const transaction = this.transactionService.beginTransaction(diffs, {
-            enableResourceCapture,
-            enableResourceValidation,
-            yieldModelDiffs: true,
-            yieldModelTransaction: true,
-            yieldResourceDiffs: true,
-            yieldResourceTransaction: true,
-        });
-        const modelDiffs = await transaction.next();
-        if (yieldModelDiffs) {
-            yield modelDiffs.value;
-        }
-        const modelTransaction = await transaction.next();
-        if (yieldModelTransaction) {
-            yield modelTransaction.value;
-        }
-        const resourceDiffs = await transaction.next();
-        if (yieldResourceDiffs) {
-            yield resourceDiffs.value;
-        }
-        if (!appLockId) {
-            throw new TransactionError('App is not in lock state!');
-        }
-        const isAppLocked = await this.stateManagementService.isAppLocked(appLockId);
-        if (!isAppLocked) {
-            throw new TransactionError('App is not in lock state!');
-        }
-        await this.stateManagementService.updateAppLockTransaction(appLockId);
-        let resourceTransaction = undefined;
-        try {
-            resourceTransaction = await transaction.next();
-            if (yieldResourceTransaction) {
-                yield resourceTransaction.value;
-            }
-            return (await transaction.next()).value;
-        }
-        finally {
-            await this.commitTransaction(app, modelTransaction.value, resourceTransaction ? resourceTransaction.value : []);
+    /**
+     * The last step of the lifecycle - records the result of a `terraform apply` back into Octo's state.
+     *
+     * A terraform apply reports what it created, and part of that is what each octo resource's
+     * `response` is made of - ARNs, generated IDs, endpoints. Without this step the next run has no
+     * idea any of it exists.
+     *
+     * **All-or-nothing**: if an expected output is missing, this throws before touching state, so a
+     * partial apply never leaves a half-written record behind. Pass `partial` after an apply that
+     * failed and the missing outputs become warnings instead, with every resource they belong to left
+     * out of the committed graph. Outputs for a folder Octo does not track are ignored, and returned
+     * as warnings for you to surface.
+     *
+     * **Requires the lock**, and does not release it. Taking and releasing the lock belongs to whoever
+     * drives the lifecycle - the CLI's `octo commit` releases it once this returns, and keeps it when this
+     * throws.
+     *
+     * @param app The root model, from {@link Octo.getRootModel}.
+     * @param options `lockId` is the lock from `octo lock`. `outputs` is
+     * `TerraformUtility.output(dir, { json: true })` in full. `partial` records what a failed apply
+     * did build.
+     * @param transaction The model transaction result.
+     * @throws {@link TransactionError} When the app is not locked, or `lockId` is not the lock held.
+     */
+    async commit(app, options, transaction) {
+        // Checked before the mode starts, so a commit without the lock reads no state and writes none.
+        if (!(await this.stateManagementService.isAppLocked(options.lockId))) {
+            throw new TransactionError('App is not locked!');
         }
+        return this.runMode('commit', app.name, async () => {
+            const { userData } = await this.stateManagementService.getResourceState(this.stateManagementService.actualResourceStateFileName);
+            // Build the transaction unless a single-process driver already built it and passed it in.
+            const resolvedTransaction = transaction ?? (await applyModelTransaction(app));
+            const { externalResourceIds, modelTransaction, ...completed } = await runCommit({
+                ...options,
+                previousFolders: userData.terraformFolders ?? [],
+                previousMappings: userData.terraformResources ?? [],
+                transaction: resolvedTransaction,
+            });
+            await this.commitTransaction(app, modelTransaction, []);
+            // The committed graph now carries everything an external resource's actions made of it, so the
+            // records they wrote mid-apply are cleared. Done after the state is persisted, so a failure
+            // here costs a stale record rather than the record itself.
+            await Promise.all(externalResourceIds.map((resourceId) => this.stateManagementService.deleteExternalResourceState(resourceId)));
+            // Emitted after the state is persisted, so a listener never sees an uncommitted commit.
+            this.eventService.emit(new CommitModeCompletedEvent(undefined, completed));
+            return { warnings: completed.warnings };
+        });
     }
-    async commitTransaction(app, modelTransaction, resourceTransaction = []) {
-        // `modelTransaction` and `resourceTransaction` is used by hooks of type CommitHook.
-        assert(!!modelTransaction);
-        assert(!!resourceTransaction);
-        // Save the state of the new app and its resources.
-        await this.saveModelState(app);
-        await this.saveResourceState();
-        // Reset the runtime environment with the latest state.
-        await this.retrieveResourceState();
-    }
+    /**
+     * Runs every loaded module, in the order {@link Octo.orderModules} set, building the model graph.
+     * Call it once, after loading modules and before any lifecycle step.
+     *
+     * @returns Every model and overlay the modules created, keyed by a unique ID.
+     */
     async compose() {
         return await this.moduleContainer.apply();
     }
+    /**
+     * The first step of the lifecycle - writes the terragrunt module folders for the infrastructure you
+     * described, one folder per module, and saves the model state.
+     *
+     * A new module gets a new folder, and a changed module is rewritten in the folder it already has.
+     * A module you *removed* is not deleted: its folder is **emptied**, keeping only the provider
+     * blocks, so the next terraform apply destroys the live infrastructure rather than orphaning it.
+     * Octo never deletes a folder.
+     *
+     * @param app The root model, from {@link Octo.getRootModel}.
+     * @param options `outputDir` is where the module folders are written.
+     * @param transaction The model transaction result.
+     */
+    async generate(app, options, transaction) {
+        return this.runMode('generate', app.name, async () => {
+            // The previous folder records must be read before this run writes the new `models.json`, so a
+            // module deleted from intent is caught on the generate right after its removal.
+            const [{ userData: modelUserData }, { userData: actualResourceUserData }] = await Promise.all([
+                this.stateManagementService.getModelState(this.stateManagementService.modelStateFileName),
+                this.stateManagementService.getResourceState(this.stateManagementService.actualResourceStateFileName),
+            ]);
+            // The last commit's record says what terraform state holds; the last generate's may say what
+            // was never applied. A folder keeps the providers of both, so neither can strand the other's
+            // resources in terraform state without the provider to destroy them.
+            const previousFolders = new Map();
+            for (const record of [
+                ...(actualResourceUserData.terraformFolders ?? []),
+                ...(modelUserData.terraformFolders ?? []),
+            ]) {
+                const providers = [...(previousFolders.get(record.moduleId)?.providers ?? [])];
+                for (const provider of record.providers) {
+                    const isRecorded = providers.some((p) => p.providerType === provider.providerType &&
+                        p.accountId === provider.accountId &&
+                        p.regionId === provider.regionId);
+                    if (!isRecorded) {
+                        providers.push(provider);
+                    }
+                }
+                previousFolders.set(record.moduleId, { ...record, providers });
+            }
+            // Build the transaction unless a single-process driver already built it and passed it in.
+            const resolvedTransaction = transaction ?? (await applyModelTransaction(app));
+            const previousFolderList = [...previousFolders.values()];
+            const resourceDiffs = await runGenerate({
+                ...options,
+                previousFolders: previousFolderList,
+                transaction: resolvedTransaction,
+            });
+            const written = this.terraformService.getModuleIds();
+            this.eventService.emit(new TerraformFoldersWrittenEvent(undefined, {
+                emptied: previousFolderList
+                    .map((folder) => folder.moduleId)
+                    .filter((moduleId) => !written.includes(moduleId)),
+                outputDir: options.outputDir,
+                written,
+            }));
+            await this.saveModelState(app);
+            return resourceDiffs;
+        });
+    }
+    /**
+     * To fetch a loaded module by its module ID.
+     *
+     * @returns The module, or `undefined` if no module was loaded under that ID.
+     */
     getModule(...args) {
         return this.inputService.getModule(...args);
     }
+    /**
+     * To fetch the resources a module produced, by its module ID.
+     */
     getModuleResources(...args) {
         return this.inputService.getModuleResources(...args);
     }
+    /**
+     * The root of the model graph - the one {@link App} the loaded modules produced. Every lifecycle
+     * step takes it. Call after {@link Octo.compose}.
+     *
+     * @throws If no app model, or more than one distinct app model, was registered.
+     */
+    getRootModel() {
+        return this.inputService.getRootModel();
+    }
+    /**
+     * Boots Octo. Call it once, before anything else.
+     *
+     * The two optional arguments are how you replace Octo's internals with your own: exclusions run
+     * first, so you can unregister a built-in {@link Factory} and then resolve yours in its place.
+     *
+     * @param stateProvider Where Octo reads and writes its state. See {@link IStateProvider}.
+     * @param initializeInContainer Factories to resolve at boot - event listeners, most commonly.
+     * @param excludeInContainer Factories to unregister at boot.
+     */
     async initialize(stateProvider, initializeInContainer = [], excludeInContainer = []) {
         const container = Container.getInstance();
         [
-            this.captureService,
+            this.eventService,
             this.inputService,
             this.modelSerializationService,
             this.moduleContainer,
             this.resourceSerializationService,
             this.schemaTranslationService,
             this.stateManagementService,
-            this.transactionService,
+            this.terraformService,
         ] = await Promise.all([
-            container.get(CaptureService),
+            container.get(EventService),
             container.get(InputService),
             container.get(ModelSerializationService),
             container.get(ModuleContainer),
@@ -114,7 +233,7 @@ export class Octo {
             container.get(StateManagementService, {
                 args: [stateProvider],
             }),
-            container.get(TransactionService),
+            container.get(TerraformService),
         ]);
         for (const exclude of excludeInContainer) {
             container.unRegisterFactory(exclude.type);
@@ -127,47 +246,233 @@ export class Octo {
         // Reset the runtime environment with the latest state.
         await this.retrieveResourceState();
     }
+    /**
+     * To load a module, which {@link Octo.compose} will then run.
+     *
+     * The same module class can be loaded more than once under different module IDs, and the ID scopes
+     * everything that instance produces.
+     *
+     * @param module The module class, or its registered name.
+     * @param moduleId A unique ID for this instance of the module.
+     * @param inputs The inputs, matching the module's schema.
+     */
     loadModule(module, moduleId, inputs) {
         this.moduleContainer.load(module, moduleId, inputs);
     }
+    /**
+     * To set the order {@link Octo.compose} runs modules in, by listing their classes.
+     *
+     * Order matters because a module resolves what earlier modules produced - a subnet module must run
+     * after the region module whose region it attaches to.
+     */
     orderModules(...args) {
         this.moduleContainer.order(...args);
     }
-    registerCapture(resourceContext, response) {
-        this.captureService.registerCapture(resourceContext, response);
-    }
+    /**
+     * To register callbacks that run at fixed points of the lifecycle. Use them to inject behavior -
+     * an audit trail, an approval gate - without modifying the framework.
+     *
+     * The hook points, each with its own signature:
+     * - `PreCommitHook` / `PostCommitHook` - around the commit.
+     * - `PreModelActionHook` / `PostModelActionHook` - around every model action.
+     * - `PreResourceActionHook` / `PostResourceActionHook` - around every resource action.
+     *
+     * @see Techniques for [Hooks](/docs/techniques/hooks).
+     */
     registerHooks(...args) {
         this.moduleContainer.registerHooks(...args);
     }
+    /**
+     * To teach Octo how to read one schema as another.
+     *
+     * Modules find each other by schema, so a module that changes its schema breaks its consumers.
+     * A translation is the escape hatch: register the schema you have, the schema your module expects,
+     * and a function between them, and the lookup keeps working while you migrate.
+     *
+     * @see Techniques for [Schema](/docs/techniques/schema).
+     */
     registerSchemaTranslation(...args) {
         return this.schemaTranslationService.registerSchemaTranslation(...args);
     }
+    /**
+     * To apply tags to resources in bulk, so that individual modules do not each have to be told about
+     * your organization's tagging policy.
+     *
+     * Each entry's `scope` decides its reach: empty tags every resource of the app, `moduleId` tags
+     * every resource of one module, and `resourceContext` tags a single resource.
+     */
     registerTags(args) {
         for (const { scope, tags } of args) {
             const isGlobal = !scope.moduleId && !scope.resourceContext;
             this.inputService.registerTag((isGlobal || scope), tags);
         }
     }
+    /**
+     * To set the minimum terraform version, and the `required_providers` block rendered into every
+     * generated module folder.
+     *
+     * Call it after {@link Octo.initialize}, and before {@link Octo.generate}.
+     */
+    registerTerraformConfig(...args) {
+        return this.terraformService.addTerraformConfig(...args);
+    }
+    /**
+     * To register a terraform provider for one deployment target - a provider type, an account, and a
+     * region.
+     *
+     * Resources bind to a provider by `{ accountId, regionId }` alone, so this is the one place a
+     * provider type is named. Register one per account/region combination you deploy into.
+     *
+     * Call it after {@link Octo.initialize}, and before {@link Octo.generate}.
+     */
+    registerTerraformProvider(...args) {
+        return this.terraformService.addTerraformProvider(...args);
+    }
+    /**
+     * Runs one resource action for an external resource.
+     *
+     * Terraform calls back into this mid-apply, through the generated CLI command; it is not a step you
+     * run yourself.
+     *
+     * @internal
+     */
+    async runAction(app, options) {
+        return this.runMode('run-action', app.name, () => runRunAction(app, options), {
+            resourceId: options.resourceId,
+        });
+    }
+    /**
+     * The second step of the lifecycle - correlates terraform's plans with your intent, and reports
+     * what it finds. This is what you read before deciding whether to apply.
+     *
+     * The report answers two questions separately:
+     * 1. **What will change, and why.** Including terraform changes Octo did not flag directly but can
+     *    attribute to something it did - a referenced resource whose identity moved, or an address the
+     *    resource no longer renders.
+     * 2. **What changed that your intent does not explain** - drift, i.e. infrastructure modified
+     *    outside Octo. Read `confidence` first: drift is only reliable when intent itself is unchanged.
+     *
+     * The report fails only when terraform could not plan a folder Octo generated. Folders Octo does
+     * not track are excluded, and noted. So is every external resource a previous run published and no
+     * commit has recorded, which is the only step that reads those records back for a user.
+     *
+     * @param app The root model, from {@link Octo.getRootModel}.
+     * @param plans The whole result of `TerraformUtility.plan(dir, { json: true })`. Its `errors` map
+     * carries terraform's own message for each folder that failed to plan.
+     * @param transaction The model transaction result.
+     */
+    async validate(app, plans, transaction) {
+        return this.runMode('validate', app.name, async () => {
+            const { userData } = await this.stateManagementService.getResourceState(this.stateManagementService.actualResourceStateFileName);
+            const { terraformFolders, terraformResources } = userData;
+            const previousMappings = terraformResources ?? [];
+            const persistedMappings = new Map();
+            for (const mapping of previousMappings) {
+                persistedMappings.set(mapping.resourceContext, mapping);
+            }
+            const externalResourceStateIds = await this.stateManagementService.listExternalResourceStateIds();
+            // Build the transaction unless a single-process driver already built it and passed it in.
+            const resolvedTransaction = transaction ?? (await applyModelTransaction(app));
+            const report = await runValidate({
+                externalResourceStateIds,
+                persistedMappings,
+                planErrors: plans.errors,
+                plans: plans.plans,
+                previousFolders: terraformFolders ?? [],
+                transaction: resolvedTransaction,
+            });
+            this.eventService.emit(new ValidateModeCompletedEvent(undefined, { report }));
+            return report;
+        });
+    }
+    /**
+     * This function persists the model and resource state using {@link IStateProvider}.
+     * Then immediately fetches the resource state in memory for the next set of operations.
+     *
+     * @internal
+     */
+    async commitTransaction(app, modelTransaction, resourceTransaction = []) {
+        // `modelTransaction` and `resourceTransaction` is used by hooks of type CommitHook.
+        assert(!!modelTransaction);
+        assert(!!resourceTransaction);
+        // Save the state of the new app and its resources.
+        await this.saveModelState(app);
+        await this.saveResourceState();
+        // Reset the runtime environment with the latest state.
+        await this.retrieveResourceState();
+    }
+    /**
+     * This function deserializes the resource state in memory.
+     * It deserializes the actual resource state into actual resources,
+     * and the last resource state into old resources.
+     *
+     * @internal
+     */
     async retrieveResourceState() {
-        const { data: actualSerializedOutput } = await this.stateManagementService.getResourceState(this.actualResourceStateFileName);
-        const { data: oldSerializedOutput } = await this.stateManagementService.getResourceState(this.oldResourceStateFileName);
+        const { data: actualSerializedOutput } = await this.stateManagementService.getResourceState(this.stateManagementService.actualResourceStateFileName);
+        const { data: oldSerializedOutput } = await this.stateManagementService.getResourceState(this.stateManagementService.oldResourceStateFileName);
         // Initialize previous resource state.
         await this.resourceSerializationService.deserialize(actualSerializedOutput, oldSerializedOutput);
     }
+    /**
+     * Wraps a mode to emit its boundary events, and re-throws whatever the mode threw.
+     * The finishing events use `emitAndWait`, so a listener that writes a file completes first.
+     *
+     * @internal
+     */
+    async runMode(mode, appName, body, { resourceId } = {}) {
+        const startedAt = Date.now();
+        const payload = { appName, mode, ...(resourceId === undefined ? {} : { resourceId }) };
+        this.eventService.emit(new ModeStartedEvent(mode, payload));
+        let result;
+        try {
+            result = await body();
+        }
+        catch (error) {
+            await this.eventService.emitAndWait(new ModeFailedEvent(mode, {
+                ...payload,
+                durationInMs: Date.now() - startedAt,
+                error: error instanceof Error ? error : new Error(String(error)),
+            }));
+            throw error;
+        }
+        await this.eventService.emitAndWait(new ModeFinishedEvent(mode, { ...payload, durationInMs: Date.now() - startedAt }));
+        return result;
+    }
+    /**
+     * This function persists the in-memory model state.
+     *
+     * @internal
+     */
     async saveModelState(app) {
         const modelSerializedOutput = await this.modelSerializationService.serialize(app);
-        await this.stateManagementService.saveModelState(this.modelStateFileName, modelSerializedOutput, {
+        await this.stateManagementService.saveModelState(this.stateManagementService.modelStateFileName, modelSerializedOutput, {
+            terraformFolders: this.terraformService.getFolderRecords(),
             version: 1,
         });
-        await Container.getInstance().get(OverlayDataRepository, { args: [true] });
     }
+    /**
+     * This function persists the in-memory resource state.
+     * The actual resource state is persisted as actual,
+     * and the current resource state is persisted as old.
+     *
+     * @internal
+     */
     async saveResourceState() {
         const actualSerializedOutput = await this.resourceSerializationService.serializeActualResources();
-        await this.stateManagementService.saveResourceState(this.actualResourceStateFileName, actualSerializedOutput, {
+        await this.stateManagementService.saveResourceState(this.stateManagementService.actualResourceStateFileName, actualSerializedOutput, {
+            terraformFolders: this.terraformService.getFolderRecords(),
+            terraformResources: this.terraformService.getOctoTerraformResourceMappings().map((m) => ({
+                ...(m.destroyLosesData ? { destroyLosesData: true } : {}),
+                moduleId: m.moduleId,
+                resourceContext: m.resourceContext,
+                resourceId: m.resourceId,
+                terraformAddresses: m.terraformAddresses,
+            })),
             version: 1,
         });
         const oldSerializedOutput = await this.resourceSerializationService.serializeNewResources();
-        await this.stateManagementService.saveResourceState(this.oldResourceStateFileName, oldSerializedOutput, {
+        await this.stateManagementService.saveResourceState(this.stateManagementService.oldResourceStateFileName, oldSerializedOutput, {
             version: 1,
         });
     }

package/dist/main.js.map

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

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

@@ -1,26 +1,62 @@
 import type { UnknownModel } from '../../app.type.js';
+import { Image } from '../image/image.model.js';
 import { AModel } from '../model.abstract.js';
 import { Region } from '../region/region.model.js';
 import { AccountSchema, AccountType } from './account.schema.js';
-type AwsCredentials = {
-    readonly accessKeyId: string;
-    readonly secretAccessKey: string;
-};
 /**
+ * An Account model is the cloud provider account the infrastructure below it is deployed into.
+ * It sits between the {@link App} and its {@link Region}s, so one app can span several accounts -
+ * e.g. a separate account per environment, or per cloud provider.
+ *
+ * Credentials are not held here. A module such as `AwsIniAccountModule` extends this model and
+ * supplies them through {@link Account.getCredentials}.
+ *
+ * @example
+ * ```ts
+ * const account = new Account(AccountType.AWS, '1234567890');
+ * app.addAccount(account);
+ * ```
+ *
  * @group Models/Account
+ *
+ * @see Definition of [Default Models](/docs/fundamentals/models#default-models).
  */
 export declare class Account extends AModel<AccountSchema, Account> {
     readonly accountId: string;
     readonly accountType: AccountType;
+    /**
+     * @param accountType The cloud provider this account belongs to.
+     * @param accountId The provider's own identifier for the account.
+     */
     constructor(accountType: AccountType, accountId: string);
+    /**
+     * @internal
+     */
+    static unSynth(account: AccountSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Account>;
+    /**
+     * To add an {@link Image}. The image is used only inside this account. A module links it to the
+     * regions it is published into, and those links leave the image's own place unchanged.
+     */
+    addImage(image: Image): void;
     /**
      * To add a {@link Region}.
      */
     addRegion(region: Region): void;
-    isAwsCredentials(credentials: ReturnType<Account['getCredentials']>): credentials is AwsCredentials;
+    /**
+     * The credentials this account authenticates with, for the paths octo drives itself rather than
+     * through a provider - an external resource's actions, most of all. The shape is the provider's
+     * own; octo only carries it from the model to whatever builds the client.
+     *
+     * @throws {@link ModelError} On the base model, which holds no credentials. Override it in the
+     * subclass a module creates.
+     */
     getCredentials(): object;
+    /**
+     * @internal
+     */
     setContext(): string | undefined;
+    /**
+     * @internal
+     */
     synth(): AccountSchema;
-    static unSynth(account: AccountSchema, deReferenceContext: (context: string) => Promise<UnknownModel>): Promise<Account>;
 }
-export {};