@powerhousedao/reactor-browser 6.0.0-dev.9 → 6.0.0-dev.91

package/dist/src/package-manager.d.ts

@@ -0,0 +1,32 @@
+import type { IDocumentModelLoader, IDocumentModelRegistry } from "@powerhousedao/reactor";
+import type { DocumentModelModule } from "document-model";
+import type { IPackageListerUnsubscribe, IPackageManager, IPackagesListener, VetraPackage } from "./types/vetra.js";
+export interface PendingInstallation {
+    documentType: string;
+    packageName: string;
+}
+export interface DismissedPackage {
+    packageName: string;
+    documentTypes: string[];
+}
+export type PendingInstallationsListener = () => void;
+export declare class BrowserPackageManager implements IPackageManager, IDocumentModelLoader {
+    #private;
+    constructor(namespace: string, registryCdnUrl?: string);
+    init(): Promise<void>;
+    get packages(): VetraPackage[];
+    get localPackageIds(): Set<string>;
+    addPackage(name: string, registryUrl: string): Promise<void>;
+    addLocalPackage(name: string, localPackage: VetraPackage): Promise<void>;
+    removePackage(name: string): Promise<void>;
+    subscribe(handler: IPackagesListener): IPackageListerUnsubscribe;
+    setDocumentModelRegistry(registry: IDocumentModelRegistry): void;
+    load(documentType: string): Promise<DocumentModelModule<any>>;
+    approveInstallation(packageName: string): Promise<void>;
+    rejectInstallation(packageName: string): void;
+    subscribePendingChanges(listener: PendingInstallationsListener): () => void;
+    getPendingInstallations(): PendingInstallation[];
+    getDismissedPackages(): DismissedPackage[];
+    removeDismissed(packageName: string): void;
+}
+//# sourceMappingURL=package-manager.d.ts.map

package/dist/src/package-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"package-manager.d.ts","sourceRoot":"","sources":["../../src/package-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAoB,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAG5E,OAAO,KAAK,EACV,yBAAyB,EACzB,eAAe,EACf,iBAAiB,EAEjB,YAAY,EACb,MAAM,kBAAkB,CAAC;AAG1B,MAAM,WAAW,mBAAmB;IAClC,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,4BAA4B,GAAG,MAAM,IAAI,CAAC;AA+DtD,qBAAa,qBACX,YAAW,eAAe,EAAE,oBAAoB;;gBAiBpC,SAAS,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM;IAgBhD,IAAI;IAWV,IAAI,QAAQ,mBAEX;IAED,IAAI,eAAe,IAAI,GAAG,CAAC,MAAM,CAAC,CAEjC;IAEK,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM;IAe5C,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,YAAY,EAAE,YAAY;IAMxD,aAAa,CAAC,IAAI,EAAE,MAAM;IAShC,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,yBAAyB;IAiBhE,wBAAwB,CAAC,QAAQ,EAAE,sBAAsB,GAAG,IAAI;IAI1D,IAAI,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC,GAAG,CAAC,CAAC;IA0B7D,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA8C7D,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAiB7C,uBAAuB,CAAC,QAAQ,EAAE,4BAA4B,GAAG,MAAM,IAAI;IAO3E,uBAAuB,IAAI,mBAAmB,EAAE;IAIhD,oBAAoB,IAAI,gBAAgB,EAAE;IAI1C,eAAe,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;CA6B3C"}

package/dist/src/pglite/drop.d.ts

@@ -1,3 +1,4 @@
 import type { PGlite } from "@electric-sql/pglite";
 export declare function dropAllTables(pg: PGlite, schema?: string): Promise<void>;
+export declare function dropAllReactorStorage(pg: PGlite): Promise<void>;
 //# sourceMappingURL=drop.d.ts.map

package/dist/src/pglite/drop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../src/pglite/drop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,MAAuB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAgBf"}
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../src/pglite/drop.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAqBnD,wBAAsB,aAAa,CACjC,EAAE,EAAE,MAAM,EACV,MAAM,GAAE,MAAuB,GAC9B,OAAO,CAAC,IAAI,CAAC,CAEf;AAED,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAKrE"}

package/dist/src/pglite/index.d.ts

@@ -1,3 +1,3 @@
-export { dropAllTables as truncateAllTables } from "./drop.js";
+export { dropAllTables as truncateAllTables, dropAllReactorStorage, } from "./drop.js";
 export * from "./hooks/index.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/src/pglite/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pglite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,IAAI,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC/D,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/pglite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,IAAI,iBAAiB,EAClC,qBAAqB,GACtB,MAAM,WAAW,CAAC;AACnB,cAAc,kBAAkB,CAAC"}

package/dist/src/re-exports.d.ts

@@ -0,0 +1,3 @@
+export { ChannelScheme, ConsoleLogger, DocumentChangeType, DocumentIntegrityService, driveCollectionId, GqlRequestChannel, InMemoryQueue, IntervalPollTimer, REACTOR_SCHEMA, ReactorBuilder, ReactorClientBuilder, RelationalDbProcessor, SyncOperationStatus, } from "@powerhousedao/reactor";
+export type { ConnectionState, ConnectionStateSnapshot, Database, IChannel, IDocumentModelLoader, IProcessor, IProcessorHostModule, IRelationalDb, Job, JwtHandler, KeyframeValidationIssue, OperationWithContext, ProcessorFactory, ProcessorFilter, ProcessorRecord, RebuildResult, Remote, SignerConfig, SnapshotValidationIssue, SyncOperation, ValidationResult, } from "@powerhousedao/reactor";
+//# sourceMappingURL=re-exports.d.ts.map

