@salesforce/metadata-core-sdk 1.6.0 → 1.7.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.d.ts CHANGED
@@ -15,7 +15,7 @@
15
15
  */
16
16
  export { IVisualizationPlugin } from './sdk/contracts/core/IVisualizationPlugin.js';
17
17
  export { IMetadataParser } from './sdk/contracts/core/IMetadataParser.js';
18
- export type { MetadataPluginInfo } from './sdk/contracts/types/MetadataPluginInfo.js';
18
+ export type { MetadataPluginInfo, TrustedSources, } from './sdk/contracts/types/MetadataPluginInfo.js';
19
19
  export type { ValidationResult } from './sdk/contracts/types/ValidationResult.js';
20
20
  export type { PluginContext } from './sdk/contracts/types/PluginContext.js';
21
21
  export type { PluginError } from './sdk/contracts/types/PluginError.js';
@@ -31,7 +31,7 @@ export { Logger } from './sdk/utils/logger.js';
31
31
  export { ErrorBuilder } from './sdk/utils/errors/ErrorBuilder.js';
32
32
  export { setupErrorHandlers } from './sdk/utils/errors/setupHandlers.js';
33
33
  export { WebviewMessageType, VALID_MESSAGE_TYPES } from './sdk/webviewMessageTypes.js';
34
- export type { PluginDataResponse, WebviewMessage, SpatialContext, EditRequest, EditHandoffResult, } from './sdk/webviewMessageTypes.js';
34
+ export type { PluginDataResponse, PluginDataContext, WebviewMessage, SpatialContext, EditRequest, EditHandoffResult, } from './sdk/webviewMessageTypes.js';
35
35
  export { getPluginData, sendToHost, onDataUpdate } from './sdk/utils/HostCommunicationUtils.js';
36
36
  export type { VersionInfo } from './sdk/contracts/types/VersionInfo.js';
