@databehave/admin 0.0.0-stage → 0.2.0

package/dist/resolve-cors.js

@@ -0,0 +1,39 @@
+const wildcard = (bind, cors) => cors === 'any' || (cors === 'auto' && bind === 'loopback-only');
+/** Origin-less local clients are allowed; a present Origin must be a valid HTTP origin. */
+export const isAdminOriginAllowed = (bind, cors, origin, requestUrl) => {
+    if (origin === undefined)
+        return true;
+    try {
+        const parsed = new URL(origin);
+        if (!['http:', 'https:'].includes(parsed.protocol) || parsed.origin !== origin)
+            return false;
+    }
+    catch {
+        return false;
+    }
+    if (origin === new URL(requestUrl).origin || wildcard(bind, cors))
+        return true;
+    if (typeof cors === 'object')
+        return typeof cors.origin === 'string' ? cors.origin === origin : cors.origin.includes(origin);
+    return false;
+};
+/** Admin owns response sharing; allowlists reflect exactly one permitted request origin. */
+export const resolveAdminCors = (bind, cors, requestOrigin = '') => {
+    let origin;
+    if (wildcard(bind, cors))
+        origin = '*';
+    else if (typeof cors === 'object') {
+        const allowed = typeof cors.origin === 'string' ? [cors.origin] : cors.origin;
+        if (allowed.includes(requestOrigin))
+            origin = requestOrigin;
+    }
+    if (!origin)
+        return {};
+    return {
+        'access-control-allow-origin': origin,
+        'access-control-allow-methods': 'GET,POST,DELETE,OPTIONS',
+        'access-control-allow-headers': 'content-type',
+        vary: 'Origin',
+    };
+};
+//# sourceMappingURL=resolve-cors.js.map

package/dist/resolve-cors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-cors.js","sourceRoot":"","sources":["../src/resolve-cors.ts"],"names":[],"mappings":"AAEA,MAAM,QAAQ,GAAG,CAAC,IAA6B,EAAE,IAAmB,EAAW,EAAE,CAC/E,IAAI,KAAK,KAAK,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,eAAe,CAAC,CAAA;AAEjE,2FAA2F;AAC3F,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAA6B,EAAE,IAAmB,EAAE,MAA0B,EAAE,UAAkB,EACzF,EAAE;IACX,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,IAAI,CAAA;IACrC,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,MAAM,CAAC,CAAA;QAC9B,IAAI,CAAC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,MAAM,CAAC,MAAM,KAAK,MAAM;YAAE,OAAO,KAAK,CAAA;IAC9F,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAA;IAAC,CAAC;IACxB,IAAI,MAAM,KAAK,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC,MAAM,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO,IAAI,CAAA;IAC9E,IAAI,OAAO,IAAI,KAAK,QAAQ;QAAE,OAAO,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;IAC5H,OAAO,KAAK,CAAA;AACd,CAAC,CAAA;AAED,4FAA4F;AAC5F,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAC9B,IAA6B,EAAE,IAAmB,EAAE,aAAa,GAAG,EAAE,EAC9C,EAAE;IAC1B,IAAI,MAA0B,CAAA;IAC9B,IAAI,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,MAAM,GAAG,GAAG,CAAA;SACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,OAAO,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAA;QAC7E,IAAI,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAC;YAAE,MAAM,GAAG,aAAa,CAAA;IAC7D,CAAC;IACD,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAA;IACtB,OAAO;QACL,6BAA6B,EAAE,MAAM;QACrC,8BAA8B,EAAE,yBAAyB;QACzD,8BAA8B,EAAE,cAAc;QAC9C,IAAI,EAAE,QAAQ;KACf,CAAA;AACH,CAAC,CAAA"}

package/dist/scenarios-store.d.ts

@@ -0,0 +1,8 @@
+import type { ScenariosStore } from './scenarios.js';
+/** Filesystem scope explicitly chosen by application composition. */
+export interface FileScenariosStoreOptions {
+    readonly dir: string;
+}
+/** Create a file adapter without reading, writing, or acquiring resources until called. */
+export declare const fileScenariosStore: (opts: FileScenariosStoreOptions) => ScenariosStore;
+//# sourceMappingURL=scenarios-store.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios-store.d.ts","sourceRoot":"","sources":["../src/scenarios-store.ts"],"names":[],"mappings":"AAuBA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAA;AAEpD,qEAAqE;AACrE,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;CACrB;AAWD,2FAA2F;AAC3F,eAAO,MAAM,kBAAkB,GAC7B,MAAM,yBAAyB,KAC9B,cAuFF,CAAA"}

