@salesforce/b2c-tooling-sdk 1.8.0 → 1.9.0

package/dist/esm/operations/debug/debug-session.js

@@ -50,14 +50,29 @@ export class DebugSessionManager {
         }
         await this.client.createClient();
         this.connected = true;
-        // Start keepalive timer
-        const keepaliveInterval = this.config.keepaliveInterval ?? DEFAULT_KEEPALIVE_INTERVAL;
-        this.keepaliveTimer = setInterval(() => void this.keepalive(), keepaliveInterval);
-        // Start thread poller
-        const pollInterval = this.config.pollInterval ?? DEFAULT_POLL_INTERVAL;
-        this.pollTimer = setInterval(() => void this.pollThreads(), pollInterval);
-        this.logger.debug('Script debugger connected');
-        this.callbacks.onConnected?.(this.config.hostname);
+        try {
+            // Start keepalive timer
+            const keepaliveInterval = this.config.keepaliveInterval ?? DEFAULT_KEEPALIVE_INTERVAL;
+            this.keepaliveTimer = setInterval(() => void this.keepalive(), keepaliveInterval);
+            // Start thread poller
+            const pollInterval = this.config.pollInterval ?? DEFAULT_POLL_INTERVAL;
+            this.pollTimer = setInterval(() => void this.pollThreads(), pollInterval);
+            this.logger.debug('Script debugger connected');
+            this.callbacks.onConnected?.(this.config.hostname);
+        }
+        catch (err) {
+            // Ensure timers are cleared if anything (incl. onConnected callback) throws
+            // after we started them; otherwise we'd leak intervals.
+            this.stopTimers();
+            this.connected = false;
+            try {
+                await this.client.deleteClient();
+            }
+            catch (deleteErr) {
+                this.logger.debug({ err: deleteErr }, 'Failed to clean up debugger client after connect error');
+            }
+            throw err;
+        }
     }
     /**
      * Disconnect: stop timers, delete client.

package/dist/esm/operations/debug/debug-session.js.map

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

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

@@ -13,5 +13,8 @@ export { B2CScriptDebugAdapter } from './dap-adapter.js';
 export { createSourceMapper } from './source-mapping.js';
 export type { SourceMapper } from './source-mapping.js';
 export { VariableStore } from './variable-store.js';
+export { resolveBreakpointPath } from './resolve-path.js';
+export { DEFAULT_MAX_VALUE_LENGTH, isPrimitiveType, projectBreakpoint, projectFrame, projectThreadLocation, projectVariable, truncateValue, } from './projections.js';
+export type { MappedBreakpoint, MappedFrame, MappedLocation, MappedVariable } from './projections.js';
 export type { VariableRef } from './variable-store.js';
 export type { SdapiLocation, SdapiStackFrame, SdapiScriptThread, SdapiBreakpoint, SdapiBreakpoints, SdapiObjectMember, SdapiObjectMembers, SdapiEvalResult, SdapiFault, BreakpointInput, DebugSessionConfig, DebugSessionCallbacks, } from './types.js';

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

@@ -16,4 +16,6 @@ export { DebugSessionManager } from './debug-session.js';
 export { B2CScriptDebugAdapter } from './dap-adapter.js';
 export { createSourceMapper } from './source-mapping.js';
 export { VariableStore } from './variable-store.js';
+export { resolveBreakpointPath } from './resolve-path.js';
+export { DEFAULT_MAX_VALUE_LENGTH, isPrimitiveType, projectBreakpoint, projectFrame, projectThreadLocation, projectVariable, truncateValue, } from './projections.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;GAOG;AACH,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAC,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/debug/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;;;;GAOG;AACH,OAAO,EAAC,WAAW,EAAE,UAAU,EAAE,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAE7E,OAAO,EAAC,mBAAmB,EAAC,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAC,qBAAqB,EAAC,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAC,kBAAkB,EAAC,MAAM,qBAAqB,CAAC;AAEvD,OAAO,EAAC,aAAa,EAAC,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAC,qBAAqB,EAAC,MAAM,mBAAmB,CAAC;AACxD,OAAO,EACL,wBAAwB,EACxB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,qBAAqB,EACrB,eAAe,EACf,aAAa,GACd,MAAM,kBAAkB,CAAC"}

package/dist/esm/operations/debug/projections.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Shared projections that map SDAPI response types to JSON-friendly objects
+ * with both server paths and resolved local file paths. Used by both the MCP
+ * debugger tools and the CLI RPC mode.
+ *
+ * @module operations/debug/projections
+ */
+import type { SourceMapper } from './source-mapping.js';
+import type { SdapiBreakpoint, SdapiObjectMember, SdapiScriptThread, SdapiStackFrame } from './types.js';
+/** Default maximum length for variable values before truncation. */
+export declare const DEFAULT_MAX_VALUE_LENGTH = 200;
+/** A mapped source location with both server and local file paths. */
+export interface MappedLocation {
+    file: null | string;
+    function_name: string;
+    line: number;
+    script_path: string;
+}
+/** A mapped stack frame. */
+export interface MappedFrame {
+    file: null | string;
+    function_name: string;
+    index: number;
+    line: number;
+    script_path: string;
+}
+/** A mapped variable for inspection. */
+export interface MappedVariable {
+    has_children: boolean;
+    name: string;
+    scope?: string;
+    type: string;
+    value: string;
+}
+/** A mapped breakpoint. */
+export interface MappedBreakpoint {
+    condition?: string;
+    file: null | string;
+    id: number;
+    line: number;
+    script_path: string;
+}
+/** True when the SDAPI type name represents a non-expandable primitive value. */
+export declare function isPrimitiveType(type: string): boolean;
+/**
+ * Truncate a string to at most `max` characters, appending `...` if truncated.
+ */
+export declare function truncateValue(value: string, max?: number): string;
+/**
+ * Project an SDAPI stack frame to a structured object with mapped local file path.
+ */
+export declare function projectFrame(frame: SdapiStackFrame, mapper: SourceMapper): MappedFrame;
+/**
+ * Project an SDAPI object member to a structured variable.
+ *
+ * @param member - The SDAPI object member
+ * @param options.includeScope - Whether to include the scope field (defaults to true)
+ * @param options.maxValueLength - Maximum value length before truncation
+ */
+export declare function projectVariable(member: SdapiObjectMember, options?: {
+    includeScope?: boolean;
+    maxValueLength?: number;
+}): MappedVariable;
+/**
+ * Project an SDAPI breakpoint to a structured object with mapped local file path.
+ */
+export declare function projectBreakpoint(bp: SdapiBreakpoint, mapper: SourceMapper): MappedBreakpoint;
+/**
+ * Project the top-of-stack location for a thread, mapping the script path.
+ * Returns null if the thread has no call stack.
+ */
+export declare function projectThreadLocation(thread: SdapiScriptThread, mapper: SourceMapper): MappedLocation | null;

