@contrail/extensions-sdk 1.0.0-alpha.0

package/.github/pull_request_template.md

@@ -0,0 +1,30 @@
+## What
+- [ ] Bugfix
+- [ ] Feature
+- [ ] Enhancement
+
+Description: 
+<!--
+Describe the functional changes of the PR.
+
+If the mechanism of your change are complex, describe them in detail as you
+would if you were explaining them to a team mate.
+
+If the PR is simple, there is no need to repeat yourself. A small description
+is sufficient.
+-->
+
+## Why
+<!-- 
+why is this change needed? Same rules as with #What
+ -->
+
+
+## Testing added
+<!-- 
+Describe the testing you added to this PR
+ -->
+
+
+## Link to Jira ticket(s)
+

package/.github/workflows/empty.yml

@@ -0,0 +1,11 @@
+name: empty-passing-test
+on:
+  pull_request
+jobs:
+  test:
+    runs-on: ubuntu-20.04
+    strategy:
+      matrix:
+        node-version: [16.17.0]
+    steps:
+      - run: 'echo "empty test for passing status checks"'

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

@@ -0,0 +1,27 @@
+name: sdk-lib-tests
+on:
+  pull_request:
+    # run this workflow when files these files change
+    paths:
+      - "**"
+  workflow_dispatch: # allow running in github actions manually
+jobs:
+  test:
+    runs-on: ubuntu-20.04
+    steps:
+      - name: Node.js
+        uses: actions/setup-node@v3
+        with:
+          node-version: ${{ matrix.node-version }}
+
+      - uses: actions/checkout@v3
+
+      - name: NPM Install
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm ci
+
+      - name: Unit Tests -
+        env:
+          NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: npm test

package/README.md

@@ -0,0 +1,2 @@
+# Contrail Extensions SDK
+Client library for interfacing with VibeIQ's services and apps from an extension.

package/home-hero.svg

@@ -0,0 +1,11 @@
+<svg width="635" height="433" viewBox="0 0 635 433" fill="none" xmlns="http://www.w3.org/2000/svg">
+<g clip-path="url(#clip0_309_15692)">
+<path d="M656.604 384.076C457.662 384.076 414.538 48.9114 216.574 48.9114C172.144 48.9339 129.54 66.5999 98.1308 98.0252C66.7213 129.451 49.077 172.063 49.077 216.494" stroke="#202532" stroke-width="97.8221" stroke-miterlimit="10"/>
+<path d="M49.077 216.494C49.077 309.04 128.454 384.076 216.66 384.076C415.601 384.076 457.747 48.9114 656.689 48.9114C701.134 48.9114 743.76 66.5673 775.188 97.9952C806.615 129.423 824.272 172.048 824.272 216.494C824.272 260.94 806.615 303.565 775.188 334.993C743.76 366.421 701.134 384.076 656.689 384.076" stroke="#00ABE9" stroke-width="97.8221" stroke-miterlimit="10"/>
+</g>
+<defs>
+<clipPath id="clip0_309_15692">
+<rect width="873.016" height="432.987" fill="white" transform="translate(0.166809)"/>
+</clipPath>
+</defs>
+</svg>

package/lib/actions/actions.d.ts

@@ -0,0 +1,14 @@
+import { AppContext } from "../apps/app-context";
+import { EntitiesClientAction } from "../entities/entities-action-handler";
+import { AppExtensionMessage } from "../extensions/app-extension-message-handler";
+export interface RegisterExtensionActions {
+    init(context: AppContext): void;
+}
+export interface ExtensionActions {
+    close(): void;
+    sendMessageToEntitiesClient(message: EntitiesClientAction): Promise<any>;
+    sendMessageToHost(message: AppExtensionMessage): void;
+}
+export declare let EXTENSION_ACTIONS: ExtensionActions;
+export declare function setExtensionActions(actions: ExtensionActions): void;
+export declare function getExtensionActions(): ExtensionActions;

package/lib/actions/actions.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getExtensionActions = exports.setExtensionActions = exports.EXTENSION_ACTIONS = void 0;
+function setExtensionActions(actions) {
+    exports.EXTENSION_ACTIONS = actions;
+}
+exports.setExtensionActions = setExtensionActions;
+function getExtensionActions() {
+    return exports.EXTENSION_ACTIONS;
+}
+exports.getExtensionActions = getExtensionActions;

package/lib/actions/index.d.ts

@@ -0,0 +1 @@
+export * from './actions';

package/lib/actions/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./actions"), exports);

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

