@ariestools/sdk 7.0.7 → 7.0.8

package/dist/node/modules/creatable/AbstractCreatable.d.ts

@@ -0,0 +1,123 @@
+import type { EventData } from '../events/index.js';
+import { BaseEmitter } from '../events/index.js';
+import { type Logger } from '../logger/index.js';
+import type { Promisable } from '../promise/index.js';
+import type { SpanConfig } from '../telemetry/index.js';
+import { type Creatable, type CreatableFactory } from './Creatable.js';
+import type { CreatableInstance, CreatableName, CreatableParams, CreatableStatus, Labels, RequiredCreatableParams } from './model/index.js';
+/**
+ * Base class for objects that follow an asynchronous creation and lifecycle pattern.
+ * Instances must be created via the static `create` method rather than direct construction.
+ * Provides start/stop lifecycle management with status tracking and telemetry support.
+ */
+export declare class AbstractCreatable<TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> extends BaseEmitter<Partial<TParams & RequiredCreatableParams>, TEventData> {
+    /** Optional default logger for this instance. */
+    defaultLogger?: Logger;
+    protected _startPromise: Promisable<boolean> | undefined;
+    private _status;
+    private _statusMutex;
+    private _validatedParams?;
+    constructor(key: unknown, params: Partial<TParams & RequiredCreatableParams>);
+    /** The name identifier for this creatable instance. */
+    get name(): CreatableName;
+    /** The validated and merged parameters for this instance. */
+    get params(): TParams & RequiredCreatableParams;
+    /** Whether this instance can be started (must be in 'created' or 'stopped' status). */
+    get startable(): boolean;
+    /** The current lifecycle status of this instance, or null if not yet initialized. */
+    get status(): CreatableStatus | null;
+    /** The status reporter used to broadcast lifecycle changes. */
+    get statusReporter(): import('./model.js').CreatableStatusReporter<void> | undefined;
+    /**
+     * Asynchronously creates a new instance by processing params, constructing,
+     * and running both static and instance createHandlers.
+     * @param inParams - Optional partial parameters to configure the instance
+     * @returns The fully initialized instance
+     */
+    static create<T extends CreatableInstance>(this: Creatable<T>, inParams?: Partial<T['params']>): Promise<T>;
+    /**
+     * Static hook called during creation to perform additional initialization.
+     * Override in subclasses to customize post-construction setup.
+     * @param instance - The newly constructed instance
+     * @returns The instance, potentially modified
+     */
+    static createHandler<T extends CreatableInstance>(this: Creatable<T>, instance: T): Promisable<T>;
+    /**
+     * Static hook called during creation to validate and transform params.
+     * Override in subclasses to add default values or validation.
+     * @param params - The raw partial params provided to `create`
+     * @returns The processed params ready for construction
+     */
+    static paramsHandler<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>): Promisable<T['params']>;
+    /** Instance-level creation hook. Override in subclasses to perform setup after construction. */
+    createHandler(): Promisable<void>;
+    /**
+     * Validates and returns the merged params, ensuring required fields are present.
+     * Override in subclasses to add custom validation logic.
+     * @param params - The raw partial params to validate
+     * @returns The validated params
+     */
+    paramsValidator(params: Partial<TParams & RequiredCreatableParams>): TParams & RequiredCreatableParams;
+    /**
+     * Executes a function within a telemetry span.
+     * @param name - The span name
+     * @param fn - The function to execute within the span
+     */
+    span<T>(name: string, fn: () => T): T;
+    /**
+     * Executes an async function within a telemetry span.
+     * @param name - The span name
+     * @param fn - The async function to execute within the span
+     * @param config - Optional span configuration
+     */
+    spanAsync<T>(name: string, fn: () => Promise<T>, config?: SpanConfig): Promise<T>;
+    /**
+     * Starts the instance, transitioning through 'starting' to 'started' status.
+     * Thread-safe via mutex. Returns true if already started or started successfully.
+     */
+    start(): Promise<boolean>;
+    /**
+     * Checks whether this instance is currently started.
+     * Takes an action if not started, based on the notStartedAction parameter.
+     * @param notStartedAction - What to do if not started: 'error'/'throw' throws, 'warn'/'log' logs, 'none' is silent
+     * @returns True if started, false otherwise
+     */
+    started(notStartedAction?: 'error' | 'throw' | 'warn' | 'log' | 'none'): boolean;
+    /**
+     * Async version of `started` that can optionally auto-start the instance.
+     * @param notStartedAction - What to do if not started and auto-start is disabled
+     * @param tryStart - If true, attempts to start the instance automatically
+     * @returns True if the instance is or becomes started
+     */
+    startedAsync(notStartedAction?: 'error' | 'throw' | 'warn' | 'log' | 'none', tryStart?: boolean): Promise<boolean>;
+    /**
+     * Stops the instance, transitioning through 'stopping' to 'stopped' status.
+     * Thread-safe via mutex. Returns true if already stopped or stopped successfully.
+     */
+    stop(): Promise<boolean>;
+    /**
+     * Asserts that the given function has not been overridden in a subclass.
+     * Used to enforce the handler pattern (override `startHandler` not `start`).
+     */
+    protected _noOverride(functionName?: string): void;
+    /** Sets the lifecycle status and reports it via the status reporter. */
+    protected setStatus(value: Exclude<CreatableStatus, 'error'>, progress?: number): void;
+    protected setStatus(value: Extract<CreatableStatus, 'error'>, error?: Error): void;
+    /** Override in subclasses to define start behavior. Throw an error on failure. */
+    protected startHandler(): Promisable<void>;
+    /** Override in subclasses to define stop behavior. Throw an error on failure. */
+    protected stopHandler(): Promisable<void>;
+}
+/**
+ * Extends AbstractCreatable with a static `factory` method for creating
+ * pre-configured CreatableFactory instances.
+ */
+export declare class AbstractCreatableWithFactory<TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> extends AbstractCreatable<TParams, TEventData> {
+    /**
+     * Creates a factory that produces instances of this class with pre-configured params and labels.
+     * @param params - Default parameters for instances created by the factory
+     * @param labels - Labels to assign to created instances
+     */
+    static factory<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>, labels?: Labels): CreatableFactory<T>;
+}
+//# sourceMappingURL=AbstractCreatable.d.ts.map

