@warlock.js/notifications 5.25.0 → 5.26.0

package/CHANGELOG.md

@@ -4,6 +4,12 @@ All notable changes to `@warlock.js/notifications` are documented in this file.
 
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/). `@warlock.js/*` packages are released in lockstep — every package shares the same version number, so a version below may list only the changes that affected this package.
 
+## 5.26.0 - 2026-09-30
+
+### Changed
+
+- Lockstep release; package APIs are unchanged.
+
 ## 5.25.0 - 2026-09-28
 
 ### Changed

package/llms-full.txt

@@ -959,7 +959,7 @@ database: inApp.configure({ repository: notificationsRepository }),
 
 ---
 name: write-notification-migration
-description: 'Create the notifications table with the `notificationColumns(Notification)` factory + cascade `Migration.create`. Column NAMES come from the model''s `columnMap` (recipient / tenant / readAt / isRead); the fixed columns are `type` / `title` / `body` / `payload` / `idempotency_key`. Read-state follows columnMap presence: `readAt` → nullable timestamp, `isRead` → indexed boolean, both → both. Defaults to `user_id` + `read_at` when no columnMap. Spread + extend for extras (FK references, composite indexes). Triggers: `notificationColumns`, `Migration.create` for notifications, "create the notifications table", "notification migration", "add organization_id to notifications", `is_read` column, `read_at` column, `idempotency_key` column; typical import `import { Migration } from "@warlock.js/cascade"; import { notificationColumns } from "@warlock.js/notifications"`. Skip: generic cascade migration writing — `@warlock.js/cascade/write-migration/SKILL.md`; the model itself — `@warlock.js/notifications/use-in-app/SKILL.md`.'
+description: 'Create the notifications table with the `notificationColumns(Notification)` factory + cascade `Migration.create`. Column NAMES come from the model''s `columnMap` (recipient / tenant / readAt / isRead); the fixed columns are `type` / `title` / `body` / `payload` / `idempotency_key`. Set `{ idType: "bigint" }` for integer-key apps; UUID remains the default. Read-state follows columnMap presence: `readAt` → nullable timestamp, `isRead` → indexed boolean, both → both. Defaults to `user_id` + `read_at` when no columnMap. Spread + extend for extras (FK references, composite indexes). Triggers: `notificationColumns`, `Migration.create` for notifications, "create the notifications table", "notification migration", "add organization_id to notifications", `is_read` column, `read_at` column, `idempotency_key` column; typical import `import { Migration } from "@warlock.js/cascade"; import { notificationColumns } from "@warlock.js/notifications"`. Skip: generic cascade migration writing — `@warlock.js/cascade/write-migration/SKILL.md`; the model itself — `@warlock.js/notifications/use-in-app/SKILL.md`.'
 ---
 
 # Write the notifications migration
@@ -992,6 +992,16 @@ The recipient / tenant / read-state column NAMES come from `columnMap`; `type` /
 `title` / `body` / `payload` / `idempotency_key` are fixed. `id` / `createdAt` /
 `updatedAt` are added automatically by cascade.
 
+## Match your app's identifier type
+
+Recipient and tenant columns default to UUID. For applications whose primary keys
+are `bigint`, `integer`, or strings, pass `idType`; it is applied to every
+identifier column the factory creates:
+
+```ts
+export default Migration.create(Notification, notificationColumns(Notification, { idType: "bigint" }));
+```
+
 ## With extras — spread + extend
 
 Add your own columns — a category, a source channel, a tenant id, anything:
@@ -1002,7 +1012,7 @@ import { notificationColumns } from "@warlock.js/notifications";
 import { Notification } from "../notification.model";
 
 export default Migration.create(Notification, {
-  ...notificationColumns(Notification),
+  ...notificationColumns(Notification, { idType: "bigint" }),
   category: string().index().nullable(),
 });
 ```

package/package.json

@@ -5,16 +5,16 @@
     "environment": "server"
   },
   "dependencies": {
-    "@warlock.js/cache": "5.25.0",
-    "@warlock.js/cascade": "5.25.0",
-    "@warlock.js/core": "5.25.0",
-    "@warlock.js/logger": "5.25.0"
+    "@warlock.js/cache": "5.26.0",
+    "@warlock.js/cascade": "5.26.0",
+    "@warlock.js/core": "5.26.0",
+    "@warlock.js/logger": "5.26.0"
   },
   "optionalDependencies": {
-    "@warlock.js/herald": "5.25.0"
+    "@warlock.js/herald": "5.26.0"
   },
   "peerDependencies": {
-    "@warlock.js/queue": "5.25.0"
+    "@warlock.js/queue": "5.26.0"
   },
   "peerDependenciesMeta": {
     "@warlock.js/queue": {
@@ -35,7 +35,7 @@
   ],
   "author": "hassanzohdy",
   "license": "MIT",
-  "version": "5.25.0",
+  "version": "5.26.0",
   "main": "./cjs/index.cjs",
   "module": "./esm/index.mjs",
   "types": "./esm/index.d.mts",