@getsoda/core 0.0.0-stage → 0.1.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 falsea3
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,77 @@
-# Temporary Holding Version
+# Soda
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+A class-based web framework for [Bun](https://bun.sh): modules, dependency injection and decorators like [Nest](https://nestjs.com), running on Bun's native router.
+
+- **Standard decorators.** TC39 decorators, no `experimentalDecorators`, no `reflect-metadata`.
+- **Native routing.** Routes compile into `Bun.serve({ routes })`; a route without guards adds ~0.1 ns to calling the handler.
+- **Modules and DI.** `inject()`, providers, async factories, global and dynamic modules, lifecycle hooks. Graph errors are reported at startup with the full resolution chain.
+- **Typed requests.** Path parameters are typed from the route path; bodies are validated with any [Standard Schema](https://standardschema.dev) library (zod, valibot, arktype).
+- **Request pipeline.** Guards, interceptors and exception filters, as classes, instances or functions.
+- **Lifecycle.** Graceful shutdown that drains requests before destroying services, shutdown signals, `bun --hot` support.
+
+> Soda is in early development (0.x): the API may change between minor versions.
+
+## Install
+
+```bash
+bun add @getsoda/core
+```
+
+Requires Bun 1.4 or later. No TypeScript flags are needed for decorators.
+
+## Quick start
+
+```ts
+import { Controller, Get, Module, Post, body, createApp, inject, int, param } from '@getsoda/core'
+import type { Context } from '@getsoda/core'
+import { z } from 'zod'
+
+const CreateUser = z.object({ name: z.string().min(1) })
+
+class UsersService {
+  readonly #users = new Map<number, { id: number; name: string }>()
+
+  find(id: number) {
+    return this.#users.get(id)
+  }
+
+  create(name: string) {
+    const user = { id: this.#users.size + 1, name }
+
+    this.#users.set(user.id, user)
+
+    return user
+  }
+}
+
+@Controller('users')
+class UsersController {
+  readonly #users = inject(UsersService)
+
+  // Ready values, Nest style
+  @Get(':id', [param('id', int())])
+  findOne(id: number) {
+    return this.#users.find(id)
+  }
+
+  // Or read from the context where needed
+  @Post()
+  async create(ctx: Context) {
+    const { name } = await ctx.body(CreateUser)
+
+    return this.#users.create(name)
+  }
+}
+
+@Module({ providers: [UsersService], controllers: [UsersController] })
+class AppModule {}
+
+const app = await createApp(AppModule)
+
+app.enableShutdownSignals()
+await app.listen(3000)
+```
+
+## License
+
+[MIT](./LICENSE)

package/dist/app/app.d.ts

@@ -0,0 +1,70 @@
+/**
+ * @module
+ * The application: container, routes and server, started and stopped together.
+ *
+ * ```ts
+ * const app = await createApp(AppModule, { prefix: '/api' })
+ *
+ * app.enableShutdownSignals()
+ * await app.listen(3000)
+ * ```
+ *
+ * Startup creates the container (every singleton, every `onInit`), then the
+ * guards, interceptors and filters (their `onInit` too), and only then accepts
+ * requests.
+ *
+ * Shutdown stops accepting requests first and waits for the ones in flight,
+ * then runs `onDestroy` (guards and the like, then the container). Nest closes
+ * the server after `onModuleDestroy`, so requests still arrive while services
+ * are being destroyed; here they cannot.
+ */
+import type { Container, ContainerOptions, ModuleImport } from '../di/index.ts';
+import type { ControllerRoutesOptions } from '../http/index.ts';
+import type { CompiledRoutes, CompileOptions } from '../routing/index.ts';
+/**
+ * Options of `createApp`.
+ */
+export interface AppOptions extends ContainerOptions, ControllerRoutesOptions, CompileOptions {
+}
+/**
+ * Where to listen. `port: 0` picks a free port.
+ */
+export interface ListenOptions {
+    readonly port?: number;
+    readonly hostname?: string;
+}
+/**
+ * A created application.
+ */
+export interface App {
+    readonly container: Container;
+    /** Routes for `Bun.serve()`, when serving them yourself instead of calling `listen()`. */
+    readonly routes: CompiledRoutes;
+    /** The server once `listen()` resolved. */
+    readonly server: Bun.Server<undefined> | undefined;
+    /**
+     * Starts serving. Under `bun --hot`, a new version of the application
+     * listening on the same port takes the server over from the previous one,
+     * which is then destroyed (its server is not stopped: it is shared).
+     */
+    listen(options?: number | ListenOptions): Promise<Bun.Server<undefined>>;
+    /**
+     * Graceful shutdown: refuses new requests, waits for those in flight, then
+     * runs `onDestroy` hooks. Safe to call more than once, even from a hook.
+     */
+    close(): Promise<void>;
+    /**
+     * Closes the application on `SIGTERM` and `SIGINT` (or `signals`), then lets
+     * the signal terminate the process. Off by default, as Nest's `enableShutdownHooks()`.
+     */
+    enableShutdownSignals(signals?: readonly NodeJS.Signals[]): this;
+}
+/**
+ * Creates the container and the routes, and runs every `onInit` hook.
+ *
+ * If anything fails, what was created is destroyed and the error is rethrown;
+ * if destroying fails too, everything comes as one `AggregateError`, startup
+ * error first, as `createContainer` does.
+ */
+export declare const createApp: (root: ModuleImport, options?: AppOptions) => Promise<App>;
+//# sourceMappingURL=app.d.ts.map

package/dist/app/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/app/app.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAGH,OAAO,KAAK,EAAE,SAAS,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAA;AAG/E,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAA;AAE/D,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzE;;GAEG;AACH,MAAM,WAAW,UAAW,SAAQ,gBAAgB,EAAE,uBAAuB,EAAE,cAAc;CAAG;AAEhG;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;CAC3B;AAKD;;GAEG;AACH,MAAM,WAAW,GAAG;IAClB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAA;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;IAC/B,2CAA2C;IAC3C,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,SAAS,CAAA;IAClD;;;;OAIG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAA;IACxE;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;IACtB;;;OAGG;IACH,qBAAqB,CAAC,OAAO,CAAC,EAAE,SAAS,MAAM,CAAC,OAAO,EAAE,GAAG,IAAI,CAAA;CACjE;AAyJD;;;;;;GAMG;AACH,eAAO,MAAM,SAAS,SAAgB,YAAY,YAAW,UAAU,KAAQ,OAAO,CAAC,GAAG,CAoBzF,CAAA"}

package/dist/app/app.js

@@ -0,0 +1,173 @@
+/**
+ * @module
+ * The application: container, routes and server, started and stopped together.
+ *
+ * ```ts
+ * const app = await createApp(AppModule, { prefix: '/api' })
+ *
+ * app.enableShutdownSignals()
+ * await app.listen(3000)
+ * ```
+ *
+ * Startup creates the container (every singleton, every `onInit`), then the
+ * guards, interceptors and filters (their `onInit` too), and only then accepts
+ * requests.
+ *
+ * Shutdown stops accepting requests first and waits for the ones in flight,
+ * then runs `onDestroy` (guards and the like, then the container). Nest closes
+ * the server after `onModuleDestroy`, so requests still arrive while services
+ * are being destroyed; here they cannot.
+ */
+import { createContainer } from '../di/index.js';
+import { destroyAll, initializeAll } from '../di/lifecycle.js';
+import { buildRoutes } from '../http/index.js';
+import { compileRoutes } from '../routing/index.js';
+import { release, takeOver } from './hot.js';
+/** Signals `enableShutdownSignals()` listens to by default. */
+const DEFAULT_SIGNALS = ['SIGTERM', 'SIGINT'];
+class Application {
+    container;
+    routes;
+    #server;
+    /** Set when a new version took the server over: it must not be stopped. */
+    #handedOver = false;
+    #closing;
+    #enhancers;
+    #signals = new Map();
+    constructor(container, routes, enhancers) {
+        this.container = container;
+        this.routes = routes;
+        this.#enhancers = enhancers;
+    }
+    get server() {
+        return this.#server;
+    }
+    async listen(options = {}) {
+        if (this.#closing !== undefined) {
+            throw new Error('Cannot listen: the application is closed');
+        }
+        if (this.#server !== undefined) {
+            throw new Error(`The application already listens on ${this.#server.url.href}`);
+        }
+        const { port = 0, hostname } = typeof options === 'number' ? { port: options } : options;
+        const server = Bun.serve({ port, hostname, ...this.routes });
+        this.#server = server;
+        if (server.port !== undefined) {
+            await takeOver(server.port, this);
+        }
+        return server;
+    }
+    /** Destroys this version without stopping the server a newer version now uses. */
+    handOver() {
+        this.#handedOver = true;
+        return this.close();
+    }
+    close() {
+        if (this.#closing === undefined) {
+            // Assigned before anything runs, so a hook calling close() gets this promise.
+            const { promise, resolve, reject } = Promise.withResolvers();
+            this.#closing = promise;
+            this.#shutdown().then(resolve, reject);
+        }
+        return this.#closing;
+    }
+    enableShutdownSignals(signals = DEFAULT_SIGNALS) {
+        for (const signal of signals) {
+            if (this.#signals.has(signal)) {
+                continue;
+            }
+            const listener = () => {
+                // A second signal while closing is ignored: the first one finishes the job.
+                if (this.#closing !== undefined) {
+                    return;
+                }
+                this.close().then(() => {
+                    this.#removeSignalListeners();
+                    // Terminate as the signal would have, exit code included.
+                    process.kill(process.pid, signal);
+                }, (error) => {
+                    console.error('Error during shutdown', error);
+                    process.exit(1);
+                });
+            };
+            this.#signals.set(signal, listener);
+            process.on(signal, listener);
+        }
+        return this;
+    }
+    async #shutdown() {
+        const server = this.#server;
+        try {
+            if (server !== undefined && !this.#handedOver) {
+                await server.stop();
+            }
+            await destroyEverything(this.#enhancers, this.container);
+        }
+        finally {
+            // Whatever happened, signals get their default behaviour back.
+            this.#removeSignalListeners();
+            if (server?.port !== undefined) {
+                release(server.port, this);
+            }
+        }
+    }
+    #removeSignalListeners() {
+        for (const [signal, listener] of this.#signals) {
+            process.off(signal, listener);
+        }
+        this.#signals.clear();
+    }
+}
+const errorsOf = (error) => (error instanceof AggregateError ? error.errors : [error]);
+/**
+ * Destroys guards and the like, then the container; every hook runs.
+ * One failure is rethrown as is, several as an `AggregateError`.
+ */
+const destroyEverything = async (enhancers, container) => {
+    const errors = [];
+    try {
+        await destroyAll(enhancers);
+    }
+    catch (error) {
+        errors.push(...errorsOf(error));
+    }
+    try {
+        await container.close();
+    }
+    catch (error) {
+        errors.push(...errorsOf(error));
+    }
+    if (errors.length === 1) {
+        throw errors[0];
+    }
+    if (errors.length > 1) {
+        throw new AggregateError(errors, `${errors.length} onDestroy hooks failed`);
+    }
+};
+/**
+ * Creates the container and the routes, and runs every `onInit` hook.
+ *
+ * If anything fails, what was created is destroyed and the error is rethrown;
+ * if destroying fails too, everything comes as one `AggregateError`, startup
+ * error first, as `createContainer` does.
+ */
+export const createApp = async (root, options = {}) => {
+    const container = await createContainer(root, options);
+    let enhancers = [];
+    try {
+        const built = buildRoutes(container, options);
+        enhancers = built.enhancers;
+        await initializeAll(enhancers);
+        return new Application(container, compileRoutes(built.routes, options), enhancers);
+    }
+    catch (error) {
+        try {
+            await destroyEverything(enhancers, container);
+        }
+        catch (destroyError) {
+            throw new AggregateError([error, ...errorsOf(destroyError)], 'Startup failed, and onDestroy hooks failed while rolling back');
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=app.js.map

package/dist/app/app.js.map

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

package/dist/app/hot.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @module
+ * Hot reload support for `bun --hot`.
+ *
+ * Under `--hot`, Bun re-evaluates the changed modules in the same process:
+ * `globalThis` survives, a second `Bun.serve()` on the same port reuses the
+ * running server instead of failing, and there is no hook telling the old
+ * module it is unloaded (`import.meta.hot` does not exist on the server).
+ * So the previous application, with its timers and connections, would stay
+ * alive forever.
+ *
+ * Applications that listen are registered here by port, in `globalThis`; a new
+ * application listening on a port takes it over and destroys the previous one
+ * without stopping the server they share. Without `--hot`, two applications
+ * cannot listen on the same port, so this never happens.
+ *
+ * Requests the old version is still serving at that moment may meet its
+ * destroyed services: a development-only window, as with any hot reload.
+ */
+/** What the registry needs from an application. */
+export interface HotApp {
+    /** Destroys the application without stopping its server. */
+    handOver(): Promise<void>;
+}
+/**
+ * Registers `app` as listening on `port`, destroying the application that listened there before.
+ */
+export declare const takeOver: (port: number, app: HotApp) => Promise<void>;
+/**
+ * Unregisters `app` from `port`, unless another application already took it over.
+ */
+export declare const release: (port: number, app: HotApp) => void;
+//# sourceMappingURL=hot.d.ts.map

package/dist/app/hot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot.d.ts","sourceRoot":"","sources":["../../src/app/hot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,mDAAmD;AACnD,MAAM,WAAW,MAAM;IACrB,4DAA4D;IAC5D,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CAC1B;AAYD;;GAEG;AACH,eAAO,MAAM,QAAQ,SAAgB,MAAM,OAAO,MAAM,KAAG,OAAO,CAAC,IAAI,CAStE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,OAAO,SAAU,MAAM,OAAO,MAAM,KAAG,IAMnD,CAAA"}

package/dist/app/hot.js

@@ -0,0 +1,46 @@
+/**
+ * @module
+ * Hot reload support for `bun --hot`.
+ *
+ * Under `--hot`, Bun re-evaluates the changed modules in the same process:
+ * `globalThis` survives, a second `Bun.serve()` on the same port reuses the
+ * running server instead of failing, and there is no hook telling the old
+ * module it is unloaded (`import.meta.hot` does not exist on the server).
+ * So the previous application, with its timers and connections, would stay
+ * alive forever.
+ *
+ * Applications that listen are registered here by port, in `globalThis`; a new
+ * application listening on a port takes it over and destroys the previous one
+ * without stopping the server they share. Without `--hot`, two applications
+ * cannot listen on the same port, so this never happens.
+ *
+ * Requests the old version is still serving at that moment may meet its
+ * destroyed services: a development-only window, as with any hot reload.
+ */
+const REGISTRY = Symbol.for('soda.app.listening');
+const registry = () => {
+    const holder = globalThis;
+    holder[REGISTRY] ??= new Map();
+    return holder[REGISTRY];
+};
+/**
+ * Registers `app` as listening on `port`, destroying the application that listened there before.
+ */
+export const takeOver = async (port, app) => {
+    const apps = registry();
+    const previous = apps.get(port);
+    apps.set(port, app);
+    if (previous !== undefined && previous !== app) {
+        await previous.handOver();
+    }
+};
+/**
+ * Unregisters `app` from `port`, unless another application already took it over.
+ */
+export const release = (port, app) => {
+    const apps = registry();
+    if (apps.get(port) === app) {
+        apps.delete(port);
+    }
+};
+//# sourceMappingURL=hot.js.map

package/dist/app/hot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hot.js","sourceRoot":"","sources":["../../src/app/hot.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAQH,MAAM,QAAQ,GAAG,MAAM,CAAC,GAAG,CAAC,oBAAoB,CAAC,CAAA;AAEjD,MAAM,QAAQ,GAAG,GAAwB,EAAE;IACzC,MAAM,MAAM,GAAG,UAAsE,CAAA;IAErF,MAAM,CAAC,QAAQ,CAAC,KAAK,IAAI,GAAG,EAAE,CAAA;IAE9B,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAA;AACzB,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,KAAK,EAAE,IAAY,EAAE,GAAW,EAAiB,EAAE;IACzE,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;IACvB,MAAM,QAAQ,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAA;IAE/B,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAA;IAEnB,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,GAAG,EAAE,CAAC;QAC/C,MAAM,QAAQ,CAAC,QAAQ,EAAE,CAAA;IAC3B,CAAC;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,IAAY,EAAE,GAAW,EAAQ,EAAE;IACzD,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;IAEvB,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,GAAG,EAAE,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAA;IACnB,CAAC;AACH,CAAC,CAAA"}

package/dist/app/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @module
+ * The application: container, routes and server, started and stopped together.
+ */
+export { createApp } from './app.ts';
+export type { App, AppOptions, ListenOptions } from './app.ts';
+//# sourceMappingURL=index.d.ts.map

package/dist/app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA;AACpC,YAAY,EAAE,GAAG,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,UAAU,CAAA"}

package/dist/app/index.js

@@ -0,0 +1,6 @@
+/**
+ * @module
+ * The application: container, routes and server, started and stopped together.
+ */
+export { createApp } from './app.js';
+//# sourceMappingURL=index.js.map

package/dist/app/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/app/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAA"}

package/dist/di/container.d.ts

@@ -0,0 +1,93 @@
+/**
+ * @module
+ * The container: creates every singleton at startup, runs lifecycle hooks, resolves tokens.
+ *
+ * Startup, in `createContainer`:
+ *
+ * 1. Build the module graph and validate it (awaiting `Promise<DynamicModule>` imports).
+ * 2. Run singleton factories, awaiting async ones. Their dependencies are
+ *    declared in `inject: [...]`, so the async part of the graph is static.
+ * 3. Create every other singleton (providers, controllers, module classes),
+ *    synchronously; `inject()` resolves dependencies, creating them on demand.
+ * 4. Call `onInit` on everything created, dependencies first.
+ *
+ * Any failure destroys what was created, in reverse order, and rejects.
+ * Nothing is resolved lazily on the request path: once the container is
+ * returned, every singleton exists.
+ */
+import type { ModuleClass, ModuleImport } from './decorators.ts';
+import type { Provider } from './provider.ts';
+import type { Constructor, Token } from './token.ts';
+/**
+ * Options of `createContainer`.
+ */
+export interface ContainerOptions {
+    /**
+     * Providers replacing those of the same token everywhere in the graph, for tests.
+     * An override that matches no provider is an error.
+     *
+     * ```ts
+     * await createContainer(AppModule, { overrides: [provide(Database, { useValue: fakeDatabase })] })
+     * ```
+     */
+    readonly overrides?: readonly Provider[];
+}
+/**
+ * Options of `container.get()` and `container.runInContext()`.
+ */
+export interface ResolveOptions {
+    /** Module to resolve from, instead of the root module. */
+    readonly from?: ModuleClass;
+}
+/**
+ * A controller created by the container, with the module that owns it.
+ */
+export interface ControllerEntry {
+    readonly module: ModuleClass;
+    readonly controller: Constructor<unknown>;
+    readonly instance: unknown;
+    /**
+     * Runs `fn` where `inject()` resolves from the controller's module, as Nest
+     * resolves guards and interceptors from the module of their controller.
+     */
+    readonly runInContext: <R>(fn: () => R) => R;
+}
+/**
+ * A started container.
+ */
+export interface Container {
+    /** Resolves `token` as `inject()` would inside the root module, or inside `options.from`. */
+    get<T>(token: Token<T>, options?: ResolveOptions & {
+        readonly optional?: false;
+    }): T;
+    get<T>(token: Token<T>, options: ResolveOptions & {
+        readonly optional: true;
+    }): T | undefined;
+    /**
+     * Runs `fn` where `inject()` works, as if it were created by the root module
+     * (or `options.from`): for functional guards, middleware and the like.
+     */
+    runInContext<R>(fn: () => R, options?: ResolveOptions): R;
+    /** Every controller, in module order. */
+    readonly controllers: readonly ControllerEntry[];
+    /**
+     * Calls `onDestroy` in reverse creation order, then releases every instance.
+     * Calling it again, even from an `onDestroy` hook, returns the same promise.
+     */
+    close(): Promise<void>;
+}
+/**
+ * Builds the graph rooted at `root`, creates every singleton and runs `onInit` hooks.
+ *
+ * ```ts
+ * const container = await createContainer(AppModule)
+ * const users = container.get(UsersService)
+ * await container.close()
+ * ```
+ *
+ * Rejects with `DiError` on graph problems. If startup fails after something was
+ * created, `onDestroy` runs for it first and the startup error is rethrown; if
+ * hooks fail too, everything is rethrown as one `AggregateError`, startup error first.
+ */
+export declare const createContainer: (root: ModuleImport, options?: ContainerOptions) => Promise<Container>;
+//# sourceMappingURL=container.d.ts.map

package/dist/di/container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"container.d.ts","sourceRoot":"","sources":["../../src/di/container.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAKhE,OAAO,KAAK,EAAE,QAAQ,EAAsB,MAAM,eAAe,CAAA;AAEjE,OAAO,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAIpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;;;;;;OAOG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,QAAQ,EAAE,CAAA;CACzC;AAED;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,0DAA0D;IAC1D,QAAQ,CAAC,IAAI,CAAC,EAAE,WAAW,CAAA;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;IAC5B,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,OAAO,CAAC,CAAA;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC1B;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,CAAA;CAC7C;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,6FAA6F;IAC7F,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,QAAQ,CAAC,EAAE,KAAK,CAAA;KAAE,GAAG,CAAC,CAAA;IACpF,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,cAAc,GAAG;QAAE,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAA;KAAE,GAAG,CAAC,GAAG,SAAS,CAAA;IAC7F;;;OAGG;IACH,YAAY,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,CAAC,CAAA;IACzD,yCAAyC;IACzC,QAAQ,CAAC,WAAW,EAAE,SAAS,eAAe,EAAE,CAAA;IAChD;;;OAGG;IACH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACvB;AAwaD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,eAAe,SAAgB,YAAY,YAAW,gBAAgB,KAAQ,OAAO,CAAC,SAAS,CA0B3G,CAAA"}