@warlock.js/notifications 5.44.0 → 5.46.0

package/esm/index.d.mts

@@ -1,11 +1,11 @@
-import { ChannelName, DatabasePayload, Id, MailPayload, Notifiable, NotificationChannels, NotificationEvents, NotificationInput, RenderContext, SendOptions } from "./types.mjs";
+import { ChannelName, DatabasePayload, Id, MailPayload, Notifiable, NotificationChannels, NotificationEvents, NotificationInput, RecipientRef, RenderContext, SendOptions } from "./types.mjs";
 import { Channel } from "./contracts/channel.contract.mjs";
 import { NotificationContract } from "./contracts/notification.contract.mjs";
 import { PreferenceProvider } from "./contracts/preference-provider.contract.mjs";
 import { QueueDispatcher } from "./contracts/queue-dispatcher.contract.mjs";
 import { RateLimiter } from "./contracts/rate-limiter.contract.mjs";
 import "./contracts/index.mjs";
-import { ChannelNotFoundError, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, UnresolvableRouteError } from "./errors.mjs";
+import { ChannelNotFoundError, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, RecipientTypeRequiredError, UnresolvableRouteError } from "./errors.mjs";
 import { ChannelMap, NotificationConfig, getNotificationConfig, resetNotificationConfig, setNotificationConfig } from "./config.mjs";
 import { defineChannel } from "./dispatch/define-channel.mjs";
 import { DefinedNotification, NotificationDef, defineNotification } from "./dispatch/define-notification.mjs";
@@ -14,6 +14,7 @@ import { notifications } from "./dispatch/notifications-event-bus.mjs";
 import "./dispatch/index.mjs";
 import { NotificationColumnMap, NotificationColumnMapHost, ResolvedNotificationColumnMap, resolveColumnMap } from "./in-app/column-map.mjs";
 import { DatabaseNotification } from "./in-app/database-notification.mjs";
+import { RecipientInput, recipientTypeOf, toRecipientRef } from "./in-app/recipient.mjs";
 import { BaseNotificationsRepository, NotificationModelClass, NotificationsFilter } from "./in-app/base-notifications-repository.mjs";
 import { databaseChannel } from "./channels/database-channel.mjs";
 import { MailChannelConfig, mailChannel } from "./channels/mail-channel.mjs";
@@ -29,6 +30,6 @@ import { BullmqQueueOptions, NOTIFICATION_JOB_NAME, bullmqQueue } from "./queue/
 import { QueuePackageLoader, loadQueuePackage } from "./queue/load-queue.mjs";
 import { QueuePackageNotInstalledError } from "./queue/queue-package-not-installed.error.mjs";
 import "./queue/index.mjs";
-export { BaseNotificationsRepository, BullmqQueueOptions, Channel, ChannelMap, ChannelName, ChannelNotFoundError, ConfigureOptions, DEFAULT_QUEUE_CHANNEL, DatabaseNotification, DatabasePayload, DefinedNotification, HeraldQueueOptions, Id, MailChannelConfig, MailPayload, MissingRendererError, NOTIFICATION_JOB_NAME, NoQueueDispatcherError, Notifiable, NotificationChannels, NotificationColumnMap, NotificationColumnMapHost, NotificationColumnsOptions, NotificationConfig, NotificationContract, NotificationDef, NotificationEvents, NotificationIdType, NotificationInput, NotificationModelClass, NotificationsFilter, NotificationsListOptions, NotificationsNotConfiguredError, Notify, PreferenceProvider, QueueDispatcher, type QueuePackageLoader, QueuePackageNotInstalledError, RateLimiter, RenderContext, ResolvedNotificationColumnMap, SendOptions, UnresolvableRouteError, WorkerOptions, bullmqQueue, databaseChannel, defineChannel, defineNotification, getNotificationConfig, heraldQueue, inApp, loadQueuePackage, mailChannel, notificationColumns, notifications, notify, resetNotificationConfig, resolveColumnMap, setNotificationConfig, startNotificationsWorker };
+export { BaseNotificationsRepository, BullmqQueueOptions, Channel, ChannelMap, ChannelName, ChannelNotFoundError, ConfigureOptions, DEFAULT_QUEUE_CHANNEL, DatabaseNotification, DatabasePayload, DefinedNotification, HeraldQueueOptions, Id, MailChannelConfig, MailPayload, MissingRendererError, NOTIFICATION_JOB_NAME, NoQueueDispatcherError, Notifiable, NotificationChannels, NotificationColumnMap, NotificationColumnMapHost, NotificationColumnsOptions, NotificationConfig, NotificationContract, NotificationDef, NotificationEvents, NotificationIdType, NotificationInput, NotificationModelClass, NotificationsFilter, NotificationsListOptions, NotificationsNotConfiguredError, Notify, PreferenceProvider, QueueDispatcher, type QueuePackageLoader, QueuePackageNotInstalledError, RateLimiter, RecipientInput, RecipientRef, RecipientTypeRequiredError, RenderContext, ResolvedNotificationColumnMap, SendOptions, UnresolvableRouteError, WorkerOptions, bullmqQueue, databaseChannel, defineChannel, defineNotification, getNotificationConfig, heraldQueue, inApp, loadQueuePackage, mailChannel, notificationColumns, notifications, notify, recipientTypeOf, resetNotificationConfig, resolveColumnMap, setNotificationConfig, startNotificationsWorker, toRecipientRef };
 import "./dispatch/define-channel.mjs";
 import "./types.mjs";

