@lix-js/sdk 0.4.7 → 0.5.0-preview.1

package/dist/thread/create-thread-comment.js

@@ -0,0 +1,64 @@
+import { nanoId } from "../deterministic/index.js";
+/**
+ * Adds a comment to an existing thread.
+ *
+ * The comment inherits the version context from the thread and can
+ * be nested by supplying a parent id.
+ *
+ * @example
+ * ```ts
+ * await createThreadComment({ lix, thread_id, body: "Thanks" })
+ * ```
+ */
+export async function createThreadComment(args) {
+    const executeInTransaction = async (trx) => {
+        const commentId = args.id ?? nanoId({ lix: args.lix });
+        const existingThread = await trx
+            .selectFrom("thread_all")
+            .where("id", "=", args.thread_id)
+            // get the root thread version
+            .where("lixcol_inherited_from_version_id", "is", null)
+            .select("lixcol_version_id")
+            .executeTakeFirstOrThrow();
+        // If parent_id is not provided, find the leaf comment using SQL traversal
+        let parentId = args.parent_id;
+        if (parentId === undefined) {
+            const leafComment = await trx
+                .selectFrom("thread_comment_all as c1")
+                .where("c1.thread_id", "=", args.thread_id)
+                .where("c1.lixcol_version_id", "=", existingThread.lixcol_version_id)
+                .where((eb) => eb.not(eb.exists(eb
+                .selectFrom("thread_comment_all as c2")
+                .where("c2.thread_id", "=", args.thread_id)
+                .where("c2.lixcol_version_id", "=", existingThread.lixcol_version_id)
+                .whereRef("c2.parent_id", "=", "c1.id")
+                .select("c2.id"))))
+                .select("c1.id")
+                .executeTakeFirst();
+            parentId = leafComment?.id ?? null;
+        }
+        await trx
+            .insertInto("thread_comment_all")
+            .values({
+            id: commentId,
+            thread_id: args.thread_id,
+            body: args.body,
+            parent_id: parentId,
+            lixcol_version_id: existingThread.lixcol_version_id,
+        })
+            .execute();
+        return await trx
+            .selectFrom("thread_comment_all")
+            .selectAll()
+            .where("id", "=", commentId)
+            .where("lixcol_version_id", "=", existingThread.lixcol_version_id)
+            .executeTakeFirstOrThrow();
+    };
+    if (args.lix.db.isTransaction) {
+        return await executeInTransaction(args.lix.db);
+    }
+    else {
+        return await args.lix.db.transaction().execute(executeInTransaction);
+    }
+}
+//# sourceMappingURL=create-thread-comment.js.map

