@salesforce/platform-sdk 3.0.0

package/dist/lightning/index.d.ts

@@ -0,0 +1,15 @@
+import { LightningSDK, SDKOptions } from '../core';
+/**
+ * Options for creating a LightningSDK instance.
+ */
+export interface LightningSDKOptions extends SDKOptions {
+}
+/**
+ * Create and initialize a LightningSDK instance based on the detected surface
+ *
+ * @param options - Optional configuration including surface override
+ * @returns Promise resolving to an initialized LightningSDK instance
+ */
+export declare function createLightningSDK(options?: LightningSDKOptions): Promise<LightningSDK>;
+export type { LightningSDK, SDKOptions } from '../core';
+//# sourceMappingURL=index.d.ts.map

package/dist/lightning/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/lightning/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAExD;;GAEG;AAEH,MAAM,WAAW,mBAAoB,SAAQ,UAAU;CAAG;AAE1D;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuBvF;AAED,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC"}

package/dist/telemetry/action-piggyback.d.ts

@@ -0,0 +1,7 @@
+import { TelemetryBuffer } from './buffer';
+export declare class ActionPiggybackAdapter {
+    private readonly buffer;
+    constructor(buffer: TelemetryBuffer);
+    wrapAction(args: Record<string, unknown>): Record<string, unknown>;
+}
+//# sourceMappingURL=action-piggyback.d.ts.map

package/dist/telemetry/action-piggyback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"action-piggyback.d.ts","sourceRoot":"","sources":["../../src/telemetry/action-piggyback.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,qBAAa,sBAAsB;IAClC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;gBAE7B,MAAM,EAAE,eAAe;IAInC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAQlE"}

package/dist/telemetry/buffer.d.ts

@@ -0,0 +1,22 @@
+import { EnvelopeEntry, EnvelopeMetadata } from './types';
+interface BufferOptions {
+    maxBufferSize: number;
+    onError?: (context: {
+        reason: string;
+        droppedCount?: number;
+    }) => void;
+}
+export declare class TelemetryBuffer {
+    private entries;
+    private totalBytes;
+    private readonly maxBufferSize;
+    private readonly onError?;
+    constructor(options: BufferOptions);
+    get size(): number;
+    get isEmpty(): boolean;
+    enqueue(envelope: Uint8Array, metadata?: EnvelopeMetadata): void;
+    drain(): EnvelopeEntry[];
+    private evict;
+}
+export {};
+//# sourceMappingURL=buffer.d.ts.map

package/dist/telemetry/buffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"buffer.d.ts","sourceRoot":"","sources":["../../src/telemetry/buffer.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAW/D,UAAU,aAAa;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACvE;AAED,qBAAa,eAAe;IAC3B,OAAO,CAAC,OAAO,CAAuB;IACtC,OAAO,CAAC,UAAU,CAAK;IACvB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAA+D;gBAE5E,OAAO,EAAE,aAAa;IAKlC,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI;IAmBhE,KAAK,IAAI,aAAa,EAAE;IAOxB,OAAO,CAAC,KAAK;CAWb"}

package/dist/telemetry/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export { createTelemetryTransport } from './transport';
+export { registerTelemetryUploader, TelemetryUploader } from './uploader/TelemetryUploader';
+export type { TelemetryTransport, TelemetryTransportOptions, TelemetryPayload, EnvelopeEntry, EnvelopeMetadata, } from './types';
+export type { TelemetryUploaderOptions, OnEnvelopeCallback, FlushReason, TelemetryUploadContext, TelemetryUploaderErrorContext, InstrumentedAppLike, DisposeOptions, } from './uploader/interfaces';
+//# sourceMappingURL=index.d.ts.map

package/dist/telemetry/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/telemetry/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AAC5F,YAAY,EACX,kBAAkB,EAClB,yBAAyB,EACzB,gBAAgB,EAChB,aAAa,EACb,gBAAgB,GAChB,MAAM,SAAS,CAAC;AACjB,YAAY,EACX,wBAAwB,EACxB,kBAAkB,EAClB,WAAW,EACX,sBAAsB,EACtB,6BAA6B,EAC7B,mBAAmB,EACnB,cAAc,GACd,MAAM,uBAAuB,CAAC"}

package/dist/telemetry/transport.d.ts

@@ -0,0 +1,3 @@
+import { TelemetryTransport, TelemetryTransportOptions } from './types';
+export declare function createTelemetryTransport(options: TelemetryTransportOptions): TelemetryTransport;
+//# sourceMappingURL=transport.d.ts.map

