crewly 1.6.0 → 1.6.2

package/dist/backend/backend/src/services/chat-v2/sqlite/chat-db.js.map

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

package/dist/backend/backend/src/services/chat-v2/sqlite/message.store.d.ts

@@ -0,0 +1,132 @@
+/**
+ * MessageStore — CRUD for `chat_messages` plus the server-side
+ * sequence assigner described in tech-spec §4.
+ *
+ * Key properties:
+ * - Every insert assigns `seq = MAX(seq)+1` for the channel inside a
+ *   transaction that also bumps `chat_channels.last_message_at`.
+ * - Concurrent writes serialize through the SQLite write lock; the
+ *   `UNIQUE(channel_id, seq)` constraint is a belt-and-braces guard.
+ * - `clientMessageId` is an optional idempotency key stored in
+ *   `metadata.clientMessageId`; duplicate inserts surface the
+ *   persisted row instead of erroring.
+ *
+ * @module services/chat-v2/sqlite/message.store
+ */
+import { type ChatContentType, type ChatMessageCursorPayload, type ChatMessageRow, type ChatSenderType } from '../types.js';
+import type { ChatDatabase } from './chat-db.js';
+/**
+ * Encode a pagination cursor to an opaque base64url string.
+ *
+ * @param payload - Cursor fields
+ * @returns Opaque base64url-encoded JSON string
+ */
+export declare function encodeCursor(payload: ChatMessageCursorPayload): string;
+/**
+ * Decode an opaque pagination cursor.
+ *
+ * @param cursor - The cursor string (or null/undefined)
+ * @returns The decoded payload, or null if input is missing
+ * @throws {ChatError} `invalid_cursor` (400) if the cursor fails to parse or
+ *   doesn't contain the expected fields.
+ */
+export declare function decodeCursor(cursor: string | null | undefined): ChatMessageCursorPayload | null;
+/** Options for inserting a message. */
+export interface MessageInsertInput {
+    channelId: string;
+    senderType: ChatSenderType;
+    senderId: string;
+    content: string;
+    contentType?: ChatContentType;
+    /** Optional metadata object. Will be JSON-stringified. */
+    metadata?: Record<string, unknown>;
+    /** Stable client id for idempotent retries; folded into metadata. */
+    clientMessageId?: string;
+    /**
+     * Phase A (SEALED §3.2) — array of mention IDs (member or team)
+     * referenced inline in `content`. Stored as a JSON-encoded string in
+     * the `mentions` column. Empty array or omitted → null in storage.
+     */
+    mentions?: string[];
+    /**
+     * Phase A (SEALED §3.2) — Slack-style thread root. When set, this
+     * message is a reply within the thread rooted at `threadId`. Omitted
+     * for top-level channel messages.
+     */
+    threadId?: string;
+    /** Override the insert clock (tests). */
+    nowMs?: number;
+    /** Override the generated id (tests / deterministic callers). */
+    id?: string;
+}
+/** Result of inserting a message — includes whether this was a dedupe hit. */
+export interface MessageInsertResult {
+    row: ChatMessageRow;
+    /** True when the returned row pre-existed under the given clientMessageId. */
+    deduped: boolean;
+}
+/** Options for listing messages with cursor pagination. */
+export interface MessageListOptions {
+    cursor?: string | null;
+    /** 1..100, default 50. */
+    limit?: number;
+    /** `backward` (default) loads older; `forward` loads newer. */
+    direction?: 'backward' | 'forward';
+}
+/** SQLite-backed store for chat messages. */
+export declare class MessageStore {
+    private readonly db;
+    /** Cap on a single page size. */
+    static readonly MAX_LIMIT = 100;
+    /** Default page size when caller didn't specify. */
+    static readonly DEFAULT_LIMIT = 50;
+    constructor(db: ChatDatabase);
+    /**
+     * Insert a message into the channel.
+     *
+     * Performs sequence assignment (`MAX(seq)+1`) and idempotency dedupe in a
+     * single transaction. If a row with the same `(channel_id, clientMessageId)`
+     * already exists, returns it with `deduped=true` instead of inserting.
+     *
+     * Also updates the parent channel's `last_message_at`.
+     *
+     * @param input - Insert payload
+     * @returns The persisted row plus a dedupe flag
+     * @throws {ChatError} `channel_not_found` (404) if the channel is missing
+     *   (or archived and we want to refuse).
+     */
+    insert(input: MessageInsertInput): MessageInsertResult;
+    /**
+     * Look up a message by its id.
+     *
+     * @param id - The message id
+     * @returns The row, or null
+     */
+    getById(id: string): ChatMessageRow | null;
+    /**
+     * List messages for a channel with cursor pagination.
+     *
+     * @param channelId - The channel id to read
+     * @param options - Listing options (cursor, limit, direction)
+     * @returns An ordered array of rows and cursors for next/prev pages
+     */
+    listByChannel(channelId: string, options?: MessageListOptions): {
+        rows: ChatMessageRow[];
+        nextCursor: string | null;
+        prevCursor: string | null;
+    };
+    /** Execute the paginated SELECT for one page of messages. */
+    private queryPage;
+    /** Compute next/prev cursors based on the page result. */
+    private buildCursors;
+    /**
+     * Return the current `MAX(seq)` for a channel, or 0 when empty.
+     *
+     * @param channelId - The channel id
+     * @returns The largest seq, or 0
+     */
+    getLastSeq(channelId: string): number;
+    /** Count messages for a channel. Used by tests and metrics. */
+    count(channelId: string): number;
+}
+//# sourceMappingURL=message.store.d.ts.map

