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

package/dist/prototype/version-schema.js

@@ -0,0 +1,86 @@
+export function applyVersionSchema(sqlite) {
+    sqlite.exec(`
+  CREATE TABLE IF NOT EXISTS version_materialized (
+		id TEXT NOT NULL,
+    name TEXT,
+    change_set_id TEXT NOT NULL
+  ) STRICT;
+
+	CREATE VIEW IF NOT EXISTS version AS
+	SELECT
+		json_extract(vj, '$.id') AS id,
+		json_extract(vj, '$.name') AS name,
+		json_extract(vj, '$.change_set_id') AS change_set_id
+	FROM (
+		SELECT get_and_materialize_row('version', 'id', v.id) AS vj
+		FROM (
+			SELECT entity_id AS id
+			FROM change
+			WHERE schema_key = 'lix_version_table'
+				AND rowid IN (
+					SELECT MAX(rowid)
+					FROM change
+					WHERE schema_key = 'lix_version_table'
+					GROUP BY entity_id
+				)
+				AND snapshot_id != 'no-content'
+		) v
+	);
+
+  CREATE TRIGGER version_insert
+  INSTEAD OF INSERT ON version
+  BEGIN
+      INSERT INTO snapshot (content)
+      VALUES (json_object('name', NEW.name, 'change_set_id', NEW.change_set_id, 'id', COALESCE(NEW.id, uuid_v7())));
+
+      INSERT INTO change (entity_id, schema_key, snapshot_id, file_id, plugin_key)
+      VALUES (
+          (SELECT json_extract(content, '$.id') FROM snapshot ORDER BY rowid DESC LIMIT 1),
+          'lix_version_table',
+          (SELECT id FROM snapshot ORDER BY rowid DESC LIMIT 1),
+          'lix_own_change_control',
+          'lix_own_change_control'
+      );
+  END;
+
+  CREATE TRIGGER version_update
+  INSTEAD OF UPDATE ON version
+  BEGIN
+      INSERT INTO snapshot (content)
+      VALUES (json_object('name', NEW.name, 'change_set_id', NEW.change_set_id, 'id', COALESCE(NEW.id, uuid_v7())));
+
+      INSERT INTO change (entity_id, schema_key, snapshot_id, file_id, plugin_key)
+      VALUES (
+          OLD.id, 
+          'lix_version_table',
+          (SELECT id FROM snapshot ORDER BY rowid DESC LIMIT 1),
+          'lix_own_change_control',
+          'lix_own_change_control'
+      );
+  END;
+
+  CREATE TRIGGER version_delete
+  INSTEAD OF DELETE ON version
+  BEGIN
+      INSERT INTO change (entity_id, schema_key, snapshot_id, file_id, plugin_key)
+      VALUES (
+          OLD.id, 
+          'lix_version_table',
+          'no-content',
+          'lix_own_change_control',
+          'lix_own_change_control'
+      );
+  END;
+`);
+}
+export const VersionViewJsonSchema = {
+    $schema: "http://json-schema.org/draft-07/schema#",
+    type: "object",
+    properties: {
+        id: { type: "string" },
+        name: { type: "string" },
+        change_set_id: { type: "string" },
+    },
+    required: ["id", "name", "change_set_id"],
+};
+//# sourceMappingURL=version-schema.js.map

package/dist/prototype/version-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version-schema.js","sourceRoot":"","sources":["../../src/prototype/version-schema.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC5D,MAAM,CAAC,IAAI,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAwEZ,CAAC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG;IACpC,OAAO,EAAE,yCAAyC;IAClD,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACtB,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,aAAa,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACjC;IACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC;CAChC,CAAC"}

package/dist/prototype/version-schema.test.d.ts

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

package/dist/prototype/version-schema.test.d.ts.map

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

package/dist/prototype/version-schema.test.js

