@withpotter/lib 0.13.0-next.101

package/dist/api/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/feedback.ts"],"sourcesContent":["import { apiFetch } from './core';\n\n/**\n * The shape of the question. Not interchangeable — see the API entity for why\n * a single `rating` column with no kind beside it cannot be read back.\n */\nexport type FeedbackSignalKind = 'nps' | 'csat' | 'ces' | 'thumb' | 'star';\n\nexport type FeedbackPromptStateName = 'answered' | 'dismissed' | 'snoozed';\n\nexport interface FeedbackPromptState {\n  promptKey: string;\n  state: FeedbackPromptStateName;\n  snoozeUntil: string | null;\n  seenCount: number;\n  /**\n   * Whether this account may be shown the prompt right now. Computed on the\n   * server so no screen re-derives \"dismissed, or snoozed and the date has not\n   * passed\" — that clause would have been spelled four ways across five call\n   * sites.\n   */\n  eligible: boolean;\n}\n\nexport interface CreateFeedbackSignal {\n  kind: FeedbackSignalKind;\n  /** Which prompt asked: `home.nps.quarterly`, `catalog.import.ces`. */\n  promptKey: string;\n  score: number;\n  comment?: string;\n  /** What was rated, when the answer is about one object not the product. */\n  subjectType?: string;\n  subjectId?: string;\n  pageUrl?: string;\n  posthogSessionId?: string;\n  /**\n   * The room the answer was given in. Collected by `describeSurroundings`,\n   * because a score with no circumstances is a number: \"3 out of 7 for the\n   * import\" is a bad importer or a merchant doing it on a phone at midnight,\n   * and the two want opposite fixes.\n   */\n  viewport?: string;\n  locale?: string;\n  timeZone?: string;\n  theme?: string;\n  route?: string;\n}\n\n/**\n * A message somebody sent us: the sentence, the screenshot, the clip.\n *\n * The other half of feedback, and the half that had no reader until now — a\n * submission opened a GitHub issue and an email, so the console showed every\n * score and nothing anybody said.\n */\nexport interface AdminFeedbackMessage {\n  id: string;\n  category: string;\n  status: string;\n  /** Null where the whole message was spoken. */\n  description: string | null;\n  audioUrl: string | null;\n  audioSeconds: number | null;\n  /** The real transcript, once the api has made one. Word times included. */\n  transcript: FeedbackTranscript | null;\n  screenshotUrl: string | null;\n  pageUrl: string;\n  /** The part of the product, in the merchant's own word for it. */\n  area: string | null;\n  /** The route pattern, ids masked. */\n  route: string | null;\n  browser: {\n    platform?: string;\n    userAgent?: string;\n    viewportWidth?: number;\n    viewportHeight?: number;\n    language?: string;\n  };\n  githubIssueUrl: string | null;\n  serviceCaseId: string | null;\n  createdAt: string;\n  business: FeedbackSignalBusiness | null;\n}\n\n/** What was said in a clip, with a time on every word. */\nexport interface FeedbackTranscript {\n  text: string;\n  words: { w: string; s: number; e: number }[];\n  by?: string;\n}\n\n/** The business an answer came from, resolved by the api rather than sent. */\nexport interface FeedbackSignalBusiness {\n  name: string;\n  slug: string;\n  model: string[];\n  industry: string | null;\n  since: string;\n}\n\nexport interface FeedbackSignalResponse {\n  id: string;\n  kind: FeedbackSignalKind;\n  promptKey: string;\n  score: number;\n  createdAt: string;\n}\n\n/** One prompt's aggregate, so nothing in this feature is write-only. */\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 const feedbackApi = {\n  /**\n   * Every prompt this account has already met, on any device.\n   *\n   * Read ONCE per session by `FeedbackPromptProvider` and shared, not called\n   * per prompt. The home already reads 29 endpoints and the catalogue 19\n   * against a 100-a-minute limiter; a feature whose whole job is to be\n   * sprinkled everywhere must not add a request per sprinkle.\n   */\n  listPrompts: () => apiFetch<FeedbackPromptState[]>('/feedback/prompts'),\n\n  /** The prompt went on screen. Returns the count including this showing. */\n  markSeen: (promptKey: string) =>\n    apiFetch<{ seenCount: number }>(\n      `/feedback/prompts/${encodeURIComponent(promptKey)}/seen`,\n      { method: 'POST' },\n    ),\n\n  /**\n   * Wave a prompt away. No `snoozeDays` means for good; a number means \"not\n   * now\" and it comes back after that many days.\n   */\n  dismissPrompt: (promptKey: string, snoozeDays?: number) =>\n    apiFetch<FeedbackPromptState>(\n      `/feedback/prompts/${encodeURIComponent(promptKey)}/dismiss`,\n      {\n        method: 'POST',\n        body: JSON.stringify(snoozeDays === undefined ? {} : { snoozeDays }),\n      },\n    ),\n\n  /**\n   * Record a score.\n   *\n   * IT SENDS THE WORKSPACE, and the note that used to be here was wrong in a\n   * way that cost the whole feature. It read: \"`tenantSlug` is deliberately not\n   * a parameter … the server reads whichever workspace the request already\n   * carries\". The server carries nothing of the sort — `apiFetch` sets\n   * `X-Tenant-Slug` only when a caller passes one, and the api's `CurrentTenant`\n   * throws a 404 when it is absent. So every score anybody ever pressed came\n   * back 404, silently, because this fires and forgets. Measured on a real\n   * session: 404 before, 201 after.\n   *\n   * The worry underneath it — that naming a workspace surveys a two-business\n   * merchant twice — was about the wrong thing. Eligibility is keyed by\n   * ACCOUNT (`/feedback/prompts` reads by accountId), so who gets asked does\n   * not change; only what the answer is filed against does. And it has to be\n   * filed against something: the admin panel shows which business said it, and\n   * a complaint cannot become a support case without a workspace to open it\n   * on.\n   */\n  recordSignal: (data: CreateFeedbackSignal, tenantSlug?: string) =>\n    apiFetch<FeedbackSignalResponse>('/feedback/signals', {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify(data),\n    }),\n\n  /**\n   * Attach the sentence to a score already recorded.\n   *\n   * Two calls rather than one because the score must not wait for the prose:\n   * most people press a number and never write anything, and a flow that held\n   * the answer back until the comment step resolved would have thrown those\n   * away. An empty string clears the comment rather than failing.\n   */\n  attachComment: (\n    signalId: string,\n    body: { comment?: string; audioUrl?: string; audioSeconds?: number },\n  ) =>\n    apiFetch<FeedbackSignalResponse>(\n      `/feedback/signals/${encodeURIComponent(signalId)}/comment`,\n      { method: 'POST', body: JSON.stringify(body) },\n    ),\n};\n\n// =============================================================================\n// READING IT BACK — a different identity, not a stronger permission\n// =============================================================================\n\n/**\n * These sit under `platform-admin/v1` and are guarded by `PlatformAdminGuard`,\n * which verifies a `pb_admin_token` with `kind: 'admin'`. A merchant session\n * cannot satisfy it at all.\n *\n * The summary first shipped on the merchant controller behind the ordinary\n * auth guard, and it aggregates the whole table with no tenant filter —\n * because a cross-merchant NPS is the only NPS worth having. So every merchant\n * could read every other merchant's scores. The query was right and the door\n * was wrong; this is the right door.\n */\n\nexport interface FeedbackSignalComment {\n  id: string;\n  /** The real transcript of the clip, once one exists. */\n  transcript: FeedbackTranscript | null;\n  /** Who said it. Null for an answer left outside any workspace. */\n  business: FeedbackSignalBusiness | null;\n  /** The case somebody opened from this answer, if anybody has. */\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: {\n    tenantSlug?: string;\n    userEmail?: string;\n    pageUrl?: string;\n    seenCount?: number;\n    posthogSessionId?: string;\n    viewport?: string;\n    locale?: string;\n    timeZone?: string;\n    theme?: string;\n    route?: string;\n  };\n}\n\n/**\n * How a prompt is FARING rather than what it scored. A prompt with a lovely\n * average that forty people closed is not a lovely prompt.\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 interface AdminIdentity {\n  id: string;\n  email: string;\n  name: string;\n  role: string;\n}\n\nexport const adminFeedbackApi = {\n  login: (email: string, password: string) =>\n    apiFetch<{ mustChangePassword: boolean; admin: AdminIdentity }>(\n      '/platform-admin/v1/auth/login',\n      { method: 'POST', body: JSON.stringify({ email, password }) },\n    ),\n\n  me: () => apiFetch<AdminIdentity>('/platform-admin/v1/auth/me'),\n\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  /**\n   * Pick a complaint up: open a support case in the merchant's own inbox,\n   * carrying what they said.\n   *\n   * Idempotent on the server — the signal remembers which case it became — so\n   * a second press, a reload, or a second admin reading the same panel cannot\n   * split one complaint across two conversations. `created: false` means it\n   * was already open.\n   */\n  /** What merchants wrote, recorded or photographed for us. */\n  messages: (days = 90, limit = 100) =>\n    apiFetch<AdminFeedbackMessage[]>(\n      `/platform-admin/v1/feedback/messages?days=${days}&limit=${limit}`,\n    ),\n\n  /** Pick a message up. Same act, same rules, as picking up a score. */\n  openCaseFromMessage: (id: string) =>\n    apiFetch<{ caseId: string; created: boolean }>(\n      `/platform-admin/v1/feedback/messages/${id}/case`,\n      { method: 'POST' },\n    ),\n\n  openCase: (signalId: string) =>\n    apiFetch<{ caseId: string; created: boolean }>(\n      `/platform-admin/v1/feedback/signals/${signalId}/case`,\n      { method: 'POST' },\n    ),\n};\n"],"mappings":"AAAA,SAAS,gBAAgB;AAuHlB,MAAM,cAAc;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASzB,aAAa,MAAM,SAAgC,mBAAmB;AAAA;AAAA,EAGtE,UAAU,CAAC,cACT;AAAA,IACE,qBAAqB,mBAAmB,SAAS,CAAC;AAAA,IAClD,EAAE,QAAQ,OAAO;AAAA,EACnB;AAAA;AAAA;AAAA;AAAA;AAAA,EAMF,eAAe,CAAC,WAAmB,eACjC;AAAA,IACE,qBAAqB,mBAAmB,SAAS,CAAC;AAAA,IAClD;AAAA,MACE,QAAQ;AAAA,MACR,MAAM,KAAK,UAAU,eAAe,SAAY,CAAC,IAAI,EAAE,WAAW,CAAC;AAAA,IACrE;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAsBF,cAAc,CAAC,MAA4B,eACzC,SAAiC,qBAAqB;AAAA,IACpD,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUH,eAAe,CACb,UACA,SAEA;AAAA,IACE,qBAAqB,mBAAmB,QAAQ,CAAC;AAAA,IACjD,EAAE,QAAQ,QAAQ,MAAM,KAAK,UAAU,IAAI,EAAE;AAAA,EAC/C;AACJ;AAoEO,MAAM,mBAAmB;AAAA,EAC9B,OAAO,CAAC,OAAe,aACrB;AAAA,IACE;AAAA,IACA,EAAE,QAAQ,QAAQ,MAAM,KAAK,UAAU,EAAE,OAAO,SAAS,CAAC,EAAE;AAAA,EAC9D;AAAA,EAEF,IAAI,MAAM,SAAwB,4BAA4B;AAAA,EAE9D,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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYF,UAAU,CAAC,OAAO,IAAI,QAAQ,QAC5B;AAAA,IACE,6CAA6C,IAAI,UAAU,KAAK;AAAA,EAClE;AAAA;AAAA,EAGF,qBAAqB,CAAC,OACpB;AAAA,IACE,wCAAwC,EAAE;AAAA,IAC1C,EAAE,QAAQ,OAAO;AAAA,EACnB;AAAA,EAEF,UAAU,CAAC,aACT;AAAA,IACE,uCAAuC,QAAQ;AAAA,IAC/C,EAAE,QAAQ,OAAO;AAAA,EACnB;AACJ;","names":[]}

