sietch 0.1.0

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

@@ -0,0 +1,166 @@
+/**
+ * Server Query Bridge — Yjs observeDeep → PostgreSQL pipeline.
+ *
+ * Architecture: §2.2 Server Components, Query Bridge
+ *
+ * Listens to Yjs updates on unencrypted subdocs and writes to:
+ * - `nodes` table (JSONB decoded properties)
+ * - `node_history` table (append-only version chain)
+ * - AGE graph (edges)
+ * - pgvector embeddings (vectors)
+ *
+ * Encrypted subtrees are stored as opaque BYTEA only.
+ */
+import type { ServerSyncService } from './sync-service.js';
+import type { AclManager } from '../acl.js';
+import type { ObservabilityContext } from '../observability.js';
+/** Abstract database interface for PostgreSQL operations. */
+export interface DatabaseAdapter {
+    /** Upsert a node's decoded data. */
+    upsertNode(id: string, subtree: string, data: Record<string, unknown>): Promise<void>;
+    /** Get a single node by ID. */
+    getNode(id: string): Promise<{
+        id: string;
+        subtree: string;
+        data: Record<string, unknown>;
+        updatedAt: Date;
+    } | null>;
+    /** List nodes, optionally filtered by subtree. */
+    listNodes(subtree?: string): Promise<Array<{
+        id: string;
+        subtree: string;
+        data: Record<string, unknown>;
+        updatedAt: Date;
+    }>>;
+    /** Append to version history (immutable). */
+    appendHistory(id: string, version: number, data: Record<string, unknown>): Promise<void>;
+    /** Get the highest version number for a node (for restarting version counters). */
+    getMaxVersion(id: string): Promise<number>;
+    /** Store raw Yjs state (for encrypted subtrees). */
+    upsertSubdocState(subtreeId: string, yjsState: Uint8Array): Promise<void>;
+    /** Add a graph edge (AGE). */
+    addGraphEdge(source: string, label: string, target: string): Promise<void>;
+    /** Remove a graph edge (AGE). */
+    removeGraphEdge(source: string, label: string, target: string): Promise<void>;
+    /** Upsert a vector embedding (pgvector). */
+    upsertVector(nodeId: string, subtree: string, embedding: number[]): Promise<void>;
+    /** Query graph via openCypher. */
+    cypherQuery(query: string, params?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    /** kNN vector search. */
+    vectorSearch(embedding: number[], k: number): Promise<Array<{
+        nodeId: string;
+        distance: number;
+    }>>;
+    /** Get version history for a node. */
+    getHistory(id: string, fromVersion?: number): Promise<Array<{
+        version: number;
+        data: Record<string, unknown>;
+        createdAt: Date;
+    }>>;
+    /** Get state at a specific timestamp. */
+    getVersionAtTimestamp(id: string, timestamp: Date): Promise<Record<string, unknown> | null>;
+}
+/** In-memory database adapter for testing without PostgreSQL. */
+export declare class InMemoryDatabaseAdapter implements DatabaseAdapter {
+    readonly nodes: Map<string, {
+        subtree: string;
+        data: Record<string, unknown>;
+    }>;
+    readonly history: Array<{
+        id: string;
+        version: number;
+        data: Record<string, unknown>;
+        createdAt: Date;
+    }>;
+    readonly subdocStates: Map<string, Uint8Array<ArrayBufferLike>>;
+    readonly edges: Array<{
+        source: string;
+        label: string;
+        target: string;
+    }>;
+    readonly vectors: Map<string, {
+        subtree: string;
+        embedding: number[];
+    }>;
+    upsertNode(id: string, subtree: string, data: Record<string, unknown>): Promise<void>;
+    getNode(id: string): Promise<{
+        id: string;
+        subtree: string;
+        data: Record<string, unknown>;
+        updatedAt: Date;
+    } | null>;
+    listNodes(subtree?: string): Promise<Array<{
+        id: string;
+        subtree: string;
+        data: Record<string, unknown>;
+        updatedAt: Date;
+    }>>;
+    appendHistory(id: string, version: number, data: Record<string, unknown>): Promise<void>;
+    getMaxVersion(id: string): Promise<number>;
+    upsertSubdocState(subtreeId: string, yjsState: Uint8Array): Promise<void>;
+    addGraphEdge(source: string, label: string, target: string): Promise<void>;
+    removeGraphEdge(source: string, label: string, target: string): Promise<void>;
+    upsertVector(nodeId: string, subtree: string, embedding: number[]): Promise<void>;
+    cypherQuery(_query: string, _params?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    vectorSearch(embedding: number[], k: number): Promise<Array<{
+        nodeId: string;
+        distance: number;
+    }>>;
+    getHistory(id: string): Promise<Array<{
+        version: number;
+        data: Record<string, unknown>;
+        createdAt: Date;
+    }>>;
+    getVersionAtTimestamp(id: string, timestamp: Date): Promise<Record<string, unknown> | null>;
+}
+export declare class ServerQueryBridge {
+    private readonly syncService;
+    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);
+    /**
+     * Start observing assigned subtrees and piping changes to the database.
+     */
+    start(): void;
+    /**
+     * Observe a single subtree for changes.
+     */
+    observeSubtree(subtreeId: string): void;
+    /**
+     * Process a Yjs update and write decoded data to the database.
+     */
+    private processUpdate;
+    /**
+     * Execute an openCypher query via the database.
+     */
+    cypherQuery(query: string, params?: Record<string, unknown>): Promise<Record<string, unknown>[]>;
+    /**
+     * Execute a vector similarity search via the database.
+     */
+    vectorSearch(embedding: number[], k: number): Promise<Array<{
+        nodeId: string;
+        distance: number;
+    }>>;
+    /**
+     * Get version history for a node.
+     */
+    getHistory(nodeId: string): Promise<Array<{
+        version: number;
+        data: Record<string, unknown>;
+        createdAt: Date;
+    }>>;
+    /**
+     * Get state at a specific timestamp.
+     */
+    getVersionAtTimestamp(nodeId: string, timestamp: Date): Promise<Record<string, unknown> | null>;
+    /**
+     * Stop observing and clean up.
+     */
+    stop(): void;
+    /** Convert a Yjs value to a plain JSON-compatible object. */
+    private yjsValueToJson;
+}

package/dist/server/query-bridge.js

@@ -0,0 +1,258 @@
+/**
+ * Server Query Bridge — Yjs observeDeep → PostgreSQL pipeline.
+ *
+ * Architecture: §2.2 Server Components, Query Bridge
+ *
+ * Listens to Yjs updates on unencrypted subdocs and writes to:
+ * - `nodes` table (JSONB decoded properties)
+ * - `node_history` table (append-only version chain)
+ * - AGE graph (edges)
+ * - pgvector embeddings (vectors)
+ *
+ * Encrypted subtrees are stored as opaque BYTEA only.
+ */
+import * as Y from 'yjs';
+/** In-memory database adapter for testing without PostgreSQL. */
+export class InMemoryDatabaseAdapter {
+    nodes = new Map();
+    history = [];
+    subdocStates = new Map();
+    edges = [];
+    vectors = new Map();
+    async upsertNode(id, subtree, data) {
+        this.nodes.set(id, { subtree, data });
+    }
+    async getNode(id) {
+        const entry = this.nodes.get(id);
+        if (!entry)
+            return null;
+        return { id, subtree: entry.subtree, data: entry.data, updatedAt: new Date() };
+    }
+    async listNodes(subtree) {
+        const results = [];
+        for (const [id, entry] of this.nodes) {
+            if (subtree === undefined || entry.subtree === subtree) {
+                results.push({ id, subtree: entry.subtree, data: entry.data, updatedAt: new Date() });
+            }
+        }
+        return results;
+    }
+    async appendHistory(id, version, data) {
+        this.history.push({ id, version, data, createdAt: new Date() });
+    }
+    async getMaxVersion(id) {
+        let max = 0;
+        for (const entry of this.history) {
+            if (entry.id === id && entry.version > max)
+                max = entry.version;
+        }
+        return max;
+    }
+    async upsertSubdocState(subtreeId, yjsState) {
+        this.subdocStates.set(subtreeId, yjsState);
+    }
+    async addGraphEdge(source, label, target) {
+        this.edges.push({ source, label, target });
+    }
+    async removeGraphEdge(source, label, target) {
+        const idx = this.edges.findIndex((e) => e.source === source && e.label === label && e.target === target);
+        if (idx >= 0)
+            this.edges.splice(idx, 1);
+    }
+    async upsertVector(nodeId, subtree, embedding) {
+        this.vectors.set(nodeId, { subtree, embedding });
+    }
+    async cypherQuery(_query, _params) {
+        return [];
+    }
+    async vectorSearch(embedding, k) {
+        // Simple cosine distance
+        const results = [];
+        for (const [nodeId, entry] of this.vectors) {
+            const dist = cosineDistance(embedding, entry.embedding);
+            results.push({ nodeId, distance: dist });
+        }
+        results.sort((a, b) => a.distance - b.distance);
+        return results.slice(0, k);
+    }
+    async getHistory(id) {
+        return this.history
+            .filter((h) => h.id === id)
+            .sort((a, b) => a.version - b.version);
+    }
+    async getVersionAtTimestamp(id, timestamp) {
+        const entries = this.history
+            .filter((h) => h.id === id && h.createdAt.getTime() <= timestamp.getTime())
+            .sort((a, b) => b.version - a.version);
+        return entries.length > 0 ? entries[0].data : null;
+    }
+}
+// ── Query Bridge ───────────────────────────────────────────
+// @req FR-46
+// @req FR-50
+// @req FR-51
+// @req FR-52
+// @req FR-53
+// @req FR-54
+export class ServerQueryBridge {
+    syncService;
+    acl;
+    db;
+    obs;
+    unsubscribes = [];
+    /** Per-node version counter. */
+    versionCounters = new Map();
+    constructor(syncService, acl, db, obs) {
+        this.syncService = syncService;
+        this.acl = acl;
+        this.db = db;
+        this.obs = obs;
+    }
+    /**
+     * Start observing assigned subtrees and piping changes to the database.
+     */
+    start() {
+        const subtrees = this.syncService.getAssignedSubtrees();
+        for (const subtreeId of subtrees) {
+            this.observeSubtree(subtreeId);
+        }
+        this.obs.logger.info({ subtreeCount: subtrees.length }, 'query bridge started');
+    }
+    /**
+     * Observe a single subtree for changes.
+     */
+    observeSubtree(subtreeId) {
+        const unsub = this.syncService.onUpdate(subtreeId, (_sid, update) => {
+            void this.processUpdate(subtreeId, update);
+        });
+        this.unsubscribes.push(unsub);
+    }
+    /**
+     * Process a Yjs update and write decoded data to the database.
+     */
+    // @req FR-31
+    // @req FR-52
+    // @req FR-54
+    async processUpdate(subtreeId, _update) {
+        // Check if subtree is encrypted — if so, only store opaque state
+        if (this.acl.hasAcl(subtreeId)) {
+            const node = this.acl.getRefNode(subtreeId);
+            if (node?.encrypted) {
+                // Encrypted subtrees: store only raw Yjs state
+                const state = this.syncService.encodeStateAsUpdate(subtreeId);
+                await this.db.upsertSubdocState(subtreeId, state);
+                return;
+            }
+        }
+        // Unencrypted: decode Yjs state and write to PostgreSQL
+        const doc = this.syncService.getSubdoc(subtreeId);
+        const nodesMap = doc.getMap('nodes');
+        for (const [key, value] of nodesMap.entries()) {
+            const nodeId = `${subtreeId}.${key}`;
+            const data = this.yjsValueToJson(value);
+            if (data && typeof data === 'object' && !Array.isArray(data)) {
+                // Upsert to nodes table
+                await this.db.upsertNode(nodeId, subtreeId, data);
+                // Append to version history (append-only, FR-54)
+                // On first write after startup, seed from DB to survive restarts
+                if (!this.versionCounters.has(nodeId)) {
+                    this.versionCounters.set(nodeId, await this.db.getMaxVersion(nodeId));
+                }
+                const version = this.versionCounters.get(nodeId) + 1;
+                this.versionCounters.set(nodeId, version);
+                await this.db.appendHistory(nodeId, version, data);
+            }
+            // Check for vector embeddings
+            if (data && typeof data === 'object' && !Array.isArray(data)) {
+                const record = data;
+                if (record['_vector'] && Array.isArray(record['_vector'])) {
+                    await this.db.upsertVector(nodeId, subtreeId, record['_vector']);
+                }
+            }
+        }
+        // Process edges
+        const edgesMap = doc.getMap('edges');
+        for (const [edgeKey, value] of edgesMap.entries()) {
+            // Edge keys are stored as 'label\0target'
+            const sepIdx = edgeKey.indexOf('\0');
+            if (sepIdx >= 0 && value === true) {
+                const label = edgeKey.substring(0, sepIdx);
+                const target = edgeKey.substring(sepIdx + 1);
+                await this.db.addGraphEdge(subtreeId, label, target);
+            }
+        }
+    }
+    /**
+     * Execute an openCypher query via the database.
+     */
+    // @req FR-46
+    async cypherQuery(query, params) {
+        return this.db.cypherQuery(query, params);
+    }
+    /**
+     * Execute a vector similarity search via the database.
+     */
+    // @req FR-50
+    async vectorSearch(embedding, k) {
+        return this.db.vectorSearch(embedding, k);
+    }
+    /**
+     * Get version history for a node.
+     */
+    // @req FR-52
+    // @req FR-53
+    async getHistory(nodeId) {
+        return this.db.getHistory(nodeId);
+    }
+    /**
+     * Get state at a specific timestamp.
+     */
+    // @req FR-53
+    async getVersionAtTimestamp(nodeId, timestamp) {
+        return this.db.getVersionAtTimestamp(nodeId, timestamp);
+    }
+    /**
+     * Stop observing and clean up.
+     */
+    stop() {
+        for (const unsub of this.unsubscribes) {
+            unsub();
+        }
+        this.unsubscribes.length = 0;
+    }
+    // ── Helpers ─────────────────────────────────────────────
+    /** Convert a Yjs value to a plain JSON-compatible object. */
+    yjsValueToJson(value) {
+        if (value instanceof Y.Map) {
+            const obj = {};
+            for (const [k, v] of value.entries()) {
+                obj[k] = this.yjsValueToJson(v);
+            }
+            return obj;
+        }
+        if (value instanceof Y.Array) {
+            const arr = [];
+            for (const item of value) {
+                arr.push(this.yjsValueToJson(item));
+            }
+            return arr;
+        }
+        return value;
+    }
+}
+// ── Utilities ──────────────────────────────────────────────
+function cosineDistance(a, b) {
+    let dot = 0;
+    let magA = 0;
+    let magB = 0;
+    for (let i = 0; i < a.length; i++) {
+        dot += (a[i] ?? 0) * (b[i] ?? 0);
+        magA += (a[i] ?? 0) ** 2;
+        magB += (b[i] ?? 0) ** 2;
+    }
+    const denom = Math.sqrt(magA) * Math.sqrt(magB);
+    if (denom === 0)
+        return 1;
+    return 1 - dot / denom;
+}
+//# sourceMappingURL=query-bridge.js.map

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

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

package/dist/server/sync-service.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Server Yjs Sync Service — relay with selective replication.
+ *
+ * Architecture: §2.2 Server Components, Yjs Sync Service
+ *
+ * - Maintains Yjs state in memory per subdocument
+ * - Selective replication based on ACL
+ * - Never evicts data (persistent source of truth)
+ * - Manages subtree assignments (FR-37, FR-38)
+ */
+import * as Y from 'yjs';
+import type { AclManager } from '../acl.js';
+import type { ObservabilityContext } from '../observability.js';
+export interface SubtreeAssignment {
+    subtreeId: string;
+    maxSize?: number;
+    vectorDimensions?: number;
+}
+export interface ServerSyncConfig {
+    /** Subtrees this server is configured to replicate. */
+    subtrees: SubtreeAssignment[];
+}
+export interface PeerAuthorization {
+    peerId: string;
+    /** Subtrees this peer is authorized to sync. */
+    authorizedSubtrees: Set<string>;
+}
+export declare class ServerSyncService {
+    private readonly acl;
+    private readonly obs;
+    /** Yjs docs maintained by the server — persistent, never evicted. */
+    private readonly subdocs;
+    /** Configured subtree assignments. */
+    private readonly assignments;
+    /** Authorized peers. */
+    private readonly peers;
+    /** Change listeners for observeDeep pipelines. */
+    private readonly changeListeners;
+    constructor(acl: AclManager, obs: ObservabilityContext, config?: ServerSyncConfig);
+    /**
+     * Get or create a Yjs doc for a subtree.
+     * Server never evicts — all docs are retained.
+     */
+    getSubdoc(subtreeId: string): Y.Doc;
+    /**
+     * Check if a subtree is configured for replication on this server.
+     */
+    isAssigned(subtreeId: string): boolean;
+    /**
+     * Request inclusion of a new subtree (client-initiated).
+     */
+    requestInclusion(subtreeId: string, requesterId: string): boolean;
+    /**
+     * Authorize a peer for specific subtree(s).
+     */
+    authorizePeer(peerId: string, subtreeIds: string[]): void;
+    /**
+     * Deauthorize a peer.
+     */
+    deauthorizePeer(peerId: string): void;
+    /**
+     * Check if a peer is authorized to sync a subtree.
+     */
+    isPeerAuthorized(peerId: string, subtreeId: string): boolean;
+    /**
+     * Apply a Yjs update to a server-side subdoc.
+     * Only processes if the subtree is assigned.
+     */
+    applyUpdate(subtreeId: string, update: Uint8Array, fromPeerId?: string): boolean;
+    /**
+     * Get Yjs state vector for a subtree.
+     */
+    getStateVector(subtreeId: string): Uint8Array;
+    /**
+     * Encode state as update (diff from remote state vector).
+     */
+    encodeStateAsUpdate(subtreeId: string, remoteStateVector?: Uint8Array): Uint8Array;
+    /**
+     * Subscribe to changes on a subtree (for Query Bridge pipeline).
+     */
+    onUpdate(subtreeId: string, listener: (subtreeId: string, update: Uint8Array) => void): () => void;
+    /**
+     * Get all assigned subtree IDs.
+     */
+    getAssignedSubtrees(): string[];
+    /**
+     * Get count of subdocs held in memory.
+     */
+    getSubdocCount(): number;
+    /**
+     * Get authorized peers for a subtree.
+     */
+    getAuthorizedPeers(subtreeId: string): string[];
+    /**
+     * Clean up all resources.
+     */
+    close(): void;
+}