lucid-extension-sdk 0.0.125 → 0.0.127

package/package.json

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

package/sdk/commandtypes.d.ts

@@ -27,6 +27,7 @@ export declare const enum CommandName {
     AddSpreadsheetIntegration = "asi",
     Alert = "a",
     AnimateViewport = "av",
+    AwaitDataSourceImport = "adi",
     AwaitImport = "ai",
     Bootstrap = "b",
     CancelDragBlockToCanvas = "cdc",
@@ -91,6 +92,7 @@ export declare const enum CommandName {
     RegisterUnfurl = "ru",
     ReloadExtension = "r",
     SendOAuthRequest = "oauth",
+    SendAsyncOAuthRequest = "aoauth",
     SendPermanentTokenRequest = "perm",
     SendUIMessage = "suim",
     SendXHR = "xhr",
@@ -149,6 +151,10 @@ export declare type CommandArgs = {
         query: AnimateViewportQuery;
         result: AnimateViewportResult;
     };
+    [CommandName.AwaitDataSourceImport]: {
+        query: AwaitDataSourceImportQuery;
+        result: AwaitDataSourceImportResult;
+    };
     [CommandName.AwaitImport]: {
         query: AwaitImportQuery;
         result: AwaitImportResult;
@@ -405,6 +411,10 @@ export declare type CommandArgs = {
         query: SendOAuthRequestQuery;
         result: SendOAuthRequestResponse;
     };
+    [CommandName.SendAsyncOAuthRequest]: {
+        query: SendAsyncOAuthRequestQuery;
+        result: SendOAuthRequestResponse;
+    };
     [CommandName.SendPermanentTokenRequest]: {
         query: SendPermanentTokenRequestQuery;
         result: SendOAuthRequestResponse;
@@ -612,6 +622,14 @@ export declare type AlertQuery = {
 };
 /** True if they click OK, false otherwise */
 export declare type AlertResult = Promise<boolean>;
+export declare type AwaitDataSourceImportQuery = {
+    /** Data Connector Name */
+    'n': string;
+    /** Sync data source ID Nonce */
+    's': string;
+};
+/** Promise resolving to the data source ID where the data arrived */
+export declare type AwaitDataSourceImportResult = Promise<string>;
 export declare type AwaitImportQuery = {
     /** Data Connector Name */
     'n': string;
@@ -1012,6 +1030,10 @@ export declare type SendOAuthRequestQuery = SendXHRQuery & {
     /** Post Result To */
     'prt'?: string | undefined;
 };
+export declare type SendAsyncOAuthRequestQuery = SendXHRQuery & {
+    /** OAuth provider name as specified in the package manifest */
+    'p': string;
+};
 export declare type SendPermanentTokenRequestQuery = SendXHRQuery & {
     /** Permanent token provider name as specified in the package manifest */
     'p': string;

package/sdk/commandtypes.js

@@ -11,6 +11,7 @@ exports.commandTitles = new Map([
     ["asi" /* CommandName.AddSpreadsheetIntegration */, 'AddSpreadsheetIntegration'],
     ["a" /* CommandName.Alert */, 'Alert'],
     ["av" /* CommandName.AnimateViewport */, 'AnimateViewport'],
+    ["adi" /* CommandName.AwaitDataSourceImport */, 'AwaitDataSourceImport'],
     ["ai" /* CommandName.AwaitImport */, 'AwaitImport'],
     ["b" /* CommandName.Bootstrap */, 'Bootstrap'],
     ["ceps" /* CommandName.CanEditPackageSettings */, 'CanEditPackageSettings'],
@@ -73,6 +74,7 @@ exports.commandTitles = new Map([
     ["ru" /* CommandName.RegisterUnfurl */, 'RegisterUnfurl'],
     ["r" /* CommandName.ReloadExtension */, 'ReloadExtension'],
     ["oauth" /* CommandName.SendOAuthRequest */, 'SendOAuthRequest'],
+    ["aoauth" /* CommandName.SendAsyncOAuthRequest */, 'SendAsyncOAuthRequest'],
     ["suim" /* CommandName.SendUIMessage */, 'SendUIMessage'],
     ["xhr" /* CommandName.SendXHR */, 'SendXHR'],
     ["scp" /* CommandName.SetCurrentPage */, 'SetCurrentPage'],

package/sdk/core/cardintegration/cardintegrationdefinitions.d.ts

@@ -1,7 +1,7 @@
 import { FieldDefinition } from '../../data/schemadefinition';
 import { isString } from '../checks';
 import { isSerializedFieldTypeDefinition } from '../data/fieldtypedefinition/fieldtypedefinition';
-import { FieldConstraintType, SerializedFieldDefinition } from '../data/serializedfield/serializedfielddefinition';
+import { SerializedFieldDefinition } from '../data/serializedfield/serializedfielddefinition';
 import { isSerializedFieldType, SerializedFieldType } from '../data/serializedfield/serializedfields';
 /** For fields with Option or ApiOption type, the label and value for each available option */
 export interface ExtensionCardFieldOption {
@@ -62,17 +62,13 @@ export declare const isSerializedFieldOptions: (p1: unknown) => p1 is import("..
     v: typeof isSerializedFieldType;
     i: (x: unknown) => x is string | undefined;
 }>[];
-export declare const isSerializedFieldConstraint: (subject: unknown) => subject is import("../guards").DestructureGuardedTypeObj<{
-    Type: (x: unknown) => x is FieldConstraintType;
-    Details: (x: unknown) => x is number | undefined;
-}>;
 /** @ignore */
 export declare const isSerializedExtensionCardFieldDefinition: (subject: unknown) => subject is import("../guards").DestructureGuardedTypeObj<{
     Name: typeof isString;
     Type: typeof isSerializedFieldTypeDefinition;
     Constraints: (x: unknown) => x is import("../guards").DestructureGuardedTypeObj<{
-        Type: (x: unknown) => x is FieldConstraintType;
-        Details: (x: unknown) => x is number | undefined;
+        Type: (x: unknown) => x is import("../data/serializedfield/serializedfielddefinition").FieldConstraintType;
+        Details: (x: unknown) => x is unknown;
     }>[] | undefined;
     l: typeof isString;
     d: (x: unknown) => x is string | undefined;

package/sdk/core/cardintegration/cardintegrationdefinitions.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.deserializeCardFieldArrayDefinition = exports.deserializeCardFieldDefinition = exports.isSerializedExtensionCardFieldDefinition = exports.isSerializedFieldConstraint = exports.isSerializedFieldOptions = exports.isSerializedFieldOption = exports.deserializeFieldOption = exports.serializeCardFieldArrayDefinition = exports.serializeCardFieldDefinition = exports.serializeCardFieldOption = void 0;
+exports.deserializeCardFieldArrayDefinition = exports.deserializeCardFieldDefinition = exports.isSerializedExtensionCardFieldDefinition = exports.isSerializedFieldOptions = exports.isSerializedFieldOption = exports.deserializeFieldOption = exports.serializeCardFieldArrayDefinition = exports.serializeCardFieldDefinition = exports.serializeCardFieldOption = void 0;
 const schemadefinition_1 = require("../../data/schemadefinition");
 const checks_1 = require("../checks");
 const fieldtypedefinition_1 = require("../data/fieldtypedefinition/fieldtypedefinition");
@@ -42,15 +42,11 @@ exports.isSerializedFieldOption = (0, validators_1.objectValidator)({
     'i': (0, validators_1.option)(checks_1.isString),
 });
 exports.isSerializedFieldOptions = (0, validators_1.arrayValidator)(exports.isSerializedFieldOption);
-exports.isSerializedFieldConstraint = (0, validators_1.objectValidator)({
-    'Type': (0, validators_1.enumValidator)(serializedfielddefinition_1.FieldConstraintType),
-    'Details': (0, validators_1.option)(checks_1.isNumber),
-});
 /** @ignore */
 exports.isSerializedExtensionCardFieldDefinition = (0, validators_1.objectValidator)({
     'Name': checks_1.isString,
     'Type': fieldtypedefinition_1.isSerializedFieldTypeDefinition,
-    'Constraints': (0, validators_1.option)((0, validators_1.arrayValidator)(exports.isSerializedFieldConstraint)),
+    'Constraints': (0, validators_1.option)((0, validators_1.arrayValidator)(serializedfielddefinition_1.isSerializedFieldConstraint)),
     'l': checks_1.isString,
     'd': (0, validators_1.option)(checks_1.isString),
     'def': (0, validators_1.option)(serializedfields_1.isSerializedFieldType),

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

@@ -1,6 +1,17 @@
+import { isString } from '../../checks';
 import { SerializedUpstreamConfig } from './serializedupstreamconfig';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedDataSourceProperties {
     'Name': string;
     'UpstreamConfig'?: SerializedUpstreamConfig | null | undefined;
 }
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedDataSourceProperties: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    UpstreamConfig: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
+        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;
+        SourceConfig: typeof import("../../checks").isObject;
+    }> | null | undefined;
+}>;

package/sdk/core/data/datasource/serializeddatasourceproperties.js

@@ -1,2 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedDataSourceProperties = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const serializedupstreamconfig_1 = require("./serializedupstreamconfig");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedDataSourceProperties = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'UpstreamConfig': (0, validators_1.nullableOption)(serializedupstreamconfig_1.isSerializedUpstreamConfig),
+});

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

@@ -1,5 +1,6 @@
-import { SerializedDataItems } from '../serializedfield/serializeddataitems';
-import { SerializedSchema } from '../serializedfield/serializedschema';
+import { isObject, isString } from '../../checks';
+import { isSerializedDataItems, SerializedDataItems } from '../serializedfield/serializeddataitems';
+import { isSerializedSchema, SerializedSchema } from '../serializedfield/serializedschema';
 import { SerializedDataSourceProperties } from './serializeddatasourceproperties';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedMetadataCollection {
@@ -8,6 +9,12 @@ export interface SerializedImportedMetadataCollection {
     'Items': SerializedDataItems;
 }
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedImportedMetadataCollection: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    Schema: typeof isSerializedSchema;
+    Items: typeof isSerializedDataItems;
+}>;
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedCollection {
     'Name': string;
     'Schema': SerializedSchema;
@@ -20,7 +27,42 @@ export interface SerializedImportedCollection {
     };
 }
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedImportedCollection: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    Schema: typeof isSerializedSchema;
+    Items: typeof isSerializedDataItems;
+    UpstreamConfig: typeof isObject;
+    Metadata: (val: unknown) => val is Record<string, import("../../guards").DestructureGuardedTypeObj<{
+        Name: typeof isString;
+        Schema: typeof isSerializedSchema;
+        Items: typeof isSerializedDataItems;
+    }>>;
+}>;
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export interface SerializedImportedDataSource {
     'Properties': SerializedDataSourceProperties;
     'Collections': SerializedImportedCollection[];
 }
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedImportedDataSource: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Properties: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+        Name: typeof isString;
+        UpstreamConfig: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
+            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;
+            SourceConfig: typeof isObject;
+        }> | null | undefined;
+    }>;
+    Collections: (val: unknown) => val is import("../../guards").DestructureGuardedTypeObj<{
+        Name: typeof isString;
+        Schema: typeof isSerializedSchema;
+        Items: typeof isSerializedDataItems;
+        UpstreamConfig: typeof isObject;
+        Metadata: (val: unknown) => val is Record<string, import("../../guards").DestructureGuardedTypeObj<{
+            Name: typeof isString;
+            Schema: typeof isSerializedSchema;
+            Items: typeof isSerializedDataItems;
+        }>>;
+    }>[];
+}>;

package/sdk/core/data/datasource/serializedimporteddatasource.js

@@ -1,2 +1,27 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedImportedDataSource = exports.isSerializedImportedCollection = exports.isSerializedImportedMetadataCollection = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const serializeddataitems_1 = require("../serializedfield/serializeddataitems");
+const serializedschema_1 = require("../serializedfield/serializedschema");
+const serializeddatasourceproperties_1 = require("./serializeddatasourceproperties");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedImportedMetadataCollection = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'Schema': serializedschema_1.isSerializedSchema,
+    'Items': serializeddataitems_1.isSerializedDataItems,
+});
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedImportedCollection = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'Schema': serializedschema_1.isSerializedSchema,
+    'Items': serializeddataitems_1.isSerializedDataItems,
+    'UpstreamConfig': checks_1.isObject,
+    'Metadata': (0, checks_1.isRecord)(exports.isSerializedImportedMetadataCollection),
+});
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+exports.isSerializedImportedDataSource = (0, validators_1.strictObjectValidator)({
+    'Properties': serializeddatasourceproperties_1.isSerializedDataSourceProperties,
+    'Collections': (0, checks_1.isTypedArray)(exports.isSerializedImportedCollection),
+});

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

@@ -1,3 +1,4 @@
+import { isObject } from '../../checks';
 import { DataSourceType } from './datasourcetype';
 import { UpstreamPatchType } from './upstreampatchtype';
 import { UpstreamUpdateType } from './upstreamupdatetype';
@@ -10,3 +11,10 @@ export interface SerializedUpstreamConfig {
         [index: string]: any;
     };
 }
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+export declare const isSerializedUpstreamConfig: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    SourceType: (x: unknown) => x is DataSourceType;
+    UpdateType: (x: unknown) => x is UpstreamUpdateType;
+    PatchType: (x: unknown) => x is UpstreamPatchType | null | undefined;
+    SourceConfig: typeof isObject;
+}>;

