datocms-plugin-sdk 0.3.7 → 0.3.24-alpha.1

package/dist/types/connect.d.ts

@@ -1,17 +1,18 @@
 import { Field, ModelBlock } from './SiteApiSchema';
-import { ContentAreaSidebarItem, FieldExtensionOverride, InitPropertiesAndMethods, ItemFormSidebarPanel, MainNavigationTab, ManualFieldExtension, OnBootPropertiesAndMethods, RenderConfigScreenPropertiesAndMethods, RenderFieldExtensionPropertiesAndMethods, RenderManualFieldExtensionConfigScreenPropertiesAndMethods, RenderModalPropertiesAndMethods, RenderPagePropertiesAndMethods, RenderSidebarPanePropertiesAndMethods, SettingsAreaSidebarItemGroup } from './types';
+import { AssetSource, ContentAreaSidebarItem, FieldExtensionOverride, InitPropertiesAndMethods, ItemFormSidebarPanel, MainNavigationTab, ManualFieldExtension, OnBootPropertiesAndMethods, RenderAssetSourcePropertiesAndMethods, RenderConfigScreenPropertiesAndMethods, RenderFieldExtensionPropertiesAndMethods, RenderManualFieldExtensionConfigScreenPropertiesAndMethods, RenderModalPropertiesAndMethods, RenderPagePropertiesAndMethods, RenderSidebarPanePropertiesAndMethods, SettingsAreaSidebarItemGroup } from './types';
 export declare type SizingUtilities = {
     /**
-     * Listens for DOM changes and automatically calls `setHeight` when it detects a change.
-     * If you're using `datocms-react-ui` package, the `<Canvas />` component already takes
-     * care of calling this method for you.
+     * Listens for DOM changes and automatically calls `setHeight` when it detects
+     * a change. If you're using `datocms-react-ui` package, the `<Canvas />`
+     * component already takes care of calling this method for you.
      */
     startAutoResizer: () => void;
     /** Stops resizing the iframe automatically */
     stopAutoResizer: () => void;
     /**
-     * Triggers a change in the size of the iframe. If you don't explicitely pass a
-     * `newHeight` it will be automatically calculated using the iframe content at the moment
+     * Triggers a change in the size of the iframe. If you don't explicitely pass
+     * a `newHeight` it will be automatically calculated using the iframe content
+     * at the moment
      */
     updateHeight: (newHeight?: number) => void;
 };
@@ -23,6 +24,7 @@ export declare type FieldIntentCtx = InitPropertiesAndMethods & {
 };
 export declare type RenderPageCtx = RenderPagePropertiesAndMethods;
 export declare type RenderModalCtx = RenderModalPropertiesAndMethods & SizingUtilities;
+export declare type RenderAssetSourceCtx = RenderAssetSourcePropertiesAndMethods & SizingUtilities;
 export declare type RenderItemFormSidebarPanelCtx = RenderSidebarPanePropertiesAndMethods & SizingUtilities;
 export declare type RenderFieldExtensionCtx = RenderFieldExtensionPropertiesAndMethods & SizingUtilities;
 export declare type RenderManualFieldExtensionConfigScreenCtx = RenderManualFieldExtensionConfigScreenPropertiesAndMethods & SizingUtilities;
