@qwreey-js/ts-util 1.0.4 → 1.0.5

package/dist/base32.d.ts

@@ -0,0 +1,16 @@
+export declare namespace Base32 {
+    /**
+     * Encodes a Uint8Array into a Base32 string according to RFC 4648.
+     * * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @returns {string} The resulting Base32 encoded string.
+     */
+    function fromUint8Array(uint8Array: Uint8Array): string;
+    /**
+     * Decodes a Base32 string into a Uint8Array.
+     * Ignores padding characters ('=') and is case-insensitive.
+     * @param {string} base32 - The Base32 encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base32: string): Uint8Array;
+}
+//# sourceMappingURL=base32.d.ts.map

package/dist/base32.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base32.d.ts","sourceRoot":"","sources":["../src/base32.ts"],"names":[],"mappings":"AAAA,yBAAiB,MAAM,CAAC;IAGtB;;;;OAIG;IACH,SAAgB,cAAc,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAwB7D;IAWD;;;;;OAKG;IACH,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAwBvD;CACF"}

package/dist/base32.js

@@ -0,0 +1,67 @@
+export var Base32;
+(function (Base32) {
+    const Base32Alpabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+    /**
+     * Encodes a Uint8Array into a Base32 string according to RFC 4648.
+     * * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @returns {string} The resulting Base32 encoded string.
+     */
+    function fromUint8Array(uint8Array) {
+        let bits = 0;
+        let value = 0;
+        const output = [];
+        for (const byte of uint8Array) {
+            value = (value << 8) | byte;
+            bits += 8;
+            while (bits >= 5) {
+                output.push(Base32Alpabet[(value >>> (bits - 5)) & 31]);
+                bits -= 5;
+            }
+        }
+        if (bits > 0) {
+            output.push(Base32Alpabet[(value << (5 - bits)) & 31]);
+        }
+        while (output.length % 8 !== 0) {
+            output.push("=");
+        }
+        return output.join("");
+    }
+    Base32.fromUint8Array = fromUint8Array;
+    const Base32Lookup = (() => {
+        const arr = new Int8Array(256);
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+        for (let i = 0; i < chars.length; i++) {
+            arr[chars.charCodeAt(i)] = i;
+        }
+        return arr;
+    })();
+    /**
+     * Decodes a Base32 string into a Uint8Array.
+     * Ignores padding characters ('=') and is case-insensitive.
+     * @param {string} base32 - The Base32 encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base32) {
+        // 소문자가 들어와도 대문자로 처리. 패딩(=) 제거
+        const str = base32.toUpperCase().replace(/=/g, "");
+        const outLen = Math.floor((str.length * 5) / 8);
+        const result = new Uint8Array(outLen);
+        let bits = 0;
+        let value = 0;
+        let index = 0;
+        for (let i = 0; i < str.length; i++) {
+            const charCode = str.charCodeAt(i);
+            // 5비트씩 가져오기
+            value = (value << 5) | Base32Lookup[charCode];
+            bits += 5;
+            // 8비트가 모이면 하나의 바이트로 결과 배열에 넣기
+            if (bits >= 8) {
+                result[index++] = (value >>> (bits - 8)) & 255;
+                bits -= 8;
+            }
+        }
+        return result;
+    }
+    Base32.toUint8Array = toUint8Array;
+})(Base32 || (Base32 = {}));
+//# sourceMappingURL=base32.js.map

package/dist/base32.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base32.js","sourceRoot":"","sources":["../src/base32.ts"],"names":[],"mappings":"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"}

package/dist/base64.d.ts

@@ -0,0 +1,34 @@
+export declare namespace Base64 {
+    /**
+     * Configuration options for Base64 encoding.
+     */
+    interface ToBase64Options {
+        /**
+         * The alphabet to use for encoding.
+         * 'base64' uses the standard Base64 alphabet (RFC 4648).
+         * 'base64url' uses the URL-safe Base64 alphabet.
+         * @default 'base64'
+         */
+        alphabet?: "base64" | "base64url";
+        /**
+         * Whether to omit the padding character ('=') at the end of the output.
+         * @default false
+         */
+        omitPadding?: boolean;
+    }
+    /**
+     * Encodes a Uint8Array into a Base64 or Base64URL string.
+     * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @param {ToBase64Options} [options] - Optional encoding configuration.
+     * @returns {string} The resulting Base64 or Base64URL encoded string.
+     */
+    function fromUint8Array(uint8Array: Uint8Array, options?: ToBase64Options): string;
+    /**
+     * Decodes a Base64 or Base64URL string into a Uint8Array.
+     * Automatically handles both standard and URL-safe alphabets and ignores padding characters ('=').
+     * @param {string} base64 - The Base64 or Base64URL encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base64: string): Uint8Array;
+}
+//# sourceMappingURL=base64.d.ts.map

package/dist/base64.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.d.ts","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"AAAA,yBAAiB,MAAM,CAAC;IACtB;;OAEG;IACH,UAAiB,eAAe;QAC9B;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,QAAQ,GAAG,WAAW,CAAC;QAClC;;;WAGG;QACH,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB;IAOD;;;;;OAKG;IACH,SAAgB,cAAc,CAC5B,UAAU,EAAE,UAAU,EACtB,OAAO,CAAC,EAAE,eAAe,GACxB,MAAM,CAuCR;IAYD;;;;;OAKG;IACH,SAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,UAAU,CAwBvD;CACF"}

package/dist/base64.js

@@ -0,0 +1,81 @@
+export var Base64;
+(function (Base64) {
+    const Base64Alpabet = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+    const Base64AlpabetUrl = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789-_";
+    /**
+     * Encodes a Uint8Array into a Base64 or Base64URL string.
+     * @param {Uint8Array} uint8Array - The byte array to encode.
+     * @param {ToBase64Options} [options] - Optional encoding configuration.
+     * @returns {string} The resulting Base64 or Base64URL encoded string.
+     */
+    function fromUint8Array(uint8Array, options) {
+        if (uint8Array.toBase64) {
+            return uint8Array.toBase64(options);
+        }
+        const alphabetName = options?.alphabet ?? "base64";
+        const omitPadding = options?.omitPadding ?? false;
+        const chars = alphabetName === "base64url" ? Base64AlpabetUrl : Base64Alpabet;
+        let result = "";
+        const len = uint8Array.length;
+        // 3바이트(24비트)씩 끊어서 4개의 6비트 문자로 변환
+        for (let i = 0; i < len; i += 3) {
+            const b1 = uint8Array[i];
+            const b2 = i + 1 < len ? uint8Array[i + 1] : 0;
+            const b3 = i + 2 < len ? uint8Array[i + 2] : 0;
+            const bits = (b1 << 16) | (b2 << 8) | b3;
+            result += chars[(bits >> 18) & 63];
+            result += chars[(bits >> 12) & 63];
+            if (i + 1 < len) {
+                result += chars[(bits >> 6) & 63];
+            }
+            else if (!omitPadding) {
+                result += "=";
+            }
+            if (i + 2 < len) {
+                result += chars[bits & 63];
+            }
+            else if (!omitPadding) {
+                result += "=";
+            }
+        }
+        return result;
+    }
+    Base64.fromUint8Array = fromUint8Array;
+    const Base64Lookup = (() => {
+        const arr = new Int8Array(256);
+        const chars = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789+/";
+        for (let i = 0; i < chars.length; i++) {
+            arr[chars.charCodeAt(i)] = i;
+        }
+        return arr;
+    })();
+    /**
+     * Decodes a Base64 or Base64URL string into a Uint8Array.
+     * Automatically handles both standard and URL-safe alphabets and ignores padding characters ('=').
+     * @param {string} base64 - The Base64 or Base64URL encoded string to decode.
+     * @returns {Uint8Array} The decoded byte array.
+     */
+    function toUint8Array(base64) {
+        // Base64URL의 -, _ 문자를 표준 +, / 로 바꾸고 패딩 제거
+        const str = base64.replace(/-/g, "+").replace(/_/g, "/").replace(/=/g, "");
+        const outLen = Math.floor((str.length * 3) / 4);
+        const result = new Uint8Array(outLen);
+        let bits = 0;
+        let value = 0;
+        let index = 0;
+        for (let i = 0; i < str.length; i++) {
+            const charCode = str.charCodeAt(i);
+            // 6비트씩 가져오기
+            value = (value << 6) | Base64Lookup[charCode];
+            bits += 6;
+            // 8비트가 모일 때마다 바이트로 저장
+            if (bits >= 8) {
+                result[index++] = (value >>> (bits - 8)) & 255;
+                bits -= 8;
+            }
+        }
+        return result;
+    }
+    Base64.toUint8Array = toUint8Array;
+})(Base64 || (Base64 = {}));
+//# sourceMappingURL=base64.js.map

