@c15t/backend 1.0.5 → 1.2.0-canary.0

package/src/integrations/cloudflare.ts

@@ -1,269 +0,0 @@
-import type { C15TInstance } from '~/core';
-import { ERROR_CODES } from '~/pkgs/results';
-
-/**
- * Convert a c15t handler to a Cloudflare Worker handler.
- *
- * This adapter is specifically designed for Cloudflare Workers environments,
- * avoiding Node.js-specific dependencies and APIs.
- *
- * @example
- * ```typescript
- * import { toCloudflareHandler } from '@c15t/backend/integrations';
- * import { c15tInstance } from '@c15t/backend';
- *
- * // Create c15t instance
- * const c15t = c15tInstance({
- *   basePath: '/',
- *   cors: true,
- *   // other options...
- * });
- *
- * // Export the worker handler
- * export default {
- *   async fetch(request, env, ctx) {
- *     return await toCloudflareHandler(c15t)(request);
- *   }
- * };
- * ```
- *
- * @param instance - The c15t instance to adapt
- * @returns A handler function suitable for Cloudflare Workers
- */
-export function toCloudflareHandler(instance: C15TInstance) {
-	return async (request: Request): Promise<Response> => {
-		try {
-			const basePath: string =
-				(instance.options?.basePath as string) || '/api/c15t';
-
-			// Extract the path and rewrite for c15t routing
-			const originalUrl = new URL(request.url);
-
-			let pathWithoutBase = originalUrl.pathname;
-
-			// Handle CORS preflight requests directly
-			if (request.method === 'OPTIONS') {
-				return handleCorsPreflightRequest(request, instance);
-			}
-
-			if (pathWithoutBase.startsWith(basePath)) {
-				pathWithoutBase = pathWithoutBase.substring(basePath.length);
-				// Ensure leading slash
-				if (!pathWithoutBase.startsWith('/')) {
-					pathWithoutBase = `/${pathWithoutBase}`;
-				}
-			}
-
-			// Create rewritten request with careful cloning to avoid stream issues
-			const rewrittenUrl = new URL(originalUrl.toString());
-			rewrittenUrl.pathname = pathWithoutBase;
-
-			const headers = new Headers();
-			for (const [key, value] of request.headers.entries()) {
-				headers.set(key, value);
-			}
-
-			// Create a new request without the credentials field which is not supported in Cloudflare Workers
-			const rewrittenRequest = new Request(rewrittenUrl.toString(), {
-				method: request.method,
-				headers,
-				body: ['GET', 'HEAD'].includes(request.method)
-					? undefined
-					: request.body,
-				duplex: ['GET', 'HEAD'].includes(request.method) ? undefined : 'half',
-			});
-
-			// Let c15t handle the request
-
-			const result = await instance.handler(rewrittenRequest);
-
-			// Convert c15t response to standard Response with CORS headers
-			return await result.match(
-				// Success case - add CORS headers and return
-				(response) => {
-					return addCorsHeaders(response, request, instance);
-				},
-				// Error case - create an error response with CORS headers
-				(error) => {
-					const status = error.statusCode || 500;
-					const message = error.message || ERROR_CODES.INTERNAL_SERVER_ERROR;
-
-					const errorResponse = new Response(
-						JSON.stringify({
-							error: true,
-							code: error.code || ERROR_CODES.INTERNAL_SERVER_ERROR,
-							message,
-							meta: error.meta,
-						}),
-						{
-							status,
-							headers: {
-								'Content-Type': 'application/json',
-							},
-						}
-					);
-
-					return addCorsHeaders(errorResponse, request, instance);
-				}
-			);
-		} catch (error) {
-			// Basic error handling
-
-			const errorResponse = new Response(
-				JSON.stringify({
-					error: true,
-					code: ERROR_CODES.INTERNAL_SERVER_ERROR,
-					message: 'An unexpected error occurred',
-					meta: { error: String(error) },
-				}),
-				{
-					status: 500,
-					headers: {
-						'Content-Type': 'application/json',
-					},
-				}
-			);
-
-			return addCorsHeaders(errorResponse, request, instance);
-		}
-	};
-
-	/**
-	 * Handle CORS preflight requests directly
-	 */
-	function handleCorsPreflightRequest(
-		request: Request,
-		instance: C15TInstance
-	): Response {
-		const origin = request.headers.get('Origin');
-		const isTrusted = isTrustedOrigin(origin, instance);
-
-		const headers = new Headers({
-			'Access-Control-Allow-Origin': isTrusted && origin ? origin : '*',
-			'Access-Control-Allow-Methods': 'GET, POST, PUT, DELETE, OPTIONS',
-			'Access-Control-Allow-Headers':
-				'Content-Type, Authorization, x-request-id',
-			'Access-Control-Max-Age': '86400',
-		});
-
-		// Add credentials header if trusted origin
-		if (isTrusted) {
-			headers.set('Access-Control-Allow-Credentials', 'true');
-		}
-
-		return new Response(null, {
-			status: 204,
-			headers,
-		});
-	}
-
-	/**
-	 * Add CORS headers to a response
-	 */
-	function addCorsHeaders(
-		response: Response,
-		request: Request,
-		instance: C15TInstance
-	): Response {
-		const origin = request.headers.get('Origin');
-		const isTrusted = isTrustedOrigin(origin, instance);
-
-		const newResponse = new Response(response.body, {
-			status: response.status,
-			statusText: response.statusText,
-			headers: response.headers,
-		});
-
-		// Set CORS headers
-		newResponse.headers.set(
-			'Access-Control-Allow-Origin',
-			isTrusted && origin ? origin : '*'
-		);
-
-		// Add credentials header if trusted origin
-		if (isTrusted) {
-			newResponse.headers.set('Access-Control-Allow-Credentials', 'true');
-		}
-
-		return newResponse;
-	}
-
-	/**
-	 * Check if origin is trusted
-	 */
-	function isTrustedOrigin(
-		origin: string | null,
-		instance: C15TInstance
-	): boolean {
-		if (!origin) {
-			return false;
-		}
-
-		// Get trusted origins from options
-		const { trustedOrigins = [] } = instance.options || {};
-
-		// Normalize trustedOrigins to array of strings
-		let originsArray: string[] = [];
-
-		if (Array.isArray(trustedOrigins)) {
-			// Handle potential nested array from env vars: ["localhost"] becomes ["localhost"]
-			originsArray = trustedOrigins.map((item) => {
-				// If item is a string that looks like an array element (has quotes and brackets)
-				if (
-					typeof item === 'string' &&
-					((item.startsWith('"') && item.endsWith('"')) ||
-						(item.startsWith('[') && item.endsWith(']')))
-				) {
-					try {
-						const parsed = JSON.parse(item);
-						return typeof parsed === 'string' ? parsed : item;
-					} catch {
-						return item;
-					}
-				}
-				return item;
-			});
-		} else if (typeof trustedOrigins === 'string') {
-			// Try to parse as JSON if it looks like an array
-			if (
-				(trustedOrigins as string).startsWith('[') &&
-				(trustedOrigins as string).endsWith(']')
-			) {
-				try {
-					const parsed = JSON.parse(trustedOrigins as string);
-					originsArray = Array.isArray(parsed) ? parsed : [trustedOrigins];
-				} catch {
-					originsArray = [trustedOrigins];
-				}
-			} else {
-				originsArray = [trustedOrigins];
-			}
-		}
-
-		// If wildcard is included, all origins are trusted
-		if (originsArray.includes('*')) {
-			return true;
-		}
-
-		// 1. Check exact match
-		const isExactMatch = originsArray.includes(origin);
-		if (isExactMatch) {
-			return true;
-		}
-
-		// 2. Check domain-based matching
-		try {
-			const originUrl = new URL(origin);
-			const originHostname = originUrl.hostname;
-
-			// Check if any trusted origin is just the hostname (without protocol)
-			if (originsArray.includes(originHostname)) {
-				return true;
-			}
-
-			return false;
-		} catch {
-			return false;
-		}
-	}
-}

