@axiom-lattice/local-stores 1.0.15 → 1.0.16

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @axiom-lattice/local-stores@1.0.15 build /home/runner/work/agentic/agentic/packages/local-stores
+> @axiom-lattice/local-stores@1.0.16 build /home/runner/work/agentic/agentic/packages/local-stores
 > tsup src/index.ts --format cjs,esm --dts --sourcemap
 
 CLI Building entry: src/index.ts
@@ -8,13 +8,13 @@
 CLI Target: es2020
 CJS Build start
 ESM Build start
-CJS dist/index.js     116.80 KB
-CJS dist/index.js.map 217.12 KB
-CJS ⚡️ Build success in 449ms
-ESM dist/index.mjs     113.57 KB
-ESM dist/index.mjs.map 214.66 KB
-ESM ⚡️ Build success in 464ms
+ESM dist/index.mjs     116.68 KB
+ESM dist/index.mjs.map 221.36 KB
+ESM ⚡️ Build success in 429ms
+CJS dist/index.js     119.95 KB
+CJS dist/index.js.map 223.95 KB
+CJS ⚡️ Build success in 433ms
 DTS Build start
-DTS ⚡️ Build success in 15572ms
-DTS dist/index.d.ts  24.92 KB
-DTS dist/index.d.mts 24.92 KB
+DTS ⚡️ Build success in 16180ms
+DTS dist/index.d.ts  26.92 KB
+DTS dist/index.d.mts 26.92 KB

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @axiom-lattice/local-stores
 
+## 1.0.16
+
+### Patch Changes
+
+- 2954442: fix issue
+- Updated dependencies [2954442]
+  - @axiom-lattice/core@2.1.94
+  - @axiom-lattice/protocols@2.1.48
+
 ## 1.0.15
 
 ### Patch Changes

package/dist/index.d.mts

@@ -119,6 +119,74 @@ declare function nowISO(): string;
  */
 declare function parseISO(iso: string): Date;
 
+/**
+ * Migration system for SQLite (sql.js) local stores.
+ *
+ * ## Identity vs Ordering
+ *
+ * **name = identity** — each migration is uniquely identified by its name
+ * within a store. Two stores may use the same name without conflict because
+ * the tracking table includes a `store_name` column.
+ *
+ * **version = ordering** — migrations are applied in ascending version order.
+ *
+ * ## Usage
+ *
+ * Each store creates its own MigrationManager with a unique store name:
+ *
+ * ```ts
+ * const mm = new MigrationManager(db, "lt_threads");
+ * mm.register({ version: 1, name: "create_table", up: (db) => { db.exec(DDL); } });
+ * mm.register({ version: 2, name: "add_column_x", up: (db) => { db.exec(ALTER); } });
+ * mm.migrate();
+ * ```
+ *
+ * @remarks
+ * - All methods are synchronous (SQLite via sql.js is single-threaded)
+ * - Duplicate **names** within the same store are rejected at registration time
+ * - Duplicate **versions** are allowed (same positioning, different tables)
+ */
+
+/**
+ * Migration definition
+ */
+interface Migration {
+    version: number;
+    name: string;
+    up: (db: DatabaseWrapper) => void;
+    down?: (db: DatabaseWrapper) => void;
+}
+/**
+ * Migration manager — one per store.
+ * Each store manages its own independent migration namespace via `storeName`.
+ */
+declare class MigrationManager {
+    private db;
+    private storeName;
+    private migrations;
+    constructor(db: DatabaseWrapper, storeName: string);
+    /**
+     * Register a migration.
+     * Duplicate names within this store are rejected immediately.
+     * Duplicate versions are allowed.
+     */
+    register(migration: Migration): void;
+    /**
+     * Apply all pending migrations in version order.
+     */
+    migrate(): void;
+    /**
+     * Rollback the last-applied migration (highest version) for this store.
+     */
+    rollback(): void;
+    /**
+     * Get the highest applied migration version for this store.
+     */
+    getCurrentVersion(): number;
+    private ensureTrackingTable;
+    private getAppliedNames;
+}
+
 /**
  * Local SQLite implementation of ThreadStore.
  */
@@ -566,4 +634,4 @@ declare function createLocalStoreConfig(options?: LocalStoreConfigOptions): Prom
     checkpoint: SqliteSaver;
 }>;
 
