stitchkit 0.107.0 → 0.108.1

package/dist/{index-zsqt5q98.js → index-p5kx5vqd.js}

@@ -14,6 +14,10 @@ import {
   withUploadProgress,
   parseApiErrorBody
 } from "./index-7jvwrjqa.js";
+import {
+  abortReason,
+  untilAborted
+} from "./index-a5qr2rj6.js";
 import {
   inputIsQuery
 } from "./index-xhzq2qvj.js";
@@ -32,108 +36,259 @@ import {
 
 // src/internal/bounded-lines.ts
 var DEFAULT_STREAM_LINE_BYTES = 1024 * 1024;
+
+class StreamLineLimitError2 extends RangeError {
+  limitBytes;
+  lineBytes;
+  name = "StreamLineLimitError";
+  constructor(limitBytes, lineBytes) {
+    super(`Stream line exceeds the ${limitBytes} byte limit (${lineBytes} bytes so far)`);
+    this.limitBytes = limitBytes;
+    this.lineBytes = lineBytes;
+  }
+}
+
+class StreamTruncatedLineError2 extends SyntaxError {
+  lineBytes;
+  name = "StreamTruncatedLineError";
+  constructor(lineBytes) {
+    super(`Stream ended with an unterminated final line (${lineBytes} bytes)`);
+    this.lineBytes = lineBytes;
+  }
+}
 function lineLimit(value) {
   const resolved = value ?? DEFAULT_STREAM_LINE_BYTES;
   assertPositiveSafeInteger("maxLineBytes", resolved);
   return resolved;
 }
-function joinBytes(left, right) {
-  if (left.byteLength === 0)
-    return right.slice();
-  const result = new Uint8Array(left.byteLength + right.byteLength);
-  result.set(left);
-  result.set(right, left.byteLength);
-  return result;
-}
-async function* readBoundedUtf8Lines(response, maxLineBytes, requireFinalNewline = false) {
-  const reader = response.body?.getReader();
-  if (!reader)
-    return;
+function createLineSplitter(maxLineBytes, requireFinalNewline = false) {
   const limit = lineLimit(maxLineBytes);
   const decoder = new TextDecoder("utf-8", { fatal: true });
-  let pending = new Uint8Array;
-  try {
-    for (;; ) {
-      const chunk = await reader.read();
-      if (chunk.done)
-        break;
+  let parts = [];
+  let pendingBytes = 0;
+  let ended = false;
+  let failed = false;
+  const drop = () => {
+    parts = [];
+    pendingBytes = 0;
+  };
+  const retain = (bytes) => {
+    if (bytes.byteLength === 0)
+      return;
+    pendingBytes += bytes.byteLength;
+    if (pendingBytes > limit) {
+      const seen = pendingBytes;
+      drop();
+      throw new StreamLineLimitError2(limit, seen);
+    }
+    parts.push(new Uint8Array(bytes));
+  };
+  const take = () => {
+    const line = new Uint8Array(pendingBytes);
+    let at = 0;
+    for (const part of parts) {
+      line.set(part, at);
+      at += part.byteLength;
+    }
+    drop();
+    return decoder.decode(line);
+  };
+  function* lines(chunk) {
+    if (ended)
+      throw new Error("Line decoder received bytes after end()");
+    if (failed)
+      throw new Error("Line decoder stopped at an earlier error; read the source again");
+    try {
       let start = 0;
-      for (let index = 0;index < chunk.value.byteLength; index += 1) {
-        if (chunk.value[index] !== 10)
-          continue;
-        const lineBytes = joinBytes(pending, chunk.value.slice(start, index));
-        if (lineBytes.byteLength > limit) {
-          throw new RangeError(`Stream line exceeds the ${limit} byte limit`);
-        }
-        yield decoder.decode(lineBytes);
-        pending = new Uint8Array;
+      for (let index = chunk.indexOf(10);index !== -1; index = chunk.indexOf(10, start)) {
+        retain(chunk.subarray(start, index));
+        yield take();
         start = index + 1;
       }
-      pending = joinBytes(pending, chunk.value.slice(start));
-      if (pending.byteLength > limit) {
-        throw new RangeError(`Stream line exceeds the ${limit} byte limit`);
-      }
+      retain(chunk.subarray(start));
+    } catch (error) {
+      failed = true;
+      throw error;
     }
-    if (pending.byteLength > 0) {
+  }
+  return {
+    lines,
+    push: (chunk) => [...lines(chunk)],
+    end() {
+      ended = true;
+      if (pendingBytes === 0)
+        return [];
       if (requireFinalNewline) {
-        throw new SyntaxError("Stream ended with an unterminated final line");
+        const seen = pendingBytes;
+        drop();
+        throw new StreamTruncatedLineError2(seen);
+      }
+      return [take()];
+    }
+  };
+}
+function createBoundedLineDecoder(maxLineBytes, requireFinalNewline = false) {
+  const { push, end } = createLineSplitter(maxLineBytes, requireFinalNewline);
+  return { push, end };
+}
+async function* chunksOf(source, signal) {
+  signal?.throwIfAborted();
+  const stream = source instanceof Response ? source.body : source;
+  if (stream === null)
+    return;
+  if (stream instanceof ReadableStream) {
+    const reader = stream.getReader();
+    const abort = () => {
+      if (signal)
+        reader.cancel(abortReason(signal)).catch(() => {
+          return;
+        });
+    };
+    signal?.addEventListener("abort", abort, { once: true });
+    try {
+      for (;; ) {
+        const chunk = await reader.read();
+        signal?.throwIfAborted();
+        if (chunk.done)
+          return;
+        yield chunk.value;
+      }
+    } finally {
+      signal?.removeEventListener("abort", abort);
+      await reader.cancel().catch(() => {
+        return;
+      });
+      reader.releaseLock();
+    }
+  }
+  const iterator = stream[Symbol.asyncIterator]();
+  let finished = false;
+  try {
+    for (;; ) {
+      const pending = iterator.next();
+      const next = await (signal ? untilAborted(pending, signal) : pending);
+      if (next.done) {
+        finished = true;
+        return;
       }
-      yield decoder.decode(pending);
+      yield next.value;
     }
   } finally {
-    await reader.cancel().catch(() => {
-      return;
-    });
-    reader.releaseLock();
+    if (!finished && signal?.aborted)
+      iterator.return?.().catch(() => {
+        return;
+      });
+    else if (!finished)
+      await iterator.return?.().catch(() => {
+        return;
+      });
+  }
+}
+async function* readBoundedUtf8Lines(source, maxLineBytes, requireFinalNewline = false, signal) {
+  const splitter = createLineSplitter(maxLineBytes, requireFinalNewline);
+  for await (const chunk of chunksOf(source, signal)) {
+    for (const line of splitter.lines(chunk)) {
+      signal?.throwIfAborted();
+      yield line;
+    }
+  }
+  for (const line of splitter.end()) {
+    signal?.throwIfAborted();
+    yield line;
   }
 }
 
 // src/browser/stream.ts
+function ndjsonLine(rawLine) {
+  return (rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine).trim();
+}
 function parseFailure(raw, error, onParseError) {
   const failure = error instanceof Error ? error : new Error(String(error));
   if (!onParseError)
     throw failure;
   onParseError(raw, failure);
 }
-async function* parseNDJSON2(response, options) {
+async function* parseNDJSON2(source, options) {
+  let reporting = false;
   try {
-    for await (const rawLine of readBoundedUtf8Lines(response, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES, options?.finalLine === "require-newline")) {
-      const line = (rawLine.endsWith("\r") ? rawLine.slice(0, -1) : rawLine).trim();
+    for await (const rawLine of readBoundedUtf8Lines(source, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES, options?.finalLine === "require-newline", options?.signal)) {
+      const line = ndjsonLine(rawLine);
       if (line === "")
         continue;
+      let value;
       try {
-        yield JSON.parse(line);
+        value = JSON.parse(line);
       } catch (error) {
+        reporting = true;
         parseFailure(line, error, options?.onParseError);
+        reporting = false;
+        continue;
       }
+      yield value;
     }
   } catch (error) {
+    if (reporting || options?.signal?.aborted)
+      throw error;
     parseFailure("", error, options?.onParseError);
   }
 }
-async function* parseSSE2(response, options) {
+function createNDJSONDecoder2(options) {
+  const lines = createBoundedLineDecoder(options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES, options?.finalLine === "require-newline");
+  let failed = false;
+  const values = (rawLines) => {
+    const parsed = [];
+    for (const rawLine of rawLines) {
+      const line = ndjsonLine(rawLine);
+      if (line === "")
+        continue;
+      try {
+        parsed.push(JSON.parse(line));
+      } catch (error) {
+        parseFailure(line, error, options?.onParseError);
+      }
+    }
+    return parsed;
+  };
+  const guarded = (step) => {
+    if (failed)
+      throw new Error("NDJSON decoder stopped at an earlier error; read the source again");
+    try {
+      return values(step());
+    } catch (error) {
+      failed = true;
+      throw error;
+    }
+  };
+  return {
+    push: (chunk) => guarded(() => lines.push(chunk)),
+    end: () => guarded(() => lines.end())
+  };
+}
+async function* parseSSE2(source, options) {
+  let reporting = false;
   try {
-    for await (const rawLine of readBoundedUtf8Lines(response, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES)) {
+    for await (const rawLine of readBoundedUtf8Lines(source, options?.maxLineBytes ?? DEFAULT_STREAM_LINE_BYTES, false, options?.signal)) {
       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;
+      let value;
       try {
-        yield JSON.parse(data);
+        value = JSON.parse(data);
       } catch (error) {
-        const failure = error instanceof Error ? error : new Error(String(error));
-        if (!options?.onParseError)
-          throw failure;
-        options.onParseError(data, failure);
+        reporting = true;
+        parseFailure(data, error, options?.onParseError);
+        reporting = false;
+        continue;
       }
+      yield value;
     }
   } catch (error) {
-    const failure = error instanceof Error ? error : new Error(String(error));
-    if (!options?.onParseError)
-      throw failure;
-    options.onParseError("", failure);
+    if (reporting || options?.signal?.aborted)
+      throw error;
+    parseFailure("", error, options?.onParseError);
   }
 }
 
@@ -797,4 +952,4 @@ function createScopedUrlBuilders2(contracts, source, scopeConfigs) {
   return buildScopedRegistry(contracts, scopeConfigs, "URL builder", (contract, config) => createUrlBuilder2(contract, source, config));
 }
 
-export { endpointHasArguments, parseNDJSON2, parseSSE2, contractEndpointMatchers2, createClient2, createClients2, createScopedClients2, createUrlBuilder2, createUrlBuilders2, createScopedUrlBuilders2 };
+export { endpointHasArguments, StreamLineLimitError2, StreamTruncatedLineError2, parseNDJSON2, createNDJSONDecoder2, parseSSE2, contractEndpointMatchers2, createClient2, createClients2, createScopedClients2, createUrlBuilder2, createUrlBuilders2, createScopedUrlBuilders2 };

package/dist/{index-bnf8s6v3.js → index-t2bsd0hm.js}

@@ -3,7 +3,7 @@ import {
   ProcessInstanceSchema2,
   readProcessInstance,
   probeProcessOwner2
-} from "./index-7r74re56.js";
+} from "./index-bh2ht9y5.js";
 import {
   BoundedFileReadError,
   readBoundedFile

package/dist/{index-4f37d3bg.js → index-w9mqgnz9.js}

@@ -1,6 +1,6 @@
 import {
   attemptExclusiveLock
-} from "./index-bnf8s6v3.js";
+} from "./index-t2bsd0hm.js";
 import {
   sleep
 } from "./index-eemvahkc.js";

package/dist/{index-e05cjgtf.js → index-xvj9h8yh.js}

@@ -2,6 +2,30 @@ import {
   isRecord
 } from "./index-9jfdm5tg.js";
 
+// src/telegram/not-dispatched.ts
+class TelegramNotDispatchedError2 extends Error {
+  stage;
+  name = "TelegramNotDispatchedError";
+  code = "TELEGRAM_NOT_DISPATCHED";
+  constructor(stage, message, options) {
+    super(message, options);
+    this.stage = stage;
+  }
+}
+function isTelegramNotDispatchedError(error) {
+  return error instanceof TelegramNotDispatchedError2 || error instanceof Error && error.name === "TelegramNotDispatchedError" && Reflect.get(error, "code") === "TELEGRAM_NOT_DISPATCHED";
+}
+function isTelegramNotDispatched(error, depth = 0) {
+  if (error instanceof TelegramNotDispatchedError2)
+    return true;
+  if (typeof error !== "object" || error === null || depth > 4)
+    return false;
+  if (Reflect.get(error, "code") === "TELEGRAM_NOT_DISPATCHED")
+    return true;
+  const nested = Reflect.get(error, "cause") ?? Reflect.get(error, "error");
+  return nested !== error && isTelegramNotDispatched(nested, depth + 1);
+}
+
 // src/telegram/send-failure.ts
 var BY_DESCRIPTION = [
   [/bot was blocked by the user|bot was kicked/i, "blocked-by-user"],
@@ -22,6 +46,7 @@ var TRAITS = {
   "rate-limited": { retryable: true, recipientUnreachable: false },
   "message-invalid": { retryable: false, recipientUnreachable: false },
   "server-error": { retryable: true, recipientUnreachable: false },
+  "not-dispatched": { retryable: true, recipientUnreachable: false },
   unknown: { retryable: false, recipientUnreachable: false }
 };
 function isSendFailureReason(value) {
@@ -71,6 +96,8 @@ function descriptionOf(value, depth = 0) {
   return [own, message, nested].filter(Boolean).join(" ");
 }
 function classifyTelegramSendFailure2(error) {
+  if (isTelegramNotDispatched(error))
+    return { reason: "not-dispatched", ...TRAITS["not-dispatched"], evidence: "transport" };
   const status = statusOf(error);
   const retryAfterSeconds = retryAfterOf(error);
   const description = descriptionOf(error);
@@ -141,4 +168,4 @@ function classifyTelegramEditRefusal(error) {
   return "other";
 }
 
-export { TELEGRAM_SEND_FAILURE_REASONS2, classifyTelegramSendFailure2, classifyTelegramEditRefusal };
+export { TelegramNotDispatchedError2, isTelegramNotDispatchedError, TELEGRAM_SEND_FAILURE_REASONS2, classifyTelegramSendFailure2, classifyTelegramEditRefusal };

package/dist/internal/bounded-lines.d.ts

@@ -1,4 +1,48 @@
 export declare const DEFAULT_STREAM_LINE_BYTES: number;
-/** Bounded, fatal-UTF-8 line reader shared by NDJSON and SSE parsers. */
-export declare function readBoundedUtf8Lines(response: Response, maxLineBytes?: number, requireFinalNewline?: boolean): AsyncGenerator<string>;
+/**
+ * A line grew past its byte limit. The reader throws as soon as the retained bytes cross the
+ * limit, so memory stays bounded by the limit plus the chunk being read.
+ */
+export declare class StreamLineLimitError extends RangeError {
+    /** The configured `maxLineBytes`. */
+    readonly limitBytes: number;
+    /** Bytes of the line seen when it crossed the limit; the line itself is longer still. */
+    readonly lineBytes: number;
+    readonly name = "StreamLineLimitError";
+    constructor(
+    /** The configured `maxLineBytes`. */
+    limitBytes: number, 
+    /** Bytes of the line seen when it crossed the limit; the line itself is longer still. */
+    lineBytes: number);
+}
+/** The source ended inside a line while `finalLine: 'require-newline'` asked for a delimiter. */
+export declare class StreamTruncatedLineError extends SyntaxError {
+    /** Bytes of the unterminated final line. */
+    readonly lineBytes: number;
+    readonly name = "StreamTruncatedLineError";
+    constructor(
+    /** Bytes of the unterminated final line. */
+    lineBytes: number);
+}
+/** Bytes a line reader accepts: a `Response` body, a web stream, or any async byte iterable. */
+export type StreamByteSource = Response | ReadableStream<Uint8Array> | AsyncIterable<Uint8Array>;
+/**
+ * Push-driven bounded line splitter for sources that deliver bytes through a callback, such as
+ * a `Bun.listen`/`Bun.connect` socket's `data` handler. Lines are split on `\n` in bytes and
+ * decoded as fatal UTF-8 only once complete, so a character split across chunks is never torn.
+ * An error (a line past the limit, invalid UTF-8) fails the whole `push` and stops the decoder:
+ * the bytes after it belong to the failed line, so every later `push` throws.
+ */
+export interface BoundedLineDecoder {
+    /** Feed one chunk; returns the lines it completed, without their `\n`. */
+    push(chunk: Uint8Array): string[];
+    /**
+     * The source ended. Returns the unterminated final line, if any, as one more line, or throws
+     * `StreamTruncatedLineError` when a final newline is required.
+     */
+    end(): string[];
+}
+export declare function createBoundedLineDecoder(maxLineBytes?: number, requireFinalNewline?: boolean): BoundedLineDecoder;
+/** Bounded, fatal-UTF-8 line reader shared by the NDJSON and SSE parsers. */
+export declare function readBoundedUtf8Lines(source: StreamByteSource, maxLineBytes?: number, requireFinalNewline?: boolean, signal?: AbortSignal): AsyncGenerator<string>;
 //# sourceMappingURL=bounded-lines.d.ts.map

package/dist/internal/bounded-lines.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounded-lines.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-lines.ts"],"names":[],"mappings":"AACA,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAgBrD,yEAAyE;AACzE,wBAAuB,oBAAoB,CACzC,QAAQ,EAAE,QAAQ,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,mBAAmB,UAAQ,GAC1B,cAAc,CAAC,MAAM,CAAC,CAqCxB"}
+{"version":3,"file":"bounded-lines.d.ts","sourceRoot":"","sources":["../../src/internal/bounded-lines.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,yBAAyB,QAAc,CAAC;AAErD;;;GAGG;AACH,qBAAa,oBAAqB,SAAQ,UAAU;IAGhD,qCAAqC;IACrC,QAAQ,CAAC,UAAU,EAAE,MAAM;IAC3B,yFAAyF;IACzF,QAAQ,CAAC,SAAS,EAAE,MAAM;IAL5B,SAAkB,IAAI,0BAA0B;IAChD;IACE,qCAAqC;IAC5B,UAAU,EAAE,MAAM;IAC3B,yFAAyF;IAChF,SAAS,EAAE,MAAM,EAG3B;CACF;AAED,iGAAiG;AACjG,qBAAa,wBAAyB,SAAQ,WAAW;IAGrD,4CAA4C;IAC5C,QAAQ,CAAC,SAAS,EAAE,MAAM;IAH5B,SAAkB,IAAI,8BAA8B;IACpD;IACE,4CAA4C;IACnC,SAAS,EAAE,MAAM,EAG3B;CACF;AAED,gGAAgG;AAChG,MAAM,MAAM,gBAAgB,GACxB,QAAQ,GACR,cAAc,CAAC,UAAU,CAAC,GAC1B,aAAa,CAAC,UAAU,CAAC,CAAC;AAE9B;;;;;;GAMG;AACH,MAAM,WAAW,kBAAkB;IACjC,0EAA0E;IAC1E,IAAI,CAAC,KAAK,EAAE,UAAU,GAAG,MAAM,EAAE,CAAC;IAClC;;;OAGG;IACH,GAAG,IAAI,MAAM,EAAE,CAAC;CACjB;AAiFD,wBAAgB,wBAAwB,CACtC,YAAY,CAAC,EAAE,MAAM,EACrB,mBAAmB,UAAQ,GAC1B,kBAAkB,CAGpB;AAkDD,6EAA6E;AAC7E,wBAAuB,oBAAoB,CACzC,MAAM,EAAE,gBAAgB,EACxB,YAAY,CAAC,EAAE,MAAM,EACrB,mBAAmB,UAAQ,EAC3B,MAAM,CAAC,EAAE,WAAW,GACnB,cAAc,CAAC,MAAM,CAAC,CAcxB"}

package/dist/internal/process-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"process-identity.d.ts","sourceRoot":"","sources":["../../src/internal/process-identity.ts"],"names":[],"mappings":"AA8CA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,SAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAiBtF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,YAAY,MAAM,SAA4B,GAClD,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAY3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAuBlB"}
+{"version":3,"file":"process-identity.d.ts","sourceRoot":"","sources":["../../src/internal/process-identity.ts"],"names":[],"mappings":"AA6DA;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAE7D;AAED;;;GAGG;AACH,wBAAsB,sBAAsB,CAAC,OAAO,SAAU,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAgBtF;AAED,wBAAsB,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAW1F;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,MAAM,EACX,KAAK,YAAY,MAAM,SAA4B,GAClD,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAY3B;AAED;;;;;;;;;GASG;AACH,wBAAsB,eAAe,CACnC,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAO,GACnD,OAAO,CAAC,OAAO,CAAC,CAsBlB"}

package/dist/internal/until-aborted.d.ts

@@ -0,0 +1,9 @@
+/** The signal's reason, or the `AbortError` a signal aborted without one stands for. */
+export declare function abortReason(signal: AbortSignal): unknown;
+/**
+ * `pending`, or the signal's reason as soon as it aborts. Each call owns its listener and removes
+ * it when `pending` settles: one promise shared by every call would retain each result for as long
+ * as the signal lives. `pending` itself is not cancelled, only no longer waited for.
+ */
+export declare function untilAborted<T>(pending: Promise<T>, signal: AbortSignal): Promise<T>;
+//# sourceMappingURL=until-aborted.d.ts.map

package/dist/internal/until-aborted.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"until-aborted.d.ts","sourceRoot":"","sources":["../../src/internal/until-aborted.ts"],"names":[],"mappings":"AAAA,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,MAAM,EAAE,WAAW,GAAG,OAAO,CAExD;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAoBpF"}

package/dist/internal/upgrade-affects.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The machine line of a breaking changelog item: what it touches, in a form a
+ * consumer's tooling reads without guessing from prose.
+ *
+ *   **Affects:** `stitchkit/files/packaging` createNativePackaging(delivery: 'embedded')
+ *   **Affects:** `stitchkit/contract`, `stitchkit/server` AppError; `stitchkit` ApiError
+ *   **Affects:** `stitchkit/process` behaviour
+ *   **Affects:** `stitchkit/agent-runtime/harness-tools` *
+ *
+ * Targets are separated by `; `. A target is one or more backticked entrypoints
+ * (`, ` between them) and then either export names (`, ` between them, each with
+ * an optional parenthesised qualifier naming the option or member), `behaviour`
+ * for a change of semantics no import name reveals, or `*` for every import of
+ * the entrypoint (a removed leaf). The whole line stays on one line.
+ *
+ * Pure: shared by the release gate, which refuses a breaking item without it,
+ * and by `stitchkit upgrade`, which matches it against a project's imports.
+ */
+/** One export a breaking item changes, with what about it changed. */
+export interface UpgradeAffectedSymbol {
+    readonly name: string;
+    /** The option or member the change is about, as written, e.g. `delivery: 'embedded'`. */
+    readonly qualifier?: string;
+}
+/** What one target of an `**Affects:**` line touches in one entrypoint. */
+export type UpgradeAffectsTarget = {
+    readonly entrypoint: string;
+    readonly kind: 'symbols';
+    readonly symbols: readonly UpgradeAffectedSymbol[];
+} | {
+    readonly entrypoint: string;
+    readonly kind: 'behaviour';
+} | {
+    readonly entrypoint: string;
+    readonly kind: 'any-import';
+};
+/** One top-level `- ` item of a breaking section, with its lines as written. */
+export interface UpgradeBreakingItemText {
+    readonly markdown: string;
+}
+/** The line could not be read; `reason` says which part is malformed. */
+export declare class UpgradeAffectsError extends Error {
+    readonly name = "UpgradeAffectsError";
+}
+/**
+ * The top-level items of a breaking section. An item opens with a `- `, `* ` or
+ * `+ ` bullet at column zero outside a fence; indented and blank lines continue
+ * it, and the next unindented line closes it.
+ */
+export declare function breakingItems(section: string): UpgradeBreakingItemText[];
+/**
+ * The text after `**Affects:**` in an item, or undefined when it declares none.
+ * An item carries at most one such line; a second is refused, never dropped.
+ */
+export declare function affectsLineOf(itemMarkdown: string): string | undefined;
+/** Every target of an `**Affects:**` line; throws `UpgradeAffectsError` on a malformed one. */
+export declare function parseAffectsLine(line: string): UpgradeAffectsTarget[];
+//# sourceMappingURL=upgrade-affects.d.ts.map

package/dist/internal/upgrade-affects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-affects.d.ts","sourceRoot":"","sources":["../../src/internal/upgrade-affects.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,sEAAsE;AACtE,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,yFAAyF;IACzF,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,2EAA2E;AAC3E,MAAM,MAAM,oBAAoB,GAC5B;IACE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,SAAS,qBAAqB,EAAE,CAAC;CACpD,GACD;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAA;CAAE,GAC3D;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAA;CAAE,CAAC;AAEjE,gFAAgF;AAChF,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAOD,yEAAyE;AACzE,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,SAAkB,IAAI,yBAAyB;CAChD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,uBAAuB,EAAE,CA6BxE;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiBtE;AAyDD,+FAA+F;AAC/F,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,oBAAoB,EAAE,CAGrE"}

package/dist/internal/upgrade-plan.d.ts

@@ -7,11 +7,31 @@
  * consumer recovers the plan without cloning the repository or being told the
  * range by whoever cut the release.
  */
+import { type UpgradeAffectsTarget } from './upgrade-affects.js';
+/** One breaking item of a release, with its machine line when it declares one. */
+export interface UpgradeBreakingItem {
+    version: string;
+    /** The backticked entrypoints the item leads with. */
+    entrypoints: string[];
+    /** The item's bold title, or its first line. */
+    title: string;
+    /** What the item touches; `undefined` for an item written before the `**Affects:**` line. */
+    affects: UpgradeAffectsTarget[] | undefined;
+    /** The item's own `**Who must act:**`, or its section's. */
+    whoMustAct: string;
+    markdown: string;
+}
 export interface UpgradeBreakingChange {
     version: string;
     whoMustAct: string;
     markdown: string;
+    items: UpgradeBreakingItem[];
 }
+/**
+ * The heading that marks a changelog section as breaking. The release gate and `stitchkit upgrade`
+ * read it through this one expression, so a heading one accepts is a heading the other finds.
+ */
+export declare const BREAKING_HEADING: RegExp;
 /** Extract every breaking section crossed by an exact `from` (exclusive) → `to` (inclusive) upgrade. */
 export declare function planUpgrade(changelog: string, from: string, to: string): UpgradeBreakingChange[];
 export declare function renderUpgradePlan(changes: readonly UpgradeBreakingChange[], from: string, to: string): string;

package/dist/internal/upgrade-plan.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"upgrade-plan.d.ts","sourceRoot":"","sources":["../../src/internal/upgrade-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAsBD,wGAAwG;AACxG,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,qBAAqB,EAAE,CAgCzB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CASR"}
+{"version":3,"file":"upgrade-plan.d.ts","sourceRoot":"","sources":["../../src/internal/upgrade-plan.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,EAIL,KAAK,oBAAoB,EAC1B,MAAM,mBAAmB,CAAC;AAE3B,kFAAkF;AAClF,MAAM,WAAW,mBAAmB;IAClC,OAAO,EAAE,MAAM,CAAC;IAChB,sDAAsD;IACtD,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,gDAAgD;IAChD,KAAK,EAAE,MAAM,CAAC;IACd,6FAA6F;IAC7F,OAAO,EAAE,oBAAoB,EAAE,GAAG,SAAS,CAAC;IAC5C,4DAA4D;IAC5D,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,qBAAqB;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,mBAAmB,EAAE,CAAC;CAC9B;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AA2EzE,wGAAwG;AACxG,wBAAgB,WAAW,CACzB,SAAS,EAAE,MAAM,EACjB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,qBAAqB,EAAE,CAgCzB;AAED,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,SAAS,qBAAqB,EAAE,EACzC,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,MAAM,CASR"}

package/dist/internal/upgrade-usage.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Whether a breaking item touches one project: the plan's `**Affects:**` lines
+ * against the names the project imports from `stitchkit`.
+ *
+ * Pure over source text. The scanner reads static `import`/`export … from`
+ * declarations at a statement start (named, aliased, `type`, default, namespace,
+ * `export *`), bare imports, and `import()` / `require()` of a literal specifier,
+ * and the script blocks of `.vue` and `.svelte` files. Comments and the contents
+ * of strings and templates are blanked first, so a commented-out import or one
+ * written inside a string is not a use; it does not evaluate code, so a
+ * specifier built at run time is invisible to it, and a regular-expression literal that holds a
+ * quote or a comment marker can hide what follows it.
+ */
+import type { UpgradeAffectsTarget } from './upgrade-affects.js';
+import type { UpgradeBreakingItem } from './upgrade-plan.js';
+/** One project file, by a path relative to the project root. */
+export interface ProjectSource {
+    readonly path: string;
+    readonly text: string;
+}
+/** One name a file imports from one stitchkit entrypoint; `*` for a namespace, star or dynamic import. */
+export interface StitchkitImport {
+    readonly path: string;
+    readonly line: number;
+    readonly entrypoint: string;
+    readonly name: string;
+}
+export type UpgradeVerdict = {
+    readonly kind: 'affects';
+    readonly uses: readonly StitchkitImport[];
+} | {
+    readonly kind: 'not-used';
+} | {
+    readonly kind: 'behavioural';
+    readonly files: readonly string[];
+} | {
+    readonly kind: 'not-declared';
+    readonly files: readonly string[];
+};
+export interface UpgradeItemVerdict {
+    readonly item: UpgradeBreakingItem;
+    readonly verdict: UpgradeVerdict;
+}
+/** Every name the given sources import from a `stitchkit` entrypoint. */
+export declare function scanStitchkitImports(sources: readonly ProjectSource[]): StitchkitImport[];
+/** One verdict per item, in plan order. */
+export declare function upgradeVerdicts(items: readonly UpgradeBreakingItem[], imports: readonly StitchkitImport[]): UpgradeItemVerdict[];
+/** The verdicts as the Markdown section `stitchkit upgrade` prints after the plan. */
+export declare function renderUpgradeVerdicts(verdicts: readonly UpgradeItemVerdict[]): string;
+/** The verdicts as the `--json` document's items. */
+export declare function upgradeVerdictsJson(verdicts: readonly UpgradeItemVerdict[]): {
+    version: string;
+    entrypoints: string[];
+    title: string;
+    whoMustAct: string;
+    affects: UpgradeAffectsTarget[] | null;
+    verdict: "affects" | "behavioural" | "not-declared" | "not-used";
+    uses?: readonly StitchkitImport[] | undefined;
+    files?: readonly string[] | undefined;
+}[];
+//# sourceMappingURL=upgrade-usage.d.ts.map

package/dist/internal/upgrade-usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"upgrade-usage.d.ts","sourceRoot":"","sources":["../../src/internal/upgrade-usage.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AACH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1D,gEAAgE;AAChE,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,0GAA0G;AAC1G,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,eAAe,EAAE,CAAA;CAAE,GACvE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAA;CAAE,GAC7B;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GACnE;IAAE,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAC;AAEzE,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,IAAI,EAAE,mBAAmB,CAAC;IACnC,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC;CAClC;AAsHD,yEAAyE;AACzE,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,SAAS,aAAa,EAAE,GAAG,eAAe,EAAE,CA+BzF;AAyBD,2CAA2C;AAC3C,wBAAgB,eAAe,CAC7B,KAAK,EAAE,SAAS,mBAAmB,EAAE,EACrC,OAAO,EAAE,SAAS,eAAe,EAAE,GAClC,kBAAkB,EAAE,CAiBtB;AASD,sFAAsF;AACtF,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE,GAAG,MAAM,CAoBrF;AAED,qDAAqD;AACrD,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,SAAS,kBAAkB,EAAE;;;;;;;;;IAa1E"}