package/esm/index.mjs

@@ -1,10 +1,11 @@
-import { ChannelNotFoundError, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, UnresolvableRouteError } from "./errors.mjs";
+import { ChannelNotFoundError, MissingRendererError, NoQueueDispatcherError, NotificationsNotConfiguredError, RecipientTypeRequiredError, UnresolvableRouteError } from "./errors.mjs";
 import { getNotificationConfig, resetNotificationConfig, setNotificationConfig } from "./config.mjs";
 import { defineChannel } from "./dispatch/define-channel.mjs";
 import { notifications } from "./dispatch/notifications-event-bus.mjs";
 import { defineNotification } from "./dispatch/define-notification.mjs";
 import { notify } from "./dispatch/notify.mjs";
 import "./dispatch/index.mjs";
+import { recipientTypeOf, toRecipientRef } from "./in-app/recipient.mjs";
 import { databaseChannel } from "./channels/database-channel.mjs";
 import { mailChannel } from "./channels/mail-channel.mjs";
 import "./channels/index.mjs";
@@ -23,4 +24,4 @@ import { loadQueuePackage } from "./queue/load-queue.mjs";
 import { NOTIFICATION_JOB_NAME, bullmqQueue } from "./queue/bullmq-queue.mjs";
 import "./queue/index.mjs";
 
-export { BaseNotificationsRepository, ChannelNotFoundError, DEFAULT_QUEUE_CHANNEL, DatabaseNotification, MissingRendererError, NOTIFICATION_JOB_NAME, NoQueueDispatcherError, NotificationsNotConfiguredError, QueuePackageNotInstalledError, UnresolvableRouteError, bullmqQueue, databaseChannel, defineChannel, defineNotification, getNotificationConfig, heraldQueue, inApp, loadQueuePackage, mailChannel, notificationColumns, notifications, notify, resetNotificationConfig, resolveColumnMap, setNotificationConfig, startNotificationsWorker };
+export { BaseNotificationsRepository, ChannelNotFoundError, DEFAULT_QUEUE_CHANNEL, DatabaseNotification, MissingRendererError, NOTIFICATION_JOB_NAME, NoQueueDispatcherError, NotificationsNotConfiguredError, QueuePackageNotInstalledError, RecipientTypeRequiredError, UnresolvableRouteError, bullmqQueue, databaseChannel, defineChannel, defineNotification, getNotificationConfig, heraldQueue, inApp, loadQueuePackage, mailChannel, notificationColumns, notifications, notify, recipientTypeOf, resetNotificationConfig, resolveColumnMap, setNotificationConfig, startNotificationsWorker, toRecipientRef };

package/esm/migration/notification-columns.d.mts

