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

package/dist/deterministic/generate-human-id.d.ts

@@ -0,0 +1,20 @@
+import type { Lix } from "../lix/open-lix.js";
+/**
+ * Generates a human-readable ID that is deterministic in deterministic mode.
+ *
+ * @example
+ * ```ts
+ * const name = generateHumanId({ lix });
+ * // In deterministic mode: returns deterministic names like "Plum", "Coin", etc.
+ * // In normal mode: returns random human-id names
+ *
+ * const lowercaseName = generateHumanId({ lix, capitalize: false });
+ * // Returns lowercase names like "plum", "coin", etc.
+ * ```
+ */
+export declare function generateHumanId(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+    separator?: string;
+    capitalize?: boolean;
+}): string;
+//# sourceMappingURL=generate-human-id.d.ts.map

package/dist/deterministic/generate-human-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-human-id.d.ts","sourceRoot":"","sources":["../../src/deterministic/generate-human-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAiD9C;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE;IACrC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,OAAO,CAAC;CACrB,GAAG,MAAM,CA2BT"}

package/dist/deterministic/generate-human-id.js

@@ -0,0 +1,86 @@
+import { isDeterministicMode } from "./is-deterministic-mode.js";
+import { nextDeterministicSequenceNumber } from "./sequence.js";
+import { humanId } from "human-id";
+// Deterministic names for anonymous accounts
+const DETERMINISTIC_NAMES = [
+    "Plum",
+    "Coin",
+    "Bird",
+    "Fish",
+    "Tree",
+    "Star",
+    "Moon",
+    "Sun",
+    "Wave",
+    "Rock",
+    "Fox",
+    "Bear",
+    "Wolf",
+    "Lion",
+    "Eagle",
+    "Hawk",
+    "Dove",
+    "Swan",
+    "Crow",
+    "Owl",
+    "Rose",
+    "Lily",
+    "Iris",
+    "Sage",
+    "Mint",
+    "Fern",
+    "Palm",
+    "Oak",
+    "Pine",
+    "Elm",
+    "Gold",
+    "Ruby",
+    "Pearl",
+    "Jade",
+    "Opal",
+    "Onyx",
+    "Zinc",
+    "Iron",
+    "Clay",
+    "Sand",
+];
+/**
+ * Generates a human-readable ID that is deterministic in deterministic mode.
+ *
+ * @example
+ * ```ts
+ * const name = generateHumanId({ lix });
+ * // In deterministic mode: returns deterministic names like "Plum", "Coin", etc.
+ * // In normal mode: returns random human-id names
+ *
+ * const lowercaseName = generateHumanId({ lix, capitalize: false });
+ * // Returns lowercase names like "plum", "coin", etc.
+ * ```
+ */
+export function generateHumanId(args) {
+    const capitalize = args.capitalize ?? true;
+    const separator = args.separator ?? "_";
+    if (isDeterministicMode({ lix: args.lix })) {
+        // In deterministic mode, use sequence to get deterministic index
+        const sequence = nextDeterministicSequenceNumber({
+            lix: args.lix,
+        });
+        // Use modulo to cycle through names
+        const name = DETERMINISTIC_NAMES[sequence % DETERMINISTIC_NAMES.length];
+        return capitalize ? name : name.toLowerCase();
+    }
+    else {
+        // In non-deterministic mode, use human-id library
+        const name = humanId({
+            capitalize: capitalize,
+            adjectiveCount: 0,
+            separator: separator,
+        })
+            // Human ID has two words, remove the last one
+            .split(separator)[0]
+            // Human ID uses plural, remove the last character to make it singular
+            .slice(0, -1);
+        return name;
+    }
+}
+//# sourceMappingURL=generate-human-id.js.map

