@capturly/capture-sdk 2.11.0 → 2.11.2

package/CHANGELOG.md

@@ -1,3 +1,44 @@
 # @capturly/capture-sdk
 
+## 2.11.2
+
+## 2.11.1
+
+### Patch Changes
+
+- [#464](https://github.com/Corey-Alan-Consulting/capturly.app/pull/464) [`47c00ea`](https://github.com/Corey-Alan-Consulting/capturly.app/commit/47c00ea9b1943850a4427a78004f85cf165adaf8) Thanks [@NX211](https://github.com/NX211)! - Add a `@capturly/capture-sdk/transport` subpath exposing the bare respondent
+  transport (`requestUpload`, `uploadBlob`, `finalizeSubmission`) for hosts that
+  bring their own recorder, and a new `fetchCaptureView` call (both entries)
+  that returns what the person is being asked — title, prompt, branding,
+  release text, limits, and any existing submission — via the new
+  `/api/campaigns/respond/view` endpoint. Existing APIs are unchanged.
+
+- [#464](https://github.com/Corey-Alan-Consulting/capturly.app/pull/464) [`47c00ea`](https://github.com/Corey-Alan-Consulting/capturly.app/commit/47c00ea9b1943850a4427a78004f85cf165adaf8) Thanks [@NX211](https://github.com/NX211)! - Harden the capture-request respond and collect surfaces, and the recording
+  storage lifecycle, per the branch's second review round:
+  - OPFS garbage collection now fails closed: an unreadable or corrupt
+    recovery marker aborts the sweep instead of reading as "nothing
+    referenced" and reclaiming crash-recovery takes.
+  - The mobile respondent flow can always be exited (persistent Close on
+    every non-recording phase), its API calls time out instead of spinning
+    forever, and a storage-full refusal is no longer misreported as
+    "take too large" with retry disabled.
+  - Respondent links are parsed origin-strictly, malformed escapes are
+    refused instead of thrown, and email unsubscribe links stay out of the
+    app on iOS (AASA exclude) while Android completes them natively.
+  - The web respondent page no longer blanks in Safari private mode, the
+    submission-received owner email can no longer be dropped or hang
+    finalize (bounded Mailgun timeout, awaited send), and view decoders
+    refuse a missing recording time limit instead of defaulting to zero.
+  - The desktop Collect screen drops stale detail responses (preventing a
+    personal link rendering under the wrong request), shows mapped error
+    copy instead of raw API codes, and its badge only polls while signed in.
+  - Take Delete / Share controls are reachable by screen readers, clock
+    labels can no longer render ":60", and saved filenames defuse Windows
+    reserved device names.
+
+  GET /api/capture-requests is now cursor-paginated (`cursor`/`limit`,
+  `nextCursor` in the response; default 50, max 100). List rows and detail
+  views group the owning studio as one nullable `studio { id, name }` object
+  in place of the previous studioId/studioName pair.
+
 ## 2.11.0

package/dist/chunk-CZPDQKMD.js

@@ -0,0 +1,278 @@
+var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]", "::1"]);
+function isSecureTransportUrl(value) {
+  if (typeof value !== "string")
+    return false;
+  let url;
+  try {
+    url = new URL(value);
+  } catch {
+    return false;
+  }
+  if (url.protocol === "https:")
+    return true;
+  if (url.protocol === "http:")
+    return LOOPBACK_HOSTS.has(url.hostname);
+  return false;
+}
+
+// src/types.ts
+var CaptureError = class extends Error {
+  code;
+  cause;
+  constructor(code, message, cause) {
+    super(message);
+    this.name = "CaptureError";
+    this.code = code;
+    if (cause !== void 0) this.cause = cause;
+  }
+};
+
+// src/transport.ts
+function isStringMap(value) {
+  if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
+  return Object.values(value).every((v) => typeof v === "string");
+}
+var CLOSED_ERROR = "ended";
+var RATE_LIMITED_ERROR = "rate_limited";
+var SUPERSEDED_ERROR = "superseded";
+function accessBody(access) {
+  return access.mode === "contact" ? { mode: "contact", contactId: access.contactId, key: access.key } : { mode: "open", campaignId: access.campaignId, key: access.key };
+}
+function codeForResponse(status, error) {
+  if (error === RATE_LIMITED_ERROR) return "rate_limited";
+  if (error === SUPERSEDED_ERROR || status === 409) return "superseded";
+  if (error === CLOSED_ERROR || status === 410) return "request_closed";
+  if (status === 401 || status === 403 || status === 404) return "link_expired";
+  if (status === 413 || status === 429) return "quota_exceeded";
+  if (status >= 400 && status < 500) return "invalid_request";
+  return "upload_failed";
+}
+var REQUEST_TIMEOUT_MS = 3e4;
+var UPLOAD_STALL_MS = 6e4;
+function linkedAbort(signal, timeoutMs) {
+  const controller = new AbortController();
+  let timedOut = false;
+  const timer = setTimeout(() => {
+    timedOut = true;
+    controller.abort();
+  }, timeoutMs);
+  const onAbort = () => controller.abort();
+  if (signal?.aborted) controller.abort();
+  else signal?.addEventListener("abort", onAbort, { once: true });
+  return {
+    signal: controller.signal,
+    timedOut: () => timedOut,
+    dispose: () => {
+      clearTimeout(timer);
+      signal?.removeEventListener("abort", onAbort);
+    }
+  };
+}
+async function postJson(baseUrl, path, body, signal) {
+  const link = linkedAbort(signal, REQUEST_TIMEOUT_MS);
+  let res;
+  try {
+    res = await fetch(`${baseUrl}${path}`, {
+      method: "POST",
+      headers: { "content-type": "application/json" },
+      body: JSON.stringify(body),
+      signal: link.signal
+    });
+  } catch (err) {
+    if (signal?.aborted) throw new CaptureError("aborted", "The request was cancelled.", err);
+    if (link.timedOut()) {
+      throw new CaptureError("network", "Capturly did not respond in time.", err);
+    }
+    throw new CaptureError("network", "Could not reach Capturly.", err);
+  } finally {
+    link.dispose();
+  }
+  const json = await res.json().catch(() => null);
+  if (!res.ok) {
+    const error = typeof json?.error === "string" ? json.error : null;
+    throw new CaptureError(
+      codeForResponse(res.status, error),
+      error ?? `Capturly returned ${res.status}.`
+    );
+  }
+  return json ?? {};
+}
+function isRecord(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value);
+}
+var stringOrNull = (v) => typeof v === "string" ? v : null;
+async function fetchCaptureView(args) {
+  const json = await postJson(
+    args.baseUrl,
+    "/api/campaigns/respond/view",
+    accessBody(args.access),
+    args.signal
+  );
+  const view = json.view;
+  if (!isRecord(view) || typeof view.title !== "string" || typeof view.prompt !== "string") {
+    throw new CaptureError("unknown", "Capturly did not return the capture request.");
+  }
+  const branding = isRecord(view.branding) ? {
+    studioName: typeof view.branding.studioName === "string" ? view.branding.studioName : "",
+    brandColor: stringOrNull(view.branding.brandColor),
+    brandSecondaryColor: stringOrNull(view.branding.brandSecondaryColor),
+    brandAccentColor: stringOrNull(view.branding.brandAccentColor),
+    coverPath: stringOrNull(view.branding.coverPath)
+  } : {
+    studioName: "",
+    brandColor: null,
+    brandSecondaryColor: null,
+    brandAccentColor: null,
+    coverPath: null
+  };
+  if (typeof view.maxDurationSec !== "number" || view.maxDurationSec <= 0) {
+    throw new CaptureError("unknown", "Capturly returned no recording time limit.");
+  }
+  const existing = isRecord(view.existing) && typeof view.existing.submissionId === "string" && typeof view.existing.submittedAt === "string" ? {
+    submissionId: view.existing.submissionId,
+    submittedAt: view.existing.submittedAt,
+    durationSec: typeof view.existing.durationSec === "number" ? view.existing.durationSec : 0
+  } : null;
+  return {
+    title: view.title,
+    prompt: view.prompt,
+    deadline: stringOrNull(view.deadline),
+    timezone: typeof view.timezone === "string" ? view.timezone : "UTC",
+    maxDurationSec: view.maxDurationSec,
+    releaseRequired: view.releaseRequired === true,
+    releaseText: typeof view.releaseText === "string" ? view.releaseText : "",
+    respondentName: stringOrNull(view.respondentName),
+    branding,
+    promptVideoUrl: stringOrNull(view.promptVideoUrl),
+    targetHeight: typeof view.targetHeight === "number" ? view.targetHeight : 1080,
+    existing
+  };
+}
+async function requestUpload(args) {
+  const json = await postJson(
+    args.baseUrl,
+    "/api/campaigns/respond/upload-url",
+    {
+      ...accessBody(args.access),
+      contentType: "video/mp4",
+      sizeBytes: args.sizeBytes,
+      durationSec: args.durationSec,
+      ...args.displayName ? { displayName: args.displayName } : {},
+      releaseAccepted: args.releaseAccepted
+    },
+    args.signal
+  );
+  const objectName = typeof json.objectName === "string" ? json.objectName : null;
+  if (!objectName) {
+    throw new CaptureError("upload_failed", "Capturly did not return an upload target.");
+  }
+  const url = json.url;
+  if (!isSecureTransportUrl(url)) {
+    throw new CaptureError("upload_failed", "Capturly returned an unusable upload URL.");
+  }
+  if (json.method !== "PUT") {
+    throw new CaptureError("upload_failed", "Capturly returned an unsupported upload method.");
+  }
+  const headers = json.headers;
+  if (!isStringMap(headers)) {
+    throw new CaptureError("upload_failed", "Capturly returned unusable upload headers.");
+  }
+  return { objectName, url, method: "PUT", headers };
+}
+function uploadBlob(args) {
+  return new Promise((resolve, reject) => {
+    if (args.signal?.aborted) {
+      reject(new CaptureError("aborted", "The upload was cancelled."));
+      return;
+    }
+    const xhr = new XMLHttpRequest();
+    let stalled = false;
+    let cancelled = false;
+    let stallTimer;
+    const onCallerAbort = () => {
+      cancelled = true;
+      xhr.abort();
+    };
+    const armStall = () => {
+      clearTimeout(stallTimer);
+      stallTimer = setTimeout(() => {
+        stalled = true;
+        xhr.abort();
+      }, UPLOAD_STALL_MS);
+    };
+    const cleanup = () => {
+      clearTimeout(stallTimer);
+      args.signal?.removeEventListener("abort", onCallerAbort);
+    };
+    xhr.open(args.target.method, args.target.url, true);
+    for (const [name, value] of Object.entries(args.target.headers)) {
+      xhr.setRequestHeader(name, value);
+    }
+    xhr.upload.onprogress = (event) => {
+      armStall();
+      if (!event.lengthComputable || !args.onProgress) return;
+      args.onProgress(Math.min(1, event.loaded / event.total));
+    };
+    xhr.onload = () => {
+      cleanup();
+      if (xhr.status >= 200 && xhr.status < 300) {
+        args.onProgress?.(1);
+        resolve();
+        return;
+      }
+      reject(new CaptureError("upload_failed", `Storage rejected the upload (${xhr.status}).`));
+    };
+    xhr.onerror = () => {
+      cleanup();
+      reject(new CaptureError("network", "The upload could not reach storage."));
+    };
+    xhr.onabort = () => {
+      cleanup();
+      if (cancelled) {
+        reject(new CaptureError("aborted", "The upload was cancelled."));
+      } else if (stalled) {
+        reject(new CaptureError("network", "The upload stopped making progress."));
+      } else {
+        reject(new CaptureError("upload_failed", "The upload was aborted."));
+      }
+    };
+    args.signal?.addEventListener("abort", onCallerAbort, { once: true });
+    armStall();
+    xhr.send(args.blob);
+  });
+}
+async function finalizeSubmission(args) {
+  const json = await postJson(
+    args.baseUrl,
+    "/api/campaigns/respond/finalize",
+    {
+      ...accessBody(args.access),
+      objectName: args.objectName,
+      durationSec: args.durationSec,
+      ...args.displayName ? { displayName: args.displayName } : {},
+      releaseAccepted: args.releaseAccepted
+    },
+    args.signal
+  );
+  const submissionId = typeof json.submissionId === "string" ? json.submissionId : null;
+  if (!submissionId) {
+    throw new CaptureError(
+      "unknown",
+      "The recording was submitted but Capturly did not return its id."
+    );
+  }
+  return {
+    submissionId,
+    submittedAt: typeof json.submittedAt === "string" ? json.submittedAt : (/* @__PURE__ */ new Date()).toISOString(),
+    replaced: json.replaced === true
+  };
+}
+
+export {
+  isSecureTransportUrl,
+  CaptureError,
+  fetchCaptureView,
+  requestUpload,
+  uploadBlob,
+  finalizeSubmission
+};

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export { CaptureClient } from './CaptureClient.js';
-export { CaptureError, type CaptureAccess, type CaptureClientOptions, type CaptureDevice, type CaptureErrorCode, type CaptureState, type CaptureTake, type PreviewOptions, type SubmitOptions, type SubmitResult, } from './types.js';
+export { fetchCaptureView } from './transport.js';
+export { CaptureError, type CaptureAccess, type CaptureClientOptions, type CaptureDevice, type CaptureErrorCode, type CaptureRequestBranding, type CaptureRequestView, type CaptureState, type CaptureTake, type PreviewOptions, type SubmitOptions, type SubmitResult, } from './types.js';

