lucid-extension-sdk 1.1.2 → 1.2.0

package/commandtypes.d.ts

@@ -20,7 +20,7 @@ import { PanelLocation } from './ui/panel';
  * Typically, an extension author will not need to access any of these commands directly, as they are all
  * exposed through appropriate classes and methods elsewhere in this SDK.
  *
- * To use these directly, use [EditorClient.sendCommand](#classes_editorclient-EditorClient_sendcommand).
+ * To use these directly, use {@link EditorClient.sendCommand}.
  *
  * FOR DEVELOPERS AT LUCID:
  * Follow this guide to add new commands: https://lucidatlassian.atlassian.net/wiki/x/3AA3Xww
@@ -174,7 +174,7 @@ export type CommandName = (typeof CommandName)[keyof typeof CommandName];
 export declare const commandTitles: Map<CommandName, string>;
 /**
  * This is a type declaration whose purpose is to allow TypeScript to enforce the correct parameter and
- * return types from [EditorClient.sendCommand](#classes_editorclient-EditorClient_sendcommand) based on
+ * return types from {@link EditorClient.sendCommand} based on
  * which command name you pass in as the first parameter.
  *
  * IMPORTANT - Before you add a new command bring it up in #api-committee to get feedback
@@ -858,13 +858,11 @@ export type AutoSyncSettings = {
     'gsf': string;
     'sqs'?: string | undefined;
     'syqs'?: string | undefined;
-    /** getDefaultFilterFields action ID - field-only config */
-    'gdf'?: string | undefined;
     /** searchFields action ID - field-only config */
     'sf'?: string | undefined;
     /** syncFields action ID - field-only config */
     'syf'?: string | undefined;
-    /** If specified, setup fields that allow user to create query template that auto applies to dynamic tables when created*/
+    /** If specified, setup fields that allow user to create query template that auto applies to dynamic tables when created */
     'dpf'?: {
         /** Get search fields action */
         'gsf': string;
@@ -872,8 +870,10 @@ export type AutoSyncSettings = {
         'gpv': string;
     } | undefined;
     'cftqs'?: string | undefined;
-    /** Get default filter fields action */
+    /** Get default filter fields action. Used in both field-only and query-string configurations. */
     'gdff'?: string | undefined;
+    /** Get more filter fields action. Used in both field-only and query-string configurations. */
+    'gmff'?: string | undefined;
 };
 export type SerializedFieldConfiguration = {
     /** Callback to get field definitions for all fields supported by the card integration */
@@ -1137,6 +1137,10 @@ export type AddSpreadsheetIntegrationQuery = {
         [K in keyof SerializedFieldConfiguration]?: SerializedFieldConfiguration[K] | undefined;
     } | undefined;
     'dm'?: DependencyMappingSettings | undefined;
+    /** Auto-sync configuration (only honored when `c` / addCardsIntegration is true) */
+    'as'?: AutoSyncSettings | undefined;
+    /** Get default config action */
+    'gdc'?: string | undefined;
 };
 /** @ignore until spreadsheet integration is ready for launch (CHART-51946) */
 export type AddSpreadsheetIntegrationResult = undefined;
@@ -1632,7 +1636,19 @@ export type GetOAuthClientIdResult = Promise<string | undefined>;
 export type GetPropertyQuery = {
     /** ID of the LucidElement to read a property from, or undefined to read from the LucidDocument */
     'id'?: string | undefined;
-    /** Name of the property to read */
+    /**
+     * Name of the property to read.
+     *
+     * For text area properties, this returns the plain text string by default. To get rich text
+     * (text + inline markup such as bold, italic, links, and line spacing), prefix the text area
+     * name with `Rich:`. For example, `properties.get('Rich:Text')` returns an object with the
+     * structure `{t: string, m: Array}` where `t` is the text content and `m` is an array of
+     * markup entries. Each markup entry has:
+     * - `s` (number): start index
+     * - `e` (number, optional): end index (omitted for block-level markup)
+     * - `n` (string): markup name (e.g. `'b'` for bold, `'i'` for italic, `'lk'` for link, `'p'` for line spacing)
+     * - `v` (any): markup value
+     */
     'p': string;
 };
 export type GetPropertyResult = UnsafeJsonSerializableOrUndefined;
@@ -1982,7 +1998,19 @@ export type SetPropertyQuery = {
     'id'?: string | undefined;
     /** Name of the property to change */
     'p': string;
-    /** New value of the property */
+    /**
+     * New value of the property.
+     *
+     * For text area properties, you can pass a plain text string to set the text while preserving
+     * the existing style. To set rich text with inline markup (bold, italic, links, line spacing, etc.),
+     * prefix the text area name in `p` with `Rich:` (e.g. `p: 'Rich:Text'`) and pass an object as
+     * the value with the structure `{t: string, m: Array}` where `t` is the text content and `m`
+     * is an array of markup entries. Each markup entry has:
+     * - `s` (number): start index
+     * - `e` (number, optional): end index
+     * - `n` (string): markup name (e.g. `'b'` for bold, `'i'` for italic, `'lk'` for link, `'p'` for line spacing)
+     * - `v` (any): markup value
+     */
     'v'?: UnsafeJsonSerializableOrUndefined;
 };
 export type SetPropertyResult = undefined;

package/commandtypes.js

@@ -8,7 +8,7 @@ const checks_1 = require("./core/checks");
  * Typically, an extension author will not need to access any of these commands directly, as they are all
  * exposed through appropriate classes and methods elsewhere in this SDK.
  *
- * To use these directly, use [EditorClient.sendCommand](#classes_editorclient-EditorClient_sendcommand).
+ * To use these directly, use {@link EditorClient.sendCommand}.
  *
  * FOR DEVELOPERS AT LUCID:
  * Follow this guide to add new commands: https://lucidatlassian.atlassian.net/wiki/x/3AA3Xww

package/core/cardintegration/cardintegrationautosyncconfig.d.ts

@@ -74,9 +74,17 @@ export interface QueryStringCardIntegrationAutoSyncConfig extends BaseCardIntegr
      * type a raw query string.
      *
      * @param searchSoFar The fields the user has populated so far (e.g. the selected data source id)
-     * @returns The filter fields to render
+     * @returns The filter fields to always render
      */
     getDefaultFilterFields?: (searchSoFar: Map<string, SerializedFieldType>) => Promise<ExtensionCardFieldDefinition[]>;
+    /**
+     * Provides the additional filter fields a user can pin from the "More filters" picker.
+     * Implementations **MUST exclude** any field already returned by {@link getDefaultFilterFields}.
+     *
+     * @param searchSoFar The fields the user has populated so far (e.g. the selected data source id)
+     * @returns The additional filter fields, excluding default fields
+     */
+    getMoreFilterFields?: (searchSoFar: Map<string, SerializedFieldType>) => Promise<ExtensionCardFieldDefinition[]>;
 }
 /**
  * @experimental
@@ -88,10 +96,20 @@ export interface FieldOnlyCardIntegrationAutoSyncConfig extends BaseCardIntegrat
      * Returns the filter field definitions available for the user to configure. Called whenever the
      * current field selections change, allowing fields to be dynamically updated based on prior selections.
      *
+     * Keep this callback fast — it is called eagerly whenever the filter form is shown.
+     *
      * @param searchSoFar The filter field values selected so far
-     * @returns the field definitions to display for filtering
+     * @returns the field definitions to display for filtering by default
      */
     getDefaultFilterFields: (searchSoFar: Map<string, SerializedFieldType>) => Promise<ExtensionCardFieldDefinition[]>;
+    /**
+     * Provides the additional filter fields a user can pin from the "More filters" picker.
+     * Implementations **MUST exclude** any field already returned by {@link getDefaultFilterFields}.
+     *
+     * @param searchSoFar The filter field values selected so far
+     * @returns The additional filter fields, excluding default fields
+     */
+    getMoreFilterFields?: (searchSoFar: Map<string, SerializedFieldType>) => Promise<ExtensionCardFieldDefinition[]>;
     /**
      * Perform a search using the selected filter field values. This should support pagination
      * (See {@link AutoSyncPaginationSize}).

package/core/cardintegration/cardintegrationparams.d.ts

@@ -56,6 +56,10 @@ export interface GetDefaultFilterFieldsParam {
     's': [string, SerializedFieldType][];
 }
 /** @ignore */
+export interface GetMoreFilterFieldsParam {
+    's': [string, SerializedFieldType][];
+}
+/** @ignore */
 export interface QuerySyncRemoveNonMatchingLabelParam {
     'g': string;
 }

package/core/cardintegration/lucidcardintegrationregistry.d.ts

@@ -12,17 +12,15 @@ export declare class LucidCardIntegrationRegistry {
         name?: string | undefined;
         dataSourceId?: string | undefined;
     }) => Promise<ExtensionCardFieldOption[]>): string;