package/dist/scenarios-store.js

@@ -0,0 +1,136 @@
+/**
+ * File-backed scenarios registry.
+ *
+ * A *scenario* is a named JSON snapshot of one or more sticky
+ * overrides. Scenarios live as `<name>.json` files inside the
+ * explicitly configured directory. Names are
+ * sanitised — only `[A-Za-z0-9_-]`, max 64 chars — so they map
+ * directly to safe filenames and round-trip through HTTP path
+ * segments without escaping.
+ *
+ * The directory is opt-in: a missing dir yields an empty list rather
+ * than throwing. The first save creates the dir.
+ *
+ * Writes are atomic: write to `<name>.json.<tmp>` then rename, so a
+ * partial write never produces a half-parsed file.
+ */
+import { randomBytes } from 'node:crypto';
+import { mkdir, open, readFile, readdir, rename, stat, unlink } from 'node:fs/promises';
+import { join } from 'node:path';
+import { validateOverrides, validateScenario, isValidScenarioName, ScenarioValidationError } from './validation.js';
+const isENOENT = (err) => typeof err === 'object' && err !== null && err.code === 'ENOENT';
+const parseScenario = (text, name) => {
+    let raw;
+    try {
+        raw = JSON.parse(text);
+    }
+    catch {
+        throw new ScenarioValidationError('Malformed scenario JSON');
+    }
+    return validateScenario(raw, name);
+};
+/** Create a file adapter without reading, writing, or acquiring resources until called. */
+export const fileScenariosStore = (opts) => {
+    const { dir } = opts;
+    const filePath = (name) => join(dir, `${name}.json`);
+    const list = async () => {
+        let entries;
+        try {
+            entries = await readdir(dir);
+        }
+        catch (err) {
+            if (isENOENT(err))
+                return [];
+            throw err;
+        }
+        const out = [];
+        for (const entry of entries) {
+            if (!entry.endsWith('.json'))
+                continue;
+            const name = entry.slice(0, -5);
+            if (!isValidScenarioName(name))
+                continue;
+            try {
+                const full = join(dir, entry);
+                const [text, st] = await Promise.all([readFile(full, 'utf8'), stat(full)]);
+                const parsed = parseScenario(text, name);
+                out.push({
+                    name,
+                    count: parsed.overrides.length,
+                    created: parsed.created ?? st.mtime.toISOString(),
+                });
+            }
+            catch {
+                // skip unreadable / malformed files; the UI still works.
+            }
+        }
+        out.sort((a, b) => a.name.localeCompare(b.name));
+        return out;
+    };
+    const get = async (name) => {
+        if (!isValidScenarioName(name))
+            return null;
+        try {
+            const text = await readFile(filePath(name), 'utf8');
+            const parsed = parseScenario(text, name);
+            return parsed;
+        }
+        catch (err) {
+            if (isENOENT(err))
+                return null;
+            throw err;
+        }
+    };
+    const save = async (name, overrides) => {
+        if (!isValidScenarioName(name)) {
+            throw new Error(`@databehave/admin: invalid scenario name: ${JSON.stringify(name)}`);
+        }
+        const validated = validateOverrides(overrides);
+        const scenario = {
+            version: 1,
+            name,
+            overrides: validated,
+            created: new Date().toISOString(),
+        };
+        const serialized = JSON.stringify(scenario, null, 2);
+        await mkdir(dir, { recursive: true });
+        const final = filePath(name);
+        const tmp = `${final}.${randomBytes(6).toString('hex')}.tmp`;
+        const handle = await open(tmp, 'wx');
+        try {
+            try {
+                await handle.writeFile(serialized, 'utf8');
+            }
+            finally {
+                await handle.close();
+            }
+            await rename(tmp, final);
+        }
+        catch (error) {
+            try {
+                await unlink(tmp);
+            }
+            catch (cleanupError) {
+                if (!isENOENT(cleanupError))
+                    throw new AggregateError([error, cleanupError], 'Scenario save and temporary cleanup failed');
+            }
+            throw error;
+        }
+        return scenario;
+    };
+    const remove = async (name) => {
+        if (!isValidScenarioName(name))
+            return false;
+        try {
+            await unlink(filePath(name));
+            return true;
+        }
+        catch (err) {
+            if (isENOENT(err))
+                return false;
+            throw err;
+        }
+    };
+    return { list, get, save, remove };
+};
+//# sourceMappingURL=scenarios-store.js.map