@@ -0,0 +1,18 @@
+import { User } from "@contrail/entity-types";
+export declare enum VibeIQAppType {
+    boards = "boards",
+    plan = "plan",
+    showcase = "showcase"
+}
+export interface AppContext {
+    appContext?: {
+        plan?: any;
+        board?: any;
+        selectedElements?: any[];
+        vibeIQApp?: VibeIQAppType;
+    };
+    user?: User;
+}
+export declare const CONTEXT: AppContext;
+export declare function setAppContext(context: AppContext): void;
+export declare function getAppContext(): AppContext;

package/lib/apps/app-context.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getAppContext = exports.setAppContext = exports.CONTEXT = exports.VibeIQAppType = void 0;
+var VibeIQAppType;
+(function (VibeIQAppType) {
+    VibeIQAppType["boards"] = "boards";
+    VibeIQAppType["plan"] = "plan";
+    VibeIQAppType["showcase"] = "showcase";
+})(VibeIQAppType = exports.VibeIQAppType || (exports.VibeIQAppType = {}));
+exports.CONTEXT = {};
+function setAppContext(context) {
+    Object.assign(exports.CONTEXT, context);
+}
+exports.setAppContext = setAppContext;
+function getAppContext() {
+    return exports.CONTEXT;
+}
+exports.getAppContext = getAppContext;

package/lib/apps/boards.d.ts

@@ -0,0 +1,5 @@
+export declare class BoardsApp {
+    static getCurrentBoard(): any;
+    static addElements(elements: Array<any>): void;
+    private static validateBoardContext;
+}

package/lib/apps/boards.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BoardsApp = void 0;
+const actions_1 = require("../actions/actions");
+const app_context_1 = require("./app-context");
+class BoardsApp {
+    static getCurrentBoard() {
+        BoardsApp.validateBoardContext();
+        return (0, app_context_1.getAppContext)().appContext.board;
+    }
+    static addElements(elements) {
+        BoardsApp.validateBoardContext();
+        const actions = (0, actions_1.getExtensionActions)();
+        actions.sendMessageToHost({ command: 'board:add_elements', data: elements });
+    }
+    static validateBoardContext() {
+        const context = (0, app_context_1.getAppContext)();
+        if (context.appContext.vibeIQApp !== app_context_1.VibeIQAppType.boards || !context.appContext.board) {
+            throw new Error("App extension has not been initialized with Board context.");
+        }
+    }
+}
+exports.BoardsApp = BoardsApp;

package/lib/apps/index.d.ts

@@ -0,0 +1,3 @@
+export { getAppContext, AppContext, VibeIQAppType } from './app-context';
+export * from './boards';
+export * from './plan';

package/lib/apps/index.js

@@ -0,0 +1,22 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VibeIQAppType = exports.getAppContext = void 0;
+var app_context_1 = require("./app-context");
+Object.defineProperty(exports, "getAppContext", { enumerable: true, get: function () { return app_context_1.getAppContext; } });
+Object.defineProperty(exports, "VibeIQAppType", { enumerable: true, get: function () { return app_context_1.VibeIQAppType; } });
+__exportStar(require("./boards"), exports);
+__exportStar(require("./plan"), exports);

package/lib/apps/plan.d.ts

@@ -0,0 +1,7 @@
+export declare class PlanApp {
+    static getCurrentPlan(): any;
+    static addRows(collectionElements: Array<any>): void;
+    static clearSelectedRows(): void;
+    static showMessage(message: string): void;
+    private static validatePlanContext;
+}

package/lib/apps/plan.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PlanApp = void 0;
+const actions_1 = require("../actions/actions");
+const app_context_1 = require("./app-context");
+class PlanApp {
+    static getCurrentPlan() {
+        PlanApp.validatePlanContext();
+        return (0, app_context_1.getAppContext)().appContext.plan;
+    }
+    static addRows(collectionElements) {
+        PlanApp.validatePlanContext();
+        const actions = (0, actions_1.getExtensionActions)();
+        actions.sendMessageToHost({ command: 'plan:add_rows', data: collectionElements });
+    }
+    static clearSelectedRows() {
+        PlanApp.validatePlanContext();
+        const actions = (0, actions_1.getExtensionActions)();
+        actions.sendMessageToHost({ command: 'plan:clear_selected_rows' });
+    }
+    static showMessage(message) {
+        PlanApp.validatePlanContext();
+        const actions = (0, actions_1.getExtensionActions)();
+        actions.sendMessageToHost({ command: 'plan:show_message', data: message });
+    }
+    static validatePlanContext() {
+        const context = (0, app_context_1.getAppContext)();
+        if (context.appContext.vibeIQApp !== app_context_1.VibeIQAppType.plan || !context.appContext.plan) {
+            throw new Error("App extension has not been initialized with Plan context.");
+        }
+    }
+}
+exports.PlanApp = PlanApp;

