beeai-framework 0.1.2

package/dist/internals/helpers/weakRef.cjs

@@ -0,0 +1,65 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function isWeakKey(value) {
+  return value != null && typeof value === "object";
+}
+__name(isWeakKey, "isWeakKey");
+class SafeWeakSet extends WeakSet {
+  static {
+    __name(this, "SafeWeakSet");
+  }
+  has(value) {
+    if (isWeakKey(value)) {
+      return super.has(value);
+    }
+    return false;
+  }
+  add(value) {
+    if (isWeakKey(value)) {
+      super.add(value);
+    }
+    return this;
+  }
+  delete(value) {
+    if (isWeakKey(value)) {
+      return super.delete(value);
+    }
+    return false;
+  }
+}
+class SafeWeakMap extends WeakMap {
+  static {
+    __name(this, "SafeWeakMap");
+  }
+  has(value) {
+    if (isWeakKey(value)) {
+      return super.has(value);
+    }
+    return false;
+  }
+  get(key) {
+    if (isWeakKey(key)) {
+      return super.get(key);
+    }
+  }
+  set(key, value) {
+    if (isWeakKey(key)) {
+      super.set(key, value);
+    }
+    return this;
+  }
+  delete(value) {
+    if (isWeakKey(value)) {
+      return super.delete(value);
+    }
+    return false;
+  }
+}
+
+exports.SafeWeakMap = SafeWeakMap;
+exports.SafeWeakSet = SafeWeakSet;
+exports.isWeakKey = isWeakKey;
+//# sourceMappingURL=weakRef.cjs.map
+//# sourceMappingURL=weakRef.cjs.map

package/dist/internals/helpers/weakRef.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/weakRef.ts"],"names":["isWeakKey","value","SafeWeakSet","WeakSet","has","add","delete","SafeWeakMap","WeakMap","get","key","set"],"mappings":";;;;AAgBO,SAASA,UAAUC,KAAc,EAAA;AACtC,EAAOA,OAAAA,KAAAA,IAAS,IAAQ,IAAA,OAAOA,KAAU,KAAA,QAAA;AAC3C;AAFgBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAIT,MAAME,oBAAoBC,OAAAA,CAAAA;EApBjC;;;AAqBEC,EAAAA,GAAAA,CAAIH,KAAgB,EAAA;AAClB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMG,IAAIH,KAAAA,CAAAA;AACnB;AACA,IAAO,OAAA,KAAA;AACT;AAEAI,EAAAA,GAAAA,CAAIJ,KAAgB,EAAA;AAClB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAA,KAAA,CAAMI,IAAIJ,KAAAA,CAAAA;AACZ;AACA,IAAO,OAAA,IAAA;AACT;AAEAK,EAAAA,MAAAA,CAAOL,KAAgB,EAAA;AACrB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMK,OAAOL,KAAAA,CAAAA;AACtB;AACA,IAAO,OAAA,KAAA;AACT;AACF;AAEO,MAAMM,oBAAuBC,OAAAA,CAAAA;EA3CpC;;;AA4CEJ,EAAAA,GAAAA,CAAIH,KAAgB,EAAA;AAClB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMG,IAAIH,KAAAA,CAAAA;AACnB;AACA,IAAO,OAAA,KAAA;AACT;AAEAQ,EAAAA,GAAAA,CAAIC,GAAc,EAAA;AAChB,IAAIV,IAAAA,SAAAA,CAAUU,GAAAA,CAAM,EAAA;AAClB,MAAO,OAAA,KAAA,CAAMD,IAAIC,GAAAA,CAAAA;AACnB;AACF;AAEAC,EAAAA,GAAAA,CAAID,KAAcT,KAAU,EAAA;AAC1B,IAAID,IAAAA,SAAAA,CAAUU,GAAAA,CAAM,EAAA;AAClB,MAAMC,KAAAA,CAAAA,GAAAA,CAAID,KAAKT,KAAAA,CAAAA;AACjB;AACA,IAAO,OAAA,IAAA;AACT;AAEAK,EAAAA,MAAAA,CAAOL,KAAgB,EAAA;AACrB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMK,OAAOL,KAAAA,CAAAA;AACtB;AACA,IAAO,OAAA,KAAA;AACT;AACF","file":"weakRef.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function isWeakKey(value: unknown): value is WeakKey {\n  return value != null && typeof value === \"object\";\n}\n\nexport class SafeWeakSet extends WeakSet {\n  has(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.has(value);\n    }\n    return false;\n  }\n\n  add(value: unknown) {\n    if (isWeakKey(value)) {\n      super.add(value);\n    }\n    return this;\n  }\n\n  delete(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.delete(value);\n    }\n    return false;\n  }\n}\n\nexport class SafeWeakMap<T> extends WeakMap<WeakKey, T> {\n  has(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.has(value);\n    }\n    return false;\n  }\n\n  get(key: unknown) {\n    if (isWeakKey(key)) {\n      return super.get(key);\n    }\n  }\n\n  set(key: unknown, value: T) {\n    if (isWeakKey(key)) {\n      super.set(key, value);\n    }\n    return this;\n  }\n\n  delete(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.delete(value);\n    }\n    return false;\n  }\n}\n"]}

package/dist/internals/helpers/weakRef.d.cts

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function isWeakKey(value: unknown): value is WeakKey;
+declare class SafeWeakSet extends WeakSet {
+    has(value: unknown): boolean;
+    add(value: unknown): this;
+    delete(value: unknown): boolean;
+}
+declare class SafeWeakMap<T> extends WeakMap<WeakKey, T> {
+    has(value: unknown): boolean;
+    get(key: unknown): T | undefined;
+    set(key: unknown, value: T): this;
+    delete(value: unknown): boolean;
+}
+
+export { SafeWeakMap, SafeWeakSet, isWeakKey };

package/dist/internals/helpers/weakRef.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+declare function isWeakKey(value: unknown): value is WeakKey;
+declare class SafeWeakSet extends WeakSet {
+    has(value: unknown): boolean;
+    add(value: unknown): this;
+    delete(value: unknown): boolean;
+}
+declare class SafeWeakMap<T> extends WeakMap<WeakKey, T> {
+    has(value: unknown): boolean;
+    get(key: unknown): T | undefined;
+    set(key: unknown, value: T): this;
+    delete(value: unknown): boolean;
+}
+
+export { SafeWeakMap, SafeWeakSet, isWeakKey };

package/dist/internals/helpers/weakRef.js

