netlify-cli/dist/recipes/ai-context/context.js

Netlify command line tool

import { promises as fs } from 'node:fs';
import { dirname } from 'node:path';
const ATTRIBUTES_REGEX = /(\S*)="([^\s"]*)"/gim;
const BASE_URL = 'https://docs.netlify.com/ai-context';
export const 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';
export const downloadFile = async (cliVersion) => {
    try {
        const res = await fetch(`${BASE_URL}/${FILE_NAME}`, {
            headers: {
                'user-agent': `NetlifyCLI ${cliVersion}`,
            },
        });
        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}>`);
};
/**
 * 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);
};
//# sourceMappingURL=context.js.map