fetchvault 1.0.0

package/dist/core.js

@@ -0,0 +1,280 @@
+import { getCircuitBreaker } from './circuit.js';
+import { inFlight, withDeduplication } from './dedup.js';
+import { createMiddlewareError, runAfterResponseHooks, runBeforeRequestHooks } from './middleware.js';
+import { executeMockRequest } from './mock.js';
+import { calculateRetryDelay, shouldRetry, waitForRetryDelay } from './retry.js';
+import { createTimeoutSignal } from './timeout.js';
+const DEFAULT_RETRIES = 3;
+const JSON_CONTENT_TYPE = 'application/json';
+const defaultContext = {
+    circuitMap: new Map(),
+    dedupMap: inFlight
+};
+/**
+ * Creates an isolated FetchVault engine.
+ *
+ * @param context Optional per-engine circuit and dedup stores.
+ * @returns Request function that follows the FetchVault result pattern.
+ * @example
+ * const engine = createFetchVaultEngine({ circuitMap: new Map(), dedupMap: new Map() })
+ */
+export function createFetchVaultEngine(context = {}) {
+    const scoped = {
+        circuitMap: context.circuitMap ?? defaultContext.circuitMap,
+        dedupMap: context.dedupMap ?? defaultContext.dedupMap
+    };
+    return async function engine(url, options) {
+        try {
+            const normalized = normalizeOptions(url, options);
+            const execute = () => executePipeline(normalized, scoped);
+            if (normalized.deduplicate) {
+                return withDeduplication(normalized.request, execute, scoped.dedupMap);
+            }
+            return execute();
+        }
+        catch (cause) {
+            return createFailure('UNKNOWN', 'Unexpected FetchVault failure.', null, cause);
+        }
+    };
+}
+const defaultEngine = createFetchVaultEngine();
+/**
+ * Executes a resilient fetch call using FetchVault defaults.
+ *
+ * @param url Target URL.
+ * @param options Optional request configuration.
+ * @returns Discriminated result union with data or structured error.
+ * @example
+ * const result = await fetchvault<{ id: string }>('/users/1')
+ */
+export async function fetchvault(url, options) {
+    return defaultEngine(url, options);
+}
+async function executePipeline(normalized, context) {
+    const beforeResult = await runBeforePipeline(normalized.request, normalized.options.beforeRequest ?? []);
+    if ('error' in beforeResult) {
+        return beforeResult;
+    }
+    if (normalized.options.mock) {
+        return executeMockPipeline(beforeResult, normalized.options);
+    }
+    const breaker = resolveCircuitBreaker(beforeResult.url, context.circuitMap);
+    if (!breaker.canRequest()) {
+        return createFailure('CIRCUIT_OPEN', 'Circuit breaker is open. Request blocked.', null);
+    }
+    return executeNetworkPipeline(beforeResult, normalized.options, normalized.retries, breaker);
+}
+function normalizeOptions(url, options) {
+    const finalOptions = options ?? {};
+    const method = finalOptions.method ?? 'GET';
+    const headers = { ...(finalOptions.headers ?? {}) };
+    const body = serializeBody(finalOptions.body, headers);
+    return {
+        request: { url, method, headers, body },
+        options: finalOptions,
+        retries: finalOptions.retries ?? DEFAULT_RETRIES,
+        deduplicate: method === 'GET' && (finalOptions.deduplicate ?? true)
+    };
+}
+function serializeBody(body, headers) {
+    if (body === undefined || body === null) {
+        return body;
+    }
+    if (typeof body === 'string' || body instanceof FormData || body instanceof URLSearchParams) {
+        return body;
+    }
+    if (!hasContentTypeHeader(headers)) {
+        headers['Content-Type'] = JSON_CONTENT_TYPE;
+    }
+    return JSON.stringify(body);
+}
+function hasContentTypeHeader(headers) {
+    return Object.keys(headers).some((key) => key.toLowerCase() === 'content-type');
+}
+async function runBeforePipeline(request, hooks) {
+    try {
+        return await runBeforeRequestHooks(request, hooks);
+    }
+    catch (cause) {
+        return {
+            data: null,
+            error: createMiddlewareError(cause),
+            statusCode: null
+        };
+    }
+}
+async function executeMockPipeline(request, options) {
+    const mocked = await executeMockRequest(request, options.mock);
+    const validated = validateAndMap(mocked.statusCode, mocked.data, options.schema);
+    if (validated.error) {
+        return validated;
+    }
+    const afterHooked = await runAfterPipeline(mocked.statusCode, mocked.headers, validated.data, options.afterResponse ?? []);
+    return afterHooked;
+}
+function resolveCircuitBreaker(requestUrl, circuitMap) {
+    return getCircuitBreaker(circuitMap, extractBaseUrl(requestUrl));
+}
+function extractBaseUrl(requestUrl) {
+    try {
+        return new URL(requestUrl).origin;
+    }
+    catch {
+        return requestUrl;
+    }
+}
+async function executeNetworkPipeline(request, options, retries, breaker) {
+    let timeoutBundle;
+    try {
+        timeoutBundle = createTimeoutSignal(options.timeout, options.signal);
+    }
+    catch (cause) {
+        return createFailure('UNKNOWN', 'Invalid timeout configuration.', null, cause);
+    }
+    const requestWithSignal = { ...request, signal: timeoutBundle.signal };
+    try {
+        return await retryLoop(requestWithSignal, options, retries, breaker, timeoutBundle.didTimeout);
+    }
+    finally {
+        timeoutBundle.cleanup();
+    }
+}
+async function retryLoop(request, options, retries, breaker, didTimeout) {
+    for (let attempt = 1; attempt <= retries + 1; attempt += 1) {
+        const attemptResult = await performAttempt(request, options, attempt, retries, didTimeout);
+        if (isRetrySignal(attemptResult)) {
+            await waitForRetryDelay(calculateRetryDelay(attempt));
+            continue;
+        }
+        updateCircuitState(breaker, attemptResult);
+        return attemptResult;
+    }
+    return createFailure('UNKNOWN', 'Unexpected retry loop exit.', null);
+}
+async function performAttempt(request, options, attempt, retries, didTimeout) {
+    let response;
+    try {
+        response = await fetch(request.url, toFetchInit(request));
+    }
+    catch (cause) {
+        if (shouldRetry(null, attempt, retries)) {
+            return { kind: 'retry' };
+        }
+        return createNetworkFailure(cause, didTimeout());
+    }
+    return handleResponseOutcome(response, options, attempt, retries);
+}
+function isRetrySignal(value) {
+    return typeof value === 'object' && value !== null && 'kind' in value && value.kind === 'retry';
+}
+async function handleResponseOutcome(response, options, attempt, retries) {
+    if (response.status >= 500 && shouldRetry(response.status, attempt, retries)) {
+        return { kind: 'retry' };
+    }
+    if (response.status >= 400) {
+        const errorBody = await parseErrorBody(response);
+        return createFailure('HTTP_ERROR', `Request failed with status ${response.status}.`, response.status, errorBody);
+    }
+    const parsedBody = await parseSuccessBody(response);
+    if ('error' in parsedBody) {
+        return parsedBody.error;
+    }
+    const validated = validateAndMap(response.status, parsedBody.data, options.schema);
+    if (validated.error) {
+        return validated;
+    }
+    return runAfterPipeline(response.status, responseHeaders(response), validated.data, options.afterResponse ?? []);
+}
+async function parseSuccessBody(response) {
+    try {
+        return { data: await parseBody(response) };
+    }
+    catch (cause) {
+        return {
+            error: createFailure('PARSE_ERROR', 'Failed to parse successful response body.', response.status, cause)
+        };
+    }
+}
+async function parseErrorBody(response) {
+    try {
+        return await parseBody(response);
+    }
+    catch {
+        return null;
+    }
+}
+async function parseBody(response) {
+    const contentType = response.headers.get('content-type')?.toLowerCase() ?? '';
+    if (contentType.includes(JSON_CONTENT_TYPE)) {
+        return response.json();
+    }
+    return response.text();
+}
+function validateAndMap(statusCode, data, schema) {
+    if (!schema) {
+        return { data: data, error: null, statusCode };
+    }
+    try {
+        const parsed = schema.parse(data);
+        return { data: parsed, error: null, statusCode };
+    }
+    catch (cause) {
+        return createFailure('VALIDATION_ERROR', 'Schema validation failed.', statusCode, cause);
+    }
+}
+async function runAfterPipeline(statusCode, headers, data, hooks) {
+    const response = { statusCode, headers, raw: data, data };
+    try {
+        const transformed = await runAfterResponseHooks(response, hooks);
+        return { data: transformed.data, error: null, statusCode: transformed.statusCode };
+    }
+    catch (cause) {
+        return {
+            data: null,
+            error: createMiddlewareError(cause),
+            statusCode
+        };
+    }
+}
+function responseHeaders(response) {
+    const headers = {};
+    response.headers.forEach((value, key) => {
+        headers[key] = value;
+    });
+    return headers;
+}
+function toFetchInit(request) {
+    return {
+        method: request.method,
+        headers: request.headers,
+        body: request.body,
+        signal: request.signal
+    };
+}
+function createNetworkFailure(cause, timedOut) {
+    if (timedOut) {
+        return createFailure('TIMEOUT', 'Request timed out.', null, cause);
+    }
+    return createFailure('NETWORK_ERROR', 'Network request failed.', null, cause);
+}
+function updateCircuitState(breaker, result) {
+    if (result.error) {
+        const isServerOrNetwork = result.statusCode === null || result.statusCode >= 500;
+        if (isServerOrNetwork) {
+            breaker.recordFailure();
+            return;
+        }
+        breaker.recordSuccess();
+        return;
+    }
+    breaker.recordSuccess();
+}
+function createFailure(code, message, statusCode, cause) {
+    return {
+        data: null,
+        error: { code, message, cause },
+        statusCode
+    };
+}
+export default fetchvault;
+//# sourceMappingURL=core.js.map