@@ -0,0 +1,114 @@
+import { expect, test } from "vitest";
+import { initPrototypeDb } from "./database-schema.js";
+test("insert, update, delete on the version view", async () => {
+    const db = await initPrototypeDb();
+    const initial = await db.selectFrom("version").selectAll().execute();
+    expect(initial).toHaveLength(0);
+    await db
+        .insertInto("version")
+        .values([
+        { id: "peter", name: "version0", change_set_id: "change_set_id_0" },
+        { id: "paul", name: "version1", change_set_id: "change_set_id_1" },
+    ])
+        .execute();
+    const viewAfterInsert = await db
+        .selectFrom("version")
+        .orderBy("name", "asc")
+        .selectAll()
+        .execute();
+    expect(viewAfterInsert).toMatchObject([
+        {
+            name: "version0",
+            change_set_id: "change_set_id_0",
+        },
+        {
+            name: "version1",
+            change_set_id: "change_set_id_1",
+        },
+    ]);
+    await db
+        .updateTable("version")
+        .where("name", "=", "version0")
+        .set({ change_set_id: "change_set_id_1" })
+        .execute();
+    const viewAfterUpdate = await db
+        .selectFrom("version")
+        .orderBy("name", "asc")
+        .selectAll()
+        .execute();
+    expect(viewAfterUpdate).toMatchObject([
+        {
+            name: "version0",
+            change_set_id: "change_set_id_1",
+        },
+        {
+            name: "version1",
+            change_set_id: "change_set_id_1",
+        },
+    ]);
+    await db.deleteFrom("version").where("name", "=", "version0").execute();
+    const viewAfterDelete = await db
+        .selectFrom("version")
+        .orderBy("name", "asc")
+        .selectAll()
+        .execute();
+    expect(viewAfterDelete).toMatchObject([
+        {
+            name: "version1",
+            change_set_id: "change_set_id_1",
+        },
+    ]);
+    const changes = await db
+        .selectFrom("change")
+        .innerJoin("snapshot", "snapshot.id", "change.snapshot_id")
+        .where("schema_key", "=", "lix_version_table")
+        .orderBy("change.created_at", "asc")
+        .selectAll("change")
+        .select("snapshot.content")
+        .execute();
+    expect(changes.map((change) => change.content)).toMatchObject([
+        // version 0's insert
+        {
+            name: "version0",
+            change_set_id: "change_set_id_0",
+        },
+        // version 0's insert
+        {
+            name: "version1",
+            change_set_id: "change_set_id_1",
+        },
+        {
+            // version 0's update
+            name: "version0",
+            change_set_id: "change_set_id_1",
+        },
+        // version 0's delete
+        null,
+    ]);
+});
+test("querying by id", async () => {
+    const db = await initPrototypeDb();
+    await db
+        .insertInto("version")
+        .values([
+        {
+            id: "version0",
+            name: "version0",
+            change_set_id: "change_set_id_0",
+        },
+        {
+            id: "version1",
+            name: "version1",
+            change_set_id: "change_set_id_1",
+        },
+    ])
+        .execute();
+    const versions = await db
+        .selectFrom("version")
+        .where("id", "=", "version0")
+        .select("id")
+        .execute();
+    expect(versions).toHaveLength(1);
+    expect(versions[0]?.id).toBe("version0");
+});
+//# sourceMappingURL=version-schema.test.js.map

package/dist/prototype/version-schema.test.js.map

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

package/dist/query-filter/change-conflict-in-version.d.ts

