@nanobpm/urban 0.61.0 → 0.62.0

package/dist/runtime/core/host.d.ts

@@ -336,3 +336,18 @@ export interface EngineClient {
     /** Tear down all connections. */
     close(): Promise<void>;
 }
+/**
+ * The names of every method on {@link EngineClient} — the single *runtime* source of
+ * truth for the interface's surface. It is compile-time-pinned to `keyof EngineClient`
+ * in both directions (see the two assertions below): the `satisfies` rejects a stray or
+ * misspelled name, and the exhaustiveness assertion rejects an *omitted* one, so adding,
+ * renaming, or removing an `EngineClient` method that this list does not mirror fails
+ * `npm run typecheck`.
+ *
+ * A fake/adapter (e.g. `@nanobpm/urban-testkit`'s `WasmEngineClient`) can iterate this
+ * list to assert at *runtime* that it implements the full surface — catching the
+ * "the SDK grew a method the test double lags" seam-lag class (issue #341: `openUserTasks`,
+ * and `getForm` before it) that a purely structural `implements EngineClient` check no
+ * longer catches once the fake is published/compiled against an older `@nanobpm/urban`.
+ */
+export declare const ENGINE_CLIENT_METHODS: readonly ["deployResources", "createInstance", "cancelInstance", "publishMessage", "searchUserTasks", "openUserTasks", "getForm", "completeUserTask", "searchProcessInstances", "registerWorker", "close"];

package/dist/runtime/core/host.js

@@ -42,3 +42,31 @@ export function presentFormIdentifier(value) {
     const trimmed = value?.trim();
     return trimmed ? trimmed : undefined;
 }
+/**
+ * The names of every method on {@link EngineClient} — the single *runtime* source of
+ * truth for the interface's surface. It is compile-time-pinned to `keyof EngineClient`
+ * in both directions (see the two assertions below): the `satisfies` rejects a stray or
+ * misspelled name, and the exhaustiveness assertion rejects an *omitted* one, so adding,
+ * renaming, or removing an `EngineClient` method that this list does not mirror fails
+ * `npm run typecheck`.
+ *
+ * A fake/adapter (e.g. `@nanobpm/urban-testkit`'s `WasmEngineClient`) can iterate this
+ * list to assert at *runtime* that it implements the full surface — catching the
+ * "the SDK grew a method the test double lags" seam-lag class (issue #341: `openUserTasks`,
+ * and `getForm` before it) that a purely structural `implements EngineClient` check no
+ * longer catches once the fake is published/compiled against an older `@nanobpm/urban`.
+ */
+export const ENGINE_CLIENT_METHODS = [
+    "deployResources",
+    "createInstance",
+    "cancelInstance",
+    "publishMessage",
+    "searchUserTasks",
+    "openUserTasks",
+    "getForm",
+    "completeUserTask",
+    "searchProcessInstances",
+    "registerWorker",
+    "close",
+];
+const _engineClientMethodsAreExhaustive = true;

package/dist/runtime/index.d.ts

@@ -14,6 +14,7 @@ export type { AppApi, Mounted, RuntimeContext } from "./core/context.ts";
 export { createLogger } from "./core/logger.ts";
 export type { Logger, LogLevel, LogFields, LogSink } from "./core/logger.ts";
 export { BpmnError, isBpmnError } from "./core/host.ts";
+export { ENGINE_CLIENT_METHODS } from "./core/host.ts";
 export { adaptConnectorHandler, mountConnectors, resolveInstalledConnectors, } from "./core/modules/connectors.ts";
 export type { ConnectorsHandle } from "./core/modules/connectors.ts";
 export { DataLayer, TypeRepo } from "./core/modules/datasource.ts";

package/dist/runtime/index.js

@@ -18,6 +18,10 @@ export { createLogger } from "./core/logger.js";
 // BPMN error contract: a handler throws `BpmnError(code)` to raise a modelled
 // error routed to an error boundary (ADR 0050), instead of a retryable failure.
 export { BpmnError, isBpmnError } from "./core/host.js";