package/dist/esm/operations/debug/projections.js

@@ -0,0 +1,84 @@
+/*
+ * 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
+ */
+/** Default maximum length for variable values before truncation. */
+export const DEFAULT_MAX_VALUE_LENGTH = 200;
+/**
+ * SDAPI primitive type names. Variables of these types are not expandable
+ * (no children to drill into).
+ */
+const PRIMITIVE_TYPES = new Set(['boolean', 'Boolean', 'null', 'number', 'Number', 'string', 'String', 'undefined']);
+/** True when the SDAPI type name represents a non-expandable primitive value. */
+export function isPrimitiveType(type) {
+    return PRIMITIVE_TYPES.has(type);
+}
+/**
+ * Truncate a string to at most `max` characters, appending `...` if truncated.
+ */
+export function truncateValue(value, max = DEFAULT_MAX_VALUE_LENGTH) {
+    if (value.length <= max)
+        return value;
+    return value.slice(0, max) + '...';
+}
+/**
+ * Project an SDAPI stack frame to a structured object with mapped local file path.
+ */
+export function projectFrame(frame, mapper) {
+    return {
+        file: mapper.toLocalPath(frame.location.script_path) ?? null,
+        function_name: frame.location.function_name,
+        index: frame.index,
+        line: frame.location.line_number,
+        script_path: frame.location.script_path,
+    };
+}
+/**
+ * Project an SDAPI object member to a structured variable.
+ *
+ * @param member - The SDAPI object member
+ * @param options.includeScope - Whether to include the scope field (defaults to true)
+ * @param options.maxValueLength - Maximum value length before truncation
+ */
+export function projectVariable(member, options = {}) {
+    const { includeScope = true, maxValueLength = DEFAULT_MAX_VALUE_LENGTH } = options;
+    const result = {
+        has_children: !isPrimitiveType(member.type),
+        name: member.name,
+        type: member.type,
+        value: truncateValue(member.value, maxValueLength),
+    };
+    if (includeScope)
+        result.scope = member.scope;
+    return result;
+}
+/**
+ * Project an SDAPI breakpoint to a structured object with mapped local file path.
+ */
+export function projectBreakpoint(bp, mapper) {
+    return {
+        condition: bp.condition,
+        file: mapper.toLocalPath(bp.script_path) ?? null,
+        id: bp.id,
+        line: bp.line_number,
+        script_path: bp.script_path,
+    };
+}
+/**
+ * Project the top-of-stack location for a thread, mapping the script path.
+ * Returns null if the thread has no call stack.
+ */
+export function projectThreadLocation(thread, mapper) {
+    const topFrame = thread.call_stack?.[0];
+    if (!topFrame)
+        return null;
+    const loc = topFrame.location;
+    return {
+        file: mapper.toLocalPath(loc.script_path) ?? null,
+        function_name: loc.function_name,
+        line: loc.line_number,
+        script_path: loc.script_path,
+    };
+}
+//# sourceMappingURL=projections.js.map

