glasswork 0.1.0

package/dist/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/types.d.ts.map

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

package/dist/types.js

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

package/dist/types.js.map

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

package/dist/utils/deep-merge.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Deep merge objects (simple implementation for small objects)
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(...objects: (T | Record<string, unknown>)[]): T;
+//# sourceMappingURL=deep-merge.d.ts.map

package/dist/utils/deep-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,GAAG,OAAO,EAAE,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAAE,GAC1C,CAAC,CAqBH"}

package/dist/utils/deep-merge.js

@@ -0,0 +1,21 @@
+/**
+ * Deep merge objects (simple implementation for small objects)
+ */
+export function deepMerge(...objects) {
+    const result = {};
+    for (const obj of objects) {
+        for (const key in obj) {
+            if (Object.hasOwn(obj, key)) {
+                const value = obj[key];
+                if (value && typeof value === 'object' && !Array.isArray(value)) {
+                    result[key] = deepMerge(result[key] || {}, value);
+                }
+                else {
+                    result[key] = value;
+                }
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=deep-merge.js.map

package/dist/utils/deep-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../src/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,SAAS,CACvB,GAAG,OAAwC;IAE3C,MAAM,MAAM,GAA4B,EAAE,CAAC;IAE3C,KAAK,MAAM,GAAG,IAAI,OAAO,EAAE,CAAC;QAC1B,KAAK,MAAM,GAAG,IAAI,GAAG,EAAE,CAAC;YACtB,IAAI,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,CAAC;gBAC5B,MAAM,KAAK,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC;gBAEvB,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;oBAChE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACpB,MAAM,CAAC,GAAG,CAA6B,IAAI,EAAE,EAC9C,KAAgC,CACjC,CAAC;gBACJ,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;gBACtB,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC"}

package/dist/utils/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/utils/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../src/utils/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/utils/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/utils/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../src/utils/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/utils/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/utils/get-client-ip.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-client-ip.d.ts","sourceRoot":"","sources":["../../src/utils/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/utils/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/utils/get-client-ip.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-client-ip.js","sourceRoot":"","sources":["../../src/utils/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/utils/logger.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Logger interface for framework and application logging
+ */
+export interface Logger {
+    debug(message: string, ...meta: unknown[]): void;
+    info(message: string, ...meta: unknown[]): void;
+    warn(message: string, ...meta: unknown[]): void;
+    error(message: string, ...meta: unknown[]): void;
+}
+/**
+ * Default console logger (used by framework internally)
+ */
+export declare const defaultLogger: Logger;
+/**
+ * Create a logger with a prefix for namespacing
+ *
+ * @param prefix - Prefix to add to all log messages
+ * @param enabled - Whether logging is enabled (default: true)
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger('MyService', debug);
+ * logger.info('Starting service'); // [MyService] Starting service
+ * ```
+ */
+export declare function createLogger(prefix: string, enabled?: boolean): Logger;
+/**
+ * Create a plain logger middleware for Lambda (strips ANSI color codes).
+ *
+ * CloudWatch Logs doesn't render ANSI colors well, so this middleware
+ * strips them for cleaner logs in production.
+ *
+ * @returns Hono logger middleware with ANSI codes stripped
+ */
+export declare function createPlainLogger(): import("hono").MiddlewareHandler;
+//# sourceMappingURL=logger.d.ts.map

package/dist/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,WAAW,MAAM;IACrB,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IACjD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChD,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;CAClD;AAED;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,MAK3B,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,MAAM,CAYnE;AAED;;;;;;;GAOG;AACH,wBAAgB,iBAAiB,qCAQhC"}

package/dist/utils/logger.js

@@ -0,0 +1,52 @@
+import { logger as honoLogger } from 'hono/logger';
+/**
+ * Default console logger (used by framework internally)
+ */
+export const defaultLogger = {
+    debug: console.debug.bind(console),
+    info: console.log.bind(console),
+    warn: console.warn.bind(console),
+    error: console.error.bind(console),
+};
+/**
+ * Create a logger with a prefix for namespacing
+ *
+ * @param prefix - Prefix to add to all log messages
+ * @param enabled - Whether logging is enabled (default: true)
+ * @returns Logger instance
+ *
+ * @example
+ * ```typescript
+ * const logger = createLogger('MyService', debug);
+ * logger.info('Starting service'); // [MyService] Starting service
+ * ```
+ */
+export function createLogger(prefix, enabled = true) {
+    if (!enabled) {
+        const noop = () => { };
+        return { debug: noop, info: noop, warn: noop, error: noop };
+    }
+    return {
+        debug: (msg, ...meta) => console.debug(`[${prefix}] ${msg}`, ...meta),
+        info: (msg, ...meta) => console.log(`[${prefix}] ${msg}`, ...meta),
+        warn: (msg, ...meta) => console.warn(`[${prefix}] ${msg}`, ...meta),
+        error: (msg, ...meta) => console.error(`[${prefix}] ${msg}`, ...meta),
+    };
+}
+/**
+ * Create a plain logger middleware for Lambda (strips ANSI color codes).
+ *
+ * CloudWatch Logs doesn't render ANSI colors well, so this middleware
+ * strips them for cleaner logs in production.
+ *
+ * @returns Hono logger middleware with ANSI codes stripped
+ */
+export function createPlainLogger() {
+    // biome-ignore lint/suspicious/noControlCharactersInRegex: we want to strip ANSI color codes
+    const stripAnsi = (input) => input.replace(/\u001B\[[0-9;]*m/g, '');
+    return honoLogger((str, ...rest) => {
+        const message = [str, ...rest].join(' ');
+        console.log(stripAnsi(message));
+    });
+}
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,UAAU,EAAE,MAAM,aAAa,CAAC;AAYnD;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAW;IACnC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;IAClC,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;IAC/B,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC;IAChC,KAAK,EAAE,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;CACnC,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,OAAO,GAAG,IAAI;IACzD,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,GAAG,EAAE,GAAE,CAAC,CAAC;QACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,OAAO;QACL,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QACrE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,MAAM,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QAClE,IAAI,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,MAAM,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;QACnE,KAAK,EAAE,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,MAAM,KAAK,GAAG,EAAE,EAAE,GAAG,IAAI,CAAC;KACtE,CAAC;AACJ,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB;IAC/B,6FAA6F;IAC7F,MAAM,SAAS,GAAG,CAAC,KAAa,EAAU,EAAE,CAAC,KAAK,CAAC,OAAO,CAAC,mBAAmB,EAAE,EAAE,CAAC,CAAC;IAEpF,OAAO,UAAU,CAAC,CAAC,GAAW,EAAE,GAAG,IAAc,EAAE,EAAE;QACnD,MAAM,OAAO,GAAG,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACzC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC;IAClC,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/utils/omit.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Creates a new object by omitting specified keys from the source object.
+ *
+ * This implementation preserves the object's prototype, making it suitable
+ * for use with class instances and objects with custom prototypes.
+ *
+ * @template T - The type of the source object
+ * @template K - The type of keys to omit (must be keys of T)
+ * @param object - The source object to omit keys from
+ * @param paths - Array of keys to omit from the object
+ * @returns A new object with the specified keys omitted
+ *
+ * @example
+ * ```typescript
+ * const user = { id: 1, name: 'John', email: 'john@example.com', password: 'secret' };
+ * const publicUser = omit(user, ['password']); // { id: 1, name: 'John', email: 'john@example.com' }
+ * ```
+ */
+export declare function omit<T extends object, K extends keyof T>(object: T, paths: K[]): Omit<T, K>;
+//# sourceMappingURL=omit.d.ts.map

package/dist/utils/omit.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.d.ts","sourceRoot":"","sources":["../../src/utils/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,IAAI,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC,EAAE,CAAC,CAAC,CAU3F"}

package/dist/utils/omit.js

@@ -0,0 +1,28 @@
+/**
+ * Creates a new object by omitting specified keys from the source object.
+ *
+ * This implementation preserves the object's prototype, making it suitable
+ * for use with class instances and objects with custom prototypes.
+ *
+ * @template T - The type of the source object
+ * @template K - The type of keys to omit (must be keys of T)
+ * @param object - The source object to omit keys from
+ * @param paths - Array of keys to omit from the object
+ * @returns A new object with the specified keys omitted
+ *
+ * @example
+ * ```typescript
+ * const user = { id: 1, name: 'John', email: 'john@example.com', password: 'secret' };
+ * const publicUser = omit(user, ['password']); // { id: 1, name: 'John', email: 'john@example.com' }
+ * ```
+ */
+export function omit(object, paths) {
+    const result = Object.create(Object.getPrototypeOf(object));
+    for (const key in object) {
+        if (Object.hasOwn(object, key) && !paths.includes(key)) {
+            result[key] = object[key];
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=omit.js.map

package/dist/utils/omit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"omit.js","sourceRoot":"","sources":["../../src/utils/omit.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,IAAI,CAAsC,MAAS,EAAE,KAAU;IAC7E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC;IAE5D,KAAK,MAAM,GAAG,IAAI,MAAM,EAAE,CAAC;QACzB,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,GAAmB,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC5B,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/utils/pagination.d.ts

@@ -0,0 +1,48 @@
+import type { Context } from 'hono';
+/**
+ * Pagination input parameters
+ */
+export interface PaginationInput {
+    page: number;
+    limit: number;
+}
+/**
+ * Paginated output structure
+ */
+export interface PaginatedOutput<T> {
+    data: T[];
+    total: number;
+    page: number;
+    limit: number;
+}
+/**
+ * Execute a paginated query and set response headers.
+ *
+ * This helper extracts pagination parameters from the query string,
+ * executes the provided function, and sets the appropriate response headers.
+ *
+ * @template T - The type of items in the result
+ * @param c - Hono context
+ * @param fn - Function that executes the paginated query
+ * @returns Array of items (headers are set as side effect)
+ *
+ * @example
+ * ```typescript
+ * router.get('/users', route({
+ *   paginate: true,
+ *   handler: async ({ context }) => {
+ *     return await paginate(context, (p) => userService.getUsers(p));
+ *   }
+ * }));
+ * ```
+ */
+export declare function paginate<T>(c: Context, fn: (p: PaginationInput) => Promise<PaginatedOutput<T>>): Promise<T[]>;
+/**
+ * Extract pagination parameters from Hono context.
+ *
+ * @param c - Hono context
+ * @param defaultLimit - Default limit if not provided (default: 100)
+ * @returns Pagination input with page and limit
+ */
+export declare function paginationInput(c: Context, defaultLimit?: number): PaginationInput;
+//# sourceMappingURL=pagination.d.ts.map