@powerhousedao/reactor-api 6.2.3-dev.44 → 6.2.3-dev.45

package/dist/src/pglite/pglite-node.d.mts

@@ -0,0 +1,130 @@
+import { ILogger } from "document-model";
+import nodeFs from "node:fs";
+import { PGlite } from "@electric-sql/pglite";
+import { NodeFS } from "@electric-sql/pglite/nodefs";
+//#region src/pglite/maintenance.d.ts
+export declare const DEFAULT_MAINTENANCE_INTERVAL_MS: number;
+export declare const DEFAULT_VACUUM_FULL_ABOVE_BYTES: number;
+type MaintenanceOutcome = "vacuum" | "vacuum-full" | "idle" | "not-ready" | "in-transaction" | "failed";
+interface MaintenanceLogger {
+  warn(message: string): void;
+}
+interface MaintenanceOptions {
+  /** VACUUM + CHECKPOINT cadence; PGlite has no autovacuum. Default 5 min; 0 disables. */
+  intervalMs?: number;
+  /** First pass runs VACUUM FULL when `base/` exceeds this at open. Default 256 MB; 0 disables. */
+  vacuumFullAboveBytes?: number;
+  logger?: MaintenanceLogger;
+}
+export declare class PgliteMaintenance {
+  private readonly intervalMs;
+  private readonly vacuumFullAboveBytes;
+  private readonly logger?;
+  private pg?;
+  private label;
+  private closing;
+  private syncsSinceMaintenance;
+  private vacuumFullPending;
+  private timer?;
+  private inFlight?;
+  constructor(options?: MaintenanceOptions);
+  get scheduled(): boolean;
+  get running(): boolean;
+  start(pg: PGlite, label: string, baseBytes: number): void;
+  noteSync(): void;
+  stop(): Promise<void>;
+  run(): Promise<MaintenanceOutcome>;
+  private schedule;
+  private cancel;
+}
+//#endregion
+//#region src/pglite/durable-node-fs.d.ts
+type NodeFsClass = typeof NodeFS;
+interface DurableNodeFsOptions {
+  /** Default true; `PH_PGLITE_FSYNC=0` turns it off (power-loss durability off). */
+  fsync?: boolean;
+  /** Default 5 min; 0 disables. */
+  maintenanceIntervalMs?: number;
+  /** `base/` size at open; default 256 MB; 0 disables. */
+  vacuumFullAboveBytes?: number;
+  logger?: {
+    warn(message: string): void;
+  };
+  /** Emscripten abort (a Postgres PANIC, e.g. ENOSPC on WAL). */
+  onAbort?: (what: unknown) => void;
+  hostFs?: Pick<typeof nodeFs, "fsyncSync" | "fdatasyncSync">;
+}
+type DurableNodeFs = InstanceType<NodeFsClass> & {
+  readonly maintenance: PgliteMaintenance;
+};
+export declare function resolvePgliteFsync(env: Record<string, string | undefined>): boolean;
+/** Built over the passed-in class so PG16 dirs on `pglite-legacy-02` get the same behaviour. */
+export declare function createDurableNodeFs(Base: NodeFsClass, dataDir: string, options?: DurableNodeFsOptions): DurableNodeFs;
+//#endregion
+//#region src/pglite/sync-tree.d.ts
+interface SyncTreeHostFs {
+  fsyncSync(fd: number): void;
+}
+interface SyncTreeResult {
+  files: number;
+  dirs: number;
+}
+/** One pass over a finished tree; interleaving fsync with writes costs seconds. */
+export declare function syncTree(root: string, hostFs?: SyncTreeHostFs): SyncTreeResult;
+/** fsyncs a directory's entries; false where the platform refuses (Windows). */
+export declare function syncDirectory(dir: string, hostFs?: SyncTreeHostFs): boolean;
+//#endregion
+//#region src/pglite/snapshot-reader.d.ts
+export declare const SNAPSHOT_FILE_NAME = "snapshot.bin";
+interface ExtractSnapshotOptions {
+  chunkSize?: number;
+  /** Default true: one fsync pass over the tree after the last write. */
+  sync?: boolean;
+  hostFs?: SyncTreeHostFs;
+}
+interface ExtractedSnapshot {
+  pgVersionMajor: number;
+  /** `global/pg_control` bytes; absent only in synthetic trees. */
+  pgControl?: Buffer;
+  /** Entries written to disk; skipped entries are not counted. */
+  entries: number;
+  /** Size of the snapshot file. */
+  bytes: number;
+}
+/** Unpacks a snapshot into the existing `outDir`. */
+export declare function extractSnapshot(snapshotPath: string, outDir: string, options?: ExtractSnapshotOptions): Promise<ExtractedSnapshot>;
+//#endregion
+//#region src/pglite/convert-snapshot-dir.d.ts
+interface VerifyHandle {
+  query<T>(sql: string): Promise<{
+    rows: T[];
+  }>;
+  close(): Promise<void>;
+}
+type ConversionStep = "extract" | "verify" | "renameOld" | "renameNew" | "removeOld";
+interface ConversionDeps {
+  /** Opens `dataDir` with the stock NodeFS of the PGlite module for `major`. */
+  openForVerify: (major: number, dataDir: string) => Promise<VerifyHandle>;
+  logger: ILogger;
+  /** Test hook: throw after a named step to simulate a crash there. */
+  afterStep?: (step: ConversionStep) => void | Promise<void>;
+  hostFs?: SyncTreeHostFs;
+}
+/** Settles the debris of an interrupted conversion; runs before it at boot. */
+export declare function recoverConversion(dir: string, deps: ConversionDeps): Promise<void>;
+/** Extracts into `.converting`, verifies by opening it, swaps through `.old`. */
+export declare function convertSnapshotDir(dir: string, deps: ConversionDeps): Promise<"converted" | "none">;
+//#endregion
+//#region src/pglite/preflight.d.ts
+/** PG major of the pinned @electric-sql/pglite; it exports none, so the test checks initdb. */
+export declare const CURRENT_PGLITE_MAJOR = 17;
+/** `openForVerify` over the loaded PGlite module only. */
+export declare function openCurrentPgliteForVerify(major: number, dataDir: string): Promise<VerifyHandle>;
+/** Converts a snapshot store and clears the files a previous run leaves behind. */
+export declare function preparePgliteDataDir(dir: string, deps: ConversionDeps): Promise<void>;
+/** PGlite leaves `postmaster.pid` after every close and `pg_wal/xlogtemp.*` after some. */
+export declare function removeStalePgliteFiles(dir: string, logger: Pick<ILogger, "debug">): Promise<void>;
+//#endregion
+export type { ConversionDeps, ConversionStep, DurableNodeFs, DurableNodeFsOptions, ExtractSnapshotOptions, ExtractedSnapshot, MaintenanceLogger, MaintenanceOptions, MaintenanceOutcome, NodeFsClass, SyncTreeHostFs, SyncTreeResult, VerifyHandle };
+export {};
+//# sourceMappingURL=pglite-node.d.mts.map