@@ -3,8 +3,19 @@ import { ColumnMap } from "@warlock.js/cascade";
 //#region ../../packages/notifications/src/migration/notification-columns.d.ts
 export type NotificationIdType = "uuid" | "bigint" | "integer" | "string";
 export type NotificationColumnsOptions = {
-  /** The type used for recipient and tenant identifiers. Defaults to UUID. */
+  /**
+   * The type used for recipient and tenant identifiers. Defaults to the id
+   * type derived from `recipientModel` when given, otherwise UUID.
+   */
   idType?: NotificationIdType;
+  /**
+   * The recipient model (a `User`, `Customer`, …). Auto-generated ids are
+   * integers, so the id columns are `integer`; a model with
+   * `autoGenerateId = false` brings its own ids, so they are `uuid`.
+   */
+  recipientModel?: {
+    autoGenerateId?: boolean;
+  };
 };
 /**
  * Returns the column map for a notification table, named from the model's

package/esm/migration/notification-columns.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"notification-columns.d.mts","names":[],"sources":["../../../../../../../../packages/notifications/src/migration/notification-columns.ts"],"mappings":";;;YAsCY;YAEA;;EAEV,SAAS;;;;;;;wBAQK,oBAAoB,UAAU,6BAA6B;wBAC3D,oBACd,QAAQ,2BACR,UAAU,6BACT"}
+{"version":3,"file":"notification-columns.d.mts","names":[],"sources":["../../../../../../../../packages/notifications/src/migration/notification-columns.ts"],"mappings":";;;YA0CY;YAEA;;;;;EAKV,SAAS;;;;;;EAMT;IAAmB;;;;;;;;wBAQL,oBAAoB,UAAU,6BAA6B;wBAC3D,oBACd,QAAQ,2BACR,UAAU,6BACT"}

package/esm/migration/notification-columns.mjs

@@ -9,6 +9,10 @@ import { bigInteger, boolCol, integer, json, string, text, timestamp, uuid } fro
 * agree by construction. The stable lexical columns (`type`, `title`, `body`,
 * `payload`, `idempotency_key`) keep fixed names.
 *
+* `columnMap.recipientType` adds the recipient-type string column (see
+* `NotificationColumnMap`). For a table created earlier, add that column with a
+* migration instead of re-creating the table.
+*
 * Read-state follows the map's presence rules (see `NotificationColumnMap`):
 * `readAt` → a nullable timestamp, `isRead` → an indexed boolean, both → both.
 *
@@ -29,8 +33,9 @@ import { bigInteger, boolCol, integer, json, string, text, timestamp, uuid } fro
 */
 function notificationColumns(modelOrOptions, options) {
 	const model = isNotificationColumnsOptions(modelOrOptions) ? void 0 : modelOrOptions;
-	const idType = (isNotificationColumnsOptions(modelOrOptions) ? modelOrOptions : options)?.idType ?? "uuid";
-	const { recipient, tenant, readAt, isRead } = resolveColumnMap(model?.columnMap);
+	const resolvedOptions = isNotificationColumnsOptions(modelOrOptions) ? modelOrOptions : options;
+	const idType = resolvedOptions?.idType ?? deriveIdType(resolvedOptions?.recipientModel);
+	const { recipient, recipientType, tenant, readAt, isRead } = resolveColumnMap(model?.columnMap);
 	const idColumn = getIdColumn(idType);
 	const columns = {
 		[recipient]: idColumn().index().notNullable(),
@@ -39,6 +44,7 @@ function notificationColumns(modelOrOptions, options) {
 		body: text().nullable(),
 		payload: json().nullable()
 	};
+	if (recipientType) columns[recipientType] = string().index().notNullable();
 	if (readAt) columns[readAt] = timestamp().nullable();
 	if (isRead) columns[isRead] = boolCol().default(false).index();
 	if (tenant) columns[tenant] = idColumn().index().notNullable();
@@ -46,7 +52,7 @@ function notificationColumns(modelOrOptions, options) {
 	return columns;
 }
 function isNotificationColumnsOptions(value) {
-	return "idType" in (value ?? {});
+	return "idType" in (value ?? {}) || "recipientModel" in (value ?? {});
 }
 function getIdColumn(idType) {
 	switch (idType) {
@@ -56,6 +62,10 @@ function getIdColumn(idType) {
 		default: return uuid;
 	}
 }
+function deriveIdType(recipientModel) {
+	if (!recipientModel || recipientModel.autoGenerateId === false) return "uuid";
+	return "integer";
+}
 
 //#endregion
 export { notificationColumns };

package/esm/migration/notification-columns.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"notification-columns.mjs","names":[],"sources":["../../../../../../../../packages/notifications/src/migration/notification-columns.ts"],"sourcesContent":["/**\n * Column factory for the notifications table, driven by the model's\n * `columnMap`. The recipient / read-state / tenant columns take the NAMES the\n * model declares, so the table, the repository, and the model accessors all\n * agree by construction. The stable lexical columns (`type`, `title`, `body`,\n * `payload`, `idempotency_key`) keep fixed names.\n *\n * Read-state follows the map's presence rules (see `NotificationColumnMap`):\n * `readAt` → a nullable timestamp, `isRead` → an indexed boolean, both → both.\n *\n * Spread + extend for app-specific extras (FK references, composite indexes).\n *\n * @example\n *   import { Migration } from \"@warlock.js/cascade\";\n *   import { notificationColumns } from \"@warlock.js/notifications\";\n *   import { Notification } from \"../notification.model\";\n *\n *   export default Migration.create(Notification, notificationColumns(Notification));\n *\n * @example  // with extras (multi-tenant FK)\n *   export default Migration.create(Notification, {\n *     ...notificationColumns(Notification),\n *     organization_id: uuid().references(Organization.table).notNullable(),\n *   });\n */\nimport {\n  bigInteger,\n  boolCol,\n  type ColumnMap,\n  integer,\n  json,\n  string,\n  text,\n  timestamp,\n  uuid,\n} from \"@warlock.js/cascade\";\nimport { type NotificationColumnMapHost, resolveColumnMap } from \"../in-app/column-map\";\n\nexport type NotificationIdType = \"uuid\" | \"bigint\" | \"integer\" | \"string\";\n\nexport type NotificationColumnsOptions = {\n  /** The type used for recipient and tenant identifiers. Defaults to UUID. */\n  idType?: NotificationIdType;\n};\n\n/**\n * Returns the column map for a notification table, named from the model's\n * `columnMap`. Without a model, falls back to the resolved defaults\n * (`user_id` recipient + `read_at` read-state).\n */\nexport function notificationColumns(options?: NotificationColumnsOptions): ColumnMap;\nexport function notificationColumns(\n  model?: NotificationColumnMapHost,\n  options?: NotificationColumnsOptions,\n): ColumnMap;\nexport function notificationColumns(\n  modelOrOptions?: NotificationColumnMapHost | NotificationColumnsOptions,\n  options?: NotificationColumnsOptions,\n): ColumnMap {\n  const model = isNotificationColumnsOptions(modelOrOptions) ? undefined : modelOrOptions;\n  const idType =\n    (isNotificationColumnsOptions(modelOrOptions) ? modelOrOptions : options)?.idType ?? \"uuid\";\n  const { recipient, tenant, readAt, isRead } = resolveColumnMap(model?.columnMap);\n  const idColumn = getIdColumn(idType);\n\n  const columns: ColumnMap = {\n    [recipient]: idColumn().index().notNullable(),\n    type: string().index().notNullable(),\n    title: string().notNullable(),\n    body: text().nullable(),\n    payload: json().nullable(),\n  };\n\n  if (readAt) {\n    columns[readAt] = timestamp().nullable();\n  }\n\n  if (isRead) {\n    columns[isRead] = boolCol().default(false).index();\n  }\n\n  if (tenant) {\n    columns[tenant] = idColumn().index().notNullable();\n  }\n\n  // Unique so a retried send can't insert a duplicate. Nullable: most rows\n  // have no key (NULLs are distinct in a unique index). `createFor` does\n  // find-or-create; this constraint is the race backstop.\n  columns.idempotency_key = string().nullable().unique();\n\n  return columns;\n}\n\nfunction isNotificationColumnsOptions(\n  value: NotificationColumnMapHost | NotificationColumnsOptions | undefined,\n): value is NotificationColumnsOptions {\n  return \"idType\" in (value ?? {});\n}\n\nfunction getIdColumn(idType: NotificationIdType) {\n  switch (idType) {\n    case \"bigint\":\n      return bigInteger;\n    case \"integer\":\n      return integer;\n    case \"string\":\n      return string;\n    default:\n      return uuid;\n  }\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAuDA,SAAgB,oBACd,gBACA,SACW;CACX,MAAM,QAAQ,6BAA6B,cAAc,IAAI,SAAY;CACzE,MAAM,UACH,6BAA6B,cAAc,IAAI,iBAAiB,QAAO,EAAG,UAAU;CACvF,MAAM,EAAE,WAAW,QAAQ,QAAQ,WAAW,iBAAiB,OAAO,SAAS;CAC/E,MAAM,WAAW,YAAY,MAAM;CAEnC,MAAM,UAAqB;GACxB,YAAY,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;EAC5C,MAAM,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;EACnC,OAAO,OAAO,CAAC,CAAC,YAAY;EAC5B,MAAM,KAAK,CAAC,CAAC,SAAS;EACtB,SAAS,KAAK,CAAC,CAAC,SAAS;CAC3B;CAEA,IAAI,QACF,QAAQ,UAAU,UAAU,CAAC,CAAC,SAAS;CAGzC,IAAI,QACF,QAAQ,UAAU,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM;CAGnD,IAAI,QACF,QAAQ,UAAU,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;CAMnD,QAAQ,kBAAkB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;CAErD,OAAO;AACT;AAEA,SAAS,6BACP,OACqC;CACrC,OAAO,aAAa,SAAS,CAAC;AAChC;AAEA,SAAS,YAAY,QAA4B;CAC/C,QAAQ,QAAR;EACE,KAAK,UACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,SACE,OAAO;CACX;AACF"}
+{"version":3,"file":"notification-columns.mjs","names":[],"sources":["../../../../../../../../packages/notifications/src/migration/notification-columns.ts"],"sourcesContent":["/**\n * Column factory for the notifications table, driven by the model's\n * `columnMap`. The recipient / read-state / tenant columns take the NAMES the\n * model declares, so the table, the repository, and the model accessors all\n * agree by construction. The stable lexical columns (`type`, `title`, `body`,\n * `payload`, `idempotency_key`) keep fixed names.\n *\n * `columnMap.recipientType` adds the recipient-type string column (see\n * `NotificationColumnMap`). For a table created earlier, add that column with a\n * migration instead of re-creating the table.\n *\n * Read-state follows the map's presence rules (see `NotificationColumnMap`):\n * `readAt` → a nullable timestamp, `isRead` → an indexed boolean, both → both.\n *\n * Spread + extend for app-specific extras (FK references, composite indexes).\n *\n * @example\n *   import { Migration } from \"@warlock.js/cascade\";\n *   import { notificationColumns } from \"@warlock.js/notifications\";\n *   import { Notification } from \"../notification.model\";\n *\n *   export default Migration.create(Notification, notificationColumns(Notification));\n *\n * @example  // with extras (multi-tenant FK)\n *   export default Migration.create(Notification, {\n *     ...notificationColumns(Notification),\n *     organization_id: uuid().references(Organization.table).notNullable(),\n *   });\n */\nimport {\n  bigInteger,\n  boolCol,\n  type ColumnMap,\n  integer,\n  json,\n  string,\n  text,\n  timestamp,\n  uuid,\n} from \"@warlock.js/cascade\";\nimport { type NotificationColumnMapHost, resolveColumnMap } from \"../in-app/column-map\";\n\nexport type NotificationIdType = \"uuid\" | \"bigint\" | \"integer\" | \"string\";\n\nexport type NotificationColumnsOptions = {\n  /**\n   * The type used for recipient and tenant identifiers. Defaults to the id\n   * type derived from `recipientModel` when given, otherwise UUID.\n   */\n  idType?: NotificationIdType;\n  /**\n   * The recipient model (a `User`, `Customer`, …). Auto-generated ids are\n   * integers, so the id columns are `integer`; a model with\n   * `autoGenerateId = false` brings its own ids, so they are `uuid`.\n   */\n  recipientModel?: { autoGenerateId?: boolean };\n};\n\n/**\n * Returns the column map for a notification table, named from the model's\n * `columnMap`. Without a model, falls back to the resolved defaults\n * (`user_id` recipient + `read_at` read-state).\n */\nexport function notificationColumns(options?: NotificationColumnsOptions): ColumnMap;\nexport function notificationColumns(\n  model?: NotificationColumnMapHost,\n  options?: NotificationColumnsOptions,\n): ColumnMap;\nexport function notificationColumns(\n  modelOrOptions?: NotificationColumnMapHost | NotificationColumnsOptions,\n  options?: NotificationColumnsOptions,\n): ColumnMap {\n  const model = isNotificationColumnsOptions(modelOrOptions) ? undefined : modelOrOptions;\n  const resolvedOptions = isNotificationColumnsOptions(modelOrOptions) ? modelOrOptions : options;\n  const idType = resolvedOptions?.idType ?? deriveIdType(resolvedOptions?.recipientModel);\n  const { recipient, recipientType, tenant, readAt, isRead } = resolveColumnMap(model?.columnMap);\n  const idColumn = getIdColumn(idType);\n\n  const columns: ColumnMap = {\n    [recipient]: idColumn().index().notNullable(),\n    type: string().index().notNullable(),\n    title: string().notNullable(),\n    body: text().nullable(),\n    payload: json().nullable(),\n  };\n\n  if (recipientType) {\n    // Indexed together with the recipient id by the app's own composite index when needed.\n    columns[recipientType] = string().index().notNullable();\n  }\n\n  if (readAt) {\n    columns[readAt] = timestamp().nullable();\n  }\n\n  if (isRead) {\n    columns[isRead] = boolCol().default(false).index();\n  }\n\n  if (tenant) {\n    columns[tenant] = idColumn().index().notNullable();\n  }\n\n  // Unique so a retried send can't insert a duplicate. Nullable: most rows\n  // have no key (NULLs are distinct in a unique index). `createFor` does\n  // find-or-create; this constraint is the race backstop.\n  columns.idempotency_key = string().nullable().unique();\n\n  return columns;\n}\n\nfunction isNotificationColumnsOptions(\n  value: NotificationColumnMapHost | NotificationColumnsOptions | undefined,\n): value is NotificationColumnsOptions {\n  return \"idType\" in (value ?? {}) || \"recipientModel\" in (value ?? {});\n}\n\nfunction getIdColumn(idType: NotificationIdType) {\n  switch (idType) {\n    case \"bigint\":\n      return bigInteger;\n    case \"integer\":\n      return integer;\n    case \"string\":\n      return string;\n    default:\n      return uuid;\n  }\n}\n\nfunction deriveIdType(recipientModel?: { autoGenerateId?: boolean }): NotificationIdType {\n  if (!recipientModel || recipientModel.autoGenerateId === false) {\n    return \"uuid\";\n  }\n\n  return \"integer\";\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAoEA,SAAgB,oBACd,gBACA,SACW;CACX,MAAM,QAAQ,6BAA6B,cAAc,IAAI,SAAY;CACzE,MAAM,kBAAkB,6BAA6B,cAAc,IAAI,iBAAiB;CACxF,MAAM,SAAS,iBAAiB,UAAU,aAAa,iBAAiB,cAAc;CACtF,MAAM,EAAE,WAAW,eAAe,QAAQ,QAAQ,WAAW,iBAAiB,OAAO,SAAS;CAC9F,MAAM,WAAW,YAAY,MAAM;CAEnC,MAAM,UAAqB;GACxB,YAAY,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;EAC5C,MAAM,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;EACnC,OAAO,OAAO,CAAC,CAAC,YAAY;EAC5B,MAAM,KAAK,CAAC,CAAC,SAAS;EACtB,SAAS,KAAK,CAAC,CAAC,SAAS;CAC3B;CAEA,IAAI,eAEF,QAAQ,iBAAiB,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;CAGxD,IAAI,QACF,QAAQ,UAAU,UAAU,CAAC,CAAC,SAAS;CAGzC,IAAI,QACF,QAAQ,UAAU,QAAQ,CAAC,CAAC,QAAQ,KAAK,CAAC,CAAC,MAAM;CAGnD,IAAI,QACF,QAAQ,UAAU,SAAS,CAAC,CAAC,MAAM,CAAC,CAAC,YAAY;CAMnD,QAAQ,kBAAkB,OAAO,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO;CAErD,OAAO;AACT;AAEA,SAAS,6BACP,OACqC;CACrC,OAAO,aAAa,SAAS,CAAC,MAAM,qBAAqB,SAAS,CAAC;AACrE;AAEA,SAAS,YAAY,QAA4B;CAC/C,QAAQ,QAAR;EACE,KAAK,UACH,OAAO;EACT,KAAK,WACH,OAAO;EACT,KAAK,UACH,OAAO;EACT,SACE,OAAO;CACX;AACF;AAEA,SAAS,aAAa,gBAAmE;CACvF,IAAI,CAAC,kBAAkB,eAAe,mBAAmB,OACvD,OAAO;CAGT,OAAO;AACT"}

package/esm/types.d.mts

@@ -10,6 +10,16 @@ import { Model } from "@warlock.js/cascade";
 export type Notifiable = Model;
 /** An identifier — string (uuid / objectId) or number (auto-increment). */
 export type Id = string | number;
+/**
+ * A recipient named without its model: the identity `type` (an auth model's
+ * `userType`, otherwise its table name) plus its `id`. Use it where only the
+ * id is at hand but the notifications table keys recipients by type. A ref
+ * without `type` is treated like a bare id.
+ */
+export type RecipientRef = {
+  type?: string;
+  id: Id;
+};
 /** What the `mail` channel renders to and `core.sendMail` consumes. */
 export type MailPayload = {
   subject: string;
@@ -20,6 +30,8 @@ export type MailPayload = {
 /** Normalized in-app record shape written through the database channel. */
 export type NotificationInput = {
   recipientId: Id;
+  /** Identity type of the recipient — set by the channel from the recipient model. */
+  recipientType?: string;
   type: string;
   title: string;
   body?: string;
@@ -31,7 +43,7 @@ export type NotificationInput = {
  * Database payload as seen by RENDERERS — `recipientId` is set by the channel
  * from the resolved route, not by the render closure.
  */
-export type DatabasePayload = Omit<NotificationInput, "recipientId">;
+export type DatabasePayload = Omit<NotificationInput, "recipientId" | "recipientType">;
 /**
  * Channel REGISTRY — the single declaration-merge target mapping channel NAME
  * → payload type. Drives `notify.<channel>` proxy typing and

package/esm/types.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../packages/notifications/src/types.ts"],"mappings":";;;;;;;;;YAkBY,aAAa;;YAGb;;YAKA;EACV;EACA;EACA;EACA;;;YAIU;EACV,aAAa;EACb;EACA;EACA;EACA,UAAU;;EAEV;;;;;;YAOU,kBAAkB,KAAK;;;;;;;;;;;;;;iBAiBlB;EACf,MAAM;EACN,UAAU;;YAGA,oBAAoB;;;;;;;;;;;;;YAgBpB;;;;;;;;EAQV;;EAEA;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;;YAIU,gBAAgB,KAAK;;;;;;;;;;;;;;YAiBrB;EACV;IACE;IACA;IACA,aAAa;IACb;IACA,SAAS;;EAEX;IACE;IACA;IACA,aAAa;IACb;IACA,SAAS;IACT;;EAEF;IACE;IACA;IACA,aAAa;IACb;IACA,OAAO;IACP,SAAS;IACT;;EAEF;IACE;IACA;IACA,aAAa;IACb;IACA,SAAS"}
+{"version":3,"file":"types.d.mts","names":[],"sources":["../../../../../../../packages/notifications/src/types.ts"],"mappings":";;;;;;;;;YAkBY,aAAa;;YAGb;;;;;;;YAQA;EAAiB;EAAe,IAAI;;;YAKpC;EACV;EACA;EACA;EACA;;;YAIU;EACV,aAAa;;EAEb;EACA;EACA;EACA;EACA,UAAU;;EAEV;;;;;;YAOU,kBAAkB,KAAK;;;;;;;;;;;;;;iBAiBlB;EACf,MAAM;EACN,UAAU;;YAGA,oBAAoB;;;;;;;;;;;;;YAgBpB;;;;;;;;EAQV;;EAEA;;EAEA,OAAO;;EAEP;;EAEA;;EAEA;;;YAIU,gBAAgB,KAAK;;;;;;;;;;;;;;YAiBrB;EACV;IACE;IACA;IACA,aAAa;IACb;IACA,SAAS;;EAEX;IACE;IACA;IACA,aAAa;IACb;IACA,SAAS;IACT;;EAEF;IACE;IACA;IACA,aAAa;IACb;IACA,OAAO;IACP,SAAS;IACT;;EAEF;IACE;IACA;IACA,aAAa;IACb;IACA,SAAS"}

package/llms-full.txt

@@ -903,13 +903,18 @@ class BaseNotificationsRepository extends RepositoryManager {
 
 ### `createFor` write side — no IDOR either (since 4.15.0)
 
-`recipientId` is always the trusted argument, applied **after** the payload — `createFor`/`createManyFor` strip server-owned keys (`id`, `recipientId`, `tenant`, `readAt`, `isRead`, and their resolved `columnMap` physical column names) off `input` before merging. Before this, a caller passing an untyped payload straight through (request JSON, a channel's `send` args) could smuggle its own `recipientId` — or the raw physical column name — and write the notification into someone else's inbox. `type` / `title` / `body` / `payload` / `idempotencyKey` are untouched; you don't need to sanitize `input` yourself.
+`recipientId` (and `recipientType`) are always the trusted arguments, applied **after** the payload — `createFor`/`createManyFor` strip server-owned keys (`id`, `recipientId`, `recipientType`, `tenant`, `readAt`, `isRead`, and their resolved `columnMap` physical column names) off `input` before merging. Before this, a caller passing an untyped payload straight through (request JSON, a channel's `send` args) could smuggle its own `recipientId` — or the raw physical column name — and write the notification into someone else's inbox. `type` / `title` / `body` / `payload` / `idempotencyKey` are untouched; you don't need to sanitize `input` yourself.
+
+### Recipient types — identities that share an id
+
+Recipients are keyed by `(type, id)`. Declare `recipientType: "recipient_type"` in `columnMap` and every `inApp` read / count / mark / dismiss filters on both, so staff `5` and customer `5` never see each other's rows. The type is the recipient model's `userType` (auth models) or its table name; the `database` channel stores it. Also accepted: `{ type, id }` (`RecipientRef`). `recipientTypeOf(model)` returns the type a model is stored under, and `toRecipientRef(recipient)` turns a model or ref into `{ type, id }`. With the column declared a **bare id throws `RecipientTypeRequiredError`**; without it ids are the only key (single-identity apps, tables created before 5.46.0). Upgrading: add a nullable `recipient_type` column, backfill it (unbackfilled rows match no typed read), then declare it in `columnMap`. Full steps in the docs page "The in-app store".
 
 ### `columnMap` — map logical roles → your columns
 
 ```ts
 export type NotificationColumnMap = {
   recipient?: string; // recipient FK. Default "user_id"
+  recipientType?: string; // recipient identity type column. Omit → ids are the only key
   tenant?: string; // multi-tenant scope, written from the recipient. Omit → single-tenant
   readAt?: string; // read-timestamp column
   isRead?: string; // read-flag column (indexed)
@@ -992,7 +997,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`. 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 — the `write-migration` topic of the `warlock-js-cascade` skill; the model itself — the `use-in-app` topic.'
+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`. Id columns default to UUID; pass `{ recipientModel: User }` to derive them (integer, or UUID when the model has `autoGenerateId = false`) or `{ idType }` to set them. `columnMap.recipientType` adds a `recipient_type` string column. 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 — the `write-migration` topic of the `warlock-js-cascade` skill; the model itself — the `use-in-app` topic.'
 ---
 
 # Write the notifications migration
@@ -1018,6 +1023,7 @@ matching columns:
 | -------------------------------------------------- | --------------------------------------------------------------------------- |
 | _(none / default)_                                 | `user_id`, `type`, `title`, `body`, `payload`, `read_at`, `idempotency_key` |
 | `{ tenant: "organization_id", readAt: "read_at" }` | adds `organization_id`; read_at-only                                        |
+| `{ recipientType: "recipient_type" }`              | adds `recipient_type` (the identity type that owns the row)                 |
 | `{ isRead: "is_read" }`                            | swaps `read_at` for `is_read` (indexed boolean)                             |
 | `{ isRead: "is_read", readAt: "read_at" }`         | both read-state columns                                                     |
 
@@ -1025,10 +1031,11 @@ 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.
 
+Declare `recipientType` so different identity types sharing an id cannot read each other's notifications (see the `use-in-app` topic). For a table that already exists, add the column with `Migration.alter` and backfill it.
+
 ## 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
+Recipient and tenant columns default to UUID. For integer-id apps pass `recipientModel: User` (auto-generated ids give `integer`; `autoGenerateId = false` keeps UUID) or set `idType` (`"uuid"`, `"bigint"`, `"integer"`, `"string"`) explicitly; it is applied to every
 identifier column the factory creates:
 
 ```ts

package/llms.txt

@@ -15,4 +15,4 @@
 - [queue-notifications](@warlock.js/notifications/skills/queue-notifications/SKILL.md): Send notifications asynchronously through the herald backend or the BullMQ driver. Configure a QueueDispatcher in config/notifications.ts, then use notif.queue(to, data, options?) to enqueue rendered jobs. Herald uses heraldQueue() and startNotificationsWorker(); bullmqQueue({ attempts, backoff }) from @warlock.js/notifications uses BullMQ (lazy-loading the optional @warlock.js/queue peer), supports retries, and honours SendOptions.delay. Without a queue configured, .queue() rejects NoQueueDispatcherError. Triggers: heraldQueue, bullmqQueue, startNotificationsWorker, QueueDispatcher, .queue(, async notifications, queue notifications, notification worker, background notifications, notifications.dispatch. Skip: synchronous sends - the `define-notification` topic; herald itself - @warlock.js/herald/*.
 - [send-ad-hoc](@warlock.js/notifications/skills/send-ad-hoc/SKILL.md): Ad-hoc per-channel send via the `notify.<channel>(to, payload, options?)` Proxy facade. Works for any channel registered in `NotificationChannels` (built-in or custom). `to` accepts a `Notifiable` model OR a raw route string (`"x@y.com"`); `payload` is typed per channel via the registry; `options` is the standard `SendOptions`. `notify.channel(name).send(...)` is the runtime escape when the channel name is not a compile-time literal. Type-based preference gating applies when a type is known — explicit via `options.type` OR auto-detected from a database payload's `type` field. For multi-channel sends use `defineNotification` instead — there is no inline `notify(to, { via, ... })` form on purpose. Triggers: `notify.<channel>`, `notify.channel(name)`, `notify.mail`, `notify.database`, "send a one-off notification", "ad-hoc notification", "send an email without defining a notification", "raw email target", "dynamic channel name"; typical import `import { notify } from "@warlock.js/notifications"`. Skip: reusable multi-channel notifications — the `define-notification` topic; configuring channels — the `configure-notifications` topic.
 - [use-in-app](@warlock.js/notifications/skills/use-in-app/SKILL.md): Use the `inApp` facade for the in-app/database channel's READ side: `inApp.configure({ model: Notification })` or `{ repository: myRepo }` binds the store AND returns the channel; `inApp.list / listUnread / countUnread / markAsRead / markAsUnread` are RECIPIENT-SCOPED by construction (no IDOR — `markAsRead(user, id)` cannot flip another user's row even with a foreign id). `countUnread` uses `RepositoryManager.countCached` for the badge fast-path. Triggers: `inApp.configure`, `inApp.list`, `inApp.listUnread`, `inApp.countUnread`, `inApp.markAsRead`, `inApp.markAsUnread`, `BaseNotificationsRepository`, `DatabaseNotification`, `NotificationsFilter`, "in-app notifications", "mark notification as read", "unread count", "notification badge", "IDOR-safe markAsRead"; typical import `import { inApp } from "@warlock.js/notifications"`. Skip: writing notifications (use `defineNotification` or `notify.database`) — the `define-notification` topic; the migration columns — the `write-notification-migration` topic; wiring it into config — the `configure-notifications` topic.
-- [write-notification-migration](@warlock.js/notifications/skills/write-notification-migration/SKILL.md): 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 — the `write-migration` topic of the `warlock-js-cascade` skill; the model itself — the `use-in-app` topic.
+- [write-notification-migration](@warlock.js/notifications/skills/write-notification-migration/SKILL.md): 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`. Id columns default to UUID; pass `{ recipientModel: User }` to derive them (integer, or UUID when the model has `autoGenerateId = false`) or `{ idType }` to set them. `columnMap.recipientType` adds a `recipient_type` string column. 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 — the `write-migration` topic of the `warlock-js-cascade` skill; the model itself — the `use-in-app` topic.

package/package.json

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

package/skills/use-in-app/SKILL.md

@@ -89,13 +89,18 @@ class BaseNotificationsRepository extends RepositoryManager {
 
 ### `createFor` write side — no IDOR either (since 4.15.0)
 
-`recipientId` is always the trusted argument, applied **after** the payload — `createFor`/`createManyFor` strip server-owned keys (`id`, `recipientId`, `tenant`, `readAt`, `isRead`, and their resolved `columnMap` physical column names) off `input` before merging. Before this, a caller passing an untyped payload straight through (request JSON, a channel's `send` args) could smuggle its own `recipientId` — or the raw physical column name — and write the notification into someone else's inbox. `type` / `title` / `body` / `payload` / `idempotencyKey` are untouched; you don't need to sanitize `input` yourself.
+`recipientId` (and `recipientType`) are always the trusted arguments, applied **after** the payload — `createFor`/`createManyFor` strip server-owned keys (`id`, `recipientId`, `recipientType`, `tenant`, `readAt`, `isRead`, and their resolved `columnMap` physical column names) off `input` before merging. Before this, a caller passing an untyped payload straight through (request JSON, a channel's `send` args) could smuggle its own `recipientId` — or the raw physical column name — and write the notification into someone else's inbox. `type` / `title` / `body` / `payload` / `idempotencyKey` are untouched; you don't need to sanitize `input` yourself.
+
+### Recipient types — identities that share an id
+
+Recipients are keyed by `(type, id)`. Declare `recipientType: "recipient_type"` in `columnMap` and every `inApp` read / count / mark / dismiss filters on both, so staff `5` and customer `5` never see each other's rows. The type is the recipient model's `userType` (auth models) or its table name; the `database` channel stores it. Also accepted: `{ type, id }` (`RecipientRef`). `recipientTypeOf(model)` returns the type a model is stored under, and `toRecipientRef(recipient)` turns a model or ref into `{ type, id }`. With the column declared a **bare id throws `RecipientTypeRequiredError`**; without it ids are the only key (single-identity apps, tables created before 5.46.0). Upgrading: add a nullable `recipient_type` column, backfill it (unbackfilled rows match no typed read), then declare it in `columnMap`. Full steps in the docs page "The in-app store".
 
 ### `columnMap` — map logical roles → your columns
 
 ```ts
 export type NotificationColumnMap = {
   recipient?: string; // recipient FK. Default "user_id"
+  recipientType?: string; // recipient identity type column. Omit → ids are the only key
   tenant?: string; // multi-tenant scope, written from the recipient. Omit → single-tenant
   readAt?: string; // read-timestamp column
   isRead?: string; // read-flag column (indexed)

package/skills/write-notification-migration/SKILL.md

@@ -1,6 +1,6 @@
 ---
 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`. 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 — the `write-migration` topic of the `warlock-js-cascade` skill; the model itself — the `use-in-app` topic.'
+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`. Id columns default to UUID; pass `{ recipientModel: User }` to derive them (integer, or UUID when the model has `autoGenerateId = false`) or `{ idType }` to set them. `columnMap.recipientType` adds a `recipient_type` string column. 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 — the `write-migration` topic of the `warlock-js-cascade` skill; the model itself — the `use-in-app` topic.'
 ---
 
 # Write the notifications migration
@@ -26,6 +26,7 @@ matching columns:
 | -------------------------------------------------- | --------------------------------------------------------------------------- |
 | _(none / default)_                                 | `user_id`, `type`, `title`, `body`, `payload`, `read_at`, `idempotency_key` |
 | `{ tenant: "organization_id", readAt: "read_at" }` | adds `organization_id`; read_at-only                                        |
+| `{ recipientType: "recipient_type" }`              | adds `recipient_type` (the identity type that owns the row)                 |
 | `{ isRead: "is_read" }`                            | swaps `read_at` for `is_read` (indexed boolean)                             |
 | `{ isRead: "is_read", readAt: "read_at" }`         | both read-state columns                                                     |
 
@@ -33,10 +34,11 @@ 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.
 
+Declare `recipientType` so different identity types sharing an id cannot read each other's notifications (see the `use-in-app` topic). For a table that already exists, add the column with `Migration.alter` and backfill it.
+
 ## 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
+Recipient and tenant columns default to UUID. For integer-id apps pass `recipientModel: User` (auto-generated ids give `integer`; `autoGenerateId = false` keeps UUID) or set `idType` (`"uuid"`, `"bigint"`, `"integer"`, `"string"`) explicitly; it is applied to every
 identifier column the factory creates:
 
 ```ts