@stacksjs/bun-router 0.0.12 → 0.0.14

package/package.json

@@ -1,8 +1,9 @@
 {
   "name": "@stacksjs/bun-router",
   "type": "module",
-  "version": "0.0.12",
-  "description": "A fast, type-safe router for Bun.",
+  "version": "0.0.14",
+  "private": true,
+  "description": "A router for Bun.",
   "author": "Chris Breuer <chris@stacksjs.org>",
   "license": "MIT",
   "homepage": "https://github.com/stacksjs/bun-router#readme",
@@ -15,80 +16,74 @@
   },
   "keywords": [
     "router",
-    "route",
-    "server",
-    "laravel",
-    "fast",
     "bun",
     "typescript"
   ],
   "exports": {
     ".": {
-      "bun": "./dist/index.js",
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
     },
     "./*": {
-      "bun": "./dist/*",
       "import": "./dist/*"
     }
   },
-  "publishConfig": {
-    "exports": {
-      ".": {
-        "bun": "./dist/index.js",
-        "types": "./dist/index.d.ts",
-        "import": "./dist/index.js"
-      },
-      "./*": {
-        "bun": "./dist/*",
-        "import": "./dist/*"
-      }
-    }
-  },
   "module": "./dist/index.js",
   "types": "./dist/index.d.ts",
