@cyguin/notify 0.1.0

package/.github/workflows/publish.yml

@@ -0,0 +1,27 @@
+name: Publish to npm
+
+on:
+  push:
+    tags:
+      - 'v*'
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+      id-token: write
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '20'
+          registry-url: 'https://registry.npmjs.org'
+      - name: Install dependencies
+        run: npm install --legacy-peer-deps
+      - name: Build
+        run: npm run build
+      - name: Publish
+        env:
+          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm publish --provenance --access public

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2026 cyguin.com
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,152 @@
+# @cyguin/notify
+
+Server-triggered in-app notifications for Next.js apps.
+
+## Install
+
+```bash
+npm install @cyguin/notify
+```
+
+## Setup
+
+### 1. Create the API route
+
+Create `app/api/notify/[...cyguin]/route.ts` in your Next.js app:
+
+```ts
+import { createNotifyHandler } from '@cyguin/notify/next';
+import Database from 'better-sqlite3';
+import { createSQLiteAdapter } from '@cyguin/notify/adapters/sqlite';
+
+const db = new Database('notify.db');
+db.pragma('journal_mode = WAL');
+const adapter = createSQLiteAdapter(db);
+
+const handler = createNotifyHandler({ adapter });
+
+export { handler as GET, handler as POST, handler as PATCH };
+```
+
+### 2. Run migrations
+
+```sql
+CREATE TABLE notifications (
+  id          TEXT PRIMARY KEY,
+  user_id     TEXT NOT NULL,
+  title       TEXT NOT NULL,
+  body        TEXT NOT NULL,
+  href        TEXT,
+  read_at     INTEGER,
+  created_at  INTEGER NOT NULL
+);
+```
+
+### 3. Configure the adapter at startup
+
+In your app startup (e.g., a setup file or server entry):
+
+```ts
+import { setNotificationAdapter } from '@cyguin/notify';
+import { createSQLiteAdapter } from '@cyguin/notify/adapters/sqlite';
+
+const adapter = createSQLiteAdapter(db);
+setNotificationAdapter(adapter);
+```
+
+### 4. Trigger notifications from your server code
+
+```ts
+import { notify } from '@cyguin/notify';
+
+// In a server action, API route, or background job:
+await notify(userId, {
+  title: 'Export ready',
+  body: 'Your data export is ready to download.',
+  href: '/exports/123',
+});
+```
+
+### 5. Add the notification bell
+
+```tsx
+import { NotificationBell } from '@cyguin/notify/react';
+
+export default function Header({ user }: { user: { id: string } }) {
+  return (
+    <header>
+      <nav>...</nav>
+      <NotificationBell
+        userId={user.id}
+        pollInterval={30000}
+        maxVisible={10}
+        onToggle={(open) => console.log('Dropdown:', open)}
+      />
+    </header>
+  );
+}
+```
+
+## API Routes
+
+| Method | Route | Description |
+|--------|-------|-------------|
+| GET | `/api/notify?userId=xxx&limit=N` | List notifications for user |
+| POST | `/api/notify` | Create notification (internal) |
+| PATCH | `/api/notify/:id/read?userId=xxx` | Mark notification as read |
+
+## NotificationBell Props
+
+| Prop | Default | Description |
+|------|---------|-------------|
+| `userId` | — | User ID to fetch notifications for. |
+| `pollInterval` | `30000` | Polling interval in ms. Pass `0` to disable. |
+| `maxVisible` | `10` | Max notifications to show in dropdown. |
+| `className` | `''` | CSS class for the root element. |
+| `onToggle` | — | Callback when dropdown opens/closes. |
+
+## Theming
+
+Use `--cyguin-*` CSS custom properties on `.cyguin-notify-bell`:
+
+```css
+.cyguin-notify-bell {
+  --cyguin-bg: #ffffff;
+  --cyguin-fg: #0a0a0a;
+  --cyguin-accent: #f5a800;
+  --cyguin-border: #e5e5e5;
+  --cyguin-radius: 6px;
+  --cyguin-shadow: 0 1px 4px rgba(0,0,0,0.08);
+}
+```
+
+Switch to dark theme with the `theme` prop on the inner button element via CSS:
+
+```css
+.cyguin-notify-bell[data-theme="dark"] {
+  --cyguin-bg: #0a0a0a;
+  --cyguin-bg-subtle: #1a1a1a;
+  --cyguin-border: #2a2a2a;
+  --cyguin-fg: #f5f5f5;
+  --cyguin-shadow: 0 1px 4px rgba(0,0,0,0.4);
+}
+```
+
+## Postgres Setup
+
+```ts
+import { createNotifyHandler } from '@cyguin/notify/next';
+import postgres from 'postgres';
+import { createPostgresAdapter } from '@cyguin/notify/adapters/postgres';
+
+const sql = postgres(process.env.DATABASE_URL!);
+const adapter = createPostgresAdapter(sql);
+
+const handler = createNotifyHandler({ adapter });
+
+export { handler as GET, handler as POST, handler as PATCH };
+```
+
+## License
+
+MIT

