@crvouga/mockingbird-service-rxvortex 1.0.0 → 1.1.1

package/dist/server.d.ts

@@ -170,82 +170,6 @@ type FaultRegistry$1 = {
     take(candidate: FaultCandidate$1): Promise<FaultHit$1[]>;
 };
 
-/** One handled request, as the structured log sees it. */
-type RequestLog$1 = {
-    service: string;
-    namespace: string;
-    operationId: string | undefined;
-    method: string;
-    path: string;
-    status: number;
-    durationMs: number;
-    /** True when the path matched no operation in the contract. */
-    unmatched: boolean;
-    /** Set when a fault rule produced the response. */
-    faultId?: string;
-    /** Resource ids the handler touched (`userId`, `orderId`, …), when the service reports them. */
-    ids?: Record<string, string>;
-    /** Set when the service created a resource the request referred to but that did not exist. */
-    adopted?: boolean;
-};
-type MetricsReport$1 = {
-    requests: number;
-    /** Counts keyed `<operationId> <status>`. */
-    byOperation: Record<string, number>;
-    /**
-     * Paths that matched no operation, most frequent first.
-     *
-     * This is the early-warning signal: a consumer calling something the mock does
-     * not implement shows up here as a count, before it fails a suite as a 404.
-     */
-    unmatched: {
-        method: string;
-        path: string;
-        count: number;
-    }[];
-    faults: number;
-    totalDurationMs: number;
-};
-type Metrics$1 = {
-    record(entry: RequestLog$1): void;
-    report(): MetricsReport$1;
-    reset(): void;
-};
-
-/** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
-type JournalEntry$1 = RequestLog$1 & {
-    at: string;
-};
-type JournalQuery$1 = {
-    /** Only this namespace. Omit for every namespace, oldest first across all of them. */
-    namespace?: string;
-    operationId?: string;
-    status?: number;
-    /** Only entries at or after this instant (epoch ms). */
-    since?: number;
-    /** At most this many, the most recent kept. */
-    limit?: number;
-};
-type Journal$1 = {
-    readonly size: number;
-    record(entry: JournalEntry$1): void;
-    list(query?: JournalQuery$1): JournalEntry$1[];
-    /** Forget one namespace's entries, or every namespace's. */
-    clear(namespace?: string): void;
-};
-
-/** Credential → namespace mapping behind `PUT /__admin/credentials`. */
-type CredentialRegistry$1 = {
-    set(credential: string, namespace: string): void;
-    get(credential: string): string | undefined;
-    remove(credential: string): boolean;
-    clear(): void;
-    entries(): {
-        credential: string;
-        namespace: string;
-    }[];
-};
-
 /** A stable identifier for a point in a {@link Timeline}. */
 type CheckpointId$1 = string;
 /** An immutable node in a timeline's checkpoint DAG. */
@@ -336,6 +260,110 @@ interface FetchAPI$2 {
     fetch(request: Request): Promise<Response>;
 }
 
