@ereo/testing 0.1.6

package/dist/loader.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @ereo/testing - Loader Testing
+ *
+ * Utilities for testing route loaders.
+ */
+import type { LoaderFunction, RouteParams } from '@ereo/core';
+import { type TestContextOptions, type TestContext } from './context';
+import { type MockRequestOptions } from './request';
+/**
+ * Options for testing a loader.
+ */
+export interface LoaderTestOptions<P = RouteParams> {
+    /** Route parameters */
+    params?: P;
+    /** Request options */
+    request?: MockRequestOptions;
+    /** Context options */
+    context?: TestContextOptions;
+}
+/**
+ * Result of testing a loader.
+ */
+export interface LoaderTestResult<T = unknown> {
+    /** The loader's return value */
+    data: T;
+    /** The test context (for inspection) */
+    context: TestContext;
+    /** The request used */
+    request: Request;
+    /** Execution time in milliseconds */
+    duration: number;
+}
+/**
+ * Test a loader function directly.
+ *
+ * @example
+ * import { testLoader } from '@ereo/testing';
+ * import { loader } from './routes/blog/[slug]';
+ *
+ * test('loads blog post', async () => {
+ *   const result = await testLoader(loader, {
+ *     params: { slug: 'my-post' },
+ *   });
+ *
+ *   expect(result.data.title).toBe('My Post');
+ *   expect(result.context.getCacheOperations()).toHaveLength(1);
+ * });
+ */
+export declare function testLoader<T = unknown, P = RouteParams>(loader: LoaderFunction<T, P>, options?: LoaderTestOptions<P>): Promise<LoaderTestResult<T>>;
+/**
+ * Create a reusable loader tester with preset options.
+ *
+ * @example
+ * const testPostLoader = createLoaderTester(loader, {
+ *   context: { store: { user: testUser } },
+ * });
+ *
+ * test('loads post with user context', async () => {
+ *   const result = await testPostLoader({ params: { slug: 'test' } });
+ *   expect(result.data).toBeDefined();
+ * });
+ */
+export declare function createLoaderTester<T = unknown, P = RouteParams>(loader: LoaderFunction<T, P>, baseOptions?: LoaderTestOptions<P>): (overrides?: Partial<LoaderTestOptions<P>>) => Promise<LoaderTestResult<T>>;
+/**
+ * Test multiple loaders in parallel (for testing combined loaders).
+ *
+ * @example
+ * const results = await testLoadersParallel([
+ *   { loader: userLoader, params: { id: '1' } },
+ *   { loader: postsLoader, params: {} },
+ * ]);
+ */
+export declare function testLoadersParallel<T extends unknown[] = unknown[]>(loaders: Array<{
+    loader: LoaderFunction<T[number]>;
+    params?: RouteParams;
+    request?: MockRequestOptions;
+    context?: TestContextOptions;
+}>): Promise<LoaderTestResult<T[number]>[]>;
+/**
+ * Test loader with multiple param combinations.
+ *
+ * @example
+ * const results = await testLoaderMatrix(loader, {
+ *   params: [
+ *     { slug: 'post-1' },
+ *     { slug: 'post-2' },
+ *     { slug: 'non-existent' },
+ *   ],
+ * });
+ *
+ * expect(results[0].data).toBeDefined();
+ * expect(results[2].data).toBeNull();
+ */
+export declare function testLoaderMatrix<T = unknown, P = RouteParams>(loader: LoaderFunction<T, P>, options: {
+    params: P[];
+    request?: MockRequestOptions;
+    context?: TestContextOptions;
+}): Promise<LoaderTestResult<T>[]>;
+/**
+ * Test loader error handling.
+ *
+ * @example
+ * test('handles missing post', async () => {
+ *   const result = await testLoaderError(loader, {
+ *     params: { slug: 'non-existent' },
+ *   });
+ *
+ *   expect(result.error).toBeInstanceOf(NotFoundError);
+ * });
+ */
+export declare function testLoaderError<P = RouteParams>(loader: LoaderFunction<unknown, P>, options?: LoaderTestOptions<P>): Promise<{
+    error: Error | null;
+    context: TestContext;
+    request: Request;
+}>;
+//# sourceMappingURL=loader.d.ts.map

