@spfn/core 0.1.0-alpha.81 → 0.1.0-alpha.82

package/dist/{types-DYueuoD6.d.ts → types/index.d.ts}

@@ -1,9 +1,22 @@
-import { Context } from 'hono';
-import { ContentfulStatusCode } from 'hono/utils/http-status';
 import * as _sinclair_typebox from '@sinclair/typebox';
-import { TSchema, Static } from '@sinclair/typebox';
-import { b as ErrorResponse } from './error-handler-wjLL3v-a.js';
+import { TSchema } from '@sinclair/typebox';
 
+/**
+ * Standard error response format
+ *
+ * Used by ErrorHandler middleware for all error responses.
+ * Compatible with ApiResponse pattern for consistent API responses.
+ */
+interface ErrorResponse {
+    success: false;
+    error: {
+        message: string;
+        type: string;
+        statusCode: number;
+        stack?: string;
+        details?: any;
+    };
+}
 /**
  * Success response wrapper
  */
@@ -23,7 +36,7 @@ interface ApiSuccessResponse<T = any> {
     };
 }
 /**
- * Error response type (re-exported from ErrorHandler for consistency)
+ * Error response type (alias for ErrorResponse)
  */
 type ApiErrorResponse = ErrorResponse;
 /**
@@ -105,58 +118,4 @@ declare function ApiResponseSchema<T extends TSchema>(dataSchema: T): _sinclair_
     }>>;
 }>;
 
-/**
- * File-based Routing System Type Definitions
- */
-type HeaderRecord = Record<string, string | string[]>;
-type RouteMeta = {
-    public?: boolean;
-    skipMiddlewares?: string[];
-    tags?: string[];
-    description?: string;
-    deprecated?: boolean;
-};
-/**
- * Route Contract: TypeBox-based type-safe route definition
- *
- * Defines the shape of request/response for a route endpoint
- */
-type RouteContract = {
-    method: HttpMethod;
-    path: string;
-    params?: TSchema;
-    query?: TSchema;
-    body?: TSchema;
-    response: TSchema;
-    meta?: RouteMeta;
-};
-/**
- * Infer types from RouteContract
- *
- * Extracts TypeScript types from TypeBox schemas
- */
-type InferContract<TContract extends RouteContract> = {
-    params: TContract['params'] extends TSchema ? Static<TContract['params']> : Record<string, never>;
-    query: TContract['query'] extends TSchema ? Static<TContract['query']> : Record<string, never>;
-    body: TContract['body'] extends TSchema ? Static<TContract['body']> : Record<string, never>;
-    response: TContract['response'] extends TSchema ? Static<TContract['response']> : unknown;
-};
-/**
- * RouteContext: Route Handler Dedicated Context
- *
- * Generic version with contract-based type inference
- */
-type RouteContext<TContract extends RouteContract = any> = {
-    params: InferContract<TContract>['params'];
-    query: InferContract<TContract>['query'];
-    data(): Promise<InferContract<TContract>['body']>;
-    json(data: InferContract<TContract>['response'], status?: ContentfulStatusCode, headers?: HeaderRecord): Response;
-    success<T>(data: T, meta?: ApiSuccessResponse<T>['meta'], status?: number): Response;
-    paginated<T>(data: T[], page: number, limit: number, total: number): Response;
-    raw: Context;
-};
-type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
-type RouteHandler<TContract extends RouteContract = any> = (c: RouteContext<TContract>) => Response | Promise<Response>;
-declare function isHttpMethod(value: unknown): value is HttpMethod;
-
-export { ApiSuccessSchema as A, type HttpMethod as H, type InferContract as I, type RouteContext as R, type RouteContract as a, type RouteHandler as b, ApiErrorSchema as c, ApiResponseSchema as d, type ApiSuccessResponse as e, type ApiErrorResponse as f, type ApiResponse as g, type HeaderRecord as h, isHttpMethod as i, type RouteMeta as j };
+export { type ApiErrorResponse, ApiErrorSchema, type ApiResponse, ApiResponseSchema, type ApiSuccessResponse, ApiSuccessSchema, type ErrorResponse };

