@proveanything/smartlinks 1.9.0 → 1.9.2

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.9.0  |  Generated: 2026-03-22T15:51:25.814Z
+Version: 1.9.2  |  Generated: 2026-03-23T18:11:56.796Z
 
 This is a concise summary of all available API functions and types.
 
@@ -5849,10 +5849,6 @@ interface ProductQueryRequest {
   query?: {
   search?: string
   status?: string[]
-  category?: string[]
-  type?: string[]
-  schemaType?: string[]
-  tags?: string[]
   productIds?: string[]
   sku?: string
   gtin?: string
@@ -5885,17 +5881,13 @@ interface ProductWriteInput {
   ownGtin?: boolean | null
   additionalGtins?: AdditionalGtin[]
   sku?: string | null
-  schemaType?: string | null
-  type?: string | null
-  category?: string | null
   label?: string | null
   status?: string | null
   sortOrder?: number | null
   heroImage?: ProductImage | ProductImageUrlInput | string | null
   facets?: ProductFacetMap
-  tags?: Record<string, boolean>
   data?: Record<string, JsonValue>
-  admin?: ProductAdminData
+  admin?: Record<string, JsonValue>
   extra?: Record<string, JsonValue>
   validCollections?: string[]
 }
@@ -6420,10 +6412,6 @@ type VerifyTokenResponse = {
 }
 ```
 
-### products (api)
-
-**ProductPublicFindParams** = `Record<`
-
 ## API Functions
 
 ### analytics.admin
@@ -7836,7 +7824,7 @@ List all Product Items for a Collection.
 
 **create**(collectionId: string,
     data: ProductCreateRequest) → `Promise<ProductResponse>`
-Create a new product for a collection (admin only). The `data` payload follows the same shape as ProductResponse minus `id` and `collectionId`. **Hero Image Auto-Fetch:** You can pass `heroImage` as either: - A full asset object: `{ url: '...', thumbnails: {...} }` - A string URL: The system automatically fetches and stores the image ```typescript // Using a URL - auto-fetched and stored const product = await product.create(collectionId, { name: 'Wine Bottle', description: 'Premium red wine', heroImage: 'https://example.com/wine.jpg', // Auto-fetched! tags: {}, data: {} }); ```
+Create a new product for a collection (admin only). The `data` payload follows the same shape as ProductResponse minus `id` and `collectionId`. **Hero Image Auto-Fetch:** You can pass `heroImage` as either: - A full asset object: `{ url: '...', thumbnails: {...} }` - A string URL: The system automatically fetches and stores the image ```typescript // Using a URL - auto-fetched and stored const product = await product.create(collectionId, { name: 'Wine Bottle', description: 'Premium red wine', heroImage: 'https://example.com/wine.jpg', // Auto-fetched! data: {} }); ```
 
 **update**(collectionId: string,
     productId: string,
@@ -7847,9 +7835,6 @@ Update a product for a collection (admin only). The `data` payload is a partial
     productId: string) → `Promise<void>`
 Delete a product for a collection (admin only).
 
-**query**(collectionId: string,
-    body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
-
 **find**(collectionId: string,
     body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
 
@@ -7917,12 +7902,6 @@ Look up a serial number by code for a product (admin only).
 **query**(collectionId: string,
     body: ProductQueryRequest) → `Promise<ProductQueryResponse>`
 
-**find**(collectionId: string,
-    body: ProductQueryRequest | Record<string, JsonValue>) → `Promise<ProductQueryResponse>`
-
-**publicFind**(collectionId: string,
-    params?: ProductPublicFindParams) → `Promise<ProductResponse[]>`
-
 **clone**(collectionId: string,
     productId: string,
     body: Record<string, JsonValue> = {}) → `Promise<ProductResponse>`

package/docs/utils.md

@@ -280,6 +280,8 @@ const path = utils.buildPortalPath(params)
 
 The `validateCondition` function helps determine if content should be shown or hidden based on various criteria like geography, device type, user status, dates, and more.
 
+Enable verbose tracing per invocation with `debugConditions`, or set `globalThis.SMARTLINKS_CONDITION_DEBUG = true` in a browser/devtools session to trace every evaluation.
+
 ### Basic Usage
 
 ```typescript
@@ -291,7 +293,6 @@ const canShow = await utils.validateCondition({
     type: 'and',
     conditions: [{
       type: 'country',
-      useRegions: true,
       regions: ['eu'],
       contains: true
     }]
@@ -328,7 +329,6 @@ await utils.validateCondition({
     type: 'and',
     conditions: [{
       type: 'country',
-      useRegions: true,
       regions: ['eu', 'uk'],
       contains: true  // true = show IN these regions, false = hide IN these regions
     }]
@@ -336,6 +336,20 @@ await utils.validateCondition({
   user: { valid: true, location: { country: 'FR' } }
 })
 
+// Regions and explicit countries can be combined
+await utils.validateCondition({
+  condition: {
+    type: 'and',
+    conditions: [{
+      type: 'country',
+      regions: ['eu'],
+      countries: ['CH'],
+      contains: true
+    }]
+  },
+  user: { valid: true, location: { country: 'CH' } }
+})
+
 // Or specific countries
 await utils.validateCondition({
   condition: {
@@ -582,7 +596,7 @@ await utils.validateCondition({
     conditions: [
       { type: 'user', userType: 'valid' },
       { type: 'device', displays: ['mobile'], contains: true },
-      { type: 'country', useRegions: true, regions: ['eu'], contains: true }
+      { type: 'country', regions: ['eu'], contains: true }
     ]
   },
   user: { valid: true, location: { country: 'FR' } },
@@ -630,12 +644,49 @@ const showNewFeature = await utils.validateCondition({
   condition: {
     type: 'and',
     conditions: [
-      { type: 'country', useRegions: true, regions: ['northamerica'], contains: true },
+      { type: 'country', regions: ['northamerica'], contains: true },
       { type: 'date', dateTest: 'after', afterDate: '2026-03-01' }
     ]
   },
   user: { valid: true, location: { country: 'US' } }
 })
+
+### Debug Logging
+
+Trace which condition is being evaluated, whether it passed, and why:
+
+```typescript
+await utils.validateCondition({
+  condition: {
+    type: 'and',
+    conditions: [
+      { type: 'user', userType: 'valid' },
+      { type: 'country', regions: ['eu'], contains: true }
+    ]
+  },
+  user: { valid: true, location: { country: 'DE' } },
+  debugConditions: true
+})
+
+// Or enable globally in the browser console/devtools
+globalThis.SMARTLINKS_CONDITION_DEBUG = true
+```
+
+If you want to route logs somewhere specific, pass a logger:
+
+```typescript
+await utils.validateCondition({
+  condition: {
+    type: 'and',
+    conditions: [{ type: 'user', userType: 'valid' }]
+  },
+  user: { valid: true },
+  debugConditions: {
+    label: 'checkout-gate',
+    logger: (...args) => console.log(...args)
+  }
+})
+```
 ```
 
 #### Mobile-Only Features

package/openapi.yaml

@@ -5433,7 +5433,7 @@ paths:
     post:
       tags:
         - product
-      summary: product.create
+      summary: Create a new product for a collection (admin only).
       operationId: product_create
       security:
         - bearerAuth: []
@@ -5495,39 +5495,6 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/ProductQueryRequest"
-  /admin/collection/{collectionId}/product/query:
-    post:
-      tags:
-        - product
-      summary: Delete a product for a collection (admin only).
-      operationId: product_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}/product/{productId}:
     put:
       tags:
@@ -6231,40 +6198,6 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/ProductCreateRequest"
-  /admin/collection/{collectionId}/products/find:
-    post:
-      tags:
-        - products
-      summary: products.find
-      operationId: products_find
-      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:
-              type: object
-              additionalProperties: true
   /admin/collection/{collectionId}/products/query:
     post:
       tags:
@@ -10005,7 +9938,7 @@ paths:
     get:
       tags:
         - product
-      summary: "/ export async function query( collectionId: string, body: ProductQueryRequest ): Promise<ProductQueryResponse> { const"
+      summary: "/ export async function find( collectionId: string, body: ProductQueryRequest ): Promise<ProductQueryResponse> { const p"
       operationId: product_publicFind
       security: []
       parameters:
@@ -10496,34 +10429,6 @@ paths:
           application/json:
             schema:
               $ref: "#/components/schemas/ProofClaimRequest"
-  /public/collection/{collectionId}/products/find:
-    get:
-      tags:
-        - products
-      summary: products.publicFind
-      operationId: products_publicFind
-      security: []
-      parameters:
-        - name: collectionId
-          in: path
-          required: true
-          schema:
-            type: string
-      responses:
-        200:
-          description: Success
-          content:
-            application/json:
-              schema:
-                type: array
-                items:
-                  $ref: "#/components/schemas/ProductResponse"
-        400:
-          description: Bad request
-        401:
-          description: Unauthorized
-        404:
-          description: Not found
   /public/collection/{collectionId}/products/{productId}/createClaim:
     post:
       tags:
@@ -20140,22 +20045,6 @@ components:
           type: array
           items:
             type: string
-        category:
-          type: array
-          items:
-            type: string
-        type:
-          type: array
-          items:
-            type: string
-        schemaType:
-          type: array
-          items:
-            type: string
-        tags:
-          type: array
-          items:
-            type: string
         productIds:
           type: array
           items:
@@ -20200,13 +20089,6 @@ components:
       required:
         - field
         - direction
-    ProductAdminData:
-      type: object
-      properties:
-        allowAutoGenerateClaims:
-          type: boolean
-        lastSerialId:
-          type: number
     Product:
       type: object
       properties:
@@ -20226,12 +20108,6 @@ components:
             $ref: "#/components/schemas/AdditionalGtin"
         sku:
           type: string
-        schemaType:
-          type: string
-        type:
-          type: string
-        category:
-          type: string
         label:
           type: string
         status:
@@ -20242,16 +20118,14 @@ components:
           $ref: "#/components/schemas/ProductImage"
         facets:
           $ref: "#/components/schemas/ProductFacetMap"
-        tags:
-          type: object
-          additionalProperties:
-            type: boolean
         data:
           type: object
           additionalProperties:
             $ref: "#/components/schemas/JsonValue"
         admin:
-          $ref: "#/components/schemas/ProductAdminData"
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/JsonValue"
         extra:
           type: object
           additionalProperties:
@@ -20293,12 +20167,6 @@ components:
             $ref: "#/components/schemas/AdditionalGtin"
         sku:
           type: string
-        schemaType:
-          type: string
-        type:
-          type: string
-        category:
-          type: string
         label:
           type: string
         status:
@@ -20310,16 +20178,14 @@ components:
           additionalProperties: true
         facets:
           $ref: "#/components/schemas/ProductFacetMap"
-        tags:
-          type: object
-          additionalProperties:
-            type: boolean
         data:
           type: object
           additionalProperties:
             $ref: "#/components/schemas/JsonValue"
         admin:
-          $ref: "#/components/schemas/ProductAdminData"
+          type: object
+          additionalProperties:
+            $ref: "#/components/schemas/JsonValue"
         extra:
           type: object
           additionalProperties:

package/package.json

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