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

package/dist/entity-views/entity-view-builder.d.ts

@@ -0,0 +1,92 @@
+import type { Lix } from "../lix/open-lix.js";
+import type { FromLixSchemaDefinition, LixSchemaDefinition } from "../schema-definition/definition.js";
+import { type StateEntityView, type ValidationRule, type ValidationCallbacks } from "./entity-state.js";
+import { type StateEntityAllView } from "./entity-state-all.js";
+import { type StateEntityHistoryView } from "./entity-state-history.js";
+import type { EntityStateView, EntityStateAllView, EntityStateHistoryView, ToKysely } from "./types.js";
+export type { StateEntityView, StateEntityAllView, StateEntityHistoryView };
+export type { ValidationRule, ValidationCallbacks };
+/**
+ * Utility type that generates database schema view entries for an entity schema.
+ * Creates three views: normal (active version), all versions, and history.
+ *
+ * TSchema should be a LixSchemaDefinition (typeof SomeSchema).
+ * TOverride allows you to provide partial type overrides for specific properties.
+ *
+ * @example
+ * ```typescript
+ * // Basic usage with schema definition
+ * type LogViews = EntityViews<typeof LixLogSchema, "log">;
+ *
+ * // With partial property override
+ * type ThreadCommentViews = EntityViews<
+ *   typeof LixThreadCommentSchema,
+ *   "thread_comment",
+ *   { body: ZettelDoc }
+ * >;
+ * ```
+ */
+export type EntityViews<TSchema extends LixSchemaDefinition, TViewName extends string, TOverride = object> = {
+    [K in TViewName]: ToKysely<EntityStateView<FromLixSchemaDefinition<TSchema> & TOverride>>;
+} & {
+    [K in `${TViewName}_all`]: ToKysely<EntityStateAllView<FromLixSchemaDefinition<TSchema> & TOverride>>;
+} & {
+    [K in `${TViewName}_history`]: ToKysely<EntityStateHistoryView<FromLixSchemaDefinition<TSchema> & TOverride>>;
+};
+/**
+ * Creates SQL views and CRUD triggers for an entity based on its schema definition.
+ *
+ * This function automatically generates three views:
+ * - Primary view (e.g., "key_value") - uses state (active version only)
+ * - All view (e.g., "key_value_all") - uses state (all versions)
+ * - History view (e.g., "key_value_history") - uses state_history (historical states)
+ *
+ * Each view includes:
+ * - A view that extracts JSON properties from the respective table
+ * - CRUD triggers for entity and entity_all views (history view is read-only)
+ *
+ * @throws Error if schema type is not "object" or x-lix-primary-key is not defined
+ *
+ * @example
+ * ```typescript
+ * // Basic usage for key-value entities
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixKeyValueSchema,
+ *   overrideName: "key_value",
+ *   pluginKey: "lix_key_value",
+ *   hardcodedFileId: "lix"
+ * });
+ * // Creates: key_value, key_value_all, and key_value_history
+ *
+ * // With default values for account entities
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixAccountSchema,
+ *   overrideName: "account",
+ *   pluginKey: "lix_own_entity",
+ *   hardcodedFileId: "lix",
+ *   defaultValues: {
+ *     id: (row) => nanoid()
+ *   }
+ * });
+ * // Creates: account, account_all, and account_history
+ * ```
+ */
+export declare function createEntityViewsIfNotExists(args: {
+    lix: Pick<Lix, "sqlite">;
+    schema: LixSchemaDefinition;
+    /** Overrides the view name which defaults to schema["x-lix-key"] */
+    overrideName?: string;
+    /** Plugin identifier for the entity */
+    pluginKey: string;
+    /** Optional hardcoded file_id (if not provided, uses lixcol_file_id from mutations) */
+    hardcodedFileId?: string;
+    /** Optional hardcoded version_id (if not provided, uses lixcol_version_id from mutations or active version) */
+    hardcodedVersionId?: string;
+    /** Object mapping property names to functions that generate default values */
+    defaultValues?: Record<string, (() => any) | ((row: Record<string, any>) => any)>;
+    /** Custom validation logic for entity operations */
+    validation?: ValidationCallbacks;
+}): void;
+//# sourceMappingURL=entity-view-builder.d.ts.map

