@farm.js/core 0.1.0-beta.21 → 0.1.0-beta.22

package/dist/plugin-BJDf43dc.d.mts

@@ -0,0 +1,165 @@
+type MaybePromise<T> = T | Promise<T>;
+type FarmClientPluginEnforce = "pre" | "post";
+type FarmClientNavigationAction = "push" | "replace" | "pop";
+type FarmClientHydrationMode = "hydrate" | "render";
+interface FarmClientLocation {
+    href: string;
+    pathname: string;
+    search: string;
+    hash: string;
+}
+interface FarmClientPluginRouter {
+    navigate(href: string, options?: Record<string, unknown>): MaybePromise<void>;
+    prefetch?(href: string): MaybePromise<void>;
+    getNavigationState?(): unknown;
+}
+interface FarmClientPluginMetadata {
+    name: string;
+    version?: string;
+}
+interface FarmClientPluginSetupEvent<TPublic = undefined> {
+    plugin: FarmClientPluginMetadata;
+    public: Readonly<TPublic>;
+    router: FarmClientPluginRouter;
+    isDev: boolean;
+    isProd: boolean;
+    deploymentId?: string;
+}
+interface FarmClientPluginStateEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginSetupEvent<TPublic> {
+    state: TState;
+}
+interface FarmClientHydrationSession {
+    container: Element;
+    location: FarmClientLocation;
+    mode: FarmClientHydrationMode;
+    startedAt: number;
+}
+interface FarmClientHydrationEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic>, FarmClientHydrationSession {
+}
+interface FarmClientHydrationCompleteEvent<TState = unknown, TPublic = undefined> extends FarmClientHydrationEvent<TState, TPublic> {
+    durationMs: number;
+    recovered: boolean;
+}
+interface FarmClientNavigationSession {
+    id: string;
+    from: FarmClientLocation | null;
+    to: FarmClientLocation;
+    action: FarmClientNavigationAction;
+    signal: AbortSignal;
+    startedAt: number;
+    route?: {
+        pattern?: string | null;
+        params?: Record<string, string>;
+    };
+}
+interface FarmClientNavigationEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic>, FarmClientNavigationSession {
+}
+interface FarmClientNavigationLoadedEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationEvent<TState, TPublic> {
+    durationMs: number;
+    data?: unknown;
+}
+interface FarmClientNavigationResolvedEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationEvent<TState, TPublic> {
+    durationMs: number;
+}
+interface FarmClientNavigationErrorEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationResolvedEvent<TState, TPublic> {
+    error: unknown;
+}
+type FarmClientPluginErrorPhase = "setup" | "hydration" | "navigation" | "window" | "unhandled-rejection" | "performance" | `plugin:${string}` | (string & {});
+interface FarmClientPluginErrorEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
+    error: unknown;
+    phase: FarmClientPluginErrorPhase;
+    location: FarmClientLocation;
+    navigation?: FarmClientNavigationSession;
+}
+interface FarmClientPerformanceEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
+    entry: PerformanceEntry;
+    location: FarmClientLocation;
+}
+interface FarmClientPluginCloseEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
+    reason: "pagehide" | "hmr" | "manual" | (string & {});
+}
+interface FarmClientPlugin<TState = unknown, TPublic = undefined> {
+    setup?(event: FarmClientPluginSetupEvent<TPublic>): MaybePromise<TState>;
+    hydration?: {
+        before?(event: FarmClientHydrationEvent<TState, TPublic>): MaybePromise<void>;
+        after?(event: FarmClientHydrationCompleteEvent<TState, TPublic>): MaybePromise<void>;
+    };
+    navigation?: {
+        before?(event: FarmClientNavigationEvent<TState, TPublic>): MaybePromise<void>;
+        loaded?(event: FarmClientNavigationLoadedEvent<TState, TPublic>): MaybePromise<void>;
+        resolved?(event: FarmClientNavigationResolvedEvent<TState, TPublic>): MaybePromise<void>;
+        rendered?(event: FarmClientNavigationResolvedEvent<TState, TPublic>): MaybePromise<void>;
+        error?(event: FarmClientNavigationErrorEvent<TState, TPublic>): MaybePromise<void>;
+    };
+    error?(event: FarmClientPluginErrorEvent<TState, TPublic>): MaybePromise<void>;
+    performance?(event: FarmClientPerformanceEvent<TState, TPublic>): MaybePromise<void>;
+    close?(event: FarmClientPluginCloseEvent<TState, TPublic>): MaybePromise<void>;
+}
+interface FarmClientPluginRegistration<TPublic = undefined> {
+    name: string;
+    version?: string;
+    enforce?: FarmClientPluginEnforce;
+    definition: FarmClientPlugin<any, TPublic>;
+    public?: TPublic;
+}
+interface FarmClientPluginManagerOptions {
+    router: FarmClientPluginRouter;
+    isDev?: boolean;
+    isProd?: boolean;
+    deploymentId?: string;
+    window?: Window;
+}
+declare class FarmClientPluginManager {
+    private readonly registrations;
+    private readonly options;
+    private readonly instances;
+    private readonly performanceObservers;
+    private startPromise?;
+    private closePromise?;
+    private currentNavigation?;
+    private navigationSequence;
+    private starting;
+    private started;
+    private closed;
+    private readonly reportedErrors;
+    private readonly handleWindowError;
+    private readonly handleUnhandledRejection;
+    private readonly handlePageHide;
+    constructor(registrations: readonly FarmClientPluginRegistration[], options: FarmClientPluginManagerOptions);
+    start(): Promise<void>;
+    beginHydration(input: {
+        container: Element;
+        mode: FarmClientHydrationMode;
+    }): Promise<FarmClientHydrationSession>;
+    completeHydration(session: FarmClientHydrationSession, options?: {
+        recovered?: boolean;
+    }): Promise<void>;
+    failHydration(session: FarmClientHydrationSession, error: unknown): Promise<void>;
+    beginNavigation(input: {
+        from?: string | URL | FarmClientLocation | null;
+        to: string | URL | FarmClientLocation;
+        action: FarmClientNavigationAction;
+        route?: FarmClientNavigationSession["route"];
+    }): Promise<FarmClientNavigationSession>;
+    markNavigationLoaded(session: FarmClientNavigationSession, data?: unknown): Promise<void>;
+    resolveNavigation(session: FarmClientNavigationSession): Promise<void>;
+    scheduleNavigationRendered(session: FarmClientNavigationSession): Promise<void>;
+    failNavigation(session: FarmClientNavigationSession, error: unknown): Promise<void>;
+    reportError(error: unknown, phase: FarmClientPluginErrorPhase, navigation?: FarmClientNavigationSession, location?: FarmClientLocation): Promise<void>;
+    close(reason?: FarmClientPluginCloseEvent["reason"]): Promise<void>;
+    getPlugins(): readonly FarmClientPluginMetadata[];
+    private startInternal;
+    private installBrowserListeners;
+    private installPerformanceObservers;
+    private closeInternal;
+    private runHook;
+    private runErrorHooks;
+    private createSetupEvent;
+    private createStateEvent;
+    private getLocation;
+    private getBaseUrl;
+    private logHookError;
+}
+declare function createClientPluginManager(registrations: readonly FarmClientPluginRegistration[], options: FarmClientPluginManagerOptions): FarmClientPluginManager;
+
+export { FarmClientPluginManager as F, type FarmClientHydrationCompleteEvent as a, type FarmClientHydrationEvent as b, createClientPluginManager as c, type FarmClientHydrationMode as d, type FarmClientHydrationSession as e, type FarmClientLocation as f, type FarmClientNavigationAction as g, type FarmClientNavigationErrorEvent as h, type FarmClientNavigationEvent as i, type FarmClientNavigationLoadedEvent as j, type FarmClientNavigationResolvedEvent as k, type FarmClientNavigationSession as l, type FarmClientPerformanceEvent as m, type FarmClientPlugin as n, type FarmClientPluginCloseEvent as o, type FarmClientPluginEnforce as p, type FarmClientPluginErrorEvent as q, type FarmClientPluginErrorPhase as r, type FarmClientPluginManagerOptions as s, type FarmClientPluginMetadata as t, type FarmClientPluginRegistration as u, type FarmClientPluginRouter as v, type FarmClientPluginSetupEvent as w, type FarmClientPluginStateEvent as x };

