@zap-js/client 0.0.9 → 0.1.1

package/dist/cli/commands/build.js

@@ -2,7 +2,7 @@ import { execSync } from 'child_process';
 import { join, resolve } from 'path';
 import { existsSync, mkdirSync, copyFileSync, readdirSync, statSync, rmSync, writeFileSync } from 'fs';
 import { cliLogger } from '../utils/logger.js';
-import { resolveBinary } from '../utils/binary-resolver.js';
+import { resolveBinary, getPlatformIdentifier } from '../utils/binary-resolver.js';
 /**
  * Build for production
  */
@@ -61,7 +61,37 @@ export async function buildCommand(options) {
     }
 }
 async function buildRust(outputDir, options) {
-    cliLogger.spinner('rust', 'Building Rust backend (release mode)...');
+    const projectDir = process.cwd();
+    // STEP 1: Try to use pre-built binary from platform package
+    const prebuiltBinary = resolveBinary('zap', projectDir);
+    if (prebuiltBinary && existsSync(prebuiltBinary)) {
+        cliLogger.spinner('rust', 'Using pre-built binary...');
+        const platformId = getPlatformIdentifier();
+        try {
+            // Copy pre-built binary to output directory
+            const destBinary = join(outputDir, 'bin', 'zap');
+            copyFileSync(prebuiltBinary, destBinary);
+            execSync(`chmod +x "${destBinary}"`, { stdio: 'pipe' });
+            cliLogger.succeedSpinner('rust', `Using pre-built binary for ${platformId}`);
+            return;
+        }
+        catch (error) {
+            cliLogger.failSpinner('rust', 'Failed to copy pre-built binary');
+            throw error;
+        }
+    }
+    // STEP 2: No pre-built binary found - check if we can build from source
+    const cargoTomlPath = join(projectDir, 'Cargo.toml');
+    if (!existsSync(cargoTomlPath)) {
+        cliLogger.failSpinner('rust', 'No binary available');
+        throw new Error('Cannot build: No pre-built binary found and no Cargo.toml to build from source.\n' +
+            '\n' +
+            'Solutions:\n' +
+            `1. Install platform package: npm install @zap-js/${getPlatformIdentifier()}\n` +
+            '2. Or build from source by cloning the ZapJS repository');
+    }
+    // STEP 3: Build from source with cargo
+    cliLogger.spinner('rust', 'Building Rust backend from source (release mode)...');
     const args = ['build', '--release', '--bin', 'zap'];
     if (options.target) {
         args.push('--target', options.target);
@@ -123,7 +153,7 @@ async function buildRust(outputDir, options) {
         const destBinary = join(outputDir, 'bin', 'zap');
         copyFileSync(srcBinary, destBinary);
         execSync(`chmod +x "${destBinary}"`, { stdio: 'pipe' });
-        cliLogger.succeedSpinner('rust', 'Rust backend built (release + LTO)');
+        cliLogger.succeedSpinner('rust', 'Rust backend built from source (release + LTO)');
     }
     catch (error) {
         cliLogger.failSpinner('rust', 'Rust build failed');

package/dist/runtime/browser.d.ts

@@ -0,0 +1,112 @@
+/**
+ * Browser-safe exports for @zap-js/client
+ *
+ * This entry point contains NO Node.js imports and is safe to use in:
+ * - Vite builds
+ * - Webpack builds
+ * - Browser environments
+ * - React/Vue/Svelte applications
+ *
+ * For server-side functionality, use @zap-js/client/node instead.
+ */
+export { RouterProvider, useRouter, useParams, usePathname, useSearchParams, useRouteMatch, useIsPending, Link, NavLink, Outlet, Redirect, type Router, type RouteDefinition, type RouteMatch, type RouterState, type NavigateOptions, type LinkProps, } from './router.js';
+export { ErrorBoundary, DefaultErrorComponent, RouteErrorContext, createRouteError, ZapError, type ZapRouteError, type ErrorComponentProps, type ErrorComponent, } from './error-boundary.js';
+export { useRouteError, useIsErrorState, useErrorState, } from './hooks.js';
+export { getCsrfToken, useCsrfToken, createCsrfFetch, CsrfTokenInput, CsrfForm, addCsrfToFormData, getCsrfHeaders, type CsrfConfig, type CsrfTokenInputProps, type CsrfFormProps, } from './csrf.js';
+export { composeMiddleware, requireAuth, requireRole, routeLogger, preloadData, type MiddlewareContext, type MiddlewareResult, type MiddlewareFunction, type RouteMiddleware, } from './middleware.js';
+export * from './streaming-utils.js';
+export * from './websockets-utils.js';
+export type { Handler, ZapRequest, ZapHandlerResponse, RouteConfig, HttpMethod, MiddlewareConfig, FileRouteConfig, StreamChunk, StreamingHandler, AnyHandler, StreamStartMessage, StreamChunkMessage, StreamEndMessage, StreamMessage, WsConnection, WsHandler, WsConnectMessage, WsMessageMessage, WsCloseMessage, WsSendMessage, WsMessage, } from './types.js';
+export { isInvokeHandlerMessage, isHandlerResponseMessage, isErrorMessage, isHealthCheckMessage, isHealthCheckResponseMessage, isRpcResponseMessage, isRpcErrorMessage, isAsyncIterable, } from './types.js';
+/**
+ * Router namespace - all routing functionality
+ * Usage: import { router } from '@zap-js/client/browser'
+ */
+import { RouterProvider, useRouter as useRouterFn, useParams as useParamsFn, usePathname as usePathnameFn, useSearchParams as useSearchParamsFn, useRouteMatch as useRouteMatchFn, useIsPending as useIsPendingFn, Link, NavLink, Outlet, Redirect } from './router.js';
+export declare const router: {
+    readonly RouterProvider: typeof RouterProvider;
+    readonly useRouter: typeof useRouterFn;
+    readonly useParams: typeof useParamsFn;
+    readonly usePathname: typeof usePathnameFn;
+    readonly useSearchParams: typeof useSearchParamsFn;
+    readonly useRouteMatch: typeof useRouteMatchFn;
+    readonly useIsPending: typeof useIsPendingFn;
+    readonly Link: typeof Link;
+    readonly NavLink: typeof NavLink;
+    readonly Outlet: typeof Outlet;
+    readonly Redirect: typeof Redirect;
+};
+/**
+ * Errors namespace - error handling and boundaries
+ * Usage: import { errors } from '@zap-js/client/browser'
+ */
+import { ErrorBoundary, DefaultErrorComponent, createRouteError, ZapError } from './error-boundary.js';
+import { useRouteError, useIsErrorState, useErrorState } from './hooks.js';
+export declare const errors: {
+    readonly ErrorBoundary: typeof ErrorBoundary;
+    readonly DefaultErrorComponent: typeof DefaultErrorComponent;
+    readonly createRouteError: typeof createRouteError;
+    readonly ZapError: typeof ZapError;
+    readonly useRouteError: typeof useRouteError;
+    readonly useIsErrorState: typeof useIsErrorState;
+    readonly useErrorState: typeof useErrorState;
+};
+/**
+ * Middleware namespace - route middleware utilities
+ * Usage: import { middleware } from '@zap-js/client/browser'
+ */
+import { composeMiddleware, requireAuth, requireRole, routeLogger, preloadData } from './middleware.js';
+export declare const middleware: {
+    readonly compose: typeof composeMiddleware;
+    readonly requireAuth: typeof requireAuth;
+    readonly requireRole: typeof requireRole;
+    readonly logger: typeof routeLogger;
+    readonly preloadData: typeof preloadData;
+};
+/**
+ * Types namespace - type definitions and guards
+ * Usage: import { types } from '@zap-js/client/browser'
+ */
+import * as TypeGuards from './types.js';
+export declare const types: {
+    readonly isInvokeHandlerMessage: typeof TypeGuards.isInvokeHandlerMessage;
+    readonly isHandlerResponseMessage: typeof TypeGuards.isHandlerResponseMessage;
+    readonly isErrorMessage: typeof TypeGuards.isErrorMessage;
+    readonly isHealthCheckMessage: typeof TypeGuards.isHealthCheckMessage;
+    readonly isHealthCheckResponseMessage: typeof TypeGuards.isHealthCheckResponseMessage;
+    readonly isRpcResponseMessage: typeof TypeGuards.isRpcResponseMessage;
+    readonly isRpcErrorMessage: typeof TypeGuards.isRpcErrorMessage;
+    readonly isAsyncIterable: typeof TypeGuards.isAsyncIterable;
+};
+/**
+ * WebSockets namespace - WebSocket utilities and helpers
+ * Usage: import { websockets } from '@zap-js/client/browser'
+ */
+import * as WebSocketUtils from './websockets-utils.js';
+export declare const websockets: {
+    readonly isWsMessage: typeof WebSocketUtils.isWsMessage;
+    readonly broadcast: typeof WebSocketUtils.broadcast;
+    readonly broadcastExcept: typeof WebSocketUtils.broadcastExcept;
+    readonly sendJson: typeof WebSocketUtils.sendJson;
+    readonly parseMessage: typeof WebSocketUtils.parseMessage;
+    readonly createErrorMessage: typeof WebSocketUtils.createErrorMessage;
+    readonly createSuccessMessage: typeof WebSocketUtils.createSuccessMessage;
+};
+/**
+ * Streaming namespace - Streaming response utilities
+ * Usage: import { streaming } from '@zap-js/client/browser'
+ */
+import * as StreamingUtils from './streaming-utils.js';
+export declare const streaming: {
+    readonly isAsyncIterable: typeof TypeGuards.isAsyncIterable;
+    readonly createChunk: typeof StreamingUtils.createChunk;
+    readonly createStream: typeof StreamingUtils.createStream;
+    readonly streamJson: typeof StreamingUtils.streamJson;
+    readonly streamSSE: typeof StreamingUtils.streamSSE;
+    readonly mapStream: typeof StreamingUtils.mapStream;
+    readonly filterStream: typeof StreamingUtils.filterStream;
+    readonly batchStream: typeof StreamingUtils.batchStream;
+    readonly delayStream: typeof StreamingUtils.delayStream;
+    readonly fromReadableStream: typeof StreamingUtils.fromReadableStream;
+    readonly intervalStream: typeof StreamingUtils.intervalStream;
+};

package/dist/runtime/browser.js

@@ -0,0 +1,136 @@
+/**
+ * Browser-safe exports for @zap-js/client
+ *
+ * This entry point contains NO Node.js imports and is safe to use in:
+ * - Vite builds
+ * - Webpack builds
+ * - Browser environments
+ * - React/Vue/Svelte applications
+ *
+ * For server-side functionality, use @zap-js/client/node instead.
+ */
+// ============================================================================
+// Router Exports (Client-side)
+// ============================================================================
+export { 
+// Provider
+RouterProvider, 
+// Hooks
+useRouter, useParams, usePathname, useSearchParams, useRouteMatch, useIsPending, 
+// Components
+Link, NavLink, Outlet, Redirect, } from './router.js';
+// ============================================================================
+// Error Handling Exports
+// ============================================================================
+export { ErrorBoundary, DefaultErrorComponent, RouteErrorContext, createRouteError, ZapError, } from './error-boundary.js';
+export { useRouteError, useIsErrorState, useErrorState, } from './hooks.js';
+// ============================================================================
+// CSRF Protection Exports
+// ============================================================================
+export { getCsrfToken, useCsrfToken, createCsrfFetch, CsrfTokenInput, CsrfForm, addCsrfToFormData, getCsrfHeaders, } from './csrf.js';
+// ============================================================================
+// Middleware Exports (Pure TypeScript, no Node.js deps)
+// ============================================================================
+export { composeMiddleware, requireAuth, requireRole, routeLogger, preloadData, } from './middleware.js';
+// ============================================================================
+// Utility Exports (Browser-safe)
+// ============================================================================
+export * from './streaming-utils.js';
+export * from './websockets-utils.js';
+// Re-export type guards (pure functions, no Node.js deps)
+export { isInvokeHandlerMessage, isHandlerResponseMessage, isErrorMessage, isHealthCheckMessage, isHealthCheckResponseMessage, isRpcResponseMessage, isRpcErrorMessage, isAsyncIterable, } from './types.js';
+// ============================================================================
+// Namespace Exports for Convenience
+// ============================================================================
+/**
+ * Router namespace - all routing functionality
+ * Usage: import { router } from '@zap-js/client/browser'
+ */
+import { RouterProvider, useRouter as useRouterFn, useParams as useParamsFn, usePathname as usePathnameFn, useSearchParams as useSearchParamsFn, useRouteMatch as useRouteMatchFn, useIsPending as useIsPendingFn, Link, NavLink, Outlet, Redirect, } from './router.js';
+export const router = {
+    RouterProvider,
+    useRouter: useRouterFn,
+    useParams: useParamsFn,
+    usePathname: usePathnameFn,
+    useSearchParams: useSearchParamsFn,
+    useRouteMatch: useRouteMatchFn,
+    useIsPending: useIsPendingFn,
+    Link,
+    NavLink,
+    Outlet,
+    Redirect,
+};
+/**
+ * Errors namespace - error handling and boundaries
+ * Usage: import { errors } from '@zap-js/client/browser'
+ */
+import { ErrorBoundary, DefaultErrorComponent, createRouteError, ZapError, } from './error-boundary.js';
+import { useRouteError, useIsErrorState, useErrorState, } from './hooks.js';
+export const errors = {
+    ErrorBoundary,
+    DefaultErrorComponent,
+    createRouteError,
+    ZapError,
+    useRouteError,
+    useIsErrorState,
+    useErrorState,
+};
+/**
+ * Middleware namespace - route middleware utilities
+ * Usage: import { middleware } from '@zap-js/client/browser'
+ */
+import { composeMiddleware, requireAuth, requireRole, routeLogger, preloadData, } from './middleware.js';
+export const middleware = {
+    compose: composeMiddleware,
+    requireAuth,
+    requireRole,
+    logger: routeLogger,
+    preloadData,
+};
+/**
+ * Types namespace - type definitions and guards
+ * Usage: import { types } from '@zap-js/client/browser'
+ */
+import * as TypeGuards from './types.js';
+export const types = {
+    isInvokeHandlerMessage: TypeGuards.isInvokeHandlerMessage,
+    isHandlerResponseMessage: TypeGuards.isHandlerResponseMessage,
+    isErrorMessage: TypeGuards.isErrorMessage,
+    isHealthCheckMessage: TypeGuards.isHealthCheckMessage,
+    isHealthCheckResponseMessage: TypeGuards.isHealthCheckResponseMessage,
+    isRpcResponseMessage: TypeGuards.isRpcResponseMessage,
+    isRpcErrorMessage: TypeGuards.isRpcErrorMessage,
+    isAsyncIterable: TypeGuards.isAsyncIterable,
+};
+/**
+ * WebSockets namespace - WebSocket utilities and helpers
+ * Usage: import { websockets } from '@zap-js/client/browser'
+ */
+import * as WebSocketUtils from './websockets-utils.js';
+export const websockets = {
+    isWsMessage: WebSocketUtils.isWsMessage,
+    broadcast: WebSocketUtils.broadcast,
+    broadcastExcept: WebSocketUtils.broadcastExcept,
+    sendJson: WebSocketUtils.sendJson,
+    parseMessage: WebSocketUtils.parseMessage,
+    createErrorMessage: WebSocketUtils.createErrorMessage,
+    createSuccessMessage: WebSocketUtils.createSuccessMessage,
+};
+/**
+ * Streaming namespace - Streaming response utilities
+ * Usage: import { streaming } from '@zap-js/client/browser'
+ */
+import * as StreamingUtils from './streaming-utils.js';
+export const streaming = {
+    isAsyncIterable: StreamingUtils.isAsyncIterable,
+    createChunk: StreamingUtils.createChunk,
+    createStream: StreamingUtils.createStream,
+    streamJson: StreamingUtils.streamJson,
+    streamSSE: StreamingUtils.streamSSE,
+    mapStream: StreamingUtils.mapStream,
+    filterStream: StreamingUtils.filterStream,
+    batchStream: StreamingUtils.batchStream,
+    delayStream: StreamingUtils.delayStream,
+    fromReadableStream: StreamingUtils.fromReadableStream,
+    intervalStream: StreamingUtils.intervalStream,
+};

package/dist/runtime/client.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Client exports for @zap-js/client
+ *
+ * Semantic alias for browser.ts - provides all browser-safe functionality.
+ * Use this when you want to be explicit about client-side code.
+ *
+ * Usage:
+ * ```ts
+ * import { router } from '@zap-js/client/client';
+ * ```
+ */
+export * from './browser.js';

package/dist/runtime/client.js

@@ -0,0 +1,12 @@
+/**
+ * Client exports for @zap-js/client
+ *
+ * Semantic alias for browser.ts - provides all browser-safe functionality.
+ * Use this when you want to be explicit about client-side code.
+ *
+ * Usage:
+ * ```ts
+ * import { router } from '@zap-js/client/client';
+ * ```
+ */
+export * from './browser.js';

package/dist/runtime/node.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Node.js exports for @zap-js/client
+ *
+ * This entry point includes server-side functionality that requires Node.js:
+ * - Zap class (server instance)
+ * - ProcessManager (manages Rust binary)
+ * - IpcServer/IpcClient (inter-process communication)
+ * - Logger (server-side logging)
+ * - RPC client utilities
+ *
+ * For browser/client-side functionality, use @zap-js/client/browser instead.
+ */
+export { Zap } from './index.js';
+export { ProcessManager } from './process-manager.js';
+export { IpcServer, IpcClient } from './ipc-client.js';
+export { rpcCall } from './rpc-client.js';
+export { Logger, logger, type LogContext, type LogLevel, type ChildLogger } from './logger.js';
+export type { Handler, ZapRequest, ZapHandlerResponse, ZapConfig, RouteConfig, MiddlewareConfig, StaticFileConfig, StaticFileOptions, FileRouteConfig, ZapOptions, IpcMessage, InvokeHandlerMessage, HandlerResponseMessage, ErrorMessage, HealthCheckMessage, HealthCheckResponseMessage, HttpMethod, InternalHandlerFunction, RpcMessage, RpcCallMessage, RpcResponseMessage, RpcErrorMessage, PendingRequest, SecurityConfig, SecurityHeadersConfig, HstsConfig, RateLimitConfig, CorsConfig, ObservabilityConfig, StreamChunk, StreamingHandler, AnyHandler, StreamStartMessage, StreamChunkMessage, StreamEndMessage, StreamMessage, WsConnection, WsHandler, WsConnectMessage, WsMessageMessage, WsCloseMessage, WsSendMessage, WsMessage, } from './types.js';
+export { isInvokeHandlerMessage, isHandlerResponseMessage, isErrorMessage, isHealthCheckMessage, isHealthCheckResponseMessage, isRpcResponseMessage, isRpcErrorMessage, isAsyncIterable, } from './types.js';
+export { composeMiddleware, requireAuth, requireRole, routeLogger, preloadData, type MiddlewareContext, type MiddlewareResult, type MiddlewareFunction, type RouteMiddleware, } from './middleware.js';
+export { RouterProvider, useRouter, useParams, usePathname, useSearchParams, useRouteMatch, useIsPending, Link, NavLink, Outlet, Redirect, type Router, type RouteDefinition, type RouteMatch, type RouterState, type NavigateOptions, type LinkProps, ErrorBoundary, DefaultErrorComponent, RouteErrorContext, createRouteError, ZapError, type ZapRouteError, type ErrorComponentProps, type ErrorComponent, useRouteError, useIsErrorState, useErrorState, getCsrfToken, useCsrfToken, createCsrfFetch, CsrfTokenInput, CsrfForm, addCsrfToFormData, getCsrfHeaders, type CsrfConfig, type CsrfTokenInputProps, type CsrfFormProps, router, errors, middleware, types, websockets, streaming, } from './index.js';
+export { default } from './index.js';

package/dist/runtime/node.js

@@ -0,0 +1,43 @@
+/**
+ * Node.js exports for @zap-js/client
+ *
+ * This entry point includes server-side functionality that requires Node.js:
+ * - Zap class (server instance)
+ * - ProcessManager (manages Rust binary)
+ * - IpcServer/IpcClient (inter-process communication)
+ * - Logger (server-side logging)
+ * - RPC client utilities
+ *
+ * For browser/client-side functionality, use @zap-js/client/browser instead.
+ */
+// ============================================================================
+// Server-Side Core Exports
+// ============================================================================
+export { Zap } from './index.js';
+export { ProcessManager } from './process-manager.js';
+export { IpcServer, IpcClient } from './ipc-client.js';
+export { rpcCall } from './rpc-client.js';
+export { Logger, logger } from './logger.js';
+// Re-export type guards
+export { isInvokeHandlerMessage, isHandlerResponseMessage, isErrorMessage, isHealthCheckMessage, isHealthCheckResponseMessage, isRpcResponseMessage, isRpcErrorMessage, isAsyncIterable, } from './types.js';
+// ============================================================================
+// Middleware Exports
+// ============================================================================
+export { composeMiddleware, requireAuth, requireRole, routeLogger, preloadData, } from './middleware.js';
+// ============================================================================
+// Re-export Browser-Safe Functionality
+// ============================================================================
+// Note: Server code might also need router, errors, etc. for SSR
+export { 
+// Router
+RouterProvider, useRouter, useParams, usePathname, useSearchParams, useRouteMatch, useIsPending, Link, NavLink, Outlet, Redirect, 
+// Error handling
+ErrorBoundary, DefaultErrorComponent, RouteErrorContext, createRouteError, ZapError, useRouteError, useIsErrorState, useErrorState, 
+// CSRF
+getCsrfToken, useCsrfToken, createCsrfFetch, CsrfTokenInput, CsrfForm, addCsrfToFormData, getCsrfHeaders, 
+// Utilities
+router, errors, middleware, types, websockets, streaming, } from './index.js';
+// ============================================================================
+// Default Export
+// ============================================================================
+export { default } from './index.js';

package/dist/runtime/server.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Server exports for @zap-js/client
+ *
+ * Semantic alias for node.ts - provides all server-side functionality.
+ * Use this when you want to be explicit about server-side code.
+ *
+ * Usage:
+ * ```ts
+ * import { Zap } from '@zap-js/client/server';
+ * ```
+ */
+export * from './node.js';

package/dist/runtime/server.js

@@ -0,0 +1,12 @@
+/**
+ * Server exports for @zap-js/client
+ *
+ * Semantic alias for node.ts - provides all server-side functionality.
+ * Use this when you want to be explicit about server-side code.
+ *
+ * Usage:
+ * ```ts
+ * import { Zap } from '@zap-js/client/server';
+ * ```
+ */
+export * from './node.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zap-js/client",
-  "version": "0.0.9",
+  "version": "0.1.1",
   "description": "High-performance fullstack React framework - Client package",
   "homepage": "https://github.com/saint0x/zapjs",
   "repository": {
@@ -16,7 +16,24 @@
   "exports": {
     ".": {
       "types": "./index.d.ts",
-      "default": "./dist/runtime/index.js"
+      "node": "./dist/runtime/node.js",
+      "default": "./dist/runtime/browser.js"
+    },
+    "./node": {
+      "types": "./index.d.ts",
+      "default": "./dist/runtime/node.js"
+    },
+    "./server": {
+      "types": "./index.d.ts",
+      "default": "./dist/runtime/server.js"
+    },
+    "./browser": {
+      "types": "./index.d.ts",
+      "default": "./dist/runtime/browser.js"
+    },
+    "./client": {
+      "types": "./index.d.ts",
+      "default": "./dist/runtime/client.js"
     },
     "./router": "./dist/router/index.js"
   },
@@ -54,9 +71,9 @@
     "ws": "^8.16.0"
   },
   "optionalDependencies": {
-    "@zap-js/darwin-arm64": "0.0.9",
-    "@zap-js/darwin-x64": "0.0.9",
-    "@zap-js/linux-x64": "0.0.9"
+    "@zap-js/darwin-arm64": "0.1.1",
+    "@zap-js/darwin-x64": "0.1.1",
+    "@zap-js/linux-x64": "0.1.1"
   },
   "peerDependencies": {
     "react": "^18.0.0",