@recomnext/browser 0.3.1-dev.1f0705f4 → 0.3.1-dev.cf35fcbb

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +12 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -67,6 +67,18 @@ cleanup(); // stop observing
67
67
  recomnext.destroy(); // flush pending impressions
68
68
  ```
69
69
 
70
+ ## nextQL filters
71
+
72
+ Recommendation `filter` / `boosters` are **opaque nextQL strings** — the SDK does not parse operators.
73
+
74
+ ```text
75
+ 'allowed_countries' contains 'IN'
76
+ 'blocked_regions' not_contains 'EU'
77
+ 'category' in ['games', 'software']
78
+ ```
79
+
80
+ Use `contains` / `not_contains` **only** for array item attributes; use `in` / `not_in` when the filter supplies the list. Missing, null, or non-array attrs fail closed — for denylists every item must have the array (`[]` = not blocked).
81
+
70
82
  ## Features
71
83
 
72
84
  - Zero dependencies in the published bundle (~3KB gzipped for recommendations; search methods add minimal size)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@recomnext/browser",
3
- "version": "0.3.1-dev.1f0705f4",
3
+ "version": "0.3.1-dev.cf35fcbb",
4
4
  "description": "Lightweight browser SDK for recomnext — recommendations, event tracking, and impression tracking",
5
5
  "type": "module",
6
6
  "main": "dist/recomnext-browser.umd.js",