package/dist/index.js

@@ -1,3 +1,12 @@
+import {
+  CaptureError,
+  fetchCaptureView,
+  finalizeSubmission,
+  isSecureTransportUrl,
+  requestUpload,
+  uploadBlob
+} from "./chunk-CZPDQKMD.js";
+
 var MP4_MIME = "video/mp4;codecs=avc1.42E01E,mp4a.40.2";
 function pickMuxStrategy() {
   if (typeof MediaRecorder !== "undefined" && MediaRecorder.isTypeSupported(MP4_MIME)) {
@@ -62,23 +71,6 @@ var RecordingEngineError = class _RecordingEngineError extends Error {
   }
 };
 
-var LOOPBACK_HOSTS = /* @__PURE__ */ new Set(["localhost", "127.0.0.1", "[::1]", "::1"]);
-function isSecureTransportUrl(value) {
-  if (typeof value !== "string")
-    return false;
-  let url2;
-  try {
-    url2 = new URL(value);
-  } catch {
-    return false;
-  }
-  if (url2.protocol === "https:")
-    return true;
-  if (url2.protocol === "http:")
-    return LOOPBACK_HOSTS.has(url2.hostname);
-  return false;
-}
-
 var CHUNK_ALIGNMENT = 256 * 1024;
 var RESUMABLE_CHUNK_BYTES = 32 * CHUNK_ALIGNMENT;
 var CHUNK_TIMEOUT_MS = 4 * 60 * 1e3;
@@ -4240,208 +4232,6 @@ function commitResources(r, logError) {
   })();
 }
 
