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

package/dist/deterministic/nano-id.test.js

@@ -0,0 +1,163 @@
+import { expect, test, vi } from "vitest";
+import { _nanoIdAlphabet, nanoId } from "./nano-id.js";
+import { openLix } from "../lix/open-lix.js";
+test("nanoId returns deterministic values when deterministic mode is enabled", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    const id1 = nanoId({ lix });
+    const id2 = nanoId({ lix });
+    const id3 = nanoId({ lix });
+    // Should have test_ prefix and 10 digits
+    expect(id1).toMatch(/^test_\d{10}$/);
+    expect(id2).toMatch(/^test_\d{10}$/);
+    expect(id3).toMatch(/^test_\d{10}$/);
+    // Extract counters
+    const counter1 = parseInt(id1.slice(5), 10);
+    const counter2 = parseInt(id2.slice(5), 10);
+    const counter3 = parseInt(id3.slice(5), 10);
+    // Should be sequential
+    expect(counter2).toBe(counter1 + 1);
+    expect(counter3).toBe(counter2 + 1);
+});
+test("nanoId returns random values when deterministic mode is disabled", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: false } }],
+    });
+    const id1 = nanoId({ lix });
+    const id2 = nanoId({ lix });
+    const id3 = nanoId({ lix });
+    // Should NOT have test_ prefix
+    expect(id1).not.toMatch(/^test_/);
+    expect(id2).not.toMatch(/^test_/);
+    expect(id3).not.toMatch(/^test_/);
+    // Should be 21 characters (default nanoid length)
+    expect(id1.length).toBe(21);
+    expect(id2.length).toBe(21);
+    expect(id3.length).toBe(21);
+    // Should all be different
+    expect(id1).not.toBe(id2);
+    expect(id2).not.toBe(id3);
+    expect(id1).not.toBe(id3);
+});
+test("nanoId toggles between deterministic and random", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Start with deterministic
+    const deterministicId = nanoId({ lix });
+    expect(deterministicId).toMatch(/^test_\d{10}$/);
+    // Switch to random
+    await lix.db
+        .updateTable("key_value")
+        .set({ value: { enabled: false } })
+        .where("key", "=", "lix_deterministic_mode")
+        .execute();
+    const randomId = nanoId({ lix });
+    expect(randomId).not.toMatch(/^test_/);
+    expect(randomId.length).toBe(21);
+    // Switch back to deterministic
+    await lix.db
+        .updateTable("key_value")
+        .set({ value: { enabled: true } })
+        .where("key", "=", "lix_deterministic_mode")
+        .execute();
+    const deterministicId2 = nanoId({ lix });
+    expect(deterministicId2).toMatch(/^test_\d{10}$/);
+});
+test("nanoId is persisted across lix instances", async () => {
+    const lix1 = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate some IDs to advance the counter
+    const id1 = nanoId({ lix: lix1 });
+    const id2 = nanoId({ lix: lix1 });
+    const id3 = nanoId({ lix: lix1 });
+    // Create a new instance from the blob
+    const blob = await lix1.toBlob();
+    const lix2 = await openLix({ blob });
+    // Next ID should continue from where we left off
+    const id4 = nanoId({ lix: lix2 });
+    // Extract counters
+    const counters = [id1, id2, id3, id4].map((id) => parseInt(id.slice(5), 10));
+    // Verify they continue sequentially
+    expect(counters[1]).toBe(counters[0] + 1);
+    expect(counters[2]).toBe(counters[1] + 1);
+    expect(counters[3]).toBe(counters[2] + 1);
+});
+test("nanoId advances correctly with many operations", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate 100 nanoIds
+    const ids = [];
+    for (let i = 0; i < 100; i++) {
+        ids.push(nanoId({ lix }));
+    }
+    // All should have test_ prefix
+    for (const id of ids) {
+        expect(id).toMatch(/^test_\d{10}$/);
+    }
+    // Extract counters
+    const counters = ids.map((id) => parseInt(id.slice(5), 10));
+    // All should be strictly increasing
+    for (let i = 1; i < counters.length; i++) {
+        expect(counters[i]).toBe(counters[i - 1] + 1);
+    }
+    // Verify the sequence span
+    expect(counters[99] - counters[0]).toBe(99);
+});
+test("nanoId format is consistent across different counter values", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate an ID with initial counter
+    const id1 = nanoId({ lix });
+    expect(id1).toMatch(/^test_\d{10}$/);
+    expect(id1.length).toBe(15); // "test_" (5) + 10 digits
+    // Generate many IDs to get different counter magnitudes
+    for (let i = 0; i < 1000; i++) {
+        nanoId({ lix });
+    }
+    const idAfter1000 = nanoId({ lix });
+    expect(idAfter1000).toMatch(/^test_\d{10}$/);
+    expect(idAfter1000.length).toBe(15); // Should still be padded to same length
+});
+test("length is obeyed", async () => {
+    const lix = await openLix({});
+    const id = nanoId({ lix, length: 10 });
+    expect(id.length).toBe(10);
+});
+test("the alphabet does not contain underscores `_` because they are not URL safe", () => {
+    expect(_nanoIdAlphabet).not.toContain("_");
+});
+test("the alphabet does not contain dashes `-` because they break selecting the ID from the URL in the browser", () => {
+    expect(_nanoIdAlphabet).not.toContain("-");
+});
+/**
+ * Test the crypto polyfill that was added to fix environments without crypto support
+ * like older versions of Node in Stackblitz.
+ *
+ * See: https://github.com/opral/lix-sdk/issues/258
+ */
+test("polyfill works when crypto is not available", async () => {
+    const lix = await openLix({});
+    // Store original crypto
+    const originalCrypto = global.crypto;
+    // Mock crypto as undefined to test the polyfill
+    vi.stubGlobal("crypto", undefined);
+    try {
+        const id = nanoId({ lix, length: 10 });
+        expect(id.length).toBe(10);
+        expect(typeof id).toBe("string");
+        // Check that it only contains characters from our alphabet
+        for (let i = 0; i < id.length; i++) {
+            expect(_nanoIdAlphabet).toContain(id[i]);
+        }
+    }
+    finally {
+        // Restore original crypto
+        vi.stubGlobal("crypto", originalCrypto);
+    }
+});
+//# sourceMappingURL=nano-id.test.js.map

