netlify 13.3.5 → 21.5.0

package/dist/recipes/ai-context/context.d.ts

@@ -0,0 +1,59 @@
+import type { RunRecipeOptions } from '../../commands/recipes/recipes.js';
+export declare const NTL_DEV_MCP_FILE_NAME = "netlify-development.mdc";
+export declare const NETLIFY_PROVIDER = "netlify";
+export interface ContextConfig {
+    scope: string;
+    glob?: string;
+    shared?: string[];
+    endpoint?: string;
+}
+export interface ContextFile {
+    key: string;
+    config: ContextConfig;
+    content: string;
+}
+export interface ConsumerConfig {
+    key: string;
+    presentedName: string;
+    consumerProcessCmd?: string;
+    path: string;
+    ext: string;
+    truncationLimit?: number;
+    contextScopes: Record<string, ContextConfig>;
+    hideFromCLI?: boolean;
+    consumerTrigger?: string;
+}
+export declare const getContextConsumers: (cliVersion: string) => Promise<ConsumerConfig[]>;
+export declare const downloadFile: (cliVersion: string, contextConfig: ContextConfig, consumer: ConsumerConfig) => Promise<{
+    contents: string;
+    minimumCLIVersion: string | undefined;
+} | null>;
+interface ParsedContextFile {
+    contents: string;
+    innerContents?: string;
+    overrides?: {
+        contents?: string;
+        innerContents?: string;
+    };
+    provider?: string;
+    version?: string;
+}
+/**
+ * Parses the `<ProviderContext>` and `<ProviderContextOverrides>` blocks in
+ * a context file.
+ */
+export declare const parseContextFile: (contents: string) => ParsedContextFile;
+/**
+ * Takes a context file (a template) and injects a string in an overrides block
+ * if one is found. Returns the resulting context file.
+ */
+export declare const applyOverrides: (template: string, overrides?: string) => string;
+/**
+ * Reads a file on disk and tries to parse it as a context file.
+ */
+export declare const getExistingContext: (path: string) => Promise<ParsedContextFile | null>;
+export declare const writeFile: (path: string, contents: string) => Promise<void>;
+export declare const deleteFile: (path: string) => Promise<void>;
+export declare const downloadAndWriteContextFiles: (consumer: ConsumerConfig, { command }: RunRecipeOptions) => Promise<void>;
+export {};
+//# sourceMappingURL=context.d.ts.map

package/dist/recipes/ai-context/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../src/recipes/ai-context/context.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAMzE,eAAO,MAAM,qBAAqB,4BAA4B,CAAA;AAE9D,eAAO,MAAM,gBAAgB,YAAY,CAAA;AAKzC,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,aAAa,CAAA;IACrB,OAAO,EAAE,MAAM,CAAA;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,GAAG,EAAE,MAAM,CAAA;IACX,aAAa,EAAE,MAAM,CAAA;IACrB,kBAAkB,CAAC,EAAE,MAAM,CAAA;IAC3B,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,eAAe,CAAC,EAAE,MAAM,CAAA;IACxB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAA;IAC5C,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,eAAe,CAAC,EAAE,MAAM,CAAA;CACzB;AAGD,eAAO,MAAM,mBAAmB,GAAU,YAAY,MAAM,8BAoB3D,CAAA;AAED,eAAO,MAAM,YAAY,GAAU,YAAY,MAAM,EAAE,eAAe,aAAa,EAAE,UAAU,cAAc;;;SAsC5G,CAAA;AAED,UAAU,iBAAiB;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,SAAS,CAAC,EAAE;QACV,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,aAAa,CAAC,EAAE,MAAM,CAAA;KACvB,CAAA;IACD,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB,GAAI,UAAU,MAAM,sBA0ChD,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,EAAE,YAAY,MAAM,WAWlE,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,kBAAkB,GAAU,MAAM,MAAM,sCAqBpD,CAAA;AAED,eAAO,MAAM,SAAS,GAAU,MAAM,MAAM,EAAE,UAAU,MAAM,kBAK7D,CAAA;AAED,eAAO,MAAM,UAAU,GAAU,MAAM,MAAM,kBAO5C,CAAA;AAED,eAAO,MAAM,4BAA4B,GAAU,UAAU,cAAc,EAAE,aAAa,gBAAgB,kBAsEzG,CAAA"}

