@ariestools/sdk 7.0.7 → 7.0.8

package/dist/neutral/modules/assert/assertDefinedEx.d.ts

@@ -0,0 +1,41 @@
+import type { AssertExErrorFunc, AssertExMessageFunc } from './types.js';
+/**
+ * Asserts that a value is defined (not undefined) and returns the value.
+ * Throws an error if the value is undefined.
+ *
+ * @template T - The type of value to check
+ * @param expr - Expression to be evaluated for being defined
+ * @param messageFunc - Function that returns a message for the error if expression is undefined
+ * @throws Error with the message returned by messageFunc
+ * @returns The value of the expression (guaranteed to be defined)
+ * @example
+ * ```typescript
+ * // Simple usage with a message function
+ * const value = assertDefinedEx(possiblyUndefined, () => 'Value must be defined')
+ *
+ * // Using with type narrowing
+ * const config: Config | undefined = loadConfig()
+ * const safeConfig = assertDefinedEx(config, () => 'Config failed to load')
+ * // safeConfig is now type Config (not Config | undefined)
+ * ```
+ */
+declare function assertDefinedEx<T>(expr: T | undefined, messageFunc?: AssertExMessageFunc<T>): T;
+/**
+ * Asserts that a value is defined (not undefined) and returns the value.
+ * Throws a custom error if the value is undefined.
+ *
+ * @template T - The type of value to check
+ * @template R - The type of error to throw
+ * @param expr - Expression to be evaluated for being defined
+ * @param errorFunc - Function that returns a custom error instance if expression is undefined
+ * @throws Custom error returned by errorFunc
+ * @returns The value of the expression (guaranteed to be defined)
+ * @example
+ * ```typescript
+ * // Using with a custom error
+ * const user = assertDefinedEx(getUser(), () => new UserNotFoundError('User not found'))
+ * ```
+ */
+declare function assertDefinedEx<T, R extends Error>(expr: T | undefined, errorFunc?: AssertExErrorFunc<T, R>): T;
+export { assertDefinedEx };
+//# sourceMappingURL=assertDefinedEx.d.ts.map

package/dist/neutral/modules/assert/assertDefinedEx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertDefinedEx.d.ts","sourceRoot":"","sources":["../../../../src/modules/assert/assertDefinedEx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,eAAe,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAEzF;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,eAAe,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAqBzG,OAAO,EAAE,eAAe,EAAE,CAAA"}

package/dist/neutral/modules/assert/assertEx.d.ts

@@ -0,0 +1,41 @@
+import type { AssertExErrorFunc, AssertExMessageFunc } from './types.js';
+/**
+ * Asserts that an expression is truthy and returns the value.
+ * Throws an error if the expression is falsy.
+ *
+ * @template T - The type of value to check
+ * @param expr - Expression to be evaluated for truthiness
+ * @param messageFunc - Function that returns a message for the error if expression is falsy
+ * @throws Error with the message returned by messageFunc
+ * @returns The value of the expression (guaranteed to be truthy)
+ * @example
+ * ```typescript
+ * // Simple usage with a message function
+ * const value = assertEx(possiblyFalsy, () => 'Value must be truthy')
+ *
+ * // Using with type narrowing
+ * const config: Config | null = loadConfig()
+ * const safeConfig = assertEx(config, () => 'Config failed to load')
+ * // safeConfig is now type Config (not Config | null)
+ * ```
+ */
+declare function assertEx<T>(expr: T | null | undefined, messageFunc?: AssertExMessageFunc<T>): T;
+/**
+ * Asserts that an expression is truthy and returns the value.
+ * Throws a custom error if the expression is falsy.
+ *
+ * @template T - The type of value to check
+ * @template R - The type of error to throw
+ * @param expr - Expression to be evaluated for truthiness
+ * @param errorFunc - Function that returns a custom error instance if expression is falsy
+ * @throws Custom error returned by errorFunc
+ * @returns The value of the expression (guaranteed to be truthy)
+ * @example
+ * ```typescript
+ * // Using with a custom error
+ * const user = assertEx(getUser(), () => new UserNotFoundError('User not found'))
+ * ```
+ */
+declare function assertEx<T, R extends Error>(expr: T | null | undefined, errorFunc?: AssertExErrorFunc<T, R>): T;
+export { assertEx };
+//# sourceMappingURL=assertEx.d.ts.map