package/dist/node/modules/creatable/AbstractCreatable.d.ts.map

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

package/dist/node/modules/creatable/Creatable.d.ts

@@ -0,0 +1,49 @@
+import type { Logger } from '../logger/index.js';
+import type { Promisable } from '../promise/index.js';
+import type { AbstractCreatable } from './AbstractCreatable.js';
+import type { CreatableInstance, CreatableParams, Labels, RequiredCreatableParams } from './model/index.js';
+/**
+ * A factory interface for creating instances of a Creatable with pre-configured parameters.
+ * Unlike the full Creatable, this only exposes the `create` method.
+ */
+export interface CreatableFactory<T extends CreatableInstance = CreatableInstance> extends Omit<Creatable<T>, 'create' | 'createHandler' | 'paramsHandler' | 'defaultLogger' | 'factory'> {
+    /** Creates a new instance, merging the provided params with the factory's defaults. */
+    create(this: CreatableFactory<T>, params?: Partial<T['params']>): Promise<T>;
+}
+/**
+ * Static interface for classes that support asynchronous creation.
+ * Provides the `create`, `createHandler`, and `paramsHandler` static methods
+ * used to construct instances through the creatable lifecycle.
+ */
+export interface Creatable<T extends CreatableInstance = CreatableInstance> {
+    /** Optional default logger shared across instances created by this class. */
+    defaultLogger?: Logger;
+    /** Constructs a new raw instance. Should not be called directly; use `create` instead. */
+    new (key: unknown, params: Partial<CreatableParams>): T & AbstractCreatable<T['params']>;
+    /** Asynchronously creates and initializes a new instance with the given params. */
+    create<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>): Promise<T>;
+    /** Hook called after construction to perform additional initialization on the instance. */
+    createHandler<T extends CreatableInstance>(this: Creatable<T>, instance: T): Promisable<T>;
+    /** Hook called to validate and transform params before instance construction. */
+    paramsHandler<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>): Promisable<T['params'] & RequiredCreatableParams>;
+}
+/** Extends Creatable with a `factory` method that produces pre-configured CreatableFactory instances. */
+export interface CreatableWithFactory<T extends CreatableInstance = CreatableInstance> extends Creatable<T> {
+    /** Creates a factory with the given default params and labels. */
+    factory<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>, labels?: Labels): CreatableFactory<T>;
+}
+/**
+ * Class annotation to be used to decorate Modules which support
+ * an asynchronous creation pattern
+ * @returns The decorated Module requiring it implement the members
+ * of the CreatableModule as statics properties/methods
+ */
+export declare function creatable<T extends CreatableInstance>(): <U extends Creatable<T>>(constructor: U) => void;
+/**
+ * Class annotation to be used to decorate Modules which support
+ * an asynchronous creation factory pattern
+ * @returns The decorated Module requiring it implement the members
+ * of the CreatableModule as statics properties/methods
+ */
+export declare function creatableFactory(): <U extends CreatableFactory>(constructor: U) => void;
+//# sourceMappingURL=Creatable.d.ts.map

