@weifuwujs/messages 0.0.0-stage → 1.0.0

package/dist/stores/postgres.js

@@ -0,0 +1,192 @@
+import { randomUUID } from 'node:crypto';
+import { decodeCursor, encodeCursor } from "../cursor.js";
+const SCHEMA = [
+    `
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  title TEXT NOT NULL,
+  body TEXT,
+  data TEXT,
+  read_at TEXT,
+  idempotency_key TEXT,
+  created_at TEXT NOT NULL,
+  UNIQUE (user_id, idempotency_key)
+)`,
+    'CREATE INDEX IF NOT EXISTS messages_inbox_idx ON messages(user_id, created_at DESC, id DESC)',
+    'CREATE INDEX IF NOT EXISTS messages_unread_idx ON messages(user_id, read_at)',
+];
+function toMessage(row) {
+    return {
+        id: row.id,
+        userId: row.user_id,
+        kind: row.kind,
+        title: row.title,
+        body: row.body,
+        data: row.data === null ? null : JSON.parse(row.data),
+        readAt: row.read_at === null ? null : new Date(row.read_at),
+        idempotencyKey: row.idempotency_key,
+        createdAt: new Date(row.created_at),
+    };
+}
+/**
+ * postgres 驱动（复用 `postgres.js`，与 `./postgres` 的 `ctx.sql` 同一客户端）。
+ *
+ * ```ts
+ * postgresMessageStore('postgres://…')
+ * postgresMessageStore(ctx.sql)   // 注入已有客户端（不负责 close）
+ * ```
+ *
+ * 幂等键靠 `(user_id, idempotency_key)` 唯一约束 + `ON CONFLICT DO NOTHING` 原子去重；
+ * 表结构与 sqlite 对齐，`migrate()` 幂等（`message_migrations`）。
+ */
+export function postgresMessageStore(urlOrSql, options) {
+    const injected = typeof urlOrSql === 'function' ? urlOrSql : null;
+    let client = injected
+        ? Promise.resolve(injected)
+        : null;
+    const sql = () => {
+        client ??= (async () => {
+            const { default: createPostgres } = (await import('postgres'));
+            if (typeof urlOrSql === 'string')
+                return createPostgres(urlOrSql, options);
+            const url = process.env.DATABASE_URL;
+            if (url)
+                return createPostgres(url, options);
+            return createPostgres(options);
+        })();
+        return client;
+    };
+    const applyMigrations = async (db) => {
+        // 并发实例串行化：DDL 与版本写入同一事务。
+        // PG 的 `CREATE TABLE IF NOT EXISTS` 并非 race-free（pg_type 唯一冲突），
+        // 多进程同时启动迁移会互相炸；advisory xact lock 让后来者排队。
+        await db.begin(async (tx) => {
+            await tx `SELECT pg_advisory_xact_lock(hashtext('weifuwu:messages:migrate'))`;
+            await tx `
+        CREATE TABLE IF NOT EXISTS message_migrations (
+          version INTEGER PRIMARY KEY,
+          applied_at TEXT NOT NULL
+        )`;
+            const applied = await tx `SELECT version FROM message_migrations WHERE version = 1`;
+            if (applied.length > 0)
+                return;
+            for (const statement of SCHEMA)
+                await tx.unsafe(statement);
+            await tx `INSERT INTO message_migrations (version, applied_at) VALUES (1, ${new Date().toISOString()})`;
+        });
+    };
+    const store = {
+        async migrate() {
+            await applyMigrations(await sql());
+        },
+        async close() {
+            if (!client || injected)
+                return;
+            const db = await client;
+            client = null;
+            await db.end({ timeout: 5 });
+        },
+        async insert(input) {
+            const db = await sql();
+            const key = input.idempotencyKey;
+            const rows = (await db `
+        INSERT INTO messages (id, user_id, kind, title, body, data, read_at,
+          idempotency_key, created_at)
+        VALUES (${randomUUID()}, ${input.userId}, ${input.kind}, ${input.title},
+          ${input.body}, ${input.data === null ? null : JSON.stringify(input.data)},
+          NULL, ${key}, ${input.createdAt.toISOString()})
+        ON CONFLICT (user_id, idempotency_key) DO NOTHING
+        RETURNING *`);
+            if (rows[0])
+                return { message: toMessage(rows[0]), created: true };
+            // 幂等键命中：返回已有消息（不覆盖）
+            const existing = (await db `
+        SELECT * FROM messages
+        WHERE user_id = ${input.userId} AND idempotency_key = ${key}
+        LIMIT 1`);
+            if (existing[0])
+                return { message: toMessage(existing[0]), created: false };
+            throw new Error('insert 冲突但未找到已有消息（idempotency_key 非空？）');
+        },
+        async get(id, userId) {
+            const db = await sql();
+            const rows = (await db `
+        SELECT * FROM messages WHERE id = ${id} AND user_id = ${userId}`);
+            return rows[0] ? toMessage(rows[0]) : null;
+        },
+        async list(query) {
+            const db = await sql();
+            const unreadFilter = query.unreadOnly ? db `AND read_at IS NULL` : db ``;
+            const kindFilter = query.kind ? db `AND kind = ${query.kind}` : db ``;
+            let cursorFilter = db ``;
+            if (query.cursor) {
+                const cursor = decodeCursor(query.cursor);
+                if (!cursor)
+                    throw new Error(`invalid cursor: ${query.cursor}`);
+                const iso = new Date(cursor.createdAtMs).toISOString();
+                cursorFilter = db `AND (created_at < ${iso} OR (created_at = ${iso} AND id < ${cursor.id}))`;
+            }
+            const limit = query.limit ?? 20;
+            const rows = (await db `
+        SELECT * FROM messages
+        WHERE user_id = ${query.userId} ${unreadFilter} ${kindFilter} ${cursorFilter}
+        ORDER BY created_at DESC, id DESC
+        LIMIT ${limit + 1}`);
+            const hasMore = rows.length > limit;
+            const page = rows.slice(0, limit).map(toMessage);
+            return {
+                items: page,
+                nextCursor: hasMore ? encodeCursor(page[page.length - 1]) : null,
+            };
+        },
+        async listAfter(query) {
+            const db = await sql();
+            let cursorFilter = db ``;
+            if (query.cursor !== null) {
+                const cursor = decodeCursor(query.cursor);
+                if (!cursor)
+                    throw new Error(`invalid cursor: ${query.cursor}`);
+                const iso = new Date(cursor.createdAtMs).toISOString();
+                cursorFilter = db `AND (created_at > ${iso} OR (created_at = ${iso} AND id > ${cursor.id}))`;
+            }
+            const rows = (await db `
+        SELECT * FROM messages
+        WHERE user_id = ${query.userId} ${cursorFilter}
+        ORDER BY created_at ASC, id ASC
+        LIMIT ${query.limit + 1}`);
+            return {
+                items: rows.slice(0, query.limit).map(toMessage),
+                hasMore: rows.length > query.limit,
+            };
+        },
+        async unreadCount(userId) {
+            const db = await sql();
+            const rows = (await db `
+        SELECT COUNT(*)::int AS count FROM messages
+        WHERE user_id = ${userId} AND read_at IS NULL`);
+            return Number(rows[0].count);
+        },
+        async markRead(userId, ids, now) {
+            if (ids.length === 0)
+                return 0;
+            const db = await sql();
+            const rows = (await db `
+        UPDATE messages SET read_at = ${now.toISOString()}
+        WHERE user_id = ${userId} AND read_at IS NULL AND id = ANY(${ids})
+        RETURNING id`);
+            return rows.length;
+        },
+        async markAllRead(userId, now) {
+            const db = await sql();
+            const rows = (await db `
+        UPDATE messages SET read_at = ${now.toISOString()}
+        WHERE user_id = ${userId} AND read_at IS NULL
+        RETURNING id`);
+            return rows.length;
+        },
+    };
+    return store;
+}
+//# sourceMappingURL=postgres.js.map

