cursedbelt 2.8.0 → 3.0.0

package/dist/server/storage/videoDerivativeKeys.d.ts

@@ -1,128 +0,0 @@
-/**
- * ── The NAMES of every video derivative binary-server writes ────────────────────────────
- *
- * A derivative's key is COMPUTED from its source's, never bookkept. A consumer finds one by
- * deriving the name and asking `/meta` whether it exists yet, so there is no webhook, no job
- * id, no schema column and nothing to reconcile: the absence of the object IS the "not ready
- * yet" state, and it answers itself.
- *
- * ── 🔴 Why these live in cursedbelt ─────────────────────────────────────────────────────
- * Owner, 2026-08-14: *"Make it in cb because many apps may move to cloudflare and share the
- * logic."* This contract is the seam between three repos that must never disagree —
- * binary-server WRITES these names, `@satellites/satellite-kit` re-exports them for the
- * satellite apps, and cursedbelt's own `binaryServerStore` mints the tokens that authorize
- * them. A second hand-typed `${key}.web.mp4` anywhere in that triangle is a silent
- * no-preview the day binary-server renames anything, and that has already happened once:
- * `apps/collections` had the contract and `apps/family` shipped video without it, so family
- * had no faststart stream, no scrub previews and no processing state at all.
- *
- * 🔴 What is shared here is the STRATEGY, never the media. Nothing in this module can resolve
- * a stored object — every function is a pure string transform over a key the caller already
- * holds. Each app is its own binary-server tenant with its own signing key, so family cannot
- * reach a collections object through anything here, and that must stay true.
- *
- * ── 🔴 This is NOT the `fs*` keyspace in `./types.ts`, and they must not be merged ───────
- * `fsHlsMasterKey(owner, id)` → `hls/<owner>/<id>/master.m3u8` and its siblings address the
- * FileCatalogue: a caller that holds an owner and an item id, whose derivatives live in their
- * own top-level namespaces. This module addresses a caller that holds a binary-server KEY and
- * derives sibling names from it, which is what makes "ask /meta for a name you computed" work
- * with no catalogue at all.
- *
- * Two consumers, two shapes, both correct:
- *   · `fs*` — cursedbelt's own FileCatalogue / the `library` transcode strategy.
- *   · this module — binary-server's derivative convention, used by the satellite apps.
- *
- * Collapsing either into the other renames objects that already exist in the store, and a
- * renamed derivative is indistinguishable from an unbuilt one (absence is the "not ready"
- * state) — so the visible result is every video in the fleet losing its previews at once,
- * silently, with the rebuild costing hours of ffmpeg.
- */
-/**
- * The browser-playable remux: the same pictures with the index at the front.
- *
- * A phone MP4/MOV stores its `moov` index at the END, and a browser cannot decode frame one
- * until it has that index — so it downloads the whole file first. Measured on the owner's
- * 90,339,606-byte upload (2026-08-13): the index began at byte 90,305,514, 99.96% of the way
- * in. That is the "videos stay on a spinner for minutes" report, and no amount of Range
- * support, caching or edge tuning fixes it. A `+faststart` remux is a STREAM COPY for
- * h264+aac sources, which is what phones produce: no re-encode, nothing lost.
- */
-/**
- * ── 🔴 THE ENCODER GENERATION IN THE NAME (2026-09-09) ──────────────────────────────────
- *
- * binary-server rebuilds every video derivative when its encoder improves, and a rebuild
- * used to write **the same filename with different bytes**. That silently cancels out an
- * `immutable` cache lifetime — a browser told `immutable` never re-checks, for a year, and
- * **that cannot be revoked for a copy already on somebody's phone**. So the owner's decision
- * (A, 2026-09-09) is that new bytes get a new address: `clip.web.mp4` → `clip.g2.web.mp4`.
- *
- * 🔴 **Generation 1 is UNTAGGED and always will be.** Every derivative in the store today is
- * at the untagged name; tagging generation 1 would orphan all of them and re-encode the
- * whole library for byte-identical output. Untagged is not a legacy case — it IS generation
- * one.
- *
- * 🔴 **This constant must match binary-server's `VIDEO_ENCODER_GENERATION`**
- * (`src/media/encoderGeneration.ts`). They are in different repos and neither can import the
- * other, so binary-server carries a test that goes RED the moment somebody bumps its number,
- * naming this file. If you are here because of that test: bump this in the same commit, and
- * remember that `notes`, `collections` and `family` all reach these names through
- * `@satellites/satellite-kit/video-derivatives`. Getting it wrong is not an error anywhere —
- * it is a 404 that reads as "no preview available", on every video.
- */
-export declare const VIDEO_KEY_GENERATION = 1;
-/** The generation tag a derivative's name carries. Empty for generation 1 — see above. */
-export declare const videoGenerationTag: (generation?: number) => string;
-export declare const webPlayableKeyFor: (key: string, generation?: number) => string;
-/** The scrub-preview sprite sheet — tiled frames from across the clip, as one JPEG. */
-export declare const spriteKeyFor: (key: string) => string;
-/** The WebVTT mapping a playhead position onto a tile of {@link spriteKeyFor}. */
-export declare const spriteVttKeyFor: (key: string) => string;
-/**
- * The single still a gallery draws on a tile.
- *
- * Deliberately the SAME name a still photograph's thumbnail gets, so a consumer has one rule
- * — *the tile for anything is `<key>.thumb.jpg`, and its absence means not ready* — rather
- * than one rule per media kind. The sprite sheet is not a substitute: it is a GRID, so drawing
- * it on a tile shows a contact sheet, and using one cell means every consumer carries the
- * VTT's geometry in order to crop it.
- */
-export declare const posterKeyFor: (key: string) => string;
-/**
- * ── The HLS tree: `<key>.hls/` ──────────────────────────────────────────────────────────
- *
- * 🔴 ONE container, and the trailing name is load-bearing. binary-server's `storage.ts`
- * co-locates a container's whole subtree under a single shard and `removeContainer()` wipes it
- * atomically — so a ladder that is one container is deleted, migrated and reconciled as one
- * thing. Segments scattered under sibling keys would be none of those, and orphaning half a
- * ladder is worse than having none: the master would keep advertising rungs whose segments
- * 404, which a player retries rather than falls back from.
- *
- * 🔴 Why HLS at all, now that Range works. The Range bug (an edge Worker answering 200 + the
- * whole 209 MB to a ranged read) was fixed 2026-08-14 and is NOT what this is for. A single
- * progressive MP4, however well served, cannot ADAPT: a weak cell connection stalls on a
- * 23 Mbps master instead of dropping to a lower rung. Each segment is also a small object that
- * caches WHOLE at the edge, which sidesteps both the 512 MiB single-entry ceiling and the
- * segment-assembly machinery that exists to work around it for big films.
- */
-export declare const hlsPrefixFor: (key: string, generation?: number) => string;
-/**
- * The playlist a player is pointed at — the one object whose presence means "the ladder is
- * ready". It is written LAST, after every rung, so a consumer that finds it can trust that
- * what it names exists. Absence is normal and means "play the faststart remux".
- */
-export declare const hlsMasterKeyFor: (key: string, generation?: number) => string;
-/**
- * Every derivative suffix, for the "is this key itself a derivative" question.
- *
- * 🔴 Load-bearing in three directions, each of which has already cost something:
- *  1. A derivative must never become the source of another, or a sweep builds
- *     `clip.web.mp4.web.mp4` and then `…web.mp4.web.mp4.web.mp4`, forever.
- *  2. A sweep must not count a derivative as work still owed, or the backlog is permanently
- *     non-empty and ffmpeg re-runs on every pass.
- *  3. A duplicate scan must not propose a file against its own derivative. They share a title
- *     by construction, so every video would pair with its own remux and a review queue would
- *     contain nothing else.
- */
-export declare const DERIVATIVE_SUFFIXES: readonly [".web.mp4", ".sprite.jpg", ".sprite.vtt", ".thumb.jpg", ".web.jpg"];
-export declare const isDerivativeKey: (key: string) => boolean;
-//# sourceMappingURL=videoDerivativeKeys.d.ts.map

