@did-btcr2/common 2.2.1 → 3.0.0

package/dist/esm/constants.js

@@ -1,4 +1,5 @@
 import { sha256 } from '@noble/hashes/sha2';
+import { bytesToHex } from '@noble/hashes/utils';
 export const ID_PLACEHOLDER_VALUE = 'did:btcr2:xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx';
 export const OP_RETURN = 0x6a;
 export const OP_PUSH32 = 0x20;
@@ -7,31 +8,36 @@ export const MULTIBASE_URI_PREFIX = 'urn:mb:';
 export const INITIAL_BLOCK_REWARD = 50;
 export const HALVING_INTERVAL = 150;
 export const COINBASE_MATURITY_DELAY = 100;
-export const POLAR_BOB_CLIENT_CONFIG = {
+export const DEFAULT_POLAR_CONFIG = {
     username: 'polaruser',
     password: 'polarpass',
     host: 'http://127.0.0.1:18443',
     allowDefaultWallet: true,
     version: '28.1.0'
 };
-export const POLAR_ALICE_CLIENT_CONFIG = {
-    username: 'polaruser',
-    password: 'polarpass',
-    host: 'http://127.0.0.1:18444',
-    allowDefaultWallet: true,
-    version: '28.1.0'
-};
 export const DEFAULT_REST_CONFIG = { host: 'http://localhost:3000' };
-export const DEFAULT_RPC_CONFIG = POLAR_BOB_CLIENT_CONFIG;
+export const DEFAULT_RPC_CONFIG = DEFAULT_POLAR_CONFIG;
 export const DEFAULT_BLOCK_CONFIRMATIONS = 7;
+/**
+ * Load a default RPC config, allowing environment overrides to avoid hard-coding credentials/hosts in bundles.
+ * @returns {typeof DEFAULT_POLAR_CONFIG} The RPC config.
+ */
+export function getDefaultRpcConfig() {
+    return {
+        ...DEFAULT_POLAR_CONFIG,
+        host: process.env.BTCR2_RPC_HOST ?? DEFAULT_POLAR_CONFIG.host,
+        username: process.env.BTCR2_RPC_USER ?? DEFAULT_POLAR_CONFIG.username,
+        password: process.env.BTCR2_RPC_PASS ?? DEFAULT_POLAR_CONFIG.password,
+    };
+}
 // Fixed public key header bytes per the Data Integrity BIP340 Cryptosuite spec: [0xe7, 0x01] / [231, 1]
 export const BIP340_PUBLIC_KEY_MULTIBASE_PREFIX = new Uint8Array([0xe7, 0x01]);
 // Hash of the BIP-340 Multikey prefix
-export const BIP340_PUBLIC_KEY_MULTIBASE_PREFIX_HASH = Buffer.from(sha256(BIP340_PUBLIC_KEY_MULTIBASE_PREFIX)).toString('hex');
+export const BIP340_PUBLIC_KEY_MULTIBASE_PREFIX_HASH = bytesToHex(sha256(BIP340_PUBLIC_KEY_MULTIBASE_PREFIX));
 // Fixed secret key header bytes per the Data Integrity BIP340 Cryptosuite spec: [0x81, 0x26] / [129, 38]
 export const BIP340_SECRET_KEY_MULTIBASE_PREFIX = new Uint8Array([0x81, 0x26]);
 // Hash of the BIP-340 Multikey prefix
-export const BIP340_SECRET_KEY_MULTIBASE_PREFIX_HASH = Buffer.from(sha256(BIP340_SECRET_KEY_MULTIBASE_PREFIX)).toString('hex');
+export const BIP340_SECRET_KEY_MULTIBASE_PREFIX_HASH = bytesToHex(sha256(BIP340_SECRET_KEY_MULTIBASE_PREFIX));
 // curve's field size
 export const B256 = 2n ** 256n;
 // curve's field prime
@@ -68,35 +74,32 @@ export const W3C_DID_RESOLUTION_V1 = 'https://w3id.org/did-resolution/v1';
 export const CONTEXT_URL_MAP = {
     w3c: {
         did: {
-            v1: 'https://www.w3.org/ns/did/v1',
-            v1_1: 'https://www.w3.org/TR/did-1.1',
+            v1: W3C_DID_V1,
+            v1_1: W3C_DID_V1_1,
         },
         didresolution: {
-            v1: 'https://w3id.org/did-resolution/v1',
+            v1: W3C_DID_RESOLUTION_V1,
         },
         security: {
-            v2: 'https://w3id.org/security/v2',
+            v2: W3C_SECURITY_V2,
         },
         dataintegrity: {
-            v1: 'https://w3id.org/security/data-integrity/v1',
-            v2: 'https://w3id.org/security/data-integrity/v2',
+            v1: W3C_DATA_INTEGRITY_V1,
+            v2: W3C_DATA_INTEGRITY_V2,
         },
         zcap: {
-            v1: 'https://w3id.org/zcap/v1',
+            v1: W3C_ZCAP_V1,
         },
         jsonldpatch: {
-            v1: 'https://w3id.org/json-ld-patch/v1',
+            v1: W3C_JSONLD_PATCH_V1,
         },
         multikey: {
-            v1: 'https://w3id.org/security/multikey/v1',
+            v1: W3C_MULTIKEY_V1,
         },
     },
     btcr2: {
-        diddocument: {
-            v1: 'https://dcdpr.github.io/did-btcr2-js/ns/did-document/v1',
-        },
         method: {
-            v1: 'https://btcr2.dev/context/v1'
+            v1: BTCR2_METHOD_CONTEXT
         },
     },
 };
@@ -109,6 +112,7 @@ export const BTCR2_MULTIKEY_CONTEXT = [
     CONTEXT_URL_MAP.w3c.multikey.v1
 ];
 export const BTCR2_DID_UPDATE_PAYLOAD_CONTEXT = [
+    CONTEXT_URL_MAP.btcr2.method.v1,
     CONTEXT_URL_MAP.w3c.security.v2,
     CONTEXT_URL_MAP.w3c.zcap.v1,
     CONTEXT_URL_MAP.w3c.jsonldpatch.v1,

package/dist/esm/constants.js.map

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

package/dist/esm/index.js

@@ -1,10 +1,12 @@
-import './exts.js';
 export * from './canonicalization.js';
 export * from './constants.js';
 export * from './errors.js';
 export * from './interfaces.js';
+export * from './json-patch.js';
 export * from './logger.js';
-export * from './patch.js';
 export * from './types.js';
-export * from './exts.js';
+export * from './utils/date.js';
+export * from './utils/json.js';
+export * from './utils/set.js';
+export * from './utils/string.js';
 //# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,CAAC;AAEnB,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAE3B,cAAc,WAAW,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,aAAa,CAAC;AAC5B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,mBAAmB,CAAC"}

package/dist/esm/json-patch.js

@@ -0,0 +1,98 @@
+import jsonPatch from 'fast-json-patch';
+import { MethodError } from './errors.js';
+const { applyPatch, compare, deepClone } = jsonPatch;
+/**
+ * Thin wrapper around fast-json-patch to keep a stable API within this package.
+ * @class JSONPatch
+ * @type {JSONPatch}
+ */
+export class JSONPatch {
+    /**
+     * Applies a JSON Patch to a source document and returns the patched document.
+     * Does not mutate the input document.
+     * @param {JSONObject} sourceDocument - The source JSON document to apply the patch to.
+     * @param {PatchOperation[]} operations - The JSON Patch operations to apply.
+     * @returns {JSONObject} The patched JSON document.
+     */
+    static apply(sourceDocument, operations, options = {}) {
+        const mutate = options.mutate ?? false;
+        const cloneFn = options.clone ?? deepClone;
+        const docClone = mutate ? sourceDocument : cloneFn(sourceDocument);
+        const validationError = this.validateOperations(operations);
+        if (validationError) {
+            throw new MethodError('Invalid JSON Patch operations', 'JSON_PATCH_APPLY_ERROR', { error: validationError });
+        }
+        try {
+            const result = applyPatch(docClone, operations, true, mutate);
+            if (result.newDocument === undefined) {
+                throw new MethodError('JSON Patch application failed', 'JSON_PATCH_APPLY_ERROR', { result });
+            }
+            return result.newDocument;
+        }
+        catch (error) {
+            throw new MethodError('JSON Patch application failed', 'JSON_PATCH_APPLY_ERROR', { error });
+        }
+    }
+    /**
+     * Compute a JSON Patch diff from source => target.
+     * @param {JSONObject} sourceDocument - The source JSON document.
+     * @param {JSONObject} targetDocument - The target JSON document.
+     * @param {string} [path] - An optional base path to prefix to each operation.
+     * @returns {PatchOperation[]} The computed JSON Patch operations.
+     */
+    static diff(sourceDocument, targetDocument, path = '') {
+        const ops = compare(sourceDocument ?? {}, targetDocument ?? {});
+        if (!path)
+            return ops;
+        const prefix = path.endsWith('/') ? path.slice(0, -1) : path;
+        return ops.map(op => ({
+            ...op,
+            path: this.joinPointer(prefix, op.path)
+        }));
+    }
+    /**
+   * Join a base pointer prefix with an operation path ensuring correct escaping.
+   * @param {string} prefix - The base pointer prefix.
+   * @param {string} opPath - The operation path.
+   * @returns {string} The joined pointer.
+   */
+    static joinPointer(prefix, opPath) {
+        if (!prefix)
+            return opPath;
+        const normalizedPrefix = prefix.startsWith('/') ? prefix : `/${prefix}`;
+        return `${this.escapeSegmentPath(normalizedPrefix)}${opPath}`;
+    }
+    /**
+   * Escape a JSON Pointer segment according to RFC 6901.
+   * @param {string} pointer - The JSON Pointer to escape.
+   * @returns {string} The escaped JSON Pointer.
+   */
+    static escapeSegmentPath(pointer) {
+        return pointer
+            .split('/')
+            .map((segment, idx) => idx === 0 ? segment : segment.replace(/~/g, '~0').replace(/\//g, '~1'))
+            .join('/');
+    }
+    /**
+   * Validate JSON Patch operations.
+   * @param {PatchOperation[]} operations - The operations to validate.
+   * @returns {Error | null} An Error if validation fails, otherwise null.
+   */
+    static validateOperations(operations) {
+        if (!Array.isArray(operations))
+            return new Error('Operations must be an array');
+        for (const op of operations) {
+            if (!op || typeof op !== 'object')
+                return new Error('Operation must be an object');
+            if (typeof op.op !== 'string')
+                return new Error('Operation.op must be a string');
+            if (typeof op.path !== 'string')
+                return new Error('Operation.path must be a string');
+            if ((op.op === 'move' || op.op === 'copy') && typeof op.from !== 'string') {
+                return new Error(`Operation.from must be a string for op=${op.op}`);
+            }
+        }
+        return null;
+    }
+}
+//# sourceMappingURL=json-patch.js.map

package/dist/esm/json-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-patch.js","sourceRoot":"","sources":["../../src/json-patch.ts"],"names":[],"mappings":"AAAA,OAAO,SAAwB,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAI1C,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,SAAS,EAAE,GAAG,SAAS,CAAC;AAErD;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACpB;;;;;;OAMG;IACH,MAAM,CAAC,KAAK,CACV,cAAgC,EAChC,UAA4B,EAC5B,UAA6D,EAAE;QAE/D,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,KAAK,CAAC;QACvC,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,IAAI,SAAS,CAAC;QAC3C,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC;QACnE,MAAM,eAAe,GAAG,IAAI,CAAC,kBAAkB,CAAC,UAAU,CAAC,CAAC;QAC5D,IAAI,eAAe,EAAE,CAAC;YACpB,MAAM,IAAI,WAAW,CAAC,+BAA+B,EAAE,wBAAwB,EAAE,EAAE,KAAK,EAAE,eAAe,EAAE,CAAC,CAAC;QAC/G,CAAC;QACD,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,UAAU,CAAC,QAAQ,EAAE,UAAyB,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC7E,IAAI,MAAM,CAAC,WAAW,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,IAAI,WAAW,CAAC,+BAA+B,EAAE,wBAAwB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;YAC/F,CAAC;YACD,OAAO,MAAM,CAAC,WAAyB,CAAC;QAC1C,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,IAAI,WAAW,CAAC,+BAA+B,EAAE,wBAAwB,EAAE,EAAE,KAAK,EAAE,CAAC,CAAC;QAC9F,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,MAAM,CAAC,IAAI,CAAC,cAA0B,EAAE,cAA0B,EAAE,OAAe,EAAE;QACnF,MAAM,GAAG,GAAG,OAAO,CAAC,cAAc,IAAI,EAAE,EAAE,cAAc,IAAI,EAAE,CAAqB,CAAC;QACpF,IAAI,CAAC,IAAI;YAAE,OAAO,GAAG,CAAC;QAEtB,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAC7D,OAAO,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;YACpB,GAAG,EAAE;YACL,IAAI,EAAG,IAAI,CAAC,WAAW,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC;SACzC,CAAC,CAAC,CAAC;IACN,CAAC;IAED;;;;;KAKC;IACD,MAAM,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc;QAC/C,IAAI,CAAC,MAAM;YAAE,OAAO,MAAM,CAAC;QAC3B,MAAM,gBAAgB,GAAG,MAAM,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,MAAM,EAAE,CAAC;QACxE,OAAO,GAAG,IAAI,CAAC,iBAAiB,CAAC,gBAAgB,CAAC,GAAG,MAAM,EAAE,CAAC;IAChE,CAAC;IAED;;;;KAIC;IACD,MAAM,CAAC,iBAAiB,CAAC,OAAe;QACtC,OAAO,OAAO;aACX,KAAK,CAAC,GAAG,CAAC;aACV,GAAG,CAAC,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC;aAC7F,IAAI,CAAC,GAAG,CAAC,CAAC;IACf,CAAC;IAED;;;;KAIC;IACD,MAAM,CAAC,kBAAkB,CAAC,UAA4B;QACpD,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,UAAU,CAAC;YAAE,OAAO,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAChF,KAAK,MAAM,EAAE,IAAI,UAAU,EAAE,CAAC;YAC5B,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ;gBAAE,OAAO,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAC;YACnF,IAAI,OAAO,EAAE,CAAC,EAAE,KAAK,QAAQ;gBAAE,OAAO,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;YACjF,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ;gBAAE,OAAO,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;YACrF,IAAI,CAAC,EAAE,CAAC,EAAE,KAAK,MAAM,IAAI,EAAE,CAAC,EAAE,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;gBAC1E,OAAO,IAAI,KAAK,CAAC,0CAA0C,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;YACtE,CAAC;QACH,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;CACF"}

package/dist/esm/logger.js

@@ -44,16 +44,33 @@ const LEVEL_METHODS = {
  * - File/line tracing
  * - Timestamps
  * - Colorized output
+ * @class Logger
+ * @type {Logger}
  */
 export class Logger {
     levels;
     namespace;
-    constructor(namespace) {
-        this.levels = LOG_LEVELS[NODE_ENV] || [];
-        this.namespace = namespace ?? 'did-btcr2-js';
+    useColors;
+    static shared;
+    /**
+     * Creates a new Logger instance.
+     * @param {string} namespace - Optional namespace for log messages.
+     * @param {Object} options - Configuration options.
+     * @param {Level[]} options.levels - Log levels to enable.
+     * @param {boolean} options.useColors - Whether to use colored output.
+     */
+    constructor(namespace, options = {}) {
+        this.levels = options.levels || LOG_LEVELS[NODE_ENV] || [];
+        this.namespace = namespace || 'did-btcr2-js';
+        const envForce = process.env.LOG_COLORS;
+        this.useColors = options.useColors || (envForce ? envForce !== '0' && envForce.toLowerCase() !== 'false' : Boolean(process.stdout.isTTY));
     }
     /**
      * Logs a message with the specified level.
+     * @param {Level} level - The log level.
+     * @param {unknown} message - The message to log.
+     * @param {...unknown[]} args - Additional arguments to log.
+     * @returns {void}
      */
     _log(level, message, ...args) {
         if (!this.levels.includes(level))
@@ -62,9 +79,10 @@ export class Logger {
         const method = LEVEL_METHODS[level];
         const timestamp = new Date().toISOString();
         const namespace = this.namespace ? `[${this.namespace}]` : '';
-        console[method](`${chalk.gray(timestamp)} ${namespace} ${color(level)}: ${chalk.white(message)}`, ...args);
+        const render = this.useColors ? color : (v) => v;
+        const renderGray = this.useColors ? chalk.gray : (v) => v;
+        console[method](`${renderGray(timestamp)} ${namespace} ${render(level)}: ${message}`, ...args);
     }
-    // 🔹 Instance-based logging methods
     debug(message, ...args) {
         this._log('debug', message, ...args);
         return this;
@@ -95,27 +113,43 @@ export class Logger {
     }
     /**
      * Static methods for convenience (auto-instantiate).
+     * These use a shared singleton instance.
+     * @param {unknown} message - The message to log.
+     * @param {...unknown[]} args - Additional arguments to log.
+     * @returns {void}
      */
     static debug(message, ...args) {
-        new Logger().debug(message, ...args);
+        Logger.instance().debug(message, ...args);
     }
     static error(message, ...args) {
-        new Logger().error(message, ...args);
+        Logger.instance().error(message, ...args);
     }
     static info(message, ...args) {
-        new Logger().info(message, ...args);
+        Logger.instance().info(message, ...args);
     }
     static warn(message, ...args) {
-        new Logger().warn(message, ...args);
+        Logger.instance().warn(message, ...args);
     }
     static security(message, ...args) {
-        new Logger().security(message, ...args);
+        Logger.instance().security(message, ...args);
     }
     static log(message, ...args) {
-        new Logger().log(message, ...args);
+        Logger.instance().log(message, ...args);
     }
     static newline() {
-        new Logger().newline();
+        Logger.instance().newline();
+    }
+    static instance(levels, useColors) {
+        if (!Logger.shared) {
+            Logger.shared = new Logger(undefined, { levels, useColors });
+        }
+        else {
+            if (levels)
+                Logger.shared.levels = levels;
+            if (useColors !== undefined)
+                Logger.shared.useColors = useColors;
+        }
+        return Logger.shared;
     }
 }
 //# sourceMappingURL=logger.js.map

package/dist/esm/logger.js.map

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

package/dist/esm/utils/date.js

@@ -0,0 +1,32 @@
+/**
+ * Utility class for date-related operations.
+ * @name DateUtils
+ * @class DateUtils
+ */
+export class DateUtils {
+    /**
+     * Render an ISO 8601 UTC timestamp without fractional seconds.
+     * @param {Date} [date=new Date()] - The date to format.
+     * @returns {string} The formatted date string.
+     */
+    static getUTCDateTime(date = new Date()) {
+        const time = date.getTime();
+        if (Number.isNaN(time)) {
+            throw new Error(`Invalid date: ${date}`);
+        }
+        return date.toISOString().replace(/\.\d{3}Z$/, 'Z');
+    }
+    /**
+     * Unix timestamp in seconds (integer).
+     * @param {Date} [date=new Date()] - The date to convert.
+     * @returns {number} The Unix timestamp in seconds.
+     */
+    static toUnixSeconds(date = new Date()) {
+        const time = date.getTime();
+        if (Number.isNaN(time)) {
+            throw new Error(`Invalid date: ${date}`);
+        }
+        return Math.floor(date.getTime() / 1000);
+    }
+}
+//# sourceMappingURL=date.js.map

package/dist/esm/utils/date.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","sourceRoot":"","sources":["../../../src/utils/date.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,OAAO,SAAS;IACpB;;;;OAIG;IACH,MAAM,CAAC,cAAc,CAAC,OAAa,IAAI,IAAI,EAAE;QAC3C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;IACtD,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,aAAa,CAAC,OAAa,IAAI,IAAI,EAAE;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC5B,IAAI,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACvB,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,EAAE,CAAC,CAAC;QAC3C,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;CACF"}