@chili-publish/studio-sdk 1.44.1 → 1.46.0

package/lib/src/sdk.cjs.js.map

@@ -1 +1 @@
-{"version":3,"file":"sdk.cjs.js","sources":["../../src/sdk.ts"],"sourcesContent":["import { Connection } from 'penpal';\nimport engineInfo from '../editor-engine.json';\nimport packageInfo from '../package.json';\nimport Connect from './interactions/Connector';\nimport { defaultStudioOptions, WellKnownConfigurationKeys } from './types/ConfigurationTypes';\n\nimport type { ConfigType, EditorAPI, RuntimeConfigType } from './types/CommonTypes';\nimport { DocumentType } from './types/DocumentTypes';\n\nimport { ActionController } from './controllers/ActionController';\nimport { AnimationController } from './controllers/AnimationController';\nimport { BarcodeController } from './controllers/BarcodeController';\nimport { BrandKitController } from './controllers/BrandKitController';\nimport { CanvasController } from './controllers/CanvasController';\nimport { CharacterStyleController } from './controllers/CharacterStyleController';\nimport { ClipboardController } from './controllers/ClipboardController';\nimport { ColorConversionController } from './controllers/ColorConversionController';\nimport { ColorStyleController } from './controllers/ColorStyleController';\nimport { ConfigurationController } from './controllers/ConfigurationController';\nimport { ConnectorController } from './controllers/ConnectorController';\nimport { DataConnectorController } from './controllers/DataConnectorController';\nimport { DataSourceController } from './controllers/DataSourceController';\nimport { DebugController } from './controllers/DebugController';\nimport { DocumentController } from './controllers/DocumentController';\nimport { ExperimentController } from './controllers/ExperimentController';\nimport { FontConnectorController } from './controllers/FontConnectorController';\nimport { FontController } from './controllers/FontController';\nimport { FrameController } from './controllers/FrameController';\nimport { InfoController } from './controllers/InfoController';\nimport { LayoutController } from './controllers/LayoutController';\nimport { MediaConnectorController } from './controllers/MediaConnectorController';\nimport { PageController } from './controllers/PageController';\nimport { ParagraphStyleController } from './controllers/ParagraphStyleController';\nimport { ShapeController } from './controllers/ShapeController';\nimport { SubscriberController } from './controllers/SubscriberController';\nimport { TextStyleController } from './controllers/TextStyleController';\nimport { ToolController } from './controllers/ToolController';\nimport { UndoManagerController } from './controllers/UndoManagerController';\nimport { UtilsController } from './controllers/UtilsController';\nimport { VariableController } from './controllers/VariableController';\nimport { NextSubscribers } from './next';\nimport { NextInitiator } from './next/NextInitiator';\nimport { ConfigHelper } from './utils/ConfigHelper';\nimport { DataItemMappingTools } from './utils/DataItemMappingTools';\nimport { LocalConfigurationDecorator } from './utils/LocalConfigurationDecorator';\nimport { GradientStyleController } from './controllers/GradientStyleController';\nimport { ComponentConnectorController } from './controllers/ComponentConnectorController';\nimport { ComponentController } from './controllers/ComponentController';\nimport { ComponentGridController } from './controllers/ComponentGridController';\n\ndeclare const __ENGINE_DOMAIN__: string;\nconst ENGINE_DOMAIN = typeof __ENGINE_DOMAIN__ !== 'undefined' ? __ENGINE_DOMAIN__ : 'studio-cdn.chiligrafx.com';\nconst FIXED_EDITOR_LINK = `https://${ENGINE_DOMAIN}/editor/${engineInfo.current}/web`;\n\nlet connection: Connection;\n\nexport class SDK {\n    config: RuntimeConfigType;\n    connection: Connection;\n\n    /**\n     * @ignore\n     */\n    editorAPI: EditorAPI;\n\n    action: ActionController;\n    layout: LayoutController;\n    frame: FrameController;\n    shape: ShapeController;\n    barcode: BarcodeController;\n    /** @experimental */\n    component: ComponentController;\n    connector: ConnectorController;\n    mediaConnector: MediaConnectorController;\n    fontConnector: FontConnectorController;\n    /**\n     * @experimental This controller is still experimental and might change in future releases.\n     */\n    componentConnector: ComponentConnectorController;\n    dataConnector: DataConnectorController;\n    dataSource: DataSourceController;\n    animation: AnimationController;\n    document: DocumentController;\n    configuration: ConfigurationController;\n    variable: VariableController;\n    utils: UtilsController;\n    tool: ToolController;\n    page: PageController;\n    debug: DebugController;\n    undoManager: UndoManagerController;\n    textSelection: TextStyleController;\n    paragraphStyle: ParagraphStyleController;\n    characterStyle: CharacterStyleController;\n    colorStyle: ColorStyleController;\n    gradientStyle: GradientStyleController;\n    font: FontController;\n    experiment: ExperimentController;\n    canvas: CanvasController;\n    colorConversion: ColorConversionController;\n    info: InfoController;\n    clipboard: ClipboardController;\n    brandKit: BrandKitController;\n    componentGrid: ComponentGridController;\n    next: NextInitiator;\n\n    private subscriber: SubscriberController;\n    private enabledNextSubscribers: NextSubscribers | undefined;\n    private localConfig = new Map<string, string>();\n    private dataItemMappingTools = new DataItemMappingTools();\n\n    /**\n     * The SDK should be configured clientside and it exposes all controllers to work with in other applications\n     * @param config The configuration object where the SDK and editor can get configured\n     */\n    constructor(config: ConfigType) {\n        this.config = ConfigHelper.createRuntimeConfig(config);\n\n        this.connection = connection;\n        this.editorAPI = connection?.promise.then((child) => {\n            return child;\n        }) as unknown as EditorAPI;\n\n        this.action = new ActionController(this.editorAPI);\n        this.layout = new LayoutController(this.editorAPI);\n        this.frame = new FrameController(this.editorAPI);\n        this.shape = new ShapeController(this.editorAPI);\n        this.barcode = new BarcodeController(this.editorAPI);\n        this.component = new ComponentController(this.editorAPI);\n        this.undoManager = new UndoManagerController(this.editorAPI, this);\n        this.connector = new ConnectorController(this.editorAPI, this.localConfig);\n        this.mediaConnector = new MediaConnectorController(this.editorAPI);\n        this.fontConnector = new FontConnectorController(this.editorAPI);\n        this.componentConnector = new ComponentConnectorController(this.editorAPI);\n        this.dataConnector = new DataConnectorController(this.editorAPI, this.dataItemMappingTools);\n        this.dataSource = new DataSourceController(this.editorAPI, this.dataItemMappingTools);\n        this.animation = new AnimationController(this.editorAPI);\n        this.document = new DocumentController(this.editorAPI);\n\n        this.configuration = new LocalConfigurationDecorator(this.editorAPI, this.localConfig);\n        this.variable = new VariableController(this.editorAPI, this.dataItemMappingTools);\n        this.utils = new UtilsController(this.editorAPI, this.localConfig);\n        this.subscriber = new SubscriberController(this.config, this.localConfig);\n        this.tool = new ToolController(this.editorAPI);\n        this.page = new PageController(this.editorAPI);\n        this.debug = new DebugController(this.editorAPI);\n        // To be renamed textSelection > textStyle\n        this.textSelection = new TextStyleController(this.editorAPI);\n        this.colorStyle = new ColorStyleController(this.editorAPI);\n        this.gradientStyle = new GradientStyleController(this.editorAPI);\n        this.paragraphStyle = new ParagraphStyleController(this.editorAPI);\n        this.characterStyle = new CharacterStyleController(this.editorAPI);\n        this.font = new FontController(this.editorAPI);\n        this.experiment = new ExperimentController(this.editorAPI);\n        this.canvas = new CanvasController(this.editorAPI);\n        this.colorConversion = new ColorConversionController(this.editorAPI);\n        this.info = new InfoController();\n        this.clipboard = new ClipboardController(this.editorAPI);\n        this.next = new NextInitiator(this.config, this.connection, this.editorAPI);\n        this.enabledNextSubscribers = this.config.enableNextSubscribers;\n        this.brandKit = new BrandKitController(this.editorAPI, this);\n        this.componentGrid = new ComponentGridController(this.editorAPI);\n    }\n\n    /**\n     * This method will initiate the editor, running this will result in the editor restarting\n     * It will generate an iframe in the document\n     */\n    loadEditor = () => {\n        Connect(\n            this.config.editorLink || FIXED_EDITOR_LINK,\n            {\n                onActionsChanged: this.subscriber.onActionsChanged,\n                onStateChanged: this.subscriber.onStateChanged,\n                onAuthExpired: this.subscriber.onAuthExpired,\n                onViewportRequested: this.subscriber.onViewportRequested,\n                onDocumentLoaded: this.subscriber.onDocumentLoaded,\n                onSelectedFramesContentChanged: this.subscriber.onSelectedFramesContentChanged,\n                onSelectedFramesLayoutChanged: this.subscriber.onSelectedFramesLayoutChanged,\n                onFramesLayoutChanged: this.subscriber.onFramesLayoutChanged,\n                onSelectedLayoutPropertiesChanged: this.subscriber.onSelectedLayoutPropertiesChanged,\n                onSelectedLayoutUnitChanged: this.subscriber.onSelectedLayoutUnitChanged,\n                onPageSelectionChanged: this.subscriber.onPageSelectionChanged,\n                onScrubberPositionChanged: this.subscriber.onAnimationPlaybackChanged,\n                onFrameAnimationsChanged: this.subscriber.onAnimationChanged,\n                onVariableListChanged: (state) => {\n                    if (this.enabledNextSubscribers?.onVariableListChanged) {\n                        this.next.subscriber.onVariableListChanged(state);\n                    } else {\n                        this.subscriber.onVariableListChanged(state);\n                    }\n                },\n                onSelectedToolChanged: this.subscriber.onSelectedToolChanged,\n                onUndoStateChanged: this.subscriber.onUndoStateChanged,\n                onSelectedLayoutFramesChanged: this.subscriber.onSelectedLayoutFramesChanged,\n                onSelectedTextStyleChanged: this.subscriber.onSelectedTextStyleChanged,\n                onColorsChanged: this.subscriber.onColorsChanged,\n                onParagraphStylesChanged: this.subscriber.onParagraphStylesChanged,\n                onCharacterStylesChanged: this.subscriber.onCharacterStylesChanged,\n                onFontFamiliesChanged: this.subscriber.onFontFamiliesChanged,\n                onSelectedLayoutIdChanged: this.subscriber.onSelectedLayoutIdChanged,\n                onLayoutsChanged: this.subscriber.onLayoutsChanged,\n                onConnectorEvent: this.subscriber.onConnectorEvent,\n                onConnectorsChanged: (state) => {\n                    if (this.enabledNextSubscribers?.onConnectorsChanged) {\n                        this.next.subscriber.onConnectorsChanged(state);\n                    } else {\n                        this.subscriber.onConnectorsChanged(state);\n                    }\n                },\n                onZoomChanged: this.subscriber.onZoomChanged,\n                onSelectedPageIdChanged: this.subscriber.onSelectedPageIdChanged,\n                onPagesChanged: this.subscriber.onPagesChanged,\n                onPageSnapshotInvalidated: this.subscriber.onPageSnapshotInvalidated,\n                onPageSizeChanged: (state) => {\n                    if (this.enabledNextSubscribers?.onPageSizeChanged) {\n                        this.next.subscriber.onPageSizeChanged(state);\n                    } else {\n                        this.subscriber.onPageSizeChanged(state);\n                    }\n                },\n                onShapeCornerRadiusChanged: this.subscriber.onShapeCornerRadiusChanged,\n                onCropActiveFrameIdChanged: this.subscriber.onCropActiveFrameIdChanged,\n                onAsyncError: this.subscriber.onAsyncError,\n                onViewModeChanged: this.subscriber.onViewModeChanged,\n                onBarcodeValidationChanged: this.subscriber.onBarcodeValidationChanged,\n                onDataSourceIdChanged: this.subscriber.onDataSourceIdChanged,\n                onInjectedDataChanged: this.subscriber.onInjectedDataChanged,\n                onDocumentIssueListChanged: this.subscriber.onDocumentIssueListChanged,\n                onCustomUndoDataChanged: this.subscriber.onCustomUndoDataChanged,\n                onEngineEditModeChanged: this.subscriber.onEngineEditModeChanged,\n                onBrandKitMediaChanged: this.subscriber.onBrandKitMediaChanged,\n            },\n            this.setConnection,\n            this.config.editorId,\n            this.config.studioStyling,\n            (error) => {\n                this.config.onConnectionError?.(error);\n            },\n        );\n        this.editorAPI = connection?.promise.then((editorAPI) => {\n            return editorAPI;\n        }) as unknown as EditorAPI;\n\n        this.action = new ActionController(this.editorAPI);\n        this.layout = new LayoutController(this.editorAPI);\n        this.frame = new FrameController(this.editorAPI);\n        this.barcode = new BarcodeController(this.editorAPI);\n        this.component = new ComponentController(this.editorAPI);\n        this.animation = new AnimationController(this.editorAPI);\n        this.document = new DocumentController(this.editorAPI);\n        this.configuration = new LocalConfigurationDecorator(this.editorAPI, this.localConfig);\n        this.utils = new UtilsController(this.editorAPI, this.localConfig);\n        this.tool = new ToolController(this.editorAPI);\n        this.page = new PageController(this.editorAPI);\n        this.debug = new DebugController(this.editorAPI);\n        this.undoManager = new UndoManagerController(this.editorAPI, this);\n        this.textSelection = new TextStyleController(this.editorAPI);\n        this.colorStyle = new ColorStyleController(this.editorAPI);\n        this.gradientStyle = new GradientStyleController(this.editorAPI);\n        this.paragraphStyle = new ParagraphStyleController(this.editorAPI);\n        this.characterStyle = new CharacterStyleController(this.editorAPI);\n        this.mediaConnector = new MediaConnectorController(this.editorAPI);\n        this.fontConnector = new FontConnectorController(this.editorAPI);\n        this.componentConnector = new ComponentConnectorController(this.editorAPI);\n        this.dataConnector = new DataConnectorController(this.editorAPI, this.dataItemMappingTools);\n        this.dataSource = new DataSourceController(this.editorAPI, this.dataItemMappingTools);\n        this.connector = new ConnectorController(this.editorAPI, this.localConfig);\n        this.variable = new VariableController(this.editorAPI, this.dataItemMappingTools);\n        this.font = new FontController(this.editorAPI);\n        this.experiment = new ExperimentController(this.editorAPI);\n        this.canvas = new CanvasController(this.editorAPI);\n        this.shape = new ShapeController(this.editorAPI);\n        this.colorConversion = new ColorConversionController(this.editorAPI);\n        this.info = new InfoController();\n        this.clipboard = new ClipboardController(this.editorAPI);\n        this.brandKit = new BrandKitController(this.editorAPI, this);\n        this.componentGrid = new ComponentGridController(this.editorAPI);\n        this.next = new NextInitiator(this.config, this.connection, this.editorAPI);\n\n        // as soon as the editor loads, provide it with the SDK version\n        // used to make it start. This enables engine compatibility checks\n        // on the Flutter side\n        this.configuration.setValue(WellKnownConfigurationKeys.GraFxStudioSdkVersion, packageInfo.version);\n\n        // Makes the engine aware which document type it should render, if this call\n        // isn't made, the engine will fall back to the type specified in the document.\n        //\n        // Loading a template JSON and setting the engine to `project` will cause\n        // the document JSON structure to be converted to a project on save.\n        // Using `getCurrentDocumentState` will also output the converted document.\n        this.configuration.setValue(\n            WellKnownConfigurationKeys.GraFxStudioDocumentType,\n            this.config.documentType || DocumentType.template,\n        );\n\n        // Update the engine with the specified options from the config or fall back to the defaults.\n        this.configuration.updateStudioOptions(this.config.studioOptions || defaultStudioOptions);\n\n        // Whether the engine should cache query calls. This is disabled by default.\n        this.configuration.setValue(\n            WellKnownConfigurationKeys.QueryCallCacheEnabled,\n            this.config.enableQueryCallCache?.toString() || 'false',\n        );\n    };\n\n    setConnection = (newConnection: Connection) => {\n        connection = newConnection;\n    };\n}\n\nexport default SDK;\n"],"names":["engineInfo","DataItemMappingTools","Connect","_a","ActionController","LayoutController","FrameController","BarcodeController","ComponentController","AnimationController","DocumentController","LocalConfigurationDecorator","UtilsController","ToolController","PageController","DebugController","UndoManagerController","TextStyleController","ColorStyleController","GradientStyleController","ParagraphStyleController","CharacterStyleController","MediaConnectorController","FontConnectorController","ComponentConnectorController","DataConnectorController","DataSourceController","ConnectorController","VariableController","FontController","ExperimentController","CanvasController","ShapeController","ColorConversionController","InfoController","ClipboardController","BrandKitController","ComponentGridController","NextInitiator","WellKnownConfigurationKeys","packageInfo","DocumentType","defaultStudioOptions","ConfigHelper","SubscriberController"],"mappings":"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"}
+{"version":3,"file":"sdk.cjs.js","sources":["../../src/sdk.ts"],"sourcesContent":["import { Connection } from 'penpal';\nimport engineInfo from '../editor-engine.json';\nimport packageInfo from '../package.json';\nimport Connect from './interactions/Connector';\nimport { defaultStudioOptions, WellKnownConfigurationKeys } from './types/ConfigurationTypes';\n\nimport type { ConfigType, EditorAPI, RuntimeConfigType } from './types/CommonTypes';\nimport { Instrumented } from './types/MethodInvocationTypes';\nimport { DocumentType } from './types/DocumentTypes';\n\nimport { ActionController } from './controllers/ActionController';\nimport { AnimationController } from './controllers/AnimationController';\nimport { BarcodeController } from './controllers/BarcodeController';\nimport { BrandKitController } from './controllers/BrandKitController';\nimport { CanvasController } from './controllers/CanvasController';\nimport { CharacterStyleController } from './controllers/CharacterStyleController';\nimport { ClipboardController } from './controllers/ClipboardController';\nimport { ColorConversionController } from './controllers/ColorConversionController';\nimport { ColorStyleController } from './controllers/ColorStyleController';\nimport { ConfigurationController } from './controllers/ConfigurationController';\nimport { ConnectorController } from './controllers/ConnectorController';\nimport { DataConnectorController } from './controllers/DataConnectorController';\nimport { DataSourceController } from './controllers/DataSourceController';\nimport { DebugController } from './controllers/DebugController';\nimport { DocumentController } from './controllers/DocumentController';\nimport { ExperimentController } from './controllers/ExperimentController';\nimport { FontConnectorController } from './controllers/FontConnectorController';\nimport { FontController } from './controllers/FontController';\nimport { FrameController } from './controllers/FrameController';\nimport { InfoController } from './controllers/InfoController';\nimport { LayoutController } from './controllers/LayoutController';\nimport { MediaConnectorController } from './controllers/MediaConnectorController';\nimport { PageController } from './controllers/PageController';\nimport { ParagraphStyleController } from './controllers/ParagraphStyleController';\nimport { ShapeController } from './controllers/ShapeController';\nimport { SubscriberController } from './controllers/SubscriberController';\nimport { TextStyleController } from './controllers/TextStyleController';\nimport { ToolController } from './controllers/ToolController';\nimport { UndoManagerController } from './controllers/UndoManagerController';\nimport { UtilsController } from './controllers/UtilsController';\nimport { VariableController } from './controllers/VariableController';\nimport { NextSubscribers } from './next';\nimport { NextInitiator } from './next/NextInitiator';\nimport { ConfigHelper } from './utils/ConfigHelper';\nimport { DataItemMappingTools } from './utils/DataItemMappingTools';\nimport { LocalConfigurationDecorator } from './utils/LocalConfigurationDecorator';\nimport { GradientStyleController } from './controllers/GradientStyleController';\nimport { ComponentConnectorController } from './controllers/ComponentConnectorController';\nimport { ComponentController } from './controllers/ComponentController';\nimport { ComponentGridController } from './controllers/ComponentGridController';\nimport { MethodListenerRegistry, wrapWithInvocationObserver } from './utils/MethodInstrumentation';\nimport { SdkEvents } from './utils/SdkEvents';\n\ndeclare const __ENGINE_DOMAIN__: string;\nconst ENGINE_DOMAIN = typeof __ENGINE_DOMAIN__ !== 'undefined' ? __ENGINE_DOMAIN__ : 'studio-cdn.chiligrafx.com';\nconst FIXED_EDITOR_LINK = `https://${ENGINE_DOMAIN}/editor/${engineInfo.current}/web`;\n\nlet connection: Connection;\n\n// Marks a freshly created controller as \"needs instrumentation\" without requiring\n// its property name to be tracked anywhere. `applyMethodInstrumentation` later scans\n// the SDK instance for properties carrying this marker and wraps them automatically,\n// so a controller can never be silently skipped just because a list wasn't updated.\nconst PENDING_INSTRUMENTATION = Symbol('pendingInstrumentation');\n\nconst markForInstrumentation = (controller: object): void => {\n    Object.defineProperty(controller, PENDING_INSTRUMENTATION, {\n        value: true,\n        enumerable: false,\n        configurable: true,\n    });\n};\n\nconst isPendingInstrumentation = (value: unknown): value is object => {\n    return typeof value === 'object' && value !== null && (value as Record<symbol, unknown>)[PENDING_INSTRUMENTATION] === true;\n};\n\nexport class SDK {\n    config: RuntimeConfigType;\n    connection: Connection;\n\n    /**\n     * @ignore\n     */\n    editorAPI: EditorAPI;\n    /**\n     * SDK method invocation events.\n     *\n     * Use this to observe which SDK controller method was called and with which parameters/result.\n     * These are SDK-level events (SDK -> consumer), separate from engine subscriber events (`config.events`).\n     */\n    sdkEvents: SdkEvents;\n\n    action: Instrumented<ActionController>;\n    layout: Instrumented<LayoutController>;\n    frame: Instrumented<FrameController>;\n    shape: Instrumented<ShapeController>;\n    barcode: Instrumented<BarcodeController>;\n    /** @experimental */\n    component: Instrumented<ComponentController>;\n    connector: Instrumented<ConnectorController>;\n    mediaConnector: Instrumented<MediaConnectorController>;\n    fontConnector: Instrumented<FontConnectorController>;\n    /**\n     * @experimental This controller is still experimental and might change in future releases.\n     */\n    componentConnector: Instrumented<ComponentConnectorController>;\n    dataConnector: Instrumented<DataConnectorController>;\n    dataSource: Instrumented<DataSourceController>;\n    animation: Instrumented<AnimationController>;\n    document: Instrumented<DocumentController>;\n    configuration: Instrumented<ConfigurationController>;\n    variable: Instrumented<VariableController>;\n    utils: Instrumented<UtilsController>;\n    tool: Instrumented<ToolController>;\n    page: Instrumented<PageController>;\n    debug: Instrumented<DebugController>;\n    undoManager: Instrumented<UndoManagerController>;\n    textSelection: Instrumented<TextStyleController>;\n    paragraphStyle: Instrumented<ParagraphStyleController>;\n    characterStyle: Instrumented<CharacterStyleController>;\n    colorStyle: Instrumented<ColorStyleController>;\n    gradientStyle: Instrumented<GradientStyleController>;\n    font: Instrumented<FontController>;\n    experiment: Instrumented<ExperimentController>;\n    canvas: Instrumented<CanvasController>;\n    colorConversion: Instrumented<ColorConversionController>;\n    info: Instrumented<InfoController>;\n    clipboard: Instrumented<ClipboardController>;\n    brandKit: Instrumented<BrandKitController>;\n    componentGrid: Instrumented<ComponentGridController>;\n\n    next: NextInitiator;\n\n    private subscriber: SubscriberController;\n    private enabledNextSubscribers: NextSubscribers | undefined;\n    private localConfig = new Map<string, string>();\n    private dataItemMappingTools = new DataItemMappingTools();\n    private methodListeners = new MethodListenerRegistry();\n\n    /**\n     * The SDK should be configured clientside and it exposes all controllers to work with in other applications\n     * @param config The configuration object where the SDK and editor can get configured\n     */\n    constructor(config: ConfigType) {\n        this.config = ConfigHelper.createRuntimeConfig(config);\n        this.sdkEvents = new SdkEvents(this.config.logging?.logger);\n\n        this.connection = connection;\n        this.editorAPI = connection?.promise.then((child: unknown) => {\n            return child;\n        }) as unknown as EditorAPI;\n\n        this.action = this.toInstrumented(new ActionController(this.editorAPI));\n        this.layout = this.toInstrumented(new LayoutController(this.editorAPI));\n        this.frame = this.toInstrumented(new FrameController(this.editorAPI));\n        this.shape = this.toInstrumented(new ShapeController(this.editorAPI));\n        this.barcode = this.toInstrumented(new BarcodeController(this.editorAPI));\n        this.component = this.toInstrumented(new ComponentController(this.editorAPI));\n        this.undoManager = this.toInstrumented(new UndoManagerController(this.editorAPI, this));\n        this.connector = this.toInstrumented(new ConnectorController(this.editorAPI, this.localConfig));\n        this.mediaConnector = this.toInstrumented(new MediaConnectorController(this.editorAPI));\n        this.fontConnector = this.toInstrumented(new FontConnectorController(this.editorAPI));\n        this.componentConnector = this.toInstrumented(new ComponentConnectorController(this.editorAPI));\n        this.dataConnector = this.toInstrumented(new DataConnectorController(this.editorAPI, this.dataItemMappingTools));\n        this.dataSource = this.toInstrumented(new DataSourceController(this.editorAPI, this.dataItemMappingTools));\n        this.animation = this.toInstrumented(new AnimationController(this.editorAPI));\n        this.document = this.toInstrumented(new DocumentController(this.editorAPI));\n\n        this.configuration = this.toInstrumented(new LocalConfigurationDecorator(this.editorAPI, this.localConfig));\n        this.variable = this.toInstrumented(new VariableController(this.editorAPI, this.dataItemMappingTools));\n        this.utils = this.toInstrumented(new UtilsController(this.editorAPI, this.localConfig));\n        this.subscriber = new SubscriberController(this.config, this.localConfig);\n        this.tool = this.toInstrumented(new ToolController(this.editorAPI));\n        this.page = this.toInstrumented(new PageController(this.editorAPI));\n        this.debug = this.toInstrumented(new DebugController(this.editorAPI));\n        // To be renamed textSelection > textStyle\n        this.textSelection = this.toInstrumented(new TextStyleController(this.editorAPI));\n        this.colorStyle = this.toInstrumented(new ColorStyleController(this.editorAPI));\n        this.gradientStyle = this.toInstrumented(new GradientStyleController(this.editorAPI));\n        this.paragraphStyle = this.toInstrumented(new ParagraphStyleController(this.editorAPI));\n        this.characterStyle = this.toInstrumented(new CharacterStyleController(this.editorAPI));\n        this.font = this.toInstrumented(new FontController(this.editorAPI));\n        this.experiment = this.toInstrumented(new ExperimentController(this.editorAPI));\n        this.canvas = this.toInstrumented(new CanvasController(this.editorAPI));\n        this.colorConversion = this.toInstrumented(new ColorConversionController(this.editorAPI));\n        this.info = this.toInstrumented(new InfoController());\n        this.clipboard = this.toInstrumented(new ClipboardController(this.editorAPI));\n        this.next = new NextInitiator(this.config, this.connection, this.editorAPI);\n        this.enabledNextSubscribers = this.config.enableNextSubscribers;\n        this.brandKit = this.toInstrumented(new BrandKitController(this.editorAPI, this));\n        this.componentGrid = this.toInstrumented(new ComponentGridController(this.editorAPI));\n\n        this.applyMethodInstrumentation();\n    }\n\n    /**\n     * This method will initiate the editor, running this will result in the editor restarting\n     * It will generate an iframe in the document\n     */\n    loadEditor = () => {\n        Connect(\n            this.config.editorLink || FIXED_EDITOR_LINK,\n            {\n                onActionsChanged: this.subscriber.onActionsChanged,\n                onStateChanged: this.subscriber.onStateChanged,\n                onAuthExpired: this.subscriber.onAuthExpired,\n                onViewportRequested: this.subscriber.onViewportRequested,\n                onDocumentLoaded: this.subscriber.onDocumentLoaded,\n                onSelectedFramesContentChanged: this.subscriber.onSelectedFramesContentChanged,\n                onSelectedFramesLayoutChanged: this.subscriber.onSelectedFramesLayoutChanged,\n                onFramesLayoutChanged: this.subscriber.onFramesLayoutChanged,\n                onSelectedLayoutPropertiesChanged: this.subscriber.onSelectedLayoutPropertiesChanged,\n                onSelectedLayoutUnitChanged: this.subscriber.onSelectedLayoutUnitChanged,\n                onPageSelectionChanged: this.subscriber.onPageSelectionChanged,\n                onScrubberPositionChanged: this.subscriber.onAnimationPlaybackChanged,\n                onFrameAnimationsChanged: this.subscriber.onAnimationChanged,\n                onVariableListChanged: (state) => {\n                    if (this.enabledNextSubscribers?.onVariableListChanged) {\n                        this.next.subscriber.onVariableListChanged(state);\n                    } else {\n                        this.subscriber.onVariableListChanged(state);\n                    }\n                },\n                onSelectedToolChanged: this.subscriber.onSelectedToolChanged,\n                onUndoStateChanged: this.subscriber.onUndoStateChanged,\n                onSelectedLayoutFramesChanged: this.subscriber.onSelectedLayoutFramesChanged,\n                onSelectedTextStyleChanged: this.subscriber.onSelectedTextStyleChanged,\n                onColorsChanged: this.subscriber.onColorsChanged,\n                onParagraphStylesChanged: this.subscriber.onParagraphStylesChanged,\n                onCharacterStylesChanged: this.subscriber.onCharacterStylesChanged,\n                onFontFamiliesChanged: this.subscriber.onFontFamiliesChanged,\n                onSelectedLayoutIdChanged: this.subscriber.onSelectedLayoutIdChanged,\n                onLayoutsChanged: this.subscriber.onLayoutsChanged,\n                onConnectorEvent: this.subscriber.onConnectorEvent,\n                onConnectorsChanged: (state) => {\n                    if (this.enabledNextSubscribers?.onConnectorsChanged) {\n                        this.next.subscriber.onConnectorsChanged(state);\n                    } else {\n                        this.subscriber.onConnectorsChanged(state);\n                    }\n                },\n                onZoomChanged: this.subscriber.onZoomChanged,\n                onSelectedPageIdChanged: this.subscriber.onSelectedPageIdChanged,\n                onPagesChanged: this.subscriber.onPagesChanged,\n                onPageSnapshotInvalidated: this.subscriber.onPageSnapshotInvalidated,\n                onPageSizeChanged: (state) => {\n                    if (this.enabledNextSubscribers?.onPageSizeChanged) {\n                        this.next.subscriber.onPageSizeChanged(state);\n                    } else {\n                        this.subscriber.onPageSizeChanged(state);\n                    }\n                },\n                onShapeCornerRadiusChanged: this.subscriber.onShapeCornerRadiusChanged,\n                onCropActiveFrameIdChanged: this.subscriber.onCropActiveFrameIdChanged,\n                onAsyncError: this.subscriber.onAsyncError,\n                onViewModeChanged: this.subscriber.onViewModeChanged,\n                onBarcodeValidationChanged: this.subscriber.onBarcodeValidationChanged,\n                onDataSourceIdChanged: this.subscriber.onDataSourceIdChanged,\n                onInjectedDataChanged: this.subscriber.onInjectedDataChanged,\n                onDocumentIssueListChanged: this.subscriber.onDocumentIssueListChanged,\n                onCustomUndoDataChanged: this.subscriber.onCustomUndoDataChanged,\n                onEngineEditModeChanged: this.subscriber.onEngineEditModeChanged,\n                onBrandKitMediaChanged: this.subscriber.onBrandKitMediaChanged,\n                onCanvasFramesManipulated: this.subscriber.onCanvasFramesManipulated,\n            },\n            this.setConnection,\n            this.config.editorId,\n            this.config.studioStyling,\n            (error) => {\n                this.config.onConnectionError?.(error);\n            },\n        );\n        this.editorAPI = connection?.promise.then((editorAPI: unknown) => {\n            return editorAPI;\n        }) as unknown as EditorAPI;\n\n        this.action = this.toInstrumented(new ActionController(this.editorAPI));\n        this.layout = this.toInstrumented(new LayoutController(this.editorAPI));\n        this.frame = this.toInstrumented(new FrameController(this.editorAPI));\n        this.barcode = this.toInstrumented(new BarcodeController(this.editorAPI));\n        this.component = this.toInstrumented(new ComponentController(this.editorAPI));\n        this.animation = this.toInstrumented(new AnimationController(this.editorAPI));\n        this.document = this.toInstrumented(new DocumentController(this.editorAPI));\n        this.configuration = this.toInstrumented(new LocalConfigurationDecorator(this.editorAPI, this.localConfig));\n        this.utils = this.toInstrumented(new UtilsController(this.editorAPI, this.localConfig));\n        this.tool = this.toInstrumented(new ToolController(this.editorAPI));\n        this.page = this.toInstrumented(new PageController(this.editorAPI));\n        this.debug = this.toInstrumented(new DebugController(this.editorAPI));\n        this.undoManager = this.toInstrumented(new UndoManagerController(this.editorAPI, this));\n        this.textSelection = this.toInstrumented(new TextStyleController(this.editorAPI));\n        this.colorStyle = this.toInstrumented(new ColorStyleController(this.editorAPI));\n        this.gradientStyle = this.toInstrumented(new GradientStyleController(this.editorAPI));\n        this.paragraphStyle = this.toInstrumented(new ParagraphStyleController(this.editorAPI));\n        this.characterStyle = this.toInstrumented(new CharacterStyleController(this.editorAPI));\n        this.mediaConnector = this.toInstrumented(new MediaConnectorController(this.editorAPI));\n        this.fontConnector = this.toInstrumented(new FontConnectorController(this.editorAPI));\n        this.componentConnector = this.toInstrumented(new ComponentConnectorController(this.editorAPI));\n        this.dataConnector = this.toInstrumented(new DataConnectorController(this.editorAPI, this.dataItemMappingTools));\n        this.dataSource = this.toInstrumented(new DataSourceController(this.editorAPI, this.dataItemMappingTools));\n        this.connector = this.toInstrumented(new ConnectorController(this.editorAPI, this.localConfig));\n        this.variable = this.toInstrumented(new VariableController(this.editorAPI, this.dataItemMappingTools));\n        this.font = this.toInstrumented(new FontController(this.editorAPI));\n        this.experiment = this.toInstrumented(new ExperimentController(this.editorAPI));\n        this.canvas = this.toInstrumented(new CanvasController(this.editorAPI));\n        this.shape = this.toInstrumented(new ShapeController(this.editorAPI));\n        this.colorConversion = this.toInstrumented(new ColorConversionController(this.editorAPI));\n        this.info = this.toInstrumented(new InfoController());\n        this.clipboard = this.toInstrumented(new ClipboardController(this.editorAPI));\n        this.brandKit = this.toInstrumented(new BrandKitController(this.editorAPI, this));\n        this.componentGrid = this.toInstrumented(new ComponentGridController(this.editorAPI));\n        this.next = new NextInitiator(this.config, this.connection, this.editorAPI);\n\n        this.applyMethodInstrumentation();\n\n        // as soon as the editor loads, provide it with the SDK version\n        // used to make it start. This enables engine compatibility checks\n        // on the Flutter side\n        this.configuration.setValue(WellKnownConfigurationKeys.GraFxStudioSdkVersion, packageInfo.version);\n\n        // Makes the engine aware which document type it should render, if this call\n        // isn't made, the engine will fall back to the type specified in the document.\n        //\n        // Loading a template JSON and setting the engine to `project` will cause\n        // the document JSON structure to be converted to a project on save.\n        // Using `getCurrentDocumentState` will also output the converted document.\n        this.configuration.setValue(\n            WellKnownConfigurationKeys.GraFxStudioDocumentType,\n            this.config.documentType || DocumentType.template,\n        );\n\n        // Update the engine with the specified options from the config or fall back to the defaults.\n        this.configuration.updateStudioOptions(this.config.studioOptions || defaultStudioOptions);\n\n        // Whether the engine should cache query calls. This is disabled by default.\n        this.configuration.setValue(\n            WellKnownConfigurationKeys.QueryCallCacheEnabled,\n            this.config.enableQueryCallCache?.toString() || 'false',\n        );\n    };\n\n    setConnection = (newConnection: Connection) => {\n        connection = newConnection;\n    };\n\n    private toInstrumented = <T extends object>(controller: T): Instrumented<T> => {\n        markForInstrumentation(controller);\n        return controller as unknown as Instrumented<T>;\n    };\n\n    /**\n     * Wraps every controller previously handed to `toInstrumented` with the invocation\n     * observer, discovering them by their marker rather than a manually maintained\n     * list of property names. Any property assigned via `toInstrumented` is picked up\n     * automatically, using its own property key as the controller name.\n     */\n    private applyMethodInstrumentation = () => {\n        const sdkProperties = this as unknown as Record<string, unknown>;\n        for (const propertyName of Object.keys(sdkProperties)) {\n            const value = sdkProperties[propertyName];\n            if (isPendingInstrumentation(value)) {\n                sdkProperties[propertyName] = wrapWithInvocationObserver(\n                    value,\n                    propertyName,\n                    this.methodListeners,\n                    this.sdkEvents,\n                    this.config.logging?.logger,\n                );\n            }\n        }\n    };\n}\n\nexport default SDK;\n"],"names":["engineInfo","DataItemMappingTools","MethodListenerRegistry","Connect","_a","ActionController","LayoutController","FrameController","BarcodeController","ComponentController","AnimationController","DocumentController","LocalConfigurationDecorator","UtilsController","ToolController","PageController","DebugController","UndoManagerController","TextStyleController","ColorStyleController","GradientStyleController","ParagraphStyleController","CharacterStyleController","MediaConnectorController","FontConnectorController","ComponentConnectorController","DataConnectorController","DataSourceController","ConnectorController","VariableController","FontController","ExperimentController","CanvasController","ShapeController","ColorConversionController","InfoController","ClipboardController","BrandKitController","ComponentGridController","NextInitiator","WellKnownConfigurationKeys","packageInfo","DocumentType","defaultStudioOptions","wrapWithInvocationObserver","ConfigHelper","SdkEvents","SubscriberController"],"mappings":"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"}