package/dist/loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loader.d.ts","sourceRoot":"","sources":["../src/loader.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAC9D,OAAO,EAAqB,KAAK,kBAAkB,EAAE,KAAK,WAAW,EAAE,MAAM,WAAW,CAAC;AACzF,OAAO,EAAqB,KAAK,kBAAkB,EAAE,MAAM,WAAW,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,iBAAiB,CAAC,CAAC,GAAG,WAAW;IAChD,uBAAuB;IACvB,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,sBAAsB;IACtB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,sBAAsB;IACtB,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,gBAAgB,CAAC,CAAC,GAAG,OAAO;IAC3C,gCAAgC;IAChC,IAAI,EAAE,CAAC,CAAC;IACR,wCAAwC;IACxC,OAAO,EAAE,WAAW,CAAC;IACrB,uBAAuB;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,qCAAqC;IACrC,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,WAAW,EAC3D,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,OAAO,GAAE,iBAAiB,CAAC,CAAC,CAAM,GACjC,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAe9B;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,WAAW,EAC7D,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,WAAW,GAAE,iBAAiB,CAAC,CAAC,CAAM,IAExB,YAAW,OAAO,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAM,KAAG,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAc3F;AAED;;;;;;;;GAQG;AACH,wBAAsB,mBAAmB,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,OAAO,EAAE,EACvE,OAAO,EAAE,KAAK,CAAC;IACb,MAAM,EAAE,cAAc,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,CAAC,GACD,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAMxC;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,WAAW,EACjE,MAAM,EAAE,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,EAC5B,OAAO,EAAE;IACP,MAAM,EAAE,CAAC,EAAE,CAAC;IACZ,OAAO,CAAC,EAAE,kBAAkB,CAAC;IAC7B,OAAO,CAAC,EAAE,kBAAkB,CAAC;CAC9B,GACA,OAAO,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,CAAC,CAUhC;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,CAAC,GAAG,WAAW,EACnD,MAAM,EAAE,cAAc,CAAC,OAAO,EAAE,CAAC,CAAC,EAClC,OAAO,GAAE,iBAAiB,CAAC,CAAC,CAAM,GACjC,OAAO,CAAC;IACT,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;CAClB,CAAC,CAeD"}

package/dist/middleware.d.ts