package/dist/telemetry/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../src/telemetry/transport.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAoB,MAAM,SAAS,CAAC;AAM/F,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,yBAAyB,GAAG,kBAAkB,CA2B/F"}

package/dist/telemetry/types.d.ts

@@ -0,0 +1,32 @@
+import { ChatSDK } from '../core';
+export interface EnvelopeMetadata {
+    traceId?: string;
+    instanceId?: string;
+    componentRef?: string;
+}
+export interface EnvelopeEntry {
+    data: string;
+    traceId?: string;
+    instanceId?: string;
+    componentRef?: string;
+    timestamp: number;
+}
+export interface TelemetryPayload {
+    envelopes: EnvelopeEntry[];
+}
+export interface TelemetryTransportOptions {
+    sdk: ChatSDK;
+    flushOnAction?: boolean;
+    maxBufferSize?: number;
+    flushInterval?: number;
+    onError?: (context: {
+        reason: string;
+        droppedCount?: number;
+    }) => void;
+}
+export interface TelemetryTransport {
+    enqueue(envelope: Uint8Array, metadata?: EnvelopeMetadata): void;
+    wrapAction(args: Record<string, unknown>): Record<string, unknown>;
+    dispose(): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/telemetry/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/telemetry/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,MAAM,WAAW,gBAAgB;IAChC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,aAAa;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,gBAAgB;IAChC,SAAS,EAAE,aAAa,EAAE,CAAC;CAC3B;AAED,MAAM,WAAW,yBAAyB;IACzC,GAAG,EAAE,OAAO,CAAC;IACb,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,YAAY,CAAC,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACvE;AAED,MAAM,WAAW,kBAAkB;IAClC,OAAO,CAAC,QAAQ,EAAE,UAAU,EAAE,QAAQ,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAAC;IACjE,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnE,OAAO,IAAI,IAAI,CAAC;CAChB"}

package/dist/telemetry/uploader/TelemetryUploader.d.ts

@@ -0,0 +1,43 @@
+import { DisposeOptions, FlushReason, InstrumentedAppLike, LogCollectorLike, MetricsCollectorLike, MetricsExtractorMethodsLike, TelemetryUploaderOptions } from './interfaces';
+export declare class TelemetryUploader implements LogCollectorLike, MetricsCollectorLike {
+    private readonly _collector;
+    private readonly _onEnvelope;
+    private readonly _onError?;
+    private readonly _enableClickTrigger;
+    private readonly _enableVisibilityTrigger;
+    private readonly _messagesLimit;
+    private readonly _metricsLimit;
+    private readonly _uploadInterval;
+    private readonly _clickUploadDelay;
+    private readonly _clickTriggerCooldown;
+    private readonly _boundClickListener;
+    private readonly _boundVisibilityChangeListener;
+    private readonly _boundPageHideListener;
+    private _intervalHandle?;
+    private _clickTimeoutHandle?;
+    private _flushPromise?;
+    private _pendingFlushReason?;
+    private _lastClickTriggeredAt;
+    private _isDisposed;
+    constructor(options: TelemetryUploaderOptions);
+    get hasData(): boolean;
+    get estimatedByteSize(): number;
+    get messagesCount(): number;
+    get metricsCount(): number;
+    getIsCollectDisabled(): boolean;
+    collect(schema: unknown, data: unknown, logMeta: unknown): void;
+    receiveMetricsExtractors(extractors: MetricsExtractorMethodsLike): void;
+    flush(reason?: FlushReason): Promise<void>;
+    dispose(options?: DisposeOptions): Promise<void>;
+    private _attachWindowListeners;
+    private _detachWindowListeners;
+    private _handleClick;
+    private _handleVisibilityChange;
+    private _handlePageHide;
+    private _restartInterval;
+    private _stopInterval;
+    private _shouldFlushForThreshold;
+    private _flushInternal;
+}
+export declare function registerTelemetryUploader(instrumentedApp: InstrumentedAppLike, options: TelemetryUploaderOptions): TelemetryUploader;
+//# sourceMappingURL=TelemetryUploader.d.ts.map

package/dist/telemetry/uploader/TelemetryUploader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"TelemetryUploader.d.ts","sourceRoot":"","sources":["../../../src/telemetry/uploader/TelemetryUploader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACX,cAAc,EACd,WAAW,EACX,mBAAmB,EACnB,gBAAgB,EAChB,oBAAoB,EACpB,2BAA2B,EAG3B,wBAAwB,EACxB,MAAM,cAAc,CAAC;AAuBtB,qBAAa,iBAAkB,YAAW,gBAAgB,EAAE,oBAAoB;IAC/E,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkB;IAC7C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyC;IACrE,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAsC;IAChE,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAU;IAC9C,OAAO,CAAC,QAAQ,CAAC,wBAAwB,CAAU;IACnD,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAS;IACxC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;IACzC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAgC;IACpE,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAA2C;IAC1F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAmC;IAC1E,OAAO,CAAC,eAAe,CAAC,CAAiC;IACzD,OAAO,CAAC,mBAAmB,CAAC,CAAgC;IAC5D,OAAO,CAAC,aAAa,CAAC,CAAgB;IACtC,OAAO,CAAC,mBAAmB,CAAC,CAAc;IAC1C,OAAO,CAAC,qBAAqB,CAAK;IAClC,OAAO,CAAC,WAAW,CAAS;gBAEhB,OAAO,EAAE,wBAAwB;IA4B7C,IAAI,OAAO,IAAI,OAAO,CAErB;IAED,IAAI,iBAAiB,IAAI,MAAM,CAE9B;IAED,IAAI,aAAa,IAAI,MAAM,CAE1B;IAED,IAAI,YAAY,IAAI,MAAM,CAEzB;IAED,oBAAoB,IAAI,OAAO;IAI/B,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAO/D,wBAAwB,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI;IAIjE,KAAK,CAAC,MAAM,GAAE,WAAsB,GAAG,OAAO,CAAC,IAAI,CAAC;IAqBpD,OAAO,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAatD,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,sBAAsB;IAU9B,OAAO,CAAC,YAAY;IAwBpB,OAAO,CAAC,uBAAuB;IAO/B,OAAO,CAAC,eAAe;IAOvB,OAAO,CAAC,gBAAgB;IASxB,OAAO,CAAC,aAAa;IAOrB,OAAO,CAAC,wBAAwB;YAIlB,cAAc;CA2B5B;AAED,wBAAgB,yBAAyB,CACxC,eAAe,EAAE,mBAAmB,EACpC,OAAO,EAAE,wBAAwB,GAC/B,iBAAiB,CAcnB"}

package/dist/telemetry/uploader/interfaces.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2026, Salesforce, Inc.,
+ * All rights reserved.
+ * For full license text, see the LICENSE.txt file
+ */
+export type FlushReason = "manual" | "interval" | "threshold" | "click" | "visibilitychange" | "pagehide" | "dispose";
+export interface TelemetryEnvironment {
+    appName?: string;
+    appVersion?: string;
+    appExperience?: string;
+    deviceId?: string;
+    deviceModel?: string;
+    sdkVersion?: string;
+}
+export interface TelemetryUploadContext {
+    reason: FlushReason;
+    messagesCount: number;
+    metricsCount: number;
+    estimatedByteSize: number;
+    triggeredAt: number;
+}
+export type OnEnvelopeCallback = (coreEnvelope: Uint8Array, context: TelemetryUploadContext) => void | Promise<void>;
+export interface TelemetryUploaderErrorContext extends TelemetryUploadContext {
+    error: unknown;
+}
+export interface TelemetryUploaderOptions {
+    onEnvelope: OnEnvelopeCallback;
+    environment?: TelemetryEnvironment;
+    uploadInterval?: number;
+    messagesLimit?: number;
+    metricsLimit?: number;
+    maxUniqueSchemas?: number;
+    enableClickTrigger?: boolean;
+    enableVisibilityTrigger?: boolean;
+    clickUploadDelay?: number;
+    clickTriggerCooldown?: number;
+    onError?: (context: TelemetryUploaderErrorContext) => void;
+}
+export interface MetricsExtractorMethodsLike {
+    getAllBucketHistograms(): unknown[];
+    getAllUpCounters(): unknown[];
+    getAllValueRecorders(): unknown[];
+}
+export interface LogCollectorLike {
+    getIsCollectDisabled?(): boolean;
+    collect(schema: unknown, data: unknown, logMeta: unknown): void;
+}
+export interface MetricsCollectorLike {
+    receiveMetricsExtractors(extractors: MetricsExtractorMethodsLike): void;
+}
+export interface InstrumentedAppLike {
+    registerLogCollector(collector: LogCollectorLike, options?: {
+        retroactive?: boolean;
+    }): void;
+    registerMetricsCollector(collector: MetricsCollectorLike): void;
+    activateClickTracker?(): void;
+}
+export interface DisposeOptions {
+    flush?: boolean;
+}
+//# sourceMappingURL=interfaces.d.ts.map

package/dist/telemetry/uploader/interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interfaces.d.ts","sourceRoot":"","sources":["../../../src/telemetry/uploader/interfaces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,MAAM,WAAW,GACpB,QAAQ,GACR,UAAU,GACV,WAAW,GACX,OAAO,GACP,kBAAkB,GAClB,UAAU,GACV,SAAS,CAAC;AAEb,MAAM,WAAW,oBAAoB;IACpC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,sBAAsB;IACtC,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,MAAM,CAAC;IACrB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,WAAW,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG,CAChC,YAAY,EAAE,UAAU,EACxB,OAAO,EAAE,sBAAsB,KAC3B,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;AAE1B,MAAM,WAAW,6BAA8B,SAAQ,sBAAsB;IAC5E,KAAK,EAAE,OAAO,CAAC;CACf;AAED,MAAM,WAAW,wBAAwB;IACxC,UAAU,EAAE,kBAAkB,CAAC;IAC/B,WAAW,CAAC,EAAE,oBAAoB,CAAC;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,CAAC,OAAO,EAAE,6BAA6B,KAAK,IAAI,CAAC;CAC3D;AAED,MAAM,WAAW,2BAA2B;IAC3C,sBAAsB,IAAI,OAAO,EAAE,CAAC;IACpC,gBAAgB,IAAI,OAAO,EAAE,CAAC;IAC9B,oBAAoB,IAAI,OAAO,EAAE,CAAC;CAClC;AAED,MAAM,WAAW,gBAAgB;IAChC,oBAAoB,CAAC,IAAI,OAAO,CAAC;IACjC,OAAO,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAAC;CAChE;AAED,MAAM,WAAW,oBAAoB;IACpC,wBAAwB,CAAC,UAAU,EAAE,2BAA2B,GAAG,IAAI,CAAC;CACxE;AAED,MAAM,WAAW,mBAAmB;IACnC,oBAAoB,CAAC,SAAS,EAAE,gBAAgB,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7F,wBAAwB,CAAC,SAAS,EAAE,oBAAoB,GAAG,IAAI,CAAC;IAChE,oBAAoB,CAAC,IAAI,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAC;CAChB"}

package/dist/telemetry/widget-state-flush.d.ts

@@ -0,0 +1,14 @@
+import { ChatSDK } from '../core';
+import { TelemetryBuffer } from './buffer';
+export declare class WidgetStateFlushAdapter {
+    private readonly buffer;
+    private readonly sdk;
+    private timerId;
+    private disposed;
+    private readonly handleVisibilityChange;
+    private readonly handlePageHide;
+    constructor(buffer: TelemetryBuffer, sdk: ChatSDK, flushInterval: number);
+    flush(): void;
+    dispose(): void;
+}
+//# sourceMappingURL=widget-state-flush.d.ts.map

package/dist/telemetry/widget-state-flush.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"widget-state-flush.d.ts","sourceRoot":"","sources":["../../src/telemetry/widget-state-flush.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAGhD,qBAAa,uBAAuB;IACnC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAU;IAC9B,OAAO,CAAC,OAAO,CAA+C;IAC9D,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAIrC;IAEF,OAAO,CAAC,QAAQ,CAAC,cAAc,CAE7B;gBAEU,MAAM,EAAE,eAAe,EAAE,GAAG,EAAE,OAAO,EAAE,aAAa,EAAE,MAAM;IASxE,KAAK,IAAI,IAAI;IASb,OAAO,IAAI,IAAI;CAcf"}

package/dist/view/index.d.ts

@@ -0,0 +1,22 @@
+import { SDKOptions, ViewSDK, McpAppsSessionOptions } from '../core';
+/**
+ * Options for creating a ViewSDK instance.
+ */
+export interface ViewSDKOptions extends SDKOptions {
+    /** MCP Apps session options (app identity, handshake timeout) */
+    mcpApps?: McpAppsSessionOptions;
+}
+/**
+ * Create and initialize a ViewSDK instance based on the detected surface
+ *
+ * For MCP Apps surfaces, this obtains the shared {@link McpAppsSession} singleton
+ * (performing the SEP-1865 handshake on the first call across all SDK factories).
+ *
+ * @param options - Optional configuration including surface override
+ * @returns Promise resolving to an initialized ViewSDK instance
+ */
+export declare function createViewSDK(options?: ViewSDKOptions): Promise<ViewSDK>;
+export { MCPAppsViewSDK } from './mcpapps';
+export { getViewSDK, getViewSDKSync, resetViewSDK } from './singleton';
+export type { AlertOptions, ModalOptions, SDKOptions, Theme, ThemeMode, ToastOptions, ViewSDK, } from '../core';
+//# sourceMappingURL=index.d.ts.map

package/dist/view/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/view/index.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,UAAU,EAAE,OAAO,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAI1E;;GAEG;AACH,MAAM,WAAW,cAAe,SAAQ,UAAU;IACjD,iEAAiE;IACjE,OAAO,CAAC,EAAE,qBAAqB,CAAC;CAChC;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CA6BxE;AAED,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEvE,YAAY,EACX,YAAY,EACZ,YAAY,EACZ,UAAU,EACV,KAAK,EACL,SAAS,EACT,YAAY,EACZ,OAAO,GACP,MAAM,SAAS,CAAC"}

package/dist/view/mcpapps.d.ts

@@ -0,0 +1,24 @@
+import { ViewSDK, AlertOptions, ToastOptions, ModalOptions, Theme, McpAppsSession } from '../core';
+/**
+ * ViewSDK implementation for MCP Apps surface.
+ *
+ * Uses a shared {@link McpAppsSession} for JSON-RPC 2.0 transport instead of
+ * owning its own postMessage listener, avoiding duplicate listeners and ID
+ * counter collisions when used alongside MCPAppsChatSDK.
+ */
+export declare class MCPAppsViewSDK implements ViewSDK {
+    private session;
+    constructor(session: McpAppsSession);
+    /**
+     * Send a formatted message to the host via ui/message
+     * @param message - The message text
+     * @param level - The message severity level (defaults to "info")
+     */
+    private sendMessage;
+    displayAlert(options: AlertOptions): Promise<void>;
+    displayToast(options: ToastOptions): Promise<void>;
+    displayModal(_options: ModalOptions): Promise<void>;
+    getTheme(): Theme | null;
+    resize(width: string, height: string): Promise<void>;
+}
+//# sourceMappingURL=mcpapps.d.ts.map

package/dist/view/mcpapps.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcpapps.d.ts","sourceRoot":"","sources":["../../src/view/mcpapps.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EACX,OAAO,EACP,YAAY,EACZ,YAAY,EACZ,YAAY,EACZ,KAAK,EAEL,MAAM,SAAS,CAAC;AACjB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAG9C;;;;;;GAMG;AACH,qBAAa,cAAe,YAAW,OAAO;IACjC,OAAO,CAAC,OAAO;gBAAP,OAAO,EAAE,cAAc;IAE3C;;;;OAIG;YACW,WAAW;IAcnB,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAIlD,YAAY,CAAC,QAAQ,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAKzD,QAAQ,IAAI,KAAK,GAAG,IAAI;IAKlB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CA2B1D"}

package/dist/view/openai.d.ts

@@ -0,0 +1,11 @@
+import { ViewSDK, AlertOptions, ToastOptions, ModalOptions, Theme } from '../core';
+/**
+ * ViewSDK implementation for OpenAI surface
+ */
+export declare class OpenAIViewSDK implements ViewSDK {
+    displayAlert(options: AlertOptions): Promise<void>;
+    displayToast(options: ToastOptions): Promise<void>;
+    displayModal(options: ModalOptions): Promise<void>;
+    getTheme(): Theme | null;
+}
+//# sourceMappingURL=openai.d.ts.map

package/dist/view/openai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai.d.ts","sourceRoot":"","sources":["../../src/view/openai.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAGxF;;GAEG;AACH,qBAAa,aAAc,YAAW,OAAO;IACtC,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOlD,YAAY,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOxD,QAAQ,IAAI,KAAK,GAAG,IAAI;CAIxB"}

package/dist/view/singleton.d.ts

@@ -0,0 +1,32 @@
+import { ViewSDK } from '../core';
+import { ViewSDKOptions } from './index';
+/**
+ * Get or create a singleton ViewSDK instance.
+ *
+ * The first caller may provide options (e.g. surface-specific configuration).
+ * Subsequent callers receive the same cached Promise regardless of arguments.
+ *
+ * The Promise itself is cached (not the resolved value) so concurrent callers
+ * do not race to create multiple instances.
+ *
+ * @param options - Optional configuration (only used on first call)
+ * @returns Promise resolving to the shared ViewSDK instance
+ */
+export declare function getViewSDK(options?: ViewSDKOptions): Promise<ViewSDK>;
+/**
+ * Synchronously get the singleton ViewSDK instance.
+ *
+ * Returns the resolved instance if {@link getViewSDK} has already been
+ * called and completed, or `null` if not yet initialized. Use this in
+ * contexts where async is not available (e.g., imperative mosaic components).
+ *
+ * @returns The singleton ViewSDK instance, or null if not yet ready
+ */
+export declare function getViewSDKSync(): ViewSDK | null;
+/**
+ * Reset the singleton ViewSDK cache.
+ *
+ * Useful for testing and session reset scenarios.
+ */
+export declare function resetViewSDK(): void;
+//# sourceMappingURL=singleton.d.ts.map

package/dist/view/singleton.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"singleton.d.ts","sourceRoot":"","sources":["../../src/view/singleton.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAK9C;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,CAQrE;AAED;;;;;;;;GAQG;AACH,wBAAgB,cAAc,IAAI,OAAO,GAAG,IAAI,CAE/C;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,IAAI,CAGnC"}

package/dist/view/utils.d.ts

@@ -0,0 +1,59 @@
+import { MessageLevel } from '../core';
+/**
+ * Get the icon emoji for a given message level
+ *
+ * Maps message severity levels to their corresponding emoji icons:
+ * - info: ℹ️
+ * - success: ✅
+ * - warning: ⚠️
+ * - error: ❌
+ *
+ * @param level - The message severity level
+ * @returns The emoji icon for the level
+ */
+export declare function getIconForLevel(level: MessageLevel): string;
+/**
+ * Format a message with an icon based on the severity level
+ *
+ * Prepends the appropriate emoji icon to the message text.
+ *
+ * @param message - The message text
+ * @param level - The message severity level
+ * @returns The formatted message with icon prefix (e.g., "ℹ️ Your message")
+ */
+export declare function formatMessageWithLevel(message: string, level: MessageLevel): string;
+/**
+ * Result type for dimension parsing
+ */
+export type ParseDimensionResult = {
+    success: true;
+    value: number | undefined;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Parse a dimension string to a numeric pixel value
+ *
+ * Supports formats:
+ * - "800px" - pixel value with unit
+ * - "800" - unitless value (treated as pixels)
+ * - "" - empty string returns undefined
+ *
+ * Rejects with error message:
+ * - Invalid formats (e.g., "800rem", "50%", "auto")
+ * - Negative values
+ * - Non-numeric values
+ *
+ * @param value - The dimension string to parse
+ * @param dimensionName - Name of the dimension for error messages ("width" or "height")
+ * @returns Result object with success flag and either value or error message
+ *
+ * @example
+ * parseDimension("800px", "width") // Returns { success: true, value: 800 }
+ * parseDimension("600", "height") // Returns { success: true, value: 600 }
+ * parseDimension("", "width") // Returns { success: true, value: undefined }
+ * parseDimension("50%", "width") // Returns { success: false, error: "Invalid width..." }
+ */
+export declare function parseDimension(value: string, dimensionName: string): ParseDimensionResult;
+//# sourceMappingURL=utils.d.ts.map

package/dist/view/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/view/utils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,YAAY,GAAG,MAAM,CAa3D;AAED;;;;;;;;GAQG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,CAGnF;AAED;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAC7B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,GAC5C;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,oBAAoB,CAiCzF"}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "@salesforce/platform-sdk",
+  "version": "3.0.0",
+  "license": "SEE LICENSE IN LICENSE.txt",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "sideEffects": false,
+  "exports": {
+    "./package.json": "./package.json",
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "vite build",
+    "clean": "rm -rf dist",
+    "dev": "vite build --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage"
+  },
+  "dependencies": {
+    "@conduit-client/command-http-cache-control": "3.17.0",
+    "@conduit-client/onestore-graphql-parser": "3.17.0",
+    "@conduit-client/service-cache": "3.17.0",
+    "@conduit-client/service-cache-control": "3.17.0",
+    "@conduit-client/service-cache-inclusion-policy": "3.17.0",
+    "@conduit-client/service-fetch-network": "3.17.0",
+    "@conduit-client/service-pubsub": "3.17.0",
+    "@conduit-client/utils": "3.17.0"
+  },
+  "peerDependencies": {
+    "o11y": ">=260.0.0",
+    "o11y_schema": ">=260.63.0"
+  },
+  "devDependencies": {
+    "vite": "^7.3.1",
+    "vite-plugin-dts": "^4.5.4",
+    "vitest": "^4.0.6"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}