package/dist/api/finance.d.ts

@@ -0,0 +1,199 @@
+import type { Transaction, FinanceAnalytics, PaymentExceptions, TransactionTimeline, OfflineCapture, WebhookFailure, PaymentDiscrepancy, OverdrawnAccount } from './types';
+export declare const financeApi: {
+    listTransactions: (tenantSlug: string, params?: {
+        status?: string;
+        type?: string;
+        search?: string;
+        page?: number;
+        limit?: number;
+        startDate?: string;
+        endDate?: string;
+        orderId?: string;
+    }) => Promise<{
+        transactions: Transaction[];
+        pagination: {
+            total: number;
+            page: number;
+            limit: number;
+            totalPages: number;
+        };
+    }>;
+    exportTransactions: (tenantSlug: string, params?: {
+        status?: string;
+        type?: string;
+        search?: string;
+        startDate?: string;
+        endDate?: string;
+    }) => Promise<string>;
+    getTransaction: (tenantSlug: string, id: string) => Promise<Transaction>;
+    /**
+     * Everything about this merchant's money that is not going as it should.
+     *
+     * The screen could only ever show the happy path — a payment stuck pending
+     * looked like a payment, and a refund the provider never confirmed looked
+     * settled. This is the answer to "is anything wrong", which is the question
+     * the surface is actually opened to ask.
+     */
+    getExceptions: (tenantSlug: string) => Promise<PaymentExceptions>;
+    /**
+     * The offline payments somebody has to say yes or no to.
+     *
+     * Its own call rather than part of the summary: the summary is drawn on every
+     * visit and this is opened on purpose, so making the count cost every row
+     * would be paying for the second question to answer the first.
+     */
+    getOfflineCaptures: (tenantSlug: string) => Promise<{
+        captures: OfflineCapture[];
+    }>;
+    /**
+     * Say whether money a device took offline ever arrived.
+     *
+     * A decision, not a lookup. There is no provider record to check — the charge
+     * happened on the machine — so this records what the merchant established and
+     * who established it.
+     */
+    resolveOfflineCapture: (tenantSlug: string, id: string, data: {
+        outcome: "collected" | "not_collected";
+        note?: string;
+    }) => Promise<{
+        transactionId: string;
+        status: string;
+        message: string;
+    }>;
+    /**
+     * Customers who spent more than they had.
+     *
+     * Only ever created offline, so each is somebody who walked away having had
+     * more than they paid for.
+     */
+    getOverdrawn: (tenantSlug: string) => Promise<{
+        accounts: OverdrawnAccount[];
+    }>;
+    /**
+     * Decide an overdraft is not worth chasing.
+     *
+     * Recorded as a movement somebody made rather than an edit to a number — a
+     * debt that vanished with no record is indistinguishable from one that was
+     * never there.
+     */
+    writeOffOverdraft: (tenantSlug: string, data: {
+        memberId: string;
+        note?: string;
+    }) => Promise<{
+        memberId: string;
+        balance: number;
+    }>;
+    /** The reconciliation findings somebody has to work through. */
+    getDiscrepancies: (tenantSlug: string) => Promise<{
+        discrepancies: PaymentDiscrepancy[];
+    }>;
+    /**
+     * Close a finding.
+     *
+     * `resolved` and `ignored` are kept apart deliberately: one says the problem
+     * was dealt with, the other says somebody decided to live with it, and in
+     * three months that is the only distinction worth having. Neither changes a
+     * figure — a button that made two records agree would be a way to make the
+     * books say whatever is convenient.
+     */
+    resolveDiscrepancy: (tenantSlug: string, id: string, data: {
+        status: "resolved" | "ignored";
+        note?: string;
+    }) => Promise<{
+        id: string;
+        status: string;
+    }>;
+    /**
+     * Ask the bank what happened to refunds it never confirmed.
+     *
+     * Nothing here decides anything — it applies what the bank says, down the
+     * same path a confirmation would have taken.
+     */
+    recheckRefunds: (tenantSlug: string) => Promise<{
+        checked: number;
+        settled: number;
+        failed: number;
+        stillPending: number;
+    }>;
+    /** Payments we could not finish recording. */
+    getWebhookFailures: (tenantSlug: string) => Promise<{
+        failures: WebhookFailure[];
+        total: number;
+    }>;
+    /**
+     * Try one again.
+     *
+     * Safe to re-run because the ledger refuses a second row for the same
+     * payment — replaying something already applied changes nothing.
+     */
+    replayWebhookFailure: (tenantSlug: string, id: string) => Promise<{
+        replayed: boolean;
+        message: string;
+    }>;
+    /**
+     * Everything that happened to one transaction, oldest first.
+     *
+     * A status is overwritten in place, so the detail screen could show one word
+     * and no history: a payment that declined, was retried, cleared, then was
+     * half refunded read as "partially refunded" and nothing else.
+     */
+    getTransactionTimeline: (tenantSlug: string, id: string) => Promise<TransactionTimeline>;
+    /** Refund a transaction — full (omit amount) or partial. */
+    /**
+     * Email the customer this payment's receipt.
+     *
+     * No address argument, deliberately: the API sends to the address on the
+     * transaction and ignores anything else, so offering one here would imply a
+     * choice the merchant does not have.
+     */
+    sendReceipt: (tenantSlug: string, id: string) => Promise<{
+        sent: boolean;
+        to: string;
+    }>;
+    /**
+     * This payment's receipt as a PDF.
+     *
+     * A blob, so it goes around `apiFetch` (which parses JSON), the same way the
+     * invoice PDF does. The API refuses a payment that did not go through, and
+     * that refusal arrives here as a sentence worth showing.
+     */
+    downloadReceipt: (tenantSlug: string, id: string) => Promise<Blob>;
+    refundTransaction: (tenantSlug: string, id: string, data?: {
+        amount?: number;
+        reason?: string;
+    }) => Promise<{
+        refundId: string;
+        reference: string;
+        amount: number;
+        currency: string;
+        status: string;
+        message: string;
+    }>;
+    getAnalytics: (tenantSlug: string, params?: {
+        startDate?: string;
+        endDate?: string;
+        period?: string;
+    }) => Promise<FinanceAnalytics>;
+    /**
+     * What a sale of this size costs, worked out by the api rather than by us.
+     *
+     * The rate is a policy that changes per plan, so any figure the dashboard
+     * computes for itself is a second source that can only drift from the one
+     * the merchant is actually on — which is exactly why the payouts card
+     * stopped restating "0.5% / 1.5% + N100" as literal strings. This asks.
+     *
+     * `transactionCharge` is what gets ADDED TO THE CUSTOMER'S TOTAL, so it is 0
+     * whenever the merchant absorbs fees. That is the endpoint's whole meaning
+     * and it is easy to misread as "this sale is free to you": when the merchant
+     * bears the fee it comes out of the payout instead, and this route does not
+     * report that figure.
+     */
+    getCharges: (tenantSlug: string, amount: number) => Promise<{
+        chargeBearer: "merchant" | "customer";
+        transactionCharge: number;
+        breakdown?: {
+            paystackFee: number;
+            potterMargin: number;
+        };
+    }>;
+};

