@takeal/cusfront-sdk 0.1.0

package/dist/resources/cards.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/cards.ts"],"names":[],"mappings":";AAkIO,IAAM,gBAAN,MAAoB;AAAA,EACzB,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAQhD,MAAM,OAAO,KAAA,EAAuC;AAClD,IAAA,MAAM,EAAE,cAAA,EAAgB,GAAG,IAAA,EAAK,GAAI,KAAA;AACpC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAAW,WAAA,EAAa;AAAA,MACvC,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,IAAI,EAAA,EAA2B;AACnC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAU,aAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EAClE;AAAA;AAAA,EAGA,MAAM,IAAA,GAAwB;AAC5B,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAY,WAAW,CAAA;AAAA,EAC1C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,OAAA,CAAQ,EAAA,EAAY,QAAA,EAAwC;AAChE,IAAA,MAAM,IAAI,IAAI,eAAA,CAAgB,EAAE,QAAA,EAAU,EAAE,QAAA,EAAS;AACrD,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA;AAAA,MACf,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,YAAY,CAAC,CAAA;AAAA,KAClD;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAA,CAAO,EAAA,EAAY,MAAA,EAAgC;AACvD,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA;AAAA,MACnC,EAAE,IAAA,EAAM,EAAE,MAAA,EAAO;AAAE,KACrB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,MAAA,CAAO,EAAA,EAAY,KAAA,EAA+C;AACtE,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA,OAAA,CAAA;AAAA,MACnC,EAAE,MAAM,EAAE,QAAA,EAAU,MAAM,QAAA,EAAU,SAAA,EAAW,KAAA,CAAM,QAAA,EAAS;AAAE,KAClE;AAAA,EACF;AAAA;AAAA,EAGA,MAAM,SAAS,EAAA,EAA2B;AACxC,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA,SAAA,CAAA;AAAA,MACnC,EAAE,IAAA,EAAM,EAAC;AAAE,KACb;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,SAAA,CAAU,EAAA,EAAY,MAAA,EAAgC;AAC1D,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,UAAA,EAAa,kBAAA,CAAmB,EAAE,CAAC,CAAA,UAAA,CAAA;AAAA,MACnC,EAAE,IAAA,EAAM,EAAE,MAAA,EAAO;AAAE,KACrB;AAAA,EACF;AACF","file":"cards.js","sourcesContent":["import type { HttpClient } from \"../http.js\";\nimport type { CustomerInfo } from \"../types/customer.js\";\n\n/**\n * Cards resource — `client.cards.*`.\n *\n * The end-user \"money OUT\" surface: a user issues themselves a card backed by\n * their wallet balance via an issuer connector. Mirrors the Takeal API's\n * `/me/cards` routes:\n *\n *   POST   /me/cards                 → create\n *   GET    /me/cards                 → list (most recent first)\n *   GET    /me/cards/{id}            → get\n *   GET    /me/cards/{id}/balance    → balance (prepaid remaining)\n *   POST   /me/cards/{id}/freeze     → freeze\n *   POST   /me/cards/{id}/unfreeze   → unfreeze\n *   POST   /me/cards/{id}/terminate  → terminate (one-way)\n *\n * The lifecycle actions are ownership-gated server-side: a caller can only\n * freeze / unfreeze / terminate a card that belongs to them (else 404).\n *\n * ## What is intentionally NOT here\n *\n * Card-data reveal (PAN / CVV) is a separate, security-sensitive flow with its\n * own re-auth + rate-limit + audit contract and is intentionally\n * NOT part of this resource (tracked separately).\n *\n * Today only PREPAID is wired end-to-end; CREDIT and GIFT return 400 from\n * the Takeal API until their issuer flows land.\n */\n\n/** Card product. Only `prepaid` is fully implemented today. */\nexport type CardType = \"credit\" | \"prepaid\" | \"gift\";\n\n/**\n * Card lifecycle state.\n *\n * `pending_payment` is a transient state: the row exists but the\n * per-card issuance-fee debit has not yet succeeded; such cards have no\n * provider reference and no user-visible side effects.\n */\nexport type CardStatus =\n  | \"pending_payment\"\n  | \"active\"\n  | \"frozen\"\n  | \"terminated\"\n  | \"redeemed\"\n  | \"failed\";\n\n/**\n * A card record as the Takeal API returns it. Mirrors the `cards` table. Note the\n * SDK never receives the full PAN or CVV here — only `last4` + expiry. The\n * gift-card `redemption_code` is returned exactly once (on create) and\n * scrubbed from subsequent list/get responses.\n */\nexport interface Card {\n  id: string;\n  user_id: string;\n  card_type: CardType;\n  /** Slug of the issuer that minted this card, as configured by the deployment. */\n  connector_slug: string;\n  /** The connector's own reference, populated once it responds. */\n  provider_reference: string | null;\n  status: CardStatus;\n  /** Last four digits of the PAN — safe to display. */\n  last4: string | null;\n  expiry_month: number | null;\n  expiry_year: number | null;\n  /** Gift cards only, present once on create then scrubbed. */\n  redemption_code?: string;\n  /** Decimal as a string. */\n  initial_amount: string | null;\n  currency: string;\n  failure_reason: string | null;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface CreateCardInput {\n  /** `prepaid` (the only fully-wired type today), `credit`, or `gift`. */\n  type: CardType;\n  /** Decimal as a string. The prepaid load amount drained from wallet balance. */\n  initial_amount?: string;\n  /** ISO 4217 code, e.g. `\"USD\"`. */\n  currency: string;\n  /**\n   * Optional. Slug of a specific issuer to mint with. Omit to let\n   * the Takeal API pick the first active issuer. Unknown slug → 400; empty issuer\n   * list → 503.\n   */\n  issuer_slug?: string;\n  metadata?: Record<string, string>;\n  /** Structured billing details — real issuers require these for 3DS / KYC. */\n  customer?: CustomerInfo;\n  /**\n   * Required by the Takeal API on this write endpoint. Same key + body replays the\n   * original card; same key + different body returns 409.\n   */\n  idempotencyKey: string;\n}\n\n/** Remaining balance of a prepaid card. */\nexport interface CardBalance {\n  amount: string;\n  currency: string;\n}\n\n/** Re-auth gate for {@link CardsResource.reveal}. */\nexport interface RevealCardInput {\n  /** The user's account password — mandatory re-auth. */\n  password: string;\n  /** TOTP code; required only when the user has TOTP enrolled. */\n  totpCode?: string;\n}\n\n/**\n * Full card data from a successful reveal. **Security**: never persist this —\n * keep it in volatile memory only, clear it within `expires_in_seconds`, and\n * never write it to localStorage / logs (the API marks the response no-store).\n */\nexport interface RevealedCard {\n  pan: string;\n  cvv: string;\n  expiry_month: number;\n  expiry_year: number;\n  holder_name: string;\n  /** Display window before the client should auto-clear the data. */\n  expires_in_seconds: number;\n}\n\nexport class CardsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Issue a card backed by the user's wallet balance. Resolves to the new\n   * `Card`. On a ledger failure after provider creation, the Takeal API rolls the row\n   * to `failed` (never an orphaned active card); inspect `status` /\n   * `failure_reason` on the result.\n   */\n  async create(input: CreateCardInput): Promise<Card> {\n    const { idempotencyKey, ...body } = input;\n    return this.http.post<Card>(\"/me/cards\", {\n      body,\n      idempotencyKey,\n    });\n  }\n\n  /** Fetch one card by id. */\n  async get(id: string): Promise<Card> {\n    return this.http.get<Card>(`/me/cards/${encodeURIComponent(id)}`);\n  }\n\n  /** List the caller's cards, most recent first. */\n  async list(): Promise<Card[]> {\n    return this.http.get<Card[]>(\"/me/cards\");\n  }\n\n  /**\n   * Remaining balance of a prepaid card. `currency` is required by the Takeal API and\n   * forwarded as a query param.\n   */\n  async balance(id: string, currency: string): Promise<CardBalance> {\n    const q = new URLSearchParams({ currency }).toString();\n    return this.http.get<CardBalance>(\n      `/me/cards/${encodeURIComponent(id)}/balance?${q}`,\n    );\n  }\n\n  /**\n   * Freeze the caller's own card. Reversible via {@link unfreeze}. The optional\n   * `reason` is recorded on the audit trail. Resolves to the updated card.\n   * 404 if the card isn't the caller's; 501 if the issuer can't freeze.\n   */\n  async freeze(id: string, reason?: string): Promise<Card> {\n    return this.http.post<Card>(\n      `/me/cards/${encodeURIComponent(id)}/freeze`,\n      { body: { reason } },\n    );\n  }\n\n  /**\n   * Reveal the FULL PAN + CVV for the caller's own card. Re-auth gated\n   * (password, + TOTP when the user has it enrolled) and rate-limited\n   * server-side. The Takeal API never persists this data and marks the\n   * response no-store; the SDK returns it verbatim and holds nothing.\n   *\n   * **Consumer security duties** (the SDK can't enforce these for you):\n   * keep the result in volatile memory only, never write it to\n   * localStorage / logs, and clear it within `expires_in_seconds`.\n   *\n   * 401 bad re-auth · 403 not your card · 429 rate-limited · 501 connector\n   * has no sensitive-data endpoint · 503 provider error.\n   */\n  async reveal(id: string, input: RevealCardInput): Promise<RevealedCard> {\n    return this.http.post<RevealedCard>(\n      `/me/cards/${encodeURIComponent(id)}/reveal`,\n      { body: { password: input.password, totp_code: input.totpCode } },\n    );\n  }\n\n  /** Unfreeze a previously-frozen card. Idempotent on an already-active card. */\n  async unfreeze(id: string): Promise<Card> {\n    return this.http.post<Card>(\n      `/me/cards/${encodeURIComponent(id)}/unfreeze`,\n      { body: {} },\n    );\n  }\n\n  /**\n   * Terminate the caller's own card. **One-way** — a terminated card cannot be\n   * reactivated. The optional `reason` is audited. Idempotent on an\n   * already-terminated card.\n   */\n  async terminate(id: string, reason?: string): Promise<Card> {\n    return this.http.post<Card>(\n      `/me/cards/${encodeURIComponent(id)}/terminate`,\n      { body: { reason } },\n    );\n  }\n}\n"]}