package/dist/server/storage/videoDerivativeKeys.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"videoDerivativeKeys.d.ts","sourceRoot":"","sources":["../../../src/server/storage/videoDerivativeKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,0FAA0F;AAC1F,eAAO,MAAM,kBAAkB,GAAI,aAAY,MAA6B,KAAG,MACtC,CAAC;AAE1C,eAAO,MAAM,iBAAiB,GAC7B,KAAK,MAAM,EACX,aAAY,MAA6B,KACvC,MAA2D,CAAC;AAE/D,uFAAuF;AACvF,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAA6B,CAAC;AAEzE,kFAAkF;AAClF,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,MAA6B,CAAC;AAE5E;;;;;;;;GAQG;AACH,eAAO,MAAM,YAAY,GAAI,KAAK,MAAM,KAAG,MAA4B,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,eAAO,MAAM,YAAY,GACxB,KAAK,MAAM,EACX,aAAY,MAA6B,KACvC,MAAwD,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,eAAe,GAC3B,KAAK,MAAM,EACX,aAAY,MAA6B,KACvC,MAAuD,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,+EAMtB,CAAC;AAiBX,eAAO,MAAM,eAAe,GAAI,KAAK,MAAM,KAAG,OAIhB,CAAC"}

package/dist/server/storage/videoDerivativeKeys.js

