glasswork 0.1.0

package/dist/core/bootstrap.d.ts

@@ -0,0 +1,55 @@
+import type { AwilixContainer } from 'awilix';
+import type { BootstrapOptions, BootstrapResult, ModuleConfig } from './types.js';
+/**
+ * Bootstrap the application with modules.
+ *
+ * This function:
+ * 1. Creates an Awilix container (PROXY mode for Lambda compatibility)
+ * 2. Registers all module providers
+ * 3. Creates a Hono app
+ * 4. Applies rate limiting middleware (if configured)
+ * 5. Configures OpenAPI (environment-aware)
+ * 6. Mounts module routes
+ * 7. Returns both app and container (container remains accessible!)
+ *
+ * Features:
+ * - Automatic environment detection (development/production/test)
+ * - OpenAPI generation and serving (environment-aware)
+ * - Rate limiting with pluggable storage (memory/DynamoDB)
+ * - Module system with dependency injection
+ *
+ * @example
+ * ```typescript
+ * const { app, container } = bootstrap(AppModule, {
+ *   openapi: {
+ *     enabled: true,
+ *     documentation: { ... }
+ *   },
+ *   rateLimit: {
+ *     enabled: true,
+ *     storage: 'memory'
+ *   }
+ * });
+ *
+ * // Container is still accessible for advanced use
+ * console.log(container.cradle.authService);
+ * container.register({ customService: asClass(CustomService) });
+ * ```
+ */
+export declare function bootstrap(rootModule: ModuleConfig, options?: BootstrapOptions): BootstrapResult;
+/**
+ * Collect all modules (flatten imports recursively)
+ * @internal - exported for testing utilities
+ */
+export declare function collectModules(rootModule: ModuleConfig): ModuleConfig[];
+/**
+ * Validate no circular dependencies between modules
+ * @internal - exported for testing utilities
+ */
+export declare function validateNoCycles(modules: ModuleConfig[]): void;
+/**
+ * Register module providers with Awilix container
+ * @internal - exported for testing utilities
+ */
+export declare function registerModuleProviders(module: ModuleConfig, container: AwilixContainer, logger: import('../utils/logger.js').Logger): void;
+//# sourceMappingURL=bootstrap.d.ts.map

package/dist/core/bootstrap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bootstrap.d.ts","sourceRoot":"","sources":["../../src/core/bootstrap.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAY9C,OAAO,KAAK,EACV,gBAAgB,EAChB,eAAe,EAKf,YAAY,EAKb,MAAM,YAAY,CAAC;AAwBpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAgB,SAAS,CACvB,UAAU,EAAE,YAAY,EACxB,OAAO,GAAE,gBAAqB,GAC7B,eAAe,CA0DjB;AAsKD;;;GAGG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,YAAY,GAAG,YAAY,EAAE,CAuBvE;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,IAAI,CA2C9D;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,YAAY,EACpB,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,OAAO,oBAAoB,EAAE,MAAM,GAC1C,IAAI,CAQN"}

package/dist/core/bootstrap.js

