framefields 2.12.0 → 2.13.0

package/dist/storage/index.d.mts

@@ -0,0 +1,206 @@
+//#region ../storage/dist/index.d.mts
+//#region src/manifest.d.ts
+/**
+ * The `storage` and `assets` sections of a project's `framefields.json`.
+ *
+ * ```json
+ * {
+ *   "storage": {
+ *     "remotes": {
+ *       "media": {
+ *         "endpoint": "https://<account>.r2.cloudflarestorage.com",
+ *         "bucket": "films",
+ *         "publicUrl": "https://media.example.com"
+ *       }
+ *     }
+ *   },
+ *   "assets": {
+ *     "assets/footage/intro.mp4": { "sha256": "…", "size": 48213 }
+ *   }
+ * }
+ * ```
+ *
+ * Assets are stored by content (`sha256/ab/<hash>`), so the manifest pins
+ * exact bytes the way a lockfile pins packages, and the files themselves
+ * stay out of git.
+ */
+/** An S3-compatible bucket: Cloudflare R2, AWS S3, Backblaze B2, MinIO, … */
+interface StorageRemote {
+  /** The S3 API endpoint, e.g. `https://<account>.r2.cloudflarestorage.com`. */
+  endpoint: string;
+  bucket: string;
+  /** SigV4 region. Default `auto` (R2); AWS needs the bucket's region. */
+  region?: string;
+  /** Key prefix inside the bucket, e.g. `films/launch/`. */
+  prefix?: string;
+  /**
+   * Where the bucket is publicly readable: a custom domain (an R2 custom
+   * domain or any CDN in front of the bucket) or the `r2.dev` URL. Reads use
+   * it instead of signed URLs, so anyone can pull and render without keys.
+   */
+  publicUrl?: string;
+}
+interface StorageConfig {
+  /** The remote new assets go to. Default: the only remote. */
+  default?: string;
+  remotes: Record<string, StorageRemote>;
+}
+/** One file the project needs, pinned by content. */
+interface AssetEntry {
+  sha256: string;
+  size: number;
+  /** The remote holding it. Default: `storage.default`. */
+  remote?: string;
+  /** A fixed https URL to fetch it from instead of a remote (public media). */
+  url?: string;
+}
+type AssetManifest = Record<string, AssetEntry>;
+declare const REMOTE_NAME: RegExp;
+declare const SHA256: RegExp;
+declare class ManifestError extends Error {
+  name: string;
+}
+/** Validates `storage`; errors name the remote and field at fault. */
+declare function parseStorage(value: unknown): StorageConfig;
+/** Validates `assets`; errors name the path and field at fault. */
+declare function parseAssets(value: unknown, storage?: StorageConfig): AssetManifest;
+/** The remote an asset (or a new one, without `name`) belongs to. */
+declare function pickRemote(storage: StorageConfig | undefined, name?: string): {
+  name: string;
+  remote: StorageRemote;
+};
+/** The object key holding `sha256`: `<prefix>sha256/ab/<hash>`. */
+declare function objectKey(sha256: string, prefix?: string): string;
+/** The asset's URL on the remote's public domain, if it has one. */
+declare function publicUrl(remote: StorageRemote, sha256: string): string | undefined;
+/**
+ * Where to download an asset without credentials: a signed URL handed in
+ * (`signed`, by sha256), its own `url`, or its remote's public domain.
+ * Undefined means the asset is on a private remote and needs a signature.
+ */
+declare function readUrl(entry: AssetEntry, storage: StorageConfig | undefined, signed?: Readonly<Record<string, string>>): string | undefined;
+declare function isAssetPath(path: string): boolean;
+//#endregion
+//#region src/bucket.d.ts
+interface Credentials {
+  accessKeyId: string;
+  secretAccessKey: string;
+  sessionToken?: string;
+}
+/**
+ * Keys for `remote` from the environment:
+ * `FRAMEFIELDS_STORAGE_<REMOTE>_ACCESS_KEY_ID` / `…_SECRET_ACCESS_KEY`
+ * (the remote's name upper-cased, `-` as `_`), else the standard
+ * `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`.
+ */
+declare function credentialsFromEnv(remote: string, env?: Readonly<Record<string, string | undefined>>): Credentials | undefined;
+/** The env vars `credentialsFromEnv` reads for `remote`, for messages. */
+declare function credentialEnvNames(remote: string): [string, string];
+declare class StorageError extends Error {
+  readonly status?: number | undefined;
+  name: string;
+  constructor(message: string, status?: number | undefined);
+}
+interface UploadProgress {
+  sent: number;
+  total: number;
+}
+interface BucketOptions {
+  fetch?: typeof fetch;
+  /** Files above this go up in parts. Default 64 MiB. */
+  multipartThreshold?: number;
+  /** Default 16 MiB; grows so a file never needs more than 10,000 parts. */
+  partSize?: number;
+  /** Parts in flight at once. Default 4. */
+  concurrency?: number;
+}
+/** One remote's bucket, signed with `credentials`. */
+declare class Bucket {
+  readonly remote: StorageRemote;
+  private readonly options;
+  private readonly aws;
+  private readonly fetch;
+  constructor(remote: StorageRemote, credentials: Credentials, options?: BucketOptions);
+  keyFor(sha256: string): string;
+  /** Whether the bucket holds `sha256` at the expected size. */
+  has(sha256: string, size: number): Promise<boolean>;
+  /**
+   * Uploads `file` (already hashed) under its content key. The bucket
+   * checks every byte against the sha256 sent with it.
+   */
+  upload(file: string, digest: {
+    sha256: string;
+    size: number;
+  }, onProgress?: (p: UploadProgress) => void): Promise<void>;
+  /** A GET URL anyone can use until it expires (at most 7 days). */
+  presign(sha256: string, expiresSec?: number): Promise<string>;
+  private put;
+  private uploadParts;
+  private url;
+  private send;
+  private failure;
+}
+//#endregion
+//#region src/files.d.ts
+type AssetErrorCode = "ASSET_NOT_FOUND" | "ASSET_FORBIDDEN" | "ASSET_DOWNLOAD_FAILED" | "ASSET_HASH_MISMATCH";
+declare class AssetError extends Error {
+  readonly code: AssetErrorCode;
+  name: string;
+  constructor(code: AssetErrorCode, message: string, options?: {
+    cause?: unknown;
+  });
+}
+interface FileDigest {
+  sha256: string;
+  size: number;
+}
+declare function hashFile(path: string): Promise<FileDigest>;
+interface DownloadOptions {
+  fetch?: typeof fetch;
+  signal?: AbortSignal;
+  /** Attempts for network errors and 5xx/429 responses. Default 3. */
+  attempts?: number;
+}
+/**
+ * Downloads `url` to `dest` through a temporary file, and only renames it
+ * into place once its size and sha256 match `expected`.
+ */
+declare function downloadVerified(url: string, dest: string, expected: FileDigest, options?: DownloadOptions): Promise<void>;
+/** Signed URLs carry credentials in the query: never print them. */
+declare function redactQuery(url: string): string;
+/** The Content-Type a CDN serves the file with. */
+declare function contentType(path: string): string;
+//#endregion
+//#region src/locate.d.ts
+interface ProjectManifest {
+  storage?: StorageConfig;
+  assets: AssetManifest;
+}
+/** The nearest folder at or above `dir` holding a framefields.json. */
+declare function findProjectDir(dir: string): string | undefined;
+/** The `storage` and `assets` of the project at `dir`; undefined without assets. */
+declare function readProjectManifest(dir: string): Promise<ProjectManifest | undefined>;
+interface AssetLocator {
+  /** The project folder (where framefields.json is). */
+  readonly root: string;
+  /** The pinned entry for an absolute path, if the project pins it. */
+  entry(file: string): AssetEntry | undefined;
+  /**
+   * A URL to read a pinned file from: its public domain or own URL, else
+   * a GET signed with the remote's keys from the environment. Undefined
+   * when the file isn't pinned, or is private and there are no keys.
+   */
+  url(file: string): Promise<string | undefined>;
+}
+/**
+ * Pinned-asset lookup for the project at or above `dir`, or undefined when
+ * it pins none.
+ */
+declare function openAssetLocator(dir: string, options?: {
+  env?: Readonly<Record<string, string | undefined>>;
+  fetch?: typeof fetch;
+}): Promise<AssetLocator | undefined>;
+//#endregion
+//#endregion
+export { type AssetEntry, AssetError, type AssetErrorCode, type AssetLocator, type AssetManifest, Bucket, type BucketOptions, type Credentials, type DownloadOptions, type FileDigest, ManifestError, type ProjectManifest, REMOTE_NAME, SHA256, type StorageConfig, StorageError, type StorageRemote, type UploadProgress, contentType, credentialEnvNames, credentialsFromEnv, downloadVerified, findProjectDir, hashFile, isAssetPath, objectKey, openAssetLocator, parseAssets, parseStorage, pickRemote, publicUrl, readProjectManifest, readUrl, redactQuery };
+//# sourceMappingURL=index.d.mts.map

