@oeave/bakery3 0.0.0-stage → 0.2.0

package/dist/catalog/index.d.ts

@@ -0,0 +1,100 @@
+import { Scene, Object3D } from 'three';
+import { Q as QualityPreset, O as OutputSpec } from '../bake-DZ-CJR6f.js';
+import { B as BatchProgress, V as VariantsQuote, a as BatchRecord } from '../testRun-20OARnQr.js';
+export { b as Batch } from '../testRun-20OARnQr.js';
+import { CatalogCamera, CatalogFinish, Bakery3 } from '../index.js';
+import { R as RoomPresetName, a as RoomPresetLighting } from '../rooms.gen-DItzBR9k.js';
+import '../animation-B1h0Ryvj.js';
+import '../timeline-ChwgD7bT.js';
+import '../prepare-BtjY4G3q.js';
+
+/**
+ * @oeave/bakery3/catalog: render a catalog of products × finishes × cameras
+ * from the browser.
+ *
+ *     import { runCatalog } from '@oeave/bakery3/catalog';
+ *
+ *     await runCatalog(bakery3, catalog, {
+ *       scene,
+ *       loadProduct: (url) => loadGltf(url),
+ *       onProgress: ({ product, done, total, cost }) => setStatus(`${product}: ${done}/${total}`),
+ *     });
+ *
+ * The work is declared as data (`Catalog`) and the recorder walks it with one
+ * product resident at a time: load, mount, capture once (the model with every
+ * finish inside it is exported and uploaded once), then one small manifest
+ * per finish × camera that differs only in `camera` and `hiddenObjectIds`,
+ * flushed as pages to the batch, then the product is removed and disposed.
+ * Peak memory is one product plus one page of manifests, whatever the
+ * catalog's size.
+ *
+ * A recorder that dies half way is resumed by running it again: the batch key
+ * re-opens the same batch and every item already `completed` is adopted at no
+ * cost.
+ */
+
+type CatalogProduct = {
+    /** Unique in the catalog; it is the item key and the `sku` in metadata. */
+    id: string;
+    /** The model, with every finish inside; the recorder hides the others per render. */
+    url: string;
+    /** At least one. `{ id, show: [] }` shows the product as loaded. */
+    finishes: CatalogFinish[];
+};
+type Catalog = {
+    /** Stable across re-runs: the batch's idempotency key. */
+    key: string;
+    /** A label for the console. */
+    name?: string;
+    quality: QualityPreset;
+    output: OutputSpec;
+    /** Ceiling for the whole run, in USD. A page that would cross it is refused, never charged. */
+    maxCost: number;
+    /** At least one; every product is shot from each. */
+    cameras: CatalogCamera[];
+    /** A preset room to photograph in, added for the run when the scene has none. */
+    room?: {
+        preset: RoomPresetName;
+        mode?: RoomPresetLighting;
+    };
+    products: CatalogProduct[];
+};
+type CatalogProgress = BatchProgress & {
+    /** The product just flushed. */
+    product: string;
+};
+type RunCatalogOptions = {
+    /** Your live scene: lights, room, environment. */
+    scene: Scene;
+    /** Your loader, with your own draco/ktx setup. */
+    loadProduct: (url: string) => Promise<Object3D> | Object3D;
+    /**
+     * Products resident at a time. `1` is the point of the recorder and the
+     * only value supported; anything else is refused rather than silently run
+     * as 1.
+     */
+    concurrency?: 1;
+    /** Called after each product's items are flushed. */
+    onProgress?: (progress: CatalogProgress) => void;
+    /**
+     * Stops between products. What was flushed stays admitted; the batch is
+     * left open so the same run can be resumed.
+     */
+    signal?: AbortSignal;
+};
+/**
+ * Record and submit the whole catalog, then seal the batch. Resolves with the
+ * sealed batch record; the pictures render on from there (`batch.wait()` or
+ * a webhook says when). Run it again with the same key to resume.
+ */
+declare function runCatalog(bakery3: Bakery3, catalog: Catalog, options: RunCatalogOptions): Promise<BatchRecord>;
+/**
+ * The same walk, priced instead of submitted: every product is loaded and
+ * captured, every item is quoted, and nothing is uploaded, admitted or
+ * reserved. The `maximum` it returns is the number to set `maxCost` from;
+ * pictures an earlier run already rendered are counted as adopted, at
+ * nothing, so after a change this is the price of the re-run.
+ */
+declare function quoteCatalog(bakery3: Bakery3, catalog: Catalog, options: RunCatalogOptions): Promise<VariantsQuote>;
+
+export { BatchProgress, type Catalog, CatalogCamera, CatalogFinish, type CatalogProduct, type CatalogProgress, type RunCatalogOptions, VariantsQuote, quoteCatalog, runCatalog };