@@ -0,0 +1,177 @@
+/**
+ * @ereo/testing - Middleware Testing
+ *
+ * Utilities for testing middleware functions.
+ */
+import type { MiddlewareHandler, NextFunction } from '@ereo/core';
+import { type TestContextOptions, type TestContext } from './context';
+import { type MockRequestOptions } from './request';
+/**
+ * Options for testing middleware.
+ */
+export interface MiddlewareTestOptions {
+    /** Request options */
+    request?: MockRequestOptions;
+    /** Context options */
+    context?: TestContextOptions;
+    /** Custom next function (defaults to returning 200 OK) */
+    next?: NextFunction;
+    /** Expected response from next (for pass-through testing) */
+    nextResponse?: Response;
+}
+/**
+ * Result of testing middleware.
+ */
+export interface MiddlewareTestResult {
+    /** The response returned by middleware */
+    response: Response;
+    /** The test context (for inspection) */
+    context: TestContext;
+    /** The request used */
+    request: Request;
+    /** Whether next() was called */
+    nextCalled: boolean;
+    /** How many times next() was called */
+    nextCallCount: number;
+    /** Execution time in milliseconds */
+    duration: number;
+}
+/**
+ * Test a middleware function directly.
+ *
+ * @example
+ * import { testMiddleware } from '@ereo/testing';
+ * import { authMiddleware } from './middleware/auth';
+ *
+ * test('blocks unauthenticated requests', async () => {
+ *   const result = await testMiddleware(authMiddleware, {
+ *     request: { url: '/admin' },
+ *   });
+ *
+ *   expect(result.response.status).toBe(401);
+ *   expect(result.nextCalled).toBe(false);
+ * });
+ *
+ * test('allows authenticated requests', async () => {
+ *   const result = await testMiddleware(authMiddleware, {
+ *     request: {
+ *       url: '/admin',
+ *       headers: { Authorization: 'Bearer valid-token' },
+ *     },
+ *   });
+ *
+ *   expect(result.nextCalled).toBe(true);
+ *   expect(result.response.status).toBe(200);
+ * });
+ */
+export declare function testMiddleware(middleware: MiddlewareHandler, options?: MiddlewareTestOptions): Promise<MiddlewareTestResult>;
+/**
+ * Create a reusable middleware tester with preset options.
+ *
+ * @example
+ * const testAuth = createMiddlewareTester(authMiddleware, {
+ *   context: { env: { AUTH_SECRET: 'test-secret' } },
+ * });
+ *
+ * test('allows valid tokens', async () => {
+ *   const result = await testAuth({
+ *     request: { headers: { Authorization: 'Bearer valid' } },
+ *   });
+ *   expect(result.nextCalled).toBe(true);
+ * });
+ */
+export declare function createMiddlewareTester(middleware: MiddlewareHandler, baseOptions?: MiddlewareTestOptions): (overrides?: Partial<MiddlewareTestOptions>) => Promise<MiddlewareTestResult>;
+/**
+ * Test a chain of middleware functions.
+ *
+ * @example
+ * const result = await testMiddlewareChain([
+ *   loggingMiddleware,
+ *   authMiddleware,
+ *   rateLimitMiddleware,
+ * ], {
+ *   request: { url: '/api/data' },
+ * });
+ *
+ * expect(result.response.status).toBe(200);
+ * expect(result.middlewareResults[0].nextCalled).toBe(true);
+ */
+export declare function testMiddlewareChain(middlewares: MiddlewareHandler[], options?: MiddlewareTestOptions): Promise<{
+    response: Response;
+    context: TestContext;
+    request: Request;
+    middlewareResults: Array<{
+        index: number;
+        nextCalled: boolean;
+        duration: number;
+    }>;
+}>;
+/**
+ * Test middleware with multiple request scenarios.
+ *
+ * @example
+ * const results = await testMiddlewareMatrix(authMiddleware, {
+ *   requests: [
+ *     { url: '/public' },
+ *     { url: '/admin', headers: { Authorization: 'Bearer valid' } },
+ *     { url: '/admin' }, // No auth
+ *   ],
+ * });
+ *
+ * expect(results[0].response.status).toBe(200);
+ * expect(results[1].response.status).toBe(200);
+ * expect(results[2].response.status).toBe(401);
+ */
+export declare function testMiddlewareMatrix(middleware: MiddlewareHandler, options: {
+    requests: MockRequestOptions[];
+    context?: TestContextOptions;
+}): Promise<MiddlewareTestResult[]>;
+/**
+ * Test middleware error handling.
+ *
+ * @example
+ * test('handles errors gracefully', async () => {
+ *   const result = await testMiddlewareError(errorMiddleware, {
+ *     next: async () => {
+ *       throw new Error('Downstream error');
+ *     },
+ *   });
+ *
+ *   expect(result.response.status).toBe(500);
+ *   expect(result.error).toBeNull(); // Middleware caught the error
+ * });
+ */
+export declare function testMiddlewareError(middleware: MiddlewareHandler, options: MiddlewareTestOptions & {
+    next: NextFunction;
+}): Promise<{
+    response: Response | null;
+    error: Error | null;
+    context: TestContext;
+}>;
+/**
+ * Test that middleware modifies context correctly.
+ *
+ * @example
+ * test('sets user in context', async () => {
+ *   const result = await testMiddlewareContext(authMiddleware, {
+ *     request: { headers: { Authorization: 'Bearer valid' } },
+ *     expectContextValues: {
+ *       user: { id: expect.any(String), role: 'user' },
+ *     },
+ *   });
+ *
+ *   expect(result.contextMatches).toBe(true);
+ * });
+ */
+export declare function testMiddlewareContext(middleware: MiddlewareHandler, options: MiddlewareTestOptions & {
+    expectContextValues: Record<string, unknown>;
+}): Promise<{
+    response: Response;
+    context: TestContext;
+    contextMatches: boolean;
+    contextDiff: Record<string, {
+        expected: unknown;
+        actual: unknown;
+    }>;
+}>;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.d.ts.map

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