@@ -0,0 +1,61 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function isWeakKey(value) {
+  return value != null && typeof value === "object";
+}
+__name(isWeakKey, "isWeakKey");
+class SafeWeakSet extends WeakSet {
+  static {
+    __name(this, "SafeWeakSet");
+  }
+  has(value) {
+    if (isWeakKey(value)) {
+      return super.has(value);
+    }
+    return false;
+  }
+  add(value) {
+    if (isWeakKey(value)) {
+      super.add(value);
+    }
+    return this;
+  }
+  delete(value) {
+    if (isWeakKey(value)) {
+      return super.delete(value);
+    }
+    return false;
+  }
+}
+class SafeWeakMap extends WeakMap {
+  static {
+    __name(this, "SafeWeakMap");
+  }
+  has(value) {
+    if (isWeakKey(value)) {
+      return super.has(value);
+    }
+    return false;
+  }
+  get(key) {
+    if (isWeakKey(key)) {
+      return super.get(key);
+    }
+  }
+  set(key, value) {
+    if (isWeakKey(key)) {
+      super.set(key, value);
+    }
+    return this;
+  }
+  delete(value) {
+    if (isWeakKey(value)) {
+      return super.delete(value);
+    }
+    return false;
+  }
+}
+
+export { SafeWeakMap, SafeWeakSet, isWeakKey };
+//# sourceMappingURL=weakRef.js.map
+//# sourceMappingURL=weakRef.js.map

package/dist/internals/helpers/weakRef.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/internals/helpers/weakRef.ts"],"names":["isWeakKey","value","SafeWeakSet","WeakSet","has","add","delete","SafeWeakMap","WeakMap","get","key","set"],"mappings":";;AAgBO,SAASA,UAAUC,KAAc,EAAA;AACtC,EAAOA,OAAAA,KAAAA,IAAS,IAAQ,IAAA,OAAOA,KAAU,KAAA,QAAA;AAC3C;AAFgBD,MAAAA,CAAAA,SAAAA,EAAAA,WAAAA,CAAAA;AAIT,MAAME,oBAAoBC,OAAAA,CAAAA;EApBjC;;;AAqBEC,EAAAA,GAAAA,CAAIH,KAAgB,EAAA;AAClB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMG,IAAIH,KAAAA,CAAAA;AACnB;AACA,IAAO,OAAA,KAAA;AACT;AAEAI,EAAAA,GAAAA,CAAIJ,KAAgB,EAAA;AAClB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAA,KAAA,CAAMI,IAAIJ,KAAAA,CAAAA;AACZ;AACA,IAAO,OAAA,IAAA;AACT;AAEAK,EAAAA,MAAAA,CAAOL,KAAgB,EAAA;AACrB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMK,OAAOL,KAAAA,CAAAA;AACtB;AACA,IAAO,OAAA,KAAA;AACT;AACF;AAEO,MAAMM,oBAAuBC,OAAAA,CAAAA;EA3CpC;;;AA4CEJ,EAAAA,GAAAA,CAAIH,KAAgB,EAAA;AAClB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMG,IAAIH,KAAAA,CAAAA;AACnB;AACA,IAAO,OAAA,KAAA;AACT;AAEAQ,EAAAA,GAAAA,CAAIC,GAAc,EAAA;AAChB,IAAIV,IAAAA,SAAAA,CAAUU,GAAAA,CAAM,EAAA;AAClB,MAAO,OAAA,KAAA,CAAMD,IAAIC,GAAAA,CAAAA;AACnB;AACF;AAEAC,EAAAA,GAAAA,CAAID,KAAcT,KAAU,EAAA;AAC1B,IAAID,IAAAA,SAAAA,CAAUU,GAAAA,CAAM,EAAA;AAClB,MAAMC,KAAAA,CAAAA,GAAAA,CAAID,KAAKT,KAAAA,CAAAA;AACjB;AACA,IAAO,OAAA,IAAA;AACT;AAEAK,EAAAA,MAAAA,CAAOL,KAAgB,EAAA;AACrB,IAAID,IAAAA,SAAAA,CAAUC,KAAAA,CAAQ,EAAA;AACpB,MAAO,OAAA,KAAA,CAAMK,OAAOL,KAAAA,CAAAA;AACtB;AACA,IAAO,OAAA,KAAA;AACT;AACF","file":"weakRef.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nexport function isWeakKey(value: unknown): value is WeakKey {\n  return value != null && typeof value === \"object\";\n}\n\nexport class SafeWeakSet extends WeakSet {\n  has(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.has(value);\n    }\n    return false;\n  }\n\n  add(value: unknown) {\n    if (isWeakKey(value)) {\n      super.add(value);\n    }\n    return this;\n  }\n\n  delete(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.delete(value);\n    }\n    return false;\n  }\n}\n\nexport class SafeWeakMap<T> extends WeakMap<WeakKey, T> {\n  has(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.has(value);\n    }\n    return false;\n  }\n\n  get(key: unknown) {\n    if (isWeakKey(key)) {\n      return super.get(key);\n    }\n  }\n\n  set(key: unknown, value: T) {\n    if (isWeakKey(key)) {\n      super.set(key, value);\n    }\n    return this;\n  }\n\n  delete(value: unknown) {\n    if (isWeakKey(value)) {\n      return super.delete(value);\n    }\n    return false;\n  }\n}\n"]}

package/dist/internals/serializable.cjs

@@ -0,0 +1,63 @@
+'use strict';
+
+var serializer_cjs = require('../serializer/serializer.cjs');
+var utils_cjs = require('../serializer/utils.cjs');
+var error_cjs = require('../serializer/error.cjs');
+var decoratorCache_cjs = require('../cache/decoratorCache.cjs');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Serializable {
+  static {
+    __name(this, "Serializable");
+  }
+  constructor() {
+    Object.getPrototypeOf(this).constructor.register();
+    decoratorCache_cjs.Cache.init(this);
+  }
+  static register(aliases) {
+    serializer_cjs.Serializer.registerSerializable(this, void 0, aliases);
+  }
+  async clone() {
+    const snapshot = await this.createSnapshot();
+    const target = Object.create(this.constructor.prototype);
+    await target.loadSnapshot(snapshot);
+    return target;
+  }
+  async serialize() {
+    const snapshot = await this.createSnapshot();
+    return await serializer_cjs.Serializer.serialize({
+      target: utils_cjs.extractClassName(this),
+      snapshot
+    });
+  }
+  async deserialize(value, options) {
+    const { __root } = await serializer_cjs.Serializer.deserializeWithMeta(value, options?.extraClasses);
+    if (!__root.target) {
+      console.warn(`Serializable class must be serialized via "serialize" method and not via Serializer class. This may lead to incorrect deserialization.`);
+      return __root;
+    }
+    const current = utils_cjs.extractClassName(this);
+    if (current !== __root.target) {
+      throw new error_cjs.SerializerError(`Snapshot has been created for class '${__root.target}' but you want to use it for class '${current}'.`);
+    }
+    return __root.snapshot;
+  }
+  static async fromSnapshot(state) {
+    const target = Object.create(this.prototype);
+    await target.loadSnapshot(state);
+    decoratorCache_cjs.Cache.init(target);
+    return target;
+  }
+  static async fromSerialized(serialized, options = {}) {
+    const target = Object.create(this.prototype);
+    const state = await target.deserialize(serialized, options);
+    await target.loadSnapshot(state);
+    decoratorCache_cjs.Cache.init(target);
+    return target;
+  }
+}
+
+exports.Serializable = Serializable;
+//# sourceMappingURL=serializable.cjs.map
+//# sourceMappingURL=serializable.cjs.map