package/lib/entities/entities-action-handler.d.ts

@@ -0,0 +1,13 @@
+export interface EntitiesClientAction {
+    method: string;
+    options: any;
+}
+export interface EntitiesClientResults {
+    success: boolean;
+    data?: any;
+    error?: string;
+}
+export declare class EntitiesActionHandler {
+    static handleActionFromExtension(action: EntitiesClientAction): Promise<EntitiesClientResults>;
+    private static executeAction;
+}

package/lib/entities/entities-action-handler.js

@@ -0,0 +1,43 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitiesActionHandler = void 0;
+const sdk_1 = require("@contrail/sdk");
+class EntitiesActionHandler {
+    static handleActionFromExtension(action) {
+        return __awaiter(this, void 0, void 0, function* () {
+            try {
+                const data = yield EntitiesActionHandler.executeAction(action);
+                return { success: true, data };
+            }
+            catch (e) {
+                return { success: false, error: e.message };
+            }
+        });
+    }
+    static executeAction(action) {
+        return __awaiter(this, void 0, void 0, function* () {
+            switch (action.method) {
+                case 'get':
+                    return yield new sdk_1.Entities().get(action.options);
+                case 'create':
+                    return yield new sdk_1.Entities().create(action.options);
+                case 'batchCreate':
+                    return yield new sdk_1.Entities().batchCreate(action.options);
+                case 'update':
+                    return yield new sdk_1.Entities().update(action.options);
+                case 'batchUpdate':
+                    return yield new sdk_1.Entities().batchUpdate(action.options);
+            }
+        });
+    }
+}
+exports.EntitiesActionHandler = EntitiesActionHandler;

package/lib/entities/entities-web-client.d.ts

@@ -0,0 +1,20 @@
+import { EntitiesClientBatchCreateOptions, EntitiesClientBatchUpdateOptions, EntitiesClientCreateOptions, EntitiesClientGetOptions, API_VERSION } from "@contrail/sdk";
+declare class EntitiesClientUpdateOptions {
+    entityName?: string;
+    object: any;
+    id?: string;
+    reference?: string;
+    relation?: string;
+    relationId?: string;
+    apiVersion?: API_VERSION;
+    suffix?: string;
+}
+export declare class EntitiesClient {
+    get(options: EntitiesClientGetOptions): Promise<any | any[]>;
+    create(options: EntitiesClientCreateOptions): Promise<any>;
+    batchCreate(options: EntitiesClientBatchCreateOptions): Promise<any[]>;
+    update(options: EntitiesClientUpdateOptions): Promise<any>;
+    batchUpdate(options: EntitiesClientBatchUpdateOptions): Promise<any[]>;
+    private validateAndReturnEntityClientResults;
+}
+export {};

package/lib/entities/entities-web-client.js

@@ -0,0 +1,55 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EntitiesClient = void 0;
+const actions_1 = require("../actions/actions");
+class EntitiesClientUpdateOptions {
+}
+class EntitiesClient {
+    get(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({ method: 'get', options });
+            return this.validateAndReturnEntityClientResults(results);
+        });
+    }
+    create(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({ method: 'create', options });
+            return this.validateAndReturnEntityClientResults(results);
+        });
+    }
+    batchCreate(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({ method: 'batchCreate', options });
+            return this.validateAndReturnEntityClientResults(results);
+        });
+    }
+    update(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({ method: 'update', options });
+            return this.validateAndReturnEntityClientResults(results);
+        });
+    }
+    batchUpdate(options) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const results = yield (0, actions_1.getExtensionActions)().sendMessageToEntitiesClient({ method: 'batchUpdate', options });
+            return this.validateAndReturnEntityClientResults(results);
+        });
+    }
+    validateAndReturnEntityClientResults(results) {
+        var _a;
+        if (!results.success) {
+            throw new Error((_a = results.error) !== null && _a !== void 0 ? _a : 'Entity operation failed.');
+        }
+        return results.data;
+    }
+}
+exports.EntitiesClient = EntitiesClient;

package/lib/entities/index.d.ts

@@ -0,0 +1 @@
+export * from './entities-web-client';

package/lib/entities/index.js

@@ -0,0 +1,17 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./entities-web-client"), exports);

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

@@ -0,0 +1,6 @@
+import { AppContext } from '../apps/app-context';
+import { AppExtensionMessageHandler } from './app-extension-message-handler';
+export declare class AppExtensionHost {
+    static registerHostWithAppExtension(iframe: HTMLIFrameElement, context: AppContext, customMessageHandler: AppExtensionMessageHandler): Promise<void>;
+    private static getExtensionActionsToRunOnHost;
+}

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

