@123toto/ai-app-assistant-server 0.1.0

package/dist/chunk-OA7OXUK7.js

@@ -0,0 +1,136 @@
+// src/http.ts
+import {
+  askDocumentationRequestSchema
+} from "@123toto/ai-app-assistant-contracts";
+import { ZodError } from "zod";
+var AiDocsRequestError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "AiDocsRequestError";
+  }
+  status;
+  code;
+};
+function createAiDocsFetchHandlers(options) {
+  const prepare = async (request) => {
+    assertPost(request);
+    const raw = await readJson(request, options.maxBodyBytes ?? 86e5);
+    const validated = askDocumentationRequestSchema.parse(raw);
+    if (!options.resolveContext && !options.authorize && !options.allowAnonymous) {
+      throw new AiDocsRequestError(401, "unauthorized", "Authentication is required");
+    }
+    const context = options.resolveContext ? await options.resolveContext(request) : void 0;
+    await options.authorize?.(context, request);
+    const input = options.transformRequest ? await options.transformRequest(validated, context) : validated;
+    return { input: askDocumentationRequestSchema.parse(input), context };
+  };
+  const present = async (response, context) => options.transformResponse ? options.transformResponse(response, context) : response;
+  const ask = async (request) => {
+    try {
+      const { input, context } = await prepare(request);
+      return jsonResponse(await present(await options.assistant.answer(input, {
+        signal: request.signal
+      }), context));
+    } catch (error) {
+      return mapError(error, request, options.onError);
+    }
+  };
+  const stream = async (request) => {
+    try {
+      const { input, context } = await prepare(request);
+      const encoder = new TextEncoder();
+      const body = new ReadableStream({
+        async start(controller) {
+          try {
+            const generation = options.assistant.stream(input, { signal: request.signal });
+            while (true) {
+              const next = await generation.next();
+              if (next.done) break;
+              let event = next.value.type === "complete" ? { ...next.value, response: await present(next.value.response, context) } : next.value;
+              if (options.transformStreamEvent) {
+                event = await options.transformStreamEvent(event, context);
+              }
+              controller.enqueue(encoder.encode(`${JSON.stringify(event)}
+`));
+            }
+          } catch {
+            controller.enqueue(encoder.encode(`${JSON.stringify({
+              type: "error",
+              message: "The assistant response could not be generated.",
+              retryable: false
+            })}
+`));
+          } finally {
+            controller.close();
+          }
+        }
+      });
+      return new Response(body, {
+        status: 200,
+        headers: {
+          "cache-control": "no-store",
+          "content-type": "application/x-ndjson; charset=utf-8",
+          "x-content-type-options": "nosniff"
+        }
+      });
+    } catch (error) {
+      return mapError(error, request, options.onError);
+    }
+  };
+  return {
+    ask,
+    stream,
+    handle: (request) => new URL(request.url).pathname.endsWith("/stream") ? stream(request) : ask(request)
+  };
+}
+function assertPost(request) {
+  if (request.method !== "POST") {
+    throw new AiDocsRequestError(405, "method_not_allowed", "Only POST is supported");
+  }
+}
+async function readJson(request, maxBodyBytes) {
+  const contentLength = Number(request.headers.get("content-length"));
+  if (Number.isFinite(contentLength) && contentLength > maxBodyBytes) {
+    throw new AiDocsRequestError(413, "request_too_large", "Request body is too large");
+  }
+  const text = await request.text();
+  if (new TextEncoder().encode(text).byteLength > maxBodyBytes) {
+    throw new AiDocsRequestError(413, "request_too_large", "Request body is too large");
+  }
+  try {
+    return JSON.parse(text);
+  } catch {
+    throw new AiDocsRequestError(400, "invalid_json", "Request body must be valid JSON");
+  }
+}
+async function mapError(error, request, customMapper) {
+  if (customMapper) return customMapper(error, request);
+  if (error instanceof AiDocsRequestError) {
+    return jsonResponse({ error: error.code, message: error.message }, error.status);
+  }
+  if (error instanceof ZodError) {
+    return jsonResponse({ error: "invalid_request", message: "The assistant request is invalid." }, 400);
+  }
+  return jsonResponse({
+    error: "assistant_error",
+    message: "The assistant response could not be generated."
+  }, 500);
+}
+function jsonResponse(value, status = 200) {
+  return new Response(JSON.stringify(value), {
+    status,
+    headers: {
+      "cache-control": "no-store",
+      "content-type": "application/json; charset=utf-8",
+      "x-content-type-options": "nosniff"
+    }
+  });
+}
+
+export {
+  AiDocsRequestError,
+  createAiDocsFetchHandlers
+};
+//# sourceMappingURL=chunk-OA7OXUK7.js.map

