lucid-extension-sdk 0.0.303 → 0.0.306

package/commandtypes.d.ts

@@ -25,6 +25,7 @@ import { PanelLocation } from './ui/panel';
  * Before you add a new command bring it up in #api-committee to get feedback.
  */
 export declare const enum CommandName {
+    AddAuthorizationFlowHandler = "aafh",
     AddCardIntegration = "aci",
     AddDiagramFromMermaid = "adfm",
     AddDiagramFromText = "adft",
@@ -166,6 +167,10 @@ export declare const commandTitles: Map<CommandName, string>;
  * IMPORTANT - Before you add a new command bring it up in #api-committee to get feedback
  */
 export type CommandArgs = {
+    [CommandName.AddAuthorizationFlowHandler]: {
+        query: AddAuthorizationFlowHandlerQuery;
+        result: AddAuthorizationFlowHandlerResult;
+    };
     [CommandName.AddCardIntegration]: {
         query: AddCardIntegrationQuery;
         result: AddCardIntegrationResult;
@@ -687,6 +692,22 @@ export type CommandArgs = {
         result: ZOrderResult;
     };
 };
+export type AuthorizationFlowHandlerProvider = string;
+export declare enum AuthorizationFlowHandlerStage {
+    OnFailure = "onFailure"
+}
+export type AddAuthorizationFlowHandlerQuery = {
+    /**
+     * Specifies the callback function to run when the handler is triggered.
+     * String, not a function itself; this is the name of the client's registered action hook
+     */
+    'c': string;
+    /** The name of the auth provider (as specified in the package's manifest.json) that triggers this handler. */
+    'p': AuthorizationFlowHandlerProvider;
+    /** The stage during the auth flow when this handler is triggered. */
+    's': AuthorizationFlowHandlerStage;
+};
+export type AddAuthorizationFlowHandlerResult = undefined;
 export type AddCardIntegrationQuery = {
     /** Title/name */
     'n': string;
@@ -709,7 +730,9 @@ export type AddCardIntegrationQuery = {
         /** Field name -> callback name tuples for searching for legal field values in an enum */
         'fvsc'?: [string, string][] | undefined;
     };
-    /** Show intro if user has not yet authorized this integration */
+    /** Show intro if user has not yet authorized this integration
+     *  String, not function; this is the name of the client's registered action hook
+     */
     'i'?: string | undefined;
     /** Get default config action */
     'gdc': string;

package/commandtypes.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ZOrderOperation = exports.isRawSendXHRResponse = exports.MermaidDiagramType = exports.GetLLMContextType = exports.GetItemsAtSearchType = exports.GetDocumentChunksType = exports.HashAlgorithmEnum = exports.commandTitles = void 0;
+exports.ZOrderOperation = exports.isRawSendXHRResponse = exports.MermaidDiagramType = exports.GetLLMContextType = exports.GetItemsAtSearchType = exports.GetDocumentChunksType = exports.HashAlgorithmEnum = exports.AuthorizationFlowHandlerStage = exports.commandTitles = void 0;
 const checks_1 = require("./core/checks");
 /** @ignore */
 exports.commandTitles = new Map([
+    ["aafh" /* CommandName.AddAuthorizationFlowHandler */, 'AddAuthorizationFlowHandler'],
     ["aci" /* CommandName.AddCardIntegration */, 'AddCardIntegration'],
     ["adfm" /* CommandName.AddDiagramFromMermaid */, 'AddDiagramFromMermaid'],
     ["adft" /* CommandName.AddDiagramFromText */, 'AddDiagramFromText'],
@@ -129,6 +130,10 @@ exports.commandTitles = new Map([
     ["wsa" /* CommandName.WithSilentActions */, 'WithSilentActions'],
     ["z" /* CommandName.ZOrder */, 'ZOrder'],
 ]);
+var AuthorizationFlowHandlerStage;
+(function (AuthorizationFlowHandlerStage) {
+    AuthorizationFlowHandlerStage["OnFailure"] = "onFailure";
+})(AuthorizationFlowHandlerStage || (exports.AuthorizationFlowHandlerStage = AuthorizationFlowHandlerStage = {}));
 var HashAlgorithmEnum;
 (function (HashAlgorithmEnum) {
     /** Use the SHA 256 hashing algorithm */

package/core/authorizationflowhandlerregistry.d.ts

@@ -0,0 +1,16 @@
+import { AuthorizationFlowHandlerProvider, AuthorizationFlowHandlerStage } from '../commandtypes';
+import { EditorClient } from '../editorclient';
+export declare class AuthorizationFlowHandlerRegistry {
+    private static nextHookId;
+    private static nextHookName;
+    /**
+     * Register a function to be run at a given stage of the authorization flow for a provider.
+     *
+     * @param client A reference to the editor client.
+     * @param callback The function to run when the handler is triggered.
+     * @param stage The stage during the auth flow when this handler is triggered.
+     * @param provider The name of the auth provider (as specified in the package's manifest.json)
+     * that triggers this handler.
+     */
+    static registerAuthorizationFlowHandler(client: EditorClient, callback: () => void, stage: AuthorizationFlowHandlerStage, provider: AuthorizationFlowHandlerProvider): void;
+}

package/core/authorizationflowhandlerregistry.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AuthorizationFlowHandlerRegistry = void 0;
+class AuthorizationFlowHandlerRegistry {
+    static nextHookName() {
+        return '__authorizationflow__hook' + AuthorizationFlowHandlerRegistry.nextHookId++;
+    }
+    /**
+     * Register a function to be run at a given stage of the authorization flow for a provider.
+     *
+     * @param client A reference to the editor client.
+     * @param callback The function to run when the handler is triggered.
+     * @param stage The stage during the auth flow when this handler is triggered.
+     * @param provider The name of the auth provider (as specified in the package's manifest.json)
+     * that triggers this handler.
+     */
+    static registerAuthorizationFlowHandler(client, callback, stage, provider) {
+        const actionHookName = AuthorizationFlowHandlerRegistry.nextHookName();
+        client.registerAction(actionHookName, callback);
+        const serialized = {
+            'c': actionHookName,
+            's': stage,
+            'p': provider,
+        };
+        client.sendCommand("aafh" /* CommandName.AddAuthorizationFlowHandler */, serialized);
+    }
+}
+exports.AuthorizationFlowHandlerRegistry = AuthorizationFlowHandlerRegistry;
+AuthorizationFlowHandlerRegistry.nextHookId = 0;

package/core/cardintegration/lucidcardintegration.d.ts

@@ -63,8 +63,8 @@ export declare abstract class LucidCardIntegration {
         fieldValueSearchCallbacks?: Map<string, string>;
     };
     /**
-     * If specified, and the user hasn't yet authorized the data connector for this extension,
-     * this should show the user an intro dialog or take some other action.
+     * @deprecated Use AuthorizationFlowHandlerRegistry.registerAuthorizationFlowHandler.
+     * WARNING: Currently unused and does nothing.
      */
     showIntro?: () => void;
     /**

package/core/data/datasource/serializeddatasourceproperties.d.ts

@@ -14,6 +14,7 @@ export declare const isSerializedDataSourceProperties: (subject: unknown) => sub
         SourceType: (x: unknown) => x is import("./datasourcetype").DataSourceType;
         UpdateType: (x: unknown) => x is import("./upstreamupdatetype").UpstreamUpdateType;
         PatchType: (x: unknown) => x is import("./upstreampatchtype").UpstreamPatchType | null | undefined;
+        IsSyncingPaused: (x: unknown) => x is true | undefined;
         SourceConfig: typeof import("../../checks").isObject;
     }> | null | undefined;
     SourceForeignKeys: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{

package/core/data/datasource/serializedimporteddatasource.d.ts

@@ -53,6 +53,7 @@ export declare const isSerializedImportedDataSource: (subject: unknown) => subje
             SourceType: (x: unknown) => x is import("./datasourcetype").DataSourceType;
             UpdateType: (x: unknown) => x is import("./upstreamupdatetype").UpstreamUpdateType;
             PatchType: (x: unknown) => x is import("./upstreampatchtype").UpstreamPatchType | null | undefined;
+            IsSyncingPaused: (x: unknown) => x is true | undefined;
             SourceConfig: typeof isObject;
         }> | null | undefined;
         SourceForeignKeys: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
@@ -89,6 +90,7 @@ export declare const isSerializedPreviewData: (subject: unknown) => subject is i
             SourceType: (x: unknown) => x is import("./datasourcetype").DataSourceType;
             UpdateType: (x: unknown) => x is import("./upstreamupdatetype").UpstreamUpdateType;
             PatchType: (x: unknown) => x is import("./upstreampatchtype").UpstreamPatchType | null | undefined;
+            IsSyncingPaused: (x: unknown) => x is true | undefined;
             SourceConfig: typeof isObject;
         }> | null | undefined;
         SourceForeignKeys: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{

package/core/data/datasource/serializedupstreamconfig.d.ts

@@ -7,6 +7,7 @@ export interface SerializedUpstreamConfig {
     'SourceType': DataSourceType;
     'UpdateType': UpstreamUpdateType;
     'PatchType'?: UpstreamPatchType | null | undefined;
+    'IsSyncingPaused'?: true | undefined;
     'SourceConfig': {
         [index: string]: any;
     };
@@ -16,5 +17,6 @@ export declare const isSerializedUpstreamConfig: (subject: unknown) => subject i
     SourceType: (x: unknown) => x is DataSourceType;
     UpdateType: (x: unknown) => x is UpstreamUpdateType;
     PatchType: (x: unknown) => x is UpstreamPatchType | null | undefined;
+    IsSyncingPaused: (x: unknown) => x is true | undefined;
     SourceConfig: typeof isObject;
 }>;

package/core/data/datasource/serializedupstreamconfig.js

@@ -11,5 +11,6 @@ exports.isSerializedUpstreamConfig = (0, validators_1.strictObjectValidator)({
     'SourceType': (0, validators_1.enumValidator)(datasourcetype_1.DataSourceType),
     'UpdateType': (0, validators_1.enumValidator)(upstreamupdatetype_1.UpstreamUpdateType),
     'PatchType': (0, validators_1.nullableOption)((0, validators_1.enumValidator)(upstreampatchtype_1.UpstreamPatchType)),
+    'IsSyncingPaused': (0, validators_1.option)((0, checks_1.isLiteral)(true)),
     'SourceConfig': checks_1.isObject,
 });

package/core/data/datasource/upstreamconfig.d.ts

@@ -7,6 +7,7 @@ export interface UpstreamConfig {
     dataSourceType: DataSourceType;
     updateType: UpstreamUpdateType;
     patchType?: UpstreamPatchType | undefined;
+    isSyncingPaused?: true;
     sourceConfig: {
         [index: string]: any;
     };

package/core/data/datasource/upstreamconfig.js

@@ -7,17 +7,13 @@ function serializeUpstreamConfig(config) {
         'SourceType': config.dataSourceType,
         'UpdateType': config.updateType,
         'PatchType': config.patchType,
+        'IsSyncingPaused': config.isSyncingPaused,
         'SourceConfig': config.sourceConfig,
     };
 }
 exports.serializeUpstreamConfig = serializeUpstreamConfig;
 function deserializeUpstreamConfig(config) {
-    return {
-        dataSourceType: config['SourceType'],
-        updateType: config['UpdateType'],
-        patchType: config['PatchType'] === null ? undefined : config['PatchType'],
-        sourceConfig: config['SourceConfig'],
-    };
+    return Object.assign(Object.assign({ dataSourceType: config['SourceType'], updateType: config['UpdateType'], patchType: config['PatchType'] === null ? undefined : config['PatchType'] }, (config['IsSyncingPaused'] && { isSyncingPaused: true })), { sourceConfig: config['SourceConfig'] });
 }
 exports.deserializeUpstreamConfig = deserializeUpstreamConfig;
 function isSerializedSourceConfig(x) {

package/package.json

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