@withpotter/lib 0.13.0-next.101

package/dist/api/disputes.d.ts

@@ -0,0 +1,47 @@
+import type { Dispute, DisputeStats } from './types';
+/**
+ * Chargebacks.
+ *
+ * Reading is `canViewFinance`; answering one is `canManageFinance` on the API,
+ * because a response is final and reaches the customer's bank under the
+ * merchant's name.
+ */
+export declare const disputesApi: {
+    list: (tenantSlug: string, params?: {
+        bucket?: "needs_merchant" | "settled";
+        status?: string;
+        page?: number;
+    }) => Promise<{
+        disputes: Dispute[];
+        total: number;
+        page: number;
+        limit: number;
+        totalPages: number;
+    }>;
+    /** The readings the money surface leads with. */
+    stats: (tenantSlug: string) => Promise<DisputeStats>;
+    /**
+     * Answer one. `contest` submits the merchant's case; `accept` concedes the
+     * debit. Both are final and they differ by the whole disputed amount, so the
+     * caller always says which.
+     */
+    respond: (tenantSlug: string, disputeId: string, body: {
+        action: "contest" | "accept";
+        message?: string;
+    }) => Promise<Dispute>;
+    /**
+     * Attach a document.
+     *
+     * Base64 in a JSON body, matching the internal media surface. Evidence is
+     * receipts and screenshots, and the API caps it at 5MB.
+     *
+     * Uploaded separately from the response on purpose: the file has to exist
+     * before the answer that quotes it, and a merchant gathering three documents
+     * should not lose them by closing the sheet.
+     */
+    uploadEvidence: (tenantSlug: string, disputeId: string, file: {
+        content: string;
+        filename: string;
+        mimetype: string;
+    }) => Promise<Dispute>;
+};

package/dist/api/disputes.js

@@ -0,0 +1,42 @@
+import { apiFetch } from "./core";
+const disputesApi = {
+  list: (tenantSlug, params) => {
+    const search = new URLSearchParams();
+    if (params?.bucket) search.set("bucket", params.bucket);
+    if (params?.status) search.set("status", params.status);
+    if (params?.page) search.set("page", String(params.page));
+    const qs = search.toString();
+    return apiFetch(`/disputes${qs ? `?${qs}` : ""}`, { tenantSlug });
+  },
+  /** The readings the money surface leads with. */
+  stats: (tenantSlug) => apiFetch("/disputes/stats", { tenantSlug }),
+  /**
+   * Answer one. `contest` submits the merchant's case; `accept` concedes the
+   * debit. Both are final and they differ by the whole disputed amount, so the
+   * caller always says which.
+   */
+  respond: (tenantSlug, disputeId, body) => apiFetch(`/disputes/${disputeId}/respond`, {
+    tenantSlug,
+    method: "POST",
+    body: JSON.stringify(body)
+  }),
+  /**
+   * Attach a document.
+   *
+   * Base64 in a JSON body, matching the internal media surface. Evidence is
+   * receipts and screenshots, and the API caps it at 5MB.
+   *
+   * Uploaded separately from the response on purpose: the file has to exist
+   * before the answer that quotes it, and a merchant gathering three documents
+   * should not lose them by closing the sheet.
+   */
+  uploadEvidence: (tenantSlug, disputeId, file) => apiFetch(`/disputes/${disputeId}/evidence`, {
+    tenantSlug,
+    method: "POST",
+    body: JSON.stringify(file)
+  })
+};
+export {
+  disputesApi
+};
+//# sourceMappingURL=disputes.js.map

