@mikeatlast/ponder 0.16.1-fork.1

package/dist/esm/ui/patch.js

@@ -0,0 +1,140 @@
+import util from "node:util";
+import ansi from "ansi-escapes";
+import terminalSize from "terminal-size";
+export function patchWriteStreams({ getLines }) {
+    const isBun = "bun" in process.versions;
+    const originalStdoutWrite = process.stdout.write;
+    const originalStderrWrite = process.stderr.write;
+    let isWriting = false;
+    let previousLineCount = 0;
+    let terminalWidth = terminalSize().columns;
+    const calculateLineCount = (lines) => {
+        let count = 0;
+        // For each line, calculate how many terminal lines it will occupy
+        for (const line of lines) {
+            // Apply wrapping logic to get actual number of lines
+            const visibleLength = line.replaceAll(ansiEscapeRegex, "").length;
+            count += Math.max(1, Math.ceil(visibleLength / terminalWidth));
+        }
+        return count;
+    };
+    // Clear previous UI and render new UI
+    const clearAndWriteLines = (lines) => {
+        if (isWriting && !lines)
+            return;
+        const wasAlreadyWriting = isWriting;
+        if (!wasAlreadyWriting)
+            isWriting = true;
+        try {
+            const text = [...lines, ""].join("\n"); // Include trailing newline
+            // Calculate line count after constructing the text to ensure accuracy
+            const newLineCount = calculateLineCount(lines);
+            // Move cursor up to the start of the previous UI
+            if (previousLineCount > 0) {
+                originalStdoutWrite.call(process.stdout, ansi.cursorUp(previousLineCount));
+            }
+            // Clear all lines of the previous UI and below
+            originalStdoutWrite.call(process.stdout, ansi.eraseDown);
+            // Write the new UI
+            originalStdoutWrite.call(process.stdout, text);
+            previousLineCount = newLineCount;
+        }
+        finally {
+            if (!wasAlreadyWriting)
+                isWriting = false;
+        }
+    };
+    // Monkey patch stdout and stderr to handle out-of-band output
+    const handleOutput = function (buffer, encoding, cb) {
+        const originalWrite = this === process.stderr ? originalStderrWrite : originalStdoutWrite;
+        // If we're already writing, use the original to avoid recursion
+        if (isWriting) {
+            return originalWrite.apply(this, [buffer, encoding, cb]);
+        }
+        // Clear the UI
+        if (previousLineCount > 0) {
+            originalStdoutWrite.call(process.stdout, ansi.cursorUp(previousLineCount) + ansi.eraseDown);
+            previousLineCount = 0;
+        }
+        // Write the new content
+        const result = originalWrite.apply(this, [buffer, encoding, cb]);
+        // Clear and write the latest UI below the new content
+        const lines = getLines();
+        clearAndWriteLines(lines);
+        return result;
+    };
+    process.stdout.write = handleOutput;
+    process.stderr.write = handleOutput;
+    // On terminal resize, reset terminal width and force a re-render
+    const resizeListener = () => {
+        terminalWidth = terminalSize().columns;
+        // Clear the UI
+        if (previousLineCount > 0) {
+            originalStdoutWrite.call(process.stdout, ansi.cursorUp(previousLineCount) + ansi.eraseDown);
+            previousLineCount = 0;
+        }
+        // Clear and write the latest UI
+        const lines = getLines();
+        clearAndWriteLines(lines);
+    };
+    process.stdout.on("resize", resizeListener);
+    let shutdown;
+    if (isBun) {
+        // bun has a custom impl of console.* methods that do not use process.stdout/process.stderr
+        // so need to patch them as well
+        const originalConsoleLog = console.log;
+        const originalConsoleInfo = console.info;
+        const originalConsoleWarn = console.warn;
+        const originalConsoleError = console.error;
+        const makeConsoleWriter = (stream, _) => (...args) => {
+            // biome-ignore lint/style/useTemplate:
+            const formatted = util.format(...args) + "\n";
+            // handleOutput so TUI is cleared + re-rendered
+            handleOutput.call(stream, formatted, "utf8", undefined);
+        };
+        console.log = makeConsoleWriter(process.stdout, originalStdoutWrite);
+        console.info = makeConsoleWriter(process.stdout, originalStdoutWrite);
+        console.warn = makeConsoleWriter(process.stderr, originalStderrWrite);
+        console.error = makeConsoleWriter(process.stderr, originalStderrWrite);
+        shutdown = () => {
+            // Restore original write methods
+            process.stdout.write = originalStdoutWrite;
+            process.stderr.write = originalStderrWrite;
+            console.log = originalConsoleLog;
+            console.info = originalConsoleInfo;
+            console.warn = originalConsoleWarn;
+            console.error = originalConsoleError;
+            // Clear the UI
+            if (previousLineCount > 0) {
+                originalStdoutWrite.call(process.stdout, ansi.cursorUp(previousLineCount) + ansi.eraseDown);
+            }
+            process.stdout.removeListener("resize", resizeListener);
+        };
+    }
+    else {
+        shutdown = () => {
+            // Restore original write methods
+            process.stdout.write = originalStdoutWrite;
+            process.stderr.write = originalStderrWrite;
+            // Clear the UI
+            if (previousLineCount > 0) {
+                originalStdoutWrite.call(process.stdout, ansi.cursorUp(previousLineCount) + ansi.eraseDown);
+            }
+            // Remove resize listener
+            process.stdout.removeListener("resize", resizeListener);
+        };
+    }
+    return {
+        refresh: () => {
+            const lines = getLines();
+            clearAndWriteLines(lines);
+        },
+        shutdown,
+    };
+}
+// Regex to strip ANSI escape sequences from a string
+const ansiEscapeRegex = new RegExp([
+    "[\\u001B\\u009B][[\\]()#;?]*(?:(?:(?:(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]+)*|[a-zA-Z\\d]+(?:;[-a-zA-Z\\d\\/#&.:=?%@~_]*)*)?\\u0007)",
+    "(?:(?:\\d{1,4}(?:;\\d{0,4})*)?[\\dA-PR-TZcf-ntqry=><~]))",
+].join("|"), "g");
+//# sourceMappingURL=patch.js.map

