netlify 13.3.5 → 21.5.1

package/dist/commands/env/env.js

@@ -0,0 +1,139 @@
+import { Option } from 'commander';
+import terminalLink from 'terminal-link';
+import { normalizeContext } from '../../utils/env/index.js';
+const env = (_options, command) => {
+    command.help();
+};
+export const createEnvCommand = (program) => {
+    program
+        .command('env:get')
+        .argument('<name>', 'Environment variable name')
+        .option('-c, --context <context>', 'Specify a deploy context for environment variables (”production”, ”deploy-preview”, ”branch-deploy”, ”dev”) or `branch:your-branch` where `your-branch` is the name of a branch', normalizeContext, 'dev')
+        .option('--json', 'Output environment variables as JSON')
+        .addOption(new Option('-s, --scope <scope>', 'Specify a scope')
+        .choices(['builds', 'functions', 'post-processing', 'runtime', 'any'])
+        .default('any'))
+        .addExamples([
+        'netlify env:get MY_VAR # get value for MY_VAR in dev context',
+        'netlify env:get MY_VAR --context production',
+        'netlify env:get MY_VAR --context branch:feat/make-it-pop # get value in the feat/make-it-pop branch context or branch-deploy context',
+        'netlify env:get MY_VAR --scope functions',
+    ])
+        .description('Get resolved value of specified environment variable (includes netlify.toml)')
+        .action(async (name, options, command) => {
+        const { envGet } = await import('./env-get.js');
+        await envGet(name, options, command);
+    });
+    program
+        .command('env:import')
+        .argument('<fileName>', '.env file to import')
+        .option('-r, --replace-existing', 'Replace all existing variables instead of merging them with the current ones', false)
+        .option('--json', 'Output environment variables as JSON')
+        .description('Import and set environment variables from .env file')
+        .action(async (fileName, options, command) => {
+        const { envImport } = await import('./env-import.js');
+        await envImport(fileName, options, command);
+    });
+    program
+        .command('env:list')
+        .option('-c, --context <context>', 'Specify a deploy context for environment variables (”production”, ”deploy-preview”, ”branch-deploy”, ”dev”) or `branch:your-branch` where `your-branch` is the name of a branch (default: all contexts)', normalizeContext, 'dev')
+        .option('--json', 'Output environment variables as JSON')
+        .addOption(new Option('--plain', 'Output environment variables as plaintext').conflicts('json'))
+        .addOption(new Option('-s, --scope <scope>', 'Specify a scope')
+        .choices(['builds', 'functions', 'post-processing', 'runtime', 'any'])
+        .default('any'))
+        .addExamples([
+        'netlify env:list # list variables with values in the dev context and with any scope',
+        'netlify env:list --context production',
+        'netlify env:list --context branch:feat/make-it-pop # list variables with values in the feat/make-it-pop branch context or branch-deploy context',
+        'netlify env:list --scope functions',
+        'netlify env:list --plain',
+    ])
+        .description('Lists resolved environment variables for project (includes netlify.toml)')
+        .action(async (options, command) => {
+        const { envList } = await import('./env-list.js');
+        await envList(options, command);
+    });
+    program
+        .command('env:set')
+        .argument('<key>', 'Environment variable key')
+        .argument('[value]', 'Value to set to', '')
+        .option('-c, --context <context...>', 'Specify a deploy context for environment variables (”production”, ”deploy-preview”, ”branch-deploy”, ”dev”) or `branch:your-branch` where `your-branch` is the name of a branch (default: all contexts)', 
+    // spread over an array for variadic options
+    (context, previous = []) => [...previous, normalizeContext(context)])
+        .option('--json', 'Output environment variables as JSON')
+        .addOption(new Option('-s, --scope <scope...>', 'Specify a scope (default: all scopes)').choices([
+        'builds',
+        'functions',
+        'post-processing',
+        'runtime',
+    ]))
+        .option('--secret', 'Indicate whether the environment variable value can be read again.')
+        .description('Set value of environment variable')
+        .addExamples([
+        'netlify env:set VAR_NAME value # set in all contexts and scopes',
+        'netlify env:set VAR_NAME value --context production',
+        'netlify env:set VAR_NAME value --context production deploy-preview # set in the production and deploy-preview contexts',
+        'netlify env:set VAR_NAME value --context branch:feat/make-it-pop # set in the feat/make-it-pop branch context',
+        'netlify env:set VAR_NAME value --context production --secret',
+        'netlify env:set VAR_NAME value --scope builds',
+        'netlify env:set VAR_NAME value --scope builds functions',
+        'netlify env:set VAR_NAME --secret # convert existing variable to secret',
+    ])
+        .action(async (key, value, options, command) => {
+        const { envSet } = await import('./env-set.js');
+        await envSet(key, value, options, command);
+    });
+    program
+        .command('env:unset')
+        .aliases(['env:delete', 'env:remove'])
+        .argument('<key>', 'Environment variable key')
+        .option('-c, --context <context...>', 'Specify a deploy context for environment variables (”production”, ”deploy-preview”, ”branch-deploy”, ”dev”) or `branch:your-branch` where `your-branch` is the name of a branch (default: all contexts)', 
+    // spread over an array for variadic options
+    (context, previous = []) => [...previous, normalizeContext(context)])
+        .option('--json', 'Output environment variables as JSON')
+        .addExamples([
+        'netlify env:unset VAR_NAME # unset in all contexts',
+        'netlify env:unset VAR_NAME --context production',
+        'netlify env:unset VAR_NAME --context production deploy-preview',
+        'netlify env:unset VAR_NAME --context branch:feat/make-it-pop # unset in the feat/make-it-pop branch context',
+    ])
+        .description('Unset an environment variable which removes it from the UI')
+        .action(async (key, options, command) => {
+        const { envUnset } = await import('./env-unset.js');
+        await envUnset(key, options, command);
+    });
+    program
+        .command('env:clone')
+        .alias('env:migrate')
+        .option('-f, --from <from>', 'Project ID (From)')
+        .requiredOption('-t, --to <to>', 'Project ID (To)')
+        .description(`Clone environment variables from one project to another`)
+        .addExamples([
+        'netlify env:clone --to <to-project-id>',
+        'netlify env:clone --to <to-project-id> --from <from-project-id>',
+    ])
+        .action(async (options, command) => {
+        const { envClone } = await import('./env-clone.js');
+        await envClone(options, command);
+    });
+    return program
+        .command('env')
+        .description('Control environment variables for the current project')
+        .addExamples([
+        'netlify env:list',
+        'netlify env:get VAR_NAME',
+        'netlify env:set VAR_NAME value',
+        'netlify env:unset VAR_NAME',
+        'netlify env:import fileName',
+        'netlify env:clone --to <to-project-id>',
+    ])
+        .addHelpText('afterAll', () => {
+        const docsUrl = 'https://docs.netlify.com/configure-builds/environment-variables/';
+        return `
+For more information about environment variables on Netlify, see ${terminalLink(docsUrl, docsUrl, { fallback: false })}
+`;
+    })
+        .action(env);
+};
+//# sourceMappingURL=env.js.map

