glitchgrab 1.48.0 → 1.49.0

package/dist/server.d.mts

@@ -127,5 +127,231 @@ interface SignSessionOptions {
  * loses the AI features.
  */
 declare function signSession(options: SignSessionOptions): string;
+/** One guide as the list returns it — no body. Dates are ISO strings: this came over JSON. */
+interface GuideSummary {
+    slug: string;
+    title: string;
+    /** One line saying what the guide answers. */
+    summary: string;
+    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. */
+    status: "DRAFT" | "PUBLISHED";
+    /** When someone last re-checked the steps against the product. */
+    lastVerifiedAt: string | null;
+    updatedAt: string;
+    /**
+     * Where this guide lives on your site: its own link, else
+     * `<guides base URL>/<slug>`, else null when the repo sets neither.
+     */
+    link: string | null;
+}
+/** One guide with its body. */
+interface Guide extends GuideSummary {
+    /** The markdown as written. */
+    content: string;
+    /**
+     * `content` rendered by Glitchgrab: raw HTML in the markdown arrives as text,
+     * only allowlisted attributes survive, and links keep only http(s), mailto
+     * and relative targets. Headings carry `id="guide-<heading text>"`, for a
+     * table of contents or a link to a single step.
+     *
+     * Safe to render as-is. On a domain that holds your users' sessions, a second
+     * sanitize pass of your own is cheap defence in depth — this SDK ships no
+     * sanitizer so it stays dependency-free.
+     */
+    html: string;
+}
+/** Options for {@link listGuides} and {@link getGuide}. */
+interface GuideReadOptions {
+    /**
+     * Repo token (`gg_…`). Falls back to {@link configureServerReporter}'s token,
+     * 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.
+     */
+    token?: string;
+    /** Override the API host. Falls back to `GLITCHGRAB_BASE_URL`, then `https://glitchgrab.dev`. */
+    baseUrl?: string;
+    /**
+     * Seconds Next.js may cache the response. Default 300; `0` reads fresh on
+     * every request. The route is `force-dynamic`, so without this nothing is
+     * cached at all. Ignored outside Next.js.
+     */
+    revalidate?: number;
+    /** Give up and return empty after this many ms. Default 5000 — a slow Glitchgrab must not hang your render. */
+    timeoutMs?: number;
+}
+/**
+ * Every published guide for the token's repo, in the order set in Glitchgrab.
+ * No bodies — this is the index page.
+ *
+ * ```ts
+ * // app/guides/page.tsx
+ * import { listGuides } from "glitchgrab/server";
+ *
+ * export default async function GuidesPage() {
+ *   const guides = await listGuides();
+ *   return guides.map((g) => <a key={g.slug} href={`/guides/${g.slug}`}>{g.title}</a>);
+ * }
+ * ```
+ *
+ * Returns `[]` on any failure. Never throws: a Glitchgrab outage leaves the
+ * page empty instead of turning it into a 500.
+ */
+declare function listGuides(options?: GuideReadOptions): Promise<GuideSummary[]>;
+/**
+ * One published guide with its markdown and rendered HTML.
+ *
+ * Returns `null` when there is no such guide and on any failure — call
+ * `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 calls key (`ggc_…`). 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">`.
+ *
+ * Guide titles and summaries are written outside your codebase, and
+ * `JSON.stringify` leaves `<` alone — a title containing `</script>` closes the
+ * tag and whatever follows runs as HTML. The JSON unicode escape for `<` is the same
+ * character to a JSON parser and inert to the HTML one. `>`, `&` and the two
+ * JavaScript line separators are escaped for the same reason.
+ *
+ * ```tsx
+ * <script
+ *   type="application/ld+json"
+ *   dangerouslySetInnerHTML={{ __html: escapeJsonForScript({ "@type": "HowTo", name: guide.title }) }}
+ * />
+ * ```
+ *
+ * Never throws: a value JSON cannot represent (circular, `undefined`) becomes `null`.
+ */
+declare function escapeJsonForScript(value: unknown): string;
 
-export { type CaptureServerErrorsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, 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

@@ -127,5 +127,231 @@ interface SignSessionOptions {
  * loses the AI features.
  */
 declare function signSession(options: SignSessionOptions): string;
+/** One guide as the list returns it — no body. Dates are ISO strings: this came over JSON. */
+interface GuideSummary {
+    slug: string;
+    title: string;
+    /** One line saying what the guide answers. */
+    summary: string;
+    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. */
+    status: "DRAFT" | "PUBLISHED";
+    /** When someone last re-checked the steps against the product. */
+    lastVerifiedAt: string | null;
+    updatedAt: string;
+    /**
+     * Where this guide lives on your site: its own link, else
+     * `<guides base URL>/<slug>`, else null when the repo sets neither.
+     */
+    link: string | null;
+}
+/** One guide with its body. */
+interface Guide extends GuideSummary {
+    /** The markdown as written. */
+    content: string;
+    /**
+     * `content` rendered by Glitchgrab: raw HTML in the markdown arrives as text,
+     * only allowlisted attributes survive, and links keep only http(s), mailto
+     * and relative targets. Headings carry `id="guide-<heading text>"`, for a
+     * table of contents or a link to a single step.
+     *
+     * Safe to render as-is. On a domain that holds your users' sessions, a second
+     * sanitize pass of your own is cheap defence in depth — this SDK ships no
+     * sanitizer so it stays dependency-free.
+     */
+    html: string;
+}
+/** Options for {@link listGuides} and {@link getGuide}. */
+interface GuideReadOptions {
+    /**
+     * Repo token (`gg_…`). Falls back to {@link configureServerReporter}'s token,
+     * 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.
+     */
+    token?: string;
+    /** Override the API host. Falls back to `GLITCHGRAB_BASE_URL`, then `https://glitchgrab.dev`. */
+    baseUrl?: string;
+    /**
+     * Seconds Next.js may cache the response. Default 300; `0` reads fresh on
+     * every request. The route is `force-dynamic`, so without this nothing is
+     * cached at all. Ignored outside Next.js.
+     */
+    revalidate?: number;
+    /** Give up and return empty after this many ms. Default 5000 — a slow Glitchgrab must not hang your render. */
+    timeoutMs?: number;
+}
+/**
+ * Every published guide for the token's repo, in the order set in Glitchgrab.
+ * No bodies — this is the index page.
+ *
+ * ```ts
+ * // app/guides/page.tsx
+ * import { listGuides } from "glitchgrab/server";
+ *
+ * export default async function GuidesPage() {
+ *   const guides = await listGuides();
+ *   return guides.map((g) => <a key={g.slug} href={`/guides/${g.slug}`}>{g.title}</a>);
+ * }
+ * ```
+ *
+ * Returns `[]` on any failure. Never throws: a Glitchgrab outage leaves the
+ * page empty instead of turning it into a 500.
+ */
+declare function listGuides(options?: GuideReadOptions): Promise<GuideSummary[]>;
+/**
+ * One published guide with its markdown and rendered HTML.
+ *
+ * Returns `null` when there is no such guide and on any failure — call
+ * `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 calls key (`ggc_…`). 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">`.
+ *
+ * Guide titles and summaries are written outside your codebase, and
+ * `JSON.stringify` leaves `<` alone — a title containing `</script>` closes the
+ * tag and whatever follows runs as HTML. The JSON unicode escape for `<` is the same
+ * character to a JSON parser and inert to the HTML one. `>`, `&` and the two
+ * JavaScript line separators are escaped for the same reason.
+ *
+ * ```tsx
+ * <script
+ *   type="application/ld+json"
+ *   dangerouslySetInnerHTML={{ __html: escapeJsonForScript({ "@type": "HowTo", name: guide.title }) }}
+ * />
+ * ```
+ *
+ * Never throws: a value JSON cannot represent (circular, `undefined`) becomes `null`.
+ */
+declare function escapeJsonForScript(value: unknown): string;
 
-export { type CaptureServerErrorsOptions, ReportResult, ReportSeverity, ReportType, type ServerReportOptions, type ServerReporterConfig, type ServerReporterIdentity, type SignSessionOptions, captureServerErrors, configureServerReporter, 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,6 +22,12 @@ 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,
   signSession: () => signSession
@@ -247,10 +253,207 @@ function signSession(options) {
   const sig = (0, import_node_crypto.createHmac)("sha256", secret).update(`v1.${exp}.${userId}`).digest("base64url");
   return `v1.${exp}.${sig}`;
 }
+var GUIDES_REVALIDATE_SECONDS = 300;
+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(), (_d = options.timeoutMs) != null ? _d : SDK_API_TIMEOUT_MS) : void 0;
+  try {
+    const request = {
+      method: (_e = init.method) != null ? _e : "GET",
+      headers: { Authorization: `Bearer ${token}` },
+      ...init.cache === "no-store" ? { cache: "no-store" } : { next: { revalidate: init.cache.revalidate } },
+      ...controller ? { signal: controller.signal } : {}
+    };
+    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 { 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;
+  if (typeof guide.slug !== "string" || typeof guide.title !== "string" || typeof guide.summary !== "string") {
+    return null;
+  }
+  return {
+    slug: guide.slug,
+    title: guide.title,
+    summary: guide.summary,
+    category: typeof guide.category === "string" ? guide.category : null,
+    orderIndex: typeof guide.orderIndex === "number" ? guide.orderIndex : 0,
+    status: guide.status === "DRAFT" ? "DRAFT" : "PUBLISHED",
+    lastVerifiedAt: typeof guide.lastVerifiedAt === "string" ? guide.lastVerifiedAt : null,
+    updatedAt: typeof guide.updatedAt === "string" ? guide.updatedAt : "",
+    link: typeof guide.link === "string" ? guide.link : null
+  };
+}
+async function listGuides(options = {}) {
+  try {
+    const data = await readGuidesApi("", options);
+    if (!Array.isArray(data)) return [];
+    return data.map(readGuideSummary).filter((guide) => guide !== null);
+  } catch (e) {
+    return [];
+  }
+}
+async function getGuide(slug, options = {}) {
+  try {
+    const wanted = typeof slug === "string" ? slug.trim() : "";
+    if (!wanted) return null;
+    const data = await readGuidesApi(`?slug=${encodeURIComponent(wanted)}`, options);
+    const summary = readGuideSummary(data);
+    const body = data;
+    if (!summary || typeof (body == null ? void 0 : body.html) !== "string") return null;
+    return {
+      ...summary,
+      content: typeof body.content === "string" ? body.content : "",
+      html: body.html
+    };
+  } catch (e) {
+    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 calls 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);
+    if (json === void 0) return "null";
+    return json.replace(/</g, "\\u003c").replace(/>/g, "\\u003e").replace(/&/g, "\\u0026").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+  } catch (e) {
+    return "null";
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   captureServerErrors,
   configureServerReporter,
+  deleteCall,
+  escapeJsonForScript,
+  getCall,
+  getGuide,
+  listCalls,
+  listGuides,
   reportServerError,
   resetServerReporter,
   signSession