@salesforce/b2c-tooling-sdk 0.0.0-nightly.20260119053920

package/dist/esm/operations/mrt/env-var.js.map

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

package/dist/esm/operations/mrt/env.d.ts

@@ -0,0 +1,256 @@
+/**
+ * Environment operations for Managed Runtime.
+ *
+ * Handles creating and managing MRT environments (targets).
+ *
+ * @module operations/mrt/env
+ */
+import type { AuthStrategy } from '../../auth/types.js';
+import type { components } from '../../clients/mrt.js';
+/**
+ * MRT environment (target) type from API.
+ */
+export type MrtEnvironment = components['schemas']['APITargetV2Create'];
+/**
+ * Environment state from the MRT API.
+ */
+export type MrtEnvironmentState = components['schemas']['StateEnum'];
+type SsrRegion = components['schemas']['SsrRegionEnum'];
+type LogLevel = components['schemas']['LogLevelEnum'];
+/**
+ * Options for creating an MRT environment.
+ */
+export interface CreateEnvOptions {
+    /**
+     * The project slug to create the environment in.
+     */
+    projectSlug: string;
+    /**
+     * Environment slug/identifier (e.g., staging, production).
+     */
+    slug: string;
+    /**
+     * Display name for the environment.
+     */
+    name: string;
+    /**
+     * AWS region for SSR deployment.
+     */
+    region?: SsrRegion;
+    /**
+     * Mark as a production environment.
+     */
+    isProduction?: boolean;
+    /**
+     * Hostname pattern for V8 Tag loading.
+     */
+    hostname?: string;
+    /**
+     * Full external hostname (e.g., www.example.com).
+     */
+    externalHostname?: string;
+    /**
+     * External domain for Universal PWA SSR (e.g., example.com).
+     */
+    externalDomain?: string;
+    /**
+     * Forward HTTP cookies to origin.
+     */
+    allowCookies?: boolean;
+    /**
+     * Enable source map support in the environment.
+     */
+    enableSourceMaps?: boolean;
+    /**
+     * Minimum log level for the environment.
+     */
+    logLevel?: LogLevel;
+    /**
+     * IP whitelist (CIDR blocks, space-separated).
+     */
+    whitelistedIps?: string;
+    /**
+     * Proxy configurations for SSR.
+     * Each proxy maps a path prefix to a backend host.
+     */
+    proxyConfigs?: Array<{
+        /** The path prefix to proxy (e.g., 'api', 'ocapi', 'einstein'). */
+        path: string;
+        /** The backend host to proxy to (e.g., 'api.example.com'). */
+        host: string;
+    }>;
+    /**
+     * MRT API origin URL.
+     * @default "https://cloud.mobify.com"
+     */
+    origin?: string;
+}
+/**
+ * Creates a new environment (target) in an MRT project.
+ *
+ * @param options - Environment creation options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The full environment object from the API
+ * @throws Error if creation fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { createEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const env = await createEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging',
+ *   name: 'Staging Environment',
+ *   region: 'us-east-1',
+ *   isProduction: false
+ * }, auth);
+ *
+ * console.log(`Environment ${env.slug} created`);
+ * ```
+ */
+export declare function createEnv(options: CreateEnvOptions, auth: AuthStrategy): Promise<MrtEnvironment>;
+/**
+ * Options for deleting an MRT environment.
+ */
+export interface DeleteEnvOptions {
+    /**
+     * The project slug containing the environment.
+     */
+    projectSlug: string;
+    /**
+     * Environment slug/identifier to delete.
+     */
+    slug: string;
+    /**
+     * MRT API origin URL.
+     * @default "https://cloud.mobify.com"
+     */
+    origin?: string;
+}
+/**
+ * Deletes an environment (target) from an MRT project.
+ *
+ * @param options - Environment deletion options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if deletion fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { deleteEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await deleteEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'feature-test'
+ * }, auth);
+ *
+ * console.log('Environment deleted');
+ * ```
+ */
+export declare function deleteEnv(options: DeleteEnvOptions, auth: AuthStrategy): Promise<void>;
+/**
+ * Options for getting an MRT environment.
+ */
+export interface GetEnvOptions {
+    /**
+     * The project slug containing the environment.
+     */
+    projectSlug: string;
+    /**
+     * Environment slug/identifier to retrieve.
+     */
+    slug: string;
+    /**
+     * MRT API origin URL.
+     * @default "https://cloud.mobify.com"
+     */
+    origin?: string;
+}
+/**
+ * Gets an environment (target) from an MRT project.
+ *
+ * @param options - Environment retrieval options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The environment object from the API
+ * @throws Error if retrieval fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { getEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const env = await getEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging'
+ * }, auth);
+ *
+ * console.log(`Environment state: ${env.state}`);
+ * ```
+ */
+export declare function getEnv(options: GetEnvOptions, auth: AuthStrategy): Promise<MrtEnvironment>;
+/**
+ * Options for waiting for an MRT environment to be ready.
+ */
+export interface WaitForEnvOptions extends GetEnvOptions {
+    /**
+     * Polling interval in milliseconds.
+     * @default 10000
+     */
+    pollInterval?: number;
+    /**
+     * Maximum time to wait in milliseconds.
+     * @default 2700000 (45 minutes)
+     */
+    timeout?: number;
+    /**
+     * Optional callback called on each poll with the current environment state.
+     */
+    onPoll?: (env: MrtEnvironment) => void;
+}
+/**
+ * Waits for an environment to reach a terminal state (ACTIVE or failed).
+ *
+ * Polls the environment status until it reaches ACTIVE, CREATE_FAILED,
+ * or PUBLISH_FAILED state, or until the timeout is reached.
+ *
+ * @param options - Wait options including polling interval and timeout
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The environment in its terminal state
+ * @throws Error if timeout is reached or environment fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { createEnv, waitForEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * // Create environment
+ * const env = await createEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging',
+ *   name: 'Staging'
+ * }, auth);
+ *
+ * // Wait for it to be ready
+ * const readyEnv = await waitForEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging',
+ *   timeout: 60000, // 1 minute
+ *   onPoll: (e) => console.log(`State: ${e.state}`)
+ * }, auth);
+ *
+ * if (readyEnv.state === 'ACTIVE') {
+ *   console.log('Environment is ready!');
+ * }
+ * ```
+ */
+export declare function waitForEnv(options: WaitForEnvOptions, auth: AuthStrategy): Promise<MrtEnvironment>;
+export {};

