@databehave/admin 0.0.0-stage → 0.1.0

package/dist/header-parser.js

@@ -0,0 +1,171 @@
+/**
+ * Parse `x-mock-*` request headers into an `ErrorMode` (or surface a
+ * conflict error). One header set ↔ one ErrorMode. Multiple terminal
+ * modes (e.g. both `x-mock-status` and `x-mock-business-failure`) are
+ * rejected with `kind: 'conflict'` so the caller can return 400.
+ *
+ * Base64 inputs (`x-mock-body`, `x-mock-business-failure-extra`) use
+ * standard base64 (NOT url-safe), per the README contract.
+ */
+import { Buffer } from 'node:buffer';
+// Note: `x-mock-business-failure-b64` is an alternative to
+// `x-mock-business-failure` that accepts a base64-UTF8 message so
+// non-ASCII strings can travel through an HTTP header — Node's fetch
+// rejects non-ASCII byte values in header values.
+const TERMINAL_HEADERS = [
+    'x-mock-status',
+    'x-mock-business-failure',
+    'x-mock-business-failure-b64',
+    'x-mock-body',
+    'x-mock-empty',
+    'x-mock-malformed',
+    'x-mock-hang',
+    'x-mock-destroy',
+];
+const get = (h, name) => h[name];
+const decodeBase64Json = (raw, headerName) => {
+    let decoded;
+    try {
+        decoded = Buffer.from(raw, 'base64').toString('utf8');
+    }
+    catch (err) {
+        throw new Error(`invalid ${headerName} header: base64 decode failed (${err instanceof Error ? err.message : String(err)})`);
+    }
+    try {
+        return JSON.parse(decoded);
+    }
+    catch (err) {
+        throw new Error(`invalid ${headerName} header: JSON parse failed (${err instanceof Error ? err.message : String(err)})`);
+    }
+};
+const parseIntStrict = (raw, headerName) => {
+    const n = Number.parseInt(raw, 10);
+    if (!Number.isFinite(n)) {
+        throw new Error(`invalid ${headerName} header: not an integer (${JSON.stringify(raw)})`);
+    }
+    return n;
+};
+const parseTerminal = (h) => {
+    const present = TERMINAL_HEADERS.filter((name) => get(h, name) !== undefined);
+    if (present.length === 0)
+        return null;
+    if (present.length > 1) {
+        throw new Error(`conflicting x-mock-* headers: ${present.join(', ')} — pick exactly one terminal mode`);
+    }
+    const [only] = present;
+    switch (only) {
+        case 'x-mock-status': {
+            const status = parseIntStrict(get(h, 'x-mock-status'), 'x-mock-status');
+            return { kind: 'http-status', status };
+        }
+        case 'x-mock-business-failure':
+        case 'x-mock-business-failure-b64': {
+            let message;
+            if (only === 'x-mock-business-failure-b64') {
+                const raw = get(h, 'x-mock-business-failure-b64');
+                try {
+                    message = Buffer.from(raw, 'base64').toString('utf8');
+                }
+                catch (err) {
+                    throw new Error(`invalid x-mock-business-failure-b64 header: base64 decode failed (${err instanceof Error ? err.message : String(err)})`);
+                }
+            }
+            else {
+                message = get(h, 'x-mock-business-failure');
+            }
+            const extraRaw = get(h, 'x-mock-business-failure-extra');
+            if (extraRaw === undefined)
+                return { kind: 'business-failure', message };
+            const extra = decodeBase64Json(extraRaw, 'x-mock-business-failure-extra');
+            if (extra === null || typeof extra !== 'object' || Array.isArray(extra)) {
+                throw new Error('invalid x-mock-business-failure-extra header: decoded value must be a JSON object');
+            }
+            return {
+                kind: 'business-failure',
+                message,
+                extra: extra,
+            };
+        }
+        case 'x-mock-body': {
+            const body = decodeBase64Json(get(h, 'x-mock-body'), 'x-mock-body');
+            const statusRaw = get(h, 'x-mock-body-status');
+            const contentType = get(h, 'x-mock-body-content-type');
+            const mode = { kind: 'custom-body', body };
+            if (statusRaw !== undefined) {
+                ;
+                mode.status = parseIntStrict(statusRaw, 'x-mock-body-status');
+            }
+            if (contentType !== undefined) {
+                ;
+                mode.contentType = contentType;
+            }
+            return mode;
+        }
+        case 'x-mock-empty': {
+            const statusRaw = get(h, 'x-mock-empty-status');
+            if (statusRaw === undefined)
+                return { kind: 'empty-body' };
+            return {
+                kind: 'empty-body',
+                status: parseIntStrict(statusRaw, 'x-mock-empty-status'),
+            };
+        }
+        case 'x-mock-malformed': {
+            const statusRaw = get(h, 'x-mock-malformed-status');
+            if (statusRaw === undefined)
+                return { kind: 'malformed-json' };
+            return {
+                kind: 'malformed-json',
+                status: parseIntStrict(statusRaw, 'x-mock-malformed-status'),
+            };
+        }
+        case 'x-mock-hang':
+            return { kind: 'hang' };
+        case 'x-mock-destroy':
+            return { kind: 'destroy' };
+        /* v8 ignore next 3 -- exhaustiveness: unreachable */
+        default:
+            // exhaustiveness — unreachable.
+            return null;
+    }
+};
+export const parseHeaderMode = (headers) => {
+    try {
+        const terminal = parseTerminal(headers);
+        const delayRaw = get(headers, 'x-mock-delay');
+        if (terminal === null && delayRaw === undefined) {
+            return { kind: 'none' };
+        }
+        if (delayRaw === undefined) {
+            return { kind: 'mode', mode: terminal };
+        }
+        const ms = parseIntStrict(delayRaw, 'x-mock-delay');
+        if (ms < 0) {
+            return {
+                kind: 'error',
+                message: 'invalid x-mock-delay header: must be >= 0',
+            };
+        }
+        if (terminal === null) {
+            return { kind: 'mode', mode: { kind: 'delay', ms } };
+        }
+        if (terminal.kind === 'delay' ||
+            terminal.kind === 'hang' ||
+            terminal.kind === 'destroy') {
+            return {
+                kind: 'error',
+                message: `x-mock-delay cannot wrap kind=${terminal.kind}`,
+            };
+        }
+        return { kind: 'mode', mode: { kind: 'delay', ms, then: terminal } };
+    }
+    catch (err) {
+        return {
+            kind: 'error',
+            message: err instanceof Error ? err.message : String(err),
+        };
+    }
+};
+/** Public alias of {@link parseHeaderMode}. */
+export const parseMockHeaders = parseHeaderMode;
+//# sourceMappingURL=header-parser.js.map

