@oeave/bakery3 0.0.0-stage → 0.2.0

package/dist/chunk-ZEBVAIJJ.js

@@ -0,0 +1,156 @@
+import { Bakery3Error } from './chunk-3G5QL4F4.js';
+
+// src/set.ts
+var RenderSet = class {
+  /** The batch underneath: pause, resume, retry, the export. */
+  batch;
+  id;
+  key;
+  /** What the call that made this set recorded. Empty for a set fetched by id. */
+  recorded;
+  /** Item key → position, for a set small enough to have asked for an order. */
+  order;
+  constructor(batch, recorded = emptyRecorded()) {
+    this.batch = batch;
+    this.id = batch.id;
+    this.key = batch.key;
+    this.recorded = recorded;
+  }
+  /** Counts and cost from the latest record. No request. */
+  progress() {
+    return this.batch.progress();
+  }
+  /**
+   * Until every picture is terminal. One long-poll on the set, however many
+   * pictures it has. Resolves with the final counts: pictures that failed
+   * are in `failures()`, they do not reject the wait.
+   */
+  async wait(options = {}) {
+    await this.batch.wait(options);
+    return this.batch.progress();
+  }
+  /**
+   * Every finished picture, a page at a time. Safe on a set of any size,
+   * and safe to call before the set is done: it walks what has completed
+   * so far.
+   */
+  async *images() {
+    for await (const item of this.batch.items({ state: "completed" })) {
+      if (!item.result) continue;
+      yield {
+        key: item.key,
+        id: item.id,
+        ...who(item.metadata),
+        url: item.result.url,
+        width: item.result.width,
+        height: item.result.height,
+        cost: item.result.cost,
+        ...item.metadata ? { metadata: item.metadata } : {},
+        result: item.result
+      };
+    }
+  }
+  /**
+   * Every picture that did not render, with the reason and the fix.
+   * `error.retryable` tells the two kinds apart: false is a refusal, the
+   * scene's fault and the same next time; true ran out of attempts on a
+   * fault of ours, and `set.batch.retry()` queues it again.
+   */
+  async *failures() {
+    for await (const item of this.batch.items({ state: "failed" })) {
+      yield {
+        key: item.key,
+        id: item.id,
+        ...who(item.metadata),
+        error: item.error ? Bakery3Error.from(item.error) : new Bakery3Error({
+          code: "WorkerFailure",
+          message: "Ended with no result and no reason.",
+          retryable: true
+        }),
+        ...item.metadata ? { metadata: item.metadata } : {}
+      };
+    }
+  }
+  /**
+   * Wait, then every picture in one array, in camera order for a
+   * `render({ cameras })`: one picture per camera, or a rejection. Rejects
+   * with `RenderSetRefused` when a picture was turned down at submission
+   * (it has no render, and the array would be one short with every later
+   * picture in the wrong place), and otherwise with the first failure, as
+   * `job.result()` does. The pictures that did render are still there:
+   * walk `images()`, each named by its `camera`.
+   *
+   * It collects, so it is for a handful of pictures. For a catalog, walk
+   * `images()`.
+   */
+  async result(options = {}) {
+    await this.wait(options);
+    if (this.recorded.refused > 0) throw new RenderSetRefused(this.recorded);
+    for await (const failure of this.failures()) throw failure.error;
+    const images = [];
+    for await (const image of this.images()) images.push(image);
+    const order = this.order;
+    if (order)
+      images.sort((a, b) => (order.get(a.key) ?? 0) - (order.get(b.key) ?? 0));
+    return images;
+  }
+  /** Cancel every picture that has not finished. What completed, completed. */
+  async cancel() {
+    await this.batch.cancel();
+  }
+  /** @internal */
+  ordered(keys) {
+    this.order = new Map(keys.map((key, index) => [key, index]));
+    return this;
+  }
+};
+var RenderSetRefused = class extends Bakery3Error {
+  /** Which pictures, and why: the first fifty when a run refused more. */
+  refusals;
+  /** How many were refused in all. */
+  refused;
+  /** How many pictures were asked for. */
+  requested;
+  constructor(recorded) {
+    const first = recorded.refusals[0];
+    const names = recorded.refusals.slice(0, 3).map(describeRefusal);
+    const more = recorded.refused - names.length;
+    super({
+      code: first?.error.code ?? "InvalidRequest",
+      message: `${recorded.refused} of ${recorded.images} pictures ${recorded.refused === 1 ? "was" : "were"} refused: ${names.join("; ")}${more > 0 ? `; and ${more} more` : ""}.`,
+      why: "A picture refused when it was submitted never renders. An array of the rest would be shorter than the list you asked for, with every later picture in the wrong place, so result() gives none.",
+      fix: "Read error.refusals for each refused picture and its reason. The pictures that were accepted still render: set.images() walks them, each named by its camera.",
+      docs: "https://bakery3.com/docs/batches#errors",
+      retryable: false
+    });
+    this.name = "RenderSetRefused";
+    this.refusals = recorded.refusals.map(({ error, ...who2 }) => ({
+      ...who2,
+      error: Bakery3Error.from(error)
+    }));
+    this.refused = recorded.refused;
+    this.requested = recorded.images;
+  }
+};
+function describeRefusal(refusal) {
+  const name = [refusal.variant, refusal.finish, refusal.camera, refusal.shot].filter(Boolean).join(" / ") || refusal.key;
+  return `"${name}" (${refusal.error.message.replace(/\.$/, "")})`;
+}
+function who(metadata) {
+  const out = {};
+  if (typeof metadata?.variant === "string") out.variant = metadata.variant;
+  else if (typeof metadata?.sku === "string") out.variant = metadata.sku;
+  if (typeof metadata?.finish === "string") out.finish = metadata.finish;
+  if (typeof metadata?.camera === "string") out.camera = metadata.camera;
+  if (typeof metadata?.shot === "string") out.shot = metadata.shot;
+  if (metadata?.kind === "video" || metadata?.kind === "image")
+    out.kind = metadata.kind;
+  return out;
+}
+function emptyRecorded() {
+  return { variants: 0, images: 0, adopted: 0, refused: 0, refusals: [] };
+}
+
+export { RenderSet, RenderSetRefused, emptyRecorded, who };
+//# sourceMappingURL=chunk-ZEBVAIJJ.js.map
+//# sourceMappingURL=chunk-ZEBVAIJJ.js.map

