@norskvideo/moq-hang 0.1.0

package/README.md

@@ -0,0 +1,65 @@
+<p align="center">
+	<img height="128px" src="https://github.com/moq-dev/moq/blob/main/.github/logo.svg" alt="Media over QUIC">
+</p>
+
+# @moq/hang
+
+[![npm version](https://img.shields.io/npm/v/@moq/hang)](https://www.npmjs.com/package/@moq/hang)
+[![TypeScript](https://img.shields.io/badge/TypeScript-ready-blue.svg)](https://www.typescriptlang.org/)
+
+Core media library for [Media over QUIC](https://moq.dev/) (MoQ). Provides shared primitives used by [`@moq/watch`](../watch) and [`@moq/publish`](../publish), built on top of [`@moq/net`](../lite).
+
+## Features
+
+- **Catalog** — JSON track describing other tracks and their codec properties (audio, video, chat, location, etc.)
+- **Container** — Media framing in two formats: CMAF (fMP4) and Legacy (varint-timestamp + raw codec bitstream)
+- **Utilities** — Hex encoding, Opus audio polyfill (libav), latency computation, browser detection workarounds
+
+Browser support detection is provided by [`<moq-watch-support>`](../watch) and [`<moq-publish-support>`](../publish).
+
+## Installation
+
+```bash
+npm add @moq/hang
+# or
+pnpm add @moq/hang
+yarn add @moq/hang
+bun add @moq/hang
+```
+
+## JavaScript API
+
+```typescript
+import * as Hang from "@moq/hang";
+
+// Catalog — describes tracks and their codec properties
+import * as Catalog from "@moq/hang/catalog";
+
+// Container — media framing (CMAF and Legacy formats)
+import * as Container from "@moq/hang/container";
+
+// CMAF (fMP4) and Legacy (varint-timestamp + raw bitstream) are both available:
+// Container.Cmaf — createVideoInitSegment, createAudioInitSegment, encodeDataSegment, decodeDataSegment, etc.
+// Container.Legacy — Producer / Consumer classes
+```
+
+For watching and publishing, use the dedicated packages:
+
+```typescript
+import * as Watch from "@moq/watch";
+import * as Publish from "@moq/publish";
+```
+
+## Related Packages
+
+- **[@moq/watch](../watch)** — Subscribe to and render MoQ broadcasts
+- **[@moq/publish](../publish)** — Publish media to MoQ broadcasts
+- **[@moq/net](../lite)** — Core pub/sub transport protocol
+- **[@moq/signals](../signals)** — Reactive signals library
+
+## License
+
+Licensed under either:
+
+- Apache License, Version 2.0 ([LICENSE-APACHE](../../LICENSE-APACHE) or http://www.apache.org/licenses/LICENSE-2.0)
+- MIT license ([LICENSE-MIT](../../LICENSE-MIT) or http://opensource.org/licenses/MIT)

package/catalog/audio.d.ts

@@ -0,0 +1,139 @@
+import * as z from "zod/mini";
+/**
+ * Schema for a single audio rendition's decoder config.
+ * Mirrors WebCodecs AudioDecoderConfig (https://w3c.github.io/webcodecs/#audio-decoder-config).
+ */
+export declare const AudioConfigSchema: z.ZodMiniObject<{
+    codec: z.ZodMiniString<string>;
+    container: z.ZodMiniDefault<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+        kind: z.ZodMiniLiteral<"legacy">;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        kind: z.ZodMiniLiteral<"cmaf">;
+        init: z.ZodMiniBase64;
+        timescale: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        trackId: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+    }, z.core.$strip>, z.ZodMiniObject<{
+        kind: z.ZodMiniLiteral<"loc">;
+    }, z.core.$strip>], "kind">>;
+    description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+    sampleRate: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+    numberOfChannels: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+    bitrate: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+    jitter: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+    timeline: z.ZodMiniOptional<z.ZodMiniObject<{
+        track: z.ZodMiniString<string>;
+        timescale: z.ZodMiniDefault<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        wall: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/** Schema for the catalog audio section: a map of track name to rendition config. */
+export declare const AudioSchema: z.ZodMiniUnion<readonly [z.ZodMiniObject<{
+    renditions: z.ZodMiniRecord<z.ZodMiniString<string>, z.ZodMiniObject<{
+        codec: z.ZodMiniString<string>;
+        container: z.ZodMiniDefault<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+            kind: z.ZodMiniLiteral<"legacy">;
+        }, z.core.$strip>, z.ZodMiniObject<{
+            kind: z.ZodMiniLiteral<"cmaf">;
+            init: z.ZodMiniBase64;
+            timescale: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+            trackId: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        }, z.core.$strip>, z.ZodMiniObject<{
+            kind: z.ZodMiniLiteral<"loc">;
+        }, z.core.$strip>], "kind">>;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        sampleRate: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+        numberOfChannels: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+        bitrate: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        jitter: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        timeline: z.ZodMiniOptional<z.ZodMiniObject<{
+            track: z.ZodMiniString<string>;
+            timescale: z.ZodMiniDefault<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+            wall: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>>;
+}, z.core.$strip>, z.ZodMiniPipe<z.ZodMiniObject<{
+    track: z.ZodMiniObject<{
+        name: z.ZodMiniString<string>;
+    }, z.core.$strip>;
+    config: z.ZodMiniObject<{
+        codec: z.ZodMiniString<string>;
+        container: z.ZodMiniDefault<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+            kind: z.ZodMiniLiteral<"legacy">;
+        }, z.core.$strip>, z.ZodMiniObject<{
+            kind: z.ZodMiniLiteral<"cmaf">;
+            init: z.ZodMiniBase64;
+            timescale: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+            trackId: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        }, z.core.$strip>, z.ZodMiniObject<{
+            kind: z.ZodMiniLiteral<"loc">;
+        }, z.core.$strip>], "kind">>;
+        description: z.ZodMiniOptional<z.ZodMiniString<string>>;
+        sampleRate: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+        numberOfChannels: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+        bitrate: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        jitter: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        timeline: z.ZodMiniOptional<z.ZodMiniObject<{
+            track: z.ZodMiniString<string>;
+            timescale: z.ZodMiniDefault<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+            wall: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+}, z.core.$strip>, z.ZodMiniTransform<{
+    renditions: {
+        [x: string]: {
+            codec: string;
+            container: {
+                kind: "legacy";
+            } | {
+                kind: "cmaf";
+                init: string;
+                timescale?: (number & z.$brand<"u53">) | undefined;
+                trackId?: (number & z.$brand<"u53">) | undefined;
+            } | {
+                kind: "loc";
+            };
+            description?: string | undefined;
+            sampleRate: number & z.$brand<"u53">;
+            numberOfChannels: number & z.$brand<"u53">;
+            bitrate?: (number & z.$brand<"u53">) | undefined;
+            jitter?: (number & z.$brand<"u53">) | undefined;
+            timeline?: {
+                track: string;
+                timescale: number & z.$brand<"u53">;
+                wall?: (number & z.$brand<"u53">) | undefined;
+            } | undefined;
+        };
+    };
+}, {
+    track: {
+        name: string;
+    };
+    config: {
+        codec: string;
+        container: {
+            kind: "legacy";
+        } | {
+            kind: "cmaf";
+            init: string;
+            timescale?: (number & z.$brand<"u53">) | undefined;
+            trackId?: (number & z.$brand<"u53">) | undefined;
+        } | {
+            kind: "loc";
+        };
+        description?: string | undefined;
+        sampleRate: number & z.$brand<"u53">;
+        numberOfChannels: number & z.$brand<"u53">;
+        bitrate?: (number & z.$brand<"u53">) | undefined;
+        jitter?: (number & z.$brand<"u53">) | undefined;
+        timeline?: {
+            track: string;
+            timescale: number & z.$brand<"u53">;
+            wall?: (number & z.$brand<"u53">) | undefined;
+        } | undefined;
+    };
+}>>]>;
+/** The catalog audio section: renditions keyed by track name. */
+export type Audio = z.infer<typeof AudioSchema>;
+/** Decoder config for a single audio rendition. */
+export type AudioConfig = z.infer<typeof AudioConfigSchema>;
+//# sourceMappingURL=audio.d.ts.map

package/catalog/audio.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.d.ts","sourceRoot":"","sources":["../../src/catalog/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAU9B;;;GAGG;AACH,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;iBAgC5B,CAAC;AAEH,qFAAqF;AACrF,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;KAgBtB,CAAC;AAEH,iEAAiE;AACjE,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAChD,mDAAmD;AACnD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC"}

package/catalog/audio.js

@@ -0,0 +1,55 @@
+/* @ts-self-types="./audio.d.ts" */
+import * as z from "zod/mini";
+import { ContainerSchema } from "./container";
+import { u53Schema } from "./integers";
+import { TimelineSchema } from "./timeline";
+// Backwards compatibility: old track schema
+const TrackSchema = z.object({
+    name: z.string(),
+});
+/**
+ * Schema for a single audio rendition's decoder config.
+ * Mirrors WebCodecs AudioDecoderConfig (https://w3c.github.io/webcodecs/#audio-decoder-config).
+ */
+export const AudioConfigSchema = z.object({
+    // See: https://w3c.github.io/webcodecs/codec_registry.html
+    codec: z.string(),
+    // The container format, used to decode the timestamp and more.
+    container: ContainerSchema,
+    // The description is used for some codecs.
+    // If provided, we can initialize the decoder based on the catalog alone.
+    // Otherwise, the initialization information is in-band.
+    description: z.optional(z.string()), // hex encoded TODO use base64
+    // The sample rate of the audio in Hz
+    sampleRate: u53Schema,
+    // The number of channels in the audio
+    numberOfChannels: u53Schema,
+    // The bitrate of the audio in bits per second
+    // TODO: Support up to Number.MAX_SAFE_INTEGER
+    bitrate: z.optional(u53Schema),
+    // The maximum jitter before the next frame is emitted in milliseconds.
+    // The player's jitter buffer should be larger than this value.
+    // If not provided, the player should assume each frame is flushed immediately.
+    //
+    // NOTE: The audio "frame" duration depends on the codec, sample rate, etc.
+    // ex: AAC often uses 1024 samples per frame, so at 44100Hz, this would be 1024/44100 = 23ms
+    jitter: z.optional(u53Schema),
+    // The companion timeline track indexing this rendition's groups, if the publisher offers one.
+    timeline: z.optional(TimelineSchema),
+});
+/** Schema for the catalog audio section: a map of track name to rendition config. */
+export const AudioSchema = z.union([
+    z.object({
+        // A map of track name to rendition configuration.
+        // This is not an array so it will work with JSON Merge Patch.
+        renditions: z.record(z.string(), AudioConfigSchema),
+    }),
+    // Backwards compatibility: transform old {track, config} format to new object format
+    z.pipe(z.object({
+        track: TrackSchema,
+        config: AudioConfigSchema,
+    }), z.transform((old) => ({
+        renditions: { [old.track.name]: old.config },
+    }))),
+]);
+//# sourceMappingURL=audio.js.map

package/catalog/audio.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"audio.js","sourceRoot":"","sources":["../../src/catalog/audio.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AACvC,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAE5C,4CAA4C;AAC5C,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;CAChB,CAAC,CAAC;AAEH;;;GAGG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC;IACzC,2DAA2D;IAC3D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IAEjB,+DAA+D;IAC/D,SAAS,EAAE,eAAe;IAE1B,2CAA2C;IAC3C,yEAAyE;IACzE,wDAAwD;IACxD,WAAW,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,8BAA8B;IAEnE,qCAAqC;IACrC,UAAU,EAAE,SAAS;IAErB,sCAAsC;IACtC,gBAAgB,EAAE,SAAS;IAE3B,8CAA8C;IAC9C,8CAA8C;IAC9C,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAE9B,uEAAuE;IACvE,+DAA+D;IAC/D,+EAA+E;IAC/E,EAAE;IACF,2EAA2E;IAC3E,4FAA4F;IAC5F,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;IAE7B,8FAA8F;IAC9F,QAAQ,EAAE,CAAC,CAAC,QAAQ,CAAC,cAAc,CAAC;CACpC,CAAC,CAAC;AAEH,qFAAqF;AACrF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC;IAClC,CAAC,CAAC,MAAM,CAAC;QACR,kDAAkD;QAClD,8DAA8D;QAC9D,UAAU,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,iBAAiB,CAAC;KACnD,CAAC;IACF,qFAAqF;IACrF,CAAC,CAAC,IAAI,CACL,CAAC,CAAC,MAAM,CAAC;QACR,KAAK,EAAE,WAAW;QAClB,MAAM,EAAE,iBAAiB;KACzB,CAAC,EACF,CAAC,CAAC,SAAS,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;QACrB,UAAU,EAAE,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,GAAG,CAAC,MAAM,EAAE;KAC5C,CAAC,CAAC,CACH;CACD,CAAC,CAAC","sourcesContent":["import * as z from \"zod/mini\";\nimport { ContainerSchema } from \"./container\";\nimport { u53Schema } from \"./integers\";\nimport { TimelineSchema } from \"./timeline\";\n\n// Backwards compatibility: old track schema\nconst TrackSchema = z.object({\n\tname: z.string(),\n});\n\n/**\n * Schema for a single audio rendition's decoder config.\n * Mirrors WebCodecs AudioDecoderConfig (https://w3c.github.io/webcodecs/#audio-decoder-config).\n */\nexport const AudioConfigSchema = z.object({\n\t// See: https://w3c.github.io/webcodecs/codec_registry.html\n\tcodec: z.string(),\n\n\t// The container format, used to decode the timestamp and more.\n\tcontainer: ContainerSchema,\n\n\t// The description is used for some codecs.\n\t// If provided, we can initialize the decoder based on the catalog alone.\n\t// Otherwise, the initialization information is in-band.\n\tdescription: z.optional(z.string()), // hex encoded TODO use base64\n\n\t// The sample rate of the audio in Hz\n\tsampleRate: u53Schema,\n\n\t// The number of channels in the audio\n\tnumberOfChannels: u53Schema,\n\n\t// The bitrate of the audio in bits per second\n\t// TODO: Support up to Number.MAX_SAFE_INTEGER\n\tbitrate: z.optional(u53Schema),\n\n\t// The maximum jitter before the next frame is emitted in milliseconds.\n\t// The player's jitter buffer should be larger than this value.\n\t// If not provided, the player should assume each frame is flushed immediately.\n\t//\n\t// NOTE: The audio \"frame\" duration depends on the codec, sample rate, etc.\n\t// ex: AAC often uses 1024 samples per frame, so at 44100Hz, this would be 1024/44100 = 23ms\n\tjitter: z.optional(u53Schema),\n\n\t// The companion timeline track indexing this rendition's groups, if the publisher offers one.\n\ttimeline: z.optional(TimelineSchema),\n});\n\n/** Schema for the catalog audio section: a map of track name to rendition config. */\nexport const AudioSchema = z.union([\n\tz.object({\n\t\t// A map of track name to rendition configuration.\n\t\t// This is not an array so it will work with JSON Merge Patch.\n\t\trenditions: z.record(z.string(), AudioConfigSchema),\n\t}),\n\t// Backwards compatibility: transform old {track, config} format to new object format\n\tz.pipe(\n\t\tz.object({\n\t\t\ttrack: TrackSchema,\n\t\t\tconfig: AudioConfigSchema,\n\t\t}),\n\t\tz.transform((old) => ({\n\t\t\trenditions: { [old.track.name]: old.config },\n\t\t})),\n\t),\n]);\n\n/** The catalog audio section: renditions keyed by track name. */\nexport type Audio = z.infer<typeof AudioSchema>;\n/** Decoder config for a single audio rendition. */\nexport type AudioConfig = z.infer<typeof AudioConfigSchema>;\n"]}

package/catalog/consumer.d.ts

@@ -0,0 +1,34 @@
+import * as Json from "@norskvideo/moq-json";
+import type * as Moq from "@norskvideo/moq-net";
+import type * as z from "zod/mini";
+import { type Root } from "./root";
+/** Options for a catalog {@link Consumer}. */
+export interface ConsumerConfig<T extends Root = Root> {
+    /** zod schema validating each catalog. Defaults to {@link RootSchema}. */
+    schema?: z.ZodMiniType<T>;
+    /**
+     * Whether the track's frames are DEFLATE-compressed (the `catalog.json.z` track). Must match the
+     * publisher. Defaults to `false`.
+     */
+    compression?: boolean;
+}
+/**
+ * Consumes a {@link Root} catalog from a track, reconstructing it from snapshots and deltas.
+ *
+ * A thin wrapper around the `@norskvideo/moq-json` consumer, pre-wired with {@link RootSchema}. Call `next()`
+ * to get each catalog as it changes, or iterate it. Pass an extended schema (built via
+ * `z.extend(RootSchema, ...)`) to validate and type application sections; otherwise unknown
+ * sections pass through untouched. Set `compression` to read the `catalog.json.z` track.
+ */
+export declare class Consumer<T extends Root = Root> extends Json.Snapshot.Consumer<T> {
+    /** Wrap `track`, validating each catalog against `config.schema` (defaults to {@link RootSchema}). */
+    constructor(track: Moq.Track, config?: ConsumerConfig<T>);
+}
+/**
+ * Read the current catalog from `track` once.
+ *
+ * @deprecated Use {@link Consumer} instead: `new Catalog.Consumer(track).next()`. A one-shot read
+ * returns only the current catalog and misses later updates (and deltas, once enabled).
+ */
+export declare function fetch(track: Moq.Track): Promise<Root | undefined>;
+//# sourceMappingURL=consumer.d.ts.map

package/catalog/consumer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.d.ts","sourceRoot":"","sources":["../../src/catalog/consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,KAAK,GAAG,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,KAAK,CAAC,MAAM,UAAU,CAAC;AAEnC,OAAO,EAAE,KAAK,IAAI,EAAc,MAAM,WAAW,CAAC;AAElD,8CAA8C;AAC9C,MAAM,WAAW,cAAc,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI;IACpD,0EAA0E;IAC1E,MAAM,CAAC,EAAE,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;IAE1B;;;OAGG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;;;;;GAOG;AACH,qBAAa,QAAQ,CAAC,CAAC,SAAS,IAAI,GAAG,IAAI,CAAE,SAAQ,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC7E,sGAAsG;IACtG,YAAY,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,GAAE,cAAc,CAAC,CAAC,CAAM,EAK3D;CACD;AAED;;;;;GAKG;AACH,wBAAgB,KAAK,CAAC,KAAK,EAAE,GAAG,CAAC,KAAK,GAAG,OAAO,CAAC,IAAI,GAAG,SAAS,CAAC,CAEjE"}

package/catalog/consumer.js

@@ -0,0 +1,30 @@
+/* @ts-self-types="./consumer.d.ts" */
+import * as Json from "@norskvideo/moq-json";
+import { RootSchema } from "./root.js";
+/**
+ * Consumes a {@link Root} catalog from a track, reconstructing it from snapshots and deltas.
+ *
+ * A thin wrapper around the `@norskvideo/moq-json` consumer, pre-wired with {@link RootSchema}. Call `next()`
+ * to get each catalog as it changes, or iterate it. Pass an extended schema (built via
+ * `z.extend(RootSchema, ...)`) to validate and type application sections; otherwise unknown
+ * sections pass through untouched. Set `compression` to read the `catalog.json.z` track.
+ */
+export class Consumer extends Json.Snapshot.Consumer {
+    /** Wrap `track`, validating each catalog against `config.schema` (defaults to {@link RootSchema}). */
+    constructor(track, config = {}) {
+        super(track, {
+            schema: (config.schema ?? RootSchema),
+            compression: config.compression,
+        });
+    }
+}
+/**
+ * Read the current catalog from `track` once.
+ *
+ * @deprecated Use {@link Consumer} instead: `new Catalog.Consumer(track).next()`. A one-shot read
+ * returns only the current catalog and misses later updates (and deltas, once enabled).
+ */
+export function fetch(track) {
+    return new Consumer(track).next();
+}
+//# sourceMappingURL=consumer.js.map

package/catalog/consumer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"consumer.js","sourceRoot":"","sources":["../../src/catalog/consumer.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAIlC,OAAO,EAAa,UAAU,EAAE,MAAM,WAAW,CAAC;AAclD;;;;;;;GAOG;AACH,MAAM,OAAO,QAAgC,SAAQ,IAAI,CAAC,QAAQ,CAAC,QAAW;IAC7E,sGAAsG;IACtG,YAAY,KAAgB,EAAE,MAAM,GAAsB,EAAE;QAC3D,KAAK,CAAC,KAAK,EAAE;YACZ,MAAM,EAAE,CAAC,MAAM,CAAC,MAAM,IAAI,UAAU,CAAqB;YACzD,WAAW,EAAE,MAAM,CAAC,WAAW;SAC/B,CAAC,CAAC;IACJ,CAAC;CACD;AAED;;;;;GAKG;AACH,MAAM,UAAU,KAAK,CAAC,KAAgB;IACrC,OAAO,IAAI,QAAQ,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC;AACnC,CAAC","sourcesContent":["import * as Json from \"@moq/json\";\nimport type * as Moq from \"@moq/net\";\nimport type * as z from \"zod/mini\";\n\nimport { type Root, RootSchema } from \"./root.ts\";\n\n/** Options for a catalog {@link Consumer}. */\nexport interface ConsumerConfig<T extends Root = Root> {\n\t/** zod schema validating each catalog. Defaults to {@link RootSchema}. */\n\tschema?: z.ZodMiniType<T>;\n\n\t/**\n\t * Whether the track's frames are DEFLATE-compressed (the `catalog.json.z` track). Must match the\n\t * publisher. Defaults to `false`.\n\t */\n\tcompression?: boolean;\n}\n\n/**\n * Consumes a {@link Root} catalog from a track, reconstructing it from snapshots and deltas.\n *\n * A thin wrapper around the `@moq/json` consumer, pre-wired with {@link RootSchema}. Call `next()`\n * to get each catalog as it changes, or iterate it. Pass an extended schema (built via\n * `z.extend(RootSchema, ...)`) to validate and type application sections; otherwise unknown\n * sections pass through untouched. Set `compression` to read the `catalog.json.z` track.\n */\nexport class Consumer<T extends Root = Root> extends Json.Snapshot.Consumer<T> {\n\t/** Wrap `track`, validating each catalog against `config.schema` (defaults to {@link RootSchema}). */\n\tconstructor(track: Moq.Track, config: ConsumerConfig<T> = {}) {\n\t\tsuper(track, {\n\t\t\tschema: (config.schema ?? RootSchema) as z.ZodMiniType<T>,\n\t\t\tcompression: config.compression,\n\t\t});\n\t}\n}\n\n/**\n * Read the current catalog from `track` once.\n *\n * @deprecated Use {@link Consumer} instead: `new Catalog.Consumer(track).next()`. A one-shot read\n * returns only the current catalog and misses later updates (and deltas, once enabled).\n */\nexport function fetch(track: Moq.Track): Promise<Root | undefined> {\n\treturn new Consumer(track).next();\n}\n"]}

package/catalog/container.d.ts

@@ -0,0 +1,24 @@
+import * as z from "zod/mini";
+/**
+ * Container format for frame timestamp encoding and frame payload structure.
+ *
+ * - "legacy": QUIC VarInt timestamp prefix followed by the raw codec payload.
+ *             Timestamps are in microseconds.
+ * - "cmaf": Fragmented MP4 container - frames contain complete moof+mdat fragments.
+ *           The init segment (ftyp+moov) is base64-encoded in the catalog.
+ * - "loc": Low Overhead Container (draft-ietf-moq-loc). Each frame has a small
+ *          property block followed by the codec payload.
+ */
+export declare const ContainerSchema: z.ZodMiniDefault<z.ZodMiniDiscriminatedUnion<[z.ZodMiniObject<{
+    kind: z.ZodMiniLiteral<"legacy">;
+}, z.core.$strip>, z.ZodMiniObject<{
+    kind: z.ZodMiniLiteral<"cmaf">;
+    init: z.ZodMiniBase64;
+    timescale: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+    trackId: z.ZodMiniOptional<z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">>;
+}, z.core.$strip>, z.ZodMiniObject<{
+    kind: z.ZodMiniLiteral<"loc">;
+}, z.core.$strip>], "kind">>;
+/** The per-frame container format declared in the catalog. */
+export type Container = z.infer<typeof ContainerSchema>;
+//# sourceMappingURL=container.d.ts.map

package/catalog/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/catalog/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAG9B;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe;;;;;;;;;4BAkB3B,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/catalog/container.js

@@ -0,0 +1,30 @@
+/* @ts-self-types="./container.d.ts" */
+import * as z from "zod/mini";
+import { u53Schema } from "./integers";
+/**
+ * Container format for frame timestamp encoding and frame payload structure.
+ *
+ * - "legacy": QUIC VarInt timestamp prefix followed by the raw codec payload.
+ *             Timestamps are in microseconds.
+ * - "cmaf": Fragmented MP4 container - frames contain complete moof+mdat fragments.
+ *           The init segment (ftyp+moov) is base64-encoded in the catalog.
+ * - "loc": Low Overhead Container (draft-ietf-moq-loc). Each frame has a small
+ *          property block followed by the codec payload.
+ */
+export const ContainerSchema = z._default(z.discriminatedUnion("kind", [
+    // The default hang container
+    z.object({ kind: z.literal("legacy") }),
+    // CMAF container with base64-encoded init segment (ftyp+moov).
+    // `timescale` and `trackId` are deprecated: they duplicate info in `init`
+    // and are accepted only so catalogs from newer publishers (which still
+    // emit them for older players) round-trip cleanly.
+    z.object({
+        kind: z.literal("cmaf"),
+        init: z.base64(),
+        timescale: z.optional(u53Schema),
+        trackId: z.optional(u53Schema),
+    }),
+    // Low Overhead Container.
+    z.object({ kind: z.literal("loc") }),
+]), { kind: "legacy" });
+//# sourceMappingURL=container.js.map

package/catalog/container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.js","sourceRoot":"","sources":["../../src/catalog/container.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAC9B,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEvC;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,QAAQ,CACxC,CAAC,CAAC,kBAAkB,CAAC,MAAM,EAAE;IAC5B,6BAA6B;IAC7B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;IACvC,+DAA+D;IAC/D,0EAA0E;IAC1E,uEAAuE;IACvE,mDAAmD;IACnD,CAAC,CAAC,MAAM,CAAC;QACR,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC;QACvB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;QAChB,SAAS,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;QAChC,OAAO,EAAE,CAAC,CAAC,QAAQ,CAAC,SAAS,CAAC;KAC9B,CAAC;IACF,0BAA0B;IAC1B,CAAC,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;CACpC,CAAC,EACF,EAAE,IAAI,EAAE,QAAQ,EAAE,CAClB,CAAC","sourcesContent":["import * as z from \"zod/mini\";\nimport { u53Schema } from \"./integers\";\n\n/**\n * Container format for frame timestamp encoding and frame payload structure.\n *\n * - \"legacy\": QUIC VarInt timestamp prefix followed by the raw codec payload.\n *             Timestamps are in microseconds.\n * - \"cmaf\": Fragmented MP4 container - frames contain complete moof+mdat fragments.\n *           The init segment (ftyp+moov) is base64-encoded in the catalog.\n * - \"loc\": Low Overhead Container (draft-ietf-moq-loc). Each frame has a small\n *          property block followed by the codec payload.\n */\nexport const ContainerSchema = z._default(\n\tz.discriminatedUnion(\"kind\", [\n\t\t// The default hang container\n\t\tz.object({ kind: z.literal(\"legacy\") }),\n\t\t// CMAF container with base64-encoded init segment (ftyp+moov).\n\t\t// `timescale` and `trackId` are deprecated: they duplicate info in `init`\n\t\t// and are accepted only so catalogs from newer publishers (which still\n\t\t// emit them for older players) round-trip cleanly.\n\t\tz.object({\n\t\t\tkind: z.literal(\"cmaf\"),\n\t\t\tinit: z.base64(),\n\t\t\ttimescale: z.optional(u53Schema),\n\t\t\ttrackId: z.optional(u53Schema),\n\t\t}),\n\t\t// Low Overhead Container.\n\t\tz.object({ kind: z.literal(\"loc\") }),\n\t]),\n\t{ kind: \"legacy\" },\n);\n\n/** The per-frame container format declared in the catalog. */\nexport type Container = z.infer<typeof ContainerSchema>;\n"]}

package/catalog/format.d.ts

@@ -0,0 +1,13 @@
+/** Track name for the uncompressed hang catalog (the `.json` track). */
+export declare const TRACK = "catalog.json";
+/** Track name for the DEFLATE-compressed hang catalog: the `.z` sibling of {@link TRACK}. */
+export declare const TRACK_COMPRESSED = "catalog.json.z";
+/** Recognized catalog format suffixes used in broadcast names. */
+export declare const FORMATS: readonly ["hang", "msf"];
+/** A catalog format advertised by a broadcast name suffix. */
+export type Format = (typeof FORMATS)[number];
+/** The catalog format assumed when a broadcast name has no recognized suffix. */
+export declare const DEFAULT_FORMAT: Format;
+/** Detect the catalog format from a broadcast name suffix, or `undefined` if the name has no recognized extension. */
+export declare function detectFormat(name: string): Format | undefined;
+//# sourceMappingURL=format.d.ts.map

package/catalog/format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.d.ts","sourceRoot":"","sources":["../../src/catalog/format.ts"],"names":[],"mappings":"AAOA,wEAAwE;AACxE,eAAO,MAAM,KAAK,iBAAiB,CAAC;AAEpC,6FAA6F;AAC7F,eAAO,MAAM,gBAAgB,mBAAmB,CAAC;AAEjD,kEAAkE;AAClE,eAAO,MAAM,OAAO,YAAI,MAAM,EAAE,KAAK,CAAU,CAAC;AAChD,8DAA8D;AAC9D,MAAM,MAAM,MAAM,GAAG,CAAC,OAAO,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC;AAE9C,iFAAiF;AACjF,eAAO,MAAM,cAAc,EAAE,MAAe,CAAC;AAE7C,sHAAsH;AACtH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAK7D"}

package/catalog/format.js

@@ -0,0 +1,24 @@
+/* @ts-self-types="./format.d.ts" */
+// Filename-style format extensions for broadcast names.
+//
+// Broadcast names use a filename-style suffix to advertise their catalog format,
+// e.g. `demo/bbb.hang` or `demo/bbb.msf`. Consumers parse the suffix to pick a
+// catalog track without explicit configuration; publishers should include the
+// suffix in the name they publish so consumers can detect it.
+/** Track name for the uncompressed hang catalog (the `.json` track). */
+export const TRACK = "catalog.json";
+/** Track name for the DEFLATE-compressed hang catalog: the `.z` sibling of {@link TRACK}. */
+export const TRACK_COMPRESSED = "catalog.json.z";
+/** Recognized catalog format suffixes used in broadcast names. */
+export const FORMATS = ["hang", "msf"];
+/** The catalog format assumed when a broadcast name has no recognized suffix. */
+export const DEFAULT_FORMAT = "hang";
+/** Detect the catalog format from a broadcast name suffix, or `undefined` if the name has no recognized extension. */
+export function detectFormat(name) {
+    for (const format of FORMATS) {
+        if (name.endsWith(`.${format}`))
+            return format;
+    }
+    return undefined;
+}
+//# sourceMappingURL=format.js.map

package/catalog/format.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"format.js","sourceRoot":"","sources":["../../src/catalog/format.ts"],"names":[],"mappings":"AAAA,wDAAwD;AACxD,EAAE;AACF,iFAAiF;AACjF,+EAA+E;AAC/E,8EAA8E;AAC9E,8DAA8D;AAE9D,wEAAwE;AACxE,MAAM,CAAC,MAAM,KAAK,GAAG,cAAc,CAAC;AAEpC,6FAA6F;AAC7F,MAAM,CAAC,MAAM,gBAAgB,GAAG,gBAAgB,CAAC;AAEjD,kEAAkE;AAClE,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,MAAM,EAAE,KAAK,CAAU,CAAC;AAIhD,iFAAiF;AACjF,MAAM,CAAC,MAAM,cAAc,GAAW,MAAM,CAAC;AAE7C,sHAAsH;AACtH,MAAM,UAAU,YAAY,CAAC,IAAY;IACxC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,EAAE,CAAC;YAAE,OAAO,MAAM,CAAC;IAChD,CAAC;IACD,OAAO,SAAS,CAAC;AAClB,CAAC","sourcesContent":["// Filename-style format extensions for broadcast names.\n//\n// Broadcast names use a filename-style suffix to advertise their catalog format,\n// e.g. `demo/bbb.hang` or `demo/bbb.msf`. Consumers parse the suffix to pick a\n// catalog track without explicit configuration; publishers should include the\n// suffix in the name they publish so consumers can detect it.\n\n/** Track name for the uncompressed hang catalog (the `.json` track). */\nexport const TRACK = \"catalog.json\";\n\n/** Track name for the DEFLATE-compressed hang catalog: the `.z` sibling of {@link TRACK}. */\nexport const TRACK_COMPRESSED = \"catalog.json.z\";\n\n/** Recognized catalog format suffixes used in broadcast names. */\nexport const FORMATS = [\"hang\", \"msf\"] as const;\n/** A catalog format advertised by a broadcast name suffix. */\nexport type Format = (typeof FORMATS)[number];\n\n/** The catalog format assumed when a broadcast name has no recognized suffix. */\nexport const DEFAULT_FORMAT: Format = \"hang\";\n\n/** Detect the catalog format from a broadcast name suffix, or `undefined` if the name has no recognized extension. */\nexport function detectFormat(name: string): Format | undefined {\n\tfor (const format of FORMATS) {\n\t\tif (name.endsWith(`.${format}`)) return format;\n\t}\n\treturn undefined;\n}\n"]}

package/catalog/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * JSON catalog schema and types describing a broadcast's tracks for WebCodecs:
+ * audio/video decoder configs, container format, and rendition layout.
+ *
+ * @module
+ */
+export * from "./audio";
+export * from "./consumer";
+export * from "./container";
+export * from "./format";
+export * from "./integers";
+export * from "./priority";
+export * from "./producer";
+export * from "./root";
+export * from "./timeline";
+export * from "./track";
+export * from "./video";
+//# sourceMappingURL=index.d.ts.map

package/catalog/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC"}

package/catalog/index.js

@@ -0,0 +1,19 @@
+/* @ts-self-types="./index.d.ts" */
+/**
+ * JSON catalog schema and types describing a broadcast's tracks for WebCodecs:
+ * audio/video decoder configs, container format, and rendition layout.
+ *
+ * @module
+ */
+export * from "./audio";
+export * from "./consumer";
+export * from "./container";
+export * from "./format";
+export * from "./integers";
+export * from "./priority";
+export * from "./producer";
+export * from "./root";
+export * from "./timeline";
+export * from "./track";
+export * from "./video";
+//# sourceMappingURL=index.js.map

package/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/catalog/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,YAAY,CAAC;AAC3B,cAAc,SAAS,CAAC;AACxB,cAAc,SAAS,CAAC","sourcesContent":["/**\n * JSON catalog schema and types describing a broadcast's tracks for WebCodecs:\n * audio/video decoder configs, container format, and rendition layout.\n *\n * @module\n */\n\nexport * from \"./audio\";\nexport * from \"./consumer\";\nexport * from \"./container\";\nexport * from \"./format\";\nexport * from \"./integers\";\nexport * from \"./priority\";\nexport * from \"./producer\";\nexport * from \"./root\";\nexport * from \"./timeline\";\nexport * from \"./track\";\nexport * from \"./video\";\n"]}

package/catalog/integers.d.ts

@@ -0,0 +1,23 @@
+import * as z from "zod/mini";
+/**
+ * Branded type for 8-bit unsigned integers (0-255)
+ */
+export declare const u8Schema: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u8", "out">;
+/** Branded 8-bit unsigned integer (0-255). */
+export type U8 = z.infer<typeof u8Schema>;
+/**
+ * Branded type for 53-bit unsigned integers (JavaScript's MAX_SAFE_INTEGER)
+ * This represents the maximum safe integer in JavaScript (2^53 - 1)
+ */
+export declare const u53Schema: z.core.$ZodBranded<z.ZodMiniNumber<number>, "u53", "out">;
+/** Branded unsigned integer up to JavaScript's MAX_SAFE_INTEGER (2^53 - 1). */
+export type U53 = z.infer<typeof u53Schema>;
+/**
+ * Convenience function to create a u8 value
+ */
+export declare function u8(value: number): U8;
+/**
+ * Convenience function to create a u53 value
+ */
+export declare function u53(value: number): U53;
+//# sourceMappingURL=integers.d.ts.map

package/catalog/integers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integers.d.ts","sourceRoot":"","sources":["../../src/catalog/integers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B;;GAEG;AACH,eAAO,MAAM,QAAQ,0DAAqE,CAAC;AAE3F,8CAA8C;AAC9C,MAAM,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAE1C;;;GAGG;AACH,eAAO,MAAM,SAAS,2DAA0F,CAAC;AAEjH,+EAA+E;AAC/E,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAE5C;;GAEG;AACH,wBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG,EAAE,CAEpC;AAED;;GAEG;AACH,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEtC"}

package/catalog/integers.js

@@ -0,0 +1,24 @@
+/* @ts-self-types="./integers.d.ts" */
+import * as z from "zod/mini";
+/**
+ * Branded type for 8-bit unsigned integers (0-255)
+ */
+export const u8Schema = z.number().check(z.int(), z.nonnegative(), z.lte(255)).brand("u8");
+/**
+ * Branded type for 53-bit unsigned integers (JavaScript's MAX_SAFE_INTEGER)
+ * This represents the maximum safe integer in JavaScript (2^53 - 1)
+ */
+export const u53Schema = z.number().check(z.int(), z.nonnegative(), z.lte(Number.MAX_SAFE_INTEGER)).brand("u53");
+/**
+ * Convenience function to create a u8 value
+ */
+export function u8(value) {
+    return u8Schema.parse(value);
+}
+/**
+ * Convenience function to create a u53 value
+ */
+export function u53(value) {
+    return u53Schema.parse(value);
+}
+//# sourceMappingURL=integers.js.map

package/catalog/integers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"integers.js","sourceRoot":"","sources":["../../src/catalog/integers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,UAAU,CAAC;AAE9B;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;AAK3F;;;GAGG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,gBAAgB,CAAC,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAKjH;;GAEG;AACH,MAAM,UAAU,EAAE,CAAC,KAAa;IAC/B,OAAO,QAAQ,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC9B,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,GAAG,CAAC,KAAa;IAChC,OAAO,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AAC/B,CAAC","sourcesContent":["import * as z from \"zod/mini\";\n\n/**\n * Branded type for 8-bit unsigned integers (0-255)\n */\nexport const u8Schema = z.number().check(z.int(), z.nonnegative(), z.lte(255)).brand(\"u8\");\n\n/** Branded 8-bit unsigned integer (0-255). */\nexport type U8 = z.infer<typeof u8Schema>;\n\n/**\n * Branded type for 53-bit unsigned integers (JavaScript's MAX_SAFE_INTEGER)\n * This represents the maximum safe integer in JavaScript (2^53 - 1)\n */\nexport const u53Schema = z.number().check(z.int(), z.nonnegative(), z.lte(Number.MAX_SAFE_INTEGER)).brand(\"u53\");\n\n/** Branded unsigned integer up to JavaScript's MAX_SAFE_INTEGER (2^53 - 1). */\nexport type U53 = z.infer<typeof u53Schema>;\n\n/**\n * Convenience function to create a u8 value\n */\nexport function u8(value: number): U8 {\n\treturn u8Schema.parse(value);\n}\n\n/**\n * Convenience function to create a u53 value\n */\nexport function u53(value: number): U53 {\n\treturn u53Schema.parse(value);\n}\n"]}

package/catalog/priority.d.ts

@@ -0,0 +1,7 @@
+/** Delivery priority per track kind; higher is sent first. */
+export declare const PRIORITY: {
+    readonly catalog: 100;
+    readonly audio: 80;
+    readonly video: 60;
+};
+//# sourceMappingURL=priority.d.ts.map

package/catalog/priority.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority.d.ts","sourceRoot":"","sources":["../../src/catalog/priority.ts"],"names":[],"mappings":"AACA,8DAA8D;AAC9D,eAAO,MAAM,QAAQ;aACpB,OAAO,EAAE,GAAG;aACZ,KAAK,EAAE,EAAE;aACT,KAAK,EAAE,EAAE;CACA,CAAC"}

package/catalog/priority.js

@@ -0,0 +1,9 @@
+/* @ts-self-types="./priority.d.ts" */
+// Defined in one place so the relative ordering stays consistent.
+/** Delivery priority per track kind; higher is sent first. */
+export const PRIORITY = {
+    catalog: 100,
+    audio: 80,
+    video: 60,
+};
+//# sourceMappingURL=priority.js.map

package/catalog/priority.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"priority.js","sourceRoot":"","sources":["../../src/catalog/priority.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,8DAA8D;AAC9D,MAAM,CAAC,MAAM,QAAQ,GAAG;IACvB,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,EAAE;IACT,KAAK,EAAE,EAAE;CACA,CAAC","sourcesContent":["// Defined in one place so the relative ordering stays consistent.\n/** Delivery priority per track kind; higher is sent first. */\nexport const PRIORITY = {\n\tcatalog: 100,\n\taudio: 80,\n\tvideo: 60,\n} as const;\n"]}