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

package/src/version/schema.ts

@@ -1,475 +0,0 @@
-import type { LixEngine } from "../engine/boot.js";
-import {
-	LixVersionDescriptorSchema,
-	LixVersionTipSchema,
-	LixActiveVersionSchema,
-	type LixVersionDescriptor,
-	type LixVersionTip,
-	type LixActiveVersion,
-	type LixVersion,
-} from "./schema-definition.js";
-
-export {
-	LixVersionDescriptorSchema,
-	LixVersionTipSchema,
-	LixActiveVersionSchema,
-	type LixVersionDescriptor,
-	type LixVersionTip,
-	type LixActiveVersion,
-	type LixVersion,
-} from "./schema-definition.js";
-
-export function applyVersionDatabaseSchema(args: {
-	engine: Pick<LixEngine, "sqlite">;
-}): void {
-	// 2) Composite "version" view that merges descriptor + tip into a single projection
-	// No backward-compat combined rows. The merged view exposes schema_key logically as 'lix_version'.
-	args.engine.sqlite.exec(`
-        CREATE VIEW IF NOT EXISTS version AS
-        WITH descriptor AS (
-            SELECT
-                id,
-                name,
-                inherits_from_version_id,
-                hidden,
-                lixcol_entity_id,
-                lixcol_file_id,
-                lixcol_plugin_key,
-                lixcol_schema_version,
-                d_change_id,
-                d_created_at,
-                d_updated_at,
-                d_commit_id
-            FROM (
-                SELECT 
-                    json_extract(snapshot_content, '$.id') AS id,
-                    json_extract(snapshot_content, '$.name') AS name,
-                    json_extract(snapshot_content, '$.inherits_from_version_id') AS inherits_from_version_id,
-                    json_extract(snapshot_content, '$.hidden') AS hidden,
-                    entity_id AS lixcol_entity_id,
-                    file_id AS lixcol_file_id,
-                    plugin_key AS lixcol_plugin_key,
-                    schema_version AS lixcol_schema_version,
-                    change_id AS d_change_id,
-                    created_at AS d_created_at,
-                    updated_at AS d_updated_at,
-                    commit_id AS d_commit_id,
-                    ROW_NUMBER() OVER (
-                        PARTITION BY entity_id
-                        ORDER BY updated_at DESC, change_id DESC
-                    ) AS rn
-                FROM state_by_version s
-                WHERE s.schema_key = 'lix_version_descriptor'
-                  AND s.version_id = 'global'
-            )
-            WHERE rn = 1
-        ),
-        tip AS (
-            SELECT
-                id,
-                commit_id,
-                working_commit_id,
-                t_change_id,
-                t_created_at,
-                t_updated_at,
-                t_commit_id
-            FROM (
-                SELECT 
-                    json_extract(snapshot_content, '$.id') AS id,
-                    json_extract(snapshot_content, '$.commit_id') AS commit_id,
-                    json_extract(snapshot_content, '$.working_commit_id') AS working_commit_id,
-                    change_id AS t_change_id,
-                    created_at AS t_created_at,
-                    updated_at AS t_updated_at,
-                    commit_id AS t_commit_id,
-                    ROW_NUMBER() OVER (
-                        PARTITION BY entity_id
-                        ORDER BY updated_at DESC, change_id DESC
-                    ) AS rn
-                FROM state_by_version s
-                WHERE s.schema_key = 'lix_version_tip'
-                  AND s.version_id = 'global'
-            )
-            WHERE rn = 1
-        )
-        SELECT 
-            d.id,
-            d.name,
-            t.commit_id,
-            t.working_commit_id AS working_commit_id,
-            d.inherits_from_version_id,
-            d.hidden,
-            d.lixcol_entity_id,
-            'lix_version' AS lixcol_schema_key,
-            d.lixcol_file_id,
-            NULL AS lixcol_inherited_from_version_id,
-            COALESCE(t.t_change_id, d.d_change_id) AS lixcol_change_id,
-            MIN(COALESCE(d.d_created_at, t.t_created_at), COALESCE(t.t_created_at, d.d_created_at)) AS lixcol_created_at,
-            COALESCE(t.t_updated_at, d.d_updated_at) AS lixcol_updated_at,
-            COALESCE(t.commit_id, d.d_commit_id) AS lixcol_commit_id,
-            0 AS lixcol_untracked
-        FROM descriptor d 
-        LEFT JOIN tip t ON t.id = d.id;
-
-        CREATE VIEW IF NOT EXISTS version_by_version AS
-        WITH descriptor AS (
-            SELECT
-                id,
-                name,
-                inherits_from_version_id,
-                hidden,
-                lixcol_entity_id,
-                lixcol_file_id,
-                lixcol_plugin_key,
-                lixcol_schema_version,
-                lixcol_version_id,
-                lixcol_inherited_from_version_id,
-                d_change_id,
-                d_created_at,
-                d_updated_at,
-                d_commit_id
-            FROM (
-                SELECT 
-                    json_extract(snapshot_content, '$.id') AS id,
-                    json_extract(snapshot_content, '$.name') AS name,
-                    json_extract(snapshot_content, '$.inherits_from_version_id') AS inherits_from_version_id,
-                    json_extract(snapshot_content, '$.hidden') AS hidden,
-                    entity_id AS lixcol_entity_id,
-                    file_id AS lixcol_file_id,
-                    plugin_key AS lixcol_plugin_key,
-                    schema_version AS lixcol_schema_version,
-                    version_id AS lixcol_version_id,
-                    inherited_from_version_id AS lixcol_inherited_from_version_id,
-                    change_id AS d_change_id,
-                    created_at AS d_created_at,
-                    updated_at AS d_updated_at,
-                    commit_id AS d_commit_id,
-                    ROW_NUMBER() OVER (
-                        PARTITION BY entity_id, version_id
-                        ORDER BY updated_at DESC, change_id DESC
-                    ) AS rn
-                FROM state_by_version s
-                WHERE s.schema_key = 'lix_version_descriptor'
-            )
-            WHERE rn = 1
-        ),
-        tip AS (
-            SELECT
-                id,
-                commit_id,
-                working_commit_id,
-                lixcol_version_id,
-                t_change_id,
-                t_created_at,
-                t_updated_at,
-                t_commit_id
-            FROM (
-                SELECT 
-                    json_extract(snapshot_content, '$.id') AS id,
-                    json_extract(snapshot_content, '$.commit_id') AS commit_id,
-                    json_extract(snapshot_content, '$.working_commit_id') AS working_commit_id,
-                    version_id AS lixcol_version_id,
-                    change_id AS t_change_id,
-                    created_at AS t_created_at,
-                    updated_at AS t_updated_at,
-                    commit_id AS t_commit_id,
-                    ROW_NUMBER() OVER (
-                        PARTITION BY entity_id, version_id
-                        ORDER BY updated_at DESC, change_id DESC
-                    ) AS rn
-                FROM state_by_version s
-                WHERE s.schema_key = 'lix_version_tip'
-            )
-            WHERE rn = 1
-        )
-        SELECT 
-            d.id,
-            d.name,
-            t.commit_id,
-            t.working_commit_id AS working_commit_id,
-            d.inherits_from_version_id,
-            d.hidden,
-            d.lixcol_entity_id,
-            'lix_version' AS lixcol_schema_key,
-            d.lixcol_file_id,
-            d.lixcol_plugin_key,
-            d.lixcol_schema_version,
-            d.lixcol_version_id,
-            d.lixcol_inherited_from_version_id,
-            COALESCE(t.t_change_id, d.d_change_id) AS lixcol_change_id,
-            MIN(COALESCE(d.d_created_at, t.t_created_at), COALESCE(t.t_created_at, d.d_created_at)) AS lixcol_created_at,
-            COALESCE(t.t_updated_at, d.d_updated_at) AS lixcol_updated_at,
-            COALESCE(t.commit_id, d.d_commit_id) AS lixcol_commit_id,
-            0 AS lixcol_untracked
-        FROM descriptor d 
-        LEFT JOIN tip t ON t.id = d.id AND t.lixcol_version_id = d.lixcol_version_id;
-
-        -- Keep history view for typing completeness; may be sparsely populated until
-        -- all writers route combined rows, which we are phasing out.
-        CREATE VIEW IF NOT EXISTS version_history AS
-        SELECT 
-            json_extract(snapshot_content, '$.id') AS id,
-            json_extract(snapshot_content, '$.name') AS name,
-            json_extract(snapshot_content, '$.commit_id') AS commit_id,
-            json_extract(snapshot_content, '$.working_commit_id') AS working_commit_id,
-            json_extract(snapshot_content, '$.inherits_from_version_id') AS inherits_from_version_id,
-            json_extract(snapshot_content, '$.hidden') AS hidden,
-            entity_id AS lixcol_entity_id,
-            file_id AS lixcol_file_id,
-            plugin_key AS lixcol_plugin_key,
-            schema_version AS lixcol_schema_version,
-            change_id AS lixcol_change_id,
-            commit_id AS lixcol_commit_id
-        FROM state_history
-        WHERE schema_key = 'lix_version';
-
-        -- Triggers to route writes on version view through version_by_version (global scope)
-        CREATE TRIGGER IF NOT EXISTS version_insert
-        INSTEAD OF INSERT ON version
-        BEGIN
-
-            -- Route creation via version_by_version (global scope). The version_by_version_insert trigger
-            -- will take care of writing descriptor + tip rows.
-            INSERT INTO version_by_version (
-                id,
-                name,
-                working_commit_id,
-                inherits_from_version_id,
-                hidden,
-                lixcol_version_id,
-                commit_id
-            ) VALUES (
-                NEW.id,
-                NEW.name,
-                NEW.working_commit_id,
-                NEW.inherits_from_version_id,
-                NEW.hidden,
-                'global',
-                NEW.commit_id
-            );
-
-        END;
-
-        CREATE TRIGGER IF NOT EXISTS version_update
-        INSTEAD OF UPDATE ON version
-        BEGIN
-            -- Route updates via version_by_version (global scope). The version_by_version_update trigger
-            -- will update descriptor fields and move the tip when commit_id is provided.
-            UPDATE version_by_version
-            SET
-                name = NEW.name,
-                working_commit_id = NEW.working_commit_id,
-                inherits_from_version_id = NEW.inherits_from_version_id,
-                hidden = NEW.hidden,
-                commit_id = NEW.commit_id
-            WHERE id = NEW.id
-              AND lixcol_version_id = 'global';
-
-        END;
-
-        CREATE TRIGGER IF NOT EXISTS version_delete
-        INSTEAD OF DELETE ON version
-        BEGIN
-            -- Route deletes via version_by_version (global scope); version_by_version_delete handles state
-            DELETE FROM version_by_version
-            WHERE id = OLD.id
-              AND lixcol_version_id = 'global';
-        END;
-
-        -- Write-capable version_by_version triggers mirroring 'version' but honoring explicit lixcol_version_id
-        CREATE TRIGGER IF NOT EXISTS version_by_version_insert
-        INSTEAD OF INSERT ON version_by_version
-        BEGIN
-            -- Always write descriptor row
-            INSERT INTO state_by_version (
-                entity_id, schema_key, file_id, plugin_key, snapshot_content, schema_version, version_id
-            ) 
-            SELECT 
-                gen_id,
-                'lix_version_descriptor',
-                'lix',
-                'lix_sdk',
-                json_object(
-                    'id', gen_id,
-                    'name', COALESCE(NEW.name, human_id()),
-                    'inherits_from_version_id', NEW.inherits_from_version_id,
-                    'hidden', COALESCE(NEW.hidden, 0)
-                ),
-                '1.0',
-                COALESCE(NEW.lixcol_version_id, 'global')
-            FROM (SELECT COALESCE(NEW.id, lix_nano_id()) AS gen_id);
-
-            -- Also write tip row: use NEW.commit_id if provided, otherwise default to parent's current tip
-            INSERT INTO state_by_version (
-                entity_id, schema_key, file_id, plugin_key, snapshot_content, schema_version, version_id
-            )
-            SELECT
-                gen_id,
-                'lix_version_tip',
-                'lix',
-                'lix_sdk',
-                json_object(
-                    'id', gen_id,
-                    'commit_id', tip_cid,
-                    'working_commit_id', COALESCE(NEW.working_commit_id, tip_cid)
-                ),
-                '1.0',
-                COALESCE(NEW.lixcol_version_id, 'global')
-            FROM (
-                SELECT 
-                  COALESCE(NEW.id, lix_nano_id()) AS gen_id,
-                  COALESCE(
-                    NEW.commit_id,
-                    (
-                      SELECT commit_id FROM version 
-                      WHERE id = COALESCE(NEW.inherits_from_version_id, 'global')
-                      LIMIT 1
-                    )
-                  ) AS tip_cid
-            )
-            WHERE tip_cid IS NOT NULL;
-
-        END;
-
-        CREATE TRIGGER IF NOT EXISTS version_by_version_update
-        INSTEAD OF UPDATE ON version_by_version
-        BEGIN
-            -- Route descriptor updates via UPDATE (fields are coalesced from current values)
-            UPDATE state_by_version
-            SET 
-                file_id = 'lix',
-                plugin_key = 'lix_sdk',
-                snapshot_content = json_object(
-                    'id', NEW.id,
-                    'name', COALESCE(NEW.name, (SELECT name FROM version WHERE id = NEW.id)),
-                    'inherits_from_version_id', NEW.inherits_from_version_id,
-                    'hidden', COALESCE(NEW.hidden, (SELECT hidden FROM version WHERE id = NEW.id))
-                ),
-                schema_version = '1.0',
-                version_id = COALESCE(NEW.lixcol_version_id, 'global')
-            WHERE entity_id = NEW.id
-              AND schema_key = 'lix_version_descriptor'
-              AND file_id = 'lix'
-              AND version_id = COALESCE(NEW.lixcol_version_id, 'global');
-
-            -- If a new commit_id is provided, update the tip pointer for the scoped version id
-            UPDATE state_by_version
-            SET 
-                file_id = 'lix',
-                plugin_key = 'lix_sdk',
-                snapshot_content = json_object(
-                    'id', NEW.id,
-                    'commit_id', NEW.commit_id,
-                    'working_commit_id', COALESCE(
-                        NEW.working_commit_id,
-                        (SELECT working_commit_id FROM version WHERE id = NEW.id)
-                    )
-                ),
-                schema_version = '1.0',
-                version_id = COALESCE(NEW.lixcol_version_id, 'global')
-            WHERE NEW.commit_id IS NOT NULL
-              AND NEW.commit_id <> (SELECT commit_id FROM version WHERE id = NEW.id)
-              AND entity_id = NEW.id
-              AND schema_key = 'lix_version_tip'
-              AND file_id = 'lix'
-              AND version_id = COALESCE(NEW.lixcol_version_id, 'global');
-
-        END;
-
-        CREATE TRIGGER IF NOT EXISTS version_by_version_delete
-        INSTEAD OF DELETE ON version_by_version
-        BEGIN
-            -- Route deletes via state_by_version (vtable handles tombstones)
-            DELETE FROM state_by_version
-            WHERE entity_id = OLD.id
-              AND schema_key = 'lix_version_descriptor'
-              AND file_id = 'lix'
-              AND version_id = COALESCE(OLD.lixcol_version_id, 'global');
-
-            DELETE FROM state_by_version
-            WHERE entity_id = OLD.id
-              AND schema_key = 'lix_version_tip'
-              AND file_id = 'lix'
-              AND version_id = COALESCE(OLD.lixcol_version_id, 'global');
-        END;
-    `);
-
-	// This is a fallback for SQLite subquery's that run
-	// as part of a DML trigger and are not (yet) preprocessed
-	// in the lix engine. The view purposefully bypasses the vtable
-	// to let SQLite's query planner optimize the query.
-	args.engine.sqlite.exec(`
-		CREATE VIEW IF NOT EXISTS active_version AS
-		SELECT
-			json_extract(snapshot_content, '$.version_id') AS version_id
-		FROM lix_internal_state_all_untracked
-		WHERE schema_key = 'lix_active_version' AND version_id = 'global';
-
-		CREATE TRIGGER IF NOT EXISTS active_version_update
-		INSTEAD OF UPDATE ON active_version
-		BEGIN
-			SELECT
-				CASE
-					WHEN NOT EXISTS (
-						SELECT 1
-						FROM state_by_version
-						WHERE schema_key = 'lix_version_descriptor'
-						  AND version_id = 'global'
-						  AND json_extract(snapshot_content, '$.id') = NEW.version_id
-					)
-					THEN RAISE(ABORT, 'Foreign key constraint violation: active_version.version_id')
-				END;
-
-			UPDATE lix_internal_state_all_untracked
-			SET
-				snapshot_content = jsonb(json_object('id', entity_id, 'version_id', NEW.version_id)),
-				schema_version = '${LixActiveVersionSchema["x-lix-version"]}',
-				updated_at = lix_timestamp(),
-				inherited_from_version_id = NULL,
-				is_tombstone = 0,
-				file_id = 'lix',
-				plugin_key = 'lix_sdk'
-			WHERE schema_key = 'lix_active_version'
-			  AND version_id = 'global';
-
-			INSERT INTO lix_internal_state_all_untracked (
-				entity_id,
-				schema_key,
-				file_id,
-				version_id,
-				plugin_key,
-				snapshot_content,
-				schema_version,
-				created_at,
-				updated_at,
-				inherited_from_version_id,
-				is_tombstone
-			)
-			SELECT
-				generated.new_id,
-				'lix_active_version',
-				'lix',
-				'global',
-				'lix_sdk',
-				jsonb(json_object('id', generated.new_id, 'version_id', NEW.version_id)),
-				'${LixActiveVersionSchema["x-lix-version"]}',
-				generated.new_created_at,
-				generated.new_created_at,
-				NULL,
-				0
-			FROM (
-				SELECT lix_nano_id() AS new_id, lix_timestamp() AS new_created_at
-			) AS generated
-			WHERE NOT EXISTS (
-				SELECT 1
-				FROM lix_internal_state_all_untracked
-				WHERE schema_key = 'lix_active_version' AND version_id = 'global'
-			);
-		END;
-	`);
-}
-
-// Logical schema for merged version view (typing + JSON column mapping)
-// Note: merged 'version' is a view, not a writable schema entity
-
-// Pure business logic type for merged version view

