@towns-protocol/utils 0.0.349

package/LICENSE.txt

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 River Association
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,3 @@
+# A utils lib
+
+Includes logging and a few other catchall items

package/dist/binary.d.ts

@@ -0,0 +1,11 @@
+export declare function bin_fromBase64(base64String: string): Uint8Array;
+export declare function bin_toBase64(uint8Array: Uint8Array): string;
+export declare function bin_fromHexString(hexString: string): Uint8Array;
+export declare function bin_toHexString(uint8Array: Uint8Array): string;
+export declare function bin_fromString(str: string): Uint8Array;
+export declare function bin_toString(buf: Uint8Array): string;
+export declare function shortenHexString(s: string): string;
+export declare function isHexString(value: string): boolean;
+export declare function bin_equal(a: Uint8Array | null | undefined, b: Uint8Array | null | undefined): boolean;
+export declare function bigIntToBytes(value: bigint): Uint8Array;
+//# sourceMappingURL=binary.d.ts.map

package/dist/binary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.d.ts","sourceRoot":"","sources":["../src/binary.ts"],"names":[],"mappings":"AASA,wBAAgB,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,UAAU,CAE/D;AAED,wBAAgB,YAAY,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE3D;AAED,wBAAgB,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,UAAU,CAE/D;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAE9D;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,CAEtD;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,MAAM,CAEpD;AAED,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKlD;AAED,wBAAgB,SAAS,CACrB,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,EAChC,CAAC,EAAE,UAAU,GAAG,IAAI,GAAG,SAAS,GACjC,OAAO,CAUT;AAGD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,CAevD"}

package/dist/binary.js

@@ -0,0 +1,60 @@
+import { base64Decode, base64Encode } from '@bufbuild/protobuf/wire';
+import { bytesToHex, bytesToUtf8, equalsBytes, hexToBytes, utf8ToBytes, } from 'ethereum-cryptography/utils';
+export function bin_fromBase64(base64String) {
+    return base64Decode(base64String);
+}
+export function bin_toBase64(uint8Array) {
+    return base64Encode(uint8Array);
+}
+export function bin_fromHexString(hexString) {
+    return hexToBytes(hexString);
+}
+export function bin_toHexString(uint8Array) {
+    return bytesToHex(uint8Array);
+}
+export function bin_fromString(str) {
+    return utf8ToBytes(str);
+}
+export function bin_toString(buf) {
+    return bytesToUtf8(buf);
+}
+export function shortenHexString(s) {
+    if (s.startsWith('0x')) {
+        return s.length > 12 ? s.slice(0, 6) + '..' + s.slice(-4) : s;
+    }
+    else {
+        return s.length > 10 ? s.slice(0, 4) + '..' + s.slice(-4) : s;
+    }
+}
+export function isHexString(value) {
+    if (value.length === 0 || (value.length & 1) !== 0) {
+        return false;
+    }
+    return /^(0x)?[0-9a-fA-F]+$/.test(value);
+}
+export function bin_equal(a, b) {
+    if ((a === undefined || a === null || a.length === 0) &&
+        (b === undefined || b === null || b.length === 0)) {
+        return true;
+    }
+    else if (a === undefined || a === null || b === undefined || b === null) {
+        return false;
+    }
+    return equalsBytes(a, b);
+}
+// Returns the absolute value of this BigInt as a big-endian byte array
+export function bigIntToBytes(value) {
+    const abs = value < 0n ? -value : value;
+    // Calculate the byte length needed to represent the BigInt
+    const byteLength = Math.ceil(abs.toString(16).length / 2);
+    // Create a buffer of the required length
+    const buffer = new Uint8Array(byteLength);
+    // Fill the buffer with the big-endian representation of the BigInt
+    let temp = abs;
+    for (let i = byteLength - 1; i >= 0; i--) {
+        buffer[i] = Number(temp & 0xffn); // Extract last 8 bits
+        temp >>= 8n; // Shift right by 8 bits
+    }
+    return buffer;
+}
+//# sourceMappingURL=binary.js.map

package/dist/binary.js.map

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

package/dist/check.d.ts

@@ -0,0 +1,16 @@
+import { Err } from '@towns-protocol/proto';
+export declare class CodeException extends Error {
+    code: number;
+    data?: any;
+    constructor(message: string, code: number, data?: any);
+}
+export declare function throwWithCode(message?: string, code?: Err, data?: any): never;
+/**
+ * If not value, throws JSON RPC error with numberic error code, which is transmitted to the client.
+ * @param value The value to check
+ * @param message Error message to use if value is not valid
+ * @param code JSON RPC error code to use if value is not valid
+ * @param data Optional data to include in the error
+ */
+export declare function check(value: boolean, message?: string, code?: Err, data?: any): asserts value;
+//# sourceMappingURL=check.d.ts.map

