@lix-js/sdk 0.0.1

package/dist/file/validate-file-path.js

@@ -0,0 +1,44 @@
+/**
+ * Idea is to have a minimal spec that can be extended over time.
+ *
+ * Every valid file path must also be a valid RFC 3986 URI.
+ */
+/**
+ * Validates a file path.
+ *
+ * @throws {Error} If the file path is invalid.
+ */
+export function validateFilePath(path) {
+    // validate beginning
+    if (path.length === 0) {
+        throw new Error("File path must not be empty.");
+    }
+    if (path[0] !== "/") {
+        throw new Error("File path must start with a slash.\n\nNot starting a file path with a slash `/` leads to ambiguity whether or not the path is a directory or a file.");
+    }
+    // validate middle
+    // validate ending
+    if (path.endsWith("/")) {
+        throw new Error("File path must not end with a slash.\n\nEnding a file with a slash leads to ambiguity whether or not the path is a directory or a file.");
+    }
+    // validate general
+    if (path.includes("//")) {
+        throw new Error("File path must not contain consecutive slashes.\n\nConsecutive slashes lead to ambiguity whether or not the path is a directory or a file.");
+    }
+    if (path.includes("\\")) {
+        throw new Error("File path must not contain backslashes.\n\nThe restriction might be loosened in the future.");
+    }
+}
+/**
+ *
+ */
+export function isValidFilePath(path) {
+    try {
+        validateFilePath(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=validate-file-path.js.map

package/dist/file/validate-file-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-file-path.js","sourceRoot":"","sources":["../../src/file/validate-file-path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;GAIG;AACH,MAAM,UAAU,gBAAgB,CAAC,IAAY;IAC5C,qBAAqB;IAErB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;IACjD,CAAC;IAED,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,GAAG,EAAE,CAAC;QACrB,MAAM,IAAI,KAAK,CACd,sJAAsJ,CACtJ,CAAC;IACH,CAAC;IAED,kBAAkB;IAElB,kBAAkB;IAElB,IAAI,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;QACxB,MAAM,IAAI,KAAK,CACd,yIAAyI,CACzI,CAAC;IACH,CAAC;IAED,mBAAmB;IAEnB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,4IAA4I,CAC5I,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;QACzB,MAAM,IAAI,KAAK,CACd,6FAA6F,CAC7F,CAAC;IACH,CAAC;AACF,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY;IAC3C,IAAI,CAAC;QACJ,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,IAAI,CAAC;IACb,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}

package/dist/file/validate-file-path.test.d.ts

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

package/dist/file/validate-file-path.test.d.ts.map

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

package/dist/file/validate-file-path.test.js

@@ -0,0 +1,36 @@
+import { test, expect } from "vitest";
+import { isValidFilePath } from "./validate-file-path.js";
+test("valid cases", () => {
+    const validCases = [
+        "/path/to/file",
+        "/path/to/file/with/multiple/segments",
+        "/path/to/file.with.dots",
+        "/path/to/file-with-hyphens_and_underscores",
+        "/path/with-file-extension.txt",
+    ];
+    for (const validCase of validCases) {
+        expect(isValidFilePath(validCase)).toBe(true);
+        // testing for RFC 3986 URI
+        expect(URL.canParse(`file://${validCase}`)).toBe(true);
+    }
+});
+// invalid cases
+test("an empty path should be invalid", () => {
+    expect(isValidFilePath("")).toBe(false);
+});
+test("a path that contains only a slash should be invalid", () => {
+    expect(isValidFilePath("/")).toBe(false);
+});
+test("a path that does not start with a slash should be invalid", () => {
+    expect(isValidFilePath("path/to/file")).toBe(false);
+});
+test("a path that ends with a slash should be invalid", () => {
+    expect(isValidFilePath("/path/to/file/")).toBe(false);
+});
+test("a path that contains consecutive slashes should be invalid", () => {
+    expect(isValidFilePath("/path//to/file")).toBe(false);
+});
+test("a path that contains backslashes should be invalid", () => {
+    expect(isValidFilePath("/path\\to\\file")).toBe(false);
+});
+//# sourceMappingURL=validate-file-path.test.js.map

package/dist/file/validate-file-path.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-file-path.test.js","sourceRoot":"","sources":["../../src/file/validate-file-path.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAE1D,IAAI,CAAC,aAAa,EAAE,GAAG,EAAE;IACxB,MAAM,UAAU,GAAG;QAClB,eAAe;QACf,sCAAsC;QACtC,yBAAyB;QACzB,4CAA4C;QAC5C,+BAA+B;KAC/B,CAAC;IAEF,KAAK,MAAM,SAAS,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAC9C,2BAA2B;QAC3B,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC,UAAU,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxD,CAAC;AACF,CAAC,CAAC,CAAC;AAEH,gBAAgB;AAEhB,IAAI,CAAC,iCAAiC,EAAE,GAAG,EAAE;IAC5C,MAAM,CAAC,eAAe,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACzC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qDAAqD,EAAE,GAAG,EAAE;IAChE,MAAM,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2DAA2D,EAAE,GAAG,EAAE;IACtE,MAAM,CAAC,eAAe,CAAC,cAAc,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,iDAAiD,EAAE,GAAG,EAAE;IAC5D,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4DAA4D,EAAE,GAAG,EAAE;IACvE,MAAM,CAAC,eAAe,CAAC,gBAAgB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACvD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAC/D,MAAM,CAAC,eAAe,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,17 @@
+export * from "./account/index.js";
+export * from "./change/index.js";
+export * from "./change-set/index.js";
+export * from "./change-conflict/index.js";
+export * from "./change-queue/index.js";
+export * from "./change-schema/index.js";
+export * from "./database/index.js";
+export * from "./discussion/index.js";
+export * from "./file/index.js";
+export * from "./lix/index.js";
+export * from "./own-entity-change-control/index.js";
+export * from "./plugin/index.js";
+export * from "./query-filter/index.js";
+export * from "./server-api-handler/index.js";
+export * from "./snapshot/index.js";
+export * from "./version/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sCAAsC,CAAC;AACrD,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+export * from "./account/index.js";
+export * from "./change/index.js";
+export * from "./change-set/index.js";
+export * from "./change-conflict/index.js";
+export * from "./change-queue/index.js";
+export * from "./change-schema/index.js";
+export * from "./database/index.js";
+export * from "./discussion/index.js";
+export * from "./file/index.js";
+export * from "./lix/index.js";
+export * from "./own-entity-change-control/index.js";
+export * from "./plugin/index.js";
+export * from "./query-filter/index.js";
+export * from "./server-api-handler/index.js";
+export * from "./snapshot/index.js";
+export * from "./version/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC;AAClC,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,0BAA0B,CAAC;AACzC,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,iBAAiB,CAAC;AAChC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,sCAAsC,CAAC;AACrD,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC"}

package/dist/key-value/database-schema.d.ts

@@ -0,0 +1,33 @@
+import type { Insertable, Selectable, Updateable } from "kysely";
+import type { SqliteDatabase } from "sqlite-wasm-kysely";
+export declare function applyKeyValueDatabaseSchema(sqlite: SqliteDatabase): SqliteDatabase;
+export type KeyValue = Selectable<KeyValueTable>;
+export type NewKeyValue = Insertable<KeyValueTable>;
+export type KeyValueUpdate = Updateable<KeyValueTable>;
+export type KeyValueTable = {
+    /**
+     * The key of the key-value pair.
+     *
+     * Lix prefixes its keys with "lix-" to avoid conflicts with user-defined keys.
+     *
+     * @example
+     *   "namespace-cool-key"
+     */
+    key: KeyValueKeys;
+    /**
+     * The value of the key-value pair.
+     *
+     * Must be a string. A JSON is a string too ;)
+     *
+     * @example
+     *   "some value"
+     *   "{ "foo": "bar" }"
+     *
+     */
+    value: string;
+};
+type PredefinedKeys = "lix_id" | "lix_server_url" | "#lix_sync";
+type KeyType = string & {};
+type KeyValueKeys = PredefinedKeys | KeyType;
+export {};
+//# sourceMappingURL=database-schema.d.ts.map

package/dist/key-value/database-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-schema.d.ts","sourceRoot":"","sources":["../../src/key-value/database-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACjE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEzD,wBAAgB,2BAA2B,CAC1C,MAAM,EAAE,cAAc,GACpB,cAAc,CAgBhB;AAED,MAAM,MAAM,QAAQ,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACjD,MAAM,MAAM,WAAW,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACpD,MAAM,MAAM,cAAc,GAAG,UAAU,CAAC,aAAa,CAAC,CAAC;AACvD,MAAM,MAAM,aAAa,GAAG;IAC3B;;;;;;;OAOG;IACH,GAAG,EAAE,YAAY,CAAC;IAClB;;;;;;;;;OASG;IACH,KAAK,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,KAAK,cAAc,GAAG,QAAQ,GAAG,gBAAgB,GAAG,WAAW,CAAC;AAGhE,KAAK,OAAO,GAAG,MAAM,GAAG,EAAE,CAAC;AAC3B,KAAK,YAAY,GAAG,cAAc,GAAG,OAAO,CAAC"}

package/dist/key-value/database-schema.js

@@ -0,0 +1,18 @@
+export function applyKeyValueDatabaseSchema(sqlite) {
+    return sqlite.exec `
+	CREATE TABLE IF NOT EXISTS key_value (
+		key TEXT PRIMARY KEY,
+		value TEXT NOT NULL
+	) STRICT;
+
+	INSERT OR IGNORE INTO key_value (key, value)
+	VALUES ('lix_id', uuid_v4());
+
+	-- default value for lix sync to false
+	-- if not exist to remove conditional logic
+	-- if the key exists or not
+	INSERT OR IGNORE INTO key_value (key, value)
+	VALUES ('#lix_sync', 'false');
+`;
+}
+//# sourceMappingURL=database-schema.js.map

package/dist/key-value/database-schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-schema.js","sourceRoot":"","sources":["../../src/key-value/database-schema.ts"],"names":[],"mappings":"AAGA,MAAM,UAAU,2BAA2B,CAC1C,MAAsB;IAEtB,OAAO,MAAM,CAAC,IAAI,CAAA;;;;;;;;;;;;;;CAclB,CAAC;AACF,CAAC"}

package/dist/key-value/database-schema.test.d.ts

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

package/dist/key-value/database-schema.test.d.ts.map

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

package/dist/key-value/database-schema.test.js

@@ -0,0 +1,98 @@
+import { sql } from "kysely";
+import { expect, test } from "vitest";
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+import { validate as validateUuid } from "uuid";
+test("string values are accepted", async () => {
+    const lix = await openLixInMemory({});
+    const result = await lix.db
+        .insertInto("key_value")
+        .values({
+        key: "foo",
+        value: "bar",
+    })
+        .returningAll()
+        .execute();
+    expect(result).toMatchObject([
+        {
+            key: "foo",
+            value: "bar",
+        },
+    ]);
+});
+test("duplicate keys lead to an error", async () => {
+    const lix = await openLixInMemory({});
+    await lix.db
+        .insertInto("key_value")
+        .values({
+        key: "foo",
+        value: "bar",
+    })
+        .returningAll()
+        .execute();
+    expect(lix.db
+        .insertInto("key_value")
+        .values({
+        key: "foo",
+        value: "bar",
+    })
+        .returningAll()
+        .execute()).rejects.toThrowErrorMatchingInlineSnapshot(`[SQLite3Error: SQLITE_CONSTRAINT_PRIMARYKEY: sqlite3 result code 1555: UNIQUE constraint failed: key_value.key]`);
+});
+test("using json as value should work", async () => {
+    const lix = await openLixInMemory({});
+    await lix.db
+        .insertInto("key_value")
+        .values([
+        {
+            key: "foo",
+            value: JSON.stringify({
+                bar: "baz",
+                age: 42,
+                location: "Berlin",
+            }),
+        },
+    ])
+        .returningAll()
+        .execute();
+    const onlyOneProperty = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", "foo")
+        .select(sql `json_extract(value, '$.bar')`.as("bar"))
+        .executeTakeFirstOrThrow();
+    // The JSON parsing plugin needs improvements.
+    // not important for now
+    // const parsedAsJson = await db
+    // 	.selectFrom("key_value")
+    // 	.where("key", "=", "foo")
+    // 	.select(sql`json(value)`.as("value"))
+    // 	.executeTakeFirstOrThrow();
+    // expect(parsedAsJson).toMatchObject({
+    // 	value: {
+    // 		bar: "baz",
+    // 		age: 42,
+    // 		location: "Berlin",
+    // 	},
+    // });
+    expect(onlyOneProperty).toMatchObject({
+        bar: "baz",
+    });
+});
+test("it should default add a uuid lix_id if not exits", async () => {
+    const lix = await openLixInMemory({});
+    const result = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", "lix_id")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(validateUuid(result.value)).toBe(true);
+});
+test("default value for #lix_sync to reduce conditional logic (the key is always set)", async () => {
+    const lix = await openLixInMemory({});
+    const result = await lix.db
+        .selectFrom("key_value")
+        .where("key", "=", "#lix_sync")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(result.value).toBe("false");
+});
+//# sourceMappingURL=database-schema.test.js.map

package/dist/key-value/database-schema.test.js.map

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

package/dist/lix/index.d.ts

@@ -0,0 +1,4 @@
+export { type Lix, openLix } from "./open-lix.js";
+export { openLixInMemory } from "./open-lix-in-memory.js";
+export { newLixFile } from "./new-lix.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/lix/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,GAAG,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC"}

