@netlify/build 35.1.10 → 35.2.0

package/lib/core/build.d.ts

@@ -3,7 +3,7 @@ export declare const startBuild: (flags: Partial<BuildFlags>) => {
     debug: boolean;
     systemLogFile: number | undefined;
     errorMonitor: any;
-    logs: import("../log/logger.js").BufferedLogs | undefined;
+    logs: import("../log/logger.js").Logs | undefined;
     timers: never[];
     env: Record<string, unknown>;
     token: string;

package/lib/core/dev.d.ts

@@ -2,14 +2,14 @@ export function startDev(devCommand: any, flags?: {}): Promise<{
     success: boolean;
     severityCode: number;
     netlifyConfig: any;
-    logs: import("../log/logger.js").BufferedLogs | undefined;
+    logs: import("../log/logger.js").Logs | undefined;
     configMutations: any;
     generatedFunctions: import("../steps/return_values.js").GeneratedFunction[];
     error?: undefined;
 } | {
     success: boolean;
     severityCode: number;
-    logs: import("../log/logger.js").BufferedLogs | undefined;
+    logs: import("../log/logger.js").Logs | undefined;
     error: {
         message: string;
         stack: string;

package/lib/core/main.d.ts

@@ -1,4 +1,4 @@
-import type { BufferedLogs } from '../log/logger.js';
+import type { Logs } from '../log/logger.js';
 import { BuildFlags } from './types.js';
 /**
  * Main entry point of Netlify Build.
@@ -9,7 +9,7 @@ import { BuildFlags } from './types.js';
 export declare function buildSite(flags?: Partial<BuildFlags>): Promise<{
     success: boolean;
     severityCode: number;
-    logs: BufferedLogs | undefined;
+    logs: Logs | undefined;
     netlifyConfig?: any;
     configMutations?: any;
 }>;

package/lib/core/main.js

@@ -2,7 +2,7 @@ import { setMultiSpanAttributes, getGlobalContext } from '@netlify/opentelemetry
 import { trace, context } from '@opentelemetry/api';
 import { handleBuildError } from '../error/handle.js';
 import { reportError } from '../error/report.js';
-import { getSystemLogger } from '../log/logger.js';
+import { getLogsOutput, getSystemLogger } from '../log/logger.js';
 import { logTimer, logBuildSuccess } from '../log/messages/core.js';
 import { getGeneratedFunctions } from '../steps/return_values.js';
 import { trackBuildComplete } from '../telemetry/main.js';
@@ -82,7 +82,7 @@ export async function buildSite(flags = {}) {
                 success,
                 severityCode,
                 netlifyConfig: netlifyConfigA,
-                logs,
+                logs: getLogsOutput(logs),
                 configMutations,
                 generatedFunctions: getGeneratedFunctions(returnValues),
             };

package/lib/core/types.d.ts

@@ -42,6 +42,8 @@ export type BuildCLIFlags = {
 export type BuildFlags = BuildCLIFlags & {
     env?: Record<string, unknown>;
     eventHandlers?: EventHandlers;
+    /** Custom logger function to capture build output */
+    logger?: (message: string) => void;
 };
 type EventHandlers = {
     [K in keyof NetlifyPlugin]: NetlifyPlugin[K] | {

package/lib/error/monitor/start.d.ts

@@ -1,7 +1,7 @@
 import type { ResolvedFlags } from '../../core/normalize_flags.js';
-import { BufferedLogs } from '../../log/logger.js';
+import { Logs } from '../../log/logger.js';
 export declare const startErrorMonitor: (config: {
     flags: ResolvedFlags;
-    logs?: BufferedLogs;
+    logs?: Logs;
     bugsnagKey?: string;
 }) => any;

package/lib/index.d.ts

@@ -1,5 +1,6 @@
 import { buildSite } from './core/main.js';
 export { NetlifyPluginConstants } from './core/constants.js';
+export type { LogOutput as Logs } from './log/logger.js';
 export type { GeneratedFunction } from './steps/return_values.js';
 export type { NetlifyPlugin } from './types/netlify_plugin.js';
 export type { NetlifyPluginOptions } from './types/netlify_plugin_options.js';

package/lib/log/header_func.d.ts

@@ -1,2 +1,2 @@
 /** Retrieve successful or error header depending on whether `error` exists */
-export declare const getLogHeaderFunc: (error?: Error) => (logs: import("./logger.js").BufferedLogs | undefined, string: string, opts?: {}) => void;
+export declare const getLogHeaderFunc: (error?: Error) => (logs: import("./logger.js").Logs | undefined, string: string, opts?: {}) => void;

package/lib/log/logger.d.ts

@@ -8,6 +8,7 @@ export type BufferedLogs = {
 };
 export type StreamedLogs = {
     outputFlusher?: OutputFlusher;
+    logFunction?: (message: string) => void;
 };
 export declare const logsAreBuffered: (logs: Logs | undefined) => logs is BufferedLogs;
 /**
@@ -16,29 +17,32 @@ export declare const logsAreBuffered: (logs: Logs | undefined) => logs is Buffer
  */
 export declare const getBufferLogs: (config: {
     buffer?: boolean;
-}) => BufferedLogs | undefined;
+    logger?: (message: string) => void;
+}) => Logs | undefined;
 export declare const log: (logs: Logs | undefined, string: string, config?: {
     indent?: boolean;
     color?: (string: string) => string;
 }) => void;
-export declare const logError: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logWarning: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logMessage: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logObject: (logs: BufferedLogs | undefined, object: any, opts: any) => void;
-export declare const logArray: (logs: BufferedLogs | undefined, array: any, opts?: {}) => void;
-export declare const logErrorArray: (logs: BufferedLogs | undefined, array: any, opts?: {}) => void;
-export declare const logWarningArray: (logs: BufferedLogs | undefined, array: any, opts?: {}) => void;
-export declare const logHeader: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logErrorHeader: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logSubHeader: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logErrorSubHeader: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
-export declare const logWarningSubHeader: (logs: BufferedLogs | undefined, string: string, opts?: {}) => void;
+export type LogOutput = Pick<BufferedLogs, 'stderr' | 'stdout'>;
+export declare const getLogsOutput: (logs: Logs | undefined) => LogOutput;
+export declare const logError: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logWarning: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logMessage: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logObject: (logs: Logs | undefined, object: any, opts: any) => void;
+export declare const logArray: (logs: Logs | undefined, array: any, opts?: {}) => void;
+export declare const logErrorArray: (logs: Logs | undefined, array: any, opts?: {}) => void;
+export declare const logWarningArray: (logs: Logs | undefined, array: any, opts?: {}) => void;
+export declare const logHeader: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logErrorHeader: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logSubHeader: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logErrorSubHeader: (logs: Logs | undefined, string: string, opts?: {}) => void;
+export declare const logWarningSubHeader: (logs: Logs | undefined, string: string, opts?: {}) => void;
 export declare const reduceLogLines: (lines: any) => any;
 /**
  * Builds a function for logging data to the system logger (i.e. hidden from
  * the user-facing build logs)
  */
-export declare const getSystemLogger: (logs: BufferedLogs | undefined, debug: boolean, 
+export declare const getSystemLogger: (logs: Logs | undefined, debug: boolean, 
 /** A system log file descriptor, if non is provided it will be a noop logger */
 systemLogFile?: number) => SystemLogger;
 export declare const addOutputFlusher: (logs: Logs, outputFlusher: OutputFlusher) => Logs;

package/lib/log/logger.js

@@ -19,11 +19,13 @@ const EMPTY_LINE = '\u{200B}';
  * on the console. The logs are accumulated in a `logs` array variable.
  */
 export const getBufferLogs = (config) => {
-    const { buffer = false } = config;
-    if (!buffer) {
-        return;
+    const { buffer = false, logger } = config;
+    if (logger) {
+        return { logFunction: logger };
+    }
+    if (buffer) {
+        return { stdout: [], stderr: [] };
     }
-    return { stdout: [], stderr: [] };
 };
 // Core logging utility, used by the other methods.
 // This should be used instead of `console.log()` as it allows us to instrument
@@ -41,8 +43,21 @@ export const log = function (logs, string, config = {}) {
         logs.stdout.push(stringC);
         return;
     }
+    if (typeof logs?.logFunction === 'function') {
+        logs.logFunction(stringC);
+        return;
+    }
     console.log(stringC);
 };
+// Returns a `logs` object to be returned in the public interface,
+// always containing a `stderr` and `stdout` arrays, regardless of
+// whether the `buffer` input property was used.
+export const getLogsOutput = (logs) => {
+    if (!logs || !logsAreBuffered(logs)) {
+        return { stdout: [], stderr: [] };
+    }
+    return { stdout: logs.stdout, stderr: logs.stderr };
+};
 const serializeIndentedArray = function (array) {
     return serializeArray(array.map(serializeIndentedItem));
 };
@@ -144,14 +159,7 @@ systemLogFile) {
     });
     return (...args) => fileDescriptor.write(`${reduceLogLines(args)}\n`);
 };
