@goodz-core/sdk 0.2.0 → 0.3.1

package/dist/chunk-OUKZ2PRD.js

@@ -0,0 +1,37 @@
+import { callMcpTool } from './chunk-4SU7SU7K.js';
+
+// src/exchange/index.ts
+function createExchangeNamespace(transport) {
+  const tool = (name) => (input) => callMcpTool(transport, name, input);
+  return {
+    // Marketplace
+    browseMarketplace: tool("browse_marketplace"),
+    getListingDetail: tool("get_listing_detail"),
+    // Listing Management
+    createListing: tool("create_listing"),
+    cancelListing: tool("cancel_listing"),
+    // Purchase & Bidding
+    buyListing: tool("buy_listing"),
+    placeBid: tool("place_bid"),
+    getBids: tool("get_bids"),
+    // WTB
+    createWtb: tool("create_wtb"),
+    fulfillWtb: tool("fulfill_wtb"),
+    cancelWtb: tool("cancel_wtb"),
+    // P2P Trade
+    proposeTrade: tool("propose_trade"),
+    respondToTrade: tool("respond_to_trade"),
+    // Watchlist
+    getWatchlist: tool("get_watchlist"),
+    addToWatchlist: tool("add_to_watchlist"),
+    removeFromWatchlist: tool("remove_from_watchlist"),
+    // Market Data
+    getMarketData: tool("get_market_data"),
+    // Raw escape hatch
+    rawTool: (toolName, args) => callMcpTool(transport, toolName, args)
+  };
+}
+
+export { createExchangeNamespace };
+//# sourceMappingURL=chunk-OUKZ2PRD.js.map
+//# sourceMappingURL=chunk-OUKZ2PRD.js.map

package/dist/chunk-OUKZ2PRD.js.map

@@ -0,0 +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"]}

package/dist/chunk-V73MMKHI.js

@@ -0,0 +1,56 @@
+import { callMcpTool } from './chunk-4SU7SU7K.js';
+
+// src/commerce/index.ts
+function createCommerceNamespace(transport) {
+  const tool = (name) => (input) => callMcpTool(transport, name, input);
+  return {
+    // Shop
+    createShop: tool("create_shop"),
+    getShopDashboard: tool("get_shop_dashboard"),
+    // Product Assembly
+    createBatch: tool("assemble_batch"),
+    createGachaPool: tool("create_gacha_pool"),
+    // Campaign Lifecycle
+    launchCampaign: tool("launch_sales_campaign"),
+    activateCampaign: tool("activate_campaign"),
+    pauseCampaign: tool("pause_campaign"),
+    endCampaign: tool("end_campaign"),
+    updateCampaign: tool("update_campaign"),
+    getCampaignInfo: tool("get_campaign_info"),
+    getCampaignItems: tool("get_campaign_items"),
+    // Purchase
+    executePurchase: tool("execute_purchase"),
+    getMyOrders: tool("get_my_orders"),
+    // Wholesale
+    publishToWholesale: tool("publish_to_wholesale"),
+    browseWholesale: tool("browse_wholesale_market"),
+    procureBatch: tool("procure_batch"),
+    // Inventory
+    manageInventory: tool("manage_inventory"),
+    registerInstances: tool("register_instances"),
+    mintToInventory: tool("mint_to_inventory"),
+    // Settlement
+    getSettlementReport: tool("get_settlement_report"),
+    // Discovery
+    searchMarketplace: tool("search_marketplace"),
+    getShopsByBlueprint: tool("get_shops_by_blueprint"),
+    // Physical Redemption
+    redeemPhysical: tool("redeem_physical_goodz"),
+    // Webhooks
+    registerWebhook: tool("register_webhook"),
+    listWebhooks: tool("list_webhooks"),
+    testWebhook: tool("test_webhook"),
+    deleteWebhook: tool("delete_webhook"),
+    // OAuth App
+    registerApp: tool("register_app"),
+    updateApp: tool("update_app"),
+    listMyApps: tool("list_my_apps"),
+    getAuthUrl: tool("get_auth_url"),
+    // Raw escape hatch
+    rawTool: (toolName, args) => callMcpTool(transport, toolName, args)
+  };
+}
+
+export { createCommerceNamespace };
+//# sourceMappingURL=chunk-V73MMKHI.js.map
+//# sourceMappingURL=chunk-V73MMKHI.js.map

package/dist/chunk-V73MMKHI.js.map

@@ -0,0 +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"]}

package/dist/commerce/index.d.ts

