@ketrics/sdk-backend 0.3.0 → 0.5.0

package/dist/job-errors.d.ts

@@ -0,0 +1,157 @@
+/**
+ * Ketrics SDK - Job Error Classes
+ *
+ * Provides typed errors for background job operations in tenant applications.
+ *
+ * Error Hierarchy:
+ * - JobError (base)
+ *   - JobNotFoundError
+ *   - InvalidFunctionError
+ *   - CrossAppPermissionError
+ *   - JobExecutionError
+ */
+/**
+ * Base error class for all Job errors
+ *
+ * All Job errors extend this class and include:
+ * - jobId: The job ID that caused the error (if applicable)
+ * - operation: The operation that failed
+ * - timestamp: When the error occurred
+ */
+export declare abstract class JobError extends Error {
+    /** Job ID that caused the error (if applicable) */
+    readonly jobId?: string;
+    /** Operation that failed */
+    readonly operation: string;
+    /** When the error occurred */
+    readonly timestamp: Date;
+    constructor(message: string, operation: string, jobId?: string);
+    /**
+     * Serialize error for logging
+     */
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when a job is not found
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const status = await ketrics.Job.getStatus('invalid-job-id');
+ * } catch (error) {
+ *   if (error instanceof ketrics.JobNotFoundError) {
+ *     console.log(`Job '${error.jobId}' not found`);
+ *   }
+ * }
+ * ```
+ */
+export declare class JobNotFoundError extends JobError {
+    constructor(jobId: string);
+}
+/**
+ * Error thrown when function name is invalid or missing
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({ function: '' });
+ * } catch (error) {
+ *   if (error instanceof ketrics.InvalidFunctionError) {
+ *     console.log(`Invalid function: ${error.functionName}`);
+ *   }
+ * }
+ * ```
+ */
+export declare class InvalidFunctionError extends JobError {
+    /** The invalid function name */
+    readonly functionName: string;
+    constructor(functionName: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when cross-app job lacks required permission
+ *
+ * This error occurs when attempting to create a job in another application
+ * without a valid application grant that includes background job permission.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({
+ *     application: 'other-app',
+ *     function: 'processData',
+ *   });
+ * } catch (error) {
+ *   if (error instanceof ketrics.CrossAppPermissionError) {
+ *     console.log(`Cannot create job from '${error.sourceApp}' to '${error.targetApp}'`);
+ *   }
+ * }
+ * ```
+ */
+export declare class CrossAppPermissionError extends JobError {
+    /** Source application code (where the job was created from) */
+    readonly sourceApp: string;
+    /** Target application code (where the job would run) */
+    readonly targetApp: string;
+    constructor(sourceApp: string, targetApp: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Error thrown when job execution fails
+ *
+ * This error wraps runtime errors that occur during job execution.
+ *
+ * @example
+ * ```typescript
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'failed' && status.error) {
+ *   console.log(`Job failed with code ${status.error.code}: ${status.error.message}`);
+ * }
+ * ```
+ */
+export declare class JobExecutionError extends JobError {
+    /** Error code from job execution */
+    readonly errorCode: string;
+    constructor(jobId: string, errorCode: string, message: string);
+    toJSON(): Record<string, unknown>;
+}
+/**
+ * Type guard to check if an error is a JobError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a JobError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({ function: 'myFunc' });
+ * } catch (error) {
+ *   if (isJobError(error)) {
+ *     console.log(`Job error during ${error.operation}: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+export declare function isJobError(error: unknown): error is JobError;
+/**
+ * Type guard to check if an error is a specific JobError type
+ *
+ * @param error - The error to check
+ * @param errorClass - The error class to check against
+ * @returns True if the error is an instance of the specified class
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.getStatus('invalid-id');
+ * } catch (error) {
+ *   if (isJobErrorType(error, JobNotFoundError)) {
+ *     console.log('Job not found');
+ *   } else if (isJobErrorType(error, CrossAppPermissionError)) {
+ *     console.log('Permission denied');
+ *   }
+ * }
+ * ```
+ */
+export declare function isJobErrorType<T extends JobError>(error: unknown, errorClass: new (...args: never[]) => T): error is T;
+//# sourceMappingURL=job-errors.d.ts.map

