@proveanything/smartlinks 1.0.4 → 1.0.5

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.4",
+  "version": "1.0.5",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",