package/dist/api/disputes.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/disputes.ts"],"sourcesContent":["import { apiFetch } from './core';\nimport type { Dispute, DisputeStats } from './types';\n\n/**\n * Chargebacks.\n *\n * Reading is `canViewFinance`; answering one is `canManageFinance` on the API,\n * because a response is final and reaches the customer's bank under the\n * merchant's name.\n */\nexport const disputesApi = {\n  list: (\n    tenantSlug: string,\n    params?: {\n      bucket?: 'needs_merchant' | 'settled';\n      status?: string;\n      page?: number;\n    },\n  ) => {\n    const search = new URLSearchParams();\n    if (params?.bucket) search.set('bucket', params.bucket);\n    if (params?.status) search.set('status', params.status);\n    if (params?.page) search.set('page', String(params.page));\n    const qs = search.toString();\n    return apiFetch<{\n      disputes: Dispute[];\n      total: number;\n      page: number;\n      limit: number;\n      totalPages: number;\n    }>(`/disputes${qs ? `?${qs}` : ''}`, { tenantSlug });\n  },\n\n  /** The readings the money surface leads with. */\n  stats: (tenantSlug: string) =>\n    apiFetch<DisputeStats>('/disputes/stats', { tenantSlug }),\n\n  /**\n   * Answer one. `contest` submits the merchant's case; `accept` concedes the\n   * debit. Both are final and they differ by the whole disputed amount, so the\n   * caller always says which.\n   */\n  respond: (\n    tenantSlug: string,\n    disputeId: string,\n    body: { action: 'contest' | 'accept'; message?: string },\n  ) =>\n    apiFetch<Dispute>(`/disputes/${disputeId}/respond`, {\n      tenantSlug,\n      method: 'POST',\n      body: JSON.stringify(body),\n    }),\n\n  /**\n   * Attach a document.\n   *\n   * Base64 in a JSON body, matching the internal media surface. Evidence is\n   * receipts and screenshots, and the API caps it at 5MB.\n   *\n   * Uploaded separately from the response on purpose: the file has to exist\n   * before the answer that quotes it, and a merchant gathering three documents\n   * should not lose them by closing the sheet.\n   */\n  uploadEvidence: (\n    tenantSlug: string,\n    disputeId: string,\n    file: { content: string; filename: string; mimetype: string },\n  ) =>\n    apiFetch<Dispute>(`/disputes/${disputeId}/evidence`, {\n      tenantSlug,\n      method: 'POST',\n      body: JSON.stringify(file),\n    }),\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AAUlB,MAAM,cAAc;AAAA,EACzB,MAAM,CACJ,YACA,WAKG;AACH,UAAM,SAAS,IAAI,gBAAgB;AACnC,QAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,OAAO,MAAM;AACtD,QAAI,QAAQ,OAAQ,QAAO,IAAI,UAAU,OAAO,MAAM;AACtD,QAAI,QAAQ,KAAM,QAAO,IAAI,QAAQ,OAAO,OAAO,IAAI,CAAC;AACxD,UAAM,KAAK,OAAO,SAAS;AAC3B,WAAO,SAMJ,YAAY,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,WAAW,CAAC;AAAA,EACrD;AAAA;AAAA,EAGA,OAAO,CAAC,eACN,SAAuB,mBAAmB,EAAE,WAAW,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAO1D,SAAS,CACP,YACA,WACA,SAEA,SAAkB,aAAa,SAAS,YAAY;AAAA,IAClD;AAAA,IACA,QAAQ;AAAA,IACR,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYH,gBAAgB,CACd,YACA,WACA,SAEA,SAAkB,aAAa,SAAS,aAAa;AAAA,IACnD;AAAA,IACA,QAAQ;AAAA,IACR,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AACL;","names":[]}

package/dist/api/feature-locked.d.ts

@@ -0,0 +1,11 @@
+/**
+ * A 402 from the engine's plan guard: `{code: 'feature_not_in_plan',
+ * feature}`. It is not "your subscription has lapsed", so it must not send
+ * the merchant to billing; the dashboard shows the locked-feature card for
+ * the page instead. `apiFetch` announces it on `window`; the plan provider
+ * listens.
+ */
+export declare const FEATURE_LOCKED_EVENT = "olive:feature-not-in-plan";
+/** The feature a 402 body names, or null when it is some other 402. */
+export declare function featureNotInPlan(body: unknown): string | null;
+export declare function announceFeatureLocked(feature: string): void;

package/dist/api/feature-locked.js

@@ -0,0 +1,18 @@
+const FEATURE_LOCKED_EVENT = "olive:feature-not-in-plan";
+function featureNotInPlan(body) {
+  if (!body || typeof body !== "object") return null;
+  const { code, feature } = body;
+  return code === "feature_not_in_plan" && typeof feature === "string" ? feature : null;
+}
+function announceFeatureLocked(feature) {
+  if (typeof window === "undefined") return;
+  window.dispatchEvent(
+    new CustomEvent(FEATURE_LOCKED_EVENT, { detail: { feature } })
+  );
+}
+export {
+  FEATURE_LOCKED_EVENT,
+  announceFeatureLocked,
+  featureNotInPlan
+};
+//# sourceMappingURL=feature-locked.js.map

package/dist/api/feature-locked.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/feature-locked.ts"],"sourcesContent":["/**\n * A 402 from the engine's plan guard: `{code: 'feature_not_in_plan',\n * feature}`. It is not \"your subscription has lapsed\", so it must not send\n * the merchant to billing; the dashboard shows the locked-feature card for\n * the page instead. `apiFetch` announces it on `window`; the plan provider\n * listens.\n */\nexport const FEATURE_LOCKED_EVENT = \"olive:feature-not-in-plan\";\n\n/** The feature a 402 body names, or null when it is some other 402. */\nexport function featureNotInPlan(body: unknown): string | null {\n  if (!body || typeof body !== \"object\") return null;\n\n  const { code, feature } = body as { code?: unknown; feature?: unknown };\n\n  return code === \"feature_not_in_plan\" && typeof feature === \"string\"\n    ? feature\n    : null;\n}\n\nexport function announceFeatureLocked(feature: string): void {\n  if (typeof window === \"undefined\") return;\n\n  window.dispatchEvent(\n    new CustomEvent(FEATURE_LOCKED_EVENT, { detail: { feature } })\n  );\n}\n"],"mappings":"AAOO,MAAM,uBAAuB;AAG7B,SAAS,iBAAiB,MAA8B;AAC7D,MAAI,CAAC,QAAQ,OAAO,SAAS,SAAU,QAAO;AAE9C,QAAM,EAAE,MAAM,QAAQ,IAAI;AAE1B,SAAO,SAAS,yBAAyB,OAAO,YAAY,WACxD,UACA;AACN;AAEO,SAAS,sBAAsB,SAAuB;AAC3D,MAAI,OAAO,WAAW,YAAa;AAEnC,SAAO;AAAA,IACL,IAAI,YAAY,sBAAsB,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC;AAAA,EAC/D;AACF;","names":[]}

