@quadnix/octo 0.0.30 → 0.2.0

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

@@ -0,0 +1,44 @@
+import type { UnknownResource } from '../app.type.js';
+import { type Diff } from '../functions/diff/diff.js';
+import type { TerraformModuleScope } from '../services/terraform/terraform.service.js';
+import { AResource } from './resource.abstract.js';
+import type { BaseResourceSchema } from './resource.schema.js';
+/**
+ * Base class for resources whose lifecycle is managed by Terraform.
+ *
+ * Subclasses implement `toHCL()` to contribute terraform resource blocks and outputs.
+ * Octo invokes `toHCL()` automatically while generating terraform files.
+ * The received scope is bound to the module folder this resource belongs to.
+ *
+ * Terraform resources cannot have resource actions; registering one throws.
+ *
+ * @example
+ * ```ts
+ * override async toHCL(terraform: TerraformModuleScope): Promise<void> {
+ *   const scope = terraform.addOctoTerraformResource(this, {
+ *     provider: { accountId: this.properties.awsAccountId, regionId: this.properties.awsRegionId },
+ *   });
+ *   const bucket = scope.addTerraformResource('aws_s3_bucket', this.resourceId, {
+ *     bucket: this.properties.bucketName,
+ *   });
+ *   scope.output({ arn: terraform.raw(`${bucket.address}.arn`) });
+ * }
+ * ```
+ *
+ * @group Resources
+ *
+ * @see {@link TerraformModuleScope} for what `toHCL()` can emit.
+ * @see Definition of [Resources](/docs/fundamentals/resources).
+ */
+export declare abstract class ATerraformResource<S extends BaseResourceSchema, T extends UnknownResource> extends AResource<S, T> {
+    /**
+     * @internal
+     */
+    diffInverse(diff: Diff, deReferenceResource: (context: string) => Promise<UnknownResource>): Promise<void>;
+    /**
+     * Emits this resource as terraform.
+     *
+     * @param terraform The module folder to write into, already scoped to this resource's module.
+     */
+    abstract toHCL(terraform: TerraformModuleScope): Promise<void> | void;
+}

package/dist/resources/terraform-resource.abstract.js

@@ -0,0 +1,45 @@
+import { DiffAction } from '../functions/diff/diff.js';
+import { AResource } from './resource.abstract.js';
+/**
+ * Base class for resources whose lifecycle is managed by Terraform.
+ *
+ * Subclasses implement `toHCL()` to contribute terraform resource blocks and outputs.
+ * Octo invokes `toHCL()` automatically while generating terraform files.
+ * The received scope is bound to the module folder this resource belongs to.
+ *
+ * Terraform resources cannot have resource actions; registering one throws.
+ *
+ * @example
+ * ```ts
+ * override async toHCL(terraform: TerraformModuleScope): Promise<void> {
+ *   const scope = terraform.addOctoTerraformResource(this, {
+ *     provider: { accountId: this.properties.awsAccountId, regionId: this.properties.awsRegionId },
+ *   });
+ *   const bucket = scope.addTerraformResource('aws_s3_bucket', this.resourceId, {
+ *     bucket: this.properties.bucketName,
+ *   });
+ *   scope.output({ arn: terraform.raw(`${bucket.address}.arn`) });
+ * }
+ * ```
+ *
+ * @group Resources
+ *
+ * @see {@link TerraformModuleScope} for what `toHCL()` can emit.
+ * @see Definition of [Resources](/docs/fundamentals/resources).
+ */
+export class ATerraformResource extends AResource {
+    /**
+     * @internal
+     */
+    async diffInverse(diff, deReferenceResource) {
+        if (diff.action === DiffAction.VALIDATE) {
+            return;
+        }
+        if (diff.field === 'resourceId' && diff.action === DiffAction.DELETE) {
+            this.remove(true);
+            return;
+        }
+        await this.cloneResourceInPlace(diff.node, deReferenceResource);
+    }
+}
+//# sourceMappingURL=terraform-resource.abstract.js.map

package/dist/resources/terraform-resource.abstract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terraform-resource.abstract.js","sourceRoot":"","sources":["../../src/resources/terraform-resource.abstract.ts"],"names":[],"mappings":"AACA,OAAO,EAAa,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAElE,OAAO,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAGnD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAgB,kBAA4E,SAAQ,SAGzG;IACC;;OAEG;IACM,KAAK,CAAC,WAAW,CACxB,IAAU,EACV,mBAAkE;QAElE,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,QAAQ,EAAE,CAAC;YACxC,OAAO;QACT,CAAC;QACD,IAAI,IAAI,CAAC,KAAK,KAAK,YAAY,IAAI,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,MAAM,EAAE,CAAC;YACrE,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAClB,OAAO;QACT,CAAC;QACD,MAAM,IAAI,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAS,EAAE,mBAAmB,CAAC,CAAC;IACvE,CAAC;CAQF"}