package/dist/core.js.map

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

package/dist/dedup.d.ts

@@ -0,0 +1,29 @@
+import type { VaultRequest, VaultResult } from './types.js';
+/**
+ * Default in-flight request map used by the top-level `fetchvault` function.
+ *
+ * @example
+ * const pending = inFlight.size
+ */
+export declare const inFlight: Map<string, Promise<VaultResult<unknown>>>;
+/**
+ * Creates a deterministic request key for deduplication.
+ *
+ * @param request Normalized request payload.
+ * @returns Stable string key representing URL, method, headers, and body.
+ * @example
+ * const key = createDedupKey({ url: '/users', method: 'GET', headers: {} })
+ */
+export declare function createDedupKey(request: VaultRequest): string;
+/**
+ * Wraps request execution with GET-only deduplication semantics.
+ *
+ * @param request Normalized request payload.
+ * @param execute Function that executes the actual request.
+ * @param store Optional custom in-flight map for scoped deduplication.
+ * @returns Existing in-flight promise or a newly created one.
+ * @example
+ * const result = await withDeduplication(req, () => fetchData())
+ */
+export declare function withDeduplication<T>(request: VaultRequest, execute: () => Promise<VaultResult<T>>, store?: Map<string, Promise<VaultResult<unknown>>>): Promise<VaultResult<T>>;
+//# sourceMappingURL=dedup.d.ts.map

