@versenco/vcoin-client 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Versenco
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,135 @@
+# @versenco/vcoin-client
+
+TypeScript client for Versenco's vCoin API — the shared in-app currency used
+across the Versenco ecosystem (vChat, VersenEducation, versen-pay, and more).
+
+Two entry points, matching the two trust domains of the underlying API:
+
+- **`createVCoinServerClient`** — needs your app's `client_secret`. Runs
+  **server-side only**. Grants and debits vCoins, issues refunds, reads any
+  user's balance, reads platform config.
+- **`createVCoinUserClient`** — no secret. Takes the *user's own*
+  `accessToken` per call. Safe to use in the browser: reads the current
+  user's balance, verifies/executes a peer-to-peer transfer, starts a top-up
+  checkout.
+
+## Install
+
+```bash
+pnpm add @versenco/vcoin-client
+```
+
+## Server usage
+
+```ts
+import { createVCoinServerClient, idempotencyKey } from "@versenco/vcoin-client";
+
+const vcoin = createVCoinServerClient({
+  appId: "your-app-id",
+  clientSecret: process.env.VCOIN_CLIENT_SECRET!,
+  baseUrl: "https://wnziizrtaocclnctqkll.supabase.co",
+});
+```
+
+This is your versen-connect Supabase project's URL (not the `auth.versenco.com`
+app domain, which only serves the login UI) — edge functions live at
+`<supabase-project-url>/functions/v1/*`.
+
+```ts
+const result = await vcoin.earn({
+  userId,
+  amount: 50,
+  type: "upload_reward",
+  description: `Uploaded "${title}"`,
+  referenceId: documentId,
+  idempotencyKey: idempotencyKey("upload", documentId, userId),
+});
+
+if (!result.ok) {
+  // result.error is a typed string; some errors (insufficient_balance,
+  // insufficient_balance_for_refund, daily_limit_exceeded) carry extra fields.
+  console.error(result.error);
+} else if (result.data.idempotent) {
+  // this exact idempotencyKey was already processed — nothing new happened.
+} else {
+  console.log(result.data.balance, result.data.transactionId);
+}
+```
+
+## User usage (safe in the browser)
+
+```ts
+import { createVCoinUserClient } from "@versenco/vcoin-client";
+
+const vcoin = createVCoinUserClient({ baseUrl: "https://wnziizrtaocclnctqkll.supabase.co" });
+
+const balance = await vcoin.balance({ accessToken });
+```
+
+The `accessToken` is the access token from your app's own versen-connect SSO
+session — not a vCoin-specific credential.
+
+## Getting a `client_secret`
+
+Server-side access is gated per app. Contact Versenco to register your app
+and receive an app id / client secret pair (the `appId` / `clientSecret`
+fields of `VCoinServerConfig`).
+
+## All methods
+
+**Server** (`createVCoinServerClient`, needs `clientSecret`):
+
+- `earn(input)` — credit vCoins to a user; idempotent via `idempotencyKey`.
+- `spend(input)` — debit vCoins from a user; idempotent via `idempotencyKey`.
+- `refund(input)` — reverse a prior spend by transaction id.
+- `balance(input)` — read any user's balance and recent transactions.
+- `getConfig(key?)` — read platform config (e.g. the vCoin-to-XOF ratio).
+
+**User** (`createVCoinUserClient`, no secret, takes `accessToken` per call):
+
+- `balance(input)` — read the current user's own balance and transactions.
+- `verifyRecipient(input)` — look up a transfer recipient before sending.
+- `transfer(input)` — send vCoins to another user; requires an
+  `idempotencyKey` (see the idempotency section below — always include your
+  app id as one of the parts, since keys are unique across the whole vCoin
+  system, not just your app).
+- `createCheckout(input)` — start a vCoin top-up checkout session.
+
+## Idempotency keys
+
+`idempotencyKey(...)` builds a stable key from one or more parts. Keys are
+unique across the ENTIRE vCoin system — all apps and all users share one
+keyspace at the database level — so always include your own app id (or an
+equally unique prefix) as one of the parts you pass in, to avoid colliding
+with another app's key.
+
+## Errors
+
+Two different failure shapes:
+
+- A thrown `VCoinNetworkError` — unexpected failures: the network is down,
+  the response isn't valid JSON, or the API returned something with no
+  recognizable error code. Callers should generally let this propagate or
+  wrap it in their own error handling.
+- A returned `{ ok: false, error, ... }` — expected business outcomes:
+  insufficient balance, wallet not found, daily limit exceeded, etc. These
+  are part of the normal return type and should be handled inline.
+
+```ts
+try {
+  const result = await vcoin.spend({ userId, amount: 10, type: "decoration" });
+  if (!result.ok) {
+    // expected business outcome, e.g. result.error === "insufficient_balance"
+    console.error(result.error);
+    return;
+  }
+  console.log(result.data.balance);
+} catch (err) {
+  // unexpected failure (network, malformed response, etc.)
+  console.error(err);
+}
+```
+
+## License
+
+MIT

package/dist/index.cjs