package/dist/chunk-OA7OXUK7.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/http.ts"],"sourcesContent":["import {\n  askDocumentationRequestSchema,\n  type AskDocumentationRequest,\n  type AskDocumentationResponse\n} from \"@123toto/ai-app-assistant-contracts\";\nimport { ZodError } from \"zod\";\nimport type { DocsAssistant, DocsAssistantStreamEvent } from \"./assistant.js\";\n\nexport interface AiDocsFetchHandlerOptions<TContext = undefined> {\n  assistant: DocsAssistant;\n  /** Resolves framework-specific authentication into an application context. */\n  resolveContext?: (request: Request) => Promise<TContext> | TContext;\n  /** Optional application authorization executed before assistant work. */\n  authorize?: (context: TContext, request: Request) => Promise<void> | void;\n  /** Explicit opt-in for public prototypes without authentication hooks. */\n  allowAnonymous?: boolean;\n  /** Optional privacy/input policy applied after protocol validation. */\n  transformRequest?: (\n    input: AskDocumentationRequest,\n    context: TContext\n  ) => Promise<AskDocumentationRequest> | AskDocumentationRequest;\n  /** Optional privacy/output policy applied before serialization. */\n  transformResponse?: (\n    response: AskDocumentationResponse,\n    context: TContext\n  ) => Promise<AskDocumentationResponse> | AskDocumentationResponse;\n  /** Applies privacy rules to progressive text before it leaves the backend. */\n  transformStreamEvent?: (\n    event: DocsAssistantStreamEvent,\n    context: TContext\n  ) => Promise<DocsAssistantStreamEvent> | DocsAssistantStreamEvent;\n  /** Maximum HTTP request size. Defaults slightly above the protocol limit. */\n  maxBodyBytes?: number;\n  /** Maps application errors without coupling the library to one framework. */\n  onError?: (error: unknown, request: Request) => Promise<Response> | Response;\n}\n\nexport interface AiDocsFetchHandlers {\n  ask(request: Request): Promise<Response>;\n  stream(request: Request): Promise<Response>;\n  /** Dispatches to `stream` when the pathname ends in `/stream`, otherwise to `ask`. */\n  handle(request: Request): Promise<Response>;\n}\n\n/** Explicit safe HTTP error that host authorization hooks can throw. */\nexport class AiDocsRequestError extends Error {\n  public constructor(\n    readonly status: number,\n    readonly code: string,\n    message: string\n  ) {\n    super(message);\n    this.name = \"AiDocsRequestError\";\n  }\n}\n\n/**\n * Creates Fetch API handlers usable by standards-based runtimes and thin\n * Express, Fastify, Nest, Next.js, Hono, Bun or serverless adapters.\n */\nexport function createAiDocsFetchHandlers<TContext = undefined>(\n  options: AiDocsFetchHandlerOptions<TContext>\n): AiDocsFetchHandlers {\n  const prepare = async (request: Request): Promise<{\n    input: AskDocumentationRequest;\n    context: TContext;\n  }> => {\n    assertPost(request);\n    const raw = await readJson(request, options.maxBodyBytes ?? 8_600_000);\n    const validated = askDocumentationRequestSchema.parse(raw);\n    if (!options.resolveContext && !options.authorize && !options.allowAnonymous) {\n      throw new AiDocsRequestError(401, \"unauthorized\", \"Authentication is required\");\n    }\n    const context = options.resolveContext\n      ? await options.resolveContext(request)\n      : undefined as TContext;\n    await options.authorize?.(context, request);\n    const input = options.transformRequest\n      ? await options.transformRequest(validated, context)\n      : validated;\n    return { input: askDocumentationRequestSchema.parse(input), context };\n  };\n\n  const present = async (\n    response: AskDocumentationResponse,\n    context: TContext\n  ): Promise<AskDocumentationResponse> => options.transformResponse\n    ? options.transformResponse(response, context)\n    : response;\n\n  const ask = async (request: Request): Promise<Response> => {\n    try {\n      const { input, context } = await prepare(request);\n      return jsonResponse(await present(await options.assistant.answer(input, {\n        signal: request.signal\n      }), context));\n    } catch (error) {\n      return mapError(error, request, options.onError);\n    }\n  };\n\n  const stream = async (request: Request): Promise<Response> => {\n    try {\n      const { input, context } = await prepare(request);\n      const encoder = new TextEncoder();\n      const body = new ReadableStream<Uint8Array>({\n        async start(controller) {\n          try {\n            const generation = options.assistant.stream(input, { signal: request.signal });\n            while (true) {\n              const next = await generation.next();\n              if (next.done) break;\n              let event = next.value.type === \"complete\"\n                ? { ...next.value, response: await present(next.value.response, context) }\n                : next.value;\n              if (options.transformStreamEvent) {\n                event = await options.transformStreamEvent(event, context);\n              }\n              controller.enqueue(encoder.encode(`${JSON.stringify(event)}\\n`));\n            }\n          } catch {\n            controller.enqueue(encoder.encode(`${JSON.stringify({\n              type: \"error\",\n              message: \"The assistant response could not be generated.\",\n              retryable: false\n            })}\\n`));\n          } finally {\n            controller.close();\n          }\n        }\n      });\n      return new Response(body, {\n        status: 200,\n        headers: {\n          \"cache-control\": \"no-store\",\n          \"content-type\": \"application/x-ndjson; charset=utf-8\",\n          \"x-content-type-options\": \"nosniff\"\n        }\n      });\n    } catch (error) {\n      return mapError(error, request, options.onError);\n    }\n  };\n\n  return {\n    ask,\n    stream,\n    handle: (request) => new URL(request.url).pathname.endsWith(\"/stream\")\n      ? stream(request)\n      : ask(request)\n  };\n}\n\nfunction assertPost(request: Request): void {\n  if (request.method !== \"POST\") {\n    throw new AiDocsRequestError(405, \"method_not_allowed\", \"Only POST is supported\");\n  }\n}\n\nasync function readJson(request: Request, maxBodyBytes: number): Promise<unknown> {\n  const contentLength = Number(request.headers.get(\"content-length\"));\n  if (Number.isFinite(contentLength) && contentLength > maxBodyBytes) {\n    throw new AiDocsRequestError(413, \"request_too_large\", \"Request body is too large\");\n  }\n  const text = await request.text();\n  if (new TextEncoder().encode(text).byteLength > maxBodyBytes) {\n    throw new AiDocsRequestError(413, \"request_too_large\", \"Request body is too large\");\n  }\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    throw new AiDocsRequestError(400, \"invalid_json\", \"Request body must be valid JSON\");\n  }\n}\n\nasync function mapError(\n  error: unknown,\n  request: Request,\n  customMapper?: AiDocsFetchHandlerOptions<unknown>[\"onError\"]\n): Promise<Response> {\n  if (customMapper) return customMapper(error, request);\n  if (error instanceof AiDocsRequestError) {\n    return jsonResponse({ error: error.code, message: error.message }, error.status);\n  }\n  if (error instanceof ZodError) {\n    return jsonResponse({ error: \"invalid_request\", message: \"The assistant request is invalid.\" }, 400);\n  }\n  return jsonResponse({\n    error: \"assistant_error\",\n    message: \"The assistant response could not be generated.\"\n  }, 500);\n}\n\nfunction jsonResponse(value: unknown, status = 200): Response {\n  return new Response(JSON.stringify(value), {\n    status,\n    headers: {\n      \"cache-control\": \"no-store\",\n      \"content-type\": \"application/json; charset=utf-8\",\n      \"x-content-type-options\": \"nosniff\"\n    }\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/express.cjs