package/dist/esm/operations/debug/projections.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"projections.js","sourceRoot":"","sources":["../../../../src/operations/debug/projections.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,oEAAoE;AACpE,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAE5C;;;GAGG;AACH,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC;AAqCrH,iFAAiF;AACjF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,aAAa,CAAC,KAAa,EAAE,MAAc,wBAAwB;IACjF,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,KAAK,CAAC;IACtC,OAAO,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,YAAY,CAAC,KAAsB,EAAE,MAAoB;IACvE,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI;QAC5D,aAAa,EAAE,KAAK,CAAC,QAAQ,CAAC,aAAa;QAC3C,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,IAAI,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;QAChC,WAAW,EAAE,KAAK,CAAC,QAAQ,CAAC,WAAW;KACxC,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAC7B,MAAyB,EACzB,UAA6D,EAAE;IAE/D,MAAM,EAAC,YAAY,GAAG,IAAI,EAAE,cAAc,GAAG,wBAAwB,EAAC,GAAG,OAAO,CAAC;IACjF,MAAM,MAAM,GAAmB;QAC7B,YAAY,EAAE,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC;QAC3C,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,KAAK,EAAE,aAAa,CAAC,MAAM,CAAC,KAAK,EAAE,cAAc,CAAC;KACnD,CAAC;IACF,IAAI,YAAY;QAAE,MAAM,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,iBAAiB,CAAC,EAAmB,EAAE,MAAoB;IACzE,OAAO;QACL,SAAS,EAAE,EAAE,CAAC,SAAS;QACvB,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,WAAW,CAAC,IAAI,IAAI;QAChD,EAAE,EAAE,EAAE,CAAC,EAAE;QACT,IAAI,EAAE,EAAE,CAAC,WAAW;QACpB,WAAW,EAAE,EAAE,CAAC,WAAW;KAC5B,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAAyB,EAAE,MAAoB;IACnF,MAAM,QAAQ,GAAG,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC;IAC3B,MAAM,GAAG,GAAG,QAAQ,CAAC,QAAQ,CAAC;IAC9B,OAAO;QACL,IAAI,EAAE,MAAM,CAAC,WAAW,CAAC,GAAG,CAAC,WAAW,CAAC,IAAI,IAAI;QACjD,aAAa,EAAE,GAAG,CAAC,aAAa;QAChC,IAAI,EAAE,GAAG,CAAC,WAAW;QACrB,WAAW,EAAE,GAAG,CAAC,WAAW;KAC7B,CAAC;AACJ,CAAC"}

