@crvouga/mockingbird-service-junction 3.0.0 → 3.2.0

package/dist/cli.js

@@ -4,7 +4,7 @@ import {
   runCli,
   serveCommand,
   serveTarget
-} from "./chunk-XMZYEZ4V.js";
+} from "./chunk-R4LSSE3O.js";
 import {
   DEFAULT_JUNCTION_BASE_URL,
   createRuntime,
@@ -12,7 +12,7 @@ import {
   isSandboxKey,
   pullCorpus,
   verifyAgainstReal
-} from "./chunk-G3BD4D34.js";
+} from "./chunk-WEQDMSPV.js";
 import {
   defaultCorpus
 } from "./chunk-2FZJPMTR.js";

package/dist/index.d.ts

@@ -1,33 +1,15 @@
 import { Hono } from 'hono';
 
-/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
-type SqliteValue$1 = null | number | bigint | string | Uint8Array | boolean;
-/** Mutation counters returned by {@link SqliteStatement.run}. */
-type SqliteRunResult$1 = {
-    changes: number;
-    lastInsertRowid: number | bigint;
+type MountedAPI = FetchAPI$1 & {
+    readonly prefix: string;
+    GET: FetchHandler;
+    POST: FetchHandler;
+    PUT: FetchHandler;
+    PATCH: FetchHandler;
+    DELETE: FetchHandler;
+    HEAD: FetchHandler;
+    OPTIONS: FetchHandler;
 };
-/**
- * Prepared statement bound to a {@link SqliteClient}.
- *
- * Pass bind values as rest arguments on each call (no sticky `bind()`).
- */
-interface SqliteStatement$1 {
-    run(...params: SqliteValue$1[]): SqliteRunResult$1;
-    all<T = Record<string, unknown>>(...params: SqliteValue$1[]): T[];
-    get<T = Record<string, unknown>>(...params: SqliteValue$1[]): T | undefined;
-}
-/**
- * Sync SQLite client port owned by Mockingbird.
- *
- * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
- * `bun:sqlite` instances all work when they expose this surface.
- */
-interface SqliteClient$1 {
-    exec(sql: string): void;
-    prepare(sql: string): SqliteStatement$1;
-    transaction<T>(fn: () => T): T;
-}
 
 /** A stable identifier for a point in a {@link Timeline}. */
 type CheckpointId = string;
@@ -118,6 +100,37 @@ declare class Timeline<T> {
 interface FetchAPI$1 {
     fetch(request: Request): Promise<Response>;
 }
+/** A bare function form of {@link FetchAPI}, compatible with `Bun.serve`, workerd, and Deno. */
+type FetchHandler = (request: Request) => Promise<Response>;
+
+/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
+type SqliteValue$1 = null | number | bigint | string | Uint8Array | boolean;
+/** Mutation counters returned by {@link SqliteStatement.run}. */
+type SqliteRunResult$1 = {
+    changes: number;
+    lastInsertRowid: number | bigint;
+};
+/**
+ * Prepared statement bound to a {@link SqliteClient}.
+ *
+ * Pass bind values as rest arguments on each call (no sticky `bind()`).
+ */
+interface SqliteStatement$1 {
+    run(...params: SqliteValue$1[]): SqliteRunResult$1;
+    all<T = Record<string, unknown>>(...params: SqliteValue$1[]): T[];
+    get<T = Record<string, unknown>>(...params: SqliteValue$1[]): T | undefined;
+}
+/**
+ * Sync SQLite client port owned by Mockingbird.
+ *
+ * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
+ * `bun:sqlite` instances all work when they expose this surface.
+ */
+interface SqliteClient$1 {
+    exec(sql: string): void;
+    prepare(sql: string): SqliteStatement$1;
+    transaction<T>(fn: () => T): T;
+}
 
 /** Options every provider constructor accepts. */
 type APIOptions = {
@@ -547,6 +560,8 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     /** Stop package-owned lifecycle timers when a supervisor closes the runtime. */
     stop?(): void;
     readonly name: string;
+    /** Same-origin Fetch handler and App Router method exports, sharing this runtime. */
+    mount(prefix: string): MountedAPI;
     readonly sqlite: SqliteClient$1;
     readonly clock: Clock;
     readonly faults: FaultRegistry;

package/dist/index.js

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

package/dist/server.d.ts

@@ -1,34 +1,16 @@
 import { Server } from 'node:http';
 import { Hono } from 'hono';
 
-/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
-type SqliteValue$2 = null | number | bigint | string | Uint8Array | boolean;
-/** Mutation counters returned by {@link SqliteStatement.run}. */
-type SqliteRunResult$2 = {
-    changes: number;
-    lastInsertRowid: number | bigint;
+type MountedAPI$1 = FetchAPI$2 & {
+    readonly prefix: string;
+    GET: FetchHandler$1;
+    POST: FetchHandler$1;
+    PUT: FetchHandler$1;
+    PATCH: FetchHandler$1;
+    DELETE: FetchHandler$1;
+    HEAD: FetchHandler$1;
+    OPTIONS: FetchHandler$1;
 };
-/**
- * Prepared statement bound to a {@link SqliteClient}.
- *
- * Pass bind values as rest arguments on each call (no sticky `bind()`).
- */
-interface SqliteStatement$2 {
-    run(...params: SqliteValue$2[]): SqliteRunResult$2;
-    all<T = Record<string, unknown>>(...params: SqliteValue$2[]): T[];
-    get<T = Record<string, unknown>>(...params: SqliteValue$2[]): T | undefined;
-}
-/**
- * Sync SQLite client port owned by Mockingbird.
- *
- * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
- * `bun:sqlite` instances all work when they expose this surface.
- */
-interface SqliteClient$2 {
-    exec(sql: string): void;
-    prepare(sql: string): SqliteStatement$2;
-    transaction<T>(fn: () => T): T;
-}
 
 /** A stable identifier for a point in a {@link Timeline}. */
 type CheckpointId$1 = string;
@@ -119,6 +101,37 @@ declare class Timeline$1<T> {
 interface FetchAPI$2 {
     fetch(request: Request): Promise<Response>;
 }
+/** A bare function form of {@link FetchAPI}, compatible with `Bun.serve`, workerd, and Deno. */
+type FetchHandler$1 = (request: Request) => Promise<Response>;
+
+/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
+type SqliteValue$2 = null | number | bigint | string | Uint8Array | boolean;
+/** Mutation counters returned by {@link SqliteStatement.run}. */
+type SqliteRunResult$2 = {
+    changes: number;
+    lastInsertRowid: number | bigint;
+};
+/**
+ * Prepared statement bound to a {@link SqliteClient}.
+ *
+ * Pass bind values as rest arguments on each call (no sticky `bind()`).
+ */
+interface SqliteStatement$2 {
+    run(...params: SqliteValue$2[]): SqliteRunResult$2;
+    all<T = Record<string, unknown>>(...params: SqliteValue$2[]): T[];
+    get<T = Record<string, unknown>>(...params: SqliteValue$2[]): T | undefined;
+}
+/**
+ * Sync SQLite client port owned by Mockingbird.
+ *
+ * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
+ * `bun:sqlite` instances all work when they expose this surface.
+ */
+interface SqliteClient$2 {
+    exec(sql: string): void;
+    prepare(sql: string): SqliteStatement$2;
+    transaction<T>(fn: () => T): T;
+}
 
 /**
  * The single source of time for a service.
@@ -535,6 +548,8 @@ 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;
+    /** Same-origin Fetch handler and App Router method exports, sharing this runtime. */
+    mount(prefix: string): MountedAPI$1;
     readonly sqlite: SqliteClient$2;
     readonly clock: Clock$1;
     readonly faults: FaultRegistry$1;
@@ -601,6 +616,9 @@ type CommonServeOptions = {
     adminKey: string | undefined;
     seed: string | undefined;
     onLog: ((entry: RequestLog$1) => void) | undefined;
+    /** Synthetic provider fixture objects supplied by a fleet entry. */
+    fixtures?: Record<string, unknown>;
+    baseUrl?: string;
 };
 /**
  * What a service contributes to `serve`: how to build its runtime from CLI flags,
@@ -619,34 +637,16 @@ type ServeTarget = {
     listening?(server: Listening): void;
 };
 
-/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
-type SqliteValue$1 = null | number | bigint | string | Uint8Array | boolean;
-/** Mutation counters returned by {@link SqliteStatement.run}. */
-type SqliteRunResult$1 = {
-    changes: number;
-    lastInsertRowid: number | bigint;
+type MountedAPI = FetchAPI$1 & {
+    readonly prefix: string;
+    GET: FetchHandler;
+    POST: FetchHandler;
+    PUT: FetchHandler;
+    PATCH: FetchHandler;
+    DELETE: FetchHandler;
+    HEAD: FetchHandler;
+    OPTIONS: FetchHandler;
 };
-/**
- * Prepared statement bound to a {@link SqliteClient}.
- *
- * Pass bind values as rest arguments on each call (no sticky `bind()`).
- */
-interface SqliteStatement$1 {
-    run(...params: SqliteValue$1[]): SqliteRunResult$1;
-    all<T = Record<string, unknown>>(...params: SqliteValue$1[]): T[];
-    get<T = Record<string, unknown>>(...params: SqliteValue$1[]): T | undefined;
-}
-/**
- * Sync SQLite client port owned by Mockingbird.
- *
- * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
- * `bun:sqlite` instances all work when they expose this surface.
- */
-interface SqliteClient$1 {
-    exec(sql: string): void;
-    prepare(sql: string): SqliteStatement$1;
-    transaction<T>(fn: () => T): T;
-}
 
 /** A stable identifier for a point in a {@link Timeline}. */
 type CheckpointId = string;
@@ -737,6 +737,37 @@ declare class Timeline<T> {
 interface FetchAPI$1 {
     fetch(request: Request): Promise<Response>;
 }
+/** A bare function form of {@link FetchAPI}, compatible with `Bun.serve`, workerd, and Deno. */
+type FetchHandler = (request: Request) => Promise<Response>;
+
+/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
+type SqliteValue$1 = null | number | bigint | string | Uint8Array | boolean;
+/** Mutation counters returned by {@link SqliteStatement.run}. */
+type SqliteRunResult$1 = {
+    changes: number;
+    lastInsertRowid: number | bigint;
+};
+/**
+ * Prepared statement bound to a {@link SqliteClient}.
+ *
+ * Pass bind values as rest arguments on each call (no sticky `bind()`).
+ */
+interface SqliteStatement$1 {
+    run(...params: SqliteValue$1[]): SqliteRunResult$1;
+    all<T = Record<string, unknown>>(...params: SqliteValue$1[]): T[];
+    get<T = Record<string, unknown>>(...params: SqliteValue$1[]): T | undefined;
+}
+/**
+ * Sync SQLite client port owned by Mockingbird.
+ *
+ * Duck-typed so `@crvouga/mockingbird-service-sqlite` `Database`, better-sqlite3, and wrapped
+ * `bun:sqlite` instances all work when they expose this surface.
+ */
+interface SqliteClient$1 {
+    exec(sql: string): void;
+    prepare(sql: string): SqliteStatement$1;
+    transaction<T>(fn: () => T): T;
+}
 
 /** Options every provider constructor accepts. */
 type APIOptions = {
@@ -1166,6 +1197,8 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     /** Stop package-owned lifecycle timers when a supervisor closes the runtime. */
     stop?(): void;
     readonly name: string;
+    /** Same-origin Fetch handler and App Router method exports, sharing this runtime. */
+    mount(prefix: string): MountedAPI;
     readonly sqlite: SqliteClient$1;
     readonly clock: Clock;
     readonly faults: FaultRegistry;

package/dist/server.js

@@ -3,8 +3,8 @@ import {
   createServer,
   loadCorpus,
   serveTarget
-} from "./chunk-XMZYEZ4V.js";
-import "./chunk-G3BD4D34.js";
+} from "./chunk-R4LSSE3O.js";
+import "./chunk-WEQDMSPV.js";
 import "./chunk-2FZJPMTR.js";
 import "./chunk-ISDNA2TU.js";
 export {

package/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.1.0
 info:
   title: Junction API (Mockingbird subset)
   description: |
-    Stateful mock subset of the Junction (Vital) API.
+    Stateful emulator subset of the Junction (Vital) API.
     Docs: https://docs.junction.com/
     Auth: https://docs.junction.com/api-details/junction-api
     Create user: https://docs.junction.com/api-reference/user/create-user
@@ -351,7 +351,7 @@ paths:
         parity:
           enabled: false
           safe: true
-          reason: "lab-account inventory is fixture-owned; the mock models the documented shape, filters and routing rules, not a live account inventory"
+          reason: "lab-account inventory is fixture-owned; the emulator models the documented shape, filters and routing rules, not a live account inventory"
       parameters:
         - name: lab_account_id
           in: query
@@ -688,7 +688,7 @@ paths:
           safe: true
           reason: >-
             central_labs presence, within_radius counts and getlabs market coverage are
-            provider-owned geo data that a mock cannot replicate per-zip; covered by the
+            provider-owned geo data that an emulator cannot replicate per-zip; covered by the
             client-parity scenario shape checks instead
       parameters:
         - name: zip_code
@@ -740,7 +740,7 @@ paths:
           safe: true
           reason: >-
             patient_service_centers are real site inventories per zip (thousands of sites,
-            result-capped at 30) that a fixture mock cannot replicate per-zip; covered by
+            result-capped at 30) that a fixture emulator cannot replicate per-zip; covered by
             the client-parity scenario shape checks instead
       parameters:
         - name: zip_code
@@ -795,7 +795,7 @@ paths:
           safe: true
           reason: >-
             availability slots are provider-side data whose values shift between sandbox calls;
-            covered by the mock-internal scheduling property suite instead
+            covered by the emulator-internal scheduling property suite instead
       parameters:
         - name: start_date
           in: query
@@ -861,7 +861,7 @@ paths:
           safe: true
           reason: >-
             availability slots are provider-side data whose values shift between sandbox calls;
-            covered by the mock-internal scheduling property suite instead
+            covered by the emulator-internal scheduling property suite instead
       parameters:
         - name: lab
           in: query
@@ -956,7 +956,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            appointment payloads embed provider-side slot data; covered by the mock-internal
+            appointment payloads embed provider-side slot data; covered by the emulator-internal
             scheduling property suite instead
       responses:
         "200":
@@ -996,7 +996,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            booking depends on live provider slot state; covered by the mock-internal scheduling
+            booking depends on live provider slot state; covered by the emulator-internal scheduling
             property suite instead
       requestBody:
         required: true
@@ -1048,7 +1048,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            rescheduling depends on live provider slot state; covered by the mock-internal
+            rescheduling depends on live provider slot state; covered by the emulator-internal
             scheduling property suite instead
       requestBody:
         required: true
@@ -1100,7 +1100,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            cancellation depends on live provider appointment state; covered by the mock-internal
+            cancellation depends on live provider appointment state; covered by the emulator-internal
             scheduling property suite instead
       requestBody:
         required: true
@@ -1152,7 +1152,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            appointment payloads embed provider-side slot data; covered by the mock-internal
+            appointment payloads embed provider-side slot data; covered by the emulator-internal
             scheduling property suite instead
       responses:
         "200":
@@ -1192,7 +1192,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            booking depends on live provider slot state; covered by the mock-internal scheduling
+            booking depends on live provider slot state; covered by the emulator-internal scheduling
             property suite instead
       parameters:
         - name: x-idempotency-key
@@ -1250,7 +1250,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            rescheduling depends on live provider slot state; covered by the mock-internal
+            rescheduling depends on live provider slot state; covered by the emulator-internal
             scheduling property suite instead
       requestBody:
         required: true
@@ -1302,7 +1302,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            cancellation depends on live provider appointment state; covered by the mock-internal
+            cancellation depends on live provider appointment state; covered by the emulator-internal
             scheduling property suite instead
       requestBody:
         required: true
@@ -1541,7 +1541,7 @@ paths:
           enabled: false
           safe: true
           reason: >-
-            results carry provider-side specimen data; covered by the mock-internal results
+            results carry provider-side specimen data; covered by the emulator-internal results
             property suite instead
       responses:
         "200":

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@crvouga/mockingbird-service-junction",
-  "version": "3.0.0",
-  "description": "Stateful mock of the Junction (Vital) user API driven by its OpenAPI contract and verified by differential property tests against the Junction sandbox.",
+  "version": "3.2.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",
   "sideEffects": false,
@@ -49,6 +49,7 @@
     "vital"
   ],
   "mockingbird": {
+    "featured": true,
     "runtime": "portable",
     "entries": {
       "server": "node",
@@ -98,7 +99,9 @@
     "lint": "biome check .",
     "test": "bun test",
     "parity": "bun scripts/parity.ts",
+    "emulator:server": "bun scripts/server.ts",
     "mock:server": "bun scripts/server.ts",
+    "emulator:serve": "bun scripts/server.ts",
     "mock:serve": "bun scripts/server.ts",
     "corpus:record": "bun scripts/record-corpus.ts",
     "client-parity": "bun scripts/client-parity.ts",
@@ -111,7 +114,7 @@
     "verify": "bun src/cli.ts verify"
   },
   "dependencies": {
-    "@crvouga/mockingbird-service-sqlite": "3.0.0",
+    "@crvouga/mockingbird-service-sqlite": "3.2.0",
     "hono": "4.11.9"
   },
   "devDependencies": {