package/dist/esm/ui/patch.js.map

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

package/dist/esm/utils/abi.js

@@ -0,0 +1,55 @@
+import { getDuplicateElements } from './duplicates.js';
+import { formatAbiItem, } from "abitype";
+import { encodeEventTopics, getAbiItem, parseAbiItem, } from "viem";
+export const toSafeName = ({ abi, item, }) => {
+    if (item.type === "event") {
+        const abiEvents = abi
+            .filter((item) => item.type === "event")
+            .filter((item) => item.anonymous === undefined || item.anonymous === false);
+        const overloadedEventNames = getDuplicateElements(abiEvents.map((item) => item.name));
+        if (overloadedEventNames.has(item.name)) {
+            return formatAbiItem(item).split("event ")[1];
+        }
+        return item.name;
+    }
+    else {
+        const abiFunctions = abi.filter((item) => item.type === "function");
+        const overloadedFunctionNames = getDuplicateElements(abiFunctions.map((item) => item.name));
+        if (overloadedFunctionNames.has(item.name)) {
+            return formatAbiItem(item).split("function ")[1];
+        }
+        return `${item.name}()`;
+    }
+};
+export function buildTopics(abi, filter) {
+    const filters = Array.isArray(filter) ? filter : [filter];
+    const topics = filters.map((filter) => {
+        // Single event with args
+        const topics = encodeEventTopics({
+            abi: [findAbiEvent(abi, filter.event)],
+            args: filter.args,
+        });
+        return {
+            topic0: topics[0],
+            topic1: topics[1] ?? null,
+            topic2: topics[2] ?? null,
+            topic3: topics[3] ?? null,
+        };
+    });
+    return topics;
+}
+/**
+ * Finds the event ABI item for the event name or event signature.
+ *
+ * @param eventName Event name or event signature if there are duplicates
+ */
+const findAbiEvent = (abi, eventName) => {
+    if (eventName.includes("(")) {
+        // full event signature
+        return parseAbiItem(`event ${eventName}`);
+    }
+    else {
+        return getAbiItem({ abi, name: eventName });
+    }
+};
+//# sourceMappingURL=abi.js.map

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

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