package/dist/resources/deposits.cjs

@@ -0,0 +1,52 @@
+'use strict';
+
+// src/resources/deposits.ts
+var DepositsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Initiate a top-up. Resolves to the freshly-created `Deposit`, whose
+   * `status` may already be `confirmed` (synchronous rails / mock) or
+   * `redirect_required` (3DS / APM — forward the user to `redirect_url`).
+   */
+  /**
+   * Price a cross-currency deposit BEFORE paying. The rate is locked
+   * server-side until `expires_at`; deposits in the local currency need no
+   * quote (the API answers 400 `no_quote_needed`).
+   */
+  async quote(input) {
+    return this.http.post("/me/deposits/quotes", { body: input });
+  }
+  async initiate(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.post("/me/deposits", {
+      body,
+      idempotencyKey
+    });
+  }
+  /** Fetch one deposit by id — the poll target while a redirect resolves. */
+  async get(id) {
+    return this.http.get(`/me/deposits/${encodeURIComponent(id)}`);
+  }
+  /** List the caller's deposits, most recent first. */
+  async list() {
+    return this.http.get("/me/deposits");
+  }
+  /**
+   * Refund a previously-confirmed deposit. Synchronous when the
+   * connector settles inline; otherwise the row stays `pending` and flips
+   * later via the inbound `deposit.refunded` event.
+   */
+  async refund(depositId, input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.post(
+      `/me/deposits/${encodeURIComponent(depositId)}/refunds`,
+      { body, idempotencyKey }
+    );
+  }
+};
+
+exports.DepositsResource = DepositsResource;
+//# sourceMappingURL=deposits.cjs.map
+//# sourceMappingURL=deposits.cjs.map

