@wild-framework/core 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Wild Framework contributors
+
+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

@@ -0,0 +1,32 @@
+# @wild-framework/core
+
+Application lifecycle and provider system for [Wild Framework](https://github.com/your-org/wild-framework).
+
+## Install
+
+```bash
+pnpm add @wild-framework/core
+```
+
+## Usage
+
+```ts
+import { createApplication } from "@wild-framework/core";
+
+const app = createApplication();
+app.register(DatabaseProvider);
+await app.boot();
+await app.listen(3000);
+```
+
+## API
+
+- `createApplication()` — create the app
+- `app.register(ProviderClass)` — register a provider
+- `app.boot()` / `app.shutdown()` — lifecycle
+- `app.resolve(T)` — resolve from the container
+- `app.listen(port)` — start the HTTP server
+
+## License
+
+MIT

package/dist/application.d.ts

@@ -0,0 +1,74 @@
+import type { ProviderConstructor, Resolver, Server } from "./contracts.js";
+/**
+ * The Application orchestrates the framework lifecycle.
+ *
+ * It owns provider registration, boot sequencing, and delegation
+ * to infrastructure implementations (Resolver, Server).
+ *
+ * Application is a plain class — no inheritance, no decorators.
+ */
+export declare class Application {
+    private state;
+    /** Provider constructors in FIFO registration order. */
+    private providerConstructors;
+    /** Instantiated providers, keyed by constructor. Populated during boot. */
+    private providerInstances;
+    /** Providers that successfully completed `boot()`. */
+    private bootedProviders;
+    /** Providers that completed `register()` (superset of bootedProviders). Used by shutdown to clean up. */
+    private liveProviders;
+    private resolver;
+    private server;
+    /**
+     * Register a provider for boot.
+     *
+     * Accepts a provider **class** (constructor), not an instance.
+     * Must be called before `boot()`. Throws on duplicate or if already booted.
+     */
+    register(providerCtor: ProviderConstructor): void;
+    /**
+     * Boot the application.
+     *
+     * Instantiates each provider, runs `register()` on all (FIFO),
+     * then `boot()` on all (FIFO). Idempotent in Booted and Shutdown states.
+     * On failure, transitions to BootFailed and rethrows.
+     */
+    boot(): Promise<void>;
+    /**
+     * Shut down the application.
+     *
+     * Calls `shutdown()` on all booted providers in LIFO order,
+     * then transitions to Shutdown.
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Register the dependency resolver.
+     * Called by ContainerProvider during its `register()` phase.
+     * Throws if a resolver is already set.
+     */
+    setResolver(resolver: Resolver): void;
+    /**
+     * Resolve a class constructor — type is inferred from the token.
+     */
+    resolve<T>(token: abstract new (...args: any[]) => T): T;
+    /**
+     * Resolve an arbitrary token — type must be explicit.
+     */
+    resolve<T>(token: unknown): T;
+    /**
+     * Register the HTTP server.
+     * Called by HttpProvider during its `register()` phase.
+     * Throws if a server is already set.
+     */
+    setServer(server: Server): void;
+    /**
+     * Start listening for HTTP requests.
+     * Delegates to the registered Server. Throws if none is registered.
+     */
+    listen(port: number): Promise<void>;
+    /** Whether the application has successfully booted. */
+    isBooted(): boolean;
+    /** Whether the application has been shut down. */
+    isShutdown(): boolean;
+}
+//# sourceMappingURL=application.d.ts.map

package/dist/application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../src/application.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAY,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAWtF;;;;;;;GAOG;AACH,qBAAa,WAAW;IACpB,OAAO,CAAC,KAAK,CAA8C;IAE3D,wDAAwD;IACxD,OAAO,CAAC,oBAAoB,CAA6B;IAEzD,2EAA2E;IAC3E,OAAO,CAAC,iBAAiB,CAA4C;IAErE,sDAAsD;IACtD,OAAO,CAAC,eAAe,CAAkC;IAEzD,yGAAyG;IACzG,OAAO,CAAC,aAAa,CAAkC;IAEvD,OAAO,CAAC,QAAQ,CAAyB;IACzC,OAAO,CAAC,MAAM,CAAuB;IAMrC;;;;;OAKG;IACH,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI;IAgBjD;;;;;;OAMG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC3B;;;;;OAKG;IACG,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IA0B/B;;;;OAIG;IACH,WAAW,CAAC,QAAQ,EAAE,QAAQ,GAAG,IAAI;IAOrC;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC;IACxD;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC;IAiB7B;;;;OAIG;IACH,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAO/B;;;OAGG;IACG,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAWzC,uDAAuD;IACvD,QAAQ,IAAI,OAAO;IAInB,kDAAkD;IAClD,UAAU,IAAI,OAAO;CAGxB"}

package/dist/application.js

@@ -0,0 +1,166 @@
+import { ApplicationState } from "./state.js";
+import { ApplicationAlreadyBootedError, ApplicationBootFailedError, DuplicateProviderError, DuplicateRegistrationError, NoResolverRegisteredError, NoServerRegisteredError, } from "./errors.js";
+/**
+ * The Application orchestrates the framework lifecycle.
+ *
+ * It owns provider registration, boot sequencing, and delegation
+ * to infrastructure implementations (Resolver, Server).
+ *
+ * Application is a plain class — no inheritance, no decorators.
+ */
+export class Application {
+    state = ApplicationState.Created;
+    /** Provider constructors in FIFO registration order. */
+    providerConstructors = [];
+    /** Instantiated providers, keyed by constructor. Populated during boot. */
+    providerInstances = new Map();
+    /** Providers that successfully completed `boot()`. */
+    bootedProviders = new Set();
+    /** Providers that completed `register()` (superset of bootedProviders). Used by shutdown to clean up. */
+    liveProviders = new Set();
+    resolver = null;
+    server = null;
+    // ---------------------------------------------------------------------------
+    // Provider registration
+    // ---------------------------------------------------------------------------
+    /**
+     * Register a provider for boot.
+     *
+     * Accepts a provider **class** (constructor), not an instance.
+     * Must be called before `boot()`. Throws on duplicate or if already booted.
+     */
+    register(providerCtor) {
+        if (this.state !== ApplicationState.Created) {
+            throw new ApplicationAlreadyBootedError();
+        }
+        if (this.providerConstructors.includes(providerCtor)) {
+            throw new DuplicateProviderError(providerCtor.name);
+        }
+        this.providerConstructors.push(providerCtor);
+    }
+    // ---------------------------------------------------------------------------
+    // Lifecycle
+    // ---------------------------------------------------------------------------
+    /**
+     * Boot the application.
+     *
+     * Instantiates each provider, runs `register()` on all (FIFO),
+     * then `boot()` on all (FIFO). Idempotent in Booted and Shutdown states.
+     * On failure, transitions to BootFailed and rethrows.
+     */
+    async boot() {
+        if (this.state === ApplicationState.Booted || this.state === ApplicationState.Shutdown) {
+            return;
+        }
+        if (this.state === ApplicationState.BootFailed) {
+            throw new ApplicationBootFailedError();
+        }
+        try {
+            // Phase 1: instantiate and register all providers (FIFO)
+            for (const ctor of this.providerConstructors) {
+                const instance = new ctor();
+                this.providerInstances.set(ctor, instance);
+                if (instance.register) {
+                    await instance.register(this);
+                }
+                this.liveProviders.add(ctor);
+            }
+            // Phase 2: boot all providers (FIFO)
+            for (const ctor of this.providerConstructors) {
+                const instance = this.providerInstances.get(ctor);
+                if (instance.boot) {
+                    await instance.boot(this);
+                }
+                this.bootedProviders.add(ctor);
+            }
+            this.state = ApplicationState.Booted;
+        }
+        catch (error) {
+            this.state = ApplicationState.BootFailed;
+            throw error;
+        }
+    }
+    /**
+     * Shut down the application.
+     *
+     * Calls `shutdown()` on all booted providers in LIFO order,
+     * then transitions to Shutdown.
+     */
+    async shutdown() {
+        if (this.state === ApplicationState.Shutdown) {
+            return;
+        }
+        // Iterate in reverse (LIFO), only providers that completed register()
+        for (let i = this.providerConstructors.length - 1; i >= 0; i--) {
+            const ctor = this.providerConstructors[i];
+            if (!this.liveProviders.has(ctor)) {
+                continue;
+            }
+            const instance = this.providerInstances.get(ctor);
+            if (instance?.shutdown) {
+                await instance.shutdown(this);
+            }
+        }
+        this.state = ApplicationState.Shutdown;
+    }
+    // ---------------------------------------------------------------------------
+    // Delegation — Resolver
+    // ---------------------------------------------------------------------------
+    /**
+     * Register the dependency resolver.
+     * Called by ContainerProvider during its `register()` phase.
+     * Throws if a resolver is already set.
+     */
+    setResolver(resolver) {
+        if (this.resolver) {
+            throw new DuplicateRegistrationError("resolver");
+        }
+        this.resolver = resolver;
+    }
+    /**
+     * Resolve a dependency from the container.
+     * Delegates to the registered Resolver. Throws if none is registered.
+     */
+    resolve(token) {
+        if (!this.resolver) {
+            throw new NoResolverRegisteredError();
+        }
+        return this.resolver.resolve(token);
+    }
+    // ---------------------------------------------------------------------------
+    // Delegation — Server
+    // ---------------------------------------------------------------------------
+    /**
+     * Register the HTTP server.
+     * Called by HttpProvider during its `register()` phase.
+     * Throws if a server is already set.
+     */
+    setServer(server) {
+        if (this.server) {
+            throw new DuplicateRegistrationError("server");
+        }
+        this.server = server;
+    }
+    /**
+     * Start listening for HTTP requests.
+     * Delegates to the registered Server. Throws if none is registered.
+     */
+    async listen(port) {
+        if (!this.server) {
+            throw new NoServerRegisteredError();
+        }
+        await this.server.listen(port);
+    }
+    // ---------------------------------------------------------------------------
+    // State queries
+    // ---------------------------------------------------------------------------
+    /** Whether the application has successfully booted. */
+    isBooted() {
+        return this.state === ApplicationState.Booted;
+    }
+    /** Whether the application has been shut down. */
+    isShutdown() {
+        return this.state === ApplicationState.Shutdown;
+    }
+}
+//# sourceMappingURL=application.js.map

package/dist/application.js.map

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

package/dist/contracts.d.ts

@@ -0,0 +1,50 @@
+import type { Application } from "./application.js";
+/**
+ * Provider contract that every Wild Framework package implements.
+ *
+ * Core instantiates provider classes via `new` — providers must have
+ * a no-arg constructor. Dependencies are obtained via `app.resolve()`
+ * inside lifecycle methods, not via constructor injection.
+ *
+ * All three lifecycle methods are optional — a provider may implement
+ * any subset.
+ */
+export interface Provider {
+    /**
+     * Called during `app.boot()`.
+     * Register services into the container, set the resolver/server, etc.
+     */
+    register?(app: Application): void | Promise<void>;
+    /**
+     * Called after all providers have been registered.
+     * Start listeners, connect to databases, schedule jobs, etc.
+     */
+    boot?(app: Application): void | Promise<void>;
+    /**
+     * Called during `app.shutdown()` in reverse registration order.
+     * Only called for providers that successfully completed `boot()`.
+     */
+    shutdown?(app: Application): void | Promise<void>;
+}
+/**
+ * Constructor type for providers. `app.register()` accepts the class,
+ * not an instance. Core calls `new` internally.
+ */
+export type ProviderConstructor = new () => Provider;
+/**
+ * Dependency injection contract. Implemented by @wild-framework/container.
+ */
+export interface Resolver {
+    /** Resolve a class constructor — type is inferred from the token. */
+    resolve<T>(token: abstract new (...args: any[]) => T): T;
+    /** Resolve an arbitrary token (string, Symbol, etc.) — type must be explicit. */
+    resolve<T>(token: unknown): T;
+}
+/**
+ * HTTP server contract. Implemented by @wild-framework/http.
+ */
+export interface Server {
+    listen(port: number): Promise<void>;
+    shutdown(): Promise<void>;
+}
+//# sourceMappingURL=contracts.d.ts.map

package/dist/contracts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.d.ts","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD;;;;;;;;;GASG;AACH,MAAM,WAAW,QAAQ;IACrB;;;OAGG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAElD;;;OAGG;IACH,IAAI,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE9C;;;OAGG;IACH,QAAQ,CAAC,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrD;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,GAAG,UAAU,QAAQ,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,QAAQ;IACrB,qEAAqE;IACrE,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,MAAM,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GAAG,CAAC,CAAC;IACzD,iFAAiF;IACjF,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CAAC;CACjC;AAED;;GAEG;AACH,MAAM,WAAW,MAAM;IACnB,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACpC,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CAC7B"}

package/dist/contracts.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=contracts.js.map

package/dist/contracts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contracts.js","sourceRoot":"","sources":["../src/contracts.ts"],"names":[],"mappings":""}

package/dist/errors.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Thrown when the same provider constructor is registered more than once.
+ */
+export declare class DuplicateProviderError extends Error {
+    constructor(providerName: string);
+}
+/**
+ * Thrown when `register()` is called after `boot()` has been invoked.
+ */
+export declare class ApplicationAlreadyBootedError extends Error {
+    constructor();
+}
+/**
+ * Thrown when `boot()` is called while the application is in the BootFailed state.
+ */
+export declare class ApplicationBootFailedError extends Error {
+    constructor();
+}
+/**
+ * Thrown when `app.resolve()` is called before a Resolver has been registered.
+ */
+export declare class NoResolverRegisteredError extends Error {
+    constructor();
+}
+/**
+ * Thrown when `app.listen()` is called before a Server has been registered.
+ */
+export declare class NoServerRegisteredError extends Error {
+    constructor();
+}
+/**
+ * Thrown when a Resolver or Server is set more than once.
+ */
+export declare class DuplicateRegistrationError extends Error {
+    constructor(kind: string);
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,KAAK;gBACjC,YAAY,EAAE,MAAM;CAInC;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,KAAK;;CAKvD;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;;CAKpD;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,KAAK;;CAKnD;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,KAAK;;CAKjD;AAED;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;gBACrC,IAAI,EAAE,MAAM;CAI3B"}

package/dist/errors.js

@@ -0,0 +1,55 @@
+/**
+ * Thrown when the same provider constructor is registered more than once.
+ */
+export class DuplicateProviderError extends Error {
+    constructor(providerName) {
+        super(`Provider "${providerName}" is already registered.`);
+        this.name = "DuplicateProviderError";
+    }
+}
+/**
+ * Thrown when `register()` is called after `boot()` has been invoked.
+ */
+export class ApplicationAlreadyBootedError extends Error {
+    constructor() {
+        super("Cannot register providers after the application has been booted.");
+        this.name = "ApplicationAlreadyBootedError";
+    }
+}
+/**
+ * Thrown when `boot()` is called while the application is in the BootFailed state.
+ */
+export class ApplicationBootFailedError extends Error {
+    constructor() {
+        super("Cannot boot — the application is in a failed state. Call shutdown() to recover.");
+        this.name = "ApplicationBootFailedError";
+    }
+}
+/**
+ * Thrown when `app.resolve()` is called before a Resolver has been registered.
+ */
+export class NoResolverRegisteredError extends Error {
+    constructor() {
+        super("No resolver has been registered. Register a ContainerProvider before calling resolve().");
+        this.name = "NoResolverRegisteredError";
+    }
+}
+/**
+ * Thrown when `app.listen()` is called before a Server has been registered.
+ */
+export class NoServerRegisteredError extends Error {
+    constructor() {
+        super("No server has been registered. Register an HttpProvider before calling listen().");
+        this.name = "NoServerRegisteredError";
+    }
+}
+/**
+ * Thrown when a Resolver or Server is set more than once.
+ */
+export class DuplicateRegistrationError extends Error {
+    constructor(kind) {
+        super(`A ${kind} has already been registered. Only one ${kind} is allowed.`);
+        this.name = "DuplicateRegistrationError";
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,sBAAuB,SAAQ,KAAK;IAC7C,YAAY,YAAoB;QAC5B,KAAK,CAAC,aAAa,YAAY,0BAA0B,CAAC,CAAC;QAC3D,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACzC,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,KAAK;IACpD;QACI,KAAK,CAAC,kEAAkE,CAAC,CAAC;QAC1E,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAChD,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACjD;QACI,KAAK,CAAC,iFAAiF,CAAC,CAAC;QACzF,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC7C,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAChD;QACI,KAAK,CAAC,yFAAyF,CAAC,CAAC;QACjG,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC5C,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,KAAK;IAC9C;QACI,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAC1F,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IAC1C,CAAC;CACJ;AAED;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,KAAK;IACjD,YAAY,IAAY;QACpB,KAAK,CAAC,KAAK,IAAI,0CAA0C,IAAI,cAAc,CAAC,CAAC;QAC7E,IAAI,CAAC,IAAI,GAAG,4BAA4B,CAAC;IAC7C,CAAC;CACJ"}

package/dist/factory.d.ts

@@ -0,0 +1,9 @@
+import { Application } from "./application.js";
+/**
+ * Create a new Wild Framework application.
+ *
+ * Returns an Application instance in the Created state.
+ * Register providers, then call `app.boot()`.
+ */
+export declare function createApplication(): Application;
+//# sourceMappingURL=factory.d.ts.map

package/dist/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;GAKG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/factory.js

@@ -0,0 +1,11 @@
+import { Application } from "./application.js";
+/**
+ * Create a new Wild Framework application.
+ *
+ * Returns an Application instance in the Created state.
+ * Register providers, then call `app.boot()`.
+ */
+export function createApplication() {
+    return new Application();
+}
+//# sourceMappingURL=factory.js.map

package/dist/factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.js","sourceRoot":"","sources":["../src/factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB;IAC7B,OAAO,IAAI,WAAW,EAAE,CAAC;AAC7B,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export { Application } from "./application.js";
+export type { Provider, ProviderConstructor, Resolver, Server } from "./contracts.js";
+export { ApplicationAlreadyBootedError, ApplicationBootFailedError, DuplicateProviderError, DuplicateRegistrationError, NoResolverRegisteredError, NoServerRegisteredError, } from "./errors.js";
+export { createApplication } from "./factory.js";
+export { ApplicationState } from "./state.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,YAAY,EAAE,QAAQ,EAAE,mBAAmB,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACtF,OAAO,EACH,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,5 @@
+export { Application } from "./application.js";
+export { ApplicationAlreadyBootedError, ApplicationBootFailedError, DuplicateProviderError, DuplicateRegistrationError, NoResolverRegisteredError, NoServerRegisteredError, } from "./errors.js";
+export { createApplication } from "./factory.js";
+export { ApplicationState } from "./state.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EACH,6BAA6B,EAC7B,0BAA0B,EAC1B,sBAAsB,EACtB,0BAA0B,EAC1B,yBAAyB,EACzB,uBAAuB,GAC1B,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AACjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/state.d.ts

@@ -0,0 +1,22 @@
+/**
+ * The Application is always in exactly one of these states.
+ *
+ * ```
+ * Created ──boot()──▶ Booted ──shutdown()──▶ Shutdown
+ *    │                    │
+ *    └──boot() throws────▶ BootFailed
+ *                             │
+ *                             └──shutdown()──▶ Shutdown
+ * ```
+ */
+export declare enum ApplicationState {
+    /** Initial state. Providers may be registered. */
+    Created = "created",
+    /** All providers registered and booted successfully. */
+    Booted = "booted",
+    /** `boot()` threw. Some providers may have booted, some did not. */
+    BootFailed = "boot_failed",
+    /** Terminal state. All booted providers have been shut down. */
+    Shutdown = "shutdown"
+}
+//# sourceMappingURL=state.d.ts.map

package/dist/state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.d.ts","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,oBAAY,gBAAgB;IACxB,kDAAkD;IAClD,OAAO,YAAY;IAEnB,wDAAwD;IACxD,MAAM,WAAW;IAEjB,oEAAoE;IACpE,UAAU,gBAAgB;IAE1B,gEAAgE;IAChE,QAAQ,aAAa;CACxB"}

package/dist/state.js

@@ -0,0 +1,23 @@
+/**
+ * The Application is always in exactly one of these states.
+ *
+ * ```
+ * Created ──boot()──▶ Booted ──shutdown()──▶ Shutdown
+ *    │                    │
+ *    └──boot() throws────▶ BootFailed
+ *                             │
+ *                             └──shutdown()──▶ Shutdown
+ * ```
+ */
+export var ApplicationState;
+(function (ApplicationState) {
+    /** Initial state. Providers may be registered. */
+    ApplicationState["Created"] = "created";
+    /** All providers registered and booted successfully. */
+    ApplicationState["Booted"] = "booted";
+    /** `boot()` threw. Some providers may have booted, some did not. */
+    ApplicationState["BootFailed"] = "boot_failed";
+    /** Terminal state. All booted providers have been shut down. */
+    ApplicationState["Shutdown"] = "shutdown";
+})(ApplicationState || (ApplicationState = {}));
+//# sourceMappingURL=state.js.map

package/dist/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","sourceRoot":"","sources":["../src/state.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,CAAN,IAAY,gBAYX;AAZD,WAAY,gBAAgB;IACxB,kDAAkD;IAClD,uCAAmB,CAAA;IAEnB,wDAAwD;IACxD,qCAAiB,CAAA;IAEjB,oEAAoE;IACpE,8CAA0B,CAAA;IAE1B,gEAAgE;IAChE,yCAAqB,CAAA;AACzB,CAAC,EAZW,gBAAgB,KAAhB,gBAAgB,QAY3B"}

package/package.json

@@ -0,0 +1,40 @@
+{
+  "name": "@wild-framework/core",
+  "version": "0.1.0",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "license": "MIT",
+  "author": "Sphah",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KhandaSoftware/wild-framework.git"
+  },
+  "description": "Application lifecycle and provider system for Wild Framework.",
+  "keywords": [
+    "wild",
+    "framework",
+    "express",
+    "lifecycle",
+    "providers"
+  ],
+  "dependencies": {},
+  "devDependencies": {},
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "test": "vitest run"
+  }
+}