@arikajs/foundation 0.0.1

package/dist/application/Application.js

@@ -0,0 +1,196 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Application = void 0;
+const path = __importStar(require("path"));
+const Container_1 = require("../container/Container");
+const ServiceProvider_1 = require("../providers/ServiceProvider");
+const Repository_1 = require("../config/Repository");
+const EnvLoader_1 = require("../support/EnvLoader");
+const config_1 = require("../support/config");
+/**
+ * Application is the core runtime of ArikaJS.
+ *
+ * It manages:
+ * - Service container
+ * - Service providers
+ * - Configuration
+ * - Application lifecycle (register → boot → run)
+ */
+class Application {
+    constructor(basePath) {
+        this.providers = [];
+        this.booted = false;
+        this.basePath = path.resolve(basePath);
+        this.container = new Container_1.Container();
+        this.configRepository = new Repository_1.Repository();
+        // Register the config repository in the global support helper
+        (0, config_1.setConfigRepository)(this.configRepository);
+        // Register the application, container, and config for injection
+        this.container.instance(Application, this);
+        this.container.instance(Container_1.Container, this.container);
+        this.container.instance(Repository_1.Repository, this.configRepository);
+        // Load environment variables from .env if it exists
+        EnvLoader_1.EnvLoader.load(this.basePath);
+        // Load configuration from config directory
+        const configPath = path.join(this.basePath, 'config');
+        this.configRepository.loadConfigDirectory(configPath);
+    }
+    /**
+     * Get the base path of the application.
+     */
+    getBasePath() {
+        return this.basePath;
+    }
+    /**
+     * Access the underlying container.
+     */
+    getContainer() {
+        return this.container;
+    }
+    /**
+     * Access the configuration repository.
+     */
+    config() {
+        return this.configRepository;
+    }
+    /**
+     * Register a service provider.
+     * Can accept a class (will be instantiated) or an instance.
+     */
+    register(provider) {
+        if (this.booted) {
+            throw new Error('Cannot register providers after the application has been booted.');
+        }
+        const providerInstance = provider instanceof ServiceProvider_1.ServiceProvider
+            ? provider
+            : new provider(this);
+        this.providers.push(providerInstance);
+    }
+    /**
+     * Boot all registered service providers.
+     * First runs all register() methods, then all boot() methods.
+     */
+    async boot() {
+        if (this.booted) {
+            return;
+        }
+        // Phase 1: Register all providers
+        for (const provider of this.providers) {
+            await provider.register();
+        }
+        // Phase 2: Boot all providers
+        for (const provider of this.providers) {
+            await provider.boot();
+        }
+        // Phase 3: Apply runtime configuration
+        // Validate APP_KEY
+        if (!this.configRepository.get('app.key')) {
+            throw new Error('Application key (APP_KEY) is not set. Please run "arika key:generate" to generate one.');
+        }
+        // Apply timezone from config to the Node.js process
+        const timezone = this.configRepository.get('app.timezone');
+        if (timezone) {
+            process.env.TZ = timezone;
+        }
+        // Mark config as booted (read-only)
+        this.configRepository.markAsBooted();
+        this.booted = true;
+    }
+    /**
+     * Run the application.
+     * This is intentionally minimal in foundation - higher layers
+     * (HTTP/CLI) will override or extend this behavior.
+     */
+    async run() {
+        if (!this.booted) {
+            await this.boot();
+        }
+        // In foundation, run() is a no-op
+        // HTTP/CLI kernels will implement actual run logic
+    }
+    /**
+     * Bind a transient service.
+     */
+    bind(token, factory) {
+        this.container.bind(token, factory);
+    }
+    /**
+     * Bind a singleton service.
+     */
+    singleton(token, factory) {
+        this.container.singleton(token, factory);
+    }
+    /**
+     * Register an existing instance.
+     */
+    instance(token, value) {
+        this.container.instance(token, value);
+    }
+    /**
+     * Resolve a service from the container.
+     */
+    make(token) {
+        // If the token is already in the container, use it
+        if (this.container.has(token)) {
+            return this.container.make(token);
+        }
+        // Otherwise, if it's a config token (e.g. 'config.app.name'),
+        // try to resolve it from the configuration repository
+        if (typeof token === 'string' && token.startsWith('config.')) {
+            const configKey = token.substring(7);
+            const value = this.configRepository.get(configKey);
+            if (value !== undefined) {
+                return value;
+            }
+        }
+        // Fall back to standard container resolution (which might throw)
+        return this.container.make(token);
+    }
+    /**
+     * Alias for make() - resolves a service from the container.
+     */
+    resolve(token) {
+        return this.container.resolve(token);
+    }
+    /**
+     * Check if the application has been booted.
+     */
+    isBooted() {
+        return this.booted;
+    }
+}
+exports.Application = Application;
+//# sourceMappingURL=Application.js.map

