mindoodb 0.0.56 → 0.0.58

package/README-server.md

@@ -48,7 +48,7 @@ bash serversetup.sh --update
 docker compose up -d --build
 ```
 
-`bash serversetup.sh --update` preserves the existing `server.identity.json`, `server.keybag`, `config.json`, tenant data, `trusted-servers.json`, and `.server_unlock`, while still rebuilding the Docker image and regenerating `docker-compose.override.yml`. Before the override is rewritten, the script now saves the previous file as `docker-compose.override.<timestamp>.yml`.
+`bash serversetup.sh --update` preserves the existing `server.identity.json`, `server.keybag`, `config.json`, tenant data, `trusted-servers.json`, and `.server_unlock`, while still rebuilding the Docker image (including `@number0/iroh`) and regenerating `docker-compose.override.yml`. Before the override is rewritten, the script now saves the previous file as `docker-compose.override.<timestamp>.yml`. Existing `config.json` files are not patched — add `"iroh": { "enabled": true, "secretKeyPath": "iroh-secret.key" }` yourself if you want the rebuilt image to join the Iroh network.
 
 The setup and update flows now prompt for a separate `Host port`. This lets you keep MindooDB listening on its internal container port `1661` while publishing a different host port such as `80`.
 
@@ -104,6 +104,10 @@ The most important file for day-to-day operations is **`config.json`**. After a
         "publicsignkey": "-----BEGIN PUBLIC KEY-----\nMCow...base64...\n-----END PUBLIC KEY-----"
       }
     ]
+  },
+  "iroh": {
+    "enabled": false,
+    "secretKeyPath": "iroh-secret.key"
   }
 }
 ```
