raffel 0.1.2

package/dist/http/guards.d.ts

@@ -0,0 +1,210 @@
+/**
+ * Guards System
+ *
+ * Route guards for authorization and access control.
+ * Guards are functions that check if a request should be allowed to proceed.
+ *
+ * @example
+ * import { createGuardsRegistry, requireUser, requireRole, requireScope } from 'raffel/http'
+ *
+ * // Create guards registry
+ * const guards = createGuardsRegistry()
+ *
+ * // Register custom guards
+ * guards.register('isAdmin', (c) => c.get('user')?.role === 'admin')
+ * guards.register('isOwner', (c) => c.get('user')?.id === c.req.param('id'))
+ *
+ * // Use built-in guard helpers
+ * app.get('/admin', requireRole('admin'), adminHandler)
+ * app.get('/profile', requireUser(), profileHandler)
+ * app.get('/api/data', requireScope('read:data'), dataHandler)
+ *
+ * // Combine guards (all must pass)
+ * app.delete('/users/:id', requireRole('admin'), guards.get('isOwner'), deleteHandler)
+ */
+import type { HttpContextInterface } from './context.js';
+import type { HttpMiddleware } from './app.js';
+/**
+ * Guard function type
+ * Returns true if access is allowed, false or throws to deny
+ */
+export type GuardFn<E extends Record<string, unknown> = Record<string, unknown>> = (c: HttpContextInterface<E>) => boolean | Promise<boolean>;
+/**
+ * Guard result with optional error message
+ */
+export interface GuardResult {
+    allowed: boolean;
+    message?: string;
+}
+/**
+ * Extended guard function that returns detailed result
+ */
+export type ExtendedGuardFn<E extends Record<string, unknown> = Record<string, unknown>> = (c: HttpContextInterface<E>) => boolean | GuardResult | Promise<boolean | GuardResult>;
+/**
+ * User object interface (minimal expected shape)
+ */
+export interface GuardUser {
+    id?: string | number;
+    role?: string;
+    roles?: string[];
+    scope?: string;
+    scopes?: string[];
+    permissions?: string[];
+    [key: string]: unknown;
+}
+/**
+ * Guard options for built-in guards
+ */
+export interface GuardOptions {
+    /**
+     * Custom error message when guard fails
+     */
+    message?: string;
+    /**
+     * HTTP status code when guard fails (default: 403)
+     */
+    status?: 401 | 403;
+    /**
+     * Key in context where user object is stored
+     * @default 'user'
+     */
+    userKey?: string;
+}
+/**
+ * Guards registry for named guard functions
+ */
+export interface GuardsRegistry<E extends Record<string, unknown> = Record<string, unknown>> {
+    /**
+     * Register a named guard
+     */
+    register(name: string, guard: ExtendedGuardFn<E>): void;
+    /**
+     * Get a guard as middleware by name
+     */
+    get(name: string): HttpMiddleware<E>;
+    /**
+     * Check if a guard exists
+     */
+    has(name: string): boolean;
+    /**
+     * Get all registered guard names
+     */
+    names(): string[];
+    /**
+     * Create a composite guard (all must pass)
+     */
+    all(...names: string[]): HttpMiddleware<E>;
+    /**
+     * Create a composite guard (any must pass)
+     */
+    any(...names: string[]): HttpMiddleware<E>;
+}
+/**
+ * Create a guards registry
+ *
+ * @example
+ * const guards = createGuardsRegistry()
+ *
+ * guards.register('isAdmin', (c) => c.get('user')?.role === 'admin')
+ * guards.register('isVerified', (c) => c.get('user')?.verified === true)
+ *
+ * app.get('/admin', guards.get('isAdmin'), adminHandler)
+ * app.get('/dashboard', guards.all('isAdmin', 'isVerified'), dashHandler)
+ */
+export declare function createGuardsRegistry<E extends Record<string, unknown> = Record<string, unknown>>(): GuardsRegistry<E>;
+/**
+ * Require an authenticated user
+ *
+ * Checks if a user object exists in context.
+ *
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * app.get('/profile', requireUser(), getProfile)
+ * app.get('/settings', requireUser({ userKey: 'currentUser' }), getSettings)
+ */
+export declare function requireUser<E extends Record<string, unknown> = Record<string, unknown>>(options?: GuardOptions): HttpMiddleware<E>;
+/**
+ * Require a specific role
+ *
+ * Checks if the user has the specified role.
+ *
+ * @param role - Required role (or array of roles, any match)
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * app.get('/admin', requireRole('admin'), adminDashboard)
+ * app.get('/moderate', requireRole(['admin', 'moderator']), moderateContent)
+ */
+export declare function requireRole<E extends Record<string, unknown> = Record<string, unknown>>(role: string | string[], options?: GuardOptions): HttpMiddleware<E>;
+/**
+ * Require a specific scope/permission
+ *
+ * Checks if the user has the specified scope.
+ *
+ * @param scope - Required scope (or array of scopes, any match)
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * app.get('/api/users', requireScope('read:users'), listUsers)
+ * app.post('/api/users', requireScope('write:users'), createUser)
+ * app.delete('/api/users/:id', requireScope(['admin', 'delete:users']), deleteUser)
+ */
+export declare function requireScope<E extends Record<string, unknown> = Record<string, unknown>>(scope: string | string[], options?: GuardOptions): HttpMiddleware<E>;
+/**
+ * Require a specific permission (alias for requireScope)
+ */
+export declare const requirePermission: typeof requireScope;
+/**
+ * Create a custom guard middleware
+ *
+ * @param guardFn - Guard function
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * const isOwner = guard(
+ *   (c) => c.get('user')?.id === c.req.param('id'),
+ *   { message: 'You can only access your own resources' }
+ * )
+ *
+ * app.get('/users/:id/private', isOwner, getPrivateData)
+ */
+export declare function guard<E extends Record<string, unknown> = Record<string, unknown>>(guardFn: ExtendedGuardFn<E>, options?: GuardOptions): HttpMiddleware<E>;
+/**
+ * Combine multiple guards (all must pass)
+ *
+ * @param guards - Guard middlewares to combine
+ * @returns Combined middleware
+ *
+ * @example
+ * const adminOwner = allGuards(requireRole('admin'), isOwnerGuard)
+ * app.delete('/posts/:id', adminOwner, deletePost)
+ */
+export declare function allGuards<E extends Record<string, unknown> = Record<string, unknown>>(...guards: HttpMiddleware<E>[]): HttpMiddleware<E>;
+/**
+ * Combine multiple guards (any must pass)
+ *
+ * @param guards - Guard middlewares to combine
+ * @returns Combined middleware
+ *
+ * @example
+ * const adminOrMod = anyGuard(requireRole('admin'), requireRole('moderator'))
+ * app.post('/moderate', adminOrMod, moderateContent)
+ */
+export declare function anyGuard<E extends Record<string, unknown> = Record<string, unknown>>(...guards: HttpMiddleware<E>[]): HttpMiddleware<E>;
+declare const _default: {
+    createGuardsRegistry: typeof createGuardsRegistry;
+    requireUser: typeof requireUser;
+    requireRole: typeof requireRole;
+    requireScope: typeof requireScope;
+    requirePermission: typeof requireScope;
+    guard: typeof guard;
+    allGuards: typeof allGuards;
+    anyGuard: typeof anyGuard;
+};
+export default _default;
+//# sourceMappingURL=guards.d.ts.map

