lucid-extension-sdk 0.0.173 → 0.0.174

package/commandtypes.d.ts

@@ -98,6 +98,7 @@ export declare const enum CommandName {
     OffsetItems = "oi",
     PatchDataItems = "pdi",
     Prompt = "p",
+    RegisterLinkImporter = "rli",
     RegisterPanel = "rp",
     RegisterUnfurl = "ru",
     ReloadExtension = "r",
@@ -449,6 +450,10 @@ export declare type CommandArgs = {
         query: PromptQuery;
         result: PromptResult;
     };
+    [CommandName.RegisterLinkImporter]: {
+        query: RegisterLinkImporterQuery;
+        result: RegisterLinkImporterResult;
+    };
     [CommandName.RegisterPanel]: {
         query: RegisterPanelQuery;
         result: RegisterPanelResult;
@@ -1127,6 +1132,17 @@ export declare type PromptQuery = {
     'b': string;
 };
 export declare type PromptResult = Promise<string | undefined>;
+export declare type RegisterLinkImporterQuery = {
+    /** ID of the link importer*/
+    'id': string;
+    /** Action to call to get links for bulk import */
+    'a': string;
+    /** Label for the menu item */
+    'l': string;
+    /** Icon URL of the menu item, preferably a base64-encoded URL */
+    'i': string;
+};
+export declare type RegisterLinkImporterResult = void;
 export declare type RegisterPanelQuery = {
     /** Name of the panel's action for receiving events; generated automatically by Panel base class */
     'n': string;

package/commandtypes.js

@@ -79,6 +79,7 @@ exports.commandTitles = new Map([
     ["oi" /* CommandName.OffsetItems */, 'OffsetItems'],
     ["pdi" /* CommandName.PatchDataItems */, 'PatchDataItems'],
     ["p" /* CommandName.Prompt */, 'Prompt'],
+    ["rli" /* CommandName.RegisterLinkImporter */, 'RegisterLinkImporter'],
     ["rp" /* CommandName.RegisterPanel */, 'RegisterPanel'],
     ["ru" /* CommandName.RegisterUnfurl */, 'RegisterUnfurl'],
     ["r" /* CommandName.ReloadExtension */, 'ReloadExtension'],

package/core/linkimporter/linkimporter.d.ts

@@ -0,0 +1,16 @@
+export interface LinkImporter {
+    /** The id for this link importer */
+    id: string;
+    /** The text to display on the menu item */
+    label: string;
+    /** The icon to display on the menu item.
+     * A URL (a data URI is fine) pointing to an icon representing the integration.
+     * This will be displayed at up to 32x32 CSS pixels in size. */
+    iconUrl: string;
+    /** A method for getting URLs that will be imported onto the canvas as link unfurl blocks.
+     * For example, this method could display a file picker, and return URLs for all of the selected files
+     *
+     * @return an array of urls for import
+     * */
+    getLinksForBulkImport: () => Promise<string[]>;
+}

package/core/linkimporter/linkimporter.js

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

package/editorclient.d.ts

@@ -1,5 +1,6 @@
 import { CommandArgs, CommandName, HashAlgorithmEnum, TriggerAuthFlowResult, UnionToIntersection } from './commandtypes';
 import { JsonSerializable } from './core/jsonserializable';
+import { LinkImporter } from './core/linkimporter/linkimporter';
 import { UnfurlCallbacks } from './core/unfurl/unfurlcallbacks';
 import { BinaryXHRResponse, OAuthXHRRequest, TextXHRResponse, XHRRequest, XHRResponse } from './core/xhr';
 import { CollectionProxy } from './data/collectionproxy';
@@ -179,6 +180,11 @@ export declare class EditorClient {
      * @param callbacks The callbacks to call when a link matching the domain is pasted.
      */
     registerUnfurlHandler(domain: string, callbacks: UnfurlCallbacks): void;
+    /**
+     * Registers a menu item for bulk importing links.
+     * @param linkImporter The importer for getting URLs that will be imported onto the canvas as link unfurl blocks
+     */
+    registerLinkImporter(linkImporter: LinkImporter): void;
     /**
      * @ignore
      * @deprecated Use registerUnfurlHandler instead.

package/editorclient.js

@@ -305,6 +305,20 @@ class EditorClient {
         });
         this.sendCommand("ru" /* CommandName.RegisterUnfurl */, { 'd': domain, 'a': action });
     }
+    /**
+     * Registers a menu item for bulk importing links.
+     * @param linkImporter The importer for getting URLs that will be imported onto the canvas as link unfurl blocks
+     */
+    registerLinkImporter(linkImporter) {
+        const action = this.getUniqueActionName();
+        this.registerAction(action, async () => { var _a; return (_a = (await linkImporter.getLinksForBulkImport())) !== null && _a !== void 0 ? _a : []; });
+        this.sendCommand("rli" /* CommandName.RegisterLinkImporter */, {
+            'id': linkImporter.id,
+            'a': action,
+            'l': linkImporter.label,
+            'i': linkImporter.iconUrl,
+        });
+    }
     /**
      * @ignore
      * @deprecated Use registerUnfurlHandler instead.

package/package.json

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