lanka 1.0.0

package/dist/gateway/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/gateway/request/_abstractions/lanka-request/ALankaRequest.ts","../../src/gateway/request/_abstractions/lanka-transport-request/ALankaTransportRequest.ts","../../src/gateway/transport/lanka-fetch-json-transport/LankaFetchJsonTransport.ts","../../src/gateway/request/lanka-fetch-json-request/LankaFetchJsonRequest.ts","../../src/gateway/_utils/build-lanka-query-params/buildLankaQueryParams.ts","../../src/gateway/_abstractions/lanka-gateway/ALankaGateway.ts","../../src/gateway/_factories/create-lanka-gateway/createLankaGateway.ts","../../src/gateway/transport/lanka-fetch-transport/LankaFetchTransport.ts","../../src/gateway/request/lanka-fetch-request/LankaFetchRequest.ts","../../src/gateway/request/_factories/create-lanka-fetch-request/createLankaFetchRequest.ts","../../src/gateway/request/_factories/create-lanka-fetch-json-request/createLankaFetchJsonRequest.ts","../../src/gateway/transport/lanka-fetch-form-data-transport/LankaFetchFormDataTransport.ts","../../src/gateway/request/lanka-fetch-form-data-request/LankaFetchFormDataRequest.ts","../../src/gateway/request/_factories/create-lanka-fetch-form-data-request/createLankaFetchFormDataRequest.ts"],"sourcesContent":["import type { TLankaErrorHandler } from \"../../../../errors/_types/TLankaErrorHandler\";\nimport type { ILankaRequest } from \"../../../_interfaces/ILankaRequest\";\nimport type { TLankaExecuteOptions } from \"../../../_types/TLankaExecuteOptions\";\nimport { handleLankaApiError } from \"../../../../errors/handle-lanka-api-error/handleLankaApiError\";\nimport { getLankaFlags } from \"../../../../config/get-lanka-flags/getLankaFlags\";\nimport { getLankaHost } from \"../../../../config/get-lanka-host/getLankaHost\";\nimport { lankaHttpInFlight } from \"../../../inflight/lankaHttpInFlight\";\nimport { LankaError } from \"../../../../errors/lanka-error/LankaError\";\nimport { getActiveRuntime } from \"../../../../_internal/active-runtime/activeRuntime\";\nimport { composeLankaRequestMiddleware } from \"../../lankaRequestMiddleware\";\nimport type { ILankaRequestContext } from \"../../lankaRequestMiddleware\";\n\n/**\n * Tags whatever the transport threw with a kind.\n *\n * Here rather than in the transports: `execute` is the single point EVERY\n * request passes through, and tagging in each of the four transports would be\n * four places to forget it.\n *\n * A real `fetch` throws `TypeError` on a broken connection and a `DOMException`\n * named `AbortError` on cancellation; it does not throw on a status code at all.\n *\n * An already-tagged error is NOT re-tagged: a request-policy plugin may report\n * `domain`, and rewriting that to `network` would lose the one thing the kind\n * exists for.\n */\nfunction classifyTransportError(error: unknown, timedOut: boolean): LankaError {\n\tif (LankaError.is(error)) return error;\n\n\t// The name is read off ANYTHING, not only off `Error`.\n\t//\n\t// `DOMException` — how `fetch` reports cancellation — does not extend `Error`\n\t// everywhere: in a browser yes, in jsdom no. An `instanceof Error` check lets\n\t// cancellation past the tagging, and a raw `AbortError` reaches the app with\n\t// neither `kind` nor `status`: retry policy reads it as non-retryable and the\n\t// app as an unknown error, so a cancelled request is shown to the user as a\n\t// failure.\n\tconst name = readErrorName(error);\n\tconst isAbort = name === \"AbortError\" || name === \"TimeoutError\";\n\tif (isAbort) {\n\t\t// Only whoever assembled the lifetime knows who aborted: `AbortSignal` has\n\t\t// one `abort` for everyone. The distinction carries a decision — a timeout\n\t\t// is shown, a cancellation is not.\n\t\tconst timedOutHere = timedOut || name === \"TimeoutError\";\n\t\treturn new LankaError({\n\t\t\tkind: timedOutHere ? \"timeout\" : \"aborted\",\n\t\t\tmessage: timedOutHere ? getLankaHost().timeoutErrorMessage() : readErrorMessage(error),\n\t\t\tcause: error,\n\t\t});\n\t}\n\n\t// `network` ONLY for what looks like a transport failure. A real `fetch`\n\t// throws `TypeError`; everything else comes from code we did not write — the\n\t// app's error handler, a response transformer, a broken plugin — and calling\n\t// that a network failure would invite the user to retry a request that\n\t// arrived and was processed.\n\t//\n\t// Unknown stays unknown and passes through. The framework asserts only what\n\t// it knows.\n\tif (error instanceof TypeError) {\n\t\treturn new LankaError({\n\t\t\tkind: \"network\",\n\t\t\tmessage: getLankaHost().networkErrorMessage(),\n\t\t\tissues: [error.message],\n\t\t\tcause: error,\n\t\t});\n\t}\n\n\treturn error as LankaError;\n}\n\n/** The error name, off `Error`, `DOMException` or anything else carrying one. */\nfunction readErrorName(error: unknown): string | undefined {\n\tif (typeof error !== \"object\" || error === null) return undefined;\n\tconst name: unknown = (error as { name?: unknown }).name;\n\treturn typeof name === \"string\" ? name : undefined;\n}\n\n/**\n * The error text, when there is one.\n *\n * An object without `message` is not stringified: `String({})` yields\n * `[object Object]`, which occupies the message slot and says nothing. Empty is\n * more honest.\n */\nfunction readErrorMessage(error: unknown): string {\n\tif (typeof error === \"string\") return error;\n\tif (typeof error !== \"object\" || error === null) return \"\";\n\tconst message: unknown = (error as { message?: unknown }).message;\n\treturn typeof message === \"string\" ? message : \"\";\n}\n\n/**\n * How a gateway request goes on the wire.\n *\n * A subclass declares one method, `request()`, and does only its own work there:\n * `LankaFetchJsonRequest` returns parsed JSON, `LankaFetchFormDataRequest`\n * returns the whole response, a custom transport returns whatever it likes.\n *\n * Overriding `request()` customises the request flow, failure handling, mock\n * substitution, response transformation and log interception.\n */\nexport abstract class ALankaRequest<TOptions = RequestInit> implements ILankaRequest<TOptions> {\n\tprotected readonly errorHandler?: TLankaErrorHandler;\n\tprotected readonly useMock: boolean;\n\n\tprotected constructor(config: { errorHandler?: TLankaErrorHandler; useMock?: boolean }) {\n\t\tconst flags = getLankaFlags();\n\n\t\t// The default error-body handler lives HERE because the request is the only\n\t\t// thing that sees the `Response`. Put on the gateway it would sit in a field\n\t\t// nobody reads — the request takes the handler from ITS OWN config — and a\n\t\t// consumer passing `errorHandler` to the gateway would get silence.\n\t\t//\n\t\t// The parse is cheap: core reads the body once and takes `message` from it;\n\t\t// backend-specific shapes are parsed by `@lankajs/plugin-http`.\n\t\tthis.errorHandler = config.errorHandler ?? handleLankaApiError;\n\n\t\tthis.useMock = config.useMock ?? flags.isMockMode ?? false;\n\t}\n\n\t/**\n\t * Performs the request and returns its result — a response, JSON or a custom\n\t * type.\n\t *\n\t * @param endpoint Full URL\n\t * @param options Transport-specific options\n\t * @param mockHandler Mock, when there is one\n\t */\n\tprotected abstract request<TReturn = Response>(\n\t\tendpoint: string,\n\t\toptions?: TOptions,\n\t\tmockHandler?: () => Promise<TReturn>,\n\t): Promise<TReturn>;\n\n\t/**\n\t * The single point EVERY gateway request passes through.\n\t *\n\t * Hence the in-flight accounting here: intent prefetch stands down while\n\t * anything else is on the wire. The `finally` matters more than the increment —\n\t * a rejected request that never decremented would disable prefetching for the\n\t * rest of the session.\n\t */\n\tpublic async execute<TReturn = Response>(\n\t\tendpoint: string,\n\t\toptions?: TLankaExecuteOptions<TOptions>,\n\t\tmockHandler?: () => Promise<TReturn>,\n\t): Promise<TReturn> {\n\t\tconst runtime = getActiveRuntime();\n\t\tconst { signal, timeoutMs, ...rest } = (options ?? {}) as TLankaExecuteOptions<TOptions>;\n\t\t// The caller's deadline travels IN THE CONTEXT, not only in the closure:\n\t\t// otherwise a policy assigning deadlines per request class could not tell\n\t\t// \"no deadline given\" from \"given by the caller\" and would override an\n\t\t// explicit request with a blanket default.\n\t\tconst fallbackDeadline = runtime?.requestTimeoutMs;\n\n\t\t// No options passed means none are produced. Destructuring yields `{}` even\n\t\t// from `undefined`, and handing that empty object to the transport would\n\t\t// change the request: \"no options\" and \"empty options\" are different\n\t\t// statements, and the transport is entitled to tell them apart.\n\t\tconst passedOptions: unknown = options === undefined ? undefined : rest;\n\n\t\t/*\n\t\t * The lifetime is assembled PER ATTEMPT, not per call, and that does two\n\t\t * things at once.\n\t\t *\n\t\t * Under retry a shared deadline would start the third attempt with whatever\n\t\t * the first two left, so the retry aborts before reaching the server.\n\t\t *\n\t\t * And it is the only way to let middleware set the deadline: `ctx.timeoutMs`\n\t\t * is read on every attempt, which is how a request-policy plugin assigns a\n\t\t * deadline per request CLASS — a file upload and a list read cannot share\n\t\t * one value.\n\t\t *\n\t\t * Caller cancellation stays end-to-end: one `signal` for all attempts.\n\t\t */\n\t\tlet lastTimedOut = false;\n\n\t\t// Tagging happens INSIDE, around the request itself, not in the outer\n\t\t// catch: middleware must receive an already-tagged error, or a retrying\n\t\t// middleware cannot tell a network failure from a domain rejection and\n\t\t// retries what must not be retried. The outer catch stays as a backstop.\n\t\tconst perform = async (ctx: ILankaRequestContext): Promise<unknown> => {\n\t\t\tconst lifetime = createRequestLifetime(signal, ctx.timeoutMs ?? fallbackDeadline);\n\t\t\ttry {\n\t\t\t\treturn await this.request<TReturn>(\n\t\t\t\t\tctx.endpoint,\n\t\t\t\t\twithSignal(ctx.options, lifetime.signal) as TOptions,\n\t\t\t\t\tmockHandler,\n\t\t\t\t);\n\t\t\t} catch (error) {\n\t\t\t\tlastTimedOut = lifetime.timedOut();\n\t\t\t\tthrow classifyTransportError(error, lastTimedOut);\n\t\t\t} finally {\n\t\t\t\tlifetime.dispose();\n\t\t\t}\n\t\t};\n\n\t\tconst run = composeLankaRequestMiddleware(runtime?.requestMiddleware ?? [], perform);\n\n\t\tlankaHttpInFlight.begin();\n\t\ttry {\n\t\t\t// The chain runs INSIDE the same guard as the request. A catch placed\n\t\t\t// outside would leave a permanent +1 when a plugin throws, disabling\n\t\t\t// prefetch for the rest of the session — the very defect this `finally`\n\t\t\t// exists to prevent.\n\t\t\treturn (await run({\n\t\t\t\tendpoint,\n\t\t\t\toptions: passedOptions,\n\t\t\t\tattempt: 1,\n\t\t\t\ttimeoutMs,\n\t\t\t})) as TReturn;\n\t\t} catch (error) {\n\t\t\tthrow classifyTransportError(error, lastTimedOut);\n\t\t} finally {\n\t\t\tlankaHttpInFlight.end();\n\t\t}\n\t}\n}\n\ninterface IRequestLifetime {\n\treadonly signal: AbortSignal | undefined;\n\t/** Whether OUR timer aborted the request rather than the caller. */\n\ttimedOut(): boolean;\n\tdispose(): void;\n}\n\n/**\n * Combines the caller's signal and our own timeout into one request lifetime.\n *\n * The outcome looks the same — an interrupted request — but the decisions\n * differ: a timeout is shown and offered for retry, a user cancellation is not\n * shown at all. `AbortSignal` does not distinguish them: one `abort`, whose\n * reason belongs to whoever got there first. Hence the private flag.\n *\n * Not `AbortSignal.timeout` alone: it cannot combine with a foreign signal\n * without `AbortSignal.any`, which older engines lack. Assembling by hand works\n * everywhere and costs one listener.\n */\nfunction createRequestLifetime(\n\texternal: AbortSignal | undefined,\n\ttimeoutMs: number | undefined,\n): IRequestLifetime {\n\tif (!external && !timeoutMs) {\n\t\treturn { signal: undefined, timedOut: () => false, dispose: () => undefined };\n\t}\n\n\tconst controller = new AbortController();\n\tlet expired = false;\n\n\tconst timer =\n\t\ttimeoutMs === undefined\n\t\t\t? undefined\n\t\t\t: setTimeout(() => {\n\t\t\t\t\texpired = true;\n\t\t\t\t\tcontroller.abort(new DOMException(\"Request timed out\", \"TimeoutError\"));\n\t\t\t\t}, timeoutMs);\n\n\tconst onExternalAbort = (): void => {\n\t\tcontroller.abort(external?.reason);\n\t};\n\n\tif (external) {\n\t\tif (external.aborted) onExternalAbort();\n\t\telse external.addEventListener(\"abort\", onExternalAbort, { once: true });\n\t}\n\n\treturn {\n\t\tsignal: controller.signal,\n\t\ttimedOut: () => expired,\n\t\tdispose: () => {\n\t\t\tif (timer !== undefined) clearTimeout(timer);\n\t\t\texternal?.removeEventListener(\"abort\", onExternalAbort);\n\t\t},\n\t};\n}\n\n/**\n * Attaches the signal to the options, inventing nothing.\n *\n * With no options and no signal the transport receives `undefined` — exactly\n * what the caller passed. An empty object instead looks harmless but is a\n * different statement, and the transport is entitled to tell them apart.\n */\nfunction withSignal(options: unknown, signal: AbortSignal | undefined): unknown {\n\tif (signal === undefined) return options;\n\treturn { ...(options ?? {}), signal };\n}\n","import { ALankaRequest } from \"../lanka-request/ALankaRequest\";\nimport { LankaError } from \"../../../../errors/lanka-error/LankaError\";\nimport { getLankaFlags } from \"../../../../config/get-lanka-flags/getLankaFlags\";\nimport { getLankaHost } from \"../../../../config/get-lanka-host/getLankaHost\";\nimport type { ILankaTransport } from \"../../../_interfaces/ILankaTransport\";\nimport type { TLankaErrorHandler } from \"../../../../errors/_types/TLankaErrorHandler\";\n\nexport interface ILankaTransportRequestConfig<TOptions> {\n\ttransport?: ILankaTransport<TOptions>;\n\terrorHandler?: TLankaErrorHandler;\n\tuseMock?: boolean;\n}\n\n/**\n * The shape every fetch-backed request has: mock, send, check, parse.\n *\n * The three concrete requests differ in exactly two places — which transport\n * they default to, and how they turn a successful `Response` into a value. Both\n * are parameters of this template, so a fourth kind is a subclass with one\n * method rather than a fourth copy of the sequence.\n */\nexport abstract class ALankaTransportRequest<\n\tTOptions = RequestInit,\n> extends ALankaRequest<TOptions> {\n\tprotected readonly transport: ILankaTransport<TOptions>;\n\n\tprotected constructor(\n\t\tconfig: ILankaTransportRequestConfig<TOptions>,\n\t\tcreateDefaultTransport: () => ILankaTransport<TOptions>,\n\t) {\n\t\tconst flags = getLankaFlags();\n\n\t\tsuper({\n\t\t\terrorHandler: config.errorHandler,\n\t\t\tuseMock: config.useMock ?? flags.isMockMode ?? false,\n\t\t});\n\n\t\tthis.transport = config.transport ?? createDefaultTransport();\n\t}\n\n\tprotected async request<TReturn>(\n\t\tendpoint: string,\n\t\toptions?: TOptions,\n\t\tmockHandler?: () => Promise<TReturn>,\n\t): Promise<TReturn> {\n\t\tif (this.useMock && mockHandler) {\n\t\t\treturn await mockHandler();\n\t\t}\n\n\t\tconst response = await this.transport.request(endpoint, options);\n\t\tif (!response.ok) return await this.refuse(response);\n\n\t\treturn await this.parse<TReturn>(response);\n\t}\n\n\t/**\n\t * Turns a successful response into the value the caller asked for.\n\t *\n\t * The one step that genuinely differs between request kinds.\n\t */\n\tprotected abstract parse<TReturn>(response: Response): Promise<TReturn>;\n\n\t/**\n\t * Refuses an unsuccessful response, and never returns.\n\t *\n\t * `TLankaErrorHandler` is typed `Promise<never>` — a handler must throw. It is\n\t * still CALLED and then followed by a throw, because a handler that breaks its\n\t * contract and returns would otherwise hand `undefined` back as if the request\n\t * had succeeded, and a non-value must never become a value.\n\t */\n\tprotected async refuse(response: Response): Promise<never> {\n\t\tif (this.errorHandler) {\n\t\t\tawait this.errorHandler(response);\n\t\t}\n\n\t\t// Kind `http`, not a bare Error: the server answered, and answered with a\n\t\t// code. Without the kind this reads as a network failure, and the user is\n\t\t// offered a retry of a request that already got a meaningful answer.\n\t\tthrow new LankaError({\n\t\t\tkind: \"http\",\n\t\t\tmessage: getLankaHost().httpErrorMessage(response.status),\n\t\t\tstatus: response.status,\n\t\t});\n\t}\n}\n","import type { ILankaTransport } from \"../../_interfaces/ILankaTransport\";\n\n/**\n * HTTP Fetch JSON transport implementation.\n * Uses native fetch API with JSON-specific headers.\n * Automatically sets Content-Type to application/json for requests with body.\n * For project-specific logic (auth, error handling, etc.), use `request` parameter\n * in Gateway config or create a custom transport.\n */\nexport class LankaFetchJsonTransport implements ILankaTransport<RequestInit> {\n\tasync request(resource: RequestInfo, options?: RequestInit): Promise<Response> {\n\t\t// Only set Content-Type if body exists and is not FormData\n\t\tif (options?.body && !(options.body instanceof FormData)) {\n\t\t\tconst headers = new Headers(options.headers);\n\n\t\t\t// If body is object, stringify it\n\t\t\tlet body = options.body;\n\t\t\tif (\n\t\t\t\ttypeof body === \"object\" &&\n\t\t\t\t!(body instanceof FormData) &&\n\t\t\t\t!(body instanceof Blob)\n\t\t\t) {\n\t\t\t\tbody = JSON.stringify(body);\n\t\t\t}\n\n\t\t\theaders.set(\"Content-Type\", \"application/json\");\n\n\t\t\treturn await fetch(resource, {\n\t\t\t\t...options,\n\t\t\t\theaders,\n\t\t\t\tbody,\n\t\t\t});\n\t\t}\n\n\t\t// No body or FormData - use options as-is\n\t\treturn await fetch(resource, options);\n\t}\n}\n","import { ALankaTransportRequest } from \"../_abstractions/lanka-transport-request/ALankaTransportRequest\";\nimport type { ILankaTransportRequestConfig } from \"../_abstractions/lanka-transport-request/ALankaTransportRequest\";\nimport type { ILankaTransport } from \"../../_interfaces/ILankaTransport\";\nimport { LankaFetchJsonTransport } from \"../../transport/lanka-fetch-json-transport/LankaFetchJsonTransport\";\nimport { LankaError } from \"../../../errors/lanka-error/LankaError\";\n\n/** The JSON request: parses the body, and refuses a body that is not JSON. */\n/**\n * A request kind that answers a parsed JSON body — what most endpoints return.\n *\n * A gateway holds one, and is handed it rather than constructing it, which is\n * what lets a test give the same gateway a transport that never leaves the\n * process. `createLankaFetchJsonRequest()` builds the same class.\n */\nexport class LankaFetchJsonRequest<\n\tTOptions = RequestInit,\n> extends ALankaTransportRequest<TOptions> {\n\tconstructor(config: ILankaTransportRequestConfig<TOptions> = {}) {\n\t\tsuper(config, () => new LankaFetchJsonTransport() as ILankaTransport<TOptions>);\n\t}\n\n\t/**\n\t * Parses the body, or names the failure.\n\t *\n\t * The content type is read for the ERROR MESSAGE only. Using it to choose\n\t * between two parse paths, where the second answers `{}` for any non-empty\n\t * body it cannot parse, fails silently: the caller's schema is the first thing\n\t * to notice, and the caller's SCREEN is where it shows up.\n\t *\n\t * A measured case: a dev server whose `/api` fell through to the SPA fallback\n\t * answered `200 text/html` with `index.html`. Turned into `{}`, the schema\n\t * refused it and a person read a validator's issue list on the sign-in card. A\n\t * body a JSON transport cannot parse is never a value — it is a misrouted\n\t * request, and saying so names the actual failure.\n\t */\n\tprotected async parse<TReturn>(response: Response): Promise<TReturn> {\n\t\tconst contentType = response.headers.get(\"content-type\");\n\n\t\tconst text = await response.text();\n\t\tif (!text) {\n\t\t\treturn undefined as TReturn;\n\t\t}\n\n\t\ttry {\n\t\t\treturn JSON.parse(text) as TReturn;\n\t\t} catch (error) {\n\t\t\t// `schema`, not `network`: the request arrived, the server answered, and\n\t\t\t// the answer was the wrong shape. Not cosmetic — a network failure\n\t\t\t// invites a retry, while retrying a broken contract is pointless and\n\t\t\t// blaming the user for it more so.\n\t\t\tthrow new LankaError({\n\t\t\t\tkind: \"schema\",\n\t\t\t\tmessage:\n\t\t\t\t\t`Failed to parse JSON response (content-type: ${contentType ?? \"none\"}): ` +\n\t\t\t\t\t`${error instanceof Error ? error.message : String(error)}`,\n\t\t\t\tcause: error,\n\t\t\t});\n\t\t}\n\t}\n}\n","import { TLankaQueryParams } from \"../../_types/TLankaQueryParams\";\nimport { TLankaQueryBuilder } from \"../../_types/TLankaQueryBuilder\";\n\n/**\n * The query string a gateway sends, from the object a method was called with.\n *\n * Arrays become `key[]` repeated, nested objects become `key[inner]`: the shape\n * most JSON APIs read back without being told about it.\n *\n * Plain loops over `Object.keys` rather than `Object.entries` and `forEach`: this\n * runs on every request that carries a filter, and the pair array `entries`\n * builds — two allocations per key, thrown away immediately — is a cost with\n * nothing to show for it.\n */\nexport const buildLankaQueryParams: TLankaQueryBuilder = <T extends Record<string, unknown>>(\n\tinput: T,\n): URLSearchParams => {\n\tconst params = new URLSearchParams();\n\n\tconst append = (key: string, value: TLankaQueryParams): void => {\n\t\tif (value == null) return;\n\n\t\tif (Array.isArray(value)) {\n\t\t\t// The bracketed key once for the whole array, not once per element.\n\t\t\tconst itemKey = `${key}[]`;\n\t\t\tfor (let index = 0; index < value.length; index += 1) append(itemKey, value[index]);\n\n\t\t\treturn;\n\t\t}\n\n\t\tif (typeof value === \"object\") {\n\t\t\tconst inner = value as Record<string, TLankaQueryParams>;\n\t\t\tconst innerKeys = Object.keys(inner);\n\n\t\t\tfor (let index = 0; index < innerKeys.length; index += 1) {\n\t\t\t\tconst innerKey = innerKeys[index];\n\t\t\t\tappend(`${key}[${innerKey}]`, inner[innerKey]);\n\t\t\t}\n\n\t\t\treturn;\n\t\t}\n\n\t\tparams.append(key, String(value));\n\t};\n\n\tconst source = input as Record<string, TLankaQueryParams>;\n\tconst keys = Object.keys(source);\n\n\tfor (let index = 0; index < keys.length; index += 1) append(keys[index], source[keys[index]]);\n\n\treturn params;\n};\n","import type { IALankaGatewayConfig } from \"../../_interfaces/IALankaGatewayConfig\";\nimport { lankaLogger } from \"../../../logger/lanka-logger/LankaLogger\";\nimport { LankaFetchJsonRequest } from \"../../request/lanka-fetch-json-request/LankaFetchJsonRequest\";\nimport type { ILankaRequest } from \"../../_interfaces/ILankaRequest\";\nimport type { TLankaExecuteOptions } from \"../../_types/TLankaExecuteOptions\";\nimport { buildLankaQueryParams } from \"../../_utils/build-lanka-query-params/buildLankaQueryParams\";\nimport { TLankaQueryParams } from \"../../_types/TLankaQueryParams\";\nimport { TLankaQueryBuilder } from \"../../_types/TLankaQueryBuilder\";\nimport { getLankaFlags } from \"../../../config/get-lanka-flags/getLankaFlags\";\nimport { getLankaHost } from \"../../../config/get-lanka-host/getLankaHost\";\n\nexport abstract class ALankaGateway<TOptions = RequestInit> {\n\tprotected requestExecutor: ILankaRequest<TOptions>;\n\tprotected queryParamsHandler: TLankaQueryBuilder;\n\n\tprotected readonly useMock: boolean;\n\tprotected readonly basePath: string;\n\n\tprotected constructor(config: IALankaGatewayConfig<TOptions>) {\n\t\tlankaLogger.printGatewayLog(\"Create gateway\", this);\n\t\tconst flags = getLankaFlags();\n\t\tthis.useMock = config.useMock ?? flags.isMockMode ?? false;\n\n\t\t// A gateway with nothing said about transport talks JSON over `fetch`, which\n\t\t// is what almost every one of them does. Supplying a request is how a gateway\n\t\t// stops being ordinary — a raw `Response`, a multipart upload, a transport\n\t\t// that never leaves the process — and that stays a decision rather than a\n\t\t// line every gateway has to carry to be born.\n\t\tthis.requestExecutor = config.request ?? new LankaFetchJsonRequest<TOptions>();\n\n\t\tthis.basePath = config.basePath ?? \"\";\n\t\tthis.queryParamsHandler = config.queryParamsHandler ?? buildLankaQueryParams;\n\t}\n\n\t/**\n\t * Resolves endpoint for request.\n\t * - Absolute paths (starting with \"/\") are returned as-is\n\t * - Relative paths are joined with basePath\n\t * - Query-only strings like \"?a=1\" are attached to basePath\n\t */\n\tprotected endpoint(path: string = \"\"): string {\n\t\t// An absolute URL is detected BEFORE joining with `basePath`, not after:\n\t\t// otherwise `https://other.host/health` first becomes\n\t\t// `/things/https://other.host/health` and there is nothing left to detect.\n\t\tif (isAbsoluteUrl(path)) return path;\n\n\t\treturn this.withApiBase(this.resolvePath(path));\n\t}\n\n\t/**\n\t * Joins `basePath` and the method path.\n\t */\n\tprivate resolvePath(path: string): string {\n\t\tif (!path) return this.basePath;\n\n\t\tif (path.startsWith(\"/\")) return path;\n\n\t\tif (path.startsWith(\"?\")) return `${this.basePath}${path}`;\n\n\t\tconst left = this.basePath.endsWith(\"/\") ? this.basePath.slice(0, -1) : this.basePath;\n\t\tconst right = path.startsWith(\"/\") ? path.slice(1) : path;\n\t\treturn `${left}/${right}`;\n\t}\n\n\t/**\n\t * Prefixes the API base URL from the host contract.\n\t *\n\t * Here rather than in every consumer: otherwise each consumer knows the URL\n\t * and the framework does not, and a realtime plugin would have to know a\n\t * specific application's build.\n\t *\n\t * Declaring the field and not using it would be worse than not declaring it: a\n\t * declaration nothing is built from is a second truth, free to diverge from\n\t * the first.\n\t *\n\t * An absolute URL never reaches here — `endpoint()` filters it out before the\n\t * join.\n\t */\n\tprivate withApiBase(path: string): string {\n\t\tconst base = withoutTrailingSlashes(getLankaHost().apiBaseUrl);\n\t\tif (!base) return path;\n\t\tif (!path) return base;\n\n\t\treturn path.startsWith(\"/\") ? `${base}${path}` : `${base}/${path}`;\n\t}\n\n\tprotected buildQueryParams<T extends object>(params: T): URLSearchParams {\n\t\treturn this.queryParamsHandler(params as Record<string, TLankaQueryParams>);\n\t}\n\n\tprotected async request<TReturn = unknown>(\n\t\tpath: string,\n\t\toptions?: TLankaExecuteOptions<TOptions>,\n\t\tmockHandler?: () => Promise<TReturn>,\n\t): Promise<TReturn> {\n\t\treturn this.requestExecutor.execute<TReturn>(this.endpoint(path), options, mockHandler);\n\t}\n\n\t/**\n\t * Allows to replace request implementation at runtime (e.g. feature flags / tests).\n\t * If you prefer static customization - override `request()` in a subclass.\n\t */\n\tprotected setRequest(request: ILankaRequest<TOptions>): void {\n\t\tthis.requestExecutor = request;\n\t}\n\n\tprotected setQueryParamsHandler(handler: TLankaQueryBuilder): void {\n\t\tthis.queryParamsHandler = handler;\n\t}\n}\n\n/**\n * A scheme plus `//` — a URL that already knows where it is going.\n *\n * A standalone function rather than a method: it is not about a particular\n * gateway, and `endpoint()` needs it before any joining.\n */\nfunction isAbsoluteUrl(path: string): boolean {\n\t// The cheap half first: a scheme needs `://`, and `includes` answers without\n\t// starting the regex engine. Every relative path an application writes — which\n\t// is nearly all of them — stops on this line.\n\tif (!path.includes(\"://\")) return false;\n\n\treturn /^[a-z][a-z\\d+\\-.]*:\\/\\//i.test(path);\n}\n\n/**\n * The API base without its trailing slashes, remembered between calls.\n *\n * The host answers the same string for the life of an application, and trimming\n * it is a regex replace otherwise run on every endpoint of every request. One\n * entry is enough: there is one active host, and a second framework in the same\n * process simply replaces what is remembered here.\n */\nlet lastRawBase: string | null = null;\nlet lastTrimmedBase = \"\";\n\nfunction withoutTrailingSlashes(base: string): string {\n\tif (base !== lastRawBase) {\n\t\tlastRawBase = base;\n\t\tlastTrimmedBase = base.replace(/\\/+$/, \"\");\n\t}\n\n\treturn lastTrimmedBase;\n}\n","import { ALankaGateway } from \"../../_abstractions/lanka-gateway/ALankaGateway\";\nimport type { IALankaGatewayConfig } from \"../../_interfaces/IALankaGatewayConfig\";\nimport type { ILankaGatewayContext } from \"../../_interfaces/ILankaGatewayContext\";\n\n/** What a gateway is built from, whichever style builds it. */\nexport interface ILankaGatewayConfig<\n\tTOptions,\n\tTMethods extends object,\n> extends IALankaGatewayConfig<TOptions> {\n\t/** The endpoints this gateway offers, written over its own surface. */\n\tmethods: (context: ILankaGatewayContext<TOptions>) => TMethods;\n}\n\n/**\n * A gateway, without writing a class.\n *\n * The bridge below is the whole mechanism, and it lives here rather than on the\n * base for two reasons. The language reads `protected` from inside a deriving\n * class body and nowhere else, so a factory outside the hierarchy could only\n * reach the public half — the wrong one. And a `toStyleContext` ON the base\n * would put `TOptions` in a method's parameter position, making the class\n * invariant in it: every `ALankaGateway<unknown>` the locator holds would stop\n * accepting a gateway typed for `RequestInit`.\n *\n * One implementation: what comes back is an instance of `ALankaGateway`, so a\n * behaviour fix reaches both styles at once.\n */\nexport const createLankaGateway = <TOptions, TMethods extends object>(\n\tconfig: ILankaGatewayConfig<TOptions, TMethods>,\n): TMethods => {\n\tclass FunctionalGateway extends ALankaGateway<TOptions> {\n\t\t// The base keeps a protected constructor — it is abstract, and a consumer\n\t\t// reaching for `new ALankaGateway()` would get an object with no endpoints.\n\t\t// A subclass may widen it, and this one is the subclass.\n\t\tpublic constructor(gatewayConfig: IALankaGatewayConfig<TOptions>) {\n\t\t\tsuper(gatewayConfig);\n\t\t}\n\n\t\tpublic build(): TMethods {\n\t\t\treturn config.methods({\n\t\t\t\tendpoint: (path) => this.endpoint(path),\n\t\t\t\trequest: (path, options, mockHandler) => this.request(path, options, mockHandler),\n\t\t\t\tbuildQueryParams: (params) => this.buildQueryParams(params),\n\t\t\t});\n\t\t}\n\t}\n\n\treturn new FunctionalGateway(config).build();\n};\n","import type { ILankaTransport } from \"../../_interfaces/ILankaTransport\";\n\n/**\n * HTTP Fetch transport implementation.\n * Uses native fetch API without any project-specific decorators.\n * For project-specific logic (auth, error handling, etc.), use `request` parameter\n * in Gateway config or create a custom transport.\n */\nexport class LankaFetchTransport implements ILankaTransport<RequestInit> {\n\tasync request(resource: RequestInfo, options?: RequestInit): Promise<Response> {\n\t\treturn await fetch(resource, options);\n\t}\n}\n","import { ALankaTransportRequest } from \"../_abstractions/lanka-transport-request/ALankaTransportRequest\";\nimport type { ILankaTransportRequestConfig } from \"../_abstractions/lanka-transport-request/ALankaTransportRequest\";\nimport type { ILankaTransport } from \"../../_interfaces/ILankaTransport\";\nimport { LankaFetchTransport } from \"../../transport/lanka-fetch-transport/LankaFetchTransport\";\n\n/**\n * The raw request: hands the `Response` back untouched.\n *\n * The minimal, extensible case — a caller wanting headers, a stream or a blob\n * reads them off the response itself.\n */\nexport class LankaFetchRequest<TOptions = RequestInit> extends ALankaTransportRequest<TOptions> {\n\tconstructor(config: ILankaTransportRequestConfig<TOptions> = {}) {\n\t\tsuper(config, () => new LankaFetchTransport() as ILankaTransport<TOptions>);\n\t}\n\n\tprotected parse<TReturn>(response: Response): Promise<TReturn> {\n\t\treturn Promise.resolve(response as unknown as TReturn);\n\t}\n}\n","import { LankaFetchRequest } from \"../../lanka-fetch-request/LankaFetchRequest\";\nimport type { ILankaTransportRequestConfig } from \"../../_abstractions/lanka-transport-request/ALankaTransportRequest\";\n\n/**\n * The functional style of `LankaFetchRequest`: the raw `Response`, for a download or a stream.\n *\n * One line, and that is the point — the factory IS the class, so a behaviour\n * cannot exist in one style and not the other.\n */\nexport const createLankaFetchRequest = <TOptions = RequestInit>(\n\tconfig: ILankaTransportRequestConfig<TOptions> = {},\n): LankaFetchRequest<TOptions> => new LankaFetchRequest<TOptions>(config);\n","import { LankaFetchJsonRequest } from \"../../lanka-fetch-json-request/LankaFetchJsonRequest\";\nimport type { ILankaTransportRequestConfig } from \"../../_abstractions/lanka-transport-request/ALankaTransportRequest\";\n\n/**\n * The functional style of `LankaFetchJsonRequest`: a JSON body, which is what most endpoints answer.\n *\n * One line, and that is the point — the factory IS the class, so a behaviour\n * cannot exist in one style and not the other.\n */\nexport const createLankaFetchJsonRequest = <TOptions = RequestInit>(\n\tconfig: ILankaTransportRequestConfig<TOptions> = {},\n): LankaFetchJsonRequest<TOptions> => new LankaFetchJsonRequest<TOptions>(config);\n","import type { ILankaTransport } from \"../../_interfaces/ILankaTransport\";\n\n/**\n * HTTP Fetch FormData transport implementation.\n * Uses native fetch API optimized for FormData requests.\n * Does not set Content-Type header (browser will set it automatically with boundary).\n * For project-specific logic (auth, error handling, etc.), use `request` parameter\n * in Gateway config or create a custom transport.\n */\nexport class LankaFetchFormDataTransport implements ILankaTransport<RequestInit> {\n\tasync request(resource: RequestInfo, options?: RequestInit): Promise<Response> {\n\t\tconst formDataOptions: RequestInit = { ...options };\n\n\t\t// Remove Content-Type header if body is FormData (browser will set it with boundary)\n\t\tif (formDataOptions.body instanceof FormData && formDataOptions.headers) {\n\t\t\tconst headers = new Headers(formDataOptions.headers);\n\t\t\theaders.delete(\"Content-Type\");\n\t\t\tformDataOptions.headers = headers;\n\t\t}\n\n\t\treturn await fetch(resource, formDataOptions);\n\t}\n}\n","import { ALankaTransportRequest } from \"../_abstractions/lanka-transport-request/ALankaTransportRequest\";\nimport type { ILankaTransportRequestConfig } from \"../_abstractions/lanka-transport-request/ALankaTransportRequest\";\nimport type { ILankaTransport } from \"../../_interfaces/ILankaTransport\";\nimport { LankaFetchFormDataTransport } from \"../../transport/lanka-fetch-form-data-transport/LankaFetchFormDataTransport\";\n\n/**\n * The multipart request: hands the `Response` back untouched.\n *\n * Differs from `LankaFetchRequest` only in its transport — the one that must NOT\n * set `content-type`, because the browser writes it with the boundary and a\n * hand-set header leaves the body unparseable to the server.\n */\nexport class LankaFetchFormDataRequest<\n\tTOptions = RequestInit,\n> extends ALankaTransportRequest<TOptions> {\n\tconstructor(config: ILankaTransportRequestConfig<TOptions> = {}) {\n\t\tsuper(config, () => new LankaFetchFormDataTransport() as ILankaTransport<TOptions>);\n\t}\n\n\tprotected parse<TReturn>(response: Response): Promise<TReturn> {\n\t\treturn Promise.resolve(response as unknown as TReturn);\n\t}\n}\n","import { LankaFetchFormDataRequest } from \"../../lanka-fetch-form-data-request/LankaFetchFormDataRequest\";\nimport type { ILankaTransportRequestConfig } from \"../../_abstractions/lanka-transport-request/ALankaTransportRequest\";\n\n/**\n * The functional style of `LankaFetchFormDataRequest`: a multipart body, for an upload.\n *\n * One line, and that is the point — the factory IS the class, so a behaviour\n * cannot exist in one style and not the other.\n */\nexport const createLankaFetchFormDataRequest = <TOptions = RequestInit>(\n\tconfig: ILankaTransportRequestConfig<TOptions> = {},\n): LankaFetchFormDataRequest<TOptions> => new LankaFetchFormDataRequest<TOptions>(config);\n"],"mappings":"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","names":[]}

