@databehave/admin 0.0.0-stage → 0.1.0

package/dist/admin-routes.js

@@ -0,0 +1,316 @@
+/**
+ * Admin REST + UI routes. Mounted under a configurable `basePath`
+ * (default `/databehave`).
+ *
+ *   GET    {basePath}                       — admin HTML page (UI shell)
+ *   GET    {basePath}/                      — same (trailing-slash equivalent)
+ *   GET    {basePath}/ui.js                 — admin UI script bundle
+ *   GET    {basePath}/ui.css                — admin UI stylesheet
+ *   GET    {basePath}/openapi-routes        — `{method, path, summary}[]`
+ *   GET    {basePath}/openapi.json          — raw OpenAPI document (404 when not configured)
+ *   GET    {basePath}/overrides             — list active sticky overrides
+ *   POST   {basePath}/overrides             — add a sticky override (201)
+ *   DELETE {basePath}/overrides             — clear all
+ *   DELETE {basePath}/overrides/:id         — remove by id (404 if missing)
+ *   GET    {basePath}/scenarios             — list saved scenarios
+ *   POST   {basePath}/scenarios             — save current overrides as a scenario
+ *   GET    {basePath}/scenarios/:name       — fetch a saved scenario
+ *   DELETE {basePath}/scenarios/:name       — delete a saved scenario
+ *   POST   {basePath}/scenarios/:name/load  — replace active overrides with the scenario
+ *
+ * CORS for these routes is controlled by `admin.cors`; the kit's
+ * server integration injects the resolved header bag here via
+ * {@link AdminRoutesOptions.corsHeaders}.
+ */
+import { readFile } from 'node:fs/promises';
+import { dirname, resolve } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { isValidScenarioName, validateScenario, isPlainObject, validateMatcher, validateMode, validateOverrides, validateScenarioVersion, ScenarioValidationError } from './validation.js';
+const HERE = dirname(fileURLToPath(import.meta.url));
+const UI_HTML_PATH = resolve(HERE, '../assets/ui.html');
+const UI_JS_PATH = resolve(HERE, '../assets/ui.js');
+const UI_CSS_PATH = resolve(HERE, '../assets/ui.css');
+// Cached on first read — the admin bundle is static for the process lifetime.
+// HTML is cached per basePath because the served body is templated with the
+// base so the UI bundle and the asset <script>/<link> tags know where to
+// fetch from when the UI is mounted at a non-default path.
+const uiHtmlCacheByBase = new Map();
+let uiJsCache;
+let uiCssCache;
+/**
+ * Inject the resolved `basePath` into the prebuilt UI shell HTML so
+ * the `<script>` / `<link>` tags resolve correctly when the UI is
+ * mounted at the bare base path (browsers resolve `./ui.js` against
+ * the parent of the current URL, which is wrong when the URL has no
+ * trailing slash) and so the UI bundle can read
+ * `window.__DATABEHAVE_BASE__` to build its fetch URLs.
+ */
+const templateHtml = (raw, basePath) => {
+    const baseJson = JSON.stringify(basePath);
+    return raw
+        .replace(/src="\.\/ui\.js"/g, `src="${basePath}/ui.js"`)
+        .replace(/href="\.\/ui\.css"/g, `href="${basePath}/ui.css"`)
+        .replace(/<script type="module"/, `<script>window.__DATABEHAVE_BASE__=${baseJson};</script>\n  <script type="module"`);
+};
+export const createAdminRoutes = (opts) => {
+    const { store, openapiBody } = opts;
+    const basePath = opts.basePath ?? '/databehave';
+    const ui = opts.ui !== false;
+    const corsHeaders = opts.corsHeaders ?? {};
+    if (!basePath.startsWith('/')) {
+        throw new Error(`@databehave/admin: admin.path must start with "/" (got ${JSON.stringify(basePath)})`);
+    }
+    const json = (status, body) => ({
+        status,
+        json: body,
+        headers: { ...corsHeaders },
+    });
+    const uiHandler = async () => {
+        try {
+            let html = uiHtmlCacheByBase.get(basePath);
+            if (html === undefined) {
+                const raw = await readFile(UI_HTML_PATH, 'utf8');
+                html = templateHtml(raw, basePath);
+                uiHtmlCacheByBase.set(basePath, html);
+            }
+            return { status: 200, html, headers: { ...corsHeaders } };
+            /* v8 ignore start -- ui.html ships with the package; missing only on a broken install */
+        }
+        catch (err) {
+            return json(500, {
+                error: 'failed to read ui.html',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        /* v8 ignore stop */
+    };
+    const uiJsHandler = async () => {
+        try {
+            if (uiJsCache === undefined) {
+                uiJsCache = await readFile(UI_JS_PATH, 'utf8');
+            }
+            return {
+                status: 200,
+                text: uiJsCache,
+                headers: {
+                    ...corsHeaders,
+                    'Content-Type': 'application/javascript; charset=utf-8',
+                },
+            };
+            /* v8 ignore start -- ui.js ships with the package; missing only on a broken install */
+        }
+        catch (err) {
+            return json(500, {
+                error: 'failed to read ui.js',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        /* v8 ignore stop */
+    };
+    const uiCssHandler = async () => {
+        try {
+            if (uiCssCache === undefined) {
+                uiCssCache = await readFile(UI_CSS_PATH, 'utf8');
+            }
+            return {
+                status: 200,
+                text: uiCssCache,
+                headers: {
+                    ...corsHeaders,
+                    'Content-Type': 'text/css; charset=utf-8',
+                },
+            };
+            /* v8 ignore start -- ui.css ships with the package; missing only on a broken install */
+        }
+        catch (err) {
+            return json(500, {
+                error: 'failed to read ui.css',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        /* v8 ignore stop */
+    };
+    const listRoutesHandler = () => json(200, {
+        features: { scenarios: opts.scenarios !== undefined },
+        routes: (opts.catalog?.() ?? [])
+            .filter((route) => route.path !== basePath && !route.path.startsWith(`${basePath}/`))
+            .map((route) => ({ method: route.method.toUpperCase(), path: route.path,
+            source: route.source === 'openapi' ? 'openapi' : 'handler',
+            ...(typeof route.metadata?.summary === 'string' ? { summary: route.metadata.summary } : {}),
+        })).sort((a, b) => a.path.localeCompare(b.path) || a.method.localeCompare(b.method)),
+        discoveredAt: new Date().toISOString(),
+    });
+    const openApiDocHandler = () => {
+        const document = openapiBody?.();
+        if (document === undefined) {
+            return json(404, { error: 'no openapi document configured' });
+        }
+        return {
+            status: 200,
+            text: document,
+            headers: {
+                ...corsHeaders,
+                'Content-Type': 'application/json',
+                'Cache-Control': 'no-store',
+            },
+        };
+    };
+    const listOverridesHandler = () => json(200, { overrides: store.list() });
+    const addOverrideHandler = async (req) => {
+        let body;
+        try {
+            body = await req.json();
+        }
+        catch (err) {
+            return json(400, {
+                error: 'invalid JSON body',
+                detail: err instanceof Error ? err.message : String(err),
+            });
+        }
+        if (!isPlainObject(body))
+            return json(400, { error: 'body must be a JSON object' });
+        const [matcher, mErr] = validateMatcher(body.matcher);
+        if (!matcher)
+            return json(400, { error: `matcher invalid: ${mErr}` });
+        const [mode, modeErr] = validateMode(body.mode);
+        if (!mode)
+            return json(400, { error: `mode invalid: ${modeErr}` });
+        const description = typeof body.description === 'string' ? body.description : undefined;
+        const override = store.add({
+            matcher,
+            mode,
+            ...(description !== undefined ? { description } : {}),
+        });
+        return {
+            status: 201,
+            json: { id: override.id, override },
+            headers: { ...corsHeaders },
+        };
+    };
+    const removeByIdHandler = (req) => {
+        const id = req.params.id;
+        if (!id)
+            return json(400, { error: 'missing :id' });
+        const ok = store.remove(id);
+        if (!ok)
+            return json(404, { error: 'override not found', id });
+        return json(200, { deleted: true, id });
+    };
+    const clearAllHandler = () => {
+        const n = store.clear();
+        return json(200, { cleared: n });
+    };
+    const routes = {
+        [`GET ${basePath}/openapi-routes`]: listRoutesHandler,
+        [`GET ${basePath}/openapi.json`]: openApiDocHandler,
+        [`GET ${basePath}/overrides`]: listOverridesHandler,
+        [`POST ${basePath}/overrides`]: addOverrideHandler,
+        [`DELETE ${basePath}/overrides`]: clearAllHandler,
+        [`DELETE ${basePath}/overrides/:id`]: removeByIdHandler,
+    };
+    if (ui) {
+        // Serve the HTML shell at the bare base path AND its trailing-slash
+        // variant so both `/databehave` and `/databehave/` work in a browser.
+        routes[`GET ${basePath}`] = uiHandler;
+        if (!basePath.endsWith('/')) {
+            routes[`GET ${basePath}/`] = uiHandler;
+        }
+        routes[`GET ${basePath}/ui.js`] = uiJsHandler;
+        routes[`GET ${basePath}/ui.css`] = uiCssHandler;
+    }
+    // Scenarios (snapshots persisted by the supplied store). Mounted only
+    // when a scenarios store is provided — pure REST CRUD plus a
+    // `:name/load` action that atomically replaces the active overrides.
+    const scenarios = opts.scenarios;
+    if (scenarios) {
+        const listScenariosHandler = async () => json(200, { scenarios: await scenarios.list() });
+        const getScenarioHandler = async (req) => {
+            const name = req.params.name ?? '';
+            if (!isValidScenarioName(name))
+                return json(400, { error: 'invalid scenario name' });
+            const s = await scenarios.get(name);
+            if (s === null)
+                return json(404, { error: 'scenario not found', name });
+            return json(200, validateScenario(s, name));
+        };
+        const createScenarioHandler = async (req) => {
+            let body;
+            try {
+                body = await req.json();
+            }
+            catch (err) {
+                return json(400, {
+                    error: 'invalid JSON body',
+                    detail: err instanceof Error ? err.message : String(err),
+                });
+            }
+            if (!isPlainObject(body))
+                return json(400, { error: 'body must be a JSON object' });
+            const name = typeof body.name === 'string' ? body.name : '';
+            if (!isValidScenarioName(name))
+                return json(400, {
+                    error: 'invalid scenario name (only [A-Za-z0-9_-], max 64 chars)',
+                });
+            let overrides;
+            try {
+                validateScenarioVersion(body.version);
+                overrides = validateOverrides(body.overrides === undefined ? store.list() : body.overrides);
+            }
+            catch (error) {
+                if (error instanceof ScenarioValidationError)
+                    return json(400, { error: error.message });
+                throw error;
+            }
+            const saved = validateScenario(await scenarios.save(name, overrides), name);
+            return {
+                status: 201,
+                json: saved,
+                headers: { ...corsHeaders },
+            };
+        };
+        const deleteScenarioHandler = async (req) => {
+            const name = req.params.name ?? '';
+            if (!isValidScenarioName(name))
+                return json(400, { error: 'invalid scenario name' });
+            const ok = await scenarios.remove(name);
+            if (!ok)
+                return json(404, { error: 'scenario not found', name });
+            return json(200, { deleted: true, name });
+        };
+        const loadScenarioHandler = async (req) => {
+            const name = req.params.name ?? '';
+            if (!isValidScenarioName(name))
+                return json(400, { error: 'invalid scenario name' });
+            const s = await scenarios.get(name);
+            if (s === null)
+                return json(404, { error: 'scenario not found', name });
+            const validated = validateScenario(s, name);
+            const loaded = store.replace(validated.overrides).map((override) => override.id);
+            return json(200, { loaded: loaded.length, name });
+        };
+        routes[`GET ${basePath}/scenarios`] =
+            listScenariosHandler;
+        routes[`GET ${basePath}/scenarios/:name`] =
+            getScenarioHandler;
+        routes[`POST ${basePath}/scenarios`] =
+            createScenarioHandler;
+        routes[`DELETE ${basePath}/scenarios/:name`] = deleteScenarioHandler;
+        routes[`POST ${basePath}/scenarios/:name/load`] = loadScenarioHandler;
+    }
+    for (const key of Object.keys(routes)) {
+        const handler = routes[key];
+        if (handler)
+            routes[key] = async (request) => {
+                try {
+                    return await handler(request);
+                }
+                catch (error) {
+                    if (error instanceof ScenarioValidationError)
+                        return json(400, { error: error.message });
+                    throw error;
+                }
+            };
+    }
+    return routes;
+};
+//# sourceMappingURL=admin-routes.js.map

package/dist/admin-routes.js.map

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

package/dist/admin-types.d.ts

@@ -0,0 +1,98 @@
+/**
+ * Discriminated union of every error mode the admin layer can inject.
+ *   1. `http-status`        — non-2xx → typical HTTP error
+ *   2. `business-failure`   — 2xx + `{success:false, message}`
+ *   3. `custom-body`        — arbitrary status + arbitrary JSON / text
+ *   4. `empty-body`         — empty body
+ *   5. `malformed-json`     — body is literally `{` so JSON.parse blows up
+ *   6. `delay`              — sleep `ms` then either run `then` or pass through
+ *   7. `hang`               — never resolve (FE timeout / hang detection)
+ *   8. `destroy`            — drop the socket without a response
+ */
+export type ErrorMode = {
+    kind: 'http-status';
+    status: number;
+} | {
+    kind: 'business-failure';
+    message: string;
+    extra?: Record<string, unknown>;
+} | {
+    kind: 'custom-body';
+    status?: number;
+    body: unknown;
+    contentType?: string;
+} | {
+    kind: 'empty-body';
+    status?: number;
+} | {
+    kind: 'malformed-json';
+    status?: number;
+} | {
+    kind: 'delay';
+    ms: number;
+    then?: Exclude<ErrorMode, {
+        kind: 'delay';
+    } | {
+        kind: 'hang';
+    } | {
+        kind: 'destroy';
+    }>;
+} | {
+    kind: 'hang';
+} | {
+    kind: 'destroy';
+};
+/**
+ * Resolution priority (handled by `OverridesStore.resolve`):
+ *   1. `exact`  (METHOD + path)
+ *   2. `path`   (path only, any method)
+ *   3. `global` (every route)
+ */
+export type OverrideMatcher = {
+    kind: 'exact';
+    method: string;
+    path: string;
+} | {
+    kind: 'path';
+    path: string;
+} | {
+    kind: 'global';
+    methods?: readonly string[];
+};
+/** Alias kept for parity with the legacy reference; prefer {@link OverrideMatcher}. */
+export type StickyMatcher = OverrideMatcher;
+/** A normalized override snapshot; mutation belongs to the fault-control capability. */
+export interface StickyOverride {
+    readonly id: string;
+    readonly matcher: OverrideMatcher;
+    readonly mode: ErrorMode;
+    readonly createdAt: string;
+    readonly description?: string;
+}
+/**
+ * Admin-mode CORS policy.
+ *
+ *   - `'auto'`        — `'*'` when bind is loopback-only, `'same-origin'`
+ *                       when `bind === 'any'` (defensive default for
+ *                       LAN-exposed servers).
+ *   - `'any'`         — `Access-Control-Allow-Origin: *`.
+ *   - `'same-origin'` — no CORS headers added; browser enforces same-origin.
+ *   - `{ origin }`    — explicit allowlist (string | string[]).
+ */
+export type AdminModeCors = 'auto' | 'any' | 'same-origin' | {
+    origin: string | readonly string[];
+};
+/** A persisted scenario — a named bundle of sticky overrides. */
+export interface Scenario {
+    readonly version?: 1;
+    readonly name: string;
+    readonly overrides: readonly StickyOverride[];
+    readonly created?: string;
+}
+/** Lightweight scenario summary returned by the list endpoint. */
+export interface ScenarioSummary {
+    readonly name: string;
+    readonly count: number;
+    readonly created: string;
+}
+//# sourceMappingURL=admin-types.d.ts.map

package/dist/admin-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-types.d.ts","sourceRoot":"","sources":["../src/admin-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,aAAa,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GACvC;IACE,IAAI,EAAE,kBAAkB,CAAA;IACxB,OAAO,EAAE,MAAM,CAAA;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAChC,GACD;IACE,IAAI,EAAE,aAAa,CAAA;IACnB,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,OAAO,CAAA;IACb,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,GACD;IAAE,IAAI,EAAE,YAAY,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,gBAAgB,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,GAC3C;IACE,IAAI,EAAE,OAAO,CAAA;IACb,EAAE,EAAE,MAAM,CAAA;IACV,IAAI,CAAC,EAAE,OAAO,CACZ,SAAS,EACT;QAAE,IAAI,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,SAAS,CAAA;KAAE,CAC3D,CAAA;CACF,GACD;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,SAAS,CAAA;CAAE,CAAA;AAEvB;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GACvB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/C;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAEnD,uFAAuF;AACvF,MAAM,MAAM,aAAa,GAAG,eAAe,CAAA;AAE3C,wFAAwF;AACxF,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,KAAK,GACL,aAAa,GACb;IAAE,MAAM,EAAE,MAAM,GAAG,SAAS,MAAM,EAAE,CAAA;CAAE,CAAA;AAE1C,iEAAiE;AACjE,MAAM,WAAW,QAAQ;IACvB,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC,CAAA;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAA;IAC7C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAED,kEAAkE;AAClE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;CACzB"}

package/dist/admin-types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=admin-types.js.map

package/dist/admin-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin-types.js","sourceRoot":"","sources":["../src/admin-types.ts"],"names":[],"mappings":""}

package/dist/banner.d.ts

@@ -0,0 +1,10 @@
+/**
+ * stdout notice emitted by the explicit browser-opening plugin. Splitting it out keeps the banner format unit-testable
+ * (no need to spin up a real http server just to assert a string).
+ */
+export interface AdminBannerLogger {
+    info(message: string): void;
+}
+export declare const formatAdminBanner: (host: string, port: number, path: string) => string;
+export declare const emitAdminBanner: (host: string, port: number, path: string, logger?: AdminBannerLogger) => void;
+//# sourceMappingURL=banner.d.ts.map

package/dist/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAA;CAC5B;AAED,eAAO,MAAM,iBAAiB,GAC5B,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,MAAM,MAAM,KACX,MAC0G,CAAA;AAE7G,eAAO,MAAM,eAAe,GAC1B,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,MAAM,MAAM,EACZ,SAAQ,iBAA2B,KAClC,IAEF,CAAA"}

package/dist/banner.js

@@ -0,0 +1,5 @@
+export const formatAdminBanner = (host, port, path) => `[@databehave/admin] admin panel ready at http://${host}:${port}${path} (dev mock — disable in production)`;
+export const emitAdminBanner = (host, port, path, logger = console) => {
+    logger.info(formatAdminBanner(host, port, path));
+};
+//# sourceMappingURL=banner.js.map

package/dist/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../src/banner.ts"],"names":[],"mappings":"AAQA,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAC/B,IAAY,EACZ,IAAY,EACZ,IAAY,EACJ,EAAE,CACV,mDAAmD,IAAI,IAAI,IAAI,GAAG,IAAI,qCAAqC,CAAA;AAE7G,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAY,EACZ,IAAY,EACZ,IAAY,EACZ,SAA4B,OAAO,EAC7B,EAAE;IACR,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;AAClD,CAAC,CAAA"}

package/dist/fault-plugin.d.ts

@@ -0,0 +1,29 @@
+import { type Plugin } from '@databehave/core';
+import type { ErrorMode, OverrideMatcher, StickyOverride } from './admin-types.js';
+/** Typed input for one new sticky fault. */
+export interface FaultOverrideInput {
+    readonly matcher: OverrideMatcher;
+    readonly mode: ErrorMode;
+    readonly description?: string;
+}
+/** Narrow state boundary used by admin and alternative control plugins. */
+export interface FaultControl {
+    add(input: FaultOverrideInput): StickyOverride;
+    remove(id: string): boolean;
+    list(): readonly StickyOverride[];
+    clear(): number;
+    /** Validates the entire input before a single atomic replacement. */
+    replace(input: unknown): readonly StickyOverride[];
+    /** Registration only; prevents control endpoints from injecting themselves. */
+    excludePathPrefix(path: string): void;
+}
+export declare const faultControlCapability: import("@databehave/core").Capability<FaultControl>;
+/** Per-request fault policy; sticky state is instance-local and owned by this plugin. */
+export interface FaultInjectionOptions {
+    readonly headers?: boolean;
+    readonly allowDestroy?: boolean;
+    readonly bypassPathPrefixes?: readonly string[];
+}
+/** Enable fault interception independently of the admin UI and persistence. */
+export declare const faultInjectionPlugin: (options?: FaultInjectionOptions) => Plugin;
+//# sourceMappingURL=fault-plugin.d.ts.map

package/dist/fault-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-plugin.d.ts","sourceRoot":"","sources":["../src/fault-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAE1D,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAIlF,4CAA4C;AAC5C,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAA;IACjC,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAA;IACxB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAC9B;AAED,2EAA2E;AAC3E,MAAM,WAAW,YAAY;IAC3B,GAAG,CAAC,KAAK,EAAE,kBAAkB,GAAG,cAAc,CAAA;IAC9C,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAA;IAC3B,IAAI,IAAI,SAAS,cAAc,EAAE,CAAA;IACjC,KAAK,IAAI,MAAM,CAAA;IACf,qEAAqE;IACrE,OAAO,CAAC,KAAK,EAAE,OAAO,GAAG,SAAS,cAAc,EAAE,CAAA;IAClD,+EAA+E;IAC/E,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CACtC;AAED,eAAO,MAAM,sBAAsB,qDAA0D,CAAA;AAE7F,yFAAyF;AACzF,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAA;IAC1B,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAA;IAC/B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAChD;AAED,+EAA+E;AAC/E,eAAO,MAAM,oBAAoB,GAAI,UAAS,qBAA0B,KAAG,MAuBzE,CAAA"}

package/dist/fault-plugin.js

@@ -0,0 +1,32 @@
+import { capability } from '@databehave/core';
+import { httpCapability } from '@databehave/server';
+import { createOverridesStore } from './overrides-store.js';
+import { createInjectHook } from './inject.js';
+export const faultControlCapability = capability('databehave.fault-control', 1);
+/** Enable fault interception independently of the admin UI and persistence. */
+export const faultInjectionPlugin = (options = {}) => ({
+    id: 'databehave.fault-injection', apiVersion: 1,
+    requires: [httpCapability], provides: [faultControlCapability],
+    setup(ctx) {
+        const store = createOverridesStore();
+        const bypass = [...(options.bypassPathPrefixes ?? [])];
+        let sealed = false;
+        ctx.onSeal(() => { sealed = true; });
+        ctx.provide(faultControlCapability, {
+            add: store.add, remove: store.remove, list: store.list, clear: store.clear, replace: store.replace,
+            excludePathPrefix(path) {
+                if (sealed)
+                    throw new Error('Fault exclusions are sealed');
+                bypass.push(path);
+            },
+        });
+        ctx.use(httpCapability).registerMiddleware({
+            owner: 'databehave.fault-injection', order: ctx.order, stage: 'interception',
+            handle: createInjectHook({ store, bypassPathPrefixes: bypass,
+                ...(options.headers !== undefined ? { headers: options.headers } : {}),
+                ...(options.allowDestroy !== undefined ? { allowDestroy: options.allowDestroy } : {}),
+            }),
+        });
+    },
+});
+//# sourceMappingURL=fault-plugin.js.map

package/dist/fault-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fault-plugin.js","sourceRoot":"","sources":["../src/fault-plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAe,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAEnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAA;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAA;AAqB9C,MAAM,CAAC,MAAM,sBAAsB,GAAG,UAAU,CAAe,0BAA0B,EAAE,CAAC,CAAC,CAAA;AAS7F,+EAA+E;AAC/E,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,UAAiC,EAAE,EAAU,EAAE,CAAC,CAAC;IACpF,EAAE,EAAE,4BAA4B,EAAE,UAAU,EAAE,CAAC;IAC/C,QAAQ,EAAE,CAAC,cAAc,CAAC,EAAE,QAAQ,EAAE,CAAC,sBAAsB,CAAC;IAC9D,KAAK,CAAC,GAAG;QACP,MAAM,KAAK,GAAG,oBAAoB,EAAE,CAAA;QACpC,MAAM,MAAM,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,kBAAkB,IAAI,EAAE,CAAC,CAAC,CAAA;QACtD,IAAI,MAAM,GAAG,KAAK,CAAA;QAClB,GAAG,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,MAAM,GAAG,IAAI,CAAA,CAAC,CAAC,CAAC,CAAA;QACnC,GAAG,CAAC,OAAO,CAAC,sBAAsB,EAAE;YAClC,GAAG,EAAE,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO;YAClG,iBAAiB,CAAC,IAAI;gBACpB,IAAI,MAAM;oBAAE,MAAM,IAAI,KAAK,CAAC,6BAA6B,CAAC,CAAA;gBAC1D,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YACnB,CAAC;SACF,CAAC,CAAA;QACF,GAAG,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC,kBAAkB,CAAC;YACzC,KAAK,EAAE,4BAA4B,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,KAAK,EAAE,cAAc;YAC5E,MAAM,EAAE,gBAAgB,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,MAAM;gBAC1D,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACtE,GAAG,CAAC,OAAO,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACtF,CAAC;SACH,CAAC,CAAA;IACJ,CAAC;CACF,CAAC,CAAA"}

package/dist/header-parser.d.ts

@@ -0,0 +1,14 @@
+import type { ErrorMode } from './admin-types.js';
+export type HeaderParseResult = {
+    kind: 'none';
+} | {
+    kind: 'mode';
+    mode: ErrorMode;
+} | {
+    kind: 'error';
+    message: string;
+};
+export declare const parseHeaderMode: (headers: Readonly<Record<string, string>>) => HeaderParseResult;
+/** Public alias of {@link parseHeaderMode}. */
+export declare const parseMockHeaders: (headers: Readonly<Record<string, string>>) => HeaderParseResult;
+//# sourceMappingURL=header-parser.d.ts.map

package/dist/header-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"header-parser.d.ts","sourceRoot":"","sources":["../src/header-parser.ts"],"names":[],"mappings":"AAWA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAEjD,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,GAChB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,SAAS,CAAA;CAAE,GACjC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAkJtC,eAAO,MAAM,eAAe,GAC1B,SAAS,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACxC,iBAqCF,CAAA;AAGD,+CAA+C;AAC/C,eAAO,MAAM,gBAAgB,YA1ClB,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,KACxC,iBAyC4C,CAAA"}