@powerhousedao/reactor-api 6.2.2-dev.9 → 6.2.2

package/dist/path-normalize-DWWFLiy6.mjs

@@ -0,0 +1,23 @@
+//#region src/graphql/gateway/path-normalize.ts
+/**
+* Normalises a route path for path-to-regexp v8:
+* - Collapses duplicate slashes (e.g. "//explorer" → "/explorer")
+* - Converts legacy optional-param syntax "/:param?" → "{/:param}". The
+*   slash must move inside the group: in p-r v8 a group whose content
+*   begins with "/" is what makes the slash and the parameter optional
+*   together, while a literal "/" left in front of the group compiles to
+*   a pattern that matches nothing (and v8 rejects a bare ":param?").
+*
+* Shared by both http adapters so registry dispatch matches the same path
+* shapes regardless of which framework is in use.
+*/
+
+!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]="f2d4c602-31b8-5f1c-aa79-49d1d196b0c0")}catch(e){}}();
+function normalizePath(path) {
+	return path.replace(/\/+/g, "/").replace(/\/:(\w+)\?/g, "{/:$1}");
+}
+//#endregion
+export { normalizePath as t };
+
+//# sourceMappingURL=path-normalize-DWWFLiy6.mjs.map
+//# debugId=f2d4c602-31b8-5f1c-aa79-49d1d196b0c0

package/dist/path-normalize-DWWFLiy6.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-normalize-DWWFLiy6.mjs","sources":["../src/graphql/gateway/path-normalize.ts"],"sourcesContent":["/**\n * Normalises a route path for path-to-regexp v8:\n * - Collapses duplicate slashes (e.g. \"//explorer\" → \"/explorer\")\n * - Converts legacy optional-param syntax \"/:param?\" → \"{/:param}\". The\n *   slash must move inside the group: in p-r v8 a group whose content\n *   begins with \"/\" is what makes the slash and the parameter optional\n *   together, while a literal \"/\" left in front of the group compiles to\n *   a pattern that matches nothing (and v8 rejects a bare \":param?\").\n *\n * Shared by both http adapters so registry dispatch matches the same path\n * shapes regardless of which framework is in use.\n */\nexport function normalizePath(path: string): string {\n  return path.replace(/\\/+/g, \"/\").replace(/\\/:(\\w+)\\?/g, \"{/:$1}\");\n}\n"],"names":[],"mappings":";;;;;;;;;;;;;;;AAYA,SAAgB,cAAc,MAAsB;AAClD,QAAO,KAAK,QAAQ,QAAQ,IAAI,CAAC,QAAQ,eAAe,SAAS","debug_id":"f2d4c602-31b8-5f1c-aa79-49d1d196b0c0"}

package/dist/src/packages/https-hooks.mjs

@@ -1,8 +1,8 @@
 
 !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]="c7cff29c-399f-5fdb-84b9-d0be2e6093bb")}catch(e){}}();
+import { pathToFileURL } from "node:url";
 import { get } from "node:http";
 import { get as get$1 } from "node:https";
