@zarel-ai/sdk 0.6.0

package/dist/_internal/mcp.js

@@ -0,0 +1,79 @@
+"use strict";
+// Spec 2 — pure extraction of an MCP JSON-RPC response from the dual
+// content-type body (application/json OR a single text/event-stream frame).
+// Zero runtime deps: reuses the pure SSE frame parser; validates the JSON-RPC
+// shape with a hand-written type-guard (no Zod, no `as` beyond the
+// unknown→record narrowing the transport's envelope-shape guard already uses).
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extractMcpResponse = extractMcpResponse;
+const errors_1 = require("../errors");
+const sse_client_1 = require("./sse-client");
+function isValidError(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    return typeof obj.code === 'number' && typeof obj.message === 'string';
+}
+/**
+ * A parsed body is a JSON-RPC response iff it is an object with a present `id`
+ * (string | number | null) and EXACTLY ONE of a present `result` (any value) or
+ * a well-formed `error` member. Keying on id + (result xor error) — rather than
+ * on `jsonrpc` — tolerates a server that omits the version field while rejecting
+ * a non-JSON-RPC body (e.g. a stray `{success,data}` envelope or an HTML page).
+ */
+function isMcpJsonRpcResponse(value) {
+    if (typeof value !== 'object' || value === null)
+        return false;
+    const obj = value;
+    if (!('id' in obj))
+        return false;
+    const id = obj.id;
+    if (!(typeof id === 'string' || typeof id === 'number' || id === null))
+        return false;
+    const hasResult = 'result' in obj;
+    const hasError = 'error' in obj && isValidError(obj.error);
+    return hasResult !== hasError;
+}
+/** Pull the first non-empty `data` payload out of an SSE body. */
+function extractSseData(body) {
+    // Whole-body (non-streaming) parse: `parseSseFrames` only emits blocks closed
+    // by a blank line, leaving any unterminated trailing block in `carry`. A
+    // single final `data:` frame sent without the closing `\n\n` would otherwise
+    // be dropped — flush it by re-feeding `carry` with a terminator.
+    const { frames, carry } = (0, sse_client_1.parseSseFrames)(body, '');
+    const allFrames = carry.trim() === ''
+        ? frames
+        : [...frames, ...(0, sse_client_1.parseSseFrames)('\n\n', carry).frames];
+    for (const frame of allFrames) {
+        if (frame.data !== '')
+            return frame.data;
+    }
+    throw new errors_1.ZarelError('MCP SSE response contained no data frame');
+}
+/**
+ * Extract the typed JSON-RPC response from an MCP transport reply. The server
+ * frames `text/event-stream` as a single `message` data frame; everything else
+ * (application/json, or a JSON body with no/odd content-type) is parsed
+ * directly. A protocol-level JSON-RPC error is RETURNED in the union (the caller
+ * discriminates with `'error' in res`); a body that is not a valid JSON-RPC
+ * response throws `ZarelError`.
+ */
+function extractMcpResponse(contentType, bodyText) {
+    const isSse = contentType !== null && contentType.includes('text/event-stream');
+    const jsonText = isSse ? extractSseData(bodyText) : bodyText;
+    if (jsonText.trim() === '') {
+        throw new errors_1.ZarelError('MCP response body is empty');
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(jsonText);
+    }
+    catch {
+        throw new errors_1.ZarelError('MCP response body is not valid JSON');
+    }
+    if (!isMcpJsonRpcResponse(parsed)) {
+        throw new errors_1.ZarelError('MCP response is not a valid JSON-RPC response');
+    }
+    return parsed;
+}
+//# sourceMappingURL=mcp.js.map

