@mandujs/core 0.54.12 → 0.54.13

package/src/runtime/__tests__/request-middleware.test.ts

@@ -1,70 +1,70 @@
-import { describe, expect, it } from "bun:test";
-import { defineMiddleware } from "../../middleware/define";
-import {
-  buildRequestMiddlewareChain,
-  runRequestMiddleware,
-} from "../request-middleware";
-
-const req = new Request("https://example.test/api/echo");
-
-describe("runtime request middleware wiring", () => {
-  it("keeps the no-middleware path unset for hot-path passthrough", () => {
-    expect(buildRequestMiddlewareChain(undefined)).toBeUndefined();
-    expect(buildRequestMiddlewareChain([])).toBeUndefined();
-  });
-
-  it("returns undefined when there is no chain or middleware is skipped", async () => {
-    let finalHits = 0;
-    const finalHandler = async (): Promise<Response> => {
-      finalHits++;
-      return new Response("ok");
-    };
-    const middlewareChain = buildRequestMiddlewareChain([
-      defineMiddleware({
-        name: "marker",
-        handler: async (_req, next) => next(),
-      }),
-    ]);
-
-    await expect(
-      runRequestMiddleware({ req, middlewareChain: undefined, finalHandler })
-    ).resolves.toBeUndefined();
-    await expect(
-      runRequestMiddleware({
-        req,
-        middlewareChain,
-        finalHandler,
-        skipMiddleware: true,
-      })
-    ).resolves.toBeUndefined();
-    expect(finalHits).toBe(0);
-  });
-
-  it("dispatches through the composed chain when configured", async () => {
-    const trace: string[] = [];
-    const middlewareChain = buildRequestMiddlewareChain([
-      defineMiddleware({
-        name: "outer",
-        handler: async (_req, next) => {
-          trace.push("before");
-          const response = await next();
-          trace.push("after");
-          return response;
-        },
-      }),
-    ]);
-
-    const response = await runRequestMiddleware({
-      req,
-      middlewareChain,
-      finalHandler: async () => {
-        trace.push("final");
-        return new Response("ok");
-      },
-    });
-
-    expect(response?.status).toBe(200);
-    expect(await response?.text()).toBe("ok");
-    expect(trace).toEqual(["before", "final", "after"]);
-  });
-});
+import { describe, expect, it } from "bun:test";
+import { defineMiddleware } from "../../middleware/define";
+import {
+  buildRequestMiddlewareChain,
+  runRequestMiddleware,
+} from "../request-middleware";
+
+const req = new Request("https://example.test/api/echo");
+
+describe("runtime request middleware wiring", () => {
+  it("keeps the no-middleware path unset for hot-path passthrough", () => {
+    expect(buildRequestMiddlewareChain(undefined)).toBeUndefined();
+    expect(buildRequestMiddlewareChain([])).toBeUndefined();
+  });
+
+  it("returns undefined when there is no chain or middleware is skipped", async () => {
+    let finalHits = 0;
+    const finalHandler = async (): Promise<Response> => {
+      finalHits++;
+      return new Response("ok");
+    };
+    const middlewareChain = buildRequestMiddlewareChain([
+      defineMiddleware({
+        name: "marker",
+        handler: async (_req, next) => next(),
+      }),
+    ]);
+
+    await expect(
+      runRequestMiddleware({ req, middlewareChain: undefined, finalHandler })
+    ).resolves.toBeUndefined();
+    await expect(
+      runRequestMiddleware({
+        req,
+        middlewareChain,
+        finalHandler,
+        skipMiddleware: true,
+      })
+    ).resolves.toBeUndefined();
+    expect(finalHits).toBe(0);
+  });
+
+  it("dispatches through the composed chain when configured", async () => {
+    const trace: string[] = [];
+    const middlewareChain = buildRequestMiddlewareChain([
+      defineMiddleware({
+        name: "outer",
+        handler: async (_req, next) => {
+          trace.push("before");
+          const response = await next();
+          trace.push("after");
+          return response;
+        },
+      }),
+    ]);
+
+    const response = await runRequestMiddleware({
+      req,
+      middlewareChain,
+      finalHandler: async () => {
+        trace.push("final");
+        return new Response("ok");
+      },
+    });
+
+    expect(response?.status).toBe(200);
+    expect(await response?.text()).toBe("ok");
+    expect(trace).toEqual(["before", "final", "after"]);
+  });
+});

