sietch 0.4.1 → 0.6.0

package/dist/index.d.ts

@@ -9,4 +9,6 @@
  */
 export { createStore, Store, Cursor, SubtreeCursor } from './store.js';
 export { ValidationError, SietchError, StorageFullError, SyncError } from './errors.js';
+export type { StorageBackend } from './storage.js';
+export type { StorageType, StorageCapacity } from './types.js';
 export type { CollectionConfig, CrdtValue, MutationEvent, WriteConfirmation, ReadResult, SyncStatus, SubtreeSyncStatus, SyncConfig, AclMap, AclPermissions, StoreOptions, StorageMetrics, SearchQuery, SearchResult, SearchHit, VectorSearchOptions, VectorResult, TraverseOptions, TraverseResult, PublicIdentity, LinkRequest, CypherResult, AclReferenceNode, SubscribeOptions, StorePlugin, WriteContext, } from './store.js';

package/dist/server/index.d.ts

@@ -4,6 +4,8 @@
  * These modules run as a standalone Node.js service,
  * connecting to PostgreSQL (with AGE and pgvector extensions).
  */
+export { SietchServer, createServer } from './server.js';
+export type { ServerOptions } from './server.js';
 export { ServerAuthService } from './auth.js';
 export type { DeviceLinkRequest, VerificationRecord, UserIdentity, LinkResult, EmailProvider } from './auth.js';
 export { ServerAclAuthority, DefaultSigningBackend } from './acl-authority.js';
@@ -13,8 +15,9 @@ export type { AclReferenceNode } from '../acl.js';
 export { ServerSyncService } from './sync-service.js';
 export type { SubtreeAssignment, ServerSyncConfig, PeerAuthorization } from './sync-service.js';
 export { ServerQueryBridge, InMemoryDatabaseAdapter } from './query-bridge.js';
-export type { DatabaseAdapter } from './query-bridge.js';
+export type { DatabaseAdapter, BridgeStateSource } from './query-bridge.js';
 export { PostgreSQLDatabaseAdapter } from './pg-adapter.js';
+export { PostgresStorageBackend } from './pg-storage.js';
 export { generateKeypair, extractPublicKey } from '../crypto.js';
 export type { HybridKeypair, HybridPublicKey } from '../crypto.js';
 export { createObservabilityContext } from '../observability.js';

package/dist/server/index.js

@@ -4,12 +4,14 @@
  * These modules run as a standalone Node.js service,
  * connecting to PostgreSQL (with AGE and pgvector extensions).
  */
+export { SietchServer, createServer } from './server.js';
 export { ServerAuthService } from './auth.js';
 export { ServerAclAuthority, DefaultSigningBackend } from './acl-authority.js';
 export { serializeRefNode, deserializeRefNode } from '../acl.js';
 export { ServerSyncService } from './sync-service.js';
 export { ServerQueryBridge, InMemoryDatabaseAdapter } from './query-bridge.js';
 export { PostgreSQLDatabaseAdapter } from './pg-adapter.js';
+export { PostgresStorageBackend } from './pg-storage.js';
 export { generateKeypair, extractPublicKey } from '../crypto.js';
 export { createObservabilityContext } from '../observability.js';
 //# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAG9C,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EAAE,gBAAgB,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,mBAAmB,CAAC;AAG/E,OAAO,EAAE,yBAAyB,EAAE,MAAM,iBAAiB,CAAC;AAE5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,iBAAiB,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAGjE,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/server/pg-storage.d.ts