package/dist/thread/create-thread-comment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-thread-comment.js","sourceRoot":"","sources":["../../src/thread/create-thread-comment.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAInD;;;;;;;;;;GAUG;AAEH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACxC,IAA+C;IAE/C,MAAM,oBAAoB,GAAG,KAAK,EAAE,GAAc,EAAE,EAAE;QACrD,MAAM,SAAS,GAAG,IAAI,CAAC,EAAE,IAAI,MAAM,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QAEvD,MAAM,cAAc,GAAG,MAAM,GAAG;aAC9B,UAAU,CAAC,YAAY,CAAC;aACxB,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;YACjC,8BAA8B;aAC7B,KAAK,CAAC,kCAAkC,EAAE,IAAI,EAAE,IAAI,CAAC;aACrD,MAAM,CAAC,mBAAmB,CAAC;aAC3B,uBAAuB,EAAE,CAAC;QAE5B,0EAA0E;QAC1E,IAAI,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;QAC9B,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,WAAW,GAAG,MAAM,GAAG;iBAC3B,UAAU,CAAC,0BAA0B,CAAC;iBACtC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;iBAC1C,KAAK,CAAC,sBAAsB,EAAE,GAAG,EAAE,cAAc,CAAC,iBAAiB,CAAC;iBACpE,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CACb,EAAE,CAAC,GAAG,CACL,EAAE,CAAC,MAAM,CACR,EAAE;iBACA,UAAU,CAAC,0BAA0B,CAAC;iBACtC,KAAK,CAAC,cAAc,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC;iBAC1C,KAAK,CACL,sBAAsB,EACtB,GAAG,EACH,cAAc,CAAC,iBAAiB,CAChC;iBACA,QAAQ,CAAC,cAAc,EAAE,GAAG,EAAE,OAAO,CAAC;iBACtC,MAAM,CAAC,OAAO,CAAC,CACjB,CACD,CACD;iBACA,MAAM,CAAC,OAAO,CAAC;iBACf,gBAAgB,EAAE,CAAC;YACrB,QAAQ,GAAG,WAAW,EAAE,EAAE,IAAI,IAAI,CAAC;QACpC,CAAC;QAED,MAAM,GAAG;aACP,UAAU,CAAC,oBAAoB,CAAC;aAChC,MAAM,CAAC;YACP,EAAE,EAAE,SAAS;YACb,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,QAAQ;YACnB,iBAAiB,EAAE,cAAc,CAAC,iBAAiB;SACnD,CAAC;aACD,OAAO,EAAE,CAAC;QAEZ,OAAO,MAAM,GAAG;aACd,UAAU,CAAC,oBAAoB,CAAC;aAChC,SAAS,EAAE;aACX,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,SAAS,CAAC;aAC3B,KAAK,CAAC,mBAAmB,EAAE,GAAG,EAAE,cAAc,CAAC,iBAAiB,CAAC;aACjE,uBAAuB,EAAE,CAAC;IAC7B,CAAC,CAAC;IAEF,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC;QAC/B,OAAO,MAAM,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACP,OAAO,MAAM,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACtE,CAAC;AACF,CAAC"}

package/dist/thread/create-thread-comment.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-thread-comment.test.d.ts.map

package/dist/thread/create-thread-comment.test.d.ts.map

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

package/dist/thread/create-thread-comment.test.js

