@henrylabs/mcp 0.26.0 → 1.1.2

package/src/local-docs-search.ts

@@ -0,0 +1,544 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import MiniSearch from 'minisearch';
+import * as fs from 'node:fs/promises';
+import * as path from 'node:path';
+import { getLogger } from './logger';
+
+type MethodEntry = {
+  name: string;
+  endpoint: string;
+  httpMethod: string;
+  summary: string;
+  description: string;
+  stainlessPath: string;
+  qualified: string;
+  params?: string[];
+  response?: string;
+  markdown?: string;
+};
+
+type ProseChunk = {
+  content: string;
+  tag: string;
+  sectionContext?: string;
+  source?: string;
+};
+
+type MiniSearchDocument = {
+  id: string;
+  kind: 'http_method' | 'prose';
+  name?: string;
+  endpoint?: string;
+  summary?: string;
+  description?: string;
+  qualified?: string;
+  stainlessPath?: string;
+  content?: string;
+  sectionContext?: string;
+  _original: Record<string, unknown>;
+};
+
+type SearchResult = {
+  results: (string | Record<string, unknown>)[];
+};
+
+const EMBEDDED_METHODS: MethodEntry[] = [
+  {
+    name: 'details',
+    endpoint: '/product/details',
+    httpMethod: 'post',
+    summary: 'Product Details',
+    description: 'Fetch detailed information about a product from a given URL.',
+    stainlessPath: '(resource) products > (method) details',
+    qualified: 'client.products.details',
+    params: ['link: string;', 'country?: string;', 'variant?: string | object;'],
+    response:
+      "{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; metadata?: object; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }; }",
+    markdown:
+      "## details\n\n`client.products.details(link: string, country?: string, variant?: string | object): { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }`\n\n**post** `/product/details`\n\nFetch detailed information about a product from a given URL.\n\n### Parameters\n\n- `link: string`\n  Direct product URL\n\n- `country?: string`\n\n- `variant?: string | object`\n  Variant selection. Can be a simple string or a key-value object\n\n### Returns\n\n- `{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; metadata?: object; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }; }`\n\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'failed'`\n  - `error?: object`\n  - `result?: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; metadata?: object; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.products.details({ link: 'https://www.nike.com/u/custom-nike-ja-3-by-you-10002205' });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'poll_details',
+    endpoint: '/product/details/status',
+    httpMethod: 'get',
+    summary: 'Product Details Status',
+    description: 'Check the status of a product details retrieval job and get results when ready.',
+    stainlessPath: '(resource) products > (method) poll_details',
+    qualified: 'client.products.pollDetails',
+    params: ['refId: string;'],
+    response:
+      "{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; metadata?: object; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }; }",
+    markdown:
+      "## poll_details\n\n`client.products.pollDetails(refId: string): { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }`\n\n**get** `/product/details/status`\n\nCheck the status of a product details retrieval job and get results when ready.\n\n### Parameters\n\n- `refId: string`\n  Reference ID used for checking status\n\n### Returns\n\n- `{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; metadata?: object; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }; }`\n\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'failed'`\n  - `error?: object`\n  - `result?: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; metadata?: object; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.products.pollDetails({ refId: 'prd-ref_3fa85f64-5717-4562-b3fc' });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'poll_search',
+    endpoint: '/product/search/status',
+    httpMethod: 'get',
+    summary: 'Product Search Status',
+    description: 'Check the status of a product search retrieval job and get results when ready.',
+    stainlessPath: '(resource) products > (method) poll_search',
+    qualified: 'client.products.pollSearch',
+    params: ['refId: string;'],
+    response:
+      "{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { pagination: { nextCursor: string; previousCursor: string; }; products: { host: string; link: string; merchant: string; name: string; price: object; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: object[]; originalPrice?: object; variants?: object[]; }[]; }; }",
+    markdown:
+      "## poll_search\n\n`client.products.pollSearch(refId: string): { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }`\n\n**get** `/product/search/status`\n\nCheck the status of a product search retrieval job and get results when ready.\n\n### Parameters\n\n- `refId: string`\n  Reference ID used for checking status\n\n### Returns\n\n- `{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { pagination: { nextCursor: string; previousCursor: string; }; products: { host: string; link: string; merchant: string; name: string; price: object; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: object[]; originalPrice?: object; variants?: object[]; }[]; }; }`\n\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'failed'`\n  - `error?: object`\n  - `result?: { pagination: { nextCursor: string; previousCursor: string; }; products: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.products.pollSearch({ refId: 'prs-ref_3fa85f64-5717-4562-b3fc' });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'search',
+    endpoint: '/product/search',
+    httpMethod: 'post',
+    summary: 'Text Product Search',
+    description: 'Search for products using keyword and passing various filters and criteria',
+    stainlessPath: '(resource) products > (method) search',
+    qualified: 'client.products.search',
+    params: [
+      'query: string;',
+      'country?: string;',
+      'cursor?: number;',
+      'limit?: number;',
+      'maxPrice?: number;',
+      'merchant?: string;',
+      'minPrice?: number;',
+      "sortBy?: 'lowToHigh' | 'highToLow';",
+    ],
+    response:
+      "{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { pagination: { nextCursor: string; previousCursor: string; }; products: { host: string; link: string; merchant: string; name: string; price: object; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: object[]; originalPrice?: object; variants?: object[]; }[]; }; }",
+    markdown:
+      "## search\n\n`client.products.search(query: string, country?: string, cursor?: number, limit?: number, maxPrice?: number, merchant?: string, minPrice?: number, sortBy?: 'lowToHigh' | 'highToLow'): { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }`\n\n**post** `/product/search`\n\nSearch for products using keyword and passing various filters and criteria\n\n### Parameters\n\n- `query: string`\n  Search query\n\n- `country?: string`\n\n- `cursor?: number`\n  Cursor returned from the previous response\n\n- `limit?: number`\n  Limit the number of results\n\n- `maxPrice?: number`\n  Maximum price filter\n\n- `merchant?: string`\n  Merchant to filter results\n\n- `minPrice?: number`\n  Minimum price filter\n\n- `sortBy?: 'lowToHigh' | 'highToLow'`\n  Sort by price: 'lowToHigh' or 'highToLow'\n\n### Returns\n\n- `{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { pagination: { nextCursor: string; previousCursor: string; }; products: { host: string; link: string; merchant: string; name: string; price: object; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: object[]; originalPrice?: object; variants?: object[]; }[]; }; }`\n\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'failed'`\n  - `error?: object`\n  - `result?: { pagination: { nextCursor: string; previousCursor: string; }; products: { host: string; link: string; merchant: string; name: string; price: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; description?: string; images?: { url: string; isFeatured?: boolean; }[]; originalPrice?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; variants?: { name: string; sku: string; availability?: 'in_stock' | 'limited_stock' | 'out_of_stock' | 'preorder' | 'backorder'; }[]; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.products.search({ query: 'Air Max Shoes' });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'create',
+    endpoint: '/cart',
+    httpMethod: 'post',
+    summary: 'Cart Create',
+    description: 'Create a cart with one or more items and get a checkout URL',
+    stainlessPath: '(resource) cart > (method) create',
+    qualified: 'client.cart.create',
+    params: [
+      'items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[];',
+      "settings?: { commissionFeeFixed?: { value: number; currency?: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; }; commissionFeePercent?: number; events?: { data: { points: number; type: 'give_points_fixed'; } | { perAmount: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; points: number; type: 'give_points_per_spent'; } | { points: number; type: 'remove_points_fixed'; } | { perAmount: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; points: number; type: 'remove_points_per_spent'; } | { tierUUID: string; type: 'give_tier'; } | { type: 'remove_tier'; } | { type: 'send_webhook'; webhookUUID: string; } | { type: 'send_email'; }[]; type: string; conditional?: { operator: 'equals' | 'not_equals'; type: 'tier'; value: string; } | { operator: string; type: 'points'; value: number; }; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; };",
+      'tags?: object;',
+    ],
+    response:
+      '{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }',
+    markdown:
+      "## create\n\n`client.cart.create(items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[], settings?: { commissionFeeFixed?: { value: number; currency?: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }, tags?: object): { data: object; message: string; status: string; success: boolean; }`\n\n**post** `/cart`\n\nCreate a cart with one or more items and get a checkout URL\n\n### Parameters\n\n- `items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]`\n  Items to include in the cart\n\n- `settings?: { commissionFeeFixed?: { value: number; currency?: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; }; commissionFeePercent?: number; events?: { data: { points: number; type: 'give_points_fixed'; } | { perAmount: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; points: number; type: 'give_points_per_spent'; } | { points: number; type: 'remove_points_fixed'; } | { perAmount: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; points: number; type: 'remove_points_per_spent'; } | { tierUUID: string; type: 'give_tier'; } | { type: 'remove_tier'; } | { type: 'send_webhook'; webhookUUID: string; } | { type: 'send_email'; }[]; type: string; conditional?: { operator: 'equals' | 'not_equals'; type: 'tier'; value: string; } | { operator: string; type: 'points'; value: number; }; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }`\n  - `commissionFeeFixed?: { value: number; currency?: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; }`\n  - `commissionFeePercent?: number`\n    Commission percentage (0–100)\n  - `events?: { data: { points: number; type: 'give_points_fixed'; } | { perAmount: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; points: number; type: 'give_points_per_spent'; } | { points: number; type: 'remove_points_fixed'; } | { perAmount: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; points: number; type: 'remove_points_per_spent'; } | { tierUUID: string; type: 'give_tier'; } | { type: 'remove_tier'; } | { type: 'send_webhook'; webhookUUID: string; } | { type: 'send_email'; }[]; type: string; conditional?: { operator: 'equals' | 'not_equals'; type: 'tier'; value: string; } | { operator: string; type: 'points'; value: number; }; }[]`\n    List of events to trigger during checkout\n  - `options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }`\n\n- `tags?: object`\n  Key-value tags to associate with the cart\n\n### Returns\n\n- `{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }`\n\n  - `data: { cartId: string; checkoutUrl: string; data: { items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]; settings?: { commissionFeeFixed?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }; tags?: object; }; metadata?: object; }`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst cart = await client.cart.create({ items: [{ link: 'https://www.nike.com/u/custom-nike-ja-3-by-you-10002205' }] });\n\nconsole.log(cart);\n```",
+  },
+  {
+    name: 'list',
+    endpoint: '/cart',
+    httpMethod: 'get',
+    summary: 'Cart Fetch',
+    description: 'Fetch a list of carts with optional filtering by cart ID or tags.',
+    stainlessPath: '(resource) cart > (method) list',
+    qualified: 'client.cart.list',
+    params: ['cartId?: string;', 'cursor?: string;', 'limit?: number;', 'tags?: object;'],
+    response:
+      '{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }[]; message: string; status: string; success: boolean; }',
+    markdown:
+      "## list\n\n`client.cart.list(cartId?: string, cursor?: string, limit?: number, tags?: object): { data: object[]; message: string; status: string; success: boolean; }`\n\n**get** `/cart`\n\nFetch a list of carts with optional filtering by cart ID or tags.\n\n### Parameters\n\n- `cartId?: string`\n  Filter by a specific cart ID\n\n- `cursor?: string`\n  Cursor returned from the previous response\n\n- `limit?: number`\n  Limit the number of results\n\n- `tags?: object`\n  Filter carts by key-value tags\n\n### Returns\n\n- `{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }[]; message: string; status: string; success: boolean; }`\n\n  - `data: { cartId: string; checkoutUrl: string; data: { items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]; settings?: { commissionFeeFixed?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }; tags?: object; }; metadata?: object; }[]`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst carts = await client.cart.list();\n\nconsole.log(carts);\n```",
+  },
+  {
+    name: 'delete',
+    endpoint: '/cart/{cartId}',
+    httpMethod: 'delete',
+    summary: 'Cart Delete',
+    description: 'Delete a cart by its unique identifier',
+    stainlessPath: '(resource) cart > (method) delete',
+    qualified: 'client.cart.delete',
+    params: ['cartId: string;'],
+    response:
+      '{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }',
+    markdown:
+      "## delete\n\n`client.cart.delete(cartId: string): { data: object; message: string; status: string; success: boolean; }`\n\n**delete** `/cart/{cartId}`\n\nDelete a cart by its unique identifier\n\n### Parameters\n\n- `cartId: string`\n  Unique identifier for the cart\n\n### Returns\n\n- `{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }`\n\n  - `data: { cartId: string; checkoutUrl: string; data: { items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]; settings?: { commissionFeeFixed?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }; tags?: object; }; metadata?: object; }`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst cart = await client.cart.delete('crt_sa2aEsCz9PRM');\n\nconsole.log(cart);\n```",
+  },
+  {
+    name: 'update',
+    endpoint: '/cart/{cartId}/item',
+    httpMethod: 'put',
+    summary: 'Cart Update Item',
+    description: 'Update an item in an existing cart.',
+    stainlessPath: '(resource) cart.item > (method) update',
+    qualified: 'client.cart.item.update',
+    params: [
+      'cartId: string;',
+      'item: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; };',
+    ],
+    response:
+      '{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }',
+    markdown:
+      "## update\n\n`client.cart.item.update(cartId: string, item: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }): { data: object; message: string; status: string; success: boolean; }`\n\n**put** `/cart/{cartId}/item`\n\nUpdate an item in an existing cart.\n\n### Parameters\n\n- `cartId: string`\n  Unique identifier for the cart\n\n- `item: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }`\n  Item to update\n  - `link: string`\n    Direct product URL\n  - `coupons?: string[]`\n    List of coupon codes applied to this cart item\n  - `metadata?: object`\n    Misc metadata associated with this cart item\n  - `quantity?: number`\n    Quantity of this item\n  - `shippingOption?: { id?: string; value?: string; }`\n    Shipping option selected for this cart item\n  - `variant?: string | object`\n    Variant selection. Can be a simple string or a key-value object\n\n### Returns\n\n- `{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }`\n\n  - `data: { cartId: string; checkoutUrl: string; data: { items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]; settings?: { commissionFeeFixed?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }; tags?: object; }; metadata?: object; }`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst item = await client.cart.item.update('crt_sa2aEsCz9PRM', { item: { link: 'https://www.nike.com/u/custom-nike-ja-3-by-you-10002205' } });\n\nconsole.log(item);\n```",
+  },
+  {
+    name: 'add',
+    endpoint: '/cart/{cartId}/item',
+    httpMethod: 'post',
+    summary: 'Cart Add Item',
+    description: 'Add an item to an existing cart.',
+    stainlessPath: '(resource) cart.item > (method) add',
+    qualified: 'client.cart.item.add',
+    params: [
+      'cartId: string;',
+      'item: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; };',
+    ],
+    response:
+      '{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }',
+    markdown:
+      "## add\n\n`client.cart.item.add(cartId: string, item: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }): { data: object; message: string; status: string; success: boolean; }`\n\n**post** `/cart/{cartId}/item`\n\nAdd an item to an existing cart.\n\n### Parameters\n\n- `cartId: string`\n  Unique identifier for the cart\n\n- `item: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }`\n  Item to add to the cart\n  - `link: string`\n    Direct product URL\n  - `coupons?: string[]`\n    List of coupon codes applied to this cart item\n  - `metadata?: object`\n    Misc metadata associated with this cart item\n  - `quantity?: number`\n    Quantity of this item\n  - `shippingOption?: { id?: string; value?: string; }`\n    Shipping option selected for this cart item\n  - `variant?: string | object`\n    Variant selection. Can be a simple string or a key-value object\n\n### Returns\n\n- `{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }`\n\n  - `data: { cartId: string; checkoutUrl: string; data: { items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]; settings?: { commissionFeeFixed?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }; tags?: object; }; metadata?: object; }`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.cart.item.add('crt_sa2aEsCz9PRM', { item: { link: 'https://www.nike.com/u/custom-nike-ja-3-by-you-10002205' } });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'remove',
+    endpoint: '/cart/{cartId}/item',
+    httpMethod: 'delete',
+    summary: 'Cart Remove item',
+    description: 'Remove an item from a cart by its unique identifier',
+    stainlessPath: '(resource) cart.item > (method) remove',
+    qualified: 'client.cart.item.remove',
+    params: ['cartId: string;', 'link: string;'],
+    response:
+      '{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }',
+    markdown:
+      "## remove\n\n`client.cart.item.remove(cartId: string, link: string): { data: object; message: string; status: string; success: boolean; }`\n\n**delete** `/cart/{cartId}/item`\n\nRemove an item from a cart by its unique identifier\n\n### Parameters\n\n- `cartId: string`\n  Unique identifier for the cart\n\n- `link: string`\n  Direct product URL\n\n### Returns\n\n- `{ data: { cartId: string; checkoutUrl: string; data: { items: object[]; settings?: object; tags?: object; }; metadata?: object; }; message: string; status: string; success: boolean; }`\n\n  - `data: { cartId: string; checkoutUrl: string; data: { items: { link: string; coupons?: string[]; metadata?: object; quantity?: number; shippingOption?: { id?: string; value?: string; }; variant?: string | object; }[]; settings?: { commissionFeeFixed?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; commissionFeePercent?: number; events?: { data: object | object | object | object | object | object | object | object[]; type: string; conditional?: object | object; }[]; options?: { allowPartialPurchase?: boolean; collectBuyerAddress?: 'off' | 'required' | 'optional'; collectBuyerEmail?: 'off' | 'required' | 'optional'; collectBuyerPhone?: 'off' | 'required' | 'optional'; }; }; tags?: object; }; metadata?: object; }`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst item = await client.cart.item.remove('crt_sa2aEsCz9PRM', { link: 'https://www.nike.com/u/custom-nike-ja-3-by-you-10002205' });\n\nconsole.log(item);\n```",
+  },
+  {
+    name: 'details',
+    endpoint: '/cart/{cartId}/details',
+    httpMethod: 'post',
+    summary: 'Cart Details',
+    description: 'Retrieve detailed information about a cart.',
+    stainlessPath: '(resource) cart.checkout > (method) details',
+    qualified: 'client.cart.checkout.details',
+    params: [
+      'cartId: string;',
+      'buyer: { shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; };',
+      'coupons?: string[];',
+      'metadata?: { botAuth?: { forterToken?: string; }; userData?: { ipAddress?: string; userAgent?: string; }; };',
+    ],
+    response:
+      "{ data: { jobs: { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }[]; metadata?: object; }; message: string; status: string; success: boolean; }",
+    markdown:
+      "## details\n\n`client.cart.checkout.details(cartId: string, buyer: { shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }, coupons?: string[], metadata?: { botAuth?: { forterToken?: string; }; userData?: { ipAddress?: string; userAgent?: string; }; }): { data: object; message: string; status: string; success: boolean; }`\n\n**post** `/cart/{cartId}/details`\n\nRetrieve detailed information about a cart.\n\n### Parameters\n\n- `cartId: string`\n  Unique identifier for the cart\n\n- `buyer: { shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }`\n  - `shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }`\n\n- `coupons?: string[]`\n  List of coupon codes applied to the cart\n\n- `metadata?: { botAuth?: { forterToken?: string; }; userData?: { ipAddress?: string; userAgent?: string; }; }`\n  Additional metadata for the request\n  - `botAuth?: { forterToken?: string; }`\n    Bot authentication credentials\n  - `userData?: { ipAddress?: string; userAgent?: string; }`\n    User identity and device information\n\n### Returns\n\n- `{ data: { jobs: { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }[]; metadata?: object; }; message: string; status: string; success: boolean; }`\n\n  - `data: { jobs: { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { items: { costs: object; shippingOptions: object[]; coupons?: object[]; metadata?: object; }[]; }; }[]; metadata?: object; }`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.cart.checkout.details('crt_sa2aEsCz9PRM', { buyer: { shippingAddress: {\n  city: 'Anytown',\n  countryCode: 'US',\n  line1: '123 Main St',\n  postalCode: '12345',\n  province: 'CA',\n} } });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'poll_details',
+    endpoint: '/cart/checkout/status',
+    httpMethod: 'get',
+    summary: 'Cart Details Status',
+    description: 'Check the status of a cart details retrieval job and get results when ready.',
+    stainlessPath: '(resource) cart.checkout > (method) poll_details',
+    qualified: 'client.cart.checkout.pollDetails',
+    params: ['refId: string;'],
+    response:
+      "{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { items: { costs: object; shippingOptions: object[]; coupons?: object[]; metadata?: object; }[]; }; }",
+    markdown:
+      "## poll_details\n\n`client.cart.checkout.pollDetails(refId: string): { refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: object; }`\n\n**get** `/cart/checkout/status`\n\nCheck the status of a cart details retrieval job and get results when ready.\n\n### Parameters\n\n- `refId: string`\n  Reference ID used for checking status\n\n### Returns\n\n- `{ refId: string; status: 'pending' | 'processing' | 'complete' | 'failed'; error?: object; result?: { items: { costs: object; shippingOptions: object[]; coupons?: object[]; metadata?: object; }[]; }; }`\n\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'failed'`\n  - `error?: object`\n  - `result?: { items: { costs: { subtotal: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; total: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; discount?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; shipping?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; tax?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; shippingOptions: { id: string; cost: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; name: string; maxDate?: string; minDate?: string; timeEstimate?: string; }[]; coupons?: { available: boolean; code: string; savedAmount?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }[]; metadata?: object; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.cart.checkout.pollDetails({ refId: 'ckd-ref_3fa85f64-5717-4562-b3fc' });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'poll_purchase',
+    endpoint: '/cart/purchase/status',
+    httpMethod: 'get',
+    summary: 'Cart Purchase Status',
+    description: 'Check the status of a cart purchase job and get results when ready.',
+    stainlessPath: '(resource) cart.checkout > (method) poll_purchase',
+    qualified: 'client.cart.checkout.pollPurchase',
+    params: ['refId: string;'],
+    response:
+      "{ details: { card: { details: object; nameOnCard: object; billingAddress?: object; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: { commissionFee: object; subtotal: object; total: object; }; items: { confirmationNumber: string; costs: object; productLink: string; appliedCoupon?: object; metadata?: object; shippingOption?: object; }[]; }; }",
+    markdown:
+      "## poll_purchase\n\n`client.cart.checkout.pollPurchase(refId: string): { details: object; products: object[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: object; }`\n\n**get** `/cart/purchase/status`\n\nCheck the status of a cart purchase job and get results when ready.\n\n### Parameters\n\n- `refId: string`\n  Reference ID used for checking status\n\n### Returns\n\n- `{ details: { card: { details: object; nameOnCard: object; billingAddress?: object; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: { commissionFee: object; subtotal: object; total: object; }; items: { confirmationNumber: string; costs: object; productLink: string; appliedCoupon?: object; metadata?: object; shippingOption?: object; }[]; }; }`\n\n  - `details: { card: { details: object; nameOnCard: { firstName: string; lastName: string; middleName?: string; }; billingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }`\n  - `products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]`\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'cancelled'`\n  - `error?: object`\n  - `result?: { costs: { commissionFee: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; subtotal: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; total: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; items: { confirmationNumber: string; costs: { total: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; discount?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; shipping?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; subtotal?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; tax?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; productLink: string; appliedCoupon?: { code: string; savedAmount?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; metadata?: object; shippingOption?: { id: string; cost: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; name: string; maxDate?: string; minDate?: string; timeEstimate?: string; }; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.cart.checkout.pollPurchase({ refId: 'ckp-ref_3fa85f64-5717-4562-b3fc' });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'purchase',
+    endpoint: '/cart/{cartId}/purchase',
+    httpMethod: 'post',
+    summary: 'Cart Purchase',
+    description: 'Initiate the purchase process for a cart.',
+    stainlessPath: '(resource) cart.checkout > (method) purchase',
+    qualified: 'client.cart.checkout.purchase',
+    params: [
+      'cartId: string;',
+      'buyer: { card: { details: { cardToken: string; }; billingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; nameOnCard?: { firstName: string; lastName: string; middleName?: string; }; }; email: string; name: { firstName: string; lastName: string; middleName?: string; }; shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; phone?: string; };',
+      'metadata?: { botAuth?: { forterToken?: string; }; userData?: { ipAddress?: string; userAgent?: string; }; };',
+      'overrideProducts?: object;',
+      'settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; };',
+    ],
+    response:
+      "{ details: { card: { details: object; nameOnCard: object; billingAddress?: object; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: { commissionFee: object; subtotal: object; total: object; }; items: { confirmationNumber: string; costs: object; productLink: string; appliedCoupon?: object; metadata?: object; shippingOption?: object; }[]; }; }",
+    markdown:
+      "## purchase\n\n`client.cart.checkout.purchase(cartId: string, buyer: { card: { details: object; billingAddress?: object; nameOnCard?: object; }; email: string; name: { firstName: string; lastName: string; middleName?: string; }; shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; phone?: string; }, metadata?: { botAuth?: { forterToken?: string; }; userData?: { ipAddress?: string; userAgent?: string; }; }, overrideProducts?: object, settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }): { details: object; products: object[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: object; }`\n\n**post** `/cart/{cartId}/purchase`\n\nInitiate the purchase process for a cart.\n\n### Parameters\n\n- `cartId: string`\n  Unique identifier for the cart\n\n- `buyer: { card: { details: { cardToken: string; }; billingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; nameOnCard?: { firstName: string; lastName: string; middleName?: string; }; }; email: string; name: { firstName: string; lastName: string; middleName?: string; }; shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; phone?: string; }`\n  - `card: { details: { cardToken: string; }; billingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; nameOnCard?: { firstName: string; lastName: string; middleName?: string; }; }`\n  - `email: string`\n    Buyer's email address\n  - `name: { firstName: string; lastName: string; middleName?: string; }`\n    Buyer's full name\n  - `shippingAddress: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }`\n  - `phone?: string`\n    Buyer's phone number\n\n- `metadata?: { botAuth?: { forterToken?: string; }; userData?: { ipAddress?: string; userAgent?: string; }; }`\n  Additional metadata for the request\n  - `botAuth?: { forterToken?: string; }`\n    Bot authentication credentials\n  - `userData?: { ipAddress?: string; userAgent?: string; }`\n    User identity and device information\n\n- `overrideProducts?: object`\n  Override quantity for a specific product URL\n\n- `settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }`\n  Settings for what information to collect\n  - `collectAddress?: boolean`\n    Whether to collect the buyer's shipping address\n  - `collectEmail?: boolean`\n    Whether to collect the buyer's email address\n  - `collectPhone?: boolean`\n    Whether to collect the buyer's phone number\n\n### Returns\n\n- `{ details: { card: { details: object; nameOnCard: object; billingAddress?: object; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: { commissionFee: object; subtotal: object; total: object; }; items: { confirmationNumber: string; costs: object; productLink: string; appliedCoupon?: object; metadata?: object; shippingOption?: object; }[]; }; }`\n\n  - `details: { card: { details: object; nameOnCard: { firstName: string; lastName: string; middleName?: string; }; billingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }`\n  - `products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]`\n  - `refId: string`\n  - `status: 'pending' | 'processing' | 'complete' | 'cancelled'`\n  - `error?: object`\n  - `result?: { costs: { commissionFee: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; subtotal: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; total: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; items: { confirmationNumber: string; costs: { total: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; discount?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; shipping?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; subtotal?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; tax?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; productLink: string; appliedCoupon?: { code: string; savedAmount?: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; metadata?: object; shippingOption?: { id: string; cost: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; name: string; maxDate?: string; minDate?: string; timeEstimate?: string; }; }[]; }`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst response = await client.cart.checkout.purchase('crt_sa2aEsCz9PRM', { buyer: {\n  card: { details: { cardToken: 'card_live_SimDpKU9cmU7tvdUXHzOeLudtgfadQVnbof' } },\n  email: 'johnadoe@example.com',\n  name: { firstName: 'John', lastName: 'Doe' },\n  shippingAddress: {\n  city: 'Anytown',\n  countryCode: 'US',\n  line1: '123 Main St',\n  postalCode: '12345',\n  province: 'CA',\n},\n} });\n\nconsole.log(response);\n```",
+  },
+  {
+    name: 'list',
+    endpoint: '/orders',
+    httpMethod: 'get',
+    summary: 'Orders Fetch',
+    description: 'Fetch a list of orders with optional filtering and pagination.',
+    stainlessPath: '(resource) orders > (method) list',
+    qualified: 'client.orders.list',
+    params: [
+      'cartId?: string;',
+      'cursor?: string;',
+      'limit?: number;',
+      "status?: 'pending' | 'processing' | 'complete' | 'cancelled';",
+    ],
+    response:
+      "{ data: { details: { card: object; hasAccount: boolean; name: object; email?: string; phone?: object; settings?: object; shippingAddress?: object; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: object; items: object[]; }; }[]; message: string; status: string; success: boolean; }",
+    markdown:
+      "## list\n\n`client.orders.list(cartId?: string, cursor?: string, limit?: number, status?: 'pending' | 'processing' | 'complete' | 'cancelled'): { data: object[]; message: string; status: string; success: boolean; }`\n\n**get** `/orders`\n\nFetch a list of orders with optional filtering and pagination.\n\n### Parameters\n\n- `cartId?: string`\n  Filter orders by cart ID\n\n- `cursor?: string`\n  Cursor returned from the previous response\n\n- `limit?: number`\n  Limit the number of results\n\n- `status?: 'pending' | 'processing' | 'complete' | 'cancelled'`\n  Filter orders by status\n\n### Returns\n\n- `{ data: { details: { card: object; hasAccount: boolean; name: object; email?: string; phone?: object; settings?: object; shippingAddress?: object; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: object; items: object[]; }; }[]; message: string; status: string; success: boolean; }`\n\n  - `data: { details: { card: { details: object; nameOnCard: { firstName: string; lastName: string; middleName?: string; }; billingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; hasAccount: boolean; name: { firstName: string; lastName: string; middleName?: string; }; email?: string; phone?: { countryCode: string; e164: string; nationalNumber: string; country?: string; }; settings?: { collectAddress?: boolean; collectEmail?: boolean; collectPhone?: boolean; }; shippingAddress?: { city: string; countryCode: string; line1: string; postalCode: string; province: string; line2?: string; }; }; products: { host: string; link: string; merchant: string; quantity: number; status: 'pending' | 'processing' | 'complete' | 'failed'; metadata?: object; variant?: string | object; }[]; refId: string; status: 'pending' | 'processing' | 'complete' | 'cancelled'; error?: object; result?: { costs: { commissionFee: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; subtotal: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; total: { currency: 'USD' | 'EUR' | 'AUD' | 'SGD' | 'TWD' | 'GBP' | 'CAD' | 'MXN'; value: number; }; }; items: { confirmationNumber: string; costs: { total: object; discount?: object; shipping?: object; subtotal?: object; tax?: object; }; productLink: string; appliedCoupon?: { code: string; savedAmount?: object; }; metadata?: object; shippingOption?: { id: string; cost: object; name: string; maxDate?: string; minDate?: string; timeEstimate?: string; }; }[]; }; }[]`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst orders = await client.orders.list();\n\nconsole.log(orders);\n```",
+  },
+  {
+    name: 'list',
+    endpoint: '/merchants',
+    httpMethod: 'get',
+    summary: 'Merchants Fetch',
+    description: 'Fetch a list of merchants with optional filtering and pagination.',
+    stainlessPath: '(resource) merchants > (method) list',
+    qualified: 'client.merchants.list',
+    params: [
+      'categories?: string[];',
+      'cursor?: string;',
+      'host?: string;',
+      'limit?: number;',
+      'name?: string;',
+    ],
+    response:
+      '{ data: { categories: string[]; description: string; host: string; logo: { urls: object[]; }; name: string; website: { urls: object[]; }; }[]; message: string; status: string; success: boolean; }',
+    markdown:
+      "## list\n\n`client.merchants.list(categories?: string[], cursor?: string, host?: string, limit?: number, name?: string): { data: object[]; message: string; status: string; success: boolean; }`\n\n**get** `/merchants`\n\nFetch a list of merchants with optional filtering and pagination.\n\n### Parameters\n\n- `categories?: string[]`\n  Filter merchants by categories\n\n- `cursor?: string`\n  Cursor returned from the previous response\n\n- `host?: string`\n  Filter merchants by host\n\n- `limit?: number`\n  Limit the number of results\n\n- `name?: string`\n  Filter merchants by name (partial match)\n\n### Returns\n\n- `{ data: { categories: string[]; description: string; host: string; logo: { urls: object[]; }; name: string; website: { urls: object[]; }; }[]; message: string; status: string; success: boolean; }`\n\n  - `data: { categories: string[]; description: string; host: string; logo: { urls: { value: string; }[]; }; name: string; website: { urls: { value: string; type?: 'landing' | 'checkout'; }[]; }; }[]`\n  - `message: string`\n  - `status: string`\n  - `success: boolean`\n\n### Example\n\n```typescript\nimport HenrySDK from '@henrylabs/sdk';\n\nconst client = new HenrySDK();\n\nconst merchants = await client.merchants.list();\n\nconsole.log(merchants);\n```",
+  },
+];
+
+const INDEX_OPTIONS = {
+  fields: [
+    'name',
+    'endpoint',
+    'summary',
+    'description',
+    'qualified',
+    'stainlessPath',
+    'content',
+    'sectionContext',
+  ],
+  storeFields: ['kind', '_original'],
+  searchOptions: {
+    prefix: true,
+    fuzzy: 0.2,
+    boost: {
+      name: 3,
+      endpoint: 2,
+      summary: 2,
+      qualified: 2,
+      content: 1,
+    } as Record<string, number>,
+  },
+};
+
+/**
+ * Self-contained local search engine backed by MiniSearch.
+ * Method data is embedded at SDK build time; prose documents
+ * can be loaded from an optional docs directory at runtime.
+ */
+export class LocalDocsSearch {
+  private methodIndex: MiniSearch<MiniSearchDocument>;
+  private proseIndex: MiniSearch<MiniSearchDocument>;
+
+  private constructor() {
+    this.methodIndex = new MiniSearch<MiniSearchDocument>(INDEX_OPTIONS);
+    this.proseIndex = new MiniSearch<MiniSearchDocument>(INDEX_OPTIONS);
+  }
+
+  static async create(opts?: { docsDir?: string }): Promise<LocalDocsSearch> {
+    const instance = new LocalDocsSearch();
+    instance.indexMethods(EMBEDDED_METHODS);
+    if (opts?.docsDir) {
+      await instance.loadDocsDirectory(opts.docsDir);
+    }
+    return instance;
+  }
+
+  // Note: Language is accepted for interface consistency with remote search, but currently has no
+  // effect since this local search only supports TypeScript docs.
+  search(props: {
+    query: string;
+    language?: string;
+    detail?: string;
+    maxResults?: number;
+    maxLength?: number;
+  }): SearchResult {
+    const { query, detail = 'default', maxResults = 5, maxLength = 100_000 } = props;
+
+    const useMarkdown = detail === 'verbose' || detail === 'high';
+
+    // Search both indices and merge results by score
+    const methodHits = this.methodIndex
+      .search(query)
+      .map((hit) => ({ ...hit, _kind: 'http_method' as const }));
+    const proseHits = this.proseIndex.search(query).map((hit) => ({ ...hit, _kind: 'prose' as const }));
+    const merged = [...methodHits, ...proseHits].sort((a, b) => b.score - a.score);
+    const top = merged.slice(0, maxResults);
+
+    const fullResults: (string | Record<string, unknown>)[] = [];
+
+    for (const hit of top) {
+      const original = (hit as Record<string, unknown>)['_original'];
+      if (hit._kind === 'http_method') {
+        const m = original as MethodEntry;
+        if (useMarkdown && m.markdown) {
+          fullResults.push(m.markdown);
+        } else {
+          fullResults.push({
+            method: m.qualified,
+            summary: m.summary,
+            description: m.description,
+            endpoint: `${m.httpMethod.toUpperCase()} ${m.endpoint}`,
+            ...(m.params ? { params: m.params } : {}),
+            ...(m.response ? { response: m.response } : {}),
+          });
+        }
+      } else {
+        const c = original as ProseChunk;
+        fullResults.push({
+          content: c.content,
+          ...(c.source ? { source: c.source } : {}),
+        });
+      }
+    }
+
+    let totalLength = 0;
+    const results: (string | Record<string, unknown>)[] = [];
+    for (const result of fullResults) {
+      const len = typeof result === 'string' ? result.length : JSON.stringify(result).length;
+      totalLength += len;
+      if (totalLength > maxLength) break;
+      results.push(result);
+    }
+
+    if (results.length < fullResults.length) {
+      results.unshift(`Truncated; showing ${results.length} of ${fullResults.length} results.`);
+    }
+
+    return { results };
+  }
+
+  private indexMethods(methods: MethodEntry[]): void {
+    const docs: MiniSearchDocument[] = methods.map((m, i) => ({
+      id: `method-${i}`,
+      kind: 'http_method' as const,
+      name: m.name,
+      endpoint: m.endpoint,
+      summary: m.summary,
+      description: m.description,
+      qualified: m.qualified,
+      stainlessPath: m.stainlessPath,
+      _original: m as unknown as Record<string, unknown>,
+    }));
+    if (docs.length > 0) {
+      this.methodIndex.addAll(docs);
+    }
+  }
+
+  private async loadDocsDirectory(docsDir: string): Promise<void> {
+    let entries;
+    try {
+      entries = await fs.readdir(docsDir, { withFileTypes: true });
+    } catch (err) {
+      getLogger().warn({ err, docsDir }, 'Could not read docs directory');
+      return;
+    }
+
+    const files = entries
+      .filter((e) => e.isFile())
+      .filter((e) => e.name.endsWith('.md') || e.name.endsWith('.markdown') || e.name.endsWith('.json'));
+
+    for (const file of files) {
+      try {
+        const filePath = path.join(docsDir, file.name);
+        const content = await fs.readFile(filePath, 'utf-8');
+
+        if (file.name.endsWith('.json')) {
+          const texts = extractTexts(JSON.parse(content));
+          if (texts.length > 0) {
+            this.indexProse(texts.join('\n\n'), file.name);
+          }
+        } else {
+          this.indexProse(content, file.name);
+        }
+      } catch (err) {
+        getLogger().warn({ err, file: file.name }, 'Failed to index docs file');
+      }
+    }
+  }
+
+  private indexProse(markdown: string, source: string): void {
+    const chunks = chunkMarkdown(markdown);
+    const baseId = this.proseIndex.documentCount;
+
+    const docs: MiniSearchDocument[] = chunks.map((chunk, i) => ({
+      id: `prose-${baseId + i}`,
+      kind: 'prose' as const,
+      content: chunk.content,
+      ...(chunk.sectionContext != null ? { sectionContext: chunk.sectionContext } : {}),
+      _original: { ...chunk, source } as unknown as Record<string, unknown>,
+    }));
+
+    if (docs.length > 0) {
+      this.proseIndex.addAll(docs);
+    }
+  }
+}
+
+/** Lightweight markdown chunker — splits on headers, chunks by word count. */
+function chunkMarkdown(markdown: string): { content: string; tag: string; sectionContext?: string }[] {
+  // Strip YAML frontmatter
+  const stripped = markdown.replace(/^---\n[\s\S]*?\n---\n?/, '');
+  const lines = stripped.split('\n');
+
+  const chunks: { content: string; tag: string; sectionContext?: string }[] = [];
+  const headers: string[] = [];
+  let current: string[] = [];
+
+  const flush = () => {
+    const text = current.join('\n').trim();
+    if (!text) return;
+    const sectionContext = headers.length > 0 ? headers.join(' > ') : undefined;
+    // Split into ~200-word chunks
+    const words = text.split(/\s+/);
+    for (let i = 0; i < words.length; i += 200) {
+      const slice = words.slice(i, i + 200).join(' ');
+      if (slice) {
+        chunks.push({ content: slice, tag: 'p', ...(sectionContext != null ? { sectionContext } : {}) });
+      }
+    }
+    current = [];
+  };
+
+  for (const line of lines) {
+    const headerMatch = line.match(/^(#{1,6})\s+(.+)/);
+    if (headerMatch) {
+      flush();
+      const level = headerMatch[1]!.length;
+      const text = headerMatch[2]!.trim();
+      while (headers.length >= level) headers.pop();
+      headers.push(text);
+    } else {
+      current.push(line);
+    }
+  }
+  flush();
+
+  return chunks;
+}
+
+/** Recursively extracts string values from a JSON structure. */
+function extractTexts(data: unknown, depth = 0): string[] {
+  if (depth > 10) return [];
+  if (typeof data === 'string') return data.trim() ? [data] : [];
+  if (Array.isArray(data)) return data.flatMap((item) => extractTexts(item, depth + 1));
+  if (typeof data === 'object' && data !== null) {
+    return Object.values(data).flatMap((v) => extractTexts(v, depth + 1));
+  }
+  return [];
+}