-import { pathToFileURL } from "node:url";
 //#region src/packages/https-hooks.mts
 /**
 * Resolve hook: resolves relative specifiers against HTTP/HTTPS parent URLs.

package/dist/src/packages/vite-loader.d.mts

@@ -1,6 +1,6 @@
-import { a as ISubscribablePackageLoader, o as ISubscriptionOptions } from "../../types-DnHgkahK.mjs";
+import { a as ISubscribablePackageLoader, o as ISubscriptionOptions } from "../../types-Bz2niABC.mjs";
 import { ILogger } from "document-model";
-import { DocumentModelModule } from "@powerhousedao/shared/document-model";
+import { DocumentModelModule, UpgradeManifest } from "@powerhousedao/shared/document-model";
 import { Logger, ViteDevServer } from "vite";
 import { ProcessorFactoryBuilder, SubgraphClass } from "@powerhousedao/reactor-api";
 
@@ -17,6 +17,7 @@ declare class VitePackageLoader implements ISubscribablePackageLoader {
   private getSubgraphsPath;
   private getProcessorsPath;
   loadDocumentModels(identifier: string, immediate?: boolean): Promise<DocumentModelModule[]>;
+  loadUpgradeManifests(identifier: string): Promise<UpgradeManifest<readonly number[]>[]>;
   loadSubgraphs(identifier: string): Promise<SubgraphClass[]>;
   loadProcessors(identifier: string): Promise<ProcessorFactoryBuilder | null>;
   onDocumentModelsChange(identifier: string, handler: (documentModels: DocumentModelModule[]) => void, options?: ISubscriptionOptions): () => void;

package/dist/src/packages/vite-loader.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"vite-loader.d.mts","names":[],"sources":["../../../src/packages/vite-loader.mts"],"mappings":";;;;;;;iBAkBgB,gBAAA,CAAiB,MAAA,EAAQ,OAAA,EAAS,MAAA,YAAW,MAAA;AAAA,cAUhD,iBAAA,YAA6B,0BAAA;EAAA;mBACvB,MAAA;EAAA,iBAEA,IAAA;EAAA,SAER,IAAA;EAAA,OAEF,KAAA,CAAM,IAAA,EAAM,aAAA,GAAa,iBAAA;cAIpB,IAAA,EAAM,aAAA;EAAA,QAIV,qBAAA;EAAA,QAIA,gBAAA;EAAA,QAIA,iBAAA;EAID,kBAAA,CAAmB,UAAA,UAAoB,SAAA,aAAiB,OAAA,CAAA,mBAAA;EA2CzD,aAAA,CAAc,UAAA,WAAqB,OAAA,CAAQ,aAAA;EA4B3C,cAAA,CACJ,UAAA,WACC,OAAA,CAAQ,uBAAA;EA+BX,sBAAA,CACE,UAAA,UACA,OAAA,GAAU,cAAA,EAAgB,mBAAA,aAC1B,OAAA,GAAU,oBAAA;EAiBZ,iBAAA,CACE,UAAA,UACA,OAAA,GAAU,SAAA,EAAW,aAAA,aACrB,OAAA,GAAU,oBAAA;EAgBZ,kBAAA,CACE,UAAA,UACA,OAAA,GAAU,UAAA,EAAY,uBAAA,kBACtB,OAAA,GAAU,oBAAA;AAAA;AAAA,iBAiBQ,eAAA,CAAgB,IAAA,UAAc,MAAA,GAAS,MAAA,GAAM,OAAA,CAAA,aAAA"}
+{"version":3,"file":"vite-loader.d.mts","names":[],"sources":["../../../src/packages/vite-loader.mts"],"mappings":";;;;;;;iBAqBgB,gBAAA,CAAiB,MAAA,EAAQ,OAAA,EAAS,MAAA,YAAW,MAAA;AAAA,cAUhD,iBAAA,YAA6B,0BAAA;EAAA;mBACvB,MAAA;EAAA,iBAEA,IAAA;EAAA,SAER,IAAA;EAAA,OAEF,KAAA,CAAM,IAAA,EAAM,aAAA,GAAa,iBAAA;cAIpB,IAAA,EAAM,aAAA;EAAA,QAIV,qBAAA;EAAA,QAIA,gBAAA;EAAA,QAIA,iBAAA;EAID,kBAAA,CAAmB,UAAA,UAAoB,SAAA,aAAiB,OAAA,CAAA,mBAAA;EA2CzD,oBAAA,CACJ,UAAA,WACC,OAAA,CAAQ,eAAA;EA+BL,aAAA,CAAc,UAAA,WAAqB,OAAA,CAAQ,aAAA;EA4B3C,cAAA,CACJ,UAAA,WACC,OAAA,CAAQ,uBAAA;EA+BX,sBAAA,CACE,UAAA,UACA,OAAA,GAAU,cAAA,EAAgB,mBAAA,aAC1B,OAAA,GAAU,oBAAA;EAwBZ,iBAAA,CACE,UAAA,UACA,OAAA,GAAU,SAAA,EAAW,aAAA,aACrB,OAAA,GAAU,oBAAA;EAuBZ,kBAAA,CACE,UAAA,UACA,OAAA,GAAU,UAAA,EAAY,uBAAA,kBACtB,OAAA,GAAU,oBAAA;AAAA;AAAA,iBAwBQ,eAAA,CAAgB,IAAA,UAAc,MAAA,GAAS,MAAA,GAAM,OAAA,CAAA,aAAA"}

package/dist/src/packages/vite-loader.mjs

@@ -1,6 +1,6 @@
 
-!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]="02fc7276-e4d6-5195-b4ce-5791df961225")}catch(e){}}();
-import { a as isSubgraphClass, o as debounce, s as isSubpath } from "../../utils-iibOQ50e.mjs";
+!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]="e3971ec2-a824-5da6-9a2a-805e72db81bf")}catch(e){}}();
+import { a as isSubgraphClass, c as isSubpath, o as debounce, s as extractUpgradeManifests } from "../../utils-lHoPB-ft.mjs";
 import { childLogger } from "document-model";
 import path from "node:path";
 import { viteCommonjs } from "@originjs/vite-plugin-commonjs";
@@ -25,13 +25,13 @@ var VitePackageLoader = class VitePackageLoader {
 		this.vite = vite;
 	}
 	getDocumentModelsPath(identifier) {
-		return path.join(identifier, "./document-models");
+		return path.posix.join(identifier, "./document-models");
 	}
 	getSubgraphsPath(identifier) {
-		return path.join(identifier, "./subgraphs");
+		return path.posix.join(identifier, "./subgraphs");
 	}
 	getProcessorsPath(identifier) {
-		return path.join(identifier, "./processors");
+		return path.posix.join(identifier, "./processors");
 	}
 	loadDocumentModels(identifier, immediate = false) {
 		return this.#loadDocumentModelsWithDebounce(immediate, identifier);
@@ -52,6 +52,19 @@ var VitePackageLoader = class VitePackageLoader {
 		}
 		return [];
 	}
+	async loadUpgradeManifests(identifier) {
+		const candidatePaths = [this.getDocumentModelsPath(identifier), path.posix.join(this.getDocumentModelsPath(identifier), "upgrade-manifests")];
+		for (const fullPath of candidatePaths) try {
+			const manifests = extractUpgradeManifests(await this.vite.ssrLoadModule(fullPath));
+			if (manifests.length > 0) {
+				this.logger.verbose(`  ➜  Loaded ${manifests.length} Upgrade Manifests from: ${identifier}`);
+				return manifests;
+			}
+		} catch (e) {
+			this.logger.debug(`  ➜  No Upgrade Manifests found at ${fullPath} for: ${identifier}`, e);
+		}
+		return [];
+	}
 	async loadSubgraphs(identifier) {
 		const fullPath = this.getSubgraphsPath(identifier);
 		this.logger.verbose("Loading subgraphs from", fullPath);
@@ -90,18 +103,26 @@ var VitePackageLoader = class VitePackageLoader {
 			if (isSubpath(this.getDocumentModelsPath(identifier), changedPath)) handler(await this.loadDocumentModels(identifier));
 		};
 		this.vite.watcher.on("change", listener);
+		this.vite.watcher.on("add", listener);
+		this.vite.watcher.on("unlink", listener);
 		return () => {
 			this.vite.watcher.off("change", listener);
+			this.vite.watcher.off("add", listener);
+			this.vite.watcher.off("unlink", listener);
 		};
 	}
 	onSubgraphsChange(identifier, handler, options) {
 		const subgraphsPath = this.getSubgraphsPath(identifier);
-		const listener = debounce(async (changedPath) => {
+		const listener = async (changedPath) => {
 			if (isSubpath(subgraphsPath, changedPath)) handler(await this.loadSubgraphs(identifier));
-		}, options?.debounce ?? 100);
+		};
 		this.vite.watcher.on("change", listener);
+		this.vite.watcher.on("add", listener);
+		this.vite.watcher.on("unlink", listener);
 		return () => {
 			this.vite.watcher.off("change", listener);
+			this.vite.watcher.off("add", listener);
+			this.vite.watcher.off("unlink", listener);
 		};
 	}
 	onProcessorsChange(identifier, handler, options) {
@@ -110,8 +131,12 @@ var VitePackageLoader = class VitePackageLoader {
 			if (isSubpath(processorsPath, changedPath)) handler(await this.loadProcessors(identifier));
 		};
 		this.vite.watcher.on("change", listener);
+		this.vite.watcher.on("add", listener);
+		this.vite.watcher.on("unlink", listener);
 		return () => {
 			this.vite.watcher.off("change", listener);
+			this.vite.watcher.off("add", listener);
+			this.vite.watcher.off("unlink", listener);
 		};
 	}
 };
@@ -142,4 +167,4 @@ async function startViteServer(root, logger) {
 export { VitePackageLoader, createViteLogger, startViteServer };
 
 //# sourceMappingURL=vite-loader.mjs.map
-//# debugId=02fc7276-e4d6-5195-b4ce-5791df961225
+//# debugId=e3971ec2-a824-5da6-9a2a-805e72db81bf

package/dist/src/packages/vite-loader.mjs.map

@@ -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 { DocumentModelModule } 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, isSubpath } from \"./util.js\";\n\nexport function createViteLogger(logger: ILogger, prefix = \"\") {\n  const customLogger = createLogger(\"info\", {\n    prefix,\n  });\n  customLogger.info = logger.info;\n  customLogger.warn = logger.warn;\n  customLogger.error = logger.error;\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.join(identifier, \"./document-models\");\n  }\n\n  private getSubgraphsPath(identifier: string): string {\n    return path.join(identifier, \"./subgraphs\");\n  }\n\n  private getProcessorsPath(identifier: string): string {\n    return path.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 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    this.vite.watcher.on(\"change\", listener);\n\n    return () => {\n      this.vite.watcher.off(\"change\", 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 = debounce(async (changedPath: string) => {\n      if (isSubpath(subgraphsPath, changedPath)) {\n        const subgraphs = await this.loadSubgraphs(identifier);\n        handler(subgraphs);\n      }\n    }, options?.debounce ?? 100);\n    this.vite.watcher.on(\"change\", listener);\n\n    return () => {\n      this.vite.watcher.off(\"change\", 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    this.vite.watcher.on(\"change\", listener);\n\n    return () => {\n      this.vite.watcher.off(\"change\", 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":";;;;;;;;;AAkBA,SAAgB,iBAAiB,QAAiB,SAAS,IAAI;CAC7D,MAAM,eAAe,aAAa,QAAQ,EACxC,QACD,CAAC;AACF,cAAa,OAAO,OAAO;AAC3B,cAAa,OAAO,OAAO;AAC3B,cAAa,QAAQ,OAAO;AAC5B,QAAO;;AAGT,IAAa,oBAAb,MAAa,kBAAwD;CACnE,SAA0B,YAAY,CAAC,eAAe,cAAc,CAAC;CAErE;CAEA,OAAgB;CAEhB,OAAO,MAAM,MAAqB;AAChC,SAAO,IAAI,kBAAkB,KAAK;;CAGpC,YAAY,MAAqB;AAC/B,OAAK,OAAO;;CAGd,sBAA8B,YAA4B;AACxD,SAAO,KAAK,KAAK,YAAY,oBAAoB;;CAGnD,iBAAyB,YAA4B;AACnD,SAAO,KAAK,KAAK,YAAY,cAAc;;CAG7C,kBAA0B,YAA4B;AACpD,SAAO,KAAK,KAAK,YAAY,eAAe;;CAG9C,mBAA0B,YAAoB,YAAY,OAAO;AAC/D,SAAO,MAAA,+BAAqC,WAAW,WAAW;;CAGpE,kCAAkC,SAChC,MAAA,mBAAyB,KAAK,KAAK,EACnC,IACD;CAED,OAAA,mBACE,YACgC;EAChC,MAAM,WAAW,KAAK,sBAAsB,WAAW;AACvD,OAAK,OAAO,MAAM,gCAAgC,SAAS;AAE3D,MAAI;GACF,MAAM,WAAY,MAAM,KAAK,KAAK,cAAc,SAAS;GAKzD,MAAM,UAAU,OAAO,OAAO,SAAS;GAGvC,MAAM,iBAAwC,EAAE;AAChD,QAAK,MAAM,MAAM,QACf,KAAI,GAAG,cACL,gBAAe,KAAK,GAAG;AAI3B,QAAK,OAAO,QACV,eAAe,eAAe,OAAO,yBAAyB,aAC/D;AAED,UAAO;WACA,GAAG;AACV,QAAK,OAAO,MAAM,sCAAsC,cAAc,EAAE;;AAG1E,SAAO,EAAE;;CAGX,MAAM,cAAc,YAA8C;EAChE,MAAM,WAAW,KAAK,iBAAiB,WAAW;AAElD,OAAK,OAAO,QAAQ,0BAA0B,SAAS;EAEvD,IAAI,iBAAgE,EAAE;AACtE,MAAI;AACF,oBAAiB,MAAM,KAAK,KAAK,cAAc,SAAS;WACjD,GAAG;AACV,QAAK,OAAO,MAAM,gCAAgC,cAAc,EAAE;AAClE,UAAO,EAAE;;EAGX,MAAM,YAA6B,EAAE;AACrC,OAAK,MAAM,CAAC,MAAM,aAAa,OAAO,QAAQ,eAAe,EAAE;GAC7D,MAAM,gBAAgB,SAAS;AAC/B,OAAI,gBAAgB,cAAc,CAChC,WAAU,KAAK,cAAc;;AAIjC,OAAK,OAAO,MACV,eAAe,UAAU,OAAO,mBAAmB,aACpD;AAED,SAAO;;CAGT,MAAM,eACJ,YACyC;EACzC,MAAM,WAAW,KAAK,kBAAkB,WAAW;AAEnD,OAAK,OAAO,QAAQ,2BAA2B,SAAS;AAExD,MAAI;GAGF,MAAM,WAFY,MAAM,KAAK,KAAK,cAAc,SAAS,GAItD;AAEH,OAAI,WAAW,OAAO,YAAY,YAAY;AAC5C,SAAK,OAAO,QACV,uCAAuC,aACxC;AACD,WAAO;;WAEF,GAAG;AACV,QAAK,OAAO,MACV,wCAAwC,cACxC,EACD;;AAGH,OAAK,OAAO,QAAQ,wCAAwC,aAAa;AAGzE,SAAO;;CAGT,uBACE,YACA,SACA,SACY;EACZ,MAAM,WAAW,OAAO,gBAAwB;AAE9C,OAAI,UADuB,KAAK,sBAAsB,WAAW,EAC/B,YAAY,CAE5C,SADuB,MAAM,KAAK,mBAAmB,WAAW,CACzC;;AAI3B,OAAK,KAAK,QAAQ,GAAG,UAAU,SAAS;AAExC,eAAa;AACX,QAAK,KAAK,QAAQ,IAAI,UAAU,SAAS;;;CAI7C,kBACE,YACA,SACA,SACY;EACZ,MAAM,gBAAgB,KAAK,iBAAiB,WAAW;EACvD,MAAM,WAAW,SAAS,OAAO,gBAAwB;AACvD,OAAI,UAAU,eAAe,YAAY,CAEvC,SADkB,MAAM,KAAK,cAAc,WAAW,CACpC;KAEnB,SAAS,YAAY,IAAI;AAC5B,OAAK,KAAK,QAAQ,GAAG,UAAU,SAAS;AAExC,eAAa;AACX,QAAK,KAAK,QAAQ,IAAI,UAAU,SAAS;;;CAI7C,mBACE,YACA,SACA,SACY;EACZ,MAAM,iBAAiB,KAAK,kBAAkB,WAAW;EACzD,MAAM,WAAW,OAAO,gBAAwB;AAC9C,OAAI,UAAU,gBAAgB,YAAY,CAExC,SADmB,MAAM,KAAK,eAAe,WAAW,CACrC;;AAGvB,OAAK,KAAK,QAAQ,GAAG,UAAU,SAAS;AAExC,eAAa;AACX,QAAK,KAAK,QAAQ,IAAI,UAAU,SAAS;;;;AAK/C,eAAsB,gBAAgB,MAAc,QAAiB;AAiCnE,QA9Ba,MAAM,aAAa;EAC9B;EACA,YAAY;EACZ;EACA,QAAQ;GAAE,gBAAgB;GAAM,OAAO,EAAE,SAAS,CAAC,YAAY,EAAE;GAAE;EACnE,SAAS;EACT,OAAO,EACL,eAAe,EACb,OAAO,EAAE,EACV,EACF;EACD,SAAS;GACP,eAAe;GACf,OAAO,IAfS,MAAM,YAAY,EAAE,KAAK,MAAM,CAAC,EAgBjC,OAAO,MACrB;GACF;EACD,SAAS,CAGP,cAAc,EACd;GACE,MAAM;GACN,kBAAkB;AAChB,WAAO,EAAE;;GAEZ,CACF;EACF,CAAC","debug_id":"02fc7276-e4d6-5195-b4ce-5791df961225"}
+{"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  customLogger.info = logger.info;\n  customLogger.warn = logger.warn;\n  customLogger.error = logger.error;\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":"e3971ec2-a824-5da6-9a2a-805e72db81bf"}

package/dist/{types-DnHgkahK.d.mts → types-Bz2niABC.d.mts}

@@ -1,11 +1,16 @@
 import { ILogger } from "document-model";
-import { DocumentModelModule } from "@powerhousedao/shared/document-model";
+import { DocumentModelModule, UpgradeManifest } from "@powerhousedao/shared/document-model";
 import { ProcessorFactoryBuilder, SubgraphClass } from "@powerhousedao/reactor-api";
 
 //#region src/packages/types.d.ts
 interface IPackageLoader {
   name: string;
   loadDocumentModels(identifier: string, immediate?: boolean): Promise<DocumentModelModule[]>;
+  /**
+   * Loads the upgrade manifests a package exports alongside its document
+   * models. Optional: loaders that predate versioned models may omit it.
+   */
+  loadUpgradeManifests?(identifier: string): Promise<UpgradeManifest<readonly number[]>[]>;
   loadSubgraphs(identifier: string, immediate?: boolean): Promise<SubgraphClass[]>;
   loadProcessors(identifier: string, immediate?: boolean): Promise<ProcessorFactoryBuilder | null>;
 }