@@ -615,6 +619,26 @@ Controls which system admins can call which `/system/*` endpoints. See [How `con
 }
 ```
 
+Optional Iroh listen (off by default). The Docker image already contains
+`@number0/iroh`; you do not install it on the host. New servers get the block
+below with `"enabled": false` in `config.json`. `--update` never rewrites an
+existing `config.json` — add or flip the block yourself, then restart.
+
+When `"enabled": true` the process joins the Iroh network with ALPN
+`mindoodb/sync-v5` and logs a ticket. The secret key is created at
+`iroh-secret.key` in the data directory on first start. Haven pastes
+`iroh:<ticket>` into the server URL field.
+
+```json
+{
+  "capabilities": {},
+  "iroh": {
+    "enabled": true,
+    "secretKeyPath": "iroh-secret.key"
+  }
+}
+```
+
 ### `server.identity.json` (global)
 
 Generated by `pnpm server:init`. Contains a `PrivateUserId` with encrypted private keys:

package/README.md

@@ -339,6 +339,7 @@ See: [Use Cases Documentation](./docs/usecases/README.md)
 
 - [Haven Handbook](./docs/haven-handbook.md) — Complete guide to Haven, the graphical MindooDB collaboration client
 - [Getting Started](./docs/getting-started.md) — Fast setup for Node.js, Web, and React Native
+- [Best Practices](./docs/best-practices.md) — What append-only storage, local-first replicas, client-side-only querying, and encryption-based read access mean for application design: summary-first querying, patch-sized writes, growth planning, collaboration expectations, and Haven app mappings
 - [Example Snippets](./docs/examples/README.md) — Copy-paste Todo starters for all runtimes
 - [Architecture Specification](./docs/specification.md) — Full technical details
 - [React Native Guide](./docs/reactnative.md) — Native Automerge setup and troubleshooting

package/dist/browser/index.mjs

@@ -88,6 +88,7 @@ export const SUMMARY_SETUP_FIELD = browser["SUMMARY_SETUP_FIELD"];
 export const SYNC_SETUP_POLICY_MODES = browser["SYNC_SETUP_POLICY_MODES"];
 export const SYNC_SETUP_POLICY_TYPE = browser["SYNC_SETUP_POLICY_TYPE"];
 export const SelectedOnly = browser["SelectedOnly"];
+export const ServerNetworkContentAddressedStore = browser["ServerNetworkContentAddressedStore"];
 export const StoreKind = browser["StoreKind"];
 export const SummaryVirtualViewDataProvider = browser["SummaryVirtualViewDataProvider"];
 export const SymmetricKeyNotFoundError = browser["SymmetricKeyNotFoundError"];

package/dist/core/appendonlystores/network/IrohNetworkTransport.d.ts

@@ -0,0 +1,93 @@
+import type { StoreEntry, StoreEntryMetadata, StoreEntryType, StoreScanCursor, StoreScanFilters, StoreScanResult, StoreIdBloomSummary, StoreCompactionStatus } from "../../types";
+import type { AttachmentReadPlan, AttachmentReadPlanOptions, ContentAddressedStore, DocumentMaterializationBatchPlan, DocumentMaterializationPlan, MaterializationPlanOptions, PutEntriesAck, StoreHead } from "../types";
+import type { NetworkTransport, NetworkTransportConfig } from "./NetworkTransport";
+import type { AuthResult, NetworkEncryptedEntry, NetworkSyncCapabilities, SessionEncryptedEntriesBatch, StoreChangeEvent } from "./types";
+import { type IrohByteStream, type IrohStreamIO, type IrohRpcContext } from "./IrohStreamIO";
+export type { IrohRpcContext };
+/**
+ * NetworkTransport over Iroh QUIC streams (ALPN {@link MINDOODB_IROH_ALPN}).
+ * Each method is one framed request/response. Pairing uses Iroh tickets.
+ */
+export declare class IrohNetworkTransport implements NetworkTransport {
+    private readonly io;
+    private readonly peerTicket;
+    private readonly config;
+    private nextId;
+    private stream;
+    constructor(io: IrohStreamIO, peerTicket: string, config: NetworkTransportConfig);
+    getIdentity(): string;
+    private rpcContext;
+    private session;
+    private call;
+    getServerInfo(): Promise<unknown>;
+    getTenantPublicInfosFingerprints(tenantId: string): Promise<{
+        tenantId: string;
+        fingerprints: string[];
+    }>;
+    requestChallenge(username?: string, options?: {
+        signingPublicKey?: string;
+    }): Promise<string>;
+    authenticate(challenge: string, signature: Uint8Array): Promise<AuthResult>;
+    getCapabilities(token: string): Promise<NetworkSyncCapabilities>;
+    findNewEntries(token: string, haveIds: string[]): Promise<StoreEntryMetadata[]>;
+    findNewEntriesForDoc(token: string, haveIds: string[], docId: string): Promise<StoreEntryMetadata[]>;
+    findEntries(token: string, type: StoreEntryType, creationDateFrom: number | null, creationDateUntil: number | null): Promise<StoreEntryMetadata[]>;
+    scanEntriesSince(token: string, cursor: StoreScanCursor | null, limit?: number, filters?: StoreScanFilters): Promise<StoreScanResult>;
+    getIdBloomSummary(token: string): Promise<StoreIdBloomSummary>;
+    getStoreHead(token: string): Promise<StoreHead>;
+    getCompactionStatus(token: string): Promise<StoreCompactionStatus>;
+    planDocumentMaterialization(token: string, docId: string, options?: MaterializationPlanOptions): Promise<DocumentMaterializationPlan>;
+    planDocumentMaterializationBatch(token: string, docIds: string[], options?: MaterializationPlanOptions): Promise<DocumentMaterializationBatchPlan>;
+    planAttachmentReadByWalkingMetadata(token: string, lastChunkId: string, attachmentSize: number, options: AttachmentReadPlanOptions): Promise<AttachmentReadPlan>;
+    getEntries(token: string, ids: string[]): Promise<NetworkEncryptedEntry[]>;
+    getEntriesSessionWrapped(token: string, ids: string[]): Promise<SessionEncryptedEntriesBatch>;
+    getEntryMetadata(token: string, id: string): Promise<StoreEntryMetadata | null>;
+    putEntries(token: string, entries: StoreEntry[]): Promise<PutEntriesAck>;
+    hasEntries(token: string, ids: string[]): Promise<string[]>;
+    getAllIds(token: string): Promise<string[]>;
+    resolveDependencies(token: string, startId: string, options?: Record<string, unknown>): Promise<string[]>;
+    subscribeToChanges(token: string, onEvent: (event: StoreChangeEvent) => void, options?: {
+        signal?: AbortSignal;
+    }): Promise<void>;
+}
+/**
+ * ContentAddressedStore proxy over Iroh. Entries stay E2E-encrypted; no extra
+ * RSA wrap. Use with `pullChangesFrom` / `pushChangesTo` between devices.
+ */
+export declare class IrohPeerStore implements ContentAddressedStore {
+    private readonly io;
+    private readonly peerTicket;
+    private readonly dbId;
+    private readonly storeKind;
+    private nextId;
+    private stream;
+    constructor(io: IrohStreamIO, peerTicket: string, dbId: string, storeKind: ReturnType<ContentAddressedStore["getStoreKind"]>);
+    getId(): string;
+    getStoreKind(): import("../types").StoreKind;
+    getCacheIdentity(): string;
+    private session;
+    private call;
+    putEntries(entries: StoreEntry[]): Promise<void>;
+    applyWitnessReceipts(receipts: StoreEntryMetadata[]): Promise<void>;
+    getEntries(ids: string[]): Promise<StoreEntry[]>;
+    getEntryMetadata(id: string): Promise<StoreEntryMetadata | null>;
+    hasEntries(ids: string[]): Promise<string[]>;
+    findNewEntries(knownIds: string[]): Promise<StoreEntryMetadata[]>;
+    findNewEntriesForDoc(knownIds: string[], docId: string): Promise<StoreEntryMetadata[]>;
+    findEntries(type: StoreEntry["entryType"], from: number | null, until: number | null): Promise<StoreEntryMetadata[]>;
+    getAllIds(): Promise<string[]>;
+    scanEntriesSince(cursor: StoreScanCursor | null, limit?: number, filters?: StoreScanFilters): Promise<StoreScanResult>;
+    getIdBloomSummary(): Promise<StoreIdBloomSummary>;
+    getStoreHead(): Promise<StoreHead>;
+    planDocumentMaterialization(docId: string, options?: MaterializationPlanOptions): Promise<DocumentMaterializationPlan>;
+    planDocumentMaterializationBatch(docIds: string[], options?: MaterializationPlanOptions): Promise<DocumentMaterializationBatchPlan>;
+    resolveDependencies(startId: string, options?: Record<string, unknown>): Promise<string[]>;
+    purgeDocHistory(docId: string): Promise<void>;
+}
+export type IrohRpcHandler = (method: string, args: unknown[], ctx?: IrohRpcContext) => Promise<unknown>;
+export declare function createStoreIrohHandler(store: ContentAddressedStore): IrohRpcHandler;
+export declare function serveIrohRpc(stream: IrohByteStream, handler: IrohRpcHandler): Promise<void>;
+export declare function listenForIrohPeers(io: IrohStreamIO, handler: IrohRpcHandler, options?: {
+    signal?: AbortSignal;
+}): Promise<void>;
+//# sourceMappingURL=IrohNetworkTransport.d.ts.map

package/dist/core/appendonlystores/network/IrohNetworkTransport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IrohNetworkTransport.d.ts","sourceRoot":"","sources":["../../../../src/core/appendonlystores/network/IrohNetworkTransport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,qBAAqB,EACtB,MAAM,aAAa,CAAC;AACrB,OAAO,KAAK,EACV,kBAAkB,EAClB,yBAAyB,EACzB,qBAAqB,EACrB,gCAAgC,EAChC,2BAA2B,EAC3B,0BAA0B,EAC1B,aAAa,EACb,SAAS,EACV,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,gBAAgB,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAC;AACnF,OAAO,KAAK,EACV,UAAU,EACV,qBAAqB,EACrB,uBAAuB,EACvB,4BAA4B,EAC5B,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB,OAAO,EAIL,KAAK,cAAc,EAGnB,KAAK,YAAY,EACjB,KAAK,cAAc,EACpB,MAAM,gBAAgB,CAAC;AAExB,YAAY,EAAE,cAAc,EAAE,CAAC;AAsB/B;;;GAGG;AACH,qBAAa,oBAAqB,YAAW,gBAAgB;IAKzD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,MAAM;IANzB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAA+B;gBAG1B,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,sBAAsB;IAGjD,WAAW,IAAI,MAAM;IAIrB,OAAO,CAAC,UAAU;YAQJ,OAAO;YAOP,IAAI;IAIlB,aAAa,IAAI,OAAO,CAAC,OAAO,CAAC;IAIjC,gCAAgC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,YAAY,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAOzG,gBAAgB,CAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,gBAAgB,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAI7F,YAAY,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,GAAG,OAAO,CAAC,UAAU,CAAC;IAI3E,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAIhE,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAI/E,oBAAoB,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIpG,WAAW,CACT,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,cAAc,EACpB,gBAAgB,EAAE,MAAM,GAAG,IAAI,EAC/B,iBAAiB,EAAE,MAAM,GAAG,IAAI,GAC/B,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAIhC,gBAAgB,CACd,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,eAAe,GAAG,IAAI,EAC9B,KAAK,CAAC,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,eAAe,CAAC;IAI3B,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAI9D,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAI/C,mBAAmB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,qBAAqB,CAAC;IAIlE,2BAA2B,CACzB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,2BAA2B,CAAC;IAIvC,gCAAgC,CAC9B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EAAE,EAChB,OAAO,CAAC,EAAE,0BAA0B,GACnC,OAAO,CAAC,gCAAgC,CAAC;IAI5C,mCAAmC,CACjC,KAAK,EAAE,MAAM,EACb,WAAW,EAAE,MAAM,EACnB,cAAc,EAAE,MAAM,EACtB,OAAO,EAAE,yBAAyB,GACjC,OAAO,CAAC,kBAAkB,CAAC;IAI9B,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,qBAAqB,EAAE,CAAC;IAI1E,wBAAwB,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC;IAI7F,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAI/E,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC;IAIxE,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3D,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAI3C,mBAAmB,CACjB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAChC,OAAO,CAAC,MAAM,EAAE,CAAC;IAId,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,CAAC,KAAK,EAAE,gBAAgB,KAAK,IAAI,EAC1C,OAAO,CAAC,EAAE;QAAE,MAAM,CAAC,EAAE,WAAW,CAAA;KAAE,GACjC,OAAO,CAAC,IAAI,CAAC;CAcjB;AAED;;;GAGG;AACH,qBAAa,aAAc,YAAW,qBAAqB;IAKvD,OAAO,CAAC,QAAQ,CAAC,EAAE;IACnB,OAAO,CAAC,QAAQ,CAAC,UAAU;IAC3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IACrB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAP5B,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,MAAM,CAA+B;gBAG1B,EAAE,EAAE,YAAY,EAChB,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,UAAU,CAAC,qBAAqB,CAAC,cAAc,CAAC,CAAC;IAG/E,KAAK,IAAI,MAAM;IAIf,YAAY;IAIZ,gBAAgB,IAAI,MAAM;YAIZ,OAAO;YAOP,IAAI;IAIlB,UAAU,CAAC,OAAO,EAAE,UAAU,EAAE,GACqB,OAAO,CAAC,IAAI,CAAC;IAGlE,oBAAoB,CAAC,QAAQ,EAAE,kBAAkB,EAAE,GACa,OAAO,CAAC,IAAI,CAAC;IAG7E,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GACyB,OAAO,CAAC,UAAU,EAAE,CAAC;IAGtE,gBAAgB,CAAC,EAAE,EAAE,MAAM,GAC2B,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC;IAGxF,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GACyB,OAAO,CAAC,MAAM,EAAE,CAAC;IAGlE,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,GACyB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAGvF,oBAAoB,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,MAAM,GACiB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAGpG,WAAW,CAAC,IAAI,EAAE,UAAU,CAAC,WAAW,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,IAAI,GACpB,OAAO,CAAC,kBAAkB,EAAE,CAAC;IAG7F,SAAS,IACoC,OAAO,CAAC,MAAM,EAAE,CAAC;IAG9D,gBAAgB,CAAC,MAAM,EAAE,eAAe,GAAG,IAAI,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GACjB,OAAO,CAAC,eAAe,CAAC;IAGlG,iBAAiB,IACoC,OAAO,CAAC,mBAAmB,CAAC;IAGjF,YAAY,IACoC,OAAO,CAAC,SAAS,CAAC;IAGlE,2BAA2B,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,0BAA0B,GACF,OAAO,CAAC,2BAA2B,CAAC;IAGjH,gCAAgC,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,0BAA0B,GACJ,OAAO,CAAC,gCAAgC,CAAC;IAG5H,mBAAmB,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACC,OAAO,CAAC,MAAM,EAAE,CAAC;IAGxF,eAAe,CAAC,KAAK,EAAE,MAAM,GAC2B,OAAO,CAAC,IAAI,CAAC;CAEtE;AAED,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,OAAO,EAAE,EACf,GAAG,CAAC,EAAE,cAAc,KACjB,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,qBAAqB,GAAG,cAAc,CASnF;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAoBjG;AAED,wBAAsB,kBAAkB,CACtC,EAAE,EAAE,YAAY,EAChB,OAAO,EAAE,cAAc,EACvB,OAAO,CAAC,EAAE;IAAE,MAAM,CAAC,EAAE,WAAW,CAAA;CAAE,GACjC,OAAO,CAAC,IAAI,CAAC,CAWf"}

package/dist/core/appendonlystores/network/IrohNetworkTransport.js

@@ -0,0 +1,260 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IrohPeerStore = exports.IrohNetworkTransport = void 0;
+exports.createStoreIrohHandler = createStoreIrohHandler;
+exports.serveIrohRpc = serveIrohRpc;
+exports.listenForIrohPeers = listenForIrohPeers;
+const types_1 = require("./types");
+const IrohStreamIO_1 = require("./IrohStreamIO");
+async function rpcCall(stream, method, args, id, ctx) {
+    const request = { id, method, args, ctx };
+    await stream.send((0, IrohStreamIO_1.encodeIrohFrame)(request));
+    const bytes = await stream.recv();
+    if (!bytes) {
+        throw new types_1.NetworkError(types_1.NetworkErrorType.NETWORK_ERROR, "Iroh stream closed");
+    }
+    const response = (0, IrohStreamIO_1.decodeIrohFrame)(bytes);
+    if (!response.ok) {
+        throw new types_1.NetworkError(types_1.NetworkErrorType.NETWORK_ERROR, response.error ?? "Iroh RPC failed");
+    }
+    return response.result;
+}
+/**
+ * NetworkTransport over Iroh QUIC streams (ALPN {@link MINDOODB_IROH_ALPN}).
+ * Each method is one framed request/response. Pairing uses Iroh tickets.
+ */
+class IrohNetworkTransport {
+    constructor(io, peerTicket, config) {
+        this.io = io;
+        this.peerTicket = peerTicket;
+        this.config = config;
+        this.nextId = 1;
+        this.stream = null;
+    }
+    getIdentity() {
+        return `iroh:${this.peerTicket}`;
+    }
+    rpcContext() {
+        return {
+            tenantId: this.config.tenantId,
+            dbId: this.config.dbId,
+            storeKind: this.config.storeKind,
+        };
+    }
+    async session() {
+        if (!this.stream) {
+            this.stream = await this.io.connect(this.peerTicket, IrohStreamIO_1.MINDOODB_IROH_ALPN);
+        }
+        return this.stream;
+    }
+    async call(method, args) {
+        return rpcCall(await this.session(), method, args, this.nextId++, this.rpcContext());
+    }
+    getServerInfo() {
+        return this.call("getServerInfo", []);
+    }
+    getTenantPublicInfosFingerprints(tenantId) {
+        return this.call("getTenantPublicInfosFingerprints", [tenantId]);
+    }
+    requestChallenge(username, options) {
+        return this.call("requestChallenge", [username, options]);
+    }
+    authenticate(challenge, signature) {
+        return this.call("authenticate", [challenge, signature]);
+    }
+    getCapabilities(token) {
+        return this.call("getCapabilities", [token]);
+    }
+    findNewEntries(token, haveIds) {
+        return this.call("findNewEntries", [token, haveIds]);
+    }
+    findNewEntriesForDoc(token, haveIds, docId) {
+        return this.call("findNewEntriesForDoc", [token, haveIds, docId]);
+    }
+    findEntries(token, type, creationDateFrom, creationDateUntil) {
+        return this.call("findEntries", [token, type, creationDateFrom, creationDateUntil]);
+    }
+    scanEntriesSince(token, cursor, limit, filters) {
+        return this.call("scanEntriesSince", [token, cursor, limit, filters]);
+    }
+    getIdBloomSummary(token) {
+        return this.call("getIdBloomSummary", [token]);
+    }
+    getStoreHead(token) {
+        return this.call("getStoreHead", [token]);
+    }
+    getCompactionStatus(token) {
+        return this.call("getCompactionStatus", [token]);
+    }
+    planDocumentMaterialization(token, docId, options) {
+        return this.call("planDocumentMaterialization", [token, docId, options]);
+    }
+    planDocumentMaterializationBatch(token, docIds, options) {
+        return this.call("planDocumentMaterializationBatch", [token, docIds, options]);
+    }
+    planAttachmentReadByWalkingMetadata(token, lastChunkId, attachmentSize, options) {
+        return this.call("planAttachmentReadByWalkingMetadata", [token, lastChunkId, attachmentSize, options]);
+    }
+    getEntries(token, ids) {
+        return this.call("getEntries", [token, ids]);
+    }
+    getEntriesSessionWrapped(token, ids) {
+        return this.call("getEntriesSessionWrapped", [token, ids]);
+    }
+    getEntryMetadata(token, id) {
+        return this.call("getEntryMetadata", [token, id]);
+    }
+    putEntries(token, entries) {
+        return this.call("putEntries", [token, entries]);
+    }
+    hasEntries(token, ids) {
+        return this.call("hasEntries", [token, ids]);
+    }
+    getAllIds(token) {
+        return this.call("getAllIds", [token]);
+    }
+    resolveDependencies(token, startId, options) {
+        return this.call("resolveDependencies", [token, startId, options]);
+    }
+    async subscribeToChanges(token, onEvent, options) {
+        const stream = await this.session();
+        await stream.send((0, IrohStreamIO_1.encodeIrohFrame)({ id: this.nextId++, method: "subscribeToChanges", args: [token] }));
+        while (!options?.signal?.aborted) {
+            const bytes = await stream.recv();
+            if (!bytes) {
+                return;
+            }
+            const frame = (0, IrohStreamIO_1.decodeIrohFrame)(bytes);
+            if ("dbId" in frame && "storeKind" in frame) {
+                onEvent(frame);
+            }
+        }
+    }
+}
+exports.IrohNetworkTransport = IrohNetworkTransport;
+/**
+ * ContentAddressedStore proxy over Iroh. Entries stay E2E-encrypted; no extra
+ * RSA wrap. Use with `pullChangesFrom` / `pushChangesTo` between devices.
+ */
+class IrohPeerStore {
+    constructor(io, peerTicket, dbId, storeKind) {
+        this.io = io;
+        this.peerTicket = peerTicket;
+        this.dbId = dbId;
+        this.storeKind = storeKind;
+        this.nextId = 1;
+        this.stream = null;
+    }
+    getId() {
+        return this.dbId;
+    }
+    getStoreKind() {
+        return this.storeKind;
+    }
+    getCacheIdentity() {
+        return `iroh:${this.peerTicket}:${this.dbId}:${this.storeKind}`;
+    }
+    async session() {
+        if (!this.stream) {
+            this.stream = await this.io.connect(this.peerTicket, IrohStreamIO_1.MINDOODB_IROH_ALPN);
+        }
+        return this.stream;
+    }
+    async call(method, args) {
+        return rpcCall(await this.session(), method, args, this.nextId++);
+    }
+    putEntries(entries) {
+        return this.call("store.putEntries", [entries]);
+    }
+    applyWitnessReceipts(receipts) {
+        return this.call("store.applyWitnessReceipts", [receipts]);
+    }
+    getEntries(ids) {
+        return this.call("store.getEntries", [ids]);
+    }
+    getEntryMetadata(id) {
+        return this.call("store.getEntryMetadata", [id]);
+    }
+    hasEntries(ids) {
+        return this.call("store.hasEntries", [ids]);
+    }
+    findNewEntries(knownIds) {
+        return this.call("store.findNewEntries", [knownIds]);
+    }
+    findNewEntriesForDoc(knownIds, docId) {
+        return this.call("store.findNewEntriesForDoc", [knownIds, docId]);
+    }
+    findEntries(type, from, until) {
+        return this.call("store.findEntries", [type, from, until]);
+    }
+    getAllIds() {
+        return this.call("store.getAllIds", []);
+    }
+    scanEntriesSince(cursor, limit, filters) {
+        return this.call("store.scanEntriesSince", [cursor, limit, filters]);
+    }
+    getIdBloomSummary() {
+        return this.call("store.getIdBloomSummary", []);
+    }
+    getStoreHead() {
+        return this.call("store.getStoreHead", []);
+    }
+    planDocumentMaterialization(docId, options) {
+        return this.call("store.planDocumentMaterialization", [docId, options]);
+    }
+    planDocumentMaterializationBatch(docIds, options) {
+        return this.call("store.planDocumentMaterializationBatch", [docIds, options]);
+    }
+    resolveDependencies(startId, options) {
+        return this.call("store.resolveDependencies", [startId, options]);
+    }
+    purgeDocHistory(docId) {
+        return this.call("store.purgeDocHistory", [docId]);
+    }
+}
+exports.IrohPeerStore = IrohPeerStore;
+function createStoreIrohHandler(store) {
+    return async (method, args) => {
+        const name = method.startsWith("store.") ? method.slice(6) : method;
+        const fn = store[name];
+        if (typeof fn !== "function") {
+            throw new Error(`Unknown Iroh store method ${method}`);
+        }
+        return fn.apply(store, args);
+    };
+}
+async function serveIrohRpc(stream, handler) {
+    while (true) {
+        const bytes = await stream.recv();
+        if (!bytes) {
+            return;
+        }
+        const request = (0, IrohStreamIO_1.decodeIrohFrame)(bytes);
+        try {
+            const result = await handler(request.method, request.args, request.ctx);
+            const response = { id: request.id, ok: true, result };
+            await stream.send((0, IrohStreamIO_1.encodeIrohFrame)(response));
+        }
+        catch (error) {
+            const response = {
+                id: request.id,
+                ok: false,
+                error: error instanceof Error ? error.message : String(error),
+            };
+            await stream.send((0, IrohStreamIO_1.encodeIrohFrame)(response));
+        }
+    }
+}
+async function listenForIrohPeers(io, handler, options) {
+    if (!io.listen) {
+        throw new Error("IrohStreamIO.listen is required to accept peers");
+    }
+    for await (const stream of io.listen(IrohStreamIO_1.MINDOODB_IROH_ALPN)) {
+        if (options?.signal?.aborted) {
+            await stream.close();
+            return;
+        }
+        void serveIrohRpc(stream, handler);
+    }
+}
+//# sourceMappingURL=IrohNetworkTransport.js.map

package/dist/core/appendonlystores/network/IrohNetworkTransport.js.map

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

package/dist/core/appendonlystores/network/IrohStreamIO.d.ts

@@ -0,0 +1,121 @@
+/**
+ * Byte-stream IO used by {@link IrohNetworkTransport}.
+ *
+ * `react-native-iroh` implements this with `endpoint.streams` (ALPN
+ * `mindoodb/sync-v5`). The Node server uses `@number0/iroh`. Tests use
+ * {@link createLoopbackIrohPair}.
+ */
+export declare const MINDOODB_IROH_ALPN = "mindoodb/sync-v5";
+/**
+ * One bidirectional QUIC/byte stream between two Iroh endpoints.
+ * {@link IrohNetworkTransport} sends one framed RPC request and reads one
+ * response on the same stream.
+ */
+export interface IrohByteStream {
+    /**
+     * Write one complete message. Native QUIC adapters should wrap this with
+     * {@link wrapLengthPrefixedByteStream} so `recv` can reassemble frames.
+     *
+     * @param bytes Encoded frame, typically from {@link encodeIrohFrame}
+     */
+    send(bytes: Uint8Array): Promise<void>;
+    /**
+     * Read the next complete message, or `null` when the peer closed the stream.
+     *
+     * @returns The next frame, or `null` on clean close
+     */
+    recv(): Promise<Uint8Array | null>;
+    /** Finish the send side and release the stream. */
+    close(): Promise<void>;
+}
+/**
+ * Local Iroh endpoint: publish a ticket, dial a peer, and optionally accept
+ * inbound streams on {@link MINDOODB_IROH_ALPN}.
+ */
+export interface IrohStreamIO {
+    /**
+     * Return the stable local ticket (or endpoint id) other peers can dial.
+     * Native bindings usually return an `endpoint…` ticket; loopback uses
+     * `loopback:a` / `loopback:b`.
+     */
+    getLocalTicket(): Promise<string>;
+    /**
+     * Open an outbound stream to `peerTicket`.
+     *
+     * @param peerTicket Remote Iroh ticket or loopback id
+     * @param alpn Protocol, defaults to {@link MINDOODB_IROH_ALPN}
+     */
+    connect(peerTicket: string, alpn?: string): Promise<IrohByteStream>;
+    /**
+     * Yield inbound streams. Required on the server / listener side; a
+     * client-only IO may omit it.
+     *
+     * @param alpn Protocol, defaults to {@link MINDOODB_IROH_ALPN}
+     */
+    listen?(alpn?: string): AsyncIterable<IrohByteStream>;
+}
+/**
+ * Tenant / store scope sent with every Iroh RPC. HTTP puts the same values
+ * in the URL (`/t/:tenantId/d/:dbId/…`).
+ */
+export interface IrohRpcContext {
+    tenantId?: string;
+    dbId?: string;
+    storeKind?: string;
+}
+/** One JSON-RPC-style request written as a single {@link IrohByteStream} frame. */
+export interface IrohRpcRequest {
+    /** Correlation id; the response echoes the same value. */
+    id: number;
+    method: string;
+    args: unknown[];
+    ctx?: IrohRpcContext;
+}
+/** Matching response for {@link IrohRpcRequest.id}. */
+export interface IrohRpcResponse {
+    id: number;
+    ok: boolean;
+    result?: unknown;
+    error?: string;
+}
+/**
+ * Serialize an RPC request or response to UTF-8 JSON. `Uint8Array` fields
+ * become `{ $bytes: "<base64>" }` so they survive `JSON.stringify`.
+ *
+ * @param payload {@link IrohRpcRequest} or {@link IrohRpcResponse}
+ */
+export declare function encodeIrohFrame(payload: unknown): Uint8Array;
+/**
+ * Length-prefix a message-oriented {@link IrohByteStream} on top of a raw
+ * QUIC/byte stream. Each `send` writes a big-endian uint32 length plus the
+ * payload; `recv` reads that header and then exactly that many bytes.
+ * Frames larger than 32 MiB are rejected. Loopback tests stay
+ * message-oriented and do not use this.
+ *
+ * @param raw Unframed write/read/close used by `@number0/iroh` (and similar)
+ */
+export declare function wrapLengthPrefixedByteStream(raw: {
+    write(bytes: Uint8Array): Promise<void>;
+    read(max: number): Promise<Uint8Array | null>;
+    close(): Promise<void>;
+}): IrohByteStream;
+/**
+ * Inverse of {@link encodeIrohFrame}: parse UTF-8 JSON and restore
+ * `{ $bytes }` objects to `Uint8Array`.
+ *
+ * @param bytes One complete frame from {@link IrohByteStream.recv}
+ */
+export declare function decodeIrohFrame(bytes: Uint8Array): unknown;
+/**
+ * Two {@link IrohStreamIO} instances that dial each other in-process
+ * (`loopback:a` ↔ `loopback:b`). Used by unit tests and the Expo two-peer
+ * spike without native Iroh. Streams are already message-oriented; do not
+ * wrap them with {@link wrapLengthPrefixedByteStream}.
+ *
+ * @returns Pair whose `connect` only accepts the other side's ticket
+ */
+export declare function createLoopbackIrohPair(): {
+    a: IrohStreamIO;
+    b: IrohStreamIO;
+};
+//# sourceMappingURL=IrohStreamIO.d.ts.map

package/dist/core/appendonlystores/network/IrohStreamIO.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IrohStreamIO.d.ts","sourceRoot":"","sources":["../../../../src/core/appendonlystores/network/IrohStreamIO.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC;;;;OAIG;IACH,IAAI,IAAI,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IACnC,mDAAmD;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAED;;;GAGG;AACH,MAAM,WAAW,YAAY;IAC3B;;;;OAIG;IACH,cAAc,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAClC;;;;;OAKG;IACH,OAAO,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpE;;;;;OAKG;IACH,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,GAAG,aAAa,CAAC,cAAc,CAAC,CAAC;CACvD;AAED;;;GAGG;AACH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,mFAAmF;AACnF,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;IAChB,GAAG,CAAC,EAAE,cAAc,CAAC;CACtB;AAED,uDAAuD;AACvD,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,EAAE,EAAE,OAAO,CAAC;IACZ,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAKD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,UAAU,CAE5D;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAAC,GAAG,EAAE;IAChD,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC9C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB,GAAG,cAAc,CAyCjB;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAE1D;AAoFD;;;;;;;GAOG;AACH,wBAAgB,sBAAsB,IAAI;IAAE,CAAC,EAAE,YAAY,CAAC;IAAC,CAAC,EAAE,YAAY,CAAA;CAAE,CAmD7E"}