package/dist/internals/serializable.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/serializable.ts"],"names":["Serializable","constructor","Object","getPrototypeOf","register","Cache","init","aliases","Serializer","registerSerializable","undefined","clone","snapshot","createSnapshot","target","create","prototype","loadSnapshot","serialize","extractClassName","deserialize","value","options","__root","deserializeWithMeta","extraClasses","console","warn","current","SerializerError","fromSnapshot","state","fromSerialized","serialized"],"mappings":";;;;;;;;;AAkCO,MAAeA,YAAAA,CAAAA;EAlCtB;;;EAsCEC,WAAc,GAAA;AACZC,IAAAA,MAAAA,CAAOC,cAAe,CAAA,IAAI,CAAEF,CAAAA,WAAAA,CAAYG,QAAQ,EAAA;AAChDC,IAAAA,wBAAAA,CAAMC,KAAK,IAAI,CAAA;AACjB;AAEA,EAAA,OAAcF,SAAwCG,OAAoB,EAAA;AACxEC,IAAWC,yBAAAA,CAAAA,oBAAAA,CAAqB,IAAMC,EAAAA,KAAAA,CAAAA,EAAWH,OAAAA,CAAAA;AACnD;AAEA,EAAA,MAAMI,KAAmD,GAAA;AACvD,IAAMC,MAAAA,QAAAA,GAAW,MAAM,IAAA,CAAKC,cAAc,EAAA;AAE1C,IAAA,MAAMC,MAASZ,GAAAA,MAAAA,CAAOa,MAAO,CAAA,IAAA,CAAKd,YAAYe,SAAS,CAAA;AACvD,IAAMF,MAAAA,MAAAA,CAAOG,aAAaL,QAAAA,CAAAA;AAC1B,IAAOE,OAAAA,MAAAA;AACT;AAEA,EAAA,MAAMI,SAA6B,GAAA;AACjC,IAAMN,MAAAA,QAAAA,GAAW,MAAM,IAAA,CAAKC,cAAc,EAAA;AAC1C,IAAO,OAAA,MAAML,0BAAWU,SAAoC,CAAA;AAC1DJ,MAAAA,MAAAA,EAAQK,2BAAiB,IAAI,CAAA;AAC7BP,MAAAA;KACF,CAAA;AACF;EAEA,MAAgBQ,WAAAA,CAAYC,OAAeC,OAA0C,EAAA;AACnF,IAAM,MAAA,EAAEC,QAAW,GAAA,MAAMf,0BAAWgB,mBAClCH,CAAAA,KAAAA,EACAC,SAASG,YAAAA,CAAAA;AAEX,IAAI,IAAA,CAACF,OAAOT,MAAQ,EAAA;AAElBY,MAAAA,OAAAA,CAAQC,KACN,CAAwI,sIAAA,CAAA,CAAA;AAE1I,MAAOJ,OAAAA,MAAAA;AACT;AAEA,IAAMK,MAAAA,OAAAA,GAAUT,2BAAiB,IAAI,CAAA;AACrC,IAAIS,IAAAA,OAAAA,KAAYL,OAAOT,MAAQ,EAAA;AAC7B,MAAA,MAAM,IAAIe,yBACR,CAAA,CAAA,qCAAA,EAAwCN,OAAOT,MAAM,CAAA,oCAAA,EAAuCc,OAAAA,CAAW,EAAA,CAAA,CAAA;AAE3G;AACA,IAAA,OAAOL,MAAOX,CAAAA,QAAAA;AAChB;AAEA,EAAA,aAAakB,aAEXC,KACY,EAAA;AACZ,IAAA,MAAMjB,MAASZ,GAAAA,MAAAA,CAAOa,MAAO,CAAA,IAAA,CAAKC,SAAS,CAAA;AAC3C,IAAMF,MAAAA,MAAAA,CAAOG,aAAac,KAAAA,CAAAA;AAC1B1B,IAAAA,wBAAAA,CAAMC,KAAKQ,MAAAA,CAAAA;AACX,IAAOA,OAAAA,MAAAA;AACT;AAEA,EAAA,aAAakB,cAEXC,CAAAA,UAAAA,EACAX,OAA8B,GAAA,EAClB,EAAA;AACZ,IAAA,MAAMR,MAASZ,GAAAA,MAAAA,CAAOa,MAAO,CAAA,IAAA,CAAKC,SAAS,CAAA;AAC3C,IAAA,MAAMe,KAAQ,GAAA,MAAMjB,MAAOM,CAAAA,WAAAA,CAAYa,YAAYX,OAAAA,CAAAA;AACnD,IAAMR,MAAAA,MAAAA,CAAOG,aAAac,KAAAA,CAAAA;AAC1B1B,IAAAA,wBAAAA,CAAMC,KAAKQ,MAAAA,CAAAA;AACX,IAAOA,OAAAA,MAAAA;AACT;AACF","file":"serializable.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Serializer } from \"@/serializer/serializer.js\";\nimport { ClassConstructor } from \"@/internals/types.js\";\nimport { extractClassName } from \"@/serializer/utils.js\";\nimport { SerializerError } from \"@/serializer/error.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\n\nexport type SerializableClass<T> = ClassConstructor<Serializable<T>> &\n  Pick<typeof Serializable<T>, \"fromSnapshot\" | \"fromSerialized\">;\n\ninterface SerializableStructure<T> {\n  target: string;\n  snapshot: T;\n}\n\nexport interface DeserializeOptions {\n  extraClasses?: SerializableClass<unknown>[];\n}\n\nexport abstract class Serializable<T = unknown> {\n  abstract createSnapshot(): T | Promise<T>;\n  abstract loadSnapshot(snapshot: T): void | Promise<void>;\n\n  constructor() {\n    Object.getPrototypeOf(this).constructor.register();\n    Cache.init(this);\n  }\n\n  public static register<T>(this: SerializableClass<T>, aliases?: string[]) {\n    Serializer.registerSerializable(this, undefined, aliases);\n  }\n\n  async clone<T extends Serializable>(this: T): Promise<T> {\n    const snapshot = await this.createSnapshot();\n\n    const target = Object.create(this.constructor.prototype) as T;\n    await target.loadSnapshot(snapshot);\n    return target;\n  }\n\n  async serialize(): Promise<string> {\n    const snapshot = await this.createSnapshot();\n    return await Serializer.serialize<SerializableStructure<T>>({\n      target: extractClassName(this),\n      snapshot,\n    });\n  }\n\n  protected async deserialize(value: string, options?: DeserializeOptions): Promise<T> {\n    const { __root } = await Serializer.deserializeWithMeta<SerializableStructure<T>>(\n      value,\n      options?.extraClasses,\n    );\n    if (!__root.target) {\n      // eslint-disable-next-line\n      console.warn(\n        `Serializable class must be serialized via \"serialize\" method and not via Serializer class. This may lead to incorrect deserialization.`,\n      );\n      return __root as T;\n    }\n\n    const current = extractClassName(this);\n    if (current !== __root.target) {\n      throw new SerializerError(\n        `Snapshot has been created for class '${__root.target}' but you want to use it for class '${current}'.`,\n      );\n    }\n    return __root.snapshot;\n  }\n\n  static async fromSnapshot<P, T extends Serializable<P>>(\n    this: new (...args: any[]) => T,\n    state: P,\n  ): Promise<T> {\n    const target = Object.create(this.prototype);\n    await target.loadSnapshot(state);\n    Cache.init(target);\n    return target;\n  }\n\n  static async fromSerialized<T extends Serializable>(\n    this: abstract new (...args: any[]) => T,\n    serialized: string,\n    options: DeserializeOptions = {},\n  ): Promise<T> {\n    const target = Object.create(this.prototype) as T;\n    const state = await target.deserialize(serialized, options);\n    await target.loadSnapshot(state);\n    Cache.init(target);\n    return target;\n  }\n}\n"]}