package/dist/node/modules/creatable/Creatable.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Creatable.d.ts","sourceRoot":"","sources":["../../../../src/modules/creatable/Creatable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAE1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EACV,iBAAiB,EAAE,eAAe,EAAE,MAAM,EAC1C,uBAAuB,EACxB,MAAM,kBAAkB,CAAA;AAEzB;;;GAGG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAC/E,SAAQ,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,QAAQ,GAAG,eAAe,GAAG,eAAe,GAAG,eAAe,GAAG,SAAS,CAAC;IAEtG,uFAAuF;IACvF,MAAM,CACJ,IAAI,EAAE,gBAAgB,CAAC,CAAC,CAAC,EACzB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;CAC7C;AAED;;;;GAIG;AACH,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAExE,6EAA6E;IAC7E,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,0FAA0F;IAC1F,KAAI,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEvF,mFAAmF;IACnF,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAChC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAE5C,2FAA2F;IAC3F,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC,CAAA;IAEhB,iFAAiF;IACjF,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,GAAG,uBAAuB,CAAC,CAAA;CACxG;AAED,yGAAyG;AACzG,MAAM,WAAW,oBAAoB,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,SAAQ,SAAS,CAAC,CAAC,CAAC;IACzG,kEAAkE;IAClE,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACjC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7B,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAA;CACxC;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,iBAAiB,MAC3C,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,UAI/C;AAED;;;;;GAKG;AAEH,wBAAgB,gBAAgB,KACtB,CAAC,SAAS,gBAAgB,EAAE,aAAa,CAAC,UAInD"}

package/dist/node/modules/creatable/Factory.d.ts

@@ -0,0 +1,28 @@
+import { type Creatable, type CreatableFactory } from './Creatable.js';
+import type { CreatableInstance, Labels } from './model/index.js';
+/**
+ * A concrete factory that wraps a Creatable class with default parameters and labels.
+ * Instances are created by merging caller-provided params over the factory defaults.
+ */
+export declare class Factory<T extends CreatableInstance = CreatableInstance> implements CreatableFactory<T> {
+    /** The Creatable class this factory delegates creation to. */
+    creatable: Creatable<T>;
+    /** Default parameters merged into every `create` call. */
+    defaultParams?: Partial<T['params']>;
+    /** Labels identifying resources created by this factory. */
+    labels?: Labels;
+    constructor(creatable: Creatable<T>, params?: Partial<T['params']>, labels?: Labels);
+    /**
+     * Creates a new Factory instance with the given default params and labels.
+     * @param creatableModule - The Creatable class to wrap
+     * @param params - Default parameters for new instances
+     * @param labels - Labels to assign to created instances
+     */
+    static withParams<T extends CreatableInstance>(creatableModule: Creatable<T>, params?: Partial<T['params']>, labels?: Labels): Factory<T>;
+    /**
+     * Creates a new instance, merging the provided params over the factory defaults.
+     * @param params - Optional parameters to override the factory defaults
+     */
+    create(params?: Partial<T['params']>): Promise<T>;
+}
+//# sourceMappingURL=Factory.d.ts.map

