@salesforce/b2c-tooling-sdk 0.0.1 → 0.0.3

package/dist/cjs/operations/mrt/bundle.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Default SSR parameters applied to all bundles.
+ * These can be overridden by providing ssrParameters in CreateBundleOptions.
+ */
+export declare const DEFAULT_SSR_PARAMETERS: Record<string, unknown>;
+/**
+ * Configuration for bundle creation.
+ */
+export interface CreateBundleOptions {
+    /**
+     * Optional message describing the bundle.
+     * Defaults to a git-based message or a timestamp.
+     */
+    message?: string;
+    /**
+     * SSR parameters to include in the bundle.
+     * These are configuration values for the SSR runtime.
+     */
+    ssrParameters?: Record<string, unknown>;
+    /**
+     * Glob patterns for files that should only run on the server.
+     * @example ['ssr.js', 'ssr/*.js']
+     */
+    ssrOnly: string[];
+    /**
+     * Glob patterns for files shared between client and server.
+     * @example ['static/**\/*', '**\/*.js']
+     */
+    ssrShared: string[];
+    /**
+     * Path to the build directory containing the application build output.
+     * @default 'build'
+     */
+    buildDirectory?: string;
+    /**
+     * Project slug for the MRT project.
+     * Used to prefix files in the archive.
+     */
+    projectSlug: string;
+}
+/**
+ * A bundle ready for upload to Managed Runtime.
+ */
+export interface Bundle {
+    /**
+     * Message describing the bundle.
+     */
+    message: string;
+    /**
+     * Encoding of the data field.
+     */
+    encoding: 'base64';
+    /**
+     * Base64-encoded tar archive of the build.
+     */
+    data: string;
+    /**
+     * SSR parameters configuration.
+     */
+    ssr_parameters: Record<string, unknown>;
+    /**
+     * List of files that only run on the server.
+     */
+    ssr_only: string[];
+    /**
+     * List of files shared between client and server.
+     */
+    ssr_shared: string[];
+    /**
+     * Bundle metadata including dependencies.
+     */
+    bundle_metadata?: Record<string, unknown>;
+}
+/**
+ * Creates a glob filter function from patterns.
+ *
+ * Patterns can include negations (prefixed with !).
+ * A path matches if it matches any positive pattern
+ * and does not match any negative pattern.
+ *
+ * @param patterns - Glob patterns to match against
+ * @returns Filter function that returns true for matching paths
+ */
+export declare function createGlobFilter(patterns?: string[]): (path: string) => boolean;
+/**
+ * Gets a default bundle message with timestamp.
+ *
+ * @returns A message like "Bundle 2025-01-15T10:30:00.000Z"
+ */
+export declare function getDefaultMessage(): string;
+/**
+ * Creates a bundle from a build directory.
+ *
+ * This creates a tar archive of the build directory, base64 encodes it,
+ * and returns a bundle object ready for upload to Managed Runtime.
+ *
+ * The archive structure is: `{projectSlug}/bld/{files...}`
+ *
+ * @param options - Bundle creation options
+ * @returns Bundle object ready for upload
+ * @throws Error if build directory doesn't exist or ssr patterns are empty
+ *
+ * @example
+ * ```typescript
+ * const bundle = await createBundle({
+ *   projectSlug: 'my-project',
+ *   ssrOnly: ['ssr.js'],
+ *   ssrShared: ['**\/*.js', 'static/**\/*'],
+ *   buildDirectory: './build',
+ *   message: 'Release v1.0.0'
+ * });
+ * ```
+ */
+export declare function createBundle(options: CreateBundleOptions): Promise<Bundle>;

package/dist/cjs/operations/mrt/bundle.js