package/dist/header-parser.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { adminPlugin, adminCapability } from './admin-plugin.js';
+export type { AdminOptions, AdminInfo } from './admin-plugin.js';
+export { faultInjectionPlugin, faultControlCapability } from './fault-plugin.js';
+export type { FaultInjectionOptions, FaultControl, FaultOverrideInput } from './fault-plugin.js';
+export type { ErrorMode, OverrideMatcher, StickyOverride, AdminModeCors, Scenario, ScenarioSummary } from './admin-types.js';
+export { openAdminBrowserPlugin } from './open-browser-plugin.js';
+export type { ScenariosStore } from './scenarios.js';
+export { fileScenariosStore } from './scenarios-store.js';
+export type { FileScenariosStoreOptions } from './scenarios-store.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,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAChE,YAAY,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,mBAAmB,CAAA;AAChE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAChF,YAAY,EAAE,qBAAqB,EAAE,YAAY,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAA;AAChG,YAAY,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,aAAa,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAA;AAC5H,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AACjE,YAAY,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA;AACzD,YAAY,EAAE,yBAAyB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { adminPlugin, adminCapability } from './admin-plugin.js';
+export { faultInjectionPlugin, faultControlCapability } from './fault-plugin.js';
+export { openAdminBrowserPlugin } from './open-browser-plugin.js';
+export { fileScenariosStore } from './scenarios-store.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,WAAW,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AAEhE,OAAO,EAAE,oBAAoB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAA;AAGhF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAA;AAEjE,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAA"}

package/dist/inject.d.ts