@@ -0,0 +1,97 @@
+import { test, expect } from "vitest";
+import { createThreadComment } from "./create-thread-comment.js";
+import { openLix } from "../lix/open-lix.js";
+import { fromPlainText } from "@opral/zettel-ast";
+import { nanoId } from "../deterministic/index.js";
+test("creates a thread comment", async () => {
+    const lix = await openLix({});
+    const threadId = nanoId({ lix });
+    await lix.db.insertInto("thread").values({ id: threadId }).execute();
+    const thread = await lix.db
+        .selectFrom("thread")
+        .selectAll()
+        .where("id", "=", threadId)
+        .executeTakeFirstOrThrow();
+    const threadComment = await createThreadComment({
+        lix,
+        thread_id: thread.id,
+        body: fromPlainText("Hello world  "),
+    });
+    expect(threadComment).toBeDefined();
+});
+test("defaults to the version of the thread", async () => {
+    const lix = await openLix({});
+    const threadId = nanoId({ lix });
+    await lix.db.insertInto("thread").values({ id: threadId }).execute();
+    const activeVersionScopedThread = await lix.db
+        .selectFrom("thread")
+        .selectAll()
+        .where("id", "=", threadId)
+        .executeTakeFirstOrThrow();
+    const threadComment = await createThreadComment({
+        lix,
+        thread_id: activeVersionScopedThread.id,
+        body: fromPlainText("Hello world  "),
+    });
+    expect(threadComment).toBeDefined();
+    await lix.db
+        .insertInto("thread_all")
+        .values({
+        id: "global-thread",
+        lixcol_version_id: "global",
+    })
+        .execute();
+    const globalThreadComment = await createThreadComment({
+        lix,
+        thread_id: "global-thread",
+        body: fromPlainText("Hello global world  "),
+    });
+    expect(globalThreadComment).toBeDefined();
+});
+test("defaults parent_id to the last comment when not provided", async () => {
+    const lix = await openLix({});
+    const threadId = nanoId({ lix });
+    await lix.db.insertInto("thread").values({ id: threadId }).execute();
+    const thread = await lix.db
+        .selectFrom("thread")
+        .selectAll()
+        .where("id", "=", threadId)
+        .executeTakeFirstOrThrow();
+    // Create first comment (should have parent_id = null)
+    const firstComment = await createThreadComment({
+        lix,
+        thread_id: thread.id,
+        body: fromPlainText("First comment"),
+    });
+    expect(firstComment.parent_id).toBeNull();
+    // Create second comment without parent_id (should default to first comment)
+    const secondComment = await createThreadComment({
+        lix,
+        thread_id: thread.id,
+        body: fromPlainText("Second comment"),
+    });
+    expect(secondComment.parent_id).toBe(firstComment.id);
+    // Create third comment without parent_id (should default to second comment)
+    const thirdComment = await createThreadComment({
+        lix,
+        thread_id: thread.id,
+        body: fromPlainText("Third comment"),
+    });
+    expect(thirdComment.parent_id).toBe(secondComment.id);
+    // Create fourth comment with explicit parent_id (should use provided parent_id)
+    const fourthComment = await createThreadComment({
+        lix,
+        thread_id: thread.id,
+        body: fromPlainText("Fourth comment"),
+        parent_id: firstComment.id,
+    });
+    expect(fourthComment.parent_id).toBe(firstComment.id);
+    // Create fifth comment without parent_id (should default to third comment, which is still the leaf)
+    const fifthComment = await createThreadComment({
+        lix,
+        thread_id: thread.id,
+        body: fromPlainText("Fifth comment"),
+    });
+    expect(fifthComment.parent_id).toBe(thirdComment.id);
+});
+//# sourceMappingURL=create-thread-comment.test.js.map

package/dist/thread/create-thread-comment.test.js.map

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

package/dist/thread/create-thread.d.ts

@@ -0,0 +1,42 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { LixThread, LixThreadComment } from "./schema.js";
+import type { NewState } from "../entity-views/types.js";
+import type { LixEntity, LixEntityCanonical } from "../entity/schema.js";
+/**
+ * Starts a new discussion thread.
+ *
+ * Threads allow collaborators to attach comments to a specific
+ * version or entity. Initial comments can be provided and will be
+ * inserted sequentially.
+ *
+ * @example
+ * ```ts
+ * // Create a standalone thread
+ * const thread = await createThread({ lix, comments: [{ body: "Hello" }] })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Create a thread attached to an entity
+ * const thread = await createThread({
+ *   lix,
+ *   entity: { entity_id: "para_123", schema_key: "markdown_paragraph", file_id: "README.md" },
+ *   comments: [{ body: "This paragraph needs review" }]
+ * })
+ * ```
+ */
+export declare function createThread(args: {
+    lix: Lix;
+    id?: string;
+    comments?: Pick<NewState<LixThreadComment>, "body">[];
+    /** defaults to global */
+    versionId?: string;
+    /** Optional entity to attach the thread to */
+    entity?: LixEntity | LixEntityCanonical;
+}): Promise<LixThread & {
+    lixcol_version_id: string;
+    comments: (LixThreadComment & {
+        lixcol_version_id: string;
+    })[];
+}>;
+//# sourceMappingURL=create-thread.d.ts.map

package/dist/thread/create-thread.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-thread.d.ts","sourceRoot":"","sources":["../../src/thread/create-thread.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,KAAK,EAAE,SAAS,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAGzE;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,GAAG,CAAC;IACT,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,QAAQ,CAAC,EAAE,IAAI,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC,EAAE,CAAC;IACtD,yBAAyB;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,SAAS,GAAG,kBAAkB,CAAC;CACxC,GAAG,OAAO,CACV,SAAS,GAAG;IACX,iBAAiB,EAAE,MAAM,CAAC;IAC1B,QAAQ,EAAE,CAAC,gBAAgB,GAAG;QAC7B,iBAAiB,EAAE,MAAM,CAAC;KAC1B,CAAC,EAAE,CAAC;CACL,CACD,CA6DA"}