+/**
+ * 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
+ * accepts (a `415` on most vendors), `syntax` when it could not be decoded, `required` when
+ * the operation needs a body and none arrived, and `schema` for a contract violation.
+ */
+type BodyIssue$1 = {
+    path: string;
+    message: string;
+    kind?: "media_type" | "syntax" | "required" | "schema";
+};
+
+/**
+ * What the mock received from a request it rejected, so a 4xx can be attributed after the
+ * fact (an empty body, a missing `content-type`, a schema violation) without logging the body.
+ */
+type RejectedRequest$1 = {
+    /** The raw `content-type` header, or `null` when the request sent none. */
+    contentType: string | null;
+    /** Bytes of body received from `content-length` (`0` for none), or `null` when the client sent no length (a streamed / chunked body). */
+    bodyBytes: number | null;
+    /** The raw `transfer-encoding` header (`chunked`), or `null`. */
+    transferEncoding: string | null;
+};
+/** One handled request, as the structured log sees it. */
+type RequestLog$1 = {
+    service: string;
+    namespace: string;
+    operationId: string | undefined;
+    method: string;
+    path: string;
+    status: number;
+    durationMs: number;
+    /** True when the path matched no operation in the contract. */
+    unmatched: boolean;
+    /** Set when a fault rule produced the response. */
+    faultId?: string;
+    /** Resource ids the handler touched (`userId`, `orderId`, …), when the service reports them. */
+    ids?: Record<string, string>;
+    /** Set when the service created a resource the request referred to but that did not exist. */
+    adopted?: boolean;
+    /** Set on a rejection (status ≥ 400) the mock produced itself, never on a scripted fault. */
+    request?: RejectedRequest$1;
+    /** The validation issues behind a rejection, when the service found any. */
+    issues?: BodyIssue$1[];
+};
+type MetricsReport$1 = {
+    requests: number;
+    /** Counts keyed `<operationId> <status>`. */
+    byOperation: Record<string, number>;
+    /**
+     * Paths that matched no operation, most frequent first.
+     *
+     * This is the early-warning signal: a consumer calling something the mock does
+     * not implement shows up here as a count, before it fails a suite as a 404.
+     */
+    unmatched: {
+        method: string;
+        path: string;
+        count: number;
+    }[];
+    faults: number;
+    totalDurationMs: number;
+};
+type Metrics$1 = {
+    record(entry: RequestLog$1): void;
+    report(): MetricsReport$1;
+    reset(): void;
+};
+
+/** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
+type JournalEntry$1 = RequestLog$1 & {
+    at: string;
+};
+type JournalQuery$1 = {
+    /** Only this namespace. Omit for every namespace, oldest first across all of them. */
+    namespace?: string;
+    operationId?: string;
+    status?: number;
+    /** Only entries at or after this instant (epoch ms). */
+    since?: number;
+    /** At most this many, the most recent kept. */
+    limit?: number;
+};
+type Journal$1 = {
+    readonly size: number;
+    record(entry: JournalEntry$1): void;
+    list(query?: JournalQuery$1): JournalEntry$1[];
+    /** Forget one namespace's entries, or every namespace's. */
+    clear(namespace?: string): void;
+};
+
+/** Credential → namespace mapping behind `PUT /__admin/credentials`. */
+type CredentialRegistry$1 = {
+    set(credential: string, namespace: string): void;
+    get(credential: string): string | undefined;
+    remove(credential: string): boolean;
+    clear(): void;
+    entries(): {
+        credential: string;
+        namespace: string;
+    }[];
+};
+
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -523,6 +551,20 @@ type Listening = {
     close(): Promise<void>;
 };
 