package/dist/esm/utils/bigint.js

@@ -0,0 +1,37 @@
+/**
+ * Returns the minimum BigInt value from an array of BigInts.
+ *
+ * @param {bigint[]} values - An array of BigInt values.
+ * @returns {bigint} The minimum BigInt value from the array.
+ */
+export function bigIntMin(values) {
+    if (values.length === 0) {
+        throw new Error("Input array must not be empty.");
+    }
+    let minVal = values[0];
+    for (let i = 1; i < values.length; i++) {
+        if (values[i] < minVal) {
+            minVal = values[i];
+        }
+    }
+    return minVal;
+}
+/**
+ * Returns the maximum BigInt value from an array of BigInts.
+ *
+ * @param {bigint[]} values - An array of BigInt values.
+ * @returns {bigint} The maximum BigInt value from the array.
+ */
+export function bigIntMax(values) {
+    if (values.length === 0) {
+        throw new Error("Input array must not be empty.");
+    }
+    let maxVal = values[0];
+    for (let i = 1; i < values.length; i++) {
+        if (values[i] > maxVal) {
+            maxVal = values[i];
+        }
+    }
+    return maxVal;
+}
+//# sourceMappingURL=bigint.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"bigint.js","sourceRoot":"","sources":["../../../src/utils/bigint.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;QACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;KACnD;IAED,IAAI,MAAM,GAAW,MAAM,CAAC,CAAC,CAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACtC,IAAI,MAAM,CAAC,CAAC,CAAE,GAAG,MAAM,EAAE;YACvB,MAAM,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;SACrB;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,MAAgB;IACxC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE;QACvB,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;KACnD;IAED,IAAI,MAAM,GAAW,MAAM,CAAC,CAAC,CAAE,CAAC;IAChC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE;QACtC,IAAI,MAAM,CAAC,CAAC,CAAE,GAAG,MAAM,EAAE;YACvB,MAAM,GAAG,MAAM,CAAC,CAAC,CAAE,CAAC;SACrB;KACF;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/esm/utils/chains.js

@@ -0,0 +1,21 @@
+import * as _chains from "viem/chains";
+import { defineChain } from "viem/utils";
+export const chains = _chains;
+// Note: wanchain testnet uses the same id as hyperliquid evm
+export const hyperliquidEvm = defineChain({
+    id: 999,
+    name: "Hyperliquid EVM",
+    nativeCurrency: { name: "HYPE", symbol: "HYPE", decimals: 18 },
+    rpcUrls: {
+        default: {
+            http: ["https://rpc.hyperliquid.xyz/evm"],
+        },
+    },
+    contracts: {
+        multicall3: {
+            address: "0xca11bde05977b3631167028862be2a173976ca11",
+            blockCreated: 13051,
+        },
+    },
+});
+//# sourceMappingURL=chains.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chains.js","sourceRoot":"","sources":["../../../src/utils/chains.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,OAAO,MAAM,aAAa,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAEzC,MAAM,CAAC,MAAM,MAAM,GAAG,OAAmD,CAAC;AAE1E,6DAA6D;AAC7D,MAAM,CAAC,MAAM,cAAc,GAAG,WAAW,CAAC;IACxC,EAAE,EAAE,GAAG;IACP,IAAI,EAAE,iBAAiB;IACvB,cAAc,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;IAC9D,OAAO,EAAE;QACP,OAAO,EAAE;YACP,IAAI,EAAE,CAAC,iCAAiC,CAAC;SAC1C;KACF;IACD,SAAS,EAAE;QACT,UAAU,EAAE;YACV,OAAO,EAAE,4CAA4C;YACrD,YAAY,EAAE,KAAK;SACpB;KACF;CACF,CAAC,CAAC"}

package/dist/esm/utils/checkpoint.js

