@lix-js/sdk 0.0.1

package/README.md

@@ -0,0 +1,68 @@
+# Lix SDK
+
+> [!NOTE]  
+> Docs soon and release of the SDK coming soon.
+
+Lix is a change control system that runs in the browser and an SDK to build web apps.  
+
+A change control system allows storing, tracking, querying, and reviewing changes in different file formats, e.g., `.xlsx`, `.sqlite`, or `.inlang`. Compared to a version control system, a change control system understands “what” changed in a file, e.g., cell C43 in the financials spreadsheet changed. 
+
+## Community & Support
+
+**[🚩 Issues](https://github.com/opral/lix-sdk/issues)** - Bugs end errors you encounter using inlang.
+
+**[💬 Discussions](https://github.com/orgs/opral/discussions)** - Get help, ask questions, request features, and discuss inlang.
+
+**[🗣️ Discord](https://discord.gg/gdMPPWy57R)** - Hanging out with the community.
+
+
+## Example use cases
+
+Apps that revolve around changes are prime use cases to be built on lix. Having an “edit -> review -> automate” workflow is a good indicator for an app that revolves around changes:
+
+- document editors (markdown, PDF, etc.)
+- accounting solutions (auditing)
+- content creation tools (Figma, Adobe Premiere)
+- spreadsheets (Excel, Google Sheets)
+- CAD software (Fusion 360, Autodesk)
+- data science (Jupyter Notebooks)
+- dashboards (Analytics, Infrastructure) 
+
+## Lix as backend for web apps 
+
+Developing a web app with lix is reduced to providing a user interface that opens and saves a file.
+
+![Open a file, provide a UI, done](./assets/open_file.png)
+
+Backend features like auth, permissions, change control, and automations are solved on a file rather than an application-specific level. Lix knows who the actors are (auth), allows actors to conduct changes (permissions), is aware of how data changes over time (change history), can merge changes (collaboration), and uses the knowledge of changes to trigger automations (automation pipelines).
+
+![Backend features for files](./assets/backend_features_to_files.png)
+
+In contrast, cloud-based apps are substantially more difficult to build because they require:
+
+- Auth (could be solved with a backend as a service)
+- Integrations (no interop between apps)
+- Ensure data privacy and security
+- Scaling complexity of storing all customer data 
+- Replicating change control features like history, branching, etc.
+
+### Capabilities
+
+#### Interop
+
+Lix apps operate on (open) files. Any app can open the files and process the data. The need for integrations that transfer data from cloud app A to cloud app B is redundant. App 1 and app 2 can provide different UIs or services while operating on the same data. 
+
+![interop](./assets/interop.png)
+
+#### Collaboration via change proposals
+
+Lix brings versions and change requests, thereby enabling permissionless collaboration in file formats other than source code. We will see an “open-sourceification” of music, video, architecture, public policy making, fashion, and who knows, maybe even automobiles.  
+
+
+![permissionless collaboration](./assets/permissionless_collaboration.svg)
+
+#### Automation
+
+Lix can trigger automations based on changes in files. This is a powerful feature that allows for a new class of apps that are not possible with cloud-based apps.
+
+![automation](./assets/fm-automate.svg)

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

@@ -0,0 +1,7 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { Account } from "./database-schema.js";
+export declare function createAccount(args: {
+    lix: Lix;
+    name: string;
+}): Promise<Account>;
+//# sourceMappingURL=create-account.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-account.d.ts","sourceRoot":"","sources":["../../src/account/create-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,GAAG,CAAC;IACT,IAAI,EAAE,MAAM,CAAC;CACb,GAAG,OAAO,CAAC,OAAO,CAAC,CAmBnB"}

package/dist/account/create-account.js

@@ -0,0 +1,20 @@
+export async function createAccount(args) {
+    const executeInTransaction = async (trx) => {
+        const account = await trx
+            .insertInto("account")
+            .values({
+            name: args.name,
+        })
+            .returningAll()
+            .executeTakeFirstOrThrow();
+        return account;
+    };
+    // user provided an open transaction
+    if (args.lix.db.isTransaction) {
+        return executeInTransaction(args.lix.db);
+    }
+    else {
+        return args.lix.db.transaction().execute(executeInTransaction);
+    }
+}
+//# sourceMappingURL=create-account.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-account.js","sourceRoot":"","sources":["../../src/account/create-account.ts"],"names":[],"mappings":"AAGA,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAGnC;IACA,MAAM,oBAAoB,GAAG,KAAK,EAAE,GAAc,EAAE,EAAE;QACrD,MAAM,OAAO,GAAG,MAAM,GAAG;aACvB,UAAU,CAAC,SAAS,CAAC;aACrB,MAAM,CAAC;YACP,IAAI,EAAE,IAAI,CAAC,IAAI;SACf,CAAC;aACD,YAAY,EAAE;aACd,uBAAuB,EAAE,CAAC;QAE5B,OAAO,OAAO,CAAC;IAChB,CAAC,CAAC;IAEF,oCAAoC;IACpC,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC;QAC/B,OAAO,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChE,CAAC;AACF,CAAC"}

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

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

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

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

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

@@ -0,0 +1,22 @@
+import { test, expect } from "vitest";
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+import { createAccount } from "./create-account.js";
+test("should create an account", async () => {
+    const lix = await openLixInMemory({});
+    const accountName = "test_account";
+    const account = await createAccount({ lix, name: accountName });
+    // Verify the account was created
+    expect(account).toMatchObject({
+        name: accountName,
+    });
+    // Verify the account exists in the database
+    const dbAccount = await lix.db
+        .selectFrom("account")
+        .selectAll()
+        .where("id", "=", account.id)
+        .executeTakeFirstOrThrow();
+    expect(dbAccount).toMatchObject({
+        name: accountName,
+    });
+});
+//# sourceMappingURL=create-account.test.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"create-account.test.js","sourceRoot":"","sources":["../../src/account/create-account.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,IAAI,CAAC,0BAA0B,EAAE,KAAK,IAAI,EAAE;IAC3C,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;IAEtC,MAAM,WAAW,GAAG,cAAc,CAAC;IACnC,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,WAAW,EAAE,CAAC,CAAC;IAEhE,iCAAiC;IACjC,MAAM,CAAC,OAAO,CAAC,CAAC,aAAa,CAAC;QAC7B,IAAI,EAAE,WAAW;KACjB,CAAC,CAAC;IAEH,4CAA4C;IAC5C,MAAM,SAAS,GAAG,MAAM,GAAG,CAAC,EAAE;SAC5B,UAAU,CAAC,SAAS,CAAC;SACrB,SAAS,EAAE;SACX,KAAK,CAAC,IAAI,EAAE,GAAG,EAAE,OAAO,CAAC,EAAE,CAAC;SAC5B,uBAAuB,EAAE,CAAC;IAE5B,MAAM,CAAC,SAAS,CAAC,CAAC,aAAa,CAAC;QAC/B,IAAI,EAAE,WAAW;KACjB,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

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

@@ -0,0 +1,18 @@
+import type { Generated, Insertable, Selectable, Updateable } from "kysely";
+import type { SqliteDatabase } from "sqlite-wasm-kysely";
+export declare function applyAccountDatabaseSchema(sqlite: SqliteDatabase): SqliteDatabase;
+export type Account = Selectable<AccountTable>;
+export type NewAccount = Insertable<AccountTable>;
+export type AccountUpdate = Updateable<AccountTable>;
+export type AccountTable = {
+    id: Generated<string>;
+    name: string;
+};
+export type ActiveAccount = Selectable<ActiveAccountTable>;
+export type NewActiveAccount = Insertable<ActiveAccountTable>;
+export type ActiveAccountUpdate = Updateable<ActiveAccountTable>;
+export type ActiveAccountTable = {
+    id: string;
+    name: string;
+};
+//# sourceMappingURL=database-schema.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-schema.d.ts","sourceRoot":"","sources":["../../src/account/database-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAC5E,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGzD,wBAAgB,0BAA0B,CACzC,MAAM,EAAE,cAAc,GACpB,cAAc,CAmChB;AAED,MAAM,MAAM,OAAO,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;AAC/C,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;AAClD,MAAM,MAAM,aAAa,GAAG,UAAU,CAAC,YAAY,CAAC,CAAC;AACrD,MAAM,MAAM,YAAY,GAAG;IAC1B,EAAE,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;CACb,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,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACb,CAAC"}

package/dist/account/database-schema.js

@@ -0,0 +1,36 @@
+import { humanId } from "human-id";
+export function applyAccountDatabaseSchema(sqlite) {
+    const anonymousAccountName = `Anonymous ${humanId({
+        capitalize: true,
+        adjectiveCount: 0,
+        separator: "_",
+    })
+        // Human ID has two words, remove the last one
+        .split("_")[0]
+        // Human ID uses plural, remove the last character to make it singular
+        .slice(0, -1)}`;
+    const sql = `
+  CREATE TABLE IF NOT EXISTS account (
+    id TEXT PRIMARY KEY DEFAULT (uuid_v7()),
+    name TEXT NOT NULL
+  ) STRICT;
+
+  -- default anonymous account
+  -- INSERT OR IGNORE INTO account (id, name) 
+  -- VALUES ('anonymous', 'anonymous');
+
+  -- current account(s)
+  -- temp table because current accounts are session
+  -- specific and should not be persisted
+  CREATE TEMP TABLE IF NOT EXISTS active_account (
+    id TEXT PRIMARY KEY,
+    name TEXT NOT NULL
+    -- can't use foreign keys in temp tables... :(
+  ) STRICT;
+
+  -- default to the anonymous account
+  INSERT INTO active_account (id, name) values ('anonymous_' || uuid_v7(), '${anonymousAccountName}');
+`;
+    return sqlite.exec(sql);
+}
+//# sourceMappingURL=database-schema.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"database-schema.js","sourceRoot":"","sources":["../../src/account/database-schema.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,MAAM,UAAU,0BAA0B,CACzC,MAAsB;IAEtB,MAAM,oBAAoB,GAAG,aAAa,OAAO,CAAC;QACjD,UAAU,EAAE,IAAI;QAChB,cAAc,EAAE,CAAC;QACjB,SAAS,EAAE,GAAG;KACd,CAAC;QACD,8CAA8C;SAC7C,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAE;QACf,sEAAsE;SACrE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;IAEjB,MAAM,GAAG,GAAG;;;;;;;;;;;;;;;;;;;;8EAoBiE,oBAAoB;CACjG,CAAC;IAED,OAAO,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

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

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

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

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

package/dist/account/database-schema.test.js

@@ -0,0 +1,139 @@
+import { Kysely } from "kysely";
+import { contentFromDatabase, createDialect, createInMemoryDatabase, loadDatabaseInMemory, } from "sqlite-wasm-kysely";
+import { expect, test } from "vitest";
+import { applyAccountDatabaseSchema, } from "./database-schema.js";
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+test("account table should have no entry in the beginning and activte account should be an anonymous account", async () => {
+    const sqlite = await createInMemoryDatabase({
+        readOnly: false,
+    });
+    // the database has the propert definition for the uuid_v7 function
+    sqlite.createFunction("uuid_v7", {
+        arity: 0,
+        deterministic: true,
+        xFunc: () => "mock_uuid_v7",
+    });
+    applyAccountDatabaseSchema(sqlite);
+    const db = new Kysely({
+        dialect: createDialect({
+            database: sqlite,
+        }),
+    });
+    const account = await db
+        .selectFrom("account")
+        .selectAll()
+        .where("id", "=", "anonymous")
+        .execute();
+    expect(account?.length).toBe(0);
+    const active_account = await db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirst();
+    expect(active_account?.id).toBe("anonymous_mock_uuid_v7");
+});
+test("account.id should default to uuid_v7", async () => {
+    const sqlite = await createInMemoryDatabase({
+        readOnly: false,
+    });
+    // the database has the propert definition for the uuid_v7 function
+    sqlite.createFunction("uuid_v7", {
+        arity: 0,
+        deterministic: true,
+        xFunc: () => "mock_uuid_v7",
+    });
+    applyAccountDatabaseSchema(sqlite);
+    const db = new Kysely({
+        dialect: createDialect({
+            database: sqlite,
+        }),
+    });
+    const result = await db
+        .insertInto("account")
+        .values({
+        name: "test",
+    })
+        .returningAll()
+        .executeTakeFirstOrThrow();
+    expect(result.id).toBe("mock_uuid_v7");
+});
+test('it should drop the temp "current_account" table on reboot to not persist the current account', async () => {
+    const sqlite = await createInMemoryDatabase({
+        readOnly: false,
+    });
+    // the database has the propert definition for the uuid_v7 function
+    sqlite.createFunction("uuid_v7", {
+        arity: 0,
+        deterministic: true,
+        xFunc: () => "mock_uuid_v7",
+    });
+    applyAccountDatabaseSchema(sqlite);
+    const db = new Kysely({
+        dialect: createDialect({
+            database: sqlite,
+        }),
+    });
+    await db
+        .insertInto("account")
+        .values({
+        id: "test",
+        name: "test",
+    })
+        .execute();
+    await db.deleteFrom("active_account").execute();
+    await db
+        .insertInto("active_account")
+        .values({
+        id: "test",
+        name: "test",
+    })
+        .execute();
+    const currentAccount = await db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirst();
+    expect(currentAccount).toMatchObject({
+        id: "test",
+    });
+    const blob = contentFromDatabase(sqlite);
+    // re-open the database
+    const sqlite2 = await loadDatabaseInMemory(blob);
+    // the database has the propert definition for the uuid_v7 function
+    sqlite2.createFunction("uuid_v7", {
+        arity: 0,
+        deterministic: true,
+        xFunc: () => "mock_uuid_v7-2",
+    });
+    applyAccountDatabaseSchema(sqlite2);
+    const db2 = new Kysely({
+        dialect: createDialect({
+            database: sqlite2,
+        }),
+    });
+    const account2 = await db2
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirst();
+    expect(account2).toMatchObject({
+        id: "anonymous_mock_uuid_v7-2",
+    });
+});
+test("should generate different anonymous account names", async () => {
+    const lix0 = await openLixInMemory({});
+    const lix1 = await openLixInMemory({});
+    const lix2 = await openLixInMemory({});
+    const account0 = await lix0.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirst();
+    const account1 = await lix1.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirst();
+    const account2 = await lix2.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirst();
+    expect(account0?.name).not.toBe(account1?.name);
+    expect(account1?.name).not.toBe(account2?.name);
+});
+//# sourceMappingURL=database-schema.test.js.map

package/dist/account/database-schema.test.js.map

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

package/dist/account/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./database-schema.js";
+export { createAccount } from "./create-account.js";
+export { switchAccount } from "./switch-account.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/account/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/account/index.js

@@ -0,0 +1,4 @@
+export * from "./database-schema.js";
+export { createAccount } from "./create-account.js";
+export { switchAccount } from "./switch-account.js";
+//# sourceMappingURL=index.js.map

package/dist/account/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/account/index.ts"],"names":[],"mappings":"AAAA,cAAc,sBAAsB,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/account/switch-account.d.ts

@@ -0,0 +1,26 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { Account } from "./database-schema.js";
+/**
+ * Switch the current account to the provided account.
+ *
+ * @example
+ *
+ *   One active account
+ *
+ *   ```ts
+ *   await switchAccount({ lix, to: [otherAccount] });
+ *   ```
+ *
+ * @example
+ *
+ *   Multiple active accounts
+ *
+ *   ```ts
+ *   await switchAccount({ lix, to: [account1, account2] });
+ *   ```
+ */
+export declare function switchAccount(args: {
+    lix: Pick<Lix, "db">;
+    to: Account[];
+}): Promise<void>;
+//# sourceMappingURL=switch-account.d.ts.map

package/dist/account/switch-account.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-account.d.ts","sourceRoot":"","sources":["../../src/account/switch-account.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;IACrB,EAAE,EAAE,OAAO,EAAE,CAAC;CACd,GAAG,OAAO,CAAC,IAAI,CAAC,CAahB"}

package/dist/account/switch-account.js

@@ -0,0 +1,34 @@
+/**
+ * Switch the current account to the provided account.
+ *
+ * @example
+ *
+ *   One active account
+ *
+ *   ```ts
+ *   await switchAccount({ lix, to: [otherAccount] });
+ *   ```
+ *
+ * @example
+ *
+ *   Multiple active accounts
+ *
+ *   ```ts
+ *   await switchAccount({ lix, to: [account1, account2] });
+ *   ```
+ */
+export async function switchAccount(args) {
+    const executeInTransaction = async (trx) => {
+        // delete all rows from the current_account table
+        await trx.deleteFrom("active_account").execute();
+        // insert the new account id into the current_account table
+        await trx.insertInto("active_account").values(args.to).execute();
+    };
+    if (args.lix.db.isTransaction) {
+        return executeInTransaction(args.lix.db);
+    }
+    else {
+        return args.lix.db.transaction().execute(executeInTransaction);
+    }
+}
+//# sourceMappingURL=switch-account.js.map

package/dist/account/switch-account.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-account.js","sourceRoot":"","sources":["../../src/account/switch-account.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,IAGnC;IACA,MAAM,oBAAoB,GAAG,KAAK,EAAE,GAAc,EAAE,EAAE;QACrD,iDAAiD;QACjD,MAAM,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,OAAO,EAAE,CAAC;QACjD,2DAA2D;QAC3D,MAAM,GAAG,CAAC,UAAU,CAAC,gBAAgB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC;IAClE,CAAC,CAAC;IAEF,IAAI,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,aAAa,EAAE,CAAC;QAC/B,OAAO,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC1C,CAAC;SAAM,CAAC;QACP,OAAO,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC;IAChE,CAAC;AACF,CAAC"}

package/dist/account/switch-account.test.d.ts

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

package/dist/account/switch-account.test.d.ts.map

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

package/dist/account/switch-account.test.js

@@ -0,0 +1,48 @@
+import { test, expect } from "vitest";
+import { openLixInMemory } from "../lix/open-lix-in-memory.js";
+import { createAccount } from "./create-account.js";
+import { switchAccount } from "./switch-account.js";
+test("should switch the current account", async () => {
+    const lix = await openLixInMemory({});
+    // Create two accounts
+    const account1 = await createAccount({ lix, name: "account1" });
+    const account2 = await createAccount({ lix, name: "account2" });
+    // Switch to account1
+    await switchAccount({ lix, to: [account1] });
+    // Verify the current account is account1
+    let activeAccount = await lix.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(activeAccount.id).toBe(account1.id);
+    // Switch to account2
+    await switchAccount({ lix, to: [account2] });
+    // Verify the current account is account2
+    activeAccount = await lix.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(activeAccount.id).toBe(account2.id);
+});
+test("should handle switching to the same account", async () => {
+    const lix = await openLixInMemory({});
+    // Create an account
+    const account = await createAccount({ lix, name: "account" });
+    // Switch to the account
+    await switchAccount({ lix, to: [account] });
+    // Verify the current account is the created account
+    let activeAccount = await lix.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(activeAccount.id).toBe(account.id);
+    // Switch to the same account again
+    await switchAccount({ lix, to: [account] });
+    // Verify the current account is still the same account
+    activeAccount = await lix.db
+        .selectFrom("active_account")
+        .selectAll()
+        .executeTakeFirstOrThrow();
+    expect(activeAccount.id).toBe(account.id);
+});
+//# sourceMappingURL=switch-account.test.js.map

package/dist/account/switch-account.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"switch-account.test.js","sourceRoot":"","sources":["../../src/account/switch-account.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,IAAI,CAAC,mCAAmC,EAAE,KAAK,IAAI,EAAE;IACpD,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;IAEtC,sBAAsB;IACtB,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,CAAC;IAEhE,qBAAqB;IACrB,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE7C,yCAAyC;IACzC,IAAI,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAC9B,UAAU,CAAC,gBAAgB,CAAC;SAC5B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAE5B,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE3C,qBAAqB;IACrB,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAE7C,yCAAyC;IACzC,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAC1B,UAAU,CAAC,gBAAgB,CAAC;SAC5B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAE5B,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,6CAA6C,EAAE,KAAK,IAAI,EAAE;IAC9D,MAAM,GAAG,GAAG,MAAM,eAAe,CAAC,EAAE,CAAC,CAAC;IAEtC,oBAAoB;IACpB,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAE9D,wBAAwB;IACxB,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE5C,oDAAoD;IACpD,IAAI,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAC9B,UAAU,CAAC,gBAAgB,CAAC;SAC5B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAE5B,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE1C,mCAAmC;IACnC,MAAM,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;IAE5C,uDAAuD;IACvD,aAAa,GAAG,MAAM,GAAG,CAAC,EAAE;SAC1B,UAAU,CAAC,gBAAgB,CAAC;SAC5B,SAAS,EAAE;SACX,uBAAuB,EAAE,CAAC;IAE5B,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;AAC3C,CAAC,CAAC,CAAC"}

package/dist/change/apply-changes.d.ts

@@ -0,0 +1,25 @@
+import type { Change } from "../database/schema.js";
+import type { Lix } from "../lix/open-lix.js";
+/**
+ * Applies the given changes to the lix.
+ *
+ * Calls the `applyChanges` method of the corresponding plugin for each change.
+ * **Carefull**, the changes are not validated before applying them. It is up to
+ * the caller to ensure that the changes are valid. Usually, only the leaf changes
+ * of a given version should be applied.
+ *
+ * @example
+ *   ```ts
+ *   const changes = await lix.db.selectFrom("change")
+ *      .where(changeIsLeafInVersion(currentVersion))
+ *      .selectAll()
+ *      .execute();
+ *
+ *   await applyChanges({ lix, changes });
+ *   ```
+ */
+export declare function applyChanges(args: {
+    lix: Pick<Lix, "db" | "plugin">;
+    changes: Change[];
+}): Promise<void>;
+//# sourceMappingURL=apply-changes.d.ts.map

package/dist/change/apply-changes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply-changes.d.ts","sourceRoot":"","sources":["../../src/change/apply-changes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAG9C;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,YAAY,CAAC,IAAI,EAAE;IACxC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,GAAG,QAAQ,CAAC,CAAC;IAChC,OAAO,EAAE,MAAM,EAAE,CAAC;CAClB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuFhB"}

package/dist/change/apply-changes.js

@@ -0,0 +1,98 @@
+import { withSkipChangeQueue } from "../change-queue/with-skip-change-queue.js";
+import { applyOwnEntityChanges } from "../own-entity-change-control/apply-own-entity-change.js";
+/**
+ * Applies the given changes to the lix.
+ *
+ * Calls the `applyChanges` method of the corresponding plugin for each change.
+ * **Carefull**, the changes are not validated before applying them. It is up to
+ * the caller to ensure that the changes are valid. Usually, only the leaf changes
+ * of a given version should be applied.
+ *
+ * @example
+ *   ```ts
+ *   const changes = await lix.db.selectFrom("change")
+ *      .where(changeIsLeafInVersion(currentVersion))
+ *      .selectAll()
+ *      .execute();
+ *
+ *   await applyChanges({ lix, changes });
+ *   ```
+ */
+export async function applyChanges(args) {
+    const executeInTransaction = async (trx) => {
+        const groupByFile = Object.groupBy(args.changes, (change) => change.file_id);
+        // Lix own changes need to be applied first.
+        //
+        // Plugin changes depend on lix changes like the file
+        // data for example. Therefore, the lix changes need
+        // to be applied first.
+        const lixOwnChanges = groupByFile["null"] ?? [];
+        delete groupByFile["null"];
+        const plugins = await args.lix.plugin.getAll();
+        // TODO make detection of which plugin to use easier
+        // https://linear.app/opral/issue/LIXDK-104/add-detectedchangeschema
+        for (const [fileId, changes] of [
+            // applying lix own changes first
+            ["null", lixOwnChanges],
+            ...Object.entries(groupByFile),
+        ]) {
+            if (changes === undefined || changes.length === 0) {
+                continue;
+            }
+            // Skip own entity changes which have a file id 'null' and
+            // plugin key 'lix_own_entity' as they are not associated with a file
+            if (fileId === "null" && changes[0]?.plugin_key === "lix_own_entity") {
+                await applyOwnEntityChanges({ lix: { ...args.lix, db: trx }, changes });
+                continue;
+            }
+            const groupByPlugin = Object.groupBy(changes, (c) => c.plugin_key);
+            // Applying lix own changes first ensures that the file
+            // exists when querying the file here.
+            const file = await trx
+                .selectFrom("file")
+                .where("id", "=", fileId)
+                .selectAll()
+                .executeTakeFirst();
+            // lix own change control deleted the file
+            // no plugin needs to apply changes
+            if (file === undefined) {
+                continue;
+            }
+            else if (file.data.byteLength === 0) {
+                // @ts-expect-error - the plugin will handle undefined file.data
+                delete file.data;
+            }
+            for (const [pluginKey, changes] of Object.entries(groupByPlugin)) {
+                if (changes === undefined) {
+                    continue;
+                }
+                const plugin = plugins.find((plugin) => plugin.key === pluginKey);
+                if (!plugin) {
+                    throw new Error(`Plugin with key ${pluginKey} not found`);
+                }
+                else if (!plugin.applyChanges) {
+                    throw new Error(`Plugin with key ${pluginKey} does not support applying changes`);
+                }
+                const { fileData } = await plugin.applyChanges({
+                    lix: { ...args.lix, db: trx },
+                    file,
+                    changes,
+                });
+                await withSkipChangeQueue(trx, async (trx) => {
+                    await trx
+                        .updateTable("file")
+                        .set({ data: fileData })
+                        .where("id", "=", fileId)
+                        .execute();
+                });
+            }
+        }
+    };
+    if (args.lix.db.isTransaction) {
+        return executeInTransaction(args.lix.db);
+    }
+    else {
+        return args.lix.db.transaction().execute(executeInTransaction);
+    }
+}
+//# sourceMappingURL=apply-changes.js.map