package/dist/_internal/mcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp.js","sourceRoot":"","sources":["../../src/_internal/mcp.ts"],"names":[],"mappings":";AAAA,qEAAqE;AACrE,4EAA4E;AAC5E,8EAA8E;AAC9E,mEAAmE;AACnE,+EAA+E;;AAsD/E,gDAgBC;AApED,sCAAuC;AAEvC,6CAA8C;AAE9C,SAAS,YAAY,CAAC,KAAc;IAChC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,OAAO,OAAO,GAAG,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,GAAG,CAAC,OAAO,KAAK,QAAQ,CAAC;AAC3E,CAAC;AAED;;;;;;GAMG;AACH,SAAS,oBAAoB,CAAC,KAAc;IACxC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,KAAK,CAAC;IAC9D,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,IAAI,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC;QAAE,OAAO,KAAK,CAAC;IACjC,MAAM,EAAE,GAAG,GAAG,CAAC,EAAE,CAAC;IAClB,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,QAAQ,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,KAAK,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACrF,MAAM,SAAS,GAAG,QAAQ,IAAI,GAAG,CAAC;IAClC,MAAM,QAAQ,GAAG,OAAO,IAAI,GAAG,IAAI,YAAY,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAC3D,OAAO,SAAS,KAAK,QAAQ,CAAC;AAClC,CAAC;AAED,kEAAkE;AAClE,SAAS,cAAc,CAAC,IAAY;IAChC,8EAA8E;IAC9E,yEAAyE;IACzE,6EAA6E;IAC7E,iEAAiE;IACjE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,IAAA,2BAAc,EAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACnD,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE;QACjC,CAAC,CAAC,MAAM;QACR,CAAC,CAAC,CAAC,GAAG,MAAM,EAAE,GAAG,IAAA,2BAAc,EAAC,MAAM,EAAE,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC;IAC3D,KAAK,MAAM,KAAK,IAAI,SAAS,EAAE,CAAC;QAC5B,IAAI,KAAK,CAAC,IAAI,KAAK,EAAE;YAAE,OAAO,KAAK,CAAC,IAAI,CAAC;IAC7C,CAAC;IACD,MAAM,IAAI,mBAAU,CAAC,0CAA0C,CAAC,CAAC;AACrE,CAAC;AAED;;;;;;;GAOG;AACH,SAAgB,kBAAkB,CAAC,WAA0B,EAAE,QAAgB;IAC3E,MAAM,KAAK,GAAG,WAAW,KAAK,IAAI,IAAI,WAAW,CAAC,QAAQ,CAAC,mBAAmB,CAAC,CAAC;IAChF,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IAC7D,IAAI,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;QACzB,MAAM,IAAI,mBAAU,CAAC,4BAA4B,CAAC,CAAC;IACvD,CAAC;IACD,IAAI,MAAe,CAAC;IACpB,IAAI,CAAC;QACD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACL,MAAM,IAAI,mBAAU,CAAC,qCAAqC,CAAC,CAAC;IAChE,CAAC;IACD,IAAI,CAAC,oBAAoB,CAAC,MAAM,CAAC,EAAE,CAAC;QAChC,MAAM,IAAI,mBAAU,CAAC,+CAA+C,CAAC,CAAC;IAC1E,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/dist/_internal/pagination.d.ts