@@ -1,150 +0,0 @@
-/**
- * ── The NAMES of every video derivative binary-server writes ────────────────────────────
- *
- * A derivative's key is COMPUTED from its source's, never bookkept. A consumer finds one by
- * deriving the name and asking `/meta` whether it exists yet, so there is no webhook, no job
- * id, no schema column and nothing to reconcile: the absence of the object IS the "not ready
- * yet" state, and it answers itself.
- *
- * ── 🔴 Why these live in cursedbelt ─────────────────────────────────────────────────────
- * Owner, 2026-08-14: *"Make it in cb because many apps may move to cloudflare and share the
- * logic."* This contract is the seam between three repos that must never disagree —
- * binary-server WRITES these names, `@satellites/satellite-kit` re-exports them for the
- * satellite apps, and cursedbelt's own `binaryServerStore` mints the tokens that authorize
- * them. A second hand-typed `${key}.web.mp4` anywhere in that triangle is a silent
- * no-preview the day binary-server renames anything, and that has already happened once:
- * `apps/collections` had the contract and `apps/family` shipped video without it, so family
- * had no faststart stream, no scrub previews and no processing state at all.
- *
- * 🔴 What is shared here is the STRATEGY, never the media. Nothing in this module can resolve
- * a stored object — every function is a pure string transform over a key the caller already
- * holds. Each app is its own binary-server tenant with its own signing key, so family cannot
- * reach a collections object through anything here, and that must stay true.
- *
- * ── 🔴 This is NOT the `fs*` keyspace in `./types.ts`, and they must not be merged ───────
- * `fsHlsMasterKey(owner, id)` → `hls/<owner>/<id>/master.m3u8` and its siblings address the
- * FileCatalogue: a caller that holds an owner and an item id, whose derivatives live in their
- * own top-level namespaces. This module addresses a caller that holds a binary-server KEY and
- * derives sibling names from it, which is what makes "ask /meta for a name you computed" work
- * with no catalogue at all.
- *
- * Two consumers, two shapes, both correct:
- *   · `fs*` — cursedbelt's own FileCatalogue / the `library` transcode strategy.
- *   · this module — binary-server's derivative convention, used by the satellite apps.
- *
- * Collapsing either into the other renames objects that already exist in the store, and a
- * renamed derivative is indistinguishable from an unbuilt one (absence is the "not ready"
- * state) — so the visible result is every video in the fleet losing its previews at once,
- * silently, with the rebuild costing hours of ffmpeg.
- */
-/**
- * The browser-playable remux: the same pictures with the index at the front.
- *
- * A phone MP4/MOV stores its `moov` index at the END, and a browser cannot decode frame one
- * until it has that index — so it downloads the whole file first. Measured on the owner's
- * 90,339,606-byte upload (2026-08-13): the index began at byte 90,305,514, 99.96% of the way
- * in. That is the "videos stay on a spinner for minutes" report, and no amount of Range
- * support, caching or edge tuning fixes it. A `+faststart` remux is a STREAM COPY for
- * h264+aac sources, which is what phones produce: no re-encode, nothing lost.
- */
-/**
- * ── 🔴 THE ENCODER GENERATION IN THE NAME (2026-09-09) ──────────────────────────────────
- *
- * binary-server rebuilds every video derivative when its encoder improves, and a rebuild
- * used to write **the same filename with different bytes**. That silently cancels out an
- * `immutable` cache lifetime — a browser told `immutable` never re-checks, for a year, and
- * **that cannot be revoked for a copy already on somebody's phone**. So the owner's decision
- * (A, 2026-09-09) is that new bytes get a new address: `clip.web.mp4` → `clip.g2.web.mp4`.
- *
- * 🔴 **Generation 1 is UNTAGGED and always will be.** Every derivative in the store today is
- * at the untagged name; tagging generation 1 would orphan all of them and re-encode the
- * whole library for byte-identical output. Untagged is not a legacy case — it IS generation
- * one.
- *
- * 🔴 **This constant must match binary-server's `VIDEO_ENCODER_GENERATION`**
- * (`src/media/encoderGeneration.ts`). They are in different repos and neither can import the
- * other, so binary-server carries a test that goes RED the moment somebody bumps its number,
- * naming this file. If you are here because of that test: bump this in the same commit, and
- * remember that `notes`, `collections` and `family` all reach these names through
- * `@satellites/satellite-kit/video-derivatives`. Getting it wrong is not an error anywhere —
- * it is a 404 that reads as "no preview available", on every video.
- */
-export const VIDEO_KEY_GENERATION = 1;
-/** The generation tag a derivative's name carries. Empty for generation 1 — see above. */
-export const videoGenerationTag = (generation = VIDEO_KEY_GENERATION) => generation <= 1 ? "" : `.g${generation}`;
-export const webPlayableKeyFor = (key, generation = VIDEO_KEY_GENERATION) => `${key}${videoGenerationTag(generation)}.web.mp4`;
-/** The scrub-preview sprite sheet — tiled frames from across the clip, as one JPEG. */
-export const spriteKeyFor = (key) => `${key}.sprite.jpg`;
-/** The WebVTT mapping a playhead position onto a tile of {@link spriteKeyFor}. */
-export const spriteVttKeyFor = (key) => `${key}.sprite.vtt`;
-/**
- * The single still a gallery draws on a tile.
- *
- * Deliberately the SAME name a still photograph's thumbnail gets, so a consumer has one rule
- * — *the tile for anything is `<key>.thumb.jpg`, and its absence means not ready* — rather
- * than one rule per media kind. The sprite sheet is not a substitute: it is a GRID, so drawing
- * it on a tile shows a contact sheet, and using one cell means every consumer carries the
- * VTT's geometry in order to crop it.
- */
-export const posterKeyFor = (key) => `${key}.thumb.jpg`;
-/**
- * ── The HLS tree: `<key>.hls/` ──────────────────────────────────────────────────────────
- *
- * 🔴 ONE container, and the trailing name is load-bearing. binary-server's `storage.ts`
- * co-locates a container's whole subtree under a single shard and `removeContainer()` wipes it
- * atomically — so a ladder that is one container is deleted, migrated and reconciled as one
- * thing. Segments scattered under sibling keys would be none of those, and orphaning half a
- * ladder is worse than having none: the master would keep advertising rungs whose segments
- * 404, which a player retries rather than falls back from.
- *
- * 🔴 Why HLS at all, now that Range works. The Range bug (an edge Worker answering 200 + the
- * whole 209 MB to a ranged read) was fixed 2026-08-14 and is NOT what this is for. A single
- * progressive MP4, however well served, cannot ADAPT: a weak cell connection stalls on a
- * 23 Mbps master instead of dropping to a lower rung. Each segment is also a small object that
- * caches WHOLE at the edge, which sidesteps both the 512 MiB single-entry ceiling and the
- * segment-assembly machinery that exists to work around it for big films.
- */
-export const hlsPrefixFor = (key, generation = VIDEO_KEY_GENERATION) => `${key}${videoGenerationTag(generation)}.hls/`;
-/**
- * The playlist a player is pointed at — the one object whose presence means "the ladder is
- * ready". It is written LAST, after every rung, so a consumer that finds it can trust that
- * what it names exists. Absence is normal and means "play the faststart remux".
- */
-export const hlsMasterKeyFor = (key, generation = VIDEO_KEY_GENERATION) => `${hlsPrefixFor(key, generation)}master.m3u8`;
-/**
- * Every derivative suffix, for the "is this key itself a derivative" question.
- *
- * 🔴 Load-bearing in three directions, each of which has already cost something:
- *  1. A derivative must never become the source of another, or a sweep builds
- *     `clip.web.mp4.web.mp4` and then `…web.mp4.web.mp4.web.mp4`, forever.
- *  2. A sweep must not count a derivative as work still owed, or the backlog is permanently
- *     non-empty and ffmpeg re-runs on every pass.
- *  3. A duplicate scan must not propose a file against its own derivative. They share a title
- *     by construction, so every video would pair with its own remux and a review queue would
- *     contain nothing else.
- */
-export const DERIVATIVE_SUFFIXES = [
-    ".web.mp4",
-    ".sprite.jpg",
-    ".sprite.vtt",
-    ".thumb.jpg",
-    ".web.jpg",
-];
-/**
- * Is this key something binary-server DERIVED rather than something a person uploaded?
- *
- * The HLS tree is matched by its container segment rather than a suffix, because every object
- * inside it (`master.m3u8`, `720/index.m3u8`, `720/000.ts`) is a derivative and none of them
- * ends in a name from the list above.
- */
-const DERIVATIVE_RE = new RegExp(
-// 🔴 The optional `.g<N>` is the encoder generation a video derivative's name carries
-// (see VIDEO_KEY_GENERATION above). Without it, `clip.g2.web.mp4` reads as a SOURCE — and
-// then a sweep derives `clip.g2.web.mp4.web.mp4` from it, for ever. Built from the suffix
-// list rather than written out, so the two cannot drift apart.
-`(?:\\.g\\d+)?(?:${DERIVATIVE_SUFFIXES.map((x) => x.replace(/[.*+?^${}()|[\]\\]/g, "\\$&")).join("|")})$`);
-export const isDerivativeKey = (key) => DERIVATIVE_RE.test(key) ||
-    key.includes(".hls/") ||
-    /-thumb\.(jpg|webp|png)$/.test(key) ||
-    /\.shot\.\d+\.jpg$/.test(key);
-//# sourceMappingURL=videoDerivativeKeys.js.map

