@camstack/types 1.2.217 → 1.2.219

package/dist/{canonical-hash-biq7T_dN.mjs → canonical-hash-DI7tT-zZ.mjs}

@@ -60,6 +60,7 @@ function buildInputArgs(input, decodeHwAccel) {
 	if (input.analyzeDurationUs !== void 0) args.push("-analyzeduration", String(input.analyzeDurationUs));
 	if (input.probeSizeBytes !== void 0) args.push("-probesize", String(input.probeSizeBytes));
 	if (input.lowDelay === true) args.push("-flags", "low_delay");
+	if (input.useWallclockTimestamps === true) args.push("-use_wallclock_as_timestamps", "1");
 	if (input.fflags?.length) for (const flag of input.fflags) args.push("-fflags", flag);
 	if (input.rtspTransport) args.push("-rtsp_transport", input.rtspTransport);
 	args.push("-i", input.url);

package/dist/{canonical-hash-BxuA6beb.js → canonical-hash-sTEH1IHd.js}

@@ -60,6 +60,7 @@ function buildInputArgs(input, decodeHwAccel) {
 	if (input.analyzeDurationUs !== void 0) args.push("-analyzeduration", String(input.analyzeDurationUs));
 	if (input.probeSizeBytes !== void 0) args.push("-probesize", String(input.probeSizeBytes));
 	if (input.lowDelay === true) args.push("-flags", "low_delay");
+	if (input.useWallclockTimestamps === true) args.push("-use_wallclock_as_timestamps", "1");
 	if (input.fflags?.length) for (const flag of input.fflags) args.push("-fflags", flag);
 	if (input.rtspTransport) args.push("-rtsp_transport", input.rtspTransport);
 	args.push("-i", input.url);

package/dist/ffmpeg/invocation.d.ts

@@ -68,6 +68,33 @@ export interface FfmpegInputPlan {
      * reorder will decode out of order.
      */
     readonly lowDelay?: boolean;
+    /**
+     * `-use_wallclock_as_timestamps 1` — stamp this input by ARRIVAL time.
+     *
+     * ffmpeg normalises each input so its first frame is pts 0, and a filter that
+     * pairs inputs (`overlay`) pairs them BY PTS. Two sources that joined at
+     * different moments therefore compose frames from different moments, for the
+     * life of the child, with nothing to correct it: each tile's clock started
+     * whenever that tile's first frame happened to arrive.
+     *
+     * The spread is real. Four joins of the SAME restream in one series measured
+     * 1830 / 3987 / 3985 / 4025 ms (hub, 2026-09-18) — a `/muted` dial is served
+     * at once only within ~500 ms of an IDR and otherwise waits for the next, so
+     * two tiles of one composite can start a key-frame interval apart.
+     *
+     * It is NOT, however, the skew a composite normally has. Measured the same
+     * day: two sources joined in PARALLEL landed 438-599 ms apart, while the same
+     * two inside one ffmpeg were 4-5 s apart — because ffmpeg opens its inputs
+     * SEQUENTIALLY and each open blocks until its probe budget is spent. Shrink
+     * `analyzeDurationUs` / `probeSizeBytes` before reaching for this flag: on
+     * the live grid that alone took the skew to 0-1 s, and this flag cost the
+     * output pacing ten stalls over a second in an 18 s run.
+     *
+     * Ask for it where several inputs must agree about WHEN. A single-input
+     * transcode does not care and should leave it alone: wall-clock stamping ties
+     * the output's timing to this machine's clock rather than to the source's.
+     */
+    readonly useWallclockTimestamps?: boolean;
     /** Caller-supplied input options (an `EncodeProfile.inputArgs`, probe flags). */
     readonly extraArgs?: readonly string[];
 }

package/dist/index.js

@@ -1,7 +1,7 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_sleep = require("./sleep-VlZxDyXq.js");
 const require_event_category = require("./event-category-BVfsrBYA.js");
-const require_canonical_hash = require("./canonical-hash-BxuA6beb.js");
+const require_canonical_hash = require("./canonical-hash-sTEH1IHd.js");
 const require_enums = require("./enums.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let zod = require("zod");

package/dist/index.mjs

@@ -1,6 +1,6 @@
 import { $ as CAM_PROFILE_ORDER, A as DeviceType, At as isEvent, B as systemMethod, Bt as isAudioChunkFormat, C as customAction, Ct as SHARE_VIEW_KINDS, D as ChargingStatus, Dt as createDurableState, E as deviceCustomAction, Et as normalizeAddonInitResult, F as event, Ft as hydrateSchema, G as ReadinessRegistry, H as nodePin, I as expandCapMethods, It as resolveHydratedFieldValue, J as readinessKey, K as ReadinessTimeoutError, L as isDeviceConfigCap, Lt as AUDIO_CHUNK_FORMATS, M as DEFAULT_RUNTIME_STATE_DURABILITY, Mt as WELL_KNOWN_TAB_MAP, N as DEVICE_SETTINGS_CONTRIBUTION_METHODS, Nt as collectHydratedFieldEntries, O as DeviceFeature, Ot as createEvent, P as DEVICE_STATUS_METHOD, Pt as collectHydratedFieldValues, Q as BrokerStatusSchema, R as method, Rt as audioChunkBytesPerSample, S as DEVICE_CHILDREN_BATCH_MAX, St as DATAPLANE_SECRET_HEADER, T as describeCustomActions, Tt as BaseAddon, U as readNodePin, V as CAP_NODE_PIN_CONTEXT_KEY, W as toNodeId, X as AudioChunkFormatSchema, Y as scopeKey, Z as BrokerStatsSchema, _ as createMirrorSource, _t as SubscribeFramesResultSchema, a as asJsonObject, at as DecodedFrameSchema, b as deviceOpsCapability, bt as parseProfileBrokerId, c as parseJsonArray, ct as FrameHandleSchema, d as BOOT_RECOVERY_BACKOFF_MS, dt as ProfileSlotStatusSchema, et as CamProfileSchema, f as DEVICE_SCOPED_CAPS, ft as StreamSourceEntrySchema, g as createLazyTrpcSource, gt as SubscribeFramesInputSchema, h as createEventBusSliceSource, ht as SubscribeAudioChunksResultSchema, i as asJsonArray, it as DecodedAudioChunkSchema, j as adminUiCapability, jt as WELL_KNOWN_TABS, k as DeviceRole, kt as emitReadiness, l as parseJsonObject, lt as ProfileRtspEntrySchema, m as createDeviceProxy, mt as SubscribeAudioChunksInputSchema, n as sleepCancellable, nt as CamStreamResolutionSchema, o as asNumber, ot as EncodedPacketSchema, p as isDeviceScopedCap, pt as StreamSourceSchema, q as emitDownForOwnedCaps, r as asBoolean, rt as CameraStreamSchema, s as asString, st as FrameHandleFormatSchema, t as sleep, tt as CamStreamKindSchema, u as parseJsonUnknown, ut as ProfileSlotSchema, v as createSliceHandle, vt as makeProfileBrokerId, w as defineCustomActions, wt as DisposerChain, x as viewerUiCapability, xt as selectAssignedProfileSlots, y as RawStateResultSchema, yt as makeSourceBrokerId, z as resolveCapMount, zt as expandAudioChunkToF32le } from "./sleep-GU_us3DG.mjs";
 import { t as EventCategory } from "./event-category-BVDXG4tB.mjs";
-import { a as buildAudioArgs, c as buildVideoArgs, d as logBannerArgs, f as pickVideoEncoder, i as audioPlanFromEncodeProfile, l as invocationFromEncodeProfile, n as Fmp4BoxSplitter, o as buildFfmpegArgs, p as resolveStreamMaps, r as AUDIO_PRESETS, s as buildInputArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-biq7T_dN.mjs";
+import { a as buildAudioArgs, c as buildVideoArgs, d as logBannerArgs, f as pickVideoEncoder, i as audioPlanFromEncodeProfile, l as invocationFromEncodeProfile, n as Fmp4BoxSplitter, o as buildFfmpegArgs, p as resolveStreamMaps, r as AUDIO_PRESETS, s as buildInputArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-DI7tT-zZ.mjs";
 import { EventSourceType } from "./enums.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { z } from "zod";

package/dist/node.js

@@ -21,7 +21,7 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 	enumerable: true
 }) : target, mod));
 //#endregion
-const require_canonical_hash = require("./canonical-hash-BxuA6beb.js");
+const require_canonical_hash = require("./canonical-hash-sTEH1IHd.js");
 const require_err_msg = require("./err-msg-COpsHMw2.js");
 let node_crypto = require("node:crypto");
 let node_fs = require("node:fs");

package/dist/node.mjs

@@ -1,4 +1,4 @@
-import { n as Fmp4BoxSplitter, o as buildFfmpegArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-biq7T_dN.mjs";
+import { n as Fmp4BoxSplitter, o as buildFfmpegArgs, t as canonicalHash, u as isSoftwareDecode } from "./canonical-hash-DI7tT-zZ.mjs";
 import { t as errMsg } from "./err-msg-IQTHeDzc.mjs";
 import { createHash, createHmac, randomUUID, timingSafeEqual } from "node:crypto";
 import * as fs from "node:fs";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/types",
-  "version": "1.2.217",
+  "version": "1.2.219",
   "description": "Shared types, interfaces, and model catalogs for the CamStack detection ecosystem",
   "keywords": [
     "camstack",