@jtdigital/renderbox-sdk 0.2.0 → 0.4.0

package/README.md

@@ -1,81 +1,161 @@
 # @jtdigital/renderbox-sdk
 
 Typed TypeScript SDK for [renderbox](https://renderbox.dev) video processing.
-Compose a video / audio / AI pipeline with a phantom-typed graph builder, then
-turn it into a job message ready to submit to a renderbox engine.
+You describe a pipeline as a graph of sort-typed streams; renderbox's GPU/CPU
+workers run it. The SDK builds the graph and the job message — it does **not**
+process video itself.
 
 ```bash
 npm install @jtdigital/renderbox-sdk
 ```
 
-## Usage
+## Building a pipeline
 
-### With a recipe
+Open inputs, chain operations on the returned streams, attach outputs:
 
 ```ts
-import { faceRedact, buildJob } from '@jtdigital/renderbox-sdk';
-
-// a recipe returns a complete GraphBuilder
-const graph = faceRedact('input.mp4', 'redacted.mp4');
-
-const job = buildJob({
-  jobId: 'job-123',
-  userId: 'user-1',
-  tenantId: 'my-tenant',
-  graph,
-  inputFiles: [
-    { s3_key: 'uploads/clip.mp4', filename: 'input.mp4', content_type: 'video/mp4' },
-  ],
-  output: { bucket: 'my-bucket', key: 'out/job-123.mp4', format: 'mp4' },
-});
-// `job` is a plain JobMessage — publish it to your renderbox engine over AMQP,
-// then consume ProgressMessage / CompletionMessage from your result queue.
+import { graph } from '@jtdigital/renderbox-sdk';
+
+const g = graph();
+const [v, a] = g.open('in.mp4');               // [VideoStream, AudioStream]
+
+const out = v.scale({ w: 1280, h: 720 })       // ops are methods → autocomplete
+             .fade({ type: 'in', d: 1 });
+
+g.write('out.mp4', out, a);
 ```
 
-### With the low-level DSL
+Streams are sort-typed: `VideoStream` exposes video ops, `AudioStream` audio
+ops, `DetectionStream` tracking and filtering. A sort mismatch (piping audio
+into a video op) is a **compile error**, not a runtime one.
+
+### Detection → tracking → redaction
 
 ```ts
-import { file, sinkAv, video, ai, combine } from '@jtdigital/renderbox-sdk';
+const g = graph();
+const [v, a] = g.open('street.mp4');
+
+const faces = v
+  .detect({ model: 'scrfd_10g', threshold: 0.12 })   // VideoStream → DetectionStream
+  .track({ algorithm: 'bytetrack' });                // stable ids across frames
 
-const [v, a] = file('clip.mp4');                       // source → [Video, Audio]
-const dets = ai.detect({ model: 'scrfd_10g' })(v);     // Video → Detection
-const redacted = combine.redact(dets, { mode: 'black' })(v);
-const graph = sinkAv('out.mp4', video.scale({ w: 1280, h: 720 })(redacted), a);
+g.write('redacted.mp4', v.redact(faces, { mode: 'black' }), a);
 ```
 
-Streams are phantom-typed (`Stream<'Video'>`, `Stream<'Audio'>`, …), so a sort
-mismatch is a compile error rather than a runtime one.
+### Multiple inputs
 
-## What's exported
+Combine ops are methods on the first stream; open more inputs on the same graph:
 
-- **Graph** — `GraphBuilder`, `pipe`, the `renderbox-ir` wire types (`GraphJSON`,
-  `OpNode`, `Origin`, `SinkTarget`, …)
-- **Sources / sinks** — `file`, `rtsp`, `mqtt`, `hls`, `camera`, `slot`;
-  `sinkAv`, `sinkVideo`, `sinkAudio`, `sinkDetectionsJsonl`, `sinkTranscript*`,
-  `sinkMqtt`, `sinkHttp`, `outputSlot`
-- **Ops** — the `video` / `audio` / `ai` / `combine` / `source` namespaces
-  (220+ typed operations)
-- **Recipes** — `letterbox`, `snip`, `faceRedact`, `depthBlurPipeline`,
-  `makeSlideshow`
-- **Job / wire** — `buildJob`, `JobMessage`, `ProgressMessage`,
-  `CompletionMessage`, `FailureMessage`
+```ts
+const g = graph();
+const [v, a] = g.open('clip.mp4');
+const [logo]  = g.open('logo.png');
 
-## Maintainers
+g.write('branded.mp4', v.overlay(logo, { x: 20, y: 20 }), a);
+```
 
-Most of `src/` is **generated** from the Rust SDK's op registry — do not edit it
-by hand. Regenerate from the renderbox-sdk repo root:
+### Detections to a data sink
 
-```bash
-cargo run --bin gen-ts-sdk -- ts-sdk
-npm --prefix ts-sdk run build   # dist/ is committed for git/file consumers
+Not every output is a video — write structured results too:
+
+```ts
+const g = graph();
+const [v] = g.open('traffic.mp4');
+const cars = v.detect({ model: 'yolo11x', classes: 'car' }).track({ algorithm: 'bytetrack' });
+g.writeDetections('cars.jsonl', cars);
 ```
 
-The generator owns `package.json`, `tsconfig.json`, `src/index.ts`, and every
-`src/ops/*.ts` — their content lives in `src/bin/gen_ts_sdk.rs`. Only
-`src/recipes/`, `src/job.ts`, `src/protocol.ts`, `tests/`, `README.md`, and
-`LICENSE` are hand-written (the generator re-exports them but never overwrites
-them). Wire-format parity with `renderbox-ir` is enforced by
-`tests/ts_wire_parity.rs` in the parent repo.
+### Recipes
+
+One-liners for common pipelines. `faceRedact`, `depthBlurPipeline`, and
+`makeSlideshow` return a ready `Graph`; `letterbox` and `snip` are stream
+transforms:
+
+```ts
+import { faceRedact, snip } from '@jtdigital/renderbox-sdk';
+
+const g = faceRedact('in.mp4', 'out.mp4', { redactMode: 'blur' });
+
+// or as a step in your own graph:
+const [v] = graph().open('long.mp4');
+const clip = snip(v, 30, 45);   // seconds 30–45
+```
+
+## Running your pipeline on renderbox
+
+A `Graph` is a *description*. To actually render it, submit it as a job to
+renderbox infrastructure — the orchestrator compiles it and dispatches it to a
+GPU or CPU worker, which streams back progress and a completion result.
+
+You reference inputs and outputs **by S3 key**. Two calls give you everything the
+worker needs: `g.json()` is the graph_ir, and `g.io()` is the S3 ⇄ storage
+binding (which object to download for each input, where to upload each output).
+The SDK assigns **no identity** — the job id, tenant, and user come from whoever
+submits (your app/auth, or the managed client).
+
+```ts
+import { graph, type ProgressMessage, type CompletionMessage } from '@jtdigital/renderbox-sdk';
+
+const g = graph();
+const [v, a] = g.open('uploads/raw.mp4');           // reference inputs by S3 key
+g.write('renders/out.mp4', v.scale({ w: 1920, h: 1080 }), a);
+
+const io = g.io();
+// io.inputs  → [{ s3_key: 'uploads/raw.mp4', filename: 'raw.mp4', content_type: 'video/mp4' }]
+// io.outputs → [{ s3_key: 'renders/out.mp4', filename: 'out.mp4' }]
+
+// Assemble the job with identity from YOUR context, then publish over AMQP.
+// (The message omits pipeline_id so the orchestrator routes on graph_ir.)
+const job = {
+  job_id: myApp.newJobId(),      // assigned by your app/DB — not the SDK
+  tenant_id: ctx.tenantId,       // from auth
+  graph_ir: g.json(),
+  input_files: io.inputs,
+};
+await channel.publish(EXCHANGE, ROUTING_KEY, Buffer.from(JSON.stringify(job)));
+```
+
+You never write filenames by hand: `open('uploads/raw.mp4')` gives the graph a
+sandbox-safe basename (`raw.mp4`) and records the S3 key for you — the worker
+rejects slashes in the sandbox, which is why the graph and the binding differ.
+
+Then consume results off your result queue. Progress arrives as the render
+proceeds; completion carries the output location(s):
+
+```ts
+function onProgress(msg: ProgressMessage) {
+  // percent is null until it can be computed (null ≠ 0%)
+  console.log(`${msg.job_id}: ${msg.percent ?? '—'}% @ ${msg.fps} fps`);
+}
+
+function onCompleted(msg: CompletionMessage) {
+  if (msg.status === 'success') {
+    for (const out of msg.outputs) console.log(out.kind, out.s3_key, out.bytes);
+  }
+}
+```
+
+### Prefer a managed client?
+
+[`@jtdigital/renderbox-client`](https://renderbox.dev/sdk/typescript) wraps the
+renderbox SaaS HTTP API — API-key auth, asset upload, job submission, SSE
+progress streaming, and result download — so you can hand it a `Graph` and get a
+finished render back without running your own transport.
+
+## Surface
+
+- **`graph()` → `Graph`** — inputs: `open` / `openVideo` / `openAudio` / `rtsp` /
+  `hls` / `mqtt` / `camera` / `screenCapture` / `slot`, plus synthetic sources.
+  Outputs: `write` / `writeVideo` / `writeAudio` / `writeDetections` /
+  `writeTranscript` / `writeMqtt` / `writeHttp` / `outputSlot`. Terminals:
+  `json()` (graph_ir) and `io()` (S3 ⇄ sandbox bindings).
+- **Stream methods** — 220+ typed operations, one per engine op, on the sort it
+  applies to (`scale`, `crop`, `fade`, `detect`, `track`, `transcribe`,
+  `overlay`, `redact`, `depthBlur`, …).
+- **Recipes** — `letterbox`, `snip`, `faceRedact`, `depthBlurPipeline`,
+  `makeSlideshow`.
+- **Wire types** — `GraphJSON`, `OpNode`, `JobMessage`, `ProgressMessage`,
+  `CompletionMessage`, `FailureMessage`.
 
 ## License
 

package/dist/graph.d.ts

@@ -1,4 +1,6 @@
-import type { SortTag, Stream, ParamValue } from './types.js';
+import type { ParamValue } from './types.js';
+import type { VideoStream, AudioStream, DetectionStream, TranscriptStream } from './streams.js';
+import type { InputFile } from './protocol.js';
 export type SortJSON = string | {
     Product: [SortJSON, SortJSON];
 };
@@ -170,25 +172,135 @@ export interface GraphJSON {
     roots: number[];
     io_manifest?: IoManifest;
 }
-export declare class GraphBuilder {
+/** One file output the graph writes. `s3_key` is where you asked it stored;
+ * `filename` is the sandbox-local name the worker writes before uploading. */
+export interface OutputBinding {
+    s3_key: string;
+    filename: string;
+}
+/** The S3 ⇄ sandbox mapping the submission layer needs: `inputs` drop straight
+ * into a job's `input_files`; each `output` names where a sink should land. */
+export interface GraphIo {
+    inputs: InputFile[];
+    outputs: OutputBinding[];
+}
+export interface SinkAvOpts {
+    codec?: string;
+    crf?: number;
+    bitrate?: string;
+    preset?: string;
+    [key: string]: ParamValue | undefined;
+}
+export interface FileOpts {
+    loop?: number;
+    t?: number;
+    [key: string]: ParamValue | undefined;
+}
+export interface AmovieOpts {
+    filename: string;
+    seek_point?: number;
+    streams?: string;
+    loop?: number;
+}
+export interface AnullsrcOpts {
+    d?: number;
+}
+export interface BlankOpts {
+    width?: number;
+    height?: number;
+    duration?: number;
+    color?: string;
+}
+export interface MovieOpts {
+    filename: string;
+    seek_point?: number;
+    streams?: string;
+    loop?: number;
+}
+export interface SineOpts {
+    frequency?: number;
+    duration?: number;
+}
+export interface TestPatternOpts {
+    width?: number;
+    height?: number;
+    duration?: number;
+}
+/**
+ * A pipeline under construction. Open inputs by S3 key, chain ops on the
+ * returned streams, attach outputs, then read json() (graph_ir) and io()
+ * (the S3 ⇄ sandbox binding) and hand both to your submission layer.
+ */
+export declare class Graph {
     /** @internal */ readonly _nodes: OpNode[];
     /** @internal */ readonly _roots: number[];
-    /** @internal */ readonly _ioSlots: IoSlotDecl[];
+    /** @internal */ readonly _slots: IoSlotDecl[];
+    /** @internal */ readonly _inputs: InputFile[];
+    /** @internal */ readonly _outputs: OutputBinding[];
+    /** @internal */ readonly _names: Set<string>;
+    /** @internal — S3 key → a unique sandbox basename. The worker joins this onto
+     * the work dir and rejects slashes / `..`, so keys are reduced to a basename;
+     * collisions get a numeric prefix. */
+    _basename(s3Key: string): string;
     /** @internal */
-    _addNode(node: OpNode): number;
+    _contentType(filename: string): string;
     /** @internal */
-    _addRoot(id: number): void;
+    _addNode(node: OpNode): number;
     /** @internal */
     _addSlot(slot: IoSlotDecl): void;
-    toJSON(): GraphJSON;
+    /** @internal */
+    _source(origin: Origin, sort: SortJSON, decoding: Decoding): number;
+    /**
+     * Open an S3 object as [video, audio]. Reference inputs by S3 key — the SDK
+     * records the input binding and gives the graph a sandbox-safe name, so
+     * `io().inputs` drops straight into a job's `input_files`.
+     */
+    open(s3Key: string, opts?: FileOpts): [VideoStream, AudioStream];
+    openVideo(s3Key: string): VideoStream;
+    openAudio(s3Key: string): AudioStream;
+    rtsp(url: string): [VideoStream, AudioStream];
+    hls(url: string): [VideoStream, AudioStream];
+    camera(device: number): [VideoStream, AudioStream];
+    screenCapture(): [VideoStream, AudioStream];
+    /** MQTT detection source (JSONL). */
+    mqtt(broker: string, topic: string): DetectionStream;
+    slot(label: string): [VideoStream, AudioStream];
+    slotVideo(label: string): VideoStream;
+    slotAudio(label: string): AudioStream;
+    aevalsrc(): AudioStream;
+    amovie(opts: AmovieOpts): AudioStream;
+    anoisesrc(): AudioStream;
+    anullsrc(opts?: AnullsrcOpts): AudioStream;
+    blank(opts?: BlankOpts): VideoStream;
+    movie(opts: MovieOpts): VideoStream;
+    sine(opts?: SineOpts): AudioStream;
+    testPattern(opts?: TestPatternOpts): VideoStream;
+    /** @internal */
+    _sink(inputs: number[], sorts: SortJSON[], target: SinkTarget, encoding: SinkEncoding, opts: Record<string, ParamValue>): void;
+    /** @internal — a file sink written to an S3 key (records the output binding). */
+    _fileSink(s3Key: string, inputs: number[], sorts: SortJSON[], encoding: SinkEncoding, opts: Record<string, ParamValue>): void;
+    /** Muxed video+audio, written to an S3 key. */
+    write(s3Key: string, video: VideoStream, audio: AudioStream, opts?: SinkAvOpts): this;
+    writeVideo(s3Key: string, video: VideoStream, opts?: SinkAvOpts): this;
+    writeAudio(s3Key: string, audio: AudioStream): this;
+    writeDetections(s3Key: string, detections: DetectionStream): this;
+    writeTranscript(s3Key: string, transcript: TranscriptStream, format?: 'srt' | 'vtt'): this;
+    writeMqtt(broker: string, topic: string, detections: DetectionStream, opts?: {
+        qos?: number;
+    }): this;
+    writeHttp(url: string, detections: DetectionStream, opts?: {
+        method?: string;
+    }): this;
+    outputSlot(label: string, video: VideoStream, audio: AudioStream, opts?: SinkAvOpts): this;
+    outputSlotVideo(label: string, video: VideoStream): this;
+    /** The graph_ir (renderbox-ir Graph serde shape) — submit this as a job's
+     * `graph_ir`. */
+    json(): GraphJSON;
+    /** The S3 ⇄ sandbox mapping the submission layer needs: `inputs` go into the
+     * job's `input_files`; pair each `output` with a destination. Identity
+     * (job id, tenant, user) is assigned by whoever submits — not here. */
+    io(): GraphIo;
 }
-/** @internal */
-export declare function _mk<S extends SortTag>(sort: S, id: number, g: GraphBuilder): Stream<S>;
-/** @internal */
-export declare function _id(s: Stream<SortTag>): number;
-/** @internal */
-export declare function _g(s: Stream<SortTag>): GraphBuilder;
-/** @internal */
-export declare function _p(opts: object): Record<string, ParamValue>;
-export declare function pipe<S extends SortTag>(...fns: Array<(s: Stream<S>) => Stream<S>>): (input: Stream<S>) => Stream<S>;
+/** Start a new pipeline. */
+export declare function graph(): Graph;
 //# sourceMappingURL=graph.d.ts.map

package/dist/graph.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAI9D,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG;IAAE,OAAO,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;CAAE,CAAC;AAIlE,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GACnD;IAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAC/D;IAAE,GAAG,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GACxB;IAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAC/C;IAAE,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;KAAE,CAAA;CAAE,GACnE;IAAE,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC9B;IAAE,aAAa,EAAE;QAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAC7C;IAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhC,MAAM,MAAM,QAAQ,GAChB,MAAM,GAAG,QAAQ,GAAG,KAAK,GAAG,KAAK,GAAG,OAAO,GAC3C,gBAAgB,GAAG,SAAS,GAAG,cAAc,GAAG,aAAa,CAAC;AAElE,MAAM,MAAM,UAAU,GAClB;IAAE,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,GAC1B;IAAE,IAAI,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAC/D;IAAE,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAA;CAAE,GAChD,QAAQ,GACR;IAAE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAA;CAAE,GAC7C;IAAE,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAEhC,MAAM,MAAM,YAAY,GACpB,WAAW,GAAG,OAAO,GAAG,iBAAiB,GACzC,KAAK,GAAG,KAAK,GAAG,sBAAsB,GAAG,SAAS,CAAC;AAIvD,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;CACzB;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GACxG;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACnF;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACxF;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACjF;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpF;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GAC1F;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GACvF;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,QAAQ,EAAE,CAAC;IAAC,MAAM,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,YAAY,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GACzI;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,GACtD;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,GACnH;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,YAAY,EAAE,MAAM,CAAA;CAAE,GAChE;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,KAAK,EAAE,eAAe,EAAE,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CAAE,CAAC;AAI7G,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,QAAQ,CAAC;AAE7C,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,CAAC;IAC/B,SAAS,EAAE,WAAW,CAAC;IACvB,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,UAAU,EAAE,CAAC;CACrB;AAID,MAAM,MAAM,YAAY,GACpB;IAAE,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpB;IAAE,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAA;CAAE,CAAC;AAE5C,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAIpD,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,CAAC,EAAE,UAAU,CAAC;CAC1B;AAID,qBAAa,YAAY;IACvB,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAChD,gBAAgB,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,CAAM;IAChD,gBAAgB,CAAC,QAAQ,CAAC,QAAQ,EAAE,UAAU,EAAE,CAAM;IAEtD,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAM9B,gBAAgB;IAChB,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAI1B,gBAAgB;IAChB,QAAQ,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAehC,MAAM,IAAI,SAAS;CAKpB;AAID,gBAAgB;AAChB,wBAAgB,GAAG,CAAC,CAAC,SAAS,OAAO,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,YAAY,GAAG,MAAM,CAAC,CAAC,CAAC,CAEtF;AAED,gBAAgB;AAChB,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,MAAM,CAE9C;AAED,gBAAgB;AAChB,wBAAgB,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,YAAY,CAEnD;AAED,gBAAgB;AAChB,wBAAgB,EAAE,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAM3D;AAID,wBAAgB,IAAI,CAAC,CAAC,SAAS,OAAO,EACpC,GAAG,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAAC,GACzC,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,CAEjC"}
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"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"}