@@ -0,0 +1,139 @@
+import { hexToBigInt } from "viem";
+// 10 digits for unix timestamp gets us to the year 2277.
+const BLOCK_TIMESTAMP_DIGITS = 10;
+// Chain IDs are uint256. As of writing the largest Chain ID on https://chainlist.org
+// is 13 digits. 16 digits should be enough (JavaScript's max safe integer).
+const CHAIN_ID_DIGITS = 16;
+// Same logic as chain ID.
+const BLOCK_NUMBER_DIGITS = 16;
+// Same logic as chain ID.
+const TRANSACTION_INDEX_DIGITS = 16;
+// At time of writing, we only have 2 event types planned, so one digit (10 types) is enough.
+const EVENT_TYPE_DIGITS = 1;
+// This could contain log index, trace index, etc. 16 digits should be enough.
+const EVENT_INDEX_DIGITS = 16;
+const CHECKPOINT_LENGTH = BLOCK_TIMESTAMP_DIGITS +
+    CHAIN_ID_DIGITS +
+    BLOCK_NUMBER_DIGITS +
+    TRANSACTION_INDEX_DIGITS +
+    EVENT_TYPE_DIGITS +
+    EVENT_INDEX_DIGITS;
+export const EVENT_TYPES = {
+    transactions: 2,
+    blocks: 5,
+    logs: 5,
+    traces: 7,
+};
+const encodedChainIds = new Map();
+export const encodeCheckpoint = (checkpoint) => {
+    const { blockTimestamp, chainId, blockNumber, transactionIndex, eventType, eventIndex, } = checkpoint;
+    if (eventType < 0 || eventType > 9) {
+        throw new Error(`Got invalid event type ${eventType}, expected a number from 0 to 9`);
+    }
+    let encodedChainId = encodedChainIds.get(chainId);
+    if (encodedChainId === undefined) {
+        encodedChainId = chainId.toString().padStart(CHAIN_ID_DIGITS, "0");
+        encodedChainIds.set(chainId, encodedChainId);
+    }
+    const result = `${blockTimestamp.toString().padStart(BLOCK_TIMESTAMP_DIGITS, "0")}${encodedChainId}${blockNumber.toString().padStart(BLOCK_NUMBER_DIGITS, "0")}${transactionIndex.toString().padStart(TRANSACTION_INDEX_DIGITS, "0")}${eventType.toString()}${eventIndex.toString().padStart(EVENT_INDEX_DIGITS, "0")}`;
+    if (result.length !== CHECKPOINT_LENGTH) {
+        throw new Error(`Invalid stringified checkpoint: ${result}`);
+    }
+    return result;
+};
+export const decodeCheckpoint = (checkpoint) => {
+    let offset = 0;
+    const blockTimestamp = BigInt(checkpoint.slice(offset, offset + BLOCK_TIMESTAMP_DIGITS));
+    offset += BLOCK_TIMESTAMP_DIGITS;
+    const chainId = BigInt(checkpoint.slice(offset, offset + CHAIN_ID_DIGITS));
+    offset += CHAIN_ID_DIGITS;
+    const blockNumber = BigInt(checkpoint.slice(offset, offset + BLOCK_NUMBER_DIGITS));
+    offset += BLOCK_NUMBER_DIGITS;
+    const transactionIndex = BigInt(checkpoint.slice(offset, offset + TRANSACTION_INDEX_DIGITS));
+    offset += TRANSACTION_INDEX_DIGITS;
+    const eventType = +checkpoint.slice(offset, offset + EVENT_TYPE_DIGITS);
+    offset += EVENT_TYPE_DIGITS;
+    const eventIndex = BigInt(checkpoint.slice(offset, offset + EVENT_INDEX_DIGITS));
+    offset += EVENT_INDEX_DIGITS;
+    return {
+        blockTimestamp,
+        chainId,
+        blockNumber,
+        transactionIndex,
+        eventType,
+        eventIndex,
+    };
+};
+export const ZERO_CHECKPOINT = {
+    blockTimestamp: 0n,
+    chainId: 0n,
+    blockNumber: 0n,
+    transactionIndex: 0n,
+    eventType: 0,
+    eventIndex: 0n,
+};
+export const MAX_CHECKPOINT = {
+    blockTimestamp: 9999999999n,
+    chainId: 9999999999999999n,
+    blockNumber: 9999999999999999n,
+    transactionIndex: 9999999999999999n,
+    eventType: 9,
+    eventIndex: 9999999999999999n,
+};
+export const ZERO_CHECKPOINT_STRING = encodeCheckpoint(ZERO_CHECKPOINT);
+export const MAX_CHECKPOINT_STRING = encodeCheckpoint(MAX_CHECKPOINT);
+/**
+/**
+ * Returns true if two checkpoints are equal.
+ */
+export const isCheckpointEqual = (a, b) => encodeCheckpoint(a) === encodeCheckpoint(b);
+/**
+ * Returns true if checkpoint a is greater than checkpoint b.
+ * Returns false if the checkpoints are equal.
+ */
+export const isCheckpointGreaterThan = (a, b) => encodeCheckpoint(a) > encodeCheckpoint(b);
+/**
+ * Returns true if checkpoint a is greater than or equal to checkpoint b.|
+ */
+export const isCheckpointGreaterThanOrEqualTo = (a, b) => encodeCheckpoint(a) >= encodeCheckpoint(b);
+export const checkpointMax = (...checkpoints) => checkpoints.reduce((max, checkpoint) => {
+    return isCheckpointGreaterThan(checkpoint, max) ? checkpoint : max;
+});
+export const checkpointMin = (...checkpoints) => checkpoints.reduce((min, checkpoint) => {
+    return isCheckpointGreaterThan(min, checkpoint) ? checkpoint : min;
+});
+export const LATEST = MAX_CHECKPOINT_STRING;
+/** Compute the minimum checkpoint, filtering out undefined. */
+export const min = (...checkpoints) => {
+    return checkpoints.reduce((acc, cur) => {
+        if (cur === undefined)
+            return acc;
+        if (acc === undefined)
+            return cur;
+        if (acc < cur)
+            return acc;
+        return cur;
+    });
+};
+/** Compute the maximum checkpoint, filtering out undefined. */
+export const max = (...checkpoints) => {
+    return checkpoints.reduce((acc, cur) => {
+        if (cur === undefined)
+            return acc;
+        if (acc === undefined)
+            return cur;
+        if (acc > cur)
+            return acc;
+        return cur;
+    });
+};
+/** Convert `block` to a `Checkpoint`. */
+export const blockToCheckpoint = (block, chainId, rounding) => {
+    return {
+        ...(rounding === "up" ? MAX_CHECKPOINT : ZERO_CHECKPOINT),
+        blockTimestamp: hexToBigInt(block.timestamp),
+        chainId: BigInt(chainId),
+        blockNumber: hexToBigInt(block.number),
+    };
+};
+//# sourceMappingURL=checkpoint.js.map

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

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

