@kanjijs/common 0.3.0-beta.1 → 1.0.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 David Sebastian Aguiar
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/__tests__/cacheable.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=cacheable.spec.d.ts.map

package/dist/__tests__/cacheable.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheable.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/cacheable.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/cacheable.spec.js

@@ -0,0 +1,150 @@
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { describe, it, expect, beforeEach } from 'bun:test';
+import { Cacheable, _cacheStore } from '../utils/cacheable.js';
+describe('@Cacheable', () => {
+    beforeEach(() => {
+        _cacheStore.clear();
+    });
+    it('should cache synchronous method results', () => {
+        let callCount = 0;
+        class TestService {
+            getData(id) {
+                callCount++;
+                return `data-${id}`;
+            }
+        }
+        __decorate([
+            Cacheable({ ttl: 1 }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Number]),
+            __metadata("design:returntype", String)
+        ], TestService.prototype, "getData", null);
+        const service = new TestService();
+        // Primera llamada - ejecuta original
+        expect(service.getData(1)).toBe('data-1');
+        expect(callCount).toBe(1);
+        // Segunda llamada - obtiene del cache
+        expect(service.getData(1)).toBe('data-1');
+        expect(callCount).toBe(1);
+        // Llamada con diferente argumento - ejecuta original
+        expect(service.getData(2)).toBe('data-2');
+        expect(callCount).toBe(2);
+    });
+    it('should preserve "this" context', () => {
+        class TestService {
+            prefix = 'prefix';
+            getData(id) {
+                return `${this.prefix}-${id}`;
+            }
+        }
+        __decorate([
+            Cacheable({ ttl: 1 }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Number]),
+            __metadata("design:returntype", String)
+        ], TestService.prototype, "getData", null);
+        const service = new TestService();
+        expect(service.getData(1)).toBe('prefix-1');
+    });
+    it('should handle async methods and cache resolved values', async () => {
+        let callCount = 0;
+        class TestService {
+            async getData(id) {
+                callCount++;
+                return `async-data-${id}`;
+            }
+        }
+        __decorate([
+            Cacheable({ ttl: 1 }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Number]),
+            __metadata("design:returntype", Promise)
+        ], TestService.prototype, "getData", null);
+        const service = new TestService();
+        // Primera llamada - asíncrona
+        const result1 = await service.getData(1);
+        expect(result1).toBe('async-data-1');
+        expect(callCount).toBe(1);
+        // Segunda llamada - asíncrona, desde cache
+        const result2 = await service.getData(1);
+        expect(result2).toBe('async-data-1');
+        expect(callCount).toBe(1);
+    });
+    it('should respect custom cache key generator', () => {
+        let callCount = 0;
+        class TestService {
+            getData(id, _ignored) {
+                callCount++;
+                return `val-${id}`;
+            }
+        }
+        __decorate([
+            Cacheable({
+                ttl: 1,
+                // Generar clave custom omitiendo el segundo argumento
+                key: (id) => `custom-key:${id}`,
+            }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Number, String]),
+            __metadata("design:returntype", String)
+        ], TestService.prototype, "getData", null);
+        const service = new TestService();
+        expect(service.getData(1, 'foo')).toBe('val-1');
+        expect(callCount).toBe(1);
+        // Segunda llamada con diferente segundo argumento, pero misma key generada
+        expect(service.getData(1, 'bar')).toBe('val-1');
+        expect(callCount).toBe(1);
+    });
+    it('should bypass cache if ttl is 0 or less', () => {
+        let callCount = 0;
+        class TestService {
+            getData(id) {
+                callCount++;
+                return `data-${id}`;
+            }
+        }
+        __decorate([
+            Cacheable({ ttl: 0 }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Number]),
+            __metadata("design:returntype", String)
+        ], TestService.prototype, "getData", null);
+        const service = new TestService();
+        expect(service.getData(1)).toBe('data-1');
+        expect(callCount).toBe(1);
+        expect(service.getData(1)).toBe('data-1');
+        expect(callCount).toBe(2); // no cacheado
+    });
+    it('should expire cache entries after ttl', async () => {
+        let callCount = 0;
+        class TestService {
+            // 50ms TTL para el test
+            getData(id) {
+                callCount++;
+                return `data-${id}`;
+            }
+        }
+        __decorate([
+            Cacheable({ ttl: 0.05 }),
+            __metadata("design:type", Function),
+            __metadata("design:paramtypes", [Number]),
+            __metadata("design:returntype", String)
+        ], TestService.prototype, "getData", null);
+        const service = new TestService();
+        expect(service.getData(1)).toBe('data-1');
+        expect(callCount).toBe(1);
+        // Esperar 100ms
+        await new Promise((resolve) => setTimeout(resolve, 100));
+        expect(service.getData(1)).toBe('data-1');
+        expect(callCount).toBe(2); // expirado y re-ejecutado
+    });
+});
+//# sourceMappingURL=cacheable.spec.js.map

package/dist/__tests__/cacheable.spec.js.map

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

package/dist/__tests__/logger.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=logger.spec.d.ts.map

package/dist/__tests__/logger.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.spec.d.ts","sourceRoot":"","sources":["../../src/__tests__/logger.spec.ts"],"names":[],"mappings":""}

package/dist/__tests__/logger.spec.js