package/dist/api/finance.js

@@ -0,0 +1,203 @@
+import { apiFetch, getApiUrl, getAccountId } from "./core";
+const financeApi = {
+  // Transactions
+  listTransactions: (tenantSlug, params) => {
+    const searchParams = new URLSearchParams();
+    if (params?.status) searchParams.set("status", params.status);
+    if (params?.type) searchParams.set("type", params.type);
+    if (params?.search) searchParams.set("search", params.search);
+    if (params?.page) searchParams.set("page", String(params.page));
+    if (params?.limit) searchParams.set("limit", String(params.limit));
+    if (params?.startDate) searchParams.set("startDate", params.startDate);
+    if (params?.endDate) searchParams.set("endDate", params.endDate);
+    if (params?.orderId) searchParams.set("orderId", params.orderId);
+    const query = searchParams.toString() ? `?${searchParams.toString()}` : "";
+    return apiFetch(`/finance/transactions${query}`, { tenantSlug });
+  },
+  exportTransactions: (tenantSlug, params) => {
+    const searchParams = new URLSearchParams();
+    if (params?.status) searchParams.set("status", params.status);
+    if (params?.type) searchParams.set("type", params.type);
+    if (params?.search) searchParams.set("search", params.search);
+    if (params?.startDate) searchParams.set("startDate", params.startDate);
+    if (params?.endDate) searchParams.set("endDate", params.endDate);
+    const query = searchParams.toString() ? `?${searchParams}` : "";
+    return apiFetch(`/finance/transactions/export${query}`, {
+      tenantSlug
+    });
+  },
+  getTransaction: (tenantSlug, id) => apiFetch(`/finance/transactions/${id}`, { tenantSlug }),
+  /**
+   * Everything about this merchant's money that is not going as it should.
+   *
+   * The screen could only ever show the happy path — a payment stuck pending
+   * looked like a payment, and a refund the provider never confirmed looked
+   * settled. This is the answer to "is anything wrong", which is the question
+   * the surface is actually opened to ask.
+   */
+  getExceptions: (tenantSlug) => apiFetch("/finance/exceptions", { tenantSlug }),
+  /**
+   * The offline payments somebody has to say yes or no to.
+   *
+   * Its own call rather than part of the summary: the summary is drawn on every
+   * visit and this is opened on purpose, so making the count cost every row
+   * would be paying for the second question to answer the first.
+   */
+  getOfflineCaptures: (tenantSlug) => apiFetch("/finance/offline-captures", {
+    tenantSlug
+  }),
+  /**
+   * Say whether money a device took offline ever arrived.
+   *
+   * A decision, not a lookup. There is no provider record to check — the charge
+   * happened on the machine — so this records what the merchant established and
+   * who established it.
+   */
+  resolveOfflineCapture: (tenantSlug, id, data) => apiFetch(
+    `/finance/transactions/${id}/resolve-offline`,
+    { tenantSlug, method: "POST", body: JSON.stringify(data) }
+  ),
+  /**
+   * Customers who spent more than they had.
+   *
+   * Only ever created offline, so each is somebody who walked away having had
+   * more than they paid for.
+   */
+  getOverdrawn: (tenantSlug) => apiFetch("/credentials/overdrawn", {
+    tenantSlug
+  }),
+  /**
+   * Decide an overdraft is not worth chasing.
+   *
+   * Recorded as a movement somebody made rather than an edit to a number — a
+   * debt that vanished with no record is indistinguishable from one that was
+   * never there.
+   */
+  writeOffOverdraft: (tenantSlug, data) => apiFetch("/credentials/write-off", {
+    tenantSlug,
+    method: "POST",
+    body: JSON.stringify(data)
+  }),
+  /** The reconciliation findings somebody has to work through. */
+  getDiscrepancies: (tenantSlug) => apiFetch(
+    "/finance/discrepancies",
+    { tenantSlug }
+  ),
+  /**
+   * Close a finding.
+   *
+   * `resolved` and `ignored` are kept apart deliberately: one says the problem
+   * was dealt with, the other says somebody decided to live with it, and in
+   * three months that is the only distinction worth having. Neither changes a
+   * figure — a button that made two records agree would be a way to make the
+   * books say whatever is convenient.
+   */
+  resolveDiscrepancy: (tenantSlug, id, data) => apiFetch(
+    `/finance/discrepancies/${id}/resolve`,
+    { tenantSlug, method: "POST", body: JSON.stringify(data) }
+  ),
+  /**
+   * Ask the bank what happened to refunds it never confirmed.
+   *
+   * Nothing here decides anything — it applies what the bank says, down the
+   * same path a confirmation would have taken.
+   */
+  recheckRefunds: (tenantSlug) => apiFetch("/finance/refunds/recheck", { tenantSlug, method: "POST" }),
+  /** Payments we could not finish recording. */
+  getWebhookFailures: (tenantSlug) => apiFetch(
+    "/finance/webhook-failures",
+    { tenantSlug }
+  ),
+  /**
+   * Try one again.
+   *
+   * Safe to re-run because the ledger refuses a second row for the same
+   * payment — replaying something already applied changes nothing.
+   */
+  replayWebhookFailure: (tenantSlug, id) => apiFetch(
+    `/finance/webhook-failures/${id}/replay`,
+    { tenantSlug, method: "POST" }
+  ),
+  /**
+   * Everything that happened to one transaction, oldest first.
+   *
+   * A status is overwritten in place, so the detail screen could show one word
+   * and no history: a payment that declined, was retried, cleared, then was
+   * half refunded read as "partially refunded" and nothing else.
+   */
+  getTransactionTimeline: (tenantSlug, id) => apiFetch(`/finance/transactions/${id}/timeline`, {
+    tenantSlug
+  }),
+  /** Refund a transaction — full (omit amount) or partial. */
+  /**
+   * Email the customer this payment's receipt.
+   *
+   * No address argument, deliberately: the API sends to the address on the
+   * transaction and ignores anything else, so offering one here would imply a
+   * choice the merchant does not have.
+   */
+  sendReceipt: (tenantSlug, id) => apiFetch(
+    `/finance/transactions/${id}/receipt`,
+    { tenantSlug, method: "POST" }
+  ),
+  /**
+   * This payment's receipt as a PDF.
+   *
+   * A blob, so it goes around `apiFetch` (which parses JSON), the same way the
+   * invoice PDF does. The API refuses a payment that did not go through, and
+   * that refusal arrives here as a sentence worth showing.
+   */
+  downloadReceipt: async (tenantSlug, id) => {
+    const headers = {};
+    if (tenantSlug) headers["X-Tenant-Slug"] = tenantSlug;
+    const accountId = getAccountId();
+    if (accountId) headers["x-account-id"] = accountId;
+    const res = await fetch(
+      `${getApiUrl()}/finance/transactions/${id}/receipt`,
+      { headers, credentials: "include" }
+    );
+    if (!res.ok) {
+      const body = await res.json().catch(() => null);
+      throw new Error(
+        body?.message || `Could not download the receipt (${res.status})`
+      );
+    }
+    return res.blob();
+  },
+  refundTransaction: (tenantSlug, id, data) => apiFetch(`/finance/transactions/${id}/refund`, {
+    tenantSlug,
+    method: "POST",
+    body: JSON.stringify(data ?? {})
+  }),
+  getAnalytics: (tenantSlug, params) => {
+    const searchParams = new URLSearchParams();
+    if (params?.startDate) searchParams.set("startDate", params.startDate);
+    if (params?.endDate) searchParams.set("endDate", params.endDate);
+    if (params?.period) searchParams.set("period", params.period);
+    const query = searchParams.toString() ? `?${searchParams.toString()}` : "";
+    return apiFetch(`/finance/dashboard${query}`, {
+      tenantSlug
+    });
+  },
+  /**
+   * What a sale of this size costs, worked out by the api rather than by us.
+   *
+   * The rate is a policy that changes per plan, so any figure the dashboard
+   * computes for itself is a second source that can only drift from the one
+   * the merchant is actually on — which is exactly why the payouts card
+   * stopped restating "0.5% / 1.5% + N100" as literal strings. This asks.
+   *
+   * `transactionCharge` is what gets ADDED TO THE CUSTOMER'S TOTAL, so it is 0
+   * whenever the merchant absorbs fees. That is the endpoint's whole meaning
+   * and it is easy to misread as "this sale is free to you": when the merchant
+   * bears the fee it comes out of the payout instead, and this route does not
+   * report that figure.
+   */
+  getCharges: (tenantSlug, amount) => apiFetch(`/payments/charges?amount=${encodeURIComponent(String(amount))}`, {
+    tenantSlug
+  })
+};
+export {
+  financeApi
+};
+//# sourceMappingURL=finance.js.map

