@goodz-core/sdk 0.3.3 → 0.3.4

package/README.md

@@ -462,12 +462,41 @@ try {
 
 | Code | HTTP | Meaning | Action |
 |------|------|---------|--------|
-| `BAD_REQUEST` | 400 | Invalid input or insufficient balance | Check input values |
+| `BAD_REQUEST` | 400 | Invalid input | Check input values |
+| `INSUFFICIENT_BALANCE` | 400 | Not enough Z-coin | Redirect to `e.depositUrl` |
 | `UNAUTHORIZED` | 401 | Missing or invalid token | Refresh token or re-login |
 | `FORBIDDEN` | 403 | No permission | Show permission denied |
 | `NOT_FOUND` | 404 | Resource doesn't exist | Show 404 or fallback |
 | `CONFLICT` | 409 | Version conflict | Retry the operation |
 
+### Handling Insufficient Balance (Auto-Redirect to Deposit)
+
+When a payment fails due to insufficient Z-coin, the error includes a deposit URL for seamless top-up:
+
+```ts
+import { GoodZApiError } from "@goodz-core/sdk";
+
+try {
+  await goodz.zcoin.mintAndCharge({ /* gacha pull */ });
+} catch (err) {
+  if (err instanceof GoodZApiError && err.isInsufficientBalance()) {
+    // Option 1: Redirect to Core's deposit page (simplest)
+    window.open(err.depositUrl, '_blank');
+
+    // Option 2: Build a custom deposit URL with return_url
+    const depositUrl = await goodz.zcoin.getDepositUrl({
+      amount: 100,  // pre-select 100 Z-coin package
+      returnUrl: window.location.href,
+      appId: 'od_myapp',
+    });
+    window.open(depositUrl.url, '_blank');
+  }
+}
+```
+
+The `isInsufficientBalance()` helper and `depositUrl` getter work for all payment methods:
+`commercialTransfer`, `mintAndCharge`, and `chargeUser`.
+
 ## UI Components (React)
 
 The SDK includes a React component for displaying GoodZ collectibles with full material effects and tilt interaction — the same experience used on GoodZ.Core itself.

package/dist/alive/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as TransportConfig } from '../transport-CzoXrUZs.js';
+import { $ as TransportConfig } from '../transport-BSpGsxyt.js';
 
 /**
  * @goodz-core/sdk — Alive API Type Definitions

package/dist/alive/index.js

@@ -1,4 +1,4 @@
-export { createAliveNamespace } from '../chunk-JAVMQXJM.js';
-import '../chunk-4SU7SU7K.js';
+export { createAliveNamespace } from '../chunk-KP7DP5LP.js';
+import '../chunk-ORUFMYZB.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/{chunk-EQUAL5M6.js → chunk-DSWHCVKV.js}

@@ -1,7 +1,7 @@
-import { createCommerceNamespace } from './chunk-V73MMKHI.js';
-import { createExchangeNamespace } from './chunk-OUKZ2PRD.js';
-import { createAliveNamespace } from './chunk-JAVMQXJM.js';
-import { createMcpTransportConfig, callMutation, callQuery } from './chunk-4SU7SU7K.js';
+import { createCommerceNamespace } from './chunk-SWD7BJQ7.js';
+import { createExchangeNamespace } from './chunk-GH33FPMY.js';
+import { createAliveNamespace } from './chunk-KP7DP5LP.js';
+import { createMcpTransportConfig, callMutation, callQuery } from './chunk-ORUFMYZB.js';
 
 // src/core/index.ts
 var DEFAULT_CORE_URL = "https://goodzcore.manus.space";
@@ -99,5 +99,5 @@ function createGoodZClient(config = {}) {
 var createUserClient = createGoodZClient;
 
 export { createGoodZClient, createUserClient };
-//# sourceMappingURL=chunk-EQUAL5M6.js.map
-//# sourceMappingURL=chunk-EQUAL5M6.js.map
+//# sourceMappingURL=chunk-DSWHCVKV.js.map
+//# sourceMappingURL=chunk-DSWHCVKV.js.map

package/dist/chunk-DSWHCVKV.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/core/index.ts"],"names":[],"mappings":"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","file":"chunk-DSWHCVKV.js","sourcesContent":["/**\n * @goodz-core/sdk/core — Unified GoodZ API Client\n *\n * One client, all services. Stripe-style namespace architecture:\n *   goodz.zcoin.*       → Core settlement & Z-coin\n *   goodz.inventory.*   → Core instance management\n *   goodz.collectible.* → Core card queries\n *   goodz.user.*        → Core user profiles\n *   goodz.auth.*        → Core auth\n *   goodz.ip.*          → Core IP (franchise/series/card)\n *   goodz.commerce.*    → Commerce/Shops (MCP)\n *   goodz.exchange.*    → Exchange marketplace (MCP)\n *   goodz.alive.*       → Alive companions (MCP)\n *\n * Core uses tRPC HTTP wire protocol; sub-sites use MCP JSON-RPC 2.0.\n * The client handles routing transparently.\n *\n * @example\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk\";\n *\n * const goodz = createGoodZClient({\n *   accessToken: \"your-jwt-token\",\n * });\n *\n * // Core APIs\n * const balance = await goodz.zcoin.getMyBalance();\n * const result = await goodz.zcoin.commercialTransfer({ ... });\n *\n * // Commerce APIs\n * const shop = await goodz.commerce.createShop({ name: \"My Shop\" });\n * const order = await goodz.commerce.executePurchase({ campaignId: 1, quantity: 1 });\n *\n * // Exchange APIs\n * const listing = await goodz.exchange.createListing({ ... });\n * const data = await goodz.exchange.getMarketData({ coreGoodzId: 42 });\n *\n * // Alive APIs\n * const chat = await goodz.alive.sendMessage({ instanceId: 1, userId: 1, message: \"Hello!\" });\n * const memories = await goodz.alive.recallMemories({ instanceId: 1, userId: 1, query: \"birthday\" });\n * ```\n *\n * @module\n */\n\nimport { callQuery, callMutation, GoodZApiError } from \"../transport\";\nimport type { TransportConfig } from \"../transport\";\nimport { createMcpTransportConfig } from \"../mcp-transport\";\nimport { createCommerceNamespace } from \"../commerce/index\";\nimport type { CommerceNamespace } from \"../commerce/index\";\nimport { createExchangeNamespace } from \"../exchange/index\";\nimport type { ExchangeNamespace } from \"../exchange/index\";\nimport { createAliveNamespace } from \"../alive/index\";\nimport type { AliveNamespace } from \"../alive/index\";\nimport type {\n  // zcoin\n  ZcoinGetMyBalanceOutput,\n  ZcoinGetMyHistoryInput,\n  ZcoinCommercialTransferInput,\n  ZcoinCommercialTransferOutput,\n  ZcoinMintAndChargeInput,\n  ZcoinMintAndChargeOutput,\n  ZcoinChargeUserInput,\n  ZcoinChargeUserOutput,\n  ZcoinCreateDirectPurchaseOrderInput,\n  ZcoinCreateDirectPurchaseOrderOutput,\n  ZcoinGetDepositPackagesInput,\n  ZcoinDepositPackage,\n  ZcoinCreateDepositOrderInput,\n  ZcoinCreateDepositOrderOutput,\n  ZcoinGetDepositStatusInput,\n  ZcoinGetDepositStatusOutput,\n  ZcoinGetDepositUrlInput,\n  ZcoinGetDepositUrlOutput,\n  // inventory\n  InventoryGetUserInventoryInput,\n  InventoryItem,\n  InventoryConfirmOwnershipInput,\n  InventoryConfirmOwnershipOutput,\n  InventoryMintInput,\n  InventoryMintOutput,\n  InventoryTransferInput,\n  InventoryTransferOutput,\n  InventoryTransferByCardInput,\n  InventoryTransferByCardOutput,\n  InventoryGrantMintAuthInput,\n  InventoryTransferHistoryInput,\n  // collectible\n  CollectibleGetInstanceByIdInput,\n  CollectibleGetPublicInstanceInput,\n  CollectibleGetPublicInstancesBatchInput,\n  CollectibleGetCardProfileInput,\n  CollectibleGetShellImageUrlInput,\n  // user\n  UserGetPublicProfileInput,\n  UserPublicProfile,\n  UserGetPublicProfileByIdInput,\n  // auth\n  AuthGetOAuthAppInfoInput,\n  AuthOAuthAppInfo,\n  AuthUser,\n  // ip\n  FranchiseGetInput,\n  SeriesGetInput,\n  SeriesListByFranchiseInput,\n  CardGetInput,\n  CardListBySeriesInput,\n} from \"../types\";\n\n// ─── Re-export types and error class ─────────────────────────\n\nexport { GoodZApiError } from \"../transport\";\nexport type * from \"../types\";\nexport type * from \"../types-commerce\";\nexport type * from \"../types-exchange\";\nexport type * from \"../types-alive\";\nexport type { CommerceNamespace } from \"../commerce/index\";\nexport type { ExchangeNamespace } from \"../exchange/index\";\nexport type { AliveNamespace } from \"../alive/index\";\n\n// ─── Default sub-site URLs ──────────────────────────────────\n\nconst DEFAULT_CORE_URL = \"https://goodzcore.manus.space\";\nconst DEFAULT_COMMERCE_URL = \"https://goodzcommerce.manus.space\";\nconst DEFAULT_EXCHANGE_URL = \"https://goodzexchange.manus.space\";\nconst DEFAULT_ALIVE_URL = \"https://goodzalive.manus.space\";\n\n// ─── Client config ───────────────────────────────────────────\n\nexport interface GoodZClientConfig {\n  /**\n   * GoodZ.Core base URL.\n   * @default \"https://goodzcore.manus.space\"\n   */\n  coreUrl?: string;\n\n  /**\n   * GoodZ.Commerce (Shops) base URL.\n   * @default \"https://goodzcommerce.manus.space\"\n   */\n  commerceUrl?: string;\n\n  /**\n   * GoodZ.Exchange base URL.\n   * @default \"https://goodzexchange.manus.space\"\n   */\n  exchangeUrl?: string;\n\n  /**\n   * GoodZ.Alive base URL.\n   * @default \"https://goodzalive.manus.space\"\n   */\n  aliveUrl?: string;\n\n  /**\n   * Static access token (JWT) for authentication.\n   * For server-to-server calls, obtain this via OAuth client_credentials flow.\n   * For user-context calls, pass the user's access token.\n   */\n  accessToken?: string;\n\n  /**\n   * Dynamic token provider — called before every request.\n   * Use this when tokens may rotate (e.g., auto-refresh).\n   * Takes precedence over `accessToken` if both are set.\n   */\n  getAccessToken?: () => string | Promise<string>;\n\n  /**\n   * Custom headers to include in every request.\n   * Useful for passing app identifiers or tracing headers.\n   */\n  headers?: Record<string, string>;\n}\n\n// ─── Core namespace interfaces (tRPC) ───────────────────────\n\nexport interface ZcoinNamespace {\n  /** Get the authenticated user's Z-coin balance. */\n  getMyBalance(): Promise<ZcoinGetMyBalanceOutput>;\n\n  /** Get the authenticated user's Z-coin transaction history. */\n  getMyHistory(input?: ZcoinGetMyHistoryInput): Promise<any[]>;\n\n  /** Get available Z-coin deposit packages with pricing. */\n  getDepositPackages(input?: ZcoinGetDepositPackagesInput): Promise<ZcoinDepositPackage[]>;\n\n  /** Create a Stripe checkout session for Z-coin deposit. */\n  createDepositOrder(input: ZcoinCreateDepositOrderInput): Promise<ZcoinCreateDepositOrderOutput>;\n\n  /** Check the status of a deposit checkout session. */\n  getDepositStatus(input: ZcoinGetDepositStatusInput): Promise<ZcoinGetDepositStatusOutput>;\n\n  /**\n   * Generate a deposit deep link URL for Z-coin top-up.\n   * Returns a URL that redirects users to Core's deposit page.\n   * After completing the deposit, the user is redirected back to returnUrl.\n   *\n   * No authentication required — anyone can generate a deposit URL.\n   *\n   * @example\n   * ```ts\n   * const { url } = await goodz.zcoin.getDepositUrl({\n   *   amount: 100,\n   *   returnUrl: \"https://myapp.com/shop\",\n   *   appId: \"od_myapp\",\n   * });\n   * window.open(url, \"_blank\");\n   * ```\n   */\n  getDepositUrl(input?: ZcoinGetDepositUrlInput): Promise<ZcoinGetDepositUrlOutput>;\n\n  /**\n   * Atomic commercial transfer: Z-coin payment + ownership transfer in one transaction.\n   * This is the primary API for Commerce and Exchange purchase flows.\n   *\n   * Idempotent via referenceId — duplicate calls return the same result.\n   *\n   * @throws {GoodZApiError} INSUFFICIENT_BALANCE — use `e.isInsufficientBalance()` to detect,\n   *   `e.depositUrl` to get the top-up redirect URL\n   * @throws {GoodZApiError} CONFLICT — version conflict (retry)\n   * @throws {GoodZApiError} FORBIDDEN — seller doesn't own instance\n   */\n  commercialTransfer(input: ZcoinCommercialTransferInput): Promise<ZcoinCommercialTransferOutput>;\n\n  /**\n   * Mint a new card instance and charge the buyer in one atomic transaction.\n   * Used by Commerce for gacha and direct-from-creator purchases.\n   *\n   * Requires mint authorization (granted via inventory.grantMintAuth).\n   * Idempotent via referenceId.\n   *\n   * @throws {GoodZApiError} FORBIDDEN — no mint authorization\n   * @throws {GoodZApiError} INSUFFICIENT_BALANCE — use `e.isInsufficientBalance()` to detect,\n   *   `e.depositUrl` to get the top-up redirect URL\n   */\n  mintAndCharge(input: ZcoinMintAndChargeInput): Promise<ZcoinMintAndChargeOutput>;\n\n  /**\n   * Charge a user's Z-coin balance for an in-app purchase.\n   * Used by apps that sell non-GoodZ digital goods/services.\n   *\n   * Idempotent via appOrderId.\n   *\n   * @throws {GoodZApiError} INSUFFICIENT_BALANCE — use `e.isInsufficientBalance()` to detect,\n   *   `e.depositUrl` to get the top-up redirect URL\n   * @throws {GoodZApiError} CONFLICT — version conflict\n   */\n  chargeUser(input: ZcoinChargeUserInput): Promise<ZcoinChargeUserOutput>;\n\n  /**\n   * Create a direct purchase checkout session (fiat → Z-coin → transfer).\n   * Transparent intermediation: user sees fiat price, Core handles conversion.\n   */\n  createDirectPurchaseOrder(input: ZcoinCreateDirectPurchaseOrderInput): Promise<ZcoinCreateDirectPurchaseOrderOutput>;\n}\n\nexport interface InventoryNamespace {\n  /** Get a user's inventory (owned card instances). */\n  getUserInventory(input: InventoryGetUserInventoryInput): Promise<InventoryItem[]>;\n\n  /** Check if a user owns at least one instance of a specific card. */\n  confirmOwnership(input: InventoryConfirmOwnershipInput): Promise<InventoryConfirmOwnershipOutput>;\n\n  /**\n   * Mint new card instances. Requires franchise ownership or admin role.\n   * For Commerce/Exchange, use zcoin.mintAndCharge instead (includes payment).\n   */\n  mint(input: InventoryMintInput): Promise<InventoryMintOutput>;\n\n  /**\n   * Transfer a specific card instance to another user.\n   * For commercial transfers, use zcoin.commercialTransfer instead.\n   *\n   * @deprecated for reason=\"purchase\"|\"trade\" — use commercialTransfer\n   */\n  transfer(input: InventoryTransferInput): Promise<InventoryTransferOutput>;\n\n  /**\n   * Transfer card instances by cardId (transfers oldest instances).\n   * For commercial transfers, use zcoin.commercialTransfer instead.\n   *\n   * @deprecated for reason=\"purchase\"|\"trade\" — use commercialTransfer\n   */\n  transferByCard(input: InventoryTransferByCardInput): Promise<InventoryTransferByCardOutput>;\n\n  /**\n   * Grant mint authorization to another user/app for a specific card.\n   * Required before Commerce can call zcoin.mintAndCharge for that card.\n   */\n  grantMintAuth(input: InventoryGrantMintAuthInput): Promise<any>;\n\n  /** Get transfer/ownership history for an instance, card, or user. */\n  transferHistory(input: InventoryTransferHistoryInput): Promise<any[]>;\n}\n\nexport interface CollectibleNamespace {\n  /** Get a card instance by its numeric ID. Returns full instance data with card chain. */\n  getInstanceById(input: CollectibleGetInstanceByIdInput): Promise<any>;\n\n  /** Get a card instance by its instance code (public-facing identifier). */\n  getPublicInstance(input: CollectibleGetPublicInstanceInput): Promise<any>;\n\n  /** Batch-fetch multiple card instances by their IDs (max 100). */\n  getPublicInstancesBatch(input: CollectibleGetPublicInstancesBatchInput): Promise<any[]>;\n\n  /** Get the card profile (metadata, rarity, series info). */\n  getCardProfile(input: CollectibleGetCardProfileInput): Promise<any>;\n\n  /** Get the shell (packaging) image URL for a card. */\n  getShellImageUrl(input: CollectibleGetShellImageUrlInput): Promise<any>;\n}\n\nexport interface UserNamespace {\n  /** Get a user's public profile by openId. */\n  getPublicProfile(input: UserGetPublicProfileInput): Promise<UserPublicProfile>;\n\n  /** Get a user's public profile by internal userId. */\n  getPublicProfileById(input: UserGetPublicProfileByIdInput): Promise<UserPublicProfile>;\n}\n\nexport interface AuthNamespace {\n  /** Get the authenticated user's profile. Returns null if not authenticated. */\n  me(): Promise<AuthUser | null>;\n\n  /** Get public info about an OAuth app by its client ID. */\n  getOAuthAppInfo(input: AuthGetOAuthAppInfoInput): Promise<AuthOAuthAppInfo | null>;\n}\n\nexport interface IpNamespace {\n  /** Get a franchise by ID or slug. */\n  getFranchise(input: FranchiseGetInput): Promise<any>;\n\n  /** Get a series by ID or slug. */\n  getSeries(input: SeriesGetInput): Promise<any>;\n\n  /** List all series in a franchise. */\n  listSeriesByFranchise(input: SeriesListByFranchiseInput): Promise<any[]>;\n\n  /** Get a card by ID. */\n  getCard(input: CardGetInput): Promise<any>;\n\n  /** List all cards in a series. */\n  listCardsBySeries(input: CardListBySeriesInput): Promise<any[]>;\n}\n\n// ─── GoodZClient type ────────────────────────────────────────\n\nexport interface GoodZClient {\n  // ── Core namespaces (tRPC) ──\n  readonly zcoin: ZcoinNamespace;\n  readonly inventory: InventoryNamespace;\n  readonly collectible: CollectibleNamespace;\n  readonly user: UserNamespace;\n  readonly auth: AuthNamespace;\n  readonly ip: IpNamespace;\n\n  // ── Sub-site namespaces (MCP) ──\n  readonly commerce: CommerceNamespace;\n  readonly exchange: ExchangeNamespace;\n  readonly alive: AliveNamespace;\n\n  /**\n   * Make a raw tRPC query call to Core. Use this for routes not yet covered\n   * by the typed namespaces.\n   */\n  rawQuery<T = any>(path: string, input?: any): Promise<T>;\n\n  /**\n   * Make a raw tRPC mutation call to Core. Use this for routes not yet covered\n   * by the typed namespaces.\n   */\n  rawMutation<T = any>(path: string, input?: any): Promise<T>;\n}\n\n// ─── Client factory ──────────────────────────────────────────\n\n/**\n * Create a unified GoodZ API client — one client for all services.\n *\n * @example Server-to-server with static token\n * ```ts\n * const goodz = createGoodZClient({\n *   accessToken: process.env.CORE_ACCESS_TOKEN,\n * });\n *\n * // Core\n * const balance = await goodz.zcoin.getMyBalance();\n *\n * // Commerce\n * const shop = await goodz.commerce.createShop({ name: \"My Shop\" });\n *\n * // Exchange\n * const listings = await goodz.exchange.browseMarketplace();\n *\n * // Alive\n * const chat = await goodz.alive.sendMessage({ instanceId: 1, userId: 1, message: \"Hi!\" });\n * ```\n *\n * @example With dynamic token provider (auto-refresh)\n * ```ts\n * const goodz = createGoodZClient({\n *   getAccessToken: async () => {\n *     const token = await refreshTokenIfNeeded();\n *     return token;\n *   },\n * });\n * ```\n *\n * @example Custom sub-site URLs (e.g., staging environment)\n * ```ts\n * const goodz = createGoodZClient({\n *   accessToken: \"...\",\n *   coreUrl: \"https://staging-core.goodz.dev\",\n *   commerceUrl: \"https://staging-commerce.goodz.dev\",\n *   exchangeUrl: \"https://staging-exchange.goodz.dev\",\n *   aliveUrl: \"https://staging-alive.goodz.dev\",\n * });\n * ```\n */\nexport function createGoodZClient(config: GoodZClientConfig = {}): GoodZClient {\n  const {\n    coreUrl = DEFAULT_CORE_URL,\n    commerceUrl = DEFAULT_COMMERCE_URL,\n    exchangeUrl = DEFAULT_EXCHANGE_URL,\n    aliveUrl = DEFAULT_ALIVE_URL,\n    accessToken,\n    getAccessToken,\n    headers: customHeaders,\n  } = config;\n\n  // Shared header builder — used by both tRPC and MCP transports\n  const buildHeaders = async (): Promise<Record<string, string>> => {\n    const h: Record<string, string> = { ...customHeaders };\n    const token = getAccessToken ? await getAccessToken() : accessToken;\n    if (token) {\n      h[\"Authorization\"] = `Bearer ${token}`;\n    }\n    return h;\n  };\n\n  // ── Core transport (tRPC) ──\n  const coreTransport: TransportConfig = {\n    baseUrl: coreUrl.replace(/\\/$/, \"\"),\n    getHeaders: buildHeaders,\n  };\n\n  // ── Sub-site transports (MCP) ──\n  const commerceTransport = createMcpTransportConfig(commerceUrl, buildHeaders);\n  const exchangeTransport = createMcpTransportConfig(exchangeUrl, buildHeaders);\n  const aliveTransport = createMcpTransportConfig(aliveUrl, buildHeaders);\n\n  // Helper shortcuts for Core tRPC\n  const q = <I, O>(path: string) => (input?: I) => callQuery<I, O>(coreTransport, path, input);\n  const m = <I, O>(path: string) => (input?: I) => callMutation<I, O>(coreTransport, path, input);\n\n  return {\n    // ── zcoin ──────────────────────────────────────────────\n    zcoin: {\n      getMyBalance: q<void, ZcoinGetMyBalanceOutput>(\"zcoin.getMyBalance\"),\n      getMyHistory: q<ZcoinGetMyHistoryInput, any[]>(\"zcoin.getMyHistory\"),\n      getDepositPackages: q<ZcoinGetDepositPackagesInput, ZcoinDepositPackage[]>(\"zcoin.getDepositPackages\"),\n      createDepositOrder: m<ZcoinCreateDepositOrderInput, ZcoinCreateDepositOrderOutput>(\"zcoin.createDepositOrder\"),\n      getDepositStatus: q<ZcoinGetDepositStatusInput, ZcoinGetDepositStatusOutput>(\"zcoin.getDepositStatus\"),\n      getDepositUrl: q<ZcoinGetDepositUrlInput, ZcoinGetDepositUrlOutput>(\"zcoin.getDepositUrl\"),\n      commercialTransfer: m<ZcoinCommercialTransferInput, ZcoinCommercialTransferOutput>(\"zcoin.commercialTransfer\"),\n      mintAndCharge: m<ZcoinMintAndChargeInput, ZcoinMintAndChargeOutput>(\"zcoin.mintAndCharge\"),\n      chargeUser: m<ZcoinChargeUserInput, ZcoinChargeUserOutput>(\"zcoin.chargeUser\"),\n      createDirectPurchaseOrder: m<ZcoinCreateDirectPurchaseOrderInput, ZcoinCreateDirectPurchaseOrderOutput>(\"zcoin.createDirectPurchaseOrder\"),\n    },\n\n    // ── inventory ──────────────────────────────────────────\n    inventory: {\n      getUserInventory: q<InventoryGetUserInventoryInput, InventoryItem[]>(\"inventory.getUserInventory\"),\n      confirmOwnership: q<InventoryConfirmOwnershipInput, InventoryConfirmOwnershipOutput>(\"inventory.confirmOwnership\"),\n      mint: m<InventoryMintInput, InventoryMintOutput>(\"inventory.mint\"),\n      transfer: m<InventoryTransferInput, InventoryTransferOutput>(\"inventory.transfer\"),\n      transferByCard: m<InventoryTransferByCardInput, InventoryTransferByCardOutput>(\"inventory.transferByCard\"),\n      grantMintAuth: m<InventoryGrantMintAuthInput, any>(\"inventory.grantMintAuth\"),\n      transferHistory: q<InventoryTransferHistoryInput, any[]>(\"inventory.transferHistory\"),\n    },\n\n    // ── collectible ────────────────────────────────────────\n    collectible: {\n      getInstanceById: q<CollectibleGetInstanceByIdInput, any>(\"collectible.getInstanceById\"),\n      getPublicInstance: q<CollectibleGetPublicInstanceInput, any>(\"collectible.getPublicInstance\"),\n      getPublicInstancesBatch: q<CollectibleGetPublicInstancesBatchInput, any[]>(\"collectible.getPublicInstancesBatch\"),\n      getCardProfile: q<CollectibleGetCardProfileInput, any>(\"collectible.getCardProfile\"),\n      getShellImageUrl: q<CollectibleGetShellImageUrlInput, any>(\"collectible.getShellImageUrl\"),\n    },\n\n    // ── user ───────────────────────────────────────────────\n    user: {\n      getPublicProfile: q<UserGetPublicProfileInput, UserPublicProfile>(\"user.getPublicProfile\"),\n      getPublicProfileById: q<UserGetPublicProfileByIdInput, UserPublicProfile>(\"user.getPublicProfileById\"),\n    },\n\n    // ── auth ───────────────────────────────────────────────\n    auth: {\n      me: q<void, AuthUser | null>(\"auth.me\"),\n      getOAuthAppInfo: q<AuthGetOAuthAppInfoInput, AuthOAuthAppInfo | null>(\"auth.getOAuthAppInfo\"),\n    },\n\n    // ── ip (franchise/series/card) ─────────────────────────\n    ip: {\n      getFranchise: q<FranchiseGetInput, any>(\"franchise.get\"),\n      getSeries: q<SeriesGetInput, any>(\"series.get\"),\n      listSeriesByFranchise: q<SeriesListByFranchiseInput, any[]>(\"series.listByFranchise\"),\n      getCard: q<CardGetInput, any>(\"card.get\"),\n      listCardsBySeries: q<CardListBySeriesInput, any[]>(\"card.listBySeries\"),\n    },\n\n    // ── commerce (MCP) ─────────────────────────────────────\n    commerce: createCommerceNamespace(commerceTransport),\n\n    // ── exchange (MCP) ─────────────────────────────────────\n    exchange: createExchangeNamespace(exchangeTransport),\n\n    // ── alive (MCP) ────────────────────────────────────────\n    alive: createAliveNamespace(aliveTransport),\n\n    // ── raw escape hatches (Core tRPC only) ────────────────\n    rawQuery: <T = any>(path: string, input?: any) => callQuery<any, T>(coreTransport, path, input),\n    rawMutation: <T = any>(path: string, input?: any) => callMutation<any, T>(coreTransport, path, input),\n  };\n}\n\n/**\n * Alias for createGoodZClient — creates a client acting on behalf of a user.\n * Semantically identical, but makes the intent clearer in server-to-server code.\n */\nexport const createUserClient = createGoodZClient;\n"]}