37
37
  export { PLUGINS_DIST_DIR, PLUGINS_DIR, REACT_UI_DIR_NAME } from './sdk/constants.js';
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG1E,YAAY,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACtF,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,YAAY,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,cAAc,6BAA6B,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAC9E,YAAY,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACvF,YAAY,EACV,kBAAkB,EAClB,cAAc,EACd,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGhG,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,cAAc,8BAA8B,CAAC;AAwB7C,OAAO,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,YAAY,GAClB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,QAAQ,EACR,UAAU,EACV,YAAY,GACb,MAAM,mDAAmD,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;;;;;GAQG;AAGH,OAAO,EAAE,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AACpF,OAAO,EAAE,eAAe,EAAE,MAAM,yCAAyC,CAAC;AAG1E,YAAY,EACV,kBAAkB,EAClB,cAAc,GACf,MAAM,6CAA6C,CAAC;AACrD,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAClF,YAAY,EAAE,aAAa,EAAE,MAAM,wCAAwC,CAAC;AAC5E,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AACrE,YAAY,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAC1E,YAAY,EAAE,gBAAgB,EAAE,MAAM,2CAA2C,CAAC;AAGlF,cAAc,6BAA6B,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,YAAY,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAC9E,YAAY,EAAE,OAAO,EAAE,MAAM,wCAAwC,CAAC;AAGtE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAGzE,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AACvF,YAAY,EACV,kBAAkB,EAClB,iBAAiB,EACjB,cAAc,EACd,cAAc,EACd,WAAW,EACX,iBAAiB,GAClB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAGhG,YAAY,EAAE,WAAW,EAAE,MAAM,sCAAsC,CAAC;AAGxE,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAGtF,cAAc,8BAA8B,CAAC;AAwB7C,OAAO,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,kBAAkB,EAClB,KAAK,YAAY,GAClB,MAAM,0CAA0C,CAAC;AAElD,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,aAAa,EAClB,QAAQ,EACR,UAAU,EACV,YAAY,GACb,MAAM,mDAAmD,CAAC"}
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAqBJ,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAIrE,wBAAwB;AACxB,cAAc,6BAA6B,CAAC;AAK5C,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,0EAA0E;AAC1E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AASvF,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAKhG,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,gBAAgB;AAChB,cAAc,8BAA8B,CAAC;AAE7C,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,sEAAsE;AACtE,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,kFAAkF;AAClF,6EAA6E;AAC7E,kFAAkF;AAClF,6EAA6E;AAC7E,6CAA6C;AAC7C,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,iEAAiE;AACjE,EAAE;AACF,wEAAwE;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,0CAA0C,CAAC;AAClD,wFAAwF;AACxF,OAAO,EAGL,QAAQ,EACR,UAAU,EACV,YAAY,GACb,MAAM,mDAAmD,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAwBJ,OAAO,EAAE,aAAa,EAAE,MAAM,sCAAsC,CAAC;AAIrE,wBAAwB;AACxB,cAAc,6BAA6B,CAAC;AAK5C,YAAY;AACZ,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAC/D,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,YAAY,EAAE,MAAM,oCAAoC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,qCAAqC,CAAC;AAEzE,0EAA0E;AAC1E,OAAO,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAUvF,+DAA+D;AAC/D,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,uCAAuC,CAAC;AAKhG,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAEtF,gBAAgB;AAChB,cAAc,8BAA8B,CAAC;AAE7C,+EAA+E;AAC/E,0EAA0E;AAC1E,gFAAgF;AAChF,+EAA+E;AAC/E,gFAAgF;AAChF,gFAAgF;AAChF,+EAA+E;AAC/E,sEAAsE;AACtE,EAAE;AACF,+EAA+E;AAC/E,kFAAkF;AAClF,kFAAkF;AAClF,6EAA6E;AAC7E,kFAAkF;AAClF,6EAA6E;AAC7E,6CAA6C;AAC7C,iFAAiF;AACjF,+EAA+E;AAC/E,gFAAgF;AAChF,iEAAiE;AACjE,EAAE;AACF,wEAAwE;AACxE,OAAO,EAAE,OAAO,EAAE,MAAM,sDAAsD,CAAC;AAC/E,OAAO,EACL,eAAe,EACf,SAAS,EACT,OAAO,EACP,kBAAkB,EAClB,kBAAkB,GAEnB,MAAM,0CAA0C,CAAC;AAClD,wFAAwF;AACxF,OAAO,EAGL,QAAQ,EACR,UAAU,EACV,YAAY,GACb,MAAM,mDAAmD,CAAC"}
@@ -24,6 +24,23 @@ export interface IMetadataParser<TData> {
24
24
  * @returns Parsed data structure
25
25
  */
26
26
  parse(filePath: string, versionInfo: VersionInfo): Promise<TData>;
27
+ /**
28
+ * Parse an in-memory payload directly, without reading from disk.
29
+ *
30
+ * Optional in-memory sibling of {@link parse}. When implemented, it enables
31
+ * by-id in-memory rendering: a host that already holds the structured payload
32
+ * (e.g. a typed object pushed by another extension) can have it visualized
33
+ * without first materializing a temp file. The framework routes to this hook
34
+ * from `VisualizationEngine.visualizeData(raw, pluginId)` when a plugin is
35
+ * selected by id rather than by file path.
36
+ *
37
+ * Parsers that only ever read from disk omit this hook; nothing breaks — the
38
+ * by-id in-memory path simply reports that the plugin does not support it.
39
+ *
40
+ * @param raw - The in-memory payload to parse (shape validated by the parser)
41
+ * @returns Parsed data structure (or a promise of it)
42
+ */
43
+ parseContent?(raw: unknown): Promise<TData> | TData;
27
44
  /**
28
45
  * Validate the parsed data
29
46
  *
@@ -1 +1 @@
1
- {"version":3,"file":"IMetadataParser.d.ts","sourceRoot":"","sources":["../../../../src/sdk/contracts/core/IMetadataParser.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAElE;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAEzC;;;;;;;;;;;;OAYG;IACH,wBAAwB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/D;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErD;;;;;;;;;OASG;IACH,mBAAmB,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAE3D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAAkB,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,cAAc,EAAE,CAAC;CACpD"}
1
+ {"version":3,"file":"IMetadataParser.d.ts","sourceRoot":"","sources":["../../../../src/sdk/contracts/core/IMetadataParser.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AAC/E,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D;;;;;GAKG;AACH,MAAM,WAAW,eAAe,CAAC,KAAK;IACpC;;;;;;OAMG;IACH,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,WAAW,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;IAElE;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,CAAC,GAAG,EAAE,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC;IAEpD;;;;;;;;OAQG;IACH,QAAQ,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,gBAAgB,CAAC;IAEzC;;;;;;;;;;;;OAYG;IACH,wBAAwB,CAAC,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;IAE/D;;;;;;;OAOG;IACH,kBAAkB,CAAC,CAAC,OAAO,EAAE,gBAAgB,GAAG,IAAI,CAAC;IAErD;;;;;;;;;OASG;IACH,mBAAmB,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,gBAAgB,GAAG,IAAI,CAAC;IAE3D;;;;;;;;;;;;;;;;;;;OAmBG;IACH,kBAAkB,CAAC,CAAC,IAAI,EAAE,KAAK,GAAG,cAAc,EAAE,CAAC;CACpD"}
@@ -4,6 +4,15 @@
4
4
  * Licensed under the BSD 3-Clause license.
5
5
  * For full license text, see LICENSE.txt file in the repo root or https://opensource.org/licenses/BSD-3-Clause
6
6
  **/
7
+ /** External HTTPS sources that a plugin webview is permitted to use. */
8
+ export interface TrustedSources {
9
+ /** HTTPS URLs to add to CSP script-src directive (e.g. 'https://cdn.jsdelivr.net') */
10
+ scripts?: string[];
11
+ /** HTTPS URLs to add to CSP style-src directive (e.g. 'https://fonts.googleapis.com') */
12
+ styles?: string[];
13
+ /** HTTPS URLs to add to CSP connect-src directive (e.g. 'https://api.example.com') */
14
+ connect?: string[];
15
+ }
7
16
  /**
8
17
  * Plugin metadata information
9
18
  *
@@ -26,7 +35,12 @@ export interface MetadataPluginInfo {
26
35
  description?: string;
27
36
  /** Team/author */
28
37
  author: string;
29
- /** File patterns this plugin handles */
38
+ /**
39
+ * File patterns this plugin handles.
40
+ *
41
+ * This array must be non-empty for file-backed plugins and must be empty when
42
+ * {@link payloadOnly} is `true`.
43
+ */
30
44
  filePatterns: string[];
31
45
  /**
32
46
  * Priority for plugin selection when multiple plugins can handle the same file
@@ -39,6 +53,20 @@ export interface MetadataPluginInfo {
39
53
  * If not specified, defaults to true
40
54
  */
41
55
  defaultEnabled?: boolean;
56
+ /**
57
+ * Whether this plugin is reached only by id via in-memory rendering, never by file path.
58
+ *
59
+ * When `true`, the plugin opts out of file-path selection entirely: it is never
60
+ * matched against a file's extension and is invoked only through
61
+ * `VisualizationEngine.visualizeData(raw, pluginId)`. Because such a plugin
62
+ * handles no files, it must declare `filePatterns: []` and its parser must
63
+ * implement `parseContent`. Conversely, an empty `filePatterns` array is valid
64
+ * only when this flag is `true`.
65
+ *
66
+ * Defaults to `false`/absent — ordinary file-handling plugins never set it and
67
+ * are unaffected.
68
+ */
69
+ payloadOnly?: boolean;
42
70
  /**
43
71
  * Trusted external sources for CSP directives.
44
72
  * Allows plugins to declare CDN sources needed for external scripts, styles, or network requests.
@@ -54,13 +82,15 @@ export interface MetadataPluginInfo {
54
82
  *
55
83
  * Plugins without trustedSources get strict CSP with no external script/network access.
56
84
  */
57
- trustedSources?: {
58
- /** HTTPS URLs to add to CSP script-src directive (e.g., 'https://cdn.jsdelivr.net') */
59
- scripts?: string[];
60
- /** HTTPS URLs to add to CSP style-src directive (e.g., 'https://fonts.googleapis.com') */
61
- styles?: string[];
62
- /** HTTPS URLs to add to CSP connect-src directive (e.g., 'https://api.example.com') */
63
- connect?: string[];
64
- };
85
+ trustedSources?: TrustedSources;
86
+ /**
87
+ * External sources approved specifically for in-memory payload rendering.
88
+ *
89
+ * Payload trust is reviewed independently: this field never inherits from
90
+ * {@link trustedSources}. Leaving it absent gives payload webviews the strict
91
+ * default CSP. This limits accidental webview egress; it is not a sandbox for
92
+ * malicious plugin package code, which already executes in the extension host.
93
+ */
94
+ payloadTrustedSources?: TrustedSources;
65
95
  }