package/dist/esm/utils/chunk.js

@@ -0,0 +1,8 @@
+export const chunk = (array, size) => {
+    const chunks = [];
+    for (let i = 0; i < array.length; i += size) {
+        chunks.push(array.slice(i, i + size));
+    }
+    return chunks;
+};
+//# sourceMappingURL=chunk.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"chunk.js","sourceRoot":"","sources":["../../../src/utils/chunk.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,KAAK,GAAG,CAAI,KAAU,EAAE,IAAY,EAAS,EAAE;IAC1D,MAAM,MAAM,GAAG,EAAE,CAAC;IAClB,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,IAAI,IAAI,EAAE;QAC3C,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;KACvC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/esm/utils/copy.js

@@ -0,0 +1,129 @@
+import util from "node:util";
+/**
+ * Symbol used to mark objects that are copied on write.
+ */
+export const COPY_ON_WRITE = Symbol.for("ponder:copyOnWrite");
+/**
+ * Create a copy-on-write proxy for an object.
+ */
+export const copyOnWrite = (obj) => {
+    let copiedObject;
+    // @ts-ignore
+    obj[util.inspect.custom] = () => {
+        return copiedObject ?? obj;
+    };
+    return new Proxy(obj, {
+        get(target, prop, receiver) {
+            if (prop === COPY_ON_WRITE) {
+                return target;
+            }
+            let result = Reflect.get(copiedObject ?? target, prop, receiver);
+            if (typeof result === "object" &&
+                result !== null &&
+                copiedObject === undefined) {
+                copiedObject = structuredClone(target);
+                result = Reflect.get(copiedObject, prop, receiver);
+            }
+            return result;
+        },
+        set(target, prop, newValue, receiver) {
+            if (copiedObject === undefined) {
+                copiedObject = structuredClone(target);
+            }
+            return Reflect.set(copiedObject, prop, newValue, receiver);
+        },
+        deleteProperty(target, prop) {
+            if (copiedObject === undefined) {
+                copiedObject = structuredClone(target);
+            }
+            return Reflect.deleteProperty(copiedObject, prop);
+        },
+        defineProperty(target, prop, descriptor) {
+            if (copiedObject === undefined) {
+                copiedObject = structuredClone(target);
+            }
+            return Reflect.defineProperty(copiedObject, prop, descriptor);
+        },
+        ownKeys(target) {
+            return Reflect.ownKeys(copiedObject ?? target);
+        },
+        has(target, prop) {
+            return Reflect.has(copiedObject ?? target, prop);
+        },
+        getOwnPropertyDescriptor(target, prop) {
+            return Reflect.getOwnPropertyDescriptor(copiedObject ?? target, prop);
+        },
+    });
+};
+/**
+ * Create a deep copy of an object.
+ *
+ * @dev This function supports copying objects that
+ * have been created with `copyOnWrite`.
+ */
+export const copy = (obj) => {
+    if (obj === null || typeof obj !== "object") {
+        return obj;
+    }
+    const hasProxy = (obj) => {
+        if (obj === null || typeof obj !== "object") {
+            return false;
+        }
+        if (obj[COPY_ON_WRITE] !== undefined) {
+            return true;
+        }
+        if (Array.isArray(obj)) {
+            return obj.some((element) => hasProxy(element));
+        }
+        for (const value of Object.values(obj)) {
+            if (hasProxy(value)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    const isDeeplyNested = (obj, depth = 0) => {
+        if (obj === null || typeof obj !== "object") {
+            return false;
+        }
+        if (depth > 0) {
+            return true;
+        }
+        if (Array.isArray(obj)) {
+            return obj.some((element) => isDeeplyNested(element, depth + 1));
+        }
+        for (const value of Object.values(obj)) {
+            if (isDeeplyNested(value, depth + 1)) {
+                return true;
+            }
+        }
+        return false;
+    };
+    // @ts-expect-error
+    const proxy = obj[COPY_ON_WRITE];
+    if (proxy === undefined) {
+        if (Array.isArray(obj)) {
+            if (hasProxy(obj)) {
+                // @ts-expect-error
+                return obj.map((element) => copy(element));
+            }
+            if (isDeeplyNested(obj))
+                return structuredClone(obj);
+            return [...obj];
+        }
+        if (hasProxy(obj)) {
+            const result = {};
+            for (const [key, value] of Object.entries(obj)) {
+                // @ts-expect-error
+                result[key] = copy(value);
+            }
+            return result;
+        }
+        // Note: spread operator is significantly faster than `structuredClone`
+        if (isDeeplyNested(obj))
+            return structuredClone(obj);
+        return { ...obj };
+    }
+    return proxy;
+};
+//# sourceMappingURL=copy.js.map

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

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

package/dist/esm/utils/date.js

@@ -0,0 +1,27 @@
+/** Formats a unix timestamp into a short date format (e.g. "Jan 1, 2021")
+ *
+ * @param unixTimestamp Unix timestamp to format
+ * @returns Formatted date string
+ */
+export function formatShortDate(unixTimestamp) {
+    const date = new Date(unixTimestamp * 1000);
+    const year = date.getFullYear();
+    const months = [
+        "Jan",
+        "Feb",
+        "Mar",
+        "Apr",
+        "May",
+        "Jun",
+        "Jul",
+        "Aug",
+        "Sep",
+        "Oct",
+        "Nov",
+        "Dec",
+    ];
+    const month = months[date.getMonth()];
+    const day = date.getDate();
+    return `${month} ${day}, ${year}`;
+}
+//# 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,UAAU,eAAe,CAAC,aAAqB;IACnD,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;IAChC,MAAM,MAAM,GAAG;QACb,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;QACL,KAAK;KACN,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IACtC,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;IAC3B,OAAO,GAAG,KAAK,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;AACpC,CAAC"}

package/dist/esm/utils/debug.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=debug.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../../../src/utils/debug.ts"],"names":[],"mappings":""}