@@ -0,0 +1,71 @@
+/**
+ * Auto-pagination (Track G2). Pure TS, zero runtime deps.
+ *
+ * `PagePromise<Page, Item>` is the value returned by the SDK's paginated `list`
+ * calls. It is simultaneously:
+ *   - a `Promise<Page>` — `await list(...)` resolves to today's single-page shape
+ *     (backward-compatible: the class implements the full `Promise<Page>`
+ *     interface, so it stays assignable to the pre-G2 return type); and
+ *   - an `AsyncIterable<Item>` — `for await (const item of list(...))` paginates
+ *     over every item across all pages.
+ *
+ * A `PaginationStrategy` knows how to extract items from a page and how to
+ * advance to the next page (or signal exhaustion) for one of the three wire
+ * models (offset+total, cursor, bare-array-offset). Strategies use typed
+ * accessor functions — never `as` or a schema library (QI-004).
+ *
+ * No default page size is injected into the request: the first page is fetched
+ * with the caller's params verbatim (so `await list(...)` is byte-identical to
+ * pre-G2 — QI-001). Page size, where a strategy needs it, is the caller's
+ * `limit` or the size of the first page returned by the server.
+ */
+/** Per-page request parameters the iterator advances between pages. */
+export interface PageParams {
+    limit?: number;
+    offset?: number;
+    cursor?: string;
+    [key: string]: unknown;
+}
+/** How to read items from a page and compute the next page's params. */
+export interface PaginationStrategy<Page, Item> {
+    items(page: Page): readonly Item[];
+    /** Next page's params, or `null` when the result set is exhausted. */
+    nextParams(page: Page, current: PageParams, lastCount: number): PageParams | null;
+}
+/**
+ * Offset pagination with an authoritative `total` (e.g. records). Advances the
+ * offset by the number of items actually returned and stops once `total` is
+ * consumed — robust to a server page size that differs from any caller `limit`.
+ */
+export declare function offsetWithTotal<Page, Item>(getItems: (page: Page) => readonly Item[], getTotal: (page: Page) => number): PaginationStrategy<Page, Item>;
+/** Cursor pagination (e.g. traces). Follows the next cursor until it is null/absent. */
+export declare function cursorBased<Page, Item>(getItems: (page: Page) => readonly Item[], getCursor: (page: Page) => string | null | undefined): PaginationStrategy<Page, Item>;
+/**
+ * Offset pagination over a bare array with no `total`/cursor (e.g. conversation
+ * sessions). End-of-data is inferred from `lastCount < pageSize`, where the
+ * page size is the **server's actual first-page length** — never the caller's
+ * requested `limit`. Trusting the requested `limit` would silently drop data if
+ * the server capped a page below it (a full first page shorter than the
+ * requested `limit` would be misread as the final page). Consequences: (a) one
+ * extra request returns an empty page and iteration stops when the row count is
+ * an exact multiple of the page size; (b) one extra empty request when the
+ * whole result fits within the first page — both bounded, no item missed or
+ * duplicated. The requested `limit` is still sent as the per-request page size
+ * by the resource; this strategy governs only termination.
+ */
+export declare function bareArrayOffset<Item>(): PaginationStrategy<Item[], Item>;
+/** A promise of the first page that can also be async-iterated over all items. */
+export declare class PagePromise<Page, Item> implements Promise<Page>, AsyncIterable<Item> {
+    private readonly fetchPage;
+    private readonly strategy;
+    private readonly initialParams;
+    private firstPage?;
+    constructor(fetchPage: (params: PageParams) => Promise<Page>, strategy: PaginationStrategy<Page, Item>, initialParams: PageParams);
+    private getFirstPage;
+    then<TResult1 = Page, TResult2 = never>(onfulfilled?: ((value: Page) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: unknown) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+    catch<TResult = never>(onrejected?: ((reason: unknown) => TResult | PromiseLike<TResult>) | null): Promise<Page | TResult>;
+    finally(onfinally?: (() => void) | null): Promise<Page>;
+    get [Symbol.toStringTag](): string;
+    [Symbol.asyncIterator](): AsyncIterator<Item>;
+}
+//# sourceMappingURL=pagination.d.ts.map

package/dist/_internal/pagination.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.d.ts","sourceRoot":"","sources":["../../src/_internal/pagination.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,uEAAuE;AACvE,MAAM,WAAW,UAAU;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CAC1B;AAED,wEAAwE;AACxE,MAAM,WAAW,kBAAkB,CAAC,IAAI,EAAE,IAAI;IAC1C,KAAK,CAAC,IAAI,EAAE,IAAI,GAAG,SAAS,IAAI,EAAE,CAAC;IACnC,sEAAsE;IACtE,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAAC;CACrF;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,IAAI,EACtC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,EAAE,EACzC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GACjC,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAUhC;AAED,wFAAwF;AACxF,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAClC,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,SAAS,IAAI,EAAE,EACzC,SAAS,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,MAAM,GAAG,IAAI,GAAG,SAAS,GACrD,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,CAUhC;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,eAAe,CAAC,IAAI,KAAK,kBAAkB,CAAC,IAAI,EAAE,EAAE,IAAI,CAAC,CAUxE;AAED,kFAAkF;AAClF,qBAAa,WAAW,CAAC,IAAI,EAAE,IAAI,CAAE,YAAW,OAAO,CAAC,IAAI,CAAC,EAAE,aAAa,CAAC,IAAI,CAAC;IAI1E,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,aAAa;IALlC,OAAO,CAAC,SAAS,CAAC,CAAgB;gBAGb,SAAS,EAAE,CAAC,MAAM,EAAE,UAAU,KAAK,OAAO,CAAC,IAAI,CAAC,EAChD,QAAQ,EAAE,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,EACxC,aAAa,EAAE,UAAU;IAG9C,OAAO,CAAC,YAAY;IAOb,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,GAAG,KAAK,EACzC,WAAW,CAAC,EAAE,CAAC,CAAC,KAAK,EAAE,IAAI,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,EACxE,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,QAAQ,GAAG,WAAW,CAAC,QAAQ,CAAC,CAAC,GAAG,IAAI,GAC5E,OAAO,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAIxB,KAAK,CAAC,OAAO,GAAG,KAAK,EACxB,UAAU,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,OAAO,KAAK,OAAO,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,GAAG,IAAI,GAC1E,OAAO,CAAC,IAAI,GAAG,OAAO,CAAC;IAInB,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,MAAM,IAAI,CAAC,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;IAI9D,IAAW,CAAC,MAAM,CAAC,WAAW,CAAC,IAAI,MAAM,CAExC;IAIa,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,IAAI,CAAC;CAY9D"}

package/dist/_internal/pagination.js

@@ -0,0 +1,130 @@
+"use strict";
+/**
+ * Auto-pagination (Track G2). Pure TS, zero runtime deps.
+ *
+ * `PagePromise<Page, Item>` is the value returned by the SDK's paginated `list`
+ * calls. It is simultaneously:
+ *   - a `Promise<Page>` — `await list(...)` resolves to today's single-page shape
+ *     (backward-compatible: the class implements the full `Promise<Page>`
+ *     interface, so it stays assignable to the pre-G2 return type); and
+ *   - an `AsyncIterable<Item>` — `for await (const item of list(...))` paginates
+ *     over every item across all pages.
+ *
+ * A `PaginationStrategy` knows how to extract items from a page and how to
+ * advance to the next page (or signal exhaustion) for one of the three wire
+ * models (offset+total, cursor, bare-array-offset). Strategies use typed
+ * accessor functions — never `as` or a schema library (QI-004).
+ *
+ * No default page size is injected into the request: the first page is fetched
+ * with the caller's params verbatim (so `await list(...)` is byte-identical to
+ * pre-G2 — QI-001). Page size, where a strategy needs it, is the caller's
+ * `limit` or the size of the first page returned by the server.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PagePromise = void 0;
+exports.offsetWithTotal = offsetWithTotal;
+exports.cursorBased = cursorBased;
+exports.bareArrayOffset = bareArrayOffset;
+/**
+ * Offset pagination with an authoritative `total` (e.g. records). Advances the
+ * offset by the number of items actually returned and stops once `total` is
+ * consumed — robust to a server page size that differs from any caller `limit`.
+ */
+function offsetWithTotal(getItems, getTotal) {
+    return {
+        items: getItems,
+        nextParams(page, current, lastCount) {
+            const total = getTotal(page);
+            const consumed = (current.offset ?? 0) + lastCount;
+            if (lastCount === 0 || consumed >= total)
+                return null;
+            return { ...current, offset: consumed };
+        },
+    };
+}
+/** Cursor pagination (e.g. traces). Follows the next cursor until it is null/absent. */
+function cursorBased(getItems, getCursor) {
+    return {
+        items: getItems,
+        nextParams(page, current) {
+            const cursor = getCursor(page);
+            // Deliberate loose `==` — treats both null and undefined as terminal.
+            if (cursor == null)
+                return null;
+            return { ...current, cursor };
+        },
+    };
+}
+/**
+ * Offset pagination over a bare array with no `total`/cursor (e.g. conversation
+ * sessions). End-of-data is inferred from `lastCount < pageSize`, where the
+ * page size is the **server's actual first-page length** — never the caller's
+ * requested `limit`. Trusting the requested `limit` would silently drop data if
+ * the server capped a page below it (a full first page shorter than the
+ * requested `limit` would be misread as the final page). Consequences: (a) one
+ * extra request returns an empty page and iteration stops when the row count is
+ * an exact multiple of the page size; (b) one extra empty request when the
+ * whole result fits within the first page — both bounded, no item missed or
+ * duplicated. The requested `limit` is still sent as the per-request page size
+ * by the resource; this strategy governs only termination.
+ */
+function bareArrayOffset() {
+    let pageSize;
+    return {
+        items: (page) => page,
+        nextParams(_page, current, lastCount) {
+            if (pageSize === undefined)
+                pageSize = lastCount;
+            if (pageSize === 0 || lastCount < pageSize)
+                return null;
+            return { ...current, offset: (current.offset ?? 0) + lastCount };
+        },
+    };
+}
+/** A promise of the first page that can also be async-iterated over all items. */
+class PagePromise {
+    fetchPage;
+    strategy;
+    initialParams;
+    firstPage;
+    constructor(fetchPage, strategy, initialParams) {
+        this.fetchPage = fetchPage;
+        this.strategy = strategy;
+        this.initialParams = initialParams;
+    }
+    getFirstPage() {
+        if (!this.firstPage)
+            this.firstPage = this.fetchPage(this.initialParams);
+        return this.firstPage;
+    }
+    // ── Promise<Page> face (delegates to the lazy, memoized first page) ──
+    then(onfulfilled, onrejected) {
+        return this.getFirstPage().then(onfulfilled, onrejected);
+    }
+    catch(onrejected) {
+        return this.getFirstPage().catch(onrejected);
+    }
+    finally(onfinally) {
+        return this.getFirstPage().finally(onfinally);
+    }
+    get [Symbol.toStringTag]() {
+        return 'PagePromise';
+    }
+    // ── AsyncIterable<Item> face ──
+    async *[Symbol.asyncIterator]() {
+        let params = this.initialParams;
+        let page = await this.getFirstPage(); // reuse the memoized first page
+        for (;;) {
+            const items = this.strategy.items(page);
+            for (const item of items)
+                yield item;
+            const next = this.strategy.nextParams(page, params, items.length);
+            if (next === null)
+                return;
+            params = next;
+            page = await this.fetchPage(next);
+        }
+    }
+}
+exports.PagePromise = PagePromise;
+//# sourceMappingURL=pagination.js.map

package/dist/_internal/pagination.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pagination.js","sourceRoot":"","sources":["../../src/_internal/pagination.ts"],"names":[],"mappings":"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"}

package/dist/_internal/require-token.d.ts

@@ -0,0 +1,17 @@
+import type { ZarelAuthErrorCode } from '../errors';
+/**
+ * Spec 050 / FR-007 / FR-008 — guard that a plane's token is configured
+ * before any network I/O is attempted.
+ *
+ * Called at the entry of every resource method in `client.runtime.*` and
+ * `client.contract.*`. The check is pure and deterministic — no side
+ * effects beyond the throw. The thrown `ZarelAuthError.code` is one of
+ * `'runtime_token_missing'` or `'contract_token_missing'`; server-issued
+ * 401s use `'unauthorized'` and are raised by FetchClient instead.
+ *
+ * Per ADR-0098, JWT-class and API-key-prefix validation is the server's
+ * responsibility (runtime-api / contract-api sentinel middleware); this
+ * helper does NOT inspect token contents — only presence.
+ */
+export declare function requireToken(token: string | undefined, code: Extract<ZarelAuthErrorCode, 'runtime_token_missing' | 'contract_token_missing'>): void;
+//# sourceMappingURL=require-token.d.ts.map

package/dist/_internal/require-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-token.d.ts","sourceRoot":"","sources":["../../src/_internal/require-token.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEpD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CACxB,KAAK,EAAE,MAAM,GAAG,SAAS,EACzB,IAAI,EAAE,OAAO,CAAC,kBAAkB,EAAE,uBAAuB,GAAG,wBAAwB,CAAC,GACtF,IAAI,CAON"}

package/dist/_internal/require-token.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.requireToken = requireToken;
+const errors_1 = require("../errors");
+/**
+ * Spec 050 / FR-007 / FR-008 — guard that a plane's token is configured
+ * before any network I/O is attempted.
+ *
+ * Called at the entry of every resource method in `client.runtime.*` and
+ * `client.contract.*`. The check is pure and deterministic — no side
+ * effects beyond the throw. The thrown `ZarelAuthError.code` is one of
+ * `'runtime_token_missing'` or `'contract_token_missing'`; server-issued
+ * 401s use `'unauthorized'` and are raised by FetchClient instead.
+ *
+ * Per ADR-0098, JWT-class and API-key-prefix validation is the server's
+ * responsibility (runtime-api / contract-api sentinel middleware); this
+ * helper does NOT inspect token contents — only presence.
+ */
+function requireToken(token, code) {
+    if (token && token.length > 0)
+        return;
+    const plane = code === 'runtime_token_missing' ? 'runtime' : 'contract';
+    throw new errors_1.ZarelAuthError(`${plane} token not configured — pass ${plane}Token to Zarel constructor`, code);
+}
+//# sourceMappingURL=require-token.js.map

package/dist/_internal/require-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"require-token.js","sourceRoot":"","sources":["../../src/_internal/require-token.ts"],"names":[],"mappings":";;AAiBA,oCAUC;AA3BD,sCAA2C;AAG3C;;;;;;;;;;;;;GAaG;AACH,SAAgB,YAAY,CACxB,KAAyB,EACzB,IAAqF;IAErF,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO;IACtC,MAAM,KAAK,GAAG,IAAI,KAAK,uBAAuB,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,UAAU,CAAC;IACxE,MAAM,IAAI,uBAAc,CACpB,GAAG,KAAK,gCAAgC,KAAK,4BAA4B,EACzE,IAAI,CACP,CAAC;AACN,CAAC"}