@@ -0,0 +1,166 @@
+/*
+ * Copyright (c) 2025, Salesforce, Inc.
+ * SPDX-License-Identifier: Apache-2
+ * For full license text, see the license.txt file in the repo root or http://www.apache.org/licenses/LICENSE-2.0
+ */
+/**
+ * Bundle creation utilities for Managed Runtime.
+ *
+ * Creates tar archives for deployment to Managed Runtime.
+ * Based on the bundle format expected by the MRT API.
+ *
+ * @module operations/mrt/bundle
+ */
+import { createWriteStream } from 'node:fs';
+import { readFile, stat, mkdtemp, rm } from 'node:fs/promises';
+import path from 'node:path';
+import os from 'node:os';
+import archiver from 'archiver';
+import { Minimatch } from 'minimatch';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Default SSR parameters applied to all bundles.
+ * These can be overridden by providing ssrParameters in CreateBundleOptions.
+ */
+export const DEFAULT_SSR_PARAMETERS = {
+    /**
+     * Node.js version for the SSR function runtime.
+     * @see https://developer.salesforce.com/docs/commerce/pwa-kit-managed-runtime/guide/upgrading-node-version.html
+     */
+    SSRFunctionNodeVersion: '22.x',
+};
+/**
+ * Creates a glob filter function from patterns.
+ *
+ * Patterns can include negations (prefixed with !).
+ * A path matches if it matches any positive pattern
+ * and does not match any negative pattern.
+ *
+ * @param patterns - Glob patterns to match against
+ * @returns Filter function that returns true for matching paths
+ */
+export function createGlobFilter(patterns) {
+    const allPatterns = (patterns || [])
+        .map((pattern) => new Minimatch(pattern, { nocomment: true }))
+        .filter((pattern) => !pattern.empty);
+    const positivePatterns = allPatterns.filter((pattern) => !pattern.negate);
+    const negativePatterns = allPatterns.filter((pattern) => pattern.negate);
+    return (filePath) => {
+        if (!filePath)
+            return false;
+        const positive = positivePatterns.some((pattern) => pattern.match(filePath));
+        const negative = negativePatterns.some((pattern) => !pattern.match(filePath));
+        return positive && !negative;
+    };
+}
+/**
+ * Gets a default bundle message with timestamp.
+ *
+ * @returns A message like "Bundle 2025-01-15T10:30:00.000Z"
+ */
+export function getDefaultMessage() {
+    return `Bundle ${new Date().toISOString()}`;
+}
+/**
+ * Creates a bundle from a build directory.
+ *
+ * This creates a tar archive of the build directory, base64 encodes it,
+ * and returns a bundle object ready for upload to Managed Runtime.
+ *
+ * The archive structure is: `{projectSlug}/bld/{files...}`
+ *
+ * @param options - Bundle creation options
+ * @returns Bundle object ready for upload
+ * @throws Error if build directory doesn't exist or ssr patterns are empty
+ *
+ * @example
+ * ```typescript
+ * const bundle = await createBundle({
+ *   projectSlug: 'my-project',
+ *   ssrOnly: ['ssr.js'],
+ *   ssrShared: ['**\/*.js', 'static/**\/*'],
+ *   buildDirectory: './build',
+ *   message: 'Release v1.0.0'
+ * });
+ * ```
+ */
+export async function createBundle(options) {
+    const logger = getLogger();
+    const { ssrOnly, ssrShared, projectSlug } = options;
+    const buildDirectory = options.buildDirectory || 'build';
+    const message = options.message || getDefaultMessage();
+    // Merge default SSR parameters with provided ones (provided values take precedence)
+    const ssrParameters = {
+        ...DEFAULT_SSR_PARAMETERS,
+        ...options.ssrParameters,
+    };
+    logger.debug({ projectSlug, buildDirectory, ssrParameters }, '[MRT] Creating bundle');
+    // Validate SSR patterns
+    if (ssrOnly.length === 0 || ssrShared.length === 0) {
+        throw new Error('ssrOnly and ssrShared patterns are required and cannot be empty');
+    }
+    // Verify build directory exists
+    const buildPath = path.isAbsolute(buildDirectory) ? buildDirectory : path.join(process.cwd(), buildDirectory);
+    try {
+        await stat(buildPath);
+    }
+    catch {
+        throw new Error(`Build directory at path "${buildPath}" not found.\n` + 'Ensure your project has been built first.');
+    }
+    // Create temp directory for tar file
+    const tmpDir = await mkdtemp(path.join(os.tmpdir(), 'b2c-mrt-'));
+    const tarPath = path.join(tmpDir, 'build.tar');
+    const filesInArchive = [];
+    try {
+        // Create tar archive
+        await new Promise((resolve, reject) => {
+            const output = createWriteStream(tarPath);
+            const archive = archiver('tar');
+            archive.pipe(output);
+            // Prefix all files with {projectSlug}/bld/
+            const newRoot = path.join(projectSlug, 'bld', '');
+            archive.directory(buildPath, false, (entry) => {
+                const stats = entry.stats;
+                if (stats?.isFile() && entry.name) {
+                    filesInArchive.push(entry.name);
+                }
+                entry.prefix = newRoot;
+                return entry;
+            });
+            archive.on('error', reject);
+            output.on('finish', resolve);
+            archive.finalize();
+        });
+        logger.debug({ fileCount: filesInArchive.length }, '[MRT] Archive created');
+        logger.trace({ files: filesInArchive.slice(0, 20) }, '[MRT] First 20 files in archive');
+        // Read and encode the tar file
+        const tarData = await readFile(tarPath);
+        const base64Data = tarData.toString('base64');
+        // Filter files for ssr_only and ssr_shared
+        logger.trace({ ssrOnly, ssrShared }, '[MRT] SSR patterns');
+        const ssrOnlyFilter = createGlobFilter(ssrOnly);
+        const ssrSharedFilter = createGlobFilter(ssrShared);
+        const ssrOnlyFiles = filesInArchive.filter(ssrOnlyFilter);
+        const ssrSharedFiles = filesInArchive.filter(ssrSharedFilter);
+        logger.trace({ ssrOnlyFiles: ssrOnlyFiles.slice(0, 20) }, '[MRT] First 20 ssr_only files');
+        logger.trace({ ssrSharedFiles: ssrSharedFiles.slice(0, 20) }, '[MRT] First 20 ssr_shared files');
+        logger.debug({
+            ssrOnlyCount: ssrOnlyFiles.length,
+            ssrSharedCount: ssrSharedFiles.length,
+            totalSize: base64Data.length,
+        }, '[MRT] Bundle created');
+        return {
+            message,
+            encoding: 'base64',
+            data: base64Data,
+            ssr_parameters: ssrParameters,
+            ssr_only: ssrOnlyFiles,
+            ssr_shared: ssrSharedFiles,
+        };
+    }
+    finally {
+        // Clean up temp directory
+        await rm(tmpDir, { recursive: true }).catch(() => { });
+    }
+}
+//# sourceMappingURL=bundle.js.map

