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

package/dist/engine/entity-views/types.d.ts

@@ -1,309 +0,0 @@
-import type { EntityStateByVersionColumns } from "./entity-state-by-version.js";
-import type { EntityStateColumns } from "./entity-state.js";
-import type { StateEntityHistoryColumns } from "./entity-state-history.js";
-import type { Generated as KyselyGenerated } from "kysely";
-import type { LixGenerated, LixInsertable, LixUpdateable, LixSelectable } from "../../schema-definition/definition.js";
-/**
- * Check if a type has the LixGenerated brand
- */
-type IsLixGenerated<T> = T extends {
-    readonly __lixGenerated?: true;
-} ? true : false;
-/**
- * Extract the base type from LixGenerated<T>
- * Since LixGenerated<T> = T & { brand }, we need to extract T
- */
-type ExtractFromGenerated<T> = T extends LixGenerated<infer U> ? U : T;
-/**
- * Extract the select type from LixGenerated or return the type as-is
- */
-type SelectType<T> = ExtractFromGenerated<T>;
-/**
- * Convert our LixGenerated types to Kysely's Generated types.
- * This adapter is used at the database boundary.
- */
-export type ToKysely<T> = {
-    [K in keyof T]: IsLixGenerated<T[K]> extends true ? KyselyGenerated<SelectType<T[K]>> : T[K];
-};
-/**
- * View type for entities in the active version only.
- *
- * This type combines your entity properties with Lix operational columns
- * (file_id, timestamps, etc.) while preserving LixGenerated markers for
- * database schema compatibility.
- *
- * Use this type when defining database views that work with the current
- * active version only.
- *
- * @example
- * ```typescript
- * // Define a view type for key-value entities
- * type KeyValueView = EntityStateView<KeyValue>;
- *
- * // The resulting type includes both entity properties and operational columns
- * // { key: string, value: any, lixcol_file_id: LixGenerated<string>, ... }
- * ```
- */
-export type EntityStateView<T> = T & EntityStateColumns;
-/**
- * View type for entities across all versions.
- *
- * This type combines your entity properties with Lix operational columns
- * including the version_id, allowing you to query and manipulate entities
- * in specific versions.
- *
- * Use this type when defining database views that need to work across
- * multiple versions.
- *
- * @example
- * ```typescript
- * // Define a view type for key-value entities across versions
- * type KeyValueByVersionView = EntityStateByVersionView<KeyValue>;
- *
- * // Query entities in a specific version
- * await lix.db
- *   .selectFrom("key_value_by_version")
- *   .where("lixcol_version_id", "=", "v2")
- *   .selectAll()
- *   .execute();
- * ```
- */
-export type EntityStateByVersionView<T> = T & EntityStateByVersionColumns;
-/**
- * View type for entity history (read-only).
- *
- * This type combines your entity properties with historical tracking columns,
- * allowing you to see how entities evolved over time through different change sets.
- *
- * History views are read-only and include change tracking information like
- * change_id, change_set_id, and depth for blame functionality.
- *
- * @example
- * ```typescript
- * // Define a history view type for key-value entities
- * type KeyValueHistoryView = EntityStateHistoryView<KeyValue>;
- *
- * // Query entity state at a specific commit
- * await lix.db
- *   .selectFrom("key_value_history")
- *   .where("lixcol_commit_id", "=", commitId)
- *   .where("lixcol_depth", "=", 0)
- *   .selectAll()
- *   .execute();
- * ```
- */
-export type EntityStateHistoryView<T> = T & StateEntityHistoryColumns;
-/**
- * Type for querying entities from the active version.
- *
- * This type unwraps all LixGenerated markers, giving you the actual engine types
- * for entity properties and operational columns. Use this when working with
- * query results from the database or passing data to UI components.
- *
- * All properties are required and have their actual types (no LixGenerated wrappers).
- *
- * @example
- * ```typescript
- * // Use State type for UI components that display entity data
- * interface SettingsCardProps {
- *   setting: State<KeyValue>;
- * }
- *
- * function SettingsCard({ setting }: SettingsCardProps) {
- *   return (
- *     <div>
- *       <h3>{setting.key}</h3>
- *       <p>{setting.value}</p>
- *       <time>{setting.lixcol_updated_at}</time>
- *     </div>
- *   );
- * }
- *
- * // Query and pass to UI
- * const settings = await lix.db
- *   .selectFrom("key_value")
- *   .selectAll()
- *   .execute();
- *
- * settings.map(setting => <SettingsCard setting={setting} />);
- * ```
- */
-export type State<T> = LixSelectable<EntityStateView<T>>;
-/**
- * Type for querying entities across all versions.
- *
- * This type unwraps all LixGenerated markers and includes the version_id column,
- * allowing you to work with entities from any version in the database.
- *
- * All properties are required and have their actual types (no LixGenerated wrappers).
- *
- * @example
- * ```typescript
- * // Use StateByVersion for version comparison UI
- * interface VersionDiffProps {
- *   oldValue: StateByVersion<KeyValue>;
- *   newValue: StateByVersion<KeyValue>;
- * }
- *
- * function VersionDiff({ oldValue, newValue }: VersionDiffProps) {
- *   return (
- *     <div>
- *       <h4>{oldValue.key}</h4>
- *       <div>Version {oldValue.lixcol_version_id}: {oldValue.value}</div>
- *       <div>Version {newValue.lixcol_version_id}: {newValue.value}</div>
- *     </div>
- *   );
- * }
- * ```
- */
-export type StateByVersion<T> = LixSelectable<EntityStateByVersionView<T>>;
-/**
- * Type for querying entity history.
- *
- * This type unwraps all LixGenerated markers and includes historical tracking
- * columns like change_id, change_set_id, and depth. Use this for blame
- * functionality and understanding how entities evolved.
- *
- * History queries are read-only.
- *
- * @example
- * ```typescript
- * // Use StateHistory for blame UI
- * interface BlameViewProps {
- *   history: StateHistory<KeyValue>[];
- * }
- *
- * function BlameView({ history }: BlameViewProps) {
- *   return (
- *     <ul>
- *       {history.map(state => (
- *         <li key={state.lixcol_change_id}>
- *           <strong>Depth {state.lixcol_depth}:</strong> {state.value}
- *           <br />
- *           <small>Change: {state.lixcol_change_id}</small>
- *         </li>
- *       ))}
- *     </ul>
- *   );
- * }
- * ```
- */
-export type StateHistory<T> = LixSelectable<EntityStateHistoryView<T>>;
-/**
- * Type for creating new entities in the active version.
- *
- * This type makes all LixGenerated columns optional (like id, timestamps),
- * while keeping other required fields mandatory. The database will
- * automatically populate generated fields if not provided.
- *
- * @example
- * ```typescript
- * // Use NewState for form data types
- * interface SettingsFormData {
- *   setting: NewState<KeyValue>;
- * }
- *
- * async function createSetting(formData: SettingsFormData) {
- *   // Only key and value are required
- *   const newSetting: NewState<KeyValue> = {
- *     key: formData.setting.key,
- *     value: formData.setting.value
- *     // lixcol_created_at, lixcol_file_id etc. are auto-generated
- *   };
- *
- *   await lix.db
- *     .insertInto("key_value")
- *     .values(newSetting)
- *     .execute();
- * }
- * ```
- */
-export type NewState<T> = LixInsertable<EntityStateView<T>>;
-/**
- * Type for updating entities in the active version.
- *
- * This type makes all columns optional, allowing partial updates.
- * Only include the fields you want to change - the database will
- * preserve existing values for omitted fields.
- *
- * @example
- * ```typescript
- * // Use StateUpdate for update form data
- * interface UpdateSettingData {
- *   updates: StateUpdate<KeyValue>;
- * }
- *
- * async function updateSetting(key: string, updates: UpdateSettingData) {
- *   // Only update the fields that changed
- *   const patch: StateUpdate<KeyValue> = {
- *     value: updates.updates.value
- *     // key, timestamps, etc. remain unchanged
- *   };
- *
- *   await lix.db
- *     .updateTable("key_value")
- *     .set(patch)
- *     .where("key", "=", key)
- *     .execute();
- * }
- * ```
- */
-export type StateUpdate<T> = LixUpdateable<EntityStateView<T>>;
-/**
- * Type for creating new entities with version control.
- *
- * This type includes lixcol_version_id for creating entities in specific
- * versions. Like NewState, it makes LixGenerated columns optional.
- *
- * @example
- * ```typescript
- * // Use NewStateByVersion for version-specific creation
- * async function createFeatureFlag(versionId: string, flag: {
- *   key: string;
- *   value: boolean;
- * }) {
- *   const newFlag: NewStateByVersion<KeyValue> = {
- *     key: flag.key,
- *     value: flag.value,
- *     lixcol_version_id: versionId  // Create in specific version
- *   };
- *
- *   await lix.db
- *     .insertInto("key_value_by_version")
- *     .values(newFlag)
- *     .execute();
- * }
- * ```
- */
-export type NewStateByVersion<T> = LixInsertable<EntityStateByVersionView<T>>;
-/**
- * Type for updating entities in specific versions.
- *
- * This type makes all columns optional for partial updates and includes
- * version control. You can update entities in any version or change
- * an entity's version.
- *
- * @example
- * ```typescript
- * // Use StateByVersionUpdate for version-specific updates
- * async function toggleFeatureFlag(
- *   key: string,
- *   versionId: string,
- *   enabled: boolean
- * ) {
- *   const updates: StateByVersionUpdate<KeyValue> = {
- *     value: enabled
- *   };
- *
- *   await lix.db
- *     .updateTable("key_value_by_version")
- *     .set(updates)
- *     .where("key", "=", key)
- *     .where("lixcol_version_id", "=", versionId)
- *     .execute();
- * }
- * ```
- */
-export type StateByVersionUpdate<T> = LixUpdateable<EntityStateByVersionView<T>>;
-export {};
-//# sourceMappingURL=types.d.ts.map

