@proveanything/smartlinks 1.14.17 → 1.15.0

package/README.md

@@ -123,7 +123,8 @@ import { products } from '@proveanything/smartlinks'
 
 await products.get(collectionId, productId, false)
 await products.list(collectionId, false)
-await products.query(collectionId, { query: { search: 'cabernet' } })
+await products.query(collectionId, { query: { search: 'cabernet' } }) // public
+await products.query(collectionId, { query: { search: 'cabernet' } }, true) // admin
 ```
 
 Quick mapping:

package/dist/api/products.d.ts

@@ -5,7 +5,26 @@ export declare namespace products {
     function create(collectionId: string, data: ProductCreateRequest): Promise<ProductResponse>;
     function update(collectionId: string, productId: string, data: ProductUpdateRequest): Promise<ProductResponse>;
     function remove(collectionId: string, productId: string): Promise<void>;
-    function query(collectionId: string, body: ProductQueryRequest): Promise<ProductQueryResponse>;
+    /**
+     * Query products in a collection with filtering, sorting, and pagination.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param body - Query parameters with filters, sorting, and pagination
+     * @param admin - When `true`, targets the `/admin` endpoint (requires an
+     *   authenticated admin context). Defaults to `false`, which targets the
+     *   `/public` endpoint — consistent with `get`, `list`, and `listAssets`.
+     * @returns Promise resolving to a ProductQueryResponse
+     *
+     * @example
+     * ```typescript
+     * // Public query (default)
+     * await products.query(collectionId, { query: { search: 'cabernet' } })
+     *
+     * // Admin query (authenticated)
+     * await products.query(collectionId, { query: { search: 'cabernet' } }, true)
+     * ```
+     */
+    function query(collectionId: string, body: ProductQueryRequest, admin?: boolean): Promise<ProductQueryResponse>;
     function clone(collectionId: string, productId: string, body?: Record<string, JsonValue>): Promise<ProductResponse>;
     function listAssets(collectionId: string, productId: string, admin?: boolean): Promise<unknown>;
     function createClaimWindow(collectionId: string, productId: string, body: Record<string, JsonValue>): Promise<unknown>;

package/dist/api/products.js

@@ -28,8 +28,28 @@ export var products;
         return del(path);
     }
     products.remove = remove;
-    async function query(collectionId, body) {
-        const path = `/admin/collection/${encodeURIComponent(collectionId)}/products/query`;
+    /**
+     * Query products in a collection with filtering, sorting, and pagination.
+     *
+     * @param collectionId - Identifier of the parent collection
+     * @param body - Query parameters with filters, sorting, and pagination
+     * @param admin - When `true`, targets the `/admin` endpoint (requires an
+     *   authenticated admin context). Defaults to `false`, which targets the
+     *   `/public` endpoint — consistent with `get`, `list`, and `listAssets`.
+     * @returns Promise resolving to a ProductQueryResponse
+     *
+     * @example
+     * ```typescript
+     * // Public query (default)
+     * await products.query(collectionId, { query: { search: 'cabernet' } })
+     *
+     * // Admin query (authenticated)
+     * await products.query(collectionId, { query: { search: 'cabernet' } }, true)
+     * ```
+     */
+    async function query(collectionId, body, admin) {
+        const base = admin ? '/admin' : '/public';
+        const path = `${base}/collection/${encodeURIComponent(collectionId)}/products/query`;
         return post(path, body);
     }
     products.query = query;

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.14.17  |  Generated: 2026-06-02T16:17:46.100Z
+Version: 1.15.0  |  Generated: 2026-06-03T10:03:05.999Z
 
 This is a concise summary of all available API functions and types.
 
@@ -9399,44 +9399,55 @@ Look up a serial number by code for a product (admin only).
     productId: string) → `Promise<void>`
 
 **query**(collectionId: string,
-    body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
+    body: ProductQueryRequest,
+    admin?: boolean) → `Promise<ProductQueryResponse>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **clone**(collectionId: string,
     productId: string,
     body: Record<string, JsonValue> = {}) → `Promise<ProductResponse>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **listAssets**(collectionId: string,
     productId: string,
     admin?: boolean) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **createClaimWindow**(collectionId: string,
     productId: string,
     body: Record<string, JsonValue>) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **updateClaimWindow**(collectionId: string,
     productId: string,
     claimId: string,
     body: Record<string, JsonValue>) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **refresh**(collectionId: string,
     productId: string) → `Promise<ProductResponse>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **getSN**(collectionId: string,
     productId: string,
     startIndex: number = 0,
     count: number = 10) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **lookupSN**(collectionId: string,
     productId: string,
     codeId: string) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **publicLookupClaim**(collectionId: string,
     productId: string,
     claimId: string) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **publicCreateClaim**(collectionId: string,
     productId: string,
     body: ProductClaimCreateRequestBody) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 ### proof
 

package/dist/openapi.yaml

@@ -6639,39 +6639,6 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/ProductCreateRequest"
-  /admin/collection/{collectionId}/products/query:
-    post:
-      tags:
-        - products
-      summary: products.query
-      operationId: products_query
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ProductQueryResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/ProductQueryRequest"
   /admin/collection/{collectionId}/products/{productId}:
     put:
       tags:

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.14.17  |  Generated: 2026-06-02T16:17:46.100Z
+Version: 1.15.0  |  Generated: 2026-06-03T10:03:05.999Z
 
 This is a concise summary of all available API functions and types.
 
@@ -9399,44 +9399,55 @@ Look up a serial number by code for a product (admin only).
     productId: string) → `Promise<void>`
 
 **query**(collectionId: string,
-    body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
+    body: ProductQueryRequest,
+    admin?: boolean) → `Promise<ProductQueryResponse>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **clone**(collectionId: string,
     productId: string,
     body: Record<string, JsonValue> = {}) → `Promise<ProductResponse>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **listAssets**(collectionId: string,
     productId: string,
     admin?: boolean) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **createClaimWindow**(collectionId: string,
     productId: string,
     body: Record<string, JsonValue>) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **updateClaimWindow**(collectionId: string,
     productId: string,
     claimId: string,
     body: Record<string, JsonValue>) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **refresh**(collectionId: string,
     productId: string) → `Promise<ProductResponse>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **getSN**(collectionId: string,
     productId: string,
     startIndex: number = 0,
     count: number = 10) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **lookupSN**(collectionId: string,
     productId: string,
     codeId: string) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **publicLookupClaim**(collectionId: string,
     productId: string,
     claimId: string) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 **publicCreateClaim**(collectionId: string,
     productId: string,
     body: ProductClaimCreateRequestBody) → `Promise<unknown>`
+Query products in a collection with filtering, sorting, and pagination. authenticated admin context). Defaults to `false`, which targets the `/public` endpoint — consistent with `get`, `list`, and `listAssets`. ```typescript // Public query (default) await products.query(collectionId, { query: { search: 'cabernet' } }) // Admin query (authenticated) await products.query(collectionId, { query: { search: 'cabernet' } }, true) ```
 
 ### proof
 

package/openapi.yaml

@@ -6639,39 +6639,6 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/ProductCreateRequest"
-  /admin/collection/{collectionId}/products/query:
-    post:
-      tags:
-        - products
-      summary: products.query
-      operationId: products_query
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/ProductQueryResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-      requestBody:
-        required: true
-        content:
-          application/json:
-            schema:
-              $ref: "#/components/schemas/ProductQueryRequest"
   /admin/collection/{collectionId}/products/{productId}:
     put:
       tags:

package/package.json

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