package/dist/deterministic/generate-human-id.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-human-id.js","sourceRoot":"","sources":["../../src/deterministic/generate-human-id.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AAEnC,6CAA6C;AAC7C,MAAM,mBAAmB,GAAG;IAC3B,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,KAAK;IACL,MAAM;IACN,KAAK;IACL,MAAM;IACN,MAAM;IACN,OAAO;IACP,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;IACN,MAAM;CACN,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,eAAe,CAAC,IAI/B;IACA,MAAM,UAAU,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC;IAC3C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,GAAG,CAAC;IAExC,IAAI,mBAAmB,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC;QAC5C,iEAAiE;QACjE,MAAM,QAAQ,GAAG,+BAA+B,CAAC;YAChD,GAAG,EAAE,IAAI,CAAC,GAAG;SACb,CAAC,CAAC;QAEH,oCAAoC;QACpC,MAAM,IAAI,GAAG,mBAAmB,CAAC,QAAQ,GAAG,mBAAmB,CAAC,MAAM,CAAE,CAAC;QACzE,OAAO,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;IAC/C,CAAC;SAAM,CAAC;QACP,kDAAkD;QAClD,MAAM,IAAI,GAAG,OAAO,CAAC;YACpB,UAAU,EAAE,UAAU;YACtB,cAAc,EAAE,CAAC;YACjB,SAAS,EAAE,SAAS;SACpB,CAAC;YACD,8CAA8C;aAC7C,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,CAAE;YACrB,sEAAsE;aACrE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAEf,OAAO,IAAI,CAAC;IACb,CAAC;AACF,CAAC"}

package/dist/deterministic/generate-human-id.test.d.ts

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

package/dist/deterministic/generate-human-id.test.d.ts.map

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

package/dist/deterministic/generate-human-id.test.js