package/dist/neutral/modules/assert/assertEx.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"assertEx.d.ts","sourceRoot":"","sources":["../../../../src/modules/assert/assertEx.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAA;AAExE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,WAAW,CAAC,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;AAEzF;;;;;;;;;;;;;;;GAeG;AACH,iBAAS,QAAQ,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,GAAG,SAAS,EAAE,SAAS,CAAC,EAAE,iBAAiB,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAA;AAoBzG,OAAO,EAAE,QAAQ,EAAE,CAAA"}

package/dist/neutral/modules/assert/index.d.ts

@@ -0,0 +1,4 @@
+export * from './assertDefinedEx.js';
+export * from './assertEx.js';
+export type * from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/neutral/modules/assert/index.d.ts.map

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

package/dist/neutral/modules/assert/model.d.ts

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

package/dist/neutral/modules/assert/model.d.ts.map

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

package/dist/neutral/modules/assert/types.d.ts

@@ -0,0 +1,36 @@
+/**
+ * @internal
+ * A function that takes a possibly null or undefined value and returns an error message string.
+ * Used in assertion functions to provide custom error messages.
+ *
+ * @internal
+ * @template T - The type of value being asserted
+ * @param value - The value being asserted (may be null or undefined)
+ * @returns A string message to be used in the error thrown by the assertion
+ * @example
+ * ```typescript
+ * const messageFunc: AssertExMessageFunc<User> = (user) =>
+ *   `User ${user ? user.id : 'unknown'} is not valid or accessible`
+ * ```
+ */
+export type AssertExMessageFunc<T> = (value?: T | null) => string;
+/**
+ * A function that takes a possibly null or undefined value and returns a custom error instance.
+ * Used in assertion functions to provide specific error types with custom properties.
+ *
+ * @internal
+ * @template T - The type of value being asserted
+ * @template R - The specific error type to be returned, must extend Error
+ * @param value - The value being asserted (may be null or undefined)
+ * @returns An instance of the custom error type
+ * @example
+ * ```typescript
+ * const errorFunc: AssertExErrorFunc<User, UserNotFoundError> = (user) =>
+ *   new UserNotFoundError(`User ${user?.id || 'unknown'} not found`, {
+ *     userId: user?.id,
+ *     timestamp: new Date()
+ *   })
+ * ```
+ */
+export type AssertExErrorFunc<T, R extends Error> = (value?: T | null) => R;
+//# sourceMappingURL=types.d.ts.map

package/dist/neutral/modules/assert/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/modules/assert/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,MAAM,CAAA;AAEjE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,EAAE,CAAC,SAAS,KAAK,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,IAAI,KAAK,CAAC,CAAA"}

package/dist/neutral/modules/base/Base.d.ts

@@ -0,0 +1,53 @@
+import type { Meter, MeterProvider, Tracer, TracerProvider } from '@opentelemetry/api';
+import type { Logger } from '../logger/index.js';
+import type { EmptyObject } from '../object/index.js';
+/** Branded string type representing a class name used for global instance tracking. */
+export type BaseClassName = string & {
+    __baseClassName: true;
+};
+/** Common parameter fields available to all Base instances (logger, meter, tracer). */
+export interface BaseParamsFields {
+    logger?: Logger;
+    meterProvider?: MeterProvider;
+    traceProvider?: TracerProvider;
+}
+/** Parameters for constructing a Base instance, combining BaseParamsFields with optional additional params. */
+export type BaseParams<TAdditionalParams extends EmptyObject = EmptyObject> = TAdditionalParams & BaseParamsFields;
+/**
+ * Abstract base class providing logging, telemetry, and global instance tracking with WeakRef-based GC.
+ * @typeParam TParams - The parameter type, extending BaseParams
+ */
+export declare abstract class Base<TParams extends BaseParams = BaseParams> {
+    static defaultLogger?: Logger;
+    static readonly globalInstances: Record<BaseClassName, WeakRef<Base>[]>;
+    static readonly globalInstancesCountHistory: Record<BaseClassName, number[]>;
+    private static _historyInterval;
+    private static _historyTime;
+    private static _historyTimeout?;
+    private static _lastGC;
+    private static _maxGcFrequency;
+    private _params;
+    constructor(params: BaseParams<TParams>);
+    static get historyInterval(): number;
+    static set historyInterval(value: number);
+    static get historyTime(): number;
+    static set historyTime(value: number);
+    static get maxGcFrequency(): number;
+    static set maxGcFrequency(value: number);
+    static get maxHistoryDepth(): number;
+    get logger(): Logger | undefined;
+    get meter(): Meter | undefined;
+    get params(): BaseParams<TParams>;
+    get tracer(): Tracer | undefined;
+    static gc(force?: boolean): void;
+    static gc(className: BaseClassName): void;
+    static instanceCount(className: BaseClassName): number;
+    static instanceCounts(): Record<BaseClassName, number>;
+    static startHistory(): void;
+    static stopHistory(): void;
+    private static addToHistory;
+    private static gcAll;
+    private static gcClass;
+    private recordInstance;
+}
+//# sourceMappingURL=Base.d.ts.map

