@salesforce/b2c-tooling-sdk 0.3.0 → 0.4.0

package/dist/esm/operations/content/types.js

@@ -0,0 +1,7 @@
+/*
+ * 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
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/esm/operations/content/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/operations/content/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/dist/esm/operations/mrt/b2c-config.js

@@ -1,5 +1,20 @@
 import { createMrtB2CClient, DEFAULT_MRT_B2C_ORIGIN, } from '../../clients/mrt-b2c.js';
 import { getLogger } from '../../logging/logger.js';
+const B2C_API_PATH = '/api/cc/b2c';
+/**
+ * Ensures the origin has the /api/cc/b2c path suffix.
+ * When callers pass the generic MRT origin (e.g. https://cloud.mobify.com),
+ * we need to append the B2C API path.
+ */
+function toB2COrigin(origin) {
+    if (!origin)
+        return DEFAULT_MRT_B2C_ORIGIN;
+    // Already has the B2C path
+    if (origin.endsWith(B2C_API_PATH))
+        return origin;
+    // Strip trailing slash before appending
+    return origin.replace(/\/+$/, '') + B2C_API_PATH;
+}
 /**
  * Gets B2C Commerce info for an organization.
  *
@@ -29,7 +44,7 @@ export async function getB2COrgInfo(options, auth) {
     const logger = getLogger();
     const { organizationSlug, origin } = options;
     logger.debug({ organizationSlug }, '[MRT-B2C] Getting B2C organization info');
-    const client = createMrtB2CClient({ origin: origin || DEFAULT_MRT_B2C_ORIGIN }, auth);
+    const client = createMrtB2CClient({ origin: toB2COrigin(origin) }, auth);
     const { data, error } = await client.GET('/b2c-organization-info/{organization_slug}/', {
         params: {
             path: { organization_slug: organizationSlug },
@@ -74,7 +89,7 @@ export async function getB2CTargetInfo(options, auth) {
     const logger = getLogger();
     const { projectSlug, targetSlug, origin } = options;
     logger.debug({ projectSlug, targetSlug }, '[MRT-B2C] Getting B2C target info');
-    const client = createMrtB2CClient({ origin: origin || DEFAULT_MRT_B2C_ORIGIN }, auth);
+    const client = createMrtB2CClient({ origin: toB2COrigin(origin) }, auth);
     const { data, error } = await client.GET('/projects/{project_slug}/b2c-target-info/{target_slug}/', {
         params: {
             path: { project_slug: projectSlug, target_slug: targetSlug },
@@ -118,7 +133,7 @@ export async function setB2CTargetInfo(options, auth) {
     const logger = getLogger();
     const { projectSlug, targetSlug, instanceId, sites, origin } = options;
     logger.debug({ projectSlug, targetSlug, instanceId }, '[MRT-B2C] Setting B2C target info');
-    const client = createMrtB2CClient({ origin: origin || DEFAULT_MRT_B2C_ORIGIN }, auth);
+    const client = createMrtB2CClient({ origin: toB2COrigin(origin) }, auth);
     const body = {
         instance_id: instanceId,
     };
@@ -169,7 +184,7 @@ export async function updateB2CTargetInfo(options, auth) {
     const logger = getLogger();
     const { projectSlug, targetSlug, instanceId, sites, origin } = options;
     logger.debug({ projectSlug, targetSlug, instanceId }, '[MRT-B2C] Updating B2C target info');
-    const client = createMrtB2CClient({ origin: origin || DEFAULT_MRT_B2C_ORIGIN }, auth);
+    const client = createMrtB2CClient({ origin: toB2COrigin(origin) }, auth);
     const body = {};
     if (instanceId !== undefined) {
         body.instance_id = instanceId;

package/dist/esm/operations/mrt/b2c-config.js.map

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

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

@@ -67,3 +67,5 @@ export { getProfile, resetApiKey, getEmailPreferences, updateEmailPreferences }
 export type { UserOperationOptions, ApiKeyResult, UpdateEmailPreferencesOptions, MrtUserProfile, MrtEmailPreferences, PatchedMrtEmailPreferences, } from './user.js';
 export { getB2COrgInfo, getB2CTargetInfo, setB2CTargetInfo, updateB2CTargetInfo } from './b2c-config.js';
 export type { GetB2COrgInfoOptions, GetB2CTargetInfoOptions, SetB2CTargetInfoOptions, UpdateB2CTargetInfoOptions, B2COrgInfo, B2CTargetInfo, PatchedB2CTargetInfo, } from './b2c-config.js';
+export { createLoggingToken, parseMrtLogLine, getLogsWebSocketUrl, tailMrtLogs } from './tail-logs.js';
+export type { MrtLogEntry, CreateLoggingTokenOptions, TailMrtLogsOptions, TailMrtLogsResult } from './tail-logs.js';

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

@@ -72,4 +72,6 @@ export { invalidateCache } from './cache.js';
 export { getProfile, resetApiKey, getEmailPreferences, updateEmailPreferences } from './user.js';
 // B2C Commerce config operations
 export { getB2COrgInfo, getB2CTargetInfo, setB2CTargetInfo, updateB2CTargetInfo } from './b2c-config.js';
+// Log tailing operations
+export { createLoggingToken, parseMrtLogLine, getLogsWebSocketUrl, tailMrtLogs } from './tail-logs.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +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,6BAA6B;AAC7B,OAAO,EAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAWhF,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,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AAevF,wBAAwB;AACxB,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAUlE,0BAA0B;AAC1B,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAQpD,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAcnG,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAaxG,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAa3B,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAevB,mCAAmC;AACnC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAU7B,mBAAmB;AACnB,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAG3C,kBAAkB;AAClB,OAAO,EAAC,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAC,MAAM,WAAW,CAAC;AAU/F,iCAAiC;AACjC,OAAO,EAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAC,MAAM,iBAAiB,CAAC"}
+{"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,6BAA6B;AAC7B,OAAO,EAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,cAAc,EAAC,MAAM,WAAW,CAAC;AAWhF,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,EAAE,QAAQ,EAAE,SAAS,EAAC,MAAM,UAAU,CAAC;AAevF,wBAAwB;AACxB,OAAO,EAAC,eAAe,EAAE,gBAAgB,EAAC,MAAM,iBAAiB,CAAC;AAUlE,0BAA0B;AAC1B,OAAO,EAAC,iBAAiB,EAAC,MAAM,mBAAmB,CAAC;AAQpD,qBAAqB;AACrB,OAAO,EAAC,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,aAAa,EAAE,aAAa,EAAC,MAAM,cAAc,CAAC;AAcnG,oBAAoB;AACpB,OAAO,EAAC,WAAW,EAAE,SAAS,EAAE,SAAS,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAC,MAAM,aAAa,CAAC;AAaxG,0BAA0B;AAC1B,OAAO,EACL,iBAAiB,EACjB,kBAAkB,EAClB,eAAe,EACf,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,mBAAmB,CAAC;AAa3B,sBAAsB;AACtB,OAAO,EACL,aAAa,EACb,cAAc,EACd,WAAW,EACX,cAAc,EACd,cAAc,EACd,cAAc,GACf,MAAM,eAAe,CAAC;AAevB,mCAAmC;AACnC,OAAO,EACL,wBAAwB,EACxB,yBAAyB,EACzB,sBAAsB,EACtB,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAU7B,mBAAmB;AACnB,OAAO,EAAC,eAAe,EAAC,MAAM,YAAY,CAAC;AAG3C,kBAAkB;AAClB,OAAO,EAAC,UAAU,EAAE,WAAW,EAAE,mBAAmB,EAAE,sBAAsB,EAAC,MAAM,WAAW,CAAC;AAU/F,iCAAiC;AACjC,OAAO,EAAC,aAAa,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,mBAAmB,EAAC,MAAM,iBAAiB,CAAC;AAWvG,yBAAyB;AACzB,OAAO,EAAC,kBAAkB,EAAE,eAAe,EAAE,mBAAmB,EAAE,WAAW,EAAC,MAAM,gBAAgB,CAAC"}

package/dist/esm/operations/mrt/tail-logs.d.ts

@@ -0,0 +1,130 @@
+/**
+ * Tail application logs from Managed Runtime environments via WebSocket.
+ *
+ * Connects to the MRT logging WebSocket to stream real-time application logs
+ * from SSR environments.
+ *
+ * @module operations/mrt/tail-logs
+ */
+import type { AuthStrategy } from '../../auth/types.js';
+/**
+ * A parsed MRT log entry.
+ */
+export interface MrtLogEntry {
+    /** ISO 8601 timestamp, if present. */
+    timestamp?: string;
+    /** Full request UUID, if present. */
+    requestId?: string;
+    /** Shortened request ID (first 8 hex chars). */
+    shortRequestId?: string;
+    /** Log level (ERROR, WARN, INFO, DEBUG, etc.), if detected. */
+    level?: string;
+    /** The log message content. */
+    message: string;
+    /** The original raw log line. */
+    raw: string;
+}
+/**
+ * Options for creating a logging JWT token.
+ */
+export interface CreateLoggingTokenOptions {
+    /** MRT project slug. */
+    projectSlug: string;
+    /** MRT environment slug. */
+    environmentSlug: string;
+    /** MRT API origin URL. */
+    origin?: string;
+}
+/**
+ * Options for tailing MRT logs.
+ */
+export interface TailMrtLogsOptions {
+    /** MRT project slug. */
+    projectSlug: string;
+    /** MRT environment slug. */
+    environmentSlug: string;
+    /** MRT API origin URL. */
+    origin?: string;
+    /** User email for the WebSocket connection. */
+    user?: string;
+    /** Called for each parsed log entry. */
+    onEntry?: (entry: MrtLogEntry) => void;
+    /** Called when the WebSocket connection is established. */
+    onConnect?: () => void;
+    /** Called on WebSocket error. */
+    onError?: (error: Error) => void;
+    /** Called when the WebSocket connection closes. */
+    onClose?: (code: number, reason: string) => void;
+}
+/**
+ * Result from starting a log tail session.
+ */
+export interface TailMrtLogsResult {
+    /** Call to stop tailing and close the WebSocket. */
+    stop: () => void;
+    /** Resolves when the WebSocket connection is closed. */
+    done: Promise<void>;
+}
+/**
+ * Creates a logging JWT token for WebSocket authentication.
+ *
+ * POST /api/projects/{project}/target/{environment}/jwt/
+ *
+ * @param options - Token creation options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The JWT token string
+ * @throws Error if token creation fails
+ */
+export declare function createLoggingToken(options: CreateLoggingTokenOptions, auth: AuthStrategy): Promise<string>;
+/**
+ * Parses a raw MRT log line into a structured entry.
+ *
+ * Application log format (tab-separated):
+ *   {ISO8601}\t{UUID}\t{LEVEL}\t{message}
+ *
+ * Platform log format:
+ *   {LEVEL} {message}
+ *
+ * @param raw - The raw log line string
+ * @returns Parsed log entry
+ */
+export declare function parseMrtLogLine(raw: string): MrtLogEntry;
+/**
+ * Transforms the MRT cloud origin URL into the logs WebSocket URL.
+ *
+ * Replaces the `cloud` prefix in the hostname with `logs` and switches
+ * the protocol to `wss://`.
+ *
+ * @example
+ * getLogsWebSocketUrl('https://cloud.mobify.com')
+ * // → 'wss://logs.mobify.com'
+ *
+ * getLogsWebSocketUrl('https://cloud-soak.mrt-soak.com')
+ * // → 'wss://logs-soak.mrt-soak.com'
+ */
+export declare function getLogsWebSocketUrl(origin: string): string;
+/**
+ * Streams application logs from an MRT environment via WebSocket.
+ *
+ * @param options - Tail options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns Object with `stop()` to end streaming and `done` promise
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { tailMrtLogs } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const { stop, done } = await tailMrtLogs({
+ *   projectSlug: 'my-storefront',
+ *   environmentSlug: 'staging',
+ *   onEntry: (entry) => console.log(entry.message),
+ *   onConnect: () => console.log('Connected'),
+ * }, auth);
+ *
+ * // Later: stop()
+ * ```
+ */
+export declare function tailMrtLogs(options: TailMrtLogsOptions, auth: AuthStrategy): Promise<TailMrtLogsResult>;

