@nodetool-ai/websocket 0.7.0-rc.22 → 0.8.1

package/dist/lib/video-proxy.js

@@ -0,0 +1,545 @@
+/**
+ * Preview proxies for video assets (F11).
+ *
+ * The timeline preview seeks one `<video>` element per clip. In a long-GOP
+ * source (camera or phone H.264/HEVC, often 4K) every seek decodes from the
+ * previous keyframe, which can be seconds away. A proxy is a smaller copy in
+ * which every frame is a keyframe, so a seek decodes exactly one small frame.
+ *
+ * - Codec: H.264 (libx264) with a GOP of one frame, 8-bit 4:2:0, in MP4.
+ *   Chromium cannot decode ProRes or DNxHR, and MJPEG plays only as an image
+ *   stream, not in `<video>`. All-intra H.264 is what Chromium decodes in
+ *   hardware or software everywhere. An ffmpeg built without libx264 (an
+ *   LGPL build) falls back to all-intra VP9 in WebM, which Chromium also
+ *   plays.
+ * - Size: the longer side is scaled down to {@link PROXY_LONG_SIDE_PX}. A
+ *   smaller source keeps its size.
+ * - Timing: `-fps_mode passthrough` keeps every source frame and its
+ *   timestamp (no frames dropped or duplicated for a variable frame rate), and
+ *   the MP4 track keeps the source stream's timescale. Source time `t` in the
+ *   proxy is the same picture as `t` in the original, so clip in points and
+ *   trims need no mapping.
+ * - Audio: none. Preview video elements are muted; a clip's sound plays from
+ *   its audio clip.
+ *
+ * Storage: a sidecar in the asset store next to the thumbnail, never an asset
+ * row. `<owner>/<id>_proxy.mp4` holds the video and `<owner>/<id>_proxy.json`
+ * a manifest recording the source file's size and mtime when the proxy was
+ * made. The proxy is ready only while the manifest matches the source file, so
+ * a relink or a file changed in place invalidates it (R2). No listing,
+ * search, agent tool, or export sees it, because it is not a row, and asset
+ * delete removes it with the thumbnail.
+ *
+ * Generation runs in the background on a queue that encodes one video at a
+ * time, so imports return at once and a batch import does not start many
+ * encoders. Local mode only: the proxy is written in place under the local
+ * storage root, gated like external assets (D6). A cloud deployment would
+ * need a worker.
+ */
+import { spawn, execFile as execFileCb } from "node:child_process";
+import { createHash } from "node:crypto";
+import { promises as fsp } from "node:fs";
+import nodePath from "node:path";
+import { promisify } from "node:util";
+import { createLogger } from "@nodetool-ai/config";
+import { Asset } from "@nodetool-ai/models";
+import { assetObjectKey, FileStorageAdapter, normalizeStorageKey } from "@nodetool-ai/storage";
+import { getSetting } from "../settings-registry.js";
+import { localAssetPath } from "./asset-paths.js";
+import { externalAssetsAvailable } from "./external-assets.js";
+import { verifiedExternalPath } from "./external-asset-lookup.js";
+import { MediaToolingMissingError } from "./media.js";
+import { getAssetAdapter } from "./storage.js";
+import { isObjectLike } from "./wire-values.js";
+const log = createLogger("nodetool.video-proxy");
+const execFile = promisify(execFileCb);
+/** Setting (and env var): the source size, in pixels of its longer side, at which a proxy is made after import. */
+export const VIDEO_PROXY_MIN_SIZE_SETTING = "NODETOOL_VIDEO_PROXY_MIN_SIZE_PX";
+/** Default: sources of 1920 px (1080p) and larger get a proxy. */
+export const DEFAULT_VIDEO_PROXY_MIN_SIZE_PX = 1920;
+/** The proxy's longer side. */
+export const PROXY_LONG_SIDE_PX = 960;
+/** Bumped when the encode changes, so proxies made before it are remade. */
+const PROXY_FORMAT_VERSION = 1;
+function manifestFileName(assetId) {
+    return `${assetId}_proxy.json`;
+}
+/** Every file a proxy can leave in the owner's folder. Asset delete removes them. */
+export function videoProxyFileNames(assetId) {
+    return [
+        `${assetId}_proxy.mp4`,
+        `${assetId}_proxy.webm`,
+        manifestFileName(assetId)
+    ];
+}
+function isEnoent(err) {
+    return isObjectLike(err) && err.code === "ENOENT";
+}
+/**
+ * Whether this server makes proxies: the local file store, outside
+ * production (the same gate as external assets, D6).
+ */
+export function videoProxiesAvailable() {
+    return externalAssetsAvailable();
+}
+/**
+ * The longer-side size, in pixels, at or above which an imported video gets a
+ * proxy. Read from the settings table, then the environment. `0` proxies every
+ * video, a negative value turns background proxies off, and a missing or
+ * non-numeric value falls back to the default. `ensureProxy` ignores it.
+ */
+export async function getVideoProxyMinSizePx() {
+    let raw;
+    try {
+        raw = await getSetting(VIDEO_PROXY_MIN_SIZE_SETTING);
+    }
+    catch {
+        raw = process.env[VIDEO_PROXY_MIN_SIZE_SETTING] ?? null;
+    }
+    if (raw === null || raw.trim() === "")
+        return DEFAULT_VIDEO_PROXY_MIN_SIZE_PX;
+    const parsed = Number(raw);
+    return Number.isFinite(parsed)
+        ? Math.floor(parsed)
+        : DEFAULT_VIDEO_PROXY_MIN_SIZE_PX;
+}
+/**
+ * The file the asset's bytes live in and its version, or null when there is
+ * none (an offline external file, a missing managed file).
+ */
+async function sourceFile(adapter, asset) {
+    const path = asset.external_path
+        ? await verifiedExternalPath(asset)
+        : await localAssetPath(adapter, asset.user_id, asset.id, asset.content_type);
+    if (!path)
+        return null;
+    try {
+        const info = await fsp.stat(path);
+        return { path, version: `${info.size}:${Math.trunc(info.mtimeMs)}` };
+    }
+    catch {
+        return null;
+    }
+}
+async function readManifest(adapter, asset) {
+    const bytes = await adapter
+        .retrieve(adapter.uriForKey(assetObjectKey(asset.user_id, manifestFileName(asset.id))))
+        .catch(() => null);
+    if (!bytes)
+        return null;
+    try {
+        const parsed = JSON.parse(Buffer.from(bytes).toString("utf8"));
+        if (!isObjectLike(parsed))
+            return null;
+        const manifest = parsed;
+        return typeof manifest.source === "string" &&
+            typeof manifest.file === "string" &&
+            videoProxyFileNames(asset.id).includes(manifest.file)
+            ? manifest
+            : null;
+    }
+    catch {
+        return null;
+    }
+}
+/** The key of a proxy made from `source`, or null when there is none. */
+async function readyProxyKey(adapter, asset, source) {
+    const manifest = await readManifest(adapter, asset);
+    if (!manifest ||
+        manifest.format !== PROXY_FORMAT_VERSION ||
+        manifest.source !== source.version) {
+        return null;
+    }
+    const key = assetObjectKey(asset.user_id, manifest.file);
+    return (await adapter.exists(adapter.uriForKey(key))) ? key : null;
+}
+function versionHash(source) {
+    return createHash("sha256").update(source.version).digest("hex").slice(0, 12);
+}
+/**
+ * The proxy state of a video asset, or null when proxies do not apply (not a
+ * video, or not a local server). A proxy made from another version of the
+ * source file is not ready.
+ */
+export async function videoProxyState(asset) {
+    if (!asset.content_type.startsWith("video/"))
+        return null;
+    if (!videoProxiesAvailable())
+        return null;
+    const adapter = getAssetAdapter();
+    const source = await sourceFile(adapter, asset);
+    if (!source)
+        return { status: "none", key: null, version: null };
+    const key = await readyProxyKey(adapter, asset, source);
+    if (key)
+        return { status: "ready", key, version: versionHash(source) };
+    return {
+        status: videoProxyQueue.status(asset.id, source.version) ?? "none",
+        key: null,
+        version: null
+    };
+}
+/** The first video stream's size, or null when the file has none. */
+export async function probeVideo(filePath) {
+    let stdout;
+    try {
+        ({ stdout } = await execFile("ffprobe", [
+            "-v",
+            "error",
+            "-select_streams",
+            "v:0",
+            "-show_entries",
+            "stream=width,height,time_base",
+            "-of",
+            "json",
+            filePath
+        ]));
+    }
+    catch (err) {
+        if (isEnoent(err))
+            throw new MediaToolingMissingError();
+        return null;
+    }
+    const stream = JSON.parse(stdout).streams?.[0];
+    const width = Number(stream?.width);
+    const height = Number(stream?.height);
+    if (!(width > 0) || !(height > 0))
+        return null;
+    const denominator = Number(stream?.time_base?.split("/")[1]);
+    return {
+        width,
+        height,
+        timescale: Number.isInteger(denominator) && denominator > 0 ? denominator : null
+    };
+}
+let encoderPromise = null;
+/** libx264 when this ffmpeg has it, else VP9. Asked once per process. */
+function proxyCodec() {
+    encoderPromise ??= execFile("ffmpeg", ["-hide_banner", "-encoders"])
+        .then(({ stdout }) => (/\blibx264\b/.test(stdout) ? "h264" : "vp9"))
+        .catch((err) => {
+        encoderPromise = null;
+        throw isEnoent(err) ? new MediaToolingMissingError() : err;
+    });
+    return encoderPromise;
+}
+/** Longer side down to {@link PROXY_LONG_SIDE_PX}, even dimensions, 4:2:0. */
+const SCALE_FILTER = `scale=w='if(gte(iw,ih),trunc(min(${PROXY_LONG_SIDE_PX},iw)/2)*2,-2)'` +
+    `:h='if(gte(iw,ih),-2,trunc(min(${PROXY_LONG_SIDE_PX},ih)/2)*2)',` +
+    "format=yuv420p";
+function encodeArgs(input, output, codec, probe) {
+    const common = [
+        "-v",
+        "error",
+        "-nostdin",
+        "-y",
+        "-i",
+        input,
+        "-map",
+        "0:v:0",
+        "-an",
+        "-sn",
+        "-dn",
+        "-map_metadata",
+        "-1",
+        "-vf",
+        SCALE_FILTER,
+        "-fps_mode",
+        "passthrough"
+    ];
+    if (codec === "h264") {
+        return [
+            ...common,
+            "-c:v",
+            "libx264",
+            "-preset",
+            "veryfast",
+            "-tune",
+            "fastdecode",
+            "-crf",
+            "26",
+            // Every frame a keyframe, no B-frames: a seek decodes one frame.
+            "-g",
+            "1",
+            "-bf",
+            "0",
+            ...(probe.timescale !== null
+                ? ["-video_track_timescale", String(probe.timescale)]
+                : []),
+            "-movflags",
+            "+faststart",
+            "-f",
+            "mp4",
+            output
+        ];
+    }
+    return [
+        ...common,
+        "-c:v",
+        "libvpx-vp9",
+        "-deadline",
+        "realtime",
+        "-cpu-used",
+        "8",
+        "-row-mt",
+        "1",
+        "-crf",
+        "34",
+        "-b:v",
+        "0",
+        "-g",
+        "1",
+        "-f",
+        "webm",
+        output
+    ];
+}
+/**
+ * Encode `input` into an all-intra preview proxy at `output`. Answers the
+ * codec and size written. Throws {@link MediaToolingMissingError} when ffmpeg
+ * is missing, and an AbortError when `signal` aborts.
+ */
+export async function encodeVideoProxy(input, output, probe, signal) {
+    const codec = await proxyCodec();
+    await new Promise((resolve, reject) => {
+        const child = spawn("ffmpeg", encodeArgs(input, output, codec, probe), {
+            stdio: ["ignore", "ignore", "pipe"],
+            signal
+        });
+        let stderr = "";
+        child.stderr.on("data", (chunk) => {
+            if (stderr.length < 4096)
+                stderr += chunk.toString();
+        });
+        child.on("error", (err) => {
+            reject(isEnoent(err) ? new MediaToolingMissingError() : err);
+        });
+        child.on("close", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`ffmpeg exited with ${code}: ${stderr.trim()}`));
+        });
+    });
+    return { codec };
+}
+/**
+ * Runs proxy jobs one at a time, in order. A job already waiting for the same
+ * asset is not queued twice (an explicit request upgrades it to `force`). A
+ * failure is remembered per source version, so an import retrying the same
+ * file does not encode it again. `ensureProxy` clears it.
+ */
+export class VideoProxyQueue {
+    runner;
+    pending = [];
+    running = null;
+    failures = new Map();
+    idleWaiters = [];
+    constructor(runner) {
+        this.runner = runner;
+    }
+    enqueue(job) {
+        const waiting = this.pending.find((p) => p.assetId === job.assetId);
+        if (waiting) {
+            waiting.force ||= job.force;
+            return;
+        }
+        this.pending.push({ ...job });
+        this.pump();
+    }
+    /** `queued` or `running` for a job in flight, `failed` when this version failed. */
+    status(assetId, version) {
+        if (this.pending.some((p) => p.assetId === assetId))
+            return "queued";
+        if (this.running?.job.assetId === assetId)
+            return "running";
+        return this.failures.get(assetId) === version ? "failed" : null;
+    }
+    clearFailure(assetId) {
+        this.failures.delete(assetId);
+    }
+    /** Drop a waiting job for the asset and stop its encode if it is running. */
+    cancel(assetId) {
+        const index = this.pending.findIndex((p) => p.assetId === assetId);
+        if (index >= 0)
+            this.pending.splice(index, 1);
+        if (this.running?.job.assetId === assetId)
+            this.running.abort.abort();
+        this.failures.delete(assetId);
+        this.notifyIfIdle();
+    }
+    /** Resolves once no job is waiting or running. */
+    idle() {
+        if (!this.running && this.pending.length === 0)
+            return Promise.resolve();
+        return new Promise((resolve) => this.idleWaiters.push(resolve));
+    }
+    pump() {
+        if (this.running)
+            return;
+        const job = this.pending.shift();
+        if (!job) {
+            this.notifyIfIdle();
+            return;
+        }
+        const abort = new AbortController();
+        this.running = { job, abort };
+        void this.runner(job, abort.signal)
+            .then(({ outcome, sourceVersion }) => {
+            if (outcome === "failed" && sourceVersion !== null) {
+                this.failures.set(job.assetId, sourceVersion);
+            }
+        })
+            .catch((err) => {
+            log.warn("video proxy job failed", {
+                assetId: job.assetId,
+                error: String(err)
+            });
+        })
+            .finally(() => {
+            this.running = null;
+            this.pump();
+        });
+    }
+    notifyIfIdle() {
+        if (this.running || this.pending.length > 0)
+            return;
+        for (const resolve of this.idleWaiters.splice(0))
+            resolve();
+    }
+}
+/** The file under the local root that `key` names. */
+function rootPath(adapter, key) {
+    const absolute = nodePath.resolve(adapter.rootDir, normalizeStorageKey(key));
+    const relative = nodePath.relative(adapter.rootDir, absolute);
+    if (relative.startsWith("..") || nodePath.isAbsolute(relative)) {
+        throw new Error(`Proxy key resolves outside the storage root: ${key}`);
+    }
+    return absolute;
+}
+async function removeProxyFiles(adapter, asset) {
+    for (const fileName of videoProxyFileNames(asset.id)) {
+        const uri = adapter.uriForKey(assetObjectKey(asset.user_id, fileName));
+        try {
+            if (await adapter.exists(uri))
+                await adapter.delete(uri);
+        }
+        catch (err) {
+            log.warn("video proxy delete failed", {
+                assetId: asset.id,
+                fileName,
+                error: String(err)
+            });
+        }
+    }
+}
+/**
+ * One job: read the row again (it may have been deleted or relinked while
+ * queued), skip a source below the threshold unless forced, encode next to
+ * the final file, move it into place, and write the manifest last, so a proxy
+ * is never ready half-written.
+ */
+export async function runVideoProxyJob(job, signal) {
+    const adapter = getAssetAdapter();
+    if (!(adapter instanceof FileStorageAdapter) || !videoProxiesAvailable()) {
+        return { outcome: "skipped", sourceVersion: null };
+    }
+    const asset = await Asset.find(job.userId, job.assetId);
+    if (!asset || !asset.content_type.startsWith("video/")) {
+        return { outcome: "gone", sourceVersion: null };
+    }
+    const source = await sourceFile(adapter, asset);
+    if (!source)
+        return { outcome: "gone", sourceVersion: null };
+    const result = (outcome) => ({
+        outcome,
+        sourceVersion: source.version
+    });
+    if (await readyProxyKey(adapter, asset, source))
+        return result("ready");
+    let tmp = null;
+    try {
+        const probe = await probeVideo(source.path);
+        if (!probe)
+            return result("failed");
+        if (!job.force) {
+            const min = await getVideoProxyMinSizePx();
+            if (min < 0 || Math.max(probe.width, probe.height) < min) {
+                return result("skipped");
+            }
+        }
+        const codec = await proxyCodec();
+        const fileName = `${asset.id}_proxy.${codec === "h264" ? "mp4" : "webm"}`;
+        const target = rootPath(adapter, assetObjectKey(asset.user_id, fileName));
+        await fsp.mkdir(nodePath.dirname(target), { recursive: true });
+        // Same folder as the target, so the rename below never crosses devices.
+        tmp = `${target}.${process.pid}.${Date.now()}.partial`;
+        const startedAt = Date.now();
+        await encodeVideoProxy(source.path, tmp, probe, signal);
+        const out = await probeVideo(tmp);
+        await fsp.rename(tmp, target);
+        tmp = null;
+        // Deleted or relinked while encoding: take the proxy away with it.
+        if (signal.aborted || !(await Asset.find(job.userId, job.assetId))) {
+            await removeProxyFiles(adapter, asset);
+            return result("gone");
+        }
+        const manifest = {
+            format: PROXY_FORMAT_VERSION,
+            source: source.version,
+            file: fileName,
+            codec,
+            width: out?.width ?? 0,
+            height: out?.height ?? 0
+        };
+        await adapter.store(assetObjectKey(asset.user_id, manifestFileName(asset.id)), new TextEncoder().encode(JSON.stringify(manifest)), "application/json");
+        log.info("video proxy created", {
+            assetId: asset.id,
+            codec,
+            width: manifest.width,
+            height: manifest.height,
+            ms: Date.now() - startedAt
+        });
+        return result("created");
+    }
+    catch (err) {
+        if (signal.aborted)
+            return result("gone");
+        log.warn("video proxy failed", {
+            assetId: asset.id,
+            error: String(err)
+        });
+        return result("failed");
+    }
+    finally {
+        if (tmp)
+            await fsp.rm(tmp, { force: true }).catch(() => undefined);
+    }
+}
+/** The server's proxy queue. */
+export const videoProxyQueue = new VideoProxyQueue(runVideoProxyJob);
+/**
+ * Queue a proxy for a video just imported or relinked. Returns at once: the
+ * job probes the size against the threshold in the background. Does nothing
+ * for other content or off the local store.
+ */
+export function scheduleVideoProxy(asset) {
+    if (!asset.content_type.startsWith("video/"))
+        return;
+    if (!videoProxiesAvailable())
+        return;
+    videoProxyQueue.enqueue({
+        assetId: asset.id,
+        userId: asset.user_id,
+        force: false
+    });
+}
+/**
+ * Remove an asset's proxy and stop any job for it. Asset delete and relink
+ * call this; relink queues a new proxy afterwards.
+ */
+export async function discardVideoProxy(asset) {
+    videoProxyQueue.cancel(asset.id);
+    await removeProxyFiles(getAssetAdapter(), asset);
+}
+//# sourceMappingURL=video-proxy.js.map

