netlify 13.3.5 → 21.5.1

package/dist/lib/functions/netlify-function.js

@@ -0,0 +1,241 @@
+import { Buffer } from 'buffer';
+import { basename, extname } from 'path';
+import { version as nodeVersion } from 'process';
+import CronParser from 'cron-parser';
+import semver from 'semver';
+import { logAndThrowError } from '../../utils/command-helpers.js';
+import { BACKGROUND } from '../../utils/functions/get-functions.js';
+import { getBlobsEventProperty } from '../blobs/blobs.js';
+const TYPESCRIPT_EXTENSIONS = new Set(['.cts', '.mts', '.ts']);
+const V2_MIN_NODE_VERSION = '18.14.0';
+// Returns a new set with all elements of `setA` that don't exist in `setB`.
+const difference = (setA, setB) => new Set([...setA].filter((item) => !setB.has(item)));
+const getNextRun = function (schedule) {
+    const cron = CronParser.parseExpression(schedule, {
+        tz: 'Etc/UTC',
+    });
+    return cron.next().toDate();
+};
+export default class NetlifyFunction {
+    blobsContext;
+    config;
+    directory;
+    projectRoot;
+    timeoutBackground;
+    timeoutSynchronous;
+    settings;
+    displayName;
+    mainFile;
+    name;
+    runtime;
+    schedule;
+    // Determines whether this is a background function based on the function
+    // name.
+    isBackground;
+    buildQueue;
+    buildData;
+    buildError = null;
+    // List of the function's source files. This starts out as an empty set
+    // and will get populated on every build.
+    srcFiles = new Set();
+    constructor({ blobsContext, config, directory, displayName, mainFile, name, projectRoot, runtime, settings, timeoutBackground, timeoutSynchronous, }) {
+        this.blobsContext = blobsContext;
+        this.config = config;
+        this.directory = directory;
+        this.mainFile = mainFile;
+        this.name = name;
+        this.displayName = displayName ?? name;
+        this.projectRoot = projectRoot;
+        this.runtime = runtime;
+        this.timeoutBackground = timeoutBackground;
+        this.timeoutSynchronous = timeoutSynchronous;
+        this.settings = settings;
+        this.isBackground = name.endsWith(BACKGROUND);
+        const functionConfig = config.functions?.[name];
+        // @ts-expect-error -- XXX(serhalp): fixed in stack PR (bumps to https://github.com/netlify/build/pull/6165)
+        this.schedule = functionConfig && functionConfig.schedule;
+        this.srcFiles = new Set();
+    }
+    get filename() {
+        if (!this.buildData?.mainFile) {
+            return null;
+        }
+        return basename(this.buildData.mainFile);
+    }
+    getRecommendedExtension() {
+        if (this.buildData?.runtimeAPIVersion !== 2) {
+            return;
+        }
+        const extension = this.buildData.mainFile ? extname(this.buildData.mainFile) : undefined;
+        const moduleFormat = this.buildData.outputModuleFormat;
+        if (moduleFormat === 'esm') {
+            return;
+        }
+        if (extension === '.ts') {
+            return '.mts';
+        }
+        if (extension === '.js') {
+            return '.mjs';
+        }
+    }
+    hasValidName() {
+        // same as https://github.com/netlify/bitballoon/blob/fbd7881e6c8e8c48e7a0145da4ee26090c794108/app/models/deploy.rb#L482
+        return /^[A-Za-z0-9_-]+$/.test(this.name);
+    }
+    async isScheduled() {
+        await this.buildQueue;
+        return Boolean(this.schedule);
+    }
+    isSupported() {
+        return !(this.buildData?.runtimeAPIVersion === 2 && semver.lt(nodeVersion, V2_MIN_NODE_VERSION));
+    }
+    isTypeScript() {
+        if (this.filename === null) {
+            return false;
+        }
+        return TYPESCRIPT_EXTENSIONS.has(extname(this.filename));
+    }
+    async getNextRun() {
+        if (!(await this.isScheduled())) {
+            return null;
+        }
+        // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+        return getNextRun(this.schedule);
+    }
+    // The `build` method transforms source files into invocable functions. Its
+    // return value is an object with:
+    //
+    // - `srcFilesDiff`: Files that were added and removed since the last time
+    //    the function was built.
+    async build({ cache }) {
+        const buildFunction = await this.runtime.getBuildFunction({
+            config: this.config,
+            directory: this.directory,
+            errorExit: logAndThrowError,
+            func: this,
+            projectRoot: this.projectRoot,
+        });
+        this.buildQueue = buildFunction({ cache });
+        try {
+            const { includedFiles = [], schedule, srcFiles, ...buildData } = await this.buildQueue;
+            const srcFilesSet = new Set(srcFiles);
+            const srcFilesDiff = this.getSrcFilesDiff(srcFilesSet);
+            this.buildData = buildData;
+            this.buildError = null;
+            this.srcFiles = srcFilesSet;
+            this.schedule = schedule ?? this.schedule;
+            if (!this.isSupported()) {
+                throw new Error(`Function requires Node.js version ${V2_MIN_NODE_VERSION} or above, but ${nodeVersion.slice(1)} is installed. Refer to https://ntl.fyi/functions-runtime for information on how to update.`);
+            }
+            return { includedFiles, srcFilesDiff };
+        }
+        catch (error) {
+            if (error instanceof Error) {
+                this.buildError = error;
+            }
+            return { error };
+        }
+    }
+    async getBuildData() {
+        await this.buildQueue;
+        return this.buildData;
+    }
+    // Compares a new set of source files against a previous one, returning an
+    // object with two Sets, one with added and the other with deleted files.
+    getSrcFilesDiff(newSrcFiles) {
+        const added = difference(newSrcFiles, this.srcFiles);
+        const deleted = difference(this.srcFiles, newSrcFiles);
+        return {
+            added,
+            deleted,
+        };
+    }
+    // Invokes the function and returns its response object.
+    async invoke(event = {}, context = {}) {
+        await this.buildQueue;
+        if (this.buildError) {
+            // TODO(serhalp): I don't think this error handling works as expected. Investigate.
+            return { result: null, error: { errorType: '', stackTrace: [], errorMessage: this.buildError.message } };
+        }
+        const timeout = this.isBackground ? this.timeoutBackground : this.timeoutSynchronous;
+        if (timeout == null) {
+            throw new Error('Function timeout (`timeoutBackground` or `timeoutSynchronous`) not set');
+        }
+        const environment = {};
+        if (this.blobsContext) {
+            const payload = JSON.stringify(getBlobsEventProperty(this.blobsContext));
+            event.blobs = Buffer.from(payload).toString('base64');
+        }
+        try {
+            const result = await this.runtime.invokeFunction({
+                context,
+                environment,
+                event,
+                func: this,
+                timeout,
+            });
+            return { result, error: null };
+        }
+        catch (error) {
+            return { result: null, error: error };
+        }
+    }
+    /**
+     * Matches all routes agains the incoming request. If a match is found, then the matched route is returned.
+     * @returns matched route
+     */
+    async matchURLPath(rawPath, method, hasStaticFile) {
+        await this.buildQueue;
+        let path = rawPath !== '/' && rawPath.endsWith('/') ? rawPath.slice(0, -1) : rawPath;
+        path = path.toLowerCase();
+        const { excludedRoutes = [], routes = [] } = this.buildData ?? {};
+        const matchingRoute = routes.find((route) => {
+            if (route.methods && route.methods.length !== 0 && !route.methods.includes(method)) {
+                return false;
+            }
+            if ('literal' in route && route.literal !== undefined) {
+                return path === route.literal;
+            }
+            if ('expression' in route && route.expression !== undefined) {
+                const regex = new RegExp(route.expression);
+                return regex.test(path);
+            }
+            return false;
+        });
+        if (!matchingRoute) {
+            return;
+        }
+        const isExcluded = excludedRoutes.some((excludedRoute) => {
+            if ('literal' in excludedRoute && excludedRoute.literal !== undefined) {
+                return path === excludedRoute.literal;
+            }
+            if ('expression' in excludedRoute && excludedRoute.expression !== undefined) {
+                const regex = new RegExp(excludedRoute.expression);
+                return regex.test(path);
+            }
+            return false;
+        });
+        if (isExcluded) {
+            return;
+        }
+        if (matchingRoute.prefer_static && (await hasStaticFile())) {
+            return;
+        }
+        return matchingRoute;
+    }
+    get runtimeAPIVersion() {
+        return this.buildData?.runtimeAPIVersion ?? 1;
+    }
+    get url() {
+        // This line fixes the issue here https://github.com/netlify/cli/issues/4116
+        // Not sure why `settings.port` was used here nor does a valid reference exist.
+        // However, it remains here to serve whatever purpose for which it was added.
+        // @ts-expect-error(serhalp) -- Remove use of `port` here? Otherwise, pass it in from `functions:serve`.
+        const port = this.settings.port || this.settings.functionsPort;
+        // @ts-expect-error(serhalp) -- Same as above for `https`
+        const protocol = this.settings.https ? 'https' : 'http';
+        const url = new URL(`/.netlify/functions/${this.name}`, `${protocol}://localhost:${port}`);
+        return url.href;
+    }
+}
+//# sourceMappingURL=netlify-function.js.map

