@lix-js/sdk 0.5.1 → 0.6.0-preview.1

package/src/entity/conversation/attach-conversation.ts

@@ -1,98 +0,0 @@
-import type { Lix } from "../../lix/open-lix.js";
-import type { LixEntity, LixEntityCanonical } from "../types.js";
-
-/**
- * Attaches a conversation to an entity (creates mapping).
- *
- * @example
- * // Attach an existing conversation to an entity
- * await attachConversation({
- *   lix,
- *   entity: { entity_id: "para_123", schema_key: "markdown_paragraph", file_id: "README.md" },
- *   conversation: { id: "conv_123" }
- * });
- *
- * @example
- * // Scope the mapping to a specific version
- * await attachConversation({
- *   lix,
- *   entity: { entity_id: "para_123", schema_key: "markdown_paragraph", file_id: "README.md" },
- *   conversation: { id: "conv_123" },
- *   versionId: "v1"
- * });
- */
-export async function attachConversation(args: {
-	lix: Pick<Lix, "db">;
-	entity: LixEntity | LixEntityCanonical;
-	conversation: { id: string };
-	versionId?: string;
-}): Promise<void> {
-	const { lix, entity, conversation } = args;
-
-	const entity_id =
-		"entity_id" in entity ? entity.entity_id : entity.lixcol_entity_id;
-	const schema_key =
-		"schema_key" in entity ? entity.schema_key : entity.lixcol_schema_key;
-	const file_id = "file_id" in entity ? entity.file_id : entity.lixcol_file_id;
-
-	const versionId = args.versionId ?? "global";
-
-	const existingMapping = await lix.db
-		.selectFrom("entity_conversation_by_version")
-		.where("entity_id", "=", entity_id)
-		.where("schema_key", "=", schema_key)
-		.where("file_id", "=", file_id)
-		.where("conversation_id", "=", conversation.id)
-		.where("lixcol_version_id", "=", versionId)
-		.select(["entity_id"])
-		.executeTakeFirst();
-
-	if (existingMapping) return;
-
-	await lix.db
-		.insertInto("entity_conversation_by_version")
-		.values({
-			entity_id,
-			schema_key,
-			file_id,
-			conversation_id: conversation.id,
-			lixcol_version_id: versionId,
-		})
-		.execute();
-}
-
-/**
- * Detaches a conversation from an entity (removes mapping).
- *
- * @example
- * await detachConversation({
- *   lix,
- *   entity: { entity_id: "para_123", schema_key: "markdown_paragraph", file_id: "README.md" },
- *   conversation: { id: "conv_123" }
- * });
- */
-export async function detachConversation(args: {
-	lix: Pick<Lix, "db">;
-	entity: LixEntity | LixEntityCanonical;
-	conversation: { id: string };
-	versionId?: string;
-}): Promise<void> {
-	const { lix, entity, conversation } = args;
-
-	const entity_id =
-		"entity_id" in entity ? entity.entity_id : entity.lixcol_entity_id;
-	const schema_key =
-		"schema_key" in entity ? entity.schema_key : entity.lixcol_schema_key;
-	const file_id = "file_id" in entity ? entity.file_id : entity.lixcol_file_id;
-
-	const versionId = args.versionId ?? "global";
-
-	await lix.db
-		.deleteFrom("entity_conversation_by_version")
-		.where("entity_id", "=", entity_id)
-		.where("schema_key", "=", schema_key)
-		.where("file_id", "=", file_id)
-		.where("conversation_id", "=", conversation.id)
-		.where("lixcol_version_id", "=", versionId)
-		.execute();
-}

package/src/entity/conversation/schema-definition.ts

@@ -1,52 +0,0 @@
-import type {
-	FromLixSchemaDefinition,
-	LixSchemaDefinition,
-} from "../../schema-definition/definition.js";
-
-export type LixEntityConversation = FromLixSchemaDefinition<
-	typeof LixEntityConversationSchema
->;
-
-export const LixEntityConversationSchema = {
-	"x-lix-key": "lix_entity_conversation",
-	"x-lix-version": "1.0",
-	"x-lix-primary-key": [
-		"/entity_id",
-		"/schema_key",
-		"/file_id",
-		"/conversation_id",
-	],
-	"x-lix-override-lixcols": {
-		lixcol_file_id: '"lix"',
-		lixcol_plugin_key: '"lix_sdk"',
-	},
-	"x-lix-foreign-keys": [
-		{
-			properties: ["/entity_id", "/schema_key", "/file_id"],
-			references: {
-				schemaKey: "state",
-				properties: ["/entity_id", "/schema_key", "/file_id"],
-			},
-			// Conversation links are stored in the shared lix file but target
-			// entities in their original files, so only version_id scoping applies.
-			scope: ["version_id"],
-		},
-		{
-			properties: ["/conversation_id"],
-			references: {
-				schemaKey: "lix_conversation",
-				properties: ["/id"],
-			},
-		},
-	],
-	type: "object",
-	properties: {
-		entity_id: { type: "string" },
-		schema_key: { type: "string" },
-		file_id: { type: "string" },
-		conversation_id: { type: "string" },
-	},
-	required: ["entity_id", "schema_key", "file_id", "conversation_id"],
-	additionalProperties: false,
-} as const;
-LixEntityConversationSchema satisfies LixSchemaDefinition;

