@drivemetadata-ai/sdk 0.1.1-beta.2 → 0.1.1-beta.4

package/docs/index.md

@@ -13,5 +13,6 @@
 
 ## Enterprise Readiness
 
+- [Architecture](./architecture.md)
 - [Security and Privacy](./security-privacy.md)
 - [Release Checklist](./release-checklist.md)

package/docs/integration.md

@@ -92,6 +92,18 @@ await flush();
 console.log(getDmdHealth());
 ```
 
+## Backend Timestamp Fields
+
+Every collector request sends these timestamp fields inside `metaData`:
+
+| Field | Format | Notes |
+|---|---|---|
+| `timestamp` | `YYYY-MM-DD HH:mm:ss` | UTC, no milliseconds, no timezone suffix |
+| `requestSentAt` | `YYYY-MM-DD HH:mm:ss` | UTC, no milliseconds, no timezone suffix |
+| `requestReceivedAt` | `YYYY-MM-DD HH:mm:ss` | UTC, no milliseconds, no timezone suffix |
+
+If a caller provides an invalid timestamp string, the SDK normalizes it to the current UTC time instead of sending the invalid value to the backend.
+
 ## React Integration
 
 Wrap the app once:
@@ -304,6 +316,20 @@ Common drop reasons:
 | `queue_limit_exceeded` | Offline queue is full | Flush more often or increase queue size |
 | `queue_ttl_expired` | Event stayed offline past TTL | Increase TTL only if business requirements allow it |
 
+## Backend Payload IDs
+
+The SDK sends `requestId`, `anonymousId`, and `sessionId` as UUID strings in `metaData`.
+
+```json
+{
+  "metaData": {
+    "requestId": "019de75e-dd28-779b-8084-2b3091b6de32",
+    "anonymousId": "019c8fe4-1fc7-7898-8089-f951a8bbfefb",
+    "sessionId": "019de75e-db3f-75e2-8054-0167411aa4ba"
+  }
+}
+```
+
 ## Production Checklist
 
 - Use `@drivemetadata-ai/sdk/browser`, `/react`, `/next`, or `/angular` only for public browser tokens.

package/docs/npm-browser-sdk.md

@@ -137,3 +137,7 @@ Common drop reasons:
 Delivery behavior:
 
 The browser SDK adds message IDs and idempotency keys to delivery payloads. Queue diagnostics include expired records, and queue flushing uses a cross-tab lease to avoid duplicate ownership when multiple tabs are open.
+
+`metaData.requestId`, `metaData.anonymousId`, and `metaData.sessionId` are UUID strings.
+
+`metaData.timestamp`, `metaData.requestSentAt`, and `metaData.requestReceivedAt` use UTC `YYYY-MM-DD HH:mm:ss` format. Invalid timestamp strings are normalized to the current UTC time before sending.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@drivemetadata-ai/sdk",
-  "version": "0.1.1-beta.2",
-  "description": "Enterprise-grade DriveMetaData browser SDK.",
+  "version": "0.1.1-beta.4",
+  "description": "DriveMetaData JavaScript and TypeScript SDK.",
   "license": "MIT",
   "type": "module",
   "publishConfig": {
@@ -10,6 +10,7 @@
   "files": [
     "dist",
     "docs/index.md",
+    "docs/architecture.md",
     "docs/integration.md",
     "docs/npm-browser-sdk.md",
     "docs/react-next-integration.md",