@toijs/modular 1.0.3 → 1.0.6

package/README.md

@@ -0,0 +1,403 @@
+# @toijs/modular
+
+Compose TypeScript applications with an isomorphic module pattern, explicit DI, and Shell — on Node.js and in the browser.
+[![npm version](https://img.shields.io/npm/v/@toijs/modular.svg)](https://www.npmjs.com/package/@toijs/modular)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.9-3178C6.svg)](https://www.typescriptlang.org/)
+[![ESM](https://img.shields.io/badge/module-ESM-brightgreen.svg)](https://nodejs.org/api/esm.html)
+[![GitHub](https://img.shields.io/badge/github-toijs%2Fframework-181717.svg)](https://github.com/toijs/framework)
+
+## Overview
+
+`@toijs/modular` is an isomorphic **composition pattern** for TypeScript: modules, explicit dependency injection, a bootstrap lifecycle, and a small runtime (`Task`, `Config`, `Metadata`, `Shell`). Use it on **Node.js servers** and in **browser clients**. App hosts (Express, Vue, React, …) plug in through **Shell** kits — this package never embeds HTTP or UI.
+
+It does **not** include HTTP, routing, validation, GraphQL, an ORM, or a renderer. Those belong in the application or in separate kits such as `@toijs/express-kit`, `@toijs/vue-kit`, and `@toijs/typeorm`.
+
+## Why @toijs/modular?
+
+Most TypeScript backends either assemble everything by hand or adopt a full platform such as NestJS. Frontends often wire Pinia/Vuex/React context ad hoc. `@toijs/modular` sits between those options: one composition model for server and client, without inheriting an HTTP server, a CLI, or a decorator-heavy application model.
+
+Constructor dependencies are **explicit**. `@Injectable([UserRepository])` does not read `design:paramtypes`. That is intentional — the container never infers tokens from TypeScript types.
+## Features
+
+Implemented in this package:
+
+- **Modules as functions** — a factory returns `{ name, dependencies?, prepare?, register?, ready? }`
+- **Dependency injection** — class, value, factory, and existing providers
+- **Explicit tokens** — `@Injectable([tokens])`, `@Inject(token)`, `@Optional()`
+- **Scopes** — `singleton` (default) and `transient` on class and factory providers
+- **Parent/child containers** — `container.createChild()`
+- **Lifecycle** — resolve factories, then `await prepare` → `await register` → `ready` (not awaited)
+- **Task bus** — `subscribe` / `invoke` (`sequential` or `parallel`)
+- **Config** — nested values via dot paths on a metadata-backed store
+- **Shell** — host-app bootstrap (`create` / `register` / `ready`) for Express, Vue, React, … kits
+- **Isomorphic** — same pattern on Node.js server and browser client
+Not in this package:
+
+- HTTP server, router, controllers as a framework primitive
+- Request-scoped providers
+- NestJS-style `@Module({ imports, providers })`
+- First-party Lambda, SQS, or worker adapters
+- Tests, changelog, and a published license (see [Open-source status](#open-source-status))
+
+## Installation
+
+```bash
+npm install @toijs/modular
+# or
+pnpm add @toijs/modular
+```
+
+The package is **ESM-only** (`"type": "module"`). Node.js 18+ is the intended runtime; `engines` is not declared yet.
+
+Enable class decorators in the consuming project. `@Injectable` is a class decorator. `@Inject` and `@Optional` are parameter decorators and need `experimentalDecorators` in `tsconfig.json`.
+
+```json
+{
+  "compilerOptions": {
+    "experimentalDecorators": true
+  }
+}
+```
+
+`emitDecoratorMetadata` is **not** required and is **not** read by this container.
+
+## Quick Start
+
+```ts
+import { Injectable, Launcher, type Module } from "@toijs/modular";
+
+@Injectable()
+class UserService {
+  list() {
+    return [{ id: "1", name: "Ada" }];
+  }
+}
+
+function AppModule(launcher: Launcher): Module {
+  const prepare = () => {
+    launcher.container.register([UserService]);
+  };
+
+  const ready = () => {
+    const users = launcher.container.resolve(UserService);
+    console.log(users.list());
+  };
+
+  return { name: "app", prepare, ready };
+}
+
+await new Launcher().modules([AppModule]).start();
+```
+
+`start()` throws if `.modules()` was never called with at least one factory.
+
+## Module example
+
+A module is a **function**, not a class. There is no `@Module()` decorator.
+
+```ts
+import { Launcher, type Module } from "@toijs/modular";
+import { UserService } from "./user.service.js";
+import { UserRepository } from "./user.repository.js";
+
+export function UserModule(launcher: Launcher): Module {
+  const prepare = () => {
+    launcher.container.register([UserRepository, UserService]);
+  };
+
+  return { name: "feature.user", prepare };
+}
+```
+
+Optional fields:
+
+| Field | Role |
+| --- | --- |
+| `name` | Required identity. Duplicate names are **skipped**. Empty names are skipped. |
+| `dependencies` | Extra `ModuleFactory[]` resolved after this module is recorded |
+| `prepare` | Register providers, subscribe to tasks, define routes in a kit — **awaited** |
+| `register` | Create the host (`shell.create`) — **awaited**; kits must **return** the create promise |
+| `ready` | After register — **not** awaited; often unused in features |
+
+The factory body runs during resolve, **before** any lifecycle hook. Put `config.define` there so later factories can read config.
+
+## Dependency Injection example
+
+Tokens must be listed. An empty `@Injectable()` does not inspect constructor types.
+
+```ts
+import { Injectable } from "@toijs/modular";
+import { UserRepository } from "./user.repository.js";
+
+@Injectable([UserRepository])
+export class UserService {
+  constructor(private readonly users: UserRepository) {}
+
+  find(id: string) {
+    return this.users.findById(id);
+  }
+}
+```
+
+Register the class as its own token (singleton by default):
+
+```ts
+launcher.container.register([UserRepository, UserService]);
+```
+
+## Provider example
+
+```ts
+import { ConnectionManager } from "@toijs/typeorm";
+
+// Class as its own token
+launcher.container.register(UserService);
+
+// Value
+launcher.container.register({
+  provide: ConnectionManager,
+  useValue: connectionManager,
+});
+
+// Factory
+launcher.container.register({
+  provide: "clock",
+  useFactory: () => () => Date.now(),
+});
+
+// Existing (alias)
+launcher.container.register({
+  provide: "Users",
+  useExisting: UserService,
+});
+
+// Class with explicit inject list and transient scope
+launcher.container.register({
+  provide: UserService,
+  useClass: UserService,
+  inject: [UserRepository],
+  scope: "transient",
+});
+```
+
+`useValue` and `useExisting` are always stored as singletons. `scope` is honored only on `useClass` and `useFactory`.
+
+## Token injection
+
+```ts
+import { Inject, Injectable, Optional } from "@toijs/modular";
+
+const CONFIG = Symbol("config");
+
+@Injectable()
+class ReportService {
+  constructor(
+    @Inject(CONFIG) private readonly config: { env: string },
+    @Optional() @Inject("logger") private readonly logger?: { info(msg: string): void },
+  ) {}
+}
+
+launcher.container.register({ provide: CONFIG, useValue: { env: "test" } });
+launcher.container.register(ReportService);
+```
+
+`@Optional()` only applies to **class constructor** parameters. Factory `inject` arrays cannot mark a dependency optional; a missing token throws.
+
+## Lifecycle
+
+`await Launcher.start()`:
+
+```text
+resolve factories (and `dependencies`)
+        ↓
+await prepare()   × all modules
+        ↓
+await register()  × all modules
+        ↓
+     ready()      × all modules   (not awaited)
+```
+
+Hooks are `() => void | Promise<void>`. `start()` **awaits** `prepare` and `register` sequentially. **`ready` is not awaited.** Kits that create a host must **return** `shell.create(...)` from `register` so bootstrap waits for the host and `task.root.register` / `task.root.ready`.
+
+`Shell` is the second, host-specific flow used by app-shell kits (Express, Vue, React, …):
+
+```text
+await shell.create(fn)
+        ↓
+await invoke "task.root.register"
+        ↓
+await invoke "task.root.ready"
+```
+
+Feature modules subscribe with `shell.register` / `shell.ready`. They should not call `shell.create`. The same modular pattern runs on Node.js and in the browser; only the kit (shell) changes.
+## Application composition
+
+```ts
+import { Launcher } from "@toijs/modular";
+import { TypeORMModule } from "@toijs/typeorm";
+import { ConfigModule } from "./config.module.js";
+import { DatabaseModule } from "./database.module.js";
+import { UserModule } from "./user.module.js";
+import { OrderModule } from "./order.module.js";
+
+await new Launcher()
+  .modules([
+    ConfigModule,     // factory body: config.define
+    TypeORMModule,    // separate package
+    DatabaseModule,   // setEntities before TypeORM register
+    UserModule,
+    OrderModule,
+  ])
+  .start();
+```
+
+`Launcher` constructs a `Container` and registers itself plus `Task`, `Metadata`, `Config`, and `Shell` as value providers.
+
+`launcher.define("http", client)` attaches a property on the launcher **and** registers it in DI. It throws if the property already exists.
+
+## Testing
+
+There is no test helper in this package. Replace a production provider with a test double by registering over the same token:
+
+```ts
+import { Launcher } from "@toijs/modular";
+import { UserModule } from "./user.module.js";
+import { UserRepository } from "./user.repository.js";
+import { InMemoryUserRepository } from "./user.repository.memory.js";
+
+const launcher = new Launcher();
+await launcher.modules([UserModule]).start();
+
+launcher.container.register({
+  provide: UserRepository,
+  useClass: InMemoryUserRepository,
+});
+
+const users = launcher.container.resolve(UserRepository);
+```
+
+`register` deletes any cached singleton for that token, so the next `resolve` builds a new instance.
+
+`container.tryResolve(token)` returns `undefined` instead of throwing. `container.has(token)` walks parent containers.
+
+## Architecture
+
+```text
+Launcher
+ ├── container   DI (providers, resolve, child containers)
+ ├── task        named handler bus
+ ├── metadata    key/value + change events
+ ├── config      metadata-backed settings (dot paths)
+ └── shell       host instance (Express, Vue, React, …)
+
+Module factory
+ ├── factory body     runs at resolve time
+ ├── prepare          awaited by start()
+ ├── register         awaited by start()
+ └── ready            not awaited
+```
+
+Keep domain types and business logic as plain TypeScript. Depend on `@toijs/modular` only at the composition root (modules, `@Injectable`, `container.register`). Same pattern on server and browser; kits supply the app shell.
+## Use cases
+
+Fits:
+
+- API process composed with a kit such as `@toijs/express-kit`
+- Vue / React SPA composed with a UI kit (`@toijs/vue-kit` or equivalent)
+- CLI / batch scripts that need modules + DI
+- Long-running workers, if **you** wire the consumer (no SQS adapter ships here)
+- Lambda handlers, if **you** bootstrap `Launcher` per cold start (no Lambda adapter ships here)
+
+Does not fit as a drop-in:
+
+- Teams that want NestJS’s HTTP, OpenAPI, microservices, and ecosystem
+- Request-scoped per-HTTP-request providers
+- Effect-style typed functional programming
+- CommonJS-only deployments
+
+## Comparison
+
+| | `@toijs/modular` | NestJS |
+| --- | --- | --- |
+| DI | Explicit tokens, class/value/factory/existing | Reflection + tokens, large provider model |
+| Module | Function factory | `@Module()` class |
+| Lifecycle | `await prepare` → `await register` → `ready` (not awaited) | Nest lifecycle hooks |
+| HTTP / UI | Not included — Shell + kits (Express, Vue, React, …) | First-class HTTP |
+| Runtime | Node.js and browser | Primarily Node.js |
+| CLI | Not included | `@nestjs/cli` |
+| ORM | Separate `@toijs/typeorm` | Separate `@nestjs/typeorm` etc. |
+| Lambda / worker | Usable; no official adapter | Usable; larger bootstrap |
+| Ecosystem | Small (`typeorm`, private kits) | Large |
+| Learning curve | Small API, unusual module shape | Large API, more tutorials |
+
+Use NestJS when you want a platform. Use `@toijs/modular` when you want isomorphic composition and DI without that platform.
+A longer comparison with Effect and plain Node.js is in [docs/guides/comparison.md](docs/guides/comparison.md).
+
+## API overview
+
+| Export | Kind |
+| --- | --- |
+| `Launcher` | Bootstrap: `modules()`, `start()`, `define()`, `container`, `task`, `config`, `metadata`, `shell` |
+| `Container` | `register`, `resolve`, `tryResolve`, `has`, `createChild`, `clear` |
+| `Injectable`, `Inject`, `Optional` | Decorators |
+| `Task` | `subscribe`, `unsubscribe`, `invoke(name, data?, type?)` |
+| `Config` | `define`, `resolve(path?)` |
+| `Metadata` | `define`, `resolve`, `subscribe`, `invoke` |
+| `Shell` | `create`, `register`, `ready`, `getInstance` |
+| `SCOPE_SINGLETON`, `SCOPE_TRANSIENT` | `"singleton"` / `"transient"` |
+| `TASK_ROOT_REGISTER`, `TASK_ROOT_READY` | Shell task names |
+| `METADATA_CONFIG`, `EVENT_METADATA_CHANGED` | Config / metadata keys |
+
+## Packages / integrations
+
+| Package | Status | Role |
+| --- | --- | --- |
+| `@toijs/modular` | v1.0.4, `private: false` | Core (isomorphic composition) |
+| `@toijs/typeorm` | v1.0.7, `private: false` | `TypeORMModule`, `ConnectionManager` |
+| `@toijs/express-kit` | `private: true` | Express `shell.create` + router (server shell) |
+| `@toijs/vue-kit` | `private: true` | Vue `shell.create` + router (browser shell) |
+| `@toijs/graphql` | `private: true` | Stub — do not treat as shipped |
+
+HTTP, Vue, React, i18n, layout, and device kits live outside this package. They are not required to use the container.
+## Documentation
+
+- [Documentation index](docs/README.md)
+- [Modules](docs/concepts/modules.md)
+- [Dependency injection](docs/concepts/dependency-injection.md)
+- [Containers](docs/concepts/containers.md)
+- [Lifecycle](docs/concepts/lifecycle.md)
+- [Architecture](docs/guides/architecture.md)
+- [Examples](examples/README.md)
+
+## Contributing
+
+There is no `CONTRIBUTING.md` yet. Source of truth is `src/` in this package. Do not add NestJS APIs “for familiarity” — this runtime is not NestJS.
+
+## Roadmap
+
+Not implemented, not scheduled in-repo (ideas only):
+
+- Await `ready` hooks (today only `prepare` / `register` are awaited)
+- Request scope
+- CJS build
+- Official Lambda / SQS examples as packages
+- First-party React kit
+- Test utilities
+- License, changelog, CI, coverage
+## Open-source status
+
+| Item | Status |
+| --- | --- |
+| Version | `1.0.4` |
+| License | **Missing** (GitHub `license: null`, no `license` field in `package.json`) |
+| Tests | **None** in this package |
+| CI | **None** in the repository |
+| Changelog | **Missing** |
+| Node `engines` | **Not declared** |
+| ESM / CJS | ESM only |
+| README (previous) | **Missing** — this file is new |
+
+Version `1.0.4` means the package is versioned, not that it has a stability policy. Treat breaking changes as possible until a changelog and semver policy exist.
+## License
+
+**NEEDS VERIFICATION.** No license file is present in the package or on [toijs/framework](https://github.com/toijs/framework). Do not assume MIT or any other license until one is published.

package/dist/launcher/services/launcher.service.d.ts

@@ -12,6 +12,8 @@ export declare class Launcher {
     config: Config;
     options: StartOptions;
     instances: Map<string, Module>;
+    /** Factories already invoked — keeps re-entrant `start()` from re-running side effects. */
+    private factories;
     constructor();
     /**
      * Attach a capability onto the launcher (and optionally register it in DI).
@@ -26,13 +28,16 @@ export declare class Launcher {
      */
     modules(modules: ModuleFactory[]): this;
     /**
-     * Resolve the module instances
-     * @param modules - The modules to resolve
-     * @returns The module instances
+     * Resolve module factories into instances.
+     * Skips factories already invoked so a later `modules([...]).start()` (e.g. plugin
+     * attach) does not re-run host factory side effects. Only newly resolved modules
+     * are returned so prepare/register/ready run for them alone.
      */
     private resolveModuleInstances;
     /**
-     * Start the application
+     * Start (or continue starting) the application.
+     * Safe to call again after `modules([...])` adds more factories — only new
+     * modules run prepare → register → ready.
      */
     start(): Promise<void>;
 }

package/dist/launcher/services/launcher.service.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"launcher.service.d.ts","sourceRoot":"","sources":["../../../src/launcher/services/launcher.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,qBAAa,QAAQ;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAEV;IACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;;IA8BlD;;;;;OAKG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EACxB,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,EACR,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAoBtB;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE;IAKhC;;;;OAIG;YACW,sBAAsB;IAsBpC;;OAEG;IACG,KAAK;CAmBZ"}
+{"version":3,"file":"launcher.service.d.ts","sourceRoot":"","sources":["../../../src/launcher/services/launcher.service.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,UAAU,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,qBAAa,QAAQ;IACZ,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,QAAQ,CAAC;IACnB,SAAS,EAAE,SAAS,CAAC;IACrB,KAAK,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,YAAY,CAEV;IACX,SAAS,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAa;IAClD,2FAA2F;IAC3F,OAAO,CAAC,SAAS,CAA4B;;IA8B7C;;;;;OAKG;IACH,MAAM,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,EACxB,GAAG,EAAE,CAAC,EACN,KAAK,EAAE,CAAC,EACR,KAAK,CAAC,EAAE,cAAc,CAAC,CAAC,CAAC,GACxB,IAAI,GAAG,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC;IAoBtB;;;OAGG;IACH,OAAO,CAAC,OAAO,EAAE,aAAa,EAAE;IAKhC;;;;;OAKG;YACW,sBAAsB;IA+BpC;;;;OAIG;IACG,KAAK;CAqBZ"}

package/dist/launcher/services/launcher.service.js

@@ -13,6 +13,8 @@ export class Launcher {
         modules: [],
     };
     instances = new Map();
+    /** Factories already invoked — keeps re-entrant `start()` from re-running side effects. */
+    factories = new Set();
     constructor() {
         this.container = new Container();
         this.task = new Task();
@@ -71,21 +73,24 @@ export class Launcher {
         return this;
     }
     /**
-     * Resolve the module instances
-     * @param modules - The modules to resolve
-     * @returns The module instances
+     * Resolve module factories into instances.
+     * Skips factories already invoked so a later `modules([...]).start()` (e.g. plugin
+     * attach) does not re-run host factory side effects. Only newly resolved modules
+     * are returned so prepare/register/ready run for them alone.
      */
     async resolveModuleInstances(modules, instances = []) {
         for (const module of modules) {
+            if (this.factories.has(module)) {
+                continue;
+            }
             const moduleInstance = module(this);
-            // If the module is already registered, skip it
+            this.factories.add(module);
+            // Duplicate or empty name: factory side effects already ran once; skip hooks.
             if (this.instances.has(moduleInstance.name) || !moduleInstance.name) {
                 continue;
             }
-            // Register the module instance
             this.instances.set(moduleInstance.name, moduleInstance);
             instances.push(moduleInstance);
-            // Resolve the module instances
             if (moduleInstance.dependencies) {
                 instances = await this.resolveModuleInstances(moduleInstance.dependencies, instances);
             }
@@ -93,18 +98,20 @@ export class Launcher {
         return instances;
     }
     /**
-     * Start the application
+     * Start (or continue starting) the application.
+     * Safe to call again after `modules([...])` adds more factories — only new
+     * modules run prepare → register → ready.
      */
     async start() {
         if (this.options.modules.length === 0) {
             throw new Error("No modules registered");
         }
-        let instances = await this.resolveModuleInstances(this.options.modules);
+        const instances = await this.resolveModuleInstances(this.options.modules);
         for (const instance of instances) {
-            instance.prepare?.();
+            await instance.prepare?.();
         }
         for (const instance of instances) {
-            instance.register?.();
+            await instance.register?.();
         }
         for (const instance of instances) {
             instance.ready?.();

package/dist/launcher/services/launcher.service.js.map

@@ -1 +1 @@
-{"version":3,"file":"launcher.service.js","sourceRoot":"","sources":["../../../src/launcher/services/launcher.service.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAuB,MAAM,UAAU,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,YAAY,CAAC;AAClC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,KAAK,EAAE,MAAM,iBAAiB,CAAC;AAExC,MAAM,OAAO,QAAQ;IACZ,IAAI,CAAO;IACX,QAAQ,CAAW;IACnB,SAAS,CAAY;IACrB,KAAK,CAAQ;IACb,MAAM,CAAS;IACf,OAAO,GAAiB;QAC7B,OAAO,EAAE,EAAqB;KACf,CAAC;IACX,SAAS,GAAwB,IAAI,GAAG,EAAE,CAAC;IAElD;QACE,IAAI,CAAC,SAAS,GAAG,IAAI,SAAS,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;QACvB,IAAI,CAAC,QAAQ,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QACjD,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,QAAQ;YACjB,QAAQ,EAAE,IAAI;SACf,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,IAAI,CAAC,IAAI;SACpB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,QAAQ;YACjB,QAAQ,EAAE,IAAI,CAAC,QAAQ;SACxB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,MAAM;YACf,QAAQ,EAAE,IAAI,CAAC,MAAM;SACtB,CAAC,CAAC;QACH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,KAAK;YACd,QAAQ,EAAE,IAAI,CAAC,KAAK;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;OAKG;IACH,MAAM,CACJ,GAAM,EACN,KAAQ,EACR,KAAyB;QAEzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,uBAAuB,GAAG,kBAAkB,CAAC,CAAC;QAChE,CAAC;QAED,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,EAAE;YAC/B,KAAK;YACL,QAAQ,EAAE,KAAK;YACf,UAAU,EAAE,IAAI;YAChB,YAAY,EAAE,KAAK;SACpB,CAAC,CAAC;QAEH,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC;YACtB,OAAO,EAAE,CAAC,KAAK,IAAI,GAAG,CAAsB;YAC5C,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;QAEH,OAAO,IAA2B,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,OAAO,CAAC,OAAwB;QAC9B,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,OAAO,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,sBAAsB,CAAC,OAAwB,EAAE,YAAsB,EAAE;QACrF,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;YAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YAEpC,+CAA+C;YAC/C,IAAI,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;gBACpE,SAAS;YACX,CAAC;YAED,+BAA+B;YAC/B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,cAAc,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC;YACxD,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;YAE/B,+BAA+B;YAC/B,IAAI,cAAc,CAAC,YAAY,EAAE,CAAC;gBAChC,SAAS,GAAG,MAAM,IAAI,CAAC,sBAAsB,CAAC,cAAc,CAAC,YAAY,EAAE,SAAS,CAAC,CAAC;YACxF,CAAC;QACH,CAAC;QAED,OAAO,SAAS,CAAC;IACnB,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,KAAK;QACT,IAAI,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;QAC3C,CAAC;QAED,IAAI,SAAS,GAAa,MAAM,IAAI,CAAC,sBAAsB,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;QAElF,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,OAAO,EAAE,EAAE,CAAC;QACvB,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,QAAQ,EAAE,EAAE,CAAC;QACxB,CAAC;QAED,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;YACjC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;QACrB,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"launcher.service.js","sourceRoot":"","sources":["../../../src/launcher/services/launcher.service.ts"],"names":[],"mappings":"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"}

package/dist/launcher/types/module.type.d.ts

@@ -9,9 +9,9 @@ import { Launcher } from "../services";
 export type Module = {
     name: string;
     dependencies?: ModuleFactory[];
-    prepare?: () => void;
-    register?: () => void;
-    ready?: () => void;
+    prepare?: () => void | Promise<void>;
+    register?: () => void | Promise<void>;
+    ready?: () => void | Promise<void>;
 };
 /**
  * A factory function that creates a module

package/dist/launcher/types/module.type.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"module.type.d.ts","sourceRoot":"","sources":["../../../src/launcher/types/module.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,IAAI,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,IAAI,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,IAAI,CAAC;CACpB,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC"}
+{"version":3,"file":"module.type.d.ts","sourceRoot":"","sources":["../../../src/launcher/types/module.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC;;;;;;GAMG;AACH,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,YAAY,CAAC,EAAE,aAAa,EAAE,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACrC,QAAQ,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,KAAK,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACpC,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,KAAK,MAAM,CAAC;AAE3D;;;;GAIG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,OAAO,EAAE,aAAa,EAAE,CAAC;CAC1B,CAAC"}

package/package.json

@@ -1,9 +1,33 @@
 {
   "name": "@toijs/modular",
-  "version": "1.0.3",
+  "version": "1.0.6",
   "private": false,
   "type": "module",
-  "description": "Lamtoi modular core (launcher, metadata, config, task, router)",
+  "description": "Isomorphic TypeScript composition pattern: modules, explicit DI, and Shell for Node.js and browser apps (Express, Vue, React, …)",
+  "keywords": [
+    "isomorphic",
+    "browser",
+    "nodejs",
+    "typescript",
+    "dependency-injection",
+    "di",
+    "container",
+    "module",
+    "modular",
+    "ioc",
+    "composition",
+    "launcher",
+    "shell"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/toijs/framework.git",
+    "directory": "modular"
+  },
+  "homepage": "https://github.com/toijs/framework/tree/develop/modular",
+  "bugs": {
+    "url": "https://github.com/toijs/framework/issues"
+  },
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {