@spfn/core 0.1.0-alpha.88 → 0.2.0-beta.2

package/dist/types-BGl4QL1w.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Logger Type Definitions
+ *
+ * 로깅 시스템 타입 정의
+ *
+ * ✅ 구현 완료:
+ * - LogLevel 타입 정의
+ * - LogMetadata 인터페이스
+ * - Transport 인터페이스
+ * - 환경별 설정 타입
+ *
+ * 🔗 관련 파일:
+ * - src/logger/logger.ts (Logger 클래스)
+ * - src/logger/transports/ (Transport 구현체)
+ * - src/logger/config.ts (설정)
+ */
+/**
+ * 로그 레벨
+ * debug < info < warn < error < fatal
+ */
+type LogLevel = 'debug' | 'info' | 'warn' | 'error' | 'fatal';
+/**
+ * 로그 메타데이터
+ */
+interface LogMetadata {
+    timestamp: Date;
+    level: LogLevel;
+    message: string;
+    module?: string;
+    error?: Error;
+    context?: Record<string, unknown>;
+}
+/**
+ * Transport 인터페이스
+ * 모든 Transport는 이 인터페이스를 구현해야 함
+ */
+interface Transport {
+    /**
+     * Transport 이름
+     */
+    name: string;
+    /**
+     * 최소 로그 레벨 (이 레벨 이상만 처리)
+     */
+    level: LogLevel;
+    /**
+     * 활성화 여부
+     */
+    enabled: boolean;
+    /**
+     * 로그 처리 함수
+     */
+    log(metadata: LogMetadata): Promise<void>;
+    /**
+     * Transport 종료 (리소스 정리)
+     */
+    close?(): Promise<void>;
+}
+/**
+ * Logger 설정
+ */
+interface LoggerConfig {
+    /**
+     * 기본 로그 레벨
+     */
+    level: LogLevel;
+    /**
+     * 모듈명 (context)
+     */
+    module?: string;
+    /**
+     * Transport 리스트
+     */
+    transports: Transport[];
+}
+
+export type { LogLevel as L, Transport as T, LoggerConfig as a };

package/dist/types-DRG2XMTR.d.ts

