@codelia/storage 0.1.3 → 0.1.12

package/dist/index.cjs

@@ -335,6 +335,7 @@ var SessionStateStoreImpl = class {
   db;
   schemaInit;
   onError;
+  lastDbUnavailableError;
   constructor(options = {}) {
     const paths = options.paths ?? resolveStoragePaths();
     this.legacyStateDir = resolveLegacyStateDir(paths);
@@ -347,8 +348,15 @@ var SessionStateStoreImpl = class {
     ]).then(() => {
     });
     this.onError = options.onError;
-    this.db = this.openDatabase();
+    this.db = null;
     this.schemaInit = null;
+    this.lastDbUnavailableError = null;
+  }
+  getOrCreateDb() {
+    if (!this.db) {
+      this.db = this.openDatabase();
+    }
+    return this.db;
   }
   resolveLegacyPath(sessionId) {
     return import_node_path3.default.join(this.legacyStateDir, `${sessionId}.json`);
@@ -415,19 +423,31 @@ var SessionStateStoreImpl = class {
   }
   async tryGetDb(action, detail) {
     try {
-      const db = await this.db;
+      const db = await this.getOrCreateDb();
       if (!this.schemaInit) {
         this.schemaInit = Promise.resolve().then(() => {
           this.initDatabaseSchema(db);
         });
       }
       await this.schemaInit;
+      this.lastDbUnavailableError = null;
       return db;
     } catch (error) {
+      this.db = null;
+      this.schemaInit = null;
+      this.lastDbUnavailableError = error;
       this.onError?.(error, { action: `${action}.db_unavailable`, detail });
       return null;
     }
   }
+  async requireDb(action, detail) {
+    const db = await this.tryGetDb(action, detail);
+    if (!db) {
+      const reason = this.lastDbUnavailableError ? `: ${String(this.lastDbUnavailableError)}` : "";
+      throw new Error(`Session index database unavailable${reason}`);
+    }
+    return db;
+  }
   async loadLegacy(sessionId) {
     try {
       const file = await import_node_fs3.promises.readFile(this.resolveLegacyPath(sessionId), "utf8");
@@ -468,7 +488,10 @@ var SessionStateStoreImpl = class {
     if (!row) return null;
     let messages;
     try {
-      const payload = await import_node_fs3.promises.readFile(this.resolveMessagePath(sessionId), "utf8");
+      const payload = await import_node_fs3.promises.readFile(
+        this.resolveMessagePath(sessionId),
+        "utf8"
+      );
       messages = deserializeMessages(payload);
     } catch (error) {
       if (error.code === "ENOENT") {
@@ -486,7 +509,10 @@ var SessionStateStoreImpl = class {
           meta = parsed;
         }
       } catch (error) {
-        this.onError?.(error, { action: "index.meta.parse", detail: sessionId });
+        this.onError?.(error, {
+          action: "index.meta.parse",
+          detail: sessionId
+        });
       }
     }
     return {
@@ -503,7 +529,10 @@ var SessionStateStoreImpl = class {
     const messagePayload = serializeMessages(
       Array.isArray(state.messages) ? state.messages : []
     );
-    await atomicWriteFile(this.resolveMessagePath(state.session_id), messagePayload);
+    await atomicWriteFile(
+      this.resolveMessagePath(state.session_id),
+      messagePayload
+    );
     const summary = toSummary(state);
     db.run(
       `INSERT INTO session_state (
@@ -537,74 +566,36 @@ var SessionStateStoreImpl = class {
       ]
     );
   }
-  async saveLegacy(state) {
-    const payload = `${JSON.stringify(state)}
-`;
-    await atomicWriteFile(this.resolveLegacyPath(state.session_id), payload);
-  }
-  async hasLegacySnapshot(sessionId) {
+  async load(sessionId) {
+    const db = await this.requireDb("load", sessionId);
     try {
-      const stat = await import_node_fs3.promises.stat(this.resolveLegacyPath(sessionId));
-      return stat.isFile();
+      const indexed = await this.loadFromIndex(sessionId, db);
+      if (indexed) return indexed;
     } catch (error) {
-      if (error.code === "ENOENT") {
-        return false;
-      }
+      this.onError?.(error, { action: "load.index", detail: sessionId });
       throw error;
     }
-  }
-  async saveLegacyIfPresent(state) {
-    if (!await this.hasLegacySnapshot(state.session_id)) {
-      return false;
-    }
-    await this.saveLegacy(state);
-    return true;
-  }
-  async load(sessionId) {
-    const db = await this.tryGetDb("load", sessionId);
-    if (db) {
-      try {
-        const indexed = await this.loadFromIndex(sessionId, db);
-        if (indexed) return indexed;
-      } catch (error) {
-        this.onError?.(error, { action: "load.index", detail: sessionId });
-        throw error;
-      }
-    }
     const legacy = await this.loadLegacy(sessionId);
     if (!legacy) return null;
     if (db) {
       try {
         await this.saveToIndex(legacy, db);
       } catch (error) {
-        this.onError?.(error, { action: "load.migrate_legacy", detail: sessionId });
+        this.onError?.(error, {
+          action: "load.migrate_legacy",
+          detail: sessionId
+        });
       }
     }
     return legacy;
   }
   async save(state) {
     await this.ensureDirs;
-    const db = await this.tryGetDb("save", state.session_id);
-    if (!db) {
-      const savedLegacy = await this.saveLegacyIfPresent(state);
-      if (savedLegacy) return;
-      throw new Error(
-        "Session index database unavailable and no legacy snapshot found"
-      );
-    }
+    const db = await this.requireDb("save", state.session_id);
     try {
       await this.saveToIndex(state, db);
     } catch (error) {
       this.onError?.(error, { action: "save.index", detail: state.session_id });
-      try {
-        const savedLegacy = await this.saveLegacyIfPresent(state);
-        if (savedLegacy) return;
-      } catch (legacyError) {
-        this.onError?.(legacyError, {
-          action: "save.legacy_fallback",
-          detail: state.session_id
-        });
-      }
       throw error;
     }
   }
@@ -645,20 +636,19 @@ var SessionStateStoreImpl = class {
   async list() {
     await this.ensureDirs;
     const summaries = /* @__PURE__ */ new Map();
-    const db = await this.tryGetDb("list");
-    if (db) {
-      try {
-        const rows = db.all(
-          `SELECT session_id, updated_at, run_id, message_count, last_user_message
-					 FROM session_state
-					 ORDER BY updated_at DESC`
-        );
-        for (const row of rows) {
-          summaries.set(row.session_id, fromSummaryRow(row));
-        }
-      } catch (error) {
-        this.onError?.(error, { action: "list.index" });
+    const db = await this.requireDb("list");
+    try {
+      const rows = db.all(
+        `SELECT session_id, updated_at, run_id, message_count, last_user_message
+				 FROM session_state
+				 ORDER BY updated_at DESC`
+      );
+      for (const row of rows) {
+        summaries.set(row.session_id, fromSummaryRow(row));
       }
+    } catch (error) {
+      this.onError?.(error, { action: "list.index" });
+      throw error;
     }
     const legacy = await this.listLegacySummaries();
     for (const item of legacy) {

package/dist/index.d.cts

@@ -44,21 +44,21 @@ declare class SessionStateStoreImpl implements SessionStateStore {
     private readonly messagesDir;
     private readonly stateDbPath;
     private readonly ensureDirs;
-    private readonly db;
+    private db;
     private schemaInit;
     private readonly onError?;
+    private lastDbUnavailableError;
     constructor(options?: SessionStateStoreOptions);
+    private getOrCreateDb;
     private resolveLegacyPath;
     private resolveMessagePath;
     private openDatabase;
     private initDatabaseSchema;
     private tryGetDb;
+    private requireDb;
     private loadLegacy;
     private loadFromIndex;
     private saveToIndex;
-    private saveLegacy;
-    private hasLegacySnapshot;
-    private saveLegacyIfPresent;
     load(sessionId: string): Promise<SessionState | null>;
     save(state: SessionState): Promise<void>;
     private listLegacySummaries;

package/dist/index.d.ts

@@ -44,21 +44,21 @@ declare class SessionStateStoreImpl implements SessionStateStore {
     private readonly messagesDir;
     private readonly stateDbPath;
     private readonly ensureDirs;
-    private readonly db;
+    private db;
     private schemaInit;
     private readonly onError?;
+    private lastDbUnavailableError;
     constructor(options?: SessionStateStoreOptions);
+    private getOrCreateDb;
     private resolveLegacyPath;
     private resolveMessagePath;
     private openDatabase;
     private initDatabaseSchema;
     private tryGetDb;
+    private requireDb;
     private loadLegacy;
     private loadFromIndex;
     private saveToIndex;
-    private saveLegacy;
-    private hasLegacySnapshot;
-    private saveLegacyIfPresent;
     load(sessionId: string): Promise<SessionState | null>;
     save(state: SessionState): Promise<void>;
     private listLegacySummaries;

package/dist/index.js

@@ -292,6 +292,7 @@ var SessionStateStoreImpl = class {
   db;
   schemaInit;
   onError;
+  lastDbUnavailableError;
   constructor(options = {}) {
     const paths = options.paths ?? resolveStoragePaths();
     this.legacyStateDir = resolveLegacyStateDir(paths);
@@ -304,8 +305,15 @@ var SessionStateStoreImpl = class {
     ]).then(() => {
     });
     this.onError = options.onError;
-    this.db = this.openDatabase();
+    this.db = null;
     this.schemaInit = null;
+    this.lastDbUnavailableError = null;
+  }
+  getOrCreateDb() {
+    if (!this.db) {
+      this.db = this.openDatabase();
+    }
+    return this.db;
   }
   resolveLegacyPath(sessionId) {
     return path3.join(this.legacyStateDir, `${sessionId}.json`);
@@ -372,19 +380,31 @@ var SessionStateStoreImpl = class {
   }
   async tryGetDb(action, detail) {
     try {
-      const db = await this.db;
+      const db = await this.getOrCreateDb();
       if (!this.schemaInit) {
         this.schemaInit = Promise.resolve().then(() => {
           this.initDatabaseSchema(db);
         });
       }
       await this.schemaInit;
+      this.lastDbUnavailableError = null;
       return db;
     } catch (error) {
+      this.db = null;
+      this.schemaInit = null;
+      this.lastDbUnavailableError = error;
       this.onError?.(error, { action: `${action}.db_unavailable`, detail });
       return null;
     }
   }
+  async requireDb(action, detail) {
+    const db = await this.tryGetDb(action, detail);
+    if (!db) {
+      const reason = this.lastDbUnavailableError ? `: ${String(this.lastDbUnavailableError)}` : "";
+      throw new Error(`Session index database unavailable${reason}`);
+    }
+    return db;
+  }
   async loadLegacy(sessionId) {
     try {
       const file = await fs3.readFile(this.resolveLegacyPath(sessionId), "utf8");
@@ -425,7 +445,10 @@ var SessionStateStoreImpl = class {
     if (!row) return null;
     let messages;
     try {
-      const payload = await fs3.readFile(this.resolveMessagePath(sessionId), "utf8");
+      const payload = await fs3.readFile(
+        this.resolveMessagePath(sessionId),
+        "utf8"
+      );
       messages = deserializeMessages(payload);
     } catch (error) {
       if (error.code === "ENOENT") {
@@ -443,7 +466,10 @@ var SessionStateStoreImpl = class {
           meta = parsed;
         }
       } catch (error) {
-        this.onError?.(error, { action: "index.meta.parse", detail: sessionId });
+        this.onError?.(error, {
+          action: "index.meta.parse",
+          detail: sessionId
+        });
       }
     }
     return {
@@ -460,7 +486,10 @@ var SessionStateStoreImpl = class {
     const messagePayload = serializeMessages(
       Array.isArray(state.messages) ? state.messages : []
     );
-    await atomicWriteFile(this.resolveMessagePath(state.session_id), messagePayload);
+    await atomicWriteFile(
+      this.resolveMessagePath(state.session_id),
+      messagePayload
+    );
     const summary = toSummary(state);
     db.run(
       `INSERT INTO session_state (
@@ -494,74 +523,36 @@ var SessionStateStoreImpl = class {
       ]
     );
   }
-  async saveLegacy(state) {
-    const payload = `${JSON.stringify(state)}
-`;
-    await atomicWriteFile(this.resolveLegacyPath(state.session_id), payload);
-  }
-  async hasLegacySnapshot(sessionId) {
+  async load(sessionId) {
+    const db = await this.requireDb("load", sessionId);
     try {
-      const stat = await fs3.stat(this.resolveLegacyPath(sessionId));
-      return stat.isFile();
+      const indexed = await this.loadFromIndex(sessionId, db);
+      if (indexed) return indexed;
     } catch (error) {
-      if (error.code === "ENOENT") {
-        return false;
-      }
+      this.onError?.(error, { action: "load.index", detail: sessionId });
       throw error;
     }
-  }
-  async saveLegacyIfPresent(state) {
-    if (!await this.hasLegacySnapshot(state.session_id)) {
-      return false;
-    }
-    await this.saveLegacy(state);
-    return true;
-  }
-  async load(sessionId) {
-    const db = await this.tryGetDb("load", sessionId);
-    if (db) {
-      try {
-        const indexed = await this.loadFromIndex(sessionId, db);
-        if (indexed) return indexed;
-      } catch (error) {
-        this.onError?.(error, { action: "load.index", detail: sessionId });
-        throw error;
-      }
-    }
     const legacy = await this.loadLegacy(sessionId);
     if (!legacy) return null;
     if (db) {
       try {
         await this.saveToIndex(legacy, db);
       } catch (error) {
-        this.onError?.(error, { action: "load.migrate_legacy", detail: sessionId });
+        this.onError?.(error, {
+          action: "load.migrate_legacy",
+          detail: sessionId
+        });
       }
     }
     return legacy;
   }
   async save(state) {
     await this.ensureDirs;
-    const db = await this.tryGetDb("save", state.session_id);
-    if (!db) {
-      const savedLegacy = await this.saveLegacyIfPresent(state);
-      if (savedLegacy) return;
-      throw new Error(
-        "Session index database unavailable and no legacy snapshot found"
-      );
-    }
+    const db = await this.requireDb("save", state.session_id);
     try {
       await this.saveToIndex(state, db);
     } catch (error) {
       this.onError?.(error, { action: "save.index", detail: state.session_id });
-      try {
-        const savedLegacy = await this.saveLegacyIfPresent(state);
-        if (savedLegacy) return;
-      } catch (legacyError) {
-        this.onError?.(legacyError, {
-          action: "save.legacy_fallback",
-          detail: state.session_id
-        });
-      }
       throw error;
     }
   }
@@ -602,20 +593,19 @@ var SessionStateStoreImpl = class {
   async list() {
     await this.ensureDirs;
     const summaries = /* @__PURE__ */ new Map();
-    const db = await this.tryGetDb("list");
-    if (db) {
-      try {
-        const rows = db.all(
-          `SELECT session_id, updated_at, run_id, message_count, last_user_message
-					 FROM session_state
-					 ORDER BY updated_at DESC`
-        );
-        for (const row of rows) {
-          summaries.set(row.session_id, fromSummaryRow(row));
-        }
-      } catch (error) {
-        this.onError?.(error, { action: "list.index" });
+    const db = await this.requireDb("list");
+    try {
+      const rows = db.all(
+        `SELECT session_id, updated_at, run_id, message_count, last_user_message
+				 FROM session_state
+				 ORDER BY updated_at DESC`
+      );
+      for (const row of rows) {
+        summaries.set(row.session_id, fromSummaryRow(row));
       }
+    } catch (error) {
+      this.onError?.(error, { action: "list.index" });
+      throw error;
     }
     const legacy = await this.listLegacySummaries();
     for (const item of legacy) {

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@codelia/storage",
-	"version": "0.1.3",
+	"version": "0.1.12",
 	"type": "module",
 	"engines": {
 		"node": ">=20 <25"
@@ -23,7 +23,7 @@
 		"typecheck": "tsc --noEmit"
 	},
 	"dependencies": {
-		"@codelia/core": "0.1.3",
+		"@codelia/core": "0.1.12",
 		"better-sqlite3": "^12.6.2"
 	},
 	"publishConfig": {