@@ -30,8 +32,8 @@ export declare type RenderConfigScreenCtx = RenderConfigScreenPropertiesAndMetho
 /** The full options you can pass to the `connect` function */
 export declare type FullConnectParameters = {
     /**
-     * This function will be called once at boot time and can be used to perform ie. some
-     * initial integrity checks on the configuration.
+     * This function will be called once at boot time and can be used to perform
+     * ie. some initial integrity checks on the configuration.
      *
      * @group boot
      */
@@ -55,69 +57,86 @@ export declare type FullConnectParameters = {
      */
     contentAreaSidebarItems: (ctx: IntentCtx) => ContentAreaSidebarItem[];
     /**
-     * Use this function to declare new field extensions that users will be able to install
-     * manually in some field
+     * Use this function to declare new field extensions that users will be able
+     * to install manually in some field
      *
      * @group manualFieldExtensions
      */
     manualFieldExtensions: (ctx: IntentCtx) => ManualFieldExtension[];
     /**
-     * Use this function to declare new sidebar panels to be shown when the user edits
-     * records of a particular model
+     * Use this function to declare additional sources to be shown when users want
+     * to upload new assets
+     *
+     * @group assetSources
+     */
+    assetSources: (ctx: IntentCtx) => AssetSource[] | void;
+    /**
+     * Use this function to declare new sidebar panels to be shown when the user
+     * edits records of a particular model
      *
      * @group sidebarPanels
      */
     itemFormSidebarPanels: (itemType: ModelBlock, ctx: IntentCtx) => ItemFormSidebarPanel[];
     /**
-     * Use this function to automatically force one or more field extensions to a particular field
+     * Use this function to automatically force one or more field extensions to a
+     * particular field
      *
      * @group forcedFieldExtensions
      */
     overrideFieldExtensions: (field: Field, ctx: FieldIntentCtx) => FieldExtensionOverride | void;
     /**
-     * This function will be called when the plugin needs to render the plugin's configuration form
+     * This function will be called when the plugin needs to render the plugin's
+     * configuration form
      *
      * @group configScreen
      */
     renderConfigScreen: (ctx: RenderConfigScreenCtx) => void;
     /**
-     * This function will be called when the plugin needs to render a specific page (see the
-     * `mainNavigationTabs`, `settingsAreaSidebarItemGroups` and `contentAreaSidebarItems` functions)
+     * This function will be called when the plugin needs to render a specific
+     * page (see the `mainNavigationTabs`, `settingsAreaSidebarItemGroups` and
+     * `contentAreaSidebarItems` functions)
      *
      * @group pages
      */
     renderPage: (pageId: string, ctx: RenderPageCtx) => void;
     /**
-     * This function will be called when the plugin requested to open a modal (see the
-     * `openModal` function)
+     * This function will be called when the plugin requested to open a modal (see
+     * the `openModal` function)
      *
      * @group modals
      */
     renderModal: (modalId: string, ctx: RenderModalCtx) => void;
     /**
-     * This function will be called when the plugin needs to render a sidebar panel (see the
-     * `itemFormSidebarPanels` function)
+     * This function will be called when the plugin needs to render a sidebar
+     * panel (see the `itemFormSidebarPanels` function)
      *
      * @group sidebarPanels
      */
     renderItemFormSidebarPanel: (sidebarPaneId: string, ctx: RenderItemFormSidebarPanelCtx) => void;
     /**
-     * This function will be called when the plugin needs to render a field extension (see
-     * the `manualFieldExtensions` and `overrideFieldExtensions` functions)
+     * This function will be called when the user selects one of the plugin's
+     * asset sources to upload a new media file.
+     *
+     * @group assetSources
+     */
+    renderAssetSource: (assetSourceId: string, ctx: RenderAssetSourceCtx) => void;
+    /**
+     * This function will be called when the plugin needs to render a field
+     * extension (see the `manualFieldExtensions` and `overrideFieldExtensions` functions)
      *
      * @group forcedFieldExtensions
      */
     renderFieldExtension: (fieldExtensionId: string, ctx: RenderFieldExtensionCtx) => void;
     /**
-     * This function will be called when the plugin needs to render the configuration form
-     * for installing a field extension inside a particular field
+     * This function will be called when the plugin needs to render the
+     * configuration form for installing a field extension inside a particular field
      *
      * @group manualFieldExtensions
      */
     renderManualFieldExtensionConfigScreen: (fieldExtensionId: string, ctx: RenderManualFieldExtensionConfigScreenCtx) => void;
     /**
-     * This function will be called each time the configuration object changes. It must
-     * return an object containing possible validation errors
+     * This function will be called each time the configuration object changes. It
+     * must return an object containing possible validation errors
      *
      * @group manualFieldExtensions
      */

package/dist/types/guards.d.ts

@@ -1,4 +1,4 @@
-import { InitMethods, OnBootMethods, RenderPageMethods, RenderFieldExtensionMethods, RenderConfigScreenMethods, RenderManualFieldExtensionConfigScreenMethods, RenderSidebarPanelMethods, RenderModalMethods } from './types';
+import { InitMethods, OnBootMethods, RenderPageMethods, RenderFieldExtensionMethods, RenderConfigScreenMethods, RenderManualFieldExtensionConfigScreenMethods, RenderSidebarPanelMethods, RenderModalMethods, RenderAssetSourceMethods } from './types';
 export declare type Parent = {
     getSettings: () => Promise<{
         mode: string;
@@ -28,3 +28,6 @@ export declare const isRenderFieldExtensionParent: (parent: Parent, settings: {
 export declare const isRenderManualFieldExtensionConfigScreenParent: (parent: Parent, settings: {
     mode: string;
 }) => parent is RenderManualFieldExtensionConfigScreenMethods;
+export declare const isRenderAssetSourceParent: (parent: Parent, settings: {
+    mode: string;
+}) => parent is RenderAssetSourceMethods;