package/dist/render.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @ereo/testing - Component/Route Rendering
+ *
+ * Utilities for testing route components with their loaders.
+ */
+import type { ComponentType, ReactElement } from 'react';
+import type { RouteParams, RouteComponentProps, RouteModule } from '@ereo/core';
+import { type TestContextOptions, type TestContext } from './context';
+import { type MockRequestOptions } from './request';
+/**
+ * Options for rendering a route.
+ */
+export interface RenderRouteOptions<P = RouteParams> {
+    /** Route parameters */
+    params?: P;
+    /** Request options */
+    request?: MockRequestOptions;
+    /** Context options */
+    context?: TestContextOptions;
+    /** Initial loader data (skip loader execution) */
+    loaderData?: unknown;
+    /** Children to render */
+    children?: ReactElement;
+}
+/**
+ * Result of rendering a route.
+ */
+export interface RenderResult<T = unknown> {
+    /** The rendered element */
+    element: ReactElement;
+    /** The loader data used */
+    loaderData: T;
+    /** The test context */
+    context: TestContext;
+    /** The request used */
+    request: Request;
+    /** Props passed to the component */
+    props: RouteComponentProps<T>;
+}
+/**
+ * Render a route component with its loader data.
+ *
+ * @example
+ * import { renderRoute } from '@ereo/testing';
+ * import { default as BlogPost, loader } from './routes/blog/[slug]';
+ *
+ * test('renders blog post', async () => {
+ *   const result = await renderRoute(
+ *     { default: BlogPost, loader },
+ *     { params: { slug: 'my-post' } }
+ *   );
+ *
+ *   // Use with your testing library
+ *   const { getByText } = render(result.element);
+ *   expect(getByText('My Post')).toBeInTheDocument();
+ * });
+ */
+export declare function renderRoute<T = unknown, P = RouteParams>(module: RouteModule, options?: RenderRouteOptions<P>): Promise<RenderResult<T>>;
+/**
+ * Create a reusable route renderer.
+ *
+ * @example
+ * const renderBlogPost = createRouteRenderer(
+ *   { default: BlogPost, loader },
+ *   { context: { store: { user: testUser } } }
+ * );
+ *
+ * test('renders for authenticated user', async () => {
+ *   const result = await renderBlogPost({ params: { slug: 'test' } });
+ *   // ...
+ * });
+ */
+export declare function createRouteRenderer<T = unknown, P = RouteParams>(module: RouteModule, baseOptions?: RenderRouteOptions<P>): (overrides?: Partial<RenderRouteOptions<P>>) => Promise<RenderResult<T>>;
+/**
+ * Render a standalone component with props.
+ *
+ * @example
+ * const element = renderComponent(Counter, { count: 5 });
+ */
+export declare function renderComponent<P extends object>(Component: ComponentType<P>, props: P): ReactElement;
+/**
+ * Render a route with multiple param sets for snapshot testing.
+ *
+ * @example
+ * const renders = await renderRouteMatrix(
+ *   { default: BlogPost, loader },
+ *   {
+ *     params: [
+ *       { slug: 'post-1' },
+ *       { slug: 'post-2' },
+ *     ],
+ *   }
+ * );
+ *
+ * renders.forEach((result, index) => {
+ *   expect(result.element).toMatchSnapshot(`render-${index}`);
+ * });
+ */
+export declare function renderRouteMatrix<T = unknown, P = RouteParams>(module: RouteModule, options: {
+    params: P[];
+    request?: MockRequestOptions;
+    context?: TestContextOptions;
+}): Promise<RenderResult<T>[]>;
+/**
+ * Test that a route renders without throwing.
+ *
+ * @example
+ * test('renders without errors', async () => {
+ *   const result = await testRouteRenders(
+ *     { default: BlogPost, loader },
+ *     { params: { slug: 'test' } }
+ *   );
+ *
+ *   expect(result.renders).toBe(true);
+ *   expect(result.error).toBeNull();
+ * });
+ */
+export declare function testRouteRenders<P = RouteParams>(module: RouteModule, options?: RenderRouteOptions<P>): Promise<{
+    renders: boolean;
+    error: Error | null;
+    result: RenderResult | null;
+}>;
+/**
+ * Get the meta tags for a route.
+ *
+ * @example
+ * const meta = await getRouteMeta(
+ *   { default: BlogPost, loader, meta: metaFn },
+ *   { params: { slug: 'my-post' } }
+ * );
+ *
+ * expect(meta.find(m => m.title)).toEqual({ title: 'My Post' });
+ */
+export declare function getRouteMeta<P = RouteParams>(module: RouteModule, options?: RenderRouteOptions<P>): Promise<ReturnType<NonNullable<RouteModule['meta']>>>;
+//# sourceMappingURL=render.d.ts.map

package/dist/render.d.ts.map

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

