@withpotter/lib 0.13.0-next.101

package/dist/admin-service-operations-api.d.ts

@@ -0,0 +1,142 @@
+import type { CountryFields } from './admin-country-api';
+export type ServiceCaseStatus = 'open' | 'waiting_on_potter' | 'waiting_on_tenant' | 'waiting_on_customer' | 'resolved' | 'closed';
+export type ServiceCasePriority = 'low' | 'normal' | 'high' | 'urgent';
+export type CaseMessageVisibility = 'participants' | 'internal';
+export type ReviewStatus = 'pending' | 'approved' | 'rejected' | 'flagged';
+export interface PlatformServiceCaseAttachment {
+    url: string;
+    name: string;
+    mimeType: string;
+    size: number;
+}
+export interface PlatformServiceCaseMessage {
+    id: string;
+    authorType: 'merchant' | 'customer' | 'platform_admin' | 'tenant_member' | 'system';
+    authorId: string | null;
+    visibility: CaseMessageVisibility;
+    body: string;
+    attachments?: PlatformServiceCaseAttachment[];
+    createdAt: string;
+}
+export interface SupportReplyInput {
+    body: string;
+    visibility: CaseMessageVisibility;
+    /** The saved reply this message started from, so its usage is counted. */
+    savedReplyId?: string;
+    /** The AI draft this message was edited from. */
+    draftId?: string;
+}
+export interface PlatformServiceCase {
+    id: string;
+    reference: string;
+    tenantId: string;
+    tenant?: CountryFields & {
+        id: string;
+        businessName: string;
+        slug: string;
+    };
+    supportContext?: {
+        sender: {
+            accountId: string | null;
+            name: string;
+            email: string;
+            avatarUrl: string | null;
+            emailVerified: boolean;
+            status: string | null;
+            lastLoginAt: string | null;
+        };
+        workspace: CountryFields & {
+            tenantId: string;
+            businessName: string;
+            slug: string;
+            industry: string | null;
+            status: string | null;
+            joinedAt: string | null;
+            plan: string | null;
+            billingStatus: string | null;
+            currency: string | null;
+            timezone: string | null;
+        };
+    };
+    reporterName: string;
+    reporterEmail: string;
+    subject: string;
+    description: string;
+    category: string;
+    priority: ServiceCasePriority;
+    status: ServiceCaseStatus;
+    assignedAdminUserId: string | null;
+    firstResponseDueAt: string | null;
+    resolutionDueAt: string | null;
+    firstRespondedAt: string | null;
+    resolvedAt: string | null;
+    closedAt: string | null;
+    createdAt: string;
+    updatedAt: string;
+    messages?: PlatformServiceCaseMessage[];
+}
+export interface PlatformReview {
+    id: string;
+    tenantId: string;
+    contentId: string;
+    rating: number;
+    title: string | null;
+    body: string;
+    reviewerName: string;
+    status: ReviewStatus;
+    isVerifiedPurchase: boolean;
+    merchantResponse: string | null;
+    merchantRespondedAt: string | null;
+    createdAt: string;
+}
+interface Page<T> {
+    rows: T[];
+    total: number;
+    page: number;
+    pageSize: number;
+}
+export interface SupportCaseQuery {
+    tenantId?: string;
+    assignedAdminUserId?: string;
+    status?: ServiceCaseStatus;
+    priority?: ServiceCasePriority;
+    search?: string;
+    page?: number;
+    pageSize?: number;
+}
+export interface ReviewQuery {
+    tenantId?: string;
+    rating?: number;
+    status?: ReviewStatus;
+    page?: number;
+    pageSize?: number;
+}
+export declare const adminServiceOperationsApi: {
+    listCases(params?: SupportCaseQuery): Promise<Page<PlatformServiceCase>>;
+    caseDetail(caseId: string): Promise<PlatformServiceCase>;
+    /** An admin's first message to a merchant; `sentToast` reads the flags. */
+    createCase(input: {
+        tenantId: string;
+        subject: string;
+        message: string;
+    }): Promise<PlatformServiceCase & {
+        emailSent?: boolean | null;
+        duplicate?: boolean;
+    }>;
+    updateCase(caseId: string, update: Partial<Pick<PlatformServiceCase, "assignedAdminUserId" | "priority" | "status">>): Promise<PlatformServiceCase>;
+    reply(caseId: string, input: SupportReplyInput): Promise<PlatformServiceCaseMessage>;
+    listReviews(params?: ReviewQuery): Promise<Page<PlatformReview>>;
+    reviewAnalytics(params?: ReviewQuery): Promise<{
+        total: number;
+        averageRating: number;
+        ratingDistribution: Array<{
+            rating: number;
+            total: number;
+        }>;
+        statusDistribution: Array<{
+            status: ReviewStatus;
+            total: number;
+        }>;
+    }>;
+};
+export {};

package/dist/admin-service-operations-api.js

@@ -0,0 +1,52 @@
+import { apiFetch } from "./api";
+function queryString(params) {
+  const query = new URLSearchParams();
+  Object.entries(params).forEach(([key, value2]) => {
+    if (value2 !== void 0 && value2 !== "") query.set(key, String(value2));
+  });
+  const value = query.toString();
+  return value ? `?${value}` : "";
+}
+const adminServiceOperationsApi = {
+  listCases(params = {}) {
+    return apiFetch(
+      `/platform-admin/v1/support/cases${queryString({ ...params })}`
+    );
+  },
+  caseDetail(caseId) {
+    return apiFetch(
+      `/platform-admin/v1/support/cases/${caseId}`
+    );
+  },
+  /** An admin's first message to a merchant; `sentToast` reads the flags. */
+  createCase(input) {
+    return apiFetch("/platform-admin/v1/support/cases", {
+      method: "POST",
+      body: JSON.stringify(input)
+    });
+  },
+  updateCase(caseId, update) {
+    return apiFetch(
+      `/platform-admin/v1/support/cases/${caseId}`,
+      { method: "PATCH", body: JSON.stringify(update) }
+    );
+  },
+  reply(caseId, input) {
+    return apiFetch(
+      `/platform-admin/v1/support/cases/${caseId}/messages`,
+      { method: "POST", body: JSON.stringify(input) }
+    );
+  },
+  listReviews(params = {}) {
+    return apiFetch(
+      `/platform-admin/v1/reviews${queryString({ ...params })}`
+    );
+  },
+  reviewAnalytics(params = {}) {
+    return apiFetch(`/platform-admin/v1/reviews/analytics${queryString({ ...params })}`);
+  }
+};
+export {
+  adminServiceOperationsApi
+};
+//# sourceMappingURL=admin-service-operations-api.js.map