@@ -0,0 +1,352 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  VCOIN_CLIENT_VERSION: () => VCOIN_CLIENT_VERSION,
+  VCoinNetworkError: () => VCoinNetworkError,
+  createVCoinServerClient: () => createVCoinServerClient,
+  createVCoinUserClient: () => createVCoinUserClient,
+  idempotencyKey: () => idempotencyKey
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/types.ts
+var VCoinNetworkError = class extends Error {
+  constructor(message, status, cause) {
+    super(message);
+    this.status = status;
+    this.cause = cause;
+    this.name = "VCoinNetworkError";
+  }
+};
+
+// src/fetcher.ts
+function functionUrl(baseUrl, fn) {
+  let parsed;
+  try {
+    parsed = new URL(baseUrl);
+  } catch {
+    throw new Error(`vCoin baseUrl must be a valid URL (got: ${baseUrl})`);
+  }
+  const isLocal = parsed.protocol === "http:" && (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1");
+  if (parsed.protocol !== "https:" && !isLocal) {
+    throw new Error(`vCoin baseUrl must use https:// (got: ${baseUrl})`);
+  }
+  return `${baseUrl.replace(/\/+$/, "")}/functions/v1/${fn}`;
+}
+async function vcoinFetch(url, init) {
+  let res;
+  try {
+    res = await fetch(url, {
+      method: init.method,
+      headers: { "Content-Type": "application/json", ...init.headers },
+      body: init.body !== void 0 ? JSON.stringify(init.body) : void 0
+    });
+  } catch (err) {
+    throw new VCoinNetworkError("Network error calling the vCoin API", void 0, err);
+  }
+  const text = await res.text();
+  let json;
+  try {
+    json = text.length > 0 ? JSON.parse(text) : {};
+  } catch (err) {
+    throw new VCoinNetworkError("vCoin API returned a non-JSON response", res.status, err);
+  }
+  if (json === null || typeof json !== "object" || Array.isArray(json)) {
+    throw new VCoinNetworkError("vCoin API returned a non-object JSON response", res.status);
+  }
+  return { status: res.status, ok: res.ok, json };
+}
+function genericErrorResult(raw) {
+  const code = typeof raw.json.error === "string" ? raw.json.error : void 0;
+  if (!code) {
+    if (raw.status === 401) {
+      return { ok: false, error: "invalid_token", detail: void 0 };
+    }
+    throw new VCoinNetworkError(`vCoin API returned ${raw.status} with no recognizable error code`, raw.status);
+  }
+  const detail = typeof raw.json.detail === "string" ? raw.json.detail : void 0;
+  return { ok: false, error: code, detail };
+}
+
+// src/mappers.ts
+function num(v) {
+  return v;
+}
+function str(v) {
+  return v;
+}
+function strOrNull(v) {
+  return v ?? null;
+}
+function toTransactionResult(raw) {
+  if (raw.ok) {
+    if (raw.json.idempotent === true) {
+      return { ok: true, data: { idempotent: true } };
+    }
+    return {
+      ok: true,
+      data: {
+        idempotent: false,
+        balance: num(raw.json.balance),
+        transactionId: str(raw.json.transaction_id),
+        amount: num(raw.json.amount)
+      }
+    };
+  }
+  if (raw.json.error === "insufficient_balance") {
+    return { ok: false, error: "insufficient_balance", balance: num(raw.json.balance), required: num(raw.json.required) };
+  }
+  return genericErrorResult(raw);
+}
+function toRefundResult(raw) {
+  if (raw.ok) {
+    return {
+      ok: true,
+      data: {
+        refundTransactionId: str(raw.json.refund_transaction_id),
+        originalTransactionId: str(raw.json.original_transaction_id),
+        balance: num(raw.json.balance),
+        amount: num(raw.json.amount)
+      }
+    };
+  }
+  if (raw.json.error === "insufficient_balance_for_refund") {
+    return {
+      ok: false,
+      error: "insufficient_balance_for_refund",
+      balance: num(raw.json.balance),
+      required: num(raw.json.required)
+    };
+  }
+  return genericErrorResult(raw);
+}
+function toBalanceResult(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  const rawTx = raw.json.transactions ?? [];
+  const transactions = rawTx.map((t) => ({
+    id: str(t.id),
+    amount: num(t.amount),
+    balanceAfter: num(t.balance_after),
+    type: str(t.type),
+    description: strOrNull(t.description),
+    referenceId: strOrNull(t.reference_id),
+    appId: strOrNull(t.app_id),
+    createdAt: str(t.created_at)
+  }));
+  return {
+    ok: true,
+    data: {
+      balance: num(raw.json.balance),
+      walletId: strOrNull(raw.json.wallet_id),
+      updatedAt: strOrNull(raw.json.updated_at),
+      transactions
+    }
+  };
+}
+function toConfigResult(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  return {
+    ok: true,
+    data: { key: str(raw.json.key), value: str(raw.json.value), ratio: num(raw.json.ratio) }
+  };
+}
+function toRecipientInfo(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  return {
+    ok: true,
+    data: {
+      walletId: strOrNull(raw.json.wallet_id),
+      name: str(raw.json.name),
+      avatarUrl: strOrNull(raw.json.avatar_url)
+    }
+  };
+}
+function toTransferResult(raw) {
+  if (raw.json.error === "insufficient_balance") {
+    return { ok: false, error: "insufficient_balance", balance: num(raw.json.balance), required: num(raw.json.required) };
+  }
+  if (raw.json.error === "daily_limit_exceeded") {
+    return {
+      ok: false,
+      error: "daily_limit_exceeded",
+      dailySent: num(raw.json.daily_sent),
+      dailyLimit: num(raw.json.daily_limit),
+      remaining: num(raw.json.remaining)
+    };
+  }
+  if (!raw.ok || typeof raw.json.error === "string") {
+    return genericErrorResult(raw);
+  }
+  if (raw.json.idempotent === true) {
+    return { ok: true, data: { idempotent: true } };
+  }
+  return {
+    ok: true,
+    data: {
+      idempotent: false,
+      senderBalance: num(raw.json.sender_balance),
+      recipientWalletId: str(raw.json.recipient_wallet_id),
+      txOutId: str(raw.json.tx_out_id),
+      txInId: str(raw.json.tx_in_id),
+      amount: num(raw.json.amount)
+    }
+  };
+}
+function toCheckoutResult(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  return { ok: true, data: { checkoutUrl: str(raw.json.checkout_url) } };
+}
+
+// src/server.ts
+function createVCoinServerClient(config) {
+  if (typeof document !== "undefined") {
+    throw new Error(
+      "createVCoinServerClient must never run in a browser \u2014 it holds a secret. Use createVCoinUserClient for browser code."
+    );
+  }
+  async function earn(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-earn"), {
+      method: "POST",
+      headers: { "x-vcoin-secret": config.clientSecret },
+      body: {
+        user_id: input.userId,
+        amount: input.amount,
+        type: input.type,
+        description: input.description,
+        reference_id: input.referenceId,
+        app_id: config.appId,
+        idempotency_key: input.idempotencyKey
+      }
+    });
+    return toTransactionResult(raw);
+  }
+  async function spend(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-spend"), {
+      method: "POST",
+      headers: { "x-vcoin-secret": config.clientSecret },
+      body: {
+        user_id: input.userId,
+        amount: input.amount,
+        type: input.type,
+        description: input.description,
+        reference_id: input.referenceId,
+        app_id: config.appId,
+        idempotency_key: input.idempotencyKey
+      }
+    });
+    return toTransactionResult(raw);
+  }
+  async function refund(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-refund"), {
+      method: "POST",
+      headers: { "x-vcoin-secret": config.clientSecret },
+      body: { transaction_id: input.transactionId, reason: input.reason, app_id: config.appId }
+    });
+    return toRefundResult(raw);
+  }
+  async function balance(input) {
+    const url = `${functionUrl(config.baseUrl, "vcoin-balance")}?user_id=${encodeURIComponent(input.userId)}`;
+    const raw = await vcoinFetch(url, {
+      method: "GET",
+      headers: { "x-vcoin-secret": config.clientSecret, "x-app-id": config.appId }
+    });
+    return toBalanceResult(raw);
+  }
+  async function getConfig(key) {
+    const qs = key ? `?key=${encodeURIComponent(key)}` : "";
+    const raw = await vcoinFetch(`${functionUrl(config.baseUrl, "vcoin-config")}${qs}`, {
+      method: "GET",
+      headers: {}
+    });
+    return toConfigResult(raw);
+  }
+  return { earn, spend, refund, balance, getConfig };
+}
+
+// src/user.ts
+function createVCoinUserClient(config) {
+  async function balance(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-balance"), {
+      method: "GET",
+      headers: { Authorization: `Bearer ${input.accessToken}` }
+    });
+    return toBalanceResult(raw);
+  }
+  async function verifyRecipient(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-transfer"), {
+      method: "POST",
+      headers: { Authorization: `Bearer ${input.accessToken}` },
+      body: { action: "verify", recipient: input.recipient }
+    });
+    return toRecipientInfo(raw);
+  }
+  async function transfer(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-transfer"), {
+      method: "POST",
+      headers: { Authorization: `Bearer ${input.accessToken}` },
+      body: {
+        action: "transfer",
+        recipient: input.recipient,
+        amount: input.amount,
+        description: input.description,
+        idempotency_key: input.idempotencyKey
+      }
+    });
+    return toTransferResult(raw);
+  }
+  async function createCheckout(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-create-checkout"), {
+      method: "POST",
+      headers: { Authorization: `Bearer ${input.accessToken}` },
+      body: { pack_id: input.packId }
+    });
+    return toCheckoutResult(raw);
+  }
+  return { balance, verifyRecipient, transfer, createCheckout };
+}
+
+// src/idempotency.ts
+function idempotencyKey(...parts) {
+  if (parts.length === 0) {
+    throw new Error("idempotencyKey requires at least one part");
+  }
+  for (const part of parts) {
+    if (part.includes("::")) {
+      throw new Error(
+        'idempotencyKey parts must not contain "::" (the separator) \u2014 this would let two different calls silently collide'
+      );
+    }
+  }
+  return parts.join("::");
+}
+
+// src/index.ts
+var VCOIN_CLIENT_VERSION = "0.1.0";
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  VCOIN_CLIENT_VERSION,
+  VCoinNetworkError,
+  createVCoinServerClient,
+  createVCoinUserClient,
+  idempotencyKey
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/types.ts","../src/fetcher.ts","../src/mappers.ts","../src/server.ts","../src/user.ts","../src/idempotency.ts"],"sourcesContent":["export const VCOIN_CLIENT_VERSION = \"0.1.0\";\n\nexport { createVCoinServerClient } from \"./server\";\nexport { createVCoinUserClient } from \"./user\";\nexport { idempotencyKey } from \"./idempotency\";\n\nexport {\n  VCoinNetworkError,\n  type VCoinResult,\n  type VCoinBusinessError,\n  type EarnType,\n  type SpendType,\n  type EarnInput,\n  type SpendInput,\n  type TransactionResult,\n  type RefundInput,\n  type RefundResult,\n  type BalanceResult,\n  type BalanceTransaction,\n  type ConfigResult,\n  type RecipientInfo,\n  type TransferInput,\n  type TransferResult,\n  type VCoinServerConfig,\n  type VCoinUserConfig,\n  type VCoinServerClient,\n  type VCoinUserClient,\n} from \"./types\";\n","// ── Network-level error ──────────────────────────────────────────────────\n\nexport class VCoinNetworkError extends Error {\n  constructor(message: string, readonly status?: number, readonly cause?: unknown) {\n    super(message);\n    this.name = \"VCoinNetworkError\";\n  }\n}\n\n// ── Discriminated result type ────────────────────────────────────────────\n\nexport type VCoinBusinessError =\n  | \"wallet_not_found\"\n  | \"recipient_wallet_not_found\"\n  | \"invalid_recipient\"\n  | \"self_transfer\"\n  | \"transaction_not_found\"\n  | \"already_refunded\"\n  | \"forbidden\"\n  | \"invalid_token\"\n  | \"missing_token\"\n  | \"missing_credentials\"\n  | \"rate_limited\"\n  | \"cannot_spend_for_other_user\"\n  | \"admin_deduct_requires_server_credentials\"\n  | \"config_not_found\"\n  | \"database_error\";\n\nexport type VCoinResult<T> =\n  | { ok: true; data: T }\n  | { ok: false; error: \"insufficient_balance\"; balance: number; required: number }\n  | { ok: false; error: \"insufficient_balance_for_refund\"; balance: number; required: number }\n  | { ok: false; error: \"daily_limit_exceeded\"; dailySent: number; dailyLimit: number; remaining: number }\n  | { ok: false; error: VCoinBusinessError; detail?: string };\n\n// ── Earn / spend ──────────────────────────────────────────────────────────\n\nexport type EarnType = \"upload_reward\" | \"welcome_bonus\" | \"admin_grant\" | \"referral\";\nexport type SpendType = \"document_purchase\" | \"decoration\" | \"payment\" | \"admin_deduct\";\n\nexport interface EarnInput {\n  userId: string;\n  amount: number;\n  type: EarnType;\n  description?: string;\n  referenceId?: string;\n  idempotencyKey?: string;\n}\n\nexport interface SpendInput {\n  userId: string;\n  amount: number;\n  type: SpendType;\n  description?: string;\n  referenceId?: string;\n  idempotencyKey?: string;\n}\n\nexport type TransactionResult =\n  | { idempotent: true }\n  | { idempotent: false; balance: number; transactionId: string; amount: number };\n\n// ── Refund ────────────────────────────────────────────────────────────────\n\nexport interface RefundInput {\n  transactionId: string;\n  reason: string;\n}\n\nexport interface RefundResult {\n  refundTransactionId: string;\n  originalTransactionId: string;\n  balance: number;\n  amount: number;\n}\n\n// ── Balance ───────────────────────────────────────────────────────────────\n\nexport interface BalanceTransaction {\n  id: string;\n  amount: number;\n  balanceAfter: number;\n  type: string;\n  description: string | null;\n  referenceId: string | null;\n  appId: string | null;\n  createdAt: string;\n}\n\nexport interface BalanceResult {\n  balance: number;\n  walletId: string | null;\n  updatedAt: string | null;\n  transactions: BalanceTransaction[];\n}\n\n// ── Config ────────────────────────────────────────────────────────────────\n\nexport interface ConfigResult {\n  key: string;\n  value: string;\n  ratio: number;\n}\n\n// ── Transfer ──────────────────────────────────────────────────────────────\n\nexport interface RecipientInfo {\n  walletId: string | null;\n  name: string;\n  avatarUrl: string | null;\n}\n\nexport interface TransferInput {\n  accessToken: string;\n  recipient: string;\n  amount: number;\n  description?: string;\n  idempotencyKey: string;\n}\n\nexport type TransferResult =\n  | { idempotent: true }\n  | {\n      idempotent: false;\n      senderBalance: number;\n      recipientWalletId: string;\n      txOutId: string;\n      txInId: string;\n      amount: number;\n    };\n\n// ── Client configs ────────────────────────────────────────────────────────\n\nexport interface VCoinServerConfig {\n  appId: string;\n  clientSecret: string;\n  baseUrl: string;\n}\n\nexport interface VCoinUserConfig {\n  baseUrl: string;\n}\n\nexport interface VCoinServerClient {\n  earn(input: EarnInput): Promise<VCoinResult<TransactionResult>>;\n  spend(input: SpendInput): Promise<VCoinResult<TransactionResult>>;\n  refund(input: RefundInput): Promise<VCoinResult<RefundResult>>;\n  balance(input: { userId: string }): Promise<VCoinResult<BalanceResult>>;\n  getConfig(key?: string): Promise<VCoinResult<ConfigResult>>;\n}\n\nexport interface VCoinUserClient {\n  balance(input: { accessToken: string }): Promise<VCoinResult<BalanceResult>>;\n  verifyRecipient(input: { accessToken: string; recipient: string }): Promise<VCoinResult<RecipientInfo>>;\n  transfer(input: TransferInput): Promise<VCoinResult<TransferResult>>;\n  createCheckout(input: { accessToken: string; packId: string }): Promise<VCoinResult<{ checkoutUrl: string }>>;\n}\n","import { VCoinNetworkError, type VCoinBusinessError, type VCoinResult } from \"./types\";\n\nexport function functionUrl(baseUrl: string, fn: string): string {\n  let parsed: URL;\n  try {\n    parsed = new URL(baseUrl);\n  } catch {\n    throw new Error(`vCoin baseUrl must be a valid URL (got: ${baseUrl})`);\n  }\n  const isLocal =\n    parsed.protocol === \"http:\" && (parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\");\n  if (parsed.protocol !== \"https:\" && !isLocal) {\n    throw new Error(`vCoin baseUrl must use https:// (got: ${baseUrl})`);\n  }\n  return `${baseUrl.replace(/\\/+$/, \"\")}/functions/v1/${fn}`;\n}\n\nexport interface VCoinRawResponse {\n  status: number;\n  ok: boolean;\n  json: Record<string, unknown>;\n}\n\nexport async function vcoinFetch(\n  url: string,\n  init: { method: \"GET\" | \"POST\"; headers: Record<string, string>; body?: unknown },\n): Promise<VCoinRawResponse> {\n  let res: Response;\n  try {\n    res = await fetch(url, {\n      method: init.method,\n      headers: { \"Content-Type\": \"application/json\", ...init.headers },\n      body: init.body !== undefined ? JSON.stringify(init.body) : undefined,\n    });\n  } catch (err) {\n    throw new VCoinNetworkError(\"Network error calling the vCoin API\", undefined, err);\n  }\n\n  const text = await res.text();\n  let json: Record<string, unknown>;\n  try {\n    json = text.length > 0 ? JSON.parse(text) : {};\n  } catch (err) {\n    throw new VCoinNetworkError(\"vCoin API returned a non-JSON response\", res.status, err);\n  }\n\n  if (json === null || typeof json !== \"object\" || Array.isArray(json)) {\n    throw new VCoinNetworkError(\"vCoin API returned a non-object JSON response\", res.status);\n  }\n\n  return { status: res.status, ok: res.ok, json };\n}\n\nexport function genericErrorResult<T>(raw: VCoinRawResponse): VCoinResult<T> {\n  const code = typeof raw.json.error === \"string\" ? raw.json.error : undefined;\n  if (!code) {\n    if (raw.status === 401) {\n      return { ok: false, error: \"invalid_token\", detail: undefined };\n    }\n    throw new VCoinNetworkError(`vCoin API returned ${raw.status} with no recognizable error code`, raw.status);\n  }\n  const detail = typeof raw.json.detail === \"string\" ? raw.json.detail : undefined;\n  return { ok: false, error: code as VCoinBusinessError, detail };\n}\n","import { genericErrorResult, type VCoinRawResponse } from \"./fetcher\";\nimport type {\n  BalanceResult,\n  BalanceTransaction,\n  ConfigResult,\n  RecipientInfo,\n  RefundResult,\n  TransactionResult,\n  TransferResult,\n  VCoinResult,\n} from \"./types\";\n\nfunction num(v: unknown): number {\n  return v as number;\n}\nfunction str(v: unknown): string {\n  return v as string;\n}\nfunction strOrNull(v: unknown): string | null {\n  return (v as string | null) ?? null;\n}\n\nexport function toTransactionResult(raw: VCoinRawResponse): VCoinResult<TransactionResult> {\n  if (raw.ok) {\n    if (raw.json.idempotent === true) {\n      return { ok: true, data: { idempotent: true } };\n    }\n    return {\n      ok: true,\n      data: {\n        idempotent: false,\n        balance: num(raw.json.balance),\n        transactionId: str(raw.json.transaction_id),\n        amount: num(raw.json.amount),\n      },\n    };\n  }\n  if (raw.json.error === \"insufficient_balance\") {\n    return { ok: false, error: \"insufficient_balance\", balance: num(raw.json.balance), required: num(raw.json.required) };\n  }\n  return genericErrorResult<TransactionResult>(raw);\n}\n\nexport function toRefundResult(raw: VCoinRawResponse): VCoinResult<RefundResult> {\n  if (raw.ok) {\n    return {\n      ok: true,\n      data: {\n        refundTransactionId: str(raw.json.refund_transaction_id),\n        originalTransactionId: str(raw.json.original_transaction_id),\n        balance: num(raw.json.balance),\n        amount: num(raw.json.amount),\n      },\n    };\n  }\n  if (raw.json.error === \"insufficient_balance_for_refund\") {\n    return {\n      ok: false,\n      error: \"insufficient_balance_for_refund\",\n      balance: num(raw.json.balance),\n      required: num(raw.json.required),\n    };\n  }\n  return genericErrorResult<RefundResult>(raw);\n}\n\nexport function toBalanceResult(raw: VCoinRawResponse): VCoinResult<BalanceResult> {\n  if (!raw.ok) return genericErrorResult<BalanceResult>(raw);\n  const rawTx = (raw.json.transactions as Record<string, unknown>[] | undefined) ?? [];\n  const transactions: BalanceTransaction[] = rawTx.map((t) => ({\n    id: str(t.id),\n    amount: num(t.amount),\n    balanceAfter: num(t.balance_after),\n    type: str(t.type),\n    description: strOrNull(t.description),\n    referenceId: strOrNull(t.reference_id),\n    appId: strOrNull(t.app_id),\n    createdAt: str(t.created_at),\n  }));\n  return {\n    ok: true,\n    data: {\n      balance: num(raw.json.balance),\n      walletId: strOrNull(raw.json.wallet_id),\n      updatedAt: strOrNull(raw.json.updated_at),\n      transactions,\n    },\n  };\n}\n\nexport function toConfigResult(raw: VCoinRawResponse): VCoinResult<ConfigResult> {\n  if (!raw.ok) return genericErrorResult<ConfigResult>(raw);\n  return {\n    ok: true,\n    data: { key: str(raw.json.key), value: str(raw.json.value), ratio: num(raw.json.ratio) },\n  };\n}\n\nexport function toRecipientInfo(raw: VCoinRawResponse): VCoinResult<RecipientInfo> {\n  if (!raw.ok) return genericErrorResult<RecipientInfo>(raw);\n  return {\n    ok: true,\n    data: {\n      walletId: strOrNull(raw.json.wallet_id),\n      name: str(raw.json.name),\n      avatarUrl: strOrNull(raw.json.avatar_url),\n    },\n  };\n}\n\nexport function toTransferResult(raw: VCoinRawResponse): VCoinResult<TransferResult> {\n  // vcoin-transfer's business errors use real HTTP status codes (402 for\n  // insufficient_balance, 429 for daily_limit_exceeded) — but we check\n  // raw.json.error before trusting raw.ok as defense in depth, since this\n  // endpoint's exact status-code contract isn't guaranteed stable.\n  if (raw.json.error === \"insufficient_balance\") {\n    return { ok: false, error: \"insufficient_balance\", balance: num(raw.json.balance), required: num(raw.json.required) };\n  }\n  if (raw.json.error === \"daily_limit_exceeded\") {\n    return {\n      ok: false,\n      error: \"daily_limit_exceeded\",\n      dailySent: num(raw.json.daily_sent),\n      dailyLimit: num(raw.json.daily_limit),\n      remaining: num(raw.json.remaining),\n    };\n  }\n  if (!raw.ok || typeof raw.json.error === \"string\") {\n    return genericErrorResult<TransferResult>(raw);\n  }\n  if (raw.json.idempotent === true) {\n    return { ok: true, data: { idempotent: true } };\n  }\n  return {\n    ok: true,\n    data: {\n      idempotent: false,\n      senderBalance: num(raw.json.sender_balance),\n      recipientWalletId: str(raw.json.recipient_wallet_id),\n      txOutId: str(raw.json.tx_out_id),\n      txInId: str(raw.json.tx_in_id),\n      amount: num(raw.json.amount),\n    },\n  };\n}\n\nexport function toCheckoutResult(raw: VCoinRawResponse): VCoinResult<{ checkoutUrl: string }> {\n  if (!raw.ok) return genericErrorResult<{ checkoutUrl: string }>(raw);\n  return { ok: true, data: { checkoutUrl: str(raw.json.checkout_url) } };\n}\n","import { functionUrl, vcoinFetch } from \"./fetcher\";\nimport {\n  toBalanceResult,\n  toConfigResult,\n  toRefundResult,\n  toTransactionResult,\n} from \"./mappers\";\nimport type {\n  BalanceResult,\n  ConfigResult,\n  EarnInput,\n  RefundInput,\n  RefundResult,\n  SpendInput,\n  TransactionResult,\n  VCoinResult,\n  VCoinServerClient,\n  VCoinServerConfig,\n} from \"./types\";\n\nexport function createVCoinServerClient(config: VCoinServerConfig): VCoinServerClient {\n  if (typeof document !== \"undefined\") {\n    throw new Error(\n      \"createVCoinServerClient must never run in a browser — it holds a secret. Use createVCoinUserClient for browser code.\",\n    );\n  }\n\n  async function earn(input: EarnInput): Promise<VCoinResult<TransactionResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-earn\"), {\n      method: \"POST\",\n      headers: { \"x-vcoin-secret\": config.clientSecret },\n      body: {\n        user_id: input.userId,\n        amount: input.amount,\n        type: input.type,\n        description: input.description,\n        reference_id: input.referenceId,\n        app_id: config.appId,\n        idempotency_key: input.idempotencyKey,\n      },\n    });\n    return toTransactionResult(raw);\n  }\n\n  async function spend(input: SpendInput): Promise<VCoinResult<TransactionResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-spend\"), {\n      method: \"POST\",\n      headers: { \"x-vcoin-secret\": config.clientSecret },\n      body: {\n        user_id: input.userId,\n        amount: input.amount,\n        type: input.type,\n        description: input.description,\n        reference_id: input.referenceId,\n        app_id: config.appId,\n        idempotency_key: input.idempotencyKey,\n      },\n    });\n    return toTransactionResult(raw);\n  }\n\n  async function refund(input: RefundInput): Promise<VCoinResult<RefundResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-refund\"), {\n      method: \"POST\",\n      headers: { \"x-vcoin-secret\": config.clientSecret },\n      body: { transaction_id: input.transactionId, reason: input.reason, app_id: config.appId },\n    });\n    return toRefundResult(raw);\n  }\n\n  async function balance(input: { userId: string }): Promise<VCoinResult<BalanceResult>> {\n    const url = `${functionUrl(config.baseUrl, \"vcoin-balance\")}?user_id=${encodeURIComponent(input.userId)}`;\n    const raw = await vcoinFetch(url, {\n      method: \"GET\",\n      headers: { \"x-vcoin-secret\": config.clientSecret, \"x-app-id\": config.appId },\n    });\n    return toBalanceResult(raw);\n  }\n\n  async function getConfig(key?: string): Promise<VCoinResult<ConfigResult>> {\n    const qs = key ? `?key=${encodeURIComponent(key)}` : \"\";\n    const raw = await vcoinFetch(`${functionUrl(config.baseUrl, \"vcoin-config\")}${qs}`, {\n      method: \"GET\",\n      headers: {},\n    });\n    return toConfigResult(raw);\n  }\n\n  return { earn, spend, refund, balance, getConfig };\n}\n","import { functionUrl, vcoinFetch } from \"./fetcher\";\nimport { toBalanceResult, toCheckoutResult, toRecipientInfo, toTransferResult } from \"./mappers\";\nimport type {\n  BalanceResult,\n  RecipientInfo,\n  TransferInput,\n  TransferResult,\n  VCoinResult,\n  VCoinUserClient,\n  VCoinUserConfig,\n} from \"./types\";\n\nexport function createVCoinUserClient(config: VCoinUserConfig): VCoinUserClient {\n  async function balance(input: { accessToken: string }): Promise<VCoinResult<BalanceResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-balance\"), {\n      method: \"GET\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n    });\n    return toBalanceResult(raw);\n  }\n\n  async function verifyRecipient(input: {\n    accessToken: string;\n    recipient: string;\n  }): Promise<VCoinResult<RecipientInfo>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-transfer\"), {\n      method: \"POST\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n      body: { action: \"verify\", recipient: input.recipient },\n    });\n    return toRecipientInfo(raw);\n  }\n\n  async function transfer(input: TransferInput): Promise<VCoinResult<TransferResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-transfer\"), {\n      method: \"POST\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n      body: {\n        action: \"transfer\",\n        recipient: input.recipient,\n        amount: input.amount,\n        description: input.description,\n        idempotency_key: input.idempotencyKey,\n      },\n    });\n    return toTransferResult(raw);\n  }\n\n  async function createCheckout(input: {\n    accessToken: string;\n    packId: string;\n  }): Promise<VCoinResult<{ checkoutUrl: string }>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-create-checkout\"), {\n      method: \"POST\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n      body: { pack_id: input.packId },\n    });\n    return toCheckoutResult(raw);\n  }\n\n  return { balance, verifyRecipient, transfer, createCheckout };\n}\n","/**\n * Builds a stable idempotency key from one or more parts (e.g. an action\n * name, a resource id, a user id). Replaces the ad-hoc string\n * concatenation (`upload_${documentId}_${userId}`) that every consuming\n * app currently writes by hand.\n */\nexport function idempotencyKey(...parts: string[]): string {\n  if (parts.length === 0) {\n    throw new Error(\"idempotencyKey requires at least one part\");\n  }\n  for (const part of parts) {\n    if (part.includes(\"::\")) {\n      throw new Error(\n        'idempotencyKey parts must not contain \"::\" (the separator) — this would let two different calls silently collide',\n      );\n    }\n  }\n  return parts.join(\"::\");\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,158 @@
+declare class VCoinNetworkError extends Error {
+    readonly status?: number | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, cause?: unknown | undefined);
+}
+type VCoinBusinessError = "wallet_not_found" | "recipient_wallet_not_found" | "invalid_recipient" | "self_transfer" | "transaction_not_found" | "already_refunded" | "forbidden" | "invalid_token" | "missing_token" | "missing_credentials" | "rate_limited" | "cannot_spend_for_other_user" | "admin_deduct_requires_server_credentials" | "config_not_found" | "database_error";
+type VCoinResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: "insufficient_balance";
+    balance: number;
+    required: number;
+} | {
+    ok: false;
+    error: "insufficient_balance_for_refund";
+    balance: number;
+    required: number;
+} | {
+    ok: false;
+    error: "daily_limit_exceeded";
+    dailySent: number;
+    dailyLimit: number;
+    remaining: number;
+} | {
+    ok: false;
+    error: VCoinBusinessError;
+    detail?: string;
+};
+type EarnType = "upload_reward" | "welcome_bonus" | "admin_grant" | "referral";
+type SpendType = "document_purchase" | "decoration" | "payment" | "admin_deduct";
+interface EarnInput {
+    userId: string;
+    amount: number;
+    type: EarnType;
+    description?: string;
+    referenceId?: string;
+    idempotencyKey?: string;
+}
+interface SpendInput {
+    userId: string;
+    amount: number;
+    type: SpendType;
+    description?: string;
+    referenceId?: string;
+    idempotencyKey?: string;
+}
+type TransactionResult = {
+    idempotent: true;
+} | {
+    idempotent: false;
+    balance: number;
+    transactionId: string;
+    amount: number;
+};
+interface RefundInput {
+    transactionId: string;
+    reason: string;
+}
+interface RefundResult {
+    refundTransactionId: string;
+    originalTransactionId: string;
+    balance: number;
+    amount: number;
+}
+interface BalanceTransaction {
+    id: string;
+    amount: number;
+    balanceAfter: number;
+    type: string;
+    description: string | null;
+    referenceId: string | null;
+    appId: string | null;
+    createdAt: string;
+}
+interface BalanceResult {
+    balance: number;
+    walletId: string | null;
+    updatedAt: string | null;
+    transactions: BalanceTransaction[];
+}
+interface ConfigResult {
+    key: string;
+    value: string;
+    ratio: number;
+}
+interface RecipientInfo {
+    walletId: string | null;
+    name: string;
+    avatarUrl: string | null;
+}
+interface TransferInput {
+    accessToken: string;
+    recipient: string;
+    amount: number;
+    description?: string;
+    idempotencyKey: string;
+}
+type TransferResult = {
+    idempotent: true;
+} | {
+    idempotent: false;
+    senderBalance: number;
+    recipientWalletId: string;
+    txOutId: string;
+    txInId: string;
+    amount: number;
+};
+interface VCoinServerConfig {
+    appId: string;
+    clientSecret: string;
+    baseUrl: string;
+}
+interface VCoinUserConfig {
+    baseUrl: string;
+}
+interface VCoinServerClient {
+    earn(input: EarnInput): Promise<VCoinResult<TransactionResult>>;
+    spend(input: SpendInput): Promise<VCoinResult<TransactionResult>>;
+    refund(input: RefundInput): Promise<VCoinResult<RefundResult>>;
+    balance(input: {
+        userId: string;
+    }): Promise<VCoinResult<BalanceResult>>;
+    getConfig(key?: string): Promise<VCoinResult<ConfigResult>>;
+}
+interface VCoinUserClient {
+    balance(input: {
+        accessToken: string;
+    }): Promise<VCoinResult<BalanceResult>>;
+    verifyRecipient(input: {
+        accessToken: string;
+        recipient: string;
+    }): Promise<VCoinResult<RecipientInfo>>;
+    transfer(input: TransferInput): Promise<VCoinResult<TransferResult>>;
+    createCheckout(input: {
+        accessToken: string;
+        packId: string;
+    }): Promise<VCoinResult<{
+        checkoutUrl: string;
+    }>>;
+}
+
+declare function createVCoinServerClient(config: VCoinServerConfig): VCoinServerClient;
+
+declare function createVCoinUserClient(config: VCoinUserConfig): VCoinUserClient;
+
+/**
+ * Builds a stable idempotency key from one or more parts (e.g. an action
+ * name, a resource id, a user id). Replaces the ad-hoc string
+ * concatenation (`upload_${documentId}_${userId}`) that every consuming
+ * app currently writes by hand.
+ */
+declare function idempotencyKey(...parts: string[]): string;
+
+declare const VCOIN_CLIENT_VERSION = "0.1.0";
+
+export { type BalanceResult, type BalanceTransaction, type ConfigResult, type EarnInput, type EarnType, type RecipientInfo, type RefundInput, type RefundResult, type SpendInput, type SpendType, type TransactionResult, type TransferInput, type TransferResult, VCOIN_CLIENT_VERSION, type VCoinBusinessError, VCoinNetworkError, type VCoinResult, type VCoinServerClient, type VCoinServerConfig, type VCoinUserClient, type VCoinUserConfig, createVCoinServerClient, createVCoinUserClient, idempotencyKey };