package/dist/recipes/ai-context/context.js

@@ -0,0 +1,195 @@
+import { promises as fs } from 'node:fs';
+import { dirname, resolve } from 'node:path';
+import semver from 'semver';
+import { chalk, logAndThrowError, log, version } from '../../utils/command-helpers.js';
+const ATTRIBUTES_REGEX = /(\S*)="([^\s"]*)"/gim;
+// AI_CONTEXT_BASE_URL is used to help with local testing at non-production
+// versions of the context apis.
+const BASE_URL = new URL(process.env.AI_CONTEXT_BASE_URL ?? 'https://docs.netlify.com/ai-context').toString();
+export const NTL_DEV_MCP_FILE_NAME = 'netlify-development.mdc';
+const MINIMUM_CLI_VERSION_HEADER = 'x-cli-min-ver';
+export const NETLIFY_PROVIDER = 'netlify';
+const PROVIDER_CONTEXT_REGEX = /<providercontext ([^>]*)>(.*)<\/providercontext>/ims;
+const PROVIDER_CONTEXT_OVERRIDES_REGEX = /<providercontextoverrides([^>]*)>(.*)<\/providercontextoverrides>/ims;
+const PROVIDER_CONTEXT_OVERRIDES_TAG = 'ProviderContextOverrides';
+let contextConsumers = [];
+export const getContextConsumers = async (cliVersion) => {
+    if (contextConsumers.length > 0) {
+        return contextConsumers;
+    }
+    try {
+        const res = await fetch(`${BASE_URL}/context-consumers`, {
+            headers: {
+                'user-agent': `NetlifyCLI ${cliVersion}`,
+            },
+        });
+        if (!res.ok) {
+            return [];
+        }
+        const data = (await res.json());
+        contextConsumers = data?.consumers ?? [];
+    }
+    catch { }
+    return contextConsumers;
+};
+export const downloadFile = async (cliVersion, contextConfig, consumer) => {
+    try {
+        if (!contextConfig.endpoint) {
+            return null;
+        }
+        const url = new URL(contextConfig.endpoint, BASE_URL);
+        url.searchParams.set('consumer', consumer.key);
+        if (process.env.AI_CONTEXT_BASE_URL) {
+            const overridingUrl = new URL(process.env.AI_CONTEXT_BASE_URL);
+            url.host = overridingUrl.host;
+            url.port = overridingUrl.port;
+            url.protocol = overridingUrl.protocol;
+        }
+        const res = await fetch(url, {
+            headers: {
+                'user-agent': `NetlifyCLI ${cliVersion}`,
+            },
+        });
+        if (!res.ok) {
+            return null;
+        }
+        const contents = await res.text();
+        const minimumCLIVersion = res.headers.get(MINIMUM_CLI_VERSION_HEADER) ?? undefined;
+        return {
+            contents,
+            minimumCLIVersion,
+        };
+    }
+    catch {
+        // no-op
+    }
+    return null;
+};
+/**
+ * Parses the `<ProviderContext>` and `<ProviderContextOverrides>` blocks in
+ * a context file.
+ */
+export const parseContextFile = (contents) => {
+    const result = {
+        contents,
+    };
+    const providerContext = contents.match(PROVIDER_CONTEXT_REGEX);
+    if (providerContext) {
+        const [, attributes, innerContents] = providerContext;
+        result.innerContents = innerContents;
+        for (const [, name, value] of attributes.matchAll(ATTRIBUTES_REGEX)) {
+            switch (name.toLowerCase()) {
+                case 'provider':
+                    result.provider = value;
+                    break;
+                case 'version':
+                    result.version = value;
+                    break;
+                default:
+                    continue;
+            }
+        }
+    }
+    const contextOverrides = contents.match(PROVIDER_CONTEXT_OVERRIDES_REGEX);
+    if (contextOverrides) {
+        const [overrideContents, , innerContents] = contextOverrides;
+        result.overrides = {
+            contents: overrideContents,
+            innerContents,
+        };
+    }
+    return result;
+};
+/**
+ * Takes a context file (a template) and injects a string in an overrides block
+ * if one is found. Returns the resulting context file.
+ */
+export const applyOverrides = (template, overrides) => {
+    if (!overrides) {
+        return template;
+    }
+    return template
+        .replace(PROVIDER_CONTEXT_OVERRIDES_REGEX, `<${PROVIDER_CONTEXT_OVERRIDES_TAG}>${overrides}</${PROVIDER_CONTEXT_OVERRIDES_TAG}>`)
+        .trim();
+};
+/**
+ * Reads a file on disk and tries to parse it as a context file.
+ */
+export const getExistingContext = async (path) => {
+    try {
+        const stats = await fs.stat(path);
+        if (!stats.isFile()) {
+            throw new Error(`${path} already exists but is not a file. Please remove it or rename it and try again.`);
+        }
+        const file = await fs.readFile(path, 'utf8');
+        const parsedFile = parseContextFile(file);
+        return parsedFile;
+    }
+    catch (error) {
+        const exception = error;
+        if (exception.code !== 'ENOENT') {
+            throw new Error(`Could not open context file at ${path}: ${exception.message}`);
+        }
+        return null;
+    }
+};
+export const writeFile = async (path, contents) => {
+    const directory = dirname(path);
+    await fs.mkdir(directory, { recursive: true });
+    await fs.writeFile(path, contents);
+};
+export const deleteFile = async (path) => {
+    try {
+        // delete file from file system - not just unlinking it
+        await fs.rm(path);
+    }
+    catch {
+        // ignore
+    }
+};
+export const downloadAndWriteContextFiles = async (consumer, { command }) => {
+    await Promise.allSettled(Object.keys(consumer.contextScopes).map(async (contextKey) => {
+        const contextConfig = consumer.contextScopes[contextKey];
+        const { contents: downloadedFile, minimumCLIVersion } = (await downloadFile(version, contextConfig, consumer).catch(() => null)) ?? {};
+        if (!downloadedFile) {
+            return logAndThrowError(`An error occurred when pulling the latest context file for scope ${contextConfig.scope}. Please try again.`);
+        }
+        if (minimumCLIVersion && semver.lt(version, minimumCLIVersion)) {
+            return logAndThrowError(`This command requires version ${minimumCLIVersion} or above of the Netlify CLI. Refer to ${chalk.underline('https://ntl.fyi/update-cli')} for information on how to update.`);
+        }
+        const absoluteFilePath = resolve(command?.workingDir ?? '', consumer.path, `netlify-${contextKey}.${consumer.ext || 'mdc'}`);
+        const existing = await getExistingContext(absoluteFilePath);
+        const remote = parseContextFile(downloadedFile);
+        let { contents } = remote;
+        // Does a file already exist at this path?
+        if (existing) {
+            // If it's a file we've created, let's check the version and bail if we're
+            // already on the latest, otherwise rewrite it with the latest version.
+            if (existing.provider?.toLowerCase() === NETLIFY_PROVIDER) {
+                if (remote.version === existing.version) {
+                    log(`You're all up to date! ${chalk.underline(absoluteFilePath)} contains the latest version of the context files.`);
+                    return;
+                }
+                // We must preserve any overrides found in the existing file.
+                contents = applyOverrides(remote.contents, existing.overrides?.innerContents);
+            }
+            else {
+                // Whatever exists in the file goes in the overrides block.
+                contents = applyOverrides(remote.contents, existing.contents);
+            }
+        }
+        // we don't want to cut off content, but if we _have_ to
+        // then we need to do so before writing or the user's
+        // context gets in a bad state. Note, this can result in
+        // a file that's not parsable next time. This will be
+        // fine because the file will simply be replaced. Not ideal
+        // but solves the issue of a truncated file in a bad state
+        // being updated.
+        if (consumer.truncationLimit && contents.length > consumer.truncationLimit) {
+            contents = contents.slice(0, consumer.truncationLimit);
+        }
+        await writeFile(absoluteFilePath, contents);
+        log(`${existing ? 'Updated' : 'Created'} context files at ${chalk.underline(absoluteFilePath)}`);
+    }));
+};
+//# sourceMappingURL=context.js.map