package/dist/storage/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","names":["StorageRemote","StorageConfig","Record","AssetEntry","AssetManifest","REMOTE_NAME","RegExp","SHA256","ManifestError","Error","parseStorage","parseAssets","pickRemote","objectKey","publicUrl","readUrl","Readonly","isAssetPath","Credentials","credentialsFromEnv","credentialEnvNames","StorageError","UploadProgress","BucketOptions","fetch","Bucket","Promise","AssetErrorCode","AssetError","FileDigest","hashFile","DownloadOptions","AbortSignal","downloadVerified","redactQuery","contentType","ProjectManifest","findProjectDir","readProjectManifest","AssetLocator","openAssetLocator"],"sources":["../../../storage/dist/index.d.mts"],"sourcesContent":["//#region src/manifest.d.ts\n/**\n * The `storage` and `assets` sections of a project's `framefields.json`.\n *\n * ```json\n * {\n *   \"storage\": {\n *     \"remotes\": {\n *       \"media\": {\n *         \"endpoint\": \"https://<account>.r2.cloudflarestorage.com\",\n *         \"bucket\": \"films\",\n *         \"publicUrl\": \"https://media.example.com\"\n *       }\n *     }\n *   },\n *   \"assets\": {\n *     \"assets/footage/intro.mp4\": { \"sha256\": \"…\", \"size\": 48213 }\n *   }\n * }\n * ```\n *\n * Assets are stored by content (`sha256/ab/<hash>`), so the manifest pins\n * exact bytes the way a lockfile pins packages, and the files themselves\n * stay out of git.\n */\n/** An S3-compatible bucket: Cloudflare R2, AWS S3, Backblaze B2, MinIO, … */\ninterface StorageRemote {\n  /** The S3 API endpoint, e.g. `https://<account>.r2.cloudflarestorage.com`. */\n  endpoint: string;\n  bucket: string;\n  /** SigV4 region. Default `auto` (R2); AWS needs the bucket's region. */\n  region?: string;\n  /** Key prefix inside the bucket, e.g. `films/launch/`. */\n  prefix?: string;\n  /**\n   * Where the bucket is publicly readable: a custom domain (an R2 custom\n   * domain or any CDN in front of the bucket) or the `r2.dev` URL. Reads use\n   * it instead of signed URLs, so anyone can pull and render without keys.\n   */\n  publicUrl?: string;\n}\ninterface StorageConfig {\n  /** The remote new assets go to. Default: the only remote. */\n  default?: string;\n  remotes: Record<string, StorageRemote>;\n}\n/** One file the project needs, pinned by content. */\ninterface AssetEntry {\n  sha256: string;\n  size: number;\n  /** The remote holding it. Default: `storage.default`. */\n  remote?: string;\n  /** A fixed https URL to fetch it from instead of a remote (public media). */\n  url?: string;\n}\ntype AssetManifest = Record<string, AssetEntry>;\ndeclare const REMOTE_NAME: RegExp;\ndeclare const SHA256: RegExp;\ndeclare class ManifestError extends Error {\n  name: string;\n}\n/** Validates `storage`; errors name the remote and field at fault. */\ndeclare function parseStorage(value: unknown): StorageConfig;\n/** Validates `assets`; errors name the path and field at fault. */\ndeclare function parseAssets(value: unknown, storage?: StorageConfig): AssetManifest;\n/** The remote an asset (or a new one, without `name`) belongs to. */\ndeclare function pickRemote(storage: StorageConfig | undefined, name?: string): {\n  name: string;\n  remote: StorageRemote;\n};\n/** The object key holding `sha256`: `<prefix>sha256/ab/<hash>`. */\ndeclare function objectKey(sha256: string, prefix?: string): string;\n/** The asset's URL on the remote's public domain, if it has one. */\ndeclare function publicUrl(remote: StorageRemote, sha256: string): string | undefined;\n/**\n * Where to download an asset without credentials: a signed URL handed in\n * (`signed`, by sha256), its own `url`, or its remote's public domain.\n * Undefined means the asset is on a private remote and needs a signature.\n */\ndeclare function readUrl(entry: AssetEntry, storage: StorageConfig | undefined, signed?: Readonly<Record<string, string>>): string | undefined;\ndeclare function isAssetPath(path: string): boolean;\n//#endregion\n//#region src/bucket.d.ts\ninterface Credentials {\n  accessKeyId: string;\n  secretAccessKey: string;\n  sessionToken?: string;\n}\n/**\n * Keys for `remote` from the environment:\n * `FRAMEFIELDS_STORAGE_<REMOTE>_ACCESS_KEY_ID` / `…_SECRET_ACCESS_KEY`\n * (the remote's name upper-cased, `-` as `_`), else the standard\n * `AWS_ACCESS_KEY_ID` / `AWS_SECRET_ACCESS_KEY`.\n */\ndeclare function credentialsFromEnv(remote: string, env?: Readonly<Record<string, string | undefined>>): Credentials | undefined;\n/** The env vars `credentialsFromEnv` reads for `remote`, for messages. */\ndeclare function credentialEnvNames(remote: string): [string, string];\ndeclare class StorageError extends Error {\n  readonly status?: number | undefined;\n  name: string;\n  constructor(message: string, status?: number | undefined);\n}\ninterface UploadProgress {\n  sent: number;\n  total: number;\n}\ninterface BucketOptions {\n  fetch?: typeof fetch;\n  /** Files above this go up in parts. Default 64 MiB. */\n  multipartThreshold?: number;\n  /** Default 16 MiB; grows so a file never needs more than 10,000 parts. */\n  partSize?: number;\n  /** Parts in flight at once. Default 4. */\n  concurrency?: number;\n}\n/** One remote's bucket, signed with `credentials`. */\ndeclare class Bucket {\n  readonly remote: StorageRemote;\n  private readonly options;\n  private readonly aws;\n  private readonly fetch;\n  constructor(remote: StorageRemote, credentials: Credentials, options?: BucketOptions);\n  keyFor(sha256: string): string;\n  /** Whether the bucket holds `sha256` at the expected size. */\n  has(sha256: string, size: number): Promise<boolean>;\n  /**\n   * Uploads `file` (already hashed) under its content key. The bucket\n   * checks every byte against the sha256 sent with it.\n   */\n  upload(file: string, digest: {\n    sha256: string;\n    size: number;\n  }, onProgress?: (p: UploadProgress) => void): Promise<void>;\n  /** A GET URL anyone can use until it expires (at most 7 days). */\n  presign(sha256: string, expiresSec?: number): Promise<string>;\n  private put;\n  private uploadParts;\n  private url;\n  private send;\n  private failure;\n}\n//#endregion\n//#region src/files.d.ts\ntype AssetErrorCode = \"ASSET_NOT_FOUND\" | \"ASSET_FORBIDDEN\" | \"ASSET_DOWNLOAD_FAILED\" | \"ASSET_HASH_MISMATCH\";\ndeclare class AssetError extends Error {\n  readonly code: AssetErrorCode;\n  name: string;\n  constructor(code: AssetErrorCode, message: string, options?: {\n    cause?: unknown;\n  });\n}\ninterface FileDigest {\n  sha256: string;\n  size: number;\n}\ndeclare function hashFile(path: string): Promise<FileDigest>;\ninterface DownloadOptions {\n  fetch?: typeof fetch;\n  signal?: AbortSignal;\n  /** Attempts for network errors and 5xx/429 responses. Default 3. */\n  attempts?: number;\n}\n/**\n * Downloads `url` to `dest` through a temporary file, and only renames it\n * into place once its size and sha256 match `expected`.\n */\ndeclare function downloadVerified(url: string, dest: string, expected: FileDigest, options?: DownloadOptions): Promise<void>;\n/** Signed URLs carry credentials in the query: never print them. */\ndeclare function redactQuery(url: string): string;\n/** The Content-Type a CDN serves the file with. */\ndeclare function contentType(path: string): string;\n//#endregion\n//#region src/locate.d.ts\ninterface ProjectManifest {\n  storage?: StorageConfig;\n  assets: AssetManifest;\n}\n/** The nearest folder at or above `dir` holding a framefields.json. */\ndeclare function findProjectDir(dir: string): string | undefined;\n/** The `storage` and `assets` of the project at `dir`; undefined without assets. */\ndeclare function readProjectManifest(dir: string): Promise<ProjectManifest | undefined>;\ninterface AssetLocator {\n  /** The project folder (where framefields.json is). */\n  readonly root: string;\n  /** The pinned entry for an absolute path, if the project pins it. */\n  entry(file: string): AssetEntry | undefined;\n  /**\n   * A URL to read a pinned file from: its public domain or own URL, else\n   * a GET signed with the remote's keys from the environment. Undefined\n   * when the file isn't pinned, or is private and there are no keys.\n   */\n  url(file: string): Promise<string | undefined>;\n}\n/**\n * Pinned-asset lookup for the project at or above `dir`, or undefined when\n * it pins none.\n */\ndeclare function openAssetLocator(dir: string, options?: {\n  env?: Readonly<Record<string, string | undefined>>;\n  fetch?: typeof fetch;\n}): Promise<AssetLocator | undefined>;\n//#endregion\nexport { type AssetEntry, AssetError, type AssetErrorCode, type AssetLocator, type AssetManifest, Bucket, type BucketOptions, type Credentials, type DownloadOptions, type FileDigest, ManifestError, type ProjectManifest, REMOTE_NAME, SHA256, type StorageConfig, StorageError, type StorageRemote, type UploadProgress, contentType, credentialEnvNames, credentialsFromEnv, downloadVerified, findProjectDir, hashFile, isAssetPath, objectKey, openAssetLocator, parseAssets, parseStorage, pickRemote, publicUrl, readProjectManifest, readUrl, redactQuery };\n//# sourceMappingURL=index.d.mts.map"],"mappings":";;;AA0BuB;AAkBN;AAGG;AAQO;AACM;AACL;AACa;AAImB;AAEwB;AAI7D;AAGG;AAEsB;;;;;;AAMiD;AACrE;AAGP;;;;;AAW+F,UApE1GA,aAAAA,CAsEOoB;EAAkB;EACK,QAK9BE,EAAAA,MAAAA;EAAc,MAIdC,EAAAA,MAAAA;EACY;EAUHvB,MAAAA,CAAAA,EAAAA,MAAAA;EAIGA;EAA4BkB,MAAAA,CAAAA,EAAAA,MAAAA;EAAuBK;;;;;EAalB,SAAA,CAAA,EAAA,MAAA;AAAA;AASpC,UAtGTtB,aAAAA,CAuGc;EACP0B;EAEGA,OAAAA,CAAAA,EAAAA,MAAAA;EAHalB,OAAAA,EApGtBP,MAoGsBO,CAAAA,MAAAA,EApGPT,aAoGOS,CAAAA;;AAAK;AAOlB,UAxGVN,UAAAA,CA4Ge;EAAuB,MACtC4B,EAAAA,MAAAA;EAEY,IAQLE,EAAAA,MAAAA;EAAsDJ;EAAsBE,MAAAA,CAAAA,EAAAA,MAAAA;EAAkBL;EAAO,GAAA,CAAA,EAAA,MAAA;AAAA;AAE1F,KAjHvBtB,aAAAA,GAAgBF,MAmHO,CAAA,MAAA,EAnHQC,UAmHR,CAAA;AAAA,cAlHdE,WAqHW,EArHEC,MAqHF;AAEF,cAtHTC,MAyHG8B,EAzHK/B,MAyHS;AAAA,cAxHjBE,aAAAA,SAAsBC,KAAAA,CA0HuB2B;EAAD,IAChDG,EAAAA,MAAAA;AAUkB;;iBAjIX7B,YAAAA,CAwITM,KAAAA,EAAAA,OAAAA,CAAAA,EAxIuCf,aAwIvCe;;iBAtISL,WAAAA,CAwIL4B,KAAAA,EAAAA,OAAAA,EAAAA,OAAAA,CAAAA,EAxI2CtC,aAwI3CsC,CAAAA,EAxI2DnC,aAwI3DmC;;iBAtIK3B,UAAAA,CAsIN,OAAA,EAtI0BX,aAsI1B,GAAA,SAAA,EAAA,IAAA,CAAA,EAAA,MAAA,CAAA,EAAA;;UApIDD;;;iBAGOa,SAAAA;;iBAEAC,SAAAA,SAAkBd;;;;;;iBAMlBe,OAAAA,QAAeZ,qBAAqBF,oCAAoCe,SAASd;iBACjFe,WAAAA;;;UAGPC,WAAAA;;;;;;;;;;;iBAWOC,kBAAAA,uBAAyCH,SAASd,sCAAsCgB;;iBAExFE,kBAAAA;cACHC,YAAAA,SAAqBZ,KAAAA;;;;;UAKzBa,cAAAA;;;;UAIAC,aAAAA;iBACOC;;;;;;;;;cASHC,MAAAA;mBACKzB;;;;sBAIGA,4BAA4BkB,uBAAuBK;;;qCAGpCG;;;;;;;;sBAQfJ,0BAA0BI;;gDAEAA;;;;;;;;;KAS3CC,cAAAA;cACSC,UAAAA,SAAmBnB,KAAAA;iBAChBkB;;oBAEGA;;;;UAIVE,UAAAA;;;;iBAIOC,QAAAA,gBAAwBJ,QAAQG;UACvCE,eAAAA;iBACOP;WACNQ;;;;;;;;iBAQMC,gBAAAA,sCAAsDJ,sBAAsBE,kBAAkBL;;iBAE9FQ,WAAAA;;iBAEAC,WAAAA;;;UAGPC,eAAAA;YACEnC;UACFG;;;iBAGOiC,cAAAA;;iBAEAC,mBAAAA,eAAkCZ,QAAQU;UACjDG,YAAAA;;;;uBAIapC;;;;;;qBAMFuB;;;;;;iBAMJc,gBAAAA;QACTxB,SAASd;iBACAsB;IACbE,QAAQa"}

