lucid-extension-sdk 0.0.84 → 0.0.85

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "lucid-extension-sdk",
-    "version": "0.0.84",
+    "version": "0.0.85",
     "description": "Utility classes for writing Lucid Software editor extensions",
     "main": "sdk/index.js",
     "types": "sdk/index.d.ts",

package/sdk/commandtypes.d.ts

@@ -28,6 +28,7 @@ export declare const enum CommandName {
     AwaitImport = "ai",
     Bootstrap = "b",
     CancelDragBlockToCanvas = "cdc",
+    CanEditPackageSettings = "ceps",
     Confirm = "c",
     CreateBlock = "cb",
     CreateCollection = "cc",
@@ -51,6 +52,7 @@ export declare const enum CommandName {
     GetDataItemField = "gdif",
     GetElementType = "get",
     GetItemPageId = "gip",
+    GetPackageSettings = "gps",
     GetProduct = "gpr",
     GetProperty = "gp",
     GetReferenceKey = "grk",
@@ -95,6 +97,7 @@ export declare const enum CommandName {
     SetText = "st",
     ShowModal = "sm",
     ShowPanel = "spn",
+    ShowPackageSettingsModal = "spsm",
     SleepForTestCase = "sleep",
     StartDragBlockToCanvas = "sdc",
     StartPDFUploadRequest = "pdf",
@@ -143,6 +146,10 @@ export declare type CommandArgs = {
         query: BootstrapQuery;
         result: BootstrapResult;
     };
+    [CommandName.CanEditPackageSettings]: {
+        query: CanEditPackageSettingsQuery;
+        result: CanEditPackageSettingsResult;
+    };
     [CommandName.CancelDragBlockToCanvas]: {
         query: CancelDragBlockToCanvasQuery;
         result: CancelDragBlockToCanvasResult;
@@ -239,6 +246,10 @@ export declare type CommandArgs = {
         query: GetItemPageIdQuery;
         result: GetItemPageIdResult;
     };
+    [CommandName.GetPackageSettings]: {
+        query: GetPackageSettingsQuery;
+        result: GetPackageSettingsResult;
+    };
     [CommandName.GetProduct]: {
         query: GetProductQuery;
         result: GetProductResult;
@@ -411,6 +422,10 @@ export declare type CommandArgs = {
         query: ShowModalQuery;
         result: ShowModalResult;
     };
+    [CommandName.ShowPackageSettingsModal]: {
+        query: ShowPackageSettingsModalQuery;
+        result: ShowPackageSettingsModalResult;
+    };
     [CommandName.ShowPanel]: {
         query: ShowPanelQuery;
         result: ShowPanelResult;
@@ -569,6 +584,8 @@ export declare type BootstrapQuery = {
     'm'?: boolean;
 };
 export declare type BootstrapResult = Promise<void>;
+export declare type CanEditPackageSettingsQuery = undefined;
+export declare type CanEditPackageSettingsResult = Promise<boolean>;
 export declare type CancelDragBlockToCanvasQuery = void;
 export declare type CancelDragBlockToCanvasResult = undefined;
 export declare type ConfirmQuery = {
@@ -771,6 +788,8 @@ export declare type GetPropertyQuery = {
     'p': string;
 };
 export declare type GetPropertyResult = JsonSerializable;
+export declare type GetPackageSettingsQuery = undefined;
+export declare type GetPackageSettingsResult = Promise<Record<string, JsonSerializable>>;
 export declare type GetRelativeLinePositionQuery = {
     /** Block or line ID to check the connections on */
     'id': string;
@@ -1034,6 +1053,8 @@ export declare type ShowModalQuery = {
     'c': string;
 };
 export declare type ShowModalResult = undefined;
+export declare type ShowPackageSettingsModalQuery = undefined;
+export declare type ShowPackageSettingsModalResult = Promise<void>;
 export declare type ShowPanelQuery = {
     /** Name of the panel's action for receiving events, i.e. RegisterPanelQuery['n'] */
     'n': string;

package/sdk/commandtypes.js

@@ -12,6 +12,7 @@ exports.commandTitles = new Map([
     ["av" /* CommandName.AnimateViewport */, 'AnimateViewport'],
     ["ai" /* CommandName.AwaitImport */, 'AwaitImport'],
     ["b" /* CommandName.Bootstrap */, 'Bootstrap'],
+    ["ceps" /* CommandName.CanEditPackageSettings */, 'CanEditPackageSettings'],
     ["cdc" /* CommandName.CancelDragBlockToCanvas */, 'CancelDragBlockToCanvas'],
     ["c" /* CommandName.Confirm */, 'Confirm'],
     ["cb" /* CommandName.CreateBlock */, 'CreateBlock'],
@@ -34,6 +35,7 @@ exports.commandTitles = new Map([
     ["gdif" /* CommandName.GetDataItemField */, 'GetDataItemField'],
     ["get" /* CommandName.GetElementType */, 'GetElementType'],
     ["gip" /* CommandName.GetItemPageId */, 'GetItemPageId'],
+    ["gps" /* CommandName.GetPackageSettings */, 'GetPackageSettings'],
     ["gpr" /* CommandName.GetProduct */, 'GetProduct'],
     ["gp" /* CommandName.GetProperty */, 'GetProperty'],
     ["grk" /* CommandName.GetReferenceKey */, 'GetReferenceKey'],
@@ -75,6 +77,7 @@ exports.commandTitles = new Map([
     ["srk" /* CommandName.SetReferenceKey */, 'SetReferenceKey'],
     ["ssd" /* CommandName.SetShapeData */, 'SetShapeData'],
     ["sm" /* CommandName.ShowModal */, 'ShowModal'],
+    ["spsm" /* CommandName.ShowPackageSettingsModal */, 'ShowPackageSettingsModal'],
     ["spn" /* CommandName.ShowPanel */, 'ShowPanel'],
     ["sleep" /* CommandName.SleepForTestCase */, 'SleepForTestCase'],
     ["sdc" /* CommandName.StartDragBlockToCanvas */, 'StartDragBlockToCanvas'],

package/sdk/core/object.d.ts

@@ -1,3 +1,6 @@
 export declare function objectEvery<T, O extends {
     [key: string]: any;
 }>(obj: O, f: (this: T | undefined, _0: O[typeof _1], _1: string & keyof O, _2: O) => any, opt_this?: T): boolean;
+export declare function entries<T>(obj: {
+    [key: string]: T;
+}): [string, T][];

package/sdk/core/object.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.objectEvery = void 0;
+exports.entries = exports.objectEvery = void 0;
 function objectEvery(obj, f, opt_this) {
     for (const key in obj) {
         if (!f.call(opt_this, obj[key], key, obj)) {
@@ -10,3 +10,8 @@ function objectEvery(obj, f, opt_this) {
     return true;
 }
 exports.objectEvery = objectEvery;
+// TODO: Placeholder until we adopt ES8 and can use Object.entries(obj)
+function entries(obj) {
+    return Object.keys(obj).map((key) => [key, obj[key]]);
+}
+exports.entries = entries;

package/sdk/editorclient.d.ts

@@ -65,6 +65,31 @@ export declare class EditorClient {
      * @throws A string with an error from the data sync server
      */
     performDataAction(flowName: string, dataConnectorName: string, syncDataSourceId?: undefined | string, flowData?: unknown, async?: boolean): Promise<DataActionResponse>;
+    /**
+     * If the extension package containing this editor extension has configurable settings,
+     * show a standard modal allowing the user to view or change those settings.
+     *
+     * If the user does not have permission to change settings on this installation of this
+     * extension, or if no settings exist, an error is thrown.
+     *
+     * @returns A promise that resolves when the user closes the settings modal.
+     */
+    showPackageSettingsModal(): Promise<void>;
+    /**
+     * If the extension package containing this editor extension has configurable settings,
+     * fetch the current values of those settings for this installation of this extension.
+     *
+     * Only settings that have been set by the installing user will have a value in the map,
+     * other settings will be missing.
+     *
+     * @returns A promise that resolves to a map of setting names to current setting values
+     */
+    getPackageSettings(): Promise<Map<string, JsonSerializable>>;
+    /**
+     * @returns True if the current user is allowed to edit package settings on this installation
+     * of this extension (if any settings exist), or false otherwise.
+     */
+    canEditPackageSettings(): Promise<boolean>;
     awaitDataImport(dataConnectorName: string, syncDataSourceId: undefined | string, syncCollectionId: string, primaryKeys: string[], timeout?: number): Promise<CollectionProxy>;
     /**
      * Make a network request

package/sdk/editorclient.js

@@ -4,6 +4,7 @@ exports.EditorClient = void 0;
 const commandtypes_1 = require("./commandtypes");
 const base64_1 = require("./core/base64");
 const checks_1 = require("./core/checks");
+const object_1 = require("./core/object");
 const unfurlcallbacks_1 = require("./core/unfurl/unfurlcallbacks");
 const unfurldetails_1 = require("./core/unfurl/unfurldetails");
 const unfurlrefresherrortype_1 = require("./core/unfurl/unfurlrefresherrortype");
@@ -119,6 +120,37 @@ class EditorClient {
             'json': result['j'],
         };
     }
+    /**
+     * If the extension package containing this editor extension has configurable settings,
+     * show a standard modal allowing the user to view or change those settings.
+     *
+     * If the user does not have permission to change settings on this installation of this
+     * extension, or if no settings exist, an error is thrown.
+     *
+     * @returns A promise that resolves when the user closes the settings modal.
+     */
+    async showPackageSettingsModal() {
+        return this.sendCommand("spsm" /* CommandName.ShowPackageSettingsModal */, undefined);
+    }
+    /**
+     * If the extension package containing this editor extension has configurable settings,
+     * fetch the current values of those settings for this installation of this extension.
+     *
+     * Only settings that have been set by the installing user will have a value in the map,
+     * other settings will be missing.
+     *
+     * @returns A promise that resolves to a map of setting names to current setting values
+     */
+    async getPackageSettings() {
+        return new Map((0, object_1.entries)(await this.sendCommand("gps" /* CommandName.GetPackageSettings */, undefined)));
+    }
+    /**
+     * @returns True if the current user is allowed to edit package settings on this installation
+     * of this extension (if any settings exist), or false otherwise.
+     */
+    async canEditPackageSettings() {
+        return this.sendCommand("ceps" /* CommandName.CanEditPackageSettings */, undefined);
+    }
     async awaitDataImport(dataConnectorName, syncDataSourceId, syncCollectionId, primaryKeys, timeout = 30000) {
         return new collectionproxy_1.CollectionProxy(await this.sendCommand("ai" /* CommandName.AwaitImport */, {
             'n': dataConnectorName,