package/dist/neutral/modules/base/Base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../../../src/modules/base/Base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAAE,MAAM,EAAE,cAAc,EACtC,MAAM,oBAAoB,CAAA;AAG3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,SAAS,CAAA;AAa1C,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,eAAe,EAAE,IAAI,CAAA;CAAE,CAAA;AAE9D,uFAAuF;AACvF,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,aAAa,CAAC,EAAE,cAAc,CAAA;CAC/B;AAED,+GAA+G;AAC/G,MAAM,MAAM,UAAU,CAAC,iBAAiB,SAAS,WAAW,GAAG,WAAW,IAAI,iBAAiB,GAAG,gBAAgB,CAAA;AAElH;;;GAGG;AACH,8BAAsB,IAAI,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IAChE,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAK;IAC5E,MAAM,CAAC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAK;IACjF,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA2B;IAC1D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAClD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAAe;IAC9C,OAAO,CAAC,MAAM,CAAC,OAAO,CAAI;IAC1B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAmB;IACjD,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;IAMvC,MAAM,KAAK,eAAe,IAIQ,MAAM,CAFvC;IAED,MAAM,KAAK,eAAe,CAAC,KAAK,EAAE,MAAM,EAGvC;IAED,MAAM,KAAK,WAAW,IAIQ,MAAM,CAFnC;IAED,MAAM,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAGnC;IAED,MAAM,KAAK,cAAc,IAIQ,MAAM,CAFtC;IAED,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,EAEtC;IAED,MAAM,KAAK,eAAe,WAEzB;IAED,IAAI,MAAM,uBAET;IAED,IAAI,KAAK,IAAI,KAAK,GAAG,SAAS,CAE7B;IAED,IAAI,MAAM,wBAET;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAChC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAWzC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM;IAItD,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;IAOtD,MAAM,CAAC,YAAY,IAAI,IAAI;IAiB3B,MAAM,CAAC,WAAW,IAAI,IAAI;IAS1B,OAAO,CAAC,MAAM,CAAC,YAAY;IAQ3B,OAAO,CAAC,MAAM,CAAC,KAAK;IAMpB,OAAO,CAAC,MAAM,CAAC,OAAO;IAKtB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/neutral/modules/base/globallyUnique.d.ts

@@ -0,0 +1,21 @@
+declare global {
+    interface ImportMeta {
+        url: string;
+    }
+    var xylabs: {
+        unique: Record<string, unknown>;
+        uniqueDisabled?: boolean;
+    };
+}
+/** Disables global uniqueness checks, allowing duplicate registrations without throwing. */
+export declare const disableGloballyUnique: () => void;
+/**
+ * Registers a value as globally unique under the given name and domain.
+ * Throws if a different value is already registered under the same key.
+ * @param name - The unique name or symbol
+ * @param value - The value to register
+ * @param domain - The namespace domain (default 'global')
+ * @returns The fully qualified unique name
+ */
+export declare const globallyUnique: (name: string | symbol, value: unknown, domain?: string) => string;
+//# sourceMappingURL=globallyUnique.d.ts.map

package/dist/neutral/modules/base/globallyUnique.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"globallyUnique.d.ts","sourceRoot":"","sources":["../../../../src/modules/base/globallyUnique.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,UAAU;QAClB,GAAG,EAAE,MAAM,CAAA;KACZ;IAED,IAAI,MAAM,EAAE;QACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,cAAc,CAAC,EAAE,OAAO,CAAA;KACzB,CAAA;CACF;AASD,4FAA4F;AAC5F,eAAO,MAAM,qBAAqB,YAEjC,CAAA;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,OAAO,EAAE,eAAiB,WAiBtF,CAAA"}

package/dist/neutral/modules/base/index.d.ts

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

package/dist/neutral/modules/base/index.d.ts.map

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

package/dist/neutral/modules/base/model.d.ts

@@ -0,0 +1,2 @@
+export type { BaseClassName, BaseParams, BaseParamsFields, } from './Base.js';
+//# sourceMappingURL=model.d.ts.map

package/dist/neutral/modules/base/model.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../../../src/modules/base/model.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,aAAa,EACb,UAAU,EACV,gBAAgB,GACjB,MAAM,WAAW,CAAA"}

package/dist/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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/neutral/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"}