lanka 1.0.0 → 1.1.0

package/README.md

@@ -2,7 +2,7 @@
 
 **◆ core** · Core
 
-> Ten subsystems, two peer dependencies, five extension points.
+> Twelve subsystems, two peer dependencies, five extension points.
 
 One, unscoped. Everything depends on it; it depends on nothing.
 
@@ -16,7 +16,8 @@ One, unscoped. Everything depends on it; it depends on nothing.
 | --- | --- | --- |
 | `useRequestMiddleware(mw)` | wrap every request | yes |
 | `inFlight.subscribe(fn)` | observe the number of requests on the wire | yes |
-| `lankaEventBus.addMiddleware` | intercept bus events | yes |
+| `lankaEventBus.addMiddleware` | intercept bus events, and stop one | yes |
+| `lankaEventBus.addObserver` | hear what became of each dispatch | yes |
 | `LankaLogger sinks` | where log output goes | yes |
 | `use(plugin)` | register a whole plugin | yes |
 
@@ -46,6 +47,7 @@ the seal on `internal`, and catches a subsystem added as a folder and forgotten
 - `src/mock/`
 - `src/errors/`
 - `src/scenario/`
+- `src/stream/`
 - `src/viewmodel/`
 - `src/logger/`
 - `src/internal/` — **not exported.** Refactored without a major.
@@ -226,7 +228,7 @@ to rename.
 
 `ViewModel` shortens to `VM` in class, factory and type names: `ALankaVM` and
 `createLankaVM` are written in every screen file — the same ViewModel reached from
-either style, one of the nine roles `skills/parity/SKILL.md` governs.
+either style, one of the roles `skills/parity/SKILL.md` governs.
 
 Three names stay bare — `isRecord`, `getStringField`, `generateUuid`. They are pure
 utilities over ordinary values; a collision there is resolved at the import site, which

package/dist/{ALankaGateway-ExlRGT3D.d.ts → ALankaGateway-CkW1LbKE.d.ts}

@@ -1,5 +1,34 @@
 import { I as ILankaValidator } from './lankaStandardValidator-CL-r-zEV.js';
 
+/**
+ * `RequestInit`, with the body a JSON API actually sends.
+ *
+ * `RequestInit["body"]` is `BodyInit | null` — a string, a `FormData`, a blob,
+ * bytes. It is what `fetch` accepts and it is NOT what a gateway method writes:
+ * every one of them writes `body: { name, email }`, an object, and lets the
+ * transport encode it.
+ *
+ * The framework's transport has always encoded that object. The TYPE never
+ * admitted it, and the cost was not a cast at the call site — it was a fork. A
+ * consumer could not write `body: { … }` against `RequestInit`, so they declared
+ * their own options type; declaring it made every shipped transport
+ * unassignable, because those were fixed to `RequestInit`; so they wrote a
+ * transport too, and with it a base URL, a CSRF header and an auth refresh the
+ * framework already had. One wrong type produced a re-implementation of three
+ * packages.
+ *
+ * `unknown` rather than a union of the encodable shapes: the transport decides
+ * by INSPECTING the value, and a type listing what it accepts would have to be
+ * kept in step with that inspection by hand. What is not a `BodyInit` is JSON —
+ * that is the whole rule, and it needs no enumeration.
+ */
+type TLankaRequestInit = Omit<RequestInit, "body"> & {
+    /**
+     * Anything. A `BodyInit` travels as given; everything else is encoded as JSON.
+     */
+    body?: unknown;
+};
+
 /**
  * Transport options plus what core controls.
  *
@@ -26,7 +55,7 @@ type TLankaExecuteOptions<TOptions> = TOptions & {
  * is how development without a backend works, and a request that ignored it
  * would silently disable mock mode for the gateway holding it.
  */