@@ -0,0 +1,329 @@
+import { asClass, asValue, createContainer, InjectionMode } from 'awilix';
+import { Hono } from 'hono';
+import { cors } from 'hono/cors';
+import { logger as honoLogger } from 'hono/logger';
+import { requestId } from 'hono/request-id';
+import { secureHeaders } from 'hono/secure-headers';
+import { defaultErrorHandler } from '../http/error-handler.js';
+import { createRateLimitMiddleware } from '../middleware/rate-limit.js';
+import { configureOpenAPI } from '../openapi/openapi.js';
+import { isLambda } from '../utils/environment.js';
+import { createLogger, createPlainLogger } from '../utils/logger.js';
+/**
+ * Detect environment from NODE_ENV or AWS Lambda context
+ */
+function detectEnvironment() {
+    const nodeEnv = process.env.NODE_ENV;
+    if (nodeEnv === 'production') {
+        return 'production';
+    }
+    if (nodeEnv === 'test') {
+        return 'test';
+    }
+    // Check if running in AWS Lambda
+    if (process.env.AWS_LAMBDA_FUNCTION_NAME || process.env.LAMBDA_TASK_ROOT) {
+        return 'production';
+    }
+    return 'development';
+}
+/**
+ * Bootstrap the application with modules.
+ *
+ * This function:
+ * 1. Creates an Awilix container (PROXY mode for Lambda compatibility)
+ * 2. Registers all module providers
+ * 3. Creates a Hono app
+ * 4. Applies rate limiting middleware (if configured)
+ * 5. Configures OpenAPI (environment-aware)
+ * 6. Mounts module routes
+ * 7. Returns both app and container (container remains accessible!)
+ *
+ * Features:
+ * - Automatic environment detection (development/production/test)
+ * - OpenAPI generation and serving (environment-aware)
+ * - Rate limiting with pluggable storage (memory/DynamoDB)
+ * - Module system with dependency injection
+ *
+ * @example
+ * ```typescript
+ * const { app, container } = bootstrap(AppModule, {
+ *   openapi: {
+ *     enabled: true,
+ *     documentation: { ... }
+ *   },
+ *   rateLimit: {
+ *     enabled: true,
+ *     storage: 'memory'
+ *   }
+ * });
+ *
+ * // Container is still accessible for advanced use
+ * console.log(container.cradle.authService);
+ * container.register({ customService: asClass(CustomService) });
+ * ```
+ */
+export function bootstrap(rootModule, options = {}) {
+    const { apiBasePath = '/api', debug = false, environment = detectEnvironment(), errorHandler = defaultErrorHandler, openapi, rateLimit, middleware, logger, } = options;
+    // Create logger for bootstrap process
+    const bootstrapLogger = createLogger('Glasswork', debug);
+    // Create Awilix container with PROXY mode (Lambda-compatible)
+    const container = createContainer({
+        injectionMode: InjectionMode.PROXY,
+        strict: true,
+    });
+    bootstrapLogger.info('Bootstrapping application...');
+    // Collect all modules (flatten imports)
+    const allModules = collectModules(rootModule);
+    bootstrapLogger.info(`Found ${allModules.length} modules: ${allModules.map((m) => m.name).join(', ')}`);
+    // Validate no circular dependencies
+    validateNoCycles(allModules);
+    // Register all providers
+    for (const module of allModules) {
+        bootstrapLogger.info(`Registering module: ${module.name}`);
+        registerModuleProviders(module, container, bootstrapLogger);
+    }
+    // Create Hono app and apply middleware
+    const app = createApp({
+        environment,
+        errorHandler,
+        openapi,
+        rateLimit,
+        middleware,
+        logger,
+        bootstrapLogger,
+    });
+    // Mount module routes
+    mountModuleRoutes({ app, modules: allModules, container, apiBasePath, bootstrapLogger });
+    bootstrapLogger.info('Bootstrap complete');
+    bootstrapLogger.info(`Environment: ${environment}`);
+    bootstrapLogger.info(`Registered ${Object.keys(container.cradle).length} services`);
+    return { app, container };
+}
+/**
+ * Create Hono app and apply middleware
+ */
+function createApp(options) {
+    const app = new Hono();
+    applyErrorHandler(app, options);
+    applySecurityMiddleware(app, options);
+    applyLoggingMiddleware(app, options);
+    applyRateLimiting(app, options);
+    applyOpenAPIDocumentation(app, options);
+    return app;
+}
+/**
+ * Apply error handler to the app
+ */
+function applyErrorHandler(app, { errorHandler, bootstrapLogger, }) {
+    if (errorHandler === false)
+        return;
+    bootstrapLogger.info('Applying error handler');
+    app.onError(errorHandler);
+}
+/**
+ * Apply security-related middleware (secure headers, request ID, CORS)
+ */
+function applySecurityMiddleware(app, { environment, middleware, bootstrapLogger, }) {
+    // Secure headers (default: true in production)
+    if (middleware?.secureHeaders !== false && environment === 'production') {
+        bootstrapLogger.info('Applying secure headers');
+        app.use(secureHeaders());
+    }
+    // Request ID (default: true)
+    if (middleware?.requestId !== false) {
+        bootstrapLogger.info('Applying request ID middleware');
+        app.use(requestId());
+    }
+    // CORS
+    if (middleware?.cors) {
+        bootstrapLogger.info('Applying CORS middleware');
+        app.use(cors(middleware.cors));
+    }
+}
+/**
+ * Apply logging middleware
+ */
+function applyLoggingMiddleware(app, { logger, bootstrapLogger, }) {
+    if (logger?.enabled === false)
+        return;
+    // Auto-detect plain mode based on environment if not specified
+    const usePlainLogger = logger?.plain ?? isLambda();
+    bootstrapLogger.info(`Applying logger (plain: ${usePlainLogger})`);
+    app.use(usePlainLogger ? createPlainLogger() : honoLogger());
+}
+/**
+ * Apply rate limiting middleware
+ */
+function applyRateLimiting(app, { rateLimit, bootstrapLogger, }) {
+    if (!rateLimit?.enabled)
+        return;
+    bootstrapLogger.info(`Rate limiting enabled (${rateLimit.storage} storage, ${rateLimit.maxRequests || 100} req/${rateLimit.windowMs || 60000}ms)`);
+    app.use(createRateLimitMiddleware(rateLimit));
+}
+/**
+ * Apply OpenAPI documentation
+ */
+function applyOpenAPIDocumentation(app, options) {
+    const { environment, openapi, rateLimit, middleware, bootstrapLogger } = options;
+    if (!openapi?.enabled)
+        return;
+    bootstrapLogger.info('Configuring OpenAPI');
+    configureOpenAPI({ app, environment, openapi, rateLimit, middleware });
+}
+/**
+ * Mount module routes to the app
+ */
+function mountModuleRoutes(options) {
+    const { app, modules, container, apiBasePath, bootstrapLogger } = options;
+    for (const module of modules) {
+        if (!module.routes || !module.basePath) {
+            continue;
+        }
+        bootstrapLogger.info(`Mounting routes: ${apiBasePath}/${module.basePath}`);
+        const router = new Hono();
+        // Call route factory with router and services
+        module.routes(router, container.cradle);
+        // Mount at base path
+        app.route(`${apiBasePath}/${module.basePath}`, router);
+    }
+}
+/**
+ * Collect all modules (flatten imports recursively)
+ * @internal - exported for testing utilities
+ */
+export function collectModules(rootModule) {
+    const modules = new Map();
+    const visited = new Set();
+    function collect(module) {
+        if (visited.has(module.name)) {
+            return;
+        }
+        visited.add(module.name);
+        modules.set(module.name, module);
+        // Recursively collect imports
+        if (module.imports) {
+            for (const importedModule of module.imports) {
+                collect(importedModule);
+            }
+        }
+    }
+    collect(rootModule);
+    return Array.from(modules.values());
+}
+/**
+ * Validate no circular dependencies between modules
+ * @internal - exported for testing utilities
+ */
+export function validateNoCycles(modules) {
+    const graph = new Map();
+    // Build dependency graph
+    for (const module of modules) {
+        if (!graph.has(module.name)) {
+            graph.set(module.name, new Set());
+        }
+        if (module.imports) {
+            for (const importedModule of module.imports) {
+                graph.get(module.name)?.add(importedModule.name);
+            }
+        }
+    }
+    // Detect cycles using DFS
+    const visiting = new Set();
+    const visited = new Set();
+    function visit(name, path) {
+        if (visiting.has(name)) {
+            throw new Error(`Circular dependency detected: ${[...path, name].join(' -> ')}`);
+        }
+        if (visited.has(name)) {
+            return;
+        }
+        visiting.add(name);
+        const dependencies = graph.get(name) || new Set();
+        for (const dep of dependencies) {
+            visit(dep, [...path, name]);
+        }
+        visiting.delete(name);
+        visited.add(name);
+    }
+    for (const module of modules) {
+        visit(module.name, []);
+    }
+}
+/**
+ * Register module providers with Awilix container
+ * @internal - exported for testing utilities
+ */
+export function registerModuleProviders(module, container, logger) {
+    if (!module.providers) {
+        return;
+    }
+    for (const provider of module.providers) {
+        registerProvider(provider, container, module.name, logger);
+    }
+}
+/**
+ * Register a single provider with Awilix
+ */
+function registerProvider(provider, container, moduleName, logger) {
+    if (typeof provider === 'function') {
+        registerClassProvider(provider, container, logger);
+        return;
+    }
+    if ('useClass' in provider) {
+        registerExplicitClassProvider(provider, container, logger);
+        return;
+    }
+    if ('useValue' in provider) {
+        registerValueProvider(provider, container, logger);
+        return;
+    }
+    if ('useFactory' in provider) {
+        registerFactoryProvider(provider, container, logger);
+        return;
+    }
+    throw new Error(`Invalid provider configuration in module "${moduleName}"`);
+}
+function registerClassProvider(provider, container, logger) {
+    const name = camelCase(provider.name);
+    logger.info(`  - Registering ${name} (${provider.name})`);
+    container.register({
+        [name]: asClass(provider).singleton(),
+    });
+}
+function registerExplicitClassProvider(provider, container, logger) {
+    const name = typeof provider.provide === 'string' ? provider.provide : camelCase(provider.provide.name);
+    const scope = provider.scope || 'SINGLETON';
+    logger.info(`  - Registering ${name} (scope: ${scope})`);
+    const registration = asClass(provider.useClass);
+    container.register({
+        [name]: applyScopeToRegistration(registration, scope),
+    });
+}
+function registerValueProvider(provider, container, logger) {
+    logger.info(`  - Registering ${provider.provide} (value)`);
+    container.register({
+        [provider.provide]: asValue(provider.useValue),
+    });
+}
+function registerFactoryProvider(provider, container, logger) {
+    logger.info(`  - Registering ${provider.provide} (factory)`);
+    container.register({
+        [provider.provide]: asValue(provider.useFactory(container)),
+    });
+}
+function applyScopeToRegistration(registration, scope) {
+    if (scope === 'SCOPED') {
+        return registration.scoped();
+    }
+    if (scope === 'TRANSIENT') {
+        return registration.transient();
+    }
+    return registration.singleton();
+}
+/**
+ * Convert PascalCase to camelCase
+ */
+function camelCase(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+//# sourceMappingURL=bootstrap.js.map

package/dist/core/bootstrap.js.map

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

package/dist/core/module.d.ts

@@ -0,0 +1,21 @@
+import type { ModuleConfig } from './types.js';
+/**
+ * Define a module with providers, imports, and routes.
+ *
+ * This is a pure metadata function - it just returns the configuration.
+ * The actual registration happens in the bootstrap function.
+ *
+ * @example
+ * ```typescript
+ * export const AuthModule = defineModule({
+ *   name: 'auth',
+ *   basePath: 'auth',
+ *   providers: [AuthService, UserService],
+ *   imports: [CommonModule],
+ *   exports: [AuthService],
+ *   routes: AuthRoutes,
+ * });
+ * ```
+ */
+export declare function defineModule(config: ModuleConfig): ModuleConfig;
+//# sourceMappingURL=module.d.ts.map

package/dist/core/module.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"module.d.ts","sourceRoot":"","sources":["../../src/core/module.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAe,YAAY,EAAkB,MAAM,YAAY,CAAC;AAE5E;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAG/D"}

package/dist/core/module.js

@@ -0,0 +1,85 @@
+/**
+ * Define a module with providers, imports, and routes.
+ *
+ * This is a pure metadata function - it just returns the configuration.
+ * The actual registration happens in the bootstrap function.
+ *
+ * @example
+ * ```typescript
+ * export const AuthModule = defineModule({
+ *   name: 'auth',
+ *   basePath: 'auth',
+ *   providers: [AuthService, UserService],
+ *   imports: [CommonModule],
+ *   exports: [AuthService],
+ *   routes: AuthRoutes,
+ * });
+ * ```
+ */
+export function defineModule(config) {
+    validateModuleConfig(config);
+    return config;
+}
+function validateModuleConfig(config) {
+    validateModuleName(config.name);
+    validateProviders(config);
+    validateExports(config);
+}
+function validateModuleName(name) {
+    if (!name) {
+        throw new Error('Module name is required');
+    }
+    if (name.includes('/') || name.includes(' ')) {
+        throw new Error('Module name must not contain "/" or spaces');
+    }
+}
+function validateProviders(config) {
+    if (!config.providers) {
+        return;
+    }
+    for (const provider of config.providers) {
+        if (typeof provider !== 'function' && typeof provider !== 'object') {
+            throw new Error(`Invalid provider in module "${config.name}"`);
+        }
+    }
+}
+function validateExports(config) {
+    if (!config.exports || !config.providers) {
+        return;
+    }
+    const providerNames = collectProviderNames(config.providers);
+    for (const exp of config.exports) {
+        const exportName = getProviderName(exp);
+        if (!providerNames.has(exportName)) {
+            throw new Error(`Module "${config.name}" exports "${exportName}" but it's not in providers`);
+        }
+    }
+}
+function collectProviderNames(providers) {
+    const names = new Set();
+    for (const provider of providers) {
+        names.add(getProviderName(provider));
+    }
+    return names;
+}
+function getProviderName(provider) {
+    if (typeof provider === 'string') {
+        return provider;
+    }
+    if (typeof provider === 'function') {
+        return camelCase(provider.name);
+    }
+    if ('provide' in provider) {
+        return typeof provider.provide === 'string'
+            ? provider.provide
+            : camelCase(provider.provide.name);
+    }
+    return '';
+}
+/**
+ * Convert PascalCase to camelCase
+ */
+function camelCase(str) {
+    return str.charAt(0).toLowerCase() + str.slice(1);
+}
+//# sourceMappingURL=module.js.map

package/dist/core/module.js.map

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