@crvouga/mockingbird-service-rxvortex 1.8.1 → 2.0.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-U5XXCFRO.js";
-import "./chunk-CNQMYSGI.js";
+} from "./chunk-6OVK7IUG.js";
+import "./chunk-MYXNLMD7.js";
 
 // src/cli.ts
 var code = await runCli(

package/dist/index.d.ts

@@ -219,6 +219,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;
@@ -226,6 +235,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
@@ -403,8 +420,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. */
@@ -570,6 +587,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[]): WebhookEndpoint[];
@@ -597,6 +617,8 @@ type ServiceTimelineState = Readonly<{
 }>;
 type ServiceCheckpoint = Checkpoint<ServiceTimelineState>;
 type ServiceRuntime<T extends ServiceInstance> = FetchAPI & {
+    /** Stop package-owned lifecycle timers when a supervisor closes the runtime. */
+    stop?(): void;
     readonly name: string;
     readonly sqlite: SqliteClient$1;
     readonly clock: Clock;
@@ -607,6 +629,13 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI & {
     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. */
@@ -948,6 +977,7 @@ type RxVortexRuntimeOptions = {
     sqlite?: SqliteClient;
     clock?: Clock;
     seed?: number | string;
+    adminPrefix?: string;
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;
     /**
@@ -975,8 +1005,8 @@ type RxVortexRuntime = ServiceRuntime<RxVortexAPI> & {
     stop(): void;
 };
 /**
- * The RxVortex mock with Mockingbird's full service contract: `/health`, `/__admin/*`,
- * namespaces by header, by `/ns/<name>` path prefix, or by client id
+ * The RxVortex mock with Mockingbird's full service contract: `/__admin/health`, `/__admin/*`,
+ * namespaces by header, by `/__admin/ns/<name>` path prefix, or by client id
  * (`PUT /__admin/credentials {"credentials": {"<RXVORTEX_CLIENT_ID>": "<namespace>"}}`),
  * clock control, fault presets, signed status webhooks and a request journal.
  */

package/dist/index.js

@@ -11,7 +11,7 @@ import {
   parseCatalogItem,
   supportedOperationIds,
   tokenCredential
-} from "./chunk-CNQMYSGI.js";
+} from "./chunk-MYXNLMD7.js";
 export {
   CUSTOM_CREAM_ANCHOR_PRESET_ID,
   DEFAULT_CATALOG,

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$1[]): WebhookEndpoint$1[];
@@ -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;
@@ -795,6 +825,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;
@@ -802,6 +841,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
@@ -979,8 +1026,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. */
@@ -1146,6 +1193,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[]): WebhookEndpoint[];
@@ -1173,6 +1223,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;
@@ -1183,6 +1235,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. */
@@ -1393,6 +1452,7 @@ type RxVortexRuntimeOptions = {
     sqlite?: SqliteClient;
     clock?: Clock;
     seed?: number | string;
+    adminPrefix?: string;
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;
     /**

package/dist/server.js

@@ -3,8 +3,8 @@ import {
   createServer,
   loadCatalogFile,
   serveTarget
-} from "./chunk-U5XXCFRO.js";
-import "./chunk-CNQMYSGI.js";
+} from "./chunk-6OVK7IUG.js";
+import "./chunk-MYXNLMD7.js";
 export {
   DEFAULT_PORT,
   createServer,