@proveanything/smartlinks 1.0.3 → 1.0.5

package/README.md

@@ -1,6 +1,6 @@
 # @proveanything/smartlinks
 
-An official JavaScript/TypeScript client SDK for the Smartlinks API. This package provides a simple wrapper around the Smartlinks REST endpoints, allowing you to fetch Collection, Product, and App Configuration data in both browser and Node.js environments.
+An official JavaScript/TypeScript client SDK for the Smartlinks API. This package provides simple, namespaced functions to fetch Collection, Product, Proof, and App Configuration data in both browser and Node.js environments.
 
 ## Installation
 
@@ -13,20 +13,38 @@ yarn add @proveanything/smartlinks
 ## Quickstart
 
 ```ts
-import { ApiClient, CollectionResponse, ProductResponse } from "@proveanything/smartlinks";
+import {
+  initializeApi,
+  collection,
+  product,
+  proof,
+  appConfiguration,
+} from "@proveanything/smartlinks";
 
 async function main() {
-  // Instantiate the client (no apiKey needed for public endpoints, but shown here for reference)
-  const client = new ApiClient("https://smartlinks.app/api/v1", "YOUR_API_KEY_HERE");
+  // Initialize once (provide base URL and optional API key/bearer token)
+  initializeApi({
+    baseURL: "https://smartlinks.app/api/v1",
+    apiKey: "YOUR_API_KEY_HERE",       // optional
+    bearerToken: "YOUR_BEARER_TOKEN",  // optional
+  });
 
   try {
     // Fetch a collection by ID
-    const collection: CollectionResponse = await client.getCollection("abc123");
-    console.log("Collection:", collection);
+    const coll = await collection.get("abc123");
+    console.log("Collection:", coll);
 
     // Fetch a product item by collection ID & product ID
-    const product: ProductResponse = await client.getProductItem("abc123", "prod789");
-    console.log("Product Item:", product);
+    const prod = await product.get("abc123", "prod789");
+    console.log("Product Item:", prod);
+
+    // Fetch a proof by collection ID & proof ID
+    const prf = await proof.get("abc123", "proof456");
+    console.log("Proof:", prf);
+
+    // Fetch an app configuration by collection ID & app ID
+    const cfg = await appConfiguration.get("abc123", "app789");
+    console.log("App Configuration:", cfg);
   } catch (err) {
     console.error("Error fetching data:", err);
   }
@@ -37,19 +55,24 @@ main();
 
 ## API Reference
 
-### Class: `ApiClient`
+### Initialization
 
 ```ts
-constructor(baseURL: string, apiKey?: string)
+initializeApi(options: { baseURL: string; apiKey?: string; bearerToken?: string }): void
 ```
 
 - **Parameters:**
-  - `baseURL` (`string`, required): The root URL of the Smartlinks API, e.g. `https://smartlinks.app/api/v1`.  
-  - `apiKey` (`string`, optional): Your Bearer token. If omitted, requests will be sent without an `Authorization` header.
+  - `baseURL` (`string`, required): The root URL of the Smartlinks API, e.g. `https://smartlinks.app/api/v1`.
+  - `apiKey`  (`string`, optional): Your API key for the `X-API-Key` header.
+  - `bearerToken` (`string`, optional): Your Bearer token for the `AUTHORIZATION` header.
+
+All subsequent calls to the API functions will use these settings.
 
 ---
 
-#### `getCollection(collectionId: string): Promise<CollectionResponse>`
+### Namespace: `collection`
+
+#### `collection.get(collectionId: string): Promise<CollectionResponse>`
 
 Fetches a single collection by its ID.
 
@@ -69,20 +92,21 @@ Fetches a single collection by its ID.
 
 - **Example:**
   ```ts
-  const client = new ApiClient("https://smartlinks.app/api/v1", "YOUR_API_KEY");
-  const collection = await client.getCollection("abc123");
-  console.log("Fetched collection:", collection);
+  const coll = await collection.get("abc123");
+  console.log("Fetched collection:", coll.title);
   ```
 
 ---
 