@@ -0,0 +1,35 @@
+/** Fault interception; HTTP owns cancellation and terminal transport effects. */
+import type { MockRequest, MockResponse } from '@databehave/server';
+import type { OverridesStore } from './overrides-store.js';
+import type { ErrorMode } from './admin-types.js';
+/** Header precedence, malformed input, or no applicable override. */
+export type ResolveResult = {
+    kind: 'mode';
+    mode: ErrorMode;
+    source: 'header' | 'sticky';
+} | {
+    kind: 'error';
+    message: string;
+} | {
+    kind: 'none';
+};
+/**
+ * Pure resolver: header overrides beat sticky overrides. Returns
+ * `'none'` when nothing applies and `'error'` for malformed headers.
+ */
+export declare const resolveMode: (store: Pick<OverridesStore, "resolve">, method: string, path: string, headers: Readonly<Record<string, string>>) => ResolveResult;
+/** Interception policy and fault state supplied by the fault plugin. */
+export interface InjectHookOptions {
+    readonly store: Pick<OverridesStore, 'resolve'>;
+    readonly headers?: boolean;
+    /** Paths matching any of these prefixes are passed through (no injection). */
+    readonly bypassPathPrefixes?: readonly string[];
+    /** When false, destroy mode resolves to a 503 instead of dropping the socket. */
+    readonly allowDestroy?: boolean;
+    readonly logger?: {
+        warn(message: string): void;
+        info?(message: string): void;
+    };
+}
+export declare const createInjectHook: (opts: InjectHookOptions) => (req: MockRequest) => Promise<MockResponse | void>;
+//# sourceMappingURL=inject.d.ts.map

package/dist/inject.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject.d.ts","sourceRoot":"","sources":["../src/inject.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,OAAO,KAAK,EACV,WAAW,EACX,YAAY,EACb,MAAM,oBAAoB,CAAA;AAE3B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAKjD,qEAAqE;AACrE,MAAM,MAAM,aAAa,GACrB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAC;IAAC,MAAM,EAAE,QAAQ,GAAG,QAAQ,CAAA;CAAE,GAC9D;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClC;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,CAAA;AAEpB;;;GAGG;AACH,eAAO,MAAM,WAAW,GACtB,OAAO,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,EACtC,QAAQ,MAAM,EACd,MAAM,MAAM,EACZ,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACxC,aAUF,CAAA;AAkFD,wEAAwE;AACxE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC,cAAc,EAAE,SAAS,CAAC,CAAA;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,8EAA8E;IAC9E,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/C,iFAAiF;IACjF,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;QAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;KAC7B,CAAA;CACF;AAED,eAAO,MAAM,gBAAgB,GAAI,MAAM,iBAAiB,MAUpD,KAAK,WAAW,KACf,OAAO,CAAC,YAAY,GAAG,IAAI,CAuC/B,CAAA"}

package/dist/inject.js

