@farm.js/plugin 0.1.0-beta.10 → 0.1.0-beta.13

package/dist/observability/index.d.ts

@@ -0,0 +1,190 @@
+import type { IncomingMessage, ServerResponse } from "http";
+export type IncidentSeverity = "low" | "medium" | "high" | "critical";
+export type ObservabilitySignalKind = "request.completed" | "api.response" | "render.completed" | "runtime.error" | "build.result" | "nitro.build";
+export interface ObservabilitySignal {
+    id: string;
+    kind: ObservabilitySignalKind;
+    timestamp: number;
+    service: string;
+    environment: string;
+    tags: Record<string, string>;
+    request?: {
+        method: string;
+        pathname: string;
+        statusCode: number;
+        durationMs: number;
+        requestId: string;
+    };
+    api?: {
+        method: string;
+        pathname: string;
+        status: number;
+    };
+    render?: {
+        pathname: string;
+        routePattern: string | null;
+    };
+    error?: {
+        phase: string;
+        message: string;
+        name?: string;
+    };
+    build?: {
+        success: boolean;
+        preset: string;
+        root: string;
+        outputDir?: string;
+    };
+}
+export interface ObservabilityIncident {
+    id: string;
+    kind: string;
+    title: string;
+    severity: IncidentSeverity;
+    fingerprint: string;
+    detectedAt: number;
+    signalId: string;
+    summary?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ObservabilityDetectionContext {
+    now: () => number;
+}
+export interface ObservabilityRule {
+    id: string;
+    severity?: IncidentSeverity;
+    when: (signal: ObservabilitySignal, context: ObservabilityDetectionContext) => boolean | Promise<boolean>;
+    buildIncident?: (signal: ObservabilitySignal, context: ObservabilityDetectionContext) => Partial<Omit<ObservabilityIncident, "id" | "detectedAt" | "signalId">> | null | undefined | Promise<Partial<Omit<ObservabilityIncident, "id" | "detectedAt" | "signalId">> | null | undefined>;
+}
+export interface ObservabilityFixResult {
+    summary: string;
+    branch?: string;
+    commitSha?: string;
+    metadata?: Record<string, unknown>;
+}
+export interface ObservabilityPipelineContext {
+    signal: ObservabilitySignal;
+    incident: ObservabilityIncident;
+    /**
+     * @deprecated Use state["fix"] or step result values in `state`.
+     */
+    fixResult?: ObservabilityFixResult | null;
+    state: Record<string, unknown>;
+}
+export type ObservabilityAction = (context: ObservabilityPipelineContext) => unknown | Promise<unknown>;
+export type ObservabilityPipelineStepName = string;
+export interface ObservabilityWorkflowStepEvent {
+    step: string;
+    context: ObservabilityPipelineContext;
+}
+export interface ObservabilityWorkflowStepCompleteEvent extends ObservabilityWorkflowStepEvent {
+    result: unknown;
+}
+export interface ObservabilityWorkflowStepErrorEvent extends ObservabilityWorkflowStepEvent {
+    error: unknown;
+}
+export interface ObservabilityWorkflowErrorEvent {
+    error: unknown;
+    context: ObservabilityPipelineContext;
+}
+export interface ObservabilityWorkflowCallbacks {
+    onIncident?: (context: ObservabilityPipelineContext) => void | Promise<void>;
+    onPipelineStart?: (context: ObservabilityPipelineContext) => void | Promise<void>;
+    onPipelineComplete?: (context: ObservabilityPipelineContext) => void | Promise<void>;
+    onPipelineError?: (event: ObservabilityWorkflowErrorEvent) => void | Promise<void>;
+    onStepStart?: (event: ObservabilityWorkflowStepEvent) => void | Promise<void>;
+    onStepComplete?: (event: ObservabilityWorkflowStepCompleteEvent) => void | Promise<void>;
+    onStepError?: (event: ObservabilityWorkflowStepErrorEvent) => void | Promise<void>;
+}
+export interface ObservabilityWorkflowOptions {
+    pipeline?: ObservabilityPipelineStepName[];
+    actions?: Record<string, ObservabilityAction>;
+    /**
+     * Callback lifecycle for side effects around pipeline execution.
+     */
+    callbacks?: ObservabilityWorkflowCallbacks;
+    /**
+     * Continue pipeline execution when a step fails.
+     * Defaults to true to avoid affecting request handling.
+     */
+    continueOnStepError?: boolean;
+    /**
+     * @deprecated Use `callbacks.onIncident`.
+     */
+    onIncident?: (context: ObservabilityPipelineContext) => void | Promise<void>;
+    /**
+     * @deprecated Use `actions.fix` and include "fix" in `pipeline`.
+     */
+    runFix?: (context: ObservabilityPipelineContext) => ObservabilityFixResult | null | undefined | Promise<ObservabilityFixResult | null | undefined>;
+    /**
+     * @deprecated Use `actions.pullRequest` and include "pullRequest" in `pipeline`.
+     */
+    openPullRequest?: (context: ObservabilityPipelineContext) => void | Promise<void>;
+}
+export interface ObservabilityDetectionOptions {
+    enabled?: boolean;
+    dedupeWindowMs?: number;
+    rules?: ObservabilityRule[];
+    mapSignalToIncident?: (signal: ObservabilitySignal, context: ObservabilityDetectionContext) => ObservabilityIncident | null | undefined | Promise<ObservabilityIncident | null | undefined>;
+}
+export interface ObservabilityTelemetryOptions {
+    slowRequestMs?: number;
+    logLifecycle?: boolean;
+    annotateHtml?: boolean;
+}
+export interface ObservabilityPluginOptions {
+    service?: string;
+    environment?: string;
+    tags?: Record<string, string>;
+    telemetry?: ObservabilityTelemetryOptions;
+    detection?: ObservabilityDetectionOptions;
+    workflow?: ObservabilityWorkflowOptions;
+    /**
+     * @deprecated Use telemetry.slowRequestMs instead.
+     */
+    slowRequestMs?: number;
+    /**
+     * @deprecated Use telemetry.logLifecycle instead.
+     */
+    logLifecycle?: boolean;
+}
+interface ObservabilityPlugin {
+    name: string;
+    enforce?: "pre" | "post";
+    init?: () => void;
+    ready?: () => void;
+    beforeRequest?: (req: IncomingMessage, res: ServerResponse, context?: unknown) => void;
+    afterResponse?: (req: IncomingMessage, res: ServerResponse, context?: unknown) => void | Promise<void>;
+    afterApiHandler?: (response: Response, api: {
+        method: string;
+        pathname: string;
+    }, context?: unknown) => Response | Promise<Response>;
+    afterRender?: (html: string, render: {
+        pathname: string;
+        routePattern: string | null;
+    }, context?: unknown) => string;
+    onError?: (error: {
+        phase: string;
+        error: unknown;
+    }, context?: unknown) => void | Promise<void>;
+    hmrUpdate?: (update: {
+        file: string;
+        modules: string[];
+    }, context?: unknown) => void;
+    afterBundle?: (result: {
+        success: boolean;
+        preset: string;
+        root: string;
+    }, context?: unknown) => void | Promise<void>;
+    afterNitroBuild?: (payload: {
+        preset: string;
+        outputDir: string;
+        root?: string;
+    }, context?: unknown) => void | Promise<void>;
+    shutdown?: (payload: {
+        reason: string;
+    }, context?: unknown) => void;
+}
+export declare function observabilityPlugin(options?: ObservabilityPluginOptions): ObservabilityPlugin;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/observability/index.d.ts.map

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

package/dist/observability/index.js

@@ -0,0 +1,399 @@
+function errorMessage(error) {
+    if (error instanceof Error)
+        return error.message;
+    return String(error);
+}
+function stableFingerprint(parts) {
+    return parts
+        .map((part) => (part === undefined || part === null ? "na" : String(part).trim()))
+        .join(":");
+}
+function toPositiveInt(value, fallback) {
+    if (typeof value !== "number" || !Number.isFinite(value))
+        return fallback;
+    return Math.max(1, Math.floor(value));
+}
+export function observabilityPlugin(options = {}) {
+    const now = () => Date.now();
+    const service = options.service || process.env.FARM_SERVICE || "farm-app";
+    const environment = options.environment || process.env.NODE_ENV || "development";
+    const tags = options.tags || {};
+    const telemetry = options.telemetry || {};
+    const detection = options.detection || {};
+    const workflow = options.workflow || {};
+    const slowRequestMs = toPositiveInt(telemetry.slowRequestMs ?? options.slowRequestMs, 300);
+    const dedupeWindowMs = toPositiveInt(detection.dedupeWindowMs, 60_000);
+    const logLifecycle = telemetry.logLifecycle ?? options.logLifecycle ?? true;
+    const annotateHtml = telemetry.annotateHtml ?? true;
+    const detectionEnabled = detection.enabled ?? true;
+    const continueOnStepError = workflow.continueOnStepError ?? true;
+    const requestStarts = new WeakMap();
+    const recentIncidentsByFingerprint = new Map();
+    let signalCounter = 0;
+    let incidentCounter = 0;
+    const nextSignalId = () => `sig_${now()}_${(signalCounter++).toString(36)}`;
+    const nextIncidentId = () => `inc_${now()}_${(incidentCounter++).toString(36)}`;
+    const detectionContext = { now };
+    const createDefaultIncident = (signal) => {
+        if (signal.kind === "runtime.error" && signal.error) {
+            return {
+                kind: "runtime-error",
+                title: `Runtime error in ${signal.error.phase}`,
+                severity: "critical",
+                fingerprint: stableFingerprint(["runtime-error", signal.error.phase, signal.error.message]),
+                summary: signal.error.message,
+                metadata: { phase: signal.error.phase, name: signal.error.name },
+            };
+        }
+        if (signal.kind === "request.completed" && signal.request) {
+            if (signal.request.statusCode >= 500) {
+                return {
+                    kind: "request-failure",
+                    title: `Request failure ${signal.request.method} ${signal.request.pathname}`,
+                    severity: "high",
+                    fingerprint: stableFingerprint([
+                        "request-failure",
+                        signal.request.method,
+                        signal.request.pathname,
+                        signal.request.statusCode,
+                    ]),
+                    summary: `Request returned ${signal.request.statusCode}`,
+                    metadata: {
+                        method: signal.request.method,
+                        pathname: signal.request.pathname,
+                        statusCode: signal.request.statusCode,
+                        durationMs: signal.request.durationMs,
+                    },
+                };
+            }
+            if (signal.request.durationMs >= slowRequestMs) {
+                return {
+                    kind: "slow-request",
+                    title: `Slow request ${signal.request.method} ${signal.request.pathname}`,
+                    severity: "medium",
+                    fingerprint: stableFingerprint([
+                        "slow-request",
+                        signal.request.method,
+                        signal.request.pathname,
+                    ]),
+                    summary: `Request took ${signal.request.durationMs}ms`,
+                    metadata: {
+                        method: signal.request.method,
+                        pathname: signal.request.pathname,
+                        statusCode: signal.request.statusCode,
+                        durationMs: signal.request.durationMs,
+                        thresholdMs: slowRequestMs,
+                    },
+                };
+            }
+        }
+        if (signal.kind === "api.response" && signal.api && signal.api.status >= 500) {
+            return {
+                kind: "api-failure",
+                title: `API failure ${signal.api.method} ${signal.api.pathname}`,
+                severity: "high",
+                fingerprint: stableFingerprint([
+                    "api-failure",
+                    signal.api.method,
+                    signal.api.pathname,
+                    signal.api.status,
+                ]),
+                summary: `API returned ${signal.api.status}`,
+                metadata: {
+                    method: signal.api.method,
+                    pathname: signal.api.pathname,
+                    status: signal.api.status,
+                },
+            };
+        }
+        return null;
+    };
+    const shouldDedupe = (fingerprint) => {
+        const seenAt = recentIncidentsByFingerprint.get(fingerprint);
+        if (seenAt && now() - seenAt < dedupeWindowMs) {
+            return true;
+        }
+        recentIncidentsByFingerprint.set(fingerprint, now());
+        return false;
+    };
+    const applyRules = async (signal) => {
+        const rules = detection.rules || [];
+        for (const rule of rules) {
+            const matched = await rule.when(signal, detectionContext);
+            if (!matched)
+                continue;
+            const partial = (await rule.buildIncident?.(signal, detectionContext)) || {};
+            const defaultIncident = createDefaultIncident(signal);
+            return {
+                kind: partial.kind || defaultIncident?.kind || `rule:${rule.id}`,
+                title: partial.title || defaultIncident?.title || `Incident from rule ${rule.id}`,
+                severity: partial.severity || rule.severity || defaultIncident?.severity || "high",
+                fingerprint: partial.fingerprint ||
+                    defaultIncident?.fingerprint ||
+                    stableFingerprint(["rule", rule.id, signal.kind]),
+                summary: partial.summary || defaultIncident?.summary,
+                metadata: {
+                    ...defaultIncident?.metadata,
+                    ...partial.metadata,
+                    ruleId: rule.id,
+                },
+            };
+        }
+        return null;
+    };
+    const resolveIncident = async (signal) => {
+        const mapped = await detection.mapSignalToIncident?.(signal, detectionContext);
+        if (mapped) {
+            return {
+                id: mapped.id || nextIncidentId(),
+                kind: mapped.kind || "mapped-incident",
+                title: mapped.title || "Mapped incident",
+                severity: mapped.severity || "high",
+                fingerprint: mapped.fingerprint || stableFingerprint(["mapped-incident", mapped.kind, signal.kind]),
+                detectedAt: mapped.detectedAt || now(),
+                signalId: mapped.signalId || signal.id,
+                summary: mapped.summary,
+                metadata: mapped.metadata,
+            };
+        }
+        const byRule = await applyRules(signal);
+        const chosen = byRule || createDefaultIncident(signal);
+        if (!chosen)
+            return null;
+        return {
+            id: nextIncidentId(),
+            kind: chosen.kind,
+            title: chosen.title,
+            severity: chosen.severity,
+            fingerprint: chosen.fingerprint,
+            detectedAt: now(),
+            signalId: signal.id,
+            summary: chosen.summary,
+            metadata: chosen.metadata,
+        };
+    };
+    const runWorkflow = async (signal, incident) => {
+        const context = {
+            signal,
+            incident,
+            state: {},
+            fixResult: null,
+        };
+        const callbacks = workflow.callbacks || {};
+        const userActions = workflow.actions || {};
+        const legacyOnIncident = workflow.onIncident;
+        const builtInActions = {
+            notify: async (ctx) => {
+                const onIncident = callbacks.onIncident || legacyOnIncident;
+                if (onIncident) {
+                    await onIncident(ctx);
+                    return;
+                }
+                console.warn(`[obs] incident detected kind=${ctx.incident.kind} severity=${ctx.incident.severity} id=${ctx.incident.id} title="${ctx.incident.title}"`);
+            },
+            log: async (ctx) => {
+                console.log(`[obs] pipeline incident=${ctx.incident.id} kind=${ctx.incident.kind} severity=${ctx.incident.severity}`);
+            },
+        };
+        // Backward-compatibility shims. Prefer defining these steps via workflow.actions.
+        const legacyActions = {};
+        if (workflow.runFix) {
+            legacyActions.fix = async (ctx) => {
+                const result = (await workflow.runFix?.(ctx)) || null;
+                ctx.fixResult = result;
+                return result;
+            };
+        }
+        if (workflow.openPullRequest) {
+            legacyActions.pullRequest = async (ctx) => {
+                if (!ctx.fixResult)
+                    return null;
+                await workflow.openPullRequest?.(ctx);
+                return ctx.fixResult;
+            };
+        }
+        const actionRegistry = {
+            ...builtInActions,
+            ...legacyActions,
+            ...userActions,
+        };
+        const hasFixPath = typeof workflow.runFix === "function";
+        const hasPrPath = typeof workflow.openPullRequest === "function";
+        const pipeline = workflow.pipeline && workflow.pipeline.length > 0
+            ? workflow.pipeline
+            : hasFixPath
+                ? hasPrPath
+                    ? ["notify", "fix", "pullRequest"]
+                    : ["notify", "fix"]
+                : ["notify"];
+        try {
+            await callbacks.onPipelineStart?.(context);
+            for (const step of pipeline) {
+                const action = actionRegistry[step];
+                if (!action) {
+                    const message = `[obs] pipeline step "${step}" is not registered`;
+                    if (!continueOnStepError)
+                        throw new Error(message);
+                    console.warn(message);
+                    continue;
+                }
+                try {
+                    await callbacks.onStepStart?.({ step, context });
+                    const result = await action(context);
+                    if (result !== undefined) {
+                        context.state[step] = result;
+                        if (step === "fix") {
+                            context.fixResult = result;
+                        }
+                    }
+                    await callbacks.onStepComplete?.({ step, context, result });
+                }
+                catch (error) {
+                    await callbacks.onStepError?.({ step, context, error });
+                    const message = `[obs] pipeline step "${step}" failed: ${errorMessage(error)}`;
+                    if (!continueOnStepError)
+                        throw new Error(message);
+                    console.error(message);
+                }
+            }
+            await callbacks.onPipelineComplete?.(context);
+        }
+        catch (error) {
+            await callbacks.onPipelineError?.({ error, context });
+            throw error;
+        }
+    };
+    const processSignal = async (signal) => {
+        if (!detectionEnabled)
+            return;
+        const incident = await resolveIncident(signal);
+        if (!incident)
+            return;
+        if (shouldDedupe(incident.fingerprint))
+            return;
+        try {
+            await runWorkflow(signal, incident);
+        }
+        catch (error) {
+            console.error(`[obs] workflow failed incident=${incident.id} error=${errorMessage(error)}`);
+        }
+    };
+    const createSignal = (kind, payload) => {
+        return {
+            id: nextSignalId(),
+            kind,
+            timestamp: now(),
+            service,
+            environment,
+            tags,
+            ...payload,
+        };
+    };
+    return {
+        name: "@farm.js/plugin-observability",
+        enforce: "post",
+        init() {
+            if (logLifecycle)
+                console.log("[obs] init");
+        },
+        ready() {
+            if (logLifecycle)
+                console.log("[obs] ready");
+        },
+        beforeRequest(req) {
+            const pathname = req.url || "/";
+            const method = req.method || "GET";
+            const requestId = `req_${now()}_${(signalCounter++).toString(36)}`;
+            requestStarts.set(req, {
+                startedAt: now(),
+                method,
+                pathname,
+                requestId,
+            });
+        },
+        async afterResponse(req, res) {
+            const started = requestStarts.get(req);
+            if (!started)
+                return;
+            requestStarts.delete(req);
+            const signal = createSignal("request.completed", {
+                request: {
+                    method: started.method,
+                    pathname: started.pathname,
+                    statusCode: res.statusCode || 200,
+                    durationMs: now() - started.startedAt,
+                    requestId: started.requestId,
+                },
+            });
+            await processSignal(signal);
+        },
+        async afterApiHandler(response, api) {
+            const signal = createSignal("api.response", {
+                api: {
+                    method: api.method,
+                    pathname: api.pathname,
+                    status: response.status,
+                },
+            });
+            await processSignal(signal);
+            return response;
+        },
+        afterRender(html, render) {
+            if (!annotateHtml)
+                return html;
+            const marker = `<!-- observability:path=${render.pathname} route=${render.routePattern ?? "unmatched"} -->`;
+            return html.includes("</body>")
+                ? html.replace("</body>", `${marker}\n</body>`)
+                : `${html}\n${marker}`;
+        },
+        async onError(error) {
+            const message = errorMessage(error.error);
+            const signal = createSignal("runtime.error", {
+                error: {
+                    phase: error.phase,
+                    message,
+                    name: error.error instanceof Error ? error.error.name : undefined,
+                },
+            });
+            await processSignal(signal);
+        },
+        hmrUpdate(update) {
+            if (!logLifecycle)
+                return;
+            console.log(`[obs] hmr file=${update.file} modules=${update.modules.length}`);
+        },
+        async afterBundle(result) {
+            if (logLifecycle) {
+                const state = result.success ? "success" : "failed";
+                console.log(`[obs] bundle ${state} preset=${result.preset} root=${result.root}`);
+            }
+            const signal = createSignal("build.result", {
+                build: {
+                    success: result.success,
+                    preset: result.preset,
+                    root: result.root,
+                },
+            });
+            await processSignal(signal);
+        },
+        async afterNitroBuild(payload) {
+            if (logLifecycle) {
+                console.log(`[obs] nitro preset=${payload.preset} output=${payload.outputDir}`);
+            }
+            const signal = createSignal("nitro.build", {
+                build: {
+                    success: true,
+                    preset: payload.preset,
+                    root: payload.root || process.cwd(),
+                    outputDir: payload.outputDir,
+                },
+            });
+            await processSignal(signal);
+        },
+        shutdown(payload) {
+            if (logLifecycle)
+                console.log(`[obs] shutdown reason=${payload.reason}`);
+            recentIncidentsByFingerprint.clear();
+        },
+    };
+}

package/dist/rsc/automatic-optimized-boundary.d.ts

@@ -0,0 +1,11 @@
+export interface AutomaticOptimizedBoundaryTransform {
+    code: string;
+    boundaryCount: number;
+}
+/**
+ * Wrap React JSX-runtime calls for native host boundaries with Farm's
+ * server-only optimizer. Eligibility is decided against the fully evaluated
+ * React element at runtime, so unsupported trees retain normal React behavior.
+ */
+export declare function transformAutomaticOptimizedBoundaries(code: string, id: string): AutomaticOptimizedBoundaryTransform | null;
+//# sourceMappingURL=automatic-optimized-boundary.d.ts.map

package/dist/rsc/automatic-optimized-boundary.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"automatic-optimized-boundary.d.ts","sourceRoot":"","sources":["../../src/rsc/automatic-optimized-boundary.ts"],"names":[],"mappings":"AAwBA,MAAM,WAAW,mCAAmC;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;CACvB;AAiGD;;;;GAIG;AACH,wBAAgB,qCAAqC,CACnD,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,GACT,mCAAmC,GAAG,IAAI,CA8C5C"}