package/dist/server/storage/videoDerivativeKeys.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"videoDerivativeKeys.js","sourceRoot":"","sources":["../../../src/server/storage/videoDerivativeKeys.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AAEH;;;;;;;;;GASG;AACH;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAEtC,0FAA0F;AAC1F,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,aAAqB,oBAAoB,EAAU,EAAE,CACvF,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,KAAK,UAAU,EAAE,CAAC;AAE1C,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAChC,GAAW,EACX,aAAqB,oBAAoB,EAChC,EAAE,CAAC,GAAG,GAAG,GAAG,kBAAkB,CAAC,UAAU,CAAC,UAAU,CAAC;AAE/D,uFAAuF;AACvF,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC;AAEzE,kFAAkF;AAClF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,GAAG,aAAa,CAAC;AAE5E;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,GAAW,EAAU,EAAE,CAAC,GAAG,GAAG,YAAY,CAAC;AAExE;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAC3B,GAAW,EACX,aAAqB,oBAAoB,EAChC,EAAE,CAAC,GAAG,GAAG,GAAG,kBAAkB,CAAC,UAAU,CAAC,OAAO,CAAC;AAE5D;;;;GAIG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC9B,GAAW,EACX,aAAqB,oBAAoB,EAChC,EAAE,CAAC,GAAG,YAAY,CAAC,GAAG,EAAE,UAAU,CAAC,aAAa,CAAC;AAE3D;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG;IAClC,UAAU;IACV,aAAa;IACb,aAAa;IACb,YAAY;IACZ,UAAU;CACD,CAAC;AAEX;;;;;;GAMG;AACH,MAAM,aAAa,GAAG,IAAI,MAAM;AAC/B,sFAAsF;AACtF,0FAA0F;AAC1F,0FAA0F;AAC1F,+DAA+D;AAC/D,mBAAmB,mBAAmB,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CACzG,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,GAAW,EAAW,EAAE,CACvD,aAAa,CAAC,IAAI,CAAC,GAAG,CAAC;IACvB,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC;IACrB,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC;IACnC,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC"}