66
96
  //# sourceMappingURL=MetadataPluginInfo.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"MetadataPluginInfo.d.ts","sourceRoot":"","sources":["../../../../src/sdk/contracts/types/MetadataPluginInfo.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf,wCAAwC;IACxC,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE;QACf,uFAAuF;QACvF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;QACnB,0FAA0F;QAC1F,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;QAClB,uFAAuF;QACvF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;KACpB,CAAC;CACH"}
1
+ {"version":3,"file":"MetadataPluginInfo.d.ts","sourceRoot":"","sources":["../../../../src/sdk/contracts/types/MetadataPluginInfo.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,wEAAwE;AACxE,MAAM,WAAW,cAAc;IAC7B,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,yFAAyF;IACzF,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,sFAAsF;IACtF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,EAAE,EAAE,MAAM,CAAC;IAEX,mBAAmB;IACnB,IAAI,EAAE,MAAM,CAAC;IAEb;;;OAGG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,kBAAkB;IAClB,MAAM,EAAE,MAAM,CAAC;IAEf;;;;;OAKG;IACH,YAAY,EAAE,MAAM,EAAE,CAAC;IAEvB;;;;OAIG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAElB;;;OAGG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;;;;;;OAYG;IACH,WAAW,CAAC,EAAE,OAAO,CAAC;IAEtB;;;;;;;;;;;;;;OAcG;IACH,cAAc,CAAC,EAAE,cAAc,CAAC;IAEhC;;;;;;;OAOG;IACH,qBAAqB,CAAC,EAAE,cAAc,CAAC;CACxC"}
@@ -12,6 +12,8 @@ import { PluginDataResponse, WebviewMessage } from '../webviewMessageTypes.js';
12
12
  declare global {
13
13
  interface Window {
14
14
  __ExtensionHostPostMessage?: (message: WebviewMessage) => void;
15
+ /** Immutable correlation id installed by hosts that support render scoping. */
16
+ __ExtensionHostExpectedRenderId?: string;
15
17
  }
16
18
  }
17
19
  /**
@@ -1 +1 @@
1
- {"version":3,"file":"HostCommunicationUtils.d.ts","sourceRoot":"","sources":["../../../src/sdk/utils/HostCommunicationUtils.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,EAAsB,kBAAkB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKnG;;;GAGG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,0BAA0B,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;KAChE;CACF;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAqC3D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAqDhG;AA2CD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAkBrF"}
1
+ {"version":3,"file":"HostCommunicationUtils.d.ts","sourceRoot":"","sources":["../../../src/sdk/utils/HostCommunicationUtils.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ,OAAO,EAAsB,kBAAkB,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAKnG;;;GAGG;AACH,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,MAAM;QACd,0BAA0B,CAAC,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,IAAI,CAAC;QAC/D,+EAA+E;QAC/E,+BAA+B,CAAC,EAAE,MAAM,CAAC;KAC1C;CACF;AAWD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,CAqC3D;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,aAAa,CAAC,SAAS,GAAE,MAAa,GAAG,OAAO,CAAC,kBAAkB,GAAG,IAAI,CAAC,CAwDhG;AA2CD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,CAAC,IAAI,EAAE,kBAAkB,KAAK,IAAI,GAAG,MAAM,IAAI,CAkBrF"}
@@ -7,6 +7,14 @@
7
7
  import { WebviewMessageType } from '../webviewMessageTypes.js';
8
8
  /** Single-flight guard: one in-flight getPluginData request at a time. */
9
9
  let inFlightPluginDataRequest = null;
10
+ /**
11
+ * Browser hosts do not install an expected id, so correlation is intentionally
12
+ * a no-op there. VS Code installs an immutable id in its page bootstrap.
13
+ */
14
+ function matchesExpectedRender(message) {
15
+ const expectedRenderId = window.__ExtensionHostExpectedRenderId;
16
+ return expectedRenderId === undefined || message.renderId === expectedRenderId;
17
+ }
10
18
  /**
11
19
  * Send a message to the host via the platform-agnostic postMessage function.
12
20
  * Platform implementations provide window.__ExtensionHostPostMessage (e.g., VS Code via vscodeHostApiBootstrap).
@@ -96,7 +104,8 @@ export async function getPluginData(timeoutMs = 5000) {
96
104
  return;
97
105
  }
98
106
  const message = event.data;
99
- if (message.type === WebviewMessageType.PLUGIN_DATA_RESPONSE) {
107
+ if (message.type === WebviewMessageType.PLUGIN_DATA_RESPONSE &&
108
+ matchesExpectedRender(message)) {
100
109
  cleanup();
101
110
  resolve(message.payload);
102
111
  }
@@ -193,7 +202,7 @@ export function onDataUpdate(callback) {
193
202
  return;
194
203
  }
195
204
  const message = event.data;
196
- if (message.type === WebviewMessageType.PLUGIN_DATA_UPDATE) {
205
+ if (message.type === WebviewMessageType.PLUGIN_DATA_UPDATE && matchesExpectedRender(message)) {
197
206
  const payload = message.payload;
198
207
  callback(payload);
199
208
  }
@@ -1 +1 @@
1
- {"version":3,"file":"HostCommunicationUtils.js","sourceRoot":"","sources":["../../../src/sdk/utils/HostCommunicationUtils.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"HostCommunicationUtils.js","sourceRoot":"","sources":["../../../src/sdk/utils/HostCommunicationUtils.ts"],"names":[],"mappings":"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"}
@@ -14,6 +14,8 @@ export declare const WebviewMessageType: {
14
14
  readonly PLUGIN_ERROR: "PLUGIN_ERROR";
15
15
  /** Retry visualization after error */
16
16
  readonly RETRY_VISUALIZATION: "RETRY_VISUALIZATION";
17
+ /** Close the correlated visualizer panel */
18
+ readonly CLOSE_VISUALIZER: "CLOSE_VISUALIZER";
17
19
  /** Copy stack trace to clipboard */
18
20
  readonly COPY_STACK_TRACE: "COPY_STACK_TRACE";
19
21
  /** Open settings panel */
@@ -41,16 +43,26 @@ export type WebviewMessageTypeValue = (typeof WebviewMessageType)[keyof typeof W
41
43
  * call sites that don't know the shape (host-side message routing, etc.)
42
44
  * keep working unchanged.
43
45
  */
46
+ export type PluginDataContext = {
47
+ kind: 'file';
48
+ filePath: string;
49
+ fileName: string;
50
+ } | {
51
+ kind: 'payload';
52
+ pluginId: string;
53
+ };
44
54
  export interface PluginDataResponse<T = unknown> {
45
55
  /** Plugin data */
46
56
  data: T;
47
- /** Plugin context (file path, file name) */
48
- context: {
49
- filePath: string;
50
- fileName: string;
51
- };
57
+ /** Source-aware plugin context. Payloads never expose a synthetic file path. */
58
+ context: PluginDataContext;
52
59
  /** Unique file ID for tracking file changes */
53
60
  fileId: string;
61
+ /**
62
+ * Monotonic within one render and reset when a new render starts. Consumers
63
+ * must use the surrounding message's renderId as the outer ordering key.
64
+ */
65
+ revision?: number;
54
66
  /**
55
67
  * SelectionGraph (C1): the flat, normalized selectable nodes for this file,
56
68
  * emitted by the parser's optional `getSelectableNodes()`. Optional — absent
@@ -131,5 +143,14 @@ export interface WebviewMessage {
131
143
  type: WebviewMessageTypeValue;
132
144
  /** Optional payload data (type depends on message type) */
133
145
  payload?: unknown;
146
+ /**
147
+ * Host-provided render correlation identifier.
148
+ *
149
+ * Optional in the platform-neutral contract because browser hosts do not yet
150
+ * implement render correlation. The VS Code bootstrap stamps this value onto
151
+ * every outbound message and filters scoped responses against its immutable
152
+ * expected value.
153
+ */
154
+ renderId?: string;
134
155
  }
135
156
  //# sourceMappingURL=webviewMessageTypes.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"webviewMessageTypes.d.ts","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;IAC7B,sEAAsE;;IAEtE,sCAAsC;;IAEtC,oCAAoC;;IAEpC,0BAA0B;;IAG1B,4CAA4C;;IAG5C,qEAAqE;;IAGrE,8EAA8E;;IAG9E;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAEnG;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,kBAAkB;IAClB,IAAI,EAAE,CAAC,CAAC;IACR,4CAA4C;IAC5C,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAC;QACjB,QAAQ,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,aAAqD,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB"}
1
+ {"version":3,"file":"webviewMessageTypes.d.ts","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAEJ;;;GAGG;AACH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AAE1E,eAAO,MAAM,kBAAkB;IAC7B,sEAAsE;;IAEtE,sCAAsC;;IAEtC,4CAA4C;;IAE5C,oCAAoC;;IAEpC,0BAA0B;;IAG1B,4CAA4C;;IAG5C,qEAAqE;;IAGrE,8EAA8E;;IAG9E;;;;;OAKG;;CAEK,CAAC;AAEX,MAAM,MAAM,uBAAuB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAEnG;;;;;;;GAOG;AACH,MAAM,MAAM,iBAAiB,GACzB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GACpD;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC;AAE1C,MAAM,WAAW,kBAAkB,CAAC,CAAC,GAAG,OAAO;IAC7C,kBAAkB;IAClB,IAAI,EAAE,CAAC,CAAC;IACR,gFAAgF;IAChF,OAAO,EAAE,iBAAiB,CAAC;IAC3B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,cAAc,EAAE,CAAC;CACpC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,cAAc;IAC7B,2EAA2E;IAC3E,WAAW,EAAE,MAAM,CAAC;IACpB,mFAAmF;IACnF,OAAO,EAAE,MAAM,CAAC;IAChB,sFAAsF;IACtF,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,2EAA2E;IAC3E,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,kEAAkE;IAClE,cAAc,CAAC,EAAE;QACf,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;KAChB,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,MAAM,EAAE,MAAM,CAAC;IACf,yEAAyE;IACzE,WAAW,EAAE,cAAc,EAAE,CAAC;CAC/B;AAED;;;;;;GAMG;AACH,MAAM,WAAW,iBAAiB;IAChC,sEAAsE;IACtE,SAAS,EAAE,OAAO,CAAC;IACnB,uCAAuC;IACvC,OAAO,EAAE,cAAc,GAAG,WAAW,GAAG,WAAW,GAAG,MAAM,CAAC;IAC7D,uEAAuE;IACvE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,8DAA8D;AAC9D,eAAO,MAAM,mBAAmB,aAAqD,CAAC;AAEtF;;GAEG;AACH,MAAM,WAAW,cAAc;IAC7B,iCAAiC;IACjC,IAAI,EAAE,uBAAuB,CAAC;IAC9B,2DAA2D;IAC3D,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB;;;;;;;OAOG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB"}
@@ -9,6 +9,8 @@ export const WebviewMessageType = {
9
9
  PLUGIN_ERROR: 'PLUGIN_ERROR',
10
10
  /** Retry visualization after error */
11
11
  RETRY_VISUALIZATION: 'RETRY_VISUALIZATION',
12
+ /** Close the correlated visualizer panel */
13
+ CLOSE_VISUALIZER: 'CLOSE_VISUALIZER',
12
14
  /** Copy stack trace to clipboard */
13
15
  COPY_STACK_TRACE: 'COPY_STACK_TRACE',
14
16
  /** Open settings panel */
@@ -1 +1 @@
1
- {"version":3,"file":"webviewMessageTypes.js","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAQJ,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,sEAAsE;IACtE,YAAY,EAAE,cAAc;IAC5B,sCAAsC;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,oCAAoC;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,0BAA0B;IAC1B,aAAa,EAAE,cAAc;IAE7B,4CAA4C;IAC5C,mBAAmB,EAAE,qBAAqB;IAE1C,qEAAqE;IACrE,oBAAoB,EAAE,sBAAsB;IAE5C,8EAA8E;IAC9E,kBAAkB,EAAE,oBAAoB;IAExC;;;;;OAKG;IACH,WAAW,EAAE,aAAa;CAClB,CAAC;AAgGX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"webviewMessageTypes.js","sourceRoot":"","sources":["../../src/sdk/webviewMessageTypes.ts"],"names":[],"mappings":"AAAA;;;;;IAKI;AAQJ,MAAM,CAAC,MAAM,kBAAkB,GAAG;IAChC,sEAAsE;IACtE,YAAY,EAAE,cAAc;IAC5B,sCAAsC;IACtC,mBAAmB,EAAE,qBAAqB;IAC1C,4CAA4C;IAC5C,gBAAgB,EAAE,kBAAkB;IACpC,oCAAoC;IACpC,gBAAgB,EAAE,kBAAkB;IACpC,0BAA0B;IAC1B,aAAa,EAAE,cAAc;IAE7B,4CAA4C;IAC5C,mBAAmB,EAAE,qBAAqB;IAE1C,qEAAqE;IACrE,oBAAoB,EAAE,sBAAsB;IAE5C,8EAA8E;IAC9E,kBAAkB,EAAE,oBAAoB;IAExC;;;;;OAKG;IACH,WAAW,EAAE,aAAa;CAClB,CAAC;AAsGX,8DAA8D;AAC9D,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAS,MAAM,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@salesforce/metadata-core-sdk",
3
- "version": "1.6.0",
3
+ "version": "1.7.0",
4
4
  "description": "Core SDK with shared contracts and platform abstractions for visualization plugins",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",