package/dist/check.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.d.ts","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAK3C,qBAAa,aAAc,SAAQ,KAAK;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,CAAC,EAAE,GAAG,CAAA;gBACE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG;CAKxD;AAED,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,KAAK,CAI7E;AAED;;;;;;GAMG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,KAAK,CAI7F"}

package/dist/check.js

@@ -0,0 +1,30 @@
+import { Err } from '@towns-protocol/proto';
+import { dlogError } from './dlog';
+const log = dlogError('csb:error');
+export class CodeException extends Error {
+    code;
+    data;
+    constructor(message, code, data) {
+        super(message);
+        this.code = code;
+        this.data = data;
+    }
+}
+export function throwWithCode(message, code, data) {
+    const e = new CodeException(message ?? 'Unknown', code ?? Err.ERR_UNSPECIFIED, data);
+    log('throwWithCode', e);
+    throw e;
+}
+/**
+ * If not value, throws JSON RPC error with numberic error code, which is transmitted to the client.
+ * @param value The value to check
+ * @param message Error message to use if value is not valid
+ * @param code JSON RPC error code to use if value is not valid
+ * @param data Optional data to include in the error
+ */
+export function check(value, message, code, data) {
+    if (!value) {
+        throwWithCode(message, code, data);
+    }
+}
+//# sourceMappingURL=check.js.map

package/dist/check.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"check.js","sourceRoot":"","sources":["../src/check.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,uBAAuB,CAAA;AAC3C,OAAO,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAA;AAElC,MAAM,GAAG,GAAG,SAAS,CAAC,WAAW,CAAC,CAAA;AAElC,MAAM,OAAO,aAAc,SAAQ,KAAK;IACpC,IAAI,CAAQ;IACZ,IAAI,CAAM;IACV,YAAY,OAAe,EAAE,IAAY,EAAE,IAAU;QACjD,KAAK,CAAC,OAAO,CAAC,CAAA;QACd,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IACpB,CAAC;CACJ;AAED,MAAM,UAAU,aAAa,CAAC,OAAgB,EAAE,IAAU,EAAE,IAAU;IAClE,MAAM,CAAC,GAAG,IAAI,aAAa,CAAC,OAAO,IAAI,SAAS,EAAE,IAAI,IAAI,GAAG,CAAC,eAAe,EAAE,IAAI,CAAC,CAAA;IACpF,GAAG,CAAC,eAAe,EAAE,CAAC,CAAC,CAAA;IACvB,MAAM,CAAC,CAAA;AACX,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,KAAK,CAAC,KAAc,EAAE,OAAgB,EAAE,IAAU,EAAE,IAAU;IAC1E,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,aAAa,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;IACtC,CAAC;AACL,CAAC"}

package/dist/dlog.d.ts

@@ -0,0 +1,72 @@
+import { Debugger } from 'debug';
+export declare const cloneAndFormat: (obj: unknown, opts?: {
+    shortenHex?: boolean;
+}) => unknown;
+export interface DLogger {
+    (...args: unknown[]): void;
+    enabled: boolean;
+    namespace: string;
+    extend: (namespace: string, delimiter?: string) => DLogger;
+    baseDebug: Debugger;
+    opts?: DLogOpts;
+}
+export interface DLogOpts {
+    defaultEnabled?: boolean;
+    allowJest?: boolean;
+    printStack?: boolean;
+    warn?: boolean;
+}
+/**
+ * Set a custom error logger that will be used instead of console.error for dlog error output.
+ * This allows external libraries to capture and buffer error logs for reporting.
+ *
+ * @param logger Custom logger function, or undefined to reset to console.error
+ */
+export declare const setDlogErrorLogger: (logger: ((...args: unknown[]) => void) | undefined) => void;
+/**
+ * Set a custom warning logger that will be used instead of console.warn for dlog warning output.
+ * This allows external libraries to capture and buffer warning logs for reporting.
+ *
+ * @param logger Custom logger function, or undefined to reset to console.warn
+ */
+export declare const setDlogWarnLogger: (logger: ((...args: unknown[]) => void) | undefined) => void;
+/**
+ * Create a new logger with namespace `ns`.
+ * It's based on the `debug` package logger with custom formatter:
+ * All aguments are formatted, hex strings and UInt8Arrays are printer as hex and shortened.
+ * No %-specifiers are supported.
+ *
+ * @param ns Namespace for the logger.
+ * @returns New logger with namespace `ns`.
+ */
+export declare const dlog: (ns: string, opts?: DLogOpts) => DLogger;
+/**
+ * Same as dlog, but logger is bound to console.error so clicking on it expands log site callstack (in addition to printed error callstack).
+ * Also, logger is enabled by default, except if running in jest.
+ *
+ * @param ns Namespace for the logger.
+ * @returns New logger with namespace `ns`.
+ */
+export declare const dlogError: (ns: string) => DLogger;
+/**
+ * Same as dlog, but logger is bound to console.warn so clicking on it expands log site callstack.
+ * Also, logger is enabled by default, except if running in jest.
+ *
+ * @param ns Namespace for the logger.
+ * @returns New logger with namespace `ns`.
+ */
+export declare const dlogWarn: (ns: string) => DLogger;
+export interface ExtendedLogger {
+    info: DLogger;
+    log: DLogger;
+    error: DLogger;
+    warn: DLogger;
+    extend: (namespace: string) => ExtendedLogger;
+}
+/**
+ * Create complex logger with multiple levels
+ * @param ns Namespace for the logger.
+ * @returns New logger with log/info/error namespace `ns`.
+ */
+export declare const dlogger: (ns: string) => ExtendedLogger;
+//# sourceMappingURL=dlog.d.ts.map