package/dist/deterministic/nano-id.test.js.map

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

package/dist/deterministic/options.d.ts

@@ -0,0 +1,53 @@
+import type { FromLixSchemaDefinition, LixInsertable } from "../schema-definition/index.js";
+/**
+ * Schema definition for deterministic mode options.
+ *
+ * @example
+ * const options = {
+ *   enabled: true,
+ *   randomLixId: false,
+ *   timestamp: true,
+ *   random_seed: "default-seed",
+ *   nano_id: true,
+ *   uuid_v7: true
+ * };
+ */
+export declare const LixDeterministicModeOptionsSchema: {
+    readonly "x-lix-key": "lix_deterministic_mode";
+    readonly "x-lix-version": "1.0";
+    readonly type: "object";
+    readonly properties: {
+        readonly enabled: {
+            readonly type: "boolean";
+        };
+        readonly randomLixId: {
+            readonly type: "boolean";
+            readonly default: false;
+            readonly "x-lix-generated": true;
+        };
+        readonly timestamp: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly "x-lix-generated": true;
+        };
+        readonly random_seed: {
+            readonly type: "string";
+            readonly default: "lix-deterministic-seed";
+            readonly "x-lix-generated": true;
+        };
+        readonly nano_id: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly "x-lix-generated": true;
+        };
+        readonly uuid_v7: {
+            readonly type: "boolean";
+            readonly default: true;
+            readonly "x-lix-generated": true;
+        };
+    };
+    readonly required: readonly ["enabled"];
+    readonly additionalProperties: false;
+};
+export type DeterministicModeOptions = LixInsertable<FromLixSchemaDefinition<typeof LixDeterministicModeOptionsSchema>>;
+//# sourceMappingURL=options.d.ts.map

package/dist/deterministic/options.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.d.ts","sourceRoot":"","sources":["../../src/deterministic/options.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACX,uBAAuB,EACvB,aAAa,EAEb,MAAM,+BAA+B,CAAC;AAEvC;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAoCpC,CAAC;AAEX,MAAM,MAAM,wBAAwB,GAAG,aAAa,CACnD,uBAAuB,CAAC,OAAO,iCAAiC,CAAC,CACjE,CAAC"}

package/dist/deterministic/options.js

