@proveanything/smartlinks 1.7.4 → 1.7.6

package/dist/openapi.yaml

@@ -4132,75 +4132,11 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/TimelineRequest"
-  /admin/collection/{collectionId}/orders/batch/{batchId}:
-    get:
-      tags:
-        - order
-      summary: Find all orders containing items from a specific batch.
-      operationId: order_findByBatch
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: batchId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindOrdersByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection/{collectionId}/orders/batch/{batchId}/items:
-    get:
-      tags:
-        - order
-      summary: Get individual order items (not full orders) for a specific batch.
-      operationId: order_findItemsByBatch
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: batchId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindItemsByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /admin/collection/{collectionId}/orders/ids/{attribute}/{value}:
     get:
       tags:
         - order
-      summary: order.getOrderIdsByAttribute
+      summary: Get unique order IDs containing items for a specific product.
       operationId: order_getOrderIdsByAttribute
       security:
         - bearerAuth: []
@@ -4390,70 +4326,6 @@ paths:
           description: Unauthorized
         404:
           description: Not found
-  /admin/collection/{collectionId}/orders/variant/{variantId}:
-    get:
-      tags:
-        - order
-      summary: Find all orders containing items from a specific variant.
-      operationId: order_findByVariant
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: variantId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindOrdersByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
-  /admin/collection/{collectionId}/orders/variant/{variantId}/items:
-    get:
-      tags:
-        - order
-      summary: Get individual order items for a specific variant.
-      operationId: order_findItemsByVariant
-      security:
-        - bearerAuth: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-        - name: variantId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                $ref: "#/components/schemas/FindItemsByAttributeResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /admin/collection/{collectionId}/orders/{orderId}:
     get:
       tags:
@@ -9828,8 +9700,9 @@ components:
         id:
           type: string
         type:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - function
         function:
           type: object
           additionalProperties: true
@@ -9973,8 +9846,9 @@ components:
         id:
           type: string
         object:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - chat.completion
         created:
           type: number
         model:
@@ -10008,8 +9882,9 @@ components:
         id:
           type: string
         object:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - chat.completion.chunk
         created:
           type: number
         model:
@@ -12040,8 +11915,9 @@ components:
           items:
             $ref: "#/components/schemas/AttestationSummaryBucket"
         audience:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - public
       required:
         - summary
         - audience
@@ -12086,8 +11962,9 @@ components:
           items:
             $ref: "#/components/schemas/AttestationSummaryBucket"
         audience:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - public
         subjectCount:
           type: number
       required:
@@ -12114,8 +11991,9 @@ components:
           items:
             $ref: "#/components/schemas/LatestAttestation"
         audience:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - public
         subjectCount:
           type: number
       required:
@@ -13952,8 +13830,9 @@ components:
           type: object
           additionalProperties: true
         type:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - object
         required:
           type: array
           items:
@@ -14425,8 +14304,9 @@ components:
       type: object
       properties:
         type:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - smartlinks-route-change
         path:
           type: string
         context:
@@ -14531,8 +14411,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - start
         id:
           type: string
         fields:
@@ -14563,8 +14444,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - chunk
         id:
           type: string
         seq:
@@ -14584,8 +14466,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - end
         id:
           type: string
       required:
@@ -14599,8 +14482,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - ack
         id:
           type: string
         seq:
@@ -14617,8 +14501,9 @@ components:
           type: object
           additionalProperties: true
         phase:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - done
         id:
           type: string
         ok:
@@ -14673,8 +14558,9 @@ components:
         include:
           type: array
           items:
-            type: object
-            additionalProperties: true
+            type: string
+            enum:
+              - interaction
     AdminInteractionsCountsByOutcomeRequest:
       type: object
       properties:
@@ -15734,12 +15620,20 @@ components:
         - items
         - limit
         - offset