package/dist/application/Application.js.map

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

package/dist/config/Repository.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Configuration repository for ArikaJS.
+ *
+ * Loads configuration files from the /config directory and provides
+ * read-only access to configuration values.
+ */
+export declare class Repository {
+    private config;
+    private booted;
+    /**
+     * Load configuration files from the config directory.
+     */
+    loadConfigDirectory(configPath: string): void;
+    /**
+     * Get a configuration value using dot notation.
+     * Example: get('app.name') returns config.app.name
+     */
+    get<T = any>(key: string, defaultValue?: T): T | undefined;
+    /**
+     * Check if a configuration key exists.
+     */
+    has(key: string): boolean;
+    /**
+     * Set a configuration value using dot notation.
+     * Example: set('app.key', 'value')
+     */
+    set(key: string, value: any): void;
+    /**
+     * Get all configuration.
+     */
+    all(): Record<string, any>;
+    /**
+     * Mark the repository as booted (read-only).
+     */
+    markAsBooted(): void;
+    /**
+     * Check if the repository has been booted.
+     */
+    isBooted(): boolean;
+}
+//# sourceMappingURL=Repository.d.ts.map

package/dist/config/Repository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Repository.d.ts","sourceRoot":"","sources":["../../src/config/Repository.ts"],"names":[],"mappings":"AAMA;;;;;GAKG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,MAAM,CAAS;IAEvB;;OAEG;IACH,mBAAmB,CAAC,UAAU,EAAE,MAAM,GAAG,IAAI;IAkC7C;;;OAGG;IACH,GAAG,CAAC,CAAC,GAAG,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,CAAC,GAAG,CAAC,GAAG,SAAS;IAc1D;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;;OAGG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI;IAmBlC;;OAEG;IACH,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC;IAI1B;;OAEG;IACH,YAAY,IAAI,IAAI;IAIpB;;OAEG;IACH,QAAQ,IAAI,OAAO;CAGpB"}

package/dist/config/Repository.js