package/dist/dlog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlog.d.ts","sourceRoot":"","sources":["../src/dlog.ts"],"names":[],"mappings":"AACA,OAAc,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AAsDvC,eAAO,MAAM,cAAc,GAAI,KAAK,OAAO,EAAE,OAAO;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAE,KAAG,OAE9E,CAAA;AAqED,MAAM,WAAW,OAAO;IACpB,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAA;IAE1B,OAAO,EAAE,OAAO,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAA;IAC1D,SAAS,EAAE,QAAQ,CAAA;IACnB,IAAI,CAAC,EAAE,QAAQ,CAAA;CAClB;AAED,MAAM,WAAW,QAAQ;IAErB,cAAc,CAAC,EAAE,OAAO,CAAA;IAGxB,SAAS,CAAC,EAAE,OAAO,CAAA;IAGnB,UAAU,CAAC,EAAE,OAAO,CAAA;IAGpB,IAAI,CAAC,EAAE,OAAO,CAAA;CACjB;AAQD;;;;;GAKG;AACH,eAAO,MAAM,kBAAkB,GAAI,QAAQ,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,KAAG,IAEvF,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,CAAC,GAAG,SAAS,KAAG,IAEtF,CAAA;AAsFD;;;;;;;;GAQG;AACH,eAAO,MAAM,IAAI,GAAI,IAAI,MAAM,EAAE,OAAO,QAAQ,KAAG,OAElD,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,GAAI,IAAI,MAAM,KAAG,OAGtC,CAAA;AAED;;;;;;GAMG;AACH,eAAO,MAAM,QAAQ,GAAI,IAAI,MAAM,KAAG,OAErC,CAAA;AAED,MAAM,WAAW,cAAc;IAC3B,IAAI,EAAE,OAAO,CAAA;IACb,GAAG,EAAE,OAAO,CAAA;IACZ,KAAK,EAAE,OAAO,CAAA;IACd,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,cAAc,CAAA;CAChD;AAED;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,IAAI,MAAM,KAAG,cAUpC,CAAA"}

package/dist/dlog.js