package/dist/esm/operations/debug/resolve-path.d.ts

@@ -0,0 +1,15 @@
+import type { SourceMapper } from './source-mapping.js';
+import type { CartridgeMapping } from '../code/cartridges.js';
+/**
+ * Resolve a user-provided file path to an SDAPI script_path.
+ *
+ * Accepts:
+ *   - Absolute local path: `/Users/.../app_storefront/cartridge/controllers/Cart.js`
+ *   - Relative local path: `./cartridges/app_storefront/cartridge/controllers/Cart.js`
+ *   - Server path: `/app_storefront/cartridge/controllers/Cart.js` (passed through if not a local match)
+ *   - Cartridge-name-prefixed: `app_storefront/cartridge/controllers/Cart.js` (prefixed with /)
+ *
+ * Returns the SDAPI script_path (e.g. `/app_storefront/cartridge/controllers/Cart.js`).
+ * Throws with a helpful message if the path cannot be resolved.
+ */
+export declare function resolveBreakpointPath(input: string, sourceMapper: SourceMapper, cartridges: CartridgeMapping[]): string;

package/dist/esm/operations/debug/resolve-path.js

@@ -0,0 +1,52 @@
+/*
+ * 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
+ */
+import path from 'node:path';
+/**
+ * Resolve a user-provided file path to an SDAPI script_path.
+ *
+ * Accepts:
+ *   - Absolute local path: `/Users/.../app_storefront/cartridge/controllers/Cart.js`
+ *   - Relative local path: `./cartridges/app_storefront/cartridge/controllers/Cart.js`
+ *   - Server path: `/app_storefront/cartridge/controllers/Cart.js` (passed through if not a local match)
+ *   - Cartridge-name-prefixed: `app_storefront/cartridge/controllers/Cart.js` (prefixed with /)
+ *
+ * Returns the SDAPI script_path (e.g. `/app_storefront/cartridge/controllers/Cart.js`).
+ * Throws with a helpful message if the path cannot be resolved.
+ */
+export function resolveBreakpointPath(input, sourceMapper, cartridges) {
+    // Always try source mapper first — handles both absolute and relative local paths
+    const mapped = sourceMapper.toServerPath(input);
+    if (mapped)
+        return mapped;
+    // Try resolving relative to cwd (for paths like ./cartridges/app_mysite/...)
+    const resolved = path.resolve(input);
+    if (resolved !== input) {
+        const mappedResolved = sourceMapper.toServerPath(resolved);
+        if (mappedResolved)
+            return mappedResolved;
+    }
+    // If it starts with / and the source mapper didn't match, treat as server path
+    if (input.startsWith('/')) {
+        return input;
+    }
+    // Check if the input starts with a known cartridge name — treat as server path missing leading /
+    const normalized = input.split(path.sep).join('/');
+    const firstSegment = normalized.split('/')[0];
+    if (cartridges.some((c) => c.name === firstSegment)) {
+        return `/${normalized}`;
+    }
+    const cartridgeNames = cartridges.map((c) => c.name).join(', ');
+    const hint = cartridges.length > 0
+        ? `Known cartridges: ${cartridgeNames}\n` +
+            `Accepted forms:\n` +
+            `  /cartridge_name/cartridge/path/to/file.js  (server path)\n` +
+            `  cartridge_name/cartridge/path/to/file.js    (server path without leading /)\n` +
+            `  ./path/to/cartridge_name/cartridge/file.js  (relative local path)\n` +
+            `  /absolute/path/to/cartridge_name/file.js    (absolute local path)`
+        : 'No cartridges discovered. Use a server path: /cartridge_name/cartridge/path/file.js';
+    throw new Error(`Cannot resolve "${input}" to a server script path.\n${hint}`);
+}
+//# sourceMappingURL=resolve-path.js.map