package/dist/engine/entity-views/types.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/engine/entity-views/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,8BAA8B,CAAC;AAChF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAC5D,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AAC3E,OAAO,KAAK,EAAE,SAAS,IAAI,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC3D,OAAO,KAAK,EACX,YAAY,EACZ,aAAa,EACb,aAAa,EACb,aAAa,EACb,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,GAClE,IAAI,GACJ,KAAK,CAAC;AAET;;;GAGG;AACH,KAAK,oBAAoB,CAAC,CAAC,IAAI,CAAC,SAAS,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAEvE;;GAEG;AACH,KAAK,UAAU,CAAC,CAAC,IAAI,oBAAoB,CAAC,CAAC,CAAC,CAAC;AAE7C;;;GAGG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,GAAG,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,GAC9C,eAAe,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GACjC,CAAC,CAAC,CAAC,CAAC;CACP,CAAC;AAEF;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,wBAAwB,CAAC,CAAC,IAAI,CAAC,GAAG,2BAA2B,CAAC;AAE1E;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,aAAa,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvE;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/D;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,MAAM,iBAAiB,CAAC,CAAC,IAAI,aAAa,CAAC,wBAAwB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE9E;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAM,MAAM,oBAAoB,CAAC,CAAC,IAAI,aAAa,CAClD,wBAAwB,CAAC,CAAC,CAAC,CAC3B,CAAC"}