package/dist/server/storage/videoProcessor.d.ts

@@ -1,31 +0,0 @@
-import type { ProcessingStatus } from '../../core/media';
-import { type MediaStore } from './types';
-export type ProcessProgress = (status: ProcessingStatus, pct: number) => void;
-export type ProcessResult = {
-    status: ProcessingStatus;
-    durationSeconds: number;
-    hasHls: boolean;
-    hasSprite: boolean;
-    hasPoster: boolean;
-};
-export type ProcessOptions = {
-    store: MediaStore;
-    /** Scratch directory for ffmpeg inputs/outputs (cleaned up afterwards). */
-    workDir: string;
-    owner: string;
-    id: string;
-    /** Storage key of the already-persisted raw source. */
-    sourceKey: string;
-    /** HLS rung heights to attempt (clamped to the source height; never upscaled). */
-    ladderHeights?: number[];
-    /**
-     * Poster-only mode for memory-constrained hosts: probe duration + extract a single-frame
-     * poster (cheap, ~tens of MB peak) and skip the heavy re-encode/HLS/sprite work that OOM'd
-     * the 1GB prod box (2026-07-04). The raw source still plays progressively; this only buys a
-     * grid thumbnail + duration. Best-effort — a failed poster still lands the row `ready`.
-     */
-    posterOnly?: boolean;
-    onProgress?: ProcessProgress;
-};
-export declare function processVideo(opts: ProcessOptions): Promise<ProcessResult>;
-//# sourceMappingURL=videoProcessor.d.ts.map

package/dist/server/storage/videoProcessor.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"videoProcessor.d.ts","sourceRoot":"","sources":["../../../src/server/storage/videoProcessor.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAezD,OAAO,EAOL,KAAK,UAAU,EAChB,MAAM,SAAS,CAAC;AAQjB,MAAM,MAAM,eAAe,GAAG,CAAC,MAAM,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,KAAK,IAAI,CAAC;AAE9E,MAAM,MAAM,aAAa,GAAG;IAC1B,MAAM,EAAE,gBAAgB,CAAC;IACzB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,OAAO,CAAC;IAChB,SAAS,EAAE,OAAO,CAAC;IACnB,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,2EAA2E;IAC3E,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,uDAAuD;IACvD,SAAS,EAAE,MAAM,CAAC;IAClB,kFAAkF;IAClF,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,eAAe,CAAC;CAC9B,CAAC;AAoDF,wBAAsB,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,aAAa,CAAC,CAmH/E"}

package/dist/server/storage/videoProcessor.js