@@ -3,6 +3,8 @@ import type { Version, LixDatabaseSchema } from "../database/schema.js";
 /**
  * Filters if a conflict is in the given version.
  *
+ * @deprecated Conflicts will be re-modeled in a later version of lix.
+ *
  * @example
  *   ```ts
  *   const conflicts = await lix.db.selectFrom("change_conflict")

package/dist/query-filter/change-conflict-in-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-conflict-in-version.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-conflict-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,IAElE,IAAI,iBAAiB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,KACzD,iBAAiB,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAOnE"}
+{"version":3,"file":"change-conflict-in-version.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-conflict-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,QAE9D,iBAAiB,CAAC,iBAAiB,EAAE,iBAAiB,CAAC,KACzD,iBAAiB,CAAC,iBAAiB,EAAE,iBAAiB,EAAE,OAAO,CAAC,CAOnE"}

package/dist/query-filter/change-conflict-in-version.js

@@ -1,6 +1,8 @@
 /**
  * Filters if a conflict is in the given version.
  *
+ * @deprecated Conflicts will be re-modeled in a later version of lix.
+ *
  * @example
  *   ```ts
  *   const conflicts = await lix.db.selectFrom("change_conflict")

package/dist/query-filter/change-conflict-in-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"change-conflict-in-version.js","sourceRoot":"","sources":["../../src/query-filter/change-conflict-in-version.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;GAUG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA4B;IACnE,OAAO,CACN,EAA2D,EACQ,EAAE,CACrE,EAAE,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC3C,QAAQ;SACN,UAAU,CAAC,yBAAyB,CAAC;SACrC,MAAM,CAAC,oBAAoB,CAAC;SAC5B,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAC9D,CAAC;AACJ,CAAC"}
+{"version":3,"file":"change-conflict-in-version.js","sourceRoot":"","sources":["../../src/query-filter/change-conflict-in-version.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,uBAAuB,CAAC,OAA4B;IACnE,OAAO,CACN,EAA2D,EACQ,EAAE,CACrE,EAAE,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC,QAAQ,EAAE,EAAE,CAC3C,QAAQ;SACN,UAAU,CAAC,yBAAyB,CAAC;SACrC,MAAM,CAAC,oBAAoB,CAAC;SAC5B,KAAK,CAAC,oCAAoC,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC,CAC9D,CAAC;AACJ,CAAC"}

package/dist/query-filter/change-in-version.d.ts

@@ -4,6 +4,8 @@ import type { SqlBool } from "kysely";
 /**
  * Filters if a change is in the given Version.
  *
+ * @deprecated Use `changeSetElementInAncestryOf` instead
+ *
  * @example
  *   ```ts
  *   const changes = await lix.db.selectFrom("change")

package/dist/query-filter/change-in-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-in-version.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAO,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAc1C,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CACxE"}
+{"version":3,"file":"change-in-version.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAO,MAAM,QAAQ,CAAC;AAChD,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AACxE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEtC;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAc1C,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CACxE"}

package/dist/query-filter/change-in-version.js

@@ -2,6 +2,8 @@ import { ExpressionWrapper, sql } from "kysely";
 /**
  * Filters if a change is in the given Version.
  *
+ * @deprecated Use `changeSetElementInAncestryOf` instead
+ *
  * @example
  *   ```ts
  *   const changes = await lix.db.selectFrom("change")

package/dist/query-filter/change-in-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"change-in-version.js","sourceRoot":"","sources":["../../src/query-filter/change-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIhD;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC3D,OAAO,GAAG,CAAA;;;;;6BAKkB,OAAO,CAAC,EAAE;;;;;;;;GAQkC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"change-in-version.js","sourceRoot":"","sources":["../../src/query-filter/change-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,GAAG,EAAE,MAAM,QAAQ,CAAC;AAIhD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,OAA4B;IAC3D,OAAO,GAAG,CAAA;;;;;6BAKkB,OAAO,CAAC,EAAE;;;;;;;;GAQkC,CAAC;AAC1E,CAAC"}

package/dist/query-filter/change-is-leaf-in-version.d.ts

@@ -3,6 +3,7 @@ import type { Version, LixDatabaseSchema } from "../database/schema.js";
 /**
  * Selects changes that are not a parent of any other change within the specified version.
  *
+ * @deprecated Use `changeSetElementIsLeafOf` instead
  *
  * @example
  *   ```ts

package/dist/query-filter/change-is-leaf-in-version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-is-leaf-in-version.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;GAWG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAmBhD,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CACxE"}
+{"version":3,"file":"change-is-leaf-in-version.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,KAAK,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AACnE,OAAO,KAAK,EAAE,OAAO,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAExE;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,GAmBhD,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CACxE"}

package/dist/query-filter/change-is-leaf-in-version.js

@@ -2,6 +2,7 @@ import { sql } from "kysely";
 /**
  * Selects changes that are not a parent of any other change within the specified version.
  *
+ * @deprecated Use `changeSetElementIsLeafOf` instead
  *
  * @example
  *   ```ts

package/dist/query-filter/change-is-leaf-in-version.js.map

@@ -1 +1 @@
-{"version":3,"file":"change-is-leaf-in-version.js","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwC,MAAM,QAAQ,CAAC;AAGnE;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IACjE,OAAO,GAAG,CAAA;;;;;6BAKkB,OAAO,CAAC,EAAE;;;;;;;;;;;;;GAakC,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"change-is-leaf-in-version.js","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-in-version.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAwC,MAAM,QAAQ,CAAC;AAGnE;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA4B;IACjE,OAAO,GAAG,CAAA;;;;;6BAKkB,OAAO,CAAC,EAAE;;;;;;;;;;;;;GAakC,CAAC;AAC1E,CAAC"}

package/dist/query-filter/change-is-leaf-of.d.ts

@@ -4,6 +4,8 @@ import type { Change } from "../database/schema.js";
 /**
  * Filter to select the last descendant of the specified change.
  *
+ * @deprecated Use `changeSetElementIsLeafOf` instead
+ *
  * @example
  *   Checking for the leaf of a change in all versiones.
  *

package/dist/query-filter/change-is-leaf-of.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"change-is-leaf-of.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAgBvC,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CACxE"}
+{"version":3,"file":"change-is-leaf-of.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAO,iBAAiB,EAAE,KAAK,OAAO,EAAE,MAAM,QAAQ,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,GAgBvC,iBAAiB,CAAC,iBAAiB,EAAE,QAAQ,EAAE,OAAO,CAAC,CACxE"}

package/dist/query-filter/change-is-leaf-of.js

@@ -2,6 +2,8 @@ import { sql, ExpressionWrapper } from "kysely";
 /**
  * Filter to select the last descendant of the specified change.
  *
+ * @deprecated Use `changeSetElementIsLeafOf` instead
+ *
  * @example
  *   Checking for the leaf of a change in all versiones.
  *

package/dist/query-filter/change-is-leaf-of.js.map

@@ -1 +1 @@
-{"version":3,"file":"change-is-leaf-of.js","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAgB,MAAM,QAAQ,CAAC;AAI9D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,UAAU,cAAc,CAAC,MAA0B;IACxD,OAAO,GAAG,CAAA;;;;;qBAKU,MAAM,CAAC,EAAE;;;;;;;;;;GAU2C,CAAC;AAC1E,CAAC"}
+{"version":3,"file":"change-is-leaf-of.js","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-of.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,iBAAiB,EAAgB,MAAM,QAAQ,CAAC;AAI9D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAAC,MAA0B;IACxD,OAAO,GAAG,CAAA;;;;;qBAKU,MAAM,CAAC,EAAE;;;;;;;;;;GAU2C,CAAC;AAC1E,CAAC"}

package/dist/query-filter/change-is-leaf-v2.d.ts

@@ -0,0 +1,69 @@
+import { type ExpressionBuilder, type ExpressionWrapper, type SqlBool } from "kysely";
+import type { LixDatabaseSchema } from "../database/schema.js";
+import type { ChangeSet } from "../change-set/database-schema.js";
+import type { GraphTraversalMode } from "../database/graph-traversal-mode.js";
+/**
+ * Filter to select leaf changes based on `change_set_edge` traversal.
+ *
+ * A "leaf" change is a change that belongs to a change set which is not overridden
+ * by any descendant change set for the same entity/file/schema.
+ *
+ * ⚠️ This requires the calling query to join:
+ * `.innerJoin("change_set_element", "change_set_element.change_id", "change.id")`
+ * `.innerJoin("change_set", "change_set.id", "change_set_element.change_set_id")`
+ *
+ * @param changeSet The root change set to begin traversal
+ * @param mode The graph traversal mode (default: full recursive)
+ */
+export declare function changeIsLeafV2(changeSet: Pick<ChangeSet, "id">, mode?: GraphTraversalMode): (eb: ExpressionBuilder<LixDatabaseSchema, "change_set">) => ExpressionWrapper<LixDatabaseSchema, "change_set", SqlBool>;
+/**
+ * Filters changes that are "leaf" changes in the selected change sets.
+ *
+ * A **leaf change** is one for which no **descendant change set**
+ * (via `change_set_edge`) contains a newer change that redefines the same
+ * `(entity_id, file_id, schema_key)`.
+ *
+ * This filter allows you to identify the most recent changes to entities
+ * across any connected group of change sets, based on their graph relationships.
+ *
+ * ---
+ *
+ * ✅ This filter is flexible and can be used with any set of change sets:
+ * - A single change set
+ * - A sequence of connected change sets
+ * - A graph of change sets with multiple concurrent end points
+ *
+ * ---
+ *
+ * ⚠️ This filter only filters which changes are leaves — it does **not**:
+ * - Deduplicate changes that affect the same entity
+ * - Resolve which version is preferred when multiple leaf changes exist
+ * - Define which change sets to include — that must be handled by the query
+ *
+ * ---
+ *
+ * ℹ️ Requirements:
+ * - The outer query must join `change_set_element` to resolve the `change → change_set_id` mapping
+ * - You are responsible for defining the scope of change sets using `.where(...)` or graph filters
+ *
+ * ---
+ * @example Get leaf changes from a list of change sets
+ * ```ts
+ * db.selectFrom("change")
+ *   .innerJoin("change_set_element", "change_set_element.change_id", "change.id")
+ *   .where("change_set_element.change_set_id", "in", [cs0.id, cs1.id, cs2.id])
+ *   .where(changeIsLeaf())
+ *   .selectAll()
+ * ```
+ *
+ * @example Get leaf changes from a recursive graph traversal
+ * ```ts
+ * db.selectFrom("change")
+ *   .innerJoin("change_set_element", "change_set_element.change_id", "change.id")
+ *   .where(changeSetIsAncestorOf(someChangeSet))
+ *   .where(changeIsLeaf())
+ *   .selectAll()
+ * ```
+ */
+export declare function changeIsLeafV3(): (eb: ExpressionBuilder<LixDatabaseSchema, "change_set_element">) => ExpressionWrapper<LixDatabaseSchema, "change_set_element", SqlBool>;
+//# sourceMappingURL=change-is-leaf-v2.d.ts.map