@@ -0,0 +1,29 @@
+import { describe, it, expect, spyOn, afterEach } from 'bun:test';
+import { DefaultConsoleLogger } from '../logger.js';
+describe('DefaultConsoleLogger', () => {
+    let logSpy = spyOn(console, 'log').mockImplementation(() => { });
+    let warnSpy = spyOn(console, 'warn').mockImplementation(() => { });
+    let errorSpy = spyOn(console, 'error').mockImplementation(() => { });
+    afterEach(() => {
+        logSpy.mockClear();
+        warnSpy.mockClear();
+        errorSpy.mockClear();
+    });
+    it('should print log messages without throwing', () => {
+        const logger = new DefaultConsoleLogger();
+        logger.log('Normal info message');
+        logger.log('Hono router method GET /users - 200 - +5ms', 'Router');
+        expect(logSpy).toHaveBeenCalled();
+    });
+    it('should print warnings without throwing', () => {
+        const logger = new DefaultConsoleLogger();
+        logger.warn('Some warning message', 'Contracts');
+        expect(warnSpy).toHaveBeenCalled();
+    });
+    it('should print errors without throwing', () => {
+        const logger = new DefaultConsoleLogger();
+        logger.error('Critical failure message', 'stacktrace-mock-data', 'InstanceLoader');
+        expect(errorSpy).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=logger.spec.js.map

package/dist/__tests__/logger.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.spec.js","sourceRoot":"","sources":["../../src/__tests__/logger.spec.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAClE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AAEpD,QAAQ,CAAC,sBAAsB,EAAE,GAAG,EAAE;IACpC,IAAI,MAAM,GAAG,KAAK,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAChE,IAAI,OAAO,GAAG,KAAK,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAClE,IAAI,QAAQ,GAAG,KAAK,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,kBAAkB,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IAEpE,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,CAAC,SAAS,EAAE,CAAC;QACnB,OAAO,CAAC,SAAS,EAAE,CAAC;QACpB,QAAQ,CAAC,SAAS,EAAE,CAAC;IACvB,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,4CAA4C,EAAE,GAAG,EAAE;QACpD,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;QAClC,MAAM,CAAC,GAAG,CAAC,4CAA4C,EAAE,QAAQ,CAAC,CAAC;QAEnE,MAAM,CAAC,MAAM,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACpC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,wCAAwC,EAAE,GAAG,EAAE;QAChD,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,CAAC,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAAC;QAEjD,MAAM,CAAC,OAAO,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACrC,CAAC,CAAC,CAAC;IAEH,EAAE,CAAC,sCAAsC,EAAE,GAAG,EAAE;QAC9C,MAAM,MAAM,GAAG,IAAI,oBAAoB,EAAE,CAAC;QAC1C,MAAM,CAAC,KAAK,CAAC,0BAA0B,EAAE,sBAAsB,EAAE,gBAAgB,CAAC,CAAC;QAEnF,MAAM,CAAC,QAAQ,CAAC,CAAC,gBAAgB,EAAE,CAAC;IACtC,CAAC,CAAC,CAAC;AACL,CAAC,CAAC,CAAC"}

package/dist/env.d.ts

@@ -0,0 +1,5 @@
+import { z } from 'zod';
+export declare function env<T extends z.ZodTypeAny>(key: string, schema: T): z.infer<T>;
+export declare function assertEnvValid(): void;
+export declare function getRegisteredEnvs(): Map<string, z.ZodTypeAny>;
+//# sourceMappingURL=env.d.ts.map

package/dist/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAexB,wBAAgB,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC,UAAU,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAgB9E;AAED,wBAAgB,cAAc,IAAI,IAAI,CAIrC;AAGD,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,UAAU,CAAC,CAE7D"}

package/dist/env.js

@@ -0,0 +1,27 @@
+const cache = new Map();
+const schemas = new Map();
+const errors = [];
+export function env(key, schema) {
+    // Register schema for .env.example autogeneration
+    schemas.set(key, schema);
+    if (cache.has(key)) {
+        return cache.get(key);
+    }
+    const result = schema.safeParse(process.env[key]);
+    if (!result.success) {
+        errors.push(`${key}: ${result.error.issues.map((i) => i.message).join(', ')}`);
+        return undefined;
+    }
+    cache.set(key, result.data);
+    return result.data;
+}
+export function assertEnvValid() {
+    if (errors.length > 0) {
+        throw new Error(`❌ Invalid environment:\n${errors.map((e) => `  - ${e}`).join('\n')}`);
+    }
+}
+// Expose schemas map for CLI or developer tools
+export function getRegisteredEnvs() {
+    return schemas;
+}
+//# sourceMappingURL=env.js.map

package/dist/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../src/env.ts"],"names":[],"mappings":"AAUA,MAAM,KAAK,GAAG,IAAI,GAAG,EAAoB,CAAC;AAE1C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAwB,CAAC;AAChD,MAAM,MAAM,GAAa,EAAE,CAAC;AAE5B,MAAM,UAAU,GAAG,CAAyB,GAAW,EAAE,MAAS;IAChE,kDAAkD;IAClD,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC;IAEzB,IAAI,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;QACnB,OAAO,KAAK,CAAC,GAAG,CAAC,GAAG,CAAe,CAAC;IACtC,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;QACpB,MAAM,CAAC,IAAI,CAAC,GAAG,GAAG,KAAK,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAC/E,OAAO,SAAuB,CAAC;IACjC,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAgB,CAAC,CAAC;IACxC,OAAO,MAAM,CAAC,IAAI,CAAC;AACrB,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACtB,MAAM,IAAI,KAAK,CAAC,2BAA2B,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACzF,CAAC;AACH,CAAC;AAED,gDAAgD;AAChD,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -1,3 +1,9 @@
-export declare const COMMON_VERSION = "0.2.0-beta.1";
-export type { ContextKey } from "./constants";
-export { CONTEXT_KEYS } from "./constants";
+export * from './types';
+export * from './env';
+export * from './logger';
+export * from './utils/errors';
+export * from './utils/helpers';
+export * from './utils/decorators';
+export * from './utils/exception-filter';
+export * from './utils/cacheable';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -1,20 +1,9 @@
-// @bun
-// src/constants.ts
-var CONTEXT_KEYS = {
-  AUTH_USER: "kanji.auth.user",
-  AUTH_SESSION: "kanji.auth.session",
-  AUTH_ROLES: "kanji.auth.roles",
-  AUTH_SCOPES: "kanji.auth.scopes",
-  AUTH_PRINCIPAL: "kanji.auth.principal",
-  AUTHZ_CACHE: "kanji.authz.cache",
-  AUTHZ_DECISION: "kanji.authz.decision",
-  REQUEST_ID: "kanji.requestId",
-  VALIDATED: "kanji.validated"
-};
-
-// src/index.ts
-var COMMON_VERSION = "0.2.0-beta.1";
-export {
-  CONTEXT_KEYS,
-  COMMON_VERSION
-};
+export * from './types';
+export * from './env';
+export * from './logger';
+export * from './utils/errors';
+export * from './utils/helpers';
+export * from './utils/decorators';
+export * from './utils/exception-filter';
+export * from './utils/cacheable';
+//# 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,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,iBAAiB,CAAC;AAChC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,mBAAmB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,15 @@
+export interface KanjiLogger {
+    log(message: string, context?: string): void;
+    error(message: string, trace?: string, context?: string): void;
+    warn(message: string, context?: string): void;
+}
+export declare const LOGGER: unique symbol;
+export declare class DefaultConsoleLogger implements KanjiLogger {
+    private useColor;
+    constructor();
+    private formatRouterMessage;
+    log(message: string, context?: string): void;
+    warn(message: string, context?: string): void;
+    error(message: string, trace?: string, context?: string): void;
+}
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,WAAW;IAC1B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/D,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/C;AAED,eAAO,MAAM,MAAM,eAAmB,CAAC;AAEvC,qBAAa,oBAAqB,YAAW,WAAW;IACtD,OAAO,CAAC,QAAQ,CAAU;;IAQ1B,OAAO,CAAC,mBAAmB;IAa3B,GAAG,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAQ5C,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;IAS7C,KAAK,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAS/D"}

package/dist/logger.js

@@ -0,0 +1,45 @@
+export const LOGGER = Symbol('LOGGER');
+export class DefaultConsoleLogger {
+    useColor;
+    constructor() {
+        const isTTY = typeof process !== 'undefined' && process.stdout?.isTTY;
+        const noColor = typeof process !== 'undefined' && process.env?.NO_COLOR !== undefined;
+        this.useColor = !!isTTY && !noColor;
+    }
+    formatRouterMessage(message) {
+        if (!this.useColor) {
+            return message;
+        }
+        // Formats Router latency message "METHOD /path - STATUS - +DURATIONms" with color codes
+        return message.replace(/ - (\d+) - \+(.+ms)/, (_match, status, duration) => {
+            const statusCode = parseInt(status, 10);
+            const statusColor = statusCode >= 500 ? '\x1b[31m' : statusCode >= 400 ? '\x1b[33m' : '\x1b[32m';
+            return ` - ${statusColor}${status}\x1b[0m - \x1b[36m+${duration}\x1b[0m`;
+        });
+    }
+    log(message, context) {
+        const ts = new Date().toLocaleTimeString();
+        const formattedMsg = context === 'Router' ? this.formatRouterMessage(message) : message;
+        const ctx = context ? (this.useColor ? `\x1b[36m[${context}]\x1b[0m` : `[${context}]`) : '';
+        const prefix = this.useColor ? `\x1b[35m[Kanji]\x1b[0m` : '[Kanji]';
+        console.log(`${prefix} ${ts} ${ctx} ${formattedMsg}`);
+    }
+    warn(message, context) {
+        const ts = new Date().toLocaleTimeString();
+        const formattedMsg = context === 'Router' ? this.formatRouterMessage(message) : message;
+        const ctx = context ? (this.useColor ? `\x1b[33m[${context}]\x1b[0m` : `[${context}]`) : '';
+        const prefix = this.useColor ? `\x1b[33m[Kanji-Warn]\x1b[0m` : '[Kanji-Warn]';
+        const msgColor = this.useColor ? `\x1b[33m${formattedMsg}\x1b[0m` : formattedMsg;
+        console.warn(`${prefix} ${ts} ${ctx} ${msgColor}`);
+    }
+    error(message, trace, context) {
+        const ts = new Date().toLocaleTimeString();
+        const formattedMsg = context === 'Router' ? this.formatRouterMessage(message) : message;
+        const ctx = context ? (this.useColor ? `\x1b[31m[${context}]\x1b[0m` : `[${context}]`) : '';
+        const prefix = this.useColor ? '\x1b[31m[Kanji-Error]\x1b[0m' : '[Kanji-Error]';
+        const msgColor = this.useColor ? `\x1b[31m${formattedMsg}\x1b[0m` : formattedMsg;
+        const traceStr = trace ? `\n${trace}` : '';
+        console.error(`${prefix} ${ts} ${ctx} ${msgColor}${traceStr}`);
+    }
+}
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,13 @@
+export interface Constructor<T = object> {
+    new (...args: never[]): T;
+}
+export type Token<T = object> = Constructor<T> | symbol | string;
+export type DeepPartial<T> = T extends Builtin ? T : T extends Map<infer K, infer V> ? Map<DeepPartial<K>, DeepPartial<V>> : T extends ReadonlyMap<infer K, infer V> ? ReadonlyMap<DeepPartial<K>, DeepPartial<V>> : T extends WeakMap<infer K, infer V> ? WeakMap<DeepPartial<K>, DeepPartial<V>> : T extends Set<infer U> ? Set<DeepPartial<U>> : T extends ReadonlySet<infer U> ? ReadonlySet<DeepPartial<U>> : T extends WeakSet<infer U> ? WeakSet<DeepPartial<U>> : T extends Array<infer U> ? T extends IsTuple<T> ? {
+    [K in keyof T]: DeepPartial<T[K]>;
+} : Array<DeepPartial<U>> : T extends Promise<infer U> ? Promise<DeepPartial<U>> : T extends {} ? {
+    [K in keyof T]?: DeepPartial<T[K]>;
+} : Partial<T>;
+type Builtin = Function | Date | Error | RegExp;
+type IsTuple<T> = T extends readonly any[] ? (number extends T['length'] ? never : T) : never;
+export {};
+//# 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":"AAAA,MAAM,WAAW,WAAW,CAAC,CAAC,GAAG,MAAM;IACrC,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,GAAG,CAAC,CAAC;CAC3B;AAED,MAAM,MAAM,KAAK,CAAC,CAAC,GAAG,MAAM,IAAI,WAAW,CAAC,CAAC,CAAC,GAAG,MAAM,GAAG,MAAM,CAAC;AAEjE,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI,CAAC,SAAS,OAAO,GAC1C,CAAC,GACD,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GAC7B,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GACnC,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACrC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GAC3C,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,GACvC,CAAC,SAAS,GAAG,CAAC,MAAM,CAAC,CAAC,GACpB,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACnB,CAAC,SAAS,WAAW,CAAC,MAAM,CAAC,CAAC,GAC5B,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GAC3B,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACvB,CAAC,SAAS,KAAK,CAAC,MAAM,CAAC,CAAC,GACtB,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,GAClB;KAAG,CAAC,IAAI,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACrC,KAAK,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACvB,CAAC,SAAS,OAAO,CAAC,MAAM,CAAC,CAAC,GACxB,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,GACvB,CAAC,SAAS,EAAE,GACV;KAAG,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;CAAE,GACtC,OAAO,CAAC,CAAC,CAAC,CAAC;AAEjC,KAAK,OAAO,GAAG,QAAQ,GAAG,IAAI,GAAG,KAAK,GAAG,MAAM,CAAC;AAEhD,KAAK,OAAO,CAAC,CAAC,IAAI,CAAC,SAAS,SAAS,GAAG,EAAE,GAAG,CAAC,MAAM,SAAS,CAAC,CAAC,QAAQ,CAAC,GAAG,KAAK,GAAG,CAAC,CAAC,GAAG,KAAK,CAAC"}

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/cacheable.d.ts

@@ -0,0 +1,17 @@
+import 'reflect-metadata';
+export interface CacheableOptions {
+    ttl: number;
+    key?: (...args: readonly never[]) => string;
+}
+interface CacheEntry<T = unknown> {
+    value: T;
+    expiresAt: number;
+}
+/**
+ * Decorador para cachear el retorno de un método.
+ * Evita ejecuciones duplicadas de computaciones pesadas o consultas repetidas a la base de datos.
+ */
+export declare function Cacheable(options: CacheableOptions): MethodDecorator;
+export declare const _cacheStore: Map<string, CacheEntry<unknown>>;
+export {};
+//# sourceMappingURL=cacheable.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"cacheable.d.ts","sourceRoot":"","sources":["../../src/utils/cacheable.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,MAAM,WAAW,gBAAgB;IAC/B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,SAAS,KAAK,EAAE,KAAK,MAAM,CAAC;CAC7C;AAED,UAAU,UAAU,CAAC,CAAC,GAAG,OAAO;IAC9B,KAAK,EAAE,CAAC,CAAC;IACT,SAAS,EAAE,MAAM,CAAC;CACnB;AAqBD;;;GAGG;AACH,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,eAAe,CAiDpE;AAGD,eAAO,MAAM,WAAW,kCAAa,CAAC"}

package/dist/utils/cacheable.js

@@ -0,0 +1,62 @@
+import 'reflect-metadata';
+// Almacenamiento en caché en memoria
+const cacheStore = new Map();
+// Cleanup periódico para evitar memory leaks
+const CLEANUP_INTERVAL_MS = 60000; // 1 minuto
+const cleanupTimer = setInterval(() => {
+    const now = Date.now();
+    for (const [key, entry] of cacheStore.entries()) {
+        if (entry.expiresAt <= now) {
+            cacheStore.delete(key);
+        }
+    }
+}, CLEANUP_INTERVAL_MS);
+// Permitir que el proceso de Bun termine de manera limpia sin esperar a que finalice el timer
+if (typeof cleanupTimer.unref === 'function') {
+    cleanupTimer.unref();
+}
+/**
+ * Decorador para cachear el retorno de un método.
+ * Evita ejecuciones duplicadas de computaciones pesadas o consultas repetidas a la base de datos.
+ */
+export function Cacheable(options) {
+    return (target, propertyKey, descriptor) => {
+        const originalMethod = descriptor.value;
+        if (typeof originalMethod !== 'function') {
+            throw new Error('@Cacheable solo se puede aplicar a métodos de clase.');
+        }
+        descriptor.value = function (...args) {
+            // Si el TTL es menor o igual a 0, ejecutar el método original sin pasar por la caché
+            if (options.ttl <= 0) {
+                return originalMethod.apply(this, args);
+            }
+            // Generar clave única para el método
+            const cacheKey = options.key
+                ? options.key.apply(this, args)
+                : `${target.constructor.name}:${String(propertyKey)}:${JSON.stringify(args)}`;
+            const now = Date.now();
+            const cached = cacheStore.get(cacheKey);
+            if (cached && cached.expiresAt > now) {
+                return cached.value;
+            }
+            const result = originalMethod.apply(this, args);
+            if (result instanceof Promise) {
+                return result.then((resolvedValue) => {
+                    cacheStore.set(cacheKey, {
+                        value: resolvedValue,
+                        expiresAt: Date.now() + options.ttl * 1000,
+                    });
+                    return resolvedValue;
+                });
+            }
+            cacheStore.set(cacheKey, {
+                value: result,
+                expiresAt: Date.now() + options.ttl * 1000,
+            });
+            return result;
+        };
+    };
+}
+// Exportar store para propósitos de testing si es necesario
+export const _cacheStore = cacheStore;
+//# sourceMappingURL=cacheable.js.map

package/dist/utils/cacheable.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cacheable.js","sourceRoot":"","sources":["../../src/utils/cacheable.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAY1B,qCAAqC;AACrC,MAAM,UAAU,GAAG,IAAI,GAAG,EAAsB,CAAC;AAEjD,6CAA6C;AAC7C,MAAM,mBAAmB,GAAG,KAAK,CAAC,CAAC,WAAW;AAC9C,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,EAAE;IACpC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,UAAU,CAAC,OAAO,EAAE,EAAE,CAAC;QAChD,IAAI,KAAK,CAAC,SAAS,IAAI,GAAG,EAAE,CAAC;YAC3B,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;AACH,CAAC,EAAE,mBAAmB,CAAC,CAAC;AAExB,8FAA8F;AAC9F,IAAI,OAAO,YAAY,CAAC,KAAK,KAAK,UAAU,EAAE,CAAC;IAC7C,YAAY,CAAC,KAAK,EAAE,CAAC;AACvB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,OAAyB;IACjD,OAAO,CACL,MAAc,EACd,WAA4B,EAC5B,UAAsC,EACH,EAAE;QACrC,MAAM,cAAc,GAAG,UAAU,CAAC,KAAK,CAAC;QACxC,IAAI,OAAO,cAAc,KAAK,UAAU,EAAE,CAAC;YACzC,MAAM,IAAI,KAAK,CAAC,sDAAsD,CAAC,CAAC;QAC1E,CAAC;QAED,UAAU,CAAC,KAAK,GAAG,UAAyB,GAAG,IAAa;YAC1D,qFAAqF;YACrF,IAAI,OAAO,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC;gBACrB,OAAO,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,CAAC;YAED,qCAAqC;YACrC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG;gBAC1B,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC;gBAC/B,CAAC,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,MAAM,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC;YAEhF,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YAExC,IAAI,MAAM,IAAI,MAAM,CAAC,SAAS,GAAG,GAAG,EAAE,CAAC;gBACrC,OAAO,MAAM,CAAC,KAAK,CAAC;YACtB,CAAC;YAED,MAAM,MAAM,GAAG,cAAc,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAEhD,IAAI,MAAM,YAAY,OAAO,EAAE,CAAC;gBAC9B,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,aAAa,EAAE,EAAE;oBACnC,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE;wBACvB,KAAK,EAAE,aAAa;wBACpB,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI;qBAC3C,CAAC,CAAC;oBACH,OAAO,aAAa,CAAC;gBACvB,CAAC,CAAC,CAAC;YACL,CAAC;YAED,UAAU,CAAC,GAAG,CAAC,QAAQ,EAAE;gBACvB,KAAK,EAAE,MAAM;gBACb,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,OAAO,CAAC,GAAG,GAAG,IAAI;aAC3C,CAAC,CAAC;YAEH,OAAO,MAAM,CAAC;QAChB,CAAiB,CAAC;IACpB,CAAC,CAAC;AACJ,CAAC;AAED,4DAA4D;AAC5D,MAAM,CAAC,MAAM,WAAW,GAAG,UAAU,CAAC"}

package/dist/utils/decorators.d.ts

@@ -0,0 +1,5 @@
+import 'reflect-metadata';
+export declare function createParamDecorator(factory: (ctx: unknown) => unknown): ParameterDecorator;
+export declare function createPropertyDecorator(metakey: string, value: unknown): PropertyDecorator;
+export declare function createMethodDecorator(factory: (...args: Array<unknown>) => PropertyDecorator): (...args: Array<unknown>) => MethodDecorator;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/utils/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,GAAG,kBAAkB,CAc3F;AAED,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,iBAAiB,CAK1F;AAED,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,iBAAiB,GACtD,CAAC,GAAG,IAAI,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,eAAe,CAS9C"}

package/dist/utils/decorators.js

@@ -0,0 +1,28 @@
+import 'reflect-metadata';
+export function createParamDecorator(factory) {
+    return (target, propertyKey, parameterIndex) => {
+        if (propertyKey === undefined)
+            return;
+        const existingMetadata = Reflect.getMetadata('kanji:params', target, propertyKey) ?? [];
+        existingMetadata.push({ index: parameterIndex, factory });
+        Reflect.defineMetadata('kanji:params', existingMetadata, target, propertyKey);
+    };
+}
+export function createPropertyDecorator(metakey, value) {
+    return (target, propertyKey) => {
+        if (propertyKey === undefined)
+            return;
+        Reflect.defineMetadata(metakey, value, target, propertyKey);
+    };
+}
+export function createMethodDecorator(factory) {
+    return (...args) => {
+        const propertyDecorator = factory(...args);
+        return (target, propertyKey) => {
+            if (propertyKey !== undefined) {
+                propertyDecorator(target, propertyKey);
+            }
+        };
+    };
+}
+//# sourceMappingURL=decorators.js.map

package/dist/utils/decorators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.js","sourceRoot":"","sources":["../../src/utils/decorators.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,MAAM,UAAU,oBAAoB,CAAC,OAAkC;IACrE,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,cAAsB,EAAE,EAAE;QAC1F,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO;QAEtC,MAAM,gBAAgB,GACpB,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,WAA8B,CAAC,IAAI,EAAE,CAAC;QACpF,gBAAgB,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,cAAc,CACpB,cAAc,EACd,gBAAgB,EAChB,MAAM,EACN,WAA8B,CAC/B,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,uBAAuB,CAAC,OAAe,EAAE,KAAc;IACrE,OAAO,CAAC,MAAc,EAAE,WAA6B,EAAE,EAAE;QACvD,IAAI,WAAW,KAAK,SAAS;YAAE,OAAO;QACtC,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAC9D,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,qBAAqB,CACnC,OAAuD;IAEvD,OAAO,CAAC,GAAG,IAAoB,EAAE,EAAE;QACjC,MAAM,iBAAiB,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;QAC3C,OAAO,CAAC,MAAc,EAAE,WAAwC,EAAE,EAAE;YAClE,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;gBAC9B,iBAAiB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YACzC,CAAC;QACH,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,36 @@
+export declare class KanjiError extends Error {
+    readonly statusCode: number;
+    readonly code: string;
+    constructor(message: string, statusCode?: number, code?: string);
+}
+export declare class BadRequestError extends KanjiError {
+    constructor(message?: string, code?: string);
+}
+export declare class UnauthorizedError extends KanjiError {
+    constructor(message?: string, code?: string);
+}
+export declare class ForbiddenError extends KanjiError {
+    constructor(message?: string, code?: string);
+}
+export declare class NotFoundError extends KanjiError {
+    constructor(message?: string, code?: string);
+}
+export declare class ConflictError extends KanjiError {
+    constructor(message?: string, code?: string);
+}
+export declare class ValidationError extends KanjiError {
+    readonly issues: Array<{
+        path: string;
+        code: string;
+        message: string;
+    }>;
+    constructor(issues: Array<{
+        path: string;
+        code: string;
+        message: string;
+    }>, message?: string);
+}
+export declare class TooManyRequestsError extends KanjiError {
+    constructor(message?: string, code?: string);
+}
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,qBAAa,UAAW,SAAQ,KAAK;IACnC,SAAgB,UAAU,EAAE,MAAM,CAAC;IACnC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,UAAU,GAAE,MAAY,EAAE,IAAI,GAAE,MAAyB;CAOvF;AAED,qBAAa,eAAgB,SAAQ,UAAU;gBACjC,OAAO,GAAE,MAAsB,EAAE,IAAI,GAAE,MAAsB;CAI1E;AAED,qBAAa,iBAAkB,SAAQ,UAAU;gBACnC,OAAO,GAAE,MAAuB,EAAE,IAAI,GAAE,MAAuB;CAI5E;AAED,qBAAa,cAAe,SAAQ,UAAU;gBAChC,OAAO,GAAE,MAAoB,EAAE,IAAI,GAAE,MAAoB;CAItE;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,GAAE,MAA6B,EAAE,IAAI,GAAE,MAAoB;CAI/E;AAED,qBAAa,aAAc,SAAQ,UAAU;gBAC/B,OAAO,GAAE,MAA4B,EAAE,IAAI,GAAE,MAAmB;CAI7E;AAED,qBAAa,eAAgB,SAAQ,UAAU;IAC7C,SAAgB,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;gBAG7E,MAAM,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC,EAC9D,OAAO,GAAE,MAA4B;CAMxC;AAED,qBAAa,oBAAqB,SAAQ,UAAU;gBACtC,OAAO,GAAE,MAA4B,EAAE,IAAI,GAAE,MAA4B;CAItF"}

package/dist/utils/errors.js

@@ -0,0 +1,56 @@
+export class KanjiError extends Error {
+    statusCode;
+    code;
+    constructor(message, statusCode = 500, code = 'INTERNAL_ERROR') {
+        super(message);
+        this.name = 'KanjiError';
+        this.statusCode = statusCode;
+        this.code = code;
+        Error.captureStackTrace(this, this.constructor);
+    }
+}
+export class BadRequestError extends KanjiError {
+    constructor(message = 'Bad request', code = 'BAD_REQUEST') {
+        super(message, 400, code);
+        this.name = 'BadRequestError';
+    }
+}
+export class UnauthorizedError extends KanjiError {
+    constructor(message = 'Unauthorized', code = 'UNAUTHORIZED') {
+        super(message, 401, code);
+        this.name = 'UnauthorizedError';
+    }
+}
+export class ForbiddenError extends KanjiError {
+    constructor(message = 'Forbidden', code = 'FORBIDDEN') {
+        super(message, 403, code);
+        this.name = 'ForbiddenError';
+    }
+}
+export class NotFoundError extends KanjiError {
+    constructor(message = 'Resource not found', code = 'NOT_FOUND') {
+        super(message, 404, code);
+        this.name = 'NotFoundError';
+    }
+}
+export class ConflictError extends KanjiError {
+    constructor(message = 'Resource conflict', code = 'CONFLICT') {
+        super(message, 409, code);
+        this.name = 'ConflictError';
+    }
+}
+export class ValidationError extends KanjiError {
+    issues;
+    constructor(issues, message = 'Validation failed') {
+        super(message, 422, 'VALIDATION_ERROR');
+        this.name = 'ValidationError';
+        this.issues = issues;
+    }
+}
+export class TooManyRequestsError extends KanjiError {
+    constructor(message = 'Too many requests', code = 'TOO_MANY_REQUESTS') {
+        super(message, 429, code);
+        this.name = 'TooManyRequestsError';
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,UAAW,SAAQ,KAAK;IACnB,UAAU,CAAS;IACnB,IAAI,CAAS;IAE7B,YAAY,OAAe,EAAE,aAAqB,GAAG,EAAE,OAAe,gBAAgB;QACpF,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7C,YAAY,UAAkB,aAAa,EAAE,OAAe,aAAa;QACvE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAED,MAAM,OAAO,iBAAkB,SAAQ,UAAU;IAC/C,YAAY,UAAkB,cAAc,EAAE,OAAe,cAAc;QACzE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;CACF;AAED,MAAM,OAAO,cAAe,SAAQ,UAAU;IAC5C,YAAY,UAAkB,WAAW,EAAE,OAAe,WAAW;QACnE,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC/B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,UAAkB,oBAAoB,EAAE,OAAe,WAAW;QAC5E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,aAAc,SAAQ,UAAU;IAC3C,YAAY,UAAkB,mBAAmB,EAAE,OAAe,UAAU;QAC1E,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC9B,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,UAAU;IAC7B,MAAM,CAAyD;IAE/E,YACE,MAA8D,EAC9D,UAAkB,mBAAmB;QAErC,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,kBAAkB,CAAC,CAAC;QACxC,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;CACF;AAED,MAAM,OAAO,oBAAqB,SAAQ,UAAU;IAClD,YAAY,UAAkB,mBAAmB,EAAE,OAAe,mBAAmB;QACnF,KAAK,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,IAAI,GAAG,sBAAsB,CAAC;IACrC,CAAC;CACF"}

package/dist/utils/exception-filter.d.ts

@@ -0,0 +1,7 @@
+import 'reflect-metadata';
+export interface ExceptionFilter<T = Error> {
+    catch(exception: T, context: any): any;
+}
+export declare function Catch(...exceptions: Array<new (...args: any[]) => Error>): ClassDecorator;
+export declare function getExceptionFilterTargets(target: object): Array<new (...args: any[]) => Error> | undefined;
+//# sourceMappingURL=exception-filter.d.ts.map

package/dist/utils/exception-filter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.d.ts","sourceRoot":"","sources":["../../src/utils/exception-filter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAE1B,MAAM,WAAW,eAAe,CAAC,CAAC,GAAG,KAAK;IACxC,KAAK,CAAC,SAAS,EAAE,CAAC,EAAE,OAAO,EAAE,GAAG,GAAG,GAAG,CAAC;CACxC;AAID,wBAAgB,KAAK,CAAC,GAAG,UAAU,EAAE,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,cAAc,CAIzF;AAED,wBAAgB,yBAAyB,CACvC,MAAM,EAAE,MAAM,GACb,KAAK,CAAC,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,KAAK,CAAC,GAAG,SAAS,CAElD"}

package/dist/utils/exception-filter.js

@@ -0,0 +1,11 @@
+import 'reflect-metadata';
+const CATCH_DECORATOR_KEY = 'kanji:exception:filters';
+export function Catch(...exceptions) {
+    return (target) => {
+        Reflect.defineMetadata(CATCH_DECORATOR_KEY, exceptions, target);
+    };
+}
+export function getExceptionFilterTargets(target) {
+    return Reflect.getMetadata(CATCH_DECORATOR_KEY, target);
+}
+//# sourceMappingURL=exception-filter.js.map

package/dist/utils/exception-filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exception-filter.js","sourceRoot":"","sources":["../../src/utils/exception-filter.ts"],"names":[],"mappings":"AAAA,OAAO,kBAAkB,CAAC;AAM1B,MAAM,mBAAmB,GAAG,yBAAyB,CAAC;AAEtD,MAAM,UAAU,KAAK,CAAC,GAAG,UAAgD;IACvE,OAAO,CAAC,MAAM,EAAE,EAAE;QAChB,OAAO,CAAC,cAAc,CAAC,mBAAmB,EAAE,UAAU,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,yBAAyB,CACvC,MAAc;IAEd,OAAO,OAAO,CAAC,WAAW,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC;AAC1D,CAAC"}

package/dist/utils/helpers.d.ts

@@ -0,0 +1,9 @@
+export declare function capitalize(str: string): string;
+export declare function toSingular(str: string): string;
+export declare function toPlural(str: string): string;
+export declare function toCamelCase(str: string): string;
+export declare function toKebabCase(str: string): string;
+export declare function fileExists(path: string): Promise<boolean>;
+export declare function ensureArray<T>(value: T | T[]): T[];
+export declare function slugify(str: string): string;
+//# sourceMappingURL=helpers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.ts","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAEA,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAG9C;AAED,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAI9C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK5C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE/C;AAED,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAK/C;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAO/D;AAED,wBAAgB,WAAW,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,EAAE,CAElD;AAED,wBAAgB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAO3C"}

package/dist/utils/helpers.js

@@ -0,0 +1,49 @@
+import { stat } from 'fs/promises';
+export function capitalize(str) {
+    if (!str)
+        return '';
+    return str.charAt(0).toUpperCase() + str.slice(1);
+}
+export function toSingular(str) {
+    if (str.endsWith('ies'))
+        return str.slice(0, -3) + 'y';
+    if (str.endsWith('s') && !str.endsWith('ss'))
+        return str.slice(0, -1);
+    return str;
+}
+export function toPlural(str) {
+    if (str.endsWith('y') && !/[aeiou]y$/.test(str)) {
+        return str.slice(0, -1) + 'ies';
+    }
+    return str + 's';
+}
+export function toCamelCase(str) {
+    return str.replace(/-([a-z])/g, (_, char) => char.toUpperCase());
+}
+export function toKebabCase(str) {
+    return str
+        .replace(/([a-z])([A-Z])/g, '$1-$2')
+        .replace(/[\s_]+/g, '-')
+        .toLowerCase();
+}
+export async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function ensureArray(value) {
+    return Array.isArray(value) ? value : [value];
+}
+export function slugify(str) {
+    return str
+        .toLowerCase()
+        .trim()
+        .replace(/[^\w\s-]/g, '')
+        .replace(/[\s_]+/g, '-')
+        .replace(/-+/g, '-');
+}
+//# sourceMappingURL=helpers.js.map

package/dist/utils/helpers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.js","sourceRoot":"","sources":["../../src/utils/helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAEnC,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,CAAC,GAAG;QAAE,OAAO,EAAE,CAAC;IACpB,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,UAAU,CAAC,GAAW;IACpC,IAAI,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC;IACvD,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAAE,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACtE,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChD,OAAO,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC;IAClC,CAAC;IACD,OAAO,GAAG,GAAG,GAAG,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG,CAAC,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,GAAG;SACP,OAAO,CAAC,iBAAiB,EAAE,OAAO,CAAC;SACnC,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,WAAW,EAAE,CAAC;AACnB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC;AAED,MAAM,UAAU,WAAW,CAAI,KAAc;IAC3C,OAAO,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,GAAW;IACjC,OAAO,GAAG;SACP,WAAW,EAAE;SACb,IAAI,EAAE;SACN,OAAO,CAAC,WAAW,EAAE,EAAE,CAAC;SACxB,OAAO,CAAC,SAAS,EAAE,GAAG,CAAC;SACvB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/package.json

@@ -1,22 +1,21 @@
 {
   "name": "@kanjijs/common",
-  "version": "0.3.0-beta.1",
-  "type": "module",
+  "version": "1.0.0-alpha.1",
   "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "files": [
-    "dist",
-    "README.md",
-    "LICENSE"
+    "dist"
   ],
-  "scripts": {
-    "build": "bun build src/index.ts --outdir dist --target bun && bunx tsc --emitDeclarationOnly --declaration --outDir dist -p tsconfig.build.json"
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "dependencies": {
+    "zod": "^3.24.1"
   },
   "peerDependencies": {
-    "@kanjijs/core": "^0.2.0-beta.56"
+    "typescript": "6.0.3"
   },
-  "devDependencies": {
-    "bun-types": "latest",
-    "@kanjijs/core": "^0.2.0-beta.56"
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "bun test"
   }
-}
+}

package/dist/constants.d.ts

@@ -1,71 +0,0 @@
-/**
- * Standard Context Keys for Kanjijs Framework
- *
- * These keys are used to store and retrieve values from the Hono context
- * in a standardized way across all Kanjijs packages.
- *
- * @example
- * ```ts
- * import { CONTEXT_KEYS } from "@kanjijs/common";
- *
- * // Set principal in auth middleware
- * c.set(CONTEXT_KEYS.AUTH_PRINCIPAL, principal);
- *
- * // Read principal in authz middleware
- * const principal = c.get(CONTEXT_KEYS.AUTH_PRINCIPAL);
- * ```
- */
-export declare const CONTEXT_KEYS: {
-    /**
-     * Authenticated user ID
-     * @example "user_123"
-     */
-    readonly AUTH_USER: "kanji.auth.user";
-    /**
-     * Session ID
-     * @example "session_abc"
-     */
-    readonly AUTH_SESSION: "kanji.auth.session";
-    /**
-     * User roles (array of strings)
-     * @example ["admin", "editor"]
-     */
-    readonly AUTH_ROLES: "kanji.auth.roles";
-    /**
-     * User scopes/permissions (array of strings)
-     * @example ["posts:read", "posts:write"]
-     */
-    readonly AUTH_SCOPES: "kanji.auth.scopes";
-    /**
-     * Normalized Principal object
-     * Contains userId, sessionId, roles, scopes, claims
-     * @see Principal from @kanjijs/security
-     */
-    readonly AUTH_PRINCIPAL: "kanji.auth.principal";
-    /**
-     * Authorization decision cache (Map)
-     * Stores decisions per request to avoid re-evaluation
-     * @example Map<string, Decision>
-     */
-    readonly AUTHZ_CACHE: "kanji.authz.cache";
-    /**
-     * Last authorization decision
-     * Useful for debugging and logging
-     * @see Decision from @kanjijs/security
-     */
-    readonly AUTHZ_DECISION: "kanji.authz.decision";
-    /**
-     * Request ID for tracing
-     * @example "req_abc123"
-     */
-    readonly REQUEST_ID: "kanji.requestId";
-    /**
-     * Validated request data (from contract validation)
-     * @example { body: {...}, query: {...} }
-     */
-    readonly VALIDATED: "kanji.validated";
-};
-/**
- * Type-safe context key type
- */
-export type ContextKey = (typeof CONTEXT_KEYS)[keyof typeof CONTEXT_KEYS];