@@ -0,0 +1,137 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/express.ts
+var express_exports = {};
+__export(express_exports, {
+  createManagedAiDocsExpressHandler: () => createManagedAiDocsExpressHandler
+});
+module.exports = __toCommonJS(express_exports);
+
+// src/http.ts
+var import_ai_app_assistant_contracts = require("@123toto/ai-app-assistant-contracts");
+var import_zod = require("zod");
+var AiDocsRequestError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "AiDocsRequestError";
+  }
+  status;
+  code;
+};
+
+// src/express.ts
+function createManagedAiDocsExpressHandler(server, options = {}) {
+  return async (request, response, next) => {
+    const abortController = new AbortController();
+    const abort = () => abortController.abort(new DOMException("Client disconnected", "AbortError"));
+    request.on?.("close", abort);
+    try {
+      const webRequest = await toFetchRequest(request, abortController.signal, options);
+      const result = await server.fetch.handle(webRequest, request);
+      if (options.fallthrough && result.status === 404 && next) {
+        next();
+        return;
+      }
+      await writeFetchResponse(response, result);
+    } catch (error) {
+      if (next) {
+        next(error);
+        return;
+      }
+      writeConnectorError(response, error);
+    } finally {
+      request.off?.("close", abort);
+    }
+  };
+}
+async function toFetchRequest(request, signal, options) {
+  const headers = new Headers();
+  for (const [name, value] of Object.entries(request.headers)) {
+    if (Array.isArray(value)) value.forEach((item) => headers.append(name, item));
+    else if (value !== void 0) headers.set(name, value);
+  }
+  const method = request.method?.toUpperCase() || "GET";
+  const host = headers.get("host");
+  const protocol = request.protocol || headers.get("x-forwarded-proto") || "http";
+  const origin = options.origin ?? `${protocol}://${host || "localhost"}`;
+  const url = new URL(request.originalUrl || request.url || "/", origin);
+  const body = method === "GET" || method === "HEAD" ? void 0 : request.body !== void 0 ? serializeBody(request.body, headers) : await readBody(request, options.maxBodyBytes ?? 86e5);
+  return new Request(url, {
+    method,
+    headers,
+    signal,
+    ...body !== void 0 ? { body } : {}
+  });
+}
+function serializeBody(body, headers) {
+  if (typeof body === "string") return body;
+  if (body instanceof Uint8Array) return new TextDecoder().decode(body);
+  if (!headers.has("content-type")) headers.set("content-type", "application/json");
+  return JSON.stringify(body) ?? "null";
+}
+async function readBody(request, maxBodyBytes) {
+  if (!(Symbol.asyncIterator in request)) return void 0;
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of request) {
+    const bytes = typeof chunk === "string" ? Buffer.from(chunk) : new Uint8Array(chunk);
+    size += bytes.byteLength;
+    if (size > maxBodyBytes) {
+      throw new AiDocsRequestError(413, "request_too_large", "Request body is too large");
+    }
+    chunks.push(bytes);
+  }
+  return chunks.length ? Buffer.concat(chunks).toString("utf8") : void 0;
+}
+async function writeFetchResponse(response, result) {
+  response.statusCode = result.status;
+  result.headers.forEach((value, name) => response.setHeader(name, value));
+  if (!result.body) {
+    response.end();
+    return;
+  }
+  const reader = result.body.getReader();
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (!response.write(value) && response.once) {
+        await new Promise((resolve) => response.once("drain", resolve));
+      }
+    }
+    if (!response.destroyed) response.end();
+  } finally {
+    reader.releaseLock();
+  }
+}
+function writeConnectorError(response, error) {
+  const status = error instanceof AiDocsRequestError ? error.status : 500;
+  const code = error instanceof AiDocsRequestError ? error.code : "assistant_error";
+  response.statusCode = status;
+  response.setHeader("content-type", "application/json; charset=utf-8");
+  response.end(JSON.stringify({ error: code }));
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  createManagedAiDocsExpressHandler
+});
+//# sourceMappingURL=express.cjs.map

