@crvouga/mockingbird-service-twilio 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,5 @@
+# Changelog — @crvouga/mockingbird-service-twilio
+
+## 0.1.0 (2026-09-22)
+
+Initial release.

package/README.md

@@ -0,0 +1,181 @@
+# @crvouga/mockingbird-service-twilio
+
+Stateful mock of **Twilio** for test suites: Lookup v2 phone validation, Verify v2 phone OTP
+(with the real state machine: wrong codes, attempt limits, 10-minute expiry on the mock clock),
+Programmable Messaging with an outbox, and call Recordings. It also signs and posts Twilio's
+inbound SMS and voice webhooks to your app. Every product is served on one port. A suite reads the
+OTP from the admin plane instead of bypassing verification (`E2E_OTP_BYPASS_*`).
+
+- Operation coverage: [SUPPORT.md](https://github.com/crvouga/mockingbird/blob/main/packages/service/twilio/SUPPORT.md)
+- The contract (`openapi.yaml`) is trimmed from Twilio's API reference to what our consumer
+  calls. Lookup v2 responses are checked byte for byte against the live API
+  (`scripts/parity.ts`, recorded in `test/fixtures/lookups.live.json`).
+
+## Install
+
+```bash
+npm install -D @crvouga/mockingbird-service-twilio
+```
+
+ESM only. Node >= 22 or Bun >= 1.2. Lookup validation uses `libphonenumber-js` (Twilio's
+Lookup is libphonenumber). Serve it with `npx mockingbird-twilio serve`, with `createServer`
+from `./server` (Node), or with `createRuntime` in any Fetch server.
+
+## Usage
+
+```bash
+npx mockingbird-twilio serve --port 8798 \
+  --app-url http://127.0.0.1:3000 \
+  --public-base-url "$TWILIO_VOICE_WEBHOOK_BASE_URL" \
+  --account-sid "$TWILIO_ACCOUNT_SID" --auth-token "$TWILIO_AUTH_TOKEN" \
+  --caller-id "$TWILIO_VOICE_CALLER_ID"
+```
+
+### Pointing the app at it (G-T1)
+
+twilio-node builds a host for each product (`api.twilio.com`, `verify.twilio.com`,
+`lookups.twilio.com`). The mock takes that host as the first path segment:
+`{mock}/api/2010-04-01/…`, `{mock}/verify/v2/…`, `{mock}/lookups/v2/…`. Pass every
+`new Twilio(...)` an `httpClient` that rewrites the URL. `twilioMockUrl` does the rewrite:
+
+```js
+import { RequestClient, Twilio } from "twilio"
+import { twilioMockUrl } from "@crvouga/mockingbird-service-twilio"
+
+/** https://verify.twilio.com/v2/Services/VA…/Verifications → {base}/verify/v2/Services/VA…/Verifications */
+class MockRequestClient extends RequestClient {
+  constructor(baseUrl) {
+    super()
+    this.baseUrl = baseUrl
+  }
+  request(opts) {
+    return super.request({ ...opts, uri: twilioMockUrl(opts.uri, this.baseUrl) })
+  }
+}
+
+const { TWILIO_ACCOUNT_SID, TWILIO_AUTH_TOKEN } = process.env
+const base = process.env.TWILIO_API_BASE_URL // e.g. http://127.0.0.1:8798
+const client = new Twilio(
+  TWILIO_ACCOUNT_SID,
+  TWILIO_AUTH_TOKEN,
+  base ? { httpClient: new MockRequestClient(base) } : {},
+)
+```
+
+The mock also routes by the `Host` header. A request that reaches it as `lookups.twilio.com`
+(through a DNS override or a proxy) and has no prefix is served as `/lookups/…`. The recording
+adapter's raw `fetch` of `https://api.twilio.com/2010-04-01/…` becomes
+`twilioMockUrl(url, TWILIO_API_BASE_URL)`. `RecordingUrl` in webhooks keeps the canonical
+`https://api.twilio.com` form that the adapter checks.
+
+### Reading the OTP in a test
+
+```ts
+import { createRuntime } from "@crvouga/mockingbird-service-twilio"
+
+const twilio = createRuntime()
+// …the app calls verify.v2.services(VA).verifications.create({ to, channel: "sms" })…
+const latest = await twilio.fetch(new Request("http://twilio.test/__admin/verify/+12025550123/latest"))
+const { code, sid, status } = (await latest.json()) as { code: string; sid: string; status: string }
+// …the app calls verificationChecks.create({ verificationSid: sid, code }) → status "approved"
+```
+
+### Routes
+
+| Route | Behaviour |
+| --- | --- |
+| `GET /lookups/v2/PhoneNumbers/{PhoneNumber}` | Validates the number the way the live API does (libphonenumber): `valid`, `validation_errors` (`TOO_SHORT`, `TOO_LONG`, `INVALID_BUT_POSSIBLE`, `INVALID_COUNTRY_CODE`, `INVALID_LENGTH`, `NOT_A_NUMBER`), `phone_number`, `national_format`, `calling_country_code`, `country_code`, `url`. Every data package is `null`. A national number with no `CountryCode` must be a valid US number, otherwise the answer is `INVALID_COUNTRY_CODE`. Fictional 555-01xx numbers are valid. |
+| `POST /verify/v2/Services/{VA}/Verifications` | `To` (valid E.164, or an email for `Channel=email`), `Channel`, optional `CustomCode`. Creates a `VE…` verification with a 6-digit code (or `fixedCode`). Sending again to the same pending verification keeps its sid and code and adds a `send_code_attempts` entry. The 6th send to one number within 10 minutes is 429 `60203`. A bad `To` is 400 `60200`. An unknown service sid (not `VA` + 32 hex) is 404 `20404`. |
+| `POST /verify/v2/Services/{VA}/VerificationCheck` | `Code` plus `VerificationSid` or `To`. The right code returns 200 `approved`, `valid: true`. A wrong code returns 200 `pending` and counts an attempt. The 6th check is 429 `60202`. A missing, approved, canceled or expired (10 minutes on the mock clock) verification is 404 `20404`. |
+| `GET` / `POST /verify/v2/Services/{VA}/Verifications/{VE}` | Fetches a verification, or sets `Status=canceled\|approved` on one. |
+| `POST /api/2010-04-01/Accounts/{AC}/Messages.json` | `To`, `Body` or `MediaUrl`, and `From` or `MessagingServiceSid`. Returns 201 with an `SM…` sid (`MM…` with media), status `queued` (or `accepted` through a Messaging Service), and RFC 2822 dates. Errors: 21604 (no To), 21602 (no Body), 21603 (no From), 21211 (invalid To), 21617 (over 1600 characters). The message is recorded in the outbox. |
+| `GET /api/2010-04-01/Accounts/{AC}/Messages/{SM}.json` | Reads a message back. |
+| `GET /api/2010-04-01/Accounts/{AC}/Recordings/{RE}.wav` | The recording as a RIFF WAV. With `RequestedChannels=2` you get both channels. Otherwise a dual-channel recording is mixed down to mono, as Twilio does. |
+| `GET` / `DELETE /api/2010-04-01/Accounts/{AC}/Recordings/{RE}.json` | Metadata, or a delete (204; a second delete is 404, which our consumer tolerates). |
+
+Errors use Twilio's body, `{code, message, more_info, status}`, with `X-Twilio-Error-Code`.
+Authentication is HTTP Basic: an `AC…` (or `SK…`) username and a non-empty password. With
+`accounts` (or `--account-sid` plus `--auth-token`) only those pairs are accepted. A missing or
+wrong credential is 401 `20003`. For a wrong token the message matches the live one:
+`authentication failed, auth token is not valid for account AC…`.
+
+### Webhooks (S8.4)
+
+The mock signs inbound webhooks with `X-Twilio-Signature`. The signature is base64
+HMAC-SHA1(auth token, public URL + sorted `key+value` params), the same computation as
+`twilio.validateRequest`. It signs against the **public base URL the app is configured with**
+(`--public-base-url`, i.e. `TWILIO_VOICE_WEBHOOK_BASE_URL`), not the localhost address it posts
+to. Twilio does not retry these webhooks, so the mock sends each one once.
+
+| Trigger | Posts to | Payload |
+| --- | --- | --- |
+| `POST /__admin/inbound/sms {from, body, to?, media?, messageSid?, params?}` | `/messaging/inbound/sms` | `MessageSid`/`SmsSid` (`SM…`, or `MM…` with media), `AccountSid`, `From`, `To` (default: `--caller-id`), `Body`, `NumMedia`, `MediaUrl{i}`, `MediaContentType{i}`, `SmsStatus=received`, … |
+| `POST /__admin/voice/twiml` | `/admin/messaging/voice/twiml` | `CallSid`, `From=client:<uuid>`, `To`, `CallStatus=ringing` plus the body's fields (e.g. `conversationId`) |
+| `POST /__admin/voice/disclosure` | `/admin/messaging/voice/disclosure` | `CallSid`, `CallStatus=in-progress` |
+| `POST /__admin/voice/status` | `/admin/messaging/voice/status` | `CallSid`, `CallStatus=completed`, `CallDuration` |
+| `POST /__admin/voice/recording` | `/admin/messaging/voice/recording` | `RecordingSid`, canonical `RecordingUrl`, `RecordingStatus=completed`, `RecordingDuration`, `RecordingChannels=2`. It also stores a dual-channel WAV so the download works. |
+
+Every body field overrides a default. The admin answer lists each delivery with the app's status
+and response body (e.g. `<Response/>`). Event types for `PUT /__admin/webhook-endpoints`
+filters are `sms.inbound` and `voice.{twiml,disclosure,status,recording}`.
+
+### Admin (beyond the standard contract)
+
+| Route | Effect |
+| --- | --- |
+| `GET /__admin/verify/:e164/latest` | `{code, sid, status, to, channel, serviceSid, attempts, sendAttempts, createdAt, expiresAt}` for the newest verification to that number. This is how a test reads the OTP. |
+| `GET` / `PUT /__admin/verify` | `{fixedCode: "000000" \| null, ttlSeconds, maxCheckAttempts, maxSendAttempts, sendWindowSeconds}` for the calling namespace. |
+| `PUT /__admin/lookups/:e164` | `{valid, validationErrors?}` overrides Lookup for that number (Verify and Messages use it too). `DELETE` removes the override. |
+| `PUT /__admin/recordings/:RE` | Uploads a recording: a raw WAV body (`content-type: audio/wav`), `{"wavBase64": …}`, or `{channels?, seconds?}` for a synthesised 8 kHz 16-bit tone. |
+| `GET /__admin/outbox?to=&since=&kind=sms\|verify` | Everything "sent": SMS (`{to, from, messagingServiceSid, body, sid}`) and every Verify code delivery (`{code, body: "Your verification code is: …"}`). |
+| `GET /__admin/messages` | Message resources in the namespace. |
+
+Fault presets (`POST /__admin/faults {"preset": "<name>", "count"?: n}`; list them with `GET /__admin/faults/presets`):
+`verify_5xx` (start and check answer 500 `20500`), `sms_socket_drop` (Messages.json drops the
+connection, an unknown outcome), `sms_4xx` (400 `21211`), `lookup_5xx` (503 `20503`; the EMR
+fails open), `webhook_duplicate`, `webhook_drop`.
+
+### Namespaces
+
+The Twilio SDK cannot add headers, so a suite picks a namespace by **AccountSid**:
+`PUT /__admin/credentials {"credentials": {"<TWILIO_ACCOUNT_SID>": "<namespace>"}}`. A namespace
+can also come from the `x-mockingbird-namespace` header or a `/ns/<name>` prefix on the base URL
+(`twilioMockUrl` keeps the prefix).
+
+### Deliberately not modelled
+
+- Delivery: messages stay `queued`/`accepted`, no status callbacks are sent (our consumer sets no
+  `statusCallback`), and no voice calls, conferences or media streams happen.
+- Paid Lookup data packages (`Fields=line_type_intelligence`, `caller_name`, …) are always
+  `null`.
+- Verify channels other than SMS are accepted and recorded, but nothing is delivered. Verify
+  Service configuration (code length, friendly name, rate-limit buckets) is global, set with
+  `PUT /__admin/verify`.
+- "Sent, then the socket dropped": `sms_socket_drop` drops before the message is recorded.
+- Accounts: any `AC…` sid is its own account, and the path's `{AccountSid}` is not
+  cross-checked against the credential.
+- libphonenumber-js drops "local only" lengths from its metadata. The mock restores them for
+  NANP (7) and GB (4–6, 8), which is enough for the fictional numbers tests use. Other countries
+  may answer `TOO_SHORT` where Twilio answers `INVALID_BUT_POSSIBLE`.
+
+## API
+
+| Export | Kind | Description |
+| --- | --- | --- |
+| `TwilioAPI` | class | The in-process mock: `fetch(request)`, `reset()`, `latestVerification(to)`, `resolveLookup(raw, country?)`, `setLookup(e164, override)`, `putRecording(sid, input)`, `outbox()`, `messages()`. Options: `sqlite`, `now`, `namespace`, `verify`, `accounts`. |
+| `createRuntime` | function | The mock with the full service contract (health, admin, namespaces, credentials, presets, outbox, webhooks), plus host routing. Options: `app: {url, publicBaseUrl?, authToken, accountSid?, callerId?, messagingServiceSid?}`, `verify`, `accounts`, `retryDelaysMs`, `fetch`, `clock`, `seed`, `adminKey`, `onLog`. The returned runtime also has `inboundSms(input)` and `voiceWebhook(kind, params)`. |
+| `TWILIO_PRESETS` | object | Every named fault preset. |
+| `TWILIO_WEBHOOK_EVENTS` | object | Webhook event type → the app path it posts to. |
+| `twilioMockUrl` | function | Rewrites an upstream `https://<product>.twilio.com/…` URL onto a mock base URL (for the G-T1 `httpClient`). |
+| `TWILIO_PRODUCTS` | array | The product prefixes served: `api`, `verify`, `lookups`. |
+| `lookup` | function | Lookup v2 validation of a raw input (optionally in a `CountryCode` region). |
+| `e164Key` | function | `+` and digits: the key that admin overrides use. |
+| `twilioError` | function | A Twilio error response, `{code, message, more_info, status}`. |
+| `DEFAULT_VERIFY_SETTINGS` | object | Verify defaults: 10-minute expiry, 5 checks, 5 sends per 10 minutes, random codes. |
+| `DEFAULT_ACCOUNT_SID` | string | The account used when the credential is an API key. |
+| `TWILIO_NAMESPACE` | string | The service name, `"twilio"`. |
+| `synthesizeWav`, `readWav`, `mixDownToMono` | functions | Make a PCM WAV, read its format, mix a multi-channel WAV down to mono. |
+| `document`, `operationIds`, `supportedOperationIds` | values | The vendored OpenAPI contract and its operation ids. |
+| `createServer`, `serveTarget`, `DEFAULT_PORT` (`./server`) | Node | Serve over `node:http`; the `serve` CLI target; port 8798. |
+
+Part of [mockingbird](https://github.com/crvouga/mockingbird).

package/dist/chunk-37HPXDSK.js

@@ -0,0 +1,388 @@
+import {
+  createRuntime
+} from "./chunk-VOBVFMYN.js";
+
+// ../../adapters/node/dist/cli.js
+import { readFile } from "node:fs/promises";
+import { parseArgs } from "node:util";
+
+// ../../adapters/node/dist/serve.js
+import { createServer } from "node:http";
+var serve = async (api, options = {}) => {
+  const server = createServer(async (req, res) => {
+    const chunks = [];
+    for await (const chunk of req) {
+      chunks.push(Buffer.from(chunk));
+    }
+    const body = Buffer.concat(chunks);
+    const address = server.address();
+    const port = typeof address === "object" && address !== null ? address.port : void 0;
+    const base = `http://${req.headers.host ?? `localhost:${port ?? 80}`}`;
+    const raw = req.url ?? "/";
+    const url = new URL(raw.replace(/^\/+/, "/"), base);
+    const method = req.method ?? "GET";
+    const init = { method, headers: req.headers };
+    if (method !== "GET" && method !== "HEAD" && body.length > 0) {
+      init.body = body;
+    }
+    const aborted = new AbortController();
+    res.once("close", () => {
+      if (!res.writableFinished)
+        aborted.abort();
+    });
+    init.signal = aborted.signal;
+    const request = new Request(url, init);
+    let response;
+    try {
+      response = await api.fetch(request);
+    } catch (error) {
+      if (error.code === "MOCKINGBIRD_DROP") {
+        req.socket.destroy();
+        return;
+      }
+      res.writeHead(500, { "content-type": "application/json" });
+      res.end(JSON.stringify({
+        error: {
+          type: "mockingbird_internal",
+          message: error instanceof Error ? error.message : String(error)
+        }
+      }));
+      return;
+    }
+    const headers = Object.fromEntries(response.headers);
+    const cookies = response.headers.getSetCookie();
+    if (cookies.length > 0)
+      headers["set-cookie"] = cookies;
+    if (!response.body) {
+      res.writeHead(response.status, headers);
+      res.end();
+      return;
+    }
+    res.writeHead(response.status, headers);
+    res.flushHeaders();
+    const reader = response.body.getReader();
+    try {
+      for (; ; ) {
+        const { done, value } = await reader.read();
+        if (done)
+          break;
+        if (!res.write(value))
+          await new Promise((resolve) => res.once("drain", resolve));
+      }
+      res.end();
+    } catch {
+      res.destroy();
+    } finally {
+      reader.releaseLock();
+    }
+  });
+  await new Promise((resolve, reject) => {
+    server.once("error", reject);
+    server.listen(options.port ?? 0, options.host, resolve);
+  });
+  return server;
+};
+
+// ../../adapters/node/dist/listen.js
+var listen = async (api, options = {}) => {
+  const host = options.host ?? "127.0.0.1";
+  const server = await serve(api, { port: options.port ?? 0, host });
+  const address = server.address();
+  const port = typeof address === "object" && address !== null ? address.port : options.port ?? 0;
+  const shown = host.includes(":") ? `[${host}]` : host;
+  return {
+    url: `http://${shown}:${port}`,
+    port,
+    host,
+    server,
+    close: () => new Promise((resolve, reject) => {
+      server.close((error) => {
+        if (error && error.code !== "ERR_SERVER_NOT_RUNNING")
+          reject(error);
+        else
+          resolve();
+      });
+      server.closeAllConnections?.();
+    })
+  };
+};
+
+// ../../adapters/node/dist/cli.js
+var optionHelp = (options) => Object.entries(options).map(([name, option]) => {
+  const flag = `--${name}${option.type === "string" ? ` ${option.value ?? "<value>"}` : ""}`;
+  const fallback = option.default !== void 0 ? ` (default: ${String(option.default)})` : "";
+  return `  ${flag.padEnd(30)} ${option.description}${fallback}`;
+});
+var help = (spec) => [
+  `${spec.bin} \u2014 ${spec.description}`,
+  "",
+  "Usage:",
+  `  ${spec.bin} <command> [options]`,
+  "",
+  "Commands:",
+  ...Object.entries(spec.commands).map(([name, c]) => `  ${name.padEnd(30)} ${c.summary}`),
+  "",
+  `Run \`${spec.bin} <command> --help\` for a command's options.`
+].join("\n");
+var commandHelp = (spec, name, command) => [
+  `${spec.bin} ${name} \u2014 ${command.summary}`,
+  "",
+  "Usage:",
+  `  ${command.usage ?? `${spec.bin} ${name} [options]`}`,
+  ...command.options ? ["", "Options:", ...optionHelp(command.options)] : []
+].join("\n");
+var runCli = async (spec, argv) => {
+  const pair = argv.length >= 2 ? `${argv[0]} ${argv[1]}` : void 0;
+  const words = pair !== void 0 && spec.commands[pair] ? 2 : 1;
+  const name = words === 2 ? pair : argv[0];
+  const rest = argv.slice(words);
+  if (name === void 0 || name === "--help" || name === "-h" || name === "help") {
+    console.log(help(spec));
+    return 0;
+  }
+  const command = spec.commands[name];
+  if (!command) {
+    console.error(`${spec.bin}: unknown command ${JSON.stringify(name)}
+
+${help(spec)}`);
+    return 2;
+  }
+  if (rest.includes("--help") || rest.includes("-h")) {
+    console.log(commandHelp(spec, name, command));
+    return 0;
+  }
+  let parsed;
+  try {
+    parsed = parseArgs({
+      args: rest,
+      allowPositionals: true,
+      strict: true,
+      options: Object.fromEntries(Object.entries(command.options ?? {}).map(([key, option]) => [
+        key,
+        {
+          type: option.type,
+          ...option.default !== void 0 ? { default: option.default } : {}
+        }
+      ]))
+    });
+  } catch (error) {
+    console.error(`${spec.bin} ${name}: ${error instanceof Error ? error.message : String(error)}
+
+${commandHelp(spec, name, command)}`);
+    return 2;
+  }
+  return command.run(parsed.values, parsed.positionals);
+};
+var COMMON_SERVE_OPTIONS = {
+  port: { type: "string", value: "<port>", description: "Port to listen on" },
+  host: { type: "string", value: "<host>", description: "Interface to bind", default: "127.0.0.1" },
+  "admin-key": {
+    type: "string",
+    value: "<key>",
+    description: "Require x-mockingbird-admin-key on /__admin/* (env MOCKINGBIRD_ADMIN_KEY)"
+  },
+  seed: { type: "string", value: "<seed>", description: "Seed for every random choice" },
+  log: {
+    type: "string",
+    value: "<pretty|json|off>",
+    description: "Request log format",
+    default: "pretty"
+  },
+  "log-requests": {
+    type: "boolean",
+    description: "One JSON line per request: namespace, operationId, status, ids touched (never bodies). Same as --log json"
+  },
+  config: {
+    type: "string",
+    value: "<file>",
+    description: "Serve every service in a mockingbird.json config instead"
+  }
+};
+var formatLog = (format) => {
+  if (format === "off")
+    return void 0;
+  if (format === "json")
+    return (entry) => console.log(JSON.stringify(entry));
+  return (entry) => {
+    const op = entry.operationId ?? (entry.unmatched ? "UNMATCHED" : "-");
+    const ns = entry.namespace === "default" ? "" : ` [${entry.namespace}]`;
+    const fault = entry.faultId ? ` fault=${entry.faultId}` : "";
+    const adopted = entry.adopted ? " adopted" : "";
+    console.log(`${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}`);
+  };
+};
+var asString = (value) => typeof value === "string" ? value : void 0;
+var loadTarget = async (name, own) => {
+  if (name === own.name)
+    return own;
+  const specifier = `@crvouga/mockingbird-service-${name}/server`;
+  try {
+    const mod = await import(specifier);
+    if (!mod.serveTarget)
+      throw new Error(`${specifier} exports no serveTarget`);
+    return mod.serveTarget;
+  } catch (error) {
+    const reason = error instanceof Error ? error.message : String(error);
+    throw new Error(`cannot load service "${name}": ${reason}. Install @crvouga/mockingbird-service-${name}.`);
+  }
+};
+var start = async (target, values, config) => {
+  const runtime = await target.create(values, {
+    adminKey: config.adminKey,
+    seed: config.seed,
+    onLog: formatLog(config.log)
+  });
+  const listening = await listen(runtime, { port: config.port, host: config.host });
+  console.log(`${target.name} mock listening on ${listening.url}`);
+  console.log(`${target.name} health: GET ${listening.url}/health`);
+  console.log(`${target.name} admin: ${listening.url}/__admin (${config.adminKey ? "x-mockingbird-admin-key required" : "open \u2014 pass --admin-key to lock"})`);
+  for (const line of target.banner?.(runtime) ?? [])
+    console.log(`${target.name} ${line}`);
+  return listening;
+};
+var untilSignal = async (servers) => new Promise((resolve) => {
+  const stop = async () => {
+    await Promise.allSettled(servers.map((s) => s.close()));
+    resolve(0);
+  };
+  process.once("SIGINT", stop);
+  process.once("SIGTERM", stop);
+});
+var serveCommand = (target) => ({
+  summary: `Serve the ${target.name} mock over HTTP`,
+  options: { ...COMMON_SERVE_OPTIONS, ...target.options },
+  async run(values) {
+    const log = values["log-requests"] === true ? "json" : asString(values.log) ?? "pretty";
+    if (!["pretty", "json", "off"].includes(log)) {
+      console.error(`--log must be pretty, json or off (got ${log})`);
+      return 2;
+    }
+    const configPath = asString(values.config);
+    if (configPath !== void 0) {
+      const config = JSON.parse(await readFile(configPath, "utf8"));
+      const servers = [];
+      try {
+        for (const [name, entry] of Object.entries(config.services ?? {})) {
+          const each = await loadTarget(name, target);
+          servers.push(await start(each, entry.options ?? {}, {
+            port: entry.port ?? each.defaultPort,
+            host: entry.host ?? "127.0.0.1",
+            ...entry.adminKey !== void 0 ? { adminKey: entry.adminKey } : {},
+            ...entry.seed !== void 0 ? { seed: entry.seed } : {},
+            log: config.log ?? log
+          }));
+        }
+      } catch (error) {
+        await Promise.allSettled(servers.map((s) => s.close()));
+        console.error(error instanceof Error ? error.message : String(error));
+        return 1;
+      }
+      return untilSignal(servers);
+    }
+    const port = asString(values.port);
+    const adminKey = asString(values["admin-key"]) ?? process.env.MOCKINGBIRD_ADMIN_KEY;
+    const seed = asString(values.seed);
+    let listening;
+    try {
+      listening = await start(target, values, {
+        port: port === void 0 ? target.defaultPort : Number.parseInt(port, 10),
+        host: asString(values.host) ?? "127.0.0.1",
+        ...adminKey !== void 0 ? { adminKey } : {},
+        ...seed !== void 0 ? { seed } : {},
+        log
+      });
+    } catch (error) {
+      console.error(error instanceof Error ? error.message : String(error));
+      return 1;
+    }
+    return untilSignal([listening]);
+  }
+});
+
+// src/server.ts
+var DEFAULT_PORT = 8798;
+var createServer2 = async (options = {}) => {
+  const { port, host, ...rest } = options;
+  const runtime = createRuntime(rest);
+  const listening = await listen(runtime, {
+    port: port ?? 0,
+    ...host !== void 0 ? { host } : {}
+  });
+  return { ...listening, runtime };
+};
+var text = (value) => typeof value === "string" ? value : void 0;
+var serveTarget = {
+  name: "twilio",
+  defaultPort: DEFAULT_PORT,
+  options: {
+    "app-url": {
+      type: "string",
+      value: "<url>",
+      description: "Post inbound SMS and voice webhooks to this app origin (e.g. http://127.0.0.1:3000)"
+    },
+    "public-base-url": {
+      type: "string",
+      value: "<url>",
+      description: "Sign webhooks against this base (the app's TWILIO_VOICE_WEBHOOK_BASE_URL)"
+    },
+    "account-sid": {
+      type: "string",
+      value: "<AC\u2026>",
+      description: "The app's TWILIO_ACCOUNT_SID (AccountSid in webhooks)"
+    },
+    "auth-token": {
+      type: "string",
+      value: "<token>",
+      description: "The app's TWILIO_AUTH_TOKEN: signs webhooks, and with --account-sid is the only accepted token"
+    },
+    "caller-id": {
+      type: "string",
+      value: "<+1\u2026>",
+      description: "To of inbound SMS (the app's TWILIO_VOICE_CALLER_ID)"
+    },
+    "fixed-code": {
+      type: "string",
+      value: "<digits>",
+      description: "Every Verify code is this (default: random 6 digits, read via /__admin)"
+    }
+  },
+  create: (values, common) => {
+    const appUrl = text(values["app-url"]);
+    const accountSid = text(values["account-sid"]);
+    const authToken = text(values["auth-token"]);
+    const publicBaseUrl = text(values["public-base-url"]);
+    const callerId = text(values["caller-id"]);
+    const fixedCode = text(values["fixed-code"]);
+    if (appUrl && !authToken) throw new Error("--app-url needs --auth-token (the signing key)");
+    return createRuntime({
+      ...appUrl && authToken ? {
+        app: {
+          url: appUrl,
+          authToken,
+          ...publicBaseUrl ? { publicBaseUrl } : {},
+          ...accountSid ? { accountSid } : {},
+          ...callerId ? { callerId } : {}
+        }
+      } : {},
+      ...accountSid && authToken ? { accounts: { [accountSid]: authToken } } : {},
+      ...fixedCode ? { verify: { fixedCode } } : {},
+      ...common.adminKey !== void 0 ? { adminKey: common.adminKey } : {},
+      ...common.seed !== void 0 ? { seed: common.seed } : {},
+      ...common.onLog ? { onLog: common.onLog } : {}
+    });
+  },
+  banner: () => [
+    "routes: /lookups/v2/\u2026, /verify/v2/\u2026, /api/2010-04-01/\u2026 (the Twilio host as a path prefix)",
+    "auth: Basic AccountSid:AuthToken; OTP: GET /__admin/verify/<e164>/latest",
+    "namespaces: x-mockingbird-namespace, /ns/<name>/\u2026, or PUT /__admin/credentials {<AccountSid>: <ns>}"
+  ]
+};
+
+export {
+  runCli,
+  serveCommand,
+  DEFAULT_PORT,
+  createServer2 as createServer,
+  serveTarget
+};
+//# sourceMappingURL=chunk-37HPXDSK.js.map

package/dist/chunk-37HPXDSK.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../adapters/node/src/cli.ts", "../../../adapters/node/src/serve.ts", "../../../adapters/node/src/listen.ts", "../src/server.ts"],
+  "sourcesContent": ["import { readFile } from \"node:fs/promises\"\nimport { type ParseArgsConfig, parseArgs } from \"node:util\"\nimport type { RequestLog, ServiceInstance, ServiceRuntime } from \"@crvouga/mockingbird-service\"\nimport { type Listening, listen } from \"./listen.js\"\n\nexport type CliOption = {\n  type: \"string\" | \"boolean\"\n  description: string\n  /** Shown in help; the value placeholder, e.g. `<port>`. */\n  value?: string\n  default?: string | boolean\n}\n\nexport type CliValues = Record<string, string | boolean | undefined>\n\nexport type CliCommand = {\n  summary: string\n  usage?: string\n  options?: Record<string, CliOption>\n  /** Resolves to an exit code; a server command resolves only when it stops. */\n  run(values: CliValues, positionals: string[]): Promise<number>\n}\n\nexport type CliSpec = {\n  bin: string\n  description: string\n  commands: Record<string, CliCommand>\n}\n\nconst optionHelp = (options: Record<string, CliOption>): string[] =>\n  Object.entries(options).map(([name, option]) => {\n    const flag = `--${name}${option.type === \"string\" ? ` ${option.value ?? \"<value>\"}` : \"\"}`\n    const fallback = option.default !== undefined ? ` (default: ${String(option.default)})` : \"\"\n    return `  ${flag.padEnd(30)} ${option.description}${fallback}`\n  })\n\nconst help = (spec: CliSpec): string =>\n  [\n    `${spec.bin} \u2014 ${spec.description}`,\n    \"\",\n    \"Usage:\",\n    `  ${spec.bin} <command> [options]`,\n    \"\",\n    \"Commands:\",\n    ...Object.entries(spec.commands).map(([name, c]) => `  ${name.padEnd(30)} ${c.summary}`),\n    \"\",\n    `Run \\`${spec.bin} <command> --help\\` for a command's options.`,\n  ].join(\"\\n\")\n\nconst commandHelp = (spec: CliSpec, name: string, command: CliCommand): string =>\n  [\n    `${spec.bin} ${name} \u2014 ${command.summary}`,\n    \"\",\n    \"Usage:\",\n    `  ${command.usage ?? `${spec.bin} ${name} [options]`}`,\n    ...(command.options ? [\"\", \"Options:\", ...optionHelp(command.options)] : []),\n  ].join(\"\\n\")\n\n/** Parse `argv` against `spec` and run the chosen command. Resolves to an exit code. */\nexport const runCli = async (spec: CliSpec, argv: string[]): Promise<number> => {\n  // Two-word commands (`corpus pull`) win over one-word ones.\n  const pair = argv.length >= 2 ? `${argv[0]} ${argv[1]}` : undefined\n  const words = pair !== undefined && spec.commands[pair] ? 2 : 1\n  const name = words === 2 ? pair : argv[0]\n  const rest = argv.slice(words)\n  if (name === undefined || name === \"--help\" || name === \"-h\" || name === \"help\") {\n    console.log(help(spec))\n    return 0\n  }\n  const command = spec.commands[name]\n  if (!command) {\n    console.error(`${spec.bin}: unknown command ${JSON.stringify(name)}\\n\\n${help(spec)}`)\n    return 2\n  }\n  if (rest.includes(\"--help\") || rest.includes(\"-h\")) {\n    console.log(commandHelp(spec, name, command))\n    return 0\n  }\n  let parsed: { values: CliValues; positionals: string[] }\n  try {\n    parsed = parseArgs({\n      args: rest,\n      allowPositionals: true,\n      strict: true,\n      options: Object.fromEntries(\n        Object.entries(command.options ?? {}).map(([key, option]) => [\n          key,\n          {\n            type: option.type,\n            ...(option.default !== undefined ? { default: option.default } : {}),\n          },\n        ]),\n      ) as ParseArgsConfig[\"options\"],\n    }) as { values: CliValues; positionals: string[] }\n  } catch (error) {\n    console.error(\n      `${spec.bin} ${name}: ${error instanceof Error ? error.message : String(error)}\\n\\n${commandHelp(spec, name, command)}`,\n    )\n    return 2\n  }\n  return command.run(parsed.values, parsed.positionals)\n}\n\n// \u2500\u2500 serve \u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\u2500\n\nexport type LogFormat = \"pretty\" | \"json\" | \"off\"\n\nexport type CommonServeOptions = {\n  adminKey: string | undefined\n  seed: string | undefined\n  onLog: ((entry: RequestLog) => void) | undefined\n}\n\n/**\n * What a service contributes to `serve`: how to build its runtime from CLI flags,\n * and what to say at startup. Every service's `./server` entry exports one as\n * `serveTarget`, which is also how `serve --config` finds services by name.\n */\nexport type ServeTarget = {\n  name: string\n  defaultPort: number\n  /** Serve flags beyond the common ones. */\n  options?: Record<string, CliOption>\n  create(\n    values: CliValues,\n    common: CommonServeOptions,\n  ): Promise<ServiceRuntime<ServiceInstance>> | ServiceRuntime<ServiceInstance>\n  /** Startup lines after the listen address, e.g. the loaded corpus version. */\n  banner?(runtime: ServiceRuntime<ServiceInstance>): string[]\n}\n\nconst COMMON_SERVE_OPTIONS: Record<string, CliOption> = {\n  port: { type: \"string\", value: \"<port>\", description: \"Port to listen on\" },\n  host: { type: \"string\", value: \"<host>\", description: \"Interface to bind\", default: \"127.0.0.1\" },\n  \"admin-key\": {\n    type: \"string\",\n    value: \"<key>\",\n    description: \"Require x-mockingbird-admin-key on /__admin/* (env MOCKINGBIRD_ADMIN_KEY)\",\n  },\n  seed: { type: \"string\", value: \"<seed>\", description: \"Seed for every random choice\" },\n  log: {\n    type: \"string\",\n    value: \"<pretty|json|off>\",\n    description: \"Request log format\",\n    default: \"pretty\",\n  },\n  \"log-requests\": {\n    type: \"boolean\",\n    description:\n      \"One JSON line per request: namespace, operationId, status, ids touched (never bodies). Same as --log json\",\n  },\n  config: {\n    type: \"string\",\n    value: \"<file>\",\n    description: \"Serve every service in a mockingbird.json config instead\",\n  },\n}\n\nconst formatLog = (format: LogFormat) => {\n  if (format === \"off\") return undefined\n  if (format === \"json\") return (entry: RequestLog) => console.log(JSON.stringify(entry))\n  return (entry: RequestLog) => {\n    const op = entry.operationId ?? (entry.unmatched ? \"UNMATCHED\" : \"-\")\n    const ns = entry.namespace === \"default\" ? \"\" : ` [${entry.namespace}]`\n    const fault = entry.faultId ? ` fault=${entry.faultId}` : \"\"\n    const adopted = entry.adopted ? \" adopted\" : \"\"\n    console.log(\n      `${entry.service} ${entry.method} ${entry.path} ${entry.status} ${op} ${entry.durationMs}ms${ns}${fault}${adopted}`,\n    )\n  }\n}\n\nconst asString = (value: string | boolean | undefined): string | undefined =>\n  typeof value === \"string\" ? value : undefined\n\n/** A service entry in `mockingbird.json`. */\nexport type ConfigService = {\n  port?: number\n  host?: string\n  adminKey?: string\n  seed?: string\n  /** Service-specific serve flags, by long name: `{ \"webhook-url\": \"\u2026\" }`. */\n  options?: Record<string, string | boolean>\n}\n\nexport type MockingbirdConfig = {\n  /** Keyed by service name: `junction` loads `@crvouga/mockingbird-service-junction`. */\n  services: Record<string, ConfigService>\n  log?: LogFormat\n}\n\nconst loadTarget = async (name: string, own: ServeTarget): Promise<ServeTarget> => {\n  if (name === own.name) return own\n  const specifier = `@crvouga/mockingbird-service-${name}/server`\n  try {\n    const mod = (await import(specifier)) as { serveTarget?: ServeTarget }\n    if (!mod.serveTarget) throw new Error(`${specifier} exports no serveTarget`)\n    return mod.serveTarget\n  } catch (error) {\n    const reason = error instanceof Error ? error.message : String(error)\n    throw new Error(\n      `cannot load service \"${name}\": ${reason}. Install @crvouga/mockingbird-service-${name}.`,\n    )\n  }\n}\n\nconst start = async (\n  target: ServeTarget,\n  values: CliValues,\n  config: { port: number; host: string; adminKey?: string; seed?: string; log: LogFormat },\n): Promise<Listening> => {\n  const runtime = await target.create(values, {\n    adminKey: config.adminKey,\n    seed: config.seed,\n    onLog: formatLog(config.log),\n  })\n  const listening = await listen(runtime, { port: config.port, host: config.host })\n  console.log(`${target.name} mock listening on ${listening.url}`)\n  console.log(`${target.name} health: GET ${listening.url}/health`)\n  console.log(\n    `${target.name} admin: ${listening.url}/__admin (${config.adminKey ? \"x-mockingbird-admin-key required\" : \"open \u2014 pass --admin-key to lock\"})`,\n  )\n  for (const line of target.banner?.(runtime) ?? []) console.log(`${target.name} ${line}`)\n  return listening\n}\n\nconst untilSignal = async (servers: Listening[]): Promise<number> =>\n  new Promise((resolve) => {\n    const stop = async () => {\n      await Promise.allSettled(servers.map((s) => s.close()))\n      resolve(0)\n    }\n    process.once(\"SIGINT\", stop)\n    process.once(\"SIGTERM\", stop)\n  })\n\n/** The standard `serve` command for a service, including multi-service `--config`. */\nexport const serveCommand = (target: ServeTarget): CliCommand => ({\n  summary: `Serve the ${target.name} mock over HTTP`,\n  options: { ...COMMON_SERVE_OPTIONS, ...target.options },\n  async run(values) {\n    const log = (\n      values[\"log-requests\"] === true ? \"json\" : (asString(values.log) ?? \"pretty\")\n    ) as LogFormat\n    if (![\"pretty\", \"json\", \"off\"].includes(log)) {\n      console.error(`--log must be pretty, json or off (got ${log})`)\n      return 2\n    }\n    const configPath = asString(values.config)\n    if (configPath !== undefined) {\n      const config = JSON.parse(await readFile(configPath, \"utf8\")) as MockingbirdConfig\n      const servers: Listening[] = []\n      try {\n        for (const [name, entry] of Object.entries(config.services ?? {})) {\n          const each = await loadTarget(name, target)\n          servers.push(\n            await start(each, entry.options ?? {}, {\n              port: entry.port ?? each.defaultPort,\n              host: entry.host ?? \"127.0.0.1\",\n              ...(entry.adminKey !== undefined ? { adminKey: entry.adminKey } : {}),\n              ...(entry.seed !== undefined ? { seed: entry.seed } : {}),\n              log: config.log ?? log,\n            }),\n          )\n        }\n      } catch (error) {\n        await Promise.allSettled(servers.map((s) => s.close()))\n        console.error(error instanceof Error ? error.message : String(error))\n        return 1\n      }\n      return untilSignal(servers)\n    }\n    const port = asString(values.port)\n    const adminKey = asString(values[\"admin-key\"]) ?? process.env.MOCKINGBIRD_ADMIN_KEY\n    const seed = asString(values.seed)\n    let listening: Listening\n    try {\n      listening = await start(target, values, {\n        port: port === undefined ? target.defaultPort : Number.parseInt(port, 10),\n        host: asString(values.host) ?? \"127.0.0.1\",\n        ...(adminKey !== undefined ? { adminKey } : {}),\n        ...(seed !== undefined ? { seed } : {}),\n        log,\n      })\n    } catch (error) {\n      console.error(error instanceof Error ? error.message : String(error))\n      return 1\n    }\n    return untilSignal([listening])\n  },\n})\n", "import { createServer } from \"node:http\"\nimport type { FetchAPI } from \"@crvouga/mockingbird-core\"\n\n/** Options for {@link serve}. */\nexport type NodeServeOptions = {\n  port?: number\n  host?: string\n}\n\n/**\n * Serve any Mockingbird {@link FetchAPI} over `node:http`.\n * Port defaults to `0`, so the OS assigns an ephemeral port (read from `server.address()`).\n */\nexport const serve = async (api: FetchAPI, options: NodeServeOptions = {}) => {\n  const server = createServer(async (req, res) => {\n    const chunks: Buffer[] = []\n    for await (const chunk of req) {\n      chunks.push(Buffer.from(chunk))\n    }\n    const body = Buffer.concat(chunks)\n    const address = server.address()\n    const port = typeof address === \"object\" && address !== null ? address.port : undefined\n    const base = `http://${req.headers.host ?? `localhost:${port ?? 80}`}`\n    const raw = req.url ?? \"/\"\n    const url = new URL(raw.replace(/^\\/+/, \"/\"), base)\n    const method = req.method ?? \"GET\"\n    const init: RequestInit = { method, headers: req.headers as Record<string, string> }\n    if (method !== \"GET\" && method !== \"HEAD\" && body.length > 0) {\n      init.body = body\n    }\n    const aborted = new AbortController()\n    res.once(\"close\", () => {\n      if (!res.writableFinished) aborted.abort()\n    })\n    init.signal = aborted.signal\n    const request = new Request(url, init)\n    let response: Response\n    try {\n      response = await api.fetch(request)\n    } catch (error) {\n      // A `drop` fault: destroy the socket so the client sees the connection die.\n      if ((error as { code?: string }).code === \"MOCKINGBIRD_DROP\") {\n        req.socket.destroy()\n        return\n      }\n      res.writeHead(500, { \"content-type\": \"application/json\" })\n      res.end(\n        JSON.stringify({\n          error: {\n            type: \"mockingbird_internal\",\n            message: error instanceof Error ? error.message : String(error),\n          },\n        }),\n      )\n      return\n    }\n    // Headers#entries() joins repeated headers; Set-Cookie must stay one header per cookie.\n    const headers: Record<string, string | string[]> = Object.fromEntries(response.headers)\n    const cookies = response.headers.getSetCookie()\n    if (cookies.length > 0) headers[\"set-cookie\"] = cookies\n    if (!response.body) {\n      res.writeHead(response.status, headers)\n      res.end()\n      return\n    }\n    // Stream the body chunk by chunk: event streams and long-polls must not be buffered.\n    res.writeHead(response.status, headers)\n    res.flushHeaders()\n    const reader = response.body.getReader()\n    try {\n      for (;;) {\n        const { done, value } = await reader.read()\n        if (done) break\n        if (!res.write(value)) await new Promise<void>((resolve) => res.once(\"drain\", resolve))\n      }\n      res.end()\n    } catch {\n      res.destroy()\n    } finally {\n      reader.releaseLock()\n    }\n  })\n  await new Promise<void>((resolve, reject) => {\n    server.once(\"error\", reject)\n    server.listen(options.port ?? 0, options.host, resolve)\n  })\n  return server\n}\n", "import type { Server } from \"node:http\"\nimport type { FetchAPI } from \"@crvouga/mockingbird-core\"\nimport { serve } from \"./serve.js\"\n\nexport type ListenOptions = {\n  /** Default `0`: the OS picks a free port. */\n  port?: number\n  /** Default `127.0.0.1`: a mock should not be reachable off the machine by accident. */\n  host?: string\n}\n\n/** A running server, with the address it actually bound. */\nexport type Listening = {\n  url: string\n  port: number\n  host: string\n  server: Server\n  close(): Promise<void>\n}\n\nexport const listen = async (api: FetchAPI, options: ListenOptions = {}): Promise<Listening> => {\n  const host = options.host ?? \"127.0.0.1\"\n  const server = await serve(api, { port: options.port ?? 0, host })\n  const address = server.address()\n  const port = typeof address === \"object\" && address !== null ? address.port : (options.port ?? 0)\n  const shown = host.includes(\":\") ? `[${host}]` : host\n  return {\n    url: `http://${shown}:${port}`,\n    port,\n    host,\n    server,\n    close: () =>\n      new Promise<void>((resolve, reject) => {\n        // Stop accepting first, then drop keep-alive sockets so close() can finish.\n        server.close((error) => {\n          if (error && (error as { code?: string }).code !== \"ERR_SERVER_NOT_RUNNING\") reject(error)\n          else resolve()\n        })\n        server.closeAllConnections?.()\n      }),\n  }\n}\n", "/// <reference types=\"node\" />\nimport { type Listening, listen, type ServeTarget } from \"@crvouga/mockingbird-adapter-node\"\nimport { createRuntime, type TwilioRuntime, type TwilioRuntimeOptions } from \"./runtime.js\"\n\n/** Port `mockingbird-twilio serve` listens on when none is given. */\nexport const DEFAULT_PORT = 8798\n\nexport type TwilioServerOptions = TwilioRuntimeOptions & {\n  /** Default `0`: the OS picks a free port. */\n  port?: number\n  /** Default `127.0.0.1`. */\n  host?: string\n}\n\nexport type TwilioServer = Listening & { runtime: TwilioRuntime }\n\n/** Serve the Twilio mock over `node:http`. */\nexport const createServer = async (options: TwilioServerOptions = {}): Promise<TwilioServer> => {\n  const { port, host, ...rest } = options\n  const runtime = createRuntime(rest)\n  const listening = await listen(runtime, {\n    port: port ?? 0,\n    ...(host !== undefined ? { host } : {}),\n  })\n  return { ...listening, runtime }\n}\n\nconst text = (value: string | boolean | undefined) =>\n  typeof value === \"string\" ? value : undefined\n\n/** How `serve` (and `serve --config`) builds the Twilio mock from flags. */\nexport const serveTarget: ServeTarget = {\n  name: \"twilio\",\n  defaultPort: DEFAULT_PORT,\n  options: {\n    \"app-url\": {\n      type: \"string\",\n      value: \"<url>\",\n      description:\n        \"Post inbound SMS and voice webhooks to this app origin (e.g. http://127.0.0.1:3000)\",\n    },\n    \"public-base-url\": {\n      type: \"string\",\n      value: \"<url>\",\n      description: \"Sign webhooks against this base (the app's TWILIO_VOICE_WEBHOOK_BASE_URL)\",\n    },\n    \"account-sid\": {\n      type: \"string\",\n      value: \"<AC\u2026>\",\n      description: \"The app's TWILIO_ACCOUNT_SID (AccountSid in webhooks)\",\n    },\n    \"auth-token\": {\n      type: \"string\",\n      value: \"<token>\",\n      description:\n        \"The app's TWILIO_AUTH_TOKEN: signs webhooks, and with --account-sid is the only accepted token\",\n    },\n    \"caller-id\": {\n      type: \"string\",\n      value: \"<+1\u2026>\",\n      description: \"To of inbound SMS (the app's TWILIO_VOICE_CALLER_ID)\",\n    },\n    \"fixed-code\": {\n      type: \"string\",\n      value: \"<digits>\",\n      description: \"Every Verify code is this (default: random 6 digits, read via /__admin)\",\n    },\n  },\n  create: (values, common) => {\n    const appUrl = text(values[\"app-url\"])\n    const accountSid = text(values[\"account-sid\"])\n    const authToken = text(values[\"auth-token\"])\n    const publicBaseUrl = text(values[\"public-base-url\"])\n    const callerId = text(values[\"caller-id\"])\n    const fixedCode = text(values[\"fixed-code\"])\n    if (appUrl && !authToken) throw new Error(\"--app-url needs --auth-token (the signing key)\")\n    return createRuntime({\n      ...(appUrl && authToken\n        ? {\n            app: {\n              url: appUrl,\n              authToken,\n              ...(publicBaseUrl ? { publicBaseUrl } : {}),\n              ...(accountSid ? { accountSid } : {}),\n              ...(callerId ? { callerId } : {}),\n            },\n          }\n        : {}),\n      ...(accountSid && authToken ? { accounts: { [accountSid]: authToken } } : {}),\n      ...(fixedCode ? { verify: { fixedCode } } : {}),\n      ...(common.adminKey !== undefined ? { adminKey: common.adminKey } : {}),\n      ...(common.seed !== undefined ? { seed: common.seed } : {}),\n      ...(common.onLog ? { onLog: common.onLog } : {}),\n    })\n  },\n  banner: () => [\n    \"routes: /lookups/v2/\u2026, /verify/v2/\u2026, /api/2010-04-01/\u2026 (the Twilio host as a path prefix)\",\n    \"auth: Basic AccountSid:AuthToken; OTP: GET /__admin/verify/<e164>/latest\",\n    \"namespaces: x-mockingbird-namespace, /ns/<name>/\u2026, or PUT /__admin/credentials {<AccountSid>: <ns>}\",\n  ],\n}\n"],
+  "mappings": ";;;;;AAAA,SAAS,gBAAgB;AACzB,SAA+B,iBAAiB;;;ACDhD,SAAS,oBAAoB;AAatB,IAAM,QAAQ,OAAO,KAAe,UAA4B,CAAA,MAAM;AAC3E,QAAM,SAAS,aAAa,OAAO,KAAK,QAAO;AAC7C,UAAM,SAAmB,CAAA;AACzB,qBAAiB,SAAS,KAAK;AAC7B,aAAO,KAAK,OAAO,KAAK,KAAK,CAAC;IAChC;AACA,UAAM,OAAO,OAAO,OAAO,MAAM;AACjC,UAAM,UAAU,OAAO,QAAO;AAC9B,UAAM,OAAO,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAO;AAC9E,UAAM,OAAO,UAAU,IAAI,QAAQ,QAAQ,aAAa,QAAQ,EAAE,EAAE;AACpE,UAAM,MAAM,IAAI,OAAO;AACvB,UAAM,MAAM,IAAI,IAAI,IAAI,QAAQ,QAAQ,GAAG,GAAG,IAAI;AAClD,UAAM,SAAS,IAAI,UAAU;AAC7B,UAAM,OAAoB,EAAE,QAAQ,SAAS,IAAI,QAAiC;AAClF,QAAI,WAAW,SAAS,WAAW,UAAU,KAAK,SAAS,GAAG;AAC5D,WAAK,OAAO;IACd;AACA,UAAM,UAAU,IAAI,gBAAe;AACnC,QAAI,KAAK,SAAS,MAAK;AACrB,UAAI,CAAC,IAAI;AAAkB,gBAAQ,MAAK;IAC1C,CAAC;AACD,SAAK,SAAS,QAAQ;AACtB,UAAM,UAAU,IAAI,QAAQ,KAAK,IAAI;AACrC,QAAI;AACJ,QAAI;AACF,iBAAW,MAAM,IAAI,MAAM,OAAO;IACpC,SAAS,OAAO;AAEd,UAAK,MAA4B,SAAS,oBAAoB;AAC5D,YAAI,OAAO,QAAO;AAClB;MACF;AACA,UAAI,UAAU,KAAK,EAAE,gBAAgB,mBAAkB,CAAE;AACzD,UAAI,IACF,KAAK,UAAU;QACb,OAAO;UACL,MAAM;UACN,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;;OAEjE,CAAC;AAEJ;IACF;AAEA,UAAM,UAA6C,OAAO,YAAY,SAAS,OAAO;AACtF,UAAM,UAAU,SAAS,QAAQ,aAAY;AAC7C,QAAI,QAAQ,SAAS;AAAG,cAAQ,YAAY,IAAI;AAChD,QAAI,CAAC,SAAS,MAAM;AAClB,UAAI,UAAU,SAAS,QAAQ,OAAO;AACtC,UAAI,IAAG;AACP;IACF;AAEA,QAAI,UAAU,SAAS,QAAQ,OAAO;AACtC,QAAI,aAAY;AAChB,UAAM,SAAS,SAAS,KAAK,UAAS;AACtC,QAAI;AACF,iBAAS;AACP,cAAM,EAAE,MAAM,MAAK,IAAK,MAAM,OAAO,KAAI;AACzC,YAAI;AAAM;AACV,YAAI,CAAC,IAAI,MAAM,KAAK;AAAG,gBAAM,IAAI,QAAc,CAAC,YAAY,IAAI,KAAK,SAAS,OAAO,CAAC;MACxF;AACA,UAAI,IAAG;IACT,QAAQ;AACN,UAAI,QAAO;IACb;AACE,aAAO,YAAW;IACpB;EACF,CAAC;AACD,QAAM,IAAI,QAAc,CAAC,SAAS,WAAU;AAC1C,WAAO,KAAK,SAAS,MAAM;AAC3B,WAAO,OAAO,QAAQ,QAAQ,GAAG,QAAQ,MAAM,OAAO;EACxD,CAAC;AACD,SAAO;AACT;;;ACnEO,IAAM,SAAS,OAAO,KAAe,UAAyB,CAAA,MAA0B;AAC7F,QAAM,OAAO,QAAQ,QAAQ;AAC7B,QAAM,SAAS,MAAM,MAAM,KAAK,EAAE,MAAM,QAAQ,QAAQ,GAAG,KAAI,CAAE;AACjE,QAAM,UAAU,OAAO,QAAO;AAC9B,QAAM,OAAO,OAAO,YAAY,YAAY,YAAY,OAAO,QAAQ,OAAQ,QAAQ,QAAQ;AAC/F,QAAM,QAAQ,KAAK,SAAS,GAAG,IAAI,IAAI,IAAI,MAAM;AACjD,SAAO;IACL,KAAK,UAAU,KAAK,IAAI,IAAI;IAC5B;IACA;IACA;IACA,OAAO,MACL,IAAI,QAAc,CAAC,SAAS,WAAU;AAEpC,aAAO,MAAM,CAAC,UAAS;AACrB,YAAI,SAAU,MAA4B,SAAS;AAA0B,iBAAO,KAAK;;AACpF,kBAAO;MACd,CAAC;AACD,aAAO,sBAAqB;IAC9B,CAAC;;AAEP;;;AFZA,IAAM,aAAa,CAAC,YAClB,OAAO,QAAQ,OAAO,EAAE,IAAI,CAAC,CAAC,MAAM,MAAM,MAAK;AAC7C,QAAM,OAAO,KAAK,IAAI,GAAG,OAAO,SAAS,WAAW,IAAI,OAAO,SAAS,SAAS,KAAK,EAAE;AACxF,QAAM,WAAW,OAAO,YAAY,SAAY,cAAc,OAAO,OAAO,OAAO,CAAC,MAAM;AAC1F,SAAO,KAAK,KAAK,OAAO,EAAE,CAAC,IAAI,OAAO,WAAW,GAAG,QAAQ;AAC9D,CAAC;AAEH,IAAM,OAAO,CAAC,SACZ;EACE,GAAG,KAAK,GAAG,WAAM,KAAK,WAAW;EACjC;EACA;EACA,KAAK,KAAK,GAAG;EACb;EACA;EACA,GAAG,OAAO,QAAQ,KAAK,QAAQ,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC,MAAM,KAAK,KAAK,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE;EACvF;EACA,SAAS,KAAK,GAAG;EACjB,KAAK,IAAI;AAEb,IAAM,cAAc,CAAC,MAAe,MAAc,YAChD;EACE,GAAG,KAAK,GAAG,IAAI,IAAI,WAAM,QAAQ,OAAO;EACxC;EACA;EACA,KAAK,QAAQ,SAAS,GAAG,KAAK,GAAG,IAAI,IAAI,YAAY;EACrD,GAAI,QAAQ,UAAU,CAAC,IAAI,YAAY,GAAG,WAAW,QAAQ,OAAO,CAAC,IAAI,CAAA;EACzE,KAAK,IAAI;AAGN,IAAM,SAAS,OAAO,MAAe,SAAmC;AAE7E,QAAM,OAAO,KAAK,UAAU,IAAI,GAAG,KAAK,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK;AAC1D,QAAM,QAAQ,SAAS,UAAa,KAAK,SAAS,IAAI,IAAI,IAAI;AAC9D,QAAM,OAAO,UAAU,IAAI,OAAO,KAAK,CAAC;AACxC,QAAM,OAAO,KAAK,MAAM,KAAK;AAC7B,MAAI,SAAS,UAAa,SAAS,YAAY,SAAS,QAAQ,SAAS,QAAQ;AAC/E,YAAQ,IAAI,KAAK,IAAI,CAAC;AACtB,WAAO;EACT;AACA,QAAM,UAAU,KAAK,SAAS,IAAI;AAClC,MAAI,CAAC,SAAS;AACZ,YAAQ,MAAM,GAAG,KAAK,GAAG,qBAAqB,KAAK,UAAU,IAAI,CAAC;;EAAO,KAAK,IAAI,CAAC,EAAE;AACrF,WAAO;EACT;AACA,MAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;AAClD,YAAQ,IAAI,YAAY,MAAM,MAAM,OAAO,CAAC;AAC5C,WAAO;EACT;AACA,MAAI;AACJ,MAAI;AACF,aAAS,UAAU;MACjB,MAAM;MACN,kBAAkB;MAClB,QAAQ;MACR,SAAS,OAAO,YACd,OAAO,QAAQ,QAAQ,WAAW,CAAA,CAAE,EAAE,IAAI,CAAC,CAAC,KAAK,MAAM,MAAM;QAC3D;QACA;UACE,MAAM,OAAO;UACb,GAAI,OAAO,YAAY,SAAY,EAAE,SAAS,OAAO,QAAO,IAAK,CAAA;;OAEpE,CAAC;KAEL;EACH,SAAS,OAAO;AACd,YAAQ,MACN,GAAG,KAAK,GAAG,IAAI,IAAI,KAAK,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;;EAAO,YAAY,MAAM,MAAM,OAAO,CAAC,EAAE;AAEzH,WAAO;EACT;AACA,SAAO,QAAQ,IAAI,OAAO,QAAQ,OAAO,WAAW;AACtD;AA8BA,IAAM,uBAAkD;EACtD,MAAM,EAAE,MAAM,UAAU,OAAO,UAAU,aAAa,oBAAmB;EACzE,MAAM,EAAE,MAAM,UAAU,OAAO,UAAU,aAAa,qBAAqB,SAAS,YAAW;EAC/F,aAAa;IACX,MAAM;IACN,OAAO;IACP,aAAa;;EAEf,MAAM,EAAE,MAAM,UAAU,OAAO,UAAU,aAAa,+BAA8B;EACpF,KAAK;IACH,MAAM;IACN,OAAO;IACP,aAAa;IACb,SAAS;;EAEX,gBAAgB;IACd,MAAM;IACN,aACE;;EAEJ,QAAQ;IACN,MAAM;IACN,OAAO;IACP,aAAa;;;AAIjB,IAAM,YAAY,CAAC,WAAqB;AACtC,MAAI,WAAW;AAAO,WAAO;AAC7B,MAAI,WAAW;AAAQ,WAAO,CAAC,UAAsB,QAAQ,IAAI,KAAK,UAAU,KAAK,CAAC;AACtF,SAAO,CAAC,UAAqB;AAC3B,UAAM,KAAK,MAAM,gBAAgB,MAAM,YAAY,cAAc;AACjE,UAAM,KAAK,MAAM,cAAc,YAAY,KAAK,KAAK,MAAM,SAAS;AACpE,UAAM,QAAQ,MAAM,UAAU,UAAU,MAAM,OAAO,KAAK;AAC1D,UAAM,UAAU,MAAM,UAAU,aAAa;AAC7C,YAAQ,IACN,GAAG,MAAM,OAAO,IAAI,MAAM,MAAM,IAAI,MAAM,IAAI,IAAI,MAAM,MAAM,IAAI,EAAE,IAAI,MAAM,UAAU,KAAK,EAAE,GAAG,KAAK,GAAG,OAAO,EAAE;EAEvH;AACF;AAEA,IAAM,WAAW,CAAC,UAChB,OAAO,UAAU,WAAW,QAAQ;AAkBtC,IAAM,aAAa,OAAO,MAAc,QAA0C;AAChF,MAAI,SAAS,IAAI;AAAM,WAAO;AAC9B,QAAM,YAAY,gCAAgC,IAAI;AACtD,MAAI;AACF,UAAM,MAAO,MAAM,OAAO;AAC1B,QAAI,CAAC,IAAI;AAAa,YAAM,IAAI,MAAM,GAAG,SAAS,yBAAyB;AAC3E,WAAO,IAAI;EACb,SAAS,OAAO;AACd,UAAM,SAAS,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK;AACpE,UAAM,IAAI,MACR,wBAAwB,IAAI,MAAM,MAAM,0CAA0C,IAAI,GAAG;EAE7F;AACF;AAEA,IAAM,QAAQ,OACZ,QACA,QACA,WACsB;AACtB,QAAM,UAAU,MAAM,OAAO,OAAO,QAAQ;IAC1C,UAAU,OAAO;IACjB,MAAM,OAAO;IACb,OAAO,UAAU,OAAO,GAAG;GAC5B;AACD,QAAM,YAAY,MAAM,OAAO,SAAS,EAAE,MAAM,OAAO,MAAM,MAAM,OAAO,KAAI,CAAE;AAChF,UAAQ,IAAI,GAAG,OAAO,IAAI,sBAAsB,UAAU,GAAG,EAAE;AAC/D,UAAQ,IAAI,GAAG,OAAO,IAAI,gBAAgB,UAAU,GAAG,SAAS;AAChE,UAAQ,IACN,GAAG,OAAO,IAAI,WAAW,UAAU,GAAG,aAAa,OAAO,WAAW,qCAAqC,sCAAiC,GAAG;AAEhJ,aAAW,QAAQ,OAAO,SAAS,OAAO,KAAK,CAAA;AAAI,YAAQ,IAAI,GAAG,OAAO,IAAI,IAAI,IAAI,EAAE;AACvF,SAAO;AACT;AAEA,IAAM,cAAc,OAAO,YACzB,IAAI,QAAQ,CAAC,YAAW;AACtB,QAAM,OAAO,YAAW;AACtB,UAAM,QAAQ,WAAW,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAK,CAAE,CAAC;AACtD,YAAQ,CAAC;EACX;AACA,UAAQ,KAAK,UAAU,IAAI;AAC3B,UAAQ,KAAK,WAAW,IAAI;AAC9B,CAAC;AAGI,IAAM,eAAe,CAAC,YAAqC;EAChE,SAAS,aAAa,OAAO,IAAI;EACjC,SAAS,EAAE,GAAG,sBAAsB,GAAG,OAAO,QAAO;EACrD,MAAM,IAAI,QAAM;AACd,UAAM,MACJ,OAAO,cAAc,MAAM,OAAO,SAAU,SAAS,OAAO,GAAG,KAAK;AAEtE,QAAI,CAAC,CAAC,UAAU,QAAQ,KAAK,EAAE,SAAS,GAAG,GAAG;AAC5C,cAAQ,MAAM,0CAA0C,GAAG,GAAG;AAC9D,aAAO;IACT;AACA,UAAM,aAAa,SAAS,OAAO,MAAM;AACzC,QAAI,eAAe,QAAW;AAC5B,YAAM,SAAS,KAAK,MAAM,MAAM,SAAS,YAAY,MAAM,CAAC;AAC5D,YAAM,UAAuB,CAAA;AAC7B,UAAI;AACF,mBAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,OAAO,YAAY,CAAA,CAAE,GAAG;AACjE,gBAAM,OAAO,MAAM,WAAW,MAAM,MAAM;AAC1C,kBAAQ,KACN,MAAM,MAAM,MAAM,MAAM,WAAW,CAAA,GAAI;YACrC,MAAM,MAAM,QAAQ,KAAK;YACzB,MAAM,MAAM,QAAQ;YACpB,GAAI,MAAM,aAAa,SAAY,EAAE,UAAU,MAAM,SAAQ,IAAK,CAAA;YAClE,GAAI,MAAM,SAAS,SAAY,EAAE,MAAM,MAAM,KAAI,IAAK,CAAA;YACtD,KAAK,OAAO,OAAO;WACpB,CAAC;QAEN;MACF,SAAS,OAAO;AACd,cAAM,QAAQ,WAAW,QAAQ,IAAI,CAAC,MAAM,EAAE,MAAK,CAAE,CAAC;AACtD,gBAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AACpE,eAAO;MACT;AACA,aAAO,YAAY,OAAO;IAC5B;AACA,UAAM,OAAO,SAAS,OAAO,IAAI;AACjC,UAAM,WAAW,SAAS,OAAO,WAAW,CAAC,KAAK,QAAQ,IAAI;AAC9D,UAAM,OAAO,SAAS,OAAO,IAAI;AACjC,QAAI;AACJ,QAAI;AACF,kBAAY,MAAM,MAAM,QAAQ,QAAQ;QACtC,MAAM,SAAS,SAAY,OAAO,cAAc,OAAO,SAAS,MAAM,EAAE;QACxE,MAAM,SAAS,OAAO,IAAI,KAAK;QAC/B,GAAI,aAAa,SAAY,EAAE,SAAQ,IAAK,CAAA;QAC5C,GAAI,SAAS,SAAY,EAAE,KAAI,IAAK,CAAA;QACpC;OACD;IACH,SAAS,OAAO;AACd,cAAQ,MAAM,iBAAiB,QAAQ,MAAM,UAAU,OAAO,KAAK,CAAC;AACpE,aAAO;IACT;AACA,WAAO,YAAY,CAAC,SAAS,CAAC;EAChC;;;;AG5RK,IAAM,eAAe;AAYrB,IAAMA,gBAAe,OAAO,UAA+B,CAAC,MAA6B;AAC9F,QAAM,EAAE,MAAM,MAAM,GAAG,KAAK,IAAI;AAChC,QAAM,UAAU,cAAc,IAAI;AAClC,QAAM,YAAY,MAAM,OAAO,SAAS;AAAA,IACtC,MAAM,QAAQ;AAAA,IACd,GAAI,SAAS,SAAY,EAAE,KAAK,IAAI,CAAC;AAAA,EACvC,CAAC;AACD,SAAO,EAAE,GAAG,WAAW,QAAQ;AACjC;AAEA,IAAM,OAAO,CAAC,UACZ,OAAO,UAAU,WAAW,QAAQ;AAG/B,IAAM,cAA2B;AAAA,EACtC,MAAM;AAAA,EACN,aAAa;AAAA,EACb,SAAS;AAAA,IACP,WAAW;AAAA,MACT,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,IACA,mBAAmB;AAAA,MACjB,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,eAAe;AAAA,MACb,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,cAAc;AAAA,MACZ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aACE;AAAA,IACJ;AAAA,IACA,aAAa;AAAA,MACX,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,IACA,cAAc;AAAA,MACZ,MAAM;AAAA,MACN,OAAO;AAAA,MACP,aAAa;AAAA,IACf;AAAA,EACF;AAAA,EACA,QAAQ,CAAC,QAAQ,WAAW;AAC1B,UAAM,SAAS,KAAK,OAAO,SAAS,CAAC;AACrC,UAAM,aAAa,KAAK,OAAO,aAAa,CAAC;AAC7C,UAAM,YAAY,KAAK,OAAO,YAAY,CAAC;AAC3C,UAAM,gBAAgB,KAAK,OAAO,iBAAiB,CAAC;AACpD,UAAM,WAAW,KAAK,OAAO,WAAW,CAAC;AACzC,UAAM,YAAY,KAAK,OAAO,YAAY,CAAC;AAC3C,QAAI,UAAU,CAAC,UAAW,OAAM,IAAI,MAAM,gDAAgD;AAC1F,WAAO,cAAc;AAAA,MACnB,GAAI,UAAU,YACV;AAAA,QACE,KAAK;AAAA,UACH,KAAK;AAAA,UACL;AAAA,UACA,GAAI,gBAAgB,EAAE,cAAc,IAAI,CAAC;AAAA,UACzC,GAAI,aAAa,EAAE,WAAW,IAAI,CAAC;AAAA,UACnC,GAAI,WAAW,EAAE,SAAS,IAAI,CAAC;AAAA,QACjC;AAAA,MACF,IACA,CAAC;AAAA,MACL,GAAI,cAAc,YAAY,EAAE,UAAU,EAAE,CAAC,UAAU,GAAG,UAAU,EAAE,IAAI,CAAC;AAAA,MAC3E,GAAI,YAAY,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,CAAC;AAAA,MAC7C,GAAI,OAAO,aAAa,SAAY,EAAE,UAAU,OAAO,SAAS,IAAI,CAAC;AAAA,MACrE,GAAI,OAAO,SAAS,SAAY,EAAE,MAAM,OAAO,KAAK,IAAI,CAAC;AAAA,MACzD,GAAI,OAAO,QAAQ,EAAE,OAAO,OAAO,MAAM,IAAI,CAAC;AAAA,IAChD,CAAC;AAAA,EACH;AAAA,EACA,QAAQ,MAAM;AAAA,IACZ;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;",
+  "names": ["createServer"]
+}