@veloxts/client 0.1.0

package/dist/errors.js

@@ -0,0 +1,250 @@
+/**
+ * Client-side error handling
+ *
+ * Provides error classes that mirror the server-side VeloxError structure,
+ * with additional context about the failed request.
+ *
+ * @module errors
+ */
+// ============================================================================
+// Client Error Classes
+// ============================================================================
+/**
+ * Base error class for all client errors
+ *
+ * Represents an error that occurred during an API request, including
+ * both network errors and server-returned error responses.
+ */
+export class VeloxClientError extends Error {
+    statusCode;
+    code;
+    body;
+    url;
+    method;
+    constructor(message, options) {
+        super(message);
+        this.name = 'VeloxClientError';
+        this.statusCode = options.statusCode;
+        this.code = options.code;
+        this.body = options.body;
+        this.url = options.url;
+        this.method = options.method;
+        // Maintains proper stack trace for where error was thrown (V8 only)
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, VeloxClientError);
+        }
+    }
+}
+/**
+ * Network error when request fails to reach server
+ *
+ * Thrown when the request cannot be completed due to network issues,
+ * CORS problems, or other transport-level failures.
+ */
+export class NetworkError extends VeloxClientError {
+    cause;
+    constructor(message, options) {
+        super(message, {
+            url: options.url,
+            method: options.method,
+        });
+        this.name = 'NetworkError';
+        this.cause = options.cause;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, NetworkError);
+        }
+    }
+}
+/**
+ * Validation error from server (400 status)
+ *
+ * Thrown when request data fails server-side validation.
+ * Includes field-level error details if provided by server.
+ */
+export class ClientValidationError extends VeloxClientError {
+    fields;
+    constructor(message, options) {
+        super(message, {
+            statusCode: 400,
+            code: 'VALIDATION_ERROR',
+            url: options.url,
+            method: options.method,
+            body: options.body,
+        });
+        this.name = 'ClientValidationError';
+        this.fields = options.fields;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ClientValidationError);
+        }
+    }
+}
+/**
+ * Not found error from server (404 status)
+ *
+ * Thrown when a requested resource doesn't exist.
+ */
+export class ClientNotFoundError extends VeloxClientError {
+    resource;
+    resourceId;
+    constructor(message, options) {
+        super(message, {
+            statusCode: 404,
+            code: 'NOT_FOUND',
+            url: options.url,
+            method: options.method,
+            body: options.body,
+        });
+        this.name = 'ClientNotFoundError';
+        this.resource = options.resource;
+        this.resourceId = options.resourceId;
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ClientNotFoundError);
+        }
+    }
+}
+/**
+ * Server error (5xx status)
+ *
+ * Thrown when server returns an internal error.
+ */
+export class ServerError extends VeloxClientError {
+    constructor(message, options) {
+        super(message, options);
+        this.name = 'ServerError';
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, ServerError);
+        }
+    }
+}
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard for VeloxClientError
+ */
+export function isVeloxClientError(error) {
+    return error instanceof VeloxClientError;
+}
+/**
+ * Type guard for NetworkError
+ */
+export function isNetworkError(error) {
+    return error instanceof NetworkError;
+}
+/**
+ * Type guard for ClientValidationError
+ */
+export function isClientValidationError(error) {
+    return error instanceof ClientValidationError;
+}
+/**
+ * Type guard for ClientNotFoundError
+ */
+export function isClientNotFoundError(error) {
+    return error instanceof ClientNotFoundError;
+}
+/**
+ * Type guard for ServerError
+ */
+export function isServerError(error) {
+    return error instanceof ServerError;
+}
+/**
+ * Type guard for validation error response
+ */
+export function isValidationErrorResponse(response) {
+    return response.error === 'ValidationError';
+}
+/**
+ * Type guard for not found error response
+ */
+export function isNotFoundErrorResponse(response) {
+    return response.error === 'NotFoundError';
+}
+// ============================================================================
+// Error Parsing
+// ============================================================================
+/**
+ * Parses an error response from the server and creates appropriate error instance
+ *
+ * @internal
+ */
+export function parseErrorResponse(response, body, url, method) {
+    // Try to parse as ErrorResponse
+    if (isErrorResponseLike(body)) {
+        const errorResponse = body;
+        // Validation error
+        if (isValidationErrorResponse(errorResponse)) {
+            return new ClientValidationError(errorResponse.message, {
+                url,
+                method,
+                fields: errorResponse.fields,
+                body,
+            });
+        }
+        // Not found error
+        if (isNotFoundErrorResponse(errorResponse)) {
+            return new ClientNotFoundError(errorResponse.message, {
+                url,
+                method,
+                resource: errorResponse.resource,
+                resourceId: errorResponse.resourceId,
+                body,
+            });
+        }
+        // Server error (5xx)
+        if (response.status >= 500) {
+            return new ServerError(errorResponse.message, {
+                statusCode: errorResponse.statusCode,
+                code: errorResponse.code,
+                url,
+                method,
+                body,
+            });
+        }
+        // Generic error
+        return new VeloxClientError(errorResponse.message, {
+            statusCode: errorResponse.statusCode,
+            code: errorResponse.code,
+            url,
+            method,
+            body,
+        });
+    }
+    // Fallback for non-standard error responses
+    const message = typeof body === 'object' &&
+        body !== null &&
+        'message' in body &&
+        typeof body.message === 'string'
+        ? body.message
+        : `Request failed with status ${response.status}`;
+    if (response.status >= 500) {
+        return new ServerError(message, {
+            statusCode: response.status,
+            url,
+            method,
+            body,
+        });
+    }
+    return new VeloxClientError(message, {
+        statusCode: response.status,
+        url,
+        method,
+        body,
+    });
+}
+/**
+ * Type guard to check if body looks like an error response
+ *
+ * @internal
+ */
+function isErrorResponseLike(body) {
+    if (typeof body !== 'object' || body === null) {
+        return false;
+    }
+    const obj = body;
+    return (typeof obj.error === 'string' &&
+        typeof obj.message === 'string' &&
+        typeof obj.statusCode === 'number');
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,29 @@
+/**
+ * @veloxts/client - Type-safe API client for frontend applications
+ *
+ * Provides a fully typed client for consuming VeloxTS APIs from frontend code.
+ * Types are inferred directly from backend procedure definitions without code generation.
+ *
+ * @example
+ * ```typescript
+ * // Import procedure types from backend
+ * import type { userProcedures } from '../server/procedures';
+ *
+ * // Create client with full type safety
+ * const api = createClient<{ users: typeof userProcedures }>({
+ *   baseUrl: '/api'
+ * });
+ *
+ * // Fully typed API calls
+ * const user = await api.users.getUser({ id: '123' });
+ * ```
+ *
+ * @module @veloxts/client
+ */
+export { createClient } from './client.js';
+export type { ClientConfig, ClientError, ClientFromCollection, ClientFromRouter, ClientProcedure, HttpMethod, InferProcedureInput, InferProcedureOutput, ProcedureCall, ProcedureCollection, ProcedureRecord, } from './types.js';
+export { ClientNotFoundError, ClientValidationError, NetworkError, ServerError, VeloxClientError, } from './errors.js';
+export { isClientNotFoundError, isClientValidationError, isNetworkError, isNotFoundErrorResponse, isServerError, isValidationErrorResponse, isVeloxClientError, } from './errors.js';
+export type { ErrorResponse } from './errors.js';
+export declare const CLIENT_VERSION = "0.1.0";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAMH,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAO3C,YAAY,EACV,YAAY,EACZ,WAAW,EACX,oBAAoB,EACpB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,mBAAmB,EACnB,oBAAoB,EACpB,aAAa,EACb,mBAAmB,EACnB,eAAe,GAChB,MAAM,YAAY,CAAC;AAMpB,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAMrB,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAMrB,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAMjD,eAAO,MAAM,cAAc,UAAU,CAAC"}

package/dist/index.js

@@ -0,0 +1,39 @@
+/**
+ * @veloxts/client - Type-safe API client for frontend applications
+ *
+ * Provides a fully typed client for consuming VeloxTS APIs from frontend code.
+ * Types are inferred directly from backend procedure definitions without code generation.
+ *
+ * @example
+ * ```typescript
+ * // Import procedure types from backend
+ * import type { userProcedures } from '../server/procedures';
+ *
+ * // Create client with full type safety
+ * const api = createClient<{ users: typeof userProcedures }>({
+ *   baseUrl: '/api'
+ * });
+ *
+ * // Fully typed API calls
+ * const user = await api.users.getUser({ id: '123' });
+ * ```
+ *
+ * @module @veloxts/client
+ */
+// ============================================================================
+// Core Client
+// ============================================================================
+export { createClient } from './client.js';
+// ============================================================================
+// Error Classes
+// ============================================================================
+export { ClientNotFoundError, ClientValidationError, NetworkError, ServerError, VeloxClientError, } from './errors.js';
+// ============================================================================
+// Type Guards
+// ============================================================================
+export { isClientNotFoundError, isClientValidationError, isNetworkError, isNotFoundErrorResponse, isServerError, isValidationErrorResponse, isVeloxClientError, } from './errors.js';
+// ============================================================================
+// Version
+// ============================================================================
+export const CLIENT_VERSION = '0.1.0';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAqB3C,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E,OAAO,EACL,mBAAmB,EACnB,qBAAqB,EACrB,YAAY,EACZ,WAAW,EACX,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E,OAAO,EACL,qBAAqB,EACrB,uBAAuB,EACvB,cAAc,EACd,uBAAuB,EACvB,aAAa,EACb,yBAAyB,EACzB,kBAAkB,GACnB,MAAM,aAAa,CAAC;AAQrB,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,173 @@
+/**
+ * Type inference utilities for the VeloxTS client
+ *
+ * Provides type extraction from backend procedure collections to enable
+ * full-stack type safety without code generation.
+ *
+ * @module types
+ */
+/**
+ * Procedure operation type (matches @veloxts/router)
+ */
+export type ProcedureType = 'query' | 'mutation';
+/**
+ * Minimal interface representing a compiled procedure
+ *
+ * This interface is designed to be structurally compatible with @veloxts/router's
+ * CompiledProcedure type, enabling type inference without requiring a direct
+ * package dependency. The client only needs the schema types for inference.
+ *
+ * @template TInput - The validated input type
+ * @template TOutput - The handler output type
+ *
+ * @see {@link https://github.com/veloxts/velox-ts-framework/velox | @veloxts/router CompiledProcedure}
+ */
+export interface ClientProcedure<TInput = unknown, TOutput = unknown> {
+    /** Whether this is a query or mutation */
+    readonly type: ProcedureType;
+    /** The procedure handler function */
+    readonly handler: (args: {
+        input: TInput;
+        ctx: unknown;
+    }) => TOutput | Promise<TOutput>;
+    /** Input validation schema (if specified) */
+    readonly inputSchema?: {
+        parse: (input: unknown) => TInput;
+    };
+    /** Output validation schema (if specified) */
+    readonly outputSchema?: {
+        parse: (output: unknown) => TOutput;
+    };
+    /** Middleware chain (not used by client, but part of CompiledProcedure) */
+    readonly middlewares?: ReadonlyArray<unknown>;
+    /** REST route override (not used by client, but part of CompiledProcedure) */
+    readonly restOverride?: {
+        method?: string;
+        path?: string;
+    };
+}
+/**
+ * Record of named procedures
+ *
+ * NOTE: Uses `any` for variance compatibility with @veloxts/router's ProcedureRecord
+ */
+export type ProcedureRecord = Record<string, ClientProcedure<any, any>>;
+/**
+ * Procedure collection with namespace
+ *
+ * Matches the structure of @veloxts/router's ProcedureCollection
+ */
+export interface ProcedureCollection<TProcedures extends ProcedureRecord = ProcedureRecord> {
+    /** Resource namespace (e.g., 'users', 'posts') */
+    readonly namespace: string;
+    /** Named procedures in this collection */
+    readonly procedures: TProcedures;
+}
+/**
+ * Extracts the input type from a procedure
+ *
+ * Works with both ClientProcedure and @veloxts/router's CompiledProcedure
+ */
+export type InferProcedureInput<T> = T extends ClientProcedure<infer I, unknown> ? I : never;
+/**
+ * Extracts the output type from a procedure
+ *
+ * Works with both ClientProcedure and @veloxts/router's CompiledProcedure
+ */
+export type InferProcedureOutput<T> = T extends ClientProcedure<unknown, infer O> ? O : never;
+/**
+ * Builds a callable client interface from a single procedure collection
+ *
+ * For each procedure, creates a method that:
+ * - Takes the procedure's input type as parameter
+ * - Returns a Promise of the procedure's output type
+ */
+export type ClientFromCollection<TCollection extends ProcedureCollection> = {
+    [K in keyof TCollection['procedures']]: (input: InferProcedureInput<TCollection['procedures'][K]>) => Promise<InferProcedureOutput<TCollection['procedures'][K]>>;
+};
+/**
+ * Builds a complete client interface from a router (collection of collections)
+ *
+ * For each collection namespace, creates a property with all callable procedures.
+ *
+ * @example
+ * ```typescript
+ * // Backend defines:
+ * const userProcedures = defineProcedures('users', {
+ *   getUser: procedure().input(...).output(...).query(...),
+ *   createUser: procedure().input(...).output(...).mutation(...),
+ * });
+ *
+ * // Frontend gets:
+ * type Client = ClientFromRouter<{ users: typeof userProcedures }>;
+ * // Client = {
+ * //   users: {
+ * //     getUser: (input: { id: string }) => Promise<User>;
+ * //     createUser: (input: CreateUserInput) => Promise<User>;
+ * //   }
+ * // }
+ * ```
+ */
+export type ClientFromRouter<TRouter> = {
+    [K in keyof TRouter]: TRouter[K] extends ProcedureCollection ? ClientFromCollection<TRouter[K]> : never;
+};
+/**
+ * Configuration for creating a client instance
+ */
+export interface ClientConfig {
+    /** Base URL for API requests (e.g., 'https://api.example.com' or '/api') */
+    baseUrl: string;
+    /** Optional custom headers to include in all requests */
+    headers?: Record<string, string>;
+    /**
+     * Optional request interceptor
+     * Called before each request is sent
+     */
+    onRequest?: (url: string, options: RequestInit) => void | Promise<void>;
+    /**
+     * Optional response interceptor
+     * Called after each successful response
+     */
+    onResponse?: (response: Response) => void | Promise<void>;
+    /**
+     * Optional error interceptor
+     * Called when a request fails or returns an error response
+     */
+    onError?: (error: ClientError) => void | Promise<void>;
+    /**
+     * Optional custom fetch implementation
+     * Defaults to global fetch
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Client error with full context about the failed request
+ */
+export interface ClientError extends Error {
+    /** HTTP status code (if available) */
+    statusCode?: number;
+    /** Error code from server (if available) */
+    code?: string;
+    /** Original response body (if available) */
+    body?: unknown;
+    /** URL that was requested */
+    url: string;
+    /** HTTP method used */
+    method: string;
+}
+/**
+ * Internal representation of a procedure call
+ */
+export interface ProcedureCall {
+    /** Namespace (e.g., 'users') */
+    namespace: string;
+    /** Procedure name (e.g., 'getUser') */
+    procedureName: string;
+    /** Input data */
+    input: unknown;
+}
+/**
+ * HTTP method inferred from procedure name
+ */
+export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js

@@ -0,0 +1,10 @@
+/**
+ * Type inference utilities for the VeloxTS client
+ *
+ * Provides type extraction from backend procedure collections to enable
+ * full-stack type safety without code generation.
+ *
+ * @module types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@veloxts/client",
+  "version": "0.1.0",
+  "description": "Type-safe frontend API client for VeloxTS framework",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "dependencies": {},
+  "devDependencies": {
+    "typescript": "5.9.3",
+    "vitest": "4.0.15"
+  },
+  "keywords": [
+    "velox",
+    "client",
+    "api",
+    "fetch",
+    "typescript"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/veloxts/velox-ts-framework",
+    "directory": "packages/client"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo"
+  }
+}