stitchkit 0.8.0 → 0.8.1

package/dist/tools.js

@@ -1,7 +1,8 @@
 import {
-  ApiError,
-  createClient
-} from "./index-kdkvp26v.js";
+  inputIsQuery,
+  signJwt,
+  verifyPkce
+} from "./index-9zrq8x5z.js";
 import {
   coerceJsonArgs,
   collectTools,
@@ -13,27 +14,18 @@ import {
   pollUntil,
   readCapped,
   toolResultFromError
-} from "./index-tr7r1530.js";
-import {
-  signJwt,
-  verifyPkce
-} from "./index-5qe31283.js";
-import"./index-48ffdxgk.js";
+} from "./index-f39j6twc.js";
 import {
   toJsonSchema
 } from "./index-0ed3bx43.js";
 import {
+  AppError,
   isWithinDir
-} from "./index-x3fcszf8.js";
-import"./index-wjwj5bz2.js";
-import {
-  AppError
-} from "./index-eq29zkrx.js";
-import"./index-kzfs85xp.js";
+} from "./index-jgpsd7dy.js";
 import {
-  isRecord
-} from "./index-809wc1tt.js";
-import"./index-37x76zdn.js";
+  isRecord,
+  typedEntries
+} from "./index-tm7dqzxc.js";
 
 // src/tools/agent.ts
 import { tool, zodSchema } from "ai";
@@ -94,16 +86,15 @@ import { z } from "zod";
 
 // src/tools/mcp-app.ts
 import { readFileSync } from "node:fs";
-import { createRequire } from "node:module";
+import { fileURLToPath } from "node:url";
 var RESOURCE_MIME_TYPE = "text/html;profile=mcp-app";
 var EXT_APPS_BUNDLE_PLACEHOLDER = "/*__EXT_APPS_BUNDLE__*/";
-var require2 = createRequire(import.meta.url);
 function inlineMcpAppBundle(html) {
   if (!html.includes(EXT_APPS_BUNDLE_PLACEHOLDER))
     return html;
   let bundlePath;
   try {
-    bundlePath = require2.resolve("@modelcontextprotocol/ext-apps/app-with-deps");
+    bundlePath = fileURLToPath(import.meta.resolve("@modelcontextprotocol/ext-apps/app-with-deps"));
   } catch {
     throw new Error("[stitchkit] inlineMcpAppBundle: '@modelcontextprotocol/ext-apps' is not installed. " + "Add it as a dependency to serve MCP App widgets.");
   }
@@ -836,6 +827,247 @@ function mountOAuthProvider(config) {
   };
   return [metadataRoute, registerRoute, authorizeRoute, tokenRoute];
 }