package/dist/cjs/operations/mrt/bundle.js.map

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

package/dist/cjs/operations/mrt/env-var.d.ts

@@ -0,0 +1,176 @@
+/**
+ * Environment variable operations for Managed Runtime.
+ *
+ * Handles listing, setting, and deleting environment variables
+ * on MRT project environments.
+ *
+ * @module operations/mrt/env-var
+ */
+import type { AuthStrategy } from '../../auth/types.js';
+/**
+ * Environment variable information returned from MRT.
+ */
+export interface EnvironmentVariable {
+    /** Name of the environment variable */
+    name: string;
+    /** Masked value (only last few characters visible) */
+    value: string;
+    /** Email of user who created the variable */
+    createdBy: string;
+    /** ISO timestamp when created */
+    createdAt: string;
+    /** ISO timestamp when last updated */
+    updatedAt: string;
+    /** Email of user who last updated the variable */
+    updatedBy: string;
+    /** Publishing status code */
+    publishingStatus: number;
+    /** Human-readable publishing status */
+    publishingStatusDescription: string;
+}
+/**
+ * Result of listing environment variables.
+ */
+export interface ListEnvVarsResult {
+    /** Total count of environment variables */
+    count: number;
+    /** Environment variables */
+    variables: EnvironmentVariable[];
+}
+/**
+ * Options for environment variable operations.
+ */
+export interface EnvVarOptions {
+    /** MRT project slug */
+    projectSlug: string;
+    /** Target environment (e.g., 'staging', 'production') */
+    environment: string;
+    /**
+     * MRT API origin URL.
+     * @default "https://cloud.mobify.com"
+     */
+    origin?: string;
+}
+/**
+ * Lists environment variables for a project environment.
+ *
+ * @param options - Options specifying project and environment
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns List of environment variables
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { listEnvVars } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const result = await listEnvVars({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production'
+ * }, auth);
+ *
+ * for (const envVar of result.variables) {
+ *   console.log(`${envVar.name}=${envVar.value}`);
+ * }
+ * ```
+ */
+export declare function listEnvVars(options: EnvVarOptions, auth: AuthStrategy): Promise<ListEnvVarsResult>;
+/**
+ * Options for setting an environment variable.
+ */
+export interface SetEnvVarOptions extends EnvVarOptions {
+    /** Environment variable name */
+    key: string;
+    /** Environment variable value */
+    value: string;
+}
+/**
+ * Sets an environment variable on a project environment.
+ *
+ * Creates the variable if it doesn't exist, or updates it if it does.
+ *
+ * @param options - Options specifying project, environment, and variable
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { setEnvVar } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await setEnvVar({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production',
+ *   key: 'API_KEY',
+ *   value: 'secret-value'
+ * }, auth);
+ * ```
+ */
+export declare function setEnvVar(options: SetEnvVarOptions, auth: AuthStrategy): Promise<void>;
+/**
+ * Options for setting multiple environment variables.
+ */
+export interface SetEnvVarsOptions extends EnvVarOptions {
+    /** Environment variables to set as key-value pairs */
+    variables: Record<string, string>;
+}
+/**
+ * Sets multiple environment variables on a project environment.
+ *
+ * Creates variables if they don't exist, or updates them if they do.
+ *
+ * @param options - Options specifying project, environment, and variables
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { setEnvVars } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await setEnvVars({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production',
+ *   variables: {
+ *     API_KEY: 'secret-value',
+ *     DEBUG: 'false'
+ *   }
+ * }, auth);
+ * ```
+ */
+export declare function setEnvVars(options: SetEnvVarsOptions, auth: AuthStrategy): Promise<void>;
+/**
+ * Options for deleting an environment variable.
+ */
+export interface DeleteEnvVarOptions extends EnvVarOptions {
+    /** Environment variable name to delete */
+    key: string;
+}
+/**
+ * Deletes an environment variable from a project environment.
+ *
+ * @param options - Options specifying project, environment, and variable name
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { deleteEnvVar } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await deleteEnvVar({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production',
+ *   key: 'OLD_API_KEY'
+ * }, auth);
+ * ```
+ */
+export declare function deleteEnvVar(options: DeleteEnvVarOptions, auth: AuthStrategy): Promise<void>;