package/src/runtime/devtools-adapter.ts

@@ -1,68 +1,68 @@
-import type { RoutesManifest } from "../spec/schema";
-import type { GuardConfig } from "../guard/types";
-import {
-  KITCHEN_PREFIX,
-  KitchenHandler,
-  recordRequest,
-  type RequestEntry,
-} from "../kitchen/kitchen-handler";
-
-export type RuntimeKitchenHandler = KitchenHandler;
-
-export interface RuntimeDevtoolsAdapter {
-  readonly kitchen: RuntimeKitchenHandler | null;
-  readonly dashboardPath: string | null;
-  start(): void;
-  stop(): void;
-  updateManifest(manifest: RoutesManifest): void;
-  handleRequest(req: Request, pathname: string): Promise<Response | null>;
-}
-
-export interface CreateRuntimeDevtoolsAdapterOptions {
-  isDev: boolean;
-  rootDir: string;
-  manifest: RoutesManifest;
-  guardConfig: GuardConfig | null;
-}
-
-export function createRuntimeDevtoolsAdapter(
-  options: CreateRuntimeDevtoolsAdapterOptions
-): RuntimeDevtoolsAdapter {
-  const kitchen = options.isDev
-    ? new KitchenHandler({
-      rootDir: options.rootDir,
-      manifest: options.manifest,
-      guardConfig: options.guardConfig,
-    })
-    : null;
-
-  return {
-    kitchen,
-    dashboardPath: kitchen ? KITCHEN_PREFIX : null,
-    start() {
-      if (kitchen) void kitchen.start();
-    },
-    stop() {
-      kitchen?.stop();
-    },
-    updateManifest(manifest: RoutesManifest) {
-      kitchen?.updateManifest(manifest);
-    },
-    async handleRequest(req: Request, pathname: string): Promise<Response | null> {
-      if (!kitchen || !pathname.startsWith(KITCHEN_PREFIX)) return null;
-      return await kitchen.handle(req, pathname);
-    },
-  };
-}
-
-export function shouldRecordRuntimeRequest(pathname: string): boolean {
-  return (
-    !pathname.startsWith("/.mandu/") &&
-    !pathname.startsWith(KITCHEN_PREFIX) &&
-    !pathname.startsWith("/__mandu/")
-  );
-}
-
-export function recordRuntimeRequest(entry: RequestEntry): void {
-  recordRequest(entry);
-}
+import type { RoutesManifest } from "../spec/schema";
+import type { GuardConfig } from "../guard/types";
+import {
+  KITCHEN_PREFIX,
+  KitchenHandler,
+  recordRequest,
+  type RequestEntry,
+} from "../kitchen/kitchen-handler";
+
+export type RuntimeKitchenHandler = KitchenHandler;
+
+export interface RuntimeDevtoolsAdapter {
+  readonly kitchen: RuntimeKitchenHandler | null;
+  readonly dashboardPath: string | null;
+  start(): void;
+  stop(): void;
+  updateManifest(manifest: RoutesManifest): void;
+  handleRequest(req: Request, pathname: string): Promise<Response | null>;
+}
+
+export interface CreateRuntimeDevtoolsAdapterOptions {
+  isDev: boolean;
+  rootDir: string;
+  manifest: RoutesManifest;
+  guardConfig: GuardConfig | null;
+}
+
+export function createRuntimeDevtoolsAdapter(
+  options: CreateRuntimeDevtoolsAdapterOptions
+): RuntimeDevtoolsAdapter {
+  const kitchen = options.isDev
+    ? new KitchenHandler({
+      rootDir: options.rootDir,
+      manifest: options.manifest,
+      guardConfig: options.guardConfig,
+    })
+    : null;
+
+  return {
+    kitchen,
+    dashboardPath: kitchen ? KITCHEN_PREFIX : null,
+    start() {
+      if (kitchen) void kitchen.start();
+    },
+    stop() {
+      kitchen?.stop();
+    },
+    updateManifest(manifest: RoutesManifest) {
+      kitchen?.updateManifest(manifest);
+    },
+    async handleRequest(req: Request, pathname: string): Promise<Response | null> {
+      if (!kitchen || !pathname.startsWith(KITCHEN_PREFIX)) return null;
+      return await kitchen.handle(req, pathname);
+    },
+  };
+}
+
+export function shouldRecordRuntimeRequest(pathname: string): boolean {
+  return (
+    !pathname.startsWith("/.mandu/") &&
+    !pathname.startsWith(KITCHEN_PREFIX) &&
+    !pathname.startsWith("/__mandu/")
+  );
+}
+
+export function recordRuntimeRequest(entry: RequestEntry): void {
+  recordRequest(entry);
+}