@@ -0,0 +1,254 @@
+import { bin_toHexString, isHexString, shortenHexString } from './binary';
+import debug from 'debug';
+import { isTestEnv } from './utils';
+import { safeEnv } from './envUtils';
+// Works as debug.enabled, but falls back on options if not explicitly set in env instead of returning false.
+debug.enabled = (ns) => {
+    if (ns.length > 0 && ns[ns.length - 1] === '*') {
+        return true;
+    }
+    for (const s of debug.skips) {
+        if (s instanceof RegExp) {
+            // users are complining that s.test is not a function in some cases
+            if (s.test(ns)) {
+                return false;
+            }
+        }
+    }
+    for (const s of debug.names) {
+        if (s instanceof RegExp) {
+            if (s.test(ns)) {
+                // users are complining that s.test is not a function in some cases
+                return true;
+            }
+        }
+    }
+    const opts = allDlogs.get(ns)?.opts;
+    if (opts !== undefined) {
+        if (!opts.allowJest && isTestEnv()) {
+            return false;
+        }
+        else {
+            return opts.defaultEnabled ?? false;
+        }
+    }
+    return false;
+};
+// Set namespaces to empty string if not set so debug.enabled() is called and can retrieve defaultEnabled from options.
+// eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+if (debug.namespaces === undefined) {
+    // eslint-disable-next-line @typescript-eslint/no-unsafe-member-access
+    ;
+    debug.namespaces = '';
+}
+const MAX_CALL_STACK_SZ = 18;
+const hasOwnProperty = (obj, prop) => {
+    return Object.prototype.hasOwnProperty.call(obj, prop);
+};
+export const cloneAndFormat = (obj, opts) => {
+    return _cloneAndFormat(obj, 0, new WeakSet(), opts?.shortenHex === true);
+};
+const _cloneAndFormat = (obj, depth, seen, shorten) => {
+    if (depth > MAX_CALL_STACK_SZ) {
+        return 'MAX_CALL_STACK_SZ exceeded';
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        if (seen.has(obj)) {
+            return '[circular reference]';
+        }
+        seen.add(obj);
+    }
+    if (typeof obj === 'string') {
+        return isHexString(obj) && shorten ? shortenHexString(obj) : obj;
+    }
+    if (obj instanceof Uint8Array) {
+        return shorten ? shortenHexString(bin_toHexString(obj)) : bin_toHexString(obj);
+    }
+    if (obj instanceof BigInt || typeof obj === 'bigint') {
+        return obj.toString();
+    }
+    if (Array.isArray(obj)) {
+        return obj.map((e) => _cloneAndFormat(e, depth + 1, seen, shorten));
+    }
+    if (typeof obj === 'object' && obj !== null) {
+        if (obj instanceof Error) {
+            return obj.stack || obj.message;
+        }
+        if (typeof obj[Symbol.iterator] === 'function') {
+            // Iterate over values of Map, Set, etc.
+            const newObj = [];
+            for (const e of obj) {
+                newObj.push(_cloneAndFormat(e, depth + 1, seen, shorten));
+            }
+            return newObj;
+        }
+        const newObj = {};
+        for (const key in obj) {
+            if (hasOwnProperty(obj, key)) {
+                let newKey = key;
+                if (typeof key === 'string' && isHexString(key) && shorten) {
+                    newKey = shortenHexString(key);
+                }
+                if (key == 'emitter') {
+                    newObj[newKey] = '[emitter]';
+                }
+                else {
+                    newObj[newKey] = _cloneAndFormat(obj[key], depth + 1, seen, shorten);
+                }
+            }
+        }
+        return newObj;
+    }
+    return obj;
+};
+const allDlogs = new Map();
+// Configurable error logger - evaluated at runtime to avoid order of operations issues
+let customErrorLogger = undefined;
+let customWarnLogger = undefined;
+/**
+ * Set a custom error logger that will be used instead of console.error for dlog error output.
+ * This allows external libraries to capture and buffer error logs for reporting.
+ *
+ * @param logger Custom logger function, or undefined to reset to console.error
+ */
+export const setDlogErrorLogger = (logger) => {
+    customErrorLogger = logger;
+};
+/**
+ * Set a custom warning logger that will be used instead of console.warn for dlog warning output.
+ * This allows external libraries to capture and buffer warning logs for reporting.
+ *
+ * @param logger Custom logger function, or undefined to reset to console.warn
+ */
+export const setDlogWarnLogger = (logger) => {
+    customWarnLogger = logger;
+};
+// github#722
+const isSingleLineLogsMode = safeEnv(['SINGLE_LINE_LOGS']) === 'true';
+const makeDlog = (d, opts) => {
+    if (opts?.warn) {
+        d.log = (...args) => {
+            const warnLogger = customWarnLogger || console.warn;
+            warnLogger(...args);
+        };
+    }
+    if (opts?.printStack) {
+        // Use a dynamic logger that checks for custom error logger at runtime
+        d.log = (...args) => {
+            const errorLogger = customErrorLogger || console.error;
+            errorLogger(...args);
+        };
+    }
+    const dlog = (...args) => {
+        if (!d.enabled || args.length === 0) {
+            return;
+        }
+        const fmt = [];
+        const newArgs = [];
+        const tailArgs = [];
+        for (let i = 0; i < args.length; i++) {
+            let c = args[i];
+            if (typeof c === 'string') {
+                fmt.push('%s ');
+                if (isHexString(c)) {
+                    c = shortenHexString(c);
+                }
+                newArgs.push(c);
+            }
+            else if (typeof c === 'object' && c !== null) {
+                if (c instanceof Error) {
+                    if (isSingleLineLogsMode) {
+                        fmt.push('%o\n');
+                    }
+                    else {
+                        fmt.push('%O\n');
+                    }
+                    tailArgs.push(c);
+                }
+                else {
+                    if (isSingleLineLogsMode) {
+                        fmt.push('%o\n');
+                    }
+                    else {
+                        fmt.push('%O\n');
+                    }
+                    newArgs.push(cloneAndFormat(c, { shortenHex: true }));
+                }
+            }
+            else {
+                if (isSingleLineLogsMode) {
+                    fmt.push('%o ');
+                }
+                else {
+                    fmt.push('%O ');
+                }
+                newArgs.push(c);
+            }
+        }
+        d(fmt.join(''), ...newArgs, ...tailArgs);
+    };
+    dlog.baseDebug = d;
+    dlog.namespace = d.namespace;
+    dlog.opts = opts;
+    dlog.extend = (sub, delimiter) => {
+        return makeDlog(d.extend(sub, delimiter), opts);
+    };
+    Object.defineProperty(dlog, 'enabled', {
+        enumerable: true,
+        configurable: false,
+        get: () => d.enabled,
+        set: (v) => (d.enabled = v),
+    });
+    allDlogs.set(d.namespace, dlog);
+    return dlog;
+};
+/**
+ * Create a new logger with namespace `ns`.
+ * It's based on the `debug` package logger with custom formatter:
+ * All aguments are formatted, hex strings and UInt8Arrays are printer as hex and shortened.
+ * No %-specifiers are supported.
+ *
+ * @param ns Namespace for the logger.
+ * @returns New logger with namespace `ns`.
+ */
+export const dlog = (ns, opts) => {
+    return makeDlog(debug(ns), opts);
+};
+/**
+ * Same as dlog, but logger is bound to console.error so clicking on it expands log site callstack (in addition to printed error callstack).
+ * Also, logger is enabled by default, except if running in jest.
+ *
+ * @param ns Namespace for the logger.
+ * @returns New logger with namespace `ns`.
+ */
+export const dlogError = (ns) => {
+    const l = makeDlog(debug(ns), { defaultEnabled: true, printStack: true, allowJest: true });
+    return l;
+};
+/**
+ * Same as dlog, but logger is bound to console.warn so clicking on it expands log site callstack.
+ * Also, logger is enabled by default, except if running in jest.
+ *
+ * @param ns Namespace for the logger.
+ * @returns New logger with namespace `ns`.
+ */
+export const dlogWarn = (ns) => {
+    return makeDlog(debug(ns), { defaultEnabled: true, allowJest: true, warn: true });
+};
+/**
+ * Create complex logger with multiple levels
+ * @param ns Namespace for the logger.
+ * @returns New logger with log/info/error namespace `ns`.
+ */
+export const dlogger = (ns) => {
+    return {
+        log: makeDlog(debug(ns + ':log')),
+        info: makeDlog(debug(ns + ':info'), { defaultEnabled: true, allowJest: true }),
+        error: dlogError(ns + ':error'),
+        warn: dlogWarn(ns + ':warn'),
+        extend: (sub) => {
+            return dlogger(ns + ':' + sub);
+        },
+    };
+};
+//# sourceMappingURL=dlog.js.map

