lanka 1.0.0

package/dist/chunk-Q3SOVBIJ.js

@@ -0,0 +1,176 @@
+import {
+  ALankaScenario,
+  LankaScenarioVMRegistry,
+  LankaScenariosRegistry,
+  Scenarios_exports,
+  lankaEventBus
+} from "./chunk-EWVDJYCC.js";
+import {
+  lankaLogger
+} from "./chunk-C2HP7CRD.js";
+import {
+  getActiveRuntime,
+  requireActiveRuntime
+} from "./chunk-BGVDPDX4.js";
+
+// src/scenario/lanka-scenario-bootstrap/LankaScenarioBootstrap.ts
+var LankaScenarioBootstrap = class {
+  /**
+   * The bootstrapped flag and the set of initialised VMs live on the INSTANCE.
+   *
+   * As static fields, a second framework in the same process would exit
+   * `bootstrap()` on someone else's flag — never starting at all, with no symptom
+   * except that no scenario works.
+   */
+  get state() {
+    return requireActiveRuntime().scenarioState;
+  }
+  isScenarioLayerBootstrapped() {
+    return this.state.bootstrapped;
+  }
+  forceInstantiateAllScenarios() {
+    for (const exported of Object.values(Scenarios_exports)) {
+      if (typeof exported !== "function") continue;
+      try {
+        new exported();
+      } catch {
+      }
+    }
+  }
+  registerScenarioEvents(scenarios) {
+    const registeredEventTypes = /* @__PURE__ */ new Set();
+    scenarios.forEach((scenario) => {
+      if (!registeredEventTypes.has(scenario.eventType)) {
+        registeredEventTypes.add(scenario.eventType);
+        lankaLogger.printScenarioLog("REGISTER SCENARIO EVENT", scenario.name);
+        lankaEventBus.registerEvent(scenario.eventType, {
+          dataType: scenario.dataTypeName,
+          description: `Scenario: ${scenario.name}`,
+          usedBy: [scenario.name],
+          priority: 0
+        });
+      }
+      if (scenario.initialize) {
+        lankaLogger.printScenarioLog("INITIALIZE SCENARIO", scenario.name);
+        scenario.initialize();
+      }
+    });
+  }
+  initializeAlreadyCreatedViewModels() {
+    const viewModels = LankaScenarioVMRegistry.getInstance().getAllViewModels();
+    viewModels.forEach((vm) => {
+      if (!this.state.initialized.has(vm)) {
+        this.state.initialized.add(vm);
+        vm.initializeScenario();
+      }
+    });
+  }
+  /**
+   * Brings up the scenario layer.
+   *
+   * Constructs the scenario classes so they can be collected, declares their
+   * events on the bus, calls `initialize()` where present, and initialises
+   * ViewModels that already exist — which happens in tests and under unusual
+   * import order.
+   *
+   * Idempotent.
+   */
+  bootstrap() {
+    if (this.state.bootstrapped) return;
+    lankaLogger.printScenarioLog("BOOTSTRAP SCENARIOS START");
+    this.forceInstantiateAllScenarios();
+    const registry = LankaScenariosRegistry.getInstance();
+    registry.collectAutoRegisteredScenarios();
+    const scenarios = registry.getAllScenarios();
+    this.registerScenarioEvents(scenarios);
+    this.state.bootstrapped = true;
+    this.initializeAlreadyCreatedViewModels();
+    lankaLogger.printScenarioLog("BOOTSTRAP SCENARIOS FINISH");
+  }
+  /**
+   * Called by a ViewModel factory when the ViewModel declares scenario handlers.
+   *
+   * Registers the ViewModel and, if the layer is already up, initialises it
+   * immediately. Duplicate registration and duplicate initialisation are
+   * impossible.
+   *
+   * @param viewModel What to register
+   * @param name Name for the log
+   */
+  /**
+   * ViewModels DECLARED in this process.
+   *
+   * Module-level deliberately, the same case as the scenario pool: a registry of
+   * DEFINITIONS, not runtime state. Splitting it between instances would be
+   * divergence, not isolation — the classes come from the same modules and both
+   * instances must see one list.
+   *
+   * Two reasons it exists:
+   *
+   * 1. Declaring a ViewModel is a declaration, not work. A screen file creates it
+   *    at module level, and import order decides whether that happens before or
+   *    after `createLanka()`. Requiring a live instance at declaration time
+   *    requires an import order the consumer does not control.
+   * 2. Instances come one after another: every test creates its own. The list is
+   *    NOT drained by the first — otherwise the second instance would know no
+   *    module-level ViewModel and its `dispose()` would not remove their
+   *    subscriptions, so a test would receive events the previous one subscribed
+   *    to.
+   */
+  declaredViewModels = [];
+  /** Registers everything declared into a NEW instance. Called by `createLanka`. */
+  adoptDeclaredViewModels() {
+    for (const { viewModel, name } of [...this.declaredViewModels]) {
+      this.attachViewModel(viewModel, name);
+    }
+  }
+  registerViewModel(viewModel, name) {
+    const isKnown = this.declaredViewModels.some(
+      (declared) => declared.viewModel === viewModel
+    );
+    if (!isKnown) this.declaredViewModels.push({ viewModel, name });
+    if (!getActiveRuntime()) return;
+    this.attachViewModel(viewModel, name);
+  }
+  attachViewModel(viewModel, name) {
+    const registry = LankaScenarioVMRegistry.getInstance();
+    if (registry.isRegistered(viewModel)) {
+      if (name) {
+        lankaLogger.printViewModelLog("VM Already Registered (skipped)", name);
+      }
+      return;
+    }
+    registry.register(viewModel);
+    if (name) {
+      lankaLogger.printViewModelLog("Register Scenario VM", name);
+    }
+    if (this.state.bootstrapped) {
+      if (!this.state.initialized.has(viewModel)) {
+        this.state.initialized.add(viewModel);
+        viewModel.initializeScenario();
+      }
+    }
+  }
+  /**
+   * Resets the whole scenario layer. Without it tests are not isolated.
+   *
+   * Clears the self-registration list, the scenario registry with its metadata,
+   * the ViewModel registry together with all their subscriptions, and the bus —
+   * events and
+   * middleware.
+   */
+  reset() {
+    ALankaScenario.clearAutoRegisteredScenarios();
+    LankaScenariosRegistry.getInstance().clear();
+    LankaScenarioVMRegistry.getInstance().resetAll();
+    lankaEventBus.clearAllEvents();
+    this.state.bootstrapped = false;
+    this.state.initialized = /* @__PURE__ */ new WeakSet();
+  }
+};
+var lankaScenarioBootstrap = new LankaScenarioBootstrap();
+
+export {
+  lankaScenarioBootstrap
+};
+//# sourceMappingURL=chunk-Q3SOVBIJ.js.map

