@truefoundry/ai-gateway-sdk 0.0.0-stage → 0.0.1

package/dist/adapters/messages/streamTransform.js

@@ -0,0 +1,174 @@
+/**
+ * Stream Transform for Messages API Adapter
+ *
+ * Transforms Chat Completions SSE chunks to Anthropic Messages API SSE format.
+ */
+import crypto from 'crypto';
+import { parseSseDataJson } from '../../utils/sseUtils.js';
+import { SSE_DONE } from '../constants.js';
+export function createMessagesStreamState() {
+    return {
+        messageId: '',
+        model: '',
+        hasStarted: false,
+        completed: false,
+        inputTokens: 0,
+        outputTokens: 0,
+        cacheReadInputTokens: 0,
+        cacheCreationInputTokens: 0,
+        stopReason: null,
+        sentTextBlockStart: false,
+        openToolBlockIndices: new Set(),
+    };
+}
+/**
+ * Transform a single Chat Completions stream chunk to Messages API stream events.
+ * Expects complete SSE messages (not partial byte chunks).
+ */
+export function transformMessagesStreamChunk(chunk, state) {
+    const trimmed = chunk.trim();
+    // Handle [DONE]
+    if (trimmed === SSE_DONE) {
+        if (!state.hasStarted || state.completed)
+            return undefined;
+        state.completed = true;
+        const doneEvents = [];
+        // Close any open content blocks if finish_reason wasn't received
+        if (!state.stopReason) {
+            if (state.sentTextBlockStart) {
+                doneEvents.push(`event: content_block_stop\ndata: ${JSON.stringify({
+                    type: 'content_block_stop',
+                    index: 0,
+                })}\n\n`);
+            }
+            for (const toolIdx of state.openToolBlockIndices) {
+                doneEvents.push(`event: content_block_stop\ndata: ${JSON.stringify({
+                    type: 'content_block_stop',
+                    index: toolIdx,
+                })}\n\n`);
+            }
+        }
+        const streamUsage = {
+            output_tokens: state.outputTokens,
+            input_tokens: state.inputTokens,
+            ...(state.cacheReadInputTokens > 0 && { cache_read_input_tokens: state.cacheReadInputTokens }),
+            ...(state.cacheCreationInputTokens > 0 && { cache_creation_input_tokens: state.cacheCreationInputTokens }),
+        };
+        doneEvents.push(`event: message_delta\ndata: ${JSON.stringify({
+            type: 'message_delta',
+            delta: {
+                stop_reason: state.stopReason || 'end_turn',
+                stop_sequence: null,
+            },
+            usage: streamUsage,
+        })}\n\n`, `event: message_stop\ndata: ${JSON.stringify({ type: 'message_stop' })}\n\n`);
+        return doneEvents.join('');
+    }
+    const parsed = parseSseDataJson(chunk);
+    if (!parsed)
+        return undefined;
+    const events = [];
+    // Initialize on first chunk
+    if (!state.hasStarted) {
+        state.hasStarted = true;
+        state.messageId = `msg_${crypto.randomUUID()}`;
+        state.model = parsed.model || '';
+        events.push(`event: message_start\ndata: ${JSON.stringify({
+            type: 'message_start',
+            message: {
+                id: state.messageId,
+                type: 'message',
+                role: 'assistant',
+                content: [],
+                model: state.model,
+                stop_reason: null,
+                stop_sequence: null,
+                usage: { input_tokens: state.inputTokens, output_tokens: 0 },
+            },
+        })}\n\n`);
+    }
+    const delta = parsed.choices?.[0]?.delta;
+    // Content delta — lazily open text block on first actual text
+    if (delta?.content) {
+        if (!state.sentTextBlockStart) {
+            state.sentTextBlockStart = true;
+            events.push(`event: content_block_start\ndata: ${JSON.stringify({
+                type: 'content_block_start',
+                index: 0,
+                content_block: { type: 'text', text: '' },
+            })}\n\n`);
+        }
+        events.push(`event: content_block_delta\ndata: ${JSON.stringify({
+            type: 'content_block_delta',
+            index: 0,
+            delta: { type: 'text_delta', text: delta.content },
+        })}\n\n`);
+    }
+    // Tool calls
+    if (delta?.tool_calls) {
+        for (const tc of delta.tool_calls) {
+            // If a text block was emitted (index 0), tool calls start at 1+.
+            // Otherwise tool calls start at 0 to avoid gaps in the Anthropic index sequence.
+            const offset = state.sentTextBlockStart ? 1 : 0;
+            const idx = (tc.index ?? 0) + offset;
+            if (tc.function?.name) {
+                state.openToolBlockIndices.add(idx);
+                events.push(`event: content_block_start\ndata: ${JSON.stringify({
+                    type: 'content_block_start',
+                    index: idx,
+                    content_block: {
+                        type: 'tool_use',
+                        id: tc.id || `toolu_${crypto.randomUUID()}`,
+                        name: tc.function.name,
+                        input: {},
+                    },
+                })}\n\n`);
+            }
+            if (tc.function?.arguments) {
+                events.push(`event: content_block_delta\ndata: ${JSON.stringify({
+                    type: 'content_block_delta',
+                    index: idx,
+                    delta: {
+                        type: 'input_json_delta',
+                        partial_json: tc.function.arguments,
+                    },
+                })}\n\n`);
+            }
+        }
+    }
+    // Track usage
+    if (parsed.usage) {
+        state.inputTokens = parsed.usage.prompt_tokens ?? state.inputTokens;
+        state.outputTokens = parsed.usage.completion_tokens ?? state.outputTokens;
+        state.cacheReadInputTokens =
+            parsed.usage.cache_read_input_tokens ??
+                parsed.usage.cache_read_tokens ??
+                parsed.usage.prompt_tokens_details?.cached_tokens ??
+                state.cacheReadInputTokens;
+        state.cacheCreationInputTokens =
+            parsed.usage.cache_creation_input_tokens ?? parsed.usage.cache_write_tokens ?? state.cacheCreationInputTokens;
+    }
+    // Track stop reason
+    if (parsed.choices?.[0]?.finish_reason) {
+        const reason = parsed.choices[0].finish_reason;
+        state.stopReason = reason === 'tool_calls' ? 'tool_use' : reason === 'length' ? 'max_tokens' : 'end_turn';
+        // Emit content_block_stop for the text block (index 0) only if it was opened
+        if (state.sentTextBlockStart) {
+            events.push(`event: content_block_stop\ndata: ${JSON.stringify({
+                type: 'content_block_stop',
+                index: 0,
+            })}\n\n`);
+            state.sentTextBlockStart = false;
+        }
+        // Emit content_block_stop for all open tool blocks
+        for (const toolIdx of state.openToolBlockIndices) {
+            events.push(`event: content_block_stop\ndata: ${JSON.stringify({
+                type: 'content_block_stop',
+                index: toolIdx,
+            })}\n\n`);
+        }
+        state.openToolBlockIndices.clear();
+    }
+    return events.length > 0 ? events.join('') : undefined;
+}
+//# sourceMappingURL=streamTransform.js.map