package/dist/esm/operations/debug/resolve-path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolve-path.js","sourceRoot":"","sources":["../../../../src/operations/debug/resolve-path.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,WAAW,CAAC;AAI7B;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,qBAAqB,CACnC,KAAa,EACb,YAA0B,EAC1B,UAA8B;IAE9B,kFAAkF;IAClF,MAAM,MAAM,GAAG,YAAY,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC;IAChD,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC;IAE1B,6EAA6E;IAC7E,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACrC,IAAI,QAAQ,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,cAAc,GAAG,YAAY,CAAC,YAAY,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,cAAc;YAAE,OAAO,cAAc,CAAC;IAC5C,CAAC;IAED,+EAA+E;IAC/E,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,iGAAiG;IACjG,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACnD,MAAM,YAAY,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,YAAY,CAAC,EAAE,CAAC;QACpD,OAAO,IAAI,UAAU,EAAE,CAAC;IAC1B,CAAC;IAED,MAAM,cAAc,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAChE,MAAM,IAAI,GACR,UAAU,CAAC,MAAM,GAAG,CAAC;QACnB,CAAC,CAAC,qBAAqB,cAAc,IAAI;YACvC,mBAAmB;YACnB,8DAA8D;YAC9D,iFAAiF;YACjF,uEAAuE;YACvE,qEAAqE;QACvE,CAAC,CAAC,qFAAqF,CAAC;IAE5F,MAAM,IAAI,KAAK,CAAC,mBAAmB,KAAK,+BAA+B,IAAI,EAAE,CAAC,CAAC;AACjF,CAAC"}

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

@@ -0,0 +1,60 @@
+/**
+ * Custom domain certificate operations for Managed Runtime.
+ *
+ * Certificates are organization-scoped and can be associated with environments
+ * via the `certificate_id` field on target create/update/clone operations.
+ *
+ * @module operations/mrt/certificate
+ */
+import type { AuthStrategy } from '../../auth/types.js';
+import type { components } from '../../clients/mrt.js';
+export type MrtCertificate = components['schemas']['CertificateBase'];
+export type MrtCertificateListCreate = components['schemas']['CertificateListCreate'];
+export interface ListCertificatesOptions {
+    organizationSlug: string;
+    limit?: number;
+    offset?: number;
+    ordering?: string;
+    search?: string;
+    /** When true, return only customer-managed certificates. */
+    customOnly?: boolean;
+    origin?: string;
+}
+export interface ListCertificatesResult {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    certificates: MrtCertificateListCreate[];
+}
+export declare function listCertificates(options: ListCertificatesOptions, auth: AuthStrategy): Promise<ListCertificatesResult>;
+export interface GetCertificateOptions {
+    organizationSlug: string;
+    certId: number;
+    origin?: string;
+}
+export declare function getCertificate(options: GetCertificateOptions, auth: AuthStrategy): Promise<MrtCertificate>;
+export interface CreateCertificateOptions {
+    organizationSlug: string;
+    /**
+     * The domain for the certificate (e.g. shop.example.com).
+     */
+    domainName: string;
+    origin?: string;
+}
+export declare function createCertificate(options: CreateCertificateOptions, auth: AuthStrategy): Promise<MrtCertificateListCreate>;
+export interface DeleteCertificateOptions {
+    organizationSlug: string;
+    certId: number;
+    origin?: string;
+}
+export declare function deleteCertificate(options: DeleteCertificateOptions, auth: AuthStrategy): Promise<void>;
+export interface RestartCertificateValidationOptions {
+    organizationSlug: string;
+    certId: number;
+    origin?: string;
+}
+/**
+ * Restarts validation for a certificate. Only works for certificates that have
+ * not yet been validated.
+ */
+export declare function restartCertificateValidation(options: RestartCertificateValidationOptions, auth: AuthStrategy): Promise<MrtCertificate>;

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