-#### `getProductItem(collectionId: string, productId: string): Promise<ProductResponse>`
+### Namespace: `product`
+
+#### `product.get(collectionId: string, productId: string): Promise<ProductResponse>`
 
 Fetches a single product item within a collection.
 
 - **Parameters:**
   - `collectionId` (`string`, required): The parent collection’s ID.
-  - `productId`   (`string`, required): The product item’s ID.
+  - `productId`    (`string`, required): The product item’s ID.
 - **Returns:**  
   A `Promise` that resolves to a `ProductResponse` object:
 
@@ -97,93 +121,119 @@ Fetches a single product item within a collection.
 
 - **Example:**
   ```ts
-  const client = new ApiClient("https://smartlinks.app/api/v1", "YOUR_API_KEY");
-  const product = await client.getProductItem("abc123", "prod789");
-  console.log("Fetched product:", product);
+  const prod = await product.get("abc123", "prod789");
+  console.log("Fetched product:", prod.name);
   ```
 
 ---
 
-#### `getAppConfiguration(collectionId: string, appId: string): Promise<AppConfigurationResponse>`
+### Namespace: `proof`
 
-Fetches a single app configuration within a collection.
+#### `proof.get(collectionId: string, proofId: string): Promise<ProofResponse>`
+
+Fetches a single proof by collection ID and proof ID.
 
 - **Parameters:**
   - `collectionId` (`string`, required): The parent collection’s ID.
-  - `appId`        (`string`, required): The app configuration’s ID.
+  - `proofId`      (`string`, required): The proof’s ID.
 - **Returns:**  
-  A `Promise` that resolves to an `AppConfigurationResponse` object:
+  A `Promise` that resolves to a `ProofResponse` object:
 
   ```ts
-  export interface AppConfigurationResponse {
+  export interface ProofResponse {
+    collectionId: string;
+    createdAt: string;
     id: string;
-    name: string;
-    settings?: Record<string, any>;
+    productId: string;
+    tokenId: string;
+    userId: string;
+    values: Record<string, any>;
   }
   ```
 
 - **Example:**
   ```ts
-  const client = new ApiClient("https://smartlinks.app/api/v1", "YOUR_API_KEY");
-  const config = await client.getAppConfiguration("abc123", "app456");
-  console.log("Fetched app configuration:", config);
+  const prf = await proof.get("abc123", "proof456");
+  console.log("Fetched proof:", prf.id);
   ```
 
 ---
 
-## Authentication
+### Namespace: `appConfiguration`
 
-All endpoints require a Bearer token passed in the `AUTHORIZATION` header. When instantiating `ApiClient`, optionally supply your token:
+#### `appConfiguration.get(collectionId: string, appId: string): Promise<AppConfigurationResponse>`
 
-```ts
-import { ApiClient } from "@proveanything/smartlinks";
+Fetches a single app configuration by collection ID and app ID.
 
-const apiKey = "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9...";
-const client = new ApiClient("https://smartlinks.app/api/v1", apiKey);
-```
+- **Parameters:**
+  - `collectionId` (`string`, required): The parent collection’s ID.
+  - `appId`        (`string`, required): The app configuration’s ID.
+- **Returns:**  
+  A `Promise` that resolves to an `AppConfigurationResponse` object:
 
-If `apiKey` is omitted, requests will be sent without an `Authorization` header, which may cause a `401 Unauthorized` for protected endpoints.
+  ```ts
+  export interface AppConfigurationResponse {
+    id: string;
+    name: string;
+    settings?: Record<string, any>;
+  }
+  ```
+
+- **Example:**
+  ```ts
+  const cfg = await appConfiguration.get("abc123", "app789");
+  console.log("Fetched app configuration:", cfg.name);
+  ```
+
+---
 
 ## Error Handling
 
-All methods throw an `Error` when the server responds with a non-2xx status. The thrown error message includes the numeric error code and message from the API. Example:
+All methods throw an `Error` when the server responds with a non-2xx status. The thrown error message will include the numeric error code and message from the API. Example:
 
 ```ts
-import { ApiClient } from "@proveanything/smartlinks";
-
-async function fetchData() {
-  const client = new ApiClient("https://smartlinks.app/api/v1", "INVALID_KEY");
+import { product } from "@proveanything/smartlinks";
 
+async function fetchProduct() {
   try {
-    await client.getCollection("nonexistent");
+    await product.get("abc123", "invalidProdId");
   } catch (err) {
-    // err.message might be: "Error 401: Unauthorized" or "Error 404: Not Found"
+    // err.message might be: "Error 404: Not Found"
     console.error("Request failed:", err);
   }
 }
 
-fetchData();
+fetchProduct();
 ```
 