package/dist/scenarios-store.js.map

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

package/dist/scenarios.d.ts

@@ -0,0 +1,9 @@
+import type { Scenario, ScenarioSummary, StickyOverride } from './admin-types.js';
+/** Storage-neutral persistence supplied explicitly to admin. Implementations own I/O and atomic saves. */
+export interface ScenariosStore {
+    list(): Promise<ScenarioSummary[]>;
+    get(name: string): Promise<Scenario | null>;
+    save(name: string, overrides: readonly StickyOverride[]): Promise<Scenario>;
+    remove(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=scenarios.d.ts.map

package/dist/scenarios.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scenarios.d.ts","sourceRoot":"","sources":["../src/scenarios.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjF,0GAA0G;AAC1G,MAAM,WAAW,cAAc;IAC7B,IAAI,IAAI,OAAO,CAAC,eAAe,EAAE,CAAC,CAAA;IAClC,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAA;IAC3C,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,cAAc,EAAE,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAA;IAC3E,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CACvC"}

package/dist/scenarios.js

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

package/dist/scenarios.js.map

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

package/dist/validation.d.ts

@@ -0,0 +1,17 @@
+import type { ErrorMode, OverrideMatcher, StickyOverride, Scenario } from './admin-types.js';
+export declare const isPlainObject: (v: unknown) => v is Record<string, unknown>;
+export declare const validateMode: (raw: unknown) => [ErrorMode | null, string | null];
+export declare const validateMatcher: (raw: unknown) => [OverrideMatcher | null, string | null];
+/** Invalid external scenario or override data. No state or file has changed. */
+export declare class ScenarioValidationError extends Error {
+    readonly name = "ScenarioValidationError";
+}
+/** Complete validation shared by HTTP requests, disk reads and atomic replacement. */
+export declare const validateOverrides: (raw: unknown) => readonly StickyOverride[];
+/** Versionless legacy scenarios and version 1 share the validated override format. */
+export declare const validateScenarioVersion: (version: unknown) => void;
+/** Names accepted by all scenario endpoints and the file adapter. */
+export declare const isValidScenarioName: (name: string) => boolean;
+/** Validate a complete provider or legacy disk result before it can become live state. */
+export declare const validateScenario: (raw: unknown, name: string) => Scenario;
+//# sourceMappingURL=validation.d.ts.map

package/dist/validation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.d.ts","sourceRoot":"","sources":["../src/validation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,cAAc,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAE5F,eAAO,MAAM,aAAa,GAAI,GAAG,OAAO,KAAG,CAAC,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CACZ,CAAA;AAE1D,eAAO,MAAM,YAAY,GAAI,KAAK,OAAO,KAAG,CAAC,SAAS,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAqF3E,CAAA;AAED,eAAO,MAAM,eAAe,GAC1B,KAAK,OAAO,KACX,CAAC,eAAe,GAAG,IAAI,EAAE,MAAM,GAAG,IAAI,CAkCxC,CAAA;AAED,gFAAgF;AAChF,qBAAa,uBAAwB,SAAQ,KAAK;IAChD,SAAkB,IAAI,6BAA4B;CACnD;AAED,sFAAsF;AACtF,eAAO,MAAM,iBAAiB,GAAI,KAAK,OAAO,KAAG,SAAS,cAAc,EAgBvE,CAAA;AAED,sFAAsF;AACtF,eAAO,MAAM,uBAAuB,GAAI,SAAS,OAAO,KAAG,IAI1D,CAAA;AAED,qEAAqE;AACrE,eAAO,MAAM,mBAAmB,GAAI,MAAM,MAAM,KAAG,OAA6C,CAAA;AAEhG,0FAA0F;AAC1F,eAAO,MAAM,gBAAgB,GAAI,KAAK,OAAO,EAAE,MAAM,MAAM,KAAG,QAQ7D,CAAA"}

package/dist/validation.js

@@ -0,0 +1,169 @@
+export const isPlainObject = (v) => v !== null && typeof v === 'object' && !Array.isArray(v);
+export const validateMode = (raw) => {
+    if (!isPlainObject(raw) || typeof raw.kind !== 'string') {
+        return [null, 'mode.kind must be a string'];
+    }
+    switch (raw.kind) {
+        case 'http-status':
+            if (typeof raw.status !== 'number' || !Number.isInteger(raw.status) || raw.status < 200 || raw.status > 599)
+                return [null, 'http-status.status must be number'];
+            return [{ kind: 'http-status', status: raw.status }, null];
+        case 'business-failure': {
+            if (typeof raw.message !== 'string')
+                return [null, 'business-failure.message must be string'];
+            const mode = { kind: 'business-failure', message: raw.message };
+            if (raw.extra !== undefined) {
+                if (!isPlainObject(raw.extra))
+                    return [null, 'business-failure.extra must be a plain object'];
+                mode.extra = raw.extra;
+            }
+            return [mode, null];
+        }
+        case 'custom-body': {
+            if (!('body' in raw))
+                return [null, 'custom-body.body is required'];
+            const mode = { kind: 'custom-body', body: raw.body };
+            if (raw.status !== undefined) {
+                if (typeof raw.status !== 'number' || !Number.isInteger(raw.status) || raw.status < 200 || raw.status > 599)
+                    return [null, 'custom-body.status must be number'];
+                mode.status = raw.status;
+            }
+            if (raw.contentType !== undefined) {
+                if (typeof raw.contentType !== 'string')
+                    return [null, 'custom-body.contentType must be string'];
+                mode.contentType = raw.contentType;
+            }
+            return [mode, null];
+        }
+        case 'empty-body': {
+            const mode = { kind: 'empty-body' };
+            if (raw.status !== undefined) {
+                if (typeof raw.status !== 'number' || !Number.isInteger(raw.status) || raw.status < 200 || raw.status > 599)
+                    return [null, 'empty-body.status must be number'];
+                mode.status = raw.status;
+            }
+            return [mode, null];
+        }
+        case 'malformed-json': {
+            const mode = { kind: 'malformed-json' };
+            if (raw.status !== undefined) {
+                if (typeof raw.status !== 'number' || !Number.isInteger(raw.status) || raw.status < 200 || raw.status > 599)
+                    return [null, 'malformed-json.status must be number'];
+                mode.status = raw.status;
+            }
+            return [mode, null];
+        }
+        case 'delay': {
+            if (typeof raw.ms !== 'number' || !Number.isFinite(raw.ms) || raw.ms < 0 || raw.ms > 2_147_483_647)
+                return [null, 'delay.ms must be a non-negative number'];
+            if (raw.then === undefined)
+                return [{ kind: 'delay', ms: raw.ms }, null];
+            const [inner, err] = validateMode(raw.then);
+            if (!inner)
+                return [null, `delay.then: ${err}`];
+            if (inner.kind === 'delay' ||
+                inner.kind === 'hang' ||
+                inner.kind === 'destroy') {
+                return [null, `delay.then cannot be ${inner.kind}`];
+            }
+            return [
+                {
+                    kind: 'delay',
+                    ms: raw.ms,
+                    then: inner,
+                },
+                null,
+            ];
+        }
+        case 'hang':
+            return [{ kind: 'hang' }, null];
+        case 'destroy':
+            return [{ kind: 'destroy' }, null];
+        default:
+            return [null, `unknown mode.kind: ${String(raw.kind)}`];
+    }
+};
+export const validateMatcher = (raw) => {
+    if (!isPlainObject(raw) || typeof raw.kind !== 'string') {
+        return [null, 'matcher.kind must be a string'];
+    }
+    switch (raw.kind) {
+        case 'exact':
+            if (typeof raw.method !== 'string' || !/^[A-Za-z]+$/.test(raw.method))
+                return [null, 'matcher.method must be string'];
+            if (typeof raw.path !== 'string' || !raw.path.startsWith('/'))
+                return [null, 'matcher.path must start with "/"'];
+            return [{ kind: 'exact', method: raw.method, path: raw.path }, null];
+        case 'path':
+            if (typeof raw.path !== 'string' || !raw.path.startsWith('/'))
+                return [null, 'matcher.path must start with "/"'];
+            return [{ kind: 'path', path: raw.path }, null];
+        case 'global': {
+            if (raw.methods === undefined)
+                return [{ kind: 'global' }, null];
+            if (!Array.isArray(raw.methods))
+                return [null, 'matcher.methods must be an array of strings'];
+            const methods = [];
+            for (const m of raw.methods) {
+                if (typeof m !== 'string')
+                    return [null, 'matcher.methods must be an array of strings'];
+                const trimmed = m.trim();
+                if (trimmed.length === 0)
+                    return [null, 'matcher.methods entries must be non-empty'];
+                methods.push(trimmed.toUpperCase());
+            }
+            if (methods.length === 0)
+                return [{ kind: 'global' }, null];
+            return [{ kind: 'global', methods }, null];
+        }
+        default:
+            return [null, `unknown matcher.kind: ${String(raw.kind)}`];
+    }
+};
+/** Invalid external scenario or override data. No state or file has changed. */
+export class ScenarioValidationError extends Error {
+    name = 'ScenarioValidationError';
+}
+/** Complete validation shared by HTTP requests, disk reads and atomic replacement. */
+export const validateOverrides = (raw) => {
+    if (!Array.isArray(raw))
+        throw new ScenarioValidationError('overrides must be an array');
+    return raw.map((entry, index) => {
+        if (!isPlainObject(entry))
+            throw new ScenarioValidationError(`overrides[${index}] must be an object`);
+        const [matcher, matcherError] = validateMatcher(entry.matcher);
+        const [mode, modeError] = validateMode(entry.mode);
+        if (!matcher || !mode)
+            throw new ScenarioValidationError(`overrides[${index}]: ${matcherError ?? modeError}`);
+        if (typeof entry.id !== 'string' || typeof entry.createdAt !== 'string') {
+            throw new ScenarioValidationError(`overrides[${index}] requires id and createdAt strings`);
+        }
+        if (entry.description !== undefined && typeof entry.description !== 'string') {
+            throw new ScenarioValidationError(`overrides[${index}].description must be a string`);
+        }
+        return { id: entry.id, createdAt: entry.createdAt, matcher, mode,
+            ...(entry.description !== undefined ? { description: entry.description } : {}) };
+    });
+};
+/** Versionless legacy scenarios and version 1 share the validated override format. */
+export const validateScenarioVersion = (version) => {
+    if (version !== undefined && version !== 1) {
+        throw new ScenarioValidationError(`Unsupported scenario version: ${String(version)}`);
+    }
+};
+/** Names accepted by all scenario endpoints and the file adapter. */
+export const isValidScenarioName = (name) => /^[A-Za-z0-9_-]{1,64}$/.test(name);
+/** Validate a complete provider or legacy disk result before it can become live state. */
+export const validateScenario = (raw, name) => {
+    if (!isPlainObject(raw))
+        throw new ScenarioValidationError('Scenario must be an object');
+    validateScenarioVersion(raw.version);
+    if (raw.name !== undefined && typeof raw.name !== 'string')
+        throw new ScenarioValidationError('Scenario name must be a string');
+    if (raw.created !== undefined && typeof raw.created !== 'string')
+        throw new ScenarioValidationError('Scenario created must be a string');
+    return { name, overrides: validateOverrides(raw.overrides),
+        ...(raw.created !== undefined ? { created: raw.created } : {}),
+        ...(raw.version === 1 ? { version: 1 } : {}) };
+};
+//# sourceMappingURL=validation.js.map

package/dist/validation.js.map

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

package/package.json

@@ -1,6 +1,55 @@
 {
   "name": "@databehave/admin",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
+  "version": "0.2.0",
+  "description": "Explicit fault injection and Web Components admin plugins for Databehave",
+  "type": "module",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./assets/*": "./assets/*"
+  },
+  "files": [
+    "dist",
+    "assets",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "engines": {
+    "node": "^24.22.1 || ^26.12.1"
+  },
+  "dependencies": {
+    "@databehave/core": "0.2.0",
+    "@databehave/server": "0.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^24.19.2",
+    "@vitest/coverage-v8": "4.1.12",
+    "typescript": "^6.0.3",
+    "vite": "^6.4.5",
+    "vitest": "^4.1.12"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "author": "ochairo",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/ochairo/databehave.git",
+    "directory": "packages/admin"
+  },
+  "scripts": {
+    "build:admin": "vite build --config vite.admin.config.ts && mv assets/ui-shell.html assets/ui.html",
+    "build": "pnpm build:admin && tsc -p tsconfig.build.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.build.json --noEmit && tsc -p tsconfig.ui.json --noEmit",
+    "test": "vitest run --coverage",
+    "test:no-coverage": "vitest run",
+    "clean": "rm -rf dist assets coverage"
+  }
 }