@crvouga/mockingbird-service-genebygene 0.1.0

package/README.md

@@ -0,0 +1,175 @@
+# @crvouga/mockingbird-service-genebygene
+
+Stateful, in-process mock of the [GeneByGene Nucleus API](https://api.genebygene.com/swagger/index.html)
+for test suites. It covers the OAuth client-credentials token endpoint, the product catalog, and
+order create/read: all 4 operations of the vendored OpenAPI subset, each verified by live parity
+against GeneByGene staging.
+
+Use it when your backend orders kits from GeneByGene and you want tests to run offline, with no
+staging credentials.
+
+- Operation coverage: [SUPPORT.md](https://github.com/crvouga/mockingbird/blob/main/packages/service/genebygene/SUPPORT.md)
+- Developer guide (PDF): https://api.genebygene.com/assets/GxG%20API%20Services%20Developer%20Guide%202022.pdf
+- Swagger UI: https://api.genebygene.com/swagger/index.html
+- Real staging hosts: API `https://staging-api.genebygene.com`, auth
+  `https://staging-auth.genebygene.com/connect/token`
+
+## Install
+
+```bash
+npm install -D @crvouga/mockingbird-service-genebygene
+```
+
+ESM only. Requires Node >= 22 or Bun >= 1.2. No native dependencies: state lives in an in-memory
+SQLite engine (`@crvouga/mockingbird-service-sqlite`, pure TypeScript). To serve it over HTTP also
+install `@crvouga/mockingbird-adapter-node` or `@crvouga/mockingbird-adapter-bun`.
+
+## Usage
+
+Routes and behaviour (all from the source):
+
+| Route | Behaviour |
+| --- | --- |
+| `POST /connect/token` | Form (or JSON) body with `grant_type=client_credentials`, `client_id`, `client_secret`. Any non-empty id/secret is accepted; returns `{ access_token, token_type: "Bearer", expires_in: 3600 }`. The token is deterministic per id/secret pair. Wrong grant type: 400 `unsupported_grant_type`; missing id/secret: 400 `invalid_client`. |
+| `GET /api/v2/products` | Requires `Authorization: Bearer <anything>`. Returns an array; a seed product `product_default` ("Mockingbird Default Kit") always exists. |
+| `POST /api/v2/orders` | Bearer required. JSON `{ productId, quantity }` (`quantity` a positive integer, `productId` must exist, else 400). Returns `{ orderId: "order_...", status: "Pending", quantity, productId, createdAt }`. |
+| `GET /api/v2/orders/{orderId}` | Bearer required. The stored order, or 404 `{ message: "order not found" }`. |
+
+- **Any host works.** Routing uses only the path, so the auth host and the API host of the real
+  service both map onto one mock instance: point both your token URL and API base URL at it.
+- **The bearer token is not validated.** Any `Authorization: Bearer <value>` passes; a missing or
+  non-Bearer header returns 401 `{ error: "unauthorized" }`.
+- Orders stay `Pending`; there are no status transitions.
+
+### In-process (inject `fetch`)
+
+```ts
+import { GeneByGeneAPI } from "@crvouga/mockingbird-service-genebygene"
+
+const gbg = new GeneByGeneAPI({ now: () => Date.UTC(2026, 0, 1) })
+
+const tokenResponse = await gbg.fetch(
+  new Request("https://staging-auth.genebygene.com/connect/token", {
+    method: "POST",
+    headers: { "content-type": "application/x-www-form-urlencoded" },
+    body: new URLSearchParams({
+      grant_type: "client_credentials",
+      client_id: "demo",
+      client_secret: "demo",
+    }),
+  }),
+)
+const { access_token } = (await tokenResponse.json()) as { access_token: string }
+const auth = { authorization: `Bearer ${access_token}` }
+
+const products = (await (
+  await gbg.fetch(new Request("https://staging-api.genebygene.com/api/v2/products", { headers: auth }))
+).json()) as { productId: string }[]
+
+const orderResponse = await gbg.fetch(
+  new Request("https://staging-api.genebygene.com/api/v2/orders", {
+    method: "POST",
+    headers: { ...auth, "content-type": "application/json" },
+    body: JSON.stringify({ productId: products[0]?.productId, quantity: 1 }),
+  }),
+)
+console.log(await orderResponse.json())
+// { orderId: "order_...", status: "Pending", quantity: 1, productId: "product_default", createdAt: "2026-01-01T00:00:00.000Z" }
+```
+
+`now` (milliseconds) drives `createdAt`.
+
+### Over HTTP
+
+```ts
+import { GeneByGeneAPI } from "@crvouga/mockingbird-service-genebygene"
+
+const gbg = new GeneByGeneAPI()
+// Equivalent to serve(gbg, { port: 0, hostname: "127.0.0.1" }) from @crvouga/mockingbird-adapter-bun
+const server = Bun.serve({ port: 0, hostname: "127.0.0.1", fetch: (request) => gbg.fetch(request) })
+const baseUrl = `http://127.0.0.1:${server.port}`
+
+// Use baseUrl for both the auth host and the API host in your app's config:
+const tokenUrl = `${baseUrl}/connect/token`
+const apiBaseUrl = baseUrl
+
+const token = await fetch(tokenUrl, {
+  method: "POST",
+  body: new URLSearchParams({ grant_type: "client_credentials", client_id: "id", client_secret: "secret" }),
+})
+console.log(token.status, apiBaseUrl) // 200
+
+server.stop()
+```
+
+Any Fetch-style server works, since `GeneByGeneAPI` only needs `fetch(request)`. On Node use
+`@crvouga/mockingbird-adapter-node`:
+
+```js
+import { serve } from "@crvouga/mockingbird-adapter-node"
+const server = await serve(gbg, { port: 0, host: "127.0.0.1" })
+const { port } = server.address()
+// ... later: server.close()
+```
+
+### Resetting between tests
+
+`reset()` deletes all orders and products, then re-seeds `product_default`:
+
+```ts
+import { beforeEach, expect, test } from "bun:test"
+import { GeneByGeneAPI } from "@crvouga/mockingbird-service-genebygene"
+
+const gbg = new GeneByGeneAPI()
+beforeEach(() => gbg.reset())
+
+test("catalog has the seed product", async () => {
+  const response = await gbg.fetch(
+    new Request("https://staging-api.genebygene.com/api/v2/products", {
+      headers: { authorization: "Bearer test" },
+    }),
+  )
+  expect(await response.json()).toEqual([
+    {
+      productId: "product_default",
+      name: "Mockingbird Default Kit",
+      description: "Seed product for GeneByGene mock",
+    },
+  ])
+})
+```
+
+## API
+
+| Export | Description |
+| --- | --- |
+| `GeneByGeneAPI` | Class. `new GeneByGeneAPI(options?)`; implements `FetchAPI`. Members: `fetch(request)`, `reset()`, `app` (Hono app), `sqlite` (`SqliteClient`). |
+| `GENEBYGENE_NAMESPACE` | `"genebygene"` — SQLite namespace holding the mock's state when sharing a `sqlite` client. |
+| `document` | The vendored GeneByGene OpenAPI document (Mockingbird subset) that drives routing. |
+| `operationIds` | Every `operationId` in `document`: `PostConnectToken`, `GetProducts`, `PostOrders`, `GetOrder`. |
+| `supportedOperationIds` | The `operationId`s the mock implements (all four). |
+
+Options and types:
+
+```text
+type APIOptions = {                // from @crvouga/mockingbird-service
+  sqlite?: SqliteClient            // share one client across services; default: fresh in-memory DB
+  now?: () => number               // clock in ms for createdAt; default Date.now
+}
+type OperationId / SupportedOperationId  // string unions of operationIds / supportedOperationIds
+```
+
+## Development
+
+For contributors to the mockingbird repo only; the parity script is not shipped in the npm package.
+
+```bash
+bun test                     # offline property suites
+bun run parity               # live parity against GeneByGene staging (credentials from env or OpenBao)
+MOCKINGBIRD_GENEBYGENE_CLIENT_ID=... MOCKINGBIRD_GENEBYGENE_CLIENT_SECRET=... bun run parity
+```
+
+Live parity exercises the token endpoint against staging auth and discovers product ids from the
+real catalog before creating orders (the live catalog differs from the mock's seed product).
+
+Part of [mockingbird](https://github.com/crvouga/mockingbird) — agent integration guide: [`@crvouga/mockingbird`](https://github.com/crvouga/mockingbird/tree/main/packages/facade#readme).

package/dist/generated/openapi.d.ts

@@ -0,0 +1,7 @@
+import type { OpenAPIDocument } from "@crvouga/mockingbird-openapi";
+export declare const document: OpenAPIDocument;
+export type OperationId = "PostConnectToken" | "GetProducts" | "PostOrders" | "GetOrder";
+export type SupportedOperationId = "PostConnectToken" | "GetProducts" | "PostOrders" | "GetOrder";
+export declare const operationIds: readonly ["PostConnectToken", "GetProducts", "PostOrders", "GetOrder"];
+export declare const supportedOperationIds: readonly ["PostConnectToken", "GetProducts", "PostOrders", "GetOrder"];
+//# sourceMappingURL=openapi.d.ts.map

package/dist/generated/openapi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.d.ts","sourceRoot":"","sources":["../../src/generated/openapi.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAA;AAEnE,eAAO,MAAM,QAAQ,EAAE,eAA8tJ,CAAA;AAErvJ,MAAM,MAAM,WAAW,GAAG,kBAAkB,GAAG,aAAa,GAAG,YAAY,GAAG,UAAU,CAAA;AACxF,MAAM,MAAM,oBAAoB,GAAG,kBAAkB,GAAG,aAAa,GAAG,YAAY,GAAG,UAAU,CAAA;AACjG,eAAO,MAAM,YAAY,wEAAsE,CAAA;AAC/F,eAAO,MAAM,qBAAqB,wEAAsE,CAAA"}

package/dist/generated/openapi.js

@@ -0,0 +1,5 @@
+// Generated by @crvouga/mockingbird-openapi-codegen from openapi.yaml. Do not edit.
+export const document = JSON.parse(`{"openapi":"3.1.0","info":{"title":"GeneByGene API (Mockingbird subset)","description":"Stateful mock subset of the GeneByGene Nucleus API.\\nDeveloper guide: https://api.genebygene.com/assets/GxG%20API%20Services%20Developer%20Guide%202022.pdf\\nSwagger UI: https://api.genebygene.com/swagger/index.html\\nStaging API: https://staging-api.genebygene.com\\nStaging auth: https://staging-auth.genebygene.com/connect/token\\n","version":"2.0","x-mockingbird-upstream":{"docs":"https://api.genebygene.com/assets/GxG%20API%20Services%20Developer%20Guide%202022.pdf","swagger":"https://api.genebygene.com/swagger/index.html","note":"Hand-authored subset from the public developer guide (products + orders + client_credentials token)."}},"servers":[{"url":"https://staging-api.genebygene.com"}],"security":[{"bearerAuth":[]}],"paths":{"/connect/token":{"post":{"operationId":"PostConnectToken","security":[],"x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"requestBody":{"required":true,"content":{"application/x-www-form-urlencoded":{"schema":{"type":"object","required":["grant_type","client_id","client_secret"],"properties":{"grant_type":{"type":"string","enum":["client_credentials"]},"client_id":{"type":"string","minLength":1},"client_secret":{"type":"string","minLength":1}}}}}},"responses":{"200":{"description":"Access token","content":{"application/json":{"schema":{"$ref":"#/components/schemas/TokenResponse"}}}},"400":{"description":"Invalid grant","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}}}},"/api/v2/products":{"get":{"operationId":"GetProducts","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"responses":{"200":{"description":"Product list","content":{"application/json":{"schema":{"type":"array","items":{"$ref":"#/components/schemas/Product"}}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}}}},"/api/v2/orders":{"post":{"operationId":"PostOrders","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOrderBody"}}}},"responses":{"200":{"description":"Created order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}}}},"/api/v2/orders/{orderId}":{"get":{"operationId":"GetOrder","x-mockingbird":{"supported":true,"parity":{"enabled":true,"safe":true}},"parameters":[{"name":"orderId","in":"path","required":true,"schema":{"type":"string","x-mockingbird-resource-ref":{"type":"order","missing":"order_missing"}}}],"responses":{"200":{"description":"Order","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Order"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}},"404":{"description":"Not Found","content":{"application/json":{"schema":{"$ref":"#/components/schemas/ErrorBody"}}}}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer"}},"schemas":{"TokenResponse":{"type":"object","required":["access_token","token_type","expires_in"],"properties":{"access_token":{"type":"string","x-mockingbird-volatile":{"kind":"token"}},"token_type":{"type":"string","enum":["Bearer"]},"expires_in":{"type":"integer"}}},"Product":{"type":"object","required":["productId","name"],"properties":{"productId":{"type":"string","x-mockingbird-resource":{"type":"product","identity":true}},"name":{"type":"string"},"description":{"type":["string","null"]}}},"CreateOrderBody":{"type":"object","required":["productId","quantity"],"properties":{"productId":{"type":"string","x-mockingbird-resource-ref":{"type":"product","missing":"product_missing"}},"quantity":{"type":"integer","minimum":1,"maximum":100}}},"Order":{"type":"object","required":["orderId","status","quantity","productId","createdAt"],"properties":{"orderId":{"type":"string","x-mockingbird-resource":{"type":"order","identity":true},"x-mockingbird-volatile":{"kind":"id"}},"status":{"type":"string","enum":["Pending","Submitted","Completed","Cancelled"]},"quantity":{"type":"integer"},"productId":{"type":"string","x-mockingbird-resource-ref":{"type":"product","missing":"product_missing"}},"createdAt":{"type":"string","format":"date-time","x-mockingbird-volatile":{"kind":"timestamp"}}}},"ErrorBody":{"type":"object","properties":{"error":{"type":"string"},"error_description":{"type":"string"},"message":{"type":"string"}}}}}}`);
+export const operationIds = ["PostConnectToken", "GetProducts", "PostOrders", "GetOrder"];
+export const supportedOperationIds = ["PostConnectToken", "GetProducts", "PostOrders", "GetOrder"];
+//# sourceMappingURL=openapi.js.map

package/dist/generated/openapi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"openapi.js","sourceRoot":"","sources":["../../src/generated/openapi.ts"],"names":[],"mappings":"AAAA,oFAAoF;AAIpF,MAAM,CAAC,MAAM,QAAQ,GAAoB,IAAI,CAAC,KAAK,CAAC,6qJAA6qJ,CAAoB,CAAA;AAIrvJ,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,kBAAkB,EAAC,aAAa,EAAC,YAAY,EAAC,UAAU,CAAU,CAAA;AAC/F,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,kBAAkB,EAAC,aAAa,EAAC,YAAY,EAAC,UAAU,CAAU,CAAA"}

package/dist/handlers.d.ts

@@ -0,0 +1,9 @@
+import { type OperationContext } from "@crvouga/mockingbird-service";
+import type { GeneByGeneState } from "./state.js";
+export declare const geneByGeneHandlers: (state: GeneByGeneState) => {
+    PostConnectToken: (context: OperationContext) => Promise<Response>;
+    GetProducts: (context: OperationContext) => Promise<Response>;
+    PostOrders: (context: OperationContext) => Promise<Response>;
+    GetOrder: (context: OperationContext) => Promise<Response>;
+};
+//# sourceMappingURL=handlers.d.ts.map

package/dist/handlers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.d.ts","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"AAAA,OAAO,EAGL,KAAK,gBAAgB,EAEtB,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AA0CjD,eAAO,MAAM,kBAAkB,GAAI,OAAO,eAAe;gCACrB,gBAAgB;2BAsBrB,gBAAgB;0BAOjB,gBAAgB;wBAyBlB,gBAAgB;CAO1C,CAAA"}

package/dist/handlers.js

@@ -0,0 +1,98 @@
+import { HttpError, jsonRes, opaqueToken, } from "@crvouga/mockingbird-service";
+const requireBearer = (context) => {
+    const auth = context.request.headers.get("authorization");
+    if (!auth?.toLowerCase().startsWith("bearer ")) {
+        throw new HttpError(401, { error: "unauthorized", message: "Bearer token required" });
+    }
+};
+const jsonBody = (context) => {
+    if (context.body.kind !== "json" ||
+        typeof context.body.value !== "object" ||
+        context.body.value === null) {
+        throw new HttpError(400, { message: "expected a JSON object body" });
+    }
+    return context.body.value;
+};
+const formBody = (context) => {
+    if (context.body.kind === "form") {
+        const out = {};
+        for (const [key, value] of Object.entries(context.body.value)) {
+            if (typeof value === "string")
+                out[key] = value;
+        }
+        return out;
+    }
+    if (context.body.kind === "json" &&
+        typeof context.body.value === "object" &&
+        context.body.value) {
+        const out = {};
+        for (const [key, value] of Object.entries(context.body.value)) {
+            if (typeof value === "string")
+                out[key] = value;
+        }
+        return out;
+    }
+    throw new HttpError(400, { error: "invalid_request", error_description: "expected form body" });
+};
+export const geneByGeneHandlers = (state) => ({
+    PostConnectToken: async (context) => {
+        const body = formBody(context);
+        if (body.grant_type !== "client_credentials") {
+            throw new HttpError(400, {
+                error: "unsupported_grant_type",
+                error_description: "grant_type must be client_credentials",
+            });
+        }
+        if (!body.client_id || !body.client_secret) {
+            throw new HttpError(400, {
+                error: "invalid_client",
+                error_description: "client_id and client_secret are required",
+            });
+        }
+        const token = opaqueToken(`gbg:${body.client_id}:${body.client_secret}`, 32);
+        return jsonRes(200, {
+            access_token: token,
+            token_type: "Bearer",
+            expires_in: 3600,
+        });
+    },
+    GetProducts: async (context) => {
+        requireBearer(context);
+        state.ensureSeedProducts();
+        const products = state.products.list({ order: "oldest" }).map((row) => row.value);
+        return jsonRes(200, products);
+    },
+    PostOrders: async (context) => {
+        requireBearer(context);
+        const body = jsonBody(context);
+        const productId = body.productId;
+        const quantity = body.quantity;
+        if (typeof productId !== "string")
+            throw new HttpError(400, { message: "productId is required" });
+        if (typeof quantity !== "number" || !Number.isInteger(quantity) || quantity < 1) {
+            throw new HttpError(400, { message: "quantity must be a positive integer" });
+        }
+        if (!state.products.has(productId)) {
+            throw new HttpError(400, { message: `unknown productId ${productId}` });
+        }
+        const orderId = state.nextOrderId();
+        const order = {
+            orderId,
+            status: "Pending",
+            quantity,
+            productId,
+            createdAt: state.isoNow(context.now),
+        };
+        state.orders.insert(orderId, order);
+        return jsonRes(200, order);
+    },
+    GetOrder: async (context) => {
+        requireBearer(context);
+        const id = context.params.orderId ?? "";
+        const order = state.orders.get(id);
+        if (!order)
+            throw new HttpError(404, { message: "order not found" });
+        return jsonRes(200, order);
+    },
+});
+//# sourceMappingURL=handlers.js.map

package/dist/handlers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handlers.js","sourceRoot":"","sources":["../src/handlers.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,23 @@
+import type { FetchAPI } from "@crvouga/mockingbird-core";
+import { type APIOptions } from "@crvouga/mockingbird-service";
+import type { SqliteClient } from "@crvouga/mockingbird-sqlite";
+import type { Hono } from "hono";
+export type { OperationId, SupportedOperationId } from "./generated/openapi.js";
+export { document, operationIds, supportedOperationIds } from "./generated/openapi.js";
+export declare const GENEBYGENE_NAMESPACE = "genebygene";
+/**
+ * Stateful mock of the GeneByGene Nucleus API (token + products + orders).
+ *
+ * Developer guide: https://api.genebygene.com/assets/GxG%20API%20Services%20Developer%20Guide%202022.pdf
+ * Swagger: https://api.genebygene.com/swagger/index.html
+ */
+export declare class GeneByGeneAPI implements FetchAPI {
+    readonly app: Hono;
+    readonly sqlite: SqliteClient;
+    private readonly service;
+    private readonly state;
+    constructor(options?: APIOptions);
+    fetch(request: Request): Promise<Response>;
+    reset(): Promise<void>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,2BAA2B,CAAA;AACzD,OAAO,EACL,KAAK,UAAU,EAOhB,MAAM,8BAA8B,CAAA;AACrC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAC/D,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,MAAM,CAAA;AAKhC,YAAY,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAA;AAC/E,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAEtF,eAAO,MAAM,oBAAoB,eAAe,CAAA;AAEhD;;;;;GAKG;AACH,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAA;IAClB,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiB;gBAE3B,OAAO,GAAE,UAAe;IAsBpC,KAAK,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAIpC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAI7B"}

package/dist/index.js

@@ -0,0 +1,48 @@
+import { bootSqlite, createService, defineOperations, HttpError, jsonRes, } from "@crvouga/mockingbird-service";
+import { document } from "./generated/openapi.js";
+import { geneByGeneHandlers } from "./handlers.js";
+import { GeneByGeneState } from "./state.js";
+export { document, operationIds, supportedOperationIds } from "./generated/openapi.js";
+export const GENEBYGENE_NAMESPACE = "genebygene";
+/**
+ * Stateful mock of the GeneByGene Nucleus API (token + products + orders).
+ *
+ * Developer guide: https://api.genebygene.com/assets/GxG%20API%20Services%20Developer%20Guide%202022.pdf
+ * Swagger: https://api.genebygene.com/swagger/index.html
+ */
+export class GeneByGeneAPI {
+    app;
+    sqlite;
+    service;
+    state;
+    constructor(options = {}) {
+        const sqlite = bootSqlite(options.sqlite);
+        this.state = new GeneByGeneState(sqlite, GENEBYGENE_NAMESPACE);
+        const handlers = defineOperations({
+            ...geneByGeneHandlers(this.state),
+        });
+        this.service = createService({
+            document,
+            handlers,
+            sqlite,
+            namespace: GENEBYGENE_NAMESPACE,
+            now: options.now,
+            notFound: () => jsonRes(404, { message: "Not Found" }),
+            onError: (error) => {
+                if (error instanceof HttpError)
+                    return error.toResponse();
+                throw error;
+            },
+        });
+        this.app = this.service.app;
+        this.sqlite = this.service.sqlite;
+    }
+    fetch(request) {
+        return this.service.fetch(request);
+    }
+    async reset() {
+        await this.service.reset();
+        this.state.ensureSeedProducts();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,UAAU,EACV,aAAa,EACb,gBAAgB,EAChB,SAAS,EACT,OAAO,GAER,MAAM,8BAA8B,CAAA;AAGrC,OAAO,EAAE,QAAQ,EAA6B,MAAM,wBAAwB,CAAA;AAC5E,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAA;AAClD,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAG5C,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAA;AAEtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,YAAY,CAAA;AAEhD;;;;;GAKG;AACH,MAAM,OAAO,aAAa;IACf,GAAG,CAAM;IACT,MAAM,CAAc;IACZ,OAAO,CAAS;IAChB,KAAK,CAAiB;IAEvC,YAAY,UAAsB,EAAE;QAClC,MAAM,MAAM,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAA;QACzC,IAAI,CAAC,KAAK,GAAG,IAAI,eAAe,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAA;QAC9D,MAAM,QAAQ,GAAG,gBAAgB,CAAuB;YACtD,GAAG,kBAAkB,CAAC,IAAI,CAAC,KAAK,CAAC;SAClC,CAAC,CAAA;QACF,IAAI,CAAC,OAAO,GAAG,aAAa,CAAC;YAC3B,QAAQ;YACR,QAAQ;YACR,MAAM;YACN,SAAS,EAAE,oBAAoB;YAC/B,GAAG,EAAE,OAAO,CAAC,GAAG;YAChB,QAAQ,EAAE,GAAG,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC;YACtD,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;gBACjB,IAAI,KAAK,YAAY,SAAS;oBAAE,OAAO,KAAK,CAAC,UAAU,EAAE,CAAA;gBACzD,MAAM,KAAK,CAAA;YACb,CAAC;SACF,CAAC,CAAA;QACF,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAA;QAC3B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,OAAO,CAAC,MAAM,CAAA;IACnC,CAAC;IAED,KAAK,CAAC,OAAgB;QACpB,OAAO,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;IACpC,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAA;QAC1B,IAAI,CAAC,KAAK,CAAC,kBAAkB,EAAE,CAAA;IACjC,CAAC;CACF"}

package/dist/state.d.ts

@@ -0,0 +1,25 @@
+import { Collection, IdSequence } from "@crvouga/mockingbird-service";
+import type { SqliteClient } from "@crvouga/mockingbird-sqlite";
+export type ProductRecord = {
+    productId: string;
+    name: string;
+    description: string | null;
+};
+export type OrderRecord = {
+    orderId: string;
+    status: "Pending" | "Submitted" | "Completed" | "Cancelled";
+    quantity: number;
+    productId: string;
+    createdAt: string;
+};
+export declare class GeneByGeneState {
+    readonly products: Collection<ProductRecord>;
+    readonly orders: Collection<OrderRecord>;
+    readonly ids: IdSequence;
+    constructor(sqlite: SqliteClient, namespace: string);
+    /** Sandbox always exposes at least one catalog product. */
+    ensureSeedProducts(): void;
+    nextOrderId(): string;
+    isoNow(now: () => number): string;
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AACrE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAE/D,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAE,MAAM,CAAA;IACjB,IAAI,EAAE,MAAM,CAAA;IACZ,WAAW,EAAE,MAAM,GAAG,IAAI,CAAA;CAC3B,CAAA;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,WAAW,GAAG,WAAW,CAAA;IAC3D,QAAQ,EAAE,MAAM,CAAA;IAChB,SAAS,EAAE,MAAM,CAAA;IACjB,SAAS,EAAE,MAAM,CAAA;CAClB,CAAA;AAED,qBAAa,eAAe;IAC1B,QAAQ,CAAC,QAAQ,EAAE,UAAU,CAAC,aAAa,CAAC,CAAA;IAC5C,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,WAAW,CAAC,CAAA;IACxC,QAAQ,CAAC,GAAG,EAAE,UAAU,CAAA;gBAEZ,MAAM,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM;IAOnD,2DAA2D;IAC3D,kBAAkB;IASlB,WAAW,IAAI,MAAM;IAIrB,MAAM,CAAC,GAAG,EAAE,MAAM,MAAM,GAAG,MAAM;CAGlC"}

package/dist/state.js

@@ -0,0 +1,29 @@
+import { Collection, IdSequence } from "@crvouga/mockingbird-service";
+export class GeneByGeneState {
+    products;
+    orders;
+    ids;
+    constructor(sqlite, namespace) {
+        this.products = new Collection(sqlite, namespace, "products");
+        this.orders = new Collection(sqlite, namespace, "orders");
+        this.ids = new IdSequence(sqlite, namespace, "genebygene");
+        this.ensureSeedProducts();
+    }
+    /** Sandbox always exposes at least one catalog product. */
+    ensureSeedProducts() {
+        if (this.products.list().length > 0)
+            return;
+        this.products.insert("product_default", {
+            productId: "product_default",
+            name: "Mockingbird Default Kit",
+            description: "Seed product for GeneByGene mock",
+        });
+    }
+    nextOrderId() {
+        return this.ids.next("order_");
+    }
+    isoNow(now) {
+        return new Date(now()).toISOString();
+    }
+}
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,8BAA8B,CAAA;AAiBrE,MAAM,OAAO,eAAe;IACjB,QAAQ,CAA2B;IACnC,MAAM,CAAyB;IAC/B,GAAG,CAAY;IAExB,YAAY,MAAoB,EAAE,SAAiB;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,CAAA;QAC7D,IAAI,CAAC,MAAM,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,QAAQ,CAAC,CAAA;QACzD,IAAI,CAAC,GAAG,GAAG,IAAI,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,YAAY,CAAC,CAAA;QAC1D,IAAI,CAAC,kBAAkB,EAAE,CAAA;IAC3B,CAAC;IAED,2DAA2D;IAC3D,kBAAkB;QAChB,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC;YAAE,OAAM;QAC3C,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,iBAAiB,EAAE;YACtC,SAAS,EAAE,iBAAiB;YAC5B,IAAI,EAAE,yBAAyB;YAC/B,WAAW,EAAE,kCAAkC;SAChD,CAAC,CAAA;IACJ,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IAChC,CAAC;IAED,MAAM,CAAC,GAAiB;QACtB,OAAO,IAAI,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;IACtC,CAAC;CACF"}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@crvouga/mockingbird-service-genebygene",
+  "version": "0.1.0",
+  "description": "Stateful mock of the GeneByGene Nucleus API (token, products, orders) verified by differential property tests against the GeneByGene staging sandbox.",
+  "license": "MIT",
+  "type": "module",
+  "sideEffects": false,
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/crvouga/mockingbird.git",
+    "directory": "packages/service/genebygene"
+  },
+  "homepage": "https://github.com/crvouga/mockingbird/tree/main/packages/service/genebygene#readme",
+  "keywords": [
+    "mockingbird",
+    "service",
+    "genebygene"
+  ],
+  "mockingbird": {
+    "runtime": "portable",
+    "layer": "service"
+  },
+  "scripts": {
+    "generate": "bun ../../openapi/codegen/dist/cli.js",
+    "generate:check": "bun ../../openapi/codegen/dist/cli.js --check",
+    "openapi:check": "bun ../../openapi/codegen/dist/cli.js --validate",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "lint": "biome check .",
+    "test": "bun test",
+    "parity": "bun scripts/parity.ts",
+    "portability": "bun ../../../scripts/portability.ts",
+    "pack:check": "bun ../../../scripts/pack-check.ts"
+  },
+  "dependencies": {
+    "@crvouga/mockingbird-core": "0.0.0-development",
+    "@crvouga/mockingbird-sqlite": "0.0.0-development",
+    "@crvouga/mockingbird-openapi": "0.0.0-development",
+    "@crvouga/mockingbird-service": "0.0.0-development",
+    "@crvouga/mockingbird-http-codec": "0.0.0-development",
+    "hono": "4.11.9"
+  },
+  "devDependencies": {
+    "fast-check": "4.9.0",
+    "@crvouga/mockingbird-testing": "0.1.0",
+    "@crvouga/mockingbird-service-sqlite": "0.0.0-development",
+    "@crvouga/mockingbird-parity": "0.0.0-development",
+    "@crvouga/mockingbird-openbao": "0.0.0-development",
+    "@crvouga/mockingbird-openapi-codegen": "0.1.0",
+    "@crvouga/mockingbird-openapi-metadata": "0.0.0-development"
+  }
+}