package/dist/resources/deposits.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/deposits.ts"],"names":[],"mappings":";;;AAyJO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYhD,MAAM,MAAM,KAAA,EAAgD;AAC1D,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA,CAAmB,uBAAuB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5E;AAAA,EAEA,MAAM,SAAS,KAAA,EAA+C;AAC5D,IAAA,MAAM,EAAE,cAAA,EAAgB,GAAG,IAAA,EAAK,GAAI,KAAA;AACpC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAAc,cAAA,EAAgB;AAAA,MAC7C,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,IAAI,EAAA,EAA8B;AACtC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAa,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA,EAGA,MAAM,IAAA,GAA2B;AAC/B,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAe,cAAc,CAAA;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAA,CACJ,SAAA,EACA,KAAA,EACiB;AACjB,IAAA,MAAM,EAAE,cAAA,EAAgB,GAAG,IAAA,EAAK,GAAI,KAAA;AACpC,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,aAAA,EAAgB,kBAAA,CAAmB,SAAS,CAAC,CAAA,QAAA,CAAA;AAAA,MAC7C,EAAE,MAAM,cAAA;AAAe,KACzB;AAAA,EACF;AACF","file":"deposits.cjs","sourcesContent":["import type { HttpClient } from \"../http.js\";\nimport type { CustomerInfo } from \"../types/customer.js\";\n\n/**\n * Deposits resource — `client.deposits.*`.\n *\n * The \"money IN\" surface: an end user tops up their wallet balance via a\n * funder connector. Mirrors the Takeal API's `/me/deposits` routes:\n *\n *   POST   /me/deposits              → initiate\n *   GET    /me/deposits              → list (most recent first)\n *   GET    /me/deposits/{id}         → get\n *   POST   /me/deposits/{id}/refunds → refund\n *\n * A deposit is rarely terminal on the initiate call: real PSPs return\n * `redirect_required` (3DS / APM redirect) and flip to `confirmed` later via\n * a connector → Takeal API inbound event. Poll `get(id)` or watch the user's\n * webhook stream for the `deposit.confirmed` / `deposit.failed` outcome.\n */\n\n/** Lifecycle of a deposit. `redirect_required` carries `redirect_url`. */\nexport type DepositStatus =\n  | \"pending\"\n  | \"redirect_required\"\n  | \"confirmed\"\n  | \"failed\";\n\n/** Top-up rail. The chosen funder decides which it supports. */\nexport type DepositMethod = \"card\" | \"crypto\" | \"bank_transfer\";\n\n/**\n * A deposit record as the Takeal API returns it. Mirrors the `deposits` table; the\n * server-side `id` is the stable handle the SDK polls against. `idempotency_key`\n * and `request_fingerprint` are server-internal and never serialised.\n */\n/** Input for `quote()` — price a cross-currency deposit before paying. */\nexport interface CreateQuoteInput {\n  /** Decimal string, e.g. `\"5000.00\"`. */\n  amount: string;\n  /** ISO 4217 source currency — must differ from the wallet's local currency. */\n  currency: string;\n}\n\n/**\n * A rate-locked funding quote: pay `source_amount source_currency`, the\n * wallet is credited `credited_amount credited_currency` (net of the\n * platform's conversion spread). Execute by passing `id` as `quote_id` to\n * `initiate()` before `expires_at`; after that the API returns 409 and a new\n * quote is needed.\n */\nexport interface FundingQuote {\n  id: string;\n  source_amount: string;\n  source_currency: string;\n  credited_amount: string;\n  credited_currency: string;\n  /** Provider rate before spread (credited units per 1 source unit). */\n  rate: string;\n  spread_bps: number;\n  provider: string;\n  expires_at: string;\n}\n\nexport interface Deposit {\n  id: string;\n  user_id: string;\n  /** Slug of the funder that handled this deposit, as configured by the deployment. */\n  connector_slug: string;\n  /** The connector's own reference, populated once it responds. */\n  provider_reference: string | null;\n  status: DepositStatus;\n  /** Decimal serialised as a string to avoid float drift. */\n  amount: string;\n  currency: string;\n  method: DepositMethod;\n  /** Present when `status === \"redirect_required\"` — send the user here. */\n  redirect_url: string | null;\n  failure_reason: string | null;\n  /** Final settled amount once confirmed (may differ from `amount` on FX). */\n  confirmed_amount: string | null;\n  confirmed_at: string | null;\n  /** Set on cross-currency deposits: the quote this deposit executed against. */\n  quote_id?: string | null;\n  /** Locked provider rate (credited units per 1 source unit). */\n  fx_rate?: string | null;\n  fx_spread_bps?: number | null;\n  /** The wallet's local currency the deposit converted into. */\n  credited_currency?: string | null;\n  /** What the wallet was actually credited, net of spread. */\n  credited_amount?: string | null;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface InitiateDepositInput {\n  /** Decimal as a string (`\"100.00\"`) — avoids float-precision loss on the wire. */\n  amount: string;\n  /** ISO 4217 code, e.g. `\"USD\"`. */\n  currency: string;\n  method: DepositMethod;\n  /**\n   * Optional. Slug of a specific funder to route through. Omit to\n   * let the Takeal API pick the first active funder. Unknown slug → 400; empty\n   * funder list → 503.\n   */\n  funder_slug?: string;\n  /** Provider-specific extras. The mock funder reads `mock_scenario`. */\n  metadata?: Record<string, string>;\n  /** Structured billing details — real PSPs require these for 3DS / compliance. */\n  customer?: CustomerInfo;\n  /**\n   * Required by the Takeal API on this write endpoint. Same key + body replays the\n   * original deposit; same key + different body returns 409. Supply a stable\n   * UUID per logical attempt so a retried network call is safe.\n   */\n  idempotencyKey: string;\n  /**\n   * Required when `currency` differs from the wallet's local currency: a\n   * fresh quote id from `quote()`. Cross-currency deposits without one are\n   * rejected with 400; expired quotes with 409.\n   */\n  quote_id?: string;\n}\n\nexport interface CreateDepositRefundInput {\n  /** Omit for a full refund of the original confirmed amount; same currency. */\n  amount?: string;\n  /** Human-readable reason, e.g. `\"customer_request\"`. */\n  reason?: string;\n  metadata?: Record<string, string>;\n  /** Required. Replays are keyed on this. */\n  idempotencyKey: string;\n}\n\n/** A refund row as the Takeal API returns it (`refunds` table, deposit-targeted). */\nexport interface Refund {\n  id: string;\n  target_type: string;\n  deposit_id?: string;\n  payment_id?: string;\n  connector_slug: string;\n  amount: string;\n  currency: string;\n  reason: string;\n  status: string;\n  provider_refund_reference?: string;\n  failure_reason?: string;\n  requestor_type: string;\n  requestor_id: string;\n  created_at: string;\n  updated_at: string;\n}\n\nexport class DepositsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Initiate a top-up. Resolves to the freshly-created `Deposit`, whose\n   * `status` may already be `confirmed` (synchronous rails / mock) or\n   * `redirect_required` (3DS / APM — forward the user to `redirect_url`).\n   */\n  /**\n   * Price a cross-currency deposit BEFORE paying. The rate is locked\n   * server-side until `expires_at`; deposits in the local currency need no\n   * quote (the API answers 400 `no_quote_needed`).\n   */\n  async quote(input: CreateQuoteInput): Promise<FundingQuote> {\n    return this.http.post<FundingQuote>(\"/me/deposits/quotes\", { body: input });\n  }\n\n  async initiate(input: InitiateDepositInput): Promise<Deposit> {\n    const { idempotencyKey, ...body } = input;\n    return this.http.post<Deposit>(\"/me/deposits\", {\n      body,\n      idempotencyKey,\n    });\n  }\n\n  /** Fetch one deposit by id — the poll target while a redirect resolves. */\n  async get(id: string): Promise<Deposit> {\n    return this.http.get<Deposit>(`/me/deposits/${encodeURIComponent(id)}`);\n  }\n\n  /** List the caller's deposits, most recent first. */\n  async list(): Promise<Deposit[]> {\n    return this.http.get<Deposit[]>(\"/me/deposits\");\n  }\n\n  /**\n   * Refund a previously-confirmed deposit. Synchronous when the\n   * connector settles inline; otherwise the row stays `pending` and flips\n   * later via the inbound `deposit.refunded` event.\n   */\n  async refund(\n    depositId: string,\n    input: CreateDepositRefundInput,\n  ): Promise<Refund> {\n    const { idempotencyKey, ...body } = input;\n    return this.http.post<Refund>(\n      `/me/deposits/${encodeURIComponent(depositId)}/refunds`,\n      { body, idempotencyKey },\n    );\n  }\n}\n"]}