package/dist/entity-views/entity-view-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-view-builder.d.ts","sourceRoot":"","sources":["../../src/entity-views/entity-view-builder.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,KAAK,EACX,uBAAuB,EACvB,mBAAmB,EACnB,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEN,KAAK,eAAe,EACpB,KAAK,cAAc,EACnB,KAAK,mBAAmB,EACxB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAEN,KAAK,kBAAkB,EACvB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEN,KAAK,sBAAsB,EAC3B,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EACX,eAAe,EACf,kBAAkB,EAClB,sBAAsB,EACtB,QAAQ,EACR,MAAM,YAAY,CAAC;AAGpB,YAAY,EAAE,eAAe,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AAC5E,YAAY,EAAE,cAAc,EAAE,mBAAmB,EAAE,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,WAAW,CACtB,OAAO,SAAS,mBAAmB,EACnC,SAAS,SAAS,MAAM,EACxB,SAAS,GAAG,MAAM,IACf;KACF,CAAC,IAAI,SAAS,GAAG,QAAQ,CACzB,eAAe,CAAC,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAC7D;CACD,GAAG;KACF,CAAC,IAAI,GAAG,SAAS,MAAM,GAAG,QAAQ,CAClC,kBAAkB,CAAC,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CAChE;CACD,GAAG;KACF,CAAC,IAAI,GAAG,SAAS,UAAU,GAAG,QAAQ,CACtC,sBAAsB,CAAC,uBAAuB,CAAC,OAAO,CAAC,GAAG,SAAS,CAAC,CACpE;CACD,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE;IAClD,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IACzB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,oEAAoE;IACpE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,uCAAuC;IACvC,SAAS,EAAE,MAAM,CAAC;IAClB,uFAAuF;IACvF,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,+GAA+G;IAC/G,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,8EAA8E;IAC9E,aAAa,CAAC,EAAE,MAAM,CACrB,MAAM,EACN,CAAC,MAAM,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CACjD,CAAC;IACF,oDAAoD;IACpD,UAAU,CAAC,EAAE,mBAAmB,CAAC;CACjC,GAAG,IAAI,CAqBP"}

package/dist/entity-views/entity-view-builder.js

@@ -0,0 +1,63 @@
+import { createEntityStateView, } from "./entity-state.js";
+import { createEntityStateAllView, } from "./entity-state-all.js";
+import { createEntityStateHistoryView, } from "./entity-state-history.js";
+/**
+ * Creates SQL views and CRUD triggers for an entity based on its schema definition.
+ *
+ * This function automatically generates three views:
+ * - Primary view (e.g., "key_value") - uses state (active version only)
+ * - All view (e.g., "key_value_all") - uses state (all versions)
+ * - History view (e.g., "key_value_history") - uses state_history (historical states)
+ *
+ * Each view includes:
+ * - A view that extracts JSON properties from the respective table
+ * - CRUD triggers for entity and entity_all views (history view is read-only)
+ *
+ * @throws Error if schema type is not "object" or x-lix-primary-key is not defined
+ *
+ * @example
+ * ```typescript
+ * // Basic usage for key-value entities
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixKeyValueSchema,
+ *   overrideName: "key_value",
+ *   pluginKey: "lix_key_value",
+ *   hardcodedFileId: "lix"
+ * });
+ * // Creates: key_value, key_value_all, and key_value_history
+ *
+ * // With default values for account entities
+ * createEntityViewsIfNotExists({
+ *   lix,
+ *   schema: LixAccountSchema,
+ *   overrideName: "account",
+ *   pluginKey: "lix_own_entity",
+ *   hardcodedFileId: "lix",
+ *   defaultValues: {
+ *     id: (row) => nanoid()
+ *   }
+ * });
+ * // Creates: account, account_all, and account_history
+ * ```
+ */
+export function createEntityViewsIfNotExists(args) {
+    const view_name = args.overrideName ?? args.schema["x-lix-key"];
+    // Create the primary view (active only)
+    createEntityStateView({
+        ...args,
+        overrideName: view_name,
+    });
+    // Create the _all view (all versions)
+    createEntityStateAllView({
+        ...args,
+        overrideName: view_name + "_all",
+    });
+    // Create the _history view (historical states)
+    createEntityStateHistoryView({
+        lix: args.lix,
+        schema: args.schema,
+        overrideName: view_name + "_history",
+    });
+}
+//# sourceMappingURL=entity-view-builder.js.map

