glasswork 0.1.0

package/dist/core/types.d.ts

@@ -0,0 +1,273 @@
+import type { AwilixContainer } from 'awilix';
+import type { ErrorHandler, Hono } from 'hono';
+/**
+ * Service lifetime scope for dependency injection
+ */
+export type ServiceScope = 'SINGLETON' | 'SCOPED' | 'TRANSIENT';
+/**
+ * Constructor type for class providers
+ *
+ * We use `any[]` for constructor arguments because in dependency injection,
+ * we can't know at compile time what arguments will be injected - that's
+ * determined by the DI container at runtime. This is a legitimate use of `any`.
+ */
+export type Constructor<T = unknown> = new (...args: any[]) => T;
+/**
+ * Provider configuration for dependency injection
+ */
+export type ProviderConfig = Constructor | {
+    provide: string | Constructor;
+    useClass: Constructor;
+    scope?: ServiceScope;
+} | {
+    provide: string;
+    useValue: unknown;
+} | {
+    provide: string;
+    useFactory: (container: unknown) => unknown;
+    inject?: string[];
+};
+/**
+ * Route factory function that receives Hono router and services
+ */
+export type RouteFactory = (router: Hono, services: Record<string, unknown>) => void;
+/**
+ * Module configuration
+ */
+export interface ModuleConfig {
+    /**
+     * Unique module name
+     */
+    name: string;
+    /**
+     * Base path for routes (e.g., 'auth' becomes /api/auth)
+     */
+    basePath?: string;
+    /**
+     * Service providers to register
+     */
+    providers?: ProviderConfig[];
+    /**
+     * Modules to import (access their exported providers)
+     */
+    imports?: ModuleConfig[];
+    /**
+     * Providers to export (available to importing modules)
+     */
+    exports?: (Constructor | string)[];
+    /**
+     * Route factory function
+     */
+    routes?: RouteFactory;
+}
+/**
+ * Environment type for conditional behavior
+ */
+export type Environment = 'development' | 'production' | 'test';
+/**
+ * OpenAPI documentation configuration
+ */
+export interface OpenAPIDocumentation {
+    info: {
+        title: string;
+        version: string;
+        description?: string;
+        contact?: {
+            name?: string;
+            email?: string;
+            url?: string;
+        };
+    };
+    tags?: Array<{
+        name: string;
+        description?: string;
+    }>;
+    servers?: Array<{
+        url: string;
+        description?: string;
+    }>;
+    components?: Record<string, unknown>;
+}
+/**
+ * Hook function for customizing OpenAPI responses
+ *
+ * Receives the response object and context, returns modified response.
+ * This allows both framework and applications to add headers, modify
+ * descriptions, etc. globally across all routes.
+ */
+export type OpenAPIResponseHook = (response: {
+    description: string;
+    headers?: Record<string, {
+        $ref: string;
+    }>;
+    content?: Record<string, unknown>;
+}, context: {
+    statusCode: string;
+    routeConfig: {
+        public?: boolean;
+        paginate?: boolean;
+        tags?: string[];
+        summary?: string;
+    };
+}) => {
+    description: string;
+    headers?: Record<string, {
+        $ref: string;
+    }>;
+    content?: Record<string, unknown>;
+};
+/**
+ * OpenAPI configuration options
+ */
+export interface OpenAPIOptions {
+    /**
+     * Whether to enable OpenAPI generation
+     */
+    enabled?: boolean;
+    /**
+     * Serve OpenAPI specs at /api/openapi.json (default: true in development)
+     */
+    serveSpecs?: boolean;
+    /**
+     * Serve Swagger UI at /api (default: true in development)
+     */
+    serveUI?: boolean;
+    /**
+     * Write OpenAPI specs to file (path relative to cwd)
+     */
+    writeToFile?: string;
+    /**
+     * OpenAPI documentation
+     */
+    documentation?: OpenAPIDocumentation;
+    /**
+     * Response hooks for customizing OpenAPI responses
+     *
+     * Hooks are applied in order to each response object.
+     * Use this to add custom headers, modify descriptions, etc.
+     */
+    responseHooks?: OpenAPIResponseHook[];
+}
+/**
+ * Rate limiting storage backend
+ */
+export type RateLimitStorage = 'memory' | 'dynamodb';
+/**
+ * Rate limiting configuration
+ */
+export interface RateLimitOptions {
+    /**
+     * Whether rate limiting is enabled
+     */
+    enabled: boolean;
+    /**
+     * Storage backend
+     */
+    storage: RateLimitStorage;
+    /**
+     * Rate limit window in milliseconds (default: 60000 = 1 minute)
+     */
+    windowMs?: number;
+    /**
+     * Maximum requests per window (default: 100)
+     */
+    maxRequests?: number;
+    /**
+     * DynamoDB configuration (required if storage is 'dynamodb')
+     */
+    dynamodb?: {
+        tableName: string;
+        region?: string;
+    };
+}
+/**
+ * Middleware configuration options
+ */
+export interface MiddlewareOptions {
+    /**
+     * Enable request ID middleware
+     * @default true
+     */
+    requestId?: boolean;
+    /**
+     * Enable secure headers middleware
+     * @default true in production
+     */
+    secureHeaders?: boolean;
+    /**
+     * CORS configuration
+     */
+    cors?: {
+        origin: string | string[];
+        credentials?: boolean;
+    };
+}
+/**
+ * Logger configuration options
+ */
+export interface LoggerOptions {
+    /**
+     * Enable HTTP request logging
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Use plain logger (no ANSI colors) for Lambda/CloudWatch
+     * Auto-detected based on environment if not specified
+     */
+    plain?: boolean;
+}
+/**
+ * Bootstrap options
+ */
+export interface BootstrapOptions {
+    /**
+     * Environment (auto-detected from NODE_ENV if not provided)
+     */
+    environment?: Environment;
+    /**
+     * API base path (default: '/api')
+     */
+    apiBasePath?: string;
+    /**
+     * Error handler middleware
+     * Set to false to disable default error handler
+     * Provide a custom ErrorHandler to override
+     * @default Glasswork's default error handler
+     */
+    errorHandler?: ErrorHandler | false;
+    /**
+     * OpenAPI configuration
+     */
+    openapi?: OpenAPIOptions;
+    /**
+     * Rate limiting configuration
+     */
+    rateLimit?: RateLimitOptions;
+    /**
+     * Common middleware configuration
+     */
+    middleware?: MiddlewareOptions;
+    /**
+     * Logger configuration
+     */
+    logger?: LoggerOptions;
+    /**
+     * Enable debug logging
+     */
+    debug?: boolean;
+}
+/**
+ * Bootstrap result
+ */
+export interface BootstrapResult {
+    /**
+     * Hono application instance
+     */
+    app: Hono;
+    /**
+     * Awilix container (fully accessible)
+     */
+    container: AwilixContainer;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/core/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAE/C;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,WAAW,CAAC;AAEhE;;;;;;GAMG;AAEH,MAAM,MAAM,WAAW,CAAC,CAAC,GAAG,OAAO,IAAI,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,CAAC;AAEjE;;GAEG;AACH,MAAM,MAAM,cAAc,GACtB,WAAW,GACX;IACE,OAAO,EAAE,MAAM,GAAG,WAAW,CAAC;IAC9B,QAAQ,EAAE,WAAW,CAAC;IACtB,KAAK,CAAC,EAAE,YAAY,CAAC;CACtB,GACD;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;CACnB,GACD;IACE,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,CAAC,SAAS,EAAE,OAAO,KAAK,OAAO,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB,CAAC;AAEN;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAAC;AAErF;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAE7B;;OAEG;IACH,OAAO,CAAC,EAAE,YAAY,EAAE,CAAC;IAEzB;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,WAAW,GAAG,MAAM,CAAC,EAAE,CAAC;IAEnC;;OAEG;IACH,MAAM,CAAC,EAAE,YAAY,CAAC;CACvB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,aAAa,GAAG,YAAY,GAAG,MAAM,CAAC;AAEhE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE;QACJ,KAAK,EAAE,MAAM,CAAC;QACd,OAAO,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,OAAO,CAAC,EAAE;YACR,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,GAAG,CAAC,EAAE,MAAM,CAAC;SACd,CAAC;KACH,CAAC;IACF,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;GAMG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAChC,QAAQ,EAAE;IACR,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,EACD,OAAO,EAAE;IACP,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE;QACX,MAAM,CAAC,EAAE,OAAO,CAAC;QACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;CACH,KACE;IACH,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,UAAU,CAAC,EAAE,OAAO,CAAC;IAErB;;OAEG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,oBAAoB,CAAC;IAErC;;;;;OAKG;IACH,aAAa,CAAC,EAAE,mBAAmB,EAAE,CAAC;CACvC;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAErD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,OAAO,EAAE,OAAO,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,gBAAgB,CAAC;IAE1B;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;OAEG;IACH,QAAQ,CAAC,EAAE;QACT,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,CAAC,EAAE,MAAM,CAAC;KACjB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IAEpB;;;OAGG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IAExB;;OAEG;IACH,IAAI,CAAC,EAAE;QACL,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC;QAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;KACvB,CAAC;CACH;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,WAAW,CAAC,EAAE,WAAW,CAAC;IAE1B;;OAEG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;;OAKG;IACH,YAAY,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC;IAEpC;;OAEG;IACH,OAAO,CAAC,EAAE,cAAc,CAAC;IAEzB;;OAEG;IACH,SAAS,CAAC,EAAE,gBAAgB,CAAC;IAE7B;;OAEG;IACH,UAAU,CAAC,EAAE,iBAAiB,CAAC;IAE/B;;OAEG;IACH,MAAM,CAAC,EAAE,aAAa,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;OAEG;IACH,GAAG,EAAE,IAAI,CAAC;IAEV;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;CAC5B"}

package/dist/core/types.js

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

package/dist/core/types.js.map

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

package/dist/environment.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Environment detection utilities for serverless and local development.
+ */
+/**
+ * Check if running in AWS Lambda environment
+ */
+export declare function isLambda(): boolean;
+/**
+ * Check if running in production environment
+ * (either NODE_ENV=production or in Lambda)
+ */
+export declare function isProduction(): boolean;
+/**
+ * Check if running in test environment
+ */
+export declare function isTest(): boolean;
+/**
+ * Check if running in development environment
+ */
+export declare function isDevelopment(): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAElC;AAED;;;GAGG;AACH,wBAAgB,YAAY,IAAI,OAAO,CAEtC;AAED;;GAEG;AACH,wBAAgB,MAAM,IAAI,OAAO,CAEhC;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,OAAO,CAEvC"}

package/dist/environment.js

@@ -0,0 +1,29 @@
+/**
+ * Environment detection utilities for serverless and local development.
+ */
+/**
+ * Check if running in AWS Lambda environment
+ */
+export function isLambda() {
+    return !!(process.env.AWS_LAMBDA_FUNCTION_NAME || process.env.LAMBDA_TASK_ROOT);
+}
+/**
+ * Check if running in production environment
+ * (either NODE_ENV=production or in Lambda)
+ */
+export function isProduction() {
+    return process.env.NODE_ENV === 'production' || isLambda();
+}
+/**
+ * Check if running in test environment
+ */
+export function isTest() {
+    return process.env.NODE_ENV === 'test';
+}
+/**
+ * Check if running in development environment
+ */
+export function isDevelopment() {
+    return !isProduction() && !isTest();
+}
+//# sourceMappingURL=environment.js.map

package/dist/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../src/environment.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,wBAAwB,IAAI,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC,CAAC;AAClF,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY;IAC1B,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,QAAQ,EAAE,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,MAAM;IACpB,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,CAAC;AACzC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa;IAC3B,OAAO,CAAC,YAAY,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC;AACtC,CAAC"}

package/dist/error-handler.d.ts

@@ -0,0 +1,33 @@
+import type { Context, ErrorHandler } from 'hono';
+import type { ContentfulStatusCode } from 'hono/utils/http-status';
+interface FormattedError {
+    message: string;
+    statusCode: ContentfulStatusCode;
+}
+interface ErrorHandlerOptions {
+    /**
+     * Whether to log errors to console
+     * @default true in development, false in test
+     */
+    logErrors?: boolean;
+    /**
+     * Custom error response handler
+     */
+    responseHandler?: (error: FormattedError, context: Context) => Response | Promise<Response>;
+}
+/**
+ * Create an error handler middleware for Hono
+ *
+ * Handles:
+ * - DomainException (custom business logic exceptions)
+ * - HTTPException (Hono's built-in HTTP exceptions)
+ * - Validation errors (returns 422)
+ * - Generic errors (returns 500)
+ */
+export declare function createErrorHandler(options?: ErrorHandlerOptions): ErrorHandler;
+/**
+ * Default error handler instance
+ */
+export declare const defaultErrorHandler: ErrorHandler;
+export {};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAGnE,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,UAAU,mBAAmB;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7F;AAcD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA+BlF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,cAAuB,CAAC"}

package/dist/error-handler.js

@@ -0,0 +1,53 @@
+import { HTTPException } from 'hono/http-exception';
+import { DomainException, getStatusCodeFromErrorCode } from './errors.js';
+/**
+ * Default response handler - returns JSON error
+ */
+function defaultResponseHandler(error, context) {
+    return context.json({
+        error: error.message,
+    }, error.statusCode);
+}
+/**
+ * Create an error handler middleware for Hono
+ *
+ * Handles:
+ * - DomainException (custom business logic exceptions)
+ * - HTTPException (Hono's built-in HTTP exceptions)
+ * - Validation errors (returns 422)
+ * - Generic errors (returns 500)
+ */
+export function createErrorHandler(options = {}) {
+    const { logErrors = process.env.NODE_ENV !== 'test', responseHandler = defaultResponseHandler } = options;
+    return (err, context) => {
+        let error;
+        if (err instanceof DomainException) {
+            const statusCode = getStatusCodeFromErrorCode(err.code);
+            error = { message: err.message, statusCode: statusCode };
+            if (logErrors && statusCode === 500) {
+                console.error('[Glasswork] DomainException with unknown code:', err);
+            }
+        }
+        else if (err instanceof HTTPException) {
+            error = {
+                message: err.message,
+                statusCode: err.status,
+            };
+        }
+        else {
+            if (logErrors) {
+                console.error('[Glasswork] Unhandled error:', err);
+            }
+            error = {
+                message: 'Internal server error',
+                statusCode: 500,
+            };
+        }
+        return responseHandler(error, context);
+    };
+}
+/**
+ * Default error handler instance
+ */
+export const defaultErrorHandler = createErrorHandler();
+//# sourceMappingURL=error-handler.js.map

package/dist/error-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.js","sourceRoot":"","sources":["../src/error-handler.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,eAAe,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAmB1E;;GAEG;AACH,SAAS,sBAAsB,CAAC,KAAqB,EAAE,OAAgB;IACrE,OAAO,OAAO,CAAC,IAAI,CACjB;QACE,KAAK,EAAE,KAAK,CAAC,OAAO;KACrB,EACD,KAAK,CAAC,UAAU,CACjB,CAAC;AACJ,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,kBAAkB,CAAC,UAA+B,EAAE;IAClE,MAAM,EAAE,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,eAAe,GAAG,sBAAsB,EAAE,GAC7F,OAAO,CAAC;IAEV,OAAO,CAAC,GAAG,EAAE,OAAO,EAAE,EAAE;QACtB,IAAI,KAAqB,CAAC;QAE1B,IAAI,GAAG,YAAY,eAAe,EAAE,CAAC;YACnC,MAAM,UAAU,GAAG,0BAA0B,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACxD,KAAK,GAAG,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,UAAU,EAAE,UAAkC,EAAE,CAAC;YAEjF,IAAI,SAAS,IAAI,UAAU,KAAK,GAAG,EAAE,CAAC;gBACpC,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,GAAG,CAAC,CAAC;YACvE,CAAC;QACH,CAAC;aAAM,IAAI,GAAG,YAAY,aAAa,EAAE,CAAC;YACxC,KAAK,GAAG;gBACN,OAAO,EAAE,GAAG,CAAC,OAAO;gBACpB,UAAU,EAAE,GAAG,CAAC,MAAM;aACvB,CAAC;QACJ,CAAC;aAAM,CAAC;YACN,IAAI,SAAS,EAAE,CAAC;gBACd,OAAO,CAAC,KAAK,CAAC,8BAA8B,EAAE,GAAG,CAAC,CAAC;YACrD,CAAC;YACD,KAAK,GAAG;gBACN,OAAO,EAAE,uBAAuB;gBAChC,UAAU,EAAE,GAAG;aAChB,CAAC;QACJ,CAAC;QAED,OAAO,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC;IACzC,CAAC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,EAAE,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Base domain exception class for business logic errors
+ */
+export declare class DomainException extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+/**
+ * Standard HTTP exception classes
+ */
+export declare class ValidationException extends DomainException {
+    constructor(message?: string);
+}
+export declare class UnauthorizedException extends DomainException {
+    constructor(message?: string);
+}
+export declare class NotFoundException extends DomainException {
+    constructor(message?: string);
+}
+export declare class ConflictException extends DomainException {
+    constructor(message?: string);
+}
+export declare class ForbiddenException extends DomainException {
+    constructor(message?: string);
+}
+export declare class BadRequestException extends DomainException {
+    constructor(message?: string);
+}
+export declare class TooManyRequestsException extends DomainException {
+    constructor(message?: string);
+}
+/**
+ * Map error codes to HTTP status codes
+ */
+export declare function getStatusCodeFromErrorCode(code: string): number;
+//# 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,eAAgB,SAAQ,KAAK;aAGtB,IAAI,EAAE,MAAM;gBAD5B,OAAO,EAAE,MAAM,EACC,IAAI,EAAE,MAAM;CAK/B;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,SAAqB;CAGzC;AAED,qBAAa,qBAAsB,SAAQ,eAAe;gBAC5C,OAAO,SAAiB;CAGrC;AAED,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,SAAc;CAGlC;AAED,qBAAa,iBAAkB,SAAQ,eAAe;gBACxC,OAAO,SAAa;CAGjC;AAED,qBAAa,kBAAmB,SAAQ,eAAe;gBACzC,OAAO,SAAc;CAGlC;AAED,qBAAa,mBAAoB,SAAQ,eAAe;gBAC1C,OAAO,SAAgB;CAGpC;AAED,qBAAa,wBAAyB,SAAQ,eAAe;gBAC/C,OAAO,SAAsB;CAG1C;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAY/D"}

package/dist/errors.js

@@ -0,0 +1,65 @@
+/**
+ * Base domain exception class for business logic errors
+ */
+export class DomainException extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = this.constructor.name;
+    }
+}
+/**
+ * Standard HTTP exception classes
+ */
+export class ValidationException extends DomainException {
+    constructor(message = 'Validation error') {
+        super(message, 'VALIDATION_ERROR');
+    }
+}
+export class UnauthorizedException extends DomainException {
+    constructor(message = 'Unauthorized') {
+        super(message, 'UNAUTHORIZED');
+    }
+}
+export class NotFoundException extends DomainException {
+    constructor(message = 'Not found') {
+        super(message, 'NOT_FOUND');
+    }
+}
+export class ConflictException extends DomainException {
+    constructor(message = 'Conflict') {
+        super(message, 'CONFLICT');
+    }
+}
+export class ForbiddenException extends DomainException {
+    constructor(message = 'Forbidden') {
+        super(message, 'FORBIDDEN');
+    }
+}
+export class BadRequestException extends DomainException {
+    constructor(message = 'Bad request') {
+        super(message, 'BAD_REQUEST');
+    }
+}
+export class TooManyRequestsException extends DomainException {
+    constructor(message = 'Too many requests') {
+        super(message, 'TOO_MANY_REQUESTS');
+    }
+}
+/**
+ * Map error codes to HTTP status codes
+ */
+export function getStatusCodeFromErrorCode(code) {
+    const codeMap = {
+        BAD_REQUEST: 400,
+        UNAUTHORIZED: 401,
+        FORBIDDEN: 403,
+        NOT_FOUND: 404,
+        CONFLICT: 409,
+        VALIDATION_ERROR: 422,
+        TOO_MANY_REQUESTS: 429,
+    };
+    return codeMap[code] || 500;
+}
+//# 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,eAAgB,SAAQ,KAAK;IAGtB;IAFlB,YACE,OAAe,EACC,IAAY;QAE5B,KAAK,CAAC,OAAO,CAAC,CAAC;QAFC,SAAI,GAAJ,IAAI,CAAQ;QAG5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAO,GAAG,kBAAkB;QACtC,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;IACrC,CAAC;CACF;AAED,MAAM,OAAO,qBAAsB,SAAQ,eAAe;IACxD,YAAY,OAAO,GAAG,cAAc;QAClC,KAAK,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IACjC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,YAAY,OAAO,GAAG,WAAW;QAC/B,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,eAAe;IACpD,YAAY,OAAO,GAAG,UAAU;QAC9B,KAAK,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,OAAO,kBAAmB,SAAQ,eAAe;IACrD,YAAY,OAAO,GAAG,WAAW;QAC/B,KAAK,CAAC,OAAO,EAAE,WAAW,CAAC,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAO,GAAG,aAAa;QACjC,KAAK,CAAC,OAAO,EAAE,aAAa,CAAC,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,wBAAyB,SAAQ,eAAe;IAC3D,YAAY,OAAO,GAAG,mBAAmB;QACvC,KAAK,CAAC,OAAO,EAAE,mBAAmB,CAAC,CAAC;IACtC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,UAAU,0BAA0B,CAAC,IAAY;IACrD,MAAM,OAAO,GAA2B;QACtC,WAAW,EAAE,GAAG;QAChB,YAAY,EAAE,GAAG;QACjB,SAAS,EAAE,GAAG;QACd,SAAS,EAAE,GAAG;QACd,QAAQ,EAAE,GAAG;QACb,gBAAgB,EAAE,GAAG;QACrB,iBAAiB,EAAE,GAAG;KACvB,CAAC;IAEF,OAAO,OAAO,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC;AAC9B,CAAC"}

