@ecopages/core 0.2.0-beta.31 → 0.2.0-beta.32

package/src/adapters/shared/http/api-request-pipeline.js

@@ -1,129 +1,132 @@
-import { createRequire } from "../../../utils/locals-utils.js";
-import { HttpError } from "../../../errors/http-error.js";
-import { ApiResponseBuilder } from "./api-response.js";
-import { runMiddlewareChain } from "./run-middleware-chain.js";
-import { matchApiPathPattern, scoreApiPathPattern } from "../../abstract/segment-path-matcher.js";
-import { appLogger } from "../../../global/app-logger.js";
-class ApiRequestPipeline {
-  schemaValidator;
-  getRenderContext;
-  getCacheService;
-  constructor(options) {
-    this.schemaValidator = options.schemaValidator;
-    this.getRenderContext = options.getRenderContext;
-    this.getCacheService = options.getCacheService;
-  }
-  match(request, apiHandlers) {
-    const pathname = new URL(request.url).pathname;
-    const method = request.method.toUpperCase();
-    const sortedHandlers = [...apiHandlers].sort((a, b) => {
-      return scoreApiPathPattern(b.path) - scoreApiPathPattern(a.path);
-    });
-    for (const routeConfig of sortedHandlers) {
-      const routeMethod = (routeConfig.method || "GET").toUpperCase();
-      if (routeMethod !== method) {
-        continue;
-      }
-      const params = matchApiPathPattern(routeConfig.path, pathname);
-      if (params) {
-        return { routeConfig, params };
-      }
+import { createRequire } from '../../../utils/locals-utils.js';
+import { HttpError } from '../../../errors/http-error.js';
+import { ApiResponseBuilder } from './api-response.js';
+import { runMiddlewareChain } from './run-middleware-chain.js';
+import { matchApiPathPattern, scoreApiPathPattern } from '../../abstract/segment-path-matcher.js';
+import { appLogger } from '../../../global/app-logger.js';
+export class ApiRequestPipeline {
+    schemaValidator;
+    getRenderContext;
+    getCacheService;
+    constructor(options) {
+        this.schemaValidator = options.schemaValidator;
+        this.getRenderContext = options.getRenderContext;
+        this.getCacheService = options.getCacheService;
     }
-    return null;
-  }
-  async tryHandle(request, apiHandlers, serverInstance, errorHandler) {
-    const apiMatch = this.match(request, apiHandlers);
-    if (!apiMatch) {
-      return null;
+    match(request, apiHandlers) {
+        const pathname = new URL(request.url).pathname;
+        const method = request.method.toUpperCase();
+        const sortedHandlers = [...apiHandlers].sort((a, b) => {
+            return scoreApiPathPattern(b.path) - scoreApiPathPattern(a.path);
+        });
+        for (const routeConfig of sortedHandlers) {
+            const routeMethod = (routeConfig.method || 'GET').toUpperCase();
+            if (routeMethod !== method) {
+                continue;
+            }
+            const params = matchApiPathPattern(routeConfig.path, pathname);
+            if (params) {
+                return { routeConfig, params };
+            }
+        }
+        return null;
+    }
+    async tryHandle(request, apiHandlers, serverInstance, errorHandler) {
+        const apiMatch = this.match(request, apiHandlers);
+        if (!apiMatch) {
+            return null;
+        }
+        return await this.execute(request, apiMatch.params, apiMatch.routeConfig, serverInstance, errorHandler);
     }
-    return await this.execute(request, apiMatch.params, apiMatch.routeConfig, serverInstance, errorHandler);
-  }
-  async execute(request, params, routeConfig, serverInstance, errorHandler) {
-    let context;
-    try {
-      context = this.createContext(request, params, serverInstance);
-      const schemaResponse = await this.applyRequestSchema(context, routeConfig.schema);
-      if (schemaResponse) {
-        return schemaResponse;
-      }
-      return await this.runMiddlewareChain(context, routeConfig);
-    } catch (error) {
-      if (error instanceof Response) return error;
-      if (errorHandler) {
+    async execute(request, params, routeConfig, serverInstance, errorHandler) {
+        let context;
         try {
-          if (!context) {
             context = this.createContext(request, params, serverInstance);
-          }
-          return await errorHandler(error, context);
-        } catch (handlerError) {
-          appLogger.error(`[ecopages] Error in custom error handler: ${handlerError}`);
+            const schemaResponse = await this.applyRequestSchema(context, routeConfig.schema);
+            if (schemaResponse) {
+                return schemaResponse;
+            }
+            return await this.runMiddlewareChain(context, routeConfig);
+        }
+        catch (error) {
+            if (error instanceof Response)
+                return error;
+            if (errorHandler) {
+                try {
+                    if (!context) {
+                        context = this.createContext(request, params, serverInstance);
+                    }
+                    return await errorHandler(error, context);
+                }
+                catch (handlerError) {
+                    appLogger.error(`[ecopages] Error in custom error handler: ${handlerError}`);
+                }
+            }
+            if (error instanceof HttpError)
+                return error.toResponse();
+            appLogger.error(`[ecopages] Error handling API request: ${error}`);
+            return new Response('Internal Server Error', { status: 500 });
         }
-      }
-      if (error instanceof HttpError) return error.toResponse();
-      appLogger.error(`[ecopages] Error handling API request: ${error}`);
-      return new Response("Internal Server Error", { status: 500 });
     }
-  }
-  createContext(request, params, serverInstance) {
-    const locals = {};
-    const normalizedParams = this.normalizeParams(params);
-    return {
-      request,
-      params: normalizedParams,
-      response: new ApiResponseBuilder(),
-      server: serverInstance,
-      locals,
-      require: createRequire(() => locals),
-      services: {
-        cache: this.getCacheService()
-      },
-      ...this.getRenderContext()
-    };
-  }
-  normalizeParams(params) {
-    return Object.fromEntries(
-      Object.entries(params).map(([key, value]) => [key, Array.isArray(value) ? value.join("/") : value])
-    );
-  }
-  async applyRequestSchema(context, schema) {
-    if (!schema) {
-      return void 0;
+    createContext(request, params, serverInstance) {
+        const locals = {};
+        const normalizedParams = this.normalizeParams(params);
+        return {
+            request,
+            params: normalizedParams,
+            response: new ApiResponseBuilder(),
+            server: serverInstance,
+            locals,
+            require: createRequire(() => locals),
+            services: {
+                cache: this.getCacheService(),
+            },
+            ...this.getRenderContext(),
+        };
     }
-    const url = new URL(context.request.url);
-    const queryParams = Object.fromEntries(url.searchParams);
-    const headers = Object.fromEntries(context.request.headers);
-    let body;
-    if (schema.body) {
-      try {
-        const contentType = context.request.headers.get("Content-Type") || "";
-        if (contentType.includes("application/json")) body = await context.request.clone().json();
-        else if (contentType.includes("text/plain")) body = await context.request.clone().text();
-      } catch {
-        return context.response.status(400).json({ error: "Invalid request body" });
-      }
+    normalizeParams(params) {
+        return Object.fromEntries(Object.entries(params).map(([key, value]) => [key, Array.isArray(value) ? value.join('/') : value]));
+    }
+    async applyRequestSchema(context, schema) {
+        if (!schema) {
+            return undefined;
+        }
+        const url = new URL(context.request.url);
+        const queryParams = Object.fromEntries(url.searchParams);
+        const headers = Object.fromEntries(context.request.headers);
+        let body;
+        if (schema.body) {
+            try {
+                const contentType = context.request.headers.get('Content-Type') || '';
+                if (contentType.includes('application/json'))
+                    body = await context.request.clone().json();
+                else if (contentType.includes('text/plain'))
+                    body = await context.request.clone().text();
+            }
+            catch {
+                return context.response.status(400).json({ error: 'Invalid request body' });
+            }
+        }
+        const validationResult = await this.schemaValidator.validateRequest({ body, query: queryParams, headers, params: context.params }, schema);
+        if (!validationResult.success) {
+            return context.response.status(400).json({
+                error: 'Validation failed',
+                issues: validationResult.errors,
+            });
+        }
+        const validated = validationResult.data;
+        if (validated.body !== undefined)
+            context.body = validated.body;
+        if (validated.query !== undefined)
+            context.query = validated.query;
+        if (validated.headers !== undefined)
+            context.headers = validated.headers;
+        if (validated.params !== undefined)
+            context.params = validated.params;
+        return undefined;
     }
-    const validationResult = await this.schemaValidator.validateRequest(
-      { body, query: queryParams, headers, params: context.params },
-      schema
-    );
-    if (!validationResult.success) {
-      return context.response.status(400).json({
-        error: "Validation failed",
-        issues: validationResult.errors
-      });
+    async runMiddlewareChain(context, routeConfig) {
+        const middleware = routeConfig.middleware ?? [];
+        return runMiddlewareChain(middleware, context, async () => await routeConfig.handler(context));
     }
-    const validated = validationResult.data;
-    if (validated.body !== void 0) context.body = validated.body;
-    if (validated.query !== void 0) context.query = validated.query;
-    if (validated.headers !== void 0) context.headers = validated.headers;
-    if (validated.params !== void 0) context.params = validated.params;
-    return void 0;
-  }
-  async runMiddlewareChain(context, routeConfig) {
-    const middleware = routeConfig.middleware ?? [];
-    return runMiddlewareChain(middleware, context, async () => await routeConfig.handler(context));
-  }
 }
-export {
-  ApiRequestPipeline
-};

package/src/adapters/shared/http/api-response.js

@@ -1,79 +1,79 @@
-import { createBodyResponse } from "./create-body-response.js";
-class ApiResponseBuilder {
-  _status = 200;
-  _headers = new Headers();
-  /**
-   * Sets the HTTP status code for the response.
-   * @param code - The HTTP status code.
-   * @returns The builder instance for chaining.
-   */
-  status(code) {
-    this._status = code;
-    return this;
-  }
-  /**
-   * Adds or merges headers for the response.
-   * @param headersInit - Headers to add or merge.
-   * @returns The builder instance for chaining.
-   */
-  headers(headersInit) {
-    const inputHeaders = new Headers(headersInit);
-    inputHeaders.forEach((value, key) => {
-      this._headers.set(key, value);
-    });
-    return this;
-  }
-  /**
-   * Creates a JSON response using the configured status and headers.
-   * @param data - The data to serialize.
-   * @returns A Response object.
-   */
-  json(data) {
-    return createBodyResponse("json", data, { status: this._status, headers: this._headers });
-  }
-  /**
-   * Creates a plain text response using the configured status and headers.
-   * @param data - The text content.
-   * @returns A Response object.
-   */
-  text(data) {
-    return createBodyResponse("text", data, { status: this._status, headers: this._headers });
-  }
-  /**
-   * Creates an HTML response using the configured status and headers.
-   * @param data - The HTML content.
-   * @returns A Response object.
-   */
-  html(data) {
-    return createBodyResponse("html", data, { status: this._status, headers: this._headers });
-  }
-  /**
-   * Creates a redirect response.
-   * @param url - The URL to redirect to.
-   * @param explicitStatus - Optional explicit status code (overrides status() if provided). Defaults to 302 if not set via status().
-   * @returns A Response object.
-   */
-  redirect(url, explicitStatus) {
-    const redirectStatus = explicitStatus ?? (this._status === 200 ? 302 : this._status);
-    this._headers.set("Location", url);
-    return new Response(null, { status: redirectStatus, headers: this._headers });
-  }
-  /**
-   * Creates an error response using the configured status and headers.
-   * If data is an object, it's treated as JSON, otherwise as text.
-   * @param data - The error data (string or object).
-   * @param explicitStatus - Optional explicit status code (overrides status() if provided). Defaults to 500 if not set via status().
-   * @returns A Response object.
-   */
-  error(data, explicitStatus) {
-    const errorStatus = explicitStatus ?? (this._status === 200 ? 500 : this._status);
-    this.status(errorStatus);
-    if (typeof data === "object" && data !== null) {
-      return createBodyResponse("json", { error: data }, { status: this._status, headers: this._headers });
+import { createBodyResponse } from './create-body-response.js';
+/**
+ * A builder class for creating Response objects fluently.
+ */
+export class ApiResponseBuilder {
+    _status = 200;
+    _headers = new Headers();
+    /**
+     * Sets the HTTP status code for the response.
+     * @param code - The HTTP status code.
+     * @returns The builder instance for chaining.
+     */
+    status(code) {
+        this._status = code;
+        return this;
+    }
+    /**
+     * Adds or merges headers for the response.
+     * @param headersInit - Headers to add or merge.
+     * @returns The builder instance for chaining.
+     */
+    headers(headersInit) {
+        const inputHeaders = new Headers(headersInit);
+        inputHeaders.forEach((value, key) => {
+            this._headers.set(key, value);
+        });
+        return this;
+    }
+    /**
+     * Creates a JSON response using the configured status and headers.
+     * @param data - The data to serialize.
+     * @returns A Response object.
+     */
+    json(data) {
+        return createBodyResponse('json', data, { status: this._status, headers: this._headers });
+    }
+    /**
+     * Creates a plain text response using the configured status and headers.
+     * @param data - The text content.
+     * @returns A Response object.
+     */
+    text(data) {
+        return createBodyResponse('text', data, { status: this._status, headers: this._headers });
+    }
+    /**
+     * Creates an HTML response using the configured status and headers.
+     * @param data - The HTML content.
+     * @returns A Response object.
+     */
+    html(data) {
+        return createBodyResponse('html', data, { status: this._status, headers: this._headers });
+    }
+    /**
+     * Creates a redirect response.
+     * @param url - The URL to redirect to.
+     * @param explicitStatus - Optional explicit status code (overrides status() if provided). Defaults to 302 if not set via status().
+     * @returns A Response object.
+     */
+    redirect(url, explicitStatus) {
+        const redirectStatus = explicitStatus ?? (this._status === 200 ? 302 : this._status); // Default to 302 if status wasn't explicitly set
+        this._headers.set('Location', url);
+        return new Response(null, { status: redirectStatus, headers: this._headers });
+    }
+    /**
+     * Creates an error response using the configured status and headers.
+     * If data is an object, it's treated as JSON, otherwise as text.
+     * @param data - The error data (string or object).
+     * @param explicitStatus - Optional explicit status code (overrides status() if provided). Defaults to 500 if not set via status().
+     * @returns A Response object.
+     */
+    error(data, explicitStatus) {
+        const errorStatus = explicitStatus ?? (this._status === 200 ? 500 : this._status); // Default to 500 if status wasn't explicitly set
+        this.status(errorStatus);
+        if (typeof data === 'object' && data !== null) {
+            return createBodyResponse('json', { error: data }, { status: this._status, headers: this._headers });
+        }
+        return createBodyResponse('text', String(data), { status: this._status, headers: this._headers });
     }
-    return createBodyResponse("text", String(data), { status: this._status, headers: this._headers });
-  }
 }
-export {
-  ApiResponseBuilder
-};

package/src/adapters/shared/http/create-body-response.js

@@ -1,23 +1,26 @@
-function createBodyResponse(kind, data, init) {
-  const headers = new Headers(init?.headers);
-  const status = init?.status ?? 200;
-  if (kind === "json") {
-    if (!headers.has("Content-Type")) {
-      headers.set("Content-Type", "application/json; charset=utf-8");
+/**
+ * Builds a typed HTTP response body for JSON, HTML, or plain text.
+ *
+ * @remarks
+ * Sole internal emission path for adapter response helpers. Not exported from `@ecopages/core`.
+ */
+export function createBodyResponse(kind, data, init) {
+    const headers = new Headers(init?.headers);
+    const status = init?.status ?? 200;
+    if (kind === 'json') {
+        if (!headers.has('Content-Type')) {
+            headers.set('Content-Type', 'application/json; charset=utf-8');
+        }
+        return new Response(JSON.stringify(data), { status, headers });
     }
-    return new Response(JSON.stringify(data), { status, headers });
-  }
-  if (kind === "html") {
-    if (!headers.has("Content-Type")) {
-      headers.set("Content-Type", "text/html; charset=utf-8");
+    if (kind === 'html') {
+        if (!headers.has('Content-Type')) {
+            headers.set('Content-Type', 'text/html; charset=utf-8');
+        }
+        return new Response(String(data), { status, headers });
+    }
+    if (!headers.has('Content-Type')) {
+        headers.set('Content-Type', 'text/plain; charset=utf-8');
     }
     return new Response(String(data), { status, headers });
-  }
-  if (!headers.has("Content-Type")) {
-    headers.set("Content-Type", "text/plain; charset=utf-8");
-  }
-  return new Response(String(data), { status, headers });
 }
-export {
-  createBodyResponse
-};

package/src/adapters/shared/http/define-api-handler.js

@@ -1,63 +1,49 @@
-import { createBodyResponse } from "./create-body-response.js";
-function defineApiHandler(handler) {
-  return handler;
+import { createBodyResponse } from './create-body-response.js';
+export function defineApiHandler(handler) {
+    return handler;
 }
 const defineApiMethod = (method) => (handler) => defineApiHandler({ ...handler, method });
-const defineGet = defineApiMethod("GET");
-const definePost = defineApiMethod("POST");
-const definePut = defineApiMethod("PUT");
-const defineDelete = defineApiMethod("DELETE");
-const definePatch = defineApiMethod("PATCH");
-const defineOptions = defineApiMethod("OPTIONS");
-const defineHead = defineApiMethod("HEAD");
-function json(data, options) {
-  return createBodyResponse("json", data, {
-    status: options?.status,
-    headers: options?.headers
-  });
+export const defineGet = defineApiMethod('GET');
+export const definePost = defineApiMethod('POST');
+export const definePut = defineApiMethod('PUT');
+export const defineDelete = defineApiMethod('DELETE');
+export const definePatch = defineApiMethod('PATCH');
+export const defineOptions = defineApiMethod('OPTIONS');
+export const defineHead = defineApiMethod('HEAD');
+export function json(data, options) {
+    return createBodyResponse('json', data, {
+        status: options?.status,
+        headers: options?.headers,
+    });
 }
-function html(content, options) {
-  return createBodyResponse("html", content, {
-    status: options?.status,
-    headers: options?.headers
-  });
+export function html(content, options) {
+    return createBodyResponse('html', content, {
+        status: options?.status,
+        headers: options?.headers,
+    });
 }
-function redirect(url, status = 302) {
-  return new Response(null, {
-    status,
-    headers: { Location: url }
-  });
+export function redirect(url, status = 302) {
+    return new Response(null, {
+        status,
+        headers: { Location: url },
+    });
 }
 function createGroupApi() {
-  const define = ((handler) => handler);
-  return Object.assign(define, {
-    get: defineApiMethod("GET"),
-    post: defineApiMethod("POST"),
-    put: defineApiMethod("PUT"),
-    delete: defineApiMethod("DELETE"),
-    patch: defineApiMethod("PATCH"),
-    options: defineApiMethod("OPTIONS"),
-    head: defineApiMethod("HEAD")
-  });
+    const define = ((handler) => handler);
+    return Object.assign(define, {
+        get: defineApiMethod('GET'),
+        post: defineApiMethod('POST'),
+        put: defineApiMethod('PUT'),
+        delete: defineApiMethod('DELETE'),
+        patch: defineApiMethod('PATCH'),
+        options: defineApiMethod('OPTIONS'),
+        head: defineApiMethod('HEAD'),
+    });
 }
-function defineGroupHandler(config) {
-  return {
-    prefix: config.prefix,
-    middleware: config.middleware,
-    routes: config.routes(createGroupApi())
-  };
+export function defineGroupHandler(config) {
+    return {
+        prefix: config.prefix,
+        middleware: config.middleware,
+        routes: config.routes(createGroupApi()),
+    };
 }
-export {
-  defineApiHandler,
-  defineDelete,
-  defineGet,
-  defineGroupHandler,
-  defineHead,
-  defineOptions,
-  definePatch,
-  definePost,
-  definePut,
-  html,
-  json,
-  redirect
-};

package/src/adapters/shared/http/explicit-static-render-preparation.js

@@ -1,26 +1,29 @@
 function getViewIntegrationName(view) {
-  return view.config?.integration ?? view.config?.__eco?.integration;
+    return view.config?.integration ?? view.config?.__eco?.integration;
 }
-async function prepareExplicitStaticRender(input) {
-  const integrationName = getViewIntegrationName(input.view);
-  if (!integrationName) {
-    throw new Error(input.errors.missingIntegration(input.routePath));
-  }
-  const renderer = input.routeRendererFactory.getExplicitViewRenderer(integrationName);
-  if (!renderer) {
-    throw new Error(input.errors.noRendererForIntegration(integrationName));
-  }
-  const props = input.view.staticProps ? (await input.view.staticProps({
-    pathname: { params: input.params },
-    appConfig: input.appConfig,
-    runtimeOrigin: input.runtimeOrigin
-  })).props : {};
-  return {
-    renderer,
-    props,
-    view: input.view
-  };
+/**
+ * Resolves the renderer and static props needed to render one explicit static
+ * view at runtime or during static generation.
+ */
+export async function prepareExplicitStaticRender(input) {
+    const integrationName = getViewIntegrationName(input.view);
+    if (!integrationName) {
+        throw new Error(input.errors.missingIntegration(input.routePath));
+    }
+    const renderer = input.routeRendererFactory.getExplicitViewRenderer(integrationName);
+    if (!renderer) {
+        throw new Error(input.errors.noRendererForIntegration(integrationName));
+    }
+    const props = input.view.staticProps
+        ? (await input.view.staticProps({
+            pathname: { params: input.params },
+            appConfig: input.appConfig,
+            runtimeOrigin: input.runtimeOrigin,
+        })).props
+        : {};
+    return {
+        renderer,
+        props,
+        view: input.view,
+    };
 }
-export {
-  prepareExplicitStaticRender
-};