package/src/entity/conversation/schema.test.ts

@@ -1,105 +0,0 @@
-import { test, expect } from "vitest";
-import { openLix } from "../../lix/open-lix.js";
-import { LixEntityConversationSchema } from "./schema-definition.js";
-import { attachConversation } from "./attach-conversation.js";
-import { createConversation } from "../../conversation/create-conversation.js";
-import { createConversationMessage } from "../../conversation/create-conversation-message.js";
-import { fromPlainText } from "@opral/zettel-ast";
-
-test("entity_conversation schema should be properly defined", () => {
-	expect(LixEntityConversationSchema["x-lix-key"]).toBe(
-		"lix_entity_conversation"
-	);
-	expect(LixEntityConversationSchema["x-lix-version"]).toBe("1.0");
-	expect(LixEntityConversationSchema["x-lix-primary-key"]).toEqual([
-		"/entity_id",
-		"/schema_key",
-		"/file_id",
-		"/conversation_id",
-	]);
-
-	expect(LixEntityConversationSchema["x-lix-foreign-keys"]).toHaveLength(2);
-	expect(LixEntityConversationSchema["x-lix-foreign-keys"]![0]).toEqual({
-		properties: ["/entity_id", "/schema_key", "/file_id"],
-		references: {
-			schemaKey: "state",
-			properties: ["/entity_id", "/schema_key", "/file_id"],
-		},
-		scope: ["version_id"],
-	});
-	expect(LixEntityConversationSchema["x-lix-foreign-keys"]![1]).toEqual({
-		properties: ["/conversation_id"],
-		references: { schemaKey: "lix_conversation", properties: ["/id"] },
-	});
-
-	expect(LixEntityConversationSchema.properties).toEqual({
-		entity_id: { type: "string" },
-		schema_key: { type: "string" },
-		file_id: { type: "string" },
-		conversation_id: { type: "string" },
-	});
-
-	expect(LixEntityConversationSchema.required).toEqual([
-		"entity_id",
-		"schema_key",
-		"file_id",
-		"conversation_id",
-	]);
-});
-
-test("conversation_message supports metadata via createConversationMessage", async () => {
-	const lix = await openLix({});
-	const conv = await createConversation({ lix });
-	const c = await createConversationMessage({
-		lix,
-		conversation_id: conv.id,
-		body: fromPlainText("world"),
-		lixcol_metadata: { lix_agent_role: "assistant" },
-	});
-	expect(c.lixcol_metadata).toEqual({ lix_agent_role: "assistant" });
-});
-
-test("entity_conversation foreign key to state table should be enforced", async () => {
-	const lix = await openLix({});
-	const conv = await createConversation({
-		lix,
-		comments: [{ body: fromPlainText("Test") }],
-	});
-
-	await expect(
-		attachConversation({
-			lix,
-			entity: {
-				entity_id: "non-existent-id",
-				schema_key: "lix_key_value",
-				file_id: "lix",
-			},
-			conversation: { id: conv.id },
-		})
-	).rejects.toThrow(/Foreign key constraint violation/);
-});
-
-test("entity_conversation foreign key to conversation table should be enforced", async () => {
-	const lix = await openLix({});
-	await lix.db
-		.insertInto("key_value_by_version")
-		.values({
-			key: "test-config",
-			value: { setting: "testvalue" },
-			lixcol_version_id: "global",
-		})
-		.execute();
-	const keyValue = await lix.db
-		.selectFrom("key_value")
-		.where("key", "=", "test-config")
-		.selectAll()
-		.executeTakeFirstOrThrow();
-
-	await expect(
-		attachConversation({
-			lix,
-			entity: keyValue,
-			conversation: { id: "non-existent-conv-id" },
-		})
-	).rejects.toThrow(/Foreign key constraint violation/);
-});