package/dist/cjs/operations/mrt/env-var.js

@@ -0,0 +1,231 @@
+import { createMrtClient, DEFAULT_MRT_ORIGIN } from '../../clients/mrt.js';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Lists environment variables for a project environment.
+ *
+ * @param options - Options specifying project and environment
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns List of environment variables
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { listEnvVars } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const result = await listEnvVars({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production'
+ * }, auth);
+ *
+ * for (const envVar of result.variables) {
+ *   console.log(`${envVar.name}=${envVar.value}`);
+ * }
+ * ```
+ */
+export async function listEnvVars(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, environment, origin } = options;
+    logger.debug({ projectSlug, environment }, '[MRT] Listing environment variables');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { data, error } = await client.GET('/api/projects/{project_slug}/target/{target_slug}/env-var/', {
+        params: {
+            path: {
+                project_slug: projectSlug,
+                target_slug: environment,
+            },
+        },
+    });
+    if (error) {
+        throw new Error(`Failed to list environment variables: ${JSON.stringify(error)}`);
+    }
+    // The API can return two formats:
+    // 1. Paginated: { count, next, previous, results: [{ "VAR_NAME": {...} }, ...] }
+    // 2. Direct object: { "VAR_NAME": {...}, "VAR_NAME2": {...}, ... }
+    const variables = [];
+    const responseData = data;
+    // Check if it's the paginated format (has 'results' array)
+    if (responseData?.results && Array.isArray(responseData.results)) {
+        for (const item of responseData.results) {
+            const entries = Object.entries(item);
+            for (const [name, metadata] of entries) {
+                const meta = metadata;
+                variables.push(parseEnvVarMetadata(name, meta));
+            }
+        }
+    }
+    else if (responseData) {
+        // Direct object format - each key is an env var name (skip pagination fields)
+        const paginationFields = ['count', 'next', 'previous', 'results'];
+        for (const [name, metadata] of Object.entries(responseData)) {
+            if (paginationFields.includes(name))
+                continue;
+            const meta = metadata;
+            // Verify it looks like env var metadata (has 'value' property)
+            if (meta && typeof meta === 'object' && 'value' in meta) {
+                variables.push(parseEnvVarMetadata(name, meta));
+            }
+        }
+    }
+    logger.debug({ count: variables.length }, '[MRT] Listed environment variables');
+    return {
+        count: typeof responseData?.count === 'number' ? responseData.count : variables.length,
+        variables,
+    };
+}
+/**
+ * Parses environment variable metadata from API response.
+ */
+function parseEnvVarMetadata(name, meta) {
+    return {
+        name,
+        value: String(meta.value ?? ''),
+        createdBy: String(meta.created_by ?? ''),
+        createdAt: String(meta.created_at ?? ''),
+        updatedAt: String(meta.updated_at ?? ''),
+        updatedBy: String(meta.updated_by ?? ''),
+        publishingStatus: Number(meta.publishing_status ?? 0),
+        publishingStatusDescription: String(meta.publishing_status_description ?? ''),
+    };
+}
+/**
+ * Sets an environment variable on a project environment.
+ *
+ * Creates the variable if it doesn't exist, or updates it if it does.
+ *
+ * @param options - Options specifying project, environment, and variable
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { setEnvVar } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await setEnvVar({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production',
+ *   key: 'API_KEY',
+ *   value: 'secret-value'
+ * }, auth);
+ * ```
+ */
+export async function setEnvVar(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, environment, key, value, origin } = options;
+    logger.debug({ projectSlug, environment, key }, '[MRT] Setting environment variable');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { error } = await client.PATCH('/api/projects/{project_slug}/target/{target_slug}/env-var/', {
+        params: {
+            path: {
+                project_slug: projectSlug,
+                target_slug: environment,
+            },
+        },
+        body: {
+            [key]: { value },
+        },
+    });
+    if (error) {
+        throw new Error(`Failed to set environment variable: ${JSON.stringify(error)}`);
+    }
+    logger.debug({ projectSlug, environment, key }, '[MRT] Environment variable set');
+}
+/**
+ * Sets multiple environment variables on a project environment.
+ *
+ * Creates variables if they don't exist, or updates them if they do.
+ *
+ * @param options - Options specifying project, environment, and variables
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { setEnvVars } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await setEnvVars({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production',
+ *   variables: {
+ *     API_KEY: 'secret-value',
+ *     DEBUG: 'false'
+ *   }
+ * }, auth);
+ * ```
+ */
+export async function setEnvVars(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, environment, variables, origin } = options;
+    const keys = Object.keys(variables);
+    logger.debug({ projectSlug, environment, count: keys.length }, '[MRT] Setting environment variables');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    // Build body with {key: {value}} format for each variable
+    const body = {};
+    for (const [key, value] of Object.entries(variables)) {
+        body[key] = { value };
+    }
+    const { error } = await client.PATCH('/api/projects/{project_slug}/target/{target_slug}/env-var/', {
+        params: {
+            path: {
+                project_slug: projectSlug,
+                target_slug: environment,
+            },
+        },
+        body,
+    });
+    if (error) {
+        throw new Error(`Failed to set environment variables: ${JSON.stringify(error)}`);
+    }
+    logger.debug({ projectSlug, environment, keys }, '[MRT] Environment variables set');
+}
+/**
+ * Deletes an environment variable from a project environment.
+ *
+ * @param options - Options specifying project, environment, and variable name
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if request fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { deleteEnvVar } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await deleteEnvVar({
+ *   projectSlug: 'my-storefront',
+ *   environment: 'production',
+ *   key: 'OLD_API_KEY'
+ * }, auth);
+ * ```
+ */
+export async function deleteEnvVar(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, environment, key, origin } = options;
+    logger.debug({ projectSlug, environment, key }, '[MRT] Deleting environment variable');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { error } = await client.PATCH('/api/projects/{project_slug}/target/{target_slug}/env-var/', {
+        params: {
+            path: {
+                project_slug: projectSlug,
+                target_slug: environment,
+            },
+        },
+        body: {
+            [key]: { value: null },
+        },
+    });
+    if (error) {
+        throw new Error(`Failed to delete environment variable: ${JSON.stringify(error)}`);
+    }
+    logger.debug({ projectSlug, environment, key }, '[MRT] Environment variable deleted');
+}
+//# sourceMappingURL=env-var.js.map