package/dist/{chunk-OUKZ2PRD.js → chunk-GH33FPMY.js}

@@ -1,4 +1,4 @@
-import { callMcpTool } from './chunk-4SU7SU7K.js';
+import { callMcpTool } from './chunk-ORUFMYZB.js';
 
 // src/exchange/index.ts
 function createExchangeNamespace(transport) {
@@ -33,5 +33,5 @@ function createExchangeNamespace(transport) {
 }
 
 export { createExchangeNamespace };
-//# sourceMappingURL=chunk-OUKZ2PRD.js.map
-//# sourceMappingURL=chunk-OUKZ2PRD.js.map
+//# sourceMappingURL=chunk-GH33FPMY.js.map
+//# sourceMappingURL=chunk-GH33FPMY.js.map

package/dist/{chunk-OUKZ2PRD.js.map → chunk-GH33FPMY.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/exchange/index.ts"],"names":[],"mappings":";;;AAqGO,SAAS,wBAAwB,SAAA,EAA+C;AACrF,EAAA,MAAM,IAAA,GAAO,CAAmC,IAAA,KAC9C,CAAC,UAAc,WAAA,CAAkB,SAAA,EAAW,MAAM,KAAU,CAAA;AAE9D,EAAA,OAAO;AAAA;AAAA,IAEL,iBAAA,EAAmB,KAAwD,oBAAoB,CAAA;AAAA,IAC/F,gBAAA,EAAkB,KAAqD,oBAAoB,CAAA;AAAA;AAAA,IAG3F,aAAA,EAAe,KAA8D,gBAAgB,CAAA;AAAA,IAC7F,aAAA,EAAe,KAAsC,gBAAgB,CAAA;AAAA;AAAA,IAGrE,UAAA,EAAY,KAAwD,aAAa,CAAA;AAAA,IACjF,QAAA,EAAU,KAAoD,WAAW,CAAA;AAAA,IACzE,OAAA,EAAS,KAA0C,UAAU,CAAA;AAAA;AAAA,IAG7D,SAAA,EAAW,KAA0C,YAAY,CAAA;AAAA,IACjE,UAAA,EAAY,KAAwD,aAAa,CAAA;AAAA,IACjF,SAAA,EAAW,KAAkC,YAAY,CAAA;AAAA;AAAA,IAGzD,YAAA,EAAc,KAAuD,eAAe,CAAA;AAAA,IACpF,cAAA,EAAgB,KAAgE,kBAAkB,CAAA;AAAA;AAAA,IAGlG,YAAA,EAAc,KAAqD,eAAe,CAAA;AAAA,IAClF,cAAA,EAAgB,KAAyD,kBAAkB,CAAA;AAAA,IAC3F,mBAAA,EAAqB,KAA4C,uBAAuB,CAAA;AAAA;AAAA,IAGxF,aAAA,EAAe,KAAqD,iBAAiB,CAAA;AAAA;AAAA,IAGrF,SAAS,CAAU,QAAA,EAAkB,SACnC,WAAA,CAAoC,SAAA,EAAW,UAAU,IAAI;AAAA,GACjE;AACF","file":"chunk-OUKZ2PRD.js","sourcesContent":["/**\n * @goodz-core/sdk — Exchange Namespace\n *\n * Provides typed access to GoodZ.Exchange MCP tools:\n * marketplace listings, auctions, WTB, P2P trades,\n * watchlist, and market data.\n *\n * All prices are in Z-coin (1 Z-coin = $0.10 USD).\n *\n * @module\n */\n\nimport { callMcpTool } from \"../mcp-transport\";\nimport type { TransportConfig } from \"../mcp-transport\";\nimport type {\n  ExchangeBrowseMarketplaceInput,\n  ExchangeListing,\n  ExchangeGetListingDetailInput,\n  ExchangeCreateListingInput,\n  ExchangeCreateListingOutput,\n  ExchangeCancelListingInput,\n  ExchangeBuyListingInput,\n  ExchangeBuyListingOutput,\n  ExchangePlaceBidInput,\n  ExchangePlaceBidOutput,\n  ExchangeGetBidsInput,\n  ExchangeBid,\n  ExchangeCreateWtbInput,\n  ExchangeWtb,\n  ExchangeFulfillWtbInput,\n  ExchangeFulfillWtbOutput,\n  ExchangeCancelWtbInput,\n  ExchangeProposeTradeInput,\n  ExchangeTradeProposal,\n  ExchangeRespondToTradeInput,\n  ExchangeRespondToTradeOutput,\n  ExchangeAddToWatchlistInput,\n  ExchangeWatchlistItem,\n  ExchangeRemoveFromWatchlistInput,\n  ExchangeGetMarketDataInput,\n  ExchangeMarketData,\n} from \"../types-exchange\";\n\n// Re-export all Exchange types\nexport type * from \"../types-exchange\";\n\n// ─── Namespace interface ────────────────────────────────────\n\nexport interface ExchangeNamespace {\n  // Marketplace\n  /** Browse active marketplace listings. */\n  browseMarketplace(input?: ExchangeBrowseMarketplaceInput): Promise<ExchangeListing[]>;\n  /** Get detailed info about a specific listing. */\n  getListingDetail(input: ExchangeGetListingDetailInput): Promise<ExchangeListing>;\n\n  // Listing Management\n  /** Create a new listing (fixed_price or auction). Core locks the instance atomically. */\n  createListing(input: ExchangeCreateListingInput): Promise<ExchangeCreateListingOutput>;\n  /** Cancel an active listing. Core unlocks the instance. */\n  cancelListing(input: ExchangeCancelListingInput): Promise<any>;\n\n  // Purchase & Bidding\n  /** Buy a fixed-price listing. Z-coin debit + ownership transfer via Core settlement. */\n  buyListing(input: ExchangeBuyListingInput): Promise<ExchangeBuyListingOutput>;\n  /** Place a bid on an auction. If bid meets buy-now price, immediate purchase is executed. */\n  placeBid(input: ExchangePlaceBidInput): Promise<ExchangePlaceBidOutput>;\n  /** Get all bids for an auction listing (highest first). */\n  getBids(input: ExchangeGetBidsInput): Promise<ExchangeBid[]>;\n\n  // Want-to-Buy\n  /** Create a WTB request — announce what you're looking for. */\n  createWtb(input: ExchangeCreateWtbInput): Promise<ExchangeWtb>;\n  /** Fulfill a WTB request by offering your item. Settlement via Core. */\n  fulfillWtb(input: ExchangeFulfillWtbInput): Promise<ExchangeFulfillWtbOutput>;\n  /** Cancel your own WTB request. */\n  cancelWtb(input: ExchangeCancelWtbInput): Promise<any>;\n\n  // P2P Trade\n  /** Propose a trade/swap with another user. Optional Z-coin compensation. */\n  proposeTrade(input: ExchangeProposeTradeInput): Promise<ExchangeTradeProposal>;\n  /** Accept or reject a trade proposal. If accepted, all items transfer via Core. */\n  respondToTrade(input: ExchangeRespondToTradeInput): Promise<ExchangeRespondToTradeOutput>;\n\n  // Watchlist\n  /** Get your watchlist. */\n  getWatchlist(): Promise<ExchangeWatchlistItem[]>;\n  /** Add a GoodZ or listing to your watchlist. */\n  addToWatchlist(input: ExchangeAddToWatchlistInput): Promise<ExchangeWatchlistItem>;\n  /** Remove an item from your watchlist. */\n  removeFromWatchlist(input: ExchangeRemoveFromWatchlistInput): Promise<any>;\n\n  // Market Data\n  /** Get market data: price history, floor price, volume, trends. */\n  getMarketData(input: ExchangeGetMarketDataInput): Promise<ExchangeMarketData>;\n\n  /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */\n  rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;\n}\n\n// ─── Factory ────────────────────────────────────────────────\n\nexport function createExchangeNamespace(transport: TransportConfig): ExchangeNamespace {\n  const tool = <I extends Record<string, any>, O>(name: string) =>\n    (input?: I) => callMcpTool<I, O>(transport, name, input as I);\n\n  return {\n    // Marketplace\n    browseMarketplace: tool<ExchangeBrowseMarketplaceInput, ExchangeListing[]>(\"browse_marketplace\"),\n    getListingDetail: tool<ExchangeGetListingDetailInput, ExchangeListing>(\"get_listing_detail\"),\n\n    // Listing Management\n    createListing: tool<ExchangeCreateListingInput, ExchangeCreateListingOutput>(\"create_listing\"),\n    cancelListing: tool<ExchangeCancelListingInput, any>(\"cancel_listing\"),\n\n    // Purchase & Bidding\n    buyListing: tool<ExchangeBuyListingInput, ExchangeBuyListingOutput>(\"buy_listing\"),\n    placeBid: tool<ExchangePlaceBidInput, ExchangePlaceBidOutput>(\"place_bid\"),\n    getBids: tool<ExchangeGetBidsInput, ExchangeBid[]>(\"get_bids\"),\n\n    // WTB\n    createWtb: tool<ExchangeCreateWtbInput, ExchangeWtb>(\"create_wtb\"),\n    fulfillWtb: tool<ExchangeFulfillWtbInput, ExchangeFulfillWtbOutput>(\"fulfill_wtb\"),\n    cancelWtb: tool<ExchangeCancelWtbInput, any>(\"cancel_wtb\"),\n\n    // P2P Trade\n    proposeTrade: tool<ExchangeProposeTradeInput, ExchangeTradeProposal>(\"propose_trade\"),\n    respondToTrade: tool<ExchangeRespondToTradeInput, ExchangeRespondToTradeOutput>(\"respond_to_trade\"),\n\n    // Watchlist\n    getWatchlist: tool<Record<string, never>, ExchangeWatchlistItem[]>(\"get_watchlist\"),\n    addToWatchlist: tool<ExchangeAddToWatchlistInput, ExchangeWatchlistItem>(\"add_to_watchlist\"),\n    removeFromWatchlist: tool<ExchangeRemoveFromWatchlistInput, any>(\"remove_from_watchlist\"),\n\n    // Market Data\n    getMarketData: tool<ExchangeGetMarketDataInput, ExchangeMarketData>(\"get_market_data\"),\n\n    // Raw escape hatch\n    rawTool: <T = any>(toolName: string, args?: Record<string, any>) =>\n      callMcpTool<Record<string, any>, T>(transport, toolName, args),\n  };\n}\n"]}
+{"version":3,"sources":["../src/exchange/index.ts"],"names":[],"mappings":";;;AAqGO,SAAS,wBAAwB,SAAA,EAA+C;AACrF,EAAA,MAAM,IAAA,GAAO,CAAmC,IAAA,KAC9C,CAAC,UAAc,WAAA,CAAkB,SAAA,EAAW,MAAM,KAAU,CAAA;AAE9D,EAAA,OAAO;AAAA;AAAA,IAEL,iBAAA,EAAmB,KAAwD,oBAAoB,CAAA;AAAA,IAC/F,gBAAA,EAAkB,KAAqD,oBAAoB,CAAA;AAAA;AAAA,IAG3F,aAAA,EAAe,KAA8D,gBAAgB,CAAA;AAAA,IAC7F,aAAA,EAAe,KAAsC,gBAAgB,CAAA;AAAA;AAAA,IAGrE,UAAA,EAAY,KAAwD,aAAa,CAAA;AAAA,IACjF,QAAA,EAAU,KAAoD,WAAW,CAAA;AAAA,IACzE,OAAA,EAAS,KAA0C,UAAU,CAAA;AAAA;AAAA,IAG7D,SAAA,EAAW,KAA0C,YAAY,CAAA;AAAA,IACjE,UAAA,EAAY,KAAwD,aAAa,CAAA;AAAA,IACjF,SAAA,EAAW,KAAkC,YAAY,CAAA;AAAA;AAAA,IAGzD,YAAA,EAAc,KAAuD,eAAe,CAAA;AAAA,IACpF,cAAA,EAAgB,KAAgE,kBAAkB,CAAA;AAAA;AAAA,IAGlG,YAAA,EAAc,KAAqD,eAAe,CAAA;AAAA,IAClF,cAAA,EAAgB,KAAyD,kBAAkB,CAAA;AAAA,IAC3F,mBAAA,EAAqB,KAA4C,uBAAuB,CAAA;AAAA;AAAA,IAGxF,aAAA,EAAe,KAAqD,iBAAiB,CAAA;AAAA;AAAA,IAGrF,SAAS,CAAU,QAAA,EAAkB,SACnC,WAAA,CAAoC,SAAA,EAAW,UAAU,IAAI;AAAA,GACjE;AACF","file":"chunk-GH33FPMY.js","sourcesContent":["/**\n * @goodz-core/sdk — Exchange Namespace\n *\n * Provides typed access to GoodZ.Exchange MCP tools:\n * marketplace listings, auctions, WTB, P2P trades,\n * watchlist, and market data.\n *\n * All prices are in Z-coin (1 Z-coin = $0.10 USD).\n *\n * @module\n */\n\nimport { callMcpTool } from \"../mcp-transport\";\nimport type { TransportConfig } from \"../mcp-transport\";\nimport type {\n  ExchangeBrowseMarketplaceInput,\n  ExchangeListing,\n  ExchangeGetListingDetailInput,\n  ExchangeCreateListingInput,\n  ExchangeCreateListingOutput,\n  ExchangeCancelListingInput,\n  ExchangeBuyListingInput,\n  ExchangeBuyListingOutput,\n  ExchangePlaceBidInput,\n  ExchangePlaceBidOutput,\n  ExchangeGetBidsInput,\n  ExchangeBid,\n  ExchangeCreateWtbInput,\n  ExchangeWtb,\n  ExchangeFulfillWtbInput,\n  ExchangeFulfillWtbOutput,\n  ExchangeCancelWtbInput,\n  ExchangeProposeTradeInput,\n  ExchangeTradeProposal,\n  ExchangeRespondToTradeInput,\n  ExchangeRespondToTradeOutput,\n  ExchangeAddToWatchlistInput,\n  ExchangeWatchlistItem,\n  ExchangeRemoveFromWatchlistInput,\n  ExchangeGetMarketDataInput,\n  ExchangeMarketData,\n} from \"../types-exchange\";\n\n// Re-export all Exchange types\nexport type * from \"../types-exchange\";\n\n// ─── Namespace interface ────────────────────────────────────\n\nexport interface ExchangeNamespace {\n  // Marketplace\n  /** Browse active marketplace listings. */\n  browseMarketplace(input?: ExchangeBrowseMarketplaceInput): Promise<ExchangeListing[]>;\n  /** Get detailed info about a specific listing. */\n  getListingDetail(input: ExchangeGetListingDetailInput): Promise<ExchangeListing>;\n\n  // Listing Management\n  /** Create a new listing (fixed_price or auction). Core locks the instance atomically. */\n  createListing(input: ExchangeCreateListingInput): Promise<ExchangeCreateListingOutput>;\n  /** Cancel an active listing. Core unlocks the instance. */\n  cancelListing(input: ExchangeCancelListingInput): Promise<any>;\n\n  // Purchase & Bidding\n  /** Buy a fixed-price listing. Z-coin debit + ownership transfer via Core settlement. */\n  buyListing(input: ExchangeBuyListingInput): Promise<ExchangeBuyListingOutput>;\n  /** Place a bid on an auction. If bid meets buy-now price, immediate purchase is executed. */\n  placeBid(input: ExchangePlaceBidInput): Promise<ExchangePlaceBidOutput>;\n  /** Get all bids for an auction listing (highest first). */\n  getBids(input: ExchangeGetBidsInput): Promise<ExchangeBid[]>;\n\n  // Want-to-Buy\n  /** Create a WTB request — announce what you're looking for. */\n  createWtb(input: ExchangeCreateWtbInput): Promise<ExchangeWtb>;\n  /** Fulfill a WTB request by offering your item. Settlement via Core. */\n  fulfillWtb(input: ExchangeFulfillWtbInput): Promise<ExchangeFulfillWtbOutput>;\n  /** Cancel your own WTB request. */\n  cancelWtb(input: ExchangeCancelWtbInput): Promise<any>;\n\n  // P2P Trade\n  /** Propose a trade/swap with another user. Optional Z-coin compensation. */\n  proposeTrade(input: ExchangeProposeTradeInput): Promise<ExchangeTradeProposal>;\n  /** Accept or reject a trade proposal. If accepted, all items transfer via Core. */\n  respondToTrade(input: ExchangeRespondToTradeInput): Promise<ExchangeRespondToTradeOutput>;\n\n  // Watchlist\n  /** Get your watchlist. */\n  getWatchlist(): Promise<ExchangeWatchlistItem[]>;\n  /** Add a GoodZ or listing to your watchlist. */\n  addToWatchlist(input: ExchangeAddToWatchlistInput): Promise<ExchangeWatchlistItem>;\n  /** Remove an item from your watchlist. */\n  removeFromWatchlist(input: ExchangeRemoveFromWatchlistInput): Promise<any>;\n\n  // Market Data\n  /** Get market data: price history, floor price, volume, trends. */\n  getMarketData(input: ExchangeGetMarketDataInput): Promise<ExchangeMarketData>;\n\n  /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */\n  rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;\n}\n\n// ─── Factory ────────────────────────────────────────────────\n\nexport function createExchangeNamespace(transport: TransportConfig): ExchangeNamespace {\n  const tool = <I extends Record<string, any>, O>(name: string) =>\n    (input?: I) => callMcpTool<I, O>(transport, name, input as I);\n\n  return {\n    // Marketplace\n    browseMarketplace: tool<ExchangeBrowseMarketplaceInput, ExchangeListing[]>(\"browse_marketplace\"),\n    getListingDetail: tool<ExchangeGetListingDetailInput, ExchangeListing>(\"get_listing_detail\"),\n\n    // Listing Management\n    createListing: tool<ExchangeCreateListingInput, ExchangeCreateListingOutput>(\"create_listing\"),\n    cancelListing: tool<ExchangeCancelListingInput, any>(\"cancel_listing\"),\n\n    // Purchase & Bidding\n    buyListing: tool<ExchangeBuyListingInput, ExchangeBuyListingOutput>(\"buy_listing\"),\n    placeBid: tool<ExchangePlaceBidInput, ExchangePlaceBidOutput>(\"place_bid\"),\n    getBids: tool<ExchangeGetBidsInput, ExchangeBid[]>(\"get_bids\"),\n\n    // WTB\n    createWtb: tool<ExchangeCreateWtbInput, ExchangeWtb>(\"create_wtb\"),\n    fulfillWtb: tool<ExchangeFulfillWtbInput, ExchangeFulfillWtbOutput>(\"fulfill_wtb\"),\n    cancelWtb: tool<ExchangeCancelWtbInput, any>(\"cancel_wtb\"),\n\n    // P2P Trade\n    proposeTrade: tool<ExchangeProposeTradeInput, ExchangeTradeProposal>(\"propose_trade\"),\n    respondToTrade: tool<ExchangeRespondToTradeInput, ExchangeRespondToTradeOutput>(\"respond_to_trade\"),\n\n    // Watchlist\n    getWatchlist: tool<Record<string, never>, ExchangeWatchlistItem[]>(\"get_watchlist\"),\n    addToWatchlist: tool<ExchangeAddToWatchlistInput, ExchangeWatchlistItem>(\"add_to_watchlist\"),\n    removeFromWatchlist: tool<ExchangeRemoveFromWatchlistInput, any>(\"remove_from_watchlist\"),\n\n    // Market Data\n    getMarketData: tool<ExchangeGetMarketDataInput, ExchangeMarketData>(\"get_market_data\"),\n\n    // Raw escape hatch\n    rawTool: <T = any>(toolName: string, args?: Record<string, any>) =>\n      callMcpTool<Record<string, any>, T>(transport, toolName, args),\n  };\n}\n"]}

