latticesql 0.18.3 → 1.0.0

package/README.md

@@ -969,7 +969,11 @@ const task = await db.updateReturning('tasks', 'task-001', { status: 'done' });
 // task → { id: 'task-001', title: 'Write docs', status: 'done', priority: 3, ... }
 
 // Composite PK
-const seat = await db.updateReturning('event_seats', { event_id: 'e-1', seat_no: 3 }, { holder: 'Bob' });
+const seat = await db.updateReturning(
+  'event_seats',
+  { event_id: 'e-1', seat_no: 3 },
+  { holder: 'Bob' },
+);
 // seat → { event_id: 'e-1', seat_no: 3, holder: 'Bob' }
 ```
 
@@ -2012,6 +2016,14 @@ Three complete, commented examples are in [docs/examples/](./docs/examples/):
 
 ---
 
+## Staying up to date
+
+**CLI users:** The `lattice` CLI checks for new versions automatically and prints a notice when an update is available. Run `lattice update` to upgrade in place. Alternatively, use `npx lattice` to always run the latest version without a global install.
+
+**Library consumers:** By default, `npm install latticesql` adds a `^` semver range to your `package.json`, so patch and minor updates are picked up on your next `npm install`. For fully automated dependency updates, set up [Dependabot](https://docs.github.com/en/code-security/dependabot) or [Renovate](https://github.com/renovatebot/renovate) — they'll create PRs in your repo whenever a new version is published.
+
+---
+
 ## Contributing
 
 See [CONTRIBUTING.md](./CONTRIBUTING.md) for dev setup, test commands, and contribution guidelines.

package/dist/cli.js

@@ -2,7 +2,8 @@
 
 // src/cli.ts
 import { resolve as resolve4, dirname as dirname5 } from "path";
-import { readFileSync as readFileSync6 } from "fs";
+import { readFileSync as readFileSync7 } from "fs";
+import { execSync } from "child_process";
 import { parse as parse2 } from "yaml";
 
 // src/codegen/generate.ts
@@ -493,7 +494,7 @@ var SchemaManager = class {
   applySchema(adapter) {
     for (const [name, def] of this._tables) {
       const pkCols = this._tablePK.get(name) ?? ["id"];
-      let constraints = def.tableConstraints ? [...def.tableConstraints] : [];
+      const constraints = def.tableConstraints ? [...def.tableConstraints] : [];
       if (pkCols.length > 1) {
         const alreadyHasPK = constraints.some((c) => c.toUpperCase().startsWith("PRIMARY KEY"));
         if (!alreadyHasPK) {
@@ -537,7 +538,7 @@ var SchemaManager = class {
   queryTable(adapter, name) {
     if (this._tables.has(name)) {
       const def = this._tables.get(name);
-      if (def.columns && "deleted_at" in def.columns) {
+      if (def?.columns && "deleted_at" in def.columns) {
         return adapter.all(`SELECT * FROM "${name}" WHERE deleted_at IS NULL`);
       }
       return adapter.all(`SELECT * FROM "${name}"`);
@@ -721,7 +722,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
     case "self":
       return [entityRow];
     case "hasMany": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -733,7 +734,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "manyToMany": {
-      if (protection && protection.protectedTables.has(source.remoteTable)) {
+      if (protection?.protectedTables.has(source.remoteTable)) {
         if (source.remoteTable === protection.currentTable) return [entityRow];
         return [];
       }
@@ -759,7 +760,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "belongsTo": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -1711,7 +1712,12 @@ var Lattice = class {
     this._assertNotInit("define");
     const compiledDef = {
       ...def,
-      render: def.render ? compileRender(def, table, this._schema, this._adapter) : () => "",
+      render: def.render ? compileRender(
+        def,
+        table,
+        this._schema,
+        this._adapter
+      ) : () => "",
       outputFile: def.outputFile ?? `.schema-only/${table}.md`
     };
     this._schema.define(table, compiledDef);
@@ -1790,9 +1796,7 @@ var Lattice = class {
           `Entity context "${table}" has encrypted: true but no encryptionKey was provided in Lattice options`
         );
       }
-      if (!this._encryptionKey) {
-        this._encryptionKey = deriveKey(this._encryptionKeyRaw);
-      }
+      this._encryptionKey ??= deriveKey(this._encryptionKeyRaw);
       const pragmaRows = this._adapter.all(`PRAGMA table_info("${table}")`);
       const allCols = pragmaRows.map((r) => r.name);
       const encCols = resolveEncryptedColumns(def.encrypted, allCols);
@@ -2621,6 +2625,49 @@ var Lattice = class {
   }
 };
 
+// src/update-check.ts
+import { readFileSync as readFileSync6, writeFileSync as writeFileSync3, mkdirSync as mkdirSync4, existsSync as existsSync8 } from "fs";
+import { join as join8 } from "path";
+import { homedir } from "os";
+var ONE_DAY_MS = 864e5;
+function isNewer(latest, current) {
+  const a = latest.split(".").map(Number);
+  const b = current.split(".").map(Number);
+  for (let i = 0; i < Math.max(a.length, b.length); i++) {
+    const av = a[i] ?? 0;
+    const bv = b[i] ?? 0;
+    if (av > bv) return true;
+    if (av < bv) return false;
+  }
+  return false;
+}
+async function checkForUpdate(pkgName, currentVersion) {
+  const cacheDir = join8(homedir(), `.${pkgName}`);
+  const cachePath = join8(cacheDir, "update-check.json");
+  try {
+    if (existsSync8(cachePath)) {
+      const cached = JSON.parse(readFileSync6(cachePath, "utf-8"));
+      if (Date.now() - cached.checked < ONE_DAY_MS) {
+        return isNewer(cached.latest, currentVersion) ? cached.latest : null;
+      }
+    }
+  } catch {
+  }
+  const res = await fetch(`https://registry.npmjs.org/${pkgName}/latest`, {
+    headers: { accept: "application/json" },
+    signal: AbortSignal.timeout(5e3)
+  });
+  if (!res.ok) return null;
+  const data = await res.json();
+  const latest = data.version;
+  try {
+    if (!existsSync8(cacheDir)) mkdirSync4(cacheDir, { recursive: true });
+    writeFileSync3(cachePath, JSON.stringify({ latest, checked: Date.now() }));
+  } catch {
+  }
+  return isNewer(latest, currentVersion) ? latest : null;
+}
+
 // src/cli.ts
 function parseArgs(argv) {
   let command;
@@ -2707,6 +2754,7 @@ function printHelp() {
       "  reconcile   Render + cleanup orphaned entity directories and files",
       "  status      Dry-run reconcile \u2014 show what would change without writing",
       "  watch       Poll for changes and re-render on each cycle",
+      "  update      Upgrade latticesql to the latest version",
       "",
       "Options (generate):",
       "  --config, -c <path>    Path to config file (default: ./lattice.config.yml)",
@@ -2744,20 +2792,40 @@ function printHelp() {
     ].join("\n")
   );
 }
