perf-skill 0.0.1 → 0.2.0

package/dist/profile/preload.js

@@ -0,0 +1,100 @@
+import { mkdirSync, writeFileSync } from "node:fs";
+import { dirname, resolve } from "node:path";
+import { parseDurationMs } from "./duration.js";
+function parsePositiveInt(value, fallback) {
+    if (!value)
+        return fallback;
+    const parsed = Number.parseInt(value, 10);
+    if (!Number.isFinite(parsed) || parsed <= 0)
+        return fallback;
+    return parsed;
+}
+const durationMs = parseDurationMs(process.env.PERF_SKILL_DURATION_MS, 10_000);
+const profileOut = resolve(process.env.PERF_SKILL_PROFILE_OUT ?? "cpu.pb.gz");
+const profileType = process.env.PERF_SKILL_PROFILE_TYPE ?? "cpu";
+const logEnabled = process.env.PERF_SKILL_PROFILE_LOG !== "0";
+const heapEnabled = process.env.PERF_SKILL_ENABLE_HEAP === "1";
+const heapOut = resolve(process.env.PERF_SKILL_HEAP_OUT ?? "heap.pb.gz");
+const heapIntervalBytes = parsePositiveInt(process.env.PERF_SKILL_HEAP_INTERVAL_BYTES, 512 * 1024);
+const heapStackDepth = parsePositiveInt(process.env.PERF_SKILL_HEAP_STACK_DEPTH, 64);
+let pprof;
+try {
+    pprof = await import("@datadog/pprof");
+}
+catch (error) {
+    console.error("[perf-skill] Failed to load @datadog/pprof. " +
+        "Ensure the package is installed and supported on this platform.");
+    if (error instanceof Error) {
+        console.error(`[perf-skill] ${error.message}`);
+    }
+    process.exit(1);
+}
+if (profileType !== "cpu" && logEnabled) {
+    console.error(`[perf-skill] Unsupported profile type: ${profileType}. Using cpu.`);
+}
+let stopped = false;
+let heapStarted = false;
+function stopAndWrite(reason) {
+    if (stopped)
+        return;
+    stopped = true;
+    try {
+        const profile = pprof.time.stop();
+        const buf = pprof.encodeSync(profile);
+        mkdirSync(dirname(profileOut), { recursive: true });
+        writeFileSync(profileOut, buf);
+        if (logEnabled) {
+            console.error(`[perf-skill] Wrote CPU profile (${reason}) to ${profileOut}`);
+        }
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[perf-skill] Failed to write profile: ${message}`);
+    }
+    if (heapEnabled && heapStarted) {
+        try {
+            const heapProfile = pprof.heap.profile();
+            const buf = pprof.encodeSync(heapProfile);
+            mkdirSync(dirname(heapOut), { recursive: true });
+            writeFileSync(heapOut, buf);
+            if (logEnabled) {
+                console.error(`[perf-skill] Wrote heap profile (${reason}) to ${heapOut}`);
+            }
+            pprof.heap.stop();
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error(`[perf-skill] Failed to write heap profile: ${message}`);
+        }
+    }
+}
+try {
+    pprof.time.start({});
+}
+catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[perf-skill] Failed to start profiler: ${message}`);
+    process.exit(1);
+}
+if (heapEnabled) {
+    try {
+        pprof.heap.start(heapIntervalBytes, heapStackDepth);
+        heapStarted = true;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        console.error(`[perf-skill] Failed to start heap profiler: ${message}`);
+    }
+}
+const timer = setTimeout(() => stopAndWrite("duration"), durationMs);
+timer.unref();
+process.once("beforeExit", () => stopAndWrite("beforeExit"));
+process.once("SIGINT", () => {
+    stopAndWrite("SIGINT");
+    process.exit(130);
+});
+process.once("SIGTERM", () => {
+    stopAndWrite("SIGTERM");
+    process.exit(143);
+});
+//# sourceMappingURL=preload.js.map