package/dist/src/re-exports.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"re-exports.d.ts","sourceRoot":"","sources":["../../src/re-exports.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,aAAa,EACb,aAAa,EACb,kBAAkB,EAClB,wBAAwB,EACxB,iBAAiB,EACjB,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,oBAAoB,EACpB,qBAAqB,EACrB,mBAAmB,GACpB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,eAAe,EACf,uBAAuB,EACvB,QAAQ,EACR,QAAQ,EACR,oBAAoB,EACpB,UAAU,EACV,oBAAoB,EACpB,aAAa,EACb,GAAG,EACH,UAAU,EACV,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,eAAe,EACf,aAAa,EACb,MAAM,EACN,YAAY,EACZ,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,wBAAwB,CAAC"}

package/dist/src/reactor-client-document-cache.d.ts

@@ -6,8 +6,6 @@ import type { IDocumentCache } from "./types/documents.js";
  *
  * This cache subscribes to document change events via IReactorClient.subscribe()
  * and automatically updates the cache when documents are created, updated, or deleted.
- *
- * Use this implementation when FEATURE_LEGACY_READ_ENABLED is false.
  */
 export declare class ReactorClientDocumentCache implements IDocumentCache {
     private client;

package/dist/src/reactor-client-document-cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactor-client-document-cache.d.ts","sourceRoot":"","sources":["../../src/reactor-client-document-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B;;;;;;;GAOG;AACH,qBAAa,0BAA2B,YAAW,cAAc;IASnD,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,SAAS,CAAmD;IACpE,OAAO,CAAC,aAAa,CAGjB;IACJ,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,WAAW,CAA6B;gBAE5B,MAAM,EAAE,cAAc;IAM1C,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,qBAAqB;YAUf,qBAAqB;IAUnC,OAAO,CAAC,2BAA2B;IAQnC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAkBvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA2D9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAiBlE;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}
+{"version":3,"file":"reactor-client-document-cache.d.ts","sourceRoot":"","sources":["../../src/reactor-client-document-cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEjD,OAAO,KAAK,EAEV,cAAc,EAEf,MAAM,sBAAsB,CAAC;AAE9B;;;;;GAKG;AACH,qBAAa,0BAA2B,YAAW,cAAc;IASnD,OAAO,CAAC,MAAM;IAR1B,OAAO,CAAC,SAAS,CAAmD;IACpE,OAAO,CAAC,aAAa,CAGjB;IACJ,OAAO,CAAC,SAAS,CAAqC;IACtD,OAAO,CAAC,WAAW,CAA6B;gBAE5B,MAAM,EAAE,cAAc;IAM1C,OAAO,CAAC,oBAAoB;IAa5B,OAAO,CAAC,qBAAqB;YAUf,qBAAqB;IAUnC,OAAO,CAAC,2BAA2B;IAQnC,GAAG,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,UAAU,CAAC;IAgBvD,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IA2D9C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,IAAI,GAAG,MAAM,IAAI;IAiBlE;;OAEG;IACH,OAAO,IAAI,IAAI;CAMhB"}

package/dist/src/reactor.d.ts

@@ -1,7 +1,6 @@
 import type { IReactorClient } from "@powerhousedao/reactor";
-import type { IConnectCrypto, IRenown } from "@renown/sdk";
-import { ConnectCrypto } from "@renown/sdk";
-import type { DocumentDriveDocument, DocumentDriveServerOptions, IDocumentDriveServer } from "document-drive";
+import type { IRenown } from "@renown/sdk";
+import { type DocumentDriveServerOptions, type IDocumentDriveServer } from "document-drive";
 export type ReactorDefaultDrivesConfig = {
     defaultDrivesUrl?: string[];
 };
@@ -10,9 +9,19 @@ export type RefreshReactorDataConfig = {
     debounceDelayMs?: number;
     immediateThresholdMs?: number;
 };
-export declare const refreshReactorData: (reactor: IDocumentDriveServer | undefined, immediate?: boolean) => Promise<void>;
+export declare const refreshReactorData: (reactor: IReactorClient, immediate?: boolean) => Promise<void>;
 export declare const refreshReactorDataClient: (reactor: IReactorClient | undefined, immediate?: boolean) => Promise<void>;
-export declare function initLegacyReactor(legacyReactor: IDocumentDriveServer, renown: IRenown | undefined, connectCrypto: IConnectCrypto | undefined): Promise<void>;
-export declare function handleCreateFirstLocalDrive(reactor: IDocumentDriveServer | undefined, localDrivesEnabled?: boolean): Promise<DocumentDriveDocument | undefined>;
-export declare function initConnectCrypto(): Promise<ConnectCrypto>;
+export declare function initLegacyReactor(legacyReactor: IDocumentDriveServer, renown: IRenown | undefined): Promise<void>;
+/**
+ * @deprecated Use {@link initRenownCrypto} instead
+ *
+ * Initialize ConnectCrypto
+ * @returns ConnectCrypto instance
+ */
+export declare function initConnectCrypto(): Promise<import("@renown/sdk").RenownCrypto>;
+/**
+ * Initialize RenownCrypto
+ * @returns RenownCrypto instance
+ */
+export declare function initRenownCrypto(): Promise<import("@renown/sdk").RenownCrypto>;
 //# sourceMappingURL=reactor.d.ts.map

package/dist/src/reactor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"reactor.d.ts","sourceRoot":"","sources":["../../src/reactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAqB,aAAa,EAAE,MAAM,aAAa,CAAC;AAC/D,OAAO,KAAK,EAEV,qBAAqB,EACrB,0BAA0B,EAC1B,oBAAoB,EACrB,MAAM,gBAAgB,CAAC;AAKxB,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,SAAQ,0BAA+B,KACtC,IAAI,CAAC,0BAA0B,EAAE,eAAe,CA6ClD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAkFF,eAAO,MAAM,kBAAkB,YAzDZ,oBAAoB,GAAG,SAAS,uCAyDkB,CAAC;AACtE,eAAO,MAAM,wBAAwB,YA1BlB,cAAc,GAAG,SAAS,uCA2BF,CAAC;AAE5C,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,oBAAoB,EACnC,MAAM,EAAE,OAAO,GAAG,SAAS,EAC3B,aAAa,EAAE,cAAc,GAAG,SAAS,iBAQ1C;AAED,wBAAsB,2BAA2B,CAC/C,OAAO,EAAE,oBAAoB,GAAG,SAAS,EACzC,kBAAkB,UAAO,8CAyB1B;AAsBD,wBAAsB,iBAAiB,2BAItC"}
+{"version":3,"file":"reactor.d.ts","sourceRoot":"","sources":["../../src/reactor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAGL,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,EAC1B,MAAM,gBAAgB,CAAC;AAIxB,MAAM,MAAM,0BAA0B,GAAG;IACvC,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAC;CAC7B,CAAC;AAEF,eAAO,MAAM,6BAA6B,GACxC,SAAQ,0BAA+B,KACtC,IAAI,CAAC,0BAA0B,EAAE,eAAe,CA6ClD,CAAC;AAEF,MAAM,MAAM,wBAAwB,GAAG;IACrC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAkFF,eAAO,MAAM,kBAAkB,YAzDZ,cAAc,uCAyDoC,CAAC;AACtE,eAAO,MAAM,wBAAwB,YA1BlB,cAAc,GAAG,SAAS,uCA2BF,CAAC;AAE5C,wBAAsB,iBAAiB,CACrC,aAAa,EAAE,oBAAoB,EACnC,MAAM,EAAE,OAAO,GAAG,SAAS,iBAQ5B;AAmBD;;;;;GAKG;AACH,wBAAsB,iBAAiB,gDAEtC;AAED;;;GAGG;AACH,wBAAsB,gBAAgB,gDAGrC"}

package/dist/src/registry/client.d.ts

@@ -0,0 +1,9 @@
+import type { RegistryPackageInfo } from "./types.js";
+export declare class RegistryClient {
+    readonly apiUrl: string;
+    constructor(cdnUrl: string);
+    getPackages(): Promise<RegistryPackageInfo[]>;
+    getPackagesByDocumentType(documentType: string): Promise<string[]>;
+    searchPackages(query: string): Promise<RegistryPackageInfo[]>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/src/registry/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/registry/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AA8BtD,qBAAa,cAAc;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,MAAM;IAIpB,WAAW,IAAI,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAO7C,yBAAyB,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IASlE,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,EAAE,CAAC;CAUpE"}

package/dist/src/registry/index.d.ts

@@ -0,0 +1,3 @@
+export { RegistryClient } from "./client.js";
+export type { RegistryPackageInfo } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/registry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/registry/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAC7C,YAAY,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/registry/types.d.ts

@@ -0,0 +1,9 @@
+export interface RegistryPackageInfo {
+    name: string;
+    description?: string;
+    version?: string;
+    category?: string;
+    publisher?: string;
+    publisherUrl?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/registry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/registry/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB"}

package/dist/src/relational/hooks/useRelationalDb.d.ts

@@ -1,12 +1,13 @@
 import type { LiveNamespace } from "@electric-sql/pglite/live";
-import type { IRelationalDb as _IRelationalDb } from "document-drive";
+import type { IRelationalDbLegacy as _IRelationalDb } from "document-drive";
 export type RelationalDbWithLive<Schema> = _IRelationalDb<Schema> & {
     live: LiveNamespace;
 };
-export interface IRelationalDb<Schema> {
+interface IRelationalDb<Schema> {
     db: RelationalDbWithLive<Schema> | null;
     isLoading: boolean;
     error: Error | null;
 }
 export declare const useRelationalDb: <Schema>() => IRelationalDb<Schema>;
+export {};
 //# sourceMappingURL=useRelationalDb.d.ts.map

package/dist/src/relational/hooks/useRelationalDb.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRelationalDb.d.ts","sourceRoot":"","sources":["../../../../src/relational/hooks/useRelationalDb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,aAAa,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQtE,MAAM,MAAM,oBAAoB,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG;IAClE,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,MAAM,WAAW,aAAa,CAAC,MAAM;IACnC,EAAE,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAkBD,eAAO,MAAM,eAAe,GAAI,MAAM,4BAsBrC,CAAC"}
+{"version":3,"file":"useRelationalDb.d.ts","sourceRoot":"","sources":["../../../../src/relational/hooks/useRelationalDb.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAkB,MAAM,2BAA2B,CAAC;AAC/E,OAAO,KAAK,EAAE,mBAAmB,IAAI,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAQ5E,MAAM,MAAM,oBAAoB,CAAC,MAAM,IAAI,cAAc,CAAC,MAAM,CAAC,GAAG;IAClE,IAAI,EAAE,aAAa,CAAC;CACrB,CAAC;AAEF,UAAU,aAAa,CAAC,MAAM;IAC5B,EAAE,EAAE,oBAAoB,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACxC,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAkBD,eAAO,MAAM,eAAe,GAAI,MAAM,4BAsBrC,CAAC"}

package/dist/src/relational/hooks/useRelationalQuery.d.ts

@@ -1,5 +1,5 @@
 import type { LiveQueryResults } from "@electric-sql/pglite/live";
-import type { IRelationalQueryBuilder, RelationalDbProcessorClass } from "document-drive";
+import type { IRelationalQueryBuilderLegacy, RelationalDbProcessorClassLegacy } from "document-drive";
 export type QueryCallbackReturnType = {
     sql: string;
     parameters?: readonly unknown[];
@@ -7,7 +7,7 @@ export type QueryCallbackReturnType = {
 export type useRelationalQueryOptions = {
     hashNamespace?: boolean;
 };
-export declare function useRelationalQuery<Schema, T = unknown, TParams = undefined>(ProcessorClass: RelationalDbProcessorClass<Schema>, driveId: string, queryCallback: (db: IRelationalQueryBuilder<Schema>, parameters?: TParams) => QueryCallbackReturnType, parameters?: TParams, options?: useRelationalQueryOptions): {
+export declare function useRelationalQuery<Schema, T = unknown, TParams = undefined>(ProcessorClass: RelationalDbProcessorClassLegacy<Schema>, driveId: string, queryCallback: (db: IRelationalQueryBuilderLegacy<Schema>, parameters?: TParams) => QueryCallbackReturnType, parameters?: TParams, options?: useRelationalQueryOptions): {
     readonly isLoading: boolean;
     readonly error: Error | null;
     readonly result: LiveQueryResults<T> | null;

package/dist/src/relational/hooks/useRelationalQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"useRelationalQuery.d.ts","sourceRoot":"","sources":["../../../../src/relational/hooks/useRelationalQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AAIxB,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IAEtC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAuBF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,GAAG,SAAS,EACzE,cAAc,EAAE,0BAA0B,CAAC,MAAM,CAAC,EAClD,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,CACb,EAAE,EAAE,uBAAuB,CAAC,MAAM,CAAC,EACnC,UAAU,CAAC,EAAE,OAAO,KACjB,uBAAuB,EAC5B,UAAU,CAAC,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE,yBAAyB;;;;EAiFpC"}
+{"version":3,"file":"useRelationalQuery.d.ts","sourceRoot":"","sources":["../../../../src/relational/hooks/useRelationalQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,gBAAgB,CAAC;AAIxB,MAAM,MAAM,uBAAuB,GAAG;IACpC,GAAG,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,SAAS,OAAO,EAAE,CAAC;CACjC,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAAG;IAEtC,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,CAAC;AAuBF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,EAAE,OAAO,GAAG,SAAS,EACzE,cAAc,EAAE,gCAAgC,CAAC,MAAM,CAAC,EACxD,OAAO,EAAE,MAAM,EACf,aAAa,EAAE,CACb,EAAE,EAAE,6BAA6B,CAAC,MAAM,CAAC,EACzC,UAAU,CAAC,EAAE,OAAO,KACjB,uBAAuB,EAC5B,UAAU,CAAC,EAAE,OAAO,EACpB,OAAO,CAAC,EAAE,yBAAyB;;;;EAiFpC"}

package/dist/src/relational/utils/createProcessorQuery.d.ts

@@ -1,14 +1,14 @@
 import type { LiveQueryResults } from "@electric-sql/pglite/live";
 import type { QueryCallbackReturnType, useRelationalQueryOptions } from "@powerhousedao/reactor-browser";
-import type { IRelationalQueryBuilder, RelationalDbProcessorClass } from "document-drive";
+import type { IRelationalQueryBuilderLegacy, RelationalDbProcessorClassLegacy } from "document-drive";
 import type { CompiledQuery } from "kysely";
-export declare function createProcessorQuery<TSchema>(ProcessorClass: RelationalDbProcessorClass<TSchema>): {
-    <TQueryBuilder extends (db: IRelationalQueryBuilder<TSchema>) => QueryCallbackReturnType>(driveId: string, queryCallback: TQueryBuilder): {
+export declare function createProcessorQuery<TSchema>(ProcessorClass: RelationalDbProcessorClassLegacy<TSchema>): {
+    <TQueryBuilder extends (db: IRelationalQueryBuilderLegacy<TSchema>) => QueryCallbackReturnType>(driveId: string, queryCallback: TQueryBuilder): {
         isLoading: boolean;
         error: Error | null;
         result: LiveQueryResults<ReturnType<TQueryBuilder> extends CompiledQuery<infer R> ? R : any> | null;
     };
-    <TParams, TQueryBuilder extends (db: IRelationalQueryBuilder<TSchema>, parameters: TParams) => QueryCallbackReturnType>(driveId: string, queryCallback: TQueryBuilder, parameters: TParams, options?: useRelationalQueryOptions): {
+    <TParams, TQueryBuilder extends (db: IRelationalQueryBuilderLegacy<TSchema>, parameters: TParams) => QueryCallbackReturnType>(driveId: string, queryCallback: TQueryBuilder, parameters: TParams, options?: useRelationalQueryOptions): {
         isLoading: boolean;
         error: Error | null;
         result: LiveQueryResults<ReturnType<TQueryBuilder> extends CompiledQuery<infer R> ? R : any> | null;

package/dist/src/relational/utils/createProcessorQuery.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"createProcessorQuery.d.ts","sourceRoot":"","sources":["../../../../src/relational/utils/createProcessorQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,uBAAuB,EACvB,0BAA0B,EAC3B,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAiB5C,wBAAgB,oBAAoB,CAAC,OAAO,EAC1C,cAAc,EAAE,0BAA0B,CAAC,OAAO,CAAC;KAIjD,aAAa,SAAS,CACpB,EAAE,EAAE,uBAAuB,CAAC,OAAO,CAAC,KACjC,uBAAuB,WAEnB,MAAM,iBACA,aAAa,GAC3B;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,gBAAgB,CACtB,UAAU,CAAC,aAAa,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CACnE,GAAG,IAAI,CAAC;KACV;KAIC,OAAO,EACP,aAAa,SAAS,CACpB,EAAE,EAAE,uBAAuB,CAAC,OAAO,CAAC,EACpC,UAAU,EAAE,OAAO,KAChB,uBAAuB,WAEnB,MAAM,iBACA,aAAa,cAChB,OAAO,YACT,yBAAyB,GAClC;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,gBAAgB,CACtB,UAAU,CAAC,aAAa,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CACnE,GAAG,IAAI,CAAC;KACV;EA2CF"}
+{"version":3,"file":"createProcessorQuery.d.ts","sourceRoot":"","sources":["../../../../src/relational/utils/createProcessorQuery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAClE,OAAO,KAAK,EACV,uBAAuB,EACvB,yBAAyB,EAC1B,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EACV,6BAA6B,EAC7B,gCAAgC,EACjC,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAiB5C,wBAAgB,oBAAoB,CAAC,OAAO,EAC1C,cAAc,EAAE,gCAAgC,CAAC,OAAO,CAAC;KAIvD,aAAa,SAAS,CACpB,EAAE,EAAE,6BAA6B,CAAC,OAAO,CAAC,KACvC,uBAAuB,WAEnB,MAAM,iBACA,aAAa,GAC3B;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,gBAAgB,CACtB,UAAU,CAAC,aAAa,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CACnE,GAAG,IAAI,CAAC;KACV;KAIC,OAAO,EACP,aAAa,SAAS,CACpB,EAAE,EAAE,6BAA6B,CAAC,OAAO,CAAC,EAC1C,UAAU,EAAE,OAAO,KAChB,uBAAuB,WAEnB,MAAM,iBACA,aAAa,cAChB,OAAO,YACT,yBAAyB,GAClC;QACD,SAAS,EAAE,OAAO,CAAC;QACnB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;QACpB,MAAM,EAAE,gBAAgB,CACtB,UAAU,CAAC,aAAa,CAAC,SAAS,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,CACnE,GAAG,IAAI,CAAC;KACV;EA2CF"}

package/dist/src/remote-controller/action-tracker.d.ts

@@ -0,0 +1,20 @@
+import type { Action } from "document-model";
+import type { TrackedAction } from "./types.js";
+/**
+ * Tracks pending actions with their operation context (prevOpHash, prevOpIndex).
+ * Actions are accumulated until flushed (on push).
+ */
+export declare class ActionTracker {
+    private pending;
+    /** Track a new action with its operation context. */
+    track(action: Action, prevOpHash: string, prevOpIndex: number): void;
+    /** Flush all pending actions and return them. Clears the internal queue. */
+    flush(): TrackedAction[];
+    /** Number of pending actions. */
+    get count(): number;
+    /** Prepend previously flushed actions back to the queue (for retry on failure). */
+    restore(actions: TrackedAction[]): void;
+    /** Clear all pending actions without returning them. */
+    clear(): void;
+}
+//# sourceMappingURL=action-tracker.d.ts.map

package/dist/src/remote-controller/action-tracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-tracker.d.ts","sourceRoot":"","sources":["../../../src/remote-controller/action-tracker.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAEhD;;;GAGG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAuB;IAEtC,qDAAqD;IACrD,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,IAAI;IAIpE,4EAA4E;IAC5E,KAAK,IAAI,aAAa,EAAE;IAMxB,iCAAiC;IACjC,IAAI,KAAK,IAAI,MAAM,CAElB;IAED,mFAAmF;IACnF,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE,GAAG,IAAI;IAIvC,wDAAwD;IACxD,KAAK,IAAI,IAAI;CAGd"}

package/dist/src/remote-controller/index.d.ts

@@ -0,0 +1,7 @@
+export { ActionTracker } from "./action-tracker.js";
+export { RemoteClient } from "./remote-client.js";
+export { RemoteDocumentController, type RemoteDocumentControllerWith, } from "./remote-controller.js";
+export { PropagationMode } from "./types.js";
+export type { ConflictInfo, ConflictStrategy, RemoteDocumentChangeEvent as DocumentChangeEvent, DocumentChangeListener, GetDocumentResult, GetDocumentWithOperationsResult, GetOperationsResult, IRemoteClient, IRemoteController, MergeHandler, PushResult, ReactorGraphQLClient, RemoteControllerOptions, RemoteDocumentData, RemoteOperation, RemoteOperationResultPage, SyncStatus, TrackedAction, } from "./types.js";
+export { ConflictError, convertRemoteOperations } from "./utils.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/remote-controller/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/remote-controller/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EACL,wBAAwB,EACxB,KAAK,4BAA4B,GAClC,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,YAAY,EACV,YAAY,EACZ,gBAAgB,EAChB,yBAAyB,IAAI,mBAAmB,EAChD,sBAAsB,EACtB,iBAAiB,EACjB,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,EACb,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,oBAAoB,EACpB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,yBAAyB,EACzB,UAAU,EACV,aAAa,GACd,MAAM,YAAY,CAAC;AACpB,OAAO,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC"}

package/dist/src/remote-controller/remote-client.d.ts

@@ -0,0 +1,30 @@
+import type { GetDocumentResult, GetDocumentWithOperationsResult, GetOperationsResult, IRemoteClient, PropagationMode, ReactorGraphQLClient, RemoteDocumentData } from "./types.js";
+export declare class RemoteClient implements IRemoteClient {
+    private readonly client;
+    private readonly pageSize;
+    constructor(client: ReactorGraphQLClient, pageSize?: number);
+    /** Fetch a document by identifier. Returns null if not found. */
+    getDocument(identifier: string, branch?: string): Promise<GetDocumentResult | null>;
+    /**
+     * Fetch a document and its first page of operations in a single query.
+     * Returns null if the document is not found.
+     */
+    getDocumentWithOperations(identifier: string, branch?: string, operationsCursor?: string): Promise<GetDocumentWithOperationsResult | null>;
+    /**
+     * Fetch all operations for a document, paginating through all pages.
+     * Returns operations grouped by scope and the final cursor for incremental fetches.
+     *
+     * @param startCursor - If provided, resume fetching from this cursor position
+     *   (for incremental pulls after the initial fetch).
+     */
+    getAllOperations(documentId: string, branch?: string, sinceRevision?: number, scopes?: string[], startCursor?: string): Promise<GetOperationsResult>;
+    /** Push actions to an existing document via MutateDocument. */
+    pushActions(documentIdentifier: string, actions: ReadonlyArray<NonNullable<unknown>>, branch?: string): Promise<RemoteDocumentData>;
+    /** Create a new document on the remote. */
+    createDocument(document: NonNullable<unknown>, parentIdentifier?: string): Promise<RemoteDocumentData>;
+    /** Create an empty document of a given type on the remote. */
+    createEmptyDocument(documentType: string, parentIdentifier?: string): Promise<RemoteDocumentData>;
+    /** Delete a document on the remote. Returns true if successful. */
+    deleteDocument(identifier: string, propagate?: PropagationMode): Promise<boolean>;
+}
+//# sourceMappingURL=remote-client.d.ts.map

package/dist/src/remote-controller/remote-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-client.d.ts","sourceRoot":"","sources":["../../../src/remote-controller/remote-client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,iBAAiB,EACjB,+BAA+B,EAC/B,mBAAmB,EACnB,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,kBAAkB,EAEnB,MAAM,YAAY,CAAC;AAOpB,qBAAa,YAAa,YAAW,aAAa;IAI9C,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;gBAGf,MAAM,EAAE,oBAAoB,EAC7C,QAAQ,CAAC,EAAE,MAAM;IAKnB,iEAAiE;IAC3D,WAAW,CACf,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC;IAQpC;;;OAGG;IACG,yBAAyB,CAC7B,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,+BAA+B,GAAG,IAAI,CAAC;IAkClD;;;;;;OAMG;IACG,gBAAgB,CACpB,UAAU,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,MAAM,EACtB,MAAM,CAAC,EAAE,MAAM,EAAE,EACjB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,mBAAmB,CAAC;IAoC/B,+DAA+D;IACzD,WAAW,CACf,kBAAkB,EAAE,MAAM,EAC1B,OAAO,EAAE,aAAa,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,EAC5C,MAAM,CAAC,EAAE,MAAM,GACd,OAAO,CAAC,kBAAkB,CAAC;IAS9B,2CAA2C;IACrC,cAAc,CAClB,QAAQ,EAAE,WAAW,CAAC,OAAO,CAAC,EAC9B,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAQ9B,8DAA8D;IACxD,mBAAmB,CACvB,YAAY,EAAE,MAAM,EACpB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,kBAAkB,CAAC;IAQ9B,mEAAmE;IAC7D,cAAc,CAClB,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,eAAe,GAC1B,OAAO,CAAC,OAAO,CAAC;CAOpB"}

package/dist/src/remote-controller/remote-controller.d.ts

@@ -0,0 +1,108 @@
+import type { DocumentOperations, PHDocument, PHDocumentController, PHDocumentHeader } from "document-model";
+import type { DocumentChangeListener, IRemoteController, PropagationMode, PushResult, RemoteControllerOptions, RemoteDocumentData, SyncStatus } from "./types.js";
+/** Extract TState from a PHDocumentController subclass. */
+type InferState<C> = C extends PHDocumentController<infer S> ? S : never;
+/**
+ * Extract action methods from a controller type.
+ * These are the dynamically-added methods (not on the base PHDocumentController prototype).
+ */
+type ActionMethodsOf<C, TRemote> = {
+    [K in Exclude<keyof C, keyof PHDocumentController<any>>]: C[K] extends (input: infer I) => unknown ? (input: I) => TRemote & ActionMethodsOf<C, TRemote> : C[K];
+};
+/** The full return type: RemoteDocumentController + action methods. */
+export type RemoteDocumentControllerWith<C extends PHDocumentController<any>> = RemoteDocumentController<C> & ActionMethodsOf<C, RemoteDocumentController<C>>;
+/**
+ * A controller that wraps a PHDocumentController with remote push/pull capabilities.
+ * Composes a local controller and adds GraphQL-based sync with a reactor server.
+ */
+export declare class RemoteDocumentController<TController extends PHDocumentController<any>> implements IRemoteController<InferState<TController>> {
+    private inner;
+    private readonly remoteClient;
+    private readonly tracker;
+    private readonly options;
+    private documentId;
+    private remoteRevision;
+    private lastCursor;
+    private pushScheduled;
+    private pushQueue;
+    private listeners;
+    private constructor();
+    get header(): PHDocumentHeader;
+    get state(): InferState<TController>;
+    get operations(): DocumentOperations;
+    get document(): PHDocument<InferState<TController>>;
+    get status(): SyncStatus;
+    /** Register a listener for document changes. Returns an unsubscribe function. */
+    onChange(listener: DocumentChangeListener): () => void;
+    private notifyListeners;
+    /** Push all pending actions to remote, then pull latest state. */
+    push(): Promise<PushResult>;
+    /** Delete the document on the remote. */
+    delete(propagate?: PropagationMode): Promise<boolean>;
+    /** Pull latest state from remote, replacing local document. Returns the remote document data. */
+    pull(): Promise<RemoteDocumentData>;
+    /**
+     * Pull an existing document from remote and create a controller for it.
+     */
+    static pull<C extends PHDocumentController<any>>(ControllerClass: new (doc?: PHDocument<any>) => C, options: RemoteControllerOptions): Promise<RemoteDocumentControllerWith<C>>;
+    /**
+     * Wrap an existing controller instance with remote capabilities.
+     * Pending local actions on the inner controller are NOT tracked
+     * (only new actions through the remote controller are tracked).
+     */
+    static from<C extends PHDocumentController<any>>(controller: C, options: RemoteControllerOptions): RemoteDocumentControllerWith<C>;
+    /** Create the document on the remote if it doesn't exist yet. */
+    private ensureRemoteDocument;
+    /** Set up interceptors for all action methods on the inner controller. */
+    private setupActionInterceptors;
+    /**
+     * Find the new operation added after applying an action,
+     * by comparing current operation counts against a previous snapshot.
+     */
+    private findNewOperation;
+    /**
+     * Get the last operation in a specific scope, optionally excluding
+     * a given operation (e.g. the one just added).
+     */
+    private getLastOperationInScope;
+    /**
+     * Detect and handle conflicts between local pending actions and remote state.
+     * Returns the (possibly rebased) tracked actions to push.
+     */
+    private handleConflicts;
+    /**
+     * Pull latest remote state and replay actions through interceptors.
+     * Returns newly tracked actions with correct prevOpHash values.
+     */
+    private pullAndReplay;
+    /** Prepare actions for push, optionally signing them. */
+    private prepareActionsForPush;
+    /** Sign an action using the configured signer, preserving existing signatures. */
+    private signAction;
+    /**
+     * Fetch document and operations in a single query, using the stored cursor
+     * for incremental fetches. If the first page has more results, continues
+     * paginating with follow-up queries. Falls back to a full fetch if the
+     * cursor is stale and produces a count mismatch.
+     */
+    private fetchDocumentAndOperations;
+    /**
+     * Full fetch fallback: fetches all operations from the beginning.
+     * Used when an incremental fetch produces a count mismatch.
+     */
+    private fullFetch;
+    /**
+     * Validate that the merged operations match the expected revision per scope.
+     * Each scope's operation count should equal its revision number.
+     */
+    private hasExpectedOperationCounts;
+    /**
+     * Merge existing local operations with newly fetched operations.
+     * Appends new operations to existing ones per scope.
+     */
+    private mergeOperations;
+    /** Schedule a push via microtask (for streaming mode coalescing). */
+    private schedulePush;
+}
+export {};
+//# sourceMappingURL=remote-controller.d.ts.map

package/dist/src/remote-controller/remote-controller.d.ts.map

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

package/dist/src/remote-controller/types.d.ts

@@ -0,0 +1,118 @@
+import type { Action, DocumentOperations, ISigner, PHBaseState, PHDocument, PHDocumentHeader } from "document-model";
+import type { GetDocumentOperationsQuery, PhDocumentFieldsFragment, PropagationMode, Sdk } from "../graphql/gen/schema.js";
+export { PropagationMode } from "../graphql/gen/schema.js";
+export type RemoteDocumentData = PhDocumentFieldsFragment;
+export type RemoteOperation = GetDocumentOperationsQuery["documentOperations"]["items"][number];
+export type RemoteOperationResultPage = GetDocumentOperationsQuery["documentOperations"];
+export type ReactorGraphQLClient = Pick<Sdk, "GetDocument" | "GetDocumentWithOperations" | "GetDocumentOperations" | "MutateDocument" | "CreateDocument" | "CreateEmptyDocument" | "DeleteDocument">;
+/**
+ * Options for creating a RemoteDocumentController.
+ */
+export type RemoteControllerOptions = {
+    client: ReactorGraphQLClient;
+    /** Remote document id. Omit for new documents. */
+    documentId?: string;
+    /** "batch" requires explicit push(), "streaming" auto-pushes after actions. Defaults to "batch" */
+    mode?: "batch" | "streaming";
+    /** Optional signer for action signing. */
+    signer?: ISigner;
+    /** Branch name, defaults to "main". */
+    branch?: string;
+    /** Parent document identifier for creating new documents. */
+    parentIdentifier?: string;
+    /** Conflict resolution strategy when remote has new operations. Default: no check (current behavior). */
+    onConflict?: ConflictStrategy;
+    /** Called when a streaming-mode push fails. If not provided, errors are silently swallowed. */
+    onPushError?: (error: unknown) => void;
+    /** Number of operations to fetch per page. Defaults to 100. */
+    operationsPageSize?: number;
+};
+/**
+ * Result of a push operation.
+ */
+export type PushResult = {
+    remoteDocument: RemoteDocumentData;
+    actionCount: number;
+    /** The actions that were sent to the server (after signing, if applicable). */
+    operations: ReadonlyArray<Action>;
+};
+/**
+ * Sync status of the controller.
+ */
+export type SyncStatus = {
+    pendingActionCount: number;
+    connected: boolean;
+    documentId: string;
+    remoteRevision: Record<string, number>;
+};
+/**
+ * A tracked action with operation context for signing.
+ */
+export type TrackedAction = {
+    action: Action;
+    prevOpHash: string;
+    prevOpIndex: number;
+};
+/** Information about a detected conflict. */
+export type ConflictInfo = {
+    /** Remote operations added since the last pull, grouped by scope. */
+    remoteOperations: Record<string, RemoteOperation[]>;
+    /** Local actions pending push. */
+    localActions: TrackedAction[];
+    /** Remote revision at last pull. */
+    knownRevision: Record<string, number>;
+    /** Current remote revision. */
+    currentRevision: Record<string, number>;
+};
+/** Custom merge handler receives conflict info and returns actions to push (or throws to abort). */
+export type MergeHandler = (conflict: ConflictInfo) => Action[] | Promise<Action[]>;
+/** Conflict resolution strategy. */
+export type ConflictStrategy = "reject" | "rebase" | MergeHandler;
+/** Event emitted when the document changes. */
+export type RemoteDocumentChangeEvent = {
+    source: "action" | "pull";
+    document: PHDocument<PHBaseState>;
+};
+/** Listener for document change events. */
+export type DocumentChangeListener = (event: RemoteDocumentChangeEvent) => void;
+/** Result of fetching operations, including the cursor for incremental fetches. */
+export type GetOperationsResult = {
+    operationsByScope: Record<string, RemoteOperation[]>;
+    /** Opaque cursor for resuming pagination. Undefined if there were no results. */
+    cursor: string | undefined;
+};
+/** Result of fetching a document together with its first page of operations. */
+export type GetDocumentWithOperationsResult = {
+    document: RemoteDocumentData;
+    childIds: ReadonlyArray<string>;
+    /** First page of operations (may need further pagination if hasNextPage is true). */
+    operations: GetOperationsResult;
+    /** True if there are more pages of operations to fetch. */
+    hasMoreOperations: boolean;
+};
+export interface IRemoteClient {
+    getDocument(identifier: string, branch?: string): Promise<GetDocumentResult | null>;
+    /** Fetch document metadata and the first page of operations in a single query. */
+    getDocumentWithOperations(identifier: string, branch?: string, operationsCursor?: string): Promise<GetDocumentWithOperationsResult | null>;
+    getAllOperations(documentId: string, branch?: string, sinceRevision?: number, scopes?: string[], cursor?: string): Promise<GetOperationsResult>;
+    pushActions(documentIdentifier: string, actions: ReadonlyArray<NonNullable<unknown>>, branch?: string): Promise<RemoteDocumentData>;
+    createDocument(document: NonNullable<unknown>, parentIdentifier?: string): Promise<RemoteDocumentData>;
+    createEmptyDocument(documentType: string, parentIdentifier?: string): Promise<RemoteDocumentData>;
+    deleteDocument(identifier: string, propagate?: PropagationMode): Promise<boolean>;
+}
+export type GetDocumentResult = {
+    document: RemoteDocumentData;
+    childIds: ReadonlyArray<string>;
+};
+export interface IRemoteController<TState extends PHBaseState = PHBaseState> {
+    readonly header: PHDocumentHeader;
+    readonly state: TState;
+    readonly operations: DocumentOperations;
+    readonly document: PHDocument<TState>;
+    readonly status: SyncStatus;
+    onChange(listener: DocumentChangeListener): () => void;
+    push(): Promise<PushResult>;
+    pull(): Promise<RemoteDocumentData>;
+    delete(propagate?: PropagationMode): Promise<boolean>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/remote-controller/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/remote-controller/types.ts"],"names":[],"mappings":"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"}

package/dist/src/remote-controller/utils.d.ts

@@ -0,0 +1,28 @@
+import type { DocumentOperations, Operation, PHBaseState, PHDocument } from "document-model";
+import type { ConflictInfo, RemoteDocumentData, RemoteOperation } from "./types.js";
+/** Convert SCREAMING_SNAKE_CASE to camelCase (e.g. "SET_MODEL_NAME" → "setModelName"). */
+export declare function screamingSnakeToCamel(s: string): string;
+/** Error thrown when a push conflict is detected with the "reject" strategy. */
+export declare class ConflictError extends Error {
+    readonly conflict: ConflictInfo;
+    constructor(conflict: ConflictInfo);
+}
+/** Convert a remote operation to the local Operation type. */
+export declare function remoteOperationToLocal(remote: RemoteOperation): Operation;
+/**
+ * Deserialize a signature string back to a 5-element tuple.
+ * The server serializes tuples via `tuple.join(", ")`.
+ */
+export declare function deserializeSignature(s: string): [string, string, string, string, string];
+/** Convert remote operations to local DocumentOperations format. */
+export declare function convertRemoteOperations(operationsByScope: Record<string, RemoteOperation[]>): DocumentOperations;
+/** Reconstruct a PHDocument from remote document data and operations. */
+export declare function buildPulledDocument(remoteDoc: RemoteDocumentData, operations: DocumentOperations, initialDoc: PHDocument<PHBaseState>, branch: string): PHDocument<PHBaseState>;
+/** Extract revision map from a remote document's revisionsList. */
+export declare function extractRevisionMap(revisionsList: RemoteDocumentData["revisionsList"]): Record<string, number>;
+/**
+ * Check if any scope in currentRevision is ahead of knownRevision.
+ * When `scopes` is provided, only those scopes are checked.
+ */
+export declare function hasRevisionConflict(currentRevision: Record<string, number>, knownRevision: Record<string, number>, scopes?: ReadonlySet<string>): boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/src/remote-controller/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/remote-controller/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,SAAS,EACT,WAAW,EACX,UAAU,EACX,MAAM,gBAAgB,CAAC;AACxB,OAAO,KAAK,EACV,YAAY,EACZ,kBAAkB,EAClB,eAAe,EAChB,MAAM,YAAY,CAAC;AAEpB,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAIvD;AAED,gFAAgF;AAChF,qBAAa,aAAc,SAAQ,KAAK;aACV,QAAQ,EAAE,YAAY;gBAAtB,QAAQ,EAAE,YAAY;CAInD;AAED,8DAA8D;AAC9D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,eAAe,GAAG,SAAS,CAyCzE;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,CAAC,EAAE,MAAM,GACR,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAS1C;AAED,oEAAoE;AACpE,wBAAgB,uBAAuB,CACrC,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,EAAE,CAAC,GACnD,kBAAkB,CAMpB;AAED,yEAAyE;AACzE,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,kBAAkB,EAC7B,UAAU,EAAE,kBAAkB,EAC9B,UAAU,EAAE,UAAU,CAAC,WAAW,CAAC,EACnC,MAAM,EAAE,MAAM,GACb,UAAU,CAAC,WAAW,CAAC,CA0BzB;AAED,mEAAmE;AACnE,wBAAgB,kBAAkB,CAChC,aAAa,EAAE,kBAAkB,CAAC,eAAe,CAAC,GACjD,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAExB;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,eAAe,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACvC,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EACrC,MAAM,CAAC,EAAE,WAAW,CAAC,MAAM,CAAC,GAC3B,OAAO,CAQT"}