netlify-cli 19.1.0 → 19.1.3

package/dist/utils/env/index.d.ts

@@ -0,0 +1,100 @@
+import { $TSFixMe } from '../../commands/types.js';
+export declare const AVAILABLE_CONTEXTS: string[];
+export declare const AVAILABLE_SCOPES: string[];
+/**
+ * @param {string|undefined} context - The deploy context or branch of the environment variable value
+ * @returns {Array<string|undefined>} The normalized context or branch name
+ */
+export declare const normalizeContext: (context: any) => any;
+/**
+ * Finds a matching environment variable value from a given context
+ * @param {Array<object>} values - An array of environment variable values from Envelope
+ * @param {string} context - The deploy context or branch of the environment variable value
+ * @returns {object<context: enum<dev,branch-deploy,deploy-preview,production,branch>, context_parameter: <string>, value: string>} The matching environment variable value object
+ */
+export declare const findValueInValues: (values: any, context: any) => any;
+/**
+ * Finds environment variables that match a given source
+ * @param {object} env - The dictionary of environment variables
+ * @param {enum<general,account,addons,ui,configFile>} source - The source of the environment variable
+ * @returns {object} The dictionary of env vars that match the given source
+ */
+export declare const filterEnvBySource: (env: any, source: any) => {
+    [k: string]: unknown;
+};
+/**
+ * Filters and sorts data from Envelope by a given context and/or scope
+ * @param {string} context - The deploy context or branch of the environment variable value
+ * @param {Array<object>} envelopeItems - An array of environment variables from the Envelope service
+ * @param {enum<any,builds,functions,runtime,post_processing>} scope - The scope of the environment variables
+ * @param {enum<general,account,addons,ui,configFile>} source - The source of the environment variable
+ * @returns {object} 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 declare const formatEnvelopeData: ({ context, envelopeItems, scope, source, }: {
+    context?: string;
+    envelopeItems: $TSFixMe[];
+    scope?: string;
+    source: string;
+}) => any;
+/**
+ * Collects env vars from multiple sources and arranges them in the correct order of precedence
+ * @param {object} api - The api singleton object
+ * @param {string} context - The deploy context or branch of the environment variable
+ * @param {object} env - The dictionary of environment variables
+ * @param {string} key - If present, fetch a single key (case-sensitive)
+ * @param {boolean} raw - Return a dictionary of raw key/value pairs for only the account and site sources
+ * @param {enum<any,builds,functions,runtime,post_processing>} scope - The scope of the environment variables
+ * @param {object} siteInfo - The site object
+ * @returns {object} An object of environment variables keys and their metadata
+ */
+export declare const getEnvelopeEnv: ({ api, context, env, key, raw, scope, siteInfo }: {
+    api: any;
+    context?: string | undefined;
+    env: any;
+    key?: string | undefined;
+    raw?: boolean | undefined;
+    scope?: string | undefined;
+    siteInfo: any;
+}) => Promise<any>;
+/**
+ * Returns a human-readable, comma-separated list of scopes
+ * @param {Array<enum<builds,functions,runtime,post_processing>>} scopes - An array of scopes
+ * @returns {string} A human-readable, comma-separated list of scopes
+ */
+export declare const getHumanReadableScopes: (scopes: any) => any;
+/**
+ * Translates a Mongo env into an Envelope env
+ * @param {object} env - The site's env as it exists in Mongo
+ * @returns {Array<object>} The array of Envelope env vars
+ */
+export declare const translateFromMongoToEnvelope: (env?: {}) => {
+    key: string;
+    scopes: string[];
+    values: {
+        context: string;
+        value: unknown;
+    }[];
+}[];
+/**
+ * Translates an Envelope env into a Mongo env
+ * @param {Array<object>} envVars - The array of Envelope env vars
+ * @param {string} context - The deploy context or branch of the environment variable
+ * @returns {object} The env object as compatible with Mongo
+ */
+export declare const translateFromEnvelopeToMongo: (envVars?: never[], context?: string) => {};
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/env/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAA;AAGlD,eAAO,MAAM,kBAAkB,UAAkE,CAAA;AACjG,eAAO,MAAM,gBAAgB,UAAwD,CAAA;AAErF;;;GAGG;AAEH,eAAO,MAAM,gBAAgB,uBAmB5B,CAAA;AAED;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB,oCAQ1B,CAAA;AAEJ;;;;;GAKG;AAEH,eAAO,MAAM,iBAAiB;;CAEoE,CAAA;AAiClG;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,kBAAkB,+CAK5B;IACD,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,aAAa,EAAE,QAAQ,EAAE,CAAA;IACzB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,MAAM,EAAE,MAAM,CAAA;CACf,QAqBS,CAAA;AAEV;;;;;;;;;;GAUG;AAEH,eAAO,MAAM,cAAc;;;;;;;;kBAyC1B,CAAA;AAED;;;;GAIG;AAEH,eAAO,MAAM,sBAAsB,sBAoBlC,CAAA;AAED;;;;GAIG;AACH,eAAO,MAAM,4BAA4B;;;;;;;GAaxC,CAAA;AAED;;;;;GAKG;AACH,eAAO,MAAM,4BAA4B,6CAe/B,CAAA"}

