stitchkit 0.78.0 → 0.79.0

package/dist/index-vj3vvpaa.js

@@ -1,307 +0,0 @@
-// src/contract/define.ts
-import { z } from "zod";
-
-// src/internal/route-pattern.ts
-var PARAM_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*$/;
-function joinRoutePath(...parts) {
-  const joined = parts.filter((part) => Boolean(part)).map((part) => part.replace(/^\/+|\/+$/g, "")).filter(Boolean).join("/");
-  return `/${joined}`;
-}
-function parseTrailingWildcard(path) {
-  const segments = path.split("/").filter(Boolean);
-  const paramNames = new Set;
-  let wildcard = null;
-  for (const [segmentIndex, segment] of segments.entries()) {
-    if (segment.startsWith(":")) {
-      const name2 = segment.slice(1);
-      if (!PARAM_IDENTIFIER.test(name2)) {
-        throw new Error(`Invalid route parameter name "${name2}" in path "${path}"`);
-      }
-      if (paramNames.has(name2)) {
-        throw new Error(`Duplicate route parameter name "${name2}" in path "${path}"`);
-      }
-      paramNames.add(name2);
-      continue;
-    }
-    if (!segment.startsWith("*")) {
-      if (segment.includes("*")) {
-        throw new Error(`Wildcard must occupy its own segment in path "${path}"`);
-      }
-      continue;
-    }
-    const name = segment.slice(1);
-    if (!PARAM_IDENTIFIER.test(name)) {
-      throw new Error(`Trailing wildcard in path "${path}" must be named, for example "/*filePath"`);
-    }
-    if (segmentIndex !== segments.length - 1) {
-      throw new Error(`Wildcard "*${name}" must be the final segment in path "${path}"`);
-    }
-    if (wildcard) {
-      throw new Error(`Path "${path}" contains more than one wildcard`);
-    }
-    if (paramNames.has(name)) {
-      throw new Error(`Duplicate route parameter name "${name}" in path "${path}"`);
-    }
-    wildcard = { name, segmentIndex };
-  }
-  return wildcard;
-}
-
-// src/internal/safe-json.ts
-function isUnsafeKey(key) {
-  return key === "__proto__";
-}
-function safeJsonParse(text) {
-  return JSON.parse(text, (key, value) => isUnsafeKey(key) ? undefined : value);
-}
-
-// src/contract/define.ts
-function defineContract(meta, endpoints) {
-  const toolTransports = new Map;
-  for (const [key, ep] of Object.entries(endpoints)) {
-    const wildcard = parseTrailingWildcard(ep.path);
-    if (wildcard) {
-      if (!ep.params) {
-        throw new Error(`Contract "${meta.prefix}": endpoint "${key}" wildcard "${wildcard.name}" requires a params schema field`);
-      }
-      const paramsJson = z.toJSONSchema(ep.params, { io: "input" });
-      if (!paramsJson.properties || !(wildcard.name in paramsJson.properties)) {
-        throw new Error(`Contract "${meta.prefix}": endpoint "${key}" params schema is missing wildcard field "${wildcard.name}"`);
-      }
-    }
-    if (ep.desc.trim() === "") {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" has an empty desc`);
-    }
-    if (ep.maxJsonBodyBytes !== undefined && (!Number.isSafeInteger(ep.maxJsonBodyBytes) || ep.maxJsonBodyBytes <= 0)) {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" maxJsonBodyBytes must be a positive safe integer, received ${ep.maxJsonBodyBytes}`);
-    }
-    if (ep.multipart)
-      assertMultipartEndpoint(meta.prefix, key, ep);
-    if (ep.rawResponse)
-      assertRawEndpoint(meta.prefix, key, ep);
-    if ("stream" in ep)
-      assertStreamingResponseEndpoint(meta.prefix, key, ep);
-    if (ep.method === "HEAD")
-      assertHeadEndpoint(meta.prefix, key, ep);
-    if (ep.rawBody)
-      assertRawBodyEndpoint(meta.prefix, key, ep);
-    if ("responseMeta" in ep)
-      assertResponseMetaEndpoint(meta.prefix, key, ep);
-    if (!("toolName" in ep) || !ep.toolName)
-      continue;
-    const transports = new Set(ep.expose ? ep.expose.filter((t) => t !== "HTTP") : ["MCP", "AGENT"]);
-    if (transports.size === 0) {
-      throw new Error(`Contract "${meta.prefix}": endpoint "${key}" sets toolName "${ep.toolName}" but is not exposed on any tool transport (MCP / AGENT)`);
-    }
-    const existing = toolTransports.get(ep.toolName);
-    if (existing) {
-      for (const t of transports) {
-        if (existing.transports.has(t)) {
-          throw new Error(`Contract "${meta.prefix}": duplicate toolName "${ep.toolName}" on transport "${t}" (endpoints: "${existing.key}" and "${key}")`);
-        }
-        existing.transports.add(t);
-      }
-    } else {
-      toolTransports.set(ep.toolName, { key, transports });
-    }
-  }
-  return { meta, endpoints };
-}
-function assertPositiveLimit(where, name, value) {
-  if (value !== undefined && (!Number.isSafeInteger(value) || value <= 0)) {
-    throw new Error(`${where} ${name} must be a positive safe integer, received ${value}`);
-  }
-}
-function assertMultipartEndpoint(prefix, key, ep) {
-  const where = `Contract "${prefix}": multipart endpoint "${key}"`;
-  if (ep.method !== "POST" && ep.method !== "PUT" && ep.method !== "PATCH") {
-    throw new Error(`${where} must use POST, PUT or PATCH`);
-  }
-  const multipart = ep.multipart;
-  if (!multipart || typeof multipart !== "object") {
-    throw new Error(`${where} must declare a multipart descriptor`);
-  }
-  assertPositiveLimit(where, "maxRequestBytes", multipart.maxRequestBytes);
-  assertPositiveLimit(where, "maxFieldBytes", multipart.maxFieldBytes);
-  const entries = Object.entries(multipart.files);
-  if (entries.length === 0)
-    throw new Error(`${where} must declare at least one file field`);
-  for (const [field, policy] of entries) {
-    if (!field || isUnsafeKey(field))
-      throw new Error(`${where} has an invalid file field name`);
-    assertPositiveLimit(`${where} field "${field}"`, "maxBytes", policy.maxBytes);
-    assertPositiveLimit(`${where} field "${field}"`, "maxFiles", policy.maxFiles);
-    if (policy.multiple !== true && policy.maxFiles !== undefined) {
-      throw new Error(`${where} field "${field}" may set maxFiles only with multiple: true`);
-    }
-    if (policy.contentTypes) {
-      if (policy.contentTypes.length === 0) {
-        throw new Error(`${where} field "${field}" contentTypes cannot be empty`);
-      }
-      for (const contentType of policy.contentTypes) {
-        if (!/^[a-z0-9!#$&^_.+-]+\/(?:[a-z0-9!#$&^_.+-]+|\*)$/i.test(contentType)) {
-          throw new Error(`${where} field "${field}" has invalid content type policy "${contentType}"`);
-        }
-      }
-    }
-  }
-}
-function assertRawEndpoint(prefix, key, ep) {
-  const where = `Contract "${prefix}": raw endpoint "${key}"`;
-  if (ep.output)
-    throw new Error(`${where} cannot declare an output schema`);
-  if ("toolName" in ep && ep.toolName)
-    throw new Error(`${where} cannot set a toolName`);
-  if ("ui" in ep && ep.ui)
-    throw new Error(`${where} cannot set MCP ui metadata`);
-  if ("annotations" in ep && ep.annotations) {
-    throw new Error(`${where} cannot set MCP annotations`);
-  }
-  const nonHttp = (ep.expose ?? []).filter((t) => t !== "HTTP");
-  if (nonHttp.length > 0) {
-    throw new Error(`${where} is HTTP-only — remove ${nonHttp.join(", ")} from expose`);
-  }
-}
-function assertStreamingResponseEndpoint(prefix, key, ep) {
-  const where = `Contract "${prefix}": streaming endpoint "${key}"`;
-  if (!("stream" in ep) || !ep.stream || typeof ep.stream !== "object") {
-    throw new Error(`${where} must declare a stream descriptor`);
-  }
-  if (!ep.stream.item || typeof ep.stream.item.parse !== "function") {
-    throw new Error(`${where} must declare an item schema`);
-  }
-  const runtimeFormat = Reflect.get(ep.stream, "format");
-  const runtimeFinalLine = Reflect.get(ep.stream, "finalLine");
-  if (ep.stream.framing === "item" && runtimeFormat === "sse") {
-    throw new Error(`${where} item framing is supported only for ndjson`);
-  }
-  if (ep.stream.framing === "item" && ep.stream.completion !== "terminal") {
-    throw new Error(`${where} item framing requires terminal completion`);
-  }
-  if (ep.stream.completion === "terminal" && !ep.stream.terminal) {
-    throw new Error(`${where} terminal completion requires a terminal schema`);
-  }
-  if (runtimeFinalLine === "require-newline" && runtimeFormat === "sse") {
-    throw new Error(`${where} finalLine applies only to ndjson`);
-  }
-  assertPositiveLimit(where, "maxFrameBytes", ep.stream.maxFrameBytes);
-  assertPositiveLimit(where, "lifetimeMs", ep.stream.lifetimeMs);
-  assertPositiveLimit(where, "heartbeatMs", ep.stream.heartbeatMs);
-  if (ep.stream.idleTimeoutSeconds !== undefined && (!Number.isSafeInteger(ep.stream.idleTimeoutSeconds) || ep.stream.idleTimeoutSeconds < 0)) {
-    throw new Error(`${where} idleTimeoutSeconds must be a non-negative safe integer`);
-  }
-  if (ep.output)
-    throw new Error(`${where} cannot declare an output schema`);
-  if (ep.rawResponse)
-    throw new Error(`${where} cannot also be rawResponse`);
-  if (ep.multipart)
-    throw new Error(`${where} cannot be multipart`);
-  if ("toolName" in ep && ep.toolName)
-    throw new Error(`${where} cannot set a toolName`);
-  const nonHttp = (ep.expose ?? []).filter((transport) => transport !== "HTTP");
-  if (nonHttp.length > 0) {
-    throw new Error(`${where} is HTTP-only — remove ${nonHttp.join(", ")} from expose`);
-  }
-}
-function assertHeadEndpoint(prefix, key, ep) {
-  const where = `Contract "${prefix}": HEAD endpoint "${key}"`;
-  if (!ep.rawResponse)
-    throw new Error(`${where} must declare rawResponse: true`);
-  if (ep.input)
-    throw new Error(`${where} cannot declare an input schema`);
-  if (ep.multipart)
-    throw new Error(`${where} cannot be multipart`);
-  if (ep.rawBody)
-    throw new Error(`${where} cannot retain a raw body`);
-}
-function assertRawBodyEndpoint(prefix, key, ep) {
-  const where = `Contract "${prefix}": rawBody endpoint "${key}"`;
-  if (!ep.input)
-    throw new Error(`${where} must declare an input schema`);
-  if (ep.multipart)
-    throw new Error(`${where} cannot be multipart`);
-  if (ep.method !== "POST" && ep.method !== "PUT" && ep.method !== "PATCH") {
-    throw new Error(`${where} must use POST, PUT or PATCH`);
-  }
-  if ("toolName" in ep && ep.toolName)
-    throw new Error(`${where} cannot set a toolName`);
-  if ("ui" in ep && ep.ui)
-    throw new Error(`${where} cannot set MCP ui metadata`);
-  if ("annotations" in ep && ep.annotations) {
-    throw new Error(`${where} cannot set MCP annotations`);
-  }
-  const nonHttp = (ep.expose ?? []).filter((transport) => transport !== "HTTP");
-  if (nonHttp.length > 0) {
-    throw new Error(`${where} is HTTP-only — remove ${nonHttp.join(", ")} from expose`);
-  }
-}
-function assertResponseMetaEndpoint(prefix, key, ep) {
-  const where = `Contract "${prefix}": responseMeta endpoint "${key}"`;
-  if (!ep.responseMeta || typeof ep.responseMeta !== "object") {
-    throw new Error(`${where} must declare responseMeta as an object`);
-  }
-  const status = ep.responseMeta.status;
-  if (status !== undefined && (!Number.isSafeInteger(status) || status < 200 || status > 299)) {
-    throw new Error(`${where} status must be a successful 2xx integer, received ${status}`);
-  }
-  if (ep.output && (status === 204 || status === 205)) {
-    throw new Error(`${where} cannot combine output with bodyless status ${status}`);
-  }
-  if (ep.rawResponse)
-    throw new Error(`${where} cannot also be a rawResponse endpoint`);
-  if ("toolName" in ep && ep.toolName)
-    throw new Error(`${where} cannot set a toolName`);
-  if ("ui" in ep && ep.ui)
-    throw new Error(`${where} cannot set MCP ui metadata`);
-  if ("annotations" in ep && ep.annotations) {
-    throw new Error(`${where} cannot set MCP annotations`);
-  }
-  const nonHttp = (ep.expose ?? []).filter((transport) => transport !== "HTTP");
-  if (nonHttp.length > 0) {
-    throw new Error(`${where} is HTTP-only — remove ${nonHttp.join(", ")} from expose`);
-  }
-}
-function mergeMeta(contractMeta, endpointMeta) {
-  if (!contractMeta)
-    return endpointMeta;
-  if (!endpointMeta)
-    return { ...contractMeta };
-  return { ...contractMeta, ...endpointMeta };
-}
-// src/contract/errors-factory.ts
-import { z as z2 } from "zod";
-// src/contract/pagination.ts
-import { z as z3 } from "zod";
-
-// src/internal/base64url.ts
-function bytesToBase64Url(bytes) {
-  let binary = "";
-  for (const byte of bytes)
-    binary += String.fromCharCode(byte);
-  return btoa(binary).replace(/\+/g, "-").replace(/\//g, "_").replace(/=+$/, "");
-}
-function base64UrlToBytes(segment) {
-  if (!/^[A-Za-z0-9_-]*$/.test(segment) || segment.length % 4 === 1) {
-    throw new Error("invalid base64url segment");
-  }
-  const b64 = segment.replace(/-/g, "+").replace(/_/g, "/");
-  const padded = b64.padEnd(Math.ceil(b64.length / 4) * 4, "=");
-  return Uint8Array.from(atob(padded), (c) => c.charCodeAt(0));
-}
-// src/contract/stream.ts
-import { z as z4 } from "zod";
-var DEFAULT_CONTRACT_STREAM_FRAME_BYTES = 256 * 1024;
-var ContractStreamFrameSchema = z4.discriminatedUnion("type", [
-  z4.object({ type: z4.literal("data"), data: z4.unknown() }).strict(),
-  z4.object({
-    type: z4.literal("error"),
-    error: z4.object({
-      code: z4.string(),
-      message: z4.string().optional(),
-      details: z4.unknown().optional(),
-      hint: z4.string().optional()
-    }).strict()
-  }).strict(),
-  z4.object({ type: z4.literal("end") }).strict()
-]);
-export { joinRoutePath, parseTrailingWildcard, isUnsafeKey, safeJsonParse, defineContract, mergeMeta, bytesToBase64Url, base64UrlToBytes, DEFAULT_CONTRACT_STREAM_FRAME_BYTES, ContractStreamFrameSchema };

package/dist/index-wfq8zerm.js

@@ -1,92 +0,0 @@
-import {
-  LiveStatePhaseSchema,
-  LiveStateStopReasonSchema
-} from "./index-dmfn9m4x.js";
-
-// src/live/watch-contract.ts
-import { z } from "zod";
-var WatchKeySchema = z.object({
-  service: z.string().min(1),
-  action: z.string().min(1),
-  digest: z.string().min(1)
-}).strict().readonly();
-var WatchOpenSchema = z.object({ key: WatchKeySchema, args: z.unknown() }).readonly();
-var WatchAcceptedSchema = z.object({
-  accepted: z.boolean(),
-  reason: z.string().optional()
-}).strict().readonly();
-var WatchValueSchema = z.object({
-  key: WatchKeySchema,
-  revision: z.number().int().nonnegative(),
-  value: z.unknown()
-}).readonly();
-var WatchStateSchema = z.object({
-  key: WatchKeySchema,
-  phase: LiveStatePhaseSchema,
-  reason: LiveStateStopReasonSchema.optional(),
-  code: z.string().optional(),
-  message: z.string().optional()
-}).readonly();
-var WATCH_OPEN = "stitchkit.watch.open";
-var WATCH_CLOSE = "stitchkit.watch.close";
-var WATCH_VALUE = "stitchkit.watch.value";
-var WATCH_STATE = "stitchkit.watch.state";
-var watchContract = {
-  serverToClient: {
-    [WATCH_VALUE]: { args: z.tuple([WatchValueSchema]) },
-    [WATCH_STATE]: { args: z.tuple([WatchStateSchema]) }
-  },
-  clientToServer: {
-    [WATCH_OPEN]: { args: z.tuple([WatchOpenSchema]), ack: WatchAcceptedSchema },
-    [WATCH_CLOSE]: { args: z.tuple([z.object({ key: WatchKeySchema }).readonly()]) }
-  }
-};
-function watchKeyString(key) {
-  return `${key.service}/${key.action}/${key.digest}`;
-}
-
-// src/internal/stable-digest.ts
-function stableValue(value) {
-  if (Array.isArray(value))
-    return value.map(stableValue);
-  if (value === null || typeof value !== "object")
-    return value;
-  const result = {};
-  for (const key of Object.keys(value).sort()) {
-    result[key] = stableValue(Reflect.get(value, key));
-  }
-  return result;
-}
-function mix128(input) {
-  let a = 2654435769;
-  let b = 2246822507;
-  let c = 3266489909;
-  let d = 668265263;
-  for (let index = 0;index < input.length; index += 1) {
-    const code = input.charCodeAt(index);
-    a = Math.imul(a ^ code, 2246822519);
-    b = Math.imul(b ^ code, 3266489917);
-    c = Math.imul(c ^ code, 668265263);
-    d = Math.imul(d ^ code, 374761393);
-    a = a << 13 | a >>> 19;
-    b = b << 17 | b >>> 15;
-    c = c << 7 | c >>> 25;
-    d = d << 11 | d >>> 21;
-  }
-  a ^= b >>> 15;
-  b ^= c >>> 13;
-  c ^= d >>> 11;
-  d ^= a >>> 9;
-  return [
-    Math.imul(a ^ a >>> 16, 575075507) >>> 0,
-    Math.imul(b ^ b >>> 13, 2654435761) >>> 0,
-    Math.imul(c ^ c >>> 16, 2246822507) >>> 0,
-    Math.imul(d ^ d >>> 15, 3266489909) >>> 0
-  ];
-}
-function argumentsDigest(args) {
-  const lanes = mix128(JSON.stringify(stableValue(args)) ?? "undefined");
-  return lanes.map((lane) => lane.toString(16).padStart(8, "0")).join("");
-}
-
-export { stableValue, argumentsDigest, WatchKeySchema, WatchValueSchema, WatchStateSchema, WATCH_OPEN, WATCH_CLOSE, WATCH_VALUE, WATCH_STATE, watchContract, watchKeyString };