@crvouga/mockingbird-service-junction 3.3.1 → 3.4.0

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-S2GN6HLD.js";
+} from "./chunk-ZTMQ5RIL.js";
 import {
   DEFAULT_JUNCTION_BASE_URL,
   createRuntime,
@@ -12,7 +12,7 @@ import {
   isSandboxKey,
   pullCorpus,
   verifyAgainstReal
-} from "./chunk-7VCGZYMN.js";
+} from "./chunk-SN6QTJKH.js";
 import {
   defaultCorpus
 } from "./chunk-2FZJPMTR.js";

package/dist/index.d.ts

@@ -457,6 +457,8 @@ type SnapshotDocument = {
     faults?: unknown;
     latency?: unknown;
     virtualTime?: boolean;
+    /** Quiescent webhook endpoints, delivery history and fault state. Contains private configuration. */
+    webhooks?: unknown;
 };
 /** Controls for one namespace. */
 type NamespaceControls = {
@@ -670,6 +672,8 @@ type CredentialRegistry = {
     }[];
 };
 
+type OwnedTransport = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
+
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -787,8 +791,16 @@ type PublishInput = {
     id?: string;
 };
 type WebhookHub = {
+    observeDeliveries(listener: (event: {
+        namespace: string;
+        state: string;
+        deliveryId: string;
+    }) => void): () => void;
+    setTransportPolicy(policy: OwnedTransport): void;
     pending(namespace: string): number;
     snapshot(namespace: string): unknown;
+    exportSnapshot(handle: unknown): unknown;
+    importSnapshot(namespace: string, document: unknown): unknown;
     restore(namespace: string, snapshot: unknown): void;
     publish(input: PublishInput): WebhookMessage;
     /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
@@ -801,7 +813,7 @@ type WebhookHub = {
     /** Run every pending retry (and release held reordered messages) now, and every retry those attempts schedule, until nothing is pending. */
     flush(): Promise<void>;
     /** Resolve once nothing is in flight. */
-    idle(): Promise<void>;
+    idle(namespace?: string): Promise<void>;
     fault(namespace: string, fault: WebhookFault): void;
     clear(namespace?: string): void;
 };
@@ -845,6 +857,8 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     /** Opaque in-process checkpoint including records, controls and webhook history. */
     fleetSnapshot(namespace: string): object;
     fleetRestore(snapshot: unknown, namespace: string): void;
+    fleetExport(snapshot: unknown): SnapshotDocument;
+    fleetImport(namespace: string, document: unknown): object;
     /** Expand a named preset into fault rules (and webhook faults) for `namespace`. */
     applyPreset(name: string, namespace?: string, overrides?: Partial<FaultRule>): FaultRule[];
     /** The instance behind `namespace` (the default one when omitted), created on first use. */

package/dist/index.js

@@ -53,7 +53,7 @@ import {
   supportedOperationIds,
   verifyAgainstReal,
   verifySvix
-} from "./chunk-7VCGZYMN.js";
+} from "./chunk-SN6QTJKH.js";
 import {
   SEALED_CORPUS_VERSION,
   SUPPORTED_SEALED_CORPUS_VERSIONS,

package/dist/server.d.ts

@@ -445,6 +445,8 @@ type SnapshotDocument$1 = {
     faults?: unknown;
     latency?: unknown;
     virtualTime?: boolean;
+    /** Quiescent webhook endpoints, delivery history and fault state. Contains private configuration. */
+    webhooks?: unknown;
 };
 /** Controls for one namespace. */
 type NamespaceControls$1 = {
@@ -658,6 +660,8 @@ type CredentialRegistry$1 = {
     }[];
 };
 
+type OwnedTransport$1 = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
+
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -775,8 +779,16 @@ type PublishInput$1 = {
     id?: string;
 };
 type WebhookHub$1 = {
+    observeDeliveries(listener: (event: {
+        namespace: string;
+        state: string;
+        deliveryId: string;
+    }) => void): () => void;
+    setTransportPolicy(policy: OwnedTransport$1): void;
     pending(namespace: string): number;
     snapshot(namespace: string): unknown;
+    exportSnapshot(handle: unknown): unknown;
+    importSnapshot(namespace: string, document: unknown): unknown;
     restore(namespace: string, snapshot: unknown): void;
     publish(input: PublishInput$1): WebhookMessage$1;
     /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
@@ -789,7 +801,7 @@ type WebhookHub$1 = {
     /** Run every pending retry (and release held reordered messages) now, and every retry those attempts schedule, until nothing is pending. */
     flush(): Promise<void>;
     /** Resolve once nothing is in flight. */
-    idle(): Promise<void>;
+    idle(namespace?: string): Promise<void>;
     fault(namespace: string, fault: WebhookFault$1): void;
     clear(namespace?: string): void;
 };
@@ -833,6 +845,8 @@ type ServiceRuntime$1<T extends ServiceInstance$1> = FetchAPI$2 & {
     /** Opaque in-process checkpoint including records, controls and webhook history. */
     fleetSnapshot(namespace: string): object;
     fleetRestore(snapshot: unknown, namespace: string): void;
+    fleetExport(snapshot: unknown): SnapshotDocument$1;
+    fleetImport(namespace: string, document: unknown): object;
     /** Expand a named preset into fault rules (and webhook faults) for `namespace`. */
     applyPreset(name: string, namespace?: string, overrides?: Partial<FaultRule$1>): FaultRule$1[];
     /** The instance behind `namespace` (the default one when omitted), created on first use. */
@@ -925,6 +939,7 @@ type CommonServeOptions = {
  * `serveTarget`, which is also how `serve --config` finds services by name.
  */
 type ServeTarget = {
+    packageVersion?: string;
     name: string;
     defaultPort: number;
     /** Serve flags beyond the common ones. */
@@ -1393,6 +1408,8 @@ type SnapshotDocument = {
     faults?: unknown;
     latency?: unknown;
     virtualTime?: boolean;
+    /** Quiescent webhook endpoints, delivery history and fault state. Contains private configuration. */
+    webhooks?: unknown;
 };
 /** Controls for one namespace. */
 type NamespaceControls = {
@@ -1606,6 +1623,8 @@ type CredentialRegistry = {
     }[];
 };
 
+type OwnedTransport = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
+
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -1723,8 +1742,16 @@ type PublishInput = {
     id?: string;
 };
 type WebhookHub = {
+    observeDeliveries(listener: (event: {
+        namespace: string;
+        state: string;
+        deliveryId: string;
+    }) => void): () => void;
+    setTransportPolicy(policy: OwnedTransport): void;
     pending(namespace: string): number;
     snapshot(namespace: string): unknown;
+    exportSnapshot(handle: unknown): unknown;
+    importSnapshot(namespace: string, document: unknown): unknown;
     restore(namespace: string, snapshot: unknown): void;
     publish(input: PublishInput): WebhookMessage;
     /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
@@ -1737,7 +1764,7 @@ type WebhookHub = {
     /** Run every pending retry (and release held reordered messages) now, and every retry those attempts schedule, until nothing is pending. */
     flush(): Promise<void>;
     /** Resolve once nothing is in flight. */
-    idle(): Promise<void>;
+    idle(namespace?: string): Promise<void>;
     fault(namespace: string, fault: WebhookFault): void;
     clear(namespace?: string): void;
 };
@@ -1781,6 +1808,8 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     /** Opaque in-process checkpoint including records, controls and webhook history. */
     fleetSnapshot(namespace: string): object;
     fleetRestore(snapshot: unknown, namespace: string): void;
+    fleetExport(snapshot: unknown): SnapshotDocument;
+    fleetImport(namespace: string, document: unknown): object;
     /** Expand a named preset into fault rules (and webhook faults) for `namespace`. */
     applyPreset(name: string, namespace?: string, overrides?: Partial<FaultRule>): FaultRule[];
     /** The instance behind `namespace` (the default one when omitted), created on first use. */

package/dist/server.js

@@ -3,8 +3,8 @@ import {
   createServer,
   loadCorpus,
   serveTarget
-} from "./chunk-S2GN6HLD.js";
-import "./chunk-7VCGZYMN.js";
+} from "./chunk-ZTMQ5RIL.js";
+import "./chunk-SN6QTJKH.js";
 import "./chunk-2FZJPMTR.js";
 import "./chunk-ISDNA2TU.js";
 export {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-junction",
-  "version": "3.3.1",
+  "version": "3.4.0",
   "description": "Stateful emulator of the Junction (Vital) user API driven by its OpenAPI contract and verified by differential property tests against the Junction sandbox.",
   "license": "MIT",
   "type": "module",