-## Examples
+---
 
-See the **examples/** folder for complete, runnable samples:
+## Types
 
-- [`examples/node-demo.ts`](examples/node-demo.ts)  
-- [`examples/browser-demo.html`](examples/browser-demo.html)  
-- [`examples/react-demo.tsx`](examples/react-demo.tsx)  
+You can import any of the response interfaces directly:
 
-## OpenAPI Specification
+```ts
+import {
+  CollectionResponse,
+  ProductResponse,
+  ProofResponse,
+  AppConfigurationResponse,
+} from "@proveanything/smartlinks/types";
+```
 
-This SDK is generated and maintained according to the [Smartlinks OpenAPI 3.0 specification](openapi.yaml).  
-You can find the full API contract in [`openapi.yaml`](openapi.yaml) at the root of this package.
+---
 
 ## Changelog
 
 ### 1.0.0
 
-- Initial release:  
-  - `ApiClient` class with `getCollection`, `getProductItem`, and `getAppConfiguration` methods.  
-  - Full TypeScript typings and JSDoc.  
-  - Browser/Node fetch support.  
+- Initial release:
+  - `initializeApi` function to configure baseURL and auth.
+  - Namespaced modules:
+    - `collection.get(collectionId)`
+    - `product.get(collectionId, productId)`
+    - `proof.get(collectionId, proofId)`
+    - `appConfiguration.get(collectionId, appId)`
+  - Full TypeScript typings and JSDoc.
+  - Browser/Node fetch support via `cross-fetch`.
   - Error handling via thrown `Error` objects.

package/dist/api/appConfiguration.d.ts

@@ -0,0 +1,11 @@
+import { AppConfigurationResponse } from "../types/appConfiguration";
+export declare namespace appConfiguration {
+    /**
+     * Retrieves a single App Configuration by Collection ID and App ID.
+     * @param collectionId – Identifier of the parent collection
+     * @param appId        – Identifier of the app configuration
+     * @returns Promise resolving to an AppConfigurationResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    function get(collectionId: string, appId: string): Promise<AppConfigurationResponse>;
+}

package/dist/api/appConfiguration.js

@@ -0,0 +1,17 @@
+// src/api/appConfiguration.ts
+import { request } from "../http";
+export var appConfiguration;
+(function (appConfiguration) {
+    /**
+     * Retrieves a single App Configuration by Collection ID and App ID.
+     * @param collectionId – Identifier of the parent collection
+     * @param appId        – Identifier of the app configuration
+     * @returns Promise resolving to an AppConfigurationResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    async function get(collectionId, appId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
+        return request(path);
+    }
+    appConfiguration.get = get;
+})(appConfiguration || (appConfiguration = {}));

package/dist/api/collection.d.ts

@@ -0,0 +1,10 @@
+import { CollectionResponse } from "../types/collection";
+export declare namespace collection {
+    /**
+     * Retrieves a single Collection by its ID.
+     * @param collectionId – Identifier of the collection
+     * @returns Promise resolving to a CollectionResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    function get(collectionId: string): Promise<CollectionResponse>;
+}

package/dist/api/collection.js

@@ -0,0 +1,16 @@
+// src/api/collection.ts
+import { request } from "../http";
+export var collection;
+(function (collection) {
+    /**
+     * Retrieves a single Collection by its ID.
+     * @param collectionId – Identifier of the collection
+     * @returns Promise resolving to a CollectionResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    async function get(collectionId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}`;
+        return request(path);
+    }
+    collection.get = get;
+})(collection || (collection = {}));

package/dist/api/index.d.ts

@@ -0,0 +1,4 @@
+export { collection } from "./collection";
+export { product } from "./product";
+export { proof } from "./proof";
+export { appConfiguration } from "./appConfiguration";

package/dist/api/index.js

@@ -0,0 +1,6 @@
+// src/api/index.ts
+// Re-export all resource namespaces so the consumer can import them in one line.
+export { collection } from "./collection";
+export { product } from "./product";
+export { proof } from "./proof";
+export { appConfiguration } from "./appConfiguration";

package/dist/api/product.d.ts

@@ -0,0 +1,18 @@
+import { ProductResponse } from "../types/product";
+export declare namespace product {
+    /**
+     * Retrieves a single Product Item by Collection ID and Product ID.
+     * @param collectionId – Identifier of the parent collection
+     * @param productId    – Identifier of the product item
+     * @returns Promise resolving to a ProductResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    function get(collectionId: string, productId: string): Promise<ProductResponse>;
+    /**
+     * Retrieves all Product Items for a Collection.
+     * @param collectionId – Identifier of the parent collection
+     * @returns Promise resolving to an array of ProductResponse objects
+     * @throws ErrorResponse if the request fails
+     */
+    function getAll(collectionId: string): Promise<ProductResponse[]>;
+}