package/dist/express.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/express.ts","../src/http.ts"],"sourcesContent":["import { AiDocsRequestError } from \"./http.js\";\nimport type { ManagedAiDocsServer } from \"./managed-server.js\";\n\n/** Minimal Express request shape; importing Express types is intentionally unnecessary. */\nexport interface AiDocsExpressRequest {\n  method?: string;\n  originalUrl?: string;\n  url?: string;\n  protocol?: string;\n  headers: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  on?(event: string, listener: () => void): unknown;\n  off?(event: string, listener: () => void): unknown;\n  [key: string]: unknown;\n}\n\n/** Minimal Express response shape used by the connector. */\nexport interface AiDocsExpressResponse {\n  statusCode: number;\n  setHeader(name: string, value: string): unknown;\n  write(chunk: Uint8Array): boolean;\n  end(chunk?: string): unknown;\n  once?(event: string, listener: () => void): unknown;\n  destroyed?: boolean;\n}\n\nexport type AiDocsExpressNext = (error?: unknown) => void;\n\nexport type AiDocsExpressManagedServer<\n  TRequest extends AiDocsExpressRequest = AiDocsExpressRequest\n> = Pick<ManagedAiDocsServer<{ id: string; label: string }, TRequest>, \"fetch\">;\n\nexport interface AiDocsExpressHandlerOptions {\n  /** Origin used only when Express does not expose a Host header. */\n  origin?: string;\n  /** Maximum size accepted when no JSON body parser populated request.body. */\n  maxBodyBytes?: number;\n  /** Lets another Express handler process unknown routes below the mounted prefix. */\n  fallthrough?: boolean;\n}\n\nexport type AiDocsExpressHandler<TRequest extends AiDocsExpressRequest> = (\n  request: TRequest,\n  response: AiDocsExpressResponse,\n  next?: AiDocsExpressNext\n) => Promise<void>;\n\n/**\n * Creates an Express-compatible handler for the complete managed API.\n *\n * @example\n * `app.use(\"/api/ai-docs\", createManagedAiDocsExpressHandler(aiDocs));`\n */\nexport function createManagedAiDocsExpressHandler<\n  TRequest extends AiDocsExpressRequest = AiDocsExpressRequest\n>(\n  server: AiDocsExpressManagedServer<TRequest>,\n  options: AiDocsExpressHandlerOptions = {}\n): AiDocsExpressHandler<TRequest> {\n  return async (request, response, next) => {\n    const abortController = new AbortController();\n    const abort = (): void => abortController.abort(new DOMException(\"Client disconnected\", \"AbortError\"));\n    request.on?.(\"close\", abort);\n    try {\n      const webRequest = await toFetchRequest(request, abortController.signal, options);\n      const result = await server.fetch.handle(webRequest, request);\n      if (options.fallthrough && result.status === 404 && next) {\n        next();\n        return;\n      }\n      await writeFetchResponse(response, result);\n    } catch (error) {\n      if (next) {\n        next(error);\n        return;\n      }\n      writeConnectorError(response, error);\n    } finally {\n      request.off?.(\"close\", abort);\n    }\n  };\n}\n\nasync function toFetchRequest(\n  request: AiDocsExpressRequest,\n  signal: AbortSignal,\n  options: AiDocsExpressHandlerOptions\n): Promise<Request> {\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(request.headers)) {\n    if (Array.isArray(value)) value.forEach((item) => headers.append(name, item));\n    else if (value !== undefined) headers.set(name, value);\n  }\n  const method = request.method?.toUpperCase() || \"GET\";\n  const host = headers.get(\"host\");\n  const protocol = request.protocol || headers.get(\"x-forwarded-proto\") || \"http\";\n  const origin = options.origin ?? `${protocol}://${host || \"localhost\"}`;\n  // originalUrl preserves the mount prefix stripped from request.url by Express.\n  const url = new URL(request.originalUrl || request.url || \"/\", origin);\n  const body = method === \"GET\" || method === \"HEAD\"\n    ? undefined\n    : request.body !== undefined\n      ? serializeBody(request.body, headers)\n      : await readBody(request, options.maxBodyBytes ?? 8_600_000);\n  return new Request(url, {\n    method,\n    headers,\n    signal,\n    ...(body !== undefined ? { body } : {})\n  });\n}\n\nfunction serializeBody(body: unknown, headers: Headers): string {\n  if (typeof body === \"string\") return body;\n  if (body instanceof Uint8Array) return new TextDecoder().decode(body);\n  if (!headers.has(\"content-type\")) headers.set(\"content-type\", \"application/json\");\n  return JSON.stringify(body) ?? \"null\";\n}\n\nasync function readBody(request: AiDocsExpressRequest, maxBodyBytes: number): Promise<string | undefined> {\n  if (!(Symbol.asyncIterator in request)) return undefined;\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  for await (const chunk of request as AsyncIterable<string | Uint8Array>) {\n    const bytes = typeof chunk === \"string\" ? Buffer.from(chunk) : new Uint8Array(chunk);\n    size += bytes.byteLength;\n    if (size > maxBodyBytes) {\n      throw new AiDocsRequestError(413, \"request_too_large\", \"Request body is too large\");\n    }\n    chunks.push(bytes);\n  }\n  return chunks.length ? Buffer.concat(chunks).toString(\"utf8\") : undefined;\n}\n\nasync function writeFetchResponse(response: AiDocsExpressResponse, result: Response): Promise<void> {\n  response.statusCode = result.status;\n  result.headers.forEach((value, name) => response.setHeader(name, value));\n  if (!result.body) {\n    response.end();\n    return;\n  }\n  const reader = result.body.getReader();\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      if (!response.write(value) && response.once) {\n        await new Promise<void>((resolve) => response.once!(\"drain\", resolve));\n      }\n    }\n    if (!response.destroyed) response.end();\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction writeConnectorError(response: AiDocsExpressResponse, error: unknown): void {\n  const status = error instanceof AiDocsRequestError ? error.status : 500;\n  const code = error instanceof AiDocsRequestError ? error.code : \"assistant_error\";\n  response.statusCode = status;\n  response.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n  response.end(JSON.stringify({ error: code }));\n}\n","import {\n  askDocumentationRequestSchema,\n  type AskDocumentationRequest,\n  type AskDocumentationResponse\n} from \"@123toto/ai-app-assistant-contracts\";\nimport { ZodError } from \"zod\";\nimport type { DocsAssistant, DocsAssistantStreamEvent } from \"./assistant.js\";\n\nexport interface AiDocsFetchHandlerOptions<TContext = undefined> {\n  assistant: DocsAssistant;\n  /** Resolves framework-specific authentication into an application context. */\n  resolveContext?: (request: Request) => Promise<TContext> | TContext;\n  /** Optional application authorization executed before assistant work. */\n  authorize?: (context: TContext, request: Request) => Promise<void> | void;\n  /** Explicit opt-in for public prototypes without authentication hooks. */\n  allowAnonymous?: boolean;\n  /** Optional privacy/input policy applied after protocol validation. */\n  transformRequest?: (\n    input: AskDocumentationRequest,\n    context: TContext\n  ) => Promise<AskDocumentationRequest> | AskDocumentationRequest;\n  /** Optional privacy/output policy applied before serialization. */\n  transformResponse?: (\n    response: AskDocumentationResponse,\n    context: TContext\n  ) => Promise<AskDocumentationResponse> | AskDocumentationResponse;\n  /** Applies privacy rules to progressive text before it leaves the backend. */\n  transformStreamEvent?: (\n    event: DocsAssistantStreamEvent,\n    context: TContext\n  ) => Promise<DocsAssistantStreamEvent> | DocsAssistantStreamEvent;\n  /** Maximum HTTP request size. Defaults slightly above the protocol limit. */\n  maxBodyBytes?: number;\n  /** Maps application errors without coupling the library to one framework. */\n  onError?: (error: unknown, request: Request) => Promise<Response> | Response;\n}\n\nexport interface AiDocsFetchHandlers {\n  ask(request: Request): Promise<Response>;\n  stream(request: Request): Promise<Response>;\n  /** Dispatches to `stream` when the pathname ends in `/stream`, otherwise to `ask`. */\n  handle(request: Request): Promise<Response>;\n}\n\n/** Explicit safe HTTP error that host authorization hooks can throw. */\nexport class AiDocsRequestError extends Error {\n  public constructor(\n    readonly status: number,\n    readonly code: string,\n    message: string\n  ) {\n    super(message);\n    this.name = \"AiDocsRequestError\";\n  }\n}\n\n/**\n * Creates Fetch API handlers usable by standards-based runtimes and thin\n * Express, Fastify, Nest, Next.js, Hono, Bun or serverless adapters.\n */\nexport function createAiDocsFetchHandlers<TContext = undefined>(\n  options: AiDocsFetchHandlerOptions<TContext>\n): AiDocsFetchHandlers {\n  const prepare = async (request: Request): Promise<{\n    input: AskDocumentationRequest;\n    context: TContext;\n  }> => {\n    assertPost(request);\n    const raw = await readJson(request, options.maxBodyBytes ?? 8_600_000);\n    const validated = askDocumentationRequestSchema.parse(raw);\n    if (!options.resolveContext && !options.authorize && !options.allowAnonymous) {\n      throw new AiDocsRequestError(401, \"unauthorized\", \"Authentication is required\");\n    }\n    const context = options.resolveContext\n      ? await options.resolveContext(request)\n      : undefined as TContext;\n    await options.authorize?.(context, request);\n    const input = options.transformRequest\n      ? await options.transformRequest(validated, context)\n      : validated;\n    return { input: askDocumentationRequestSchema.parse(input), context };\n  };\n\n  const present = async (\n    response: AskDocumentationResponse,\n    context: TContext\n  ): Promise<AskDocumentationResponse> => options.transformResponse\n    ? options.transformResponse(response, context)\n    : response;\n\n  const ask = async (request: Request): Promise<Response> => {\n    try {\n      const { input, context } = await prepare(request);\n      return jsonResponse(await present(await options.assistant.answer(input, {\n        signal: request.signal\n      }), context));\n    } catch (error) {\n      return mapError(error, request, options.onError);\n    }\n  };\n\n  const stream = async (request: Request): Promise<Response> => {\n    try {\n      const { input, context } = await prepare(request);\n      const encoder = new TextEncoder();\n      const body = new ReadableStream<Uint8Array>({\n        async start(controller) {\n          try {\n            const generation = options.assistant.stream(input, { signal: request.signal });\n            while (true) {\n              const next = await generation.next();\n              if (next.done) break;\n              let event = next.value.type === \"complete\"\n                ? { ...next.value, response: await present(next.value.response, context) }\n                : next.value;\n              if (options.transformStreamEvent) {\n                event = await options.transformStreamEvent(event, context);\n              }\n              controller.enqueue(encoder.encode(`${JSON.stringify(event)}\\n`));\n            }\n          } catch {\n            controller.enqueue(encoder.encode(`${JSON.stringify({\n              type: \"error\",\n              message: \"The assistant response could not be generated.\",\n              retryable: false\n            })}\\n`));\n          } finally {\n            controller.close();\n          }\n        }\n      });\n      return new Response(body, {\n        status: 200,\n        headers: {\n          \"cache-control\": \"no-store\",\n          \"content-type\": \"application/x-ndjson; charset=utf-8\",\n          \"x-content-type-options\": \"nosniff\"\n        }\n      });\n    } catch (error) {\n      return mapError(error, request, options.onError);\n    }\n  };\n\n  return {\n    ask,\n    stream,\n    handle: (request) => new URL(request.url).pathname.endsWith(\"/stream\")\n      ? stream(request)\n      : ask(request)\n  };\n}\n\nfunction assertPost(request: Request): void {\n  if (request.method !== \"POST\") {\n    throw new AiDocsRequestError(405, \"method_not_allowed\", \"Only POST is supported\");\n  }\n}\n\nasync function readJson(request: Request, maxBodyBytes: number): Promise<unknown> {\n  const contentLength = Number(request.headers.get(\"content-length\"));\n  if (Number.isFinite(contentLength) && contentLength > maxBodyBytes) {\n    throw new AiDocsRequestError(413, \"request_too_large\", \"Request body is too large\");\n  }\n  const text = await request.text();\n  if (new TextEncoder().encode(text).byteLength > maxBodyBytes) {\n    throw new AiDocsRequestError(413, \"request_too_large\", \"Request body is too large\");\n  }\n  try {\n    return JSON.parse(text) as unknown;\n  } catch {\n    throw new AiDocsRequestError(400, \"invalid_json\", \"Request body must be valid JSON\");\n  }\n}\n\nasync function mapError(\n  error: unknown,\n  request: Request,\n  customMapper?: AiDocsFetchHandlerOptions<unknown>[\"onError\"]\n): Promise<Response> {\n  if (customMapper) return customMapper(error, request);\n  if (error instanceof AiDocsRequestError) {\n    return jsonResponse({ error: error.code, message: error.message }, error.status);\n  }\n  if (error instanceof ZodError) {\n    return jsonResponse({ error: \"invalid_request\", message: \"The assistant request is invalid.\" }, 400);\n  }\n  return jsonResponse({\n    error: \"assistant_error\",\n    message: \"The assistant response could not be generated.\"\n  }, 500);\n}\n\nfunction jsonResponse(value: unknown, status = 200): Response {\n  return new Response(JSON.stringify(value), {\n    status,\n    headers: {\n      \"cache-control\": \"no-store\",\n      \"content-type\": \"application/json; charset=utf-8\",\n      \"x-content-type-options\": \"nosniff\"\n    }\n  });\n}\n"],"mappings":"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","names":[]}