@@ -0,0 +1,155 @@
+import { parseHeaderMode } from './header-parser.js';
+import { terminateTransport } from '@databehave/server';
+const TAG_HEADER = 'x-mock-injected';
+/**
+ * Pure resolver: header overrides beat sticky overrides. Returns
+ * `'none'` when nothing applies and `'error'` for malformed headers.
+ */
+export const resolveMode = (store, method, path, headers) => {
+    const fromHeader = parseHeaderMode(headers);
+    if (fromHeader.kind === 'error')
+        return { kind: 'error', message: fromHeader.message };
+    if (fromHeader.kind === 'mode') {
+        return { kind: 'mode', mode: fromHeader.mode, source: 'header' };
+    }
+    const sticky = store.resolve(method, path);
+    if (sticky)
+        return { kind: 'mode', mode: sticky.mode, source: 'sticky' };
+    return { kind: 'none' };
+};
+const buildResponse = (mode, source) => {
+    const tagHeaders = {
+        [TAG_HEADER]: `${mode.kind}:${source}`,
+    };
+    switch (mode.kind) {
+        case 'http-status':
+            return {
+                status: mode.status,
+                json: { error: true, status: mode.status, injected: mode.kind },
+                headers: tagHeaders,
+            };
+        case 'business-failure':
+            return {
+                status: 200,
+                json: {
+                    success: false,
+                    message: mode.message,
+                    ...(mode.extra ?? {}),
+                },
+                headers: { ...tagHeaders, 'content-type': 'application/json' },
+            };
+        case 'custom-body': {
+            const status = mode.status ?? 200;
+            const contentType = mode.contentType ?? 'application/json';
+            if (typeof mode.body === 'string' && !contentType.includes('json')) {
+                return {
+                    status,
+                    text: mode.body,
+                    headers: { ...tagHeaders, 'content-type': contentType },
+                };
+            }
+            const payload = typeof mode.body === 'string' ? mode.body : JSON.stringify(mode.body);
+            return {
+                status,
+                raw: payload,
+                headers: { ...tagHeaders, 'content-type': contentType },
+            };
+        }
+        case 'empty-body':
+            return {
+                status: mode.status ?? 204,
+                empty: true,
+                headers: tagHeaders,
+            };
+        case 'malformed-json':
+            return {
+                status: mode.status ?? 200,
+                raw: '{',
+                headers: { ...tagHeaders, 'content-type': 'application/json' },
+            };
+        /* v8 ignore start -- defensive: delay/hang/destroy never reach here */
+        case 'delay':
+        case 'hang':
+        case 'destroy':
+            // delay/hang are handled before this function; destroy is dispatched
+            // through HTTP transport termination. Reaching here is a bug.
+            return {
+                status: 500,
+                json: {
+                    error: true,
+                    message: `inject: ${mode.kind} should be handled before buildResponse`,
+                },
+                headers: tagHeaders,
+            };
+        /* v8 ignore stop */
+    }
+};
+const buildDestroyDisabledResponse = () => ({
+    status: 503,
+    json: {
+        error: 'x-mock-destroy disabled by faultInjectionPlugin allowDestroy:false',
+    },
+    headers: { [TAG_HEADER]: 'destroy-disabled' },
+});
+export const createInjectHook = (opts) => {
+    const { store } = opts;
+    const bypass = opts.bypassPathPrefixes ?? ['/databehave'];
+    const allowDestroy = opts.allowDestroy !== false;
+    const logger = opts.logger ?? console;
+    const shouldBypass = (path) => bypass.some((p) => path === p || path.startsWith(p.endsWith('/') ? p : `${p}/`));
+    return async (req) => {
+        if (shouldBypass(req.path))
+            return undefined;
+        const resolved = resolveMode(store, req.effectiveMethod, req.path, opts.headers === false ? {} : req.headers);
+        if (resolved.kind === 'none')
+            return undefined;
+        if (resolved.kind === 'error') {
+            return {
+                status: 400,
+                json: { error: 'invalid x-mock-* header', detail: resolved.message },
+                headers: { [TAG_HEADER]: 'header-error' },
+            };
+        }
+        const { mode, source } = resolved;
+        if (mode.kind === 'hang') {
+            await waitForFault(req.signal);
+            return undefined;
+        }
+        if (mode.kind === 'destroy') {
+            if (!allowDestroy) {
+                logger.warn(`[@databehave/admin] destroy requested on ${req.method} ${req.path} ` +
+                    `(source=${source}) but faultInjectionPlugin allowDestroy:false — responding 503.`);
+                return buildDestroyDisabledResponse();
+            }
+            return terminateTransport('Fault injection requested connection destruction');
+        }
+        if (mode.kind === 'delay') {
+            await waitForFault(req.signal, mode.ms);
+            if (mode.then === undefined)
+                return undefined;
+            return buildResponse(mode.then, source);
+        }
+        return buildResponse(mode, source);
+    };
+};
+/** Wait until the delay elapses or cancel immediately when HTTP aborts the request. */
+const waitForFault = (signal, ms) => new Promise((resolve, reject) => {
+    if (signal.aborted) {
+        reject(signal.reason);
+        return;
+    }
+    let timer;
+    const abort = () => {
+        if (timer !== undefined)
+            clearTimeout(timer);
+        signal.removeEventListener('abort', abort);
+        reject(signal.reason);
+    };
+    signal.addEventListener('abort', abort, { once: true });
+    if (ms !== undefined)
+        timer = setTimeout(() => {
+            signal.removeEventListener('abort', abort);
+            resolve();
+        }, ms);
+});
+//# sourceMappingURL=inject.js.map