package/dist/thread/create-thread.js

@@ -0,0 +1,79 @@
+import { nanoId } from "../deterministic/index.js";
+import { createEntityThread } from "../entity/thread/create-entity-thread.js";
+/**
+ * Starts a new discussion thread.
+ *
+ * Threads allow collaborators to attach comments to a specific
+ * version or entity. Initial comments can be provided and will be
+ * inserted sequentially.
+ *
+ * @example
+ * ```ts
+ * // Create a standalone thread
+ * const thread = await createThread({ lix, comments: [{ body: "Hello" }] })
+ * ```
+ *
+ * @example
+ * ```ts
+ * // Create a thread attached to an entity
+ * const thread = await createThread({
+ *   lix,
+ *   entity: { entity_id: "para_123", schema_key: "markdown_paragraph", file_id: "README.md" },
+ *   comments: [{ body: "This paragraph needs review" }]
+ * })
+ * ```
+ */
+export async function createThread(args) {
+    const executeInTransaction = async (trx) => {
+        const threadId = args.id ?? nanoId({ lix: args.lix });
+        const versionId = args.versionId ?? "global";
+        await trx
+            .insertInto("thread_all")
+            .values({ id: threadId, lixcol_version_id: versionId })
+            .execute();
+        const thread = await trx
+            .selectFrom("thread_all")
+            .selectAll()
+            .where("id", "=", threadId)
+            .where("lixcol_version_id", "=", versionId)
+            .executeTakeFirstOrThrow();
+        const insertedComments = [];
+        for (const [index, comment] of (args.comments ?? []).entries()) {
+            const commentId = nanoId({ lix: args.lix });
+            await trx
+                .insertInto("thread_comment_all")
+                .values({
+                id: commentId,
+                thread_id: thread.id,
+                body: comment.body,
+                parent_id: index > 0 ? insertedComments[index - 1].id : null,
+                lixcol_version_id: versionId,
+            })
+                .execute();
+            const insertedComment = await trx
+                .selectFrom("thread_comment_all")
+                .selectAll()
+                .where("id", "=", commentId)
+                .where("lixcol_version_id", "=", versionId)
+                .executeTakeFirstOrThrow();
+            insertedComments.push(insertedComment);
+        }
+        // If an entity is provided, create the entity-thread mapping
+        if (args.entity) {
+            await createEntityThread({
+                lix: { db: trx },
+                entity: args.entity,
+                thread: { id: threadId },
+                versionId: versionId,
+            });
+        }
+        return { ...thread, comments: insertedComments };
+    };
+    if (args.lix.db.isTransaction) {
+        return await executeInTransaction(args.lix.db);
+    }
+    else {
+        return await args.lix.db.transaction().execute(executeInTransaction);
+    }
+}
+//# sourceMappingURL=create-thread.js.map

package/dist/thread/create-thread.js.map

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

package/dist/thread/create-thread.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=create-thread.test.d.ts.map

package/dist/thread/create-thread.test.d.ts.map

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

package/dist/thread/create-thread.test.js

