datocms-plugin-sdk 2.1.0-alpha.0 → 2.1.0-alpha.1

package/src/manifest.ts

@@ -101,6 +101,30 @@ export const manifest: Manifest = {
         lineNumber: 19,
       },
     },
+    schemaItemTypeDropdownActions: {
+      name: 'schemaItemTypeDropdownActions',
+      comment: {
+        markdownText:
+          'Use this function to define custom actions (or groups of actions) for a model/block model in the Schema section.\n\nThe `executeSchemaItemTypeDropdownAction()` hook will be triggered once the user\nclicks on one of the defined actions.',
+        tag: 'dropdownActions',
+      },
+      nonCtxArguments: [
+        {
+          name: 'itemType',
+          typeName: 'ItemType',
+        },
+      ],
+      ctxArgument: {
+        type: 'Ctx',
+        additionalProperties: [],
+        additionalMethods: [],
+      },
+      returnType: 'Array<DropdownAction | DropdownActionGroup>',
+      location: {
+        filePath: 'src/hooks/schemaItemTypeDropdownActions.ts',
+        lineNumber: 16,
+      },
+    },
     renderUploadSidebarPanel: {
       name: 'renderUploadSidebarPanel',
       comment: {
@@ -251,6 +275,16 @@ export const manifest: Manifest = {
                 },
                 type: 'string',
               },
+              location: {
+                comment: {
+                  markdownText: 'Current page location.',
+                },
+                location: {
+                  filePath: 'src/hooks/renderPage.ts',
+                  lineNumber: 22,
+                },
+                type: '{\n      pathname: string;\n      search: string;\n      hash: string;\n    }',
+              },
             },
           },
         ],
@@ -1711,7 +1745,7 @@ export const manifest: Manifest = {
       name: 'onBeforeItemUpsert',
       comment: {
         markdownText:
-          'This function will be called before saving a new version of a record. You\ncan stop the action by returning `false`.',
+          'This hook is called when the user attempts to save a record. You can use it to block record saving.\n\nIf you return `false`, the record will NOT be saved. A small on-page error will say "A plugin blocked the action".\nHowever, for better UX, consider also using `ctx.alert()` to better explain to the user why their save was blocked.\n\nIf you return `true`, the save will proceed as normal.\n\nThis hook runs BEFORE serverside validation. You can use it to do your own additional validation before returning.\nClientside validations are not affected by this hook, since those occur on individual fields\' `onBlur()` events.',
         tag: 'beforeHooks',
       },
       nonCtxArguments: [
@@ -1722,13 +1756,35 @@ export const manifest: Manifest = {
       ],
       ctxArgument: {
         type: 'Ctx',
-        additionalProperties: [],
-        additionalMethods: [],
+        additionalProperties: [
+          {
+            items: {},
+          },
+        ],
+        additionalMethods: [
+          {
+            items: {
+              scrollToField: {
+                comment: {
+                  markdownText:
+                    'Smoothly navigates to a specific field in the form. If the field is\nlocalized it will switch language tab and then navigate to the chosen\nfield.',
+                  example:
+                    "const fieldPath = prompt(\n  'Please insert the path of a field in the form',\n  ctx.fieldPath,\n);\n\nawait ctx.scrollToField(fieldPath);",
+                },
+                location: {
+                  filePath: 'src/hooks/onBeforeItemUpsert.ts',
+                  lineNumber: 47,
+                },
+                type: '(path: string, locale?: string) => Promise<void>',
+              },
+            },
+          },
+        ],
       },
       returnType: 'MaybePromise<boolean>',
       location: {
         filePath: 'src/hooks/onBeforeItemUpsert.ts',
-        lineNumber: 15,
+        lineNumber: 22,
       },
     },
     manualFieldExtensions: {
@@ -2272,6 +2328,46 @@ export const manifest: Manifest = {
         lineNumber: 13,
       },
     },
+    executeSchemaItemTypeDropdownAction: {
+      name: 'executeSchemaItemTypeDropdownAction',
+      comment: {
+        markdownText:
+          'Use this function to execute a particular dropdown action defined via\nthe `schemaItemTypeDropdownActions()` hook.',
+        tag: 'dropdownActions',
+      },
+      nonCtxArguments: [
+        {
+          name: 'actionId',
+          typeName: 'string',
+        },
+        {
+          name: 'itemType',
+          typeName: 'ItemType',
+        },
+      ],
+      ctxArgument: {
+        type: 'Ctx',
+        additionalProperties: [
+          {
+            items: {
+              parameters: {
+                location: {
+                  filePath: 'src/hooks/executeSchemaItemTypeDropdownAction.ts',
+                  lineNumber: 23,
+                },
+                type: 'Record<string, unknown> | undefined',
+              },
+            },
+          },
+        ],
+        additionalMethods: [],
+      },
+      returnType: 'Promise<void>',
+      location: {
+        filePath: 'src/hooks/executeSchemaItemTypeDropdownAction.ts',
+        lineNumber: 13,
+      },
+    },
     executeItemsDropdownAction: {
       name: 'executeItemsDropdownAction',
       comment: {
@@ -3050,6 +3146,17 @@ export const manifest: Manifest = {
             },
             type: 'string',
           },
+          isEnvironmentPrimary: {
+            comment: {
+              markdownText:
+                'Whether the current environment is the primary one.',
+            },
+            location: {
+              filePath: 'src/ctx/base.ts',
+              lineNumber: 64,
+            },
+            type: 'boolean',
+          },
           owner: {
             comment: {
               markdownText:
@@ -3057,7 +3164,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 64,
+              lineNumber: 67,
             },
             type: 'Account | Organization',
           },
@@ -3069,7 +3176,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 72,
+              lineNumber: 75,
             },
             type: 'Account | undefined',
           },