package/dist/node/modules/creatable/Factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../../../src/modules/creatable/Factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,SAAS,EAAE,KAAK,gBAAgB,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,KAAK,EACV,iBAAiB,EAAE,MAAM,EAC1B,MAAM,kBAAkB,CAAA;AAEzB;;;GAGG;AACH,qBAAa,OAAO,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,YAAW,gBAAgB,CAAC,CAAC,CAAC;IAClG,8DAA8D;IAC9D,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAEvB,0DAA0D;IAC1D,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEpC,4DAA4D;IAC5D,MAAM,CAAC,EAAE,MAAM,CAAA;gBAGb,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,EACvB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7B,MAAM,GAAE,MAAW;IAOrB;;;;;OAKG;IACH,MAAM,CAAC,UAAU,CAAC,CAAC,SAAS,iBAAiB,EAC3C,eAAe,EAAE,SAAS,CAAC,CAAC,CAAC,EAC7B,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7B,MAAM,GAAE,MAAW;IAKrB;;;OAGG;IACH,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;CAOlD"}

package/dist/node/modules/creatable/index.d.ts

@@ -0,0 +1,5 @@
+export * from './AbstractCreatable.js';
+export * from './Creatable.js';
+export * from './Factory.js';
+export * from './model/index.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/creatable/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/creatable/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,gBAAgB,CAAA;AAC9B,cAAc,cAAc,CAAA;AAC5B,cAAc,kBAAkB,CAAA"}

package/dist/node/modules/creatable/lib/getFunctionName.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Extracts the function name from the call stack at the given depth.
+ * @param depth - The stack frame depth to inspect (default: 2)
+ * @returns The function name, or '\<unknown\>' if it cannot be determined
+ */
+export declare function getFunctionName(depth?: number): string;
+//# sourceMappingURL=getFunctionName.d.ts.map

package/dist/node/modules/creatable/lib/getFunctionName.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getFunctionName.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/lib/getFunctionName.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,KAAK,SAAI,UAiBxC"}

package/dist/node/modules/creatable/lib/getRootFunction.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Walks the prototype chain to find the root (base-most) definition of a named function.
+ * @param obj - The object to start searching from
+ * @param funcName - The name of the function to locate
+ * @returns The function from the highest prototype in the chain that defines it
+ */
+export declare function getRootFunction(obj: unknown, funcName: string): unknown;
+//# sourceMappingURL=getRootFunction.d.ts.map

package/dist/node/modules/creatable/lib/getRootFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRootFunction.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/lib/getRootFunction.ts"],"names":[],"mappings":"AAKA;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAUvE"}

package/dist/node/modules/creatable/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './getFunctionName.js';
+export * from './getRootFunction.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/creatable/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/lib/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAA;AACpC,cAAc,sBAAsB,CAAA"}

package/dist/node/modules/creatable/model/CreatableInstance.d.ts

@@ -0,0 +1,16 @@
+import type { EventData, EventEmitter } from '../../events/index.js';
+import type { CreatableName, CreatableParams } from './CreatableParams.js';
+/** Represents a created instance with a managed lifecycle (start/stop) and event emission. */
+export interface CreatableInstance<TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> extends EventEmitter<TEventData> {
+    /** The event data type associated with this instance. */
+    eventData: TEventData;
+    /** The name identifier for this instance. */
+    name: CreatableName;
+    /** The parameters used to configure this instance. */
+    params: TParams;
+    /** Starts the instance. Resolves to true if started successfully. */
+    start: () => Promise<boolean>;
+    /** Stops the instance. Resolves to true if stopped successfully. */
+    stop: () => Promise<boolean>;
+}
+//# sourceMappingURL=CreatableInstance.d.ts.map

package/dist/node/modules/creatable/model/CreatableInstance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableInstance.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/model/CreatableInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,YAAY,EAAE,MAAM,SAAS,CAAA;AAEtD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE1E,8FAA8F;AAC9F,MAAM,WAAW,iBAAiB,CAAC,OAAO,SAAS,eAAe,GAAG,eAAe,EAClF,UAAU,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,YAAY,CAAC,UAAU,CAAC;IAC1E,yDAAyD;IACzD,SAAS,EAAE,UAAU,CAAA;IACrB,6CAA6C;IAC7C,IAAI,EAAE,aAAa,CAAA;IACnB,sDAAsD;IACtD,MAAM,EAAE,OAAO,CAAA;IACf,qEAAqE;IACrE,KAAK,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;IAC7B,oEAAoE;IACpE,IAAI,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC7B"}

package/dist/node/modules/creatable/model/CreatableParams.d.ts

