@xylabs/creatable 4.12.8 → 4.12.10

package/dist/neutral/index.mjs

@@ -1,8 +1,9 @@
 // src/AbstractCreatable.ts
 import { assertEx } from "@xylabs/assert";
 import { BaseEmitter } from "@xylabs/events";
+import { isError } from "@xylabs/typeof";
 
-// src/getFunctionName.ts
+// src/lib/getFunctionName.ts
 import { isNumber } from "@xylabs/typeof";
 function getFunctionName(depth = 2) {
   const error = new Error("Stack");
@@ -19,7 +20,7 @@ function getFunctionName(depth = 2) {
   return isNumber(newIndex) ? `${funcName} ${stackParts?.[newIndex + 1]}` : funcName;
 }
 
-// src/getRootFunction.ts
+// src/lib/getRootFunction.ts
 function getRootFunction(obj, funcName) {
   let anyObj = obj;
   while (anyObj.__proto__?.[funcName]) {
@@ -42,19 +43,58 @@ var AbstractCreatable = class extends BaseEmitter {
     this._populatedParams = this._populatedParams ?? this.paramsHandler(super.params);
     return this._populatedParams;
   }
+  get statusReporter() {
+    return this.params.statusReporter;
+  }
   static async create(params) {
-    const instance = new this(params);
-    await instance.createHandler();
-    return await Promise.resolve(instance);
+    const name = params.name ?? this.name;
+    params.statusReporter?.report(name, "creating");
+    try {
+      const instance = new this(params);
+      await instance.createHandler();
+      params.statusReporter?.report(name, "created");
+      return instance;
+    } catch (ex) {
+      params.statusReporter?.report(name, "error", isError(ex) ? ex : new Error(`Error creating: ${name}`));
+      throw new Error(`Error creating: ${name}`);
+    }
   }
   createHandler() {
     return true;
   }
+  async start() {
+    this._noOverride("start");
+    try {
+      this.statusReporter?.report(this.name, "starting");
+      await this.startHandler();
+      this.statusReporter?.report(this.name, "started");
+      return true;
+    } catch (ex) {
+      this.statusReporter?.report(this.name, "error", isError(ex) ? ex : new Error(`Error stopping: ${ex}`));
+      return false;
+    }
+  }
+  async stop() {
+    this._noOverride("stop");
+    try {
+      this.statusReporter?.report(this.name, "stopping");
+      await this.stopHandler();
+      this.statusReporter?.report(this.name, "stopped");
+      return true;
+    } catch (ex) {
+      this.statusReporter?.report(this.name, "error", isError(ex) ? ex : new Error(`Error stopping: ${ex}`));
+      return false;
+    }
+  }
   _noOverride(functionName = getFunctionName(3)) {
     const thisFunc = this[functionName];
     const rootFunc = getRootFunction(this, functionName);
     assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`);
   }
+  startHandler() {
+  }
+  stopHandler() {
+  }
 };
 
 // src/Creatable.ts

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/AbstractCreatable.ts","../../src/getFunctionName.ts","../../src/getRootFunction.ts","../../src/Creatable.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 { EmptyObject } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\n\nimport type { Creatable } from './Creatable.ts'\nimport type { CreatableInstance } from './CreatableInstance.ts'\nimport type { CreatableName, CreatableParams } from './CreatableParams.ts'\nimport { getFunctionName } from './getFunctionName.ts'\nimport { getRootFunction } from './getRootFunction.ts'\n\nexport abstract class AbstractCreatable<TParams extends EmptyObject | void = void,\n  TEventData extends EventData = EventData> extends BaseEmitter<Partial<CreatableParams<TParams>>, TEventData> {\n  defaultLogger?: Logger\n  name: CreatableName\n\n  private _populatedParams: CreatableParams<TParams> | undefined\n\n  constructor(params: Partial<CreatableParams<TParams>>) {\n    super(params)\n    this.name = params.name ?? this.constructor.name as CreatableName\n  }\n\n  override get params(): CreatableParams<TParams> {\n    this._noOverride()\n    this._populatedParams = this._populatedParams ?? this.paramsHandler(super.params)\n    return this._populatedParams\n  }\n\n  static async create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(\n    this: Creatable<T, TParams>,\n    params: Partial<CreatableParams<TParams>>,\n  ): Promise<CreatableInstance<T>> {\n    const instance = new this(params)\n    await instance.createHandler()\n    return await Promise.resolve(instance as CreatableInstance<T>)\n  }\n\n  createHandler(): Promisable<boolean> {\n    return true\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 abstract paramsHandler(params?: Partial<CreatableParams<TParams>>): CreatableParams<TParams>\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","import type { Logger } from '@xylabs/logger'\nimport type { EmptyObject } from '@xylabs/object'\n\nimport type { AbstractCreatable } from './AbstractCreatable.ts'\nimport type { CreatableInstance } from './CreatableInstance.ts'\nimport type { CreatableParams } from './CreatableParams.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 EmptyObject | void = void, TParams extends EmptyObject | void = void> {\n\n  defaultLogger?: Logger\n\n  new (params: Partial<CreatableParams<TParams>>): CreatableInstance<T> & AbstractCreatable<TParams>\n\n  create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(\n    this: Creatable<T, TParams>,\n    params: Partial<CreatableParams<TParams>>): Promise<CreatableInstance<T>>\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<TInstance extends EmptyObject | void = void, TParams extends EmptyObject | void = void>() {\n  return <U extends Creatable<TInstance, TParams>>(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"],"mappings":";AAAA,SAAS,gBAAgB;AAEzB,SAAS,mBAAmB;;;ACF5B,SAAS,gBAAgB;AAElB,SAAS,gBAAgB,QAAQ,GAAG;AACzC,QAAM,QAAQ,IAAI,MAAM,OAAO;AAC/B,MAAI;AACJ,QAAM,aAAa,MAAM,OAAO,MAAM,IAAI,EAAE,KAAK,GAAG,MAAM,GAAG;AAC7D,QAAM,WACE,YAAY,KAAK,CAAC,MAAM,UAAU;AAClC,QAAI,KAAK,SAAS,KAAK,SAAS,MAAM;AAEpC,UAAI,SAAS,OAAO;AAClB,mBAAW;AAAA,MACb;AACA,aAAO;AAAA,IACT;AAAA,EACF,CAAC,KAAK;AACZ,SAAO,SAAS,QAAQ,IAAI,GAAG,QAAQ,IAAI,aAAa,WAAW,CAAC,CAAC,KAAK;AAC5E;;;ACjBO,SAAS,gBAAgB,KAAc,UAAkB;AAE9D,MAAI,SAAS;AACb,SAAO,OAAO,YAAY,QAAQ,GAAG;AACnC,aAAS,OAAO;AAAA,EAClB;AACA,SAAO,OAAO,QAAQ;AACxB;;;AFMO,IAAe,oBAAf,cAC6C,YAA2D;AAAA,EAC7G;AAAA,EACA;AAAA,EAEQ;AAAA,EAER,YAAY,QAA2C;AACrD,UAAM,MAAM;AACZ,SAAK,OAAO,OAAO,QAAQ,KAAK,YAAY;AAAA,EAC9C;AAAA,EAEA,IAAa,SAAmC;AAC9C,SAAK,YAAY;AACjB,SAAK,mBAAmB,KAAK,oBAAoB,KAAK,cAAc,MAAM,MAAM;AAChF,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,aAAa,OAEX,QAC+B;AAC/B,UAAM,WAAW,IAAI,KAAK,MAAM;AAChC,UAAM,SAAS,cAAc;AAC7B,WAAO,MAAM,QAAQ,QAAQ,QAAgC;AAAA,EAC/D;AAAA,EAEA,gBAAqC;AACnC,WAAO;AAAA,EACT;AAAA,EAEU,YAAY,eAAe,gBAAgB,CAAC,GAAG;AAEvD,UAAM,WAAY,KAAa,YAAY;AAE3C,UAAM,WAAW,gBAAgB,MAAM,YAAY;AACnD,aAAS,aAAa,UAAU,MAAM,6BAA6B,YAAY,gBAAgB,YAAY,iBAAiB;AAAA,EAC9H;AAGF;;;AGjBO,SAAS,YAAoG;AAClH,SAAO,CAA0C,gBAAmB;AAElE;AAAA,EACF;AACF;","names":[]}
+{"version":3,"sources":["../../src/AbstractCreatable.ts","../../src/lib/getFunctionName.ts","../../src/lib/getRootFunction.ts","../../src/Creatable.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 { EmptyObject } from '@xylabs/object'\nimport type { Promisable } from '@xylabs/promise'\nimport { isError } from '@xylabs/typeof'\n\nimport type { Creatable } from './Creatable.ts'\nimport { getFunctionName, getRootFunction } from './lib/index.ts'\nimport type {\n  CreatableInstance, CreatableName, CreatableParams,\n} from './model/index.ts'\n\nexport abstract class AbstractCreatable<TParams extends EmptyObject | void = void,\n  TEventData extends EventData = EventData> extends BaseEmitter<Partial<CreatableParams<TParams>>, TEventData> {\n  defaultLogger?: Logger\n  name: CreatableName\n\n  private _populatedParams: CreatableParams<TParams> | undefined\n\n  constructor(params: Partial<CreatableParams<TParams>>) {\n    super(params)\n    this.name = params.name ?? this.constructor.name as CreatableName\n  }\n\n  override get params(): CreatableParams<TParams> {\n    this._noOverride()\n    this._populatedParams = this._populatedParams ?? this.paramsHandler(super.params)\n    return this._populatedParams\n  }\n\n  get statusReporter() {\n    return this.params.statusReporter\n  }\n\n  static async create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(\n    this: Creatable<T, TParams>,\n    params: Partial<CreatableParams<TParams>>,\n  ): Promise<CreatableInstance<T>> {\n    const name: CreatableName = params.name ?? this.name\n    params.statusReporter?.report(name, 'creating')\n    try {\n      const instance = new this(params)\n      await instance.createHandler()\n      params.statusReporter?.report(name, 'created')\n      return instance\n    } catch (ex) {\n      params.statusReporter?.report(name, 'error', isError(ex) ? ex : new Error(`Error creating: ${name}`))\n      throw new Error(`Error creating: ${name}`)\n    }\n  }\n\n  createHandler(): Promisable<boolean> {\n    return true\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  protected abstract paramsHandler(params?: Partial<CreatableParams<TParams>>): CreatableParams<TParams>\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","import type { Logger } from '@xylabs/logger'\nimport type { EmptyObject } from '@xylabs/object'\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 EmptyObject | void = void, TParams extends EmptyObject | void = void> {\n\n  defaultLogger?: Logger\n\n  new (params: Partial<CreatableParams<TParams>>): CreatableInstance<T, TParams> & AbstractCreatable<TParams>\n\n  create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(\n    this: Creatable<T, TParams>,\n    params: Partial<CreatableParams<TParams>>): Promise<CreatableInstance<T>>\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<TInstance extends EmptyObject | void = void, TParams extends EmptyObject | void = void>() {\n  return <U extends Creatable<TInstance, TParams>>(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"],"mappings":"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","names":[]}

package/dist/types/AbstractCreatable.d.ts

@@ -4,17 +4,21 @@ import { type Logger } from '@xylabs/logger';
 import type { EmptyObject } from '@xylabs/object';
 import type { Promisable } from '@xylabs/promise';
 import type { Creatable } from './Creatable.ts';
-import type { CreatableInstance } from './CreatableInstance.ts';
-import type { CreatableName, CreatableParams } from './CreatableParams.ts';
+import type { CreatableInstance, CreatableName, CreatableParams } from './model/index.ts';
 export declare abstract class AbstractCreatable<TParams extends EmptyObject | void = void, TEventData extends EventData = EventData> extends BaseEmitter<Partial<CreatableParams<TParams>>, TEventData> {
     defaultLogger?: Logger;
     name: CreatableName;
     private _populatedParams;
     constructor(params: Partial<CreatableParams<TParams>>);
     get params(): CreatableParams<TParams>;
+    get statusReporter(): import("./model/CreatableStatusReporter.ts").CreatableStatusReporter | undefined;
     static create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(this: Creatable<T, TParams>, params: Partial<CreatableParams<TParams>>): Promise<CreatableInstance<T>>;
     createHandler(): Promisable<boolean>;
+    start(): Promise<boolean>;
+    stop(): Promise<boolean>;
     protected _noOverride(functionName?: string): void;
+    protected startHandler(): Promisable<void>;
+    protected stopHandler(): Promisable<void>;
     protected abstract paramsHandler(params?: Partial<CreatableParams<TParams>>): CreatableParams<TParams>;
 }
 //# sourceMappingURL=AbstractCreatable.d.ts.map

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,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAI1E,8BAAsB,iBAAiB,CAAC,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAC/E,UAAU,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,aAAa,CAAA;IAEnB,OAAO,CAAC,gBAAgB,CAAsC;gBAElD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAKrD,IAAa,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,CAI9C;WAEY,MAAM,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAChG,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,EAC3B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GACxC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAMhC,aAAa,IAAI,UAAU,CAAC,OAAO,CAAC;IAIpC,SAAS,CAAC,WAAW,CAAC,YAAY,SAAqB;IAQvD,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC;CACvG"}
+{"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,WAAW,EAAE,MAAM,gBAAgB,CAAA;AACjD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAGjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,KAAK,EACV,iBAAiB,EAAE,aAAa,EAAE,eAAe,EAClD,MAAM,kBAAkB,CAAA;AAEzB,8BAAsB,iBAAiB,CAAC,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAC/E,UAAU,SAAS,SAAS,GAAG,SAAS,CAAE,SAAQ,WAAW,CAAC,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,EAAE,UAAU,CAAC;IAC5G,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,IAAI,EAAE,aAAa,CAAA;IAEnB,OAAO,CAAC,gBAAgB,CAAsC;gBAElD,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAKrD,IAAa,MAAM,IAAI,eAAe,CAAC,OAAO,CAAC,CAI9C;IAED,IAAI,cAAc,qFAEjB;WAEY,MAAM,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAChG,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,EAC3B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GACxC,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC;IAchC,aAAa,IAAI,UAAU,CAAC,OAAO,CAAC;IAI9B,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;IAIzC,SAAS,CAAC,QAAQ,CAAC,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,eAAe,CAAC,OAAO,CAAC;CACvG"}

package/dist/types/Creatable.d.ts

@@ -1,11 +1,10 @@
 import type { Logger } from '@xylabs/logger';
 import type { EmptyObject } from '@xylabs/object';
 import type { AbstractCreatable } from './AbstractCreatable.ts';
-import type { CreatableInstance } from './CreatableInstance.ts';
-import type { CreatableParams } from './CreatableParams.ts';
+import type { CreatableInstance, CreatableParams } from './model/index.ts';
 export interface Creatable<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void> {
     defaultLogger?: Logger;
-    new (params: Partial<CreatableParams<TParams>>): CreatableInstance<T> & AbstractCreatable<TParams>;
+    new (params: Partial<CreatableParams<TParams>>): CreatableInstance<T, TParams> & AbstractCreatable<TParams>;
     create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(this: Creatable<T, TParams>, params: Partial<CreatableParams<TParams>>): Promise<CreatableInstance<T>>;
 }
 /**

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,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAA;AAC/D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAS3D,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI;IAEvG,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,KAAK,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAElG,MAAM,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EACnF,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,EAC3B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;CAM5E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,MACtG,CAAC,SAAS,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,UAIhE;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,WAAW,EAAE,MAAM,gBAAgB,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,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI;IAEvG,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,KAAK,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAA;IAE3G,MAAM,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EACnF,IAAI,EAAE,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,EAC3B,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAA;CAM5E;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,SAAS,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,MACtG,CAAC,SAAS,SAAS,CAAC,SAAS,EAAE,OAAO,CAAC,EAAE,aAAa,CAAC,UAIhE;AAED;;;;;GAKG"}

package/dist/types/index.d.ts

@@ -1,6 +1,4 @@
 export * from './AbstractCreatable.ts';
 export * from './Creatable.ts';
-export * from './CreatableInstance.ts';
-export * from './CreatableParams.ts';
-export * from './CreatableStatusReporter.ts';
+export * from './model/index.ts';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/lib/getFunctionName.d.ts.map

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

package/dist/types/lib/getRootFunction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"getRootFunction.d.ts","sourceRoot":"","sources":["../../../src/lib/getRootFunction.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAO7D"}

package/dist/types/lib/index.d.ts

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

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableInstance.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE1E,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI;IAChF,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IACxG,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAA"}

package/dist/types/{CreatableParams.d.ts → model/CreatableParams.d.ts}

@@ -4,7 +4,7 @@ import type { EmptyObject } from '@xylabs/object';
 import type { CreatableStatusReporter } from './CreatableStatusReporter.ts';
 export type CreatableName = Exclude<string, 'creatable-name-reserved-32546239486'> & BaseClassName;
 export type CreatableParamsFields = {
-    name?: CreatableName;
+    name: CreatableName;
     statusReporter?: CreatableStatusReporter;
 };
 export type CreatableParams<TAdditionalParams extends EmptyObject | void = void> = BaseEmitterParams<TAdditionalParams extends EmptyObject ? CreatableParamsFields & TAdditionalParams : CreatableParamsFields>;

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

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableParams.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAE3E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,qCAAqC,CAAC,GAAG,aAAa,CAAA;AAElG,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,EAAE,aAAa,CAAA;IACnB,cAAc,CAAC,EAAE,uBAAuB,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,iBAAiB,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IAC7E,iBAAiB,CAAC,iBAAiB,SAAS,WAAW,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,qBAAqB,CAAC,CAAA"}

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

@@ -0,0 +1,7 @@
+import type { BaseClassName } from '@xylabs/base';
+export type CreatableStatus = 'creating' | 'created' | 'starting' | 'started' | 'stopping' | 'stopped' | 'error';
+export interface CreatableStatusReporter {
+    report(name: BaseClassName, status: Exclude<CreatableStatus, 'error'>, progress?: number): void;
+    report(name: BaseClassName, status: Extract<CreatableStatus, 'error'>, error?: Error): void;
+}
+//# sourceMappingURL=CreatableStatusReporter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"CreatableStatusReporter.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableStatusReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,OAAO,CAAA;AAEhH,MAAM,WAAW,uBAAuB;IACtC,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC/F,MAAM,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,OAAO,CAAC,eAAe,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,KAAK,GAAG,IAAI,CAAA;CAC5F"}

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

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

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

@@ -0,0 +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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/creatable",
-  "version": "4.12.8",
+  "version": "4.12.10",
   "description": "Primary SDK for using XYO Protocol 2.0",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -30,12 +30,12 @@
   "types": "dist/types/index.d.ts",
   "dependencies": {
     "@opentelemetry/api": "^1.9.0",
-    "@xylabs/assert": "^4.12.8",
-    "@xylabs/base": "^4.12.8",
-    "@xylabs/events": "^4.12.8",
-    "@xylabs/logger": "^4.12.8",
-    "@xylabs/object": "^4.12.8",
-    "@xylabs/typeof": "^4.12.8"
+    "@xylabs/assert": "^4.12.10",
+    "@xylabs/base": "^4.12.10",
+    "@xylabs/events": "^4.12.10",
+    "@xylabs/logger": "^4.12.10",
+    "@xylabs/object": "^4.12.10",
+    "@xylabs/typeof": "^4.12.10"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "^6.5.8",

package/src/AbstractCreatable.ts

@@ -4,12 +4,13 @@ import { BaseEmitter } from '@xylabs/events'
 import { type Logger } from '@xylabs/logger'
 import type { EmptyObject } from '@xylabs/object'
 import type { Promisable } from '@xylabs/promise'
+import { isError } from '@xylabs/typeof'
 
 import type { Creatable } from './Creatable.ts'
-import type { CreatableInstance } from './CreatableInstance.ts'
-import type { CreatableName, CreatableParams } from './CreatableParams.ts'
-import { getFunctionName } from './getFunctionName.ts'
-import { getRootFunction } from './getRootFunction.ts'
+import { getFunctionName, getRootFunction } from './lib/index.ts'
+import type {
+  CreatableInstance, CreatableName, CreatableParams,
+} from './model/index.ts'
 
 export abstract class AbstractCreatable<TParams extends EmptyObject | void = void,
   TEventData extends EventData = EventData> extends BaseEmitter<Partial<CreatableParams<TParams>>, TEventData> {
@@ -29,19 +30,57 @@ export abstract class AbstractCreatable<TParams extends EmptyObject | void = voi
     return this._populatedParams
   }
 
+  get statusReporter() {
+    return this.params.statusReporter
+  }
+
   static async create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(
     this: Creatable<T, TParams>,
     params: Partial<CreatableParams<TParams>>,
   ): Promise<CreatableInstance<T>> {
-    const instance = new this(params)
-    await instance.createHandler()
-    return await Promise.resolve(instance as CreatableInstance<T>)
+    const name: CreatableName = params.name ?? this.name
+    params.statusReporter?.report(name, 'creating')
+    try {
+      const instance = new this(params)
+      await instance.createHandler()
+      params.statusReporter?.report(name, 'created')
+      return instance
+    } catch (ex) {
+      params.statusReporter?.report(name, 'error', isError(ex) ? ex : new Error(`Error creating: ${name}`))
+      throw new Error(`Error creating: ${name}`)
+    }
   }
 
   createHandler(): Promisable<boolean> {
     return true
   }
 
+  async start(): Promise<boolean> {
+    this._noOverride('start')
+    try {
+      this.statusReporter?.report(this.name, 'starting')
+      await this.startHandler()
+      this.statusReporter?.report(this.name, 'started')
+      return true
+    } catch (ex) {
+      this.statusReporter?.report(this.name, 'error', isError(ex) ? ex : new Error(`Error stopping: ${ex}`))
+      return false
+    }
+  }
+
+  async stop(): Promise<boolean> {
+    this._noOverride('stop')
+    try {
+      this.statusReporter?.report(this.name, 'stopping')
+      await this.stopHandler()
+      this.statusReporter?.report(this.name, 'stopped')
+      return true
+    } catch (ex) {
+      this.statusReporter?.report(this.name, 'error', isError(ex) ? ex : new Error(`Error stopping: ${ex}`))
+      return false
+    }
+  }
+
   protected _noOverride(functionName = getFunctionName(3)) {
     // eslint-disable-next-line @typescript-eslint/no-explicit-any
     const thisFunc = (this as any)[functionName]
@@ -50,5 +89,13 @@ export abstract class AbstractCreatable<TParams extends EmptyObject | void = voi
     assertEx(thisFunc === rootFunc, () => `Override not allowed for [${functionName}] - override ${functionName}Handler instead`)
   }
 
+  protected startHandler(): Promisable<void> {
+    // when overriding this, throw an error on failure
+  }
+
+  protected stopHandler(): Promisable<void> {
+    // when overriding this, throw an error on failure
+  }
+
   protected abstract paramsHandler(params?: Partial<CreatableParams<TParams>>): CreatableParams<TParams>
 }

package/src/Creatable.ts

@@ -2,8 +2,7 @@ import type { Logger } from '@xylabs/logger'
 import type { EmptyObject } from '@xylabs/object'
 
 import type { AbstractCreatable } from './AbstractCreatable.ts'
-import type { CreatableInstance } from './CreatableInstance.ts'
-import type { CreatableParams } from './CreatableParams.ts'
+import type { CreatableInstance, CreatableParams } from './model/index.ts'
 
 /*
 export interface CreatableFactory<T extends EmptyObject | void = void,
@@ -16,7 +15,7 @@ export interface Creatable<T extends EmptyObject | void = void, TParams extends
 
   defaultLogger?: Logger
 
-  new (params: Partial<CreatableParams<TParams>>): CreatableInstance<T> & AbstractCreatable<TParams>
+  new (params: Partial<CreatableParams<TParams>>): CreatableInstance<T, TParams> & AbstractCreatable<TParams>
 
   create<T extends EmptyObject | void = void, TParams extends EmptyObject | void = void>(
     this: Creatable<T, TParams>,

package/src/index.ts

@@ -1,5 +1,3 @@
 export * from './AbstractCreatable.ts'
 export * from './Creatable.ts'
-export * from './CreatableInstance.ts'
-export * from './CreatableParams.ts'
-export * from './CreatableStatusReporter.ts'
+export * from './model/index.ts'

package/src/lib/index.ts

@@ -0,0 +1,2 @@
+export * from './getFunctionName.ts'
+export * from './getRootFunction.ts'

package/src/{CreatableParams.ts → model/CreatableParams.ts}

@@ -7,7 +7,7 @@ import type { CreatableStatusReporter } from './CreatableStatusReporter.ts'
 export type CreatableName = Exclude<string, 'creatable-name-reserved-32546239486'> & BaseClassName
 
 export type CreatableParamsFields = {
-  name?: CreatableName
+  name: CreatableName
   statusReporter?: CreatableStatusReporter
 }
 

package/src/model/CreatableStatusReporter.ts

@@ -0,0 +1,8 @@
+import type { BaseClassName } from '@xylabs/base'
+
+export type CreatableStatus = 'creating' | 'created' | 'starting' | 'started' | 'stopping' | 'stopped' | 'error'
+
+export interface CreatableStatusReporter {
+  report(name: BaseClassName, status: Exclude<CreatableStatus, 'error'>, progress?: number): void
+  report(name: BaseClassName, status: Extract<CreatableStatus, 'error'>, error?: Error): void
+}

package/src/model/index.ts

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

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

@@ -1 +0,0 @@
-{"version":3,"file":"CreatableInstance.d.ts","sourceRoot":"","sources":["../../src/CreatableInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE1E,MAAM,WAAW,uBAAuB,CAAC,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI;IAChF,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,eAAe,CAAC,OAAO,CAAC,CAAA;CACjC;AAED,MAAM,MAAM,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IACxG,CAAC,SAAS,WAAW,GAAG,CAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,GAAG,uBAAuB,CAAC,OAAO,CAAC,CAAA"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"CreatableParams.d.ts","sourceRoot":"","sources":["../../src/CreatableParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AACjD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAA;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAEjD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAA;AAE3E,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,qCAAqC,CAAC,GAAG,aAAa,CAAA;AAElG,MAAM,MAAM,qBAAqB,GAAG;IAClC,IAAI,CAAC,EAAE,aAAa,CAAA;IACpB,cAAc,CAAC,EAAE,uBAAuB,CAAA;CACzC,CAAA;AAED,MAAM,MAAM,eAAe,CAAC,iBAAiB,SAAS,WAAW,GAAG,IAAI,GAAG,IAAI,IAC7E,iBAAiB,CAAC,iBAAiB,SAAS,WAAW,GAAG,qBAAqB,GAAG,iBAAiB,GAAG,qBAAqB,CAAC,CAAA"}

package/dist/types/CreatableStatusReporter.d.ts

@@ -1,6 +0,0 @@
-import type { BaseClassName } from '@xylabs/base';
-export type CreatableStatus = 'creating' | 'created' | 'starting' | 'started' | 'stopping' | 'stopped';
-export interface CreatableStatusReporter {
-    report: (name: BaseClassName, status: CreatableStatus, progress?: number) => void;
-}
-//# sourceMappingURL=CreatableStatusReporter.d.ts.map

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

@@ -1 +0,0 @@
-{"version":3,"file":"CreatableStatusReporter.d.ts","sourceRoot":"","sources":["../../src/CreatableStatusReporter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAA;AAEjD,MAAM,MAAM,eAAe,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,GAAG,UAAU,GAAG,SAAS,CAAA;AAEtG,MAAM,WAAW,uBAAuB;IACtC,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,eAAe,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;CAClF"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"getFunctionName.d.ts","sourceRoot":"","sources":["../../src/getFunctionName.ts"],"names":[],"mappings":"AAEA,wBAAgB,eAAe,CAAC,KAAK,SAAI,UAexC"}

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

@@ -1 +0,0 @@
-{"version":3,"file":"getRootFunction.d.ts","sourceRoot":"","sources":["../../src/getRootFunction.ts"],"names":[],"mappings":"AAAA,wBAAgB,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAO7D"}

package/src/CreatableStatusReporter.ts

@@ -1,7 +0,0 @@
-import type { BaseClassName } from '@xylabs/base'
-
-export type CreatableStatus = 'creating' | 'created' | 'starting' | 'started' | 'stopping' | 'stopped'
-
-export interface CreatableStatusReporter {
-  report: (name: BaseClassName, status: CreatableStatus, progress?: number) => void
-}