@proveanything/smartlinks 1.7.5 → 1.7.8

package/dist/types/ai.d.ts

@@ -50,6 +50,83 @@ export interface ToolDefinition {
         };
     };
 }
+/** Additional/native tool definition accepted by the Responses API. */
+export interface ResponseTool {
+    type: string;
+    name?: string;
+    description?: string;
+    parameters?: Record<string, any>;
+    [key: string]: any;
+}
+/** Structured input item accepted by the Responses API. */
+export interface ResponseInputItem {
+    role?: 'system' | 'user' | 'assistant' | 'function' | 'tool';
+    type?: string;
+    content?: string | ContentPart[];
+    name?: string;
+    function_call?: FunctionCall;
+    tool_calls?: ToolCall[];
+    tool_call_id?: string;
+    [key: string]: any;
+}
+/** Request for the Responses API. */
+export interface ResponsesRequest {
+    model?: string;
+    input?: string | ResponseInputItem[];
+    messages?: ResponseInputItem[];
+    previous_response_id?: string;
+    conversation?: string | Record<string, any>;
+    tools?: Array<ToolDefinition | ResponseTool>;
+    tool_choice?: 'none' | 'auto' | 'required' | {
+        type: 'function';
+        function: {
+            name: string;
+        };
+    } | {
+        type: 'function';
+        name: string;
+    };
+    stream?: boolean;
+    temperature?: number;
+    max_output_tokens?: number;
+    store?: boolean;
+    instructions?: string;
+    include?: string[];
+    reasoning?: Record<string, any>;
+    parallel_tool_calls?: boolean;
+    truncation?: 'auto' | 'disabled';
+    text?: Record<string, any>;
+    metadata?: Record<string, string>;
+    prompt_cache_key?: string;
+}
+/** Response from the Responses API. */
+export interface ResponsesResult {
+    id: string;
+    object: 'response';
+    created: number;
+    model: string;
+    status?: 'completed' | 'failed' | 'in_progress' | 'queued' | 'cancelled' | 'incomplete';
+    output: any[];
+    output_text: string;
+    usage: {
+        input_tokens: number;
+        output_tokens: number;
+        total_tokens: number;
+    };
+    error?: any;
+    incomplete_details?: {
+        reason?: 'max_output_tokens' | 'content_filter';
+    } | null;
+    previous_response_id?: string | null;
+    conversation?: unknown;
+    provider: 'openai';
+    responseTime: number;
+}
+/** Generic SSE event emitted by the Responses API. */
+export interface ResponsesStreamEvent {
+    type: string;
+    [key: string]: any;
+}
 /** Chat completion request */
 export interface ChatCompletionRequest {
     messages: ChatMessage[];
@@ -120,6 +197,16 @@ export interface AIModel {
     features: string[];
     recommended?: string;
 }
+/** Filter parameters when listing models. */
+export interface AIModelListParams {
+    provider?: 'gemini' | 'openai';
+    capability?: 'text' | 'vision' | 'audio' | 'code';
+}
+/** Model list response. */
+export interface AIModelListResponse {
+    object: 'list';
+    data: AIModel[];
+}
 /** Document chunk with embedding */
 export interface DocumentChunk {
     text: string;

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.5  |  Generated: 2026-03-10T14:23:18.789Z
+Version: 1.7.8  |  Generated: 2026-03-12T16:18:35.207Z
 
 This is a concise summary of all available API functions and types.
 
@@ -431,6 +431,93 @@ interface ToolDefinition {
 }
 ```
 
+**ResponseTool** (interface)
+```typescript
+interface ResponseTool {
+  type: string
+  name?: string
+  description?: string
+  parameters?: Record<string, any>
+  [key: string]: any
+}
+```
+
+**ResponseInputItem** (interface)
+```typescript
+interface ResponseInputItem {
+  role?: 'system' | 'user' | 'assistant' | 'function' | 'tool'
+  type?: string
+  content?: string | ContentPart[]
+  name?: string
+  function_call?: FunctionCall
+  tool_calls?: ToolCall[]
+  tool_call_id?: string
+  [key: string]: any
+}
+```
+
+**ResponsesRequest** (interface)
+```typescript
+interface ResponsesRequest {
+  model?: string
+  input?: string | ResponseInputItem[]
+  messages?: ResponseInputItem[]
+  previous_response_id?: string
+  conversation?: string | Record<string, any>
+  tools?: Array<ToolDefinition | ResponseTool>
+  tool_choice?:
+  | 'none'
+  | 'auto'
+  | 'required'
+  | { type: 'function'; function: { name: string } }
+  | { type: 'function'; name: string }
+  stream?: boolean
+  temperature?: number
+  max_output_tokens?: number
+  store?: boolean
+  instructions?: string
+  include?: string[]
+  reasoning?: Record<string, any>
+  parallel_tool_calls?: boolean
+  truncation?: 'auto' | 'disabled'
+  text?: Record<string, any>
+  metadata?: Record<string, string>
+  prompt_cache_key?: string
+}
+```
+
+**ResponsesResult** (interface)
+```typescript
+interface ResponsesResult {
+  id: string
+  object: 'response'
+  created: number
+  model: string
+  status?: 'completed' | 'failed' | 'in_progress' | 'queued' | 'cancelled' | 'incomplete'
+  output: any[]
+  output_text: string
+  usage: {
+  input_tokens: number
+  output_tokens: number
+  total_tokens: number
+  }
+  error?: any
+  incomplete_details?: { reason?: 'max_output_tokens' | 'content_filter' } | null
+  previous_response_id?: string | null
+  conversation?: unknown
+  provider: 'openai'
+  responseTime: number
+}
+```
+
+**ResponsesStreamEvent** (interface)
+```typescript
+interface ResponsesStreamEvent {
+  type: string
+  [key: string]: any
+}
+```
+
 **ChatCompletionRequest** (interface)
 ```typescript
 interface ChatCompletionRequest {
@@ -509,6 +596,22 @@ interface AIModel {
 }
 ```
 
+**AIModelListParams** (interface)
+```typescript
+interface AIModelListParams {
+  provider?: 'gemini' | 'openai'
+  capability?: 'text' | 'vision' | 'audio' | 'code'
+}
+```
+
+**AIModelListResponse** (interface)
+```typescript
+interface AIModelListResponse {
+  object: 'list'
+  data: AIModel[]
+}
+```
+
 **DocumentChunk** (interface)
 ```typescript
 interface DocumentChunk {
@@ -4400,23 +4503,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 +4655,7 @@ interface GetOrderIdsParams {
 interface GetOrderIdsResponse {
   orderIds: string[]
   count: number
-  attribute: 'batchId' | 'productId' | 'variantId'
+  attribute: 'productId'
   value: string
 }
 ```
@@ -5271,90 +5389,6 @@ type AccountInfoResponse = {
 
 ## API Functions
 
-### ai
-
-**create**(collectionId: string,
-        request: ChatCompletionRequest) → `Promise<ChatCompletionResponse | AsyncIterable<ChatCompletionChunk>>`
-Create a chat completion (streaming or non-streaming)
-
-**list**(collectionId: string) → `Promise<`
-List available AI models
-
-**get**(collectionId: string, modelId: string) → `Promise<AIModel>`
-Get specific model information
-
-**indexDocument**(collectionId: string,
-      request: IndexDocumentRequest) → `Promise<IndexDocumentResponse>`
-Index a document for RAG
-
-**configureAssistant**(collectionId: string,
-      request: ConfigureAssistantRequest) → `Promise<ConfigureAssistantResponse>`
-Configure AI assistant behavior
-
-**stats**(collectionId: string) → `Promise<SessionStatistics>`
-Get session statistics
-
-**reset**(collectionId: string, userId: string) → `Promise<`
-Reset rate limit for a user
-
-**generate**(collectionId: string,
-      request: GeneratePodcastRequest) → `Promise<GeneratePodcastResponse>`
-Generate a NotebookLM-style conversational podcast from product documents
-
-**getStatus**(collectionId: string, podcastId: string) → `Promise<PodcastStatus>`
-Get podcast generation status
-
-**generate**(collectionId: string,
-      request: TTSRequest) → `Promise<Blob>`
-Generate text-to-speech audio
-
-**chat**(collectionId: string,
-      request: PublicChatRequest) → `Promise<PublicChatResponse>`
-Chat with product assistant (RAG)
-
-**getSession**(collectionId: string, sessionId: string) → `Promise<Session>`
-Get session history
-
-**clearSession**(collectionId: string, sessionId: string) → `Promise<`
-Clear session history
-
-**getRateLimit**(collectionId: string, userId: string) → `Promise<RateLimitStatus>`
-Check rate limit status
-
-**getToken**(collectionId: string,
-      request: EphemeralTokenRequest) → `Promise<EphemeralTokenResponse>`
-Generate ephemeral token for Gemini Live
-
-**isSupported**() → `boolean`
-Check if voice is supported in browser
-
-**listen**(language = 'en-US') → `Promise<string>`
-Listen for voice input
-
-**speak**(text: string, options?: { voice?: string; rate?: number }) → `Promise<void>`
-Speak text
-
-**generateContent**(collectionId: string,
-    params: AIGenerateContentRequest,
-    admin: boolean = true) → `Promise<any>`
-Generate text/content via AI (admin)
-
-**generateImage**(collectionId: string, params: AIGenerateImageRequest) → `Promise<any>`
-Generate an image via AI (admin)
-
-**searchPhotos**(collectionId: string,
-    params: AISearchPhotosRequest) → `Promise<AISearchPhotosPhoto[]>`
-Search stock photos or similar via AI (admin)
-
-**uploadFile**(collectionId: string, params: any) → `Promise<any>`
-Upload a file for AI usage (admin). Pass FormData for binary uploads.
-
-**createCache**(collectionId: string, params: any) → `Promise<any>`
-Create or warm a cache for AI (admin)
-
-**postChat**(collectionId: string, params: any, admin: boolean = true) → `Promise<any>`
-Post a chat message to the AI (admin or public)
-
 ### app
 
 **create**(collectionId: string,
@@ -5823,6 +5857,94 @@ Get all tags/codes assigned to a specific batch. Shows which claim set codes hav
 **appendBulk**(collectionId: string,
     body: BroadcastAppendBulkBody) → `Promise<AppendBulkResult>`
 
+### chat
+
+**create**(collectionId: string,
+        request: ResponsesRequest) → `Promise<ResponsesResult | AsyncIterable<ResponsesStreamEvent>>`
+Create a Responses API request (streaming or non-streaming)
+
+**create**(collectionId: string,
+        request: ChatCompletionRequest) → `Promise<ChatCompletionResponse | AsyncIterable<ChatCompletionChunk>>`
+Create a chat completion (streaming or non-streaming)
+
+**list**(collectionId: string, params?: AIModelListParams) → `Promise<AIModelListResponse>`
+List available AI models
+
+**get**(collectionId: string, modelId: string) → `Promise<AIModel>`
+Get specific model information
+
+**indexDocument**(collectionId: string,
+      request: IndexDocumentRequest) → `Promise<IndexDocumentResponse>`
+Index a document for RAG
+
+**configureAssistant**(collectionId: string,
+      request: ConfigureAssistantRequest) → `Promise<ConfigureAssistantResponse>`
+Configure AI assistant behavior
+
+**stats**(collectionId: string) → `Promise<SessionStatistics>`
+Get session statistics
+
+**reset**(collectionId: string, userId: string) → `Promise<`
+Reset rate limit for a user
+
+**generate**(collectionId: string,
+      request: GeneratePodcastRequest) → `Promise<GeneratePodcastResponse>`
+Generate a NotebookLM-style conversational podcast from product documents
+
+**getStatus**(collectionId: string, podcastId: string) → `Promise<PodcastStatus>`
+Get podcast generation status
+
+**generate**(collectionId: string,
+      request: TTSRequest) → `Promise<Blob>`
+Generate text-to-speech audio
+
+**chat**(collectionId: string,
+      request: PublicChatRequest) → `Promise<PublicChatResponse>`
+Chat with product assistant (RAG)
+
+**getSession**(collectionId: string, sessionId: string) → `Promise<Session>`
+Get session history
+
+**clearSession**(collectionId: string, sessionId: string) → `Promise<`
+Clear session history
+
+**getRateLimit**(collectionId: string, userId: string) → `Promise<RateLimitStatus>`
+Check rate limit status
+
+**getToken**(collectionId: string,
+      request: EphemeralTokenRequest) → `Promise<EphemeralTokenResponse>`
+Generate ephemeral token for Gemini Live
+
+**isSupported**() → `boolean`
+Check if voice is supported in browser
+
+**listen**(language = 'en-US') → `Promise<string>`
+Listen for voice input
+
+**speak**(text: string, options?: { voice?: string; rate?: number }) → `Promise<void>`
+Speak text
+
+**generateContent**(collectionId: string,
+    params: AIGenerateContentRequest,
+    admin: boolean = true) → `Promise<any>`
+Generate text/content via AI (admin)
+
+**generateImage**(collectionId: string, params: AIGenerateImageRequest) → `Promise<any>`
+Generate an image via AI (admin)
+
+**searchPhotos**(collectionId: string,
+    params: AISearchPhotosRequest) → `Promise<AISearchPhotosPhoto[]>`
+Search stock photos or similar via AI (admin)
+
+**uploadFile**(collectionId: string, params: any) → `Promise<any>`
+Upload a file for AI usage (admin). Pass FormData for binary uploads.
+
+**createCache**(collectionId: string, params: any) → `Promise<any>`
+Create or warm a cache for AI (admin)
+
+**postChat**(collectionId: string, params: any, admin: boolean = true) → `Promise<any>`
+Post a chat message to the AI (admin or public)
+
 ### claimSet
 
 **getAllForCollection**(collectionId: string) → `Promise<any[]>`
@@ -6308,7 +6430,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 +6463,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