package/dist/api/product.js

@@ -0,0 +1,28 @@
+// src/api/product.ts
+import { request } from "../http";
+export var product;
+(function (product) {
+    /**
+     * Retrieves a single Product Item by Collection ID and Product ID.
+     * @param collectionId – Identifier of the parent collection
+     * @param productId    – Identifier of the product item
+     * @returns Promise resolving to a ProductResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    async function get(collectionId, productId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}`;
+        return request(path);
+    }
+    product.get = get;
+    /**
+     * Retrieves all Product Items for a Collection.
+     * @param collectionId – Identifier of the parent collection
+     * @returns Promise resolving to an array of ProductResponse objects
+     * @throws ErrorResponse if the request fails
+     */
+    async function getAll(collectionId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/product`;
+        return request(path);
+    }
+    product.getAll = getAll;
+})(product || (product = {}));

package/dist/api/proof.d.ts

@@ -0,0 +1,11 @@
+import { ProofResponse } from "../types/proof";
+export declare namespace proof {
+    /**
+     * Retrieves a single Proof by Collection ID and Proof ID.
+     * @param collectionId – Identifier of the parent collection
+     * @param proofId      – Identifier of the proof
+     * @returns Promise resolving to a ProofResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    function get(collectionId: string, proofId: string): Promise<ProofResponse>;
+}

package/dist/api/proof.js

@@ -0,0 +1,17 @@
+// src/api/proof.ts
+import { request } from "../http";
+export var proof;
+(function (proof) {
+    /**
+     * Retrieves a single Proof by Collection ID and Proof ID.
+     * @param collectionId – Identifier of the parent collection
+     * @param proofId      – Identifier of the proof
+     * @returns Promise resolving to a ProofResponse object
+     * @throws ErrorResponse if the request fails
+     */
+    async function get(collectionId, proofId) {
+        const path = `/public/collection/${encodeURIComponent(collectionId)}/proof/${encodeURIComponent(proofId)}`;
+        return request(path);
+    }
+    proof.get = get;
+})(proof || (proof = {}));

package/dist/http.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Call this once (e.g. at app startup) to configure baseURL/auth.
+ *
+ * @param options.baseURL - The root URL of the Smartlinks API (e.g. "https://smartlinks.app/api/v1")
+ * @param options.apiKey - (Optional) API key for X-API-Key header
+ * @param options.bearerToken - (Optional) Bearer token for AUTHORIZATION header
+ */
+export declare function initializeApi(options: {
+    baseURL: string;
+    apiKey?: string;
+    bearerToken?: string;
+}): void;
+/**
+ * Internal helper that performs a GET request to \`\${baseURL}\${path}\`,
+ * injecting headers for apiKey or bearerToken if present.
+ * Returns the parsed JSON as T, or throws an Error.
+ */
+export declare function request<T>(path: string): Promise<T>;

package/dist/http.js

@@ -0,0 +1,54 @@
+// src/http.ts
+// This module replaces the ApiClient constructor. It keeps baseURL, apiKey, bearerToken
+// in module-scope variables, and provides a shared `request<T>(path)` helper that will
+// be used by all namespaced files (collection.ts, product.ts, etc.).
+let baseURL = null;
+let apiKey = undefined;
+let bearerToken = undefined;
+/**
+ * Call this once (e.g. at app startup) to configure baseURL/auth.
+ *
+ * @param options.baseURL - The root URL of the Smartlinks API (e.g. "https://smartlinks.app/api/v1")
+ * @param options.apiKey - (Optional) API key for X-API-Key header
+ * @param options.bearerToken - (Optional) Bearer token for AUTHORIZATION header
+ */
+export function initializeApi(options) {
+    baseURL = options.baseURL.replace(/\/+\$/, ""); // trim trailing slash
+    apiKey = options.apiKey;
+    bearerToken = options.bearerToken;
+}
+/**
+ * Internal helper that performs a GET request to \`\${baseURL}\${path}\`,
+ * injecting headers for apiKey or bearerToken if present.
+ * Returns the parsed JSON as T, or throws an Error.
+ */
+export async function request(path) {
+    if (!baseURL) {
+        throw new Error("HTTP client is not initialized. Call initializeApi(...) first.");
+    }
+    const url = `${baseURL}${path}`;
+    const headers = {
+        "Content-Type": "application/json",
+    };
+    if (apiKey) {
+        headers["X-API-Key"] = apiKey;
+    }
+    if (bearerToken) {
+        headers["AUTHORIZATION"] = `Bearer ${bearerToken}`;
+    }
+    const response = await fetch(url, {
+        method: "GET",
+        headers,
+    });
+    if (!response.ok) {
+        // Try to parse ErrorResponse; if that fails, throw generic
+        try {
+            const errBody = (await response.json());
+            throw new Error(`Error ${errBody.code}: ${errBody.message}`);
+        }
+        catch (_a) {
+            throw new Error(`Request to ${url} failed with status ${response.status}`);
+        }
+    }
+    return (await response.json());
+}

package/dist/index.d.ts

@@ -1,113 +1,3 @@
-/**
- * Represents a Collection object.
- */
-export interface CollectionResponse {
-    /** Unique identifier for the collection */
-    id: string;
-    /** Machine‐readable name of the collection */
-    name: string;
-    /** Human‐readable title of the collection */
-    title: string;
-    /** URL to the collection’s logo image */
-    logoImage: string;
-}
-/**
- * Represents a Product Item object.
- */
-export interface ProductResponse {
-    /** Unique identifier for the product */
-    id: string;
-    /** Name of the product */
-    name: string;
-    /** Detailed description of the product */
-    description: string;
-    /** URL to the product’s hero image */
-    heroImage: string;
-}
-/**
- * Represents an App Configuration object.
- */
-export interface AppConfigurationResponse {
-    /** Unique identifier for the app configuration */
-    id: string;
-    /** Name of the app configuration */
-    name: string;
-    /** Key‐value pairs representing configuration settings */
-    settings?: Record<string, any>;
-}
-/**
- * Represents a standardized error response.
- */
-export interface ErrorResponse {
-    /** Numeric error code */
-    code: number;
-    /** Human‐readable error message */
-    message: string;
-}
-/**
- * ApiClient for the Smartlinks API.
- * Supports both browser (native fetch) and Node (using cross-fetch).
- */
-export declare class ApiClient {
-    private baseURL;
-    private apiKey?;
-    private bearerToken?;
-    /**
-     * Creates an instance of ApiClient.
-     * @param baseURL - The base URL of the Smartlinks API (e.g., https://smartlinks.app/api/v1)
-     * @param apiKey - (Optional) API key for X-API-Key header
-     * @param bearerToken - (Optional) Bearer token for AUTHORIZATION header
-     *
-     * @example
-     * // With both API key and bearer token
-     * const client = new ApiClient(
-     *   'https://smartlinks.app/api/v1',
-     *   'your-api-key',
-     *   'your-bearer-token'
-     * );
-     *
-     * // With only API key
-     * const client = new ApiClient(
-     *   'https://smartlinks.app/api/v1',
-     *   'your-api-key'
-     * );
-     *
-     * // With only bearer token
-     * const client = new ApiClient(
-     *   'https://smartlinks.app/api/v1',
-     *   undefined,
-     *   'your-bearer-token'
-     * );
-     */
-    constructor(baseURL: string, apiKey?: string, bearerToken?: string);
-    /**
-     * Retrieves a single Collection by its ID.
-     * @param collectionId - Identifier of the collection
-     * @returns Promise resolving to a CollectionResponse object
-     * @throws ErrorResponse if the request fails
-     */
-    getCollection(collectionId: string): Promise<CollectionResponse>;
-    /**
-     * Retrieves a single Product Item by Collection ID and Product ID.
-     * @param collectionId - Identifier of the parent collection
-     * @param productId - Identifier of the product item
-     * @returns Promise resolving to a ProductResponse object
-     * @throws ErrorResponse if the request fails
-     */
-    getProductItem(collectionId: string, productId: string): Promise<ProductResponse>;
-    /**
-     * Retrieves a single App Configuration by Collection ID and App ID.
-     * @param collectionId - Identifier of the parent collection
-     * @param appId - Identifier of the app configuration
-     * @returns Promise resolving to an AppConfigurationResponse object
-     * @throws ErrorResponse if the request fails
-     */
-    getAppConfiguration(collectionId: string, appId: string): Promise<AppConfigurationResponse>;
-    /**
-     * Internal helper to perform a GET request and parse JSON.
-     * @param path - The path (relative to baseURL) to request
-     * @returns Promise resolving to the parsed JSON of type T
-     * @throws Error if network error or a non-2xx response is returned
-     */
-    private request;
-}
+export { initializeApi, request } from "./http";
+export * from "./api";
+export * from "./types";

package/dist/index.js

@@ -1,105 +1,5 @@
-import fetch from 'cross-fetch';
-///////////////////////////
-// ApiClient Class
-///////////////////////////
-/**
- * ApiClient for the Smartlinks API.
- * Supports both browser (native fetch) and Node (using cross-fetch).
- */
-export class ApiClient {
-    /**
-     * Creates an instance of ApiClient.
-     * @param baseURL - The base URL of the Smartlinks API (e.g., https://smartlinks.app/api/v1)
-     * @param apiKey - (Optional) API key for X-API-Key header
-     * @param bearerToken - (Optional) Bearer token for AUTHORIZATION header
-     *
-     * @example
-     * // With both API key and bearer token
-     * const client = new ApiClient(
-     *   'https://smartlinks.app/api/v1',
-     *   'your-api-key',
-     *   'your-bearer-token'
-     * );
-     *
-     * // With only API key
-     * const client = new ApiClient(
-     *   'https://smartlinks.app/api/v1',
-     *   'your-api-key'
-     * );
-     *
-     * // With only bearer token
-     * const client = new ApiClient(
-     *   'https://smartlinks.app/api/v1',
-     *   undefined,
-     *   'your-bearer-token'
-     * );
-     */
-    constructor(baseURL, apiKey, bearerToken) {
-        this.baseURL = baseURL.replace(/\/+$/, ''); // Trim trailing slash
-        this.apiKey = apiKey;
-        this.bearerToken = bearerToken;
-    }
-    /**
-     * Retrieves a single Collection by its ID.
-     * @param collectionId - Identifier of the collection
-     * @returns Promise resolving to a CollectionResponse object
-     * @throws ErrorResponse if the request fails
-     */
-    async getCollection(collectionId) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}`;
-        return this.request(path);
-    }
-    /**
-     * Retrieves a single Product Item by Collection ID and Product ID.
-     * @param collectionId - Identifier of the parent collection
-     * @param productId - Identifier of the product item
-     * @returns Promise resolving to a ProductResponse object
-     * @throws ErrorResponse if the request fails
-     */
-    async getProductItem(collectionId, productId) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}`;
-        return this.request(path);
-    }
-    /**
-     * Retrieves a single App Configuration by Collection ID and App ID.
-     * @param collectionId - Identifier of the parent collection
-     * @param appId - Identifier of the app configuration
-     * @returns Promise resolving to an AppConfigurationResponse object
-     * @throws ErrorResponse if the request fails
-     */
-    async getAppConfiguration(collectionId, appId) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/app/${encodeURIComponent(appId)}`;
-        return this.request(path);
-    }
-    /**
-     * Internal helper to perform a GET request and parse JSON.
-     * @param path - The path (relative to baseURL) to request
-     * @returns Promise resolving to the parsed JSON of type T
-     * @throws Error if network error or a non-2xx response is returned
-     */
-    async request(path) {
-        const url = `${this.baseURL}${path}`;
-        const headers = {
-            'Content-Type': 'application/json',
-        };
-        if (this.apiKey) {
-            headers['X-API-Key'] = this.apiKey;
-        }
-        if (this.bearerToken) {
-            headers['AUTHORIZATION'] = `Bearer ${this.bearerToken}`;
-        }
-        const response = await fetch(url, { method: 'GET', headers });
-        if (!response.ok) {
-            // Attempt to parse error body; if it fails, throw generic
-            let errorBody;
-            try {
-                errorBody = (await response.json());
-            }
-            catch (_a) {
-                throw new Error(`Request failed with status ${response.status}`);
-            }
-            throw new Error(`Error ${errorBody.code}: ${errorBody.message}`);
-        }
-        return (await response.json());
-    }
-}
+// src/index.ts
+// Top-level entrypoint of the npm package. Re-export initializeApi + all namespaces.
+export { initializeApi, request } from "./http";
+export * from "./api";
+export * from "./types";