package/dist/express.d.cts

@@ -0,0 +1,49 @@
+import { M as ManagedAiDocsServer } from './managed-server-7iurKxF1.cjs';
+import './ai-sdk-QImICd56.cjs';
+import 'ai';
+import '@123toto/ai-app-assistant-contracts';
+
+/** Minimal Express request shape; importing Express types is intentionally unnecessary. */
+interface AiDocsExpressRequest {
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+    protocol?: string;
+    headers: Record<string, string | string[] | undefined>;
+    body?: unknown;
+    on?(event: string, listener: () => void): unknown;
+    off?(event: string, listener: () => void): unknown;
+    [key: string]: unknown;
+}
+/** Minimal Express response shape used by the connector. */
+interface AiDocsExpressResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): unknown;
+    write(chunk: Uint8Array): boolean;
+    end(chunk?: string): unknown;
+    once?(event: string, listener: () => void): unknown;
+    destroyed?: boolean;
+}
+type AiDocsExpressNext = (error?: unknown) => void;
+type AiDocsExpressManagedServer<TRequest extends AiDocsExpressRequest = AiDocsExpressRequest> = Pick<ManagedAiDocsServer<{
+    id: string;
+    label: string;
+}, TRequest>, "fetch">;
+interface AiDocsExpressHandlerOptions {
+    /** Origin used only when Express does not expose a Host header. */
+    origin?: string;
+    /** Maximum size accepted when no JSON body parser populated request.body. */
+    maxBodyBytes?: number;
+    /** Lets another Express handler process unknown routes below the mounted prefix. */
+    fallthrough?: boolean;
+}
+type AiDocsExpressHandler<TRequest extends AiDocsExpressRequest> = (request: TRequest, response: AiDocsExpressResponse, next?: AiDocsExpressNext) => Promise<void>;
+/**
+ * Creates an Express-compatible handler for the complete managed API.
+ *
+ * @example
+ * `app.use("/api/ai-docs", createManagedAiDocsExpressHandler(aiDocs));`
+ */
+declare function createManagedAiDocsExpressHandler<TRequest extends AiDocsExpressRequest = AiDocsExpressRequest>(server: AiDocsExpressManagedServer<TRequest>, options?: AiDocsExpressHandlerOptions): AiDocsExpressHandler<TRequest>;
+
+export { type AiDocsExpressHandler, type AiDocsExpressHandlerOptions, type AiDocsExpressManagedServer, type AiDocsExpressNext, type AiDocsExpressRequest, type AiDocsExpressResponse, createManagedAiDocsExpressHandler };