package/src/version/select-active-version.ts

@@ -1,18 +0,0 @@
-import type { SelectQueryBuilder } from "kysely";
-import type { LixDatabaseSchema } from "../database/schema.js";
-import type { Lix } from "../lix/open-lix.js";
-import type { State } from "../engine/entity-views/types.js";
-import type { LixVersion } from "./schema-definition.js";
-
-export function selectActiveVersion(
-	lix: Lix
-): SelectQueryBuilder<
-	LixDatabaseSchema,
-	"version" | "active_version",
-	State<LixVersion>
-> {
-	return lix.db
-		.selectFrom("active_version")
-		.innerJoin("version", "active_version.version_id", "version.id")
-		.selectAll("version");
-}

package/src/version/select-version-diff.bench.ts

@@ -1,145 +0,0 @@
-import { bench } from "vitest";
-import { openLix } from "../lix/open-lix.js";
-import { createVersion } from "./create-version.js";
-import { selectVersionDiff } from "./select-version-diff.js";
-import type { LixSchemaDefinition } from "../schema-definition/definition.js";
-
-const COUNTS = {
-	created: 10,
-	updated: 10,
-	deleted: 10,
-} as const;
-
-type Ctx = {
-	lix: Awaited<ReturnType<typeof openLix>>;
-	sourceId: string;
-	targetId: string;
-};
-
-const readyCtx: Promise<Ctx> = (async () => {
-	const lix = await openLix({
-		keyValues: [
-			{
-				key: "lix_deterministic_mode",
-				value: { enabled: true },
-				lixcol_version_id: "global",
-			},
-		],
-	});
-
-	const BENCH_STORED_SCHEMA: LixSchemaDefinition = {
-		type: "object",
-		additionalProperties: false,
-		properties: {
-			v: { type: "string" },
-		},
-		required: ["v"],
-		"x-lix-key": "bench_diff_entity",
-		"x-lix-version": "1.0",
-	};
-
-	await lix.db
-		.insertInto("stored_schema")
-		.values({ value: BENCH_STORED_SCHEMA })
-		.execute();
-
-	const source = await createVersion({ lix, name: "bench_source" });
-	const target = await createVersion({ lix, name: "bench_target" });
-
-	// Seed created (only in source)
-	for (let i = 0; i < COUNTS.created; i++) {
-		await lix.db
-			.insertInto("state_by_version")
-			.values({
-				entity_id: `created_${i}`,
-				schema_key: "bench_diff_entity",
-				file_id: "bench_file",
-				version_id: source.id,
-				plugin_key: "bench_plugin",
-				snapshot_content: { v: `${i}` },
-				schema_version: "1.0",
-			})
-			.execute();
-	}
-
-	// Seed deleted (only in target)
-	for (let i = 0; i < COUNTS.deleted; i++) {
-		await lix.db
-			.insertInto("state_by_version")
-			.values({
-				entity_id: `deleted_${i}`,
-				schema_key: "bench_diff_entity",
-				file_id: "bench_file",
-				version_id: target.id,
-				plugin_key: "bench_plugin",
-				snapshot_content: { v: `${i}` },
-				schema_version: "1.0",
-			})
-			.execute();
-	}
-
-	// Seed updated (present in both, different change ids/content)
-	for (let i = 0; i < COUNTS.updated; i++) {
-		const id = `updated_${i}`;
-		// target first (older)
-		await lix.db
-			.insertInto("state_by_version")
-			.values({
-				entity_id: id,
-				schema_key: "bench_diff_entity",
-				file_id: "bench_file",
-				version_id: target.id,
-				plugin_key: "bench_plugin",
-				snapshot_content: { v: "old" },
-				schema_version: "1.0",
-			})
-			.execute();
-		// source later (newer)
-		await lix.db
-			.insertInto("state_by_version")
-			.values({
-				entity_id: id,
-				schema_key: "bench_diff_entity",
-				file_id: "bench_file",
-				version_id: source.id,
-				plugin_key: "bench_plugin",
-				snapshot_content: { v: "new" },
-				schema_version: "1.0",
-			})
-			.execute();
-	}
-
-	return { lix, sourceId: source.id, targetId: target.id } satisfies Ctx;
-})();
-
-bench("selectVersionDiff (exclude unchanged)", async () => {
-	try {
-		const { lix, sourceId, targetId } = await readyCtx;
-
-		const qb = selectVersionDiff({
-			lix,
-			source: { id: sourceId },
-			target: { id: targetId },
-		}).where("diff.status", "!=", "unchanged");
-
-		const rows = await qb.execute();
-		// Consume result to prevent dead-code elimination
-		if (!rows || rows.length === 0)
-			throw new Error("unexpected empty diff in bench");
-	} catch (error) {
-		console.error("Error during selectVersionDiff bench:", error);
-	}
-});
-
-bench("selectVersionDiff (full document diff)", async () => {
-	const { lix, sourceId, targetId } = await readyCtx;
-	const qb = selectVersionDiff({
-		lix,
-		source: { id: sourceId },
-		target: { id: targetId },
-	});
-
-	const rows = await qb.execute();
-	if (!rows || rows.length === 0)
-		throw new Error("unexpected empty diff in bench");
-});