package/dist/index.d.ts

@@ -0,0 +1,20 @@
+export { ALankaPlugin, ILankaBootstrapConfig, ILankaInstance, ILankaInstanceConfig, ILankaPlugin, ILankaScenarioBootstrapConfig, ILankaServiceConfig, ILankaStartOptions, TLankaStartConfig, createLanka, resetActiveLanka, startLanka } from './bootstrap/index.js';
+export { ILankaRoleFactory, ILankaRoleOpening, TLankaRoleOpener, defineLankaRole } from './role/index.js';
+export { ILankaHostConfig, createLankaHost, getLankaFlags, getLankaHost } from './config/index.js';
+export { I as ILankaFlags, a as ILankaHost, b as ILankaRuntimeConfig } from './ILankaRuntimeConfig-Vl436GWK.js';
+export { I as ILankaLocatorConfig } from './LankaSharedStoreLocator-MvCpav5F.js';
+export { lankaLogger } from './logger/index.js';
+export { I as ILankaErrorInit, L as LankaError, T as TLankaErrorKind } from './LankaError-B1HtuIkw.js';
+import './createLankaScope-Bc_vChRs.js';
+import './activeRuntime-FcsSJvUg.js';
+import './ILankaScenarioVM-DuCyPoyT.js';
+import './LankaScenarioLocator-BGQHwf3n.js';
+import './ILankaScenarioMetadata-Bu-yggTZ.js';
+import './ALankaGateway-ExlRGT3D.js';
+import './lankaStandardValidator-CL-r-zEV.js';
+import '@standard-schema/spec';
+import './lankaHttpInFlight-Bk1eIuSx.js';
+import './lankaRequestMiddleware-DAC5kCb7.js';
+import './ALankaSharedStore-B7uepuuk.js';
+import 'zustand/vanilla';
+import './ILankaApiError-zI_2bNs0.js';