package/dist/express.d.ts

@@ -0,0 +1,49 @@
+import { M as ManagedAiDocsServer } from './managed-server-CrZumvVU.js';
+import './ai-sdk-QImICd56.js';
+import 'ai';
+import '@123toto/ai-app-assistant-contracts';
+
+/** Minimal Express request shape; importing Express types is intentionally unnecessary. */
+interface AiDocsExpressRequest {
+    method?: string;
+    originalUrl?: string;
+    url?: string;
+    protocol?: string;
+    headers: Record<string, string | string[] | undefined>;
+    body?: unknown;
+    on?(event: string, listener: () => void): unknown;
+    off?(event: string, listener: () => void): unknown;
+    [key: string]: unknown;
+}
+/** Minimal Express response shape used by the connector. */
+interface AiDocsExpressResponse {
+    statusCode: number;
+    setHeader(name: string, value: string): unknown;
+    write(chunk: Uint8Array): boolean;
+    end(chunk?: string): unknown;
+    once?(event: string, listener: () => void): unknown;
+    destroyed?: boolean;
+}
+type AiDocsExpressNext = (error?: unknown) => void;
+type AiDocsExpressManagedServer<TRequest extends AiDocsExpressRequest = AiDocsExpressRequest> = Pick<ManagedAiDocsServer<{
+    id: string;
+    label: string;
+}, TRequest>, "fetch">;
+interface AiDocsExpressHandlerOptions {
+    /** Origin used only when Express does not expose a Host header. */
+    origin?: string;
+    /** Maximum size accepted when no JSON body parser populated request.body. */
+    maxBodyBytes?: number;
+    /** Lets another Express handler process unknown routes below the mounted prefix. */
+    fallthrough?: boolean;
+}
+type AiDocsExpressHandler<TRequest extends AiDocsExpressRequest> = (request: TRequest, response: AiDocsExpressResponse, next?: AiDocsExpressNext) => Promise<void>;
+/**
+ * Creates an Express-compatible handler for the complete managed API.
+ *
+ * @example
+ * `app.use("/api/ai-docs", createManagedAiDocsExpressHandler(aiDocs));`
+ */
+declare function createManagedAiDocsExpressHandler<TRequest extends AiDocsExpressRequest = AiDocsExpressRequest>(server: AiDocsExpressManagedServer<TRequest>, options?: AiDocsExpressHandlerOptions): AiDocsExpressHandler<TRequest>;
+
+export { type AiDocsExpressHandler, type AiDocsExpressHandlerOptions, type AiDocsExpressManagedServer, type AiDocsExpressNext, type AiDocsExpressRequest, type AiDocsExpressResponse, createManagedAiDocsExpressHandler };