package/dist/request.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @ereo/testing - Request Utilities
+ *
+ * Create mock requests for testing.
+ */
+/**
+ * Options for creating a mock request.
+ */
+export interface MockRequestOptions {
+    /** HTTP method (default: GET) */
+    method?: string;
+    /** Request URL or path */
+    url?: string;
+    /** Request headers */
+    headers?: Record<string, string>;
+    /** Request body (for POST/PUT/PATCH) */
+    body?: BodyInit | Record<string, unknown>;
+    /** Query parameters */
+    searchParams?: Record<string, string | string[]>;
+    /** Form data */
+    formData?: Record<string, string | Blob>;
+    /** Cookies */
+    cookies?: Record<string, string>;
+}
+/**
+ * Create a mock Request object for testing.
+ *
+ * @example
+ * // Simple GET request
+ * const request = createMockRequest({ url: '/api/posts' });
+ *
+ * // POST with JSON body
+ * const request = createMockRequest({
+ *   method: 'POST',
+ *   url: '/api/posts',
+ *   body: { title: 'Test Post' },
+ * });
+ *
+ * // POST with form data
+ * const request = createMockRequest({
+ *   method: 'POST',
+ *   url: '/api/login',
+ *   formData: { email: 'test@example.com', password: 'secret' },
+ * });
+ */
+export declare function createMockRequest(url?: string | MockRequestOptions, options?: MockRequestOptions): Request;
+/**
+ * Create a POST request with form data (convenience function).
+ *
+ * @example
+ * const request = createFormRequest('/api/login', {
+ *   email: 'test@example.com',
+ *   password: 'secret',
+ * });
+ */
+export declare function createFormRequest(url: string, data: Record<string, string | Blob>): Request;
+/**
+ * Create mock FormData for testing.
+ *
+ * @example
+ * const formData = createMockFormData({
+ *   email: 'test@example.com',
+ *   password: 'secret',
+ * });
+ */
+export declare function createMockFormData(data: Record<string, string | Blob | File>): FormData;
+/**
+ * Create mock Headers for testing.
+ *
+ * @example
+ * const headers = createMockHeaders({
+ *   'Authorization': 'Bearer token123',
+ *   'Content-Type': 'application/json',
+ * });
+ */
+export declare function createMockHeaders(data: Record<string, string>): Headers;
+/**
+ * Parse JSON from a Response.
+ *
+ * @example
+ * const result = await testAction(action, options);
+ * const data = await parseJsonResponse<MyData>(result.response);
+ */
+export declare function parseJsonResponse<T = unknown>(response: Response): Promise<T>;
+/**
+ * Parse text from a Response.
+ */
+export declare function parseTextResponse(response: Response): Promise<string>;
+/**
+ * Create a mock File for testing file uploads.
+ *
+ * @example
+ * const file = createMockFile('test.txt', 'Hello World', 'text/plain');
+ */
+export declare function createMockFile(name: string, content: string | Blob, type?: string): File;
+/**
+ * Extract cookies from a Response.
+ *
+ * @example
+ * const cookies = extractCookies(response);
+ * expect(cookies.session).toBeDefined();
+ */
+export declare function extractCookies(response: Response): Record<string, string>;
+//# sourceMappingURL=request.d.ts.map

package/dist/request.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.d.ts","sourceRoot":"","sources":["../src/request.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,iCAAiC;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,sBAAsB;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,wCAAwC;IACxC,IAAI,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1C,uBAAuB;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IACjD,gBAAgB;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IACzC,cAAc;IACd,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,kBAAkB,EAAE,OAAO,CAAC,EAAE,kBAAkB,GAAG,OAAO,CAU1G;AAiED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,GAClC,OAAO,CAcT;AAED;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAAC,GACzC,QAAQ,CAMV;AAED;;;;;;;;GAQG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAEvE;AAED;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC,CAOnF;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAE3E;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,GAAG,IAAI,EACtB,IAAI,SAA6B,GAChC,IAAI,CAGN;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,QAAQ,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAazE"}

package/dist/server.d.ts