package/dist/engine/entity-views/types.js

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=types.js.map

package/dist/engine/entity-views/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/engine/entity-views/types.ts"],"names":[],"mappings":""}

package/dist/engine/entity-views/types.test.d.ts

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

package/dist/engine/entity-views/types.test.d.ts.map

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

package/dist/engine/entity-views/types.test.js

@@ -1,62 +0,0 @@
-/* eslint-disable @typescript-eslint/no-unused-vars */
-import { test } from "vitest";
-test("ToKysely converts LixGenerated to Kysely Generated", () => {
-    // Verify the conversion is correct by creating a type-compatible object
-    const kyselyTable = {
-        id: {},
-        name: "test",
-        count: {},
-        metadata: { foo: "bar" },
-        optional: null,
-    };
-    // These should work
-    const id = {};
-    const name = "test";
-    const count = {};
-    const metadata = { foo: "test" };
-    const optional1 = "value";
-    const optional2 = null;
-    const optional3 = undefined;
-});
-test("LixDefault markers work with NewState", () => {
-    // Define a mock schema with x-lix-default
-    const MockEntitySchema = {
-        "x-lix-key": "mock_entity",
-        "x-lix-version": "1.0",
-        "x-lix-primary-key": ["/id"],
-        type: "object",
-        properties: {
-            id: { type: "string", "x-lix-default": "lix_nano_id()" },
-            name: { type: "string" },
-            count: { type: "number", "x-lix-default": "0" },
-            optional_field: { type: "string", nullable: true },
-        },
-        required: ["id", "name", "count"],
-        additionalProperties: false,
-    };
-    // Test that NewState makes generated fields optional
-    const newMockEntity = {
-        name: "test-name",
-        // id should be optional because it's LixGenerated
-        // count should be optional because it's LixGenerated
-        // optional_field should be optional because it's nullable
-    };
-    // Test that NewState also accepts generated fields when provided
-    const newMockEntityWithGenerated = {
-        id: "custom-id",
-        name: "test-name",
-        count: 42,
-        optional_field: "optional",
-    };
-    // Test that required non-generated fields are still required
-    // @ts-expect-error - name is required
-    const invalidNewMockEntity = {
-        count: 42,
-        // Missing required field 'name'
-    };
-    // Verify the types work as expected
-    void newMockEntity;
-    void newMockEntityWithGenerated;
-    void invalidNewMockEntity;
-});
-//# sourceMappingURL=types.test.js.map