-interface ILankaRequest<TOptions = RequestInit> {
+interface ILankaRequest<TOptions = TLankaRequestInit> {
     /**
      * Sends the request and returns the value the caller asked for.
      *
@@ -68,7 +97,15 @@ interface IALankaGatewayConfig<TOptions> {
      * reads it.
      */
     queryParamsHandler?: TLankaQueryBuilder;
-    /** Validation service (DI). May be replaced for tests / migration. */
+    /**
+     * The validator a method checks a response body with. Defaults to
+     * `lankaStandardValidator`.
+     *
+     * Reachable as `this.validationService` in a class and as
+     * `validationService` in the functional context. A test hands one that
+     * records what it was asked; a migration hands one that accepts a shape the
+     * new schema does not yet.
+     */
     validationService?: ILankaValidator;
     /**
      * Enable mock mode. If undefined, reads from infrastructure flags (isMockMode).
@@ -77,9 +114,18 @@ interface IALankaGatewayConfig<TOptions> {
     useMock?: boolean;
 }
 
-declare abstract class ALankaGateway<TOptions = RequestInit> {
+declare abstract class ALankaGateway<TOptions = TLankaRequestInit> {
     protected requestExecutor: ILankaRequest<TOptions>;
     protected queryParamsHandler: TLankaQueryBuilder;
+    /**
+     * The validator a method checks a response body with.
+     *
+     * `config.validationService` when one was given, the Standard Schema port
+     * otherwise. It used to be accepted by the config and read by nothing: a
+     * consumer handing a test double to the gateway got the real validator and no
+     * error, which is the worst kind of ignored option — it looks honoured.
+     */
+    protected readonly validationService: ILankaValidator;
     protected readonly useMock: boolean;
     protected readonly basePath: string;
     protected constructor(config: IALankaGatewayConfig<TOptions>);
@@ -119,4 +165,4 @@ declare abstract class ALankaGateway<TOptions = RequestInit> {
     protected setQueryParamsHandler(handler: TLankaQueryBuilder): void;
 }
 
-export { ALankaGateway as A, type IALankaGatewayConfig as I, type TLankaExecuteOptions as T, type ILankaRequest as a, type TLankaQueryBuilder as b, type TLankaQueryParams as c };
+export { ALankaGateway as A, type IALankaGatewayConfig as I, type TLankaExecuteOptions as T, type TLankaRequestInit as a, type ILankaRequest as b, type TLankaQueryBuilder as c, type TLankaQueryParams as d };

package/dist/{ILankaScenarioMetadata-Bu-yggTZ.d.ts → ILankaScenarioMetadata-GoWWNEQL.d.ts}

@@ -1,4 +1,4 @@
-import { a as ILankaScenario } from './ILankaScenarioVM-DuCyPoyT.js';
+import { a as ILankaScenario } from './ILankaScenarioVM-DUsI-fSc.js';
 
 /**
  * Metadata about a registered scenario

package/dist/{ILankaScenarioVM-DuCyPoyT.d.ts → ILankaScenarioVM-DUsI-fSc.d.ts}

@@ -35,6 +35,17 @@ interface ILankaEventLog {
     eventType: string;
     /** ISO timestamp of when the event was dispatched. */
     timestamp: string;
+    /**
+     * Where this record falls in the order the bus saw events, counting from one.
+     *
+     * What `getEventLogs()` orders by, and the reason it can: a timestamp has
+     * millisecond resolution, and a burst dispatches many events inside one, so
+     * two records of one millisecond cannot be told apart by their time.
+     *
+     * Optional because a record built by anything other than the bus has no
+     * place in that order.
+     */
+    sequence?: number;
     /** The payload data of the event. */
     data: unknown;
     /** Optional captured stack trace (if enabled). */
@@ -77,6 +88,60 @@ type TLankaEventBusDecision = "pass" | {
  */
 type TLankaEventBusMiddleware<T> = (eventType: string, data: T) => TLankaEventBusDecision;
 
+/**
+ * What became of one dispatch, after the whole chain has run.
+ *
+ * The counterpart of `TLankaEventBusDecision`: a middleware RETURNS a decision,
+ * and the bus REPORTS an outcome. The two are deliberately symmetrical, and the
+ * asymmetry that matters is that an outcome cannot change anything.
+ */
+interface ILankaEventBusOutcome {
+    eventType: string;
+    /**
+     * Delivered to the subscribers, stopped by a middleware, or refused by the
+     * event's own schema.
+     *
+     * A union rather than an `enum`: a fourth outcome is then additive, which
+     * `skills/surface/SKILL.md` §6d.5 is about.
+     */
+    outcome: "delivered" | "stopped" | "invalid";
+    /**
+     * How many subscribers the event had when it was dispatched.
+     *
+     * The AUDIENCE, not the recipients: "three subscribers never heard it" is the
+     * sentence a stopped event needs, and a count that went to zero on a stop
+     * could not say it.
+     */
+    subscribers: number;
+    /** The reason a middleware gave, when one stopped it. */
+    stoppedBy?: string;
+}
+
+/**
+ * Something watching what became of each dispatch.
+ *
+ * ## Why this is not a middleware
+ *
+ * A middleware runs in a CHAIN and sees only what happened before it. The first
+ * one registered — which is what a diagnostic tool ends up being, since it is
+ * installed at bootstrap — cannot see a later middleware's decision to stop an
+ * event, so "which middleware stopped it" was a question nothing could answer.
+ * `@lankajs/plugin-devtools` carried a `stoppedBy` field that no code path ever
+ * filled, and its guide documented it.
+ *
+ * An observer runs ONCE per dispatch, after the chain, and its return value is
+ * ignored — it cannot decide anything. That is what keeps a diagnostic tool
+ * incapable of changing what it diagnoses, by construction rather than by
+ * discipline.
+ *
+ * ## Why the parameter is one object
+ *
+ * `skills/surface/SKILL.md` §6d.9: a callback's parameters are one object, so
+ * the day the bus learns to report how long delivery took, nobody's handler
+ * silently receives a different third argument.
+ */
+type TLankaEventBusObserver = (outcome: ILankaEventBusOutcome) => void;
+
 /**
  * How many recent values to replay to a new subscriber.
  *
@@ -88,12 +153,26 @@ declare class LankaEventBusInstance {
     private registry;
     /** Middleware registered on this instance. */
     private middlewares;
+    /**
+     * What is watching the OUTCOME of each dispatch — see `TLankaEventBusObserver`.
+     *
+     * An array rather than a set for one reason: `dispatch` reads `.length` on
+     * every event, and that check is what keeps an unobserved bus paying nothing.
+     */
+    private observers;
     /** Default maximum number of logs kept per event type. */
     private defaultMaxLogs;
     /** Internal timers for replay batching (avoid multiple replays in the same tick). */
     private pendingReplayTimers;
     /** Whether event logging is enabled. */
     private isEnableLogs;
+    /**
+     * How many events this bus has logged, ever — the order records are read in.
+     *
+     * Incremented only while logging is on, which is off by default, so a bus
+     * nobody is inspecting pays nothing for it.
+     */
+    private dispatchCount;
     /** Configures the bus, e.g. logging. Called once at application start. */
     enableLogs(): void;
     disableLogs(): void;
@@ -162,7 +241,28 @@ declare class LankaEventBusInstance {
     /** Removes previously added middleware. */
     removeMiddleware<T>(mw: TLankaEventBusMiddleware<T>): void;
     /**
-     * Log of dispatched events.
+     * Watches what became of each dispatch. An extension point — the sixth.
+     *
+     * An observer never decides: its return value is ignored, and a throw from it
+     * is logged rather than surfaced. A diagnostic tool that could stop an event
+     * would make "I disabled the inspector and it started working" a sentence
+     * somebody says.
+     */
+    addObserver(observer: TLankaEventBusObserver): void;
+    /** Removes a previously added observer. */
+    removeObserver(observer: TLankaEventBusObserver): void;
+    /**
+     * Log of dispatched events, oldest first, `limit` most recent kept.
+     *
+     * ## Why the records are sorted rather than concatenated
+     *
+     * They are held per event TYPE, so that each type keeps its own `maxLogs`
+     * and a chatty event cannot push a quiet one's history out. Concatenating
+     * those lists puts every record of one type before every record of the next,
+     * and `slice(-limit)` then answers the tail of whichever type the registry
+     * happened to hold last — not the most recent events at all. On a bus with
+     * one event type nothing looked wrong; on a real one the log was a
+     * chronology that had never been in chronological order.
      *
      * @param eventType Limit to one type
      * @param limit How many recent records to return
@@ -172,8 +272,21 @@ declare class LankaEventBusInstance {
     clearEvent(eventType: string): void;
     /** Removes every event and any scheduled replays. */
     clearAllEvents(): void;
-    /** Full bus reset: events and middleware. */
+    /** Full bus reset: events, middleware and observers. */
     reset(): void;
+    /**
+     * Tells the observers what became of a dispatch.
+     *
+     * The empty-list check is the whole reason a bus nobody watches pays nothing
+     * for this: `dispatch` is a hot path, and an iteration over an empty array on
+     * every event would be a cost paid by every application for a feature almost
+     * none of them installs. Measured in `LankaEventBusInstance.bench.ts`.
+     *
+     * An observer that throws is logged and the next one still runs — the same
+     * treatment a subscriber gets, and for the same reason: a diagnostic tool must
+     * not be able to break the application it is diagnosing.
+     */
+    private report;
     /**
      * Marks the last log record with the reason it was stopped.
      *
@@ -257,4 +370,4 @@ interface ILankaScenarioVM {
     resetScenario(): void;
 }
 
-export { type ILankaScenarioVM as I, LankaEventBusInstance as L, type TLankaReplayRequest as T, type ILankaScenario as a, type ILankaEventMetadata as b, type TLankaEventBusMiddleware as c, type ILankaEventLog as d, type TLankaEventBusDecision as e };
+export { type ILankaScenarioVM as I, LankaEventBusInstance as L, type TLankaReplayRequest as T, type ILankaScenario as a, type ILankaEventMetadata as b, type TLankaEventBusMiddleware as c, type TLankaEventBusObserver as d, type ILankaEventLog as e, type ILankaEventBusOutcome as f, type TLankaEventBusDecision as g };

package/dist/{LankaScenarioLocator-BGQHwf3n.d.ts → LankaScenarioLocator-D86TIwiu.d.ts}

@@ -1,7 +1,7 @@
-import { a as ILankaScenario, I as ILankaScenarioVM } from './ILankaScenarioVM-DuCyPoyT.js';
-import { I as ILankaScenarioMetadata } from './ILankaScenarioMetadata-Bu-yggTZ.js';
-import { A as ALankaGateway } from './ALankaGateway-ExlRGT3D.js';
-import { A as ALankaLocator } from './LankaSharedStoreLocator-MvCpav5F.js';
+import { a as ILankaScenario, I as ILankaScenarioVM } from './ILankaScenarioVM-DUsI-fSc.js';
+import { I as ILankaScenarioMetadata } from './ILankaScenarioMetadata-GoWWNEQL.js';
+import { A as ALankaGateway } from './ALankaGateway-CkW1LbKE.js';
+import { A as ALankaLocator } from './LankaSharedStoreLocator-zS2kLu-S.js';
 
 /**
  * The scenario registry: both those that registered themselves and those
@@ -31,7 +31,8 @@ declare class LankaScenariosRegistry {
      */
     register(scenario: ILankaScenario<unknown>): boolean;
     /**
-     * Unregister a scenario
+     * Removes a scenario, calling its `cleanup` if it declared one.
+     *
      * @param scenarioName Name of the scenario to unregister
      * @returns true if unregistered successfully, false if not found
      */
@@ -61,7 +62,11 @@ declare class LankaScenariosRegistry {
     /** Every registered ViewModel. */
     getAllViewModels(): ILankaScenarioVM[];
     /**
-     * Clears every registered scenario. Required by tests.
+     * Removes every scenario, calling each one's `cleanup`.
+     *
+     * What `dispose()` and the between-tests reset go through: `initialize` ran
+     * for every scenario at bootstrap, and this is the one moment its mirror
+     * image can run for all of them.
      */
     clear(): void;
 }

package/dist/{LankaSharedStoreLocator-MvCpav5F.d.ts → LankaSharedStoreLocator-zS2kLu-S.d.ts}

@@ -43,6 +43,27 @@ declare abstract class ALankaLocator<TInstance> implements ILankaLocator<TInstan
         notFoundError: (name: string, propertyName: string) => string;
     };
     protected constructor(config: ILankaLocatorConfig<TInstance>);
+    /**
+     * The class a name resolves to: hand-registered FIRST, then the consumer's
+     * barrel.
+     *
+     * One owner for both callers, and that is the whole point of it existing.
+     * `registeredClasses` used to be read inside each locator's own
+     * `findClassByName`, and only two of the four did it — singletons and shared
+     * stores worked, gateways and scenarios silently dropped the class. Moving the
+     * read into `getInstanceByName` fixed those two and broke a third path:
+     * `LankaSingletonLocator.createScopedInstance` calls `findClassByName`
+     * directly, so a registered class stopped resolving inside a scope. Ten tests
+     * said so.
+     *
+     * Both callers go through here now. A fourth caller added later gets the
+     * precedence for free instead of having to remember it.
+     *
+     * The precedence itself matches `registeredInstances` below: what a caller
+     * handed over wins over what the barrel happens to export under that name,
+     * because the caller is usually a test substituting a double.
+     */
+    protected classFor(instanceName: string): (new () => TInstance) | undefined;
     /**
      * An object by class name.
      *

package/dist/_extend/index.d.ts

@@ -1,11 +1,11 @@
-export { L as LankaGatewayLocator, a as LankaScenarioLocator, b as LankaScenarioVMRegistry, c as LankaScenariosRegistry } from '../LankaScenarioLocator-BGQHwf3n.js';
-import { a as ILankaLocator } from '../LankaSharedStoreLocator-MvCpav5F.js';
-export { A as ALankaLocator, L as LankaSharedStoreLocator, b as LankaSingletonLocator } from '../LankaSharedStoreLocator-MvCpav5F.js';
-export { c as createLankaScope } from '../createLankaScope-Bc_vChRs.js';
+export { L as LankaGatewayLocator, a as LankaScenarioLocator, b as LankaScenarioVMRegistry, c as LankaScenariosRegistry } from '../LankaScenarioLocator-D86TIwiu.js';
+import { a as ILankaLocator } from '../LankaSharedStoreLocator-zS2kLu-S.js';
+export { A as ALankaLocator, L as LankaSharedStoreLocator, b as LankaSingletonLocator } from '../LankaSharedStoreLocator-zS2kLu-S.js';
+export { c as createLankaScope } from '../createLankaScope-BiFxNQgl.js';
 export { c as composeLankaRequestMiddleware } from '../lankaRequestMiddleware-DAC5kCb7.js';
-import '../ILankaScenarioVM-DuCyPoyT.js';
-import '../ILankaScenarioMetadata-Bu-yggTZ.js';
-import '../ALankaGateway-ExlRGT3D.js';
+import '../ILankaScenarioVM-DUsI-fSc.js';
+import '../ILankaScenarioMetadata-GoWWNEQL.js';
+import '../ALankaGateway-CkW1LbKE.js';
 import '../lankaStandardValidator-CL-r-zEV.js';
 import '@standard-schema/spec';
 import '../ALankaSharedStore-B7uepuuk.js';

package/dist/_extend/index.js

@@ -2,11 +2,11 @@ import {
   LankaGatewayLocator,
   LankaScenarioLocator,
   createLankaScope
-} from "../chunk-FIR4XTBL.js";
+} from "../chunk-5MAQVBI2.js";
 import {
   LankaScenarioVMRegistry,
   LankaScenariosRegistry
-} from "../chunk-EWVDJYCC.js";
+} from "../chunk-O5ROO7QF.js";
 import {
   composeLankaRequestMiddleware
 } from "../chunk-YR4MZXMU.js";
@@ -17,7 +17,7 @@ import {
   ALankaLocator,
   LankaSharedStoreLocator,
   LankaSingletonLocator
-} from "../chunk-ILQNYQY5.js";
+} from "../chunk-UE2C76OR.js";
 import "../chunk-C2HP7CRD.js";
 import "../chunk-D27MREPB.js";
 import "../chunk-BGVDPDX4.js";

package/dist/_internal/index.d.ts

@@ -1,11 +1,11 @@
-export { I as ILankaRuntime, T as TLankaRuntimeResolver, s as setLankaRuntimeResolver } from '../activeRuntime-FcsSJvUg.js';
-import '../ILankaScenarioVM-DuCyPoyT.js';
-import '../LankaScenarioLocator-BGQHwf3n.js';
-import '../ILankaScenarioMetadata-Bu-yggTZ.js';
-import '../ALankaGateway-ExlRGT3D.js';
+export { I as ILankaRuntime, T as TLankaRuntimeResolver, s as setLankaRuntimeResolver } from '../activeRuntime-B336NU5I.js';
+import '../ILankaScenarioVM-DUsI-fSc.js';
+import '../LankaScenarioLocator-D86TIwiu.js';
+import '../ILankaScenarioMetadata-GoWWNEQL.js';
+import '../ALankaGateway-CkW1LbKE.js';
 import '../lankaStandardValidator-CL-r-zEV.js';
 import '@standard-schema/spec';
-import '../LankaSharedStoreLocator-MvCpav5F.js';
+import '../LankaSharedStoreLocator-zS2kLu-S.js';
 import '../ALankaSharedStore-B7uepuuk.js';
 import 'zustand/vanilla';
 import '../ILankaRuntimeConfig-Vl436GWK.js';

package/dist/{activeRuntime-FcsSJvUg.d.ts → activeRuntime-B336NU5I.d.ts}

@@ -1,9 +1,9 @@
-import { L as LankaEventBusInstance, I as ILankaScenarioVM } from './ILankaScenarioVM-DuCyPoyT.js';
-import { c as LankaScenariosRegistry, b as LankaScenarioVMRegistry, L as LankaGatewayLocator, a as LankaScenarioLocator } from './LankaScenarioLocator-BGQHwf3n.js';
+import { L as LankaEventBusInstance, I as ILankaScenarioVM } from './ILankaScenarioVM-DUsI-fSc.js';
+import { c as LankaScenariosRegistry, b as LankaScenarioVMRegistry, L as LankaGatewayLocator, a as LankaScenarioLocator } from './LankaScenarioLocator-D86TIwiu.js';
 import { b as ILankaRuntimeConfig } from './ILankaRuntimeConfig-Vl436GWK.js';
 import { I as ILankaInFlightCounter } from './lankaHttpInFlight-Bk1eIuSx.js';
 import { T as TLankaRequestMiddleware } from './lankaRequestMiddleware-DAC5kCb7.js';
-import { b as LankaSingletonLocator, L as LankaSharedStoreLocator } from './LankaSharedStoreLocator-MvCpav5F.js';
+import { b as LankaSingletonLocator, L as LankaSharedStoreLocator } from './LankaSharedStoreLocator-zS2kLu-S.js';
 
 /**
  * The pointer to the framework instance that ambient facades resolve to.

package/dist/bootstrap/index.d.ts

@@ -1,150 +1,19 @@
-import { I as ILankaScope } from '../createLankaScope-Bc_vChRs.js';
-import { I as ILankaRuntime } from '../activeRuntime-FcsSJvUg.js';
-import { a as ILankaHost, I as ILankaFlags } from '../ILankaRuntimeConfig-Vl436GWK.js';
-import { T as TLankaRequestMiddleware } from '../lankaRequestMiddleware-DAC5kCb7.js';
-import '../LankaSharedStoreLocator-MvCpav5F.js';
-import '../ALankaSharedStore-B7uepuuk.js';
-import 'zustand/vanilla';
-import '../ILankaScenarioVM-DuCyPoyT.js';
-import '../LankaScenarioLocator-BGQHwf3n.js';
-import '../ILankaScenarioMetadata-Bu-yggTZ.js';
-import '../ALankaGateway-ExlRGT3D.js';
+import { c as ILankaPlugin, e as ILankaServiceConfig, I as ILankaBootstrapConfig, a as ILankaInstance } from '../createLanka-DI1CSy2Q.js';
+export { b as ILankaInstanceConfig, d as ILankaScenarioBootstrapConfig, f as createLanka } from '../createLanka-DI1CSy2Q.js';
+import { I as ILankaFlags, a as ILankaHost } from '../ILankaRuntimeConfig-Vl436GWK.js';
+export { I as ILankaScope } from '../createLankaScope-BiFxNQgl.js';
+import '../activeRuntime-B336NU5I.js';
+import '../ILankaScenarioVM-DUsI-fSc.js';
+import '../LankaScenarioLocator-D86TIwiu.js';
+import '../ILankaScenarioMetadata-GoWWNEQL.js';
+import '../ALankaGateway-CkW1LbKE.js';
 import '../lankaStandardValidator-CL-r-zEV.js';
 import '@standard-schema/spec';
+import '../LankaSharedStoreLocator-zS2kLu-S.js';
+import '../ALankaSharedStore-B7uepuuk.js';
+import 'zustand/vanilla';
 import '../lankaHttpInFlight-Bk1eIuSx.js';
-
-/**
- * A plugin is an extension core knows by SHAPE rather than by name.
- *
- * ## Plugin versus module
- *
- * A module is called by the application (`app → module`) and core does not know
- * it exists. A plugin sits on the path core itself walks (`app → core → plugin`).
- * The test question: does core need a hook for this to work? No — then it is a
- * module, and making it a plugin costs more, because the hook has to be supported
- * forever.
- *
- * ## Why `install` receives the instance
- *
- * So a plugin has no private route to the framework. Everything it can do comes
- * from the instance it was given, which means two instances in one process (a
- * test beside the app) do not share its configuration.
- */
-interface ILankaPlugin {
-    /**
-     * The name the plugin is recognised by. Registering the same name twice is
-     * rejected: two copies of a retry policy would silently double the request
-     * count.
-     */
-    readonly name: string;
-    /**
-     * Installation. The returned function removes everything the plugin installed
-     * and is called when the plugin is removed and when the instance is disposed.
-     */
-    install: (lanka: ILankaInstance) => (() => void) | void;
-}
-
-/**
- * A framework instance: all framework state in one object.
- *
- * What instance-scoped state buys: two apps in one process (micro-frontends,
- * Storybook beside the app) no longer share a bus, locator caches and mock mode;
- * SSR does not reuse state between different users' requests; and test isolation
- * rests on construction rather than on a global `beforeEach` reaching into
- * internal registries.
- *
- * **Ambient facades** — `lankaEventBus.dispatch`, `lankaSingletons.foo`,
- * `getLankaFlags()`, `lankaHttpInFlight` — resolve THE ONE active instance
- * (`internal/activeRuntime.ts`). Isolation belongs to whoever holds an instance;
- * a facade cannot offer it.
- *
- * One thing stays at module level deliberately: `ALankaScenario` collects
- * constructed scenarios into a static pool. That is a REGISTRY OF DEFINITIONS,
- * not runtime state — the classes come from one `@lanka_di/Scenarios` barrel and
- * both instances must see the same list. Splitting it would be divergence.
- */
-interface ILankaInstance extends ILankaRuntime {
-    /**
-     * Adds a wrapper around every request. Returns a function that removes it.
-     *
-     * This is how `@lankajs/plugin-http` installs retry, the idempotency key, the
-     * CSRF header and auth refresh.
-     */
-    useRequestMiddleware(middleware: TLankaRequestMiddleware): () => void;
-    /** Default timeout for every request of this instance. */
-    setRequestTimeout(timeoutMs: number | undefined): void;
-    /** Resolves a service in the root scope — for the instance's whole lifetime. */
-    resolve<TInstance>(propertyName: string): TInstance;
-    /**
-     * Creates a scope: a lifetime shorter than the application's.
-     *
-     * An object created in a scope goes away with it.
-     */
-    createScope(): ILankaScope;
-    /**
-     * Registers a plugin. Returns a function that removes it.
-     *
-     * The fifth and last extension point. An extension point declared before
-     * anything plugs into it describes an imagined need while costing real
-     * support, so this one arrived with the FIRST plugin.
-     */
-    use(plugin: ILankaPlugin): () => void;
-    /** Runs services and the scenario layer. Idempotent. */
-    bootstrap(config?: ILankaBootstrapConfig): Promise<void>;
-    /** Has bootstrap already run? */
-    isBootstrapped(): boolean;
-    /** Makes this instance the one ambient facades resolve to. */
-    activate(): void;
-    /**
-     * Removes subscriptions, clears registries and, if this instance was active,
-     * clears the pointer. Returns the framework to its pre-bootstrap state.
-     */
-    dispose(): void;
-}
-interface ILankaInstanceConfig {
-    host: ILankaHost;
-    flags?: ILankaFlags;
-}
-interface ILankaServiceConfig {
-    name?: string;
-    init: () => void | Promise<void>;
-    sync?: boolean;
-    priority?: number;
-    /**
-     * A failure of this service does not abort bootstrap.
-     *
-     * Without the flag one failed service takes the WHOLE phase with it: the async
-     * phase because of `Promise.all`, the sync phase because later tasks never run.
-     * Wrapping the failure in a swallowing `try/catch` is worse still — the app
-     * starts with a partially executed plan and does not know it.
-     */
-    optional?: boolean;
-    /**
-     * How long to wait for the service. Overrunning counts as a failure.
-     *
-     * Without a deadline a service that never settles holds bootstrap forever and
-     * the app never paints its first screen. Failing is more honest than waiting:
-     * an optional service is skipped, a required one names itself.
-     */
-    timeoutMs?: number;
-}
-interface ILankaScenarioBootstrapConfig {
-    sync?: boolean;
-    priority?: number;
-}
-interface ILankaBootstrapConfig {
-    services?: ILankaServiceConfig[];
-    scenarios?: ILankaScenarioBootstrapConfig;
-}
-/**
- * Creates an instance and makes it active.
- *
- * Activating on creation is the deliberate default: there is almost always one
- * app and the facades must work immediately. A second instance takes the
- * pointer — the last one created serves the facades. Callers needing another
- * order call `activate()` explicitly.
- */
-declare function createLanka(config: ILankaInstanceConfig): ILankaInstance;
+import '../lankaRequestMiddleware-DAC5kCb7.js';
 
 /** What `startLanka` takes beyond the host, all of it optional. */
 interface ILankaStartOptions {
@@ -239,4 +108,4 @@ declare abstract class ALankaPlugin implements ILankaPlugin {
     install(lanka: ILankaInstance): () => void;
 }
 
-export { ALankaPlugin, type ILankaBootstrapConfig, type ILankaInstance, type ILankaInstanceConfig, type ILankaPlugin, type ILankaScenarioBootstrapConfig, ILankaScope, type ILankaServiceConfig, type ILankaStartOptions, type TLankaStartConfig, createLanka, resetActiveLanka, startLanka };
+export { ALankaPlugin, ILankaBootstrapConfig, ILankaInstance, ILankaPlugin, ILankaServiceConfig, type ILankaStartOptions, type TLankaStartConfig, resetActiveLanka, startLanka };

package/dist/bootstrap/index.js

@@ -3,13 +3,13 @@ import {
   createLanka,
   resetActiveLanka,
   startLanka
-} from "../chunk-RYFZCAQ3.js";
-import "../chunk-Q3SOVBIJ.js";
-import "../chunk-FIR4XTBL.js";
-import "../chunk-EWVDJYCC.js";
+} from "../chunk-LMKLLEHA.js";
+import "../chunk-UGXSGQPW.js";
+import "../chunk-5MAQVBI2.js";
+import "../chunk-O5ROO7QF.js";
 import "../chunk-XESL274R.js";
 import "../chunk-UJEC7H6K.js";
-import "../chunk-ILQNYQY5.js";
+import "../chunk-UE2C76OR.js";
 import "../chunk-C2HP7CRD.js";
 import "../chunk-D27MREPB.js";
 import "../chunk-BGVDPDX4.js";