@goodz-core/sdk 0.2.0 → 0.3.1

package/dist/transport-BOlScYEv.d.ts

@@ -0,0 +1,377 @@
+/**
+ * @goodz-core/sdk — Public API Type Definitions
+ *
+ * Hand-crafted types mirroring GoodZ.Core's tRPC API surface.
+ * These are the source of truth for SDK consumers — they define
+ * the contract between apps and Core.
+ *
+ * Naming convention:
+ *   Input types:  {Namespace}{Method}Input
+ *   Output types: {Namespace}{Method}Output
+ *
+ * @module
+ */
+type SaleType = "direct" | "wholesale" | "retail_resale" | "gacha" | "trade";
+type TransferReason = "purchase" | "gift" | "trade" | "admin_transfer";
+type PurchaseChannel = "web" | "ios" | "android";
+type ZcoinTxType = "DEPOSIT" | "PURCHASE" | "APP_PAYMENT" | "DIRECT_PURCHASE" | "REFUND" | "ADJUSTMENT" | "EXPIRY";
+interface ZcoinGetMyBalanceOutput {
+    balance: number;
+    totalDeposited: number;
+    totalSpent: number;
+    version: number;
+}
+interface ZcoinGetMyHistoryInput {
+    limit?: number;
+    offset?: number;
+    txType?: ZcoinTxType;
+}
+interface ZcoinCommercialTransferInput {
+    /** ID of the card_instance to transfer */
+    instanceId: number;
+    /** Buyer's userId — will be debited Z-coin */
+    buyerUserId: number;
+    /** Seller's userId — must be current owner of the instance */
+    sellerUserId: number;
+    /** Transaction price in Z-coin hundredths (e.g. 1050 = 10.50 Z-coin) */
+    priceZcoin: number;
+    /** Type of sale — determines fee rules */
+    saleType: SaleType;
+    /** Idempotency key (e.g., Commerce order ID, Exchange trade ID) */
+    referenceId: string;
+    /** OAuth APP client ID of the calling application */
+    appClientId: string;
+    /** Human-readable description of the transaction */
+    description?: string;
+    /** Optional listing ID (for Exchange trades) */
+    listingId?: number;
+}
+interface ZcoinCommercialTransferOutput {
+    success: true;
+    tradeId: number;
+    zcoinTxId: number;
+    ownershipEventId: number;
+    platformFee: number;
+    sellerProceeds: number;
+    primarySaleFeeApplied: boolean;
+    primarySaleFeeMarked: boolean;
+}
+interface ZcoinMintAndChargeInput {
+    /** The card to mint (probability result from Commerce) */
+    cardId: number;
+    /** The buyer's user ID (will be debited Z-coin and receive the new instance) */
+    buyerUserId: number;
+    /** Price per unit in Z-coin hundredths (e.g. 1050 = 10.50 Z-coin) */
+    priceZcoin: number;
+    /** Type of sale */
+    saleType?: "gacha" | "direct";
+    /** Idempotency key (e.g., Commerce order ID) */
+    referenceId: string;
+    /** OAuth APP client ID of the calling application */
+    appClientId: string;
+    /** Human-readable description */
+    description?: string;
+    /** Number of instances to mint (default 1, max 10 for batch gacha) */
+    quantity?: number;
+}
+interface ZcoinMintAndChargeOutput {
+    success: boolean;
+    tradeId: number;
+    zcoinTxId: number;
+    platformFee: number;
+    sellerProceeds: number;
+    authorizationId: number;
+    remainingMints: number | null;
+    instances: Array<{
+        id: number;
+        instanceCode: string;
+        shortCode: string;
+    }>;
+}
+interface ZcoinChargeUserInput {
+    /** Z-coin amount to charge (in hundredths, e.g. 1050 = 10.50 Z-coin) */
+    amount: number;
+    /** OAuth app client ID making the charge */
+    appClientId: string;
+    /** Unique order/reference ID from the APP (for idempotency) */
+    appOrderId: string;
+    /** Human-readable description of what the user is paying for */
+    description: string;
+}
+interface ZcoinChargeUserOutput {
+    success: boolean;
+    transactionId: number;
+    amountCharged: number;
+    platformFee: number;
+    developerProceeds: number;
+    balanceAfter: number;
+    referenceId: string;
+}
+interface ZcoinCreateDirectPurchaseOrderInput {
+    /** The card instance to purchase */
+    instanceId: number;
+    /** The seller's user ID */
+    sellerUserId: number;
+    /** Price in Z-coin hundredths (e.g. 5000 = 50.00 Z-coin) */
+    priceZcoin: number;
+    /** Type of sale */
+    saleType: SaleType;
+    /** OAuth APP client ID */
+    appClientId: string;
+    /** Idempotency key from the calling APP */
+    referenceId: string;
+    /** Human-readable description */
+    description?: string;
+    /** Purchase channel */
+    channel?: PurchaseChannel;
+    /** Frontend origin for redirect URLs */
+    origin: string;
+    /** Optional listing ID (for Exchange trades) */
+    listingId?: number;
+}
+interface ZcoinCreateDirectPurchaseOrderOutput {
+    sessionId: string;
+    checkoutUrl: string;
+    priceZcoin: number;
+    fiatAmountCents: number;
+    groupId: string;
+    channel: PurchaseChannel;
+    status: "pending_payment";
+}
+interface ZcoinGetDepositPackagesInput {
+    channel?: PurchaseChannel;
+}
+interface ZcoinDepositPackage {
+    id: string;
+    zcoinAmount: number;
+    zcoinHundredths: number;
+    label: string;
+    basePriceCents: number;
+    totalPriceCents: number;
+    channel: PurchaseChannel;
+    featured: boolean;
+}
+interface ZcoinCreateDepositOrderInput {
+    /** Z-coin amount to purchase (display units, e.g. 100 or 100.50) */
+    amount: number;
+    /** Purchase channel */
+    channel?: PurchaseChannel;
+    /** Frontend origin for redirect URLs */
+    origin: string;
+}
+interface ZcoinCreateDepositOrderOutput {
+    sessionId: string;
+    checkoutUrl: string;
+    zcoinAmount: number;
+    fiatAmountCents: number;
+    channel: PurchaseChannel;
+    status: "pending_payment";
+}
+interface ZcoinGetDepositStatusInput {
+    sessionId: string;
+}
+interface ZcoinGetDepositStatusOutput {
+    sessionId: string;
+    paymentStatus: string;
+    status: string;
+    zcoinAmount: number;
+    amountTotal: number | null;
+    currency: string | null;
+}
+interface InventoryGetUserInventoryInput {
+    userId?: number;
+    openId?: string;
+    seriesId?: number;
+    limit?: number;
+    offset?: number;
+}
+interface InventoryConfirmOwnershipInput {
+    userId: number;
+    cardId: number;
+}
+interface InventoryConfirmOwnershipOutput {
+    owns: boolean;
+    count: number;
+}
+interface InventoryMintInput {
+    cardId: number;
+    toUserId: number;
+    quantity?: number;
+    referenceId?: string;
+}
+interface InventoryMintOutput {
+    success: boolean;
+    cardId: number;
+    toUserId: number;
+    quantity: number;
+    instances: Array<{
+        id: number;
+        instanceCode: string;
+        shortCode: string;
+    }>;
+}
+interface InventoryTransferInput {
+    instanceId: number;
+    toUserId: number;
+    reason?: TransferReason;
+    referenceId?: string;
+    expectedVersion?: number;
+}
+interface InventoryTransferOutput {
+    success: true;
+    idempotent: boolean;
+    instanceId: number;
+    fromUserId: number | null;
+    toUserId: number;
+    reason: string;
+    eventId?: number;
+    _deprecation_warning?: string;
+}
+interface InventoryTransferByCardInput {
+    cardId: number;
+    toUserId: number;
+    quantity?: number;
+    reason?: TransferReason;
+    referenceId?: string;
+}
+interface InventoryTransferByCardOutput {
+    success: true;
+    idempotent: boolean;
+    cardId: number;
+    fromUserId: number | null;
+    toUserId: number;
+    quantity: number;
+    reason: string;
+    _deprecation_warning?: string;
+}
+interface InventoryGrantMintAuthInput {
+    cardId: number;
+    granteeUserId: number;
+    granteeAppClientId?: string;
+    maxMintCount?: number;
+    validUntilMs?: number;
+}
+interface InventoryTransferHistoryInput {
+    instanceId?: number;
+    cardId?: number;
+    userId?: number;
+    limit?: number;
+    offset?: number;
+}
+interface CollectibleGetInstanceByIdInput {
+    instanceId: number;
+    claimToken?: string;
+}
+interface CollectibleGetPublicInstanceInput {
+    instanceCode: string;
+}
+interface CollectibleGetPublicInstancesBatchInput {
+    instanceIds: number[];
+}
+interface CollectibleGetCardProfileInput {
+    cardId: number;
+}
+interface CollectibleGetShellImageUrlInput {
+    cardId: number;
+}
+interface UserGetPublicProfileInput {
+    openId: string;
+}
+interface UserPublicProfile {
+    openId: string;
+    name: string;
+    avatarUrl: string | null;
+    joinedAt: Date;
+    stats: {
+        totalOwned: number;
+    };
+}
+interface UserGetPublicProfileByIdInput {
+    userId: number;
+}
+interface AuthGetOAuthAppInfoInput {
+    clientId: string;
+}
+interface AuthOAuthAppInfo {
+    appName: string;
+    iconUrl: string | null;
+    websiteUrl: string | null;
+}
+interface AuthUser {
+    id: number;
+    openId: string;
+    name: string;
+    email: string | null;
+    avatarUrl: string | null;
+    role: "admin" | "user";
+}
+interface FranchiseGetInput {
+    id?: number;
+    slug?: string;
+}
+interface SeriesGetInput {
+    id?: number;
+    slug?: string;
+}
+interface SeriesListByFranchiseInput {
+    franchiseId: number;
+}
+interface CardGetInput {
+    id: number;
+}
+interface CardListBySeriesInput {
+    seriesId: number;
+}
+interface GoodZApiFieldError {
+    path: (string | number)[];
+    message: string;
+    code: string;
+}
+/**
+ * Structured error from GoodZ.Core API.
+ * Includes tRPC error code, HTTP status, and optional Zod validation details.
+ */
+interface GoodZErrorV2 {
+    type: string;
+    code: string;
+    message: string;
+    httpStatus: number;
+}
+
+/**
+ * @goodz-core/sdk — HTTP Transport Layer
+ *
+ * Speaks the tRPC v11 HTTP wire protocol directly using fetch.
+ * Handles superjson serialization, batching, and error parsing.
+ *
+ * Wire format reference:
+ * - Queries:   GET  /api/trpc/{procedure}?input={superjson-encoded}
+ * - Mutations: POST /api/trpc/{procedure}  body: {superjson-encoded}
+ * - Batch:     GET  /api/trpc/{p1},{p2}?input={0: ..., 1: ...}
+ *
+ * @internal
+ */
+
+declare class GoodZApiError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    readonly path: string;
+    readonly zodErrors?: GoodZApiFieldError[];
+    readonly data?: unknown;
+    constructor(opts: {
+        message: string;
+        code: string;
+        httpStatus: number;
+        path: string;
+        zodErrors?: GoodZApiFieldError[];
+        data?: unknown;
+    });
+    /** Human-readable summary including field errors if present. */
+    toDetailedString(): string;
+}
+interface TransportConfig {
+    baseUrl: string;
+    getHeaders: () => Record<string, string> | Promise<Record<string, string>>;
+}
+
+export { type AuthGetOAuthAppInfoInput as A, type ZcoinCommercialTransferOutput as B, type CardGetInput as C, type ZcoinCreateDepositOrderInput as D, type ZcoinCreateDepositOrderOutput as E, type FranchiseGetInput as F, GoodZApiError as G, type ZcoinCreateDirectPurchaseOrderInput as H, type InventoryConfirmOwnershipInput as I, type ZcoinCreateDirectPurchaseOrderOutput as J, type ZcoinDepositPackage as K, type ZcoinGetDepositPackagesInput as L, type ZcoinGetDepositStatusInput as M, type ZcoinGetDepositStatusOutput as N, type ZcoinGetMyBalanceOutput as O, type PurchaseChannel as P, type ZcoinGetMyHistoryInput as Q, type ZcoinMintAndChargeInput as R, type SaleType as S, type TransferReason as T, type UserGetPublicProfileByIdInput as U, type ZcoinMintAndChargeOutput as V, type ZcoinTxType as W, type TransportConfig as X, type ZcoinChargeUserInput as Z, type AuthOAuthAppInfo as a, type AuthUser as b, type CardListBySeriesInput as c, type CollectibleGetCardProfileInput as d, type CollectibleGetInstanceByIdInput as e, type CollectibleGetPublicInstanceInput as f, type CollectibleGetPublicInstancesBatchInput as g, type CollectibleGetShellImageUrlInput as h, type GoodZApiFieldError as i, type GoodZErrorV2 as j, type InventoryConfirmOwnershipOutput as k, type InventoryGetUserInventoryInput as l, type InventoryGrantMintAuthInput as m, type InventoryMintInput as n, type InventoryMintOutput as o, type InventoryTransferByCardInput as p, type InventoryTransferByCardOutput as q, type InventoryTransferHistoryInput as r, type InventoryTransferInput as s, type InventoryTransferOutput as t, type SeriesGetInput as u, type SeriesListByFranchiseInput as v, type UserGetPublicProfileInput as w, type UserPublicProfile as x, type ZcoinChargeUserOutput as y, type ZcoinCommercialTransferInput as z };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goodz-core/sdk",
-  "version": "0.2.0",
-  "description": "Official SDK for GoodZ.Core — type-safe API client, OAuth helpers, Z-coin utilities, and React UI components for building GoodZ-powered applications.",
+  "version": "0.3.1",
+  "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",
   "types": "./dist/index.d.ts",
