@copilotkit/aimock 1.37.4 → 1.39.0

package/dist/agui-types.d.cts

@@ -18,11 +18,13 @@ interface AGUIRunFinishedEvent extends AGUIBaseEvent {
   runId: string;
   result?: unknown;
   outcome?: AGUIRunFinishedOutcome;
+  usage?: AGUITokenUsage[];
 }
 interface AGUIRunErrorEvent extends AGUIBaseEvent {
   type: "RUN_ERROR";
   message: string;
   code?: string;
+  usage?: AGUITokenUsage[];
 }
 interface AGUIStepStartedEvent extends AGUIBaseEvent {
   type: "STEP_STARTED";
@@ -192,6 +194,22 @@ type AGUIRunFinishedOutcome = {
   type: "interrupt";
   interrupts: AGUIInterrupt[];
 };
+/**
+ * Numeric-only token usage summary, mirroring `TokenUsageSchema` in
+ * `@ag-ui/core`. Deliberately carries no content-bearing or identifying
+ * fields — only provider/model labels and non-negative integer token counts.
+ * Carried as an array on RUN_FINISHED / RUN_ERROR so a run that invokes
+ * multiple models keeps them separate.
+ */
+interface AGUITokenUsage {
+  provider?: string;
+  model?: string;
+  inputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+  reasoningTokens?: number;
+  cachedInputTokens?: number;
+}
 interface AGUIRunAgentInput {
   threadId: string;
   runId: string;
@@ -275,5 +293,5 @@ interface AGUIRecordConfig {
 }
 //# sourceMappingURL=agui-types.d.ts.map
 //#endregion
-export { AGUIActivityDeltaEvent, AGUIActivitySnapshotEvent, AGUIBaseEvent, AGUICustomEvent, AGUIEvent, AGUIEventType, AGUIFixture, AGUIFixtureMatch, AGUIInterrupt, AGUIMessage, AGUIMessageContentPart, AGUIMessageRole, AGUIMessagesSnapshotEvent, AGUIMockOptions, AGUIRawEvent, AGUIReasoningEncryptedValueEvent, AGUIReasoningEncryptedValueSubtype, AGUIReasoningEndEvent, AGUIReasoningMessageChunkEvent, AGUIReasoningMessageContentEvent, AGUIReasoningMessageEndEvent, AGUIReasoningMessageStartEvent, AGUIReasoningStartEvent, AGUIRecordConfig, AGUIResumeEntry, AGUIRunAgentInput, AGUIRunErrorEvent, AGUIRunFinishedEvent, AGUIRunFinishedOutcome, AGUIRunStartedEvent, AGUIStateDeltaEvent, AGUIStateSnapshotEvent, AGUIStepFinishedEvent, AGUIStepStartedEvent, AGUITextMessageChunkEvent, AGUITextMessageContentEvent, AGUITextMessageEndEvent, AGUITextMessageRole, AGUITextMessageStartEvent, AGUIThinkingEndEvent, AGUIThinkingStartEvent, AGUIThinkingTextMessageContentEvent, AGUIThinkingTextMessageEndEvent, AGUIThinkingTextMessageStartEvent, AGUIToolCall, AGUIToolCallArgsEvent, AGUIToolCallChunkEvent, AGUIToolCallEndEvent, AGUIToolCallResultEvent, AGUIToolCallStartEvent, AGUIToolDefinition };
+export { AGUIActivityDeltaEvent, AGUIActivitySnapshotEvent, AGUIBaseEvent, AGUICustomEvent, AGUIEvent, AGUIEventType, AGUIFixture, AGUIFixtureMatch, AGUIInterrupt, AGUIMessage, AGUIMessageContentPart, AGUIMessageRole, AGUIMessagesSnapshotEvent, AGUIMockOptions, AGUIRawEvent, AGUIReasoningEncryptedValueEvent, AGUIReasoningEncryptedValueSubtype, AGUIReasoningEndEvent, AGUIReasoningMessageChunkEvent, AGUIReasoningMessageContentEvent, AGUIReasoningMessageEndEvent, AGUIReasoningMessageStartEvent, AGUIReasoningStartEvent, AGUIRecordConfig, AGUIResumeEntry, AGUIRunAgentInput, AGUIRunErrorEvent, AGUIRunFinishedEvent, AGUIRunFinishedOutcome, AGUIRunStartedEvent, AGUIStateDeltaEvent, AGUIStateSnapshotEvent, AGUIStepFinishedEvent, AGUIStepStartedEvent, AGUITextMessageChunkEvent, AGUITextMessageContentEvent, AGUITextMessageEndEvent, AGUITextMessageRole, AGUITextMessageStartEvent, AGUIThinkingEndEvent, AGUIThinkingStartEvent, AGUIThinkingTextMessageContentEvent, AGUIThinkingTextMessageEndEvent, AGUIThinkingTextMessageStartEvent, AGUITokenUsage, AGUIToolCall, AGUIToolCallArgsEvent, AGUIToolCallChunkEvent, AGUIToolCallEndEvent, AGUIToolCallResultEvent, AGUIToolCallStartEvent, AGUIToolDefinition };
 //# sourceMappingURL=agui-types.d.cts.map

package/dist/agui-types.d.cts.map

@@ -1 +1 @@
-{"version":3,"file":"agui-types.d.cts","names":[],"sources":["../src/agui-types.ts"],"sourcesContent":[],"mappings":";KAOY,aAAA;AAAA,UA6CK,aAAA,CA7CQ;EA6CR,IAAA,EACT,aADsB;EAUb,SAAA,CAAA,EAAA,MAAA;EAAoB,QAAA,CAAA,EAAA,OAAA;;AAAQ,UAA5B,mBAAA,SAA4B,aAAA,CAAA;EAAa,IAAA,EAAA,aAAA;EAQzC,QAAA,EAAA,MAAA;EAAqB,KAAA,EAAA,MAAA;aAK1B,CAAA,EAAA,MAAA;OALkC,CAAA,EAHpC,iBAGoC;;AAQ7B,UARA,oBAAA,SAA6B,aAQU,CAAA;EAMvC,IAAA,EAAA,cAAA;EAKA,QAAA,EAAA,MAAA;EAOL,KAAA,EAAA,MAAA;EAEA,MAAA,CAAA,EAAA,OAAA;EASK,OAAA,CAAA,EAhCL,sBAgC+B;;AAGnC,UAhCS,iBAAA,SAA0B,aAgCnC,CAAA;MAH2C,EAAA,WAAA;EAAa,OAAA,EAAA,MAAA;EAO/C,IAAA,CAAA,EAAA,MAAA;AAMjB;AAKiB,UAzCA,oBAAA,SAA6B,aAyCH,CAAA;EAAA,IAAA,EAAA,cAAA;UAGlC,EAAA,MAAA;;AAHuD,UApC/C,qBAAA,SAA8B,aAoCiB,CAAA;EAU/C,IAAA,EAAA,eAAA;EAOA,QAAA,EAAA,MAAA;AAMjB;AAKiB,KAzDL,mBAAA,GAyD4B,WAAQ,GAAA,QAAa,GAAA,WAAA,GAAA,MAAA;AAQ5C,KA/DL,eAAA,GA+D6B,WAAA,GAAQ,QAAA,GAAA,WAAa,GAAA,MAAA,GAAA,MAAA,GAAA,UAAA,GAAA,WAAA;AAU7C,UAhEA,yBAAA,SAAkC,aAgEU,CAAA;EAK5C,IAAA,EAAA,oBAAoB;EAKpB,SAAA,EAAA,MAAA;EAA0B,IAAA,EAvEnC,mBAuEmC;MAE/B,CAAA,EAAA,MAAA;;AAFoD,UAnE/C,2BAAA,SAAoC,aAmEW,CAAA;EAO/C,IAAA,EAAA,sBAA0B;EAAA,SAAA,EAAA,MAAA;OAIhC,EAAA,MAAA;;AAJqD,UApE/C,uBAAA,SAAgC,aAoEe,CAAA;EAQ/C,IAAA,EAAA,kBAAA;EASA,SAAA,EAAA,MAAA;AAKjB;AAMiB,UA3FA,yBAAA,SAAkC,aA2FO,CAAa;EAMtD,IAAA,EAAA,oBAAA;EAKA,SAAA,CAAA,EAAA,MAAA;EAMA,IAAA,CAAA,EAzGR,mBAyG8B;EAK3B,KAAA,CAAA,EAAA,MAAA;EAEK,IAAA,CAAA,EAAA,MAAA;;AAEN,UA3GM,sBAAA,SAA+B,aA2GrC,CAAA;MAF+C,EAAA,iBAAA;EAAa,UAAA,EAAA,MAAA;EAStD,YAAA,EAAA,MAAa;EAMb,eAAA,CAAA,EAAgB,MAAA;AAQjC;AAKiB,UA9HA,qBAAA,SAA8B,aA8HY,CAAA;EAI1C,IAAA,EAAA,gBAAA;EAIA,UAAA,EAAA,MAAA;EAKA,KAAA,EAAA,MAAA;AAMjB;AAAqB,UA3IJ,oBAAA,SAA6B,aA2IzB,CAAA;MACjB,EAAA,eAAA;YACA,EAAA,MAAA;;AAEA,UA1Ia,sBAAA,SAA+B,aA0I5C,CAAA;MACA,EAAA,iBAAA;YACA,CAAA,EAAA,MAAA;cACA,CAAA,EAAA,MAAA;iBACA,CAAA,EAAA,MAAA;OACA,CAAA,EAAA,MAAA;;AAEA,UAzIa,uBAAA,SAAgC,aAyI7C,CAAA;MACA,EAAA,kBAAA;WACA,EAAA,MAAA;YACA,EAAA,MAAA;SACA,EAAA,MAAA;MACA,CAAA,EAAA,MAAA;;AAEA,UAtIa,sBAAA,SAA+B,aAsI5C,CAAA;MACA,EAAA,gBAAA;UACA,EAAA,OAAA;;AAEA,UArIa,mBAAA,SAA4B,aAqIzC,CAAA;MACA,EAAA,aAAA;OACA,EAAA,OAAA,EAAA;;AAEA,UApIa,yBAAA,SAAkC,aAoI/C,CAAA;MACA,EAAA,mBAAA;UACA,EApIQ,WAoIR,EAAA;;AAEA,UAjIa,yBAAA,SAAkC,aAiI/C,CAAA;MACA,EAAA,mBAAA;WACA,EAAA,MAAA;cACA,EAAA,MAAA;EAA+B,OAAA,EAhIxB,MAgIwB,CAAA,MAAA,EAAA,OAAA,CAAA;EAIlB,OAAA,CAAA,EAAA,OAAa;;AAKX,UArIF,sBAAA,SAA+B,aAqI7B,CAAA;MAEN,EAAA,gBAAA;EAAM,SAAA,EAAA,MAAA;EAGF,YAAA,EAAA,MAAe;EAMpB,KAAA,EAAA,OAAA,EAAA;AAMZ;AAAkC,UA7IjB,uBAAA,SAAgC,aA6If,CAAA;MAKrB,EAAA,iBAAA;WACH,EAAA,MAAA;;AAGC,UAjJM,8BAAA,SAAuC,aAiJ7C,CAAA;EAAe,IAAA,EAAA,yBAAA;EAGT,SAAA,EAAA,MAAY;EAOjB,IAAA,EAAA,WAAA;AAIZ;AAA4B,UAzJX,gCAAA,SAAyC,aAyJ9B,CAAA;MAEpB,EAAA,2BAAA;WACa,EAAA,MAAA;OAKP,EAAA,MAAA;;AAGG,UA9JA,4BAAA,SAAqC,aAkKnC,CAAA;EAKF,IAAA,EAAA,uBAAgB;EAAA,SAAA,EAAA,MAAA;;AAKX,UAvKL,8BAAA,SAAuC,aAuKlC,CAAA;EAAiB,IAAA,EAAA,yBAAA;EAGtB,SAAA,CAAA,EAAA,MAAW;EAAA,KAAA,CAAA,EAAA,MAAA;;AAElB,UAtKO,qBAAA,SAA8B,aAsKrC,CAAA;EAAS,IAAA,EAAA,eAAA;EAIF,SAAA,EAAA,MAAA;AAMjB;KA3KY,kCAAA;UAEK,gCAAA,SAAyC;;WAE/C;;;;UAOM,YAAA,SAAqB;;;;;UAMrB,eAAA,SAAwB;;;;;UAQxB,sBAAA,SAA+B;;;;UAK/B,oBAAA,SAA6B;;;UAI7B,iCAAA,SAA0C;;;UAI1C,mCAAA,SAA4C;;;;UAK5C,+BAAA,SAAwC;;;KAM7C,SAAA,GACR,sBACA,uBACA,oBACA,uBACA,wBACA,4BACA,8BACA,0BACA,4BACA,yBACA,wBACA,uBACA,yBACA,0BACA,yBACA,sBACA,4BACA,4BACA,yBACA,0BACA,iCACA,mCACA,+BACA,iCACA,wBACA,mCACA,eACA,kBACA,yBACA,uBACA,oCACA,sCACA;UAIa,aAAA;;;;;mBAKE;;aAEN;;UAGI,eAAA;;;;;KAML,sBAAA;;;;cAEyB;;UAIpB,iBAAA;;;;;aAKJ;UACH;YACE;;;;;WAED;;UAGM,YAAA;;;;;;;;;KAOL,sBAAA;;;;;;;UAIK,WAAA;;QAET;qBACa;;;;;cAKP;;UAGG,kBAAA;;;;aAIJ;;UAKI,gBAAA;qBACI;;;;sBAIC;;UAGL,WAAA;SACR;UACC;;;UAIO,eAAA;;;;;UAMA,gBAAA"}
+{"version":3,"file":"agui-types.d.cts","names":[],"sources":["../src/agui-types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/agui-types.d.ts

@@ -18,11 +18,13 @@ interface AGUIRunFinishedEvent extends AGUIBaseEvent {
   runId: string;
   result?: unknown;
   outcome?: AGUIRunFinishedOutcome;
+  usage?: AGUITokenUsage[];
 }
 interface AGUIRunErrorEvent extends AGUIBaseEvent {
   type: "RUN_ERROR";
   message: string;
   code?: string;
+  usage?: AGUITokenUsage[];
 }
 interface AGUIStepStartedEvent extends AGUIBaseEvent {
   type: "STEP_STARTED";
@@ -192,6 +194,22 @@ type AGUIRunFinishedOutcome = {
   type: "interrupt";
   interrupts: AGUIInterrupt[];
 };
+/**
+ * Numeric-only token usage summary, mirroring `TokenUsageSchema` in
+ * `@ag-ui/core`. Deliberately carries no content-bearing or identifying
+ * fields — only provider/model labels and non-negative integer token counts.
+ * Carried as an array on RUN_FINISHED / RUN_ERROR so a run that invokes
+ * multiple models keeps them separate.
+ */
+interface AGUITokenUsage {
+  provider?: string;
+  model?: string;
+  inputTokens?: number;
+  outputTokens?: number;
+  totalTokens?: number;
+  reasoningTokens?: number;
+  cachedInputTokens?: number;
+}
 interface AGUIRunAgentInput {
   threadId: string;
   runId: string;
@@ -275,5 +293,5 @@ interface AGUIRecordConfig {
 }
 //# sourceMappingURL=agui-types.d.ts.map
 //#endregion
-export { AGUIActivityDeltaEvent, AGUIActivitySnapshotEvent, AGUIBaseEvent, AGUICustomEvent, AGUIEvent, AGUIEventType, AGUIFixture, AGUIFixtureMatch, AGUIInterrupt, AGUIMessage, AGUIMessageContentPart, AGUIMessageRole, AGUIMessagesSnapshotEvent, AGUIMockOptions, AGUIRawEvent, AGUIReasoningEncryptedValueEvent, AGUIReasoningEncryptedValueSubtype, AGUIReasoningEndEvent, AGUIReasoningMessageChunkEvent, AGUIReasoningMessageContentEvent, AGUIReasoningMessageEndEvent, AGUIReasoningMessageStartEvent, AGUIReasoningStartEvent, AGUIRecordConfig, AGUIResumeEntry, AGUIRunAgentInput, AGUIRunErrorEvent, AGUIRunFinishedEvent, AGUIRunFinishedOutcome, AGUIRunStartedEvent, AGUIStateDeltaEvent, AGUIStateSnapshotEvent, AGUIStepFinishedEvent, AGUIStepStartedEvent, AGUITextMessageChunkEvent, AGUITextMessageContentEvent, AGUITextMessageEndEvent, AGUITextMessageRole, AGUITextMessageStartEvent, AGUIThinkingEndEvent, AGUIThinkingStartEvent, AGUIThinkingTextMessageContentEvent, AGUIThinkingTextMessageEndEvent, AGUIThinkingTextMessageStartEvent, AGUIToolCall, AGUIToolCallArgsEvent, AGUIToolCallChunkEvent, AGUIToolCallEndEvent, AGUIToolCallResultEvent, AGUIToolCallStartEvent, AGUIToolDefinition };
+export { AGUIActivityDeltaEvent, AGUIActivitySnapshotEvent, AGUIBaseEvent, AGUICustomEvent, AGUIEvent, AGUIEventType, AGUIFixture, AGUIFixtureMatch, AGUIInterrupt, AGUIMessage, AGUIMessageContentPart, AGUIMessageRole, AGUIMessagesSnapshotEvent, AGUIMockOptions, AGUIRawEvent, AGUIReasoningEncryptedValueEvent, AGUIReasoningEncryptedValueSubtype, AGUIReasoningEndEvent, AGUIReasoningMessageChunkEvent, AGUIReasoningMessageContentEvent, AGUIReasoningMessageEndEvent, AGUIReasoningMessageStartEvent, AGUIReasoningStartEvent, AGUIRecordConfig, AGUIResumeEntry, AGUIRunAgentInput, AGUIRunErrorEvent, AGUIRunFinishedEvent, AGUIRunFinishedOutcome, AGUIRunStartedEvent, AGUIStateDeltaEvent, AGUIStateSnapshotEvent, AGUIStepFinishedEvent, AGUIStepStartedEvent, AGUITextMessageChunkEvent, AGUITextMessageContentEvent, AGUITextMessageEndEvent, AGUITextMessageRole, AGUITextMessageStartEvent, AGUIThinkingEndEvent, AGUIThinkingStartEvent, AGUIThinkingTextMessageContentEvent, AGUIThinkingTextMessageEndEvent, AGUIThinkingTextMessageStartEvent, AGUITokenUsage, AGUIToolCall, AGUIToolCallArgsEvent, AGUIToolCallChunkEvent, AGUIToolCallEndEvent, AGUIToolCallResultEvent, AGUIToolCallStartEvent, AGUIToolDefinition };
 //# sourceMappingURL=agui-types.d.ts.map

package/dist/agui-types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agui-types.d.ts","names":[],"sources":["../src/agui-types.ts"],"sourcesContent":[],"mappings":"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"}
+{"version":3,"file":"agui-types.d.ts","names":[],"sources":["../src/agui-types.ts"],"sourcesContent":[],"mappings":"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"}

package/dist/aimock-cli.cjs

@@ -99,7 +99,6 @@ function runAimockCli(deps = {}) {
 			port,
 			host
 		});
-		log(`aimock server listening on ${url}`);
 		function shutdown() {
 			log("Shutting down...");
 			process.removeListener("SIGINT", shutdown);
@@ -111,6 +110,7 @@ function runAimockCli(deps = {}) {
 		}
 		process.on("SIGINT", shutdown);
 		process.on("SIGTERM", shutdown);
+		log(`aimock server listening on ${url}`);
 		if (deps.onReady) deps.onReady({ shutdown });
 	}
 	main().catch((err) => {

package/dist/aimock-cli.cjs.map

@@ -1 +1 @@
-{"version":3,"file":"aimock-cli.cjs","names":["loadConfig","startFromConfig"],"sources":["../src/aimock-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { resolve, basename } from \"node:path\";\nimport { loadConfig, startFromConfig } from \"./config-loader.js\";\nimport { runConvertCli, type ConvertCliDeps } from \"./convert.js\";\n\nconst HELP = `\nUsage: aimock [options]\n       aimock convert <format> <input> [output]\n\nOptions:\n  -c, --config <path>   Path to aimock config JSON file (required)\n  -p, --port <number>   Port override (default: from config or 0)\n  -h, --host <string>   Host override (default: from config or 127.0.0.1)\n      --help            Show this help message\n\nSubcommands:\n  convert               Convert third-party mock configs to aimock format\n                        Run \"aimock convert --help\" for details\n`.trim();\n\nexport interface AimockCliDeps {\n  argv?: string[];\n  log?: (msg: string) => void;\n  logError?: (msg: string) => void;\n  exit?: (code: number) => void;\n  loadConfigFn?: typeof loadConfig;\n  startFromConfigFn?: typeof startFromConfig;\n  onReady?: (ctx: { shutdown: () => void }) => void;\n  convertDeps?: Partial<ConvertCliDeps>;\n}\n\nexport function runAimockCli(deps: AimockCliDeps = {}): void {\n  /* v8 ignore next 6 -- defaults used only when called from CLI entry point */\n  const argv = deps.argv ?? process.argv.slice(2);\n  const log = deps.log ?? console.log.bind(console);\n  const logError = deps.logError ?? console.error.bind(console);\n  const exit = deps.exit ?? process.exit.bind(process);\n  const loadConfigFn = deps.loadConfigFn ?? loadConfig;\n  const startFromConfigFn = deps.startFromConfigFn ?? startFromConfig;\n\n  // Intercept \"convert\" subcommand before parseArgs (which uses strict mode)\n  if (argv[0] === \"convert\") {\n    runConvertCli({\n      argv: argv.slice(1),\n      log,\n      logError,\n      exit,\n      ...deps.convertDeps,\n    });\n    return;\n  }\n\n  let values;\n  try {\n    ({ values } = parseArgs({\n      args: argv,\n      options: {\n        config: { type: \"string\", short: \"c\" },\n        port: { type: \"string\", short: \"p\" },\n        host: { type: \"string\", short: \"h\" },\n        help: { type: \"boolean\", default: false },\n      },\n      strict: true,\n    }));\n  } catch (err) {\n    /* v8 ignore next -- parseArgs always throws Error subclasses */\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Error: ${msg}\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n\n  if (values.help) {\n    log(HELP);\n    exit(0);\n    return;\n  }\n  if (!values.config) {\n    logError(\"Error: --config is required.\\n\\n\" + HELP);\n    exit(1);\n    return;\n  }\n\n  const configPath = resolve(values.config);\n  let config;\n  try {\n    config = loadConfigFn(configPath);\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Failed to load config from ${configPath}: ${msg}`);\n    exit(1);\n    return;\n  }\n\n  const port = values.port ? Number(values.port) : undefined;\n  if (\n    port !== undefined &&\n    (Number.isNaN(port) || !Number.isInteger(port) || port < 0 || port > 65535)\n  ) {\n    logError(`Error: invalid port \"${values.port}\".\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n  const host = values.host;\n\n  async function main() {\n    const { llmock, url } = await startFromConfigFn(config!, { port, host });\n    log(`aimock server listening on ${url}`);\n\n    function shutdown() {\n      log(\"Shutting down...\");\n      process.removeListener(\"SIGINT\", shutdown);\n      process.removeListener(\"SIGTERM\", shutdown);\n      llmock.stop().then(\n        () => exit(0),\n        (err) => {\n          logError(`Shutdown error: ${err instanceof Error ? err.message : String(err)}`);\n          exit(1);\n        },\n      );\n    }\n    process.on(\"SIGINT\", shutdown);\n    process.on(\"SIGTERM\", shutdown);\n\n    if (deps.onReady) {\n      deps.onReady({ shutdown });\n    }\n  }\n\n  main().catch((err) => {\n    logError(err instanceof Error ? err.message : String(err));\n    exit(1);\n  });\n}\n\n// Run when executed as a script (not when imported for testing).\n/* v8 ignore start -- entry-point guard, exercised by integration tests */\nconst scriptName = process.argv[1] ?? \"\";\nconst base = basename(scriptName);\nif (base === \"aimock\" || base === \"aimock-cli.js\" || base === \"aimock-cli.ts\") {\n  runAimockCli();\n}\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;AAMA,MAAM,OAAO;;;;;;;;;;;;;EAaX,MAAM;AAaR,SAAgB,aAAa,OAAsB,EAAE,EAAQ;;CAE3D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,MAAM,EAAE;CAC/C,MAAM,MAAM,KAAK,OAAO,QAAQ,IAAI,KAAK,QAAQ;CACjD,MAAM,WAAW,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ;CAC7D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,KAAK,QAAQ;CACpD,MAAM,eAAe,KAAK,gBAAgBA;CAC1C,MAAM,oBAAoB,KAAK,qBAAqBC;AAGpD,KAAI,KAAK,OAAO,WAAW;AACzB,gCAAc;GACZ,MAAM,KAAK,MAAM,EAAE;GACnB;GACA;GACA;GACA,GAAG,KAAK;GACT,CAAC;AACF;;CAGF,IAAI;AACJ,KAAI;AACF,GAAC,CAAE,mCAAqB;GACtB,MAAM;GACN,SAAS;IACP,QAAQ;KAAE,MAAM;KAAU,OAAO;KAAK;IACtC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAW,SAAS;KAAO;IAC1C;GACD,QAAQ;GACT,CAAC;UACK,KAAK;AAGZ,WAAS,UADG,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CACrC,MAAM,OAAO;AACpC,OAAK,EAAE;AACP;;AAGF,KAAI,OAAO,MAAM;AACf,MAAI,KAAK;AACT,OAAK,EAAE;AACP;;AAEF,KAAI,CAAC,OAAO,QAAQ;AAClB,WAAS,qCAAqC,KAAK;AACnD,OAAK,EAAE;AACP;;CAGF,MAAM,oCAAqB,OAAO,OAAO;CACzC,IAAI;AACJ,KAAI;AACF,WAAS,aAAa,WAAW;UAC1B,KAAK;AAEZ,WAAS,8BAA8B,WAAW,IADtC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GACA;AAC5D,OAAK,EAAE;AACP;;CAGF,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK,GAAG;AACjD,KACE,SAAS,WACR,OAAO,MAAM,KAAK,IAAI,CAAC,OAAO,UAAU,KAAK,IAAI,OAAO,KAAK,OAAO,QACrE;AACA,WAAS,wBAAwB,OAAO,KAAK,QAAQ,OAAO;AAC5D,OAAK,EAAE;AACP;;CAEF,MAAM,OAAO,OAAO;CAEpB,eAAe,OAAO;EACpB,MAAM,EAAE,QAAQ,QAAQ,MAAM,kBAAkB,QAAS;GAAE;GAAM;GAAM,CAAC;AACxE,MAAI,8BAA8B,MAAM;EAExC,SAAS,WAAW;AAClB,OAAI,mBAAmB;AACvB,WAAQ,eAAe,UAAU,SAAS;AAC1C,WAAQ,eAAe,WAAW,SAAS;AAC3C,UAAO,MAAM,CAAC,WACN,KAAK,EAAE,GACZ,QAAQ;AACP,aAAS,mBAAmB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AAC/E,SAAK,EAAE;KAEV;;AAEH,UAAQ,GAAG,UAAU,SAAS;AAC9B,UAAQ,GAAG,WAAW,SAAS;AAE/B,MAAI,KAAK,QACP,MAAK,QAAQ,EAAE,UAAU,CAAC;;AAI9B,OAAM,CAAC,OAAO,QAAQ;AACpB,WAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC1D,OAAK,EAAE;GACP;;AAMJ,MAAM,+BADa,QAAQ,KAAK,MAAM,GACL;AACjC,IAAI,SAAS,YAAY,SAAS,mBAAmB,SAAS,gBAC5D,eAAc"}
+{"version":3,"file":"aimock-cli.cjs","names":["loadConfig","startFromConfig"],"sources":["../src/aimock-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { resolve, basename } from \"node:path\";\nimport { loadConfig, startFromConfig } from \"./config-loader.js\";\nimport { runConvertCli, type ConvertCliDeps } from \"./convert.js\";\n\nconst HELP = `\nUsage: aimock [options]\n       aimock convert <format> <input> [output]\n\nOptions:\n  -c, --config <path>   Path to aimock config JSON file (required)\n  -p, --port <number>   Port override (default: from config or 0)\n  -h, --host <string>   Host override (default: from config or 127.0.0.1)\n      --help            Show this help message\n\nSubcommands:\n  convert               Convert third-party mock configs to aimock format\n                        Run \"aimock convert --help\" for details\n`.trim();\n\nexport interface AimockCliDeps {\n  argv?: string[];\n  log?: (msg: string) => void;\n  logError?: (msg: string) => void;\n  exit?: (code: number) => void;\n  loadConfigFn?: typeof loadConfig;\n  startFromConfigFn?: typeof startFromConfig;\n  onReady?: (ctx: { shutdown: () => void }) => void;\n  convertDeps?: Partial<ConvertCliDeps>;\n}\n\nexport function runAimockCli(deps: AimockCliDeps = {}): void {\n  /* v8 ignore next 6 -- defaults used only when called from CLI entry point */\n  const argv = deps.argv ?? process.argv.slice(2);\n  const log = deps.log ?? console.log.bind(console);\n  const logError = deps.logError ?? console.error.bind(console);\n  const exit = deps.exit ?? process.exit.bind(process);\n  const loadConfigFn = deps.loadConfigFn ?? loadConfig;\n  const startFromConfigFn = deps.startFromConfigFn ?? startFromConfig;\n\n  // Intercept \"convert\" subcommand before parseArgs (which uses strict mode)\n  if (argv[0] === \"convert\") {\n    runConvertCli({\n      argv: argv.slice(1),\n      log,\n      logError,\n      exit,\n      ...deps.convertDeps,\n    });\n    return;\n  }\n\n  let values;\n  try {\n    ({ values } = parseArgs({\n      args: argv,\n      options: {\n        config: { type: \"string\", short: \"c\" },\n        port: { type: \"string\", short: \"p\" },\n        host: { type: \"string\", short: \"h\" },\n        help: { type: \"boolean\", default: false },\n      },\n      strict: true,\n    }));\n  } catch (err) {\n    /* v8 ignore next -- parseArgs always throws Error subclasses */\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Error: ${msg}\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n\n  if (values.help) {\n    log(HELP);\n    exit(0);\n    return;\n  }\n  if (!values.config) {\n    logError(\"Error: --config is required.\\n\\n\" + HELP);\n    exit(1);\n    return;\n  }\n\n  const configPath = resolve(values.config);\n  let config;\n  try {\n    config = loadConfigFn(configPath);\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Failed to load config from ${configPath}: ${msg}`);\n    exit(1);\n    return;\n  }\n\n  const port = values.port ? Number(values.port) : undefined;\n  if (\n    port !== undefined &&\n    (Number.isNaN(port) || !Number.isInteger(port) || port < 0 || port > 65535)\n  ) {\n    logError(`Error: invalid port \"${values.port}\".\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n  const host = values.host;\n\n  async function main() {\n    const { llmock, url } = await startFromConfigFn(config!, { port, host });\n\n    function shutdown() {\n      log(\"Shutting down...\");\n      process.removeListener(\"SIGINT\", shutdown);\n      process.removeListener(\"SIGTERM\", shutdown);\n      llmock.stop().then(\n        () => exit(0),\n        (err) => {\n          logError(`Shutdown error: ${err instanceof Error ? err.message : String(err)}`);\n          exit(1);\n        },\n      );\n    }\n    // Register BEFORE announcing readiness — see the note in src/cli.ts. A supervisor\n    // that reacts to the readiness line must never win a race against this listener.\n    process.on(\"SIGINT\", shutdown);\n    process.on(\"SIGTERM\", shutdown);\n\n    log(`aimock server listening on ${url}`);\n\n    if (deps.onReady) {\n      deps.onReady({ shutdown });\n    }\n  }\n\n  main().catch((err) => {\n    logError(err instanceof Error ? err.message : String(err));\n    exit(1);\n  });\n}\n\n// Run when executed as a script (not when imported for testing).\n/* v8 ignore start -- entry-point guard, exercised by integration tests */\nconst scriptName = process.argv[1] ?? \"\";\nconst base = basename(scriptName);\nif (base === \"aimock\" || base === \"aimock-cli.js\" || base === \"aimock-cli.ts\") {\n  runAimockCli();\n}\n/* v8 ignore stop */\n"],"mappings":";;;;;;;;;AAMA,MAAM,OAAO;;;;;;;;;;;;;EAaX,MAAM;AAaR,SAAgB,aAAa,OAAsB,EAAE,EAAQ;;CAE3D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,MAAM,EAAE;CAC/C,MAAM,MAAM,KAAK,OAAO,QAAQ,IAAI,KAAK,QAAQ;CACjD,MAAM,WAAW,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ;CAC7D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,KAAK,QAAQ;CACpD,MAAM,eAAe,KAAK,gBAAgBA;CAC1C,MAAM,oBAAoB,KAAK,qBAAqBC;AAGpD,KAAI,KAAK,OAAO,WAAW;AACzB,gCAAc;GACZ,MAAM,KAAK,MAAM,EAAE;GACnB;GACA;GACA;GACA,GAAG,KAAK;GACT,CAAC;AACF;;CAGF,IAAI;AACJ,KAAI;AACF,GAAC,CAAE,mCAAqB;GACtB,MAAM;GACN,SAAS;IACP,QAAQ;KAAE,MAAM;KAAU,OAAO;KAAK;IACtC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAW,SAAS;KAAO;IAC1C;GACD,QAAQ;GACT,CAAC;UACK,KAAK;AAGZ,WAAS,UADG,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CACrC,MAAM,OAAO;AACpC,OAAK,EAAE;AACP;;AAGF,KAAI,OAAO,MAAM;AACf,MAAI,KAAK;AACT,OAAK,EAAE;AACP;;AAEF,KAAI,CAAC,OAAO,QAAQ;AAClB,WAAS,qCAAqC,KAAK;AACnD,OAAK,EAAE;AACP;;CAGF,MAAM,oCAAqB,OAAO,OAAO;CACzC,IAAI;AACJ,KAAI;AACF,WAAS,aAAa,WAAW;UAC1B,KAAK;AAEZ,WAAS,8BAA8B,WAAW,IADtC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GACA;AAC5D,OAAK,EAAE;AACP;;CAGF,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK,GAAG;AACjD,KACE,SAAS,WACR,OAAO,MAAM,KAAK,IAAI,CAAC,OAAO,UAAU,KAAK,IAAI,OAAO,KAAK,OAAO,QACrE;AACA,WAAS,wBAAwB,OAAO,KAAK,QAAQ,OAAO;AAC5D,OAAK,EAAE;AACP;;CAEF,MAAM,OAAO,OAAO;CAEpB,eAAe,OAAO;EACpB,MAAM,EAAE,QAAQ,QAAQ,MAAM,kBAAkB,QAAS;GAAE;GAAM;GAAM,CAAC;EAExE,SAAS,WAAW;AAClB,OAAI,mBAAmB;AACvB,WAAQ,eAAe,UAAU,SAAS;AAC1C,WAAQ,eAAe,WAAW,SAAS;AAC3C,UAAO,MAAM,CAAC,WACN,KAAK,EAAE,GACZ,QAAQ;AACP,aAAS,mBAAmB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AAC/E,SAAK,EAAE;KAEV;;AAIH,UAAQ,GAAG,UAAU,SAAS;AAC9B,UAAQ,GAAG,WAAW,SAAS;AAE/B,MAAI,8BAA8B,MAAM;AAExC,MAAI,KAAK,QACP,MAAK,QAAQ,EAAE,UAAU,CAAC;;AAI9B,OAAM,CAAC,OAAO,QAAQ;AACpB,WAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC1D,OAAK,EAAE;GACP;;AAMJ,MAAM,+BADa,QAAQ,KAAK,MAAM,GACL;AACjC,IAAI,SAAS,YAAY,SAAS,mBAAmB,SAAS,gBAC5D,eAAc"}

package/dist/aimock-cli.js

@@ -97,7 +97,6 @@ function runAimockCli(deps = {}) {
 			port,
 			host
 		});
-		log(`aimock server listening on ${url}`);
 		function shutdown() {
 			log("Shutting down...");
 			process.removeListener("SIGINT", shutdown);
@@ -109,6 +108,7 @@ function runAimockCli(deps = {}) {
 		}
 		process.on("SIGINT", shutdown);
 		process.on("SIGTERM", shutdown);
+		log(`aimock server listening on ${url}`);
 		if (deps.onReady) deps.onReady({ shutdown });
 	}
 	main().catch((err) => {

package/dist/aimock-cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"aimock-cli.js","names":[],"sources":["../src/aimock-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { resolve, basename } from \"node:path\";\nimport { loadConfig, startFromConfig } from \"./config-loader.js\";\nimport { runConvertCli, type ConvertCliDeps } from \"./convert.js\";\n\nconst HELP = `\nUsage: aimock [options]\n       aimock convert <format> <input> [output]\n\nOptions:\n  -c, --config <path>   Path to aimock config JSON file (required)\n  -p, --port <number>   Port override (default: from config or 0)\n  -h, --host <string>   Host override (default: from config or 127.0.0.1)\n      --help            Show this help message\n\nSubcommands:\n  convert               Convert third-party mock configs to aimock format\n                        Run \"aimock convert --help\" for details\n`.trim();\n\nexport interface AimockCliDeps {\n  argv?: string[];\n  log?: (msg: string) => void;\n  logError?: (msg: string) => void;\n  exit?: (code: number) => void;\n  loadConfigFn?: typeof loadConfig;\n  startFromConfigFn?: typeof startFromConfig;\n  onReady?: (ctx: { shutdown: () => void }) => void;\n  convertDeps?: Partial<ConvertCliDeps>;\n}\n\nexport function runAimockCli(deps: AimockCliDeps = {}): void {\n  /* v8 ignore next 6 -- defaults used only when called from CLI entry point */\n  const argv = deps.argv ?? process.argv.slice(2);\n  const log = deps.log ?? console.log.bind(console);\n  const logError = deps.logError ?? console.error.bind(console);\n  const exit = deps.exit ?? process.exit.bind(process);\n  const loadConfigFn = deps.loadConfigFn ?? loadConfig;\n  const startFromConfigFn = deps.startFromConfigFn ?? startFromConfig;\n\n  // Intercept \"convert\" subcommand before parseArgs (which uses strict mode)\n  if (argv[0] === \"convert\") {\n    runConvertCli({\n      argv: argv.slice(1),\n      log,\n      logError,\n      exit,\n      ...deps.convertDeps,\n    });\n    return;\n  }\n\n  let values;\n  try {\n    ({ values } = parseArgs({\n      args: argv,\n      options: {\n        config: { type: \"string\", short: \"c\" },\n        port: { type: \"string\", short: \"p\" },\n        host: { type: \"string\", short: \"h\" },\n        help: { type: \"boolean\", default: false },\n      },\n      strict: true,\n    }));\n  } catch (err) {\n    /* v8 ignore next -- parseArgs always throws Error subclasses */\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Error: ${msg}\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n\n  if (values.help) {\n    log(HELP);\n    exit(0);\n    return;\n  }\n  if (!values.config) {\n    logError(\"Error: --config is required.\\n\\n\" + HELP);\n    exit(1);\n    return;\n  }\n\n  const configPath = resolve(values.config);\n  let config;\n  try {\n    config = loadConfigFn(configPath);\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Failed to load config from ${configPath}: ${msg}`);\n    exit(1);\n    return;\n  }\n\n  const port = values.port ? Number(values.port) : undefined;\n  if (\n    port !== undefined &&\n    (Number.isNaN(port) || !Number.isInteger(port) || port < 0 || port > 65535)\n  ) {\n    logError(`Error: invalid port \"${values.port}\".\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n  const host = values.host;\n\n  async function main() {\n    const { llmock, url } = await startFromConfigFn(config!, { port, host });\n    log(`aimock server listening on ${url}`);\n\n    function shutdown() {\n      log(\"Shutting down...\");\n      process.removeListener(\"SIGINT\", shutdown);\n      process.removeListener(\"SIGTERM\", shutdown);\n      llmock.stop().then(\n        () => exit(0),\n        (err) => {\n          logError(`Shutdown error: ${err instanceof Error ? err.message : String(err)}`);\n          exit(1);\n        },\n      );\n    }\n    process.on(\"SIGINT\", shutdown);\n    process.on(\"SIGTERM\", shutdown);\n\n    if (deps.onReady) {\n      deps.onReady({ shutdown });\n    }\n  }\n\n  main().catch((err) => {\n    logError(err instanceof Error ? err.message : String(err));\n    exit(1);\n  });\n}\n\n// Run when executed as a script (not when imported for testing).\n/* v8 ignore start -- entry-point guard, exercised by integration tests */\nconst scriptName = process.argv[1] ?? \"\";\nconst base = basename(scriptName);\nif (base === \"aimock\" || base === \"aimock-cli.js\" || base === \"aimock-cli.ts\") {\n  runAimockCli();\n}\n/* v8 ignore stop */\n"],"mappings":";;;;;;;AAMA,MAAM,OAAO;;;;;;;;;;;;;EAaX,MAAM;AAaR,SAAgB,aAAa,OAAsB,EAAE,EAAQ;;CAE3D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,MAAM,EAAE;CAC/C,MAAM,MAAM,KAAK,OAAO,QAAQ,IAAI,KAAK,QAAQ;CACjD,MAAM,WAAW,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ;CAC7D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,KAAK,QAAQ;CACpD,MAAM,eAAe,KAAK,gBAAgB;CAC1C,MAAM,oBAAoB,KAAK,qBAAqB;AAGpD,KAAI,KAAK,OAAO,WAAW;AACzB,gBAAc;GACZ,MAAM,KAAK,MAAM,EAAE;GACnB;GACA;GACA;GACA,GAAG,KAAK;GACT,CAAC;AACF;;CAGF,IAAI;AACJ,KAAI;AACF,GAAC,CAAE,UAAW,UAAU;GACtB,MAAM;GACN,SAAS;IACP,QAAQ;KAAE,MAAM;KAAU,OAAO;KAAK;IACtC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAW,SAAS;KAAO;IAC1C;GACD,QAAQ;GACT,CAAC;UACK,KAAK;AAGZ,WAAS,UADG,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CACrC,MAAM,OAAO;AACpC,OAAK,EAAE;AACP;;AAGF,KAAI,OAAO,MAAM;AACf,MAAI,KAAK;AACT,OAAK,EAAE;AACP;;AAEF,KAAI,CAAC,OAAO,QAAQ;AAClB,WAAS,qCAAqC,KAAK;AACnD,OAAK,EAAE;AACP;;CAGF,MAAM,aAAa,QAAQ,OAAO,OAAO;CACzC,IAAI;AACJ,KAAI;AACF,WAAS,aAAa,WAAW;UAC1B,KAAK;AAEZ,WAAS,8BAA8B,WAAW,IADtC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GACA;AAC5D,OAAK,EAAE;AACP;;CAGF,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK,GAAG;AACjD,KACE,SAAS,WACR,OAAO,MAAM,KAAK,IAAI,CAAC,OAAO,UAAU,KAAK,IAAI,OAAO,KAAK,OAAO,QACrE;AACA,WAAS,wBAAwB,OAAO,KAAK,QAAQ,OAAO;AAC5D,OAAK,EAAE;AACP;;CAEF,MAAM,OAAO,OAAO;CAEpB,eAAe,OAAO;EACpB,MAAM,EAAE,QAAQ,QAAQ,MAAM,kBAAkB,QAAS;GAAE;GAAM;GAAM,CAAC;AACxE,MAAI,8BAA8B,MAAM;EAExC,SAAS,WAAW;AAClB,OAAI,mBAAmB;AACvB,WAAQ,eAAe,UAAU,SAAS;AAC1C,WAAQ,eAAe,WAAW,SAAS;AAC3C,UAAO,MAAM,CAAC,WACN,KAAK,EAAE,GACZ,QAAQ;AACP,aAAS,mBAAmB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AAC/E,SAAK,EAAE;KAEV;;AAEH,UAAQ,GAAG,UAAU,SAAS;AAC9B,UAAQ,GAAG,WAAW,SAAS;AAE/B,MAAI,KAAK,QACP,MAAK,QAAQ,EAAE,UAAU,CAAC;;AAI9B,OAAM,CAAC,OAAO,QAAQ;AACpB,WAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC1D,OAAK,EAAE;GACP;;AAMJ,MAAM,OAAO,SADM,QAAQ,KAAK,MAAM,GACL;AACjC,IAAI,SAAS,YAAY,SAAS,mBAAmB,SAAS,gBAC5D,eAAc"}
+{"version":3,"file":"aimock-cli.js","names":[],"sources":["../src/aimock-cli.ts"],"sourcesContent":["#!/usr/bin/env node\nimport { parseArgs } from \"node:util\";\nimport { resolve, basename } from \"node:path\";\nimport { loadConfig, startFromConfig } from \"./config-loader.js\";\nimport { runConvertCli, type ConvertCliDeps } from \"./convert.js\";\n\nconst HELP = `\nUsage: aimock [options]\n       aimock convert <format> <input> [output]\n\nOptions:\n  -c, --config <path>   Path to aimock config JSON file (required)\n  -p, --port <number>   Port override (default: from config or 0)\n  -h, --host <string>   Host override (default: from config or 127.0.0.1)\n      --help            Show this help message\n\nSubcommands:\n  convert               Convert third-party mock configs to aimock format\n                        Run \"aimock convert --help\" for details\n`.trim();\n\nexport interface AimockCliDeps {\n  argv?: string[];\n  log?: (msg: string) => void;\n  logError?: (msg: string) => void;\n  exit?: (code: number) => void;\n  loadConfigFn?: typeof loadConfig;\n  startFromConfigFn?: typeof startFromConfig;\n  onReady?: (ctx: { shutdown: () => void }) => void;\n  convertDeps?: Partial<ConvertCliDeps>;\n}\n\nexport function runAimockCli(deps: AimockCliDeps = {}): void {\n  /* v8 ignore next 6 -- defaults used only when called from CLI entry point */\n  const argv = deps.argv ?? process.argv.slice(2);\n  const log = deps.log ?? console.log.bind(console);\n  const logError = deps.logError ?? console.error.bind(console);\n  const exit = deps.exit ?? process.exit.bind(process);\n  const loadConfigFn = deps.loadConfigFn ?? loadConfig;\n  const startFromConfigFn = deps.startFromConfigFn ?? startFromConfig;\n\n  // Intercept \"convert\" subcommand before parseArgs (which uses strict mode)\n  if (argv[0] === \"convert\") {\n    runConvertCli({\n      argv: argv.slice(1),\n      log,\n      logError,\n      exit,\n      ...deps.convertDeps,\n    });\n    return;\n  }\n\n  let values;\n  try {\n    ({ values } = parseArgs({\n      args: argv,\n      options: {\n        config: { type: \"string\", short: \"c\" },\n        port: { type: \"string\", short: \"p\" },\n        host: { type: \"string\", short: \"h\" },\n        help: { type: \"boolean\", default: false },\n      },\n      strict: true,\n    }));\n  } catch (err) {\n    /* v8 ignore next -- parseArgs always throws Error subclasses */\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Error: ${msg}\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n\n  if (values.help) {\n    log(HELP);\n    exit(0);\n    return;\n  }\n  if (!values.config) {\n    logError(\"Error: --config is required.\\n\\n\" + HELP);\n    exit(1);\n    return;\n  }\n\n  const configPath = resolve(values.config);\n  let config;\n  try {\n    config = loadConfigFn(configPath);\n  } catch (err) {\n    const msg = err instanceof Error ? err.message : String(err);\n    logError(`Failed to load config from ${configPath}: ${msg}`);\n    exit(1);\n    return;\n  }\n\n  const port = values.port ? Number(values.port) : undefined;\n  if (\n    port !== undefined &&\n    (Number.isNaN(port) || !Number.isInteger(port) || port < 0 || port > 65535)\n  ) {\n    logError(`Error: invalid port \"${values.port}\".\\n\\n${HELP}`);\n    exit(1);\n    return;\n  }\n  const host = values.host;\n\n  async function main() {\n    const { llmock, url } = await startFromConfigFn(config!, { port, host });\n\n    function shutdown() {\n      log(\"Shutting down...\");\n      process.removeListener(\"SIGINT\", shutdown);\n      process.removeListener(\"SIGTERM\", shutdown);\n      llmock.stop().then(\n        () => exit(0),\n        (err) => {\n          logError(`Shutdown error: ${err instanceof Error ? err.message : String(err)}`);\n          exit(1);\n        },\n      );\n    }\n    // Register BEFORE announcing readiness — see the note in src/cli.ts. A supervisor\n    // that reacts to the readiness line must never win a race against this listener.\n    process.on(\"SIGINT\", shutdown);\n    process.on(\"SIGTERM\", shutdown);\n\n    log(`aimock server listening on ${url}`);\n\n    if (deps.onReady) {\n      deps.onReady({ shutdown });\n    }\n  }\n\n  main().catch((err) => {\n    logError(err instanceof Error ? err.message : String(err));\n    exit(1);\n  });\n}\n\n// Run when executed as a script (not when imported for testing).\n/* v8 ignore start -- entry-point guard, exercised by integration tests */\nconst scriptName = process.argv[1] ?? \"\";\nconst base = basename(scriptName);\nif (base === \"aimock\" || base === \"aimock-cli.js\" || base === \"aimock-cli.ts\") {\n  runAimockCli();\n}\n/* v8 ignore stop */\n"],"mappings":";;;;;;;AAMA,MAAM,OAAO;;;;;;;;;;;;;EAaX,MAAM;AAaR,SAAgB,aAAa,OAAsB,EAAE,EAAQ;;CAE3D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,MAAM,EAAE;CAC/C,MAAM,MAAM,KAAK,OAAO,QAAQ,IAAI,KAAK,QAAQ;CACjD,MAAM,WAAW,KAAK,YAAY,QAAQ,MAAM,KAAK,QAAQ;CAC7D,MAAM,OAAO,KAAK,QAAQ,QAAQ,KAAK,KAAK,QAAQ;CACpD,MAAM,eAAe,KAAK,gBAAgB;CAC1C,MAAM,oBAAoB,KAAK,qBAAqB;AAGpD,KAAI,KAAK,OAAO,WAAW;AACzB,gBAAc;GACZ,MAAM,KAAK,MAAM,EAAE;GACnB;GACA;GACA;GACA,GAAG,KAAK;GACT,CAAC;AACF;;CAGF,IAAI;AACJ,KAAI;AACF,GAAC,CAAE,UAAW,UAAU;GACtB,MAAM;GACN,SAAS;IACP,QAAQ;KAAE,MAAM;KAAU,OAAO;KAAK;IACtC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAU,OAAO;KAAK;IACpC,MAAM;KAAE,MAAM;KAAW,SAAS;KAAO;IAC1C;GACD,QAAQ;GACT,CAAC;UACK,KAAK;AAGZ,WAAS,UADG,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CACrC,MAAM,OAAO;AACpC,OAAK,EAAE;AACP;;AAGF,KAAI,OAAO,MAAM;AACf,MAAI,KAAK;AACT,OAAK,EAAE;AACP;;AAEF,KAAI,CAAC,OAAO,QAAQ;AAClB,WAAS,qCAAqC,KAAK;AACnD,OAAK,EAAE;AACP;;CAGF,MAAM,aAAa,QAAQ,OAAO,OAAO;CACzC,IAAI;AACJ,KAAI;AACF,WAAS,aAAa,WAAW;UAC1B,KAAK;AAEZ,WAAS,8BAA8B,WAAW,IADtC,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GACA;AAC5D,OAAK,EAAE;AACP;;CAGF,MAAM,OAAO,OAAO,OAAO,OAAO,OAAO,KAAK,GAAG;AACjD,KACE,SAAS,WACR,OAAO,MAAM,KAAK,IAAI,CAAC,OAAO,UAAU,KAAK,IAAI,OAAO,KAAK,OAAO,QACrE;AACA,WAAS,wBAAwB,OAAO,KAAK,QAAQ,OAAO;AAC5D,OAAK,EAAE;AACP;;CAEF,MAAM,OAAO,OAAO;CAEpB,eAAe,OAAO;EACpB,MAAM,EAAE,QAAQ,QAAQ,MAAM,kBAAkB,QAAS;GAAE;GAAM;GAAM,CAAC;EAExE,SAAS,WAAW;AAClB,OAAI,mBAAmB;AACvB,WAAQ,eAAe,UAAU,SAAS;AAC1C,WAAQ,eAAe,WAAW,SAAS;AAC3C,UAAO,MAAM,CAAC,WACN,KAAK,EAAE,GACZ,QAAQ;AACP,aAAS,mBAAmB,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,GAAG;AAC/E,SAAK,EAAE;KAEV;;AAIH,UAAQ,GAAG,UAAU,SAAS;AAC9B,UAAQ,GAAG,WAAW,SAAS;AAE/B,MAAI,8BAA8B,MAAM;AAExC,MAAI,KAAK,QACP,MAAK,QAAQ,EAAE,UAAU,CAAC;;AAI9B,OAAM,CAAC,OAAO,QAAQ;AACpB,WAAS,eAAe,QAAQ,IAAI,UAAU,OAAO,IAAI,CAAC;AAC1D,OAAK,EAAE;GACP;;AAMJ,MAAM,OAAO,SADM,QAAQ,KAAK,MAAM,GACL;AACjC,IAAI,SAAS,YAAY,SAAS,mBAAmB,SAAS,gBAC5D,eAAc"}

package/dist/api-key-auth.cjs

@@ -0,0 +1,166 @@
+const require_runtime = require('./_virtual/_rolldown/runtime.cjs');
+let node_crypto = require("node:crypto");
+
+//#region src/api-key-auth.ts
+const INBOUND_API_KEY_HEADERS = [
+	"authorization",
+	"x-api-key",
+	"x-goog-api-key",
+	"api-key",
+	"xi-api-key"
+];
+const RECOGNIZED_HEADERS = new Set(INBOUND_API_KEY_HEADERS);
+const API_KEY_ERROR_BODY = JSON.stringify({ error: {
+	message: "Invalid API key",
+	type: "authentication_error",
+	code: "invalid_api_key"
+} });
+const DISABLED_POLICY = {
+	enabled: false,
+	keys: []
+};
+const authenticatedRequests = /* @__PURE__ */ new WeakSet();
+const OWS_EDGES = /^[ \t]+|[ \t]+$/g;
+function fail(label, suffix) {
+	throw new Error(`${label}${suffix}`);
+}
+function hasControl(value) {
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (code <= 31 || code === 127) return true;
+	}
+	return false;
+}
+function normalizeKey(value, label) {
+	if (typeof value !== "string") fail(label, " must be a string");
+	const normalized = value.replace(OWS_EDGES, "");
+	if (normalized.length === 0) fail(label, " must not be empty");
+	if (hasControl(normalized)) fail(label, " must not contain control characters");
+	return normalized;
+}
+/** Parse a public auth source once and construct its private server policy. */
+function resolveInboundAuth(source) {
+	if (source.value === void 0) return { policy: DISABLED_POLICY };
+	if (source.value === null || typeof source.value !== "object" || Array.isArray(source.value)) fail(source.label, " must be an object");
+	const apiKeys = source.value.apiKeys;
+	if (!Array.isArray(apiKeys)) fail(`${source.label}.apiKeys`, " must be an array");
+	if (apiKeys.length === 0) fail(`${source.label}.apiKeys`, " must not be empty");
+	const keys = apiKeys.map((value, index) => normalizeKey(value, `${source.label}.apiKeys[${index}]`));
+	const seen = /* @__PURE__ */ new Set();
+	for (const key of keys) {
+		if (seen.has(key)) fail(source.label, " must not contain duplicate API keys");
+		seen.add(key);
+	}
+	return {
+		publicConfig: { apiKeys: keys },
+		policy: {
+			enabled: true,
+			keys: keys.map((key) => Buffer.from(key, "utf8"))
+		}
+	};
+}
+/** Select configuration without parsing it, so an environment override bypasses malformed JSON auth. */
+function selectInboundAuthSource(configAuth, env = process.env) {
+	if (Object.prototype.hasOwnProperty.call(env, "AIMOCK_API_KEYS")) return {
+		value: { apiKeys: (env.AIMOCK_API_KEYS ?? "").split(",") },
+		label: "AIMOCK_API_KEYS"
+	};
+	return {
+		value: configAuth,
+		label: "aimock.json.auth"
+	};
+}
+function isRecognizedApiKeyHeader(name) {
+	return RECOGNIZED_HEADERS.has(name.toLowerCase());
+}
+function rawCandidates(req) {
+	const candidates = [];
+	for (let index = 0; index < req.rawHeaders.length; index += 2) {
+		const name = req.rawHeaders[index];
+		const value = req.rawHeaders[index + 1] ?? "";
+		const lower = name.toLowerCase();
+		if (!isRecognizedApiKeyHeader(lower)) continue;
+		if (hasControl(value)) return { reason: "invalid" };
+		if (lower === "authorization") {
+			const match = /^(?:Bearer|Key)[ \t]+(.+)$/i.exec(value.replace(OWS_EDGES, ""));
+			if (!match) return { reason: "invalid" };
+			const candidate = match[1].replace(OWS_EDGES, "");
+			if (candidate.length === 0 || hasControl(candidate)) return { reason: "invalid" };
+			candidates.push(candidate);
+		} else {
+			const candidate = value.replace(OWS_EDGES, "");
+			if (candidate.length === 0) return { reason: "invalid" };
+			candidates.push(candidate);
+		}
+	}
+	return candidates.length > 0 ? { candidates } : { reason: "missing" };
+}
+function matchingIndex(candidate, keys) {
+	const encoded = Buffer.from(candidate, "utf8");
+	for (let index = 0; index < keys.length; index += 1) {
+		const key = keys[index];
+		if (encoded.length === key.length && (0, node_crypto.timingSafeEqual)(encoded, key)) return index;
+	}
+}
+function validateRequestApiKey(req, policy) {
+	if (!policy.enabled) return { ok: true };
+	const extracted = rawCandidates(req);
+	if (!extracted.candidates) return {
+		ok: false,
+		reason: extracted.reason
+	};
+	let resolved;
+	for (const candidate of extracted.candidates) {
+		const index = matchingIndex(candidate, policy.keys);
+		if (index === void 0) return {
+			ok: false,
+			reason: "invalid"
+		};
+		if (resolved !== void 0 && resolved !== index) return {
+			ok: false,
+			reason: "conflict"
+		};
+		resolved = index;
+	}
+	return { ok: true };
+}
+/** @internal Opaque egress marker; it deliberately carries no key material. */
+function markAuthenticatedRequest(req, policy) {
+	if (policy.enabled) authenticatedRequests.add(req);
+}
+/** @internal Used by egress paths to select safe credential handling. */
+function isAuthenticatedRequest(req) {
+	return authenticatedRequests.has(req);
+}
+function writeApiKeyHttpRejection(res, setCorsHeaders) {
+	setCorsHeaders(res);
+	res.writeHead(401, {
+		"Content-Type": "application/json",
+		"Content-Length": Buffer.byteLength(API_KEY_ERROR_BODY),
+		"WWW-Authenticate": "Bearer realm=\"aimock\""
+	});
+	res.end(API_KEY_ERROR_BODY);
+}
+function writeApiKeyUpgradeRejection(socket) {
+	socket.write([
+		"HTTP/1.1 401 Unauthorized",
+		"Content-Type: application/json",
+		`Content-Length: ${Buffer.byteLength(API_KEY_ERROR_BODY)}`,
+		"WWW-Authenticate: Bearer realm=\"aimock\"",
+		"Connection: close",
+		"",
+		API_KEY_ERROR_BODY
+	].join("\r\n"));
+	socket.destroy();
+}
+
+//#endregion
+exports.isAuthenticatedRequest = isAuthenticatedRequest;
+exports.isRecognizedApiKeyHeader = isRecognizedApiKeyHeader;
+exports.markAuthenticatedRequest = markAuthenticatedRequest;
+exports.resolveInboundAuth = resolveInboundAuth;
+exports.selectInboundAuthSource = selectInboundAuthSource;
+exports.validateRequestApiKey = validateRequestApiKey;
+exports.writeApiKeyHttpRejection = writeApiKeyHttpRejection;
+exports.writeApiKeyUpgradeRejection = writeApiKeyUpgradeRejection;
+//# sourceMappingURL=api-key-auth.cjs.map

package/dist/api-key-auth.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-auth.cjs","names":[],"sources":["../src/api-key-auth.ts"],"sourcesContent":["import { timingSafeEqual } from \"node:crypto\";\nimport type * as http from \"node:http\";\nimport type * as net from \"node:net\";\nimport type { ApiKeyAuthConfig } from \"./types.js\";\n\nexport const INBOUND_API_KEY_HEADERS = [\n  \"authorization\",\n  \"x-api-key\",\n  \"x-goog-api-key\",\n  \"api-key\",\n  \"xi-api-key\",\n] as const;\n\nconst RECOGNIZED_HEADERS = new Set<string>(INBOUND_API_KEY_HEADERS);\n\nexport const API_KEY_ERROR_BODY = JSON.stringify({\n  error: {\n    message: \"Invalid API key\",\n    type: \"authentication_error\",\n    code: \"invalid_api_key\",\n  },\n});\n\n/** @internal */\nexport interface ApiKeyPolicy {\n  readonly enabled: boolean;\n  readonly keys: readonly Buffer[];\n}\n\n/** @internal */\nexport interface ResolvedInboundAuth {\n  readonly publicConfig?: ApiKeyAuthConfig;\n  readonly policy: ApiKeyPolicy;\n}\n\nexport interface AuthResult {\n  readonly ok: boolean;\n  readonly reason?: \"missing\" | \"invalid\" | \"conflict\";\n}\n\nconst DISABLED_POLICY: ApiKeyPolicy = { enabled: false, keys: [] };\nconst authenticatedRequests = new WeakSet<http.IncomingMessage>();\nconst OWS_EDGES = /^[ \\t]+|[ \\t]+$/g;\n\nfunction fail(label: string, suffix: string): never {\n  throw new Error(`${label}${suffix}`);\n}\n\nfunction hasControl(value: string): boolean {\n  for (let index = 0; index < value.length; index += 1) {\n    const code = value.charCodeAt(index);\n    if (code <= 0x1f || code === 0x7f) return true;\n  }\n  return false;\n}\n\nfunction normalizeKey(value: unknown, label: string): string {\n  if (typeof value !== \"string\") fail(label, \" must be a string\");\n  const normalized = value.replace(OWS_EDGES, \"\");\n  if (normalized.length === 0) fail(label, \" must not be empty\");\n  if (hasControl(normalized)) fail(label, \" must not contain control characters\");\n  return normalized;\n}\n\n/** Parse a public auth source once and construct its private server policy. */\nexport function resolveInboundAuth(source: { value: unknown; label: string }): ResolvedInboundAuth {\n  if (source.value === undefined) return { policy: DISABLED_POLICY };\n  if (source.value === null || typeof source.value !== \"object\" || Array.isArray(source.value)) {\n    fail(source.label, \" must be an object\");\n  }\n  const apiKeys = (source.value as { apiKeys?: unknown }).apiKeys;\n  if (!Array.isArray(apiKeys)) fail(`${source.label}.apiKeys`, \" must be an array\");\n  if (apiKeys.length === 0) fail(`${source.label}.apiKeys`, \" must not be empty\");\n  const keys = apiKeys.map((value, index) =>\n    normalizeKey(value, `${source.label}.apiKeys[${index}]`),\n  );\n  const seen = new Set<string>();\n  for (const key of keys) {\n    if (seen.has(key)) fail(source.label, \" must not contain duplicate API keys\");\n    seen.add(key);\n  }\n  return {\n    publicConfig: { apiKeys: keys },\n    policy: { enabled: true, keys: keys.map((key) => Buffer.from(key, \"utf8\")) },\n  };\n}\n\n/** Select configuration without parsing it, so an environment override bypasses malformed JSON auth. */\nexport function selectInboundAuthSource(\n  configAuth: unknown,\n  env: NodeJS.ProcessEnv = process.env,\n): { value: unknown; label: string } {\n  if (Object.prototype.hasOwnProperty.call(env, \"AIMOCK_API_KEYS\")) {\n    return { value: { apiKeys: (env.AIMOCK_API_KEYS ?? \"\").split(\",\") }, label: \"AIMOCK_API_KEYS\" };\n  }\n  return { value: configAuth, label: \"aimock.json.auth\" };\n}\n\nexport function isRecognizedApiKeyHeader(name: string): boolean {\n  return RECOGNIZED_HEADERS.has(name.toLowerCase());\n}\n\nfunction rawCandidates(req: http.IncomingMessage): {\n  candidates?: string[];\n  reason?: \"missing\" | \"invalid\";\n} {\n  const candidates: string[] = [];\n  for (let index = 0; index < req.rawHeaders.length; index += 2) {\n    const name = req.rawHeaders[index];\n    const value = req.rawHeaders[index + 1] ?? \"\";\n    const lower = name.toLowerCase();\n    if (!isRecognizedApiKeyHeader(lower)) continue;\n    if (hasControl(value)) return { reason: \"invalid\" };\n    if (lower === \"authorization\") {\n      const match = /^(?:Bearer|Key)[ \\t]+(.+)$/i.exec(value.replace(OWS_EDGES, \"\"));\n      if (!match) return { reason: \"invalid\" };\n      const candidate = match[1].replace(OWS_EDGES, \"\");\n      if (candidate.length === 0 || hasControl(candidate)) return { reason: \"invalid\" };\n      candidates.push(candidate);\n    } else {\n      const candidate = value.replace(OWS_EDGES, \"\");\n      if (candidate.length === 0) return { reason: \"invalid\" };\n      candidates.push(candidate);\n    }\n  }\n  return candidates.length > 0 ? { candidates } : { reason: \"missing\" };\n}\n\nfunction matchingIndex(candidate: string, keys: readonly Buffer[]): number | undefined {\n  const encoded = Buffer.from(candidate, \"utf8\");\n  for (let index = 0; index < keys.length; index += 1) {\n    const key = keys[index];\n    if (encoded.length === key.length && timingSafeEqual(encoded, key)) return index;\n  }\n  return undefined;\n}\n\nexport function validateRequestApiKey(req: http.IncomingMessage, policy: ApiKeyPolicy): AuthResult {\n  if (!policy.enabled) return { ok: true };\n  const extracted = rawCandidates(req);\n  if (!extracted.candidates) return { ok: false, reason: extracted.reason };\n  let resolved: number | undefined;\n  for (const candidate of extracted.candidates) {\n    const index = matchingIndex(candidate, policy.keys);\n    if (index === undefined) return { ok: false, reason: \"invalid\" };\n    if (resolved !== undefined && resolved !== index) return { ok: false, reason: \"conflict\" };\n    resolved = index;\n  }\n  return { ok: true };\n}\n\n/** @internal Opaque egress marker; it deliberately carries no key material. */\nexport function markAuthenticatedRequest(req: http.IncomingMessage, policy: ApiKeyPolicy): void {\n  if (policy.enabled) authenticatedRequests.add(req);\n}\n\n/** @internal Used by egress paths to select safe credential handling. */\nexport function isAuthenticatedRequest(req: http.IncomingMessage): boolean {\n  return authenticatedRequests.has(req);\n}\n\nexport function writeApiKeyHttpRejection(\n  res: http.ServerResponse,\n  setCorsHeaders: (res: http.ServerResponse) => void,\n): void {\n  setCorsHeaders(res);\n  res.writeHead(401, {\n    \"Content-Type\": \"application/json\",\n    \"Content-Length\": Buffer.byteLength(API_KEY_ERROR_BODY),\n    \"WWW-Authenticate\": 'Bearer realm=\"aimock\"',\n  });\n  res.end(API_KEY_ERROR_BODY);\n}\n\nexport function writeApiKeyUpgradeRejection(socket: net.Socket): void {\n  socket.write(\n    [\n      \"HTTP/1.1 401 Unauthorized\",\n      \"Content-Type: application/json\",\n      `Content-Length: ${Buffer.byteLength(API_KEY_ERROR_BODY)}`,\n      'WWW-Authenticate: Bearer realm=\"aimock\"',\n      \"Connection: close\",\n      \"\",\n      API_KEY_ERROR_BODY,\n    ].join(\"\\r\\n\"),\n  );\n  socket.destroy();\n}\n"],"mappings":"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"}

package/dist/api-key-auth.d.cts

@@ -0,0 +1,17 @@
+import { ApiKeyAuthConfig } from "./types.cjs";
+
+//#region src/api-key-auth.d.ts
+
+/** @internal */
+interface ApiKeyPolicy {
+  readonly enabled: boolean;
+  readonly keys: readonly Buffer[];
+}
+/** @internal */
+interface ResolvedInboundAuth {
+  readonly publicConfig?: ApiKeyAuthConfig;
+  readonly policy: ApiKeyPolicy;
+}
+//#endregion
+export { ResolvedInboundAuth };
+//# sourceMappingURL=api-key-auth.d.cts.map

package/dist/api-key-auth.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-auth.d.cts","names":[],"sources":["../src/api-key-auth.ts"],"sourcesContent":[],"mappings":";;;;;AA+B0B,UAPT,YAAA,CAOS;WACP,OAAA,EAAA,OAAA;EAAY,SAAA,IAAA,EAAA,SANL,MAMK,EAAA;;;UAFd,mBAAA;0BACS;mBACP"}

package/dist/api-key-auth.d.ts

@@ -0,0 +1,17 @@
+import { ApiKeyAuthConfig } from "./types.js";
+
+//#region src/api-key-auth.d.ts
+
+/** @internal */
+interface ApiKeyPolicy {
+  readonly enabled: boolean;
+  readonly keys: readonly Buffer[];
+}
+/** @internal */
+interface ResolvedInboundAuth {
+  readonly publicConfig?: ApiKeyAuthConfig;
+  readonly policy: ApiKeyPolicy;
+}
+//#endregion
+export { ResolvedInboundAuth };
+//# sourceMappingURL=api-key-auth.d.ts.map

package/dist/api-key-auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-key-auth.d.ts","names":[],"sources":["../src/api-key-auth.ts"],"sourcesContent":[],"mappings":";;;;;AA+B0B,UAPT,YAAA,CAOS;WACP,OAAA,EAAA,OAAA;EAAY,SAAA,IAAA,EAAA,SANL,MAMK,EAAA;;;UAFd,mBAAA;0BACS;mBACP"}

package/dist/api-key-auth.js

@@ -0,0 +1,158 @@
+import { timingSafeEqual } from "node:crypto";
+
+//#region src/api-key-auth.ts
+const INBOUND_API_KEY_HEADERS = [
+	"authorization",
+	"x-api-key",
+	"x-goog-api-key",
+	"api-key",
+	"xi-api-key"
+];
+const RECOGNIZED_HEADERS = new Set(INBOUND_API_KEY_HEADERS);
+const API_KEY_ERROR_BODY = JSON.stringify({ error: {
+	message: "Invalid API key",
+	type: "authentication_error",
+	code: "invalid_api_key"
+} });
+const DISABLED_POLICY = {
+	enabled: false,
+	keys: []
+};
+const authenticatedRequests = /* @__PURE__ */ new WeakSet();
+const OWS_EDGES = /^[ \t]+|[ \t]+$/g;
+function fail(label, suffix) {
+	throw new Error(`${label}${suffix}`);
+}
+function hasControl(value) {
+	for (let index = 0; index < value.length; index += 1) {
+		const code = value.charCodeAt(index);
+		if (code <= 31 || code === 127) return true;
+	}
+	return false;
+}
+function normalizeKey(value, label) {
+	if (typeof value !== "string") fail(label, " must be a string");
+	const normalized = value.replace(OWS_EDGES, "");
+	if (normalized.length === 0) fail(label, " must not be empty");
+	if (hasControl(normalized)) fail(label, " must not contain control characters");
+	return normalized;
+}
+/** Parse a public auth source once and construct its private server policy. */
+function resolveInboundAuth(source) {
+	if (source.value === void 0) return { policy: DISABLED_POLICY };
+	if (source.value === null || typeof source.value !== "object" || Array.isArray(source.value)) fail(source.label, " must be an object");
+	const apiKeys = source.value.apiKeys;
+	if (!Array.isArray(apiKeys)) fail(`${source.label}.apiKeys`, " must be an array");
+	if (apiKeys.length === 0) fail(`${source.label}.apiKeys`, " must not be empty");
+	const keys = apiKeys.map((value, index) => normalizeKey(value, `${source.label}.apiKeys[${index}]`));
+	const seen = /* @__PURE__ */ new Set();
+	for (const key of keys) {
+		if (seen.has(key)) fail(source.label, " must not contain duplicate API keys");
+		seen.add(key);
+	}
+	return {
+		publicConfig: { apiKeys: keys },
+		policy: {
+			enabled: true,
+			keys: keys.map((key) => Buffer.from(key, "utf8"))
+		}
+	};
+}
+/** Select configuration without parsing it, so an environment override bypasses malformed JSON auth. */
+function selectInboundAuthSource(configAuth, env = process.env) {
+	if (Object.prototype.hasOwnProperty.call(env, "AIMOCK_API_KEYS")) return {
+		value: { apiKeys: (env.AIMOCK_API_KEYS ?? "").split(",") },
+		label: "AIMOCK_API_KEYS"
+	};
+	return {
+		value: configAuth,
+		label: "aimock.json.auth"
+	};
+}
+function isRecognizedApiKeyHeader(name) {
+	return RECOGNIZED_HEADERS.has(name.toLowerCase());
+}
+function rawCandidates(req) {
+	const candidates = [];
+	for (let index = 0; index < req.rawHeaders.length; index += 2) {
+		const name = req.rawHeaders[index];
+		const value = req.rawHeaders[index + 1] ?? "";
+		const lower = name.toLowerCase();
+		if (!isRecognizedApiKeyHeader(lower)) continue;
+		if (hasControl(value)) return { reason: "invalid" };
+		if (lower === "authorization") {
+			const match = /^(?:Bearer|Key)[ \t]+(.+)$/i.exec(value.replace(OWS_EDGES, ""));
+			if (!match) return { reason: "invalid" };
+			const candidate = match[1].replace(OWS_EDGES, "");
+			if (candidate.length === 0 || hasControl(candidate)) return { reason: "invalid" };
+			candidates.push(candidate);
+		} else {
+			const candidate = value.replace(OWS_EDGES, "");
+			if (candidate.length === 0) return { reason: "invalid" };
+			candidates.push(candidate);
+		}
+	}
+	return candidates.length > 0 ? { candidates } : { reason: "missing" };
+}
+function matchingIndex(candidate, keys) {
+	const encoded = Buffer.from(candidate, "utf8");
+	for (let index = 0; index < keys.length; index += 1) {
+		const key = keys[index];
+		if (encoded.length === key.length && timingSafeEqual(encoded, key)) return index;
+	}
+}
+function validateRequestApiKey(req, policy) {
+	if (!policy.enabled) return { ok: true };
+	const extracted = rawCandidates(req);
+	if (!extracted.candidates) return {
+		ok: false,
+		reason: extracted.reason
+	};
+	let resolved;
+	for (const candidate of extracted.candidates) {
+		const index = matchingIndex(candidate, policy.keys);
+		if (index === void 0) return {
+			ok: false,
+			reason: "invalid"
+		};
+		if (resolved !== void 0 && resolved !== index) return {
+			ok: false,
+			reason: "conflict"
+		};
+		resolved = index;
+	}
+	return { ok: true };
+}
+/** @internal Opaque egress marker; it deliberately carries no key material. */
+function markAuthenticatedRequest(req, policy) {
+	if (policy.enabled) authenticatedRequests.add(req);
+}
+/** @internal Used by egress paths to select safe credential handling. */
+function isAuthenticatedRequest(req) {
+	return authenticatedRequests.has(req);
+}
+function writeApiKeyHttpRejection(res, setCorsHeaders) {
+	setCorsHeaders(res);
+	res.writeHead(401, {
+		"Content-Type": "application/json",
+		"Content-Length": Buffer.byteLength(API_KEY_ERROR_BODY),
+		"WWW-Authenticate": "Bearer realm=\"aimock\""
+	});
+	res.end(API_KEY_ERROR_BODY);
+}
+function writeApiKeyUpgradeRejection(socket) {
+	socket.write([
+		"HTTP/1.1 401 Unauthorized",
+		"Content-Type: application/json",
+		`Content-Length: ${Buffer.byteLength(API_KEY_ERROR_BODY)}`,
+		"WWW-Authenticate: Bearer realm=\"aimock\"",
+		"Connection: close",
+		"",
+		API_KEY_ERROR_BODY
+	].join("\r\n"));
+	socket.destroy();
+}
+
+//#endregion
+export { isAuthenticatedRequest, isRecognizedApiKeyHeader, markAuthenticatedRequest, resolveInboundAuth, selectInboundAuthSource, validateRequestApiKey, writeApiKeyHttpRejection, writeApiKeyUpgradeRejection };
+//# sourceMappingURL=api-key-auth.js.map