@@ -0,0 +1,16 @@
+import type { BaseClassName } from '../../base/index.js';
+import type { BaseEmitterParams } from '../../events/index.js';
+import type { CreatableStatus, CreatableStatusReporter } from './CreatableStatusReporter.js';
+/** A branded string type used as the name identifier for creatables. */
+export type CreatableName = Exclude<string, 'creatable-name-reserved-32546239486'> & BaseClassName;
+/** The minimum required parameters for constructing a creatable. */
+export interface RequiredCreatableParams<TAdditionalStatus extends CreatableStatus | void = void> extends BaseEmitterParams {
+    /** Optional name identifying this creatable instance. */
+    name?: CreatableName;
+    /** Optional reporter for broadcasting status changes. */
+    statusReporter?: CreatableStatusReporter<TAdditionalStatus>;
+}
+/** Parameters for creating a creatable instance, combining required params with emitter params. */
+export interface CreatableParams extends RequiredCreatableParams, BaseEmitterParams {
+}
+//# sourceMappingURL=CreatableParams.d.ts.map

package/dist/node/modules/creatable/model/CreatableParams.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableParams.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/model/CreatableParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAC1C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAA;AAEhD,OAAO,KAAK,EAAE,eAAe,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAE5F,wEAAwE;AACxE,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,qCAAqC,CAAC,GAAG,aAAa,CAAA;AAElG,oEAAoE;AACpE,MAAM,WAAW,uBAAuB,CAAC,iBAAiB,SAAS,eAAe,GAAG,IAAI,GAAG,IAAI,CAAE,SAAQ,iBAAiB;IACzH,yDAAyD;IACzD,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,yDAAyD;IACzD,cAAc,CAAC,EAAE,uBAAuB,CAAC,iBAAiB,CAAC,CAAA;CAC5D;AAED,mGAAmG;AACnG,MAAM,WAAW,eAAgB,SAAQ,uBAAuB,EAAE,iBAAiB;CAAG"}

package/dist/node/modules/creatable/model/CreatableStatusReporter.d.ts

@@ -0,0 +1,15 @@
+import type { BaseClassName } from '../../base/index.js';
+/** The standard lifecycle statuses a creatable can transition through. */
+export type StandardCreatableStatus = 'creating' | 'created' | 'starting' | 'started' | 'stopping' | 'stopped' | 'error';
+/** A creatable's status, optionally extended with additional custom status values. */
+export type CreatableStatus<TAdditionalStatus extends void | string = void> = StandardCreatableStatus | (TAdditionalStatus extends void ? StandardCreatableStatus : TAdditionalStatus);
+/** Reports status changes for a creatable, supporting progress tracking and error reporting. */
+export interface CreatableStatusReporter<TAdditionalStatus extends void | string = void> {
+    /** Report a non-error status with a numeric progress value. */
+    report(name: BaseClassName, status: Exclude<CreatableStatus<TAdditionalStatus>, 'error'>, progress: number): void;
+    /** Report an error status with the associated Error. */
+    report(name: BaseClassName, status: Extract<CreatableStatus<TAdditionalStatus>, 'error'>, error: Error): void;
+    /** Report a status change without progress or error details. */
+    report(name: BaseClassName, status: CreatableStatus<TAdditionalStatus>): void;
+}
+//# sourceMappingURL=CreatableStatusReporter.d.ts.map

package/dist/node/modules/creatable/model/CreatableStatusReporter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableStatusReporter.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/model/CreatableStatusReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAA;AAE1C,0EAA0E;AAC1E,MAAM,MAAM,uBAAuB,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;AAExH,sFAAsF;AACtF,MAAM,MAAM,eAAe,CAAC,iBAAiB,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI,IACtE,uBAAuB,GAAG,CAAC,iBAAiB,SAAS,IAAI,GAAG,uBAAuB,GAAG,iBAAiB,CAAC,CAAA;AAE5G,gGAAgG;AAChG,MAAM,WAAW,uBAAuB,CAAC,iBAAiB,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI;IACrF,+DAA+D;IAC/D,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC,EAAE,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAA;IACjH,wDAAwD;IACxD,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAC,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IAC7G,gEAAgE;IAChE,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,CAAC,iBAAiB,CAAC,GAAG,IAAI,CAAA;CAC9E"}

