@depup/netlify-cli 24.3.0-depup.0

package/dist/utils/env/index.js

@@ -0,0 +1,260 @@
+import { logAndThrowError } from '../command-helpers.js';
+/**
+ * Supported values for the user-provided env `context` option.
+ * These all match possible `context` values returned by the Envelope API.
+ * Note that a user may also specify a branch name with the special `branch:my-branch-name` format.
+ */
+export const SUPPORTED_CONTEXTS = ['all', 'production', 'deploy-preview', 'branch-deploy', 'dev', 'dev-server'];
+/**
+ * Additional aliases for the user-provided env `context` option.
+ */
+const SUPPORTED_CONTEXT_ALIASES = {
+    dp: 'deploy-preview',
+    prod: 'production',
+};
+/**
+ * Supported values for the user-provided env `scope` option.
+ * These exactly match possible `scope` values returned by the Envelope API.
+ * Note that `any` is also supported.
+ */
+export const ALL_ENVELOPE_SCOPES = ['builds', 'functions', 'runtime', 'post_processing'];
+/**
+ * Normalizes a user-provided "context". Note that this may be the special `branch:my-branch-name` format.
+ *
+ * - If this is a supported alias of a context, it will be normalized to the canonical context.
+ * - Valid canonical contexts are returned as is.
+ * - If this starts with `branch:`, it will be normalized to the branch name.
+ *
+ * @param context A user-provided context, context alias, or a string in the `branch:my-branch-name` format.
+ *
+ * @returns The normalized context name or just the branch name
+ */
+export const normalizeContext = (context) => {
+    if (!context) {
+        return context;
+    }
+    context = context.toLowerCase();
+    if (context in SUPPORTED_CONTEXT_ALIASES) {
+        context = SUPPORTED_CONTEXT_ALIASES[context];
+    }
+    const forbiddenContexts = SUPPORTED_CONTEXTS.map((ctx) => `branch:${ctx}`);
+    if (forbiddenContexts.includes(context)) {
+        return logAndThrowError(`The context ${context} includes a reserved keyword and is not allowed`);
+    }
+    return context.replace(/^branch:/, '');
+};
+/**
+ * Finds a matching environment variable value for a given context
+ * @private
+ */
+export const getValueForContext = (
+/**
+ * An array of environment variable values from Envelope
+ */
+values, 
+/**
+ * The deploy context or branch of the environment variable value
+ */
+contextOrBranch) => {
+    const isSupportedContext = SUPPORTED_CONTEXTS.includes(contextOrBranch);
+    if (!isSupportedContext) {
+        // FIXME(ndhoule): If it's not a supported context, we just assume this is a branch deploy. This
+        // means that if you ever add a deploy context but forget to add it to SUPPORTED_CONTEXTS, we'll
+        // just load the wrong environment variables. (This bug is not theoretical: it's why I'm writing
+        // this comment.) We should instead pass a `context` and optional `branch` parameter to this
+        // function rather than mix the two concepts, and we should fail when an unsupported context is
+        // provided.
+        const valueMatchingAsBranch = values.find((val) => val.context_parameter === contextOrBranch);
+        // This is a `branch` context, which is an override, so it takes precedence
+        if (valueMatchingAsBranch != null) {
+            return valueMatchingAsBranch;
+        }
+        const valueMatchingContext = values.find((val) => val.context === 'all' || val.context === 'branch-deploy');
+        return valueMatchingContext ?? undefined;
+    }
+    const valueMatchingAsContext = values.find((val) => val.context === 'all' || val.context === contextOrBranch);
+    return valueMatchingAsContext ?? undefined;
+};
+/**
+ * Finds environment variables that match a given source
+ * @param env - The dictionary of environment variables
+ * @param source - The source of the environment variable
+ * @returns The dictionary of env vars that match the given source
+ */
+export const filterEnvBySource = (env, source) => Object.fromEntries(Object.entries(env).filter(([, variable]) => variable.sources[0] === source));
+const fetchEnvelopeItems = async function ({ accountId, api, key, siteId, }) {
+    if (accountId === undefined) {
+        return [];
+    }
+    try {
+        // if a single key is passed, fetch that single env var
+        if (key) {
+            const envelopeItem = await api.getEnvVar({ accountId, key, siteId });
+            // See FIXME(serhalp) above
+            return [envelopeItem];
+        }
+        // otherwise, fetch the entire list of env vars
+        const envelopeItems = await api.getEnvVars({ accountId, siteId });
+        // See FIXME(serhalp) above
+        return envelopeItems;
+    }
+    catch {
+        // Collaborators aren't allowed to read shared env vars,
+        // so return an empty array silently in that case
+        return [];
+    }
+};
+/**
+ * Filters and sorts data from Envelope by a given context and/or scope
+ * @param context - The deploy context or branch of the environment variable value
+ * @param envelopeItems - An array of environment variables from the Envelope service
+ * @param scope - The scope of the environment variables
+ * @param source - The source of the environment variable
+ * @returns A dicionary in the following format:
+ * {
+ *   FOO: {
+ *     context: 'dev',
+ *     scopes: ['builds', 'functions'],
+ *     sources: ['ui'],
+ *     value: 'bar',
+ *   },
+ *   BAZ: {
+ *     context: 'branch',
+ *     branch: 'staging',
+ *     scopes: ['runtime'],
+ *     sources: ['account'],
+ *     value: 'bang',
+ *   },
+ * }
+ */
+export const formatEnvelopeData = ({ context = 'dev', envelopeItems = [], scope = 'any', source, }) => envelopeItems
+    // filter by context
+    .filter(({ values }) => Boolean(getValueForContext(values, context)))
+    // filter by scope
+    .filter(({ scopes }) => (scope === 'any' ? true : scopes.includes(scope)))
+    // sort alphabetically, case insensitive
+    .sort((left, right) => (left.key.toLowerCase() < right.key.toLowerCase() ? -1 : 1))
+    // format the data
+    .reduce((acc, cur) => {
+    const val = getValueForContext(cur.values, context);
+    if (val === undefined) {
+        throw new TypeError(`failed to locate environment variable value for ${context} context`);
+    }
+    const { context: itemContext, context_parameter: branch, value } = val;
+    return {
+        ...acc,
+        [cur.key]: {
+            context: itemContext,
+            branch,
+            scopes: cur.scopes,
+            sources: [source],
+            value,
+        },
+    };
+}, {});
+/**
+ * Collects env vars from multiple sources and arranges them in the correct order of precedence
+ * @param opts.api The api singleton object
+ * @param opts.context The deploy context or branch of the environment variable
+ * @param opts.env The dictionary of environment variables
+ * @param opts.key If present, fetch a single key (case-sensitive)
+ * @param opts.raw Return a dictionary of raw key/value pairs for only the account and site sources
+ * @param opts.scope The scope of the environment variables
+ * @param opts.siteInfo The site object
+ * @returns An object of environment variables keys and their metadata
+ */
+export const getEnvelopeEnv = async ({ api, context = 'dev', env, key = '', raw = false, scope = 'any', siteInfo, }) => {
+    const { account_slug: accountId, id: siteId } = siteInfo;
+    const [accountEnvelopeItems, siteEnvelopeItems] = await Promise.all([
+        fetchEnvelopeItems({ api, accountId, key }),
+        fetchEnvelopeItems({ api, accountId, key, siteId }),
+    ]);
+    const accountEnv = formatEnvelopeData({ context, envelopeItems: accountEnvelopeItems, scope, source: 'account' });
+    const siteEnv = formatEnvelopeData({ context, envelopeItems: siteEnvelopeItems, scope, source: 'ui' });
+    if (raw) {
+        const entries = Object.entries({ ...accountEnv, ...siteEnv });
+        return entries.reduce((obj, [envVarKey, metadata]) => ({
+            ...obj,
+            [envVarKey]: metadata.value,
+        }), {});
+    }
+    const generalEnv = filterEnvBySource(env, 'general');
+    const internalEnv = filterEnvBySource(env, 'internal');
+    const addonsEnv = filterEnvBySource(env, 'addons');
+    const configFileEnv = filterEnvBySource(env, 'configFile');
+    // filter out configFile env vars if a non-configFile scope is passed
+    const includeConfigEnvVars = /any|builds|post[-_]processing/.test(scope);
+    // Sources of environment variables, in ascending order of precedence.
+    return {
+        ...generalEnv,
+        ...accountEnv,
+        ...(includeConfigEnvVars ? addonsEnv : {}),
+        ...siteEnv,
+        ...(includeConfigEnvVars ? configFileEnv : {}),
+        ...internalEnv,
+    };
+};
+/**
+ * Returns a human-readable, comma-separated list of scopes
+ * @param scopes An array of scopes
+ * @returns A human-readable, comma-separated list of scopes
+ */
+export const getHumanReadableScopes = (scopes) => {
+    const HUMAN_SCOPES = ['Builds', 'Functions', 'Runtime', 'Post processing'];
+    const SCOPES_MAP = {
+        builds: HUMAN_SCOPES[0],
+        functions: HUMAN_SCOPES[1],
+        runtime: HUMAN_SCOPES[2],
+        post_processing: HUMAN_SCOPES[3],
+        // TODO(serhalp) I believe this isn't needed, as `post-processing` is a user-provided
+        // CLI option, not a scope returned by the Envelope API.
+        'post-processing': HUMAN_SCOPES[3],
+    };
+    if (!scopes) {
+        // if `scopes` is not available, the env var comes from netlify.toml
+        // env vars specified in netlify.toml are present in the `builds` and `post_processing` scope
+        return 'Builds, Post processing';
+    }
+    if (scopes.length === Object.keys(HUMAN_SCOPES).length) {
+        // shorthand instead of listing every available scope
+        return 'All';
+    }
+    return scopes.map((scope) => SCOPES_MAP[scope]).join(', ');
+};
+/**
+ * Translates a Mongo env into an Envelope env
+ * @param env The site's env as it exists in Mongo
+ * @returns The array of Envelope env vars
+ */
+export const translateFromMongoToEnvelope = (env = {}) => {
+    const envVars = Object.entries(env).map(([key, value]) => ({
+        key,
+        scopes: ALL_ENVELOPE_SCOPES,
+        values: [
+            {
+                context: 'all',
+                value,
+            },
+        ],
+    }));
+    return envVars;
+};
+/**
+ * Translates an Envelope env into a Mongo env
+ * @param envVars The array of Envelope env vars
+ * @param context The deploy context or branch of the environment variable
+ * @returns The env object as compatible with Mongo
+ */
+export const translateFromEnvelopeToMongo = (envVars = [], context = 'dev') => envVars
+    .sort((a, b) => (a.key.toLowerCase() < b.key.toLowerCase() ? -1 : 1))
+    .reduce((acc, cur) => {
+    const envVar = cur.values.find((val) => [context, 'all'].includes((val.context_parameter ?? '') || val.context));
+    if (envVar && envVar.value) {
+        return {
+            ...acc,
+            [cur.key]: envVar.value,
+        };
+    }
+    return acc;
+}, {});
+//# sourceMappingURL=index.js.map