package/dist/resources/deposits.d.cts

@@ -0,0 +1,168 @@
+import { H as HttpClient } from '../http-BkZZZI8K.cjs';
+import { C as CustomerInfo } from '../customer-CoxPwe5o.cjs';
+
+/**
+ * Deposits resource — `client.deposits.*`.
+ *
+ * The "money IN" surface: an end user tops up their wallet balance via a
+ * funder connector. Mirrors the Takeal API's `/me/deposits` routes:
+ *
+ *   POST   /me/deposits              → initiate
+ *   GET    /me/deposits              → list (most recent first)
+ *   GET    /me/deposits/{id}         → get
+ *   POST   /me/deposits/{id}/refunds → refund
+ *
+ * A deposit is rarely terminal on the initiate call: real PSPs return
+ * `redirect_required` (3DS / APM redirect) and flip to `confirmed` later via
+ * a connector → Takeal API inbound event. Poll `get(id)` or watch the user's
+ * webhook stream for the `deposit.confirmed` / `deposit.failed` outcome.
+ */
+/** Lifecycle of a deposit. `redirect_required` carries `redirect_url`. */
+type DepositStatus = "pending" | "redirect_required" | "confirmed" | "failed";
+/** Top-up rail. The chosen funder decides which it supports. */
+type DepositMethod = "card" | "crypto" | "bank_transfer";
+/**
+ * A deposit record as the Takeal API returns it. Mirrors the `deposits` table; the
+ * server-side `id` is the stable handle the SDK polls against. `idempotency_key`
+ * and `request_fingerprint` are server-internal and never serialised.
+ */
+/** Input for `quote()` — price a cross-currency deposit before paying. */
+interface CreateQuoteInput {
+    /** Decimal string, e.g. `"5000.00"`. */
+    amount: string;
+    /** ISO 4217 source currency — must differ from the wallet's local currency. */
+    currency: string;
+}
+/**
+ * A rate-locked funding quote: pay `source_amount source_currency`, the
+ * wallet is credited `credited_amount credited_currency` (net of the
+ * platform's conversion spread). Execute by passing `id` as `quote_id` to
+ * `initiate()` before `expires_at`; after that the API returns 409 and a new
+ * quote is needed.
+ */
+interface FundingQuote {
+    id: string;
+    source_amount: string;
+    source_currency: string;
+    credited_amount: string;
+    credited_currency: string;
+    /** Provider rate before spread (credited units per 1 source unit). */
+    rate: string;
+    spread_bps: number;
+    provider: string;
+    expires_at: string;
+}
+interface Deposit {
+    id: string;
+    user_id: string;
+    /** Slug of the funder that handled this deposit, as configured by the deployment. */
+    connector_slug: string;
+    /** The connector's own reference, populated once it responds. */
+    provider_reference: string | null;
+    status: DepositStatus;
+    /** Decimal serialised as a string to avoid float drift. */
+    amount: string;
+    currency: string;
+    method: DepositMethod;
+    /** Present when `status === "redirect_required"` — send the user here. */
+    redirect_url: string | null;
+    failure_reason: string | null;
+    /** Final settled amount once confirmed (may differ from `amount` on FX). */
+    confirmed_amount: string | null;
+    confirmed_at: string | null;
+    /** Set on cross-currency deposits: the quote this deposit executed against. */
+    quote_id?: string | null;
+    /** Locked provider rate (credited units per 1 source unit). */
+    fx_rate?: string | null;
+    fx_spread_bps?: number | null;
+    /** The wallet's local currency the deposit converted into. */
+    credited_currency?: string | null;
+    /** What the wallet was actually credited, net of spread. */
+    credited_amount?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface InitiateDepositInput {
+    /** Decimal as a string (`"100.00"`) — avoids float-precision loss on the wire. */
+    amount: string;
+    /** ISO 4217 code, e.g. `"USD"`. */
+    currency: string;
+    method: DepositMethod;
+    /**
+     * Optional. Slug of a specific funder to route through. Omit to
+     * let the Takeal API pick the first active funder. Unknown slug → 400; empty
+     * funder list → 503.
+     */
+    funder_slug?: string;
+    /** Provider-specific extras. The mock funder reads `mock_scenario`. */
+    metadata?: Record<string, string>;
+    /** Structured billing details — real PSPs require these for 3DS / compliance. */
+    customer?: CustomerInfo;
+    /**
+     * Required by the Takeal API on this write endpoint. Same key + body replays the
+     * original deposit; same key + different body returns 409. Supply a stable
+     * UUID per logical attempt so a retried network call is safe.
+     */
+    idempotencyKey: string;
+    /**
+     * Required when `currency` differs from the wallet's local currency: a
+     * fresh quote id from `quote()`. Cross-currency deposits without one are
+     * rejected with 400; expired quotes with 409.
+     */
+    quote_id?: string;
+}
+interface CreateDepositRefundInput {
+    /** Omit for a full refund of the original confirmed amount; same currency. */
+    amount?: string;
+    /** Human-readable reason, e.g. `"customer_request"`. */
+    reason?: string;
+    metadata?: Record<string, string>;
+    /** Required. Replays are keyed on this. */
+    idempotencyKey: string;
+}
+/** A refund row as the Takeal API returns it (`refunds` table, deposit-targeted). */
+interface Refund {
+    id: string;
+    target_type: string;
+    deposit_id?: string;
+    payment_id?: string;
+    connector_slug: string;
+    amount: string;
+    currency: string;
+    reason: string;
+    status: string;
+    provider_refund_reference?: string;
+    failure_reason?: string;
+    requestor_type: string;
+    requestor_id: string;
+    created_at: string;
+    updated_at: string;
+}
+declare class DepositsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Initiate a top-up. Resolves to the freshly-created `Deposit`, whose
+     * `status` may already be `confirmed` (synchronous rails / mock) or
+     * `redirect_required` (3DS / APM — forward the user to `redirect_url`).
+     */
+    /**
+     * Price a cross-currency deposit BEFORE paying. The rate is locked
+     * server-side until `expires_at`; deposits in the local currency need no
+     * quote (the API answers 400 `no_quote_needed`).
+     */
+    quote(input: CreateQuoteInput): Promise<FundingQuote>;
+    initiate(input: InitiateDepositInput): Promise<Deposit>;
+    /** Fetch one deposit by id — the poll target while a redirect resolves. */
+    get(id: string): Promise<Deposit>;
+    /** List the caller's deposits, most recent first. */
+    list(): Promise<Deposit[]>;
+    /**
+     * Refund a previously-confirmed deposit. Synchronous when the
+     * connector settles inline; otherwise the row stays `pending` and flips
+     * later via the inbound `deposit.refunded` event.
+     */
+    refund(depositId: string, input: CreateDepositRefundInput): Promise<Refund>;
+}
+
+export { type CreateDepositRefundInput, type CreateQuoteInput, type Deposit, type DepositMethod, type DepositStatus, DepositsResource, type FundingQuote, type InitiateDepositInput, type Refund };

