@powerhousedao/reactor-api 6.2.3-dev.7 → 6.2.3-dev.71

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (60) hide show
  1. package/README.md +7 -2
  2. package/dist/{adapter-gateway-apollo-CxJNBVyD.mjs → adapter-gateway-apollo-D-EdZ4e-.mjs} +23 -23
  3. package/dist/adapter-gateway-apollo-D-EdZ4e-.mjs.map +1 -0
  4. package/dist/{adapter-gateway-mercurius-CZVy88Za.mjs → adapter-gateway-mercurius-CdxLge5p.mjs} +4 -12
  5. package/dist/adapter-gateway-mercurius-CdxLge5p.mjs.map +1 -0
  6. package/dist/{adapter-http-express-B39rPhqH.mjs → adapter-http-express-P0t-mdMV.mjs} +10 -10
  7. package/dist/adapter-http-express-P0t-mdMV.mjs.map +1 -0
  8. package/dist/{adapter-http-fastify-BwXO6rqE.mjs → adapter-http-fastify-D0OP5q9K.mjs} +13 -12
  9. package/dist/adapter-http-fastify-D0OP5q9K.mjs.map +1 -0
  10. package/dist/base-document-models-uUQKgXcf.mjs +1415 -0
  11. package/dist/base-document-models-uUQKgXcf.mjs.map +1 -0
  12. package/dist/create-schema-BUk-IQCT.d.mts +144 -0
  13. package/dist/create-schema-BUk-IQCT.d.mts.map +1 -0
  14. package/dist/index.d.mts +2029 -739
  15. package/dist/index.d.mts.map +1 -1
  16. package/dist/index.mjs +4558 -1715
  17. package/dist/index.mjs.map +1 -1
  18. package/dist/package-subgraph-check-CsTPajAN.mjs +137 -0
  19. package/dist/package-subgraph-check-CsTPajAN.mjs.map +1 -0
  20. package/dist/pglite-node-C-UQXrjU.mjs +576 -0
  21. package/dist/pglite-node-C-UQXrjU.mjs.map +1 -0
  22. package/dist/rolldown-runtime-8H4AJuhK.mjs +16 -0
  23. package/dist/run-node-handler-CQjyjOuN.mjs +52 -0
  24. package/dist/run-node-handler-CQjyjOuN.mjs.map +1 -0
  25. package/dist/src/graphql/subgraph-types.d.mts +43 -0
  26. package/dist/src/graphql/subgraph-types.d.mts.map +1 -0
  27. package/dist/src/graphql/subgraph-types.mjs +14 -0
  28. package/dist/src/graphql/subgraph-types.mjs.map +1 -0
  29. package/dist/src/packages/https-hooks.d.mts +4 -4
  30. package/dist/src/packages/https-hooks.d.mts.map +1 -1
  31. package/dist/src/packages/https-hooks.mjs +2 -2
  32. package/dist/src/packages/https-hooks.mjs.map +1 -1
  33. package/dist/src/packages/vite-loader.d.mts +21 -10
  34. package/dist/src/packages/vite-loader.d.mts.map +1 -1
  35. package/dist/src/packages/vite-loader.mjs +134 -82
  36. package/dist/src/packages/vite-loader.mjs.map +1 -1
  37. package/dist/src/pglite/pglite-node.d.mts +130 -0
  38. package/dist/src/pglite/pglite-node.d.mts.map +1 -0
  39. package/dist/src/pglite/pglite-node.mjs +4 -0
  40. package/dist/{utils-XWVecaNn.mjs → subgraph-extraction-cSpPp3Hq.mjs} +541 -17
  41. package/dist/subgraph-extraction-cSpPp3Hq.mjs.map +1 -0
  42. package/dist/subgraph-schema-owner-BEjuk2Xv.mjs +10 -0
  43. package/dist/subgraph-schema-owner-BEjuk2Xv.mjs.map +1 -0
  44. package/dist/types-CCI5IDgT.d.mts +82 -0
  45. package/dist/types-CCI5IDgT.d.mts.map +1 -0
  46. package/package.json +30 -20
  47. package/dist/adapter-gateway-apollo-CxJNBVyD.mjs.map +0 -1
  48. package/dist/adapter-gateway-apollo-DowrX6E_.mjs +0 -4
  49. package/dist/adapter-gateway-mercurius-CZVy88Za.mjs.map +0 -1
  50. package/dist/adapter-gateway-stitching-CaZjvRzx.mjs +0 -316
  51. package/dist/adapter-gateway-stitching-CaZjvRzx.mjs.map +0 -1
  52. package/dist/adapter-http-express-B39rPhqH.mjs.map +0 -1
  53. package/dist/adapter-http-fastify-BwXO6rqE.mjs.map +0 -1
  54. package/dist/path-normalize-BOQwY9wR.mjs +0 -23
  55. package/dist/path-normalize-BOQwY9wR.mjs.map +0 -1
  56. package/dist/types-DcYyNcHJ.d.mts +0 -48
  57. package/dist/types-DcYyNcHJ.d.mts.map +0 -1
  58. package/dist/utils-XWVecaNn.mjs.map +0 -1
  59. package/dist/websocket-DncAB9XK.mjs +0 -18
  60. package/dist/websocket-DncAB9XK.mjs.map +0 -1