package/dist/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../src/dedup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,YAAY,CAAA;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,QAAQ,4CAAmD,CAAA;AAExE;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,MAAM,CAI5D;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EACjC,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,MAAM,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EACtC,KAAK,GAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC,CAAY,GAC3D,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,CAgBzB"}

package/dist/dedup.js

@@ -0,0 +1,70 @@
+/**
+ * Default in-flight request map used by the top-level `fetchvault` function.
+ *
+ * @example
+ * const pending = inFlight.size
+ */
+export const inFlight = new Map();
+/**
+ * Creates a deterministic request key for deduplication.
+ *
+ * @param request Normalized request payload.
+ * @returns Stable string key representing URL, method, headers, and body.
+ * @example
+ * const key = createDedupKey({ url: '/users', method: 'GET', headers: {} })
+ */
+export function createDedupKey(request) {
+    const headers = serializeHeaders(request.headers);
+    const body = stableSerialize(request.body);
+    return `${request.method}|${request.url}|${headers}|${body}`;
+}
+/**
+ * Wraps request execution with GET-only deduplication semantics.
+ *
+ * @param request Normalized request payload.
+ * @param execute Function that executes the actual request.
+ * @param store Optional custom in-flight map for scoped deduplication.
+ * @returns Existing in-flight promise or a newly created one.
+ * @example
+ * const result = await withDeduplication(req, () => fetchData())
+ */
+export function withDeduplication(request, execute, store = inFlight) {
+    if (request.method !== 'GET') {
+        return execute();
+    }
+    const key = createDedupKey(request);
+    const existing = store.get(key);
+    if (existing) {
+        return existing;
+    }
+    const pending = execute().finally(() => {
+        store.delete(key);
+    });
+    store.set(key, pending);
+    return pending;
+}
+function serializeHeaders(headers) {
+    const entries = Object.entries(headers)
+        .map(([key, value]) => [key.toLowerCase(), value])
+        .sort(([left], [right]) => left.localeCompare(right));
+    return entries.map(([key, value]) => `${key}:${value}`).join('&');
+}
+function stableSerialize(value) {
+    if (value === undefined) {
+        return 'undefined';
+    }
+    if (value === null || typeof value !== 'object') {
+        return JSON.stringify(value);
+    }
+    if (Array.isArray(value)) {
+        const serializedItems = value.map((item) => stableSerialize(item)).join(',');
+        return `[${serializedItems}]`;
+    }
+    const record = value;
+    const keys = Object.keys(record).sort((left, right) => left.localeCompare(right));
+    const serialized = keys
+        .map((key) => `${JSON.stringify(key)}:${stableSerialize(record[key])}`)
+        .join(',');
+    return `{${serialized}}`;
+}
+//# sourceMappingURL=dedup.js.map