package/dist/commands/env/env.js.map

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

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

@@ -0,0 +1,2 @@
+export { createEnvCommand } from './env.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/commands/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA"}

package/dist/commands/env/index.js

@@ -0,0 +1,2 @@
+export { createEnvCommand } from './env.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/commands/env/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAA"}

package/dist/commands/functions/functions-build.d.ts

@@ -0,0 +1,4 @@
+import type { OptionValues } from 'commander';
+import type BaseCommand from '../base-command.js';
+export declare const functionsBuild: (options: OptionValues, command: BaseCommand) => Promise<undefined>;
+//# sourceMappingURL=functions-build.d.ts.map

package/dist/commands/functions/functions-build.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-build.d.ts","sourceRoot":"","sources":["../../../src/commands/functions/functions-build.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAI7C,OAAO,KAAK,WAAW,MAAM,oBAAoB,CAAA;AAEjD,eAAO,MAAM,cAAc,GAAU,SAAS,YAAY,EAAE,SAAS,WAAW,uBA+B/E,CAAA"}

package/dist/commands/functions/functions-build.js

@@ -0,0 +1,26 @@
+import { mkdir } from 'fs/promises';
+import { zipFunctions } from '@netlify/zip-it-and-ship-it';
+import { NETLIFYDEVERR, NETLIFYDEVLOG, exit, log } from '../../utils/command-helpers.js';
+import { getFunctionsDir } from '../../utils/functions/index.js';
+export const functionsBuild = async (options, command) => {
+    const { config } = command.netlify;
+    const src = ('src' in options && typeof options.src === 'string' && options.src.trim().length > 0 ? options.src : null) ??
+        config.build.functionsSource;
+    const dst = getFunctionsDir({ options, config });
+    if (src === dst) {
+        log(`${NETLIFYDEVERR} Source and destination for function build can't be the same`);
+        exit(1);
+    }
+    if (!src || !dst) {
+        if (!src)
+            log(`${NETLIFYDEVERR} Error: You must specify a source folder with a --src flag or a functionsSource field in your config`);
+        if (!dst)
+            log(`${NETLIFYDEVERR} Error: You must specify a destination functions folder with a --functions flag or a functions field in your config`);
+        return exit(1);
+    }
+    await mkdir(dst, { recursive: true });
+    log(`${NETLIFYDEVLOG} Building functions`);
+    await zipFunctions(src, dst);
+    log(`${NETLIFYDEVLOG} Functions built to `, dst);
+};
+//# sourceMappingURL=functions-build.js.map

