@bluepic/embed 0.4.0-next.188 → 0.4.0-next.189

package/dist/util/assetAuth.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Credentials for the GATED brand-portal asset routes
+ * (`/api/public/campaigns/:uid/assets/:assetId/{download|preview|document}`).
+ *
+ * A protected campaign is unlocked either with its password or by signing in;
+ * the config and serial fetches already carry that proof, but the asset bytes
+ * are requested separately — by a `fetch()` (download, viewer parsing) or by a
+ * media element's `src` (audio, video, image), which cannot carry headers at
+ * all. This module is the ONE place that knows how to attach the proof to
+ * either kind of request, so the two can never drift apart:
+ *
+ *  - `assetRequestHeaders` → `X-Bluepic-Password` / `Authorization: Bearer …`
+ *  - `withAssetAuthQuery`  → `?password=…` / `?access_token=…`
+ *
+ * Prefer the headers wherever a `fetch()` is used; the query form exists only
+ * for `src` attributes. An empty auth object leaves headers and URLs untouched,
+ * so a public campaign behaves exactly as before.
+ */
+export type AssetAuth = {
+    /** The campaign password the visitor unlocked with, if any. */
+    password?: string;
+    /** The signed-in visitor's Auth0 access token, if any. */
+    accessToken?: string;
+};
+/** Query parameter names the API accepts for media `src` URLs. */
+export declare const ASSET_AUTH_QUERY_PASSWORD = "password";
+export declare const ASSET_AUTH_QUERY_ACCESS_TOKEN = "access_token";
+/** Headers for a `fetch()` of gated asset bytes. `{}` when nothing to attach. */
+export declare function assetRequestHeaders(auth?: AssetAuth | null): Record<string, string>;
+/**
+ * The same proof as query parameters, for `<img>`/`<video>`/`<audio>` sources
+ * that cannot carry headers. Returns `url` unchanged when there is nothing to
+ * attach. Existing query parameters (and a hash) are preserved.
+ */
+export declare function withAssetAuthQuery(url: string, auth?: AssetAuth | null): string;

package/dist/util/batch/export.d.ts

@@ -38,6 +38,13 @@ export interface BatchExportProgress {
     current: number;
     /** 1-based index of the row being rendered. */
     currentIndex: number;
+    /** Rows that threw (rendering or consuming) and were skipped. */
+    failed: number;
+}
+/** A row that did not make it into the output. `index` is 0-based (row 1 is index 0). */
+export interface BatchFailedRow {
+    index: number;
+    message: string;
 }
 export interface BatchFileExportResult {
     /** One blob per exported file (a multi-frame template yields several per row). */
@@ -51,6 +58,11 @@ export interface BatchFileExportResult {
         fileName: string;
     };
     cancelled: boolean;
+    /**
+     * Rows missing from `output` because they threw. Successful rows were still
+     * consumed (charged) and packed; a failed row was never consumed.
+     */
+    failedRows: BatchFailedRow[];
 }
 /** Image rows render four at a time, videos strictly one after the other (decision 2026-09-02). */
 export declare const BATCH_IMAGE_CONCURRENCY = 4;
@@ -64,8 +76,10 @@ export declare function batchFileBaseNames(rows: BatchRow[], naming: BatchNaming
  *
  * Images go through the campaign render endpoint (which does not charge — the
  * per-row `consumeOutput` does), videos through the video render service.
- * Rows are rendered in order; a failed row aborts the export with its error
- * so nothing half-billed slips through silently.
+ * Rows are rendered in order and isolated from each other: a row that throws
+ * is recorded in `failedRows` (never consumed, never packed) and the rest
+ * carry on, so one bad row cannot discard the already-charged good ones. Only
+ * when every row failed is there nothing to hand out, and the export throws.
  */
 export declare function exportBatchFiles(rows: BatchRow[], format: BatchFileFormat, naming: BatchNaming, ctx: BatchFileExportContext, onProgress?: (progress: BatchExportProgress) => void): Promise<BatchFileExportResult>;
 /** One file stays a file; several become a zip named after the template. */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluepic/embed",
-  "version": "0.4.0-next.188",
+  "version": "0.4.0-next.189",
   "description": "Bluepic embed sdk",
   "type": "module",
   "sideEffects": false,