@@ -1,149 +0,0 @@
-import { mkdir, readdir, rm } from 'node:fs/promises';
-import path from 'node:path';
-import { buildSpriteVtt, canStreamCopy, faststartArgs, hlsLadderArgs, isFfmpegAvailable, LIBRARY_CRF, planSprite, posterArgs, probeVideoStream, resolveLadder, runFfmpegProgress, spriteArgs, } from '../media-bun';
-import { fsHlsFileKey, fsHlsMasterKey, fsMp4Key, fsPosterKey, fsSpriteKey, fsVttKey, } from './types';
-// Stream a produced local file into the store under `key` (no full heap copy).
-async function uploadFile(store, localPath, key, mime) {
-    const file = Bun.file(localPath);
-    if (!(await file.exists()))
-        return;
-    await store.putStream(key, file.stream(), mime, { contentLength: file.size });
-}
-// Recursively upload an HLS output tree (master.m3u8 + <height>/playlist.m3u8 + segments).
-async function uploadHlsTree(store, dir, owner, id) {
-    const walk = async (rel) => {
-        const entries = await readdir(path.join(dir, rel), { withFileTypes: true });
-        for (const e of entries) {
-            const childRel = rel ? path.join(rel, e.name) : e.name;
-            if (e.isDirectory()) {
-                await walk(childRel);
-            }
-            else {
-                const mime = e.name.endsWith('.m3u8') ? 'application/vnd.apple.mpegurl' : 'video/mp2t';
-                await uploadFile(store, path.join(dir, childRel), fsHlsFileKey(owner, id, childRel), mime);
-            }
-        }
-    };
-    await walk('');
-}
-// Extract a single JPEG poster, robust to very short clips: seek ~1s in to skip black intros, but
-// clamp the seek inside a short clip and fall back to frame 0 if the seek lands past EOF (which
-// otherwise decodes no frame and silently produces no poster — the 2026-07-04 `0:00` .mov case).
-async function extractPoster(inPath, outPath, durationSeconds) {
-    let stderrTail = '';
-    const onError = (tail) => {
-        stderrTail = tail;
-    };
-    const at = durationSeconds > 1.2 ? 1 : 0;
-    if (await runFfmpegProgress(posterArgs(inPath, outPath, at), 0, undefined, onError))
-        return true;
-    if (at !== 0 && (await runFfmpegProgress(posterArgs(inPath, outPath, 0), 0, undefined, onError)))
-        return true;
-    // Real poster failures AND the malformed/short-clip fixtures test suites deliberately
-    // feed ffmpeg land here — stderr alone can't tell them apart, so the message is tagged
-    // `[expected-in-tests]` (grep-filterable) instead of silenced, so a real prod
-    // regression still surfaces.
-    console.warn(`[videoProcessor][expected-in-tests] poster extraction failed (duration=${durationSeconds}s): ${stderrTail.slice(-400)}`);
-    return false;
-}
-export async function processVideo(opts) {
-    const { store, workDir, owner, id, sourceKey, onProgress } = opts;
-    const report = (s, p) => onProgress?.(s, p);
-    const idle = {
-        status: 'ready',
-        durationSeconds: 0,
-        hasHls: false,
-        hasSprite: false,
-        hasPoster: false,
-    };
-    if (!(await isFfmpegAvailable())) {
-        report('ready', 100);
-        return idle;
-    }
-    const jobDir = path.join(workDir, owner, id);
-    await mkdir(jobDir, { recursive: true });
-    try {
-        report('processing', 1);
-        // 1. Materialise the source locally for ffmpeg (use the backend's own path if local).
-        let srcPath = (await store.localPath?.(sourceKey)) ?? null;
-        if (!srcPath) {
-            const bytes = await store.get(sourceKey);
-            if (!bytes)
-                throw new Error(`source missing: ${sourceKey}`);
-            srcPath = path.join(jobDir, 'source.bin');
-            await Bun.write(srcPath, bytes);
-        }
-        const probe = await probeVideoStream(srcPath);
-        const durationSeconds = probe.duration;
-        // Poster-only mode: extract one frame + report ready. No re-encode, no HLS, no sprite —
-        // the memory-heavy steps that OOM'd the 1GB host stay off; the raw source plays as-is.
-        if (opts.posterOnly) {
-            report('processing', 50);
-            const posterPath = path.join(jobDir, 'poster.jpg');
-            const okPoster = await extractPoster(srcPath, posterPath, durationSeconds);
-            if (okPoster)
-                await uploadFile(store, posterPath, fsPosterKey(owner, id), 'image/jpeg');
-            report('ready', 100);
-            return {
-                status: 'ready',
-                durationSeconds,
-                hasHls: false,
-                hasSprite: false,
-                hasPoster: okPoster,
-            };
-        }
-        // 2. Faststart MP4 — the progressive Range fallback (streamUrl). Stream-copy when the
-        //    source is already web-safe, else re-encode to the shared web-safe ladder.
-        const mp4Path = path.join(jobDir, 'out.mp4');
-        const okMp4 = await runFfmpegProgress(faststartArgs(srcPath, mp4Path, { copy: canStreamCopy(probe) }), durationSeconds, (pct) => report('processing', Math.round(pct * 0.4)));
-        if (okMp4)
-            await uploadFile(store, mp4Path, fsMp4Key(owner, id), 'video/mp4');
-        // ffmpeg operates on the faststart output when it exists, else the raw source.
-        const encodeInput = okMp4 ? mp4Path : srcPath;
-        // 3. HLS ladder — the adaptive path (hlsUrl).
-        const heights = resolveLadder(opts.ladderHeights ?? [480, 720, 1080], probe.height);
-        const hlsDir = path.join(jobDir, 'hls');
-        await mkdir(hlsDir, { recursive: true });
-        const okHls = await runFfmpegProgress(hlsLadderArgs(encodeInput, hlsDir, {
-            heights,
-            crf: Number(LIBRARY_CRF),
-            hasAudio: probe.hasAudio,
-        }), durationSeconds, (pct) => report('processing', 40 + Math.round(pct * 0.5)));
-        if (okHls)
-            await uploadHlsTree(store, hlsDir, owner, id);
-        // 4. Poster (frame ~1s in).
-        report('processing', 92);
-        const posterPath = path.join(jobDir, 'poster.jpg');
-        const okPoster = await extractPoster(encodeInput, posterPath, durationSeconds);
-        if (okPoster)
-            await uploadFile(store, posterPath, fsPosterKey(owner, id), 'image/jpeg');
-        // 5. Sprite sheet + WebVTT scrub track.
-        report('processing', 96);
-        let hasSprite = false;
-        if (durationSeconds > 0) {
-            const plan = planSprite(durationSeconds, 5, probe.width, probe.height);
-            const spritePath = path.join(jobDir, 'sprites.jpg');
-            if (await runFfmpegProgress(spriteArgs(encodeInput, spritePath, plan), 0)) {
-                await uploadFile(store, spritePath, fsSpriteKey(owner, id), 'image/jpeg');
-                await store.put(fsVttKey(owner, id), new TextEncoder().encode(buildSpriteVtt(plan, 'sprites.jpg')), 'text/vtt');
-                hasSprite = true;
-            }
-        }
-        report('ready', 100);
-        return {
-            status: 'ready',
-            durationSeconds,
-            hasHls: okHls && (await store.stat(fsHlsMasterKey(owner, id))) !== null,
-            hasSprite,
-            hasPoster: okPoster,
-        };
-    }
-    catch {
-        report('failed', 0);
-        return { ...idle, status: 'failed' };
-    }
-    finally {
-        await rm(jobDir, { recursive: true, force: true }).catch(() => { });
-    }
-}
-//# sourceMappingURL=videoProcessor.js.map

