@wardx/core 0.4.0 → 0.5.0

package/README.md

@@ -302,3 +302,12 @@ Internal series use the prefix `wardx.internal.`.
 - Ingest server: `@wardx/server`
 
 The wire contract is protocol version 1. A runtime sends `POST /v1/sync` with JSON and gzip. The request header is `X-Wardx-Key`.
+
+## Retention activity
+
+`WardxCore.retentionActivity(userId)` requires an explicit nonblank user ID and
+emits salted `retention.activity` evidence into the existing event buffer. The
+server persists UTC cohorts and exact received-user D1/D7/D30 returns; the core
+does not infer activity or keep a durable client identity/outbox. Use the same
+user ID and privacy salt across sessions and clients. See the
+[Node retention contract](../node/README.md#user-retention-d1--d7--d30).

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wardx/core",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "description": "Runtime-agnostic Wardx engine for metrics, events, logs, Remote Config, and experiments.",
   "keywords": [
     "wardx",
@@ -41,4 +41,4 @@
   "publishConfig": {
     "access": "public"
   }
-}
+}

package/src/WardxCore.js

@@ -3,6 +3,7 @@ import { EventBuffer } from './buffers/EventBuffer.js';
 import { LogBuffer } from './buffers/LogBuffer.js';
 import { ConfigStore } from './config/ConfigStore.js';
 import { ExperimentResolver } from './config/ExperimentResolver.js';
+import { subjectHash } from './config/hash.js';
 import { FrameBuilder } from './frame/FrameBuilder.js';
 import { InternalMetrics } from './internal/InternalMetrics.js';
 import { NOOP_COUNTER } from './metrics/Counter.js';
@@ -106,6 +107,20 @@ export class WardxCore {
     return wrapped;
   }
 
+  retentionActivity(userId) {
+    if (typeof userId !== 'string' || userId.trim().length === 0) {
+      throw new Error('retentionActivity requires a non-empty userId');
+    }
+    const salt = this.settings.privacySalt;
+    if (typeof salt !== 'string' || salt.trim().length === 0) {
+      throw new Error('retentionActivity requires a non-empty privacySalt');
+    }
+    this.event('retention.activity', {
+      subject: subjectHash(salt, userId),
+      salt: subjectHash(salt, 'wardx.retention.identity')
+    });
+  }
+
   identify(subjectId) {
     if (subjectId === undefined || subjectId === null) {
       this._subjectId = null;

package/src/index.d.ts

@@ -440,6 +440,7 @@ export class WardxCore {
   distinct(name: string, dims?: Dimensions | null): DistinctHandle;
   timer(name: string, dims?: Dimensions | null): StopTimer;
   event(name: string, attrs?: Attrs | null): void;
+  retentionActivity(userId: string): void;
   identify(subjectId: string | null | undefined): void;
   configGet<T>(key: string, fallback: T, context?: SubjectContext): T;
   experimentGoal(name: string, context?: ExperimentGoalContext): void;