package/dist/express.js

@@ -0,0 +1,100 @@
+import {
+  AiDocsRequestError
+} from "./chunk-OA7OXUK7.js";
+
+// src/express.ts
+function createManagedAiDocsExpressHandler(server, options = {}) {
+  return async (request, response, next) => {
+    const abortController = new AbortController();
+    const abort = () => abortController.abort(new DOMException("Client disconnected", "AbortError"));
+    request.on?.("close", abort);
+    try {
+      const webRequest = await toFetchRequest(request, abortController.signal, options);
+      const result = await server.fetch.handle(webRequest, request);
+      if (options.fallthrough && result.status === 404 && next) {
+        next();
+        return;
+      }
+      await writeFetchResponse(response, result);
+    } catch (error) {
+      if (next) {
+        next(error);
+        return;
+      }
+      writeConnectorError(response, error);
+    } finally {
+      request.off?.("close", abort);
+    }
+  };
+}
+async function toFetchRequest(request, signal, options) {
+  const headers = new Headers();
+  for (const [name, value] of Object.entries(request.headers)) {
+    if (Array.isArray(value)) value.forEach((item) => headers.append(name, item));
+    else if (value !== void 0) headers.set(name, value);
+  }
+  const method = request.method?.toUpperCase() || "GET";
+  const host = headers.get("host");
+  const protocol = request.protocol || headers.get("x-forwarded-proto") || "http";
+  const origin = options.origin ?? `${protocol}://${host || "localhost"}`;
+  const url = new URL(request.originalUrl || request.url || "/", origin);
+  const body = method === "GET" || method === "HEAD" ? void 0 : request.body !== void 0 ? serializeBody(request.body, headers) : await readBody(request, options.maxBodyBytes ?? 86e5);
+  return new Request(url, {
+    method,
+    headers,
+    signal,
+    ...body !== void 0 ? { body } : {}
+  });
+}
+function serializeBody(body, headers) {
+  if (typeof body === "string") return body;
+  if (body instanceof Uint8Array) return new TextDecoder().decode(body);
+  if (!headers.has("content-type")) headers.set("content-type", "application/json");
+  return JSON.stringify(body) ?? "null";
+}
+async function readBody(request, maxBodyBytes) {
+  if (!(Symbol.asyncIterator in request)) return void 0;
+  const chunks = [];
+  let size = 0;
+  for await (const chunk of request) {
+    const bytes = typeof chunk === "string" ? Buffer.from(chunk) : new Uint8Array(chunk);
+    size += bytes.byteLength;
+    if (size > maxBodyBytes) {
+      throw new AiDocsRequestError(413, "request_too_large", "Request body is too large");
+    }
+    chunks.push(bytes);
+  }
+  return chunks.length ? Buffer.concat(chunks).toString("utf8") : void 0;
+}
+async function writeFetchResponse(response, result) {
+  response.statusCode = result.status;
+  result.headers.forEach((value, name) => response.setHeader(name, value));
+  if (!result.body) {
+    response.end();
+    return;
+  }
+  const reader = result.body.getReader();
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (done) break;
+      if (!response.write(value) && response.once) {
+        await new Promise((resolve) => response.once("drain", resolve));
+      }
+    }
+    if (!response.destroyed) response.end();
+  } finally {
+    reader.releaseLock();
+  }
+}
+function writeConnectorError(response, error) {
+  const status = error instanceof AiDocsRequestError ? error.status : 500;
+  const code = error instanceof AiDocsRequestError ? error.code : "assistant_error";
+  response.statusCode = status;
+  response.setHeader("content-type", "application/json; charset=utf-8");
+  response.end(JSON.stringify({ error: code }));
+}
+export {
+  createManagedAiDocsExpressHandler
+};
+//# sourceMappingURL=express.js.map