package/dist/types/appConfiguration.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Represents an App Configuration object.
+ */
+export interface AppConfigurationResponse {
+    /** Unique identifier for the app configuration */
+    id: string;
+    /** Name of the app configuration */
+    name: string;
+    /** Key-value pairs representing configuration settings */
+    settings?: Record<string, any>;
+}

package/dist/types/appConfiguration.js

@@ -0,0 +1 @@
+export {};

package/dist/types/collection.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Represents a Collection object.
+ */
+export interface CollectionResponse {
+    /** Unique identifier for the collection */
+    id: string;
+    /** Machine-readable name of the collection */
+    name: string;
+    /** Human-readable title of the collection */
+    title: string;
+    /** URL to the collection’s logo image */
+    logoImage: string;
+}

package/dist/types/collection.js

@@ -0,0 +1 @@
+export {};

package/dist/types/error.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Represents a standardized error response.
+ */
+export interface ErrorResponse {
+    /** Numeric error code */
+    code: number;
+    /** Human-readable error message */
+    message: string;
+}

package/dist/types/error.js

@@ -0,0 +1 @@
+export {};

package/dist/types/index.d.ts

@@ -0,0 +1,5 @@
+export * from "./collection";
+export * from "./product";
+export * from "./proof";
+export * from "./appConfiguration";
+export * from "./error";