package/dist/stores/postgres.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"postgres.js","sourceRoot":"","sources":["../../src/stores/postgres.ts"],"names":[],"mappings":"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"}

package/dist/stores/sqlite.d.ts

@@ -0,0 +1,13 @@
+import { DatabaseSync } from 'node:sqlite';
+import type { MessageStore } from '../types.ts';
+export interface SqliteMessageStore extends MessageStore {
+    readonly db: DatabaseSync;
+    migrate(): Promise<void>;
+    close(): void;
+}
+/**
+ * sqlite 驱动（`node:sqlite`，零依赖）。构造自动迁移，迁移幂等；
+ * `:memory:` 用于测试；**单进程**语义（多进程不承诺，文档写明）。
+ */
+export declare function sqliteMessageStore(path?: string): SqliteMessageStore;
+//# sourceMappingURL=sqlite.d.ts.map

package/dist/stores/sqlite.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.d.ts","sourceRoot":"","sources":["../../src/stores/sqlite.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,OAAO,KAAK,EAOV,YAAY,EAEb,MAAM,aAAa,CAAA;AAkEpB,MAAM,WAAW,kBAAmB,SAAQ,YAAY;IACtD,QAAQ,CAAC,EAAE,EAAE,YAAY,CAAA;IACzB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACxB,KAAK,IAAI,IAAI,CAAA;CACd;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,SAAqB,GAAG,kBAAkB,CAgJhF"}

