@serfab/quereus-plugin-sereus 0.8.0

package/dist/connect-browser.js

@@ -0,0 +1,45 @@
+import cryptoPlugin from '@optimystic/quereus-plugin-crypto/plugin';
+import { createLibp2pNode } from '@optimystic/db-p2p/rn';
+import { webSockets } from '@libp2p/websockets';
+import { circuitRelayTransport } from '@libp2p/circuit-relay-v2';
+import { IndexedDBRawStorage, openOptimysticWebDb } from '@optimystic/db-p2p-storage-web';
+import { composeStrand, applyRegistrations } from './compose-strand.js';
+/**
+ * Connect a Quereus Database to a Sereus strand from a browser/worker.
+ *
+ * Thin adapter over the shared {@link composeStrand} composition, supplying the
+ * browser platform seams:
+ *  - crypto registered inline (no runtime `@quereus/quereus` import, so the
+ *    bundle does not duplicate the host's instance),
+ *  - storage defaulting to `IndexedDBRawStorage` keyed by `sereus-strand-<id>`,
+ *  - a node created via the TCP-free `@optimystic/db-p2p/rn` entry with explicit
+ *    `webSockets()` + `circuitRelayTransport()` transports.
+ */
+export async function connectToStrandBrowser(db, options) {
+    return composeStrand(db, options, {
+        registerCrypto(database) {
+            applyRegistrations(database, cryptoPlugin(database, {}));
+        },
+        async resolveStorage({ strandId, resolvedTransactor, requestedStorage }) {
+            if (requestedStorage)
+                return requestedStorage;
+            // Browsers always default to IndexedDB so a reload survives; the
+            // unit-test fake transactor needs no storage.
+            if (resolvedTransactor === 'test')
+                return undefined;
+            const dbHandle = await openOptimysticWebDb(`sereus-strand-${strandId}`);
+            return new IndexedDBRawStorage(dbHandle);
+        },
+        async createNode({ networkName, bootstrapNodes, fretProfile, storage }) {
+            return createLibp2pNode({
+                transports: [webSockets(), circuitRelayTransport()],
+                listenAddrs: [],
+                bootstrapNodes,
+                networkName,
+                fretProfile,
+                ...(storage && { storage }),
+            });
+        },
+    });
+}
+//# sourceMappingURL=connect-browser.js.map

package/dist/connect-browser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect-browser.js","sourceRoot":"","sources":["../src/connect-browser.ts"],"names":[],"mappings":"AACA,OAAO,YAAY,MAAM,0CAA0C,CAAC;AACpE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,0BAA0B,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1F,OAAO,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AASxE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC3C,EAAY,EACZ,OAAgC;IAEhC,OAAO,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE;QACjC,cAAc,CAAC,QAAQ;YACtB,kBAAkB,CAAC,QAAQ,EAAE,YAAY,CAAC,QAAQ,EAAE,EAAE,CAAuB,CAAC,CAAC;QAChF,CAAC;QACD,KAAK,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,kBAAkB,EAAE,gBAAgB,EAAE;YACtE,IAAI,gBAAgB;gBAAE,OAAO,gBAAgB,CAAC;YAC9C,iEAAiE;YACjE,8CAA8C;YAC9C,IAAI,kBAAkB,KAAK,MAAM;gBAAE,OAAO,SAAS,CAAC;YACpD,MAAM,QAAQ,GAAG,MAAM,mBAAmB,CAAC,iBAAiB,QAAQ,EAAE,CAAC,CAAC;YACxE,OAAO,IAAI,mBAAmB,CAAC,QAAQ,CAAC,CAAC;QAC1C,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,OAAO,EAAE;YACrE,OAAO,gBAAgB,CAAC;gBACvB,UAAU,EAAE,CAAC,UAAU,EAAE,EAAE,qBAAqB,EAAE,CAAC;gBACnD,WAAW,EAAE,EAAE;gBACf,cAAc;gBACd,WAAW;gBACX,WAAW;gBACX,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC3B,CAAoB,CAAC;QACvB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/connect.d.ts

@@ -0,0 +1,10 @@
+import type { Database } from '@quereus/quereus';
+import type { StrandConnectionOptions, SereusPluginResult } from './types.js';
+/**
+ * Connect a Quereus Database to a Sereus strand (Node).
+ *
+ * Thin adapter over the shared {@link composeStrand} composition, supplying the
+ * Node platform seams: crypto via `@quereus/quereus`'s `registerPlugin`, and a
+ * TCP libp2p node created (only when not injected) via `@optimystic/db-p2p`.
+ */
+export declare function connectToStrand(db: Database, options: StrandConnectionOptions): Promise<SereusPluginResult>;

package/dist/connect.js

