@rift-vs/rift-embedded 0.12.1-snapshot.104.g9a93306

package/dist/admin.d.ts

@@ -0,0 +1,134 @@
+/**
+ * `EmbeddedAdmin` (issue #10) — the embedded transport's `AdminApi` implementation, backed by
+ * `librift_ffi` calls (`NativeEngineLike`) plus a local `Map<port, Imposter>` registry, and a
+ * lazily-started loopback admin plane (`AdminBridge`, over `rift_serve_admin`) for the handful of
+ * operations with no FFI symbol.
+ *
+ * Routing is deliberately FFI-first and never conditional on flags: `createImposter` always goes
+ * through `rift_create_imposter`, never the admin plane, so `inject`/scripted stubs work with no
+ * `allowInjection` flag — that flag only gates the HTTP admin surface the plane's bridge methods hit,
+ * and FFI calls never pass through it. The registry exists because several FFI calls (`rift_recorded`,
+ * `rift_replace_stubs`, ...) are scoped to a port with no "list all imposters" or "get one imposter"
+ * symbol — those are reconstructed locally from what this instance has created/observed.
+ */
+import type { Imposter, ImpostersConfig, RecordedRequest as WireRecordedRequest, Stub } from '@rift-vs/rift/internal';
+import type { AdminApi, BuildInfo } from '@rift-vs/rift/internal';
+import type { FlowScopedOptions } from '@rift-vs/rift/internal';
+/** The subset of `NativeEngine`'s facade `EmbeddedAdmin` depends on — small enough that tests
+ * inject a FAKE returning canned FFI results, and the real `NativeEngine` satisfies it structurally
+ * as-is (see `create.ts`'s default `loadNativeEngine`). */
+export interface NativeEngineLike {
+    readonly buildInfo: string;
+    createImposter(json: string): Promise<number>;
+    replaceStubs(port: number, json: string): Promise<number>;
+    deleteImposter(port: number): Promise<number>;
+    deleteAll(): Promise<number>;
+    applyConfig(json: string): Promise<string>;
+    recorded(port: number): Promise<string>;
+    flowStateGet(port: number, flowId: string, key: string): Promise<{
+        found: boolean;
+        value?: unknown;
+    }>;
+    flowStatePut(port: number, flowId: string, key: string, valueJson: string): Promise<number>;
+    flowStateDelete(port: number, flowId: string, key: string): Promise<number>;
+    spaceAddStub(port: number, flowId: string, json: string): Promise<number>;
+    spaceListStubs(port: number, flowId: string): Promise<string>;
+    spaceDelete(port: number, flowId: string): Promise<number>;
+    spaceRecorded(port: number, flowId: string): Promise<string>;
+    /** Intercept (TLS-MITM, issue #11) — adapted by `EmbeddedInterceptBackend`, not routed through
+     * this class (there's no imposter/registry state involved). */
+    startIntercept(optionsJson: string): Promise<Record<string, unknown>>;
+    interceptAddRules(json: string): Promise<number>;
+    interceptClearRules(): Promise<number>;
+    interceptListRules(): Promise<string>;
+    interceptCaPem(): Promise<string>;
+    interceptExportTruststore(format: string, password: string, outPath: string): Promise<number>;
+    serveAdmin(optionsJson: string): Promise<Record<string, unknown>>;
+    close(): Promise<void>;
+}
+/** Starts the loopback admin plane and reports where it landed. Injectable so bridge behavior
+ * (auth, routing, "starts exactly once") is testable against a fake HTTP server instead of a real
+ * `rift_serve_admin` call. */
+export type StartAdminPlane = (native: NativeEngineLike, opts: {
+    apiKey: string;
+}) => Promise<{
+    adminUrl: string;
+}>;
+export interface EmbeddedAdminOptions {
+    native: NativeEngineLike;
+    buildInfo: BuildInfo;
+    startAdminPlane?: StartAdminPlane;
+}
+export declare class EmbeddedAdmin implements AdminApi {
+    #private;
+    readonly url: string | undefined;
+    readonly buildInfo: BuildInfo;
+    constructor(opts: EmbeddedAdminOptions);
+    /** Starts the loopback admin plane on first use (idempotent — see `#ensurePlane`) and returns its
+     * URL. Not part of `AdminApi`; called by the `Engine.adminUrl()` hook `create.ts` wires up. */
+    adminUrl(): Promise<string>;
+    /** Always FFI — never the admin plane, so `inject`/scripted stubs work unconditionally (the
+     * plane's `allowInjection` gate only applies to bridge-routed HTTP calls, never to this path). */
+    createImposter(imposter: Imposter): Promise<Imposter>;
+    listImposters(opts?: {
+        replayable?: boolean;
+    }): Promise<ImpostersConfig>;
+    getImposter(port: number, opts?: {
+        replayable?: boolean;
+        removeProxies?: boolean;
+    }): Promise<Imposter>;
+    deleteImposter(port: number): Promise<Imposter>;
+    deleteAllImposters(): Promise<void>;
+    replaceImposters(config: ImpostersConfig): Promise<ImpostersConfig>;
+    addStub(port: number, stub: Stub, index?: number): Promise<void>;
+    replaceStubs(port: number, stubs: Stub[]): Promise<void>;
+    getStub(port: number, ref: number | {
+        id: string;
+    }): Promise<Stub>;
+    updateStub(port: number, ref: number | {
+        id: string;
+    }, stub: Stub): Promise<void>;
+    deleteStub(port: number, ref: number | {
+        id: string;
+    }): Promise<void>;
+    /** `flow_id=<id>` (the only `match` entry `engine.ts`'s `fetchRecorded` ever sends) routes to
+     * `rift_space_recorded` — the FFI's own flow-scoped journal — instead of a generic filter; any
+     * OTHER `match` entries (`field=value` / `field:key=value`) are evaluated client-side via the #6
+     * evaluator, since there is no server-side `match=` filtering to delegate to here. */
+    getSavedRequests(port: number, match?: string[]): Promise<WireRecordedRequest[]>;
+    deleteSavedRequests(port: number, match?: string[]): Promise<void>;
+    deleteSavedProxyResponses(port: number): Promise<void>;
+    enableImposter(port: number): Promise<void>;
+    disableImposter(port: number): Promise<void>;
+    getScenarios(port: number, opts?: FlowScopedOptions): Promise<{
+        flowId: string;
+        scenarios: Array<{
+            name: string;
+            state: string;
+        }>;
+    }>;
+    setScenarioState(port: number, name: string, state: string, opts?: FlowScopedOptions): Promise<void>;
+    resetScenarios(port: number, opts?: FlowScopedOptions): Promise<void>;
+    addSpaceStub(port: number, flowId: string, stub: Stub): Promise<void>;
+    listSpaceStubs(port: number, flowId: string): Promise<{
+        space: string;
+        stubs: Stub[];
+    }>;
+    /** No `rift_space_*` symbol returns the full space object — bridged (see `bridge.ts`). */
+    getSpace<T = unknown>(port: number, flowId: string): Promise<T>;
+    deleteSpace(port: number, flowId: string): Promise<void>;
+    getFlowState<T = unknown>(port: number, flowId: string, key: string): Promise<T | undefined>;
+    setFlowState(port: number, flowId: string, key: string, value: unknown): Promise<void>;
+    deleteFlowState(port: number, flowId: string, key: string): Promise<void>;
+    /** Synthesized from the parsed build info + no live plane — never starts one just to answer this. */
+    config(): Promise<Record<string, unknown>>;
+    logs(opts?: {
+        startIndex?: number;
+        endIndex?: number;
+    }): Promise<unknown[]>;
+    reload(): Promise<unknown>;
+    get closed(): boolean;
+    close(): Promise<void>;
+    [Symbol.asyncDispose](): Promise<void>;
+}
+//# sourceMappingURL=admin.d.ts.map

