veloce-ts 0.1.0

package/dist/types/validation/index.d.ts

@@ -0,0 +1,3 @@
+export { ValidationEngine } from './validator.js';
+export { ValidationException } from './exceptions.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/validation/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/types/validation/validator.d.ts

@@ -0,0 +1,54 @@
+import { ZodSchema } from 'zod';
+/**
+ * ValidationEngine handles validation of data against Zod schemas
+ * with built-in caching for performance optimization
+ *
+ * Performance optimizations:
+ * - WeakMap-based schema caching to reuse parsed schemas
+ * - Optional result caching for identical input objects
+ * - Efficient error handling with minimal overhead
+ */
+export declare class ValidationEngine {
+    private schemaCache;
+    private stats;
+    /**
+     * Validates data asynchronously against a Zod schema
+     * Uses cached schema for improved performance on repeated validations
+     *
+     * @param data - The data to validate
+     * @param schema - The Zod schema to validate against
+     * @returns The validated and typed data
+     * @throws ValidationException if validation fails
+     */
+    validate<T>(data: unknown, schema: ZodSchema<T>): Promise<T>;
+    /**
+     * Validates data synchronously against a Zod schema
+     * Uses cached schema for improved performance on repeated validations
+     *
+     * @param data - The data to validate
+     * @param schema - The Zod schema to validate against
+     * @returns The validated and typed data
+     * @throws ValidationException if validation fails
+     */
+    validateSync<T>(data: unknown, schema: ZodSchema<T>): T;
+    /**
+     * Get cache statistics (useful for monitoring and debugging)
+     * Returns hit rate and total validations performed
+     */
+    getCacheStats(): {
+        hits: number;
+        misses: number;
+        validations: number;
+        hitRate: number;
+    };
+    /**
+     * Reset cache statistics (useful for testing)
+     */
+    resetStats(): void;
+    /**
+     * Clear the schema cache (useful for testing or memory management)
+     * Note: WeakMap doesn't have a clear method, so we create a new instance
+     */
+    clearCache(): void;
+}
+//# sourceMappingURL=validator.d.ts.map

package/dist/types/validation/validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validator.d.ts","sourceRoot":"","sources":["../../../src/validation/validator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAY,MAAM,KAAK,CAAC;AAa1C;;;;;;;;GAQG;AACH,qBAAa,gBAAgB;IAE3B,OAAO,CAAC,WAAW,CAAmD;IAGtE,OAAO,CAAC,KAAK,CAIX;IAEF;;;;;;;;OAQG;IACG,QAAQ,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA6BlE;;;;;;;;OAQG;IACH,YAAY,CAAC,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,GAAG,CAAC;IA6BvD;;;OAGG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAWvF;;OAEG;IACH,UAAU,IAAI,IAAI;IAQlB;;;OAGG;IACH,UAAU,IAAI,IAAI;CAInB"}

package/dist/types/websocket/connection.d.ts