package/dist/{chunk-JAVMQXJM.js → chunk-KP7DP5LP.js}

@@ -1,4 +1,4 @@
-import { callMcpTool } from './chunk-4SU7SU7K.js';
+import { callMcpTool } from './chunk-ORUFMYZB.js';
 
 // src/alive/index.ts
 function createAliveNamespace(transport) {
@@ -23,5 +23,5 @@ function createAliveNamespace(transport) {
 }
 
 export { createAliveNamespace };
-//# sourceMappingURL=chunk-JAVMQXJM.js.map
-//# sourceMappingURL=chunk-JAVMQXJM.js.map
+//# sourceMappingURL=chunk-KP7DP5LP.js.map
+//# sourceMappingURL=chunk-KP7DP5LP.js.map

package/dist/{chunk-JAVMQXJM.js.map → chunk-KP7DP5LP.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/alive/index.ts"],"names":[],"mappings":";;;AAqEO,SAAS,qBAAqB,SAAA,EAA4C;AAC/E,EAAA,MAAM,IAAA,GAAO,CAAmC,IAAA,KAC9C,CAAC,UAAc,WAAA,CAAkB,SAAA,EAAW,MAAM,KAAU,CAAA;AAE9D,EAAA,OAAO;AAAA;AAAA,IAEL,WAAA,EAAa,KAAyC,cAAc,CAAA;AAAA,IACpE,cAAA,EAAgB,KAA8C,iBAAiB,CAAA;AAAA,IAC/E,YAAA,EAAc,KAAkC,eAAe,CAAA;AAAA;AAAA,IAG/D,WAAA,EAAa,KAA2C,cAAc,CAAA;AAAA,IACtE,cAAA,EAAgB,KAA8C,iBAAiB,CAAA;AAAA;AAAA,IAG/E,YAAA,EAAc,KAA2C,eAAe,CAAA;AAAA;AAAA,IAGxE,cAAA,EAAgB,KAAsD,iBAAiB,CAAA;AAAA;AAAA,IAGvF,WAAA,EAAa,KAA+C,cAAc,CAAA;AAAA;AAAA,IAG1E,SAAS,CAAU,QAAA,EAAkB,SACnC,WAAA,CAAoC,SAAA,EAAW,UAAU,IAAI;AAAA,GACjE;AACF","file":"chunk-JAVMQXJM.js","sourcesContent":["/**\n * @goodz-core/sdk — Alive Namespace\n *\n * Provides typed access to GoodZ.Alive MCP tools:\n * memory management, intimacy/affection, context building,\n * intent classification, and chat sessions.\n *\n * GoodZ.Alive gives each GoodZ card a \"soul\" — an AI-powered\n * companion that remembers, grows, and responds uniquely.\n *\n * @module\n */\n\nimport { callMcpTool } from \"../mcp-transport\";\nimport type { TransportConfig } from \"../mcp-transport\";\nimport type {\n  AliveStoreMemoryInput,\n  AliveMemory,\n  AliveRecallMemoriesInput,\n  AliveForgetMemoryInput,\n  AliveGetIntimacyInput,\n  AliveIntimacy,\n  AliveUpdateIntimacyInput,\n  AliveBuildContextInput,\n  AliveContext,\n  AliveClassifyIntentInput,\n  AliveClassifiedIntent,\n  AliveSendMessageInput,\n  AliveChatResponse,\n} from \"../types-alive\";\n\n// Re-export all Alive types\nexport type * from \"../types-alive\";\n\n// ─── Namespace interface ────────────────────────────────────\n\nexport interface AliveNamespace {\n  // Memory\n  /** Store a new memory for a character-user pair. */\n  storeMemory(input: AliveStoreMemoryInput): Promise<AliveMemory>;\n  /** Recall relevant memories using semantic search. */\n  recallMemories(input: AliveRecallMemoriesInput): Promise<AliveMemory[]>;\n  /** Delete a specific memory. */\n  forgetMemory(input: AliveForgetMemoryInput): Promise<any>;\n\n  // Intimacy\n  /** Get the intimacy/affection state between a character and user. */\n  getIntimacy(input: AliveGetIntimacyInput): Promise<AliveIntimacy>;\n  /** Update intimacy level (e.g., after a positive/negative interaction). */\n  updateIntimacy(input: AliveUpdateIntimacyInput): Promise<AliveIntimacy>;\n\n  // Context\n  /** Build a full context object for AI generation (profile + memories + history + system prompt). */\n  buildContext(input: AliveBuildContextInput): Promise<AliveContext>;\n\n  // Intent\n  /** Classify a user's message into an intent category. */\n  classifyIntent(input: AliveClassifyIntentInput): Promise<AliveClassifiedIntent>;\n\n  // Chat\n  /** Send a message and get a character response (includes memory, intimacy, and intent processing). */\n  sendMessage(input: AliveSendMessageInput): Promise<AliveChatResponse>;\n\n  /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */\n  rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;\n}\n\n// ─── Factory ────────────────────────────────────────────────\n\nexport function createAliveNamespace(transport: TransportConfig): AliveNamespace {\n  const tool = <I extends Record<string, any>, O>(name: string) =>\n    (input?: I) => callMcpTool<I, O>(transport, name, input as I);\n\n  return {\n    // Memory\n    storeMemory: tool<AliveStoreMemoryInput, AliveMemory>(\"store_memory\"),\n    recallMemories: tool<AliveRecallMemoriesInput, AliveMemory[]>(\"recall_memories\"),\n    forgetMemory: tool<AliveForgetMemoryInput, any>(\"forget_memory\"),\n\n    // Intimacy\n    getIntimacy: tool<AliveGetIntimacyInput, AliveIntimacy>(\"get_intimacy\"),\n    updateIntimacy: tool<AliveUpdateIntimacyInput, AliveIntimacy>(\"update_intimacy\"),\n\n    // Context\n    buildContext: tool<AliveBuildContextInput, AliveContext>(\"build_context\"),\n\n    // Intent\n    classifyIntent: tool<AliveClassifyIntentInput, AliveClassifiedIntent>(\"classify_intent\"),\n\n    // Chat\n    sendMessage: tool<AliveSendMessageInput, AliveChatResponse>(\"send_message\"),\n\n    // Raw escape hatch\n    rawTool: <T = any>(toolName: string, args?: Record<string, any>) =>\n      callMcpTool<Record<string, any>, T>(transport, toolName, args),\n  };\n}\n"]}
+{"version":3,"sources":["../src/alive/index.ts"],"names":[],"mappings":";;;AAqEO,SAAS,qBAAqB,SAAA,EAA4C;AAC/E,EAAA,MAAM,IAAA,GAAO,CAAmC,IAAA,KAC9C,CAAC,UAAc,WAAA,CAAkB,SAAA,EAAW,MAAM,KAAU,CAAA;AAE9D,EAAA,OAAO;AAAA;AAAA,IAEL,WAAA,EAAa,KAAyC,cAAc,CAAA;AAAA,IACpE,cAAA,EAAgB,KAA8C,iBAAiB,CAAA;AAAA,IAC/E,YAAA,EAAc,KAAkC,eAAe,CAAA;AAAA;AAAA,IAG/D,WAAA,EAAa,KAA2C,cAAc,CAAA;AAAA,IACtE,cAAA,EAAgB,KAA8C,iBAAiB,CAAA;AAAA;AAAA,IAG/E,YAAA,EAAc,KAA2C,eAAe,CAAA;AAAA;AAAA,IAGxE,cAAA,EAAgB,KAAsD,iBAAiB,CAAA;AAAA;AAAA,IAGvF,WAAA,EAAa,KAA+C,cAAc,CAAA;AAAA;AAAA,IAG1E,SAAS,CAAU,QAAA,EAAkB,SACnC,WAAA,CAAoC,SAAA,EAAW,UAAU,IAAI;AAAA,GACjE;AACF","file":"chunk-KP7DP5LP.js","sourcesContent":["/**\n * @goodz-core/sdk — Alive Namespace\n *\n * Provides typed access to GoodZ.Alive MCP tools:\n * memory management, intimacy/affection, context building,\n * intent classification, and chat sessions.\n *\n * GoodZ.Alive gives each GoodZ card a \"soul\" — an AI-powered\n * companion that remembers, grows, and responds uniquely.\n *\n * @module\n */\n\nimport { callMcpTool } from \"../mcp-transport\";\nimport type { TransportConfig } from \"../mcp-transport\";\nimport type {\n  AliveStoreMemoryInput,\n  AliveMemory,\n  AliveRecallMemoriesInput,\n  AliveForgetMemoryInput,\n  AliveGetIntimacyInput,\n  AliveIntimacy,\n  AliveUpdateIntimacyInput,\n  AliveBuildContextInput,\n  AliveContext,\n  AliveClassifyIntentInput,\n  AliveClassifiedIntent,\n  AliveSendMessageInput,\n  AliveChatResponse,\n} from \"../types-alive\";\n\n// Re-export all Alive types\nexport type * from \"../types-alive\";\n\n// ─── Namespace interface ────────────────────────────────────\n\nexport interface AliveNamespace {\n  // Memory\n  /** Store a new memory for a character-user pair. */\n  storeMemory(input: AliveStoreMemoryInput): Promise<AliveMemory>;\n  /** Recall relevant memories using semantic search. */\n  recallMemories(input: AliveRecallMemoriesInput): Promise<AliveMemory[]>;\n  /** Delete a specific memory. */\n  forgetMemory(input: AliveForgetMemoryInput): Promise<any>;\n\n  // Intimacy\n  /** Get the intimacy/affection state between a character and user. */\n  getIntimacy(input: AliveGetIntimacyInput): Promise<AliveIntimacy>;\n  /** Update intimacy level (e.g., after a positive/negative interaction). */\n  updateIntimacy(input: AliveUpdateIntimacyInput): Promise<AliveIntimacy>;\n\n  // Context\n  /** Build a full context object for AI generation (profile + memories + history + system prompt). */\n  buildContext(input: AliveBuildContextInput): Promise<AliveContext>;\n\n  // Intent\n  /** Classify a user's message into an intent category. */\n  classifyIntent(input: AliveClassifyIntentInput): Promise<AliveClassifiedIntent>;\n\n  // Chat\n  /** Send a message and get a character response (includes memory, intimacy, and intent processing). */\n  sendMessage(input: AliveSendMessageInput): Promise<AliveChatResponse>;\n\n  /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */\n  rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;\n}\n\n// ─── Factory ────────────────────────────────────────────────\n\nexport function createAliveNamespace(transport: TransportConfig): AliveNamespace {\n  const tool = <I extends Record<string, any>, O>(name: string) =>\n    (input?: I) => callMcpTool<I, O>(transport, name, input as I);\n\n  return {\n    // Memory\n    storeMemory: tool<AliveStoreMemoryInput, AliveMemory>(\"store_memory\"),\n    recallMemories: tool<AliveRecallMemoriesInput, AliveMemory[]>(\"recall_memories\"),\n    forgetMemory: tool<AliveForgetMemoryInput, any>(\"forget_memory\"),\n\n    // Intimacy\n    getIntimacy: tool<AliveGetIntimacyInput, AliveIntimacy>(\"get_intimacy\"),\n    updateIntimacy: tool<AliveUpdateIntimacyInput, AliveIntimacy>(\"update_intimacy\"),\n\n    // Context\n    buildContext: tool<AliveBuildContextInput, AliveContext>(\"build_context\"),\n\n    // Intent\n    classifyIntent: tool<AliveClassifyIntentInput, AliveClassifiedIntent>(\"classify_intent\"),\n\n    // Chat\n    sendMessage: tool<AliveSendMessageInput, AliveChatResponse>(\"send_message\"),\n\n    // Raw escape hatch\n    rawTool: <T = any>(toolName: string, args?: Record<string, any>) =>\n      callMcpTool<Record<string, any>, T>(transport, toolName, args),\n  };\n}\n"]}

package/dist/{chunk-4SU7SU7K.js → chunk-ORUFMYZB.js}

@@ -29,6 +29,33 @@ var GoodZApiError = class extends Error {
     }
     return parts.join("\n");
   }
+  /**
+   * Check if this error is an insufficient Z-coin balance error.
+   * When true, `depositUrl` provides the URL to redirect users for top-up.
+   *
+   * @example
+   * ```ts
+   * try {
+   *   await goodz.zcoin.commercialTransfer({ ... });
+   * } catch (e) {
+   *   if (e instanceof GoodZApiError && e.isInsufficientBalance()) {
+   *     window.open(e.depositUrl!, '_blank');
+   *   }
+   * }
+   * ```
+   */
+  isInsufficientBalance() {
+    return this.code === "INSUFFICIENT_BALANCE" || this.message?.toLowerCase().includes("insufficient") && this.message?.toLowerCase().includes("balance");
+  }
+  /**
+   * Deposit URL for Z-coin top-up (available when isInsufficientBalance() is true).
+   * Returned by Core when a payment fails due to insufficient balance.
+   * Append `&amount={needed}&return_url={your_page}` for seamless round-trip.
+   */
+  get depositUrl() {
+    const d = this.data;
+    return d?.deposit_url ?? d?.deposit_url_with_return ?? void 0;
+  }
 };
 async function callQuery(config, path, input) {
   const url = `${config.baseUrl}/api/trpc/${path}`;
@@ -223,5 +250,5 @@ function createMcpTransportConfig(baseUrl, getHeaders) {
 }
 
 export { GoodZApiError, callMcpTool, callMutation, callQuery, createMcpTransportConfig };
-//# sourceMappingURL=chunk-4SU7SU7K.js.map
-//# sourceMappingURL=chunk-4SU7SU7K.js.map
+//# sourceMappingURL=chunk-ORUFMYZB.js.map
+//# sourceMappingURL=chunk-ORUFMYZB.js.map

package/dist/chunk-ORUFMYZB.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/transport.ts","../src/mcp-transport.ts"],"names":[],"mappings":"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","file":"chunk-ORUFMYZB.js","sourcesContent":["/**\n * @goodz-core/sdk — HTTP Transport Layer\n *\n * Speaks the tRPC v11 HTTP wire protocol directly using fetch.\n * Handles superjson serialization, batching, and error parsing.\n *\n * Wire format reference:\n * - Queries:   GET  /api/trpc/{procedure}?input={superjson-encoded}\n * - Mutations: POST /api/trpc/{procedure}  body: {superjson-encoded}\n * - Batch:     GET  /api/trpc/{p1},{p2}?input={0: ..., 1: ...}\n *\n * @internal\n */\n\nimport superjson from \"superjson\";\nimport type { GoodZApiFieldError } from \"./types\";\n\n// ─── Error class ─────────────────────────────────────────────\n\nexport class GoodZApiError extends Error {\n  public readonly code: string;\n  public readonly httpStatus: number;\n  public readonly path: string;\n  public readonly zodErrors?: GoodZApiFieldError[];\n  public readonly data?: unknown;\n\n  constructor(opts: {\n    message: string;\n    code: string;\n    httpStatus: number;\n    path: string;\n    zodErrors?: GoodZApiFieldError[];\n    data?: unknown;\n  }) {\n    super(opts.message);\n    this.name = \"GoodZApiError\";\n    this.code = opts.code;\n    this.httpStatus = opts.httpStatus;\n    this.path = opts.path;\n    this.zodErrors = opts.zodErrors;\n    this.data = opts.data;\n  }\n\n  /** Human-readable summary including field errors if present. */\n  toDetailedString(): string {\n    const parts = [\n      `[GoodZApiError] ${this.code} on ${this.path}: ${this.message}`,\n    ];\n    if (this.zodErrors?.length) {\n      parts.push(\"Field errors:\");\n      for (const e of this.zodErrors) {\n        parts.push(`  - ${e.path.join(\".\")}: ${e.message} (${e.code})`);\n      }\n    }\n    return parts.join(\"\\n\");\n  }\n\n  /**\n   * Check if this error is an insufficient Z-coin balance error.\n   * When true, `depositUrl` provides the URL to redirect users for top-up.\n   *\n   * @example\n   * ```ts\n   * try {\n   *   await goodz.zcoin.commercialTransfer({ ... });\n   * } catch (e) {\n   *   if (e instanceof GoodZApiError && e.isInsufficientBalance()) {\n   *     window.open(e.depositUrl!, '_blank');\n   *   }\n   * }\n   * ```\n   */\n  isInsufficientBalance(): boolean {\n    return this.code === \"INSUFFICIENT_BALANCE\" ||\n      (this.message?.toLowerCase().includes(\"insufficient\") &&\n       this.message?.toLowerCase().includes(\"balance\"));\n  }\n\n  /**\n   * Deposit URL for Z-coin top-up (available when isInsufficientBalance() is true).\n   * Returned by Core when a payment fails due to insufficient balance.\n   * Append `&amount={needed}&return_url={your_page}` for seamless round-trip.\n   */\n  get depositUrl(): string | undefined {\n    const d = this.data as Record<string, unknown> | undefined;\n    return (d?.deposit_url as string) ?? (d?.deposit_url_with_return as string) ?? undefined;\n  }\n}\n\n// ─── Transport config ────────────────────────────────────────\n\nexport interface TransportConfig {\n  baseUrl: string;\n  getHeaders: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\n// ─── Core transport functions ────────────────────────────────\n\n/**\n * Call a tRPC query (GET request).\n * Uses POST with method override for compatibility with Commerce/Exchange\n * server-to-server patterns (some proxies strip GET bodies).\n */\nexport async function callQuery<TInput, TOutput>(\n  config: TransportConfig,\n  path: string,\n  input?: TInput,\n): Promise<TOutput> {\n  const url = `${config.baseUrl}/api/trpc/${path}`;\n  const headers = await config.getHeaders();\n\n  // Use GET with query params for queries (standard tRPC)\n  const serialized = input !== undefined ? superjson.serialize(input) : undefined;\n  const queryUrl = serialized\n    ? `${url}?input=${encodeURIComponent(JSON.stringify(serialized))}`\n    : url;\n\n  const res = await fetch(queryUrl, {\n    method: \"GET\",\n    headers: {\n      ...headers,\n      \"Content-Type\": \"application/json\",\n    },\n  });\n\n  return parseResponse<TOutput>(res, path);\n}\n\n/**\n * Call a tRPC mutation (POST request).\n */\nexport async function callMutation<TInput, TOutput>(\n  config: TransportConfig,\n  path: string,\n  input?: TInput,\n): Promise<TOutput> {\n  const url = `${config.baseUrl}/api/trpc/${path}`;\n  const headers = await config.getHeaders();\n\n  const serialized = input !== undefined ? superjson.serialize(input) : undefined;\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      ...headers,\n      \"Content-Type\": \"application/json\",\n    },\n    body: serialized ? JSON.stringify(serialized) : undefined,\n  });\n\n  return parseResponse<TOutput>(res, path);\n}\n\n// ─── Response parser ─────────────────────────────────────────\n\nasync function parseResponse<T>(res: Response, path: string): Promise<T> {\n  const text = await res.text();\n  let body: any;\n\n  try {\n    body = JSON.parse(text);\n  } catch {\n    throw new GoodZApiError({\n      message: `Invalid JSON response: ${text.slice(0, 200)}`,\n      code: \"PARSE_ERROR\",\n      httpStatus: res.status,\n      path,\n    });\n  }\n\n  // tRPC wraps responses in { result: { data: ... } }\n  // Batch responses are arrays: [{ result: { data: ... } }]\n  const envelope = Array.isArray(body) ? body[0] : body;\n\n  // Check for tRPC error envelope\n  if (envelope?.error) {\n    const err = envelope.error;\n    const errJson = err?.json ?? err;\n    const errData = errJson?.data ?? {};\n\n    throw new GoodZApiError({\n      message: errJson?.message ?? \"Unknown API error\",\n      code: errData?.code ?? errJson?.code ?? \"UNKNOWN\",\n      httpStatus: errData?.httpStatus ?? res.status,\n      path: errData?.path ?? path,\n      zodErrors: errData?.zodError?.issues,\n      data: errData,\n    });\n  }\n\n  // Success path: extract and deserialize the data\n  const resultData = envelope?.result?.data;\n  if (resultData === undefined) {\n    // Some queries return null/undefined legitimately\n    if (res.ok) return undefined as T;\n\n    throw new GoodZApiError({\n      message: `Unexpected response shape from ${path}`,\n      code: \"UNEXPECTED_RESPONSE\",\n      httpStatus: res.status,\n      path,\n    });\n  }\n\n  // superjson wraps data in { json: ..., meta?: ... }\n  // Check if it's a superjson envelope\n  if (resultData && typeof resultData === \"object\" && \"json\" in resultData) {\n    return superjson.deserialize(resultData) as T;\n  }\n\n  // Plain JSON (shouldn't happen with superjson transformer, but be safe)\n  return resultData as T;\n}\n","/**\n * @goodz-core/sdk — MCP Transport Layer\n *\n * Speaks the MCP (Model Context Protocol) JSON-RPC 2.0 wire format\n * used by Commerce, Exchange, and Alive sub-sites.\n *\n * Wire format:\n *   POST /api/mcp\n *   Content-Type: application/json\n *   Authorization: Bearer <token>\n *\n *   { \"jsonrpc\": \"2.0\", \"method\": \"tools/call\", \"params\": { \"name\": \"<tool>\", \"arguments\": { ... } }, \"id\": 1 }\n *\n * Response:\n *   { \"jsonrpc\": \"2.0\", \"result\": { \"content\": [{ \"type\": \"text\", \"text\": \"<json>\" }] }, \"id\": 1 }\n *\n * @internal\n */\n\nimport { GoodZApiError } from \"./transport\";\nimport type { TransportConfig } from \"./transport\";\n\n// Re-export for convenience\nexport type { TransportConfig };\n\n// ─── MCP request counter ────────────────────────────────────\n\nlet _mcpRequestId = 0;\nfunction nextId(): number {\n  return ++_mcpRequestId;\n}\n\n// ─── Session management ─────────────────────────────────────\n\nconst _sessionIds = new Map<string, string>();\n\n// ─── Core MCP call function ─────────────────────────────────\n\n/**\n * Call an MCP tool on a sub-site.\n *\n * Handles:\n * - JSON-RPC 2.0 envelope construction\n * - Session ID management (mcp-session-id header)\n * - Response parsing (extracts JSON from text content)\n * - Error mapping to GoodZApiError\n */\nexport async function callMcpTool<TInput extends Record<string, any>, TOutput>(\n  config: TransportConfig,\n  toolName: string,\n  args?: TInput,\n): Promise<TOutput> {\n  const url = `${config.baseUrl}/api/mcp`;\n  const headers = await config.getHeaders();\n\n  // Add session ID if we have one for this endpoint\n  const sessionId = _sessionIds.get(config.baseUrl);\n  if (sessionId) {\n    headers[\"mcp-session-id\"] = sessionId;\n  }\n\n  const body = {\n    jsonrpc: \"2.0\" as const,\n    method: \"tools/call\",\n    params: {\n      name: toolName,\n      arguments: args ?? {},\n    },\n    id: nextId(),\n  };\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      ...headers,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json, text/event-stream\",\n    },\n    body: JSON.stringify(body),\n  });\n\n  // Store session ID from response\n  const newSessionId = res.headers.get(\"mcp-session-id\");\n  if (newSessionId) {\n    _sessionIds.set(config.baseUrl, newSessionId);\n  }\n\n  // Handle SSE responses (some MCP servers use streaming)\n  const contentType = res.headers.get(\"content-type\") || \"\";\n  if (contentType.includes(\"text/event-stream\")) {\n    return parseSseResponse<TOutput>(res, toolName);\n  }\n\n  // Standard JSON response\n  const text = await res.text();\n  return parseJsonRpcResponse<TOutput>(text, res.status, toolName);\n}\n\n// ─── Response parsers ───────────────────────────────────────\n\nfunction parseJsonRpcResponse<T>(\n  text: string,\n  httpStatus: number,\n  toolName: string,\n): T {\n  let body: any;\n  try {\n    body = JSON.parse(text);\n  } catch {\n    throw new GoodZApiError({\n      message: `Invalid JSON response from MCP tool ${toolName}: ${text.slice(0, 200)}`,\n      code: \"PARSE_ERROR\",\n      httpStatus,\n      path: toolName,\n    });\n  }\n\n  // JSON-RPC error\n  if (body.error) {\n    throw new GoodZApiError({\n      message: body.error.message || \"MCP tool error\",\n      code: body.error.code?.toString() || \"MCP_ERROR\",\n      httpStatus,\n      path: toolName,\n      data: body.error.data,\n    });\n  }\n\n  // Extract result from MCP content array\n  return extractMcpResult<T>(body.result, toolName, httpStatus);\n}\n\nasync function parseSseResponse<T>(\n  res: Response,\n  toolName: string,\n): Promise<T> {\n  const text = await res.text();\n  const lines = text.split(\"\\n\");\n\n  // Find the last \"data:\" line that contains a JSON-RPC response\n  let lastData: string | null = null;\n  for (const line of lines) {\n    if (line.startsWith(\"data:\")) {\n      lastData = line.slice(5).trim();\n    }\n  }\n\n  if (!lastData) {\n    throw new GoodZApiError({\n      message: `Empty SSE response from MCP tool ${toolName}`,\n      code: \"EMPTY_RESPONSE\",\n      httpStatus: res.status,\n      path: toolName,\n    });\n  }\n\n  return parseJsonRpcResponse<T>(lastData, res.status, toolName);\n}\n\nfunction extractMcpResult<T>(\n  result: any,\n  toolName: string,\n  httpStatus: number,\n): T {\n  if (!result) {\n    throw new GoodZApiError({\n      message: `No result from MCP tool ${toolName}`,\n      code: \"EMPTY_RESULT\",\n      httpStatus,\n      path: toolName,\n    });\n  }\n\n  // MCP tools return { content: [{ type: \"text\", text: \"...\" }] }\n  const content = result.content;\n  if (Array.isArray(content)) {\n    // Find the first text content block\n    const textBlock = content.find((c: any) => c.type === \"text\");\n    if (textBlock?.text) {\n      // Check if the tool returned an error in the text\n      if (result.isError) {\n        throw new GoodZApiError({\n          message: textBlock.text,\n          code: \"MCP_TOOL_ERROR\",\n          httpStatus,\n          path: toolName,\n        });\n      }\n\n      // Try to parse as JSON\n      try {\n        return JSON.parse(textBlock.text) as T;\n      } catch {\n        // If not JSON, return the text as-is (some tools return plain text)\n        return textBlock.text as T;\n      }\n    }\n  }\n\n  // Fallback: return the result directly\n  return result as T;\n}\n\n// ─── MCP transport config builder ───────────────────────────\n\n/**\n * Create a TransportConfig for an MCP sub-site endpoint.\n */\nexport function createMcpTransportConfig(\n  baseUrl: string,\n  getHeaders: () => Record<string, string> | Promise<Record<string, string>>,\n): TransportConfig {\n  return {\n    baseUrl: baseUrl.replace(/\\/$/, \"\"),\n    getHeaders,\n  };\n}\n"]}