@@ -25,6 +25,18 @@
     "./ui": {
       "types": "./dist/ui/index.d.ts",
       "import": "./dist/ui/index.js"
+    },
+    "./commerce": {
+      "types": "./dist/commerce/index.d.ts",
+      "import": "./dist/commerce/index.js"
+    },
+    "./exchange": {
+      "types": "./dist/exchange/index.d.ts",
+      "import": "./dist/exchange/index.js"
+    },
+    "./alive": {
+      "types": "./dist/alive/index.d.ts",
+      "import": "./dist/alive/index.js"
     }
   },
   "files": [
@@ -47,7 +59,12 @@
     "zcoin",
     "react",
     "card-display",
-    "holographic"
+    "holographic",
+    "commerce",
+    "exchange",
+    "marketplace",
+    "gacha",
+    "nft"
   ],
   "author": "GoodZ Team",
   "license": "MIT",

package/dist/chunk-G7NKU6PT.js

@@ -1,183 +0,0 @@
-import superjson from 'superjson';
-
-// src/transport.ts
-var GoodZApiError = class extends Error {
-  code;
-  httpStatus;
-  path;
-  zodErrors;
-  data;
-  constructor(opts) {
-    super(opts.message);
-    this.name = "GoodZApiError";
-    this.code = opts.code;
-    this.httpStatus = opts.httpStatus;
-    this.path = opts.path;
-    this.zodErrors = opts.zodErrors;
-    this.data = opts.data;
-  }
-  /** Human-readable summary including field errors if present. */
-  toDetailedString() {
-    const parts = [
-      `[GoodZApiError] ${this.code} on ${this.path}: ${this.message}`
-    ];
-    if (this.zodErrors?.length) {
-      parts.push("Field errors:");
-      for (const e of this.zodErrors) {
-        parts.push(`  - ${e.path.join(".")}: ${e.message} (${e.code})`);
-      }
-    }
-    return parts.join("\n");
-  }
-};
-async function callQuery(config, path, input) {
-  const url = `${config.baseUrl}/api/trpc/${path}`;
-  const headers = await config.getHeaders();
-  const serialized = input !== void 0 ? superjson.serialize(input) : void 0;
-  const queryUrl = serialized ? `${url}?input=${encodeURIComponent(JSON.stringify(serialized))}` : url;
-  const res = await fetch(queryUrl, {
-    method: "GET",
-    headers: {
-      ...headers,
-      "Content-Type": "application/json"
-    }
-  });
-  return parseResponse(res, path);
-}
-async function callMutation(config, path, input) {
-  const url = `${config.baseUrl}/api/trpc/${path}`;
-  const headers = await config.getHeaders();
-  const serialized = input !== void 0 ? superjson.serialize(input) : void 0;
-  const res = await fetch(url, {
-    method: "POST",
-    headers: {
-      ...headers,
-      "Content-Type": "application/json"
-    },
-    body: serialized ? JSON.stringify(serialized) : void 0
-  });
-  return parseResponse(res, path);
-}
-async function parseResponse(res, path) {
-  const text = await res.text();
-  let body;
-  try {
-    body = JSON.parse(text);
-  } catch {
-    throw new GoodZApiError({
-      message: `Invalid JSON response: ${text.slice(0, 200)}`,
-      code: "PARSE_ERROR",
-      httpStatus: res.status,
-      path
-    });
-  }
-  const envelope = Array.isArray(body) ? body[0] : body;
-  if (envelope?.error) {
-    const err = envelope.error;
-    const errJson = err?.json ?? err;
-    const errData = errJson?.data ?? {};
-    throw new GoodZApiError({
-      message: errJson?.message ?? "Unknown API error",
-      code: errData?.code ?? errJson?.code ?? "UNKNOWN",
-      httpStatus: errData?.httpStatus ?? res.status,
-      path: errData?.path ?? path,
-      zodErrors: errData?.zodError?.issues,
-      data: errData
-    });
-  }
-  const resultData = envelope?.result?.data;
-  if (resultData === void 0) {
-    if (res.ok) return void 0;
-    throw new GoodZApiError({
-      message: `Unexpected response shape from ${path}`,
-      code: "UNEXPECTED_RESPONSE",
-      httpStatus: res.status,
-      path
-    });
-  }
-  if (resultData && typeof resultData === "object" && "json" in resultData) {
-    return superjson.deserialize(resultData);
-  }
-  return resultData;
-}
-
-// src/core/index.ts
-function createGoodZClient(config = {}) {
-  const {
-    coreUrl = "https://goodzcore.manus.space",
-    accessToken,
-    getAccessToken,
-    headers: customHeaders
-  } = config;
-  const transport = {
-    baseUrl: coreUrl.replace(/\/$/, ""),
-    getHeaders: async () => {
-      const h = { ...customHeaders };
-      const token = getAccessToken ? await getAccessToken() : accessToken;
-      if (token) {
-        h["Authorization"] = `Bearer ${token}`;
-      }
-      return h;
-    }
-  };
-  const q = (path) => (input) => callQuery(transport, path, input);
-  const m = (path) => (input) => callMutation(transport, path, input);
-  return {
-    // ── zcoin ──────────────────────────────────────────────
-    zcoin: {
-      getMyBalance: q("zcoin.getMyBalance"),
-      getMyHistory: q("zcoin.getMyHistory"),
-      getDepositPackages: q("zcoin.getDepositPackages"),
-      createDepositOrder: m("zcoin.createDepositOrder"),
-      getDepositStatus: q("zcoin.getDepositStatus"),
-      commercialTransfer: m("zcoin.commercialTransfer"),
-      mintAndCharge: m("zcoin.mintAndCharge"),
-      chargeUser: m("zcoin.chargeUser"),
-      createDirectPurchaseOrder: m("zcoin.createDirectPurchaseOrder")
-    },
-    // ── inventory ──────────────────────────────────────────
-    inventory: {
-      getUserInventory: q("inventory.getUserInventory"),
-      confirmOwnership: q("inventory.confirmOwnership"),
-      mint: m("inventory.mint"),
-      transfer: m("inventory.transfer"),
-      transferByCard: m("inventory.transferByCard"),
-      grantMintAuth: m("inventory.grantMintAuth"),
-      transferHistory: q("inventory.transferHistory")
-    },
-    // ── collectible ────────────────────────────────────────
-    collectible: {
-      getInstanceById: q("collectible.getInstanceById"),
-      getPublicInstance: q("collectible.getPublicInstance"),
-      getPublicInstancesBatch: q("collectible.getPublicInstancesBatch"),
-      getCardProfile: q("collectible.getCardProfile"),
-      getShellImageUrl: q("collectible.getShellImageUrl")
-    },
-    // ── user ───────────────────────────────────────────────
-    user: {
-      getPublicProfile: q("user.getPublicProfile"),
-      getPublicProfileById: q("user.getPublicProfileById")
-    },
-    // ── auth ───────────────────────────────────────────────
-    auth: {
-      me: q("auth.me"),
-      getOAuthAppInfo: q("auth.getOAuthAppInfo")
-    },
-    // ── ip (franchise/series/card) ─────────────────────────
-    ip: {
-      getFranchise: q("franchise.get"),
-      getSeries: q("series.get"),
-      listSeriesByFranchise: q("series.listByFranchise"),
-      getCard: q("card.get"),
-      listCardsBySeries: q("card.listBySeries")
-    },
-    // ── raw escape hatches ─────────────────────────────────
-    rawQuery: (path, input) => callQuery(transport, path, input),
-    rawMutation: (path, input) => callMutation(transport, path, input)
-  };
-}
-var createUserClient = createGoodZClient;
-
-export { GoodZApiError, createGoodZClient, createUserClient };
-//# sourceMappingURL=chunk-G7NKU6PT.js.map
-//# sourceMappingURL=chunk-G7NKU6PT.js.map