package/dist/internals/serializable.d.cts

@@ -0,0 +1,36 @@
+import { ClassConstructor } from './types.cjs';
+import './helpers/guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+type SerializableClass<T> = ClassConstructor<Serializable<T>> & Pick<typeof Serializable<T>, "fromSnapshot" | "fromSerialized">;
+interface DeserializeOptions {
+    extraClasses?: SerializableClass<unknown>[];
+}
+declare abstract class Serializable<T = unknown> {
+    abstract createSnapshot(): T | Promise<T>;
+    abstract loadSnapshot(snapshot: T): void | Promise<void>;
+    constructor();
+    static register<T>(this: SerializableClass<T>, aliases?: string[]): void;
+    clone<T extends Serializable>(this: T): Promise<T>;
+    serialize(): Promise<string>;
+    protected deserialize(value: string, options?: DeserializeOptions): Promise<T>;
+    static fromSnapshot<P, T extends Serializable<P>>(this: new (...args: any[]) => T, state: P): Promise<T>;
+    static fromSerialized<T extends Serializable>(this: abstract new (...args: any[]) => T, serialized: string, options?: DeserializeOptions): Promise<T>;
+}
+
+export { type DeserializeOptions, Serializable, type SerializableClass };

package/dist/internals/serializable.d.ts

@@ -0,0 +1,36 @@
+import { ClassConstructor } from './types.js';
+import './helpers/guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+type SerializableClass<T> = ClassConstructor<Serializable<T>> & Pick<typeof Serializable<T>, "fromSnapshot" | "fromSerialized">;
+interface DeserializeOptions {
+    extraClasses?: SerializableClass<unknown>[];
+}
+declare abstract class Serializable<T = unknown> {
+    abstract createSnapshot(): T | Promise<T>;
+    abstract loadSnapshot(snapshot: T): void | Promise<void>;
+    constructor();
+    static register<T>(this: SerializableClass<T>, aliases?: string[]): void;
+    clone<T extends Serializable>(this: T): Promise<T>;
+    serialize(): Promise<string>;
+    protected deserialize(value: string, options?: DeserializeOptions): Promise<T>;
+    static fromSnapshot<P, T extends Serializable<P>>(this: new (...args: any[]) => T, state: P): Promise<T>;
+    static fromSerialized<T extends Serializable>(this: abstract new (...args: any[]) => T, serialized: string, options?: DeserializeOptions): Promise<T>;
+}
+
+export { type DeserializeOptions, Serializable, type SerializableClass };

package/dist/internals/serializable.js

@@ -0,0 +1,61 @@
+import { Serializer } from '../serializer/serializer.js';
+import { extractClassName } from '../serializer/utils.js';
+import { SerializerError } from '../serializer/error.js';
+import { Cache } from '../cache/decoratorCache.js';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+class Serializable {
+  static {
+    __name(this, "Serializable");
+  }
+  constructor() {
+    Object.getPrototypeOf(this).constructor.register();
+    Cache.init(this);
+  }
+  static register(aliases) {
+    Serializer.registerSerializable(this, void 0, aliases);
+  }
+  async clone() {
+    const snapshot = await this.createSnapshot();
+    const target = Object.create(this.constructor.prototype);
+    await target.loadSnapshot(snapshot);
+    return target;
+  }
+  async serialize() {
+    const snapshot = await this.createSnapshot();
+    return await Serializer.serialize({
+      target: extractClassName(this),
+      snapshot
+    });
+  }
+  async deserialize(value, options) {
+    const { __root } = await Serializer.deserializeWithMeta(value, options?.extraClasses);
+    if (!__root.target) {
+      console.warn(`Serializable class must be serialized via "serialize" method and not via Serializer class. This may lead to incorrect deserialization.`);
+      return __root;
+    }
+    const current = extractClassName(this);
+    if (current !== __root.target) {
+      throw new SerializerError(`Snapshot has been created for class '${__root.target}' but you want to use it for class '${current}'.`);
+    }
+    return __root.snapshot;
+  }
+  static async fromSnapshot(state) {
+    const target = Object.create(this.prototype);
+    await target.loadSnapshot(state);
+    Cache.init(target);
+    return target;
+  }
+  static async fromSerialized(serialized, options = {}) {
+    const target = Object.create(this.prototype);
+    const state = await target.deserialize(serialized, options);
+    await target.loadSnapshot(state);
+    Cache.init(target);
+    return target;
+  }
+}
+
+export { Serializable };
+//# sourceMappingURL=serializable.js.map
+//# sourceMappingURL=serializable.js.map