@@ -0,0 +1,140 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Repository = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+/**
+ * Configuration repository for ArikaJS.
+ *
+ * Loads configuration files from the /config directory and provides
+ * read-only access to configuration values.
+ */
+class Repository {
+    constructor() {
+        this.config = {};
+        this.booted = false;
+    }
+    /**
+     * Load configuration files from the config directory.
+     */
+    loadConfigDirectory(configPath) {
+        if (this.booted) {
+            throw new Error('Configuration cannot be modified after boot.');
+        }
+        if (!fs.existsSync(configPath)) {
+            return;
+        }
+        const files = fs.readdirSync(configPath);
+        const configFiles = files.filter((file) => file.endsWith('.js') || file.endsWith('.ts'));
+        for (const file of configFiles) {
+            const filePath = path.join(configPath, file);
+            const configName = path.basename(file, path.extname(file));
+            try {
+                // Load config file - expects compiled JS in production
+                // For TS files, they should be pre-compiled to JS
+                const configModule = require(filePath);
+                const configValue = configModule.default || configModule;
+                if (typeof configValue === 'object' && configValue !== null) {
+                    this.config[configName] = configValue;
+                }
+            }
+            catch (error) {
+                // Silently skip files that can't be loaded
+                // In production, you might want to log this
+            }
+        }
+    }
+    /**
+     * Get a configuration value using dot notation.
+     * Example: get('app.name') returns config.app.name
+     */
+    get(key, defaultValue) {
+        const keys = key.split('.');
+        let value = this.config;
+        for (const k of keys) {
+            if (value === undefined || value === null) {
+                return defaultValue;
+            }
+            value = value[k];
+        }
+        return value !== undefined ? value : defaultValue;
+    }
+    /**
+     * Check if a configuration key exists.
+     */
+    has(key) {
+        return this.get(key) !== undefined;
+    }
+    /**
+     * Set a configuration value using dot notation.
+     * Example: set('app.key', 'value')
+     */
+    set(key, value) {
+        if (this.booted) {
+            throw new Error('Configuration cannot be modified after boot.');
+        }
+        const keys = key.split('.');
+        let current = this.config;
+        for (let i = 0; i < keys.length - 1; i++) {
+            const k = keys[i];
+            if (!(k in current) || typeof current[k] !== 'object' || current[k] === null) {
+                current[k] = {};
+            }
+            current = current[k];
+        }
+        current[keys[keys.length - 1]] = value;
+    }
+    /**
+     * Get all configuration.
+     */
+    all() {
+        return { ...this.config };
+    }
+    /**
+     * Mark the repository as booted (read-only).
+     */
+    markAsBooted() {
+        this.booted = true;
+    }
+    /**
+     * Check if the repository has been booted.
+     */
+    isBooted() {
+        return this.booted;
+    }
+}
+exports.Repository = Repository;
+//# sourceMappingURL=Repository.js.map

package/dist/config/Repository.js.map

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

package/dist/container/Container.d.ts

@@ -0,0 +1,39 @@
+export type Token<T = any> = string | symbol | (new (...args: any[]) => T);
+export type Factory<T = any> = (container: Container) => T;
+/**
+ * Lightweight dependency injection container for ArikaJS.
+ *
+ * Responsible for:
+ * - Registering bindings and singletons
+ * - Resolving services on demand
+ * - Holding pre-built instances
+ */
+export declare class Container {
+    private bindings;
+    /**
+     * Bind a token to a factory. Produces a new instance on every resolution.
+     */
+    bind<T>(token: Token<T>, factory: Factory<T>): void;
+    /**
+     * Bind a token as a singleton. The factory runs once and the
+     * same instance is returned for all subsequent resolutions.
+     */
+    singleton<T>(token: Token<T>, factory: Factory<T>): void;
+    /**
+     * Directly register an existing instance for a token.
+     */
+    instance<T>(token: Token<T>, value: T): void;
+    /**
+     * Resolve a token from the container.
+     */
+    make<T>(token: Token<T>): T;
+    /**
+     * Alias for make() - resolves a token from the container.
+     */
+    resolve<T>(token: Token<T>): T;
+    /**
+     * Check whether a token has been registered.
+     */
+    has(token: Token): boolean;
+}
+//# sourceMappingURL=Container.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Container.d.ts","sourceRoot":"","sources":["../../src/container/Container.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,GAAG,MAAM,GAAG,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC;AAE3E,MAAM,MAAM,OAAO,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,SAAS,EAAE,SAAS,KAAK,CAAC,CAAC;AAQ3D;;;;;;;GAOG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,QAAQ,CAA6B;IAE7C;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAInD;;;OAGG;IACH,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI;IAIxD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,IAAI;IAQ5C;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAuB3B;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC;IAI9B;;OAEG;IACH,GAAG,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO;CAG3B"}