package/dist/profile/preload.js.map

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

package/dist/profile/runner.d.ts

@@ -0,0 +1,22 @@
+export interface RunProfileOptions {
+    entryPath: string;
+    entryArgs?: string[];
+    durationMs?: number;
+    outPath?: string;
+    enableHeap?: boolean;
+    heapOutPath?: string;
+    heapIntervalBytes?: number;
+    heapStackDepth?: number;
+    cwd?: string;
+    env?: NodeJS.ProcessEnv;
+}
+export declare function resolvePreloadPath(): {
+    preloadPath: string;
+    needsTsx: boolean;
+};
+export declare function runCpuProfile(options: RunProfileOptions): Promise<{
+    profilePath: string;
+    heapProfilePath?: string;
+}>;
+export declare function parseDurationInput(value: string | undefined): number;
+//# sourceMappingURL=runner.d.ts.map

package/dist/profile/runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runner.d.ts","sourceRoot":"","sources":["../../src/profile/runner.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;CACzB;AAaD,wBAAgB,kBAAkB,IAAI;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAY/E;AAOD,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,eAAe,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CA6D5D;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAEpE"}

package/dist/profile/runner.js

@@ -0,0 +1,88 @@
+import { spawn } from "node:child_process";
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { resolve, extname } from "node:path";
+import { fileURLToPath, pathToFileURL } from "node:url";
+import { parseDurationMs } from "./duration.js";
+const require = createRequire(import.meta.url);
+function hasTsx() {
+    try {
+        require.resolve("tsx");
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+export function resolvePreloadPath() {
+    const jsPath = fileURLToPath(new URL("./preload.js", import.meta.url));
+    if (existsSync(jsPath)) {
+        return { preloadPath: jsPath, needsTsx: false };
+    }
+    const tsPath = fileURLToPath(new URL("./preload.ts", import.meta.url));
+    if (existsSync(tsPath)) {
+        return { preloadPath: tsPath, needsTsx: true };
+    }
+    throw new Error("Unable to locate perf-skill profile preload module.");
+}
+function entryNeedsTsx(entryPath) {
+    const ext = extname(entryPath).toLowerCase();
+    return ext === ".ts" || ext === ".tsx";
+}
+export async function runCpuProfile(options) {
+    const durationMs = options.durationMs ?? 10_000;
+    if (!Number.isFinite(durationMs) || durationMs <= 0) {
+        throw new Error("Invalid duration for profiling.");
+    }
+    const entryPath = resolve(options.entryPath);
+    const profilePath = resolve(options.outPath ?? "cpu.pb.gz");
+    const heapEnabled = options.enableHeap === true;
+    const heapProfilePath = heapEnabled
+        ? resolve(options.heapOutPath ?? "heap.pb.gz")
+        : undefined;
+    const { preloadPath, needsTsx: preloadNeedsTsx } = resolvePreloadPath();
+    const entryUsesTsx = entryNeedsTsx(entryPath);
+    const needsTsx = preloadNeedsTsx || entryUsesTsx;
+    if (needsTsx && !hasTsx()) {
+        throw new Error("TypeScript entry requires the tsx package to be installed.");
+    }
+    const nodeArgs = [];
+    if (needsTsx) {
+        nodeArgs.push("--import", "tsx");
+    }
+    nodeArgs.push("--import", pathToFileURL(preloadPath).href, entryPath, ...(options.entryArgs ?? []));
+    const env = {
+        ...process.env,
+        ...options.env,
+        PERF_SKILL_DURATION_MS: String(durationMs),
+        PERF_SKILL_PROFILE_OUT: profilePath,
+        PERF_SKILL_PROFILE_TYPE: "cpu",
+        PERF_SKILL_ENABLE_HEAP: heapEnabled ? "1" : "0",
+    };
+    if (heapEnabled && heapProfilePath) {
+        env.PERF_SKILL_HEAP_OUT = heapProfilePath;
+        if (options.heapIntervalBytes !== undefined) {
+            env.PERF_SKILL_HEAP_INTERVAL_BYTES = String(options.heapIntervalBytes);
+        }
+        if (options.heapStackDepth !== undefined) {
+            env.PERF_SKILL_HEAP_STACK_DEPTH = String(options.heapStackDepth);
+        }
+    }
+    const exitCode = await new Promise((resolvePromise, reject) => {
+        const child = spawn(process.execPath, nodeArgs, {
+            stdio: "inherit",
+            cwd: options.cwd ?? process.cwd(),
+            env,
+        });
+        child.on("error", reject);
+        child.on("exit", (code) => resolvePromise(code ?? 1));
+    });
+    if (exitCode !== 0) {
+        throw new Error(`Profile run failed with exit code ${exitCode}.`);
+    }
+    return { profilePath, heapProfilePath };
+}
+export function parseDurationInput(value) {
+    return parseDurationMs(value, 10_000);
+}
+//# sourceMappingURL=runner.js.map

package/dist/profile/runner.js.map

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

package/dist/server/http.d.ts

@@ -0,0 +1,27 @@
+/**
+ * HTTP API server for perf-skill
+ */
+import { type FastifyInstance } from "fastify";
+import { analyze, diff } from "../index.js";
+export interface ServerOptions {
+    port?: number;
+    host?: string;
+    maxFileSize?: number;
+    enableCors?: boolean;
+    corsOrigin?: string | string[] | boolean;
+    enableHelmet?: boolean;
+    enableRateLimit?: boolean;
+    rateLimitMax?: number;
+    rateLimitWindowMs?: number;
+    analyzeFn?: typeof analyze;
+    diffFn?: typeof diff;
+}
+/**
+ * Create and configure Fastify server
+ */
+export declare function createServer(options?: ServerOptions): Promise<FastifyInstance>;
+/**
+ * Start the HTTP server
+ */
+export declare function startServer(options?: ServerOptions): Promise<FastifyInstance>;
+//# sourceMappingURL=http.d.ts.map

package/dist/server/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../../src/server/http.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAgB,EAAE,KAAK,eAAe,EAAE,MAAM,SAAS,CAAC;AAKxD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAY5C,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,OAAO,CAAC;IACzC,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,OAAO,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,IAAI,CAAC;CACtB;AAED;;GAEG;AACH,wBAAsB,YAAY,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAqSxF;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,OAAO,GAAE,aAAkB,GAAG,OAAO,CAAC,eAAe,CAAC,CAiBvF"}

package/dist/server/http.js

@@ -0,0 +1,285 @@
+/**
+ * HTTP API server for perf-skill
+ */
+import Fastify from "fastify";
+import multipart from "@fastify/multipart";
+import cors from "@fastify/cors";
+import helmet from "@fastify/helmet";
+import rateLimit from "@fastify/rate-limit";
+import { analyze, diff } from "../index.js";
+import { logger } from "../utils/logger.js";
+import { checkSizeLimit, DEFAULT_LIMITS } from "../utils/limits.js";
+import { cleanupUploadedFiles, parseOptionsField, parseBoolean, parseNumber, resolveMultipartFile, } from "./utils.js";
+/**
+ * Create and configure Fastify server
+ */
+export async function createServer(options = {}) {
+    const server = Fastify({
+        logger: process.env.LOG_FORMAT === "json",
+    });
+    const analyzeFn = options.analyzeFn ?? analyze;
+    const diffFn = options.diffFn ?? diff;
+    const corsEnabled = options.enableCors ?? parseBoolean(process.env.CORS_ENABLED, true);
+    const helmetEnabled = options.enableHelmet ?? parseBoolean(process.env.HELMET_ENABLED, true);
+    const rateLimitEnabled = options.enableRateLimit ?? parseBoolean(process.env.RATE_LIMIT_ENABLED, true);
+    if (corsEnabled) {
+        const originValue = options.corsOrigin ?? process.env.CORS_ORIGIN ?? true;
+        const origin = typeof originValue === "string"
+            ? originValue === "*"
+                ? true
+                : originValue.split(",").map((item) => item.trim()).filter(Boolean)
+            : originValue;
+        await server.register(cors, { origin });
+    }
+    if (helmetEnabled) {
+        await server.register(helmet);
+    }
+    if (rateLimitEnabled) {
+        const max = options.rateLimitMax ?? parseNumber(process.env.RATE_LIMIT_MAX, 60);
+        const timeWindow = options.rateLimitWindowMs ?? parseNumber(process.env.RATE_LIMIT_WINDOW_MS, 60_000);
+        if (max > 0) {
+            await server.register(rateLimit, { max, timeWindow });
+        }
+    }
+    // Register multipart plugin for file uploads
+    await server.register(multipart, {
+        attachFieldsToBody: true,
+        limits: {
+            fileSize: options.maxFileSize ?? DEFAULT_LIMITS.maxProfileBytes,
+        },
+    });
+    // Health check
+    server.get("/health", async () => {
+        return { status: "ok", timestamp: new Date().toISOString() };
+    });
+    // API info
+    server.get("/v1", async () => {
+        return {
+            name: "perf-skill",
+            version: "1.0.0",
+            endpoints: {
+                analyze: "POST /v1/pprof/analyze",
+                diff: "POST /v1/pprof/diff",
+                convert: "POST /v1/pprof/convert",
+            },
+        };
+    });
+    // Analyze endpoint
+    server.post("/v1/pprof/analyze", async (request, reply) => {
+        const startTime = performance.now();
+        try {
+            // Handle multipart file upload
+            const data = await resolveMultipartFile(request, "file");
+            if (!data) {
+                return reply.status(400).send({
+                    success: false,
+                    error: {
+                        code: "MISSING_FILE",
+                        message: "Profile file is required",
+                    },
+                });
+            }
+            const profileBuffer = await data.toBuffer();
+            checkSizeLimit(profileBuffer, DEFAULT_LIMITS.maxProfileBytes, "Profile");
+            let options;
+            try {
+                options = parseOptionsField(request.body?.options);
+            }
+            catch (error) {
+                return reply.status(400).send({
+                    success: false,
+                    error: {
+                        code: "INVALID_OPTIONS",
+                        message: error instanceof Error ? error.message : "Invalid options",
+                    },
+                });
+            }
+            // Default to not including source in server mode for security
+            if (options.includeSource === undefined) {
+                options.includeSource = false;
+            }
+            logger.info("Analyze request received", {
+                filename: data.filename,
+                size: profileBuffer.length,
+                mode: options.mode,
+            });
+            const result = await analyzeFn(profileBuffer, options);
+            const response = {
+                success: true,
+                data: result,
+            };
+            logger.info("Analyze request completed", {
+                durationMs: Math.round(performance.now() - startTime),
+                hotspotsCount: result.hotspots.length,
+            });
+            return response;
+        }
+        catch (error) {
+            logger.error("Analyze request failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return reply.status(500).send({
+                success: false,
+                error: {
+                    code: "ANALYSIS_ERROR",
+                    message: error instanceof Error ? error.message : "Analysis failed",
+                },
+            });
+        }
+    });
+    // Convert-only endpoint (no LLM)
+    server.post("/v1/pprof/convert", async (request, reply) => {
+        try {
+            const data = await resolveMultipartFile(request, "file");
+            if (!data) {
+                return reply.status(400).send({
+                    success: false,
+                    error: {
+                        code: "MISSING_FILE",
+                        message: "Profile file is required",
+                    },
+                });
+            }
+            const profileBuffer = await data.toBuffer();
+            checkSizeLimit(profileBuffer, DEFAULT_LIMITS.maxProfileBytes, "Profile");
+            let parsedOptions;
+            try {
+                parsedOptions = parseOptionsField(request.body?.options);
+            }
+            catch (error) {
+                return reply.status(400).send({
+                    success: false,
+                    error: {
+                        code: "INVALID_OPTIONS",
+                        message: error instanceof Error ? error.message : "Invalid options",
+                    },
+                });
+            }
+            const options = {
+                ...parsedOptions,
+                mode: "convert-only",
+                includeSource: false,
+            };
+            const result = await analyzeFn(profileBuffer, options);
+            return {
+                success: true,
+                data: result,
+            };
+        }
+        catch (error) {
+            return reply.status(500).send({
+                success: false,
+                error: {
+                    code: "CONVERT_ERROR",
+                    message: error instanceof Error ? error.message : "Conversion failed",
+                },
+            });
+        }
+    });
+    // Diff endpoint
+    server.post("/v1/pprof/diff", async (request, reply) => {
+        const startTime = performance.now();
+        let files;
+        try {
+            // Expect two files: base and current
+            files = await request.saveRequestFiles();
+            if (files.length < 2) {
+                return reply.status(400).send({
+                    success: false,
+                    error: {
+                        code: "MISSING_FILES",
+                        message: "Two profile files required (base and current)",
+                    },
+                });
+            }
+            const baseFile = files.find(f => f.fieldname === "base") || files[0];
+            const currentFile = files.find(f => f.fieldname === "current") || files[1];
+            const { readFile } = await import("node:fs/promises");
+            const baseBuffer = await readFile(baseFile.filepath);
+            const currentBuffer = await readFile(currentFile.filepath);
+            checkSizeLimit(baseBuffer, DEFAULT_LIMITS.maxProfileBytes, "Base profile");
+            checkSizeLimit(currentBuffer, DEFAULT_LIMITS.maxProfileBytes, "Current profile");
+            let options;
+            try {
+                options = parseOptionsField(request.body?.options);
+            }
+            catch (error) {
+                return reply.status(400).send({
+                    success: false,
+                    error: {
+                        code: "INVALID_OPTIONS",
+                        message: error instanceof Error ? error.message : "Invalid options",
+                    },
+                });
+            }
+            logger.info("Diff request received", {
+                baseSize: baseBuffer.length,
+                currentSize: currentBuffer.length,
+            });
+            const result = await diffFn(baseBuffer, currentBuffer, options);
+            logger.info("Diff request completed", {
+                durationMs: Math.round(performance.now() - startTime),
+                regressions: result.regressions.length,
+                improvements: result.improvements.length,
+            });
+            return {
+                success: true,
+                data: result,
+            };
+        }
+        catch (error) {
+            logger.error("Diff request failed", {
+                error: error instanceof Error ? error.message : String(error),
+            });
+            return reply.status(500).send({
+                success: false,
+                error: {
+                    code: "DIFF_ERROR",
+                    message: error instanceof Error ? error.message : "Diff analysis failed",
+                },
+            });
+        }
+        finally {
+            if (files) {
+                await cleanupUploadedFiles(files);
+            }
+        }
+    });
+    // Error handler
+    server.setErrorHandler((error, request, reply) => {
+        const message = error instanceof Error ? error.message : String(error);
+        logger.error("Server error", {
+            error: message,
+            url: request.url,
+        });
+        reply.status(500).send({
+            success: false,
+            error: {
+                code: "INTERNAL_ERROR",
+                message: "Internal server error",
+            },
+        });
+    });
+    return server;
+}
+/**
+ * Start the HTTP server
+ */
+export async function startServer(options = {}) {
+    const server = await createServer(options);
+    const port = options.port ?? 3000;
+    const host = options.host ?? "0.0.0.0";
+    try {
+        await server.listen({ port, host });
+        console.log(`perf-skill server listening on http://${host}:${port}`);
+        console.log(`API docs: http://${host}:${port}/v1`);
+        return server;
+    }
+    catch (error) {
+        logger.error("Failed to start server", {
+            error: error instanceof Error ? error.message : String(error),
+        });
+        throw error;
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/server/http.js.map

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

package/dist/server/utils.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Server utilities for multipart handling
+ */
+import type { MultipartFile } from "@fastify/multipart";
+export declare function parseOptionsField<T extends object>(input: unknown): T;
+export declare function cleanupUploadedFiles(files: Array<{
+    filepath?: string | null;
+}>): Promise<void>;
+export declare function resolveMultipartFile(request: {
+    file: () => Promise<MultipartFile | undefined>;
+    body?: Record<string, unknown>;
+}, fieldName: string): Promise<MultipartFile | undefined>;
+export declare function parseBoolean(value: string | undefined, defaultValue: boolean): boolean;
+export declare function parseNumber(value: string | undefined, defaultValue: number): number;
+//# sourceMappingURL=utils.d.ts.map

package/dist/server/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/server/utils.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAExD,wBAAgB,iBAAiB,CAAC,CAAC,SAAS,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,CAAC,CA2BrE;AAED,wBAAsB,oBAAoB,CACxC,KAAK,EAAE,KAAK,CAAC;IAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,GACzC,OAAO,CAAC,IAAI,CAAC,CAiBf;AAED,wBAAsB,oBAAoB,CACxC,OAAO,EAAE;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,EAC3F,SAAS,EAAE,MAAM,GAChB,OAAO,CAAC,aAAa,GAAG,SAAS,CAAC,CAapC;AAED,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,OAAO,GAAG,OAAO,CAMtF;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,EAAE,YAAY,EAAE,MAAM,GAAG,MAAM,CAInF"}

package/dist/server/utils.js

@@ -0,0 +1,71 @@
+/**
+ * Server utilities for multipart handling
+ */
+import { rm } from "node:fs/promises";
+import { logger } from "../utils/logger.js";
+export function parseOptionsField(input) {
+    if (input === undefined || input === null) {
+        return {};
+    }
+    if (typeof input === "string") {
+        const trimmed = input.trim();
+        if (!trimmed) {
+            return {};
+        }
+        try {
+            return JSON.parse(trimmed);
+        }
+        catch (error) {
+            throw new Error(`Invalid options JSON: ${error instanceof Error ? error.message : String(error)}`);
+        }
+    }
+    if (typeof input === "object") {
+        if (input && "value" in input) {
+            return parseOptionsField(input.value);
+        }
+        return input;
+    }
+    throw new Error("Invalid options field type");
+}
+export async function cleanupUploadedFiles(files) {
+    const paths = files
+        .map((file) => file.filepath)
+        .filter((path) => Boolean(path));
+    const results = await Promise.allSettled(paths.map((path) => rm(path, { force: true })));
+    results.forEach((result, index) => {
+        if (result.status === "rejected") {
+            logger.warn("Failed to cleanup uploaded file", {
+                path: paths[index],
+                error: result.reason instanceof Error ? result.reason.message : String(result.reason),
+            });
+        }
+    });
+}
+export async function resolveMultipartFile(request, fieldName) {
+    const body = request.body;
+    const entry = body?.[fieldName];
+    if (Array.isArray(entry)) {
+        return entry[0];
+    }
+    if (entry && typeof entry === "object" && entry.type === "file") {
+        return entry;
+    }
+    return request.file();
+}
+export function parseBoolean(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    const normalized = value.trim().toLowerCase();
+    if (["1", "true", "yes", "on"].includes(normalized))
+        return true;
+    if (["0", "false", "no", "off"].includes(normalized))
+        return false;
+    return defaultValue;
+}
+export function parseNumber(value, defaultValue) {
+    if (value === undefined)
+        return defaultValue;
+    const parsed = Number(value);
+    return Number.isFinite(parsed) ? parsed : defaultValue;
+}
+//# sourceMappingURL=utils.js.map