-// src/types.ts
-var CaptureError = class extends Error {
-  code;
-  cause;
-  constructor(code, message, cause) {
-    super(message);
-    this.name = "CaptureError";
-    this.code = code;
-    if (cause !== void 0) this.cause = cause;
-  }
-};
-
-// src/transport.ts
-function isStringMap(value) {
-  if (value === null || typeof value !== "object" || Array.isArray(value)) return false;
-  return Object.values(value).every((v) => typeof v === "string");
-}
-var CLOSED_ERROR = "ended";
-var RATE_LIMITED_ERROR = "rate_limited";
-var SUPERSEDED_ERROR = "superseded";
-function accessBody(access) {
-  return access.mode === "contact" ? { mode: "contact", contactId: access.contactId, key: access.key } : { mode: "open", campaignId: access.campaignId, key: access.key };
-}
-function codeForResponse(status, error) {
-  if (error === RATE_LIMITED_ERROR) return "rate_limited";
-  if (error === SUPERSEDED_ERROR || status === 409) return "superseded";
-  if (error === CLOSED_ERROR || status === 410) return "request_closed";
-  if (status === 401 || status === 403 || status === 404) return "link_expired";
-  if (status === 413 || status === 429) return "quota_exceeded";
-  if (status >= 400 && status < 500) return "invalid_request";
-  return "upload_failed";
-}
-var REQUEST_TIMEOUT_MS = 3e4;
-var UPLOAD_STALL_MS = 6e4;
-function linkedAbort(signal, timeoutMs) {
-  const controller = new AbortController();
-  let timedOut = false;
-  const timer = setTimeout(() => {
-    timedOut = true;
-    controller.abort();
-  }, timeoutMs);
-  const onAbort = () => controller.abort();
-  if (signal?.aborted) controller.abort();
-  else signal?.addEventListener("abort", onAbort, { once: true });
-  return {
-    signal: controller.signal,
-    timedOut: () => timedOut,
-    dispose: () => {
-      clearTimeout(timer);
-      signal?.removeEventListener("abort", onAbort);
-    }
-  };
-}
-async function postJson(baseUrl, path, body, signal) {
-  const link = linkedAbort(signal, REQUEST_TIMEOUT_MS);
-  let res;
-  try {
-    res = await fetch(`${baseUrl}${path}`, {
-      method: "POST",
-      headers: { "content-type": "application/json" },
-      body: JSON.stringify(body),
-      signal: link.signal
-    });
-  } catch (err) {
-    if (signal?.aborted) throw new CaptureError("aborted", "The request was cancelled.", err);
-    if (link.timedOut()) {
-      throw new CaptureError("network", "Capturly did not respond in time.", err);
-    }
-    throw new CaptureError("network", "Could not reach Capturly.", err);
-  } finally {
-    link.dispose();
-  }
-  const json = await res.json().catch(() => null);
-  if (!res.ok) {
-    const error = typeof json?.error === "string" ? json.error : null;
-    throw new CaptureError(
-      codeForResponse(res.status, error),
-      error ?? `Capturly returned ${res.status}.`
-    );
-  }
-  return json ?? {};
-}
-async function requestUpload(args) {
-  const json = await postJson(
-    args.baseUrl,
-    "/api/campaigns/respond/upload-url",
-    {
-      ...accessBody(args.access),
-      contentType: "video/mp4",
-      sizeBytes: args.sizeBytes,
-      durationSec: args.durationSec,
-      ...args.displayName ? { displayName: args.displayName } : {},
-      releaseAccepted: args.releaseAccepted
-    },
-    args.signal
-  );
-  const objectName = typeof json.objectName === "string" ? json.objectName : null;
-  if (!objectName) {
-    throw new CaptureError("upload_failed", "Capturly did not return an upload target.");
-  }
-  const url2 = json.url;
-  if (!isSecureTransportUrl(url2)) {
-    throw new CaptureError("upload_failed", "Capturly returned an unusable upload URL.");
-  }
-  if (json.method !== "PUT") {
-    throw new CaptureError("upload_failed", "Capturly returned an unsupported upload method.");
-  }
-  const headers = json.headers;
-  if (!isStringMap(headers)) {
-    throw new CaptureError("upload_failed", "Capturly returned unusable upload headers.");
-  }
-  return { objectName, url: url2, method: "PUT", headers };
-}
-function uploadBlob(args) {
-  return new Promise((resolve, reject) => {
-    if (args.signal?.aborted) {
-      reject(new CaptureError("aborted", "The upload was cancelled."));
-      return;
-    }
-    const xhr = new XMLHttpRequest();
-    let stalled = false;
-    let cancelled = false;
-    let stallTimer;
-    const onCallerAbort = () => {
-      cancelled = true;
-      xhr.abort();
-    };
-    const armStall = () => {
-      clearTimeout(stallTimer);
-      stallTimer = setTimeout(() => {
-        stalled = true;
-        xhr.abort();
-      }, UPLOAD_STALL_MS);
-    };
-    const cleanup = () => {
-      clearTimeout(stallTimer);
-      args.signal?.removeEventListener("abort", onCallerAbort);
-    };
-    xhr.open(args.target.method, args.target.url, true);
-    for (const [name, value] of Object.entries(args.target.headers)) {
-      xhr.setRequestHeader(name, value);
-    }
-    xhr.upload.onprogress = (event) => {
-      armStall();
-      if (!event.lengthComputable || !args.onProgress) return;
-      args.onProgress(Math.min(1, event.loaded / event.total));
-    };
-    xhr.onload = () => {
-      cleanup();
-      if (xhr.status >= 200 && xhr.status < 300) {
-        args.onProgress?.(1);
-        resolve();
-        return;
-      }
-      reject(new CaptureError("upload_failed", `Storage rejected the upload (${xhr.status}).`));
-    };
-    xhr.onerror = () => {
-      cleanup();
-      reject(new CaptureError("network", "The upload could not reach storage."));
-    };
-    xhr.onabort = () => {
-      cleanup();
-      if (cancelled) {
-        reject(new CaptureError("aborted", "The upload was cancelled."));
-      } else if (stalled) {
-        reject(new CaptureError("network", "The upload stopped making progress."));
-      } else {
-        reject(new CaptureError("upload_failed", "The upload was aborted."));
-      }
-    };
-    args.signal?.addEventListener("abort", onCallerAbort, { once: true });
-    armStall();
-    xhr.send(args.blob);
-  });
-}
-async function finalizeSubmission(args) {
-  const json = await postJson(
-    args.baseUrl,
-    "/api/campaigns/respond/finalize",
-    {
-      ...accessBody(args.access),
-      objectName: args.objectName,
-      durationSec: args.durationSec,
-      ...args.displayName ? { displayName: args.displayName } : {},
-      releaseAccepted: args.releaseAccepted
-    },
-    args.signal
-  );
-  const submissionId = typeof json.submissionId === "string" ? json.submissionId : null;
-  if (!submissionId) {
-    throw new CaptureError(
-      "unknown",
-      "The recording was submitted but Capturly did not return its id."
-    );
-  }
-  return {
-    submissionId,
-    submittedAt: typeof json.submittedAt === "string" ? json.submittedAt : (/* @__PURE__ */ new Date()).toISOString(),
-    replaced: json.replaced === true
-  };
-}
-
 // src/CaptureClient.ts
 var DEFAULT_BASE_URL = "https://capturly.app";
 var SLASH = 47;