-export { DatabaseWrapper, LocalA2AApiKeyStore, LocalAssistantStore, LocalChannelBindingStore, LocalChannelInstallationStore, LocalDatabaseConfigStore, LocalEvalStore, LocalMcpServerConfigStore, LocalMetricsServerConfigStore, LocalProjectStore, LocalScheduleStorage, LocalSkillStore, type LocalStoreConfigOptions, type LocalStoreOptions, LocalTaskStore, LocalTenantStore, LocalThreadMessageQueueStore, LocalThreadStore, LocalUserStore, LocalUserTenantLinkStore, LocalWorkflowTrackingStore, LocalWorkspaceStore, RunResult, StatementWrapper, closeDatabase, createLocalStoreConfig, ensureTable, getDatabase, initDatabase, nowISO, parseISO };
+export { DatabaseWrapper, LocalA2AApiKeyStore, LocalAssistantStore, LocalChannelBindingStore, LocalChannelInstallationStore, LocalDatabaseConfigStore, LocalEvalStore, LocalMcpServerConfigStore, LocalMetricsServerConfigStore, LocalProjectStore, LocalScheduleStorage, LocalSkillStore, type LocalStoreConfigOptions, type LocalStoreOptions, LocalTaskStore, LocalTenantStore, LocalThreadMessageQueueStore, LocalThreadStore, LocalUserStore, LocalUserTenantLinkStore, LocalWorkflowTrackingStore, LocalWorkspaceStore, type Migration, MigrationManager, RunResult, StatementWrapper, closeDatabase, createLocalStoreConfig, ensureTable, getDatabase, initDatabase, nowISO, parseISO };

package/dist/index.d.ts

@@ -119,6 +119,74 @@ declare function nowISO(): string;
  */
 declare function parseISO(iso: string): Date;
 
+/**
+ * Migration system for SQLite (sql.js) local stores.
+ *
+ * ## Identity vs Ordering
+ *
+ * **name = identity** — each migration is uniquely identified by its name
+ * within a store. Two stores may use the same name without conflict because
+ * the tracking table includes a `store_name` column.
+ *
+ * **version = ordering** — migrations are applied in ascending version order.
+ *
+ * ## Usage
+ *
+ * Each store creates its own MigrationManager with a unique store name:
+ *
+ * ```ts
+ * const mm = new MigrationManager(db, "lt_threads");
+ * mm.register({ version: 1, name: "create_table", up: (db) => { db.exec(DDL); } });
+ * mm.register({ version: 2, name: "add_column_x", up: (db) => { db.exec(ALTER); } });
+ * mm.migrate();
+ * ```
+ *
+ * @remarks
+ * - All methods are synchronous (SQLite via sql.js is single-threaded)
+ * - Duplicate **names** within the same store are rejected at registration time
+ * - Duplicate **versions** are allowed (same positioning, different tables)
+ */
+
+/**
+ * Migration definition
+ */
+interface Migration {
+    version: number;
+    name: string;
+    up: (db: DatabaseWrapper) => void;
+    down?: (db: DatabaseWrapper) => void;
+}
+/**
+ * Migration manager — one per store.
+ * Each store manages its own independent migration namespace via `storeName`.
+ */
+declare class MigrationManager {
+    private db;
+    private storeName;
+    private migrations;
+    constructor(db: DatabaseWrapper, storeName: string);
+    /**
+     * Register a migration.
+     * Duplicate names within this store are rejected immediately.
+     * Duplicate versions are allowed.
+     */
+    register(migration: Migration): void;
+    /**
+     * Apply all pending migrations in version order.
+     */
+    migrate(): void;
+    /**
+     * Rollback the last-applied migration (highest version) for this store.
+     */
+    rollback(): void;
+    /**
+     * Get the highest applied migration version for this store.
+     */
+    getCurrentVersion(): number;
+    private ensureTrackingTable;
+    private getAppliedNames;
+}
+
 /**
  * Local SQLite implementation of ThreadStore.
  */
@@ -566,4 +634,4 @@ declare function createLocalStoreConfig(options?: LocalStoreConfigOptions): Prom
     checkpoint: SqliteSaver;
 }>;
 
-export { DatabaseWrapper, LocalA2AApiKeyStore, LocalAssistantStore, LocalChannelBindingStore, LocalChannelInstallationStore, LocalDatabaseConfigStore, LocalEvalStore, LocalMcpServerConfigStore, LocalMetricsServerConfigStore, LocalProjectStore, LocalScheduleStorage, LocalSkillStore, type LocalStoreConfigOptions, type LocalStoreOptions, LocalTaskStore, LocalTenantStore, LocalThreadMessageQueueStore, LocalThreadStore, LocalUserStore, LocalUserTenantLinkStore, LocalWorkflowTrackingStore, LocalWorkspaceStore, RunResult, StatementWrapper, closeDatabase, createLocalStoreConfig, ensureTable, getDatabase, initDatabase, nowISO, parseISO };
+export { DatabaseWrapper, LocalA2AApiKeyStore, LocalAssistantStore, LocalChannelBindingStore, LocalChannelInstallationStore, LocalDatabaseConfigStore, LocalEvalStore, LocalMcpServerConfigStore, LocalMetricsServerConfigStore, LocalProjectStore, LocalScheduleStorage, LocalSkillStore, type LocalStoreConfigOptions, type LocalStoreOptions, LocalTaskStore, LocalTenantStore, LocalThreadMessageQueueStore, LocalThreadStore, LocalUserStore, LocalUserTenantLinkStore, LocalWorkflowTrackingStore, LocalWorkspaceStore, type Migration, MigrationManager, RunResult, StatementWrapper, closeDatabase, createLocalStoreConfig, ensureTable, getDatabase, initDatabase, nowISO, parseISO };

package/dist/index.js

