@ttt-productions/notification-core 0.15.0 → 0.15.1

package/dist/index.d.ts

@@ -1,2 +1,3 @@
 export type { NotificationDoc, PendingNotification, NotificationCategoryConfig, NotificationTypeConfig, NotificationSystemConfig, UseActiveNotificationsOptions, UseNotificationHistoryOptions, NotificationHistoryItem, UseUnreadCountOptions, UseArchiveNotificationOptions, UseArchiveAllNotificationsOptions, ArchiveAllJobStatus, EnqueueArchiveAllResult, ArchiveAllJobSnapshot, ArchiveAllPollResult, NotificationRowActions, NotificationListProps, NotificationHistoryListProps, NotificationEmptyStateProps, NotificationUnreadBadgeProps, } from './types.js';
+export { NotificationDocSchema, PendingNotificationSchema } from './schemas.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,iCAAiC,EACjC,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,eAAe,EACf,mBAAmB,EACnB,0BAA0B,EAC1B,sBAAsB,EACtB,wBAAwB,EACxB,6BAA6B,EAC7B,6BAA6B,EAC7B,uBAAuB,EACvB,qBAAqB,EACrB,6BAA6B,EAC7B,iCAAiC,EACjC,mBAAmB,EACnB,uBAAuB,EACvB,qBAAqB,EACrB,oBAAoB,EACpB,sBAAsB,EACtB,qBAAqB,EACrB,4BAA4B,EAC5B,2BAA2B,EAC3B,4BAA4B,GAC7B,MAAM,YAAY,CAAC;AAKpB,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -1,2 +1,5 @@
-export {};
+// Runtime schemas for the generic notification doc shapes (notification-core owns
+// these; consuming apps compose them instead of hand-mirroring). Server- and
+// UI-safe (zod only, no React/firebase).
+export { NotificationDocSchema, PendingNotificationSchema } from './schemas.js';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAuBA,kFAAkF;AAClF,6EAA6E;AAC7E,yCAAyC;AACzC,OAAO,EAAE,qBAAqB,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC"}

package/dist/schemas.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @ttt-productions/notification-core — Zod schemas
+ *
+ * Runtime validation schemas for the generic notification document shapes whose
+ * TypeScript types live in `./types.ts`. notification-core OWNS these shapes, so
+ * it owns their schemas too — the consuming app (e.g. `@ttt-productions/ttt-core`)
+ * composes these rather than hand-mirroring them, so the schema can never drift
+ * from the type.
+ *
+ * The interfaces in `./types.ts` remain the documented public type API. Each
+ * schema is compile-time-checked against its interface via
+ * `satisfies z.ZodType<Shape>` — a shape drift between the interface and the
+ * schema fails the build here.
+ *
+ * zod-only, no React/firebase: safe for both server (Cloud Functions) and UI.
+ */
+import { z } from 'zod';
+/**
+ * Active notification document (`NotificationDoc`). Same shape for both the user
+ * and admin active collections.
+ */
+export declare const NotificationDocSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    dedupKey: z.ZodString;
+    category: z.ZodString;
+    targetUserId: z.ZodNullable<z.ZodString>;
+    title: z.ZodString;
+    message: z.ZodString;
+    count: z.ZodNumber;
+    latestActorIds: z.ZodArray<z.ZodString>;
+    targetPath: z.ZodOptional<z.ZodString>;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    seenAt: z.ZodNumber;
+    activityGeneration: z.ZodOptional<z.ZodString>;
+    seenAtGeneration: z.ZodOptional<z.ZodString>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Pending notification (`PendingNotification`) — queue item for the batch processor.
+ */
+export declare const PendingNotificationSchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodString;
+    category: z.ZodString;
+    targetUserId: z.ZodNullable<z.ZodString>;
+    actorId: z.ZodString;
+    metadata: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    createdAt: z.ZodNumber;
+}, z.core.$strip>;
+//# sourceMappingURL=schemas.d.ts.map

package/dist/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;iBAoBK,CAAC;AAExC;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;iBAQK,CAAC"}

package/dist/schemas.js