package/dist/query-filter/change-is-leaf-v2.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-is-leaf-v2.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EAEN,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,OAAO,EACZ,MAAM,QAAQ,CAAC;AAChB,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAC/D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kCAAkC,CAAC;AAClE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAE9E;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAC7B,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,EAChC,IAAI,CAAC,EAAE,kBAAkB,GACvB,CACF,EAAE,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,YAAY,CAAC,KAClD,iBAAiB,CAAC,iBAAiB,EAAE,YAAY,EAAE,OAAO,CAAC,CAsC/D;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,wBAAgB,cAAc,IAAI,CACjC,EAAE,EAAE,iBAAiB,CAAC,iBAAiB,EAAE,oBAAoB,CAAC,KAC1D,iBAAiB,CAAC,iBAAiB,EAAE,oBAAoB,EAAE,OAAO,CAAC,CAkBvE"}

package/dist/query-filter/change-is-leaf-v2.js

@@ -0,0 +1,116 @@
+import { sql, } from "kysely";
+/**
+ * Filter to select leaf changes based on `change_set_edge` traversal.
+ *
+ * A "leaf" change is a change that belongs to a change set which is not overridden
+ * by any descendant change set for the same entity/file/schema.
+ *
+ * ⚠️ This requires the calling query to join:
+ * `.innerJoin("change_set_element", "change_set_element.change_id", "change.id")`
+ * `.innerJoin("change_set", "change_set.id", "change_set_element.change_set_id")`
+ *
+ * @param changeSet The root change set to begin traversal
+ * @param mode The graph traversal mode (default: full recursive)
+ */
+export function changeIsLeafV2(changeSet, mode) {
+    const traversal = mode ?? { type: "recursive" };
+    if (traversal.type === "direct") {
+        return (eb) => eb("change_set.id", "=", changeSet.id);
+    }
+    const depthCondition = traversal.depth !== undefined
+        ? sql `WHERE ap.depth < ${sql.lit(traversal.depth)}`
+        : sql ``;
+    return () => sql `
+    NOT EXISTS (
+      SELECT 1
+      FROM change newer
+      JOIN change_set_element newer_cse ON newer.id = newer_cse.change_id
+      JOIN change_set_edge edge ON edge.parent_id = change_set.id
+      WHERE
+        edge.child_id = newer_cse.change_set_id
+        AND newer.entity_id = change.entity_id
+        AND newer.file_id = change.file_id
+        AND newer.schema_key = change.schema_key
+        AND newer.id != change.id
+        AND newer_cse.change_set_id IN (
+          WITH RECURSIVE ancestor_path(id, depth) AS (
+            SELECT id, 0 AS depth FROM change_set WHERE id = ${sql.lit(changeSet.id)}
+            UNION ALL
+            SELECT edge.parent_id, ap.depth + 1
+            FROM change_set_edge edge
+            JOIN ancestor_path ap ON edge.child_id = ap.id
+            ${depthCondition}
+          )
+          SELECT id FROM ancestor_path
+        )
+    )
+  `;
+}
+/**
+ * Filters changes that are "leaf" changes in the selected change sets.
+ *
+ * A **leaf change** is one for which no **descendant change set**
+ * (via `change_set_edge`) contains a newer change that redefines the same
+ * `(entity_id, file_id, schema_key)`.
+ *
+ * This filter allows you to identify the most recent changes to entities
+ * across any connected group of change sets, based on their graph relationships.
+ *
+ * ---
+ *
+ * ✅ This filter is flexible and can be used with any set of change sets:
+ * - A single change set
+ * - A sequence of connected change sets
+ * - A graph of change sets with multiple concurrent end points
+ *
+ * ---
+ *
+ * ⚠️ This filter only filters which changes are leaves — it does **not**:
+ * - Deduplicate changes that affect the same entity
+ * - Resolve which version is preferred when multiple leaf changes exist
+ * - Define which change sets to include — that must be handled by the query
+ *
+ * ---
+ *
+ * ℹ️ Requirements:
+ * - The outer query must join `change_set_element` to resolve the `change → change_set_id` mapping
+ * - You are responsible for defining the scope of change sets using `.where(...)` or graph filters
+ *
+ * ---
+ * @example Get leaf changes from a list of change sets
+ * ```ts
+ * db.selectFrom("change")
+ *   .innerJoin("change_set_element", "change_set_element.change_id", "change.id")
+ *   .where("change_set_element.change_set_id", "in", [cs0.id, cs1.id, cs2.id])
+ *   .where(changeIsLeaf())
+ *   .selectAll()
+ * ```
+ *
+ * @example Get leaf changes from a recursive graph traversal
+ * ```ts
+ * db.selectFrom("change")
+ *   .innerJoin("change_set_element", "change_set_element.change_id", "change.id")
+ *   .where(changeSetIsAncestorOf(someChangeSet))
+ *   .where(changeIsLeaf())
+ *   .selectAll()
+ * ```
+ */
+export function changeIsLeafV3() {
+    return () => sql `
+      NOT EXISTS (
+        SELECT 1
+        FROM change AS newer
+        INNER JOIN change_set_element AS newer_cse
+          ON newer_cse.change_id = newer.id
+        INNER JOIN change_set_edge
+          ON change_set_edge.child_id = newer_cse.change_set_id
+        WHERE
+          newer.entity_id = change.entity_id
+          AND newer.file_id = change.file_id
+          AND newer.schema_key = change.schema_key
+          AND newer.id != change.id
+          AND change_set_edge.parent_id = change_set_element.change_set_id
+      )
+    `;
+}
+//# sourceMappingURL=change-is-leaf-v2.js.map