@@ -0,0 +1,51 @@
+import type { WebSocketManager } from './manager';
+/**
+ * WebSocketConnection wraps a native WebSocket with helper methods
+ * for sending messages, broadcasting, and managing rooms
+ */
+export declare class WebSocketConnection {
+    private manager;
+    readonly id: string;
+    private _ws;
+    constructor(ws: WebSocket, manager: WebSocketManager, id?: string);
+    /**
+     * Send a message to this specific connection
+     * @param data - Data to send (will be JSON stringified)
+     */
+    send(data: any): void;
+    /**
+     * Broadcast a message to all connections in a room (or all connections if no room specified)
+     * @param data - Data to broadcast
+     * @param room - Optional room name to broadcast to
+     */
+    broadcast(data: any, room?: string): void;
+    /**
+     * Join a room
+     * @param room - Room name to join
+     */
+    join(room: string): void;
+    /**
+     * Leave a room
+     * @param room - Room name to leave
+     */
+    leave(room: string): void;
+    /**
+     * Close the WebSocket connection
+     * @param code - Optional close code
+     * @param reason - Optional close reason
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * Get the native WebSocket instance
+     */
+    get native(): WebSocket | null;
+    /**
+     * Check if the connection is open
+     */
+    get isOpen(): boolean;
+    /**
+     * Internal method to mark connection as closed
+     */
+    _markClosed(): void;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/types/websocket/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../../src/websocket/connection.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAElD;;;GAGG;AACH,qBAAa,mBAAmB;IAM5B,OAAO,CAAC,OAAO;IALjB,SAAgB,EAAE,EAAE,MAAM,CAAC;IAC3B,OAAO,CAAC,GAAG,CAAmB;gBAG5B,EAAE,EAAE,SAAS,EACL,OAAO,EAAE,gBAAgB,EACjC,EAAE,CAAC,EAAE,MAAM;IAMb;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,GAAG,GAAG,IAAI;IASrB;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAIzC;;;OAGG;IACH,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAIzB;;;;OAIG;IACH,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI;IAM3C;;OAEG;IACH,IAAI,MAAM,IAAI,SAAS,GAAG,IAAI,CAE7B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,OAAO,CAEpB;IAED;;OAEG;IACH,WAAW,IAAI,IAAI;CAGpB"}

package/dist/types/websocket/index.d.ts

@@ -0,0 +1,4 @@
+export { WebSocketConnection } from './connection';
+export { WebSocketManager } from './manager';
+export { WebSocketPlugin } from './plugin';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/websocket/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/websocket/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC"}

package/dist/types/websocket/manager.d.ts

@@ -0,0 +1,82 @@
+import type { WebSocketMetadata } from '../types';
+import { WebSocketConnection } from './connection';
+/**
+ * WebSocketManager handles WebSocket connection lifecycle,
+ * connection tracking, and room-based broadcasting
+ */
+export declare class WebSocketManager {
+    private connections;
+    private rooms;
+    private connectionsByRoom;
+    /**
+     * Register a new WebSocket connection
+     * @param ws - Native WebSocket instance
+     * @param metadata - WebSocket route metadata
+     * @returns The created WebSocketConnection
+     */
+    handleConnection(ws: WebSocket, metadata: WebSocketMetadata): WebSocketConnection;
+    /**
+     * Handle incoming WebSocket message
+     */
+    private handleMessage;
+    /**
+     * Handle WebSocket disconnection
+     */
+    private handleDisconnect;
+    /**
+     * Execute a handler method on the target class
+     */
+    private executeHandler;
+    /**
+     * Broadcast a message to all connections or connections in a specific room
+     * @param message - Message to broadcast
+     * @param room - Optional room name
+     */
+    broadcast(message: any, room?: string): void;
+    /**
+     * Add a connection to a room
+     * @param connectionId - Connection ID
+     * @param room - Room name
+     */
+    joinRoom(connectionId: string, room: string): void;
+    /**
+     * Remove a connection from a room
+     * @param connectionId - Connection ID
+     * @param room - Room name
+     */
+    leaveRoom(connectionId: string, room: string): void;
+    /**
+     * Get all connections in a specific room
+     * @param room - Room name
+     * @returns Array of connections in the room
+     */
+    private getConnectionsInRoom;
+    /**
+     * Get a connection by ID
+     * @param connectionId - Connection ID
+     * @returns The connection or undefined
+     */
+    getConnection(connectionId: string): WebSocketConnection | undefined;
+    /**
+     * Get all active connections
+     * @returns Array of all connections
+     */
+    getAllConnections(): WebSocketConnection[];
+    /**
+     * Get the number of active connections
+     * @returns Number of connections
+     */
+    getConnectionCount(): number;
+    /**
+     * Get all room names
+     * @returns Array of room names
+     */
+    getRooms(): string[];
+    /**
+     * Get the number of connections in a room
+     * @param room - Room name
+     * @returns Number of connections in the room
+     */
+    getRoomSize(room: string): number;
+}
+//# sourceMappingURL=manager.d.ts.map

package/dist/types/websocket/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../../src/websocket/manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAS,MAAM,UAAU,CAAC;AACzD,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AAEnD;;;GAGG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,WAAW,CAA+C;IAClE,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,iBAAiB,CAAoD;IAE7E;;;;;OAKG;IACH,gBAAgB,CAAC,EAAE,EAAE,SAAS,EAAE,QAAQ,EAAE,iBAAiB,GAAG,mBAAmB;IA2BjF;;OAEG;YACW,aAAa;IA+B3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IA2BxB;;OAEG;YACW,cAAc;IAsB5B;;;;OAIG;IACH,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAc5C;;;;OAIG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAmBlD;;;;OAIG;IACH,SAAS,CAAC,YAAY,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAyBnD;;;;OAIG;IACH,OAAO,CAAC,oBAAoB;IAK5B;;;;OAIG;IACH,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,mBAAmB,GAAG,SAAS;IAIpE;;;OAGG;IACH,iBAAiB,IAAI,mBAAmB,EAAE;IAI1C;;;OAGG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;;OAGG;IACH,QAAQ,IAAI,MAAM,EAAE;IAIpB;;;;OAIG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAGlC"}

package/dist/types/websocket/plugin.d.ts

@@ -0,0 +1,51 @@
+import type { Plugin } from '../core/plugin';
+import type { VeloceTS } from '../core/application';
+import { WebSocketManager } from './manager';
+/**
+ * WebSocketPlugin adds WebSocket support to FastAPI-TS
+ * Registers WebSocket routes and handles connection upgrades
+ */
+export declare class WebSocketPlugin implements Plugin {
+    name: string;
+    version: string;
+    private manager;
+    constructor();
+    install(app: VeloceTS): Promise<void>;
+    /**
+     * Register a WebSocket route with the application
+     */
+    private registerWebSocket;
+    /**
+     * Handle WebSocket upgrade for different runtimes
+     */
+    private handleUpgrade;
+    /**
+     * Handle WebSocket upgrade for Bun runtime
+     */
+    private handleBunUpgrade;
+    /**
+     * Handle WebSocket upgrade for Deno runtime
+     */
+    private handleDenoUpgrade;
+    /**
+     * Handle WebSocket upgrade for Node.js runtime
+     */
+    private handleNodeUpgrade;
+    /**
+     * Get the WebSocket manager instance
+     */
+    getManager(): WebSocketManager;
+    /**
+     * Broadcast a message to all connections or a specific room
+     */
+    broadcast(message: any, room?: string): void;
+    /**
+     * Get connection count
+     */
+    getConnectionCount(): number;
+    /**
+     * Get all active rooms
+     */
+    getRooms(): string[];
+}
+//# sourceMappingURL=plugin.d.ts.map

package/dist/types/websocket/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../../../src/websocket/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAE7C;;;GAGG;AACH,qBAAa,eAAgB,YAAW,MAAM;IAC5C,IAAI,SAAe;IACnB,OAAO,SAAW;IAElB,OAAO,CAAC,OAAO,CAAmB;;IAM5B,OAAO,CAAC,GAAG,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAU3C;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;IACH,OAAO,CAAC,aAAa;IAYrB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAUxB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAYzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAMzB;;OAEG;IACH,UAAU,IAAI,gBAAgB;IAI9B;;OAEG;IACH,SAAS,CAAC,OAAO,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI;IAI5C;;OAEG;IACH,kBAAkB,IAAI,MAAM;IAI5B;;OAEG;IACH,QAAQ,IAAI,MAAM,EAAE;CAGrB"}

package/package.json

@@ -0,0 +1,149 @@
+{
+  "name": "veloce-ts",
+  "version": "0.1.0",
+  "description": "A modern, fast web framework for TypeScript inspired by FastAPI",
+  "type": "module",
+  "main": "./dist/cjs/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "bin": {
+    "veloce-ts": "./bin/veloce.ts",
+    "veloce": "./bin/veloce.ts"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js",
+      "require": "./dist/cjs/index.js",
+      "default": "./dist/esm/index.js"
+    },
+    "./validation": {
+      "types": "./dist/types/validation/index.d.ts",
+      "import": "./dist/esm/validation/index.js",
+      "require": "./dist/cjs/validation/index.js"
+    },
+    "./middleware": {
+      "types": "./dist/types/middleware/index.d.ts",
+      "import": "./dist/esm/middleware/index.js",
+      "require": "./dist/cjs/middleware/index.js"
+    },
+    "./testing": {
+      "types": "./dist/types/testing/index.d.ts",
+      "import": "./dist/esm/testing/index.js",
+      "require": "./dist/cjs/testing/index.js"
+    },
+    "./errors": {
+      "types": "./dist/types/errors/index.d.ts",
+      "import": "./dist/esm/errors/index.js",
+      "require": "./dist/cjs/errors/index.js"
+    },
+    "./types": {
+      "types": "./dist/types/types/index.d.ts",
+      "import": "./dist/esm/types/index.js",
+      "require": "./dist/cjs/types/index.js"
+    },
+    "./docs": {
+      "types": "./dist/types/docs/index.d.ts",
+      "import": "./dist/esm/docs/index.js",
+      "require": "./dist/cjs/docs/index.js"
+    },
+    "./graphql": {
+      "types": "./dist/types/graphql/index.d.ts",
+      "import": "./dist/esm/graphql/index.js",
+      "require": "./dist/cjs/graphql/index.js"
+    },
+    "./websocket": {
+      "types": "./dist/types/websocket/index.d.ts",
+      "import": "./dist/esm/websocket/index.js",
+      "require": "./dist/cjs/websocket/index.js"
+    },
+    "./plugins": {
+      "types": "./dist/types/plugins/index.d.ts",
+      "import": "./dist/esm/plugins/index.js",
+      "require": "./dist/cjs/plugins/index.js"
+    },
+    "./cli": {
+      "types": "./dist/types/cli/index.d.ts",
+      "import": "./dist/esm/cli/index.js",
+      "require": "./dist/cjs/cli/index.js"
+    },
+    "./adapters/*": {
+      "types": "./dist/types/adapters/*.d.ts",
+      "import": "./dist/esm/adapters/*.js",
+      "require": "./dist/cjs/adapters/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "scripts": {
+    "build": "bun run build.ts",
+    "build:prod": "bun run build.ts --production",
+    "build:types": "tsc --project tsconfig.build.json",
+    "dev": "bun --watch src/index.ts",
+    "test": "bun test",
+    "test:watch": "bun test --watch",
+    "test:coverage": "bun test --coverage",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "bun run build:prod",
+    "prepack": "bun run build:prod",
+    "release:major": "bun run scripts/release.ts major",
+    "release:minor": "bun run scripts/release.ts minor",
+    "release:patch": "bun run scripts/release.ts patch",
+    "test:package": "bun run scripts/test-package.ts"
+  },
+  "keywords": [
+    "veloce-ts",
+    "veloce",
+    "fastapi",
+    "typescript",
+    "web-framework",
+    "hono",
+    "zod",
+    "decorators",
+    "validation",
+    "openapi",
+    "fast",
+    "modern",
+    "fastapi-typescript"
+  ],
+  "author": "Alfredo Mejia <mejia_alfredo@outlook.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/AlfredoMejia3001/veloce-ts.git"
+  },
+  "bugs": {
+    "url": "https://github.com/AlfredoMejia3001/veloce-ts/issues"
+  },
+  "homepage": "https://github.com/AlfredoMejia3001/veloce-ts#readme",
+  "files": [
+    "dist/esm",
+    "dist/cjs",
+    "dist/types",
+    "bin",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "engines": {
+    "node": ">=18.0.0",
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "commander": "^14.0.1",
+    "hono": "^4.0.0",
+    "reflect-metadata": "^0.2.0",
+    "zod": "^3.22.0",
+    "zod-to-json-schema": "^3.24.6"
+  },
+  "devDependencies": {
+    "@types/bun": "latest",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "typescript": ">=5.0.0"
+  }
+}