@chatcops/store-postgres 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 CoderCops
+
+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

@@ -1,3 +1,114 @@
-# Temporary Holding Version
+# @chatcops/store-postgres
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Postgres storage for [ChatCops](https://chat.codercops.com): conversations, rate limit counters, turn locks and analytics events, so they survive restarts and are shared by every server instance.
+
+It works with any driver. Every write is a single SQL statement, so nothing needs a transaction or a dedicated connection, and serverless drivers such as Neon's work as well as `pg`.
+
+## Install
+
+```bash
+npm install @chatcops/store-postgres pg
+```
+
+`pg` is only needed for the `migrate` command and if you use it as your driver.
+
+## Create the tables
+
+Once per database, and again after upgrading this package:
+
+```bash
+DATABASE_URL=postgres://... npx chatcops-postgres migrate
+```
+
+Or from code, for example at startup:
+
+```ts
+import { migrate } from '@chatcops/store-postgres';
+await migrate(pool);
+```
+
+Migrations already applied are skipped, so running it on every deploy is fine.
+
+## Use it
+
+```ts
+import pg from 'pg';
+import { postgresStorage } from '@chatcops/store-postgres';
+
+const pool = new pg.Pool({ connectionString: process.env.DATABASE_URL });
+const storage = postgresStorage({ db: pool });
+```
+
+With Neon on Vercel or Cloudflare:
+
+```ts
+import { neon } from '@neondatabase/serverless';
+import { fromNeon, postgresStorage } from '@chatcops/store-postgres';
+
+const storage = postgresStorage({ db: fromNeon(neon(process.env.DATABASE_URL!)) });
+```
+
+With postgres.js, wrap the client the same way: `fromPostgresJs(postgres(url))`.
+
+Pass the complete storage object to the server:
+
+```ts
+chatcopsMiddleware({
+  provider: { type: 'claude', apiKey: process.env.ANTHROPIC_API_KEY! },
+  systemPrompt: 'You are a helpful assistant.',
+  storage,
+});
+```
+
+## Options
+
+| Option | Default | What it does |
+|---|---|---|
+| `db` | required | A `pg` `Pool`, or a client wrapped with `fromNeon` or `fromPostgresJs`. Anything with `query(text, params)` that returns `{ rows }` works. |
+| `tablePrefix` | `'chatcops_'` | Table name prefix, so several apps can share a database. Use the same one with `migrate`. |
+
+## Your own columns
+
+To stamp your own columns on every new conversation and message row (a tenant id, a site id), add them with your own migration, declare them, and say how to fill them:
+
+```ts
+// ALTER TABLE chatcops_conversations ADD COLUMN workspace_id uuid;
+// ALTER TABLE chatcops_messages ADD COLUMN workspace_id uuid;
+const storage = postgresStorage({
+  db: pool,
+  extraColumns: { workspace_id: 'uuid' },
+  rowHook: ({ table, metadata }) => ({ workspace_id: metadata?.workspaceId }),
+});
+```
+
+The hook runs when a row is created, never on updates. It gets the table, the conversation id, the metadata passed with the write, and the message for message rows. Returning a key that isn't in `extraColumns` throws, and values are sent as query parameters, never put into the SQL. Reads aren't filtered by these columns; that's up to your own queries or row-level security.
+
+## Tables
+
+| Table | Holds |
+|---|---|
+| `chatcops_conversations` | One row per conversation: metadata, version, timestamps |
+| `chatcops_messages` | One row per message, with parts, status and usage as `jsonb` |
+| `chatcops_counters` | Rate limit and budget counters with their expiry |
+| `chatcops_kv` | Short-lived keys, such as the lock that keeps two replies to one conversation from overlapping |
+| `chatcops_events` | Analytics events |
+
+Writing to a conversation is one `INSERT ... ON CONFLICT` that locks its row, so two server instances answering at once never lose a message, and a stale `expectedVersion` fails with a `ConflictError`.
+
+## Retention
+
+Nothing is deleted on its own. Call `purge(before)` on a schedule to delete conversations last updated before a time, with their messages. It also clears expired counters and keys:
+
+```ts
+const thirtyDaysAgo = Date.now() - 30 * 24 * 60 * 60 * 1000;
+await storage.conversations.purge?.(thirtyDaysAgo);
+```
+
+## Testing
+
+The package runs the shared ChatCops storage conformance suite against a real Postgres when `CHATCOPS_TEST_POSTGRES_URL` is set:
+
+```bash
+docker run -d -p 5432:5432 -e POSTGRES_PASSWORD=postgres postgres:17-alpine
+CHATCOPS_TEST_POSTGRES_URL=postgres://postgres:postgres@localhost:5432/postgres pnpm --filter @chatcops/store-postgres test
+```

package/dist/bin.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=bin.d.ts.map

package/dist/bin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.d.ts","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":""}

package/dist/bin.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+import { main } from './cli.js';
+process.exitCode = await main(process.argv.slice(2), {
+    env: process.env,
+    log: (message) => console.log(message),
+    error: (message) => console.error(message),
+});
+//# sourceMappingURL=bin.js.map

package/dist/bin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bin.js","sourceRoot":"","sources":["../src/bin.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAEhC,OAAO,CAAC,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE;IACnD,GAAG,EAAE,OAAO,CAAC,GAAG;IAChB,GAAG,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;IACtC,KAAK,EAAE,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC;CAC3C,CAAC,CAAC"}

package/dist/cli.d.ts

@@ -0,0 +1,14 @@
+import type { Queryable } from './queryable.js';
+export declare const USAGE = "Usage: chatcops-postgres migrate [--prefix chatcops_]\n\nCreates or updates the ChatCops tables in the database at DATABASE_URL.\nNeeds the pg package installed.";
+export interface CliDeps {
+    env: Record<string, string | undefined>;
+    log(message: string): void;
+    error(message: string): void;
+    /** Opens a pool for the URL. Defaults to `pg`. */
+    connect?(url: string): Promise<Queryable & {
+        end(): Promise<void>;
+    }>;
+}
+/** The `chatcops-postgres` command. Resolves the exit code. */
+export declare function main(args: string[], deps: CliDeps): Promise<number>;
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAGhD,eAAO,MAAM,KAAK,sKAGc,CAAC;AAEjC,MAAM,WAAW,OAAO;IACtB,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IACxC,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,kDAAkD;IAClD,OAAO,CAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,GAAG;QAAE,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAC,CAAC;CACtE;AAQD,+DAA+D;AAC/D,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,CAiCzE"}

package/dist/cli.js

@@ -0,0 +1,47 @@
+import { migrate } from './schema.js';
+export const USAGE = `Usage: chatcops-postgres migrate [--prefix chatcops_]
+
+Creates or updates the ChatCops tables in the database at DATABASE_URL.
+Needs the pg package installed.`;
+async function connectWithPg(url) {
+    const pg = await import('pg').catch(() => null);
+    if (!pg)
+        throw new Error('The migrate command needs the pg package: npm install pg');
+    return new pg.default.Pool({ connectionString: url });
+}
+/** The `chatcops-postgres` command. Resolves the exit code. */
+export async function main(args, deps) {
+    if (args[0] !== 'migrate') {
+        deps.log(USAGE);
+        return args[0] === '--help' || args[0] === '-h' ? 0 : 1;
+    }
+    const prefixIndex = args.indexOf('--prefix');
+    const tablePrefix = prefixIndex === -1 ? undefined : args[prefixIndex + 1];
+    const url = deps.env.DATABASE_URL;
+    if (!url) {
+        deps.error('Set DATABASE_URL to the database to migrate.');
+        return 1;
+    }
+    let pool;
+    try {
+        pool = await (deps.connect ?? connectWithPg)(url);
+    }
+    catch (error) {
+        deps.error(error instanceof Error ? error.message : String(error));
+        return 1;
+    }
+    try {
+        const { applied } = await migrate(pool, { tablePrefix });
+        deps.log(applied.length ? `Applied migrations: ${applied.join(', ')}` : 'Already up to date.');
+        return 0;
+    }
+    catch (error) {
+        // Only the message: driver errors can include the connection string.
+        deps.error(`Migration failed: ${error instanceof Error ? error.message : String(error)}`);
+        return 1;
+    }
+    finally {
+        await pool.end();
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAEtC,MAAM,CAAC,MAAM,KAAK,GAAG;;;gCAGW,CAAC;AAUjC,KAAK,UAAU,aAAa,CAAC,GAAW;IACtC,MAAM,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAChD,IAAI,CAAC,EAAE;QAAE,MAAM,IAAI,KAAK,CAAC,0DAA0D,CAAC,CAAC;IACrF,OAAO,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,gBAAgB,EAAE,GAAG,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,+DAA+D;AAC/D,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAc,EAAE,IAAa;IACtD,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC1B,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAChB,OAAO,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7C,MAAM,WAAW,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,CAAC,CAAC;IAC3E,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC;IAClC,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,IAAI,CAAC,KAAK,CAAC,8CAA8C,CAAC,CAAC;QAC3D,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,IAA0C,CAAC;IAC/C,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,aAAa,CAAC,CAAC,GAAG,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACnE,OAAO,CAAC,CAAC;IACX,CAAC;IAED,IAAI,CAAC;QACH,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,OAAO,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,uBAAuB,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC;QAC/F,OAAO,CAAC,CAAC;IACX,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,qEAAqE;QACrE,IAAI,CAAC,KAAK,CAAC,qBAAqB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;QAC1F,OAAO,CAAC,CAAC;IACX,CAAC;YAAS,CAAC;QACT,MAAM,IAAI,CAAC,GAAG,EAAE,CAAC;IACnB,CAAC;AACH,CAAC"}

package/dist/conversations.d.ts

@@ -0,0 +1,38 @@
+import { type AppendOptions, type ChatMessage, type Conversation, type ConversationStore, type ConversationSummary, type ListQuery } from '@chatcops/core';
+import type { Queryable } from './queryable.js';
+import type { RowHook } from './row-hook.js';
+import type { TableNames } from './schema.js';
+export declare class PostgresConversationStore implements ConversationStore {
+    private readonly db;
+    private readonly t;
+    private readonly now;
+    private readonly hook?;
+    constructor(db: Queryable, t: TableNames, now: () => number, hook?: RowHook | undefined);
+    /** The hook's extra columns for one new row, as SQL and bound params. */
+    private extraFor;
+    /**
+     * Inserts `messages` after the conversation's last sequence number. `conv`
+     * is a CTE returning `next_seq` after the upsert, which already counts
+     * these messages, so the first one gets `next_seq - count + 1`.
+     */
+    private insertMessages;
+    get(id: string): Promise<Conversation | null>;
+    /** Replaces the whole conversation, as 0.4 stores did. */
+    save(conversation: Conversation): Promise<void>;
+    delete(id: string): Promise<void>;
+    append(id: string, messages: ChatMessage[], options?: AppendOptions): Promise<{
+        version: number;
+    }>;
+    updateMessage(id: string, message: ChatMessage): Promise<boolean>;
+    removeMessage(id: string, messageId: string): Promise<boolean>;
+    list(query: ListQuery): Promise<{
+        items: ConversationSummary[];
+        cursor?: string;
+    }>;
+    /**
+     * Deletes conversations last updated before `before`, with their messages.
+     * Also clears expired counters and keys, which nothing else removes.
+     */
+    purge(before: number): Promise<number>;
+}
+//# sourceMappingURL=conversations.d.ts.map

package/dist/conversations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conversations.d.ts","sourceRoot":"","sources":["../src/conversations.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,KAAK,aAAa,EAClB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,mBAAmB,EACxB,KAAK,SAAS,EACf,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AA6D9C,qBAAa,yBAA0B,YAAW,iBAAiB;IAE/D,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG;IACpB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC;gBAHL,EAAE,EAAE,SAAS,EACb,CAAC,EAAE,UAAU,EACb,GAAG,EAAE,MAAM,MAAM,EACjB,IAAI,CAAC,EAAE,OAAO,YAAA;IAGjC,yEAAyE;IACzE,OAAO,CAAC,QAAQ;IAchB;;;;OAIG;IACH,OAAO,CAAC,cAAc;IA4BhB,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;IAsBnD,0DAA0D;IACpD,IAAI,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IA2B/C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjC,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,EAAE,EAAE,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC;QAAE,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IAyCtG,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAoBjE,aAAa,CAAC,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAe9D,IAAI,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,mBAAmB,EAAE,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAiCxF;;;OAGG;IACG,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAY7C"}

package/dist/conversations.js

@@ -0,0 +1,230 @@
+import { ConflictError, } from '@chatcops/core';
+import { json, ms, param, toTime } from './sql.js';
+const KNOWN_FIELDS = new Set(['id', 'role', 'content', 'parts', 'status', 'usage', 'aiGenerated', 'timestamp', 'metadata']);
+/** The columns of a message, in insert order. */
+const MESSAGE_COLUMNS = 'id, role, content, parts, status, usage, ai_generated, metadata, extra, sent_at';
+function messageValues(message) {
+    const extra = Object.fromEntries(Object.entries(message).filter(([key]) => !KNOWN_FIELDS.has(key)));
+    return [
+        message.id,
+        message.role,
+        message.content,
+        json(message.parts),
+        param(message.status),
+        json(message.usage),
+        param(message.aiGenerated),
+        json(message.metadata),
+        Object.keys(extra).length ? JSON.stringify(extra) : null,
+        message.timestamp,
+    ];
+}
+function toMessage(row) {
+    return {
+        ...(row.extra ?? {}),
+        id: row.id,
+        role: row.role,
+        content: row.content,
+        ...(row.parts ? { parts: row.parts } : {}),
+        ...(row.status ? { status: row.status } : {}),
+        ...(row.usage ? { usage: row.usage } : {}),
+        ...(row.ai_generated !== null ? { aiGenerated: row.ai_generated } : {}),
+        timestamp: Number(row.sent_ms),
+        ...(row.metadata ? { metadata: row.metadata } : {}),
+    };
+}
+export class PostgresConversationStore {
+    db;
+    t;
+    now;
+    hook;
+    constructor(db, t, now, hook) {
+        this.db = db;
+        this.t = t;
+        this.now = now;
+        this.hook = hook;
+    }
+    /** The hook's extra columns for one new row, as SQL and bound params. */
+    extraFor(table, context, params) {
+        if (!this.hook)
+            return { columns: '', values: '' };
+        const row = this.hook.values({ table, ...context });
+        const values = this.hook.columns.map(([name, type]) => {
+            params.push(row[name] ?? null);
+            return `$${params.length}::${type}`;
+        });
+        return { columns: this.hook.columnList, values: values.map((v) => `, ${v}`).join('') };
+    }
+    /**
+     * Inserts `messages` after the conversation's last sequence number. `conv`
+     * is a CTE returning `next_seq` after the upsert, which already counts
+     * these messages, so the first one gets `next_seq - count + 1`.
+     */
+    insertMessages(conversationId, metadata, messages, params, idParam) {
+        let hookColumns = '';
+        const rows = messages.map((message, i) => {
+            const placeholders = messageValues(message).map((value) => {
+                params.push(value);
+                return `$${params.length}`;
+            });
+            const [id, role, content, parts, status, usage, ai, meta, extra, sent] = placeholders;
+            const hooked = this.extraFor('messages', { conversationId, metadata, message }, params);
+            hookColumns = hooked.columns;
+            return `(${i + 1}, ${id}::text, ${role}::text, ${content}::text, ${parts}::text::jsonb, ${status}::text, ${usage}::text::jsonb, ${ai}::boolean, ${meta}::text::jsonb, ${extra}::text::jsonb, ${toTime(sent)}${hooked.values})`;
+        });
+        params.push(messages.length);
+        const count = `$${params.length}::int`;
+        const hookSelect = (this.hook?.columns ?? []).map(([name]) => `, v.${name}`).join('');
+        return `ins AS (
+      INSERT INTO ${this.t.messages} (conversation_id, seq, ${MESSAGE_COLUMNS}${hookColumns})
+      SELECT ${idParam}, conv.next_seq - ${count} + v.ord, v.id, v.role, v.content, v.parts, v.status, v.usage, v.ai_generated, v.metadata, v.extra, v.sent_at${hookSelect}
+      FROM conv, (VALUES ${rows.join(', ')}) AS v (ord, ${MESSAGE_COLUMNS}${hookColumns})
+    )`;
+    }
+    async get(id) {
+        const { rows } = await this.db.query(`SELECT c.id, c.metadata, c.version, ${ms('c.created_at')} AS created_ms, ${ms('c.updated_at')} AS updated_ms,
+        coalesce((
+          SELECT jsonb_agg(to_jsonb(m) - 'conversation_id' || jsonb_build_object('sent_ms', ${ms('m.sent_at')}) ORDER BY m.seq)
+          FROM ${this.t.messages} m WHERE m.conversation_id = c.id
+        ), '[]'::jsonb) AS messages
+      FROM ${this.t.conversations} c WHERE c.id = $1`, [id]);
+        const row = rows[0];
+        if (!row)
+            return null;
+        return {
+            id: row.id,
+            messages: row.messages.map(toMessage),
+            ...(row.metadata ? { metadata: row.metadata } : {}),
+            version: Number(row.version),
+            createdAt: Number(row.created_ms),
+            updatedAt: Number(row.updated_ms),
+        };
+    }
+    /** Replaces the whole conversation, as 0.4 stores did. */
+    async save(conversation) {
+        const params = [conversation.id, json(conversation.metadata), conversation.messages.length, conversation.createdAt, this.now()];
+        const hooked = this.extraFor('conversations', { conversationId: conversation.id, metadata: conversation.metadata }, params);
+        const insert = conversation.messages.length
+            ? `, ${this.insertMessages(conversation.id, conversation.metadata, conversation.messages, params, '$1')}`
+            : '';
+        await this.db.query(`WITH conv AS (
+        INSERT INTO ${this.t.conversations} AS c (id, metadata, version, next_seq, created_at, updated_at${hooked.columns})
+        VALUES ($1, $2::text::jsonb, 1, $3::int, ${toTime('$4')}, ${toTime('$5')}${hooked.values})
+        ON CONFLICT (id) DO UPDATE SET
+          metadata = EXCLUDED.metadata,
+          version = c.version + 1,
+          next_seq = c.next_seq + EXCLUDED.next_seq,
+          created_at = EXCLUDED.created_at,
+          updated_at = EXCLUDED.updated_at
+        RETURNING c.version, c.next_seq
+      ),
+      del AS (
+        DELETE FROM ${this.t.messages}
+        WHERE conversation_id = $1 AND seq <= (SELECT next_seq FROM conv) - $3::int
+      )${insert}
+      SELECT version FROM conv`, params);
+    }
+    async delete(id) {
+        await this.db.query(`DELETE FROM ${this.t.conversations} WHERE id = $1`, [id]);
+    }
+    async append(id, messages, options = {}) {
+        const expected = options.expectedVersion ?? null;
+        const params = [id, json(options.metadata), messages.length, this.now(), expected];
+        const hooked = this.extraFor('conversations', { conversationId: id, metadata: options.metadata }, params);
+        const insert = messages.length ? `, ${this.insertMessages(id, options.metadata, messages, params, '$1')}` : '';
+        // One statement, so it's atomic without a transaction. The upsert locks
+        // the conversation row, and a concurrent append waits for it and then
+        // sees the latest version and sequence number. A new conversation is only
+        // created when no version, or version 0, was expected.
+        const { rows } = await this.db.query(`WITH conv AS (
+        INSERT INTO ${this.t.conversations} AS c (id, metadata, version, next_seq, created_at, updated_at${hooked.columns})
+        SELECT $1, $2::text::jsonb, 1, $3::int, ${toTime('$4')}, ${toTime('$4')}${hooked.values}
+        WHERE $5::int IS NULL OR $5::int = 0
+          OR EXISTS (SELECT 1 FROM ${this.t.conversations} WHERE id = $1)
+        ON CONFLICT (id) DO UPDATE SET
+          version = c.version + 1,
+          next_seq = c.next_seq + EXCLUDED.next_seq,
+          updated_at = EXCLUDED.updated_at,
+          metadata = CASE
+            WHEN EXCLUDED.metadata IS NULL THEN c.metadata
+            ELSE coalesce(c.metadata, '{}'::jsonb) || EXCLUDED.metadata
+          END
+        WHERE $5::int IS NULL OR c.version = $5::int
+        RETURNING c.version, c.next_seq
+      )${insert}
+      SELECT version FROM conv`, params);
+        const row = rows[0];
+        if (row)
+            return { version: Number(row.version) };
+        const current = await this.db.query(`SELECT version FROM ${this.t.conversations} WHERE id = $1`, [id]);
+        throw new ConflictError(id, expected ?? 0, Number(current.rows[0]?.version ?? 0));
+    }
+    async updateMessage(id, message) {
+        const values = messageValues(message);
+        const { rows } = await this.db.query(`WITH m AS (
+        UPDATE ${this.t.messages} SET
+          role = $3::text, content = $4::text, parts = $5::text::jsonb, status = $6::text, usage = $7::text::jsonb,
+          ai_generated = $8::boolean, metadata = $9::text::jsonb, extra = $10::text::jsonb, sent_at = ${toTime('$11')}
+        WHERE conversation_id = $1 AND id = $2
+        RETURNING 1
+      ),
+      bump AS (
+        UPDATE ${this.t.conversations} SET version = version + 1, updated_at = ${toTime('$12')}
+        WHERE id = $1 AND EXISTS (SELECT 1 FROM m)
+      )
+      SELECT count(*)::int AS updated FROM m`, [id, ...values, this.now()]);
+        return Number(rows[0]?.updated ?? 0) > 0;
+    }
+    async removeMessage(id, messageId) {
+        const { rows } = await this.db.query(`WITH m AS (
+        DELETE FROM ${this.t.messages} WHERE conversation_id = $1 AND id = $2 RETURNING 1
+      ),
+      bump AS (
+        UPDATE ${this.t.conversations} SET version = version + 1, updated_at = ${toTime('$3')}
+        WHERE id = $1 AND EXISTS (SELECT 1 FROM m)
+      )
+      SELECT count(*)::int AS removed FROM m`, [id, messageId, this.now()]);
+        return Number(rows[0]?.removed ?? 0) > 0;
+    }
+    async list(query) {
+        let cursorTime = null;
+        let cursorId = null;
+        if (query.cursor) {
+            const split = query.cursor.indexOf(':');
+            cursorTime = Number(query.cursor.slice(0, split));
+            cursorId = query.cursor.slice(split + 1);
+            if (split === -1 || !Number.isFinite(cursorTime))
+                throw new Error(`Not a list cursor: "${query.cursor}".`);
+        }
+        const { rows } = await this.db.query(`SELECT c.id, c.metadata, ${ms('c.created_at')} AS created_ms, ${ms('c.updated_at')} AS updated_ms,
+        (SELECT count(*)::int FROM ${this.t.messages} m WHERE m.conversation_id = c.id) AS message_count
+      FROM ${this.t.conversations} c
+      WHERE ($1::float8 IS NULL OR c.updated_at > ${toTime('$1')})
+        AND ($2::float8 IS NULL OR c.updated_at < ${toTime('$2')} OR (c.updated_at = ${toTime('$2')} AND c.id > $3::text))
+      ORDER BY c.updated_at DESC, c.id ASC
+      LIMIT $4::int`, [param(query.updatedAfter), cursorTime, cursorId, query.limit + 1]);
+        const page = rows.slice(0, query.limit);
+        const items = page.map((row) => ({
+            id: row.id,
+            createdAt: Number(row.created_ms),
+            updatedAt: Number(row.updated_ms),
+            messageCount: Number(row.message_count),
+            ...(row.metadata ? { metadata: row.metadata } : {}),
+        }));
+        const last = items.at(-1);
+        return rows.length > query.limit && last ? { items, cursor: `${last.updatedAt}:${last.id}` } : { items };
+    }
+    /**
+     * Deletes conversations last updated before `before`, with their messages.
+     * Also clears expired counters and keys, which nothing else removes.
+     */
+    async purge(before) {
+        const { rows } = await this.db.query(`WITH gone AS (
+        DELETE FROM ${this.t.conversations} WHERE updated_at < ${toTime('$1')} RETURNING 1
+      ),
+      counters AS (DELETE FROM ${this.t.counters} WHERE expires_at <= ${toTime('$2')}),
+      keys AS (DELETE FROM ${this.t.kv} WHERE expires_at <= ${toTime('$2')})
+      SELECT count(*)::int AS purged FROM gone`, [before, this.now()]);
+        return Number(rows[0]?.purged ?? 0);
+    }
+}
+//# sourceMappingURL=conversations.js.map

package/dist/conversations.js.map

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

package/dist/counters.d.ts

@@ -0,0 +1,37 @@
+import type { AnalyticsEvent, CounterStore, CounterValue, EventCount, EventQuery, EventSink, KeyValueStore } from '@chatcops/core';
+import type { Queryable } from './queryable.js';
+import type { TableNames } from './schema.js';
+/** One upsert per increment, so concurrent increments never lose a count. */
+export declare class PostgresCounterStore implements CounterStore {
+    private readonly db;
+    private readonly t;
+    private readonly now;
+    constructor(db: Queryable, t: TableNames, now: () => number);
+    increment(key: string, by: number, ttlMs: number): Promise<CounterValue>;
+    get(key: string): Promise<CounterValue | null>;
+}
+/** JSON values with an optional expiry. Expired rows are ignored, and cleared by `purge()`. */
+export declare class PostgresKeyValueStore implements KeyValueStore {
+    private readonly db;
+    private readonly t;
+    private readonly now;
+    constructor(db: Queryable, t: TableNames, now: () => number);
+    private expiry;
+    get<T = unknown>(key: string): Promise<T | null>;
+    set(key: string, value: unknown, options?: {
+        ttlMs?: number;
+    }): Promise<void>;
+    setIfAbsent(key: string, value: unknown, options?: {
+        ttlMs?: number;
+    }): Promise<boolean>;
+    delete(key: string): Promise<void>;
+}
+/** Events as rows, counted with SQL. Writes go in batches of up to 500 rows. */
+export declare class PostgresEventSink implements EventSink {
+    private readonly db;
+    private readonly t;
+    constructor(db: Queryable, t: TableNames);
+    write(events: AnalyticsEvent[]): Promise<void>;
+    query(query: EventQuery): Promise<EventCount[]>;
+}
+//# sourceMappingURL=counters.d.ts.map

package/dist/counters.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"counters.d.ts","sourceRoot":"","sources":["../src/counters.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,gBAAgB,CAAC;AACnI,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAChD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAM9C,6EAA6E;AAC7E,qBAAa,oBAAqB,YAAW,YAAY;IAErD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAFH,EAAE,EAAE,SAAS,EACb,CAAC,EAAE,UAAU,EACb,GAAG,EAAE,MAAM,MAAM;IAG9B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAcxE,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC;CAQrD;AAED,+FAA+F;AAC/F,qBAAa,qBAAsB,YAAW,aAAa;IAEvD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;IAClB,OAAO,CAAC,QAAQ,CAAC,GAAG;gBAFH,EAAE,EAAE,SAAS,EACb,CAAC,EAAE,UAAU,EACb,GAAG,EAAE,MAAM,MAAM;IAGpC,OAAO,CAAC,MAAM;IAIR,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG,IAAI,CAAC;IAShD,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IASjF,WAAW,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAa5F,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAGzC;AAED,gFAAgF;AAChF,qBAAa,iBAAkB,YAAW,SAAS;IAE/C,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,CAAC;gBADD,EAAE,EAAE,SAAS,EACb,CAAC,EAAE,UAAU;IAG1B,KAAK,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB9C,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;CAatD"}