package/dist/utils/env/index.js.map

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

package/dist/utils/execa.d.ts

@@ -0,0 +1,4 @@
+import execaLib from 'execa';
+declare let execa: typeof execaLib;
+export default execa;
+//# sourceMappingURL=execa.d.ts.map

package/dist/utils/execa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"execa.d.ts","sourceRoot":"","sources":["../../src/utils/execa.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,MAAM,OAAO,CAAA;AAM5B,QAAA,IAAI,KAAK,EAAE,OAAO,QAAQ,CAAA;AAS1B,eAAe,KAAK,CAAA"}

package/dist/utils/execa.js

@@ -0,0 +1,15 @@
+import { env } from 'process';
+import execaLib from 'execa';
+// This is a thin layer on top of `execa` that allows consumers to provide an
+// alternative path to the module location, making it easier to mock its logic
+// in tests (see `tests/integration/utils/mock-execa.ts`).
+let execa;
+if (env.NETLIFY_CLI_EXECA_PATH) {
+    const execaMock = await import(env.NETLIFY_CLI_EXECA_PATH);
+    execa = execaMock.default;
+}
+else {
+    execa = execaLib;
+}
+export default execa;
+//# sourceMappingURL=execa.js.map

package/dist/utils/execa.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"execa.js","sourceRoot":"","sources":["../../src/utils/execa.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,SAAS,CAAA;AAE7B,OAAO,QAAQ,MAAM,OAAO,CAAA;AAE5B,6EAA6E;AAC7E,8EAA8E;AAC9E,0DAA0D;AAE1D,IAAI,KAAsB,CAAA;AAE1B,IAAI,GAAG,CAAC,sBAAsB,EAAE,CAAC;IAC/B,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAA;IAC1D,KAAK,GAAG,SAAS,CAAC,OAAO,CAAA;AAC3B,CAAC;KAAM,CAAC;IACN,KAAK,GAAG,QAAQ,CAAA;AAClB,CAAC;AAED,eAAe,KAAK,CAAA"}