@@ -0,0 +1,50 @@
+/**
+ * PostgreSQL Storage Backend — implements StorageBackend for PG persistence.
+ *
+ * Uses two tables:
+ * - `subdoc_states` (shared with PostgreSQLDatabaseAdapter) — raw Yjs BYTEA
+ * - `sietch_kv` — generic key-value for identity, refs, and metadata
+ *
+ * The pool is NOT owned by this backend — close() is a no-op.
+ * The caller owns the pool and may share it with PostgreSQLDatabaseAdapter.
+ */
+import pg from 'pg';
+import type { StorageBackend } from '../storage.js';
+import type { StorageCapacity } from '../types.js';
+export declare class PostgresStorageBackend implements StorageBackend {
+    readonly type: "postgres";
+    private pool;
+    private schemaReady;
+    constructor(pool: pg.Pool);
+    /**
+     * Ensure required tables exist. Idempotent — safe to call on every startup.
+     * Does NOT create `nodes`, `node_history`, `vectors`, or AGE graph —
+     * those belong to PostgreSQLDatabaseAdapter.
+     */
+    ensureSchema(): Promise<void>;
+    persistSubdoc(subtreeId: string, state: Uint8Array): Promise<void>;
+    loadSubdoc(subtreeId: string): Promise<Uint8Array | null>;
+    deleteSubdoc(subtreeId: string): Promise<void>;
+    listSubdocs(): Promise<string[]>;
+    capacity(): Promise<StorageCapacity>;
+    persistIdentity(encrypted: Uint8Array): Promise<void>;
+    loadIdentity(): Promise<Uint8Array | null>;
+    persistRef(refId: string, state: Uint8Array): Promise<void>;
+    loadRef(refId: string): Promise<Uint8Array | null>;
+    getSubdocMetadata(id: string): Promise<{
+        lastAccess: number;
+        byteSize: number;
+    } | null>;
+    setSubdocMetadata(id: string, meta: {
+        lastAccess: number;
+        byteSize: number;
+    }): Promise<void>;
+    listSubdocMetadata(): Promise<Array<{
+        id: string;
+        lastAccess: number;
+        byteSize: number;
+    }>>;
+    close(): Promise<void>;
+    private kvUpsert;
+    private kvLoad;
+}

package/dist/server/pg-storage.js