package/dist/{chunk-V73MMKHI.js → chunk-SWD7BJQ7.js}

@@ -1,4 +1,4 @@
-import { callMcpTool } from './chunk-4SU7SU7K.js';
+import { callMcpTool } from './chunk-ORUFMYZB.js';
 
 // src/commerce/index.ts
 function createCommerceNamespace(transport) {
@@ -52,5 +52,5 @@ function createCommerceNamespace(transport) {
 }
 
 export { createCommerceNamespace };
-//# sourceMappingURL=chunk-V73MMKHI.js.map
-//# sourceMappingURL=chunk-V73MMKHI.js.map
+//# sourceMappingURL=chunk-SWD7BJQ7.js.map
+//# sourceMappingURL=chunk-SWD7BJQ7.js.map

package/dist/{chunk-V73MMKHI.js.map → chunk-SWD7BJQ7.js.map}

@@ -1 +1 @@
-{"version":3,"sources":["../src/commerce/index.ts"],"names":[],"mappings":";;;AAuJO,SAAS,wBAAwB,SAAA,EAA+C;AACrF,EAAA,MAAM,IAAA,GAAO,CAAmC,IAAA,KAC9C,CAAC,UAAc,WAAA,CAAkB,SAAA,EAAW,MAAM,KAAU,CAAA;AAE9D,EAAA,OAAO;AAAA;AAAA,IAEL,UAAA,EAAY,KAA4C,aAAa,CAAA;AAAA,IACrE,gBAAA,EAAkB,KAA2D,oBAAoB,CAAA;AAAA;AAAA,IAGjG,WAAA,EAAa,KAA8C,gBAAgB,CAAA;AAAA,IAC3E,eAAA,EAAiB,KAAsD,mBAAmB,CAAA;AAAA;AAAA,IAG1F,cAAA,EAAgB,KAAoD,uBAAuB,CAAA;AAAA,IAC3F,gBAAA,EAAkB,KAAsD,mBAAmB,CAAA;AAAA,IAC3F,aAAA,EAAe,KAAmD,gBAAgB,CAAA;AAAA,IAClF,WAAA,EAAa,KAAiD,cAAc,CAAA;AAAA,IAC5E,cAAA,EAAgB,KAAoD,iBAAiB,CAAA;AAAA,IACrF,eAAA,EAAiB,KAAwC,mBAAmB,CAAA;AAAA,IAC5E,gBAAA,EAAkB,KAA4D,oBAAoB,CAAA;AAAA;AAAA,IAGlG,eAAA,EAAiB,KAAuD,kBAAkB,CAAA;AAAA,IAC1F,WAAA,EAAa,KAAgD,eAAe,CAAA;AAAA;AAAA,IAG5E,kBAAA,EAAoB,KAA2C,sBAAsB,CAAA;AAAA,IACrF,eAAA,EAAiB,KAA+D,yBAAyB,CAAA;AAAA,IACzG,YAAA,EAAc,KAAqC,eAAe,CAAA;AAAA;AAAA,IAGlE,eAAA,EAAiB,KAAwC,kBAAkB,CAAA;AAAA,IAC3E,iBAAA,EAAmB,KAA0C,oBAAoB,CAAA;AAAA,IACjF,eAAA,EAAiB,KAAwC,mBAAmB,CAAA;AAAA;AAAA,IAG5E,mBAAA,EAAqB,KAA4C,uBAAuB,CAAA;AAAA;AAAA,IAGxF,iBAAA,EAAmB,KAA4C,oBAAoB,CAAA;AAAA,IACnF,mBAAA,EAAqB,KAA8C,wBAAwB,CAAA;AAAA;AAAA,IAG3F,cAAA,EAAgB,KAAuC,uBAAuB,CAAA;AAAA;AAAA,IAG9E,eAAA,EAAiB,KAAoD,kBAAkB,CAAA;AAAA,IACvF,YAAA,EAAc,KAA+C,eAAe,CAAA;AAAA,IAC5E,WAAA,EAAa,KAAoC,cAAc,CAAA;AAAA,IAC/D,aAAA,EAAe,KAAsC,gBAAgB,CAAA;AAAA;AAAA,IAGrE,WAAA,EAAa,KAAoC,cAAc,CAAA;AAAA,IAC/D,SAAA,EAAW,KAAkC,YAAY,CAAA;AAAA,IACzD,UAAA,EAAY,KAAqC,cAAc,CAAA;AAAA,IAC/D,UAAA,EAAY,KAA+C,cAAc,CAAA;AAAA;AAAA,IAGzE,SAAS,CAAU,QAAA,EAAkB,SACnC,WAAA,CAAoC,SAAA,EAAW,UAAU,IAAI;AAAA,GACjE;AACF","file":"chunk-V73MMKHI.js","sourcesContent":["/**\n * @goodz-core/sdk — Commerce / Shops Namespace\n *\n * Provides typed access to GoodZ.Commerce MCP tools:\n * shop management, batches, gacha pools, campaigns,\n * wholesale, purchases, settlement, and webhooks.\n *\n * @module\n */\n\nimport { callMcpTool } from \"../mcp-transport\";\nimport type { TransportConfig } from \"../mcp-transport\";\nimport type {\n  CommerceCreateShopInput,\n  CommerceShop,\n  CommerceGetShopDashboardInput,\n  CommerceShopDashboard,\n  CommerceCreateBatchInput,\n  CommerceBatch,\n  CommerceCreateGachaPoolInput,\n  CommerceGachaPool,\n  CommerceLaunchCampaignInput,\n  CommerceCampaign,\n  CommerceActivateCampaignInput,\n  CommercePauseCampaignInput,\n  CommerceEndCampaignInput,\n  CommerceUpdateCampaignInput,\n  CommerceGetCampaignInfoInput,\n  CommerceGetCampaignItemsInput,\n  CommerceCampaignItem,\n  CommerceExecutePurchaseInput,\n  CommerceDrawResult,\n  CommerceGetMyOrdersInput,\n  CommerceOrder,\n  CommercePublishToWholesaleInput,\n  CommerceBrowseWholesaleInput,\n  CommerceWholesaleListing,\n  CommerceProcureBatchInput,\n  CommerceManageInventoryInput,\n  CommerceRegisterInstancesInput,\n  CommerceMintToInventoryInput,\n  CommerceGetSettlementReportInput,\n  CommerceSearchMarketplaceInput,\n  CommerceGetShopsByBlueprintInput,\n  CommerceRedeemPhysicalInput,\n  CommerceRegisterWebhookInput,\n  CommerceWebhook,\n  CommerceTestWebhookInput,\n  CommerceDeleteWebhookInput,\n  CommerceRegisterAppInput,\n  CommerceUpdateAppInput,\n  CommerceListMyAppsInput,\n  CommerceGetAuthUrlInput,\n} from \"../types-commerce\";\n\n// Re-export all Commerce types\nexport type * from \"../types-commerce\";\n\n// ─── Namespace interface ────────────────────────────────────\n\nexport interface CommerceNamespace {\n  // Shop Management\n  /** Create a new shop. */\n  createShop(input: CommerceCreateShopInput): Promise<CommerceShop>;\n  /** Get shop dashboard with stats, revenue, and recent orders. */\n  getShopDashboard(input?: CommerceGetShopDashboardInput): Promise<CommerceShopDashboard>;\n\n  // Product Assembly\n  /** Create a batch (product assembly with tiers). Supports blind_box, ichiban_kuji, direct_sale. */\n  createBatch(input: CommerceCreateBatchInput): Promise<CommerceBatch>;\n  /** Create a gacha pool with weighted probabilities and optional pity mechanics. */\n  createGachaPool(input: CommerceCreateGachaPoolInput): Promise<CommerceGachaPool>;\n\n  // Campaign Lifecycle\n  /** Launch a sales campaign in draft status. Connect a Batch or Gacha pool to the storefront. */\n  launchCampaign(input: CommerceLaunchCampaignInput): Promise<CommerceCampaign>;\n  /** Activate a draft/paused campaign — makes it live and purchasable. */\n  activateCampaign(input: CommerceActivateCampaignInput): Promise<CommerceCampaign>;\n  /** Pause an active campaign. Existing orders unaffected. */\n  pauseCampaign(input: CommercePauseCampaignInput): Promise<CommerceCampaign>;\n  /** Permanently end a campaign (terminal state). */\n  endCampaign(input: CommerceEndCampaignInput): Promise<CommerceCampaign>;\n  /** Update campaign configuration (editable fields depend on status). */\n  updateCampaign(input: CommerceUpdateCampaignInput): Promise<CommerceCampaign>;\n  /** Get detailed campaign info including batch/gacha config and tiers. */\n  getCampaignInfo(input: CommerceGetCampaignInfoInput): Promise<any>;\n  /** Get unified campaign items list (works for both batch and gacha campaigns). */\n  getCampaignItems(input: CommerceGetCampaignItemsInput): Promise<CommerceCampaignItem[]>;\n\n  // Purchase / Draw\n  /** Execute a purchase or draw. Handles payment, draw mechanics, settlement, and ownership transfer. */\n  executePurchase(input: CommerceExecutePurchaseInput): Promise<CommerceDrawResult>;\n  /** Get the authenticated user's order history. */\n  getMyOrders(input?: CommerceGetMyOrdersInput): Promise<CommerceOrder[]>;\n\n  // Wholesale\n  /** Publish a batch to the wholesale market for other shopkeepers to procure. */\n  publishToWholesale(input: CommercePublishToWholesaleInput): Promise<any>;\n  /** Browse available wholesale listings. */\n  browseWholesale(input?: CommerceBrowseWholesaleInput): Promise<CommerceWholesaleListing[]>;\n  /** Procure goods from the wholesale market. */\n  procureBatch(input: CommerceProcureBatchInput): Promise<any>;\n\n  // Inventory\n  /** View and manage shop inventory (list or sync from Core). */\n  manageInventory(input?: CommerceManageInventoryInput): Promise<any>;\n  /** Register existing Core instances into shop inventory. */\n  registerInstances(input: CommerceRegisterInstancesInput): Promise<any>;\n  /** Mint new instances directly into shop inventory. */\n  mintToInventory(input: CommerceMintToInventoryInput): Promise<any>;\n\n  // Settlement\n  /** Get settlement report with revenue breakdown. */\n  getSettlementReport(input?: CommerceGetSettlementReportInput): Promise<any>;\n\n  // Discovery\n  /** Search the marketplace for campaigns. */\n  searchMarketplace(input?: CommerceSearchMarketplaceInput): Promise<any[]>;\n  /** Find shops selling a specific GoodZ card. */\n  getShopsByBlueprint(input: CommerceGetShopsByBlueprintInput): Promise<any[]>;\n\n  // Physical Redemption\n  /** Request physical redemption for a purchased item. */\n  redeemPhysical(input: CommerceRedeemPhysicalInput): Promise<any>;\n\n  // Webhooks\n  /** Register a webhook URL to receive shop event notifications. */\n  registerWebhook(input: CommerceRegisterWebhookInput): Promise<CommerceWebhook>;\n  /** List all registered webhook endpoints. */\n  listWebhooks(): Promise<CommerceWebhook[]>;\n  /** Send a test ping to a webhook endpoint. */\n  testWebhook(input: CommerceTestWebhookInput): Promise<any>;\n  /** Delete a webhook endpoint. */\n  deleteWebhook(input: CommerceDeleteWebhookInput): Promise<any>;\n\n  // OAuth App Management\n  /** Register a new OAuth application with Commerce scopes. */\n  registerApp(input: CommerceRegisterAppInput): Promise<any>;\n  /** Update an existing OAuth application. */\n  updateApp(input: CommerceUpdateAppInput): Promise<any>;\n  /** List all OAuth applications owned by the user. */\n  listMyApps(input?: CommerceListMyAppsInput): Promise<any[]>;\n  /** Generate an OAuth authorization URL. */\n  getAuthUrl(input?: CommerceGetAuthUrlInput): Promise<{ url: string }>;\n\n  /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */\n  rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;\n}\n\n// ─── Factory ────────────────────────────────────────────────\n\nexport function createCommerceNamespace(transport: TransportConfig): CommerceNamespace {\n  const tool = <I extends Record<string, any>, O>(name: string) =>\n    (input?: I) => callMcpTool<I, O>(transport, name, input as I);\n\n  return {\n    // Shop\n    createShop: tool<CommerceCreateShopInput, CommerceShop>(\"create_shop\"),\n    getShopDashboard: tool<CommerceGetShopDashboardInput, CommerceShopDashboard>(\"get_shop_dashboard\"),\n\n    // Product Assembly\n    createBatch: tool<CommerceCreateBatchInput, CommerceBatch>(\"assemble_batch\"),\n    createGachaPool: tool<CommerceCreateGachaPoolInput, CommerceGachaPool>(\"create_gacha_pool\"),\n\n    // Campaign Lifecycle\n    launchCampaign: tool<CommerceLaunchCampaignInput, CommerceCampaign>(\"launch_sales_campaign\"),\n    activateCampaign: tool<CommerceActivateCampaignInput, CommerceCampaign>(\"activate_campaign\"),\n    pauseCampaign: tool<CommercePauseCampaignInput, CommerceCampaign>(\"pause_campaign\"),\n    endCampaign: tool<CommerceEndCampaignInput, CommerceCampaign>(\"end_campaign\"),\n    updateCampaign: tool<CommerceUpdateCampaignInput, CommerceCampaign>(\"update_campaign\"),\n    getCampaignInfo: tool<CommerceGetCampaignInfoInput, any>(\"get_campaign_info\"),\n    getCampaignItems: tool<CommerceGetCampaignItemsInput, CommerceCampaignItem[]>(\"get_campaign_items\"),\n\n    // Purchase\n    executePurchase: tool<CommerceExecutePurchaseInput, CommerceDrawResult>(\"execute_purchase\"),\n    getMyOrders: tool<CommerceGetMyOrdersInput, CommerceOrder[]>(\"get_my_orders\"),\n\n    // Wholesale\n    publishToWholesale: tool<CommercePublishToWholesaleInput, any>(\"publish_to_wholesale\"),\n    browseWholesale: tool<CommerceBrowseWholesaleInput, CommerceWholesaleListing[]>(\"browse_wholesale_market\"),\n    procureBatch: tool<CommerceProcureBatchInput, any>(\"procure_batch\"),\n\n    // Inventory\n    manageInventory: tool<CommerceManageInventoryInput, any>(\"manage_inventory\"),\n    registerInstances: tool<CommerceRegisterInstancesInput, any>(\"register_instances\"),\n    mintToInventory: tool<CommerceMintToInventoryInput, any>(\"mint_to_inventory\"),\n\n    // Settlement\n    getSettlementReport: tool<CommerceGetSettlementReportInput, any>(\"get_settlement_report\"),\n\n    // Discovery\n    searchMarketplace: tool<CommerceSearchMarketplaceInput, any[]>(\"search_marketplace\"),\n    getShopsByBlueprint: tool<CommerceGetShopsByBlueprintInput, any[]>(\"get_shops_by_blueprint\"),\n\n    // Physical Redemption\n    redeemPhysical: tool<CommerceRedeemPhysicalInput, any>(\"redeem_physical_goodz\"),\n\n    // Webhooks\n    registerWebhook: tool<CommerceRegisterWebhookInput, CommerceWebhook>(\"register_webhook\"),\n    listWebhooks: tool<Record<string, never>, CommerceWebhook[]>(\"list_webhooks\"),\n    testWebhook: tool<CommerceTestWebhookInput, any>(\"test_webhook\"),\n    deleteWebhook: tool<CommerceDeleteWebhookInput, any>(\"delete_webhook\"),\n\n    // OAuth App\n    registerApp: tool<CommerceRegisterAppInput, any>(\"register_app\"),\n    updateApp: tool<CommerceUpdateAppInput, any>(\"update_app\"),\n    listMyApps: tool<CommerceListMyAppsInput, any[]>(\"list_my_apps\"),\n    getAuthUrl: tool<CommerceGetAuthUrlInput, { url: string }>(\"get_auth_url\"),\n\n    // Raw escape hatch\n    rawTool: <T = any>(toolName: string, args?: Record<string, any>) =>\n      callMcpTool<Record<string, any>, T>(transport, toolName, args),\n  };\n}\n"]}
+{"version":3,"sources":["../src/commerce/index.ts"],"names":[],"mappings":";;;AAuJO,SAAS,wBAAwB,SAAA,EAA+C;AACrF,EAAA,MAAM,IAAA,GAAO,CAAmC,IAAA,KAC9C,CAAC,UAAc,WAAA,CAAkB,SAAA,EAAW,MAAM,KAAU,CAAA;AAE9D,EAAA,OAAO;AAAA;AAAA,IAEL,UAAA,EAAY,KAA4C,aAAa,CAAA;AAAA,IACrE,gBAAA,EAAkB,KAA2D,oBAAoB,CAAA;AAAA;AAAA,IAGjG,WAAA,EAAa,KAA8C,gBAAgB,CAAA;AAAA,IAC3E,eAAA,EAAiB,KAAsD,mBAAmB,CAAA;AAAA;AAAA,IAG1F,cAAA,EAAgB,KAAoD,uBAAuB,CAAA;AAAA,IAC3F,gBAAA,EAAkB,KAAsD,mBAAmB,CAAA;AAAA,IAC3F,aAAA,EAAe,KAAmD,gBAAgB,CAAA;AAAA,IAClF,WAAA,EAAa,KAAiD,cAAc,CAAA;AAAA,IAC5E,cAAA,EAAgB,KAAoD,iBAAiB,CAAA;AAAA,IACrF,eAAA,EAAiB,KAAwC,mBAAmB,CAAA;AAAA,IAC5E,gBAAA,EAAkB,KAA4D,oBAAoB,CAAA;AAAA;AAAA,IAGlG,eAAA,EAAiB,KAAuD,kBAAkB,CAAA;AAAA,IAC1F,WAAA,EAAa,KAAgD,eAAe,CAAA;AAAA;AAAA,IAG5E,kBAAA,EAAoB,KAA2C,sBAAsB,CAAA;AAAA,IACrF,eAAA,EAAiB,KAA+D,yBAAyB,CAAA;AAAA,IACzG,YAAA,EAAc,KAAqC,eAAe,CAAA;AAAA;AAAA,IAGlE,eAAA,EAAiB,KAAwC,kBAAkB,CAAA;AAAA,IAC3E,iBAAA,EAAmB,KAA0C,oBAAoB,CAAA;AAAA,IACjF,eAAA,EAAiB,KAAwC,mBAAmB,CAAA;AAAA;AAAA,IAG5E,mBAAA,EAAqB,KAA4C,uBAAuB,CAAA;AAAA;AAAA,IAGxF,iBAAA,EAAmB,KAA4C,oBAAoB,CAAA;AAAA,IACnF,mBAAA,EAAqB,KAA8C,wBAAwB,CAAA;AAAA;AAAA,IAG3F,cAAA,EAAgB,KAAuC,uBAAuB,CAAA;AAAA;AAAA,IAG9E,eAAA,EAAiB,KAAoD,kBAAkB,CAAA;AAAA,IACvF,YAAA,EAAc,KAA+C,eAAe,CAAA;AAAA,IAC5E,WAAA,EAAa,KAAoC,cAAc,CAAA;AAAA,IAC/D,aAAA,EAAe,KAAsC,gBAAgB,CAAA;AAAA;AAAA,IAGrE,WAAA,EAAa,KAAoC,cAAc,CAAA;AAAA,IAC/D,SAAA,EAAW,KAAkC,YAAY,CAAA;AAAA,IACzD,UAAA,EAAY,KAAqC,cAAc,CAAA;AAAA,IAC/D,UAAA,EAAY,KAA+C,cAAc,CAAA;AAAA;AAAA,IAGzE,SAAS,CAAU,QAAA,EAAkB,SACnC,WAAA,CAAoC,SAAA,EAAW,UAAU,IAAI;AAAA,GACjE;AACF","file":"chunk-SWD7BJQ7.js","sourcesContent":["/**\n * @goodz-core/sdk — Commerce / Shops Namespace\n *\n * Provides typed access to GoodZ.Commerce MCP tools:\n * shop management, batches, gacha pools, campaigns,\n * wholesale, purchases, settlement, and webhooks.\n *\n * @module\n */\n\nimport { callMcpTool } from \"../mcp-transport\";\nimport type { TransportConfig } from \"../mcp-transport\";\nimport type {\n  CommerceCreateShopInput,\n  CommerceShop,\n  CommerceGetShopDashboardInput,\n  CommerceShopDashboard,\n  CommerceCreateBatchInput,\n  CommerceBatch,\n  CommerceCreateGachaPoolInput,\n  CommerceGachaPool,\n  CommerceLaunchCampaignInput,\n  CommerceCampaign,\n  CommerceActivateCampaignInput,\n  CommercePauseCampaignInput,\n  CommerceEndCampaignInput,\n  CommerceUpdateCampaignInput,\n  CommerceGetCampaignInfoInput,\n  CommerceGetCampaignItemsInput,\n  CommerceCampaignItem,\n  CommerceExecutePurchaseInput,\n  CommerceDrawResult,\n  CommerceGetMyOrdersInput,\n  CommerceOrder,\n  CommercePublishToWholesaleInput,\n  CommerceBrowseWholesaleInput,\n  CommerceWholesaleListing,\n  CommerceProcureBatchInput,\n  CommerceManageInventoryInput,\n  CommerceRegisterInstancesInput,\n  CommerceMintToInventoryInput,\n  CommerceGetSettlementReportInput,\n  CommerceSearchMarketplaceInput,\n  CommerceGetShopsByBlueprintInput,\n  CommerceRedeemPhysicalInput,\n  CommerceRegisterWebhookInput,\n  CommerceWebhook,\n  CommerceTestWebhookInput,\n  CommerceDeleteWebhookInput,\n  CommerceRegisterAppInput,\n  CommerceUpdateAppInput,\n  CommerceListMyAppsInput,\n  CommerceGetAuthUrlInput,\n} from \"../types-commerce\";\n\n// Re-export all Commerce types\nexport type * from \"../types-commerce\";\n\n// ─── Namespace interface ────────────────────────────────────\n\nexport interface CommerceNamespace {\n  // Shop Management\n  /** Create a new shop. */\n  createShop(input: CommerceCreateShopInput): Promise<CommerceShop>;\n  /** Get shop dashboard with stats, revenue, and recent orders. */\n  getShopDashboard(input?: CommerceGetShopDashboardInput): Promise<CommerceShopDashboard>;\n\n  // Product Assembly\n  /** Create a batch (product assembly with tiers). Supports blind_box, ichiban_kuji, direct_sale. */\n  createBatch(input: CommerceCreateBatchInput): Promise<CommerceBatch>;\n  /** Create a gacha pool with weighted probabilities and optional pity mechanics. */\n  createGachaPool(input: CommerceCreateGachaPoolInput): Promise<CommerceGachaPool>;\n\n  // Campaign Lifecycle\n  /** Launch a sales campaign in draft status. Connect a Batch or Gacha pool to the storefront. */\n  launchCampaign(input: CommerceLaunchCampaignInput): Promise<CommerceCampaign>;\n  /** Activate a draft/paused campaign — makes it live and purchasable. */\n  activateCampaign(input: CommerceActivateCampaignInput): Promise<CommerceCampaign>;\n  /** Pause an active campaign. Existing orders unaffected. */\n  pauseCampaign(input: CommercePauseCampaignInput): Promise<CommerceCampaign>;\n  /** Permanently end a campaign (terminal state). */\n  endCampaign(input: CommerceEndCampaignInput): Promise<CommerceCampaign>;\n  /** Update campaign configuration (editable fields depend on status). */\n  updateCampaign(input: CommerceUpdateCampaignInput): Promise<CommerceCampaign>;\n  /** Get detailed campaign info including batch/gacha config and tiers. */\n  getCampaignInfo(input: CommerceGetCampaignInfoInput): Promise<any>;\n  /** Get unified campaign items list (works for both batch and gacha campaigns). */\n  getCampaignItems(input: CommerceGetCampaignItemsInput): Promise<CommerceCampaignItem[]>;\n\n  // Purchase / Draw\n  /** Execute a purchase or draw. Handles payment, draw mechanics, settlement, and ownership transfer. */\n  executePurchase(input: CommerceExecutePurchaseInput): Promise<CommerceDrawResult>;\n  /** Get the authenticated user's order history. */\n  getMyOrders(input?: CommerceGetMyOrdersInput): Promise<CommerceOrder[]>;\n\n  // Wholesale\n  /** Publish a batch to the wholesale market for other shopkeepers to procure. */\n  publishToWholesale(input: CommercePublishToWholesaleInput): Promise<any>;\n  /** Browse available wholesale listings. */\n  browseWholesale(input?: CommerceBrowseWholesaleInput): Promise<CommerceWholesaleListing[]>;\n  /** Procure goods from the wholesale market. */\n  procureBatch(input: CommerceProcureBatchInput): Promise<any>;\n\n  // Inventory\n  /** View and manage shop inventory (list or sync from Core). */\n  manageInventory(input?: CommerceManageInventoryInput): Promise<any>;\n  /** Register existing Core instances into shop inventory. */\n  registerInstances(input: CommerceRegisterInstancesInput): Promise<any>;\n  /** Mint new instances directly into shop inventory. */\n  mintToInventory(input: CommerceMintToInventoryInput): Promise<any>;\n\n  // Settlement\n  /** Get settlement report with revenue breakdown. */\n  getSettlementReport(input?: CommerceGetSettlementReportInput): Promise<any>;\n\n  // Discovery\n  /** Search the marketplace for campaigns. */\n  searchMarketplace(input?: CommerceSearchMarketplaceInput): Promise<any[]>;\n  /** Find shops selling a specific GoodZ card. */\n  getShopsByBlueprint(input: CommerceGetShopsByBlueprintInput): Promise<any[]>;\n\n  // Physical Redemption\n  /** Request physical redemption for a purchased item. */\n  redeemPhysical(input: CommerceRedeemPhysicalInput): Promise<any>;\n\n  // Webhooks\n  /** Register a webhook URL to receive shop event notifications. */\n  registerWebhook(input: CommerceRegisterWebhookInput): Promise<CommerceWebhook>;\n  /** List all registered webhook endpoints. */\n  listWebhooks(): Promise<CommerceWebhook[]>;\n  /** Send a test ping to a webhook endpoint. */\n  testWebhook(input: CommerceTestWebhookInput): Promise<any>;\n  /** Delete a webhook endpoint. */\n  deleteWebhook(input: CommerceDeleteWebhookInput): Promise<any>;\n\n  // OAuth App Management\n  /** Register a new OAuth application with Commerce scopes. */\n  registerApp(input: CommerceRegisterAppInput): Promise<any>;\n  /** Update an existing OAuth application. */\n  updateApp(input: CommerceUpdateAppInput): Promise<any>;\n  /** List all OAuth applications owned by the user. */\n  listMyApps(input?: CommerceListMyAppsInput): Promise<any[]>;\n  /** Generate an OAuth authorization URL. */\n  getAuthUrl(input?: CommerceGetAuthUrlInput): Promise<{ url: string }>;\n\n  /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */\n  rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;\n}\n\n// ─── Factory ────────────────────────────────────────────────\n\nexport function createCommerceNamespace(transport: TransportConfig): CommerceNamespace {\n  const tool = <I extends Record<string, any>, O>(name: string) =>\n    (input?: I) => callMcpTool<I, O>(transport, name, input as I);\n\n  return {\n    // Shop\n    createShop: tool<CommerceCreateShopInput, CommerceShop>(\"create_shop\"),\n    getShopDashboard: tool<CommerceGetShopDashboardInput, CommerceShopDashboard>(\"get_shop_dashboard\"),\n\n    // Product Assembly\n    createBatch: tool<CommerceCreateBatchInput, CommerceBatch>(\"assemble_batch\"),\n    createGachaPool: tool<CommerceCreateGachaPoolInput, CommerceGachaPool>(\"create_gacha_pool\"),\n\n    // Campaign Lifecycle\n    launchCampaign: tool<CommerceLaunchCampaignInput, CommerceCampaign>(\"launch_sales_campaign\"),\n    activateCampaign: tool<CommerceActivateCampaignInput, CommerceCampaign>(\"activate_campaign\"),\n    pauseCampaign: tool<CommercePauseCampaignInput, CommerceCampaign>(\"pause_campaign\"),\n    endCampaign: tool<CommerceEndCampaignInput, CommerceCampaign>(\"end_campaign\"),\n    updateCampaign: tool<CommerceUpdateCampaignInput, CommerceCampaign>(\"update_campaign\"),\n    getCampaignInfo: tool<CommerceGetCampaignInfoInput, any>(\"get_campaign_info\"),\n    getCampaignItems: tool<CommerceGetCampaignItemsInput, CommerceCampaignItem[]>(\"get_campaign_items\"),\n\n    // Purchase\n    executePurchase: tool<CommerceExecutePurchaseInput, CommerceDrawResult>(\"execute_purchase\"),\n    getMyOrders: tool<CommerceGetMyOrdersInput, CommerceOrder[]>(\"get_my_orders\"),\n\n    // Wholesale\n    publishToWholesale: tool<CommercePublishToWholesaleInput, any>(\"publish_to_wholesale\"),\n    browseWholesale: tool<CommerceBrowseWholesaleInput, CommerceWholesaleListing[]>(\"browse_wholesale_market\"),\n    procureBatch: tool<CommerceProcureBatchInput, any>(\"procure_batch\"),\n\n    // Inventory\n    manageInventory: tool<CommerceManageInventoryInput, any>(\"manage_inventory\"),\n    registerInstances: tool<CommerceRegisterInstancesInput, any>(\"register_instances\"),\n    mintToInventory: tool<CommerceMintToInventoryInput, any>(\"mint_to_inventory\"),\n\n    // Settlement\n    getSettlementReport: tool<CommerceGetSettlementReportInput, any>(\"get_settlement_report\"),\n\n    // Discovery\n    searchMarketplace: tool<CommerceSearchMarketplaceInput, any[]>(\"search_marketplace\"),\n    getShopsByBlueprint: tool<CommerceGetShopsByBlueprintInput, any[]>(\"get_shops_by_blueprint\"),\n\n    // Physical Redemption\n    redeemPhysical: tool<CommerceRedeemPhysicalInput, any>(\"redeem_physical_goodz\"),\n\n    // Webhooks\n    registerWebhook: tool<CommerceRegisterWebhookInput, CommerceWebhook>(\"register_webhook\"),\n    listWebhooks: tool<Record<string, never>, CommerceWebhook[]>(\"list_webhooks\"),\n    testWebhook: tool<CommerceTestWebhookInput, any>(\"test_webhook\"),\n    deleteWebhook: tool<CommerceDeleteWebhookInput, any>(\"delete_webhook\"),\n\n    // OAuth App\n    registerApp: tool<CommerceRegisterAppInput, any>(\"register_app\"),\n    updateApp: tool<CommerceUpdateAppInput, any>(\"update_app\"),\n    listMyApps: tool<CommerceListMyAppsInput, any[]>(\"list_my_apps\"),\n    getAuthUrl: tool<CommerceGetAuthUrlInput, { url: string }>(\"get_auth_url\"),\n\n    // Raw escape hatch\n    rawTool: <T = any>(toolName: string, args?: Record<string, any>) =>\n      callMcpTool<Record<string, any>, T>(transport, toolName, args),\n  };\n}\n"]}

package/dist/commerce/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as TransportConfig } from '../transport-CzoXrUZs.js';
+import { $ as TransportConfig } from '../transport-BSpGsxyt.js';
 
 /**
  * @goodz-core/sdk — Commerce / Shops API Type Definitions

package/dist/commerce/index.js

@@ -1,4 +1,4 @@
-export { createCommerceNamespace } from '../chunk-V73MMKHI.js';
-import '../chunk-4SU7SU7K.js';
+export { createCommerceNamespace } from '../chunk-SWD7BJQ7.js';
+import '../chunk-ORUFMYZB.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/core/index.d.ts

@@ -4,8 +4,8 @@ import { ExchangeNamespace } from '../exchange/index.js';
 export { CompensationDirection, ExchangeAddToWatchlistInput, ExchangeBid, ExchangeBrowseMarketplaceInput, ExchangeBuyListingInput, ExchangeBuyListingOutput, ExchangeCancelListingInput, ExchangeCancelWtbInput, ExchangeCreateListingInput, ExchangeCreateListingOutput, ExchangeCreateWtbInput, ExchangeFulfillWtbInput, ExchangeFulfillWtbOutput, ExchangeGetBidsInput, ExchangeGetListingDetailInput, ExchangeGetMarketDataInput, ExchangeListing, ExchangeMarketData, ExchangePlaceBidInput, ExchangePlaceBidOutput, ExchangePricePoint, ExchangeProposeTradeInput, ExchangeRemoveFromWatchlistInput, ExchangeRespondToTradeInput, ExchangeRespondToTradeOutput, ExchangeTradeItem, ExchangeTradeProposal, ExchangeWatchlistItem, ExchangeWtb, ListingCondition, ListingType } from '../exchange/index.js';
 import { AliveNamespace } from '../alive/index.js';
 export { AliveBuildContextInput, AliveChatResponse, AliveClassifiedIntent, AliveClassifyIntentInput, AliveContext, AliveForgetMemoryInput, AliveGetIntimacyInput, AliveIntimacy, AliveMemory, AliveRecallMemoriesInput, AliveSendMessageInput, AliveStoreMemoryInput, AliveUpdateIntimacyInput, IntentCategory, MemoryType, MoodState } from '../alive/index.js';
-import { b as AuthUser, A as AuthGetOAuthAppInfoInput, a as AuthOAuthAppInfo, e as CollectibleGetInstanceByIdInput, f as CollectibleGetPublicInstanceInput, g as CollectibleGetPublicInstancesBatchInput, d as CollectibleGetCardProfileInput, h as CollectibleGetShellImageUrlInput, V as ZcoinGetMyBalanceOutput, W as ZcoinGetMyHistoryInput, M as ZcoinGetDepositPackagesInput, L as ZcoinDepositPackage, E as ZcoinCreateDepositOrderInput, H as ZcoinCreateDepositOrderOutput, N as ZcoinGetDepositStatusInput, O as ZcoinGetDepositStatusOutput, Q as ZcoinGetDepositUrlInput, R as ZcoinGetDepositUrlOutput, B as ZcoinCommercialTransferInput, D as ZcoinCommercialTransferOutput, X as ZcoinMintAndChargeInput, Y as ZcoinMintAndChargeOutput, Z as ZcoinChargeUserInput, z as ZcoinChargeUserOutput, J as ZcoinCreateDirectPurchaseOrderInput, K as ZcoinCreateDirectPurchaseOrderOutput, l as InventoryGetUserInventoryInput, n as InventoryItem, I as InventoryConfirmOwnershipInput, k as InventoryConfirmOwnershipOutput, o as InventoryMintInput, p as InventoryMintOutput, t as InventoryTransferInput, u as InventoryTransferOutput, q as InventoryTransferByCardInput, r as InventoryTransferByCardOutput, m as InventoryGrantMintAuthInput, s as InventoryTransferHistoryInput, x as UserGetPublicProfileInput, y as UserPublicProfile, U as UserGetPublicProfileByIdInput, F as FranchiseGetInput, v as SeriesGetInput, w as SeriesListByFranchiseInput, C as CardGetInput, c as CardListBySeriesInput } from '../transport-CzoXrUZs.js';
-export { G as GoodZApiError, i as GoodZApiFieldError, j as GoodZErrorV2, P as PurchaseChannel, S as SaleType, T as TransferReason, _ as ZcoinTxType } from '../transport-CzoXrUZs.js';
+import { b as AuthUser, A as AuthGetOAuthAppInfoInput, a as AuthOAuthAppInfo, e as CollectibleGetInstanceByIdInput, f as CollectibleGetPublicInstanceInput, g as CollectibleGetPublicInstancesBatchInput, d as CollectibleGetCardProfileInput, h as CollectibleGetShellImageUrlInput, V as ZcoinGetMyBalanceOutput, W as ZcoinGetMyHistoryInput, M as ZcoinGetDepositPackagesInput, L as ZcoinDepositPackage, E as ZcoinCreateDepositOrderInput, H as ZcoinCreateDepositOrderOutput, N as ZcoinGetDepositStatusInput, O as ZcoinGetDepositStatusOutput, Q as ZcoinGetDepositUrlInput, R as ZcoinGetDepositUrlOutput, B as ZcoinCommercialTransferInput, D as ZcoinCommercialTransferOutput, X as ZcoinMintAndChargeInput, Y as ZcoinMintAndChargeOutput, Z as ZcoinChargeUserInput, z as ZcoinChargeUserOutput, J as ZcoinCreateDirectPurchaseOrderInput, K as ZcoinCreateDirectPurchaseOrderOutput, l as InventoryGetUserInventoryInput, n as InventoryItem, I as InventoryConfirmOwnershipInput, k as InventoryConfirmOwnershipOutput, o as InventoryMintInput, p as InventoryMintOutput, t as InventoryTransferInput, u as InventoryTransferOutput, q as InventoryTransferByCardInput, r as InventoryTransferByCardOutput, m as InventoryGrantMintAuthInput, s as InventoryTransferHistoryInput, x as UserGetPublicProfileInput, y as UserPublicProfile, U as UserGetPublicProfileByIdInput, F as FranchiseGetInput, v as SeriesGetInput, w as SeriesListByFranchiseInput, C as CardGetInput, c as CardListBySeriesInput } from '../transport-BSpGsxyt.js';
+export { G as GoodZApiError, i as GoodZApiFieldError, j as GoodZErrorV2, P as PurchaseChannel, S as SaleType, T as TransferReason, _ as ZcoinTxType } from '../transport-BSpGsxyt.js';
 
 /**
  * @goodz-core/sdk/core — Unified GoodZ API Client
@@ -126,7 +126,8 @@ interface ZcoinNamespace {
      *
      * Idempotent via referenceId — duplicate calls return the same result.
      *
-     * @throws {GoodZApiError} BAD_REQUEST — insufficient balance
+     * @throws {GoodZApiError} INSUFFICIENT_BALANCE — use `e.isInsufficientBalance()` to detect,
+     *   `e.depositUrl` to get the top-up redirect URL
      * @throws {GoodZApiError} CONFLICT — version conflict (retry)
      * @throws {GoodZApiError} FORBIDDEN — seller doesn't own instance
      */
