@spfn/core 0.1.0-alpha.64 → 0.1.0-alpha.68

package/dist/{types-Bd8YsFSU.d.ts → types-CAON3Mmg.d.ts}

@@ -54,4 +54,4 @@ 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 HeaderRecord as H, type InferContract as I, type RouteContract as R, type RouteHandler as a, type RouteMeta as b, type RouteContext as c, type HttpMethod as d, isHttpMethod as i };
+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.64",
+  "version": "0.1.0-alpha.68",
   "description": "SPFN Framework Core - File-based routing, transactions, repository pattern",
   "type": "module",
   "main": "./dist/index.js",
@@ -31,6 +31,21 @@
       "import": "./dist/server/index.js",
       "require": "./dist/server/index.js"
     },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js",
+      "require": "./dist/errors/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/middleware/index.d.ts",
+      "import": "./dist/middleware/index.js",
+      "require": "./dist/middleware/index.js"
+    },
+    "./cache": {
+      "types": "./dist/cache/index.d.ts",
+      "import": "./dist/cache/index.js",
+      "require": "./dist/cache/index.js"
+    },
     "./codegen": {
       "types": "./dist/codegen/index.d.ts",
       "import": "./dist/codegen/index.js",
@@ -117,9 +132,10 @@
   "devDependencies": {
     "@types/micromatch": "^4.0.9",
     "@types/node": "^20.11.0",
+    "@vitest/coverage-v8": "^4.0.6",
     "drizzle-kit": "^0.31.5",
     "tsup": "^8.0.0",
-    "vitest": "^3.2.4"
+    "vitest": "^4.0.6"
   },
   "files": [
     "dist",
@@ -137,6 +153,7 @@
     "test": "vitest",
     "test:unit": "vitest --config vitest.unit.config.ts",
     "test:integration": "vitest --config vitest.integration.config.ts",
+    "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",

package/dist/bind-CSzshBtm.d.ts

@@ -1,17 +0,0 @@
-import { Context } from 'hono';
-import { R as RouteContract, c as RouteContext } from './types-Bd8YsFSU.js';
-
-/**
- * Contract-based Route Handler Wrapper
- *
- * Binds a contract to a route handler, providing automatic validation
- * and type-safe context creation.
- *
- * Features:
- * - Automatic params/query/body validation using TypeBox
- * - Type-safe RouteContext with contract-based inference
- * - Clean separation: bind() for validation, Hono for middleware
- */
-declare function bind<TContract extends RouteContract>(contract: TContract, handler: (c: RouteContext<TContract>) => Response | Promise<Response>): (rawContext: Context) => Promise<Response>;
-
-export { bind as b };

package/dist/contract-generator-CqKsfsNE.d.ts

@@ -1,52 +0,0 @@
-/**
- * Generator Interface
- *
- * Defines the contract for code generators that can be orchestrated by the codegen system.
- */
-interface GeneratorOptions {
-    /** Project root directory */
-    cwd: string;
-    /** Enable debug logging */
-    debug?: boolean;
-    /** Custom configuration options */
-    [key: string]: any;
-}
-interface Generator {
-    /** Unique generator name */
-    name: string;
-    /** File patterns to watch (glob patterns) */
-    watchPatterns: string[];
-    /**
-     * Generate code once
-     *
-     * @param options - Generator options
-     */
-    generate(options: GeneratorOptions): Promise<void>;
-    /**
-     * Handle individual file changes (optional)
-     *
-     * If not provided, the orchestrator will call generate() on any file change.
-     *
-     * @param filePath - Changed file path (relative to cwd)
-     * @param event - Type of file event
-     */
-    onFileChange?(filePath: string, event: 'add' | 'change' | 'unlink'): Promise<void>;
-}
-
-/**
- * Contract Generator
- *
- * Generates type-safe API client from contract definitions
- */
-
-interface ContractGeneratorConfig {
-    /** Routes directory (default: src/server/routes) */
-    routesDir?: string;
-    /** Output path (default: src/lib/api.ts) */
-    outputPath?: string;
-    /** Base URL for API client */
-    baseUrl?: string;
-}
-declare function createContractGenerator(config?: ContractGeneratorConfig): Generator;
-
-export { type ContractGeneratorConfig as C, type Generator as G, type GeneratorOptions as a, createContractGenerator as c };

package/dist/postgres-errors-lw1aRUFe.d.ts

@@ -1,397 +0,0 @@
-import * as drizzle_orm from 'drizzle-orm';
-import * as drizzle_orm_pg_core from 'drizzle-orm/pg-core';
-import { PgColumn } from 'drizzle-orm/pg-core';
-import { PostgresJsDatabase } from 'drizzle-orm/postgres-js';
-import * as hono from 'hono';
-
-/**
- * Drizzle Kit configuration generator
- * Automatically generates drizzle.config.ts from environment variables
- */
-interface DrizzleConfigOptions {
-    /** Database connection URL (defaults to process.env.DATABASE_URL) */
-    databaseUrl?: string;
-    /** Schema files glob pattern or array of patterns (defaults to './src/server/entities/\*\*\/*.ts') */
-    schema?: string | string[];
-    /** Migration output directory (defaults to './src/server/drizzle') */
-    out?: string;
-    /** Database dialect (auto-detected from URL if not provided) */
-    dialect?: 'postgresql' | 'mysql' | 'sqlite';
-    /** Current working directory for discovering package schemas */
-    cwd?: string;
-    /** Disable automatic package schema discovery */
-    disablePackageDiscovery?: boolean;
-    /** Only include schemas from specific package (e.g., '@spfn/cms') */
-    packageFilter?: string;
-}
-/**
- * Detect database dialect from connection URL
- */
-declare function detectDialect(url: string): 'postgresql' | 'mysql' | 'sqlite';
-/**
- * Generate Drizzle Kit configuration
- *
- * @param options - Configuration options
- * @returns Drizzle Kit configuration object
- *
- * @example
- * ```ts
- * // Zero-config (reads from process.env.DATABASE_URL)
- * const config = getDrizzleConfig();
- *
- * // Custom config
- * const config = getDrizzleConfig({
- *   databaseUrl: 'postgresql://localhost/mydb',
- *   schema: './src/db/schema/*.ts',
- *   out: './migrations',
- * });
- * ```
- */
-declare function getDrizzleConfig(options?: DrizzleConfigOptions): {
-    schema: string | string[];
-    out: string;
-    dialect: "postgresql" | "mysql" | "sqlite";
-    dbCredentials: {
-        url: string;
-    };
-};
-/**
- * Generate drizzle.config.ts file content
- *
- * @param options - Configuration options
- * @returns File content as string
- */
-declare function generateDrizzleConfigFile(options?: DrizzleConfigOptions): string;
-
-/**
- * Standard auto-incrementing primary key
- *
- * @returns bigserial primary key column
- *
- * @example
- * ```typescript
- * export const users = pgTable('users', {
- *     id: id(),
- *     // ...
- * });
- * ```
- */
-declare function id(): drizzle_orm.IsPrimaryKey<drizzle_orm.NotNull<drizzle_orm_pg_core.PgBigSerial53BuilderInitial<"id">>>;
-/**
- * Standard timestamp fields (createdAt, updatedAt)
- *
- * Both fields are timezone-aware, auto-set to current time on creation.
- * When autoUpdate is enabled, updatedAt will be automatically updated on record updates.
- *
- * @param options - Optional configuration
- * @param options.autoUpdate - Automatically update updatedAt on record updates (default: false)
- * @returns Object with createdAt and updatedAt columns
- *
- * @example
- * ```typescript
- * // Without auto-update
- * export const users = pgTable('users', {
- *     id: id(),
- *     email: text('email'),
- *     ...timestamps(),
- * });
- *
- * // With auto-update
- * export const posts = pgTable('posts', {
- *     id: id(),
- *     title: text('title'),
- *     ...timestamps({ autoUpdate: true }),
- * });
- * ```
- */
-declare function timestamps(options?: {
-    autoUpdate?: boolean;
-}): {
-    createdAt: drizzle_orm.NotNull<drizzle_orm.HasDefault<drizzle_orm_pg_core.PgTimestampBuilderInitial<"created_at">>>;
-    updatedAt: drizzle_orm.NotNull<drizzle_orm.HasDefault<drizzle_orm_pg_core.PgTimestampBuilderInitial<"updated_at">>>;
-};
-/**
- * Foreign key reference to another table
- *
- * Creates a bigserial column with cascade delete.
- * Type-safe: ensures the reference points to a valid PostgreSQL column.
- *
- * @param name - Column name (e.g., 'author' creates 'author_id')
- * @param reference - Reference to parent table column
- * @param options - Optional foreign key options
- *
- * @example
- * ```typescript
- * import { users } from './users';
- *
- * export const posts = pgTable('posts', {
- *     id: id(),
- *     authorId: foreignKey('author', () => users.id),
- *     ...timestamps(),
- * });
- * ```
- */
-declare function foreignKey<T extends PgColumn>(name: string, reference: () => T, options?: {
-    onDelete?: 'cascade' | 'set null' | 'restrict' | 'no action';
-}): drizzle_orm.NotNull<drizzle_orm_pg_core.PgBigSerial53BuilderInitial<`${string}_id`>>;
-/**
- * Optional foreign key reference (nullable)
- *
- * Type-safe: ensures the reference points to a valid PostgreSQL column.
- *
- * @param name - Column name (e.g., 'author' creates 'author_id')
- * @param reference - Reference to parent table column
- * @param options - Optional foreign key options
- *
- * @example
- * ```typescript
- * export const posts = pgTable('posts', {
- *     id: id(),
- *     authorId: optionalForeignKey('author', () => users.id),
- * });
- * ```
- */
-declare function optionalForeignKey<T extends PgColumn>(name: string, reference: () => T, options?: {
-    onDelete?: 'cascade' | 'set null' | 'restrict' | 'no action';
-}): drizzle_orm_pg_core.PgBigSerial53BuilderInitial<`${string}_id`>;
-
-/**
- * AsyncLocalStorage-based Transaction Context
- *
- * Uses Node.js AsyncLocalStorage to propagate transactions throughout the async call chain.
- *
- * Features:
- * - AsyncLocalStorage-based context management
- * - Type-safe transaction propagation across async chains
- * - Transaction ID tracking for debugging and tracing
- * - Nested transaction detection and logging
- * - Transaction nesting level tracking
- */
-
-/**
- * Transaction database type
- * Record<string, never> represents an empty schema; actual schema is determined at runtime
- */
-type TransactionDB = PostgresJsDatabase;
-/**
- * Transaction context stored in AsyncLocalStorage
- */
-type TransactionContext = {
-    /** The actual Drizzle transaction object */
-    tx: TransactionDB;
-    /** Unique transaction ID for logging and tracing */
-    txId: string;
-    level: number;
-};
-/**
- * Get current transaction from AsyncLocalStorage
- *
- * @returns Transaction if available, null otherwise
- */
-declare function getTransaction(): TransactionDB | null;
-/**
- * Run a function within a transaction context
- *
- * The transaction will be available to all async operations within the callback
- * via getTransaction().
- *
- * @param tx - Drizzle transaction object
- * @param txId - Unique ID for the transaction
- * @param callback - Function to run within transaction context
- * @returns Result of the callback
- */
-declare function runWithTransaction<T>(tx: TransactionDB, txId: string, // Add txId parameter
-callback: () => Promise<T>): Promise<T>;
-
-/**
- * Transaction middleware options
- */
-interface TransactionalOptions {
-    /**
-     * Slow transaction warning threshold in milliseconds
-     * @default 1000 (1 second)
-     */
-    slowThreshold?: number;
-    /**
-     * Enable transaction logging
-     * @default true
-     */
-    enableLogging?: boolean;
-    /**
-     * Transaction timeout in milliseconds
-     *
-     * If transaction exceeds this duration, it will be aborted with TransactionError.
-     *
-     * @default 30000 (30 seconds) or TRANSACTION_TIMEOUT environment variable
-     *
-     * @example
-     * ```typescript
-     * // Default timeout (30s or TRANSACTION_TIMEOUT env var)
-     * Transactional()
-     *
-     * // Custom timeout for specific route (60s)
-     * Transactional({ timeout: 60000 })
-     *
-     * // Disable timeout
-     * Transactional({ timeout: 0 })
-     * ```
-     */
-    timeout?: number;
-}
-/**
- * Transaction middleware for Hono routes
- *
- * Automatically wraps route handlers in a database transaction.
- * Commits on success, rolls back on error.
- *
- * @example
- * ```typescript
- * // In your route file
- * export const middlewares = [Transactional()];
- *
- * export async function POST(c: RouteContext) {
- *   // All DB operations run in a transaction
- *   const [user] = await db.insert(users).values(body).returning();
- *   await db.insert(profiles).values({ userId: user.id });
- *   // Auto-commits on success
- *   return c.json(user, 201);
- * }
- * ```
- *
- * @example
- * ```typescript
- * // With custom options
- * export const middlewares = [
- *   Transactional({
- *     slowThreshold: 2000,    // Warn if transaction takes > 2s
- *     enableLogging: false,   // Disable logging
- *     timeout: 60000,         // 60 second timeout for long operations
- *   })
- * ];
- * ```
- *
- * 🔄 Transaction behavior:
- * - Success: Auto-commit
- * - Error: Auto-rollback
- * - Detects context.error to trigger rollback
- *
- * 📊 Transaction logging:
- * - Auto-logs transaction start/commit/rollback
- * - Measures and records execution time
- * - Warns about slow transactions (default: > 1s)
- */
-declare function Transactional(options?: TransactionalOptions): hono.MiddlewareHandler<any, string, {}>;
-
-/**
- * Database Error Classes
- *
- * Type-safe error handling with custom error class hierarchy
- * Mapped to HTTP status codes for API responses
- */
-/**
- * Base Database Error
- *
- * Base class for all database-related errors
- */
-declare class DatabaseError<TDetails extends Record<string, unknown> = Record<string, unknown>> extends Error {
-    readonly statusCode: number;
-    readonly details?: TDetails;
-    readonly timestamp: Date;
-    constructor(message: string, statusCode?: number, details?: TDetails);
-    /**
-     * Serialize error for API response
-     */
-    toJSON(): {
-        name: string;
-        message: string;
-        statusCode: number;
-        details: TDetails | undefined;
-        timestamp: string;
-    };
-}
-/**
- * Connection Error (503 Service Unavailable)
- *
- * Database connection failure, connection pool exhaustion, etc.
- */
-declare class ConnectionError extends DatabaseError {
-    constructor(message: string, details?: Record<string, any>);
-}
-/**
- * Query Error (500 Internal Server Error)
- *
- * SQL query execution failure, syntax errors, etc.
- */
-declare class QueryError extends DatabaseError {
-    constructor(message: string, statusCode?: number, details?: Record<string, any>);
-}
-/**
- * Not Found Error (404 Not Found)
- *
- * Requested resource does not exist
- */
-declare class NotFoundError extends QueryError {
-    constructor(resource: string, id: string | number);
-}
-/**
- * Validation Error (400 Bad Request)
- *
- * Input data validation failure
- */
-declare class ValidationError extends QueryError {
-    constructor(message: string, details?: Record<string, any>);
-}
-/**
- * Transaction Error (500 Internal Server Error)
- *
- * Transaction start/commit/rollback failure
- */
-declare class TransactionError extends DatabaseError {
-    constructor(message: string, statusCode?: number, details?: Record<string, any>);
-}
-/**
- * Deadlock Error (409 Conflict)
- *
- * Database deadlock detected
- */
-declare class DeadlockError extends TransactionError {
-    constructor(message: string, details?: Record<string, any>);
-}
-/**
- * Duplicate Entry Error (409 Conflict)
- *
- * Unique constraint violation (e.g., duplicate email)
- */
-declare class DuplicateEntryError extends QueryError {
-    constructor(field: string, value: string | number);
-}
-
-/**
- * PostgreSQL Error Conversion Utilities
- *
- * Converts PostgreSQL-specific error codes to custom error types
- * @see https://www.postgresql.org/docs/current/errcodes-appendix.html
- */
-
-/**
- * Convert PostgreSQL error to custom DatabaseError
- *
- * Maps PostgreSQL error codes to appropriate error classes with correct status codes
- *
- * @param error - PostgreSQL error object (from pg driver or Drizzle)
- * @returns Custom DatabaseError instance
- *
- * @example
- * ```typescript
- * import { fromPostgresError } from '@spfn/core/db';
- *
- * try {
- *   await db.insert(users).values(data);
- * } catch (pgError) {
- *   throw fromPostgresError(pgError);
- * }
- * ```
- */
-declare function fromPostgresError(error: any): DatabaseError;
-
-export { ConnectionError as C, DatabaseError as D, NotFoundError as N, QueryError as Q, Transactional as T, ValidationError as V, generateDrizzleConfigFile as a, fromPostgresError as b, type DrizzleConfigOptions as c, detectDialect as d, getTransaction as e, foreignKey as f, getDrizzleConfig as g, type TransactionContext as h, id as i, type TransactionalOptions as j, TransactionError as k, DeadlockError as l, DuplicateEntryError as m, type TransactionDB as n, optionalForeignKey as o, runWithTransaction as r, timestamps as t };