package/dist/http/guards.d.ts.map

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

package/dist/http/guards.js

@@ -0,0 +1,327 @@
+/**
+ * Guards System
+ *
+ * Route guards for authorization and access control.
+ * Guards are functions that check if a request should be allowed to proceed.
+ *
+ * @example
+ * import { createGuardsRegistry, requireUser, requireRole, requireScope } from 'raffel/http'
+ *
+ * // Create guards registry
+ * const guards = createGuardsRegistry()
+ *
+ * // Register custom guards
+ * guards.register('isAdmin', (c) => c.get('user')?.role === 'admin')
+ * guards.register('isOwner', (c) => c.get('user')?.id === c.req.param('id'))
+ *
+ * // Use built-in guard helpers
+ * app.get('/admin', requireRole('admin'), adminHandler)
+ * app.get('/profile', requireUser(), profileHandler)
+ * app.get('/api/data', requireScope('read:data'), dataHandler)
+ *
+ * // Combine guards (all must pass)
+ * app.delete('/users/:id', requireRole('admin'), guards.get('isOwner'), deleteHandler)
+ */
+import { HttpUnauthorizedError, HttpForbiddenError } from './errors.js';
+/**
+ * Create a guards registry
+ *
+ * @example
+ * const guards = createGuardsRegistry()
+ *
+ * guards.register('isAdmin', (c) => c.get('user')?.role === 'admin')
+ * guards.register('isVerified', (c) => c.get('user')?.verified === true)
+ *
+ * app.get('/admin', guards.get('isAdmin'), adminHandler)
+ * app.get('/dashboard', guards.all('isAdmin', 'isVerified'), dashHandler)
+ */
+export function createGuardsRegistry() {
+    const guards = new Map();
+    return {
+        register(name, guard) {
+            guards.set(name, guard);
+        },
+        get(name) {
+            const guard = guards.get(name);
+            if (!guard) {
+                throw new Error(`Guard not found: ${name}`);
+            }
+            return createGuardMiddleware(guard, { message: `Guard '${name}' denied access` });
+        },
+        has(name) {
+            return guards.has(name);
+        },
+        names() {
+            return Array.from(guards.keys());
+        },
+        all(...names) {
+            const guardFns = names.map((name) => {
+                const guard = guards.get(name);
+                if (!guard)
+                    throw new Error(`Guard not found: ${name}`);
+                return guard;
+            });
+            return async (c, next) => {
+                for (const guard of guardFns) {
+                    const result = await guard(c);
+                    const allowed = typeof result === 'boolean' ? result : result.allowed;
+                    if (!allowed) {
+                        const message = typeof result === 'object' ? result.message : undefined;
+                        throw new HttpForbiddenError(message || 'Access denied');
+                    }
+                }
+                await next();
+            };
+        },
+        any(...names) {
+            const guardFns = names.map((name) => {
+                const guard = guards.get(name);
+                if (!guard)
+                    throw new Error(`Guard not found: ${name}`);
+                return guard;
+            });
+            return async (c, next) => {
+                for (const guard of guardFns) {
+                    try {
+                        const result = await guard(c);
+                        const allowed = typeof result === 'boolean' ? result : result.allowed;
+                        if (allowed) {
+                            await next();
+                            return;
+                        }
+                    }
+                    catch {
+                        // Guard threw, try next one
+                    }
+                }
+                throw new HttpForbiddenError('Access denied');
+            };
+        },
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Guard Middleware Factory
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Create a middleware from a guard function
+ */
+function createGuardMiddleware(guard, options = {}) {
+    const { message = 'Access denied', status = 403, userKey: _userKey = 'user' } = options;
+    return async (c, next) => {
+        try {
+            const result = await guard(c);
+            const allowed = typeof result === 'boolean' ? result : result.allowed;
+            const errorMessage = typeof result === 'object' && result.message ? result.message : message;
+            if (!allowed) {
+                if (status === 401) {
+                    throw new HttpUnauthorizedError(errorMessage);
+                }
+                throw new HttpForbiddenError(errorMessage);
+            }
+            await next();
+        }
+        catch (err) {
+            if (err instanceof HttpUnauthorizedError || err instanceof HttpForbiddenError) {
+                throw err;
+            }
+            // Guard threw an unexpected error
+            throw new HttpForbiddenError(message);
+        }
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Built-in Guards
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Require an authenticated user
+ *
+ * Checks if a user object exists in context.
+ *
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * app.get('/profile', requireUser(), getProfile)
+ * app.get('/settings', requireUser({ userKey: 'currentUser' }), getSettings)
+ */
+export function requireUser(options = {}) {
+    const { message = 'Authentication required', status: _status = 401, userKey = 'user' } = options;
+    return async (c, next) => {
+        const user = c.get(userKey);
+        if (!user) {
+            throw new HttpUnauthorizedError(message);
+        }
+        await next();
+    };
+}
+/**
+ * Require a specific role
+ *
+ * Checks if the user has the specified role.
+ *
+ * @param role - Required role (or array of roles, any match)
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * app.get('/admin', requireRole('admin'), adminDashboard)
+ * app.get('/moderate', requireRole(['admin', 'moderator']), moderateContent)
+ */
+export function requireRole(role, options = {}) {
+    const roles = Array.isArray(role) ? role : [role];
+    const { message, status: _status = 403, userKey = 'user' } = options;
+    const defaultMessage = `Required role: ${roles.join(' or ')}`;
+    return async (c, next) => {
+        const user = c.get(userKey);
+        if (!user) {
+            throw new HttpUnauthorizedError('Authentication required');
+        }
+        // Check user.role (single role)
+        if (user.role && roles.includes(user.role)) {
+            await next();
+            return;
+        }
+        // Check user.roles (array of roles)
+        if (user.roles && user.roles.some((r) => roles.includes(r))) {
+            await next();
+            return;
+        }
+        throw new HttpForbiddenError(message || defaultMessage);
+    };
+}
+/**
+ * Require a specific scope/permission
+ *
+ * Checks if the user has the specified scope.
+ *
+ * @param scope - Required scope (or array of scopes, any match)
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * app.get('/api/users', requireScope('read:users'), listUsers)
+ * app.post('/api/users', requireScope('write:users'), createUser)
+ * app.delete('/api/users/:id', requireScope(['admin', 'delete:users']), deleteUser)
+ */
+export function requireScope(scope, options = {}) {
+    const scopes = Array.isArray(scope) ? scope : [scope];
+    const { message, status: _status = 403, userKey = 'user' } = options;
+    const defaultMessage = `Required scope: ${scopes.join(' or ')}`;
+    return async (c, next) => {
+        const user = c.get(userKey);
+        if (!user) {
+            throw new HttpUnauthorizedError('Authentication required');
+        }
+        // Check user.scope (single scope string, space-separated)
+        if (user.scope) {
+            const userScopes = user.scope.split(' ');
+            if (scopes.some((s) => userScopes.includes(s))) {
+                await next();
+                return;
+            }
+        }
+        // Check user.scopes (array of scopes)
+        if (user.scopes && user.scopes.some((s) => scopes.includes(s))) {
+            await next();
+            return;
+        }
+        // Check user.permissions (alternative name)
+        if (user.permissions && user.permissions.some((p) => scopes.includes(p))) {
+            await next();
+            return;
+        }
+        throw new HttpForbiddenError(message || defaultMessage);
+    };
+}
+/**
+ * Require a specific permission (alias for requireScope)
+ */
+export const requirePermission = requireScope;
+/**
+ * Create a custom guard middleware
+ *
+ * @param guardFn - Guard function
+ * @param options - Guard options
+ * @returns Middleware function
+ *
+ * @example
+ * const isOwner = guard(
+ *   (c) => c.get('user')?.id === c.req.param('id'),
+ *   { message: 'You can only access your own resources' }
+ * )
+ *
+ * app.get('/users/:id/private', isOwner, getPrivateData)
+ */
+export function guard(guardFn, options = {}) {
+    return createGuardMiddleware(guardFn, options);
+}
+/**
+ * Combine multiple guards (all must pass)
+ *
+ * @param guards - Guard middlewares to combine
+ * @returns Combined middleware
+ *
+ * @example
+ * const adminOwner = allGuards(requireRole('admin'), isOwnerGuard)
+ * app.delete('/posts/:id', adminOwner, deletePost)
+ */
+export function allGuards(...guards) {
+    return async (c, next) => {
+        for (const g of guards) {
+            await new Promise((resolve, reject) => {
+                const result = g(c, async () => resolve());
+                if (result instanceof Promise) {
+                    result.catch(reject);
+                }
+            });
+        }
+        await next();
+    };
+}
+/**
+ * Combine multiple guards (any must pass)
+ *
+ * @param guards - Guard middlewares to combine
+ * @returns Combined middleware
+ *
+ * @example
+ * const adminOrMod = anyGuard(requireRole('admin'), requireRole('moderator'))
+ * app.post('/moderate', adminOrMod, moderateContent)
+ */
+export function anyGuard(...guards) {
+    return async (c, next) => {
+        const errors = [];
+        for (const g of guards) {
+            try {
+                await new Promise((resolve, reject) => {
+                    const result = g(c, async () => resolve());
+                    if (result instanceof Promise) {
+                        result.catch(reject);
+                    }
+                });
+                // Guard passed, continue to handler
+                await next();
+                return;
+            }
+            catch (err) {
+                errors.push(err);
+            }
+        }
+        // All guards failed
+        throw errors[0] || new HttpForbiddenError('Access denied');
+    };
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Exports
+// ─────────────────────────────────────────────────────────────────────────────
+export default {
+    createGuardsRegistry,
+    requireUser,
+    requireRole,
+    requireScope,
+    requirePermission,
+    guard,
+    allGuards,
+    anyGuard,
+};
+//# sourceMappingURL=guards.js.map

package/dist/http/guards.js.map

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