package/dist/adapters/postgres.cjs

@@ -0,0 +1,7 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+var _chunkHW23IB3Rcjs = require('../chunk-HW23IB3R.cjs');
+require('../chunk-N3OMUVHL.cjs');
+
+
+exports.createPostgresAdapter = _chunkHW23IB3Rcjs.createPostgresAdapter;

package/dist/adapters/postgres.d.cts

@@ -0,0 +1,5 @@
+import { a as NotificationAdapter } from '../types-Q62lBJZ-.cjs';
+
+declare function createPostgresAdapter(connectionString: string): NotificationAdapter;
+
+export { createPostgresAdapter };

package/dist/adapters/postgres.d.ts

@@ -0,0 +1,5 @@
+import { a as NotificationAdapter } from '../types-Q62lBJZ-.js';
+
+declare function createPostgresAdapter(connectionString: string): NotificationAdapter;
+
+export { createPostgresAdapter };

package/dist/adapters/postgres.js

@@ -0,0 +1,7 @@
+import {
+  createPostgresAdapter
+} from "../chunk-VKPJWS2D.js";
+import "../chunk-4SP667TN.js";
+export {
+  createPostgresAdapter
+};

package/dist/adapters/sqlite.cjs

@@ -0,0 +1,9 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});
+
+
+var _chunkDBFBHOZIcjs = require('../chunk-DBFBHOZI.cjs');
+require('../chunk-N3OMUVHL.cjs');
+
+
+
+exports.SQLiteNotificationAdapter = _chunkDBFBHOZIcjs.SQLiteNotificationAdapter; exports.createSQLiteAdapter = _chunkDBFBHOZIcjs.createSQLiteAdapter;

package/dist/adapters/sqlite.d.cts

@@ -0,0 +1,6 @@
+import { a as NotificationAdapter } from '../types-Q62lBJZ-.cjs';
+
+declare const SQLiteNotificationAdapter: NotificationAdapter;
+declare function createSQLiteAdapter(): NotificationAdapter;
+
+export { SQLiteNotificationAdapter, createSQLiteAdapter };

package/dist/adapters/sqlite.d.ts

@@ -0,0 +1,6 @@
+import { a as NotificationAdapter } from '../types-Q62lBJZ-.js';
+
+declare const SQLiteNotificationAdapter: NotificationAdapter;
+declare function createSQLiteAdapter(): NotificationAdapter;
+
+export { SQLiteNotificationAdapter, createSQLiteAdapter };

package/dist/adapters/sqlite.js

@@ -0,0 +1,9 @@
+import {
+  SQLiteNotificationAdapter,
+  createSQLiteAdapter
+} from "../chunk-QHPFQN2C.js";
+import "../chunk-4SP667TN.js";
+export {
+  SQLiteNotificationAdapter,
+  createSQLiteAdapter
+};