package/dist/lib/functions/netlify-function.js.map

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

package/dist/lib/functions/registry.d.ts

@@ -0,0 +1,121 @@
+import { type ListedFunction, listFunctions, type Manifest } from '@netlify/zip-it-and-ship-it';
+import { type NormalizedCachedConfigConfig } from '../../utils/command-helpers.js';
+import { getFrameworksAPIPaths } from '../../utils/frameworks-api.js';
+import type { BlobsContextWithEdgeAccess } from '../blobs/blobs.js';
+import type { ServerSettings } from '../../utils/types.js';
+import NetlifyFunction from './netlify-function.js';
+import { type BaseBuildResult } from './runtimes/index.js';
+export declare const DEFAULT_FUNCTION_URL_EXPRESSION: RegExp;
+export declare class FunctionsRegistry {
+    /**
+     * The functions held by the registry
+     */
+    private functions;
+    /**
+     * File watchers for function files. Maps function names to objects built
+     * by the `watchDebounced` utility.
+     */
+    private functionWatchers;
+    private directoryWatchers;
+    /**
+     * Keeps track of whether we've checked whether `TYPES_PACKAGE` is
+     * installed.
+     */
+    private hasCheckedTypesPackage;
+    /**
+     * Context object for Netlify Blobs
+     */
+    private blobsContext;
+    private buildCommandCache?;
+    private capabilities;
+    private config;
+    private debug;
+    private frameworksAPIPaths;
+    private isConnected;
+    private logLambdaCompat;
+    private manifest?;
+    private projectRoot;
+    private settings;
+    private timeouts;
+    constructor({ blobsContext, capabilities, config, debug, frameworksAPIPaths, isConnected, logLambdaCompat, manifest, projectRoot, settings, timeouts, }: {
+        blobsContext: BlobsContextWithEdgeAccess;
+        buildCache?: Record<string, unknown>;
+        capabilities: {
+            backgroundFunctions?: boolean;
+        };
+        config: NormalizedCachedConfigConfig;
+        debug?: boolean;
+        frameworksAPIPaths: ReturnType<typeof getFrameworksAPIPaths>;
+        isConnected?: boolean;
+        logLambdaCompat: boolean;
+        manifest?: Manifest;
+        projectRoot: string;
+        settings: Pick<ServerSettings, 'functions' | 'functionsPort'>;
+        timeouts: {
+            backgroundFunctions: number;
+            syncFunctions: number;
+        };
+    });
+    checkTypesPackage(): void;
+    static prepareDirectory(directory: string): Promise<void>;
+    /**
+     * Builds a function and sets up the appropriate file watchers so that any
+     * changes will trigger another build.
+     */
+    buildFunctionAndWatchFiles(func: NetlifyFunction<BaseBuildResult>, firstLoad?: boolean): Promise<void>;
+    /**
+     * Returns a function by name.
+     */
+    get(name: string): NetlifyFunction<BaseBuildResult> | undefined;
+    /**
+     * Looks for the first function that matches a given URL path. If a match is
+     * found, returns an object with the function and the route. If the URL path
+     * matches the default functions URL (i.e. can only be for a function) but no
+     * function with the given name exists, returns an object with the function
+     * and the route set to `null`. Otherwise, `undefined` is returned,
+     */
+    getFunctionForURLPath(urlPath: string, method: string, hasStaticFile: () => Promise<boolean>): Promise<{
+        func: null;
+        route: null;
+    } | {
+        func: NetlifyFunction<BaseBuildResult>;
+        route: null;
+    } | {
+        func: NetlifyFunction<BaseBuildResult>;
+        route: import("@netlify/zip-it-and-ship-it").ExtendedRoute;
+    } | undefined>;
+    /**
+     * Logs an event associated with functions.
+     */
+    private logEvent;
+    /**
+     * Adds a function to the registry
+     */
+    registerFunction(name: string, funcBeforeHook: NetlifyFunction<BaseBuildResult>, isReload?: boolean): Promise<void>;
+    /**
+     * A proxy to zip-it-and-ship-it's `listFunctions` method. It exists just so
+     * that we can mock it in tests.
+     */
+    listFunctions(...args: Parameters<typeof listFunctions>): Promise<ListedFunction[]>;
+    /**
+     * Takes a list of directories and scans for functions. It keeps tracks of
+     * any functions in those directories that we've previously seen, and takes
+     * care of registering and unregistering functions as they come and go.
+     */
+    scan(relativeDirs: (string | undefined)[]): Promise<void>;
+    /**
+     * Creates a watcher that looks at files being added or removed from a
+     * functions directory. It doesn't care about files being changed, because
+     * those will be handled by each functions' watcher.
+     */
+    setupDirectoryWatcher(directory: string): Promise<void>;
+    /**
+     * Removes a function from the registry and closes its file watchers.
+     */
+    unregisterFunction(func: NetlifyFunction<BaseBuildResult>): Promise<void>;
+    /**
+     * Takes a zipped function and extracts its contents to an internal directory.
+     */
+    unzipFunction(func: NetlifyFunction<BaseBuildResult>): Promise<string>;
+}
+//# sourceMappingURL=registry.d.ts.map

package/dist/lib/functions/registry.d.ts.map

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