package/dist/express.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/express.ts"],"sourcesContent":["import { AiDocsRequestError } from \"./http.js\";\nimport type { ManagedAiDocsServer } from \"./managed-server.js\";\n\n/** Minimal Express request shape; importing Express types is intentionally unnecessary. */\nexport interface AiDocsExpressRequest {\n  method?: string;\n  originalUrl?: string;\n  url?: string;\n  protocol?: string;\n  headers: Record<string, string | string[] | undefined>;\n  body?: unknown;\n  on?(event: string, listener: () => void): unknown;\n  off?(event: string, listener: () => void): unknown;\n  [key: string]: unknown;\n}\n\n/** Minimal Express response shape used by the connector. */\nexport interface AiDocsExpressResponse {\n  statusCode: number;\n  setHeader(name: string, value: string): unknown;\n  write(chunk: Uint8Array): boolean;\n  end(chunk?: string): unknown;\n  once?(event: string, listener: () => void): unknown;\n  destroyed?: boolean;\n}\n\nexport type AiDocsExpressNext = (error?: unknown) => void;\n\nexport type AiDocsExpressManagedServer<\n  TRequest extends AiDocsExpressRequest = AiDocsExpressRequest\n> = Pick<ManagedAiDocsServer<{ id: string; label: string }, TRequest>, \"fetch\">;\n\nexport interface AiDocsExpressHandlerOptions {\n  /** Origin used only when Express does not expose a Host header. */\n  origin?: string;\n  /** Maximum size accepted when no JSON body parser populated request.body. */\n  maxBodyBytes?: number;\n  /** Lets another Express handler process unknown routes below the mounted prefix. */\n  fallthrough?: boolean;\n}\n\nexport type AiDocsExpressHandler<TRequest extends AiDocsExpressRequest> = (\n  request: TRequest,\n  response: AiDocsExpressResponse,\n  next?: AiDocsExpressNext\n) => Promise<void>;\n\n/**\n * Creates an Express-compatible handler for the complete managed API.\n *\n * @example\n * `app.use(\"/api/ai-docs\", createManagedAiDocsExpressHandler(aiDocs));`\n */\nexport function createManagedAiDocsExpressHandler<\n  TRequest extends AiDocsExpressRequest = AiDocsExpressRequest\n>(\n  server: AiDocsExpressManagedServer<TRequest>,\n  options: AiDocsExpressHandlerOptions = {}\n): AiDocsExpressHandler<TRequest> {\n  return async (request, response, next) => {\n    const abortController = new AbortController();\n    const abort = (): void => abortController.abort(new DOMException(\"Client disconnected\", \"AbortError\"));\n    request.on?.(\"close\", abort);\n    try {\n      const webRequest = await toFetchRequest(request, abortController.signal, options);\n      const result = await server.fetch.handle(webRequest, request);\n      if (options.fallthrough && result.status === 404 && next) {\n        next();\n        return;\n      }\n      await writeFetchResponse(response, result);\n    } catch (error) {\n      if (next) {\n        next(error);\n        return;\n      }\n      writeConnectorError(response, error);\n    } finally {\n      request.off?.(\"close\", abort);\n    }\n  };\n}\n\nasync function toFetchRequest(\n  request: AiDocsExpressRequest,\n  signal: AbortSignal,\n  options: AiDocsExpressHandlerOptions\n): Promise<Request> {\n  const headers = new Headers();\n  for (const [name, value] of Object.entries(request.headers)) {\n    if (Array.isArray(value)) value.forEach((item) => headers.append(name, item));\n    else if (value !== undefined) headers.set(name, value);\n  }\n  const method = request.method?.toUpperCase() || \"GET\";\n  const host = headers.get(\"host\");\n  const protocol = request.protocol || headers.get(\"x-forwarded-proto\") || \"http\";\n  const origin = options.origin ?? `${protocol}://${host || \"localhost\"}`;\n  // originalUrl preserves the mount prefix stripped from request.url by Express.\n  const url = new URL(request.originalUrl || request.url || \"/\", origin);\n  const body = method === \"GET\" || method === \"HEAD\"\n    ? undefined\n    : request.body !== undefined\n      ? serializeBody(request.body, headers)\n      : await readBody(request, options.maxBodyBytes ?? 8_600_000);\n  return new Request(url, {\n    method,\n    headers,\n    signal,\n    ...(body !== undefined ? { body } : {})\n  });\n}\n\nfunction serializeBody(body: unknown, headers: Headers): string {\n  if (typeof body === \"string\") return body;\n  if (body instanceof Uint8Array) return new TextDecoder().decode(body);\n  if (!headers.has(\"content-type\")) headers.set(\"content-type\", \"application/json\");\n  return JSON.stringify(body) ?? \"null\";\n}\n\nasync function readBody(request: AiDocsExpressRequest, maxBodyBytes: number): Promise<string | undefined> {\n  if (!(Symbol.asyncIterator in request)) return undefined;\n  const chunks: Uint8Array[] = [];\n  let size = 0;\n  for await (const chunk of request as AsyncIterable<string | Uint8Array>) {\n    const bytes = typeof chunk === \"string\" ? Buffer.from(chunk) : new Uint8Array(chunk);\n    size += bytes.byteLength;\n    if (size > maxBodyBytes) {\n      throw new AiDocsRequestError(413, \"request_too_large\", \"Request body is too large\");\n    }\n    chunks.push(bytes);\n  }\n  return chunks.length ? Buffer.concat(chunks).toString(\"utf8\") : undefined;\n}\n\nasync function writeFetchResponse(response: AiDocsExpressResponse, result: Response): Promise<void> {\n  response.statusCode = result.status;\n  result.headers.forEach((value, name) => response.setHeader(name, value));\n  if (!result.body) {\n    response.end();\n    return;\n  }\n  const reader = result.body.getReader();\n  try {\n    while (true) {\n      const { done, value } = await reader.read();\n      if (done) break;\n      if (!response.write(value) && response.once) {\n        await new Promise<void>((resolve) => response.once!(\"drain\", resolve));\n      }\n    }\n    if (!response.destroyed) response.end();\n  } finally {\n    reader.releaseLock();\n  }\n}\n\nfunction writeConnectorError(response: AiDocsExpressResponse, error: unknown): void {\n  const status = error instanceof AiDocsRequestError ? error.status : 500;\n  const code = error instanceof AiDocsRequestError ? error.code : \"assistant_error\";\n  response.statusCode = status;\n  response.setHeader(\"content-type\", \"application/json; charset=utf-8\");\n  response.end(JSON.stringify({ error: code }));\n}\n"],"mappings":"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","names":[]}