package/dist/inject.js.map

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

package/dist/open-browser-plugin.d.ts

@@ -0,0 +1,6 @@
+import type { Plugin } from '@databehave/core';
+/** Select an argument-based opener without a shell. */
+export declare const resolveBrowserCommand: (platform: NodeJS.Platform) => string;
+/** Explicit opt-in browser opener; application composition authorizes this local effect. */
+export declare const openAdminBrowserPlugin: () => Plugin;
+//# sourceMappingURL=open-browser-plugin.d.ts.map

package/dist/open-browser-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser-plugin.d.ts","sourceRoot":"","sources":["../src/open-browser-plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAK9C,uDAAuD;AACvD,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,CAAC,QAAQ,KAAG,MACmB,CAAA;AAErF,4FAA4F;AAC5F,eAAO,MAAM,sBAAsB,QAAO,MAqBxC,CAAA"}

package/dist/open-browser-plugin.js

@@ -0,0 +1,32 @@
+import { spawn } from 'node:child_process';
+import { listenerCapability } from '@databehave/server';
+import { adminCapability } from './admin-plugin.js';
+import { emitAdminBanner } from './banner.js';
+/** Select an argument-based opener without a shell. */
+export const resolveBrowserCommand = (platform) => platform === 'darwin' ? 'open' : platform === 'win32' ? 'explorer.exe' : 'xdg-open';
+/** Explicit opt-in browser opener; application composition authorizes this local effect. */
+export const openAdminBrowserPlugin = () => ({
+    id: 'databehave.admin.open-browser', apiVersion: 1,
+    requires: [listenerCapability, adminCapability],
+    setup() { },
+    open(ctx) {
+        const admin = ctx.use(adminCapability);
+        const address = ctx.use(listenerCapability).address;
+        if (!admin.ui || !address)
+            return;
+        const host = address.host === '0.0.0.0' || address.host === '::' ? '127.0.0.1' : address.host;
+        const urlHost = host.includes(':') ? `[${host}]` : host;
+        const url = `http://${urlHost}:${address.port}${admin.path}`;
+        emitAdminBanner(urlHost, address.port, admin.path);
+        const command = resolveBrowserCommand(process.platform);
+        const child = spawn(command, [url], { stdio: 'ignore', shell: false });
+        ctx.defer(() => { if (child.exitCode === null)
+            child.kill(); });
+        child.on('error', (error) => {
+            // eslint-disable-next-line no-console
+            console.warn(`Unable to open admin browser: ${error.message}`);
+        });
+        child.unref();
+    },
+});
+//# sourceMappingURL=open-browser-plugin.js.map

package/dist/open-browser-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"open-browser-plugin.js","sourceRoot":"","sources":["../src/open-browser-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAE1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAA;AAE7C,uDAAuD;AACvD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAyB,EAAU,EAAE,CACzE,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,UAAU,CAAA;AAErF,4FAA4F;AAC5F,MAAM,CAAC,MAAM,sBAAsB,GAAG,GAAW,EAAE,CAAC,CAAC;IACnD,EAAE,EAAE,+BAA+B,EAAE,UAAU,EAAE,CAAC;IAClD,QAAQ,EAAE,CAAC,kBAAkB,EAAE,eAAe,CAAC;IAC/C,KAAK,KAAI,CAAC;IACV,IAAI,CAAC,GAAG;QACN,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,eAAe,CAAC,CAAA;QACtC,MAAM,OAAO,GAAG,GAAG,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC,OAAO,CAAA;QACnD,IAAI,CAAC,KAAK,CAAC,EAAE,IAAI,CAAC,OAAO;YAAE,OAAM;QACjC,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAA;QAC7F,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,GAAG,CAAC,CAAC,CAAC,IAAI,CAAA;QACvD,MAAM,GAAG,GAAG,UAAU,OAAO,IAAI,OAAO,CAAC,IAAI,GAAG,KAAK,CAAC,IAAI,EAAE,CAAA;QAC5D,eAAe,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;QAClD,MAAM,OAAO,GAAG,qBAAqB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAA;QACvD,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAA;QACtE,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,KAAK,CAAC,QAAQ,KAAK,IAAI;YAAE,KAAK,CAAC,IAAI,EAAE,CAAA,CAAC,CAAC,CAAC,CAAA;QAC9D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE;YAC1B,sCAAsC;YACtC,OAAO,CAAC,IAAI,CAAC,iCAAiC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;QAChE,CAAC,CAAC,CAAA;QACF,KAAK,CAAC,KAAK,EAAE,CAAA;IACf,CAAC;CACF,CAAC,CAAA"}

