@venizia/ignis-kernel 0.4.2 → 0.4.4

package/dist/cjs/base/applications/rest.d.ts

@@ -1,154 +0,0 @@
-import type { TBindingNamespace } from '../../common/bindings';
-import type { Binding } from '../../helpers/inversion';
-import { OpenAPIHono } from '@hono/zod-openapi';
-import type { IConfigurable, TClass, ValueOrPromise } from '@venizia/ignis-helpers/common';
-import { RequestIdGenerator } from '@venizia/ignis-helpers/core';
-import type { Env, Schema } from 'hono';
-import type { BaseComponent } from '../components';
-import type { BaseConfiguration } from '../configurations';
-import type { IDataSource } from '../datasources';
-import { BaseAppErrorMiddleware } from '../middlewares/app-error/app-error.middleware';
-import type { TMixinOpts } from '../mixins/common';
-import type { IRepository } from '../repositories';
-import type { IService } from '../services';
-import { AbstractApplication } from './abstract';
-import type { IBootSequenceStep } from './boot-sequence';
-import type { IApplicationConfigs, TArtifactIndexInput } from './common';
-interface IRegisterDynamicBindingsOptions<T extends IConfigurable = IConfigurable> {
-    namespace: TBindingNamespace;
-    onBeforeConfigure?: (opts: {
-        binding: Binding<T>;
-    }) => Promise<void>;
-    onAfterConfigure?: (opts: {
-        binding: Binding<T>;
-        instance: T;
-    }) => Promise<void>;
-}
-/** Adds the `OpenAPIHono` router surface on top of `AbstractApplication` - no listening server, so this is the layer a browser Worker or gRPC-only host can extend without pulling in `Bun.serve` / `@hono/node-server`. */
-export declare abstract class RestApplication<AppEnv extends Env = Env, AppSchema extends Schema = {}, BasePath extends string = '/'> extends AbstractApplication {
-    private registeredBindings;
-    private artifactOptions;
-    /** The router, and nothing else. What runtime is underneath and what socket is bound are `ServerApplication`'s to know - a browser Worker has neither, and carrying the union here made `RuntimeModules.detect()` answer `'node'` inside a Worker. */
-    protected server: {
-        hono: OpenAPIHono<AppEnv, AppSchema, BasePath>;
-    };
-    protected rootRouter: OpenAPIHono<AppEnv, AppSchema, BasePath>;
-    protected readonly requestIdGenerator: RequestIdGenerator;
-    /** A copy of the `bodyLimit` the default stack installed, absent until `registerDefaultMiddlewares()` ran. */
-    private installedBodyLimit?;
-    constructor(opts: {
-        scope: string;
-        config: IApplicationConfigs;
-    });
-    getRootRouter(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
-    getServer(): OpenAPIHono<AppEnv, AppSchema, BasePath>;
-    protected registerCoreBindings(): void;
-    /** The correlation id every host stamps - see {@link RequestIdGenerator} for why `crypto.randomUUID` is refused. */
-    protected generateRequestId(): string;
-    /** The error handler the default stack installs. `@venizia/ignis` overrides it to swap in the `ErrorPrettier`-backed formatter, which reaches `node:util` and so cannot live here. */
-    protected buildErrorMiddleware(): BaseAppErrorMiddleware;
-    /**
-     * The three registrations every host needs: request id, error envelope, JSON 404 - without them a
-     * thrown `ApplicationError` is a generic 500, a 404 is `text/plain`, and no response carries a request id.
-     * Registered before `initialize()`, so an application's own handlers still win.
-     */
-    protected registerDefaultMiddlewares(): ValueOrPromise<void>;
-    /** What a `bodyLimit` config installs: nothing when absent or disabled, else a copy, so a later in-place edit shows. */
-    private toInstalledBodyLimit;
-    private isSameBodyLimit;
-    /**
-     * `configs.middlewares` is read by `registerDefaultMiddlewares()`, which runs before `staticConfigure()`.
-     * A limit assigned in a boot hook would read back as configured while every request ran unlimited.
-     */
-    private assertBodyLimitUnchanged;
-    /**
-     * The artifact order, stated once: datasources before the repositories that auto-resolve them,
-     * components before the controllers they may contribute. `BaseApplication` splices its server-only
-     * steps around these by name instead of rewriting the list.
-     */
-    protected getBootSequence(): IBootSequenceStep[];
-    initialize(): Promise<void>;
-    /** The application hook currently running, so `registerArtifact` can tell a hand registration inside `preConfigure`/`postConfigure` from one the index step made. */
-    private runningApplicationHook;
-    private runApplicationHook;
-    /**
-     * Bound keys carrying one of `tags` that nothing has resolved since the counts were last reset.
-     * The counter answers "who was read", never "who is dead" - an unread binding may be an
-     * allow-list entry or a technical floor, and only the application can tell those apart.
-     *
-     * Counting is off by default. Call `startResolutionCounting()` after `initialize()` and run the
-     * traffic that exercises the application, then read this.
-     */
-    getUnresolvedBindings(opts?: {
-        tags?: string[];
-    }): string[];
-    /** `bootChecks.binding.doVerify`: resolve every service and repository once, collect every failure, throw once with the whole list - a made-up `@inject` key or a dependency a `when` excluded then fails the boot, not the first request. */
-    protected verifyBindings(): void;
-    /** One measured log line per step, and a failure names its step before rethrowing, so a hung or failed boot is attributable without reading the sequence. */
-    protected runBootSequence(opts: {
-        steps: IBootSequenceStep[];
-    }): Promise<void>;
-    protected inspectRoutes(): void;
-    /**
-     * `configured` is the drain's state, mutated in place: a fresh `Set` gives a one-shot complete
-     * drain (`RestComponent`); `registerDynamicBindings` passes its persistent per-namespace `Set`,
-     * which is why a second sweep touches only what the first one missed.
-     */
-    drainByTag<T>(opts: {
-        tag: string;
-        configured: Set<string>;
-        onEach: (opts: {
-            binding: Binding<T>;
-        }) => Promise<void>;
-    }): Promise<void>;
-    protected registerDynamicBindings<T extends IConfigurable = IConfigurable>(opts: IRegisterDynamicBindingsOptions<T>): Promise<void>;
-    /** The same-key guard behind every artifact registration (`component`/`controller`/`service`/`repository`/`dataSource`). `allowOverride` defaults true to match `bind()`'s overwrite behavior; `allowOverride: false` on one registration, or `bootChecks.binding.allowOverride: false` for the whole application, opts into strict mode. */
-    protected assertNoBindingCollision(opts: {
-        key: string;
-        allowOverride?: boolean;
-        caller: string;
-    }): void;
-    /** Resolution order for every registration: explicit `opts` > the class's `@injectable` defaults > the derived key and the kind's default scope. `order` and `when` are `registerArtifacts`' concern, not this one. */
-    private registerArtifact;
-    configuration<Base extends BaseConfiguration<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
-    registerConfigurations(): Promise<void>;
-    component<Base extends BaseComponent<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
-    registerComponents(): Promise<void>;
-    /**
-     * Second DATASOURCE sweep, for datasources components contributed at any depth. Calls
-     * `registerDynamicBindings` directly: `this.registerDataSources()` is polymorphic and an override
-     * would run twice. Runs after every component, so a component a datasource registers is never configured.
-     */
-    registerContributedDataSources(): Promise<void>;
-    /** REST only - the kernel has no gRPC (it reaches `node:module`). `BaseApplication` adds the gRPC branch on top. */
-    registerControllers(): Promise<void>;
-    /** SINGLETON like `component()`: `RestComponent` mounts the one instance it resolves, so a second resolution must be that instance, not an unmounted twin. */
-    controller<Base>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
-    service<Base extends IService>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
-    repository<Base extends IRepository>(target: TClass<Base>, opts?: TMixinOpts): Binding<Base>;
-    dataSource<Base extends IDataSource<Options>, Options extends object = {}>(target: TClass<Base>, opts?: TMixinOpts<Options>): Binding<Base>;
-    /** The boot step body behind `configs.artifacts`, also callable by hand: registers every kind in dependency order across the given indexes. */
-    registerArtifacts(index: TArtifactIndexInput): Promise<void>;
-    /** Registers every class a stereotype decorated, with no `configs.artifacts` entry anywhere. `when` and `order` apply exactly as they do to a declared index - which is how one process running several applications keeps them apart. */
-    registerDiscoveredArtifacts(): Promise<void>;
-    /**
-     * The artifact boot step. `configs.discoverArtifacts` adds every decorated class in the import
-     * graph; `configs.artifacts` adds exactly what it lists. Both together register the union.
-     *
-     * An absent `artifacts` still registers nothing. Reading it as "register everything" would change
-     * what an existing application boots with, silently, and the failure would surface as ten times
-     * the bindings rather than as an error.
-     */
-    protected registerConfiguredArtifacts(): Promise<void>;
-    /** Each `@provide` method becomes a lazy provider: the component is resolved (SINGLETON) and the method called on first `get`, so a provided value may depend on datasources or secrets that do not exist yet at registration time. */
-    private bindProvidedKeys;
-    registerDataSources(): Promise<void>;
-    /**
-     * Closes every datasource the boot configured, so a stopped application holds no pool, socket or
-     * WASM instance. A failure, or a `close()` still pending after `dataSourceCloseTimeoutMs`, is logged
-     * and never stops the rest. A datasource configured by hand is closed by whoever configured it.
-     */
-    protected closeDataSources(): Promise<void>;
-}
-export {};
-//# sourceMappingURL=rest.d.ts.map

package/dist/cjs/base/applications/rest.d.ts.map

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