package/dist/api/feedback-prompts.d.ts

@@ -0,0 +1,45 @@
+export type FeedbackPromptKind = 'nps' | 'csat' | 'ces' | 'thumb' | 'star';
+export interface EligibleFeedbackPrompt {
+    id: string;
+    key: string;
+    question: string;
+    followUp: string | null;
+    kind: FeedbackPromptKind;
+    scaleMin: number;
+    scaleMax: number;
+    allowComment: boolean;
+    allowVoice: boolean;
+    snoozeDays: number;
+}
+interface FeedbackSignal {
+    id: string;
+    kind: FeedbackPromptKind;
+    promptKey: string;
+    score: number;
+    createdAt: string;
+}
+interface RecordSignalInput {
+    prompt: EligibleFeedbackPrompt;
+    score: number;
+    route: string;
+}
+export interface FeedbackAudioUpload {
+    url: string;
+    duration?: number;
+}
+interface AttachSignalContext {
+    comment?: string;
+    audioUrl?: string;
+    audioSeconds?: number;
+}
+export declare const feedbackPromptsApi: {
+    eligible(tenantSlug: string, route: string): Promise<EligibleFeedbackPrompt[]>;
+    markSeen(tenantSlug: string, promptKey: string): Promise<{
+        seenCount: number;
+    }>;
+    dismiss(tenantSlug: string, promptKey: string, snoozeDays?: number): Promise<unknown>;
+    recordSignal(tenantSlug: string, { prompt, score, route }: RecordSignalInput): Promise<FeedbackSignal>;
+    uploadAudio(tenantSlug: string, file: File): Promise<FeedbackAudioUpload>;
+    attachComment(tenantSlug: string, signalId: string, context: AttachSignalContext): Promise<FeedbackSignal>;
+};
+export {};

package/dist/api/feedback-prompts.js

@@ -0,0 +1,85 @@
+import { apiFetch } from "@withpotter/lib/api";
+function eligibilityQuery(placement, route) {
+  const params = new URLSearchParams({ placement, route });
+  return `/feedback/prompts/eligible?${params.toString()}`;
+}
+const feedbackPromptsApi = {
+  async eligible(tenantSlug, route) {
+    const options = { tenantSlug };
+    const [pagePrompts, signInPrompts] = await Promise.all([
+      apiFetch(
+        eligibilityQuery("page", route),
+        options
+      ),
+      apiFetch(
+        eligibilityQuery("next_sign_in", route),
+        options
+      )
+    ]);
+    return [...pagePrompts, ...signInPrompts];
+  },
+  markSeen(tenantSlug, promptKey) {
+    return apiFetch(
+      `/feedback/prompts/${encodeURIComponent(promptKey)}/seen`,
+      { method: "POST", tenantSlug }
+    );
+  },
+  dismiss(tenantSlug, promptKey, snoozeDays) {
+    return apiFetch(
+      `/feedback/prompts/${encodeURIComponent(promptKey)}/dismiss`,
+      {
+        method: "POST",
+        tenantSlug,
+        body: JSON.stringify(snoozeDays === void 0 ? {} : { snoozeDays })
+      }
+    );
+  },
+  recordSignal(tenantSlug, { prompt, score, route }) {
+    return apiFetch("/feedback/signals", {
+      method: "POST",
+      tenantSlug,
+      body: JSON.stringify({
+        kind: prompt.kind,
+        promptKey: prompt.key,
+        score,
+        pageUrl: window.location.href,
+        viewport: `${window.innerWidth}x${window.innerHeight}`,
+        locale: navigator.language,
+        timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        theme: document.documentElement.classList.contains("dark") ? "dark" : "light",
+        route
+      })
+    });
+  },
+  uploadAudio(tenantSlug, file) {
+    const formData = new FormData();
+    formData.append("file", file);
+    const csrfToken = document.cookie.match(/pb_csrf_token=([^;]+)/)?.[1];
+    return fetch("/api/proxy/feedback/audio", {
+      method: "POST",
+      credentials: "include",
+      headers: {
+        "X-Tenant-Slug": tenantSlug,
+        ...csrfToken ? { "X-CSRF-Token": csrfToken } : {}
+      },
+      body: formData
+    }).then(async (response) => {
+      if (!response.ok) throw new Error("Audio upload failed");
+      return response.json();
+    });
+  },
+  attachComment(tenantSlug, signalId, context) {
+    return apiFetch(
+      `/feedback/signals/${encodeURIComponent(signalId)}/comment`,
+      {
+        method: "POST",
+        tenantSlug,
+        body: JSON.stringify(context)
+      }
+    );
+  }
+};
+export {
+  feedbackPromptsApi
+};
+//# sourceMappingURL=feedback-prompts.js.map