package/dist/storage/index.mjs

@@ -0,0 +1,3 @@
+import { S as redactQuery, _ as parseStorage, a as SHA256, b as readProjectManifest, c as credentialEnvNames, d as findProjectDir, f as hashFile, g as parseAssets, h as openAssetLocator, i as REMOTE_NAME, l as credentialsFromEnv, m as objectKey, n as Bucket, o as StorageError, p as isAssetPath, r as ManifestError, s as contentType, t as AssetError, u as downloadVerified, v as pickRemote, x as readUrl, y as publicUrl } from "../dist-CiTgmfUw.mjs";
+
+export { AssetError, Bucket, ManifestError, REMOTE_NAME, SHA256, StorageError, contentType, credentialEnvNames, credentialsFromEnv, downloadVerified, findProjectDir, hashFile, isAssetPath, objectKey, openAssetLocator, parseAssets, parseStorage, pickRemote, publicUrl, readProjectManifest, readUrl, redactQuery };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "framefields",
-  "version": "2.12.0",
+  "version": "2.13.0",
   "private": false,
   "description": "High-performance WebGPU rendering SDK for video composition, Photoshop-grade 2D VFX, audio DSP, and reactive signals. Built for AI Agents.",
   "license": "Apache-2.0",
@@ -87,6 +87,12 @@
       "import": "./dist/cloud/index.mjs",
       "default": "./dist/cloud/index.mjs"
     },