package/dist/container/Container.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Container = void 0;
+/**
+ * Lightweight dependency injection container for ArikaJS.
+ *
+ * Responsible for:
+ * - Registering bindings and singletons
+ * - Resolving services on demand
+ * - Holding pre-built instances
+ */
+class Container {
+    constructor() {
+        this.bindings = new Map();
+    }
+    /**
+     * Bind a token to a factory. Produces a new instance on every resolution.
+     */
+    bind(token, factory) {
+        this.bindings.set(token, { factory, singleton: false });
+    }
+    /**
+     * Bind a token as a singleton. The factory runs once and the
+     * same instance is returned for all subsequent resolutions.
+     */
+    singleton(token, factory) {
+        this.bindings.set(token, { factory, singleton: true });
+    }
+    /**
+     * Directly register an existing instance for a token.
+     */
+    instance(token, value) {
+        this.bindings.set(token, {
+            factory: () => value,
+            singleton: true,
+            instance: value,
+        });
+    }
+    /**
+     * Resolve a token from the container.
+     */
+    make(token) {
+        let binding = this.bindings.get(token);
+        if (!binding) {
+            // If it's a class/constructor, try to instantiate it
+            if (typeof token === 'function') {
+                return new token(this);
+            }
+            throw new Error(`Container: no binding found for token "${String(token)}"`);
+        }
+        if (binding.singleton) {
+            if (binding.instance === undefined) {
+                binding.instance = binding.factory(this);
+            }
+            return binding.instance;
+        }
+        return binding.factory(this);
+    }
+    /**
+     * Alias for make() - resolves a token from the container.
+     */
+    resolve(token) {
+        return this.make(token);
+    }
+    /**
+     * Check whether a token has been registered.
+     */
+    has(token) {
+        return this.bindings.has(token);
+    }
+}
+exports.Container = Container;
+//# sourceMappingURL=Container.js.map

package/dist/container/Container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Container.js","sourceRoot":"","sources":["../../src/container/Container.ts"],"names":[],"mappings":";;;AAUA;;;;;;;GAOG;AACH,MAAa,SAAS;IAAtB;QACU,aAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAmE/C,CAAC;IAjEC;;OAEG;IACH,IAAI,CAAI,KAAe,EAAE,OAAmB;QAC1C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC,CAAC;IAC1D,CAAC;IAED;;;OAGG;IACH,SAAS,CAAI,KAAe,EAAE,OAAmB;QAC/C,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACzD,CAAC;IAED;;OAEG;IACH,QAAQ,CAAI,KAAe,EAAE,KAAQ;QACnC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,EAAE;YACvB,OAAO,EAAE,GAAG,EAAE,CAAC,KAAK;YACpB,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE,KAAK;SAChB,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACH,IAAI,CAAI,KAAe;QACrB,IAAI,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QAEvC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,qDAAqD;YACrD,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;gBAChC,OAAO,IAAK,KAAa,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;YACD,MAAM,IAAI,KAAK,CACb,0CAA0C,MAAM,CAAC,KAAK,CAAC,GAAG,CAC3D,CAAC;QACJ,CAAC;QAED,IAAI,OAAO,CAAC,SAAS,EAAE,CAAC;YACtB,IAAI,OAAO,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;gBACnC,OAAO,CAAC,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,OAAO,CAAC,QAAa,CAAC;QAC/B,CAAC;QAED,OAAO,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/B,CAAC;IAED;;OAEG;IACH,OAAO,CAAI,KAAe;QACxB,OAAO,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAC1B,CAAC;IAED;;OAEG;IACH,GAAG,CAAC,KAAY;QACd,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AApED,8BAoEC"}

package/dist/contracts/Application.d.ts

@@ -0,0 +1,15 @@
+export interface Application {
+    getBasePath(): string;
+    getContainer(): any;
+    config(): any;
+    register(provider: any): void;
+    boot(): Promise<void>;
+    run(): Promise<void>;
+    bind(token: any, factory: any): void;
+    singleton(token: any, factory: any): void;
+    instance(token: any, value: any): void;
+    make<T = any>(token: any): T;
+    resolve<T = any>(token: any): T;
+    isBooted(): boolean;
+}
+//# sourceMappingURL=Application.d.ts.map

package/dist/contracts/Application.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Application.d.ts","sourceRoot":"","sources":["../../src/contracts/Application.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,WAAW;IACxB,WAAW,IAAI,MAAM,CAAC;IACtB,YAAY,IAAI,GAAG,CAAC;IACpB,MAAM,IAAI,GAAG,CAAC;IACd,QAAQ,CAAC,QAAQ,EAAE,GAAG,GAAG,IAAI,CAAC;IAC9B,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACrB,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;IACrC,SAAS,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,GAAG,IAAI,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,IAAI,CAAC;IACvC,IAAI,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC;IAC7B,OAAO,CAAC,CAAC,GAAG,GAAG,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC;IAChC,QAAQ,IAAI,OAAO,CAAC;CACvB"}

