@fluentcommerce/fc-connect-sdk 0.1.52 → 0.1.53

package/README.md

@@ -1309,7 +1309,17 @@ if (logs.results[0]?.id) {
 
 #### Query Parameters
 
-All parameters are optional. Context filters use flat dot-notation keys:
+All parameters are optional. Context filters use **dot-notation keys** which require quotes in JavaScript/TypeScript:
+
+```typescript
+// ⚠️ Dot-notation keys MUST be quoted (JavaScript syntax requirement)
+await client.getEvents({
+  'context.rootEntityType': 'ORDER',  // ✅ Quotes required (has dot)
+  'context.entityRef': 'ORD-123',     // ✅ Quotes required (has dot)
+  eventType: 'ORCHESTRATION_AUDIT',   // ✅ No quotes needed (simple key)
+  count: 100,                         // ✅ No quotes needed (simple key)
+});
+```
 
 | Parameter | Type | Description | Example |
 |-----------|------|-------------|---------|
@@ -1325,7 +1335,7 @@ All parameters are optional. Context filters use flat dot-notation keys:
 | `category` | string | Category filter | `'ruleSet'`, `'ACTION'` |
 | `from` | string | Start date (UTC ISO 8601) | `'2026-02-01T00:00:00.000Z'` |
 | `to` | string | End date (UTC ISO 8601) | `'2026-02-15T23:59:59.999Z'` |
-| `retailerId` | string/number | Retailer filter (falls back to client config) | `'5'` |
+| `retailerId` | string/number | Retailer filter (pass explicitly; no auto-fallback) | `'5'` |
 | `start` | number | Pagination offset (default: `0`) | `0` |
 | `count` | number | Results per page (default: `100`, max: `5000`) | `1000` |
 
@@ -1418,7 +1428,7 @@ const orderEvents = await client.getEvents({
 | **Time range (to)** | 1 month forward max | API rejects future dates beyond ~1 month |
 | **Default time window** | Past 30 days | Applied when `from` is omitted |
 | **Date format** | UTC ISO 8601 | `YYYY-MM-DDTHH:mm:ss.SSSZ` |
-| **retailerId fallback** | Client config | If not in params, uses `client.config.retailerId` |
+| **retailerId** | Pass explicitly | Unlike `sendEvent()`, no auto-fallback to client config — pass in params if needed |
 | **attributes field** | Nullable | Can be `null` (not empty array) — always check before iterating |
 | **name field** | Nullable | Can be `null` for some system events |
 | **GraphQL** | Not available | Event queries use REST only — no GraphQL `events` root field exists |

package/dist/cjs/types/index.d.ts

@@ -133,7 +133,7 @@ export interface FluentEventLogContext {
 }
 export interface FluentEventLogAttribute {
     name: string;
-    value: string;
+    value: unknown;
     type?: string;
     [key: string]: unknown;
 }

package/dist/esm/types/index.d.ts

@@ -133,7 +133,7 @@ export interface FluentEventLogContext {
 }
 export interface FluentEventLogAttribute {
     name: string;
-    value: string;
+    value: unknown;
     type?: string;
     [key: string]: unknown;
 }