package/dist/server/storage/videoProcessor.js.map

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

package/dist/server/stream/cdcBridge.d.ts

@@ -1,68 +0,0 @@
-/**
- * CDC → server push (01 §2.6 → 03 §3.2).
- *
- * The mutation stream already says "a row changed" independently of any UI
- * event; this turns that into the client-visible invalidation the two-tier
- * subscription model (03 §6.2) pulls against. The client's dirty ledger cannot
- * mark a port dirty for a change it never heard about, so without this bridge
- * the ledger only ever reflects changes the same tab made.
- *
- * Records are published per INSTANCE rather than app-wide. A domain maps to the
- * engine that owns it, and the manifest already names every instance of that
- * engine — so a knowledge-domain write invalidates the knowledge instances and
- * nothing else. Fanning every write to every stream would work, and would make
- * `over-invalidation-risk` (04 V4) a runtime certainty rather than a
- * verifiable defect.
- */
-import type { DomainName } from 'cwip/domains';
-import type { MutationRecord, StorageProvider } from 'cwip/storage';
-import type { JobBroker } from '../drivers';
-import type { EffectiveManifest } from '../../verify/types';
-import type { ServerPushHub, Unsubscribe } from './serverPush';
-/**
- * Which engine owns which domain file — re-exported from `core/domainOwners`,
- * where it lives so the CLIENT tier can read it without importing server code
- * (04 §5c's DevStudio needs the same map).
- */
-import { DOMAIN_OWNER_ENGINE } from '../../core/domainOwners';
-export { DOMAIN_OWNER_ENGINE };
-export interface CdcBridgeOptions {
-    storage: StorageProvider;
-    hub: ServerPushHub;
-    manifest: EffectiveManifest;
-    /**
-     * Domains to tap. Defaults to the domains the manifest's engines own — a
-     * handle that was never injected would otherwise throw on first `domain()`.
-     */
-    domains?: readonly DomainName[];
-}
-/** The payload shape clients receive on the `cdc` event. */
-export interface CdcPushPayload {
-    domain: string;
-    table: string;
-    op: MutationRecord['op'];
-    rowId: string;
-    rev: number;
-    at: string;
-}
-/**
- * Tap every relevant domain's CDC stream and republish onto the push hub.
- * Returns one handle that detaches all of them.
- */
-export declare const bridgeCdcToPush: (options: CdcBridgeOptions) => Unsubscribe;
-export interface JobPushOptions {
-    hub: ServerPushHub;
-    jobId: string;
-    tenantId: string;
-    instanceId?: string;
-}
-/**
- * Publish a job's terminal result on the push hub.
- *
- * Deliberately a helper rather than a blanket broker tap: `onComplete` is a
- * per-id subscription (03 §7.3), so the route that enqueued a job is the one
- * that knows which tenant and instance it belongs to. Registering it here keeps
- * the tenant scoping honest — a broker-wide tap would have to guess.
- */
-export declare const publishJobCompletion: (broker: JobBroker, options: JobPushOptions) => void;
-//# sourceMappingURL=cdcBridge.d.ts.map