@@ -0,0 +1,31 @@
+import { registerPlugin } from '@quereus/quereus';
+import cryptoPlugin from '@optimystic/quereus-plugin-crypto/plugin';
+import { composeStrand } from './compose-strand.js';
+/**
+ * Connect a Quereus Database to a Sereus strand (Node).
+ *
+ * Thin adapter over the shared {@link composeStrand} composition, supplying the
+ * Node platform seams: crypto via `@quereus/quereus`'s `registerPlugin`, and a
+ * TCP libp2p node created (only when not injected) via `@optimystic/db-p2p`.
+ */
+export async function connectToStrand(db, options) {
+    return composeStrand(db, options, {
+        async registerCrypto(database) {
+            await registerPlugin(database, cryptoPlugin);
+        },
+        async createNode({ networkName, bootstrapNodes, fretProfile, port, storage }) {
+            // Dynamically import to keep the module cross-platform friendly: this
+            // pulls the Node-only `@optimystic/db-p2p` (TCP) entry, and is only
+            // reached when actually creating a node (never for injected nodes).
+            const { createLibp2pNode } = await import('@optimystic/db-p2p');
+            return createLibp2pNode({
+                port,
+                bootstrapNodes,
+                networkName,
+                fretProfile,
+                ...(storage && { storage }),
+            });
+        },
+    });
+}
+//# sourceMappingURL=connect.js.map