package/dist/entity-views/entity-view-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-view-builder.js","sourceRoot":"","sources":["../../src/entity-views/entity-view-builder.ts"],"names":[],"mappings":"AAKA,OAAO,EACN,qBAAqB,GAIrB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EACN,wBAAwB,GAExB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACN,4BAA4B,GAE5B,MAAM,2BAA2B,CAAC;AAkDnC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAkB5C;IACA,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAEhE,wCAAwC;IACxC,qBAAqB,CAAC;QACrB,GAAG,IAAI;QACP,YAAY,EAAE,SAAS;KACvB,CAAC,CAAC;IAEH,sCAAsC;IACtC,wBAAwB,CAAC;QACxB,GAAG,IAAI;QACP,YAAY,EAAE,SAAS,GAAG,MAAM;KAChC,CAAC,CAAC;IAEH,+CAA+C;IAC/C,4BAA4B,CAAC;QAC5B,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,MAAM,EAAE,IAAI,CAAC,MAAM;QACnB,YAAY,EAAE,SAAS,GAAG,UAAU;KACpC,CAAC,CAAC;AACJ,CAAC"}

package/dist/entity-views/entity-view-builder.test.d.ts

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

package/dist/entity-views/entity-view-builder.test.d.ts.map

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

package/dist/entity-views/entity-view-builder.test.js

