@proveanything/smartlinks 1.0.32 → 1.0.34

package/dist/api/product.d.ts

@@ -1,4 +1,4 @@
-import { ProductResponse } from "../types/product";
+import { ProductResponse, ProductCreateRequest, ProductUpdateRequest } from "../types/product";
 export declare namespace product {
     /**
      * Retrieves a single Product Item by Collection ID and Product ID.
@@ -19,21 +19,23 @@ export declare namespace product {
     function list(collectionId: string, admin?: boolean): Promise<ProductResponse[]>;
     /**
      * Create a new product for a collection (admin only).
+     * The `data` payload follows the same shape as ProductResponse minus `id` and `collectionId`.
      * @param collectionId – Identifier of the parent collection
-     * @param data – Product creation data
+     * @param data – Product creation data (see ProductCreateRequest)
      * @returns Promise resolving to a ProductResponse object
      * @throws ErrorResponse if the request fails
      */
-    function create(collectionId: string, data: any): Promise<ProductResponse>;
+    function create(collectionId: string, data: ProductCreateRequest): Promise<ProductResponse>;
     /**
      * Update a product for a collection (admin only).
+     * The `data` payload is a partial of ProductResponse minus `id` and `collectionId`.
      * @param collectionId – Identifier of the parent collection
      * @param productId – Identifier of the product
-     * @param data – Product update data
+     * @param data – Product update data (see ProductUpdateRequest)
      * @returns Promise resolving to a ProductResponse object
      * @throws ErrorResponse if the request fails
      */
-    function update(collectionId: string, productId: string, data: any): Promise<ProductResponse>;
+    function update(collectionId: string, productId: string, data: ProductUpdateRequest): Promise<ProductResponse>;
     /**
      * Delete a product for a collection (admin only).
      * @param collectionId – Identifier of the parent collection

package/dist/api/product.js

@@ -31,8 +31,9 @@ export var product;
     product.list = list;
     /**
      * Create a new product for a collection (admin only).
+     * The `data` payload follows the same shape as ProductResponse minus `id` and `collectionId`.
      * @param collectionId – Identifier of the parent collection
-     * @param data – Product creation data
+     * @param data – Product creation data (see ProductCreateRequest)
      * @returns Promise resolving to a ProductResponse object
      * @throws ErrorResponse if the request fails
      */
@@ -43,9 +44,10 @@ export var product;
     product.create = create;
     /**
      * Update a product for a collection (admin only).
+     * The `data` payload is a partial of ProductResponse minus `id` and `collectionId`.
      * @param collectionId – Identifier of the parent collection
      * @param productId – Identifier of the product
-     * @param data – Product update data
+     * @param data – Product update data (see ProductUpdateRequest)
      * @returns Promise resolving to a ProductResponse object
      * @throws ErrorResponse if the request fails
      */

package/dist/api/proof.d.ts

@@ -1,15 +1,42 @@
 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
+     * Retrieves a single Proof by Collection ID, Product ID, and Proof ID.
+     * Both public and admin endpoints now include productId in the path.
      */
-    function get(collectionId: string, proofId: string): Promise<ProofResponse>;
+    function get(collectionId: string, productId: string, proofId: string, admin?: boolean): Promise<ProofResponse>;
     /**
      * List all Proofs for a Collection.
      */
     function list(collectionId: string): Promise<ProofResponse[]>;
+    /**
+     * Create a proof for a product (admin only).
+     * POST /admin/collection/:collectionId/product/:productId/proof
+     */
+    function create(collectionId: string, productId: string, values: any): Promise<ProofResponse>;
+    /**
+     * Update a proof for a product (admin only).
+     * PUT /admin/collection/:collectionId/product/:productId/proof/:proofId
+     */
+    function update(collectionId: string, productId: string, proofId: string, values: any): Promise<ProofResponse>;
+    /**
+     * Get proofs for a user in a collection (admin only).
+     * GET /admin/collection/:collectionId/proof/findByUser/:userId
+     */
+    function getByUser(collectionId: string, userId: string): Promise<ProofResponse[]>;
+    /**
+     * Get proofs for a product (admin only).
+     * GET /admin/collection/:collectionId/product/:productId/proof
+     */
+    function getByProduct(collectionId: string, productId: string): Promise<ProofResponse[]>;
+    /**
+     * Find proofs for a product (admin only).
+     * POST /admin/collection/:collectionId/product/:productId/proof/find
+     */
+    function findByProduct(collectionId: string, productId: string, query: any): Promise<ProofResponse[]>;
+    /**
+     * Get proofs for a batch (admin only).
+     * GET /admin/collection/:collectionId/product/:productId/batch/:batchId/proof
+     */
+    function getByBatch(collectionId: string, productId: string, batchId: string): Promise<ProofResponse[]>;
 }

