@kanjijs/auth 0.2.0-beta.13 → 0.2.0-beta.15

package/dist/auth/src/index.d.ts

@@ -0,0 +1,23 @@
+import type { AuthConfig } from "@auth/core";
+import { type DynamicModule } from "@kanjijs/core";
+import type { MiddlewareHandler } from "hono";
+export declare const AUTH_USER_KEY = "kanjijs.auth.user";
+export declare const AUTH_SESSION_KEY = "kanjijs.auth.session";
+/**
+ * Configure Auth.js middleware.
+ * This middleware initializes Auth.js and automatically populates the session/user.
+ *
+ * Usage:
+ * @Use(auth({ ...authConfig }))
+ */
+export declare function auth(config: AuthConfig): MiddlewareHandler;
+/**
+ * Middleware: Require Authentication
+ * Returns 401 if no user is found in context.
+ * MUST be used AFTER auth() middleware.
+ */
+export declare const requireAuth: MiddlewareHandler;
+export declare function requireRole(role: string): MiddlewareHandler;
+export declare class AuthModule {
+    static forRoot(config: AuthConfig): DynamicModule;
+}

package/dist/contracts/src/index.d.ts

@@ -0,0 +1,27 @@
+export type SchemaLike = unknown;
+export interface ContractRequestSpec<T = SchemaLike> {
+    params?: T;
+    query?: T;
+    headers?: T;
+    cookies?: T;
+    body?: T;
+}
+export interface ContractResponseSpec<T = SchemaLike> {
+    [status: number]: T;
+}
+export interface ContractSpec<T = SchemaLike> {
+    request?: ContractRequestSpec<T>;
+    response?: ContractResponseSpec<T>;
+}
+export interface ValidatorAdapter<S = SchemaLike> {
+    parse<O = unknown>(schema: S, data: unknown): Promise<{
+        success: true;
+        data: O;
+    } | {
+        success: false;
+        issues: unknown[];
+    }>;
+}
+export declare class Contract {
+    static json<T = SchemaLike>(spec: ContractRequestSpec<T>): ContractSpec<T>;
+}

package/dist/core/src/context.d.ts

@@ -0,0 +1,7 @@
+import { AsyncLocalStorage } from "node:async_hooks";
+export interface RequestContext {
+    requestId: string;
+    [key: string]: any;
+}
+export declare const kanjijsContext: AsyncLocalStorage<RequestContext>;
+export declare function getRequestId(): string | undefined;

package/dist/core/src/decorators.d.ts

@@ -0,0 +1,34 @@
+import type { ContractSpec } from "@kanjijs/contracts";
+import { type ModuleMetadata, type Token } from "./metadata";
+/**
+ * @Module({ controllers: [...] })
+ */
+export declare function Module(metadata: ModuleMetadata): ClassDecorator;
+/**
+ * @Contract({ ... })
+ */
+export declare function Contract(spec: ContractSpec): MethodDecorator;
+/**
+ * @Controller('/users')
+ */
+export declare function Controller(prefix?: string): ClassDecorator;
+export declare function Injectable(): ClassDecorator;
+export declare const Get: (path?: string) => MethodDecorator;
+export declare const Post: (path?: string) => MethodDecorator;
+export declare const Put: (path?: string) => MethodDecorator;
+export declare const Delete: (path?: string) => MethodDecorator;
+export declare const Patch: (path?: string) => MethodDecorator;
+/**
+ * @Inject("DATABASE_CLIENT")
+ */
+export declare function Inject(token: Token<unknown>): ParameterDecorator;
+/**
+ * @Use(middleware1, middleware2)
+ * Attaches middlewares to a controller or method.
+ */
+export declare function Use(...middlewares: unknown[]): MethodDecorator & ClassDecorator;
+export declare const Body: (data?: string) => ParameterDecorator;
+export declare const Query: (data?: string) => ParameterDecorator;
+export declare const Param: (data?: string) => ParameterDecorator;
+export declare const Headers: (data?: string) => ParameterDecorator;
+export declare const Ctx: (data?: string) => ParameterDecorator;

package/dist/core/src/di/container.d.ts

@@ -0,0 +1,26 @@
+import { type Constructor, type Token } from "../metadata";
+import "reflect-metadata";
+export declare class KanjijsIoC {
+    private static providers;
+    static register<T>(target: Constructor<T>): void;
+    static register<T>(token: Token<T>, provider: {
+        useValue?: T;
+        useClass?: Constructor<T>;
+    }): void;
+    static resolve<T>(target: Token<T>): T;
+    static clear(): void;
+}
+/**
+ * V2 STRICT CONTAINER
+ * Instance-based, no auto-registration, explicit visibility.
+ */
+export declare class Container {
+    private providers;
+    register<T>(token: Token<T>, provider: {
+        useValue?: T;
+        useClass?: Constructor<T>;
+        useFactory?: (...args: unknown[]) => T;
+        inject?: Array<Token<unknown>>;
+    }): void;
+    resolve<T>(token: Token<T>): T;
+}