+// The runtime source of truth for the `EngineClient` method surface (issue #341): a test
+// double / adapter iterates it to prove at runtime that it implements the full interface,
+// catching the "fake lags the SDK" seam-lag class categorically.
+export { ENGINE_CLIENT_METHODS } from "./core/host.js";
 // Connector packs (ADR 0050, in-process port)
 export { adaptConnectorHandler, mountConnectors, resolveInstalledConnectors, } from "./core/modules/connectors.js";
 // Data layer

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nanobpm/urban",
-	"version": "0.61.0",
+	"version": "0.62.0",
 	"description": "Urban: build and run code-first apps on Nano — runtime, derivation toolkit, and CLI in one. Author durable processes with @nanobpm/workflow (defineFlow), a typed datasource, forms, triggers and surfaces from a nano.app.json manifest, on Node or Deno.",
 	"license": "Apache-2.0",
 	"type": "module",

package/src/runtime/core/host.ts

@@ -359,3 +359,39 @@ export interface EngineClient {
   /** Tear down all connections. */
   close(): Promise<void>;
 }
+
+/**
+ * The names of every method on {@link EngineClient} — the single *runtime* source of
+ * truth for the interface's surface. It is compile-time-pinned to `keyof EngineClient`
+ * in both directions (see the two assertions below): the `satisfies` rejects a stray or
+ * misspelled name, and the exhaustiveness assertion rejects an *omitted* one, so adding,
+ * renaming, or removing an `EngineClient` method that this list does not mirror fails
+ * `npm run typecheck`.
+ *
+ * A fake/adapter (e.g. `@nanobpm/urban-testkit`'s `WasmEngineClient`) can iterate this
+ * list to assert at *runtime* that it implements the full surface — catching the
+ * "the SDK grew a method the test double lags" seam-lag class (issue #341: `openUserTasks`,
+ * and `getForm` before it) that a purely structural `implements EngineClient` check no
+ * longer catches once the fake is published/compiled against an older `@nanobpm/urban`.
+ */
+export const ENGINE_CLIENT_METHODS = [
+  "deployResources",
+  "createInstance",
+  "cancelInstance",
+  "publishMessage",
+  "searchUserTasks",
+  "openUserTasks",
+  "getForm",
+  "completeUserTask",
+  "searchProcessInstances",
+  "registerWorker",
+  "close",
+] as const satisfies readonly (keyof EngineClient)[];
+
+// Compile-time exhaustiveness: every `EngineClient` method must appear in
+// `ENGINE_CLIENT_METHODS`. If one is omitted, `Exclude<...>` is a non-`never` union of
+// the missing keys, so this type resolves to `never` and the `true` assignment fails to
+// compile — the twin of the `satisfies` above, together pinning the list to
+// `keyof EngineClient` exactly (No Drift Surfaces).
+type MissingEngineClientMethods = Exclude<keyof EngineClient, (typeof ENGINE_CLIENT_METHODS)[number]>;
+const _engineClientMethodsAreExhaustive: [MissingEngineClientMethods] extends [never] ? true : never = true;

package/src/runtime/index.ts

@@ -118,6 +118,10 @@ export type { Logger, LogLevel, LogFields, LogSink } from "./core/logger.ts";
 // BPMN error contract: a handler throws `BpmnError(code)` to raise a modelled
 // error routed to an error boundary (ADR 0050), instead of a retryable failure.
 export { BpmnError, isBpmnError } from "./core/host.ts";
+// The runtime source of truth for the `EngineClient` method surface (issue #341): a test
+// double / adapter iterates it to prove at runtime that it implements the full interface,
+// catching the "fake lags the SDK" seam-lag class categorically.
+export { ENGINE_CLIENT_METHODS } from "./core/host.ts";
 
 // Connector packs (ADR 0050, in-process port)
 export {