latticesql 0.18.4 → 1.1.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' }
 ```
 

package/dist/cli.js

@@ -1712,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);

package/dist/index.cjs

@@ -36,6 +36,7 @@ __export(index_exports, {
   Lattice: () => Lattice,
   READ_ONLY_HEADER: () => READ_ONLY_HEADER,
   applyWriteEntry: () => applyWriteEntry,
+  autoUpdate: () => autoUpdate,
   contentHash: () => contentHash,
   createReadOnlyHeader: () => createReadOnlyHeader,
   createSQLiteStateStore: () => createSQLiteStateStore,
@@ -1755,7 +1756,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);
@@ -2676,9 +2682,7 @@ 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?.type.toUpperCase().includes("INTEGER")) {
-      db.exec(
-        'ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"'
-      );
+      db.exec('ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"');
     }
   }
 }
@@ -3098,6 +3102,66 @@ function applyWriteEntry(db, entry) {
     return { ok: false, reason: `DB error: ${message}` };
   }
 }
+
+// src/auto-update.ts
+var import_node_child_process = require("child_process");
+var import_node_fs8 = require("fs");
+var import_node_path8 = require("path");
+function getInstalledVersion(pkgName) {
+  try {
+    const pkgPath = (0, import_node_path8.join)(process.cwd(), "node_modules", pkgName, "package.json");
+    const pkg = JSON.parse((0, import_node_fs8.readFileSync)(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return null;
+  }
+}
+async function getLatestVersion(pkgName) {
+  try {
+    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();
+    return data.version;
+  } catch {
+    return null;
+  }
+}
+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++) {
+    if ((a[i] ?? 0) > (b[i] ?? 0)) return true;
+    if ((a[i] ?? 0) < (b[i] ?? 0)) return false;
+  }
+  return false;
+}
+async function autoUpdate(opts) {
+  const log = opts?.quiet ? () => {
+  } : console.log;
+  const result = { updated: false, packages: [], restartRequired: false };
+  const installed = getInstalledVersion("latticesql");
+  if (!installed) return result;
+  const latest = await getLatestVersion("latticesql");
+  if (!latest || !isNewer(latest, installed)) return result;
+  log(`[latticesql] Updating: latticesql@${installed} \u2192 ${latest}`);
+  try {
+    (0, import_node_child_process.execSync)(`npm install latticesql@${latest}`, {
+      cwd: process.cwd(),
+      stdio: opts?.quiet ? "ignore" : "inherit",
+      timeout: 6e4
+    });
+    result.updated = true;
+    result.restartRequired = true;
+    result.packages.push({ name: "latticesql", from: installed, to: latest });
+    log(`[latticesql] Updated successfully. Restart required.`);
+  } catch (err) {
+    console.error("[latticesql] Auto-update failed:", err);
+  }
+  return result;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   DEFAULT_ENTRY_TYPES,
@@ -3106,6 +3170,7 @@ function applyWriteEntry(db, entry) {
   Lattice,
   READ_ONLY_HEADER,
   applyWriteEntry,
+  autoUpdate,
   contentHash,
   createReadOnlyHeader,
   createSQLiteStateStore,

package/dist/index.d.cts

@@ -1810,4 +1810,21 @@ declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
  */
 declare const READ_ONLY_HEADER: string;
 
-export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileManifestInfo, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type ReportConfig, type ReportResult, type ReportSection, type ReportSectionResult, type ReverseSyncError, type ReverseSyncResult, type ReverseSyncUpdate, type Row, type SecurityOptions, type SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, contentHash, createReadOnlyHeader, createSQLiteStateStore, decrypt, deriveKey, encrypt, entityFileNames, fixSchemaConflicts, frontmatter, generateEntryId, generateWriteEntryId, isEncrypted, isV1EntityFiles, manifestPath, markdownTable, normalizeEntityFiles, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };
+interface AutoUpdateResult {
+    updated: boolean;
+    packages: Array<{
+        name: string;
+        from: string;
+        to: string;
+    }>;
+    restartRequired: boolean;
+}
+/**
+ * Check npm for a newer version of latticesql and install it.
+ * Safe to call on every startup — skips if already on latest.
+ */
+declare function autoUpdate(opts?: {
+    quiet?: boolean;
+}): Promise<AutoUpdateResult>;
+
+export { type ApplyWriteResult, type AuditEvent, type AutoUpdateResult, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileManifestInfo, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type ReportConfig, type ReportResult, type ReportSection, type ReportSectionResult, type ReverseSyncError, type ReverseSyncResult, type ReverseSyncUpdate, type Row, type SecurityOptions, type SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, autoUpdate, contentHash, createReadOnlyHeader, createSQLiteStateStore, decrypt, deriveKey, encrypt, entityFileNames, fixSchemaConflicts, frontmatter, generateEntryId, generateWriteEntryId, isEncrypted, isV1EntityFiles, manifestPath, markdownTable, normalizeEntityFiles, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.d.ts

@@ -1810,4 +1810,21 @@ declare function createReadOnlyHeader(options?: ReadOnlyHeaderOptions): string;
  */
 declare const READ_ONLY_HEADER: string;
 
-export { type ApplyWriteResult, type AuditEvent, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileManifestInfo, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type ReportConfig, type ReportResult, type ReportSection, type ReportSectionResult, type ReverseSyncError, type ReverseSyncResult, type ReverseSyncUpdate, type Row, type SecurityOptions, type SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, contentHash, createReadOnlyHeader, createSQLiteStateStore, decrypt, deriveKey, encrypt, entityFileNames, fixSchemaConflicts, frontmatter, generateEntryId, generateWriteEntryId, isEncrypted, isV1EntityFiles, manifestPath, markdownTable, normalizeEntityFiles, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };
+interface AutoUpdateResult {
+    updated: boolean;
+    packages: Array<{
+        name: string;
+        from: string;
+        to: string;
+    }>;
+    restartRequired: boolean;
+}
+/**
+ * Check npm for a newer version of latticesql and install it.
+ * Safe to call on every startup — skips if already on latest.
+ */
+declare function autoUpdate(opts?: {
+    quiet?: boolean;
+}): Promise<AutoUpdateResult>;
+
+export { type ApplyWriteResult, type AuditEvent, type AutoUpdateResult, type BelongsToRelation, type BelongsToSource, type BuiltinTemplateName, type CleanupOptions, type CleanupResult, type CountOptions, type CustomSource, DEFAULT_ENTRY_TYPES, DEFAULT_TYPE_ALIASES, type EnrichedSource, type EnrichmentLookup, type EntityContextDefinition, type EntityContextManifestEntry, type EntityFileManifestInfo, type EntityFileSource, type EntityFileSpec, type EntityProfileField, type EntityProfileSection, type EntityProfileTemplate, type EntityRenderSpec, type EntityRenderTemplate, type EntitySectionPerRow, type EntitySectionsTemplate, type EntityTableColumn, type EntityTableTemplate, type Filter, type FilterOp, type HasManyRelation, type HasManySource, InMemoryStateStore, type InitOptions, Lattice, type LatticeConfig, type LatticeConfigInput, type LatticeEntityDef, type LatticeEntityRenderSpec, type LatticeFieldDef, type LatticeFieldType, type LatticeManifest, type LatticeOptions, type LinkOptions, type ManyToManySource, type MarkdownTableColumn, type Migration, type MultiTableDefinition, type OrderBySpec, type ParseError, type ParseResult, type ParsedConfig, type PkLookup, type PrimaryKey, type QueryOptions, READ_ONLY_HEADER, type ReadOnlyHeaderOptions, type ReconcileOptions, type ReconcileResult, type Relation, type RenderHooks, type RenderResult, type RenderSpec, type ReportConfig, type ReportResult, type ReportSection, type ReportSectionResult, type ReverseSyncError, type ReverseSyncResult, type ReverseSyncUpdate, type Row, type SecurityOptions, type SeedConfig, type SeedLinkSpec, type SeedResult, type SelfSource, type SessionEntry, type SessionParseOptions, type SessionWriteEntry, type SessionWriteOp, type SessionWriteParseResult, type SourceQueryOptions, type StopFn, type SyncResult, type TableDefinition, type TemplateRenderSpec, type UpsertByNaturalKeyOptions, type WatchOptions, type WriteHook, type WriteHookContext, type WritebackDefinition, type WritebackStateStore, applyWriteEntry, autoUpdate, contentHash, createReadOnlyHeader, createSQLiteStateStore, decrypt, deriveKey, encrypt, entityFileNames, fixSchemaConflicts, frontmatter, generateEntryId, generateWriteEntryId, isEncrypted, isV1EntityFiles, manifestPath, markdownTable, normalizeEntityFiles, parseConfigFile, parseConfigString, parseMarkdownEntries, parseSessionMD, parseSessionWrites, readManifest, slugify, truncate, validateEntryId, writeManifest };

package/dist/index.js

@@ -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);
@@ -2609,9 +2614,7 @@ 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?.type.toUpperCase().includes("INTEGER")) {
-      db.exec(
-        'ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"'
-      );
+      db.exec('ALTER TABLE "__lattice_migrations" RENAME TO "__lattice_migrations_v1"');
     }
   }
 }
@@ -3031,6 +3034,66 @@ function applyWriteEntry(db, entry) {
     return { ok: false, reason: `DB error: ${message}` };
   }
 }
+
+// src/auto-update.ts
+import { execSync } from "child_process";
+import { readFileSync as readFileSync6 } from "fs";
+import { join as join7 } from "path";
+function getInstalledVersion(pkgName) {
+  try {
+    const pkgPath = join7(process.cwd(), "node_modules", pkgName, "package.json");
+    const pkg = JSON.parse(readFileSync6(pkgPath, "utf-8"));
+    return pkg.version;
+  } catch {
+    return null;
+  }
+}
+async function getLatestVersion(pkgName) {
+  try {
+    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();
+    return data.version;
+  } catch {
+    return null;
+  }
+}
+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++) {
+    if ((a[i] ?? 0) > (b[i] ?? 0)) return true;
+    if ((a[i] ?? 0) < (b[i] ?? 0)) return false;
+  }
+  return false;
+}
+async function autoUpdate(opts) {
+  const log = opts?.quiet ? () => {
+  } : console.log;
+  const result = { updated: false, packages: [], restartRequired: false };
+  const installed = getInstalledVersion("latticesql");
+  if (!installed) return result;
+  const latest = await getLatestVersion("latticesql");
+  if (!latest || !isNewer(latest, installed)) return result;
+  log(`[latticesql] Updating: latticesql@${installed} \u2192 ${latest}`);
+  try {
+    execSync(`npm install latticesql@${latest}`, {
+      cwd: process.cwd(),
+      stdio: opts?.quiet ? "ignore" : "inherit",
+      timeout: 6e4
+    });
+    result.updated = true;
+    result.restartRequired = true;
+    result.packages.push({ name: "latticesql", from: installed, to: latest });
+    log(`[latticesql] Updated successfully. Restart required.`);
+  } catch (err) {
+    console.error("[latticesql] Auto-update failed:", err);
+  }
+  return result;
+}
 export {
   DEFAULT_ENTRY_TYPES,
   DEFAULT_TYPE_ALIASES,
@@ -3038,6 +3101,7 @@ export {
   Lattice,
   READ_ONLY_HEADER,
   applyWriteEntry,
+  autoUpdate,
   contentHash,
   createReadOnlyHeader,
   createSQLiteStateStore,

package/package.json

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