glitchgrab 1.48.1 → 1.50.0

package/README.md

@@ -886,7 +886,63 @@ interface GuideReadOptions {
 }
 ```
 
-Never pass the `ggw_` guides write key here for a public page — it reads drafts too.
+Never pass the `ggc_` server key here for a public page — it reads drafts too, and client calls.
+
+## How do I show recorded client calls in my admin panel?
+
+On a call page in Glitchgrab, press **share with client**, then issue a **calls
+key** (`ggc_…`) on API Tokens → Server keys. Put it in your server env as `GLITCHGRAB_CALLS_KEY` — never
+a `NEXT_PUBLIC_` variable, because it plays and deletes calls. Your admin panel
+then reads only the calls you shared:
+
+```tsx
+// app/admin/calls/[id]/page.tsx — server component, behind your admin auth
+import { notFound } from "next/navigation";
+import { getCall } from "glitchgrab/server";
+
+export default async function CallPage({ params }: { params: Promise<{ id: string }> }) {
+  const { id } = await params;
+  const call = await getCall(id);
+  if (!call) notFound();
+
+  return (
+    <article>
+      <h1>{call.title}</h1>
+      {call.audio.map((a) => (
+        <audio key={a.track} controls src={a.url} />
+      ))}
+      <p>{call.summary?.overview}</p>
+      <pre>{call.transcript}</pre>
+    </article>
+  );
+}
+```
+
+- **Shared calls only.** Everything else on the project — internal calls,
+  prospects — is a 404 to this key.
+- **Links expire after 15 minutes** (`linksExpireInSeconds`). Read the call when
+  the page renders; never store `url`s. Nothing is cached for the same reason.
+- **Audio tracks:** a bot recording has one (`call`). An extension recording has
+  two — `client` (everyone else on the call) and `recorder` (your side).
+- **Match a call to a customer** by `participants[].email`.
+- **Screenshots come a page at a time** — `getCall(id, { framesOffset: 50, framesLimit: 50 })`;
+  `frames.total` says how many exist.
+- **`deleteCall(id)` is permanent** — recording, screenshots and transcript. It
+  resolves `{ deleted: false, error }` rather than throwing, e.g. while the bot
+  is still in that call.
+- **Never throws.** `listCalls()` → `[]`, `getCall()` → `null` on any failure.
+
+```ts
+listCalls(options?: { limit?: number; before?: string } & CallsOptions): Promise<CallListItem[]>
+getCall(id: string, options?: { framesOffset?: number; framesLimit?: number } & CallsOptions): Promise<Call | null>
+deleteCall(id: string, options?: CallsOptions): Promise<{ deleted: true } | { deleted: false; error: string }>
+
+interface CallsOptions {
+  key?: string;        // default: GLITCHGRAB_CALLS_KEY
+  baseUrl?: string;    // default: GLITCHGRAB_BASE_URL, then https://glitchgrab.dev
+  timeoutMs?: number;  // default 5000
+}
+```
 
 ## What configuration options are available?
 

package/dist/server.d.mts

@@ -136,7 +136,7 @@ interface GuideSummary {
     category: string | null;
     /** The order set in Glitchgrab. The list already arrives sorted by it. */
     orderIndex: number;
-    /** Always `"PUBLISHED"` with a `gg_` token; only a `ggw_` write key sees drafts. */
+    /** Always `"PUBLISHED"` with a `gg_` token; only the project's `ggc_` server key sees drafts. */
     status: "DRAFT" | "PUBLISHED";
     /** When someone last re-checked the steps against the product. */
     lastVerifiedAt: string | null;
@@ -170,7 +170,7 @@ interface GuideReadOptions {
      * then `GLITCHGRAB_TOKEN`, then `NEXT_PUBLIC_GLITCHGRAB_TOKEN` — the token is
      * public, so the one your provider already uses is fine.
      *
-     * Never pass the `ggw_` guides write key for a public page: it reads drafts too.
+     * Never pass the `ggc_` server key for a public page: it reads drafts too, and client calls.
      */
     token?: string;
     /** Override the API host. Falls back to `GLITCHGRAB_BASE_URL`, then `https://glitchgrab.dev`. */