@@ -0,0 +1,175 @@
+import { expect, test } from "vitest";
+import { createThread } from "./create-thread.js";
+import { openLix } from "../lix/open-lix.js";
+import { fromPlainText } from "@opral/zettel-ast";
+import { ebEntity } from "../entity/eb-entity.js";
+test("creates a thread with sequential comments where only the first has null parent_id", async () => {
+    const lix = await openLix({});
+    const comments = [
+        { body: fromPlainText("First comment") },
+        { body: fromPlainText("Second comment") },
+        { body: fromPlainText("Third comment") },
+    ];
+    const threadWithComments = await createThread({ lix, comments });
+    const { comments: insertedComments } = threadWithComments;
+    expect(insertedComments).toHaveLength(3);
+    expect(insertedComments[0].parent_id).toBeNull();
+    expect(insertedComments[1].parent_id).toBe(insertedComments[0].id);
+    expect(insertedComments[2].parent_id).toBe(insertedComments[1].id);
+});
+test("defaults to global version if no versionId is provided", async () => {
+    const lix = await openLix({});
+    const comments = [{ body: fromPlainText("Global comment") }];
+    const threadWithComments = await createThread({ lix, comments });
+    expect(threadWithComments.lixcol_version_id).toBe("global");
+    expect(threadWithComments.comments[0].lixcol_version_id).toBe("global");
+});
+test("creates a thread with entity mapping when entity is provided", async () => {
+    const lix = await openLix({});
+    // Create a key-value entity
+    await lix.db
+        .insertInto("key_value_all")
+        .values({
+        key: "test-entity-config",
+        value: { setting: "entityvalue" },
+        lixcol_version_id: "global",
+    })
+        .execute();
+    const keyValue = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", "test-entity-config")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const comments = [{ body: fromPlainText("Comment on entity") }];
+    // Create thread with entity
+    const threadWithComments = await createThread({
+        lix,
+        comments,
+        entity: keyValue,
+    });
+    // Verify thread was created
+    expect(threadWithComments.id).toBeDefined();
+    expect(threadWithComments.comments).toHaveLength(1);
+    // Verify entity-thread mapping was created
+    const mapping = await lix.db
+        .selectFrom("entity_thread")
+        .where("entity_id", "=", keyValue.key)
+        .where("schema_key", "=", "lix_key_value")
+        .where("file_id", "=", "lix")
+        .where("thread_id", "=", threadWithComments.id)
+        .selectAll()
+        .executeTakeFirst();
+    expect(mapping).toBeDefined();
+    expect(mapping?.thread_id).toBe(threadWithComments.id);
+});
+test("creates a thread without entity mapping when entity is not provided", async () => {
+    const lix = await openLix({});
+    const comments = [{ body: fromPlainText("Standalone comment") }];
+    // Create thread without entity
+    const threadWithComments = await createThread({ lix, comments });
+    // Verify thread was created
+    expect(threadWithComments.id).toBeDefined();
+    // Verify no entity-thread mapping exists
+    const mappings = await lix.db
+        .selectFrom("entity_thread")
+        .where("thread_id", "=", threadWithComments.id)
+        .selectAll()
+        .execute();
+    expect(mappings).toHaveLength(0);
+});
+test("can query threads for a specific entity using ebEntity", async () => {
+    const lix = await openLix({});
+    // Create a key-value entity
+    await lix.db
+        .insertInto("key_value_all")
+        .values({
+        key: "query-test-config",
+        value: { setting: "queryvalue" },
+        lixcol_version_id: "global",
+    })
+        .execute();
+    const keyValue = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", "query-test-config")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    // Create multiple threads for the entity
+    const thread1 = await createThread({
+        lix,
+        comments: [{ body: fromPlainText("First thread") }],
+        entity: keyValue,
+    });
+    const thread2 = await createThread({
+        lix,
+        comments: [{ body: fromPlainText("Second thread") }],
+        entity: keyValue,
+    });
+    // Create a thread for a different entity
+    await lix.db
+        .insertInto("key_value_all")
+        .values({
+        key: "other-config",
+        value: { setting: "othervalue" },
+        lixcol_version_id: "global",
+    })
+        .execute();
+    const otherKeyValue = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", "other-config")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    await createThread({
+        lix,
+        comments: [{ body: fromPlainText("Other thread") }],
+        entity: otherKeyValue,
+    });
+    // Query threads for the specific entity using ebEntity
+    const threads = await lix.db
+        .selectFrom("thread")
+        .innerJoin("entity_thread", "entity_thread.thread_id", "thread.id")
+        .where(ebEntity("entity_thread").equals(keyValue))
+        .select(["thread.id"])
+        .execute();
+    expect(threads).toHaveLength(2);
+    expect(threads.map((t) => t.id)).toContain(thread1.id);
+    expect(threads.map((t) => t.id)).toContain(thread2.id);
+});
+test("works with lixcol_ prefixed entity fields", async () => {
+    const lix = await openLix({});
+    // Create a key-value entity
+    await lix.db
+        .insertInto("key_value_all")
+        .values({
+        key: "lixcol-test-config",
+        value: { setting: "lixcolvalue" },
+        lixcol_version_id: "global",
+    })
+        .execute();
+    // Get the key-value from state view (which has lixcol_ prefixed fields)
+    const stateEntity = await lix.db
+        .selectFrom("state")
+        .where("entity_id", "=", "lixcol-test-config")
+        .where("schema_key", "=", "lix_key_value")
+        .where("file_id", "=", "lix")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    const comments = [{ body: fromPlainText("Comment with lixcol fields") }];
+    // Create thread with entity object from state view
+    const threadWithComments = await createThread({
+        lix,
+        comments,
+        entity: stateEntity,
+    });
+    // Verify entity-thread mapping was created
+    const mapping = await lix.db
+        .selectFrom("entity_thread")
+        .where("entity_id", "=", "lixcol-test-config")
+        .where("schema_key", "=", "lix_key_value")
+        .where("file_id", "=", "lix")
+        .where("thread_id", "=", threadWithComments.id)
+        .selectAll()
+        .executeTakeFirst();
+    expect(mapping).toBeDefined();
+    expect(mapping?.thread_id).toBe(threadWithComments.id);
+});
+//# sourceMappingURL=create-thread.test.js.map