package/dist/admin-service-operations-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-service-operations-api.ts"],"sourcesContent":["import { apiFetch } from './api';\nimport type { CountryFields } from './admin-country-api';\n\nexport type ServiceCaseStatus =\n  | 'open'\n  | 'waiting_on_potter'\n  | 'waiting_on_tenant'\n  | 'waiting_on_customer'\n  | 'resolved'\n  | 'closed';\nexport type ServiceCasePriority = 'low' | 'normal' | 'high' | 'urgent';\nexport type CaseMessageVisibility = 'participants' | 'internal';\nexport type ReviewStatus = 'pending' | 'approved' | 'rejected' | 'flagged';\n\nexport interface PlatformServiceCaseAttachment {\n  url: string;\n  name: string;\n  mimeType: string;\n  size: number;\n}\n\nexport interface PlatformServiceCaseMessage {\n  id: string;\n  authorType:\n    | 'merchant'\n    | 'customer'\n    | 'platform_admin'\n    | 'tenant_member'\n    | 'system';\n  authorId: string | null;\n  visibility: CaseMessageVisibility;\n  body: string;\n  attachments?: PlatformServiceCaseAttachment[];\n  createdAt: string;\n}\n\nexport interface SupportReplyInput {\n  body: string;\n  visibility: CaseMessageVisibility;\n  /** The saved reply this message started from, so its usage is counted. */\n  savedReplyId?: string;\n  /** The AI draft this message was edited from. */\n  draftId?: string;\n}\n\nexport interface PlatformServiceCase {\n  id: string;\n  reference: string;\n  tenantId: string;\n  tenant?: CountryFields & {\n    id: string;\n    businessName: string;\n    slug: string;\n  };\n  supportContext?: {\n    sender: {\n      accountId: string | null;\n      name: string;\n      email: string;\n      avatarUrl: string | null;\n      emailVerified: boolean;\n      status: string | null;\n      lastLoginAt: string | null;\n    };\n    workspace: CountryFields & {\n      tenantId: string;\n      businessName: string;\n      slug: string;\n      industry: string | null;\n      status: string | null;\n      joinedAt: string | null;\n      plan: string | null;\n      billingStatus: string | null;\n      currency: string | null;\n      timezone: string | null;\n    };\n  };\n  reporterName: string;\n  reporterEmail: string;\n  subject: string;\n  description: string;\n  category: string;\n  priority: ServiceCasePriority;\n  status: ServiceCaseStatus;\n  assignedAdminUserId: string | null;\n  firstResponseDueAt: string | null;\n  resolutionDueAt: string | null;\n  firstRespondedAt: string | null;\n  resolvedAt: string | null;\n  closedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n  messages?: PlatformServiceCaseMessage[];\n}\n\nexport interface PlatformReview {\n  id: string;\n  tenantId: string;\n  contentId: string;\n  rating: number;\n  title: string | null;\n  body: string;\n  reviewerName: string;\n  status: ReviewStatus;\n  isVerifiedPurchase: boolean;\n  merchantResponse: string | null;\n  merchantRespondedAt: string | null;\n  createdAt: string;\n}\n\ninterface Page<T> {\n  rows: T[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\nexport interface SupportCaseQuery {\n  tenantId?: string;\n  assignedAdminUserId?: string;\n  status?: ServiceCaseStatus;\n  priority?: ServiceCasePriority;\n  search?: string;\n  page?: number;\n  pageSize?: number;\n}\n\nexport interface ReviewQuery {\n  tenantId?: string;\n  rating?: number;\n  status?: ReviewStatus;\n  page?: number;\n  pageSize?: number;\n}\n\nfunction queryString(params: Record<string, string | number | undefined>) {\n  const query = new URLSearchParams();\n  Object.entries(params).forEach(([key, value]) => {\n    if (value !== undefined && value !== '') query.set(key, String(value));\n  });\n  const value = query.toString();\n  return value ? `?${value}` : '';\n}\n\nexport const adminServiceOperationsApi = {\n  listCases(params: SupportCaseQuery = {}) {\n    return apiFetch<Page<PlatformServiceCase>>(\n      `/platform-admin/v1/support/cases${queryString({ ...params })}`,\n    );\n  },\n  caseDetail(caseId: string) {\n    return apiFetch<PlatformServiceCase>(\n      `/platform-admin/v1/support/cases/${caseId}`,\n    );\n  },\n  /** An admin's first message to a merchant; `sentToast` reads the flags. */\n  createCase(input: { tenantId: string; subject: string; message: string }) {\n    return apiFetch<\n      PlatformServiceCase & {\n        emailSent?: boolean | null;\n        duplicate?: boolean;\n      }\n    >('/platform-admin/v1/support/cases', {\n      method: 'POST',\n      body: JSON.stringify(input),\n    });\n  },\n  updateCase(\n    caseId: string,\n    update: Partial<\n      Pick<PlatformServiceCase, 'assignedAdminUserId' | 'priority' | 'status'>\n    >,\n  ) {\n    return apiFetch<PlatformServiceCase>(\n      `/platform-admin/v1/support/cases/${caseId}`,\n      { method: 'PATCH', body: JSON.stringify(update) },\n    );\n  },\n  reply(caseId: string, input: SupportReplyInput) {\n    return apiFetch<PlatformServiceCaseMessage>(\n      `/platform-admin/v1/support/cases/${caseId}/messages`,\n      { method: 'POST', body: JSON.stringify(input) },\n    );\n  },\n  listReviews(params: ReviewQuery = {}) {\n    return apiFetch<Page<PlatformReview>>(\n      `/platform-admin/v1/reviews${queryString({ ...params })}`,\n    );\n  },\n  reviewAnalytics(params: ReviewQuery = {}) {\n    return apiFetch<{\n      total: number;\n      averageRating: number;\n      ratingDistribution: Array<{ rating: number; total: number }>;\n      statusDistribution: Array<{ status: ReviewStatus; total: number }>;\n    }>(`/platform-admin/v1/reviews/analytics${queryString({ ...params })}`);\n  },\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AAuIzB,SAAS,YAAY,QAAqD;AACxE,QAAM,QAAQ,IAAI,gBAAgB;AAClC,SAAO,QAAQ,MAAM,EAAE,QAAQ,CAAC,CAAC,KAAKA,MAAK,MAAM;AAC/C,QAAIA,WAAU,UAAaA,WAAU,GAAI,OAAM,IAAI,KAAK,OAAOA,MAAK,CAAC;AAAA,EACvE,CAAC;AACD,QAAM,QAAQ,MAAM,SAAS;AAC7B,SAAO,QAAQ,IAAI,KAAK,KAAK;AAC/B;AAEO,MAAM,4BAA4B;AAAA,EACvC,UAAU,SAA2B,CAAC,GAAG;AACvC,WAAO;AAAA,MACL,mCAAmC,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC;AAAA,IAC/D;AAAA,EACF;AAAA,EACA,WAAW,QAAgB;AACzB,WAAO;AAAA,MACL,oCAAoC,MAAM;AAAA,IAC5C;AAAA,EACF;AAAA;AAAA,EAEA,WAAW,OAA+D;AACxE,WAAO,SAKL,oCAAoC;AAAA,MACpC,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,KAAK;AAAA,IAC5B,CAAC;AAAA,EACH;AAAA,EACA,WACE,QACA,QAGA;AACA,WAAO;AAAA,MACL,oCAAoC,MAAM;AAAA,MAC1C,EAAE,QAAQ,SAAS,MAAM,KAAK,UAAU,MAAM,EAAE;AAAA,IAClD;AAAA,EACF;AAAA,EACA,MAAM,QAAgB,OAA0B;AAC9C,WAAO;AAAA,MACL,oCAAoC,MAAM;AAAA,MAC1C,EAAE,QAAQ,QAAQ,MAAM,KAAK,UAAU,KAAK,EAAE;AAAA,IAChD;AAAA,EACF;AAAA,EACA,YAAY,SAAsB,CAAC,GAAG;AACpC,WAAO;AAAA,MACL,6BAA6B,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC;AAAA,IACzD;AAAA,EACF;AAAA,EACA,gBAAgB,SAAsB,CAAC,GAAG;AACxC,WAAO,SAKJ,uCAAuC,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC,EAAE;AAAA,EACxE;AACF;","names":["value"]}

package/dist/admin-signatures-api.d.ts

@@ -0,0 +1,57 @@
+/** Everything an admin writes for a signature. Absent is `""`. */
+export interface SignatureFields {
+    /** What the saved signature is called in the list, e.g. a team name. */
+    label: string;
+    /** The person or team signing. The one required field. */
+    name: string;
+    /** Their role. */
+    title: string;
+    /** The line above the name. */
+    closing: string;
+    email: string;
+    linkLabel: string;
+    linkUrl: string;
+    logoUrl: string;
+    bannerUrl: string;
+}
+/**
+ * A signature as it arrives. Only `name` is certain: rows saved before the
+ * branding fields existed may leave the rest out, or send null.
+ */
+type Loose = {
+    name: string;
+} & {
+    [K in Exclude<keyof SignatureFields, 'name'>]?: string | null;
+};
+export type Signature = Loose & {
+    id: string;
+    createdBy: {
+        id: string;
+        name: string;
+    } | null;
+    createdAt: string;
+    updatedAt: string;
+};
+/** The copy a newsletter carries. A snapshot: later edits do not reach it. */
+export type NewsletterSignature = Loose & {
+    id: string;
+};
+/** A create or an edit: `name`, and whichever other fields are being set. */
+export type SignatureInput = Partial<SignatureFields> & {
+    name: string;
+};
+export declare const adminSignaturesApi: {
+    list: () => Promise<{
+        items: Signature[];
+    }>;
+    create: (input: SignatureInput) => Promise<Signature>;
+    update: (id: string, input: SignatureInput) => Promise<Signature>;
+    remove: (id: string) => Promise<{
+        success: boolean;
+    }>;
+    /** The signature block as the email will draw it. Nothing is saved. */
+    preview: (fields: SignatureFields) => Promise<{
+        html: string;
+    }>;
+};
+export {};

package/dist/admin-signatures-api.js

@@ -0,0 +1,15 @@
+import { apiFetch } from "./api";
+const BASE = "/platform-admin/v1/newsletter-signatures";
+const send = (path, method, body) => apiFetch(`${BASE}${path}`, { method, body: JSON.stringify(body) });
+const adminSignaturesApi = {
+  list: () => apiFetch(BASE),
+  create: (input) => send("", "POST", input),
+  update: (id, input) => send(`/${id}`, "PATCH", input),
+  remove: (id) => apiFetch(`${BASE}/${id}`, { method: "DELETE" }),
+  /** The signature block as the email will draw it. Nothing is saved. */
+  preview: (fields) => send("/preview", "POST", fields)
+};
+export {
+  adminSignaturesApi
+};
+//# sourceMappingURL=admin-signatures-api.js.map

package/dist/admin-signatures-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-signatures-api.ts"],"sourcesContent":["import { apiFetch } from './api';\n\n/** Everything an admin writes for a signature. Absent is `\"\"`. */\nexport interface SignatureFields {\n  /** What the saved signature is called in the list, e.g. a team name. */\n  label: string;\n  /** The person or team signing. The one required field. */\n  name: string;\n  /** Their role. */\n  title: string;\n  /** The line above the name. */\n  closing: string;\n  email: string;\n  linkLabel: string;\n  linkUrl: string;\n  logoUrl: string;\n  bannerUrl: string;\n}\n\n/**\n * A signature as it arrives. Only `name` is certain: rows saved before the\n * branding fields existed may leave the rest out, or send null.\n */\ntype Loose = { name: string } & {\n  [K in Exclude<keyof SignatureFields, 'name'>]?: string | null;\n};\n\nexport type Signature = Loose & {\n  id: string;\n  createdBy: { id: string; name: string } | null;\n  createdAt: string;\n  updatedAt: string;\n};\n\n/** The copy a newsletter carries. A snapshot: later edits do not reach it. */\nexport type NewsletterSignature = Loose & { id: string };\n\n/** A create or an edit: `name`, and whichever other fields are being set. */\nexport type SignatureInput = Partial<SignatureFields> & { name: string };\n\nconst BASE = '/platform-admin/v1/newsletter-signatures';\nconst send = <T>(path: string, method: string, body: unknown) =>\n  apiFetch<T>(`${BASE}${path}`, { method, body: JSON.stringify(body) });\n\nexport const adminSignaturesApi = {\n  list: () => apiFetch<{ items: Signature[] }>(BASE),\n  create: (input: SignatureInput) => send<Signature>('', 'POST', input),\n  update: (id: string, input: SignatureInput) =>\n    send<Signature>(`/${id}`, 'PATCH', input),\n  remove: (id: string) =>\n    apiFetch<{ success: boolean }>(`${BASE}/${id}`, { method: 'DELETE' }),\n  /** The signature block as the email will draw it. Nothing is saved. */\n  preview: (fields: SignatureFields) =>\n    send<{ html: string }>('/preview', 'POST', fields),\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AAwCzB,MAAM,OAAO;AACb,MAAM,OAAO,CAAI,MAAc,QAAgB,SAC7C,SAAY,GAAG,IAAI,GAAG,IAAI,IAAI,EAAE,QAAQ,MAAM,KAAK,UAAU,IAAI,EAAE,CAAC;AAE/D,MAAM,qBAAqB;AAAA,EAChC,MAAM,MAAM,SAAiC,IAAI;AAAA,EACjD,QAAQ,CAAC,UAA0B,KAAgB,IAAI,QAAQ,KAAK;AAAA,EACpE,QAAQ,CAAC,IAAY,UACnB,KAAgB,IAAI,EAAE,IAAI,SAAS,KAAK;AAAA,EAC1C,QAAQ,CAAC,OACP,SAA+B,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,QAAQ,SAAS,CAAC;AAAA;AAAA,EAEtE,SAAS,CAAC,WACR,KAAuB,YAAY,QAAQ,MAAM;AACrD;","names":[]}

package/dist/admin-support-analytics-api.d.ts

@@ -0,0 +1,36 @@
+import type { PlatformServiceCase, ServiceCaseStatus, SupportCaseQuery } from './admin-service-operations-api';
+/**
+ * `GET /platform-admin/v1/support/analytics`: the queue counted by status,
+ * plus SLA events and satisfaction scores, for the same filters as the case
+ * list. The response is read defensively: any field the API leaves out comes
+ * back `null` so the page can fall back to counting cases itself.
+ */
+export interface SupportAnalytics {
+    total: number | null;
+    /** Null when the API sent no breakdown; a status it left out is zero. */
+    byStatus: Partial<Record<ServiceCaseStatus, number>> | null;
+    slaWarnings: number | null;
+    slaBreaches: number | null;
+    satisfaction: Array<{
+        metric: string;
+        responses: number;
+        average: number | null;
+    }>;
+}
+/** Turn whatever the API sent into the shape above, never throwing. */
+export declare function parseSupportAnalytics(raw: unknown): SupportAnalytics;
+export declare const adminSupportAnalyticsApi: {
+    get(params?: SupportCaseQuery & {
+        startDate?: string;
+        endDate?: string;
+    }): Promise<SupportAnalytics>;
+    /**
+     * Every case opened since `startDate` (the API filters on `created_at`),
+     * read page by page up to `maxPages` of 100. `total` is the API's own
+     * count, so it stays exact even when the rows stop at the cap.
+     */
+    casesSince(startDate: string, maxPages?: number): Promise<{
+        rows: PlatformServiceCase[];
+        total: number;
+    }>;
+};

package/dist/admin-support-analytics-api.js

@@ -0,0 +1,71 @@
+import { apiFetch } from "./api";
+const num = (value) => {
+  const n = typeof value === "string" ? Number(value) : value;
+  return typeof n === "number" && Number.isFinite(n) ? n : null;
+};
+const list = (value) => Array.isArray(value) ? value.filter(
+  (row) => typeof row === "object" && row !== null
+) : [];
+function parseSupportAnalytics(raw) {
+  const body = typeof raw === "object" && raw !== null ? raw : {};
+  const byStatus = {};
+  for (const row of list(body.byStatus)) {
+    const total = num(row.total ?? row.count);
+    if (typeof row.status === "string" && total !== null)
+      byStatus[row.status] = total;
+  }
+  const sla = list(body.sla);
+  const slaCount = (suffix) => {
+    if (!Array.isArray(body.sla)) return null;
+    return sla.filter((row) => String(row.name ?? "").endsWith(suffix)).reduce((sum, row) => sum + (num(row.total) ?? 0), 0);
+  };
+  return {
+    total: num(body.total),
+    byStatus: Array.isArray(body.byStatus) ? byStatus : null,
+    slaWarnings: slaCount("sla_warning"),
+    slaBreaches: slaCount("sla_breached"),
+    satisfaction: list(body.satisfaction).map((row) => ({
+      metric: String(row.metric ?? ""),
+      responses: num(row.responses) ?? 0,
+      average: num(row.average)
+    }))
+  };
+}
+function queryString(params) {
+  const query = new URLSearchParams();
+  for (const [key, value] of Object.entries(params))
+    if (value !== void 0 && value !== "") query.set(key, String(value));
+  const text = query.toString();
+  return text ? `?${text}` : "";
+}
+const adminSupportAnalyticsApi = {
+  async get(params = {}) {
+    const raw = await apiFetch(
+      `/platform-admin/v1/support/analytics${queryString({ ...params })}`
+    );
+    return parseSupportAnalytics(raw);
+  },
+  /**
+   * Every case opened since `startDate` (the API filters on `created_at`),
+   * read page by page up to `maxPages` of 100. `total` is the API's own
+   * count, so it stays exact even when the rows stop at the cap.
+   */
+  async casesSince(startDate, maxPages = 5) {
+    const rows = [];
+    let total = 0;
+    for (let page = 1; page <= maxPages; page += 1) {
+      const result = await apiFetch(
+        `/platform-admin/v1/support/cases${queryString({ startDate, page, pageSize: 100 })}`
+      );
+      rows.push(...result.rows);
+      total = result.total;
+      if (rows.length >= total || result.rows.length < 100) break;
+    }
+    return { rows, total };
+  }
+};
+export {
+  adminSupportAnalyticsApi,
+  parseSupportAnalytics
+};
+//# sourceMappingURL=admin-support-analytics-api.js.map

package/dist/admin-support-analytics-api.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-support-analytics-api.ts"],"sourcesContent":["import { apiFetch } from './api';\nimport type {\n  PlatformServiceCase,\n  ServiceCaseStatus,\n  SupportCaseQuery,\n} from './admin-service-operations-api';\n\n/**\n * `GET /platform-admin/v1/support/analytics`: the queue counted by status,\n * plus SLA events and satisfaction scores, for the same filters as the case\n * list. The response is read defensively: any field the API leaves out comes\n * back `null` so the page can fall back to counting cases itself.\n */\nexport interface SupportAnalytics {\n  total: number | null;\n  /** Null when the API sent no breakdown; a status it left out is zero. */\n  byStatus: Partial<Record<ServiceCaseStatus, number>> | null;\n  slaWarnings: number | null;\n  slaBreaches: number | null;\n  satisfaction: Array<{\n    metric: string;\n    responses: number;\n    average: number | null;\n  }>;\n}\n\nconst num = (value: unknown): number | null => {\n  const n = typeof value === 'string' ? Number(value) : value;\n  return typeof n === 'number' && Number.isFinite(n) ? n : null;\n};\n\nconst list = (value: unknown): Record<string, unknown>[] =>\n  Array.isArray(value)\n    ? value.filter(\n        (row): row is Record<string, unknown> =>\n          typeof row === 'object' && row !== null,\n      )\n    : [];\n\n/** Turn whatever the API sent into the shape above, never throwing. */\nexport function parseSupportAnalytics(raw: unknown): SupportAnalytics {\n  const body =\n    typeof raw === 'object' && raw !== null\n      ? (raw as Record<string, unknown>)\n      : {};\n  const byStatus: Partial<Record<ServiceCaseStatus, number>> = {};\n\n  for (const row of list(body.byStatus)) {\n    const total = num(row.total ?? row.count);\n    if (typeof row.status === 'string' && total !== null)\n      byStatus[row.status as ServiceCaseStatus] = total;\n  }\n\n  const sla = list(body.sla);\n  const slaCount = (suffix: string) => {\n    if (!Array.isArray(body.sla)) return null;\n    return sla\n      .filter((row) => String(row.name ?? '').endsWith(suffix))\n      .reduce((sum, row) => sum + (num(row.total) ?? 0), 0);\n  };\n\n  return {\n    total: num(body.total),\n    byStatus: Array.isArray(body.byStatus) ? byStatus : null,\n    slaWarnings: slaCount('sla_warning'),\n    slaBreaches: slaCount('sla_breached'),\n    satisfaction: list(body.satisfaction).map((row) => ({\n      metric: String(row.metric ?? ''),\n      responses: num(row.responses) ?? 0,\n      average: num(row.average),\n    })),\n  };\n}\n\nfunction queryString(params: Record<string, string | number | undefined>) {\n  const query = new URLSearchParams();\n  for (const [key, value] of Object.entries(params))\n    if (value !== undefined && value !== '') query.set(key, String(value));\n  const text = query.toString();\n  return text ? `?${text}` : '';\n}\n\nexport const adminSupportAnalyticsApi = {\n  async get(\n    params: SupportCaseQuery & { startDate?: string; endDate?: string } = {},\n  ) {\n    const raw = await apiFetch<unknown>(\n      `/platform-admin/v1/support/analytics${queryString({ ...params })}`,\n    );\n    return parseSupportAnalytics(raw);\n  },\n\n  /**\n   * Every case opened since `startDate` (the API filters on `created_at`),\n   * read page by page up to `maxPages` of 100. `total` is the API's own\n   * count, so it stays exact even when the rows stop at the cap.\n   */\n  async casesSince(startDate: string, maxPages = 5) {\n    const rows: PlatformServiceCase[] = [];\n    let total = 0;\n    for (let page = 1; page <= maxPages; page += 1) {\n      const result = await apiFetch<{\n        rows: PlatformServiceCase[];\n        total: number;\n      }>(\n        `/platform-admin/v1/support/cases${queryString({ startDate, page, pageSize: 100 })}`,\n      );\n      rows.push(...result.rows);\n      total = result.total;\n      if (rows.length >= total || result.rows.length < 100) break;\n    }\n    return { rows, total };\n  },\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AA0BzB,MAAM,MAAM,CAAC,UAAkC;AAC7C,QAAM,IAAI,OAAO,UAAU,WAAW,OAAO,KAAK,IAAI;AACtD,SAAO,OAAO,MAAM,YAAY,OAAO,SAAS,CAAC,IAAI,IAAI;AAC3D;AAEA,MAAM,OAAO,CAAC,UACZ,MAAM,QAAQ,KAAK,IACf,MAAM;AAAA,EACJ,CAAC,QACC,OAAO,QAAQ,YAAY,QAAQ;AACvC,IACA,CAAC;AAGA,SAAS,sBAAsB,KAAgC;AACpE,QAAM,OACJ,OAAO,QAAQ,YAAY,QAAQ,OAC9B,MACD,CAAC;AACP,QAAM,WAAuD,CAAC;AAE9D,aAAW,OAAO,KAAK,KAAK,QAAQ,GAAG;AACrC,UAAM,QAAQ,IAAI,IAAI,SAAS,IAAI,KAAK;AACxC,QAAI,OAAO,IAAI,WAAW,YAAY,UAAU;AAC9C,eAAS,IAAI,MAA2B,IAAI;AAAA,EAChD;AAEA,QAAM,MAAM,KAAK,KAAK,GAAG;AACzB,QAAM,WAAW,CAAC,WAAmB;AACnC,QAAI,CAAC,MAAM,QAAQ,KAAK,GAAG,EAAG,QAAO;AACrC,WAAO,IACJ,OAAO,CAAC,QAAQ,OAAO,IAAI,QAAQ,EAAE,EAAE,SAAS,MAAM,CAAC,EACvD,OAAO,CAAC,KAAK,QAAQ,OAAO,IAAI,IAAI,KAAK,KAAK,IAAI,CAAC;AAAA,EACxD;AAEA,SAAO;AAAA,IACL,OAAO,IAAI,KAAK,KAAK;AAAA,IACrB,UAAU,MAAM,QAAQ,KAAK,QAAQ,IAAI,WAAW;AAAA,IACpD,aAAa,SAAS,aAAa;AAAA,IACnC,aAAa,SAAS,cAAc;AAAA,IACpC,cAAc,KAAK,KAAK,YAAY,EAAE,IAAI,CAAC,SAAS;AAAA,MAClD,QAAQ,OAAO,IAAI,UAAU,EAAE;AAAA,MAC/B,WAAW,IAAI,IAAI,SAAS,KAAK;AAAA,MACjC,SAAS,IAAI,IAAI,OAAO;AAAA,IAC1B,EAAE;AAAA,EACJ;AACF;AAEA,SAAS,YAAY,QAAqD;AACxE,QAAM,QAAQ,IAAI,gBAAgB;AAClC,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM;AAC9C,QAAI,UAAU,UAAa,UAAU,GAAI,OAAM,IAAI,KAAK,OAAO,KAAK,CAAC;AACvE,QAAM,OAAO,MAAM,SAAS;AAC5B,SAAO,OAAO,IAAI,IAAI,KAAK;AAC7B;AAEO,MAAM,2BAA2B;AAAA,EACtC,MAAM,IACJ,SAAsE,CAAC,GACvE;AACA,UAAM,MAAM,MAAM;AAAA,MAChB,uCAAuC,YAAY,EAAE,GAAG,OAAO,CAAC,CAAC;AAAA,IACnE;AACA,WAAO,sBAAsB,GAAG;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,WAAW,WAAmB,WAAW,GAAG;AAChD,UAAM,OAA8B,CAAC;AACrC,QAAI,QAAQ;AACZ,aAAS,OAAO,GAAG,QAAQ,UAAU,QAAQ,GAAG;AAC9C,YAAM,SAAS,MAAM;AAAA,QAInB,mCAAmC,YAAY,EAAE,WAAW,MAAM,UAAU,IAAI,CAAC,CAAC;AAAA,MACpF;AACA,WAAK,KAAK,GAAG,OAAO,IAAI;AACxB,cAAQ,OAAO;AACf,UAAI,KAAK,UAAU,SAAS,OAAO,KAAK,SAAS,IAAK;AAAA,IACxD;AACA,WAAO,EAAE,MAAM,MAAM;AAAA,EACvB;AACF;","names":[]}

package/dist/admin-tenant-setup-types.d.ts

@@ -0,0 +1,85 @@
+/** Setup, connections and money for one workspace, from the admin API. */
+export interface TenantSetup {
+    onboarding?: {
+        percent: number;
+        completedAt: string | null;
+        dismissed: boolean;
+        steps: Array<{
+            key: string;
+            label: string;
+            status: string;
+        }>;
+    } | null;
+    domains?: Array<{
+        domain: string;
+        status: string;
+        isPrimary: boolean;
+        provider: string;
+        dnsConfigured: boolean;
+        sslConfigured: boolean;
+        healthStatus: string | null;
+        expiresAt: string | null;
+    }>;
+    integrations?: Array<{
+        kind: 'social' | 'sales_channel' | 'calendar' | 'odoo';
+        provider: string;
+        name: string | null;
+        status: string;
+        problem: string | null;
+        lastSyncedAt: string | null;
+    }>;
+    wallet?: {
+        status: string;
+        balances: Array<{
+            currency: string;
+            availableMinor: string;
+            pendingMinor: string;
+            restrictedMinor: string;
+            payoutPendingMinor: string;
+        }>;
+    } | null;
+    invites?: TenantInvite[];
+    activity?: TenantActivityEntry[];
+    profile?: TenantProfile | null;
+}
+/** Public business details from the workspace's settings. */
+export interface TenantProfile {
+    country: string | null;
+    currency: string | null;
+    timezone: string | null;
+    language: string | null;
+    businessType: string | null;
+    industry: string | null;
+    tagline: string | null;
+    logoUrl: string | null;
+    address: string | null;
+    socials: Array<{
+        network: string;
+        url: string;
+    }>;
+    storefrontPublished: boolean;
+    customDomain: string | null;
+    templateId: string | null;
+    referralCode: string | null;
+}
+export interface TenantInvite {
+    scope: 'workspace' | 'organization';
+    email: string;
+    role: string;
+    invitedBy: string | null;
+    invitedAt: string;
+    expiresAt: string | null;
+    expired: boolean;
+}
+export interface TenantActivityEntry {
+    id: string;
+    at: string;
+    /** null means the system (a webhook or scheduled job). */
+    actor: string | null;
+    actorAccountId?: string | null;
+    /** Done by the workspace owner rather than a team member or the system. */
+    byOwner?: boolean;
+    action: string;
+    summary: string;
+    target: string | null;
+}

package/dist/admin-tenant-setup-types.js

@@ -0,0 +1 @@
+//# sourceMappingURL=admin-tenant-setup-types.js.map

package/dist/admin-tenant-setup-types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/admin-tenants-query.d.ts

@@ -0,0 +1,14 @@
+import type { TenantStatus } from './admin-api';
+/** Narrowing for the merchants list. */
+export interface TenantListParams {
+    page?: number;
+    pageSize?: number;
+    search?: string;
+    status?: TenantStatus;
+    /** A country name or ISO code. */
+    country?: string;
+    /** An admin id, or "me" for the signed-in admin. */
+    accountOfficerId?: string;
+}
+/** The merchants list's query string, `?`-prefixed, or '' when there is none. */
+export declare function tenantsQuery(params?: TenantListParams): string;

package/dist/admin-tenants-query.js

@@ -0,0 +1,17 @@
+function tenantsQuery(params = {}) {
+  const qs = new URLSearchParams();
+  if (params.page) qs.set("page", String(params.page));
+  if (params.pageSize) qs.set("pageSize", String(params.pageSize));
+  if (params.search) qs.set("search", params.search);
+  if (params.status) qs.set("status", params.status);
+  if (params.country) qs.set("country", params.country);
+  if (params.accountOfficerId) {
+    qs.set("accountOfficerId", params.accountOfficerId);
+  }
+  const query = qs.toString();
+  return query ? `?${query}` : "";
+}
+export {
+  tenantsQuery
+};
+//# sourceMappingURL=admin-tenants-query.js.map

package/dist/admin-tenants-query.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-tenants-query.ts"],"sourcesContent":["import type { TenantStatus } from './admin-api';\n\n/** Narrowing for the merchants list. */\nexport interface TenantListParams {\n  page?: number;\n  pageSize?: number;\n  search?: string;\n  status?: TenantStatus;\n  /** A country name or ISO code. */\n  country?: string;\n  /** An admin id, or \"me\" for the signed-in admin. */\n  accountOfficerId?: string;\n}\n\n/** The merchants list's query string, `?`-prefixed, or '' when there is none. */\nexport function tenantsQuery(params: TenantListParams = {}): string {\n  const qs = new URLSearchParams();\n\n  if (params.page) qs.set('page', String(params.page));\n  if (params.pageSize) qs.set('pageSize', String(params.pageSize));\n  if (params.search) qs.set('search', params.search);\n  if (params.status) qs.set('status', params.status);\n  if (params.country) qs.set('country', params.country);\n  if (params.accountOfficerId) {\n    qs.set('accountOfficerId', params.accountOfficerId);\n  }\n\n  const query = qs.toString();\n\n  return query ? `?${query}` : '';\n}\n"],"mappings":"AAeO,SAAS,aAAa,SAA2B,CAAC,GAAW;AAClE,QAAM,KAAK,IAAI,gBAAgB;AAE/B,MAAI,OAAO,KAAM,IAAG,IAAI,QAAQ,OAAO,OAAO,IAAI,CAAC;AACnD,MAAI,OAAO,SAAU,IAAG,IAAI,YAAY,OAAO,OAAO,QAAQ,CAAC;AAC/D,MAAI,OAAO,OAAQ,IAAG,IAAI,UAAU,OAAO,MAAM;AACjD,MAAI,OAAO,OAAQ,IAAG,IAAI,UAAU,OAAO,MAAM;AACjD,MAAI,OAAO,QAAS,IAAG,IAAI,WAAW,OAAO,OAAO;AACpD,MAAI,OAAO,kBAAkB;AAC3B,OAAG,IAAI,oBAAoB,OAAO,gBAAgB;AAAA,EACpD;AAEA,QAAM,QAAQ,GAAG,SAAS;AAE1B,SAAO,QAAQ,IAAI,KAAK,KAAK;AAC/B;","names":[]}

package/dist/analytics/PostHogProvider.d.ts

@@ -0,0 +1,25 @@
+interface PostHogProviderProps {
+    userId: string;
+    email: string;
+    name: string;
+    workspaceId?: string;
+    workspaceName?: string;
+    workspaceSlug?: string;
+}
+/**
+ * Headless component that syncs PostHog identity with the current auth state.
+ *
+ * - Identifies the merchant user on mount / auth change
+ * - Sets workspace as a PostHog group for workspace-level analytics
+ * - Registers workspace slug as a super property (attached to every event)
+ */
+export declare function PostHogProvider({ userId, email, name, workspaceId, workspaceName, workspaceSlug, }: PostHogProviderProps): null;
+/**
+ * Reset PostHog identity on logout so subsequent events are anonymous.
+ */
+export declare function resetPostHogIdentity(): void;
+/**
+ * Capture a PostHog event imperatively (e.g. from a use case or action).
+ */
+export declare function capturePostHogEvent(event: string, properties?: Record<string, unknown>): void;
+export {};

package/dist/analytics/PostHogProvider.js

@@ -0,0 +1,44 @@
+"use client";
+import { useEffect, useRef } from "react";
+import posthog from "posthog-js";
+const POSTHOG_KEY = process.env.NEXT_PUBLIC_POSTHOG_KEY;
+function PostHogProvider({
+  userId,
+  email,
+  name,
+  workspaceId,
+  workspaceName,
+  workspaceSlug
+}) {
+  const prevUserIdRef = useRef(null);
+  useEffect(() => {
+    if (!POSTHOG_KEY) return;
+    if (prevUserIdRef.current !== userId) {
+      posthog.identify(userId, { email, name });
+      prevUserIdRef.current = userId;
+    }
+  }, [userId, email, name]);
+  useEffect(() => {
+    if (!POSTHOG_KEY || !workspaceId) return;
+    posthog.group("workspace", workspaceId, {
+      name: workspaceName,
+      slug: workspaceSlug
+    });
+    posthog.register({ workspace_slug: workspaceSlug });
+  }, [workspaceId, workspaceName, workspaceSlug]);
+  return null;
+}
+function resetPostHogIdentity() {
+  if (!POSTHOG_KEY) return;
+  posthog.reset();
+}
+function capturePostHogEvent(event, properties) {
+  if (!POSTHOG_KEY) return;
+  posthog.capture(event, properties);
+}
+export {
+  PostHogProvider,
+  capturePostHogEvent,
+  resetPostHogIdentity
+};
+//# sourceMappingURL=PostHogProvider.js.map

package/dist/analytics/PostHogProvider.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/analytics/PostHogProvider.tsx"],"sourcesContent":["'use client';\n\nimport { useEffect, useRef } from 'react';\nimport posthog from 'posthog-js';\n\nconst POSTHOG_KEY = process.env.NEXT_PUBLIC_POSTHOG_KEY;\n\ninterface PostHogProviderProps {\n  userId: string;\n  email: string;\n  name: string;\n  workspaceId?: string;\n  workspaceName?: string;\n  workspaceSlug?: string;\n}\n\n/**\n * Headless component that syncs PostHog identity with the current auth state.\n *\n * - Identifies the merchant user on mount / auth change\n * - Sets workspace as a PostHog group for workspace-level analytics\n * - Registers workspace slug as a super property (attached to every event)\n */\nexport function PostHogProvider({\n  userId,\n  email,\n  name,\n  workspaceId,\n  workspaceName,\n  workspaceSlug,\n}: PostHogProviderProps) {\n  const prevUserIdRef = useRef<string | null>(null);\n\n  useEffect(() => {\n    if (!POSTHOG_KEY) return;\n\n    // Only re-identify when the user actually changes\n    if (prevUserIdRef.current !== userId) {\n      posthog.identify(userId, { email, name });\n      prevUserIdRef.current = userId;\n    }\n  }, [userId, email, name]);\n\n  useEffect(() => {\n    if (!POSTHOG_KEY || !workspaceId) return;\n    posthog.group('workspace', workspaceId, {\n      name: workspaceName,\n      slug: workspaceSlug,\n    });\n    posthog.register({ workspace_slug: workspaceSlug });\n  }, [workspaceId, workspaceName, workspaceSlug]);\n\n  return null;\n}\n\n/**\n * Reset PostHog identity on logout so subsequent events are anonymous.\n */\nexport function resetPostHogIdentity(): void {\n  if (!POSTHOG_KEY) return;\n  posthog.reset();\n}\n\n/**\n * Capture a PostHog event imperatively (e.g. from a use case or action).\n */\nexport function capturePostHogEvent(\n  event: string,\n  properties?: Record<string, unknown>,\n): void {\n  if (!POSTHOG_KEY) return;\n  posthog.capture(event, properties);\n}\n"],"mappings":";AAEA,SAAS,WAAW,cAAc;AAClC,OAAO,aAAa;AAEpB,MAAM,cAAc,QAAQ,IAAI;AAkBzB,SAAS,gBAAgB;AAAA,EAC9B;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACF,GAAyB;AACvB,QAAM,gBAAgB,OAAsB,IAAI;AAEhD,YAAU,MAAM;AACd,QAAI,CAAC,YAAa;AAGlB,QAAI,cAAc,YAAY,QAAQ;AACpC,cAAQ,SAAS,QAAQ,EAAE,OAAO,KAAK,CAAC;AACxC,oBAAc,UAAU;AAAA,IAC1B;AAAA,EACF,GAAG,CAAC,QAAQ,OAAO,IAAI,CAAC;AAExB,YAAU,MAAM;AACd,QAAI,CAAC,eAAe,CAAC,YAAa;AAClC,YAAQ,MAAM,aAAa,aAAa;AAAA,MACtC,MAAM;AAAA,MACN,MAAM;AAAA,IACR,CAAC;AACD,YAAQ,SAAS,EAAE,gBAAgB,cAAc,CAAC;AAAA,EACpD,GAAG,CAAC,aAAa,eAAe,aAAa,CAAC;AAE9C,SAAO;AACT;AAKO,SAAS,uBAA6B;AAC3C,MAAI,CAAC,YAAa;AAClB,UAAQ,MAAM;AAChB;AAKO,SAAS,oBACd,OACA,YACM;AACN,MAAI,CAAC,YAAa;AAClB,UAAQ,QAAQ,OAAO,UAAU;AACnC;","names":[]}

package/dist/analytics/index.d.ts

@@ -0,0 +1 @@
+export { PostHogProvider, resetPostHogIdentity, capturePostHogEvent, } from './PostHogProvider';

package/dist/analytics/index.js

@@ -0,0 +1,11 @@
+import {
+  PostHogProvider,
+  resetPostHogIdentity,
+  capturePostHogEvent
+} from "./PostHogProvider";
+export {
+  PostHogProvider,
+  capturePostHogEvent,
+  resetPostHogIdentity
+};
+//# sourceMappingURL=index.js.map

package/dist/analytics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/analytics/index.ts"],"sourcesContent":["export {\n  PostHogProvider,\n  resetPostHogIdentity,\n  capturePostHogEvent,\n} from './PostHogProvider';\n"],"mappings":"AAAA;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}

package/dist/analytics.d.ts

@@ -0,0 +1 @@
+export * from './analytics/index';

package/dist/analytics.js

@@ -0,0 +1 @@
+export * from './analytics/index.js';