package/dist/index.d.ts

@@ -0,0 +1,158 @@
+declare class VCoinNetworkError extends Error {
+    readonly status?: number | undefined;
+    readonly cause?: unknown | undefined;
+    constructor(message: string, status?: number | undefined, cause?: unknown | undefined);
+}
+type VCoinBusinessError = "wallet_not_found" | "recipient_wallet_not_found" | "invalid_recipient" | "self_transfer" | "transaction_not_found" | "already_refunded" | "forbidden" | "invalid_token" | "missing_token" | "missing_credentials" | "rate_limited" | "cannot_spend_for_other_user" | "admin_deduct_requires_server_credentials" | "config_not_found" | "database_error";
+type VCoinResult<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: "insufficient_balance";
+    balance: number;
+    required: number;
+} | {
+    ok: false;
+    error: "insufficient_balance_for_refund";
+    balance: number;
+    required: number;
+} | {
+    ok: false;
+    error: "daily_limit_exceeded";
+    dailySent: number;
+    dailyLimit: number;
+    remaining: number;
+} | {
+    ok: false;
+    error: VCoinBusinessError;
+    detail?: string;
+};
+type EarnType = "upload_reward" | "welcome_bonus" | "admin_grant" | "referral";
+type SpendType = "document_purchase" | "decoration" | "payment" | "admin_deduct";
+interface EarnInput {
+    userId: string;
+    amount: number;
+    type: EarnType;
+    description?: string;
+    referenceId?: string;
+    idempotencyKey?: string;
+}
+interface SpendInput {
+    userId: string;
+    amount: number;
+    type: SpendType;
+    description?: string;
+    referenceId?: string;
+    idempotencyKey?: string;
+}
+type TransactionResult = {
+    idempotent: true;
+} | {
+    idempotent: false;
+    balance: number;
+    transactionId: string;
+    amount: number;
+};
+interface RefundInput {
+    transactionId: string;
+    reason: string;
+}
+interface RefundResult {
+    refundTransactionId: string;
+    originalTransactionId: string;
+    balance: number;
+    amount: number;
+}
+interface BalanceTransaction {
+    id: string;
+    amount: number;
+    balanceAfter: number;
+    type: string;
+    description: string | null;
+    referenceId: string | null;
+    appId: string | null;
+    createdAt: string;
+}
+interface BalanceResult {
+    balance: number;
+    walletId: string | null;
+    updatedAt: string | null;
+    transactions: BalanceTransaction[];
+}
+interface ConfigResult {
+    key: string;
+    value: string;
+    ratio: number;
+}
+interface RecipientInfo {
+    walletId: string | null;
+    name: string;
+    avatarUrl: string | null;
+}
+interface TransferInput {
+    accessToken: string;
+    recipient: string;
+    amount: number;
+    description?: string;
+    idempotencyKey: string;
+}
+type TransferResult = {
+    idempotent: true;
+} | {
+    idempotent: false;
+    senderBalance: number;
+    recipientWalletId: string;
+    txOutId: string;
+    txInId: string;
+    amount: number;
+};
+interface VCoinServerConfig {
+    appId: string;
+    clientSecret: string;
+    baseUrl: string;
+}
+interface VCoinUserConfig {
+    baseUrl: string;
+}
+interface VCoinServerClient {
+    earn(input: EarnInput): Promise<VCoinResult<TransactionResult>>;
+    spend(input: SpendInput): Promise<VCoinResult<TransactionResult>>;
+    refund(input: RefundInput): Promise<VCoinResult<RefundResult>>;
+    balance(input: {
+        userId: string;
+    }): Promise<VCoinResult<BalanceResult>>;
+    getConfig(key?: string): Promise<VCoinResult<ConfigResult>>;
+}
+interface VCoinUserClient {
+    balance(input: {
+        accessToken: string;
+    }): Promise<VCoinResult<BalanceResult>>;
+    verifyRecipient(input: {
+        accessToken: string;
+        recipient: string;
+    }): Promise<VCoinResult<RecipientInfo>>;
+    transfer(input: TransferInput): Promise<VCoinResult<TransferResult>>;
+    createCheckout(input: {
+        accessToken: string;
+        packId: string;
+    }): Promise<VCoinResult<{
+        checkoutUrl: string;
+    }>>;
+}
+
+declare function createVCoinServerClient(config: VCoinServerConfig): VCoinServerClient;
+
+declare function createVCoinUserClient(config: VCoinUserConfig): VCoinUserClient;
+
+/**
+ * Builds a stable idempotency key from one or more parts (e.g. an action
+ * name, a resource id, a user id). Replaces the ad-hoc string
+ * concatenation (`upload_${documentId}_${userId}`) that every consuming
+ * app currently writes by hand.
+ */
+declare function idempotencyKey(...parts: string[]): string;
+
+declare const VCOIN_CLIENT_VERSION = "0.1.0";
+
+export { type BalanceResult, type BalanceTransaction, type ConfigResult, type EarnInput, type EarnType, type RecipientInfo, type RefundInput, type RefundResult, type SpendInput, type SpendType, type TransactionResult, type TransferInput, type TransferResult, VCOIN_CLIENT_VERSION, type VCoinBusinessError, VCoinNetworkError, type VCoinResult, type VCoinServerClient, type VCoinServerConfig, type VCoinUserClient, type VCoinUserConfig, createVCoinServerClient, createVCoinUserClient, idempotencyKey };