package/dist/dlog.js.map

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

package/dist/envUtils.d.ts

@@ -0,0 +1,6 @@
+export interface SafeEnvOpts {
+    env?: Record<string, string>;
+    keyPrefix?: string;
+}
+export declare function safeEnv(keys: string[], opts?: SafeEnvOpts): string | undefined;
+//# sourceMappingURL=envUtils.d.ts.map

package/dist/envUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"envUtils.d.ts","sourceRoot":"","sources":["../src/envUtils.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAExB,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAE5B,SAAS,CAAC,EAAE,MAAM,CAAA;CACrB;AAED,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,WAAW,GAAG,MAAM,GAAG,SAAS,CAkB9E"}

package/dist/envUtils.js

@@ -0,0 +1,20 @@
+export function safeEnv(keys, opts) {
+    for (const keyRef of keys) {
+        // check for key prefix
+        const key = opts?.keyPrefix ? `${opts.keyPrefix}${keyRef}` : keyRef;
+        // check for key in env
+        if (opts?.env) {
+            if (opts.env[key]) {
+                return opts.env[key];
+            }
+        }
+        // look for the key in process.env
+        if (typeof process === 'object' && 'env' in process) {
+            if (process.env[key]) {
+                return process.env[key];
+            }
+        }
+    }
+    return undefined;
+}
+//# sourceMappingURL=envUtils.js.map