package/src/integrations/next.ts

@@ -1,204 +0,0 @@
-import type { C15TInstance } from '~/core';
-import { ERROR_CODES } from '~/pkgs/results';
-import type { C15TContext } from '~/types';
-
-/**
- * Type definition for a Next.js route handler function
- */
-type RouteHandler = (request: Request) => Promise<Response>;
-
-/**
- * Type definition for Next.js route handlers object
- */
-type NextRouteHandlers = {
-	GET: RouteHandler;
-	POST: RouteHandler;
-	PUT: RouteHandler;
-	DELETE: RouteHandler;
-	OPTIONS: RouteHandler;
-	HEAD: RouteHandler;
-	PATCH: RouteHandler;
-};
-
-/**
- * Convert a c15t handler to a Next.js route handler.
- *
- * This adapter converts between standard Web API and c15t, letting c15t/H3 handle
- * all the HTTP logic including CORS. It doesn't depend on next/server.
- *
- * @example
- * ```typescript
- * import { toNextHandler } from '@c15t/backend/integrations/next';
- * import { c15t } from '@/c15t';
- *
- * // app/api/c15t/[...paths]/route.ts
- * export const { GET, POST } = toNextHandler(c15t);
- * ```
- *
- * @param instance - The c15t instance to adapt
- * @returns An object with Next.js route handler functions for each method
- */
-export function toNextHandler(instance: C15TInstance): NextRouteHandlers {
-	// Create the base handler that processes requests
-	const handleRequest = async (request: Request) => {
-		try {
-			const basePath: string =
-				(instance.options?.basePath as string) || '/api/c15t';
-
-			// Extract the path and rewrite for c15t routing
-			const originalUrl = new URL(request.url);
-			let pathWithoutBase = originalUrl.pathname;
-
-			if (pathWithoutBase.startsWith(basePath)) {
-				pathWithoutBase = pathWithoutBase.substring(basePath.length);
-				// Ensure leading slash
-				if (!pathWithoutBase.startsWith('/')) {
-					pathWithoutBase = `/${pathWithoutBase}`;
-				}
-			}
-
-			// Create rewritten request
-			const rewrittenUrl = new URL(originalUrl.toString());
-			rewrittenUrl.pathname = pathWithoutBase;
-
-			const rewrittenRequest = new Request(rewrittenUrl.toString(), {
-				method: request.method,
-				headers: request.headers,
-				body: request.body,
-				// Preserve request properties
-				credentials: 'include',
-				// Add duplex option when body is present
-				duplex: ['GET', 'HEAD'].includes(request.method) ? undefined : 'half',
-			});
-
-			// Update baseURL for proper URL generation in responses
-			await updateBaseUrl(request, basePath);
-
-			// Let c15t handle the request
-			const result = await instance.handler(rewrittenRequest);
-
-			// Return the response directly - Next.js supports standard Response objects
-			return await result.match(
-				// Success case - just return the response
-				(response) => response,
-				// Error case - create an error response
-				(error) => {
-					const status = error.statusCode || 500;
-					const message = error.message || ERROR_CODES.INTERNAL_SERVER_ERROR;
-
-					return new Response(
-						JSON.stringify({
-							error: true,
-							code: error.code || ERROR_CODES.INTERNAL_SERVER_ERROR,
-							message,
-							meta: error.meta,
-						}),
-						{
-							status,
-							headers: {
-								'Content-Type': 'application/json',
-							},
-						}
-					);
-				}
-			);
-		} catch (error) {
-			// Basic error handling
-			return new Response(
-				JSON.stringify({
-					error: true,
-					code: ERROR_CODES.INTERNAL_SERVER_ERROR,
-					message: 'An unexpected error occurred',
-					meta: { error: String(error) },
-				}),
-				{
-					status: 500,
-					headers: {
-						'Content-Type': 'application/json',
-					},
-				}
-			);
-		}
-	};
-
-	// Return an object with handler functions for each HTTP method
-	return {
-		GET: handleRequest,
-		POST: handleRequest,
-		PUT: handleRequest,
-		DELETE: handleRequest,
-		OPTIONS: handleRequest,
-		HEAD: handleRequest,
-		PATCH: handleRequest,
-	};
-
-	async function updateBaseUrl(
-		request: Request,
-		basePath: string
-	): Promise<void> {
-		if (!instance.$context) {
-			return;
-		}
-
-		try {
-			const contextResult = await instance.$context;
-
-			contextResult.match(
-				(context: C15TContext) => {
-					const url = new URL(request.url);
-					const baseURL = `${url.protocol}//${url.host}${basePath}`;
-
-					if (!context.baseURL || context.baseURL !== baseURL) {
-						context.baseURL = baseURL;
-						if (context.options) {
-							context.options.baseURL = baseURL;
-						}
-					}
-				},
-				() => {} // Ignore errors
-			);
-		} catch {
-			// Ignore errors
-		}
-	}
-}
-
-/**
- * Alternative Next.js route handler that works with any handler function.
- *
- * This utility function helps create Next.js App Router route handlers
- * from any function that accepts a Request and returns a Response.
- *
- * @example
- * ```typescript
- * // Using with c15t
- * import { toNextJsHandler } from '@c15t/backend/integrations/next';
- * import { c15t } from '@/c15t';
- *
- * // app/api/auth/[...slug]/route.ts
- * export const { GET, POST } = toNextJsHandler(c15t);
- *
- * // Using with a custom handler
- * export const { GET } = toNextJsHandler((request) => {
- *   return new Response('Hello World');
- * });
- * ```
- *
- * @param auth - Either a function or an object with a handler method
- * @returns An object with GET and POST methods for Next.js App Router
- */
-export function toNextJsHandler(
-	auth:
-		| {
-				handler: (request: Request) => Promise<Response>;
-		  }
-		| ((request: Request) => Promise<Response>)
-) {
-	const handler = async (request: Request) => {
-		return 'handler' in auth ? auth.handler(request) : auth(request);
-	};
-	return {
-		GET: handler,
-		POST: handler,
-	};
-}