package/dist/chunk-Q3SOVBIJ.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/scenario/lanka-scenario-bootstrap/LankaScenarioBootstrap.ts"],"sourcesContent":["import type { ILankaScenario } from \"../_interfaces/ILankaScenario\";\nimport type { ILankaScenarioVM } from \"../_interfaces/ILankaScenarioVM\";\nimport { LankaScenariosRegistry } from \"../_registries/lanka-scenarios-registry/LankaScenariosRegistry\";\nimport { LankaScenarioVMRegistry } from \"../_registries/lanka-scenario-vm-registry/LankaScenarioVMRegistry\";\nimport { ALankaScenario } from \"../_abstractions/lanka-scenario/ALankaScenario\";\nimport { lankaLogger } from \"../../logger/lanka-logger/LankaLogger\";\n\n/**\n * Brings up the scenario layer — deliberately React-free.\n *\n * Two jobs: declare every scenario's events on the bus as early as possible,\n * before the first ViewModel exists; and let a ViewModel raise its own\n * subscriptions at construction.\n *\n * Called from the application entry point before ViewModels are imported.\n */\n\n// The barrel of every scenario class: what keeps bootstrap in step with the list.\nimport * as ScenariosModule from \"@lanka_di/Scenarios\";\nimport { lankaEventBus } from \"../event-bus/_facades/lanka-event-bus/lankaEventBus\";\nimport {\n\tgetActiveRuntime,\n\trequireActiveRuntime,\n} from \"../../_internal/active-runtime/activeRuntime\";\n\n/**\n * Bootstrapping the scenario layer, for callers with no instance in hand.\n *\n * An ordinary class with an ordinary instance: the declared-ViewModel list below\n * is deliberately shared across instances — every test builds a new framework and\n * module-level ViewModels are declared once — so the single instance IS the\n * shared list, and a second one would be a second list nobody adopts.\n */\nexport class LankaScenarioBootstrap {\n\t/**\n\t * The bootstrapped flag and the set of initialised VMs live on the INSTANCE.\n\t *\n\t * As static fields, a second framework in the same process would exit\n\t * `bootstrap()` on someone else's flag — never starting at all, with no symptom\n\t * except that no scenario works.\n\t */\n\tprivate get state() {\n\t\treturn requireActiveRuntime().scenarioState;\n\t}\n\n\tpublic isScenarioLayerBootstrapped(): boolean {\n\t\treturn this.state.bootstrapped;\n\t}\n\n\tprivate forceInstantiateAllScenarios(): void {\n\t\tfor (const exported of Object.values(ScenariosModule)) {\n\t\t\t// Only class constructors are relevant.\n\t\t\tif (typeof exported !== \"function\") continue;\n\n\t\t\ttry {\n\t\t\t\t// Constructing an ALankaScenario subclass puts it into the\n\t\t\t\t// self-registration pool — see ALankaScenario.\n\t\t\t\tnew (exported as unknown as new () => unknown)();\n\t\t\t} catch {\n\t\t\t\t// Not every export is constructible; skip those.\n\t\t\t}\n\t\t}\n\t}\n\n\tprivate registerScenarioEvents(scenarios: ILankaScenario<unknown>[]): void {\n\t\tconst registeredEventTypes = new Set<string>();\n\n\t\tscenarios.forEach((scenario) => {\n\t\t\tif (!registeredEventTypes.has(scenario.eventType)) {\n\t\t\t\tregisteredEventTypes.add(scenario.eventType);\n\n\t\t\t\tlankaLogger.printScenarioLog(\"REGISTER SCENARIO EVENT\", scenario.name);\n\t\t\t\tlankaEventBus.registerEvent(scenario.eventType, {\n\t\t\t\t\tdataType: scenario.dataTypeName,\n\t\t\t\t\tdescription: `Scenario: ${scenario.name}`,\n\t\t\t\t\tusedBy: [scenario.name],\n\t\t\t\t\tpriority: 0,\n\t\t\t\t});\n\t\t\t}\n\n\t\t\tif (scenario.initialize) {\n\t\t\t\tlankaLogger.printScenarioLog(\"INITIALIZE SCENARIO\", scenario.name);\n\t\t\t\tscenario.initialize();\n\t\t\t}\n\t\t});\n\t}\n\n\tprivate initializeAlreadyCreatedViewModels(): void {\n\t\tconst viewModels = LankaScenarioVMRegistry.getInstance().getAllViewModels();\n\t\tviewModels.forEach((vm) => {\n\t\t\tif (!this.state.initialized.has(vm)) {\n\t\t\t\tthis.state.initialized.add(vm);\n\t\t\t\tvm.initializeScenario();\n\t\t\t}\n\t\t});\n\t}\n\n\t/**\n\t * Brings up the scenario layer.\n\t *\n\t * Constructs the scenario classes so they can be collected, declares their\n\t * events on the bus, calls `initialize()` where present, and initialises\n\t * ViewModels that already exist — which happens in tests and under unusual\n\t * import order.\n\t *\n\t * Idempotent.\n\t */\n\tpublic bootstrap(): void {\n\t\tif (this.state.bootstrapped) return;\n\n\t\tlankaLogger.printScenarioLog(\"BOOTSTRAP SCENARIOS START\");\n\n\t\t// Instances must exist, or the registry has nothing to collect.\n\t\tthis.forceInstantiateAllScenarios();\n\n\t\tconst registry = LankaScenariosRegistry.getInstance();\n\t\tregistry.collectAutoRegisteredScenarios();\n\n\t\tconst scenarios = registry.getAllScenarios();\n\t\tthis.registerScenarioEvents(scenarios);\n\n\t\tthis.state.bootstrapped = true;\n\n\t\t// Some ViewModels may predate bootstrap — in tests, or under unusual import\n\t\t// order; initialise them now.\n\t\tthis.initializeAlreadyCreatedViewModels();\n\n\t\tlankaLogger.printScenarioLog(\"BOOTSTRAP SCENARIOS FINISH\");\n\t}\n\n\t/**\n\t * Called by a ViewModel factory when the ViewModel declares scenario handlers.\n\t *\n\t * Registers the ViewModel and, if the layer is already up, initialises it\n\t * immediately. Duplicate registration and duplicate initialisation are\n\t * impossible.\n\t *\n\t * @param viewModel What to register\n\t * @param name Name for the log\n\t */\n\t/**\n\t * ViewModels DECLARED in this process.\n\t *\n\t * Module-level deliberately, the same case as the scenario pool: a registry of\n\t * DEFINITIONS, not runtime state. Splitting it between instances would be\n\t * divergence, not isolation — the classes come from the same modules and both\n\t * instances must see one list.\n\t *\n\t * Two reasons it exists:\n\t *\n\t * 1. Declaring a ViewModel is a declaration, not work. A screen file creates it\n\t *    at module level, and import order decides whether that happens before or\n\t *    after `createLanka()`. Requiring a live instance at declaration time\n\t *    requires an import order the consumer does not control.\n\t * 2. Instances come one after another: every test creates its own. The list is\n\t *    NOT drained by the first — otherwise the second instance would know no\n\t *    module-level ViewModel and its `dispose()` would not remove their\n\t *    subscriptions, so a test would receive events the previous one subscribed\n\t *    to.\n\t */\n\tprivate readonly declaredViewModels: { viewModel: ILankaScenarioVM; name?: string }[] = [];\n\n\t/** Registers everything declared into a NEW instance. Called by `createLanka`. */\n\tpublic adoptDeclaredViewModels(): void {\n\t\tfor (const { viewModel, name } of [...this.declaredViewModels]) {\n\t\t\tthis.attachViewModel(viewModel, name);\n\t\t}\n\t}\n\n\tpublic registerViewModel(viewModel: ILankaScenarioVM, name?: string): void {\n\t\tconst isKnown = this.declaredViewModels.some(\n\t\t\t(declared) => declared.viewModel === viewModel,\n\t\t);\n\t\tif (!isKnown) this.declaredViewModels.push({ viewModel, name });\n\n\t\t// No instance yet: the declaration came before bootstrap, and whoever\n\t\t// bootstraps will pick it up.\n\t\tif (!getActiveRuntime()) return;\n\n\t\tthis.attachViewModel(viewModel, name);\n\t}\n\n\tprivate attachViewModel(viewModel: ILankaScenarioVM, name?: string): void {\n\t\tconst registry = LankaScenarioVMRegistry.getInstance();\n\n\t\t// Already registered — nothing to do.\n\t\tif (registry.isRegistered(viewModel)) {\n\t\t\tif (name) {\n\t\t\t\tlankaLogger.printViewModelLog(\"VM Already Registered (skipped)\", name);\n\t\t\t}\n\t\t\treturn;\n\t\t}\n\n\t\t// Register it.\n\t\tregistry.register(viewModel);\n\n\t\tif (name) {\n\t\t\tlankaLogger.printViewModelLog(\"Register Scenario VM\", name);\n\t\t}\n\n\t\t// The layer is already up — initialise it now rather than at the next\n\t\t// bootstrap.\n\t\tif (this.state.bootstrapped) {\n\t\t\tif (!this.state.initialized.has(viewModel)) {\n\t\t\t\tthis.state.initialized.add(viewModel);\n\t\t\t\tviewModel.initializeScenario();\n\t\t\t}\n\t\t}\n\t}\n\n\t/**\n\t * Resets the whole scenario layer. Without it tests are not isolated.\n\t *\n\t * Clears the self-registration list, the scenario registry with its metadata,\n\t * the ViewModel registry together with all their subscriptions, and the bus —\n\t * events and\n\t * middleware.\n\t */\n\tpublic reset(): void {\n\t\tALankaScenario.clearAutoRegisteredScenarios();\n\t\tLankaScenariosRegistry.getInstance().clear();\n\t\tLankaScenarioVMRegistry.getInstance().resetAll();\n\t\tlankaEventBus.clearAllEvents();\n\t\tthis.state.bootstrapped = false;\n\t\tthis.state.initialized = new WeakSet<ILankaScenarioVM>();\n\t}\n}\n\n/** The one every caller wants. */\nexport const lankaScenarioBootstrap = new LankaScenarioBootstrap();\n"],"mappings":"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","names":[]}