@@ -0,0 +1,55 @@
+/**
+ * @ttt-productions/notification-core — Zod schemas
+ *
+ * Runtime validation schemas for the generic notification document shapes whose
+ * TypeScript types live in `./types.ts`. notification-core OWNS these shapes, so
+ * it owns their schemas too — the consuming app (e.g. `@ttt-productions/ttt-core`)
+ * composes these rather than hand-mirroring them, so the schema can never drift
+ * from the type.
+ *
+ * The interfaces in `./types.ts` remain the documented public type API. Each
+ * schema is compile-time-checked against its interface via
+ * `satisfies z.ZodType<Shape>` — a shape drift between the interface and the
+ * schema fails the build here.
+ *
+ * zod-only, no React/firebase: safe for both server (Cloud Functions) and UI.
+ */
+import { z } from 'zod';
+/**
+ * Active notification document (`NotificationDoc`). Same shape for both the user
+ * and admin active collections.
+ */
+export const NotificationDocSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    dedupKey: z.string(),
+    category: z.string(),
+    targetUserId: z.string().nullable(),
+    title: z.string(),
+    message: z.string(),
+    count: z.number(),
+    latestActorIds: z.array(z.string()),
+    // Absent on linkless types (no defaultTargetPath in the type config).
+    targetPath: z.string().optional(),
+    metadata: z.record(z.string(), z.unknown()),
+    seenAt: z.number(),
+    // Opaque per-generation token rotated on create / material re-light. Optional on
+    // the legacy active doc shape; the ledger materializer always sets it.
+    activityGeneration: z.string().optional(),
+    seenAtGeneration: z.string().optional(),
+    createdAt: z.number(),
+    updatedAt: z.number(),
+});
+/**
+ * Pending notification (`PendingNotification`) — queue item for the batch processor.
+ */
+export const PendingNotificationSchema = z.object({
+    id: z.string(),
+    type: z.string(),
+    category: z.string(),
+    targetUserId: z.string().nullable(),
+    actorId: z.string(),
+    metadata: z.record(z.string(), z.unknown()),
+    createdAt: z.number(),
+});
+//# sourceMappingURL=schemas.js.map

package/dist/schemas.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.js","sourceRoot":"","sources":["../src/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;GAGG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC,MAAM,CAAC;IAC5C,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC;IACnC,sEAAsE;IACtE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;IAClB,iFAAiF;IACjF,uEAAuE;IACvE,kBAAkB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACzC,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAAsC,CAAC;AAExC;;GAEG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,CAAC,MAAM,CAAC;IAChD,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE;IAChB,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE;IACnB,QAAQ,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAC3C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;CACtB,CAA0C,CAAC"}

package/dist/server/observed-generation.d.ts

@@ -9,8 +9,8 @@
  * replay return the stored result and touch nothing.
  *
  * GENERIC: the app constructs the deterministic ids (`historyRef`, `payloadHash`)
- * via its own canonical hash (ttt-core) and passes the refs in; this module owns
- * only the transactional state machine, not the id formulas.
+ * via its own canonical hash (in the consuming app's core package) and passes the
+ * refs in; this module owns only the transactional state machine, not the id formulas.
  */
 import type { ServerFirestore, ServerDocRef, ServerTransaction } from './types.js';
 export type MarkSeenOutcome = 'seen' | 'generation-mismatch' | 'missing';

package/dist/server/observed-generation.js

@@ -9,8 +9,8 @@
  * replay return the stored result and touch nothing.
  *
  * GENERIC: the app constructs the deterministic ids (`historyRef`, `payloadHash`)
- * via its own canonical hash (ttt-core) and passes the refs in; this module owns
- * only the transactional state machine, not the id formulas.
+ * via its own canonical hash (in the consuming app's core package) and passes the
+ * refs in; this module owns only the transactional state machine, not the id formulas.
  */
 /**
  * Set `seenAt`/`seenAtGeneration` ONLY if the card's current `activityGeneration`

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ttt-productions/notification-core",
-  "version": "0.15.0",
+  "version": "0.15.1",
   "description": "Shared notification system for TTT Productions apps — active/history two-tier architecture with dedup, batch processing, and themed UI components",
   "repository": {
     "type": "git",
@@ -37,10 +37,13 @@
     "typecheck": "tsc --noEmit",
     "prepublishOnly": "npm run build"
   },
+  "dependencies": {
+    "zod": "^4.4.3"
+  },
   "peerDependencies": {
     "@tanstack/react-query": ">=5.0.0",
     "@ttt-productions/query-core": "^0.14.0",
-    "@ttt-productions/ui-core": "^0.11.1",
+    "@ttt-productions/ui-core": "^0.11.4",
     "firebase": ">=12.0.0",
     "react": ">=19.0.0",
     "react-dom": ">=19.0.0"
@@ -68,7 +71,7 @@
   "devDependencies": {
     "@tanstack/react-query": "^5.0.0",
     "@ttt-productions/query-core": "^0.14.0",
-    "@ttt-productions/ui-core": "^0.11.1",
+    "@ttt-productions/ui-core": "^0.11.4",
     "@types/react": "^19.0.0",
     "@types/react-dom": "^19.0.0",
     "firebase": "^11.0.0",