package/dist/adapters/messages/streamTransform.js.map

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

package/dist/adapters/registry.d.ts

@@ -0,0 +1,68 @@
+import { Endpoint } from '../providers/types';
+import { Adapter, RequestFormat } from './types';
+/**
+ * Register an adapter for a request format.
+ * Called once at startup for each supported format.
+ */
+export declare function registerAdapter(adapter: Adapter): void;
+/** True when all request-format adapters are present in the registry. */
+export declare function hasAllAdaptersRegistered(): boolean;
+/** Test-only: clear the adapter registry between suites. */
+export declare function __clearAdaptersForTests(): void;
+/**
+ * Endpoint → format lookup against an arbitrary registry Map.
+ * DI seam for P6.2 / tests — production callers use {@link resolveAdapter}.
+ */
+export declare function resolveAdapterFromRegistry(registry: ReadonlyMap<RequestFormat, Adapter>, fn: Endpoint): Adapter | null;
+/**
+ * Resolve the adapter for a given endpoint (format) from the **default
+ * singleton registry**.
+ * Returns null for Chat Completions (no adapter needed — existing path).
+ * Pure endpoint → format lookup; no Hono / request context.
+ *
+ * Used by `createProviderRequest`. No Hono Context.
+ */
+export declare function resolveAdapter(fn: Endpoint): Adapter | null;
+/**
+ * Async generator to read SSE chunks from a ReadableStream.
+ * Yields complete SSE messages (delimited by double newlines).
+ * This ensures each chunk passed to the adapter is a complete SSE event,
+ * not a partial byte fragment.
+ *
+ * Delegates to shared {@link readSseFrames} (P5.3) so adapter and provider
+ * pumps do not diverge on buffering.
+ *
+ * Generator return value is `{ truncated }` — true when the upstream aborted
+ * (or threw AbortError). Callers must not synthesize a trailing `SSE_DONE`
+ * after a truncated stream.
+ */
+export declare function readSseStream(reader: ReadableStreamDefaultReader<Uint8Array>, options?: {
+    abortSignal?: AbortSignal;
+}): AsyncGenerator<string, {
+    truncated: boolean;
+}>;
+/**
+ * Transform a streaming CC response to the adapter's format.
+ *
+ * Uses an async IIFE with its own TransformStream so that the adapter's
+ * output stream is **decoupled** from the streaming handler's
+ * TransformStream. This prevents downstream cancellation (e.g. Hono
+ * cleaning up the HTTP response) from propagating backward and killing
+ * the pump with an `undefined` error.
+ *
+ * When the downstream writable errors (consumer canceled), we keep
+ * draining the upstream readable so the pump never stalls on
+ * backpressure.
+ *
+ * The adapter's `convertStreamChunkFromOpenAI` may return a string (SSE text)
+ * or Uint8Array (binary framing, e.g., AWS event stream with CRC32).
+ * The response Content-Type is set from `adapter.streamContentType`.
+ */
+export declare function adaptStreamingResponse(response: Response, adapter: Adapter, originalRequest?: Record<string, any>, options?: {
+    abortSignal?: AbortSignal;
+}): Response;
+/**
+ * Transform a non-streaming CC JSON response to the adapter's format.
+ */
+export declare function adaptNonStreamingResponse(response: Response, adapter: Adapter, provider: string, originalRequest: any): Promise<Response>;
+//# sourceMappingURL=registry.d.ts.map