package/dist/chunk-ZEBVAIJJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/set.ts"],"names":["who"],"mappings":"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","file":"chunk-ZEBVAIJJ.js","sourcesContent":["/**\n * A set of pictures: what every many-pictures call hands back.\n *\n * `render({ cameras })` and `renderVariants()` in the browser, and\n * `renderBatch()` from Node, all record into a batch and return one of\n * these, so a set of three and a catalog of six thousand are the same object\n * with the same guarantees: one ceiling for all of it, one poll for all of\n * it, results walked a page at a time and never held.\n *\n * No three.js here: the server entry imports this file.\n */\n\nimport type { RenderError, RenderResult } from './protocol/index.js';\nimport type { Batch, BatchProgress, WaitOptions } from './batch.js';\nimport { Bakery3Error } from './errors.js';\n\n/** One finished picture of a set. */\nexport type RenderSetImage = {\n  /** The item's key: `variant/finish/camera`, as recorded. */\n  key: string;\n  /** The render's id. */\n  id: string;\n  variant?: string;\n  finish?: string;\n  camera?: string;\n  /** The shot this is, for a set recorded with shots. */\n  shot?: string;\n  /** `'video'` when the url is a clip. */\n  kind?: 'image' | 'video';\n  /** Signed and expiring. Copy the bytes; do not serve from it. */\n  url: string;\n  width: number;\n  height: number;\n  /** What this picture cost. Nothing, when it was adopted from an earlier run. */\n  cost: number;\n  metadata?: Record<string, unknown>;\n  result: RenderResult;\n};\n\n/** One picture that did not render, and why. */\nexport type RenderSetFailure = {\n  key: string;\n  id: string;\n  variant?: string;\n  finish?: string;\n  camera?: string;\n  shot?: string;\n  error: Bakery3Error;\n  metadata?: Record<string, unknown>;\n};\n\n/** One picture turned down when it was submitted: it has no render and never will. */\nexport type RenderSetRefusal = {\n  key: string;\n  variant?: string;\n  finish?: string;\n  camera?: string;\n  shot?: string;\n  error: RenderError;\n};\n\n/** What a recording did, in numbers small enough to keep. */\nexport type Recorded = {\n  variants: number;\n  images: number;\n  /** Already rendered under their keys in an earlier run. Cost nothing. */\n  adopted: number;\n  /** Turned down alone at admission (a spec that does not parse, an item over its own ceiling). */\n  refused: number;\n  /** The first of those, with their reasons. Capped, because a broken pipeline refuses every item. */\n  refusals: RenderSetRefusal[];\n};\n\n/** What a whole run would cost, from `quoteVariants()`. Nothing was admitted. */\nexport type VariantsQuote = Recorded & {\n  /** Σ estimate over the pictures that would render. */\n  estimated: number;\n  /** Σ maximum: what admission would reserve, and the number to set `maxCost` from. */\n  maximum: number;\n};\n\nexport class RenderSet {\n  /** The batch underneath: pause, resume, retry, the export. */\n  readonly batch: Batch;\n  readonly id: string;\n  readonly key: string;\n  /** What the call that made this set recorded. Empty for a set fetched by id. */\n  readonly recorded: Recorded;\n  /** Item key → position, for a set small enough to have asked for an order. */\n  private order?: Map<string, number>;\n\n  constructor(batch: Batch, recorded: Recorded = emptyRecorded()) {\n    this.batch = batch;\n    this.id = batch.id;\n    this.key = batch.key;\n    this.recorded = recorded;\n  }\n\n  /** Counts and cost from the latest record. No request. */\n  progress(): BatchProgress {\n    return this.batch.progress();\n  }\n\n  /**\n   * Until every picture is terminal. One long-poll on the set, however many\n   * pictures it has. Resolves with the final counts: pictures that failed\n   * are in `failures()`, they do not reject the wait.\n   */\n  async wait(options: WaitOptions = {}): Promise<BatchProgress> {\n    await this.batch.wait(options);\n    return this.batch.progress();\n  }\n\n  /**\n   * Every finished picture, a page at a time. Safe on a set of any size,\n   * and safe to call before the set is done: it walks what has completed\n   * so far.\n   */\n  async *images(): AsyncIterable<RenderSetImage> {\n    for await (const item of this.batch.items({ state: 'completed' })) {\n      if (!item.result) continue;\n      yield {\n        key: item.key,\n        id: item.id,\n        ...who(item.metadata),\n        url: item.result.url,\n        width: item.result.width,\n        height: item.result.height,\n        cost: item.result.cost,\n        ...(item.metadata ? { metadata: item.metadata } : {}),\n        result: item.result,\n      };\n    }\n  }\n\n  /**\n   * Every picture that did not render, with the reason and the fix.\n   * `error.retryable` tells the two kinds apart: false is a refusal, the\n   * scene's fault and the same next time; true ran out of attempts on a\n   * fault of ours, and `set.batch.retry()` queues it again.\n   */\n  async *failures(): AsyncIterable<RenderSetFailure> {\n    for await (const item of this.batch.items({ state: 'failed' })) {\n      yield {\n        key: item.key,\n        id: item.id,\n        ...who(item.metadata),\n        error: item.error\n          ? Bakery3Error.from(item.error)\n          : new Bakery3Error({\n              code: 'WorkerFailure',\n              message: 'Ended with no result and no reason.',\n              retryable: true,\n            }),\n        ...(item.metadata ? { metadata: item.metadata } : {}),\n      };\n    }\n  }\n\n  /**\n   * Wait, then every picture in one array, in camera order for a\n   * `render({ cameras })`: one picture per camera, or a rejection. Rejects\n   * with `RenderSetRefused` when a picture was turned down at submission\n   * (it has no render, and the array would be one short with every later\n   * picture in the wrong place), and otherwise with the first failure, as\n   * `job.result()` does. The pictures that did render are still there:\n   * walk `images()`, each named by its `camera`.\n   *\n   * It collects, so it is for a handful of pictures. For a catalog, walk\n   * `images()`.\n   */\n  async result(options: WaitOptions = {}): Promise<RenderSetImage[]> {\n    await this.wait(options);\n    if (this.recorded.refused > 0) throw new RenderSetRefused(this.recorded);\n    for await (const failure of this.failures()) throw failure.error;\n    const images: RenderSetImage[] = [];\n    for await (const image of this.images()) images.push(image);\n    const order = this.order;\n    if (order)\n      images.sort((a, b) => (order.get(a.key) ?? 0) - (order.get(b.key) ?? 0));\n    return images;\n  }\n\n  /** Cancel every picture that has not finished. What completed, completed. */\n  async cancel(): Promise<void> {\n    await this.batch.cancel();\n  }\n\n  /** @internal */\n  ordered(keys: string[]): this {\n    this.order = new Map(keys.map((key, index) => [key, index]));\n    return this;\n  }\n}\n\n/**\n * Pictures of a set were turned down when they were submitted, so the set\n * cannot give one picture per camera (or per variant) in order.\n *\n * `refusals` says which and why. Its `code` is the first refusal's. The\n * pictures that were accepted render as usual: `set.images()` walks them.\n */\nexport class RenderSetRefused extends Bakery3Error {\n  /** Which pictures, and why: the first fifty when a run refused more. */\n  readonly refusals: Array<\n    Omit<RenderSetRefusal, 'error'> & { error: Bakery3Error }\n  >;\n  /** How many were refused in all. */\n  readonly refused: number;\n  /** How many pictures were asked for. */\n  readonly requested: number;\n\n  constructor(recorded: Recorded) {\n    const first = recorded.refusals[0];\n    const names = recorded.refusals.slice(0, 3).map(describeRefusal);\n    const more = recorded.refused - names.length;\n    super({\n      code: first?.error.code ?? 'InvalidRequest',\n      message: `${recorded.refused} of ${recorded.images} pictures ${recorded.refused === 1 ? 'was' : 'were'} refused: ${names.join('; ')}${more > 0 ? `; and ${more} more` : ''}.`,\n      why: 'A picture refused when it was submitted never renders. An array of the rest would be shorter than the list you asked for, with every later picture in the wrong place, so result() gives none.',\n      fix: 'Read error.refusals for each refused picture and its reason. The pictures that were accepted still render: set.images() walks them, each named by its camera.',\n      docs: 'https://bakery3.com/docs/batches#errors',\n      retryable: false,\n    });\n    this.name = 'RenderSetRefused';\n    this.refusals = recorded.refusals.map(({ error, ...who }) => ({\n      ...who,\n      error: Bakery3Error.from(error),\n    }));\n    this.refused = recorded.refused;\n    this.requested = recorded.images;\n  }\n}\n\nfunction describeRefusal(refusal: RenderSetRefusal): string {\n  const name =\n    [refusal.variant, refusal.finish, refusal.camera, refusal.shot]\n      .filter(Boolean)\n      .join(' / ') || refusal.key;\n  return `\"${name}\" (${refusal.error.message.replace(/\\.$/, '')})`;\n}\n\n/** The variant, finish, camera and shot an item was recorded under, from its metadata. */\nexport function who(\n  metadata: Record<string, unknown> | undefined,\n): Pick<RenderSetImage, 'variant' | 'finish' | 'camera' | 'shot' | 'kind'> {\n  const out: Pick<\n    RenderSetImage,\n    'variant' | 'finish' | 'camera' | 'shot' | 'kind'\n  > = {};\n  if (typeof metadata?.variant === 'string') out.variant = metadata.variant;\n  // The catalog recorder's own word for it.\n  else if (typeof metadata?.sku === 'string') out.variant = metadata.sku;\n  if (typeof metadata?.finish === 'string') out.finish = metadata.finish;\n  if (typeof metadata?.camera === 'string') out.camera = metadata.camera;\n  if (typeof metadata?.shot === 'string') out.shot = metadata.shot;\n  if (metadata?.kind === 'video' || metadata?.kind === 'image')\n    out.kind = metadata.kind;\n  return out;\n}\n\nexport function emptyRecorded(): Recorded {\n  return { variants: 0, images: 0, adopted: 0, refused: 0, refusals: [] };\n}\n"]}