+/** One preset catalog row, in the field names `GET /api/v1/preset-catalog-items` uses. */
+type CatalogItem = {
+    catalog_id: string;
+    medication_name: string;
+    medication_strength: string | null;
+    package_size: string | null;
+    quantity: number | null;
+    quantity_units: string | null;
+    medication_form: string | null;
+    route: string | null;
+    states: string[];
+    status: "active" | "inactive";
+};
+
 /**
  * The single source of time for a service.
  *
@@ -728,94 +770,6 @@ type FaultRegistry = {
     take(candidate: FaultCandidate): Promise<FaultHit[]>;
 };
 
-/** One handled request, as the structured log sees it. */
-type RequestLog = {
-    service: string;
-    namespace: string;
-    operationId: string | undefined;
-    method: string;
-    path: string;
-    status: number;
-    durationMs: number;
-    /** True when the path matched no operation in the contract. */
-    unmatched: boolean;
-    /** Set when a fault rule produced the response. */
-    faultId?: string;
-    /** Resource ids the handler touched (`userId`, `orderId`, …), when the service reports them. */
-    ids?: Record<string, string>;
-    /** Set when the service created a resource the request referred to but that did not exist. */
-    adopted?: boolean;
-};
-type MetricsReport = {
-    requests: number;
-    /** Counts keyed `<operationId> <status>`. */
-    byOperation: Record<string, number>;
-    /**
-     * Paths that matched no operation, most frequent first.
-     *
-     * This is the early-warning signal: a consumer calling something the mock does
-     * not implement shows up here as a count, before it fails a suite as a 404.
-     */
-    unmatched: {
-        method: string;
-        path: string;
-        count: number;
-    }[];
-    faults: number;
-    totalDurationMs: number;
-};
-type Metrics = {
-    record(entry: RequestLog): void;
-    report(): MetricsReport;
-    reset(): void;
-};
-
-/** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
-type JournalEntry = RequestLog & {
-    at: string;
-};
-type JournalQuery = {
-    /** Only this namespace. Omit for every namespace, oldest first across all of them. */
-    namespace?: string;
-    operationId?: string;
-    status?: number;
-    /** Only entries at or after this instant (epoch ms). */
-    since?: number;
-    /** At most this many, the most recent kept. */
-    limit?: number;
-};
-type Journal = {
-    readonly size: number;
-    record(entry: JournalEntry): void;
-    list(query?: JournalQuery): JournalEntry[];
-    /** Forget one namespace's entries, or every namespace's. */
-    clear(namespace?: string): void;
-};
-
-/** Credential → namespace mapping behind `PUT /__admin/credentials`. */
-type CredentialRegistry = {
-    set(credential: string, namespace: string): void;
-    get(credential: string): string | undefined;
-    remove(credential: string): boolean;
-    clear(): void;
-    entries(): {
-        credential: string;
-        namespace: string;
-    }[];
-};
-
-/**
- * Sequential id source persisted in SQLite. Ids are deterministic for a given
- * sequence history (`cus_` + 14 opaque chars), so reproductions stay stable.
- */
-declare class IdSequence {
-    private readonly sqlite;
-    private readonly namespace;
-    private readonly salt;
-    constructor(sqlite: SqliteClient$1, namespace: string, salt?: string);
-    next(prefix: string, length?: number): string;
-}
-
 /** A stable identifier for a point in a {@link Timeline}. */
 type CheckpointId = string;
 /** An immutable node in a timeline's checkpoint DAG. */
@@ -906,6 +860,135 @@ interface FetchAPI$1 {
     fetch(request: Request): Promise<Response>;
 }
 