package/dist/node/modules/creatable/model/Labels.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Object used to represent labels identifying a resource.
+ */
+export type Labels = Record<string, string | undefined>;
+/**
+ * Interface for objects that have labels.
+ */
+export interface WithLabels<T extends Labels = Labels> {
+    labels: T;
+}
+/**
+ * Interface for objects that have labels.
+ */
+export interface WithOptionalLabels<T extends Labels = Labels> {
+    labels?: T;
+}
+/**
+ * Returns true if the source object has all the labels from the required set
+ * @param source Source object to check against
+ * @param required Set of labels to check for in source
+ * @returns True of the source object has all the labels from the required set
+ */
+export declare const hasAllLabels: (source?: Labels, required?: Labels) => boolean;
+//# sourceMappingURL=Labels.d.ts.map

package/dist/node/modules/creatable/model/Labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Labels.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/model/Labels.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAA;AAEvD;;GAEG;AACH,MAAM,WAAW,UAAU,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IACnD,MAAM,EAAE,CAAC,CAAA;CACV;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM;IAC3D,MAAM,CAAC,EAAE,CAAC,CAAA;CACX;AAED;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,MAAM,EAAE,WAAW,MAAM,KAAG,OAKjE,CAAA"}

package/dist/node/modules/creatable/model/index.d.ts

@@ -0,0 +1,5 @@
+export * from './CreatableInstance.js';
+export * from './CreatableParams.js';
+export * from './CreatableStatusReporter.js';
+export * from './Labels.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/creatable/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/modules/creatable/model/index.ts"],"names":[],"mappings":"AAAA,cAAc,wBAAwB,CAAA;AACtC,cAAc,sBAAsB,CAAA;AACpC,cAAc,8BAA8B,CAAA;AAC5C,cAAc,aAAa,CAAA"}

package/dist/node/modules/creatable/model.d.ts

@@ -0,0 +1,3 @@
+export type * from './Creatable.js';
+export type * from './model/index.js';
+//# sourceMappingURL=model.d.ts.map

package/dist/node/modules/creatable/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/modules/creatable/model.ts"],"names":[],"mappings":"AAAA,mBAAmB,gBAAgB,CAAA;AACnC,mBAAmB,kBAAkB,CAAA"}

package/dist/node/modules/decimal-precision/fromFixedPoint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts a fixed-point bigint back to a whole-number bigint by dividing out the decimal places.
+ * @param value - The fixed-point bigint value to convert
+ * @param places - Number of decimal places (default 18)
+ * @returns The whole-number bigint result
+ */
+export declare const fromFixedPoint: (value: bigint, places?: number) => bigint;
+//# sourceMappingURL=fromFixedPoint.d.ts.map

package/dist/node/modules/decimal-precision/fromFixedPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fromFixedPoint.d.ts","sourceRoot":"","sources":["../../../../src/modules/decimal-precision/fromFixedPoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,cAAc,GAAI,OAAO,MAAM,EAAE,eAAW,KAAG,MAG3D,CAAA"}

package/dist/node/modules/decimal-precision/index.d.ts

@@ -0,0 +1,4 @@
+export * from './fromFixedPoint.js';
+export * from './toDecimalPrecision.js';
+export * from './toFixedPoint.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/decimal-precision/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/decimal-precision/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAA;AACnC,cAAc,yBAAyB,CAAA;AACvC,cAAc,mBAAmB,CAAA"}

package/dist/node/modules/decimal-precision/toDecimalPrecision.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Formats a number to the specified number of significant digits, returning a string with minimal trailing zeros.
+ * @param value - The number to format
+ * @param digits - The number of significant digits
+ * @returns A string representation of the number with the specified precision
+ */
+export declare const toDecimalPrecision: (value: number, digits: number) => string;
+//# sourceMappingURL=toDecimalPrecision.d.ts.map

package/dist/node/modules/decimal-precision/toDecimalPrecision.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toDecimalPrecision.d.ts","sourceRoot":"","sources":["../../../../src/modules/decimal-precision/toDecimalPrecision.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,MAAM,EAAE,QAAQ,MAAM,WAO/D,CAAA"}

package/dist/node/modules/decimal-precision/toFixedPoint.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Converts a bigint or decimal string to a fixed-point bigint representation.
+ * @param value - The value to convert (bigint or string with optional decimal point)
+ * @param places - Number of decimal places (default 18)
+ * @returns A bigint representing the value scaled by 10^places
+ */
+export declare const toFixedPoint: (value: bigint | string, places?: number) => bigint;
+//# sourceMappingURL=toFixedPoint.d.ts.map