@@ -0,0 +1,48 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppExtensionHost = void 0;
+const penpal_1 = require("penpal");
+const entities_action_handler_1 = require("../entities/entities-action-handler");
+class AppExtensionHost {
+    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 appExtension = yield connection.promise;
+                console.log('[HostApp] Connected to app extension.');
+                appExtension.init(context);
+            }
+            catch (error) {
+                console.error("Failed to connect host app with app extension:", error);
+                throw error;
+            }
+        });
+    }
+    static getExtensionActionsToRunOnHost(customMessageHandler) {
+        return {
+            close() {
+                customMessageHandler.handleMessage({ command: 'close' });
+            },
+            sendMessageToEntitiesClient(message) {
+                return entities_action_handler_1.EntitiesActionHandler.handleActionFromExtension(message);
+            },
+            sendMessageToHost(message) {
+                customMessageHandler.handleMessage(message);
+            }
+        };
+    }
+}
+exports.AppExtensionHost = AppExtensionHost;

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

@@ -0,0 +1,7 @@
+export interface AppExtensionMessage {
+    command: string;
+    data?: any;
+}
+export interface AppExtensionMessageHandler {
+    handleMessage: (message: AppExtensionMessage) => {};
+}

package/lib/extensions/app-extension-message-handler.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,6 @@
+export declare class AppExtension {
+    static registerAppExtension(): Promise<void>;
+    private static getExtensionActions;
+    private static initAppExtension;
+    static close(): void;
+}

package/lib/extensions/app-extension.js

@@ -0,0 +1,51 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AppExtension = void 0;
+const penpal_1 = require("penpal");
+const app_context_1 = require("../apps/app-context");
+const actions_1 = require("../actions/actions");
+class AppExtension {
+    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 hostApp = yield connection.promise;
+                console.log('[AppExtension] Connected to host app.');
+                (0, actions_1.setExtensionActions)(hostApp);
+            }
+            catch (error) {
+                console.error("Failed to connect app extension with host application:", error);
+                throw error;
+            }
+        });
+    }
+    static getExtensionActions() {
+        return {
+            init(context) {
+                return AppExtension.initAppExtension(context);
+            }
+        };
+    }
+    static initAppExtension(context) {
+        return __awaiter(this, void 0, void 0, function* () {
+            console.log("[AppExtension]: Initialized: Received context: ", context);
+            (0, app_context_1.setAppContext)(context);
+        });
+    }
+    ;
+    static close() {
+        (0, actions_1.getExtensionActions)().close();
+    }
+}
+exports.AppExtension = AppExtension;

package/lib/extensions/index.d.ts

@@ -0,0 +1,2 @@
+export * from './app-extension';
+export * from './app-extension-message-handler';

package/lib/extensions/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./app-extension"), exports);
+__exportStar(require("./app-extension-message-handler"), exports);

package/lib/index.d.ts

@@ -0,0 +1,3 @@
+export * from './apps';
+export * from './entities';
+export * from './extensions';

package/lib/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./apps"), exports);
+__exportStar(require("./entities"), exports);
+__exportStar(require("./extensions"), exports);

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@contrail/extensions-sdk",
+  "version": "1.0.0-alpha.0",
+  "description": "Client library for interfacing with VibeIQ's services and apps from an extension.",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "format": "prettier --write \"src/**/*.ts\" \"src/**/*.js\"",
+    "lint": "tslint -p tsconfig.json",
+    "generate-docs": "npx typedoc src/index.ts --disableSources --excludeInternal  --plugin typedoc-plugin-extras --favicon home-hero.svg",
+    "test": "jest"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "@contrail/sdk": "^1.3.8",
+    "@contrail/entity-types": "^1.1.35",
+    "penpal": "^6.2.2"
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.2",
+    "@types/node": "^14.10.1",
+    "jest": "^29.5.0",
+    "prettier": "^1.19.1",
+    "ts-jest": "^29.1.1",
+    "tslint": "^5.11.0",
+    "tslint-config-prettier": "^1.18.0",
+    "typedoc": "^0.25.7",
+    "typedoc-plugin-extras": "^3.0.0",
+    "typescript": "^4.0.0"
+  },
+  "jest": {
+    "moduleFileExtensions": [
+      "js",
+      "json",
+      "ts"
+    ],
+    "rootDir": "src",
+    "testRegex": ".spec.ts$",
+    "transform": {
+      "^.+\\.(t|j)s$": "ts-jest"
+    },
+    "coverageDirectory": "../coverage",
+    "testEnvironment": "node"
+  }
+}