@@ -0,0 +1,123 @@
+import { test, expect } from "vitest";
+import { generateHumanId } from "./generate-human-id.js";
+import { openLix } from "../lix/open-lix.js";
+test("returns deterministic names in deterministic mode", async () => {
+    // Open two separate lix instances with deterministic mode
+    const lix1 = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    const lix2 = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate IDs from both instances - they should match
+    const id1_lix1 = generateHumanId({ lix: lix1 });
+    const id1_lix2 = generateHumanId({ lix: lix2 });
+    const id2_lix1 = generateHumanId({ lix: lix1 });
+    const id2_lix2 = generateHumanId({ lix: lix2 });
+    const id3_lix1 = generateHumanId({ lix: lix1 });
+    const id3_lix2 = generateHumanId({ lix: lix2 });
+    // Both instances should generate the same sequence
+    expect(id1_lix1).toBe(id1_lix2);
+    expect(id2_lix1).toBe(id2_lix2);
+    expect(id3_lix1).toBe(id3_lix2);
+});
+test("cycles through names when exceeding array length", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate many IDs to test cycling
+    const names = [];
+    for (let i = 0; i < 45; i++) {
+        names.push(generateHumanId({ lix }));
+    }
+    // Find where the cycle starts repeating
+    let firstRepeatIndex = -1;
+    for (let i = 1; i < names.length; i++) {
+        if (names[i] === names[0]) {
+            firstRepeatIndex = i;
+            break;
+        }
+    }
+    // Should cycle after 40 names
+    expect(firstRepeatIndex).toBe(40);
+    // Verify cycling pattern
+    expect(names[40]).toBe(names[0]);
+    expect(names[41]).toBe(names[1]);
+    expect(names[42]).toBe(names[2]);
+});
+test("returns non-deterministic names in normal mode", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: false } }],
+    });
+    const id1 = generateHumanId({ lix });
+    const id2 = generateHumanId({ lix });
+    // Names should be strings
+    expect(typeof id1).toBe("string");
+    expect(typeof id2).toBe("string");
+    // Names should not be empty
+    expect(id1.length).toBeGreaterThan(0);
+    expect(id2.length).toBeGreaterThan(0);
+    // Names should be capitalized
+    expect(id1[0]).toBe(id1[0]?.toUpperCase());
+    expect(id2[0]).toBe(id2[0]?.toUpperCase());
+});
+test("uses custom separator when provided", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: false } }],
+    });
+    const idWithDash = generateHumanId({ lix, separator: "-" });
+    const idWithSpace = generateHumanId({ lix, separator: " " });
+    const idWithUnderscore = generateHumanId({ lix, separator: "_" });
+    // All should be strings
+    expect(typeof idWithDash).toBe("string");
+    expect(typeof idWithSpace).toBe("string");
+    expect(typeof idWithUnderscore).toBe("string");
+    // Should not contain separators (since we extract only first word)
+    expect(idWithDash).not.toContain("-");
+    expect(idWithSpace).not.toContain(" ");
+    expect(idWithUnderscore).not.toContain("_");
+});
+test("persists sequence across lix instances", async () => {
+    // Create first lix instance
+    const lix1 = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate some IDs
+    const id1 = generateHumanId({ lix: lix1 });
+    const id2 = generateHumanId({ lix: lix1 });
+    const id3 = generateHumanId({ lix: lix1 });
+    // Get the blob
+    const blob = await lix1.toBlob();
+    // Create new lix instance from blob
+    const lix2 = await openLix({
+        blob,
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate next ID - should continue from where we left off
+    const id4 = generateHumanId({ lix: lix2 });
+    // Verify it's not repeating the sequence
+    expect(id4).not.toBe(id1);
+    expect(id4).not.toBe(id2);
+    expect(id4).not.toBe(id3);
+});
+test("handles capitalize option", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    // Generate IDs with different capitalize options
+    const capitalizedId = generateHumanId({ lix, capitalize: true });
+    const lowercaseId = generateHumanId({ lix, capitalize: false });
+    // Capitalized should be uppercase first letter
+    expect(capitalizedId[0]).toBe(capitalizedId[0]?.toUpperCase());
+    // Lowercase should be all lowercase
+    expect(lowercaseId).toBe(lowercaseId.toLowerCase());
+});
+test("default capitalize is true", async () => {
+    const lix = await openLix({
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    const id = generateHumanId({ lix });
+    // Should be capitalized by default
+    expect(id[0]).toBe(id[0]?.toUpperCase());
+});
+//# sourceMappingURL=generate-human-id.test.js.map

package/dist/deterministic/generate-human-id.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-human-id.test.js","sourceRoot":"","sources":["../../src/deterministic/generate-human-id.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACtC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,oBAAoB,CAAC;AAE7C,IAAI,CAAC,mDAAmD,EAAE,KAAK,IAAI,EAAE;IACpE,0DAA0D;IAC1D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC1B,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC1B,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,uDAAuD;IACvD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,QAAQ,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAEhD,mDAAmD;IACnD,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAChC,MAAM,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACjC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,kDAAkD,EAAE,KAAK,IAAI,EAAE;IACnE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,oCAAoC;IACpC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC7B,KAAK,CAAC,IAAI,CAAC,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,CAAC;IACtC,CAAC;IAED,wCAAwC;IACxC,IAAI,gBAAgB,GAAG,CAAC,CAAC,CAAC;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACvC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;YAC3B,gBAAgB,GAAG,CAAC,CAAC;YACrB,MAAM;QACP,CAAC;IACF,CAAC;IAED,8BAA8B;IAC9B,MAAM,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAElC,yBAAyB;IACzB,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACjC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClC,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,gDAAgD,EAAE,KAAK,IAAI,EAAE;IACjE,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IACrC,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAErC,0BAA0B;IAC1B,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAClC,MAAM,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAElC,4BAA4B;IAC5B,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IACtC,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAEtC,8BAA8B;IAC9B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAC3C,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;AAC5C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,qCAAqC,EAAE,KAAK,IAAI,EAAE;IACtD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,CAAC;KACzE,CAAC,CAAC;IAEH,MAAM,UAAU,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAC7D,MAAM,gBAAgB,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,SAAS,EAAE,GAAG,EAAE,CAAC,CAAC;IAElE,wBAAwB;IACxB,MAAM,CAAC,OAAO,UAAU,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IACzC,MAAM,CAAC,OAAO,WAAW,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1C,MAAM,CAAC,OAAO,gBAAgB,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAE/C,mEAAmE;IACnE,MAAM,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACtC,MAAM,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;IACvC,MAAM,CAAC,gBAAgB,CAAC,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;AAC7C,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,wCAAwC,EAAE,KAAK,IAAI,EAAE;IACzD,4BAA4B;IAC5B,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC1B,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,oBAAoB;IACpB,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAC3C,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,eAAe;IACf,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC;IAEjC,oCAAoC;IACpC,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC;QAC1B,IAAI;QACJ,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,4DAA4D;IAC5D,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC;IAE3C,yCAAyC;IACzC,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC1B,MAAM,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,2BAA2B,EAAE,KAAK,IAAI,EAAE;IAC5C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,iDAAiD;IACjD,MAAM,aAAa,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,WAAW,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC;IAEhE,+CAA+C;IAC/C,MAAM,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;IAE/D,oCAAoC;IACpC,MAAM,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC;AACrD,CAAC,CAAC,CAAC;AAEH,IAAI,CAAC,4BAA4B,EAAE,KAAK,IAAI,EAAE;IAC7C,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC;QACzB,SAAS,EAAE,CAAC,EAAE,GAAG,EAAE,wBAAwB,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;KACxE,CAAC,CAAC;IAEH,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC;IAEpC,mCAAmC;IACnC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC"}

package/dist/deterministic/index.d.ts

@@ -0,0 +1,8 @@
+export { isDeterministicMode } from "./is-deterministic-mode.js";
+export { nextDeterministicSequenceNumber } from "./sequence.js";
+export { timestamp } from "./timestamp.js";
+export { uuidV7 } from "./uuid-v7.js";
+export { nanoId } from "./nano-id.js";
+export { random } from "./random.js";
+export { generateHumanId } from "./generate-human-id.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/deterministic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/deterministic/index.js

@@ -0,0 +1,8 @@
+export { isDeterministicMode } from "./is-deterministic-mode.js";
+export { nextDeterministicSequenceNumber } from "./sequence.js";
+export { timestamp } from "./timestamp.js";
+export { uuidV7 } from "./uuid-v7.js";
+export { nanoId } from "./nano-id.js";
+export { random } from "./random.js";
+export { generateHumanId } from "./generate-human-id.js";
+//# sourceMappingURL=index.js.map

package/dist/deterministic/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/deterministic/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,+BAA+B,EAAE,MAAM,eAAe,CAAC;AAChE,OAAO,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC"}

package/dist/deterministic/is-deterministic-mode.d.ts

@@ -0,0 +1,14 @@
+import type { Lix } from "../lix/open-lix.js";
+/**
+ * Checks if deterministic mode is enabled by querying the key_value table.
+ *
+ * Returns true if the enabled property in the JSON object is true.
+ * Returns false for any other value or if the key doesn't exist.
+ *
+ * @param args - Object containing the lix instance with sqlite connection
+ * @returns true if deterministic mode is enabled, false otherwise
+ */
+export declare function isDeterministicMode(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+}): boolean;
+//# sourceMappingURL=is-deterministic-mode.d.ts.map

package/dist/deterministic/is-deterministic-mode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-deterministic-mode.d.ts","sourceRoot":"","sources":["../../src/deterministic/is-deterministic-mode.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAK9C;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACzC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;CAChC,GAAG,OAAO,CAeV"}

package/dist/deterministic/is-deterministic-mode.js

@@ -0,0 +1,25 @@
+import { executeSync } from "../database/execute-sync.js";
+import { sql } from "kysely";
+/**
+ * Checks if deterministic mode is enabled by querying the key_value table.
+ *
+ * Returns true if the enabled property in the JSON object is true.
+ * Returns false for any other value or if the key doesn't exist.
+ *
+ * @param args - Object containing the lix instance with sqlite connection
+ * @returns true if deterministic mode is enabled, false otherwise
+ */
+export function isDeterministicMode(args) {
+    // TODO account for active version
+    // Need to query from underlying state to avoid recursion
+    const [row] = executeSync({
+        lix: args.lix,
+        query: args.lix.db
+            .selectFrom("internal_resolved_state_all")
+            .where("entity_id", "=", "lix_deterministic_mode")
+            .where("schema_key", "=", "lix_key_value")
+            .select(sql `json_extract(snapshot_content, '$.value.enabled')`.as("enabled")),
+    });
+    return row?.enabled == true;
+}
+//# sourceMappingURL=is-deterministic-mode.js.map

package/dist/deterministic/is-deterministic-mode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-deterministic-mode.js","sourceRoot":"","sources":["../../src/deterministic/is-deterministic-mode.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC1D,OAAO,EAAE,GAAG,EAAe,MAAM,QAAQ,CAAC;AAG1C;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CAAC,IAEnC;IACA,kCAAkC;IAClC,yDAAyD;IACzD,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;QACzB,GAAG,EAAE,IAAI,CAAC,GAAG;QACb,KAAK,EAAG,IAAI,CAAC,GAAG,CAAC,EAAmD;aAClE,UAAU,CAAC,6BAA6B,CAAC;aACzC,KAAK,CAAC,WAAW,EAAE,GAAG,EAAE,wBAAwB,CAAC;aACjD,KAAK,CAAC,YAAY,EAAE,GAAG,EAAE,eAAe,CAAC;aACzC,MAAM,CACN,GAAG,CAAA,mDAAmD,CAAC,EAAE,CAAC,SAAS,CAAC,CACpE;KACF,CAAC,CAAC;IAEH,OAAO,GAAG,EAAE,OAAO,IAAI,IAAI,CAAC;AAC7B,CAAC"}

package/dist/deterministic/is-deterministic-mode.test.d.ts

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

package/dist/deterministic/is-deterministic-mode.test.d.ts.map

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

package/dist/deterministic/is-deterministic-mode.test.js

@@ -0,0 +1,103 @@
+import { test, expect } from "vitest";
+import { isDeterministicMode } from "./is-deterministic-mode.js";
+import { openLix } from "../lix/open-lix.js";
+import { newLixFile } from "../lix/new-lix.js";
+test("isDeterministicMode returns false when lix_deterministic_mode is not set", async () => {
+    const lix = await openLix({ blob: await newLixFile() });
+    const result = isDeterministicMode({ lix });
+    expect(result).toBe(false);
+});
+test("isDeterministicMode returns false when lix_deterministic_mode is explicitly false", async () => {
+    const lix = await openLix({
+        blob: await newLixFile(),
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: false } }],
+    });
+    const result = isDeterministicMode({ lix });
+    expect(result).toBe(false);
+});
+test("isDeterministicMode returns true when lix_deterministic_mode is true", async () => {
+    const lix = await openLix({
+        blob: await newLixFile(),
+        keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true } }],
+    });
+    const result = isDeterministicMode({ lix });
+    expect(result).toBe(true);
+});
+test("isDeterministicMode returns true for enabled values loosely equal to true", async () => {
+    const testCases = [
+        { enabled: 1, expected: true },
+        { enabled: "1", expected: true },
+        { enabled: true, expected: true },
+    ];
+    for (const { enabled, expected } of testCases) {
+        const lix = await openLix({
+            blob: await newLixFile(),
+            keyValues: [{ key: "lix_deterministic_mode", value: { enabled } }],
+        });
+        const result = isDeterministicMode({ lix });
+        expect(result).toBe(expected);
+    }
+});
+test("isDeterministicMode returns false for enabled values not loosely equal to true", async () => {
+    const testCases = [
+        { enabled: "yes", expected: false },
+        { enabled: "true", expected: false },
+        { enabled: 2, expected: false },
+        { enabled: {}, expected: false },
+        { enabled: [], expected: false },
+    ];
+    for (const { enabled, expected } of testCases) {
+        const lix = await openLix({
+            blob: await newLixFile(),
+            keyValues: [{ key: "lix_deterministic_mode", value: { enabled } }],
+        });
+        const result = isDeterministicMode({ lix });
+        expect(result).toBe(expected);
+    }
+});
+test("isDeterministicMode returns false for falsy enabled values", async () => {
+    const testCases = [
+        { enabled: null, expected: false },
+        { enabled: 0, expected: false },
+        { enabled: "", expected: false },
+        { enabled: undefined, expected: false },
+        { enabled: false, expected: false },
+    ];
+    for (const { enabled, expected } of testCases) {
+        const lix = await openLix({
+            blob: await newLixFile(),
+            keyValues: [{ key: "lix_deterministic_mode", value: { enabled } }],
+        });
+        const result = isDeterministicMode({ lix });
+        expect(result).toBe(expected);
+    }
+});
+test("isDeterministicMode works with only required properties from Lix", async () => {
+    const lix = await openLix({ blob: await newLixFile() });
+    // Create a minimal object with only required properties
+    const minimalLix = {
+        sqlite: lix.sqlite,
+        db: lix.db,
+    };
+    const result = isDeterministicMode({ lix: minimalLix });
+    expect(result).toBe(false);
+});
+test("isDeterministicMode can be changed at runtime", async () => {
+    const lix = await openLix({ blob: await newLixFile() });
+    // Initially false
+    expect(isDeterministicMode({ lix })).toBe(false);
+    // Set to true
+    await lix.db
+        .insertInto("key_value")
+        .values({ key: "lix_deterministic_mode", value: { enabled: true } })
+        .execute();
+    expect(isDeterministicMode({ lix })).toBe(true);
+    // Update to false
+    await lix.db
+        .updateTable("key_value")
+        .where("key", "=", "lix_deterministic_mode")
+        .set({ value: { enabled: false } })
+        .execute();
+    expect(isDeterministicMode({ lix })).toBe(false);
+});
+//# sourceMappingURL=is-deterministic-mode.test.js.map