package/dist/node/modules/decimal-precision/toFixedPoint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"toFixedPoint.d.ts","sourceRoot":"","sources":["../../../../src/modules/decimal-precision/toFixedPoint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,YAAY,GAAI,OAAO,MAAM,GAAG,MAAM,EAAE,eAAW,KAAG,MAelE,CAAA"}

package/dist/node/modules/delay/delay.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Returns a promise that resolves after the specified number of milliseconds.
+ * @param ms - The number of milliseconds to delay.
+ * @returns A promise that resolves after the delay.
+ */
+export declare const delay: (ms: number) => Promise<void>;
+//# sourceMappingURL=delay.d.ts.map

package/dist/node/modules/delay/delay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"delay.d.ts","sourceRoot":"","sources":["../../../../src/modules/delay/delay.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,eAAO,MAAM,KAAK,GAAI,IAAI,MAAM,kBAE/B,CAAA"}

package/dist/node/modules/delay/index.d.ts

@@ -0,0 +1,2 @@
+export { delay } from './delay.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/delay/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/delay/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA"}

package/dist/node/modules/ellipsize/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Truncates a string to show the first and last `length` characters separated by an ellipsis.
+ * @param value - The string to ellipsize
+ * @param length - Number of characters to keep at each end (default 2)
+ * @returns The ellipsized string
+ */
+export declare const ellipsize: (value: string, length?: number) => string;
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/ellipsize/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/ellipsize/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,eAAO,MAAM,SAAS,GAAI,OAAO,MAAM,EAAE,eAAU,KAAG,MAIrD,CAAA"}

package/dist/node/modules/enum/Enum.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Transforms a given record object into a readonly "enum-like" structure while preserving
+ * the literal types of its values. This allows you to use the returned object both at runtime
+ * (for lookups) and at compile time (for strongly typed values).
+ *
+ * To maintain literal types (i.e., prevent them from being widened to `string`, `number`, etc.),
+ * ensure you annotate your object with `as const` before passing it to `Enum`.
+ *
+ * @template T - A record type with string keys and any kind of values.
+ * @param obj - A readonly record object annotated with `as const`.
+ * @returns A readonly version of the provided record, preserving exact literal value types.
+ *
+ * @example
+ * ```typescript
+ * // Defining a record with literal types using as const:
+ * const DnsRecordType = Enum({
+ *   A: 1,
+ *   AAAA: 28,
+ *   CAA: 257,
+ *   CNAME: 5,
+ *   DNAME: 39,
+ *   MX: 15,
+ *   NS: 2,
+ *   PTR: 12,
+ *   SOA: 6,
+ *   SPF: 99,
+ *   SRV: 33,
+ *   TXT: 16,
+ * } as const);
+ *
+ * // DnsRecordType is now a readonly object:
+ * // {
+ * //   readonly A: 1;
+ * //   readonly AAAA: 28;
+ * //   readonly CAA: 257;
+ * //   readonly CNAME: 5;
+ * //   readonly DNAME: 39;
+ * //   readonly MX: 15;
+ * //   readonly NS: 2;
+ * //   readonly PTR: 12;
+ * //   readonly SOA: 6;
+ * //   readonly SPF: 99;
+ * //   readonly SRV: 33;
+ * //   readonly TXT: 16;
+ * // }
+ * ```
+ */
+export declare const Enum: <const T extends Record<string | number | symbol, unknown>>(obj: Readonly<T>) => Enum<T>;
+/**
+ * A utility type that, given a `Record<string, unknown>`, returns a readonly version
+ * of that record. This results in a type where all properties of `T` are readonly.
+ *
+ * @template T - The record type to make readonly.
+ *
+ * @example
+ * ```typescript
+ * // Given a record:
+ * export const DnsRecordType = Enum({
+ *   A: 1,
+ *   AAAA: 28,
+ *   CAA: 257,
+ *   CNAME: 5,
+ *   DNAME: 39,
+ *   MX: 15,
+ *   NS: 2,
+ *   PTR: 12,
+ *   SOA: 6,
+ *   SPF: 99,
+ *   SRV: 33,
+ *   TXT: 16,
+ * })
+ *
+ * // Now the type inference will preserve the literal types:
+ * export type DnsRecordType = Enum<typeof DnsRecordType>
+ * ```
+ */
+export type Enum<T extends Readonly<Record<string | number | symbol, unknown>>> = {
+    readonly [K in keyof T]: T[K];
+};
+/**
+ * A utility type that, given an `Enum` object, returns the union of its keys.
+ */
+export type EnumKey<T extends Record<string | number | symbol, unknown>, K = Enum<T>> = keyof K;
+/**
+ * A utility type that, given an `Enum` object, returns the union of its values.
+ */
+export type EnumValue<T extends Record<string | number | symbol, unknown>, K = Enum<T>> = K[keyof K];
+//# sourceMappingURL=Enum.d.ts.map