-function printVersion() {
+function getVersion() {
   try {
     const pkgPath = new URL("../package.json", import.meta.url).pathname;
-    const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
-    console.log(pkg.version);
+    const pkg = JSON.parse(readFileSync7(pkgPath, "utf-8"));
+    return pkg.version;
   } catch {
-    console.log("unknown");
+    return "unknown";
+  }
+}
+function printVersion() {
+  console.log(getVersion());
+}
+async function runUpdate() {
+  const currentVersion = getVersion();
+  console.log(`Current version: ${currentVersion}`);
+  const latest = await checkForUpdate("latticesql", currentVersion);
+  if (!latest) {
+    console.log("Already up to date.");
+    return;
+  }
+  console.log(`Updating to ${latest}...`);
+  try {
+    execSync("npm install -g latticesql@latest", { stdio: "inherit" });
+    console.log(`Updated latticesql ${currentVersion} \u2192 ${latest}`);
+  } catch {
+    console.error("Update failed. Try running manually: npm install -g latticesql@latest");
+    process.exit(1);
   }
 }
 function runGenerate(args) {
   const configPath = resolve4(args.config);
   let raw;
   try {
-    raw = readFileSync6(configPath, "utf-8");
+    raw = readFileSync7(configPath, "utf-8");
   } catch {
     console.error(`Error: cannot read config file at "${configPath}"`);
     process.exit(1);
@@ -2924,6 +2992,19 @@ function main() {
     printHelp();
     process.exit(args.command === void 0 && !args.help ? 1 : 0);
   }
+  const version = getVersion();
+  if (version !== "unknown") {
+    checkForUpdate("latticesql", version).then((latest) => {
+      if (latest) {
+        process.on("exit", () => {
+          console.log(
+            `
+Update available: ${version} \u2192 ${latest} \u2014 run "lattice update" to upgrade`
+          );
+        });
+      }
+    }).catch(() => void 0);
+  }
   switch (args.command) {
     case "generate":
       runGenerate(args);
@@ -2940,6 +3021,9 @@ function main() {
     case "watch":
       void runWatch(args);
       break;
+    case "update":
+      void runUpdate();
+      break;
     default:
       console.error(`Unknown command: ${args.command}`);
       printHelp();

package/dist/index.cjs

@@ -246,7 +246,7 @@ var SchemaManager = class {
   applySchema(adapter) {
     for (const [name, def] of this._tables) {
       const pkCols = this._tablePK.get(name) ?? ["id"];
-      let constraints = def.tableConstraints ? [...def.tableConstraints] : [];
+      const constraints = def.tableConstraints ? [...def.tableConstraints] : [];
       if (pkCols.length > 1) {
         const alreadyHasPK = constraints.some((c) => c.toUpperCase().startsWith("PRIMARY KEY"));
         if (!alreadyHasPK) {
@@ -290,7 +290,7 @@ var SchemaManager = class {
   queryTable(adapter, name) {
     if (this._tables.has(name)) {
       const def = this._tables.get(name);
-      if (def.columns && "deleted_at" in def.columns) {
+      if (def?.columns && "deleted_at" in def.columns) {
         return adapter.all(`SELECT * FROM "${name}" WHERE deleted_at IS NULL`);
       }
       return adapter.all(`SELECT * FROM "${name}"`);
@@ -474,7 +474,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
     case "self":
       return [entityRow];
     case "hasMany": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -486,7 +486,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "manyToMany": {
-      if (protection && protection.protectedTables.has(source.remoteTable)) {
+      if (protection?.protectedTables.has(source.remoteTable)) {
         if (source.remoteTable === protection.currentTable) return [entityRow];
         return [];
       }
@@ -512,7 +512,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "belongsTo": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -1755,7 +1755,12 @@ var Lattice = class {
     this._assertNotInit("define");
     const compiledDef = {
       ...def,
-      render: def.render ? compileRender(def, table, this._schema, this._adapter) : () => "",
+      render: def.render ? compileRender(
+        def,
+        table,
+        this._schema,
+        this._adapter
+      ) : () => "",
       outputFile: def.outputFile ?? `.schema-only/${table}.md`
     };
     this._schema.define(table, compiledDef);
@@ -1834,9 +1839,7 @@ var Lattice = class {
           `Entity context "${table}" has encrypted: true but no encryptionKey was provided in Lattice options`
         );
       }
-      if (!this._encryptionKey) {
-        this._encryptionKey = deriveKey(this._encryptionKeyRaw);
-      }
+      this._encryptionKey ??= deriveKey(this._encryptionKeyRaw);
       const pragmaRows = this._adapter.all(`PRAGMA table_info("${table}")`);
       const allCols = pragmaRows.map((r) => r.name);
       const encCols = resolveEncryptedColumns(def.encrypted, allCols);
@@ -2677,10 +2680,8 @@ function fixSchemaConflicts(db, checks) {
   }
   if (tableExists(db, "__lattice_migrations")) {
     const versionCol = db.prepare('PRAGMA table_info("__lattice_migrations")').all().find((c) => c.name === "version");
-    if (versionCol && versionCol.type.toUpperCase().includes("INTEGER")) {
-      db.exec(
-        'ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"'
-      );
+    if (versionCol?.type.toUpperCase().includes("INTEGER")) {
+      db.exec('ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"');
     }
   }
 }

package/dist/index.d.cts

@@ -1539,10 +1539,10 @@ declare function contentHash(content: string): string;
  * // Now safe to call lattice.init()
  * ```
  */
-declare function fixSchemaConflicts(db: Database.Database, checks: Array<{
+declare function fixSchemaConflicts(db: Database.Database, checks: {
     table: string;
     requiredColumns: string[];
-}>): void;
+}[]): void;
 
 /**
  * Derive a 256-bit AES key from a master password using scrypt.

package/dist/index.d.ts

@@ -1539,10 +1539,10 @@ declare function contentHash(content: string): string;
  * // Now safe to call lattice.init()
  * ```
  */
-declare function fixSchemaConflicts(db: Database.Database, checks: Array<{
+declare function fixSchemaConflicts(db: Database.Database, checks: {
     table: string;
     requiredColumns: string[];
-}>): void;
+}[]): void;
 
 /**
  * Derive a 256-bit AES key from a master password using scrypt.

package/dist/index.js

@@ -179,7 +179,7 @@ var SchemaManager = class {
   applySchema(adapter) {
     for (const [name, def] of this._tables) {
       const pkCols = this._tablePK.get(name) ?? ["id"];
-      let constraints = def.tableConstraints ? [...def.tableConstraints] : [];
+      const constraints = def.tableConstraints ? [...def.tableConstraints] : [];
       if (pkCols.length > 1) {
         const alreadyHasPK = constraints.some((c) => c.toUpperCase().startsWith("PRIMARY KEY"));
         if (!alreadyHasPK) {
@@ -223,7 +223,7 @@ var SchemaManager = class {
   queryTable(adapter, name) {
     if (this._tables.has(name)) {
       const def = this._tables.get(name);
-      if (def.columns && "deleted_at" in def.columns) {
+      if (def?.columns && "deleted_at" in def.columns) {
         return adapter.all(`SELECT * FROM "${name}" WHERE deleted_at IS NULL`);
       }
       return adapter.all(`SELECT * FROM "${name}"`);
@@ -407,7 +407,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
     case "self":
       return [entityRow];
     case "hasMany": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -419,7 +419,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "manyToMany": {
-      if (protection && protection.protectedTables.has(source.remoteTable)) {
+      if (protection?.protectedTables.has(source.remoteTable)) {
         if (source.remoteTable === protection.currentTable) return [entityRow];
         return [];
       }
@@ -445,7 +445,7 @@ function resolveEntitySource(source, entityRow, entityPk, adapter, protection) {
       return adapter.all(sql, params);
     }
     case "belongsTo": {
-      if (protection && protection.protectedTables.has(source.table)) {
+      if (protection?.protectedTables.has(source.table)) {
         if (source.table === protection.currentTable) return [entityRow];
         return [];
       }
@@ -1688,7 +1688,12 @@ var Lattice = class {
     this._assertNotInit("define");
     const compiledDef = {
       ...def,
-      render: def.render ? compileRender(def, table, this._schema, this._adapter) : () => "",
+      render: def.render ? compileRender(
+        def,
+        table,
+        this._schema,
+        this._adapter
+      ) : () => "",
       outputFile: def.outputFile ?? `.schema-only/${table}.md`
     };
     this._schema.define(table, compiledDef);
@@ -1767,9 +1772,7 @@ var Lattice = class {
           `Entity context "${table}" has encrypted: true but no encryptionKey was provided in Lattice options`
         );
       }
-      if (!this._encryptionKey) {
-        this._encryptionKey = deriveKey(this._encryptionKeyRaw);
-      }
+      this._encryptionKey ??= deriveKey(this._encryptionKeyRaw);
       const pragmaRows = this._adapter.all(`PRAGMA table_info("${table}")`);
       const allCols = pragmaRows.map((r) => r.name);
       const encCols = resolveEncryptedColumns(def.encrypted, allCols);
@@ -2610,10 +2613,8 @@ function fixSchemaConflicts(db, checks) {
   }
   if (tableExists(db, "__lattice_migrations")) {
     const versionCol = db.prepare('PRAGMA table_info("__lattice_migrations")').all().find((c) => c.name === "version");
-    if (versionCol && versionCol.type.toUpperCase().includes("INTEGER")) {
-      db.exec(
-        'ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"'
-      );
+    if (versionCol?.type.toUpperCase().includes("INTEGER")) {
+      db.exec('ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"');
     }
   }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "latticesql",
-  "version": "0.18.3",
+  "version": "1.0.0",
   "description": "Persistent structured memory for AI agent systems — SQLite ↔ LLM context bridge",
   "type": "module",
   "main": "./dist/index.js",