package/dist/utils/env/index.js

@@ -0,0 +1,231 @@
+import { error } from '../command-helpers.js';
+export const AVAILABLE_CONTEXTS = ['all', 'production', 'deploy-preview', 'branch-deploy', 'dev'];
+export const AVAILABLE_SCOPES = ['builds', 'functions', 'runtime', 'post_processing'];
+/**
+ * @param {string|undefined} context - The deploy context or branch of the environment variable value
+ * @returns {Array<string|undefined>} The normalized context or branch name
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'context' implicitly has an 'any' type.
+export const normalizeContext = (context) => {
+    if (!context) {
+        return context;
+    }
+    const CONTEXT_SYNONYMS = {
+        dp: 'deploy-preview',
+        prod: 'production',
+    };
+    context = context.toLowerCase();
+    if (context in CONTEXT_SYNONYMS) {
+        // @ts-expect-error TS(7053) FIXME: Element implicitly has an 'any' type because expre... Remove this comment to see the full error message
+        context = CONTEXT_SYNONYMS[context];
+    }
+    const forbiddenContexts = AVAILABLE_CONTEXTS.map((ctx) => `branch:${ctx}`);
+    if (forbiddenContexts.includes(context)) {
+        error(`The context ${context} includes a reserved keyword and is not allowed`);
+    }
+    context = context.replace(/^branch:/, '');
+    return context;
+};
+/**
+ * Finds a matching environment variable value from a given context
+ * @param {Array<object>} values - An array of environment variable values from Envelope
+ * @param {string} context - The deploy context or branch of the environment variable value
+ * @returns {object<context: enum<dev,branch-deploy,deploy-preview,production,branch>, context_parameter: <string>, value: string>} The matching environment variable value object
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'values' implicitly has an 'any' type.
+export const findValueInValues = (values, context) => 
+// @ts-expect-error TS(7006) FIXME: Parameter 'val' implicitly has an 'any' type.
+values.find((val) => {
+    if (!AVAILABLE_CONTEXTS.includes(context)) {
+        // the "context" option passed in is actually the name of a branch
+        return val.context === 'all' || val.context_parameter === context;
+    }
+    return [context, 'all'].includes(val.context);
+});
+/**
+ * Finds environment variables that match a given source
+ * @param {object} env - The dictionary of environment variables
+ * @param {enum<general,account,addons,ui,configFile>} source - The source of the environment variable
+ * @returns {object} The dictionary of env vars that match the given source
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'env' implicitly has an 'any' type.
+export const filterEnvBySource = (env, source) => 
+// @ts-expect-error TS(2571) FIXME: Object is of type 'unknown'.
+Object.fromEntries(Object.entries(env).filter(([, variable]) => variable.sources[0] === source));
+// Fetches data from Envelope
+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 });
+            return [envelopeItem];
+        }
+        // otherwise, fetch the entire list of env vars
+        const envelopeItems = await api.getEnvVars({ accountId, siteId });
+        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 {string} context - The deploy context or branch of the environment variable value
+ * @param {Array<object>} envelopeItems - An array of environment variables from the Envelope service
+ * @param {enum<any,builds,functions,runtime,post_processing>} scope - The scope of the environment variables
+ * @param {enum<general,account,addons,ui,configFile>} source - The source of the environment variable
+ * @returns {object} 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(findValueInValues(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 { context: ctx, context_parameter: branch, value } = findValueInValues(cur.values, context);
+    return {
+        ...acc,
+        [cur.key]: {
+            context: ctx,
+            branch,
+            scopes: cur.scopes,
+            sources: [source],
+            value,
+        },
+    };
+}, {});
+/**
+ * Collects env vars from multiple sources and arranges them in the correct order of precedence
+ * @param {object} api - The api singleton object
+ * @param {string} context - The deploy context or branch of the environment variable
+ * @param {object} env - The dictionary of environment variables
+ * @param {string} key - If present, fetch a single key (case-sensitive)
+ * @param {boolean} raw - Return a dictionary of raw key/value pairs for only the account and site sources
+ * @param {enum<any,builds,functions,runtime,post_processing>} scope - The scope of the environment variables
+ * @param {object} siteInfo - The site object
+ * @returns {object} An object of environment variables keys and their metadata
+ */
+// @ts-expect-error TS(7031) FIXME: Binding element 'api' implicitly has an 'any' type... Remove this comment to see the full error message
+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([
+        // @ts-expect-error TS(2345) FIXME: Argument of type '{ api: any; accountId: any; key:... Remove this comment to see the full error message
+        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,
+            // @ts-expect-error TS(2571) FIXME: Object is of type 'unknown'.
+            [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 {Array<enum<builds,functions,runtime,post_processing>>} scopes - An array of scopes
+ * @returns {string} A human-readable, comma-separated list of scopes
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'scopes' implicitly has an 'any' type.
+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],
+        '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';
+    }
+    // @ts-expect-error TS(7006) FIXME: Parameter 'scope' implicitly has an 'any' type.
+    return scopes.map((scope) => SCOPES_MAP[scope]).join(', ');
+};
+/**
+ * Translates a Mongo env into an Envelope env
+ * @param {object} env - The site's env as it exists in Mongo
+ * @returns {Array<object>} The array of Envelope env vars
+ */
+export const translateFromMongoToEnvelope = (env = {}) => {
+    const envVars = Object.entries(env).map(([key, value]) => ({
+        key,
+        scopes: AVAILABLE_SCOPES,
+        values: [
+            {
+                context: 'all',
+                value,
+            },
+        ],
+    }));
+    return envVars;
+};
+/**
+ * Translates an Envelope env into a Mongo env
+ * @param {Array<object>} envVars - The array of Envelope env vars
+ * @param {string} context - The deploy context or branch of the environment variable
+ * @returns {object} The env object as compatible with Mongo
+ */
+export const translateFromEnvelopeToMongo = (envVars = [], context = 'dev') => envVars
+    // @ts-expect-error TS(2339) FIXME: Property 'key' does not exist on type 'never'.
+    .sort((left, right) => (left.key.toLowerCase() < right.key.toLowerCase() ? -1 : 1))
+    .reduce((acc, cur) => {
+    // @ts-expect-error TS(2339) FIXME: Property 'values' does not exist on type 'never'.
+    const envVar = cur.values.find((val) => [context, 'all'].includes(val.context_parameter || val.context));
+    if (envVar && envVar.value) {
+        return {
+            ...acc,
+            // @ts-expect-error TS(2339) FIXME: Property 'key' does not exist on type 'never'.
+            [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;AAO5B,QAAA,IAAI,KAAK,EAAE,OAAO,QAAQ,CAAA;AAS1B,eAAe,KAAK,CAAA"}

package/dist/utils/execa.js

@@ -0,0 +1,16 @@
+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/utils/moc
+// eslint-disable-next-line import/no-mutable-exports
+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,iCAAiC;AAEjC,qDAAqD;AACrD,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,21 @@
+/**
+ * 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
+ * @param {*} siteInfo
+ *
+ * @returns {boolean}
+ */
+export declare const isFeatureFlagEnabled: (flagName: string, siteInfo: any) => boolean;
+/**
+ * Retrieves all Feature flags from the siteInfo
+ */
+export declare const getFeatureFlagsFromSiteInfo: (siteInfo: {
+    feature_flags?: Record<string, boolean | string | number>;
+}) => 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;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,oBAAoB,aAAc,MAAM,oBAAa,OACa,CAAA;AAE/E;;GAEG;AACH,eAAO,MAAM,2BAA2B,aAAc;IACpD,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,GAAG,MAAM,CAAC,CAAA;CAC1D,KAAG,YAMF,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,25 @@
+/**
+ * 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
+ * @param {*} siteInfo
+ *
+ * @returns {boolean}
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'flagName' implicitly has an 'any' type.
+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,
+    project_ceruledge_ui: 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;;;;;;;;;;;GAWG;AACH,sFAAsF;AACtF,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAgB,EAAE,QAAQ,EAAW,EAAE,CAC1E,OAAO,CAAC,QAAQ,CAAC,aAAa,IAAI,QAAQ,CAAC,aAAa,CAAC,QAAQ,CAAC,KAAK,KAAK,CAAC,CAAA;AAE/E;;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;IAClC,oBAAoB,EAAE,IAAI;CAC3B,CAAC,CAAA"}

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

@@ -0,0 +1,13 @@
+import { 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":"AASA,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAK3C,UAAU,iBAAiB;IACzB,SAAS,CAAC,EAAE,CAAC,GAAG,CAAC,CAAA;CAClB;AAED;;GAEG;AACH,eAAO,MAAM,oBAAoB,uBAG9B;IACD,GAAG,EAAE,MAAM,CAAA;IACX,QAAQ,EAAE,cAAc,CAAA;CACzB,KAAG,OAAO,CAAC,iBAAiB,CAqD5B,CAAA"}

package/dist/utils/framework-server.js

@@ -0,0 +1,61 @@
+import { rm } from 'node:fs/promises';
+import waitPort from 'wait-port';
+import { startSpinner, stopSpinner } from '../lib/spinner.js';
+import { error, exit, log, NETLIFYDEVERR, NETLIFYDEVLOG } from './command-helpers.js';
+import { runCommand } from './shell.js';
+import { startStaticServer } from './static-server.js';
+// 10 minutes
+const FRAMEWORK_PORT_TIMEOUT = 6e5;
+/**
+ * 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(`${NETLIFYDEVLOG} Starting Netlify Dev with ${settings.framework || 'custom config'}`);
+    const spinner = startSpinner({
+        text: `Waiting for framework port ${settings.frameworkPort}. This can be configured using the 'targetPort' property in the netlify.toml`,
+    });
+    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 {
+            port = await waitPort({
+                // eslint-disable-next-line @typescript-eslint/no-non-null-assertion
+                port: settings.frameworkPort,
+                host: 'localhost',
+                output: 'silent',
+                timeout: FRAMEWORK_PORT_TIMEOUT,
+                ...(settings.pollingStrategies?.includes('HTTP') && { protocol: 'http' }),
+            });
+            if (!port.open) {
+                throw new Error(`Timed out waiting for port '${settings.frameworkPort}' to be open`);
+            }
+        }
+        stopSpinner({ error: false, spinner });
+    }
+    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}`);
+        error(error_);
+        exit(1);
+    }
+    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("../commands/types.js").PatchedConfig>;
+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,aAAc,MAAM,gBAAgB,MAAM,sHAiC3E,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,sBAAsB,WAAkB,cAAc,CAAC,QAAQ,CAAC,2BAA2B,MAAM,0DAY7G,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"}