package/dist/utils/feature-flags.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Allows us to check if a feature flag is enabled for a site.
+ * Due to versioning of the cli, and the desire to remove flags from
+ * our feature flag service when they should always evaluate to true,
+ * we can't just look for the presense of {featureFlagName: true}, as
+ * the absense of a flag should also evaluate to the flag being enabled.
+ * Instead, we return that the feature flag is enabled if it isn't
+ * specifically set to false in the response
+ */
+export declare const isFeatureFlagEnabled: (flagName: string, siteInfo: {
+    feature_flags?: Record<string, string | boolean> | undefined;
+}) => boolean;
+/**
+ * Retrieves all Feature flags from the siteInfo
+ */
+export declare const getFeatureFlagsFromSiteInfo: (siteInfo: {
+    feature_flags?: Record<string, string | boolean> | undefined;
+}) => FeatureFlags;
+export type FeatureFlags = Record<string, boolean | string | number>;
+//# sourceMappingURL=feature-flags.d.ts.map

package/dist/utils/feature-flags.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.d.ts","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,eAAO,MAAM,oBAAoB,GAC/B,UAAU,MAAM,EAChB,UAAU;IAAE,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAA;CAAE,KACzE,OAAwF,CAAA;AAE3F;;GAEG;AACH,eAAO,MAAM,2BAA2B,GAAI,UAAU;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,GAAG,SAAS,CAAA;CAC7D,KAAG,YAKF,CAAA;AAEF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA"}