package/dist/lix/index.js

@@ -0,0 +1,7 @@
+export { openLix } from "./open-lix.js";
+export { openLixInMemory } from "./open-lix-in-memory.js";
+export { newLixFile } from "./new-lix.js";
+// not exporting merge for api stability milestone
+// will need an overhaul to be stable
+// export { merge } from "./merge.js";
+//# sourceMappingURL=index.js.map

package/dist/lix/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/lix/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,OAAO,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,kDAAkD;AAClD,qCAAqC;AACrC,sCAAsC"}

package/dist/lix/merge.d.ts

@@ -0,0 +1,9 @@
+import type { Lix } from "./open-lix.js";
+/**
+ * Combined the changes of the source lix into the target lix.
+ */
+export declare function merge(args: {
+    targetLix: Lix;
+    sourceLix: Lix;
+}): Promise<void>;
+//# sourceMappingURL=merge.d.ts.map

package/dist/lix/merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.d.ts","sourceRoot":"","sources":["../../src/lix/merge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAKzC;;GAEG;AACH,wBAAsB,KAAK,CAAC,IAAI,EAAE;IACjC,SAAS,EAAE,GAAG,CAAC;IACf,SAAS,EAAE,GAAG,CAAC;CAGf,GAAG,OAAO,CAAC,IAAI,CAAC,CAsOhB"}