package/dist/node/modules/enum/Enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Enum.d.ts","sourceRoot":"","sources":["../../../../src/modules/enum/Enum.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8CG;AACH,eAAO,MAAM,IAAI,GAAI,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAG,IAAI,CAAC,CAAC,CAExG,CAAA;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,IAAI,CAAC,CAAC,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,CAAC,IAAI;IAChF,QAAQ,EAAE,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;CAC9B,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,OAAO,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,CAAA;AAE/F;;GAEG;AACH,MAAM,MAAM,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,EAAE,OAAO,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAA"}

package/dist/node/modules/enum/index.d.ts

@@ -0,0 +1,2 @@
+export * from './Enum.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/node/modules/enum/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/modules/enum/index.ts"],"names":[],"mappings":"AAAA,cAAc,WAAW,CAAA"}

package/dist/node/modules/enum/model.d.ts

@@ -0,0 +1,2 @@
+export type { Enum, EnumKey, EnumValue, } from './Enum.js';
+//# sourceMappingURL=model.d.ts.map

package/dist/node/modules/enum/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/modules/enum/model.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,IAAI,EACJ,OAAO,EACP,SAAS,GACV,MAAM,WAAW,CAAA"}

package/dist/node/modules/error/assert.d.ts

@@ -0,0 +1,12 @@
+type AssertCallback = (value: unknown, message: string) => string | boolean;
+/** Configuration for assertion behavior: a static message string, a boolean toggle, or a callback. */
+export type AssertConfig = string | AssertCallback | boolean;
+/**
+ * Throws an Error based on the assert configuration when a value fails validation.
+ * @param value - The value being validated
+ * @param assert - Assertion config controlling the error message
+ * @param defaultMessage - Fallback message if no custom message is provided
+ */
+export declare const assertError: (value: unknown, assert: AssertConfig | undefined, defaultMessage: string) => undefined;
+export {};
+//# sourceMappingURL=assert.d.ts.map

package/dist/node/modules/error/assert.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assert.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/assert.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAA;AAE3E,sGAAsG;AACtG,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,CAAA;AAE5D;;;;;GAKG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,OAAO,EAAE,QAAQ,YAAY,GAAG,SAAS,EAAE,gBAAgB,MAAM,cAcnG,CAAA"}

package/dist/node/modules/error/handleError.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Invokes the handler if the value is an Error, otherwise re-throws it.
+ * @param error - The caught value to inspect
+ * @param handler - Callback invoked with the Error if it is one
+ * @returns The handler's return value
+ */
+export declare const handleError: <T>(error: any, handler: (error: Error) => T) => T;
+/**
+ * Async version of handleError. Invokes the async handler if the value is an Error, otherwise re-throws it.
+ * @param error - The caught value to inspect
+ * @param handler - Async callback invoked with the Error if it is one
+ * @returns The handler's resolved return value
+ */
+export declare const handleErrorAsync: <T>(error: any, handler: (error: Error) => Promise<T>) => Promise<T>;
+//# sourceMappingURL=handleError.d.ts.map

package/dist/node/modules/error/handleError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleError.d.ts","sourceRoot":"","sources":["../../../../src/modules/error/handleError.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AAEH,eAAO,MAAM,WAAW,GAAI,CAAC,EAAE,OAAO,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,KAAK,CAAC,MAKtE,CAAA;AAED;;;;;GAKG;AAEH,eAAO,MAAM,gBAAgB,GAAU,CAAC,EAAE,OAAO,GAAG,EAAE,SAAS,CAAC,KAAK,EAAE,KAAK,KAAK,OAAO,CAAC,CAAC,CAAC,eAK1F,CAAA"}