package/dist/internals/serializable.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/serializable.ts"],"names":["Serializable","constructor","Object","getPrototypeOf","register","Cache","init","aliases","Serializer","registerSerializable","undefined","clone","snapshot","createSnapshot","target","create","prototype","loadSnapshot","serialize","extractClassName","deserialize","value","options","__root","deserializeWithMeta","extraClasses","console","warn","current","SerializerError","fromSnapshot","state","fromSerialized","serialized"],"mappings":";;;;;;;AAkCO,MAAeA,YAAAA,CAAAA;EAlCtB;;;EAsCEC,WAAc,GAAA;AACZC,IAAAA,MAAAA,CAAOC,cAAe,CAAA,IAAI,CAAEF,CAAAA,WAAAA,CAAYG,QAAQ,EAAA;AAChDC,IAAAA,KAAAA,CAAMC,KAAK,IAAI,CAAA;AACjB;AAEA,EAAA,OAAcF,SAAwCG,OAAoB,EAAA;AACxEC,IAAWC,UAAAA,CAAAA,oBAAAA,CAAqB,IAAMC,EAAAA,KAAAA,CAAAA,EAAWH,OAAAA,CAAAA;AACnD;AAEA,EAAA,MAAMI,KAAmD,GAAA;AACvD,IAAMC,MAAAA,QAAAA,GAAW,MAAM,IAAA,CAAKC,cAAc,EAAA;AAE1C,IAAA,MAAMC,MAASZ,GAAAA,MAAAA,CAAOa,MAAO,CAAA,IAAA,CAAKd,YAAYe,SAAS,CAAA;AACvD,IAAMF,MAAAA,MAAAA,CAAOG,aAAaL,QAAAA,CAAAA;AAC1B,IAAOE,OAAAA,MAAAA;AACT;AAEA,EAAA,MAAMI,SAA6B,GAAA;AACjC,IAAMN,MAAAA,QAAAA,GAAW,MAAM,IAAA,CAAKC,cAAc,EAAA;AAC1C,IAAO,OAAA,MAAML,WAAWU,SAAoC,CAAA;AAC1DJ,MAAAA,MAAAA,EAAQK,iBAAiB,IAAI,CAAA;AAC7BP,MAAAA;KACF,CAAA;AACF;EAEA,MAAgBQ,WAAAA,CAAYC,OAAeC,OAA0C,EAAA;AACnF,IAAM,MAAA,EAAEC,QAAW,GAAA,MAAMf,WAAWgB,mBAClCH,CAAAA,KAAAA,EACAC,SAASG,YAAAA,CAAAA;AAEX,IAAI,IAAA,CAACF,OAAOT,MAAQ,EAAA;AAElBY,MAAAA,OAAAA,CAAQC,KACN,CAAwI,sIAAA,CAAA,CAAA;AAE1I,MAAOJ,OAAAA,MAAAA;AACT;AAEA,IAAMK,MAAAA,OAAAA,GAAUT,iBAAiB,IAAI,CAAA;AACrC,IAAIS,IAAAA,OAAAA,KAAYL,OAAOT,MAAQ,EAAA;AAC7B,MAAA,MAAM,IAAIe,eACR,CAAA,CAAA,qCAAA,EAAwCN,OAAOT,MAAM,CAAA,oCAAA,EAAuCc,OAAAA,CAAW,EAAA,CAAA,CAAA;AAE3G;AACA,IAAA,OAAOL,MAAOX,CAAAA,QAAAA;AAChB;AAEA,EAAA,aAAakB,aAEXC,KACY,EAAA;AACZ,IAAA,MAAMjB,MAASZ,GAAAA,MAAAA,CAAOa,MAAO,CAAA,IAAA,CAAKC,SAAS,CAAA;AAC3C,IAAMF,MAAAA,MAAAA,CAAOG,aAAac,KAAAA,CAAAA;AAC1B1B,IAAAA,KAAAA,CAAMC,KAAKQ,MAAAA,CAAAA;AACX,IAAOA,OAAAA,MAAAA;AACT;AAEA,EAAA,aAAakB,cAEXC,CAAAA,UAAAA,EACAX,OAA8B,GAAA,EAClB,EAAA;AACZ,IAAA,MAAMR,MAASZ,GAAAA,MAAAA,CAAOa,MAAO,CAAA,IAAA,CAAKC,SAAS,CAAA;AAC3C,IAAA,MAAMe,KAAQ,GAAA,MAAMjB,MAAOM,CAAAA,WAAAA,CAAYa,YAAYX,OAAAA,CAAAA;AACnD,IAAMR,MAAAA,MAAAA,CAAOG,aAAac,KAAAA,CAAAA;AAC1B1B,IAAAA,KAAAA,CAAMC,KAAKQ,MAAAA,CAAAA;AACX,IAAOA,OAAAA,MAAAA;AACT;AACF","file":"serializable.js","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport { Serializer } from \"@/serializer/serializer.js\";\nimport { ClassConstructor } from \"@/internals/types.js\";\nimport { extractClassName } from \"@/serializer/utils.js\";\nimport { SerializerError } from \"@/serializer/error.js\";\nimport { Cache } from \"@/cache/decoratorCache.js\";\n\nexport type SerializableClass<T> = ClassConstructor<Serializable<T>> &\n  Pick<typeof Serializable<T>, \"fromSnapshot\" | \"fromSerialized\">;\n\ninterface SerializableStructure<T> {\n  target: string;\n  snapshot: T;\n}\n\nexport interface DeserializeOptions {\n  extraClasses?: SerializableClass<unknown>[];\n}\n\nexport abstract class Serializable<T = unknown> {\n  abstract createSnapshot(): T | Promise<T>;\n  abstract loadSnapshot(snapshot: T): void | Promise<void>;\n\n  constructor() {\n    Object.getPrototypeOf(this).constructor.register();\n    Cache.init(this);\n  }\n\n  public static register<T>(this: SerializableClass<T>, aliases?: string[]) {\n    Serializer.registerSerializable(this, undefined, aliases);\n  }\n\n  async clone<T extends Serializable>(this: T): Promise<T> {\n    const snapshot = await this.createSnapshot();\n\n    const target = Object.create(this.constructor.prototype) as T;\n    await target.loadSnapshot(snapshot);\n    return target;\n  }\n\n  async serialize(): Promise<string> {\n    const snapshot = await this.createSnapshot();\n    return await Serializer.serialize<SerializableStructure<T>>({\n      target: extractClassName(this),\n      snapshot,\n    });\n  }\n\n  protected async deserialize(value: string, options?: DeserializeOptions): Promise<T> {\n    const { __root } = await Serializer.deserializeWithMeta<SerializableStructure<T>>(\n      value,\n      options?.extraClasses,\n    );\n    if (!__root.target) {\n      // eslint-disable-next-line\n      console.warn(\n        `Serializable class must be serialized via \"serialize\" method and not via Serializer class. This may lead to incorrect deserialization.`,\n      );\n      return __root as T;\n    }\n\n    const current = extractClassName(this);\n    if (current !== __root.target) {\n      throw new SerializerError(\n        `Snapshot has been created for class '${__root.target}' but you want to use it for class '${current}'.`,\n      );\n    }\n    return __root.snapshot;\n  }\n\n  static async fromSnapshot<P, T extends Serializable<P>>(\n    this: new (...args: any[]) => T,\n    state: P,\n  ): Promise<T> {\n    const target = Object.create(this.prototype);\n    await target.loadSnapshot(state);\n    Cache.init(target);\n    return target;\n  }\n\n  static async fromSerialized<T extends Serializable>(\n    this: abstract new (...args: any[]) => T,\n    serialized: string,\n    options: DeserializeOptions = {},\n  ): Promise<T> {\n    const target = Object.create(this.prototype) as T;\n    const state = await target.deserialize(serialized, options);\n    await target.loadSnapshot(state);\n    Cache.init(target);\n    return target;\n  }\n}\n"]}