package/dist/types/index.js

@@ -0,0 +1,7 @@
+// src/types/index.ts
+// Re-export all type modules so consumers can import types directly
+export * from "./collection";
+export * from "./product";
+export * from "./proof";
+export * from "./appConfiguration";
+export * from "./error";

package/dist/types/product.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Represents a Product Item object.
+ */
+export interface ProductResponse {
+    /** Unique identifier for the product */
+    id: string;
+    /** Name of the product */
+    name: string;
+    /** Detailed description of the product */
+    description: string;
+    /** URL to the product’s hero image */
+    heroImage: string;
+}

package/dist/types/product.js

@@ -0,0 +1 @@
+export {};

package/dist/types/proof.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Represents a Proof object.
+ */
+export interface ProofResponse {
+    /** Unique identifier for the collection */
+    collectionId: string;
+    /** Creation timestamp */
+    createdAt: string;
+    /** Unique identifier for the proof */
+    id: string;
+    /** Unique identifier for the product */
+    productId: string;
+    /** Unique identifier for the token */
+    tokenId: string;
+    /** Unique identifier for the user */
+    userId: string;
+    /** Arbitrary key-value pairs for proof values */
+    values: Record<string, any>;
+}

package/dist/types/proof.js

@@ -0,0 +1 @@
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",