@xylabs/creatable 4.12.21 → 4.12.23

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\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(params: Partial<TParams>) {\n    super(params)\n  }\n\n  get name(): CreatableName {\n    return this.params.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(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 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 { EmptyObject } from '@xylabs/object'\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(params: Partial<T['params']>): 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 EmptyObject | void = void, TParams extends CreatableParams = CreatableParams>() {\n  return <U extends Creatable<CreatableInstance<T, 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","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/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\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(params: Partial<TParams>) {\n    super(params)\n  }\n\n  get name(): CreatableName {\n    return this.params.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(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 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 } 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(params: Partial<T['params']>): 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":[]}

package/dist/types/Creatable.d.ts

@@ -1,8 +1,7 @@
 import type { Logger } from '@xylabs/logger';
-import type { EmptyObject } from '@xylabs/object';
 import type { Promisable } from '@xylabs/promise';
 import type { AbstractCreatable } from './AbstractCreatable.ts';
-import type { CreatableInstance, CreatableParams } from './model/index.ts';
+import type { CreatableInstance } from './model/index.ts';
 export interface Creatable<T extends CreatableInstance = CreatableInstance> {
     defaultLogger?: Logger;
     new (params: Partial<T['params']>): T & AbstractCreatable<T['params']>;
@@ -16,7 +15,7 @@ export interface Creatable<T extends CreatableInstance = CreatableInstance> {
  * @returns The decorated Module requiring it implement the members
  * of the CreatableModule as statics properties/methods
  */
-export declare function creatable<T extends EmptyObject | void = void, TParams extends CreatableParams = CreatableParams>(): <U extends Creatable<CreatableInstance<T, TParams>>>(constructor: U) => void;
+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

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;AACjD,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,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAErE,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,WAAW,GAAG,IAAI,GAAG,IAAI,EAAE,OAAO,SAAS,eAAe,GAAG,eAAe,MACtG,CAAC,SAAS,SAAS,CAAC,iBAAiB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,aAAa,CAAC,UAI3E;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,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAA;AASzD,MAAM,WAAW,SAAS,CAAC,CAAC,SAAS,iBAAiB,GAAG,iBAAiB;IAExE,aAAa,CAAC,EAAE,MAAM,CAAA;IAEtB,KAAI,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,GAAG,iBAAiB,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAA;IAErE,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"}

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

@@ -1,10 +1,8 @@
 import type { EventData } from '@xylabs/events';
-import type { EmptyObject } from '@xylabs/object';
 import type { CreatableName, CreatableParams } from './CreatableParams.ts';
-export interface CreatableInstanceFields<TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> {
-    eventData: TEventData;
+export interface CreatableInstance {
+    eventData: EventData;
     name: CreatableName;
-    params: CreatableParams<TParams>;
+    params: CreatableParams;
 }
-export type CreatableInstance<T extends EmptyObject | void = void, TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> = T extends void ? CreatableInstanceFields<TParams, TEventData> : (T & CreatableInstanceFields<TParams, TEventData>);
 //# sourceMappingURL=CreatableInstance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"CreatableInstance.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAC/C,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,eAAe,GAAG,eAAe,EAAE,UAAU,SAAS,SAAS,GAAG,SAAS;IAClI,SAAS,EAAE,UAAU,CAAA;IACrB,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,eAAe,GAAG,eAAe,EAAE,UAAU,SAAS,SAAS,GAAG,SAAS,IAC1J,CAAC,SAAS,IAAI,GAAG,uBAAuB,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,CAAC,CAAC,GAAG,uBAAuB,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAA"}
+{"version":3,"file":"CreatableInstance.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableInstance.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAA;AAE/C,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AAE1E,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,SAAS,CAAA;IACpB,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,EAAE,eAAe,CAAA;CACxB"}

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

@@ -1,11 +1,8 @@
 import type { BaseClassName } from '@xylabs/base';
-import type { BaseEmitterParams } from '@xylabs/events';
-import type { EmptyObject } from '@xylabs/object';
 import type { CreatableStatusReporter } from './CreatableStatusReporter.ts';
 export type CreatableName = Exclude<string, 'creatable-name-reserved-32546239486'> & BaseClassName;
-export interface CreatableParamsFields {
+export interface CreatableParams {
     name: CreatableName;
     statusReporter?: CreatableStatusReporter;
 }
-export type CreatableParams<TAdditionalParams extends EmptyObject = EmptyObject> = BaseEmitterParams<TAdditionalParams & CreatableParamsFields>;
 //# sourceMappingURL=CreatableParams.d.ts.map

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

@@ -1 +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,WAAW,qBAAqB;IACpC,IAAI,EAAE,aAAa,CAAA;IACnB,cAAc,CAAC,EAAE,uBAAuB,CAAA;CACzC;AAED,MAAM,MAAM,eAAe,CAAC,iBAAiB,SAAS,WAAW,GAAG,WAAW,IAC3E,iBAAiB,CAAC,iBAAiB,GAAG,qBAAqB,CAAC,CAAA"}
+{"version":3,"file":"CreatableParams.d.ts","sourceRoot":"","sources":["../../../src/model/CreatableParams.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,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,WAAW,eAAe;IAC9B,IAAI,EAAE,aAAa,CAAA;IACnB,cAAc,CAAC,EAAE,uBAAuB,CAAA;CACzC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/creatable",
-  "version": "4.12.21",
+  "version": "4.12.23",
   "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.21",
-    "@xylabs/base": "^4.12.21",
-    "@xylabs/events": "^4.12.21",
-    "@xylabs/logger": "^4.12.21",
-    "@xylabs/object": "^4.12.21",
-    "@xylabs/promise": "^4.12.21",
-    "@xylabs/typeof": "^4.12.21"
+    "@xylabs/assert": "^4.12.23",
+    "@xylabs/base": "^4.12.23",
+    "@xylabs/events": "^4.12.23",
+    "@xylabs/logger": "^4.12.23",
+    "@xylabs/object": "^4.12.23",
+    "@xylabs/promise": "^4.12.23",
+    "@xylabs/typeof": "^4.12.23"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "^6.5.9",

package/src/Creatable.ts

@@ -1,9 +1,8 @@
 import type { Logger } from '@xylabs/logger'
-import type { EmptyObject } from '@xylabs/object'
 import type { Promisable } from '@xylabs/promise'
 
 import type { AbstractCreatable } from './AbstractCreatable.ts'
-import type { CreatableInstance, CreatableParams } from './model/index.ts'
+import type { CreatableInstance } from './model/index.ts'
 
 /*
 export interface CreatableFactory<T extends EmptyObject | void = void,
@@ -42,8 +41,8 @@ export interface Creatable<T extends CreatableInstance = CreatableInstance> {
  * @returns The decorated Module requiring it implement the members
  * of the CreatableModule as statics properties/methods
  */
-export function creatable<T extends EmptyObject | void = void, TParams extends CreatableParams = CreatableParams>() {
-  return <U extends Creatable<CreatableInstance<T, TParams>>>(constructor: U) => {
+export function creatable<T extends CreatableInstance>() {
+  return <U extends Creatable<T>>(constructor: U) => {
     // eslint-disable-next-line @typescript-eslint/no-unused-expressions
     constructor
   }

package/src/TestCreatable.ts

@@ -1,8 +1,9 @@
 import type { EventData } from '@xylabs/events'
+import { Promisable } from '@xylabs/promise'
 
 import { AbstractCreatable } from './AbstractCreatable.ts'
-import { creatable } from './Creatable.ts'
-import type { CreatableParams } from './model/index.ts'
+import { Creatable, creatable } from './Creatable.ts'
+import type { CreatableInstance, CreatableParams } from './model/index.ts'
 
 interface TestCreatableParams extends CreatableParams {
   testParam: string
@@ -13,6 +14,13 @@ interface TestCreatableParams extends CreatableParams {
 // eslint-disable-next-line @typescript-eslint/no-unused-vars
 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',

package/src/model/CreatableInstance.ts

@@ -1,13 +1,9 @@
 import type { EventData } from '@xylabs/events'
-import type { EmptyObject } from '@xylabs/object'
 
 import type { CreatableName, CreatableParams } from './CreatableParams.ts'
 
-export interface CreatableInstanceFields<TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData> {
-  eventData: TEventData
+export interface CreatableInstance {
+  eventData: EventData
   name: CreatableName
-  params: CreatableParams<TParams>
+  params: CreatableParams
 }
-
-export type CreatableInstance<T extends EmptyObject | void = void, TParams extends CreatableParams = CreatableParams, TEventData extends EventData = EventData>
-  = T extends void ? CreatableInstanceFields<TParams, TEventData> : (T & CreatableInstanceFields<TParams, TEventData>)

package/src/model/CreatableParams.ts

@@ -1,15 +1,10 @@
 import type { BaseClassName } from '@xylabs/base'
-import type { BaseEmitterParams } from '@xylabs/events'
-import type { EmptyObject } from '@xylabs/object'
 
 import type { CreatableStatusReporter } from './CreatableStatusReporter.ts'
 
 export type CreatableName = Exclude<string, 'creatable-name-reserved-32546239486'> & BaseClassName
 
-export interface CreatableParamsFields {
+export interface CreatableParams {
   name: CreatableName
   statusReporter?: CreatableStatusReporter
 }
-
-export type CreatableParams<TAdditionalParams extends EmptyObject = EmptyObject>
-  = BaseEmitterParams<TAdditionalParams & CreatableParamsFields>