package/dist/types/index.js

@@ -0,0 +1,38 @@
+import { Type } from '@sinclair/typebox';
+
+// src/types/api-response.ts
+function ApiSuccessSchema(dataSchema) {
+  return Type.Object({
+    success: Type.Literal(true),
+    data: dataSchema,
+    meta: Type.Optional(Type.Object({
+      timestamp: Type.Optional(Type.String()),
+      requestId: Type.Optional(Type.String()),
+      pagination: Type.Optional(Type.Object({
+        page: Type.Number(),
+        limit: Type.Number(),
+        total: Type.Number(),
+        totalPages: Type.Number()
+      }))
+    }))
+  });
+}
+function ApiErrorSchema() {
+  return Type.Object({
+    success: Type.Literal(false),
+    error: Type.Object({
+      message: Type.String(),
+      type: Type.String(),
+      statusCode: Type.Number(),
+      stack: Type.Optional(Type.String()),
+      details: Type.Optional(Type.Any())
+    })
+  });
+}
+function ApiResponseSchema(dataSchema) {
+  return ApiSuccessSchema(dataSchema);
+}
+
+export { ApiErrorSchema, ApiResponseSchema, ApiSuccessSchema };
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/api-response.ts"],"names":[],"mappings":";;;AAiFO,SAAS,iBAAoC,UAAA,EACpD;AACI,EAAA,OAAO,KAAK,MAAA,CAAO;AAAA,IACf,OAAA,EAAS,IAAA,CAAK,OAAA,CAAQ,IAAI,CAAA;AAAA,IAC1B,IAAA,EAAM,UAAA;AAAA,IACN,IAAA,EAAM,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,MAAA,CAAO;AAAA,MAC5B,SAAA,EAAW,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAQ,CAAA;AAAA,MACtC,SAAA,EAAW,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAQ,CAAA;AAAA,MACtC,UAAA,EAAY,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,MAAA,CAAO;AAAA,QAClC,IAAA,EAAM,KAAK,MAAA,EAAO;AAAA,QAClB,KAAA,EAAO,KAAK,MAAA,EAAO;AAAA,QACnB,KAAA,EAAO,KAAK,MAAA,EAAO;AAAA,QACnB,UAAA,EAAY,KAAK,MAAA;AAAO,OAC3B,CAAC;AAAA,KACL,CAAC;AAAA,GACL,CAAA;AACL;AAKO,SAAS,cAAA,GAChB;AACI,EAAA,OAAO,KAAK,MAAA,CAAO;AAAA,IACf,OAAA,EAAS,IAAA,CAAK,OAAA,CAAQ,KAAK,CAAA;AAAA,IAC3B,KAAA,EAAO,KAAK,MAAA,CAAO;AAAA,MACf,OAAA,EAAS,KAAK,MAAA,EAAO;AAAA,MACrB,IAAA,EAAM,KAAK,MAAA,EAAO;AAAA,MAClB,UAAA,EAAY,KAAK,MAAA,EAAO;AAAA,MACxB,KAAA,EAAO,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,QAAQ,CAAA;AAAA,MAClC,OAAA,EAAS,IAAA,CAAK,QAAA,CAAS,IAAA,CAAK,KAAK;AAAA,KACpC;AAAA,GACJ,CAAA;AACL;AAoBO,SAAS,kBAAqC,UAAA,EACrD;AACI,EAAA,OAAO,iBAAiB,UAAU,CAAA;AACtC","file":"index.js","sourcesContent":["/**\n * Standard API Response Types & Schemas\n *\n * Pure TypeBox schemas and type definitions for API responses.\n * Can be used in both server and client code.\n */\n\nimport type { TSchema } from '@sinclair/typebox';\nimport { Type } from '@sinclair/typebox';\n\n// ============================================================================\n// Type Definitions\n// ============================================================================\n\n/**\n * Standard error response format\n *\n * Used by ErrorHandler middleware for all error responses.\n * Compatible with ApiResponse pattern for consistent API responses.\n */\nexport interface ErrorResponse\n{\n    success: false;\n    error: {\n        message: string;\n        type: string;\n        statusCode: number;\n        stack?: string;\n        details?: any;\n    };\n}\n\n/**\n * Success response wrapper\n */\nexport interface ApiSuccessResponse<T = any>\n{\n    success: true;\n    data: T;\n    meta?: {\n        timestamp?: string;\n        requestId?: string;\n        pagination?: {\n            page: number;\n            limit: number;\n            total: number;\n            totalPages: number;\n        };\n        [key: string]: any;\n    };\n}\n\n/**\n * Error response type (alias for ErrorResponse)\n */\nexport type ApiErrorResponse = ErrorResponse;\n\n/**\n * Unified API response type\n */\nexport type ApiResponse<T = any> = ApiSuccessResponse<T> | ApiErrorResponse;\n\n// ============================================================================\n// TypeBox Schema Helpers\n// ============================================================================\n\n/**\n * Creates a TypeBox schema for ApiSuccessResponse<T>\n *\n * @example\n * ```ts\n * const UserSchema = Type.Object({\n *   id: Type.String(),\n *   name: Type.String(),\n * });\n *\n * const contract = {\n *   response: ApiSuccessSchema(UserSchema),\n * };\n * ```\n */\nexport function ApiSuccessSchema<T extends TSchema>(dataSchema: T)\n{\n    return Type.Object({\n        success: Type.Literal(true),\n        data: dataSchema,\n        meta: Type.Optional(Type.Object({\n            timestamp: Type.Optional(Type.String()),\n            requestId: Type.Optional(Type.String()),\n            pagination: Type.Optional(Type.Object({\n                page: Type.Number(),\n                limit: Type.Number(),\n                total: Type.Number(),\n                totalPages: Type.Number(),\n            })),\n        })),\n    });\n}\n\n/**\n * Creates a TypeBox schema for ApiErrorResponse\n */\nexport function ApiErrorSchema()\n{\n    return Type.Object({\n        success: Type.Literal(false),\n        error: Type.Object({\n            message: Type.String(),\n            type: Type.String(),\n            statusCode: Type.Number(),\n            stack: Type.Optional(Type.String()),\n            details: Type.Optional(Type.Any()),\n        }),\n    });\n}\n\n/**\n * Creates a TypeBox schema for ApiSuccessResponse<T>\n *\n * Use this in your route contract's response field for standardized responses.\n * Note: ContractClient throws ApiClientError on failure, so only success type is needed.\n *\n * @example\n * ```ts\n * const contract = {\n *   method: 'GET',\n *   path: '/users/:id',\n *   response: ApiResponseSchema(Type.Object({\n *     id: Type.String(),\n *     name: Type.String(),\n *   })),\n * };\n * ```\n */\nexport function ApiResponseSchema<T extends TSchema>(dataSchema: T)\n{\n    return ApiSuccessSchema(dataSchema);\n}\n"]}