@@ -0,0 +1,52 @@
+/**
+ * Schema definition for deterministic mode options.
+ *
+ * @example
+ * const options = {
+ *   enabled: true,
+ *   randomLixId: false,
+ *   timestamp: true,
+ *   random_seed: "default-seed",
+ *   nano_id: true,
+ *   uuid_v7: true
+ * };
+ */
+export const LixDeterministicModeOptionsSchema = {
+    "x-lix-key": "lix_deterministic_mode",
+    "x-lix-version": "1.0",
+    type: "object",
+    properties: {
+        enabled: {
+            type: "boolean",
+        },
+        randomLixId: {
+            type: "boolean",
+            default: false,
+            "x-lix-generated": true,
+        },
+        timestamp: {
+            type: "boolean",
+            default: true,
+            "x-lix-generated": true,
+        },
+        random_seed: {
+            type: "string",
+            default: "lix-deterministic-seed",
+            "x-lix-generated": true,
+        },
+        nano_id: {
+            type: "boolean",
+            default: true,
+            "x-lix-generated": true,
+        },
+        uuid_v7: {
+            type: "boolean",
+            default: true,
+            "x-lix-generated": true,
+        },
+    },
+    required: ["enabled"],
+    additionalProperties: false,
+};
+LixDeterministicModeOptionsSchema;
+//# sourceMappingURL=options.js.map

package/dist/deterministic/options.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"options.js","sourceRoot":"","sources":["../../src/deterministic/options.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG;IAChD,WAAW,EAAE,wBAAwB;IACrC,eAAe,EAAE,KAAK;IACtB,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACX,OAAO,EAAE;YACR,IAAI,EAAE,SAAS;SACf;QACD,WAAW,EAAE;YACZ,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,KAAK;YACd,iBAAiB,EAAE,IAAI;SACvB;QACD,SAAS,EAAE;YACV,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,IAAI;SACvB;QACD,WAAW,EAAE;YACZ,IAAI,EAAE,QAAQ;YACd,OAAO,EAAE,wBAAwB;YACjC,iBAAiB,EAAE,IAAI;SACvB;QACD,OAAO,EAAE;YACR,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,IAAI;SACvB;QACD,OAAO,EAAE;YACR,IAAI,EAAE,SAAS;YACf,OAAO,EAAE,IAAI;YACb,iBAAiB,EAAE,IAAI;SACvB;KACD;IACD,QAAQ,EAAE,CAAC,SAAS,CAAC;IACrB,oBAAoB,EAAE,KAAK;CAClB,CAAC;AAMX,iCAA+D,CAAC"}

package/dist/deterministic/options.test.d.ts

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

package/dist/deterministic/options.test.d.ts.map

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

package/dist/deterministic/options.test.js