package/dist/utils/feature-flags.js

@@ -0,0 +1,20 @@
+/**
+ * Allows us to check if a feature flag is enabled for a site.
+ * Due to versioning of the cli, and the desire to remove flags from
+ * our feature flag service when they should always evaluate to true,
+ * we can't just look for the presense of {featureFlagName: true}, as
+ * the absense of a flag should also evaluate to the flag being enabled.
+ * Instead, we return that the feature flag is enabled if it isn't
+ * specifically set to false in the response
+ */
+export const isFeatureFlagEnabled = (flagName, siteInfo) => Boolean(siteInfo.feature_flags && siteInfo.feature_flags[flagName] !== false);
+/**
+ * Retrieves all Feature flags from the siteInfo
+ */
+export const getFeatureFlagsFromSiteInfo = (siteInfo) => ({
+    ...siteInfo.feature_flags,
+    // see https://github.com/netlify/pod-dev-foundations/issues/581#issuecomment-1731022753
+    zisi_golang_use_al2: isFeatureFlagEnabled('cli_golang_use_al2', siteInfo),
+    netlify_build_frameworks_api: true,
+});
+//# sourceMappingURL=feature-flags.js.map

package/dist/utils/feature-flags.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feature-flags.js","sourceRoot":"","sources":["../../src/utils/feature-flags.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,QAAgB,EAChB,QAA0E,EACjE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,CAAA;AAE3F;;GAEG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CAAC,QAE3C,EAAgB,EAAE,CAAC,CAAC;IACnB,GAAG,QAAQ,CAAC,aAAa;IACzB,wFAAwF;IACxF,mBAAmB,EAAE,oBAAoB,CAAC,oBAAoB,EAAE,QAAQ,CAAC;IACzE,4BAA4B,EAAE,IAAI;CACnC,CAAC,CAAA"}

package/dist/utils/framework-server.d.ts

@@ -0,0 +1,13 @@
+import type { ServerSettings } from './types.js';
+interface StartReturnObject {
+    ipVersion?: 4 | 6;
+}
+/**
+ * Start a static server if the `useStaticServer` is provided or a framework specific server
+ */
+export declare const startFrameworkServer: ({ cwd, settings, }: {
+    cwd: string;
+    settings: ServerSettings;
+}) => Promise<StartReturnObject>;
+export {};
+//# sourceMappingURL=framework-server.d.ts.map

package/dist/utils/framework-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framework-server.d.ts","sourceRoot":"","sources":["../../src/utils/framework-server.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAKhD,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,GAAmB,oBAGjD;IACD,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,cAAc,CAAA;CACzB,KAAG,OAAO,CAAC,iBAAiB,CAyE5B,CAAA"}

package/dist/utils/framework-server.js