package/dist/overrides-store.d.ts

@@ -0,0 +1,21 @@
+import type { ErrorMode, StickyMatcher, StickyOverride } from './admin-types.js';
+/** Optional duplicate-rule diagnostics. */
+export interface OverridesStoreLogger {
+    warn(message: string): void;
+    info?(message: string): void;
+}
+/** Instance-local state owned exclusively by the fault plugin. */
+export interface OverridesStore {
+    replace(input: unknown): readonly StickyOverride[];
+    add(input: {
+        matcher: StickyMatcher;
+        mode: ErrorMode;
+        description?: string;
+    }): StickyOverride;
+    remove(id: string): boolean;
+    list(): readonly StickyOverride[];
+    clear(): number;
+    resolve(method: string, path: string): StickyOverride | undefined;
+}
+export declare const createOverridesStore: (logger?: OverridesStoreLogger) => OverridesStore;
+//# sourceMappingURL=overrides-store.d.ts.map

package/dist/overrides-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"overrides-store.d.ts","sourceRoot":"","sources":["../src/overrides-store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,SAAS,EAAE,aAAa,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEhF,2CAA2C;AAC3C,MAAM,WAAW,oBAAoB;IACnC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;IAC3B,IAAI,CAAC,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC7B;AAED,kEAAkE;AAClE,MAAM,WAAW,cAAc;IAC7B,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,CAAA;IAClD,GAAG,CAAC,KAAK,EAAE;QACT,OAAO,EAAE,aAAa,CAAA;QACtB,IAAI,EAAE,SAAS,CAAA;QACf,WAAW,CAAC,EAAE,MAAM,CAAA;KACrB,GAAG,cAAc,CAAA;IAClB,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,IAAI,IAAI,SAAS,cAAc,EAAE,CAAA;IACjC,KAAK,IAAI,MAAM,CAAA;IACf,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,cAAc,GAAG,SAAS,CAAA;CAClE;AAED,eAAO,MAAM,oBAAoB,GAC/B,SAAQ,oBAA8B,KACrC,cAgHF,CAAA"}

package/dist/overrides-store.js

