@trustrails/sdk 0.4.5 → 0.4.8

package/README.md

@@ -67,8 +67,9 @@ Search for products. Returns summary data (title, price, availability, category)
 - `options.category?: string` - Filter by product category (e.g., 'Laptops', 'Headphones')
 - `options.minPrice?: number` - Minimum price filter in GBP
 - `options.maxPrice?: number` - Maximum price filter in GBP
-- `options.lite?: boolean` - Return trimmed product objects with only essential fields (reduces payload by ~80%)
+- `options.lite?: boolean` - Return trimmed product objects with only essential fields including `offer_count` (reduces payload by ~80%)
 - `options.limit?: number` - Maximum number of results (default: 50, max: 100)
+- `options.sort?: string` - Sort order: `'relevance'` (default), `'price_asc'` (cheapest first), `'price_desc'` (most expensive first)
 
 **Returns:** Promise resolving to `SearchResponse` containing `products` array and `total` count.
 
@@ -80,7 +81,7 @@ const results = await trustrails.search({
   minPrice: 400,
   maxPrice: 1000,
   category: 'Laptops',
-  limit: 10
+  sort: 'price_asc'
 });
 ```
 
@@ -95,7 +96,7 @@ const results = await trustrails.search({
 
 ##### `product(id: string): Promise<Product>`
 
-Get full details for a single product. Returns complete technical specifications, full description, stock level, delivery time, and retailer source. Use this after `search()` to get detailed specs for comparison or recommendations.
+Get full details for a single product. Returns complete technical specifications including `specs.description` (full prose spec text with processor, RAM, storage, display, etc.), stock level, delivery time, and all retailer offers with per-retailer pricing. Accepts canonical product IDs or original retailer offer IDs. Use this after `search()` to get detailed specs for comparison or recommendations.
 
 **Parameters:**
 - `id: string` - The product ID
@@ -114,8 +115,8 @@ const product = await trustrails.product('prod_123');
 ```typescript
 interface Product {
   id: string;
+  ean?: string;
   title: string;
-  description?: string;
   brand?: string;
   price: number;
   currency: string;
@@ -126,13 +127,31 @@ interface Product {
   category: string;
   product_type: "product" | "accessory";
   specs: {
-    [key: string]: any;
+    description?: string;  // Full prose spec text — always check this for technical details
+    model_number?: string;
+    dimensions?: string;
   };
   provenance: {
     source: string;
     last_updated: string;
   };
   purchase_url: string;
+  offer_count?: number;  // number of retailer offers (when >1, call product() to compare prices)
+  offers?: Offer[];      // per-retailer offers sorted by price (returned by product())
+}
+
+interface Offer {
+  id: string;
+  source: string;
+  title: string;
+  price: number;
+  currency: string;
+  availability: "in_stock" | "low_stock" | "out_of_stock";
+  stock: number;
+  delivery_time: string;
+  purchase_url: string;
+  image_url?: string;
+  last_updated: string;
 }
 ```
 
@@ -147,6 +166,7 @@ interface SearchOptions {
   maxPrice?: number;
   lite?: boolean;
   limit?: number;
+  sort?: 'relevance' | 'price_asc' | 'price_desc';
 }
 ```
 

package/dist/index.d.mts

@@ -2,13 +2,29 @@
  * Product availability status
  */
 type Availability = "in_stock" | "low_stock" | "out_of_stock";
+/**
+ * Per-retailer offer for a product
+ */
+interface Offer {
+    id: string;
+    source: string;
+    title: string;
+    price: number;
+    currency: string;
+    availability: Availability;
+    stock: number;
+    delivery_time: string;
+    purchase_url: string;
+    image_url?: string;
+    last_updated: string;
+}
 /**
  * Product information returned by TrustRails API
  */
 interface Product {
     id: string;
+    ean?: string;
     title: string;
-    description?: string;
     brand?: string;
     price: number;
     currency: string;
@@ -19,16 +35,19 @@ interface Product {
     category: string;
     product_type: 'product' | 'accessory';
     specs: {
-        raw_category?: string;
+        description?: string;
         model_number?: string;
         dimensions?: string;
-        [key: string]: any;
     };
     provenance: {
         source: string;
         last_updated: string;
     };
     purchase_url: string;
+    /** Number of retailer offers available for this product */
+    offer_count?: number;
+    /** Per-retailer offers sorted by price (full mode / getProduct only) */
+    offers?: Offer[];
 }
 /**
  * Options for searching products
@@ -43,6 +62,8 @@ interface SearchOptions {
     lite?: boolean;
     /** Maximum number of products to return (default 50, max 100) */
     limit?: number;
+    /** Sort order: 'relevance' (default), 'price_asc' (cheapest first), 'price_desc' (most expensive first) */
+    sort?: 'relevance' | 'price_asc' | 'price_desc';
 }
 /**
  * Response from product search endpoint

package/dist/index.d.ts

@@ -2,13 +2,29 @@
  * Product availability status
  */
 type Availability = "in_stock" | "low_stock" | "out_of_stock";
+/**
+ * Per-retailer offer for a product
+ */
+interface Offer {
+    id: string;
+    source: string;
+    title: string;
+    price: number;
+    currency: string;
+    availability: Availability;
+    stock: number;
+    delivery_time: string;
+    purchase_url: string;
+    image_url?: string;
+    last_updated: string;
+}
 /**
  * Product information returned by TrustRails API
  */
 interface Product {
     id: string;
+    ean?: string;
     title: string;
-    description?: string;
     brand?: string;
     price: number;
     currency: string;
@@ -19,16 +35,19 @@ interface Product {
     category: string;
     product_type: 'product' | 'accessory';
     specs: {
-        raw_category?: string;
+        description?: string;
         model_number?: string;
         dimensions?: string;
-        [key: string]: any;
     };
     provenance: {
         source: string;
         last_updated: string;
     };
     purchase_url: string;
+    /** Number of retailer offers available for this product */
+    offer_count?: number;
+    /** Per-retailer offers sorted by price (full mode / getProduct only) */
+    offers?: Offer[];
 }
 /**
  * Options for searching products
@@ -43,6 +62,8 @@ interface SearchOptions {
     lite?: boolean;
     /** Maximum number of products to return (default 50, max 100) */
     limit?: number;
+    /** Sort order: 'relevance' (default), 'price_asc' (cheapest first), 'price_desc' (most expensive first) */
+    sort?: 'relevance' | 'price_asc' | 'price_desc';
 }
 /**
  * Response from product search endpoint

package/dist/index.js

@@ -74,6 +74,9 @@ var TrustRails = class {
     if (options.limit) {
       url.searchParams.set("limit", options.limit.toString());
     }
+    if (options.sort) {
+      url.searchParams.set("sort", options.sort);
+    }
     try {
       const response = await fetch(url.toString(), {
         method: "GET",

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":";;;;;AAGO,IAAM,eAAA,GAAN,MAAM,gBAAA,SAAwB,KAAA,CAAM;AAAA,EACzC,WAAA,CACE,OAAA,EACO,UAAA,EACA,QAAA,EACP;AACA,IAAA,KAAA,CAAM,OAAO,CAAA;AAHN,IAAA,IAAA,CAAA,UAAA,GAAA,UAAA;AACA,IAAA,IAAA,CAAA,QAAA,GAAA,QAAA;AAGP,IAAA,IAAA,CAAK,IAAA,GAAO,iBAAA;AAGZ,IAAA,IAAI,MAAM,iBAAA,EAAmB;AAC3B,MAAA,KAAA,CAAM,iBAAA,CAAkB,MAAM,gBAAe,CAAA;AAAA,IAC/C;AAAA,EACF;AACF;;;ACdA,IAAM,gBAAA,GAAmB,wBAAA;AAWlB,IAAM,aAAN,MAAiB;AAAA,EAgBtB,YAAY,cAAA,EAA2C;AACrD,IAAA,IAAI,OAAO,mBAAmB,QAAA,EAAU;AACtC,MAAA,IAAA,CAAK,MAAA,GAAS,cAAA;AACd,MAAA,IAAA,CAAK,OAAA,GAAU,gBAAA;AAAA,IACjB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,SAAS,cAAA,CAAe,MAAA;AAC7B,MAAA,IAAA,CAAK,OAAA,GAAU,eAAe,OAAA,IAAW,gBAAA;AAAA,IAC3C;AAGA,IAAA,IAAI,IAAA,CAAK,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,EAAG;AAC9B,MAAA,IAAA,CAAK,OAAA,GAAU,IAAA,CAAK,OAAA,CAAQ,KAAA,CAAM,GAAG,EAAE,CAAA;AAAA,IACzC;AAEA,IAAA,IAAI,CAAC,KAAK,MAAA,EAAQ;AAChB,MAAA,MAAM,IAAI,MAAM,oBAAoB,CAAA;AAAA,IACtC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAoBA,MAAM,MAAA,CAAO,OAAA,GAAyB,EAAC,EAA4B;AACjE,IAAA,MAAM,MAAM,IAAI,GAAA,CAAI,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,WAAA,CAAa,CAAA;AAEhD,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,OAAA,EAAS,OAAA,CAAQ,KAAK,CAAA;AAAA,IAC7C;AAEA,IAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,MAAA,GAAA,CAAI,aAAa,GAAA,CAAI,WAAA,EAAa,OAAA,CAAQ,QAAA,CAAS,UAAU,CAAA;AAAA,IAC/D;AAEA,IAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,MAAA,GAAA,CAAI,aAAa,GAAA,CAAI,WAAA,EAAa,OAAA,CAAQ,QAAA,CAAS,UAAU,CAAA;AAAA,IAC/D;AAEA,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,OAAA,EAAS,OAAA,CAAQ,KAAK,CAAA;AAAA,IAC7C;AAEA,IAAA,IAAI,QAAQ,QAAA,EAAU;AACpB,MAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,UAAA,EAAY,OAAA,CAAQ,QAAQ,CAAA;AAAA,IACnD;AAEA,IAAA,IAAI,QAAQ,IAAA,EAAM;AAChB,MAAA,GAAA,CAAI,YAAA,CAAa,GAAA,CAAI,MAAA,EAAQ,MAAM,CAAA;AAAA,IACrC;AAEA,IAAA,IAAI,QAAQ,KAAA,EAAO;AACjB,MAAA,GAAA,CAAI,aAAa,GAAA,CAAI,OAAA,EAAS,OAAA,CAAQ,KAAA,CAAM,UAAU,CAAA;AAAA,IACxD;AAEA,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,CAAI,UAAS,EAAG;AAAA,QAC3C,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA,CAAA;AAAA,UACtC,cAAA,EAAgB;AAAA;AAClB,OACD,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,MAAM,IAAI,eAAA;AAAA,UACR,CAAA,eAAA,EAAkB,SAAS,UAAU,CAAA,CAAA;AAAA,UACrC,QAAA,CAAS,MAAA;AAAA,UACT,MAAM,SAAS,IAAA;AAAK,SACtB;AAAA,MACF;AAEA,MAAA,MAAM,IAAA,GAAO,MAAM,QAAA,CAAS,IAAA,EAAK;AACjC,MAAA,OAAO,IAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,iBAAiB,eAAA,EAAiB;AACpC,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,MAAM,IAAI,eAAA;AAAA,QACR,CAAA,eAAA,EAAkB,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,eAAe,CAAA;AAAA,OAC5E;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAeA,MAAM,QAAQ,EAAA,EAA8B;AAC1C,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,MAAM,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,aAAA,EAAgB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAEjE,IAAA,IAAI;AACF,MAAA,MAAM,QAAA,GAAW,MAAM,KAAA,CAAM,GAAA,EAAK;AAAA,QAChC,MAAA,EAAQ,KAAA;AAAA,QACR,OAAA,EAAS;AAAA,UACP,eAAA,EAAiB,CAAA,OAAA,EAAU,IAAA,CAAK,MAAM,CAAA,CAAA;AAAA,UACtC,cAAA,EAAgB;AAAA;AAClB,OACD,CAAA;AAED,MAAA,IAAI,CAAC,SAAS,EAAA,EAAI;AAChB,QAAA,IAAI,QAAA,CAAS,WAAW,GAAA,EAAK;AAC3B,UAAA,MAAM,IAAI,eAAA,CAAgB,CAAA,mBAAA,EAAsB,EAAE,IAAI,GAAG,CAAA;AAAA,QAC3D;AACA,QAAA,MAAM,IAAI,eAAA;AAAA,UACR,CAAA,oBAAA,EAAuB,SAAS,UAAU,CAAA,CAAA;AAAA,UAC1C,QAAA,CAAS,MAAA;AAAA,UACT,MAAM,SAAS,IAAA;AAAK,SACtB;AAAA,MACF;AAEA,MAAA,MAAM,OAAA,GAAU,MAAM,QAAA,CAAS,IAAA,EAAK;AACpC,MAAA,OAAO,OAAA;AAAA,IACT,SAAS,KAAA,EAAO;AACd,MAAA,IAAI,iBAAiB,eAAA,EAAiB;AACpC,QAAA,MAAM,KAAA;AAAA,MACR;AACA,MAAA,MAAM,IAAI,eAAA;AAAA,QACR,CAAA,eAAA,EAAkB,KAAA,YAAiB,KAAA,GAAQ,KAAA,CAAM,UAAU,eAAe,CAAA;AAAA,OAC5E;AAAA,IACF;AAAA,EACF;AACF","file":"index.js","sourcesContent":["/**\n * Custom error class for TrustRails API errors\n */\nexport class TrustRailsError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public response?: any\n  ) {\n    super(message);\n    this.name = 'TrustRailsError';\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TrustRailsError);\n    }\n  }\n}\n","import { TrustRailsError } from './errors';\nimport type { Product, SearchOptions, SearchResponse, TrustRailsConfig } from './types';\n\nconst DEFAULT_BASE_URL = 'https://trustrails.app';\n\n/**\n * TrustRails SDK\n *\n * @example\n * ```typescript\n * const trustrails = new TrustRails('your-api-key');\n * const results = await trustrails.search({ query: 'laptop', maxPrice: 1000 });\n * ```\n */\nexport class TrustRails {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  /**\n   * Creates a new TrustRails SDK instance\n   *\n   * @param apiKey - Your TrustRails API key\n   */\n  constructor(apiKey: string);\n  /**\n   * Creates a new TrustRails SDK instance with custom configuration\n   *\n   * @param config - Configuration object with apiKey and optional baseUrl\n   */\n  constructor(config: TrustRailsConfig);\n  constructor(apiKeyOrConfig: string | TrustRailsConfig) {\n    if (typeof apiKeyOrConfig === 'string') {\n      this.apiKey = apiKeyOrConfig;\n      this.baseUrl = DEFAULT_BASE_URL;\n    } else {\n      this.apiKey = apiKeyOrConfig.apiKey;\n      this.baseUrl = apiKeyOrConfig.baseUrl || DEFAULT_BASE_URL;\n    }\n\n    // Clean up baseUrl - remove trailing slash\n    if (this.baseUrl.endsWith('/')) {\n      this.baseUrl = this.baseUrl.slice(0, -1);\n    }\n\n    if (!this.apiKey) {\n      throw new Error('apiKey is required');\n    }\n  }\n\n  /**\n   * Search for products. Returns summary data (title, price, availability, category).\n   * For full technical specs, call product(id) with the product ID.\n   *\n   * @param options - Search parameters\n   * @returns Promise resolving to search results\n   *\n   * @example\n   * ```typescript\n   * const results = await client.search({\n   *   query: 'USB-C charger',\n   *   brand: 'Anker',\n   *   minPrice: 20,\n   *   maxPrice: 50,\n   *   category: 'Chargers'\n   * });\n   * ```\n   */\n  async search(options: SearchOptions = {}): Promise<SearchResponse> {\n    const url = new URL(`${this.baseUrl}/api/search`);\n\n    if (options.query) {\n      url.searchParams.set('query', options.query);\n    }\n\n    if (options.minPrice) {\n      url.searchParams.set('min_price', options.minPrice.toString());\n    }\n\n    if (options.maxPrice) {\n      url.searchParams.set('max_price', options.maxPrice.toString());\n    }\n\n    if (options.brand) {\n      url.searchParams.set('brand', options.brand);\n    }\n\n    if (options.category) {\n      url.searchParams.set('category', options.category);\n    }\n\n    if (options.lite) {\n      url.searchParams.set('lite', 'true');\n    }\n\n    if (options.limit) {\n      url.searchParams.set('limit', options.limit.toString());\n    }\n\n    try {\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        throw new TrustRailsError(\n          `Search failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const data = await response.json() as SearchResponse;\n      return data;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  /**\n   * Get full details for a single product. Returns complete specs, description,\n   * stock level, delivery time, and retailer source. Use after search() for\n   * detailed comparison or recommendations.\n   *\n   * @param id - The product ID\n   * @returns Promise resolving to complete product details\n   *\n   * @example\n   * ```typescript\n   * const product = await client.product('prod_123');\n   * ```\n   */\n  async product(id: string): Promise<Product> {\n    if (!id) {\n      throw new Error('Product ID is required');\n    }\n\n    const url = `${this.baseUrl}/api/product/${encodeURIComponent(id)}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new TrustRailsError(`Product not found: ${id}`, 404);\n        }\n        throw new TrustRailsError(\n          `Get product failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const product = await response.json() as Product;\n      return product;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Custom error class for TrustRails API errors\n */\nexport class TrustRailsError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public response?: any\n  ) {\n    super(message);\n    this.name = 'TrustRailsError';\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TrustRailsError);\n    }\n  }\n}\n","import { TrustRailsError } from './errors';\nimport type { Product, SearchOptions, SearchResponse, TrustRailsConfig } from './types';\n\nconst DEFAULT_BASE_URL = 'https://trustrails.app';\n\n/**\n * TrustRails SDK\n *\n * @example\n * ```typescript\n * const trustrails = new TrustRails('your-api-key');\n * const results = await trustrails.search({ query: 'laptop', maxPrice: 1000 });\n * ```\n */\nexport class TrustRails {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  /**\n   * Creates a new TrustRails SDK instance\n   *\n   * @param apiKey - Your TrustRails API key\n   */\n  constructor(apiKey: string);\n  /**\n   * Creates a new TrustRails SDK instance with custom configuration\n   *\n   * @param config - Configuration object with apiKey and optional baseUrl\n   */\n  constructor(config: TrustRailsConfig);\n  constructor(apiKeyOrConfig: string | TrustRailsConfig) {\n    if (typeof apiKeyOrConfig === 'string') {\n      this.apiKey = apiKeyOrConfig;\n      this.baseUrl = DEFAULT_BASE_URL;\n    } else {\n      this.apiKey = apiKeyOrConfig.apiKey;\n      this.baseUrl = apiKeyOrConfig.baseUrl || DEFAULT_BASE_URL;\n    }\n\n    // Clean up baseUrl - remove trailing slash\n    if (this.baseUrl.endsWith('/')) {\n      this.baseUrl = this.baseUrl.slice(0, -1);\n    }\n\n    if (!this.apiKey) {\n      throw new Error('apiKey is required');\n    }\n  }\n\n  /**\n   * Search for products. Returns summary data (title, price, availability, category).\n   * For full technical specs, call product(id) with the product ID.\n   *\n   * @param options - Search parameters\n   * @returns Promise resolving to search results\n   *\n   * @example\n   * ```typescript\n   * const results = await client.search({\n   *   query: 'USB-C charger',\n   *   brand: 'Anker',\n   *   minPrice: 20,\n   *   maxPrice: 50,\n   *   category: 'Chargers'\n   * });\n   * ```\n   */\n  async search(options: SearchOptions = {}): Promise<SearchResponse> {\n    const url = new URL(`${this.baseUrl}/api/search`);\n\n    if (options.query) {\n      url.searchParams.set('query', options.query);\n    }\n\n    if (options.minPrice) {\n      url.searchParams.set('min_price', options.minPrice.toString());\n    }\n\n    if (options.maxPrice) {\n      url.searchParams.set('max_price', options.maxPrice.toString());\n    }\n\n    if (options.brand) {\n      url.searchParams.set('brand', options.brand);\n    }\n\n    if (options.category) {\n      url.searchParams.set('category', options.category);\n    }\n\n    if (options.lite) {\n      url.searchParams.set('lite', 'true');\n    }\n\n    if (options.limit) {\n      url.searchParams.set('limit', options.limit.toString());\n    }\n\n    if (options.sort) {\n      url.searchParams.set('sort', options.sort);\n    }\n\n    try {\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        throw new TrustRailsError(\n          `Search failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const data = await response.json() as SearchResponse;\n      return data;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  /**\n   * Get full details for a single product. Returns complete specs, description,\n   * stock level, delivery time, and retailer source. Use after search() for\n   * detailed comparison or recommendations.\n   *\n   * @param id - The product ID\n   * @returns Promise resolving to complete product details\n   *\n   * @example\n   * ```typescript\n   * const product = await client.product('prod_123');\n   * ```\n   */\n  async product(id: string): Promise<Product> {\n    if (!id) {\n      throw new Error('Product ID is required');\n    }\n\n    const url = `${this.baseUrl}/api/product/${encodeURIComponent(id)}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new TrustRailsError(`Product not found: ${id}`, 404);\n        }\n        throw new TrustRailsError(\n          `Get product failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const product = await response.json() as Product;\n      return product;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n}\n"]}

package/dist/index.mjs

@@ -70,6 +70,9 @@ var TrustRails = class {
     if (options.limit) {
       url.searchParams.set("limit", options.limit.toString());
     }
+    if (options.sort) {
+      url.searchParams.set("sort", options.sort);
+    }
     try {
       const response = await fetch(url.toString(), {
         method: "GET",

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Custom error class for TrustRails API errors\n */\nexport class TrustRailsError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public response?: any\n  ) {\n    super(message);\n    this.name = 'TrustRailsError';\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TrustRailsError);\n    }\n  }\n}\n","import { TrustRailsError } from './errors';\nimport type { Product, SearchOptions, SearchResponse, TrustRailsConfig } from './types';\n\nconst DEFAULT_BASE_URL = 'https://trustrails.app';\n\n/**\n * TrustRails SDK\n *\n * @example\n * ```typescript\n * const trustrails = new TrustRails('your-api-key');\n * const results = await trustrails.search({ query: 'laptop', maxPrice: 1000 });\n * ```\n */\nexport class TrustRails {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  /**\n   * Creates a new TrustRails SDK instance\n   *\n   * @param apiKey - Your TrustRails API key\n   */\n  constructor(apiKey: string);\n  /**\n   * Creates a new TrustRails SDK instance with custom configuration\n   *\n   * @param config - Configuration object with apiKey and optional baseUrl\n   */\n  constructor(config: TrustRailsConfig);\n  constructor(apiKeyOrConfig: string | TrustRailsConfig) {\n    if (typeof apiKeyOrConfig === 'string') {\n      this.apiKey = apiKeyOrConfig;\n      this.baseUrl = DEFAULT_BASE_URL;\n    } else {\n      this.apiKey = apiKeyOrConfig.apiKey;\n      this.baseUrl = apiKeyOrConfig.baseUrl || DEFAULT_BASE_URL;\n    }\n\n    // Clean up baseUrl - remove trailing slash\n    if (this.baseUrl.endsWith('/')) {\n      this.baseUrl = this.baseUrl.slice(0, -1);\n    }\n\n    if (!this.apiKey) {\n      throw new Error('apiKey is required');\n    }\n  }\n\n  /**\n   * Search for products. Returns summary data (title, price, availability, category).\n   * For full technical specs, call product(id) with the product ID.\n   *\n   * @param options - Search parameters\n   * @returns Promise resolving to search results\n   *\n   * @example\n   * ```typescript\n   * const results = await client.search({\n   *   query: 'USB-C charger',\n   *   brand: 'Anker',\n   *   minPrice: 20,\n   *   maxPrice: 50,\n   *   category: 'Chargers'\n   * });\n   * ```\n   */\n  async search(options: SearchOptions = {}): Promise<SearchResponse> {\n    const url = new URL(`${this.baseUrl}/api/search`);\n\n    if (options.query) {\n      url.searchParams.set('query', options.query);\n    }\n\n    if (options.minPrice) {\n      url.searchParams.set('min_price', options.minPrice.toString());\n    }\n\n    if (options.maxPrice) {\n      url.searchParams.set('max_price', options.maxPrice.toString());\n    }\n\n    if (options.brand) {\n      url.searchParams.set('brand', options.brand);\n    }\n\n    if (options.category) {\n      url.searchParams.set('category', options.category);\n    }\n\n    if (options.lite) {\n      url.searchParams.set('lite', 'true');\n    }\n\n    if (options.limit) {\n      url.searchParams.set('limit', options.limit.toString());\n    }\n\n    try {\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        throw new TrustRailsError(\n          `Search failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const data = await response.json() as SearchResponse;\n      return data;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  /**\n   * Get full details for a single product. Returns complete specs, description,\n   * stock level, delivery time, and retailer source. Use after search() for\n   * detailed comparison or recommendations.\n   *\n   * @param id - The product ID\n   * @returns Promise resolving to complete product details\n   *\n   * @example\n   * ```typescript\n   * const product = await client.product('prod_123');\n   * ```\n   */\n  async product(id: string): Promise<Product> {\n    if (!id) {\n      throw new Error('Product ID is required');\n    }\n\n    const url = `${this.baseUrl}/api/product/${encodeURIComponent(id)}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new TrustRailsError(`Product not found: ${id}`, 404);\n        }\n        throw new TrustRailsError(\n          `Get product failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const product = await response.json() as Product;\n      return product;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n}\n"]}
+{"version":3,"sources":["../src/errors.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Custom error class for TrustRails API errors\n */\nexport class TrustRailsError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public response?: any\n  ) {\n    super(message);\n    this.name = 'TrustRailsError';\n\n    // Maintains proper stack trace for where our error was thrown (only available on V8)\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, TrustRailsError);\n    }\n  }\n}\n","import { TrustRailsError } from './errors';\nimport type { Product, SearchOptions, SearchResponse, TrustRailsConfig } from './types';\n\nconst DEFAULT_BASE_URL = 'https://trustrails.app';\n\n/**\n * TrustRails SDK\n *\n * @example\n * ```typescript\n * const trustrails = new TrustRails('your-api-key');\n * const results = await trustrails.search({ query: 'laptop', maxPrice: 1000 });\n * ```\n */\nexport class TrustRails {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  /**\n   * Creates a new TrustRails SDK instance\n   *\n   * @param apiKey - Your TrustRails API key\n   */\n  constructor(apiKey: string);\n  /**\n   * Creates a new TrustRails SDK instance with custom configuration\n   *\n   * @param config - Configuration object with apiKey and optional baseUrl\n   */\n  constructor(config: TrustRailsConfig);\n  constructor(apiKeyOrConfig: string | TrustRailsConfig) {\n    if (typeof apiKeyOrConfig === 'string') {\n      this.apiKey = apiKeyOrConfig;\n      this.baseUrl = DEFAULT_BASE_URL;\n    } else {\n      this.apiKey = apiKeyOrConfig.apiKey;\n      this.baseUrl = apiKeyOrConfig.baseUrl || DEFAULT_BASE_URL;\n    }\n\n    // Clean up baseUrl - remove trailing slash\n    if (this.baseUrl.endsWith('/')) {\n      this.baseUrl = this.baseUrl.slice(0, -1);\n    }\n\n    if (!this.apiKey) {\n      throw new Error('apiKey is required');\n    }\n  }\n\n  /**\n   * Search for products. Returns summary data (title, price, availability, category).\n   * For full technical specs, call product(id) with the product ID.\n   *\n   * @param options - Search parameters\n   * @returns Promise resolving to search results\n   *\n   * @example\n   * ```typescript\n   * const results = await client.search({\n   *   query: 'USB-C charger',\n   *   brand: 'Anker',\n   *   minPrice: 20,\n   *   maxPrice: 50,\n   *   category: 'Chargers'\n   * });\n   * ```\n   */\n  async search(options: SearchOptions = {}): Promise<SearchResponse> {\n    const url = new URL(`${this.baseUrl}/api/search`);\n\n    if (options.query) {\n      url.searchParams.set('query', options.query);\n    }\n\n    if (options.minPrice) {\n      url.searchParams.set('min_price', options.minPrice.toString());\n    }\n\n    if (options.maxPrice) {\n      url.searchParams.set('max_price', options.maxPrice.toString());\n    }\n\n    if (options.brand) {\n      url.searchParams.set('brand', options.brand);\n    }\n\n    if (options.category) {\n      url.searchParams.set('category', options.category);\n    }\n\n    if (options.lite) {\n      url.searchParams.set('lite', 'true');\n    }\n\n    if (options.limit) {\n      url.searchParams.set('limit', options.limit.toString());\n    }\n\n    if (options.sort) {\n      url.searchParams.set('sort', options.sort);\n    }\n\n    try {\n      const response = await fetch(url.toString(), {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        throw new TrustRailsError(\n          `Search failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const data = await response.json() as SearchResponse;\n      return data;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  /**\n   * Get full details for a single product. Returns complete specs, description,\n   * stock level, delivery time, and retailer source. Use after search() for\n   * detailed comparison or recommendations.\n   *\n   * @param id - The product ID\n   * @returns Promise resolving to complete product details\n   *\n   * @example\n   * ```typescript\n   * const product = await client.product('prod_123');\n   * ```\n   */\n  async product(id: string): Promise<Product> {\n    if (!id) {\n      throw new Error('Product ID is required');\n    }\n\n    const url = `${this.baseUrl}/api/product/${encodeURIComponent(id)}`;\n\n    try {\n      const response = await fetch(url, {\n        method: 'GET',\n        headers: {\n          'Authorization': `Bearer ${this.apiKey}`,\n          'Content-Type': 'application/json',\n        },\n      });\n\n      if (!response.ok) {\n        if (response.status === 404) {\n          throw new TrustRailsError(`Product not found: ${id}`, 404);\n        }\n        throw new TrustRailsError(\n          `Get product failed: ${response.statusText}`,\n          response.status,\n          await response.text()\n        );\n      }\n\n      const product = await response.json() as Product;\n      return product;\n    } catch (error) {\n      if (error instanceof TrustRailsError) {\n        throw error;\n      }\n      throw new TrustRailsError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n}\n"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trustrails/sdk",
-  "version": "0.4.5",
+  "version": "0.4.8",
   "description": "Official TypeScript SDK for TrustRails API",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",