@@ -0,0 +1,111 @@
+import { test, expect } from "vitest";
+import { LixDeterministicModeOptionsSchema, } from "./options.js";
+import { validateLixSchema, validateLixSchemaDefinition, } from "../schema-definition/validate-lix-schema.js";
+test("deterministic mode options schema is a valid LixSchemaDefinition", () => {
+    expect(() => validateLixSchemaDefinition(LixDeterministicModeOptionsSchema)).not.toThrow();
+});
+test("validates correct deterministic mode options", () => {
+    const validOptions = {
+        enabled: true,
+        randomLixId: false,
+        timestamp: true,
+        random_seed: "test-seed",
+        nano_id: true,
+        uuid_v7: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, validOptions)).not.toThrow();
+});
+test("validates minimal deterministic mode options with only required fields", () => {
+    const minimalOptions = {
+        enabled: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, minimalOptions)).not.toThrow();
+});
+test("fails validation when enabled is missing", () => {
+    // @ts-expect-error - Testing missing required field
+    const invalidOptions = {
+        randomLixId: false,
+        timestamp: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("fails validation when enabled is not a boolean", () => {
+    const invalidOptions = {
+        // @ts-expect-error - Testing invalid type for enabled field
+        enabled: "true", // string instead of boolean
+        randomLixId: false,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("fails validation with additional properties", () => {
+    const invalidOptions = {
+        enabled: true,
+        // @ts-expect-error - Testing additional properties
+        unknown_property: "value",
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("validates all boolean fields correctly", () => {
+    const options = {
+        enabled: false,
+        randomLixId: true,
+        timestamp: false,
+        random_seed: "custom-seed",
+        nano_id: false,
+        uuid_v7: true,
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, options)).not.toThrow();
+});
+test("fails validation when boolean fields have wrong types", () => {
+    const testCases = [
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for randomLixId
+            randomLixId: "true",
+        },
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for timestamp
+            timestamp: 1,
+        },
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for nano_id
+            nano_id: null,
+        },
+        {
+            enabled: true,
+            // @ts-expect-error - Testing invalid type for uuid_v7
+            uuid_v7: {},
+        },
+    ];
+    for (const testCase of testCases) {
+        expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, testCase)).toThrow(/Data validation failed/);
+    }
+});
+test("fails validation when random_seed is not a string", () => {
+    const invalidOptions = {
+        enabled: true,
+        // @ts-expect-error - Testing invalid type for random_seed
+        random_seed: 12345, // number instead of string
+    };
+    expect(() => validateLixSchema(LixDeterministicModeOptionsSchema, invalidOptions)).toThrow(/Data validation failed/);
+});
+test("schema has correct metadata", () => {
+    expect(LixDeterministicModeOptionsSchema["x-lix-key"]).toBe("lix_deterministic_mode");
+    expect(LixDeterministicModeOptionsSchema["x-lix-version"]).toBe("1.0");
+    expect(LixDeterministicModeOptionsSchema.type).toBe("object");
+    expect(LixDeterministicModeOptionsSchema.required).toEqual(["enabled"]);
+    expect(LixDeterministicModeOptionsSchema.additionalProperties).toBe(false);
+});
+test("schema has correct default values", () => {
+    const properties = LixDeterministicModeOptionsSchema.properties;
+    expect(properties.randomLixId.default).toBe(false);
+    expect(properties.timestamp.default).toBe(true);
+    expect(properties.random_seed.default).toBe("lix-deterministic-seed");
+    expect(properties.nano_id.default).toBe(true);
+    expect(properties.uuid_v7.default).toBe(true);
+    // enabled should not have a default
+    expect(properties.enabled).not.toHaveProperty("default");
+});
+//# sourceMappingURL=options.test.js.map

package/dist/deterministic/options.test.js.map

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

package/dist/deterministic/random.d.ts

@@ -0,0 +1,68 @@
+import type { Lix } from "../lix/open-lix.js";
+/**
+ * Returns a random float between 0 (inclusive) and 1 (exclusive).
+ *
+ * In deterministic mode, generates reproducible values using xorshift128+ PRNG
+ * (the same algorithm used by V8/Chrome for Math.random()).
+ * In normal mode, uses crypto.getRandomValues() for cryptographically secure randomness.
+ *
+ * - Normal mode: Uses crypto.getRandomValues() for cryptographic quality
+ * - Deterministic mode: Uses xorshift128+ PRNG (same as V8/Chrome's Math.random())
+ * - Default seed: Uses `lix_id` value unless `lix_deterministic_rng_seed` is set
+ * - State persisted via `lix_deterministic_rng_state` key value
+ * - Both modes return 53-bit precision floats for consistency
+ * - For ID generation, consider {@link uuidV7} or {@link nanoId} instead
+ *
+ * @example Normal mode - cryptographically secure randomness
+ * ```ts
+ * const lix = await openLix();
+ * const r1 = random({ lix }); // 0.823... (unpredictable)
+ * const r2 = random({ lix }); // 0.156... (unpredictable)
+ * ```
+ *
+ * @example Deterministic mode - reproducible randomness
+ * ```ts
+ * const lix = await openLix({
+ *   keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }]
+ * });
+ * const r1 = random({ lix }); // 0.318... (always same sequence)
+ * const r2 = random({ lix }); // 0.937... (for same seed)
+ * const r3 = random({ lix }); // 0.543...
+ * ```
+ *
+ * @example Sampling and shuffling
+ * ```ts
+ * // Random selection
+ * const items = ["a", "b", "c", "d"];
+ * const idx = Math.floor(random({ lix }) * items.length);
+ * const selected = items[idx];
+ *
+ * // Fisher-Yates shuffle
+ * function shuffle<T>(array: T[], lix: Lix): T[] {
+ *   const result = [...array];
+ *   for (let i = result.length - 1; i > 0; i--) {
+ *     const j = Math.floor(random({ lix }) * (i + 1));
+ *     [result[i], result[j]] = [result[j], result[i]];
+ *   }
+ *   return result;
+ * }
+ * ```
+ *
+ * @param args.lix - The Lix instance with sqlite and db connections
+ * @returns Random float between 0 (inclusive) and 1 (exclusive) with 53-bit precision
+ */
+export declare function random(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+}): number;
+/**
+ * @internal
+ * Flush the in-memory RNG state to persistent storage.
+ *
+ * Called automatically by Lix after each committing write and during
+ * `lix.toBlob()` / `lix.close()`. **Not part of the public API.**
+ */
+export declare function commitDeterministicRngState(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+    timestamp?: string;
+}): void;
+//# sourceMappingURL=random.d.ts.map

package/dist/deterministic/random.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random.d.ts","sourceRoot":"","sources":["../../src/deterministic/random.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAoC9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmDG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE;IAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAA;CAAE,GAAG,MAAM,CAgDxE;AAkFD;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CAAC,IAAI,EAAE;IACjD,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,IAAI,CA4BP"}