package/dist/lib/video-proxy.js.map

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

package/dist/lib/wire-values.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Type predicates for values that arrive over the WebSocket wire.
+ *
+ * Client frames are MsgPack/JSON, so every field reaches the runner as
+ * `unknown` and has to be narrowed before use. These are the questions the
+ * runner asks about such a value, each with one definition so the leniency
+ * they encode (what counts as an object, whether arrays pass) is the same at
+ * every call site.
+ */
+/** A string field. */
+export declare function isString(value: unknown): value is string;
+/** A string field carrying content. */
+export declare function isNonEmptyString(value: unknown): value is string;
+/** A string field carrying content that is not only whitespace. */
+export declare function isNonBlankString(value: unknown): value is string;
+/** A numeric field, `NaN` and infinities included. */
+export declare function isNumber(value: unknown): value is number;
+/** A numeric field safe to compute with. */
+export declare function isFiniteNumber(value: unknown): value is number;
+/** A boolean field. */
+export declare function isBoolean(value: unknown): value is boolean;
+/**
+ * A non-null object, arrays included — the lenient check used where an array
+ * is an acceptable payload or has already been handled by an earlier branch.
+ */
+export declare function isObjectLike(value: unknown): value is Record<string, unknown>;
+/** A non-null, non-array object: a keyed payload. */
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+/** A callable slot on an object whose shape the runner only partly knows. */
+export declare function isFunctionValue(value: unknown): value is (...args: never[]) => unknown;
+//# sourceMappingURL=wire-values.d.ts.map