package/dist/services/event/event.service.d.ts

@@ -1,23 +1,50 @@
-import type { Constructable } from '../../app.type.js';
+import type { AbstractConstructable } from '../../app.type.js';
 import { Event } from '../../events/index.js';
 /**
  * @internal
  */
 export declare class EventService {
-    private readonly EVENT_BUFFER_SIZE;
+    private static instance;
     private readonly emitter;
+    private readonly EVENT_BUFFER_SIZE;
     private readonly eventBuffer;
-    private static instance;
     private readonly listeners;
+    /**
+     * @internal
+     */
     constructor();
+    /**
+     * @internal
+     */
+    static getInstance(): EventService;
+    /**
+     * @internal
+     */
     emit(event: Event<unknown>): void;
+    /**
+     * Emits an event and waits for every matching listener to settle, throwing the first failure.
+     * Unlike {@link emit}, which is fire-and-forget.
+     */
+    emitAndWait(event: Event<unknown>): Promise<void>;
+    /**
+     * @internal
+     */
     forwardEvent(event: Event<unknown>, listeners?: ((event: Event<unknown>) => Promise<any>)[]): void;
-    static getInstance(): EventService;
-    registerListeners(eventClass: Constructable<Event<unknown>>, target: any, descriptor: PropertyDescriptor): void;
+    /**
+     * @internal
+     */
+    registerListeners(eventClass: AbstractConstructable<Event<unknown>>, target: any, descriptor: PropertyDescriptor): void;
+    /**
+     * @internal
+     */
+    private bufferEvent;
 }
 /**
  * @internal
  */
 export declare class EventServiceFactory {
+    /**
+     * @internal
+     */
     static create(): Promise<EventService>;
 }

package/dist/services/event/event.service.js