package/dist/resources/deposits.d.ts

@@ -0,0 +1,168 @@
+import { H as HttpClient } from '../http-BkZZZI8K.js';
+import { C as CustomerInfo } from '../customer-CoxPwe5o.js';
+
+/**
+ * Deposits resource — `client.deposits.*`.
+ *
+ * The "money IN" surface: an end user tops up their wallet balance via a
+ * funder connector. Mirrors the Takeal API's `/me/deposits` routes:
+ *
+ *   POST   /me/deposits              → initiate
+ *   GET    /me/deposits              → list (most recent first)
+ *   GET    /me/deposits/{id}         → get
+ *   POST   /me/deposits/{id}/refunds → refund
+ *
+ * A deposit is rarely terminal on the initiate call: real PSPs return
+ * `redirect_required` (3DS / APM redirect) and flip to `confirmed` later via
+ * a connector → Takeal API inbound event. Poll `get(id)` or watch the user's
+ * webhook stream for the `deposit.confirmed` / `deposit.failed` outcome.
+ */
+/** Lifecycle of a deposit. `redirect_required` carries `redirect_url`. */
+type DepositStatus = "pending" | "redirect_required" | "confirmed" | "failed";
+/** Top-up rail. The chosen funder decides which it supports. */
+type DepositMethod = "card" | "crypto" | "bank_transfer";
+/**
+ * A deposit record as the Takeal API returns it. Mirrors the `deposits` table; the
+ * server-side `id` is the stable handle the SDK polls against. `idempotency_key`
+ * and `request_fingerprint` are server-internal and never serialised.
+ */
+/** Input for `quote()` — price a cross-currency deposit before paying. */
+interface CreateQuoteInput {
+    /** Decimal string, e.g. `"5000.00"`. */
+    amount: string;
+    /** ISO 4217 source currency — must differ from the wallet's local currency. */
+    currency: string;
+}
+/**
+ * A rate-locked funding quote: pay `source_amount source_currency`, the
+ * wallet is credited `credited_amount credited_currency` (net of the
+ * platform's conversion spread). Execute by passing `id` as `quote_id` to
+ * `initiate()` before `expires_at`; after that the API returns 409 and a new
+ * quote is needed.
+ */
+interface FundingQuote {
+    id: string;
+    source_amount: string;
+    source_currency: string;
+    credited_amount: string;
+    credited_currency: string;
+    /** Provider rate before spread (credited units per 1 source unit). */
+    rate: string;
+    spread_bps: number;
+    provider: string;
+    expires_at: string;
+}
+interface Deposit {
+    id: string;
+    user_id: string;
+    /** Slug of the funder that handled this deposit, as configured by the deployment. */
+    connector_slug: string;
+    /** The connector's own reference, populated once it responds. */
+    provider_reference: string | null;
+    status: DepositStatus;
+    /** Decimal serialised as a string to avoid float drift. */
+    amount: string;
+    currency: string;
+    method: DepositMethod;
+    /** Present when `status === "redirect_required"` — send the user here. */
+    redirect_url: string | null;
+    failure_reason: string | null;
+    /** Final settled amount once confirmed (may differ from `amount` on FX). */
+    confirmed_amount: string | null;
+    confirmed_at: string | null;
+    /** Set on cross-currency deposits: the quote this deposit executed against. */
+    quote_id?: string | null;
+    /** Locked provider rate (credited units per 1 source unit). */
+    fx_rate?: string | null;
+    fx_spread_bps?: number | null;
+    /** The wallet's local currency the deposit converted into. */
+    credited_currency?: string | null;
+    /** What the wallet was actually credited, net of spread. */
+    credited_amount?: string | null;
+    created_at: string;
+    updated_at: string;
+}
+interface InitiateDepositInput {
+    /** Decimal as a string (`"100.00"`) — avoids float-precision loss on the wire. */
+    amount: string;
+    /** ISO 4217 code, e.g. `"USD"`. */
+    currency: string;
+    method: DepositMethod;
+    /**
+     * Optional. Slug of a specific funder to route through. Omit to
+     * let the Takeal API pick the first active funder. Unknown slug → 400; empty
+     * funder list → 503.
+     */
+    funder_slug?: string;
+    /** Provider-specific extras. The mock funder reads `mock_scenario`. */
+    metadata?: Record<string, string>;
+    /** Structured billing details — real PSPs require these for 3DS / compliance. */
+    customer?: CustomerInfo;
+    /**
+     * Required by the Takeal API on this write endpoint. Same key + body replays the
+     * original deposit; same key + different body returns 409. Supply a stable
+     * UUID per logical attempt so a retried network call is safe.
+     */
+    idempotencyKey: string;
+    /**
+     * Required when `currency` differs from the wallet's local currency: a
+     * fresh quote id from `quote()`. Cross-currency deposits without one are
+     * rejected with 400; expired quotes with 409.
+     */
+    quote_id?: string;
+}
+interface CreateDepositRefundInput {
+    /** Omit for a full refund of the original confirmed amount; same currency. */
+    amount?: string;
+    /** Human-readable reason, e.g. `"customer_request"`. */
+    reason?: string;
+    metadata?: Record<string, string>;
+    /** Required. Replays are keyed on this. */
+    idempotencyKey: string;
+}
+/** A refund row as the Takeal API returns it (`refunds` table, deposit-targeted). */
+interface Refund {
+    id: string;
+    target_type: string;
+    deposit_id?: string;
+    payment_id?: string;
+    connector_slug: string;
+    amount: string;
+    currency: string;
+    reason: string;
+    status: string;
+    provider_refund_reference?: string;
+    failure_reason?: string;
+    requestor_type: string;
+    requestor_id: string;
+    created_at: string;
+    updated_at: string;
+}
+declare class DepositsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    /**
+     * Initiate a top-up. Resolves to the freshly-created `Deposit`, whose
+     * `status` may already be `confirmed` (synchronous rails / mock) or
+     * `redirect_required` (3DS / APM — forward the user to `redirect_url`).
+     */
+    /**
+     * Price a cross-currency deposit BEFORE paying. The rate is locked
+     * server-side until `expires_at`; deposits in the local currency need no
+     * quote (the API answers 400 `no_quote_needed`).
+     */
+    quote(input: CreateQuoteInput): Promise<FundingQuote>;
+    initiate(input: InitiateDepositInput): Promise<Deposit>;
+    /** Fetch one deposit by id — the poll target while a redirect resolves. */
+    get(id: string): Promise<Deposit>;
+    /** List the caller's deposits, most recent first. */
+    list(): Promise<Deposit[]>;
+    /**
+     * Refund a previously-confirmed deposit. Synchronous when the
+     * connector settles inline; otherwise the row stays `pending` and flips
+     * later via the inbound `deposit.refunded` event.
+     */
+    refund(depositId: string, input: CreateDepositRefundInput): Promise<Refund>;
+}
+
+export { type CreateDepositRefundInput, type CreateQuoteInput, type Deposit, type DepositMethod, type DepositStatus, DepositsResource, type FundingQuote, type InitiateDepositInput, type Refund };