@@ -139,7 +140,8 @@ interface ZcoinNamespace {
      * Idempotent via referenceId.
      *
      * @throws {GoodZApiError} FORBIDDEN — no mint authorization
-     * @throws {GoodZApiError} BAD_REQUEST — insufficient balance
+     * @throws {GoodZApiError} INSUFFICIENT_BALANCE — use `e.isInsufficientBalance()` to detect,
+     *   `e.depositUrl` to get the top-up redirect URL
      */
     mintAndCharge(input: ZcoinMintAndChargeInput): Promise<ZcoinMintAndChargeOutput>;
     /**
@@ -148,7 +150,8 @@ interface ZcoinNamespace {
      *
      * Idempotent via appOrderId.
      *
-     * @throws {GoodZApiError} BAD_REQUEST — insufficient balance
+     * @throws {GoodZApiError} INSUFFICIENT_BALANCE — use `e.isInsufficientBalance()` to detect,
+     *   `e.depositUrl` to get the top-up redirect URL
      * @throws {GoodZApiError} CONFLICT — version conflict
      */
     chargeUser(input: ZcoinChargeUserInput): Promise<ZcoinChargeUserOutput>;

package/dist/core/index.js

@@ -1,7 +1,7 @@
-export { createGoodZClient, createUserClient } from '../chunk-EQUAL5M6.js';
-import '../chunk-V73MMKHI.js';
-import '../chunk-OUKZ2PRD.js';
-import '../chunk-JAVMQXJM.js';
-export { GoodZApiError } from '../chunk-4SU7SU7K.js';
+export { createGoodZClient, createUserClient } from '../chunk-DSWHCVKV.js';
+import '../chunk-SWD7BJQ7.js';
+import '../chunk-GH33FPMY.js';
+import '../chunk-KP7DP5LP.js';
+export { GoodZApiError } from '../chunk-ORUFMYZB.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/exchange/index.d.ts

@@ -1,4 +1,4 @@
-import { $ as TransportConfig } from '../transport-CzoXrUZs.js';
+import { $ as TransportConfig } from '../transport-BSpGsxyt.js';
 
 /**
  * @goodz-core/sdk — Exchange API Type Definitions

package/dist/exchange/index.js

@@ -1,4 +1,4 @@
-export { createExchangeNamespace } from '../chunk-OUKZ2PRD.js';
-import '../chunk-4SU7SU7K.js';
+export { createExchangeNamespace } from '../chunk-GH33FPMY.js';
+import '../chunk-ORUFMYZB.js';
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.d.ts

@@ -1,5 +1,5 @@
 export { AuthNamespace, CollectibleNamespace, GoodZClient, GoodZClientConfig, InventoryNamespace, IpNamespace, UserNamespace, ZcoinNamespace, createGoodZClient, createUserClient } from './core/index.js';
-export { A as AuthGetOAuthAppInfoInput, a as AuthOAuthAppInfo, b as AuthUser, C as CardGetInput, c as CardListBySeriesInput, d as CollectibleGetCardProfileInput, e as CollectibleGetInstanceByIdInput, f as CollectibleGetPublicInstanceInput, g as CollectibleGetPublicInstancesBatchInput, h as CollectibleGetShellImageUrlInput, F as FranchiseGetInput, G as GoodZApiError, i as GoodZApiFieldError, j as GoodZErrorV2, I as InventoryConfirmOwnershipInput, k as InventoryConfirmOwnershipOutput, l as InventoryGetUserInventoryInput, m as InventoryGrantMintAuthInput, n as InventoryItem, o as InventoryMintInput, p as InventoryMintOutput, q as InventoryTransferByCardInput, r as InventoryTransferByCardOutput, s as InventoryTransferHistoryInput, t as InventoryTransferInput, u as InventoryTransferOutput, P as PurchaseChannel, S as SaleType, v as SeriesGetInput, w as SeriesListByFranchiseInput, T as TransferReason, U as UserGetPublicProfileByIdInput, x as UserGetPublicProfileInput, y as UserPublicProfile, Z as ZcoinChargeUserInput, z as ZcoinChargeUserOutput, B as ZcoinCommercialTransferInput, D as ZcoinCommercialTransferOutput, E as ZcoinCreateDepositOrderInput, H as ZcoinCreateDepositOrderOutput, J as ZcoinCreateDirectPurchaseOrderInput, K as ZcoinCreateDirectPurchaseOrderOutput, L as ZcoinDepositPackage, M as ZcoinGetDepositPackagesInput, N as ZcoinGetDepositStatusInput, O as ZcoinGetDepositStatusOutput, Q as ZcoinGetDepositUrlInput, R as ZcoinGetDepositUrlOutput, V as ZcoinGetMyBalanceOutput, W as ZcoinGetMyHistoryInput, X as ZcoinMintAndChargeInput, Y as ZcoinMintAndChargeOutput, _ as ZcoinTxType } from './transport-CzoXrUZs.js';
+export { A as AuthGetOAuthAppInfoInput, a as AuthOAuthAppInfo, b as AuthUser, C as CardGetInput, c as CardListBySeriesInput, d as CollectibleGetCardProfileInput, e as CollectibleGetInstanceByIdInput, f as CollectibleGetPublicInstanceInput, g as CollectibleGetPublicInstancesBatchInput, h as CollectibleGetShellImageUrlInput, F as FranchiseGetInput, G as GoodZApiError, i as GoodZApiFieldError, j as GoodZErrorV2, I as InventoryConfirmOwnershipInput, k as InventoryConfirmOwnershipOutput, l as InventoryGetUserInventoryInput, m as InventoryGrantMintAuthInput, n as InventoryItem, o as InventoryMintInput, p as InventoryMintOutput, q as InventoryTransferByCardInput, r as InventoryTransferByCardOutput, s as InventoryTransferHistoryInput, t as InventoryTransferInput, u as InventoryTransferOutput, P as PurchaseChannel, S as SaleType, v as SeriesGetInput, w as SeriesListByFranchiseInput, T as TransferReason, U as UserGetPublicProfileByIdInput, x as UserGetPublicProfileInput, y as UserPublicProfile, Z as ZcoinChargeUserInput, z as ZcoinChargeUserOutput, B as ZcoinCommercialTransferInput, D as ZcoinCommercialTransferOutput, E as ZcoinCreateDepositOrderInput, H as ZcoinCreateDepositOrderOutput, J as ZcoinCreateDirectPurchaseOrderInput, K as ZcoinCreateDirectPurchaseOrderOutput, L as ZcoinDepositPackage, M as ZcoinGetDepositPackagesInput, N as ZcoinGetDepositStatusInput, O as ZcoinGetDepositStatusOutput, Q as ZcoinGetDepositUrlInput, R as ZcoinGetDepositUrlOutput, V as ZcoinGetMyBalanceOutput, W as ZcoinGetMyHistoryInput, X as ZcoinMintAndChargeInput, Y as ZcoinMintAndChargeOutput, _ as ZcoinTxType } from './transport-BSpGsxyt.js';
 export { AuthorizationMode, CampaignStatus, CommerceActivateCampaignInput, CommerceBatch, CommerceBatchTier, CommerceBrowseWholesaleInput, CommerceCampaign, CommerceCampaignItem, CommerceCreateBatchInput, CommerceCreateGachaPoolInput, CommerceCreateShopInput, CommerceDeleteWebhookInput, CommerceDrawResult, CommerceEndCampaignInput, CommerceExecutePurchaseInput, CommerceGachaItem, CommerceGachaPool, CommerceGetAuthUrlInput, CommerceGetCampaignInfoInput, CommerceGetCampaignItemsInput, CommerceGetMyOrdersInput, CommerceGetSettlementReportInput, CommerceGetShopDashboardInput, CommerceGetShopsByBlueprintInput, CommerceLaunchCampaignInput, CommerceListMyAppsInput, CommerceManageInventoryInput, CommerceMintToInventoryInput, CommerceNamespace, CommerceOrder, CommercePauseCampaignInput, CommercePityConfig, CommerceProcureBatchInput, CommercePublishToWholesaleInput, CommerceRedeemPhysicalInput, CommerceRegisterAppInput, CommerceRegisterInstancesInput, CommerceRegisterWebhookInput, CommerceSearchMarketplaceInput, CommerceShop, CommerceShopDashboard, CommerceTestWebhookInput, CommerceUpdateAppInput, CommerceUpdateCampaignInput, CommerceWebhook, CommerceWholesaleListing, IntegrationMode, SaleMode } from './commerce/index.js';
 export { CompensationDirection, ExchangeAddToWatchlistInput, ExchangeBid, ExchangeBrowseMarketplaceInput, ExchangeBuyListingInput, ExchangeBuyListingOutput, ExchangeCancelListingInput, ExchangeCancelWtbInput, ExchangeCreateListingInput, ExchangeCreateListingOutput, ExchangeCreateWtbInput, ExchangeFulfillWtbInput, ExchangeFulfillWtbOutput, ExchangeGetBidsInput, ExchangeGetListingDetailInput, ExchangeGetMarketDataInput, ExchangeListing, ExchangeMarketData, ExchangeNamespace, ExchangePlaceBidInput, ExchangePlaceBidOutput, ExchangePricePoint, ExchangeProposeTradeInput, ExchangeRemoveFromWatchlistInput, ExchangeRespondToTradeInput, ExchangeRespondToTradeOutput, ExchangeTradeItem, ExchangeTradeProposal, ExchangeWatchlistItem, ExchangeWtb, ListingCondition, ListingType } from './exchange/index.js';
 export { AliveBuildContextInput, AliveChatResponse, AliveClassifiedIntent, AliveClassifyIntentInput, AliveContext, AliveForgetMemoryInput, AliveGetIntimacyInput, AliveIntimacy, AliveMemory, AliveNamespace, AliveRecallMemoriesInput, AliveSendMessageInput, AliveStoreMemoryInput, AliveUpdateIntimacyInput, IntentCategory, MemoryType, MoodState } from './alive/index.js';
@@ -46,6 +46,6 @@ import 'react';
  * @module
  */
 
-declare const SDK_VERSION = "0.3.3";
+declare const SDK_VERSION = "0.3.4";
 
 export { SDK_VERSION };

package/dist/index.js

@@ -1,14 +1,14 @@
-export { createGoodZClient, createUserClient } from './chunk-EQUAL5M6.js';
+export { createGoodZClient, createUserClient } from './chunk-DSWHCVKV.js';
 export { TokenManager, buildAuthorizationUrl, exchangeCode } from './chunk-EUKUN4JF.js';
 export { ZCOIN_PRECISION, formatZcoin, formatZcoinWithSymbol, toDisplay, toHundredths } from './chunk-2ZETOE2X.js';
 export { FORM_FACTORS, GoodZCardFocus, getAspectRatioCSS, getFormFactorSpec } from './chunk-K6IFJWLB.js';
-import './chunk-V73MMKHI.js';
-import './chunk-OUKZ2PRD.js';
-import './chunk-JAVMQXJM.js';
-export { GoodZApiError } from './chunk-4SU7SU7K.js';
+import './chunk-SWD7BJQ7.js';
+import './chunk-GH33FPMY.js';
+import './chunk-KP7DP5LP.js';
+export { GoodZApiError } from './chunk-ORUFMYZB.js';
 
 // src/index.ts
-var SDK_VERSION = "0.3.3";
+var SDK_VERSION = "0.3.4";
 
 export { SDK_VERSION };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;AAqGO,IAAM,WAAA,GAAc","file":"index.js","sourcesContent":["/**\n * @goodz-core/sdk — Official SDK for the GoodZ Ecosystem\n *\n * One package, all services. Stripe-style unified client.\n *\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk\";\n *\n * const goodz = createGoodZClient({ accessToken: \"...\" });\n *\n * // Core\n * await goodz.zcoin.getMyBalance();\n * await goodz.inventory.mint({ ... });\n *\n * // Commerce\n * await goodz.commerce.createShop({ name: \"My Shop\" });\n * await goodz.commerce.executePurchase({ campaignId: 1, quantity: 1 });\n *\n * // Exchange\n * await goodz.exchange.createListing({ ... });\n * await goodz.exchange.getMarketData({ coreGoodzId: 42 });\n *\n * // Alive\n * await goodz.alive.sendMessage({ instanceId: 1, userId: 1, message: \"Hello!\" });\n * ```\n *\n * For tree-shaking, prefer importing from specific subpaths:\n *\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk/core\";\n * import { TokenManager } from \"@goodz-core/sdk/auth\";\n * import { GoodZCardFocus } from \"@goodz-core/sdk/ui\";\n * ```\n *\n * @module\n */\n\n// Core client (includes all namespace types)\nexport {\n  createGoodZClient,\n  createUserClient,\n  GoodZApiError,\n  type GoodZClient,\n  type GoodZClientConfig,\n  // Core namespaces\n  type ZcoinNamespace,\n  type InventoryNamespace,\n  type CollectibleNamespace,\n  type UserNamespace,\n  type AuthNamespace,\n  type IpNamespace,\n  // Sub-site namespaces\n  type CommerceNamespace,\n  type ExchangeNamespace,\n  type AliveNamespace,\n} from \"./core/index\";\n\n// All API types — Core\nexport type * from \"./types\";\n\n// All API types — Commerce\nexport type * from \"./types-commerce\";\n\n// All API types — Exchange\nexport type * from \"./types-exchange\";\n\n// All API types — Alive\nexport type * from \"./types-alive\";\n\n// Auth helpers\nexport {\n  TokenManager,\n  buildAuthorizationUrl,\n  exchangeCode,\n  type TokenManagerConfig,\n  type TokenPair,\n  type OAuthUrlConfig,\n} from \"./auth/index\";\n\n// Z-coin utilities\nexport {\n  ZCOIN_PRECISION,\n  toHundredths,\n  toDisplay,\n  formatZcoin,\n  formatZcoinWithSymbol,\n} from \"./zcoin-utils\";\n\n// UI components (React 18+)\n// Note: Import from \"@goodz-core/sdk/ui\" for tree-shaking\nexport {\n  GoodZCardFocus,\n  type GoodZCardFocusProps,\n  type FormFactorKey,\n  type FormFactorSpec,\n  FORM_FACTORS,\n  getFormFactorSpec,\n  getAspectRatioCSS,\n} from \"./ui/index\";\n\n// SDK version\nexport const SDK_VERSION = \"0.3.3\";\n"]}
+{"version":3,"sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;AAqGO,IAAM,WAAA,GAAc","file":"index.js","sourcesContent":["/**\n * @goodz-core/sdk — Official SDK for the GoodZ Ecosystem\n *\n * One package, all services. Stripe-style unified client.\n *\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk\";\n *\n * const goodz = createGoodZClient({ accessToken: \"...\" });\n *\n * // Core\n * await goodz.zcoin.getMyBalance();\n * await goodz.inventory.mint({ ... });\n *\n * // Commerce\n * await goodz.commerce.createShop({ name: \"My Shop\" });\n * await goodz.commerce.executePurchase({ campaignId: 1, quantity: 1 });\n *\n * // Exchange\n * await goodz.exchange.createListing({ ... });\n * await goodz.exchange.getMarketData({ coreGoodzId: 42 });\n *\n * // Alive\n * await goodz.alive.sendMessage({ instanceId: 1, userId: 1, message: \"Hello!\" });\n * ```\n *\n * For tree-shaking, prefer importing from specific subpaths:\n *\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk/core\";\n * import { TokenManager } from \"@goodz-core/sdk/auth\";\n * import { GoodZCardFocus } from \"@goodz-core/sdk/ui\";\n * ```\n *\n * @module\n */\n\n// Core client (includes all namespace types)\nexport {\n  createGoodZClient,\n  createUserClient,\n  GoodZApiError,\n  type GoodZClient,\n  type GoodZClientConfig,\n  // Core namespaces\n  type ZcoinNamespace,\n  type InventoryNamespace,\n  type CollectibleNamespace,\n  type UserNamespace,\n  type AuthNamespace,\n  type IpNamespace,\n  // Sub-site namespaces\n  type CommerceNamespace,\n  type ExchangeNamespace,\n  type AliveNamespace,\n} from \"./core/index\";\n\n// All API types — Core\nexport type * from \"./types\";\n\n// All API types — Commerce\nexport type * from \"./types-commerce\";\n\n// All API types — Exchange\nexport type * from \"./types-exchange\";\n\n// All API types — Alive\nexport type * from \"./types-alive\";\n\n// Auth helpers\nexport {\n  TokenManager,\n  buildAuthorizationUrl,\n  exchangeCode,\n  type TokenManagerConfig,\n  type TokenPair,\n  type OAuthUrlConfig,\n} from \"./auth/index\";\n\n// Z-coin utilities\nexport {\n  ZCOIN_PRECISION,\n  toHundredths,\n  toDisplay,\n  formatZcoin,\n  formatZcoinWithSymbol,\n} from \"./zcoin-utils\";\n\n// UI components (React 18+)\n// Note: Import from \"@goodz-core/sdk/ui\" for tree-shaking\nexport {\n  GoodZCardFocus,\n  type GoodZCardFocusProps,\n  type FormFactorKey,\n  type FormFactorSpec,\n  FORM_FACTORS,\n  getFormFactorSpec,\n  getAspectRatioCSS,\n} from \"./ui/index\";\n\n// SDK version\nexport const SDK_VERSION = \"0.3.4\";\n"]}

package/dist/{transport-CzoXrUZs.d.ts → transport-BSpGsxyt.d.ts}

@@ -423,6 +423,28 @@ declare class GoodZApiError extends Error {
     });
     /** Human-readable summary including field errors if present. */
     toDetailedString(): string;