package/dist/engine/entity-views/types.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.test.js","sourceRoot":"","sources":["../../../src/engine/entity-views/types.test.ts"],"names":[],"mappings":"AAAA,sDAAsD;AACtD,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAY9B,IAAI,CAAC,oDAAoD,EAAE,GAAG,EAAE;IAY/D,wEAAwE;IACxE,MAAM,WAAW,GAAkB;QAClC,EAAE,EAAE,EAA6B;QACjC,IAAI,EAAE,MAAM;QACZ,KAAK,EAAE,EAA6B;QACpC,QAAQ,EAAE,EAAE,GAAG,EAAE,KAAK,EAAE;QACxB,QAAQ,EAAE,IAAI;KACd,CAAC;IASF,oBAAoB;IACpB,MAAM,EAAE,GAAW,EAA6B,CAAC;IACjD,MAAM,IAAI,GAAa,MAAM,CAAC;IAC9B,MAAM,KAAK,GAAc,EAA6B,CAAC;IACvD,MAAM,QAAQ,GAAiB,EAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAC/C,MAAM,SAAS,GAAiB,OAAO,CAAC;IACxC,MAAM,SAAS,GAAiB,IAAI,CAAC;IACrC,MAAM,SAAS,GAAiB,SAAS,CAAC;AAC3C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,uCAAuC,EAAE,GAAG,EAAE;IAClD,0CAA0C;IAC1C,MAAM,gBAAgB,GAAG;QACxB,WAAW,EAAE,aAAa;QAC1B,eAAe,EAAE,KAAK;QACtB,mBAAmB,EAAE,CAAC,KAAK,CAAC;QAC5B,IAAI,EAAE,QAAQ;QACd,UAAU,EAAE;YACX,EAAE,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,eAAe,EAAE;YACxD,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACxB,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,eAAe,EAAE,GAAG,EAAE;YAC/C,cAAc,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,IAAI,EAAE;SAClD;QACD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC;QACjC,oBAAoB,EAAE,KAAK;KACY,CAAC;IAKzC,qDAAqD;IACrD,MAAM,aAAa,GAAyB;QAC3C,IAAI,EAAE,WAAW;QACjB,kDAAkD;QAClD,qDAAqD;QACrD,0DAA0D;KAC1D,CAAC;IAEF,iEAAiE;IACjE,MAAM,0BAA0B,GAAyB;QACxD,EAAE,EAAE,WAAW;QACf,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,EAAE;QACT,cAAc,EAAE,UAAU;KAC1B,CAAC;IAEF,6DAA6D;IAC7D,sCAAsC;IACtC,MAAM,oBAAoB,GAAyB;QAClD,KAAK,EAAE,EAAE;QACT,gCAAgC;KAChC,CAAC;IAEF,oCAAoC;IACpC,KAAK,aAAa,CAAC;IACnB,KAAK,0BAA0B,CAAC;IAChC,KAAK,oBAAoB,CAAC;AAC3B,CAAC,CAAC,CAAC"}