package/dist/src/pglite/pglite-node.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pglite-node.d.mts","names":[],"sources":["../../../src/pglite/maintenance.ts","../../../src/pglite/durable-node-fs.ts","../../../src/pglite/sync-tree.ts","../../../src/pglite/snapshot-reader.ts","../../../src/pglite/convert-snapshot-dir.ts","../../../src/pglite/preflight.ts"],"mappings":";;;;;qBAIa;qBACA;KAGD;UAQK;EACf,KAAK;;UAGU;;EAEf;;EAEA;EACA,SAAS;;qBAGE;mBACM;mBACA;mBACA;UAET;UACA;UACA;UACA;UACA;UACA;UACA;EAER,YAAY,UAAS;MAYjB;MAIA;EAIJ,MAAM,IAAI,QAAQ,eAAe;EAQjC;EAIM,QAAQ;EAMR,OAAO,QAAQ;UA+Cb;UAoBA;;;;KC1IE,qBAAqB;UAKhB;;EAEf;;EAEA;;EAEA;EACA;IAAW,KAAK;;;EAEhB,WAAW;EACX,SAAS,YAAY;;KAGX,gBAAgB,aAAa;WAC9B,aAAa;;wBAGR,mBACd,KAAK;;wBAmES,oBACd,MAAM,aACN,iBACA,UAAS,uBACR;;;UCnGc;EACf,UAAU;;UAGK;EACf;EACA;;;wBAIc,SACd,cACA,SAAQ,iBACP;;wBA+Ba,cACd,aACA,SAAQ;;;qBC3CG;UASI;EACf;;EAEA;EACA,SAAS;;UAGM;EACf;;EAEA,YAAY;;EAEZ;;EAEA;;;wBAIoB,gBACpB,sBACA,gBACA,UAAS,yBACR,QAAQ;;;UC/BM;EACf,MAAM,GAAG,cAAc;IAAU,MAAM;;EACvC,SAAS;;KAGC;UAOK;;EAEf,gBAAgB,eAAe,oBAAoB,QAAQ;EAC3D,QAAQ;;EAER,aAAa,MAAM,0BAA0B;EAC7C,SAAS;;;wBA6BW,kBACpB,aACA,MAAM,iBACL;;wBA6CmB,mBACpB,aACA,MAAM,iBACL;;;;qBC3FU;;wBAGS,2BACpB,eACA,kBACC,QAAQ;;wBAYW,qBACpB,aACA,MAAM,iBACL;;wBAOmB,uBACpB,aACA,QAAQ,KAAK,oBACZ"}