+    "./storage": {
+      "types": "./dist/storage/index.d.mts",
+      "development": "./src/storage/index.ts",
+      "import": "./dist/storage/index.mjs",
+      "default": "./dist/storage/index.mjs"
+    },
     "./sam": {
       "types": "./dist/sam/index.d.mts",
       "development": "./src/sam/index.ts",
@@ -105,6 +111,7 @@
     "@mediabunny/server": "^1.61.6",
     "@napi-rs/webcodecs": "^1.3.1",
     "@resvg/resvg-js": "^2.6.2",
+    "aws4fetch": "^1.0.20",
     "d3-format": "^3.1.2",
     "d3-scale": "^4.0.2",
     "d3-shape": "^3.2.0",
@@ -138,64 +145,65 @@
     "tsdown": "^0.19.0",
     "typescript": "^5.8.3",
     "vitest": "4.1.5",
-    "@framefields/client-utils": "2.12.0",
-    "@framefields/ai": "2.12.0",
-    "@framefields/compositions": "2.12.0",
-    "@framefields/components": "2.12.0",
-    "@framefields/node-audio-noise-gate": "2.12.0",
-    "@framefields/node-audio-fade": "2.12.0",
-    "@framefields/node-audio-reverb": "2.12.0",
-    "@framefields/node-audio-parametric-eq": "2.12.0",
-    "@framefields/node-color-balance": "2.12.0",
-    "@framefields/node-audio-delay": "2.12.0",
-    "@framefields/node-audio-signal-extractor": "2.12.0",
-    "@framefields/node-colorkey": "2.12.0",
-    "@framefields/node-audio-compressor": "2.12.0",
-    "@framefields/node-corner-pin": "2.12.0",
-    "@framefields/core": "2.12.0",
-    "@framefields/node-crop": "2.12.0",
-    "@framefields/node-curves": "2.12.0",
-    "@framefields/node-displacement-map": "2.12.0",
-    "@framefields/node-film-grain": "2.12.0",
-    "@framefields/node-flip": "2.12.0",
-    "@framefields/node-gradient-map": "2.12.0",
-    "@framefields/node-halftone-screen": "2.12.0",
-    "@framefields/node-kenburns": "2.12.0",
-    "@framefields/node-liquify": "2.12.0",
-    "@framefields/node-deflicker": "2.12.0",
-    "@framefields/node-levels": "2.12.0",
-    "@framefields/node-blur": "2.12.0",
-    "@framefields/node-layer-style": "2.12.0",
-    "@framefields/node-mask-math": "2.12.0",
-    "@framefields/node-high-pass": "2.12.0",
-    "@framefields/node-paint": "2.12.0",
-    "@framefields/node-mesh-warp": "2.12.0",
-    "@framefields/node-patch-heal": "2.12.0",
-    "@framefields/node-sdk": "2.12.0",
-    "@framefields/node-modulate": "2.12.0",
-    "@framefields/node-particles": "2.12.0",
-    "@framefields/node-relight-3d": "2.12.0",
-    "@framefields/node-signal": "2.12.0",
-    "@framefields/node-rotate": "2.12.0",
-    "@framefields/node-refine-edge": "2.12.0",
-    "@framefields/node-selective-color": "2.12.0",
-    "@framefields/node-signal-math": "2.12.0",
-    "@framefields/node-signal-gate": "2.12.0",
-    "@framefields/node-shadows-highlights": "2.12.0",
-    "@framefields/node-lut": "2.12.0",
-    "@framefields/node-refraction-caustics": "2.12.0",
-    "@framefields/node-stereo-panning": "2.12.0",
-    "@framefields/node-tile-offset": "2.12.0",
-    "@framefields/node-vignette": "2.12.0",
-    "@framefields/renderers": "2.12.0",
-    "@framefields/node-unsharp-mask": "2.12.0",
-    "@framefields/node-vision": "2.12.0",
-    "@framefields/tensor-webgpu": "2.12.0",
-    "@framefields/tsconfig": "2.12.0",
-    "@framefields/vision-sam": "2.12.0",
-    "@framefields/vision": "2.12.0",
-    "@framefields/webgpu-renderers": "2.12.0",
-    "@framefields/renderer": "2.12.0"
+    "@framefields/ai": "2.13.0",
+    "@framefields/node-audio-compressor": "2.13.0",
+    "@framefields/client-utils": "2.13.0",
+    "@framefields/compositions": "2.13.0",
+    "@framefields/components": "2.13.0",
+    "@framefields/node-audio-noise-gate": "2.13.0",
+    "@framefields/core": "2.13.0",
+    "@framefields/node-audio-fade": "2.13.0",
+    "@framefields/node-audio-reverb": "2.13.0",
+    "@framefields/node-audio-parametric-eq": "2.13.0",
+    "@framefields/node-audio-delay": "2.13.0",
+    "@framefields/node-color-balance": "2.13.0",
+    "@framefields/node-crop": "2.13.0",
+    "@framefields/node-curves": "2.13.0",
+    "@framefields/node-colorkey": "2.13.0",
+    "@framefields/node-audio-signal-extractor": "2.13.0",
+    "@framefields/node-deflicker": "2.13.0",
+    "@framefields/node-displacement-map": "2.13.0",
+    "@framefields/node-film-grain": "2.13.0",
+    "@framefields/node-blur": "2.13.0",
+    "@framefields/node-gradient-map": "2.13.0",
+    "@framefields/node-high-pass": "2.13.0",
+    "@framefields/node-kenburns": "2.13.0",
+    "@framefields/node-liquify": "2.13.0",
+    "@framefields/node-corner-pin": "2.13.0",
+    "@framefields/node-levels": "2.13.0",
+    "@framefields/node-halftone-screen": "2.13.0",
+    "@framefields/node-lut": "2.13.0",
+    "@framefields/node-mask-math": "2.13.0",
+    "@framefields/node-modulate": "2.13.0",
+    "@framefields/node-mesh-warp": "2.13.0",
+    "@framefields/node-paint": "2.13.0",
+    "@framefields/node-patch-heal": "2.13.0",
+    "@framefields/node-particles": "2.13.0",
+    "@framefields/node-refraction-caustics": "2.13.0",
+    "@framefields/node-layer-style": "2.13.0",
+    "@framefields/node-refine-edge": "2.13.0",
+    "@framefields/node-rotate": "2.13.0",
+    "@framefields/node-sdk": "2.13.0",
+    "@framefields/node-selective-color": "2.13.0",
+    "@framefields/node-shadows-highlights": "2.13.0",
+    "@framefields/node-signal-gate": "2.13.0",
+    "@framefields/node-signal-math": "2.13.0",
+    "@framefields/node-signal": "2.13.0",
+    "@framefields/node-stereo-panning": "2.13.0",
+    "@framefields/node-unsharp-mask": "2.13.0",
+    "@framefields/node-tile-offset": "2.13.0",
+    "@framefields/node-vignette": "2.13.0",
+    "@framefields/node-vision": "2.13.0",
+    "@framefields/renderer": "2.13.0",
+    "@framefields/storage": "2.13.0",
+    "@framefields/renderers": "2.13.0",
+    "@framefields/tensor-webgpu": "2.13.0",
+    "@framefields/tsconfig": "2.13.0",
+    "@framefields/vision-sam": "2.13.0",
+    "@framefields/vision": "2.13.0",
+    "@framefields/webgpu-renderers": "2.13.0",
+    "@framefields/node-flip": "2.13.0",
+    "@framefields/node-relight-3d": "2.13.0"
   },
   "scripts": {
     "build": "tsdown && node ../../scripts/sync-readme.mjs && node scripts/check-bundled-imports.mjs && node scripts/check-components-treeshake.mjs && node scripts/check-registry-types.mjs",

package/dist/audio-afTBdB3U.d.mts.map

@@ -1 +0,0 @@
-{"version":3,"file":"audio-afTBdB3U.d.mts","names":["_framefields_node_sdk_renderer0","_default","NodeRendererPlugin","Readonly","default"],"sources":["../../../nodes/node-modulate/dist/renderer.d.mts","../src/signals/audio.ts"],"sourcesContent":["import * as _framefields_node_sdk_renderer0 from \"@framefields/node-sdk/renderer\";\n\n//#region src/renderers/index.d.ts\ndeclare const _default: Readonly<_framefields_node_sdk_renderer0.NodeRendererPlugin>;\n//#endregion\nexport { _default as default };\n//# sourceMappingURL=renderer.d.mts.map"],"mappings":";;;;;;cAGcC,UAAUE,SAASH;;;;UCWhB,kBAAA,SAA2B;;;EDX9BC,WAAsE,CAAA,EAAA,UAAnDD,GAAAA,UAAAA,GAAAA,cAAD,GAAA,UAAA;;UCiBf,2BAAA;WACP;EAPO,IAAA,EAQV,WARU,CAAA,MAAmB,CAAA;EAMnB,IAAA,EAGV,WAHU,CAAA,MAAA,CAAA;EACP,MAAA,EAGD,WAHC,CAAA,MAAA,CAAA;EACH,WAAA,EAAA,MAAA;EACA,SAAA,EAAA,MAAA;EACE,UAAA,EAAA,MAAA;EAAW,WAAA,EAAA,OAAA;EAaH,OAAA,EAAA,OAAA;EAKA,aAAA,EAAA,OAAiB;EAE7B,UAAA,EAAA,OAAA;EAEQ,UAAA,EAAA,OAAA;EAEJ,YAAA,EAAA,OAAA;EACO,SAAA,CAAA,KAAA,EAAA,MAAA,CAAA,EAAA,IAAA;;AAAgD,UAZ/C,iBAAA,SAA0B,qBAYqB,CAAA;EAAY,GAAA,CAAA,EAAA,MAAA;AAc5E;;AAIW,UAzBM,iBAAA,CAyBN;EACC;EAAR,EAAA,EAxBC,WAwBD,CAAA,MAAA,CAAA;EAoFO;EACC,UAAA,EA3GC,WA2GD,CAAA,MAAA,CAAA;EAAR;EAWQ,MAAA,EApHH,WAoHG,CAAA,MAAA,CAAA;EAED,OAAA,EAAA;IACC,EAAA,EAtHI,YAsHJ;IAAR,UAAA,EAtHsC,YAsHtC;IA4BO,MAAA,EAlJqD,YAkJrD;EACC,CAAA;EAAR,GAAA,EAAA,MAAA;EAAO,SAAA,EAAA,MAAA;;;cArIE;gCAED,8CAED,qBACP,QAAQ;oCAoFD,qBACP,QAAQ;;8BAWA,8CAED,oBACP,QAAQ;;kCA4BD,oBACP,QAAQ"}

package/dist/cloud-COid1Ipa.mjs.map

@@ -1 +0,0 @@
-{"version":3,"file":"cloud-COid1Ipa.mjs","names":["fs","resolve"],"sources":["../src/cli/config.ts","../src/cloud/git-source.ts","../src/cloud/index.ts"],"sourcesContent":["/**\n * `framefields.json` at the project root: where installed components live,\n * which fonts `framefields add` / `framefields fonts add` installed, and the\n * project's named renders.\n *\n * ```json\n * {\n *   \"components\": \"src/components\",\n *   \"renders\": {\n *     \"film\": {\n *       \"title\": \"Launch film\",\n *       \"entry\": \"src/film.ts\",\n *       \"export\": \"buildFilm\",\n *       \"workers\": \"auto\"\n *     }\n *   }\n * }\n * ```\n *\n * A named render is what `framefields render film --cloud`, `framefields\n * check film`, `renderCloud({ render: \"film\" })` and the dashboard's New\n * render dialog pick, so nobody chooses files and exports by hand.\n */\nimport { existsSync, readFileSync, writeFileSync } from \"node:fs\";\nimport { join } from \"node:path\";\n\nexport const CONFIG_FILE = \"framefields.json\";\n\n/** One renderable piece of the project: an export of a module, with its defaults. */\nexport interface RenderSpec {\n\t/** The module that builds the composition, relative to the project root. */\n\tentry: string;\n\t/** A Composition, or a function returning one. Default `buildFilm`. */\n\texport?: string;\n\t/** Shown in the dashboard and `framefields renders`. Default: the name. */\n\ttitle?: string;\n\tdescription?: string;\n\t/** Passed to the export when it is a function. */\n\targs?: unknown;\n\t/** When the export returns several compositions, the one to render. */\n\tselect?: string;\n\t/** Cloud workers: 1, a number, or \"auto\" to split long films. Default 1. */\n\tworkers?: number | \"auto\";\n\tmaxWorkers?: number;\n\tcodec?: \"h264\" | \"vp9\";\n\tquality?: \"very_low\" | \"low\" | \"high\" | \"very_high\";\n\t/** Where `framefields render <name> --cloud` writes the video. */\n\toutput?: string;\n}\n\nexport interface ProjectConfig {\n\t/** Components directory, relative to the project root. */\n\tcomponents: string;\n\t/**\n\t * Font files by role (`emoji`), relative to the project root. A role\n\t * set here counts as installed: point it at your own font to use that.\n\t */\n\tfonts?: Partial<Record<string, string>>;\n\t/** Named renders, by name (letters, digits, `-`, `_`, `.`). */\n\trenders?: Record<string, RenderSpec>;\n}\n\nexport const RENDER_NAME = /^[A-Za-z0-9][\\w.-]{0,63}$/;\nconst IDENTIFIER = /^[A-Za-z_$][\\w$]*$/;\nconst QUALITIES = [\"very_low\", \"low\", \"high\", \"very_high\"];\n\n/**\n * The project's config, or the default it would get: `src/components` when\n * there is a `src`. `saved` is whether the file records a components folder.\n */\nexport function readConfig(cwd: string): {\n\tconfig: ProjectConfig;\n\tsaved: boolean;\n} {\n\tconst file = join(cwd, CONFIG_FILE);\n\tconst fallback = existsSync(join(cwd, \"src\"))\n\t\t? \"src/components\"\n\t\t: \"components\";\n\tif (!existsSync(file))\n\t\treturn { config: { components: fallback }, saved: false };\n\tlet raw: unknown;\n\ttry {\n\t\traw = JSON.parse(readFileSync(file, \"utf8\"));\n\t} catch (err) {\n\t\tthrow new Error(\n\t\t\t`${CONFIG_FILE} is not valid JSON: ${(err as Error).message}`,\n\t\t);\n\t}\n\tif (!isRecord(raw)) throw new Error(`${CONFIG_FILE} must be a JSON object`);\n\tconst { components, fonts, renders } = raw;\n\tif (components !== undefined && typeof components !== \"string\")\n\t\tthrow new Error(`${CONFIG_FILE}: \"components\" must be a directory path`);\n\tif (\n\t\tfonts !== undefined &&\n\t\t(!isRecord(fonts) ||\n\t\t\tObject.values(fonts).some((v) => typeof v !== \"string\"))\n\t)\n\t\tthrow new Error(\n\t\t\t`${CONFIG_FILE}: \"fonts\" must map roles to font file paths, e.g. { \"emoji\": \"assets/fonts/NotoColorEmoji.ttf\" }`,\n\t\t);\n\t// Other keys (a `$schema`, say) survive a rewrite.\n\tconst config = {\n\t\t...raw,\n\t\tcomponents: components ?? fallback,\n\t\t...(renders !== undefined && { renders: parseRenders(renders) }),\n\t} as ProjectConfig;\n\treturn { config, saved: components !== undefined };\n}\n\nexport function writeConfig(cwd: string, config: ProjectConfig): void {\n\twriteFileSync(\n\t\tjoin(cwd, CONFIG_FILE),\n\t\t`${JSON.stringify(config, null, \"\\t\")}\\n`,\n\t);\n}\n\n/** Validates the `renders` map; errors name the render and field at fault. */\nexport function parseRenders(value: unknown): Record<string, RenderSpec> {\n\tif (!isRecord(value))\n\t\tthrow new Error(\n\t\t\t`${CONFIG_FILE}: \"renders\" must map names to renders, e.g. { \"film\": { \"entry\": \"src/film.ts\" } }`,\n\t\t);\n\tconst out: Record<string, RenderSpec> = {};\n\tfor (const [name, spec] of Object.entries(value)) {\n\t\tconst fail = (message: string) => {\n\t\t\tthrow new Error(`${CONFIG_FILE}: renders.${name} ${message}`);\n\t\t};\n\t\tif (!RENDER_NAME.test(name))\n\t\t\tfail(\"has an invalid name: use letters, digits, -, _ and . (at most 64)\");\n\t\tif (!isRecord(spec)) fail(\"must be an object with an entry\");\n\t\tconst s = spec as Record<string, unknown>;\n\t\tif (!isRelativePath(s.entry))\n\t\t\tfail(\n\t\t\t\t'needs \"entry\": the module path inside the project, e.g. \"src/film.ts\"',\n\t\t\t);\n\t\tif (\n\t\t\ts.export !== undefined &&\n\t\t\t!(typeof s.export === \"string\" && IDENTIFIER.test(s.export))\n\t\t)\n\t\t\tfail('\"export\" must be a JavaScript identifier');\n\t\tfor (const key of [\"title\", \"description\", \"select\"] as const)\n\t\t\tif (s[key] !== undefined && typeof s[key] !== \"string\")\n\t\t\t\tfail(`\"${key}\" must be a string`);\n\t\tif (s.workers !== undefined && s.workers !== \"auto\" && !isCount(s.workers))\n\t\t\tfail('\"workers\" must be \"auto\" or a positive whole number');\n\t\tif (s.maxWorkers !== undefined && !isCount(s.maxWorkers))\n\t\t\tfail('\"maxWorkers\" must be a positive whole number');\n\t\tif (s.codec !== undefined && s.codec !== \"h264\" && s.codec !== \"vp9\")\n\t\t\tfail('\"codec\" must be \"h264\" or \"vp9\"');\n\t\tif (s.quality !== undefined && !QUALITIES.includes(s.quality as string))\n\t\t\tfail(`\"quality\" must be one of ${QUALITIES.join(\", \")}`);\n\t\tif (s.output !== undefined && typeof s.output !== \"string\")\n\t\t\tfail('\"output\" must be a file path');\n\t\tout[name] = s as unknown as RenderSpec;\n\t}\n\treturn out;\n}\n\n/**\n * The named render `name` of the project at `cwd`, or undefined when there\n * is no render by that name (an entry path, say).\n */\nexport function findRender(\n\tcwd: string,\n\tname: string,\n): (RenderSpec & { name: string }) | undefined {\n\tconst spec = readConfig(cwd).config.renders?.[name];\n\treturn spec && { ...spec, name };\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === \"object\" && value !== null && !Array.isArray(value);\n}\n\nfunction isCount(value: unknown): boolean {\n\treturn typeof value === \"number\" && Number.isInteger(value) && value >= 1;\n}\n\nfunction isRelativePath(value: unknown): boolean {\n\treturn (\n\t\ttypeof value === \"string\" &&\n\t\tvalue.length > 0 &&\n\t\t!value.startsWith(\"/\") &&\n\t\t!value.split(/[/\\\\]/).includes(\"..\")\n\t);\n}\n","/**\n * Where a cloud render gets the project from: the git repo the working\n * directory is in, at the commit checked out now. Cloud workers fetch from\n * the remote, so that commit has to be pushed; uncommitted changes are not\n * rendered.\n */\nimport { execFileSync } from \"node:child_process\";\nimport { realpathSync } from \"node:fs\";\nimport path from \"node:path\";\n\nexport interface CloudSource {\n\trepo: string;\n\tref?: string;\n\tcommit?: string;\n\t/** The project's folder inside the repo (monorepos), `.` at the root. */\n\tworkdir?: string;\n}\n\nexport interface ResolvedSource {\n\tsource: CloudSource;\n\t/** The entry relative to `source.workdir`, as the worker loads it. */\n\tentry: string;\n\t/** Things that render differently than the user may expect (uncommitted changes). */\n\twarnings: string[];\n}\n\n/** Reads repo, branch, commit and folder from git, and checks the commit is pushed. */\nexport function resolveGitSource(cwd: string, entry: string): ResolvedSource {\n\tconst git = (...args: string[]) =>\n\t\texecFileSync(\"git\", args, {\n\t\t\tcwd,\n\t\t\tencoding: \"utf8\",\n\t\t\tstdio: [\"ignore\", \"pipe\", \"pipe\"],\n\t\t}).trim();\n\tlet root: string;\n\ttry {\n\t\troot = git(\"rev-parse\", \"--show-toplevel\");\n\t} catch {\n\t\tthrow new Error(\n\t\t\t`${cwd} is not in a git repository. Cloud renders fetch the project from git: commit it and push it to a remote first.`,\n\t\t);\n\t}\n\t// git reports the root with symlinks resolved (macOS /var → /private/var).\n\tconst workdir =\n\t\tpath\n\t\t\t.relative(realpathSync(root), realpathSync(cwd))\n\t\t\t.split(path.sep)\n\t\t\t.join(\"/\") || \".\";\n\tconst relEntry = path\n\t\t.relative(cwd, path.resolve(cwd, entry))\n\t\t.split(path.sep)\n\t\t.join(\"/\");\n\tif (relEntry.startsWith(\"../\") || path.isAbsolute(relEntry))\n\t\tthrow new Error(\n\t\t\t`${entry} is outside ${cwd}; run from the project folder that contains it.`,\n\t\t);\n\n\tconst branch = git(\"rev-parse\", \"--abbrev-ref\", \"HEAD\");\n\tconst commit = git(\"rev-parse\", \"HEAD\");\n\tconst remoteName = upstreamRemote(git, branch) ?? \"origin\";\n\tlet remoteUrl: string;\n\ttry {\n\t\tremoteUrl = git(\"remote\", \"get-url\", remoteName);\n\t} catch {\n\t\tthrow new Error(\n\t\t\t`The repository has no \"${remoteName}\" remote. Push the project to a git host first.`,\n\t\t);\n\t}\n\tconst pushed = git(\"branch\", \"-r\", \"--contains\", commit);\n\tif (!pushed)\n\t\tthrow new Error(\n\t\t\t`Commit ${commit.slice(0, 7)} is not on ${remoteName}. Push it first (\\`git push\\`): cloud workers fetch the project from the remote.`,\n\t\t);\n\tconst dirty = git(\"status\", \"--porcelain\", \"--untracked-files=no\", \"--\", \".\");\n\treturn {\n\t\tsource: {\n\t\t\trepo: toHttps(remoteUrl),\n\t\t\t...(branch !== \"HEAD\" && { ref: branch }),\n\t\t\tcommit,\n\t\t\tworkdir,\n\t\t},\n\t\tentry: relEntry,\n\t\twarnings: dirty\n\t\t\t? [\n\t\t\t\t\t`Uncommitted changes are not rendered: the cloud renders commit ${commit.slice(0, 7)}.`,\n\t\t\t\t]\n\t\t\t: [],\n\t};\n}\n\nfunction upstreamRemote(\n\tgit: (...args: string[]) => string,\n\tbranch: string,\n): string | undefined {\n\tif (branch === \"HEAD\") return undefined;\n\ttry {\n\t\treturn git(\"config\", `branch.${branch}.remote`) || undefined;\n\t} catch {\n\t\treturn undefined;\n\t}\n}\n\n/** `git@github.com:acme/films.git` → `https://github.com/acme/films.git`; credentials dropped. */\nexport function toHttps(url: string): string {\n\tconst scp = /^[\\w.-]+@([^:/]+):(.+)$/.exec(url);\n\tif (scp) return `https://${scp[1]}/${scp[2]}`;\n\tconst parsed = URL.canParse(url) ? new URL(url) : undefined;\n\tif (parsed && (parsed.protocol === \"ssh:\" || parsed.protocol === \"git:\"))\n\t\treturn `https://${parsed.hostname}${parsed.pathname}`;\n\tif (parsed?.protocol === \"https:\" || parsed?.protocol === \"http:\") {\n\t\tparsed.username = \"\";\n\t\tparsed.password = \"\";\n\t\treturn parsed.toString();\n\t}\n\treturn url;\n}\n","/**\n * Cloud renders on api.framefields.dev: the project renders from git on\n * framefields' GPU workers, billed to the account that owns the API key.\n *\n * ```ts\n * import { renderCloud } from \"framefields/cloud\";\n *\n * const result = await renderCloud({\n *   render: \"film\", // a render named in framefields.json\n *   outputPath: \"output/film.mp4\",\n *   onProgress: (s) => console.log(s.status, s.progress.frames),\n * });\n * ```\n *\n * Without a framefields.json, name the module instead: `entry: \"src/film.ts\"`\n * (and `export`, `workers`, …). Options passed here override the named\n * render's.\n *\n * `workers: \"auto\"` probes the film on one worker first, then splits it into\n * as many chunks as stay efficient: short films stay on one worker, long ones\n * spread out up to `maxWorkers`. `dryRun: true` returns that plan with the\n * estimated cost and renders nothing. Aborting `signal` cancels the render;\n * GPU time already used is charged.\n */\nimport { createWriteStream } from \"node:fs\";\nimport fs from \"node:fs/promises\";\nimport path from \"node:path\";\nimport { Readable } from \"node:stream\";\nimport { pipeline } from \"node:stream/promises\";\nimport type { ReadableStream as WebReadableStream } from \"node:stream/web\";\nimport { CONFIG_FILE, findRender, readConfig } from \"../cli/config.js\";\nimport { type CloudSource, resolveGitSource } from \"./git-source.js\";\n\nexport { type CloudSource, resolveGitSource, toHttps } from \"./git-source.js\";\n\nexport const FRAMEFIELDS_API_URL = \"https://api.framefields.dev\";\n\nexport interface CloudRenderOptions {\n\t/** A render named in `cwd`'s framefields.json; its fields are the defaults here. */\n\trender?: string;\n\t/** The module that builds the composition, relative to `cwd`. Required without `render`. */\n\tentry?: string;\n\t/** Its export: a Composition, or a function returning one. Default `buildFilm`. */\n\texport?: string;\n\t/** Passed to the export when it is a function. */\n\targs?: unknown;\n\t/** When the export returns several compositions, the one to render. */\n\tselect?: string;\n\t/** 1 (default) renders on one worker; a number or \"auto\" splits the film. */\n\tworkers?: number | \"auto\";\n\t/** Upper bound for \"auto\" (the API caps it too). */\n\tmaxWorkers?: number;\n\tcodec?: \"h264\" | \"vp9\";\n\tquality?: string;\n\t/** Probe and plan only: returns the plan and estimated cost, renders nothing. */\n\tdryRun?: boolean;\n\t/** Download the finished video here. */\n\toutputPath?: string;\n\t/** Project folder. Default `process.cwd()`. */\n\tcwd?: string;\n\t/** Instead of reading repo, branch and commit from git. */\n\tsource?: CloudSource;\n\t/** Default `process.env.FRAMEFIELDS_API_KEY`. */\n\tapiKey?: string;\n\t/** Default `process.env.FRAMEFIELDS_API_URL`, else https://api.framefields.dev. */\n\tapiUrl?: string;\n\t/** Called with every status poll. */\n\tonProgress?: (status: CloudRenderStatus) => void;\n\t/** Called for each warning (uncommitted changes). Default: stderr. */\n\tonWarning?: (message: string) => void;\n\t/** Aborting cancels the cloud render. */\n\tsignal?: AbortSignal;\n\t/** Status poll interval, ms. Default 3000. */\n\tpollMs?: number;\n}\n\nexport type CloudRenderPhase =\n\t| \"probing\"\n\t| \"holding\"\n\t| \"rendering\"\n\t| \"stitching\"\n\t| \"planned\"\n\t| \"completed\"\n\t| \"failed\"\n\t| \"cancelled\";\n\nexport interface CloudRenderPlan {\n\tworkers: number;\n\t/** Render time of the whole film on one GPU, seconds. */\n\tworkSec: number;\n\t/** Expected wall time with this plan, seconds. */\n\tetaSec: number;\n\tchunks: { start: number; end: number; workSec: number }[];\n}\n\nexport interface CloudRenderStatus {\n\tid: string;\n\tstatus: CloudRenderPhase;\n\tworkers: number;\n\tplan?: CloudRenderPlan;\n\tprogress: {\n\t\tframes: number;\n\t\ttotalFrames: number | null;\n\t\tetaSec: number | null;\n\t};\n\t/** Charged so far (final once the render ended), USD. */\n\tcostUsd: number;\n\tgpuSeconds: number;\n\t/** The planned render's estimated charge, USD. */\n\testimateUsd?: number;\n\t/** The commit rendered. */\n\tsha?: string;\n\toutput?: { url: string; bytes?: number };\n\terror?: { code: string; message: string };\n}\n\nexport interface CloudRenderResult extends CloudRenderStatus {\n\t/** Where the video was downloaded (`outputPath`). */\n\tfilePath?: string;\n}\n\n/** A cloud render that failed, was cancelled, or was refused by the API. */\nexport class CloudRenderError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\treadonly code: string,\n\t\treadonly status?: CloudRenderStatus,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = \"CloudRenderError\";\n\t}\n}\n\nconst DONE = new Set<CloudRenderPhase>([\n\t\"planned\",\n\t\"completed\",\n\t\"failed\",\n\t\"cancelled\",\n]);\n\n/** Starts a cloud render and waits for it; resolves when it completed (or was planned). */\nexport async function renderCloud(\n\toptions: CloudRenderOptions,\n): Promise<CloudRenderResult> {\n\tconst api = cloudClient(options);\n\tconst cwd = options.cwd ?? process.cwd();\n\tconst o = withNamedRender(cwd, options);\n\tconst resolved = options.source\n\t\t? { source: options.source, entry: o.entry, warnings: [] }\n\t\t: resolveGitSource(cwd, o.entry);\n\tconst warn =\n\t\toptions.onWarning ??\n\t\t((m: string) => process.stderr.write(`framefields: ${m}\\n`));\n\tfor (const w of resolved.warnings) warn(w);\n\n\tlet status = await api.start({\n\t\tsource: resolved.source,\n\t\ttarget: {\n\t\t\tentry: resolved.entry,\n\t\t\texport: o.export ?? \"buildFilm\",\n\t\t\t...(o.args !== undefined && { args: o.args }),\n\t\t\t...(o.select && { select: [o.select] }),\n\t\t},\n\t\trender: {\n\t\t\tcodec: o.codec ?? \"h264\",\n\t\t\t...(o.quality && { quality: o.quality }),\n\t\t},\n\t\tworkers: o.workers ?? 1,\n\t\t...(o.maxWorkers && { max_workers: o.maxWorkers }),\n\t\tdry_run: options.dryRun ?? false,\n\t\t...(o.name && { name: o.name }),\n\t\t...(o.title && { title: o.title }),\n\t});\n\toptions.onProgress?.(status);\n\n\ttry {\n\t\twhile (!DONE.has(status.status)) {\n\t\t\tawait sleep(options.pollMs ?? 3000, options.signal);\n\t\t\tstatus = await api.status(status.id);\n\t\t\toptions.onProgress?.(status);\n\t\t}\n\t} catch (err) {\n\t\tif (options.signal?.aborted) {\n\t\t\tconst final = await api.cancel(status.id).catch(() => status);\n\t\t\tthrow new CloudRenderError(\n\t\t\t\t\"The cloud render was cancelled.\",\n\t\t\t\t\"cancelled\",\n\t\t\t\tfinal,\n\t\t\t);\n\t\t}\n\t\tthrow err;\n\t}\n\n\tif (status.status === \"failed\" || status.status === \"cancelled\")\n\t\tthrow new CloudRenderError(\n\t\t\tstatus.error\n\t\t\t\t? `Cloud render ${status.status}: ${status.error.message} (${status.error.code})`\n\t\t\t\t: `Cloud render ${status.status}.`,\n\t\t\tstatus.error?.code ?? status.status,\n\t\t\tstatus,\n\t\t);\n\tif (status.status === \"completed\" && options.outputPath && status.output) {\n\t\tawait download(status.output.url, options.outputPath, options.signal);\n\t\treturn { ...status, filePath: options.outputPath };\n\t}\n\treturn status;\n}\n\n/**\n * The options with a named render's fields filled in where the caller left\n * them out, plus the name and title the dashboard shows.\n */\nexport function withNamedRender(\n\tcwd: string,\n\toptions: CloudRenderOptions,\n): CloudRenderOptions & { entry: string; name?: string; title?: string } {\n\tif (!options.render) {\n\t\tif (!options.entry)\n\t\t\tthrow new CloudRenderError(\n\t\t\t\t\"Name a render from framefields.json (render) or a module (entry).\",\n\t\t\t\t\"invalid_request\",\n\t\t\t);\n\t\treturn { ...options, entry: options.entry };\n\t}\n\tconst spec = findRender(cwd, options.render);\n\tif (!spec) {\n\t\tconst names = Object.keys(readConfig(cwd).config.renders ?? {});\n\t\tthrow new CloudRenderError(\n\t\t\tnames.length\n\t\t\t\t? `No render named \"${options.render}\" in ${CONFIG_FILE}. Renders: ${names.join(\", \")}.`\n\t\t\t\t: `No render named \"${options.render}\": ${CONFIG_FILE} has no \"renders\".`,\n\t\t\t\"render_not_found\",\n\t\t);\n\t}\n\tconst defined = Object.fromEntries(\n\t\tObject.entries(options).filter(([, v]) => v !== undefined),\n\t) as CloudRenderOptions;\n\treturn {\n\t\tentry: spec.entry,\n\t\texport: spec.export,\n\t\targs: spec.args,\n\t\tselect: spec.select,\n\t\tworkers: spec.workers,\n\t\tmaxWorkers: spec.maxWorkers,\n\t\tcodec: spec.codec,\n\t\tquality: spec.quality,\n\t\t...defined,\n\t\tname: spec.name,\n\t\ttitle: spec.title ?? spec.name,\n\t} as CloudRenderOptions & { entry: string; name: string; title: string };\n}\n\n/** The API calls behind `renderCloud`, for callers who track renders themselves. */\nexport function cloudClient(\n\toptions: Pick<CloudRenderOptions, \"apiKey\" | \"apiUrl\">,\n) {\n\tconst key = options.apiKey ?? process.env.FRAMEFIELDS_API_KEY;\n\tif (!key)\n\t\tthrow new CloudRenderError(\n\t\t\t\"No API key. Set FRAMEFIELDS_API_KEY (keys at https://framefields.dev/dashboard/keys) or pass apiKey.\",\n\t\t\t\"invalid_api_key\",\n\t\t);\n\tconst base = (\n\t\toptions.apiUrl ??\n\t\tprocess.env.FRAMEFIELDS_API_URL ??\n\t\tFRAMEFIELDS_API_URL\n\t).replace(/\\/+$/, \"\");\n\tconst call = async (method: string, route: string, body?: unknown) => {\n\t\tconst res = await fetch(`${base}/v1/render${route}`, {\n\t\t\tmethod,\n\t\t\theaders: {\n\t\t\t\tAuthorization: `Bearer ${key}`,\n\t\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t},\n\t\t\t...(body !== undefined && { body: JSON.stringify(body) }),\n\t\t});\n\t\tconst json = (await res.json().catch(() => ({}))) as ApiStatus & {\n\t\t\terror?: { type?: string; message?: string };\n\t\t};\n\t\tif (!res.ok)\n\t\t\tthrow new CloudRenderError(\n\t\t\t\tjson.error?.message ??\n\t\t\t\t\t`api.framefields.dev answered HTTP ${res.status}`,\n\t\t\t\tjson.error?.type ?? `http_${res.status}`,\n\t\t\t);\n\t\treturn fromApi(json);\n\t};\n\treturn {\n\t\tstart: (body: unknown) => call(\"POST\", \"\", body),\n\t\tstatus: (id: string) => call(\"GET\", `/${encodeURIComponent(id)}`),\n\t\tcancel: (id: string) => call(\"DELETE\", `/${encodeURIComponent(id)}`),\n\t};\n}\n\n/** The API's snake_case status. */\ninterface ApiStatus {\n\tid: string;\n\tstatus: CloudRenderPhase;\n\tworkers?: number;\n\tplan?: {\n\t\tworkers: number;\n\t\twork_sec: number;\n\t\teta_sec: number;\n\t\tchunks: CloudRenderPlan[\"chunks\"];\n\t};\n\tprogress?: {\n\t\tframes?: number;\n\t\ttotal_frames?: number | null;\n\t\teta_sec?: number | null;\n\t};\n\tcost_usd?: number;\n\tgpu_seconds?: number;\n\testimate_usd?: number;\n\tsha?: string;\n\toutput?: { url: string; bytes?: number };\n\terror?: { code: string; message: string };\n}\n\nfunction fromApi(s: ApiStatus): CloudRenderStatus {\n\treturn {\n\t\tid: s.id,\n\t\tstatus: s.status,\n\t\tworkers: s.workers ?? 1,\n\t\t...(s.plan && {\n\t\t\tplan: {\n\t\t\t\tworkers: s.plan.workers,\n\t\t\t\tworkSec: s.plan.work_sec,\n\t\t\t\tetaSec: s.plan.eta_sec,\n\t\t\t\tchunks: s.plan.chunks,\n\t\t\t},\n\t\t}),\n\t\tprogress: {\n\t\t\tframes: s.progress?.frames ?? 0,\n\t\t\ttotalFrames: s.progress?.total_frames ?? null,\n\t\t\tetaSec: s.progress?.eta_sec ?? null,\n\t\t},\n\t\tcostUsd: s.cost_usd ?? 0,\n\t\tgpuSeconds: s.gpu_seconds ?? 0,\n\t\t...(s.estimate_usd !== undefined && { estimateUsd: s.estimate_usd }),\n\t\t...(s.sha && { sha: s.sha }),\n\t\t...(s.output && { output: s.output }),\n\t\t...(s.error && { error: s.error }),\n\t};\n}\n\nasync function download(url: string, file: string, signal?: AbortSignal) {\n\tconst res = await fetch(url, { signal });\n\tif (!res.ok || !res.body)\n\t\tthrow new CloudRenderError(\n\t\t\t`Downloading the render failed: HTTP ${res.status}`,\n\t\t\t\"download_failed\",\n\t\t);\n\tawait fs.mkdir(path.dirname(path.resolve(file)), { recursive: true });\n\tawait pipeline(\n\t\tReadable.fromWeb(res.body as WebReadableStream),\n\t\tcreateWriteStream(file),\n\t);\n}\n\nfunction sleep(ms: number, signal?: AbortSignal): Promise<void> {\n\treturn new Promise((resolve, reject) => {\n\t\tif (signal?.aborted) return reject(signal.reason);\n\t\tconst timer = setTimeout(resolve, ms);\n\t\tsignal?.addEventListener(\n\t\t\t\"abort\",\n\t\t\t() => {\n\t\t\t\tclearTimeout(timer);\n\t\t\t\treject(signal.reason);\n\t\t\t},\n\t\t\t{ once: true },\n\t\t);\n\t});\n}\n"],"mappings":"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"}