@contrail/extensions-sdk 1.0.18-5 → 1.0.19

package/.github/workflows/empty.yml

@@ -2,7 +2,7 @@ name: empty-passing-test
 on: pull_request
 jobs:
   test:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
     strategy:
       matrix:
         node-version: [16.17.0]

package/.github/workflows/sdk-lib.yml

@@ -7,15 +7,18 @@ on:
   workflow_dispatch: # allow running in github actions manually
 jobs:
   test:
-    runs-on: ubuntu-20.04
+    runs-on: ubuntu-24.04
+    strategy:
+      matrix:
+        node-version: [20]
     steps:
+      - uses: actions/checkout@v4
+
       - name: Node.js
-        uses: actions/setup-node@v3
+        uses: actions/setup-node@v4
         with:
           node-version: ${{ matrix.node-version }}
 
-      - uses: actions/checkout@v3
-
       - name: NPM Install
         env:
           NPM_TOKEN: ${{ secrets.NPM_TOKEN }}

package/lib/actions/actions.d.ts

@@ -1,10 +1,9 @@
-import { AppContext, AppExtensionEvent } from '../apps/app-context';
+import { AppContext } from '../apps/app-context';
 import { EntitiesClientAction } from '../entities/entities-action-handler';
 import { AppExtensionMessage } from '../extensions/app-extension-message-handler';
 import { TypesClientAction } from '../types/types-action-handler';
 export interface RegisterExtensionActions {
-    init(context: AppContext): Promise<void>;
-    emitEvent(event: AppExtensionEvent): void;
+    init(context: AppContext): void;
 }
 export interface ExtensionActions {
     close(): void;
@@ -12,7 +11,6 @@ export interface ExtensionActions {
     sendMessageToTypesClient(message: TypesClientAction): Promise<any>;
     sendMessageToHost(message: AppExtensionMessage): Promise<any>;
 }
-export declare let EXTENSION_ACTIONS: ExtensionActions | undefined;
+export declare let EXTENSION_ACTIONS: ExtensionActions;
 export declare function setExtensionActions(actions: ExtensionActions): void;
-export declare function getExtensionActions(): ExtensionActions | undefined;
-export declare function getExtensionActionsOrThrow(): ExtensionActions;
+export declare function getExtensionActions(): ExtensionActions;

package/lib/actions/actions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getExtensionActionsOrThrow = exports.getExtensionActions = exports.setExtensionActions = exports.EXTENSION_ACTIONS = void 0;
+exports.getExtensionActions = exports.setExtensionActions = exports.EXTENSION_ACTIONS = void 0;
 function setExtensionActions(actions) {
     exports.EXTENSION_ACTIONS = actions;
 }
@@ -9,11 +9,3 @@ function getExtensionActions() {
     return exports.EXTENSION_ACTIONS;
 }
 exports.getExtensionActions = getExtensionActions;
-function getExtensionActionsOrThrow() {
-    const actions = exports.EXTENSION_ACTIONS;
-    if (!actions) {
-        throw new Error('Extension is not connected. Ensure AppExtension.registerAppExtension() has resolved before using this API.');
-    }
-    return actions;
-}
-exports.getExtensionActionsOrThrow = getExtensionActionsOrThrow;

package/lib/apps/app-context.d.ts

@@ -84,15 +84,6 @@ export interface ShowcaseContext {
     previewFileId?: string;
     backingAssortmentId?: string;
 }
-export declare enum AppEventType {
-    SelectedElementsChanged = "selected_elements_changed",
-    ShowcaseFramesChanged = "showcase_frames_changed",
-    ShowcaseCurrentFrameChanged = "showcase_current_frame_changed"
-}
-export interface AppExtensionEvent<T = any> {
-    type: AppEventType;
-    data: T;
-}
 export declare const CONTEXT: AppContext;
 export declare function setAppContext(context: AppContext): void;
 export declare function getAppContext(): AppContext;

package/lib/apps/app-context.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.getAppContext = exports.setAppContext = exports.CONTEXT = exports.AppEventType = exports.VibeIQAppType = void 0;
+exports.getAppContext = exports.setAppContext = exports.CONTEXT = exports.VibeIQAppType = void 0;
 var VibeIQAppType;
 (function (VibeIQAppType) {
     VibeIQAppType["BOARDS"] = "boards";
@@ -8,12 +8,6 @@ var VibeIQAppType;
     VibeIQAppType["SHOWCASE"] = "showcase";
     VibeIQAppType["ADMIN_CONSOLE"] = "admin_console";
 })(VibeIQAppType = exports.VibeIQAppType || (exports.VibeIQAppType = {}));
-var AppEventType;
-(function (AppEventType) {
-    AppEventType["SelectedElementsChanged"] = "selected_elements_changed";
-    AppEventType["ShowcaseFramesChanged"] = "showcase_frames_changed";
-    AppEventType["ShowcaseCurrentFrameChanged"] = "showcase_current_frame_changed";
-})(AppEventType = exports.AppEventType || (exports.AppEventType = {}));
 exports.CONTEXT = {};
 function setAppContext(context) {
     Object.assign(exports.CONTEXT, context);

package/lib/apps/boards.d.ts

@@ -7,7 +7,14 @@ export declare enum BoardCommand {
     GET_ELEMENTS = "board:get_elements",
     RECOLOR_IMAGES = "board:recolor_images",
     ADD_CONTENT_TO_ENTITY_FROM_ELEMENTS = "board:add_content_to_entity_from_elements",
-    ADD_FRAMES_FROM_TEMPLATE = "board:add_frames_from_template"
+    ADD_FRAMES_FROM_TEMPLATE = "board:add_frames_from_template",
+    ADD_ITEMS_TO_CLIPBOARD = "board:add_items_to_clipboard"
+}
+export interface ClipboardItemsPayload {
+    clipboardItems: Array<{
+        itemId: string;
+        projectItemId?: string | null;
+    }>;
 }
 export interface BoardDocumentElement extends DocumentElement {
     [key: string]: any;
@@ -51,6 +58,10 @@ export declare class BoardsApp {
     static getElements(criteria: object): Promise<Array<DocumentElement>>;
     static createNewContentAndAssignToEntity(assignmentOptions: any, entity: any, elements: Array<DocumentElement>): Promise<Array<DocumentElement>>;
     static recolorImages(imageElements: Array<DocumentElement>, hexCode: string, hexMap?: {}): Promise<Array<DocumentElement>>;
+    static addItemsToClipboard(clipboardItems: Array<{
+        itemId: string;
+        projectItemId?: string | null;
+    }>): void;
     private static validateBoardContext;
     private static validateAndReturnResults;
 }

package/lib/apps/boards.js

@@ -21,6 +21,7 @@ var BoardCommand;
     BoardCommand["RECOLOR_IMAGES"] = "board:recolor_images";
     BoardCommand["ADD_CONTENT_TO_ENTITY_FROM_ELEMENTS"] = "board:add_content_to_entity_from_elements";
     BoardCommand["ADD_FRAMES_FROM_TEMPLATE"] = "board:add_frames_from_template";
+    BoardCommand["ADD_ITEMS_TO_CLIPBOARD"] = "board:add_items_to_clipboard";
 })(BoardCommand = exports.BoardCommand || (exports.BoardCommand = {}));
 class BoardsApp {
     static getCurrentBoard() {
@@ -30,7 +31,7 @@ class BoardsApp {
     static addElements(elements) {
         BoardsApp.validateBoardContext();
         if (elements === null || elements === void 0 ? void 0 : elements.length) {
-            (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({
+            (0, actions_1.getExtensionActions)().sendMessageToHost({
                 command: BoardCommand.ADD_ELEMENTS,
                 data: elements,
             });
@@ -40,7 +41,7 @@ class BoardsApp {
         return __awaiter(this, void 0, void 0, function* () {
             BoardsApp.validateBoardContext();
             if (frames === null || frames === void 0 ? void 0 : frames.length) {
-                const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({
+                const results = yield (0, actions_1.getExtensionActions)().sendMessageToHost({
                     command: BoardCommand.ADD_FRAMES_FROM_TEMPLATE,
                     data: frames,
                 });
@@ -53,13 +54,13 @@ class BoardsApp {
         BoardsApp.validateBoardContext();
         const elementsWithIds = elements.filter((element) => !!element.id);
         if (elementsWithIds === null || elementsWithIds === void 0 ? void 0 : elementsWithIds.length) {
-            (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({ command: BoardCommand.DELETE_ELEMENTS, data: elementsWithIds });
+            (0, actions_1.getExtensionActions)().sendMessageToHost({ command: BoardCommand.DELETE_ELEMENTS, data: elementsWithIds });
         }
     }
     static modifyElements(changeObjects) {
         BoardsApp.validateBoardContext();
         if (changeObjects === null || changeObjects === void 0 ? void 0 : changeObjects.length) {
-            (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({
+            (0, actions_1.getExtensionActions)().sendMessageToHost({
                 command: BoardCommand.MODIFY_ELEMENTS,
                 data: changeObjects,
             });
@@ -68,7 +69,7 @@ class BoardsApp {
     static getElements(criteria) {
         return __awaiter(this, void 0, void 0, function* () {
             BoardsApp.validateBoardContext();
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToHost({
                 command: BoardCommand.GET_ELEMENTS,
                 data: criteria,
             });
@@ -83,7 +84,7 @@ class BoardsApp {
                 entity,
                 elements,
             };
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToHost({
                 command: BoardCommand.ADD_CONTENT_TO_ENTITY_FROM_ELEMENTS,
                 data,
             });
@@ -93,13 +94,22 @@ class BoardsApp {
     static recolorImages(imageElements, hexCode, hexMap = {}) {
         return __awaiter(this, void 0, void 0, function* () {
             BoardsApp.validateBoardContext();
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToHost({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToHost({
                 command: BoardCommand.RECOLOR_IMAGES,
                 data: { imageElements, hexCode, hexMap },
             });
             return this.validateAndReturnResults(results);
         });
     }
+    static addItemsToClipboard(clipboardItems) {
+        BoardsApp.validateBoardContext();
+        if (clipboardItems === null || clipboardItems === void 0 ? void 0 : clipboardItems.length) {
+            (0, actions_1.getExtensionActions)().sendMessageToHost({
+                command: BoardCommand.ADD_ITEMS_TO_CLIPBOARD,
+                data: { clipboardItems },
+            });
+        }
+    }
     static validateBoardContext() {
         const context = (0, app_context_1.getAppContext)();
         if (context.appContext.vibeIQApp !== app_context_1.VibeIQAppType.BOARDS || !context.appContext.board) {

package/lib/apps/index.d.ts

@@ -1,3 +1,4 @@
 export { getAppContext, AppContext, BoardContext, PlanContext, ShowcaseContext, VibeIQAppType } from './app-context';
 export * from './boards';
 export * from './plan';
+export * from './showcase';

package/lib/apps/index.js

@@ -20,3 +20,4 @@ Object.defineProperty(exports, "getAppContext", { enumerable: true, get: functio
 Object.defineProperty(exports, "VibeIQAppType", { enumerable: true, get: function () { return app_context_1.VibeIQAppType; } });
 __exportStar(require("./boards"), exports);
 __exportStar(require("./plan"), exports);
+__exportStar(require("./showcase"), exports);

package/lib/apps/plan.js

@@ -35,18 +35,18 @@ class PlanApp {
     static addRows(collectionElements) {
         PlanApp.validatePlanContext();
         if (collectionElements === null || collectionElements === void 0 ? void 0 : collectionElements.length) {
-            const actions = (0, actions_1.getExtensionActionsOrThrow)();
+            const actions = (0, actions_1.getExtensionActions)();
             actions.sendMessageToHost({ command: PlanCommand.ADD_ROWS, data: collectionElements });
         }
     }
     static clearSelectedRows() {
         PlanApp.validatePlanContext();
-        const actions = (0, actions_1.getExtensionActionsOrThrow)();
+        const actions = (0, actions_1.getExtensionActions)();
         actions.sendMessageToHost({ command: PlanCommand.CLEAR_SELECTED_ROWS });
     }
     static showMessage(message) {
         PlanApp.validatePlanContext();
-        const actions = (0, actions_1.getExtensionActionsOrThrow)();
+        const actions = (0, actions_1.getExtensionActions)();
         actions.sendMessageToHost({ command: PlanCommand.SHOW_MESSAGE, data: message });
     }
     static validatePlanContext() {

package/lib/apps/showcase.d.ts

@@ -0,0 +1,11 @@
+export declare enum ShowcaseCommand {
+    ADD_ITEMS_TO_CLIPBOARD = "showcase:add_items_to_clipboard"
+}
+export declare class ShowcaseApp {
+    static getCurrentShowcase(): any;
+    static addItemsToClipboard(clipboardItems: Array<{
+        itemId: string;
+        projectItemId?: string | null;
+    }>): void;
+    private static validateShowcaseContext;
+}

package/lib/apps/showcase.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ShowcaseApp = exports.ShowcaseCommand = void 0;
+const actions_1 = require("../actions/actions");
+const app_context_1 = require("./app-context");
+var ShowcaseCommand;
+(function (ShowcaseCommand) {
+    ShowcaseCommand["ADD_ITEMS_TO_CLIPBOARD"] = "showcase:add_items_to_clipboard";
+})(ShowcaseCommand = exports.ShowcaseCommand || (exports.ShowcaseCommand = {}));
+class ShowcaseApp {
+    static getCurrentShowcase() {
+        var _a;
+        ShowcaseApp.validateShowcaseContext();
+        return (_a = (0, app_context_1.getAppContext)().appContext) === null || _a === void 0 ? void 0 : _a.showcase;
+    }
+    static addItemsToClipboard(clipboardItems) {
+        ShowcaseApp.validateShowcaseContext();
+        if (clipboardItems === null || clipboardItems === void 0 ? void 0 : clipboardItems.length) {
+            (0, actions_1.getExtensionActions)().sendMessageToHost({
+                command: ShowcaseCommand.ADD_ITEMS_TO_CLIPBOARD,
+                data: { clipboardItems },
+            });
+        }
+    }
+    static validateShowcaseContext() {
+        var _a, _b;
+        const context = (0, app_context_1.getAppContext)();
+        if (((_a = context.appContext) === null || _a === void 0 ? void 0 : _a.vibeIQApp) !== app_context_1.VibeIQAppType.SHOWCASE || !((_b = context.appContext) === null || _b === void 0 ? void 0 : _b.showcase)) {
+            throw new Error('App extension has not been initialized with Showcase context.');
+        }
+    }
+}
+exports.ShowcaseApp = ShowcaseApp;

package/lib/entities/entities-client.js

@@ -17,7 +17,7 @@ class EntitiesClientUpdateOptions {
 class EntitiesClient {
     get(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.GET,
                 options,
             });
@@ -26,7 +26,7 @@ class EntitiesClient {
     }
     create(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.CREATE,
                 options,
             });
@@ -35,7 +35,7 @@ class EntitiesClient {
     }
     batchCreate(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.BATCH_CREATE,
                 options,
             });
@@ -44,7 +44,7 @@ class EntitiesClient {
     }
     update(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.UPDATE,
                 options,
             });
@@ -53,7 +53,7 @@ class EntitiesClient {
     }
     batchUpdate(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.BATCH_UPDATE,
                 options,
             });
@@ -62,7 +62,7 @@ class EntitiesClient {
     }
     delete(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.DELETE,
                 options,
             });
@@ -71,7 +71,7 @@ class EntitiesClient {
     }
     batchDelete(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToEntitiesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({
                 method: entities_action_handler_1.EntitiesClientMethods.BATCH_DELETE,
                 options,
             });

package/lib/extensions/app-extension-host.d.ts

@@ -1,11 +1,6 @@
-import { AppContext, AppExtensionEvent } from '../apps/app-context';
+import { AppContext } from '../apps/app-context';
 import { AppExtensionMessageHandler } from './app-extension-message-handler';
-export interface RegisterHostWithAppExtensionOptions {
-    timeoutMs?: number;
-}
 export declare class AppExtensionHost {
-    private static appExtension;
-    static registerHostWithAppExtension(iframe: HTMLIFrameElement, context: AppContext, customMessageHandler: AppExtensionMessageHandler, options?: RegisterHostWithAppExtensionOptions): Promise<void>;
-    static emitEvent(event: AppExtensionEvent): void;
+    static registerHostWithAppExtension(iframe: HTMLIFrameElement, context: AppContext, customMessageHandler: AppExtensionMessageHandler): Promise<void>;
     private static getExtensionActionsToRunOnHost;
 }

package/lib/extensions/app-extension-host.js

@@ -13,21 +13,18 @@ exports.AppExtensionHost = void 0;
 const penpal_1 = require("penpal");
 const entities_action_handler_1 = require("../entities/entities-action-handler");
 const types_action_handler_1 = require("../types/types-action-handler");
-const connection_timeout_1 = require("./connection-timeout");
 class AppExtensionHost {
-    static registerHostWithAppExtension(iframe, context, customMessageHandler, options) {
+    static registerHostWithAppExtension(iframe, context, customMessageHandler) {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const hostActions = AppExtensionHost.getExtensionActionsToRunOnHost(customMessageHandler);
                 const connection = (0, penpal_1.connectToChild)({ iframe, methods: Object.assign({}, hostActions) });
+                const iframeWindow = iframe.contentWindow;
+                iframeWindow.postMessage({ isConnected: true }, iframe.src);
                 console.log('[HostApp] Awaiting connection to app extension...');
-                const connectionPromise = (options === null || options === void 0 ? void 0 : options.timeoutMs) !== undefined
-                    ? (0, connection_timeout_1.withConnectionTimeout)(connection.promise, options.timeoutMs, () => new connection_timeout_1.HostConnectionTimeoutError(options.timeoutMs))
-                    : connection.promise;
-                const appExtension = yield connectionPromise;
+                const appExtension = yield connection.promise;
                 console.log('[HostApp] Connected to app extension.');
-                AppExtensionHost.appExtension = appExtension;
-                yield appExtension.init(context);
+                appExtension.init(context);
             }
             catch (error) {
                 console.error('Failed to connect host app with app extension:', error);
@@ -35,13 +32,6 @@ class AppExtensionHost {
             }
         });
     }
-    static emitEvent(event) {
-        if (!AppExtensionHost.appExtension) {
-            console.warn('[HostApp] Cannot emit event: no app extension connected.');
-            return;
-        }
-        AppExtensionHost.appExtension.emitEvent(event);
-    }
     static getExtensionActionsToRunOnHost(customMessageHandler) {
         return {
             close() {
@@ -60,4 +50,3 @@ class AppExtensionHost {
     }
 }
 exports.AppExtensionHost = AppExtensionHost;
-AppExtensionHost.appExtension = null;

package/lib/extensions/app-extension.d.ts

@@ -1,15 +1,7 @@
-import { AppEventType } from '../apps/app-context';
-export interface RegisterAppExtensionOptions {
-    timeoutMs?: number;
-}
 export declare class AppExtension {
     private static initPromiseResolver;
-    private static eventListeners;
-    static registerAppExtension(options?: RegisterAppExtensionOptions): Promise<void>;
+    static registerAppExtension(): Promise<void>;
     private static getExtensionActions;
     private static initAppExtension;
-    private static handleEvent;
-    private static getCurrentValueForEvent;
-    static subscribe<T = any>(eventType: AppEventType, listener: (data: T) => void): () => void;
     static close(): void;
 }

package/lib/extensions/app-extension.js

@@ -13,18 +13,14 @@ exports.AppExtension = void 0;
 const penpal_1 = require("penpal");
 const app_context_1 = require("../apps/app-context");
 const actions_1 = require("../actions/actions");
-const connection_timeout_1 = require("./connection-timeout");
 class AppExtension {
-    static registerAppExtension(options) {
+    static registerAppExtension() {
         return __awaiter(this, void 0, void 0, function* () {
             try {
                 const extensionRegistrationActions = AppExtension.getExtensionActions();
                 const connection = (0, penpal_1.connectToParent)({ methods: Object.assign({}, extensionRegistrationActions) });
                 console.log('[AppExtension] Awaiting connection to host app...');
-                const connectionPromise = (options === null || options === void 0 ? void 0 : options.timeoutMs) !== undefined
-                    ? (0, connection_timeout_1.withConnectionTimeout)(connection.promise, options.timeoutMs, () => new connection_timeout_1.ExtensionConnectionTimeoutError(options.timeoutMs))
-                    : connection.promise;
-                const hostApp = yield connectionPromise;
+                const hostApp = yield connection.promise;
                 console.log('[AppExtension] Connected to host app.');
                 (0, actions_1.setExtensionActions)(hostApp);
                 yield new Promise((resolve) => {
@@ -42,9 +38,6 @@ class AppExtension {
             init(context) {
                 return AppExtension.initAppExtension(context);
             },
-            emitEvent(event) {
-                return AppExtension.handleEvent(event);
-            },
         };
     }
     static initAppExtension(context) {
@@ -56,75 +49,9 @@ class AppExtension {
             }
         });
     }
-    static handleEvent(event) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        const existing = (0, app_context_1.getAppContext)();
-        switch (event.type) {
-            case app_context_1.AppEventType.SelectedElementsChanged:
-                (0, app_context_1.setAppContext)(Object.assign(Object.assign({}, existing), { appContext: Object.assign(Object.assign({}, ((_a = existing.appContext) !== null && _a !== void 0 ? _a : {})), { selectedElements: event.data }) }));
-                break;
-            case app_context_1.AppEventType.ShowcaseFramesChanged:
-                (0, app_context_1.setAppContext)(Object.assign(Object.assign({}, existing), { appContext: Object.assign(Object.assign({}, ((_b = existing.appContext) !== null && _b !== void 0 ? _b : {})), { showcase: Object.assign(Object.assign({}, ((_d = (_c = existing.appContext) === null || _c === void 0 ? void 0 : _c.showcase) !== null && _d !== void 0 ? _d : {})), { frames: event.data }) }) }));
-                break;
-            case app_context_1.AppEventType.ShowcaseCurrentFrameChanged:
-                (0, app_context_1.setAppContext)(Object.assign(Object.assign({}, existing), { appContext: Object.assign(Object.assign({}, ((_e = existing.appContext) !== null && _e !== void 0 ? _e : {})), { showcase: Object.assign(Object.assign({}, ((_g = (_f = existing.appContext) === null || _f === void 0 ? void 0 : _f.showcase) !== null && _g !== void 0 ? _g : {})), { currentFrame: event.data }) }) }));
-                break;
-        }
-        const listeners = AppExtension.eventListeners.get(event.type);
-        if (listeners) {
-            listeners.forEach((listener) => {
-                try {
-                    listener(event.data);
-                }
-                catch (error) {
-                    console.error(`[AppExtension] Error in listener for event "${event.type}":`, error);
-                }
-            });
-        }
-    }
-    static getCurrentValueForEvent(eventType) {
-        var _a, _b, _c, _d, _e;
-        const ctx = (0, app_context_1.getAppContext)();
-        switch (eventType) {
-            case app_context_1.AppEventType.SelectedElementsChanged:
-                return (_a = ctx.appContext) === null || _a === void 0 ? void 0 : _a.selectedElements;
-            case app_context_1.AppEventType.ShowcaseFramesChanged:
-                return (_c = (_b = ctx.appContext) === null || _b === void 0 ? void 0 : _b.showcase) === null || _c === void 0 ? void 0 : _c.frames;
-            case app_context_1.AppEventType.ShowcaseCurrentFrameChanged:
-                return (_e = (_d = ctx.appContext) === null || _d === void 0 ? void 0 : _d.showcase) === null || _e === void 0 ? void 0 : _e.currentFrame;
-        }
-    }
-    static subscribe(eventType, listener) {
-        if (!AppExtension.eventListeners.has(eventType)) {
-            AppExtension.eventListeners.set(eventType, []);
-        }
-        AppExtension.eventListeners.get(eventType).push(listener);
-        const currentValue = AppExtension.getCurrentValueForEvent(eventType);
-        if (currentValue !== undefined) {
-            try {
-                listener(currentValue);
-            }
-            catch (error) {
-                console.error(`[AppExtension] Error emitting initial value for event "${eventType}":`, error);
-            }
-        }
-        return () => {
-            const listeners = AppExtension.eventListeners.get(eventType);
-            if (listeners) {
-                const index = listeners.indexOf(listener);
-                if (index > -1) {
-                    listeners.splice(index, 1);
-                }
-            }
-        };
-    }
     static close() {
-        const actions = (0, actions_1.getExtensionActions)();
-        if (actions) {
-            actions.close();
-        }
+        (0, actions_1.getExtensionActions)().close();
     }
 }
 exports.AppExtension = AppExtension;
 AppExtension.initPromiseResolver = null;
-AppExtension.eventListeners = new Map();

package/lib/extensions/index.d.ts

@@ -1,4 +1,3 @@
 export * from './app-extension-host';
 export * from './app-extension-message-handler';
 export * from './app-extension';
-export * from './connection-timeout';

package/lib/extensions/index.js

@@ -17,4 +17,3 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./app-extension-host"), exports);
 __exportStar(require("./app-extension-message-handler"), exports);
 __exportStar(require("./app-extension"), exports);
-__exportStar(require("./connection-timeout"), exports);

package/lib/types/types-client.js

@@ -15,7 +15,7 @@ const types_action_handler_1 = require("./types-action-handler");
 class TypesClient {
     getType(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToTypesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToTypesClient({
                 method: types_action_handler_1.TypesClientMethods.GET_TYPE,
                 options,
             });
@@ -24,7 +24,7 @@ class TypesClient {
     }
     getByRootAndPath(options) {
         return __awaiter(this, void 0, void 0, function* () {
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToTypesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToTypesClient({
                 method: types_action_handler_1.TypesClientMethods.GET_BY_ROOT_AND_PATH,
                 options,
             });
@@ -34,7 +34,7 @@ class TypesClient {
     getProperty(typeId, propertySlug) {
         return __awaiter(this, void 0, void 0, function* () {
             const getPropertyOptions = { typeId, propertySlug };
-            const results = yield (0, actions_1.getExtensionActionsOrThrow)().sendMessageToTypesClient({
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToTypesClient({
                 method: types_action_handler_1.TypesClientMethods.GET_PROPERTY,
                 options: getPropertyOptions,
             });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@contrail/extensions-sdk",
-  "version": "1.0.18-5",
+  "version": "1.0.19",
   "description": "Client library for interfacing with VibeIQ's services and apps from an extension.",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",

package/docs/EXTENSION_SDK_GUIDE.md

@@ -1,183 +0,0 @@
-# Extension SDK Guide
-
-This guide explains how the Contrail Extensions SDK works, how the **host app** (Boards, Showcase, Plan) establishes the connection and passes context, and how **external developers** write extensions that consume that context.
-
----
-
-## How context works
-
-The host sends the full `AppContext` **once** over the Penpal connection when it calls `init(context)` after the extension registers. The extension receives it during `registerAppExtension()` and can read it at any time via `getAppContext()`. There is no real-time context update mechanism; the extension only has the snapshot provided at initialization.
-
----
-
-## For the Host App: Establishing the Connection
-
-The host app is responsible for loading the extension in an iframe, registering with the SDK, and passing the initial context.
-
-### 1. Install and import the SDK
-
-```ts
-import {
-  AppExtensionHost,
-  AppContext,
-  AppExtensionMessage,
-  AppExtensionMessageHandler,
-} from '@contrail/extensions-sdk'; // or your package name
-```
-
-### 2. Create the extension iframe
-
-Create an `HTMLIFrameElement` that loads your extension's entry URL (e.g. the built extension app). The extension script inside the iframe will call `AppExtension.registerAppExtension()` and use Penpal to connect to the parent.
-
-### 3. Implement the message handler
-
-The host must implement `AppExtensionMessageHandler` to handle commands from the extension (e.g. close, custom commands):
-
-```ts
-const messageHandler: AppExtensionMessageHandler = {
-  async handleMessage(message: AppExtensionMessage): Promise<unknown> {
-    switch (message.command) {
-      case 'close':
-        // Close the extension panel or navigate away
-        break;
-      // Handle other commands your extension sends via sendMessageToHost()
-      default:
-        break;
-    }
-    return undefined;
-  },
-};
-```
-
-### 4. Build initial context and register with the extension
-
-Gather the `AppContext` (user, app type, board/plan/showcase snapshot, etc.) and call `registerHostWithAppExtension`. This establishes the Penpal connection and sends the context once via `init(context)`.
-
-```ts
-const iframe = document.querySelector('iframe#extension') as HTMLIFrameElement;
-const context: AppContext = {
-  user: currentUser,
-  appContext: {
-    vibeIQApp: VibeIQAppType.SHOWCASE,
-    showcase: {
-      id: showcase.id,
-      name: showcase.name,
-      orgId: showcase.orgId,
-      currentFrame: activeFrame,
-      frames: showcase.frames,
-      // ... other fields
-    },
-    // board, plan, selectedElements, etc. as needed
-  },
-};
-
-await AppExtensionHost.registerHostWithAppExtension(iframe, context, messageHandler);
-// Connection is ready. The extension has received context via init().
-```
-
-The extension receives this context once at init. If the host needs to change what the extension sees (e.g. after navigating to a different showcase or frame), it would need to re-load or re-initialize the extension with new context; the SDK does not support pushing context updates after init.
-
----
-
-## For Extension Developers: Writing an Extension
-
-Extensions run inside an iframe loaded by the host. They use the SDK to register with the host and read the context that was passed at initialization.
-
-### 1. Install and import the SDK
-
-```ts
-import {
-  AppExtension,
-  getAppContext,
-  VibeIQAppType,
-} from '@contrail/extensions-sdk';
-```
-
-### 2. Register the extension on load
-
-Your extension entry point (e.g. main.tsx or main.ts) must call `AppExtension.registerAppExtension()` and wait for it. This sets up the Penpal connection and waits for the host to call `init(context)`.
-
-```ts
-// In your extension's bootstrap (e.g. main.tsx)
-async function bootstrap() {
-  await AppExtension.registerAppExtension();
-  // Connection is ready. Initial context is set.
-  // Mount your app (e.g. React root).
-}
-
-bootstrap().catch(console.error);
-```
-
-Do not render your UI or depend on context until `registerAppExtension()` has resolved. The host calls `init(context)` once; that is the only time context is provided.
-
-### 3. Read context
-
-Use `getAppContext()` to read the context snapshot that was passed at init:
-
-```ts
-const context = getAppContext();
-
-if (context.appContext?.vibeIQApp === VibeIQAppType.SHOWCASE) {
-  const showcase = context.appContext.showcase;
-  const currentFrame = showcase?.currentFrame;
-  const frames = showcase?.frames;
-}
-
-const selectedElements = context.appContext?.selectedElements ?? [];
-```
-
-This context does not change after init. The extension only has the snapshot the host provided when the connection was established.
-
-### 4. Showcase context
-
-When the host app is Showcase (or includes showcase in context), the host includes `showcase` in the `AppContext` passed to `registerHostWithAppExtension` / `init(context)`. The extension reads it via `getAppContext().appContext?.showcase` (e.g. `currentFrame`, `frames`). There is no API to receive showcase updates after init; the extension works with the initial snapshot.
-
-### 5. Sending messages to the host
-
-Use the SDK APIs that talk to the host over the Penpal connection:
-
-```ts
-// Close the extension (host handles in messageHandler)
-AppExtension.close();
-```
-
-For app-specific commands (e.g. Board or Plan actions), use the SDK's app modules (e.g. `Boards`, `Plan`), which send messages to the host internally. Custom commands can be sent via those modules or whatever host-messaging API your SDK exposes; the host receives them in `messageHandler.handleMessage`.
-
-### 6. Clipboard: bulk add items
-
-Extensions can request that the host bulk-add items to the user's clipboard by sending a message with a list of `{ itemId, projectItemId }`. The host dispatches its existing clipboard store action; there is no success or error response unless the host adds one later.
-
-**Board:** Use `BoardsApp.addItemsToClipboard(clipboardItems)`:
-
-```ts
-import { BoardsApp } from '@contrail/extensions-sdk';
-
-BoardsApp.addItemsToClipboard([
-  { itemId: 'item-1', projectItemId: 'proj-1' },
-  { itemId: 'item-2', projectItemId: null },
-]);
-```
-
-You can also send the command explicitly with `command: BoardCommand.ADD_ITEMS_TO_CLIPBOARD` and `data: { clipboardItems }` via your extension's host message channel.
-
-**Showcase:** Use `ShowcaseApp.addItemsToClipboard(clipboardItems)`:
-
-```ts
-import { ShowcaseApp } from '@contrail/extensions-sdk';
-
-ShowcaseApp.addItemsToClipboard([
-  { itemId: 'item-1', projectItemId: 'proj-1' },
-  { itemId: 'item-2', projectItemId: null },
-]);
-```
-
-You can also send the command explicitly with `command: ShowcaseCommand.ADD_ITEMS_TO_CLIPBOARD` and `data: { clipboardItems }` via your extension's host message channel.
-
-**Payload:** `clipboardItems: Array<{ itemId: string; projectItemId?: string | null }>`. The host normalizes and dispatches its existing clipboard action; no new API or store logic is required on the host.
-
----
-
-## Summary
-
-- **Host:** Load extension iframe → build `AppContext` → call `AppExtensionHost.registerHostWithAppExtension(iframe, context, messageHandler)`. Context is sent once via `init(context)`; there is no API to push context updates after that.
-- **Extension:** Call `AppExtension.registerAppExtension()` at startup → use `getAppContext()` to read the context snapshot received at init. Showcase and other app data are available under `getAppContext().appContext` (e.g. `appContext.showcase`).

package/lib/extensions/connection-timeout.d.ts

@@ -1,7 +0,0 @@
-export declare class ExtensionConnectionTimeoutError extends Error {
-    constructor(timeoutMs: number);
-}
-export declare class HostConnectionTimeoutError extends Error {
-    constructor(timeoutMs: number);
-}
-export declare function withConnectionTimeout<T>(promise: Promise<T>, timeoutMs: number, createError: () => Error): Promise<T>;

package/lib/extensions/connection-timeout.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.withConnectionTimeout = exports.HostConnectionTimeoutError = exports.ExtensionConnectionTimeoutError = void 0;
-class ExtensionConnectionTimeoutError extends Error {
-    constructor(timeoutMs) {
-        super(`Extension connection to host timed out after ${timeoutMs}ms. Ensure the host calls registerHostWithAppExtension after the extension iframe has loaded.`);
-        this.name = 'ExtensionConnectionTimeoutError';
-        Object.setPrototypeOf(this, ExtensionConnectionTimeoutError.prototype);
-    }
-}
-exports.ExtensionConnectionTimeoutError = ExtensionConnectionTimeoutError;
-class HostConnectionTimeoutError extends Error {
-    constructor(timeoutMs) {
-        super(`Host connection to extension timed out after ${timeoutMs}ms. Ensure the extension calls registerAppExtension() on load and the iframe has loaded.`);
-        this.name = 'HostConnectionTimeoutError';
-        Object.setPrototypeOf(this, HostConnectionTimeoutError.prototype);
-    }
-}
-exports.HostConnectionTimeoutError = HostConnectionTimeoutError;
-function withConnectionTimeout(promise, timeoutMs, createError) {
-    return new Promise((resolve, reject) => {
-        const timer = setTimeout(() => reject(createError()), timeoutMs);
-        promise
-            .then((value) => {
-            clearTimeout(timer);
-            resolve(value);
-        })
-            .catch((err) => {
-            clearTimeout(timer);
-            reject(err);
-        });
-    });
-}
-exports.withConnectionTimeout = withConnectionTimeout;