package/dist/lib/wire-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-values.d.ts","sourceRoot":"","sources":["../../src/lib/wire-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sBAAsB;AACtB,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,uCAAuC;AACvC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAEhE;AAED,sDAAsD;AACtD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD;AAED,4CAA4C;AAC5C,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAE9D;AAED,uBAAuB;AACvB,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,OAAO,CAE1D;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAE7E;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAEzE;AAED,6EAA6E;AAC7E,wBAAgB,eAAe,CAC7B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,CAAC,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,CAExC"}

package/dist/lib/wire-values.js

@@ -0,0 +1,49 @@
+/**
+ * Type predicates for values that arrive over the WebSocket wire.
+ *
+ * Client frames are MsgPack/JSON, so every field reaches the runner as
+ * `unknown` and has to be narrowed before use. These are the questions the
+ * runner asks about such a value, each with one definition so the leniency
+ * they encode (what counts as an object, whether arrays pass) is the same at
+ * every call site.
+ */
+/** A string field. */
+export function isString(value) {
+    return typeof value === "string";
+}
+/** A string field carrying content. */
+export function isNonEmptyString(value) {
+    return typeof value === "string" && value.length > 0;
+}
+/** A string field carrying content that is not only whitespace. */
+export function isNonBlankString(value) {
+    return typeof value === "string" && value.trim() !== "";
+}
+/** A numeric field, `NaN` and infinities included. */
+export function isNumber(value) {
+    return typeof value === "number";
+}
+/** A numeric field safe to compute with. */
+export function isFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value);
+}
+/** A boolean field. */
+export function isBoolean(value) {
+    return typeof value === "boolean";
+}
+/**
+ * A non-null object, arrays included — the lenient check used where an array
+ * is an acceptable payload or has already been handled by an earlier branch.
+ */
+export function isObjectLike(value) {
+    return Boolean(value) && typeof value === "object";
+}
+/** A non-null, non-array object: a keyed payload. */
+export function isRecord(value) {
+    return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+/** A callable slot on an object whose shape the runner only partly knows. */
+export function isFunctionValue(value) {
+    return typeof value === "function";
+}
+//# sourceMappingURL=wire-values.js.map

package/dist/lib/wire-values.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wire-values.js","sourceRoot":"","sources":["../../src/lib/wire-values.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,sBAAsB;AACtB,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,uCAAuC;AACvC,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;AACvD,CAAC;AAED,mEAAmE;AACnE,MAAM,UAAU,gBAAgB,CAAC,KAAc;IAC7C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC;AAC1D,CAAC;AAED,sDAAsD;AACtD,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,OAAO,KAAK,KAAK,QAAQ,CAAC;AACnC,CAAC;AAED,4CAA4C;AAC5C,MAAM,UAAU,cAAc,CAAC,KAAc;IAC3C,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AAC7D,CAAC;AAED,uBAAuB;AACvB,MAAM,UAAU,SAAS,CAAC,KAAc;IACtC,OAAO,OAAO,KAAK,KAAK,SAAS,CAAC;AACpC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,KAAc;IACzC,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC;AACrD,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,QAAQ,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AAC9E,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,eAAe,CAC7B,KAAc;IAEd,OAAO,OAAO,KAAK,KAAK,UAAU,CAAC;AACrC,CAAC"}