package/dist/_internal/retry-after.d.ts

@@ -0,0 +1,2 @@
+export declare function parseRetryAfter(value: string | null, nowMs: number): number | undefined;
+//# sourceMappingURL=retry-after.d.ts.map

package/dist/_internal/retry-after.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.d.ts","sourceRoot":"","sources":["../../src/_internal/retry-after.ts"],"names":[],"mappings":"AASA,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAkBvF"}

package/dist/_internal/retry-after.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseRetryAfter = parseRetryAfter;
+// Pure parser for the HTTP `Retry-After` response header (RFC 7231 §7.1.3).
+// Two forms are accepted: an integer count of seconds (delta-seconds) and an
+// HTTP-date. Returns a NON-NEGATIVE millisecond delay, or `undefined` when the
+// header is absent/unparseable. The caller injects `nowMs` (so the HTTP-date
+// arithmetic is deterministic and testable) and is responsible for clamping the
+// result to a ceiling — this module is parsing only, no policy.
+//
+// No `as` cast, no schema library — hand-written narrowing (the SDK's zero-dep,
+// no-Zod boundary convention).
+function parseRetryAfter(value, nowMs) {
+    if (value === null)
+        return undefined;
+    const trimmed = value.trim();
+    if (trimmed === '')
+        return undefined;
+    // delta-seconds: an integer number of seconds (RFC 7231 requires an integer).
+    if (/^-?\d+$/.test(trimmed)) {
+        const seconds = Number(trimmed);
+        return Math.max(0, seconds * 1000);
+    }
+    // HTTP-date: must contain letters (month/day names + "GMT") — this rejects
+    // bare numerics like "1.5"/"1e3" that `Date.parse` would otherwise coerce
+    // into a year. A real HTTP-date → delta from now, floored at 0.
+    if (!/[a-zA-Z]/.test(trimmed))
+        return undefined;
+    const parsed = Date.parse(trimmed);
+    if (Number.isNaN(parsed))
+        return undefined;
+    return Math.max(0, parsed - nowMs);
+}
+//# sourceMappingURL=retry-after.js.map

