@crvouga/mockingbird-service-fullscript 1.7.1 → 2.0.0

package/dist/cli.js

@@ -3,8 +3,8 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-DI3IPCT2.js";
-import "./chunk-VPJ64KU3.js";
+} from "./chunk-EZGGE5JC.js";
+import "./chunk-R7LD4QOX.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. */
@@ -558,6 +575,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[];
@@ -585,6 +605,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;
@@ -595,6 +617,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. */
@@ -947,6 +976,7 @@ type FullscriptRuntimeOptions = {
     sqlite?: SqliteClient;
     clock?: Clock;
     seed?: number | string;
+    adminPrefix?: string;
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;
     settings?: Partial<Settings>;
@@ -966,8 +996,8 @@ type FullscriptRuntime = ServiceRuntime<FullscriptAPI> & {
     readonly webhooks: WebhookHub;
 };
 /**
- * The Fullscript mock with Mockingbird's full service contract: `/health`, `/__admin/*`,
- * namespaces by header, by `/ns/<name>` path prefix on FULLSCRIPT_API_URL, or by OAuth client
+ * The Fullscript mock with Mockingbird's full service contract: `/__admin/health`, `/__admin/*`,
+ * namespaces by header, by `/__admin/ns/<name>` path prefix on FULLSCRIPT_API_URL, or by OAuth client
  * (for API calls), clock control, fault presets, signed webhooks and a request journal.
  */
 declare const createRuntime: (options?: FullscriptRuntimeOptions) => FullscriptRuntime;
@@ -1001,7 +1031,8 @@ type SeedOrder = {
 type FullscriptAPIOptions = APIOptions & {
     settings?: Partial<Settings>;
     orders?: readonly SeedOrder[];
-    /** The public namespace, so result PDF URLs carry a `/ns/<name>` prefix. */
+    /** The public namespace, so result PDF URLs carry a `/__admin/ns/<name>` prefix. */
+    adminPrefix?: string;
     publicNamespace?: string;
     /** Called for every event; the runtime signs and delivers it. */
     onEvent?: (event: EventRecord) => void;

package/dist/index.js

@@ -18,7 +18,7 @@ import {
   publicEvent,
   supportedOperationIds,
   tokenCredential
-} from "./chunk-VPJ64KU3.js";
+} from "./chunk-R7LD4QOX.js";
 export {
   DEFAULT_CLINIC,
   DEFAULT_PRACTITIONER,

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;
@@ -781,6 +811,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;
@@ -788,6 +827,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
@@ -965,8 +1012,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. */
@@ -1120,6 +1167,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[];
@@ -1147,6 +1197,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;
@@ -1157,6 +1209,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. */
@@ -1345,7 +1404,8 @@ type SeedOrder = {
 type FullscriptAPIOptions = APIOptions & {
     settings?: Partial<Settings>;
     orders?: readonly SeedOrder[];
-    /** The public namespace, so result PDF URLs carry a `/ns/<name>` prefix. */
+    /** The public namespace, so result PDF URLs carry a `/__admin/ns/<name>` prefix. */
+    adminPrefix?: string;
     publicNamespace?: string;
     /** Called for every event; the runtime signs and delivers it. */
     onEvent?: (event: EventRecord) => void;
@@ -1402,6 +1462,7 @@ type FullscriptRuntimeOptions = {
     sqlite?: SqliteClient;
     clock?: Clock;
     seed?: number | string;
+    adminPrefix?: string;
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;
     settings?: Partial<Settings>;

package/dist/server.js

@@ -2,8 +2,8 @@ import {
   DEFAULT_PORT,
   createServer,
   serveTarget
-} from "./chunk-DI3IPCT2.js";
-import "./chunk-VPJ64KU3.js";
+} from "./chunk-EZGGE5JC.js";
+import "./chunk-R7LD4QOX.js";
 export {
   DEFAULT_PORT,
   createServer,