package/src/integrations/node.ts

@@ -1,141 +0,0 @@
-import type { C15TInstance } from '~/core';
-import { ERROR_CODES } from '~/pkgs/results';
-import type { C15TContext } from '~/types';
-
-/**
- * Convert a c15t handler to a pure Node.js/Cloudflare Worker handler.
- *
- * This adapter converts between Web API Request/Response objects and c15t,
- * letting c15t/H3 handle all the HTTP logic including CORS.
- *
- * @example
- * ```typescript
- * // Node.js with standard Request/Response objects
- * import { toNodeHandler } from '@c15t/backend/integrations/node';
- * import { c15t } from './c15t';
- *
- * // Create the request handler
- * const handler = toNodeHandler(c15t);
- *
- * // Example for Cloudflare Worker
- * export default {
- *   async fetch(request, env, ctx) {
- *     return await handler(request);
- *   }
- * };
- * ```
- *
- * @param instance - The c15t instance to adapt
- * @returns A handler function that takes a Request and returns a Response
- */
-export function toNodeHandler(instance: C15TInstance) {
-	return async (request: Request): Promise<Response> => {
-		try {
-			const basePath: string =
-				(instance.options?.basePath as string) || '/api/c15t';
-
-			// Extract the path and rewrite for c15t routing
-			const originalUrl = new URL(request.url);
-			let pathWithoutBase = originalUrl.pathname;
-
-			if (pathWithoutBase.startsWith(basePath)) {
-				pathWithoutBase = pathWithoutBase.substring(basePath.length);
-				// Ensure leading slash
-				if (!pathWithoutBase.startsWith('/')) {
-					pathWithoutBase = `/${pathWithoutBase}`;
-				}
-			}
-
-			// Create rewritten request
-			const rewrittenUrl = new URL(originalUrl.toString());
-			rewrittenUrl.pathname = pathWithoutBase;
-
-			const rewrittenRequest = new Request(rewrittenUrl.toString(), {
-				method: request.method,
-				headers: request.headers,
-				body: request.body,
-				// Preserve request properties
-				credentials: 'include',
-				duplex: ['GET', 'HEAD'].includes(request.method) ? undefined : 'half',
-			});
-
-			// Update baseURL for proper URL generation in responses
-			await updateBaseUrl(request, basePath);
-
-			// Let c15t handle the request
-			const result = await instance.handler(rewrittenRequest);
-
-			// Convert c15t response to standard Response
-			return await result.match(
-				// Success case - just return the response
-				(response) => response,
-				// Error case - create an error response
-				(error) => {
-					const status = error.statusCode || 500;
-					const message = error.message || ERROR_CODES.INTERNAL_SERVER_ERROR;
-
-					return new Response(
-						JSON.stringify({
-							error: true,
-							code: error.code || ERROR_CODES.INTERNAL_SERVER_ERROR,
-							message,
-							meta: error.meta,
-						}),
-						{
-							status,
-							headers: {
-								'Content-Type': 'application/json',
-							},
-						}
-					);
-				}
-			);
-		} catch (error) {
-			// Basic error handling
-			return new Response(
-				JSON.stringify({
-					error: true,
-					code: ERROR_CODES.INTERNAL_SERVER_ERROR,
-					message: 'An unexpected error occurred',
-					meta: { error: String(error) },
-				}),
-				{
-					status: 500,
-					headers: {
-						'Content-Type': 'application/json',
-					},
-				}
-			);
-		}
-	};
-
-	async function updateBaseUrl(
-		request: Request,
-		basePath: string
-	): Promise<void> {
-		if (!instance.$context) {
-			return;
-		}
-
-		try {
-			const contextResult = await instance.$context;
-
-			contextResult.match(
-				(context: C15TContext) => {
-					const url = new URL(request.url);
-					const baseURL = `${url.protocol}//${url.host}${basePath}`;
-
-					if (!context.baseURL || context.baseURL !== baseURL) {
-						context.baseURL = baseURL;
-						if (context.options) {
-							context.options.baseURL = baseURL;
-						}
-					}
-				},
-				() => {} // Ignore errors
-			);
-		} catch {
-			// Ignore errors
-		}
-	}
-}