+// src/browser/http.ts
+import ky, { isHTTPError } from "ky";
+class ApiError extends Error {
+  code;
+  status;
+  details;
+  hint;
+  constructor(code, status = 0, details, message, hint) {
+    super(message ?? `API Error: ${code}`);
+    this.code = code;
+    this.status = status;
+    this.details = details;
+    this.hint = hint;
+    this.name = "ApiError";
+  }
+  static is(error) {
+    return error instanceof ApiError;
+  }
+}
+function parseApiErrorBody(body) {
+  if (!isRecord(body) || !isRecord(body.error))
+    return null;
+  const error = body.error;
+  if (typeof error.code !== "string")
+    return null;
+  return {
+    code: error.code,
+    message: typeof error.message === "string" ? error.message : undefined,
+    details: error.details,
+    hint: typeof error.hint === "string" ? error.hint : undefined
+  };
+}
+
+// src/browser/client.ts
+function withTimeout(options, timeout) {
+  if (timeout === undefined)
+    return options;
+  return { ...options, timeout };
+}
+function isParamArray(value) {
+  return Array.isArray(value) && value.every((v) => typeof v === "string" || typeof v === "number");
+}
+function collectQueryParams(args, skipKeys) {
+  const params = {};
+  let hasParams = false;
+  for (const [key, value] of Object.entries(args)) {
+    if (skipKeys.has(key) || value === undefined || value === null)
+      continue;
+    if (typeof value === "string" || typeof value === "number" || typeof value === "boolean" || isParamArray(value)) {
+      params[key] = value;
+      hasParams = true;
+    }
+  }
+  return hasParams ? params : undefined;
+}
+function createClient(contract, configOrClient, contractConfig) {
+  const client = {};
+  const makeMethod = isHttpAdapter(configOrClient) ? (endpoint) => createHttpMethod(endpoint, contract.meta.prefix, configOrClient, contractConfig) : (endpoint) => createFetchMethod(endpoint, contract.meta.prefix, configOrClient, contractConfig);
+  for (const [key, endpoint] of typedEntries(contract.endpoints)) {
+    if (endpoint.expose && !endpoint.expose.includes("HTTP"))
+      continue;
+    setClientMethod(client, key, makeMethod(endpoint));
+  }
+  return client;
+}
+function isHttpAdapter(value) {
+  return typeof value === "object" && "get" in value && typeof value.get === "function";
+}
+function setClientMethod(target, key, method) {
+  target[key] = method;
+}
+function createHttpMethod(endpoint, prefix, client, config) {
+  const httpMethod = endpoint.method.toLowerCase();
+  const isGet = httpMethod === "get";
+  const paramNames = extractParamNames(endpoint.path);
+  const prefixKeys = new Set([...config?.stripPrefixKeys ?? [], ...paramNames]);
+  return (...args) => {
+    const firstArg = args[0] ?? {};
+    let pathPrefixStr = "";
+    if (config?.pathPrefix) {
+      pathPrefixStr = typeof config.pathPrefix === "function" ? config.pathPrefix(firstArg) : config.pathPrefix;
+      if (pathPrefixStr && !pathPrefixStr.endsWith("/"))
+        pathPrefixStr += "/";
+    }
+    let url = `${pathPrefixStr}${prefix}${endpoint.path}`;
+    for (const name of paramNames) {
+      const value = firstArg[name];
+      if (value === undefined || value === null) {
+        throw new Error(`Missing path param: ${name}`);
+      }
+      url = url.replace(`:${name}`, encodeURIComponent(String(value)));
+    }
+    if (url.endsWith("/"))
+      url = url.slice(0, -1);
+    if (endpoint.multipart) {
+      const file = firstArg[endpoint.multipart];
+      if (!(file instanceof Blob)) {
+        throw new Error(`Missing multipart file field: ${endpoint.multipart}`);
+      }
+      const formData = new FormData;
+      formData.append(endpoint.multipart, file);
+      appendFormFields(formData, firstArg, new Set([...prefixKeys, endpoint.multipart]));
+      return client.post(url, formData, withTimeout(undefined, endpoint.timeout));
+    }
+    if (isGet) {
+      const params = collectQueryParams(firstArg, prefixKeys);
+      return client.get(url, withTimeout(params ? { params } : undefined, endpoint.timeout));
+    }
+    if (httpMethod === "delete") {
+      const params = collectQueryParams(firstArg, prefixKeys);
+      return client.delete(url, withTimeout(params ? { params } : undefined, endpoint.timeout));
+    }
+    const payload = {};
+    for (const [key, value] of Object.entries(firstArg)) {
+      if (!prefixKeys.has(key) && value !== undefined) {
+        payload[key] = value;
+      }
+    }
+    return client[httpMethod](url, Object.keys(payload).length > 0 ? payload : undefined, withTimeout(undefined, endpoint.timeout));
+  };
+}
+function createFetchMethod(endpoint, prefix, config, contractConfig) {
+  const prefixKeys = new Set(contractConfig?.stripPrefixKeys ?? []);
+  return async (args) => {
+    let pathPrefixStr = "";
+    if (contractConfig?.pathPrefix) {
+      pathPrefixStr = typeof contractConfig.pathPrefix === "function" ? contractConfig.pathPrefix(args ?? {}) : contractConfig.pathPrefix;
+      if (pathPrefixStr && !pathPrefixStr.endsWith("/"))
+        pathPrefixStr += "/";
+    }
+    let url = buildFetchUrl(config.baseUrl, prefix, endpoint.path, args, pathPrefixStr);
+    const headers = {
+      Accept: "application/json",
+      ...typeof config.headers === "function" ? config.headers() : config.headers
+    };
+    const isQuery = inputIsQuery(endpoint.method);
+    const hasBody = !isQuery && !endpoint.multipart && endpoint.input && args;
+    if (isQuery && args) {
+      const remaining = stripParams(args, endpoint.path, prefixKeys);
+      const searchParams = new URLSearchParams;
+      for (const [k, v] of Object.entries(remaining)) {
+        if (v === undefined || v === null)
+          continue;
+        if (isParamArray(v)) {
+          for (const item of v)
+            searchParams.append(k, String(item));
+        } else if (typeof v !== "object") {
+          searchParams.set(k, String(v));
+        }
+      }
+      if (searchParams.size > 0)
+        url += `?${searchParams}`;
+    }
+    if (hasBody)
+      headers["Content-Type"] = "application/json";
+    if (endpoint.multipart && args) {
+      const file = args[endpoint.multipart];
+      if (!(file instanceof Blob)) {
+        throw new Error(`Missing multipart file field: ${endpoint.multipart}`);
+      }
+      const formData = new FormData;
+      formData.append(endpoint.multipart, file);
+      appendFormFields(formData, stripParams(args, endpoint.path, prefixKeys), new Set([endpoint.multipart]));
+      const res2 = await fetch(url, {
+        method: endpoint.method,
+        headers,
+        credentials: config.credentials,
+        body: formData
+      });
+      if (!res2.ok) {
+        await throwForErrorResponse(res2, config, null);
+      }
+      if (res2.status === 204)
+        return;
+      const json3 = await res2.json();
+      return endpoint.output ? endpoint.output.parse(json3) : json3;
+    }
+    const res = await fetch(url, {
+      method: endpoint.method,
+      headers,
+      credentials: config.credentials,
+      ...hasBody && {
+        body: JSON.stringify(stripParams(hasBody, endpoint.path, prefixKeys))
+      }
+    });
+    if (!res.ok) {
+      await throwForErrorResponse(res, config, { error: res.statusText });
+    }
+    if (res.status === 204)
+      return;
+    const json2 = await res.json();
+    return endpoint.output ? endpoint.output.parse(json2) : json2;
+  };
+}
+function appendFormFields(formData, values, skipKeys) {
+  for (const [key, value] of Object.entries(values)) {
+    if (skipKeys.has(key) || value === undefined || value === null)
+      continue;
+    formData.append(key, typeof value === "string" ? value : JSON.stringify(value));
+  }
+}
+async function throwForErrorResponse(res, config, fallbackBody) {
+  const body = await res.json().catch(() => fallbackBody);
+  config.onError?.(res.status, body);
+  const parsed = parseApiErrorBody(body);
+  if (parsed) {
+    throw new ApiError(parsed.code, res.status, parsed.details, parsed.message, parsed.hint);
+  }
+  throw new ApiError("HTTP_ERROR", res.status, { body });
+}
+function extractParamNames(path) {
+  const matches = path.match(/:(\w+)/g);
+  return matches ? matches.map((m) => m.slice(1)) : [];
+}
+function buildFetchUrl(baseUrl, prefix, path, args, pathPrefix = "") {
+  let fullPath = `/${pathPrefix}${prefix}${path === "/" ? "" : path}`;
+  if (args) {
+    fullPath = fullPath.replace(/:(\w+)/g, (_, key) => {
+      const val = args[key];
+      if (val === undefined || val === null) {
+        throw new Error(`Missing path param: ${key}`);
+      }
+      return encodeURIComponent(String(val));
+    });
+  }
+  return `${baseUrl}${fullPath}`;
+}
+function stripParams(args, path, extra) {
+  const skip = new Set(extra);
+  for (const match of path.matchAll(/:(\w+)/g)) {
+    if (match[1])
+      skip.add(match[1]);
+  }
+  const result = {};
+  for (const [k, v] of Object.entries(args)) {
+    if (!skip.has(k))
+      result[k] = v;
+  }
+  return result;
+}
+
 // src/tools/remote.ts
 function toArgs(ctx) {
   const { params, input } = ctx;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stitchkit",
-  "version": "0.8.0",
+  "version": "0.8.1",
   "description": "Contract-first backend framework — one defineContract() into an HTTP API, MCP tools, AI-agent tools and a typed client. Bun and Node.",
   "keywords": [
     "bun",
@@ -82,9 +82,11 @@
   },
   "scripts": {
     "check": "bun x tsc --noEmit",
-    "build:js": "bun build src/index.ts src/react.ts src/tools.ts src/cli.ts src/contract/index.ts src/server/index.ts src/observability/index.ts src/node.ts --outdir dist --target node --packages external --splitting --root src",
+    "build:browser": "bun build src/index.ts src/react.ts src/contract/index.ts --outdir dist --target node --packages external --splitting --root src",
+    "build:server": "bun build src/server/index.ts src/node.ts src/tools.ts src/cli.ts src/observability/index.ts --outdir dist --target node --packages external --splitting --root src",
+    "build:js": "bun run build:browser && bun run build:server",
     "build:types": "bun x tsc -p tsconfig.build.json --emitDeclarationOnly",
-    "build": "rm -rf dist && bun run build:js && bun run build:types",
+    "build": "rm -rf dist && bun run build:js && bun run build:types && bun scripts/check-browser-clean.mjs",
     "dev": "bun run build:js -- --watch",
     "prepublishOnly": "cp ../../README.md ./README.md && bun ../../scripts/gen-llms.ts && bun run build",
     "test": "bun test",

package/dist/index-37x76zdn.js

@@ -1,4 +0,0 @@
-import { createRequire } from "node:module";
-var __require = /* @__PURE__ */ createRequire(import.meta.url);
-
-export { __require };

package/dist/index-48ffdxgk.js

@@ -1,6 +0,0 @@
-// src/internal/http-input.ts
-function inputIsQuery(method) {
-  return method === "GET" || method === "DELETE";
-}
-
-export { inputIsQuery };

package/dist/index-809wc1tt.js

@@ -1,18 +0,0 @@
-// src/internal/typed.ts
-function typedEntries(value) {
-  return Object.entries(value);
-}
-function isRecord(value) {
-  return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function mapObject(source, mapper) {
-  const result = {};
-  for (const [key, value] of typedEntries(source)) {
-    const mapped = mapper(key, value);
-    if (mapped !== undefined)
-      result[key] = mapped;
-  }
-  return result;
-}
-
-export { typedEntries, isRecord, mapObject };

package/dist/index-a1702zj4.js

@@ -1,72 +0,0 @@
-import {
-  normalizeError
-} from "./index-wjwj5bz2.js";
-
-// src/server/stream.ts
-function streamSSE(generator) {
-  const encoder = new TextEncoder;
-  const stream = new ReadableStream({
-    async start(controller) {
-      try {
-        for await (const chunk of generator) {
-          const data = JSON.stringify(chunk);
-          controller.enqueue(encoder.encode(`data: ${data}
-
-`));
-        }
-        controller.enqueue(encoder.encode(`data: [DONE]
-
-`));
-        controller.close();
-      } catch (err) {
-        const envelope = normalizeError(err).toJSON();
-        controller.enqueue(encoder.encode(`data: ${JSON.stringify(envelope)}
-
-`));
-        controller.close();
-      }
-    }
-  });
-  return new Response(stream, {
-    headers: {
-      "Content-Type": "text/event-stream",
-      "Cache-Control": "no-cache",
-      Connection: "keep-alive"
-    }
-  });
-}
-async function* parseSSE(response, options) {
-  const reader = response.body?.getReader();
-  if (!reader)
-    return;
-  const decoder = new TextDecoder;
-  let buffer = "";
-  try {
-    while (true) {
-      const { done, value } = await reader.read();
-      if (done)
-        break;
-      buffer += decoder.decode(value, { stream: true });
-      const lines = buffer.split(`
-`);
-      buffer = lines.pop() ?? "";
-      for (const rawLine of lines) {
-        const line = rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine;
-        if (!line.startsWith("data:"))
-          continue;
-        const data = line.slice(5).replace(/^ /, "");
-        if (data === "[DONE]")
-          return;
-        try {
-          yield JSON.parse(data);
-        } catch (err) {
-          options?.onParseError?.(data, err instanceof Error ? err : new Error(String(err)));
-        }
-      }
-    }
-  } finally {
-    reader.releaseLock();
-  }
-}
-
-export { streamSSE, parseSSE };