-    QueryOrdersRequest:
+    QueryOrderItemFilter:
+      type: object
+      properties:
+        productId:
+          type: string
+        batchId:
+          type: string
+        variantId:
+          type: string
+      required:
+        - productId
+    QueryOrdersFilter:
       type: object
       properties:
-        query:
-          type: object
-          additionalProperties: true
         status:
           type: string
         orderRef:
@@ -15761,6 +15655,8 @@ components:
         metadata:
           type: object
           additionalProperties: true
+        item:
+          $ref: "#/components/schemas/QueryOrderItemFilter"
         sortBy:
           type: string
         sortOrder:
@@ -15768,6 +15664,11 @@ components:
           enum:
             - asc
             - desc
+    QueryOrdersRequest:
+      type: object
+      properties:
+        query:
+          $ref: "#/components/schemas/QueryOrdersFilter"
         limit:
           type: number
         offset:
@@ -15955,9 +15856,7 @@ components:
         attribute:
           type: string
           enum:
-            - batchId
             - productId
-            - variantId
         value:
           type: string
       required:
@@ -16970,8 +16869,9 @@ components:
       type: object
       properties:
         engine:
-          type: object
-          additionalProperties: true
+          type: string
+          enum:
+            - liquid
         source:
           type: string
         props:

package/dist/types/order.d.ts

@@ -175,24 +175,38 @@ export interface GetOrderItemsResponse {
     limit: number;
     offset: number;
 }