package/dist/job-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-errors.d.ts","sourceRoot":"","sources":["../src/job-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAMH;;;;;;;GAOG;AACH,8BAAsB,QAAS,SAAQ,KAAK;IAC1C,mDAAmD;IACnD,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAExB,4BAA4B;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,8BAA8B;IAC9B,QAAQ,CAAC,SAAS,EAAE,IAAI,CAAC;gBAEb,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;IAa9D;;OAEG;IACH,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CASlC;AAMD;;;;;;;;;;;;;GAaG;AACH,qBAAa,gBAAiB,SAAQ,QAAQ;gBAChC,KAAK,EAAE,MAAM;CAO1B;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,oBAAqB,SAAQ,QAAQ;IAChD,gCAAgC;IAChC,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;gBAElB,YAAY,EAAE,MAAM;IAQhC,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,uBAAwB,SAAQ,QAAQ;IACnD,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAE3B,wDAAwD;IACxD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM;IAShD,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAOlC;AAED;;;;;;;;;;;;GAYG;AACH,qBAAa,iBAAkB,SAAQ,QAAQ;IAC7C,oCAAoC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;gBAEf,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAS7D,MAAM,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;CAMlC;AAMD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,QAAQ,CAE5D;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,QAAQ,EAC/C,KAAK,EAAE,OAAO,EACd,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,GACtC,KAAK,IAAI,CAAC,CAEZ"}

package/dist/job-errors.js