package/dist/esm/operations/mrt/tail-logs.js

@@ -0,0 +1,223 @@
+import { DEFAULT_MRT_ORIGIN } from '../../clients/mrt.js';
+import { getLogger } from '../../logging/logger.js';
+/** Known platform log levels. */
+const PLATFORM_LEVELS = new Set(['ERROR', 'WARN', 'WARNING', 'INFO', 'DEBUG', 'TRACE']);
+/** Heartbeat interval: 5 minutes (server has 10-min idle timeout). */
+const HEARTBEAT_INTERVAL_MS = 5 * 60 * 1000;
+/**
+ * Creates a logging JWT token for WebSocket authentication.
+ *
+ * POST /api/projects/{project}/target/{environment}/jwt/
+ *
+ * @param options - Token creation options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns The JWT token string
+ * @throws Error if token creation fails
+ */
+export async function createLoggingToken(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, environmentSlug, origin } = options;
+    const baseUrl = origin || DEFAULT_MRT_ORIGIN;
+    logger.debug({ projectSlug, environmentSlug }, '[MRT] Creating logging token');
+    const url = `${baseUrl}/api/projects/${encodeURIComponent(projectSlug)}/target/${encodeURIComponent(environmentSlug)}/jwt/`;
+    const response = await auth.fetch(url, {
+        method: 'POST',
+    });
+    if (!response.ok) {
+        const body = await response.text().catch(() => '');
+        throw new Error(`Failed to create logging token (${response.status}): ${body}`);
+    }
+    const data = (await response.json());
+    logger.debug('[MRT] Logging token created');
+    return data.token;
+}
+/**
+ * Parses a raw MRT log line into a structured entry.
+ *
+ * Application log format (tab-separated):
+ *   {ISO8601}\t{UUID}\t{LEVEL}\t{message}
+ *
+ * Platform log format:
+ *   {LEVEL} {message}
+ *
+ * @param raw - The raw log line string
+ * @returns Parsed log entry
+ */
+export function parseMrtLogLine(raw) {
+    // Try application format: tab-separated with at least 4 fields
+    const parts = raw.split('\t');
+    if (parts.length >= 4) {
+        const [timestamp, requestId, level, ...messageParts] = parts;
+        // Validate this looks like an application log (timestamp should be ISO-ish)
+        if (timestamp && /^\d{4}-\d{2}-\d{2}/.test(timestamp)) {
+            const message = messageParts.join('\t');
+            return {
+                timestamp,
+                requestId,
+                shortRequestId: requestId ? requestId.replace(/-/g, '').slice(0, 8) : undefined,
+                level: level || undefined,
+                message,
+                raw,
+            };
+        }
+    }
+    // Try platform format: "LEVEL message"
+    const spaceIdx = raw.indexOf(' ');
+    if (spaceIdx > 0) {
+        const maybeLevel = raw.slice(0, spaceIdx).toUpperCase();
+        if (PLATFORM_LEVELS.has(maybeLevel)) {
+            return {
+                level: maybeLevel,
+                message: raw.slice(spaceIdx + 1),
+                raw,
+            };
+        }
+    }
+    // Fallback: entire line is the message
+    return {
+        message: raw,
+        raw,
+    };
+}
+/**
+ * Transforms the MRT cloud origin URL into the logs WebSocket URL.
+ *
+ * Replaces the `cloud` prefix in the hostname with `logs` and switches
+ * the protocol to `wss://`.
+ *
+ * @example
+ * getLogsWebSocketUrl('https://cloud.mobify.com')
+ * // → 'wss://logs.mobify.com'
+ *
+ * getLogsWebSocketUrl('https://cloud-soak.mrt-soak.com')
+ * // → 'wss://logs-soak.mrt-soak.com'
+ */
+export function getLogsWebSocketUrl(origin) {
+    const url = new URL(origin);
+    url.protocol = 'wss:';
+    url.hostname = url.hostname.replace('cloud', 'logs');
+    return url.origin;
+}
+/**
+ * Streams application logs from an MRT environment via WebSocket.
+ *
+ * @param options - Tail options
+ * @param auth - Authentication strategy (ApiKeyStrategy)
+ * @returns Object with `stop()` to end streaming and `done` promise
+ *
+ * @example
+ * ```typescript
+ * import { ApiKeyStrategy } from '@salesforce/b2c-tooling-sdk/auth';
+ * import { tailMrtLogs } from '@salesforce/b2c-tooling-sdk/operations/mrt';
+ *
+ * const auth = new ApiKeyStrategy(process.env.MRT_API_KEY!, 'Authorization');
+ *
+ * const { stop, done } = await tailMrtLogs({
+ *   projectSlug: 'my-storefront',
+ *   environmentSlug: 'staging',
+ *   onEntry: (entry) => console.log(entry.message),
+ *   onConnect: () => console.log('Connected'),
+ * }, auth);
+ *
+ * // Later: stop()
+ * ```
+ */
+export async function tailMrtLogs(options, auth) {
+    const logger = getLogger();
+    const { projectSlug, environmentSlug, origin, user, onEntry, onConnect, onError, onClose } = options;
+    const baseOrigin = origin || DEFAULT_MRT_ORIGIN;
+    logger.debug({ projectSlug, environmentSlug, origin: baseOrigin }, '[MRT] Starting log tail');
+    // Step 1: Get JWT token
+    logger.trace({ projectSlug, environmentSlug }, '[MRT] Requesting logging JWT token');
+    const token = await createLoggingToken({ projectSlug, environmentSlug, origin: baseOrigin }, auth);
+    logger.trace('[MRT] Logging JWT token received');
+    // Step 2: Build WebSocket URL (connect to root of logs host, like pwa-kit)
+    const wsBase = getLogsWebSocketUrl(baseOrigin);
+    logger.trace({ cloudOrigin: baseOrigin, wsOrigin: wsBase }, '[MRT] Transformed cloud origin to WebSocket origin');
+    const wsUrl = new URL(wsBase);
+    wsUrl.searchParams.set('project', projectSlug);
+    wsUrl.searchParams.set('environment', environmentSlug);
+    wsUrl.searchParams.set('access_token', token);
+    if (user) {
+        wsUrl.searchParams.set('user', user);
+    }
+    logger.debug({ wsUrl: wsUrl.toString() }, '[MRT] Opening log stream WebSocket');
+    // Step 3: Open WebSocket
+    const ws = new WebSocket(wsUrl.toString());
+    logger.trace({ readyState: ws.readyState }, '[MRT] WebSocket instance created');
+    let heartbeatTimer;
+    let stopped = false;
+    let hadError = false;
+    const done = new Promise((resolve, reject) => {
+        ws.addEventListener('open', () => {
+            logger.debug('[MRT] WebSocket connected successfully');
+            onConnect?.();
+            // Send heartbeat to avoid idle timeout (server disconnects after 10 min)
+            heartbeatTimer = setInterval(() => {
+                if (ws.readyState === WebSocket.OPEN) {
+                    logger.trace('[MRT] Sending WebSocket heartbeat');
+                    ws.send('');
+                }
+            }, HEARTBEAT_INTERVAL_MS);
+            logger.trace({ intervalMs: HEARTBEAT_INTERVAL_MS }, '[MRT] Heartbeat timer started');
+        });
+        ws.addEventListener('message', (event) => {
+            logger.trace({ dataLength: String(event.data).length }, '[MRT] WebSocket message received');
+            if (!onEntry)
+                return;
+            try {
+                const messages = JSON.parse(String(event.data));
+                logger.trace({ messageCount: messages.length }, '[MRT] Parsed WebSocket message batch');
+                for (const msg of messages) {
+                    if (msg.message) {
+                        const entry = parseMrtLogLine(msg.message);
+                        onEntry(entry);
+                    }
+                }
+            }
+            catch (err) {
+                logger.debug({ error: err, rawData: String(event.data).slice(0, 200) }, '[MRT] Failed to parse WebSocket message');
+            }
+        });
+        // The browser WebSocket API fires 'error' before 'close', but the error
+        // event carries no details. We flag it here and report in the close handler
+        // where we have the close code and reason.
+        ws.addEventListener('error', () => {
+            hadError = true;
+            logger.debug('[MRT] WebSocket error event fired (waiting for close event for details)');
+        });
+        ws.addEventListener('close', (event) => {
+            if (heartbeatTimer) {
+                clearInterval(heartbeatTimer);
+                logger.trace('[MRT] Heartbeat timer cleared');
+            }
+            logger.debug({ code: event.code, reason: event.reason, hadError, stopped, wasClean: event.code === 1000 }, '[MRT] WebSocket closed');
+            if (hadError && !stopped) {
+                // Build a descriptive error from the close code/reason
+                const detail = event.reason || `close code ${event.code}`;
+                const error = new Error(`WebSocket connection failed: ${detail}`);
+                logger.debug({ detail, code: event.code, reason: event.reason }, '[MRT] WebSocket connection failed');
+                onError?.(error);
+                onClose?.(event.code, event.reason);
+                reject(error);
+            }
+            else {
+                onClose?.(event.code, event.reason);
+                resolve();
+            }
+        });
+    });
+    const stop = () => {
+        logger.debug('[MRT] Stopping log tail');
+        stopped = true;
+        if (heartbeatTimer) {
+            clearInterval(heartbeatTimer);
+        }
+        if (ws.readyState === WebSocket.OPEN || ws.readyState === WebSocket.CONNECTING) {
+            logger.trace({ readyState: ws.readyState }, '[MRT] Closing WebSocket connection');
+            ws.close();
+        }
+    };
+    return { stop, done };
+}
+//# sourceMappingURL=tail-logs.js.map

