wowdump 0.2.1 → 0.3.2

package/dist/broker-codec.js

@@ -1,148 +0,0 @@
-import { createHash, randomUUID } from "node:crypto";
-import { BrokerProtocolError, BROKER_MAX_INLINE_BYTES } from "./broker-protocol.js";
-export const BROKER_BINARY_CODEC = "wow.broker.binary.v1";
-export const BROKER_HANDLE_CODEC = "wow.broker.handle.v1";
-export class BrokerWireCodec {
-    ttlMs;
-    now;
-    handles = new Map();
-    constructor(ttlMs = 300_000, now = () => Date.now()) {
-        this.ttlMs = ttlMs;
-        this.now = now;
-    }
-    encode(value, scope) {
-        this.prune();
-        const created = [];
-        const visiting = new WeakSet();
-        const walk = (input) => {
-            if (input === null || typeof input === "string" || typeof input === "boolean")
-                return input;
-            if (typeof input === "number") {
-                if (!Number.isFinite(input))
-                    throw new BrokerProtocolError("FRAME_INVALID", "non-finite numbers cannot cross Broker IPC");
-                return input;
-            }
-            if (typeof input === "bigint")
-                return input.toString();
-            if (Buffer.isBuffer(input) || input instanceof Uint8Array || input instanceof ArrayBuffer) {
-                const bytes = Buffer.isBuffer(input) ? input : input instanceof ArrayBuffer ? Buffer.from(input) : Buffer.from(input.buffer, input.byteOffset, input.byteLength);
-                if (bytes.length > BROKER_MAX_INLINE_BYTES)
-                    return this.createHandle(input, "binary", scope, created);
-                return { schema: BROKER_BINARY_CODEC, encoding: "base64", bytes: bytes.length, sha256: createHash("sha256").update(bytes).digest("hex"), data: bytes.toString("base64") };
-            }
-            if (typeof input === "undefined")
-                return null;
-            if (typeof input === "function")
-                return this.createHandle(input, "function", scope, created);
-            if (typeof input === "symbol")
-                throw new BrokerProtocolError("FRAME_INVALID", "symbols cannot cross Broker IPC");
-            if (Array.isArray(input)) {
-                if (visiting.has(input))
-                    return this.createHandle(input, "cyclic-array", scope, created);
-                visiting.add(input);
-                const result = input.map(walk);
-                visiting.delete(input);
-                return result;
-            }
-            if (typeof input === "object") {
-                if (visiting.has(input))
-                    return this.createHandle(input, "cyclic-object", scope, created);
-                const prototype = Object.getPrototypeOf(input);
-                if (prototype !== Object.prototype && prototype !== null)
-                    return this.createHandle(input, prototype?.constructor?.name ?? "host-object", scope, created);
-                visiting.add(input);
-                const output = {};
-                for (const [key, child] of Object.entries(input))
-                    output[key] = walk(child);
-                visiting.delete(input);
-                return output;
-            }
-            throw new BrokerProtocolError("FRAME_INVALID", "unsupported Broker IPC value");
-        };
-        return { value: walk(value), handles: created };
-    }
-    decode(value, scope, operation) {
-        this.prune();
-        const walk = (input) => {
-            if (Array.isArray(input))
-                return input.map(walk);
-            if (!input || typeof input !== "object")
-                return input;
-            const record = input;
-            if (record.schema === BROKER_BINARY_CODEC) {
-                const bytes = Buffer.from(String(record.data ?? ""), "base64");
-                if (bytes.length !== record.bytes || createHash("sha256").update(bytes).digest("hex") !== record.sha256)
-                    throw new BrokerProtocolError("FRAME_INVALID", "binary codec digest mismatch");
-                return bytes;
-            }
-            if (record.schema === BROKER_HANDLE_CODEC) {
-                if (!["host_call", "script_call", "script_unload", "detach"].includes(operation))
-                    throw new BrokerProtocolError("RESOURCE_NOT_OWNER", `opaque handles are not allowed for ${operation}`);
-                const handle = this.lookup(String(record.handleId ?? ""));
-                this.assertScope(handle, scope);
-                return handle.value;
-            }
-            return Object.fromEntries(Object.entries(record).map(([key, child]) => [key, walk(child)]));
-        };
-        return walk(value);
-    }
-    /** Acquire an existing opaque handle for the same client/target lease. */
-    acquireResource(resourceId, scope) {
-        const handle = this.lookup(resourceId);
-        this.assertScope(handle, scope);
-        handle.refcount += 1;
-        handle.expiresAtMs = this.now() + this.ttlMs;
-        handle.expiresAt = new Date(handle.expiresAtMs).toISOString();
-        return this.toWire(handle);
-    }
-    /** Release one reference. A scoped call is used for external requests. */
-    releaseResource(resourceId, scope) {
-        const handle = this.lookup(resourceId);
-        if (scope)
-            this.assertScope(handle, scope);
-        if (handle.refcount <= 0)
-            throw new BrokerProtocolError("RESOURCE_REF_UNDERFLOW", "opaque handle reference count is already zero");
-        handle.refcount -= 1;
-        if (handle.refcount === 0) {
-            this.handles.delete(handle.handleId);
-            return null;
-        }
-        return this.toWire(handle);
-    }
-    releaseClient(clientId) {
-        for (const [handleId, handle] of this.handles)
-            if (handle.ownerClientId === clientId)
-                this.handles.delete(handleId);
-    }
-    status() { this.prune(); return [...this.handles.values()].map(handle => this.toWire(handle)); }
-    lookup(resourceId) {
-        this.prune();
-        const handleId = resourceId.startsWith("handle:") ? resourceId.slice("handle:".length) : resourceId;
-        const handle = this.handles.get(handleId);
-        if (!handle)
-            throw new BrokerProtocolError("RESOURCE_NOT_FOUND", "opaque handle is missing or expired", "Use a live Broker-issued resourceId.");
-        return handle;
-    }
-    assertScope(handle, scope) {
-        if (handle.ownerClientId !== scope.clientId)
-            throw new BrokerProtocolError("RESOURCE_NOT_OWNER", "opaque handle belongs to another client");
-        if (handle.pid !== scope.pid || handle.buildKey !== scope.buildKey)
-            throw new BrokerProtocolError("SESSION_TARGET_MISMATCH", "opaque handle target scope changed");
-    }
-    toWire(handle) {
-        const { value: _value, expiresAtMs: _expiresAtMs, ...wire } = handle;
-        return wire;
-    }
-    createHandle(value, type, scope, created) {
-        const handleId = randomUUID();
-        const expiresAtMs = this.now() + this.ttlMs;
-        const handle = { schema: BROKER_HANDLE_CODEC, handleId, resourceId: `handle:${handleId}`, type, ownerClientId: scope.clientId, pid: scope.pid, buildKey: scope.buildKey, expiresAt: new Date(expiresAtMs).toISOString(), expiresAtMs, refcount: 1, value };
-        this.handles.set(handleId, handle);
-        const { value: _value, expiresAtMs: _expiresAtMs, ...wire } = handle;
-        created.push(wire);
-        return wire;
-    }
-    prune() { for (const [handleId, handle] of this.handles)
-        if (handle.expiresAtMs <= this.now())
-            this.handles.delete(handleId); }
-}