+/** 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
+ * accepts (a `415` on most vendors), `syntax` when it could not be decoded, `required` when
+ * the operation needs a body and none arrived, and `schema` for a contract violation.
+ */
+type BodyIssue = {
+    path: string;
+    message: string;
+    kind?: "media_type" | "syntax" | "required" | "schema";
+};
+
+/**
+ * What the mock received from a request it rejected, so a 4xx can be attributed after the
+ * fact (an empty body, a missing `content-type`, a schema violation) without logging the body.
+ */
+type RejectedRequest = {
+    /** The raw `content-type` header, or `null` when the request sent none. */
+    contentType: string | null;
+    /** Bytes of body received from `content-length` (`0` for none), or `null` when the client sent no length (a streamed / chunked body). */
+    bodyBytes: number | null;
+    /** The raw `transfer-encoding` header (`chunked`), or `null`. */
+    transferEncoding: string | null;
+};
+/** One handled request, as the structured log sees it. */
+type RequestLog = {
+    service: string;
+    namespace: string;
+    operationId: string | undefined;
+    method: string;
+    path: string;
+    status: number;
+    durationMs: number;
+    /** True when the path matched no operation in the contract. */
+    unmatched: boolean;
+    /** Set when a fault rule produced the response. */
+    faultId?: string;
+    /** Resource ids the handler touched (`userId`, `orderId`, …), when the service reports them. */
+    ids?: Record<string, string>;
+    /** Set when the service created a resource the request referred to but that did not exist. */
+    adopted?: boolean;
+    /** Set on a rejection (status ≥ 400) the mock produced itself, never on a scripted fault. */
+    request?: RejectedRequest;
+    /** The validation issues behind a rejection, when the service found any. */
+    issues?: BodyIssue[];
+};
+type MetricsReport = {
+    requests: number;
+    /** Counts keyed `<operationId> <status>`. */
+    byOperation: Record<string, number>;
+    /**
+     * Paths that matched no operation, most frequent first.
+     *
+     * This is the early-warning signal: a consumer calling something the mock does
+     * not implement shows up here as a count, before it fails a suite as a 404.
+     */
+    unmatched: {
+        method: string;
+        path: string;
+        count: number;
+    }[];
+    faults: number;
+    totalDurationMs: number;
+};
+type Metrics = {
+    record(entry: RequestLog): void;
+    report(): MetricsReport;
+    reset(): void;
+};
+
+/** One journal entry: a request log stamped with when (on the mock clock) it was handled. */
+type JournalEntry = RequestLog & {
+    at: string;
+};
+type JournalQuery = {
+    /** Only this namespace. Omit for every namespace, oldest first across all of them. */
+    namespace?: string;
+    operationId?: string;
+    status?: number;
+    /** Only entries at or after this instant (epoch ms). */
+    since?: number;
+    /** At most this many, the most recent kept. */
+    limit?: number;
+};
+type Journal = {
+    readonly size: number;
+    record(entry: JournalEntry): void;
+    list(query?: JournalQuery): JournalEntry[];
+    /** Forget one namespace's entries, or every namespace's. */
+    clear(namespace?: string): void;
+};
+
+/** Credential → namespace mapping behind `PUT /__admin/credentials`. */
+type CredentialRegistry = {
+    set(credential: string, namespace: string): void;
+    get(credential: string): string | undefined;
+    remove(credential: string): boolean;
+    clear(): void;
+    entries(): {
+        credential: string;
+        namespace: string;
+    }[];
+};
+
+/**
+ * Sequential id source persisted in SQLite. Ids are deterministic for a given
+ * sequence history (`cus_` + 14 opaque chars), so reproductions stay stable.
+ */
+declare class IdSequence {
+    private readonly sqlite;
+    private readonly namespace;
+    private readonly salt;
+    constructor(sqlite: SqliteClient$1, namespace: string, salt?: string);
+    next(prefix: string, length?: number): string;
+}
+
 /**
  * A point-in-time copy of everything a service namespace holds.
  *
@@ -1056,19 +1139,6 @@ type ServiceRuntime<T extends ServiceInstance> = FetchAPI$1 & {
     timeline(namespace?: string): Timeline<ServiceTimelineState>;
 };
 
-/** 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;
-};
-
 /** 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}. */
@@ -1098,20 +1168,6 @@ interface SqliteClient {
     transaction<T>(fn: () => T): T;
 }
 