@@ -0,0 +1,212 @@
+"use strict";
+/**
+ * Ketrics SDK - Job Error Classes
+ *
+ * Provides typed errors for background job operations in tenant applications.
+ *
+ * Error Hierarchy:
+ * - JobError (base)
+ *   - JobNotFoundError
+ *   - InvalidFunctionError
+ *   - CrossAppPermissionError
+ *   - JobExecutionError
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.JobExecutionError = exports.CrossAppPermissionError = exports.InvalidFunctionError = exports.JobNotFoundError = exports.JobError = void 0;
+exports.isJobError = isJobError;
+exports.isJobErrorType = isJobErrorType;
+// ============================================================================
+// Base Error Class
+// ============================================================================
+/**
+ * Base error class for all Job errors
+ *
+ * All Job errors extend this class and include:
+ * - jobId: The job ID that caused the error (if applicable)
+ * - operation: The operation that failed
+ * - timestamp: When the error occurred
+ */
+class JobError extends Error {
+    constructor(message, operation, jobId) {
+        super(message);
+        this.name = this.constructor.name;
+        this.operation = operation;
+        this.jobId = jobId;
+        this.timestamp = new Date();
+        // Maintains proper stack trace for where error was thrown
+        if (Error.captureStackTrace) {
+            Error.captureStackTrace(this, this.constructor);
+        }
+    }
+    /**
+     * Serialize error for logging
+     */
+    toJSON() {
+        return {
+            name: this.name,
+            message: this.message,
+            jobId: this.jobId,
+            operation: this.operation,
+            timestamp: this.timestamp.toISOString(),
+        };
+    }
+}
+exports.JobError = JobError;
+// ============================================================================
+// Specific Error Classes
+// ============================================================================
+/**
+ * Error thrown when a job is not found
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   const status = await ketrics.Job.getStatus('invalid-job-id');
+ * } catch (error) {
+ *   if (error instanceof ketrics.JobNotFoundError) {
+ *     console.log(`Job '${error.jobId}' not found`);
+ *   }
+ * }
+ * ```
+ */
+class JobNotFoundError extends JobError {
+    constructor(jobId) {
+        super(`Job '${jobId}' not found. Verify the job ID is correct and the job exists.`, 'getStatus', jobId);
+    }
+}
+exports.JobNotFoundError = JobNotFoundError;
+/**
+ * Error thrown when function name is invalid or missing
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({ function: '' });
+ * } catch (error) {
+ *   if (error instanceof ketrics.InvalidFunctionError) {
+ *     console.log(`Invalid function: ${error.functionName}`);
+ *   }
+ * }
+ * ```
+ */
+class InvalidFunctionError extends JobError {
+    constructor(functionName) {
+        super(`Invalid function name '${functionName}'. Function name must be a non-empty string.`, 'runInBackground');
+        this.functionName = functionName;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            functionName: this.functionName,
+        };
+    }
+}
+exports.InvalidFunctionError = InvalidFunctionError;
+/**
+ * Error thrown when cross-app job lacks required permission
+ *
+ * This error occurs when attempting to create a job in another application
+ * without a valid application grant that includes background job permission.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({
+ *     application: 'other-app',
+ *     function: 'processData',
+ *   });
+ * } catch (error) {
+ *   if (error instanceof ketrics.CrossAppPermissionError) {
+ *     console.log(`Cannot create job from '${error.sourceApp}' to '${error.targetApp}'`);
+ *   }
+ * }
+ * ```
+ */
+class CrossAppPermissionError extends JobError {
+    constructor(sourceApp, targetApp) {
+        super(`Cross-app job permission denied. Application '${sourceApp}' does not have background job permission for '${targetApp}'.`, 'runInBackground');
+        this.sourceApp = sourceApp;
+        this.targetApp = targetApp;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            sourceApp: this.sourceApp,
+            targetApp: this.targetApp,
+        };
+    }
+}
+exports.CrossAppPermissionError = CrossAppPermissionError;
+/**
+ * Error thrown when job execution fails
+ *
+ * This error wraps runtime errors that occur during job execution.
+ *
+ * @example
+ * ```typescript
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'failed' && status.error) {
+ *   console.log(`Job failed with code ${status.error.code}: ${status.error.message}`);
+ * }
+ * ```
+ */
+class JobExecutionError extends JobError {
+    constructor(jobId, errorCode, message) {
+        super(`Job '${jobId}' execution failed: ${message}`, 'execute', jobId);
+        this.errorCode = errorCode;
+    }
+    toJSON() {
+        return {
+            ...super.toJSON(),
+            errorCode: this.errorCode,
+        };
+    }
+}
+exports.JobExecutionError = JobExecutionError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a JobError
+ *
+ * @param error - The error to check
+ * @returns True if the error is a JobError
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.runInBackground({ function: 'myFunc' });
+ * } catch (error) {
+ *   if (isJobError(error)) {
+ *     console.log(`Job error during ${error.operation}: ${error.message}`);
+ *   }
+ * }
+ * ```
+ */
+function isJobError(error) {
+    return error instanceof JobError;
+}
+/**
+ * Type guard to check if an error is a specific JobError type
+ *
+ * @param error - The error to check
+ * @param errorClass - The error class to check against
+ * @returns True if the error is an instance of the specified class
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await ketrics.Job.getStatus('invalid-id');
+ * } catch (error) {
+ *   if (isJobErrorType(error, JobNotFoundError)) {
+ *     console.log('Job not found');
+ *   } else if (isJobErrorType(error, CrossAppPermissionError)) {
+ *     console.log('Permission denied');
+ *   }
+ * }
+ * ```
+ */
+function isJobErrorType(error, errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=job-errors.js.map

package/dist/job-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-errors.js","sourceRoot":"","sources":["../src/job-errors.ts"],"names":[],"mappings":"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"}

package/dist/job.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Ketrics SDK - Job Interfaces and Types
+ *
+ * Provides type definitions for background job execution
+ * in tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Queue a background job
+ * const jobId = await ketrics.Job.runInBackground({
+ *   function: 'generateReport',
+ *   payload: { year: 2024 },
+ *   options: { timeout: 600000 }
+ * });
+ *
+ * // Check job status
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'completed') {
+ *   console.log('Job completed at:', status.completedAt);
+ * }
+ *
+ * // List pending jobs
+ * const result = await ketrics.Job.list({ status: 'pending', limit: 10 });
+ * for (const job of result.jobs) {
+ *   console.log(job.jobId, job.functionName);
+ * }
+ * ```
+ */
+/**
+ * Job status string literal type
+ */
+export type JobStatusValue = 'pending' | 'running' | 'completed' | 'failed';
+/**
+ * Options for background job execution
+ */
+export interface RunInBackgroundOptions {
+    /**
+     * Execution timeout in milliseconds
+     *
+     * @default 300000 (5 minutes)
+     * @max 900000 (15 minutes)
+     */
+    timeout?: number;
+    /**
+     * Idempotency key to prevent duplicate job creation
+     *
+     * If a job with the same idempotency key already exists,
+     * the existing job ID will be returned instead of creating a new job.
+     */
+    idempotencyKey?: string;
+}
+/**
+ * Parameters for Job.runInBackground()
+ */
+export interface RunInBackgroundParams {
+    /**
+     * Target application code (optional)
+     *
+     * If specified, creates a cross-app job that executes in another application.
+     * Requires a valid application grant with background job permission.
+     * If omitted, the job executes in the current application.
+     */
+    application?: string;
+    /**
+     * Function name to execute
+     *
+     * Must be an exported function in the target application.
+     */
+    function: string;
+    /**
+     * Payload to pass to the function
+     *
+     * This object will be passed as the first argument to the function.
+     */
+    payload?: Record<string, unknown>;
+    /**
+     * Execution options
+     */
+    options?: RunInBackgroundOptions;
+}
+/**
+ * Job error details
+ */
+export interface JobErrorDetails {
+    /**
+     * Error code
+     *
+     * Common codes:
+     * - 'TIMEOUT': Job exceeded execution timeout
+     * - 'RUNTIME_ERROR': Unhandled exception in function
+     * - 'FUNCTION_NOT_FOUND': Target function does not exist
+     */
+    code: string;
+    /** Human-readable error message */
+    message: string;
+}
+/**
+ * Job status returned from getStatus() and list()
+ */
+export interface JobStatus {
+    /** Job UUID */
+    jobId: string;
+    /** Application UUID where the job runs */
+    applicationId: string;
+    /** Application code where the job runs */
+    applicationCode: string;
+    /** Function name being executed */
+    functionName: string;
+    /** Current job status */
+    status: JobStatusValue;
+    /** ISO timestamp when the job was created */
+    createdAt: string;
+    /** ISO timestamp when the job started execution (optional) */
+    startedAt?: string;
+    /** ISO timestamp when the job completed (optional) */
+    completedAt?: string;
+    /** Error details if the job failed (optional) */
+    error?: JobErrorDetails;
+}
+/**
+ * Parameters for Job.list()
+ */
+export interface JobListParams {
+    /**
+     * Filter by job status
+     *
+     * If omitted, returns jobs of all statuses.
+     */
+    status?: JobStatusValue;
+    /**
+     * Maximum number of results to return
+     *
+     * @default 20
+     * @max 100
+     */
+    limit?: number;
+    /**
+     * Pagination cursor from previous response
+     *
+     * Pass the `cursor` from a previous JobListResult to fetch the next page.
+     */
+    cursor?: string;
+}
+/**
+ * Result from Job.list()
+ */
+export interface JobListResult {
+    /** Array of job status objects */
+    jobs: JobStatus[];
+    /**
+     * Pagination cursor for fetching the next page
+     *
+     * If present, more results are available. Pass this value as
+     * the `cursor` parameter in the next call to get the next page.
+     */
+    cursor?: string;
+}
+//# sourceMappingURL=job.d.ts.map

package/dist/job.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.d.ts","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AAMH;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,GAAG,QAAQ,CAAC;AAM5E;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;;;;OAKG;IACH,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAElC;;OAEG;IACH,OAAO,CAAC,EAAE,sBAAsB,CAAC;CAClC;AAMD;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb,mCAAmC;IACnC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,eAAe;IACf,KAAK,EAAE,MAAM,CAAC;IAEd,0CAA0C;IAC1C,aAAa,EAAE,MAAM,CAAC;IAEtB,0CAA0C;IAC1C,eAAe,EAAE,MAAM,CAAC;IAExB,mCAAmC;IACnC,YAAY,EAAE,MAAM,CAAC;IAErB,yBAAyB;IACzB,MAAM,EAAE,cAAc,CAAC;IAEvB,6CAA6C;IAC7C,SAAS,EAAE,MAAM,CAAC;IAElB,8DAA8D;IAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC;IAErB,iDAAiD;IACjD,KAAK,CAAC,EAAE,eAAe,CAAC;CACzB;AAMD;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B;;;;OAIG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;IAExB;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf;;;;OAIG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,kCAAkC;IAClC,IAAI,EAAE,SAAS,EAAE,CAAC;IAElB;;;;;OAKG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB"}

package/dist/job.js

@@ -0,0 +1,31 @@
+"use strict";
+/**
+ * Ketrics SDK - Job Interfaces and Types
+ *
+ * Provides type definitions for background job execution
+ * in tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Queue a background job
+ * const jobId = await ketrics.Job.runInBackground({
+ *   function: 'generateReport',
+ *   payload: { year: 2024 },
+ *   options: { timeout: 600000 }
+ * });
+ *
+ * // Check job status
+ * const status = await ketrics.Job.getStatus(jobId);
+ * if (status.status === 'completed') {
+ *   console.log('Job completed at:', status.completedAt);
+ * }
+ *
+ * // List pending jobs
+ * const result = await ketrics.Job.list({ status: 'pending', limit: 10 });
+ * for (const job of result.jobs) {
+ *   console.log(job.jobId, job.functionName);
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=job.js.map

package/dist/job.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"job.js","sourceRoot":"","sources":["../src/job.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG"}

package/dist/messages-errors.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Ketrics SDK - Messages Error Classes
+ *
+ * Provides error class definitions for the Messages SDK.
+ * These classes are used for error handling in tenant applications.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * try {
+ *   await ketrics.Messages.sendToGroup({
+ *     groupCode: 'engineering-team',
+ *     type: 'TEAM_UPDATE',
+ *     subject: 'Sprint planning',
+ *     body: '...'
+ *   });
+ * } catch (error) {
+ *   if (error instanceof ketrics.MessageValidationError) {
+ *     console.log('Invalid message parameters:', error.message);
+ *   } else if (error instanceof ketrics.GroupNotFoundError) {
+ *     console.log('Group not found:', error.message);
+ *   } else if (error instanceof ketrics.TenantGrantPermissionDeniedError) {
+ *     console.log('Missing permissions:', error.missingPermissions);
+ *   }
+ * }
+ * ```
+ */
+/**
+ * Base error class for message-related errors
+ */
+export declare class MessageError extends Error {
+    readonly code: string;
+    constructor(message: string, code?: string);
+}
+/**
+ * Error thrown when message validation fails
+ */
+export declare class MessageValidationError extends MessageError {
+    constructor(message: string);
+}
+/**
+ * Error thrown when group is not found
+ */
+export declare class GroupNotFoundError extends MessageError {
+    constructor(groupCode: string);
+}
+/**
+ * Error thrown when application IAM-data permission is missing
+ *
+ * This error is thrown when an application tries to access tenant data
+ * (users, groups, group memberships) without having the required
+ * IAM-data permissions assigned via its role.
+ */
+export declare class TenantGrantPermissionDeniedError extends MessageError {
+    readonly missingPermissions: string[];
+    constructor(message: string, code?: string);
+    /**
+     * Factory method to create error with permissions list
+     */
+    static withPermissions(permissions: string[]): TenantGrantPermissionDeniedError;
+}
+/**
+ * Type guard to check if an error is a MessageError
+ */
+export declare function isMessageError(error: unknown): error is MessageError;
+/**
+ * Type guard to check if an error is a specific MessageError type
+ */
+export declare function isMessageErrorType<T extends MessageError>(error: unknown, errorClass: new (...args: any[]) => T): error is T;
+//# sourceMappingURL=messages-errors.d.ts.map

package/dist/messages-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-errors.d.ts","sourceRoot":"","sources":["../src/messages-errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,IAAI,EAAE,MAAM,CAAC;gBAEjB,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;CAK3C;AAMD;;GAEG;AACH,qBAAa,sBAAuB,SAAQ,YAAY;gBAC1C,OAAO,EAAE,MAAM;CAI5B;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;gBACtC,SAAS,EAAE,MAAM;CAI9B;AAED;;;;;;GAMG;AACH,qBAAa,gCAAiC,SAAQ,YAAY;IAChE,SAAgB,kBAAkB,EAAE,MAAM,EAAE,CAAC;gBAEjC,OAAO,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM;IAQ1C;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,gCAAgC;CAMhF;AAMD;;GAEG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,YAAY,CAEpE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,YAAY,EACvD,KAAK,EAAE,OAAO,EAEd,UAAU,EAAE,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,CAAC,GACpC,KAAK,IAAI,CAAC,CAEZ"}