@depup/netlify-cli 24.3.0-depup.0

package/dist/lib/edge-functions/headers.js

@@ -0,0 +1,43 @@
+import { Buffer } from 'buffer';
+export const headers = {
+    AIGateway: 'x-nf-ai-gateway',
+    BlobsInfo: 'x-nf-blobs-info',
+    DeployID: 'x-nf-deploy-id',
+    DeployContext: 'x-nf-deploy-context',
+    FeatureFlags: 'x-nf-feature-flags',
+    ForwardedHost: 'x-forwarded-host',
+    ForwardedProtocol: 'x-forwarded-proto',
+    Functions: 'x-nf-edge-functions',
+    InvocationMetadata: 'x-nf-edge-functions-metadata',
+    Geo: 'x-nf-geo',
+    Passthrough: 'x-nf-passthrough',
+    PassthroughHost: 'x-nf-passthrough-host',
+    PassthroughProtocol: 'x-nf-passthrough-proto',
+    IP: 'x-nf-client-connection-ip',
+    Site: 'X-NF-Site-Info',
+    DebugLogging: 'x-nf-debug-logging',
+    Account: 'x-nf-account-info',
+};
+/**
+ * Takes an array of feature flags and produces a Base64-encoded JSON object
+ * that the bootstrap layer can understand.
+ *
+ * @param {Array<string>} featureFlags
+ * @returns {string}
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'featureFlags' implicitly has an 'any' t... Remove this comment to see the full error message
+export const getFeatureFlagsHeader = (featureFlags) => {
+    // @ts-expect-error TS(7006) FIXME: Parameter 'acc' implicitly has an 'any' type.
+    const featureFlagsObject = featureFlags.reduce((acc, flagName) => ({ ...acc, [flagName]: true }), {});
+    return Buffer.from(JSON.stringify(featureFlagsObject)).toString('base64');
+};
+/**
+ * Takes the invocation metadata object and produces a Base64-encoded JSON
+ * object that the bootstrap layer can understand.
+ *
+ * @param {object} metadata
+ * @returns {string}
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'metadata' implicitly has an 'any' type.
+export const getInvocationMetadataHeader = (metadata) => Buffer.from(JSON.stringify(metadata)).toString('base64');
+//# sourceMappingURL=headers.js.map

package/dist/lib/edge-functions/headers.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"headers.js","sourceRoot":"","sources":["../../../src/lib/edge-functions/headers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAA;AAE/B,MAAM,CAAC,MAAM,OAAO,GAAG;IACrB,SAAS,EAAE,iBAAiB;IAC5B,SAAS,EAAE,iBAAiB;IAC5B,QAAQ,EAAE,gBAAgB;IAC1B,aAAa,EAAE,qBAAqB;IACpC,YAAY,EAAE,oBAAoB;IAClC,aAAa,EAAE,kBAAkB;IACjC,iBAAiB,EAAE,mBAAmB;IACtC,SAAS,EAAE,qBAAqB;IAChC,kBAAkB,EAAE,8BAA8B;IAClD,GAAG,EAAE,UAAU;IACf,WAAW,EAAE,kBAAkB;IAC/B,eAAe,EAAE,uBAAuB;IACxC,mBAAmB,EAAE,wBAAwB;IAC7C,EAAE,EAAE,2BAA2B;IAC/B,IAAI,EAAE,gBAAgB;IACtB,YAAY,EAAE,oBAAoB;IAClC,OAAO,EAAE,mBAAmB;CAC7B,CAAA;AAED;;;;;;GAMG;AACH,2IAA2I;AAC3I,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,YAAY,EAAE,EAAE;IACpD,iFAAiF;IACjF,MAAM,kBAAkB,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,GAAG,EAAE,CAAC,QAAQ,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAErG,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;AAC3E,CAAC,CAAA;AAED;;;;;;GAMG;AACH,sFAAsF;AACtF,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAAQ,EAAE,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA"}

package/dist/lib/edge-functions/proxy.d.ts

@@ -0,0 +1,50 @@
+import type { IncomingMessage, ClientRequest } from 'http';
+import * as bundler from '@netlify/edge-bundler';
+import type { AIGatewayContext } from '@netlify/ai/bootstrap';
+import type BaseCommand from '../../commands/base-command.js';
+import type { $TSFixMe } from '../../commands/types.js';
+import { type NormalizedCachedConfigConfig } from '../../utils/command-helpers.js';
+import { BlobsContextWithEdgeAccess } from '../blobs/blobs.js';
+import type { LocalState, ServerSettings } from '../../utils/types.js';
+export type EdgeFunctionDeclaration = bundler.Declaration;
+declare const headersSymbol: unique symbol;
+type ExtendedIncomingMessage = IncomingMessage & {
+    [headersSymbol]: Record<string, string>;
+};
+export declare const handleProxyRequest: (req: ExtendedIncomingMessage, proxyReq: ClientRequest) => void;
+export declare const createSiteInfoHeader: (siteInfo: {
+    id?: string | undefined;
+    name?: string | undefined;
+    url?: string | undefined;
+}, localURL?: string) => string;
+export declare const initializeProxy: ({ accountId, aiGatewayContext, blobsContext, command, config, configPath, debug, env: configEnv, geoCountry, geolocationMode, getUpdatedConfig, inspectSettings, mainPort, offline, passthroughPort, projectDir, repositoryRoot, settings, siteInfo, state, deployEnvironment, }: {
+    accountId: string;
+    aiGatewayContext?: AIGatewayContext | null;
+    blobsContext: BlobsContextWithEdgeAccess;
+    command: BaseCommand;
+    config: NormalizedCachedConfigConfig;
+    configPath: string;
+    debug: boolean;
+    env: $TSFixMe;
+    offline: $TSFixMe;
+    geoCountry: $TSFixMe;
+    geolocationMode: $TSFixMe;
+    getUpdatedConfig: () => Promise<NormalizedCachedConfigConfig>;
+    inspectSettings: $TSFixMe;
+    mainPort: $TSFixMe;
+    passthroughPort: $TSFixMe;
+    projectDir: string;
+    repositoryRoot?: string;
+    settings: ServerSettings;
+    siteInfo: $TSFixMe;
+    state: LocalState;
+    deployEnvironment: {
+        key: string;
+        value: string;
+        isSecret: boolean;
+        scopes: string[];
+    }[];
+}) => Promise<(req: ExtendedIncomingMessage) => Promise<string | undefined>>;
+export declare const isEdgeFunctionsRequest: (req: IncomingMessage) => req is ExtendedIncomingMessage;
+export {};
+//# sourceMappingURL=proxy.d.ts.map

package/dist/lib/edge-functions/proxy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.d.ts","sourceRoot":"","sources":["../../../src/lib/edge-functions/proxy.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,MAAM,CAAA;AAG1D,OAAO,KAAK,OAAO,MAAM,uBAAuB,CAAA;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAG7D,OAAO,KAAK,WAAW,MAAM,gCAAgC,CAAA;AAC7D,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AACvD,OAAO,EAEL,KAAK,4BAA4B,EAGlC,MAAM,gCAAgC,CAAA;AAEvC,OAAO,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAA;AAI9D,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAOtE,MAAM,MAAM,uBAAuB,GAAG,OAAO,CAAC,WAAW,CAAA;AAEzD,QAAA,MAAM,aAAa,eAAmC,CAAA;AAItD,KAAK,uBAAuB,GAAG,eAAe,GAAG;IAAE,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAAA;AAmB5F,eAAO,MAAM,kBAAkB,GAAI,KAAK,uBAAuB,EAAE,UAAU,aAAa,KAAG,IAI1F,CAAA;AAED,eAAO,MAAM,oBAAoB,GAC/B,UAAU;IAAE,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,EAC1F,WAAW,MAAM,KAChB,MAKF,CAAA;AAQD,eAAO,MAAM,eAAe,GAAU,kRAsBnC;IACD,SAAS,EAAE,MAAM,CAAA;IACjB,gBAAgB,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAA;IAC1C,YAAY,EAAE,0BAA0B,CAAA;IACxC,OAAO,EAAE,WAAW,CAAA;IACpB,MAAM,EAAE,4BAA4B,CAAA;IACpC,UAAU,EAAE,MAAM,CAAA;IAClB,KAAK,EAAE,OAAO,CAAA;IACd,GAAG,EAAE,QAAQ,CAAA;IACb,OAAO,EAAE,QAAQ,CAAA;IACjB,UAAU,EAAE,QAAQ,CAAA;IACpB,eAAe,EAAE,QAAQ,CAAA;IACzB,gBAAgB,EAAE,MAAM,OAAO,CAAC,4BAA4B,CAAC,CAAA;IAC7D,eAAe,EAAE,QAAQ,CAAA;IACzB,QAAQ,EAAE,QAAQ,CAAA;IAClB,eAAe,EAAE,QAAQ,CAAA;IACzB,UAAU,EAAE,MAAM,CAAA;IAClB,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,QAAQ,EAAE,cAAc,CAAA;IACxB,QAAQ,EAAE,QAAQ,CAAA;IAClB,KAAK,EAAE,UAAU,CAAA;IACjB,iBAAiB,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,EAAE,CAAA;CACzF,mBAwBoB,uBAAuB,iCAuD3C,CAAA;AAED,eAAO,MAAM,sBAAsB,GAAI,KAAK,eAAe,KAAG,GAAG,IAAI,uBAClC,CAAA"}

package/dist/lib/edge-functions/proxy.js

@@ -0,0 +1,159 @@
+import { Buffer } from 'buffer';
+import { rm } from 'fs/promises';
+import { join, resolve } from 'path';
+import * as bundler from '@netlify/edge-bundler';
+import getAvailablePort from 'get-port';
+import { NETLIFYDEVERR, chalk, logAndThrowError, } from '../../utils/command-helpers.js';
+import { getFeatureFlagsFromSiteInfo } from '../../utils/feature-flags.js';
+import { getGeoLocation } from '../geo-location.js';
+import { getPathInProject } from '../settings.js';
+import { startSpinner, stopSpinner } from '../spinner.js';
+import { getBootstrapURL } from './bootstrap.js';
+import { DIST_IMPORT_MAP_PATH, EDGE_FUNCTIONS_SERVE_FOLDER } from './consts.js';
+import { getFeatureFlagsHeader, getInvocationMetadataHeader, headers } from './headers.js';
+import { EdgeFunctionsRegistryImpl } from './registry.js';
+const headersSymbol = Symbol('Edge Functions Headers');
+const LOCAL_HOST = '127.0.0.1';
+const getDownloadUpdateFunctions = () => {
+    let spinner;
+    const onAfterDownload = (error_) => {
+        stopSpinner({ error: Boolean(error_), spinner });
+    };
+    const onBeforeDownload = () => {
+        spinner = startSpinner({ text: 'Setting up the Edge Functions environment. This may take a couple of minutes.' });
+    };
+    return {
+        onAfterDownload,
+        onBeforeDownload,
+    };
+};
+export const handleProxyRequest = (req, proxyReq) => {
+    Object.entries(req[headersSymbol]).forEach(([header, value]) => {
+        proxyReq.setHeader(header, value);
+    });
+};
+export const createSiteInfoHeader = (siteInfo, localURL) => {
+    const { id, name, url } = siteInfo;
+    const site = { id, name, url: localURL ?? url };
+    const siteString = JSON.stringify(site);
+    return Buffer.from(siteString).toString('base64');
+};
+const createAccountInfoHeader = ({ id }) => {
+    const account = { id };
+    const accountString = JSON.stringify(account);
+    return Buffer.from(accountString).toString('base64');
+};
+export const initializeProxy = async ({ accountId, aiGatewayContext, blobsContext, command, config, configPath, debug, env: configEnv, geoCountry, geolocationMode, getUpdatedConfig, inspectSettings, mainPort, offline, passthroughPort, projectDir, repositoryRoot, settings, siteInfo, state, deployEnvironment, }) => {
+    const isolatePort = await getAvailablePort();
+    const runtimeFeatureFlags = ['edge_functions_bootstrap_failure_mode', 'edge_functions_bootstrap_populate_environment'];
+    const protocol = settings.https ? 'https' : 'http';
+    const buildFeatureFlags = { ...getFeatureFlagsFromSiteInfo(siteInfo), edge_functions_npm_modules: true };
+    // Initializes the server, bootstrapping the Deno CLI and downloading it from
+    // the network if needed. We don't want to wait for that to be completed, or
+    // the command will be left hanging.
+    const server = prepareServer({
+        aiGatewayContext,
+        command,
+        config,
+        configPath,
+        debug,
+        env: configEnv,
+        featureFlags: buildFeatureFlags,
+        getUpdatedConfig,
+        inspectSettings,
+        port: isolatePort,
+        projectDir,
+        repositoryRoot,
+        deployEnvironment,
+    });
+    return async (req) => {
+        if (req.headers[headers.Passthrough] !== undefined) {
+            return;
+        }
+        const [geoLocation, registry] = await Promise.all([
+            getGeoLocation({ mode: geolocationMode, geoCountry, offline, state }),
+            server,
+        ]);
+        if (!registry)
+            return;
+        // Setting header with geolocation and site info.
+        req.headers[headers.Geo] = Buffer.from(JSON.stringify(geoLocation)).toString('base64');
+        req.headers[headers.DeployID] = '0';
+        req.headers[headers.DeployContext] = 'dev';
+        req.headers[headers.Site] = createSiteInfoHeader(siteInfo, `${protocol}://localhost:${mainPort}`);
+        req.headers[headers.Account] = createAccountInfoHeader({ id: accountId });
+        if (blobsContext?.edgeURL && blobsContext?.token) {
+            req.headers[headers.BlobsInfo] = Buffer.from(JSON.stringify({ url: blobsContext.edgeURL, url_uncached: blobsContext.edgeURL, token: blobsContext.token })).toString('base64');
+        }
+        if (aiGatewayContext) {
+            req.headers[headers.AIGateway] = Buffer.from(JSON.stringify(aiGatewayContext)).toString('base64');
+        }
+        await registry.initialize();
+        const url = new URL(req.url, `http://${LOCAL_HOST}:${mainPort}`);
+        const { functionNames, invocationMetadata } = registry.matchURLPath(url.pathname, req.method, req.headers);
+        if (functionNames.length === 0) {
+            return;
+        }
+        req[headersSymbol] = {
+            [headers.FeatureFlags]: getFeatureFlagsHeader(runtimeFeatureFlags),
+            [headers.ForwardedProtocol]: `${protocol}:`,
+            [headers.Functions]: functionNames.join(','),
+            [headers.InvocationMetadata]: getInvocationMetadataHeader(invocationMetadata),
+            [headers.IP]: LOCAL_HOST,
+            [headers.Passthrough]: 'passthrough',
+            [headers.PassthroughHost]: `localhost:${passthroughPort}`,
+            [headers.PassthroughProtocol]: 'http:',
+        };
+        if (debug) {
+            req[headersSymbol][headers.DebugLogging] = '1';
+        }
+        return `http://${LOCAL_HOST}:${isolatePort}`;
+    };
+};
+export const isEdgeFunctionsRequest = (req) => Object.hasOwn(req, headersSymbol);
+const prepareServer = async ({ aiGatewayContext, command, config, configPath, debug, env: configEnv, featureFlags, getUpdatedConfig, inspectSettings, port, projectDir, repositoryRoot, deployEnvironment, }) => {
+    try {
+        const distImportMapPath = getPathInProject([DIST_IMPORT_MAP_PATH]);
+        const servePath = resolve(projectDir, command.getPathInProject(EDGE_FUNCTIONS_SERVE_FOLDER));
+        await rm(servePath, { force: true, recursive: true });
+        const runIsolate = await bundler.serve({
+            ...getDownloadUpdateFunctions(),
+            basePath: projectDir,
+            bootstrapURL: await getBootstrapURL(),
+            debug,
+            distImportMapPath: join(projectDir, distImportMapPath),
+            featureFlags,
+            formatExportTypeError: (name) => `${NETLIFYDEVERR} ${chalk.red('Failed')} to load Edge Function ${chalk.yellow(name)}. The file does not seem to have a function as the default export.`,
+            formatImportError: (name) => `${NETLIFYDEVERR} ${chalk.red('Failed')} to run Edge Function ${chalk.yellow(name)}:`,
+            inspectSettings,
+            port,
+            rootPath: repositoryRoot,
+            servePath,
+        });
+        const registry = new EdgeFunctionsRegistryImpl({
+            aiGatewayContext,
+            bundler,
+            command,
+            config,
+            configPath,
+            debug,
+            env: configEnv,
+            featureFlags,
+            getUpdatedConfig,
+            importMapFromTOML: config.functions?.['*'].deno_import_map,
+            projectDir,
+            runIsolate,
+            servePath,
+            deployEnvironment: deployEnvironment
+                .filter(({ scopes }) => scopes.includes('functions'))
+                // Scopes should be opaque to the functions registry: We just filtered down to only variables
+                // should be applied to functions.
+                .map(({ scopes, ...rest }) => rest),
+        });
+        return registry;
+    }
+    catch (error) {
+        return logAndThrowError(error instanceof Error ? error.message : error?.toString());
+    }
+};
+//# sourceMappingURL=proxy.js.map

package/dist/lib/edge-functions/proxy.js.map

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

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

@@ -0,0 +1,138 @@
+import type { AIGatewayContext } from '@netlify/ai/bootstrap';
+import BaseCommand from '../../commands/base-command.js';
+import { type NormalizedCachedConfigConfig } from '../../utils/command-helpers.js';
+import type { FeatureFlags } from '../../utils/feature-flags.js';
+type RunIsolate = Awaited<ReturnType<typeof import('@netlify/edge-bundler').serve>>;
+interface EdgeFunctionsRegistryOptions {
+    aiGatewayContext?: AIGatewayContext | null;
+    bundler: typeof import('@netlify/edge-bundler');
+    command: BaseCommand;
+    config: NormalizedCachedConfigConfig;
+    configPath: string;
+    debug: boolean;
+    env: Record<string, {
+        sources: string[];
+        value: string;
+    }>;
+    featureFlags: FeatureFlags;
+    getUpdatedConfig: () => Promise<NormalizedCachedConfigConfig>;
+    importMapFromTOML?: string;
+    projectDir: string;
+    runIsolate: RunIsolate;
+    servePath: string;
+    deployEnvironment: {
+        key: string;
+        value: string;
+        isSecret: boolean;
+    }[];
+}
+/** Public contract for EdgeFunctionsRegistry - consumers should use this type */
+export interface EdgeFunctionsRegistry {
+    initialize(): Promise<void>;
+    matchURLPath(urlPath: string, method: string, headers: Record<string, string | string[] | undefined>): {
+        functionNames: string[];
+        invocationMetadata: unknown;
+    };
+}
+export declare class EdgeFunctionsRegistryImpl implements EdgeFunctionsRegistry {
+    importMapFromDeployConfig?: string;
+    private aiGatewayContext?;
+    private buildError;
+    /** @internal Exposed for testing - not part of the public EdgeFunctionsRegistry interface */
+    buildPending: boolean;
+    /** @internal Exposed for testing - not part of the public EdgeFunctionsRegistry interface */
+    buildPromise: Promise<{
+        warnings: Record<string, string[]>;
+    }> | null;
+    private bundler;
+    private configPath;
+    private importMapFromTOML?;
+    private declarationsFromDeployConfig;
+    private declarationsFromTOML;
+    private dependencyPaths;
+    private directoryWatchers;
+    private env;
+    private featureFlags;
+    private userFunctions;
+    private internalFunctions;
+    private functionPaths;
+    private getUpdatedConfig;
+    private initialScan;
+    private manifest;
+    private routes;
+    private runIsolate;
+    private servePath;
+    private projectDir;
+    private command;
+    constructor({ aiGatewayContext, bundler, command, config, configPath, env, featureFlags, getUpdatedConfig, importMapFromTOML, projectDir, runIsolate, servePath, deployEnvironment, }: EdgeFunctionsRegistryOptions);
+    private doInitialScan;
+    private get functions();
+    /**
+     * Triggers a build of edge functions with coalescing behavior.
+     *
+     * Note: We intentionally don't use @netlify/dev-utils memoize() here because
+     * it has a 300ms debounce and fire-and-forget logic. Edge function build
+     * needs callers to receive the latest build result.
+     *
+     * @internal Exposed for testing - not part of the public EdgeFunctionsRegistry interface
+     */
+    build(): Promise<{
+        warnings: Record<string, string[]>;
+    }>;
+    /** @internal Exposed for testing - not part of the public EdgeFunctionsRegistry interface */
+    doBuild(): Promise<{
+        warnings: Record<string, string[]>;
+    }>;
+    /**
+     * Builds a manifest and corresponding routes for the functions in the
+     * registry, taking into account the declarations from the TOML, from
+     * the deploy configuration API, and from the in-source configuration
+     * found in both internal and user functions.
+     */
+    private buildRoutes;
+    private checkForAddedOrDeletedFunctions;
+    private static getDeclarationsFromTOML;
+    private getDisplayName;
+    private static getEnvironmentVariables;
+    private handleFileChange;
+    initialize(): Promise<void>;
+    /**
+     * Logs an event associated with functions.
+     */
+    private logEvent;
+    /**
+     * Returns the functions in the registry that should run for a given URL path
+     * and HTTP method, based on the routes registered for each function.
+     */
+    matchURLPath(urlPath: string, method: string, headers: Record<string, string | string[] | undefined>): {
+        functionNames: string[];
+        invocationMetadata: {
+            function_config: Record<string, import("@netlify/edge-bundler").EdgeFunctionConfig> | undefined;
+            req_routes: number[];
+            routes: {
+                function: string;
+                path: string | undefined;
+                pattern: string;
+            }[];
+        };
+    };
+    /**
+     * Takes the module graph returned from the server and tracks dependencies of
+     * each function.
+     */
+    private processGraph;
+    /**
+     * Thin wrapper for `#runIsolate` that skips running a build and returns an
+     * empty response if there are no functions in the registry.
+     */
+    private runBuild;
+    private get internalImportMapPath();
+    private readDeployConfig;
+    private scanForDeployConfig;
+    private scanForFunctions;
+    private setupWatchers;
+    private setupWatcherForDirectory;
+    private get usesFrameworksAPI();
+}
+export {};
+//# sourceMappingURL=registry.d.ts.map

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

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