netlify-cli 19.1.0 → 19.1.3

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

@@ -0,0 +1,266 @@
+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 { error as errorExit } 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 {
+    name;
+    mainFile;
+    displayName;
+    schedule;
+    runtime;
+    directory;
+    projectRoot;
+    blobsContext;
+    timeoutBackground;
+    timeoutSynchronous;
+    // 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({ 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'blobsContext' implicitly has an '... Remove this comment to see the full error message
+    blobsContext, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'config' implicitly has an 'any' t... Remove this comment to see the full error message
+    config, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'directory' implicitly has an 'any... Remove this comment to see the full error message
+    directory, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'displayName' implicitly has an 'a... Remove this comment to see the full error message
+    displayName, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'mainFile' implicitly has an 'any'... Remove this comment to see the full error message
+    mainFile, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'name' implicitly has an 'any' typ... Remove this comment to see the full error message
+    name, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'projectRoot' implicitly has an 'a... Remove this comment to see the full error message
+    projectRoot, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'runtime' implicitly has an 'any' ... Remove this comment to see the full error message
+    runtime, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'settings' implicitly has an 'any'... Remove this comment to see the full error message
+    settings, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'timeoutBackground' implicitly has... Remove this comment to see the full error message
+    timeoutBackground, 
+    // @ts-expect-error TS(7031) FIXME: Binding element 'timeoutSynchronous' implicitly ha... Remove this comment to see the full error message
+    timeoutSynchronous, }) {
+        this.blobsContext = blobsContext;
+        // @ts-expect-error TS(2339) FIXME: Property 'config' does not exist on type 'NetlifyF... Remove this comment to see the full error message
+        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;
+        // @ts-expect-error TS(2339) FIXME: Property 'settings' does not exist on type 'Netlif... Remove this comment to see the full error message
+        this.settings = settings;
+        this.isBackground = name.endsWith(BACKGROUND);
+        const functionConfig = config.functions && config.functions[name];
+        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
+        // eslint-disable-next-line unicorn/better-regex
+        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.
+    // @ts-expect-error TS(7031) FIXME: Binding element 'cache' implicitly has an 'any' ty... Remove this comment to see the full error message
+    async build({ cache }) {
+        // @ts-expect-error TS(2339) FIXME: Property 'runtime' does not exist on type 'Netlify... Remove this comment to see the full error message
+        const buildFunction = await this.runtime.getBuildFunction({
+            // @ts-expect-error TS(2339) FIXME: Property 'config' does not exist on type 'NetlifyF... Remove this comment to see the full error message
+            config: this.config,
+            directory: this.directory,
+            errorExit,
+            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;
+            // @ts-expect-error TS(2339) FIXME: Property 'srcFiles' does not exist on type 'Netlif... Remove this comment to see the full error message
+            this.srcFiles = srcFilesSet;
+            // @ts-expect-error TS(2339) FIXME: Property 'schedule' does not exist on type 'Netlif... Remove this comment to see the full error message
+            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) {
+            return { result: null, error: { errorMessage: this.buildError.message } };
+        }
+        const timeout = this.isBackground ? this.timeoutBackground : this.timeoutSynchronous;
+        const environment = {};
+        if (this.blobsContext) {
+            const payload = JSON.stringify(getBlobsEventProperty(this.blobsContext));
+            // @ts-expect-error TS(2339) FIXME: Property 'blobs' does not exist on type '{}'.
+            event.blobs = Buffer.from(payload).toString('base64');
+        }
+        try {
+            // @ts-expect-error TS(2339) FIXME: Property 'runtime' does not exist on type 'Netlify... Remove this comment to see the full error message
+            const result = await this.runtime.invokeFunction({
+                context,
+                environment,
+                event,
+                func: this,
+                timeout,
+            });
+            return { result, error: null };
+        }
+        catch (error) {
+            return { result: null, 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 TS(2339) FIXME: Property 'settings' does not exist on type 'Netlif... Remove this comment to see the full error message
+        const port = this.settings.port || this.settings.functionsPort;
+        // @ts-expect-error TS(2339) FIXME: Property 'settings' does not exist on type 'Netlif... Remove this comment to see the full error message
+        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,106 @@
+import { ListedFunction, listFunctions } from '@netlify/zip-it-and-ship-it';
+import { getFrameworksAPIPaths } from '../../utils/frameworks-api.js';
+import type { BlobsContext } from '../blobs/blobs.js';
+import NetlifyFunction from './netlify-function.js';
+export declare const DEFAULT_FUNCTION_URL_EXPRESSION: RegExp;
+/**
+ * @typedef {"buildError" | "extracted" | "loaded" | "missing-types-package" | "reloaded" | "reloading" | "removed"} FunctionEvent
+ */
+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;
+    /**
+     * Keeps track of whether we've checked whether `TYPES_PACKAGE` is
+     * installed.
+     */
+    private hasCheckedTypesPackage;
+    /**
+     * Context object for Netlify Blobs
+     */
+    private blobsContext;
+    private projectRoot;
+    private isConnected;
+    private debug;
+    private frameworksAPIPaths;
+    constructor({ blobsContext, capabilities, config, debug, frameworksAPIPaths, isConnected, logLambdaCompat, manifest, projectRoot, settings, timeouts, }: {
+        projectRoot: string;
+        debug?: boolean;
+        frameworksAPIPaths: ReturnType<typeof getFrameworksAPIPaths>;
+        isConnected?: boolean;
+        blobsContext: BlobsContext;
+    } & object);
+    checkTypesPackage(): void;
+    /**
+     * Runs before `scan` and calls any `onDirectoryScan` hooks defined by the
+     * runtime before the directory is read. This gives runtime the opportunity
+     * to run additional logic when a directory is scanned.
+     */
+    static prepareDirectoryScan(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, firstLoad?: boolean): Promise<void>;
+    /**
+     * Returns a function by name.
+     */
+    get(name: string): NetlifyFunction | 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;
+        route: any;
+    } | undefined>;
+    /**
+     * Logs an event associated with functions.
+     */
+    static logEvent(event: 'buildError' | 'extracted' | 'loaded' | 'missing-types-package' | 'reloaded' | 'reloading' | 'removed', { func, warnings }: {
+        func: NetlifyFunction;
+        warnings?: string[];
+    }): void;
+    /**
+     * Adds a function to the registry
+     */
+    registerFunction(name: string, funcBeforeHook: NetlifyFunction, 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): Promise<void>;
+    /**
+     * Takes a zipped function and extracts its contents to an internal directory.
+     */
+    unzipFunction(func: NetlifyFunction): 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":"AAKA,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAa3E,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAA;AAErE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAIrD,OAAO,eAAe,MAAM,uBAAuB,CAAA;AAGnD,eAAO,MAAM,+BAA+B,QAAiD,CAAA;AAQ7F;;GAEG;AAEH,qBAAa,iBAAiB;IAC5B;;OAEG;IACH,OAAO,CAAC,SAAS,CAAqC;IAEtD;;;OAGG;IACH,OAAO,CAAC,gBAAgB,CAAgE;IAExF;;;OAGG;IACH,OAAO,CAAC,sBAAsB,CAAQ;IAEtC;;OAEG;IACH,OAAO,CAAC,YAAY,CAAc;IAElC,OAAO,CAAC,WAAW,CAAQ;IAC3B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,kBAAkB,CAA0C;gBAExD,EACV,YAAY,EAEZ,YAAY,EAEZ,MAAM,EACN,KAAa,EACb,kBAAkB,EAClB,WAAmB,EAEnB,eAAe,EAEf,QAAQ,EACR,WAAW,EAEX,QAAQ,EAER,QAAQ,GACT,EAAE;QACD,WAAW,EAAE,MAAM,CAAA;QACnB,KAAK,CAAC,EAAE,OAAO,CAAA;QACf,kBAAkB,EAAE,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;QAC5D,WAAW,CAAC,EAAE,OAAO,CAAA;QACrB,YAAY,EAAE,YAAY,CAAA;KAC3B,GAAG,MAAM;IAqDV,iBAAiB;IAoBjB;;;;OAIG;WACU,oBAAoB,CAAC,SAAS,EAAE,MAAM;IAmBnD;;;OAGG;IACG,0BAA0B,CAAC,IAAI,EAAE,eAAe,EAAE,SAAS,UAAQ;IAsEzE;;OAEG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM;IAIhB;;;;;;OAMG;IACG,qBAAqB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC;;;;;;;IAyClG;;OAEG;IACH,MAAM,CAAC,QAAQ,CACb,KAAK,EAAE,YAAY,GAAG,WAAW,GAAG,QAAQ,GAAG,uBAAuB,GAAG,UAAU,GAAG,WAAW,GAAG,SAAS,EAC7G,EAAE,IAAI,EAAE,QAAa,EAAE,EAAE;QAAE,IAAI,EAAE,eAAe,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;IAoEzE;;OAEG;IACG,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,QAAQ,UAAQ;IAsEtF;;;OAGG;IAEG,aAAa,CAAC,GAAG,IAAI,EAAE,UAAU,CAAC,OAAO,aAAa,CAAC;IAI7D;;;;OAIG;IACG,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,GAAG,SAAS,CAAC,EAAE;IAkH/C;;;;OAIG;IACG,qBAAqB,CAAC,SAAS,EAAE,MAAM;IAoB7C;;OAEG;IACG,kBAAkB,CAAC,IAAI,EAAE,eAAe;IAc9C;;OAEG;IACG,aAAa,CAAC,IAAI,EAAE,eAAe;CAU1C"}