@trustrails/sdk 0.1.0

package/README.md

@@ -0,0 +1,155 @@
+# TrustRails TypeScript SDK
+
+Official TypeScript/JavaScript client library for the TrustRails API.
+
+## Installation
+
+```bash
+npm install trustrails
+```
+
+## Quick Start
+
+```typescript
+import { TrustRailsClient } from 'trustrails';
+
+// Initialize the client
+const client = new TrustRailsClient(
+  'https://api.trustrails.com',
+  'your-api-key'
+);
+
+// Search for products
+const results = await client.search({
+  query: 'USB-C charger',
+  maxPrice: 50
+});
+
+console.log(`Found ${results.total} products`);
+results.products.forEach(product => {
+  console.log(`${product.title} - $${product.price}`);
+});
+
+// Get a specific product
+const product = await client.getProduct('product-id');
+console.log(product);
+```
+
+## API Reference
+
+### `TrustRailsClient`
+
+#### Constructor
+
+```typescript
+new TrustRailsClient(baseUrl: string, apiKey: string)
+```
+
+Or use a config object:
+
+```typescript
+new TrustRailsClient({ baseUrl: string, apiKey: string })
+```
+
+**Parameters:**
+- `baseUrl` - The base URL of the TrustRails API
+- `apiKey` - Your TrustRails API key
+
+#### Methods
+
+##### `search(options?: SearchOptions): Promise<SearchResponse>`
+
+Search for products.
+
+**Parameters:**
+- `options.query?: string` - Search query string
+- `options.maxPrice?: number` - Maximum price filter
+
+**Returns:** Promise resolving to `SearchResponse` containing `products` array and `total` count.
+
+**Example:**
+```typescript
+const results = await client.search({
+  query: 'laptop',
+  maxPrice: 1000
+});
+```
+
+##### `getProduct(id: string): Promise<Product>`
+
+Get a specific product by ID.
+
+**Parameters:**
+- `id: string` - The product ID
+
+**Returns:** Promise resolving to `Product` object.
+
+**Example:**
+```typescript
+const product = await client.getProduct('prod_123');
+```
+
+## Types
+
+### `Product`
+
+```typescript
+interface Product {
+  id: string;
+  title: string;
+  brand?: string;
+  price: number;
+  currency: string;
+  availability: "in_stock" | "low_stock" | "out_of_stock";
+  stock: number;
+  delivery_time: string;
+  image_url?: string;
+  specs: {
+    [key: string]: any;
+  };
+  provenance: {
+    source: string;
+    last_updated: string;
+  };
+  purchase_url: string;
+}
+```
+
+### `SearchOptions`
+
+```typescript
+interface SearchOptions {
+  query?: string;
+  maxPrice?: number;
+}
+```
+
+### `SearchResponse`
+
+```typescript
+interface SearchResponse {
+  products: Product[];
+  total: number;
+}
+```
+
+## Error Handling
+
+The SDK throws `TrustRailsError` for API-related errors:
+
+```typescript
+import { TrustRailsClient, TrustRailsError } from 'trustrails';
+
+try {
+  const product = await client.getProduct('invalid-id');
+} catch (error) {
+  if (error instanceof TrustRailsError) {
+    console.error(`API Error: ${error.message}`);
+    console.error(`Status Code: ${error.statusCode}`);
+  }
+}
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,107 @@
+/**
+ * Product information returned by TrustRails API
+ */
+interface Product {
+    id: string;
+    title: string;
+    brand?: string;
+    price: number;
+    currency: string;
+    availability: "in_stock" | "low_stock" | "out_of_stock";
+    stock: number;
+    delivery_time: string;
+    image_url?: string;
+    specs: {
+        wattage?: number;
+        ports?: number;
+        cable_length?: string;
+        pd_version?: string;
+        [key: string]: any;
+    };
+    provenance: {
+        source: string;
+        last_updated: string;
+    };
+    purchase_url: string;
+}
+/**
+ * Options for searching products
+ */
+interface SearchOptions {
+    query?: string;
+    maxPrice?: number;
+}
+/**
+ * Response from product search endpoint
+ */
+interface SearchResponse {
+    products: Product[];
+    total: number;
+}
+/**
+ * Configuration options for TrustRails client
+ */
+interface TrustRailsConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+
+/**
+ * TrustRails API Client
+ *
+ * @example
+ * ```typescript
+ * const client = new TrustRailsClient('https://api.trustrails.com', 'your-api-key');
+ * const results = await client.search({ query: 'laptop', maxPrice: 1000 });
+ * ```
+ */
+declare class TrustRailsClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    /**
+     * Creates a new TrustRails API client
+     *
+     * @param baseUrl - The base URL of the TrustRails API
+     * @param apiKey - Your TrustRails API key
+     */
+    constructor(baseUrl: string, apiKey: string);
+    constructor(config: TrustRailsConfig);
+    /**
+     * Search for products
+     *
+     * @param options - Search parameters
+     * @returns Promise resolving to search results
+     *
+     * @example
+     * ```typescript
+     * const results = await client.search({
+     *   query: 'USB-C charger',
+     *   maxPrice: 50
+     * });
+     * ```
+     */
+    search(options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Get a specific product by ID
+     *
+     * @param id - The product ID
+     * @returns Promise resolving to product details
+     *
+     * @example
+     * ```typescript
+     * const product = await client.getProduct('prod_123');
+     * ```
+     */
+    getProduct(id: string): Promise<Product>;
+}
+
+/**
+ * Custom error class for TrustRails API errors
+ */
+declare class TrustRailsError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+
+export { type Product, type SearchOptions, type SearchResponse, TrustRailsClient, type TrustRailsConfig, TrustRailsError };

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+/**
+ * Product information returned by TrustRails API
+ */
+interface Product {
+    id: string;
+    title: string;
+    brand?: string;
+    price: number;
+    currency: string;
+    availability: "in_stock" | "low_stock" | "out_of_stock";
+    stock: number;
+    delivery_time: string;
+    image_url?: string;
+    specs: {
+        wattage?: number;
+        ports?: number;
+        cable_length?: string;
+        pd_version?: string;
+        [key: string]: any;
+    };
+    provenance: {
+        source: string;
+        last_updated: string;
+    };
+    purchase_url: string;
+}
+/**
+ * Options for searching products
+ */
+interface SearchOptions {
+    query?: string;
+    maxPrice?: number;
+}
+/**
+ * Response from product search endpoint
+ */
+interface SearchResponse {
+    products: Product[];
+    total: number;
+}
+/**
+ * Configuration options for TrustRails client
+ */
+interface TrustRailsConfig {
+    baseUrl: string;
+    apiKey: string;
+}
+
+/**
+ * TrustRails API Client
+ *
+ * @example
+ * ```typescript
+ * const client = new TrustRailsClient('https://api.trustrails.com', 'your-api-key');
+ * const results = await client.search({ query: 'laptop', maxPrice: 1000 });
+ * ```
+ */
+declare class TrustRailsClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    /**
+     * Creates a new TrustRails API client
+     *
+     * @param baseUrl - The base URL of the TrustRails API
+     * @param apiKey - Your TrustRails API key
+     */
+    constructor(baseUrl: string, apiKey: string);
+    constructor(config: TrustRailsConfig);
+    /**
+     * Search for products
+     *
+     * @param options - Search parameters
+     * @returns Promise resolving to search results
+     *
+     * @example
+     * ```typescript
+     * const results = await client.search({
+     *   query: 'USB-C charger',
+     *   maxPrice: 50
+     * });
+     * ```
+     */
+    search(options?: SearchOptions): Promise<SearchResponse>;
+    /**
+     * Get a specific product by ID
+     *
+     * @param id - The product ID
+     * @returns Promise resolving to product details
+     *
+     * @example
+     * ```typescript
+     * const product = await client.getProduct('prod_123');
+     * ```
+     */
+    getProduct(id: string): Promise<Product>;
+}
+
+/**
+ * Custom error class for TrustRails API errors
+ */
+declare class TrustRailsError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+
+export { type Product, type SearchOptions, type SearchResponse, TrustRailsClient, type TrustRailsConfig, TrustRailsError };

package/dist/index.js

@@ -0,0 +1,131 @@
+'use strict';
+
+// src/errors.ts
+var TrustRailsError = class _TrustRailsError extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "TrustRailsError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _TrustRailsError);
+    }
+  }
+};
+
+// src/client.ts
+var TrustRailsClient = class {
+  constructor(baseUrlOrConfig, apiKey) {
+    if (typeof baseUrlOrConfig === "string") {
+      this.baseUrl = baseUrlOrConfig.endsWith("/") ? baseUrlOrConfig.slice(0, -1) : baseUrlOrConfig;
+      this.apiKey = apiKey;
+    } else {
+      this.baseUrl = baseUrlOrConfig.baseUrl.endsWith("/") ? baseUrlOrConfig.baseUrl.slice(0, -1) : baseUrlOrConfig.baseUrl;
+      this.apiKey = baseUrlOrConfig.apiKey;
+    }
+    if (!this.baseUrl) {
+      throw new Error("baseUrl is required");
+    }
+    if (!this.apiKey) {
+      throw new Error("apiKey is required");
+    }
+  }
+  /**
+   * Search for products
+   *
+   * @param options - Search parameters
+   * @returns Promise resolving to search results
+   *
+   * @example
+   * ```typescript
+   * const results = await client.search({
+   *   query: 'USB-C charger',
+   *   maxPrice: 50
+   * });
+   * ```
+   */
+  async search(options = {}) {
+    const url = new URL(`${this.baseUrl}/api/search`);
+    if (options.query) {
+      url.searchParams.set("query", options.query);
+    }
+    if (options.maxPrice) {
+      url.searchParams.set("max_price", options.maxPrice.toString());
+    }
+    try {
+      const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        }
+      });
+      if (!response.ok) {
+        throw new TrustRailsError(
+          `Search failed: ${response.statusText}`,
+          response.status,
+          await response.text()
+        );
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      if (error instanceof TrustRailsError) {
+        throw error;
+      }
+      throw new TrustRailsError(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+  /**
+   * Get a specific product by ID
+   *
+   * @param id - The product ID
+   * @returns Promise resolving to product details
+   *
+   * @example
+   * ```typescript
+   * const product = await client.getProduct('prod_123');
+   * ```
+   */
+  async getProduct(id) {
+    if (!id) {
+      throw new Error("Product ID is required");
+    }
+    const url = `${this.baseUrl}/api/products/${encodeURIComponent(id)}`;
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        }
+      });
+      if (!response.ok) {
+        if (response.status === 404) {
+          throw new TrustRailsError(`Product not found: ${id}`, 404);
+        }
+        throw new TrustRailsError(
+          `Get product failed: ${response.statusText}`,
+          response.status,
+          await response.text()
+        );
+      }
+      const product = await response.json();
+      return product;
+    } catch (error) {
+      if (error instanceof TrustRailsError) {
+        throw error;
+      }
+      throw new TrustRailsError(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+};
+
+exports.TrustRailsClient = TrustRailsClient;
+exports.TrustRailsError = TrustRailsError;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"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\n/**\n * TrustRails API Client\n *\n * @example\n * ```typescript\n * const client = new TrustRailsClient('https://api.trustrails.com', 'your-api-key');\n * const results = await client.search({ query: 'laptop', maxPrice: 1000 });\n * ```\n */\nexport class TrustRailsClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  /**\n   * Creates a new TrustRails API client\n   *\n   * @param baseUrl - The base URL of the TrustRails API\n   * @param apiKey - Your TrustRails API key\n   */\n  constructor(baseUrl: string, apiKey: string);\n  constructor(config: TrustRailsConfig);\n  constructor(baseUrlOrConfig: string | TrustRailsConfig, apiKey?: string) {\n    if (typeof baseUrlOrConfig === 'string') {\n      this.baseUrl = baseUrlOrConfig.endsWith('/')\n        ? baseUrlOrConfig.slice(0, -1)\n        : baseUrlOrConfig;\n      this.apiKey = apiKey!;\n    } else {\n      this.baseUrl = baseUrlOrConfig.baseUrl.endsWith('/')\n        ? baseUrlOrConfig.baseUrl.slice(0, -1)\n        : baseUrlOrConfig.baseUrl;\n      this.apiKey = baseUrlOrConfig.apiKey;\n    }\n\n    if (!this.baseUrl) {\n      throw new Error('baseUrl is required');\n    }\n    if (!this.apiKey) {\n      throw new Error('apiKey is required');\n    }\n  }\n\n  /**\n   * Search for products\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   *   maxPrice: 50\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.maxPrice) {\n      url.searchParams.set('max_price', options.maxPrice.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 a specific product by ID\n   *\n   * @param id - The product ID\n   * @returns Promise resolving to product details\n   *\n   * @example\n   * ```typescript\n   * const product = await client.getProduct('prod_123');\n   * ```\n   */\n  async getProduct(id: string): Promise<Product> {\n    if (!id) {\n      throw new Error('Product ID is required');\n    }\n\n    const url = `${this.baseUrl}/api/products/${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

@@ -0,0 +1,128 @@
+// src/errors.ts
+var TrustRailsError = class _TrustRailsError extends Error {
+  constructor(message, statusCode, response) {
+    super(message);
+    this.statusCode = statusCode;
+    this.response = response;
+    this.name = "TrustRailsError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, _TrustRailsError);
+    }
+  }
+};
+
+// src/client.ts
+var TrustRailsClient = class {
+  constructor(baseUrlOrConfig, apiKey) {
+    if (typeof baseUrlOrConfig === "string") {
+      this.baseUrl = baseUrlOrConfig.endsWith("/") ? baseUrlOrConfig.slice(0, -1) : baseUrlOrConfig;
+      this.apiKey = apiKey;
+    } else {
+      this.baseUrl = baseUrlOrConfig.baseUrl.endsWith("/") ? baseUrlOrConfig.baseUrl.slice(0, -1) : baseUrlOrConfig.baseUrl;
+      this.apiKey = baseUrlOrConfig.apiKey;
+    }
+    if (!this.baseUrl) {
+      throw new Error("baseUrl is required");
+    }
+    if (!this.apiKey) {
+      throw new Error("apiKey is required");
+    }
+  }
+  /**
+   * Search for products
+   *
+   * @param options - Search parameters
+   * @returns Promise resolving to search results
+   *
+   * @example
+   * ```typescript
+   * const results = await client.search({
+   *   query: 'USB-C charger',
+   *   maxPrice: 50
+   * });
+   * ```
+   */
+  async search(options = {}) {
+    const url = new URL(`${this.baseUrl}/api/search`);
+    if (options.query) {
+      url.searchParams.set("query", options.query);
+    }
+    if (options.maxPrice) {
+      url.searchParams.set("max_price", options.maxPrice.toString());
+    }
+    try {
+      const response = await fetch(url.toString(), {
+        method: "GET",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        }
+      });
+      if (!response.ok) {
+        throw new TrustRailsError(
+          `Search failed: ${response.statusText}`,
+          response.status,
+          await response.text()
+        );
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      if (error instanceof TrustRailsError) {
+        throw error;
+      }
+      throw new TrustRailsError(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+  /**
+   * Get a specific product by ID
+   *
+   * @param id - The product ID
+   * @returns Promise resolving to product details
+   *
+   * @example
+   * ```typescript
+   * const product = await client.getProduct('prod_123');
+   * ```
+   */
+  async getProduct(id) {
+    if (!id) {
+      throw new Error("Product ID is required");
+    }
+    const url = `${this.baseUrl}/api/products/${encodeURIComponent(id)}`;
+    try {
+      const response = await fetch(url, {
+        method: "GET",
+        headers: {
+          "Authorization": `Bearer ${this.apiKey}`,
+          "Content-Type": "application/json"
+        }
+      });
+      if (!response.ok) {
+        if (response.status === 404) {
+          throw new TrustRailsError(`Product not found: ${id}`, 404);
+        }
+        throw new TrustRailsError(
+          `Get product failed: ${response.statusText}`,
+          response.status,
+          await response.text()
+        );
+      }
+      const product = await response.json();
+      return product;
+    } catch (error) {
+      if (error instanceof TrustRailsError) {
+        throw error;
+      }
+      throw new TrustRailsError(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+};
+
+export { TrustRailsClient, TrustRailsError };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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;;;ACLO,IAAM,mBAAN,MAAuB;AAAA,EAY5B,WAAA,CAAY,iBAA4C,MAAA,EAAiB;AACvE,IAAA,IAAI,OAAO,oBAAoB,QAAA,EAAU;AACvC,MAAA,IAAA,CAAK,OAAA,GAAU,gBAAgB,QAAA,CAAS,GAAG,IACvC,eAAA,CAAgB,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GAC3B,eAAA;AACJ,MAAA,IAAA,CAAK,MAAA,GAAS,MAAA;AAAA,IAChB,CAAA,MAAO;AACL,MAAA,IAAA,CAAK,OAAA,GAAU,eAAA,CAAgB,OAAA,CAAQ,QAAA,CAAS,GAAG,CAAA,GAC/C,eAAA,CAAgB,OAAA,CAAQ,KAAA,CAAM,CAAA,EAAG,EAAE,CAAA,GACnC,eAAA,CAAgB,OAAA;AACpB,MAAA,IAAA,CAAK,SAAS,eAAA,CAAgB,MAAA;AAAA,IAChC;AAEA,IAAA,IAAI,CAAC,KAAK,OAAA,EAAS;AACjB,MAAA,MAAM,IAAI,MAAM,qBAAqB,CAAA;AAAA,IACvC;AACA,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,EAgBA,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;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,EAaA,MAAM,WAAW,EAAA,EAA8B;AAC7C,IAAA,IAAI,CAAC,EAAA,EAAI;AACP,MAAA,MAAM,IAAI,MAAM,wBAAwB,CAAA;AAAA,IAC1C;AAEA,IAAA,MAAM,MAAM,CAAA,EAAG,IAAA,CAAK,OAAO,CAAA,cAAA,EAAiB,kBAAA,CAAmB,EAAE,CAAC,CAAA,CAAA;AAElE,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.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\n/**\n * TrustRails API Client\n *\n * @example\n * ```typescript\n * const client = new TrustRailsClient('https://api.trustrails.com', 'your-api-key');\n * const results = await client.search({ query: 'laptop', maxPrice: 1000 });\n * ```\n */\nexport class TrustRailsClient {\n  private readonly baseUrl: string;\n  private readonly apiKey: string;\n\n  /**\n   * Creates a new TrustRails API client\n   *\n   * @param baseUrl - The base URL of the TrustRails API\n   * @param apiKey - Your TrustRails API key\n   */\n  constructor(baseUrl: string, apiKey: string);\n  constructor(config: TrustRailsConfig);\n  constructor(baseUrlOrConfig: string | TrustRailsConfig, apiKey?: string) {\n    if (typeof baseUrlOrConfig === 'string') {\n      this.baseUrl = baseUrlOrConfig.endsWith('/')\n        ? baseUrlOrConfig.slice(0, -1)\n        : baseUrlOrConfig;\n      this.apiKey = apiKey!;\n    } else {\n      this.baseUrl = baseUrlOrConfig.baseUrl.endsWith('/')\n        ? baseUrlOrConfig.baseUrl.slice(0, -1)\n        : baseUrlOrConfig.baseUrl;\n      this.apiKey = baseUrlOrConfig.apiKey;\n    }\n\n    if (!this.baseUrl) {\n      throw new Error('baseUrl is required');\n    }\n    if (!this.apiKey) {\n      throw new Error('apiKey is required');\n    }\n  }\n\n  /**\n   * Search for products\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   *   maxPrice: 50\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.maxPrice) {\n      url.searchParams.set('max_price', options.maxPrice.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 a specific product by ID\n   *\n   * @param id - The product ID\n   * @returns Promise resolving to product details\n   *\n   * @example\n   * ```typescript\n   * const product = await client.getProduct('prod_123');\n   * ```\n   */\n  async getProduct(id: string): Promise<Product> {\n    if (!id) {\n      throw new Error('Product ID is required');\n    }\n\n    const url = `${this.baseUrl}/api/products/${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

@@ -0,0 +1,54 @@
+{
+  "name": "@trustrails/sdk",
+  "version": "0.1.0",
+  "description": "Official TypeScript SDK for TrustRails API",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "trustrails",
+    "api",
+    "sdk",
+    "typescript",
+    "ecommerce",
+    "product-verification"
+  ],
+  "author": "James Roe",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/james-webdev/trustrails.git",
+    "directory": "packages/trustrails"
+  },
+  "homepage": "https://github.com/james-webdev/trustrails#readme",
+  "bugs": {
+    "url": "https://github.com/james-webdev/trustrails/issues"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.0",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.2.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}