package/dist/engine/execute-sync.d.ts

@@ -1,5 +0,0 @@
-import type { LixEngine } from "./boot.js";
-export declare function createExecuteSync(args: {
-    engine: Pick<LixEngine, "sqlite" | "hooks" | "runtimeCacheRef" | "preprocessQuery">;
-}): LixEngine["executeSync"];
-//# sourceMappingURL=execute-sync.d.ts.map

package/dist/engine/execute-sync.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute-sync.d.ts","sourceRoot":"","sources":["../../src/engine/execute-sync.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAE3C,wBAAgB,iBAAiB,CAAC,IAAI,EAAE;IACvC,MAAM,EAAE,IAAI,CACX,SAAS,EACT,QAAQ,GAAG,OAAO,GAAG,iBAAiB,GAAG,iBAAiB,CAC1D,CAAC;CACF,GAAG,SAAS,CAAC,aAAa,CAAC,CAuC3B"}

package/dist/engine/execute-sync.js

@@ -1,38 +0,0 @@
-export function createExecuteSync(args) {
-    const executeSyncFn = (args2) => {
-        const mode = args2.preprocessMode ?? "full";
-        const preprocessed = mode === "none"
-            ? {
-                sql: args2.sql,
-                parameters: args2.parameters ?? [],
-            }
-            : args.engine.preprocessQuery({
-                sql: args2.sql,
-                parameters: args2.parameters ?? [],
-                mode,
-            });
-        const columnNames = [];
-        try {
-            const rows = args.engine.sqlite.exec({
-                sql: preprocessed.sql,
-                bind: preprocessed.parameters,
-                returnValue: "resultRows",
-                rowMode: "object",
-                columnNames,
-            });
-            return { rows };
-        }
-        catch (error) {
-            const enriched = error instanceof Error ? error : new Error(String(error));
-            const debugPayload = {
-                rewrittenSql: preprocessed.sql,
-                originalSql: args2.sql,
-                parameters: preprocessed.parameters,
-            };
-            Object.assign(enriched, debugPayload);
-            throw enriched;
-        }
-    };
-    return executeSyncFn;
-}
-//# sourceMappingURL=execute-sync.js.map

package/dist/engine/execute-sync.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"execute-sync.js","sourceRoot":"","sources":["../../src/engine/execute-sync.ts"],"names":[],"mappings":"AAEA,MAAM,UAAU,iBAAiB,CAAC,IAKjC;IACA,MAAM,aAAa,GAA6B,CAAC,KAAK,EAAE,EAAE;QACzD,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,IAAI,MAAM,CAAC;QAC5C,MAAM,YAAY,GACjB,IAAI,KAAK,MAAM;YACd,CAAC,CAAC;gBACA,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,UAAU,EAAG,KAAK,CAAC,UAAqC,IAAI,EAAE;aAC9D;YACF,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;gBAC5B,GAAG,EAAE,KAAK,CAAC,GAAG;gBACd,UAAU,EAAG,KAAK,CAAC,UAAqC,IAAI,EAAE;gBAC9D,IAAI;aACJ,CAAC,CAAC;QAEN,MAAM,WAAW,GAAa,EAAE,CAAC;QACjC,IAAI,CAAC;YACJ,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;gBACpC,GAAG,EAAE,YAAY,CAAC,GAAG;gBACrB,IAAI,EAAE,YAAY,CAAC,UAAmB;gBACtC,WAAW,EAAE,YAAY;gBACzB,OAAO,EAAE,QAAQ;gBACjB,WAAW;aACX,CAAC,CAAC;YACH,OAAO,EAAE,IAAI,EAAE,CAAC;QACjB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YAChB,MAAM,QAAQ,GACb,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3D,MAAM,YAAY,GAAG;gBACpB,YAAY,EAAE,YAAY,CAAC,GAAG;gBAC9B,WAAW,EAAE,KAAK,CAAC,GAAG;gBACtB,UAAU,EAAE,YAAY,CAAC,UAAU;aACnC,CAAC;YACF,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;YACtC,MAAM,QAAQ,CAAC;QAChB,CAAC;IACF,CAAC,CAAC;IAEF,OAAO,aAAa,CAAC;AACtB,CAAC"}