package/dist/adapters/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/adapters/registry.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAI9C,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AASjD;;;GAGG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAEtD;AAED,yEAAyE;AACzE,wBAAgB,wBAAwB,IAAI,OAAO,CAIlD;AAED,4DAA4D;AAC5D,wBAAgB,uBAAuB,IAAI,IAAI,CAE9C;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,WAAW,CAAC,aAAa,EAAE,OAAO,CAAC,EAC7C,EAAE,EAAE,QAAQ,GACX,OAAO,GAAG,IAAI,CAoBhB;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,GAAG,IAAI,CAE3D;AAID;;;;;;;;;;;;GAYG;AACH,wBAAuB,aAAa,CAClC,MAAM,EAAE,2BAA2B,CAAC,UAAU,CAAC,EAC/C,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GACtC,cAAc,CAAC,MAAM,EAAE;IAAE,SAAS,EAAE,OAAO,CAAA;CAAE,CAAC,CAsBhD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,sBAAsB,CACpC,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,EACrC,OAAO,CAAC,EAAE;IAAE,WAAW,CAAC,EAAE,WAAW,CAAA;CAAE,GACtC,QAAQ,CA8DV;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,QAAQ,EAAE,QAAQ,EAClB,OAAO,EAAE,OAAO,EAChB,QAAQ,EAAE,MAAM,EAChB,eAAe,EAAE,GAAG,GACnB,OAAO,CAAC,QAAQ,CAAC,CAwDnB"}

package/dist/adapters/registry.js