@@ -0,0 +1,122 @@
+/**
+ * PostgreSQL Storage Backend — implements StorageBackend for PG persistence.
+ *
+ * Uses two tables:
+ * - `subdoc_states` (shared with PostgreSQLDatabaseAdapter) — raw Yjs BYTEA
+ * - `sietch_kv` — generic key-value for identity, refs, and metadata
+ *
+ * The pool is NOT owned by this backend — close() is a no-op.
+ * The caller owns the pool and may share it with PostgreSQLDatabaseAdapter.
+ */
+// @req FR-02
+export class PostgresStorageBackend {
+    type = 'postgres';
+    pool;
+    schemaReady = false;
+    constructor(pool) {
+        this.pool = pool;
+    }
+    /**
+     * Ensure required tables exist. Idempotent — safe to call on every startup.
+     * Does NOT create `nodes`, `node_history`, `vectors`, or AGE graph —
+     * those belong to PostgreSQLDatabaseAdapter.
+     */
+    async ensureSchema() {
+        if (this.schemaReady)
+            return;
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS subdoc_states (
+        subtree_id TEXT PRIMARY KEY,
+        yjs_state BYTEA NOT NULL,
+        updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+      )
+    `);
+        await this.pool.query(`
+      CREATE TABLE IF NOT EXISTS sietch_kv (
+        key TEXT PRIMARY KEY,
+        value BYTEA NOT NULL,
+        updated_at TIMESTAMPTZ NOT NULL DEFAULT now()
+      )
+    `);
+        this.schemaReady = true;
+    }
+    // ── Subdoc persistence ──────────────────────────────────
+    async persistSubdoc(subtreeId, state) {
+        await this.pool.query(`INSERT INTO subdoc_states (subtree_id, yjs_state, updated_at)
+       VALUES ($1, $2, now())
+       ON CONFLICT (subtree_id) DO UPDATE SET yjs_state = $2, updated_at = now()`, [subtreeId, Buffer.from(state)]);
+    }
+    async loadSubdoc(subtreeId) {
+        const result = await this.pool.query('SELECT yjs_state FROM subdoc_states WHERE subtree_id = $1', [subtreeId]);
+        if (result.rows.length === 0)
+            return null;
+        const buf = result.rows[0].yjs_state;
+        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    async deleteSubdoc(subtreeId) {
+        await this.pool.query('DELETE FROM subdoc_states WHERE subtree_id = $1', [subtreeId]);
+    }
+    async listSubdocs() {
+        const result = await this.pool.query('SELECT subtree_id FROM subdoc_states ORDER BY subtree_id');
+        return result.rows.map((row) => row.subtree_id);
+    }
+    // ── Capacity ────────────────────────────────────────────
+    async capacity() {
+        return {
+            used: 0,
+            total: Number.MAX_SAFE_INTEGER,
+            available: Number.MAX_SAFE_INTEGER,
+        };
+    }
+    // ── Identity persistence ────────────────────────────────
+    async persistIdentity(encrypted) {
+        await this.kvUpsert('identity:keypair', Buffer.from(encrypted));
+    }
+    async loadIdentity() {
+        return this.kvLoad('identity:keypair');
+    }
+    // ── Reference node persistence ──────────────────────────
+    async persistRef(refId, state) {
+        await this.kvUpsert(`ref:${refId}`, Buffer.from(state));
+    }
+    async loadRef(refId) {
+        return this.kvLoad(`ref:${refId}`);
+    }
+    // ── Subdoc metadata ─────────────────────────────────────
+    async getSubdocMetadata(id) {
+        const raw = await this.kvLoad(`meta:${id}`);
+        if (!raw)
+            return null;
+        return JSON.parse(new TextDecoder().decode(raw));
+    }
+    async setSubdocMetadata(id, meta) {
+        const encoded = Buffer.from(JSON.stringify(meta));
+        await this.kvUpsert(`meta:${id}`, encoded);
+    }
+    async listSubdocMetadata() {
+        const result = await this.pool.query("SELECT key, value FROM sietch_kv WHERE key LIKE 'meta:%' ORDER BY key");
+        return result.rows.map((row) => {
+            const id = row.key.slice(5); // strip 'meta:'
+            const meta = JSON.parse(row.value.toString());
+            return { id, ...meta };
+        });
+    }
+    // ── Lifecycle ───────────────────────────────────────────
+    async close() {
+        // No-op — pool is owned by the caller
+    }
+    // ── Private helpers ─────────────────────────────────────
+    async kvUpsert(key, value) {
+        await this.pool.query(`INSERT INTO sietch_kv (key, value, updated_at)
+       VALUES ($1, $2, now())
+       ON CONFLICT (key) DO UPDATE SET value = $2, updated_at = now()`, [key, value]);
+    }
+    async kvLoad(key) {
+        const result = await this.pool.query('SELECT value FROM sietch_kv WHERE key = $1', [key]);
+        if (result.rows.length === 0)
+            return null;
+        const buf = result.rows[0].value;
+        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+}
+//# sourceMappingURL=pg-storage.js.map

package/dist/server/pg-storage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pg-storage.js","sourceRoot":"","sources":["../../src/server/pg-storage.ts"],"names":[],"mappings":"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"}

package/dist/server/query-bridge.d.ts

@@ -11,9 +11,20 @@
  *
  * Encrypted subtrees are stored as opaque BYTEA only.
  */
-import type { ServerSyncService } from './sync-service.js';
+import * as Y from 'yjs';
 import type { AclManager } from '../acl.js';
 import type { ObservabilityContext } from '../observability.js';
+/** Minimal interface for the state source that feeds the query bridge. */
+export interface BridgeStateSource {
+    /** Subscribe to raw Yjs updates on a subtree. */
+    onUpdate(subtreeId: string, listener: (subtreeId: string, update: Uint8Array) => void): () => void;
+    /** Get the Yjs doc for a subtree (for full-state reads). */
+    getSubdoc(subtreeId: string): Y.Doc | Promise<Y.Doc>;
+    /** Encode full state as a Yjs update (for encrypted subtree persistence). */
+    encodeStateAsUpdate(subtreeId: string, remoteStateVector?: Uint8Array): Uint8Array | Promise<Uint8Array>;
+    /** Get list of assigned/active subtrees. */
+    getAssignedSubtrees(): string[];
+}
 /** Abstract database interface for PostgreSQL operations. */
 export interface DatabaseAdapter {
     /** Upsert a node's decoded data. */
@@ -114,14 +125,14 @@ export declare class InMemoryDatabaseAdapter implements DatabaseAdapter {
     getVersionAtTimestamp(id: string, timestamp: Date): Promise<Record<string, unknown> | null>;
 }
 export declare class ServerQueryBridge {
-    private readonly syncService;
+    private readonly stateSource;
     private readonly acl;
     private readonly db;
     private readonly obs;
     private readonly unsubscribes;
     /** Per-node version counter. */
     private readonly versionCounters;
-    constructor(syncService: ServerSyncService, acl: AclManager, db: DatabaseAdapter, obs: ObservabilityContext);
+    constructor(stateSource: BridgeStateSource, acl: AclManager, db: DatabaseAdapter, obs: ObservabilityContext);
     /**
      * Start observing assigned subtrees and piping changes to the database.
      */

package/dist/server/query-bridge.js

@@ -95,15 +95,15 @@ export class InMemoryDatabaseAdapter {
 // @req FR-53
 // @req FR-54
 export class ServerQueryBridge {
-    syncService;
+    stateSource;
     acl;
     db;
     obs;
     unsubscribes = [];
     /** Per-node version counter. */
     versionCounters = new Map();
-    constructor(syncService, acl, db, obs) {
-        this.syncService = syncService;
+    constructor(stateSource, acl, db, obs) {
+        this.stateSource = stateSource;
         this.acl = acl;
         this.db = db;
         this.obs = obs;
@@ -112,7 +112,7 @@ export class ServerQueryBridge {
      * Start observing assigned subtrees and piping changes to the database.
      */
     start() {
-        const subtrees = this.syncService.getAssignedSubtrees();
+        const subtrees = this.stateSource.getAssignedSubtrees();
         for (const subtreeId of subtrees) {
             this.observeSubtree(subtreeId);
         }
@@ -122,7 +122,7 @@ export class ServerQueryBridge {
      * Observe a single subtree for changes.
      */
     observeSubtree(subtreeId) {
-        const unsub = this.syncService.onUpdate(subtreeId, (_sid, update) => {
+        const unsub = this.stateSource.onUpdate(subtreeId, (_sid, update) => {
             void this.processUpdate(subtreeId, update);
         });
         this.unsubscribes.push(unsub);
@@ -139,13 +139,13 @@ export class ServerQueryBridge {
             const node = this.acl.getRefNode(subtreeId);
             if (node?.encrypted) {
                 // Encrypted subtrees: store only raw Yjs state
-                const state = this.syncService.encodeStateAsUpdate(subtreeId);
+                const state = await this.stateSource.encodeStateAsUpdate(subtreeId);
                 await this.db.upsertSubdocState(subtreeId, state);
                 return;
             }
         }
         // Unencrypted: decode Yjs state and write to PostgreSQL
-        const doc = this.syncService.getSubdoc(subtreeId);
+        const doc = await this.stateSource.getSubdoc(subtreeId);
         const nodesMap = doc.getMap('nodes');
         for (const [key, value] of nodesMap.entries()) {
             const nodeId = `${subtreeId}.${key}`;

package/dist/server/query-bridge.js.map

@@ -1 +1 @@
-{"version":3,"file":"query-bridge.js","sourceRoot":"","sources":["../../src/server/query-bridge.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"query-bridge.js","sourceRoot":"","sources":["../../src/server/query-bridge.ts"],"names":[],"mappings":"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"}

package/dist/server/server.d.ts

@@ -0,0 +1,82 @@
+/**
+ * SietchServer — server-focused API class.
+ *
+ * Composes YjsEngine, SyncEngine, IdentityManager, AclManager, and
+ * optionally ServerQueryBridge behind a clean surface with a single
+ * Y.Doc pool and coherent lifecycle.
+ *
+ * @example
+ *   import { createServer } from 'sietch/server';
+ *   const server = await createServer({ listen: ['/ip4/0.0.0.0/tcp/9090/ws'] });
+ *   await server.put('items.book1', { title: 'Dune', year: 1965 });
+ *   await server.close();
+ */
+import * as Y from 'yjs';
+import { type PublicIdentity } from '../identity.js';
+import { type StorageBackend } from '../storage.js';
+import type { SyncConfig } from '../sync-engine.js';
+import { type DatabaseAdapter } from './query-bridge.js';
+import { type AclSigningBackend } from './acl-authority.js';
+import type { CrdtValue, MutationEvent, StorageType, Unsubscribe, WriteConfirmation, ReadResult } from '../types.js';
+export interface ServerOptions {
+    /** Multiaddrs to listen on (e.g., ['/ip4/0.0.0.0/tcp/9090/ws']). */
+    listen: string[];
+    /** Storage backend preference (default: 'auto' — filesystem in Node.js). */
+    storage?: StorageType | 'auto';
+    /** Filesystem storage directory (default: '.sietch'). */
+    storagePath?: string;
+    /** Pre-initialized storage backend (bypasses auto-detection). */
+    storageBackend?: StorageBackend;
+    /** Database adapter for query bridge (optional — no PG pipeline without it). */
+    database?: DatabaseAdapter;
+    /** Log level (default: 'info'). */
+    logLevel?: 'debug' | 'info' | 'warn' | 'error';
+    /** ACL signing backend for server-owned subtrees. */
+    aclSigningBackend?: AclSigningBackend;
+    /** Sync reconnect configuration. */
+    reconnect?: SyncConfig['reconnect'];
+}
+export declare class SietchServer {
+    private readonly yjsEngine;
+    private readonly syncEngine;
+    private readonly identityMgr;
+    private readonly aclMgr;
+    private readonly obs;
+    private readonly storage;
+    private queryBridge?;
+    private aclAuthority?;
+    /** Subtrees already registered with the query bridge. */
+    private readonly bridgedSubtrees;
+    /** Private — use createServer(). */
+    private constructor();
+    /** Factory — initializes all subsystems in correct order. */
+    static create(options: ServerOptions): Promise<SietchServer>;
+    /** Multiaddrs this server is listening on. */
+    get multiaddrs(): string[];
+    /** The server's PQ identity. */
+    identity(): Promise<PublicIdentity>;
+    /** Write a value (goes through YjsEngine — persist + sync to peers). */
+    put(path: string, value: CrdtValue): Promise<WriteConfirmation>;
+    /** Read a value from the local Yjs state. */
+    get(path: string): Promise<ReadResult>;
+    /** Shallow-merge fields into an existing value. */
+    patch(path: string, fields: Record<string, CrdtValue>): Promise<WriteConfirmation>;
+    /** Delete a value. */
+    delete(path: string): Promise<WriteConfirmation>;
+    /** Subscribe to fine-grained mutation events across all subtrees. */
+    onMutation(callback: (event: MutationEvent) => void): Unsubscribe;
+    /** Subscribe to raw Yjs updates on a subtree (for external pipelines). */
+    onSubdocUpdate(subtreeId: string, listener: (subtreeId: string, update: Uint8Array) => void): Unsubscribe;
+    /** Get the raw Y.Doc for a subtree (for y-crdt interop / external observers). */
+    getSubdoc(subtreeId: string): Promise<Y.Doc>;
+    /** Execute a Cypher query (requires database). */
+    cypher(query: string, params?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    /** Register a query handler for the sync protocol. */
+    registerQueryHandler(handler: (q: string, p?: Record<string, unknown>) => Promise<Record<string, unknown>[]>): void;
+    /** Ensure the query bridge is observing a subtree. */
+    private ensureBridged;
+    /** Gracefully shut down all subsystems. */
+    close(): Promise<void>;
+}
+/** Convenience factory. */
+export declare function createServer(options: ServerOptions): Promise<SietchServer>;

package/dist/server/server.js

@@ -0,0 +1,210 @@
+/**
+ * SietchServer — server-focused API class.
+ *
+ * Composes YjsEngine, SyncEngine, IdentityManager, AclManager, and
+ * optionally ServerQueryBridge behind a clean surface with a single
+ * Y.Doc pool and coherent lifecycle.
+ *
+ * @example
+ *   import { createServer } from 'sietch/server';
+ *   const server = await createServer({ listen: ['/ip4/0.0.0.0/tcp/9090/ws'] });
+ *   await server.put('items.book1', { title: 'Dune', year: 1965 });
+ *   await server.close();
+ */
+import * as Y from 'yjs';
+import { YjsEngine } from '../yjs-engine.js';
+import { IdentityManager } from '../identity.js';
+import { AclManager } from '../acl.js';
+import { createStorageBackend } from '../storage.js';
+import { createObservabilityContext } from '../observability.js';
+import { ServerQueryBridge } from './query-bridge.js';
+import { ServerAclAuthority } from './acl-authority.js';
+// ── YjsEngine → BridgeStateSource adapter ──────────────────
+/**
+ * Adapts YjsEngine to the BridgeStateSource interface required by
+ * ServerQueryBridge, allowing the bridge to observe the same Y.Doc
+ * pool used for sync and local operations.
+ */
+class YjsEngineBridgeAdapter {
+    engine;
+    constructor(engine) {
+        this.engine = engine;
+    }
+    onUpdate(subtreeId, listener) {
+        return this.engine.onSubdocUpdate(subtreeId, listener);
+    }
+    async getSubdoc(subtreeId) {
+        return this.engine.getSubdoc(subtreeId);
+    }
+    async encodeStateAsUpdate(subtreeId, remoteStateVector) {
+        const doc = await this.engine.getSubdoc(subtreeId);
+        return Y.encodeStateAsUpdate(doc, remoteStateVector);
+    }
+    getAssignedSubtrees() {
+        return this.engine.listLoadedSubdocIds();
+    }
+}
+// ── SietchServer ───────────────────────────────────────────
+export class SietchServer {
+    yjsEngine;
+    syncEngine;
+    identityMgr;
+    aclMgr;
+    obs;
+    storage;
+    queryBridge;
+    aclAuthority;
+    /** Subtrees already registered with the query bridge. */
+    bridgedSubtrees = new Set();
+    /** Private — use createServer(). */
+    constructor(storage, obs, yjsEngine, syncEngine, identityMgr, aclMgr) {
+        this.storage = storage;
+        this.obs = obs;
+        this.yjsEngine = yjsEngine;
+        this.syncEngine = syncEngine;
+        this.identityMgr = identityMgr;
+        this.aclMgr = aclMgr;
+    }
+    /** Factory — initializes all subsystems in correct order. */
+    static async create(options) {
+        const obs = createObservabilityContext(options.logLevel ?? 'info');
+        // 1. Storage
+        let storage;
+        if (options.storageBackend) {
+            storage = options.storageBackend;
+        }
+        else {
+            storage = await createStorageBackend(obs, options.storage ?? 'auto', options.storagePath);
+        }
+        // 2. YjsEngine (single doc pool)
+        const yjsEngine = new YjsEngine(storage, obs);
+        // 3. Identity
+        const identityMgr = new IdentityManager(storage, obs);
+        await identityMgr.init();
+        // 4. ACL
+        const aclMgr = new AclManager(obs);
+        // 5. SyncEngine (transport)
+        const { SyncEngine: SyncEngineCtor } = await import('../sync-engine.js');
+        const syncEngine = new SyncEngineCtor(yjsEngine, identityMgr, aclMgr, obs);
+        const syncConfig = { listen: options.listen };
+        if (options.reconnect) {
+            syncConfig.reconnect = options.reconnect;
+        }
+        await syncEngine.init(syncConfig);
+        const server = new SietchServer(storage, obs, yjsEngine, syncEngine, identityMgr, aclMgr);
+        // 6. QueryBridge (optional — only if database adapter provided)
+        if (options.database) {
+            const bridgeSource = new YjsEngineBridgeAdapter(yjsEngine);
+            server.queryBridge = new ServerQueryBridge(bridgeSource, aclMgr, options.database, obs);
+            server.queryBridge.start();
+            syncEngine.registerQueryHandler((q, p) => server.queryBridge.cypherQuery(q, p));
+        }
+        // 7. ACL authority (optional)
+        if (options.aclSigningBackend) {
+            const identity = identityMgr.getPublicIdentity();
+            server.aclAuthority = new ServerAclAuthority(options.aclSigningBackend, obs, identity.peerId);
+        }
+        obs.logger.info({ listen: options.listen }, 'server started');
+        return server;
+    }
+    // ── Accessors ──────────────────────────────────────────
+    /** Multiaddrs this server is listening on. */
+    get multiaddrs() {
+        return this.syncEngine.getMultiaddrs();
+    }
+    /** The server's PQ identity. */
+    async identity() {
+        if (!this.identityMgr.isInitialized()) {
+            await this.identityMgr.init();
+        }
+        return this.identityMgr.getPublicIdentity();
+    }
+    // ── Data Operations ──────────────────────────────────────
+    /** Write a value (goes through YjsEngine — persist + sync to peers). */
+    async put(path, value) {
+        const subtreeId = path.split('.')[0] ?? path;
+        this.ensureBridged(subtreeId);
+        const { update } = await this.yjsEngine.applyLocal(path, value);
+        if (update) {
+            this.syncEngine.queueUpdate(subtreeId, update);
+        }
+        return { path, timestamp: Date.now(), persisted: true };
+    }
+    /** Read a value from the local Yjs state. */
+    async get(path) {
+        const value = await this.yjsEngine.getState(path);
+        return { value: value ?? undefined, source: 'local' };
+    }
+    /** Shallow-merge fields into an existing value. */
+    async patch(path, fields) {
+        const subtreeId = path.split('.')[0] ?? path;
+        this.ensureBridged(subtreeId);
+        const { update } = await this.yjsEngine.applyPatch(path, fields);
+        if (update) {
+            this.syncEngine.queueUpdate(subtreeId, update);
+        }
+        return { path, timestamp: Date.now(), persisted: true };
+    }
+    /** Delete a value. */
+    async delete(path) {
+        const subtreeId = path.split('.')[0] ?? path;
+        this.ensureBridged(subtreeId);
+        const { update } = await this.yjsEngine.applyLocal(path, null);
+        if (update) {
+            this.syncEngine.queueUpdate(subtreeId, update);
+        }
+        return { path, timestamp: Date.now(), persisted: true };
+    }
+    // ── Observation ──────────────────────────────────────────
+    /** Subscribe to fine-grained mutation events across all subtrees. */
+    onMutation(callback) {
+        return this.yjsEngine.onMutation(callback);
+    }
+    /** Subscribe to raw Yjs updates on a subtree (for external pipelines). */
+    onSubdocUpdate(subtreeId, listener) {
+        return this.yjsEngine.onSubdocUpdate(subtreeId, listener);
+    }
+    /** Get the raw Y.Doc for a subtree (for y-crdt interop / external observers). */
+    async getSubdoc(subtreeId) {
+        return this.yjsEngine.getSubdoc(subtreeId);
+    }
+    // ── Query Bridge (requires database option) ──────────────
+    /** Execute a Cypher query (requires database). */
+    async cypher(query, params) {
+        if (!this.queryBridge) {
+            throw new Error('Query bridge not configured — pass `database` option to createServer()');
+        }
+        return this.queryBridge.cypherQuery(query, params);
+    }
+    // ── ACL ──────────────────────────────────────────────────
+    /** Register a query handler for the sync protocol. */
+    registerQueryHandler(handler) {
+        this.syncEngine.registerQueryHandler(handler);
+    }
+    // ── Private ──────────────────────────────────────────────
+    /** Ensure the query bridge is observing a subtree. */
+    ensureBridged(subtreeId) {
+        if (!this.queryBridge)
+            return;
+        if (this.bridgedSubtrees.has(subtreeId))
+            return;
+        this.bridgedSubtrees.add(subtreeId);
+        this.queryBridge.observeSubtree(subtreeId);
+    }
+    // ── Lifecycle ────────────────────────────────────────────
+    /** Gracefully shut down all subsystems. */
+    async close() {
+        if (this.queryBridge) {
+            this.queryBridge.stop();
+        }
+        await this.syncEngine.close();
+        this.yjsEngine.close();
+        await this.storage.close();
+        this.obs.logger.info('server stopped');
+    }
+}
+/** Convenience factory. */
+export async function createServer(options) {
+    return SietchServer.create(options);
+}
+//# sourceMappingURL=server.js.map