@@ -0,0 +1,157 @@
+import { TSchema, Static } from '@sinclair/typebox';
+import { ErrorRegistry, ErrorRegistryInput } from '@spfn/core/errors';
+import { RouteDef, RouteInput } from '@spfn/core/route';
+
+/**
+ * Extract structured input from RouteInput
+ */
+type StructuredInput<TInput extends RouteInput> = {
+    params: TInput['params'] extends TSchema ? Static<TInput['params']> : {};
+    query: TInput['query'] extends TSchema ? Static<TInput['query']> : {};
+    body: TInput['body'] extends TSchema ? Static<TInput['body']> : {};
+    headers: TInput['headers'] extends TSchema ? Static<TInput['headers']> : {};
+    cookies: TInput['cookies'] extends TSchema ? Static<TInput['cookies']> : {};
+};
+/**
+ * Infer route input type
+ */
+type InferRouteInput<TRoute> = TRoute extends RouteDef<infer TInput, any, any> ? StructuredInput<TInput> : never;
+/**
+ * Infer route output type
+ */
+type InferRouteOutput<TRoute> = TRoute extends RouteDef<any, any, infer TResponse> ? TResponse : never;
+/**
+ * Cookie options for setCookie
+ */
+interface CookieOptions {
+    httpOnly?: boolean;
+    secure?: boolean;
+    sameSite?: 'strict' | 'lax' | 'none';
+    maxAge?: number;
+    path?: string;
+    domain?: string;
+}
+/**
+ * Cookie to set in response
+ */
+interface SetCookie {
+    name: string;
+    value: string;
+    options?: CookieOptions;
+}
+/**
+ * Request interceptor - called before fetch
+ */
+type RequestInterceptor = (url: string, init: RequestInit) => Promise<RequestInit> | RequestInit;
+/**
+ * Response interceptor - called after fetch
+ */
+type ResponseInterceptor = (response: Response, body: any) => Promise<{
+    response: Response;
+    body: any;
+}> | {
+    response: Response;
+    body: any;
+};
+/**
+ * Client configuration
+ */
+interface ApiConfig {
+    /**
+     * Base URL for RPC endpoint
+     *
+     * @default '/api/rpc'
+     * @example '/api/rpc', 'http://localhost:3000/api/rpc'
+     */
+    baseUrl?: string;
+    /**
+     * Default headers for all requests
+     */
+    headers?: Record<string, string>;
+    /**
+     * Request timeout in milliseconds
+     *
+     * @default 30000
+     */
+    timeout?: number;
+    /**
+     * Custom fetch implementation
+     */
+    fetch?: typeof fetch;
+    /**
+     * Global request interceptor
+     */
+    onRequest?: RequestInterceptor;
+    /**
+     * Global response interceptor
+     */
+    onResponse?: ResponseInterceptor;
+    /**
+     * Custom error registry for deserialization
+     *
+     * Core HTTP errors are automatically registered. Use this to add your custom application errors.
+     *
+     * @example
+     * ```typescript
+     * import { errorRegistry } from '@spfn/core/errors';
+     * import { authErrorRegistry } from '@myapp/auth/errors';
+     * import { PaymentFailedError } from '@/server/errors';
+     *
+     * const api = createApi<AppRouter>({
+     *   errorRegistry: [errorRegistry, authErrorRegistry, PaymentFailedError]
+     * });
+     * ```
+     */
+    errorRegistry?: ErrorRegistry | ErrorRegistryInput[];
+    /**
+     * Enable debug logging
+     *
+     * @default false
+     */
+    debug?: boolean;
+}
+/**
+ * Per-call options
+ */
+interface CallOptions {
+    /**
+     * Additional headers for this request
+     */
+    headers?: Record<string, string>;
+    /**
+     * Override cookies for this request
+     *
+     * Note: Cookies are automatically forwarded by the proxy.
+     * Use this only when you need to override them.
+     */
+    cookies?: Record<string, string>;
+    /**
+     * Request-specific interceptor
+     */
+    onRequest?: RequestInterceptor;
+    /**
+     * Response-specific interceptor
+     */
+    onResponse?: ResponseInterceptor;
+    /**
+     * Next.js-specific fetch options
+     *
+     * @example
+     * // Time-based revalidation
+     * { next: { revalidate: 60 } }
+     *
+     * // Disable cache
+     * { cache: 'no-store' }
+     *
+     * // Tag-based revalidation
+     * { next: { tags: ['users'] } }
+     */
+    fetchOptions?: RequestInit & {
+        next?: {
+            revalidate?: number | false;
+            tags?: string[];
+        };
+    };
+}
+
+export type { ApiConfig as A, CallOptions as C, InferRouteInput as I, RequestInterceptor as R, SetCookie as S, ResponseInterceptor as a, InferRouteOutput as b };

package/package.json

@@ -1,31 +1,34 @@
 {
   "name": "@spfn/core",
-  "version": "0.1.0-alpha.88",
+  "version": "0.2.0-beta.2",
   "description": "SPFN Framework Core - File-based routing, transactions, repository pattern",
   "type": "module",
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
   "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.js"
-    },
     "./client": {
       "types": "./dist/client/index.d.ts",
       "import": "./dist/client/index.js",
       "require": "./dist/client/index.js"
     },