package/dist/types-BXibIEyj.d.ts

@@ -0,0 +1,60 @@
+import { Context } from 'hono';
+import { ContentfulStatusCode } from 'hono/utils/http-status';
+import { TSchema, Static } from '@sinclair/typebox';
+import { ApiSuccessResponse } from './types/index.js';
+
+/**
+ * File-based Routing System Type Definitions
+ */
+type HeaderRecord = Record<string, string | string[]>;
+type RouteMeta = {
+    public?: boolean;
+    skipMiddlewares?: string[];
+    tags?: string[];
+    description?: string;
+    deprecated?: boolean;
+};
+/**
+ * Route Contract: TypeBox-based type-safe route definition
+ *
+ * Defines the shape of request/response for a route endpoint
+ */
+type RouteContract = {
+    method: HttpMethod;
+    path: string;
+    params?: TSchema;
+    query?: TSchema;
+    body?: TSchema;
+    response: TSchema;
+    meta?: RouteMeta;
+};
+/**
+ * Infer types from RouteContract
+ *
+ * Extracts TypeScript types from TypeBox schemas
+ */
+type InferContract<TContract extends RouteContract> = {
+    params: TContract['params'] extends TSchema ? Static<TContract['params']> : Record<string, never>;
+    query: TContract['query'] extends TSchema ? Static<TContract['query']> : Record<string, never>;
+    body: TContract['body'] extends TSchema ? Static<TContract['body']> : Record<string, never>;
+    response: TContract['response'] extends TSchema ? Static<TContract['response']> : unknown;
+};
+/**
+ * RouteContext: Route Handler Dedicated Context
+ *
+ * Generic version with contract-based type inference
+ */
+type RouteContext<TContract extends RouteContract = any> = {
+    params: InferContract<TContract>['params'];
+    query: InferContract<TContract>['query'];
+    data(): Promise<InferContract<TContract>['body']>;
+    json(data: InferContract<TContract>['response'], status?: ContentfulStatusCode, headers?: HeaderRecord): Response;
+    success<T>(data: T, meta?: ApiSuccessResponse<T>['meta'], status?: number): Response;
+    paginated<T>(data: T[], page: number, limit: number, total: number): Response;
+    raw: Context;
+};
+type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+type RouteHandler<TContract extends RouteContract = any> = (c: RouteContext<TContract>) => Response | Promise<Response>;
+declare function isHttpMethod(value: unknown): value is HttpMethod;
+
+export { type HttpMethod as H, type InferContract as I, type RouteContext as R, type RouteContract as a, type RouteHandler as b, type HeaderRecord as c, type RouteMeta as d, isHttpMethod as i };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spfn/core",
-  "version": "0.1.0-alpha.81",
+  "version": "0.1.0-alpha.82",
   "description": "SPFN Framework Core - File-based routing, transactions, repository pattern",
   "type": "module",
   "main": "./dist/index.js",