package/dist/index.js

@@ -0,0 +1,43 @@
+import {
+  defineLankaRole
+} from "./chunk-MDZ42XRH.js";
+import {
+  ALankaPlugin,
+  createLanka,
+  resetActiveLanka,
+  startLanka
+} from "./chunk-RYFZCAQ3.js";
+import "./chunk-Q3SOVBIJ.js";
+import "./chunk-FIR4XTBL.js";
+import "./chunk-EWVDJYCC.js";
+import {
+  createLankaHost
+} from "./chunk-XESL274R.js";
+import "./chunk-UJEC7H6K.js";
+import {
+  LankaError
+} from "./chunk-Q7QESSYF.js";
+import {
+  getLankaHost
+} from "./chunk-RKYKK6MN.js";
+import "./chunk-ILQNYQY5.js";
+import {
+  lankaLogger
+} from "./chunk-C2HP7CRD.js";
+import {
+  getLankaFlags
+} from "./chunk-D27MREPB.js";
+import "./chunk-BGVDPDX4.js";
+export {
+  ALankaPlugin,
+  LankaError,
+  createLanka,
+  createLankaHost,
+  defineLankaRole,
+  getLankaFlags,
+  getLankaHost,
+  lankaLogger,
+  resetActiveLanka,
+  startLanka
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/lankaHttpInFlight-Bk1eIuSx.d.ts

@@ -0,0 +1,43 @@
+/**
+ * Counts the gateway requests currently on the wire.
+ *
+ * Exists for ONE consumer: intent prefetch, which must never compete with a
+ * request the app is actually waiting for. The priority ladder is
+ *
+ *   SSE  >  ordinary request  >  route chunk  >  prefetch
+ *
+ * and prefetch is the only participant that can be dropped for free — the screen
+ * that needs the data fetches it itself. Without a probe the rule could only be
+ * documented, not enforced.
+ *
+ * Deliberately a plain counter, not a queue or a scheduler: it answers "is
+ * anything else in flight right now". It cannot tell a prefetch from an ordinary
+ * read — every request goes through the same `ALankaRequest.execute` — so the
+ * prefetcher subtracts its OWN in-flight count from this total. Accounting lives
+ * at the single choke point, in a `finally`: a rejected request that never
+ * decremented would disable prefetching for the rest of the session.
+ */
+interface ILankaInFlightCounter {
+    /** Called by `ALankaRequest.execute` before sending. */
+    begin(): void;
+    /** Called by `ALankaRequest.execute` in `finally`, on success and on failure. */
+    end(): void;
+    getActiveCount(): number;
+    /**
+     * Notifies of a change in the count. Returns an unsubscribe function.
+     *
+     * What the counter exists for: `@lankajs/plugin-prefetch` stands down while
+     * another request is on the wire, and polling the counter in a loop would be a
+     * poor substitute for a notification.
+     */
+    subscribe(listener: (activeCount: number) => void): () => void;
+}
+/**
+ * Ambient counter: the active instance's, reachable without holding it.
+ *
+ * Used by `ALankaRequest`, which every gateway request passes through and which
+ * has no instance reference. Instance holders read `lanka.inFlight`.
+ */
+declare const lankaHttpInFlight: ILankaInFlightCounter;
+
+export { type ILankaInFlightCounter as I, lankaHttpInFlight as l };

package/dist/lankaRequestMiddleware-DAC5kCb7.d.ts

@@ -0,0 +1,62 @@
+/**
+ * What middleware knows about the request it wraps.
+ *
+ * `options` is deliberately `unknown`: every transport has its own —
+ * `RequestInit` for fetch, something else for the next one. Core does not read
+ * them, it passes them along.
+ */
+interface ILankaRequestContext {
+    readonly endpoint: string;
+    readonly options: unknown;
+    /**
+     * Which attempt this is, counting from one.
+     *
+     * In the context rather than in the middleware itself, because a retry may be
+     * started by someone other than the one counting: an auth refresh restarts the
+     * request, and the retrying middleware must not mistake that for its own
+     * second attempt.
+     */
+    readonly attempt: number;
+    /**
+     * This attempt's deadline, when middleware assigned one.
+     *
+     * Read by CORE before every call into the transport, which is what allows a
+     * deadline per request class: a file upload and a list read cannot share one
+     * value, and the policy knows that difference while the framework does not.
+     */
+    readonly timeoutMs?: number;
+}
+/**
+ * A wrapper around a request.
+ *
+ * ## A wrapper rather than `onRequest` / `onResponse` / `onError`
+ *
+ * Three hooks cannot express RETRY. `onError` can replace an error but cannot
+ * run the request again — and retry plus auth refresh are the two main abilities
+ * a request-policy plugin exists for. A wrapper expresses those and everything
+ * the hooks expressed.
+ *
+ * ## Why the objection to `next()` does not carry over
+ *
+ * On the event bus, middleware that skips `next` SILENCES the event: subscribers
+ * do not run and nothing records it. Here, skipping `next` means returning a
+ * value instead of a request — and the caller receives that value, so the
+ * decision is visible.
+ *
+ * ## Order
+ *
+ * Registered first wraps all the rest: it sees the request before everyone and
+ * the response after everyone — ordinary layer semantics, where "outer" means
+ * outer.
+ */
+type TLankaRequestMiddleware = (ctx: ILankaRequestContext, next: (ctx: ILankaRequestContext) => Promise<unknown>) => Promise<unknown>;
+/**
+ * Folds the chain into one function.
+ *
+ * An empty chain returns `perform` as-is, with no wrappers and no cost: an app
+ * without a request-policy plugin has no middleware at all and must not pay for
+ * their absence.
+ */
+declare function composeLankaRequestMiddleware(middleware: readonly TLankaRequestMiddleware[], perform: (ctx: ILankaRequestContext) => Promise<unknown>): (ctx: ILankaRequestContext) => Promise<unknown>;
+
+export { type ILankaRequestContext as I, type TLankaRequestMiddleware as T, composeLankaRequestMiddleware as c };

package/dist/lankaStandardValidator-CL-r-zEV.d.ts

@@ -0,0 +1,34 @@
+import { StandardSchemaV1 } from '@standard-schema/spec';
+
+type TLankaValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    errors: string[];
+};
+
+/**
+ * Response body validation with any Standard Schema implementation.
+ *
+ * An abstraction typed by one library cannot be implemented by another, which is
+ * the whole reason a validation port exists. Standard Schema is the shared
+ * interface implemented by zod 4, valibot, arktype and others.
+ *
+ * `@standard-schema/spec` contains TYPES ONLY and adds no bytes to a build, so it
+ * is a regular dependency rather than another peer.
+ *
+ * No adapter classes: a schema describes itself, and
+ * `schema["~standard"].validate(data)` is the whole protocol.
+ */
+/** A schema the port understands: any Standard Schema implementation. */
+type TLankaSchema<TOutput = unknown> = StandardSchemaV1<unknown, TOutput>;
+interface ILankaValidator {
+    /** Validates and returns the parsed value, or throws. */
+    validate<TOutput>(schema: TLankaSchema<TOutput>, data: unknown, context: string): TOutput;
+    /** Validates and returns an outcome, throwing nothing. */
+    validateSafe<TOutput>(schema: TLankaSchema<TOutput>, data: unknown): TLankaValidationResult<TOutput>;
+}
+declare const lankaStandardValidator: ILankaValidator;
+
+export { type ILankaValidator as I, type TLankaSchema as T, type TLankaValidationResult as a, lankaStandardValidator as l };