package/dist/api/finance.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/finance.ts"],"sourcesContent":["import { apiFetch, getApiUrl, getAccountId } from './core';\nimport type {\n  Transaction,\n  FinanceAnalytics,\n  PaymentExceptions,\n  TransactionTimeline,\n  OfflineCapture,\n  WebhookFailure,\n  PaymentDiscrepancy,\n  OverdrawnAccount,\n} from './types';\n\nexport const financeApi = {\n  // Transactions\n  listTransactions: (\n    tenantSlug: string,\n    params?: {\n      status?: string;\n      type?: string;\n      search?: string;\n      page?: number;\n      limit?: number;\n      startDate?: string;\n      endDate?: string;\n      orderId?: string;\n    },\n  ) => {\n    const searchParams = new URLSearchParams();\n    if (params?.status) searchParams.set('status', params.status);\n    if (params?.type) searchParams.set('type', params.type);\n    if (params?.search) searchParams.set('search', params.search);\n    if (params?.page) searchParams.set('page', String(params.page));\n    if (params?.limit) searchParams.set('limit', String(params.limit));\n    if (params?.startDate) searchParams.set('startDate', params.startDate);\n    if (params?.endDate) searchParams.set('endDate', params.endDate);\n    if (params?.orderId) searchParams.set('orderId', params.orderId);\n    const query = searchParams.toString() ? `?${searchParams.toString()}` : '';\n    return apiFetch<{\n      transactions: Transaction[];\n      pagination: {\n        total: number;\n        page: number;\n        limit: number;\n        totalPages: number;\n      };\n    }>(`/finance/transactions${query}`, { tenantSlug });\n  },\n\n  exportTransactions: (\n    tenantSlug: string,\n    params?: {\n      status?: string;\n      type?: string;\n      search?: string;\n      startDate?: string;\n      endDate?: string;\n    },\n  ) => {\n    const searchParams = new URLSearchParams();\n    if (params?.status) searchParams.set('status', params.status);\n    if (params?.type) searchParams.set('type', params.type);\n    if (params?.search) searchParams.set('search', params.search);\n    if (params?.startDate) searchParams.set('startDate', params.startDate);\n    if (params?.endDate) searchParams.set('endDate', params.endDate);\n    const query = searchParams.toString() ? `?${searchParams}` : '';\n    return apiFetch<string>(`/finance/transactions/export${query}`, {\n      tenantSlug,\n    });\n  },\n\n  getTransaction: (tenantSlug: string, id: string) =>\n    apiFetch<Transaction>(`/finance/transactions/${id}`, { tenantSlug }),\n\n  /**\n   * Everything about this merchant's money that is not going as it should.\n   *\n   * The screen could only ever show the happy path — a payment stuck pending\n   * looked like a payment, and a refund the provider never confirmed looked\n   * settled. This is the answer to \"is anything wrong\", which is the question\n   * the surface is actually opened to ask.\n   */\n  getExceptions: (tenantSlug: string) =>\n    apiFetch<PaymentExceptions>('/finance/exceptions', { tenantSlug }),\n\n  /**\n   * The offline payments somebody has to say yes or no to.\n   *\n   * Its own call rather than part of the summary: the summary is drawn on every\n   * visit and this is opened on purpose, so making the count cost every row\n   * would be paying for the second question to answer the first.\n   */\n  getOfflineCaptures: (tenantSlug: string) =>\n    apiFetch<{ captures: OfflineCapture[] }>('/finance/offline-captures', {\n      tenantSlug,\n    }),\n\n  /**\n   * Say whether money a device took offline ever arrived.\n   *\n   * A decision, not a lookup. There is no provider record to check — the charge\n   * happened on the machine — so this records what the merchant established and\n   * who established it.\n   */\n  resolveOfflineCapture: (\n    tenantSlug: string,\n    id: string,\n    data: { outcome: 'collected' | 'not_collected'; note?: string },\n  ) =>\n    apiFetch<{ transactionId: string; status: string; message: string }>(\n      `/finance/transactions/${id}/resolve-offline`,\n      { tenantSlug, method: 'POST', body: JSON.stringify(data) },\n    ),\n\n  /**\n   * Customers who spent more than they had.\n   *\n   * Only ever created offline, so each is somebody who walked away having had\n   * more than they paid for.\n   */\n  getOverdrawn: (tenantSlug: string) =>\n    apiFetch<{ accounts: OverdrawnAccount[] }>('/credentials/overdrawn', {\n      tenantSlug,\n    }),\n\n  /**\n   * Decide an overdraft is not worth chasing.\n   *\n   * Recorded as a movement somebody made rather than an edit to a number — a\n   * debt that vanished with no record is indistinguishable from one that was\n   * never there.\n   */\n  writeOffOverdraft: (\n    tenantSlug: string,\n    data: { memberId: string; note?: string },\n  ) =>\n    apiFetch<{ memberId: string; balance: number }>('/credentials/write-off', {\n      tenantSlug,\n      method: 'POST',\n      body: JSON.stringify(data),\n    }),\n\n  /** The reconciliation findings somebody has to work through. */\n  getDiscrepancies: (tenantSlug: string) =>\n    apiFetch<{ discrepancies: PaymentDiscrepancy[] }>(\n      '/finance/discrepancies',\n      { tenantSlug },\n    ),\n\n  /**\n   * Close a finding.\n   *\n   * `resolved` and `ignored` are kept apart deliberately: one says the problem\n   * was dealt with, the other says somebody decided to live with it, and in\n   * three months that is the only distinction worth having. Neither changes a\n   * figure — a button that made two records agree would be a way to make the\n   * books say whatever is convenient.\n   */\n  resolveDiscrepancy: (\n    tenantSlug: string,\n    id: string,\n    data: { status: 'resolved' | 'ignored'; note?: string },\n  ) =>\n    apiFetch<{ id: string; status: string }>(\n      `/finance/discrepancies/${id}/resolve`,\n      { tenantSlug, method: 'POST', body: JSON.stringify(data) },\n    ),\n\n  /**\n   * Ask the bank what happened to refunds it never confirmed.\n   *\n   * Nothing here decides anything — it applies what the bank says, down the\n   * same path a confirmation would have taken.\n   */\n  recheckRefunds: (tenantSlug: string) =>\n    apiFetch<{\n      checked: number;\n      settled: number;\n      failed: number;\n      stillPending: number;\n    }>('/finance/refunds/recheck', { tenantSlug, method: 'POST' }),\n\n  /** Payments we could not finish recording. */\n  getWebhookFailures: (tenantSlug: string) =>\n    apiFetch<{ failures: WebhookFailure[]; total: number }>(\n      '/finance/webhook-failures',\n      { tenantSlug },\n    ),\n\n  /**\n   * Try one again.\n   *\n   * Safe to re-run because the ledger refuses a second row for the same\n   * payment — replaying something already applied changes nothing.\n   */\n  replayWebhookFailure: (tenantSlug: string, id: string) =>\n    apiFetch<{ replayed: boolean; message: string }>(\n      `/finance/webhook-failures/${id}/replay`,\n      { tenantSlug, method: 'POST' },\n    ),\n\n  /**\n   * Everything that happened to one transaction, oldest first.\n   *\n   * A status is overwritten in place, so the detail screen could show one word\n   * and no history: a payment that declined, was retried, cleared, then was\n   * half refunded read as \"partially refunded\" and nothing else.\n   */\n  getTransactionTimeline: (tenantSlug: string, id: string) =>\n    apiFetch<TransactionTimeline>(`/finance/transactions/${id}/timeline`, {\n      tenantSlug,\n    }),\n\n  /** Refund a transaction — full (omit amount) or partial. */\n  /**\n   * Email the customer this payment's receipt.\n   *\n   * No address argument, deliberately: the API sends to the address on the\n   * transaction and ignores anything else, so offering one here would imply a\n   * choice the merchant does not have.\n   */\n  sendReceipt: (tenantSlug: string, id: string) =>\n    apiFetch<{ sent: boolean; to: string }>(\n      `/finance/transactions/${id}/receipt`,\n      { tenantSlug, method: 'POST' },\n    ),\n\n  /**\n   * This payment's receipt as a PDF.\n   *\n   * A blob, so it goes around `apiFetch` (which parses JSON), the same way the\n   * invoice PDF does. The API refuses a payment that did not go through, and\n   * that refusal arrives here as a sentence worth showing.\n   */\n  downloadReceipt: async (tenantSlug: string, id: string): Promise<Blob> => {\n    const headers: Record<string, string> = {};\n    if (tenantSlug) headers['X-Tenant-Slug'] = tenantSlug;\n    const accountId = getAccountId();\n    if (accountId) headers['x-account-id'] = accountId;\n\n    const res = await fetch(\n      `${getApiUrl()}/finance/transactions/${id}/receipt`,\n      { headers, credentials: 'include' },\n    );\n    if (!res.ok) {\n      const body = await res.json().catch(() => null);\n      throw new Error(\n        body?.message || `Could not download the receipt (${res.status})`,\n      );\n    }\n\n    return res.blob();\n  },\n\n  refundTransaction: (\n    tenantSlug: string,\n    id: string,\n    data?: { amount?: number; reason?: string },\n  ) =>\n    apiFetch<{\n      refundId: string;\n      reference: string;\n      amount: number;\n      currency: string;\n      status: string;\n      message: string;\n    }>(`/finance/transactions/${id}/refund`, {\n      tenantSlug,\n      method: 'POST',\n      body: JSON.stringify(data ?? {}),\n    }),\n\n  getAnalytics: (\n    tenantSlug: string,\n    params?: { startDate?: string; endDate?: string; period?: string },\n  ) => {\n    const searchParams = new URLSearchParams();\n    if (params?.startDate) searchParams.set('startDate', params.startDate);\n    if (params?.endDate) searchParams.set('endDate', params.endDate);\n    if (params?.period) searchParams.set('period', params.period);\n    const query = searchParams.toString() ? `?${searchParams.toString()}` : '';\n    return apiFetch<FinanceAnalytics>(`/finance/dashboard${query}`, {\n      tenantSlug,\n    });\n  },\n\n  /**\n   * What a sale of this size costs, worked out by the api rather than by us.\n   *\n   * The rate is a policy that changes per plan, so any figure the dashboard\n   * computes for itself is a second source that can only drift from the one\n   * the merchant is actually on — which is exactly why the payouts card\n   * stopped restating \"0.5% / 1.5% + N100\" as literal strings. This asks.\n   *\n   * `transactionCharge` is what gets ADDED TO THE CUSTOMER'S TOTAL, so it is 0\n   * whenever the merchant absorbs fees. That is the endpoint's whole meaning\n   * and it is easy to misread as \"this sale is free to you\": when the merchant\n   * bears the fee it comes out of the payout instead, and this route does not\n   * report that figure.\n   */\n  getCharges: (tenantSlug: string, amount: number) =>\n    apiFetch<{\n      chargeBearer: 'merchant' | 'customer';\n      transactionCharge: number;\n      breakdown?: { paystackFee: number; potterMargin: number };\n    }>(`/payments/charges?amount=${encodeURIComponent(String(amount))}`, {\n      tenantSlug,\n    }),\n};\n"],"mappings":"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","names":[]}

package/dist/api/gallery.d.ts

@@ -0,0 +1,30 @@
+import type { GalleryItemStatus, GalleryItem, GalleryListResponse, GalleryQuery } from './types';
+/** The counts the API keeps for a tenant's gallery. */
+export interface GalleryStats {
+    totalItems: number;
+    imageCount: number;
+    videoCount: number;
+    featuredCount: number;
+    beforeAfterCount: number;
+    totalSizeBytes: number;
+    categoryCounts: Record<string, number>;
+}
+export declare const galleryApi: {
+    getStats: (tenantSlug: string) => Promise<GalleryStats>;
+    list: (tenantSlug: string, query?: GalleryQuery) => Promise<GalleryListResponse>;
+    categories: (tenantSlug: string) => Promise<string[]>;
+    create: (tenantSlug: string, body: Partial<GalleryItem> & {
+        url: string;
+    }) => Promise<GalleryItem>;
+    /**
+     * `PUT`, which is what the controller serves. It was `PATCH`, and there is no
+     * `@Patch(':id')` on the gallery controller — so both edits on Website →
+     * Gallery (the caption and the featured toggle) went nowhere.
+     */
+    update: (tenantSlug: string, id: string, body: Partial<GalleryItem>) => Promise<GalleryItem>;
+    remove: (tenantSlug: string, id: string) => Promise<void>;
+    /** Persist a drag-reorder. Order of `ids` is the new `sortOrder`. */
+    reorder: (tenantSlug: string, ids: string[]) => Promise<void>;
+    setStatus: (tenantSlug: string, ids: string[], status: GalleryItemStatus) => Promise<void>;
+};
+/** The rails a commitment can arrive on. Mirrors CommerceSource on the API. */

package/dist/api/gallery.js

@@ -0,0 +1,48 @@
+import { apiFetch } from "./core";
+const galleryApi = {
+  getStats: (tenantSlug) => apiFetch("/gallery/stats", { tenantSlug }),
+  list: (tenantSlug, query = {}) => {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== void 0 && value !== "") params.set(key, String(value));
+    }
+    const qs = params.toString();
+    return apiFetch(`/gallery${qs ? `?${qs}` : ""}`, {
+      tenantSlug
+    });
+  },
+  categories: (tenantSlug) => apiFetch("/gallery/categories", { tenantSlug }),
+  create: (tenantSlug, body) => apiFetch("/gallery", {
+    method: "POST",
+    tenantSlug,
+    body: JSON.stringify(body)
+  }),
+  /**
+   * `PUT`, which is what the controller serves. It was `PATCH`, and there is no
+   * `@Patch(':id')` on the gallery controller — so both edits on Website →
+   * Gallery (the caption and the featured toggle) went nowhere.
+   */
+  update: (tenantSlug, id, body) => apiFetch(`/gallery/${id}`, {
+    method: "PUT",
+    tenantSlug,
+    body: JSON.stringify(body)
+  }),
+  remove: (tenantSlug, id) => apiFetch(`/gallery/${id}`, { method: "DELETE", tenantSlug }),
+  /** Persist a drag-reorder. Order of `ids` is the new `sortOrder`. */
+  reorder: (tenantSlug, ids) => apiFetch("/gallery/reorder", {
+    method: "POST",
+    tenantSlug,
+    body: JSON.stringify({
+      items: ids.map((id, i) => ({ id, sortOrder: i }))
+    })
+  }),
+  setStatus: (tenantSlug, ids, status) => apiFetch("/gallery/set-status", {
+    method: "POST",
+    tenantSlug,
+    body: JSON.stringify({ ids, status })
+  })
+};
+export {
+  galleryApi
+};
+//# sourceMappingURL=gallery.js.map