@@ -19,6 +24,11 @@ interface ISubscribablePackageLoader extends IPackageLoader {
 }
 interface IPackageManager {
   onDocumentModelsChange(handler: (documentModels: Record<string, DocumentModelModule[]>) => void): void;
+  /**
+   * Remove a package from all package maps and emit the change events.
+   * Used when a dynamically installed package is uninstalled.
+   */
+  removePackage(packageName: string): void;
 }
 type IPackageLoaderOptions = {
   logger?: ILogger;
@@ -29,9 +39,10 @@ type IPackageManagerOptions = {
 };
 type PackageManagerResult = {
   documentModels: DocumentModelModule[];
+  upgradeManifests: UpgradeManifest<readonly number[]>[];
   subgraphs: Map<string, SubgraphClass[]>;
   processors: Map<string, ProcessorFactoryBuilder[]>;
 };
 //#endregion
 export { ISubscribablePackageLoader as a, IPackageManagerOptions as i, IPackageLoaderOptions as n, ISubscriptionOptions as o, IPackageManager as r, PackageManagerResult as s, IPackageLoader as t };
-//# sourceMappingURL=types-DnHgkahK.d.mts.map
+//# sourceMappingURL=types-Bz2niABC.d.mts.map

package/dist/types-Bz2niABC.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types-Bz2niABC.d.mts","names":[],"sources":["../src/packages/types.ts"],"mappings":";;;;;UAUiB,cAAA;EACf,IAAA;EACA,kBAAA,CACE,UAAA,UACA,SAAA,aACC,OAAA,CAAQ,mBAAA;EALkB;;;;EAU7B,oBAAA,EACE,UAAA,WACC,OAAA,CAAQ,eAAA;EACX,aAAA,CACE,UAAA,UACA,SAAA,aACC,OAAA,CAAQ,aAAA;EACX,cAAA,CACE,UAAA,UACA,SAAA,aACC,OAAA,CAAQ,uBAAA;AAAA;AAAA,UAGI,oBAAA;EACf,QAAA;AAAA;AAAA,UAGe,0BAAA,SAAmC,cAAA;EAClD,sBAAA,EACE,UAAA,UACA,OAAA,GAAU,cAAA,EAAgB,mBAAA,aAC1B,OAAA,GAAU,oBAAA;EAEZ,iBAAA,EACE,UAAA,UACA,OAAA,GAAU,SAAA,EAAW,aAAA,aACrB,OAAA,GAAU,oBAAA;EAEZ,kBAAA,EACE,UAAA,UACA,OAAA,GAAU,UAAA,EAAY,uBAAA,kBACtB,OAAA,GAAU,oBAAA;AAAA;AAAA,UAIG,eAAA;EACf,sBAAA,CACE,OAAA,GAAU,cAAA,EAAgB,MAAA,SAAe,mBAAA;EArC3C;;;;EA2CA,aAAA,CAAc,WAAA;AAAA;AAAA,KAGJ,qBAAA;EACV,MAAA,GAAS,OAAA;AAAA;AAAA,KAGC,sBAAA;EACV,QAAA;EACA,UAAA;AAAA;AAAA,KAWU,oBAAA;EACV,cAAA,EAAgB,mBAAA;EAChB,gBAAA,EAAkB,eAAA;EAClB,SAAA,EAAW,GAAA,SAAY,aAAA;EACvB,UAAA,EAAY,GAAA,SAAY,uBAAA;AAAA"}

package/dist/{utils-iibOQ50e.mjs → utils-lHoPB-ft.mjs}

@@ -1,10 +1,11 @@
 
-!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]="bb45ff30-0d48-5614-9063-64b33d486341")}catch(e){}}();
+!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]="be942ef6-aaec-563e-8853-7a72a137c7fc")}catch(e){}}();
 import { gql } from "graphql-tag";
 import { GraphQLError } from "graphql";