package/dist/thread/create-thread.test.js.map

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

package/dist/thread/database-schema.d.ts

@@ -0,0 +1,20 @@
+import type { Generated, Insertable, Selectable, Updateable } from "kysely";
+import type { SqliteWasmDatabase } from "sqlite-wasm-kysely";
+import { type ZettelDoc } from "@opral/zettel-ast";
+export declare function applyThreadDatabaseSchema(sqlite: SqliteWasmDatabase): SqliteWasmDatabase;
+export type Thread = Selectable<ThreadTable>;
+export type NewThread = Insertable<ThreadTable>;
+export type ThreadUpdate = Updateable<ThreadTable>;
+export type ThreadTable = {
+    id: Generated<string>;
+};
+export type ThreadComment = Selectable<ThreadCommentTable>;
+export type NewThreadComment = Insertable<ThreadCommentTable>;
+export type ThreadCommentUpdate = Updateable<ThreadCommentTable>;
+export type ThreadCommentTable = {
+    id: Generated<string>;
+    thread_id: string;
+    parent_id: string | null;
+    body: ZettelDoc;
+};
+//# sourceMappingURL=database-schema.d.ts.map

package/dist/thread/database-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-schema.d.ts","sourceRoot":"","sources":["../../src/thread/database-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAC7D,OAAO,EAEN,KAAK,SAAS,EACd,MAAM,mBAAmB,CAAC;AAE3B,wBAAgB,yBAAyB,CACxC,MAAM,EAAE,kBAAkB,GACxB,kBAAkB,CA0DpB;AAED,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAC7C,MAAM,MAAM,SAAS,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AAChD,MAAM,MAAM,YAAY,GAAG,UAAU,CAAC,WAAW,CAAC,CAAC;AACnD,MAAM,MAAM,WAAW,GAAG;IACzB,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAC3D,MAAM,MAAM,gBAAgB,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AAC9D,MAAM,MAAM,mBAAmB,GAAG,UAAU,CAAC,kBAAkB,CAAC,CAAC;AACjE,MAAM,MAAM,kBAAkB,GAAG;IAChC,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,IAAI,EAAE,SAAS,CAAC;CAChB,CAAC"}

