@leofcoin/codec-format-interface 1.7.14 → 1.8.0

package/README.md

@@ -1,6 +1,8 @@
 # codec-format-interface
- 
-## usage 
+
+TypeScript/JavaScript interface for defining and working with codec formats.
+
+## Usage
 
 ```js
 import FormatInterface from '@leofcoin/codec-format-interface'
@@ -14,19 +16,42 @@ class MyFormat extends FormatInterface {
   }
 
   constructor(data) {
-    super(data, { name: 'my-format', hashFormat = 'bs32' })
+    super(data, { name: 'my-format', hashFormat: 'bs32' })
   }
 }
-
 ```
 
-## build for browser
-### rollup
+## API
+
+- **FormatInterface**: Base class for creating custom codec formats.
+  - `constructor(data, options)`: Initialize with data and options.
+  - `proto`: Getter for the protocol definition.
+  - `toBs58()`, `toBs32()`, `hash()`: Encoding and hashing utilities.
+
+## Build for Browser
+
+### Rollup Example
 ```js
 import resolve from '@rollup/plugin-node-resolve'
-...
+import typescript from '@rollup/plugin-typescript'
+
+export default {
+  input: 'src/index.ts',
+  output: {
+    dir: 'exports',
+    format: 'es'
+  },
   plugins: [
-    resolve()
+    resolve(),
+    typescript()
   ]
-...
-```
+}
+```
+
+## Contributing
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.
+
+## License
+
+MIT

package/exports/README.md

@@ -0,0 +1,8 @@
+# Exports Directory
+
+This directory contains the public API surface of the package. Only files in this directory are considered part of the public API and are safe to import from other projects.
+
+- `index.js` / `index.d.ts`: Main entry point
+- Other files: Specific interfaces and codecs
+
+Do not import from internal `src/` files directly.

package/exports/basic-interface.d.ts

@@ -14,6 +14,10 @@ export default class BasicInterface {
     get proto(): object;
     decode(encoded?: Uint8Array): Object;
     encode(decoded?: object): Uint8Array;
+    static _protoCache: WeakMap<object, {
+        keys: string[];
+        values: any[];
+    }>;
     protoEncode(data: object): Uint8Array;
     protoDecode(data: Uint8Array): object;
     isHex(string: string): boolean;

package/exports/basic-interface.js

@@ -4,8 +4,20 @@ import isHex from '@vandeurenglenn/is-hex';
 import proto from '@vandeurenglenn/proto-array';
 import { fromBase58, fromHex, toHex, toBase32, toBase58 } from '@vandeurenglenn/typed-array-utils';
 
-const jsonStringifyBigInt = (key, value) => typeof value === 'bigint' ? { $bigint: value.toString() } : value;
-const jsonParseBigInt = (key, value) => typeof value === 'object' && value.$bigint ? BigInt(value.$bigint) : value;
+const jsonStringifyBigInt = (key, value) => {
+    if (typeof value === 'bigint')
+        return { $bigint: value.toString() };
+    return value;
+};
+const jsonParseBigInt = (key, value) => {
+    if (typeof value === 'object' && value) {
+        if (value.$bigint)
+            return BigInt(value.$bigint);
+    }
+    return value;
+};
+const _textEncoder = new TextEncoder();
+const _textDecoder = new TextDecoder();
 class BasicInterface {
     #encoded;
     #decoded;
@@ -40,20 +52,49 @@ class BasicInterface {
     }
     decode(encoded) {
         encoded = encoded || this.encoded;
-        return new Object();
+        // Example: decode as JSON if possible (override in subclass)
+        try {
+            return JSON.parse(_textDecoder.decode(encoded), jsonParseBigInt);
+        }
+        catch {
+            return new Object();
+        }
     }
     encode(decoded) {
         decoded = decoded || this.decoded;
-        return new Uint8Array();
+        // Example: encode as JSON (override in subclass)
+        return _textEncoder.encode(JSON.stringify(decoded, jsonStringifyBigInt));
     }
     // get Codec(): Codec {}
+    // Cache proto keys/values for reuse
+    static _protoCache = new WeakMap();
     protoEncode(data) {
-        // check schema
+        let cache = BasicInterface._protoCache.get(this.proto);
+        if (!cache) {
+            cache = {
+                keys: Object.keys(this.proto),
+                values: Object.values(this.proto)
+            };
+            BasicInterface._protoCache.set(this.proto, cache);
+        }
+        // Use proto.encode directly, but avoid new array allocations inside encode if possible
         return proto.encode(this.proto, data, false);
     }
     protoDecode(data) {
-        // check schema
-        return proto.decode(this.proto, data, false);
+        // Use a static output object if possible (not thread-safe, but safe for single-threaded use)
+        if (!this._decodeOutput)
+            this._decodeOutput = {};
+        const result = proto.decode(this.proto, data, false);
+        // Copy properties to static object to avoid new allocations
+        Object.keys(result).forEach((k) => {
+            this._decodeOutput[k] = result[k];
+        });
+        // Remove any keys not in result
+        Object.keys(this._decodeOutput).forEach((k) => {
+            if (!(k in result))
+                delete this._decodeOutput[k];
+        });
+        return this._decodeOutput;
     }
     isHex(string) {
         return isHex(string);
@@ -86,7 +127,10 @@ class BasicInterface {
         return this.decode(fromHex(string));
     }
     fromArray(array) {
-        return this.decode(Uint8Array.from([...array]));
+        // Avoid unnecessary copy if already Uint8Array
+        if (array instanceof Uint8Array)
+            return this.decode(array);
+        return this.decode(Uint8Array.from(array));
     }
     fromEncoded(encoded) {
         return this.decode(encoded);
@@ -94,15 +138,21 @@ class BasicInterface {
     toString() {
         if (!this.encoded)
             this.encode();
-        return this.encoded.toString();
+        // Use cached string if available
+        if (!this._string)
+            this._string = Array.prototype.join.call(this.encoded, ',');
+        return this._string;
     }
     toHex() {
         if (!this.encoded)
             this.encode();
-        return toHex(this.encoded
-            .toString()
-            .split(',')
-            .map((number) => Number(number)));
+        // Use cached hex if available
+        if (!this._hex) {
+            if (!this._string)
+                this._string = Array.prototype.join.call(this.encoded, ',');
+            this._hex = toHex(this._string.split(',').map(Number));
+        }
+        return this._hex;
     }
     /**
      * @return {String} encoded
@@ -110,7 +160,10 @@ class BasicInterface {
     toBs32() {
         if (!this.encoded)
             this.encode();
-        return toBase32(this.encoded);
+        // Use cached bs32 if available
+        if (!this._bs32)
+            this._bs32 = toBase32(this.encoded);
+        return this._bs32;
     }
     /**
      * @return {String} encoded
@@ -123,3 +176,4 @@ class BasicInterface {
 }
 
 export { BasicInterface as default, jsonParseBigInt, jsonStringifyBigInt };
+//# sourceMappingURL=basic-interface.js.map

package/exports/basic-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-interface.js","sources":["../src/basic-interface.ts"],"sourcesContent":["import base32 from '@vandeurenglenn/base32'\nimport base58 from '@vandeurenglenn/base58'\nimport type { base58String } from '@vandeurenglenn/base58'\nimport type { base32String } from '@vandeurenglenn/base32'\nimport isHex from '@vandeurenglenn/is-hex'\nimport proto from '@vandeurenglenn/proto-array'\nimport {\n  fromBase32,\n  fromBase58,\n  fromString,\n  fromHex,\n  fromArrayLike,\n  fromUintArrayString,\n  toBase32,\n  toBase58,\n  toHex\n} from '@vandeurenglenn/typed-array-utils'\n\nconst BASE64_CHUNK_SIZE = 0x8000\n\nconst uint8ArrayToBase64 = (value: Uint8Array): string => {\n  if (typeof Buffer !== 'undefined') return Buffer.from(value).toString('base64')\n  let binary = ''\n  for (let offset = 0; offset < value.length; offset += BASE64_CHUNK_SIZE) {\n    const slice = value.subarray(offset, offset + BASE64_CHUNK_SIZE)\n    binary += String.fromCharCode(...slice)\n  }\n  return btoa(binary)\n}\n\nconst base64ToUint8Array = (value: string): Uint8Array => {\n  if (typeof Buffer !== 'undefined') return new Uint8Array(Buffer.from(value, 'base64'))\n  const binary = atob(value)\n  const output = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) output[i] = binary.charCodeAt(i)\n  return output\n}\n\nexport const jsonStringifyBigInt = (key, value) => {\n  if (typeof value === 'bigint') return { $bigint: value.toString() }\n  return value\n}\n\nexport const jsonParseBigInt = (key, value) => {\n  if (typeof value === 'object' && value) {\n    if (value.$bigint) return BigInt(value.$bigint)\n  }\n  return value\n}\n\nconst _textEncoder = new TextEncoder()\nconst _textDecoder = new TextDecoder()\n\nexport default class BasicInterface {\n  #encoded: Uint8Array\n  #decoded: object\n  name: string\n  #proto: object\n\n  get keys() {\n    // handles proto keys\n    // protokey -> key\n    return Object.keys(this.#proto).map((key) => (key.endsWith('?') ? key.split('?')[0] : key))\n  }\n\n  get encoded() {\n    if (!this.#encoded) this.#encoded = this.encode()\n    return this.#encoded\n  }\n\n  set encoded(value) {\n    this.#encoded = value\n  }\n\n  get decoded() {\n    if (!this.#decoded) this.#decoded = this.decode()\n    return this.#decoded\n  }\n\n  set decoded(value) {\n    this.#decoded = value\n  }\n\n  set proto(value) {\n    this.#proto = value\n  }\n\n  get proto() {\n    return this.#proto\n  }\n\n  decode(encoded?: Uint8Array): Object {\n    encoded = encoded || this.encoded\n    // Example: decode as JSON if possible (override in subclass)\n    try {\n      return JSON.parse(_textDecoder.decode(encoded), jsonParseBigInt)\n    } catch {\n      return new Object()\n    }\n  }\n\n  encode(decoded?: object): Uint8Array {\n    decoded = decoded || this.decoded\n    // Example: encode as JSON (override in subclass)\n    return _textEncoder.encode(JSON.stringify(decoded, jsonStringifyBigInt))\n  }\n  // get Codec(): Codec {}\n\n  // Cache proto keys/values for reuse\n  static _protoCache = new WeakMap<object, { keys: string[]; values: any[] }>()\n\n  protoEncode(data: object): Uint8Array {\n    let cache = BasicInterface._protoCache.get(this.proto)\n    if (!cache) {\n      cache = {\n        keys: Object.keys(this.proto),\n        values: Object.values(this.proto)\n      }\n      BasicInterface._protoCache.set(this.proto, cache)\n    }\n    // Use proto.encode directly, but avoid new array allocations inside encode if possible\n    return proto.encode(this.proto, data, false)\n  }\n\n  protoDecode(data: Uint8Array): object {\n    // Use a static output object if possible (not thread-safe, but safe for single-threaded use)\n    if (!this._decodeOutput) this._decodeOutput = {}\n    const result = proto.decode(this.proto, data, false)\n    // Copy properties to static object to avoid new allocations\n    Object.keys(result).forEach((k) => {\n      this._decodeOutput[k] = result[k]\n    })\n    // Remove any keys not in result\n    Object.keys(this._decodeOutput).forEach((k) => {\n      if (!(k in result)) delete this._decodeOutput[k]\n    })\n    return this._decodeOutput\n  }\n\n  isHex(string: string): boolean {\n    return isHex(string)\n  }\n  isBase32(string: string): boolean {\n    return base32.isBase32(string)\n  }\n  isBase58(string: string): boolean {\n    return base58.isBase58(string)\n  }\n\n  fromBs32(encoded: string): object {\n    return this.decode(base32.decode(encoded))\n  }\n\n  fromBs58(encoded: base58String): object {\n    return this.decode(fromBase58(encoded))\n  }\n\n  async toArray() {\n    const array: number[] = []\n    for await (const value of this.encoded.values()) {\n      array.push(value)\n    }\n    return array\n  }\n\n  fromString(string: string): object {\n    const array: string[] = string.split(',')\n    const arrayLike = array.map((string) => Number(string))\n    return this.decode(Uint8Array.from(arrayLike))\n  }\n\n  fromHex(string: string): object {\n    return this.decode(fromHex(string))\n  }\n\n  fromArray(array: number[]): object {\n    // Avoid unnecessary copy if already Uint8Array\n    if (array instanceof Uint8Array) return this.decode(array)\n    return this.decode(Uint8Array.from(array))\n  }\n\n  fromEncoded(encoded: Uint8Array) {\n    return this.decode(encoded)\n  }\n\n  toString(): string {\n    if (!this.encoded) this.encode()\n    // Use cached string if available\n    if (!this._string) this._string = Array.prototype.join.call(this.encoded, ',')\n    return this._string\n  }\n\n  toHex(): string {\n    if (!this.encoded) this.encode()\n    // Use cached hex if available\n    if (!this._hex) {\n      if (!this._string) this._string = Array.prototype.join.call(this.encoded, ',')\n      this._hex = toHex(this._string.split(',').map(Number))\n    }\n    return this._hex\n  }\n\n  /**\n   * @return {String} encoded\n   */\n  toBs32(): base32String {\n    if (!this.encoded) this.encode()\n    // Use cached bs32 if available\n    if (!this._bs32) this._bs32 = toBase32(this.encoded)\n    return this._bs32\n  }\n\n  /**\n   * @return {String} encoded\n   */\n  toBs58(): base58String {\n    if (!this.encoded) this.encode()\n    return toBase58(this.encoded)\n  }\n}\n"],"names":[],"mappings":"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"}

package/exports/cjs/basic-interface.js

@@ -0,0 +1,185 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var base32 = require('@vandeurenglenn/base32');
+var base58 = require('@vandeurenglenn/base58');
+var isHex = require('@vandeurenglenn/is-hex');
+var proto = require('@vandeurenglenn/proto-array');
+var typedArrayUtils = require('@vandeurenglenn/typed-array-utils');
+
+const jsonStringifyBigInt = (key, value) => {
+    if (typeof value === 'bigint')
+        return { $bigint: value.toString() };
+    return value;
+};
+const jsonParseBigInt = (key, value) => {
+    if (typeof value === 'object' && value) {
+        if (value.$bigint)
+            return BigInt(value.$bigint);
+    }
+    return value;
+};
+const _textEncoder = new TextEncoder();
+const _textDecoder = new TextDecoder();
+class BasicInterface {
+    #encoded;
+    #decoded;
+    name;
+    #proto;
+    get keys() {
+        // handles proto keys
+        // protokey -> key
+        return Object.keys(this.#proto).map((key) => (key.endsWith('?') ? key.split('?')[0] : key));
+    }
+    get encoded() {
+        if (!this.#encoded)
+            this.#encoded = this.encode();
+        return this.#encoded;
+    }
+    set encoded(value) {
+        this.#encoded = value;
+    }
+    get decoded() {
+        if (!this.#decoded)
+            this.#decoded = this.decode();
+        return this.#decoded;
+    }
+    set decoded(value) {
+        this.#decoded = value;
+    }
+    set proto(value) {
+        this.#proto = value;
+    }
+    get proto() {
+        return this.#proto;
+    }
+    decode(encoded) {
+        encoded = encoded || this.encoded;
+        // Example: decode as JSON if possible (override in subclass)
+        try {
+            return JSON.parse(_textDecoder.decode(encoded), jsonParseBigInt);
+        }
+        catch {
+            return new Object();
+        }
+    }
+    encode(decoded) {
+        decoded = decoded || this.decoded;
+        // Example: encode as JSON (override in subclass)
+        return _textEncoder.encode(JSON.stringify(decoded, jsonStringifyBigInt));
+    }
+    // get Codec(): Codec {}
+    // Cache proto keys/values for reuse
+    static _protoCache = new WeakMap();
+    protoEncode(data) {
+        let cache = BasicInterface._protoCache.get(this.proto);
+        if (!cache) {
+            cache = {
+                keys: Object.keys(this.proto),
+                values: Object.values(this.proto)
+            };
+            BasicInterface._protoCache.set(this.proto, cache);
+        }
+        // Use proto.encode directly, but avoid new array allocations inside encode if possible
+        return proto.encode(this.proto, data, false);
+    }
+    protoDecode(data) {
+        // Use a static output object if possible (not thread-safe, but safe for single-threaded use)
+        if (!this._decodeOutput)
+            this._decodeOutput = {};
+        const result = proto.decode(this.proto, data, false);
+        // Copy properties to static object to avoid new allocations
+        Object.keys(result).forEach((k) => {
+            this._decodeOutput[k] = result[k];
+        });
+        // Remove any keys not in result
+        Object.keys(this._decodeOutput).forEach((k) => {
+            if (!(k in result))
+                delete this._decodeOutput[k];
+        });
+        return this._decodeOutput;
+    }
+    isHex(string) {
+        return isHex(string);
+    }
+    isBase32(string) {
+        return base32.isBase32(string);
+    }
+    isBase58(string) {
+        return base58.isBase58(string);
+    }
+    fromBs32(encoded) {
+        return this.decode(base32.decode(encoded));
+    }
+    fromBs58(encoded) {
+        return this.decode(typedArrayUtils.fromBase58(encoded));
+    }
+    async toArray() {
+        const array = [];
+        for await (const value of this.encoded.values()) {
+            array.push(value);
+        }
+        return array;
+    }
+    fromString(string) {
+        const array = string.split(',');
+        const arrayLike = array.map((string) => Number(string));
+        return this.decode(Uint8Array.from(arrayLike));
+    }
+    fromHex(string) {
+        return this.decode(typedArrayUtils.fromHex(string));
+    }
+    fromArray(array) {
+        // Avoid unnecessary copy if already Uint8Array
+        if (array instanceof Uint8Array)
+            return this.decode(array);
+        return this.decode(Uint8Array.from(array));
+    }
+    fromEncoded(encoded) {
+        return this.decode(encoded);
+    }
+    toString() {
+        if (!this.encoded)
+            this.encode();
+        // Use cached string if available
+        if (!this._string)
+            this._string = Array.prototype.join.call(this.encoded, ',');
+        return this._string;
+    }
+    toHex() {
+        if (!this.encoded)
+            this.encode();
+        // Use cached hex if available
+        if (!this._hex) {
+            if (!this._string)
+                this._string = Array.prototype.join.call(this.encoded, ',');
+            this._hex = typedArrayUtils.toHex(this._string.split(',').map(Number));
+        }
+        return this._hex;
+    }
+    /**
+     * @return {String} encoded
+     */
+    toBs32() {
+        if (!this.encoded)
+            this.encode();
+        // Use cached bs32 if available
+        if (!this._bs32)
+            this._bs32 = typedArrayUtils.toBase32(this.encoded);
+        return this._bs32;
+    }
+    /**
+     * @return {String} encoded
+     */
+    toBs58() {
+        if (!this.encoded)
+            this.encode();
+        return typedArrayUtils.toBase58(this.encoded);
+    }
+}
+
+exports.default = BasicInterface;
+exports.jsonParseBigInt = jsonParseBigInt;
+exports.jsonStringifyBigInt = jsonStringifyBigInt;
+//# sourceMappingURL=basic-interface.js.map

package/exports/cjs/basic-interface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"basic-interface.js","sources":["../../src/basic-interface.ts"],"sourcesContent":["import base32 from '@vandeurenglenn/base32'\nimport base58 from '@vandeurenglenn/base58'\nimport type { base58String } from '@vandeurenglenn/base58'\nimport type { base32String } from '@vandeurenglenn/base32'\nimport isHex from '@vandeurenglenn/is-hex'\nimport proto from '@vandeurenglenn/proto-array'\nimport {\n  fromBase32,\n  fromBase58,\n  fromString,\n  fromHex,\n  fromArrayLike,\n  fromUintArrayString,\n  toBase32,\n  toBase58,\n  toHex\n} from '@vandeurenglenn/typed-array-utils'\n\nconst BASE64_CHUNK_SIZE = 0x8000\n\nconst uint8ArrayToBase64 = (value: Uint8Array): string => {\n  if (typeof Buffer !== 'undefined') return Buffer.from(value).toString('base64')\n  let binary = ''\n  for (let offset = 0; offset < value.length; offset += BASE64_CHUNK_SIZE) {\n    const slice = value.subarray(offset, offset + BASE64_CHUNK_SIZE)\n    binary += String.fromCharCode(...slice)\n  }\n  return btoa(binary)\n}\n\nconst base64ToUint8Array = (value: string): Uint8Array => {\n  if (typeof Buffer !== 'undefined') return new Uint8Array(Buffer.from(value, 'base64'))\n  const binary = atob(value)\n  const output = new Uint8Array(binary.length)\n  for (let i = 0; i < binary.length; i++) output[i] = binary.charCodeAt(i)\n  return output\n}\n\nexport const jsonStringifyBigInt = (key, value) => {\n  if (typeof value === 'bigint') return { $bigint: value.toString() }\n  return value\n}\n\nexport const jsonParseBigInt = (key, value) => {\n  if (typeof value === 'object' && value) {\n    if (value.$bigint) return BigInt(value.$bigint)\n  }\n  return value\n}\n\nconst _textEncoder = new TextEncoder()\nconst _textDecoder = new TextDecoder()\n\nexport default class BasicInterface {\n  #encoded: Uint8Array\n  #decoded: object\n  name: string\n  #proto: object\n\n  get keys() {\n    // handles proto keys\n    // protokey -> key\n    return Object.keys(this.#proto).map((key) => (key.endsWith('?') ? key.split('?')[0] : key))\n  }\n\n  get encoded() {\n    if (!this.#encoded) this.#encoded = this.encode()\n    return this.#encoded\n  }\n\n  set encoded(value) {\n    this.#encoded = value\n  }\n\n  get decoded() {\n    if (!this.#decoded) this.#decoded = this.decode()\n    return this.#decoded\n  }\n\n  set decoded(value) {\n    this.#decoded = value\n  }\n\n  set proto(value) {\n    this.#proto = value\n  }\n\n  get proto() {\n    return this.#proto\n  }\n\n  decode(encoded?: Uint8Array): Object {\n    encoded = encoded || this.encoded\n    // Example: decode as JSON if possible (override in subclass)\n    try {\n      return JSON.parse(_textDecoder.decode(encoded), jsonParseBigInt)\n    } catch {\n      return new Object()\n    }\n  }\n\n  encode(decoded?: object): Uint8Array {\n    decoded = decoded || this.decoded\n    // Example: encode as JSON (override in subclass)\n    return _textEncoder.encode(JSON.stringify(decoded, jsonStringifyBigInt))\n  }\n  // get Codec(): Codec {}\n\n  // Cache proto keys/values for reuse\n  static _protoCache = new WeakMap<object, { keys: string[]; values: any[] }>()\n\n  protoEncode(data: object): Uint8Array {\n    let cache = BasicInterface._protoCache.get(this.proto)\n    if (!cache) {\n      cache = {\n        keys: Object.keys(this.proto),\n        values: Object.values(this.proto)\n      }\n      BasicInterface._protoCache.set(this.proto, cache)\n    }\n    // Use proto.encode directly, but avoid new array allocations inside encode if possible\n    return proto.encode(this.proto, data, false)\n  }\n\n  protoDecode(data: Uint8Array): object {\n    // Use a static output object if possible (not thread-safe, but safe for single-threaded use)\n    if (!this._decodeOutput) this._decodeOutput = {}\n    const result = proto.decode(this.proto, data, false)\n    // Copy properties to static object to avoid new allocations\n    Object.keys(result).forEach((k) => {\n      this._decodeOutput[k] = result[k]\n    })\n    // Remove any keys not in result\n    Object.keys(this._decodeOutput).forEach((k) => {\n      if (!(k in result)) delete this._decodeOutput[k]\n    })\n    return this._decodeOutput\n  }\n\n  isHex(string: string): boolean {\n    return isHex(string)\n  }\n  isBase32(string: string): boolean {\n    return base32.isBase32(string)\n  }\n  isBase58(string: string): boolean {\n    return base58.isBase58(string)\n  }\n\n  fromBs32(encoded: string): object {\n    return this.decode(base32.decode(encoded))\n  }\n\n  fromBs58(encoded: base58String): object {\n    return this.decode(fromBase58(encoded))\n  }\n\n  async toArray() {\n    const array: number[] = []\n    for await (const value of this.encoded.values()) {\n      array.push(value)\n    }\n    return array\n  }\n\n  fromString(string: string): object {\n    const array: string[] = string.split(',')\n    const arrayLike = array.map((string) => Number(string))\n    return this.decode(Uint8Array.from(arrayLike))\n  }\n\n  fromHex(string: string): object {\n    return this.decode(fromHex(string))\n  }\n\n  fromArray(array: number[]): object {\n    // Avoid unnecessary copy if already Uint8Array\n    if (array instanceof Uint8Array) return this.decode(array)\n    return this.decode(Uint8Array.from(array))\n  }\n\n  fromEncoded(encoded: Uint8Array) {\n    return this.decode(encoded)\n  }\n\n  toString(): string {\n    if (!this.encoded) this.encode()\n    // Use cached string if available\n    if (!this._string) this._string = Array.prototype.join.call(this.encoded, ',')\n    return this._string\n  }\n\n  toHex(): string {\n    if (!this.encoded) this.encode()\n    // Use cached hex if available\n    if (!this._hex) {\n      if (!this._string) this._string = Array.prototype.join.call(this.encoded, ',')\n      this._hex = toHex(this._string.split(',').map(Number))\n    }\n    return this._hex\n  }\n\n  /**\n   * @return {String} encoded\n   */\n  toBs32(): base32String {\n    if (!this.encoded) this.encode()\n    // Use cached bs32 if available\n    if (!this._bs32) this._bs32 = toBase32(this.encoded)\n    return this._bs32\n  }\n\n  /**\n   * @return {String} encoded\n   */\n  toBs58(): base58String {\n    if (!this.encoded) this.encode()\n    return toBase58(this.encoded)\n  }\n}\n"],"names":["fromBase58","fromHex","toHex","toBase32","toBase58"],"mappings":"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"}

package/exports/cjs/codec-format-interface.js

@@ -0,0 +1,197 @@
+'use strict';
+
+var basicInterface = require('./basic-interface.js');
+var codec = require('./codec.js');
+var codecHash = require('./codec-hash.js');
+require('@vandeurenglenn/base32');
+require('@vandeurenglenn/base58');
+require('@vandeurenglenn/is-hex');
+require('@vandeurenglenn/proto-array');
+require('@vandeurenglenn/typed-array-utils');
+require('varint');
+require('@leofcoin/codecs');
+require('hash-wasm');
+
+class FormatInterface extends basicInterface.default {
+    hashFormat;
+    #hash;
+    #encoded;
+    get encoded() {
+        return this.#encoded || this.encode();
+    }
+    set encoded(value) {
+        this.#encoded = value;
+    }
+    init(buffer) {
+        if (buffer instanceof FormatInterface && buffer?.name === this.name) {
+            return buffer;
+        }
+        else if (buffer instanceof Uint8Array) {
+            this.fromUint8Array(buffer);
+        }
+        else if (buffer instanceof ArrayBuffer) {
+            this.fromArrayBuffer(buffer);
+        }
+        else if (typeof buffer === 'string') {
+            if (this.isHex(buffer))
+                this.fromHex(buffer);
+            else if (this.isBase58(buffer))
+                this.fromBs58(buffer);
+            else if (this.isBase32(buffer))
+                this.fromBs32(buffer);
+            else
+                this.fromString(buffer);
+        }
+        else if (typeof buffer === 'object' && buffer !== null) {
+            this.create(buffer);
+        }
+        else {
+            // Explicitly reject all other types (number, boolean, undefined, symbol, function, null)
+            throw new TypeError(`Invalid input type for FormatInterface: ${typeof buffer}`);
+        }
+        return this;
+    }
+    hasCodec() {
+        if (!this.encoded)
+            return false;
+        const codec$1 = new codec(this.encoded);
+        if (codec$1.name)
+            return true;
+    }
+    decode(encoded) {
+        encoded = encoded || this.encoded;
+        const codec$1 = new codec(encoded);
+        if (codec$1.codecBuffer) {
+            encoded = encoded.slice(codec$1.codecBuffer.length);
+            this.name = codec$1.name;
+            this.decoded = this.protoDecode(encoded);
+            // try {
+            //   this.decoded = JSON.parse(this.decoded)
+            // } catch {
+            // }
+        }
+        else {
+            throw new Error(`no codec found`);
+        }
+        return this.decoded;
+    }
+    encode(decoded) {
+        let encoded;
+        decoded = decoded || this.decoded;
+        const codec$1 = new codec(this.name);
+        if (decoded instanceof Uint8Array)
+            encoded = decoded;
+        else
+            encoded = this.protoEncode(decoded);
+        if (codec$1.codecBuffer) {
+            const uint8Array = new Uint8Array(encoded.length + codec$1.codecBuffer.length);
+            uint8Array.set(codec$1.codecBuffer);
+            uint8Array.set(encoded, codec$1.codecBuffer.length);
+            this.encoded = uint8Array;
+        }
+        else {
+            throw new Error(`invalid codec`);
+        }
+        return this.encoded;
+    }
+    /**
+     * @param {Buffer|String|Object} buffer - data - The data needed to create the desired message
+     * @param {Object} proto - {protoObject}
+     * @param {Object} options - {hashFormat, name}
+     */
+    constructor(buffer, proto, options) {
+        super();
+        this.proto = proto;
+        this.hashFormat = options?.hashFormat ? options.hashFormat : 'bs32';
+        if (options?.name)
+            this.name = options.name;
+        this.init(buffer);
+    }
+    get format() {
+        const upper = this.hashFormat.charAt(0).toUpperCase();
+        return `${upper}${this.hashFormat.substring(1, this.hashFormat.length)}`;
+    }
+    /**
+     * Extract content bytes without codec prefix
+     */
+    get contentBytes() {
+        if (!this.encoded)
+            return new Uint8Array(0);
+        const codec$1 = new codec(this.encoded);
+        if (codec$1.codecBuffer) {
+            return this.encoded.slice(codec$1.codecBuffer.length);
+        }
+        return this.encoded;
+    }
+    beforeHashing(decoded) {
+        // Avoid copying if not needed
+        if (decoded && Object.prototype.hasOwnProperty.call(decoded, 'hash')) {
+            // Only copy if hash is present
+            const rest = { ...decoded };
+            delete rest.hash;
+            return rest;
+        }
+        return decoded;
+    }
+    /**
+     * @return {PeernetHash}
+     */
+    get peernetHash() {
+        // Optimize: if decoded has no hash property, contentBytes are already correct
+        // Since protoEncode is deterministic (varint-based), we can use them directly
+        if (this.encoded &&
+            this.decoded &&
+            !Object.prototype.hasOwnProperty.call(this.decoded, 'hash')) {
+            // @ts-ignore
+            const hash = new codecHash({ name: this.name });
+            return hash.init(this.contentBytes);
+        }
+        // Fallback: must re-encode without hash property
+        const decoded = this.beforeHashing({ ...this.decoded });
+        // @ts-ignore
+        const hash = new codecHash({ name: this.name });
+        return hash.init(decoded);
+    }
+    /**
+     * @return {peernetHash}
+     */
+    async hash() {
+        if (this.#hash)
+            return this.#hash;
+        const upper = this.hashFormat.charAt(0).toUpperCase();
+        const format = `${upper}${this.hashFormat.substring(1, this.hashFormat.length)}`;
+        this.#hash = (await this.peernetHash)[`to${format}`]();
+        return this.#hash;
+    }
+    fromUint8Array(buffer) {
+        this.encoded = buffer;
+        return this.hasCodec()
+            ? this.decode()
+            : this.create(JSON.parse(basicInterface.default._textDecoder.decode(this.encoded), basicInterface.jsonParseBigInt));
+    }
+    fromArrayBuffer(buffer) {
+        this.encoded = new Uint8Array(buffer, buffer.byteOffset, buffer.byteLength);
+        return this.hasCodec()
+            ? this.decode()
+            : this.create(JSON.parse(basicInterface.default._textDecoder.decode(this.encoded), basicInterface.jsonParseBigInt));
+    }
+    /**
+     * @param {Object} data
+     */
+    create(data) {
+        const decoded = {};
+        // @ts-ignore
+        if (data.hash)
+            this.#hash = data.hash;
+        if (this.keys?.length > 0) {
+            for (const key of this.keys) {
+                decoded[key] = data[key];
+            }
+            this.decoded = decoded;
+            // return this.encode(decoded)
+        }
+    }
+}
+
+module.exports = FormatInterface;
+//# sourceMappingURL=codec-format-interface.js.map