package/dist/chunk-Q7QESSYF.js

@@ -0,0 +1,49 @@
+// src/errors/lanka-error/LankaError.ts
+var LankaError = class _LankaError extends Error {
+  kind;
+  status;
+  code;
+  issues;
+  /** The parsed error response body; core carries it without reading it. */
+  body;
+  constructor(init) {
+    super(init.message, init.cause === void 0 ? void 0 : { cause: init.cause });
+    this.name = "LankaError";
+    this.kind = init.kind;
+    this.status = init.status;
+    this.code = init.code;
+    this.issues = init.issues;
+    this.body = init.body;
+    Object.setPrototypeOf(this, _LankaError.prototype);
+  }
+  /** The `ILankaApiError` field. The details are the message list. */
+  get errors() {
+    return this.issues ? [...this.issues] : void 0;
+  }
+  /**
+   * Whether to show this to the user.
+   *
+   * A cancelled request is the one failure that must NOT be reported: its cause
+   * is that the user left before the response, and a toast would catch them on
+   * another screen.
+   */
+  get isSilent() {
+    return this.kind === "aborted";
+  }
+  /**
+   * Recognises our error among others.
+   *
+   * Checks the name rather than `instanceof` alone: a consumer may end up with
+   * two copies of the package — adjacent majors in the dependency tree — and
+   * then `instanceof` answers `false` for an error that is ours by every other
+   * sign.
+   */
+  static is(value) {
+    return value instanceof _LankaError || value instanceof Error && value.name === "LankaError";
+  }
+};
+
+export {
+  LankaError
+};
+//# sourceMappingURL=chunk-Q7QESSYF.js.map