package/dist/dedup.js.map

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

package/dist/index.cjs

@@ -0,0 +1,29 @@
+'use strict';
+
+const load = () => import('./index.js');
+
+const fetchvault = async (...args) => {
+  const mod = await load();
+  return mod.fetchvault(...args);
+};
+
+const createClient = (...args) => {
+  const lazyMethod = async (method, ...methodArgs) => {
+    const mod = await load();
+    const client = mod.createClient(...args);
+    return client[method](...methodArgs);
+  };
+
+  return {
+    get: (...methodArgs) => lazyMethod('get', ...methodArgs),
+    post: (...methodArgs) => lazyMethod('post', ...methodArgs),
+    put: (...methodArgs) => lazyMethod('put', ...methodArgs),
+    patch: (...methodArgs) => lazyMethod('patch', ...methodArgs),
+    delete: (...methodArgs) => lazyMethod('delete', ...methodArgs)
+  };
+};
+
+module.exports = fetchvault;
+module.exports.default = fetchvault;
+module.exports.fetchvault = fetchvault;
+module.exports.createClient = createClient;

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { default, fetchvault } from './core.js';
+export { createClient } from './client.js';
+export type { InferSchema, VaultClient, VaultClientConfig, VaultError, VaultFailure, VaultMockConfig, VaultOptions, VaultRequestHook, VaultResponseHook, VaultResult, VaultSchema, VaultSuccess } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA;AAE1C,YAAY,EACV,WAAW,EACX,WAAW,EACX,iBAAiB,EACjB,UAAU,EACV,YAAY,EACZ,eAAe,EACf,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,WAAW,EACX,WAAW,EACX,YAAY,EACb,MAAM,YAAY,CAAA"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { default, fetchvault } from './core.js';
+export { createClient } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAA"}

package/dist/middleware.d.ts

