@indigoai-us/hq-cloud 6.15.6 → 6.15.7

package/dist/sync/state-store.d.ts

@@ -11,6 +11,37 @@ export interface StateStoreOptions<T> {
     reduce: (state: T, record: StateStoreRecord) => T;
     /** Compact after this many WAL records. Defaults to 256. */
     maxRecordsBeforeCompaction?: number;
+    /** Compact once the current WAL reaches this many bytes. Defaults to 16 MiB. */
+    maxWalBytesBeforeCompaction?: number;
+}
+export interface StateStoreRecoveryStats {
+    /** Bytes in the selected generation's WAL, including its header. */
+    walBytes: number;
+    /** Largest single snapshot payload or WAL frame buffered during recovery. */
+    maxReadBytes: number;
+}
+export interface StateStoreRepairResult {
+    recoveredGeneration: number;
+    recoveredWalBytes: number;
+    firstCompactGeneration: number;
+    currentGeneration: number;
+}
+export interface StateStoreRecoveryProgress {
+    /** Bytes consumed from the snapshot plus WAL selected for recovery. */
+    bytesRead: number;
+    /** Total bytes in that snapshot/WAL generation. */
+    totalBytes: number;
+}
+export type StateStoreMaintenanceResult = {
+    status: "missing" | "not-needed";
+} | ({
+    status: "repaired";
+} & StateStoreRepairResult);
+export interface StateStoreMaintenanceOptions {
+    /** Rewrite even when the generation is already under its byte budget. */
+    force?: boolean;
+    /** Synchronous recovery progress, suitable for a process heartbeat. */
+    onProgress?: (event: StateStoreRecoveryProgress) => void;
 }
 export declare class StateStoreCorruptionError extends Error {
     constructor(message: string, options?: ErrorOptions);
@@ -25,16 +56,37 @@ export declare class StateStore<T> {
     private state;
     private lastRecordSequence;
     private recordCount;
+    private walBytes;
+    private maxRecoveryReadBytes;
     private constructor();
     static exists(rootDir: string, scopeId: string): boolean;
     static open<T>(options: StateStoreOptions<T>): StateStore<T>;
+    /**
+     * Repair an over-budget generation without opening it once and refreshing it
+     * a second time. The entire recovery and two-copy publication happens under
+     * the scope lock, so an appender cannot race the migration.
+     */
+    static repairIfNeeded<T>(options: StateStoreOptions<T>, maintenance?: StateStoreMaintenanceOptions): StateStoreMaintenanceResult;
     getState(): T;
     getGeneration(): number;
     getLastRecordSequence(): number;
+    getRecoveryStats(): StateStoreRecoveryStats;
     append(type: number, payload: unknown, flags?: number): StateStoreRecord;
+    /**
+     * Atomically replace the current state with a compact snapshot generation.
+     *
+     * This is the rollback-compatible write path for domains whose previous
+     * reducer cannot understand a new WAL record type. If the recovered
+     * generation contains records, publish two compact copies so every retained
+     * WAL is header-only before pruning it. Later replacements need one new copy
+     * and retain the prior compact copy.
+     */
+    replaceState(nextState: T): void;
     /** Create G+1 without ever merging two generations during recovery. */
     compact(): void;
     private refreshFromDisk;
     private compactUnlocked;
+    private compactGeneration;
+    private installGeneration;
 }
 //# sourceMappingURL=state-store.d.ts.map

package/dist/sync/state-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/sync/state-store.ts"],"names":[],"mappings":"AAsBA,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,CAAC,CAAC;CACZ;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,CAAC,CAAC;IAChB,MAAM,EAAE,CAAC,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,gBAAgB,KAAK,CAAC,CAAC;IAClD,4DAA4D;IAC5D,0BAA0B,CAAC,EAAE,MAAM,CAAC;CACrC;AAcD,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY;CAIpD;AASD,+DAA+D;AAC/D,qBAAa,UAAU,CAAC,CAAC;IAUrB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAT1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;IAC7B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,KAAK,CAAI;IACjB,OAAO,CAAC,kBAAkB,CAAS;IACnC,OAAO,CAAC,WAAW,CAAS;IAE5B,OAAO;IAcP,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO;IAUxD,MAAM,CAAC,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,CAAC,CAAC,CAAC,GAAG,UAAU,CAAC,CAAC,CAAC;IA6B5D,QAAQ,IAAI,CAAC;IAIb,aAAa,IAAI,MAAM;IAIvB,qBAAqB,IAAI,MAAM;IAI/B,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,KAAK,SAAI,GAAG,gBAAgB;IAyBnE,uEAAuE;IACvE,OAAO,IAAI,IAAI;IAOf,OAAO,CAAC,eAAe;IAYvB,OAAO,CAAC,eAAe;CAaxB"}
+{"version":3,"file":"state-store.d.ts","sourceRoot":"","sources":["../../src/sync/state-store.ts"],"names":[],"mappings":"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"}