@@ -0,0 +1,109 @@
+/**
+ * @ereo/testing - Test Server
+ *
+ * Create a test server for integration testing.
+ */
+import type { FrameworkConfig } from '@ereo/core';
+/**
+ * Test server options.
+ */
+export interface TestServerOptions {
+    /** Framework configuration */
+    config?: FrameworkConfig;
+    /** Port to run on (default: random available port) */
+    port?: number;
+    /** Routes directory */
+    routesDir?: string;
+}
+/**
+ * Test server interface.
+ */
+export interface TestServer {
+    /** Server base URL */
+    url: string;
+    /** Port the server is running on */
+    port: number;
+    /** Make a request to the server */
+    fetch: (path: string, init?: RequestInit) => Promise<Response>;
+    /** Make a GET request */
+    get: (path: string, init?: Omit<RequestInit, 'method'>) => Promise<Response>;
+    /** Make a POST request */
+    post: (path: string, body?: unknown, init?: Omit<RequestInit, 'method' | 'body'>) => Promise<Response>;
+    /** Make a PUT request */
+    put: (path: string, body?: unknown, init?: Omit<RequestInit, 'method' | 'body'>) => Promise<Response>;
+    /** Make a DELETE request */
+    delete: (path: string, init?: Omit<RequestInit, 'method'>) => Promise<Response>;
+    /** Make a PATCH request */
+    patch: (path: string, body?: unknown, init?: Omit<RequestInit, 'method' | 'body'>) => Promise<Response>;
+    /** Submit a form */
+    submitForm: (path: string, formData: Record<string, string>, init?: Omit<RequestInit, 'method' | 'body'>) => Promise<Response>;
+    /** Stop the server */
+    stop: () => Promise<void>;
+}
+/**
+ * Create a test server for integration testing.
+ *
+ * @example
+ * import { createTestServer } from '@ereo/testing';
+ *
+ * describe('API routes', () => {
+ *   let server: TestServer;
+ *
+ *   beforeAll(async () => {
+ *     server = await createTestServer({
+ *       routesDir: './app/routes',
+ *     });
+ *   });
+ *
+ *   afterAll(async () => {
+ *     await server.stop();
+ *   });
+ *
+ *   test('GET /api/posts', async () => {
+ *     const response = await server.get('/api/posts');
+ *     expect(response.status).toBe(200);
+ *
+ *     const posts = await response.json();
+ *     expect(posts).toHaveLength(3);
+ *   });
+ *
+ *   test('POST /api/posts', async () => {
+ *     const response = await server.post('/api/posts', {
+ *       title: 'New Post',
+ *       content: 'Content here',
+ *     });
+ *     expect(response.status).toBe(201);
+ *   });
+ * });
+ */
+export declare function createTestServer(options?: TestServerOptions): Promise<TestServer>;
+/**
+ * Create a simple mock server for external API testing.
+ *
+ * @example
+ * const mockApi = await createMockServer({
+ *   routes: {
+ *     'GET /users/1': { id: 1, name: 'Test User' },
+ *     'POST /users': (req) => ({ id: 2, ...req.body }),
+ *     'GET /users': [{ id: 1 }, { id: 2 }],
+ *   },
+ * });
+ *
+ * // In your test, use mockApi.url as the API base URL
+ * process.env.API_URL = mockApi.url;
+ *
+ * // After test
+ * await mockApi.stop();
+ */
+export declare function createMockServer(options: {
+    routes: Record<string, unknown | ((request: {
+        body?: unknown;
+        params?: Record<string, string>;
+    }) => unknown)>;
+    port?: number;
+}): Promise<{
+    url: string;
+    port: number;
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,8BAA8B;IAC9B,MAAM,CAAC,EAAE,eAAe,CAAC;IACzB,sDAAsD;IACtD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,uBAAuB;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB,sBAAsB;IACtB,GAAG,EAAE,MAAM,CAAC;IACZ,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,mCAAmC;IACnC,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/D,yBAAyB;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC7E,0BAA0B;IAC1B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvG,yBAAyB;IACzB,GAAG,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACtG,4BAA4B;IAC5B,MAAM,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAChF,2BAA2B;IAC3B,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACxG,oBAAoB;IACpB,UAAU,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,IAAI,CAAC,EAAE,IAAI,CAAC,WAAW,EAAE,QAAQ,GAAG,MAAM,CAAC,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC/H,sBAAsB;IACtB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,GAAE,iBAAsB,GAAG,OAAO,CAAC,UAAU,CAAC,CAiH3F;AAoBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAsB,gBAAgB,CAAC,OAAO,EAAE;IAC9C,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,CAAC,CAAC,OAAO,EAAE;QAAE,IAAI,CAAC,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;KAAE,KAAK,OAAO,CAAC,CAAC,CAAC;IAC9G,IAAI,CAAC,EAAE,MAAM,CAAC;CACf,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAgDpE"}