@@ -0,0 +1,31 @@
+import type { VaultError, VaultRequest, VaultRequestHook, VaultResponse, VaultResponseHook } from './types.js';
+/**
+ * Runs request hooks sequentially and returns the final request.
+ *
+ * @param request Initial request payload.
+ * @param hooks Ordered request hook list.
+ * @returns Request after all hook transformations.
+ * @example
+ * const nextReq = await runBeforeRequestHooks(req, [addAuthHeader])
+ */
+export declare function runBeforeRequestHooks(request: VaultRequest, hooks?: Array<VaultRequestHook>): Promise<VaultRequest>;
+/**
+ * Runs response hooks sequentially and returns the final response.
+ *
+ * @param response Initial response payload.
+ * @param hooks Ordered response hook list.
+ * @returns Response after all hook transformations.
+ * @example
+ * const nextRes = await runAfterResponseHooks(res, [logResponse])
+ */
+export declare function runAfterResponseHooks(response: VaultResponse, hooks?: Array<VaultResponseHook>): Promise<VaultResponse>;
+/**
+ * Converts thrown middleware exceptions into FetchVault error objects.
+ *
+ * @param cause Original thrown middleware value.
+ * @returns Normalized middleware error.
+ * @example
+ * const error = createMiddlewareError(new Error('hook failed'))
+ */
+export declare function createMiddlewareError(cause: unknown): VaultError;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,aAAa,EACb,iBAAiB,EAClB,MAAM,YAAY,CAAA;AAEnB;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,OAAO,EAAE,YAAY,EACrB,KAAK,GAAE,KAAK,CAAC,gBAAgB,CAAM,GAClC,OAAO,CAAC,YAAY,CAAC,CAOvB;AAED;;;;;;;;GAQG;AACH,wBAAsB,qBAAqB,CACzC,QAAQ,EAAE,aAAa,EACvB,KAAK,GAAE,KAAK,CAAC,iBAAiB,CAAM,GACnC,OAAO,CAAC,aAAa,CAAC,CAOxB;AAED;;;;;;;GAOG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,CAMhE"}

package/dist/middleware.js