package/dist/envUtils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"envUtils.js","sourceRoot":"","sources":["../src/envUtils.ts"],"names":[],"mappings":"AAOA,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,IAAkB;IACtD,KAAK,MAAM,MAAM,IAAI,IAAI,EAAE,CAAC;QACxB,uBAAuB;QACvB,MAAM,GAAG,GAAG,IAAI,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,GAAG,MAAM,EAAE,CAAC,CAAC,CAAC,MAAM,CAAA;QACnE,uBAAuB;QACvB,IAAI,IAAI,EAAE,GAAG,EAAE,CAAC;YACZ,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAChB,OAAO,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YACxB,CAAC;QACL,CAAC;QACD,kCAAkC;QAClC,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,KAAK,IAAI,OAAO,EAAE,CAAC;YAClD,IAAI,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAA;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,SAAS,CAAA;AACpB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+/**************************************************************************
+ * This file is generated by running 🏕️ scripts/generate_sdk_index.sh 🏕️ *
+ **************************************************************************/
+export * from './binary';
+export * from './check';
+export * from './dlog';
+export * from './envUtils';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;4EAE4E;AAC5E,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,9 @@
+/**************************************************************************
+ * This file is generated by running 🏕️ scripts/generate_sdk_index.sh 🏕️ *
+ **************************************************************************/
+export * from './binary';
+export * from './check';
+export * from './dlog';
+export * from './envUtils';
+export * from './utils';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;4EAE4E;AAC5E,cAAc,UAAU,CAAA;AACxB,cAAc,SAAS,CAAA;AACvB,cAAc,QAAQ,CAAA;AACtB,cAAc,YAAY,CAAA;AAC1B,cAAc,SAAS,CAAA"}

package/dist/tests/binary.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @group main
+ */
+export {};
+//# sourceMappingURL=binary.test.d.ts.map

package/dist/tests/binary.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"binary.test.d.ts","sourceRoot":"","sources":["../../src/tests/binary.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tests/binary.test.js

@@ -0,0 +1,48 @@
+/**
+ * @group main
+ */
+import { bin_fromBase64, bin_fromHexString, isHexString } from '../binary';
+describe.concurrent('types', () => {
+    it('bin_fromHexString', () => {
+        const expected = new Uint8Array([1, 35, 69, 103, 137, 171, 205, 239]);
+        expect(bin_fromHexString('0123456789abcdef')).toEqual(expected);
+        expect(bin_fromHexString('0123456789ABCDEF')).toEqual(expected);
+        expect(bin_fromHexString('0x0123456789abcdef')).toEqual(expected);
+        expect(bin_fromHexString('')).toEqual(new Uint8Array([]));
+        expect(bin_fromHexString('0x')).toEqual(new Uint8Array([]));
+        expect(bin_fromHexString('00')).toEqual(new Uint8Array([0]));
+        expect(bin_fromHexString('01')).toEqual(new Uint8Array([1]));
+        expect(bin_fromHexString('0a')).toEqual(new Uint8Array([10]));
+        expect(bin_fromHexString('0000')).toEqual(new Uint8Array([0, 0]));
+        expect(bin_fromHexString('0001')).toEqual(new Uint8Array([0, 1]));
+        expect(() => bin_fromHexString('0')).toThrow();
+        expect(() => bin_fromHexString('0x0')).toThrow();
+        expect(() => bin_fromHexString('001')).toThrow();
+        expect(() => bin_fromHexString('11223')).toThrow();
+    });
+    it('bin_fromBase64String', () => {
+        const expected = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8, 9]);
+        const expected2 = new Uint8Array([1, 2, 3, 4, 5, 6, 7, 8, 9, 1, 2, 3, 4, 5, 6, 7, 8, 9]);
+        expect(bin_fromBase64('AQIDBAUGBwgJ')).toEqual(expected);
+        expect(bin_fromBase64('AQIDBAUGBwgJAQIDBAUGBwgJ')).toEqual(expected2);
+        expect(bin_fromBase64('')).toEqual(new Uint8Array([]));
+        expect(bin_fromBase64('AA==')).toEqual(new Uint8Array([0]));
+    });
+    it('isHexString', () => {
+        expect(isHexString('0123456789abcdef')).toBeTruthy();
+        expect(isHexString('0123456789ABCDEF')).toBeTruthy();
+        expect(isHexString('0x0123456789abcdef')).toBeTruthy();
+        expect(isHexString('00')).toBeTruthy();
+        expect(isHexString('01')).toBeTruthy();
+        expect(isHexString('0a')).toBeTruthy();
+        expect(isHexString('0000')).toBeTruthy();
+        expect(isHexString('0001')).toBeTruthy();
+        expect(isHexString('')).toBeFalsy();
+        expect(isHexString('0x')).toBeFalsy();
+        expect(isHexString('0')).toBeFalsy();
+        expect(isHexString('0x0')).toBeFalsy();
+        expect(isHexString('001')).toBeFalsy();
+        expect(isHexString('11223')).toBeFalsy();
+    });
+});
+//# sourceMappingURL=binary.test.js.map

package/dist/tests/binary.test.js.map

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

package/dist/tests/dlog.test.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @group main
+ */
+export {};
+//# sourceMappingURL=dlog.test.d.ts.map

package/dist/tests/dlog.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlog.test.d.ts","sourceRoot":"","sources":["../../src/tests/dlog.test.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/tests/dlog.test.js