+    /**
+     * Check if this error is an insufficient Z-coin balance error.
+     * When true, `depositUrl` provides the URL to redirect users for top-up.
+     *
+     * @example
+     * ```ts
+     * try {
+     *   await goodz.zcoin.commercialTransfer({ ... });
+     * } catch (e) {
+     *   if (e instanceof GoodZApiError && e.isInsufficientBalance()) {
+     *     window.open(e.depositUrl!, '_blank');
+     *   }
+     * }
+     * ```
+     */
+    isInsufficientBalance(): boolean;
+    /**
+     * Deposit URL for Z-coin top-up (available when isInsufficientBalance() is true).
+     * Returned by Core when a payment fails due to insufficient balance.
+     * Append `&amount={needed}&return_url={your_page}` for seamless round-trip.
+     */
+    get depositUrl(): string | undefined;
 }
 interface TransportConfig {
     baseUrl: string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goodz-core/sdk",
-  "version": "0.3.3",
+  "version": "0.3.4",
   "description": "Official SDK for the GoodZ Ecosystem — unified API client for Core, Commerce, Exchange, and Alive. Includes OAuth helpers, Z-coin utilities, and React UI components.",
   "type": "module",
   "main": "./dist/index.js",

package/dist/chunk-4SU7SU7K.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/transport.ts","../src/mcp-transport.ts"],"names":[],"mappings":";;;AAmBO,IAAM,aAAA,GAAN,cAA4B,KAAA,CAAM;AAAA,EACvB,IAAA;AAAA,EACA,UAAA;AAAA,EACA,IAAA;AAAA,EACA,SAAA;AAAA,EACA,IAAA;AAAA,EAEhB,YAAY,IAAA,EAOT;AACD,IAAA,KAAA,CAAM,KAAK,OAAO,CAAA;AAClB,IAAA,IAAA,CAAK,IAAA,GAAO,eAAA;AACZ,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,aAAa,IAAA,CAAK,UAAA;AACvB,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AACjB,IAAA,IAAA,CAAK,YAAY,IAAA,CAAK,SAAA;AACtB,IAAA,IAAA,CAAK,OAAO,IAAA,CAAK,IAAA;AAAA,EACnB;AAAA;AAAA,EAGA,gBAAA,GAA2B;AACzB,IAAA,MAAM,KAAA,GAAQ;AAAA,MACZ,CAAA,gBAAA,EAAmB,KAAK,IAAI,CAAA,IAAA,EAAO,KAAK,IAAI,CAAA,EAAA,EAAK,KAAK,OAAO,CAAA;AAAA,KAC/D;AACA,IAAA,IAAI,IAAA,CAAK,WAAW,MAAA,EAAQ;AAC1B,MAAA,KAAA,CAAM,KAAK,eAAe,CAAA;AAC1B,MAAA,KAAA,MAAW,CAAA,IAAK,KAAK,SAAA,EAAW;AAC9B,QAAA,KAAA,CAAM,IAAA,CAAK,CAAA,IAAA,EAAO,CAAA,CAAE,IAAA,CAAK,IAAA,CAAK,GAAG,CAAC,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,EAAA,EAAK,CAAA,CAAE,IAAI,CAAA,CAAA,CAAG,CAAA;AAAA,MAChE;AAAA,IACF;AACA,IAAA,OAAO,KAAA,CAAM,KAAK,IAAI,CAAA;AAAA,EACxB;AACF;AAgBA,eAAsB,SAAA,CACpB,MAAA,EACA,IAAA,EACA,KAAA,EACkB;AAClB,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,MAAA,CAAO,OAAO,aAAa,IAAI,CAAA,CAAA;AAC9C,EAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,UAAA,EAAW;AAGxC,EAAA,MAAM,aAAa,KAAA,KAAU,MAAA,GAAY,SAAA,CAAU,SAAA,CAAU,KAAK,CAAA,GAAI,MAAA;AACtE,EAAA,MAAM,QAAA,GAAW,UAAA,GACb,CAAA,EAAG,GAAG,CAAA,OAAA,EAAU,kBAAA,CAAmB,IAAA,CAAK,SAAA,CAAU,UAAU,CAAC,CAAC,CAAA,CAAA,GAC9D,GAAA;AAEJ,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,QAAA,EAAU;AAAA,IAChC,MAAA,EAAQ,KAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,GAAG,OAAA;AAAA,MACH,cAAA,EAAgB;AAAA;AAClB,GACD,CAAA;AAED,EAAA,OAAO,aAAA,CAAuB,KAAK,IAAI,CAAA;AACzC;AAKA,eAAsB,YAAA,CACpB,MAAA,EACA,IAAA,EACA,KAAA,EACkB;AAClB,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,MAAA,CAAO,OAAO,aAAa,IAAI,CAAA,CAAA;AAC9C,EAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,UAAA,EAAW;AAExC,EAAA,MAAM,aAAa,KAAA,KAAU,MAAA,GAAY,SAAA,CAAU,SAAA,CAAU,KAAK,CAAA,GAAI,MAAA;AAEtE,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,IAC3B,MAAA,EAAQ,MAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,GAAG,OAAA;AAAA,MACH,cAAA,EAAgB;AAAA,KAClB;AAAA,IACA,IAAA,EAAM,UAAA,GAAa,IAAA,CAAK,SAAA,CAAU,UAAU,CAAA,GAAI;AAAA,GACjD,CAAA;AAED,EAAA,OAAO,aAAA,CAAuB,KAAK,IAAI,CAAA;AACzC;AAIA,eAAe,aAAA,CAAiB,KAAe,IAAA,EAA0B;AACvE,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,EAAA,IAAI,IAAA;AAEJ,EAAA,IAAI;AACF,IAAA,IAAA,GAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EACxB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,SAAS,CAAA,uBAAA,EAA0B,IAAA,CAAK,KAAA,CAAM,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AAAA,MACrD,IAAA,EAAM,aAAA;AAAA,MACN,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB;AAAA,KACD,CAAA;AAAA,EACH;AAIA,EAAA,MAAM,WAAW,KAAA,CAAM,OAAA,CAAQ,IAAI,CAAA,GAAI,IAAA,CAAK,CAAC,CAAA,GAAI,IAAA;AAGjD,EAAA,IAAI,UAAU,KAAA,EAAO;AACnB,IAAA,MAAM,MAAM,QAAA,CAAS,KAAA;AACrB,IAAA,MAAM,OAAA,GAAU,KAAK,IAAA,IAAQ,GAAA;AAC7B,IAAA,MAAM,OAAA,GAAU,OAAA,EAAS,IAAA,IAAQ,EAAC;AAElC,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,OAAA,EAAS,SAAS,OAAA,IAAW,mBAAA;AAAA,MAC7B,IAAA,EAAM,OAAA,EAAS,IAAA,IAAQ,OAAA,EAAS,IAAA,IAAQ,SAAA;AAAA,MACxC,UAAA,EAAY,OAAA,EAAS,UAAA,IAAc,GAAA,CAAI,MAAA;AAAA,MACvC,IAAA,EAAM,SAAS,IAAA,IAAQ,IAAA;AAAA,MACvB,SAAA,EAAW,SAAS,QAAA,EAAU,MAAA;AAAA,MAC9B,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAGA,EAAA,MAAM,UAAA,GAAa,UAAU,MAAA,EAAQ,IAAA;AACrC,EAAA,IAAI,eAAe,MAAA,EAAW;AAE5B,IAAA,IAAI,GAAA,CAAI,IAAI,OAAO,MAAA;AAEnB,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,OAAA,EAAS,kCAAkC,IAAI,CAAA,CAAA;AAAA,MAC/C,IAAA,EAAM,qBAAA;AAAA,MACN,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB;AAAA,KACD,CAAA;AAAA,EACH;AAIA,EAAA,IAAI,UAAA,IAAc,OAAO,UAAA,KAAe,QAAA,IAAY,UAAU,UAAA,EAAY;AACxE,IAAA,OAAO,SAAA,CAAU,YAAY,UAAU,CAAA;AAAA,EACzC;AAGA,EAAA,OAAO,UAAA;AACT;;;AC1JA,IAAI,aAAA,GAAgB,CAAA;AACpB,SAAS,MAAA,GAAiB;AACxB,EAAA,OAAO,EAAE,aAAA;AACX;AAIA,IAAM,WAAA,uBAAkB,GAAA,EAAoB;AAa5C,eAAsB,WAAA,CACpB,MAAA,EACA,QAAA,EACA,IAAA,EACkB;AAClB,EAAA,MAAM,GAAA,GAAM,CAAA,EAAG,MAAA,CAAO,OAAO,CAAA,QAAA,CAAA;AAC7B,EAAA,MAAM,OAAA,GAAU,MAAM,MAAA,CAAO,UAAA,EAAW;AAGxC,EAAA,MAAM,SAAA,GAAY,WAAA,CAAY,GAAA,CAAI,MAAA,CAAO,OAAO,CAAA;AAChD,EAAA,IAAI,SAAA,EAAW;AACb,IAAA,OAAA,CAAQ,gBAAgB,CAAA,GAAI,SAAA;AAAA,EAC9B;AAEA,EAAA,MAAM,IAAA,GAAO;AAAA,IACX,OAAA,EAAS,KAAA;AAAA,IACT,MAAA,EAAQ,YAAA;AAAA,IACR,MAAA,EAAQ;AAAA,MACN,IAAA,EAAM,QAAA;AAAA,MACN,SAAA,EAAW,QAAQ;AAAC,KACtB;AAAA,IACA,IAAI,MAAA;AAAO,GACb;AAEA,EAAA,MAAM,GAAA,GAAM,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,IAC3B,MAAA,EAAQ,MAAA;AAAA,IACR,OAAA,EAAS;AAAA,MACP,GAAG,OAAA;AAAA,MACH,cAAA,EAAgB,kBAAA;AAAA,MAChB,MAAA,EAAQ;AAAA,KACV;AAAA,IACA,IAAA,EAAM,IAAA,CAAK,SAAA,CAAU,IAAI;AAAA,GAC1B,CAAA;AAGD,EAAA,MAAM,YAAA,GAAe,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,gBAAgB,CAAA;AACrD,EAAA,IAAI,YAAA,EAAc;AAChB,IAAA,WAAA,CAAY,GAAA,CAAI,MAAA,CAAO,OAAA,EAAS,YAAY,CAAA;AAAA,EAC9C;AAGA,EAAA,MAAM,WAAA,GAAc,GAAA,CAAI,OAAA,CAAQ,GAAA,CAAI,cAAc,CAAA,IAAK,EAAA;AACvD,EAAA,IAAI,WAAA,CAAY,QAAA,CAAS,mBAAmB,CAAA,EAAG;AAC7C,IAAA,OAAO,gBAAA,CAA0B,KAAK,QAAQ,CAAA;AAAA,EAChD;AAGA,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,EAAA,OAAO,oBAAA,CAA8B,IAAA,EAAM,GAAA,CAAI,MAAA,EAAQ,QAAQ,CAAA;AACjE;AAIA,SAAS,oBAAA,CACP,IAAA,EACA,UAAA,EACA,QAAA,EACG;AACH,EAAA,IAAI,IAAA;AACJ,EAAA,IAAI;AACF,IAAA,IAAA,GAAO,IAAA,CAAK,MAAM,IAAI,CAAA;AAAA,EACxB,CAAA,CAAA,MAAQ;AACN,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,OAAA,EAAS,uCAAuC,QAAQ,CAAA,EAAA,EAAK,KAAK,KAAA,CAAM,CAAA,EAAG,GAAG,CAAC,CAAA,CAAA;AAAA,MAC/E,IAAA,EAAM,aAAA;AAAA,MACN,UAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAGA,EAAA,IAAI,KAAK,KAAA,EAAO;AACd,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,OAAA,EAAS,IAAA,CAAK,KAAA,CAAM,OAAA,IAAW,gBAAA;AAAA,MAC/B,IAAA,EAAM,IAAA,CAAK,KAAA,CAAM,IAAA,EAAM,UAAS,IAAK,WAAA;AAAA,MACrC,UAAA;AAAA,MACA,IAAA,EAAM,QAAA;AAAA,MACN,IAAA,EAAM,KAAK,KAAA,CAAM;AAAA,KAClB,CAAA;AAAA,EACH;AAGA,EAAA,OAAO,gBAAA,CAAoB,IAAA,CAAK,MAAA,EAAQ,QAAA,EAAU,UAAU,CAAA;AAC9D;AAEA,eAAe,gBAAA,CACb,KACA,QAAA,EACY;AACZ,EAAA,MAAM,IAAA,GAAO,MAAM,GAAA,CAAI,IAAA,EAAK;AAC5B,EAAA,MAAM,KAAA,GAAQ,IAAA,CAAK,KAAA,CAAM,IAAI,CAAA;AAG7B,EAAA,IAAI,QAAA,GAA0B,IAAA;AAC9B,EAAA,KAAA,MAAW,QAAQ,KAAA,EAAO;AACxB,IAAA,IAAI,IAAA,CAAK,UAAA,CAAW,OAAO,CAAA,EAAG;AAC5B,MAAA,QAAA,GAAW,IAAA,CAAK,KAAA,CAAM,CAAC,CAAA,CAAE,IAAA,EAAK;AAAA,IAChC;AAAA,EACF;AAEA,EAAA,IAAI,CAAC,QAAA,EAAU;AACb,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,OAAA,EAAS,oCAAoC,QAAQ,CAAA,CAAA;AAAA,MACrD,IAAA,EAAM,gBAAA;AAAA,MACN,YAAY,GAAA,CAAI,MAAA;AAAA,MAChB,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAEA,EAAA,OAAO,oBAAA,CAAwB,QAAA,EAAU,GAAA,CAAI,MAAA,EAAQ,QAAQ,CAAA;AAC/D;AAEA,SAAS,gBAAA,CACP,MAAA,EACA,QAAA,EACA,UAAA,EACG;AACH,EAAA,IAAI,CAAC,MAAA,EAAQ;AACX,IAAA,MAAM,IAAI,aAAA,CAAc;AAAA,MACtB,OAAA,EAAS,2BAA2B,QAAQ,CAAA,CAAA;AAAA,MAC5C,IAAA,EAAM,cAAA;AAAA,MACN,UAAA;AAAA,MACA,IAAA,EAAM;AAAA,KACP,CAAA;AAAA,EACH;AAGA,EAAA,MAAM,UAAU,MAAA,CAAO,OAAA;AACvB,EAAA,IAAI,KAAA,CAAM,OAAA,CAAQ,OAAO,CAAA,EAAG;AAE1B,IAAA,MAAM,YAAY,OAAA,CAAQ,IAAA,CAAK,CAAC,CAAA,KAAW,CAAA,CAAE,SAAS,MAAM,CAAA;AAC5D,IAAA,IAAI,WAAW,IAAA,EAAM;AAEnB,MAAA,IAAI,OAAO,OAAA,EAAS;AAClB,QAAA,MAAM,IAAI,aAAA,CAAc;AAAA,UACtB,SAAS,SAAA,CAAU,IAAA;AAAA,UACnB,IAAA,EAAM,gBAAA;AAAA,UACN,UAAA;AAAA,UACA,IAAA,EAAM;AAAA,SACP,CAAA;AAAA,MACH;AAGA,MAAA,IAAI;AACF,QAAA,OAAO,IAAA,CAAK,KAAA,CAAM,SAAA,CAAU,IAAI,CAAA;AAAA,MAClC,CAAA,CAAA,MAAQ;AAEN,QAAA,OAAO,SAAA,CAAU,IAAA;AAAA,MACnB;AAAA,IACF;AAAA,EACF;AAGA,EAAA,OAAO,MAAA;AACT;AAOO,SAAS,wBAAA,CACd,SACA,UAAA,EACiB;AACjB,EAAA,OAAO;AAAA,IACL,OAAA,EAAS,OAAA,CAAQ,OAAA,CAAQ,KAAA,EAAO,EAAE,CAAA;AAAA,IAClC;AAAA,GACF;AACF","file":"chunk-4SU7SU7K.js","sourcesContent":["/**\n * @goodz-core/sdk — HTTP Transport Layer\n *\n * Speaks the tRPC v11 HTTP wire protocol directly using fetch.\n * Handles superjson serialization, batching, and error parsing.\n *\n * Wire format reference:\n * - Queries:   GET  /api/trpc/{procedure}?input={superjson-encoded}\n * - Mutations: POST /api/trpc/{procedure}  body: {superjson-encoded}\n * - Batch:     GET  /api/trpc/{p1},{p2}?input={0: ..., 1: ...}\n *\n * @internal\n */\n\nimport superjson from \"superjson\";\nimport type { GoodZApiFieldError } from \"./types\";\n\n// ─── Error class ─────────────────────────────────────────────\n\nexport class GoodZApiError extends Error {\n  public readonly code: string;\n  public readonly httpStatus: number;\n  public readonly path: string;\n  public readonly zodErrors?: GoodZApiFieldError[];\n  public readonly data?: unknown;\n\n  constructor(opts: {\n    message: string;\n    code: string;\n    httpStatus: number;\n    path: string;\n    zodErrors?: GoodZApiFieldError[];\n    data?: unknown;\n  }) {\n    super(opts.message);\n    this.name = \"GoodZApiError\";\n    this.code = opts.code;\n    this.httpStatus = opts.httpStatus;\n    this.path = opts.path;\n    this.zodErrors = opts.zodErrors;\n    this.data = opts.data;\n  }\n\n  /** Human-readable summary including field errors if present. */\n  toDetailedString(): string {\n    const parts = [\n      `[GoodZApiError] ${this.code} on ${this.path}: ${this.message}`,\n    ];\n    if (this.zodErrors?.length) {\n      parts.push(\"Field errors:\");\n      for (const e of this.zodErrors) {\n        parts.push(`  - ${e.path.join(\".\")}: ${e.message} (${e.code})`);\n      }\n    }\n    return parts.join(\"\\n\");\n  }\n}\n\n// ─── Transport config ────────────────────────────────────────\n\nexport interface TransportConfig {\n  baseUrl: string;\n  getHeaders: () => Record<string, string> | Promise<Record<string, string>>;\n}\n\n// ─── Core transport functions ────────────────────────────────\n\n/**\n * Call a tRPC query (GET request).\n * Uses POST with method override for compatibility with Commerce/Exchange\n * server-to-server patterns (some proxies strip GET bodies).\n */\nexport async function callQuery<TInput, TOutput>(\n  config: TransportConfig,\n  path: string,\n  input?: TInput,\n): Promise<TOutput> {\n  const url = `${config.baseUrl}/api/trpc/${path}`;\n  const headers = await config.getHeaders();\n\n  // Use GET with query params for queries (standard tRPC)\n  const serialized = input !== undefined ? superjson.serialize(input) : undefined;\n  const queryUrl = serialized\n    ? `${url}?input=${encodeURIComponent(JSON.stringify(serialized))}`\n    : url;\n\n  const res = await fetch(queryUrl, {\n    method: \"GET\",\n    headers: {\n      ...headers,\n      \"Content-Type\": \"application/json\",\n    },\n  });\n\n  return parseResponse<TOutput>(res, path);\n}\n\n/**\n * Call a tRPC mutation (POST request).\n */\nexport async function callMutation<TInput, TOutput>(\n  config: TransportConfig,\n  path: string,\n  input?: TInput,\n): Promise<TOutput> {\n  const url = `${config.baseUrl}/api/trpc/${path}`;\n  const headers = await config.getHeaders();\n\n  const serialized = input !== undefined ? superjson.serialize(input) : undefined;\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      ...headers,\n      \"Content-Type\": \"application/json\",\n    },\n    body: serialized ? JSON.stringify(serialized) : undefined,\n  });\n\n  return parseResponse<TOutput>(res, path);\n}\n\n// ─── Response parser ─────────────────────────────────────────\n\nasync function parseResponse<T>(res: Response, path: string): Promise<T> {\n  const text = await res.text();\n  let body: any;\n\n  try {\n    body = JSON.parse(text);\n  } catch {\n    throw new GoodZApiError({\n      message: `Invalid JSON response: ${text.slice(0, 200)}`,\n      code: \"PARSE_ERROR\",\n      httpStatus: res.status,\n      path,\n    });\n  }\n\n  // tRPC wraps responses in { result: { data: ... } }\n  // Batch responses are arrays: [{ result: { data: ... } }]\n  const envelope = Array.isArray(body) ? body[0] : body;\n\n  // Check for tRPC error envelope\n  if (envelope?.error) {\n    const err = envelope.error;\n    const errJson = err?.json ?? err;\n    const errData = errJson?.data ?? {};\n\n    throw new GoodZApiError({\n      message: errJson?.message ?? \"Unknown API error\",\n      code: errData?.code ?? errJson?.code ?? \"UNKNOWN\",\n      httpStatus: errData?.httpStatus ?? res.status,\n      path: errData?.path ?? path,\n      zodErrors: errData?.zodError?.issues,\n      data: errData,\n    });\n  }\n\n  // Success path: extract and deserialize the data\n  const resultData = envelope?.result?.data;\n  if (resultData === undefined) {\n    // Some queries return null/undefined legitimately\n    if (res.ok) return undefined as T;\n\n    throw new GoodZApiError({\n      message: `Unexpected response shape from ${path}`,\n      code: \"UNEXPECTED_RESPONSE\",\n      httpStatus: res.status,\n      path,\n    });\n  }\n\n  // superjson wraps data in { json: ..., meta?: ... }\n  // Check if it's a superjson envelope\n  if (resultData && typeof resultData === \"object\" && \"json\" in resultData) {\n    return superjson.deserialize(resultData) as T;\n  }\n\n  // Plain JSON (shouldn't happen with superjson transformer, but be safe)\n  return resultData as T;\n}\n","/**\n * @goodz-core/sdk — MCP Transport Layer\n *\n * Speaks the MCP (Model Context Protocol) JSON-RPC 2.0 wire format\n * used by Commerce, Exchange, and Alive sub-sites.\n *\n * Wire format:\n *   POST /api/mcp\n *   Content-Type: application/json\n *   Authorization: Bearer <token>\n *\n *   { \"jsonrpc\": \"2.0\", \"method\": \"tools/call\", \"params\": { \"name\": \"<tool>\", \"arguments\": { ... } }, \"id\": 1 }\n *\n * Response:\n *   { \"jsonrpc\": \"2.0\", \"result\": { \"content\": [{ \"type\": \"text\", \"text\": \"<json>\" }] }, \"id\": 1 }\n *\n * @internal\n */\n\nimport { GoodZApiError } from \"./transport\";\nimport type { TransportConfig } from \"./transport\";\n\n// Re-export for convenience\nexport type { TransportConfig };\n\n// ─── MCP request counter ────────────────────────────────────\n\nlet _mcpRequestId = 0;\nfunction nextId(): number {\n  return ++_mcpRequestId;\n}\n\n// ─── Session management ─────────────────────────────────────\n\nconst _sessionIds = new Map<string, string>();\n\n// ─── Core MCP call function ─────────────────────────────────\n\n/**\n * Call an MCP tool on a sub-site.\n *\n * Handles:\n * - JSON-RPC 2.0 envelope construction\n * - Session ID management (mcp-session-id header)\n * - Response parsing (extracts JSON from text content)\n * - Error mapping to GoodZApiError\n */\nexport async function callMcpTool<TInput extends Record<string, any>, TOutput>(\n  config: TransportConfig,\n  toolName: string,\n  args?: TInput,\n): Promise<TOutput> {\n  const url = `${config.baseUrl}/api/mcp`;\n  const headers = await config.getHeaders();\n\n  // Add session ID if we have one for this endpoint\n  const sessionId = _sessionIds.get(config.baseUrl);\n  if (sessionId) {\n    headers[\"mcp-session-id\"] = sessionId;\n  }\n\n  const body = {\n    jsonrpc: \"2.0\" as const,\n    method: \"tools/call\",\n    params: {\n      name: toolName,\n      arguments: args ?? {},\n    },\n    id: nextId(),\n  };\n\n  const res = await fetch(url, {\n    method: \"POST\",\n    headers: {\n      ...headers,\n      \"Content-Type\": \"application/json\",\n      Accept: \"application/json, text/event-stream\",\n    },\n    body: JSON.stringify(body),\n  });\n\n  // Store session ID from response\n  const newSessionId = res.headers.get(\"mcp-session-id\");\n  if (newSessionId) {\n    _sessionIds.set(config.baseUrl, newSessionId);\n  }\n\n  // Handle SSE responses (some MCP servers use streaming)\n  const contentType = res.headers.get(\"content-type\") || \"\";\n  if (contentType.includes(\"text/event-stream\")) {\n    return parseSseResponse<TOutput>(res, toolName);\n  }\n\n  // Standard JSON response\n  const text = await res.text();\n  return parseJsonRpcResponse<TOutput>(text, res.status, toolName);\n}\n\n// ─── Response parsers ───────────────────────────────────────\n\nfunction parseJsonRpcResponse<T>(\n  text: string,\n  httpStatus: number,\n  toolName: string,\n): T {\n  let body: any;\n  try {\n    body = JSON.parse(text);\n  } catch {\n    throw new GoodZApiError({\n      message: `Invalid JSON response from MCP tool ${toolName}: ${text.slice(0, 200)}`,\n      code: \"PARSE_ERROR\",\n      httpStatus,\n      path: toolName,\n    });\n  }\n\n  // JSON-RPC error\n  if (body.error) {\n    throw new GoodZApiError({\n      message: body.error.message || \"MCP tool error\",\n      code: body.error.code?.toString() || \"MCP_ERROR\",\n      httpStatus,\n      path: toolName,\n      data: body.error.data,\n    });\n  }\n\n  // Extract result from MCP content array\n  return extractMcpResult<T>(body.result, toolName, httpStatus);\n}\n\nasync function parseSseResponse<T>(\n  res: Response,\n  toolName: string,\n): Promise<T> {\n  const text = await res.text();\n  const lines = text.split(\"\\n\");\n\n  // Find the last \"data:\" line that contains a JSON-RPC response\n  let lastData: string | null = null;\n  for (const line of lines) {\n    if (line.startsWith(\"data:\")) {\n      lastData = line.slice(5).trim();\n    }\n  }\n\n  if (!lastData) {\n    throw new GoodZApiError({\n      message: `Empty SSE response from MCP tool ${toolName}`,\n      code: \"EMPTY_RESPONSE\",\n      httpStatus: res.status,\n      path: toolName,\n    });\n  }\n\n  return parseJsonRpcResponse<T>(lastData, res.status, toolName);\n}\n\nfunction extractMcpResult<T>(\n  result: any,\n  toolName: string,\n  httpStatus: number,\n): T {\n  if (!result) {\n    throw new GoodZApiError({\n      message: `No result from MCP tool ${toolName}`,\n      code: \"EMPTY_RESULT\",\n      httpStatus,\n      path: toolName,\n    });\n  }\n\n  // MCP tools return { content: [{ type: \"text\", text: \"...\" }] }\n  const content = result.content;\n  if (Array.isArray(content)) {\n    // Find the first text content block\n    const textBlock = content.find((c: any) => c.type === \"text\");\n    if (textBlock?.text) {\n      // Check if the tool returned an error in the text\n      if (result.isError) {\n        throw new GoodZApiError({\n          message: textBlock.text,\n          code: \"MCP_TOOL_ERROR\",\n          httpStatus,\n          path: toolName,\n        });\n      }\n\n      // Try to parse as JSON\n      try {\n        return JSON.parse(textBlock.text) as T;\n      } catch {\n        // If not JSON, return the text as-is (some tools return plain text)\n        return textBlock.text as T;\n      }\n    }\n  }\n\n  // Fallback: return the result directly\n  return result as T;\n}\n\n// ─── MCP transport config builder ───────────────────────────\n\n/**\n * Create a TransportConfig for an MCP sub-site endpoint.\n */\nexport function createMcpTransportConfig(\n  baseUrl: string,\n  getHeaders: () => Record<string, string> | Promise<Record<string, string>>,\n): TransportConfig {\n  return {\n    baseUrl: baseUrl.replace(/\\/$/, \"\"),\n    getHeaders,\n  };\n}\n"]}