@@ -0,0 +1,76 @@
+import { createMrtClient, DEFAULT_MRT_ORIGIN } from '../../clients/mrt.js';
+import { getLogger } from '../../logging/logger.js';
+function describeError(error, action) {
+    const message = typeof error === 'object' && error !== null && 'message' in error
+        ? String(error.message)
+        : JSON.stringify(error);
+    return new Error(`Failed to ${action}: ${message}`);
+}
+export async function listCertificates(options, auth) {
+    const logger = getLogger();
+    const { organizationSlug, limit, offset, ordering, search, customOnly, origin } = options;
+    logger.debug({ organizationSlug }, '[MRT] Listing certificates');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { data, error } = await client.GET('/api/organizations/{organization_slug}/certificates/', {
+        params: {
+            path: { organization_slug: organizationSlug },
+            query: { limit, offset, ordering, search, custom_only: customOnly },
+        },
+    });
+    if (error)
+        throw describeError(error, 'list certificates');
+    return {
+        count: data.count ?? 0,
+        next: data.next ?? null,
+        previous: data.previous ?? null,
+        certificates: data.results ?? [],
+    };
+}
+export async function getCertificate(options, auth) {
+    const { organizationSlug, certId, origin } = options;
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { data, error } = await client.GET('/api/organizations/{organization_slug}/certificates/{cert_id}/', {
+        params: { path: { organization_slug: organizationSlug, cert_id: String(certId) } },
+    });
+    if (error)
+        throw describeError(error, 'get certificate');
+    return data;
+}
+export async function createCertificate(options, auth) {
+    const logger = getLogger();
+    const { organizationSlug, domainName, origin } = options;
+    logger.debug({ organizationSlug, domainName }, '[MRT] Creating certificate');
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { data, error } = await client.POST('/api/organizations/{organization_slug}/certificates/', {
+        params: { path: { organization_slug: organizationSlug } },
+        body: { domain_name: domainName },
+    });
+    if (error)
+        throw describeError(error, 'create certificate');
+    return data;
+}
+export async function deleteCertificate(options, auth) {
+    const { organizationSlug, certId, origin } = options;
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { error } = await client.DELETE('/api/organizations/{organization_slug}/certificates/{cert_id}/', {
+        params: { path: { organization_slug: organizationSlug, cert_id: String(certId) } },
+    });
+    if (error)
+        throw describeError(error, 'delete certificate');
+}
+/**
+ * Restarts validation for a certificate. Only works for certificates that have
+ * not yet been validated.
+ */
+export async function restartCertificateValidation(options, auth) {
+    const { organizationSlug, certId, origin } = options;
+    const client = createMrtClient({ origin: origin || DEFAULT_MRT_ORIGIN }, auth);
+    const { data, error } = await client.PATCH('/api/organizations/{organization_slug}/certificates/{cert_id}/restart-validation/', {
+        params: { path: { organization_slug: organizationSlug, cert_id: String(certId) } },
+        body: {},
+    });
+    if (error)
+        throw describeError(error, 'restart certificate validation');
+    return data;
+}
+//# sourceMappingURL=certificate.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"certificate.js","sourceRoot":"","sources":["../../../../src/operations/mrt/certificate.ts"],"names":[],"mappings":"AAcA,OAAO,EAAC,eAAe,EAAE,kBAAkB,EAAC,MAAM,sBAAsB,CAAC;AAEzE,OAAO,EAAC,SAAS,EAAC,MAAM,yBAAyB,CAAC;AAKlD,SAAS,aAAa,CAAC,KAAc,EAAE,MAAc;IACnD,MAAM,OAAO,GACX,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,SAAS,IAAI,KAAK;QAC/D,CAAC,CAAC,MAAM,CAAE,KAA4B,CAAC,OAAO,CAAC;QAC/C,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IAC5B,OAAO,IAAI,KAAK,CAAC,aAAa,MAAM,KAAK,OAAO,EAAE,CAAC,CAAC;AACtD,CAAC;AAoBD,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,OAAgC,EAChC,IAAkB;IAElB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAC,gBAAgB,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IAExF,MAAM,CAAC,KAAK,CAAC,EAAC,gBAAgB,EAAC,EAAE,4BAA4B,CAAC,CAAC;IAE/D,MAAM,MAAM,GAAG,eAAe,CAAC,EAAC,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAC,EAAE,IAAI,CAAC,CAAC;IAE7E,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,sDAAsD,EAAE;QAC7F,MAAM,EAAE;YACN,IAAI,EAAE,EAAC,iBAAiB,EAAE,gBAAgB,EAAC;YAC3C,KAAK,EAAE,EAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,UAAU,EAAC;SAClE;KACF,CAAC,CAAC;IAEH,IAAI,KAAK;QAAE,MAAM,aAAa,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;IAE3D,OAAO;QACL,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,CAAC;QACtB,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI;QACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,IAAI;QAC/B,YAAY,EAAE,IAAI,CAAC,OAAO,IAAI,EAAE;KACjC,CAAC;AACJ,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAA8B,EAAE,IAAkB;IACrF,MAAM,EAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IACnD,MAAM,MAAM,GAAG,eAAe,CAAC,EAAC,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAC,EAAE,IAAI,CAAC,CAAC;IAE7E,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,MAAM,CAAC,GAAG,CAAC,gEAAgE,EAAE;QACvG,MAAM,EAAE,EAAC,IAAI,EAAE,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAC,EAAC;KAC/E,CAAC,CAAC;IAEH,IAAI,KAAK;QAAE,MAAM,aAAa,CAAC,KAAK,EAAE,iBAAiB,CAAC,CAAC;IAEzD,OAAO,IAAI,CAAC;AACd,CAAC;AAWD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CACrC,OAAiC,EACjC,IAAkB;IAElB,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,EAAC,gBAAgB,EAAE,UAAU,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IAEvD,MAAM,CAAC,KAAK,CAAC,EAAC,gBAAgB,EAAE,UAAU,EAAC,EAAE,4BAA4B,CAAC,CAAC;IAE3E,MAAM,MAAM,GAAG,eAAe,CAAC,EAAC,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAC,EAAE,IAAI,CAAC,CAAC;IAE7E,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,sDAAsD,EAAE;QAC9F,MAAM,EAAE,EAAC,IAAI,EAAE,EAAC,iBAAiB,EAAE,gBAAgB,EAAC,EAAC;QACrD,IAAI,EAAE,EAAC,WAAW,EAAE,UAAU,EAAC;KAChC,CAAC,CAAC;IAEH,IAAI,KAAK;QAAE,MAAM,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;IAE5D,OAAO,IAAI,CAAC;AACd,CAAC;AAQD,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,OAAiC,EAAE,IAAkB;IAC3F,MAAM,EAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IACnD,MAAM,MAAM,GAAG,eAAe,CAAC,EAAC,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAC,EAAE,IAAI,CAAC,CAAC;IAE7E,MAAM,EAAC,KAAK,EAAC,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,gEAAgE,EAAE;QACpG,MAAM,EAAE,EAAC,IAAI,EAAE,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAC,EAAC;KAC/E,CAAC,CAAC;IAEH,IAAI,KAAK;QAAE,MAAM,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,CAAC;AAC9D,CAAC;AAQD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,4BAA4B,CAChD,OAA4C,EAC5C,IAAkB;IAElB,MAAM,EAAC,gBAAgB,EAAE,MAAM,EAAE,MAAM,EAAC,GAAG,OAAO,CAAC;IACnD,MAAM,MAAM,GAAG,eAAe,CAAC,EAAC,MAAM,EAAE,MAAM,IAAI,kBAAkB,EAAC,EAAE,IAAI,CAAC,CAAC;IAE7E,MAAM,EAAC,IAAI,EAAE,KAAK,EAAC,GAAG,MAAM,MAAM,CAAC,KAAK,CACtC,mFAAmF,EACnF;QACE,MAAM,EAAE,EAAC,IAAI,EAAE,EAAC,iBAAiB,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC,EAAC,EAAC;QAC9E,IAAI,EAAE,EAAE;KACT,CACF,CAAC;IAEF,IAAI,KAAK;QAAE,MAAM,aAAa,CAAC,KAAK,EAAE,gCAAgC,CAAC,CAAC;IAExE,OAAO,IAAI,CAAC;AACd,CAAC"}

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

