@xylabs/base 5.0.1 → 5.0.2

package/dist/neutral/Base.d.ts

@@ -1,7 +1,9 @@
 import type { Meter, MeterProvider, Tracer, TracerProvider } from '@opentelemetry/api';
 import type { Logger } from '@xylabs/logger';
 import type { EmptyObject } from '@xylabs/object';
-export type BaseClassName = Exclude<string, 'base-class-name-reserved-32546239486'>;
+export type BaseClassName = string & {
+    __baseClassName: true;
+};
 export type BaseParamsFields = {
     logger?: Logger;
     meterProvider?: MeterProvider;
@@ -12,7 +14,6 @@ export declare abstract class Base<TParams extends BaseParams = BaseParams> {
     static defaultLogger?: Logger;
     static readonly globalInstances: Record<BaseClassName, WeakRef<Base>[]>;
     static readonly globalInstancesCountHistory: Record<BaseClassName, number[]>;
-    static readonly uniqueName: string;
     private static _historyInterval;
     private static _historyTime;
     private static _historyTimeout?;
@@ -32,8 +33,8 @@ export declare abstract class Base<TParams extends BaseParams = BaseParams> {
     get params(): BaseParams<TParams>;
     get tracer(): Tracer | undefined;
     static gc(force?: boolean): void;
-    static gc(className: string): void;
-    static instanceCount(className: string): number;
+    static gc(className: BaseClassName): void;
+    static instanceCount(className: BaseClassName): number;
     static instanceCounts(): Record<BaseClassName, number>;
     static startHistory(): void;
     static stopHistory(): void;

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

@@ -1 +1 @@
-{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAAE,MAAM,EAAE,cAAc,EACtC,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAUjD,MAAM,MAAM,aAAa,GAAG,OAAO,CAAC,MAAM,EAAE,sCAAsC,CAAC,CAAA;AAEnF,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,aAAa,CAAC,EAAE,cAAc,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,iBAAiB,SAAS,WAAW,GAAG,WAAW,IAAI,iBAAiB,GAAG,gBAAgB,CAAA;AAElH,8BAAsB,IAAI,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IAChE,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAK;IAC5E,MAAM,CAAC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAK;IACjF,MAAM,CAAC,QAAQ,CAAC,UAAU,SAAyC;IACnE,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA2B;IAC1D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAClD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA+B;IAC9D,OAAO,CAAC,MAAM,CAAC,OAAO,CAAI;IAC1B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAmB;IACjD,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;IAMvC,MAAM,KAAK,eAAe,IAIQ,MAAM,CAFvC;IAED,MAAM,KAAK,eAAe,CAAC,KAAK,EAAE,MAAM,EAGvC;IAED,MAAM,KAAK,WAAW,IAIQ,MAAM,CAFnC;IAED,MAAM,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAGnC;IAED,MAAM,KAAK,cAAc,IAIQ,MAAM,CAFtC;IAED,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,EAEtC;IAED,MAAM,KAAK,eAAe,WAEzB;IAED,IAAI,MAAM,uBAET;IAED,IAAI,KAAK,IAAI,KAAK,GAAG,SAAS,CAE7B;IAED,IAAI,MAAM,wBAET;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAChC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAWlC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAI/C,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;IAOtD,MAAM,CAAC,YAAY,IAAI,IAAI;IAe3B,MAAM,CAAC,WAAW,IAAI,IAAI;IAO1B,OAAO,CAAC,MAAM,CAAC,YAAY;IAQ3B,OAAO,CAAC,MAAM,CAAC,KAAK;IAMpB,OAAO,CAAC,MAAM,CAAC,OAAO;IAKtB,OAAO,CAAC,cAAc;CAKvB"}
+{"version":3,"file":"Base.d.ts","sourceRoot":"","sources":["../../src/Base.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,KAAK,EACL,aAAa,EAAE,MAAM,EAAE,cAAc,EACtC,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAA;AAC5C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAA;AAQjD,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG;IAAE,eAAe,EAAE,IAAI,CAAA;CAAE,CAAA;AAE9D,MAAM,MAAM,gBAAgB,GAAG;IAC7B,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,aAAa,CAAC,EAAE,aAAa,CAAA;IAC7B,aAAa,CAAC,EAAE,cAAc,CAAA;CAC/B,CAAA;AAED,MAAM,MAAM,UAAU,CAAC,iBAAiB,SAAS,WAAW,GAAG,WAAW,IAAI,iBAAiB,GAAG,gBAAgB,CAAA;AAElH,8BAAsB,IAAI,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU;IAChE,MAAM,CAAC,aAAa,CAAC,EAAE,MAAM,CAAA;IAC7B,MAAM,CAAC,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC,aAAa,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC,CAAK;IAC5E,MAAM,CAAC,QAAQ,CAAC,2BAA2B,EAAE,MAAM,CAAC,aAAa,EAAE,MAAM,EAAE,CAAC,CAAK;IACjF,OAAO,CAAC,MAAM,CAAC,gBAAgB,CAA2B;IAC1D,OAAO,CAAC,MAAM,CAAC,YAAY,CAAuB;IAClD,OAAO,CAAC,MAAM,CAAC,eAAe,CAAC,CAA+B;IAC9D,OAAO,CAAC,MAAM,CAAC,OAAO,CAAI;IAC1B,OAAO,CAAC,MAAM,CAAC,eAAe,CAAmB;IACjD,OAAO,CAAC,OAAO,CAAqB;gBAExB,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;IAMvC,MAAM,KAAK,eAAe,IAIQ,MAAM,CAFvC;IAED,MAAM,KAAK,eAAe,CAAC,KAAK,EAAE,MAAM,EAGvC;IAED,MAAM,KAAK,WAAW,IAIQ,MAAM,CAFnC;IAED,MAAM,KAAK,WAAW,CAAC,KAAK,EAAE,MAAM,EAGnC;IAED,MAAM,KAAK,cAAc,IAIQ,MAAM,CAFtC;IAED,MAAM,KAAK,cAAc,CAAC,KAAK,EAAE,MAAM,EAEtC;IAED,MAAM,KAAK,eAAe,WAEzB;IAED,IAAI,MAAM,uBAET;IAED,IAAI,KAAK,IAAI,KAAK,GAAG,SAAS,CAE7B;IAED,IAAI,MAAM,wBAET;IAED,IAAI,MAAM,IAAI,MAAM,GAAG,SAAS,CAE/B;IAED,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,GAAG,IAAI;IAChC,MAAM,CAAC,EAAE,CAAC,SAAS,EAAE,aAAa,GAAG,IAAI;IAWzC,MAAM,CAAC,aAAa,CAAC,SAAS,EAAE,aAAa,GAAG,MAAM;IAItD,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,aAAa,EAAE,MAAM,CAAC;IAOtD,MAAM,CAAC,YAAY,IAAI,IAAI;IAe3B,MAAM,CAAC,WAAW,IAAI,IAAI;IAO1B,OAAO,CAAC,MAAM,CAAC,YAAY;IAQ3B,OAAO,CAAC,MAAM,CAAC,KAAK;IAMpB,OAAO,CAAC,MAAM,CAAC,OAAO;IAKtB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/neutral/UniqueBase.d.ts

@@ -0,0 +1,9 @@
+import type { BaseParams } from './Base.ts';
+import { Base } from './Base.ts';
+export declare abstract class UniqueBase<TParams extends BaseParams = BaseParams> extends Base<TParams> {
+    static readonly uniqueDomain = "xy";
+    static readonly uniqueName: string;
+    static readonly uniqueNameXyo: string;
+    constructor(params: BaseParams<TParams>);
+}
+//# sourceMappingURL=UniqueBase.d.ts.map

package/dist/neutral/UniqueBase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"UniqueBase.d.ts","sourceRoot":"","sources":["../../src/UniqueBase.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC3C,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAGhC,8BAAsB,UAAU,CAAC,OAAO,SAAS,UAAU,GAAG,UAAU,CAAE,SAAQ,IAAI,CAAC,OAAO,CAAC;IAC7F,MAAM,CAAC,QAAQ,CAAC,YAAY,QAAO;IACnC,MAAM,CAAC,QAAQ,CAAC,UAAU,SAAqD;IAE/E,MAAM,CAAC,QAAQ,CAAC,aAAa,SAAyC;gBAC1D,MAAM,EAAE,UAAU,CAAC,OAAO,CAAC;CAGxC"}

package/dist/neutral/globallyUnique.d.ts

@@ -5,5 +5,5 @@ declare global {
     };
 }
 export declare const disableGloballyUnique: () => void;
-export declare const globallyUnique: (name: string, value: unknown, domain?: string) => string;
+export declare const globallyUnique: (name: string | symbol, value: unknown, domain?: string) => string;
 //# sourceMappingURL=globallyUnique.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"globallyUnique.d.ts","sourceRoot":"","sources":["../../src/globallyUnique.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,MAAM,EAAE;QACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,cAAc,CAAC,EAAE,OAAO,CAAA;KACzB,CAAA;CACF;AAOD,eAAO,MAAM,qBAAqB,YAEjC,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,EAAE,OAAO,OAAO,EAAE,eAAiB,WAgB7E,CAAA"}
+{"version":3,"file":"globallyUnique.d.ts","sourceRoot":"","sources":["../../src/globallyUnique.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,CAAC;IACb,IAAI,MAAM,EAAE;QACV,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;QAC/B,cAAc,CAAC,EAAE,OAAO,CAAA;KACzB,CAAA;CACF;AAOD,eAAO,MAAM,qBAAqB,YAEjC,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,MAAM,MAAM,GAAG,MAAM,EAAE,OAAO,OAAO,EAAE,eAAiB,WAgBtF,CAAA"}

package/dist/neutral/index.d.ts

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

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

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

package/dist/neutral/index.mjs

@@ -1,33 +1,5 @@
 // src/Base.ts
 import { assertEx } from "@xylabs/assert";
-
-// src/globallyUnique.ts
-var xyoGlobal = () => {
-  globalThis.xylabs = globalThis.xylabs ?? {};
-  return globalThis.xylabs;
-};
-var disableGloballyUnique = () => {
-  xyoGlobal().uniqueDisabled = true;
-};
-var globallyUnique = (name, value, domain = "global") => {
-  const uniqueName = domain === "bundle" ? [domain, name].join(":") : [domain, import.meta.url, name].join(":");
-  if (!xyoGlobal().uniqueDisabled) {
-    const xylabs = globalThis.xylabs = globalThis.xylabs ?? {};
-    const unique = xylabs.unique = xylabs.unique ?? {};
-    if (unique[uniqueName] === void 0) {
-      unique[uniqueName] = value;
-    } else {
-      if (unique[uniqueName] !== value) {
-        throw new Error(
-          `Global unique item ${uniqueName} already defined.  Make sure you are not importing two versions of the package that contains this item`
-        );
-      }
-    }
-  }
-  return uniqueName;
-};
-
-// src/Base.ts
 var DEFAULT_HISTORY_INTERVAL = 1e3 * 5;
 var DEFAULT_HISTORY_TIME = 60 * 60 * 1e3;
 var MAX_GC_FREQUENCY = 1e3 * 60;
@@ -37,7 +9,6 @@ var Base = class _Base {
   static defaultLogger;
   static globalInstances = {};
   static globalInstancesCountHistory = {};
-  static uniqueName = globallyUnique(this.name, this, "xyo");
   static _historyInterval = DEFAULT_HISTORY_INTERVAL;
   static _historyTime = DEFAULT_HISTORY_TIME;
   static _historyTimeout;
@@ -136,13 +107,52 @@ var Base = class _Base {
     this.globalInstances[className] = this.globalInstances[className]?.filter((ref) => ref.deref() !== null) ?? [];
   }
   recordInstance() {
-    const instanceArray = _Base.globalInstances[this.constructor.name] ?? [];
+    const baseClassName = this.constructor.name;
+    const instanceArray = _Base.globalInstances[baseClassName] ?? [];
     instanceArray.push(new WeakRef(this));
-    _Base.globalInstances[this.constructor.name] = instanceArray;
+    _Base.globalInstances[baseClassName] = instanceArray;
+  }
+};
+
+// src/globallyUnique.ts
+var xyoGlobal = () => {
+  globalThis.xylabs = globalThis.xylabs ?? {};
+  return globalThis.xylabs;
+};
+var disableGloballyUnique = () => {
+  xyoGlobal().uniqueDisabled = true;
+};
+var globallyUnique = (name, value, domain = "global") => {
+  const uniqueName = domain === "bundle" ? [domain, name].join(":") : [domain, import.meta.url, name].join(":");
+  if (!xyoGlobal().uniqueDisabled) {
+    const xylabs = globalThis.xylabs = globalThis.xylabs ?? {};
+    const unique = xylabs.unique = xylabs.unique ?? {};
+    if (unique[uniqueName] === void 0) {
+      unique[uniqueName] = value;
+    } else {
+      if (unique[uniqueName] !== value) {
+        throw new Error(
+          `Global unique item ${uniqueName} already defined.  Make sure you are not importing two versions of the package that contains this item`
+        );
+      }
+    }
+  }
+  return uniqueName;
+};
+
+// src/UniqueBase.ts
+var UniqueBase = class extends Base {
+  static uniqueDomain = "xy";
+  static uniqueName = globallyUnique(this.name, this, this.uniqueDomain);
+  // TODO: Remove xyo domain version when old xyo versions are no longer needed
+  static uniqueNameXyo = globallyUnique(this.name, this, "xyo");
+  constructor(params) {
+    super(params);
   }
 };
 export {
   Base,
+  UniqueBase,
   disableGloballyUnique,
   globallyUnique
 };

package/dist/neutral/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/Base.ts","../../src/globallyUnique.ts"],"sourcesContent":["import type {\n  Meter,\n  MeterProvider, Tracer, TracerProvider,\n} from '@opentelemetry/api'\nimport { assertEx } from '@xylabs/assert'\nimport type { Logger } from '@xylabs/logger'\nimport type { EmptyObject } from '@xylabs/object'\n\nimport { globallyUnique } from './globallyUnique.ts'\n\nconst DEFAULT_HISTORY_INTERVAL = 1000 * 5\nconst DEFAULT_HISTORY_TIME = 60 * 60 * 1000\nconst MAX_GC_FREQUENCY = 1000 * 60\nconst MIN_GC_FREQUENCY = 1000\nconst MIN_HISTORY_INTERVAL = 1000\n\nexport type BaseClassName = Exclude<string, 'base-class-name-reserved-32546239486'>\n\nexport type BaseParamsFields = {\n  logger?: Logger\n  meterProvider?: MeterProvider\n  traceProvider?: TracerProvider\n}\n\nexport type BaseParams<TAdditionalParams extends EmptyObject = EmptyObject> = TAdditionalParams & BaseParamsFields\n\nexport abstract class Base<TParams extends BaseParams = BaseParams> {\n  static defaultLogger?: Logger\n  static readonly globalInstances: Record<BaseClassName, WeakRef<Base>[]> = {}\n  static readonly globalInstancesCountHistory: Record<BaseClassName, number[]> = {}\n  static readonly uniqueName = globallyUnique(this.name, this, 'xyo')\n  private static _historyInterval = DEFAULT_HISTORY_INTERVAL\n  private static _historyTime = DEFAULT_HISTORY_TIME\n  private static _historyTimeout?: ReturnType<typeof setTimeout>\n  private static _lastGC = 0\n  private static _maxGcFrequency = MAX_GC_FREQUENCY\n  private _params: BaseParams<TParams>\n\n  constructor(params: BaseParams<TParams>) {\n    this._params = params\n    params?.logger?.debug(`Base constructed [${Object(this).name}]`)\n    this.recordInstance()\n  }\n\n  static get historyInterval() {\n    return this._historyInterval\n  }\n\n  static set historyInterval(value: number) {\n    assertEx(value <= this.historyTime, () => `historyInterval [${value}] must be less than or equal to historyTime [${this.historyTime}]`)\n    this._historyInterval = Math.max(value, MIN_HISTORY_INTERVAL)\n  }\n\n  static get historyTime() {\n    return this._historyTime\n  }\n\n  static set historyTime(value: number) {\n    assertEx(value >= this.historyInterval, () => `historyTime [${value}] must be greater than or equal to historyInterval [${this.historyInterval}]`)\n    this._historyInterval = value\n  }\n\n  static get maxGcFrequency() {\n    return this._maxGcFrequency\n  }\n\n  static set maxGcFrequency(value: number) {\n    this._maxGcFrequency = Math.max(value, MIN_GC_FREQUENCY)\n  }\n\n  static get maxHistoryDepth() {\n    return Math.floor(this.historyTime / this.historyInterval)\n  }\n\n  get logger() {\n    return this.params?.logger ?? Base.defaultLogger\n  }\n\n  get meter(): Meter | undefined {\n    return this.params?.meterProvider?.getMeter(this.constructor.name)\n  }\n\n  get params() {\n    return this._params\n  }\n\n  get tracer(): Tracer | undefined {\n    return this.params?.traceProvider?.getTracer(this.constructor.name)\n  }\n\n  static gc(force?: boolean): void\n  static gc(className: string): void\n  static gc(classNameOrForce: string | boolean = false): void {\n    if (typeof classNameOrForce === 'string') {\n      this.gcClass(classNameOrForce)\n    } else {\n      if (classNameOrForce || Date.now() - this._lastGC > this._maxGcFrequency) {\n        this.gcAll()\n      }\n    }\n  }\n\n  static instanceCount(className: string): number {\n    return this.globalInstances[className]?.length ?? 0\n  }\n\n  static instanceCounts(): Record<BaseClassName, number> {\n    this.gc()\n    const result: Record<BaseClassName, number> = {}\n    for (const [className, instances] of Object.entries(this.globalInstances)) result[className] = instances.length\n    return result\n  }\n\n  static startHistory(): void {\n    if (this._historyTimeout) {\n      this.stopHistory()\n    }\n\n    const timeoutHandler = () => {\n      if (this._historyTimeout) {\n        this.addToHistory()\n        this._historyTimeout = setTimeout(timeoutHandler, this.historyInterval)\n      }\n    }\n\n    this._historyTimeout = setTimeout(timeoutHandler, this.historyInterval)\n  }\n\n  static stopHistory(): void {\n    if (this._historyTimeout) {\n      clearTimeout(this._historyTimeout)\n      this._historyTimeout = undefined\n    }\n  }\n\n  private static addToHistory() {\n    const counts = this.instanceCounts()\n    for (const className of Object.keys(this.globalInstances)) {\n      this.globalInstancesCountHistory[className] = this.globalInstancesCountHistory[className]?.slice(-this.maxHistoryDepth) ?? []\n      this.globalInstancesCountHistory[className].push(counts[className])\n    }\n  }\n\n  private static gcAll() {\n    for (const className of Object.keys(this.globalInstances)) {\n      this.gcClass(className)\n    }\n  }\n\n  private static gcClass(className: BaseClassName) {\n    // remove all the weak refs that are now empty\n    this.globalInstances[className] = this.globalInstances[className]?.filter(ref => ref.deref() !== null) ?? []\n  }\n\n  private recordInstance() {\n    const instanceArray = Base.globalInstances[this.constructor.name] ?? []\n    instanceArray.push(new WeakRef(this))\n    Base.globalInstances[this.constructor.name] = instanceArray\n  }\n}\n","declare global {\n  var xylabs: {\n    unique: Record<string, unknown>\n    uniqueDisabled?: boolean\n  }\n}\n\nconst xyoGlobal = () => {\n  globalThis.xylabs = globalThis.xylabs ?? {}\n  return globalThis.xylabs\n}\n\nexport const disableGloballyUnique = () => {\n  xyoGlobal().uniqueDisabled = true\n}\n\nexport const globallyUnique = (name: string, value: unknown, domain = 'global') => {\n  const uniqueName = domain === 'bundle' ? [domain, name].join(':') : [domain, import.meta.url, name].join(':')\n  if (!xyoGlobal().uniqueDisabled) {\n    const xylabs = globalThis.xylabs = globalThis.xylabs ?? {}\n    const unique = (xylabs.unique = xylabs.unique ?? {})\n    if (unique[uniqueName] === undefined) {\n      unique[uniqueName] = value\n    } else {\n      if (unique[uniqueName] !== value) {\n        throw new Error(\n          `Global unique item ${uniqueName} already defined.  Make sure you are not importing two versions of the package that contains this item`,\n        )\n      }\n    }\n  }\n  return uniqueName\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../src/Base.ts","../../src/globallyUnique.ts","../../src/UniqueBase.ts"],"sourcesContent":["import type {\n  Meter,\n  MeterProvider, Tracer, TracerProvider,\n} from '@opentelemetry/api'\nimport { assertEx } from '@xylabs/assert'\nimport type { Logger } from '@xylabs/logger'\nimport type { EmptyObject } from '@xylabs/object'\n\nconst DEFAULT_HISTORY_INTERVAL = 1000 * 5\nconst DEFAULT_HISTORY_TIME = 60 * 60 * 1000\nconst MAX_GC_FREQUENCY = 1000 * 60\nconst MIN_GC_FREQUENCY = 1000\nconst MIN_HISTORY_INTERVAL = 1000\n\nexport type BaseClassName = string & { __baseClassName: true }\n\nexport type BaseParamsFields = {\n  logger?: Logger\n  meterProvider?: MeterProvider\n  traceProvider?: TracerProvider\n}\n\nexport type BaseParams<TAdditionalParams extends EmptyObject = EmptyObject> = TAdditionalParams & BaseParamsFields\n\nexport abstract class Base<TParams extends BaseParams = BaseParams> {\n  static defaultLogger?: Logger\n  static readonly globalInstances: Record<BaseClassName, WeakRef<Base>[]> = {}\n  static readonly globalInstancesCountHistory: Record<BaseClassName, number[]> = {}\n  private static _historyInterval = DEFAULT_HISTORY_INTERVAL\n  private static _historyTime = DEFAULT_HISTORY_TIME\n  private static _historyTimeout?: ReturnType<typeof setTimeout>\n  private static _lastGC = 0\n  private static _maxGcFrequency = MAX_GC_FREQUENCY\n  private _params: BaseParams<TParams>\n\n  constructor(params: BaseParams<TParams>) {\n    this._params = params\n    params?.logger?.debug(`Base constructed [${Object(this).name}]`)\n    this.recordInstance()\n  }\n\n  static get historyInterval() {\n    return this._historyInterval\n  }\n\n  static set historyInterval(value: number) {\n    assertEx(value <= this.historyTime, () => `historyInterval [${value}] must be less than or equal to historyTime [${this.historyTime}]`)\n    this._historyInterval = Math.max(value, MIN_HISTORY_INTERVAL)\n  }\n\n  static get historyTime() {\n    return this._historyTime\n  }\n\n  static set historyTime(value: number) {\n    assertEx(value >= this.historyInterval, () => `historyTime [${value}] must be greater than or equal to historyInterval [${this.historyInterval}]`)\n    this._historyInterval = value\n  }\n\n  static get maxGcFrequency() {\n    return this._maxGcFrequency\n  }\n\n  static set maxGcFrequency(value: number) {\n    this._maxGcFrequency = Math.max(value, MIN_GC_FREQUENCY)\n  }\n\n  static get maxHistoryDepth() {\n    return Math.floor(this.historyTime / this.historyInterval)\n  }\n\n  get logger() {\n    return this.params?.logger ?? Base.defaultLogger\n  }\n\n  get meter(): Meter | undefined {\n    return this.params?.meterProvider?.getMeter(this.constructor.name)\n  }\n\n  get params() {\n    return this._params\n  }\n\n  get tracer(): Tracer | undefined {\n    return this.params?.traceProvider?.getTracer(this.constructor.name)\n  }\n\n  static gc(force?: boolean): void\n  static gc(className: BaseClassName): void\n  static gc(classNameOrForce: BaseClassName | boolean = false): void {\n    if (typeof classNameOrForce === 'string') {\n      this.gcClass(classNameOrForce)\n    } else {\n      if (classNameOrForce || Date.now() - this._lastGC > this._maxGcFrequency) {\n        this.gcAll()\n      }\n    }\n  }\n\n  static instanceCount(className: BaseClassName): number {\n    return this.globalInstances[className]?.length ?? 0\n  }\n\n  static instanceCounts(): Record<BaseClassName, number> {\n    this.gc()\n    const result: Record<BaseClassName, number> = {}\n    for (const [className, instances] of Object.entries(this.globalInstances)) result[className as BaseClassName] = instances.length\n    return result\n  }\n\n  static startHistory(): void {\n    if (this._historyTimeout) {\n      this.stopHistory()\n    }\n\n    const timeoutHandler = () => {\n      if (this._historyTimeout) {\n        this.addToHistory()\n        this._historyTimeout = setTimeout(timeoutHandler, this.historyInterval)\n      }\n    }\n\n    this._historyTimeout = setTimeout(timeoutHandler, this.historyInterval)\n  }\n\n  static stopHistory(): void {\n    if (this._historyTimeout) {\n      clearTimeout(this._historyTimeout)\n      this._historyTimeout = undefined\n    }\n  }\n\n  private static addToHistory() {\n    const counts = this.instanceCounts()\n    for (const className of Object.keys(this.globalInstances) as BaseClassName[]) {\n      this.globalInstancesCountHistory[className] = this.globalInstancesCountHistory[className]?.slice(-this.maxHistoryDepth) ?? []\n      this.globalInstancesCountHistory[className].push(counts[className])\n    }\n  }\n\n  private static gcAll() {\n    for (const className of Object.keys(this.globalInstances) as BaseClassName[]) {\n      this.gcClass(className)\n    }\n  }\n\n  private static gcClass(className: BaseClassName) {\n    // remove all the weak refs that are now empty\n    this.globalInstances[className] = this.globalInstances[className]?.filter(ref => ref.deref() !== null) ?? []\n  }\n\n  private recordInstance() {\n    const baseClassName = this.constructor.name as BaseClassName\n    const instanceArray = Base.globalInstances[baseClassName] ?? []\n    instanceArray.push(new WeakRef(this))\n    Base.globalInstances[baseClassName] = instanceArray\n  }\n}\n","declare global {\n  var xylabs: {\n    unique: Record<string, unknown>\n    uniqueDisabled?: boolean\n  }\n}\n\nconst xyoGlobal = () => {\n  globalThis.xylabs = globalThis.xylabs ?? {}\n  return globalThis.xylabs\n}\n\nexport const disableGloballyUnique = () => {\n  xyoGlobal().uniqueDisabled = true\n}\n\nexport const globallyUnique = (name: string | symbol, value: unknown, domain = 'global') => {\n  const uniqueName = domain === 'bundle' ? [domain, name].join(':') : [domain, import.meta.url, name].join(':')\n  if (!xyoGlobal().uniqueDisabled) {\n    const xylabs = globalThis.xylabs = globalThis.xylabs ?? {}\n    const unique = (xylabs.unique = xylabs.unique ?? {})\n    if (unique[uniqueName] === undefined) {\n      unique[uniqueName] = value\n    } else {\n      if (unique[uniqueName] !== value) {\n        throw new Error(\n          `Global unique item ${uniqueName} already defined.  Make sure you are not importing two versions of the package that contains this item`,\n        )\n      }\n    }\n  }\n  return uniqueName\n}\n","import type { BaseParams } from './Base.ts'\nimport { Base } from './Base.ts'\nimport { globallyUnique } from './globallyUnique.ts'\n\nexport abstract class UniqueBase<TParams extends BaseParams = BaseParams> extends Base<TParams> {\n  static readonly uniqueDomain = 'xy'\n  static readonly uniqueName = globallyUnique(this.name, this, this.uniqueDomain)\n  // TODO: Remove xyo domain version when old xyo versions are no longer needed\n  static readonly uniqueNameXyo = globallyUnique(this.name, this, 'xyo')\n  constructor(params: BaseParams<TParams>) {\n    super(params)\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xylabs/base",
-  "version": "5.0.1",
+  "version": "5.0.2",
   "description": "Base functionality used throughout XY Labs TypeScript/JavaScript libraries",
   "homepage": "https://xyo.network",
   "bugs": {
@@ -36,9 +36,9 @@
   ],
   "dependencies": {
     "@opentelemetry/api": "~1.9.0",
-    "@xylabs/assert": "~5.0.1",
-    "@xylabs/logger": "~5.0.1",
-    "@xylabs/object": "~5.0.1"
+    "@xylabs/assert": "~5.0.2",
+    "@xylabs/logger": "~5.0.2",
+    "@xylabs/object": "~5.0.2"
   },
   "devDependencies": {
     "@xylabs/ts-scripts-yarn3": "~7.0.3",

package/src/Base.ts

@@ -6,15 +6,13 @@ import { assertEx } from '@xylabs/assert'
 import type { Logger } from '@xylabs/logger'
 import type { EmptyObject } from '@xylabs/object'
 
-import { globallyUnique } from './globallyUnique.ts'
-
 const DEFAULT_HISTORY_INTERVAL = 1000 * 5
 const DEFAULT_HISTORY_TIME = 60 * 60 * 1000
 const MAX_GC_FREQUENCY = 1000 * 60
 const MIN_GC_FREQUENCY = 1000
 const MIN_HISTORY_INTERVAL = 1000
 
-export type BaseClassName = Exclude<string, 'base-class-name-reserved-32546239486'>
+export type BaseClassName = string & { __baseClassName: true }
 
 export type BaseParamsFields = {
   logger?: Logger
@@ -28,7 +26,6 @@ export abstract class Base<TParams extends BaseParams = BaseParams> {
   static defaultLogger?: Logger
   static readonly globalInstances: Record<BaseClassName, WeakRef<Base>[]> = {}
   static readonly globalInstancesCountHistory: Record<BaseClassName, number[]> = {}
-  static readonly uniqueName = globallyUnique(this.name, this, 'xyo')
   private static _historyInterval = DEFAULT_HISTORY_INTERVAL
   private static _historyTime = DEFAULT_HISTORY_TIME
   private static _historyTimeout?: ReturnType<typeof setTimeout>
@@ -89,8 +86,8 @@ export abstract class Base<TParams extends BaseParams = BaseParams> {
   }
 
   static gc(force?: boolean): void
-  static gc(className: string): void
-  static gc(classNameOrForce: string | boolean = false): void {
+  static gc(className: BaseClassName): void
+  static gc(classNameOrForce: BaseClassName | boolean = false): void {
     if (typeof classNameOrForce === 'string') {
       this.gcClass(classNameOrForce)
     } else {
@@ -100,14 +97,14 @@ export abstract class Base<TParams extends BaseParams = BaseParams> {
     }
   }
 
-  static instanceCount(className: string): number {
+  static instanceCount(className: BaseClassName): number {
     return this.globalInstances[className]?.length ?? 0
   }
 
   static instanceCounts(): Record<BaseClassName, number> {
     this.gc()
     const result: Record<BaseClassName, number> = {}
-    for (const [className, instances] of Object.entries(this.globalInstances)) result[className] = instances.length
+    for (const [className, instances] of Object.entries(this.globalInstances)) result[className as BaseClassName] = instances.length
     return result
   }
 
@@ -135,14 +132,14 @@ export abstract class Base<TParams extends BaseParams = BaseParams> {
 
   private static addToHistory() {
     const counts = this.instanceCounts()
-    for (const className of Object.keys(this.globalInstances)) {
+    for (const className of Object.keys(this.globalInstances) as BaseClassName[]) {
       this.globalInstancesCountHistory[className] = this.globalInstancesCountHistory[className]?.slice(-this.maxHistoryDepth) ?? []
       this.globalInstancesCountHistory[className].push(counts[className])
     }
   }
 
   private static gcAll() {
-    for (const className of Object.keys(this.globalInstances)) {
+    for (const className of Object.keys(this.globalInstances) as BaseClassName[]) {
       this.gcClass(className)
     }
   }
@@ -153,8 +150,9 @@ export abstract class Base<TParams extends BaseParams = BaseParams> {
   }
 
   private recordInstance() {
-    const instanceArray = Base.globalInstances[this.constructor.name] ?? []
+    const baseClassName = this.constructor.name as BaseClassName
+    const instanceArray = Base.globalInstances[baseClassName] ?? []
     instanceArray.push(new WeakRef(this))
-    Base.globalInstances[this.constructor.name] = instanceArray
+    Base.globalInstances[baseClassName] = instanceArray
   }
 }

package/src/UniqueBase.ts

@@ -0,0 +1,13 @@
+import type { BaseParams } from './Base.ts'
+import { Base } from './Base.ts'
+import { globallyUnique } from './globallyUnique.ts'
+
+export abstract class UniqueBase<TParams extends BaseParams = BaseParams> extends Base<TParams> {
+  static readonly uniqueDomain = 'xy'
+  static readonly uniqueName = globallyUnique(this.name, this, this.uniqueDomain)
+  // TODO: Remove xyo domain version when old xyo versions are no longer needed
+  static readonly uniqueNameXyo = globallyUnique(this.name, this, 'xyo')
+  constructor(params: BaseParams<TParams>) {
+    super(params)
+  }
+}

package/src/globallyUnique.ts

@@ -14,7 +14,7 @@ export const disableGloballyUnique = () => {
   xyoGlobal().uniqueDisabled = true
 }
 
-export const globallyUnique = (name: string, value: unknown, domain = 'global') => {
+export const globallyUnique = (name: string | symbol, value: unknown, domain = 'global') => {
   const uniqueName = domain === 'bundle' ? [domain, name].join(':') : [domain, import.meta.url, name].join(':')
   if (!xyoGlobal().uniqueDisabled) {
     const xylabs = globalThis.xylabs = globalThis.xylabs ?? {}

package/src/index.ts

@@ -1,2 +1,3 @@
 export * from './Base.ts'
 export * from './globallyUnique.ts'
+export * from './UniqueBase.ts'