@@ -0,0 +1,193 @@
+/**
+ * @group main
+ */
+import { dlog, dlogError, dlogger, dlogWarn } from '../dlog';
+import debug from 'debug';
+import { bin_fromHexString } from '../binary';
+describe.concurrent('dlogTest', () => {
+    it('basic', () => {
+        const longHex = bin_fromHexString('0102030405060708090a0b0c0d0e0f101112131415161718191a');
+        const obj = {
+            a: 1,
+            b: 'b',
+            c: {
+                d: 2,
+                e: 'e',
+            },
+            d: [1, 2, 3],
+            q: new Uint8Array([1, 2, 3]),
+            longHex,
+            nested: {
+                a: 1,
+                more: {
+                    even_more: {
+                        more_yet: {
+                            z: 1000,
+                        },
+                    },
+                },
+            },
+        };
+        const log = dlog('test:dlog');
+        log(obj);
+        log('\n\n\n');
+        log('obj =', obj);
+        log('\n\n\n');
+        log('b', 'q', obj, obj, 'end');
+        log('\n\n\n');
+        log(obj, obj);
+        log('\n\n\n');
+        log('obj =', obj, 'obj =', obj);
+        log('\n\n\n');
+        log(longHex);
+        log('\n\n\n');
+        log('longHex =', longHex);
+        log('\n\n\n');
+        log('shortenedHexKey =', { '0x0102030405060708090a0b0c0d0e0f101112131415161718191a': true });
+        log('shortenedHexValue =', '0x0102030405060708090a0b0c0d0e0f101112131415161718191a');
+        log('shortenedHexValue =', {
+            key: '0x0102030405060708090a0b0c0d0e0f101112131415161718191a',
+        });
+    });
+    it('extend', () => {
+        const base_log = dlog('test:dlog');
+        const log = base_log.extend('extend');
+        log('extend');
+        log(22);
+        log('33 =', 33);
+        log('gonna print more', '44 =', 44);
+    });
+    it('enabled1', () => {
+        const log = dlog('test:dlog');
+        if (log.enabled) {
+            log('enabled', log.enabled);
+            log.enabled = false;
+            log('(should not print)', log.enabled);
+            log.enabled = true;
+            log('enabled', log.enabled);
+        }
+    });
+    it('circularReference', () => {
+        const log = dlog('test:dlog');
+        class A {
+            b;
+            constructor() {
+                this.b = new B(this);
+            }
+        }
+        class B {
+            a;
+            constructor(a) {
+                this.a = a;
+            }
+        }
+        const a = new A();
+        log('test circular:', { a });
+    });
+    it('numbers', () => {
+        const log = dlog('test:dlog');
+        log('test same number:', { a: 1, b: 1, c: 1, d: 2 });
+    });
+    it('error', () => {
+        const log = dlogError('test:dlog:error');
+        log('test same number:', { a: 1, b: 1, c: 1, d: 2 });
+        log(new Error('test error'));
+        function funcThatThrows() {
+            throw new Error('test error 2');
+        }
+        try {
+            funcThatThrows();
+        }
+        catch (e) {
+            log(e);
+        }
+        try {
+            funcThatThrows();
+        }
+        catch (e) {
+            log('test error 3', e, 123, 'more text');
+        }
+    });
+    it('set', () => {
+        const s = new Set([111, 222, { aaa: 333 }]);
+        dlog('test:dlog')(s);
+        const log = dlog('test:dlog');
+        log.enabled = true;
+        let output = '';
+        log.baseDebug.log = (...args) => {
+            for (const arg of args) {
+                output += `${arg}`;
+            }
+        };
+        log(s);
+        expect(output).toContain('111');
+        expect(output).toContain('222');
+        expect(output).toContain('333');
+        expect(output).toContain('aaa');
+    });
+    it('map', () => {
+        const s = new Map([
+            ['aaa', 111],
+            ['bbb', 222],
+            ['ccc', { a: 333 }],
+        ]);
+        dlog('test:dlog')(s);
+        const log = dlog('test:dlog');
+        log.enabled = true;
+        let output = '';
+        log.baseDebug.log = (...args) => {
+            for (const arg of args) {
+                output += `${arg}`;
+            }
+        };
+        log(s);
+        expect(output).toContain('111');
+        expect(output).toContain('aaa');
+        expect(output).toContain('222');
+        expect(output).toContain('bbb');
+        expect(output).toContain('333');
+        expect(output).toContain('ccc');
+    });
+    it('enabled2', () => {
+        const ns = 'uniqueLogName';
+        // Override
+        let log = dlog(ns);
+        expect(log.enabled).toBeFalsy();
+        log.enabled = true;
+        expect(log.enabled).toBeTruthy();
+        log.enabled = false;
+        expect(log.enabled).toBeFalsy();
+        // Default
+        log = dlog(ns, { defaultEnabled: true, allowJest: true });
+        expect(log.enabled).toBeTruthy();
+        log.enabled = false;
+        expect(log.enabled).toBeFalsy();
+        // Default under Jest
+        log = dlog(ns, { defaultEnabled: true });
+        expect(log.enabled).toBeFalsy();
+        log.enabled = true;
+        expect(log.enabled).toBeTruthy();
+        // Enabled explicitly by settings
+        debug.enable(ns);
+        log = dlog(ns);
+        expect(log.enabled).toBeTruthy();
+        // Disabled explicitly by settings
+        debug.enable('-' + ns);
+        expect(log.enabled).toBeFalsy();
+        // Disabled explicitly by settings, default ignored
+        log = dlog(ns, { defaultEnabled: true, allowJest: true });
+        expect(log.enabled).toBeFalsy();
+    });
+    it('tests warn', () => {
+        const log = dlogWarn('test:dlog:warn');
+        log('test warn');
+    });
+    it('tests logger with warn', () => {
+        const log = dlogger('test:dlogger');
+        log.log('test log');
+        log.info('test info');
+        log.warn('test warn');
+        log.error('test error');
+    });
+});
+//# sourceMappingURL=dlog.test.js.map