-  "bin": {
-    "bun-router": "./dist/cli.js",
-    "router": "./bin/cli.ts"
-  },
   "files": [
     "README.md",
-    "dist",
-    "src"
+    "dist"
   ],
   "scripts": {
-    "build": "bun --bun build.ts && bun run compile",
+    "build": "cd ./packages/bun-router && bun run build",
     "compile": "bun build ./bin/cli.ts --compile --minify --outfile bin/router",
     "compile:all": "bun run compile:linux-x64 && bun run compile:linux-arm64 && bun run compile:windows-x64 && bun run compile:darwin-x64 && bun run compile:darwin-arm64",
-    "compile:linux-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-x64 --outfile bin/router-linux-x64",
-    "compile:linux-arm64": "bun build ./bin/cli.ts --compile --minify --target=bun-linux-arm64 --outfile bin/router-linux-arm64",
-    "compile:windows-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-windows-x64 --outfile bin/router-windows-x64.exe",
-    "compile:darwin-x64": "bun build ./bin/cli.ts --compile --minify --target=bun-darwin-x64 --outfile bin/router-darwin-x64",
-    "compile:darwin-arm64": "bun build ./bin/cli.ts --compile --minify --target=bun-darwin-arm64 --outfile bin/router-darwin-arm64",
+    "compile:linux-x64": "bun build ./packages/bun-router/bin/cli.ts --compile --minify --target=bun-linux-x64 --outfile ./packages/bun-router/dist/bin/router-linux-x64",
+    "compile:linux-arm64": "bun build ./packages/bun-router/bin/cli.ts --compile --minify --target=bun-linux-arm64 --outfile ./packages/bun-router/dist/bin/router-linux-arm64",
+    "compile:windows-x64": "bun build ./packages/bun-router/bin/cli.ts --compile --minify --target=bun-windows-x64 --outfile ./packages/bun-router/dist/bin/router-windows-x64.exe",
+    "compile:darwin-x64": "bun build ./packages/bun-router/bin/cli.ts --compile --minify --target=bun-darwin-x64 --outfile ./packages/bun-router/dist/bin/router-darwin-x64",
+    "compile:darwin-arm64": "bun build ./packages/bun-router/bin/cli.ts --compile --minify --target=bun-darwin-arm64 --outfile ./packages/bun-router/dist/bin/router-darwin-arm64",
     "zip": "bun run zip:all",
     "zip:all": "bun run zip:linux-x64 && bun run zip:linux-arm64 && bun run zip:windows-x64 && bun run zip:darwin-x64 && bun run zip:darwin-arm64",
-    "zip:linux-x64": "zip -j bin/router-linux-x64.zip bin/router-linux-x64",
-    "zip:linux-arm64": "zip -j bin/router-linux-arm64.zip bin/router-linux-arm64",
-    "zip:windows-x64": "zip -j bin/router-windows-x64.zip bin/router-windows-x64.exe",
-    "zip:darwin-x64": "zip -j bin/router-darwin-x64.zip bin/router-darwin-x64",
-    "zip:darwin-arm64": "zip -j bin/router-darwin-arm64.zip bin/router-darwin-arm64",
-    "lint": "bunx --bun eslint .",
-    "lint:fix": "bunx --bun eslint . --fix",
+    "zip:linux-x64": "zip -j ./packages/bun-router/dist/bin/router-linux-x64.zip ./packages/bun-router/dist/bin/router-linux-x64",
+    "zip:linux-arm64": "zip -j ./packages/bun-router/dist/bin/router-linux-arm64.zip ./packages/bun-router/dist/bin/router-linux-arm64",
+    "zip:windows-x64": "zip -j ./packages/bun-router/dist/bin/router-windows-x64.zip ./packages/bun-router/dist/bin/router-windows-x64.exe",
+    "zip:darwin-x64": "zip -j ./packages/bun-router/dist/bin/router-darwin-x64.zip ./packages/bun-router/dist/bin/router-darwin-x64",
+    "zip:darwin-arm64": "zip -j ./packages/bun-router/dist/bin/router-darwin-arm64.zip ./packages/bun-router/dist/bin/router-darwin-arm64",
     "fresh": "bunx rimraf node_modules/ bun.lock && bun i",
-    "changelog": "bunx changelogen --output CHANGELOG.md",
     "prepublishOnly": "bun --bun run build",
     "package:bin": "bun run compile:all && bun run zip",
-    "release": "bun run changelog && bunx bumpp package.json --all",
     "test": "bun test",
+    "lint": "bunx --bun pickier .",
+    "lint:fix": "bunx --bun pickier . --fix",
+    "format": "bunx --bun pickier . --format",
+    "format:fix": "bunx --bun pickier . --format --write",
+    "changelog": "bunx logsmith --verbose",
+    "changelog:generate": "bunx logsmith --output CHANGELOG.md",
+    "release": "bun --bun run changelog:generate && bunx --bun bumpx prompt --recursive",
+    "release:patch": "bun --bun run changelog:generate && bunx --bun bumpx patch --recursive --yes",
+    "publish:patch": "bun --bun run changelog:generate && bunx --bun bumpx patch --recursive --yes",
+    "release:minor": "bun --bun run changelog:generate && bunx --bun bumpx minor --recursive --yes && cd packages/bun-router && bun publish",
+    "release:major": "bun --bun run changelog:generate && bunx --bun bumpx major --recursive --yes && cd packages/bun-router && bun publish",
+    "dev:docs": "bun --bun bunpress dev docs",
+    "build:docs": "bun --bun bunpress build docs",
+    "preview:docs": "bun --bun bunpress preview docs",
+    "deploy:docs": "bunx bunpress deploy --domain bun-router.stacksjs.com",
     "typecheck": "bunx --bun tsc --noEmit"
   },