-export const addOutputFlusher = (logs, outputFlusher) => {
-    if (logsAreBuffered(logs)) {
-        return {
-            ...logs,
-            outputFlusher,
-        };
-    }
-    return {
-        outputFlusher,
-    };
-};
+export const addOutputFlusher = (logs, outputFlusher) => ({
+    ...logs,
+    outputFlusher,
+});

package/lib/log/messages/config.js

@@ -54,9 +54,10 @@ const INTERNAL_FLAGS = [
     'enhancedSecretScan',
     'edgeFunctionsBootstrapURL',
     'eventHandlers',
+    'logger',
 ];
 const HIDDEN_FLAGS = [...SECURE_FLAGS, ...TEST_FLAGS, ...INTERNAL_FLAGS];
-const HIDDEN_DEBUG_FLAGS = [...SECURE_FLAGS, ...TEST_FLAGS, 'eventHandlers'];
+const HIDDEN_DEBUG_FLAGS = [...SECURE_FLAGS, ...TEST_FLAGS, 'eventHandlers', 'logger'];
 export const logBuildDir = function (logs, buildDir) {
     logSubHeader(logs, 'Current directory');
     logMessage(logs, buildDir);

package/lib/log/messages/core.d.ts

@@ -1,6 +1,6 @@
-import { BufferedLogs } from '../logger.js';
+import { Logs } from '../logger.js';
 import { OutputFlusher } from '../output_flusher.js';
-export declare const logBuildStart: (logs?: BufferedLogs) => void;
+export declare const logBuildStart: (logs?: Logs) => void;
 export declare const logBuildError: ({ error, netlifyConfig, logs, debug }: {
     error: any;
     netlifyConfig: any;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@netlify/build",
-  "version": "35.1.10",
+  "version": "35.2.0",
   "description": "Netlify build module",
   "type": "module",
   "exports": "./lib/index.js",
@@ -71,12 +71,12 @@
     "@netlify/cache-utils": "^6.0.4",
     "@netlify/config": "^24.0.5",
     "@netlify/edge-bundler": "14.5.6",
-    "@netlify/functions-utils": "^6.2.9",
+    "@netlify/functions-utils": "^6.2.10",
     "@netlify/git-utils": "^6.0.2",
     "@netlify/opentelemetry-utils": "^2.0.1",
     "@netlify/plugins-list": "^6.80.0",
     "@netlify/run-utils": "^6.0.2",
-    "@netlify/zip-it-and-ship-it": "14.1.9",
+    "@netlify/zip-it-and-ship-it": "14.1.10",
     "@sindresorhus/slugify": "^2.0.0",
     "ansi-escapes": "^7.0.0",
     "ansis": "^4.1.0",
@@ -152,5 +152,5 @@
   "engines": {
     "node": ">=18.14.0"
   },
-  "gitHead": "a98cd8ef9f09a4212343791b644502b7af9d158f"
+  "gitHead": "4aebfe99730221de3e3ebbd9edb119e1029ee596"
 }