package/dist/engine/execute-sync.test.d.ts

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

package/dist/engine/execute-sync.test.d.ts.map

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

package/dist/engine/execute-sync.test.js

@@ -1,64 +0,0 @@
-import { describe, expect, test, vi } from "vitest";
-import { createExecuteSync } from "./execute-sync.js";
-describe("createExecuteSync", () => {
-    test("passes through bound parameters unchanged", async () => {
-        const exec = vi.fn().mockReturnValue([]);
-        const sqlite = { exec };
-        const preprocess = vi.fn(({ sql, parameters }) => ({
-            sql,
-            parameters,
-        }));
-        const executeSync = createExecuteSync({
-            engine: {
-                sqlite,
-                hooks: {},
-                runtimeCacheRef: {},
-                preprocessQuery: preprocess,
-            },
-        });
-        const parameters = [1, "two", { three: 3 }];
-        executeSync({ sql: "SELECT ?", parameters });
-        expect(preprocess).toHaveBeenCalledWith(expect.objectContaining({ sql: "SELECT ?", parameters, mode: "full" }));
-        expect(exec).toHaveBeenCalledWith(expect.objectContaining({ bind: parameters }));
-    });
-    test("passes preprocessing mode through when provided", async () => {
-        const exec = vi.fn().mockReturnValue([]);
-        const sqlite = { exec };
-        const preprocess = vi.fn(({ sql, parameters }) => ({
-            sql,
-            parameters,
-        }));
-        const executeSync = createExecuteSync({
-            engine: {
-                sqlite,
-                hooks: {},
-                runtimeCacheRef: {},
-                preprocessQuery: preprocess,
-            },
-        });
-        const sql = "SELECT 1";
-        const parameters = [];
-        executeSync({ sql, parameters, preprocessMode: "vtable-select-only" });
-        expect(preprocess).toHaveBeenCalledWith(expect.objectContaining({ sql, parameters, mode: "vtable-select-only" }));
-        expect(exec).toHaveBeenCalledWith(expect.objectContaining({ sql, bind: parameters }));
-    });
-    test("bypasses the preprocessor when specified", async () => {
-        const exec = vi.fn().mockReturnValue([]);
-        const sqlite = { exec };
-        const preprocess = vi.fn();
-        const executeSync = createExecuteSync({
-            engine: {
-                sqlite,
-                hooks: {},
-                runtimeCacheRef: {},
-                preprocessQuery: preprocess,
-            },
-        });
-        const sql = "SELECT 1";
-        const parameters = [];
-        executeSync({ sql, parameters, preprocessMode: "none" });
-        expect(preprocess).not.toHaveBeenCalled();
-        expect(exec).toHaveBeenCalledWith(expect.objectContaining({ sql, bind: parameters }));
-    });
-});
-//# sourceMappingURL=execute-sync.test.js.map

package/dist/engine/execute-sync.test.js.map

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

package/dist/engine/explain-query.d.ts

@@ -1,15 +0,0 @@
-import type { LixEngine } from "./boot.js";
-type ExplainQueryStage = {
-    originalSql: string;
-    parameters: unknown[];
-    rewrittenSql?: string;
-    plan: any[];
-};
-export declare function createExplainQuery(args: {
-    engine: Pick<LixEngine, "sqlite" | "hooks" | "runtimeCacheRef" | "preprocessQuery" | "executeSync">;
-}): (args: {
-    sql: string;
-    parameters: any[];
-}) => ExplainQueryStage;
-export {};
-//# sourceMappingURL=explain-query.d.ts.map

package/dist/engine/explain-query.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"explain-query.d.ts","sourceRoot":"","sources":["../../src/engine/explain-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AAS3C,KAAK,iBAAiB,GAAG;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,OAAO,EAAE,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,GAAG,EAAE,CAAC;CACZ,CAAC;AAEF,wBAAgB,kBAAkB,CAAC,IAAI,EAAE;IACxC,MAAM,EAAE,IAAI,CACX,SAAS,EACT,QAAQ,GAAG,OAAO,GAAG,iBAAiB,GAAG,iBAAiB,GAAG,aAAa,CAC1E,CAAC;CACF,GAAG,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,GAAG,EAAE,CAAA;CAAE,KAAK,iBAAiB,CAoClE"}