package/dist/graph.js

@@ -1,8 +1,40 @@
-// --- GraphBuilder ---
-export class GraphBuilder {
+import { mk, _p } from './streams.js';
+const AV = { Product: ['Video', 'Audio'] };
+/**
+ * A pipeline under construction. Open inputs by S3 key, chain ops on the
+ * returned streams, attach outputs, then read json() (graph_ir) and io()
+ * (the S3 ⇄ sandbox binding) and hand both to your submission layer.
+ */
+export class Graph {
     /** @internal */ _nodes = [];
     /** @internal */ _roots = [];
-    /** @internal */ _ioSlots = [];
+    /** @internal */ _slots = [];
+    /** @internal */ _inputs = [];
+    /** @internal */ _outputs = [];
+    /** @internal */ _names = new Set();
+    /** @internal — S3 key → a unique sandbox basename. The worker joins this onto
+     * the work dir and rejects slashes / `..`, so keys are reduced to a basename;
+     * collisions get a numeric prefix. */
+    _basename(s3Key) {
+        const base = (s3Key.split('/').pop() || s3Key).replace(/[/\\]/g, '_') || 'file';
+        let name = base;
+        for (let i = 1; this._names.has(name); i++)
+            name = `${i}_${base}`;
+        this._names.add(name);
+        return name;
+    }
+    /** @internal */
+    _contentType(filename) {
+        const ext = filename.includes('.') ? filename.split('.').pop().toLowerCase() : '';
+        const map = {
+            mp4: 'video/mp4', mov: 'video/quicktime', webm: 'video/webm', mkv: 'video/x-matroska',
+            mp3: 'audio/mpeg', wav: 'audio/wav', aac: 'audio/aac', m4a: 'audio/mp4', flac: 'audio/flac',
+            jpg: 'image/jpeg', jpeg: 'image/jpeg', png: 'image/png', webp: 'image/webp', gif: 'image/gif',
+            srt: 'application/x-subrip', vtt: 'text/vtt',
+            jsonl: 'application/x-ndjson', json: 'application/json',
+        };
+        return map[ext] ?? 'application/octet-stream';
+    }
     /** @internal */
     _addNode(node) {
         const id = this._nodes.length;
@@ -10,53 +42,159 @@ export class GraphBuilder {
         return id;
     }
     /** @internal */
-    _addRoot(id) {
-        this._roots.push(id);
-    }
-    /** @internal */
     _addSlot(slot) {
-        const dup = this._ioSlots.some((s) => s.label === slot.label && s.direction === slot.direction);
+        const dup = this._slots.some((s) => s.label === slot.label && s.direction === slot.direction);
         if (dup) {
-            // Duplicate input labels share one binding (bind() rewrites every
-            // matching source); duplicate output labels are ambiguous.
             if (slot.direction === 'Output') {
                 throw new Error(`duplicate output slot label: ${slot.label}`);
             }
-            return;
+            return; // duplicate input labels share one binding
         }
-        this._ioSlots.push(slot);
+        this._slots.push(slot);
+    }
+    /** @internal */
+    _source(origin, sort, decoding) {
+        return this._addNode({ kind: 'Source', origin, sort, decoding, opts: {} });
+    }
+    // --- Inputs ---------------------------------------------------------------
+    /**
+     * Open an S3 object as [video, audio]. Reference inputs by S3 key — the SDK
+     * records the input binding and gives the graph a sandbox-safe name, so
+     * `io().inputs` drops straight into a job's `input_files`.
+     */
+    open(s3Key, opts) {
+        const filename = this._basename(s3Key);
+        this._inputs.push({ s3_key: s3Key, filename, content_type: this._contentType(filename) });
+        const id = this._addNode({
+            kind: 'Source',
+            origin: { File: { path: filename } },
+            sort: AV,
+            decoding: 'Passthrough',
+            opts: opts ? _p(opts) : {},
+        });
+        return [mk('Video', id, this), mk('Audio', id, this)];
+    }
+    openVideo(s3Key) {
+        return this.open(s3Key)[0];
     }
-    toJSON() {
+    openAudio(s3Key) {
+        return this.open(s3Key)[1];
+    }
+    rtsp(url) {
+        const id = this._source({ Rtsp: { url, transport: null } }, AV, 'Passthrough');
+        return [mk('Video', id, this), mk('Audio', id, this)];
+    }
+    hls(url) {
+        const id = this._source({ Hls: { url } }, AV, 'Passthrough');
+        return [mk('Video', id, this), mk('Audio', id, this)];
+    }
+    camera(device) {
+        const id = this._source({ Camera: { device: String(device) } }, AV, 'Passthrough');
+        return [mk('Video', id, this), mk('Audio', id, this)];
+    }
+    screenCapture() {
+        const id = this._source({ ScreenCapture: { display: null } }, AV, 'Passthrough');
+        return [mk('Video', id, this), mk('Audio', id, this)];
+    }
+    /** MQTT detection source (JSONL). */
+    mqtt(broker, topic) {
+        const id = this._source({ Mqtt: { broker, topic, qos: null } }, 'Detection', 'JsonlDetection');
+        return mk('Detection', id, this);
+    }
+    slot(label) {
+        const id = this._source({ Slot: { label } }, AV, 'Passthrough');
+        this._addSlot({ label, node_ids: [[id, 'Video'], [id, 'Audio']], direction: 'Input', optional: false });
+        return [mk('Video', id, this), mk('Audio', id, this)];
+    }
+    slotVideo(label) {
+        const id = this._source({ Slot: { label } }, 'Video', 'Passthrough');
+        this._addSlot({ label, node_ids: [[id, 'Video']], direction: 'Input', optional: false });
+        return mk('Video', id, this);
+    }
+    slotAudio(label) {
+        const id = this._source({ Slot: { label } }, 'Audio', 'Passthrough');
+        this._addSlot({ label, node_ids: [[id, 'Audio']], direction: 'Input', optional: false });
+        return mk('Audio', id, this);
+    }
+    aevalsrc() { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'aevalsrc', params: {} } }, sort: 'Audio', decoding: 'Passthrough', opts: {} }); return mk('Audio', id, this); }
+    amovie(opts) { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'amovie', params: _p(opts) } }, sort: 'Audio', decoding: 'Passthrough', opts: {} }); return mk('Audio', id, this); }
+    anoisesrc() { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'anoisesrc', params: {} } }, sort: 'Audio', decoding: 'Passthrough', opts: {} }); return mk('Audio', id, this); }
+    anullsrc(opts) { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'anullsrc', params: opts ? _p(opts) : {} } }, sort: 'Audio', decoding: 'Passthrough', opts: {} }); return mk('Audio', id, this); }
+    blank(opts) { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'blank', params: opts ? _p(opts) : {} } }, sort: 'Video', decoding: 'Passthrough', opts: {} }); return mk('Video', id, this); }
+    movie(opts) { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'movie', params: _p(opts) } }, sort: 'Video', decoding: 'Passthrough', opts: {} }); return mk('Video', id, this); }
+    sine(opts) { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'sine', params: opts ? _p(opts) : {} } }, sort: 'Audio', decoding: 'Passthrough', opts: {} }); return mk('Audio', id, this); }
+    testPattern(opts) { const id = this._addNode({ kind: 'Source', origin: { Synthetic: { name: 'test_pattern', params: opts ? _p(opts) : {} } }, sort: 'Video', decoding: 'Passthrough', opts: {} }); return mk('Video', id, this); }
+    // --- Outputs --------------------------------------------------------------
+    /** @internal */
+    _sink(inputs, sorts, target, encoding, opts) {
+        const id = this._addNode({ kind: 'Sink', inputs, input_sorts: sorts, target, encoding, opts });
+        this._roots.push(id);
+    }
+    /** @internal — a file sink written to an S3 key (records the output binding). */
+    _fileSink(s3Key, inputs, sorts, encoding, opts) {
+        const filename = this._basename(s3Key);
+        this._outputs.push({ s3_key: s3Key, filename });
+        this._sink(inputs, sorts, { File: { path: filename } }, encoding, opts);
+    }
+    /** Muxed video+audio, written to an S3 key. */
+    write(s3Key, video, audio, opts) {
+        this._fileSink(s3Key, [video._id, audio._id], ['Video', 'Audio'], 'Container', opts ? _p(opts) : {});
+        return this;
+    }
+    writeVideo(s3Key, video, opts) {
+        this._fileSink(s3Key, [video._id], ['Video'], 'Container', opts ? _p(opts) : {});
+        return this;
+    }
+    writeAudio(s3Key, audio) {
+        this._fileSink(s3Key, [audio._id], ['Audio'], 'Container', {});
+        return this;
+    }
+    writeDetections(s3Key, detections) {
+        this._fileSink(s3Key, [detections._id], ['Detection'], 'Jsonl', {});
+        return this;
+    }
+    writeTranscript(s3Key, transcript, format = 'srt') {
+        this._fileSink(s3Key, [transcript._id], ['Transcript'], format === 'vtt' ? 'Vtt' : 'Srt', {});
+        return this;
+    }
+    writeMqtt(broker, topic, detections, opts) {
+        this._sink([detections._id], ['Detection'], { Mqtt: { broker, topic, qos: opts?.qos ?? null } }, 'Jsonl', {});
+        return this;
+    }
+    writeHttp(url, detections, opts) {
+        this._sink([detections._id], ['Detection'], { Http: { url, method: opts?.method ?? null } }, 'Jsonl', {});
+        return this;
+    }
+    outputSlot(label, video, audio, opts) {
+        const id = this._addNode({ kind: 'Sink', inputs: [video._id, audio._id], input_sorts: ['Video', 'Audio'], target: { Slot: { label } }, encoding: 'Container', opts: opts ? _p(opts) : {} });
+        this._roots.push(id);
+        this._addSlot({ label, node_ids: [[id, 'Video'], [id, 'Audio']], direction: 'Output', optional: false });
+        return this;
+    }
+    outputSlotVideo(label, video) {
+        const id = this._addNode({ kind: 'Sink', inputs: [video._id], input_sorts: ['Video'], target: { Slot: { label } }, encoding: 'Container', opts: {} });
+        this._roots.push(id);
+        this._addSlot({ label, node_ids: [[id, 'Video']], direction: 'Output', optional: false });
+        return this;
+    }
+    // --- Terminals ------------------------------------------------------------
+    /** The graph_ir (renderbox-ir Graph serde shape) — submit this as a job's
+     * `graph_ir`. */
+    json() {
         const g = { arena: this._nodes, roots: this._roots };
-        if (this._ioSlots.length > 0)
-            g.io_manifest = { slots: this._ioSlots };
+        if (this._slots.length > 0)
+            g.io_manifest = { slots: this._slots };
         return g;
     }
+    /** The S3 ⇄ sandbox mapping the submission layer needs: `inputs` go into the
+     * job's `input_files`; pair each `output` with a destination. Identity
+     * (job id, tenant, user) is assigned by whoever submits — not here. */
+    io() {
+        return { inputs: [...this._inputs], outputs: [...this._outputs] };
+    }
 }
-// --- Internal helpers (used by generated op functions) ---
-/** @internal */
-export function _mk(sort, id, g) {
-    return { _id: id, _graph: g, _sort: sort };
-}
-/** @internal */
-export function _id(s) {
-    return s._id;
-}
-/** @internal */
-export function _g(s) {
-    return s._graph;
-}
-/** @internal */
-export function _p(opts) {
-    const out = {};
-    for (const [k, v] of Object.entries(opts)) {
-        if (v !== undefined)
-            out[k] = v;
-    }
-    return out;
-}
-// --- Composition ---
-export function pipe(...fns) {
-    return (input) => fns.reduce((s, fn) => fn(s), input);
+/** Start a new pipeline. */
+export function graph() {
+    return new Graph();
 }
 //# sourceMappingURL=graph.js.map