@@ -209,6 +209,131 @@ declare function listGuides(options?: GuideReadOptions): Promise<GuideSummary[]>
  * `notFound()` on it. Never throws.
  */
 declare function getGuide(slug: string, options?: GuideReadOptions): Promise<Guide | null>;
+/** Someone on the call, as the recorder saw them. */
+interface CallParticipant {
+    name: string | null;
+    email: string | null;
+}
+/** One shared call as the list returns it — no transcript, no links. */
+interface CallListItem {
+    id: string;
+    title: string | null;
+    startsAt: string | null;
+    endsAt: string | null;
+    durationSec: number | null;
+    /** `"bot"` (joined the Meet) or `"extension"` (recorded from someone's Chrome). */
+    recorder: string | null;
+    /** Match a call to your customer by these emails. */
+    participants: CallParticipant[];
+    hasRecording: boolean;
+    /** `IDLE`, `RUNNING`, `DONE` or `FAILED`. */
+    transcriptStatus: string;
+    /** One line on what the call was about, once Glitchgrab has read it. */
+    overview: string | null;
+    createdAt: string;
+}
+interface CallAudio {
+    /**
+     * `call` — a bot recording's single mixed track. An extension recording has
+     * two instead: `client` (everyone else on the call) and `recorder` (the
+     * person who recorded it).
+     */
+    track: "call" | "client" | "recorder";
+    /** Plays for {@link Call.linksExpireInSeconds}. */
+    url: string;
+}
+interface CallMoment {
+    /** Milliseconds into the call — seek the audio here. */
+    tMs: number | null;
+    speaker: string | null;
+    text: string;
+}
+/** One shared call in full. */
+interface Call extends CallListItem {
+    meetUrl: string | null;
+    audio: CallAudio[];
+    /** Audio and screenshot links stop working after this many seconds. Read the call per render; never store them. */
+    linksExpireInSeconds: number;
+    transcript: string | null;
+    summary: {
+        overview: string;
+        moments: CallMoment[];
+    } | null;
+    /** Screenshots grabbed during the call, a page at a time. `tMs` is on the transcript's clock. */
+    frames: {
+        total: number;
+        offset: number;
+        limit: number;
+        items: {
+            tMs: number;
+            url: string;
+        }[];
+    };
+}
+/** Options for {@link listCalls}, {@link getCall} and {@link deleteCall}. */
+interface CallsOptions {
+    /**
+     * The project's server key (`ggc_…`, API Tokens → Server keys). Falls back to `GLITCHGRAB_CALLS_KEY`.
+     * Server only — never a `NEXT_PUBLIC_` variable: it plays and deletes calls.
+     */
+    key?: string;
+    /** Override the API host. Falls back to `GLITCHGRAB_BASE_URL`, then `https://glitchgrab.dev`. */
+    baseUrl?: string;
+    /** Give up after this many ms. Default 5000. */
+    timeoutMs?: number;
+}
+interface ListCallsOptions extends CallsOptions {
+    /** Default 20, max 100. */
+    limit?: number;
+    /** ISO date: only calls recorded before it. Pass the last call's `createdAt` for the next page. */
+    before?: string;
+}
+interface GetCallOptions extends CallsOptions {
+    /** First screenshot to return. Default 0. */
+    framesOffset?: number;
+    /** Screenshots per page. Default 50, max 200, `0` for none. */
+    framesLimit?: number;
+}
+type DeleteCallResult = {
+    deleted: true;
+} | {
+    deleted: false;
+    error: string;
+};
+/**
+ * Calls shared with the client on the key's project, newest first. No links —
+ * open one with {@link getCall}.
+ *
+ * ```ts
+ * // app/admin/calls/page.tsx — server component
+ * import { listCalls } from "glitchgrab/server";
+ *
+ * export default async function CallsPage() {
+ *   const calls = await listCalls(); // GLITCHGRAB_CALLS_KEY=ggc_…
+ *   return calls.map((c) => <a key={c.id} href={`/admin/calls/${c.id}`}>{c.title}</a>);
+ * }
+ * ```
+ *
+ * Returns `[]` on any failure. Never throws.
+ */
+declare function listCalls(options?: ListCallsOptions): Promise<CallListItem[]>;
+/**
+ * One shared call: audio links, transcript, summary and a page of screenshots.
+ * Links expire after `linksExpireInSeconds` — read the call when the page
+ * renders and never store them.
+ *
+ * Returns `null` when the call does not exist, is not shared, and on any
+ * failure — call `notFound()` on it. Never throws.
+ */
+declare function getCall(id: string, options?: GetCallOptions): Promise<Call | null>;
+/**
+ * Permanently delete one shared call — the recording, the screenshots, the
+ * transcript. Cannot be undone.
+ *
+ * Resolves `{ deleted: false, error }` instead of throwing: the reason is worth
+ * showing ("The bot is still in this call — delete it after the call ends").
+ */
+declare function deleteCall(id: string, options?: CallsOptions): Promise<DeleteCallResult>;
 /**
  * `JSON.stringify` that is safe inside `<script type="application/ld+json">`.
  *
@@ -229,4 +354,4 @@ declare function getGuide(slug: string, options?: GuideReadOptions): Promise<Gui
  */
 declare function escapeJsonForScript(value: unknown): string;
 