package/dist/api/proof.js

@@ -1,16 +1,14 @@
 // src/api/proof.ts
-import { request } from "../http";
+import { request, post, put } 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
+     * Retrieves a single Proof by Collection ID, Product ID, and Proof ID.
+     * Both public and admin endpoints now include productId in the path.
      */
-    async function get(collectionId, proofId) {
-        const path = `/public/collection/${encodeURIComponent(collectionId)}/proof/${encodeURIComponent(proofId)}`;
+    async function get(collectionId, productId, proofId, admin) {
+        const base = admin ? '/admin' : '/public';
+        const path = `${base}/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}`;
         return request(path);
     }
     proof.get = get;
@@ -22,4 +20,59 @@ export var proof;
         return request(path);
     }
     proof.list = list;
+    // -------------------- Admin functions (legacy parity) --------------------
+    /**
+     * Create a proof for a product (admin only).
+     * POST /admin/collection/:collectionId/product/:productId/proof
+     */
+    async function create(collectionId, productId, values) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof`;
+        return post(path, values);
+    }
+    proof.create = create;
+    /**
+     * Update a proof for a product (admin only).
+     * PUT /admin/collection/:collectionId/product/:productId/proof/:proofId
+     */
+    async function update(collectionId, productId, proofId, values) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/${encodeURIComponent(proofId)}`;
+        return put(path, values);
+    }
+    proof.update = update;
+    /**
+     * Get proofs for a user in a collection (admin only).
+     * GET /admin/collection/:collectionId/proof/findByUser/:userId
+     */
+    async function getByUser(collectionId, userId) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/proof/findByUser/${encodeURIComponent(userId)}`;
+        return request(path);
+    }
+    proof.getByUser = getByUser;
+    /**
+     * Get proofs for a product (admin only).
+     * GET /admin/collection/:collectionId/product/:productId/proof
+     */
+    async function getByProduct(collectionId, productId) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof`;
+        return request(path);
+    }
+    proof.getByProduct = getByProduct;
+    /**
+     * Find proofs for a product (admin only).
+     * POST /admin/collection/:collectionId/product/:productId/proof/find
+     */
+    async function findByProduct(collectionId, productId, query) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/proof/find`;
+        return post(path, query);
+    }
+    proof.findByProduct = findByProduct;
+    /**
+     * Get proofs for a batch (admin only).
+     * GET /admin/collection/:collectionId/product/:productId/batch/:batchId/proof
+     */
+    async function getByBatch(collectionId, productId, batchId) {
+        const path = `/admin/collection/${encodeURIComponent(collectionId)}/product/${encodeURIComponent(productId)}/batch/${encodeURIComponent(batchId)}/proof`;
+        return request(path);
+    }
+    proof.getByBatch = getByBatch;
 })(proof || (proof = {}));

package/dist/index.d.ts

@@ -6,3 +6,4 @@ export type { AttestationResponse, AttestationCreateRequest, AttestationUpdateRe
 export type { BatchResponse, BatchCreateRequest, BatchUpdateRequest, } from "./types/batch";
 export type { VariantResponse, VariantCreateRequest, VariantUpdateRequest, } from "./types/variant";
 export type { AppConfigOptions } from "./api/appConfiguration";
+export type { ProductCreateRequest, ProductUpdateRequest, } from "./types/product";

package/dist/types/product.d.ts

@@ -30,3 +30,5 @@ export interface ProductResponse {
         [key: string]: any;
     };
 }
+export type ProductCreateRequest = Omit<ProductResponse, 'id' | 'collectionId'>;
+export type ProductUpdateRequest = Partial<Omit<ProductResponse, 'id' | 'collectionId'>>;

package/package.json

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