package/dist/core/src/di/module-compiler.d.ts

@@ -0,0 +1,11 @@
+import { type Constructor } from "../metadata";
+import { Container } from "./container";
+export declare class ModuleCompiler {
+    private nodes;
+    private globalExportedTokens;
+    compile(rootModule: Constructor): Container;
+    private scan;
+    private processProviders;
+    private validate;
+    private checkDependencies;
+}

package/dist/core/src/exceptions/exception.filter.d.ts

@@ -0,0 +1,3 @@
+export interface ExceptionFilter<T = any, C = any> {
+    catch(exception: T, context: C): void | Promise<void> | any;
+}

package/dist/core/src/exceptions/http.exception.d.ts

@@ -0,0 +1,7 @@
+export declare class HttpException extends Error {
+    readonly response: string | object;
+    readonly status: number;
+    constructor(response: string | object, status: number);
+    getResponse(): string | object;
+    getStatus(): number;
+}

package/dist/core/src/index.d.ts

@@ -0,0 +1,9 @@
+export type { ContractRequestSpec, ContractResponseSpec, ContractSpec, SchemaLike, ValidatorAdapter, } from "@kanjijs/contracts";
+export * from "./context";
+export * from "./decorators";
+export * from "./di/container";
+export * from "./di/module-compiler";
+export * from "./exceptions/exception.filter";
+export * from "./exceptions/http.exception";
+export * from "./metadata";
+export declare const GLOBAL_MIDDLEWARE_TOKEN: unique symbol;

package/dist/core/src/metadata.d.ts

@@ -0,0 +1,64 @@
+import type { ContractSpec } from "@kanjijs/contracts";
+import "reflect-metadata";
+export type Constructor<T = unknown> = new (...args: unknown[]) => T;
+export type HttpMethod = "GET" | "POST" | "PUT" | "DELETE" | "PATCH";
+export type RouteParamType = "BODY" | "QUERY" | "PARAM" | "HEADERS" | "CONTEXT";
+export interface RouteParamMetadata {
+    index: number;
+    type: RouteParamType;
+    data?: string;
+}
+export interface RouteMetadata {
+    method: HttpMethod;
+    path: string;
+    contract?: ContractSpec;
+    middlewares?: unknown[];
+    params?: RouteParamMetadata[];
+}
+export interface ControllerMetadata {
+    prefix: string;
+    middlewares?: unknown[];
+}
+export type Token<T = unknown> = string | symbol | Constructor<T>;
+export type Provider<T = unknown> = Constructor<T> | {
+    provide: Token<T>;
+    useValue: T;
+} | {
+    provide: Token<T>;
+    useClass: Constructor<T>;
+} | {
+    provide: Token<T>;
+    useFactory: (...args: unknown[]) => T | Promise<T>;
+    inject?: Token[];
+};
+export interface DynamicModule {
+    module: Constructor;
+    providers?: Provider[];
+    imports?: Array<Constructor | DynamicModule>;
+    exports?: Token[];
+    global?: boolean;
+}
+export interface ModuleMetadata {
+    controllers?: Constructor[];
+    providers?: Provider[];
+    imports?: Array<Constructor | DynamicModule>;
+    exports?: Token[];
+    global?: boolean;
+}
+export interface IMetadataStorage {
+    addRoute(target: object, methodName: string, meta: RouteMetadata): void;
+    addContract(target: object, methodName: string, contract: ContractSpec): void;
+    addMiddleware(target: object, middleware: unknown, methodName?: string): void;
+    getRoutes(target: object): Map<string, RouteMetadata> | undefined;
+    setController(target: object, meta: ControllerMetadata): void;
+    getController(target: object): ControllerMetadata | undefined;
+    defineModule(target: object, meta: ModuleMetadata): void;
+    getModule(target: object): ModuleMetadata | undefined;
+    addInjection(target: object, index: number, token: Token<unknown>): void;
+    getInjections(target: object): Map<number, Token<unknown>> | undefined;
+    addRouteParam(target: object, methodName: string, param: RouteParamMetadata): void;
+}
+declare global {
+    var KANJI_METADATA_STORAGE: IMetadataStorage | undefined;
+}
+export declare const MetadataStorage: IMetadataStorage;