@recomnext/node 0.3.0 → 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
@@ -48,6 +48,18 @@ await client.ingestion.logImpressions([
48
48
  ]);
49
49
  ```
50
50
 
51
+ ## nextQL filters
52
+
53
+ Recommendation `filter` / `boosters` are **opaque nextQL strings** — the SDK does not parse operators.
54
+
55
+ ```text
56
+ 'allowed_countries' contains 'IN'
57
+ 'blocked_regions' not_contains 'EU'
58
+ 'category' in ['games', 'software']
59
+ ```
60
+
61
+ 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).
62
+
51
63
  ## Configuration
52
64
 
53
65
  | Option | Type | Default | Description |
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@recomnext/node",
3
- "version": "0.3.0",
3
+ "version": "0.3.1-dev.cf35fcbb",
4
4
  "description": "Node.js server SDK for the recomnext recommendation engine",
5
5
  "type": "module",
6
6
  "main": "dist/index.cjs",