@substrat-run/vertical-host 0.134.0 → 0.136.0

package/dist/routed-node.js

@@ -0,0 +1,10 @@
+/**
+ * Reading the node the router asserted (K-26, #1978).
+ *
+ * Moving here from the kernel: every vertical reads it, and nothing in it needs a kernel
+ * guarantee. For one release the definition still lives in `@substrat-run/kernel` and this
+ * module re-exports that same binding, so an import from either package is the one
+ * function. Import it from here.
+ */
+export { readRoutedNode, RouterAssertionError } from '@substrat-run/kernel';
+//# sourceMappingURL=routed-node.js.map

package/dist/routed-node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routed-node.js","sourceRoot":"","sources":["../src/routed-node.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/scope-sweep-host.d.ts

@@ -0,0 +1,46 @@
+/**
+ * The handoff between a vertical's bundle and the scope sweeper the platform supplies (#1902).
+ *
+ * A vertical that declares `manifest.schedules` and exports no `defineScopeSweeperDO` class
+ * of its own is given one at upload: the uploader adds the class, its `SWEEPER` binding and
+ * its migration. That class is the platform's code, prebuilt, and it cannot know the one
+ * thing a pass needs — the vertical's own scope host, with the vertical's modules and its
+ * host options (service principals, declared connectors, attachment extractors). A host
+ * rebuilt from the modules alone would drain a declared connector's events as if no
+ * connector were declared, so it has to be the vertical's.
+ *
+ * Every deployed vertical already hands that host to `mountPlatformSurface` as `hostFor`,
+ * so that is where it is registered — on `globalThis` under a GLOBAL symbol, because the
+ * platform's copy of the reader and the vertical-host the vertical bundled are different
+ * module instances that meet only there (the same reason #1893's stamp registry is global).
+ *
+ * The roster is the other half. The platform's sweeper is told which scopes exist by
+ * `mountPlatformSurface` itself, on provision, reconcile and delete-scope — but only when the
+ * upload says it supplied one: the uploader sets `SUBSTRAT_SCOPE_SWEEPER` to the binding's
+ * name. A vertical that brings its own sweeper keeps its own hooks and never sees the var.
+ *
+ * Zero imports on purpose: `tools/platform-entry-emit.mts` bundles this file into the
+ * platform's sweeper module, which is added to every such upload.
+ */
+/** The env var the uploader sets to the binding of the sweeper it supplied (#1902). Contracts'
+ *  `PLATFORM_SWEEPER_VAR`, spelled out because this file imports nothing; control-plane-api's
+ *  `platform-entry.test.ts` holds the two equal. */
+export declare const PLATFORM_SWEEPER_VAR = "SUBSTRAT_SCOPE_SWEEPER";
+/** Builds this deployment's scope host from the worker env — `mountPlatformSurface`'s `hostFor`. */
+export type ScopeSweepHostFactory = (env: never) => unknown;
+/** Record the vertical's host builder for the platform's sweeper. The last call wins. */
+export declare function registerScopeSweepHost(hostFor: ScopeSweepHostFactory): void;
+/** The host builder the vertical registered, or `undefined` when its bundle registers none. */
+export declare function registeredScopeSweepHost(): ScopeSweepHostFactory | undefined;
+/** The slice of a sweeper stub the surface calls. */
+interface RosterStub {
+    noteScope(tenantId: string, scopeId: string): Promise<unknown>;
+    forgetScope(scopeId: string): Promise<unknown>;
+}
+/**
+ * The platform-supplied sweeper's stub, or `undefined` when this upload was given none —
+ * which is every local run, and every vertical that wires its own.
+ */
+export declare function platformSweeperOf(env: object): RosterStub | undefined;
+export {};
+//# sourceMappingURL=scope-sweep-host.d.ts.map

package/dist/scope-sweep-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-sweep-host.d.ts","sourceRoot":"","sources":["../src/scope-sweep-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAIH;;oDAEoD;AACpD,eAAO,MAAM,oBAAoB,2BAA2B,CAAC;AAE7D,oGAAoG;AACpG,MAAM,MAAM,qBAAqB,GAAG,CAAC,GAAG,EAAE,KAAK,KAAK,OAAO,CAAC;AAE5D,yFAAyF;AACzF,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,qBAAqB,GAAG,IAAI,CAE3E;AAED,+FAA+F;AAC/F,wBAAgB,wBAAwB,IAAI,qBAAqB,GAAG,SAAS,CAE5E;AAED,qDAAqD;AACrD,UAAU,UAAU;IAClB,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/D,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAChD;AAUD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,UAAU,GAAG,SAAS,CAWrE"}

package/dist/scope-sweep-host.js