@@ -0,0 +1,114 @@
+/**
+ * In-memory sticky overrides registry. Lost on process restart by
+ * design — this tool is for ad-hoc dev sessions, not persistence.
+ *
+ * Resolution priority (first hit wins): `exact` > `path` > `global`.
+ * When two stickies live at the same priority level, the **last** one
+ * added wins (and a warning is logged) so the dev's most-recent click
+ * in the UI is always the active rule.
+ */
+import { randomUUID } from 'node:crypto';
+import { validateOverrides } from './validation.js';
+export const createOverridesStore = (logger = console) => {
+    // Insertion-ordered. `Map.values()` yields oldest → newest, so
+    // when iterating we keep track of the *last* hit per priority bucket.
+    let byId = new Map();
+    const sameMatcher = (a, b) => {
+        if (a.kind !== b.kind)
+            return false;
+        if (a.kind === 'exact' && b.kind === 'exact') {
+            return (a.method.toUpperCase() === b.method.toUpperCase() && a.path === b.path);
+        }
+        if (a.kind === 'path' && b.kind === 'path')
+            return a.path === b.path;
+        return a.kind === 'global' && b.kind === 'global';
+    };
+    const describeMatcher = (m) => {
+        if (m.kind === 'exact')
+            return `${m.method.toUpperCase()} ${m.path}`;
+        if (m.kind === 'path')
+            return `* ${m.path}`;
+        return '* (global)';
+    };
+    const add = ({ matcher, mode, description }) => {
+        // Detect same-matcher collision so the warning is informative.
+        for (const existing of byId.values()) {
+            if (sameMatcher(existing.matcher, matcher)) {
+                logger.warn(`[mock-server/overrides] duplicate matcher ${describeMatcher(matcher)} ` +
+                    `— new rule shadows ${existing.id} (last-wins). Remove the old one if unintended.`);
+            }
+        }
+        const override = {
+            id: randomUUID(),
+            matcher: matcher.kind === 'exact'
+                ? {
+                    kind: 'exact',
+                    method: matcher.method.toUpperCase(),
+                    path: matcher.path,
+                }
+                : matcher.kind === 'global' && matcher.methods && matcher.methods.length > 0
+                    ? {
+                        kind: 'global',
+                        methods: matcher.methods.map((m) => m.toUpperCase()),
+                    }
+                    : matcher.kind === 'global'
+                        ? { kind: 'global' }
+                        : matcher,
+            mode,
+            createdAt: new Date().toISOString(),
+            ...(description !== undefined ? { description } : {}),
+        };
+        byId.set(override.id, override);
+        return override;
+    };
+    const remove = (id) => byId.delete(id);
+    const list = () => [...byId.values()];
+    const clear = () => {
+        const n = byId.size;
+        byId.clear();
+        return n;
+    };
+    const resolve = (method, path) => {
+        const m = method.toUpperCase();
+        // Walk newest → oldest so the last-added rule wins per bucket.
+        const all = [...byId.values()].reverse();
+        let exactHit;
+        let pathHit;
+        let globalHit;
+        for (const o of all) {
+            if (o.matcher.kind === 'exact') {
+                if (!exactHit && o.matcher.method === m && o.matcher.path === path) {
+                    exactHit = o;
+                }
+            }
+            else if (o.matcher.kind === 'path') {
+                if (!pathHit && o.matcher.path === path)
+                    pathHit = o;
+            }
+            else {
+                if (!globalHit
+                    && (!o.matcher.methods
+                        || o.matcher.methods.length === 0
+                        || o.matcher.methods.includes(m))) {
+                    globalHit = o;
+                }
+            }
+        }
+        return exactHit ?? pathHit ?? globalHit;
+    };
+    const replace = (input) => {
+        const validated = validateOverrides(input);
+        const replacement = new Map();
+        for (const override of validated) {
+            const id = randomUUID();
+            replacement.set(id, { ...override, id,
+                matcher: override.matcher.kind === 'exact'
+                    ? { ...override.matcher, method: override.matcher.method.toUpperCase() }
+                    : override.matcher });
+        }
+        byId = replacement;
+        return list();
+    };
+    return { add, remove, list, clear, resolve, replace };
+};
+//# sourceMappingURL=overrides-store.js.map

package/dist/overrides-store.js.map

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

package/dist/resolve-cors.d.ts

@@ -0,0 +1,6 @@
+import type { AdminModeCors } from './admin-types.js';
+/** Origin-less local clients are allowed; a present Origin must be a valid HTTP origin. */
+export declare const isAdminOriginAllowed: (bind: "loopback-only" | "any", cors: AdminModeCors, origin: string | undefined, requestUrl: string) => boolean;
+/** Admin owns response sharing; allowlists reflect exactly one permitted request origin. */
+export declare const resolveAdminCors: (bind: "loopback-only" | "any", cors: AdminModeCors, requestOrigin?: string) => Record<string, string>;
+//# sourceMappingURL=resolve-cors.d.ts.map

package/dist/resolve-cors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cors.d.ts","sourceRoot":"","sources":["../src/resolve-cors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAKrD,2FAA2F;AAC3F,eAAO,MAAM,oBAAoB,GAC/B,MAAM,eAAe,GAAG,KAAK,EAAE,MAAM,aAAa,EAAE,QAAQ,MAAM,GAAG,SAAS,EAAE,YAAY,MAAM,KACjG,OASF,CAAA;AAED,4FAA4F;AAC5F,eAAO,MAAM,gBAAgB,GAC3B,MAAM,eAAe,GAAG,KAAK,EAAE,MAAM,aAAa,EAAE,sBAAkB,KACrE,MAAM,CAAC,MAAM,EAAE,MAAM,CAcvB,CAAA"}