+/**
+ * Item-level filters for advanced order querying.
+ * Batch and variant identifiers are only meaningful within a product.
+ */
+export interface QueryOrderItemFilter {
+    productId: string;
+    batchId?: string;
+    variantId?: string;
+}
+/**
+ * Order-level and item-level filters for advanced order querying.
+ */
+export interface QueryOrdersFilter {
+    status?: string;
+    orderRef?: string;
+    customerId?: string;
+    createdAfter?: string;
+    createdBefore?: string;
+    updatedAfter?: string;
+    updatedBefore?: string;
+    minItemCount?: number;
+    maxItemCount?: number;
+    metadata?: Record<string, any>;
+    item?: QueryOrderItemFilter;
+    sortBy?: string;
+    sortOrder?: 'asc' | 'desc';
+}
 /**
  * Request for advanced order querying.
  */
 export interface QueryOrdersRequest {
-    query?: {
-        status?: string;
-        orderRef?: string;
-        customerId?: string;
-        createdAfter?: string;
-        createdBefore?: string;
-        updatedAfter?: string;
-        updatedBefore?: string;
-        minItemCount?: number;
-        maxItemCount?: number;
-        metadata?: Record<string, any>;
-        sortBy?: string;
-        sortOrder?: 'asc' | 'desc';
-    };
+    query?: QueryOrdersFilter;
     limit?: number;
     offset?: number;
     includeItems?: boolean;
@@ -302,7 +316,7 @@ export interface GetOrderIdsParams {
 export interface GetOrderIdsResponse {
     orderIds: string[];
     count: number;
-    attribute: 'batchId' | 'productId' | 'variantId';
+    attribute: 'productId';
     value: string;
 }
 /**

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.7.4  |  Generated: 2026-03-10T14:18:07.271Z
+Version: 1.7.6  |  Generated: 2026-03-12T15:07:14.383Z
 
 This is a concise summary of all available API functions and types.
 
@@ -4400,23 +4400,38 @@ interface GetOrderItemsResponse {
 }
 ```
 
-**QueryOrdersRequest** (interface)
+**QueryOrderItemFilter** (interface)
 ```typescript
-interface QueryOrdersRequest {
-  query?: {
+interface QueryOrderItemFilter {
+  productId: string
+  batchId?: string
+  variantId?: string
+}
+```
+
+**QueryOrdersFilter** (interface)
+```typescript
+interface QueryOrdersFilter {
   status?: string
   orderRef?: string
   customerId?: string
-  createdAfter?: string           // ISO 8601 date
-  createdBefore?: string          // ISO 8601 date
-  updatedAfter?: string           // ISO 8601 date
-  updatedBefore?: string          // ISO 8601 date
+  createdAfter?: string             // ISO 8601 date
+  createdBefore?: string            // ISO 8601 date
+  updatedAfter?: string             // ISO 8601 date
+  updatedBefore?: string            // ISO 8601 date
   minItemCount?: number
   maxItemCount?: number
   metadata?: Record<string, any>
+  item?: QueryOrderItemFilter
   sortBy?: string
   sortOrder?: 'asc' | 'desc'
-  }
+}
+```
+
+**QueryOrdersRequest** (interface)
+```typescript
+interface QueryOrdersRequest {
+  query?: QueryOrdersFilter
   limit?: number                    // Optional: Max results (default: 100)
   offset?: number                   // Optional: Pagination offset (default: 0)
   includeItems?: boolean            // Optional: Include items array (default: false)
@@ -4537,7 +4552,7 @@ interface GetOrderIdsParams {
 interface GetOrderIdsResponse {
   orderIds: string[]
   count: number
-  attribute: 'batchId' | 'productId' | 'variantId'
+  attribute: 'productId'
   value: string
 }
 ```
@@ -6308,7 +6323,7 @@ Find all orders containing specific items (tags, proofs, or serial numbers). Use
 
 **query**(collectionId: string,
     data: QueryOrdersRequest) → `Promise<QueryOrdersResponse>`
-Advanced query for orders with date filtering, metadata search, and sorting. More powerful than the basic list() function. ```typescript // Find pending orders created in January 2026 const result = await order.query('coll_123', { query: { status: 'pending', createdAfter: '2026-01-01T00:00:00Z', createdBefore: '2026-02-01T00:00:00Z', sortBy: 'createdAt', sortOrder: 'desc' }, limit: 50 }) // Find orders with specific metadata and item count const highPriority = await order.query('coll_123', { query: { metadata: { priority: 'high' }, minItemCount: 10, maxItemCount: 100 }, includeItems: true }) ```
+Advanced query for orders with order-level and item-level filtering. More powerful than the basic list() function. ```typescript // Find pending orders created in January 2026 const result = await order.query('coll_123', { query: { status: 'pending', createdAfter: '2026-01-01T00:00:00Z', createdBefore: '2026-02-01T00:00:00Z', sortBy: 'createdAt', sortOrder: 'desc' }, limit: 50 }) // Find orders with specific metadata and item count const highPriority = await order.query('coll_123', { query: { metadata: { priority: 'high' }, minItemCount: 10, maxItemCount: 100 }, includeItems: true }) // Find orders containing a specific product batch const batchOrders = await order.query('coll_123', { query: { item: { productId: 'prod_789', batchId: 'BATCH-2024-001' } }, includeItems: true }) ```
 
 **reports**(collectionId: string,
     params?: ReportsParams) → `Promise<ReportsResponse>`
@@ -6341,41 +6356,21 @@ Get analytics summary for multiple orders at once. Efficient way to retrieve sca
     params?: SummaryRequest) → `Promise<CollectionSummaryResponse>`
 Get collection-wide analytics summary across all orders. Returns daily scan counts and admin activity overview. ```typescript // Get all-time collection summary const summary = await order.getCollectionSummary('coll_123') console.log(`Admin activity count: ${summary.adminActivity.count}`) console.log('Scans by day:') summary.scansByDay.forEach(day => { console.log(`  ${day.date}: ${day.scanCount} scans`) }) // Get summary for last 30 days const recentSummary = await order.getCollectionSummary('coll_123', { from: '2026-01-08T00:00:00Z', to: '2026-02-08T00:00:00Z' }) ```
 
-**findByBatch**(collectionId: string,
-    batchId: string,
-    params?: FindOrdersByAttributeParams) → `Promise<FindOrdersByAttributeResponse>`
-Find all orders containing items from a specific batch. Uses indexed queries for fast lookups across order items. ```typescript // Find orders with items from a specific batch const { orders } = await order.findByBatch('coll_123', 'BATCH-2024-001', { includeItems: true, limit: 50 }) // Get unique customers who received this batch const customers = [...new Set(orders.map(o => o.customerId).filter(Boolean))] console.log(`Batch delivered to ${customers.length} customers`) ```
-
 **findOrdersByProduct**(collectionId: string,
     productId: string,
     params?: FindOrdersByAttributeParams) → `Promise<FindOrdersByAttributeResponse>`
 Find all orders containing items from a specific product. Uses indexed queries for fast lookups across order items. ```typescript // Find all orders containing a product const { orders, limit, offset } = await order.findOrdersByProduct('coll_123', 'prod_789', { limit: 100 }) console.log(`Product appears in ${orders.length} orders`) ```
 
-**findByVariant**(collectionId: string,
-    variantId: string,
-    params?: FindOrdersByAttributeParams) → `Promise<FindOrdersByAttributeResponse>`
-Find all orders containing items from a specific variant. Uses indexed queries for fast lookups across order items. ```typescript // Find orders with a specific variant const { orders } = await order.findByVariant('coll_123', 'var_456', { includeItems: true }) console.log(`Variant ${variantId} in ${orders.length} orders`) ```
-
-**findItemsByBatch**(collectionId: string,
-    batchId: string,
-    params?: FindItemsByAttributeParams) → `Promise<FindItemsByAttributeResponse>`
-Get individual order items (not full orders) for a specific batch. Returns all matching items with optional order summary. ```typescript // Get items from a batch with order info const { items, count } = await order.findItemsByBatch('coll_123', 'BATCH-2024-001', { includeOrder: true, limit: 100 }) // Group by order status const byStatus = items.reduce((acc, item) => { const status = item.order?.status || 'unknown' acc[status] = (acc[status] || 0) + 1 return acc }, {}) ```
-
 **findItemsByProduct**(collectionId: string,
     productId: string,
     params?: FindItemsByAttributeParams) → `Promise<FindItemsByAttributeResponse>`
 Get individual order items for a specific product. Returns all matching items with optional order summary. ```typescript // Get all items for a product const { items } = await order.findItemsByProduct('coll_123', 'prod_789', { includeOrder: true }) console.log(`Product delivered in ${items.length} order items`) ```
 
-**findItemsByVariant**(collectionId: string,
-    variantId: string,
-    params?: FindItemsByAttributeParams) → `Promise<FindItemsByAttributeResponse>`
-Get individual order items for a specific variant. Returns all matching items with optional order summary. ```typescript // Get variant items with order details const { items, count } = await order.findItemsByVariant('coll_123', 'var_456', { includeOrder: true, limit: 50 }) ```
-
 **getOrderIdsByAttribute**(collectionId: string,
-    attribute: 'batchId' | 'productId' | 'variantId',
+    attribute: 'productId',
     value: string,
     params?: GetOrderIdsParams) → `Promise<GetOrderIdsResponse>`
-Get unique order IDs containing items matching the specified attribute. Lightweight query that only returns order IDs, not full order objects. ```typescript // Get order IDs for a batch (fast count) const { orderIds, count } = await order.getOrderIdsByAttribute( 'coll_123', 'batchId', 'BATCH-2024-001' ) console.log(`Batch appears in ${count} orders`) // Get order IDs for a product const productOrders = await order.getOrderIdsByAttribute( 'coll_123', 'productId', 'prod_789', { limit: 500 } ) ```
+Get unique order IDs containing items for a specific product. Lightweight query that only returns order IDs, not full order objects. ```typescript // Get order IDs for a product const productOrders = await order.getOrderIdsByAttribute( 'coll_123', 'productId', 'prod_789', { limit: 500 } ) ```
 
 ### product