package/dist/admin.d.ts.map

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

package/dist/admin.js

@@ -0,0 +1,310 @@
+/**
+ * `EmbeddedAdmin` (issue #10) — the embedded transport's `AdminApi` implementation, backed by
+ * `librift_ffi` calls (`NativeEngineLike`) plus a local `Map<port, Imposter>` registry, and a
+ * lazily-started loopback admin plane (`AdminBridge`, over `rift_serve_admin`) for the handful of
+ * operations with no FFI symbol.
+ *
+ * Routing is deliberately FFI-first and never conditional on flags: `createImposter` always goes
+ * through `rift_create_imposter`, never the admin plane, so `inject`/scripted stubs work with no
+ * `allowInjection` flag — that flag only gates the HTTP admin surface the plane's bridge methods hit,
+ * and FFI calls never pass through it. The registry exists because several FFI calls (`rift_recorded`,
+ * `rift_replace_stubs`, ...) are scoped to a port with no "list all imposters" or "get one imposter"
+ * symbol — those are reconstructed locally from what this instance has created/observed.
+ */
+import { randomUUID } from 'crypto';
+import { ImposterNotFound, InvalidDefinition, RiftError } from '@rift-vs/rift';
+import { toRecordedRequest } from '@rift-vs/rift/internal';
+import { evalPredicates } from '@rift-vs/rift/internal';
+import { AdminBridge } from './bridge.js';
+async function defaultStartAdminPlane(native, opts) {
+    const result = await native.serveAdmin(JSON.stringify({ host: '127.0.0.1', port: 0, apiKey: opts.apiKey }));
+    const adminUrl = result['adminUrl'];
+    if (typeof adminUrl !== 'string') {
+        throw new RiftError('embedded admin plane (rift_serve_admin) did not report an adminUrl');
+    }
+    return { adminUrl };
+}
+const FLOW_ID_PREFIX = 'flow_id=';
+/** Converts a `match=` filter string (`field=value` or `field:key=value`, e.g. `header:X-Y=z`) into
+ * an `equals` predicate, reusing the #6 evaluator (`evalPredicates`) instead of a bespoke matcher —
+ * there is no server-side `match=` filtering for the embedded transport to delegate to. */
+function matchToPredicate(entry) {
+    const eq = entry.indexOf('=');
+    if (eq === -1) {
+        throw new InvalidDefinition(`malformed match entry (expected "field=value"): ${entry}`);
+    }
+    const left = entry.slice(0, eq);
+    const value = entry.slice(eq + 1);
+    const colon = left.indexOf(':');
+    if (colon === -1) {
+        return { equals: { [left]: value } };
+    }
+    const field = left.slice(0, colon);
+    const key = left.slice(colon + 1);
+    return { equals: { [field]: { [key]: value } } };
+}
+function stripProxyStubs(stubs) {
+    return stubs.filter((s) => !(s.responses ?? []).some((r) => r.proxy !== undefined));
+}
+export class EmbeddedAdmin {
+    url = undefined;
+    #native;
+    buildInfo;
+    #startAdminPlane;
+    #registry = new Map();
+    #planePromise;
+    #closed = false;
+    constructor(opts) {
+        this.#native = opts.native;
+        this.buildInfo = opts.buildInfo;
+        this.#startAdminPlane = opts.startAdminPlane ?? defaultStartAdminPlane;
+    }
+    /** Starts the loopback admin plane on first use (idempotent — see `#ensurePlane`) and returns its
+     * URL. Not part of `AdminApi`; called by the `Engine.adminUrl()` hook `create.ts` wires up. */
+    async adminUrl() {
+        const plane = await this.#ensurePlane();
+        return plane.adminUrl;
+    }
+    // --- imposters ---------------------------------------------------------------------------------
+    /** Always FFI — never the admin plane, so `inject`/scripted stubs work unconditionally (the
+     * plane's `allowInjection` gate only applies to bridge-routed HTTP calls, never to this path). */
+    async createImposter(imposter) {
+        const port = await this.#native.createImposter(JSON.stringify(imposter));
+        const stored = { ...imposter, port };
+        this.#registry.set(port, stored);
+        return stored;
+    }
+    async listImposters(opts) {
+        const imposters = await Promise.all([...this.#registry.values()].map((imp) => this.#project(imp, opts)));
+        return { imposters };
+    }
+    async getImposter(port, opts) {
+        return this.#project(this.#requireImposter(port), opts);
+    }
+    async deleteImposter(port) {
+        const imp = this.#requireImposter(port);
+        await this.#native.deleteImposter(port);
+        this.#registry.delete(port);
+        return imp;
+    }
+    async deleteAllImposters() {
+        await this.#native.deleteAll();
+        this.#registry.clear();
+    }
+    async replaceImposters(config) {
+        const raw = await this.#native.applyConfig(JSON.stringify(config));
+        const report = JSON.parse(raw);
+        // applyConfig has ALREADY mutated native state (partial-apply is possible — that's what `failed[]`
+        // reports), so reconcile the registry with whatever natively succeeded BEFORE surfacing failures.
+        // Build the replacement map fully first, then swap it in atomically — never clear-then-repopulate
+        // in place, which would leave the registry half-updated if a later entry is malformed.
+        const next = new Map();
+        for (const imp of report.imposters) {
+            if (imp.port === undefined)
+                throw new RiftError('applyConfig returned an imposter without a port');
+            next.set(imp.port, imp);
+        }
+        this.#registry = next;
+        if (report.failed !== undefined && report.failed.length > 0) {
+            const detail = report.failed
+                .map((f) => (f.port !== undefined ? `port ${f.port}: ${f.error}` : f.error))
+                .join('; ');
+            throw new InvalidDefinition(`applyConfig rejected ${report.failed.length} imposter(s): ${detail}`);
+        }
+        return { imposters: report.imposters };
+    }
+    // --- stubs (read-modify-write over the registry, then a single native.replaceStubs) ------------
+    async addStub(port, stub, index) {
+        const imp = this.#requireImposter(port);
+        const stubs = [...(imp.stubs ?? [])];
+        if (index !== undefined)
+            stubs.splice(index, 0, stub);
+        else
+            stubs.push(stub);
+        await this.#native.replaceStubs(port, JSON.stringify(stubs));
+        imp.stubs = stubs;
+    }
+    async replaceStubs(port, stubs) {
+        const imp = this.#requireImposter(port);
+        await this.#native.replaceStubs(port, JSON.stringify(stubs));
+        imp.stubs = [...stubs]; // copy so later caller-side mutation of `stubs` can't leak into the registry
+    }
+    async getStub(port, ref) {
+        const imp = this.#requireImposter(port);
+        const stubs = imp.stubs ?? [];
+        const stub = stubs[this.#stubIndex(stubs, ref)];
+        if (stub === undefined)
+            throw new ImposterNotFound('no such stub');
+        return stub;
+    }
+    async updateStub(port, ref, stub) {
+        const imp = this.#requireImposter(port);
+        const stubs = [...(imp.stubs ?? [])];
+        stubs[this.#stubIndex(stubs, ref)] = stub;
+        await this.#native.replaceStubs(port, JSON.stringify(stubs));
+        imp.stubs = stubs;
+    }
+    async deleteStub(port, ref) {
+        const imp = this.#requireImposter(port);
+        const stubs = [...(imp.stubs ?? [])];
+        stubs.splice(this.#stubIndex(stubs, ref), 1);
+        await this.#native.replaceStubs(port, JSON.stringify(stubs));
+        imp.stubs = stubs;
+    }
+    // --- saved requests ------------------------------------------------------------------------------
+    /** `flow_id=<id>` (the only `match` entry `engine.ts`'s `fetchRecorded` ever sends) routes to
+     * `rift_space_recorded` — the FFI's own flow-scoped journal — instead of a generic filter; any
+     * OTHER `match` entries (`field=value` / `field:key=value`) are evaluated client-side via the #6
+     * evaluator, since there is no server-side `match=` filtering to delegate to here. */
+    async getSavedRequests(port, match) {
+        this.#requireImposter(port);
+        const flowEntry = match?.find((m) => m.startsWith(FLOW_ID_PREFIX));
+        const rest = (match ?? []).filter((m) => m !== flowEntry);
+        const raw = flowEntry !== undefined
+            ? await this.#native.spaceRecorded(port, flowEntry.slice(FLOW_ID_PREFIX.length))
+            : await this.#native.recorded(port);
+        const records = JSON.parse(raw);
+        if (rest.length === 0)
+            return records;
+        const predicates = rest.map(matchToPredicate);
+        return records.filter((r) => evalPredicates(predicates, toRecordedRequest(r)));
+    }
+    async deleteSavedRequests(port, match) {
+        const { bridge } = await this.#ensurePlane();
+        await bridge.deleteSavedRequests(port, match);
+    }
+    async deleteSavedProxyResponses(port) {
+        const { bridge } = await this.#ensurePlane();
+        await bridge.deleteSavedProxyResponses(port);
+    }
+    // --- enable/disable (bridge — no FFI symbol) -----------------------------------------------------
+    async enableImposter(port) {
+        const { bridge } = await this.#ensurePlane();
+        await bridge.enableImposter(port);
+    }
+    async disableImposter(port) {
+        const { bridge } = await this.#ensurePlane();
+        await bridge.disableImposter(port);
+    }
+    // --- scenarios (bridge — no FFI symbol) ------------------------------------------------------------
+    async getScenarios(port, opts) {
+        const { bridge } = await this.#ensurePlane();
+        return bridge.getScenarios(port, opts);
+    }
+    async setScenarioState(port, name, state, opts) {
+        const { bridge } = await this.#ensurePlane();
+        await bridge.setScenarioState(port, name, state, opts);
+    }
+    async resetScenarios(port, opts) {
+        const { bridge } = await this.#ensurePlane();
+        await bridge.resetScenarios(port, opts);
+    }
+    // --- spaces ---------------------------------------------------------------------------------------
+    async addSpaceStub(port, flowId, stub) {
+        await this.#native.spaceAddStub(port, flowId, JSON.stringify(stub));
+    }
+    async listSpaceStubs(port, flowId) {
+        const raw = await this.#native.spaceListStubs(port, flowId);
+        return JSON.parse(raw);
+    }
+    /** No `rift_space_*` symbol returns the full space object — bridged (see `bridge.ts`). */
+    async getSpace(port, flowId) {
+        const { bridge } = await this.#ensurePlane();
+        return bridge.getSpace(port, flowId);
+    }
+    async deleteSpace(port, flowId) {
+        await this.#native.spaceDelete(port, flowId);
+    }
+    // --- flow state -------------------------------------------------------------------------------------
+    async getFlowState(port, flowId, key) {
+        const result = await this.#native.flowStateGet(port, flowId, key);
+        return result.found ? result.value : undefined;
+    }
+    async setFlowState(port, flowId, key, value) {
+        await this.#native.flowStatePut(port, flowId, key, JSON.stringify(value));
+    }
+    async deleteFlowState(port, flowId, key) {
+        await this.#native.flowStateDelete(port, flowId, key);
+    }
+    // --- admin ------------------------------------------------------------------------------------------
+    /** Synthesized from the parsed build info + no live plane — never starts one just to answer this. */
+    async config() {
+        return {
+            options: {
+                version: this.buildInfo.version,
+                commit: this.buildInfo.commit,
+                builtAt: this.buildInfo.builtAt,
+            },
+            features: this.buildInfo.features,
+        };
+    }
+    async logs(opts) {
+        const { bridge } = await this.#ensurePlane();
+        return bridge.logs(opts);
+    }
+    async reload() {
+        const { bridge } = await this.#ensurePlane();
+        return bridge.reload();
+    }
+    // --- disposal -----------------------------------------------------------------------------------------
+    get closed() {
+        return this.#closed;
+    }
+    async close() {
+        if (this.#closed)
+            return;
+        this.#closed = true;
+        // native.close() MUST run even if the plane failed to start or its teardown throws — otherwise
+        // the FFI handle / worker thread leaks and, since #closed is already set, can never be retried.
+        try {
+            if (this.#planePromise !== undefined) {
+                const plane = await this.#planePromise.catch(() => undefined);
+                await plane?.bridge.close();
+            }
+        }
+        finally {
+            await this.#native.close();
+        }
+    }
+    async [Symbol.asyncDispose]() {
+        await this.close();
+    }
+    // --- internals -------------------------------------------------------------------------------------------
+    #requireImposter(port) {
+        const imp = this.#registry.get(port);
+        if (imp === undefined)
+            throw new ImposterNotFound(`no imposter on port ${port}`);
+        return imp;
+    }
+    #stubIndex(stubs, ref) {
+        const index = typeof ref === 'number' ? ref : stubs.findIndex((s) => s.id === ref.id);
+        if (index < 0 || index >= stubs.length)
+            throw new ImposterNotFound('no such stub');
+        return index;
+    }
+    async #project(imp, opts) {
+        const stubs = opts?.removeProxies === true && imp.stubs !== undefined ? stripProxyStubs(imp.stubs) : imp.stubs;
+        const base = { ...imp, stubs };
+        if (opts?.replayable === true)
+            return base;
+        const raw = await this.#native.recorded(imp.port);
+        const numberOfRequests = JSON.parse(raw).length;
+        return { ...base, numberOfRequests };
+    }
+    /** Starts the loopback admin plane at most once: the promise is assigned synchronously (before
+     * any `await`), so concurrent first-uses — even two bridge calls issued without an `await`
+     * between them — observe the same in-flight promise instead of racing two `rift_serve_admin`
+     * calls. An `EmbeddedAdmin` that never calls a bridge method never starts the plane at all. */
+    #ensurePlane() {
+        if (this.#planePromise === undefined) {
+            this.#planePromise = this.#startPlane();
+        }
+        return this.#planePromise;
+    }
+    async #startPlane() {
+        const apiKey = randomUUID();
+        const { adminUrl } = await this.#startAdminPlane(this.#native, { apiKey });
+        return { bridge: new AdminBridge({ adminUrl, apiKey }), adminUrl };
+    }
+}
+//# sourceMappingURL=admin.js.map

package/dist/admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"admin.js","sourceRoot":"","sources":["../src/admin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AAUpC,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC/E,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAwC1C,KAAK,UAAU,sBAAsB,CACnC,MAAwB,EACxB,IAAwB;IAExB,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IAC5G,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;IACpC,IAAI,OAAO,QAAQ,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,IAAI,SAAS,CAAC,oEAAoE,CAAC,CAAC;IAC5F,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,CAAC;AACtB,CAAC;AAaD,MAAM,cAAc,GAAG,UAAU,CAAC;AAElC;;2FAE2F;AAC3F,SAAS,gBAAgB,CAAC,KAAa;IACrC,MAAM,EAAE,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC9B,IAAI,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,iBAAiB,CAAC,mDAAmD,KAAK,EAAE,CAAC,CAAC;IAC1F,CAAC;IACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAChC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IAClC,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAChC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;QACjB,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,EAAe,CAAC;IACpD,CAAC;IACD,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAClC,OAAO,EAAE,MAAM,EAAE,EAAE,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,KAAK,EAAE,EAAE,EAAe,CAAC;AAChE,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,OAAO,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC;AACtF,CAAC;AAED,MAAM,OAAO,aAAa;IACf,GAAG,GAAuB,SAAS,CAAC;IAE7C,OAAO,CAAmB;IACjB,SAAS,CAAY;IAC9B,gBAAgB,CAAkB;IAClC,SAAS,GAAG,IAAI,GAAG,EAAoB,CAAC;IACxC,aAAa,CAA6B;IAC1C,OAAO,GAAG,KAAK,CAAC;IAEhB,YAAY,IAA0B;QACpC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,MAAM,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,gBAAgB,GAAG,IAAI,CAAC,eAAe,IAAI,sBAAsB,CAAC;IACzE,CAAC;IAED;mGAC+F;IAC/F,KAAK,CAAC,QAAQ;QACZ,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC,QAAQ,CAAC;IACxB,CAAC;IAED,kGAAkG;IAElG;sGACkG;IAClG,KAAK,CAAC,cAAc,CAAC,QAAkB;QACrC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;QACzE,MAAM,MAAM,GAAa,EAAE,GAAG,QAAQ,EAAE,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QACjC,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,IAA+B;QACjD,MAAM,SAAS,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC;QACzG,OAAO,EAAE,SAAS,EAAE,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,WAAW,CACf,IAAY,EACZ,IAAwD;QAExD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,EAAE,IAAI,CAAC,CAAC;IAC1D,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC5B,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,kBAAkB;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,EAAE,CAAC;QAC/B,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,MAAuB;QAC5C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC;QACnE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAG5B,CAAC;QACF,mGAAmG;QACnG,kGAAkG;QAClG,kGAAkG;QAClG,uFAAuF;QACvF,MAAM,IAAI,GAAG,IAAI,GAAG,EAAoB,CAAC;QACzC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;YACnC,IAAI,GAAG,CAAC,IAAI,KAAK,SAAS;gBAAE,MAAM,IAAI,SAAS,CAAC,iDAAiD,CAAC,CAAC;YACnG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAC1B,CAAC;QACD,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC;QACtB,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5D,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM;iBACzB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,IAAI,KAAK,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;iBAC3E,IAAI,CAAC,IAAI,CAAC,CAAC;YACd,MAAM,IAAI,iBAAiB,CAAC,wBAAwB,MAAM,CAAC,MAAM,CAAC,MAAM,iBAAiB,MAAM,EAAE,CAAC,CAAC;QACrG,CAAC;QACD,OAAO,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC;IACzC,CAAC;IAED,kGAAkG;IAElG,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,IAAU,EAAE,KAAc;QACpD,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACrC,IAAI,KAAK,KAAK,SAAS;YAAE,KAAK,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;;YACjD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACtB,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,KAAa;QAC5C,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,GAAG,CAAC,KAAK,GAAG,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,6EAA6E;IACvG,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAY,EAAE,GAA4B;QACtD,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC;QAC9B,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACnE,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,GAA4B,EAAE,IAAU;QACrE,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC;QAC1C,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,IAAY,EAAE,GAA4B;QACzD,MAAM,GAAG,GAAG,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,KAAK,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,CAAC;QACrC,KAAK,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;QAC7D,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;IACpB,CAAC;IAED,oGAAoG;IAEpG;;;0FAGsF;IACtF,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,KAAgB;QACnD,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,SAAS,GAAG,KAAK,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,UAAU,CAAC,cAAc,CAAC,CAAC,CAAC;QACnE,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,CAAC,CAAC;QAC1D,MAAM,GAAG,GACP,SAAS,KAAK,SAAS;YACrB,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,EAAE,SAAS,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC;YAChF,CAAC,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;QACxC,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAA0B,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,OAAO,CAAC;QACtC,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;QAC9C,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,cAAc,CAAC,UAAU,EAAE,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACjF,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,IAAY,EAAE,KAAgB;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,yBAAyB,CAAC,IAAY;QAC1C,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,oGAAoG;IAEpG,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY;QAChC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IACrC,CAAC;IAED,sGAAsG;IAEtG,KAAK,CAAC,YAAY,CAChB,IAAY,EACZ,IAAwB;QAExB,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACzC,CAAC;IAED,KAAK,CAAC,gBAAgB,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa,EAAE,IAAwB;QACxF,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,IAAwB;QACzD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,MAAM,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,qGAAqG;IAErG,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,IAAU;QACzD,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC;IACtE,CAAC;IAED,KAAK,CAAC,cAAc,CAAC,IAAY,EAAE,MAAc;QAC/C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC5D,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAqC,CAAC;IAC7D,CAAC;IAED,0FAA0F;IAC1F,KAAK,CAAC,QAAQ,CAAc,IAAY,EAAE,MAAc;QACtD,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,QAAQ,CAAI,IAAI,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAAY,EAAE,MAAc;QAC5C,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAC/C,CAAC;IAED,uGAAuG;IAEvG,KAAK,CAAC,YAAY,CAAc,IAAY,EAAE,MAAc,EAAE,GAAW;QACvE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;QAClE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAE,MAAM,CAAC,KAAW,CAAC,CAAC,CAAC,SAAS,CAAC;IACxD,CAAC;IAED,KAAK,CAAC,YAAY,CAAC,IAAY,EAAE,MAAc,EAAE,GAAW,EAAE,KAAc;QAC1E,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC;IAC5E,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAAY,EAAE,MAAc,EAAE,GAAW;QAC7D,MAAM,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,CAAC,CAAC;IACxD,CAAC;IAED,uGAAuG;IAEvG,qGAAqG;IACrG,KAAK,CAAC,MAAM;QACV,OAAO;YACL,OAAO,EAAE;gBACP,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO;gBAC/B,MAAM,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM;gBAC7B,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO;aAChC;YACD,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ;SAClC,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,IAAiD;QAC1D,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,MAAM;QACV,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,IAAI,CAAC,YAAY,EAAE,CAAC;QAC7C,OAAO,MAAM,CAAC,MAAM,EAAE,CAAC;IACzB,CAAC;IAED,yGAAyG;IAEzG,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAC;IACtB,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,+FAA+F;QAC/F,gGAAgG;QAChG,IAAI,CAAC;YACH,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;gBACrC,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBAC9D,MAAM,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC;YAC9B,CAAC;QACH,CAAC;gBAAS,CAAC;YACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;IACH,CAAC;IAED,KAAK,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC;QACzB,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC;IACrB,CAAC;IAED,4GAA4G;IAE5G,gBAAgB,CAAC,IAAY;QAC3B,MAAM,GAAG,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACrC,IAAI,GAAG,KAAK,SAAS;YAAE,MAAM,IAAI,gBAAgB,CAAC,uBAAuB,IAAI,EAAE,CAAC,CAAC;QACjF,OAAO,GAAG,CAAC;IACb,CAAC;IAED,UAAU,CAAC,KAAa,EAAE,GAA4B;QACpD,MAAM,KAAK,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,EAAE,CAAC,CAAC;QACtF,IAAI,KAAK,GAAG,CAAC,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM;YAAE,MAAM,IAAI,gBAAgB,CAAC,cAAc,CAAC,CAAC;QACnF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,GAAa,EACb,IAAwD;QAExD,MAAM,KAAK,GACT,IAAI,EAAE,aAAa,KAAK,IAAI,IAAI,GAAG,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;QACnG,MAAM,IAAI,GAAa,EAAE,GAAG,GAAG,EAAE,KAAK,EAAE,CAAC;QACzC,IAAI,IAAI,EAAE,UAAU,KAAK,IAAI;YAAE,OAAO,IAAI,CAAC;QAC3C,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAc,CAAC,CAAC;QAC5D,MAAM,gBAAgB,GAAI,IAAI,CAAC,KAAK,CAAC,GAAG,CAAe,CAAC,MAAM,CAAC;QAC/D,OAAO,EAAE,GAAG,IAAI,EAAE,gBAAgB,EAAE,CAAC;IACvC,CAAC;IAED;;;mGAG+F;IAC/F,YAAY;QACV,IAAI,IAAI,CAAC,aAAa,KAAK,SAAS,EAAE,CAAC;YACrC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAC1C,CAAC;QACD,OAAO,IAAI,CAAC,aAAa,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,WAAW;QACf,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;QAC5B,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QAC3E,OAAO,EAAE,MAAM,EAAE,IAAI,WAAW,CAAC,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,EAAE,QAAQ,EAAE,CAAC;IACrE,CAAC;CACF"}

package/dist/bridge.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Loopback admin-plane HTTP client (issue #10) — the embedded transport's fallback for the handful
+ * of admin operations `librift_ffi` has no C-ABI symbol for: scenarios, saved-request/proxy-response
+ * deletion, enable/disable, logs, reload, and `getSpace` (the one space operation without a
+ * `rift_space_*` counterpart — see `admin.ts`). Started lazily, at most once per `EmbeddedAdmin`
+ * (see its `#ensurePlane`), against the loopback `rift_serve_admin` plane.
+ *
+ * Reuses `RemoteClient` wholesale rather than re-deriving fetch/HTTP-status mapping a second time —
+ * the loopback plane speaks the exact same admin HTTP surface a remote/spawned engine does.
+ */
+import { type FlowScopedOptions } from '@rift-vs/rift/internal';
+export interface BridgeOptions {
+    adminUrl: string;
+    apiKey: string;
+}
+export declare class AdminBridge {
+    #private;
+    constructor(opts: BridgeOptions);
+    getScenarios(port: number, opts?: FlowScopedOptions): Promise<{
+        flowId: string;
+        scenarios: Array<{
+            name: string;
+            state: string;
+        }>;
+    }>;
+    setScenarioState(port: number, name: string, state: string, opts?: FlowScopedOptions): Promise<void>;
+    resetScenarios(port: number, opts?: FlowScopedOptions): Promise<void>;
+    deleteSavedRequests(port: number, match?: string[]): Promise<void>;
+    deleteSavedProxyResponses(port: number): Promise<void>;
+    enableImposter(port: number): Promise<void>;
+    disableImposter(port: number): Promise<void>;
+    logs(opts?: {
+        startIndex?: number;
+        endIndex?: number;
+    }): Promise<unknown[]>;
+    reload(): Promise<unknown>;
+    /** No `rift_space_*` FFI symbol returns the full space object (only its stub list, via
+     * `spaceListStubs`) — bridged rather than reconstructed approximately from the FFI pieces. */
+    getSpace<T = unknown>(port: number, flowId: string): Promise<T>;
+    close(): Promise<void>;
+}
+//# sourceMappingURL=bridge.d.ts.map

package/dist/bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.d.ts","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAgB,KAAK,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE9E,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,WAAW;;gBAGV,IAAI,EAAE,aAAa;IAI/B,YAAY,CACV,IAAI,EAAE,MAAM,EACZ,IAAI,CAAC,EAAE,iBAAiB,GACvB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,CAAC;YAAE,IAAI,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC;IAIjF,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpG,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAIrE,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlE,yBAAyB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAItD,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI3C,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,IAAI,CAAC,IAAI,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,OAAO,EAAE,CAAC;IAI3E,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC;IAI1B;kGAC8F;IAC9F,QAAQ,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAIzD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAG7B"}

package/dist/bridge.js

@@ -0,0 +1,53 @@
+/**
+ * Loopback admin-plane HTTP client (issue #10) — the embedded transport's fallback for the handful
+ * of admin operations `librift_ffi` has no C-ABI symbol for: scenarios, saved-request/proxy-response
+ * deletion, enable/disable, logs, reload, and `getSpace` (the one space operation without a
+ * `rift_space_*` counterpart — see `admin.ts`). Started lazily, at most once per `EmbeddedAdmin`
+ * (see its `#ensurePlane`), against the loopback `rift_serve_admin` plane.
+ *
+ * Reuses `RemoteClient` wholesale rather than re-deriving fetch/HTTP-status mapping a second time —
+ * the loopback plane speaks the exact same admin HTTP surface a remote/spawned engine does.
+ */
+import { RemoteClient } from '@rift-vs/rift/internal';
+export class AdminBridge {
+    #client;
+    constructor(opts) {
+        this.#client = new RemoteClient(opts.adminUrl, { apiKey: opts.apiKey });
+    }
+    getScenarios(port, opts) {
+        return this.#client.getScenarios(port, opts);
+    }
+    setScenarioState(port, name, state, opts) {
+        return this.#client.setScenarioState(port, name, state, opts);
+    }
+    resetScenarios(port, opts) {
+        return this.#client.resetScenarios(port, opts);
+    }
+    deleteSavedRequests(port, match) {
+        return this.#client.deleteSavedRequests(port, match);
+    }
+    deleteSavedProxyResponses(port) {
+        return this.#client.deleteSavedProxyResponses(port);
+    }
+    enableImposter(port) {
+        return this.#client.enableImposter(port);
+    }
+    disableImposter(port) {
+        return this.#client.disableImposter(port);
+    }
+    logs(opts) {
+        return this.#client.logs(opts);
+    }
+    reload() {
+        return this.#client.reload();
+    }
+    /** No `rift_space_*` FFI symbol returns the full space object (only its stub list, via
+     * `spaceListStubs`) — bridged rather than reconstructed approximately from the FFI pieces. */
+    getSpace(port, flowId) {
+        return this.#client.getSpace(port, flowId);
+    }
+    async close() {
+        await this.#client.close();
+    }
+}
+//# sourceMappingURL=bridge.js.map

package/dist/bridge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bridge.js","sourceRoot":"","sources":["../src/bridge.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,YAAY,EAA0B,MAAM,wBAAwB,CAAC;AAO9E,MAAM,OAAO,WAAW;IACtB,OAAO,CAAe;IAEtB,YAAY,IAAmB;QAC7B,IAAI,CAAC,OAAO,GAAG,IAAI,YAAY,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1E,CAAC;IAED,YAAY,CACV,IAAY,EACZ,IAAwB;QAExB,OAAO,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,gBAAgB,CAAC,IAAY,EAAE,IAAY,EAAE,KAAa,EAAE,IAAwB;QAClF,OAAO,IAAI,CAAC,OAAO,CAAC,gBAAgB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;IAChE,CAAC;IAED,cAAc,CAAC,IAAY,EAAE,IAAwB;QACnD,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IACjD,CAAC;IAED,mBAAmB,CAAC,IAAY,EAAE,KAAgB;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,mBAAmB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,yBAAyB,CAAC,IAAY;QACpC,OAAO,IAAI,CAAC,OAAO,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED,cAAc,CAAC,IAAY;QACzB,OAAO,IAAI,CAAC,OAAO,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;IAC3C,CAAC;IAED,eAAe,CAAC,IAAY;QAC1B,OAAO,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;IAC5C,CAAC;IAED,IAAI,CAAC,IAAiD;QACpD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjC,CAAC;IAED,MAAM;QACJ,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/B,CAAC;IAED;kGAC8F;IAC9F,QAAQ,CAAc,IAAY,EAAE,MAAc;QAChD,OAAO,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAI,IAAI,EAAE,MAAM,CAAC,CAAC;IAChD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,MAAM,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;IAC7B,CAAC;CACF"}

package/dist/create.d.ts

@@ -0,0 +1,26 @@
+/**
+ * `rift.embedded()` wiring (issue #10): resolves the `librift_ffi` cdylib, loads the `NativeEngine`,
+ * runs the version/feature preflight, and returns the same `RiftEngine` facade `rift.connect`/
+ * `rift.spawn` produce — backed by `EmbeddedAdmin` (./admin.ts) instead of an HTTP client.
+ *
+ * `loadNativeEngine` is injectable specifically so this whole pipeline — preflight, registry, stub
+ * routing, and the lazy admin-plane bridge — is unit-testable against a FAKE `NativeEngineLike` with
+ * no real cdylib/koffi involved (see test/unit/embedded-admin.test.ts). The default wiring (real
+ * `resolveCdylib` + `NativeEngine.load`) is only exercised by the real-cdylib integration suite,
+ * which self-skips without `RIFT_FFI_LIB`.
+ */
+import { Engine } from '@rift-vs/rift/internal';
+import { type NativeEngineLike, type StartAdminPlane } from './admin.js';
+import type { EmbeddedOptions } from '@rift-vs/rift';
+export type { EmbeddedOptions };
+export interface EmbeddedDeps {
+    /** Injectable native-engine loader; defaults to `resolveCdylib` + `NativeEngine.load`. Supplying
+     * this SKIPS `resolveCdylib` entirely — tests inject a fake loader with no real cdylib involved.
+     * Note: `options.keepAlive` is forwarded only by the DEFAULT loader; an injected loader owns its
+     * worker lifecycle and must handle keep-alive itself if it cares. */
+    loadNativeEngine?: (libPath: string) => Promise<NativeEngineLike>;
+    /** Injectable admin-plane starter, forwarded to `EmbeddedAdmin`; see `admin.ts`'s `StartAdminPlane`. */
+    startAdminPlane?: StartAdminPlane;
+}
+export declare function createEmbeddedEngine(options?: EmbeddedOptions, deps?: EmbeddedDeps): Promise<Engine>;
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAAE,MAAM,EAAoD,MAAM,wBAAwB,CAAC;AAKlG,OAAO,EAAiB,KAAK,gBAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,YAAY,CAAC;AAKxF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AACrD,YAAY,EAAE,eAAe,EAAE,CAAC;AAEhC,MAAM,WAAW,YAAY;IAC3B;;;yEAGqE;IACrE,gBAAgB,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;IAClE,wGAAwG;IACxG,eAAe,CAAC,EAAE,eAAe,CAAC;CACnC;AAsDD,wBAAsB,oBAAoB,CACxC,OAAO,GAAE,eAAoB,EAC7B,IAAI,GAAE,YAAiB,GACtB,OAAO,CAAC,MAAM,CAAC,CA8BjB"}