package/dist/api/gallery.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/gallery.ts"],"sourcesContent":["import { apiFetch } from './core';\nimport type {\n  GalleryItemStatus,\n  GalleryItem,\n  GalleryListResponse,\n  GalleryQuery,\n} from './types';\n\n/** The counts the API keeps for a tenant's gallery. */\nexport interface GalleryStats {\n  totalItems: number;\n  imageCount: number;\n  videoCount: number;\n  featuredCount: number;\n  beforeAfterCount: number;\n  totalSizeBytes: number;\n  categoryCounts: Record<string, number>;\n}\n\nexport const galleryApi = {\n  getStats: (tenantSlug: string) =>\n    apiFetch<GalleryStats>('/gallery/stats', { tenantSlug }),\n\n  list: (tenantSlug: string, query: GalleryQuery = {}) => {\n    const params = new URLSearchParams();\n    for (const [key, value] of Object.entries(query)) {\n      if (value !== undefined && value !== '') params.set(key, String(value));\n    }\n    const qs = params.toString();\n    return apiFetch<GalleryListResponse>(`/gallery${qs ? `?${qs}` : ''}`, {\n      tenantSlug,\n    });\n  },\n\n  categories: (tenantSlug: string) =>\n    apiFetch<string[]>('/gallery/categories', { tenantSlug }),\n\n  create: (tenantSlug: string, body: Partial<GalleryItem> & { url: string }) =>\n    apiFetch<GalleryItem>('/gallery', {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify(body),\n    }),\n\n  /**\n   * `PUT`, which is what the controller serves. It was `PATCH`, and there is no\n   * `@Patch(':id')` on the gallery controller — so both edits on Website →\n   * Gallery (the caption and the featured toggle) went nowhere.\n   */\n  update: (tenantSlug: string, id: string, body: Partial<GalleryItem>) =>\n    apiFetch<GalleryItem>(`/gallery/${id}`, {\n      method: 'PUT',\n      tenantSlug,\n      body: JSON.stringify(body),\n    }),\n\n  remove: (tenantSlug: string, id: string) =>\n    apiFetch<void>(`/gallery/${id}`, { method: 'DELETE', tenantSlug }),\n\n  /** Persist a drag-reorder. Order of `ids` is the new `sortOrder`. */\n  reorder: (tenantSlug: string, ids: string[]) =>\n    apiFetch<void>('/gallery/reorder', {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify({\n        items: ids.map((id, i) => ({ id, sortOrder: i })),\n      }),\n    }),\n\n  setStatus: (tenantSlug: string, ids: string[], status: GalleryItemStatus) =>\n    apiFetch<void>('/gallery/set-status', {\n      method: 'POST',\n      tenantSlug,\n      body: JSON.stringify({ ids, status }),\n    }),\n};\n\n// ============================================\n// COMMERCE — every rail as one list\n// ============================================\n\n/** The rails a commitment can arrive on. Mirrors CommerceSource on the API. */\n"],"mappings":"AAAA,SAAS,gBAAgB;AAmBlB,MAAM,aAAa;AAAA,EACxB,UAAU,CAAC,eACT,SAAuB,kBAAkB,EAAE,WAAW,CAAC;AAAA,EAEzD,MAAM,CAAC,YAAoB,QAAsB,CAAC,MAAM;AACtD,UAAM,SAAS,IAAI,gBAAgB;AACnC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AAChD,UAAI,UAAU,UAAa,UAAU,GAAI,QAAO,IAAI,KAAK,OAAO,KAAK,CAAC;AAAA,IACxE;AACA,UAAM,KAAK,OAAO,SAAS;AAC3B,WAAO,SAA8B,WAAW,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI;AAAA,MACpE;AAAA,IACF,CAAC;AAAA,EACH;AAAA,EAEA,YAAY,CAAC,eACX,SAAmB,uBAAuB,EAAE,WAAW,CAAC;AAAA,EAE1D,QAAQ,CAAC,YAAoB,SAC3B,SAAsB,YAAY;AAAA,IAChC,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOH,QAAQ,CAAC,YAAoB,IAAY,SACvC,SAAsB,YAAY,EAAE,IAAI;AAAA,IACtC,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,KAAK,UAAU,IAAI;AAAA,EAC3B,CAAC;AAAA,EAEH,QAAQ,CAAC,YAAoB,OAC3B,SAAe,YAAY,EAAE,IAAI,EAAE,QAAQ,UAAU,WAAW,CAAC;AAAA;AAAA,EAGnE,SAAS,CAAC,YAAoB,QAC5B,SAAe,oBAAoB;AAAA,IACjC,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,KAAK,UAAU;AAAA,MACnB,OAAO,IAAI,IAAI,CAAC,IAAI,OAAO,EAAE,IAAI,WAAW,EAAE,EAAE;AAAA,IAClD,CAAC;AAAA,EACH,CAAC;AAAA,EAEH,WAAW,CAAC,YAAoB,KAAe,WAC7C,SAAe,uBAAuB;AAAA,IACpC,QAAQ;AAAA,IACR;AAAA,IACA,MAAM,KAAK,UAAU,EAAE,KAAK,OAAO,CAAC;AAAA,EACtC,CAAC;AACL;","names":[]}