package/dist/connect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"connect.js","sourceRoot":"","sources":["../src/connect.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAClD,OAAO,YAAY,MAAM,0CAA0C,CAAC;AAGpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACpC,EAAY,EACZ,OAAgC;IAEhC,OAAO,aAAa,CAAC,EAAE,EAAE,OAAO,EAAE;QACjC,KAAK,CAAC,cAAc,CAAC,QAAQ;YAC5B,MAAM,cAAc,CAAC,QAAQ,EAAE,YAAY,CAAC,CAAC;QAC9C,CAAC;QACD,KAAK,CAAC,UAAU,CAAC,EAAE,WAAW,EAAE,cAAc,EAAE,WAAW,EAAE,IAAI,EAAE,OAAO,EAAE;YAC3E,sEAAsE;YACtE,oEAAoE;YACpE,oEAAoE;YACpE,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,MAAM,CAAC,oBAAoB,CAAC,CAAC;YAChE,OAAO,gBAAgB,CAAC;gBACvB,IAAI;gBACJ,cAAc;gBACd,WAAW;gBACX,WAAW;gBACX,GAAG,CAAC,OAAO,IAAI,EAAE,OAAO,EAAE,CAAC;aAC3B,CAAoB,CAAC;QACvB,CAAC;KACD,CAAC,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { connectToStrand } from './connect.js';
+export type { StrandConnectionOptions, SereusPluginResult } from './types.js';

package/dist/index.js

@@ -0,0 +1,2 @@
+export { connectToStrand } from './connect.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC"}

package/dist/parse-config.d.ts

@@ -0,0 +1,7 @@
+import type { SqlValue } from '@quereus/quereus';
+import type { StrandConnectionOptions } from './types.js';
+/**
+ * Parse the plugin-loader SqlValue config into typed StrandConnectionOptions.
+ * Shared by the Node (`plugin.ts`) and browser (`plugin-browser.ts`) entries.
+ */
+export declare function parseConfig(config: Record<string, SqlValue>): StrandConnectionOptions;

package/dist/parse-config.js

@@ -0,0 +1,47 @@
+/**
+ * Parse the plugin-loader SqlValue config into typed StrandConnectionOptions.
+ * Shared by the Node (`plugin.ts`) and browser (`plugin-browser.ts`) entries.
+ */
+export function parseConfig(config) {
+    const strandId = config.strand_id;
+    if (typeof strandId !== 'string' || !strandId) {
+        throw new Error('quereus-plugin-sereus: strand_id is required');
+    }
+    const bootstrapNodesRaw = config.bootstrap_nodes;
+    const bootstrapNodes = typeof bootstrapNodesRaw === 'string' && bootstrapNodesRaw
+        ? bootstrapNodesRaw.split(',').map(s => s.trim()).filter(Boolean)
+        : [];
+    const schema = typeof config.schema === 'string' ? config.schema : undefined;
+    const sAppId = typeof config.sapp_id === 'string' ? config.sapp_id : 'unknown';
+    const sAppVersion = typeof config.sapp_version === 'string' ? config.sapp_version : '1.0.0';
+    const port = typeof config.port === 'number' ? config.port : 0;
+    const enableCache = config.enable_cache !== false && config.enable_cache !== 0;
+    const fretProfile = config.fret_profile === 'core' ? 'core' : 'edge';
+    // Lifecycle mode: selects bootstrap (local transactor) vs networked. Only the
+    // two known values are honored; anything else falls through to the default.
+    const mode = config.mode === 'bootstrap' || config.mode === 'networked'
+        ? config.mode
+        : undefined;
+    // Internal transactor override (e.g. `'test'`). Applies only when `mode` is
+    // unset — see `StrandConnectionOptions.transactor`.
+    const transactor = typeof config.transactor === 'string' && config.transactor
+        ? config.transactor
+        : undefined;
+    // NOTE: persistent storage cannot ride a `Record<string, SqlValue>` — an
+    // `IRawStorage` is not an `SqlValue`. The Node loader (`plugin.ts`) reads the
+    // platform-only `storage_path` key directly and resolves it to a concrete
+    // `FileRawStorage`; it is intentionally NOT parsed into the typed options here.
+    return {
+        strandId,
+        bootstrapNodes,
+        schema,
+        sAppId,
+        sAppVersion,
+        port,
+        enableCache,
+        fretProfile,
+        ...(mode && { mode }),
+        ...(transactor && { transactor }),
+    };
+}
+//# sourceMappingURL=parse-config.js.map

package/dist/parse-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse-config.js","sourceRoot":"","sources":["../src/parse-config.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,MAAgC;IAC3D,MAAM,QAAQ,GAAG,MAAM,CAAC,SAAS,CAAC;IAClC,IAAI,OAAO,QAAQ,KAAK,QAAQ,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,8CAA8C,CAAC,CAAC;IACjE,CAAC;IAED,MAAM,iBAAiB,GAAG,MAAM,CAAC,eAAe,CAAC;IACjD,MAAM,cAAc,GAAG,OAAO,iBAAiB,KAAK,QAAQ,IAAI,iBAAiB;QAChF,CAAC,CAAC,iBAAiB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC;QACjE,CAAC,CAAC,EAAE,CAAC;IAEN,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IAC7E,MAAM,MAAM,GAAG,OAAO,MAAM,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAC/E,MAAM,WAAW,GAAG,OAAO,MAAM,CAAC,YAAY,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,CAAC,OAAO,CAAC;IAC5F,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,KAAK,KAAK,IAAI,MAAM,CAAC,YAAY,KAAK,CAAC,CAAC;IAC/E,MAAM,WAAW,GAAG,MAAM,CAAC,YAAY,KAAK,MAAM,CAAC,CAAC,CAAC,MAAe,CAAC,CAAC,CAAC,MAAe,CAAC;IAEvF,8EAA8E;IAC9E,4EAA4E;IAC5E,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,KAAK,WAAW,IAAI,MAAM,CAAC,IAAI,KAAK,WAAW;QACtE,CAAC,CAAC,MAAM,CAAC,IAAI;QACb,CAAC,CAAC,SAAS,CAAC;IAEb,4EAA4E;IAC5E,oDAAoD;IACpD,MAAM,UAAU,GAAG,OAAO,MAAM,CAAC,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,UAAU;QAC5E,CAAC,CAAC,MAAM,CAAC,UAAU;QACnB,CAAC,CAAC,SAAS,CAAC;IAEb,yEAAyE;IACzE,8EAA8E;IAC9E,0EAA0E;IAC1E,gFAAgF;IAEhF,OAAO;QACN,QAAQ;QACR,cAAc;QACd,MAAM;QACN,MAAM;QACN,WAAW;QACX,IAAI;QACJ,WAAW;QACX,WAAW;QACX,GAAG,CAAC,IAAI,IAAI,EAAE,IAAI,EAAE,CAAC;QACrB,GAAG,CAAC,UAAU,IAAI,EAAE,UAAU,EAAE,CAAC;KACjC,CAAC;AACH,CAAC"}

package/dist/plugin-browser.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Quereus plugin entry point for Sereus strand connections (browser/worker).
+ *
+ * This is the ESM-bundled counterpart to `./plugin`. Load via Quoomb-web's
+ * plugin URL field or `plugins[].source` in `quoomb.config.json`. Defaults
+ * storage to IndexedDB and uses WebSockets + circuit-relay transports.
+ */
+import type { Database, SqlValue } from '@quereus/quereus';
+import { parseConfig } from './parse-config.js';
+import type { SereusPluginResult } from './types.js';
+export { parseConfig };
+/**
+ * Default export: Quereus plugin registration function (browser).
+ *
+ * Note: the `storage_path` setting is Node-only (it resolves to a filesystem
+ * `FileRawStorage` in `./plugin`). The browser entry ignores it and defaults
+ * storage to IndexedDB via `connectToStrandBrowser`.
+ */
+export default function register(db: Database, config?: Record<string, SqlValue>): Promise<SereusPluginResult>;