package/dist/query-filter/change-is-leaf-v2.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-is-leaf-v2.js","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-v2.ts"],"names":[],"mappings":"AAAA,OAAO,EACN,GAAG,GAIH,MAAM,QAAQ,CAAC;AAKhB;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,cAAc,CAC7B,SAAgC,EAChC,IAAyB;IAIzB,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC;IAEhD,IAAI,SAAS,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACjC,OAAO,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,eAAe,EAAE,GAAG,EAAE,SAAS,CAAC,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,MAAM,cAAc,GACnB,SAAS,CAAC,KAAK,KAAK,SAAS;QAC5B,CAAC,CAAC,GAAG,CAAA,oBAAoB,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;QACnD,CAAC,CAAC,GAAG,CAAA,EAAE,CAAC;IAEV,OAAO,GAAG,EAAE,CACX,GAAG,CAAA;;;;;;;;;;;;;;+DAc0D,GAAG,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;;;;;cAKtE,cAAc;;;;;GAKiD,CAAC;AAC9E,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgDG;AACH,MAAM,UAAU,cAAc;IAG7B,OAAO,GAAG,EAAE,CACX,GAAG,CAAS;;;;;;;;;;;;;;;KAe6D,CAAC;AAC5E,CAAC"}

package/dist/query-filter/change-is-leaf-v2.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=change-is-leaf-v2.test.d.ts.map

package/dist/query-filter/change-is-leaf-v2.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"change-is-leaf-v2.test.d.ts","sourceRoot":"","sources":["../../src/query-filter/change-is-leaf-v2.test.ts"],"names":[],"mappings":""}