package/dist/get-client-ip.d.ts

@@ -0,0 +1,24 @@
+import type { Context } from 'hono';
+/**
+ * Extract the client IP address from Hono context.
+ *
+ * Checks headers in order:
+ * 1. x-forwarded-for (proxy/load balancer)
+ * 2. x-real-ip (nginx)
+ * 3. Direct connection info (if available)
+ *
+ * @param c - Hono context
+ * @returns Client IP address or 'unknown' if not determinable
+ *
+ * @example
+ * ```typescript
+ * router.post('/login', route({
+ *   handler: async ({ ip }) => {
+ *     // ip is automatically populated
+ *     await authService.logLoginAttempt(email, ip);
+ *   }
+ * }));
+ * ```
+ */
+export declare function getClientIp(c: Context): string;
+//# sourceMappingURL=get-client-ip.d.ts.map

package/dist/get-client-ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-client-ip.d.ts","sourceRoot":"","sources":["../src/get-client-ip.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,WAAW,CAAC,CAAC,EAAE,OAAO,GAAG,MAAM,CA0B9C"}

package/dist/get-client-ip.js

@@ -0,0 +1,49 @@
+/**
+ * Extract the client IP address from Hono context.
+ *
+ * Checks headers in order:
+ * 1. x-forwarded-for (proxy/load balancer)
+ * 2. x-real-ip (nginx)
+ * 3. Direct connection info (if available)
+ *
+ * @param c - Hono context
+ * @returns Client IP address or 'unknown' if not determinable
+ *
+ * @example
+ * ```typescript
+ * router.post('/login', route({
+ *   handler: async ({ ip }) => {
+ *     // ip is automatically populated
+ *     await authService.logLoginAttempt(email, ip);
+ *   }
+ * }));
+ * ```
+ */
+export function getClientIp(c) {
+    // Check x-forwarded-for header (proxy/load balancer)
+    const xForwardedFor = c.req.header('x-forwarded-for');
+    if (xForwardedFor) {
+        const ip = xForwardedFor.split(',')[0].trim();
+        if (ip)
+            return ip;
+    }
+    // Check x-real-ip header (nginx)
+    const xRealIp = c.req.header('x-real-ip');
+    if (xRealIp)
+        return xRealIp;
+    // Try to get connection info (Node.js server)
+    try {
+        // Dynamic import to avoid bundling @hono/node-server in Lambda
+        // This will throw in non-Node environments
+        const { getConnInfo } = require('@hono/node-server/conninfo');
+        const info = getConnInfo(c);
+        if (info?.remote?.address) {
+            return info.remote.address;
+        }
+    }
+    catch {
+        // Not in Node.js environment or module not available
+    }
+    return 'unknown';
+}
+//# sourceMappingURL=get-client-ip.js.map