package/dist/internals/types.cjs

@@ -0,0 +1,15 @@
+'use strict';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+function narrowTo(value, fn) {
+  if (typeof fn === "function") {
+    return fn(value);
+  }
+  return fn;
+}
+__name(narrowTo, "narrowTo");
+
+exports.narrowTo = narrowTo;
+//# sourceMappingURL=types.cjs.map
+//# sourceMappingURL=types.cjs.map

package/dist/internals/types.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/internals/types.ts"],"names":["narrowTo","value","fn"],"mappings":";;;;AAmGO,SAASA,QAAAA,CAAYC,OAAgBC,EAAqC,EAAA;AAC/E,EAAI,IAAA,OAAOA,OAAO,UAAY,EAAA;AAC5B,IAAA,OAAOA,GAAGD,KAAAA,CAAAA;AACZ;AACA,EAAOC,OAAAA,EAAAA;AACT;AALgBF,MAAAA,CAAAA,QAAAA,EAAAA,UAAAA,CAAAA","file":"types.cjs","sourcesContent":["/**\n * Copyright 2025 IBM Corp.\n *\n * Licensed under the Apache License, Version 2.0 (the \"License\");\n * you may not use this file except in compliance with the License.\n * You may obtain a copy of the License at\n *\n *     http://www.apache.org/licenses/LICENSE-2.0\n *\n * Unless required by applicable law or agreed to in writing, software\n * distributed under the License is distributed on an \"AS IS\" BASIS,\n * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.\n * See the License for the specific language governing permissions and\n * limitations under the License.\n */\n\nimport type { Primitive } from \"@/internals/helpers/guards.js\";\ntype ExcludeArrayLike<T> = object & Exclude<T, any[]>;\nexport type ObjectLike<K extends keyof any = string, V = any> = Record<K, V>;\nexport type PlainObject<K extends string = string, V = Primitive> = Exclude<\n  ExcludeArrayLike<Record<K & string, any extends V ? never : V>>,\n  any[]\n>;\n\nexport type ExcludeNonStringIndex<T> = {\n  [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];\n};\n\nexport type AnyFn = (...args: any[]) => any;\n\nexport type Enum<T> = Readonly<{\n  [K in keyof T]: K;\n}>;\nexport type EnumFromUnion<T extends string> = Readonly<{\n  [K in T as Uppercase<K>]: K;\n}>;\nexport type EnumValue<T> = T extends Enum<infer P> ? P[keyof P] : never;\nexport type EnumLowerCaseValue<T> = Readonly<{\n  [K in keyof T]: K extends string ? Lowercase<K> : never;\n}>[keyof T];\nexport type EmptyObject = Record<string, never>;\n\nexport type OmitType<T, O = never> = { [K in keyof T as T[K] extends O ? never : K]: T[K] };\n\nexport type Class<T = any> = new (...args: any[]) => T;\n\ntype TupleUnion<U extends string, R extends any[] = []> = {\n  [S in U]: Exclude<U, S> extends never ? [...R, S] : TupleUnion<Exclude<U, S>, [...R, S]>;\n}[U];\nexport type ArrayKeys<T> = TupleUnion<Extract<keyof T, string>>;\nexport type Common<A, B> = {\n  [P in keyof A & keyof B]: A[P] | B[P];\n};\nexport type ValueOf<T extends NonNullable<unknown>> = T[keyof T];\n\nexport type Head<T> = T extends [infer A, ...any] ? A : never;\nexport type Tail<T> = T extends [any, ...infer B] ? B : never;\nexport type RequiredExcept<T, K extends keyof T> = Omit<Required<T>, K> & Pick<Partial<T>, K>;\nexport type OptionalExcept<T, K extends keyof T> = Pick<Required<T>, K> & Omit<Partial<T>, K>;\nexport type NonUndefined<T, K extends keyof T = keyof T> = Pick<Required<T>, K> & Omit<T, K>;\n\nexport type RequiredAll<T> = {\n  [P in keyof T]-?: NonNullable<T[P]>;\n};\n\nexport type RequiredNested<T> = {\n  [P in keyof T]-?: Required<T[P]>;\n};\n\nexport type OmitEmpty<T> = OmitType<T, never | void>;\nexport type NonEmptyArray<T> = [T, ...T[]];\nexport type Unwrap<T> = T extends (infer X)[] ? X : T;\nexport type Constructable<T> = new (...args: any[]) => T;\nexport type AbstractConstructable = abstract new (...args: any[]) => any;\nexport type AnyConstructable = Constructable<any>;\n\nexport type Constructor<T extends new (...args: any) => any> = T extends new (\n  ...args: infer A\n) => infer R\n  ? new (...args: A) => R\n  : never;\n\nexport interface ClassConstructor<T = any> {\n  name: string;\n  new (...args: any[]): T;\n}\nexport type AbstractClassConstructor<T = any> = abstract new (...args: any[]) => T;\nexport interface NamedFunction<T = any> {\n  name: string;\n  (...args: any[]): T;\n}\n\nexport type PromiseOrPlain<T, Decider extends AnyFn> =\n  ReturnType<Decider> extends Promise<unknown> ? Promise<T> : T;\n\nexport type NoPromise<T> = T extends Promise<unknown> ? never : T;\n\nexport type TypedFn<P extends any[], R> = (...args: P) => R;\n\nexport function narrowTo<T>(value: unknown, fn: boolean | ((value: T) => boolean)): value is T {\n  if (typeof fn === \"function\") {\n    return fn(value as T);\n  }\n  return fn;\n}\n\ntype Without<T, U> = Partial<Record<Exclude<keyof T, keyof U>, never>>;\nexport type XOR<T, U> = T | U extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U;\nexport type OneOf<T extends any[]> = T extends [infer Only]\n  ? Only\n  : T extends [infer A, infer B, ...infer Rest]\n    ? OneOf<[XOR<A, B>, ...Rest]>\n    : never;\n\nexport type AnyVoid = Promise<unknown> | unknown;\n\nexport type OmitPrivateKeys<T> = {\n  [K in keyof T as K extends `_${string}` ? never : K]: T[K];\n};\n\ntype MergeElements<A, B> = A extends never ? B : B extends never ? A : A | B;\nexport type MergeArrays<A extends any[], B extends any[]> = A extends []\n  ? B\n  : B extends []\n    ? A\n    : [MergeElements<Head<A>, Head<B>>, ...MergeArrays<Tail<A>, Tail<B>>];\n\nexport type MergeFunctions<A extends AnyFn, B extends AnyFn> = (\n  ...args: MergeArrays<Parameters<A>, Parameters<B>>\n) => MergeElements<ReturnType<B>, ReturnType<A>>;\n\nexport type WithoutLast<T> = T extends [...infer A, any] ? A : [];\n"]}