package/dist/resources/deposits.js

@@ -0,0 +1,50 @@
+// src/resources/deposits.ts
+var DepositsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  /**
+   * Initiate a top-up. Resolves to the freshly-created `Deposit`, whose
+   * `status` may already be `confirmed` (synchronous rails / mock) or
+   * `redirect_required` (3DS / APM — forward the user to `redirect_url`).
+   */
+  /**
+   * Price a cross-currency deposit BEFORE paying. The rate is locked
+   * server-side until `expires_at`; deposits in the local currency need no
+   * quote (the API answers 400 `no_quote_needed`).
+   */
+  async quote(input) {
+    return this.http.post("/me/deposits/quotes", { body: input });
+  }
+  async initiate(input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.post("/me/deposits", {
+      body,
+      idempotencyKey
+    });
+  }
+  /** Fetch one deposit by id — the poll target while a redirect resolves. */
+  async get(id) {
+    return this.http.get(`/me/deposits/${encodeURIComponent(id)}`);
+  }
+  /** List the caller's deposits, most recent first. */
+  async list() {
+    return this.http.get("/me/deposits");
+  }
+  /**
+   * Refund a previously-confirmed deposit. Synchronous when the
+   * connector settles inline; otherwise the row stays `pending` and flips
+   * later via the inbound `deposit.refunded` event.
+   */
+  async refund(depositId, input) {
+    const { idempotencyKey, ...body } = input;
+    return this.http.post(
+      `/me/deposits/${encodeURIComponent(depositId)}/refunds`,
+      { body, idempotencyKey }
+    );
+  }
+};
+
+export { DepositsResource };
+//# sourceMappingURL=deposits.js.map
+//# sourceMappingURL=deposits.js.map