package/dist/get-client-ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-client-ip.js","sourceRoot":"","sources":["../src/get-client-ip.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,WAAW,CAAC,CAAU;IACpC,qDAAqD;IACrD,MAAM,aAAa,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC;IACtD,IAAI,aAAa,EAAE,CAAC;QAClB,MAAM,EAAE,GAAG,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;QAC9C,IAAI,EAAE;YAAE,OAAO,EAAE,CAAC;IACpB,CAAC;IAED,iCAAiC;IACjC,MAAM,OAAO,GAAG,CAAC,CAAC,GAAG,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;IAC1C,IAAI,OAAO;QAAE,OAAO,OAAO,CAAC;IAE5B,8CAA8C;IAC9C,IAAI,CAAC;QACH,+DAA+D;QAC/D,2CAA2C;QAC3C,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,4BAA4B,CAAC,CAAC;QAC9D,MAAM,IAAI,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;QAC5B,IAAI,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;YAC1B,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC;QAC7B,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/http/error-handler.d.ts

@@ -0,0 +1,33 @@
+import type { Context, ErrorHandler } from 'hono';
+import type { ContentfulStatusCode } from 'hono/utils/http-status';
+interface FormattedError {
+    message: string;
+    statusCode: ContentfulStatusCode;
+}
+interface ErrorHandlerOptions {
+    /**
+     * Whether to log errors to console
+     * @default true in development, false in test
+     */
+    logErrors?: boolean;
+    /**
+     * Custom error response handler
+     */
+    responseHandler?: (error: FormattedError, context: Context) => Response | Promise<Response>;
+}
+/**
+ * Create an error handler middleware for Hono
+ *
+ * Handles:
+ * - DomainException (custom business logic exceptions)
+ * - HTTPException (Hono's built-in HTTP exceptions)
+ * - Validation errors (returns 422)
+ * - Generic errors (returns 500)
+ */
+export declare function createErrorHandler(options?: ErrorHandlerOptions): ErrorHandler;
+/**
+ * Default error handler instance
+ */
+export declare const defaultErrorHandler: ErrorHandler;
+export {};
+//# sourceMappingURL=error-handler.d.ts.map

package/dist/http/error-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-handler.d.ts","sourceRoot":"","sources":["../../src/http/error-handler.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,MAAM,CAAC;AAElD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAMnE,UAAU,cAAc;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,oBAAoB,CAAC;CAClC;AAED,UAAU,mBAAmB;IAC3B;;;OAGG;IACH,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB;;OAEG;IACH,eAAe,CAAC,EAAE,CAAC,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC7F;AAcD;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,mBAAwB,GAAG,YAAY,CA+BlF;AAED;;GAEG;AACH,eAAO,MAAM,mBAAmB,cAAuB,CAAC"}