@withpotter/lib 0.13.0-next.101

package/dist/admin-feedback-api.js

@@ -0,0 +1,63 @@
+import { apiFetch } from "./api";
+const adminFeedbackApi = {
+  list(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.category) qs.set("category", params.category);
+    if (params.status) qs.set("status", params.status);
+    if (params.rating) qs.set("rating", String(params.rating));
+    const query = qs.toString();
+    return apiFetch(
+      `/platform-admin/v1/feedback${query ? `?${query}` : ""}`
+    );
+  }
+};
+const adminSignalsApi = {
+  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"
+  )
+};
+const adminFeedbackPromptsApi = {
+  list(params = {}) {
+    const query = new URLSearchParams();
+    if (params.page) query.set("page", String(params.page));
+    if (params.pageSize) query.set("pageSize", String(params.pageSize));
+    if (params.search) query.set("search", params.search);
+    if (params.mode) query.set("mode", params.mode);
+    if (params.status) query.set("status", params.status);
+    const suffix = query.toString();
+    return apiFetch(
+      `/platform-admin/v1/feedback/prompts${suffix ? `?${suffix}` : ""}`
+    );
+  },
+  get: (id) => apiFetch(`/platform-admin/v1/feedback/prompts/${id}`),
+  create: (input) => apiFetch("/platform-admin/v1/feedback/prompts", {
+    method: "POST",
+    body: JSON.stringify(input)
+  }),
+  update: (id, input) => apiFetch(`/platform-admin/v1/feedback/prompts/${id}`, {
+    method: "PATCH",
+    body: JSON.stringify(input)
+  }),
+  command: (id, command) => apiFetch(
+    `/platform-admin/v1/feedback/prompts/${id}/${command}`,
+    { method: "POST" }
+  ),
+  insights: (id, days = 90) => apiFetch(
+    `/platform-admin/v1/feedback/prompts/${id}/insights?days=${days}`
+  )
+};
+export {
+  adminFeedbackApi,
+  adminFeedbackPromptsApi,
+  adminSignalsApi
+};
+//# sourceMappingURL=admin-feedback-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-feedback-api.ts"],"sourcesContent":["import { apiFetch } from './api';\nimport type {\n  CountryFields,\n  FeedbackSignalBusiness,\n} from './admin-country-api';\n\nexport type AdminFeedbackCategory = 'bug' | 'suggestion' | 'question';\nexport type AdminFeedbackStatus =\n  'open' | 'acknowledged' | 'resolved' | 'closed';\n\nexport interface AdminFeedbackBrowserInfo {\n  userAgent?: string;\n  language?: string;\n  platform?: string;\n  screenWidth?: number;\n  screenHeight?: number;\n  viewportWidth?: number;\n  viewportHeight?: number;\n}\n\nexport interface AdminFeedbackRow {\n  id: string;\n  account: { id: string; name: string | null; email: string };\n  tenant: (CountryFields & { id: string; name: string; slug: string }) | null;\n  rating: number | null;\n  note: string | null;\n  flowContext: string | null;\n  area: string | null;\n  route: string | null;\n  pagePath: string;\n  pageUrl: string;\n  browserInfo: AdminFeedbackBrowserInfo;\n  screenshotUrl: string | null;\n  audioUrl: string | null;\n  audioSeconds: number | null;\n  posthogSessionUrl: string | null;\n  githubIssueUrl: string | null;\n  category: AdminFeedbackCategory;\n  status: AdminFeedbackStatus;\n  createdAt: string;\n  updatedAt: string | null;\n}\n\nexport interface AdminFeedbackPage {\n  items: AdminFeedbackRow[];\n  total: number;\n  page: number;\n  pageSize: number;\n  totalPages: number;\n}\n\nexport interface AdminFeedbackQuery {\n  page?: number;\n  pageSize?: number;\n  search?: string;\n  category?: AdminFeedbackCategory;\n  status?: AdminFeedbackStatus;\n  rating?: number;\n}\n\nexport const adminFeedbackApi = {\n  list(params: AdminFeedbackQuery = {}) {\n    const qs = new URLSearchParams();\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.category) qs.set('category', params.category);\n    if (params.status) qs.set('status', params.status);\n    if (params.rating) qs.set('rating', String(params.rating));\n    const query = qs.toString();\n    return apiFetch<AdminFeedbackPage>(\n      `/platform-admin/v1/feedback${query ? `?${query}` : ''}`,\n    );\n  },\n};\n\n/**\n * THE SCORES, WHICH ARE NOT THE TICKETS.\n *\n * `adminFeedbackApi.list` above reads what merchants FILED — a message, a page\n * path, a status. This reads what they SCORED: NPS, CSAT, CES, thumbs, stars.\n * Two questions, two tables, one desk, which is why they sit in one file and\n * not one function.\n *\n * `promptKey` is the column that makes any of it worth having. Unkeyed, the\n * data answers \"are merchants happy\" and nothing else; keyed, it answers\n * \"which screen is the unhappy one\".\n */\nexport type FeedbackSignalKind = 'nps' | 'csat' | 'ces' | 'thumb' | 'star';\n\nexport interface FeedbackSignalSummaryRow {\n  promptKey: string;\n  kind: FeedbackSignalKind;\n  responses: number;\n  average: number;\n  /** Promoters minus detractors, NPS only. Null for every other kind. */\n  nps: number | null;\n  commented: number;\n}\n\nexport interface FeedbackSignalComment {\n  id: string;\n  business: FeedbackSignalBusiness | null;\n  serviceCaseId: string | null;\n  promptKey: string;\n  kind: FeedbackSignalKind;\n  score: number;\n  /** Null when the answer was spoken rather than typed. */\n  comment: string | null;\n  audioUrl: string | null;\n  audioSeconds: number | null;\n  createdAt: string;\n  context: Record<string, unknown>;\n}\n\n/**\n * Shown versus answered, which is how a prompt says it is in the wrong place.\n * A prompt seen four hundred times and answered nine is not unpopular; it is\n * interrupting something.\n */\nexport interface FeedbackPromptHealth {\n  promptKey: string;\n  people: number;\n  shown: number;\n  answered: number;\n  dismissed: number;\n  waiting: number;\n}\n\nexport const adminSignalsApi = {\n  summary: (days = 90) =>\n    apiFetch<FeedbackSignalSummaryRow[]>(\n      `/platform-admin/v1/feedback/summary?days=${days}`,\n    ),\n\n  comments: (days = 90, promptKey?: string) =>\n    apiFetch<FeedbackSignalComment[]>(\n      `/platform-admin/v1/feedback/comments?days=${days}` +\n        (promptKey ? `&promptKey=${encodeURIComponent(promptKey)}` : ''),\n    ),\n\n  promptHealth: () =>\n    apiFetch<FeedbackPromptHealth[]>(\n      '/platform-admin/v1/feedback/prompt-health',\n    ),\n};\n\nexport type FeedbackPromptMode = 'campaign' | 'direct';\nexport type FeedbackPromptPlacement = 'next_sign_in' | 'page';\nexport type FeedbackPromptAudience =\n  | { type: 'all' }\n  | { type: 'workspaces'; tenantIds: string[] }\n  | { type: 'accounts'; accountIds: string[] }\n  | {\n      type: 'segment';\n      industries?: string[];\n      plans?: string[];\n      tenantStatuses?: string[];\n    };\nexport type FeedbackPromptStatus =\n  'draft' | 'scheduled' | 'active' | 'paused' | 'completed';\n\nexport interface AdminFeedbackPrompt {\n  id: string;\n  key: string;\n  name: string;\n  question: string;\n  followUp: string | null;\n  kind: FeedbackSignalKind;\n  scaleMin: number;\n  scaleMax: number;\n  allowComment: boolean;\n  allowVoice: boolean;\n  mode: FeedbackPromptMode;\n  status: FeedbackPromptStatus;\n  audience: FeedbackPromptAudience;\n  placement: FeedbackPromptPlacement;\n  routePattern: string | null;\n  startsAt: string | null;\n  endsAt: string | null;\n  snoozeDays: number;\n  publishedAt: string | null;\n  completedAt: string | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface AdminFeedbackPromptInput {\n  key: string;\n  name: string;\n  question: string;\n  followUp?: string | null;\n  kind: FeedbackSignalKind;\n  scaleMin: number;\n  scaleMax: number;\n  allowComment: boolean;\n  allowVoice: boolean;\n  mode: FeedbackPromptMode;\n  audience: FeedbackPromptAudience;\n  placement: FeedbackPromptPlacement;\n  routePattern?: string | null;\n  startsAt?: string | null;\n  endsAt?: string | null;\n  snoozeDays: number;\n}\n\nexport interface AdminFeedbackPromptPage {\n  items: AdminFeedbackPrompt[];\n  total: number;\n  page: number;\n  pageSize: number;\n}\n\nexport interface AdminFeedbackPromptQuery {\n  page?: number;\n  pageSize?: number;\n  search?: string;\n  mode?: FeedbackPromptMode;\n  status?: FeedbackPromptStatus;\n}\n\nexport interface AdminFeedbackPromptInsights {\n  promptId: string;\n  promptKey: string;\n  audienceSize: number;\n  reached: number;\n  shown: number;\n  answered: number;\n  dismissed: number;\n  waiting: number;\n  responseRate: number | null;\n  dismissalRate: number | null;\n  average: number | null;\n  nps: number | null;\n  withContext: number;\n  trend: Array<{ date: string; answered: number; average: number | null }>;\n}\n\nexport type FeedbackPromptCommand = 'publish' | 'pause' | 'complete';\n\nexport const adminFeedbackPromptsApi = {\n  list(params: AdminFeedbackPromptQuery = {}) {\n    const query = new URLSearchParams();\n    if (params.page) query.set('page', String(params.page));\n    if (params.pageSize) query.set('pageSize', String(params.pageSize));\n    if (params.search) query.set('search', params.search);\n    if (params.mode) query.set('mode', params.mode);\n    if (params.status) query.set('status', params.status);\n    const suffix = query.toString();\n    return apiFetch<AdminFeedbackPromptPage>(\n      `/platform-admin/v1/feedback/prompts${suffix ? `?${suffix}` : ''}`,\n    );\n  },\n  get: (id: string) =>\n    apiFetch<AdminFeedbackPrompt>(`/platform-admin/v1/feedback/prompts/${id}`),\n  create: (input: AdminFeedbackPromptInput) =>\n    apiFetch<AdminFeedbackPrompt>('/platform-admin/v1/feedback/prompts', {\n      method: 'POST',\n      body: JSON.stringify(input),\n    }),\n  update: (id: string, input: Partial<AdminFeedbackPromptInput>) =>\n    apiFetch<AdminFeedbackPrompt>(`/platform-admin/v1/feedback/prompts/${id}`, {\n      method: 'PATCH',\n      body: JSON.stringify(input),\n    }),\n  command: (id: string, command: FeedbackPromptCommand) =>\n    apiFetch<AdminFeedbackPrompt>(\n      `/platform-admin/v1/feedback/prompts/${id}/${command}`,\n      { method: 'POST' },\n    ),\n  insights: (id: string, days = 90) =>\n    apiFetch<AdminFeedbackPromptInsights>(\n      `/platform-admin/v1/feedback/prompts/${id}/insights?days=${days}`,\n    ),\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AA4DlB,MAAM,mBAAmB;AAAA,EAC9B,KAAK,SAA6B,CAAC,GAAG;AACpC,UAAM,KAAK,IAAI,gBAAgB;AAC/B,QAAI,OAAO,KAAM,IAAG,IAAI,QAAQ,OAAO,OAAO,IAAI,CAAC;AACnD,QAAI,OAAO,SAAU,IAAG,IAAI,YAAY,OAAO,OAAO,QAAQ,CAAC;AAC/D,QAAI,OAAO,OAAQ,IAAG,IAAI,UAAU,OAAO,MAAM;AACjD,QAAI,OAAO,SAAU,IAAG,IAAI,YAAY,OAAO,QAAQ;AACvD,QAAI,OAAO,OAAQ,IAAG,IAAI,UAAU,OAAO,MAAM;AACjD,QAAI,OAAO,OAAQ,IAAG,IAAI,UAAU,OAAO,OAAO,MAAM,CAAC;AACzD,UAAM,QAAQ,GAAG,SAAS;AAC1B,WAAO;AAAA,MACL,8BAA8B,QAAQ,IAAI,KAAK,KAAK,EAAE;AAAA,IACxD;AAAA,EACF;AACF;AAuDO,MAAM,kBAAkB;AAAA,EAC7B,SAAS,CAAC,OAAO,OACf;AAAA,IACE,4CAA4C,IAAI;AAAA,EAClD;AAAA,EAEF,UAAU,CAAC,OAAO,IAAI,cACpB;AAAA,IACE,6CAA6C,IAAI,MAC9C,YAAY,cAAc,mBAAmB,SAAS,CAAC,KAAK;AAAA,EACjE;AAAA,EAEF,cAAc,MACZ;AAAA,IACE;AAAA,EACF;AACJ;AA+FO,MAAM,0BAA0B;AAAA,EACrC,KAAK,SAAmC,CAAC,GAAG;AAC1C,UAAM,QAAQ,IAAI,gBAAgB;AAClC,QAAI,OAAO,KAAM,OAAM,IAAI,QAAQ,OAAO,OAAO,IAAI,CAAC;AACtD,QAAI,OAAO,SAAU,OAAM,IAAI,YAAY,OAAO,OAAO,QAAQ,CAAC;AAClE,QAAI,OAAO,OAAQ,OAAM,IAAI,UAAU,OAAO,MAAM;AACpD,QAAI,OAAO,KAAM,OAAM,IAAI,QAAQ,OAAO,IAAI;AAC9C,QAAI,OAAO,OAAQ,OAAM,IAAI,UAAU,OAAO,MAAM;AACpD,UAAM,SAAS,MAAM,SAAS;AAC9B,WAAO;AAAA,MACL,sCAAsC,SAAS,IAAI,MAAM,KAAK,EAAE;AAAA,IAClE;AAAA,EACF;AAAA,EACA,KAAK,CAAC,OACJ,SAA8B,uCAAuC,EAAE,EAAE;AAAA,EAC3E,QAAQ,CAAC,UACP,SAA8B,uCAAuC;AAAA,IACnE,QAAQ;AAAA,IACR,MAAM,KAAK,UAAU,KAAK;AAAA,EAC5B,CAAC;AAAA,EACH,QAAQ,CAAC,IAAY,UACnB,SAA8B,uCAAuC,EAAE,IAAI;AAAA,IACzE,QAAQ;AAAA,IACR,MAAM,KAAK,UAAU,KAAK;AAAA,EAC5B,CAAC;AAAA,EACH,SAAS,CAAC,IAAY,YACpB;AAAA,IACE,uCAAuC,EAAE,IAAI,OAAO;AAAA,IACpD,EAAE,QAAQ,OAAO;AAAA,EACnB;AAAA,EACF,UAAU,CAAC,IAAY,OAAO,OAC5B;AAAA,IACE,uCAAuC,EAAE,kBAAkB,IAAI;AAAA,EACjE;AACJ;","names":[]}