package/dist/chunk-EQUAL5M6.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/core/index.ts"],"names":[],"mappings":"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","file":"chunk-EQUAL5M6.js","sourcesContent":["/**\n * @goodz-core/sdk/core — Unified GoodZ API Client\n *\n * One client, all services. Stripe-style namespace architecture:\n *   goodz.zcoin.*       → Core settlement & Z-coin\n *   goodz.inventory.*   → Core instance management\n *   goodz.collectible.* → Core card queries\n *   goodz.user.*        → Core user profiles\n *   goodz.auth.*        → Core auth\n *   goodz.ip.*          → Core IP (franchise/series/card)\n *   goodz.commerce.*    → Commerce/Shops (MCP)\n *   goodz.exchange.*    → Exchange marketplace (MCP)\n *   goodz.alive.*       → Alive companions (MCP)\n *\n * Core uses tRPC HTTP wire protocol; sub-sites use MCP JSON-RPC 2.0.\n * The client handles routing transparently.\n *\n * @example\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk\";\n *\n * const goodz = createGoodZClient({\n *   accessToken: \"your-jwt-token\",\n * });\n *\n * // Core APIs\n * const balance = await goodz.zcoin.getMyBalance();\n * const result = await goodz.zcoin.commercialTransfer({ ... });\n *\n * // Commerce APIs\n * const shop = await goodz.commerce.createShop({ name: \"My Shop\" });\n * const order = await goodz.commerce.executePurchase({ campaignId: 1, quantity: 1 });\n *\n * // Exchange APIs\n * const listing = await goodz.exchange.createListing({ ... });\n * const data = await goodz.exchange.getMarketData({ coreGoodzId: 42 });\n *\n * // Alive APIs\n * const chat = await goodz.alive.sendMessage({ instanceId: 1, userId: 1, message: \"Hello!\" });\n * const memories = await goodz.alive.recallMemories({ instanceId: 1, userId: 1, query: \"birthday\" });\n * ```\n *\n * @module\n */\n\nimport { callQuery, callMutation, GoodZApiError } from \"../transport\";\nimport type { TransportConfig } from \"../transport\";\nimport { createMcpTransportConfig } from \"../mcp-transport\";\nimport { createCommerceNamespace } from \"../commerce/index\";\nimport type { CommerceNamespace } from \"../commerce/index\";\nimport { createExchangeNamespace } from \"../exchange/index\";\nimport type { ExchangeNamespace } from \"../exchange/index\";\nimport { createAliveNamespace } from \"../alive/index\";\nimport type { AliveNamespace } from \"../alive/index\";\nimport type {\n  // zcoin\n  ZcoinGetMyBalanceOutput,\n  ZcoinGetMyHistoryInput,\n  ZcoinCommercialTransferInput,\n  ZcoinCommercialTransferOutput,\n  ZcoinMintAndChargeInput,\n  ZcoinMintAndChargeOutput,\n  ZcoinChargeUserInput,\n  ZcoinChargeUserOutput,\n  ZcoinCreateDirectPurchaseOrderInput,\n  ZcoinCreateDirectPurchaseOrderOutput,\n  ZcoinGetDepositPackagesInput,\n  ZcoinDepositPackage,\n  ZcoinCreateDepositOrderInput,\n  ZcoinCreateDepositOrderOutput,\n  ZcoinGetDepositStatusInput,\n  ZcoinGetDepositStatusOutput,\n  ZcoinGetDepositUrlInput,\n  ZcoinGetDepositUrlOutput,\n  // inventory\n  InventoryGetUserInventoryInput,\n  InventoryItem,\n  InventoryConfirmOwnershipInput,\n  InventoryConfirmOwnershipOutput,\n  InventoryMintInput,\n  InventoryMintOutput,\n  InventoryTransferInput,\n  InventoryTransferOutput,\n  InventoryTransferByCardInput,\n  InventoryTransferByCardOutput,\n  InventoryGrantMintAuthInput,\n  InventoryTransferHistoryInput,\n  // collectible\n  CollectibleGetInstanceByIdInput,\n  CollectibleGetPublicInstanceInput,\n  CollectibleGetPublicInstancesBatchInput,\n  CollectibleGetCardProfileInput,\n  CollectibleGetShellImageUrlInput,\n  // user\n  UserGetPublicProfileInput,\n  UserPublicProfile,\n  UserGetPublicProfileByIdInput,\n  // auth\n  AuthGetOAuthAppInfoInput,\n  AuthOAuthAppInfo,\n  AuthUser,\n  // ip\n  FranchiseGetInput,\n  SeriesGetInput,\n  SeriesListByFranchiseInput,\n  CardGetInput,\n  CardListBySeriesInput,\n} from \"../types\";\n\n// ─── Re-export types and error class ─────────────────────────\n\nexport { GoodZApiError } from \"../transport\";\nexport type * from \"../types\";\nexport type * from \"../types-commerce\";\nexport type * from \"../types-exchange\";\nexport type * from \"../types-alive\";\nexport type { CommerceNamespace } from \"../commerce/index\";\nexport type { ExchangeNamespace } from \"../exchange/index\";\nexport type { AliveNamespace } from \"../alive/index\";\n\n// ─── Default sub-site URLs ──────────────────────────────────\n\nconst DEFAULT_CORE_URL = \"https://goodzcore.manus.space\";\nconst DEFAULT_COMMERCE_URL = \"https://goodzcommerce.manus.space\";\nconst DEFAULT_EXCHANGE_URL = \"https://goodzexchange.manus.space\";\nconst DEFAULT_ALIVE_URL = \"https://goodzalive.manus.space\";\n\n// ─── Client config ───────────────────────────────────────────\n\nexport interface GoodZClientConfig {\n  /**\n   * GoodZ.Core base URL.\n   * @default \"https://goodzcore.manus.space\"\n   */\n  coreUrl?: string;\n\n  /**\n   * GoodZ.Commerce (Shops) base URL.\n   * @default \"https://goodzcommerce.manus.space\"\n   */\n  commerceUrl?: string;\n\n  /**\n   * GoodZ.Exchange base URL.\n   * @default \"https://goodzexchange.manus.space\"\n   */\n  exchangeUrl?: string;\n\n  /**\n   * GoodZ.Alive base URL.\n   * @default \"https://goodzalive.manus.space\"\n   */\n  aliveUrl?: string;\n\n  /**\n   * Static access token (JWT) for authentication.\n   * For server-to-server calls, obtain this via OAuth client_credentials flow.\n   * For user-context calls, pass the user's access token.\n   */\n  accessToken?: string;\n\n  /**\n   * Dynamic token provider — called before every request.\n   * Use this when tokens may rotate (e.g., auto-refresh).\n   * Takes precedence over `accessToken` if both are set.\n   */\n  getAccessToken?: () => string | Promise<string>;\n\n  /**\n   * Custom headers to include in every request.\n   * Useful for passing app identifiers or tracing headers.\n   */\n  headers?: Record<string, string>;\n}\n\n// ─── Core namespace interfaces (tRPC) ───────────────────────\n\nexport interface ZcoinNamespace {\n  /** Get the authenticated user's Z-coin balance. */\n  getMyBalance(): Promise<ZcoinGetMyBalanceOutput>;\n\n  /** Get the authenticated user's Z-coin transaction history. */\n  getMyHistory(input?: ZcoinGetMyHistoryInput): Promise<any[]>;\n\n  /** Get available Z-coin deposit packages with pricing. */\n  getDepositPackages(input?: ZcoinGetDepositPackagesInput): Promise<ZcoinDepositPackage[]>;\n\n  /** Create a Stripe checkout session for Z-coin deposit. */\n  createDepositOrder(input: ZcoinCreateDepositOrderInput): Promise<ZcoinCreateDepositOrderOutput>;\n\n  /** Check the status of a deposit checkout session. */\n  getDepositStatus(input: ZcoinGetDepositStatusInput): Promise<ZcoinGetDepositStatusOutput>;\n\n  /**\n   * Generate a deposit deep link URL for Z-coin top-up.\n   * Returns a URL that redirects users to Core's deposit page.\n   * After completing the deposit, the user is redirected back to returnUrl.\n   *\n   * No authentication required — anyone can generate a deposit URL.\n   *\n   * @example\n   * ```ts\n   * const { url } = await goodz.zcoin.getDepositUrl({\n   *   amount: 100,\n   *   returnUrl: \"https://myapp.com/shop\",\n   *   appId: \"od_myapp\",\n   * });\n   * window.open(url, \"_blank\");\n   * ```\n   */\n  getDepositUrl(input?: ZcoinGetDepositUrlInput): Promise<ZcoinGetDepositUrlOutput>;\n\n  /**\n   * Atomic commercial transfer: Z-coin payment + ownership transfer in one transaction.\n   * This is the primary API for Commerce and Exchange purchase flows.\n   *\n   * Idempotent via referenceId — duplicate calls return the same result.\n   *\n   * @throws {GoodZApiError} BAD_REQUEST — insufficient balance\n   * @throws {GoodZApiError} CONFLICT — version conflict (retry)\n   * @throws {GoodZApiError} FORBIDDEN — seller doesn't own instance\n   */\n  commercialTransfer(input: ZcoinCommercialTransferInput): Promise<ZcoinCommercialTransferOutput>;\n\n  /**\n   * Mint a new card instance and charge the buyer in one atomic transaction.\n   * Used by Commerce for gacha and direct-from-creator purchases.\n   *\n   * Requires mint authorization (granted via inventory.grantMintAuth).\n   * Idempotent via referenceId.\n   *\n   * @throws {GoodZApiError} FORBIDDEN — no mint authorization\n   * @throws {GoodZApiError} BAD_REQUEST — insufficient balance\n   */\n  mintAndCharge(input: ZcoinMintAndChargeInput): Promise<ZcoinMintAndChargeOutput>;\n\n  /**\n   * Charge a user's Z-coin balance for an in-app purchase.\n   * Used by apps that sell non-GoodZ digital goods/services.\n   *\n   * Idempotent via appOrderId.\n   *\n   * @throws {GoodZApiError} BAD_REQUEST — insufficient balance\n   * @throws {GoodZApiError} CONFLICT — version conflict\n   */\n  chargeUser(input: ZcoinChargeUserInput): Promise<ZcoinChargeUserOutput>;\n\n  /**\n   * Create a direct purchase checkout session (fiat → Z-coin → transfer).\n   * Transparent intermediation: user sees fiat price, Core handles conversion.\n   */\n  createDirectPurchaseOrder(input: ZcoinCreateDirectPurchaseOrderInput): Promise<ZcoinCreateDirectPurchaseOrderOutput>;\n}\n\nexport interface InventoryNamespace {\n  /** Get a user's inventory (owned card instances). */\n  getUserInventory(input: InventoryGetUserInventoryInput): Promise<InventoryItem[]>;\n\n  /** Check if a user owns at least one instance of a specific card. */\n  confirmOwnership(input: InventoryConfirmOwnershipInput): Promise<InventoryConfirmOwnershipOutput>;\n\n  /**\n   * Mint new card instances. Requires franchise ownership or admin role.\n   * For Commerce/Exchange, use zcoin.mintAndCharge instead (includes payment).\n   */\n  mint(input: InventoryMintInput): Promise<InventoryMintOutput>;\n\n  /**\n   * Transfer a specific card instance to another user.\n   * For commercial transfers, use zcoin.commercialTransfer instead.\n   *\n   * @deprecated for reason=\"purchase\"|\"trade\" — use commercialTransfer\n   */\n  transfer(input: InventoryTransferInput): Promise<InventoryTransferOutput>;\n\n  /**\n   * Transfer card instances by cardId (transfers oldest instances).\n   * For commercial transfers, use zcoin.commercialTransfer instead.\n   *\n   * @deprecated for reason=\"purchase\"|\"trade\" — use commercialTransfer\n   */\n  transferByCard(input: InventoryTransferByCardInput): Promise<InventoryTransferByCardOutput>;\n\n  /**\n   * Grant mint authorization to another user/app for a specific card.\n   * Required before Commerce can call zcoin.mintAndCharge for that card.\n   */\n  grantMintAuth(input: InventoryGrantMintAuthInput): Promise<any>;\n\n  /** Get transfer/ownership history for an instance, card, or user. */\n  transferHistory(input: InventoryTransferHistoryInput): Promise<any[]>;\n}\n\nexport interface CollectibleNamespace {\n  /** Get a card instance by its numeric ID. Returns full instance data with card chain. */\n  getInstanceById(input: CollectibleGetInstanceByIdInput): Promise<any>;\n\n  /** Get a card instance by its instance code (public-facing identifier). */\n  getPublicInstance(input: CollectibleGetPublicInstanceInput): Promise<any>;\n\n  /** Batch-fetch multiple card instances by their IDs (max 100). */\n  getPublicInstancesBatch(input: CollectibleGetPublicInstancesBatchInput): Promise<any[]>;\n\n  /** Get the card profile (metadata, rarity, series info). */\n  getCardProfile(input: CollectibleGetCardProfileInput): Promise<any>;\n\n  /** Get the shell (packaging) image URL for a card. */\n  getShellImageUrl(input: CollectibleGetShellImageUrlInput): Promise<any>;\n}\n\nexport interface UserNamespace {\n  /** Get a user's public profile by openId. */\n  getPublicProfile(input: UserGetPublicProfileInput): Promise<UserPublicProfile>;\n\n  /** Get a user's public profile by internal userId. */\n  getPublicProfileById(input: UserGetPublicProfileByIdInput): Promise<UserPublicProfile>;\n}\n\nexport interface AuthNamespace {\n  /** Get the authenticated user's profile. Returns null if not authenticated. */\n  me(): Promise<AuthUser | null>;\n\n  /** Get public info about an OAuth app by its client ID. */\n  getOAuthAppInfo(input: AuthGetOAuthAppInfoInput): Promise<AuthOAuthAppInfo | null>;\n}\n\nexport interface IpNamespace {\n  /** Get a franchise by ID or slug. */\n  getFranchise(input: FranchiseGetInput): Promise<any>;\n\n  /** Get a series by ID or slug. */\n  getSeries(input: SeriesGetInput): Promise<any>;\n\n  /** List all series in a franchise. */\n  listSeriesByFranchise(input: SeriesListByFranchiseInput): Promise<any[]>;\n\n  /** Get a card by ID. */\n  getCard(input: CardGetInput): Promise<any>;\n\n  /** List all cards in a series. */\n  listCardsBySeries(input: CardListBySeriesInput): Promise<any[]>;\n}\n\n// ─── GoodZClient type ────────────────────────────────────────\n\nexport interface GoodZClient {\n  // ── Core namespaces (tRPC) ──\n  readonly zcoin: ZcoinNamespace;\n  readonly inventory: InventoryNamespace;\n  readonly collectible: CollectibleNamespace;\n  readonly user: UserNamespace;\n  readonly auth: AuthNamespace;\n  readonly ip: IpNamespace;\n\n  // ── Sub-site namespaces (MCP) ──\n  readonly commerce: CommerceNamespace;\n  readonly exchange: ExchangeNamespace;\n  readonly alive: AliveNamespace;\n\n  /**\n   * Make a raw tRPC query call to Core. Use this for routes not yet covered\n   * by the typed namespaces.\n   */\n  rawQuery<T = any>(path: string, input?: any): Promise<T>;\n\n  /**\n   * Make a raw tRPC mutation call to Core. Use this for routes not yet covered\n   * by the typed namespaces.\n   */\n  rawMutation<T = any>(path: string, input?: any): Promise<T>;\n}\n\n// ─── Client factory ──────────────────────────────────────────\n\n/**\n * Create a unified GoodZ API client — one client for all services.\n *\n * @example Server-to-server with static token\n * ```ts\n * const goodz = createGoodZClient({\n *   accessToken: process.env.CORE_ACCESS_TOKEN,\n * });\n *\n * // Core\n * const balance = await goodz.zcoin.getMyBalance();\n *\n * // Commerce\n * const shop = await goodz.commerce.createShop({ name: \"My Shop\" });\n *\n * // Exchange\n * const listings = await goodz.exchange.browseMarketplace();\n *\n * // Alive\n * const chat = await goodz.alive.sendMessage({ instanceId: 1, userId: 1, message: \"Hi!\" });\n * ```\n *\n * @example With dynamic token provider (auto-refresh)\n * ```ts\n * const goodz = createGoodZClient({\n *   getAccessToken: async () => {\n *     const token = await refreshTokenIfNeeded();\n *     return token;\n *   },\n * });\n * ```\n *\n * @example Custom sub-site URLs (e.g., staging environment)\n * ```ts\n * const goodz = createGoodZClient({\n *   accessToken: \"...\",\n *   coreUrl: \"https://staging-core.goodz.dev\",\n *   commerceUrl: \"https://staging-commerce.goodz.dev\",\n *   exchangeUrl: \"https://staging-exchange.goodz.dev\",\n *   aliveUrl: \"https://staging-alive.goodz.dev\",\n * });\n * ```\n */\nexport function createGoodZClient(config: GoodZClientConfig = {}): GoodZClient {\n  const {\n    coreUrl = DEFAULT_CORE_URL,\n    commerceUrl = DEFAULT_COMMERCE_URL,\n    exchangeUrl = DEFAULT_EXCHANGE_URL,\n    aliveUrl = DEFAULT_ALIVE_URL,\n    accessToken,\n    getAccessToken,\n    headers: customHeaders,\n  } = config;\n\n  // Shared header builder — used by both tRPC and MCP transports\n  const buildHeaders = async (): Promise<Record<string, string>> => {\n    const h: Record<string, string> = { ...customHeaders };\n    const token = getAccessToken ? await getAccessToken() : accessToken;\n    if (token) {\n      h[\"Authorization\"] = `Bearer ${token}`;\n    }\n    return h;\n  };\n\n  // ── Core transport (tRPC) ──\n  const coreTransport: TransportConfig = {\n    baseUrl: coreUrl.replace(/\\/$/, \"\"),\n    getHeaders: buildHeaders,\n  };\n\n  // ── Sub-site transports (MCP) ──\n  const commerceTransport = createMcpTransportConfig(commerceUrl, buildHeaders);\n  const exchangeTransport = createMcpTransportConfig(exchangeUrl, buildHeaders);\n  const aliveTransport = createMcpTransportConfig(aliveUrl, buildHeaders);\n\n  // Helper shortcuts for Core tRPC\n  const q = <I, O>(path: string) => (input?: I) => callQuery<I, O>(coreTransport, path, input);\n  const m = <I, O>(path: string) => (input?: I) => callMutation<I, O>(coreTransport, path, input);\n\n  return {\n    // ── zcoin ──────────────────────────────────────────────\n    zcoin: {\n      getMyBalance: q<void, ZcoinGetMyBalanceOutput>(\"zcoin.getMyBalance\"),\n      getMyHistory: q<ZcoinGetMyHistoryInput, any[]>(\"zcoin.getMyHistory\"),\n      getDepositPackages: q<ZcoinGetDepositPackagesInput, ZcoinDepositPackage[]>(\"zcoin.getDepositPackages\"),\n      createDepositOrder: m<ZcoinCreateDepositOrderInput, ZcoinCreateDepositOrderOutput>(\"zcoin.createDepositOrder\"),\n      getDepositStatus: q<ZcoinGetDepositStatusInput, ZcoinGetDepositStatusOutput>(\"zcoin.getDepositStatus\"),\n      getDepositUrl: q<ZcoinGetDepositUrlInput, ZcoinGetDepositUrlOutput>(\"zcoin.getDepositUrl\"),\n      commercialTransfer: m<ZcoinCommercialTransferInput, ZcoinCommercialTransferOutput>(\"zcoin.commercialTransfer\"),\n      mintAndCharge: m<ZcoinMintAndChargeInput, ZcoinMintAndChargeOutput>(\"zcoin.mintAndCharge\"),\n      chargeUser: m<ZcoinChargeUserInput, ZcoinChargeUserOutput>(\"zcoin.chargeUser\"),\n      createDirectPurchaseOrder: m<ZcoinCreateDirectPurchaseOrderInput, ZcoinCreateDirectPurchaseOrderOutput>(\"zcoin.createDirectPurchaseOrder\"),\n    },\n\n    // ── inventory ──────────────────────────────────────────\n    inventory: {\n      getUserInventory: q<InventoryGetUserInventoryInput, InventoryItem[]>(\"inventory.getUserInventory\"),\n      confirmOwnership: q<InventoryConfirmOwnershipInput, InventoryConfirmOwnershipOutput>(\"inventory.confirmOwnership\"),\n      mint: m<InventoryMintInput, InventoryMintOutput>(\"inventory.mint\"),\n      transfer: m<InventoryTransferInput, InventoryTransferOutput>(\"inventory.transfer\"),\n      transferByCard: m<InventoryTransferByCardInput, InventoryTransferByCardOutput>(\"inventory.transferByCard\"),\n      grantMintAuth: m<InventoryGrantMintAuthInput, any>(\"inventory.grantMintAuth\"),\n      transferHistory: q<InventoryTransferHistoryInput, any[]>(\"inventory.transferHistory\"),\n    },\n\n    // ── collectible ────────────────────────────────────────\n    collectible: {\n      getInstanceById: q<CollectibleGetInstanceByIdInput, any>(\"collectible.getInstanceById\"),\n      getPublicInstance: q<CollectibleGetPublicInstanceInput, any>(\"collectible.getPublicInstance\"),\n      getPublicInstancesBatch: q<CollectibleGetPublicInstancesBatchInput, any[]>(\"collectible.getPublicInstancesBatch\"),\n      getCardProfile: q<CollectibleGetCardProfileInput, any>(\"collectible.getCardProfile\"),\n      getShellImageUrl: q<CollectibleGetShellImageUrlInput, any>(\"collectible.getShellImageUrl\"),\n    },\n\n    // ── user ───────────────────────────────────────────────\n    user: {\n      getPublicProfile: q<UserGetPublicProfileInput, UserPublicProfile>(\"user.getPublicProfile\"),\n      getPublicProfileById: q<UserGetPublicProfileByIdInput, UserPublicProfile>(\"user.getPublicProfileById\"),\n    },\n\n    // ── auth ───────────────────────────────────────────────\n    auth: {\n      me: q<void, AuthUser | null>(\"auth.me\"),\n      getOAuthAppInfo: q<AuthGetOAuthAppInfoInput, AuthOAuthAppInfo | null>(\"auth.getOAuthAppInfo\"),\n    },\n\n    // ── ip (franchise/series/card) ─────────────────────────\n    ip: {\n      getFranchise: q<FranchiseGetInput, any>(\"franchise.get\"),\n      getSeries: q<SeriesGetInput, any>(\"series.get\"),\n      listSeriesByFranchise: q<SeriesListByFranchiseInput, any[]>(\"series.listByFranchise\"),\n      getCard: q<CardGetInput, any>(\"card.get\"),\n      listCardsBySeries: q<CardListBySeriesInput, any[]>(\"card.listBySeries\"),\n    },\n\n    // ── commerce (MCP) ─────────────────────────────────────\n    commerce: createCommerceNamespace(commerceTransport),\n\n    // ── exchange (MCP) ─────────────────────────────────────\n    exchange: createExchangeNamespace(exchangeTransport),\n\n    // ── alive (MCP) ────────────────────────────────────────\n    alive: createAliveNamespace(aliveTransport),\n\n    // ── raw escape hatches (Core tRPC only) ────────────────\n    rawQuery: <T = any>(path: string, input?: any) => callQuery<any, T>(coreTransport, path, input),\n    rawMutation: <T = any>(path: string, input?: any) => callMutation<any, T>(coreTransport, path, input),\n  };\n}\n\n/**\n * Alias for createGoodZClient — creates a client acting on behalf of a user.\n * Semantically identical, but makes the intent clearer in server-to-server code.\n */\nexport const createUserClient = createGoodZClient;\n"]}