@@ -41,6 +41,11 @@
       "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",
@@ -116,7 +121,7 @@
     "chalk": "^5.6.2",
     "chokidar": "^4.0.3",
     "dotenv": "^17.2.3",
-    "drizzle-orm": "^0.44.6",
+    "drizzle-orm": "^0.44.7",
     "drizzle-typebox": "^0.1.0",
     "hono": "^4.9.0",
     "jiti": "^2.6.1",
@@ -127,7 +132,8 @@
     "zod": "^4.1.11"
   },
   "optionalDependencies": {
-    "ioredis": "^5.4.1"
+    "ioredis": "^5.4.1",
+    "pino-pretty": "^11.0.0"
   },
   "devDependencies": {
     "@types/micromatch": "^4.0.9",

package/dist/error-handler-wjLL3v-a.d.ts

@@ -1,44 +0,0 @@
-import { Context } from 'hono';
-
-/**
- * Error Handler Middleware
- *
- * Generic middleware that converts errors with statusCode to HTTP responses
- */
-
-interface ErrorHandlerOptions {
-    /**
-     * Include stack trace in response
-     * @default process.env.NODE_ENV !== 'production'
-     */
-    includeStack?: boolean;
-    /**
-     * Enable error logging
-     * @default true
-     */
-    enableLogging?: boolean;
-}
-/**
- * Standard error response format
- *
- * Used by ErrorHandler middleware for all error responses.
- * Compatible with ApiResponse pattern for consistent API responses.
- */
-interface ErrorResponse {
-    success: false;
-    error: {
-        message: string;
-        type: string;
-        statusCode: number;
-        stack?: string;
-        details?: any;
-    };
-}
-/**
- * Error handler middleware
- *
- * Used in Hono's onError hook
- */
-declare function ErrorHandler(options?: ErrorHandlerOptions): (err: Error, c: Context) => Response | Promise<Response>;
-
-export { ErrorHandler as E, type ErrorHandlerOptions as a, type ErrorResponse as b };