package/lib/src/sdk.d.ts

@@ -1,5 +1,6 @@
 import { Connection } from 'penpal';
 import { ConfigType, EditorAPI, RuntimeConfigType } from './types/CommonTypes';
+import { Instrumented } from './types/MethodInvocationTypes';
 import { ActionController } from './controllers/ActionController';
 import { AnimationController } from './controllers/AnimationController';
 import { BarcodeController } from './controllers/BarcodeController';
@@ -35,6 +36,7 @@ import { GradientStyleController } from './controllers/GradientStyleController';
 import { ComponentConnectorController } from './controllers/ComponentConnectorController';
 import { ComponentController } from './controllers/ComponentController';
 import { ComponentGridController } from './controllers/ComponentGridController';
+import { SdkEvents } from './utils/SdkEvents';
 export declare class SDK {
     config: RuntimeConfigType;
     connection: Connection;
@@ -42,49 +44,57 @@ export declare class SDK {
      * @ignore
      */
     editorAPI: EditorAPI;
-    action: ActionController;
-    layout: LayoutController;
-    frame: FrameController;
-    shape: ShapeController;
-    barcode: BarcodeController;
+    /**
+     * SDK method invocation events.
+     *
+     * Use this to observe which SDK controller method was called and with which parameters/result.
+     * These are SDK-level events (SDK -> consumer), separate from engine subscriber events (`config.events`).
+     */
+    sdkEvents: SdkEvents;
+    action: Instrumented<ActionController>;
+    layout: Instrumented<LayoutController>;
+    frame: Instrumented<FrameController>;
+    shape: Instrumented<ShapeController>;
+    barcode: Instrumented<BarcodeController>;
     /** @experimental */
-    component: ComponentController;
-    connector: ConnectorController;
-    mediaConnector: MediaConnectorController;
-    fontConnector: FontConnectorController;
+    component: Instrumented<ComponentController>;
+    connector: Instrumented<ConnectorController>;
+    mediaConnector: Instrumented<MediaConnectorController>;
+    fontConnector: Instrumented<FontConnectorController>;
     /**
      * @experimental This controller is still experimental and might change in future releases.
      */
-    componentConnector: ComponentConnectorController;
-    dataConnector: DataConnectorController;
-    dataSource: DataSourceController;
-    animation: AnimationController;
-    document: DocumentController;
-    configuration: ConfigurationController;
-    variable: VariableController;
-    utils: UtilsController;
-    tool: ToolController;
-    page: PageController;
-    debug: DebugController;
-    undoManager: UndoManagerController;
-    textSelection: TextStyleController;
-    paragraphStyle: ParagraphStyleController;
-    characterStyle: CharacterStyleController;
-    colorStyle: ColorStyleController;
-    gradientStyle: GradientStyleController;
-    font: FontController;
-    experiment: ExperimentController;
-    canvas: CanvasController;
-    colorConversion: ColorConversionController;
-    info: InfoController;
-    clipboard: ClipboardController;
-    brandKit: BrandKitController;
-    componentGrid: ComponentGridController;
+    componentConnector: Instrumented<ComponentConnectorController>;
+    dataConnector: Instrumented<DataConnectorController>;
+    dataSource: Instrumented<DataSourceController>;
+    animation: Instrumented<AnimationController>;
+    document: Instrumented<DocumentController>;
+    configuration: Instrumented<ConfigurationController>;
+    variable: Instrumented<VariableController>;
+    utils: Instrumented<UtilsController>;
+    tool: Instrumented<ToolController>;
+    page: Instrumented<PageController>;
+    debug: Instrumented<DebugController>;
+    undoManager: Instrumented<UndoManagerController>;
+    textSelection: Instrumented<TextStyleController>;
+    paragraphStyle: Instrumented<ParagraphStyleController>;
+    characterStyle: Instrumented<CharacterStyleController>;
+    colorStyle: Instrumented<ColorStyleController>;
+    gradientStyle: Instrumented<GradientStyleController>;
+    font: Instrumented<FontController>;
+    experiment: Instrumented<ExperimentController>;
+    canvas: Instrumented<CanvasController>;
+    colorConversion: Instrumented<ColorConversionController>;
+    info: Instrumented<InfoController>;
+    clipboard: Instrumented<ClipboardController>;
+    brandKit: Instrumented<BrandKitController>;
+    componentGrid: Instrumented<ComponentGridController>;
     next: NextInitiator;
     private subscriber;
     private enabledNextSubscribers;
     private localConfig;
     private dataItemMappingTools;
+    private methodListeners;
     /**
      * The SDK should be configured clientside and it exposes all controllers to work with in other applications
      * @param config The configuration object where the SDK and editor can get configured
@@ -96,5 +106,13 @@ export declare class SDK {
      */
     loadEditor: () => void;
     setConnection: (newConnection: Connection) => void;
+    private toInstrumented;
+    /**
+     * Wraps every controller previously handed to `toInstrumented` with the invocation
+     * observer, discovering them by their marker rather than a manually maintained
+     * list of property names. Any property assigned via `toInstrumented` is picked up
+     * automatically, using its own property key as the controller name.
+     */
+    private applyMethodInstrumentation;
 }
 export default SDK;

package/lib/src/sdk.es.js

@@ -41,19 +41,34 @@ import { GradientStyleController } from "./controllers/GradientStyleController.e
 import { ComponentConnectorController } from "./controllers/ComponentConnectorController.es.js";
 import { ComponentController } from "./controllers/ComponentController.es.js";
 import { ComponentGridController } from "./controllers/ComponentGridController.es.js";
+import { MethodListenerRegistry, wrapWithInvocationObserver } from "./utils/MethodInstrumentation.es.js";
+import { SdkEvents } from "./utils/SdkEvents.es.js";
 const ENGINE_DOMAIN = "studio-cdn.chiligrafx.com";
 const FIXED_EDITOR_LINK = `https://${ENGINE_DOMAIN}/editor/${engineInfo.current}/web`;
 let connection;
+const PENDING_INSTRUMENTATION = Symbol("pendingInstrumentation");
+const markForInstrumentation = (controller) => {
+  Object.defineProperty(controller, PENDING_INSTRUMENTATION, {
+    value: true,
+    enumerable: false,
+    configurable: true
+  });
+};
+const isPendingInstrumentation = (value) => {
+  return typeof value === "object" && value !== null && value[PENDING_INSTRUMENTATION] === true;
+};
 class SDK {
   /**
    * The SDK should be configured clientside and it exposes all controllers to work with in other applications
    * @param config The configuration object where the SDK and editor can get configured
    */
   constructor(config) {
+    var _a;
     this.localConfig = /* @__PURE__ */ new Map();
     this.dataItemMappingTools = new DataItemMappingTools();
+    this.methodListeners = new MethodListenerRegistry();
     this.loadEditor = () => {
-      var _a;
+      var _a2;
       Connect(
         this.config.editorLink || FIXED_EDITOR_LINK,
         {
@@ -71,8 +86,8 @@ class SDK {
           onScrubberPositionChanged: this.subscriber.onAnimationPlaybackChanged,
           onFrameAnimationsChanged: this.subscriber.onAnimationChanged,
           onVariableListChanged: (state) => {
-            var _a2;
-            if ((_a2 = this.enabledNextSubscribers) == null ? void 0 : _a2.onVariableListChanged) {
+            var _a3;
+            if ((_a3 = this.enabledNextSubscribers) == null ? void 0 : _a3.onVariableListChanged) {
               this.next.subscriber.onVariableListChanged(state);
             } else {
               this.subscriber.onVariableListChanged(state);
@@ -90,8 +105,8 @@ class SDK {
           onLayoutsChanged: this.subscriber.onLayoutsChanged,
           onConnectorEvent: this.subscriber.onConnectorEvent,
           onConnectorsChanged: (state) => {
-            var _a2;
-            if ((_a2 = this.enabledNextSubscribers) == null ? void 0 : _a2.onConnectorsChanged) {
+            var _a3;
+            if ((_a3 = this.enabledNextSubscribers) == null ? void 0 : _a3.onConnectorsChanged) {
               this.next.subscriber.onConnectorsChanged(state);
             } else {
               this.subscriber.onConnectorsChanged(state);
@@ -102,8 +117,8 @@ class SDK {
           onPagesChanged: this.subscriber.onPagesChanged,
           onPageSnapshotInvalidated: this.subscriber.onPageSnapshotInvalidated,
           onPageSizeChanged: (state) => {
-            var _a2;
-            if ((_a2 = this.enabledNextSubscribers) == null ? void 0 : _a2.onPageSizeChanged) {
+            var _a3;
+            if ((_a3 = this.enabledNextSubscribers) == null ? void 0 : _a3.onPageSizeChanged) {
               this.next.subscriber.onPageSizeChanged(state);
             } else {
               this.subscriber.onPageSizeChanged(state);
@@ -119,54 +134,56 @@ class SDK {
           onDocumentIssueListChanged: this.subscriber.onDocumentIssueListChanged,
           onCustomUndoDataChanged: this.subscriber.onCustomUndoDataChanged,
           onEngineEditModeChanged: this.subscriber.onEngineEditModeChanged,
-          onBrandKitMediaChanged: this.subscriber.onBrandKitMediaChanged
+          onBrandKitMediaChanged: this.subscriber.onBrandKitMediaChanged,
+          onCanvasFramesManipulated: this.subscriber.onCanvasFramesManipulated
         },
         this.setConnection,
         this.config.editorId,
         this.config.studioStyling,
         (error) => {
-          var _a2, _b;
-          (_b = (_a2 = this.config).onConnectionError) == null ? void 0 : _b.call(_a2, error);
+          var _a3, _b;
+          (_b = (_a3 = this.config).onConnectionError) == null ? void 0 : _b.call(_a3, error);
         }
       );
       this.editorAPI = connection == null ? void 0 : connection.promise.then((editorAPI) => {
         return editorAPI;
       });
-      this.action = new ActionController(this.editorAPI);
-      this.layout = new LayoutController(this.editorAPI);
-      this.frame = new FrameController(this.editorAPI);
-      this.barcode = new BarcodeController(this.editorAPI);
-      this.component = new ComponentController(this.editorAPI);
-      this.animation = new AnimationController(this.editorAPI);
-      this.document = new DocumentController(this.editorAPI);
-      this.configuration = new LocalConfigurationDecorator(this.editorAPI, this.localConfig);
-      this.utils = new UtilsController(this.editorAPI, this.localConfig);
-      this.tool = new ToolController(this.editorAPI);
-      this.page = new PageController(this.editorAPI);
-      this.debug = new DebugController(this.editorAPI);
-      this.undoManager = new UndoManagerController(this.editorAPI, this);
-      this.textSelection = new TextStyleController(this.editorAPI);
-      this.colorStyle = new ColorStyleController(this.editorAPI);
-      this.gradientStyle = new GradientStyleController(this.editorAPI);
-      this.paragraphStyle = new ParagraphStyleController(this.editorAPI);
-      this.characterStyle = new CharacterStyleController(this.editorAPI);
-      this.mediaConnector = new MediaConnectorController(this.editorAPI);
-      this.fontConnector = new FontConnectorController(this.editorAPI);
-      this.componentConnector = new ComponentConnectorController(this.editorAPI);
-      this.dataConnector = new DataConnectorController(this.editorAPI, this.dataItemMappingTools);
-      this.dataSource = new DataSourceController(this.editorAPI, this.dataItemMappingTools);
-      this.connector = new ConnectorController(this.editorAPI, this.localConfig);
-      this.variable = new VariableController(this.editorAPI, this.dataItemMappingTools);
-      this.font = new FontController(this.editorAPI);
-      this.experiment = new ExperimentController(this.editorAPI);
-      this.canvas = new CanvasController(this.editorAPI);
-      this.shape = new ShapeController(this.editorAPI);
-      this.colorConversion = new ColorConversionController(this.editorAPI);
-      this.info = new InfoController();
-      this.clipboard = new ClipboardController(this.editorAPI);
-      this.brandKit = new BrandKitController(this.editorAPI, this);
-      this.componentGrid = new ComponentGridController(this.editorAPI);
+      this.action = this.toInstrumented(new ActionController(this.editorAPI));
+      this.layout = this.toInstrumented(new LayoutController(this.editorAPI));
+      this.frame = this.toInstrumented(new FrameController(this.editorAPI));
+      this.barcode = this.toInstrumented(new BarcodeController(this.editorAPI));
+      this.component = this.toInstrumented(new ComponentController(this.editorAPI));
+      this.animation = this.toInstrumented(new AnimationController(this.editorAPI));
+      this.document = this.toInstrumented(new DocumentController(this.editorAPI));
+      this.configuration = this.toInstrumented(new LocalConfigurationDecorator(this.editorAPI, this.localConfig));
+      this.utils = this.toInstrumented(new UtilsController(this.editorAPI, this.localConfig));
+      this.tool = this.toInstrumented(new ToolController(this.editorAPI));
+      this.page = this.toInstrumented(new PageController(this.editorAPI));
+      this.debug = this.toInstrumented(new DebugController(this.editorAPI));
+      this.undoManager = this.toInstrumented(new UndoManagerController(this.editorAPI, this));
+      this.textSelection = this.toInstrumented(new TextStyleController(this.editorAPI));
+      this.colorStyle = this.toInstrumented(new ColorStyleController(this.editorAPI));
+      this.gradientStyle = this.toInstrumented(new GradientStyleController(this.editorAPI));
+      this.paragraphStyle = this.toInstrumented(new ParagraphStyleController(this.editorAPI));
+      this.characterStyle = this.toInstrumented(new CharacterStyleController(this.editorAPI));
+      this.mediaConnector = this.toInstrumented(new MediaConnectorController(this.editorAPI));
+      this.fontConnector = this.toInstrumented(new FontConnectorController(this.editorAPI));
+      this.componentConnector = this.toInstrumented(new ComponentConnectorController(this.editorAPI));
+      this.dataConnector = this.toInstrumented(new DataConnectorController(this.editorAPI, this.dataItemMappingTools));
+      this.dataSource = this.toInstrumented(new DataSourceController(this.editorAPI, this.dataItemMappingTools));
+      this.connector = this.toInstrumented(new ConnectorController(this.editorAPI, this.localConfig));
+      this.variable = this.toInstrumented(new VariableController(this.editorAPI, this.dataItemMappingTools));
+      this.font = this.toInstrumented(new FontController(this.editorAPI));
+      this.experiment = this.toInstrumented(new ExperimentController(this.editorAPI));
+      this.canvas = this.toInstrumented(new CanvasController(this.editorAPI));
+      this.shape = this.toInstrumented(new ShapeController(this.editorAPI));
+      this.colorConversion = this.toInstrumented(new ColorConversionController(this.editorAPI));
+      this.info = this.toInstrumented(new InfoController());
+      this.clipboard = this.toInstrumented(new ClipboardController(this.editorAPI));
+      this.brandKit = this.toInstrumented(new BrandKitController(this.editorAPI, this));
+      this.componentGrid = this.toInstrumented(new ComponentGridController(this.editorAPI));
       this.next = new NextInitiator(this.config, this.connection, this.editorAPI);
+      this.applyMethodInstrumentation();
       this.configuration.setValue(WellKnownConfigurationKeys.GraFxStudioSdkVersion, packageInfo.version);
       this.configuration.setValue(
         WellKnownConfigurationKeys.GraFxStudioDocumentType,
@@ -175,54 +192,76 @@ class SDK {
       this.configuration.updateStudioOptions(this.config.studioOptions || defaultStudioOptions);
       this.configuration.setValue(
         WellKnownConfigurationKeys.QueryCallCacheEnabled,
-        ((_a = this.config.enableQueryCallCache) == null ? void 0 : _a.toString()) || "false"
+        ((_a2 = this.config.enableQueryCallCache) == null ? void 0 : _a2.toString()) || "false"
       );
     };
     this.setConnection = (newConnection) => {
       connection = newConnection;
     };
+    this.toInstrumented = (controller) => {
+      markForInstrumentation(controller);
+      return controller;
+    };
+    this.applyMethodInstrumentation = () => {
+      var _a2;
+      const sdkProperties = this;
+      for (const propertyName of Object.keys(sdkProperties)) {
+        const value = sdkProperties[propertyName];
+        if (isPendingInstrumentation(value)) {
+          sdkProperties[propertyName] = wrapWithInvocationObserver(
+            value,
+            propertyName,
+            this.methodListeners,
+            this.sdkEvents,
+            (_a2 = this.config.logging) == null ? void 0 : _a2.logger
+          );
+        }
+      }
+    };
     this.config = ConfigHelper.createRuntimeConfig(config);
+    this.sdkEvents = new SdkEvents((_a = this.config.logging) == null ? void 0 : _a.logger);
     this.connection = connection;
     this.editorAPI = connection == null ? void 0 : connection.promise.then((child) => {
       return child;
     });
-    this.action = new ActionController(this.editorAPI);
-    this.layout = new LayoutController(this.editorAPI);
-    this.frame = new FrameController(this.editorAPI);
-    this.shape = new ShapeController(this.editorAPI);
-    this.barcode = new BarcodeController(this.editorAPI);
-    this.component = new ComponentController(this.editorAPI);
-    this.undoManager = new UndoManagerController(this.editorAPI, this);
-    this.connector = new ConnectorController(this.editorAPI, this.localConfig);
-    this.mediaConnector = new MediaConnectorController(this.editorAPI);
-    this.fontConnector = new FontConnectorController(this.editorAPI);
-    this.componentConnector = new ComponentConnectorController(this.editorAPI);
-    this.dataConnector = new DataConnectorController(this.editorAPI, this.dataItemMappingTools);
-    this.dataSource = new DataSourceController(this.editorAPI, this.dataItemMappingTools);
-    this.animation = new AnimationController(this.editorAPI);
-    this.document = new DocumentController(this.editorAPI);
-    this.configuration = new LocalConfigurationDecorator(this.editorAPI, this.localConfig);
-    this.variable = new VariableController(this.editorAPI, this.dataItemMappingTools);
-    this.utils = new UtilsController(this.editorAPI, this.localConfig);
+    this.action = this.toInstrumented(new ActionController(this.editorAPI));
+    this.layout = this.toInstrumented(new LayoutController(this.editorAPI));
+    this.frame = this.toInstrumented(new FrameController(this.editorAPI));
+    this.shape = this.toInstrumented(new ShapeController(this.editorAPI));
+    this.barcode = this.toInstrumented(new BarcodeController(this.editorAPI));
+    this.component = this.toInstrumented(new ComponentController(this.editorAPI));
+    this.undoManager = this.toInstrumented(new UndoManagerController(this.editorAPI, this));
+    this.connector = this.toInstrumented(new ConnectorController(this.editorAPI, this.localConfig));
+    this.mediaConnector = this.toInstrumented(new MediaConnectorController(this.editorAPI));
+    this.fontConnector = this.toInstrumented(new FontConnectorController(this.editorAPI));
+    this.componentConnector = this.toInstrumented(new ComponentConnectorController(this.editorAPI));
+    this.dataConnector = this.toInstrumented(new DataConnectorController(this.editorAPI, this.dataItemMappingTools));
+    this.dataSource = this.toInstrumented(new DataSourceController(this.editorAPI, this.dataItemMappingTools));
+    this.animation = this.toInstrumented(new AnimationController(this.editorAPI));
+    this.document = this.toInstrumented(new DocumentController(this.editorAPI));
+    this.configuration = this.toInstrumented(new LocalConfigurationDecorator(this.editorAPI, this.localConfig));
+    this.variable = this.toInstrumented(new VariableController(this.editorAPI, this.dataItemMappingTools));
+    this.utils = this.toInstrumented(new UtilsController(this.editorAPI, this.localConfig));
     this.subscriber = new SubscriberController(this.config, this.localConfig);
-    this.tool = new ToolController(this.editorAPI);
-    this.page = new PageController(this.editorAPI);
-    this.debug = new DebugController(this.editorAPI);
-    this.textSelection = new TextStyleController(this.editorAPI);
-    this.colorStyle = new ColorStyleController(this.editorAPI);
-    this.gradientStyle = new GradientStyleController(this.editorAPI);
-    this.paragraphStyle = new ParagraphStyleController(this.editorAPI);
-    this.characterStyle = new CharacterStyleController(this.editorAPI);
-    this.font = new FontController(this.editorAPI);
-    this.experiment = new ExperimentController(this.editorAPI);
-    this.canvas = new CanvasController(this.editorAPI);
-    this.colorConversion = new ColorConversionController(this.editorAPI);
-    this.info = new InfoController();
-    this.clipboard = new ClipboardController(this.editorAPI);
+    this.tool = this.toInstrumented(new ToolController(this.editorAPI));
+    this.page = this.toInstrumented(new PageController(this.editorAPI));
+    this.debug = this.toInstrumented(new DebugController(this.editorAPI));
+    this.textSelection = this.toInstrumented(new TextStyleController(this.editorAPI));
+    this.colorStyle = this.toInstrumented(new ColorStyleController(this.editorAPI));
+    this.gradientStyle = this.toInstrumented(new GradientStyleController(this.editorAPI));
+    this.paragraphStyle = this.toInstrumented(new ParagraphStyleController(this.editorAPI));
+    this.characterStyle = this.toInstrumented(new CharacterStyleController(this.editorAPI));
+    this.font = this.toInstrumented(new FontController(this.editorAPI));
+    this.experiment = this.toInstrumented(new ExperimentController(this.editorAPI));
+    this.canvas = this.toInstrumented(new CanvasController(this.editorAPI));
+    this.colorConversion = this.toInstrumented(new ColorConversionController(this.editorAPI));
+    this.info = this.toInstrumented(new InfoController());
+    this.clipboard = this.toInstrumented(new ClipboardController(this.editorAPI));
     this.next = new NextInitiator(this.config, this.connection, this.editorAPI);
     this.enabledNextSubscribers = this.config.enableNextSubscribers;
-    this.brandKit = new BrandKitController(this.editorAPI, this);
-    this.componentGrid = new ComponentGridController(this.editorAPI);
+    this.brandKit = this.toInstrumented(new BrandKitController(this.editorAPI, this));
+    this.componentGrid = this.toInstrumented(new ComponentGridController(this.editorAPI));
+    this.applyMethodInstrumentation();
   }
 }
 export {