package/dist/esm/operations/mrt/env.js

@@ -0,0 +1,233 @@
+import { createMrtClient, DEFAULT_MRT_ORIGIN } from '../../clients/mrt.js';
+import { getLogger } from '../../logging/logger.js';
+/**
+ * Creates a new environment (target) in an MRT project.
+ *
+ * @param options - Environment creation options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The full environment object from the API
+ * @throws Error if creation fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { createEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const env = await createEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging',
+ *   name: 'Staging Environment',
+ *   region: 'us-east-1',
+ *   isProduction: false
+ * }, auth);
+ *
+ * console.log(`Environment ${env.slug} created`);
+ * ```
+ */
+export async function createEnv(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, slug, name, origin } = options;
+    logger.debug({ projectSlug, slug }, '[MRT] Creating environment');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    // Build the request body
+    const body = {
+        slug,
+        name,
+        is_production: options.isProduction ?? false,
+    };
+    if (options.region) {
+        body.ssr_region = options.region;
+    }
+    if (options.hostname) {
+        body.hostname = options.hostname;
+    }
+    if (options.externalHostname) {
+        body.ssr_external_hostname = options.externalHostname;
+    }
+    if (options.externalDomain) {
+        body.ssr_external_domain = options.externalDomain;
+    }
+    if (options.allowCookies !== undefined) {
+        body.allow_cookies = options.allowCookies;
+    }
+    if (options.enableSourceMaps !== undefined) {
+        body.enable_source_maps = options.enableSourceMaps;
+    }
+    if (options.logLevel) {
+        body.log_level = options.logLevel;
+    }
+    if (options.whitelistedIps) {
+        body.ssr_whitelisted_ips = options.whitelistedIps;
+    }
+    if (options.proxyConfigs && options.proxyConfigs.length > 0) {
+        // The API accepts ssr_proxy_configs - cast to handle the path field
+        // which may not be in the generated types but is accepted by the API
+        body.ssr_proxy_configs = options.proxyConfigs;
+    }
+    const { data, error } = await client.POST('/api/projects/{project_slug}/target/', {
+        params: {
+            path: { project_slug: projectSlug },
+        },
+        body,
+    });
+    if (error) {
+        const errorMessage = typeof error === 'object' && error !== null && 'message' in error
+            ? String(error.message)
+            : JSON.stringify(error);
+        throw new Error(`Failed to create environment: ${errorMessage}`);
+    }
+    logger.debug({ slug: data.slug, state: data.state }, '[MRT] Environment created successfully');
+    return data;
+}
+/**
+ * Deletes an environment (target) from an MRT project.
+ *
+ * @param options - Environment deletion options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @throws Error if deletion fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { deleteEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * await deleteEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'feature-test'
+ * }, auth);
+ *
+ * console.log('Environment deleted');
+ * ```
+ */
+export async function deleteEnv(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, slug, origin } = options;
+    logger.debug({ projectSlug, slug }, '[MRT] Deleting environment');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { error } = await client.DELETE('/api/projects/{project_slug}/target/{target_slug}/', {
+        params: {
+            path: { project_slug: projectSlug, target_slug: slug },
+        },
+    });
+    if (error) {
+        const errorMessage = typeof error === 'object' && error !== null && 'message' in error
+            ? String(error.message)
+            : JSON.stringify(error);
+        throw new Error(`Failed to delete environment: ${errorMessage}`);
+    }
+    logger.debug({ slug }, '[MRT] Environment deleted successfully');
+}
+/**
+ * Gets an environment (target) from an MRT project.
+ *
+ * @param options - Environment retrieval options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The environment object from the API
+ * @throws Error if retrieval fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { getEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const env = await getEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging'
+ * }, auth);
+ *
+ * console.log(`Environment state: ${env.state}`);
+ * ```
+ */
+export async function getEnv(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, slug, origin } = options;
+    logger.debug({ projectSlug, slug }, '[MRT] Getting environment');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { data, error } = await client.GET('/api/projects/{project_slug}/target/{target_slug}/', {
+        params: {
+            path: { project_slug: projectSlug, target_slug: slug },
+        },
+    });
+    if (error) {
+        const errorMessage = typeof error === 'object' && error !== null && 'message' in error
+            ? String(error.message)
+            : JSON.stringify(error);
+        throw new Error(`Failed to get environment: ${errorMessage}`);
+    }
+    logger.debug({ slug: data.slug, state: data.state }, '[MRT] Environment retrieved');
+    return data;
+}
+/**
+ * Terminal states for MRT environments (no longer changing).
+ */
+const TERMINAL_STATES = ['ACTIVE', 'CREATE_FAILED', 'PUBLISH_FAILED'];
+/**
+ * Waits for an environment to reach a terminal state (ACTIVE or failed).
+ *
+ * Polls the environment status until it reaches ACTIVE, CREATE_FAILED,
+ * or PUBLISH_FAILED state, or until the timeout is reached.
+ *
+ * @param options - Wait options including polling interval and timeout
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The environment in its terminal state
+ * @throws Error if timeout is reached or environment fails
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { createEnv, waitForEnv } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * // Create environment
+ * const env = await createEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging',
+ *   name: 'Staging'
+ * }, auth);
+ *
+ * // Wait for it to be ready
+ * const readyEnv = await waitForEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging',
+ *   timeout: 60000, // 1 minute
+ *   onPoll: (e) => console.log(`State: ${e.state}`)
+ * }, auth);
+ *
+ * if (readyEnv.state === 'ACTIVE') {
+ *   console.log('Environment is ready!');
+ * }
+ * ```
+ */
+export async function waitForEnv(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, slug, pollInterval = 10000, timeout = 2700000, onPoll, origin } = options;
+    logger.debug({ projectSlug, slug, pollInterval, timeout }, '[MRT] Waiting for environment');
+    const startTime = Date.now();
+    while (Date.now() - startTime < timeout) {
+        const env = await getEnv({ projectSlug, slug, origin }, auth);
+        if (onPoll) {
+            onPoll(env);
+        }
+        if (env.state && TERMINAL_STATES.includes(env.state)) {
+            if (env.state === 'CREATE_FAILED') {
+                throw new Error(`Environment creation failed`);
+            }
+            if (env.state === 'PUBLISH_FAILED') {
+                throw new Error(`Environment publish failed`);
+            }
+            logger.debug({ slug, state: env.state }, '[MRT] Environment reached terminal state');
+            return env;
+        }
+        logger.debug({ slug, state: env.state, elapsed: Date.now() - startTime }, '[MRT] Environment still in progress');
+        await new Promise((resolve) => setTimeout(resolve, pollInterval));
+    }
+    throw new Error(`Timeout waiting for environment "${slug}" to be ready after ${timeout}ms`);
+}
+//# sourceMappingURL=env.js.map