package/dist/resources/deposits.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/deposits.ts"],"names":[],"mappings":";AAyJO,IAAM,mBAAN,MAAuB;AAAA,EAC5B,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAYhD,MAAM,MAAM,KAAA,EAAgD;AAC1D,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA,CAAmB,uBAAuB,EAAE,IAAA,EAAM,OAAO,CAAA;AAAA,EAC5E;AAAA,EAEA,MAAM,SAAS,KAAA,EAA+C;AAC5D,IAAA,MAAM,EAAE,cAAA,EAAgB,GAAG,IAAA,EAAK,GAAI,KAAA;AACpC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,IAAA,CAAc,cAAA,EAAgB;AAAA,MAC7C,IAAA;AAAA,MACA;AAAA,KACD,CAAA;AAAA,EACH;AAAA;AAAA,EAGA,MAAM,IAAI,EAAA,EAA8B;AACtC,IAAA,OAAO,KAAK,IAAA,CAAK,GAAA,CAAa,gBAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAE,CAAA;AAAA,EACxE;AAAA;AAAA,EAGA,MAAM,IAAA,GAA2B;AAC/B,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAe,cAAc,CAAA;AAAA,EAChD;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,MAAA,CACJ,SAAA,EACA,KAAA,EACiB;AACjB,IAAA,MAAM,EAAE,cAAA,EAAgB,GAAG,IAAA,EAAK,GAAI,KAAA;AACpC,IAAA,OAAO,KAAK,IAAA,CAAK,IAAA;AAAA,MACf,CAAA,aAAA,EAAgB,kBAAA,CAAmB,SAAS,CAAC,CAAA,QAAA,CAAA;AAAA,MAC7C,EAAE,MAAM,cAAA;AAAe,KACzB;AAAA,EACF;AACF","file":"deposits.js","sourcesContent":["import type { HttpClient } from \"../http.js\";\nimport type { CustomerInfo } from \"../types/customer.js\";\n\n/**\n * Deposits resource — `client.deposits.*`.\n *\n * The \"money IN\" surface: an end user tops up their wallet balance via a\n * funder connector. Mirrors the Takeal API's `/me/deposits` routes:\n *\n *   POST   /me/deposits              → initiate\n *   GET    /me/deposits              → list (most recent first)\n *   GET    /me/deposits/{id}         → get\n *   POST   /me/deposits/{id}/refunds → refund\n *\n * A deposit is rarely terminal on the initiate call: real PSPs return\n * `redirect_required` (3DS / APM redirect) and flip to `confirmed` later via\n * a connector → Takeal API inbound event. Poll `get(id)` or watch the user's\n * webhook stream for the `deposit.confirmed` / `deposit.failed` outcome.\n */\n\n/** Lifecycle of a deposit. `redirect_required` carries `redirect_url`. */\nexport type DepositStatus =\n  | \"pending\"\n  | \"redirect_required\"\n  | \"confirmed\"\n  | \"failed\";\n\n/** Top-up rail. The chosen funder decides which it supports. */\nexport type DepositMethod = \"card\" | \"crypto\" | \"bank_transfer\";\n\n/**\n * A deposit record as the Takeal API returns it. Mirrors the `deposits` table; the\n * server-side `id` is the stable handle the SDK polls against. `idempotency_key`\n * and `request_fingerprint` are server-internal and never serialised.\n */\n/** Input for `quote()` — price a cross-currency deposit before paying. */\nexport interface CreateQuoteInput {\n  /** Decimal string, e.g. `\"5000.00\"`. */\n  amount: string;\n  /** ISO 4217 source currency — must differ from the wallet's local currency. */\n  currency: string;\n}\n\n/**\n * A rate-locked funding quote: pay `source_amount source_currency`, the\n * wallet is credited `credited_amount credited_currency` (net of the\n * platform's conversion spread). Execute by passing `id` as `quote_id` to\n * `initiate()` before `expires_at`; after that the API returns 409 and a new\n * quote is needed.\n */\nexport interface FundingQuote {\n  id: string;\n  source_amount: string;\n  source_currency: string;\n  credited_amount: string;\n  credited_currency: string;\n  /** Provider rate before spread (credited units per 1 source unit). */\n  rate: string;\n  spread_bps: number;\n  provider: string;\n  expires_at: string;\n}\n\nexport interface Deposit {\n  id: string;\n  user_id: string;\n  /** Slug of the funder that handled this deposit, as configured by the deployment. */\n  connector_slug: string;\n  /** The connector's own reference, populated once it responds. */\n  provider_reference: string | null;\n  status: DepositStatus;\n  /** Decimal serialised as a string to avoid float drift. */\n  amount: string;\n  currency: string;\n  method: DepositMethod;\n  /** Present when `status === \"redirect_required\"` — send the user here. */\n  redirect_url: string | null;\n  failure_reason: string | null;\n  /** Final settled amount once confirmed (may differ from `amount` on FX). */\n  confirmed_amount: string | null;\n  confirmed_at: string | null;\n  /** Set on cross-currency deposits: the quote this deposit executed against. */\n  quote_id?: string | null;\n  /** Locked provider rate (credited units per 1 source unit). */\n  fx_rate?: string | null;\n  fx_spread_bps?: number | null;\n  /** The wallet's local currency the deposit converted into. */\n  credited_currency?: string | null;\n  /** What the wallet was actually credited, net of spread. */\n  credited_amount?: string | null;\n  created_at: string;\n  updated_at: string;\n}\n\nexport interface InitiateDepositInput {\n  /** Decimal as a string (`\"100.00\"`) — avoids float-precision loss on the wire. */\n  amount: string;\n  /** ISO 4217 code, e.g. `\"USD\"`. */\n  currency: string;\n  method: DepositMethod;\n  /**\n   * Optional. Slug of a specific funder to route through. Omit to\n   * let the Takeal API pick the first active funder. Unknown slug → 400; empty\n   * funder list → 503.\n   */\n  funder_slug?: string;\n  /** Provider-specific extras. The mock funder reads `mock_scenario`. */\n  metadata?: Record<string, string>;\n  /** Structured billing details — real PSPs require these for 3DS / compliance. */\n  customer?: CustomerInfo;\n  /**\n   * Required by the Takeal API on this write endpoint. Same key + body replays the\n   * original deposit; same key + different body returns 409. Supply a stable\n   * UUID per logical attempt so a retried network call is safe.\n   */\n  idempotencyKey: string;\n  /**\n   * Required when `currency` differs from the wallet's local currency: a\n   * fresh quote id from `quote()`. Cross-currency deposits without one are\n   * rejected with 400; expired quotes with 409.\n   */\n  quote_id?: string;\n}\n\nexport interface CreateDepositRefundInput {\n  /** Omit for a full refund of the original confirmed amount; same currency. */\n  amount?: string;\n  /** Human-readable reason, e.g. `\"customer_request\"`. */\n  reason?: string;\n  metadata?: Record<string, string>;\n  /** Required. Replays are keyed on this. */\n  idempotencyKey: string;\n}\n\n/** A refund row as the Takeal API returns it (`refunds` table, deposit-targeted). */\nexport interface Refund {\n  id: string;\n  target_type: string;\n  deposit_id?: string;\n  payment_id?: string;\n  connector_slug: string;\n  amount: string;\n  currency: string;\n  reason: string;\n  status: string;\n  provider_refund_reference?: string;\n  failure_reason?: string;\n  requestor_type: string;\n  requestor_id: string;\n  created_at: string;\n  updated_at: string;\n}\n\nexport class DepositsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  /**\n   * Initiate a top-up. Resolves to the freshly-created `Deposit`, whose\n   * `status` may already be `confirmed` (synchronous rails / mock) or\n   * `redirect_required` (3DS / APM — forward the user to `redirect_url`).\n   */\n  /**\n   * Price a cross-currency deposit BEFORE paying. The rate is locked\n   * server-side until `expires_at`; deposits in the local currency need no\n   * quote (the API answers 400 `no_quote_needed`).\n   */\n  async quote(input: CreateQuoteInput): Promise<FundingQuote> {\n    return this.http.post<FundingQuote>(\"/me/deposits/quotes\", { body: input });\n  }\n\n  async initiate(input: InitiateDepositInput): Promise<Deposit> {\n    const { idempotencyKey, ...body } = input;\n    return this.http.post<Deposit>(\"/me/deposits\", {\n      body,\n      idempotencyKey,\n    });\n  }\n\n  /** Fetch one deposit by id — the poll target while a redirect resolves. */\n  async get(id: string): Promise<Deposit> {\n    return this.http.get<Deposit>(`/me/deposits/${encodeURIComponent(id)}`);\n  }\n\n  /** List the caller's deposits, most recent first. */\n  async list(): Promise<Deposit[]> {\n    return this.http.get<Deposit[]>(\"/me/deposits\");\n  }\n\n  /**\n   * Refund a previously-confirmed deposit. Synchronous when the\n   * connector settles inline; otherwise the row stays `pending` and flips\n   * later via the inbound `deposit.refunded` event.\n   */\n  async refund(\n    depositId: string,\n    input: CreateDepositRefundInput,\n  ): Promise<Refund> {\n    const { idempotencyKey, ...body } = input;\n    return this.http.post<Refund>(\n      `/me/deposits/${encodeURIComponent(depositId)}/refunds`,\n      { body, idempotencyKey },\n    );\n  }\n}\n"]}

package/dist/resources/subscriptions.cjs

@@ -0,0 +1,24 @@
+'use strict';
+
+// src/resources/subscriptions.ts
+var SubscriptionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async get() {
+    return this.http.get("/me/subscriptions");
+  }
+  /**
+   * Replace the whole set — this is a PUT, not a merge. Pass `[]` to opt out
+   * of everything.
+   */
+  async set(channels) {
+    return this.http.put("/me/subscriptions", {
+      body: { channels }
+    });
+  }
+};
+
+exports.SubscriptionsResource = SubscriptionsResource;
+//# sourceMappingURL=subscriptions.cjs.map
+//# sourceMappingURL=subscriptions.cjs.map