package/dist/tests/dlog.test.js.map

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

package/dist/utils.d.ts

@@ -0,0 +1,4 @@
+export declare const isBrowser: boolean;
+export declare const isNodeEnv: boolean;
+export declare function isTestEnv(): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,SAAS,SAA0E,CAAA;AAEhG,eAAO,MAAM,SAAS,SACyE,CAAA;AAE/F,wBAAgB,SAAS,IAAI,OAAO,CAQnC"}

package/dist/utils.js

@@ -0,0 +1,10 @@
+export const isBrowser = typeof window !== 'undefined' && typeof window.document !== 'undefined';
+export const isNodeEnv = typeof process !== 'undefined' && process.versions != null && process.versions.node != null;
+export function isTestEnv() {
+    return (isNodeEnv &&
+        (process.env.NODE_ENV === 'test' ||
+            process.env.VITEST === 'true' ||
+            process.env.JEST_WORKER_ID !== undefined ||
+            process.env.TS_JEST === '1'));
+}
+//# sourceMappingURL=utils.js.map

package/dist/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../src/utils.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,SAAS,GAAG,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,MAAM,CAAC,QAAQ,KAAK,WAAW,CAAA;AAEhG,MAAM,CAAC,MAAM,SAAS,GAClB,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,QAAQ,IAAI,IAAI,IAAI,OAAO,CAAC,QAAQ,CAAC,IAAI,IAAI,IAAI,CAAA;AAE/F,MAAM,UAAU,SAAS;IACrB,OAAO,CACH,SAAS;QACT,CAAC,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;YAC5B,OAAO,CAAC,GAAG,CAAC,MAAM,KAAK,MAAM;YAC7B,OAAO,CAAC,GAAG,CAAC,cAAc,KAAK,SAAS;YACxC,OAAO,CAAC,GAAG,CAAC,OAAO,KAAK,GAAG,CAAC,CACnC,CAAA;AACL,CAAC"}

package/package.json

@@ -0,0 +1,44 @@
+{
+    "name": "@towns-protocol/utils",
+    "version": "0.0.349",
+    "packageManager": "yarn@3.8.0",
+    "type": "module",
+    "main": "dist/index.js",
+    "types": "dist/index.d.ts",
+    "scripts": {
+        "build": "tsc",
+        "cb": "yarn clean && yarn build",
+        "clean": "rm -rf dist",
+        "lint": "yarn eslint --format unix ./src",
+        "lint:fix": "yarn lint --fix",
+        "test": "vitest run",
+        "test:ci": "yarn test",
+        "test:debug": "DEBUG=test yarn test",
+        "test:watch": "vitest --watch",
+        "watch": "tsc --watch"
+    },
+    "dependencies": {
+        "@bufbuild/protobuf": "^2.2.2",
+        "@towns-protocol/proto": "^0.0.349",
+        "debug": "^4.3.4",
+        "ethereum-cryptography": "^3.2.0"
+    },
+    "devDependencies": {
+        "@types/debug": "^4.1.8",
+        "@typescript-eslint/eslint-plugin": "^8.29.0",
+        "@typescript-eslint/parser": "^8.29.0",
+        "eslint": "^8.57.1",
+        "eslint-import-resolver-typescript": "^4.3.2",
+        "eslint-plugin-import-x": "^4.10.2",
+        "ts-node": "^10.9.1",
+        "typescript": "^5.8.2",
+        "vitest": "^3.2.3"
+    },
+    "files": [
+        "/dist"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "gitHead": "203975e546c212816a5086c7c97a17c3f45b139f"
+}