package/dist/chunk-Q7QESSYF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/lanka-error/LankaError.ts"],"sourcesContent":["import type { ILankaApiError } from \"../_interfaces/ILankaApiError\";\n\n/**\n * How a request ended.\n *\n * Six kinds rather than one, for one reason: each demands something DIFFERENT of\n * the interface. A distinction that implies no different behaviour is\n * superfluous, which is why there is no seventh.\n */\nexport type TLankaErrorKind =\n\t/** Never reached the server: dropped link, DNS failure, no network. Offer a retry. */\n\t| \"network\"\n\t/** Reached it; the response never came. Also a retry, but a different message. */\n\t| \"timeout\"\n\t/** Cancelled by the caller. Nothing to show: the user left. */\n\t| \"aborted\"\n\t/** The server answered with an error status; what to show depends on it. */\n\t| \"http\"\n\t/** A response arrived in the wrong shape. A break, not the user's fault. */\n\t| \"schema\"\n\t/** The server refused deliberately and named the reason. Show what it said. */\n\t| \"domain\";\n\nexport interface ILankaErrorInit {\n\tkind: TLankaErrorKind;\n\tmessage: string;\n\t/** HTTP status, when there was one. */\n\tstatus?: number;\n\t/** The domain failure code — what the application branches on. */\n\tcode?: string;\n\t/** Details: server messages, or paths to the fields that failed validation. */\n\tissues?: readonly string[];\n\t/**\n\t * The parsed ERROR response body, when there was one and it was JSON.\n\t *\n\t * Travels with the error because a `Response` is read once: without this field\n\t * a plugin extracting the domain failure code would read an already-drained\n\t * stream and get nothing. Core does not look into the body; it carries it.\n\t */\n\tbody?: unknown;\n\t/** The original error, when this one wraps it. */\n\tcause?: unknown;\n}\n\n/**\n * One failure type for every layer of the framework.\n *\n * Without a tagged kind, an app cannot tell a network failure from a timeout,\n * from a broken schema, from a deliberate domain refusal — so it builds its own\n * error contract ON TOP of the framework, and builds it once per application.\n *\n * Implements `ILankaApiError`: `status` and `errors` are present, so code reading\n * them the old way keeps working.\n *\n * What is NOT here: parsing a particular response body format. Which JSON a\n * backend sends is policy, and policy lives in `@lankajs/plugin-http`. Core knows\n * only that it has a failure and must name its kind.\n */\nexport class LankaError extends Error implements ILankaApiError {\n\treadonly kind: TLankaErrorKind;\n\treadonly status?: number;\n\treadonly code?: string;\n\treadonly issues?: readonly string[];\n\t/** The parsed error response body; core carries it without reading it. */\n\treadonly body?: unknown;\n\n\tconstructor(init: ILankaErrorInit) {\n\t\tsuper(init.message, init.cause === undefined ? undefined : { cause: init.cause });\n\t\tthis.name = \"LankaError\";\n\t\tthis.kind = init.kind;\n\t\tthis.status = init.status;\n\t\tthis.code = init.code;\n\t\tthis.issues = init.issues;\n\t\tthis.body = init.body;\n\n\t\t// The prototype chain is pinned explicitly: without it `instanceof` breaks\n\t\t// for a consumer whose bundler downlevels to ES5, and breaks silently —\n\t\t// `catch` simply fails to recognise its own error.\n\t\tObject.setPrototypeOf(this, LankaError.prototype);\n\t}\n\n\t/** The `ILankaApiError` field. The details are the message list. */\n\tget errors(): string[] | undefined {\n\t\treturn this.issues ? [...this.issues] : undefined;\n\t}\n\n\t/**\n\t * Whether to show this to the user.\n\t *\n\t * A cancelled request is the one failure that must NOT be reported: its cause\n\t * is that the user left before the response, and a toast would catch them on\n\t * another screen.\n\t */\n\tget isSilent(): boolean {\n\t\treturn this.kind === \"aborted\";\n\t}\n\n\t/**\n\t * Recognises our error among others.\n\t *\n\t * Checks the name rather than `instanceof` alone: a consumer may end up with\n\t * two copies of the package — adjacent majors in the dependency tree — and\n\t * then `instanceof` answers `false` for an error that is ours by every other\n\t * sign.\n\t */\n\tstatic is(value: unknown): value is LankaError {\n\t\treturn (\n\t\t\tvalue instanceof LankaError || (value instanceof Error && value.name === \"LankaError\")\n\t\t);\n\t}\n}\n"],"mappings":";AA0DO,IAAM,aAAN,MAAM,oBAAmB,MAAgC;AAAA,EACtD;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA;AAAA,EAEA;AAAA,EAET,YAAY,MAAuB;AAClC,UAAM,KAAK,SAAS,KAAK,UAAU,SAAY,SAAY,EAAE,OAAO,KAAK,MAAM,CAAC;AAChF,SAAK,OAAO;AACZ,SAAK,OAAO,KAAK;AACjB,SAAK,SAAS,KAAK;AACnB,SAAK,OAAO,KAAK;AACjB,SAAK,SAAS,KAAK;AACnB,SAAK,OAAO,KAAK;AAKjB,WAAO,eAAe,MAAM,YAAW,SAAS;AAAA,EACjD;AAAA;AAAA,EAGA,IAAI,SAA+B;AAClC,WAAO,KAAK,SAAS,CAAC,GAAG,KAAK,MAAM,IAAI;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EASA,IAAI,WAAoB;AACvB,WAAO,KAAK,SAAS;AAAA,EACtB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,OAAO,GAAG,OAAqC;AAC9C,WACC,iBAAiB,eAAe,iBAAiB,SAAS,MAAM,SAAS;AAAA,EAE3E;AACD;","names":[]}