package/dist/base64.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base64.js","sourceRoot":"","sources":["../src/base64.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -6,6 +6,8 @@ export * from "./mixin.js";
 export * from "./params-builder.js";
 export * from "./result.js";
 export * from "./utils.js";
+export * from "./base32.js";
+export * from "./base64.js";
 import { setLogErr as _setLogErr } from "./libLog.js";
 export declare namespace UtilLogging {
     const setLogErr: typeof _setLogErr;

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAqB,MAAM,aAAa,CAAC;AACzE,yBAAiB,WAAW,CAAC;IACpB,MAAM,SAAS,mBAAa,CAAC;IAC7B,MAAM,MAAM,8BAAU,CAAC;CAC/B"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAqB,MAAM,aAAa,CAAC;AACzE,yBAAiB,WAAW,CAAC;IACpB,MAAM,SAAS,mBAAa,CAAC;IAC7B,MAAM,MAAM,8BAAU,CAAC;CAC/B"}

package/dist/index.js

@@ -6,6 +6,8 @@ export * from "./mixin.js";
 export * from "./params-builder.js";
 export * from "./result.js";
 export * from "./utils.js";
+export * from "./base32.js";
+export * from "./base64.js";
 import { setLogErr as _setLogErr, logErr as _logErr } from "./libLog.js";
 export var UtilLogging;
 (function (UtilLogging) {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAE3B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,MAAM,KAAW,WAAW,CAG3B;AAHD,WAAiB,WAAW;IACb,qBAAS,GAAG,UAAU,CAAC;IACvB,kBAAM,GAAG,OAAO,CAAC;AAChC,CAAC,EAHgB,WAAW,KAAX,WAAW,QAG3B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC;AAC1B,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,qBAAqB,CAAC;AACpC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAE5B,OAAO,EAAE,SAAS,IAAI,UAAU,EAAE,MAAM,IAAI,OAAO,EAAE,MAAM,aAAa,CAAC;AACzE,MAAM,KAAW,WAAW,CAG3B;AAHD,WAAiB,WAAW;IACb,qBAAS,GAAG,UAAU,CAAC;IACvB,kBAAM,GAAG,OAAO,CAAC;AAChC,CAAC,EAHgB,WAAW,KAAX,WAAW,QAG3B"}

package/dist/mixin.d.ts

@@ -23,6 +23,25 @@ export type Mixin<T extends AbstractConstructor[]> = T extends [
  * @param baseClassList An array of base classes to mix into the `targetClass`.
  */
 export declare function applyRuntimeMixins(targetClass: any, baseClassList: any[]): void;
+export declare function isNonNullObject(instance: any): instance is object;
+/**
+ * Checks whether the given instance incorporates a specific mixin or base class.
+ * This utility serves as an alternative to the native `instanceof` operator for custom
+ * mixin implementations where the prototype chain does not inherently preserve the relationship.
+ *
+ * @template T - The constructor type of the target mixin or base class.
+ * @param {T} baseClass - The mixin or base class constructor to verify against.
+ * @param {*} instance - The object instance to inspect.
+ * @returns {instance is T} `true` if the instance incorporates the specified mixin; otherwise, `false`.
+ */
+export declare function hasMixin<T extends AbstractConstructor>(baseClass: T, instance: any): instance is T;
+/**
+ * Retrieves the sequence of mixins associated with the specified instance.
+ *
+ * @param {*} instance - The object instance to inspect.
+ * @returns {ReadonlyArray<AbstractConstructor> | undefined} A read-only array of mixin constructors applied to the instance, or `undefined` if no mixins are registered.
+ */
+export declare function getMixins(instance: any): ReadonlyArray<AbstractConstructor> | undefined;
 /**
  * Creates an anonymous target class, applies the `baseClassList` to it, and returns the constructed mixin class.
  * @param baseClassList A list of base classes you want to compose.

package/dist/mixin.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,SAAS,CACnB,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAC5C,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,CAAC,SAAS;IAC7D,MAAM,KAAK,SAAS,mBAAmB;CACxC,GACG,KAAK,GACL,CAAC,SAAS;IACN,GAAG,MAAM,MAAM,SAAS,mBAAmB,EAAE;IAC7C,MAAM,IAAI,SAAS,mBAAmB;CACvC,GACD,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAC9B,KAAK,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAwBxE;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,EACnD,GAAG,aAAa,EAAE,CAAC,GAClB,KAAK,CAAC,CAAC,CAAC,CAIV;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,GAAG,SAAS,GAAG,IAAI;IAC1B,mBAAmB;CACpB,EAAE,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,cAAc,IAAI,mBAAmB,CAC3E;KACG,CAAC,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GACxC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACzB,MAAM;CACX,CAAC,MAAM,CAAC,CACV,CAAC"}
+{"version":3,"file":"mixin.d.ts","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,GAAG,GAAG,IAAI,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAE9E;;;GAGG;AACH,MAAM,MAAM,SAAS,CACnB,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,EAC9C,CAAC,SAAS,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,IAC5C,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,mBAAmB,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,YAAY,CAAC,CAAC,CAAC,CAAC,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,IAAI,CAAC,SAAS;IAC7D,MAAM,KAAK,SAAS,mBAAmB;CACxC,GACG,KAAK,GACL,CAAC,SAAS;IACN,GAAG,MAAM,MAAM,SAAS,mBAAmB,EAAE;IAC7C,MAAM,IAAI,SAAS,mBAAmB;CACvC,GACD,SAAS,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,GAC9B,KAAK,CAAC;AAEZ;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,GAAG,EAAE,QAsCxE;AAED,wBAAgB,eAAe,CAAC,QAAQ,EAAE,GAAG,GAAG,QAAQ,IAAI,MAAM,CAIjE;AAED;;;;;;;;;GASG;AACH,wBAAgB,QAAQ,CAAC,CAAC,SAAS,mBAAmB,EACpD,SAAS,EAAE,CAAC,EACZ,QAAQ,EAAE,GAAG,GACZ,QAAQ,IAAI,CAAC,CAIf;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CACvB,QAAQ,EAAE,GAAG,GACZ,aAAa,CAAC,mBAAmB,CAAC,GAAG,SAAS,CAWhD;AAED;;;;GAIG;AACH,wBAAgB,KAAK,CAAC,CAAC,SAAS,mBAAmB,EAAE,EACnD,GAAG,aAAa,EAAE,CAAC,GAClB,KAAK,CAAC,CAAC,CAAC,CAMV;AAED;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC3B,OAAO,GAAG,SAAS,GAAG,IAAI;IAC1B,mBAAmB;CACpB,EAAE,CAAC;AAEJ;;GAEG;AACH,MAAM,MAAM,aAAa,CAAC,KAAK,SAAS,cAAc,IAAI,mBAAmB,CAC3E;KACG,CAAC,IAAI,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GACxC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACzB,MAAM;CACX,CAAC,MAAM,CAAC,CACV,CAAC"}

package/dist/mixin.js

@@ -5,24 +5,78 @@
  */
 export function applyRuntimeMixins(targetClass, baseClassList) {
     for (const baseClass of baseClassList) {
-        Object.getOwnPropertyNames(baseClass.prototype).forEach((name) => {
-            if (name !== "constructor") {
-                const descriptor = Object.getOwnPropertyDescriptor(baseClass.prototype, name);
-                if (descriptor) {
-                    Object.defineProperty(targetClass.prototype, name, descriptor);
+        let currentProto = baseClass.prototype;
+        while (currentProto && currentProto !== Object.prototype) {
+            Object.getOwnPropertyNames(currentProto).forEach((name) => {
+                if (name !== "constructor") {
+                    const descriptor = Object.getOwnPropertyDescriptor(currentProto, name);
+                    if (descriptor) {
+                        Object.defineProperty(targetClass.prototype, name, descriptor);
+                    }
                 }
-            }
-        });
-        for (const name of Object.getOwnPropertyNames(baseClass)) {
-            if (!["length", "prototype", "name"].includes(name)) {
-                const descriptor = Object.getOwnPropertyDescriptor(baseClass, name);
-                if (descriptor) {
-                    Object.defineProperty(targetClass, name, descriptor);
+            });
+            currentProto = Object.getPrototypeOf(currentProto);
+        }
+        let currentClass = baseClass;
+        while (currentClass &&
+            currentClass !== Function.prototype &&
+            currentClass !== Object) {
+            for (const name of Object.getOwnPropertyNames(currentClass)) {
+                if (!["length", "prototype", "name"].includes(name)) {
+                    const descriptor = Object.getOwnPropertyDescriptor(currentClass, name);
+                    if (descriptor) {
+                        Object.defineProperty(targetClass, name, descriptor);
+                    }
                 }
             }
+            currentClass = Object.getPrototypeOf(currentClass);
         }
     }
 }
+export function isNonNullObject(instance) {
+    if (typeof instance !== "object")
+        return false;
+    if (instance === null)
+        return false;
+    return true;
+}
+/**
+ * Checks whether the given instance incorporates a specific mixin or base class.
+ * This utility serves as an alternative to the native `instanceof` operator for custom
+ * mixin implementations where the prototype chain does not inherently preserve the relationship.
+ *
+ * @template T - The constructor type of the target mixin or base class.
+ * @param {T} baseClass - The mixin or base class constructor to verify against.
+ * @param {*} instance - The object instance to inspect.
+ * @returns {instance is T} `true` if the instance incorporates the specified mixin; otherwise, `false`.
+ */
+export function hasMixin(baseClass, instance) {
+    const mixins = getMixins(instance);
+    if (!mixins)
+        return false;
+    return mixins.includes(baseClass);
+}
+/**
+ * Retrieves the sequence of mixins associated with the specified instance.
+ *
+ * @param {*} instance - The object instance to inspect.
+ * @returns {ReadonlyArray<AbstractConstructor> | undefined} A read-only array of mixin constructors applied to the instance, or `undefined` if no mixins are registered.
+ */
+export function getMixins(instance) {
+    if (!isNonNullObject(instance))
+        return;
+    if (!("constructor" in instance))
+        return;
+    const instConstructor = instance.constructor;
+    if (typeof instConstructor !== "function")
+        return;
+    if (!("$baseClassList" in instConstructor))
+        return;
+    const baseClassList = instConstructor["$baseClassList"];
+    if (!Array.isArray(baseClassList))
+        return;
+    return baseClassList;
+}
 /**
  * Creates an anonymous target class, applies the `baseClassList` to it, and returns the constructed mixin class.
  * @param baseClassList A list of base classes you want to compose.
@@ -30,6 +84,7 @@ export function applyRuntimeMixins(targetClass, baseClassList) {
  */
 export function mixin(...baseClassList) {
     const targetClass = class {
+        static $baseClassList = baseClassList;
     };
     applyRuntimeMixins(targetClass, baseClassList);
     return targetClass;

package/dist/mixin.js.map

@@ -1 +1 @@
-{"version":3,"file":"mixin.js","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"AA8BA;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,WAAgB,EAAE,aAAoB;IACvE,KAAK,MAAM,SAAS,IAAI,aAAa,EAAE,CAAC;QACtC,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;YAC/D,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;gBAC3B,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAChD,SAAS,CAAC,SAAS,EACnB,IAAI,CACL,CAAC;gBACF,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,cAAc,CAAC,WAAW,CAAC,SAAS,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBACjE,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;QAEH,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,mBAAmB,CAAC,SAAS,CAAC,EAAE,CAAC;YACzD,IAAI,CAAC,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;gBACpD,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;gBAEpE,IAAI,UAAU,EAAE,CAAC;oBACf,MAAM,CAAC,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,UAAU,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,KAAK,CACnB,GAAG,aAAgB;IAEnB,MAAM,WAAW,GAAG;KAAQ,CAAC;IAC7B,kBAAkB,CAAC,WAAW,EAAE,aAAa,CAAC,CAAC;IAC/C,OAAO,WAAkB,CAAC;AAC5B,CAAC"}
+{"version":3,"file":"mixin.js","sourceRoot":"","sources":["../src/mixin.ts"],"names":[],"mappings":"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"}

package/dist/result.d.ts

@@ -26,4 +26,6 @@ export declare namespace Result {
         error: U;
     };
 }
+export declare const Ok: typeof Result.ok;
+export declare const Err: typeof Result.err;
 //# sourceMappingURL=result.d.ts.map

package/dist/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,CAAC,CAAC;CACV,GACD;IACE,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEN,yBAAiB,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAEhE;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAEhE;CACF"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,IACnB;IACE,MAAM,EAAE,SAAS,CAAC;IAClB,KAAK,EAAE,CAAC,CAAC;CACV,GACD;IACE,MAAM,EAAE,CAAC,CAAC;IACV,KAAK,EAAE,SAAS,CAAC;CAClB,CAAC;AAEN,yBAAiB,MAAM,CAAC;IACtB;;;OAGG;IACH,SAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,CAAC,CAAC;QAAC,KAAK,EAAE,SAAS,CAAA;KAAE,CAEhE;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG;QAAE,MAAM,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAEhE;CACF;AAED,eAAO,MAAM,EAAE,kBAAY,CAAC;AAC5B,eAAO,MAAM,GAAG,mBAAa,CAAC"}

package/dist/result.js

@@ -17,4 +17,6 @@ export var Result;
     }
     Result.err = err;
 })(Result || (Result = {}));
+export const Ok = Result.ok;
+export const Err = Result.err;
 //# sourceMappingURL=result.js.map

package/dist/result.js.map

@@ -1 +1 @@
-{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAaA,MAAM,KAAW,MAAM,CAgBtB;AAhBD,WAAiB,MAAM;IACrB;;;OAGG;IACH,SAAgB,EAAE,CAAI,MAAS;QAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAFe,SAAE,KAEjB,CAAA;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAI,KAAQ;QAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC;IAFe,UAAG,MAElB,CAAA;AACH,CAAC,EAhBgB,MAAM,KAAN,MAAM,QAgBtB"}
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../src/result.ts"],"names":[],"mappings":"AAaA,MAAM,KAAW,MAAM,CAgBtB;AAhBD,WAAiB,MAAM;IACrB;;;OAGG;IACH,SAAgB,EAAE,CAAI,MAAS;QAC7B,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC;IACtC,CAAC;IAFe,SAAE,KAEjB,CAAA;IAED;;;OAGG;IACH,SAAgB,GAAG,CAAI,KAAQ;QAC7B,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IACtC,CAAC;IAFe,UAAG,MAElB,CAAA;AACH,CAAC,EAhBgB,MAAM,KAAN,MAAM,QAgBtB;AAED,MAAM,CAAC,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC;AAC5B,MAAM,CAAC,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC"}

package/dist/timeid.d.ts

@@ -0,0 +1,24 @@
+export declare namespace TimeId {
+    /**
+     * Generates a unique, time-sortable identifier string.
+     *
+     * The identifier is composed of four hyphen-separated segments:
+     * - The first two segments encode the current millisecond timestamp.
+     * - The last two segments (16 characters) contain random entropy.
+     *
+     * @returns {string} A unique ID string (e.g., "XXXX-XXXX-YYYY-YYYY").
+     */
+    function create(timebase?: Date | null): string;
+    /**
+     * Parses a timeId string and returns the original Date and random bytes.
+     *
+     * @param id The timeId string to parse.
+     * @returns An object containing the decoded `date` and `randbytes`.
+     * @throws If the timeId format or payload is invalid.
+     */
+    function parse(id: string): {
+        date: Date;
+        randbytes: Uint8Array;
+    };
+}
+//# sourceMappingURL=timeid.d.ts.map

package/dist/timeid.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeid.d.ts","sourceRoot":"","sources":["../src/timeid.ts"],"names":[],"mappings":"AAEA,yBAAiB,MAAM,CAAC;IACtB;;;;;;;;OAQG;IACH,SAAgB,MAAM,CAAC,QAAQ,GAAE,IAAI,GAAG,IAAW,GAAG,MAAM,CAsB3D;IAED;;;;;;OAMG;IACH,SAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,IAAI,CAAC;QAAC,SAAS,EAAE,UAAU,CAAA;KAAE,CA+BvE;CACF"}

package/dist/timeid.js

@@ -0,0 +1,62 @@
+import { Base32 } from "./base32.js";
+export var TimeId;
+(function (TimeId) {
+    /**
+     * Generates a unique, time-sortable identifier string.
+     *
+     * The identifier is composed of four hyphen-separated segments:
+     * - The first two segments encode the current millisecond timestamp.
+     * - The last two segments (16 characters) contain random entropy.
+     *
+     * @returns {string} A unique ID string (e.g., "XXXX-XXXX-YYYY-YYYY").
+     */
+    function create(timebase = null) {
+        // Create random values
+        const randbytes = crypto.getRandomValues(new Uint8Array(8));
+        const k32 = Base32.fromUint8Array(randbytes);
+        const lower = k32.substring(0, 8);
+        const upper = k32.substring(8, 16);
+        const timepad = k32.substring(16, 19);
+        // Construct time Uint8Array
+        timebase ??= new Date();
+        const timestamp = BigInt(timebase.getTime());
+        const timebuffer = new ArrayBuffer(8);
+        const timeview = new DataView(timebuffer);
+        timeview.setBigUint64(0, timestamp, false);
+        const timearr = new Uint8Array(timebuffer);
+        // Assemble id
+        const timestr = Base32.fromUint8Array(timearr).substring(0, 13) + timepad;
+        const timelower = timestr.substring(0, 8);
+        const timeupper = timestr.substring(8, 16);
+        const generated = `${timelower}-${timeupper}-${lower}-${upper}`;
+        return generated;
+    }
+    TimeId.create = create;
+    /**
+     * Parses a timeId string and returns the original Date and random bytes.
+     *
+     * @param id The timeId string to parse.
+     * @returns An object containing the decoded `date` and `randbytes`.
+     * @throws If the timeId format or payload is invalid.
+     */
+    function parse(id) {
+        const parts = id.split("-");
+        if (parts.length !== 4) {
+            throw new Error("Invalid timeId format");
+        }
+        const [timeLower, timeUpper, randLower, randUpper] = parts;
+        const randStr = randLower + randUpper;
+        const randbytes = Base32.toUint8Array(randStr);
+        const timeStr = timeLower + timeUpper;
+        const timearr = Base32.toUint8Array(timeStr);
+        if (randbytes.length !== 8 || timearr.length !== 8) {
+            throw new Error("Invalid timeId payload");
+        }
+        const timeview = new DataView(timearr.buffer, timearr.byteOffset, timearr.byteLength);
+        const timestamp = timeview.getBigUint64(0, false);
+        const date = new Date(Number(timestamp));
+        return { date, randbytes };
+    }
+    TimeId.parse = parse;
+})(TimeId || (TimeId = {}));
+//# sourceMappingURL=timeid.js.map

package/dist/timeid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timeid.js","sourceRoot":"","sources":["../src/timeid.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@qwreey-js/ts-util",
-  "version": "1.0.4",
+  "version": "1.0.5",
   "description": "Qwreey's typescript utilities",
   "keywords": [
     "typescript"
@@ -26,7 +26,8 @@
     "check:format": "npm run --prefix ../../ prettier -- --check packages/ts-util/src",
     "fix:format": "npm run --prefix ../../ prettier -- --write packages/ts-util/src",
     "init": "npm ci --include-workspace-root --include=dev",
-    "prepack": "npm run init && npm run check && npm run build"
+    "prepack": "npm run init && npm run check && npm run build",
+    "test": "../../node_modules/.bin/tsx src/test/index.ts"
   },
   "exports": {
     ".": {