package/dist/backend/backend/src/services/chat-v2/sqlite/message.store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message.store.d.ts","sourceRoot":"","sources":["../../../../../../../backend/src/services/chat-v2/sqlite/message.store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAGH,OAAO,EAGL,KAAK,eAAe,EACpB,KAAK,wBAAwB,EAC7B,KAAK,cAAc,EACnB,KAAK,cAAc,EACpB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAoBjD;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,wBAAwB,GAAG,MAAM,CAGtE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,wBAAwB,GAAG,IAAI,CAqB/F;AAMD,uCAAuC;AACvC,MAAM,WAAW,kBAAkB;IACjC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,cAAc,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,eAAe,CAAC;IAC9B,0DAA0D;IAC1D,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,qEAAqE;IACrE,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,iEAAiE;IACjE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED,8EAA8E;AAC9E,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,cAAc,CAAC;IACpB,8EAA8E;IAC9E,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,2DAA2D;AAC3D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,0BAA0B;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,+DAA+D;IAC/D,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;CACpC;AAMD,6CAA6C;AAC7C,qBAAa,YAAY;IAMX,OAAO,CAAC,QAAQ,CAAC,EAAE;IAL/B,iCAAiC;IACjC,MAAM,CAAC,QAAQ,CAAC,SAAS,OAAO;IAChC,oDAAoD;IACpD,MAAM,CAAC,QAAQ,CAAC,aAAa,MAAM;gBAEN,EAAE,EAAE,YAAY;IAE7C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,mBAAmB;IA4GtD;;;;;OAKG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI;IAW1C;;;;;;OAMG;IACH,aAAa,CACX,SAAS,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,kBAAkB,GAC3B;QACD,IAAI,EAAE,cAAc,EAAE,CAAC;QACvB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;QAC1B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;KAC3B;IAoBD,6DAA6D;IAC7D,OAAO,CAAC,SAAS;IAmDjB,0DAA0D;IAC1D,OAAO,CAAC,YAAY;IAiCpB;;;;;OAKG;IACH,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;IAWrC,+DAA+D;IAC/D,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM;CAMjC"}

package/dist/backend/backend/src/services/chat-v2/sqlite/message.store.js