@@ -50,6 +50,7 @@ __export(index_exports, {
   LocalUserTenantLinkStore: () => LocalUserTenantLinkStore,
   LocalWorkflowTrackingStore: () => LocalWorkflowTrackingStore,
   LocalWorkspaceStore: () => LocalWorkspaceStore,
+  MigrationManager: () => MigrationManager,
   RunResult: () => RunResult,
   StatementWrapper: () => StatementWrapper,
   closeDatabase: () => closeDatabase,
@@ -232,10 +233,103 @@ function parseISO(iso) {
   return new Date(iso);
 }
 
+// src/migrations/migration.ts
+var MigrationManager = class {
+  constructor(db, storeName) {
+    this.migrations = [];
+    this.db = db;
+    this.storeName = storeName;
+    this.ensureTrackingTable();
+  }
+  /**
+   * Register a migration.
+   * Duplicate names within this store are rejected immediately.
+   * Duplicate versions are allowed.
+   */
+  register(migration) {
+    const existing = this.migrations.find((m) => m.name === migration.name);
+    if (existing) {
+      throw new Error(
+        `[${this.storeName}] Migration name conflict: "${migration.name}" v${migration.version} collides with existing registration at v${existing.version}`
+      );
+    }
+    this.migrations.push(migration);
+    this.migrations.sort((a, b) => a.version - b.version);
+  }
+  /**
+   * Apply all pending migrations in version order.
+   */
+  migrate() {
+    const appliedNames = this.getAppliedNames();
+    const pending = this.migrations.filter((m) => !appliedNames.has(m.name));
+    if (pending.length === 0) return;
+    for (const m of pending) {
+      m.up(this.db);
+      this.db.run(
+        `INSERT INTO lattice_schema_migrations (store_name, name, version, applied_at)
+         VALUES (?, ?, ?, ?)`,
+        [this.storeName, m.name, m.version, (/* @__PURE__ */ new Date()).toISOString()]
+      );
+    }
+  }
+  /**
+   * Rollback the last-applied migration (highest version) for this store.
+   */
+  rollback() {
+    const row = this.db.prepare(
+      `SELECT name, version FROM lattice_schema_migrations
+         WHERE store_name = ? ORDER BY version DESC LIMIT 1`
+    ).get(this.storeName);
+    if (!row) {
+      throw new Error(`[${this.storeName}] No migrations to rollback`);
+    }
+    const migration = this.migrations.find((m) => m.name === row.name);
+    if (!migration?.down) {
+      throw new Error(
+        `[${this.storeName}] Migration "${row.name}" (v${row.version}) has no down migration`
+      );
+    }
+    migration.down(this.db);
+    this.db.run(
+      `DELETE FROM lattice_schema_migrations WHERE store_name = ? AND name = ?`,
+      [this.storeName, row.name]
+    );
+  }
+  /**
+   * Get the highest applied migration version for this store.
+   */
+  getCurrentVersion() {
+    const row = this.db.prepare(
+      `SELECT COALESCE(MAX(version), 0) AS max FROM lattice_schema_migrations
+         WHERE store_name = ?`
+    ).get(this.storeName);
+    return row?.max ?? 0;
+  }
+  // ── private ────────────────────────────────────────────────
+  ensureTrackingTable() {
+    this.db.exec(`
+      CREATE TABLE IF NOT EXISTS lattice_schema_migrations (
+        store_name TEXT NOT NULL,
+        name TEXT NOT NULL,
+        version INTEGER NOT NULL,
+        applied_at TEXT NOT NULL,
+        PRIMARY KEY (store_name, name)
+      )
+    `);
+  }
+  getAppliedNames() {
+    const rows = this.db.prepare(
+      `SELECT name FROM lattice_schema_migrations WHERE store_name = ? ORDER BY version`
+    ).all(this.storeName);
+    return new Set(rows.map((r) => r.name));
+  }
+};
+
 // src/createLocalStoreConfig.ts
 var import_langgraph_checkpoint_sqlite = require("@langchain/langgraph-checkpoint-sqlite");
 
 // src/stores/LocalThreadStore.ts
+var STORE_NAME = "lt_threads";
 var DDL = `
 CREATE TABLE IF NOT EXISTS lt_threads (
   id TEXT NOT NULL,
@@ -251,7 +345,15 @@ CREATE INDEX IF NOT EXISTS idx_lt_threads_assistant ON lt_threads(tenant_id, ass
 var LocalThreadStore = class {
   constructor(db) {
     this.db = db;
-    ensureTable(db, DDL);
+    const mm = new MigrationManager(db, STORE_NAME);
+    mm.register({
+      version: 1,
+      name: "create_lt_threads",
+      up: (d) => {
+        d.exec(DDL);
+      }
+    });
+    mm.migrate();
   }
   async getThreadsByAssistantId(tenantId, assistantId, metadataFilter) {
     const rows = this.db.prepare(
@@ -3613,6 +3715,7 @@ async function createLocalStoreConfig(options = {}) {
   LocalUserTenantLinkStore,
   LocalWorkflowTrackingStore,
   LocalWorkspaceStore,
+  MigrationManager,
   RunResult,
   StatementWrapper,
   closeDatabase,