package/dist/engine/explain-query.js

@@ -1,66 +0,0 @@
-import { createSchemaCacheTable, schemaKeyToCacheTableName, } from "../state/cache/create-schema-cache-table.js";
-import { getStateCacheTables } from "../state/cache/schema.js";
-import { listAvailableCacheSchemas } from "../state/cache/schema-resolver.js";
-export function createExplainQuery(args) {
-    const preprocess = args.engine.preprocessQuery;
-    return ({ sql, parameters }) => {
-        const result = preprocess({
-            sql,
-            parameters,
-            // sideEffects removed false,
-        });
-        ensureCacheTablesForSql(args.engine, result.sql);
-        const trimmed = result.sql.trimStart();
-        const needsWrapper = trimmed.startsWith("(");
-        // Wrap the rewritten SQL in a trivial CTE only when we end up with a bare derived table.
-        // SQLite refuses to EXPLAIN `(…) AS alias`, but regular INSERT/UPDATE/SELECT statements
-        // should be explained as-is.
-        const explainTarget = needsWrapper
-            ? `WITH __lix_explain_target AS (${result.sql}) SELECT * FROM __lix_explain_target`
-            : result.sql;
-        const explainRows = args.engine.sqlite.exec({
-            sql: `EXPLAIN QUERY PLAN ${explainTarget}`,
-            bind: result.parameters,
-            returnValue: "resultRows",
-            rowMode: "object",
-            columnNames: [],
-        });
-        const wasRewritten = result.sql !== sql;
-        return {
-            originalSql: sql,
-            parameters,
-            rewrittenSql: wasRewritten ? result.sql : undefined,
-            plan: explainRows,
-        };
-    };
-}
-function ensureCacheTablesForSql(engine, sql) {
-    const matches = sql.matchAll(/lix_internal_state_cache_([A-Za-z0-9_]+)/g);
-    const tableCache = getStateCacheTables({ engine });
-    const availableSchemas = listAvailableCacheSchemas({ engine });
-    const tableToSchema = new Map();
-    for (const [schemaKey, definition] of availableSchemas.entries()) {
-        const tableName = schemaKeyToCacheTableName(schemaKey);
-        tableToSchema.set(tableName, definition);
-    }
-    for (const match of matches) {
-        const tableName = match[0];
-        if (!tableName)
-            continue;
-        if (tableCache.has(tableName))
-            continue;
-        const schemaDefinition = tableToSchema.get(tableName);
-        if (!schemaDefinition) {
-            continue;
-        }
-        const created = createSchemaCacheTable({
-            engine,
-            schema: schemaDefinition,
-        });
-        tableCache.add(created);
-        if (created !== tableName) {
-            tableCache.add(tableName);
-        }
-    }
-}
-//# sourceMappingURL=explain-query.js.map