package/dist/lix/merge.get-leaf-changes-only-in-source.d.ts

@@ -0,0 +1,15 @@
+import type { Change } from "../database/schema.js";
+import type { LixReadonly } from "../plugin/lix-plugin.js";
+/**
+ * Gets the leaf changes that only exist in the source lix.
+ *
+ * @example
+ *   source changes = [c1, s1 (child of c1), s2 (child of s1), s3 (child of s2)]
+ *   target changes = [c1, t1 (child of c1)]
+ *   leaf changes only in source = [s3]
+ */
+export declare function getLeafChangesOnlyInSource(args: {
+    sourceLix: LixReadonly;
+    targetLix: LixReadonly;
+}): Promise<Change[]>;
+//# sourceMappingURL=merge.get-leaf-changes-only-in-source.d.ts.map

package/dist/lix/merge.get-leaf-changes-only-in-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.get-leaf-changes-only-in-source.d.ts","sourceRoot":"","sources":["../../src/lix/merge.get-leaf-changes-only-in-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAE3D;;;;;;;GAOG;AAEH,wBAAsB,0BAA0B,CAAC,IAAI,EAAE;IACtD,SAAS,EAAE,WAAW,CAAC;IACvB,SAAS,EAAE,WAAW,CAAC;CACvB,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CA8BpB"}