-    "./client/nextjs": {
-      "types": "./dist/client/nextjs/index.d.ts",
-      "import": "./dist/client/nextjs/index.js",
-      "require": "./dist/client/nextjs/index.js"
+    "./nextjs": {
+      "types": "./dist/nextjs/index.d.ts",
+      "import": "./dist/nextjs/index.js",
+      "require": "./dist/nextjs/index.js"
+    },
+    "./nextjs/server": {
+      "types": "./dist/nextjs/server.d.ts",
+      "import": "./dist/nextjs/server.js",
+      "require": "./dist/nextjs/server.js"
     },
     "./route": {
       "types": "./dist/route/index.d.ts",
       "import": "./dist/route/index.js",
       "require": "./dist/route/index.js"
     },
+    "./route/types": {
+      "types": "./dist/route/types.d.ts",
+      "import": "./dist/route/types.js",
+      "require": "./dist/route/types.js"
+    },
     "./db": {
       "types": "./dist/db/index.d.ts",
       "import": "./dist/db/index.js",
@@ -46,11 +49,6 @@
       "import": "./dist/middleware/index.js",
       "require": "./dist/middleware/index.js"
     },
-    "./types": {
-      "types": "./dist/types/index.d.ts",
-      "import": "./dist/types/index.js",
-      "require": "./dist/types/index.js"
-    },
     "./cache": {
       "types": "./dist/cache/index.d.ts",
       "import": "./dist/cache/index.js",
@@ -71,20 +69,20 @@
       "import": "./dist/logger/index.js",
       "require": "./dist/logger/index.js"
     },
-    "./events": {
-      "types": "./dist/events/index.d.ts",
-      "import": "./dist/events/index.js",
-      "require": "./dist/events/index.js"
+    "./config": {
+      "types": "./dist/config/index.d.ts",
+      "import": "./dist/config/index.js",
+      "require": "./dist/config/index.js"
     },
-    "./generators": {
-      "types": "./dist/codegen/generators/index.d.ts",
-      "import": "./dist/codegen/generators/index.js",
-      "require": "./dist/codegen/generators/index.js"
+    "./job": {
+      "types": "./dist/job/index.d.ts",
+      "import": "./dist/job/index.js",
+      "require": "./dist/job/index.js"
     },
-    "./codegen/generators": {
-      "types": "./dist/codegen/generators/index.d.ts",
-      "import": "./dist/codegen/generators/index.js",
-      "require": "./dist/codegen/generators/index.js"
+    "./event": {
+      "types": "./dist/event/index.d.ts",
+      "import": "./dist/event/index.js",
+      "require": "./dist/event/index.js"
     }
   },
   "keywords": [
@@ -131,11 +129,12 @@
     "chalk": "^5.6.2",
     "chokidar": "^4.0.3",
     "dotenv": "^17.2.3",
-    "drizzle-orm": "^0.44.7",
+    "drizzle-orm": "^0.45.0",
     "drizzle-typebox": "^0.1.0",
-    "hono": "^4.9.0",
+    "hono": "^4.10.6",
     "jiti": "^2.6.1",
     "micromatch": "^4.0.8",
+    "pg-boss": "^11.1.2",
     "postgres": "^3.4.0",
     "typescript": "^5.3.3",
     "zod": "^4.1.11"
@@ -148,12 +147,18 @@
     "@types/node": "^20.11.0",
     "@vitest/coverage-v8": "^4.0.6",
     "drizzle-kit": "^0.31.6",
-    "next": "^16.0.1",
+    "madge": "^8.0.0",
+    "next": "16.0.7",
     "tsup": "^8.5.0",
     "vitest": "^4.0.6"
   },
   "peerDependencies": {
-    "next": "^16.0.1"
+    "next": "^15.0.0 || ^16.0.0"
+  },
+  "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    }
   },
   "files": [
     "dist",
@@ -166,25 +171,25 @@
     "tag": "alpha"
   },
   "scripts": {
-    "build": "tsup",
+    "build": "pnpm check:circular && tsup",
     "dev": "tsup",
-    "test": "vitest",
-    "test:unit": "vitest --config vitest.unit.config.ts",
-    "test:integration": "vitest --config vitest.integration.config.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
     "test:coverage": "vitest run --config vitest.unit.config.ts --coverage",
-    "test:logger": "vitest src/logger",
-    "test:errors": "vitest src/errors",
-    "test:codegen": "vitest src/codegen",
-    "test:route": "vitest src/route",
-    "test:client": "vitest src/client",
-    "test:middleware": "vitest src/middleware",
-    "test:env": "vitest src/env",
-    "test:cache": "vitest src/cache --config vitest.integration.config.ts",
-    "test:db": "vitest src/db --config vitest.integration.config.ts",
-    "test:server": "vitest src/server --config vitest.integration.config.ts",
+    "test:logger": "vitest run src/logger",
+    "test:errors": "vitest run src/errors",
+    "test:codegen": "vitest run src/codegen",
+    "test:route": "vitest run src/route",
+    "test:client": "vitest run src/client",
+    "test:middleware": "vitest run src/middleware",
+    "test:env": "vitest run src/env",
+    "test:cache": "vitest run src/cache --config vitest.integration.config.ts",
+    "test:db": "vitest run src/db --config vitest.integration.config.ts",
+    "test:server": "vitest run src/server --config vitest.integration.config.ts",
     "docker:test:up": "docker compose -f docker-compose.test.yml up -d",
     "docker:test:down": "docker compose -f docker-compose.test.yml down",
     "docker:test:logs": "docker compose -f docker-compose.test.yml logs -f",
+    "check:circular": "madge --circular --extensions ts src/",
     "type-check": "tsc --noEmit"
   }
 }

package/dist/auto-loader-JFaZ9gON.d.ts

@@ -1,80 +0,0 @@
-import { MiddlewareHandler, Hono } from 'hono';
-
-declare module 'hono' {
-    interface ContextVariableMap {
-        _skipMiddlewares?: string[];
-    }
-}
-/**
- * AutoRouteLoader: Simplified File-based Routing System
- *
- * Features:
- * - Auto-discovery: Scans routes directory and auto-registers
- * - Dynamic routes: [id] → :id, [...slug] → *
- * - Statistics: Route registration stats for dashboard
- * - Grouping: Natural grouping by directory structure
- */
-type RouteInfo = {
-    path: string;
-    file: string;
-    meta?: {
-        description?: string;
-        tags?: string[];
-        auth?: boolean;
-        [key: string]: unknown;
-    };
-    priority: number;
-};
-type RouteStats = {
-    total: number;
-    byPriority: {
-        static: number;
-        dynamic: number;
-        catchAll: number;
-    };
-    byTag: Record<string, number>;
-    routes: RouteInfo[];
-};
-declare class AutoRouteLoader {
-    private routesDir;
-    private routes;
-    private readonly debug;
-    private readonly middlewares;
-    constructor(routesDir: string, debug?: boolean, middlewares?: Array<{
-        name: string;
-        handler: MiddlewareHandler;
-    }>);
-    load(app: Hono): Promise<RouteStats>;
-    /**
-     * Load routes from an external directory (e.g., from SPFN function packages)
-     * Reads package.json spfn.prefix and mounts routes under that prefix
-     *
-     * @param app - Hono app instance
-     * @param routesDir - Directory containing route handlers
-     * @param packageName - Name of the package (for logging)
-     * @param prefix - Optional prefix to mount routes under (from package.json spfn.prefix)
-     * @returns Route statistics
-     */
-    loadExternalRoutes(app: Hono, routesDir: string, packageName: string, prefix?: string): Promise<RouteStats>;
-    getStats(): RouteStats;
-    private scanFiles;
-    private isValidRouteFile;
-    private loadRoute;
-    private extractContractPaths;
-    private calculateContractPriority;
-    private validateModule;
-    private registerContractBasedMiddlewares;
-    private categorizeAndLogError;
-    private logStats;
-}
-declare function loadRoutes(app: Hono, options?: {
-    routesDir?: string;
-    debug?: boolean;
-    middlewares?: Array<{
-        name: string;
-        handler: MiddlewareHandler;
-    }>;
-    includeFunctionRoutes?: boolean;
-}): Promise<RouteStats>;
-
-export { AutoRouteLoader as A, type RouteInfo as R, type RouteStats as a, loadRoutes as l };