package/dist/recipes/ai-context/context.js.map

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

package/dist/recipes/ai-context/index.d.ts

@@ -0,0 +1,4 @@
+import type { RunRecipeOptions } from '../../commands/recipes/recipes.js';
+export declare const description = "Manage context files for AI tools";
+export declare const run: (runOptions: RunRecipeOptions) => Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/recipes/ai-context/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recipes/ai-context/index.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAA;AAYzE,eAAO,MAAM,WAAW,sCAAsC,CAAA;AAqH9D,eAAO,MAAM,GAAG,GAAU,YAAY,gBAAgB,kBAuCrD,CAAA"}

package/dist/recipes/ai-context/index.js

@@ -0,0 +1,132 @@
+import { resolve } from 'node:path';
+import inquirer from 'inquirer';
+import execa from 'execa';
+import { logAndThrowError, log, version } from '../../utils/command-helpers.js';
+import { getExistingContext, NTL_DEV_MCP_FILE_NAME, getContextConsumers, deleteFile, downloadAndWriteContextFiles, } from './context.js';
+export const description = 'Manage context files for AI tools';
+// context consumers endpoints returns all supported IDE and other consumers
+// that can be used to pull context files. It also includes a catchall consumer
+// for outlining all context that an unspecified consumer would handle.
+const allContextConsumers = (await getContextConsumers(version)).filter((consumer) => !consumer.hideFromCLI);
+const cliContextConsumers = allContextConsumers.filter((consumer) => !consumer.hideFromCLI);
+const rulesForDefaultConsumer = allContextConsumers.find((consumer) => consumer.key === 'catchall-consumer') ?? {
+    key: 'catchall-consumer',
+    path: './ai-context',
+    presentedName: '',
+    ext: 'mdc',
+    contextScopes: {},
+    hideFromCLI: true,
+};
+const presets = cliContextConsumers.map((consumer) => ({
+    name: consumer.presentedName,
+    value: consumer.key,
+}));
+// always add the custom location option (not preset from API)
+presets.push({ name: 'Custom location', value: rulesForDefaultConsumer.key });
+const promptForContextConsumerSelection = async () => {
+    const { consumerKey } = await inquirer.prompt([
+        {
+            name: 'consumerKey',
+            message: 'Where should we put the context files?',
+            type: 'list',
+            choices: presets,
+        },
+    ]);
+    const contextConsumer = consumerKey ? cliContextConsumers.find((consumer) => consumer.key === consumerKey) : null;
+    if (contextConsumer) {
+        return contextConsumer;
+    }
+    const { customPath } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'customPath',
+            message: 'Enter the path, relative to the project root, where the context files should be placed',
+            default: './ai-context',
+        },
+    ]);
+    if (customPath) {
+        return { ...rulesForDefaultConsumer, path: customPath || rulesForDefaultConsumer.path };
+    }
+    log('You must select a path.');
+    return promptForContextConsumerSelection();
+};
+/**
+ * Checks if a command belongs to a known IDEs by checking if it includes a specific string.
+ * For example, the command that starts windsurf looks something like "/applications/windsurf.app/contents/...".
+ */
+const getConsumerKeyFromCommand = (command) => {
+    // The actual command is something like "/applications/windsurf.app/contents/...", but we are only looking for windsurf
+    const match = cliContextConsumers.find((consumer) => consumer.consumerProcessCmd && command.includes(consumer.consumerProcessCmd));
+    return match ? match.key : null;
+};
+/**
+ * Receives a process ID (pid) and returns both the command that the process was run with and its parent process ID. If the process is a known IDE, also returns information about that IDE.
+ */
+const getCommandAndParentPID = async (pid) => {
+    const { stdout } = await execa('ps', ['-p', String(pid), '-o', 'ppid=,comm=']);
+    const output = stdout.trim();
+    const spaceIndex = output.indexOf(' ');
+    const parentPID = output.substring(0, spaceIndex);
+    const command = output.substring(spaceIndex + 1).toLowerCase();
+    return {
+        parentPID: Number(parentPID),
+        command,
+        consumerKey: getConsumerKeyFromCommand(command),
+    };
+};
+const getPathByDetectingIDE = async () => {
+    // Go up the chain of ancestor process IDs and find if one of their commands matches an IDE.
+    const ppid = process.ppid;
+    let result;
+    try {
+        result = await getCommandAndParentPID(ppid);
+        while (result.parentPID !== 1 && !result.consumerKey) {
+            result = await getCommandAndParentPID(result.parentPID);
+        }
+    }
+    catch {
+        // The command "ps -p {pid} -o ppid=,comm=" didn't work,
+        // perhaps we are on a machine that doesn't support it.
+        return null;
+    }
+    if (result?.consumerKey) {
+        const contextConsumer = cliContextConsumers.find((consumer) => consumer.key === result.consumerKey);
+        if (contextConsumer) {
+            return contextConsumer;
+        }
+    }
+    return null;
+};
+export const run = async (runOptions) => {
+    const { args, command } = runOptions;
+    let consumer = null;
+    const filePath = args[0];
+    if (filePath) {
+        consumer = { ...rulesForDefaultConsumer, path: filePath };
+    }
+    if (!consumer && process.env.AI_CONTEXT_SKIP_DETECTION !== 'true') {
+        consumer = await getPathByDetectingIDE();
+    }
+    if (!consumer) {
+        consumer = await promptForContextConsumerSelection();
+    }
+    if (!consumer?.contextScopes) {
+        log('No context files found for this consumer. Try again or let us know if this happens again via our support channels.');
+        return;
+    }
+    try {
+        await downloadAndWriteContextFiles(consumer, runOptions);
+        // the deprecated MCP file path
+        // let's remove that file if it exists.
+        const priorContextFilePath = resolve(command?.workingDir ?? '', consumer.path, NTL_DEV_MCP_FILE_NAME);
+        const priorExists = await getExistingContext(priorContextFilePath);
+        if (priorExists) {
+            await deleteFile(priorContextFilePath);
+        }
+        log('All context files have been added!');
+    }
+    catch (error) {
+        logAndThrowError(error);
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/recipes/ai-context/index.js.map

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

package/dist/recipes/blobs-migrate/index.d.ts

@@ -0,0 +1,9 @@
+import BaseCommand from '../../commands/base-command.js';
+export declare const description = "Migrate legacy Netlify Blobs stores";
+interface Options {
+    args: string[];
+    command: BaseCommand;
+}
+export declare const run: ({ args, command }: Options) => Promise<undefined>;
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/recipes/blobs-migrate/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recipes/blobs-migrate/index.ts"],"names":[],"mappings":"AAIA,OAAO,WAAW,MAAM,gCAAgC,CAAA;AAGxD,eAAO,MAAM,WAAW,wCAAwC,CAAA;AAIhE,UAAU,OAAO;IACf,IAAI,EAAE,MAAM,EAAE,CAAA;IACd,OAAO,EAAE,WAAW,CAAA;CACrB;AAED,eAAO,MAAM,GAAG,GAAU,mBAAmB,OAAO,uBA2FnD,CAAA"}

package/dist/recipes/blobs-migrate/index.js

@@ -0,0 +1,78 @@
+import { getStore, listStores } from '@netlify/blobs';
+import inquirer from 'inquirer';
+import pMap from 'p-map';
+import { logAndThrowError, log } from '../../utils/command-helpers.js';
+export const description = 'Migrate legacy Netlify Blobs stores';
+const BLOB_OPS_CONCURRENCY = 5;
+export const run = async ({ args, command }) => {
+    if (args.length !== 1) {
+        return logAndThrowError(`Usage: netlify recipes blobs-migrate <name of store>`);
+    }
+    const [storeName] = args;
+    const { api, siteInfo } = command.netlify;
+    const clientOptions = {
+        apiURL: `${api.scheme}://${api.host}`,
+        siteID: siteInfo.id,
+        token: api.accessToken ?? '',
+    };
+    // The store we'll copy from.
+    const oldStore = getStore({
+        ...clientOptions,
+        name: `netlify-internal/legacy-namespace/${storeName}`,
+    });
+    // The store we'll write to.
+    const newStore = getStore({
+        ...clientOptions,
+        name: storeName,
+    });
+    const { blobs } = await oldStore.list();
+    if (blobs.length === 0) {
+        log(`Store '${storeName}' does not exist or is empty, so there's nothing to migrate.`);
+        return;
+    }
+    const { stores } = await listStores(clientOptions);
+    if (stores.includes(storeName)) {
+        const { confirmExistingStore } = await inquirer.prompt({
+            type: 'confirm',
+            name: 'confirmExistingStore',
+            message: `The store '${storeName}' already exists in the new format, which means it has already been migrated or it has been used with a newer version of the Netlify Blobs client. If you continue with the migration, any blobs from the legacy store will overwrite newer entries that have the same key. Do you want to proceed?`,
+            default: false,
+        });
+        if (!confirmExistingStore) {
+            return;
+        }
+    }
+    const { confirmMigration } = await inquirer.prompt({
+        type: 'confirm',
+        name: 'confirmMigration',
+        message: `You're about to migrate the store '${storeName}' with ${blobs.length} blobs. Do you want to proceed?`,
+        default: true,
+    });
+    if (!confirmMigration) {
+        return;
+    }
+    await pMap(blobs, async (blob) => {
+        log(`Migrating blob with key '${blob.key}'...`);
+        const result = await oldStore.getWithMetadata(blob.key);
+        if (result === null) {
+            return;
+        }
+        await newStore.set(blob.key, result.data, { metadata: result.metadata });
+    }, { concurrency: BLOB_OPS_CONCURRENCY });
+    log('Verifying data in the new store...');
+    const { blobs: newBlobs } = await newStore.list();
+    const blobsMap = new Map(newBlobs.map((blob) => [blob.key, blob.etag]));
+    // Before deleting anything, let's first verify that all entries that exist
+    // in the old store are now also on the new store, with the same etag.
+    if (!blobs.every((blob) => blobsMap.get(blob.key) === blob.etag)) {
+        return logAndThrowError(`Failed to migrate some blobs. Try running the command again.`);
+    }
+    try {
+        await pMap(blobs, (blob) => oldStore.delete(blob.key), { concurrency: BLOB_OPS_CONCURRENCY });
+    }
+    catch {
+        return logAndThrowError('Failed to remove legacy store after migration. Try running the command again.');
+    }
+    log(`Store '${storeName}' has been migrated successfully.`);
+};
+//# sourceMappingURL=index.js.map

package/dist/recipes/blobs-migrate/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/recipes/blobs-migrate/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACrD,OAAO,QAAQ,MAAM,UAAU,CAAA;AAC/B,OAAO,IAAI,MAAM,OAAO,CAAA;AAGxB,OAAO,EAAE,gBAAgB,EAAE,GAAG,EAAE,MAAM,gCAAgC,CAAA;AAEtE,MAAM,CAAC,MAAM,WAAW,GAAG,qCAAqC,CAAA;AAEhE,MAAM,oBAAoB,GAAG,CAAC,CAAA;AAO9B,MAAM,CAAC,MAAM,GAAG,GAAG,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAW,EAAE,EAAE;IACtD,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,gBAAgB,CAAC,sDAAsD,CAAC,CAAA;IACjF,CAAC;IAED,MAAM,CAAC,SAAS,CAAC,GAAG,IAAI,CAAA;IACxB,MAAM,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,OAAO,CAAA;IACzC,MAAM,aAAa,GAAG;QACpB,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE;QACrC,MAAM,EAAE,QAAQ,CAAC,EAAE;QACnB,KAAK,EAAE,GAAG,CAAC,WAAW,IAAI,EAAE;KAC7B,CAAA;IAED,6BAA6B;IAC7B,MAAM,QAAQ,GAAG,QAAQ,CAAC;QACxB,GAAG,aAAa;QAChB,IAAI,EAAE,qCAAqC,SAAS,EAAE;KACvD,CAAC,CAAA;IAEF,4BAA4B;IAC5B,MAAM,QAAQ,GAAG,QAAQ,CAAC;QACxB,GAAG,aAAa;QAChB,IAAI,EAAE,SAAS;KAChB,CAAC,CAAA;IACF,MAAM,EAAE,KAAK,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IAEvC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,CAAC,UAAU,SAAS,8DAA8D,CAAC,CAAA;QACtF,OAAM;IACR,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,UAAU,CAAC,aAAa,CAAC,CAAA;IAElD,IAAI,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;YACrD,IAAI,EAAE,SAAS;YACf,IAAI,EAAE,sBAAsB;YAC5B,OAAO,EAAE,cAAc,SAAS,qSAAqS;YACrU,OAAO,EAAE,KAAK;SACf,CAAC,CAAA;QAEF,IAAI,CAAC,oBAAoB,EAAE,CAAC;YAC1B,OAAM;QACR,CAAC;IACH,CAAC;IAED,MAAM,EAAE,gBAAgB,EAAE,GAAG,MAAM,QAAQ,CAAC,MAAM,CAAC;QACjD,IAAI,EAAE,SAAS;QACf,IAAI,EAAE,kBAAkB;QACxB,OAAO,EAAE,sCAAsC,SAAS,UAAU,KAAK,CAAC,MAAM,iCAAiC;QAC/G,OAAO,EAAE,IAAI;KACd,CAAC,CAAA;IAEF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAM;IACR,CAAC;IAED,MAAM,IAAI,CACR,KAAK,EACL,KAAK,EAAE,IAAI,EAAE,EAAE;QACb,GAAG,CAAC,4BAA4B,IAAI,CAAC,GAAG,MAAM,CAAC,CAAA;QAE/C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;QAEvD,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;YACpB,OAAM;QACR,CAAC;QAED,MAAM,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC1E,CAAC,EACD,EAAE,WAAW,EAAE,oBAAoB,EAAE,CACtC,CAAA;IAED,GAAG,CAAC,oCAAoC,CAAC,CAAA;IAEzC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAA;IACjD,MAAM,QAAQ,GAAG,IAAI,GAAG,CAAiB,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;IAEvF,2EAA2E;IAC3E,sEAAsE;IACtE,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,OAAO,gBAAgB,CAAC,8DAA8D,CAAC,CAAA;IACzF,CAAC;IAED,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,WAAW,EAAE,oBAAoB,EAAE,CAAC,CAAA;IAC/F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,gBAAgB,CAAC,+EAA+E,CAAC,CAAA;IAC1G,CAAC;IAED,GAAG,CAAC,UAAU,SAAS,mCAAmC,CAAC,CAAA;AAC7D,CAAC,CAAA"}

package/dist/recipes/vscode/index.d.ts

@@ -0,0 +1,12 @@
+export declare const description = "Create VS Code settings for an optimal experience with Netlify projects";
+/**
+ * @param {object} params
+ * @param {*} params.config
+ * @param {string} params.repositoryRoot
+ * @returns
+ */
+export declare const run: ({ config, repositoryRoot }: {
+    config: any;
+    repositoryRoot: any;
+}) => Promise<undefined>;
+//# sourceMappingURL=index.d.ts.map

package/dist/recipes/vscode/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/recipes/vscode/index.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,WAAW,4EAA4E,CAAA;AAuDpG;;;;;GAKG;AAEH,eAAO,MAAM,GAAG,GAAU;;;CAA0B,uBAuCnD,CAAA"}

package/dist/recipes/vscode/index.js

@@ -0,0 +1,93 @@
+import { join } from 'path';
+import { DenoBridge } from '@netlify/edge-bundler';
+import execa from 'execa';
+import inquirer from 'inquirer';
+import { NETLIFYDEVLOG, NETLIFYDEVWARN, chalk, logAndThrowError, log } from '../../utils/command-helpers.js';
+import { applySettings, getSettings, writeSettings } from './settings.js';
+export const description = 'Create VS Code settings for an optimal experience with Netlify projects';
+// @ts-expect-error TS(7031) FIXME: Binding element 'fileExists' implicitly has an 'an... Remove this comment to see the full error message
+const getPrompt = ({ fileExists, path }) => {
+    const formattedPath = chalk.underline(path);
+    const message = fileExists
+        ? `There is a VS Code settings file at ${formattedPath}. Can we update it?`
+        : `A new VS Code settings file will be created at ${formattedPath}`;
+    return inquirer.prompt({
+        type: 'confirm',
+        name: 'confirm',
+        message,
+        default: true,
+    });
+};
+// @ts-expect-error TS(7031) FIXME: Binding element 'config' implicitly has an 'any' t... Remove this comment to see the full error message
+const getEdgeFunctionsPath = ({ config, repositoryRoot }) => config.build.edge_functions || join(repositoryRoot, 'netlify', 'edge-functions');
+/**
+ * @param {string} repositoryRoot
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'repositoryRoot' implicitly has an 'any'... Remove this comment to see the full error message
+const getSettingsPath = (repositoryRoot) => join(repositoryRoot, '.vscode', 'settings.json');
+/**
+ * @param {string} repositoryRoot
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'repositoryRoot' implicitly has an 'any'... Remove this comment to see the full error message
+const hasDenoVSCodeExt = async (repositoryRoot) => {
+    const { stdout: extensions } = await execa('code', ['--list-extensions'], { stderr: 'inherit', cwd: repositoryRoot });
+    return extensions.split('\n').includes('denoland.vscode-deno');
+};
+/**
+ * @param {string} repositoryRoot
+ */
+// @ts-expect-error TS(7006) FIXME: Parameter 'repositoryRoot' implicitly has an 'any'... Remove this comment to see the full error message
+const getDenoVSCodeExt = async (repositoryRoot) => {
+    await execa('code', ['--install-extension', 'denoland.vscode-deno'], { stdio: 'inherit', cwd: repositoryRoot });
+};
+const getDenoExtPrompt = () => {
+    const message = 'The Deno VS Code extension is recommended. Would you like to install it now?';
+    return inquirer.prompt({
+        type: 'confirm',
+        name: 'confirm',
+        message,
+        default: true,
+    });
+};
+/**
+ * @param {object} params
+ * @param {*} params.config
+ * @param {string} params.repositoryRoot
+ * @returns
+ */
+// @ts-expect-error TS(7031) FIXME: Binding element 'config' implicitly has an 'any' t... Remove this comment to see the full error message
+export const run = async ({ config, repositoryRoot }) => {
+    const deno = new DenoBridge({
+        onBeforeDownload: () => {
+            log(`${NETLIFYDEVWARN} Setting up the Edge Functions environment. This may take a couple of minutes.`);
+        },
+    });
+    const denoBinary = await deno.getBinaryPath();
+    const settingsPath = getSettingsPath(repositoryRoot);
+    const edgeFunctionsPath = getEdgeFunctionsPath({ config, repositoryRoot });
+    const { fileExists, settings: existingSettings } = await getSettings(settingsPath);
+    const settings = applySettings(existingSettings, { denoBinary, edgeFunctionsPath, repositoryRoot });
+    const { confirm } = await getPrompt({ fileExists, path: settingsPath });
+    if (!confirm) {
+        return;
+    }
+    try {
+        if (!(await hasDenoVSCodeExt(repositoryRoot))) {
+            const { confirm: denoExtConfirm } = await getDenoExtPrompt();
+            if (denoExtConfirm) {
+                getDenoVSCodeExt(repositoryRoot);
+            }
+        }
+    }
+    catch {
+        log(`${NETLIFYDEVWARN} Unable to install Deno VS Code extension. To install it manually, visit ${chalk.blue('https://ntl.fyi/deno-vscode')}.`);
+    }
+    try {
+        await writeSettings({ settings, settingsPath });
+        log(`${NETLIFYDEVLOG} VS Code settings file ${fileExists ? 'updated' : 'created'}.`);
+    }
+    catch {
+        return logAndThrowError('Could not write VS Code settings file.');
+    }
+};
+//# sourceMappingURL=index.js.map

package/dist/recipes/vscode/index.js.map

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