package/dist/lix/merge.get-leaf-changes-only-in-source.js

@@ -0,0 +1,34 @@
+/**
+ * Gets the leaf changes that only exist in the source lix.
+ *
+ * @example
+ *   source changes = [c1, s1 (child of c1), s2 (child of s1), s3 (child of s2)]
+ *   target changes = [c1, t1 (child of c1)]
+ *   leaf changes only in source = [s3]
+ */
+// TODO optimize later to use a single sql query (attach mode)
+export async function getLeafChangesOnlyInSource(args) {
+    const result = [];
+    const leafChangesInSource = await args.sourceLix.db
+        .selectFrom("change")
+        .selectAll("change")
+        .where("change.id", "not in", args.sourceLix.db
+        .selectFrom("change")
+        .innerJoin("change_edge", "change_edge.child_id", "change.id")
+        .select("parent_id")
+        .where("parent_id", "is not", null)
+        .distinct())
+        .execute();
+    for (const change of leafChangesInSource) {
+        const changeExistsInTarget = await args.targetLix.db
+            .selectFrom("change")
+            .select("id")
+            .where("id", "=", change.id)
+            .executeTakeFirst();
+        if (!changeExistsInTarget) {
+            result.push(change);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=merge.get-leaf-changes-only-in-source.js.map

package/dist/lix/merge.get-leaf-changes-only-in-source.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.get-leaf-changes-only-in-source.js","sourceRoot":"","sources":["../../src/lix/merge.get-leaf-changes-only-in-source.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,8DAA8D;AAC9D,MAAM,CAAC,KAAK,UAAU,0BAA0B,CAAC,IAGhD;IACA,MAAM,MAAM,GAAa,EAAE,CAAC;IAE5B,MAAM,mBAAmB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE;SACjD,UAAU,CAAC,QAAQ,CAAC;SACpB,SAAS,CAAC,QAAQ,CAAC;SACnB,KAAK,CACL,WAAW,EACX,QAAQ,EACR,IAAI,CAAC,SAAS,CAAC,EAAE;SACf,UAAU,CAAC,QAAQ,CAAC;SACpB,SAAS,CAAC,aAAa,EAAE,sBAAsB,EAAE,WAAW,CAAC;SAC7D,MAAM,CAAC,WAAW,CAAC;SACnB,KAAK,CAAC,WAAW,EAAE,QAAQ,EAAE,IAAI,CAAC;SAClC,QAAQ,EAAE,CACZ;SACA,OAAO,EAAE,CAAC;IAEZ,KAAK,MAAM,MAAM,IAAI,mBAAmB,EAAE,CAAC;QAC1C,MAAM,oBAAoB,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,EAAE;aAClD,UAAU,CAAC,QAAQ,CAAC;aACpB,MAAM,CAAC,IAAI,CAAC;aACZ,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,CAAC;aAC3B,gBAAgB,EAAE,CAAC;QAErB,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC3B,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACrB,CAAC;IACF,CAAC;IACD,OAAO,MAAM,CAAC;AACf,CAAC"}

package/dist/lix/merge.get-leaf-changes-only-in-source.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=merge.get-leaf-changes-only-in-source.test.d.ts.map

package/dist/lix/merge.get-leaf-changes-only-in-source.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.get-leaf-changes-only-in-source.test.d.ts","sourceRoot":"","sources":["../../src/lix/merge.get-leaf-changes-only-in-source.test.ts"],"names":[],"mappings":""}

package/dist/lix/merge.get-leaf-changes-only-in-source.test.js

@@ -0,0 +1,121 @@
+import { test, expect } from "vitest";
+import { getLeafChangesOnlyInSource } from "./merge.get-leaf-changes-only-in-source.js";
+import { openLixInMemory } from "./open-lix-in-memory.js";
+import { newLixFile } from "./new-lix.js";
+import { mockJsonSnapshot } from "../snapshot/mock-json-snapshot.js";
+test("it should get the leaf changes that only exist in source", async () => {
+    const sourceLix = await openLixInMemory({
+        blob: await newLixFile(),
+    });
+    const targetLix = await openLixInMemory({
+        blob: await newLixFile(),
+    });
+    const commonSnapshots = [
+        mockJsonSnapshot({ id: "mock-id", color: "red" }),
+        mockJsonSnapshot({ id: "mock-id", color: "blue" }),
+    ];
+    const commonChanges = [
+        {
+            id: "c1",
+            file_id: "mock",
+            entity_id: "value1",
+            plugin_key: "mock",
+            schema_key: "mock",
+            snapshot_id: commonSnapshots[0].id,
+        },
+        {
+            id: "c2",
+            file_id: "mock",
+            entity_id: "value1",
+            plugin_key: "mock",
+            schema_key: "mock",
+            snapshot_id: commonSnapshots[1].id,
+        },
+    ];
+    const commonChangesEdges = [{ parent_id: "c1", child_id: "c2" }];
+    const snapshotsOnlyInSource = [
+        mockJsonSnapshot({ id: "mock-id", color: "pink" }),
+        mockJsonSnapshot({ id: "mock-id", color: "orange" }),
+        mockJsonSnapshot({ id: "mock-id", color: "yellow" }),
+    ];
+    const changesOnlyInSource = [
+        {
+            id: "s1",
+            file_id: "mock",
+            entity_id: "value1",
+            plugin_key: "mock",
+            schema_key: "mock",
+            snapshot_id: snapshotsOnlyInSource[0].id,
+        },
+        {
+            id: "s2",
+            entity_id: "value1",
+            file_id: "mock",
+            plugin_key: "mock",
+            schema_key: "mock",
+            snapshot_id: snapshotsOnlyInSource[1].id,
+        },
+        {
+            id: "s3",
+            entity_id: "value1",
+            file_id: "mock",
+            plugin_key: "mock",
+            schema_key: "mock",
+            snapshot_id: snapshotsOnlyInSource[2].id,
+        },
+    ];
+    const changesOnlyInSourceEdges = [
+        { parent_id: "s1", child_id: "s2" },
+        { parent_id: "s2", child_id: "s3" },
+    ];
+    const snapshotsOnlyInTarget = [
+        mockJsonSnapshot({ id: "mock-id", color: "black" }),
+    ];
+    const changesOnlyInTarget = [
+        {
+            id: "t1",
+            entity_id: "value1",
+            file_id: "mock",
+            plugin_key: "mock",
+            schema_key: "mock",
+            snapshot_id: snapshotsOnlyInTarget[0].id,
+        },
+    ];
+    const changesOnlyInTargetEdges = [{ parent_id: "c2", child_id: "t1" }];
+    await targetLix.db
+        .insertInto("snapshot")
+        .values([...commonSnapshots, ...snapshotsOnlyInTarget].map((s) => {
+        return { content: s.content };
+    }))
+        .execute();
+    await targetLix.db
+        .insertInto("change")
+        .values([...commonChanges, ...changesOnlyInTarget])
+        .execute();
+    await targetLix.db
+        .insertInto("change_edge")
+        .values([...commonChangesEdges, ...changesOnlyInTargetEdges])
+        .execute();
+    await sourceLix.db
+        .insertInto("snapshot")
+        .values([...commonSnapshots, ...snapshotsOnlyInSource].map((s) => {
+        return { content: s.content };
+    }))
+        .execute();
+    await sourceLix.db
+        .insertInto("change")
+        .values([...commonChanges, ...changesOnlyInSource])
+        .execute();
+    await sourceLix.db
+        .insertInto("change_edge")
+        .values([...commonChangesEdges, ...changesOnlyInSourceEdges])
+        .execute();
+    const result = await getLeafChangesOnlyInSource({
+        sourceLix: sourceLix,
+        targetLix: targetLix,
+    });
+    // only the last change in the source is expected,
+    // not s1 and s2 which are parents of s3
+    expect(result.map((c) => c.id)).toEqual(["s3"]);
+});
+//# sourceMappingURL=merge.get-leaf-changes-only-in-source.test.js.map

package/dist/lix/merge.get-leaf-changes-only-in-source.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"merge.get-leaf-changes-only-in-source.test.js","sourceRoot":"","sources":["../../src/lix/merge.get-leaf-changes-only-in-source.test.ts"],"names":[],"mappings":"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"}