@@ -0,0 +1,55 @@
+/**
+ * The handoff between a vertical's bundle and the scope sweeper the platform supplies (#1902).
+ *
+ * A vertical that declares `manifest.schedules` and exports no `defineScopeSweeperDO` class
+ * of its own is given one at upload: the uploader adds the class, its `SWEEPER` binding and
+ * its migration. That class is the platform's code, prebuilt, and it cannot know the one
+ * thing a pass needs — the vertical's own scope host, with the vertical's modules and its
+ * host options (service principals, declared connectors, attachment extractors). A host
+ * rebuilt from the modules alone would drain a declared connector's events as if no
+ * connector were declared, so it has to be the vertical's.
+ *
+ * Every deployed vertical already hands that host to `mountPlatformSurface` as `hostFor`,
+ * so that is where it is registered — on `globalThis` under a GLOBAL symbol, because the
+ * platform's copy of the reader and the vertical-host the vertical bundled are different
+ * module instances that meet only there (the same reason #1893's stamp registry is global).
+ *
+ * The roster is the other half. The platform's sweeper is told which scopes exist by
+ * `mountPlatformSurface` itself, on provision, reconcile and delete-scope — but only when the
+ * upload says it supplied one: the uploader sets `SUBSTRAT_SCOPE_SWEEPER` to the binding's
+ * name. A vertical that brings its own sweeper keeps its own hooks and never sees the var.
+ *
+ * Zero imports on purpose: `tools/platform-entry-emit.mts` bundles this file into the
+ * platform's sweeper module, which is added to every such upload.
+ */
+const HOSTS = Symbol.for('substrat.scope-sweep-host');
+/** The env var the uploader sets to the binding of the sweeper it supplied (#1902). Contracts'
+ *  `PLATFORM_SWEEPER_VAR`, spelled out because this file imports nothing; control-plane-api's
+ *  `platform-entry.test.ts` holds the two equal. */
+export const PLATFORM_SWEEPER_VAR = 'SUBSTRAT_SCOPE_SWEEPER';
+/** Record the vertical's host builder for the platform's sweeper. The last call wins. */
+export function registerScopeSweepHost(hostFor) {
+    globalThis[HOSTS] = hostFor;
+}
+/** The host builder the vertical registered, or `undefined` when its bundle registers none. */
+export function registeredScopeSweepHost() {
+    return globalThis[HOSTS];
+}
+/** `SCOPE_SWEEPER_NAME` in adapter-cloudflare — the singleton every caller addresses. */
+const SCOPE_SWEEPER_NAME = 'scope-sweeper';
+/**
+ * The platform-supplied sweeper's stub, or `undefined` when this upload was given none —
+ * which is every local run, and every vertical that wires its own.
+ */
+export function platformSweeperOf(env) {
+    const vars = env;
+    const binding = vars[PLATFORM_SWEEPER_VAR];
+    if (typeof binding !== 'string' || !binding)
+        return undefined;
+    const ns = vars[binding];
+    if (!ns || typeof ns.idFromName !== 'function') {
+        throw new Error(`${PLATFORM_SWEEPER_VAR} names the binding '${binding}', but this script has no Durable Object namespace by that name`);
+    }
+    return ns.get(ns.idFromName(SCOPE_SWEEPER_NAME));
+}
+//# sourceMappingURL=scope-sweep-host.js.map

package/dist/scope-sweep-host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scope-sweep-host.js","sourceRoot":"","sources":["../src/scope-sweep-host.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,MAAM,KAAK,GAAG,MAAM,CAAC,GAAG,CAAC,2BAA2B,CAAC,CAAC;AAEtD;;oDAEoD;AACpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,wBAAwB,CAAC;AAK7D,yFAAyF;AACzF,MAAM,UAAU,sBAAsB,CAAC,OAA8B;IAClE,UAA2E,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;AAChG,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,wBAAwB;IACtC,OAAQ,UAA2E,CAAC,KAAK,CAAC,CAAC;AAC7F,CAAC;AAaD,yFAAyF;AACzF,MAAM,kBAAkB,GAAG,eAAe,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,MAAM,IAAI,GAAG,GAA8B,CAAC;IAC5C,MAAM,OAAO,GAAG,IAAI,CAAC,oBAAoB,CAAC,CAAC;IAC3C,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,OAAO;QAAE,OAAO,SAAS,CAAC;IAC9D,MAAM,EAAE,GAAG,IAAI,CAAC,OAAO,CAA0B,CAAC;IAClD,IAAI,CAAC,EAAE,IAAI,OAAO,EAAE,CAAC,UAAU,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CACb,GAAG,oBAAoB,uBAAuB,OAAO,iEAAiE,CACvH,CAAC;IACJ,CAAC;IACD,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,UAAU,CAAC,kBAAkB,CAAC,CAAe,CAAC;AACjE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@substrat-run/vertical-host",
-  "version": "0.134.0",
+  "version": "0.136.0",
   "description": "The platform's /internal/* surface + error envelope, authored once — mount it in a vertical worker instead of re-copying the control-plane contract",
   "license": "AGPL-3.0-only",
   "repository": {
@@ -29,15 +29,15 @@
     "ai": "7.0.114",
     "hono": "^4.13.9",
     "workers-ai-provider": "^4.0.0",
-    "@substrat-run/kernel": "^0.134.0",
-    "@substrat-run/model-providers": "^0.5.24",
-    "@substrat-run/contracts": "^0.134.0"
+    "@substrat-run/kernel": "^0.136.0",
+    "@substrat-run/contracts": "^0.136.0",
+    "@substrat-run/model-providers": "^0.5.26"
   },
   "devDependencies": {
     "typescript": "^7.0.0",
     "vitest": "^3.2.7",
-    "@substrat-run/contract-tests": "^0.134.0",
-    "@substrat-run/adapter-sqlite": "^0.134.0"
+    "@substrat-run/contract-tests": "^0.136.0",
+    "@substrat-run/adapter-sqlite": "^0.136.0"
   },
   "publishConfig": {
     "access": "public"