package/dist/stores/sqlite.js

@@ -0,0 +1,180 @@
+import { randomUUID } from 'node:crypto';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+import { DatabaseSync } from 'node:sqlite';
+import { decodeCursor, encodeCursor } from "../cursor.js";
+const SCHEMA = `
+CREATE TABLE IF NOT EXISTS messages (
+  id TEXT PRIMARY KEY,
+  user_id TEXT NOT NULL,
+  kind TEXT NOT NULL,
+  title TEXT NOT NULL,
+  body TEXT,
+  data TEXT,
+  read_at TEXT,
+  idempotency_key TEXT,
+  created_at TEXT NOT NULL,
+  UNIQUE (user_id, idempotency_key)
+);
+CREATE INDEX IF NOT EXISTS messages_inbox_idx ON messages(user_id, created_at DESC, id DESC);
+CREATE INDEX IF NOT EXISTS messages_unread_idx ON messages(user_id, read_at);
+`;
+function toMessage(row) {
+    return {
+        id: row.id,
+        userId: row.user_id,
+        kind: row.kind,
+        title: row.title,
+        body: row.body,
+        data: row.data === null ? null : JSON.parse(row.data),
+        readAt: row.read_at === null ? null : new Date(row.read_at),
+        idempotencyKey: row.idempotency_key,
+        createdAt: new Date(row.created_at),
+    };
+}
+function applyMigrations(db) {
+    db.exec('CREATE TABLE IF NOT EXISTS message_migrations (version INTEGER PRIMARY KEY, applied_at TEXT NOT NULL)');
+    const applied = db
+        .prepare('SELECT version FROM message_migrations WHERE version = ?')
+        .get(1);
+    if (applied)
+        return;
+    db.exec('BEGIN');
+    try {
+        db.exec(SCHEMA);
+        db.prepare('INSERT INTO message_migrations (version, applied_at) VALUES (?, ?)').run(1, new Date().toISOString());
+        db.exec('COMMIT');
+    }
+    catch (error) {
+        db.exec('ROLLBACK');
+        throw error;
+    }
+}
+/**
+ * sqlite 驱动（`node:sqlite`，零依赖）。构造自动迁移，迁移幂等；
+ * `:memory:` 用于测试；**单进程**语义（多进程不承诺，文档写明）。
+ */
+export function sqliteMessageStore(path = 'data/messages.db') {
+    if (path !== ':memory:')
+        mkdirSync(dirname(path), { recursive: true });
+    const db = new DatabaseSync(path);
+    applyMigrations(db);
+    const store = {
+        db,
+        async migrate() {
+            applyMigrations(db);
+        },
+        close() {
+            db.close();
+        },
+        async insert(input) {
+            const key = input.idempotencyKey;
+            if (key) {
+                const existing = db
+                    .prepare('SELECT * FROM messages WHERE user_id = ? AND idempotency_key = ?')
+                    .get(input.userId, key);
+                if (existing)
+                    return { message: toMessage(existing), created: false };
+            }
+            const id = randomUUID();
+            try {
+                db.prepare(`INSERT INTO messages (id, user_id, kind, title, body, data, read_at,
+             idempotency_key, created_at)
+           VALUES (?, ?, ?, ?, ?, ?, NULL, ?, ?)`).run(id, input.userId, input.kind, input.title, input.body, input.data === null ? null : JSON.stringify(input.data), key, input.createdAt.toISOString());
+            }
+            catch (error) {
+                if (key && /UNIQUE/i.test(String(error))) {
+                    const existing = db
+                        .prepare('SELECT * FROM messages WHERE user_id = ? AND idempotency_key = ?')
+                        .get(input.userId, key);
+                    if (existing)
+                        return { message: toMessage(existing), created: false };
+                }
+                throw error;
+            }
+            const row = db
+                .prepare('SELECT * FROM messages WHERE id = ?')
+                .get(id);
+            return { message: toMessage(row), created: true };
+        },
+        async get(id, userId) {
+            const row = db
+                .prepare('SELECT * FROM messages WHERE id = ? AND user_id = ?')
+                .get(id, userId);
+            return row ? toMessage(row) : null;
+        },
+        async list(query) {
+            const where = ['user_id = ?'];
+            const params = [query.userId];
+            if (query.unreadOnly)
+                where.push('read_at IS NULL');
+            if (query.kind) {
+                where.push('kind = ?');
+                params.push(query.kind);
+            }
+            if (query.cursor) {
+                const cursor = decodeCursor(query.cursor);
+                if (!cursor)
+                    throw new Error(`invalid cursor: ${query.cursor}`);
+                const iso = new Date(cursor.createdAtMs).toISOString();
+                where.push('(created_at < ? OR (created_at = ? AND id < ?))');
+                params.push(iso, iso, cursor.id);
+            }
+            const limit = query.limit ?? 20;
+            const rows = db
+                .prepare(`SELECT * FROM messages WHERE ${where.join(' AND ')}
+           ORDER BY created_at DESC, id DESC LIMIT ?`)
+                .all(...params, limit + 1);
+            const hasMore = rows.length > limit;
+            const page = rows.slice(0, limit).map(toMessage);
+            return {
+                items: page,
+                nextCursor: hasMore ? encodeCursor(page[page.length - 1]) : null,
+            };
+        },
+        async listAfter(query) {
+            const where = ['user_id = ?'];
+            const params = [query.userId];
+            if (query.cursor !== null) {
+                const cursor = decodeCursor(query.cursor);
+                if (!cursor)
+                    throw new Error(`invalid cursor: ${query.cursor}`);
+                const iso = new Date(cursor.createdAtMs).toISOString();
+                where.push('(created_at > ? OR (created_at = ? AND id > ?))');
+                params.push(iso, iso, cursor.id);
+            }
+            const rows = db
+                .prepare(`SELECT * FROM messages WHERE ${where.join(' AND ')}
+           ORDER BY created_at ASC, id ASC LIMIT ?`)
+                .all(...params, query.limit + 1);
+            return {
+                items: rows.slice(0, query.limit).map(toMessage),
+                hasMore: rows.length > query.limit,
+            };
+        },
+        async unreadCount(userId) {
+            const row = db
+                .prepare('SELECT COUNT(*) AS count FROM messages WHERE user_id = ? AND read_at IS NULL')
+                .get(userId);
+            return Number(row.count);
+        },
+        async markRead(userId, ids, now) {
+            if (ids.length === 0)
+                return 0;
+            const placeholders = ids.map(() => '?').join(', ');
+            const result = db
+                .prepare(`UPDATE messages SET read_at = ?
+           WHERE user_id = ? AND read_at IS NULL AND id IN (${placeholders})`)
+                .run(now.toISOString(), userId, ...ids);
+            return Number(result.changes);
+        },
+        async markAllRead(userId, now) {
+            const result = db
+                .prepare('UPDATE messages SET read_at = ? WHERE user_id = ? AND read_at IS NULL')
+                .run(now.toISOString(), userId);
+            return Number(result.changes);
+        },
+    };
+    return store;
+}
+//# sourceMappingURL=sqlite.js.map