-  "dependencies": {
-    "@stacksjs/clapp": "^0.2.0",
-    "bun-query-builder": "^0.1.13",
-    "ts-rate-limiter": "^0.4.2"
+  "devDependencies": {
+    "@stacksjs/bunpress": "^0.1.4",
+    "better-dx": "^0.2.7"
   },
-  "lint-staged": {
-    "*.{js,ts}": "bunx --bun pickier . --fix"
+  "workspaces": [
+    "packages/*"
+  ],
+  "git-hooks": {
+    "pre-commit": {
+      "staged-lint": {
+        "*.{js,ts,json,yaml,yml,md}": "bunx --bun pickier lint --fix"
+      }
+    },
+    "commit-msg": "bunx gitlint --edit .git/COMMIT_EDITMSG"
   }
 }

package/bin/cli.ts

@@ -1,9 +0,0 @@
-/**
- * This file is a simple entry point to the CLI implementation.
- * The actual CLI code is now modularized in src/cli/ directory.
- */
-import { createCLI } from '../src/cli/index'
-
-// Create and run the CLI
-const cli = createCLI()
-cli.parse()

package/dist/auth.d.ts

@@ -1,134 +0,0 @@
-import type { EnhancedRequest, JwtPayload } from './types';
-export interface JwtVerifyOptions {
-    issuer?: string;
-    audience?: string;
-    subject?: string;
-    algorithms?: string[];
-    expiresIn?: string | number;
-    notBefore?: string | number;
-    ignoreExpiration?: boolean;
-    allowInvalidAsymmetricKeyTypes?: boolean;
-}
-export interface JwtSignOptions {
-    algorithm?: 'HS256' | 'HS384' | 'HS512' | 'RS256' | 'RS384' | 'RS512' | 'ES256' | 'ES384' | 'ES512' | 'PS256' | 'PS384' | 'PS512' | 'none';
-    expiresIn?: string | number;
-    notBefore?: string | number;
-    audience?: string | string[];
-    issuer?: string;
-    subject?: string;
-    keyid?: string;
-    jwtid?: string;
-    noTimestamp?: boolean;
-    header?: Record<string, any>;
-    encoding?: string;
-}
-export interface ApiKeyOptions {
-    source?: 'header' | 'query' | 'cookie';
-    keyName?: string;
-    keyPrefix?: string;
-}
-export interface OAuth2Config {
-    clientId: string;
-    clientSecret: string;
-    authorizeUrl: string;
-    tokenUrl: string;
-    redirectUri: string;
-    scope?: string;
-    state?: string;
-}
-export type { JwtPayload };
-/**
- * Simple JWT implementation for signing and verifying tokens
- */
-export declare class JWT {
-    private secret;
-    constructor(secret: string);
-    /**
-     * Sign payload into a JWT token
-     */
-    sign(payload: Record<string, any>, options?: JwtSignOptions): string;
-    /**
-     * Verify a JWT token and return the decoded payload
-     */
-    verify(token: string, options?: JwtVerifyOptions): Record<string, any> | null;
-    /**
-     * Decode a JWT token without verifying the signature
-     */
-    decode(token: string): {
-        header: Record<string, any>;
-        payload: Record<string, any>;
-    } | null;
-    /**
-     * Simple signature creation - Note: This is NOT secure for production
-     * In a real app, use Bun's crypto functionality or a dedicated JWT library
-     */
-    private createSignature;
-    /**
-     * Parse timespan string to seconds
-     */
-    private parseTimespan;
-}
-/**
- * API Key manager to generate, validate and handle API keys
- */
-export declare class ApiKeyManager {
-    private keys;
-    private options;
-    constructor(options?: ApiKeyOptions);
-    /**
-     * Generate a new API key
-     */
-    generateKey(owner: string, scopes?: string[], expiresIn?: number): string;
-    /**
-     * Validate an API key
-     */
-    validateKey(key: string, requiredScopes?: string[]): boolean;
-    /**
-     * Get key information
-     */
-    getKeyInfo(key: string): {
-        owner: string;
-        scopes: string[];
-        expiresAt?: Date;
-    } | null;
-    /**
-     * Revoke an API key
-     */
-    revokeKey(key: string): boolean;
-    /**
-     * Extract API key from request based on configured source
-     */
-    extractFromRequest(req: EnhancedRequest): string | null;
-    /**
-     * Generate a random string for keys
-     */
-    private randomString;
-}
-/**
- * OAuth2 helper for authorization code flow
- */
-export declare class OAuth2Helper {
-    private config;
-    constructor(config: OAuth2Config);
-    /**
-     * Generate authorization URL for redirect
-     */
-    getAuthorizationUrl(additionalParams?: Record<string, string>): string;
-    /**
-     * Exchange authorization code for access token
-     */
-    exchangeCodeForToken(code: string): Promise<Record<string, any>>;
-    /**
-     * Refresh an access token using a refresh token
-     */
-    refreshToken(refreshToken: string): Promise<Record<string, any>>;
-}
-/**
- * Authentication helpers namespace
- */
-declare const Auth: {
-    JWT: typeof JWT;
-    ApiKeyManager: typeof ApiKeyManager;
-    OAuth2Helper: typeof OAuth2Helper;
-};
-export default Auth;

package/dist/cache/lru-cache.d.ts

@@ -1,139 +0,0 @@
-/**
- * High-performance LRU (Least Recently Used) cache implementation
- * Optimized for Bun runtime with configurable size limits and TTL support
- */
-export interface LRUCacheOptions {
-    maxSize: number;
-    ttl?: number;
-    onEvict?: (key: string, value: any) => void;
-    allowStale?: boolean;
-    updateAgeOnGet?: boolean;
-}
-export interface CacheEntry<T = any> {
-    value: T;
-    timestamp: number;
-    accessCount: number;
-    lastAccessed: number;
-    ttl?: number;
-}
-export interface CacheStats {
-    size: number;
-    maxSize: number;
-    hits: number;
-    misses: number;
-    evictions: number;
-    hitRate: number;
-    memoryUsage: number;
-}
-/**
- * High-performance LRU cache with TTL support and detailed statistics
- */
-export declare class LRUCache<T = any> {
-    private options;
-    private cache;
-    private head;
-    private tail;
-    private stats;
-    constructor(options: LRUCacheOptions);
-    /**
-     * Get value from cache
-     */
-    get(key: string): T | undefined;
-    /**
-     * Set value in cache
-     */
-    set(key: string, value: T, ttl?: number): void;
-    /**
-     * Delete key from cache
-     */
-    delete(key: string): boolean;
-    /**
-     * Check if key exists in cache (without updating access time)
-     */
-    has(key: string): boolean;
-    /**
-     * Clear all entries from cache
-     */
-    clear(): void;
-    /**
-     * Get all keys in cache (ordered by recency)
-     */
-    keys(): string[];
-    /**
-     * Get all values in cache (ordered by recency)
-     */
-    values(): T[];
-    /**
-     * Get cache statistics
-     */
-    getStats(): CacheStats;
-    /**
-     * Reset statistics
-     */
-    resetStats(): void;
-    /**
-     * Prune expired entries
-     */
-    prune(): number;
-    /**
-     * Get entries sorted by access frequency
-     */
-    getFrequentlyUsed(limit?: number): Array<{
-        key: string;
-        value: T;
-        accessCount: number;
-    }>;
-    /**
-     * Resize cache (may trigger evictions)
-     */
-    resize(newMaxSize: number): void;
-    /**
-     * Check if entry is expired
-     */
-    private isExpired;
-    /**
-     * Move node to front of list (most recently used)
-     */
-    private moveToFront;
-    /**
-     * Add node to front of list
-     */
-    private addToFront;
-    /**
-     * Remove node from list
-     */
-    private removeNode;
-    /**
-     * Evict least recently used entry
-     */
-    private evictLRU;
-    /**
-     * Estimate memory usage in bytes
-     */
-    private estimateMemoryUsage;
-    /**
-     * Estimate size of a value in bytes
-     */
-    private estimateValueSize;
-}
-/**
- * Factory function to create LRU cache with common configurations
- */
-export declare const createLRUCache: {
-    /**
-     * Create a small cache for frequently accessed items
-     */
-    small: <T = any>(ttl?: number) => LRUCache<T>;
-    /**
-     * Create a medium cache for general purpose use
-     */
-    medium: <T = any>(ttl?: number) => LRUCache<T>;
-    /**
-     * Create a large cache for heavy caching scenarios
-     */
-    large: <T = any>(ttl?: number) => LRUCache<T>;
-    /**
-     * Create a custom configured cache
-     */
-    custom: <T = any>(options: LRUCacheOptions) => LRUCache<T>;
-};

package/dist/cache/middleware-memoization.d.ts

@@ -1,151 +0,0 @@
-import type { EnhancedRequest, MiddlewareHandler } from '../types';
-import type { LRUCacheOptions } from './lru-cache';
-/**
- * Middleware result memoization for expensive operations
- * Caches middleware results based on request characteristics
- */
-export interface MemoizationOptions extends Omit<LRUCacheOptions, 'maxSize'> {
-    maxSize: number;
-    keyGenerator?: (req: EnhancedRequest) => string;
-    shouldMemoize?: (req: EnhancedRequest, result: any) => boolean;
-    resultSerializer?: (result: any) => any;
-    resultDeserializer?: (serialized: any) => any;
-}
-export interface MemoizedResult<T = any> {
-    value: T;
-    timestamp: number;
-    requestFingerprint: string;
-    executionTime: number;
-    hitCount: number;
-}
-export interface MemoizationStats {
-    totalRequests: number;
-    cacheHits: number;
-    cacheMisses: number;
-    hitRate: number;
-    averageExecutionTime: number;
-    totalTimeSaved: number;
-    memoryUsage: number;
-}
-/**
- * Middleware memoization system for caching expensive operations
- */
-export declare class MiddlewareMemoizer {
-    private options;
-    private cache;
-    private stats;
-    constructor(options: MemoizationOptions);
-    /**
-     * Create a memoized version of a middleware function
-     */
-    memoize<_T = any>(middleware: MiddlewareHandler, options?: {
-        name?: string;
-        keyGenerator?: (req: EnhancedRequest) => string;
-        shouldMemoize?: (req: EnhancedRequest, result: any) => boolean;
-        ttl?: number;
-    }): MiddlewareHandler;
-    /**
-     * Create a memoized async function (not middleware)
-     */
-    memoizeFunction<TArgs extends any[], TResult>(fn: (...args: TArgs) => Promise<TResult>, options?: {
-        name?: string;
-        keyGenerator?: (...args: TArgs) => string;
-        shouldMemoize?: (result: TResult, ...args: TArgs) => boolean;
-        ttl?: number;
-    }): (...args: TArgs) => Promise<TResult>;
-    /**
-     * Invalidate cached results by pattern
-     */
-    invalidate(pattern: string | RegExp): number;
-    /**
-     * Invalidate cached results for specific user
-     */
-    invalidateForUser(userId: string): number;
-    /**
-     * Invalidate cached results by tag
-     */
-    invalidateByTag(tag: string): number;
-    /**
-     * Get most frequently used cached results
-     */
-    getPopularResults(limit?: number): Array<{
-        key: string;
-        hitCount: number;
-        executionTime: number;
-        timeSaved: number;
-    }>;
-    /**
-     * Get memoization statistics
-     */
-    getStats(): MemoizationStats;
-    /**
-     * Clear cache and reset statistics
-     */
-    clear(): void;
-    /**
-     * Prune expired entries
-     */
-    prune(): number;
-    /**
-     * Generate cache key for middleware
-     */
-    private generateCacheKey;
-    /**
-     * Generate request fingerprint for cache validation
-     */
-    private generateRequestFingerprint;
-    /**
-     * Update hit rate statistics
-     */
-    private updateHitRate;
-}
-/**
- * Common memoization patterns and utilities
- */
-export declare class MemoizationPatterns {
-    /**
-     * Memoize database queries
-     */
-    static createDatabaseMemoizer(options?: MemoizationOptions): MiddlewareMemoizer;
-    /**
-     * Memoize API calls
-     */
-    static createApiMemoizer(options?: MemoizationOptions): MiddlewareMemoizer;
-    /**
-     * Memoize authentication checks
-     */
-    static createAuthMemoizer(options?: MemoizationOptions): MiddlewareMemoizer;
-    /**
-     * Memoize rate limiting checks
-     */
-    static createRateLimitMemoizer(options?: MemoizationOptions): MiddlewareMemoizer;
-    /**
-     * Memoize expensive computations
-     */
-    static createComputationMemoizer(options?: MemoizationOptions): MiddlewareMemoizer;
-}
-/**
- * Decorator for memoizing class methods
- */
-export declare function Memoize(options?: {
-    memoizer: MiddlewareMemoizer;
-    keyGenerator?: (...args: any[]) => string;
-    ttl?: number;
-}): MethodDecorator;
-/**
- * Factory functions for creating memoizers
- */
-export declare const createMemoizer: {
-    /**
-     * Create memoizer for development
-     */
-    development: () => MiddlewareMemoizer;
-    /**
-     * Create memoizer for production
-     */
-    production: () => MiddlewareMemoizer;
-    /**
-     * Create custom memoizer
-     */
-    custom: (options: MemoizationOptions) => MiddlewareMemoizer;
-};