@xylabs/creatable 4.12.33 → 4.12.34

package/dist/neutral/index.mjs

@@ -20,6 +20,36 @@ function creatable() {
     constructor;
   };
 }
+function creatableFactory() {
+  return (constructor) => {
+    constructor;
+  };
+}
+
+// src/Factory.ts
+var Factory = class _Factory {
+  creatable;
+  defaultParams;
+  labels;
+  constructor(creatable2, params, labels = {}) {
+    this.creatable = creatable2;
+    this.defaultParams = params;
+    this.labels = Object.assign({}, creatable2.labels ?? {}, labels ?? {});
+  }
+  static withParams(creatableModule, params, labels = {}) {
+    return new _Factory(creatableModule, params, labels);
+  }
+  create(params) {
+    const mergedParams = {
+      ...this.defaultParams,
+      ...params
+    };
+    return this.creatable.create(mergedParams);
+  }
+  factory(params, labels = {}) {
+    return new _Factory(this.creatable, params, labels);
+  }
+};
 
 // src/lib/getFunctionName.ts
 import { isNumber } from "@xylabs/typeof";
@@ -84,6 +114,9 @@ var AbstractCreatable = class extends BaseEmitter {
   static createHandler(instance) {
     return instance;
   }
+  static factory(params, labels) {
+    return Factory.withParams(this, params, labels);
+  }
   static paramsHandler(params = {}) {
     return { ...params };
   }
@@ -129,8 +162,18 @@ var AbstractCreatable = class extends BaseEmitter {
 AbstractCreatable = __decorateClass([
   creatable()
 ], AbstractCreatable);
+
+// src/model/Labels.ts
+var hasAllLabels = (source, required) => {
+  if (!required) return true;
+  return Object.entries(required).every(([key, value]) => {
+    return source?.hasOwnProperty(key) && source?.[key] === value;
+  });
+};
 export {
   AbstractCreatable,
-  creatable
+  creatable,
+  creatableFactory,
+  hasAllLabels
 };
 //# sourceMappingURL=index.mjs.map

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/AbstractCreatable.ts","../../src/Creatable.ts","../../src/lib/getFunctionName.ts","../../src/lib/getRootFunction.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type { EventData } from '@xylabs/events'\nimport { BaseEmitter } from '@xylabs/events'\nimport { type Logger } from '@xylabs/logger'\nimport type { Promisable } from '@xylabs/promise'\nimport { isError } from '@xylabs/typeof'\n\nimport { type Creatable, creatable } from './Creatable.ts'\nimport { getFunctionName, getRootFunction } from './lib/index.ts'\nimport type {\n  CreatableInstance, CreatableName, CreatableParams,\n} from './model/index.ts'\n\nconst AbstractCreatableConstructorKey = Symbol.for('AbstractCreatableConstructor')\n\n@creatable()\nexport class AbstractCreatable<TParams extends CreatableParams = CreatableParams,\n  TEventData extends EventData = EventData> extends BaseEmitter<Partial<TParams>, TEventData> {\n  defaultLogger?: Logger\n\n  private _validatedParams?: TParams\n\n  constructor(key: unknown, params: Partial<TParams>) {\n    assertEx(key === AbstractCreatableConstructorKey, () => 'AbstractCreatable should not be instantiated directly, use the static create method instead')\n    super(params)\n  }\n\n  get name(): CreatableName {\n    return this.params.name ?? this.constructor.name\n  }\n\n  override get params(): TParams {\n    this._validatedParams = this._validatedParams ?? this.paramsValidator(super.params)\n    return this._validatedParams\n  }\n\n  get statusReporter() {\n    return this.params.statusReporter\n  }\n\n  static async create<T extends CreatableInstance>(\n    this: Creatable<T>,\n    inParams: Partial<T['params']> = {},\n  ): Promise<T> {\n    const params = await this.paramsHandler(inParams)\n    const name: CreatableName = params.name ?? this.name\n    params.statusReporter?.report(name, 'creating')\n    try {\n      const instance = new this(AbstractCreatableConstructorKey, params)\n      const initializedInstance = await this.createHandler(instance)\n      await instance.createHandler()\n      params.statusReporter?.report(name, 'created')\n      return initializedInstance\n    } catch (ex) {\n      params.statusReporter?.report(name, 'error', isError(ex) ? ex : new Error(`Error creating: ${name}`))\n      throw isError(ex) ? ex : new Error(`Error creating: ${name}`)\n    }\n  }\n\n  static createHandler<T extends CreatableInstance>(\n    this: Creatable<T>,\n    instance: T,\n  ): Promisable<T> {\n    return instance\n  }\n\n  static paramsHandler<T extends CreatableInstance>(\n    this: Creatable<T>,\n    params: Partial<T['params']> = {},\n  ): Promisable<Partial<T['params']>> {\n    return { ...params }\n  }\n\n  createHandler(): Promisable<void> {}\n\n  paramsValidator(params: Partial<TParams>): TParams {\n    return { ...params, name: params.name ?? this.constructor.name } as TParams\n  }\n\n  async start(): Promise<boolean> {\n    this._noOverride('start')\n    try {\n      this.statusReporter?.report(this.name, 'starting')\n      await this.startHandler()\n      this.statusReporter?.report(this.name, 'started')\n      return true\n    } catch (ex) {\n      this.statusReporter?.report(this.name, 'error', isError(ex) ? ex : new Error(`Error stopping: ${ex}`))\n      return false\n    }\n  }\n\n  async stop(): Promise<boolean> {\n    this._noOverride('stop')\n    try {\n      this.statusReporter?.report(this.name, 'stopping')\n      await this.stopHandler()\n      this.statusReporter?.report(this.name, 'stopped')\n      return true\n    } catch (ex) {\n      this.statusReporter?.report(this.name, 'error', isError(ex) ? ex : new Error(`Error stopping: ${ex}`))\n      return false\n    }\n  }\n\n  protected _noOverride(functionName = getFunctionName(3)) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const thisFunc = (this as any)[functionName]\n\n    const rootFunc = getRootFunction(this, functionName)\n    assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)\n  }\n\n  protected startHandler(): Promisable<void> {\n    // when overriding this, throw an error on failure\n  }\n\n  protected stopHandler(): Promisable<void> {\n    // when overriding this, throw an error on failure\n  }\n}\n","import type { Logger } from '@xylabs/logger'\nimport type { Promisable } from '@xylabs/promise'\n\nimport type { AbstractCreatable } from './AbstractCreatable.ts'\nimport type { CreatableInstance, CreatableParams } from './model/index.ts'\n\n/*\nexport interface CreatableFactory<T extends EmptyObject | void = void,\n  TParams extends EmptyObject | void = void> {\n  create(params?: CreatableParams<TParams>): Promise<CreatableInstance<T>>\n}\n*/\n\nexport interface Creatable<T extends CreatableInstance = CreatableInstance> {\n\n  defaultLogger?: Logger\n\n  new(key: unknown, params: Partial<CreatableParams>): T & AbstractCreatable<T['params']>\n\n  create<T extends CreatableInstance>(\n    this: Creatable<T>,\n    params: Partial<T['params']>): Promise<T>\n\n  createHandler<T extends CreatableInstance>(\n    this: Creatable<T>,\n    instance: T\n  ): Promisable<T>\n\n  paramsHandler<T extends CreatableInstance>(\n    this: Creatable<T>, params?: Partial<T['params']>): Promisable<Partial<T['params']>>\n\n  /*\n  factory<T extends EmptyObject | void = void,\n    TParams extends EmptyObject | void = void> (this: Creatable<T, TParams>, params: Partial<CreatableParams<TParams>>): CreatableFactory<T, TParams>\n  */\n}\n\n/**\n * Class annotation to be used to decorate Modules which support\n * an asynchronous creation pattern\n * @returns The decorated Module requiring it implement the members\n * of the CreatableModule as statics properties/methods\n */\nexport function creatable<T extends CreatableInstance>() {\n  return <U extends Creatable<T>>(constructor: U) => {\n    // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n    constructor\n  }\n}\n\n/**\n * Class annotation to be used to decorate Modules which support\n * an asynchronous creation factory pattern\n * @returns The decorated Module requiring it implement the members\n * of the CreatableModule as statics properties/methods\n */\n\n/*\nexport function creatableFactory() {\n  return <U extends CreatableFactory>(constructor: U) => {\n    // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n    constructor\n  }\n}\n*/\n","import { isNumber } from '@xylabs/typeof'\n\nexport function getFunctionName(depth = 2) {\n  const error = new Error('Stack')\n  let newIndex: number | undefined\n  const stackParts = error.stack?.split('\\n')[depth]?.split(' ')\n  const funcName\n        = stackParts?.find((item, index) => {\n          if (item.length > 0 && item !== 'at') {\n            // check if constructor\n            if (item === 'new') {\n              newIndex = index\n            }\n            return true\n          }\n        }) ?? '<unknown>'\n  return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName\n}\n","export function getRootFunction(obj: unknown, funcName: string) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let anyObj = obj as any\n  while (anyObj.__proto__?.[funcName]) {\n    anyObj = anyObj.__proto__\n  }\n  return anyObj[funcName]\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/AbstractCreatable.ts","../../src/Creatable.ts","../../src/Factory.ts","../../src/lib/getFunctionName.ts","../../src/lib/getRootFunction.ts","../../src/model/Labels.ts"],"sourcesContent":["import { assertEx } from '@xylabs/assert'\nimport type { EventData } from '@xylabs/events'\nimport { BaseEmitter } from '@xylabs/events'\nimport { type Logger } from '@xylabs/logger'\nimport type { Promisable } from '@xylabs/promise'\nimport { isError } from '@xylabs/typeof'\n\nimport { type Creatable, creatable } from './Creatable.ts'\nimport { Factory } from './Factory.ts'\nimport { getFunctionName, getRootFunction } from './lib/index.ts'\nimport type {\n  CreatableInstance, CreatableName, CreatableParams,\n  Labels,\n} from './model/index.ts'\n\nconst AbstractCreatableConstructorKey = Symbol.for('AbstractCreatableConstructor')\n\n@creatable()\nexport class AbstractCreatable<TParams extends CreatableParams = CreatableParams,\n  TEventData extends EventData = EventData> extends BaseEmitter<Partial<TParams>, TEventData> {\n  defaultLogger?: Logger\n\n  private _validatedParams?: TParams\n\n  constructor(key: unknown, params: Partial<TParams>) {\n    assertEx(key === AbstractCreatableConstructorKey, () => 'AbstractCreatable should not be instantiated directly, use the static create method instead')\n    super(params)\n  }\n\n  get name(): CreatableName {\n    return this.params.name ?? this.constructor.name\n  }\n\n  override get params(): TParams {\n    this._validatedParams = this._validatedParams ?? this.paramsValidator(super.params)\n    return this._validatedParams\n  }\n\n  get statusReporter() {\n    return this.params.statusReporter\n  }\n\n  static async create<T extends CreatableInstance>(\n    this: Creatable<T>,\n    inParams: Partial<T['params']> = {},\n  ): Promise<T> {\n    const params = await this.paramsHandler(inParams)\n    const name: CreatableName = params.name ?? this.name\n    params.statusReporter?.report(name, 'creating')\n    try {\n      const instance = new this(AbstractCreatableConstructorKey, params)\n      const initializedInstance = await this.createHandler(instance)\n      await instance.createHandler()\n      params.statusReporter?.report(name, 'created')\n      return initializedInstance\n    } catch (ex) {\n      params.statusReporter?.report(name, 'error', isError(ex) ? ex : new Error(`Error creating: ${name}`))\n      throw isError(ex) ? ex : new Error(`Error creating: ${name}`)\n    }\n  }\n\n  static createHandler<T extends CreatableInstance>(\n    this: Creatable<T>,\n    instance: T,\n  ): Promisable<T> {\n    return instance\n  }\n\n  static factory<T extends CreatableInstance>(\n    this: Creatable<T>,\n    params?: Partial<T['params']>,\n    labels?: Labels,\n  ): Factory<T> {\n    return Factory.withParams<T>(this, params, labels)\n  }\n\n  static paramsHandler<T extends CreatableInstance>(\n    this: Creatable<T>,\n    params: Partial<T['params']> = {},\n  ): Promisable<Partial<T['params']>> {\n    return { ...params }\n  }\n\n  createHandler(): Promisable<void> {}\n\n  paramsValidator(params: Partial<TParams>): TParams {\n    return { ...params, name: params.name ?? this.constructor.name } as TParams\n  }\n\n  async start(): Promise<boolean> {\n    this._noOverride('start')\n    try {\n      this.statusReporter?.report(this.name, 'starting')\n      await this.startHandler()\n      this.statusReporter?.report(this.name, 'started')\n      return true\n    } catch (ex) {\n      this.statusReporter?.report(this.name, 'error', isError(ex) ? ex : new Error(`Error stopping: ${ex}`))\n      return false\n    }\n  }\n\n  async stop(): Promise<boolean> {\n    this._noOverride('stop')\n    try {\n      this.statusReporter?.report(this.name, 'stopping')\n      await this.stopHandler()\n      this.statusReporter?.report(this.name, 'stopped')\n      return true\n    } catch (ex) {\n      this.statusReporter?.report(this.name, 'error', isError(ex) ? ex : new Error(`Error stopping: ${ex}`))\n      return false\n    }\n  }\n\n  protected _noOverride(functionName = getFunctionName(3)) {\n    // eslint-disable-next-line @typescript-eslint/no-explicit-any\n    const thisFunc = (this as any)[functionName]\n\n    const rootFunc = getRootFunction(this, functionName)\n    assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)\n  }\n\n  protected startHandler(): Promisable<void> {\n    // when overriding this, throw an error on failure\n  }\n\n  protected stopHandler(): Promisable<void> {\n    // when overriding this, throw an error on failure\n  }\n}\n","import type { Logger } from '@xylabs/logger'\nimport type { Promisable } from '@xylabs/promise'\n\nimport type { AbstractCreatable } from './AbstractCreatable.ts'\nimport type {\n  CreatableInstance, CreatableParams, Labels,\n} from './model/index.ts'\n\nexport interface CreatableFactory<T extends CreatableInstance = CreatableInstance>\n  extends Omit<Creatable<T>, 'create' | 'createHandler' | 'paramsHandler' | 'defaultLogger'> {\n\n  create(\n    this: CreatableFactory<T>,\n    params?: Partial<T['params']>): Promise<T>\n}\n\nexport interface Creatable<T extends CreatableInstance = CreatableInstance> {\n\n  defaultLogger?: Logger\n\n  new(key: unknown, params: Partial<CreatableParams>): T & AbstractCreatable<T['params']>\n\n  create<T extends CreatableInstance>(\n    this: Creatable<T>,\n    params?: Partial<T['params']>): Promise<T>\n\n  createHandler<T extends CreatableInstance>(\n    this: Creatable<T>,\n    instance: T\n  ): Promisable<T>\n\n  factory(params?: Partial<T['params']>, labels?: Labels): CreatableFactory<T>\n\n  paramsHandler<T extends CreatableInstance>(\n    this: Creatable<T>, params?: Partial<T['params']>): Promisable<Partial<T['params']>>\n}\n\n/**\n * Class annotation to be used to decorate Modules which support\n * an asynchronous creation pattern\n * @returns The decorated Module requiring it implement the members\n * of the CreatableModule as statics properties/methods\n */\nexport function creatable<T extends CreatableInstance>() {\n  return <U extends Creatable<T>>(constructor: U) => {\n    // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n    constructor\n  }\n}\n\n/**\n * Class annotation to be used to decorate Modules which support\n * an asynchronous creation factory pattern\n * @returns The decorated Module requiring it implement the members\n * of the CreatableModule as statics properties/methods\n */\n\nexport function creatableFactory() {\n  return <U extends CreatableFactory>(constructor: U) => {\n    // eslint-disable-next-line @typescript-eslint/no-unused-expressions\n    constructor\n  }\n}\n","import { type Creatable, type CreatableFactory } from './Creatable.ts'\nimport type {\n  CreatableInstance, Labels, WithOptionalLabels,\n} from './model/index.ts'\n\nexport class Factory<T extends CreatableInstance = CreatableInstance> implements CreatableFactory<T> {\n  creatable: Creatable<T>\n\n  defaultParams?: Partial<T['params']>\n\n  labels?: Labels\n\n  constructor(\n    creatable: Creatable<T>,\n    params?: Partial<T['params']>,\n    labels: Labels = {},\n  ) {\n    this.creatable = creatable\n    this.defaultParams = params\n    this.labels = Object.assign({}, (creatable as WithOptionalLabels).labels ?? {}, labels ?? {})\n  }\n\n  static withParams<T extends CreatableInstance>(\n    creatableModule: Creatable<T>,\n    params?: Partial<T['params']>,\n    labels: Labels = {},\n  ) {\n    return new Factory<T>(creatableModule, params, labels)\n  }\n\n  create(params?: Partial<T['params']>): Promise<T> {\n    const mergedParams: T['params'] = {\n      ...this.defaultParams,\n      ...params,\n    } as T['params']\n    return this.creatable.create<T>(mergedParams)\n  }\n\n  factory<T extends CreatableInstance>(this: Factory<T>, params?: Partial<T['params']>, labels: Labels = {}): CreatableFactory<T> {\n    return new Factory<T>(this.creatable, params, labels)\n  }\n}\n","import { isNumber } from '@xylabs/typeof'\n\nexport function getFunctionName(depth = 2) {\n  const error = new Error('Stack')\n  let newIndex: number | undefined\n  const stackParts = error.stack?.split('\\n')[depth]?.split(' ')\n  const funcName\n        = stackParts?.find((item, index) => {\n          if (item.length > 0 && item !== 'at') {\n            // check if constructor\n            if (item === 'new') {\n              newIndex = index\n            }\n            return true\n          }\n        }) ?? '<unknown>'\n  return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName\n}\n","export function getRootFunction(obj: unknown, funcName: string) {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  let anyObj = obj as any\n  while (anyObj.__proto__?.[funcName]) {\n    anyObj = anyObj.__proto__\n  }\n  return anyObj[funcName]\n}\n","/**\n * Object used to represent labels identifying a resource.\n */\nexport interface Labels {\n  [key: string]: string | undefined\n}\n\n/**\n * Interface for objects that have labels.\n */\nexport interface WithLabels<T extends Labels = Labels> {\n  labels: T\n}\n\n/**\n * Interface for objects that have labels.\n */\nexport interface WithOptionalLabels<T extends Labels = Labels> {\n  labels?: T\n}\n\n/**\n * Returns true if the source object has all the labels from the required set\n * @param source Source object to check against\n * @param required Set of labels to check for in source\n * @returns True of the source object has all the labels from the required set\n */\nexport const hasAllLabels = (source?: Labels, required?: Labels): boolean => {\n  if (!required) return true\n  return Object.entries(required).every(([key, value]) => {\n    return source?.hasOwnProperty(key as keyof typeof source) && source?.[key as keyof typeof source] === value\n  })\n}\n"],"mappings":"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","names":["creatable"]}

package/dist/types/AbstractCreatable.d.ts

@@ -3,7 +3,8 @@ import { BaseEmitter } from '@xylabs/events';
 import { type Logger } from '@xylabs/logger';
 import type { Promisable } from '@xylabs/promise';
 import { type Creatable } from './Creatable.ts';
-import type { CreatableInstance, CreatableName, CreatableParams } from './model/index.ts';
+import { Factory } from './Factory.ts';
+import type { CreatableInstance, CreatableName, CreatableParams, Labels } from './model/index.ts';
 export declare class AbstractCreatable<TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> extends BaseEmitter<Partial<TParams>, TEventData> {
     defaultLogger?: Logger;
     private _validatedParams?;
@@ -13,6 +14,7 @@ export declare class AbstractCreatable<TParams extends CreatableParams = Creatab
     get statusReporter(): import("./model/CreatableStatusReporter.ts").CreatableStatusReporter<void> | undefined;
     static create<T extends CreatableInstance>(this: Creatable<T>, inParams?: Partial<T['params']>): Promise<T>;
     static createHandler<T extends CreatableInstance>(this: Creatable<T>, instance: T): Promisable<T>;
+    static factory<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>, labels?: Labels): Factory<T>;
     static paramsHandler<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>): Promisable<Partial<T['params']>>;
     createHandler(): Promisable<void>;
     paramsValidator(params: Partial<TParams>): TParams;

package/dist/types/AbstractCreatable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractCreatable.d.ts","sourceRoot":"","sources":["../../src/AbstractCreatable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,gBAAgB,CAAA;AAE1D,OAAO,KAAK,EACV,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAClD,MAAM,kBAAkB,CAAA;AAIzB,qBACa,iBAAiB,CAAC,OAAO,SAAS,eAAe,GAAG,eAAe,EAC9E,UAAU,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,OAAO,CAAC,gBAAgB,CAAC,CAAS;gBAEtB,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;IAKlD,IAAI,IAAI,IAAI,aAAa,CAExB;IAED,IAAa,MAAM,IAAI,OAAO,CAG7B;IAED,IAAI,cAAc,2FAEjB;WAEY,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAC7C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,GAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IAgBb,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAC9C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC;IAIhB,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAC9C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,GAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAM,GAChC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAInC,aAAa,IAAI,UAAU,CAAC,IAAI,CAAC;IAEjC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;IAI5C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAa9B,SAAS,CAAC,WAAW,CAAC,YAAY,SAAqB;IAQvD,SAAS,CAAC,YAAY,IAAI,UAAU,CAAC,IAAI,CAAC;IAI1C,SAAS,CAAC,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC;CAG1C"}
+{"version":3,"file":"AbstractCreatable.d.ts","sourceRoot":"","sources":["../../src/AbstractCreatable.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,EAAE,KAAK,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,gBAAgB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAA;AAEtC,OAAO,KAAK,EACV,iBAAiB,EAAE,aAAa,EAAE,eAAe,EACjD,MAAM,EACP,MAAM,kBAAkB,CAAA;AAIzB,qBACa,iBAAiB,CAAC,OAAO,SAAS,eAAe,GAAG,eAAe,EAC9E,UAAU,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,WAAW,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,UAAU,CAAC;IAC3F,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,OAAO,CAAC,gBAAgB,CAAC,CAAS;gBAEtB,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;IAKlD,IAAI,IAAI,IAAI,aAAa,CAExB;IAED,IAAa,MAAM,IAAI,OAAO,CAG7B;IAED,IAAI,cAAc,2FAEjB;WAEY,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAC7C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,GAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAM,GAClC,OAAO,CAAC,CAAC,CAAC;IAgBb,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAC9C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC;IAIhB,MAAM,CAAC,OAAO,CAAC,CAAC,SAAS,iBAAiB,EACxC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAC7B,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,CAAC,CAAC;IAIb,MAAM,CAAC,aAAa,CAAC,CAAC,SAAS,iBAAiB,EAC9C,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,GAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAM,GAChC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IAInC,aAAa,IAAI,UAAU,CAAC,IAAI,CAAC;IAEjC,eAAe,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,GAAG,OAAO;IAI5C,KAAK,IAAI,OAAO,CAAC,OAAO,CAAC;IAazB,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAa9B,SAAS,CAAC,WAAW,CAAC,YAAY,SAAqB;IAQvD,SAAS,CAAC,YAAY,IAAI,UAAU,CAAC,IAAI,CAAC;IAI1C,SAAS,CAAC,WAAW,IAAI,UAAU,CAAC,IAAI,CAAC;CAG1C"}

package/dist/types/Creatable.d.ts

@@ -1,12 +1,16 @@
 import type { Logger } from '@xylabs/logger';
 import type { Promisable } from '@xylabs/promise';
 import type { AbstractCreatable } from './AbstractCreatable.ts';
-import type { CreatableInstance, CreatableParams } from './model/index.ts';
+import type { CreatableInstance, CreatableParams, Labels } from './model/index.ts';
+export interface CreatableFactory<T extends CreatableInstance = CreatableInstance> extends Omit<Creatable<T>, 'create' | 'createHandler' | 'paramsHandler' | 'defaultLogger'> {
+    create(this: CreatableFactory<T>, params?: Partial<T['params']>): Promise<T>;
+}
 export interface Creatable<T extends CreatableInstance = CreatableInstance> {
     defaultLogger?: Logger;
     new (key: unknown, params: Partial<CreatableParams>): T & AbstractCreatable<T['params']>;
-    create<T extends CreatableInstance>(this: Creatable<T>, params: Partial<T['params']>): Promise<T>;
+    create<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>): Promise<T>;
     createHandler<T extends CreatableInstance>(this: Creatable<T>, instance: T): Promisable<T>;
+    factory(params?: Partial<T['params']>, labels?: Labels): CreatableFactory<T>;
     paramsHandler<T extends CreatableInstance>(this: Creatable<T>, params?: Partial<T['params']>): Promisable<Partial<T['params']>>;
 }
 /**
@@ -22,4 +26,5 @@ export declare function creatable<T extends CreatableInstance>(): <U extends Cre
  * @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/types/Creatable.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Creatable.d.ts","sourceRoot":"","sources":["../../src/Creatable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAS1E,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAExE,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,KAAI,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEvF,MAAM,CAAC,CAAC,SAAS,iBAAiB,EAChC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAA;IAE3C,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC,CAAA;IAEhB,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,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;CAMvF;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,iBAAiB,MAC3C,CAAC,SAAS,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,CAAC,UAI/C;AAED;;;;;GAKG"}
+{"version":3,"file":"Creatable.d.ts","sourceRoot":"","sources":["../../src/Creatable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EACV,iBAAiB,EAAE,eAAe,EAAE,MAAM,EAC3C,MAAM,kBAAkB,CAAA;AAEzB,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,CAAC;IAE1F,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,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAExE,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,KAAI,GAAG,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEvF,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,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvC,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC,CAAA;IAEhB,OAAO,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAA;IAE5E,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,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;CACvF;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/types/Factory.d.ts

@@ -0,0 +1,12 @@
+import { type Creatable, type CreatableFactory } from './Creatable.ts';
+import type { CreatableInstance, Labels } from './model/index.ts';
+export declare class Factory<T extends CreatableInstance = CreatableInstance> implements CreatableFactory<T> {
+    creatable: Creatable<T>;
+    defaultParams?: Partial<T['params']>;
+    labels?: Labels;
+    constructor(creatable: Creatable<T>, params?: Partial<T['params']>, labels?: Labels);
+    static withParams<T extends CreatableInstance>(creatableModule: Creatable<T>, params?: Partial<T['params']>, labels?: Labels): Factory<T>;
+    create(params?: Partial<T['params']>): Promise<T>;
+    factory<T extends CreatableInstance>(this: Factory<T>, params?: Partial<T['params']>, labels?: Labels): CreatableFactory<T>;
+}
+//# sourceMappingURL=Factory.d.ts.map

package/dist/types/Factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Factory.d.ts","sourceRoot":"","sources":["../../src/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,qBAAa,OAAO,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB,CAAE,YAAW,gBAAgB,CAAC,CAAC,CAAC;IAClG,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC,CAAA;IAEvB,aAAa,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAEpC,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,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,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAQjD,OAAO,CAAC,CAAC,SAAS,iBAAiB,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,GAAE,MAAW,GAAG,gBAAgB,CAAC,CAAC,CAAC;CAGhI"}

package/dist/types/model/Labels.d.ts

@@ -0,0 +1,26 @@
+/**
+ * Object used to represent labels identifying a resource.
+ */
+export interface Labels {
+    [key: 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/types/model/Labels.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Labels.d.ts","sourceRoot":"","sources":["../../../src/model/Labels.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAA;CAClC;AAED;;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/types/model/index.d.ts

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

package/dist/types/model/index.d.ts.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/creatable",
-  "version": "4.12.33",
+  "version": "4.12.34",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -29,13 +29,13 @@
   "module": "dist/neutral/index.mjs",
   "types": "dist/types/index.d.ts",
   "dependencies": {
-    "@xylabs/assert": "^4.12.33",
-    "@xylabs/base": "^4.12.33",
-    "@xylabs/events": "^4.12.33",
-    "@xylabs/logger": "^4.12.33",
-    "@xylabs/object": "^4.12.33",
-    "@xylabs/promise": "^4.12.33",
-    "@xylabs/typeof": "^4.12.33"
+    "@xylabs/assert": "^4.12.34",
+    "@xylabs/base": "^4.12.34",
+    "@xylabs/events": "^4.12.34",
+    "@xylabs/logger": "^4.12.34",
+    "@xylabs/object": "^4.12.34",
+    "@xylabs/promise": "^4.12.34",
+    "@xylabs/typeof": "^4.12.34"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "^6.5.12",

package/src/AbstractCreatable.ts

@@ -6,9 +6,11 @@ import type { Promisable } from '@xylabs/promise'
 import { isError } from '@xylabs/typeof'
 
 import { type Creatable, creatable } from './Creatable.ts'
+import { Factory } from './Factory.ts'
 import { getFunctionName, getRootFunction } from './lib/index.ts'
 import type {
   CreatableInstance, CreatableName, CreatableParams,
+  Labels,
 } from './model/index.ts'
 
 const AbstractCreatableConstructorKey = Symbol.for('AbstractCreatableConstructor')
@@ -64,6 +66,14 @@ export class AbstractCreatable<TParams extends CreatableParams = CreatableParams
     return instance
   }
 
+  static factory<T extends CreatableInstance>(
+    this: Creatable<T>,
+    params?: Partial<T['params']>,
+    labels?: Labels,
+  ): Factory<T> {
+    return Factory.withParams<T>(this, params, labels)
+  }
+
   static paramsHandler<T extends CreatableInstance>(
     this: Creatable<T>,
     params: Partial<T['params']> = {},

package/src/Creatable.ts

@@ -2,14 +2,17 @@ import type { Logger } from '@xylabs/logger'
 import type { Promisable } from '@xylabs/promise'
 
 import type { AbstractCreatable } from './AbstractCreatable.ts'
-import type { CreatableInstance, CreatableParams } from './model/index.ts'
+import type {
+  CreatableInstance, CreatableParams, Labels,
+} from './model/index.ts'
 
-/*
-export interface CreatableFactory<T extends EmptyObject | void = void,
-  TParams extends EmptyObject | void = void> {
-  create(params?: CreatableParams<TParams>): Promise<CreatableInstance<T>>
+export interface CreatableFactory<T extends CreatableInstance = CreatableInstance>
+  extends Omit<Creatable<T>, 'create' | 'createHandler' | 'paramsHandler' | 'defaultLogger'> {
+
+  create(
+    this: CreatableFactory<T>,
+    params?: Partial<T['params']>): Promise<T>
 }
-*/
 
 export interface Creatable<T extends CreatableInstance = CreatableInstance> {
 
@@ -19,20 +22,17 @@ export interface Creatable<T extends CreatableInstance = CreatableInstance> {
 
   create<T extends CreatableInstance>(
     this: Creatable<T>,
-    params: Partial<T['params']>): Promise<T>
+    params?: Partial<T['params']>): Promise<T>
 
   createHandler<T extends CreatableInstance>(
     this: Creatable<T>,
     instance: T
   ): Promisable<T>
 
+  factory(params?: Partial<T['params']>, labels?: Labels): CreatableFactory<T>
+
   paramsHandler<T extends CreatableInstance>(
     this: Creatable<T>, params?: Partial<T['params']>): Promisable<Partial<T['params']>>
-
-  /*
-  factory<T extends EmptyObject | void = void,
-    TParams extends EmptyObject | void = void> (this: Creatable<T, TParams>, params: Partial<CreatableParams<TParams>>): CreatableFactory<T, TParams>
-  */
 }
 
 /**
@@ -55,11 +55,9 @@ export function creatable<T extends CreatableInstance>() {
  * of the CreatableModule as statics properties/methods
  */
 
-/*
 export function creatableFactory() {
   return <U extends CreatableFactory>(constructor: U) => {
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     constructor
   }
 }
-*/

package/src/Factory.ts

@@ -0,0 +1,42 @@
+import { type Creatable, type CreatableFactory } from './Creatable.ts'
+import type {
+  CreatableInstance, Labels, WithOptionalLabels,
+} from './model/index.ts'
+
+export class Factory<T extends CreatableInstance = CreatableInstance> implements CreatableFactory<T> {
+  creatable: Creatable<T>
+
+  defaultParams?: Partial<T['params']>
+
+  labels?: Labels
+
+  constructor(
+    creatable: Creatable<T>,
+    params?: Partial<T['params']>,
+    labels: Labels = {},
+  ) {
+    this.creatable = creatable
+    this.defaultParams = params
+    this.labels = Object.assign({}, (creatable as WithOptionalLabels).labels ?? {}, labels ?? {})
+  }
+
+  static withParams<T extends CreatableInstance>(
+    creatableModule: Creatable<T>,
+    params?: Partial<T['params']>,
+    labels: Labels = {},
+  ) {
+    return new Factory<T>(creatableModule, params, labels)
+  }
+
+  create(params?: Partial<T['params']>): Promise<T> {
+    const mergedParams: T['params'] = {
+      ...this.defaultParams,
+      ...params,
+    } as T['params']
+    return this.creatable.create<T>(mergedParams)
+  }
+
+  factory<T extends CreatableInstance>(this: Factory<T>, params?: Partial<T['params']>, labels: Labels = {}): CreatableFactory<T> {
+    return new Factory<T>(this.creatable, params, labels)
+  }
+}

package/src/model/Labels.ts

@@ -0,0 +1,33 @@
+/**
+ * Object used to represent labels identifying a resource.
+ */
+export interface Labels {
+  [key: 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 const hasAllLabels = (source?: Labels, required?: Labels): boolean => {
+  if (!required) return true
+  return Object.entries(required).every(([key, value]) => {
+    return source?.hasOwnProperty(key as keyof typeof source) && source?.[key as keyof typeof source] === value
+  })
+}

package/src/model/index.ts

@@ -1,3 +1,4 @@
 export * from './CreatableInstance.ts'
 export * from './CreatableParams.ts'
 export * from './CreatableStatusReporter.ts'
+export * from './Labels.ts'

package/dist/types/TestCreatable.d.ts

@@ -1,13 +0,0 @@
-import type { EventData } from '@xylabs/events';
-import { Promisable } from '@xylabs/promise';
-import { AbstractCreatable } from './AbstractCreatable.ts';
-import { Creatable } from './Creatable.ts';
-import type { CreatableInstance, CreatableParams } from './model/index.ts';
-export interface TestCreatableParams extends CreatableParams {
-    testParam: string;
-}
-export declare class TestCreatable<TParams extends TestCreatableParams = TestCreatableParams, TEventData extends EventData = EventData> extends AbstractCreatable<TParams, TEventData> {
-    static createHandler<T extends CreatableInstance>(this: Creatable<T>, instance: T): Promisable<T>;
-    paramsValidator(params?: Partial<TParams>): TParams;
-}
-//# sourceMappingURL=TestCreatable.d.ts.map

package/dist/types/TestCreatable.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TestCreatable.d.ts","sourceRoot":"","sources":["../../src/TestCreatable.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC1D,OAAO,EAAE,SAAS,EAAa,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAE1E,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,qBACa,aAAa,CAAC,OAAO,SAAS,mBAAmB,GAAG,mBAAmB,EAAE,UAAU,SAAS,SAAS,GAAG,SAAS,CAC5H,SAAQ,iBAAiB,CAAC,OAAO,EAAE,UAAU,CAAC;WAC9B,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC;IAIP,eAAe,CAAC,MAAM,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO;CAMjE"}

package/dist/types/TestCreatable2.d.ts

@@ -1,14 +0,0 @@
-import type { EventData } from '@xylabs/events';
-import { Promisable } from '@xylabs/promise';
-import { Creatable } from './Creatable.ts';
-import type { CreatableInstance } from './model/index.ts';
-import { TestCreatable, TestCreatableParams } from './TestCreatable.ts';
-interface TestCreatableParams2 extends TestCreatableParams {
-    testParam2: number;
-}
-export declare class TestCreatable2<TParams extends TestCreatableParams2 = TestCreatableParams2, TEventData extends EventData = EventData> extends TestCreatable<TParams, TEventData> {
-    static createHandler<T extends CreatableInstance>(this: Creatable<T>, instance: T): Promisable<T>;
-    paramsValidator(params?: Partial<TParams>): TParams;
-}
-export {};
-//# sourceMappingURL=TestCreatable2.d.ts.map

package/dist/types/TestCreatable2.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"TestCreatable2.d.ts","sourceRoot":"","sources":["../../src/TestCreatable2.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAE5C,OAAO,EAAE,SAAS,EAAa,MAAM,gBAAgB,CAAA;AACrD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AACzD,OAAO,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAA;AAEvE,UAAU,oBAAqB,SAAQ,mBAAmB;IACxD,UAAU,EAAE,MAAM,CAAA;CACnB;AAED,qBACa,cAAc,CAAC,OAAO,SAAS,oBAAoB,GAAG,oBAAoB,EAAE,UAAU,SAAS,SAAS,GAAG,SAAS,CAC/H,SAAQ,aAAa,CAAC,OAAO,EAAE,UAAU,CAAC;WAC1B,aAAa,CAAC,CAAC,SAAS,iBAAiB,EACvD,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,EAClB,QAAQ,EAAE,CAAC,GACV,UAAU,CAAC,CAAC,CAAC;IAIP,eAAe,CAAC,MAAM,GAAE,OAAO,CAAC,OAAO,CAAM,GAAG,OAAO;CAMjE"}

package/src/TestCreatable.ts

@@ -1,28 +0,0 @@
-import type { EventData } from '@xylabs/events'
-import { Promisable } from '@xylabs/promise'
-
-import { AbstractCreatable } from './AbstractCreatable.ts'
-import { Creatable, creatable } from './Creatable.ts'
-import type { CreatableInstance, CreatableParams } from './model/index.ts'
-
-export interface TestCreatableParams extends CreatableParams {
-  testParam: string
-}
-
-@creatable()
-export class TestCreatable<TParams extends TestCreatableParams = TestCreatableParams, TEventData extends EventData = EventData>
-  extends AbstractCreatable<TParams, TEventData> {
-  static override createHandler<T extends CreatableInstance>(
-    this: Creatable<T>,
-    instance: T,
-  ): Promisable<T> {
-    return instance
-  }
-
-  override paramsValidator(params: Partial<TParams> = {}): TParams {
-    const result: TestCreatableParams = {
-      ...params, name: params.name ?? this.constructor.name, testParam: 'yo',
-    }
-    return result as TParams
-  }
-}

package/src/TestCreatable2.ts

@@ -1,28 +0,0 @@
-import type { EventData } from '@xylabs/events'
-import { Promisable } from '@xylabs/promise'
-
-import { Creatable, creatable } from './Creatable.ts'
-import type { CreatableInstance } from './model/index.ts'
-import { TestCreatable, TestCreatableParams } from './TestCreatable.ts'
-
-interface TestCreatableParams2 extends TestCreatableParams {
-  testParam2: number
-}
-
-@creatable()
-export class TestCreatable2<TParams extends TestCreatableParams2 = TestCreatableParams2, TEventData extends EventData = EventData>
-  extends TestCreatable<TParams, TEventData> {
-  static override createHandler<T extends CreatableInstance>(
-    this: Creatable<T>,
-    instance: T,
-  ): Promisable<T> {
-    return instance
-  }
-
-  override paramsValidator(params: Partial<TParams> = {}): TParams {
-    const result: TestCreatableParams = {
-      ...params, name: params.name ?? this.constructor.name, testParam: 'yo',
-    }
-    return result as TParams
-  }
-}