package/dist/server/stream/cdcBridge.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"cdcBridge.d.ts","sourceRoot":"","sources":["../../../src/server/stream/cdcBridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE/D;;;;GAIG;AACH,OAAO,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAE9D,OAAO,EAAE,mBAAmB,EAAE,CAAC;AAE/B,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,eAAe,CAAC;IACzB,GAAG,EAAE,aAAa,CAAC;IACnB,QAAQ,EAAE,iBAAiB,CAAC;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;CACjC;AAED,4DAA4D;AAC5D,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,cAAc,CAAC,IAAI,CAAC,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,EAAE,MAAM,CAAC;CACZ;AAED;;;GAGG;AACH,eAAO,MAAM,eAAe,GAAI,SAAS,gBAAgB,KAAG,WA2D3D,CAAC;AAIF,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,aAAa,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,oBAAoB,GAAI,QAAQ,SAAS,EAAE,SAAS,cAAc,KAAG,IASjF,CAAC"}

package/dist/server/stream/cdcBridge.js

@@ -1,82 +0,0 @@
-/**
- * Which engine owns which domain file — re-exported from `core/domainOwners`,
- * where it lives so the CLIENT tier can read it without importing server code
- * (04 §5c's DevStudio needs the same map).
- */
-import { DOMAIN_OWNER_ENGINE } from '../../core/domainOwners';
-export { DOMAIN_OWNER_ENGINE };
-/**
- * Tap every relevant domain's CDC stream and republish onto the push hub.
- * Returns one handle that detaches all of them.
- */
-export const bridgeCdcToPush = (options) => {
-    const { storage, hub, manifest } = options;
-    const engines = new Set(manifest.engines);
-    const declared = options.domains !== undefined;
-    const domains = options.domains ??
-        Object.keys(DOMAIN_OWNER_ENGINE).filter((domain) => engines.has(DOMAIN_OWNER_ENGINE[domain]));
-    /** instance ids per domain, resolved once — this runs on every write. */
-    const targets = new Map();
-    for (const domain of domains) {
-        const engine = DOMAIN_OWNER_ENGINE[domain];
-        targets.set(domain, manifest.instances.filter((instance) => instance.engine === engine).map((instance) => instance.id));
-    }
-    const handles = [];
-    for (const domain of domains) {
-        const instanceIds = targets.get(domain) ?? [];
-        if (instanceIds.length === 0)
-            continue;
-        /*
-         * An INFERRED domain with no injected handle is skipped; a DECLARED one
-         * throws. The asymmetry is the point: an app running `knowledge` without a
-         * search tier should boot (its derived index simply does not exist — 01
-         * §2.3), whereas a host that explicitly asked to tap `search` and forgot to
-         * inject its handle has a bug that must not be swallowed.
-         */
-        let handle;
-        try {
-            handle = storage.domain(domain);
-        }
-        catch (error) {
-            if (declared)
-                throw error;
-            continue;
-        }
-        const unsubscribe = handle.onMutation((record) => {
-            const data = {
-                domain: record.domain,
-                table: record.table,
-                op: record.op,
-                rowId: record.rowId,
-                rev: record.rev,
-                at: record.at,
-            };
-            for (const instanceId of instanceIds)
-                hub.publish({ event: 'cdc', data, instanceId, tenantId: record.tenantId });
-        });
-        handles.push(unsubscribe);
-    }
-    return () => {
-        for (const handle of handles.splice(0))
-            handle();
-    };
-};
-/**
- * Publish a job's terminal result on the push hub.
- *
- * Deliberately a helper rather than a blanket broker tap: `onComplete` is a
- * per-id subscription (03 §7.3), so the route that enqueued a job is the one
- * that knows which tenant and instance it belongs to. Registering it here keeps
- * the tenant scoping honest — a broker-wide tap would have to guess.
- */
-export const publishJobCompletion = (broker, options) => {
-    broker.onComplete(options.jobId, (result) => {
-        options.hub.publish({
-            event: 'job',
-            data: { jobId: result.jobId, ok: result.ok, error: result.error },
-            instanceId: options.instanceId,
-            tenantId: options.tenantId,
-        });
-    });
-};
-//# sourceMappingURL=cdcBridge.js.map