package/dist/contracts/Application.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Application.js.map

package/dist/contracts/Application.js.map

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

package/dist/contracts/Kernel.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Kernel contract for ArikaJS.
+ *
+ * Kernels are responsible for handling requests in different contexts:
+ * - HTTP kernel handles web requests
+ * - CLI kernel handles command-line commands
+ * - Queue kernel handles background jobs
+ *
+ * Foundation only defines the contract - implementations live in
+ * higher-level packages like @arikajs/http, @arikajs/cli, etc.
+ */
+export interface Kernel {
+    /**
+     * Bootstrap the kernel.
+     * Called once when the kernel is initialized.
+     */
+    bootstrap(): Promise<void> | void;
+    /**
+     * Handle a request/command/job.
+     * The exact signature depends on the kernel type.
+     */
+    handle(...args: any[]): Promise<any> | any;
+}
+//# sourceMappingURL=Kernel.d.ts.map

package/dist/contracts/Kernel.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Kernel.d.ts","sourceRoot":"","sources":["../../src/contracts/Kernel.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,WAAW,MAAM;IACrB;;;OAGG;IACH,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAElC;;;OAGG;IACH,MAAM,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,CAAC,GAAG,GAAG,CAAC;CAC5C"}

package/dist/contracts/Kernel.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=Kernel.js.map

package/dist/contracts/Kernel.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { Application } from './application/Application';
+export * from './container/Container';
+export * from './providers/ServiceProvider';
+export * from './config/Repository';
+export { Application as ApplicationContract } from './contracts/Application';
+export { Kernel as KernelContract } from './contracts/Kernel';
+export * from './support/env';
+export * from './support/config';
+export * from './support/EnvLoader';
+//# 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":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAGxD,cAAc,uBAAuB,CAAC;AAGtC,cAAc,6BAA6B,CAAC;AAG5C,cAAc,qBAAqB,CAAC;AAGpC,OAAO,EAAE,WAAW,IAAI,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAC7E,OAAO,EAAE,MAAM,IAAI,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAG9D,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,qBAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,31 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Application = void 0;
+// Application
+var Application_1 = require("./application/Application");
+Object.defineProperty(exports, "Application", { enumerable: true, get: function () { return Application_1.Application; } });
+// Container
+__exportStar(require("./container/Container"), exports);
+// Service Providers
+__exportStar(require("./providers/ServiceProvider"), exports);
+// Configuration
+__exportStar(require("./config/Repository"), exports);
+// Support
+__exportStar(require("./support/env"), exports);
+__exportStar(require("./support/config"), exports);
+__exportStar(require("./support/EnvLoader"), exports);
+//# 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,cAAc;AACd,yDAAwD;AAA/C,0GAAA,WAAW,OAAA;AAEpB,YAAY;AACZ,wDAAsC;AAEtC,oBAAoB;AACpB,8DAA4C;AAE5C,gBAAgB;AAChB,sDAAoC;AAMpC,UAAU;AACV,gDAA8B;AAC9B,mDAAiC;AACjC,sDAAoC"}

package/dist/providers/ServiceProvider.d.ts

@@ -0,0 +1,25 @@
+import { Application } from '../contracts/Application';
+/**
+ * Base class for service providers in ArikaJS.
+ *
+ * Service providers are the primary way to package and register features.
+ * They follow a two-phase lifecycle:
+ * - register(): Bind services to the container (no heavy side-effects)
+ * - boot(): Perform runtime logic after all providers are registered
+ */
+export declare abstract class ServiceProvider<T extends Application = Application> {
+    protected readonly app: T;
+    constructor(app: T);
+    /**
+     * Register services to the container.
+     * This method is called for all providers before any boot() methods run.
+     */
+    abstract register(): void | Promise<void>;
+    /**
+     * Boot the service provider.
+     * This method is called after all providers have been registered.
+     * Safe to resolve other services here.
+     */
+    boot(): void | Promise<void>;
+}
+//# sourceMappingURL=ServiceProvider.d.ts.map