@@ -0,0 +1,247 @@
+import { test, expect, describe } from "vitest";
+import { openLix } from "../lix/open-lix.js";
+import { createEntityViewsIfNotExists } from "./entity-view-builder.js";
+describe("createEntityViewsIfNotExists (Integration)", () => {
+    const testSchema = {
+        "x-lix-key": "test_entity",
+        "x-lix-version": "1.0",
+        "x-lix-primary-key": ["id"],
+        type: "object",
+        properties: {
+            id: { type: "string" },
+            name: { type: "string" },
+            value: { type: "number" },
+        },
+        required: ["id", "name"],
+    };
+    test("should create all three views: active, _all, and _history", async () => {
+        const lix = await openLix({});
+        // Add stored schema
+        const mockSchema = {
+            "x-lix-key": "test_entity",
+            "x-lix-version": "1.0",
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                value: { type: "number" },
+            },
+        };
+        await lix.db
+            .insertInto("stored_schema")
+            .values({ value: mockSchema })
+            .execute();
+        createEntityViewsIfNotExists({
+            lix,
+            schema: testSchema,
+            overrideName: "triple_test",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert data through primary view
+        await lix.db
+            .insertInto("triple_test")
+            .values({ id: "test_id", name: "test_name", value: 42 })
+            .execute();
+        // All three views should be queryable
+        const activeResult = await lix.db
+            .selectFrom("triple_test")
+            .selectAll()
+            .execute();
+        const allResult = await lix.db
+            .selectFrom("triple_test_all")
+            .selectAll()
+            .execute();
+        // Get the active version's change set to query history
+        const activeVersion = await lix.db
+            .selectFrom("active_version")
+            .innerJoin("version", "active_version.version_id", "version.id")
+            .select("version.change_set_id")
+            .executeTakeFirstOrThrow();
+        const historyResult = await lix.db
+            .selectFrom("triple_test_history")
+            .where("lixcol_change_set_id", "=", activeVersion.change_set_id)
+            .selectAll()
+            .execute();
+        // All views should return data
+        expect(activeResult).toHaveLength(1);
+        expect(allResult).toHaveLength(1);
+        expect(historyResult).toHaveLength(1);
+        // Verify business data consistency across all views
+        expect(activeResult[0]).toMatchObject({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        });
+        expect(allResult[0]).toMatchObject({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        });
+        expect(historyResult[0]).toMatchObject({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+        });
+        // Verify column differences between views
+        expect(activeResult[0]).not.toHaveProperty("lixcol_version_id"); // Primary view hides version_id
+        expect(allResult[0]).toHaveProperty("lixcol_version_id"); // _all view exposes version_id
+        expect(historyResult[0]).toHaveProperty("lixcol_change_set_id"); // _history view has history columns
+        expect(historyResult[0]).toHaveProperty("lixcol_depth", 0); // Current state is at depth 0
+    });
+    test("should handle cross-view operations", async () => {
+        const lix = await openLix({});
+        // Add stored schema
+        const mockSchema = {
+            "x-lix-key": "test_entity",
+            "x-lix-version": "1.0",
+            type: "object",
+            properties: {
+                id: { type: "string" },
+                name: { type: "string" },
+                value: { type: "number" },
+            },
+        };
+        await lix.db
+            .insertInto("stored_schema")
+            .values({ value: mockSchema })
+            .execute();
+        createEntityViewsIfNotExists({
+            lix,
+            schema: testSchema,
+            overrideName: "cross_test",
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Insert through _all view
+        await lix.db
+            .insertInto("cross_test_all")
+            .values({
+            id: "test_id",
+            name: "test_name",
+            value: 42,
+            lixcol_version_id: lix.db
+                .selectFrom("active_version")
+                .select("version_id"),
+        })
+            .execute();
+        // Update through primary view
+        await lix.db
+            .updateTable("cross_test")
+            .where("id", "=", "test_id")
+            .set({ name: "updated_name", value: 100 })
+            .execute();
+        // Update again to create history
+        await lix.db
+            .updateTable("cross_test")
+            .where("id", "=", "test_id")
+            .set({ name: "final_name", value: 200 })
+            .execute();
+        // Verify update in both CRUD views
+        const primaryResult = await lix.db
+            .selectFrom("cross_test")
+            .selectAll()
+            .execute();
+        const allResult = await lix.db
+            .selectFrom("cross_test_all")
+            .selectAll()
+            .execute();
+        expect(primaryResult[0]).toMatchObject({ name: "final_name", value: 200 });
+        expect(allResult[0]).toMatchObject({ name: "final_name", value: 200 });
+        // Verify history view shows current state and can access historical data
+        const activeVersion = await lix.db
+            .selectFrom("active_version")
+            .innerJoin("version", "active_version.version_id", "version.id")
+            .select("version.change_set_id")
+            .executeTakeFirstOrThrow();
+        const historyResult = await lix.db
+            .selectFrom("cross_test_history")
+            .where("entity_id", "=", "test_id")
+            .where("lixcol_change_set_id", "=", activeVersion.change_set_id)
+            .orderBy("lixcol_depth", "asc")
+            .selectAll()
+            .execute();
+        expect(historyResult.length).toBeGreaterThan(0);
+        // Current state should be at depth 0
+        const currentState = historyResult.find((h) => h.lixcol_depth === 0);
+        expect(currentState).toBeDefined();
+        expect(currentState).toMatchObject({
+            name: "final_name",
+            value: 200,
+        });
+        // Delete through primary view
+        await lix.db
+            .deleteFrom("cross_test")
+            .where("id", "=", "test_id")
+            .execute();
+        // Verify deletion in both CRUD views
+        const afterDeletePrimary = await lix.db
+            .selectFrom("cross_test")
+            .selectAll()
+            .execute();
+        const afterDeleteAll = await lix.db
+            .selectFrom("cross_test_all")
+            .selectAll()
+            .execute();
+        expect(afterDeletePrimary).toHaveLength(0);
+        expect(afterDeleteAll).toHaveLength(0);
+    });
+    test("should use consistent naming conventions", async () => {
+        const lix = await openLix({});
+        createEntityViewsIfNotExists({
+            lix,
+            schema: testSchema,
+            // No overrideName - should use schema["x-lix-key"] as base
+            pluginKey: "test_plugin",
+            hardcodedFileId: "test_file",
+        });
+        // Should create views with default names based on schema key
+        // Primary view: test_entity
+        // All view: test_entity_all
+        // History view: test_entity_history
+        // Test primary view
+        await lix.db
+            .insertInto("test_entity")
+            .values({ id: "test_id", name: "test_name", value: 42 })
+            .execute();
+        const primaryResult = await lix.db
+            .selectFrom("test_entity")
+            .selectAll()
+            .execute();
+        expect(primaryResult).toHaveLength(1);
+        // Test _all view
+        const allResult = await lix.db
+            .selectFrom("test_entity_all")
+            .selectAll()
+            .execute();
+        expect(allResult).toHaveLength(1);
+        // Test _history view
+        const historyViews = await lix.db
+            .selectFrom("test_entity_history")
+            .selectAll()
+            .limit(1)
+            .execute();
+        // History view should exist (even if no results match current query)
+        expect(historyViews).toBeDefined();
+    });
+    test("should handle validation and error cases", async () => {
+        const lix = await openLix({});
+        const invalidSchema = {
+            "x-lix-key": "invalid_schema",
+            "x-lix-version": "1.0",
+            type: "object",
+            properties: {
+                name: { type: "string" },
+            },
+        };
+        // Should throw error for all view types when schema is invalid
+        expect(() => {
+            createEntityViewsIfNotExists({
+                lix,
+                schema: invalidSchema,
+                pluginKey: "test_plugin",
+            });
+        }).toThrow("Schema must define 'x-lix-primary-key' for entity view generation");
+    });
+});
+//# sourceMappingURL=entity-view-builder.test.js.map

package/dist/entity-views/entity-view-builder.test.js.map

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

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

@@ -0,0 +1,128 @@
+import type { EntityStateAllColumns } from "./entity-state-all.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";
+export 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 that preserves Generated markers for database schema.
+ * This type is used in the database schema to ensure Kysely recognizes generated columns.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueView = StateEntityView<LixKeyValue>;
+ * ```
+ */
+export type EntityStateView<T> = T & EntityStateColumns;
+/**
+ * View type for all versions that preserves Generated markers.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueAllView = StateEntityAllView<LixKeyValue>;
+ * ```
+ */
+export type EntityStateAllView<T> = T & EntityStateAllColumns;
+/**
+ * View type for history that preserves Generated markers.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueHistoryView = StateEntityHistoryView<LixKeyValue>;
+ * ```
+ */
+export type EntityStateHistoryView<T> = T & StateEntityHistoryColumns;
+/**
+ * Generic type for entity state (active version only).
+ * Unwraps LixGenerated<T> columns to their underlying types for select operations.
+ *
+ * @example
+ * ```typescript
+ * type KeyValue = State<LixKeyValue>;
+ * ```
+ */
+export type State<T> = LixSelectable<EntityStateView<T>>;
+/**
+ * Generic type for entity state across all versions.
+ * Unwraps LixGenerated<T> columns to their underlying types for select operations.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueAll = StateAll<LixKeyValue>;
+ * ```
+ */
+export type StateAll<T> = LixSelectable<EntityStateAllView<T>>;
+/**
+ * Generic type for entity history state.
+ * Unwraps LixGenerated<T> columns to their underlying types for select operations.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueHistory = StateHistory<LixKeyValue>;
+ * ```
+ */
+export type StateHistory<T> = LixSelectable<EntityStateHistoryView<T>>;
+/**
+ * Generic type for creating new entity state (active version).
+ * Uses LixInsertable to make generated columns optional.
+ *
+ * @example
+ * ```typescript
+ * type NewKeyValue = NewState<LixKeyValue>;
+ * ```
+ */
+export type NewState<T> = LixInsertable<EntityStateView<T>>;
+/**
+ * Generic type for updating entity state (active version).
+ * Uses LixUpdateable to make all columns optional.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueUpdate = StateUpdate<LixKeyValue>;
+ * ```
+ */
+export type StateUpdate<T> = LixUpdateable<EntityStateView<T>>;
+/**
+ * Generic type for creating new entity state (all versions).
+ * Uses LixInsertable to make generated columns optional.
+ *
+ * @example
+ * ```typescript
+ * type NewKeyValueAll = NewStateAll<LixKeyValue>;
+ * ```
+ */
+export type NewStateAll<T> = LixInsertable<EntityStateAllView<T>>;
+/**
+ * Generic type for updating entity state (all versions).
+ * Uses LixUpdateable to make all columns optional.
+ *
+ * @example
+ * ```typescript
+ * type KeyValueAllUpdate = StateAllUpdate<LixKeyValue>;
+ * ```
+ */
+export type StateAllUpdate<T> = LixUpdateable<EntityStateAllView<T>>;
+export type { EntityViews } from "./entity-view-builder.js";
+//# sourceMappingURL=generic-types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generic-types.d.ts","sourceRoot":"","sources":["../../src/entity-views/generic-types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AACnE,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,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAGpH,YAAY,EAAE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AAEpH;;GAEG;AACH,KAAK,cAAc,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,IAAI,CAAA;CAAE,GAAG,IAAI,GAAG,KAAK,CAAC;AAErF;;;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;;;;;;;;GAQG;AACH,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,CAAC,GAAG,kBAAkB,CAAC;AAExD;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI,CAAC,GAAG,qBAAqB,CAAC;AAE9D;;;;;;;GAOG;AACH,MAAM,MAAM,sBAAsB,CAAC,CAAC,IAAI,CAAC,GAAG,yBAAyB,CAAC;AAEtE;;;;;;;;GAQG;AACH,MAAM,MAAM,KAAK,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAEzD;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,IAAI,aAAa,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,CAAC;AAEvE;;;;;;;;GAQG;AACH,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAE5D;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC,CAAC;AAE/D;;;;;;;;GAQG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAElE;;;;;;;;GAQG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI,aAAa,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,CAAC;AAGrE,YAAY,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC"}

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

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

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

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

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

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

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

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