package/dist/src/pglite/pglite-node.mjs

@@ -0,0 +1,4 @@
+import { a as convertSnapshotDir, c as extractSnapshot, d as syncDirectory, f as syncTree, h as PgliteMaintenance, i as removeStalePgliteFiles, l as createDurableNodeFs, m as DEFAULT_VACUUM_FULL_ABOVE_BYTES, n as openCurrentPgliteForVerify, o as recoverConversion, p as DEFAULT_MAINTENANCE_INTERVAL_MS, r as preparePgliteDataDir, s as SNAPSHOT_FILE_NAME, t as CURRENT_PGLITE_MAJOR, u as resolvePgliteFsync } from "../../pglite-node-Ow9i5Rb4.mjs";
+export { CURRENT_PGLITE_MAJOR, DEFAULT_MAINTENANCE_INTERVAL_MS, DEFAULT_VACUUM_FULL_ABOVE_BYTES, PgliteMaintenance, SNAPSHOT_FILE_NAME, convertSnapshotDir, createDurableNodeFs, extractSnapshot, openCurrentPgliteForVerify, preparePgliteDataDir, recoverConversion, removeStalePgliteFiles, resolvePgliteFsync, syncDirectory, syncTree };
+!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="6dd4c09b-2fd7-5402-83f6-a92c933064b1")}catch(e){}}();
+//# debugId=6dd4c09b-2fd7-5402-83f6-a92c933064b1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@powerhousedao/reactor-api",
-  "version": "6.2.3-dev.44",
+  "version": "6.2.3-dev.45",
   "description": "GraphQL API layer for the Powerhouse reactor — auto-generated subgraphs per document model plus the core reactor subgraph for drive and document management.",
   "type": "module",
   "repository": {
@@ -24,6 +24,11 @@
       "types": "./dist/https-hooks.d.mts",
       "import": "./dist/src/packages/https-hooks.mjs"
     },
+    "./pglite-node": {
+      "source": "./src/pglite/pglite-node.ts",
+      "types": "./dist/src/pglite/pglite-node.d.mts",
+      "import": "./dist/src/pglite/pglite-node.mjs"
+    },
     "./test": {
       "import": "./test/index.ts"
     }
@@ -59,24 +64,23 @@
     "@graphql-tools/schema": "10.0.31",
     "@graphql-tools/utils": "11.0.0",
     "@originjs/vite-plugin-commonjs": "^1.0.3",
-    "@powerhousedao/analytics-engine-core": "6.2.3-dev.44",
-    "@powerhousedao/analytics-engine-graphql": "6.2.3-dev.44",
-    "@powerhousedao/analytics-engine-pg": "6.2.3-dev.44",
-    "@powerhousedao/config": "6.2.3-dev.44",
+    "@powerhousedao/analytics-engine-core": "6.2.3-dev.45",
+    "@powerhousedao/analytics-engine-graphql": "6.2.3-dev.45",
+    "@powerhousedao/analytics-engine-pg": "6.2.3-dev.45",
+    "@powerhousedao/config": "6.2.3-dev.45",
     "@powerhousedao/document-engineering": "1.40.5",
-    "@powerhousedao/pglite-fs": "6.2.3-dev.44",
-    "@powerhousedao/reactor": "6.2.3-dev.44",
-    "@powerhousedao/reactor-attachments": "6.2.3-dev.44",
-    "@powerhousedao/reactor-drive": "6.2.3-dev.44",
-    "@powerhousedao/reactor-group": "6.2.3-dev.44",
-    "@powerhousedao/reactor-mcp": "6.2.3-dev.44",
-    "@powerhousedao/shared": "6.2.3-dev.44",
-    "@renown/sdk": "6.2.3-dev.44",
+    "@powerhousedao/reactor": "6.2.3-dev.45",
+    "@powerhousedao/reactor-attachments": "6.2.3-dev.45",
+    "@powerhousedao/reactor-drive": "6.2.3-dev.45",
+    "@powerhousedao/reactor-group": "6.2.3-dev.45",
+    "@powerhousedao/reactor-mcp": "6.2.3-dev.45",
+    "@powerhousedao/shared": "6.2.3-dev.45",
+    "@renown/sdk": "6.2.3-dev.45",
     "body-parser": "^1.20.3",
     "change-case": "5.4.4",
     "cors": "^2.8.5",
     "devcert": "^1.2.2",
-    "document-model": "6.2.3-dev.44",
+    "document-model": "6.2.3-dev.45",
     "dotenv": "^16.4.5",
     "es-module-lexer": "^2.0.0",
     "express": "^4.22.1",