-import { DRIVE_AUTH_ERROR_MESSAGES } from "@powerhousedao/reactor";
+import { DRIVE_AUTH_ERROR_MESSAGES, RECOVERABLE_GRAPHQL_ERROR_CODES } from "@powerhousedao/reactor";
 import { childLogger } from "document-model";
 import path from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
 //#region src/graphql/errors.ts
 /** Caller (authenticated or anonymous) lacks permission for the document. */
 var ForbiddenError = class extends GraphQLError {
@@ -20,6 +21,45 @@ var AuthenticationRequiredError = class extends GraphQLError {
 		super(`${base}${detail ? ` ${detail}` : ""}`, { extensions: { code: "UNAUTHENTICATED" } });
 	}
 };
+/**
+* The reactor holds no decision model, so no authorization preflight can be
+* answered.
+*
+* Distinct from a denial, and deliberately so: a caller that cannot get a
+* prediction should render its controls as it did before it asked and let the
+* submit path refuse. Reading this as a denial would disable every control on a
+* switchboard running without authEnforcement. The code is what a client
+* branches on, since the message is not a contract.
+*/
+var AuthEvaluationUnsupportedError = class extends GraphQLError {
+	constructor() {
+		super("Authorization evaluation is unavailable: this reactor runs without the authEnforcement feature flag, so it holds no decision model", { extensions: { code: "AUTH_EVALUATION_UNSUPPORTED" } });
+	}
+};
+/**
+* A stored operation cannot be represented in the schema, so it is reported
+* rather than served.
+*
+* The schema declares an action's id, type, timestamp, input and scope
+* non-null; an operation written before the API rejected an action without an
+* id violates that. Left to the executor, the missing value nullifies the
+* action, which bubbles up through the non-null chain until it nullifies the
+* envelope's whole operation list, and the caller receives a partial response
+* beside "Cannot return null for non-nullable field Action.id" - which says
+* nothing about which operation, and which a sync client can only read as a
+* permanent GraphQL rejection, stopping its poll timer for good.
+*
+* Thrown instead, with a code that says the failure is worth polling through:
+* the document holding the operation needs repairing, but the channel serves
+* every other document, and a peer that stopped polling would stop receiving
+* those too. The code is what a client branches on, since the message is not a
+* contract.
+*/
+var MalformedStoredOperationError = class extends GraphQLError {
+	constructor(detail) {
+		super(`Stored operation cannot be served: ${detail}`, { extensions: { code: RECOVERABLE_GRAPHQL_ERROR_CODES.malformedStoredOperation } });
+	}
+};
 //#endregion
 //#region src/services/authorization.service.ts
 /**
@@ -197,6 +237,36 @@ function createAuthorizationService(config, documentPermissionService, getParent
 	return new DocumentPermissionsAuthorizationService(documentPermissionService, getParentIds, config);
 }
 //#endregion
+//#region src/services/canonical-document-id.ts
+/**
+* Raised when a caller-supplied identifier cannot be resolved to a canonical
+* document id. Carries no detail on purpose: resolution failures must not act
+* as a document-existence oracle, so consumers map this to their generic
+* fail-closed response.
+*/
+var CanonicalDocumentIdResolutionError = class extends Error {
+	constructor() {
+		super("Document identifier could not be resolved");
+		this.name = "CanonicalDocumentIdResolutionError";
+	}
+};
+/**
+* The sanctioned string-to-CanonicalDocumentId cast: both the GraphQL layer
+* and server routes must resolve caller identifiers through this helper so
+* decision and data layers always agree on the subject document.
+*/
+function createCanonicalDocumentIdResolver(client) {
+	return async (identifier) => {
+		let resolved;
+		try {
+			resolved = await client.resolveIdOrSlug(identifier);
+		} catch {
+			throw new CanonicalDocumentIdResolutionError();
+		}
+		return resolved;
+	};
+}
+//#endregion
 //#region src/graphql/base-subgraph.ts
 var BaseSubgraph = class {
 	name = "example";
@@ -213,22 +283,27 @@ var BaseSubgraph = class {
 	syncManager;
 	documentPermissionService;
 	authorizationService;
+	syncServingGate;
 	/**
 	* Per-request memo of raw identifier to canonical document id, keyed on the
 	* request context object so entries are released when the request ends. Lets
 	* batch resolvers resolve each distinct identifier at most once.
 	*/
 	#canonicalIdMemo = /* @__PURE__ */ new WeakMap();
+	#resolveCanonical;
 	constructor(args) {
+		this.#resolveCanonical = createCanonicalDocumentIdResolver(args.reactorClient);
 		this.reactorClient = args.reactorClient;
 		this.graphqlManager = args.graphqlManager;
 		this.relationalDb = args.relationalDb;
 		this.syncManager = args.syncManager;
 		this.documentPermissionService = args.documentPermissionService;
 		this.authorizationService = args.authorizationService;
+		this.syncServingGate = args.syncServingGate;
 		this.path = args.path ?? "";
 	}
 	async onSetup() {}
+	async onDisconnect() {}
 	/**
 	* Resolves a caller-supplied identifier (id or slug) to its canonical
 	* document id, memoized per request. Both the decision layer and the data
@@ -245,13 +320,12 @@ var BaseSubgraph = class {
 		}
 		const cached = cache.get(identifier);
 		if (cached !== void 0) return cached;
-		let resolved;
+		let canonical;
 		try {
-			resolved = await this.reactorClient.resolveIdOrSlug(identifier);
+			canonical = await this.#resolveCanonical(identifier);
 		} catch {
 			throw new ForbiddenError();
 		}
-		const canonical = resolved;
 		cache.set(identifier, canonical);
 		return canonical;
 	}
@@ -285,6 +359,22 @@ var BaseSubgraph = class {
 		return this.authorizationService.canRead(documentId, ctx.user?.address);
 	}
 	/**
+	* The principal a request decides as: the authenticated caller's address, and
+	* the did:key of the app instance whose token authenticated it.
+	*
+	* Both, because a policy can name either. The key is what a document records
+	* as its creator, so a subject built without one cannot match the creator's
+	* standing permission over the auth scope -- the document's own creator would
+	* be refused an operation the write path accepts, since a signed action
+	* carries the same key. Anonymous callers supply neither.
+	*/
+	viewSubject(ctx) {
+		return {
+			address: ctx.user?.address,
+			key: ctx.user?.appKey
+		};
+	}
+	/**
 	* Asserts read access, resolving a slug first. Returns a handle whose
 	* `fetchIdentifier` the caller reuses for the data fetch; a denial throws.
 	*/
@@ -328,6 +418,15 @@ var BaseSubgraph = class {
 //#endregion
 //#region src/packages/import-resolver.ts
 /**
+* Imports a specifier that may be either a bare package specifier or a
+* filesystem path. Absolute paths are converted to file:// URLs, because the
+* ESM loader reads the drive letter in a Windows path as a URL scheme
+* (`import('D:\\...')` fails with ERR_UNSUPPORTED_ESM_URL_SCHEME).
+*/
+async function importSpecifier(target) {
+	return await (path.isAbsolute(target) ? import(pathToFileURL(target).href) : import(target));
+}
+/**
 * Attempts to import from suggested Node.js paths
 */
 async function tryNodeSuggestedPaths(packageName, subPath) {
@@ -338,10 +437,7 @@ async function tryNodeSuggestedPaths(packageName, subPath) {
 		`${packageName}/dist/${subPath}.js`
 	];
 	for (const suggestedPath of suggestedPaths) try {
-		return await import(
-			/* @vite-ignore */
-			suggestedPath
-);
+		return await importSpecifier(suggestedPath);
 	} catch {}
 	return null;
 }
@@ -352,7 +448,7 @@ async function tryImportMetaResolve(packageName, subPath) {
 	try {
 		const resolvedUrl = import.meta.resolve?.(`${packageName}/package.json`);
 		if (!resolvedUrl) return null;
-		const packageRoot = path.dirname(new URL(resolvedUrl).pathname);
+		const packageRoot = path.dirname(fileURLToPath(resolvedUrl));
 		const pathsToTry = [
 			path.join(packageRoot, "dist", "node", subPath, "index.mjs"),
 			path.join(packageRoot, "dist", "node", `${subPath}.mjs`),
@@ -362,10 +458,7 @@ async function tryImportMetaResolve(packageName, subPath) {
 			path.join(packageRoot, `${subPath}.js`)
 		];
 		for (const attemptPath of pathsToTry) try {
-			return await import(
-				/* @vite-ignore */
-				attemptPath
-);
+			return await importSpecifier(attemptPath);
 		} catch {}
 	} catch {}
 	return null;
@@ -401,10 +494,7 @@ function getCommonWorkspacePaths(packageName, subPath) {
 */
 async function tryWorkspacePatterns(patterns) {
 	for (const workspacePath of patterns) try {
-		return await import(
-			/* @vite-ignore */
-			workspacePath
-);
+		return await importSpecifier(workspacePath);
 	} catch {}
 	return null;
 }
@@ -448,20 +538,37 @@ async function loadProcessors(packageName) {
 * Returns null if the dependency cannot be loaded.
 */
 async function loadDependency(packageName, subPath) {
-	const fullPath = `${packageName}/${subPath}`;
+	const fullPath = path.isAbsolute(packageName) ? pathToFileURL(path.join(packageName, subPath)).href : `${packageName}/${subPath}`;
 	try {
 		return await import(
 			/* @vite-ignore */
 			fullPath
 );
 	} catch (e) {
-		if (e instanceof Error && "code" in e && (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "ERR_UNSUPPORTED_DIR_IMPORT")) {
+		if (e instanceof Error && "code" in e && (e.code === "ERR_MODULE_NOT_FOUND" || e.code === "ERR_UNSUPPORTED_DIR_IMPORT" || e.code === "ERR_UNSUPPORTED_ESM_URL_SCHEME")) {
 			const result = await resolveLinkedPackage(packageName, subPath);
 			if (result) return result;
 		}
 		throw e;
 	}
 }
+function isUpgradeManifest(value) {
+	return typeof value === "object" && value !== null && "documentType" in value && "supportedVersions" in value && "upgrades" in value;
+}
+/**
+* Collects upgrade manifests from a package's document-models namespace.
+* Handles both the aggregate `upgradeManifests` array export and individual
+* manifest exports; dedupes by documentType.
+*/
+function extractUpgradeManifests(namespace) {
+	const manifests = /* @__PURE__ */ new Map();
+	const add = (value) => {
+		if (isUpgradeManifest(value)) manifests.set(value.documentType, value);
+	};
+	for (const value of Object.values(namespace)) if (Array.isArray(value)) value.forEach(add);
+	else add(value);
+	return Array.from(manifests.values());
+}
 function debounce(func, delay = 250) {
 	let timer;
 	return (immediate = false, ...args) => {
@@ -537,7 +644,7 @@ function buildGraphQlDriveDocument(doc) {
 	};
 }
 //#endregion
-export { isSubgraphClass as a, loadDocumentModels as c, BaseSubgraph as d, AuthorizationPolicy as f, buildGraphqlOperations as i, loadProcessors as l, createAuthorizationService as m, buildGraphQlDriveDocument as n, debounce as o, AuthorizedDocumentHandle as p, buildGraphqlOperation as r, isSubpath as s, buildGraphQlDocument as t, loadSubgraphs as u };
+export { createAuthorizationService as _, isSubgraphClass as a, MalformedStoredOperationError as b, isSubpath as c, loadSubgraphs as d, BaseSubgraph as f, AuthorizedDocumentHandle as g, AuthorizationPolicy as h, buildGraphqlOperations as i, loadDocumentModels as l, createCanonicalDocumentIdResolver as m, buildGraphQlDriveDocument as n, debounce as o, CanonicalDocumentIdResolutionError as p, buildGraphqlOperation as r, extractUpgradeManifests as s, buildGraphQlDocument as t, loadProcessors as u, AuthEvaluationUnsupportedError as v, ForbiddenError as y };
 
-//# sourceMappingURL=utils-iibOQ50e.mjs.map
-//# debugId=bb45ff30-0d48-5614-9063-64b33d486341
+//# sourceMappingURL=utils-lHoPB-ft.mjs.map
+//# debugId=be942ef6-aaec-563e-8853-7a72a137c7fc