@crvouga/mockingbird-service-junction 1.8.2 → 2.0.0

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-4QHCRJO4.js";
+} from "./chunk-7LPCTLIJ.js";
 import {
   DEFAULT_JUNCTION_BASE_URL,
   createRuntime,
@@ -12,7 +12,7 @@ import {
   isSandboxKey,
   pullCorpus,
   verifyAgainstReal
-} from "./chunk-ADSZBAJZ.js";
+} from "./chunk-FZVFIPML.js";
 import {
   defaultCorpus
 } from "./chunk-C2UGIPPM.js";

package/dist/index.d.ts

@@ -154,6 +154,15 @@ type FaultCandidate = {
     namespace: string;
 };
 type FaultRegistry = {
+    isolateNamespaces(): void;
+    snapshot(namespace: string): {
+        rules: (FaultRule & {
+            remaining: number | null;
+            hits: number;
+            position: number;
+        })[];
+        rngState: number;
+    };
     add(rule: FaultRule): FaultRule;
     list(): (FaultRule & {
         remaining: number | null;
@@ -161,6 +170,14 @@ type FaultRegistry = {
     })[];
     remove(id: string): boolean;
     clear(): void;
+    restore(namespace: string, state: {
+        rules: (FaultRule & {
+            remaining: number | null;
+            hits: number;
+            position: number;
+        })[];
+        rngState: number;
+    }): void;
     /**
      * Every fault this request should get, in rule order, stopping at the first that answers
      * or drops (effect-only and delay-only rules let later rules match too). Consumes one of
@@ -338,8 +355,8 @@ type MetricsReport = {
 };
 type Metrics = {
     record(entry: RequestLog): void;
-    report(): MetricsReport;
-    reset(): void;
+    report(namespace?: string): MetricsReport;
+    reset(namespace?: string): void;
 };
 
 /** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
@@ -493,6 +510,9 @@ type PublishInput = {
     id?: string;
 };
 type WebhookHub = {
+    pending(namespace: string): number;
+    snapshot(namespace: string): unknown;
+    restore(namespace: string, snapshot: unknown): void;
     publish(input: PublishInput): WebhookMessage;
     /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
     setEndpoints(namespace: string, endpoints: WebhookEndpoint$1[]): WebhookEndpoint$1[];
@@ -520,6 +540,8 @@ type ServiceTimelineState = Readonly<{
 }>;
 type ServiceCheckpoint = Checkpoint<ServiceTimelineState>;
 type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
+    /** Stop package-owned lifecycle timers when a supervisor closes the runtime. */
+    stop?(): void;
     readonly name: string;
     readonly sqlite: SqliteClient$1;
     readonly clock: Clock;
@@ -530,6 +552,13 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     readonly credentials: CredentialRegistry;
     /** The webhook hub, when the service has outbound webhooks. */
     readonly webhooks: WebhookHub | undefined;
+    /** Enable independent namespace clocks and PRNGs before serving a fleet. */
+    isolateNamespaces(): void;
+    namespaceClock(namespace?: string): Clock;
+    namespaceOf(request: Request): string;
+    /** Opaque in-process checkpoint including records, controls and webhook history. */
+    fleetSnapshot(namespace: string): object;
+    fleetRestore(snapshot: unknown, namespace: string): void;
     /** 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. */
@@ -1516,6 +1545,8 @@ type JunctionRuntimeOptions = {
     clock?: Clock;
     /** Seeds fault rates and webhook retry jitter. */
     seed?: number | string;
+    /** Prefix for all internal HTTP paths. Default /__admin. */
+    adminPrefix?: string;
     /** Require `x-mockingbird-admin-key` on `/__admin/*`. */
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;
@@ -1526,7 +1557,7 @@ type JunctionRuntime = ServiceRuntime<JunctionAPI> & {
 };
 /**
  * The Junction mock with Mockingbird's full service contract: unauthenticated
- * `/health`, the `/__admin/*` control plane, per-request namespaces
+ * `/__admin/health`, the `/__admin/*` control plane, per-request namespaces
  * (`x-mockingbird-namespace`), clock control, fault injection and request metrics.
  * Runtime-neutral: serve it with any Fetch-native server, or use `./server` for Node.
  */
@@ -1644,7 +1675,7 @@ type JunctionAPIOptions = APIOptions & {
     /** Users and orders to load into every namespace, re-applied on every `reset()`. */
     fixtures?: JunctionFixtures;
 };
-/** What a loaded corpus covers, for `/health` and startup logs. */
+/** What a loaded corpus covers, for `/__admin/health` and startup logs. */
 type CorpusInfo = {
     label: string;
     recordedAt: string;

package/dist/index.js

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

package/dist/server.d.ts

@@ -155,6 +155,15 @@ type FaultCandidate$1 = {
     namespace: string;
 };
 type FaultRegistry$1 = {
+    isolateNamespaces(): void;
+    snapshot(namespace: string): {
+        rules: (FaultRule$1 & {
+            remaining: number | null;
+            hits: number;
+            position: number;
+        })[];
+        rngState: number;
+    };
     add(rule: FaultRule$1): FaultRule$1;
     list(): (FaultRule$1 & {
         remaining: number | null;
@@ -162,6 +171,14 @@ type FaultRegistry$1 = {
     })[];
     remove(id: string): boolean;
     clear(): void;
+    restore(namespace: string, state: {
+        rules: (FaultRule$1 & {
+            remaining: number | null;
+            hits: number;
+            position: number;
+        })[];
+        rngState: number;
+    }): void;
     /**
      * Every fault this request should get, in rule order, stopping at the first that answers
      * or drops (effect-only and delay-only rules let later rules match too). Consumes one of
@@ -326,8 +343,8 @@ type MetricsReport$1 = {
 };
 type Metrics$1 = {
     record(entry: RequestLog$1): void;
-    report(): MetricsReport$1;
-    reset(): void;
+    report(namespace?: string): MetricsReport$1;
+    reset(namespace?: string): void;
 };
 
 /** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
@@ -481,6 +498,9 @@ type PublishInput$1 = {
     id?: string;
 };
 type WebhookHub$1 = {
+    pending(namespace: string): number;
+    snapshot(namespace: string): unknown;
+    restore(namespace: string, snapshot: unknown): void;
     publish(input: PublishInput$1): WebhookMessage$1;
     /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
     setEndpoints(namespace: string, endpoints: WebhookEndpoint$2[]): WebhookEndpoint$2[];
@@ -508,6 +528,8 @@ type ServiceTimelineState$1 = Readonly<{
 }>;
 type ServiceCheckpoint$1 = Checkpoint$1<ServiceTimelineState$1>;
 type ServiceRuntime$1<T extends ServiceInstance$1> = FetchAPI$2 & {
+    /** Stop package-owned lifecycle timers when a supervisor closes the runtime. */
+    stop?(): void;
     readonly name: string;
     readonly sqlite: SqliteClient$2;
     readonly clock: Clock$1;
@@ -518,6 +540,13 @@ type ServiceRuntime$1<T extends ServiceInstance$1> = FetchAPI$2 & {
     readonly credentials: CredentialRegistry$1;
     /** The webhook hub, when the service has outbound webhooks. */
     readonly webhooks: WebhookHub$1 | undefined;
+    /** Enable independent namespace clocks and PRNGs before serving a fleet. */
+    isolateNamespaces(): void;
+    namespaceClock(namespace?: string): Clock$1;
+    namespaceOf(request: Request): string;
+    /** Opaque in-process checkpoint including records, controls and webhook history. */
+    fleetSnapshot(namespace: string): object;
+    fleetRestore(snapshot: unknown, namespace: string): void;
     /** 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. */
@@ -564,6 +593,7 @@ type CliOption = {
 };
 type CliValues = Record<string, string | boolean | undefined>;
 type CommonServeOptions = {
+    adminPrefix?: string;
     adminKey: string | undefined;
     seed: string | undefined;
     onLog: ((entry: RequestLog$1) => void) | undefined;
@@ -739,6 +769,15 @@ type FaultCandidate = {
     namespace: string;
 };
 type FaultRegistry = {
+    isolateNamespaces(): void;
+    snapshot(namespace: string): {
+        rules: (FaultRule & {
+            remaining: number | null;
+            hits: number;
+            position: number;
+        })[];
+        rngState: number;
+    };
     add(rule: FaultRule): FaultRule;
     list(): (FaultRule & {
         remaining: number | null;
@@ -746,6 +785,14 @@ type FaultRegistry = {
     })[];
     remove(id: string): boolean;
     clear(): void;
+    restore(namespace: string, state: {
+        rules: (FaultRule & {
+            remaining: number | null;
+            hits: number;
+            position: number;
+        })[];
+        rngState: number;
+    }): void;
     /**
      * Every fault this request should get, in rule order, stopping at the first that answers
      * or drops (effect-only and delay-only rules let later rules match too). Consumes one of
@@ -923,8 +970,8 @@ type MetricsReport = {
 };
 type Metrics = {
     record(entry: RequestLog): void;
-    report(): MetricsReport;
-    reset(): void;
+    report(namespace?: string): MetricsReport;
+    reset(namespace?: string): void;
 };
 
 /** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
@@ -1078,6 +1125,9 @@ type PublishInput = {
     id?: string;
 };
 type WebhookHub = {
+    pending(namespace: string): number;
+    snapshot(namespace: string): unknown;
+    restore(namespace: string, snapshot: unknown): void;
     publish(input: PublishInput): WebhookMessage;
     /** Replace a namespace's own endpoints (`PUT /__admin/webhook-endpoints`). */
     setEndpoints(namespace: string, endpoints: WebhookEndpoint$1[]): WebhookEndpoint$1[];
@@ -1105,6 +1155,8 @@ type ServiceTimelineState = Readonly<{
 }>;
 type ServiceCheckpoint = Checkpoint<ServiceTimelineState>;
 type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
+    /** Stop package-owned lifecycle timers when a supervisor closes the runtime. */
+    stop?(): void;
     readonly name: string;
     readonly sqlite: SqliteClient$1;
     readonly clock: Clock;
@@ -1115,6 +1167,13 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     readonly credentials: CredentialRegistry;
     /** The webhook hub, when the service has outbound webhooks. */
     readonly webhooks: WebhookHub | undefined;
+    /** Enable independent namespace clocks and PRNGs before serving a fleet. */
+    isolateNamespaces(): void;
+    namespaceClock(namespace?: string): Clock;
+    namespaceOf(request: Request): string;
+    /** Opaque in-process checkpoint including records, controls and webhook history. */
+    fleetSnapshot(namespace: string): object;
+    fleetRestore(snapshot: unknown, namespace: string): void;
     /** 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. */
@@ -1650,7 +1709,7 @@ type JunctionAPIOptions = APIOptions & {
     /** Users and orders to load into every namespace, re-applied on every `reset()`. */
     fixtures?: JunctionFixtures;
 };
-/** What a loaded corpus covers, for `/health` and startup logs. */
+/** What a loaded corpus covers, for `/__admin/health` and startup logs. */
 type CorpusInfo = {
     label: string;
     recordedAt: string;
@@ -1789,6 +1848,8 @@ type JunctionRuntimeOptions = {
     clock?: Clock;
     /** Seeds fault rates and webhook retry jitter. */
     seed?: number | string;
+    /** Prefix for all internal HTTP paths. Default /__admin. */
+    adminPrefix?: string;
     /** Require `x-mockingbird-admin-key` on `/__admin/*`. */
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;

package/dist/server.js

@@ -3,8 +3,8 @@ import {
   createServer,
   loadCorpus,
   serveTarget
-} from "./chunk-4QHCRJO4.js";
-import "./chunk-ADSZBAJZ.js";
+} from "./chunk-7LPCTLIJ.js";
+import "./chunk-FZVFIPML.js";
 import "./chunk-C2UGIPPM.js";
 import "./chunk-ISDNA2TU.js";
 export {