@@ -0,0 +1,66 @@
+import { rm } from 'node:fs/promises';
+import { startSpinner, stopSpinner } from '../lib/spinner.js';
+import { waitPort } from '../lib/wait-port.js';
+import { logAndThrowError, log, NETLIFYDEVERR, NETLIFYDEVLOG, chalk } from './command-helpers.js';
+import { runCommand } from './shell.js';
+import { startStaticServer } from './static-server.js';
+const FRAMEWORK_PORT_TIMEOUT_MS = 10 * 60 * 1000;
+const FRAMEWORK_PORT_WARN_TIMEOUT_MS = 5 * 1000;
+/**
+ * Start a static server if the `useStaticServer` is provided or a framework specific server
+ */
+export const startFrameworkServer = async function ({ cwd, settings, }) {
+    if (settings.useStaticServer) {
+        if (settings.command) {
+            runCommand(settings.command, { env: settings.env, cwd });
+        }
+        const { family } = await startStaticServer({ settings });
+        return { ipVersion: family === 'IPv6' ? 6 : 4 };
+    }
+    log('');
+    log(`${NETLIFYDEVLOG} Starting ${settings.framework || 'framework'} dev server`);
+    const spinner = startSpinner({
+        text: `Waiting for ${settings.framework || 'framework'} dev server to be ready on port ${settings.frameworkPort}`,
+    });
+    if (settings.clearPublishDirectory && settings.dist) {
+        await rm(settings.dist, { recursive: true, force: true });
+    }
+    if (settings.command) {
+        runCommand(settings.command, { env: settings.env, spinner, cwd });
+    }
+    let port;
+    try {
+        if (settings.skipWaitPort) {
+            // default ip version based on node version
+            const ipVersion = parseInt(process.versions.node.split('.')[0]) >= 18 ? 6 : 4;
+            port = { open: true, ipVersion };
+        }
+        else {
+            const waitPortPromise = waitPort(
+            // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+            settings.frameworkPort, 'localhost', FRAMEWORK_PORT_TIMEOUT_MS, 20);
+            const timerId = setTimeout(() => {
+                if (!port?.open) {
+                    spinner.update({
+                        text: `Still waiting for server on port ${settings.frameworkPort} to be ready. Are you sure this is the correct port${settings.framework ? ` for ${settings.framework}` : ''}? Change this with the ${chalk.yellow('targetPort')} option in your ${chalk.yellow('netlify.toml')}.`,
+                    });
+                }
+            }, FRAMEWORK_PORT_WARN_TIMEOUT_MS);
+            port = await waitPortPromise;
+            clearTimeout(timerId);
+            if (!port.open) {
+                throw new Error(`Timed out waiting for port '${settings.frameworkPort}' to be open`);
+            }
+        }
+        spinner.success(`${settings.framework || 'framework'} dev server ready on port ${settings.frameworkPort}`);
+    }
+    catch (error_) {
+        stopSpinner({ error: true, spinner });
+        log(NETLIFYDEVERR, `Netlify Dev could not start or connect to localhost:${settings.frameworkPort}.`);
+        log(NETLIFYDEVERR, `Please make sure your framework server is running on port ${settings.frameworkPort}`);
+        log(NETLIFYDEVERR, `If not, you can configure it using the ${chalk.yellow('targetPort')} option in your ${chalk.yellow('netlify.toml')}.`);
+        return logAndThrowError(error_);
+    }
+    return { ipVersion: port.ipVersion };
+};
+//# sourceMappingURL=framework-server.js.map

package/dist/utils/framework-server.js.map

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

package/dist/utils/frameworks-api.d.ts

@@ -0,0 +1,20 @@
+import type { NetlifyOptions } from '../commands/types.js';
+interface FrameworksAPIPath {
+    path: string;
+    ensureExists: () => Promise<void>;
+    exists: () => Promise<boolean>;
+}
+export type FrameworksAPIPaths = ReturnType<typeof getFrameworksAPIPaths>;
+/**
+ * Returns an object containing the paths for all the operations of the
+ * Frameworks API. Each key maps to an object containing a `path` property with
+ * the path of the operation, an `exists` method that returns whether the path
+ * exists, and an `ensureExists` method that creates it in case it doesn't.
+ */
+export declare const getFrameworksAPIPaths: (basePath: string, packagePath?: string) => Record<"config" | "functions" | "blobs" | "root" | "edgeFunctions" | "edgeFunctionsImportMap", FrameworksAPIPath>;
+/**
+ * Merges a config object with any config options from the Frameworks API.
+ */
+export declare const getFrameworksAPIConfig: (config: NetlifyOptions["config"], frameworksAPIConfigPath: string) => Promise<import("./command-helpers.js").NormalizedCachedConfigConfig>;
+export {};
+//# sourceMappingURL=frameworks-api.d.ts.map

package/dist/utils/frameworks-api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks-api.d.ts","sourceRoot":"","sources":["../../src/utils/frameworks-api.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAE1D,UAAU,iBAAiB;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,YAAY,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;IACjC,MAAM,EAAE,MAAM,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,MAAM,kBAAkB,GAAG,UAAU,CAAC,OAAO,qBAAqB,CAAC,CAAA;AAEzE;;;;;GAKG;AACH,eAAO,MAAM,qBAAqB,GAAI,UAAU,MAAM,EAAE,cAAc,MAAM,sHAiC3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,GAAU,QAAQ,cAAc,CAAC,QAAQ,CAAC,EAAE,yBAAyB,MAAM,yEAY7G,CAAA"}

package/dist/utils/frameworks-api.js

@@ -0,0 +1,54 @@
+import { access, mkdir, readFile } from 'node:fs/promises';
+import { resolve } from 'node:path';
+import { mergeConfigs } from '@netlify/config';
+/**
+ * Returns an object containing the paths for all the operations of the
+ * Frameworks API. Each key maps to an object containing a `path` property with
+ * the path of the operation, an `exists` method that returns whether the path
+ * exists, and an `ensureExists` method that creates it in case it doesn't.
+ */
+export const getFrameworksAPIPaths = (basePath, packagePath) => {
+    const root = resolve(basePath, packagePath || '', '.netlify/v1');
+    const edgeFunctions = resolve(root, 'edge-functions');
+    const paths = {
+        root,
+        config: resolve(root, 'config.json'),
+        functions: resolve(root, 'functions'),
+        edgeFunctions,
+        edgeFunctionsImportMap: resolve(edgeFunctions, 'import_map.json'),
+        blobs: resolve(root, 'blobs'),
+    };
+    return Object.entries(paths).reduce((acc, [name, path]) => ({
+        ...acc,
+        [name]: {
+            path,
+            ensureExists: async () => {
+                await mkdir(path, { recursive: true });
+            },
+            exists: async () => {
+                try {
+                    await access(path);
+                    return true;
+                }
+                catch {
+                    return false;
+                }
+            },
+        },
+    }), {});
+};
+/**
+ * Merges a config object with any config options from the Frameworks API.
+ */
+export const getFrameworksAPIConfig = async (config, frameworksAPIConfigPath) => {
+    let frameworksAPIConfigFile;
+    try {
+        frameworksAPIConfigFile = await readFile(frameworksAPIConfigPath, 'utf8');
+    }
+    catch {
+        return config;
+    }
+    const frameworksAPIConfig = JSON.parse(frameworksAPIConfigFile);
+    return mergeConfigs([frameworksAPIConfig, config], { concatenateArrays: true });
+};
+//# sourceMappingURL=frameworks-api.js.map

package/dist/utils/frameworks-api.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frameworks-api.js","sourceRoot":"","sources":["../../src/utils/frameworks-api.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,kBAAkB,CAAA;AAC1D,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAY9C;;;;;GAKG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAgB,EAAE,WAAoB,EAAE,EAAE;IAC9E,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,EAAE,WAAW,IAAI,EAAE,EAAE,aAAa,CAAC,CAAA;IAChE,MAAM,aAAa,GAAG,OAAO,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAA;IACrD,MAAM,KAAK,GAAG;QACZ,IAAI;QACJ,MAAM,EAAE,OAAO,CAAC,IAAI,EAAE,aAAa,CAAC;QACpC,SAAS,EAAE,OAAO,CAAC,IAAI,EAAE,WAAW,CAAC;QACrC,aAAa;QACb,sBAAsB,EAAE,OAAO,CAAC,aAAa,EAAE,iBAAiB,CAAC;QACjE,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;KAC9B,CAAA;IAED,OAAO,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CACjC,CAAC,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACtB,GAAG,GAAG;QACN,CAAC,IAAI,CAAC,EAAE;YACN,IAAI;YACJ,YAAY,EAAE,KAAK,IAAI,EAAE;gBACvB,MAAM,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;YACxC,CAAC;YACD,MAAM,EAAE,KAAK,IAAI,EAAE;gBACjB,IAAI,CAAC;oBACH,MAAM,MAAM,CAAC,IAAI,CAAC,CAAA;oBAElB,OAAO,IAAI,CAAA;gBACb,CAAC;gBAAC,MAAM,CAAC;oBACP,OAAO,KAAK,CAAA;gBACd,CAAC;YACH,CAAC;SACF;KACF,CAAC,EACF,EAAmD,CACpD,CAAA;AACH,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,KAAK,EAAE,MAAgC,EAAE,uBAA+B,EAAE,EAAE;IAChH,IAAI,uBAA2C,CAAA;IAE/C,IAAI,CAAC;QACH,uBAAuB,GAAG,MAAM,QAAQ,CAAC,uBAAuB,EAAE,MAAM,CAAC,CAAA;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAA;IACf,CAAC;IAED,MAAM,mBAAmB,GAAG,IAAI,CAAC,KAAK,CAAC,uBAAuB,CAAC,CAAA;IAE/D,OAAO,YAAY,CAAC,CAAC,mBAAmB,EAAE,MAAM,CAAC,EAAE,EAAE,iBAAiB,EAAE,IAAI,EAAE,CAA6B,CAAA;AAC7G,CAAC,CAAA"}

package/dist/utils/functions/constants.d.ts

@@ -0,0 +1,2 @@
+export declare const CLOCKWORK_USERAGENT = "Netlify Clockwork";
+//# sourceMappingURL=constants.d.ts.map

package/dist/utils/functions/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/utils/functions/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,mBAAmB,sBAAsB,CAAA"}

package/dist/utils/functions/constants.js

@@ -0,0 +1,2 @@
+export const CLOCKWORK_USERAGENT = 'Netlify Clockwork';
+//# sourceMappingURL=constants.js.map

package/dist/utils/functions/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/utils/functions/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,mBAAmB,GAAG,mBAAmB,CAAA"}

package/dist/utils/functions/functions.d.ts

@@ -0,0 +1,32 @@
+import type { OptionValues } from 'commander';
+import type { NormalizedCachedConfigConfig } from '../command-helpers.js';
+export declare const INTERNAL_FUNCTIONS_FOLDER = "functions-internal";
+export declare const SERVE_FUNCTIONS_FOLDER = "functions-serve";
+/**
+ * retrieves the function directory out of the flags or config
+ */
+export declare const getFunctionsDir: ({ config, options, }: {
+    config: NormalizedCachedConfigConfig;
+    options: OptionValues;
+}, defaultValue?: string) => string | undefined;
+export declare const getFunctionsManifestPath: ({ base, packagePath }: {
+    base: string;
+    packagePath?: string;
+}) => Promise<string | null>;
+export declare const getFunctionsDistPath: ({ base, packagePath, }: {
+    base?: undefined | string;
+    packagePath?: string;
+}) => Promise<string | null>;
+export declare const getFunctionsServePath: ({ base, packagePath, }: {
+    base?: undefined | string;
+    packagePath?: string;
+}) => string;
+/**
+ * Retrieves the internal functions directory and creates it if ensureExists is provided
+ */
+export declare const getInternalFunctionsDir: ({ base, ensureExists, packagePath, }: {
+    base?: undefined | string;
+    ensureExists?: boolean;
+    packagePath?: string;
+}) => Promise<string>;
+//# sourceMappingURL=functions.d.ts.map

package/dist/utils/functions/functions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.d.ts","sourceRoot":"","sources":["../../../src/utils/functions/functions.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAI7C,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAA;AAEzE,eAAO,MAAM,yBAAyB,uBAAuB,CAAA;AAC7D,eAAO,MAAM,sBAAsB,oBAAoB,CAAA;AAIvD;;GAEG;AACH,eAAO,MAAM,eAAe,GAC1B,sBAGG;IACD,MAAM,EAAE,4BAA4B,CAAA;IACpC,OAAO,EAAE,YAAY,CAAA;CACtB,EACD,eAAe,MAAM,KACpB,MAAM,GAAG,SAIE,CAAA;AAEd,eAAO,MAAM,wBAAwB,GAAU,uBAA4B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,2BAKhH,CAAA;AAED,eAAO,MAAM,oBAAoB,GAAU,wBAGxC;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,2BAKA,CAAA;AAED,eAAO,MAAM,qBAAqB,GAAI,wBAGnC;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,WAIA,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,uBAAuB,GAAU,sCAI3C;IACD,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAA;IACzB,YAAY,CAAC,EAAE,OAAO,CAAA;IACtB,WAAW,CAAC,EAAE,MAAM,CAAA;CACrB,oBAQA,CAAA"}

package/dist/utils/functions/functions.js

@@ -0,0 +1,39 @@
+import { promises as fs } from 'fs';
+import { resolve } from 'path';
+import { isDirectoryAsync, isFileAsync } from '../../lib/fs.js';
+import { getPathInProject } from '../../lib/settings.js';
+export const INTERNAL_FUNCTIONS_FOLDER = 'functions-internal';
+export const SERVE_FUNCTIONS_FOLDER = 'functions-serve';
+const isNonEmptyString = (s) => typeof s === 'string' && s.length > 0;
+/**
+ * retrieves the function directory out of the flags or config
+ */
+export const getFunctionsDir = ({ config, options, }, defaultValue) => ('functions' in options && isNonEmptyString(options.functions) ? options.functions : null) ??
+    (isNonEmptyString(config.dev?.functions) ? config.dev.functions : null) ??
+    (isNonEmptyString(config.functionsDirectory) ? config.functionsDirectory : null) ??
+    defaultValue;
+export const getFunctionsManifestPath = async ({ base, packagePath = '' }) => {
+    const path = resolve(base, packagePath, getPathInProject(['functions', 'manifest.json']));
+    const isFile = await isFileAsync(path);
+    return isFile ? path : null;
+};
+export const getFunctionsDistPath = async ({ base, packagePath = '', }) => {
+    const path = resolve(base ?? '', packagePath, getPathInProject(['functions']));
+    const isDirectory = await isDirectoryAsync(path);
+    return isDirectory ? path : null;
+};
+export const getFunctionsServePath = ({ base, packagePath = '', }) => {
+    const path = resolve(base ?? '', packagePath, getPathInProject([SERVE_FUNCTIONS_FOLDER]));
+    return path;
+};
+/**
+ * Retrieves the internal functions directory and creates it if ensureExists is provided
+ */
+export const getInternalFunctionsDir = async ({ base, ensureExists, packagePath = '', }) => {
+    const path = resolve(base ?? '', packagePath, getPathInProject([INTERNAL_FUNCTIONS_FOLDER]));
+    if (ensureExists) {
+        await fs.mkdir(path, { recursive: true });
+    }
+    return path;
+};
+//# sourceMappingURL=functions.js.map

package/dist/utils/functions/functions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions.js","sourceRoot":"","sources":["../../../src/utils/functions/functions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,IAAI,EAAE,EAAE,MAAM,IAAI,CAAA;AACnC,OAAO,EAAE,OAAO,EAAE,MAAM,MAAM,CAAA;AAI9B,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAC/D,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAA;AAGxD,MAAM,CAAC,MAAM,yBAAyB,GAAG,oBAAoB,CAAA;AAC7D,MAAM,CAAC,MAAM,sBAAsB,GAAG,iBAAiB,CAAA;AAEvD,MAAM,gBAAgB,GAAG,CAAC,CAAU,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,GAAG,CAAC,CAAA;AAE3F;;GAEG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,EACE,MAAM,EACN,OAAO,GAIR,EACD,YAAqB,EACD,EAAE,CACtB,CAAC,WAAW,IAAI,OAAO,IAAI,gBAAgB,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IAC1F,CAAC,gBAAgB,CAAC,MAAM,CAAC,GAAG,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC;IACvE,CAAC,gBAAgB,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI,CAAC;IAChF,YAAY,CAAA;AAEd,MAAM,CAAC,MAAM,wBAAwB,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,WAAW,GAAG,EAAE,EAA0C,EAAE,EAAE;IACnH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,WAAW,EAAE,eAAe,CAAC,CAAC,CAAC,CAAA;IACzF,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,IAAI,CAAC,CAAA;IAEtC,OAAO,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAC7B,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,EACzC,IAAI,EACJ,WAAW,GAAG,EAAE,GAIjB,EAAE,EAAE;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,CAAA;IAC9E,MAAM,WAAW,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;IAEhD,OAAO,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAA;AAClC,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,EACpC,IAAI,EACJ,WAAW,GAAG,EAAE,GAIjB,EAAE,EAAE;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,sBAAsB,CAAC,CAAC,CAAC,CAAA;IAEzF,OAAO,IAAI,CAAA;AACb,CAAC,CAAA;AAED;;GAEG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,KAAK,EAAE,EAC5C,IAAI,EACJ,YAAY,EACZ,WAAW,GAAG,EAAE,GAKjB,EAAE,EAAE;IACH,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,EAAE,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,CAAA;IAE5F,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAC3C,CAAC;IAED,OAAO,IAAI,CAAA;AACb,CAAC,CAAA"}