@converse/skeletor 3.1.5 → 3.1.6

package/CHANGES.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 3.1.6 (2026-08-06)
+
+- The `'node'` store type can now be told where to put its database files, via the new
+  `PersistentStorage.nodeStorageDir`. The driver has always taken a `storageDir` argument,
+  but nothing could reach it through the string store type, so `new PersistentStorage(id, 'node')`
+  was stuck with the driver's default. That default is relative, so it resolves against
+  `process.cwd()` and an app started from two directories keeps two separate sets of state.
+  Set an absolute path (`$XDG_STATE_HOME/<app>`, say) to pin it. The default is unchanged.
+
+- Ship a separate `dist/skeletor.node.d.ts` for the `@converse/skeletor/node` entry point.
+  Both entry points pointed their `types` at the browser rollup.
+
 ## 3.1.5 (2026-07-22)
 
 - Fix every write through the Node.js SQLite driver failing with `Record Not Found` while

package/dist/skeletor.d.ts

@@ -762,8 +762,9 @@ export declare function noConflict(): any;
 /**
  * Constructor for a Node.js-only storage driver. Registered by the
  * `@converse/skeletor/node` entry point via {@link PersistentStorage.nodeStorage}.
+ * @public
  */
-declare type NodeStorageConstructor = new (name: string) => StorageDriver;
+export declare type NodeStorageConstructor = new (name: string, storageDir?: string, inMemory?: boolean) => StorageDriver;
 
 /**
  * @public
@@ -795,6 +796,18 @@ export declare class PersistentStorage {
     static sessionStorageInitialized: Promise<void>;
     static localForage: typeof localForage;
     static nodeStorage: NodeStorageConstructor | null;
+    /**
+     * Directory the `'node'` store type writes its database files to. The driver's
+     * own default is relative, so it resolves against `process.cwd()` and a process
+     * started from two directories ends up with two separate sets of state. Set an
+     * absolute path (`$XDG_STATE_HOME/<app>`, say) to pin it. Left `null`, the
+     * driver's default applies.
+     *
+     * Only the `'node'` string store type reads this; passing a driver instance to
+     * the constructor means you've already chosen a directory yourself.
+     * @public
+     */
+    static nodeStorageDir: string | null;
     /** Register a storage instance with a weak reference. @public */
     static register(instance: PersistentStorage): void;
     /**

package/dist/skeletor.esm.js

@@ -8699,7 +8699,7 @@ class PersistentStorage {
                 throw new Error("Skeletor.storage: the 'node' storage type is only available in Node.js builds. " +
                     "Import from '@converse/skeletor/node' instead of '@converse/skeletor'.");
             }
-            this.store = new NodeSQLiteStorage(this.name);
+            this.store = new NodeSQLiteStorage(this.name, PersistentStorage.nodeStorageDir ?? undefined);
             if (batchedWrites) {
                 this.store.debouncedSetItems = mergebounce((items) => this.store.setItems(items), 50, {
                     'promise': true,
@@ -8903,6 +8903,18 @@ class PersistentStorage {
 // node-only driver (and its `node:sqlite` import) never enters the browser
 // bundle; the `@converse/skeletor/node` entry sets it.
 PersistentStorage.nodeStorage = null;
+/**
+ * Directory the `'node'` store type writes its database files to. The driver's
+ * own default is relative, so it resolves against `process.cwd()` and a process
+ * started from two directories ends up with two separate sets of state. Set an
+ * absolute path (`$XDG_STATE_HOME/<app>`, say) to pin it. Left `null`, the
+ * driver's default applies.
+ *
+ * Only the `'node'` string store type reads this; passing a driver instance to
+ * the constructor means you've already chosen a directory yourself.
+ * @public
+ */
+PersistentStorage.nodeStorageDir = null;
 PersistentStorage.sessionStorageInitialized = localForage.defineDriver(sessionStorageWrapper);
 PersistentStorage.localForage = localForage;