-    static registerUserSearchCallback(client: EditorClient, callback: (searchText: string, inputSoFar: Map<string, SerializedFieldType>) => Promise<ExtensionCardUserData[]>): string;
+    static registerUserSearchCallback(client: EditorClient, callback: (searchText: string, inputSoFar: Map<string, SerializedFieldType>, fieldData?: {
+        name?: string | undefined;
+        dataSourceId?: string | undefined;
+    }) => Promise<ExtensionCardUserData[]>): string;
     static registerFieldTypeToCollectionItemsCallback(client: EditorClient, callback: (fieldName: string, value: SerializedFieldType, dataSourceProxy?: DataSourceProxy | undefined) => Promise<[string, SerializedFields][]>): string;
     static registerFieldLabelIconsCallback(client: EditorClient, callback: (dataSourceProxy: DataSourceProxy, dataItemProxy: DataItemProxy) => Promise<ExtensionCardFieldLabelIcons>): string;
     static registerTagCallback(client: EditorClient, callback: TagCallback): string;
     static registerBannerActionCallback(client: EditorClient, callback: (actionId: string) => void): string;
     private static registerDependencyMapping;
-    private static serializeSearchResult;
-    /**
-     * Helper to serialize import results (single or array) to the expected format.
-     */
-    private static serializeImportResults;
     private static registerImportCardFromPastedLinkHandler;
     /**
      * Register a card integration.

package/core/cardintegration/lucidcardintegrationregistry.js

@@ -2,7 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.LucidCardIntegrationRegistry = void 0;
 const commandtypes_1 = require("../../commandtypes");
-const collectiondefinition_1 = require("../../data/collectiondefinition");
 const collectionproxy_1 = require("../../data/collectionproxy");
 const dataitemproxy_1 = require("../../data/dataitemproxy");
 const datasourceproxy_1 = require("../../data/datasourceproxy");
@@ -11,7 +10,6 @@ const checks_1 = require("../checks");
 const importcardfromdetails_1 = require("../importcardfromdetails/importcardfromdetails");
 const cardintegrationdefinitions_1 = require("../sharedcardintegration/cardintegrationdefinitions");
 const sharedregistryutil_1 = require("../sharedcardintegration/sharedregistryutil");
-const cardintegrationautosyncconfig_1 = require("./cardintegrationautosyncconfig");
 const cardintegrationconfig_1 = require("./cardintegrationconfig");
 const tabs_1 = require("./cardpaneltabs/tabs");
 const extensiondatapanellistitem_1 = require("./extensiondatapanel/extensiondatapanellistitem");
@@ -30,31 +28,13 @@ class LucidCardIntegrationRegistry {
         return name;
     }
     static registerFieldSearchCallback(client, callback) {
-        const name = LucidCardIntegrationRegistry.nextHookName();
-        client.registerAction(name, async ({ 'i': inputSoFar, 's': searchText, 'fd': serializedFieldData }) => {
-            const fieldData = serializedFieldData
-                ? { name: serializedFieldData['n'], dataSourceId: serializedFieldData['ds'] }
-                : undefined;
-            const result = await callback(searchText, new Map(inputSoFar), fieldData);
-            return result.map((option) => (0, cardintegrationdefinitions_1.serializeCardFieldOption)(option));
-        });
-        return name;
+        return (0, sharedregistryutil_1.registerFieldSearchCallback)(client, callback, () => LucidCardIntegrationRegistry.nextHookName());
     }
     static registerUserSearchCallback(client, callback) {
-        const name = LucidCardIntegrationRegistry.nextHookName();
-        client.registerAction(name, async ({ 'i': inputSoFar, 's': searchText }) => {
-            const result = await callback(searchText, new Map(inputSoFar));
-            return result.map((userData) => (0, cardintegrationdefinitions_1.serializeCardUserData)(userData));
-        });
-        return name;
+        return (0, sharedregistryutil_1.registerUserSearchCallback)(client, callback, () => LucidCardIntegrationRegistry.nextHookName());
     }
     static registerFieldTypeToCollectionItemsCallback(client, callback) {
-        const name = LucidCardIntegrationRegistry.nextHookName();
-        client.registerAction(name, async ({ 'd': dataSourceId, 'v': value, 'f': fieldName }) => {
-            const dataSourceProxy = dataSourceId ? new datasourceproxy_1.DataSourceProxy(dataSourceId, client) : undefined;
-            return await callback(fieldName, value, dataSourceProxy);
-        });
-        return name;
+        return (0, sharedregistryutil_1.registerFieldTypeToCollectionItemsCallback)(client, callback, () => LucidCardIntegrationRegistry.nextHookName());
     }
     static registerFieldLabelIconsCallback(client, callback) {
         const name = LucidCardIntegrationRegistry.nextHookName();
@@ -99,50 +79,6 @@ class LucidCardIntegrationRegistry {
     static registerDependencyMapping(client, cardIntegration, serialized) {
         return (0, sharedregistryutil_1.registerDependencyMapping)(client, cardIntegration, serialized, () => LucidCardIntegrationRegistry.nextHookName());
     }
-    static serializeSearchResult(searchResult) {
-        var _a;
-        return {
-            'srs': searchResult.searchResults.map((resultPerCollection) => ({
-                'd': (0, collectiondefinition_1.serializeCollectionDefinition)(resultPerCollection.data),
-                'f': (0, cardintegrationdefinitions_1.serializeCardFieldArrayDefinition)(resultPerCollection.fields),
-                'm': resultPerCollection.partialImportMetadata && {
-                    'cid': resultPerCollection.partialImportMetadata.collectionId,
-                    'sid': resultPerCollection.partialImportMetadata.syncDataSourceId,
-                },
-            })),
-            'ipsr': searchResult.itemsPerSearchResult,
-            'e': searchResult.error,
-            'bs': (_a = searchResult.banners) === null || _a === void 0 ? void 0 : _a.map((banner) => ({
-                'ty': banner.type,
-                'msg': banner.message,
-                'btyp': banner.bannerType,
-                'actbtn': banner.actionButton
-                    ? {
-                        'lab': banner.actionButton.label,
-                        'aid': banner.actionButton.actionId,
-                        'href': banner.actionButton.href,
-                    }
-                    : undefined,
-            })),
-        };
-    }
-    /**
-     * Helper to serialize import results (single or array) to the expected format.
-     */
-    static serializeImportResults(result) {
-        if ((0, checks_1.isArray)(result)) {
-            return result.map((importResult) => {
-                return {
-                    'c': importResult.collection.id,
-                    'pks': importResult.primaryKeys,
-                };
-            });
-        }
-        return {
-            'c': result.collection.id,
-            'pks': result.primaryKeys,
-        };
-    }
     static registerImportCardFromPastedLinkHandler(client, cardIntegration, serialized) {
         if (!cardIntegration.importCardFromPastedLink) {
             return;
@@ -175,7 +111,7 @@ class LucidCardIntegrationRegistry {
      * Register a card integration.
      */
     static addCardIntegration(client, cardIntegration) {
-        var _a, _b, _c, _d, _e, _f;
+        var _a, _b, _c, _d;
         const getFieldsActionName = LucidCardIntegrationRegistry.nextHookName();
         client.registerAction(getFieldsActionName, async (param) => {
             const dataSource = new datasourceproxy_1.DataSourceProxy(param['d'], client);
@@ -282,32 +218,21 @@ class LucidCardIntegrationRegistry {
                     const result = await importModal.search(new Map(param), offset, limit);
                     if (!(0, cardintegrationdefinitions_1.isSearchResult)(result)) {
                         if ((0, checks_1.isArray)(result)) {
-                            return this.serializeSearchResult({
+                            return (0, sharedregistryutil_1.serializeSearchResult)({
                                 searchResults: result,
                             });
                         }
                         else {
-                            return this.serializeSearchResult({
+                            return (0, sharedregistryutil_1.serializeSearchResult)({
                                 searchResults: [result],
                             });
                         }
                     }
-                    return this.serializeSearchResult(result);
+                    return (0, sharedregistryutil_1.serializeSearchResult)(result);
                 });
                 client.registerAction(serialized['im']['i'], async ({ 'pks': primaryKeys, 's': searchFields }) => {
                     const result = await importModal.import(primaryKeys, new Map(searchFields));
-                    if ((0, checks_1.isArray)(result)) {
-                        return result.map((importResult) => {
-                            return {
-                                'c': importResult.collection.id,
-                                'pks': importResult.primaryKeys,
-                            };
-                        });
-                    }
-                    return {
-                        'c': result.collection.id,
-                        'pks': result.primaryKeys,
-                    };
+                    return (0, sharedregistryutil_1.serializeImportResults)(result);
                 });
                 if (serialized['im']['os']) {
                     client.registerAction(serialized['im']['os'], async () => {
@@ -336,146 +261,13 @@ class LucidCardIntegrationRegistry {
             });
         }
         if (cardIntegration.autoSync) {
-            const autoSync = cardIntegration.autoSync;
-            serialized['as'] = {
-                'gsf': LucidCardIntegrationRegistry.nextHookName(),
-            };
-            if (autoSync.phrases) {
-                serialized['as']['p'] = {
-                    'h': autoSync.phrases.header,
-                    'l': autoSync.phrases.label,
-                    'qph': autoSync.phrases.queryPlaceholder,
-                    'rnml': LucidCardIntegrationRegistry.nextHookName(),
-                    'nml': autoSync.phrases.noMatchedLabel,
-                    'esl': autoSync.phrases.emptyStateLabel,
-                };
-                client.registerAction(serialized['as']['p']['rnml'], ({ 'g': inputSoFar }) => {
-                    var _a;
-                    if (!(0, cardintegrationautosyncconfig_1.isSupportedAutoSyncGeneratorType)(inputSoFar)) {
-                        return '';
-                    }
-                    return (_a = autoSync.phrases) === null || _a === void 0 ? void 0 : _a.removeNonMatchingLabel(inputSoFar);
-                });
-                if ((_a = autoSync.phrases) === null || _a === void 0 ? void 0 : _a.syncingGrowlMessage) {
-                    serialized['as']['p']['sgm'] = LucidCardIntegrationRegistry.nextHookName();
-                    client.registerAction(serialized['as']['p']['sgm'], ({ 'c': count }) => {
-                        var _a, _b;
-                        return (_b = (_a = autoSync.phrases) === null || _a === void 0 ? void 0 : _a.syncingGrowlMessage) === null || _b === void 0 ? void 0 : _b.call(_a, count);
-                    });
-                }
-                if ((_b = autoSync.phrases) === null || _b === void 0 ? void 0 : _b.removingGrowlMessage) {
-                    serialized['as']['p']['rgm'] = LucidCardIntegrationRegistry.nextHookName();
-                    client.registerAction(serialized['as']['p']['rgm'], ({ 'c': count }) => {
-                        var _a, _b;
-                        return (_b = (_a = autoSync.phrases) === null || _a === void 0 ? void 0 : _a.removingGrowlMessage) === null || _b === void 0 ? void 0 : _b.call(_a, count);
-                    });
-                }
-            }
-            client.registerAction(serialized['as']['gsf'], async ({ 'i': inputSoFar }) => {
-                const result = await autoSync.getSyncDataSourceIdField(new Map(inputSoFar));
-                return (0, cardintegrationdefinitions_1.serializeCardFieldArrayDefinition)(result);
-            });
-            if ('searchFields' in autoSync) {
-                const fieldOnlyAutoSync = autoSync;
-                serialized['as']['gdf'] = LucidCardIntegrationRegistry.nextHookName();
-                client.registerAction(serialized['as']['gdf'], async ({ 'i': inputSoFar }) => {
-                    const result = await fieldOnlyAutoSync.getDefaultFilterFields(new Map(inputSoFar));
-                    return (0, cardintegrationdefinitions_1.serializeCardFieldArrayDefinition)(result);
-                });
-                serialized['as']['sf'] = LucidCardIntegrationRegistry.nextHookName();
-                client.registerAction(serialized['as']['sf'], async ({ 'f': fields, 'if': instanceFields, 'pn': pageNumber, 'npt': nextPageToken, }) => {
-                    const result = await fieldOnlyAutoSync.searchFields(new Map(fields), new Map(instanceFields), pageNumber, nextPageToken);
-                    if (result) {
-                        return this.serializeSearchResult(result);
-                    }
-                    else {
-                        return this.serializeSearchResult({
-                            searchResults: [],
-                            error: 'Unknown Error Occurred',
-                        });
-                    }
-                });
-                serialized['as']['syf'] = LucidCardIntegrationRegistry.nextHookName();
-                client.registerAction(serialized['as']['syf'], async ({ 'f': fields, 'if': instanceFields }) => {
-                    var _a;
-                    const result = (_a = (await fieldOnlyAutoSync.syncFields(new Map(fields), new Map(instanceFields)))) !== null && _a !== void 0 ? _a : [];
-                    return LucidCardIntegrationRegistry.serializeImportResults(result);
-                });
-            }
-            else {
-                const queryStringAutoSync = autoSync;
-                if (queryStringAutoSync.searchQueryString) {
-                    serialized['as']['sqs'] = LucidCardIntegrationRegistry.nextHookName();
-                    client.registerAction(serialized['as']['sqs'], async ({ 'qs': queryString, 'of': otherFields, 'pn': pageNumber, 'npt': nextPageToken, }) => {
-                        var _a;
-                        const result = await ((_a = queryStringAutoSync.searchQueryString) === null || _a === void 0 ? void 0 : _a.call(queryStringAutoSync, queryString, new Map(otherFields), pageNumber, nextPageToken));
-                        if (result) {
-                            return this.serializeSearchResult(result);
-                        }
-                        else {
-                            return this.serializeSearchResult({
-                                searchResults: [],
-                                error: 'Unknown Error Occurred',
-                            });
-                        }
-                    });
-                }
-                if (queryStringAutoSync.syncQueryString) {
-                    serialized['as']['syqs'] = LucidCardIntegrationRegistry.nextHookName();
-                    client.registerAction(serialized['as']['syqs'], async ({ 'qs': queryString, 'of': otherFields }) => {
-                        var _a, _b;
-                        const result = (_b = (await ((_a = queryStringAutoSync.syncQueryString) === null || _a === void 0 ? void 0 : _a.call(queryStringAutoSync, queryString, new Map(otherFields))))) !== null && _b !== void 0 ? _b : [];
-                        return LucidCardIntegrationRegistry.serializeImportResults(result);
-                    });
-                }
-                if (queryStringAutoSync.convertFiltersToQueryString) {
-                    serialized['as']['cftqs'] = LucidCardIntegrationRegistry.nextHookName();
-                    client.registerAction(serialized['as']['cftqs'], async ({ 'ff': filterFields }) => {
-                        var _a;
-                        const result = await ((_a = queryStringAutoSync.convertFiltersToQueryString) === null || _a === void 0 ? void 0 : _a.call(queryStringAutoSync, new Map(filterFields)));
-                        if ((0, cardintegrationautosyncconfig_1.isConvertFiltersToQueryStringResult)(result)) {
-                            return {
-                                'qs': result.queryString,
-                                'e': result.error,
-                            };
-                        }
-                        return result;
-                    });
-                }
-                if (queryStringAutoSync.getDefaultFilterFields) {
-                    serialized['as']['gdff'] = LucidCardIntegrationRegistry.nextHookName();
-                    client.registerAction(serialized['as']['gdff'], async ({ 's': searchSoFar }) => {
-                        var _a, _b;
-                        const result = (_b = (await ((_a = queryStringAutoSync.getDefaultFilterFields) === null || _a === void 0 ? void 0 : _a.call(queryStringAutoSync, new Map(searchSoFar))))) !== null && _b !== void 0 ? _b : [];
-                        return (0, cardintegrationdefinitions_1.serializeCardFieldArrayDefinition)(result);
-                    });
-                }
-            }
-            if (autoSync.documentPresetSetupFields) {
-                const documentPresetSetupFields = autoSync.documentPresetSetupFields;
-                serialized['as']['dpf'] = {
-                    'gsf': LucidCardIntegrationRegistry.nextHookName(),
-                    'gpv': LucidCardIntegrationRegistry.nextHookName(),
-                };
-                client.registerAction(serialized['as']['dpf']['gsf'], async ({ 's': searchSoFar }) => {
-                    const result = await documentPresetSetupFields.getSearchFields(new Map(searchSoFar));
-                    return (0, cardintegrationdefinitions_1.serializeCardFieldArrayDefinition)(result);
-                });
-                client.registerAction(serialized['as']['dpf']['gpv'], async ({ 'f': fields }) => {
-                    const result = await documentPresetSetupFields.generatePresetValue(new Map(fields));
-                    return {
-                        'dcn': result.dataConnectorName,
-                        'iid': result.instanceId,
-                        'q': result.query,
-                    };
-                });
-            }
+            serialized['as'] = (0, sharedregistryutil_1.registerAutoSync)(client, cardIntegration.autoSync, () => LucidCardIntegrationRegistry.nextHookName());
         }
         if (cardIntegration.fieldConfiguration.customFieldDisplaySettings) {
             serialized['fc']['cfds'] = {
                 'd': cardIntegration.fieldConfiguration.customFieldDisplaySettings.defaultToMultilineText,
-                'uri': (_d = (_c = cardIntegration.fieldConfiguration) === null || _c === void 0 ? void 0 : _c.customFieldDisplaySettings) === null || _d === void 0 ? void 0 : _d.useRoundIcons,
-                'dadr': (_f = (_e = cardIntegration.fieldConfiguration) === null || _e === void 0 ? void 0 : _e.customFieldDisplaySettings) === null || _f === void 0 ? void 0 : _f.displayMappedDatesAsDateRange,
+                'uri': (_b = (_a = cardIntegration.fieldConfiguration) === null || _a === void 0 ? void 0 : _a.customFieldDisplaySettings) === null || _b === void 0 ? void 0 : _b.useRoundIcons,
+                'dadr': (_d = (_c = cardIntegration.fieldConfiguration) === null || _c === void 0 ? void 0 : _c.customFieldDisplaySettings) === null || _d === void 0 ? void 0 : _d.displayMappedDatesAsDateRange,
             };
         }
         if (cardIntegration.fieldConfiguration.nonCustomizableFields) {

package/core/checks.d.ts

@@ -138,6 +138,7 @@ export declare function isTypedTuple<const Tuple extends readonly unknown[]>(gua
  * @return Whether variable is a map.
  */
 export declare function isMap(val: unknown): val is Map<unknown, unknown>;
+export declare function isTypedMap<K, V>(kTest: (k: unknown) => k is K, vTest: (v: unknown) => v is V): (val: unknown) => val is Map<K, V>;
 export type Tuple<T, N extends number> = N extends N ? (number extends N ? T[] : TupleOfHelper<T, N, []>) : never;
 type TupleOfHelper<T, N extends number, R extends unknown[]> = R['length'] extends N ? R : TupleOfHelper<T, N, [T, ...R]>;
 export declare function isExactLength<T, N extends number>(arr: readonly T[], exactLength: N): arr is Tuple<T, N>;

package/core/checks.js

@@ -21,6 +21,7 @@ exports.isTypedArray = isTypedArray;
 exports.isDefinedArray = isDefinedArray;
 exports.isTypedTuple = isTypedTuple;
 exports.isMap = isMap;
+exports.isTypedMap = isTypedMap;
 exports.isExactLength = isExactLength;
 exports.isAtLeastLength = isAtLeastLength;
 exports.isPair = isPair;
@@ -215,6 +216,19 @@ function isTypedTuple(guards) {
 function isMap(val) {
     return val instanceof Map;
 }
+function isTypedMap(kTest, vTest) {
+    return function (val) {
+        if (!isMap(val)) {
+            return false;
+        }
+        for (const [k, v] of val) {
+            if (!kTest(k) || !vTest(v)) {
+                return false;
+            }
+        }
+        return true;
+    };
+}
 function isExactLength(arr, exactLength) {
     return arr.length === exactLength;
 }

package/core/lucidproduct.d.ts

@@ -4,6 +4,7 @@
 export declare const LucidProduct: {
     readonly Chart: "chart";
     readonly Spark: "spark";
+    /** @ignore */
     readonly TeamSpaces: "teamspaces";
 };
 export type LucidProduct = (typeof LucidProduct)[keyof typeof LucidProduct];

package/core/lucidproduct.js

@@ -7,5 +7,6 @@ exports.LucidProduct = void 0;
 exports.LucidProduct = {
     Chart: 'chart',
     Spark: 'spark',
+    /** @ignore */
     TeamSpaces: 'teamspaces',
 };

package/core/sharedcardintegration/sharedregistryutil.d.ts

@@ -1,4 +1,61 @@
-import { DependencyMappingSettings } from '../../commandtypes';
+import { AutoSyncSettings, DependencyMappingSettings } from '../../commandtypes';
+import { DataSourceProxy } from '../../data/datasourceproxy';
 import { EditorClient } from '../../editorclient';
+import { type CardIntegrationAutoSyncConfig } from '../cardintegration/cardintegrationautosyncconfig';
+import { SerializedFieldType, SerializedFields } from '../data/serializedfield/serializedfields';
+import { ExtensionCardFieldOption, ExtensionCardUserData, ImportResult, SearchResult } from './cardintegrationdefinitions';
 import { CardIntegrationDependencyMappingConfig } from './dependencymappingconfig';
+/**
+ * Serializes a `SearchResult` into the wire-format object the editor expects. Shared between the
+ * import-modal `search` path and the auto-sync `searchQueryString` / `searchFields` paths.
+ */
+export declare function serializeSearchResult(searchResult: SearchResult): {
+    srs: {
+        d: import("../../data/collectiondefinition").SerializedCollectionDefinition;
+        f: import("./cardintegrationdefinitions").SerializedExtensionCardFieldDefinition[];
+        m: {
+            cid: string;
+            sid: string | undefined;
+        } | undefined;
+    }[];
+    ipsr: number | undefined;
+    e: string | undefined;
+    bs: {
+        ty: "error-banner";
+        msg: string;
+        btyp: import("./cardintegrationdefinitions").BannerType | undefined;
+        actbtn: {
+            lab: string;
+            aid: string | undefined;
+            href: string | undefined;
+        } | undefined;
+    }[] | undefined;
+};
+/**
+ * Serializes import results (single or array) to the wire-format the editor expects. Shared
+ * between the import-modal `import` path, the dependency-mapping path, and the auto-sync `sync*`
+ * paths.
+ */
+export declare function serializeImportResults(result: ImportResult | ImportResult[]): {
+    c: string;
+    pks: string[];
+}[] | {
+    c: string;
+    pks: string[];
+};
+/**
+ * Registers the editor-side actions for a `CardIntegrationAutoSyncConfig` on the given client and
+ * returns the corresponding `AutoSyncSettings` wire-format payload. Used by both
+ * `LucidCardIntegrationRegistry` and `LucidSpreadsheetIntegrationRegistry`.
+ */
+export declare function registerAutoSync(client: EditorClient, autoSync: CardIntegrationAutoSyncConfig, getNextHookName: () => string): AutoSyncSettings;
 export declare function registerDependencyMapping(client: EditorClient, dependencyMapping: CardIntegrationDependencyMappingConfig, serialized: DependencyMappingSettings, getNextHookName: () => string): void;
+export declare function registerFieldSearchCallback(client: EditorClient, callback: (searchText: string, inputSoFar: Map<string, SerializedFieldType>, fieldData?: {
+    name?: string | undefined;
+    dataSourceId?: string | undefined;
+}) => Promise<ExtensionCardFieldOption[]>, getNextHookName: () => string): string;
+export declare function registerUserSearchCallback(client: EditorClient, callback: (searchText: string, inputSoFar: Map<string, SerializedFieldType>, fieldData?: {
+    name?: string | undefined;
+    dataSourceId?: string | undefined;
+}) => Promise<ExtensionCardUserData[]>, getNextHookName: () => string): string;
+export declare function registerFieldTypeToCollectionItemsCallback(client: EditorClient, callback: (fieldName: string, value: SerializedFieldType, dataSourceProxy?: DataSourceProxy | undefined) => Promise<[string, SerializedFields][]>, getNextHookName: () => string): string;