-/** One preset catalog row, in the field names `GET /api/v1/preset-catalog-items` uses. */
-type CatalogItem = {
-    catalog_id: string;
-    medication_name: string;
-    medication_strength: string | null;
-    package_size: string | null;
-    quantity: number | null;
-    quantity_units: string | null;
-    medication_form: string | null;
-    route: string | null;
-    states: string[];
-    status: "active" | "inactive";
-};
-
 /**
  * Anything that can answer a Fetch `Request` with a `Response`.
  *
@@ -1164,6 +1220,12 @@ type Settings = {
         client_secret: string;
     }[];
     autoAdvance: AutoAdvance | null;
+    /**
+     * What a submit does with a well-formed `preset_catalog_id` the catalog does not hold:
+     * `"reject"` answers 422 as the sandbox does; `"accept"` adds it as an active row named
+     * after the request's `medication_name`. Inactive rows are refused either way.
+     */
+    unknownPresets: "reject" | "accept";
 };
 declare class RxVortexState {
     private readonly seed;
@@ -1172,11 +1234,14 @@ declare class RxVortexState {
     readonly settings: Collection<Settings>;
     readonly ids: IdSequence;
     constructor(sqlite: SqliteClient, namespace: string, seed: {
-        catalog: readonly CatalogItem[];
+        catalog: readonly CatalogItem[] | undefined;
         settings: Partial<Settings>;
     });
     /** Re-apply the catalog and settings after a reset. */
     ensureSeeded(): void;
+    /** Load rows: `replace` drops every other row first, `merge` upserts by `catalog_id`. */
+    putCatalog(items: readonly CatalogItem[], mode: "replace" | "merge"): number;
+    catalogRows(): CatalogItem[];
     current(): Settings;
     update(patch: Partial<Settings>): Settings;
     /** By vendor tracking id first, then by our sender order id (the recovery lookup). */
@@ -1235,6 +1300,11 @@ declare class RxVortexAPI implements FetchAPI {
     private iso;
     private generateToken;
     private createOrder;
+    /**
+     * Under `unknownPresets: "accept"`, a well-formed preset id the catalog lacks becomes an
+     * active row described by the request, so later submits and catalog reads see it.
+     */
+    private adoptPreset;
     private getOrder;
     private cancelOrder;
     /** Move an order to a vendor status, set the three fields coherently, emit the webhook. */
@@ -1253,6 +1323,10 @@ type RxVortexRuntimeOptions = {
     seed?: number | string;
     adminKey?: string;
     onLog?: (entry: RequestLog) => void;
+    /**
+     * Rows every namespace starts with, and returns to on `POST /__admin/reset` (`serve
+     * --catalog <file>`). Default: `DEFAULT_CATALOG`.
+     */
     catalog?: readonly CatalogItem[];
     settings?: Partial<Settings>;
     /** Where status webhooks go (`POST /prescriptions/webhooks/rxvortex`), sent with the secret header. */
@@ -1287,8 +1361,13 @@ type RxVortexServer = Listening & {
 };
 /** Serve the RxVortex mock over `node:http`, with auto-advance ticking every 100 ms. */
 declare const createServer: (options?: RxVortexServerOptions) => Promise<RxVortexServer>;
+/**
+ * Read a catalog file: a JSON array of rows, or the `{data: [...]}` body
+ * `GET /api/v1/preset-catalog-items` answers with, so a recorded response loads as-is.
+ */
+declare const loadCatalogFile: (path: string) => CatalogItem[];
 /** How `serve` (and `serve --config`) builds the RxVortex mock from flags. */
 declare const serveTarget: ServeTarget;
 
-export { DEFAULT_PORT, createServer, serveTarget };
+export { DEFAULT_PORT, createServer, loadCatalogFile, serveTarget };
 export type { RxVortexServer, RxVortexServerOptions };

package/dist/server.js

@@ -1,12 +1,14 @@
 import {
   DEFAULT_PORT,
   createServer,
+  loadCatalogFile,
   serveTarget
-} from "./chunk-ZAM35JQO.js";
-import "./chunk-DNELVPK4.js";
+} from "./chunk-XAWKEXKJ.js";
+import "./chunk-5KK6W2PE.js";
 export {
   DEFAULT_PORT,
   createServer,
+  loadCatalogFile,
   serveTarget
 };
 //# sourceMappingURL=server.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crvouga/mockingbird-service-rxvortex",
-  "version": "1.0.0",
+  "version": "1.1.1",
   "description": "Stateful mock of the RxVortex (Strive) pharmacy API: OAuth token, order submit, status, cancel, recovery by sender order id, preset catalog, and signed status webhooks.",
   "license": "MIT",
   "type": "module",
@@ -56,7 +56,7 @@
       "website": "https://www.rxvortex.com",
       "description": "RxVortex is a pharmacy order platform whose API lets telehealth partners submit, track and cancel prescription orders with pharmacies such as Strive."
     },
-    "status": "wip"
+    "status": "ready"
   },
   "scripts": {
     "generate": "bun ../../openapi/codegen/dist/cli.js",