recker 1.0.2-0 → 1.0.3

package/dist/mcp/contract.js

@@ -0,0 +1,278 @@
+export class MCPContractError extends Error {
+    toolName;
+    validationType;
+    originalError;
+    constructor(toolName, validationType, originalError) {
+        super(`MCP Contract Error [${toolName}] ${validationType} validation failed: ${originalError.message}`);
+        this.toolName = toolName;
+        this.validationType = validationType;
+        this.originalError = originalError;
+        this.name = 'MCPContractError';
+    }
+}
+export function createMCPContract(mcp, contract) {
+    const proxy = {};
+    for (const [toolName, toolDef] of Object.entries(contract)) {
+        if (toolDef.stream) {
+            proxy[toolName] = async function* (args = {}) {
+                let validatedArgs = args;
+                if (toolDef.inputSchema) {
+                    try {
+                        validatedArgs = toolDef.inputSchema.parse(args);
+                    }
+                    catch (err) {
+                        throw new MCPContractError(toolName, 'input', err);
+                    }
+                }
+                const result = await mcp.tools.call(toolName, validatedArgs);
+                for (const content of result.content) {
+                    if (content.type === 'text' && content.text) {
+                        yield content.text;
+                    }
+                }
+            };
+        }
+        else {
+            proxy[toolName] = async (args = {}) => {
+                let validatedArgs = args;
+                if (toolDef.inputSchema) {
+                    try {
+                        validatedArgs = toolDef.inputSchema.parse(args);
+                    }
+                    catch (err) {
+                        throw new MCPContractError(toolName, 'input', err);
+                    }
+                }
+                const result = await mcp.tools.call(toolName, validatedArgs);
+                const textContent = result.content
+                    .filter((c) => c.type === 'text')
+                    .map((c) => c.text)
+                    .join('');
+                if (toolDef.outputSchema) {
+                    try {
+                        const parsed = JSON.parse(textContent);
+                        return toolDef.outputSchema.parse(parsed);
+                    }
+                    catch (err) {
+                        try {
+                            return toolDef.outputSchema.parse(textContent);
+                        }
+                        catch (validationErr) {
+                            throw new MCPContractError(toolName, 'output', validationErr);
+                        }
+                    }
+                }
+                return result;
+            };
+        }
+    }
+    proxy.raw = async (name, args = {}) => {
+        const toolDef = contract[name];
+        let validatedArgs = args;
+        if (toolDef?.inputSchema) {
+            try {
+                validatedArgs = toolDef.inputSchema.parse(args);
+            }
+            catch (err) {
+                throw new MCPContractError(name, 'input', err);
+            }
+        }
+        return mcp.tools.call(name, validatedArgs);
+    };
+    proxy.list = () => {
+        return Object.entries(contract).map(([name, def]) => ({
+            name,
+            description: def.description,
+            inputSchema: def.inputSchema,
+        }));
+    };
+    proxy.has = (name) => {
+        return name in contract;
+    };
+    return proxy;
+}
+export function createMCPStream(mcp, toolName, options = {}) {
+    const { inputParam = 'prompt', extraParams = {} } = options;
+    const streamFn = async function* (input) {
+        const args = { [inputParam]: input, ...extraParams };
+        const result = await mcp.tools.call(toolName, args);
+        for (const content of result.content) {
+            if (content.type === 'text' && content.text) {
+                yield content.text;
+            }
+        }
+    };
+    streamFn.text = async (input) => {
+        const chunks = [];
+        for await (const chunk of streamFn(input)) {
+            chunks.push(chunk);
+        }
+        return chunks.join('');
+    };
+    streamFn.json = async (input) => {
+        const text = await streamFn.text(input);
+        return JSON.parse(text);
+    };
+    return streamFn;
+}
+export function createMCPBatch(mcp, contract) {
+    return async (calls) => {
+        const results = await Promise.allSettled(calls.map(async ({ tool, args }) => {
+            const toolDef = contract[tool];
+            let validatedArgs = (args || {});
+            if (toolDef?.inputSchema) {
+                validatedArgs = toolDef.inputSchema.parse(args);
+            }
+            const result = await mcp.tools.call(tool, validatedArgs);
+            if (toolDef?.outputSchema) {
+                const textContent = result.content
+                    .filter((c) => c.type === 'text')
+                    .map((c) => c.text)
+                    .join('');
+                try {
+                    const parsed = JSON.parse(textContent);
+                    return toolDef.outputSchema.parse(parsed);
+                }
+                catch {
+                    return toolDef.outputSchema.parse(textContent);
+                }
+            }
+            return result;
+        }));
+        return results.map((r) => {
+            if (r.status === 'fulfilled') {
+                return { success: true, result: r.value };
+            }
+            else {
+                return { success: false, error: r.reason };
+            }
+        });
+    };
+}
+export function createMCPSSEStream(client, endpoint, options = {}) {
+    const { inputParam = 'prompt', extraParams = {}, eventType = 'message', extractData = (event) => event.data, } = options;
+    const eventTypes = Array.isArray(eventType) ? eventType : [eventType];
+    async function* streamEvents(input, callOptions) {
+        const body = { [inputParam]: input, ...extraParams };
+        const response = await client.post(endpoint, {
+            json: body,
+            signal: callOptions?.signal,
+            timeout: callOptions?.timeout,
+            headers: {
+                Accept: 'text/event-stream',
+                'Cache-Control': 'no-cache',
+            },
+        });
+        for await (const event of response.sse()) {
+            yield event;
+        }
+    }
+    async function* streamText(input, callOptions) {
+        for await (const event of streamEvents(input, callOptions)) {
+            const eventName = event.event || 'message';
+            if (!eventTypes.includes(eventName))
+                continue;
+            if (event.data === '[DONE]')
+                continue;
+            const data = extractData(event);
+            if (data !== null && data !== undefined && data !== '') {
+                yield data;
+            }
+        }
+    }
+    const fn = streamText;
+    fn.text = async (input, callOptions) => {
+        const chunks = [];
+        for await (const chunk of streamText(input, callOptions)) {
+            chunks.push(chunk);
+        }
+        return chunks.join('');
+    };
+    fn.json = async (input, callOptions) => {
+        const text = await fn.text(input, callOptions);
+        return JSON.parse(text);
+    };
+    fn.events = streamEvents;
+    return fn;
+}
+export function createValidatedSSEStream(client, endpoint, options) {
+    const { inputSchema, extraParams = {}, eventType = 'message', extractData = (event) => event.data, } = options;
+    const eventTypes = Array.isArray(eventType) ? eventType : [eventType];
+    async function* streamEvents(args, callOptions) {
+        const validatedArgs = inputSchema.parse(args);
+        const body = { ...validatedArgs, ...extraParams };
+        const response = await client.post(endpoint, {
+            json: body,
+            signal: callOptions?.signal,
+            timeout: callOptions?.timeout,
+            headers: {
+                Accept: 'text/event-stream',
+                'Cache-Control': 'no-cache',
+            },
+        });
+        for await (const event of response.sse()) {
+            yield event;
+        }
+    }
+    async function* streamText(args, callOptions) {
+        for await (const event of streamEvents(args, callOptions)) {
+            const eventName = event.event || 'message';
+            if (!eventTypes.includes(eventName))
+                continue;
+            if (event.data === '[DONE]')
+                continue;
+            const data = extractData(event);
+            if (data !== null && data !== undefined && data !== '') {
+                yield data;
+            }
+        }
+    }
+    const fn = streamText;
+    fn.text = async (args, callOptions) => {
+        const chunks = [];
+        for await (const chunk of streamText(args, callOptions)) {
+            chunks.push(chunk);
+        }
+        return chunks.join('');
+    };
+    fn.json = async (args, callOptions) => {
+        const text = await fn.text(args, callOptions);
+        return JSON.parse(text);
+    };
+    fn.events = streamEvents;
+    return fn;
+}
+export function openAIExtractor(event) {
+    if (!event.data || event.data === '[DONE]')
+        return null;
+    try {
+        const json = JSON.parse(event.data);
+        if (json.choices?.[0]?.delta?.content) {
+            return json.choices[0].delta.content;
+        }
+        if (json.choices?.[0]?.text) {
+            return json.choices[0].text;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+export function anthropicExtractor(event) {
+    if (!event.data || event.data === '[DONE]')
+        return null;
+    try {
+        const json = JSON.parse(event.data);
+        if (json.delta?.text) {
+            return json.delta.text;
+        }
+        if (json.type === 'message_delta') {
+            return null;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/mcp/types.d.ts

@@ -65,6 +65,7 @@ export interface MCPResource {
     mimeType?: string;
 }
 export interface MCPResourceContent {
+    type: 'resource';
     uri: string;
     mimeType?: string;
     text?: string;

package/dist/mcp/types.d.ts.map

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

package/dist/plugins/auth.d.ts

@@ -0,0 +1,45 @@
+import { Middleware, Plugin } from '../types/index.js';
+export interface BasicAuthOptions {
+    username: string;
+    password: string;
+}
+export declare function basicAuth(options: BasicAuthOptions): Middleware;
+export declare function basicAuthPlugin(options: BasicAuthOptions): Plugin;
+export interface BearerAuthOptions {
+    token: string | (() => string | Promise<string>);
+    type?: string;
+    headerName?: string;
+}
+export declare function bearerAuth(options: BearerAuthOptions): Middleware;
+export declare function bearerAuthPlugin(options: BearerAuthOptions): Plugin;
+export interface ApiKeyAuthOptions {
+    key: string | (() => string | Promise<string>);
+    in?: 'header' | 'query';
+    name?: string;
+}
+export declare function apiKeyAuth(options: ApiKeyAuthOptions): Middleware;
+export declare function apiKeyAuthPlugin(options: ApiKeyAuthOptions): Plugin;
+export interface DigestAuthOptions {
+    username: string;
+    password: string;
+    preemptive?: boolean;
+}
+export declare function digestAuth(options: DigestAuthOptions): Middleware;
+export declare function digestAuthPlugin(options: DigestAuthOptions): Plugin;
+export interface OAuth2Options {
+    accessToken: string | (() => string | Promise<string>);
+    tokenType?: string;
+    onTokenExpired?: () => Promise<string>;
+}
+export declare function oauth2(options: OAuth2Options): Middleware;
+export declare function oauth2Plugin(options: OAuth2Options): Plugin;
+export interface AWSSignatureV4Options {
+    accessKeyId: string;
+    secretAccessKey: string;
+    region: string;
+    service: string;
+    sessionToken?: string;
+}
+export declare function awsSignatureV4(options: AWSSignatureV4Options): Middleware;
+export declare function awsSignatureV4Plugin(options: AWSSignatureV4Options): Plugin;
+//# sourceMappingURL=auth.d.ts.map

package/dist/plugins/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/plugins/auth.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,EAAiB,MAAM,mBAAmB,CAAC;AAOtE,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAcD,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,UAAU,CAQ/D;AAKD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAIjE;AAMD,MAAM,WAAW,iBAAiB;IAIhC,KAAK,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAKjD,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAiBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAajE;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAInE;AAMD,MAAM,WAAW,iBAAiB;IAIhC,GAAG,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAM/C,EAAE,CAAC,EAAE,QAAQ,GAAG,OAAO,CAAC;IAMxB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAmBD,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CA0BjE;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAInE;AAMD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IAKjB,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAkID,wBAAgB,UAAU,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAoDjE;AAKD,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAInE;AAMD,MAAM,WAAW,aAAa;IAI5B,WAAW,EAAE,MAAM,GAAG,CAAC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC;IAKvD,SAAS,CAAC,EAAE,MAAM,CAAC;IAMnB,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAC;CACxC;AAiBD,wBAAgB,MAAM,CAAC,OAAO,EAAE,aAAa,GAAG,UAAU,CA2BzD;AAKD,wBAAgB,YAAY,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAI3D;AAMD,MAAM,WAAW,qBAAqB;IAIpC,WAAW,EAAE,MAAM,CAAC;IAKpB,eAAe,EAAE,MAAM,CAAC;IAKxB,MAAM,EAAE,MAAM,CAAC;IAKf,OAAO,EAAE,MAAM,CAAC;IAKhB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAgBD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,UAAU,CA4GzE;AAKD,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,qBAAqB,GAAG,MAAM,CAI3E"}

package/dist/plugins/auth.js

@@ -0,0 +1,268 @@
+import { createHash, randomBytes } from 'node:crypto';
+export function basicAuth(options) {
+    const credentials = Buffer.from(`${options.username}:${options.password}`).toString('base64');
+    const authHeader = `Basic ${credentials}`;
+    return async (req, next) => {
+        const newReq = req.withHeader('Authorization', authHeader);
+        return next(newReq);
+    };
+}
+export function basicAuthPlugin(options) {
+    return (client) => {
+        client.use(basicAuth(options));
+    };
+}
+export function bearerAuth(options) {
+    const type = options.type ?? 'Bearer';
+    const headerName = options.headerName ?? 'Authorization';
+    return async (req, next) => {
+        const token = typeof options.token === 'function'
+            ? await options.token()
+            : options.token;
+        const authHeader = `${type} ${token}`;
+        const newReq = req.withHeader(headerName, authHeader);
+        return next(newReq);
+    };
+}
+export function bearerAuthPlugin(options) {
+    return (client) => {
+        client.use(bearerAuth(options));
+    };
+}
+export function apiKeyAuth(options) {
+    const location = options.in ?? 'header';
+    const name = options.name ?? 'X-API-Key';
+    return async (req, next) => {
+        const key = typeof options.key === 'function'
+            ? await options.key()
+            : options.key;
+        if (location === 'header') {
+            const newReq = req.withHeader(name, key);
+            return next(newReq);
+        }
+        else {
+            const url = new URL(req.url);
+            url.searchParams.set(name, key);
+            const newReq = {
+                ...req,
+                url: url.toString(),
+            };
+            return next(newReq);
+        }
+    };
+}
+export function apiKeyAuthPlugin(options) {
+    return (client) => {
+        client.use(apiKeyAuth(options));
+    };
+}
+function parseDigestChallenge(header) {
+    if (!header.toLowerCase().startsWith('digest ')) {
+        return null;
+    }
+    const params = {};
+    const regex = /(\w+)=(?:"([^"]+)"|([^\s,]+))/g;
+    let match;
+    while ((match = regex.exec(header)) !== null) {
+        params[match[1].toLowerCase()] = match[2] || match[3];
+    }
+    if (!params.realm || !params.nonce) {
+        return null;
+    }
+    return {
+        realm: params.realm,
+        nonce: params.nonce,
+        qop: params.qop,
+        opaque: params.opaque,
+        algorithm: params.algorithm,
+        stale: params.stale === 'true',
+    };
+}
+function md5(str) {
+    return createHash('md5').update(str).digest('hex');
+}
+function sha256(str) {
+    return createHash('sha256').update(str).digest('hex');
+}
+function generateDigestHeader(method, uri, username, password, challenge, nc) {
+    const algorithm = challenge.algorithm?.toUpperCase() || 'MD5';
+    const hashFn = algorithm.includes('SHA-256') ? sha256 : md5;
+    const cnonce = randomBytes(8).toString('hex');
+    const ncStr = nc.toString(16).padStart(8, '0');
+    let ha1 = hashFn(`${username}:${challenge.realm}:${password}`);
+    if (algorithm.endsWith('-SESS')) {
+        ha1 = hashFn(`${ha1}:${challenge.nonce}:${cnonce}`);
+    }
+    const ha2 = hashFn(`${method}:${uri}`);
+    let response;
+    if (challenge.qop) {
+        response = hashFn(`${ha1}:${challenge.nonce}:${ncStr}:${cnonce}:${challenge.qop}:${ha2}`);
+    }
+    else {
+        response = hashFn(`${ha1}:${challenge.nonce}:${ha2}`);
+    }
+    const parts = [
+        `username="${username}"`,
+        `realm="${challenge.realm}"`,
+        `nonce="${challenge.nonce}"`,
+        `uri="${uri}"`,
+        `response="${response}"`,
+    ];
+    if (challenge.qop) {
+        parts.push(`qop=${challenge.qop.split(',')[0].trim()}`);
+        parts.push(`nc=${ncStr}`);
+        parts.push(`cnonce="${cnonce}"`);
+    }
+    if (challenge.opaque) {
+        parts.push(`opaque="${challenge.opaque}"`);
+    }
+    if (algorithm !== 'MD5') {
+        parts.push(`algorithm=${algorithm}`);
+    }
+    return `Digest ${parts.join(', ')}`;
+}
+export function digestAuth(options) {
+    let nc = 0;
+    let lastChallenge = null;
+    return async (req, next) => {
+        if (lastChallenge && options.preemptive) {
+            nc++;
+            const uri = new URL(req.url).pathname + new URL(req.url).search;
+            const authHeader = generateDigestHeader(req.method, uri, options.username, options.password, lastChallenge, nc);
+            const newReq = req.withHeader('Authorization', authHeader);
+            return next(newReq);
+        }
+        const response = await next(req);
+        if (response.status === 401) {
+            const wwwAuth = response.headers.get('WWW-Authenticate');
+            if (wwwAuth) {
+                const challenge = parseDigestChallenge(wwwAuth);
+                if (challenge) {
+                    lastChallenge = challenge;
+                    nc++;
+                    const uri = new URL(req.url).pathname + new URL(req.url).search;
+                    const authHeader = generateDigestHeader(req.method, uri, options.username, options.password, challenge, nc);
+                    const newReq = req.withHeader('Authorization', authHeader);
+                    return next(newReq);
+                }
+            }
+        }
+        return response;
+    };
+}
+export function digestAuthPlugin(options) {
+    return (client) => {
+        client.use(digestAuth(options));
+    };
+}
+export function oauth2(options) {
+    const tokenType = options.tokenType ?? 'Bearer';
+    return async (req, next) => {
+        const token = typeof options.accessToken === 'function'
+            ? await options.accessToken()
+            : options.accessToken;
+        const authReq = req.withHeader('Authorization', `${tokenType} ${token}`);
+        const response = await next(authReq);
+        if (response.status === 401 && options.onTokenExpired) {
+            try {
+                const newToken = await options.onTokenExpired();
+                const retryReq = req.withHeader('Authorization', `${tokenType} ${newToken}`);
+                return next(retryReq);
+            }
+            catch {
+                return response;
+            }
+        }
+        return response;
+    };
+}
+export function oauth2Plugin(options) {
+    return (client) => {
+        client.use(oauth2(options));
+    };
+}
+export function awsSignatureV4(options) {
+    return async (req, next) => {
+        const url = new URL(req.url);
+        const host = url.host;
+        const pathname = url.pathname;
+        const queryString = url.search.slice(1);
+        const now = new Date();
+        const amzDate = now.toISOString().replace(/[:-]|\.\d{3}/g, '');
+        const dateStamp = amzDate.slice(0, 8);
+        const method = req.method;
+        const canonicalUri = pathname || '/';
+        const canonicalQueryString = queryString
+            .split('&')
+            .filter(Boolean)
+            .sort()
+            .join('&');
+        let payload = '';
+        if (req.body) {
+            if (typeof req.body === 'string') {
+                payload = req.body;
+            }
+            else if (req.body instanceof ArrayBuffer) {
+                payload = Buffer.from(req.body).toString();
+            }
+        }
+        const payloadHash = sha256(payload);
+        const headers = {
+            host,
+            'x-amz-date': amzDate,
+            'x-amz-content-sha256': payloadHash,
+        };
+        if (options.sessionToken) {
+            headers['x-amz-security-token'] = options.sessionToken;
+        }
+        req.headers.forEach((value, key) => {
+            headers[key.toLowerCase()] = value;
+        });
+        const signedHeaders = Object.keys(headers).sort().join(';');
+        const canonicalHeaders = Object.keys(headers)
+            .sort()
+            .map(key => `${key}:${headers[key].trim()}\n`)
+            .join('');
+        const canonicalRequest = [
+            method,
+            canonicalUri,
+            canonicalQueryString,
+            canonicalHeaders,
+            signedHeaders,
+            payloadHash,
+        ].join('\n');
+        const algorithm = 'AWS4-HMAC-SHA256';
+        const credentialScope = `${dateStamp}/${options.region}/${options.service}/aws4_request`;
+        const stringToSign = [
+            algorithm,
+            amzDate,
+            credentialScope,
+            sha256(canonicalRequest),
+        ].join('\n');
+        const getSignatureKey = (key, dateStamp, regionName, serviceName) => {
+            const kDate = createHash('sha256').update(`AWS4${key}`).update(dateStamp).digest();
+            const kRegion = createHash('sha256').update(kDate).update(regionName).digest();
+            const kService = createHash('sha256').update(kRegion).update(serviceName).digest();
+            const kSigning = createHash('sha256').update(kService).update('aws4_request').digest();
+            return kSigning;
+        };
+        const signingKey = getSignatureKey(options.secretAccessKey, dateStamp, options.region, options.service);
+        const signature = createHash('sha256')
+            .update(signingKey)
+            .update(stringToSign)
+            .digest('hex');
+        const authorizationHeader = `${algorithm} Credential=${options.accessKeyId}/${credentialScope}, SignedHeaders=${signedHeaders}, Signature=${signature}`;
+        let newReq = req.withHeader('Authorization', authorizationHeader);
+        newReq = newReq.withHeader('x-amz-date', amzDate);
+        newReq = newReq.withHeader('x-amz-content-sha256', payloadHash);
+        if (options.sessionToken) {
+            newReq = newReq.withHeader('x-amz-security-token', options.sessionToken);
+        }
+        return next(newReq);
+    };
+}
+export function awsSignatureV4Plugin(options) {
+    return (client) => {
+        client.use(awsSignatureV4(options));
+    };
+}

package/dist/plugins/cache.d.ts

@@ -1,10 +1,16 @@
-import { CacheStorage, CacheStrategy, Plugin, ReckerRequest } from '../types/index.js';
+import { CacheStorage, CacheStrategy, Plugin, ReckerRequest, CacheEntry } from '../types/index.js';
 export interface CacheOptions {
     storage?: CacheStorage;
     strategy?: CacheStrategy;
     ttl?: number;
     methods?: string[];
     keyGenerator?: (req: ReckerRequest) => string;
+    respectCacheControl?: boolean;
+    respectVary?: boolean;
+    maxStale?: number;
+    forceRevalidate?: boolean;
 }
+declare function parseCacheControl(header: string | null): Partial<CacheEntry>;
 export declare function cache(options?: CacheOptions): Plugin;
+export { parseCacheControl };
 //# sourceMappingURL=cache.d.ts.map

package/dist/plugins/cache.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/plugins/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,EAAE,aAAa,EAAkB,MAAM,mBAAmB,CAAC;AAInH,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;CAC/C;AAED,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAgGxD"}
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../../src/plugins/cache.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAc,MAAM,EAAE,aAAa,EAAkB,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAM/H,MAAM,WAAW,YAAY;IAC3B,OAAO,CAAC,EAAE,YAAY,CAAC;IACvB,QAAQ,CAAC,EAAE,aAAa,CAAC;IACzB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,CAAC;IAU9C,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAM9B,WAAW,CAAC,EAAE,OAAO,CAAC;IAOtB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAOlB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B;AAmDD,iBAAS,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,CA6BrE;AA0OD,wBAAgB,KAAK,CAAC,OAAO,GAAE,YAAiB,GAAG,MAAM,CAuYxD;AAGD,OAAO,EAAE,iBAAiB,EAAE,CAAC"}