@@ -4744,5 +4534,6 @@ var GUM_MESSAGES = {
 };
 export {
   CaptureClient,
-  CaptureError
+  CaptureError,
+  fetchCaptureView
 };

package/dist/transport.d.ts

@@ -1,4 +1,18 @@
-import { type CaptureAccess } from './types.js';
+import { CaptureError, type CaptureAccess, type CaptureErrorCode, type CaptureRequestBranding, type CaptureRequestView } from './types.js';
+export { CaptureError };
+export type { CaptureAccess, CaptureErrorCode, CaptureRequestBranding, CaptureRequestView };
+/**
+ * Fetch what the person is being asked — title, prompt, branding, release
+ * text, limits, and any submission they already made. Same access, same
+ * refusal codes as the other calls, so a dead link fails here rather than
+ * after a recording exists. Contact links are marked opened by this call,
+ * exactly as opening the hosted page would.
+ */
+export declare function fetchCaptureView(args: {
+    baseUrl: string;
+    access: CaptureAccess;
+    signal?: AbortSignal | undefined;
+}): Promise<CaptureRequestView>;
 export interface UploadTarget {
     objectName: string;
     url: string;

package/dist/transport.js

@@ -0,0 +1,14 @@
+import {
+  CaptureError,
+  fetchCaptureView,
+  finalizeSubmission,
+  requestUpload,
+  uploadBlob
+} from "./chunk-CZPDQKMD.js";
+export {
+  CaptureError,
+  fetchCaptureView,
+  finalizeSubmission,
+  requestUpload,
+  uploadBlob
+};

package/dist/types.d.ts

@@ -24,6 +24,42 @@ export interface CaptureClientOptions {
     onWarning?: (message: string, cause?: unknown) => void;
 }
 export type CaptureState = 'idle' | 'starting' | 'recording' | 'stopping' | 'stopped';
+export interface CaptureRequestBranding {
+    studioName: string;
+    brandColor: string | null;
+    brandSecondaryColor: string | null;
+    brandAccentColor: string | null;
+    /** Cover-art path under the Capturly origin, or null when unset. */
+    coverPath: string | null;
+}
+/**
+ * What the person is being asked, fetched with the same access the recording
+ * uses. Show `releaseText` before recording whenever `releaseRequired` — a
+ * consent record is only honest if the person actually saw the text.
+ */
+export interface CaptureRequestView {
+    title: string;
+    prompt: string;
+    deadline: string | null;
+    timezone: string;
+    maxDurationSec: number;
+    releaseRequired: boolean;
+    /** Resolved release copy — never empty when `releaseRequired`. */
+    releaseText: string;
+    /** The person's name for a contact link; null for an open link. */
+    respondentName: string | null;
+    branding: CaptureRequestBranding;
+    /** Short-lived signed URL of the video prompt, when the request has one. */
+    promptVideoUrl: string | null;
+    /** Frame-height ceiling the owner's plan records at (e.g. 1080). */
+    targetHeight: number;
+    /** This person's existing submission, when they already answered. */
+    existing: {
+        submissionId: string;
+        submittedAt: string;
+        durationSec: number;
+    } | null;
+}
 export interface CaptureDevice {
     deviceId: string;
     label: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@capturly/capture-sdk",
-  "version": "2.11.0",
+  "version": "2.11.2",
   "description": "Record full-quality audio and video on your user's own device, from your own product.",
   "keywords": [
     "recording",
@@ -35,6 +35,10 @@
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     },
+    "./transport": {
+      "types": "./dist/transport.d.ts",
+      "default": "./dist/transport.js"
+    },
     "./package.json": "./package.json"
   },
   "files": [
@@ -51,12 +55,12 @@
     "esbuild": "^0.25.0",
     "typescript": "^5.4.0",
     "vitest": "^4.1.7",
-    "@capturly/eslint-config": "2.11.0",
-    "@capturly/tsconfig": "2.11.0",
-    "@capturly/recording-engine": "2.11.0"
+    "@capturly/eslint-config": "2.11.2",
+    "@capturly/recording-engine": "2.11.2",
+    "@capturly/tsconfig": "2.11.2"
   },
   "scripts": {
-    "build": "node build.mjs && tsc -p tsconfig.build.json --emitDeclarationOnly",
+    "build": "pnpm clean && node build.mjs && tsc -p tsconfig.build.json --emitDeclarationOnly",
     "test": "vitest run",
     "test:watch": "vitest",
     "lint": "eslint src --ext .ts",