package/dist/esm/operations/mrt/env.js.map

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

package/dist/esm/operations/mrt/index.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Managed Runtime (MRT) operations.
+ *
+ * This module provides functions for managing bundles and deployments
+ * on Salesforce Managed Runtime.
+ *
+ * ## Bundle Operations
+ *
+ * - {@link createBundle} - Create a bundle from a build directory
+ * - {@link pushBundle} - Push a bundle to MRT (creates and uploads)
+ * - {@link uploadBundle} - Upload a pre-created bundle
+ * - {@link listBundles} - List bundles for a project
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { pushBundle } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * // Push and deploy a bundle
+ * const result = await pushBundle({
+ *   projectSlug: 'my-storefront',
+ *   ssrOnly: ['ssr.js'],
+ *   ssrShared: ['**\/*.js', 'static/**\/*'],
+ *   buildDirectory: './build',
+ *   message: 'Release v1.0.0',
+ *   target: 'staging'
+ * }, auth);
+ *
+ * console.log(`Bundle ${result.bundleId} deployed to ${result.target}`);
+ * ```
+ *
+ * ## Authentication
+ *
+ * MRT operations use API key authentication. Get your API key from the
+ * [Runtime Admin](https://runtime.commercecloud.com/) dashboard.
+ *
+ * @module operations/mrt
+ */
+export { createBundle, createGlobFilter, getDefaultMessage, DEFAULT_SSR_PARAMETERS } from './bundle.js';
+export type { CreateBundleOptions, Bundle } from './bundle.js';
+export { pushBundle, uploadBundle, listBundles } from './push.js';
+export type { PushOptions, PushResult } from './push.js';
+export { listEnvVars, setEnvVar, setEnvVars, deleteEnvVar } from './env-var.js';
+export type { EnvVarOptions, SetEnvVarOptions, SetEnvVarsOptions, DeleteEnvVarOptions, ListEnvVarsResult, EnvironmentVariable, } from './env-var.js';
+export { createEnv, deleteEnv, getEnv, waitForEnv } from './env.js';
+export type { CreateEnvOptions, DeleteEnvOptions, GetEnvOptions, WaitForEnvOptions, MrtEnvironment, MrtEnvironmentState, } from './env.js';

package/dist/esm/operations/mrt/index.js

@@ -0,0 +1,55 @@
+/*
+ * 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
+ */
+/**
+ * Managed Runtime (MRT) operations.
+ *
+ * This module provides functions for managing bundles and deployments
+ * on Salesforce Managed Runtime.
+ *
+ * ## Bundle Operations
+ *
+ * - {@link createBundle} - Create a bundle from a build directory
+ * - {@link pushBundle} - Push a bundle to MRT (creates and uploads)
+ * - {@link uploadBundle} - Upload a pre-created bundle
+ * - {@link listBundles} - List bundles for a project
+ *
+ * ## Usage
+ *
+ * ```typescript
+ * import { pushBundle } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * // Push and deploy a bundle
+ * const result = await pushBundle({
+ *   projectSlug: 'my-storefront',
+ *   ssrOnly: ['ssr.js'],
+ *   ssrShared: ['**\/*.js', 'static/**\/*'],
+ *   buildDirectory: './build',
+ *   message: 'Release v1.0.0',
+ *   target: 'staging'
+ * }, auth);
+ *
+ * console.log(`Bundle ${result.bundleId} deployed to ${result.target}`);
+ * ```
+ *
+ * ## Authentication
+ *
+ * MRT operations use API key authentication. Get your API key from the
+ * [Runtime Admin](https://runtime.commercecloud.com/) dashboard.
+ *
+ * @module operations/mrt
+ */
+// Bundle creation
+export { createBundle, createGlobFilter, getDefaultMessage, DEFAULT_SSR_PARAMETERS } from './bundle.js';
+// Push operations
+export { pushBundle, uploadBundle, listBundles } from './push.js';
+// Environment variable operations
+export { listEnvVars, setEnvVar, setEnvVars, deleteEnvVar } from './env-var.js';
+// Environment (target) operations
+export { createEnv, deleteEnv, getEnv, waitForEnv } from './env.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/operations/mrt/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/mrt/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAEH,kBAAkB;AAClB,OAAO,EAAC,YAAY,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,sBAAsB,EAAC,MAAM,aAAa,CAAC;AAGtG,kBAAkB;AAClB,OAAO,EAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAC,MAAM,WAAW,CAAC;AAGhE,kCAAkC;AAClC,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,UAAU,EAAE,YAAY,EAAC,MAAM,cAAc,CAAC;AAU9E,kCAAkC;AAClC,OAAO,EAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,EAAC,MAAM,UAAU,CAAC"}