@@ -0,0 +1,48 @@
+/**
+ * Runs request hooks sequentially and returns the final request.
+ *
+ * @param request Initial request payload.
+ * @param hooks Ordered request hook list.
+ * @returns Request after all hook transformations.
+ * @example
+ * const nextReq = await runBeforeRequestHooks(req, [addAuthHeader])
+ */
+export async function runBeforeRequestHooks(request, hooks = []) {
+    let current = request;
+    for (const hook of hooks) {
+        current = await hook(current);
+    }
+    return current;
+}
+/**
+ * Runs response hooks sequentially and returns the final response.
+ *
+ * @param response Initial response payload.
+ * @param hooks Ordered response hook list.
+ * @returns Response after all hook transformations.
+ * @example
+ * const nextRes = await runAfterResponseHooks(res, [logResponse])
+ */
+export async function runAfterResponseHooks(response, hooks = []) {
+    let current = response;
+    for (const hook of hooks) {
+        current = await hook(current);
+    }
+    return current;
+}
+/**
+ * Converts thrown middleware exceptions into FetchVault error objects.
+ *
+ * @param cause Original thrown middleware value.
+ * @returns Normalized middleware error.
+ * @example
+ * const error = createMiddlewareError(new Error('hook failed'))
+ */
+export function createMiddlewareError(cause) {
+    return {
+        code: 'MIDDLEWARE_ERROR',
+        message: 'A middleware hook threw an error.',
+        cause
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/middleware.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.js","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAQA;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,OAAqB,EACrB,QAAiC,EAAE;IAEnC,IAAI,OAAO,GAAG,OAAO,CAAA;IACrB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,QAAuB,EACvB,QAAkC,EAAE;IAEpC,IAAI,OAAO,GAAG,QAAQ,CAAA;IACtB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,OAAO,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;IAC/B,CAAC;IAED,OAAO,OAAO,CAAA;AAChB,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAc;IAClD,OAAO;QACL,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,mCAAmC;QAC5C,KAAK;KACN,CAAA;AACH,CAAC"}

package/dist/mock.d.ts

@@ -0,0 +1,30 @@
+import type { VaultMockConfig, VaultRequest, VaultResponse } from './types.js';
+/**
+ * Resolves optional mock delay into milliseconds.
+ *
+ * @param delay Delay value from mock config.
+ * @returns Delay in milliseconds.
+ * @example
+ * const delayMs = resolveMockDelay('150ms')
+ */
+export declare function resolveMockDelay(delay: string | number | undefined): number;
+/**
+ * Creates a normalized `VaultResponse` from mock data.
+ *
+ * @param config Mock configuration.
+ * @returns Normalized mock response payload.
+ * @example
+ * const response = buildMockResponse({ data: { ok: true } })
+ */
+export declare function buildMockResponse(config: VaultMockConfig): VaultResponse;
+/**
+ * Executes a mock request with optional artificial latency.
+ *
+ * @param request Request context for observability and future extensions.
+ * @param config Mock configuration.
+ * @returns Mock response after optional delay.
+ * @example
+ * const response = await executeMockRequest(req, { data: { ok: true }, delay: '200ms' })
+ */
+export declare function executeMockRequest(request: VaultRequest, config: VaultMockConfig): Promise<VaultResponse>;
+//# sourceMappingURL=mock.d.ts.map

package/dist/mock.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.d.ts","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,YAAY,CAAA;AAI9E;;;;;;;GAOG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,MAAM,CAM3E;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,eAAe,GAAG,aAAa,CAQxE;AAED;;;;;;;;GAQG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,YAAY,EACrB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,aAAa,CAAC,CAQxB"}

package/dist/mock.js

@@ -0,0 +1,56 @@
+import { parseTimeout } from './timeout.js';
+const DEFAULT_MOCK_STATUS = 200;
+/**
+ * Resolves optional mock delay into milliseconds.
+ *
+ * @param delay Delay value from mock config.
+ * @returns Delay in milliseconds.
+ * @example
+ * const delayMs = resolveMockDelay('150ms')
+ */
+export function resolveMockDelay(delay) {
+    if (delay === undefined) {
+        return 0;
+    }
+    return parseTimeout(delay);
+}
+/**
+ * Creates a normalized `VaultResponse` from mock data.
+ *
+ * @param config Mock configuration.
+ * @returns Normalized mock response payload.
+ * @example
+ * const response = buildMockResponse({ data: { ok: true } })
+ */
+export function buildMockResponse(config) {
+    const statusCode = config.status ?? DEFAULT_MOCK_STATUS;
+    return {
+        statusCode,
+        headers: {},
+        raw: config.data,
+        data: config.data
+    };
+}
+/**
+ * Executes a mock request with optional artificial latency.
+ *
+ * @param request Request context for observability and future extensions.
+ * @param config Mock configuration.
+ * @returns Mock response after optional delay.
+ * @example
+ * const response = await executeMockRequest(req, { data: { ok: true }, delay: '200ms' })
+ */
+export async function executeMockRequest(request, config) {
+    const _requestContext = request;
+    const delayMs = resolveMockDelay(config.delay);
+    if (delayMs > 0) {
+        await wait(delayMs);
+    }
+    return buildMockResponse(config);
+}
+function wait(delayMs) {
+    return new Promise((resolve) => {
+        setTimeout(resolve, delayMs);
+    });
+}
+//# sourceMappingURL=mock.js.map

package/dist/mock.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mock.js","sourceRoot":"","sources":["../src/mock.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAA;AAG3C,MAAM,mBAAmB,GAAG,GAAG,CAAA;AAE/B;;;;;;;GAOG;AACH,MAAM,UAAU,gBAAgB,CAAC,KAAkC;IACjE,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxB,OAAO,CAAC,CAAA;IACV,CAAC;IAED,OAAO,YAAY,CAAC,KAAK,CAAC,CAAA;AAC5B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,MAAuB;IACvD,MAAM,UAAU,GAAG,MAAM,CAAC,MAAM,IAAI,mBAAmB,CAAA;IACvD,OAAO;QACL,UAAU;QACV,OAAO,EAAE,EAAE;QACX,GAAG,EAAE,MAAM,CAAC,IAAI;QAChB,IAAI,EAAE,MAAM,CAAC,IAAI;KAClB,CAAA;AACH,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,OAAqB,EACrB,MAAuB;IAEvB,MAAM,eAAe,GAAG,OAAO,CAAA;IAC/B,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;IAC9C,IAAI,OAAO,GAAG,CAAC,EAAE,CAAC;QAChB,MAAM,IAAI,CAAC,OAAO,CAAC,CAAA;IACrB,CAAC;IAED,OAAO,iBAAiB,CAAC,MAAM,CAAC,CAAA;AAClC,CAAC;AAED,SAAS,IAAI,CAAC,OAAe;IAC3B,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,UAAU,CAAC,OAAO,EAAE,OAAO,CAAC,CAAA;IAC9B,CAAC,CAAC,CAAA;AACJ,CAAC"}