@@ -0,0 +1,462 @@
+import { X as TransportConfig } from '../transport-BOlScYEv.js';
+
+/**
+ * @goodz-core/sdk — Commerce / Shops API Type Definitions
+ *
+ * Hand-crafted types mirroring the GoodZ.Commerce MCP tool surface.
+ * These cover shop management, batches, gacha pools, campaigns,
+ * wholesale, purchases, and settlement.
+ *
+ * Aligned with Commerce MCP as of 2026-03-20.
+ *
+ * @module
+ */
+type CampaignStatus = "draft" | "active" | "paused" | "ended" | "sold_out";
+type SaleMode = "blind_box" | "ichiban_kuji" | "direct_sale" | "gacha";
+type AuthorizationMode = "open" | "whitelist" | "approved_only";
+type IntegrationMode = "hosted" | "custom";
+interface CommerceCreateShopInput {
+    name: string;
+    description?: string;
+    logoUrl?: string;
+    slug?: string;
+    userId?: number;
+}
+interface CommerceShop {
+    id: number;
+    name: string;
+    description: string | null;
+    logoUrl: string | null;
+    slug: string | null;
+    ownerId: number;
+    createdAt: string;
+}
+interface CommerceGetShopDashboardInput {
+    shopId?: number;
+    userId?: number;
+}
+interface CommerceShopDashboard {
+    shop: CommerceShop;
+    stats: {
+        totalOrders: number;
+        totalRevenue: number;
+        platformFees: number;
+        creatorShare: number;
+        shopShare: number;
+        activeCampaigns: number;
+    };
+    recentOrders: any[];
+}
+interface CommerceBatchTier {
+    tierName: string;
+    coreCardId: number;
+    quantity: number;
+    retailPriceCents: number;
+    imageUrl?: string;
+}
+interface CommerceCreateBatchInput {
+    shopId?: number;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    saleMode: SaleMode;
+    tiers: CommerceBatchTier[];
+    /** Core goods ID to link the batch to a specific IP/card blueprint */
+    coreGoodsId?: number;
+    /** Whether this batch has limited supply */
+    isLimited?: boolean;
+    /** Total supply across all tiers */
+    totalSupply?: number;
+    /** Retail price in cents (for the entire batch or per unit) */
+    retailPriceCents?: number;
+    /** Number of units per box (for blind-box sale mode) */
+    unitsPerBox?: number;
+    /** Number of boxes per batch */
+    boxesPerBatch?: number;
+    userId?: number;
+}
+interface CommerceBatch {
+    id: number;
+    name: string;
+    description: string | null;
+    saleMode: SaleMode;
+    status: string;
+    tiers: CommerceBatchTier[];
+    createdAt: string;
+}
+interface CommerceGachaItem {
+    coreCardId: number;
+    name?: string;
+    imageUrl?: string;
+    weight: number;
+    rarity?: string;
+    quantity?: number;
+}
+interface CommercePityConfig {
+    softPityStart?: number;
+    hardPityAt?: number;
+    stepUpGuarantee?: number;
+    guaranteedRarity?: string;
+}
+interface CommerceCreateGachaPoolInput {
+    shopId?: number;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    pricePerDrawCents: number;
+    isLimited: boolean;
+    totalDraws?: number;
+    items?: CommerceGachaItem[];
+    pityConfig?: CommercePityConfig;
+    userId?: number;
+}
+interface CommerceGachaPool {
+    id: number;
+    name: string;
+    description: string | null;
+    pricePerDrawCents: number;
+    isLimited: boolean;
+    totalDraws: number | null;
+    remainingDraws: number | null;
+    items: CommerceGachaItem[];
+    pityConfig: CommercePityConfig | null;
+    createdAt: string;
+}
+interface CommerceLaunchCampaignInput {
+    shopId?: number;
+    name: string;
+    description?: string;
+    imageUrl?: string;
+    batchId?: number;
+    gachaPoolId?: number;
+    isProcured?: boolean;
+    procurementId?: number;
+    startsAt?: string;
+    endsAt?: string;
+    userId?: number;
+}
+interface CommerceCampaign {
+    id: number;
+    name: string;
+    description: string | null;
+    imageUrl: string | null;
+    status: CampaignStatus;
+    batchId: number | null;
+    gachaPoolId: number | null;
+    startsAt: string | null;
+    endsAt: string | null;
+    createdAt: string;
+}
+interface CommerceActivateCampaignInput {
+    campaignId: number;
+    userId?: number;
+}
+interface CommercePauseCampaignInput {
+    campaignId: number;
+    userId?: number;
+}
+interface CommerceEndCampaignInput {
+    campaignId: number;
+    userId?: number;
+}
+interface CommerceUpdateCampaignInput {
+    campaignId: number;
+    name?: string;
+    description?: string;
+    imageUrl?: string;
+    /** Link or update the batch for this campaign */
+    batchId?: number;
+    /** Link or update the gacha pool for this campaign */
+    gachaPoolId?: number;
+    startsAt?: string;
+    endsAt?: string;
+    userId?: number;
+}
+interface CommerceGetCampaignInfoInput {
+    campaignId: number;
+}
+interface CommerceGetCampaignItemsInput {
+    campaign_id: number;
+    enrich_images?: boolean;
+}
+interface CommerceCampaignItem {
+    sourceType: "batch" | "gacha";
+    coreCardId: number;
+    name: string | null;
+    imageUrl: string | null;
+    quantity: number | null;
+    probability: number | null;
+    retailPriceCents: number | null;
+    rarity: string | null;
+}
+interface CommerceExecutePurchaseInput {
+    campaignId: number;
+    quantity?: number;
+    tierId?: number;
+    userId?: number;
+}
+interface CommerceDrawResult {
+    orderId: number;
+    items: Array<{
+        cardId: number;
+        cardName: string | null;
+        imageUrl: string | null;
+        instanceId: number;
+        instanceCode: string;
+        rarity: string | null;
+        tierName: string | null;
+    }>;
+    totalCharged: number;
+    platformFee: number;
+}
+interface CommerceGetMyOrdersInput {
+    userId?: number;
+    limit?: number;
+}
+interface CommerceOrder {
+    id: number;
+    campaignId: number;
+    campaignName: string;
+    quantity: number;
+    totalPaid: number;
+    status: string;
+    createdAt: string;
+    items: any[];
+}
+interface CommercePublishToWholesaleInput {
+    batchId: number;
+    wholesalePriceCents?: number;
+    channelMarginBps?: number;
+    totalStock?: number;
+    authorizationMode?: AuthorizationMode;
+    userId?: number;
+}
+interface CommerceBrowseWholesaleInput {
+    keyword?: string;
+    minPrice?: number;
+    maxPrice?: number;
+    authorizationMode?: AuthorizationMode;
+    creatorId?: string;
+    saleMode?: string;
+    limit?: number;
+}
+interface CommerceWholesaleListing {
+    id: number;
+    batchId: number;
+    batchName: string;
+    wholesalePriceCents: number | null;
+    channelMarginBps: number | null;
+    totalStock: number | null;
+    remainingStock: number | null;
+    authorizationMode: AuthorizationMode;
+    saleMode: SaleMode;
+    creatorId: string;
+}
+interface CommerceProcureBatchInput {
+    listingId: number;
+    quantity?: number;
+    shopId?: number;
+    userId?: number;
+}
+interface CommerceManageInventoryInput {
+    action?: "list" | "sync";
+    shopId?: number;
+    userId?: number;
+}
+interface CommerceRegisterInstancesInput {
+    shopId?: number;
+    /** Array of instance objects or IDs to register */
+    instances: Array<{
+        instanceId: number;
+        [key: string]: any;
+    }> | number[];
+    /** Source of the instances (e.g. "core_mint", "transfer", "import") */
+    source?: string;
+    userId?: number;
+}
+interface CommerceMintToInventoryInput {
+    shopId?: number;
+    coreCardId: number;
+    quantity?: number;
+    /** Display name for the minted instances */
+    name?: string;
+    userId?: number;
+}
+interface CommerceGetSettlementReportInput {
+    shopId?: number;
+    userId?: number;
+    /** Number of days to include in the report period */
+    periodDays?: number;
+}
+interface CommerceSearchMarketplaceInput {
+    /** Search query string */
+    query?: string;
+    /** Filter by sale mode */
+    sale_mode?: SaleMode;
+    /** Minimum price in cents */
+    min_price_cents?: number;
+    /** Maximum price in cents */
+    max_price_cents?: number;
+    /** Filter by specific shop */
+    shop_id?: number;
+    /** Sort order (e.g. "newest", "price_asc", "price_desc", "popular") */
+    sort?: string;
+    /** Filter by status (e.g. "active") */
+    status?: string;
+    /** Page number (1-based) */
+    page?: number;
+    /** Items per page */
+    page_size?: number;
+}
+interface CommerceGetShopsByBlueprintInput {
+    /** Core card ID to find shops selling this blueprint */
+    core_card_id: number;
+    /** Include ended campaigns */
+    include_ended?: boolean;
+    /** Page number (1-based) */
+    page?: number;
+    /** Items per page */
+    page_size?: number;
+}
+interface CommerceRedeemPhysicalInput {
+    orderItemId: number;
+    shippingName: string;
+    shippingAddress: string;
+    shippingPhone: string;
+    coreCardId?: number;
+    /** Core inventory item ID for the specific instance to redeem */
+    coreInventoryItemId?: number;
+    userId?: number;
+}
+interface CommerceRegisterWebhookInput {
+    url: string;
+    events: string[];
+    shop_id?: number;
+}
+interface CommerceWebhook {
+    id: number;
+    url: string;
+    events: string[];
+    status: string;
+    failureCount: number;
+    signingSecret?: string;
+}
+interface CommerceTestWebhookInput {
+    webhook_id: number;
+}
+interface CommerceDeleteWebhookInput {
+    webhook_id: number;
+}
+interface CommerceRegisterAppInput {
+    appName: string;
+    /** App description */
+    description?: string;
+    /** Website URL for the app */
+    websiteUrl?: string;
+    /** Icon URL for the app */
+    iconUrl?: string;
+    redirectUris?: string[];
+    coreScopes?: string[];
+    commerceScopes?: string[];
+    userId?: number;
+}
+interface CommerceUpdateAppInput {
+    clientId: string;
+    appName?: string;
+    description?: string;
+    websiteUrl?: string;
+    iconUrl?: string;
+    redirectUris?: string[];
+    coreScopes?: string[];
+    commerceScopes?: string[];
+    integrationMode?: IntegrationMode;
+    userId?: number;
+}
+interface CommerceListMyAppsInput {
+    userId?: number;
+}
+interface CommerceGetAuthUrlInput {
+    callbackUrl?: string;
+}
+
+/**
+ * @goodz-core/sdk — Commerce / Shops Namespace
+ *
+ * Provides typed access to GoodZ.Commerce MCP tools:
+ * shop management, batches, gacha pools, campaigns,
+ * wholesale, purchases, settlement, and webhooks.
+ *
+ * @module
+ */
+
+interface CommerceNamespace {
+    /** Create a new shop. */
+    createShop(input: CommerceCreateShopInput): Promise<CommerceShop>;
+    /** Get shop dashboard with stats, revenue, and recent orders. */
+    getShopDashboard(input?: CommerceGetShopDashboardInput): Promise<CommerceShopDashboard>;
+    /** Create a batch (product assembly with tiers). Supports blind_box, ichiban_kuji, direct_sale. */
+    createBatch(input: CommerceCreateBatchInput): Promise<CommerceBatch>;
+    /** Create a gacha pool with weighted probabilities and optional pity mechanics. */
+    createGachaPool(input: CommerceCreateGachaPoolInput): Promise<CommerceGachaPool>;
+    /** Launch a sales campaign in draft status. Connect a Batch or Gacha pool to the storefront. */
+    launchCampaign(input: CommerceLaunchCampaignInput): Promise<CommerceCampaign>;
+    /** Activate a draft/paused campaign — makes it live and purchasable. */
+    activateCampaign(input: CommerceActivateCampaignInput): Promise<CommerceCampaign>;
+    /** Pause an active campaign. Existing orders unaffected. */
+    pauseCampaign(input: CommercePauseCampaignInput): Promise<CommerceCampaign>;
+    /** Permanently end a campaign (terminal state). */
+    endCampaign(input: CommerceEndCampaignInput): Promise<CommerceCampaign>;
+    /** Update campaign configuration (editable fields depend on status). */
+    updateCampaign(input: CommerceUpdateCampaignInput): Promise<CommerceCampaign>;
+    /** Get detailed campaign info including batch/gacha config and tiers. */
+    getCampaignInfo(input: CommerceGetCampaignInfoInput): Promise<any>;
+    /** Get unified campaign items list (works for both batch and gacha campaigns). */
+    getCampaignItems(input: CommerceGetCampaignItemsInput): Promise<CommerceCampaignItem[]>;
+    /** Execute a purchase or draw. Handles payment, draw mechanics, settlement, and ownership transfer. */
+    executePurchase(input: CommerceExecutePurchaseInput): Promise<CommerceDrawResult>;
+    /** Get the authenticated user's order history. */
+    getMyOrders(input?: CommerceGetMyOrdersInput): Promise<CommerceOrder[]>;
+    /** Publish a batch to the wholesale market for other shopkeepers to procure. */
+    publishToWholesale(input: CommercePublishToWholesaleInput): Promise<any>;
+    /** Browse available wholesale listings. */
+    browseWholesale(input?: CommerceBrowseWholesaleInput): Promise<CommerceWholesaleListing[]>;
+    /** Procure goods from the wholesale market. */
+    procureBatch(input: CommerceProcureBatchInput): Promise<any>;
+    /** View and manage shop inventory (list or sync from Core). */
+    manageInventory(input?: CommerceManageInventoryInput): Promise<any>;
+    /** Register existing Core instances into shop inventory. */
+    registerInstances(input: CommerceRegisterInstancesInput): Promise<any>;
+    /** Mint new instances directly into shop inventory. */
+    mintToInventory(input: CommerceMintToInventoryInput): Promise<any>;
+    /** Get settlement report with revenue breakdown. */
+    getSettlementReport(input?: CommerceGetSettlementReportInput): Promise<any>;
+    /** Search the marketplace for campaigns. */
+    searchMarketplace(input?: CommerceSearchMarketplaceInput): Promise<any[]>;
+    /** Find shops selling a specific GoodZ card. */
+    getShopsByBlueprint(input: CommerceGetShopsByBlueprintInput): Promise<any[]>;
+    /** Request physical redemption for a purchased item. */
+    redeemPhysical(input: CommerceRedeemPhysicalInput): Promise<any>;
+    /** Register a webhook URL to receive shop event notifications. */
+    registerWebhook(input: CommerceRegisterWebhookInput): Promise<CommerceWebhook>;
+    /** List all registered webhook endpoints. */
+    listWebhooks(): Promise<CommerceWebhook[]>;
+    /** Send a test ping to a webhook endpoint. */
+    testWebhook(input: CommerceTestWebhookInput): Promise<any>;
+    /** Delete a webhook endpoint. */
+    deleteWebhook(input: CommerceDeleteWebhookInput): Promise<any>;
+    /** Register a new OAuth application with Commerce scopes. */
+    registerApp(input: CommerceRegisterAppInput): Promise<any>;
+    /** Update an existing OAuth application. */
+    updateApp(input: CommerceUpdateAppInput): Promise<any>;
+    /** List all OAuth applications owned by the user. */
+    listMyApps(input?: CommerceListMyAppsInput): Promise<any[]>;
+    /** Generate an OAuth authorization URL. */
+    getAuthUrl(input?: CommerceGetAuthUrlInput): Promise<{
+        url: string;
+    }>;
+    /** Call a raw MCP tool by name. Escape hatch for tools not yet in the typed API. */
+    rawTool<T = any>(toolName: string, args?: Record<string, any>): Promise<T>;
+}
+declare function createCommerceNamespace(transport: TransportConfig): CommerceNamespace;
+
+export { type AuthorizationMode, type CampaignStatus, type CommerceActivateCampaignInput, type CommerceBatch, type CommerceBatchTier, type CommerceBrowseWholesaleInput, type CommerceCampaign, type CommerceCampaignItem, type CommerceCreateBatchInput, type CommerceCreateGachaPoolInput, type CommerceCreateShopInput, type CommerceDeleteWebhookInput, type CommerceDrawResult, type CommerceEndCampaignInput, type CommerceExecutePurchaseInput, type CommerceGachaItem, type CommerceGachaPool, type CommerceGetAuthUrlInput, type CommerceGetCampaignInfoInput, type CommerceGetCampaignItemsInput, type CommerceGetMyOrdersInput, type CommerceGetSettlementReportInput, type CommerceGetShopDashboardInput, type CommerceGetShopsByBlueprintInput, type CommerceLaunchCampaignInput, type CommerceListMyAppsInput, type CommerceManageInventoryInput, type CommerceMintToInventoryInput, type CommerceNamespace, type CommerceOrder, type CommercePauseCampaignInput, type CommercePityConfig, type CommerceProcureBatchInput, type CommercePublishToWholesaleInput, type CommerceRedeemPhysicalInput, type CommerceRegisterAppInput, type CommerceRegisterInstancesInput, type CommerceRegisterWebhookInput, type CommerceSearchMarketplaceInput, type CommerceShop, type CommerceShopDashboard, type CommerceTestWebhookInput, type CommerceUpdateAppInput, type CommerceUpdateCampaignInput, type CommerceWebhook, type CommerceWholesaleListing, type IntegrationMode, type SaleMode, createCommerceNamespace };

package/dist/commerce/index.js

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

package/dist/commerce/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"index.js"}