package/dist/thread/database-schema.js

@@ -0,0 +1,57 @@
+import { validate as validateZettelDoc, } from "@opral/zettel-ast";
+export function applyThreadDatabaseSchema(sqlite) {
+    // Register the validate_zettel_doc function directly on this sqlite instance
+    sqlite.createFunction({
+        name: "validate_zettel_doc",
+        arity: 1,
+        xFunc: (_ctx, value) => {
+            const result = validateZettelDoc(JSON.parse(value));
+            if (result.errors) {
+                throw new Error("The Zettel Doc is invalid: " + result.errors.join("\n"));
+            }
+            return 1;
+        },
+        deterministic: true,
+    });
+    const sql = `
+  CREATE TABLE IF NOT EXISTS thread (
+    id TEXT PRIMARY KEY DEFAULT (nano_id())
+  ) STRICT;
+
+  CREATE TABLE IF NOT EXISTS thread_comment (
+    id TEXT PRIMARY KEY DEFAULT (nano_id()),
+    thread_id TEXT NOT NULL,
+    parent_id TEXT,
+
+    body BLOB NOT NULL, --JSONB
+    FOREIGN KEY(thread_id) REFERENCES thread(id),
+    FOREIGN KEY(parent_id) REFERENCES thread_comment(id)
+  ) STRICT;
+
+  -- TEMP TRIGGER to validate ZettelDoc for inserts
+  CREATE TEMP TRIGGER IF NOT EXISTS validate_thread_comment_doc_insert
+  BEFORE INSERT ON thread_comment
+  FOR EACH ROW
+  BEGIN
+    SELECT
+      CASE
+        WHEN validate_zettel_doc(json(NEW.body)) = 0
+        THEN RAISE(ABORT, 'Invalid ZettelDoc: body must be a valid ZettelDoc')
+      END;
+  END;
+
+  -- TEMP TRIGGER to validate ZettelDoc for upserts/updates
+  CREATE TEMP TRIGGER IF NOT EXISTS validate_thread_comment_doc_update
+  BEFORE UPDATE OF body ON thread_comment
+  FOR EACH ROW
+  BEGIN
+    SELECT
+      CASE
+        WHEN validate_zettel_doc(json(NEW.body)) = 0
+        THEN RAISE(ABORT, 'Invalid ZettelDoc: body must be a valid ZettelDoc')
+      END;
+  END;
+`;
+    return sqlite.exec(sql);
+}
+//# sourceMappingURL=database-schema.js.map

package/dist/thread/database-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-schema.js","sourceRoot":"","sources":["../../src/thread/database-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EACN,QAAQ,IAAI,iBAAiB,GAE7B,MAAM,mBAAmB,CAAC;AAE3B,MAAM,UAAU,yBAAyB,CACxC,MAA0B;IAE1B,6EAA6E;IAC7E,MAAM,CAAC,cAAc,CAAC;QACrB,IAAI,EAAE,qBAAqB;QAC3B,KAAK,EAAE,CAAC;QACR,KAAK,EAAE,CAAC,IAAY,EAAE,KAAK,EAAE,EAAE;YAC9B,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,CAAC,KAAK,CAAC,KAAe,CAAC,CAAC,CAAC;YAC9D,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnB,MAAM,IAAI,KAAK,CACd,6BAA6B,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CACxD,CAAC;YACH,CAAC;YACD,OAAO,CAAC,CAAC;QACV,CAAC;QACD,aAAa,EAAE,IAAI;KACnB,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAsCZ,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/thread/database-schema.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=database-schema.test.d.ts.map

package/dist/thread/database-schema.test.d.ts.map

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