-export { type CaptureServerErrorsOptions, type Guide, type GuideReadOptions, type GuideSummary, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, escapeJsonForScript, getGuide, listGuides, reportServerError, resetServerReporter, signSession };
+export { type Call, type CallAudio, type CallListItem, type CallMoment, type CallParticipant, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type ListCallsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getCall, getGuide, listCalls, listGuides, reportServerError, resetServerReporter, signSession };

package/dist/server.d.ts

@@ -136,7 +136,7 @@ interface GuideSummary {
     category: string | null;
     /** The order set in Glitchgrab. The list already arrives sorted by it. */
     orderIndex: number;
-    /** Always `"PUBLISHED"` with a `gg_` token; only a `ggw_` write key sees drafts. */
+    /** Always `"PUBLISHED"` with a `gg_` token; only the project's `ggc_` server key sees drafts. */
     status: "DRAFT" | "PUBLISHED";
     /** When someone last re-checked the steps against the product. */
     lastVerifiedAt: string | null;
@@ -170,7 +170,7 @@ interface GuideReadOptions {
      * then `GLITCHGRAB_TOKEN`, then `NEXT_PUBLIC_GLITCHGRAB_TOKEN` — the token is
      * public, so the one your provider already uses is fine.
      *
-     * Never pass the `ggw_` guides write key for a public page: it reads drafts too.
+     * Never pass the `ggc_` server key for a public page: it reads drafts too, and client calls.
      */
     token?: string;
     /** Override the API host. Falls back to `GLITCHGRAB_BASE_URL`, then `https://glitchgrab.dev`. */
@@ -209,6 +209,131 @@ declare function listGuides(options?: GuideReadOptions): Promise<GuideSummary[]>
  * `notFound()` on it. Never throws.
  */
 declare function getGuide(slug: string, options?: GuideReadOptions): Promise<Guide | null>;
+/** Someone on the call, as the recorder saw them. */
+interface CallParticipant {
+    name: string | null;
+    email: string | null;
+}
+/** One shared call as the list returns it — no transcript, no links. */
+interface CallListItem {
+    id: string;
+    title: string | null;
+    startsAt: string | null;
+    endsAt: string | null;
+    durationSec: number | null;
+    /** `"bot"` (joined the Meet) or `"extension"` (recorded from someone's Chrome). */
+    recorder: string | null;
+    /** Match a call to your customer by these emails. */
+    participants: CallParticipant[];
+    hasRecording: boolean;
+    /** `IDLE`, `RUNNING`, `DONE` or `FAILED`. */
+    transcriptStatus: string;
+    /** One line on what the call was about, once Glitchgrab has read it. */
+    overview: string | null;
+    createdAt: string;
+}
+interface CallAudio {
+    /**
+     * `call` — a bot recording's single mixed track. An extension recording has
+     * two instead: `client` (everyone else on the call) and `recorder` (the
+     * person who recorded it).
+     */
+    track: "call" | "client" | "recorder";
+    /** Plays for {@link Call.linksExpireInSeconds}. */
+    url: string;
+}
+interface CallMoment {
+    /** Milliseconds into the call — seek the audio here. */
+    tMs: number | null;
+    speaker: string | null;
+    text: string;
+}
+/** One shared call in full. */
+interface Call extends CallListItem {
+    meetUrl: string | null;
+    audio: CallAudio[];
+    /** Audio and screenshot links stop working after this many seconds. Read the call per render; never store them. */
+    linksExpireInSeconds: number;
+    transcript: string | null;
+    summary: {
+        overview: string;
+        moments: CallMoment[];
+    } | null;
+    /** Screenshots grabbed during the call, a page at a time. `tMs` is on the transcript's clock. */
+    frames: {
+        total: number;
+        offset: number;
+        limit: number;
+        items: {
+            tMs: number;
+            url: string;
+        }[];
+    };
+}
+/** Options for {@link listCalls}, {@link getCall} and {@link deleteCall}. */
+interface CallsOptions {
+    /**
+     * The project's server key (`ggc_…`, API Tokens → Server keys). Falls back to `GLITCHGRAB_CALLS_KEY`.
+     * Server only — never a `NEXT_PUBLIC_` variable: it plays and deletes calls.
+     */
+    key?: string;
+    /** Override the API host. Falls back to `GLITCHGRAB_BASE_URL`, then `https://glitchgrab.dev`. */
+    baseUrl?: string;
+    /** Give up after this many ms. Default 5000. */
+    timeoutMs?: number;
+}
+interface ListCallsOptions extends CallsOptions {
+    /** Default 20, max 100. */
+    limit?: number;
+    /** ISO date: only calls recorded before it. Pass the last call's `createdAt` for the next page. */
+    before?: string;
+}
+interface GetCallOptions extends CallsOptions {
+    /** First screenshot to return. Default 0. */
+    framesOffset?: number;
+    /** Screenshots per page. Default 50, max 200, `0` for none. */
+    framesLimit?: number;
+}
+type DeleteCallResult = {
+    deleted: true;
+} | {
+    deleted: false;
+    error: string;
+};
+/**
+ * Calls shared with the client on the key's project, newest first. No links —
+ * open one with {@link getCall}.
+ *
+ * ```ts
+ * // app/admin/calls/page.tsx — server component
+ * import { listCalls } from "glitchgrab/server";
+ *
+ * export default async function CallsPage() {
+ *   const calls = await listCalls(); // GLITCHGRAB_CALLS_KEY=ggc_…
+ *   return calls.map((c) => <a key={c.id} href={`/admin/calls/${c.id}`}>{c.title}</a>);
+ * }
+ * ```
+ *
+ * Returns `[]` on any failure. Never throws.
+ */
+declare function listCalls(options?: ListCallsOptions): Promise<CallListItem[]>;
+/**
+ * One shared call: audio links, transcript, summary and a page of screenshots.
+ * Links expire after `linksExpireInSeconds` — read the call when the page
+ * renders and never store them.
+ *
+ * Returns `null` when the call does not exist, is not shared, and on any
+ * failure — call `notFound()` on it. Never throws.
+ */
+declare function getCall(id: string, options?: GetCallOptions): Promise<Call | null>;
+/**
+ * Permanently delete one shared call — the recording, the screenshots, the
+ * transcript. Cannot be undone.
+ *
+ * Resolves `{ deleted: false, error }` instead of throwing: the reason is worth
+ * showing ("The bot is still in this call — delete it after the call ends").
+ */
+declare function deleteCall(id: string, options?: CallsOptions): Promise<DeleteCallResult>;
 /**
  * `JSON.stringify` that is safe inside `<script type="application/ld+json">`.
  *
@@ -229,4 +354,4 @@ declare function getGuide(slug: string, options?: GuideReadOptions): Promise<Gui
  */
 declare function escapeJsonForScript(value: unknown): string;
 
-export { type CaptureServerErrorsOptions, type Guide, type GuideReadOptions, type GuideSummary, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, escapeJsonForScript, getGuide, listGuides, reportServerError, resetServerReporter, signSession };
+export { type Call, type CallAudio, type CallListItem, type CallMoment, type CallParticipant, type CallsOptions, type CaptureServerErrorsOptions, type DeleteCallResult, type GetCallOptions, type Guide, type GuideReadOptions, type GuideSummary, type ListCallsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, deleteCall, escapeJsonForScript, getCall, getGuide, listCalls, listGuides, reportServerError, resetServerReporter, signSession };

package/dist/server.js

@@ -22,8 +22,11 @@ var server_exports = {};
 __export(server_exports, {
   captureServerErrors: () => captureServerErrors,
   configureServerReporter: () => configureServerReporter,
+  deleteCall: () => deleteCall,
   escapeJsonForScript: () => escapeJsonForScript,
+  getCall: () => getCall,
   getGuide: () => getGuide,
+  listCalls: () => listCalls,
   listGuides: () => listGuides,
   reportServerError: () => reportServerError,
   resetServerReporter: () => resetServerReporter,
@@ -251,31 +254,39 @@ function signSession(options) {
   return `v1.${exp}.${sig}`;
 }
 var GUIDES_REVALIDATE_SECONDS = 300;
-var GUIDES_TIMEOUT_MS = 5e3;
-async function readGuidesApi(query, options) {
-  var _a, _b, _c, _d, _e, _f, _g, _h;
-  const token = (_c = (_b = (_a = options.token) != null ? _a : defaults.token) != null ? _b : readEnv("GLITCHGRAB_TOKEN")) != null ? _c : readEnv("NEXT_PUBLIC_GLITCHGRAB_TOKEN");
-  if (!token) return null;
-  const baseUrl = ((_f = (_e = (_d = options.baseUrl) != null ? _d : defaults.baseUrl) != null ? _e : readEnv("GLITCHGRAB_BASE_URL")) != null ? _f : DEFAULT_BASE_URL).replace(/\/+$/, "");
-  const revalidate = typeof options.revalidate === "number" && Number.isFinite(options.revalidate) && options.revalidate >= 0 ? options.revalidate : GUIDES_REVALIDATE_SECONDS;
+var SDK_API_TIMEOUT_MS = 5e3;
+async function callSdkApi(path, token, options, init) {
+  var _a, _b, _c, _d, _e, _f;
+  const baseUrl = ((_c = (_b = (_a = options.baseUrl) != null ? _a : defaults.baseUrl) != null ? _b : readEnv("GLITCHGRAB_BASE_URL")) != null ? _c : DEFAULT_BASE_URL).replace(/\/+$/, "");
   const controller = typeof AbortController === "function" ? new AbortController() : void 0;
-  const timer = controller ? setTimeout(() => controller.abort(), (_g = options.timeoutMs) != null ? _g : GUIDES_TIMEOUT_MS) : void 0;
+  const timer = controller ? setTimeout(() => controller.abort(), (_d = options.timeoutMs) != null ? _d : SDK_API_TIMEOUT_MS) : void 0;
   try {
-    const init = {
+    const request = {
+      method: (_e = init.method) != null ? _e : "GET",
       headers: { Authorization: `Bearer ${token}` },
-      next: { revalidate },
+      ...init.cache === "no-store" ? { cache: "no-store" } : { next: { revalidate: init.cache.revalidate } },
       ...controller ? { signal: controller.signal } : {}
     };
-    const response = await fetch(`${baseUrl}/api/v1/sdk/guides${query}`, init);
-    if (!response.ok) return null;
-    const body = await response.json();
-    return (body == null ? void 0 : body.success) === true ? (_h = body.data) != null ? _h : null : null;
+    const response = await fetch(`${baseUrl}${path}`, request);
+    const body = await response.json().catch(() => null);
+    if (!response.ok || (body == null ? void 0 : body.success) !== true) {
+      return { data: null, error: typeof (body == null ? void 0 : body.error) === "string" ? body.error : `HTTP ${response.status}` };
+    }
+    return { data: (_f = body.data) != null ? _f : null, error: null };
   } catch (e) {
-    return null;
+    return { data: null, error: "Could not reach Glitchgrab" };
   } finally {
     if (timer) clearTimeout(timer);
   }
 }
+async function readGuidesApi(query, options) {
+  var _a, _b, _c;
+  const token = (_c = (_b = (_a = options.token) != null ? _a : defaults.token) != null ? _b : readEnv("GLITCHGRAB_TOKEN")) != null ? _c : readEnv("NEXT_PUBLIC_GLITCHGRAB_TOKEN");
+  if (!token) return null;
+  const revalidate = typeof options.revalidate === "number" && Number.isFinite(options.revalidate) && options.revalidate >= 0 ? options.revalidate : GUIDES_REVALIDATE_SECONDS;
+  const result = await callSdkApi(`/api/v1/sdk/guides${query}`, token, options, { cache: { revalidate } });
+  return result.data;
+}
 function readGuideSummary(value) {
   if (!value || typeof value !== "object" || Array.isArray(value)) return null;
   const guide = value;
@@ -320,6 +331,110 @@ async function getGuide(slug, options = {}) {
     return null;
   }
 }
+var CALLS_KEY_PREFIX = "ggc_";
+function callsKey(options) {
+  var _a;
+  const key = (_a = options.key) != null ? _a : readEnv("GLITCHGRAB_CALLS_KEY");
+  return typeof key === "string" && key.startsWith(CALLS_KEY_PREFIX) ? key : null;
+}
+function isRecord(value) {
+  return !!value && typeof value === "object" && !Array.isArray(value);
+}
+function stringOrNull(value) {
+  return typeof value === "string" ? value : null;
+}
+function numberOrNull(value) {
+  return typeof value === "number" && Number.isFinite(value) ? value : null;
+}
+function readCallListItem(value) {
+  if (!isRecord(value) || typeof value.id !== "string") return null;
+  return {
+    id: value.id,
+    title: stringOrNull(value.title),
+    startsAt: stringOrNull(value.startsAt),
+    endsAt: stringOrNull(value.endsAt),
+    durationSec: numberOrNull(value.durationSec),
+    recorder: stringOrNull(value.recorder),
+    participants: Array.isArray(value.participants) ? value.participants.filter(isRecord).map((p) => ({ name: stringOrNull(p.name), email: stringOrNull(p.email) })) : [],
+    hasRecording: value.hasRecording === true,
+    transcriptStatus: typeof value.transcriptStatus === "string" ? value.transcriptStatus : "IDLE",
+    overview: stringOrNull(value.overview),
+    createdAt: typeof value.createdAt === "string" ? value.createdAt : ""
+  };
+}
+var AUDIO_TRACKS = /* @__PURE__ */ new Set(["call", "client", "recorder"]);
+function readCall(value) {
+  var _a, _b, _c, _d;
+  const base = readCallListItem(value);
+  if (!base || !isRecord(value)) return null;
+  const rawSummary = value.summary;
+  const summary = isRecord(rawSummary) && typeof rawSummary.overview === "string" ? {
+    overview: rawSummary.overview,
+    moments: Array.isArray(rawSummary.moments) ? rawSummary.moments.filter(isRecord).filter((m) => typeof m.text === "string").map((m) => ({ tMs: numberOrNull(m.tMs), speaker: stringOrNull(m.speaker), text: m.text })) : []
+  } : null;
+  const frames = isRecord(value.frames) ? value.frames : {};
+  return {
+    ...base,
+    meetUrl: stringOrNull(value.meetUrl),
+    audio: Array.isArray(value.audio) ? value.audio.filter(isRecord).filter((a) => typeof a.url === "string" && typeof a.track === "string" && AUDIO_TRACKS.has(a.track)).map((a) => ({ track: a.track, url: a.url })) : [],
+    linksExpireInSeconds: (_a = numberOrNull(value.linksExpireInSeconds)) != null ? _a : 0,
+    transcript: stringOrNull(value.transcript),
+    summary,
+    frames: {
+      total: (_b = numberOrNull(frames.total)) != null ? _b : 0,
+      offset: (_c = numberOrNull(frames.offset)) != null ? _c : 0,
+      limit: (_d = numberOrNull(frames.limit)) != null ? _d : 0,
+      items: Array.isArray(frames.items) ? frames.items.filter(isRecord).filter((f) => typeof f.url === "string" && typeof f.tMs === "number").map((f) => ({ tMs: f.tMs, url: f.url })) : []
+    }
+  };
+}
+function setNumber(query, name, value) {
+  if (typeof value === "number" && Number.isFinite(value)) query.set(name, String(Math.floor(value)));
+}
+async function listCalls(options = {}) {
+  try {
+    const key = callsKey(options);
+    if (!key) return [];
+    const query = new URLSearchParams();
+    setNumber(query, "limit", options.limit);
+    if (typeof options.before === "string" && options.before) query.set("before", options.before);
+    const qs = query.toString();
+    const { data } = await callSdkApi(`/api/v1/sdk/calls${qs ? `?${qs}` : ""}`, key, options, { cache: "no-store" });
+    if (!Array.isArray(data)) return [];
+    return data.map(readCallListItem).filter((call) => call !== null);
+  } catch (e) {
+    return [];
+  }
+}
+async function getCall(id, options = {}) {
+  try {
+    const wanted = typeof id === "string" ? id.trim() : "";
+    const key = callsKey(options);
+    if (!wanted || !key) return null;
+    const query = new URLSearchParams({ id: wanted });
+    setNumber(query, "framesOffset", options.framesOffset);
+    setNumber(query, "framesLimit", options.framesLimit);
+    const { data } = await callSdkApi(`/api/v1/sdk/calls?${query.toString()}`, key, options, { cache: "no-store" });
+    return readCall(data);
+  } catch (e) {
+    return null;
+  }
+}
+async function deleteCall(id, options = {}) {
+  try {
+    const wanted = typeof id === "string" ? id.trim() : "";
+    if (!wanted) return { deleted: false, error: "No call id" };
+    const key = callsKey(options);
+    if (!key) return { deleted: false, error: "No server key \u2014 set GLITCHGRAB_CALLS_KEY (ggc_\u2026)" };
+    const { error } = await callSdkApi(`/api/v1/sdk/calls?id=${encodeURIComponent(wanted)}`, key, options, {
+      method: "DELETE",
+      cache: "no-store"
+    });
+    return error === null ? { deleted: true } : { deleted: false, error };
+  } catch (e) {
+    return { deleted: false, error: "Could not delete the call" };
+  }
+}
 function escapeJsonForScript(value) {
   try {
     const json = JSON.stringify(value);
@@ -333,8 +448,11 @@ function escapeJsonForScript(value) {
 0 && (module.exports = {
   captureServerErrors,
   configureServerReporter,
+  deleteCall,
   escapeJsonForScript,
+  getCall,
   getGuide,
+  listCalls,
   listGuides,
   reportServerError,
   resetServerReporter,