package/dist/index.js

@@ -0,0 +1,321 @@
+// src/types.ts
+var VCoinNetworkError = class extends Error {
+  constructor(message, status, cause) {
+    super(message);
+    this.status = status;
+    this.cause = cause;
+    this.name = "VCoinNetworkError";
+  }
+};
+
+// src/fetcher.ts
+function functionUrl(baseUrl, fn) {
+  let parsed;
+  try {
+    parsed = new URL(baseUrl);
+  } catch {
+    throw new Error(`vCoin baseUrl must be a valid URL (got: ${baseUrl})`);
+  }
+  const isLocal = parsed.protocol === "http:" && (parsed.hostname === "localhost" || parsed.hostname === "127.0.0.1");
+  if (parsed.protocol !== "https:" && !isLocal) {
+    throw new Error(`vCoin baseUrl must use https:// (got: ${baseUrl})`);
+  }
+  return `${baseUrl.replace(/\/+$/, "")}/functions/v1/${fn}`;
+}
+async function vcoinFetch(url, init) {
+  let res;
+  try {
+    res = await fetch(url, {
+      method: init.method,
+      headers: { "Content-Type": "application/json", ...init.headers },
+      body: init.body !== void 0 ? JSON.stringify(init.body) : void 0
+    });
+  } catch (err) {
+    throw new VCoinNetworkError("Network error calling the vCoin API", void 0, err);
+  }
+  const text = await res.text();
+  let json;
+  try {
+    json = text.length > 0 ? JSON.parse(text) : {};
+  } catch (err) {
+    throw new VCoinNetworkError("vCoin API returned a non-JSON response", res.status, err);
+  }
+  if (json === null || typeof json !== "object" || Array.isArray(json)) {
+    throw new VCoinNetworkError("vCoin API returned a non-object JSON response", res.status);
+  }
+  return { status: res.status, ok: res.ok, json };
+}
+function genericErrorResult(raw) {
+  const code = typeof raw.json.error === "string" ? raw.json.error : void 0;
+  if (!code) {
+    if (raw.status === 401) {
+      return { ok: false, error: "invalid_token", detail: void 0 };
+    }
+    throw new VCoinNetworkError(`vCoin API returned ${raw.status} with no recognizable error code`, raw.status);
+  }
+  const detail = typeof raw.json.detail === "string" ? raw.json.detail : void 0;
+  return { ok: false, error: code, detail };
+}
+
+// src/mappers.ts
+function num(v) {
+  return v;
+}
+function str(v) {
+  return v;
+}
+function strOrNull(v) {
+  return v ?? null;
+}
+function toTransactionResult(raw) {
+  if (raw.ok) {
+    if (raw.json.idempotent === true) {
+      return { ok: true, data: { idempotent: true } };
+    }
+    return {
+      ok: true,
+      data: {
+        idempotent: false,
+        balance: num(raw.json.balance),
+        transactionId: str(raw.json.transaction_id),
+        amount: num(raw.json.amount)
+      }
+    };
+  }
+  if (raw.json.error === "insufficient_balance") {
+    return { ok: false, error: "insufficient_balance", balance: num(raw.json.balance), required: num(raw.json.required) };
+  }
+  return genericErrorResult(raw);
+}
+function toRefundResult(raw) {
+  if (raw.ok) {
+    return {
+      ok: true,
+      data: {
+        refundTransactionId: str(raw.json.refund_transaction_id),
+        originalTransactionId: str(raw.json.original_transaction_id),
+        balance: num(raw.json.balance),
+        amount: num(raw.json.amount)
+      }
+    };
+  }
+  if (raw.json.error === "insufficient_balance_for_refund") {
+    return {
+      ok: false,
+      error: "insufficient_balance_for_refund",
+      balance: num(raw.json.balance),
+      required: num(raw.json.required)
+    };
+  }
+  return genericErrorResult(raw);
+}
+function toBalanceResult(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  const rawTx = raw.json.transactions ?? [];
+  const transactions = rawTx.map((t) => ({
+    id: str(t.id),
+    amount: num(t.amount),
+    balanceAfter: num(t.balance_after),
+    type: str(t.type),
+    description: strOrNull(t.description),
+    referenceId: strOrNull(t.reference_id),
+    appId: strOrNull(t.app_id),
+    createdAt: str(t.created_at)
+  }));
+  return {
+    ok: true,
+    data: {
+      balance: num(raw.json.balance),
+      walletId: strOrNull(raw.json.wallet_id),
+      updatedAt: strOrNull(raw.json.updated_at),
+      transactions
+    }
+  };
+}
+function toConfigResult(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  return {
+    ok: true,
+    data: { key: str(raw.json.key), value: str(raw.json.value), ratio: num(raw.json.ratio) }
+  };
+}
+function toRecipientInfo(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  return {
+    ok: true,
+    data: {
+      walletId: strOrNull(raw.json.wallet_id),
+      name: str(raw.json.name),
+      avatarUrl: strOrNull(raw.json.avatar_url)
+    }
+  };
+}
+function toTransferResult(raw) {
+  if (raw.json.error === "insufficient_balance") {
+    return { ok: false, error: "insufficient_balance", balance: num(raw.json.balance), required: num(raw.json.required) };
+  }
+  if (raw.json.error === "daily_limit_exceeded") {
+    return {
+      ok: false,
+      error: "daily_limit_exceeded",
+      dailySent: num(raw.json.daily_sent),
+      dailyLimit: num(raw.json.daily_limit),
+      remaining: num(raw.json.remaining)
+    };
+  }
+  if (!raw.ok || typeof raw.json.error === "string") {
+    return genericErrorResult(raw);
+  }
+  if (raw.json.idempotent === true) {
+    return { ok: true, data: { idempotent: true } };
+  }
+  return {
+    ok: true,
+    data: {
+      idempotent: false,
+      senderBalance: num(raw.json.sender_balance),
+      recipientWalletId: str(raw.json.recipient_wallet_id),
+      txOutId: str(raw.json.tx_out_id),
+      txInId: str(raw.json.tx_in_id),
+      amount: num(raw.json.amount)
+    }
+  };
+}
+function toCheckoutResult(raw) {
+  if (!raw.ok) return genericErrorResult(raw);
+  return { ok: true, data: { checkoutUrl: str(raw.json.checkout_url) } };
+}
+
+// src/server.ts
+function createVCoinServerClient(config) {
+  if (typeof document !== "undefined") {
+    throw new Error(
+      "createVCoinServerClient must never run in a browser \u2014 it holds a secret. Use createVCoinUserClient for browser code."
+    );
+  }
+  async function earn(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-earn"), {
+      method: "POST",
+      headers: { "x-vcoin-secret": config.clientSecret },
+      body: {
+        user_id: input.userId,
+        amount: input.amount,
+        type: input.type,
+        description: input.description,
+        reference_id: input.referenceId,
+        app_id: config.appId,
+        idempotency_key: input.idempotencyKey
+      }
+    });
+    return toTransactionResult(raw);
+  }
+  async function spend(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-spend"), {
+      method: "POST",
+      headers: { "x-vcoin-secret": config.clientSecret },
+      body: {
+        user_id: input.userId,
+        amount: input.amount,
+        type: input.type,
+        description: input.description,
+        reference_id: input.referenceId,
+        app_id: config.appId,
+        idempotency_key: input.idempotencyKey
+      }
+    });
+    return toTransactionResult(raw);
+  }
+  async function refund(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-refund"), {
+      method: "POST",
+      headers: { "x-vcoin-secret": config.clientSecret },
+      body: { transaction_id: input.transactionId, reason: input.reason, app_id: config.appId }
+    });
+    return toRefundResult(raw);
+  }
+  async function balance(input) {
+    const url = `${functionUrl(config.baseUrl, "vcoin-balance")}?user_id=${encodeURIComponent(input.userId)}`;
+    const raw = await vcoinFetch(url, {
+      method: "GET",
+      headers: { "x-vcoin-secret": config.clientSecret, "x-app-id": config.appId }
+    });
+    return toBalanceResult(raw);
+  }
+  async function getConfig(key) {
+    const qs = key ? `?key=${encodeURIComponent(key)}` : "";
+    const raw = await vcoinFetch(`${functionUrl(config.baseUrl, "vcoin-config")}${qs}`, {
+      method: "GET",
+      headers: {}
+    });
+    return toConfigResult(raw);
+  }
+  return { earn, spend, refund, balance, getConfig };
+}
+
+// src/user.ts
+function createVCoinUserClient(config) {
+  async function balance(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-balance"), {
+      method: "GET",
+      headers: { Authorization: `Bearer ${input.accessToken}` }
+    });
+    return toBalanceResult(raw);
+  }
+  async function verifyRecipient(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-transfer"), {
+      method: "POST",
+      headers: { Authorization: `Bearer ${input.accessToken}` },
+      body: { action: "verify", recipient: input.recipient }
+    });
+    return toRecipientInfo(raw);
+  }
+  async function transfer(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-transfer"), {
+      method: "POST",
+      headers: { Authorization: `Bearer ${input.accessToken}` },
+      body: {
+        action: "transfer",
+        recipient: input.recipient,
+        amount: input.amount,
+        description: input.description,
+        idempotency_key: input.idempotencyKey
+      }
+    });
+    return toTransferResult(raw);
+  }
+  async function createCheckout(input) {
+    const raw = await vcoinFetch(functionUrl(config.baseUrl, "vcoin-create-checkout"), {
+      method: "POST",
+      headers: { Authorization: `Bearer ${input.accessToken}` },
+      body: { pack_id: input.packId }
+    });
+    return toCheckoutResult(raw);
+  }
+  return { balance, verifyRecipient, transfer, createCheckout };
+}
+
+// src/idempotency.ts
+function idempotencyKey(...parts) {
+  if (parts.length === 0) {
+    throw new Error("idempotencyKey requires at least one part");
+  }
+  for (const part of parts) {
+    if (part.includes("::")) {
+      throw new Error(
+        'idempotencyKey parts must not contain "::" (the separator) \u2014 this would let two different calls silently collide'
+      );
+    }
+  }
+  return parts.join("::");
+}
+
+// src/index.ts
+var VCOIN_CLIENT_VERSION = "0.1.0";
+export {
+  VCOIN_CLIENT_VERSION,
+  VCoinNetworkError,
+  createVCoinServerClient,
+  createVCoinUserClient,
+  idempotencyKey
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/types.ts","../src/fetcher.ts","../src/mappers.ts","../src/server.ts","../src/user.ts","../src/idempotency.ts","../src/index.ts"],"sourcesContent":["// ── Network-level error ──────────────────────────────────────────────────\n\nexport class VCoinNetworkError extends Error {\n  constructor(message: string, readonly status?: number, readonly cause?: unknown) {\n    super(message);\n    this.name = \"VCoinNetworkError\";\n  }\n}\n\n// ── Discriminated result type ────────────────────────────────────────────\n\nexport type VCoinBusinessError =\n  | \"wallet_not_found\"\n  | \"recipient_wallet_not_found\"\n  | \"invalid_recipient\"\n  | \"self_transfer\"\n  | \"transaction_not_found\"\n  | \"already_refunded\"\n  | \"forbidden\"\n  | \"invalid_token\"\n  | \"missing_token\"\n  | \"missing_credentials\"\n  | \"rate_limited\"\n  | \"cannot_spend_for_other_user\"\n  | \"admin_deduct_requires_server_credentials\"\n  | \"config_not_found\"\n  | \"database_error\";\n\nexport type VCoinResult<T> =\n  | { ok: true; data: T }\n  | { ok: false; error: \"insufficient_balance\"; balance: number; required: number }\n  | { ok: false; error: \"insufficient_balance_for_refund\"; balance: number; required: number }\n  | { ok: false; error: \"daily_limit_exceeded\"; dailySent: number; dailyLimit: number; remaining: number }\n  | { ok: false; error: VCoinBusinessError; detail?: string };\n\n// ── Earn / spend ──────────────────────────────────────────────────────────\n\nexport type EarnType = \"upload_reward\" | \"welcome_bonus\" | \"admin_grant\" | \"referral\";\nexport type SpendType = \"document_purchase\" | \"decoration\" | \"payment\" | \"admin_deduct\";\n\nexport interface EarnInput {\n  userId: string;\n  amount: number;\n  type: EarnType;\n  description?: string;\n  referenceId?: string;\n  idempotencyKey?: string;\n}\n\nexport interface SpendInput {\n  userId: string;\n  amount: number;\n  type: SpendType;\n  description?: string;\n  referenceId?: string;\n  idempotencyKey?: string;\n}\n\nexport type TransactionResult =\n  | { idempotent: true }\n  | { idempotent: false; balance: number; transactionId: string; amount: number };\n\n// ── Refund ────────────────────────────────────────────────────────────────\n\nexport interface RefundInput {\n  transactionId: string;\n  reason: string;\n}\n\nexport interface RefundResult {\n  refundTransactionId: string;\n  originalTransactionId: string;\n  balance: number;\n  amount: number;\n}\n\n// ── Balance ───────────────────────────────────────────────────────────────\n\nexport interface BalanceTransaction {\n  id: string;\n  amount: number;\n  balanceAfter: number;\n  type: string;\n  description: string | null;\n  referenceId: string | null;\n  appId: string | null;\n  createdAt: string;\n}\n\nexport interface BalanceResult {\n  balance: number;\n  walletId: string | null;\n  updatedAt: string | null;\n  transactions: BalanceTransaction[];\n}\n\n// ── Config ────────────────────────────────────────────────────────────────\n\nexport interface ConfigResult {\n  key: string;\n  value: string;\n  ratio: number;\n}\n\n// ── Transfer ──────────────────────────────────────────────────────────────\n\nexport interface RecipientInfo {\n  walletId: string | null;\n  name: string;\n  avatarUrl: string | null;\n}\n\nexport interface TransferInput {\n  accessToken: string;\n  recipient: string;\n  amount: number;\n  description?: string;\n  idempotencyKey: string;\n}\n\nexport type TransferResult =\n  | { idempotent: true }\n  | {\n      idempotent: false;\n      senderBalance: number;\n      recipientWalletId: string;\n      txOutId: string;\n      txInId: string;\n      amount: number;\n    };\n\n// ── Client configs ────────────────────────────────────────────────────────\n\nexport interface VCoinServerConfig {\n  appId: string;\n  clientSecret: string;\n  baseUrl: string;\n}\n\nexport interface VCoinUserConfig {\n  baseUrl: string;\n}\n\nexport interface VCoinServerClient {\n  earn(input: EarnInput): Promise<VCoinResult<TransactionResult>>;\n  spend(input: SpendInput): Promise<VCoinResult<TransactionResult>>;\n  refund(input: RefundInput): Promise<VCoinResult<RefundResult>>;\n  balance(input: { userId: string }): Promise<VCoinResult<BalanceResult>>;\n  getConfig(key?: string): Promise<VCoinResult<ConfigResult>>;\n}\n\nexport interface VCoinUserClient {\n  balance(input: { accessToken: string }): Promise<VCoinResult<BalanceResult>>;\n  verifyRecipient(input: { accessToken: string; recipient: string }): Promise<VCoinResult<RecipientInfo>>;\n  transfer(input: TransferInput): Promise<VCoinResult<TransferResult>>;\n  createCheckout(input: { accessToken: string; packId: string }): Promise<VCoinResult<{ checkoutUrl: string }>>;\n}\n","import { VCoinNetworkError, type VCoinBusinessError, type VCoinResult } from \"./types\";\n\nexport function functionUrl(baseUrl: string, fn: string): string {\n  let parsed: URL;\n  try {\n    parsed = new URL(baseUrl);\n  } catch {\n    throw new Error(`vCoin baseUrl must be a valid URL (got: ${baseUrl})`);\n  }\n  const isLocal =\n    parsed.protocol === \"http:\" && (parsed.hostname === \"localhost\" || parsed.hostname === \"127.0.0.1\");\n  if (parsed.protocol !== \"https:\" && !isLocal) {\n    throw new Error(`vCoin baseUrl must use https:// (got: ${baseUrl})`);\n  }\n  return `${baseUrl.replace(/\\/+$/, \"\")}/functions/v1/${fn}`;\n}\n\nexport interface VCoinRawResponse {\n  status: number;\n  ok: boolean;\n  json: Record<string, unknown>;\n}\n\nexport async function vcoinFetch(\n  url: string,\n  init: { method: \"GET\" | \"POST\"; headers: Record<string, string>; body?: unknown },\n): Promise<VCoinRawResponse> {\n  let res: Response;\n  try {\n    res = await fetch(url, {\n      method: init.method,\n      headers: { \"Content-Type\": \"application/json\", ...init.headers },\n      body: init.body !== undefined ? JSON.stringify(init.body) : undefined,\n    });\n  } catch (err) {\n    throw new VCoinNetworkError(\"Network error calling the vCoin API\", undefined, err);\n  }\n\n  const text = await res.text();\n  let json: Record<string, unknown>;\n  try {\n    json = text.length > 0 ? JSON.parse(text) : {};\n  } catch (err) {\n    throw new VCoinNetworkError(\"vCoin API returned a non-JSON response\", res.status, err);\n  }\n\n  if (json === null || typeof json !== \"object\" || Array.isArray(json)) {\n    throw new VCoinNetworkError(\"vCoin API returned a non-object JSON response\", res.status);\n  }\n\n  return { status: res.status, ok: res.ok, json };\n}\n\nexport function genericErrorResult<T>(raw: VCoinRawResponse): VCoinResult<T> {\n  const code = typeof raw.json.error === \"string\" ? raw.json.error : undefined;\n  if (!code) {\n    if (raw.status === 401) {\n      return { ok: false, error: \"invalid_token\", detail: undefined };\n    }\n    throw new VCoinNetworkError(`vCoin API returned ${raw.status} with no recognizable error code`, raw.status);\n  }\n  const detail = typeof raw.json.detail === \"string\" ? raw.json.detail : undefined;\n  return { ok: false, error: code as VCoinBusinessError, detail };\n}\n","import { genericErrorResult, type VCoinRawResponse } from \"./fetcher\";\nimport type {\n  BalanceResult,\n  BalanceTransaction,\n  ConfigResult,\n  RecipientInfo,\n  RefundResult,\n  TransactionResult,\n  TransferResult,\n  VCoinResult,\n} from \"./types\";\n\nfunction num(v: unknown): number {\n  return v as number;\n}\nfunction str(v: unknown): string {\n  return v as string;\n}\nfunction strOrNull(v: unknown): string | null {\n  return (v as string | null) ?? null;\n}\n\nexport function toTransactionResult(raw: VCoinRawResponse): VCoinResult<TransactionResult> {\n  if (raw.ok) {\n    if (raw.json.idempotent === true) {\n      return { ok: true, data: { idempotent: true } };\n    }\n    return {\n      ok: true,\n      data: {\n        idempotent: false,\n        balance: num(raw.json.balance),\n        transactionId: str(raw.json.transaction_id),\n        amount: num(raw.json.amount),\n      },\n    };\n  }\n  if (raw.json.error === \"insufficient_balance\") {\n    return { ok: false, error: \"insufficient_balance\", balance: num(raw.json.balance), required: num(raw.json.required) };\n  }\n  return genericErrorResult<TransactionResult>(raw);\n}\n\nexport function toRefundResult(raw: VCoinRawResponse): VCoinResult<RefundResult> {\n  if (raw.ok) {\n    return {\n      ok: true,\n      data: {\n        refundTransactionId: str(raw.json.refund_transaction_id),\n        originalTransactionId: str(raw.json.original_transaction_id),\n        balance: num(raw.json.balance),\n        amount: num(raw.json.amount),\n      },\n    };\n  }\n  if (raw.json.error === \"insufficient_balance_for_refund\") {\n    return {\n      ok: false,\n      error: \"insufficient_balance_for_refund\",\n      balance: num(raw.json.balance),\n      required: num(raw.json.required),\n    };\n  }\n  return genericErrorResult<RefundResult>(raw);\n}\n\nexport function toBalanceResult(raw: VCoinRawResponse): VCoinResult<BalanceResult> {\n  if (!raw.ok) return genericErrorResult<BalanceResult>(raw);\n  const rawTx = (raw.json.transactions as Record<string, unknown>[] | undefined) ?? [];\n  const transactions: BalanceTransaction[] = rawTx.map((t) => ({\n    id: str(t.id),\n    amount: num(t.amount),\n    balanceAfter: num(t.balance_after),\n    type: str(t.type),\n    description: strOrNull(t.description),\n    referenceId: strOrNull(t.reference_id),\n    appId: strOrNull(t.app_id),\n    createdAt: str(t.created_at),\n  }));\n  return {\n    ok: true,\n    data: {\n      balance: num(raw.json.balance),\n      walletId: strOrNull(raw.json.wallet_id),\n      updatedAt: strOrNull(raw.json.updated_at),\n      transactions,\n    },\n  };\n}\n\nexport function toConfigResult(raw: VCoinRawResponse): VCoinResult<ConfigResult> {\n  if (!raw.ok) return genericErrorResult<ConfigResult>(raw);\n  return {\n    ok: true,\n    data: { key: str(raw.json.key), value: str(raw.json.value), ratio: num(raw.json.ratio) },\n  };\n}\n\nexport function toRecipientInfo(raw: VCoinRawResponse): VCoinResult<RecipientInfo> {\n  if (!raw.ok) return genericErrorResult<RecipientInfo>(raw);\n  return {\n    ok: true,\n    data: {\n      walletId: strOrNull(raw.json.wallet_id),\n      name: str(raw.json.name),\n      avatarUrl: strOrNull(raw.json.avatar_url),\n    },\n  };\n}\n\nexport function toTransferResult(raw: VCoinRawResponse): VCoinResult<TransferResult> {\n  // vcoin-transfer's business errors use real HTTP status codes (402 for\n  // insufficient_balance, 429 for daily_limit_exceeded) — but we check\n  // raw.json.error before trusting raw.ok as defense in depth, since this\n  // endpoint's exact status-code contract isn't guaranteed stable.\n  if (raw.json.error === \"insufficient_balance\") {\n    return { ok: false, error: \"insufficient_balance\", balance: num(raw.json.balance), required: num(raw.json.required) };\n  }\n  if (raw.json.error === \"daily_limit_exceeded\") {\n    return {\n      ok: false,\n      error: \"daily_limit_exceeded\",\n      dailySent: num(raw.json.daily_sent),\n      dailyLimit: num(raw.json.daily_limit),\n      remaining: num(raw.json.remaining),\n    };\n  }\n  if (!raw.ok || typeof raw.json.error === \"string\") {\n    return genericErrorResult<TransferResult>(raw);\n  }\n  if (raw.json.idempotent === true) {\n    return { ok: true, data: { idempotent: true } };\n  }\n  return {\n    ok: true,\n    data: {\n      idempotent: false,\n      senderBalance: num(raw.json.sender_balance),\n      recipientWalletId: str(raw.json.recipient_wallet_id),\n      txOutId: str(raw.json.tx_out_id),\n      txInId: str(raw.json.tx_in_id),\n      amount: num(raw.json.amount),\n    },\n  };\n}\n\nexport function toCheckoutResult(raw: VCoinRawResponse): VCoinResult<{ checkoutUrl: string }> {\n  if (!raw.ok) return genericErrorResult<{ checkoutUrl: string }>(raw);\n  return { ok: true, data: { checkoutUrl: str(raw.json.checkout_url) } };\n}\n","import { functionUrl, vcoinFetch } from \"./fetcher\";\nimport {\n  toBalanceResult,\n  toConfigResult,\n  toRefundResult,\n  toTransactionResult,\n} from \"./mappers\";\nimport type {\n  BalanceResult,\n  ConfigResult,\n  EarnInput,\n  RefundInput,\n  RefundResult,\n  SpendInput,\n  TransactionResult,\n  VCoinResult,\n  VCoinServerClient,\n  VCoinServerConfig,\n} from \"./types\";\n\nexport function createVCoinServerClient(config: VCoinServerConfig): VCoinServerClient {\n  if (typeof document !== \"undefined\") {\n    throw new Error(\n      \"createVCoinServerClient must never run in a browser — it holds a secret. Use createVCoinUserClient for browser code.\",\n    );\n  }\n\n  async function earn(input: EarnInput): Promise<VCoinResult<TransactionResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-earn\"), {\n      method: \"POST\",\n      headers: { \"x-vcoin-secret\": config.clientSecret },\n      body: {\n        user_id: input.userId,\n        amount: input.amount,\n        type: input.type,\n        description: input.description,\n        reference_id: input.referenceId,\n        app_id: config.appId,\n        idempotency_key: input.idempotencyKey,\n      },\n    });\n    return toTransactionResult(raw);\n  }\n\n  async function spend(input: SpendInput): Promise<VCoinResult<TransactionResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-spend\"), {\n      method: \"POST\",\n      headers: { \"x-vcoin-secret\": config.clientSecret },\n      body: {\n        user_id: input.userId,\n        amount: input.amount,\n        type: input.type,\n        description: input.description,\n        reference_id: input.referenceId,\n        app_id: config.appId,\n        idempotency_key: input.idempotencyKey,\n      },\n    });\n    return toTransactionResult(raw);\n  }\n\n  async function refund(input: RefundInput): Promise<VCoinResult<RefundResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-refund\"), {\n      method: \"POST\",\n      headers: { \"x-vcoin-secret\": config.clientSecret },\n      body: { transaction_id: input.transactionId, reason: input.reason, app_id: config.appId },\n    });\n    return toRefundResult(raw);\n  }\n\n  async function balance(input: { userId: string }): Promise<VCoinResult<BalanceResult>> {\n    const url = `${functionUrl(config.baseUrl, \"vcoin-balance\")}?user_id=${encodeURIComponent(input.userId)}`;\n    const raw = await vcoinFetch(url, {\n      method: \"GET\",\n      headers: { \"x-vcoin-secret\": config.clientSecret, \"x-app-id\": config.appId },\n    });\n    return toBalanceResult(raw);\n  }\n\n  async function getConfig(key?: string): Promise<VCoinResult<ConfigResult>> {\n    const qs = key ? `?key=${encodeURIComponent(key)}` : \"\";\n    const raw = await vcoinFetch(`${functionUrl(config.baseUrl, \"vcoin-config\")}${qs}`, {\n      method: \"GET\",\n      headers: {},\n    });\n    return toConfigResult(raw);\n  }\n\n  return { earn, spend, refund, balance, getConfig };\n}\n","import { functionUrl, vcoinFetch } from \"./fetcher\";\nimport { toBalanceResult, toCheckoutResult, toRecipientInfo, toTransferResult } from \"./mappers\";\nimport type {\n  BalanceResult,\n  RecipientInfo,\n  TransferInput,\n  TransferResult,\n  VCoinResult,\n  VCoinUserClient,\n  VCoinUserConfig,\n} from \"./types\";\n\nexport function createVCoinUserClient(config: VCoinUserConfig): VCoinUserClient {\n  async function balance(input: { accessToken: string }): Promise<VCoinResult<BalanceResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-balance\"), {\n      method: \"GET\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n    });\n    return toBalanceResult(raw);\n  }\n\n  async function verifyRecipient(input: {\n    accessToken: string;\n    recipient: string;\n  }): Promise<VCoinResult<RecipientInfo>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-transfer\"), {\n      method: \"POST\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n      body: { action: \"verify\", recipient: input.recipient },\n    });\n    return toRecipientInfo(raw);\n  }\n\n  async function transfer(input: TransferInput): Promise<VCoinResult<TransferResult>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-transfer\"), {\n      method: \"POST\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n      body: {\n        action: \"transfer\",\n        recipient: input.recipient,\n        amount: input.amount,\n        description: input.description,\n        idempotency_key: input.idempotencyKey,\n      },\n    });\n    return toTransferResult(raw);\n  }\n\n  async function createCheckout(input: {\n    accessToken: string;\n    packId: string;\n  }): Promise<VCoinResult<{ checkoutUrl: string }>> {\n    const raw = await vcoinFetch(functionUrl(config.baseUrl, \"vcoin-create-checkout\"), {\n      method: \"POST\",\n      headers: { Authorization: `Bearer ${input.accessToken}` },\n      body: { pack_id: input.packId },\n    });\n    return toCheckoutResult(raw);\n  }\n\n  return { balance, verifyRecipient, transfer, createCheckout };\n}\n","/**\n * Builds a stable idempotency key from one or more parts (e.g. an action\n * name, a resource id, a user id). Replaces the ad-hoc string\n * concatenation (`upload_${documentId}_${userId}`) that every consuming\n * app currently writes by hand.\n */\nexport function idempotencyKey(...parts: string[]): string {\n  if (parts.length === 0) {\n    throw new Error(\"idempotencyKey requires at least one part\");\n  }\n  for (const part of parts) {\n    if (part.includes(\"::\")) {\n      throw new Error(\n        'idempotencyKey parts must not contain \"::\" (the separator) — this would let two different calls silently collide',\n      );\n    }\n  }\n  return parts.join(\"::\");\n}\n","export const VCOIN_CLIENT_VERSION = \"0.1.0\";\n\nexport { createVCoinServerClient } from \"./server\";\nexport { createVCoinUserClient } from \"./user\";\nexport { idempotencyKey } from \"./idempotency\";\n\nexport {\n  VCoinNetworkError,\n  type VCoinResult,\n  type VCoinBusinessError,\n  type EarnType,\n  type SpendType,\n  type EarnInput,\n  type SpendInput,\n  type TransactionResult,\n  type RefundInput,\n  type RefundResult,\n  type BalanceResult,\n  type BalanceTransaction,\n  type ConfigResult,\n  type RecipientInfo,\n  type TransferInput,\n  type TransferResult,\n  type VCoinServerConfig,\n  type VCoinUserConfig,\n  type VCoinServerClient,\n  type VCoinUserClient,\n} from \"./types\";\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@versenco/vcoin-client",
+  "version": "0.1.0",
+  "description": "Server and user-session TypeScript client for Versenco's vCoin API",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Versenco/versenco-shared.git",
+    "directory": "packages/vcoin-client"
+  },
+  "type": "module",
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": { "types": "./dist/index.d.ts", "default": "./dist/index.js" },
+      "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" }
+    }
+  },
+  "files": ["dist", "README.md", "LICENSE"],
+  "publishConfig": { "access": "public" },
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "devDependencies": {
+    "tsup": "^8.3.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.1.0"
+  }
+}