@@ -3080,7 +3187,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 78,
+              lineNumber: 81,
             },
             type: '{\n    /** Preferred locale */\n    locale: string;\n  }',
           },
@@ -3091,7 +3198,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 84,
+              lineNumber: 87,
             },
             type: 'Theme',
           },
@@ -3111,7 +3218,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 94,
+              lineNumber: 97,
             },
             type: 'Partial<Record<string, ItemType>>',
           },
@@ -3122,7 +3229,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 101,
+              lineNumber: 104,
             },
             type: 'Partial<Record<string, Field>>',
           },
@@ -3133,7 +3240,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 108,
+              lineNumber: 111,
             },
             type: 'Partial<Record<string, Fieldset>>',
           },
@@ -3144,7 +3251,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 115,
+              lineNumber: 118,
             },
             type: 'Partial<Record<string, User>>',
           },
@@ -3155,7 +3262,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 122,
+              lineNumber: 125,
             },
             type: 'Partial<Record<string, SsoUser>>',
           },
@@ -3179,7 +3286,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 165,
+              lineNumber: 168,
             },
             type: '(itemTypeId: string) => Promise<Field[]>',
           },
@@ -3192,7 +3299,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 184,
+              lineNumber: 187,
             },
             type: '(itemTypeId: string) => Promise<Fieldset[]>',
           },
@@ -3205,7 +3312,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 201,
+              lineNumber: 204,
             },
             type: '() => Promise<Field[]>',
           },
@@ -3218,7 +3325,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 214,
+              lineNumber: 217,
             },
             type: '() => Promise<User[]>',
           },
@@ -3231,7 +3338,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 227,
+              lineNumber: 230,
             },
             type: '() => Promise<SsoUser[]>',
           },
@@ -3253,7 +3360,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 249,
+              lineNumber: 252,
             },
             type: '(params: Record<string, unknown>) => Promise<void>',
           },
@@ -3266,7 +3373,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 300,
+              lineNumber: 303,
             },
             type: '(\n    fieldId: string,\n    changes: FieldAppearanceChange[],\n  ) => Promise<void>',
           },
@@ -3288,7 +3395,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 405,
+              lineNumber: 408,
             },
             type: '(message: string) => Promise<void>',
           },
@@ -3301,7 +3408,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 420,
+              lineNumber: 423,
             },
             type: '(message: string) => Promise<void>',
           },
@@ -3314,7 +3421,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 444,
+              lineNumber: 447,
             },
             type: '<CtaValue = unknown>(\n    toast: Toast<CtaValue>,\n  ) => Promise<CtaValue | null>',
           },
@@ -3336,7 +3443,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 330,
+              lineNumber: 333,
             },
             type: '(itemTypeId: string) => Promise<Item | null>',
           },
@@ -3349,7 +3456,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 351,
+              lineNumber: 354,
             },
             type: '{\n    (\n      itemTypeId: string,\n      options: { multiple: true; initialLocationQuery?: ItemListLocationQuery },\n    ): Promise<Item[] | null>;\n    (\n      itemTypeId: string,\n      options?: {\n        multiple: false;\n        initialLocationQuery?: ItemListLocationQuery;\n      },\n    ): Promise<Item | null>;\n  }',
           },
@@ -3362,7 +3469,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 383,
+              lineNumber: 386,
             },
             type: '(itemId: string) => Promise<Item | null>',
           },
@@ -3384,7 +3491,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 471,
+              lineNumber: 474,
             },
             type: '{\n    (options: { multiple: true }): Promise<Upload[] | null>;\n    (options?: { multiple: false }): Promise<Upload | null>;\n  }',
           },
@@ -3397,7 +3504,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 499,
+              lineNumber: 502,
             },
             type: '(\n    uploadId: string,\n  ) => Promise<(Upload & { deleted?: true }) | null>',
           },
@@ -3410,7 +3517,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 527,
+              lineNumber: 530,
             },
             type: '(\n    /** The "single asset" field structure */\n    fileFieldValue: FileFieldValue,\n    /** Shows metadata information for a specific locale */\n    locale?: string,\n  ) => Promise<FileFieldValue | null>',
           },
@@ -3432,7 +3539,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 558,
+              lineNumber: 561,
             },
             type: '(modal: Modal) => Promise<unknown>',
           },
@@ -3445,7 +3552,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 595,
+              lineNumber: 598,
             },
             type: '(options: ConfirmOptions) => Promise<unknown>',
           },
@@ -3466,7 +3573,7 @@ export const manifest: Manifest = {
             },
             location: {
               filePath: 'src/ctx/base.ts',
-              lineNumber: 609,
+              lineNumber: 612,
             },
             type: '(path: string) => Promise<void>',
           },