@breeztech/breez-sdk-spark 0.15.1 → 0.17.0

package/nodejs/{postgres-session-manager → postgres-session-store}/index.cjs

@@ -1,7 +1,7 @@
 /**
- * CommonJS implementation for Node.js PostgreSQL Session Manager.
+ * CommonJS implementation for Node.js PostgreSQL Session Store.
  *
- * Implements the JS-side `SessionManager` interface consumed by the Breez
+ * Implements the JS-side `SessionStore` interface consumed by the Breez
  * SDK WASM bindings: `getSession(serviceIdentityKey)` returns the cached
  * session for the (tenant, service) pair or `null` when not found, and
  * `setSession(serviceIdentityKey, session)` upserts a session.
@@ -29,10 +29,10 @@ try {
   }
 }
 
-const { SessionManagerError } = require("./errors.cjs");
-const { SessionManagerMigrationManager } = require("./migrations.cjs");
+const { SessionStoreError } = require("./errors.cjs");
+const { SessionStoreMigrationManager } = require("./migrations.cjs");
 
-class PostgresSessionManager {
+class PostgresSessionStore {
   /**
    * @param {import('pg').Pool} pool
    * @param {Buffer|Uint8Array} identity - 33-byte secp256k1 compressed pubkey
@@ -41,7 +41,7 @@ class PostgresSessionManager {
    */
   constructor(pool, identity, logger = null, runMigration = true) {
     if (!identity || identity.length !== 33) {
-      throw new SessionManagerError(
+      throw new SessionStoreError(
         "tenant identity (33-byte secp256k1 pubkey) is required"
       );
     }
@@ -54,13 +54,13 @@ class PostgresSessionManager {
   async initialize() {
     try {
       if (this.runMigration) {
-        const migrationManager = new SessionManagerMigrationManager(this.logger);
+        const migrationManager = new SessionStoreMigrationManager(this.logger);
         await migrationManager.migrate(this.pool);
       }
       return this;
     } catch (error) {
-      throw new SessionManagerError(
-        `Failed to initialize PostgreSQL session manager: ${error.message}`,
+      throw new SessionStoreError(
+        `Failed to initialize PostgreSQL session store: ${error.message}`,
         error
       );
     }
@@ -76,7 +76,7 @@ class PostgresSessionManager {
   /**
    * Returns the cached session for the given service identity key, or `null`
    * if no session is cached. The Rust adapter maps `null` to
-   * `SessionManagerError::NotFound`.
+   * `SessionStoreError::NotFound`.
    * @param {string} serviceIdentityKey - hex-encoded 33-byte secp256k1 pubkey
    * @returns {Promise<{token: string, expiration: number} | null>}
    */
@@ -97,7 +97,7 @@ class PostgresSessionManager {
         expiration: Number(row.expiration),
       };
     } catch (error) {
-      throw new SessionManagerError(
+      throw new SessionStoreError(
         `Failed to read session: ${error.message}`,
         error
       );
@@ -120,7 +120,7 @@ class PostgresSessionManager {
         [this.identity, serviceKey, session.token, session.expiration]
       );
     } catch (error) {
-      throw new SessionManagerError(
+      throw new SessionStoreError(
         `Failed to write session: ${error.message}`,
         error
       );
@@ -130,7 +130,7 @@ class PostgresSessionManager {
 
 function _decodePubkey(hex) {
   if (typeof hex !== "string" || hex.length !== 66) {
-    throw new SessionManagerError(
+    throw new SessionStoreError(
       "service_identity_key must be a 66-character hex-encoded 33-byte pubkey"
     );
   }
@@ -139,13 +139,13 @@ function _decodePubkey(hex) {
 
 /**
  * Convenience factory: creates a pool from a Pool config and returns an
- * initialized `PostgresSessionManager`. Most callers should use
- * `createPostgresSessionManagerWithPool` instead so the pool can be shared
+ * initialized `PostgresSessionStore`. Most callers should use
+ * `createPostgresSessionStoreWithPool` instead so the pool can be shared
  * across stores.
  */
-async function createPostgresSessionManager(poolConfig, identity, logger = null) {
+async function createPostgresSessionStore(poolConfig, identity, logger = null) {
   const pool = new pg.Pool(poolConfig);
-  const manager = new PostgresSessionManager(
+  const manager = new PostgresSessionStore(
     pool,
     identity,
     logger,
@@ -159,13 +159,13 @@ async function createPostgresSessionManager(poolConfig, identity, logger = null)
  * Wraps an existing pool — useful when sharing the pool with the storage,
  * tree store, and token store implementations.
  */
-async function createPostgresSessionManagerWithPool(
+async function createPostgresSessionStoreWithPool(
   pool,
   identity,
   logger = null,
   runMigration = true
 ) {
-  const manager = new PostgresSessionManager(
+  const manager = new PostgresSessionStore(
     pool,
     identity,
     logger,
@@ -176,8 +176,8 @@ async function createPostgresSessionManagerWithPool(
 }
 
 module.exports = {
-  PostgresSessionManager,
-  createPostgresSessionManager,
-  createPostgresSessionManagerWithPool,
-  SessionManagerError,
+  PostgresSessionStore,
+  createPostgresSessionStore,
+  createPostgresSessionStoreWithPool,
+  SessionStoreError,
 };

package/nodejs/{postgres-session-manager → postgres-session-store}/migrations.cjs

@@ -1,22 +1,22 @@
 /**
- * Database Migration Manager for Breez SDK PostgreSQL Session Manager.
+ * Database Migration Manager for Breez SDK PostgreSQL Session Store.
  *
  * Uses a brz_session_schema_migrations table + pg_advisory_xact_lock to safely
  * run migrations from concurrent processes. Mirrors the schema produced by
- * the Rust `PostgresSessionManager`.
+ * the Rust `PostgresSessionStore`.
  */
 
-const { SessionManagerError } = require("./errors.cjs");
+const { SessionStoreError } = require("./errors.cjs");
 
 /**
- * Advisory lock ID for session-manager migrations.
+ * Advisory lock ID for session-store migrations.
  * Uses a different lock ID from the storage / tree store / token store
  * migrations to avoid contention. Derived from ASCII bytes of "SESN"
  * (0x5345534E).
  */
 const MIGRATION_LOCK_ID = "1397245774"; // 0x5345534E as decimal string
 
-class SessionManagerMigrationManager {
+class SessionStoreMigrationManager {
   constructor(logger = null) {
     this.logger = logger;
   }
@@ -51,7 +51,7 @@ class SessionManagerMigrationManager {
       if (currentVersion >= migrations.length) {
         this._log(
           "info",
-          `Session manager database is up to date (version ${currentVersion})`
+          `Session store database is up to date (version ${currentVersion})`
         );
         await client.query("COMMIT");
         return;
@@ -59,7 +59,7 @@ class SessionManagerMigrationManager {
 
       this._log(
         "info",
-        `Migrating session manager database from version ${currentVersion} to ${migrations.length}`
+        `Migrating session store database from version ${currentVersion} to ${migrations.length}`
       );
 
       for (let i = currentVersion; i < migrations.length; i++) {
@@ -67,7 +67,7 @@ class SessionManagerMigrationManager {
         const version = i + 1;
         this._log(
           "debug",
-          `Running session manager migration ${version}: ${migration.name}`
+          `Running session store migration ${version}: ${migration.name}`
         );
 
         for (const sql of migration.sql) {
@@ -83,12 +83,12 @@ class SessionManagerMigrationManager {
       await client.query("COMMIT");
       this._log(
         "info",
-        "Session manager database migration completed successfully"
+        "Session store database migration completed successfully"
       );
     } catch (error) {
       await client.query("ROLLBACK").catch(() => {});
-      throw new SessionManagerError(
-        `Session manager migration failed: ${error.message}`,
+      throw new SessionStoreError(
+        `Session store migration failed: ${error.message}`,
         error
       );
     } finally {
@@ -137,12 +137,12 @@ class SessionManagerMigrationManager {
     if (this.logger && typeof this.logger.log === "function") {
       this.logger.log({ line: message, level });
     } else if (level === "error") {
-      console.error(`[SessionManagerMigrationManager] ${message}`);
+      console.error(`[SessionStoreMigrationManager] ${message}`);
     }
   }
 
   /**
-   * Migrations matching the Rust PostgresSessionManager schema exactly.
+   * Migrations matching the Rust PostgresSessionStore schema exactly.
    */
   _getMigrations() {
     return [
@@ -162,4 +162,4 @@ class SessionManagerMigrationManager {
   }
 }
 
-module.exports = { SessionManagerMigrationManager };
+module.exports = { SessionStoreMigrationManager };

package/nodejs/postgres-session-store/package.json

@@ -0,0 +1,9 @@
+{
+  "dependencies": {
+    "pg": "^8.18.0"
+  },
+  "description": "Node.js PostgreSQL session store implementation for Breez SDK WASM (CommonJS)",
+  "main": "index.cjs",
+  "name": "@breez-sdk/postgres-session-store",
+  "version": "1.0.0"
+}