package/dist/api/feedback-prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/feedback-prompts.ts"],"sourcesContent":["import { apiFetch } from '@withpotter/lib/api';\n\nexport type FeedbackPromptKind = 'nps' | 'csat' | 'ces' | 'thumb' | 'star';\n\nexport interface EligibleFeedbackPrompt {\n  id: string;\n  key: string;\n  question: string;\n  followUp: string | null;\n  kind: FeedbackPromptKind;\n  scaleMin: number;\n  scaleMax: number;\n  allowComment: boolean;\n  allowVoice: boolean;\n  snoozeDays: number;\n}\n\ninterface FeedbackSignal {\n  id: string;\n  kind: FeedbackPromptKind;\n  promptKey: string;\n  score: number;\n  createdAt: string;\n}\n\ninterface RecordSignalInput {\n  prompt: EligibleFeedbackPrompt;\n  score: number;\n  route: string;\n}\n\nexport interface FeedbackAudioUpload {\n  url: string;\n  duration?: number;\n}\n\ninterface AttachSignalContext {\n  comment?: string;\n  audioUrl?: string;\n  audioSeconds?: number;\n}\n\nfunction eligibilityQuery(placement: 'page' | 'next_sign_in', route: string) {\n  const params = new URLSearchParams({ placement, route });\n  return `/feedback/prompts/eligible?${params.toString()}`;\n}\n\nexport const feedbackPromptsApi = {\n  async eligible(tenantSlug: string, route: string) {\n    const options = { tenantSlug };\n    const [pagePrompts, signInPrompts] = await Promise.all([\n      apiFetch<EligibleFeedbackPrompt[]>(\n        eligibilityQuery('page', route),\n        options,\n      ),\n      apiFetch<EligibleFeedbackPrompt[]>(\n        eligibilityQuery('next_sign_in', route),\n        options,\n      ),\n    ]);\n\n    return [...pagePrompts, ...signInPrompts];\n  },\n\n  markSeen(tenantSlug: string, promptKey: string) {\n    return apiFetch<{ seenCount: number }>(\n      `/feedback/prompts/${encodeURIComponent(promptKey)}/seen`,\n      { method: 'POST', tenantSlug },\n    );\n  },\n\n  dismiss(tenantSlug: string, promptKey: string, snoozeDays?: number) {\n    return apiFetch(\n      `/feedback/prompts/${encodeURIComponent(promptKey)}/dismiss`,\n      {\n        method: 'POST',\n        tenantSlug,\n        body: JSON.stringify(snoozeDays === undefined ? {} : { snoozeDays }),\n      },\n    );\n  },\n\n  recordSignal(\n    tenantSlug: string,\n    { prompt, score, route }: RecordSignalInput,\n  ) {\n    return apiFetch<FeedbackSignal>('/feedback/signals', {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify({\n        kind: prompt.kind,\n        promptKey: prompt.key,\n        score,\n        pageUrl: window.location.href,\n        viewport: `${window.innerWidth}x${window.innerHeight}`,\n        locale: navigator.language,\n        timeZone: Intl.DateTimeFormat().resolvedOptions().timeZone,\n        theme: document.documentElement.classList.contains('dark')\n          ? 'dark'\n          : 'light',\n        route,\n      }),\n    });\n  },\n\n  uploadAudio(tenantSlug: string, file: File) {\n    const formData = new FormData();\n    formData.append('file', file);\n    const csrfToken = document.cookie.match(/pb_csrf_token=([^;]+)/)?.[1];\n\n    return fetch('/api/proxy/feedback/audio', {\n      method: 'POST',\n      credentials: 'include',\n      headers: {\n        'X-Tenant-Slug': tenantSlug,\n        ...(csrfToken ? { 'X-CSRF-Token': csrfToken } : {}),\n      },\n      body: formData,\n    }).then(async (response) => {\n      if (!response.ok) throw new Error('Audio upload failed');\n      return response.json() as Promise<FeedbackAudioUpload>;\n    });\n  },\n\n  attachComment(\n    tenantSlug: string,\n    signalId: string,\n    context: AttachSignalContext,\n  ) {\n    return apiFetch<FeedbackSignal>(\n      `/feedback/signals/${encodeURIComponent(signalId)}/comment`,\n      {\n        method: 'POST',\n        tenantSlug,\n        body: JSON.stringify(context),\n      },\n    );\n  },\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AA0CzB,SAAS,iBAAiB,WAAoC,OAAe;AAC3E,QAAM,SAAS,IAAI,gBAAgB,EAAE,WAAW,MAAM,CAAC;AACvD,SAAO,8BAA8B,OAAO,SAAS,CAAC;AACxD;AAEO,MAAM,qBAAqB;AAAA,EAChC,MAAM,SAAS,YAAoB,OAAe;AAChD,UAAM,UAAU,EAAE,WAAW;AAC7B,UAAM,CAAC,aAAa,aAAa,IAAI,MAAM,QAAQ,IAAI;AAAA,MACrD;AAAA,QACE,iBAAiB,QAAQ,KAAK;AAAA,QAC9B;AAAA,MACF;AAAA,MACA;AAAA,QACE,iBAAiB,gBAAgB,KAAK;AAAA,QACtC;AAAA,MACF;AAAA,IACF,CAAC;AAED,WAAO,CAAC,GAAG,aAAa,GAAG,aAAa;AAAA,EAC1C;AAAA,EAEA,SAAS,YAAoB,WAAmB;AAC9C,WAAO;AAAA,MACL,qBAAqB,mBAAmB,SAAS,CAAC;AAAA,MAClD,EAAE,QAAQ,QAAQ,WAAW;AAAA,IAC/B;AAAA,EACF;AAAA,EAEA,QAAQ,YAAoB,WAAmB,YAAqB;AAClE,WAAO;AAAA,MACL,qBAAqB,mBAAmB,SAAS,CAAC;AAAA,MAClD;AAAA,QACE,QAAQ;AAAA,QACR;AAAA,QACA,MAAM,KAAK,UAAU,eAAe,SAAY,CAAC,IAAI,EAAE,WAAW,CAAC;AAAA,MACrE;AAAA,IACF;AAAA,EACF;AAAA,EAEA,aACE,YACA,EAAE,QAAQ,OAAO,MAAM,GACvB;AACA,WAAO,SAAyB,qBAAqB;AAAA,MACnD,QAAQ;AAAA,MACR;AAAA,MACA,MAAM,KAAK,UAAU;AAAA,QACnB,MAAM,OAAO;AAAA,QACb,WAAW,OAAO;AAAA,QAClB;AAAA,QACA,SAAS,OAAO,SAAS;AAAA,QACzB,UAAU,GAAG,OAAO,UAAU,IAAI,OAAO,WAAW;AAAA,QACpD,QAAQ,UAAU;AAAA,QAClB,UAAU,KAAK,eAAe,EAAE,gBAAgB,EAAE;AAAA,QAClD,OAAO,SAAS,gBAAgB,UAAU,SAAS,MAAM,IACrD,SACA;AAAA,QACJ;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAEA,YAAY,YAAoB,MAAY;AAC1C,UAAM,WAAW,IAAI,SAAS;AAC9B,aAAS,OAAO,QAAQ,IAAI;AAC5B,UAAM,YAAY,SAAS,OAAO,MAAM,uBAAuB,IAAI,CAAC;AAEpE,WAAO,MAAM,6BAA6B;AAAA,MACxC,QAAQ;AAAA,MACR,aAAa;AAAA,MACb,SAAS;AAAA,QACP,iBAAiB;AAAA,QACjB,GAAI,YAAY,EAAE,gBAAgB,UAAU,IAAI,CAAC;AAAA,MACnD;AAAA,MACA,MAAM;AAAA,IACR,CAAC,EAAE,KAAK,OAAO,aAAa;AAC1B,UAAI,CAAC,SAAS,GAAI,OAAM,IAAI,MAAM,qBAAqB;AACvD,aAAO,SAAS,KAAK;AAAA,IACvB,CAAC;AAAA,EACH;AAAA,EAEA,cACE,YACA,UACA,SACA;AACA,WAAO;AAAA,MACL,qBAAqB,mBAAmB,QAAQ,CAAC;AAAA,MACjD;AAAA,QACE,QAAQ;AAAA,QACR;AAAA,QACA,MAAM,KAAK,UAAU,OAAO;AAAA,MAC9B;AAAA,IACF;AAAA,EACF;AACF;","names":[]}

package/dist/api/feedback.d.ts

@@ -0,0 +1,254 @@
+/**
+ * The shape of the question. Not interchangeable — see the API entity for why
+ * a single `rating` column with no kind beside it cannot be read back.
+ */
+export type FeedbackSignalKind = 'nps' | 'csat' | 'ces' | 'thumb' | 'star';
+export type FeedbackPromptStateName = 'answered' | 'dismissed' | 'snoozed';
+export interface FeedbackPromptState {
+    promptKey: string;
+    state: FeedbackPromptStateName;
+    snoozeUntil: string | null;
+    seenCount: number;
+    /**
+     * Whether this account may be shown the prompt right now. Computed on the
+     * server so no screen re-derives "dismissed, or snoozed and the date has not
+     * passed" — that clause would have been spelled four ways across five call
+     * sites.
+     */
+    eligible: boolean;
+}
+export interface CreateFeedbackSignal {
+    kind: FeedbackSignalKind;
+    /** Which prompt asked: `home.nps.quarterly`, `catalog.import.ces`. */
+    promptKey: string;
+    score: number;
+    comment?: string;
+    /** What was rated, when the answer is about one object not the product. */
+    subjectType?: string;
+    subjectId?: string;
+    pageUrl?: string;
+    posthogSessionId?: string;
+    /**
+     * The room the answer was given in. Collected by `describeSurroundings`,
+     * because a score with no circumstances is a number: "3 out of 7 for the
+     * import" is a bad importer or a merchant doing it on a phone at midnight,
+     * and the two want opposite fixes.
+     */
+    viewport?: string;
+    locale?: string;
+    timeZone?: string;
+    theme?: string;
+    route?: string;
+}
+/**
+ * A message somebody sent us: the sentence, the screenshot, the clip.
+ *
+ * The other half of feedback, and the half that had no reader until now — a
+ * submission opened a GitHub issue and an email, so the console showed every
+ * score and nothing anybody said.
+ */
+export interface AdminFeedbackMessage {
+    id: string;
+    category: string;
+    status: string;
+    /** Null where the whole message was spoken. */
+    description: string | null;
+    audioUrl: string | null;
+    audioSeconds: number | null;
+    /** The real transcript, once the api has made one. Word times included. */
+    transcript: FeedbackTranscript | null;
+    screenshotUrl: string | null;
+    pageUrl: string;
+    /** The part of the product, in the merchant's own word for it. */
+    area: string | null;
+    /** The route pattern, ids masked. */
+    route: string | null;
+    browser: {
+        platform?: string;
+        userAgent?: string;
+        viewportWidth?: number;
+        viewportHeight?: number;
+        language?: string;
+    };
+    githubIssueUrl: string | null;
+    serviceCaseId: string | null;
+    createdAt: string;
+    business: FeedbackSignalBusiness | null;
+}
+/** What was said in a clip, with a time on every word. */
+export interface FeedbackTranscript {
+    text: string;
+    words: {
+        w: string;
+        s: number;
+        e: number;
+    }[];
+    by?: string;
+}
+/** The business an answer came from, resolved by the api rather than sent. */
+export interface FeedbackSignalBusiness {
+    name: string;
+    slug: string;
+    model: string[];
+    industry: string | null;
+    since: string;
+}
+export interface FeedbackSignalResponse {
+    id: string;
+    kind: FeedbackSignalKind;
+    promptKey: string;
+    score: number;
+    createdAt: string;
+}
+/** One prompt's aggregate, so nothing in this feature is write-only. */
+export interface FeedbackSignalSummaryRow {
+    promptKey: string;
+    kind: FeedbackSignalKind;
+    responses: number;
+    average: number;
+    /** Promoters minus detractors, NPS only. Null for every other kind. */
+    nps: number | null;
+    commented: number;
+}
+export declare const feedbackApi: {
+    /**
+     * Every prompt this account has already met, on any device.
+     *
+     * Read ONCE per session by `FeedbackPromptProvider` and shared, not called
+     * per prompt. The home already reads 29 endpoints and the catalogue 19
+     * against a 100-a-minute limiter; a feature whose whole job is to be
+     * sprinkled everywhere must not add a request per sprinkle.
+     */
+    listPrompts: () => Promise<FeedbackPromptState[]>;
+    /** The prompt went on screen. Returns the count including this showing. */
+    markSeen: (promptKey: string) => Promise<{
+        seenCount: number;
+    }>;
+    /**
+     * Wave a prompt away. No `snoozeDays` means for good; a number means "not
+     * now" and it comes back after that many days.
+     */
+    dismissPrompt: (promptKey: string, snoozeDays?: number) => Promise<FeedbackPromptState>;
+    /**
+     * Record a score.
+     *
+     * IT SENDS THE WORKSPACE, and the note that used to be here was wrong in a
+     * way that cost the whole feature. It read: "`tenantSlug` is deliberately not
+     * a parameter … the server reads whichever workspace the request already
+     * carries". The server carries nothing of the sort — `apiFetch` sets
+     * `X-Tenant-Slug` only when a caller passes one, and the api's `CurrentTenant`
+     * throws a 404 when it is absent. So every score anybody ever pressed came
+     * back 404, silently, because this fires and forgets. Measured on a real
+     * session: 404 before, 201 after.
+     *
+     * The worry underneath it — that naming a workspace surveys a two-business
+     * merchant twice — was about the wrong thing. Eligibility is keyed by
+     * ACCOUNT (`/feedback/prompts` reads by accountId), so who gets asked does
+     * not change; only what the answer is filed against does. And it has to be
+     * filed against something: the admin panel shows which business said it, and
+     * a complaint cannot become a support case without a workspace to open it
+     * on.
+     */
+    recordSignal: (data: CreateFeedbackSignal, tenantSlug?: string) => Promise<FeedbackSignalResponse>;
+    /**
+     * Attach the sentence to a score already recorded.
+     *
+     * Two calls rather than one because the score must not wait for the prose:
+     * most people press a number and never write anything, and a flow that held
+     * the answer back until the comment step resolved would have thrown those
+     * away. An empty string clears the comment rather than failing.
+     */
+    attachComment: (signalId: string, body: {
+        comment?: string;
+        audioUrl?: string;
+        audioSeconds?: number;
+    }) => Promise<FeedbackSignalResponse>;
+};
+/**
+ * These sit under `platform-admin/v1` and are guarded by `PlatformAdminGuard`,
+ * which verifies a `pb_admin_token` with `kind: 'admin'`. A merchant session
+ * cannot satisfy it at all.
+ *
+ * The summary first shipped on the merchant controller behind the ordinary
+ * auth guard, and it aggregates the whole table with no tenant filter —
+ * because a cross-merchant NPS is the only NPS worth having. So every merchant
+ * could read every other merchant's scores. The query was right and the door
+ * was wrong; this is the right door.
+ */
+export interface FeedbackSignalComment {
+    id: string;
+    /** The real transcript of the clip, once one exists. */
+    transcript: FeedbackTranscript | null;
+    /** Who said it. Null for an answer left outside any workspace. */
+    business: FeedbackSignalBusiness | null;
+    /** The case somebody opened from this answer, if anybody has. */
+    serviceCaseId: string | null;
+    promptKey: string;
+    kind: FeedbackSignalKind;
+    score: number;
+    /** Null when the answer was spoken rather than typed. */
+    comment: string | null;
+    audioUrl: string | null;
+    audioSeconds: number | null;
+    createdAt: string;
+    context: {
+        tenantSlug?: string;
+        userEmail?: string;
+        pageUrl?: string;
+        seenCount?: number;
+        posthogSessionId?: string;
+        viewport?: string;
+        locale?: string;
+        timeZone?: string;
+        theme?: string;
+        route?: string;
+    };
+}
+/**
+ * How a prompt is FARING rather than what it scored. A prompt with a lovely
+ * average that forty people closed is not a lovely prompt.
+ */
+export interface FeedbackPromptHealth {
+    promptKey: string;
+    people: number;
+    shown: number;
+    answered: number;
+    dismissed: number;
+    waiting: number;
+}
+export interface AdminIdentity {
+    id: string;
+    email: string;
+    name: string;
+    role: string;
+}
+export declare const adminFeedbackApi: {
+    login: (email: string, password: string) => Promise<{
+        mustChangePassword: boolean;
+        admin: AdminIdentity;
+    }>;
+    me: () => Promise<AdminIdentity>;
+    summary: (days?: number) => Promise<FeedbackSignalSummaryRow[]>;
+    comments: (days?: number, promptKey?: string) => Promise<FeedbackSignalComment[]>;
+    promptHealth: () => Promise<FeedbackPromptHealth[]>;
+    /**
+     * Pick a complaint up: open a support case in the merchant's own inbox,
+     * carrying what they said.
+     *
+     * Idempotent on the server — the signal remembers which case it became — so
+     * a second press, a reload, or a second admin reading the same panel cannot
+     * split one complaint across two conversations. `created: false` means it
+     * was already open.
+     */
+    /** What merchants wrote, recorded or photographed for us. */
+    messages: (days?: number, limit?: number) => Promise<AdminFeedbackMessage[]>;
+    /** Pick a message up. Same act, same rules, as picking up a score. */
+    openCaseFromMessage: (id: string) => Promise<{
+        caseId: string;
+        created: boolean;
+    }>;
+    openCase: (signalId: string) => Promise<{
+        caseId: string;
+        created: boolean;
+    }>;
+};

package/dist/api/feedback.js

@@ -0,0 +1,108 @@
+import { apiFetch } from "./core";
+const feedbackApi = {
+  /**
+   * Every prompt this account has already met, on any device.
+   *
+   * Read ONCE per session by `FeedbackPromptProvider` and shared, not called
+   * per prompt. The home already reads 29 endpoints and the catalogue 19
+   * against a 100-a-minute limiter; a feature whose whole job is to be
+   * sprinkled everywhere must not add a request per sprinkle.
+   */
+  listPrompts: () => apiFetch("/feedback/prompts"),
+  /** The prompt went on screen. Returns the count including this showing. */
+  markSeen: (promptKey) => apiFetch(
+    `/feedback/prompts/${encodeURIComponent(promptKey)}/seen`,
+    { method: "POST" }
+  ),
+  /**
+   * Wave a prompt away. No `snoozeDays` means for good; a number means "not
+   * now" and it comes back after that many days.
+   */
+  dismissPrompt: (promptKey, snoozeDays) => apiFetch(
+    `/feedback/prompts/${encodeURIComponent(promptKey)}/dismiss`,
+    {
+      method: "POST",
+      body: JSON.stringify(snoozeDays === void 0 ? {} : { snoozeDays })
+    }
+  ),
+  /**
+   * Record a score.
+   *
+   * IT SENDS THE WORKSPACE, and the note that used to be here was wrong in a
+   * way that cost the whole feature. It read: "`tenantSlug` is deliberately not
+   * a parameter … the server reads whichever workspace the request already
+   * carries". The server carries nothing of the sort — `apiFetch` sets
+   * `X-Tenant-Slug` only when a caller passes one, and the api's `CurrentTenant`
+   * throws a 404 when it is absent. So every score anybody ever pressed came
+   * back 404, silently, because this fires and forgets. Measured on a real
+   * session: 404 before, 201 after.
+   *
+   * The worry underneath it — that naming a workspace surveys a two-business
+   * merchant twice — was about the wrong thing. Eligibility is keyed by
+   * ACCOUNT (`/feedback/prompts` reads by accountId), so who gets asked does
+   * not change; only what the answer is filed against does. And it has to be
+   * filed against something: the admin panel shows which business said it, and
+   * a complaint cannot become a support case without a workspace to open it
+   * on.
+   */
+  recordSignal: (data, tenantSlug) => apiFetch("/feedback/signals", {
+    method: "POST",
+    tenantSlug,
+    body: JSON.stringify(data)
+  }),
+  /**
+   * Attach the sentence to a score already recorded.
+   *
+   * Two calls rather than one because the score must not wait for the prose:
+   * most people press a number and never write anything, and a flow that held
+   * the answer back until the comment step resolved would have thrown those
+   * away. An empty string clears the comment rather than failing.
+   */
+  attachComment: (signalId, body) => apiFetch(
+    `/feedback/signals/${encodeURIComponent(signalId)}/comment`,
+    { method: "POST", body: JSON.stringify(body) }
+  )
+};
+const adminFeedbackApi = {
+  login: (email, password) => apiFetch(
+    "/platform-admin/v1/auth/login",
+    { method: "POST", body: JSON.stringify({ email, password }) }
+  ),
+  me: () => apiFetch("/platform-admin/v1/auth/me"),
+  summary: (days = 90) => apiFetch(
+    `/platform-admin/v1/feedback/summary?days=${days}`
+  ),
+  comments: (days = 90, promptKey) => apiFetch(
+    `/platform-admin/v1/feedback/comments?days=${days}` + (promptKey ? `&promptKey=${encodeURIComponent(promptKey)}` : "")
+  ),
+  promptHealth: () => apiFetch(
+    "/platform-admin/v1/feedback/prompt-health"
+  ),
+  /**
+   * Pick a complaint up: open a support case in the merchant's own inbox,
+   * carrying what they said.
+   *
+   * Idempotent on the server — the signal remembers which case it became — so
+   * a second press, a reload, or a second admin reading the same panel cannot
+   * split one complaint across two conversations. `created: false` means it
+   * was already open.
+   */
+  /** What merchants wrote, recorded or photographed for us. */
+  messages: (days = 90, limit = 100) => apiFetch(
+    `/platform-admin/v1/feedback/messages?days=${days}&limit=${limit}`
+  ),
+  /** Pick a message up. Same act, same rules, as picking up a score. */
+  openCaseFromMessage: (id) => apiFetch(
+    `/platform-admin/v1/feedback/messages/${id}/case`,
+    { method: "POST" }
+  ),
+  openCase: (signalId) => apiFetch(
+    `/platform-admin/v1/feedback/signals/${signalId}/case`,
+    { method: "POST" }
+  )
+};
+export {
+  adminFeedbackApi,
+  feedbackApi
+};
+//# sourceMappingURL=feedback.js.map