package/dist/api/geo.d.ts

@@ -0,0 +1,18 @@
+export declare const geoApi: {
+    countries: () => Promise<{
+        code: string;
+        name: string;
+    }[]>;
+    states: (countryCode: string) => Promise<string[]>;
+    cities: (countryCode: string, state: string) => Promise<string[]>;
+    geocode: (query: string, countryCode?: string) => Promise<{
+        lat: number;
+        lng: number;
+        displayName: string;
+        name?: string;
+        address?: string;
+        city?: string;
+        state?: string;
+        country?: string;
+    }[]>;
+};

package/dist/api/geo.js

@@ -0,0 +1,19 @@
+import { apiFetch } from "./core";
+const geoApi = {
+  countries: () => apiFetch("/geo/countries"),
+  states: (countryCode) => apiFetch(
+    `/geo/states?country=${encodeURIComponent(countryCode)}`
+  ),
+  cities: (countryCode, state) => apiFetch(
+    `/geo/cities?country=${encodeURIComponent(countryCode)}&state=${encodeURIComponent(state)}`
+  ),
+  geocode: (query, countryCode) => {
+    const params = new URLSearchParams({ q: query });
+    if (countryCode) params.append("country", countryCode);
+    return apiFetch(`/geo/geocode?${params}`);
+  }
+};
+export {
+  geoApi
+};
+//# sourceMappingURL=geo.js.map

