@proveanything/smartlinks 2.0.31 → 2.0.32

package/dist/api/appObjects.js

@@ -421,15 +421,30 @@ export var app;
  * Build a query string from an object of parameters
  */
 function buildQueryString(params) {
-    const entries = Object.entries(params).filter(([_, value]) => value !== undefined && value !== null);
-    if (entries.length === 0)
-        return '';
-    const queryString = entries
-        .map(([key, value]) => {
-        const encodedKey = encodeURIComponent(key);
-        const encodedValue = encodeURIComponent(String(value));
-        return `${encodedKey}=${encodedValue}`;
-    })
-        .join('&');
-    return `?${queryString}`;
+    const parts = [];
+    const add = (key, value) => {
+        if (value === undefined || value === null)
+            return;
+        parts.push(`${encodeURIComponent(key)}=${encodeURIComponent(String(value))}`);
+    };
+    for (const [key, value] of Object.entries(params)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            add(key, value.join(',')); // unchanged: top-level arrays are sent comma-joined
+        }
+        else if (typeof value === 'object' && !(value instanceof Date)) {
+            // Nested filter objects (e.g. dataFilter: { versionId: 'x', zone: 'in:a,b' }) → dataFilter[versionId]=x
+            for (const [sub, subValue] of Object.entries(value)) {
+                if (Array.isArray(subValue))
+                    subValue.forEach((v) => add(`${key}[${sub}]`, v));
+                else
+                    add(`${key}[${sub}]`, subValue);
+            }
+        }
+        else {
+            add(key, value instanceof Date ? value.toISOString() : value);
+        }
+    }
+    return parts.length ? `?${parts.join('&')}` : '';
 }

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.31  |  Generated: 2026-09-29T19:37:17.528Z
+Version: 2.0.32  |  Generated: 2026-10-01T17:18:44.658Z
 
 This is a concise summary of all available API functions and types.
 

package/dist/openapi.yaml

@@ -14509,6 +14509,21 @@ paths:
           required: false
           schema:
             type: string
+        - name: qFields
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: dataFilter
+          in: query
+          required: false
+          schema:
+            type: object
+            additionalProperties:
+              type: array
+              items:
+                type: object
+                additionalProperties: true
         - name: authorId
           in: query
           required: false
@@ -20052,6 +20067,15 @@ components:
           type: string
         q:
           type: string
+        qFields:
+          type: string
+        dataFilter:
+          type: object
+          additionalProperties:
+            type: array
+            items:
+              type: object
+              additionalProperties: true
         authorId:
           type: string
         parentType:

package/dist/types/appObjects.d.ts

@@ -620,8 +620,19 @@ export interface RecordListQueryParams extends ListQueryParams {
     variantId?: string;
     /** Filter by batchId (indexed flat column) */
     batchId?: string;
-    /** Full-text filter on data.label (case-insensitive substring) */
+    /** Full-text filter (case-insensitive substring) on data.label — or on `qFields` (admin) */
     q?: string;
+    /**
+     * Admin only: which top-level `data` keys `q` searches (comma-separated, max 5).
+     * Default `label`. Example: `'value,label'`.
+     */
+    qFields?: string;
+    /**
+     * Admin only: filter on top-level `data` keys. Each value is an exact match, an
+     * `in:a,b,c` list, or an array of values (any match). Max 10 keys.
+     * Example: `{ versionId: 'v1', zone: 'in:on_pack,unclear' }`.
+     */
+    dataFilter?: Record<string, string | string[]>;
     authorId?: string;
     parentType?: string;
     parentId?: string;

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 2.0.31  |  Generated: 2026-09-29T19:37:17.528Z
+Version: 2.0.32  |  Generated: 2026-10-01T17:18:44.658Z
 
 This is a concise summary of all available API functions and types.
 

package/openapi.yaml

@@ -14509,6 +14509,21 @@ paths:
           required: false
           schema:
             type: string
+        - name: qFields
+          in: query
+          required: false
+          schema:
+            type: string
+        - name: dataFilter
+          in: query
+          required: false
+          schema:
+            type: object
+            additionalProperties:
+              type: array
+              items:
+                type: object
+                additionalProperties: true
         - name: authorId
           in: query
           required: false
@@ -20052,6 +20067,15 @@ components:
           type: string
         q:
           type: string
+        qFields:
+          type: string
+        dataFilter:
+          type: object
+          additionalProperties:
+            type: array
+            items:
+              type: object
+              additionalProperties: true
         authorId:
           type: string
         parentType:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "2.0.31",
+  "version": "2.0.32",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "type": "module",
   "main": "dist/index.js",