@crvouga/mockingbird-service-fullscript 3.13.0 → 3.15.0

package/dist/index.d.ts

@@ -113,98 +113,6 @@ interface FetchAPI {
 /** 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;
-}
-
-/** Every stored record carries a monotonically increasing sequence for stable ordering. */
-type Stored<T> = {
-    seq: number;
-    value: T;
-};
-type ListRecordsOptions<T> = {
-    /** Keep only records passing the predicate. */
-    where?: (value: T, seq: number) => boolean;
-    /** Sort order; default newest first. */
-    order?: "newest" | "oldest";
-};
-/**
- * A SQLite-backed table of JSON records addressed by id. Ordering is by insertion
- * sequence, never by id lexicographic order, so list semantics stay stable.
- */
-declare class Collection<T> {
-    private readonly sqlite;
-    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
-    readonly namespace: string;
-    /** Table name inside the namespace. Stable across resets of the rows themselves. */
-    readonly collectionName: string;
-    private readonly statements;
-    private prepare;
-    constructor(sqlite: SqliteClient$1, 
-    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
-    namespace: string, 
-    /** Table name inside the namespace. Stable across resets of the rows themselves. */
-    collectionName: string);
-    private bumpCollectionSeq;
-    nextSequence(): number;
-    get(id: string): T | undefined;
-    has(id: string): boolean;
-    /** Insert a new record, assigning it the next sequence number. */
-    insert(id: string, value: T): Stored<T>;
-    /** Replace an existing record's value, keeping its position. */
-    update(id: string, value: T): Stored<T> | undefined;
-    delete(id: string): boolean;
-    /** How many records the collection holds, without reading them. */
-    count(): number;
-    list(options?: ListRecordsOptions<T>): Array<Stored<T> & {
-        id: string;
-    }>;
-}
-
-/**
- * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
- * which derives the base from the wall clock when the runtime is created.
- */
-type IdBase = number | string;
-
-/** Options every provider constructor accepts. */
-type APIOptions = {
-    /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
-    sqlite?: SqliteClient$1;
-    /** Clock used for `created`-style fields. Default `Date.now`. */
-    now?: () => number;
-    /**
-     * Storage namespace for this instance's records. Instances sharing one SQLite
-     * client stay isolated when their namespaces differ. Defaults to the service name.
-     */
-    namespace?: string;
-};
-
 /**
  * The single source of time for a service.
  *
@@ -235,6 +143,11 @@ type Clock = {
     state(): ClockState;
 };
 
+type UpstreamState = {
+    mode: "emulated" | "forward";
+    baseUrl: string;
+};
+
 /**
  * Seeded pseudo-random numbers, so anything a mock invents — ids, jitter, which
  * request a percentage fault hits — is reproducible from a seed.
@@ -511,6 +424,7 @@ declare const SNAPSHOT_FORMAT = "mockingbird.snapshot/v1";
  * `records` are required, so a hand-written seed file is a valid snapshot.
  */
 type SnapshotDocument = {
+    upstream?: UpstreamState;
     format: typeof SNAPSHOT_FORMAT;
     /** The service that wrote it. A snapshot is rejected by any other service. */
     service?: string;
@@ -584,6 +498,7 @@ type LatencyState = LatencyRule & {
 };
 /** What {@link controlHeaders} turns into request headers. */
 type ControlHeaderInput = {
+    upstream?: "emulated" | "forward";
     namespace?: string;
     adminKey?: string;
     branch?: string;
@@ -601,6 +516,48 @@ type ControlHeaderInput = {
     snapshot?: string;
 };
 
+/** 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 = {
+    /** Sync SQLite client. Defaults to `@crvouga/mockingbird-service-sqlite`. */
+    sqlite?: SqliteClient$1;
+    /** Clock used for `created`-style fields. Default `Date.now`. */
+    now?: () => number;
+    /**
+     * Storage namespace for this instance's records. Instances sharing one SQLite
+     * client stay isolated when their namespaces differ. Defaults to the service name.
+     */
+    namespace?: string;
+};
+
 /**
  * One problem with a request body, at a dotted path (`patient.address.city`, `items.0.sku`).
  * `kind` is `media_type` when the body is present but its media type is not one the operation
@@ -627,6 +584,7 @@ type RejectedRequest = {
 };
 /** One handled request, as the structured log sees it. */
 type RequestLog = {
+    upstream?: boolean;
     service: string;
     namespace: string;
     operationId: string | undefined;
@@ -761,8 +719,6 @@ type CredentialRegistry = {
     }[];
 };
 
-type OwnedTransport = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
-
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -785,6 +741,50 @@ type NamespaceSnapshot = {
     }[];
 };
 
+/** Every stored record carries a monotonically increasing sequence for stable ordering. */
+type Stored<T> = {
+    seq: number;
+    value: T;
+};
+type ListRecordsOptions<T> = {
+    /** Keep only records passing the predicate. */
+    where?: (value: T, seq: number) => boolean;
+    /** Sort order; default newest first. */
+    order?: "newest" | "oldest";
+};
+/**
+ * A SQLite-backed table of JSON records addressed by id. Ordering is by insertion
+ * sequence, never by id lexicographic order, so list semantics stay stable.
+ */
+declare class Collection<T> {
+    private readonly sqlite;
+    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
+    readonly namespace: string;
+    /** Table name inside the namespace. Stable across resets of the rows themselves. */
+    readonly collectionName: string;
+    private readonly statements;
+    private prepare;
+    constructor(sqlite: SqliteClient$1, 
+    /** Storage namespace. Admin introspection uses this to ignore another namespace's tables. */
+    namespace: string, 
+    /** Table name inside the namespace. Stable across resets of the rows themselves. */
+    collectionName: string);
+    private bumpCollectionSeq;
+    nextSequence(): number;
+    get(id: string): T | undefined;
+    has(id: string): boolean;
+    /** Insert a new record, assigning it the next sequence number. */
+    insert(id: string, value: T): Stored<T>;
+    /** Replace an existing record's value, keeping its position. */
+    update(id: string, value: T): Stored<T> | undefined;
+    delete(id: string): boolean;
+    /** How many records the collection holds, without reading them. */
+    count(): number;
+    list(options?: ListRecordsOptions<T>): Array<Stored<T> & {
+        id: string;
+    }>;
+}
+
 declare const STATE_FIELD_KINDS: readonly ["string", "number", "boolean", "null", "object", "array", "unknown"];
 type StateFieldKind = (typeof STATE_FIELD_KINDS)[number];
 /** JSON-safe annotations a bespoke admin UI may read. The default UI shows them as text. */
@@ -815,6 +815,14 @@ type StateView = {
     collections: StateCollectionView[];
 };
 
+/**
+ * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
+ * which derives the base from the wall clock when the runtime is created.
+ */
+type IdBase = number | string;
+
+type OwnedTransport = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
+
 type WebhookEndpoint = {
     /** Stable id; generated when omitted. */
     id?: string;

package/dist/index.js

@@ -18,8 +18,7 @@ import {
   publicEvent,
   supportedOperationIds,
   tokenCredential
-} from "./chunk-NEIB5IT4.js";
-import "./chunk-RJZUEZVH.js";
+} from "./chunk-CJAYCSOW.js";
 export {
   DEFAULT_CLINIC,
   DEFAULT_PRACTITIONER,

package/dist/server.d.ts

@@ -105,41 +105,6 @@ interface FetchAPI {
 /** 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 = null | number | bigint | string | Uint8Array | boolean;
-/** Mutation counters returned by {@link SqliteStatement.run}. */
-type SqliteRunResult = {
-    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 {
-    run(...params: SqliteValue[]): SqliteRunResult;
-    all<T = Record<string, unknown>>(...params: SqliteValue[]): T[];
-    get<T = Record<string, unknown>>(...params: SqliteValue[]): 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 {
-    exec(sql: string): void;
-    prepare(sql: string): SqliteStatement;
-    transaction<T>(fn: () => T): T;
-}
-
-/**
- * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
- * which derives the base from the wall clock when the runtime is created.
- */
-type IdBase = number | string;
-
 /**
  * The single source of time for a service.
  *
@@ -170,6 +135,11 @@ type Clock = {
     state(): ClockState;
 };
 
+type UpstreamState = {
+    mode: "emulated" | "forward";
+    baseUrl: string;
+};
+
 /**
  * Seeded pseudo-random numbers, so anything a mock invents — ids, jitter, which
  * request a percentage fault hits — is reproducible from a seed.
@@ -433,6 +403,7 @@ declare const SNAPSHOT_FORMAT = "mockingbird.snapshot/v1";
  * `records` are required, so a hand-written seed file is a valid snapshot.
  */
 type SnapshotDocument = {
+    upstream?: UpstreamState;
     format: typeof SNAPSHOT_FORMAT;
     /** The service that wrote it. A snapshot is rejected by any other service. */
     service?: string;
@@ -506,6 +477,7 @@ type LatencyState = LatencyRule & {
 };
 /** What {@link controlHeaders} turns into request headers. */
 type ControlHeaderInput = {
+    upstream?: "emulated" | "forward";
     namespace?: string;
     adminKey?: string;
     branch?: string;
@@ -523,6 +495,35 @@ type ControlHeaderInput = {
     snapshot?: string;
 };
 
+/** Bind values accepted by Mockingbird's SQLite port (matches sqlite-mem / better-sqlite3). */
+type SqliteValue = null | number | bigint | string | Uint8Array | boolean;
+/** Mutation counters returned by {@link SqliteStatement.run}. */
+type SqliteRunResult = {
+    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 {
+    run(...params: SqliteValue[]): SqliteRunResult;
+    all<T = Record<string, unknown>>(...params: SqliteValue[]): T[];
+    get<T = Record<string, unknown>>(...params: SqliteValue[]): 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 {
+    exec(sql: string): void;
+    prepare(sql: string): SqliteStatement;
+    transaction<T>(fn: () => T): T;
+}
+
 /**
  * One problem with a request body, at a dotted path (`patient.address.city`, `items.0.sku`).
  * `kind` is `media_type` when the body is present but its media type is not one the operation
@@ -549,6 +550,7 @@ type RejectedRequest = {
 };
 /** One handled request, as the structured log sees it. */
 type RequestLog = {
+    upstream?: boolean;
     service: string;
     namespace: string;
     operationId: string | undefined;
@@ -683,8 +685,6 @@ type CredentialRegistry = {
     }[];
 };
 
-type OwnedTransport = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
-
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -737,6 +737,14 @@ type StateView = {
     collections: StateCollectionView[];
 };
 
+/**
+ * What names an id base: a non-negative safe integer (or its decimal string) or `"boot"`,
+ * which derives the base from the wall clock when the runtime is created.
+ */
+type IdBase = number | string;
+
+type OwnedTransport = (request: Request, namespace: string, send: typeof fetch) => Promise<Response>;
+
 type WebhookEndpoint = {
     /** Stable id; generated when omitted. */
     id?: string;

package/dist/server.js

@@ -2,9 +2,8 @@ import {
   DEFAULT_PORT,
   createServer,
   serveTarget
-} from "./chunk-NYU2CEXU.js";
-import "./chunk-NEIB5IT4.js";
-import "./chunk-RJZUEZVH.js";
+} from "./chunk-IVB27G3V.js";
+import "./chunk-CJAYCSOW.js";
 export {
   DEFAULT_PORT,
   createServer,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-fullscript",
-  "version": "3.13.0",
+  "version": "3.15.0",
   "description": "Stateful emulator of the Fullscript lab-ordering API: per-practitioner OAuth, clinic, session grants, forward-only lab orders with results, lab-order events, expiring result PDFs, and Fullscript-Signature webhooks.",
   "license": "MIT",
   "type": "module",
@@ -98,7 +98,8 @@
     "pack:check": "bun ../../../scripts/pack-check.ts"
   },
   "dependencies": {
-    "@crvouga/mockingbird-service-sqlite": "3.4.2",
+    "@crvouga/mockingbird-runtime": "0.0.1",
+    "@crvouga/mockingbird-service-sqlite": "3.5.0",
     "hono": "4.13.11"
   },
   "devDependencies": {