package/dist/resources/subscriptions.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/subscriptions.ts"],"names":[],"mappings":";;;AA2BO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAEhD,MAAM,GAAA,GAA8B;AAClC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAmB,mBAAmB,CAAA;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,QAAA,EAAsD;AAC9D,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAmB,mBAAA,EAAqB;AAAA,MACvD,IAAA,EAAM,EAAE,QAAA;AAAS,KAClB,CAAA;AAAA,EACH;AACF","file":"subscriptions.cjs","sourcesContent":["import type { HttpClient } from \"../http.js\";\n\n/**\n * Subscriptions resource — `client.subscriptions.*`.\n *\n * Which channels the signed-in user agreed to receive announcements on.\n * `available` tells you which toggles to render: a deployment with no\n * Telegram bot configured can't deliver there, so offering the switch would\n * be a lie.\n *\n * ```ts\n * const { channels, available } = await client.subscriptions.get();\n * await client.subscriptions.set([...channels, \"telegram\"]);\n * ```\n *\n * Unrelated to paid/VIP tiers — this is only about announcements.\n */\n\nexport type BroadcastChannel = \"email\" | \"telegram\" | (string & {});\n\nexport interface Subscriptions {\n  /** Channels the user currently receives announcements on. */\n  channels: BroadcastChannel[];\n  /** Channels this deployment can actually deliver on. */\n  available: BroadcastChannel[];\n}\n\nexport class SubscriptionsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  async get(): Promise<Subscriptions> {\n    return this.http.get<Subscriptions>(\"/me/subscriptions\");\n  }\n\n  /**\n   * Replace the whole set — this is a PUT, not a merge. Pass `[]` to opt out\n   * of everything.\n   */\n  async set(channels: BroadcastChannel[]): Promise<Subscriptions> {\n    return this.http.put<Subscriptions>(\"/me/subscriptions\", {\n      body: { channels },\n    });\n  }\n}\n"]}

package/dist/resources/subscriptions.d.cts

@@ -0,0 +1,36 @@
+import { H as HttpClient } from '../http-BkZZZI8K.cjs';
+
+/**
+ * Subscriptions resource — `client.subscriptions.*`.
+ *
+ * Which channels the signed-in user agreed to receive announcements on.
+ * `available` tells you which toggles to render: a deployment with no
+ * Telegram bot configured can't deliver there, so offering the switch would
+ * be a lie.
+ *
+ * ```ts
+ * const { channels, available } = await client.subscriptions.get();
+ * await client.subscriptions.set([...channels, "telegram"]);
+ * ```
+ *
+ * Unrelated to paid/VIP tiers — this is only about announcements.
+ */
+type BroadcastChannel = "email" | "telegram" | (string & {});
+interface Subscriptions {
+    /** Channels the user currently receives announcements on. */
+    channels: BroadcastChannel[];
+    /** Channels this deployment can actually deliver on. */
+    available: BroadcastChannel[];
+}
+declare class SubscriptionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(): Promise<Subscriptions>;
+    /**
+     * Replace the whole set — this is a PUT, not a merge. Pass `[]` to opt out
+     * of everything.
+     */
+    set(channels: BroadcastChannel[]): Promise<Subscriptions>;
+}
+
+export { type BroadcastChannel, type Subscriptions, SubscriptionsResource };

package/dist/resources/subscriptions.d.ts

@@ -0,0 +1,36 @@
+import { H as HttpClient } from '../http-BkZZZI8K.js';
+
+/**
+ * Subscriptions resource — `client.subscriptions.*`.
+ *
+ * Which channels the signed-in user agreed to receive announcements on.
+ * `available` tells you which toggles to render: a deployment with no
+ * Telegram bot configured can't deliver there, so offering the switch would
+ * be a lie.
+ *
+ * ```ts
+ * const { channels, available } = await client.subscriptions.get();
+ * await client.subscriptions.set([...channels, "telegram"]);
+ * ```
+ *
+ * Unrelated to paid/VIP tiers — this is only about announcements.
+ */
+type BroadcastChannel = "email" | "telegram" | (string & {});
+interface Subscriptions {
+    /** Channels the user currently receives announcements on. */
+    channels: BroadcastChannel[];
+    /** Channels this deployment can actually deliver on. */
+    available: BroadcastChannel[];
+}
+declare class SubscriptionsResource {
+    private readonly http;
+    constructor(http: HttpClient);
+    get(): Promise<Subscriptions>;
+    /**
+     * Replace the whole set — this is a PUT, not a merge. Pass `[]` to opt out
+     * of everything.
+     */
+    set(channels: BroadcastChannel[]): Promise<Subscriptions>;
+}
+
+export { type BroadcastChannel, type Subscriptions, SubscriptionsResource };

package/dist/resources/subscriptions.js

@@ -0,0 +1,22 @@
+// src/resources/subscriptions.ts
+var SubscriptionsResource = class {
+  constructor(http) {
+    this.http = http;
+  }
+  async get() {
+    return this.http.get("/me/subscriptions");
+  }
+  /**
+   * Replace the whole set — this is a PUT, not a merge. Pass `[]` to opt out
+   * of everything.
+   */
+  async set(channels) {
+    return this.http.put("/me/subscriptions", {
+      body: { channels }
+    });
+  }
+};
+
+export { SubscriptionsResource };
+//# sourceMappingURL=subscriptions.js.map
+//# sourceMappingURL=subscriptions.js.map

package/dist/resources/subscriptions.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/resources/subscriptions.ts"],"names":[],"mappings":";AA2BO,IAAM,wBAAN,MAA4B;AAAA,EACjC,YAA6B,IAAA,EAAkB;AAAlB,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAAA,EAAmB;AAAA,EAEhD,MAAM,GAAA,GAA8B;AAClC,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAmB,mBAAmB,CAAA;AAAA,EACzD;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,MAAM,IAAI,QAAA,EAAsD;AAC9D,IAAA,OAAO,IAAA,CAAK,IAAA,CAAK,GAAA,CAAmB,mBAAA,EAAqB;AAAA,MACvD,IAAA,EAAM,EAAE,QAAA;AAAS,KAClB,CAAA;AAAA,EACH;AACF","file":"subscriptions.js","sourcesContent":["import type { HttpClient } from \"../http.js\";\n\n/**\n * Subscriptions resource — `client.subscriptions.*`.\n *\n * Which channels the signed-in user agreed to receive announcements on.\n * `available` tells you which toggles to render: a deployment with no\n * Telegram bot configured can't deliver there, so offering the switch would\n * be a lie.\n *\n * ```ts\n * const { channels, available } = await client.subscriptions.get();\n * await client.subscriptions.set([...channels, \"telegram\"]);\n * ```\n *\n * Unrelated to paid/VIP tiers — this is only about announcements.\n */\n\nexport type BroadcastChannel = \"email\" | \"telegram\" | (string & {});\n\nexport interface Subscriptions {\n  /** Channels the user currently receives announcements on. */\n  channels: BroadcastChannel[];\n  /** Channels this deployment can actually deliver on. */\n  available: BroadcastChannel[];\n}\n\nexport class SubscriptionsResource {\n  constructor(private readonly http: HttpClient) {}\n\n  async get(): Promise<Subscriptions> {\n    return this.http.get<Subscriptions>(\"/me/subscriptions\");\n  }\n\n  /**\n   * Replace the whole set — this is a PUT, not a merge. Pass `[]` to opt out\n   * of everything.\n   */\n  async set(channels: BroadcastChannel[]): Promise<Subscriptions> {\n    return this.http.put<Subscriptions>(\"/me/subscriptions\", {\n      body: { channels },\n    });\n  }\n}\n"]}