package/sdk/core/data/datasource/serializedupstreamconfig.js

@@ -1,2 +1,15 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedUpstreamConfig = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const datasourcetype_1 = require("./datasourcetype");
+const upstreampatchtype_1 = require("./upstreampatchtype");
+const upstreamupdatetype_1 = require("./upstreamupdatetype");
+/** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+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)),
+    'SourceConfig': checks_1.isObject,
+});

package/sdk/core/data/serializedfield/serializedfielddefinition.d.ts

@@ -1,13 +1,7 @@
+import { isString } from '../../checks';
 import { JsonSerializable } from '../../jsonserializable';
-import { SerializedFieldTypeDefinition } from '../fieldtypedefinition/fieldtypedefinition';
+import { isSerializedFieldTypeDefinition, SerializedFieldTypeDefinition } from '../fieldtypedefinition/fieldtypedefinition';
 import { SemanticKind } from '../fieldtypedefinition/semantickind';
-export declare type SerializedFieldDefinition = {
-    'Name': string;
-    'Type': SerializedFieldTypeDefinition;
-    'Constraints'?: SerializedFieldConstraint[] | undefined;
-    'SyncSchema'?: string | undefined;
-    'Mapping'?: readonly SemanticKind[] | undefined;
-};
 export declare enum FieldConstraintType {
     REQUIRED = "required",
     LOCKED = "locked",
@@ -21,3 +15,24 @@ export declare type SerializedFieldConstraint = {
     'Type': FieldConstraintType;
     'Details'?: JsonSerializable;
 };
+export declare const isSerializedFieldConstraint: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Type: (x: unknown) => x is FieldConstraintType;
+    Details: (x: unknown) => x is unknown;
+}>;
+export declare type SerializedFieldDefinition = {
+    'Name': string;
+    'Type': SerializedFieldTypeDefinition;
+    'Constraints'?: SerializedFieldConstraint[] | undefined;
+    'SyncSchema'?: string | undefined;
+    'Mapping'?: readonly SemanticKind[] | undefined;
+};
+export declare const isSerializedFieldDefinition: (subject: unknown) => subject is import("../../guards").DestructureGuardedTypeObj<{
+    Name: typeof isString;
+    Type: typeof isSerializedFieldTypeDefinition;
+    Constraints: (x: unknown) => x is import("../../guards").DestructureGuardedTypeObj<{
+        Type: (x: unknown) => x is FieldConstraintType;
+        Details: (x: unknown) => x is unknown;
+    }>[] | undefined;
+    SyncSchema: (x: unknown) => x is string | undefined;
+    Mapping: (x: unknown) => x is SemanticKind[] | undefined;
+}>;

package/sdk/core/data/serializedfield/serializedfielddefinition.js

@@ -1,7 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFieldConstraintType = exports.FieldConstraintType = void 0;
+exports.isSerializedFieldDefinition = exports.isSerializedFieldConstraint = exports.isFieldConstraintType = exports.FieldConstraintType = void 0;
+const checks_1 = require("../../checks");
 const validators_1 = require("../../validators/validators");
+const fieldtypedefinition_1 = require("../fieldtypedefinition/fieldtypedefinition");
+const semantickind_1 = require("../fieldtypedefinition/semantickind");
 // The options here must match com.lucidchart.data.model.fielddefinition.FieldConstraintType on the backend
 var FieldConstraintType;
 (function (FieldConstraintType) {
@@ -13,3 +16,14 @@ var FieldConstraintType;
     FieldConstraintType["NO_WHITESPACE"] = "noWhitespace";
 })(FieldConstraintType = exports.FieldConstraintType || (exports.FieldConstraintType = {}));
 exports.isFieldConstraintType = (0, validators_1.enumValidator)(FieldConstraintType);
+exports.isSerializedFieldConstraint = (0, validators_1.objectValidator)({
+    'Type': (0, validators_1.enumValidator)(FieldConstraintType),
+    'Details': (0, validators_1.option)(checks_1.isUnknown),
+});
+exports.isSerializedFieldDefinition = (0, validators_1.strictObjectValidator)({
+    'Name': checks_1.isString,
+    'Type': fieldtypedefinition_1.isSerializedFieldTypeDefinition,
+    'Constraints': (0, validators_1.option)((0, validators_1.arrayValidator)(exports.isSerializedFieldConstraint)),
+    'SyncSchema': (0, validators_1.option)(checks_1.isString),
+    'Mapping': (0, validators_1.option)((0, validators_1.arrayValidator)((0, validators_1.stringEnumValidator)(semantickind_1.SemanticKind))),
+});

package/sdk/core/data/serializedfield/serializedschema.d.ts

@@ -7,3 +7,4 @@ export declare type SerializedSchema = {
     'PrimaryKey': string[];
     'FieldLabelOverrides'?: SerializedLabelOverrides | undefined;
 };
+export declare function isSerializedSchema(schema: any): schema is SerializedSchema;

package/sdk/core/data/serializedfield/serializedschema.js

@@ -1,2 +1,23 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.isSerializedSchema = void 0;
+const checks_1 = require("../../checks");
+const validators_1 = require("../../validators/validators");
+const serializedfielddefinition_1 = require("./serializedfielddefinition");
+function isSerializedSchema(schema) {
+    if (schema == null) {
+        return false;
+    }
+    const fields = schema['Fields'];
+    const primaryKey = schema['PrimaryKey'];
+    const fieldLabelOverrides = schema['FieldLabelOverrides'];
+    const validOverrides = (0, checks_1.isDefAndNotNull)(fieldLabelOverrides)
+        ? (0, checks_1.isRecord)(checks_1.isString)(fieldLabelOverrides) && !(0, checks_1.isArray)(fieldLabelOverrides)
+        : true; // Optional field
+    return ((0, checks_1.isTypedArray)(serializedfielddefinition_1.isSerializedFieldDefinition)(fields) &&
+        (0, validators_1.arrayValidator)(serializedfielddefinition_1.isSerializedFieldDefinition)(fields) &&
+        (0, checks_1.isArray)(primaryKey) &&
+        primaryKey.every(checks_1.isString) &&
+        validOverrides);
+}
+exports.isSerializedSchema = isSerializedSchema;

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegration.d.ts

@@ -1,5 +1,5 @@
-import { CollectionProxy } from '../../data/collectionproxy';
 import { SerializedImportedDataSource } from '../data/datasource/serializedimporteddatasource';
+import { JsonSerializable } from '../jsonserializable';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare enum LucidSpreadsheetIntegrationFailureType {
     AuthorizationFailure = "AuthorizationFailure",
@@ -9,12 +9,16 @@ export declare enum LucidSpreadsheetIntegrationFailureType {
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare const lucidSpreadsheetIntegrationFailureTypeValidator: (x: unknown) => x is LucidSpreadsheetIntegrationFailureType;
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
-export declare abstract class LucidSpreadsheetIntegration<CONFIG, SHEET> {
+export declare abstract class LucidSpreadsheetIntegration<CONFIG extends JsonSerializable, SHEET extends JsonSerializable> {
     abstract name: string;
     abstract label: string;
     abstract iconUrl: string;
-    abstract getSpreadsheetToImportDetails: () => Promise<CONFIG | LucidSpreadsheetIntegrationFailureType>;
+    abstract getSpreadsheetToImportDetails(): Promise<CONFIG | LucidSpreadsheetIntegrationFailureType>;
     abstract getSpreadsheetSheetIdsAndNames(spreadsheetDetails: CONFIG): Promise<Map<SHEET, string> | LucidSpreadsheetIntegrationFailureType>;
-    abstract getPreviewData(spreadsheetDetails: CONFIG, sheetIdsToPreview: SHEET[]): Promise<SerializedImportedDataSource | LucidSpreadsheetIntegrationFailureType>;
-    abstract importSheets(spreadsheetDetails: CONFIG, sheetIdsToImport: SHEET[]): Promise<CollectionProxy[] | LucidSpreadsheetIntegrationFailureType>;
+    abstract getPreviewData(spreadsheetDetails: CONFIG, sheetsToPreview: SHEET[]): Promise<SerializedImportedDataSource | LucidSpreadsheetIntegrationFailureType>;
+    abstract importSheets(spreadsheetDetails: CONFIG, sheetsToImportConfig: {
+        'sheet': SHEET;
+        'headerRowIndex': number;
+        'primaryKeys': string[];
+    }[]): Promise<string | LucidSpreadsheetIntegrationFailureType>;
 }

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegrationregistry.d.ts

@@ -1,4 +1,5 @@
 import { EditorClient } from '../../editorclient';
+import { JsonSerializable } from '../jsonserializable';
 import { LucidSpreadsheetIntegration } from './lucidspreadsheetintegration';
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export declare class LucidSpreadsheetIntegrationRegistry {
@@ -7,5 +8,5 @@ export declare class LucidSpreadsheetIntegrationRegistry {
     /**
      * Register a spreadsheet integration.
      */