package/dist/chunk-G7NKU6PT.js.map

@@ -1 +0,0 @@
-{"version":3,"sources":["../src/transport.ts","../src/core/index.ts"],"names":[],"mappings":"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","file":"chunk-G7NKU6PT.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/core — Type-safe API client for GoodZ.Core\n *\n * Zero tRPC dependency — speaks the tRPC HTTP wire protocol directly\n * using fetch + superjson. All types are hand-crafted and self-contained.\n *\n * @example\n * ```ts\n * import { createGoodZClient } from \"@goodz-core/sdk/core\";\n *\n * const goodz = createGoodZClient({\n *   coreUrl: \"https://goodzcore.manus.space\",\n *   accessToken: \"your-jwt-token\",\n * });\n *\n * // Fully typed — IDE autocomplete for all inputs and outputs\n * const balance = await goodz.zcoin.getMyBalance();\n * const result = await goodz.zcoin.commercialTransfer({ ... });\n * const instance = await goodz.collectible.getInstanceById({ instanceId: 90447 });\n * ```\n *\n * @module\n */\n\nimport { callQuery, callMutation, GoodZApiError } from \"../transport\";\nimport type { TransportConfig } from \"../transport\";\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  // inventory\n  InventoryGetUserInventoryInput,\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\";\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   * 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// ─── Namespace interfaces (for type documentation) ───────────\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   * 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<any[]>;\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  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  /**\n   * Make a raw tRPC query call. 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. 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 type-safe GoodZ.Core API client.\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 *\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 Acting on behalf of a user\n * ```ts\n * const userGoodz = createGoodZClient({\n *   accessToken: userAccessToken,\n * });\n * const balance = await userGoodz.zcoin.getMyBalance();\n * ```\n */\nexport function createGoodZClient(config: GoodZClientConfig = {}): GoodZClient {\n  const {\n    coreUrl = \"https://goodzcore.manus.space\",\n    accessToken,\n    getAccessToken,\n    headers: customHeaders,\n  } = config;\n\n  const transport: TransportConfig = {\n    baseUrl: coreUrl.replace(/\\/$/, \"\"),\n    getHeaders: async () => {\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\n  // Helper shortcuts\n  const q = <I, O>(path: string) => (input?: I) => callQuery<I, O>(transport, path, input);\n  const m = <I, O>(path: string) => (input?: I) => callMutation<I, O>(transport, 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      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, any[]>(\"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    // ── raw escape hatches ─────────────────────────────────\n    rawQuery: <T = any>(path: string, input?: any) => callQuery<any, T>(transport, path, input),\n    rawMutation: <T = any>(path: string, input?: any) => callMutation<any, T>(transport, 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"]}