@@ -228,6 +228,10 @@ export interface WaitForEnvOptions extends GetEnvOptions {
      * Custom sleep function for testing.
      */
     sleep?: (ms: number) => Promise<void>;
+    /**
+     * Custom clock for testing. Defaults to Date.now.
+     */
+    now?: () => number;
 }
 /**
  * Waits for an environment to reach a terminal state (ACTIVE or failed).
@@ -272,6 +276,81 @@ export declare function waitForEnv(options: WaitForEnvOptions, auth: AuthStrateg
  * MRT environment type for updates.
  */
 export type MrtEnvironmentUpdate = components['schemas']['APITargetV2Update'];
+/**
+ * Options for cloning an MRT environment.
+ */
+export interface CloneEnvOptions {
+    /**
+     * The project slug containing the source and new environment.
+     */
+    projectSlug: string;
+    /**
+     * Slug for the new environment created by the clone.
+     */
+    slug: string;
+    /**
+     * Slug of the source environment to clone from.
+     */
+    fromSlug: string;
+    /**
+     * Full external hostname (e.g., www.example.com).
+     * Required when not using an MRT-managed certificate.
+     */
+    externalHostname?: string | null;
+    /**
+     * External domain for Universal PWA SSR (e.g., example.com).
+     */
+    externalDomain?: string | null;
+    /**
+     * ID of the certificate to associate with the new environment.
+     * Required when using a custom domain.
+     */
+    certificateId?: number | null;
+    /**
+     * Clone redirects from the source environment.
+     * @default false
+     */
+    cloneRedirects?: boolean;
+    /**
+     * Clone environment variables from the source environment.
+     * @default false
+     */
+    cloneEnvironmentVariables?: boolean;
+    /**
+     * Clone B2C target info from the source environment.
+     * @default false
+     */
+    cloneB2cTargetInfo?: boolean;
+    /**
+     * MRT API origin URL.
+     * @default "https://cloud.mobify.com"
+     */
+    origin?: string;
+}
+/**
+ * Clones an environment (target) from an existing source environment.
+ *
+ * The new environment receives the source's configuration (excluding proxies and
+ * production flag) and is automatically deployed with the same bundle as the
+ * source target's current deployment (if any).
+ *
+ * @param options - Clone options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The newly created environment
+ * @throws Error if the clone fails
+ *
+ * @example
+ * ```typescript
+ * const env = await cloneEnv({
+ *   projectSlug: 'my-storefront',
+ *   slug: 'staging-copy',
+ *   fromSlug: 'staging',
+ *   cloneRedirects: true,
+ *   cloneEnvironmentVariables: true
+ * }, auth);
+ * ```
+ */
+export declare function cloneEnv(options: CloneEnvOptions, auth: AuthStrategy): Promise<MrtEnvironment>;
 /**
  * Patched environment for partial updates.
  */