directus 9.22.4 → 9.23.3

package/dist/services/users.js

@@ -4,23 +4,25 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.UsersService = void 0;
+const exceptions_1 = require("@directus/shared/exceptions");
+const utils_1 = require("@directus/shared/utils");
 const jsonwebtoken_1 = __importDefault(require("jsonwebtoken"));
 const lodash_1 = require("lodash");
+const perf_hooks_1 = require("perf_hooks");
 const database_1 = __importDefault(require("../database"));
 const env_1 = __importDefault(require("../env"));
-const exceptions_1 = require("@directus/shared/exceptions");
 const exceptions_2 = require("../exceptions");
 const record_not_unique_1 = require("../exceptions/database/record-not-unique");
 const is_url_allowed_1 = __importDefault(require("../utils/is-url-allowed"));
-const utils_1 = require("@directus/shared/utils");
+const stall_1 = require("../utils/stall");
 const url_1 = require("../utils/url");
 const items_1 = require("./items");
 const mail_1 = require("./mail");
 const settings_1 = require("./settings");
-const stall_1 = require("../utils/stall");
-const perf_hooks_1 = require("perf_hooks");
-const utils_2 = require("@directus/shared/utils");
 class UsersService extends items_1.ItemsService {
+    knex;
+    accountability;
+    schema;
     constructor(options) {
         super('directus_users', options);
         this.knex = options.knex || (0, database_1.default)();
@@ -96,7 +98,7 @@ class UsersService extends items_1.ItemsService {
             .andWhere({ 'directus_roles.admin_access': true })
             .leftJoin('directus_roles', 'directus_users.role', 'directus_roles.id')
             .first();
-        const otherAdminUsersCount = +((otherAdminUsers === null || otherAdminUsers === void 0 ? void 0 : otherAdminUsers.count) || 0);
+        const otherAdminUsersCount = +(otherAdminUsers?.count || 0);
         if (otherAdminUsersCount === 0) {
             throw new exceptions_2.UnprocessableEntityException(`You can't remove the last admin user from the role.`);
         }
@@ -113,7 +115,7 @@ class UsersService extends items_1.ItemsService {
             .andWhere({ 'directus_users.status': 'active' })
             .leftJoin('directus_roles', 'directus_users.role', 'directus_roles.id')
             .first();
-        const otherAdminUsersCount = +((otherAdminUsers === null || otherAdminUsers === void 0 ? void 0 : otherAdminUsers.count) || 0);
+        const otherAdminUsersCount = +(otherAdminUsers?.count || 0);
         if (otherAdminUsersCount === 0) {
             throw new exceptions_2.UnprocessableEntityException(`You can't change the active status of the last admin user.`);
         }
@@ -131,11 +133,16 @@ class UsersService extends items_1.ItemsService {
     async createMany(data, opts) {
         const emails = data.map((payload) => payload.email).filter((email) => email);
         const passwords = data.map((payload) => payload.password).filter((password) => password);
-        if (emails.length) {
-            await this.checkUniqueEmails(emails);
+        try {
+            if (emails.length) {
+                await this.checkUniqueEmails(emails);
+            }
+            if (passwords.length) {
+                await this.checkPasswordPolicy(passwords);
+            }
         }
-        if (passwords.length) {
-            await this.checkPasswordPolicy(passwords);
+        catch (err) {
+            (opts || (opts = {})).preMutationException = err;
         }
         return await super.createMany(data, opts);
     }
@@ -174,45 +181,49 @@ class UsersService extends items_1.ItemsService {
      * Update many users by primary key
      */
     async updateMany(keys, data, opts) {
-        var _a, _b;
-        if (data.role) {
-            // data.role will be an object with id with GraphQL mutations
-            const roleId = (_b = (_a = data.role) === null || _a === void 0 ? void 0 : _a.id) !== null && _b !== void 0 ? _b : data.role;
-            const newRole = await this.knex.select('admin_access').from('directus_roles').where('id', roleId).first();
-            if (!(newRole === null || newRole === void 0 ? void 0 : newRole.admin_access)) {
-                await this.checkRemainingAdminExistence(keys);
+        try {
+            if (data.role) {
+                // data.role will be an object with id with GraphQL mutations
+                const roleId = data.role?.id ?? data.role;
+                const newRole = await this.knex.select('admin_access').from('directus_roles').where('id', roleId).first();
+                if (!newRole?.admin_access) {
+                    await this.checkRemainingAdminExistence(keys);
+                }
             }
-        }
-        if (data.status !== undefined && data.status !== 'active') {
-            await this.checkRemainingActiveAdmin(keys);
-        }
-        if (data.email) {
-            if (keys.length > 1) {
-                throw new record_not_unique_1.RecordNotUniqueException('email', {
-                    collection: 'directus_users',
-                    field: 'email',
-                    invalid: data.email,
-                });
+            if (data.status !== undefined && data.status !== 'active') {
+                await this.checkRemainingActiveAdmin(keys);
             }
-            await this.checkUniqueEmails([data.email], keys[0]);
-        }
-        if (data.password) {
-            await this.checkPasswordPolicy([data.password]);
-        }
-        if (data.tfa_secret !== undefined) {
-            throw new exceptions_2.InvalidPayloadException(`You can't change the "tfa_secret" value manually.`);
-        }
-        if (data.provider !== undefined) {
-            if (this.accountability && this.accountability.admin !== true) {
-                throw new exceptions_2.InvalidPayloadException(`You can't change the "provider" value manually.`);
+            if (data.email) {
+                if (keys.length > 1) {
+                    throw new record_not_unique_1.RecordNotUniqueException('email', {
+                        collection: 'directus_users',
+                        field: 'email',
+                        invalid: data.email,
+                    });
+                }
+                await this.checkUniqueEmails([data.email], keys[0]);
             }
-            data.auth_data = null;
-        }
-        if (data.external_identifier !== undefined) {
-            if (this.accountability && this.accountability.admin !== true) {
-                throw new exceptions_2.InvalidPayloadException(`You can't change the "external_identifier" value manually.`);
+            if (data.password) {
+                await this.checkPasswordPolicy([data.password]);
+            }
+            if (data.tfa_secret !== undefined) {
+                throw new exceptions_2.InvalidPayloadException(`You can't change the "tfa_secret" value manually.`);
+            }
+            if (data.provider !== undefined) {
+                if (this.accountability && this.accountability.admin !== true) {
+                    throw new exceptions_2.InvalidPayloadException(`You can't change the "provider" value manually.`);
+                }
+                data.auth_data = null;
+            }
+            if (data.external_identifier !== undefined) {
+                if (this.accountability && this.accountability.admin !== true) {
+                    throw new exceptions_2.InvalidPayloadException(`You can't change the "external_identifier" value manually.`);
+                }
+                data.auth_data = null;
             }
-            data.auth_data = null;
+        }
+        catch (err) {
+            (opts || (opts = {})).preMutationException = err;
         }
         return await super.updateMany(keys, data, opts);
     }
@@ -227,7 +238,12 @@ class UsersService extends items_1.ItemsService {
      * Delete multiple users by primary key
      */
     async deleteMany(keys, opts) {
-        await this.checkRemainingAdminExistence(keys);
+        try {
+            await this.checkRemainingAdminExistence(keys);
+        }
+        catch (err) {
+            (opts || (opts = {})).preMutationException = err;
+        }
         await this.knex('directus_notifications').update({ sender: null }).whereIn('sender', keys);
         await super.deleteMany(keys, opts);
         return keys;
@@ -248,8 +264,14 @@ class UsersService extends items_1.ItemsService {
         return await this.deleteMany(keys, opts);
     }
     async inviteUser(email, role, url, subject) {
-        if (url && (0, is_url_allowed_1.default)(url, env_1.default.USER_INVITE_URL_ALLOW_LIST) === false) {
-            throw new exceptions_2.InvalidPayloadException(`Url "${url}" can't be used to invite users.`);
+        const opts = {};
+        try {
+            if (url && (0, is_url_allowed_1.default)(url, env_1.default.USER_INVITE_URL_ALLOW_LIST) === false) {
+                throw new exceptions_2.InvalidPayloadException(`Url "${url}" can't be used to invite users.`);
+            }
+        }
+        catch (err) {
+            opts.preMutationException = err;
         }
         const emails = (0, utils_1.toArray)(email);
         const mailService = new mail_1.MailService({
@@ -259,11 +281,11 @@ class UsersService extends items_1.ItemsService {
         for (const email of emails) {
             const payload = { email, scope: 'invite' };
             const token = jsonwebtoken_1.default.sign(payload, env_1.default.SECRET, { expiresIn: '7d', issuer: 'directus' });
-            const subjectLine = subject !== null && subject !== void 0 ? subject : "You've been invited";
+            const subjectLine = subject ?? "You've been invited";
             const inviteURL = url ? new url_1.Url(url) : new url_1.Url(env_1.default.PUBLIC_URL).addPath('admin', 'accept-invite');
             inviteURL.setQuery('token', token);
             // Create user first to verify uniqueness
-            await this.createOne({ email, role, status: 'invited' });
+            await this.createOne({ email, role, status: 'invited' }, opts);
             await mailService.send({
                 to: email,
                 subject: subjectLine,
@@ -282,7 +304,7 @@ class UsersService extends items_1.ItemsService {
         if (scope !== 'invite')
             throw new exceptions_2.ForbiddenException();
         const user = await this.knex.select('id', 'status').from('directus_users').where({ email }).first();
-        if ((user === null || user === void 0 ? void 0 : user.status) !== 'invited') {
+        if (user?.status !== 'invited') {
             throw new exceptions_2.InvalidPayloadException(`Email address ${email} hasn't been invited.`);
         }
         // Allow unauthenticated update
@@ -293,9 +315,6 @@ class UsersService extends items_1.ItemsService {
         await service.updateOne(user.id, { password, status: 'active' });
     }
     async requestPasswordReset(email, url, subject) {
-        if (url && (0, is_url_allowed_1.default)(url, env_1.default.PASSWORD_RESET_URL_ALLOW_LIST) === false) {
-            throw new exceptions_2.InvalidPayloadException(`Url "${url}" can't be used to reset passwords.`);
-        }
         const STALL_TIME = 500;
         const timeStart = perf_hooks_1.performance.now();
         const user = await this.knex
@@ -303,16 +322,19 @@ class UsersService extends items_1.ItemsService {
             .from('directus_users')
             .whereRaw('LOWER(??) = ?', ['email', email.toLowerCase()])
             .first();
-        if ((user === null || user === void 0 ? void 0 : user.status) !== 'active') {
+        if (user?.status !== 'active') {
             await (0, stall_1.stall)(STALL_TIME, timeStart);
             throw new exceptions_2.ForbiddenException();
         }
+        if (url && (0, is_url_allowed_1.default)(url, env_1.default.PASSWORD_RESET_URL_ALLOW_LIST) === false) {
+            throw new exceptions_2.InvalidPayloadException(`Url "${url}" can't be used to reset passwords.`);
+        }
         const mailService = new mail_1.MailService({
             schema: this.schema,
             knex: this.knex,
             accountability: this.accountability,
         });
-        const payload = { email, scope: 'password-reset', hash: (0, utils_2.getSimpleHash)('' + user.password) };
+        const payload = { email, scope: 'password-reset', hash: (0, utils_1.getSimpleHash)('' + user.password) };
         const token = jsonwebtoken_1.default.sign(payload, env_1.default.SECRET, { expiresIn: '1d', issuer: 'directus' });
         const acceptURL = url
             ? new url_1.Url(url).setQuery('token', token).toString()
@@ -332,13 +354,18 @@ class UsersService extends items_1.ItemsService {
         await (0, stall_1.stall)(STALL_TIME, timeStart);
     }
     async resetPassword(token, password) {
-        var _a;
         const { email, scope, hash } = jsonwebtoken_1.default.verify(token, env_1.default.SECRET, { issuer: 'directus' });
         if (scope !== 'password-reset' || !hash)
             throw new exceptions_2.ForbiddenException();
-        await this.checkPasswordPolicy([password]);
+        const opts = {};
+        try {
+            await this.checkPasswordPolicy([password]);
+        }
+        catch (err) {
+            opts.preMutationException = err;
+        }
         const user = await this.knex.select('id', 'status', 'password').from('directus_users').where({ email }).first();
-        if ((user === null || user === void 0 ? void 0 : user.status) !== 'active' || hash !== (0, utils_2.getSimpleHash)('' + user.password)) {
+        if (user?.status !== 'active' || hash !== (0, utils_1.getSimpleHash)('' + user.password)) {
             throw new exceptions_2.ForbiddenException();
         }
         // Allow unauthenticated update
@@ -346,11 +373,11 @@ class UsersService extends items_1.ItemsService {
             knex: this.knex,
             schema: this.schema,
             accountability: {
-                ...((_a = this.accountability) !== null && _a !== void 0 ? _a : { role: null }),
+                ...(this.accountability ?? { role: null }),
                 admin: true, // We need to skip permissions checks for the update call below
             },
         });
-        await service.updateOne(user.id, { password, status: 'active' });
+        await service.updateOne(user.id, { password, status: 'active' }, opts);
     }
 }
 exports.UsersService = UsersService;

package/dist/services/utils.d.ts

@@ -1,6 +1,6 @@
-import { Knex } from 'knex';
-import { AbstractServiceOptions, PrimaryKey } from '../types';
-import { Accountability, SchemaOverview } from '@directus/shared/types';
+import type { Accountability, SchemaOverview } from '@directus/shared/types';
+import type { Knex } from 'knex';
+import type { AbstractServiceOptions, PrimaryKey } from '../types';
 export declare class UtilsService {
     knex: Knex;
     accountability: Accountability | null;

package/dist/services/utils.js

@@ -6,30 +6,32 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.UtilsService = void 0;
 const database_1 = __importDefault(require("../database"));
 const collections_1 = require("../database/system-data/collections");
-const exceptions_1 = require("../exceptions");
 const emitter_1 = __importDefault(require("../emitter"));
+const exceptions_1 = require("../exceptions");
 class UtilsService {
+    knex;
+    accountability;
+    schema;
     constructor(options) {
         this.knex = options.knex || (0, database_1.default)();
         this.accountability = options.accountability || null;
         this.schema = options.schema;
     }
     async sort(collection, { item, to }) {
-        var _a, _b, _c, _d;
         const sortFieldResponse = (await this.knex.select('sort_field').from('directus_collections').where({ collection }).first()) ||
             collections_1.systemCollectionRows;
-        const sortField = sortFieldResponse === null || sortFieldResponse === void 0 ? void 0 : sortFieldResponse.sort_field;
+        const sortField = sortFieldResponse?.sort_field;
         if (!sortField) {
             throw new exceptions_1.InvalidPayloadException(`Collection "${collection}" doesn't have a sort field.`);
         }
-        if (((_a = this.accountability) === null || _a === void 0 ? void 0 : _a.admin) !== true) {
-            const permissions = (_c = (_b = this.accountability) === null || _b === void 0 ? void 0 : _b.permissions) === null || _c === void 0 ? void 0 : _c.find((permission) => {
+        if (this.accountability?.admin !== true) {
+            const permissions = this.accountability?.permissions?.find((permission) => {
                 return permission.collection === collection && permission.action === 'update';
             });
             if (!permissions) {
                 throw new exceptions_1.ForbiddenException();
             }
-            const allowedFields = (_d = permissions.fields) !== null && _d !== void 0 ? _d : [];
+            const allowedFields = permissions.fields ?? [];
             if (allowedFields[0] !== '*' && allowedFields.includes(sortField) === false) {
                 throw new exceptions_1.ForbiddenException();
             }
@@ -37,7 +39,7 @@ class UtilsService {
         const primaryKeyField = this.schema.collections[collection].primary;
         // Make sure all rows have a sort value
         const countResponse = await this.knex.count('* as count').from(collection).whereNull(sortField).first();
-        if ((countResponse === null || countResponse === void 0 ? void 0 : countResponse.count) && +countResponse.count !== 0) {
+        if (countResponse?.count && +countResponse.count !== 0) {
             const lastSortValueResponse = await this.knex.max(sortField).from(collection).first();
             const rowsWithoutSortValue = await this.knex
                 .select(primaryKeyField, sortField)
@@ -59,7 +61,7 @@ class UtilsService {
             .groupBy(sortField)
             .from(collection)
             .havingRaw('count(??) > 1', [sortField]);
-        if ((duplicates === null || duplicates === void 0 ? void 0 : duplicates.length) > 0) {
+        if (duplicates?.length > 0) {
             const ids = await this.knex.select(primaryKeyField).from(collection).orderBy(sortField);
             // This might not scale that well, but I don't really know how to accurately set all rows
             // to a sequential value that works cross-DB vendor otherwise

package/dist/services/webhooks.d.ts

@@ -1,6 +1,6 @@
-import { AbstractServiceOptions, Item, PrimaryKey, Webhook, MutationOptions } from '../types';
-import { ItemsService } from './items';
 import { Messenger } from '../messenger';
+import type { AbstractServiceOptions, Item, MutationOptions, PrimaryKey, Webhook } from '../types';
+import { ItemsService } from './items';
 export declare class WebhooksService extends ItemsService<Webhook> {
     messenger: Messenger;
     constructor(options: AbstractServiceOptions);

package/dist/services/webhooks.js

@@ -1,9 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.WebhooksService = void 0;
-const items_1 = require("./items");
 const messenger_1 = require("../messenger");
+const items_1 = require("./items");
 class WebhooksService extends items_1.ItemsService {
+    messenger;
     constructor(options) {
         super('directus_webhooks', options);
         this.messenger = (0, messenger_1.getMessenger)();

package/dist/types/assets.d.ts

@@ -1,6 +1,6 @@
-import { ResizeOptions, Sharp } from 'sharp';
+import type { ResizeOptions, Sharp } from 'sharp';
 export declare const TransformationMethods: readonly ["toFormat", "jpeg", "png", "tiff", "webp", "resize", "extend", "extract", "trim", "rotate", "flip", "flop", "sharpen", "median", "blur", "flatten", "gamma", "negate", "normalise", "normalize", "clahe", "convolve", "threshold", "linear", "recomb", "modulate", "tint", "greyscale", "grayscale", "toColorspace", "toColourspace", "removeAlpha", "ensureAlpha", "extractChannel", "bandbool"];
-type AllowedSharpMethods = Pick<Sharp, typeof TransformationMethods[number]>;
+type AllowedSharpMethods = Pick<Sharp, (typeof TransformationMethods)[number]>;
 export type TransformationMap = {
     [M in keyof AllowedSharpMethods]: readonly [M, ...Parameters<AllowedSharpMethods[M]>];
 };

package/dist/types/ast.d.ts

@@ -1,4 +1,4 @@
-import { Query, Relation } from '@directus/shared/types';
+import type { Query, Relation } from '@directus/shared/types';
 export type M2ONode = {
     type: 'm2o';
     name: string;

package/dist/types/auth.d.ts

@@ -1,5 +1,5 @@
-import { SchemaOverview } from '@directus/shared/types';
-import { Knex } from 'knex';
+import type { SchemaOverview } from '@directus/shared/types';
+import type { Knex } from 'knex';
 export interface AuthDriverOptions {
     knex: Knex;
     schema: SchemaOverview;

package/dist/types/collection.d.ts

@@ -1,5 +1,5 @@
-import { Table } from 'knex-schema-inspector/dist/types/table';
-import { Field } from '@directus/shared/types';
+import type { Field } from '@directus/shared/types';
+import type { Table } from 'knex-schema-inspector/dist/types/table';
 export type CollectionMeta = {
     collection: string;
     note: string | null;

package/dist/types/database.d.ts

@@ -0,0 +1,3 @@
+export type Driver = 'mysql' | 'pg' | 'cockroachdb' | 'sqlite3' | 'oracledb' | 'mssql';
+export declare const DatabaseClients: readonly ["mysql", "postgres", "cockroachdb", "sqlite", "oracle", "mssql", "redshift"];
+export type DatabaseClient = (typeof DatabaseClients)[number];

package/dist/types/database.js

@@ -0,0 +1,4 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatabaseClients = void 0;
+exports.DatabaseClients = ['mysql', 'postgres', 'cockroachdb', 'sqlite', 'oracle', 'mssql', 'redshift'];

package/dist/types/events.d.ts

@@ -1,5 +1,5 @@
-import { ActionHandler, FilterHandler, InitHandler } from '@directus/shared/types';
-import { ScheduledTask } from 'node-cron';
+import type { ActionHandler, FilterHandler, InitHandler } from '@directus/shared/types';
+import type { ScheduledTask } from 'node-cron';
 export type EventHandler = {
     type: 'filter';
     name: string;

package/dist/types/graphql.d.ts

@@ -1,5 +1,5 @@
-import { Request, Response } from 'express';
-import { DocumentNode } from 'graphql';
+import type { Request, Response } from 'express';
+import type { DocumentNode } from 'graphql';
 export interface GraphQLParams {
     query: string | null;
     variables: {

package/dist/types/index.d.ts

@@ -2,6 +2,7 @@ export * from './assets';
 export * from './ast';
 export * from './auth';
 export * from './collection';
+export * from './database';
 export * from './events';
 export * from './files';
 export * from './graphql';

package/dist/types/index.js

@@ -18,6 +18,7 @@ __exportStar(require("./assets"), exports);
 __exportStar(require("./ast"), exports);
 __exportStar(require("./auth"), exports);
 __exportStar(require("./collection"), exports);
+__exportStar(require("./database"), exports);
 __exportStar(require("./events"), exports);
 __exportStar(require("./files"), exports);
 __exportStar(require("./graphql"), exports);

package/dist/types/items.d.ts

@@ -2,7 +2,8 @@
  * I know this looks a little silly, but it allows us to explicitly differentiate between when we're
  * expecting an item vs any other generic object.
  */
-import { EventContext } from '@directus/shared/types';
+import type { BaseException } from '@directus/shared/exceptions';
+import type { EventContext } from '@directus/shared/types';
 export type Item = Record<string, any>;
 export type PrimaryKey = string | number;
 export type Alterations = {
@@ -30,12 +31,16 @@ export type MutationOptions = {
     /**
      * Allow disabling the emitting of hooks. Useful if a custom hook is fired (like files.upload)
      */
-    emitEvents?: boolean;
+    emitEvents?: boolean | undefined;
     /**
      * To bypass the emitting of action events if emitEvents is enabled
      * Can be used to queue up the nested events from item service's create, update and delete
      */
     bypassEmitAction?: (params: ActionEventParams) => void;
+    /**
+     * The validation error to throw right before the mutation takes place
+     */
+    preMutationException?: BaseException;
 };
 export type ActionEventParams = {
     event: string | string[];

package/dist/types/services.d.ts

@@ -1,14 +1,14 @@
-import { Knex } from 'knex';
-import { Accountability, Query, SchemaOverview } from '@directus/shared/types';
-import { Item, PrimaryKey } from './items';
+import type { Accountability, Query, SchemaOverview } from '@directus/shared/types';
+import type { Knex } from 'knex';
+import type { Item, PrimaryKey } from './items';
 export type AbstractServiceOptions = {
     knex?: Knex;
-    accountability?: Accountability | null;
+    accountability?: Accountability | null | undefined;
     schema: SchemaOverview;
 };
 export interface AbstractService {
     knex: Knex;
-    accountability: Accountability | null;
+    accountability: Accountability | null | undefined;
     createOne(data: Partial<Item>): Promise<PrimaryKey>;
     createMany(data: Partial<Item>[]): Promise<PrimaryKey[]>;
     readOne(key: PrimaryKey, query?: Query): Promise<Item>;

package/dist/types/snapshot.d.ts

@@ -1,9 +1,11 @@
-import { Collection } from './collection';
-import { Relation, RelationMeta, Field, FieldMeta } from '@directus/shared/types';
-import { Diff } from 'deep-diff';
+import type { Field, FieldMeta, Relation, RelationMeta } from '@directus/shared/types';
+import type { Diff } from 'deep-diff';
+import type { Collection } from './collection';
+import type { DatabaseClient } from './database';
 export type Snapshot = {
     version: number;
     directus: string;
+    vendor?: DatabaseClient;
     collections: Collection[];
     fields: SnapshotField[];
     relations: SnapshotRelation[];
@@ -14,6 +16,9 @@ export type SnapshotField = Field & {
 export type SnapshotRelation = Relation & {
     meta: Omit<RelationMeta, 'id'>;
 };
+export type SnapshotWithHash = Snapshot & {
+    hash: string;
+};
 export type SnapshotDiff = {
     collections: {
         collection: string;
@@ -31,3 +36,20 @@ export type SnapshotDiff = {
         diff: Diff<SnapshotRelation | undefined>[];
     }[];
 };
+export type SnapshotDiffWithHash = {
+    hash: string;
+    diff: SnapshotDiff;
+};
+/**
+ * Indicates the kind of change based on comparisons by deep-diff package
+ */
+export declare const DiffKind: {
+    /** indicates a newly added property/element */
+    readonly NEW: "N";
+    /** indicates a property/element was deleted */
+    readonly DELETE: "D";
+    /** indicates a property/element was edited */
+    readonly EDIT: "E";
+    /** indicates a change occurred within an array */
+    readonly ARRAY: "A";
+};

package/dist/types/snapshot.js

@@ -1,2 +1,16 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.DiffKind = void 0;
+/**
+ * Indicates the kind of change based on comparisons by deep-diff package
+ */
+exports.DiffKind = {
+    /** indicates a newly added property/element */
+    NEW: 'N',
+    /** indicates a property/element was deleted */
+    DELETE: 'D',
+    /** indicates a property/element was edited */
+    EDIT: 'E',
+    /** indicates a change occurred within an array */
+    ARRAY: 'A',
+};

package/dist/utils/apply-diff.d.ts

@@ -0,0 +1,9 @@
+import type { SchemaOverview } from '@directus/shared/types';
+import { Diff } from 'deep-diff';
+import type { Knex } from 'knex';
+import { Snapshot, SnapshotDiff, SnapshotField } from '../types';
+export declare function applyDiff(currentSnapshot: Snapshot, snapshotDiff: SnapshotDiff, options?: {
+    database?: Knex;
+    schema?: SchemaOverview;
+}): Promise<void>;
+export declare function isNestedMetaUpdate(diff: Diff<SnapshotField | undefined>): boolean;