package/dist/admin-inbox-seen.d.ts

@@ -0,0 +1,22 @@
+/**
+ * When this admin last looked at each inbox, kept in this browser.
+ *
+ * The badge counts what arrived after that moment, so opening Support or
+ * Product feedback clears it. A tiny external store lets the nav badge, the
+ * bell and the tab title all clear on the same render.
+ */
+export type InboxKind = 'support' | 'feedback';
+export type InboxSeen = Partial<Record<InboxKind, string>>;
+declare function read(): InboxSeen;
+export declare const inboxSeenStore: {
+    subscribe(listener: () => void): () => boolean;
+    snapshot: typeof read;
+    serverSnapshot: () => InboxSeen;
+    /** Everything up to `at` in this inbox has been seen. */
+    markSeen(kind: InboxKind, at: string): void;
+};
+/** Items stamped after the admin last looked; all of them if never. */
+export declare function countUnseen(stamps: string[], seenAt: string | undefined): number;
+/** The newest stamp, so marking seen never skips past unseen items. */
+export declare function newest(stamps: string[]): string | null;
+export {};

package/dist/admin-inbox-seen.js

@@ -0,0 +1,47 @@
+const KEY = "potter-admin-inbox-seen";
+const listeners = /* @__PURE__ */ new Set();
+let cache = null;
+function read() {
+  if (cache) return cache;
+  try {
+    cache = JSON.parse(localStorage.getItem(KEY) ?? "{}");
+  } catch {
+    cache = {};
+  }
+  return cache;
+}
+const inboxSeenStore = {
+  subscribe(listener) {
+    listeners.add(listener);
+    return () => listeners.delete(listener);
+  },
+  snapshot: read,
+  serverSnapshot: () => ({}),
+  /** Everything up to `at` in this inbox has been seen. */
+  markSeen(kind, at) {
+    const current = read();
+    if (current[kind] && current[kind] >= at) return;
+    cache = { ...current, [kind]: at };
+    try {
+      localStorage.setItem(KEY, JSON.stringify(cache));
+    } catch {
+    }
+    listeners.forEach((listener) => listener());
+  }
+};
+function countUnseen(stamps, seenAt) {
+  if (!seenAt) return stamps.length;
+  return stamps.filter((stamp) => stamp > seenAt).length;
+}
+function newest(stamps) {
+  return stamps.reduce(
+    (best, stamp) => !best || stamp > best ? stamp : best,
+    null
+  );
+}
+export {
+  countUnseen,
+  inboxSeenStore,
+  newest
+};
+//# sourceMappingURL=admin-inbox-seen.js.map

