@bluepic/embed 0.4.0-next.187 → 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/dist/util/export.d.ts

@@ -1,4 +1,4 @@
-import { FieldsBridge, Render, Studio, Template } from '@bluepic/types';
+import { BillingV3, FieldsBridge, Render, Studio, Template } from '@bluepic/types';
 import { Ref } from 'vue';
 import { z } from '@hono/zod-openapi';
 import BxLiveTemplate from '../components/TemplateEditor/BxLiveTemplate.vue';
@@ -97,11 +97,18 @@ svgLoadWaitDelay?: Ref<number | undefined>): {
     rendering: Ref<boolean, boolean>;
     videoRenderingProgress: Ref<number | undefined, number | undefined>;
 };
+/**
+ * Report ONE delivered output to the server.
+ *
+ * The SDK names the surface (`usage`) and describes what it produced
+ * (`assets`) — it never sends, and never learns, a price. The rate table lives
+ * server-side in `@bluepic/types` (`BillingV3.calculateCenticreditConsumption`).
+ */
 export declare function consumeCredits(apiBaseUrl: string, env: 'dev' | 'prod', campaignId: number, templateId: string, sessionState: string, billingKey: number, 
-/** Which rate to bill at. Omitted = `conversion`, the single-export rate. */
-action?: Studio.ConsumeRenderCreditsAction, 
-/** Units of that action — 1 for anything but a video, which bills in video credit units. */
-amount?: number): Promise<void>;
+/** Which surface produced this. Omitted = a single editor export. */
+usage?: Studio.ConsumeRenderCreditsUsage, 
+/** One entry per delivered file — an array of one for a single export. */
+assets?: BillingV3.BillableUsageAsset[]): Promise<void>;
 export declare function hasMobileShareCapability(files: File[]): boolean;
 export declare function blobsToShareFiles(files: Blob[], baseName: string): File[];
 export declare function performDownload(files: Blob[], baseName: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bluepic/embed",
-  "version": "0.4.0-next.187",
+  "version": "0.4.0-next.189",
   "description": "Bluepic embed sdk",
   "type": "module",
   "sideEffects": false,
@@ -46,7 +46,7 @@
   },
   "devDependencies": {
     "@auth0/auth0-vue": "^2.4.0",
-    "@bluepic/types": "^0.8.70",
+    "@bluepic/types": "^0.8.75",
     "@hono/zod-openapi": "^1.1.4",
     "@types/css": "^0.0.38",
     "@types/downloadjs": "^1.4.6",