package/dist/chunk-4SP667TN.js

@@ -0,0 +1,33 @@
+// node_modules/nanoid/index.js
+import crypto from "crypto";
+
+// node_modules/nanoid/url-alphabet/index.js
+var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+
+// node_modules/nanoid/index.js
+var POOL_SIZE_MULTIPLIER = 128;
+var pool;
+var poolOffset;
+var fillPool = (bytes) => {
+  if (!pool || pool.length < bytes) {
+    pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER);
+    crypto.randomFillSync(pool);
+    poolOffset = 0;
+  } else if (poolOffset + bytes > pool.length) {
+    crypto.randomFillSync(pool);
+    poolOffset = 0;
+  }
+  poolOffset += bytes;
+};
+var nanoid = (size = 21) => {
+  fillPool(size |= 0);
+  let id = "";
+  for (let i = poolOffset - size; i < poolOffset; i++) {
+    id += urlAlphabet[pool[i] & 63];
+  }
+  return id;
+};
+
+export {
+  nanoid
+};

package/dist/chunk-DBFBHOZI.cjs

@@ -0,0 +1,82 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }
+
+var _chunkN3OMUVHLcjs = require('./chunk-N3OMUVHL.cjs');
+
+// src/adapters/sqlite.ts
+var _bettersqlite3 = require('better-sqlite3'); var _bettersqlite32 = _interopRequireDefault(_bettersqlite3);
+var _db = null;
+function getDb() {
+  if (!_db) {
+    _db = new (0, _bettersqlite32.default)(":memory:");
+    _db.pragma("journal_mode = WAL");
+    _db.exec(`
+      CREATE TABLE IF NOT EXISTS notifications (
+        id          TEXT PRIMARY KEY,
+        user_id     TEXT NOT NULL,
+        title       TEXT NOT NULL,
+        body        TEXT NOT NULL,
+        href        TEXT,
+        read_at     INTEGER,
+        created_at  INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_notifications_user_id ON notifications(user_id);
+      CREATE INDEX IF NOT EXISTS idx_notifications_created_at ON notifications(created_at);
+    `);
+  }
+  return _db;
+}
+function rowToRecord(row) {
+  return {
+    id: row.id,
+    userId: row.user_id,
+    title: row.title,
+    body: row.body,
+    href: row.href,
+    readAt: row.read_at,
+    createdAt: row.created_at
+  };
+}
+var SQLiteNotificationAdapter = {
+  async create(notification) {
+    const db = getDb();
+    const id = _chunkN3OMUVHLcjs.nanoid.call(void 0, );
+    const createdAt = Date.now();
+    db.prepare(`
+      INSERT INTO notifications (id, user_id, title, body, href, created_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(id, notification.userId, notification.title, notification.body, _nullishCoalesce(notification.href, () => ( null)), createdAt);
+    return { id, ...notification, createdAt };
+  },
+  async findManyByUser(userId, { limit = 20, offset = 0 } = {}) {
+    const db = getDb();
+    const rows = db.prepare(`
+      SELECT id, user_id, title, body, href, read_at, created_at
+      FROM notifications
+      WHERE user_id = ?
+      ORDER BY created_at DESC
+      LIMIT ? OFFSET ?
+    `).all(userId, limit, offset);
+    return rows.map(rowToRecord);
+  },
+  async markRead(id, userId) {
+    const db = getDb();
+    db.prepare(`
+      UPDATE notifications SET read_at = ? WHERE id = ? AND user_id = ?
+    `).run(Date.now(), id, userId);
+  },
+  async countUnread(userId) {
+    const db = getDb();
+    const row = db.prepare(`
+      SELECT COUNT(*) as count FROM notifications WHERE user_id = ? AND read_at IS NULL
+    `).get(userId);
+    return row.count;
+  }
+};
+function createSQLiteAdapter() {
+  return SQLiteNotificationAdapter;
+}
+
+
+
+
+exports.SQLiteNotificationAdapter = SQLiteNotificationAdapter; exports.createSQLiteAdapter = createSQLiteAdapter;

package/dist/chunk-HW23IB3R.cjs

@@ -0,0 +1,59 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkN3OMUVHLcjs = require('./chunk-N3OMUVHL.cjs');
+
+// src/adapters/postgres.ts
+function createPostgresAdapter(connectionString) {
+  const pool = globalThis.__cyguin_postgres_pool;
+  const sql = pool ? (q, p) => pool.query(q, p).then((r) => r.rows) : async (_q, _p) => {
+    throw new Error("Postgres pool not initialized");
+  };
+  return {
+    async create(notification) {
+      const id = _chunkN3OMUVHLcjs.nanoid.call(void 0, );
+      const createdAt = Date.now();
+      await sql(
+        `INSERT INTO notifications (id, user_id, title, body, href, created_at)
+         VALUES ($1, $2, $3, $4, $5, $6)`,
+        [id, notification.userId, notification.title, notification.body, _nullishCoalesce(notification.href, () => ( null)), createdAt]
+      );
+      return { id, ...notification, createdAt };
+    },
+    async findManyByUser(userId, { limit = 20, offset = 0 } = {}) {
+      const rows = await sql(
+        `SELECT id, user_id, title, body, href, read_at, created_at
+         FROM notifications
+         WHERE user_id = $1
+         ORDER BY created_at DESC
+         LIMIT $2 OFFSET $3`,
+        [userId, limit, offset]
+      );
+      return rows.map((row) => ({
+        id: row.id,
+        userId: row.user_id,
+        title: row.title,
+        body: row.body,
+        href: row.href,
+        readAt: row.read_at,
+        createdAt: row.created_at
+      }));
+    },
+    async markRead(id, userId) {
+      await sql(
+        `UPDATE notifications SET read_at = $1 WHERE id = $2 AND user_id = $3`,
+        [Date.now(), id, userId]
+      );
+    },
+    async countUnread(userId) {
+      const rows = await sql(
+        `SELECT COUNT(*) as count FROM notifications WHERE user_id = $1 AND read_at IS NULL`,
+        [userId]
+      );
+      return Number(_nullishCoalesce(_optionalChain([rows, 'access', _ => _[0], 'optionalAccess', _2 => _2.count]), () => ( 0)));
+    }
+  };
+}
+
+
+
+exports.createPostgresAdapter = createPostgresAdapter;

package/dist/chunk-N3OMUVHL.cjs

@@ -0,0 +1,33 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; }// node_modules/nanoid/index.js
+var _crypto = require('crypto'); var _crypto2 = _interopRequireDefault(_crypto);
+
+// node_modules/nanoid/url-alphabet/index.js
+var urlAlphabet = "useandom-26T198340PX75pxJACKVERYMINDBUSHWOLF_GQZbfghjklqvwyzrict";
+
+// node_modules/nanoid/index.js
+var POOL_SIZE_MULTIPLIER = 128;
+var pool;
+var poolOffset;
+var fillPool = (bytes) => {
+  if (!pool || pool.length < bytes) {
+    pool = Buffer.allocUnsafe(bytes * POOL_SIZE_MULTIPLIER);
+    _crypto2.default.randomFillSync(pool);
+    poolOffset = 0;
+  } else if (poolOffset + bytes > pool.length) {
+    _crypto2.default.randomFillSync(pool);
+    poolOffset = 0;
+  }
+  poolOffset += bytes;
+};
+var nanoid = (size = 21) => {
+  fillPool(size |= 0);
+  let id = "";
+  for (let i = poolOffset - size; i < poolOffset; i++) {
+    id += urlAlphabet[pool[i] & 63];
+  }
+  return id;
+};
+
+
+
+exports.nanoid = nanoid;

package/dist/chunk-NJEVZBJ7.cjs

@@ -0,0 +1,67 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } }// src/handlers/route.ts
+var _server = require('next/server');
+
+// src/di.ts
+var NOTIFICATION_ADAPTER = /* @__PURE__ */ Symbol.for("@cyguin/notify/NotificationAdapter");
+var _adapter = null;
+function setNotificationAdapter(adapter) {
+  _adapter = adapter;
+}
+function getNotificationAdapter() {
+  if (!_adapter) {
+    throw new Error(
+      "[@cyguin/notify] Notification adapter not set. Call setNotificationAdapter() before using notify()."
+    );
+  }
+  return _adapter;
+}
+
+// src/handlers/route.ts
+function createNotifyHandler(_options) {
+  const adapter = getNotificationAdapter();
+  return {
+    async GET(request) {
+      const url = new URL(request.url);
+      const userId = url.searchParams.get("userId");
+      if (!userId) {
+        return _server.NextResponse.json({ error: "userId is required" }, { status: 400 });
+      }
+      const limit = Number(_nullishCoalesce(url.searchParams.get("limit"), () => ( 20)));
+      const offset = Number(_nullishCoalesce(url.searchParams.get("offset"), () => ( 0)));
+      const notifications = await adapter.findManyByUser(userId, { limit, offset });
+      return _server.NextResponse.json({ notifications });
+    },
+    async POST(request) {
+      let body;
+      try {
+        body = await request.json();
+      } catch (e) {
+        return _server.NextResponse.json({ error: "Invalid JSON body" }, { status: 400 });
+      }
+      const { userId, title, body: notificationBody, href } = body;
+      if (!userId || !title || !notificationBody) {
+        return _server.NextResponse.json({ error: "userId, title, and body are required" }, { status: 400 });
+      }
+      const options = { title, body: notificationBody, href };
+      const notification = await adapter.create({ userId, ...options });
+      return _server.NextResponse.json({ notification }, { status: 201 });
+    },
+    async PATCH(request) {
+      const url = new URL(request.url);
+      const id = url.searchParams.get("id");
+      const userId = url.searchParams.get("userId");
+      if (!id || !userId) {
+        return _server.NextResponse.json({ error: "id and userId are required" }, { status: 400 });
+      }
+      await adapter.markRead(id, userId);
+      return _server.NextResponse.json({ ok: true });
+    }
+  };
+}
+
+
+
+
+
+
+exports.NOTIFICATION_ADAPTER = NOTIFICATION_ADAPTER; exports.setNotificationAdapter = setNotificationAdapter; exports.getNotificationAdapter = getNotificationAdapter; exports.createNotifyHandler = createNotifyHandler;

package/dist/chunk-QHPFQN2C.js

@@ -0,0 +1,82 @@
+import {
+  nanoid
+} from "./chunk-4SP667TN.js";
+
+// src/adapters/sqlite.ts
+import Database from "better-sqlite3";
+var _db = null;
+function getDb() {
+  if (!_db) {
+    _db = new Database(":memory:");
+    _db.pragma("journal_mode = WAL");
+    _db.exec(`
+      CREATE TABLE IF NOT EXISTS notifications (
+        id          TEXT PRIMARY KEY,
+        user_id     TEXT NOT NULL,
+        title       TEXT NOT NULL,
+        body        TEXT NOT NULL,
+        href        TEXT,
+        read_at     INTEGER,
+        created_at  INTEGER NOT NULL
+      );
+      CREATE INDEX IF NOT EXISTS idx_notifications_user_id ON notifications(user_id);
+      CREATE INDEX IF NOT EXISTS idx_notifications_created_at ON notifications(created_at);
+    `);
+  }
+  return _db;
+}
+function rowToRecord(row) {
+  return {
+    id: row.id,
+    userId: row.user_id,
+    title: row.title,
+    body: row.body,
+    href: row.href,
+    readAt: row.read_at,
+    createdAt: row.created_at
+  };
+}
+var SQLiteNotificationAdapter = {
+  async create(notification) {
+    const db = getDb();
+    const id = nanoid();
+    const createdAt = Date.now();
+    db.prepare(`
+      INSERT INTO notifications (id, user_id, title, body, href, created_at)
+      VALUES (?, ?, ?, ?, ?, ?)
+    `).run(id, notification.userId, notification.title, notification.body, notification.href ?? null, createdAt);
+    return { id, ...notification, createdAt };
+  },
+  async findManyByUser(userId, { limit = 20, offset = 0 } = {}) {
+    const db = getDb();
+    const rows = db.prepare(`
+      SELECT id, user_id, title, body, href, read_at, created_at
+      FROM notifications
+      WHERE user_id = ?
+      ORDER BY created_at DESC
+      LIMIT ? OFFSET ?
+    `).all(userId, limit, offset);
+    return rows.map(rowToRecord);
+  },
+  async markRead(id, userId) {
+    const db = getDb();
+    db.prepare(`
+      UPDATE notifications SET read_at = ? WHERE id = ? AND user_id = ?
+    `).run(Date.now(), id, userId);
+  },
+  async countUnread(userId) {
+    const db = getDb();
+    const row = db.prepare(`
+      SELECT COUNT(*) as count FROM notifications WHERE user_id = ? AND read_at IS NULL
+    `).get(userId);
+    return row.count;
+  }
+};
+function createSQLiteAdapter() {
+  return SQLiteNotificationAdapter;
+}
+
+export {
+  SQLiteNotificationAdapter,
+  createSQLiteAdapter
+};

package/dist/chunk-VKPJWS2D.js

@@ -0,0 +1,59 @@
+import {
+  nanoid
+} from "./chunk-4SP667TN.js";
+
+// src/adapters/postgres.ts
+function createPostgresAdapter(connectionString) {
+  const pool = globalThis.__cyguin_postgres_pool;
+  const sql = pool ? (q, p) => pool.query(q, p).then((r) => r.rows) : async (_q, _p) => {
+    throw new Error("Postgres pool not initialized");
+  };
+  return {
+    async create(notification) {
+      const id = nanoid();
+      const createdAt = Date.now();
+      await sql(
+        `INSERT INTO notifications (id, user_id, title, body, href, created_at)
+         VALUES ($1, $2, $3, $4, $5, $6)`,
+        [id, notification.userId, notification.title, notification.body, notification.href ?? null, createdAt]
+      );
+      return { id, ...notification, createdAt };
+    },
+    async findManyByUser(userId, { limit = 20, offset = 0 } = {}) {
+      const rows = await sql(
+        `SELECT id, user_id, title, body, href, read_at, created_at
+         FROM notifications
+         WHERE user_id = $1
+         ORDER BY created_at DESC
+         LIMIT $2 OFFSET $3`,
+        [userId, limit, offset]
+      );
+      return rows.map((row) => ({
+        id: row.id,
+        userId: row.user_id,
+        title: row.title,
+        body: row.body,
+        href: row.href,
+        readAt: row.read_at,
+        createdAt: row.created_at
+      }));
+    },
+    async markRead(id, userId) {
+      await sql(
+        `UPDATE notifications SET read_at = $1 WHERE id = $2 AND user_id = $3`,
+        [Date.now(), id, userId]
+      );
+    },
+    async countUnread(userId) {
+      const rows = await sql(
+        `SELECT COUNT(*) as count FROM notifications WHERE user_id = $1 AND read_at IS NULL`,
+        [userId]
+      );
+      return Number(rows[0]?.count ?? 0);
+    }
+  };
+}
+
+export {
+  createPostgresAdapter
+};