@@ -12,27 +12,58 @@ import { Container } from '../../functions/container/container.js';
  * @internal
  */
 export class EventService {
+    /**
+     * @internal
+     */
     constructor() {
-        this.EVENT_BUFFER_SIZE = 50;
         this.emitter = new EventEmitter();
+        this.EVENT_BUFFER_SIZE = 50;
         this.eventBuffer = {};
         this.listeners = {};
         this.emitter.on('*', (event) => {
-            // Save event to EventBuffer.
-            if (!this.eventBuffer[event.constructor.name]) {
-                this.eventBuffer[event.constructor.name] = { eventClass: Object.getPrototypeOf(event).constructor, events: [] };
-            }
-            if (this.eventBuffer[event.constructor.name].events.length >= this.EVENT_BUFFER_SIZE) {
-                this.eventBuffer[event.constructor.name].events.shift();
-            }
-            this.eventBuffer[event.constructor.name].events.push(event);
+            this.bufferEvent(event);
             // Forward event to matching listeners.
             this.forwardEvent(event);
         });
     }
+    /**
+     * @internal
+     */
+    static getInstance() {
+        if (!this.instance) {
+            this.instance = new EventService();
+        }
+        return this.instance;
+    }
+    /**
+     * @internal
+     */
     emit(event) {
         this.emitter.emit('*', event);
     }
+    /**
+     * Emits an event and waits for every matching listener to settle, throwing the first failure.
+     * Unlike {@link emit}, which is fire-and-forget.
+     */
+    async emitAndWait(event) {
+        this.bufferEvent(event);
+        const pending = [];
+        for (const eventClassName of Object.keys(this.listeners)) {
+            if (event instanceof this.listeners[eventClassName].eventClass) {
+                for (const listener of this.listeners[eventClassName].eventListeners) {
+                    pending.push(listener(event));
+                }
+            }
+        }
+        const results = await Promise.allSettled(pending);
+        const failure = results.find((result) => result.status === 'rejected');
+        if (failure) {
+            throw failure.reason;
+        }
+    }
+    /**
+     * @internal
+     */
     forwardEvent(event, listeners = []) {
         if (!listeners.length) {
             for (const eventClassName of Object.keys(this.listeners)) {
@@ -53,13 +84,9 @@ export class EventService {
             }
         }
     }
-    static getInstance() {
-        if (!this.instance) {
-            this.instance = new EventService();
-        }
-        return this.instance;
-    }
-    // TODO: https://github.com/quadnix/octo/issues/6
+    /**
+     * @internal
+     */
     registerListeners(eventClass, target, descriptor) {
         if (!this.listeners[eventClass.name]) {
             this.listeners[eventClass.name] = { eventClass, eventListeners: [] };
@@ -84,11 +111,26 @@ export class EventService {
             }
         }
     }
+    /**
+     * @internal
+     */
+    bufferEvent(event) {
+        if (!this.eventBuffer[event.constructor.name]) {
+            this.eventBuffer[event.constructor.name] = { eventClass: Object.getPrototypeOf(event).constructor, events: [] };
+        }
+        if (this.eventBuffer[event.constructor.name].events.length >= this.EVENT_BUFFER_SIZE) {
+            this.eventBuffer[event.constructor.name].events.shift();
+        }
+        this.eventBuffer[event.constructor.name].events.push(event);
+    }
 }
 /**
  * @internal
  */
 let EventServiceFactory = class EventServiceFactory {
+    /**
+     * @internal
+     */
     static async create() {
         return EventService.getInstance();
     }

package/dist/services/event/event.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.service.js","sourceRoot":"","sources":["../../../src/services/event/event.service.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"event.service.js","sourceRoot":"","sources":["../../../src/services/event/event.service.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAEtC,OAAO,EAAE,OAAO,EAAE,MAAM,uCAAuC,CAAC;AAChE,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,wCAAwC,CAAC;AAEnE;;GAEG;AACH,MAAM,OAAO,YAAY;IAkBvB;;OAEG;IACH;QAlBiB,YAAO,GAAG,IAAI,YAAY,EAAE,CAAC;QAE7B,sBAAiB,GAAG,EAAE,CAAC;QAEvB,gBAAW,GAExB,EAAE,CAAC;QAEU,cAAS,GAKtB,EAAE,CAAC;QAML,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,KAAqB,EAAE,EAAE;YAC7C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;YAExB,uCAAuC;YACvC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;QAC3B,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW;QAChB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,IAAI,CAAC,QAAQ,GAAG,IAAI,YAAY,EAAE,CAAC;QACrC,CAAC;QACD,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;IAED;;OAEG;IACH,IAAI,CAAC,KAAqB;QACxB,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,WAAW,CAAC,KAAqB;QACrC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC;QAExB,MAAM,OAAO,GAAuB,EAAE,CAAC;QACvC,KAAK,MAAM,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,IAAI,KAAK,YAAY,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,UAAU,EAAE,CAAC;gBAC/D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,cAAc,EAAE,CAAC;oBACrE,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC;gBAChC,CAAC;YACH,CAAC;QACH,CAAC;QAED,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAClD,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,EAAmC,EAAE,CAAC,MAAM,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC;QACxG,IAAI,OAAO,EAAE,CAAC;YACZ,MAAM,OAAO,CAAC,MAAM,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,YAAY,CAAC,KAAqB,EAAE,YAAyD,EAAE;QAC7F,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,KAAK,MAAM,cAAc,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;gBACzD,IAAI,KAAK,YAAY,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,UAAU,EAAE,CAAC;oBAC/D,KAAK,MAAM,QAAQ,IAAI,IAAI,CAAC,SAAS,CAAC,cAAc,CAAC,CAAC,cAAc,EAAE,CAAC;wBACrE,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;4BAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;wBACvB,CAAC,CAAC,CAAC;oBACL,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;aAAM,CAAC;YACN,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;gBACjC,QAAQ,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;oBAC9B,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACvB,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACH,iBAAiB,CACf,UAAiD,EACjD,MAAW,EACX,UAA8B;QAE9B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;YACrC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,cAAc,EAAE,EAAE,EAAE,CAAC;QACvE,CAAC;QAED,0BAA0B;QAC1B,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QACxC,UAAU,CAAC,KAAK,GAAG,KAAK,WAAW,GAAG,IAAsB;YAC1D,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,WAAW,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;YAC5E,OAAO,MAAM,cAAc,CAAC,KAAK,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QACpD,CAAC,CAAC;QACF,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;QAEtE,oFAAoF;QACpF,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACpC,KAAK,MAAM,sBAAsB,IAAI,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;YACnE,MAAM,kBAAkB,GAAG,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,UAAU,CAAC;YAC/E,IAAI,kBAAkB,CAAC,SAAS,YAAY,UAAU,IAAI,kBAAkB,KAAK,UAAU,EAAE,CAAC;gBAC5F,KAAK,MAAM,aAAa,IAAI,IAAI,CAAC,WAAW,CAAC,sBAAsB,CAAC,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;oBAClF,IAAI,gBAAgB,IAAI,aAAa,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;wBACvD,IAAI,CAAC,YAAY,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,cAAc,CAAC,CAAC;oBACnF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED;;OAEG;IACK,WAAW,CAAC,KAAqB;QACvC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,EAAE,CAAC;YAC9C,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,WAAW,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QAClH,CAAC;QACD,IAAI,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACrF,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;QAC1D,CAAC;QACD,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC9D,CAAC;CACF;AAED;;GAEG;AAEI,IAAM,mBAAmB,GAAzB,MAAM,mBAAmB;IAC9B;;OAEG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM;QACjB,OAAO,YAAY,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;CACF,CAAA;AAPY,mBAAmB;IAD/B,OAAO,CAAe,YAAY,CAAC;GACvB,mBAAmB,CAO/B"}

package/dist/services/input/input.service.d.ts

@@ -12,16 +12,54 @@ export declare class InputService {
     private models;
     private modules;
     private overlays;
+    private resourceCreators;
+    private resourceModels;
     private resources;
     private tags;
+    /**
+     * @internal
+     */
     constructor(overlayDataRepository: OverlayDataRepository, resourceDataRepository: ResourceDataRepository);
+    /**
+     * @internal
+     */
     getAllNodeKeys(moduleId: string): string[];
+    /**
+     * @internal
+     */
+    getCreatorFromResource(resource: UnknownResource): string | undefined;
+    /**
+     * @internal
+     */
     getMetadataKeys(moduleId: string): string[];
+    /**
+     * @internal
+     */
+    getModelsFromResource(resource: UnknownResource): string[];
+    /**
+     * @internal
+     */
     getModule<M extends UnknownModule>(moduleId: string): M | undefined;
-    getModuleIdFromModel(model: UnknownModel): string;
-    getModuleIdFromOverlay(overlay: UnknownOverlay): string;
-    getModuleIdFromResource(resource: UnknownResource): string;
+    /**
+     * @internal
+     */
+    getModuleIdFromModel(model: UnknownModel): string | undefined;
+    /**
+     * @internal
+     */
+    getModuleIdFromOverlay(overlay: UnknownOverlay): string | undefined;
+    /**
+     * @internal
+     */
+    getModuleIdFromResource(resource: UnknownResource): string | undefined;
+    /**
+     * @internal
+     */
     getModuleResources(moduleId: string): UnknownResource[];
+    /**
+     * Returns the root model of the graph - the one and only `App` registered by any module.
+     */
+    getRootModel(): UnknownModel;
     /**
      * Registers the inputs passed to an instance of module.
      * It maps the input key provided to the module with the input value.
@@ -29,12 +67,18 @@ export declare class InputService {
      * another input, module, overlay, or resource.
      */
     registerInput(moduleId: string, key: string, value: unknown): void;
+    /**
+     * @internal
+     */
     registerMetadata(moduleId: string, key: string, value: unknown): void;
     /**
      * Registers the model generated by an instance of module.
      * The key is a reference to the model generated by the module, and maps directly to the model instance.
      */
     registerModel(moduleId: string, model: UnknownModel): void;
+    /**
+     * @internal
+     */
     registerModule(moduleId: string, module: UnknownModule): void;
     /**
      * Registers the overlay generated by an instance of module.
@@ -43,9 +87,20 @@ export declare class InputService {
     registerOverlay(moduleId: string, overlay: UnknownOverlay): void;
     /**
      * Registers the resource generated by an instance of module.
-     * The key is a reference to the resource generated by the module, and maps to the resource context.
+     * The key is a reference to the resource generated by the module, by its `localResourceId`, and maps
+     * to the resource context. A module's resources must have distinct `localResourceId`s, even in
+     * different scopes, since the module's actions find them by it. The `node` is the model or overlay
+     * whose action created the resource; a resource made outside an action has none.
+     */
+    registerResource(moduleId: string, resource: UnknownResource, node?: UnknownModel | UnknownOverlay): void;
+    /**
+     * Records that the action of a model or overlay produced a resource, which may already have been
+     * produced by another.
+     */
+    registerResourceModel(resource: UnknownResource, node: UnknownModel | UnknownOverlay): void;
+    /**
+     * @internal
      */
-    registerResource(moduleId: string, resource: UnknownResource): void;
     registerTag(scope: true | {
         moduleId: string;
     } | {
@@ -54,7 +109,20 @@ export declare class InputService {
     }, tags: {
         [key: string]: string;
     }): void;
+    /**
+     * @internal
+     */
     resolve(key: string): unknown | undefined;
+    /**
+     * Whether the model, overlay or resource a key such as `module.model.region` names exists.
+     */
+    private hasNode;
+    /**
+     * Refuses an input pointing to what does not exist. A module's models, overlays and resources exist
+     * once it has run, and modules run in the order of their types, so the usual cause is a module
+     * whose type is ordered after the type of the module referring to it.
+     */
+    private refuseMissingReference;
     /**
      * Given an input key, returns the resolved input key.
      * An input key is resolved when the value is not a pointer to another input.
@@ -63,7 +131,13 @@ export declare class InputService {
      * This method traverses the value of the input key recursively until it is resolved.
      */
     private resolveInputKey;
+    /**
+     * @internal
+     */
     private resolveInputValue;
+    /**
+     * @internal
+     */
     private resolveObjectPath;
 }
 /**
@@ -71,5 +145,8 @@ export declare class InputService {
  */
 export declare class InputServiceFactory {
     private static instance;
+    /**
+     * @internal
+     */
     static create(forceNew?: boolean): Promise<InputService>;
 }