@endora-commerce/mod-admin-notifications 0.0.0-stage → 0.100.0

package/dist/migrations/20260611T140350_admin_notifications_init.js

@@ -0,0 +1,82 @@
+import { Migration } from '@mikro-orm/migrations';
+/**
+ * Admin notifications — minimal "bell" surface introduced by feature 026.
+ *
+ * One row per notification. `audience='all_admins'` rows are visible to
+ * every admin (the read state is tracked per-admin in a future iteration
+ * via `admin_notification_reads`; for the first iteration we keep `read_at`
+ * on the row itself for `audience='admin_user'` rows only, and rely on the
+ * `mark-all-read` endpoint stamping a per-admin "last seen" cursor —
+ * implemented in code, not in this schema).
+ *
+ * Unread cap is enforced by application code (`pruneStale()`), not by the
+ * schema.
+ */
+export class Migration20260611T140350AdminNotificationsInit extends Migration {
+    async up() {
+        this.addSql(`
+      create table "admin_notifications" (
+        "id" uuid not null,
+        "audience" varchar(16) not null,
+        "target_admin_user_id" uuid null,
+        "kind" varchar(64) not null,
+        "subject_type" varchar(64) null,
+        "subject_id" uuid null,
+        "title" varchar(255) not null,
+        "body" text null,
+        "link_path" varchar(255) null,
+        "created_at" timestamptz not null default now(),
+        "read_at" timestamptz null,
+        "archived_at" timestamptz null,
+        constraint "admin_notifications_pkey" primary key ("id"),
+        constraint "admin_notifications_audience_check"
+          check ("audience" in ('all_admins', 'admin_user')),
+        constraint "admin_notifications_target_consistency_check"
+          check (
+            ("audience" = 'all_admins' and "target_admin_user_id" is null)
+            or ("audience" = 'admin_user' and "target_admin_user_id" is not null)
+          ),
+        constraint "admin_notifications_target_admin_user_fk"
+          foreign key ("target_admin_user_id") references "admin_users" ("id") on delete cascade
+      );
+    `);
+        // Feed query: most-recent first, filtered by audience + (optionally)
+        // target admin.
+        this.addSql(`
+      create index "admin_notifications_audience_idx"
+        on "admin_notifications" ("audience", "target_admin_user_id", "created_at" desc);
+    `);
+        // Partial index for the unread-count fast path.
+        this.addSql(`
+      create index "admin_notifications_unread_idx"
+        on "admin_notifications" ("audience", "target_admin_user_id")
+        where "read_at" is null and "archived_at" is null;
+    `);
+        // Per-admin read cursor for `audience='all_admins'` rows.
+        // (Each admin marks their own copy of a broadcast notification as read.)
+        this.addSql(`
+      create table "admin_notification_reads" (
+        "notification_id" uuid not null,
+        "admin_user_id" uuid not null,
+        "read_at" timestamptz not null default now(),
+        constraint "admin_notification_reads_pkey"
+          primary key ("notification_id", "admin_user_id"),
+        constraint "admin_notification_reads_notification_fk"
+          foreign key ("notification_id") references "admin_notifications" ("id") on delete cascade,
+        constraint "admin_notification_reads_admin_user_fk"
+          foreign key ("admin_user_id") references "admin_users" ("id") on delete cascade
+      );
+    `);
+        this.addSql(`
+      create index "admin_notification_reads_admin_user_idx"
+        on "admin_notification_reads" ("admin_user_id");
+    `);
+    }
+    async down() {
+        this.addSql(`drop table if exists "admin_notification_reads" cascade;`);
+        this.addSql(`drop index if exists "admin_notifications_audience_idx";`);
+        this.addSql(`drop index if exists "admin_notifications_unread_idx";`);
+        this.addSql(`drop table if exists "admin_notifications" cascade;`);
+    }
+}
+//# sourceMappingURL=20260611T140350_admin_notifications_init.js.map

package/dist/migrations/20260611T140350_admin_notifications_init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"20260611T140350_admin_notifications_init.js","sourceRoot":"","sources":["../../src/migrations/20260611T140350_admin_notifications_init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAElD;;;;;;;;;;;;GAYG;AACH,MAAM,OAAO,8CAA+C,SAAQ,SAAS;IAClE,KAAK,CAAC,EAAE;QACf,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;KAyBX,CAAC,CAAC;QAEH,qEAAqE;QACrE,gBAAgB;QAChB,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;QAEH,gDAAgD;QAChD,IAAI,CAAC,MAAM,CAAC;;;;KAIX,CAAC,CAAC;QAEH,0DAA0D;QAC1D,yEAAyE;QACzE,IAAI,CAAC,MAAM,CAAC;;;;;;;;;;;;KAYX,CAAC,CAAC;QAEH,IAAI,CAAC,MAAM,CAAC;;;KAGX,CAAC,CAAC;IACL,CAAC;IAEQ,KAAK,CAAC,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,0DAA0D,CAAC,CAAC;QACxE,IAAI,CAAC,MAAM,CAAC,wDAAwD,CAAC,CAAC;QACtE,IAAI,CAAC,MAAM,CAAC,qDAAqD,CAAC,CAAC;IACrE,CAAC;CACF"}