@@ -0,0 +1,281 @@
+/**
+ * MessageStore — CRUD for `chat_messages` plus the server-side
+ * sequence assigner described in tech-spec §4.
+ *
+ * Key properties:
+ * - Every insert assigns `seq = MAX(seq)+1` for the channel inside a
+ *   transaction that also bumps `chat_channels.last_message_at`.
+ * - Concurrent writes serialize through the SQLite write lock; the
+ *   `UNIQUE(channel_id, seq)` constraint is a belt-and-braces guard.
+ * - `clientMessageId` is an optional idempotency key stored in
+ *   `metadata.clientMessageId`; duplicate inserts surface the
+ *   persisted row instead of erroring.
+ *
+ * @module services/chat-v2/sqlite/message.store
+ */
+import { randomUUID } from 'crypto';
+import { CHAT_ERROR_CODES, ChatError, } from '../types.js';
+// ---------------------------------------------------------------------------
+// Constants — shared SELECT column list, single source of truth
+// ---------------------------------------------------------------------------
+/**
+ * Canonical column list for `chat_messages` SELECTs. Including all Phase A
+ * columns (mentions / thread_id) here keeps every read path in this store
+ * mapping to a fully-populated `ChatMessageRow`.
+ */
+const MESSAGE_SELECT_COLUMNS = `
+  id, channel_id, seq, sender_type, sender_id, content, content_type,
+  created_at, metadata, mentions, thread_id
+`;
+// ---------------------------------------------------------------------------
+// Cursor helpers
+// ---------------------------------------------------------------------------
+/**
+ * Encode a pagination cursor to an opaque base64url string.
+ *
+ * @param payload - Cursor fields
+ * @returns Opaque base64url-encoded JSON string
+ */
+export function encodeCursor(payload) {
+    const json = JSON.stringify(payload);
+    return Buffer.from(json, 'utf-8').toString('base64url');
+}
+/**
+ * Decode an opaque pagination cursor.
+ *
+ * @param cursor - The cursor string (or null/undefined)
+ * @returns The decoded payload, or null if input is missing
+ * @throws {ChatError} `invalid_cursor` (400) if the cursor fails to parse or
+ *   doesn't contain the expected fields.
+ */
+export function decodeCursor(cursor) {
+    if (!cursor)
+        return null;
+    try {
+        const json = Buffer.from(cursor, 'base64url').toString('utf-8');
+        const parsed = JSON.parse(json);
+        if (typeof parsed.seq !== 'number' ||
+            !Number.isFinite(parsed.seq) ||
+            typeof parsed.channelId !== 'string' ||
+            parsed.channelId.length === 0) {
+            throw new Error('missing required fields');
+        }
+        return { seq: parsed.seq, channelId: parsed.channelId };
+    }
+    catch (err) {
+        throw new ChatError(CHAT_ERROR_CODES.INVALID_CURSOR, 400, `Cursor failed to parse: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// ---------------------------------------------------------------------------
+// Store
+// ---------------------------------------------------------------------------
+/** SQLite-backed store for chat messages. */
+export class MessageStore {
+    db;
+    /** Cap on a single page size. */
+    static MAX_LIMIT = 100;
+    /** Default page size when caller didn't specify. */
+    static DEFAULT_LIMIT = 50;
+    constructor(db) {
+        this.db = db;
+    }
+    /**
+     * Insert a message into the channel.
+     *
+     * Performs sequence assignment (`MAX(seq)+1`) and idempotency dedupe in a
+     * single transaction. If a row with the same `(channel_id, clientMessageId)`
+     * already exists, returns it with `deduped=true` instead of inserting.
+     *
+     * Also updates the parent channel's `last_message_at`.
+     *
+     * @param input - Insert payload
+     * @returns The persisted row plus a dedupe flag
+     * @throws {ChatError} `channel_not_found` (404) if the channel is missing
+     *   (or archived and we want to refuse).
+     */
+    insert(input) {
+        const id = input.id ?? randomUUID();
+        const createdAt = input.nowMs ?? Date.now();
+        const contentType = input.contentType ?? 'markdown';
+        const metadataObj = {
+            ...(input.metadata ?? {}),
+            ...(input.clientMessageId ? { clientMessageId: input.clientMessageId } : {}),
+        };
+        const metadataHasKeys = Object.keys(metadataObj).length > 0;
+        const metadataJson = metadataHasKeys ? JSON.stringify(metadataObj) : null;
+        // Phase A: serialize mentions to JSON. Treat null/empty as DB-null so
+        // legacy rows and "no mentions" share a representation; the read-side
+        // mapper translates DB-null back to [].
+        const mentionsJson = input.mentions && input.mentions.length > 0 ? JSON.stringify(input.mentions) : null;
+        const threadId = input.threadId ?? null;
+        const txn = this.db.transaction(() => {
+            // Dedupe check — same clientMessageId + channel → return existing row.
+            if (input.clientMessageId) {
+                const existing = this.db
+                    .prepare(`SELECT ${MESSAGE_SELECT_COLUMNS}
+             FROM chat_messages
+             WHERE channel_id = ?
+               AND json_extract(metadata, '$.clientMessageId') = ?
+             LIMIT 1`)
+                    .get(input.channelId, input.clientMessageId);
+                if (existing) {
+                    return { row: existing, deduped: true };
+                }
+            }
+            // Channel existence check — FK catches it too but we want a typed error
+            // with a sensible status code.
+            const channel = this.db
+                .prepare('SELECT id, archived_at FROM chat_channels WHERE id = ?')
+                .get(input.channelId);
+            if (!channel) {
+                throw new ChatError(CHAT_ERROR_CODES.CHANNEL_NOT_FOUND, 404, `Channel ${input.channelId} not found`);
+            }
+            if (channel.archived_at) {
+                throw new ChatError(CHAT_ERROR_CODES.CHANNEL_ARCHIVED, 404, `Channel ${input.channelId} is archived`);
+            }
+            // Sequence assignment + insert.
+            const seqRow = this.db
+                .prepare(`SELECT COALESCE(MAX(seq), 0) + 1 AS next_seq
+           FROM chat_messages
+           WHERE channel_id = ?`)
+                .get(input.channelId);
+            this.db
+                .prepare(`INSERT INTO chat_messages
+             (id, channel_id, seq, sender_type, sender_id, content, content_type,
+              created_at, metadata, mentions, thread_id)
+           VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, ?)`)
+                .run(id, input.channelId, seqRow.next_seq, input.senderType, input.senderId, input.content, contentType, createdAt, metadataJson, mentionsJson, threadId);
+            // Touch last_message_at on the parent channel.
+            this.db
+                .prepare(`UPDATE chat_channels
+           SET last_message_at = ?
+           WHERE id = ?
+             AND (last_message_at IS NULL OR last_message_at < ?)`)
+                .run(createdAt, input.channelId, createdAt);
+            const row = this.db
+                .prepare(`SELECT ${MESSAGE_SELECT_COLUMNS}
+           FROM chat_messages
+           WHERE id = ?`)
+                .get(id);
+            return { row, deduped: false };
+        });
+        return txn();
+    }
+    /**
+     * Look up a message by its id.
+     *
+     * @param id - The message id
+     * @returns The row, or null
+     */
+    getById(id) {
+        const row = this.db
+            .prepare(`SELECT ${MESSAGE_SELECT_COLUMNS}
+         FROM chat_messages
+         WHERE id = ?`)
+            .get(id);
+        return row ?? null;
+    }
+    /**
+     * List messages for a channel with cursor pagination.
+     *
+     * @param channelId - The channel id to read
+     * @param options - Listing options (cursor, limit, direction)
+     * @returns An ordered array of rows and cursors for next/prev pages
+     */
+    listByChannel(channelId, options) {
+        const direction = options?.direction ?? 'backward';
+        const rawLimit = options?.limit ?? MessageStore.DEFAULT_LIMIT;
+        const limit = Math.max(1, Math.min(rawLimit, MessageStore.MAX_LIMIT));
+        const decoded = decodeCursor(options?.cursor);
+        if (decoded && decoded.channelId !== channelId) {
+            throw new ChatError(CHAT_ERROR_CODES.INVALID_CURSOR, 400, 'Cursor belongs to a different channel');
+        }
+        const rows = this.queryPage(channelId, decoded?.seq ?? null, direction, limit);
+        const cursors = this.buildCursors(channelId, rows, direction, limit);
+        return { rows, ...cursors };
+    }
+    /** Execute the paginated SELECT for one page of messages. */
+    queryPage(channelId, fromSeq, direction, limit) {
+        const cols = MESSAGE_SELECT_COLUMNS;
+        if (direction === 'backward') {
+            // Loading older: newest-first, seq < cursor.
+            if (fromSeq === null) {
+                return this.db
+                    .prepare(`SELECT ${cols} FROM chat_messages
+             WHERE channel_id = ?
+             ORDER BY seq DESC
+             LIMIT ?`)
+                    .all(channelId, limit);
+            }
+            return this.db
+                .prepare(`SELECT ${cols} FROM chat_messages
+           WHERE channel_id = ? AND seq < ?
+           ORDER BY seq DESC
+           LIMIT ?`)
+                .all(channelId, fromSeq, limit);
+        }
+        // Forward: oldest-first, seq > cursor.
+        if (fromSeq === null) {
+            return this.db
+                .prepare(`SELECT ${cols} FROM chat_messages
+           WHERE channel_id = ?
+           ORDER BY seq ASC
+           LIMIT ?`)
+                .all(channelId, limit);
+        }
+        return this.db
+            .prepare(`SELECT ${cols} FROM chat_messages
+         WHERE channel_id = ? AND seq > ?
+         ORDER BY seq ASC
+         LIMIT ?`)
+            .all(channelId, fromSeq, limit);
+    }
+    /** Compute next/prev cursors based on the page result. */
+    buildCursors(channelId, rows, direction, limit) {
+        // `nextCursor` continues in the current direction; `prevCursor` goes back.
+        if (rows.length === 0) {
+            return { nextCursor: null, prevCursor: null };
+        }
+        const isLastPage = rows.length < limit;
+        if (direction === 'backward') {
+            // rows ordered newest → oldest; the last element has the smallest seq.
+            const oldest = rows[rows.length - 1];
+            const newest = rows[0];
+            return {
+                nextCursor: isLastPage
+                    ? null
+                    : encodeCursor({ seq: oldest.seq, channelId }),
+                prevCursor: encodeCursor({ seq: newest.seq, channelId }),
+            };
+        }
+        // forward: rows ordered oldest → newest; the last element has the largest seq.
+        const newest = rows[rows.length - 1];
+        const oldest = rows[0];
+        return {
+            nextCursor: isLastPage ? null : encodeCursor({ seq: newest.seq, channelId }),
+            prevCursor: encodeCursor({ seq: oldest.seq, channelId }),
+        };
+    }
+    /**
+     * Return the current `MAX(seq)` for a channel, or 0 when empty.
+     *
+     * @param channelId - The channel id
+     * @returns The largest seq, or 0
+     */
+    getLastSeq(channelId) {
+        const row = this.db
+            .prepare(`SELECT COALESCE(MAX(seq), 0) AS last_seq
+         FROM chat_messages
+         WHERE channel_id = ?`)
+            .get(channelId);
+        return row.last_seq;
+    }
+    /** Count messages for a channel. Used by tests and metrics. */
+    count(channelId) {
+        const row = this.db
+            .prepare('SELECT COUNT(*) AS n FROM chat_messages WHERE channel_id = ?')
+            .get(channelId);
+        return row.n;
+    }
+}
+//# sourceMappingURL=message.store.js.map

package/dist/backend/backend/src/services/chat-v2/sqlite/message.store.js.map

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