package/dist/chunk-RKYKK6MN.js

@@ -0,0 +1,19 @@
+import {
+  requireActiveRuntime
+} from "./chunk-BGVDPDX4.js";
+
+// src/config/get-lanka-host/getLankaHost.ts
+function getLankaHost() {
+  const host = requireActiveRuntime().config.host;
+  if (!host) {
+    throw new Error(
+      "lanka used before a host was configured. Call createLanka({ host }): the framework needs the application's HTTP error copy and its API base URL, and neither has a default that would be correct for every application."
+    );
+  }
+  return host;
+}
+
+export {
+  getLankaHost
+};
+//# sourceMappingURL=chunk-RKYKK6MN.js.map

package/dist/chunk-RKYKK6MN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config/get-lanka-host/getLankaHost.ts"],"sourcesContent":["import { requireActiveRuntime } from \"../../_internal/active-runtime/activeRuntime\";\nimport type { ILankaHost } from \"../_interfaces/ILankaHost\";\n\n/**\n * The host of the active instance.\n *\n * Unlike flags, a missing host IS an error: every field of `ILankaHost` is a\n * product decision with no correct default, so there is nothing to fall back to.\n */\nexport function getLankaHost(): ILankaHost {\n\tconst host = requireActiveRuntime().config.host;\n\tif (!host) {\n\t\tthrow new Error(\n\t\t\t\"lanka used before a host was configured. Call createLanka({ host }): the \" +\n\t\t\t\t\"framework needs the application's HTTP error copy and its API base URL, \" +\n\t\t\t\t\"and neither has a default that would be correct for every application.\",\n\t\t);\n\t}\n\treturn host;\n}\n"],"mappings":";;;;;AASO,SAAS,eAA2B;AAC1C,QAAM,OAAO,qBAAqB,EAAE,OAAO;AAC3C,MAAI,CAAC,MAAM;AACV,UAAM,IAAI;AAAA,MACT;AAAA,IAGD;AAAA,EACD;AACA,SAAO;AACR;","names":[]}