package/dist/migrations/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260611T140350AdminNotificationsInit } from './20260611T140350_admin_notifications_init.js';
+export declare const migrations: (typeof Migration20260611T140350AdminNotificationsInit)[];
+export { Migration20260611T140350AdminNotificationsInit, };
+//# sourceMappingURL=index.d.ts.map

package/dist/migrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,8CAA8C,EAAE,MAAM,+CAA+C,CAAC;AAE/G,eAAO,MAAM,UAAU,2DAEtB,CAAC;AAEF,OAAO,EACL,8CAA8C,GAC/C,CAAC"}

package/dist/migrations/index.js

@@ -0,0 +1,29 @@
+/**
+ * The `./migrations` subpath — every migration class this module owns, as one
+ * ordered `migrations` array.
+ *
+ * The array is what the platform reads when this module is **installed**:
+ * `src/packages/package-runtime.ts` takes `exported['migrations']` and refuses
+ * the package outright when it is absent (D-168).
+ *
+ * Listed in ascending timestamp, which is the order of this module's own
+ * migrations and of nothing else (feature 081): a manifest `dependencies` array
+ * is the only thing ordering this block against another module's.
+ *
+ * The **named** exports stay beside the array, and the asymmetry with
+ * `./backend` — which publishes an array and no named class (D-168) — is
+ * deliberate. `db/migrations-registry.generated.ts` imports each class by name
+ * from this specifier, and a migration class name is contract in a way an entity
+ * class name is not: `mikro_orm_migrations` persists it, so it is a string every
+ * already-migrated database holds.
+ *
+ * A class that is in neither the array nor the barrel is a migration that does
+ * not run: `migration:pending` reports nothing pending and the first symptom is
+ * a query against a table nobody created.
+ */
+import { Migration20260611T140350AdminNotificationsInit } from './20260611T140350_admin_notifications_init.js';
+export const migrations = [
+    Migration20260611T140350AdminNotificationsInit,
+];
+export { Migration20260611T140350AdminNotificationsInit, };
+//# sourceMappingURL=index.js.map

package/dist/migrations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/migrations/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,EAAE,8CAA8C,EAAE,MAAM,+CAA+C,CAAC;AAE/G,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,8CAA8C;CAC/C,CAAC;AAEF,OAAO,EACL,8CAA8C,GAC/C,CAAC"}

package/package.json

@@ -1,6 +1,66 @@
 {
   "name": "@endora-commerce/mod-admin-notifications",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.100.0",
+  "type": "module",
+  "sideEffects": false,
+  "description": "In-app notification feed surfaced in the admin top-nav bell. Generic so any module can write entries.",
+  "license": "MIT",
+  "endora": {
+    "type": "module",
+    "id": "admin_notifications"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/endora-commerce/endora-commerce.git",
+    "directory": "packages/modules/admin_notifications"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/manifest.d.ts",
+      "default": "./dist/manifest.js"
+    },
+    "./backend": {
+      "types": "./dist/backend/index.d.ts",
+      "default": "./dist/backend/index.js"
+    },
+    "./migrations": {
+      "types": "./dist/migrations/index.d.ts",
+      "default": "./dist/migrations/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "peerDependencies": {
+    "@mikro-orm/core": "^6",
+    "@mikro-orm/migrations": "^6",
+    "@mikro-orm/postgresql": "^6",
+    "fastify": "^5",
+    "zod": "^4",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "devDependencies": {
+    "@mikro-orm/core": "^6.6.13",
+    "@mikro-orm/migrations": "^6.6.13",
+    "@mikro-orm/postgresql": "^6.6.13",
+    "@types/node": "^22.9.0",
+    "fastify": "^5.12.5",
+    "typescript": "^5.9.3",
+    "zod": "^4.2.0",
+    "@endora-commerce/contracts": "0.100.0",
+    "@endora-commerce/platform": "0.100.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json",
+    "lint": "eslint src"
+  }
 }