package/dist/commands/functions/functions-build.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-build.js","sourceRoot":"","sources":["../../../src/commands/functions/functions-build.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAA;AAEnC,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAA;AAG1D,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAA;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAGhE,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,OAAqB,EAAE,OAAoB,EAAE,EAAE;IAClF,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,OAAO,CAAA;IAElC,MAAM,GAAG,GACP,CAAC,KAAK,IAAI,OAAO,IAAI,OAAO,OAAO,CAAC,GAAG,KAAK,QAAQ,IAAI,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;QAC3G,MAAM,CAAC,KAAK,CAAC,eAAe,CAAA;IAC9B,MAAM,GAAG,GAAG,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,EAAE,CAAC,CAAA;IAEhD,IAAI,GAAG,KAAK,GAAG,EAAE,CAAC;QAChB,GAAG,CAAC,GAAG,aAAa,8DAA8D,CAAC,CAAA;QACnF,IAAI,CAAC,CAAC,CAAC,CAAA;IACT,CAAC;IAED,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACjB,IAAI,CAAC,GAAG;YACN,GAAG,CACD,GAAG,aAAa,sGAAsG,CACvH,CAAA;QACH,IAAI,CAAC,GAAG;YACN,GAAG,CACD,GAAG,aAAa,qHAAqH,CACtI,CAAA;QACH,OAAO,IAAI,CAAC,CAAC,CAAC,CAAA;IAChB,CAAC;IAED,MAAM,KAAK,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAA;IAErC,GAAG,CAAC,GAAG,aAAa,qBAAqB,CAAC,CAAA;IAE1C,MAAM,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAC5B,GAAG,CAAC,GAAG,aAAa,sBAAsB,EAAE,GAAG,CAAC,CAAA;AAClD,CAAC,CAAA"}

package/dist/commands/functions/functions-create.d.ts

@@ -0,0 +1,4 @@
+import { OptionValues } from 'commander';
+import BaseCommand from '../base-command.js';
+export declare const functionsCreate: (name: string, options: OptionValues, command: BaseCommand) => Promise<void>;
+//# sourceMappingURL=functions-create.d.ts.map

package/dist/commands/functions/functions-create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"functions-create.d.ts","sourceRoot":"","sources":["../../../src/commands/functions/functions-create.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAsBxC,OAAO,WAAW,MAAM,oBAAoB,CAAA;AAmtB5C,eAAO,MAAM,eAAe,GAAU,MAAM,MAAM,EAAE,SAAS,YAAY,EAAE,SAAS,WAAW,kBAQ9F,CAAA"}