@@ -0,0 +1,232 @@
+import { logger } from '../logger.js';
+import { readSseFrames } from '../stream/readSseFrames.js';
+import { ignoreWithLog, logIgnoredFailure } from '../utils/ignoreWithLog.js';
+import { SSE_DONE } from './constants.js';
+/**
+ * Process-wide default registry. {@link resolveAdapter} reads this Map.
+ * {@link initAdapters} registers factory-built instances (with injected
+ * GuardrailHelpers) into this singleton.
+ */
+const adapters = new Map();
+/**
+ * Register an adapter for a request format.
+ * Called once at startup for each supported format.
+ */
+export function registerAdapter(adapter) {
+    adapters.set(adapter.format, adapter);
+}
+/** True when all request-format adapters are present in the registry. */
+export function hasAllAdaptersRegistered() {
+    return (adapters.has('messages') && adapters.has('responses') && adapters.has('gemini') && adapters.has('bedrock-converse'));
+}
+/** Test-only: clear the adapter registry between suites. */
+export function __clearAdaptersForTests() {
+    adapters.clear();
+}
+/**
+ * Endpoint → format lookup against an arbitrary registry Map.
+ * DI seam for P6.2 / tests — production callers use {@link resolveAdapter}.
+ */
+export function resolveAdapterFromRegistry(registry, fn) {
+    switch (fn) {
+        case 'messages':
+            return registry.get('messages') ?? null;
+        case 'createModelResponse':
+        case 'createModelResponseCompact':
+            return registry.get('responses') ?? null;
+        case 'generateContent':
+        case 'stream-generateContent':
+            return registry.get('gemini') ?? null;
+        case 'bedrockConverse':
+        case 'stream-bedrockConverse':
+            return registry.get('bedrock-converse') ?? null;
+        default:
+            return null;
+    }
+}
+/**
+ * Resolve the adapter for a given endpoint (format) from the **default
+ * singleton registry**.
+ * Returns null for Chat Completions (no adapter needed — existing path).
+ * Pure endpoint → format lookup; no Hono / request context.
+ *
+ * Used by `createProviderRequest`. No Hono Context.
+ */
+export function resolveAdapter(fn) {
+    return resolveAdapterFromRegistry(adapters, fn);
+}
+// ─── SSE Stream Utilities ───────────────────────────────────────────────────
+/**
+ * Async generator to read SSE chunks from a ReadableStream.
+ * Yields complete SSE messages (delimited by double newlines).
+ * This ensures each chunk passed to the adapter is a complete SSE event,
+ * not a partial byte fragment.
+ *
+ * Delegates to shared {@link readSseFrames} (P5.3) so adapter and provider
+ * pumps do not diverge on buffering.
+ *
+ * Generator return value is `{ truncated }` — true when the upstream aborted
+ * (or threw AbortError). Callers must not synthesize a trailing `SSE_DONE`
+ * after a truncated stream.
+ */
+export async function* readSseStream(reader, options) {
+    const gen = readSseFrames({
+        reader,
+        splitPattern: '\n\n',
+        normalizeCrlf: true,
+        abortSignal: options?.abortSignal,
+    });
+    try {
+        while (true) {
+            const iter = await gen.next();
+            if (iter.done) {
+                // Only flush remainder on natural end (not abort / truncated).
+                if (!iter.value.truncated && iter.value.remainder.trim()) {
+                    yield iter.value.remainder;
+                }
+                return { truncated: !!iter.value.truncated };
+            }
+            yield iter.value;
+        }
+    }
+    finally {
+        await gen.return({ truncated: true, remainder: '' }).catch(ignoreWithLog('sdk.readSseStream.genReturn'));
+    }
+}
+/**
+ * Transform a streaming CC response to the adapter's format.
+ *
+ * Uses an async IIFE with its own TransformStream so that the adapter's
+ * output stream is **decoupled** from the streaming handler's
+ * TransformStream. This prevents downstream cancellation (e.g. Hono
+ * cleaning up the HTTP response) from propagating backward and killing
+ * the pump with an `undefined` error.
+ *
+ * When the downstream writable errors (consumer canceled), we keep
+ * draining the upstream readable so the pump never stalls on
+ * backpressure.
+ *
+ * The adapter's `convertStreamChunkFromOpenAI` may return a string (SSE text)
+ * or Uint8Array (binary framing, e.g., AWS event stream with CRC32).
+ * The response Content-Type is set from `adapter.streamContentType`.
+ */
+export function adaptStreamingResponse(response, adapter, originalRequest, options) {
+    if (!response.body)
+        return response;
+    const { readable, writable } = new TransformStream();
+    const writer = writable.getWriter();
+    const reader = response.body.getReader();
+    const textEncoder = new TextEncoder();
+    const state = adapter.createStreamState(originalRequest);
+    (async () => {
+        let writerOk = true;
+        const writeChunk = async (sseChunk) => {
+            if (!writerOk)
+                return;
+            try {
+                const result = adapter.convertStreamChunkFromOpenAI(sseChunk, state);
+                if (!result)
+                    return;
+                const bytes = typeof result === 'string' ? textEncoder.encode(result) : result;
+                await writer.write(bytes);
+            }
+            catch (error) {
+                logIgnoredFailure('sdk.adapter.streamWrite', error);
+                writerOk = false;
+            }
+        };
+        try {
+            let sawDone = false;
+            let truncated = false;
+            const sseGen = readSseStream(reader, { abortSignal: options?.abortSignal });
+            while (true) {
+                const iter = await sseGen.next();
+                if (iter.done) {
+                    truncated = iter.value.truncated;
+                    break;
+                }
+                if (iter.value.trim() === SSE_DONE.trim())
+                    sawDone = true;
+                await writeChunk(iter.value);
+            }
+            // Do not invent a clean end after provider/client abort (P5.3 review nit).
+            if (writerOk && !sawDone && !truncated) {
+                await writeChunk(SSE_DONE);
+            }
+        }
+        catch (err) {
+            if (err !== undefined) {
+                logger.error(`Adapter stream transform error: ${err?.message || err}`);
+            }
+        }
+        finally {
+            try {
+                await writer.close();
+            }
+            catch {
+                logger.error('Adapter stream transform error: writer.close() failed');
+            }
+        }
+    })();
+    const headers = new Headers(response.headers);
+    headers.set('content-type', adapter.streamContentType ?? 'text/event-stream');
+    headers.delete('content-length');
+    headers.delete('content-encoding');
+    headers.delete('transfer-encoding');
+    return new Response(readable, { status: 200, headers });
+}
+/**
+ * Transform a non-streaming CC JSON response to the adapter's format.
+ */
+export async function adaptNonStreamingResponse(response, adapter, provider, originalRequest) {
+    let json;
+    try {
+        const text = await response.text();
+        try {
+            json = JSON.parse(text);
+        }
+        catch {
+            logger.error({
+                message: 'Adapter response JSON parse failed, returning raw text as error',
+                provider,
+                status: response.status,
+            });
+            return new Response(JSON.stringify({ error: { message: text || 'Unknown error from provider', type: 'server_error' } }), { status: response.status || 500, headers: { 'content-type': 'application/json' } });
+        }
+    }
+    catch (err) {
+        logger.error({
+            message: 'Adapter response read failed',
+            provider,
+            status: response.status,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return new Response(JSON.stringify({ error: { message: 'Internal error', type: 'server_error' } }), {
+            status: 500,
+            headers: { 'content-type': 'application/json' },
+        });
+    }
+    let transformedJson;
+    try {
+        transformedJson = adapter.convertResponseFromOpenAI(json, response.status, provider, originalRequest);
+    }
+    catch (err) {
+        logger.error({
+            message: 'Adapter response transform failed',
+            provider,
+            status: response.status,
+            error: err instanceof Error ? err.message : String(err),
+        });
+        return new Response(JSON.stringify({ error: { message: 'Adapter response transform failed', type: 'server_error' } }), { status: 500, headers: { 'content-type': 'application/json' } });
+    }
+    const headers = new Headers(response.headers);
+    headers.delete('content-length');
+    headers.delete('content-encoding');
+    headers.delete('transfer-encoding');
+    headers.set('content-type', 'application/json');
+    return new Response(JSON.stringify(transformedJson), {
+        status: response.status,
+        headers,
+    });
+}
+//# sourceMappingURL=registry.js.map

package/dist/adapters/registry.js.map

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

package/dist/adapters/responses/encryptedContentAffinity.d.ts

@@ -0,0 +1,13 @@
+/**
+ * `encrypted_content` only decrypts on the key that produced it, so a stateless turn (`store: false`,
+ * no previous_response_id) that replays it must go back to the same backend. We stamp the serving
+ * target onto the blob and read it back on replay: `tfy_enc_v1:<base64url(target)>;<ciphertext>`.
+ *
+ * See live `src/adapters/responses/originPinning.ts` for the stateful case, where the
+ * response id carries the target instead (origin pinning stays gateway-owned).
+ */
+export declare const STAMPED_CONTENT_PREFIX = "tfy_enc_v1:";
+export declare const ENCRYPTED_CONTENT_KEY = "encrypted_content";
+export declare function stampEncryptedContent(payload: unknown, target: string): boolean;
+export declare function unstampEncryptedContent(payload: unknown): string | undefined;
+//# sourceMappingURL=encryptedContentAffinity.d.ts.map

package/dist/adapters/responses/encryptedContentAffinity.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryptedContentAffinity.d.ts","sourceRoot":"","sources":["../../../src/adapters/responses/encryptedContentAffinity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,sBAAsB,gBAAgB,CAAC;AAEpD,eAAO,MAAM,qBAAqB,sBAAsB,CAAC;AAuBzD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAK/E;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,GAAG,SAAS,CAY5E"}

package/dist/adapters/responses/encryptedContentAffinity.js

@@ -0,0 +1,55 @@
+/**
+ * `encrypted_content` only decrypts on the key that produced it, so a stateless turn (`store: false`,
+ * no previous_response_id) that replays it must go back to the same backend. We stamp the serving
+ * target onto the blob and read it back on replay: `tfy_enc_v1:<base64url(target)>;<ciphertext>`.
+ *
+ * See live `src/adapters/responses/originPinning.ts` for the stateful case, where the
+ * response id carries the target instead (origin pinning stays gateway-owned).
+ */
+export const STAMPED_CONTENT_PREFIX = 'tfy_enc_v1:';
+export const ENCRYPTED_CONTENT_KEY = 'encrypted_content';
+/**
+ * Apply `visit` to every `encrypted_content` string in a parsed payload; true if anything changed.
+ * Matching the key at any depth handles request input, JSON bodies, SSE events and compaction items
+ * with one implementation.
+ */
+function mapEncryptedContent(payload, visit) {
+    if (!payload || typeof payload !== 'object')
+        return false;
+    let changed = false;
+    for (const [key, value] of Object.entries(payload)) {
+        if (key === ENCRYPTED_CONTENT_KEY && typeof value === 'string' && value) {
+            const visited = visit(value);
+            if (visited === value)
+                continue;
+            payload[key] = visited;
+            changed = true;
+        }
+        else if (value && typeof value === 'object') {
+            changed = mapEncryptedContent(value, visit) || changed;
+        }
+    }
+    return changed;
+}
+export function stampEncryptedContent(payload, target) {
+    const stamp = `${STAMPED_CONTENT_PREFIX}${Buffer.from(target, 'utf8').toString('base64url')};`;
+    return mapEncryptedContent(payload, content => content.startsWith(STAMPED_CONTENT_PREFIX) ? content : `${stamp}${content}`);
+}
+export function unstampEncryptedContent(payload) {
+    let target;
+    mapEncryptedContent(payload, content => {
+        if (!content.startsWith(STAMPED_CONTENT_PREFIX))
+            return content;
+        const stampEnd = content.indexOf(';');
+        if (stampEnd < STAMPED_CONTENT_PREFIX.length)
+            return content;
+        const stamped = Buffer.from(content.slice(STAMPED_CONTENT_PREFIX.length, stampEnd), 'base64url').toString('utf8');
+        if (!stamped)
+            return content;
+        if (!target)
+            target = stamped;
+        return content.slice(stampEnd + 1);
+    });
+    return target;
+}
+//# sourceMappingURL=encryptedContentAffinity.js.map

package/dist/adapters/responses/encryptedContentAffinity.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"encryptedContentAffinity.js","sourceRoot":"","sources":["../../../src/adapters/responses/encryptedContentAffinity.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,sBAAsB,GAAG,aAAa,CAAC;AAEpD,MAAM,CAAC,MAAM,qBAAqB,GAAG,mBAAmB,CAAC;AAEzD;;;;GAIG;AACH,SAAS,mBAAmB,CAAC,OAAgB,EAAE,KAAkC;IAC/E,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAC1D,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QACnD,IAAI,GAAG,KAAK,qBAAqB,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,EAAE,CAAC;YACxE,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;YAC7B,IAAI,OAAO,KAAK,KAAK;gBAAE,SAAS;YAC/B,OAAmC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC;YACpD,OAAO,GAAG,IAAI,CAAC;QACjB,CAAC;aAAM,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;YAC9C,OAAO,GAAG,mBAAmB,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,OAAO,CAAC;QACzD,CAAC;IACH,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,OAAgB,EAAE,MAAc;IACpE,MAAM,KAAK,GAAG,GAAG,sBAAsB,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC;IAC/F,OAAO,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE,CAC5C,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,GAAG,KAAK,GAAG,OAAO,EAAE,CAC5E,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAgB;IACtD,IAAI,MAA0B,CAAC;IAC/B,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,EAAE;QACrC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,sBAAsB,CAAC;YAAE,OAAO,OAAO,CAAC;QAChE,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QACtC,IAAI,QAAQ,GAAG,sBAAsB,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC;QAC7D,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClH,IAAI,CAAC,OAAO;YAAE,OAAO,OAAO,CAAC;QAC7B,IAAI,CAAC,MAAM;YAAE,MAAM,GAAG,OAAO,CAAC;QAC9B,OAAO,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC;IACrC,CAAC,CAAC,CAAC;IACH,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/adapters/responses/index.d.ts

@@ -0,0 +1,7 @@
+import type { GuardrailHelpers } from '../guardrailHelpers';
+import { Adapter } from '../types';
+/**
+ * Build a Responses-format adapter with injected {@link GuardrailHelpers}.
+ */
+export declare function createResponsesAdapter(helpers: GuardrailHelpers): Adapter;
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/responses/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/responses/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAC5D,OAAO,EAAE,OAAO,EAAqC,MAAM,UAAU,CAAC;AAwKtE;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,gBAAgB,GAAG,OAAO,CAiDzE"}