package/dist/api/geo.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/api/geo.ts"],"sourcesContent":["import { apiFetch } from './core';\n\n// =============================================================================\n// GEO REFERENCE API\n// =============================================================================\n\nexport const geoApi = {\n  countries: () => apiFetch<{ code: string; name: string }[]>('/geo/countries'),\n\n  states: (countryCode: string) =>\n    apiFetch<string[]>(\n      `/geo/states?country=${encodeURIComponent(countryCode)}`,\n    ),\n\n  cities: (countryCode: string, state: string) =>\n    apiFetch<string[]>(\n      `/geo/cities?country=${encodeURIComponent(countryCode)}&state=${encodeURIComponent(state)}`,\n    ),\n\n  geocode: (query: string, countryCode?: string) => {\n    const params = new URLSearchParams({ q: query });\n    if (countryCode) params.append('country', countryCode);\n    return apiFetch<\n      {\n        lat: number;\n        lng: number;\n        displayName: string;\n        name?: string;\n        address?: string;\n        city?: string;\n        state?: string;\n        country?: string;\n      }[]\n    >(`/geo/geocode?${params}`);\n  },\n};\n\n// =============================================================================\n// LOCATIONS API\n// =============================================================================\n"],"mappings":"AAAA,SAAS,gBAAgB;AAMlB,MAAM,SAAS;AAAA,EACpB,WAAW,MAAM,SAA2C,gBAAgB;AAAA,EAE5E,QAAQ,CAAC,gBACP;AAAA,IACE,uBAAuB,mBAAmB,WAAW,CAAC;AAAA,EACxD;AAAA,EAEF,QAAQ,CAAC,aAAqB,UAC5B;AAAA,IACE,uBAAuB,mBAAmB,WAAW,CAAC,UAAU,mBAAmB,KAAK,CAAC;AAAA,EAC3F;AAAA,EAEF,SAAS,CAAC,OAAe,gBAAyB;AAChD,UAAM,SAAS,IAAI,gBAAgB,EAAE,GAAG,MAAM,CAAC;AAC/C,QAAI,YAAa,QAAO,OAAO,WAAW,WAAW;AACrD,WAAO,SAWL,gBAAgB,MAAM,EAAE;AAAA,EAC5B;AACF;","names":[]}