package/dist/_internal/retry-after.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry-after.js","sourceRoot":"","sources":["../../src/_internal/retry-after.ts"],"names":[],"mappings":";;AASA,0CAkBC;AA3BD,4EAA4E;AAC5E,6EAA6E;AAC7E,+EAA+E;AAC/E,6EAA6E;AAC7E,gFAAgF;AAChF,gEAAgE;AAChE,EAAE;AACF,gFAAgF;AAChF,+BAA+B;AAC/B,SAAgB,eAAe,CAAC,KAAoB,EAAE,KAAa;IAC/D,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,SAAS,CAAC;IACrC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC7B,IAAI,OAAO,KAAK,EAAE;QAAE,OAAO,SAAS,CAAC;IAErC,8EAA8E;IAC9E,IAAI,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC1B,MAAM,OAAO,GAAG,MAAM,CAAC,OAAO,CAAC,CAAC;QAChC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,OAAO,GAAG,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,2EAA2E;IAC3E,0EAA0E;IAC1E,gEAAgE;IAChE,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,OAAO,CAAC;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;IACnC,IAAI,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO,SAAS,CAAC;IAC3C,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/_internal/sse-client.d.ts

@@ -0,0 +1,43 @@
+import type { EventStreamHandle, EventStreamHandlers, EventStreamOptions } from '../types/events-stream';
+export interface RawSseFrame {
+    event?: string;
+    data: string;
+    id?: string;
+    retry?: number;
+}
+/**
+ * Incrementally parse SSE text. Pure over `(chunk, carry)`: returns the complete
+ * frames found and the leftover `carry` (an unterminated trailing block) to feed
+ * into the next call. Frames are delimited by a blank line (`\n\n`).
+ */
+export declare function parseSseFrames(chunk: string, carry: string): {
+    frames: RawSseFrame[];
+    carry: string;
+};
+/** The outcome of one connect attempt, classified by the transport. */
+export type ConnectOutcome = {
+    kind: 'open';
+    body: ReadableStream<Uint8Array>;
+} | {
+    kind: 'terminal';
+    error: unknown;
+} | {
+    kind: 'transient';
+    error?: unknown;
+};
+export interface StreamLoopDeps {
+    /** One connect attempt. Resolves an open body, or a terminal/transient disposition. */
+    connect: (lastEventId: string | undefined, signal: AbortSignal) => Promise<ConnectOutcome>;
+    handlers: EventStreamHandlers;
+    options: EventStreamOptions;
+    baseDelayMs?: number;
+    maxDelayMs?: number;
+    sleep?: (ms: number, signal: AbortSignal) => Promise<void>;
+}
+/**
+ * Drive a self-reconnecting SSE consumption loop. Returns an `EventStreamHandle`
+ * synchronously; the first connect happens asynchronously. Reconnect attempts are
+ * UNBOUNDED (until `close()`/abort/terminal); only the per-attempt delay is capped.
+ */
+export declare function runEventStream(deps: StreamLoopDeps): EventStreamHandle;
+//# sourceMappingURL=sse-client.d.ts.map

package/dist/_internal/sse-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-client.d.ts","sourceRoot":"","sources":["../../src/_internal/sse-client.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EACR,iBAAiB,EACjB,mBAAmB,EACnB,kBAAkB,EACrB,MAAM,wBAAwB,CAAC;AAUhC,MAAM,WAAW,WAAW;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;CAClB;AAoDD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,MAAM,EAAE,WAAW,EAAE,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAcrG;AAID,uEAAuE;AACvE,MAAM,MAAM,cAAc,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,cAAc,CAAC,UAAU,CAAC,CAAA;CAAE,GAClD;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GACpC;IAAE,IAAI,EAAE,WAAW,CAAC;IAAC,KAAK,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAE7C,MAAM,WAAW,cAAc;IAC3B,uFAAuF;IACvF,OAAO,EAAE,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,cAAc,CAAC,CAAC;IAC3F,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,OAAO,EAAE,kBAAkB,CAAC;IAE5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9D;AAoBD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,cAAc,GAAG,iBAAiB,CA+FtE"}