@objectstack/service-messaging 9.4.0 → 9.5.0

package/dist/index.d.cts

@@ -26,11 +26,15 @@ interface MessagingServicePluginOptions {
     mandatoryTopics?: readonly string[];
     /**
      * Retention window in days for the notification pipeline (ADR-0030
-     * hardening). When set (> 0), a periodic sweep prunes events, deliveries,
-     * inbox materializations and receipts older than this — bounding the
-     * event-log growth from high-frequency periodic flows. **Opt-in**: unset (or
-     * ≤ 0) disables retention (default), so no notification data is ever deleted
-     * without explicit operator policy.
+     * hardening). When > 0, a periodic sweep prunes events, deliveries, inbox
+     * materializations and receipts older than this — bounding the event-log
+     * growth from high-frequency periodic flows.
+     *
+     * **Default-on** at {@link DEFAULT_NOTIFICATION_RETENTION_DAYS} as of GA
+     * (launch-readiness.md P1-2): an unbounded notification log is a slow leak,
+     * so retention ships enabled rather than opt-in. Set to `0` to disable
+     * retention entirely (notification history kept forever; operator owns
+     * cleanup). Raise/lower the number to widen/narrow the window.
      */
     retentionDays?: number;
     /** Retention sweep interval in ms (default 1 hour). Only used when `retentionDays` is set. */

package/dist/index.d.ts

@@ -26,11 +26,15 @@ interface MessagingServicePluginOptions {
     mandatoryTopics?: readonly string[];
     /**
      * Retention window in days for the notification pipeline (ADR-0030
-     * hardening). When set (> 0), a periodic sweep prunes events, deliveries,
-     * inbox materializations and receipts older than this — bounding the
-     * event-log growth from high-frequency periodic flows. **Opt-in**: unset (or
-     * ≤ 0) disables retention (default), so no notification data is ever deleted
-     * without explicit operator policy.
+     * hardening). When > 0, a periodic sweep prunes events, deliveries, inbox
+     * materializations and receipts older than this — bounding the event-log
+     * growth from high-frequency periodic flows.
+     *
+     * **Default-on** at {@link DEFAULT_NOTIFICATION_RETENTION_DAYS} as of GA
+     * (launch-readiness.md P1-2): an unbounded notification log is a slow leak,
+     * so retention ships enabled rather than opt-in. Set to `0` to disable
+     * retention entirely (notification history kept forever; operator owns
+     * cleanup). Raise/lower the number to widen/narrow the window.
      */
     retentionDays?: number;
     /** Retention sweep interval in ms (default 1 hour). Only used when `retentionDays` is set. */

package/dist/index.js

@@ -1874,6 +1874,7 @@ function stableNodeOffset2(nodeId, partitionCount) {
 }
 
 // src/retention.ts
+var DEFAULT_NOTIFICATION_RETENTION_DAYS = 90;
 var DEFAULT_RETENTION_TARGETS = [
   { object: RECEIPT_OBJECT, tsField: "created_at", format: "iso" },
   { object: INBOX_OBJECT, tsField: "created_at", format: "iso" },
@@ -2447,7 +2448,7 @@ var MessagingServicePlugin = class {
       partitionCount: 8,
       dispatchIntervalMs: 500,
       mandatoryTopics: [],
-      retentionDays: 0,
+      retentionDays: DEFAULT_NOTIFICATION_RETENTION_DAYS,
       retentionSweepMs: 36e5,
       ...options
     };