package/dist/admin-inbox-seen.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-inbox-seen.ts"],"sourcesContent":["/**\n * When this admin last looked at each inbox, kept in this browser.\n *\n * The badge counts what arrived after that moment, so opening Support or\n * Product feedback clears it. A tiny external store lets the nav badge, the\n * bell and the tab title all clear on the same render.\n */\n\nexport type InboxKind = 'support' | 'feedback';\n\nexport type InboxSeen = Partial<Record<InboxKind, string>>;\n\nconst KEY = 'potter-admin-inbox-seen';\n\nconst listeners = new Set<() => void>();\n\nlet cache: InboxSeen | null = null;\n\nfunction read(): InboxSeen {\n  if (cache) return cache;\n\n  try {\n    cache = JSON.parse(localStorage.getItem(KEY) ?? '{}') as InboxSeen;\n  } catch {\n    cache = {};\n  }\n\n  return cache;\n}\n\nexport const inboxSeenStore = {\n  subscribe(listener: () => void) {\n    listeners.add(listener);\n\n    return () => listeners.delete(listener);\n  },\n  snapshot: read,\n  serverSnapshot: (): InboxSeen => ({}),\n  /** Everything up to `at` in this inbox has been seen. */\n  markSeen(kind: InboxKind, at: string) {\n    const current = read();\n\n    if (current[kind] && current[kind]! >= at) return;\n\n    cache = { ...current, [kind]: at };\n\n    try {\n      localStorage.setItem(KEY, JSON.stringify(cache));\n    } catch {\n      // Not remembered across reloads; still clears for this session.\n    }\n\n    listeners.forEach((listener) => listener());\n  },\n};\n\n/** Items stamped after the admin last looked; all of them if never. */\nexport function countUnseen(stamps: string[], seenAt: string | undefined) {\n  if (!seenAt) return stamps.length;\n\n  return stamps.filter((stamp) => stamp > seenAt).length;\n}\n\n/** The newest stamp, so marking seen never skips past unseen items. */\nexport function newest(stamps: string[]) {\n  return stamps.reduce<string | null>(\n    (best, stamp) => (!best || stamp > best ? stamp : best),\n    null,\n  );\n}\n"],"mappings":"AAYA,MAAM,MAAM;AAEZ,MAAM,YAAY,oBAAI,IAAgB;AAEtC,IAAI,QAA0B;AAE9B,SAAS,OAAkB;AACzB,MAAI,MAAO,QAAO;AAElB,MAAI;AACF,YAAQ,KAAK,MAAM,aAAa,QAAQ,GAAG,KAAK,IAAI;AAAA,EACtD,QAAQ;AACN,YAAQ,CAAC;AAAA,EACX;AAEA,SAAO;AACT;AAEO,MAAM,iBAAiB;AAAA,EAC5B,UAAU,UAAsB;AAC9B,cAAU,IAAI,QAAQ;AAEtB,WAAO,MAAM,UAAU,OAAO,QAAQ;AAAA,EACxC;AAAA,EACA,UAAU;AAAA,EACV,gBAAgB,OAAkB,CAAC;AAAA;AAAA,EAEnC,SAAS,MAAiB,IAAY;AACpC,UAAM,UAAU,KAAK;AAErB,QAAI,QAAQ,IAAI,KAAK,QAAQ,IAAI,KAAM,GAAI;AAE3C,YAAQ,EAAE,GAAG,SAAS,CAAC,IAAI,GAAG,GAAG;AAEjC,QAAI;AACF,mBAAa,QAAQ,KAAK,KAAK,UAAU,KAAK,CAAC;AAAA,IACjD,QAAQ;AAAA,IAER;AAEA,cAAU,QAAQ,CAAC,aAAa,SAAS,CAAC;AAAA,EAC5C;AACF;AAGO,SAAS,YAAY,QAAkB,QAA4B;AACxE,MAAI,CAAC,OAAQ,QAAO,OAAO;AAE3B,SAAO,OAAO,OAAO,CAAC,UAAU,QAAQ,MAAM,EAAE;AAClD;AAGO,SAAS,OAAO,QAAkB;AACvC,SAAO,OAAO;AAAA,IACZ,CAAC,MAAM,UAAW,CAAC,QAAQ,QAAQ,OAAO,QAAQ;AAAA,IAClD;AAAA,EACF;AACF;","names":[]}

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

@@ -0,0 +1,85 @@
+/**
+ * One business's money ledger, read by an admin: the wallet's balances, its
+ * entries newest first, a statement for a window, and the holds on it. Same
+ * `apiFetch` and cookie session as the rest of the console; no envelope.
+ *
+ * Amounts are minor-unit strings, as everywhere in Money. `restrictions` and
+ * `statement/export` answer a bare 404 on a server whose switch for them is
+ * off; the screen reads that as "not available here", not as a failure.
+ */
+export type Compartment = 'pending' | 'available' | 'restricted' | 'payoutPending';
+export interface LedgerBalance {
+    currency: string;
+    pendingMinor: string;
+    availableMinor: string;
+    restrictedMinor: string;
+    payoutPendingMinor: string;
+}
+export interface LedgerWallet {
+    id: string;
+    status: string;
+    tag: string | null;
+    balances: LedgerBalance[];
+}
+export interface LedgerEntry {
+    entryId: string;
+    transactionId: string;
+    direction: 'CREDIT' | 'DEBIT';
+    amountMinor: string;
+    currency: string;
+    effectiveAt: string;
+    description: string | null;
+    postingRule: string | null;
+    paymentId: string | null;
+    paymentReference: string | null;
+}
+/** The pair that asks for the entries after the last one already shown. */
+export interface ActivityCursor {
+    beforeEffectiveAt: string;
+    beforeEntryId: string;
+}
+export interface StatementQuery {
+    currency: string;
+    compartment: Compartment;
+    /** `YYYY-MM-DD`, inclusive, UTC. */
+    from: string;
+    to: string;
+}
+export interface LedgerStatement {
+    compartment: Compartment;
+    currency: string;
+    normalSide: string;
+    effectiveFrom: string;
+    effectiveBefore: string;
+    asOfSequence: string;
+    rowCount: string;
+    totals: {
+        openingBalanceMinor: string;
+        debitTotalMinor: string;
+        creditTotalMinor: string;
+        entryCount: string;
+        closingBalanceMinor: string;
+    };
+    mediaType: string;
+    sha256: string;
+}
+export interface LedgerRestriction {
+    id: string;
+    currency: string;
+    restrictionType: string;
+    reasonCode: string;
+    amountMinor: string;
+    remainingMinor: string;
+    status: string;
+    effectiveAt: string;
+    expiresAt: string | null;
+}
+export declare const adminLedgerApi: {
+    wallet: (tenantId: string) => Promise<LedgerWallet>;
+    /** Newest first; `[]` when the business has no wallet. */
+    activity: (tenantId: string, limit: number, cursor?: ActivityCursor) => Promise<LedgerEntry[]>;
+    statement: (tenantId: string, s: StatementQuery) => Promise<LedgerStatement>;
+    /** The statement as CSV text. Over 10,000 rows is a 422. */
+    exportStatement: (tenantId: string, s: StatementQuery) => Promise<string>;
+    restrictions: (tenantId: string) => Promise<LedgerRestriction[]>;
+};

package/dist/admin-ledger-api.js

@@ -0,0 +1,30 @@
+import { apiFetch } from "./api";
+const base = (tenantId) => `/platform-admin/v1/money/tenants/${encodeURIComponent(tenantId)}/wallet`;
+const qs = (params) => {
+  const q = new URLSearchParams();
+  for (const [key, value] of Object.entries(params))
+    if (value !== void 0 && value !== "") q.set(key, String(value));
+  const text = q.toString();
+  return text ? `?${text}` : "";
+};
+const statementQs = (s) => qs({
+  currency: s.currency,
+  compartment: s.compartment,
+  from: s.from,
+  to: s.to
+});
+const adminLedgerApi = {
+  wallet: (tenantId) => apiFetch(base(tenantId)),
+  /** Newest first; `[]` when the business has no wallet. */
+  activity: (tenantId, limit, cursor) => apiFetch(
+    `${base(tenantId)}/activity${qs({ limit, ...cursor })}`
+  ),
+  statement: (tenantId, s) => apiFetch(`${base(tenantId)}/statement${statementQs(s)}`),
+  /** The statement as CSV text. Over 10,000 rows is a 422. */
+  exportStatement: (tenantId, s) => apiFetch(`${base(tenantId)}/statement/export${statementQs(s)}`),
+  restrictions: (tenantId) => apiFetch(`${base(tenantId)}/restrictions`)
+};
+export {
+  adminLedgerApi
+};
+//# sourceMappingURL=admin-ledger-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-ledger-api.ts"],"sourcesContent":["import { apiFetch } from './api';\n\n/**\n * One business's money ledger, read by an admin: the wallet's balances, its\n * entries newest first, a statement for a window, and the holds on it. Same\n * `apiFetch` and cookie session as the rest of the console; no envelope.\n *\n * Amounts are minor-unit strings, as everywhere in Money. `restrictions` and\n * `statement/export` answer a bare 404 on a server whose switch for them is\n * off; the screen reads that as \"not available here\", not as a failure.\n */\nexport type Compartment =\n  | 'pending'\n  | 'available'\n  | 'restricted'\n  | 'payoutPending';\n\nexport interface LedgerBalance {\n  currency: string;\n  pendingMinor: string;\n  availableMinor: string;\n  restrictedMinor: string;\n  payoutPendingMinor: string;\n}\n\nexport interface LedgerWallet {\n  id: string;\n  status: string;\n  tag: string | null;\n  balances: LedgerBalance[];\n}\n\nexport interface LedgerEntry {\n  entryId: string;\n  transactionId: string;\n  direction: 'CREDIT' | 'DEBIT';\n  amountMinor: string;\n  currency: string;\n  effectiveAt: string;\n  description: string | null;\n  postingRule: string | null;\n  paymentId: string | null;\n  paymentReference: string | null;\n}\n\n/** The pair that asks for the entries after the last one already shown. */\nexport interface ActivityCursor {\n  beforeEffectiveAt: string;\n  beforeEntryId: string;\n}\n\nexport interface StatementQuery {\n  currency: string;\n  compartment: Compartment;\n  /** `YYYY-MM-DD`, inclusive, UTC. */\n  from: string;\n  to: string;\n}\n\nexport interface LedgerStatement {\n  compartment: Compartment;\n  currency: string;\n  normalSide: string;\n  effectiveFrom: string;\n  effectiveBefore: string;\n  asOfSequence: string;\n  rowCount: string;\n  totals: {\n    openingBalanceMinor: string;\n    debitTotalMinor: string;\n    creditTotalMinor: string;\n    entryCount: string;\n    closingBalanceMinor: string;\n  };\n  mediaType: string;\n  sha256: string;\n}\n\nexport interface LedgerRestriction {\n  id: string;\n  currency: string;\n  restrictionType: string;\n  reasonCode: string;\n  amountMinor: string;\n  remainingMinor: string;\n  status: string;\n  effectiveAt: string;\n  expiresAt: string | null;\n}\n\nconst base = (tenantId: string) =>\n  `/platform-admin/v1/money/tenants/${encodeURIComponent(tenantId)}/wallet`;\n\nconst qs = (params: Record<string, string | number | undefined>) => {\n  const q = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params))\n    if (value !== undefined && value !== '') q.set(key, String(value));\n\n  const text = q.toString();\n\n  return text ? `?${text}` : '';\n};\n\nconst statementQs = (s: StatementQuery) =>\n  qs({\n    currency: s.currency,\n    compartment: s.compartment,\n    from: s.from,\n    to: s.to,\n  });\n\nexport const adminLedgerApi = {\n  wallet: (tenantId: string) => apiFetch<LedgerWallet>(base(tenantId)),\n\n  /** Newest first; `[]` when the business has no wallet. */\n  activity: (tenantId: string, limit: number, cursor?: ActivityCursor) =>\n    apiFetch<LedgerEntry[]>(\n      `${base(tenantId)}/activity${qs({ limit, ...cursor })}`,\n    ),\n\n  statement: (tenantId: string, s: StatementQuery) =>\n    apiFetch<LedgerStatement>(`${base(tenantId)}/statement${statementQs(s)}`),\n\n  /** The statement as CSV text. Over 10,000 rows is a 422. */\n  exportStatement: (tenantId: string, s: StatementQuery) =>\n    apiFetch<string>(`${base(tenantId)}/statement/export${statementQs(s)}`),\n\n  restrictions: (tenantId: string) =>\n    apiFetch<LedgerRestriction[]>(`${base(tenantId)}/restrictions`),\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AA0FzB,MAAM,OAAO,CAAC,aACZ,oCAAoC,mBAAmB,QAAQ,CAAC;AAElE,MAAM,KAAK,CAAC,WAAwD;AAClE,QAAM,IAAI,IAAI,gBAAgB;AAE9B,aAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,MAAM;AAC9C,QAAI,UAAU,UAAa,UAAU,GAAI,GAAE,IAAI,KAAK,OAAO,KAAK,CAAC;AAEnE,QAAM,OAAO,EAAE,SAAS;AAExB,SAAO,OAAO,IAAI,IAAI,KAAK;AAC7B;AAEA,MAAM,cAAc,CAAC,MACnB,GAAG;AAAA,EACD,UAAU,EAAE;AAAA,EACZ,aAAa,EAAE;AAAA,EACf,MAAM,EAAE;AAAA,EACR,IAAI,EAAE;AACR,CAAC;AAEI,MAAM,iBAAiB;AAAA,EAC5B,QAAQ,CAAC,aAAqB,SAAuB,KAAK,QAAQ,CAAC;AAAA;AAAA,EAGnE,UAAU,CAAC,UAAkB,OAAe,WAC1C;AAAA,IACE,GAAG,KAAK,QAAQ,CAAC,YAAY,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC;AAAA,EACvD;AAAA,EAEF,WAAW,CAAC,UAAkB,MAC5B,SAA0B,GAAG,KAAK,QAAQ,CAAC,aAAa,YAAY,CAAC,CAAC,EAAE;AAAA;AAAA,EAG1E,iBAAiB,CAAC,UAAkB,MAClC,SAAiB,GAAG,KAAK,QAAQ,CAAC,oBAAoB,YAAY,CAAC,CAAC,EAAE;AAAA,EAExE,cAAc,CAAC,aACb,SAA8B,GAAG,KAAK,QAAQ,CAAC,eAAe;AAClE;","names":[]}

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

@@ -0,0 +1,127 @@
+import type { TenantTransactionsPage } from './admin-api';
+/**
+ * Money calls for the admin console that `admin-api.ts` does not carry:
+ * payout tier configuration, the transactions list with a date window, and
+ * the maker-checker cash posting proposals. Same `apiFetch` and cookie
+ * session as the rest.
+ *
+ * Amounts are minor-unit strings, as everywhere in Money. Cash proposals have
+ * no list route on the API: a proposal is known only by the id its creation
+ * returns, so the screen shows that id and a checker is given it to decide.
+ */
+export interface PayoutTier {
+    id: string;
+    key: string;
+    currency: string;
+    label: string;
+    position: number;
+    requirements: string[];
+    minimumMinor: string;
+    maximumMinor: string;
+    dailyMaximumMinor: string;
+    monthlyMaximumMinor: string | null;
+    enabled: boolean;
+}
+export type PayoutTierInput = Omit<PayoutTier, 'id'>;
+export interface PayoutTierPreview {
+    tenantId: string;
+    currency: string;
+    verified: string[];
+    tier: PayoutTier | null;
+    missing: string[];
+}
+export type CashPostingKind = 'opening' | 'otc';
+export interface CashPostingInput {
+    /** Whole minor units as a string ("150000" = 1,500.00). */
+    amountMinor: string;
+    currency: string;
+    description?: string;
+    evidence?: Record<string, string>;
+    /** Required for an OTC deposit: the merchant wallet the cash lands in. */
+    walletId?: string;
+}
+/** The API's states: an approved proposal is POSTED to the ledger. */
+export type CashProposalStatus = 'PROPOSED' | 'POSTED' | 'REJECTED';
+/** The parts of a ledger adjustment proposal the console shows. */
+export interface CashProposal {
+    id: string;
+    reasonCode: string;
+    description: string;
+    status: CashProposalStatus;
+    rejectionReasonCode: string | null;
+    proposedAt: string;
+    decidedAt: string | null;
+    maker?: {
+        id: string;
+    } | null;
+    checker?: {
+        id: string;
+    } | null;
+}
+export interface TransactionQuery {
+    status?: string;
+    type?: string;
+    startDate?: string;
+    endDate?: string;
+    /** Sticker ids of the terminals that took it, comma-separated. */
+    deviceIds?: string;
+    page?: number;
+    limit?: number;
+}
+/** One cash posting as the platform lists them, newest first. */
+export interface CashProposalRow {
+    id: string;
+    reasonCode: string;
+    description: string;
+    status: 'PROPOSED' | 'POSTED' | 'REJECTED';
+    amountMinor: string | null;
+    currency: string | null;
+    makerId: string;
+    makerEmail: string | null;
+    checkerId: string | null;
+    checkerEmail: string | null;
+    rejectionReasonCode: string | null;
+    proposedAt: string;
+    decidedAt: string | null;
+}
+export declare const adminMoneyApi: {
+    listTiers: (currency?: string) => Promise<PayoutTier[]>;
+    createTier: (body: PayoutTierInput) => Promise<PayoutTier>;
+    updateTier: (id: string, body: PayoutTierInput) => Promise<PayoutTier>;
+    removeTier: (id: string) => Promise<void>;
+    previewTier: (tenantId: string, currency: string) => Promise<PayoutTierPreview>;
+    /** A merchant's transactions, filtered by status, type and window. */
+    transactions: (tenantId: string, params?: TransactionQuery) => Promise<TenantTransactionsPage>;
+    /** Cash postings newest first; `PROPOSED` for what waits for a checker. */
+    cashProposals: (status?: CashProposalRow["status"]) => Promise<CashProposalRow[]>;
+    /** The standalone Cash posting page's two calls (kept from main). */
+    proposeOpeningCash: (body: {
+        amountMinor: string;
+        currency: string;
+        description?: string;
+    }) => Promise<{
+        id: string;
+    }>;
+    proposeOtcCash: (body: {
+        amountMinor: string;
+        currency: string;
+        walletId: string;
+        description?: string;
+    }) => Promise<{
+        id: string;
+    }>;
+    /** The Wallets workspace's call: one entry point, evidence attached. */
+    proposeCash: (kind: CashPostingKind, input: CashPostingInput) => Promise<CashProposal>;
+    approveCash: (proposalId: string) => Promise<CashProposal>;
+    rejectCash: (proposalId: string, rejectionReasonCode: string) => Promise<CashProposal>;
+};
+/** Every verification a tier can require: the KYC engine's operations. */
+export declare const TIER_REQUIREMENTS: {
+    readonly Individual: readonly ["nin", "nin-slip", "advanced-nin", "premium-nin", "bvn", "validate-bvn", "bvn-nin-selfie", "phone-number", "age-identity", "passport", "drivers-license", "voter-id", "ghana-card", "ghana-passport", "ghana-digital-address", "kenya-national-id", "kenya-passport", "kenya-kra-pin", "uganda-nin", "uganda-voter-id", "south-africa-national-id", "angola-national-id", "zambia-nrc", "zimbabwe-national-id", "zimbabwe-credit-check", "canada-ekyc", "uk-ekyc", "liveness", "face-compare", "face-doc-compare", "document-analysis", "generic-ocr", "utility-bill", "individual-address", "aml-screening", "user-screening", "email-check", "ip-screening", "phone-check"];
+    readonly Business: readonly ["cac", "tin", "global-business-search", "kenya-business", "zambia-business", "business-document", "business-address", "business-aml-screening"];
+};
+/**
+ * "1,500.50" → "150050" for a two-decimal currency. Returns null for
+ * anything that is not a positive amount with at most `digits` decimals.
+ */
+export declare function toMinor(major: string, digits?: number): string | null;

package/dist/admin-money-api.js

@@ -0,0 +1,125 @@
+import { apiFetch } from "./api";
+const BASE = "/platform-admin/v1/money";
+const CASH = `${BASE}/cash`;
+const json = (body) => ({
+  method: "POST",
+  body: JSON.stringify(body)
+});
+function query(params) {
+  const qs = new URLSearchParams();
+  for (const [key, value] of Object.entries(params))
+    if (value !== void 0 && value !== "") qs.set(key, String(value));
+  const q = qs.toString();
+  return q ? `?${q}` : "";
+}
+const adminMoneyApi = {
+  listTiers: (currency) => apiFetch(
+    `${BASE}/payout-tiers${currency ? `?currency=${currency}` : ""}`
+  ),
+  createTier: (body) => apiFetch(`${BASE}/payout-tiers`, json(body)),
+  updateTier: (id, body) => apiFetch(`${BASE}/payout-tiers/${id}`, {
+    method: "PUT",
+    body: JSON.stringify(body)
+  }),
+  removeTier: (id) => apiFetch(`${BASE}/payout-tiers/${id}`, { method: "DELETE" }),
+  previewTier: (tenantId, currency) => apiFetch(
+    `${BASE}/payout-tiers/preview`,
+    json({ tenantId, currency })
+  ),
+  /** A merchant's transactions, filtered by status, type and window. */
+  transactions: (tenantId, params = {}) => apiFetch(
+    `/platform-admin/v1/tenants/${tenantId}/transactions${query({ ...params })}`
+  ),
+  /** Cash postings newest first; `PROPOSED` for what waits for a checker. */
+  cashProposals: (status) => apiFetch(`${CASH}/proposals${query({ status })}`),
+  /** The standalone Cash posting page's two calls (kept from main). */
+  proposeOpeningCash: (body) => apiFetch(`${CASH}/opening/proposals`, json(body)),
+  proposeOtcCash: (body) => apiFetch(`${CASH}/otc/proposals`, json(body)),
+  /** The Wallets workspace's call: one entry point, evidence attached. */
+  proposeCash: (kind, input) => {
+    const body = {
+      amountMinor: input.amountMinor,
+      currency: input.currency,
+      description: input.description,
+      evidence: input.evidence ?? {}
+    };
+    if (kind === "otc") body.walletId = input.walletId;
+    return apiFetch(`${CASH}/${kind}/proposals`, json(body));
+  },
+  approveCash: (proposalId) => apiFetch(
+    `${CASH}/proposals/${encodeURIComponent(proposalId)}/approve`,
+    { method: "POST" }
+  ),
+  rejectCash: (proposalId, rejectionReasonCode) => apiFetch(
+    `${CASH}/proposals/${encodeURIComponent(proposalId)}/reject`,
+    json({ rejectionReasonCode })
+  )
+};
+const TIER_REQUIREMENTS = {
+  Individual: [
+    "nin",
+    "nin-slip",
+    "advanced-nin",
+    "premium-nin",
+    "bvn",
+    "validate-bvn",
+    "bvn-nin-selfie",
+    "phone-number",
+    "age-identity",
+    "passport",
+    "drivers-license",
+    "voter-id",
+    "ghana-card",
+    "ghana-passport",
+    "ghana-digital-address",
+    "kenya-national-id",
+    "kenya-passport",
+    "kenya-kra-pin",
+    "uganda-nin",
+    "uganda-voter-id",
+    "south-africa-national-id",
+    "angola-national-id",
+    "zambia-nrc",
+    "zimbabwe-national-id",
+    "zimbabwe-credit-check",
+    "canada-ekyc",
+    "uk-ekyc",
+    "liveness",
+    "face-compare",
+    "face-doc-compare",
+    "document-analysis",
+    "generic-ocr",
+    "utility-bill",
+    "individual-address",
+    "aml-screening",
+    "user-screening",
+    "email-check",
+    "ip-screening",
+    "phone-check"
+  ],
+  Business: [
+    "cac",
+    "tin",
+    "global-business-search",
+    "kenya-business",
+    "zambia-business",
+    "business-document",
+    "business-address",
+    "business-aml-screening"
+  ]
+};
+function toMinor(major, digits = 2) {
+  const clean = major.replace(/[\s,]/g, "");
+  if (!/^\d+(\.\d+)?$/.test(clean)) return null;
+  const [whole, fraction = ""] = clean.split(".");
+  if (fraction.length > digits) return null;
+  const minor = `${whole}${fraction.padEnd(digits, "0")}`.replace(/^0+/, "");
+  if (!minor || minor.length > 19) return null;
+  return minor;
+}
+export {
+  TIER_REQUIREMENTS,
+  adminMoneyApi,
+  toMinor
+};
+//# sourceMappingURL=admin-money-api.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/admin-money-api.ts"],"sourcesContent":["import { apiFetch } from './api';\nimport type { TenantTransactionsPage } from './admin-api';\n\n/**\n * Money calls for the admin console that `admin-api.ts` does not carry:\n * payout tier configuration, the transactions list with a date window, and\n * the maker-checker cash posting proposals. Same `apiFetch` and cookie\n * session as the rest.\n *\n * Amounts are minor-unit strings, as everywhere in Money. Cash proposals have\n * no list route on the API: a proposal is known only by the id its creation\n * returns, so the screen shows that id and a checker is given it to decide.\n */\nexport interface PayoutTier {\n  id: string;\n  key: string;\n  currency: string;\n  label: string;\n  position: number;\n  requirements: string[];\n  minimumMinor: string;\n  maximumMinor: string;\n  dailyMaximumMinor: string;\n  monthlyMaximumMinor: string | null;\n  enabled: boolean;\n}\n\nexport type PayoutTierInput = Omit<PayoutTier, 'id'>;\n\nexport interface PayoutTierPreview {\n  tenantId: string;\n  currency: string;\n  verified: string[];\n  tier: PayoutTier | null;\n  missing: string[];\n}\n\nexport type CashPostingKind = 'opening' | 'otc';\n\nexport interface CashPostingInput {\n  /** Whole minor units as a string (\"150000\" = 1,500.00). */\n  amountMinor: string;\n  currency: string;\n  description?: string;\n  evidence?: Record<string, string>;\n  /** Required for an OTC deposit: the merchant wallet the cash lands in. */\n  walletId?: string;\n}\n\n/** The API's states: an approved proposal is POSTED to the ledger. */\nexport type CashProposalStatus = 'PROPOSED' | 'POSTED' | 'REJECTED';\n\n/** The parts of a ledger adjustment proposal the console shows. */\nexport interface CashProposal {\n  id: string;\n  reasonCode: string;\n  description: string;\n  status: CashProposalStatus;\n  rejectionReasonCode: string | null;\n  proposedAt: string;\n  decidedAt: string | null;\n  maker?: { id: string } | null;\n  checker?: { id: string } | null;\n}\n\nexport interface TransactionQuery {\n  status?: string;\n  type?: string;\n  startDate?: string;\n  endDate?: string;\n  /** Sticker ids of the terminals that took it, comma-separated. */\n  deviceIds?: string;\n  page?: number;\n  limit?: number;\n}\n\n/** One cash posting as the platform lists them, newest first. */\nexport interface CashProposalRow {\n  id: string;\n  reasonCode: string;\n  description: string;\n  status: 'PROPOSED' | 'POSTED' | 'REJECTED';\n  amountMinor: string | null;\n  currency: string | null;\n  makerId: string;\n  makerEmail: string | null;\n  checkerId: string | null;\n  checkerEmail: string | null;\n  rejectionReasonCode: string | null;\n  proposedAt: string;\n  decidedAt: string | null;\n}\n\nconst BASE = '/platform-admin/v1/money';\nconst CASH = `${BASE}/cash`;\n\nconst json = (body: unknown) => ({\n  method: 'POST',\n  body: JSON.stringify(body),\n});\n\nfunction query(params: Record<string, string | number | undefined>) {\n  const qs = new URLSearchParams();\n\n  for (const [key, value] of Object.entries(params))\n    if (value !== undefined && value !== '') qs.set(key, String(value));\n\n  const q = qs.toString();\n\n  return q ? `?${q}` : '';\n}\n\nexport const adminMoneyApi = {\n  listTiers: (currency?: string) =>\n    apiFetch<PayoutTier[]>(\n      `${BASE}/payout-tiers${currency ? `?currency=${currency}` : ''}`,\n    ),\n  createTier: (body: PayoutTierInput) =>\n    apiFetch<PayoutTier>(`${BASE}/payout-tiers`, json(body)),\n  updateTier: (id: string, body: PayoutTierInput) =>\n    apiFetch<PayoutTier>(`${BASE}/payout-tiers/${id}`, {\n      method: 'PUT',\n      body: JSON.stringify(body),\n    }),\n  removeTier: (id: string) =>\n    apiFetch<void>(`${BASE}/payout-tiers/${id}`, { method: 'DELETE' }),\n  previewTier: (tenantId: string, currency: string) =>\n    apiFetch<PayoutTierPreview>(\n      `${BASE}/payout-tiers/preview`,\n      json({ tenantId, currency }),\n    ),\n\n  /** A merchant's transactions, filtered by status, type and window. */\n  transactions: (tenantId: string, params: TransactionQuery = {}) =>\n    apiFetch<TenantTransactionsPage>(\n      `/platform-admin/v1/tenants/${tenantId}/transactions${query({ ...params })}`,\n    ),\n\n  /** Cash postings newest first; `PROPOSED` for what waits for a checker. */\n  cashProposals: (status?: CashProposalRow['status']) =>\n    apiFetch<CashProposalRow[]>(`${CASH}/proposals${query({ status })}`),\n\n  /** The standalone Cash posting page's two calls (kept from main). */\n  proposeOpeningCash: (body: {\n    amountMinor: string;\n    currency: string;\n    description?: string;\n  }) => apiFetch<{ id: string }>(`${CASH}/opening/proposals`, json(body)),\n  proposeOtcCash: (body: {\n    amountMinor: string;\n    currency: string;\n    walletId: string;\n    description?: string;\n  }) => apiFetch<{ id: string }>(`${CASH}/otc/proposals`, json(body)),\n\n  /** The Wallets workspace's call: one entry point, evidence attached. */\n  proposeCash: (kind: CashPostingKind, input: CashPostingInput) => {\n    const body: Record<string, unknown> = {\n      amountMinor: input.amountMinor,\n      currency: input.currency,\n      description: input.description,\n      evidence: input.evidence ?? {},\n    };\n\n    if (kind === 'otc') body.walletId = input.walletId;\n\n    return apiFetch<CashProposal>(`${CASH}/${kind}/proposals`, json(body));\n  },\n\n  approveCash: (proposalId: string) =>\n    apiFetch<CashProposal>(\n      `${CASH}/proposals/${encodeURIComponent(proposalId)}/approve`,\n      { method: 'POST' },\n    ),\n\n  rejectCash: (proposalId: string, rejectionReasonCode: string) =>\n    apiFetch<CashProposal>(\n      `${CASH}/proposals/${encodeURIComponent(proposalId)}/reject`,\n      json({ rejectionReasonCode }),\n    ),\n};\n\n/** Every verification a tier can require: the KYC engine's operations. */\nexport const TIER_REQUIREMENTS = {\n  Individual: [\n    'nin',\n    'nin-slip',\n    'advanced-nin',\n    'premium-nin',\n    'bvn',\n    'validate-bvn',\n    'bvn-nin-selfie',\n    'phone-number',\n    'age-identity',\n    'passport',\n    'drivers-license',\n    'voter-id',\n    'ghana-card',\n    'ghana-passport',\n    'ghana-digital-address',\n    'kenya-national-id',\n    'kenya-passport',\n    'kenya-kra-pin',\n    'uganda-nin',\n    'uganda-voter-id',\n    'south-africa-national-id',\n    'angola-national-id',\n    'zambia-nrc',\n    'zimbabwe-national-id',\n    'zimbabwe-credit-check',\n    'canada-ekyc',\n    'uk-ekyc',\n    'liveness',\n    'face-compare',\n    'face-doc-compare',\n    'document-analysis',\n    'generic-ocr',\n    'utility-bill',\n    'individual-address',\n    'aml-screening',\n    'user-screening',\n    'email-check',\n    'ip-screening',\n    'phone-check',\n  ],\n  Business: [\n    'cac',\n    'tin',\n    'global-business-search',\n    'kenya-business',\n    'zambia-business',\n    'business-document',\n    'business-address',\n    'business-aml-screening',\n  ],\n} as const;\n\n/**\n * \"1,500.50\" → \"150050\" for a two-decimal currency. Returns null for\n * anything that is not a positive amount with at most `digits` decimals.\n */\nexport function toMinor(major: string, digits = 2): string | null {\n  const clean = major.replace(/[\\s,]/g, '');\n\n  if (!/^\\d+(\\.\\d+)?$/.test(clean)) return null;\n\n  const [whole, fraction = ''] = clean.split('.');\n\n  if (fraction.length > digits) return null;\n\n  const minor = `${whole}${fraction.padEnd(digits, '0')}`.replace(/^0+/, '');\n\n  if (!minor || minor.length > 19) return null;\n\n  return minor;\n}\n"],"mappings":"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","names":[]}

package/dist/admin-newsletter-contacts-api.d.ts

@@ -0,0 +1,70 @@
+import type { Delivery } from './admin-newsletter-deliveries-api';
+export type ContactStatus = 'subscribed' | 'unsubscribed' | 'bounced' | 'unverified' | 'inactive';
+export type ContactSource = 'account' | 'manual' | 'import';
+export type UnsubscribedVia = 'link' | 'mailbox' | 'admin';
+/** One email address the newsletter can know about, and where it stands. */
+export interface Contact {
+    id: string;
+    email: string;
+    name: string | null;
+    status: ContactStatus;
+    source: ContactSource;
+    importId: string | null;
+    sourceNote: string | null;
+    accountId: string | null;
+    consent: boolean;
+    unsubscribedAt: string | null;
+    unsubscribedVia: UnsubscribedVia | null;
+    unsubscribedNewsletter: {
+        id: string;
+        subject: string;
+    } | null;
+    bouncedAt: string | null;
+    /** What an admin typed when they changed the status by hand. */
+    statusNote: string | null;
+    createdAt: string;
+    segments: {
+        id: string;
+        name: string;
+    }[];
+    lastSent: {
+        newsletterId: string;
+        subject: string;
+        sentAt: string;
+    } | null;
+}
+/** `notEmailable` is unverified and inactive together. */
+export interface ContactCounts {
+    all: number;
+    subscribed: number;
+    unsubscribed: number;
+    bounced: number;
+    notEmailable: number;
+}
+export interface ContactPage {
+    items: Contact[];
+    total: number;
+    page: number;
+    limit: number;
+    counts: ContactCounts;
+}
+export type ContactDelivery = Delivery & {
+    subject: string;
+};
+export interface ContactDeliveryPage {
+    items: ContactDelivery[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/** `query` is a ready query string ("?status=bounced&page=1"), or empty. */
+export declare const adminNewsletterContactsApi: {
+    list: (query: string) => Promise<ContactPage>;
+    /** Answers with the CSV file's text. */
+    exportCsv: (query: string) => Promise<string>;
+    get: (id: string) => Promise<Contact>;
+    deliveries: (id: string, query: string) => Promise<ContactDeliveryPage>;
+    unsubscribe: (id: string, note: string) => Promise<Contact>;
+    /** Refused with 409 for a bounced, unverified or inactive contact. */
+    resubscribe: (id: string, note: string) => Promise<Contact>;
+};