package/dist/locator/index.d.ts

@@ -0,0 +1,282 @@
+export { I as ILankaScope } from '../createLankaScope-Bc_vChRs.js';
+export { a as ILankaLocator, I as ILankaLocatorConfig, c as ILankaSharedStoreLocatorConfig, d as ILankaSingletonLocatorConfig } from '../LankaSharedStoreLocator-MvCpav5F.js';
+import { A as ALankaGateway } from '../ALankaGateway-ExlRGT3D.js';
+import { A as ALankaSharedStore } from '../ALankaSharedStore-B7uepuuk.js';
+import '../lankaStandardValidator-CL-r-zEV.js';
+import '@standard-schema/spec';
+import 'zustand/vanilla';
+
+/**
+ * The singletons this app publishes to `lanka`.
+ *
+ * Add one export line per class; the framework derives the locator from these
+ * exports, so there is nothing else to register.
+ *
+ * @example export { AnalyticsService } from "../src/...";
+ */
+
+declare namespace SingletonsModule {
+  export {  };
+}
+
+/**
+ * The singleton marker: "this class is published by the application in
+ * `lankaSingletons`".
+ *
+ * ## Why a marker when the class is exported anyway
+ *
+ * The other three locators have one: a gateway extends `ALankaGateway`, a
+ * scenario has a `name`, a store extends `ALankaSharedStore`. Without a marker
+ * the selection is "anything that is a function with a prototype", so a stray
+ * export in the barrel — a helper, a companion class, an accidental re-export —
+ * becomes part of the public `lankaSingletons.*`, and a typo in a name is caught
+ * at runtime on first use, far from where it was made.
+ *
+ * ## A base class rather than a field
+ *
+ * A marker field can be put on anything, an object included, and the type would
+ * again stop telling a class from a non-class. Inheritance also gives TypeScript
+ * something it can select on in a mapped type.
+ *
+ * The class is empty deliberately: all it carries is the statement "I am meant
+ * for the locator".
+ */
+declare abstract class ALankaSingleton {
+    /**
+     * A runtime check, for the locator, which cannot see types.
+     *
+     * Looks at the prototype chain rather than the name: names are lost to
+     * minification, and a name check would work only until the build.
+     */
+    static is(candidate: unknown): boolean;
+}
+
+/**
+ * Singleton classes, read from the consumer's barrel.
+ *
+ * Adding one takes two steps and no registration:
+ *
+ * 1. write the class;
+ * 2. add ONE export line to `.lanka_di/lankaSingletons.ts` at the project root.
+ *
+ * The type below is derived from that module's exports, so the property name
+ * and the instance type appear by themselves.
+ */
+
+/**
+ * Turns a PascalCase class name into a camelCase property name: `UserProfile` → `userProfile`.
+ */
+type TPascalToCamelCase$3<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+/** Whether a type is a class constructor. */
+/**
+ * A class marked as a singleton.
+ *
+ * Selecting on "is a constructor" admits anything, so a stray barrel export
+ * silently becomes part of the public `lankaSingletons.*` and a typo is caught at
+ * runtime on first use.
+ */
+type TIsSingletonClass<T> = T extends new () => infer Instance ? Instance extends ALankaSingleton ? true : false : false;
+/**
+ * Builds the singletons type from the barrel's exports.
+ *
+ * Derived automatically; no list has to be maintained by hand.
+ */
+type TLankaSingletons = {
+    [K in keyof typeof SingletonsModule as TIsSingletonClass<(typeof SingletonsModule)[K]> extends true ? TPascalToCamelCase$3<K & string> : never]: (typeof SingletonsModule)[K] extends new () => infer Instance ? Instance : never;
+};
+
+declare const lankaSingletons: TLankaSingletons;
+
+/**
+ * The shared stores this app publishes to `lanka`.
+ *
+ * Add one export line per class; the framework derives the locator from these
+ * exports, so there is nothing else to register.
+ *
+ * @example export { UserSharedStore } from "../src/...";
+ */
+
+declare namespace SharedStoresModule {
+  export {  };
+}
+
+/**
+ * Shared-store classes read from the consumer's barrel.
+ *
+ * Adding one takes two steps and no registration:
+ *
+ * 1. write a class extending `ALankaSharedStore`;
+ * 2. add ONE export line to `.lanka_di/lankaSharedStores.ts` at the project root.
+ *
+ * The type below is derived from that module's exports, so the property name
+ * and the instance type appear by themselves.
+ */
+
+/**
+ * Turns a PascalCase class name into a camelCase property name: `RoleEditorStore` → `roleEditorStore`.
+ */
+type TPascalToCamelCase$2<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+/** Whether the type is a shared-store class. */
+type TIsSharedStoreClass<T> = T extends new () => infer Instance ? Instance extends ALankaSharedStore<object> ? true : false : false;
+/**
+ * Builds the shared-store type from every export of the barrel.
+ *
+ * Derived automatically; no list has to be maintained by hand.
+ */
+type TLankaSharedStores = {
+    [K in keyof typeof SharedStoresModule as TIsSharedStoreClass<(typeof SharedStoresModule)[K]> extends true ? TPascalToCamelCase$2<K & string> : never]: (typeof SharedStoresModule)[K] extends new () => infer Instance ? Instance : never;
+};
+
+/**
+ * Access to every shared store at once.
+ *
+ * An `ALankaSharedStore` subclass appears here by itself once it is exported from
+ * `@lanka_di/SharedStores`. The property is camelCase, the class name PascalCase.
+ */
+declare const lankaSharedStores: TLankaSharedStores;
+
+/**
+ * The gateways this app publishes to `lanka`.
+ *
+ * Add one export line per class; the framework derives the locator from these
+ * exports, so there is nothing else to register.
+ *
+ * @example export { UserGateway } from "../src/...";
+ */
+
+declare namespace GatewaysModule {
+  export {  };
+}
+
+/**
+ * Gateway classes read from the consumer's barrel.
+ *
+ * Adding one takes two steps and no registration:
+ *
+ * 1. write a class extending `ALankaGateway`;
+ * 2. add ONE export line to `.lanka_di/lankaGateways.ts` at the project root.
+ *
+ * The type below is derived from that module's exports, so the property name
+ * and the instance type appear by themselves.
+ */
+
+/**
+ * Turns a PascalCase class name into a camelCase property name: `UserGateway` → `userGateway`.
+ */
+type TPascalToCamelCase$1<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+/** Whether the type is a gateway class — an `ALankaGateway` subclass. */
+type TIsGatewayClass<T> = T extends new () => infer Instance ? Instance extends ALankaGateway<unknown> ? true : false : false;
+/**
+ * Builds the gateway type from every export of the barrel.
+ *
+ * Derived automatically; no list has to be maintained by hand.
+ */
+type TLankaGateways = {
+    [K in keyof typeof GatewaysModule as TIsGatewayClass<(typeof GatewaysModule)[K]> extends true ? TPascalToCamelCase$1<K & string> : never]: (typeof GatewaysModule)[K] extends new () => infer Instance ? Instance : never;
+};
+
+/**
+ * Access to every gateway at once.
+ *
+ * An `ALankaGateway` subclass appears here by itself. The property is camelCase,
+ * the gateway name is PascalCase.
+ *
+ * ```ts
+ * import { lankaGateways } from "lanka";
+ *
+ * const user = await lankaGateways.userGateway.getById(1);
+ * const list = await lankaGateways.companyGateway.getList({ page: 1 });
+ * ```
+ */
+declare const lankaGateways: TLankaGateways;
+
+/**
+ * The scenarios this app publishes to `lanka`.
+ *
+ * Add one export line per class; the framework derives the locator from these
+ * exports, so there is nothing else to register.
+ *
+ * @example export { SessionScenario } from "../src/...";
+ */
+
+declare namespace ScenariosModule {
+  export {  };
+}
+
+/**
+ * Scenario classes read from the consumer's barrel.
+ *
+ * Adding one takes two steps and no registration:
+ *
+ * 1. write a class extending `ALankaScenario`;
+ * 2. add ONE export line to `.lanka_di/lankaScenarios.ts` at the project root.
+ *
+ * The type below is derived from that module's exports, so the property name
+ * and the instance type appear by themselves.
+ */
+
+/**
+ * Turns a PascalCase class name into a camelCase property name: `SessionUpdated` → `sessionUpdated`.
+ */
+type TPascalToCamelCase<S extends string> = S extends `${infer P1}${infer P2}` ? `${Lowercase<P1>}${P2}` : S;
+/** Extracts the scenario name from the constructor. */
+type TExtractScenarioName<T> = T extends new () => infer Instance ? Instance extends {
+    readonly name: infer N;
+} ? N extends string ? N : never : never : never;
+/** Derives the property name from a scenario constructor. */
+type TScenarioPropertyName<T> = TPascalToCamelCase<TExtractScenarioName<T>>;
+/** Whether the type is a scenario class — a constructor yielding a named instance. */
+type TIsScenarioClass<T> = T extends new () => infer Instance ? Instance extends {
+    readonly name: string;
+} ? true : false : false;
+/**
+ * Builds the scenario type from every export of the barrel.
+ *
+ * Derived automatically; no list has to be maintained by hand.
+ */
+type TLankaScenarios = {
+    [K in keyof typeof ScenariosModule as TIsScenarioClass<(typeof ScenariosModule)[K]> extends true ? TScenarioPropertyName<(typeof ScenariosModule)[K]> : never]: (typeof ScenariosModule)[K] extends new () => infer Instance ? Instance : never;
+};
+
+/**
+ * Access to every scenario at once.
+ *
+ * An `ALankaScenario` subclass appears here by itself. The property is camelCase,
+ * the scenario name is PascalCase.
+ *
+ * ```ts
+ * import { lankaScenarios } from "lanka";
+ *
+ * lankaScenarios.sessionUpdated.trigger({ user });
+ * lankaScenarios.usersListRefresh.trigger({ reason: "create" });
+ *
+ * lankaScenarios.usersListRefresh.subscribe((data) => { ... });
+ * ```
+ */
+declare const lankaScenarios: TLankaScenarios;
+
+/**
+ * The functional style of `ALankaSingleton`: a singleton declared by a function.
+ *
+ * A singleton is a role — an application writes many — and this is the same role
+ * the class style declares by extending the marker. What comes back IS a subclass
+ * of `ALankaSingleton`, so the locator discovers it in the consumer's barrel,
+ * builds it on first use and caches it, exactly as it does a hand-written class.
+ *
+ * ```ts
+ * export const PlaygroundClock = createLankaSingleton(() => ({
+ * 	now: () => Date.now(),
+ * }));
+ * ```
+ *
+ * The result is exported under a PascalCase name because it is a class: the
+ * locator resolves `lankaSingletons.playgroundClock` by that export name, and a
+ * camelCase one would read as the instance while being the constructor.
+ *
+ * The builder runs at first resolution, not here — a singleton declared in a
+ * module body must not touch a runtime that does not exist yet. Canon:
+ * `skills/parity/SKILL.md`.
+ */
+declare const createLankaSingleton: <TInstance extends object>(build: () => TInstance) => new () => TInstance;
+
+export { ALankaSingleton, type TLankaGateways, type TLankaScenarios, type TLankaSharedStores, type TLankaSingletons, createLankaSingleton, lankaGateways, lankaScenarios, lankaSharedStores, lankaSingletons };