@salesforce/b2c-tooling-sdk 1.9.0 → 1.11.0

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

@@ -1,234 +0,0 @@
-/*
- * 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
- */
-/**
- * Debug session manager for the SDAPI.
- *
- * Manages the debugger lifecycle, polls for halted threads, and sends periodic
- * keepalive resets to prevent the 60-second halt timeout. State changes are
- * communicated via callbacks.
- *
- * @module operations/debug/debug-session
- */
-import { getLogger } from '../../logging/logger.js';
-import { SdapiClient, SdapiError } from './sdapi-client.js';
-const DEFAULT_POLL_INTERVAL = 500;
-const DEFAULT_KEEPALIVE_INTERVAL = 15_000;
-export class DebugSessionManager {
-    client;
-    config;
-    callbacks;
-    logger = getLogger();
-    pollTimer;
-    keepaliveTimer;
-    /** Last known thread states keyed by thread id */
-    knownThreads = new Map();
-    connected = false;
-    constructor(config, callbacks = {}) {
-        this.config = config;
-        this.callbacks = callbacks;
-        this.client = new SdapiClient({
-            hostname: config.hostname,
-            username: config.username,
-            password: config.password,
-            clientId: config.clientId,
-        });
-    }
-    /**
-     * Connect to the debugger: enable the client, start polling and keepalive.
-     */
-    async connect() {
-        this.logger.debug({ hostname: this.config.hostname }, 'Connecting to script debugger');
-        // Take over any existing session (same pattern as Python reference)
-        try {
-            await this.client.deleteClient();
-        }
-        catch {
-            // Ignore — client may not exist yet
-        }
-        await this.client.createClient();
-        this.connected = true;
-        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.
-     */
-    async disconnect() {
-        this.stopTimers();
-        if (this.connected) {
-            try {
-                await this.client.deleteClient();
-            }
-            catch (error) {
-                this.logger.warn({ error }, 'Error deleting debugger client during disconnect');
-            }
-            this.connected = false;
-        }
-        this.knownThreads.clear();
-        this.logger.debug('Script debugger disconnected');
-        this.callbacks.onDisconnected?.();
-    }
-    /**
-     * Set breakpoints (replaces all current breakpoints).
-     */
-    async setBreakpoints(breakpoints) {
-        await this.client.deleteBreakpoints();
-        if (breakpoints.length === 0)
-            return [];
-        return this.client.setBreakpoints(breakpoints);
-    }
-    /**
-     * Resume a halted thread.
-     */
-    async resume(threadId) {
-        await this.client.resume(threadId);
-    }
-    /**
-     * Step over (next line).
-     */
-    async stepOver(threadId) {
-        await this.client.stepOver(threadId);
-    }
-    /**
-     * Step into function.
-     */
-    async stepInto(threadId) {
-        await this.client.stepInto(threadId);
-    }
-    /**
-     * Step out of function.
-     */
-    async stepOut(threadId) {
-        await this.client.stepOut(threadId);
-    }
-    /**
-     * Get the current list of known threads (from last poll).
-     */
-    getKnownThreads() {
-        return [...this.knownThreads.values()];
-    }
-    // -----------------------------------------------------------------------
-    // Internal
-    // -----------------------------------------------------------------------
-    stopTimers() {
-        if (this.pollTimer) {
-            clearInterval(this.pollTimer);
-            this.pollTimer = undefined;
-        }
-        if (this.keepaliveTimer) {
-            clearInterval(this.keepaliveTimer);
-            this.keepaliveTimer = undefined;
-        }
-    }
-    async keepalive() {
-        try {
-            await this.client.resetThreads();
-        }
-        catch (error) {
-            this.logger.debug({ error }, 'Keepalive reset failed');
-        }
-    }
-    haltLocationChanged(prev, curr) {
-        const prevLoc = prev.call_stack?.[0]?.location;
-        const currLoc = curr.call_stack?.[0]?.location;
-        if (!prevLoc || !currLoc)
-            return prevLoc !== currLoc;
-        return prevLoc.script_path !== currLoc.script_path || prevLoc.line_number !== currLoc.line_number;
-    }
-    logThreadHalted(thread) {
-        const topFrame = thread.call_stack?.[0];
-        if (topFrame) {
-            const loc = topFrame.location;
-            const fn = loc.function_name || '<anonymous>';
-            this.logger.debug(`Thread ${thread.id} halted at ${loc.script_path}:${loc.line_number} (${fn})`);
-        }
-        else {
-            this.logger.debug(`Thread ${thread.id} halted`);
-        }
-    }
-    async pollThreads() {
-        try {
-            const threads = await this.client.getThreads();
-            const currentIds = new Set();
-            for (const thread of threads) {
-                currentIds.add(thread.id);
-                const previous = this.knownThreads.get(thread.id);
-                if (!previous) {
-                    // New thread appeared
-                    this.knownThreads.set(thread.id, thread);
-                    if (thread.status === 'halted') {
-                        this.logThreadHalted(thread);
-                        this.callbacks.onThreadStopped?.(thread);
-                    }
-                }
-                else if (previous.status !== thread.status) {
-                    // State changed
-                    this.knownThreads.set(thread.id, thread);
-                    if (thread.status === 'halted') {
-                        this.logThreadHalted(thread);
-                        this.callbacks.onThreadStopped?.(thread);
-                    }
-                    else {
-                        this.logger.debug(`Thread ${thread.id} resumed`);
-                        this.callbacks.onThreadContinued?.(thread.id);
-                    }
-                }
-                else if (thread.status === 'halted' && this.haltLocationChanged(previous, thread)) {
-                    // Still halted but at a different location (hit another breakpoint or stepped)
-                    this.knownThreads.set(thread.id, thread);
-                    this.logThreadHalted(thread);
-                    this.callbacks.onThreadStopped?.(thread);
-                }
-                else {
-                    this.knownThreads.set(thread.id, thread);
-                }
-            }
-            // Detect threads that disappeared
-            for (const [id] of this.knownThreads) {
-                if (!currentIds.has(id)) {
-                    this.knownThreads.delete(id);
-                    this.logger.debug(`Thread ${id} exited`);
-                    this.callbacks.onThreadExited?.(id);
-                }
-            }
-        }
-        catch (error) {
-            if (error instanceof SdapiError && error.status === 412) {
-                // Debugger disabled — stop polling
-                this.logger.warn('Debugger was disabled externally');
-                this.stopTimers();
-                this.connected = false;
-                this.callbacks.onDebuggerDisabled?.();
-            }
-            else {
-                this.logger.debug({ error }, 'Thread poll error');
-                this.callbacks.onError?.(error instanceof Error ? error : new Error(String(error)));
-            }
-        }
-    }
-}
-//# sourceMappingURL=debug-session.js.map

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

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

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

@@ -1,20 +0,0 @@
-/**
- * B2C Commerce Script Debugger operations.
- *
- * Provides the SDAPI client, debug session manager, DAP adapter, and supporting
- * utilities for source mapping and variable reference management.
- *
- * @module operations/debug
- */
-export { SdapiClient, SdapiError, createSdapiClient } from './sdapi-client.js';
-export type { SdapiClientConfig } from './sdapi-client.js';
-export { DebugSessionManager } from './debug-session.js';
-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/cjs/operations/debug/index.js

@@ -1,21 +0,0 @@
-/*
- * 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
- */
-/**
- * B2C Commerce Script Debugger operations.
- *
- * Provides the SDAPI client, debug session manager, DAP adapter, and supporting
- * utilities for source mapping and variable reference management.
- *
- * @module operations/debug
- */
-export { SdapiClient, SdapiError, createSdapiClient } from './sdapi-client.js';
-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/cjs/operations/debug/index.js.map

@@ -1 +0,0 @@
-{"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/cjs/operations/debug/projections.d.ts

@@ -1,72 +0,0 @@
-/**
- * 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/cjs/operations/debug/projections.js

@@ -1,84 +0,0 @@
-/*
- * 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/cjs/operations/debug/projections.js.map

@@ -1 +0,0 @@
-{"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/cjs/operations/debug/resolve-path.d.ts

@@ -1,15 +0,0 @@
-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/cjs/operations/debug/resolve-path.js

@@ -1,52 +0,0 @@
-/*
- * 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/cjs/operations/debug/resolve-path.js.map

@@ -1 +0,0 @@
-{"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/cjs/operations/debug/sdapi-client.d.ts

@@ -1,44 +0,0 @@
-import type { SdapiBreakpoint, SdapiEvalResult, SdapiFault, SdapiObjectMembers, SdapiScriptThread, BreakpointInput } from './types.js';
-/**
- * Error thrown when the SDAPI returns a fault response.
- */
-export declare class SdapiError extends Error {
-    readonly fault: SdapiFault;
-    readonly status: number;
-    constructor(fault: SdapiFault, status: number);
-}
-export interface SdapiClientConfig {
-    hostname: string;
-    username: string;
-    password: string;
-    clientId?: string;
-}
-/**
- * Creates a new SDAPI client.
- */
-export declare function createSdapiClient(config: SdapiClientConfig): SdapiClient;
-export declare class SdapiClient {
-    private readonly baseUrl;
-    private readonly headers;
-    private readonly logger;
-    constructor(config: SdapiClientConfig);
-    createClient(): Promise<void>;
-    deleteClient(): Promise<void>;
-    getBreakpoints(): Promise<SdapiBreakpoint[]>;
-    setBreakpoints(breakpoints: BreakpointInput[]): Promise<SdapiBreakpoint[]>;
-    deleteBreakpoints(): Promise<void>;
-    deleteBreakpoint(id: number): Promise<void>;
-    getThreads(): Promise<SdapiScriptThread[]>;
-    getThread(threadId: number): Promise<SdapiScriptThread>;
-    resetThreads(): Promise<void>;
-    resume(threadId: number): Promise<SdapiScriptThread>;
-    stepOver(threadId: number): Promise<SdapiScriptThread>;
-    stepInto(threadId: number): Promise<SdapiScriptThread>;
-    stepOut(threadId: number): Promise<SdapiScriptThread>;
-    stopThread(threadId: number): Promise<void>;
-    getVariables(threadId: number, frameIndex: number): Promise<SdapiObjectMembers>;
-    getMembers(threadId: number, frameIndex: number, objectPath?: string, start?: number, count?: number): Promise<SdapiObjectMembers>;
-    evaluate(threadId: number, frameIndex: number, expr: string): Promise<SdapiEvalResult>;
-    private request;
-    private throwSdapiError;
-}