package/dist/deterministic/is-deterministic-mode.test.js.map

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

package/dist/deterministic/nano-id.d.ts

@@ -0,0 +1,61 @@
+import type { Lix } from "../lix/open-lix.js";
+/**
+ * Returns a nano ID that is deterministic in deterministic mode.
+ *
+ * In normal mode, returns a random 21-character nano ID using the [nanoid](https://github.com/ai/nanoid) algorithm.
+ * In deterministic mode, returns sequential IDs with "test_" prefix for easy identification.
+ *
+ * Use nano IDs when IDs will appear in URLs - their shorter length makes links easier to share.
+ * For better database performance with time-ordered queries, consider {@link uuidV7} instead.
+ *
+ * - Normal mode: URL-safe random ID using custom alphabet (no `-` or `_`)
+ * - Deterministic mode: "test_" + 10-digit zero-padded counter
+ * - Counter state shared with {@link nextDeterministicSequenceNumber}
+ * - The "test_" prefix makes deterministic IDs easily identifiable
+ * - Choose nano IDs for URL-friendly short IDs, {@link uuidV7} for time-sortable database keys
+ * - Use the [Nano ID collision calculator](https://zelark.github.io/nano-id-cc/) to find the optimal length for your shareability vs uniqueness needs
+ *
+ * @example Normal mode - returns random nanoid
+ * ```ts
+ * const lix = await openLix();
+ * nanoId({ lix }); // "V1StGXR8_Z5jdHi6B-myT"
+ * ```
+ *
+ * @example Deterministic mode - returns sequential IDs
+ * ```ts
+ * const lix = await openLix({
+ *   keyValues: [{ key: "lix_deterministic_mode", value: { enabled: true }, lixcol_version_id: "global" }]
+ * });
+ * nanoId({ lix }); // "test_0000000000"
+ * nanoId({ lix }); // "test_0000000001"
+ * nanoId({ lix }); // "test_0000000002"
+ * ```
+ *
+ * @example Database operations
+ * ```ts
+ * await lix.db
+ *   .insertInto("label")
+ *   .values({
+ *     id: nanoId({ lix }),
+ *     name: "bug",
+ *     color: "#ff0000"
+ *   })
+ *   .execute();
+ * ```
+ *
+ * @param args.lix - The Lix instance with sqlite and db connections
+ * @param args.length - Custom length for non-deterministic mode (default: 21)
+ * @returns Nano ID string
+ */
+export declare function nanoId(args: {
+    lix: Pick<Lix, "sqlite" | "db">;
+    length?: number;
+}): string;
+/**
+ * Uses every character from nano id except for the `-` and `_` character.
+ *
+ * - Underscore `_` is not URL safe https://github.com/ai/nanoid/issues/347.
+ * - Dash `-` breaks selecting the ID from the URL in the browser.
+ */
+export declare const _nanoIdAlphabet = "0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz";
+//# sourceMappingURL=nano-id.d.ts.map

package/dist/deterministic/nano-id.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nano-id.d.ts","sourceRoot":"","sources":["../../src/deterministic/nano-id.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAO9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+CG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE;IAC5B,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,MAAM,CA6BT;AAiFD;;;;;GAKG;AACH,eAAO,MAAM,eAAe,mEACqC,CAAC"}