package/dist/plugin-BJDf43dc.d.ts

@@ -0,0 +1,165 @@
+type MaybePromise<T> = T | Promise<T>;
+type FarmClientPluginEnforce = "pre" | "post";
+type FarmClientNavigationAction = "push" | "replace" | "pop";
+type FarmClientHydrationMode = "hydrate" | "render";
+interface FarmClientLocation {
+    href: string;
+    pathname: string;
+    search: string;
+    hash: string;
+}
+interface FarmClientPluginRouter {
+    navigate(href: string, options?: Record<string, unknown>): MaybePromise<void>;
+    prefetch?(href: string): MaybePromise<void>;
+    getNavigationState?(): unknown;
+}
+interface FarmClientPluginMetadata {
+    name: string;
+    version?: string;
+}
+interface FarmClientPluginSetupEvent<TPublic = undefined> {
+    plugin: FarmClientPluginMetadata;
+    public: Readonly<TPublic>;
+    router: FarmClientPluginRouter;
+    isDev: boolean;
+    isProd: boolean;
+    deploymentId?: string;
+}
+interface FarmClientPluginStateEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginSetupEvent<TPublic> {
+    state: TState;
+}
+interface FarmClientHydrationSession {
+    container: Element;
+    location: FarmClientLocation;
+    mode: FarmClientHydrationMode;
+    startedAt: number;
+}
+interface FarmClientHydrationEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic>, FarmClientHydrationSession {
+}
+interface FarmClientHydrationCompleteEvent<TState = unknown, TPublic = undefined> extends FarmClientHydrationEvent<TState, TPublic> {
+    durationMs: number;
+    recovered: boolean;
+}
+interface FarmClientNavigationSession {
+    id: string;
+    from: FarmClientLocation | null;
+    to: FarmClientLocation;
+    action: FarmClientNavigationAction;
+    signal: AbortSignal;
+    startedAt: number;
+    route?: {
+        pattern?: string | null;
+        params?: Record<string, string>;
+    };
+}
+interface FarmClientNavigationEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic>, FarmClientNavigationSession {
+}
+interface FarmClientNavigationLoadedEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationEvent<TState, TPublic> {
+    durationMs: number;
+    data?: unknown;
+}
+interface FarmClientNavigationResolvedEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationEvent<TState, TPublic> {
+    durationMs: number;
+}
+interface FarmClientNavigationErrorEvent<TState = unknown, TPublic = undefined> extends FarmClientNavigationResolvedEvent<TState, TPublic> {
+    error: unknown;
+}
+type FarmClientPluginErrorPhase = "setup" | "hydration" | "navigation" | "window" | "unhandled-rejection" | "performance" | `plugin:${string}` | (string & {});
+interface FarmClientPluginErrorEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
+    error: unknown;
+    phase: FarmClientPluginErrorPhase;
+    location: FarmClientLocation;
+    navigation?: FarmClientNavigationSession;
+}
+interface FarmClientPerformanceEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
+    entry: PerformanceEntry;
+    location: FarmClientLocation;
+}
+interface FarmClientPluginCloseEvent<TState = unknown, TPublic = undefined> extends FarmClientPluginStateEvent<TState, TPublic> {
+    reason: "pagehide" | "hmr" | "manual" | (string & {});
+}
+interface FarmClientPlugin<TState = unknown, TPublic = undefined> {
+    setup?(event: FarmClientPluginSetupEvent<TPublic>): MaybePromise<TState>;
+    hydration?: {
+        before?(event: FarmClientHydrationEvent<TState, TPublic>): MaybePromise<void>;
+        after?(event: FarmClientHydrationCompleteEvent<TState, TPublic>): MaybePromise<void>;
+    };
+    navigation?: {
+        before?(event: FarmClientNavigationEvent<TState, TPublic>): MaybePromise<void>;
+        loaded?(event: FarmClientNavigationLoadedEvent<TState, TPublic>): MaybePromise<void>;
+        resolved?(event: FarmClientNavigationResolvedEvent<TState, TPublic>): MaybePromise<void>;
+        rendered?(event: FarmClientNavigationResolvedEvent<TState, TPublic>): MaybePromise<void>;
+        error?(event: FarmClientNavigationErrorEvent<TState, TPublic>): MaybePromise<void>;
+    };
+    error?(event: FarmClientPluginErrorEvent<TState, TPublic>): MaybePromise<void>;
+    performance?(event: FarmClientPerformanceEvent<TState, TPublic>): MaybePromise<void>;
+    close?(event: FarmClientPluginCloseEvent<TState, TPublic>): MaybePromise<void>;
+}
+interface FarmClientPluginRegistration<TPublic = undefined> {
+    name: string;
+    version?: string;
+    enforce?: FarmClientPluginEnforce;
+    definition: FarmClientPlugin<any, TPublic>;
+    public?: TPublic;
+}
+interface FarmClientPluginManagerOptions {
+    router: FarmClientPluginRouter;
+    isDev?: boolean;
+    isProd?: boolean;
+    deploymentId?: string;
+    window?: Window;
+}
+declare class FarmClientPluginManager {
+    private readonly registrations;
+    private readonly options;
+    private readonly instances;
+    private readonly performanceObservers;
+    private startPromise?;
+    private closePromise?;
+    private currentNavigation?;
+    private navigationSequence;
+    private starting;
+    private started;
+    private closed;
+    private readonly reportedErrors;
+    private readonly handleWindowError;
+    private readonly handleUnhandledRejection;
+    private readonly handlePageHide;
+    constructor(registrations: readonly FarmClientPluginRegistration[], options: FarmClientPluginManagerOptions);
+    start(): Promise<void>;
+    beginHydration(input: {
+        container: Element;
+        mode: FarmClientHydrationMode;
+    }): Promise<FarmClientHydrationSession>;
+    completeHydration(session: FarmClientHydrationSession, options?: {
+        recovered?: boolean;
+    }): Promise<void>;
+    failHydration(session: FarmClientHydrationSession, error: unknown): Promise<void>;
+    beginNavigation(input: {
+        from?: string | URL | FarmClientLocation | null;
+        to: string | URL | FarmClientLocation;
+        action: FarmClientNavigationAction;
+        route?: FarmClientNavigationSession["route"];
+    }): Promise<FarmClientNavigationSession>;
+    markNavigationLoaded(session: FarmClientNavigationSession, data?: unknown): Promise<void>;
+    resolveNavigation(session: FarmClientNavigationSession): Promise<void>;
+    scheduleNavigationRendered(session: FarmClientNavigationSession): Promise<void>;
+    failNavigation(session: FarmClientNavigationSession, error: unknown): Promise<void>;
+    reportError(error: unknown, phase: FarmClientPluginErrorPhase, navigation?: FarmClientNavigationSession, location?: FarmClientLocation): Promise<void>;
+    close(reason?: FarmClientPluginCloseEvent["reason"]): Promise<void>;
+    getPlugins(): readonly FarmClientPluginMetadata[];
+    private startInternal;
+    private installBrowserListeners;
+    private installPerformanceObservers;
+    private closeInternal;
+    private runHook;
+    private runErrorHooks;
+    private createSetupEvent;
+    private createStateEvent;
+    private getLocation;
+    private getBaseUrl;
+    private logHookError;
+}
+declare function createClientPluginManager(registrations: readonly FarmClientPluginRegistration[], options: FarmClientPluginManagerOptions): FarmClientPluginManager;
+
+export { FarmClientPluginManager as F, type FarmClientHydrationCompleteEvent as a, type FarmClientHydrationEvent as b, createClientPluginManager as c, type FarmClientHydrationMode as d, type FarmClientHydrationSession as e, type FarmClientLocation as f, type FarmClientNavigationAction as g, type FarmClientNavigationErrorEvent as h, type FarmClientNavigationEvent as i, type FarmClientNavigationLoadedEvent as j, type FarmClientNavigationResolvedEvent as k, type FarmClientNavigationSession as l, type FarmClientPerformanceEvent as m, type FarmClientPlugin as n, type FarmClientPluginCloseEvent as o, type FarmClientPluginEnforce as p, type FarmClientPluginErrorEvent as q, type FarmClientPluginErrorPhase as r, type FarmClientPluginManagerOptions as s, type FarmClientPluginMetadata as t, type FarmClientPluginRegistration as u, type FarmClientPluginRouter as v, type FarmClientPluginSetupEvent as w, type FarmClientPluginStateEvent as x };

