snapshot of https://github.com/RocketChat/Rocket.Chat.git (develop, 2026-09-16; blobs > 131072B omitted)

packages/apps-engine/src/definition/exceptions/AppsEngineException.ts

@@ -0,0 +1,29 @@
+/**
+ * The internal exception from the framework
+ *
+ * It's used to signal to the outside world that
+ * a _known_ exception has happened during the execution
+ * of the apps.
+ *
+ * It's the base exception for other known classes
+ * such as UserNotAllowedException, which is used
+ * to inform the host that an app identified
+ * that a user cannot perform some action, e.g.
+ * join a room
+ */
+export class AppsEngineException extends Error {
+	public name = 'AppsEngineException';
+
+	public static JSONRPC_ERROR_CODE = -32070;
+
+	constructor(message?: string) {
+		super(message);
+	}
+
+	public getErrorInfo() {
+		return {
+			name: this.name,
+			message: this.message,
+		};
+	}
+}

packages/apps-engine/src/definition/exceptions/EssentialAppDisabledException.ts

@@ -0,0 +1,16 @@
+import { AppsEngineException } from '.';
+
+/**
+ * This exception informs the host system that an
+ * app essential to the execution of a system action
+ * is disabled, so the action should be halted.
+ *
+ * Apps can register to be considered essential to
+ * the execution of internal events of the framework
+ * such as `IPreMessageSentPrevent`, `IPreRoomUserJoined`,
+ * etc.
+ *
+ * This is used interally by the framework and is not
+ * intended to be thrown manually by apps.
+ */
+export class EssentialAppDisabledException extends AppsEngineException {}

packages/apps-engine/src/definition/exceptions/FileUploadNotAllowedException.ts

@@ -0,0 +1,12 @@
+import { AppsEngineException } from './AppsEngineException';
+
+/**
+ * This exception informs the host system that an
+ * app has determined that a file upload is not
+ * allowed to be completed.
+ *
+ * Currently it is expected to be thrown by the
+ * following events:
+ * - IPreFileUpload
+ */
+export class FileUploadNotAllowedException extends AppsEngineException {}

packages/apps-engine/src/definition/exceptions/InvalidSettingValueException.ts

@@ -0,0 +1,8 @@
+import { AppsEngineException } from './AppsEngineException';
+
+/**
+ * This exception informs the host system that an
+ * app has determined that an invalid setting value
+ * is passed.
+ */
+export class InvalidSettingValueException extends AppsEngineException {}

packages/apps-engine/src/definition/exceptions/UserNotAllowedException.ts

@@ -0,0 +1,14 @@
+import { AppsEngineException } from '.';
+
+/**
+ * This exception informs the host system that an
+ * app has determined that an user is not allowed
+ * to perform a specific action.
+ *
+ * Currently it is expected to be thrown by the
+ * following events:
+ * - IPreRoomCreatePrevent
+ * - IPreRoomUserJoined
+ * - IPreRoomUserLeave
+ */
+export class UserNotAllowedException extends AppsEngineException {}

packages/apps-engine/src/definition/exceptions/index.ts

@@ -0,0 +1,5 @@
+export * from './AppsEngineException';
+export * from './EssentialAppDisabledException';
+export * from './UserNotAllowedException';
+export * from './FileUploadNotAllowedException';
+export * from './InvalidSettingValueException';