package/dist/internals/types.d.cts

@@ -0,0 +1,92 @@
+import { Primitive } from './helpers/guards.cjs';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+type ExcludeArrayLike<T> = object & Exclude<T, any[]>;
+type ObjectLike<K extends keyof any = string, V = any> = Record<K, V>;
+type PlainObject<K extends string = string, V = Primitive> = Exclude<ExcludeArrayLike<Record<K & string, any extends V ? never : V>>, any[]>;
+type ExcludeNonStringIndex<T> = {
+    [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
+};
+type AnyFn = (...args: any[]) => any;
+type Enum<T> = Readonly<{
+    [K in keyof T]: K;
+}>;
+type EnumFromUnion<T extends string> = Readonly<{
+    [K in T as Uppercase<K>]: K;
+}>;
+type EnumValue<T> = T extends Enum<infer P> ? P[keyof P] : never;
+type EnumLowerCaseValue<T> = Readonly<{
+    [K in keyof T]: K extends string ? Lowercase<K> : never;
+}>[keyof T];
+type EmptyObject = Record<string, never>;
+type OmitType<T, O = never> = {
+    [K in keyof T as T[K] extends O ? never : K]: T[K];
+};
+type Class<T = any> = new (...args: any[]) => T;
+type TupleUnion<U extends string, R extends any[] = []> = {
+    [S in U]: Exclude<U, S> extends never ? [...R, S] : TupleUnion<Exclude<U, S>, [...R, S]>;
+}[U];
+type ArrayKeys<T> = TupleUnion<Extract<keyof T, string>>;
+type Common<A, B> = {
+    [P in keyof A & keyof B]: A[P] | B[P];
+};
+type ValueOf<T extends NonNullable<unknown>> = T[keyof T];
+type Head<T> = T extends [infer A, ...any] ? A : never;
+type Tail<T> = T extends [any, ...infer B] ? B : never;
+type RequiredExcept<T, K extends keyof T> = Omit<Required<T>, K> & Pick<Partial<T>, K>;
+type OptionalExcept<T, K extends keyof T> = Pick<Required<T>, K> & Omit<Partial<T>, K>;
+type NonUndefined<T, K extends keyof T = keyof T> = Pick<Required<T>, K> & Omit<T, K>;
+type RequiredAll<T> = {
+    [P in keyof T]-?: NonNullable<T[P]>;
+};
+type RequiredNested<T> = {
+    [P in keyof T]-?: Required<T[P]>;
+};
+type OmitEmpty<T> = OmitType<T, never | void>;
+type NonEmptyArray<T> = [T, ...T[]];
+type Unwrap<T> = T extends (infer X)[] ? X : T;
+type Constructable<T> = new (...args: any[]) => T;
+type AbstractConstructable = abstract new (...args: any[]) => any;
+type AnyConstructable = Constructable<any>;
+type Constructor<T extends new (...args: any) => any> = T extends new (...args: infer A) => infer R ? new (...args: A) => R : never;
+interface ClassConstructor<T = any> {
+    name: string;
+    new (...args: any[]): T;
+}
+type AbstractClassConstructor<T = any> = abstract new (...args: any[]) => T;
+interface NamedFunction<T = any> {
+    name: string;
+    (...args: any[]): T;
+}
+type PromiseOrPlain<T, Decider extends AnyFn> = ReturnType<Decider> extends Promise<unknown> ? Promise<T> : T;
+type NoPromise<T> = T extends Promise<unknown> ? never : T;
+type TypedFn<P extends any[], R> = (...args: P) => R;
+declare function narrowTo<T>(value: unknown, fn: boolean | ((value: T) => boolean)): value is T;
+type Without<T, U> = Partial<Record<Exclude<keyof T, keyof U>, never>>;
+type XOR<T, U> = T | U extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U;
+type OneOf<T extends any[]> = T extends [infer Only] ? Only : T extends [infer A, infer B, ...infer Rest] ? OneOf<[XOR<A, B>, ...Rest]> : never;
+type AnyVoid = Promise<unknown> | unknown;
+type OmitPrivateKeys<T> = {
+    [K in keyof T as K extends `_${string}` ? never : K]: T[K];
+};
+type MergeElements<A, B> = A extends never ? B : B extends never ? A : A | B;
+type MergeArrays<A extends any[], B extends any[]> = A extends [] ? B : B extends [] ? A : [MergeElements<Head<A>, Head<B>>, ...MergeArrays<Tail<A>, Tail<B>>];
+type MergeFunctions<A extends AnyFn, B extends AnyFn> = (...args: MergeArrays<Parameters<A>, Parameters<B>>) => MergeElements<ReturnType<B>, ReturnType<A>>;
+type WithoutLast<T> = T extends [...infer A, any] ? A : [];
+
+export { type AbstractClassConstructor, type AbstractConstructable, type AnyConstructable, type AnyFn, type AnyVoid, type ArrayKeys, type Class, type ClassConstructor, type Common, type Constructable, type Constructor, type EmptyObject, type Enum, type EnumFromUnion, type EnumLowerCaseValue, type EnumValue, type ExcludeNonStringIndex, type Head, type MergeArrays, type MergeFunctions, type NamedFunction, type NoPromise, type NonEmptyArray, type NonUndefined, type ObjectLike, type OmitEmpty, type OmitPrivateKeys, type OmitType, type OneOf, type OptionalExcept, type PlainObject, type PromiseOrPlain, type RequiredAll, type RequiredExcept, type RequiredNested, type Tail, type TypedFn, type Unwrap, type ValueOf, type WithoutLast, type XOR, narrowTo };

package/dist/internals/types.d.ts

@@ -0,0 +1,92 @@
+import { Primitive } from './helpers/guards.js';
+
+/**
+ * Copyright 2025 IBM Corp.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *     http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+type ExcludeArrayLike<T> = object & Exclude<T, any[]>;
+type ObjectLike<K extends keyof any = string, V = any> = Record<K, V>;
+type PlainObject<K extends string = string, V = Primitive> = Exclude<ExcludeArrayLike<Record<K & string, any extends V ? never : V>>, any[]>;
+type ExcludeNonStringIndex<T> = {
+    [K in keyof T as string extends K ? never : number extends K ? never : K]: T[K];
+};
+type AnyFn = (...args: any[]) => any;
+type Enum<T> = Readonly<{
+    [K in keyof T]: K;
+}>;
+type EnumFromUnion<T extends string> = Readonly<{
+    [K in T as Uppercase<K>]: K;
+}>;
+type EnumValue<T> = T extends Enum<infer P> ? P[keyof P] : never;
+type EnumLowerCaseValue<T> = Readonly<{
+    [K in keyof T]: K extends string ? Lowercase<K> : never;
+}>[keyof T];
+type EmptyObject = Record<string, never>;
+type OmitType<T, O = never> = {
+    [K in keyof T as T[K] extends O ? never : K]: T[K];
+};
+type Class<T = any> = new (...args: any[]) => T;
+type TupleUnion<U extends string, R extends any[] = []> = {
+    [S in U]: Exclude<U, S> extends never ? [...R, S] : TupleUnion<Exclude<U, S>, [...R, S]>;
+}[U];
+type ArrayKeys<T> = TupleUnion<Extract<keyof T, string>>;
+type Common<A, B> = {
+    [P in keyof A & keyof B]: A[P] | B[P];
+};
+type ValueOf<T extends NonNullable<unknown>> = T[keyof T];
+type Head<T> = T extends [infer A, ...any] ? A : never;
+type Tail<T> = T extends [any, ...infer B] ? B : never;
+type RequiredExcept<T, K extends keyof T> = Omit<Required<T>, K> & Pick<Partial<T>, K>;
+type OptionalExcept<T, K extends keyof T> = Pick<Required<T>, K> & Omit<Partial<T>, K>;
+type NonUndefined<T, K extends keyof T = keyof T> = Pick<Required<T>, K> & Omit<T, K>;
+type RequiredAll<T> = {
+    [P in keyof T]-?: NonNullable<T[P]>;
+};
+type RequiredNested<T> = {
+    [P in keyof T]-?: Required<T[P]>;
+};
+type OmitEmpty<T> = OmitType<T, never | void>;
+type NonEmptyArray<T> = [T, ...T[]];
+type Unwrap<T> = T extends (infer X)[] ? X : T;
+type Constructable<T> = new (...args: any[]) => T;
+type AbstractConstructable = abstract new (...args: any[]) => any;
+type AnyConstructable = Constructable<any>;
+type Constructor<T extends new (...args: any) => any> = T extends new (...args: infer A) => infer R ? new (...args: A) => R : never;
+interface ClassConstructor<T = any> {
+    name: string;
+    new (...args: any[]): T;
+}
+type AbstractClassConstructor<T = any> = abstract new (...args: any[]) => T;
+interface NamedFunction<T = any> {
+    name: string;
+    (...args: any[]): T;
+}
+type PromiseOrPlain<T, Decider extends AnyFn> = ReturnType<Decider> extends Promise<unknown> ? Promise<T> : T;
+type NoPromise<T> = T extends Promise<unknown> ? never : T;
+type TypedFn<P extends any[], R> = (...args: P) => R;
+declare function narrowTo<T>(value: unknown, fn: boolean | ((value: T) => boolean)): value is T;
+type Without<T, U> = Partial<Record<Exclude<keyof T, keyof U>, never>>;
+type XOR<T, U> = T | U extends object ? (Without<T, U> & U) | (Without<U, T> & T) : T | U;
+type OneOf<T extends any[]> = T extends [infer Only] ? Only : T extends [infer A, infer B, ...infer Rest] ? OneOf<[XOR<A, B>, ...Rest]> : never;
+type AnyVoid = Promise<unknown> | unknown;
+type OmitPrivateKeys<T> = {
+    [K in keyof T as K extends `_${string}` ? never : K]: T[K];
+};
+type MergeElements<A, B> = A extends never ? B : B extends never ? A : A | B;
+type MergeArrays<A extends any[], B extends any[]> = A extends [] ? B : B extends [] ? A : [MergeElements<Head<A>, Head<B>>, ...MergeArrays<Tail<A>, Tail<B>>];
+type MergeFunctions<A extends AnyFn, B extends AnyFn> = (...args: MergeArrays<Parameters<A>, Parameters<B>>) => MergeElements<ReturnType<B>, ReturnType<A>>;
+type WithoutLast<T> = T extends [...infer A, any] ? A : [];
+
+export { type AbstractClassConstructor, type AbstractConstructable, type AnyConstructable, type AnyFn, type AnyVoid, type ArrayKeys, type Class, type ClassConstructor, type Common, type Constructable, type Constructor, type EmptyObject, type Enum, type EnumFromUnion, type EnumLowerCaseValue, type EnumValue, type ExcludeNonStringIndex, type Head, type MergeArrays, type MergeFunctions, type NamedFunction, type NoPromise, type NonEmptyArray, type NonUndefined, type ObjectLike, type OmitEmpty, type OmitPrivateKeys, type OmitType, type OneOf, type OptionalExcept, type PlainObject, type PromiseOrPlain, type RequiredAll, type RequiredExcept, type RequiredNested, type Tail, type TypedFn, type Unwrap, type ValueOf, type WithoutLast, type XOR, narrowTo };