package/dist/plugin.cjs

@@ -21330,6 +21330,15 @@ __name(normalizeMiddlewareModule, "normalizeMiddlewareModule");
 
 // src/middleware/manager.ts
 init_response();
+
+// src/cli-colors.ts
+var import_picocolors = __toESM(require("picocolors"));
+function createCliColors(interactive = process.stdout.isTTY === true) {
+  return import_picocolors.default.createColors(interactive);
+}
+__name(createCliColors, "createCliColors");
+
+// src/middleware/manager.ts
 function isMiddlewareResponse(value) {
   return value instanceof Response;
 }
@@ -21486,23 +21495,16 @@ var _MiddlewareManager = class _MiddlewareManager {
     if (applicable.length === 0) {
       return false;
     }
-    try {
-      const pc = require("picocolors");
-      const middlewarePaths = applicable.map(({ mw }) => mw.path).join(", ");
-      const log = [
-        pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.magenta("MIDDLEWARE")) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
-        pc.gray("Executing middleware: "),
-        pc.gray(pathname),
-        pc.dim(` (${(Date.now() - startTime).toFixed(2)}ms)`)
-      ].join(" ");
-      console.log(log);
-    } catch {
-      console.log(
-        `[FARM] [MIDDLEWARE] [${method}] Executing ${pathname} (${applicable.length} middleware)`
-      );
-    }
+    const pc = createCliColors();
+    const log = [
+      pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.magenta("MIDDLEWARE")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
+      pc.gray("Executing middleware: "),
+      pc.gray(pathname),
+      pc.dim(` (${(Date.now() - startTime).toFixed(2)}ms)`)
+    ].join(" ");
+    console.log(log);
     for (const entry of applicable) {
       const { mw, routeMatch } = entry;
       const configMatch = mw.config ? this.matchesConfig(routePathname, mw.config, ctx) : { matched: true };
@@ -22874,18 +22876,14 @@ function farmPlugin(options = {}, initialPluginManager) {
   let refreshRouteDiscovery = null;
   let workflowHandler = null;
   const logUpdate = /* @__PURE__ */ __name((tag, message) => {
-    try {
-      const pc = require("picocolors");
-      const log = [
-        pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
-        pc.dim("[") + pc.bold(pc.yellow("UPDATE")) + pc.dim("]"),
-        pc.gray(message)
-      ].join(" ");
-      console.log(log);
-    } catch {
-      console.log(`[FARM] [${tag}] [UPDATE] ${message}`);
-    }
+    const pc = createCliColors();
+    const log = [
+      pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
+      pc.dim("[") + pc.bold(pc.yellow("UPDATE")) + pc.dim("]"),
+      pc.gray(message)
+    ].join(" ");
+    console.log(log);
   }, "logUpdate");
   return {
     name: "farm",
@@ -23326,25 +23324,21 @@ window.__FARM_MANIFEST__ = ${inlineValue({
           return;
         }
         logResponse.__last = { key: dedupeKey, ts: now };
-        try {
-          const pc = require("picocolors");
-          let statusColor = pc.green;
-          if (status >= 500) statusColor = pc.red;
-          else if (status >= 400) statusColor = pc.yellow;
-          else if (status >= 300) statusColor = pc.cyan;
-          const log = [
-            pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
-            pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
-            pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
-            pc.gray(urlPath),
-            pc.dim("-"),
-            statusColor(status.toString()),
-            pc.dim(`(${duration}ms)`)
-          ].join(" ");
-          console.log(log);
-        } catch {
-          console.log(`[FARM] [${tag}] [${method}] ${urlPath} - ${status} (${duration}ms)`);
-        }
+        const pc = createCliColors();
+        let statusColor = pc.green;
+        if (status >= 500) statusColor = pc.red;
+        else if (status >= 400) statusColor = pc.yellow;
+        else if (status >= 300) statusColor = pc.cyan;
+        const log = [
+          pc.dim("[") + pc.bold(pc.blue("FARM")) + pc.dim("]"),
+          pc.dim("[") + pc.bold(pc.cyan(tag)) + pc.dim("]"),
+          pc.dim("[") + pc.bold(pc.white(method.padEnd(3))) + pc.dim("]"),
+          pc.gray(urlPath),
+          pc.dim("-"),
+          statusColor(status.toString()),
+          pc.dim(`(${duration}ms)`)
+        ].join(" ");
+        console.log(log);
       }, "logResponse");
       server.middlewares.use(
         _withAfterNodeMiddleware(async (req, res, next) => {