package/dist/esm/operations/mrt/tail-logs.js.map

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

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

@@ -4,3 +4,5 @@
  * @module operations/ods
  */
 export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, } from './sandbox-lookup.js';
+export { waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, } from './wait-for-sandbox.js';
+export type { SandboxState, WaitForSandboxOptions, WaitForSandboxPollInfo } from './wait-for-sandbox.js';

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

@@ -9,4 +9,5 @@
  * @module operations/ods
  */
 export { isUuid, isFriendlySandboxId, parseFriendlySandboxId, resolveSandboxId, SandboxNotFoundError, } from './sandbox-lookup.js';
+export { waitForSandbox, SandboxPollingTimeoutError, SandboxPollingError, SandboxTerminalStateError, } from './wait-for-sandbox.js';
 //# sourceMappingURL=index.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/ods/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/operations/ods/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH;;;;GAIG;AAEH,OAAO,EACL,MAAM,EACN,mBAAmB,EACnB,sBAAsB,EACtB,gBAAgB,EAChB,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,yBAAyB,GAC1B,MAAM,uBAAuB,CAAC"}

package/dist/esm/operations/ods/wait-for-sandbox.d.ts

@@ -0,0 +1,64 @@
+import type { OdsClient } from '../../clients/ods.js';
+export type SandboxState = 'deleted' | 'failed' | 'started' | 'stopped' | (string & {});
+export declare class SandboxPollingTimeoutError extends Error {
+    readonly sandboxId: string;
+    readonly targetState: SandboxState;
+    readonly timeoutSeconds: number;
+    readonly lastState?: SandboxState | undefined;
+    constructor(sandboxId: string, targetState: SandboxState, timeoutSeconds: number, lastState?: SandboxState | undefined);
+}
+export declare class SandboxPollingError extends Error {
+    readonly sandboxId: string;
+    readonly message: string;
+    constructor(sandboxId: string, message: string);
+}
+export declare class SandboxTerminalStateError extends Error {
+    readonly sandboxId: string;
+    readonly targetState: SandboxState;
+    readonly state: SandboxState;
+    constructor(sandboxId: string, targetState: SandboxState, state: SandboxState);
+}
+export interface WaitForSandboxPollInfo {
+    sandboxId: string;
+    elapsedSeconds: number;
+    state: SandboxState;
+}
+export interface WaitForSandboxOptions {
+    sandboxId: string;
+    targetState: SandboxState;
+    pollIntervalSeconds: number;
+    timeoutSeconds: number;
+    onPoll?: (info: WaitForSandboxPollInfo) => void;
+    sleep?: (ms: number) => Promise<void>;
+}
+/**
+ * Waits for a sandbox to reach a target state by polling its status.
+ *
+ * This function polls the ODS API at regular intervals until the sandbox reaches the desired state,
+ * times out, or enters a terminal error state (failed/deleted).
+ *
+ * @param client - ODS client for API calls
+ * @param options - Polling configuration options
+ * @param options.sandboxId - ID of the sandbox to monitor
+ * @param options.targetState - Desired sandbox state (e.g., 'started', 'stopped', 'deleted')
+ * @param options.pollIntervalSeconds - Seconds between status checks
+ * @param options.timeoutSeconds - Maximum seconds to wait (0 = no timeout)
+ * @param options.onPoll - Optional callback invoked on each poll with current state
+ * @param options.sleep - Optional custom sleep function (primarily for testing)
+ *
+ * @throws {SandboxPollingTimeoutError} If the timeout is exceeded before reaching target state
+ * @throws {SandboxPollingError} If the API request fails
+ * @throws {SandboxTerminalStateError} If the sandbox enters a terminal error state
+ *
+ * @example
+ * ```typescript
+ * await waitForSandbox(odsClient, {
+ *   sandboxId: 'abc-123',
+ *   targetState: 'started',
+ *   pollIntervalSeconds: 5,
+ *   timeoutSeconds: 300,
+ *   onPoll: (info) => console.log(`State: ${info.state} (${info.elapsedSeconds}s)`),
+ * });
+ * ```
+ */
+export declare function waitForSandbox(client: OdsClient, options: WaitForSandboxOptions): Promise<void>;