package/dist/catalog/index.js

@@ -0,0 +1,154 @@
+import { record, disposeTree } from '../chunk-XK35ANPJ.js';
+import '../chunk-ZEBVAIJJ.js';
+import '../chunk-62M6XXNX.js';
+import { Bakery3Error } from '../chunk-3G5QL4F4.js';
+
+// src/catalog/index.ts
+async function runCatalog(bakery3, catalog, options) {
+  validate(catalog, options);
+  const batch = await bakery3.batches.open({
+    key: catalog.key,
+    ...catalog.name ? { name: catalog.name } : {},
+    maxCost: catalog.maxCost,
+    lane: "batch"
+  });
+  await walk(bakery3, batch, catalog, options, false);
+  return batch.close();
+}
+async function quoteCatalog(bakery3, catalog, options) {
+  validate(catalog, options);
+  const batch = await bakery3.batches.open({
+    key: catalog.key,
+    ...catalog.name ? { name: catalog.name } : {},
+    maxCost: catalog.maxCost,
+    lane: "batch"
+  });
+  return walk(bakery3, batch, catalog, options, true);
+}
+async function walk(bakery3, batch, catalog, options, dryRun) {
+  const room = await mountRoom(options.scene, catalog.room);
+  try {
+    return await record({
+      host: bakery3,
+      batch,
+      scene: options.scene,
+      variants: catalog.products,
+      idOf: (product) => product.id,
+      apply: async (product) => {
+        const root = await options.loadProduct(product.url);
+        options.scene.add(root);
+        return () => {
+          options.scene.remove(root);
+          disposeTree(root);
+        };
+      },
+      finishesOf: (product) => product.finishes,
+      cameras: catalog.cameras,
+      output: catalog.output,
+      spec: (manifest) => ({
+        manifest,
+        quality: catalog.quality,
+        output: catalog.output
+      }),
+      metadataOf: (_product, ids) => ({
+        sku: ids.variant,
+        finish: ids.finish,
+        camera: ids.camera
+      }),
+      dryRun,
+      ...options.signal ? { signal: options.signal } : {},
+      onVariant: ({
+        variant,
+        variants: _variants,
+        images: _images,
+        upload: _upload,
+        ...progress
+      }) => options.onProgress?.({ ...progress, product: variant })
+    });
+  } finally {
+    room?.();
+  }
+}
+function validate(catalog, options) {
+  validateCatalog(catalog);
+  if (options.concurrency !== void 0 && options.concurrency !== 1) {
+    throw new Bakery3Error({
+      code: "InvalidRequest",
+      message: `concurrency: ${options.concurrency} is not supported; the recorder holds one product at a time.`,
+      why: "Bounded memory is the reason runCatalog() exists. One product resident is the bound.",
+      fix: "Remove `concurrency`, or set it to 1.",
+      docs: "https://bakery3.com/docs/api"
+    });
+  }
+}
+async function mountRoom(scene, room) {
+  if (!room) return void 0;
+  const { createPresetRoom, findPresetRooms } = await import('../room-FS26KAPQ.js');
+  if (findPresetRooms(scene).length) return void 0;
+  const group = createPresetRoom(
+    room.preset,
+    room.mode ? { lighting: room.mode } : {}
+  );
+  scene.add(group);
+  return () => {
+    scene.remove(group);
+    disposeTree(group);
+  };
+}
+function validateCatalog(catalog) {
+  const refuse = (message, fix) => new Bakery3Error({
+    code: "InvalidRequest",
+    message,
+    why: "The catalog is the recorder's whole input; a hole in it would be a hole in the batch.",
+    fix,
+    docs: "https://bakery3.com/docs/api"
+  });
+  if (!catalog.key)
+    throw refuse(
+      "The catalog has no key.",
+      "Give it a stable key: it is the batch's idempotency key."
+    );
+  if (!catalog.cameras.length)
+    throw refuse("The catalog has no cameras.", "Declare at least one camera.");
+  if (!(catalog.maxCost > 0))
+    throw refuse(
+      "The catalog has no maxCost.",
+      "Set the ceiling for the whole run, in dollars."
+    );
+  const seen = /* @__PURE__ */ new Set();
+  for (const product of catalog.products) {
+    if (seen.has(product.id))
+      throw refuse(
+        `Product "${product.id}" is declared twice.`,
+        "Product ids are item keys; make them unique."
+      );
+    seen.add(product.id);
+    if (!product.finishes.length)
+      throw refuse(
+        `Product "${product.id}" has no finishes.`,
+        "Declare one finish: `{ id, show: [] }` shows the product as loaded."
+      );
+    const finishIds = /* @__PURE__ */ new Set();
+    for (const finish of product.finishes) {
+      if (finishIds.has(finish.id))
+        throw refuse(
+          `Finish "${finish.id}" of "${product.id}" is declared twice.`,
+          "Finish ids are part of the item key; make them unique per product."
+        );
+      finishIds.add(finish.id);
+    }
+  }
+  const cameraIds = /* @__PURE__ */ new Set();
+  for (const camera of catalog.cameras) {
+    if (cameraIds.has(camera.id))
+      throw refuse(
+        `Camera "${camera.id}" is declared twice.`,
+        "Camera ids are part of the item key; make them unique."
+      );
+    cameraIds.add(camera.id);
+  }
+}
+
+export { quoteCatalog, runCatalog };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/catalog/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/catalog/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @oeave/bakery3/catalog: render a catalog of products × finishes × cameras\n * from the browser.\n *\n *     import { runCatalog } from '@oeave/bakery3/catalog';\n *\n *     await runCatalog(bakery3, catalog, {\n *       scene,\n *       loadProduct: (url) => loadGltf(url),\n *       onProgress: ({ product, done, total, cost }) => setStatus(`${product}: ${done}/${total}`),\n *     });\n *\n * The work is declared as data (`Catalog`) and the recorder walks it with one\n * product resident at a time: load, mount, capture once (the model with every\n * finish inside it is exported and uploaded once), then one small manifest\n * per finish × camera that differs only in `camera` and `hiddenObjectIds`,\n * flushed as pages to the batch, then the product is removed and disposed.\n * Peak memory is one product plus one page of manifests, whatever the\n * catalog's size.\n *\n * A recorder that dies half way is resumed by running it again: the batch key\n * re-opens the same batch and every item already `completed` is adopted at no\n * cost.\n */\n\nimport type { Object3D, Scene } from 'three';\nimport type {\n  BatchRecord,\n  OutputSpec,\n  QualityPreset,\n} from '../protocol/index.js';\nimport type { Bakery3 } from '../index.js';\nimport type { Batch, BatchProgress } from '../batch.js';\nimport { Bakery3Error } from '../errors.js';\nimport { record, type VariantsQuote } from '../renderSet.js';\nimport {\n  disposeTree,\n  type CatalogCamera,\n  type CatalogFinish,\n} from '../variant.js';\n// Types only: the room module (its loaders, the meshopt decoder, the sky\n// dome) is loaded when a catalog names a room, and not before.\nimport type {\n  RoomPresetLighting,\n  RoomPresetName,\n} from '../presets/rooms.gen.js';\n\n// ---------------------------------------------------------------------------\n// The declaration\n// ---------------------------------------------------------------------------\n\nexport type CatalogProduct = {\n  /** Unique in the catalog; it is the item key and the `sku` in metadata. */\n  id: string;\n  /** The model, with every finish inside; the recorder hides the others per render. */\n  url: string;\n  /** At least one. `{ id, show: [] }` shows the product as loaded. */\n  finishes: CatalogFinish[];\n};\n\nexport type Catalog = {\n  /** Stable across re-runs: the batch's idempotency key. */\n  key: string;\n  /** A label for the console. */\n  name?: string;\n  quality: QualityPreset;\n  output: OutputSpec;\n  /** Ceiling for the whole run, in USD. A page that would cross it is refused, never charged. */\n  maxCost: number;\n  /** At least one; every product is shot from each. */\n  cameras: CatalogCamera[];\n  /** A preset room to photograph in, added for the run when the scene has none. */\n  room?: { preset: RoomPresetName; mode?: RoomPresetLighting };\n  products: CatalogProduct[];\n};\n\nexport type CatalogProgress = BatchProgress & {\n  /** The product just flushed. */\n  product: string;\n};\n\nexport type RunCatalogOptions = {\n  /** Your live scene: lights, room, environment. */\n  scene: Scene;\n  /** Your loader, with your own draco/ktx setup. */\n  loadProduct: (url: string) => Promise<Object3D> | Object3D;\n  /**\n   * Products resident at a time. `1` is the point of the recorder and the\n   * only value supported; anything else is refused rather than silently run\n   * as 1.\n   */\n  concurrency?: 1;\n  /** Called after each product's items are flushed. */\n  onProgress?: (progress: CatalogProgress) => void;\n  /**\n   * Stops between products. What was flushed stays admitted; the batch is\n   * left open so the same run can be resumed.\n   */\n  signal?: AbortSignal;\n};\n\n// ---------------------------------------------------------------------------\n// The recorder\n// ---------------------------------------------------------------------------\n\n/**\n * Record and submit the whole catalog, then seal the batch. Resolves with the\n * sealed batch record; the pictures render on from there (`batch.wait()` or\n * a webhook says when). Run it again with the same key to resume.\n */\nexport async function runCatalog(\n  bakery3: Bakery3,\n  catalog: Catalog,\n  options: RunCatalogOptions,\n): Promise<BatchRecord> {\n  validate(catalog, options);\n\n  // Open, or re-open, the batch. Same key, same batch; items already\n  // completed in an earlier run are adopted, not re-rendered.\n  const batch: Batch = await bakery3.batches.open({\n    key: catalog.key,\n    ...(catalog.name ? { name: catalog.name } : {}),\n    maxCost: catalog.maxCost,\n    lane: 'batch',\n  });\n\n  await walk(bakery3, batch, catalog, options, false);\n\n  // Seal: the total is known and `batch.completed` can fire.\n  return batch.close();\n}\n\n/**\n * The same walk, priced instead of submitted: every product is loaded and\n * captured, every item is quoted, and nothing is uploaded, admitted or\n * reserved. The `maximum` it returns is the number to set `maxCost` from;\n * pictures an earlier run already rendered are counted as adopted, at\n * nothing, so after a change this is the price of the re-run.\n */\nexport async function quoteCatalog(\n  bakery3: Bakery3,\n  catalog: Catalog,\n  options: RunCatalogOptions,\n): Promise<VariantsQuote> {\n  validate(catalog, options);\n  // The route that prices a page belongs to a batch, so one is opened under\n  // the catalog's key. It holds nothing, and the real run re-opens it.\n  const batch = await bakery3.batches.open({\n    key: catalog.key,\n    ...(catalog.name ? { name: catalog.name } : {}),\n    maxCost: catalog.maxCost,\n    lane: 'batch',\n  });\n  return walk(bakery3, batch, catalog, options, true);\n}\n\n/**\n * For every product, by the recorder every multi-picture call shares: load\n * and mount one product, capture once, upload once, one item per finish ×\n * camera, flush, let go.\n */\nasync function walk(\n  bakery3: Bakery3,\n  batch: Batch,\n  catalog: Catalog,\n  options: RunCatalogOptions,\n  dryRun: boolean,\n) {\n  const room = await mountRoom(options.scene, catalog.room);\n  try {\n    return await record<CatalogProduct>({\n      host: bakery3,\n      batch,\n      scene: options.scene,\n      variants: catalog.products,\n      idOf: (product) => product.id,\n      apply: async (product) => {\n        const root = await options.loadProduct(product.url);\n        options.scene.add(root);\n        return () => {\n          options.scene.remove(root);\n          disposeTree(root);\n        };\n      },\n      finishesOf: (product) => product.finishes,\n      cameras: catalog.cameras,\n      output: catalog.output,\n      spec: (manifest) => ({\n        manifest,\n        quality: catalog.quality,\n        output: catalog.output,\n      }),\n      metadataOf: (_product, ids) => ({\n        sku: ids.variant,\n        finish: ids.finish,\n        camera: ids.camera,\n      }),\n      dryRun,\n      ...(options.signal ? { signal: options.signal } : {}),\n      onVariant: ({\n        variant,\n        variants: _variants,\n        images: _images,\n        upload: _upload,\n        ...progress\n      }) => options.onProgress?.({ ...progress, product: variant }),\n    });\n  } finally {\n    room?.();\n  }\n}\n\nfunction validate(catalog: Catalog, options: RunCatalogOptions): void {\n  validateCatalog(catalog);\n  if (options.concurrency !== undefined && options.concurrency !== 1) {\n    throw new Bakery3Error({\n      code: 'InvalidRequest',\n      message: `concurrency: ${options.concurrency} is not supported; the recorder holds one product at a time.`,\n      why: 'Bounded memory is the reason runCatalog() exists. One product resident is the bound.',\n      fix: 'Remove `concurrency`, or set it to 1.',\n      docs: 'https://bakery3.com/docs/api',\n    });\n  }\n}\n\n/**\n * Put the declared room in the scene for the run, unless the scene already\n * has one: an existing room is the one to be faithful to. Returns the undo,\n * or nothing when nothing was added.\n */\nasync function mountRoom(\n  scene: Scene,\n  room: Catalog['room'],\n): Promise<(() => void) | undefined> {\n  if (!room) return undefined;\n  const { createPresetRoom, findPresetRooms } =\n    await import('../presets/room.js');\n  if (findPresetRooms(scene).length) return undefined;\n  const group = createPresetRoom(\n    room.preset,\n    room.mode ? { lighting: room.mode } : {},\n  );\n  scene.add(group);\n  return () => {\n    scene.remove(group);\n    disposeTree(group);\n  };\n}\n\nfunction validateCatalog(catalog: Catalog): void {\n  const refuse = (message: string, fix: string) =>\n    new Bakery3Error({\n      code: 'InvalidRequest',\n      message,\n      why: \"The catalog is the recorder's whole input; a hole in it would be a hole in the batch.\",\n      fix,\n      docs: 'https://bakery3.com/docs/api',\n    });\n  if (!catalog.key)\n    throw refuse(\n      'The catalog has no key.',\n      \"Give it a stable key: it is the batch's idempotency key.\",\n    );\n  if (!catalog.cameras.length)\n    throw refuse('The catalog has no cameras.', 'Declare at least one camera.');\n  if (!(catalog.maxCost > 0))\n    throw refuse(\n      'The catalog has no maxCost.',\n      'Set the ceiling for the whole run, in dollars.',\n    );\n  const seen = new Set<string>();\n  for (const product of catalog.products) {\n    if (seen.has(product.id))\n      throw refuse(\n        `Product \"${product.id}\" is declared twice.`,\n        'Product ids are item keys; make them unique.',\n      );\n    seen.add(product.id);\n    if (!product.finishes.length)\n      throw refuse(\n        `Product \"${product.id}\" has no finishes.`,\n        'Declare one finish: `{ id, show: [] }` shows the product as loaded.',\n      );\n    const finishIds = new Set<string>();\n    for (const finish of product.finishes) {\n      if (finishIds.has(finish.id))\n        throw refuse(\n          `Finish \"${finish.id}\" of \"${product.id}\" is declared twice.`,\n          'Finish ids are part of the item key; make them unique per product.',\n        );\n      finishIds.add(finish.id);\n    }\n  }\n  const cameraIds = new Set<string>();\n  for (const camera of catalog.cameras) {\n    if (cameraIds.has(camera.id))\n      throw refuse(\n        `Camera \"${camera.id}\" is declared twice.`,\n        'Camera ids are part of the item key; make them unique.',\n      );\n    cameraIds.add(camera.id);\n  }\n}\n\nexport type { CatalogCamera, CatalogFinish } from '../variant.js';\nexport type { VariantsQuote } from '../renderSet.js';\nexport type { Batch, BatchProgress } from '../batch.js';\n"]}