@trustrails/sdk 0.4.6 → 0.4.8

package/README.md

@@ -67,7 +67,7 @@ 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)
 
@@ -96,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
@@ -115,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;
@@ -127,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;
 }
 ```
 

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

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

package/package.json

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