package/dist/engine/explain-query.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"explain-query.js","sourceRoot":"","sources":["../../src/engine/explain-query.ts"],"names":[],"mappings":"AACA,OAAO,EACN,sBAAsB,EACtB,yBAAyB,GACzB,MAAM,6CAA6C,CAAC;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,yBAAyB,EAAE,MAAM,mCAAmC,CAAC;AAU9E,MAAM,UAAU,kBAAkB,CAAC,IAKlC;IACA,MAAM,UAAU,GAAG,IAAI,CAAC,MAAM,CAAC,eAAe,CAAC;IAE/C,OAAO,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,EAAE,EAAE;QAC9B,MAAM,MAAM,GAAG,UAAU,CAAC;YACzB,GAAG;YACH,UAAU;YACV,6BAA6B;SAC7B,CAAC,CAAC;QAEH,uBAAuB,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;QACjD,MAAM,OAAO,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC;QACvC,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC;QAC7C,yFAAyF;QACzF,wFAAwF;QACxF,6BAA6B;QAC7B,MAAM,aAAa,GAAG,YAAY;YACjC,CAAC,CAAC,iCAAiC,MAAM,CAAC,GAAG,sCAAsC;YACnF,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QACd,MAAM,WAAW,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC;YAC3C,GAAG,EAAE,sBAAsB,aAAa,EAAE;YAC1C,IAAI,EAAE,MAAM,CAAC,UAAmB;YAChC,WAAW,EAAE,YAAY;YACzB,OAAO,EAAE,QAAQ;YACjB,WAAW,EAAE,EAAE;SACf,CAAU,CAAC;QAEZ,MAAM,YAAY,GAAG,MAAM,CAAC,GAAG,KAAK,GAAG,CAAC;QAExC,OAAO;YACN,WAAW,EAAE,GAAG;YAChB,UAAU;YACV,YAAY,EAAE,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,SAAS;YACnD,IAAI,EAAE,WAAW;SACjB,CAAC;IACH,CAAC,CAAC;AACH,CAAC;AAED,SAAS,uBAAuB,CAC/B,MAAoE,EACpE,GAAW;IAEX,MAAM,OAAO,GAAG,GAAG,CAAC,QAAQ,CAAC,2CAA2C,CAAC,CAAC;IAC1E,MAAM,UAAU,GAAG,mBAAmB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IACnD,MAAM,gBAAgB,GAAG,yBAAyB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAC/D,MAAM,aAAa,GAAG,IAAI,GAAG,EAA+B,CAAC;IAC7D,KAAK,MAAM,CAAC,SAAS,EAAE,UAAU,CAAC,IAAI,gBAAgB,CAAC,OAAO,EAAE,EAAE,CAAC;QAClE,MAAM,SAAS,GAAG,yBAAyB,CAAC,SAAS,CAAC,CAAC;QACvD,aAAa,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;IAC1C,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC3B,IAAI,CAAC,SAAS;YAAE,SAAS;QACzB,IAAI,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,SAAS;QACxC,MAAM,gBAAgB,GAAG,aAAa,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACtD,IAAI,CAAC,gBAAgB,EAAE,CAAC;YACvB,SAAS;QACV,CAAC;QACD,MAAM,OAAO,GAAG,sBAAsB,CAAC;YACtC,MAAM;YACN,MAAM,EAAE,gBAAgB;SACxB,CAAC,CAAC;QACH,UAAU,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACxB,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YAC3B,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC3B,CAAC;IACF,CAAC;AACF,CAAC"}

package/dist/engine/explain-query.test.d.ts

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

package/dist/engine/explain-query.test.d.ts.map

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

package/dist/engine/explain-query.test.js

@@ -1,17 +0,0 @@
-import { expect, test } from "vitest";
-import { openLix } from "../lix/index.js";
-import { createExplainQuery } from "./explain-query.js";
-test("createExplainQuery returns rewritten when query is mutated", async () => {
-    const lix = await openLix({});
-    const engine = lix.engine;
-    const explain = createExplainQuery({ engine });
-    const query = {
-        sql: "SELECT * FROM lix_internal_state_vtable WHERE schema_key = 'mock_schema'",
-        parameters: [],
-    };
-    const report = explain(query);
-    expect(report.rewrittenSql).toBeDefined();
-    expect(report.rewrittenSql).not.toBe(report.originalSql);
-    await lix.close();
-});
-//# sourceMappingURL=explain-query.test.js.map

package/dist/engine/explain-query.test.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"explain-query.test.js","sourceRoot":"","sources":["../../src/engine/explain-query.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,OAAO,EAAE,MAAM,iBAAiB,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD,IAAI,CAAC,4DAA4D,EAAE,KAAK,IAAI,EAAE;IAC7E,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,EAAE,CAAC,CAAC;IAE9B,MAAM,MAAM,GAAG,GAAG,CAAC,MAAO,CAAC;IAC3B,MAAM,OAAO,GAAG,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE/C,MAAM,KAAK,GAAG;QACb,GAAG,EAAE,0EAA0E;QAC/E,UAAU,EAAE,EAAE;KACd,CAAC;IAEF,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAE9B,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAC1C,MAAM,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IACzD,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC;AACnB,CAAC,CAAC,CAAC"}