-    static addSpreadsheetIntegration<CONFIG, SHEET>(client: EditorClient, spreadsheetIntegration: LucidSpreadsheetIntegration<CONFIG, SHEET>): void;
+    static addSpreadsheetIntegration<CONFIG extends JsonSerializable, SHEET extends JsonSerializable>(client: EditorClient, spreadsheetIntegration: LucidSpreadsheetIntegration<CONFIG, SHEET>): void;
 }

package/sdk/core/spreadsheetintegration/lucidspreadsheetintegrationregistry.js

@@ -13,29 +13,42 @@ class LucidSpreadsheetIntegrationRegistry {
     static addSpreadsheetIntegration(client, spreadsheetIntegration) {
         const getSpreadsheetToImportDetailsActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(getSpreadsheetToImportDetailsActionName, async () => {
-            const result = await spreadsheetIntegration.getSpreadsheetToImportDetails();
-            return result;
+            try {
+                return await spreadsheetIntegration.getSpreadsheetToImportDetails();
+            }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const getSpreadsheetSheetIdsAndNamesActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(getSpreadsheetSheetIdsAndNamesActionName, async (message) => {
-            const result = await spreadsheetIntegration.getSpreadsheetSheetIdsAndNames(message['dataDetails']);
-            if ((0, lucidspreadsheetintegration_1.lucidSpreadsheetIntegrationFailureTypeValidator)(result)) {
-                return result;
-            }
-            else {
-                // Serialize the Map
-                return Array.from(result);
+            try {
+                const result = await spreadsheetIntegration.getSpreadsheetSheetIdsAndNames(message['dataDetails']);
+                if ((0, lucidspreadsheetintegration_1.lucidSpreadsheetIntegrationFailureTypeValidator)(result)) {
+                    return result;
+                }
+                else {
+                    // Serialize the Map
+                    return Array.from(result);
+                }
             }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const getPreviewDataActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(getPreviewDataActionName, async (message) => {
-            const result = await spreadsheetIntegration.getPreviewData(message['dataDetails'], message['sheetIds']);
-            return result;
+            try {
+                return await spreadsheetIntegration.getPreviewData(message['dataDetails'], message['sheets']);
+            }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const importSheetsActionName = LucidSpreadsheetIntegrationRegistry.nextHookName();
         client.registerAction(importSheetsActionName, async (message) => {
-            const result = await spreadsheetIntegration.importSheets(message['dataDetails'], message['sheetIds']);
-            return result;
+            try {
+                return await spreadsheetIntegration.importSheets(message['dataDetails'], message['sheetsToImportConfig']);
+            }
+            catch (error) { }
+            return lucidspreadsheetintegration_1.LucidSpreadsheetIntegrationFailureType.GenericFailure;
         });
         const serialized = {
             'n': spreadsheetIntegration.name,

package/sdk/editorclient.d.ts

@@ -92,6 +92,8 @@ export declare class EditorClient {
      */
     canEditPackageSettings(): Promise<boolean>;
     awaitDataImport(dataConnectorName: string, syncDataSourceId: undefined | string, syncCollectionId: string, primaryKeys: string[], timeout?: number): Promise<CollectionProxy>;
+    /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+    awaitDataSourceImport(dataConnectorName: string, syncDataSourceIdNonce: string): Promise<string>;
     /**
      * Make a network request
      * @param request Settings for the network request
@@ -105,6 +107,28 @@ export declare class EditorClient {
         responseFormat: 'binary';
     }): Promise<BinaryXHRResponse>;
     xhr(request: XHRRequest): Promise<XHRResponse>;
+    /**
+     * Make an asyncronous OAuth network request. The request is enqueued to eventually execute. The request may be attempted multiple times with
+     * an overall timeout of 120 seconds.
+     * @param providerName Name of the OAuth provider
+     * @param request Settings for the request
+     * @returns A promise that will either resolve or reject with an XHRResponse. If the HTTP status
+     *   code is not 2xx, the promise will reject.
+     */
+    asyncOAuthXhr(providerName: string, request: OAuthXHRRequest & {
+        responseFormat: 'utf8';
+    }): Promise<TextXHRResponse>;
+    asyncOAuthXhr(providerName: string, request: OAuthXHRRequest & {
+        responseFormat: 'binary';
+    }): Promise<BinaryXHRResponse>;
+    asyncOAuthXhr(providerName: string, request: OAuthXHRRequest): Promise<XHRResponse>;
+    /**
+     * Make an OAuth network request. Make the request immediately and only once with a 10 second timeout.
+     * @param providerName Name of the OAuth provider
+     * @param request Settings for the request
+     * @returns A promise that will either resolve or reject with an XHRResponse. If the HTTP status
+     *   code is not 2xx, the promise will reject.
+     */
     oauthXhr(providerName: string, request: OAuthXHRRequest & {
         responseFormat: 'utf8';
     }): Promise<TextXHRResponse>;

package/sdk/editorclient.js

@@ -158,6 +158,13 @@ class EditorClient {
             't': timeout,
         }), this);
     }
+    /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
+    async awaitDataSourceImport(dataConnectorName, syncDataSourceIdNonce) {
+        return await this.sendCommand("adi" /* CommandName.AwaitDataSourceImport */, {
+            'n': dataConnectorName,
+            's': syncDataSourceIdNonce,
+        });
+    }
     xhr(request) {
         const responseFormat = request.responseFormat || 'utf8';
         return this.sendCommand("xhr" /* CommandName.SendXHR */, {
@@ -176,6 +183,17 @@ class EditorClient {
             throw parseRawXHRResponse(responseFormat, raw);
         });
     }
+    asyncOAuthXhr(providerName, request) {
+        const responseFormat = request.responseFormat || 'utf8';
+        return this.sendCommand("aoauth" /* CommandName.SendAsyncOAuthRequest */, Object.assign({ 'url': request.url, 'm': request.method, 'd': request.data, 'h': request.headers, 'ms': request.timeoutMs, 'p': providerName, 'f': responseFormat }, (request.postResultTo ? { 'prt': request.postResultTo } : {})))
+            .then((raw) => {
+            return parseRawXHRResponse(responseFormat, raw);
+        })
+            .catch((error) => {
+            const raw = (0, commandtypes_1.isRawSendXHRResponse)(error) ? error : undefined;
+            throw parseRawXHRResponse(responseFormat, raw);
+        });
+    }
     oauthXhr(providerName, request) {
         const responseFormat = request.responseFormat || 'utf8';
         return this.sendCommand("oauth" /* CommandName.SendOAuthRequest */, Object.assign({ 'url': request.url, 'm': request.method, 'd': request.data, 'h': request.headers, 'ms': request.timeoutMs, 'p': providerName, 'f': responseFormat }, (request.postResultTo ? { 'prt': request.postResultTo } : {})))