package/dist/stores/sqlite.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sqlite.js","sourceRoot":"","sources":["../../src/stores/sqlite.ts"],"names":[],"mappings":"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"}

package/dist/testing.d.ts

@@ -0,0 +1,24 @@
+import type { MessageBus, MessageStore } from './types.ts';
+/**
+ * 消息存储契约套件：memory / sqlite / postgres / redis 与自定义驱动共用。
+ *
+ * ```ts
+ * import { messagesStoreContract } from '@weifuwujs/messages/testing'
+ * messagesStoreContract('my-store', () => myMessageStore())
+ * ```
+ */
+export declare function messagesStoreContract(name: string, create: () => MessageStore | Promise<MessageStore>, options?: {
+    skip?: boolean | string;
+}): void;
+/**
+ * 消息总线契约套件：local / redis 与自定义总线共用。
+ *
+ * ```ts
+ * import { messageBusContract } from '@weifuwujs/messages/testing'
+ * messageBusContract('my-bus', () => myMessageBus())
+ * ```
+ */
+export declare function messageBusContract(name: string, create: () => MessageBus | Promise<MessageBus>, options?: {
+    skip?: boolean | string;
+}): void;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAiB,MAAM,YAAY,CAAA;AAkBzE;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CACnC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,EAClD,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GACxC,IAAI,CAwON;AAaD;;;;;;;GAOG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC,EAC9C,OAAO,GAAE;IAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAAA;CAAO,GACxC,IAAI,CAmDN"}