package/src/runtime/escape.ts

@@ -3,40 +3,40 @@
  * <title>, <p> 등 텍스트 노드에 들어갈 문자열을 안전하게 처리.
  * 속성값과 달리 " ' 는 이스케이프 불필요.
  */
-export function escapeHtmlText(value: string): string {
-  return value
-    .replace(/&/g, "&amp;")
-    .replace(/</g, "&lt;")
-    .replace(/>/g, "&gt;");
-}
-
-/**
- * Decode the small HTML entity set React can emit inside text metadata.
- * Callers should still escape the returned string before writing HTML.
- */
-export function decodeHtmlText(value: string): string {
-  return value.replace(/&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos|#39);/gi, (match, entity: string) => {
-    const normalized = entity.toLowerCase();
-    if (normalized === "amp") return "&";
-    if (normalized === "lt") return "<";
-    if (normalized === "gt") return ">";
-    if (normalized === "quot") return '"';
-    if (normalized === "apos" || normalized === "#39") return "'";
-    if (normalized.startsWith("#x")) {
-      const codePoint = Number.parseInt(normalized.slice(2), 16);
-      return isValidCodePoint(codePoint) ? String.fromCodePoint(codePoint) : match;
-    }
-    if (normalized.startsWith("#")) {
-      const codePoint = Number.parseInt(normalized.slice(1), 10);
-      return isValidCodePoint(codePoint) ? String.fromCodePoint(codePoint) : match;
-    }
-    return match;
-  });
-}
-
-function isValidCodePoint(value: number): boolean {
-  return Number.isInteger(value) && value >= 0 && value <= 0x10ffff;
-}
+export function escapeHtmlText(value: string): string {
+  return value
+    .replace(/&/g, "&amp;")
+    .replace(/</g, "&lt;")
+    .replace(/>/g, "&gt;");
+}
+
+/**
+ * Decode the small HTML entity set React can emit inside text metadata.
+ * Callers should still escape the returned string before writing HTML.
+ */
+export function decodeHtmlText(value: string): string {
+  return value.replace(/&(#x[0-9a-f]+|#\d+|amp|lt|gt|quot|apos|#39);/gi, (match, entity: string) => {
+    const normalized = entity.toLowerCase();
+    if (normalized === "amp") return "&";
+    if (normalized === "lt") return "<";
+    if (normalized === "gt") return ">";
+    if (normalized === "quot") return '"';
+    if (normalized === "apos" || normalized === "#39") return "'";
+    if (normalized.startsWith("#x")) {
+      const codePoint = Number.parseInt(normalized.slice(2), 16);
+      return isValidCodePoint(codePoint) ? String.fromCodePoint(codePoint) : match;
+    }
+    if (normalized.startsWith("#")) {
+      const codePoint = Number.parseInt(normalized.slice(1), 10);
+      return isValidCodePoint(codePoint) ? String.fromCodePoint(codePoint) : match;
+    }
+    return match;
+  });
+}
+
+function isValidCodePoint(value: number): boolean {
+  return Number.isInteger(value) && value >= 0 && value <= 0x10ffff;
+}
 
 /**
  * HTML 속성값 이스케이프

package/src/runtime/image-feature.ts

@@ -0,0 +1,15 @@
+export async function maybeHandleImageFeatureRequest(
+  request: Request,
+  settings: {
+    edge?: boolean;
+    rootDir: string;
+    publicDir: string;
+  },
+): Promise<Response | null> {
+  if (settings.edge) return null;
+  const pathname = new URL(request.url).pathname;
+  if (pathname !== "/_mandu/image") return null;
+
+  const { handleImageRequest } = await import("./image-handler");
+  return await handleImageRequest(request, settings.rootDir, settings.publicDir);
+}