@@ -1 +1 @@
1
- {"version":3,"file":"vite-loader.mjs","sources":["../../../src/packages/vite-loader.mts"],"sourcesContent":["import { viteCommonjs } from \"@originjs/vite-plugin-commonjs\";\nimport type {\n ProcessorFactoryBuilder,\n SubgraphClass,\n} from \"@powerhousedao/reactor-api\";\nimport type {\n DocumentModelModule,\n UpgradeManifest,\n} from \"@powerhousedao/shared/document-model\";\nimport { childLogger, type ILogger } from \"document-model\";\nimport path from \"node:path\";\nimport { readPackage } from \"read-pkg\";\nimport type { Logger, PluginOption, ViteDevServer } from \"vite\";\nimport { createLogger, createServer } from \"vite\";\nimport { isSubgraphClass } from \"../graphql/utils.js\";\nimport type {\n ISubscribablePackageLoader,\n ISubscriptionOptions,\n} from \"./types.js\";\nimport { debounce, extractUpgradeManifests, isSubpath } from \"./util.js\";\n\nexport function createViteLogger(logger: ILogger, prefix = \"\") {\n const customLogger = createLogger(\"info\", {\n prefix,\n });\n // Wrapped rather than assigned: the logger methods are bound to their own\n // instance, and re-homing them onto Vite's logger object made every Vite\n // log line throw.\n //\n // Vite's text goes through as a replacement, never as the format string: it\n // is somebody else's prose, not a template. `ILogger` substitutes `@token`,\n // and Vite log lines are full of npm scopes, so `pre-transforming\n // @powerhousedao/design-system` came out as `pre-transforming\n // null/design-system`. Substituting into `@line` instead emits it verbatim.\n //\n // Vite's second argument is dropped for the same reason. It is `LogOptions`\n // -- `{ clear, timestamp }` -- and forwarding it made it the replacement for\n // whatever `@token` the line happened to contain, or got appended as JSON.\n // Only `error` keeps it, where it carries the error itself.\n customLogger.info = (msg) => logger.info(\"@line\", msg);\n customLogger.warn = (msg) => logger.warn(\"@line\", msg);\n customLogger.error = (msg, options) =>\n options?.error\n ? logger.error(\"@line\", msg, options.error)\n : logger.error(\"@line\", msg);\n return customLogger;\n}\n\nexport class VitePackageLoader implements ISubscribablePackageLoader {\n private readonly logger = childLogger([\"reactor-api\", \"vite-loader\"]);\n\n private readonly vite: ViteDevServer;\n\n readonly name = \"VitePackageLoader\";\n\n static build(vite: ViteDevServer) {\n return new VitePackageLoader(vite);\n }\n\n constructor(vite: ViteDevServer) {\n this.vite = vite;\n }\n\n private getDocumentModelsPath(identifier: string): string {\n return path.posix.join(identifier, \"./document-models\");\n }\n\n private getSubgraphsPath(identifier: string): string {\n return path.posix.join(identifier, \"./subgraphs\");\n }\n\n private getProcessorsPath(identifier: string): string {\n return path.posix.join(identifier, \"./processors\");\n }\n\n public loadDocumentModels(identifier: string, immediate = false) {\n return this.#loadDocumentModelsWithDebounce(immediate, identifier);\n }\n\n #loadDocumentModelsWithDebounce = debounce(\n this.#loadDocumentModels.bind(this),\n 500,\n );\n\n async #loadDocumentModels(\n identifier: string,\n ): Promise<DocumentModelModule[]> {\n const fullPath = this.getDocumentModelsPath(identifier);\n this.logger.debug(\"Loading document models from\", fullPath);\n\n try {\n const localDMs = (await this.vite.ssrLoadModule(fullPath)) as Record<\n string,\n DocumentModelModule\n >;\n\n const exports = Object.values(localDMs);\n\n // duck type\n const documentModels: DocumentModelModule[] = [];\n for (const dm of exports) {\n if (dm.documentModel) {\n documentModels.push(dm);\n }\n }\n\n this.logger.verbose(\n ` ➜ Loaded ${documentModels.length} Document Models from: ${identifier}`,\n );\n\n return documentModels;\n } catch (e) {\n this.logger.debug(` ➜ No Document Models found for: ${identifier}`, e);\n }\n\n return [];\n }\n\n async loadUpgradeManifests(\n identifier: string,\n ): Promise<UpgradeManifest<readonly number[]>[]> {\n // Projects generated before the aggregate index re-exported the\n // manifests only expose them at document-models/upgrade-manifests, so\n // try both without requiring a regeneration.\n const candidatePaths = [\n this.getDocumentModelsPath(identifier),\n path.posix.join(this.getDocumentModelsPath(identifier), \"upgrade-manifests\"),\n ];\n for (const fullPath of candidatePaths) {\n try {\n const namespace = (await this.vite.ssrLoadModule(fullPath)) as Record<\n string,\n unknown\n >;\n const manifests = extractUpgradeManifests(namespace);\n if (manifests.length > 0) {\n this.logger.verbose(\n ` ➜ Loaded ${manifests.length} Upgrade Manifests from: ${identifier}`,\n );\n return manifests;\n }\n } catch (e) {\n this.logger.debug(\n ` ➜ No Upgrade Manifests found at ${fullPath} for: ${identifier}`,\n e,\n );\n }\n }\n return [];\n }\n\n async loadSubgraphs(identifier: string): Promise<SubgraphClass[]> {\n const fullPath = this.getSubgraphsPath(identifier);\n\n this.logger.verbose(\"Loading subgraphs from\", fullPath);\n\n let localSubgraphs: Record<string, Record<string, SubgraphClass>> = {};\n try {\n localSubgraphs = await this.vite.ssrLoadModule(fullPath);\n } catch (e) {\n this.logger.debug(` ➜ No Subgraphs found for: ${identifier}`, e);\n return [];\n }\n\n const subgraphs: SubgraphClass[] = [];\n for (const [name, subgraph] of Object.entries(localSubgraphs)) {\n const SubgraphClass = subgraph[name];\n if (isSubgraphClass(SubgraphClass)) {\n subgraphs.push(SubgraphClass);\n }\n }\n\n this.logger.debug(\n ` ➜ Loaded ${subgraphs.length} Subgraphs from: ${identifier}`,\n );\n\n return subgraphs;\n }\n\n async loadProcessors(\n identifier: string,\n ): Promise<ProcessorFactoryBuilder | null> {\n const fullPath = this.getProcessorsPath(identifier);\n\n this.logger.verbose(\"Loading processors from\", fullPath);\n\n try {\n const pkgModule = await this.vite.ssrLoadModule(fullPath);\n\n const factory = (\n pkgModule as Record<string, ProcessorFactoryBuilder | undefined>\n )?.processorFactory;\n\n if (factory && typeof factory === \"function\") {\n this.logger.verbose(\n ` ➜ Loaded Processor Factory from: ${identifier}`,\n );\n return factory;\n }\n } catch (e) {\n this.logger.debug(\n ` ➜ No Processor Factory found for: ${identifier}`,\n e,\n );\n }\n\n this.logger.verbose(` ➜ No Processor Factory found for: ${identifier}`);\n\n // return empty processor factory\n return null;\n }\n\n onDocumentModelsChange(\n identifier: string,\n handler: (documentModels: DocumentModelModule[]) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n const listener = async (changedPath: string) => {\n const documentModelsPath = this.getDocumentModelsPath(identifier);\n if (isSubpath(documentModelsPath, changedPath)) {\n const documentModels = await this.loadDocumentModels(identifier);\n handler(documentModels);\n }\n };\n\n // \"change\" alone misses files that are created or deleted: a removed\n // document-models/ entry would never report an empty result, and the\n // package's registered models would leak.\n this.vite.watcher.on(\"change\", listener);\n this.vite.watcher.on(\"add\", listener);\n this.vite.watcher.on(\"unlink\", listener);\n\n return () => {\n this.vite.watcher.off(\"change\", listener);\n this.vite.watcher.off(\"add\", listener);\n this.vite.watcher.off(\"unlink\", listener);\n };\n }\n\n onSubgraphsChange(\n identifier: string,\n handler: (subgraphs: SubgraphClass[]) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n const subgraphsPath = this.getSubgraphsPath(identifier);\n const listener = async (changedPath: string) => {\n if (isSubpath(subgraphsPath, changedPath)) {\n const subgraphs = await this.loadSubgraphs(identifier);\n handler(subgraphs);\n }\n };\n // \"change\" alone misses files that are created or deleted: a removed\n // subgraphs/ entry would never report an empty result, and the\n // package's registered subgraphs would leak.\n this.vite.watcher.on(\"change\", listener);\n this.vite.watcher.on(\"add\", listener);\n this.vite.watcher.on(\"unlink\", listener);\n\n return () => {\n this.vite.watcher.off(\"change\", listener);\n this.vite.watcher.off(\"add\", listener);\n this.vite.watcher.off(\"unlink\", listener);\n };\n }\n\n onProcessorsChange(\n identifier: string,\n handler: (processors: ProcessorFactoryBuilder | null) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n const processorsPath = this.getProcessorsPath(identifier);\n const listener = async (changedPath: string) => {\n if (isSubpath(processorsPath, changedPath)) {\n const processors = await this.loadProcessors(identifier);\n handler(processors);\n }\n };\n // \"change\" alone misses files that are created or deleted: a removed\n // processors/ entry would never report an empty result, and the\n // package's registered processor factories would leak.\n this.vite.watcher.on(\"change\", listener);\n this.vite.watcher.on(\"add\", listener);\n this.vite.watcher.on(\"unlink\", listener);\n\n return () => {\n this.vite.watcher.off(\"change\", listener);\n this.vite.watcher.off(\"add\", listener);\n this.vite.watcher.off(\"unlink\", listener);\n };\n }\n}\n\nexport async function startViteServer(root: string, logger?: Logger) {\n const packageJson = await readPackage({ cwd: root });\n\n const vite = await createServer({\n root,\n configFile: false,\n logger,\n server: { middlewareMode: true, watch: { ignored: [\"**/.ph/**\"] } },\n appType: \"custom\",\n build: {\n rollupOptions: {\n input: [],\n },\n },\n resolve: {\n tsconfigPaths: true,\n alias: {\n [packageJson.name]: root,\n },\n },\n plugins: [\n // cast: the plugin ships types built against an older vite, and the\n // mismatched Plugin type crashes tsc 6 during assignability checking\n viteCommonjs() as PluginOption,\n {\n name: \"suppress-hmr\",\n handleHotUpdate() {\n return []; // return empty array to suppress server refresh\n },\n },\n ],\n });\n\n return vite;\n}\n"],"names":["#loadDocumentModelsWithDebounce","#loadDocumentModels"],"mappings":"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","debug_id":"9da64ff1-d15d-5b85-94b1-f1b0dad67551"}
1
+ {"version":3,"file":"vite-loader.mjs","sources":["../../../src/packages/vite-loader.mts"],"sourcesContent":["import { viteCommonjs } from \"@originjs/vite-plugin-commonjs\";\nimport type {\n ProcessorFactoryBuilder,\n SubgraphClass,\n} from \"@powerhousedao/reactor-api\";\nimport type {\n DocumentModelModule,\n UpgradeManifest,\n} from \"@powerhousedao/shared/document-model\";\nimport { childLogger, type ILogger } from \"document-model\";\nimport path from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { readPackage } from \"read-pkg\";\nimport type { Logger, PluginOption, ViteDevServer } from \"vite\";\nimport { createLogger, createServer } from \"vite\";\nimport { extractDocumentModels } from \"./document-model-detection.js\";\nimport { extractSubgraphs } from \"./subgraph-extraction.js\";\nimport {\n BUILT_PIECE_LIST,\n PIECES_SUBPATH,\n packageRootOf,\n pieceListLocation,\n piecesFromListModule,\n} from \"./pieces.js\";\nimport type {\n ISubscribablePackageLoader,\n ISubscriptionOptions,\n PackagePieceEntry,\n} from \"./types.js\";\nimport {\n PACKAGE_MODULE_FAILED,\n debounce,\n extractUpgradeManifests,\n isSubpath,\n} from \"./util.js\";\nimport { runDetached, type ReportError } from \"../utils/detached.js\";\n\nexport function createViteLogger(logger: ILogger, prefix = \"\") {\n const customLogger = createLogger(\"info\", {\n prefix,\n });\n // Wrapped rather than assigned: the logger methods are bound to their own\n // instance, and re-homing them onto Vite's logger object made every Vite\n // log line throw.\n //\n // Vite's text goes through as a replacement, never as the format string: it\n // is somebody else's prose, not a template. `ILogger` substitutes `@token`,\n // and Vite log lines are full of npm scopes, so `pre-transforming\n // @powerhousedao/design-system` came out as `pre-transforming\n // null/design-system`. Substituting into `@line` instead emits it verbatim.\n //\n // Vite's second argument is dropped for the same reason. It is `LogOptions`\n // -- `{ clear, timestamp }` -- and forwarding it made it the replacement for\n // whatever `@token` the line happened to contain, or got appended as JSON.\n // Only `error` keeps it, where it carries the error itself.\n customLogger.info = (msg) => logger.info(\"@line\", msg);\n customLogger.warn = (msg) => logger.warn(\"@line\", msg);\n customLogger.error = (msg, options) =>\n options?.error\n ? logger.error(\"@line\", msg, options.error)\n : logger.error(\"@line\", msg);\n return customLogger;\n}\n\nexport interface VitePackageLoaderOptions {\n /** Modules, as paths or file URLs, whose dependencies a package the project\n * does not install may resolve from. This loader's own module always is. */\n resolveFrom?: string[];\n reportError?: ReportError;\n}\n\ninterface LoadedModule {\n id: string;\n namespace: Record<string, unknown>;\n}\n\nexport class VitePackageLoader implements ISubscribablePackageLoader {\n private readonly logger = childLogger([\"reactor-api\", \"vite-loader\"]);\n\n private readonly vite: ViteDevServer;\n\n private readonly importers: string[];\n\n readonly #reportError?: ReportError;\n\n readonly name = \"VitePackageLoader\";\n\n static build(vite: ViteDevServer, options?: VitePackageLoaderOptions) {\n return new VitePackageLoader(vite, options);\n }\n\n constructor(vite: ViteDevServer, options: VitePackageLoaderOptions = {}) {\n this.vite = vite;\n this.importers = [...(options.resolveFrom ?? []), import.meta.url].map(\n (from) => (from.startsWith(\"file:\") ? fileURLToPath(from) : from),\n );\n this.#reportError = options.reportError;\n }\n\n // The project first, then the host's own dependencies. A bare name or a path\n // Vite cannot resolve is a package without that module, not an error.\n async #resolve(identifier: string, subpath: string) {\n const aliased = path.isAbsolute(identifier)\n ? undefined\n : this.aliasedRoot(identifier);\n const specifier = path.posix.join(aliased ?? identifier, subpath);\n const bare = !aliased && !path.isAbsolute(identifier);\n const importers = bare ? [undefined, ...this.importers] : [undefined];\n const container = this.vite.environments.ssr.pluginContainer;\n for (const importer of importers) {\n try {\n const resolved = await container.resolveId(specifier, importer);\n if (resolved && !resolved.external) return resolved.id;\n } catch (e) {\n this.logger.debug(\"Could not resolve @specifier: @error\", specifier, e);\n }\n }\n return undefined;\n }\n\n // Resolved before it is loaded, so only a module that exists and fails is\n // reported and thrown; one a package does not have is a debug-level miss.\n async #load(\n identifier: string,\n subpath: string,\n ): Promise<LoadedModule | undefined> {\n const id = await this.#resolve(identifier, subpath);\n if (id === undefined) {\n this.logger.debug(\"No @subpath module in @pkg\", subpath, identifier);\n return undefined;\n }\n try {\n const namespace = (await this.vite.ssrLoadModule(id)) as Record<\n string,\n unknown\n >;\n return { id, namespace };\n } catch (e) {\n const message = e instanceof Error ? e.message : String(e);\n this.logger.error(\n \"Failed to load @subpath of @pkg from @id: @error\",\n subpath,\n identifier,\n id,\n message,\n );\n // Tagged: vite's own code can read as a package without the module.\n throw Object.assign(\n new Error(`Failed to load ${id}: ${message}`, { cause: e }),\n { code: PACKAGE_MODULE_FAILED },\n );\n }\n }\n\n private getDocumentModelsPath(identifier: string): string {\n return path.posix.join(identifier, \"./document-models\");\n }\n\n private getSubgraphsPath(identifier: string): string {\n return path.posix.join(identifier, \"./subgraphs\");\n }\n\n private getProcessorsPath(identifier: string): string {\n return path.posix.join(identifier, \"./processors\");\n }\n\n private getPiecesPath(identifier: string): string {\n return path.posix.join(identifier, `./${PIECES_SUBPATH}`);\n }\n\n // The dev server aliases the local project by its own package name, so a\n // package that is this project is rooted at the source tree vite serves.\n private aliasedRoot(identifier: string): string | undefined {\n const alias = this.vite.config.resolve.alias;\n const entries = Array.isArray(alias) ? alias : [];\n const hit = entries.find((entry) => entry.find === identifier);\n return typeof hit?.replacement === \"string\" ? hit.replacement : undefined;\n }\n\n // What a declared piece path is relative to. Not the module vite loaded: a\n // list read from source still points at the built output beside it.\n private pieceRoot(identifier: string, listId?: string): string | undefined {\n if (!path.isAbsolute(identifier)) {\n const aliased = this.aliasedRoot(identifier);\n if (aliased) return aliased;\n // A built list resolved from wherever the package is installed.\n if (listId) return packageRootOf(path.dirname(listId));\n }\n try {\n return pieceListLocation(identifier).root;\n } catch {\n return undefined;\n }\n }\n\n async loadDocumentModels(identifier: string): Promise<DocumentModelModule[]> {\n this.logger.debug(\n \"Loading document models from\",\n this.getDocumentModelsPath(identifier),\n );\n const loaded = await this.#load(identifier, \"document-models\");\n if (!loaded) return [];\n\n const documentModels = extractDocumentModels(loaded.namespace);\n this.logger.verbose(\n ` ➜ Loaded ${documentModels.length} Document Models from: ${identifier}`,\n );\n return documentModels;\n }\n\n async loadUpgradeManifests(\n identifier: string,\n ): Promise<UpgradeManifest<readonly number[]>[]> {\n // Projects generated before the aggregate index re-exported the\n // manifests only expose them at document-models/upgrade-manifests.\n for (const subpath of [\n \"document-models\",\n \"document-models/upgrade-manifests\",\n ]) {\n const loaded = await this.#load(identifier, subpath);\n if (!loaded) continue;\n const manifests = extractUpgradeManifests(loaded.namespace);\n if (manifests.length > 0) {\n this.logger.verbose(\n ` ➜ Loaded ${manifests.length} Upgrade Manifests from: ${identifier}`,\n );\n return manifests;\n }\n }\n return [];\n }\n\n async loadSubgraphs(identifier: string): Promise<SubgraphClass[]> {\n this.logger.verbose(\n \"Loading subgraphs from\",\n this.getSubgraphsPath(identifier),\n );\n const loaded = await this.#load(identifier, \"subgraphs\");\n if (!loaded) return [];\n\n const subgraphs = extractSubgraphs(loaded.namespace);\n\n this.logger.debug(\n ` ➜ Loaded ${subgraphs.length} Subgraphs from: ${identifier}`,\n );\n\n return subgraphs;\n }\n\n async loadProcessors(\n identifier: string,\n ): Promise<ProcessorFactoryBuilder | null> {\n this.logger.verbose(\n \"Loading processors from\",\n this.getProcessorsPath(identifier),\n );\n const loaded = await this.#load(identifier, \"processors\");\n const factory = loaded?.namespace.processorFactory;\n if (typeof factory === \"function\") {\n this.logger.verbose(` ➜ Loaded Processor Factory from: ${identifier}`);\n return factory as ProcessorFactoryBuilder;\n }\n\n this.logger.verbose(` ➜ No Processor Factory found for: ${identifier}`);\n return null;\n }\n\n // The list only, never a piece: in dev it is usually the TypeScript source,\n // and what it names is still the built bundle a worker will load.\n async loadPieces(identifier: string): Promise<PackagePieceEntry[]> {\n this.logger.verbose(\"Loading pieces from\", this.getPiecesPath(identifier));\n const loaded = await this.#load(identifier, PIECES_SUBPATH);\n if (!loaded) return [];\n\n const root = this.pieceRoot(identifier, loaded.id);\n if (root === undefined) {\n this.logger.debug(` ➜ No package root found for: ${identifier}`);\n return [];\n }\n\n const pieces = piecesFromListModule(loaded.namespace, {\n root,\n identifier,\n logger: this.logger,\n });\n this.logger.debug(\n ` ➜ Loaded ${pieces.length} Pieces from: ${identifier}`,\n );\n return pieces;\n }\n\n // One detached reload per burst of file events. \"add\" and \"unlink\" too, or a\n // removed entry never reports empty and its registrations leak. Once\n // unsubscribed, no pending or running reload reaches `handler`, and a\n // failed load leaves the last good set.\n #watch<T>(\n label: string,\n matches: (changedPath: string) => unknown,\n load: () => Promise<T>,\n handler: (value: T) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n let subscribed = true;\n const reloadOnce = debounce(\n () =>\n runDetached(\n label,\n async () => {\n if (!subscribed) return;\n let value: T;\n try {\n value = await load();\n } catch (e) {\n if ((e as NodeJS.ErrnoException).code === PACKAGE_MODULE_FAILED) {\n return;\n }\n throw e;\n }\n if (subscribed) handler(value);\n },\n { logger: this.logger, report: this.#reportError },\n ),\n options?.debounce ?? 100,\n );\n const listener = (changedPath: string) => {\n if (matches(changedPath)) void reloadOnce();\n };\n const events = [\"change\", \"add\", \"unlink\"] as const;\n for (const event of events) this.vite.watcher.on(event, listener);\n\n return () => {\n subscribed = false;\n for (const event of events) this.vite.watcher.off(event, listener);\n };\n }\n\n onDocumentModelsChange(\n identifier: string,\n handler: (documentModels: DocumentModelModule[]) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n const documentModelsPath = this.getDocumentModelsPath(identifier);\n return this.#watch(\n `Reloading the document models of ${identifier}`,\n (changedPath) => isSubpath(documentModelsPath, changedPath),\n () => this.loadDocumentModels(identifier),\n handler,\n options,\n );\n }\n\n onSubgraphsChange(\n identifier: string,\n handler: (subgraphs: SubgraphClass[]) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n const subgraphsPath = this.getSubgraphsPath(identifier);\n return this.#watch(\n `Reloading the subgraphs of ${identifier}`,\n (changedPath) => isSubpath(subgraphsPath, changedPath),\n () => this.loadSubgraphs(identifier),\n handler,\n options,\n );\n }\n\n onProcessorsChange(\n identifier: string,\n handler: (processors: ProcessorFactoryBuilder | null) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n const processorsPath = this.getProcessorsPath(identifier);\n return this.#watch(\n `Reloading the processors of ${identifier}`,\n (changedPath) => isSubpath(processorsPath, changedPath),\n () => this.loadProcessors(identifier),\n handler,\n options,\n );\n }\n\n onPiecesChange(\n identifier: string,\n handler: (pieces: PackagePieceEntry[]) => void,\n options?: ISubscriptionOptions,\n ): () => void {\n // Both the source list and the build output: the list says which pieces a\n // package ships, and only the build decides whether one is there to run.\n const watched = [this.getPiecesPath(identifier)];\n const root = this.pieceRoot(identifier);\n if (root !== undefined) {\n watched.push(path.dirname(path.resolve(root, BUILT_PIECE_LIST)));\n }\n return this.#watch(\n `Reloading the pieces of ${identifier}`,\n (changedPath) => watched.some((dir) => isSubpath(dir, changedPath)),\n () => this.loadPieces(identifier),\n handler,\n options,\n );\n }\n}\n\nexport async function startViteServer(root: string, logger?: Logger) {\n const packageJson = await readPackage({ cwd: root });\n\n const vite = await createServer({\n root,\n configFile: false,\n logger,\n server: { middlewareMode: true, watch: { ignored: [\"**/.ph/**\"] } },\n appType: \"custom\",\n build: {\n rollupOptions: {\n input: [],\n },\n },\n resolve: {\n tsconfigPaths: true,\n alias: {\n [packageJson.name]: root,\n },\n },\n plugins: [\n // cast: the plugin ships types built against an older vite, and the\n // mismatched Plugin type crashes tsc 6 during assignability checking\n viteCommonjs() as PluginOption,\n {\n name: \"suppress-hmr\",\n handleHotUpdate() {\n return []; // return empty array to suppress server refresh\n },\n },\n ],\n });\n\n return vite;\n}\n"],"names":[],"mappings":"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","debug_id":"617a3ed8-6fe0-5cfb-b6f9-2d2ab2656cc3"}
@@ -0,0 +1,130 @@
1
+ import { ILogger } from "document-model";
2
+ import nodeFs from "node:fs";
3
+ import { PGlite } from "@electric-sql/pglite";
4
+ import { NodeFS } from "@electric-sql/pglite/nodefs";
5
+ //#region src/pglite/maintenance.d.ts
6
+ export declare const DEFAULT_MAINTENANCE_INTERVAL_MS: number;
7
+ export declare const DEFAULT_VACUUM_FULL_ABOVE_BYTES: number;
8
+ type MaintenanceOutcome = "vacuum" | "vacuum-full" | "idle" | "not-ready" | "in-transaction" | "failed";
9
+ interface MaintenanceLogger {
10
+ warn(message: string): void;
11
+ }
12
+ interface MaintenanceOptions {
13
+ /** VACUUM + CHECKPOINT cadence; PGlite has no autovacuum. Default 5 min; 0 disables. */
14
+ intervalMs?: number;
15
+ /** First pass runs VACUUM FULL when `base/` exceeds this at open. Default 256 MB; 0 disables. */
16
+ vacuumFullAboveBytes?: number;
17
+ logger?: MaintenanceLogger;
18
+ }
19
+ export declare class PgliteMaintenance {
20
+ private readonly intervalMs;
21
+ private readonly vacuumFullAboveBytes;
22
+ private readonly logger?;
23
+ private pg?;
24
+ private label;
25
+ private closing;
26
+ private syncsSinceMaintenance;
27
+ private vacuumFullPending;
28
+ private timer?;
29
+ private inFlight?;
30
+ constructor(options?: MaintenanceOptions);
31
+ get scheduled(): boolean;
32
+ get running(): boolean;
33
+ start(pg: PGlite, label: string, baseBytes: number): void;
34
+ noteSync(): void;
35
+ stop(): Promise<void>;
36
+ run(): Promise<MaintenanceOutcome>;
37
+ private schedule;
38
+ private cancel;
39
+ }
40
+ //#endregion
41
+ //#region src/pglite/durable-node-fs.d.ts
42
+ type NodeFsClass = typeof NodeFS;
43
+ interface DurableNodeFsOptions {
44
+ /** Default true; `PH_PGLITE_FSYNC=0` turns it off (power-loss durability off). */
45
+ fsync?: boolean;
46
+ /** Default 5 min; 0 disables. */
47
+ maintenanceIntervalMs?: number;
48
+ /** `base/` size at open; default 256 MB; 0 disables. */
49
+ vacuumFullAboveBytes?: number;
50
+ logger?: {
51
+ warn(message: string): void;
52
+ };
53
+ /** Emscripten abort (a Postgres PANIC, e.g. ENOSPC on WAL). */
54
+ onAbort?: (what: unknown) => void;
55
+ hostFs?: Pick<typeof nodeFs, "fsyncSync" | "fdatasyncSync">;
56
+ }
57
+ type DurableNodeFs = InstanceType<NodeFsClass> & {
58
+ readonly maintenance: PgliteMaintenance;
59
+ };
60
+ export declare function resolvePgliteFsync(env: Record<string, string | undefined>): boolean;
61
+ /** Built over the passed-in class so PG16 dirs on `pglite-legacy-02` get the same behaviour. */
62
+ export declare function createDurableNodeFs(Base: NodeFsClass, dataDir: string, options?: DurableNodeFsOptions): DurableNodeFs;
63
+ //#endregion
64
+ //#region src/pglite/sync-tree.d.ts
65
+ interface SyncTreeHostFs {
66
+ fsyncSync(fd: number): void;
67
+ }
68
+ interface SyncTreeResult {
69
+ files: number;
70
+ dirs: number;
71
+ }
72
+ /** One pass over a finished tree; interleaving fsync with writes costs seconds. */
73
+ export declare function syncTree(root: string, hostFs?: SyncTreeHostFs): SyncTreeResult;
74
+ /** fsyncs a directory's entries; false where the platform refuses (Windows). */
75
+ export declare function syncDirectory(dir: string, hostFs?: SyncTreeHostFs): boolean;
76
+ //#endregion
77
+ //#region src/pglite/snapshot-reader.d.ts
78
+ export declare const SNAPSHOT_FILE_NAME = "snapshot.bin";
79
+ interface ExtractSnapshotOptions {
80
+ chunkSize?: number;
81
+ /** Default true: one fsync pass over the tree after the last write. */
82
+ sync?: boolean;
83
+ hostFs?: SyncTreeHostFs;
84
+ }
85
+ interface ExtractedSnapshot {
86
+ pgVersionMajor: number;
87
+ /** `global/pg_control` bytes; absent only in synthetic trees. */
88
+ pgControl?: Buffer;
89
+ /** Entries written to disk; skipped entries are not counted. */
90
+ entries: number;
91
+ /** Size of the snapshot file. */
92
+ bytes: number;
93
+ }
94
+ /** Unpacks a snapshot into the existing `outDir`. */
95
+ export declare function extractSnapshot(snapshotPath: string, outDir: string, options?: ExtractSnapshotOptions): Promise<ExtractedSnapshot>;
96
+ //#endregion
97
+ //#region src/pglite/convert-snapshot-dir.d.ts
98
+ interface VerifyHandle {
99
+ query<T>(sql: string): Promise<{
100
+ rows: T[];
101
+ }>;
102
+ close(): Promise<void>;
103
+ }
104
+ type ConversionStep = "extract" | "verify" | "renameOld" | "renameNew" | "removeOld";
105
+ interface ConversionDeps {
106
+ /** Opens `dataDir` with the stock NodeFS of the PGlite module for `major`. */
107
+ openForVerify: (major: number, dataDir: string) => Promise<VerifyHandle>;
108
+ logger: ILogger;
109
+ /** Test hook: throw after a named step to simulate a crash there. */
110
+ afterStep?: (step: ConversionStep) => void | Promise<void>;
111
+ hostFs?: SyncTreeHostFs;
112
+ }
113
+ /** Settles the debris of an interrupted conversion; runs before it at boot. */
114
+ export declare function recoverConversion(dir: string, deps: ConversionDeps): Promise<void>;
115
+ /** Extracts into `.converting`, verifies by opening it, swaps through `.old`. */
116
+ export declare function convertSnapshotDir(dir: string, deps: ConversionDeps): Promise<"converted" | "none">;
117
+ //#endregion
118
+ //#region src/pglite/preflight.d.ts
119
+ /** PG major of the pinned @electric-sql/pglite; it exports none, so the test checks initdb. */
120
+ export declare const CURRENT_PGLITE_MAJOR = 17;
121
+ /** `openForVerify` over the loaded PGlite module only. */
122
+ export declare function openCurrentPgliteForVerify(major: number, dataDir: string): Promise<VerifyHandle>;
123
+ /** Converts a snapshot store and clears the files a previous run leaves behind. */
124
+ export declare function preparePgliteDataDir(dir: string, deps: ConversionDeps): Promise<void>;
125
+ /** PGlite leaves `postmaster.pid` after every close and `pg_wal/xlogtemp.*` after some. */
126
+ export declare function removeStalePgliteFiles(dir: string, logger: Pick<ILogger, "debug">): Promise<void>;
127
+ //#endregion
128
+ export type { ConversionDeps, ConversionStep, DurableNodeFs, DurableNodeFsOptions, ExtractSnapshotOptions, ExtractedSnapshot, MaintenanceLogger, MaintenanceOptions, MaintenanceOutcome, NodeFsClass, SyncTreeHostFs, SyncTreeResult, VerifyHandle };
129
+ export {};
130
+ //# sourceMappingURL=pglite-node.d.mts.map
@@ -0,0 +1 @@
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;;wBA4ES,oBACd,MAAM,aACN,iBACA,UAAS,uBACR;;;UC5Gc;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"}
@@ -0,0 +1,4 @@
1
+ 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-C-UQXrjU.mjs";
2
+ 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 };
3
+ !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]="ed420ffd-8935-59fa-b4d8-f15e5aeaf71d")}catch(e){}}();
4
+ //# debugId=ed420ffd-8935-59fa-b4d8-f15e5aeaf71d