@ketrics/sdk-backend 0.4.0 → 0.7.0

package/dist/context.d.ts

@@ -37,26 +37,47 @@ export interface ApplicationContext {
 /**
  * User Context
  *
- * Information about the user or service account making the request.
+ * Information about the user making the request.
+ * @deprecated Use RequestorContext instead for clear distinction between users and service accounts
  */
 export interface UserContext {
-    /** User UUID or Service Account UUID */
+    /** User UUID */
     id: string;
-    /** User email address (empty for service accounts) */
+    /** User email address */
     email: string;
-    /** User full name or Service Account display name */
+    /** User full name */
     name: string;
-    /** Whether user is tenant admin (false for service accounts) */
-    isAdmin: boolean;
-    /** Whether this is a service account (non-human identity) */
-    isServiceAccount: boolean;
+    /** User's application permissions for the current app (e.g., ["read", "write"] or ["*"]) */
+    applicationPermissions: string[];
 }
 /**
- * Environment Context
+ * Requestor Context
+ *
+ * Information about who/what is making the request.
+ * Provides clear distinction between users and service accounts.
+ */
+export interface RequestorContext {
+    /** Type of requestor */
+    type: 'USER' | 'SERVICE_ACCOUNT';
+    /** User UUID (only when type is 'USER') */
+    userId?: string;
+    /** Service account UUID (only when type is 'SERVICE_ACCOUNT') */
+    serviceAccountId?: string;
+    /** Service account code (only when type is 'SERVICE_ACCOUNT') */
+    serviceAccountCode?: string;
+    /** Display name of the requestor */
+    name: string;
+    /** Email address (only when type is 'USER') */
+    email?: string;
+    /** Requestor's application permissions for the current app */
+    applicationPermissions: string[];
+}
+/**
+ * Runtime Context
  *
  * Information about the runtime environment.
  */
-export interface EnvironmentContext {
+export interface RuntimeContext {
     /** Node.js version (e.g., "18.x") */
     nodeVersion: string;
     /** Runtime platform */
@@ -64,4 +85,11 @@ export interface EnvironmentContext {
     /** AWS region (e.g., "us-east-1") */
     region: string;
 }
+/**
+ * Environment Variables
+ *
+ * Key-value map of application environment variables.
+ * Keys are uppercase with letters, numbers, and underscores only.
+ */
+export type EnvironmentVariables = Record<string, string>;
 //# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,wCAAwC;IACxC,EAAE,EAAE,MAAM,CAAC;IACX,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB,6DAA6D;IAC7D,gBAAgB,EAAE,OAAO,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,kBAAkB;IAClB,EAAE,EAAE,MAAM,CAAC;IACX,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,uBAAuB;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,kDAAkD;IAClD,IAAI,EAAE,MAAM,CAAC;IACb,+BAA+B;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;;;GAKG;AACH,MAAM,WAAW,WAAW;IAC1B,gBAAgB;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,yBAAyB;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,4FAA4F;IAC5F,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;;GAKG;AACH,MAAM,WAAW,gBAAgB;IAC/B,wBAAwB;IACxB,IAAI,EAAE,MAAM,GAAG,iBAAiB,CAAC;IAEjC,2CAA2C;IAC3C,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,iEAAiE;IACjE,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,iEAAiE;IACjE,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,oCAAoC;IACpC,IAAI,EAAE,MAAM,CAAC;IAEb,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,8DAA8D;IAC9D,sBAAsB,EAAE,MAAM,EAAE,CAAC;CAClC;AAED;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC7B,qCAAqC;IACrC,WAAW,EAAE,MAAM,CAAC;IACpB,uBAAuB;IACvB,OAAO,EAAE,aAAa,CAAC;IACvB,qCAAqC;IACrC,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;;;GAKG;AACH,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC"}

package/dist/index.d.ts

@@ -14,7 +14,8 @@
  * export async function handler() {
  *   // Access the global ketrics object (auto-typed)
  *   console.log(ketrics.tenant.name);
- *   console.log(ketrics.user.email);
+ *   console.log(ketrics.requestor.name);
+ *   console.log(ketrics.requestor.type); // 'USER' or 'SERVICE_ACCOUNT'
  *
  *   // Use ketrics.Volume.connect() for S3 storage
  *   try {
@@ -54,7 +55,7 @@
  * }
  * ```
  */
-export { TenantContext, ApplicationContext, UserContext, EnvironmentContext, } from './context';
+export { TenantContext, ApplicationContext, UserContext, RequestorContext, RuntimeContext, EnvironmentVariables, } from './context';
 export { ConsoleLogger } from './console';
 export { HttpRequestConfig, HttpResponse, HttpClient } from './http';
 export { DatabaseQueryResult, DatabaseExecuteResult, IDatabaseConnection, DatabaseManager, } from './databases';
@@ -67,9 +68,11 @@ export { PdfPageSize, PdfStandardFont, PdfRgbColor, PdfDrawTextOptions, PdfDrawR
 export { PdfError, PdfParseError, PdfWriteError, isPdfError, isPdfErrorType, } from './pdf-errors';
 export { JobStatusValue, RunInBackgroundOptions, RunInBackgroundParams, JobErrorDetails, JobStatus, JobListParams, JobListResult, } from './job';
 export { JobError, JobNotFoundError, InvalidFunctionError, CrossAppPermissionError, JobExecutionError, isJobError, isJobErrorType, } from './job-errors';
+export { MessagePriorityLevel, MessageChannelConfig, SendMessageParams, SendBulkMessageParams, SendGroupMessageParams, SendMessageResult, SendBulkMessageResult, MessagesManager, } from './messages';
+export { MessageError, MessageValidationError, GroupNotFoundError, TenantGrantPermissionDeniedError, isMessageError, isMessageErrorType, } from './messages-errors';
 export { PutContent, FileContent, FileMetadata, FileInfo, PutOptions, PutResult, DeleteResult, DeleteError, DeleteByPrefixResult, ListOptions, ListResult, CopyOptions, CopyResult, MoveOptions, MoveResult, DownloadUrlOptions, UploadUrlOptions, PresignedUrl, IVolume, } from './volumes';
 export { VolumePermissionValue, VolumeError, VolumeNotFoundError, VolumeAccessDeniedError, VolumePermissionDeniedError, FileNotFoundError, FileAlreadyExistsError, InvalidPathError, FileSizeLimitError, ContentTypeNotAllowedError, isVolumeError, isVolumeErrorType, } from './errors';
-import type { TenantContext, ApplicationContext, UserContext, EnvironmentContext } from './context';
+import type { TenantContext, ApplicationContext, RequestorContext, RuntimeContext, EnvironmentVariables } from './context';
 import type { ConsoleLogger } from './console';
 import type { HttpClient } from './http';
 import type { IDatabaseConnection } from './databases';
@@ -77,12 +80,21 @@ import type { IVolume } from './volumes';
 import type { IExcelWorkbook } from './excel';
 import type { IPdfDocument, PdfRgbColor } from './pdf';
 import type { RunInBackgroundParams, JobStatus, JobListParams, JobListResult } from './job';
+import type { MessagesManager } from './messages';
 import { VolumeError as VolumeErrorClass, VolumeNotFoundError as VolumeNotFoundErrorClass, VolumeAccessDeniedError as VolumeAccessDeniedErrorClass, VolumePermissionDeniedError as VolumePermissionDeniedErrorClass, FileNotFoundError as FileNotFoundErrorClass, FileAlreadyExistsError as FileAlreadyExistsErrorClass, InvalidPathError as InvalidPathErrorClass, FileSizeLimitError as FileSizeLimitErrorClass, ContentTypeNotAllowedError as ContentTypeNotAllowedErrorClass } from './errors';
 import { DatabaseError as DatabaseErrorClass, DatabaseNotFoundError as DatabaseNotFoundErrorClass, DatabaseAccessDeniedError as DatabaseAccessDeniedErrorClass, DatabaseConnectionError as DatabaseConnectionErrorClass, DatabaseQueryError as DatabaseQueryErrorClass, DatabaseTransactionError as DatabaseTransactionErrorClass } from './database-errors';
 import { SecretError as SecretErrorClass, SecretNotFoundError as SecretNotFoundErrorClass, SecretAccessDeniedError as SecretAccessDeniedErrorClass, SecretDecryptionError as SecretDecryptionErrorClass } from './secret-errors';
 import { ExcelError as ExcelErrorClass, ExcelParseError as ExcelParseErrorClass, ExcelWriteError as ExcelWriteErrorClass } from './excel-errors';
 import { PdfError as PdfErrorClass, PdfParseError as PdfParseErrorClass, PdfWriteError as PdfWriteErrorClass } from './pdf-errors';
 import { JobError as JobErrorClass, JobNotFoundError as JobNotFoundErrorClass, InvalidFunctionError as InvalidFunctionErrorClass, CrossAppPermissionError as CrossAppPermissionErrorClass, JobExecutionError as JobExecutionErrorClass } from './job-errors';
+import { MessageError as MessageErrorClass, MessageValidationError as MessageValidationErrorClass, GroupNotFoundError as GroupNotFoundErrorClass, TenantGrantPermissionDeniedError as TenantGrantPermissionDeniedErrorClass } from './messages-errors';
+import { isVolumeError, isVolumeErrorType } from './errors';
+import { isDatabaseError, isDatabaseErrorType } from './database-errors';
+import { isSecretError, isSecretErrorType } from './secret-errors';
+import { isExcelError, isExcelErrorType } from './excel-errors';
+import { isPdfError, isPdfErrorType } from './pdf-errors';
+import { isJobError, isJobErrorType } from './job-errors';
+import { isMessageError, isMessageErrorType } from './messages-errors';
 /**
  * Ketrics Platform SDK Interface
  *
@@ -94,8 +106,9 @@ import { JobError as JobErrorClass, JobNotFoundError as JobNotFoundErrorClass, I
  * // Access tenant context
  * console.log(ketrics.tenant.name);
  * console.log(ketrics.application.code);
- * console.log(ketrics.user.email);
- * console.log(ketrics.env.region);
+ * console.log(ketrics.requestor.name);
+ * console.log(ketrics.requestor.type); // 'USER' or 'SERVICE_ACCOUNT'
+ * console.log(ketrics.runtime.region);
  *
  * // Use console logging (forwarded to CloudWatch)
  * ketrics.console.log('Processing request...');
@@ -116,6 +129,14 @@ import { JobError as JobErrorClass, JobNotFoundError as JobNotFoundErrorClass, I
  * // Access volumes
  * const volume = await ketrics.Volume.connect('uploads');
  * const file = await volume.get('document.pdf');
+ *
+ * // Send messages to users
+ * await ketrics.Messages.send({
+ *   userId: 'user-123',
+ *   type: 'ORDER_SHIPPED',
+ *   subject: 'Your order shipped!',
+ *   body: 'Track your package...'
+ * });
  * ```
  */
 export interface KetricsSdkV1 {
@@ -123,14 +144,144 @@ export interface KetricsSdkV1 {
     tenant: TenantContext;
     /** Current application information */
     application: ApplicationContext;
-    /** Current user information */
-    user: UserContext;
+    /** Current requestor information (user or service account) */
+    requestor: RequestorContext;
     /** Runtime environment information */
-    env: EnvironmentContext;
+    runtime: RuntimeContext;
+    /** Application environment variables (key-value pairs) */
+    environment: EnvironmentVariables;
     /** Console logging (forwarded to CloudWatch) */
     console: ConsoleLogger;
     /** HTTP client for external API requests */
     http: HttpClient;
+    /** Volume class with static connect() factory method */
+    Volume: {
+        connect(volumeCode: string): Promise<IVolume>;
+    };
+    /** Base error class for all Volume errors (abstract) */
+    VolumeError: typeof VolumeErrorClass;
+    /** Error thrown when volume doesn't exist */
+    VolumeNotFoundError: typeof VolumeNotFoundErrorClass;
+    /** Error thrown when application has no access grant */
+    VolumeAccessDeniedError: typeof VolumeAccessDeniedErrorClass;
+    /** Error thrown when operation requires missing permission */
+    VolumePermissionDeniedError: typeof VolumePermissionDeniedErrorClass;
+    /** Error thrown when file doesn't exist */
+    FileNotFoundError: typeof FileNotFoundErrorClass;
+    /** Error thrown when file already exists (with ifNotExists option) */
+    FileAlreadyExistsError: typeof FileAlreadyExistsErrorClass;
+    /** Error thrown for invalid path characters or traversal attempts */
+    InvalidPathError: typeof InvalidPathErrorClass;
+    /** Error thrown when file exceeds size limit */
+    FileSizeLimitError: typeof FileSizeLimitErrorClass;
+    /** Error thrown when content type is not allowed */
+    ContentTypeNotAllowedError: typeof ContentTypeNotAllowedErrorClass;
+    /** Type guard to check if error is a VolumeError */
+    isVolumeError: typeof isVolumeError;
+    /** Type guard to check if error is a specific VolumeError type */
+    isVolumeErrorType: typeof isVolumeErrorType;
+    /** DatabaseConnection class with static connect() factory method */
+    DatabaseConnection: {
+        connect(databaseCode: string): Promise<IDatabaseConnection>;
+    };
+    /** Base error class for all Database errors (abstract) */
+    DatabaseError: typeof DatabaseErrorClass;
+    /** Error thrown when database doesn't exist */
+    DatabaseNotFoundError: typeof DatabaseNotFoundErrorClass;
+    /** Error thrown when application has no access grant */
+    DatabaseAccessDeniedError: typeof DatabaseAccessDeniedErrorClass;
+    /** Error thrown when connection cannot be established */
+    DatabaseConnectionError: typeof DatabaseConnectionErrorClass;
+    /** Error thrown when query execution fails */
+    DatabaseQueryError: typeof DatabaseQueryErrorClass;
+    /** Error thrown when transaction fails */
+    DatabaseTransactionError: typeof DatabaseTransactionErrorClass;
+    /** Type guard to check if error is a DatabaseError */
+    isDatabaseError: typeof isDatabaseError;
+    /** Type guard to check if error is a specific DatabaseError type */
+    isDatabaseErrorType: typeof isDatabaseErrorType;
+    /** Secret class with static get() method */
+    Secret: {
+        get(secretCode: string): Promise<string>;
+        exists(secretCode: string): Promise<boolean>;
+    };
+    /** Base error class for all Secret errors (abstract) */
+    SecretError: typeof SecretErrorClass;
+    /** Error thrown when secret doesn't exist */
+    SecretNotFoundError: typeof SecretNotFoundErrorClass;
+    /** Error thrown when application has no access grant */
+    SecretAccessDeniedError: typeof SecretAccessDeniedErrorClass;
+    /** Error thrown when decryption fails */
+    SecretDecryptionError: typeof SecretDecryptionErrorClass;
+    /** Type guard to check if error is a SecretError */
+    isSecretError: typeof isSecretError;
+    /** Type guard to check if error is a specific SecretError type */
+    isSecretErrorType: typeof isSecretErrorType;
+    /** Excel class with static read() and create() methods */
+    Excel: {
+        read(buffer: Buffer): Promise<IExcelWorkbook>;
+        create(): IExcelWorkbook;
+    };
+    /** Base error class for all Excel errors (abstract) */
+    ExcelError: typeof ExcelErrorClass;
+    /** Error thrown when parsing Excel file fails */
+    ExcelParseError: typeof ExcelParseErrorClass;
+    /** Error thrown when writing Excel file fails */
+    ExcelWriteError: typeof ExcelWriteErrorClass;
+    /** Type guard to check if error is an ExcelError */
+    isExcelError: typeof isExcelError;
+    /** Type guard to check if error is a specific ExcelError type */
+    isExcelErrorType: typeof isExcelErrorType;
+    /** PDF class with static read() and create() methods */
+    Pdf: {
+        read(buffer: Buffer): Promise<IPdfDocument>;
+        create(): Promise<IPdfDocument>;
+        rgb(r: number, g: number, b: number): PdfRgbColor;
+    };
+    /** Base error class for all PDF errors (abstract) */
+    PdfError: typeof PdfErrorClass;
+    /** Error thrown when parsing PDF file fails */
+    PdfParseError: typeof PdfParseErrorClass;
+    /** Error thrown when writing PDF file fails */
+    PdfWriteError: typeof PdfWriteErrorClass;
+    /** Type guard to check if error is a PdfError */
+    isPdfError: typeof isPdfError;
+    /** Type guard to check if error is a specific PdfError type */
+    isPdfErrorType: typeof isPdfErrorType;
+    /** Job class with static methods for background job operations */
+    Job: {
+        runInBackground(params: RunInBackgroundParams): Promise<string>;
+        getStatus(jobId: string): Promise<JobStatus>;
+        list(params?: JobListParams): Promise<JobListResult>;
+    };
+    /** Base error class for all job errors */
+    JobError: typeof JobErrorClass;
+    /** Thrown when a job is not found */
+    JobNotFoundError: typeof JobNotFoundErrorClass;
+    /** Thrown when function name is invalid or missing */
+    InvalidFunctionError: typeof InvalidFunctionErrorClass;
+    /** Thrown when cross-app job lacks required permission */
+    CrossAppPermissionError: typeof CrossAppPermissionErrorClass;
+    /** Thrown when job execution fails */
+    JobExecutionError: typeof JobExecutionErrorClass;
+    /** Type guard to check if error is a JobError */
+    isJobError: typeof isJobError;
+    /** Type guard to check if error is a specific JobError type */
+    isJobErrorType: typeof isJobErrorType;
+    /** Messages class with static methods for sending messages to users */
+    Messages: MessagesManager;
+    /** Base error class for all message errors */
+    MessageError: typeof MessageErrorClass;
+    /** Error thrown when message validation fails */
+    MessageValidationError: typeof MessageValidationErrorClass;
+    /** Error thrown when group is not found */
+    GroupNotFoundError: typeof GroupNotFoundErrorClass;
+    /** Error thrown when TenantGrant permissions are missing */
+    TenantGrantPermissionDeniedError: typeof TenantGrantPermissionDeniedErrorClass;
+    /** Type guard to check if error is a MessageError */
+    isMessageError: typeof isMessageError;
+    /** Type guard to check if error is a specific MessageError type */
+    isMessageErrorType: typeof isMessageErrorType;
 }
 /**
  * Volume - S3-backed storage for tenant applications
@@ -483,177 +634,20 @@ export declare class Job {
  * Global declaration for the Ketrics VM sandbox.
  *
  * The `ketrics` global object provides:
- * - Context: tenant, application, user, env
+ * - Context: tenant, application, requestor, runtime, environment
  * - Utilities: console, http
  * - Volume: Static class for S3 storage
  * - DatabaseConnection: Static class for database access
  * - Secret: Static class for secret retrieval
+ * - Excel: Static class for Excel file operations
+ * - Pdf: Static class for PDF file operations
+ * - Job: Static class for background job execution
+ * - Messages: Static class for user messaging
  * - Error classes: For instanceof checks
+ * - Type guards: For error type checking
  */
 declare global {
     /** Ketrics SDK global object - available in all tenant application code */
-    const ketrics: KetricsSdkV1 & {
-        /**
-         * Volume class for S3-backed storage
-         *
-         * Use `ketrics.Volume.connect()` to get a connected volume instance.
-         *
-         * @example
-         * ```typescript
-         * const volume = await ketrics.Volume.connect('uploads');
-         * const file = await volume.get('document.pdf');
-         * ```
-         */
-        Volume: {
-            connect(volumeCode: string): Promise<IVolume>;
-        };
-        /**
-         * DatabaseConnection class for external database access
-         *
-         * Use `ketrics.DatabaseConnection.connect()` to get a connected database instance.
-         *
-         * @example
-         * ```typescript
-         * const db = await ketrics.DatabaseConnection.connect('main-db');
-         * const result = await db.query('SELECT * FROM users');
-         * await db.close();
-         * ```
-         */
-        DatabaseConnection: {
-            connect(databaseCode: string): Promise<IDatabaseConnection>;
-        };
-        /**
-         * Secret class for encrypted secret retrieval
-         *
-         * Use `ketrics.Secret.get()` to retrieve a secret value.
-         *
-         * @example
-         * ```typescript
-         * const apiKey = await ketrics.Secret.get('stripe-api-key');
-         * ```
-         */
-        Secret: {
-            get(secretCode: string): Promise<string>;
-            exists(secretCode: string): Promise<boolean>;
-        };
-        /**
-         * Excel class for reading and writing Excel files
-         *
-         * Use `ketrics.Excel.read()` to parse an Excel file or
-         * `ketrics.Excel.create()` to create a new workbook.
-         *
-         * @example
-         * ```typescript
-         * const workbook = await ketrics.Excel.read(file.content);
-         * const sheet = workbook.getWorksheet('Sheet1');
-         * ```
-         */
-        Excel: {
-            read(buffer: Buffer): Promise<IExcelWorkbook>;
-            create(): IExcelWorkbook;
-        };
-        /**
-         * Pdf class for reading, creating, and modifying PDF files
-         *
-         * Use `ketrics.Pdf.read()` to parse a PDF file or
-         * `ketrics.Pdf.create()` to create a new document.
-         *
-         * @example
-         * ```typescript
-         * const doc = await ketrics.Pdf.read(file.content);
-         * console.log('Pages:', doc.getPageCount());
-         *
-         * const newDoc = await ketrics.Pdf.create();
-         * const page = newDoc.addPage('A4');
-         * await page.drawText('Hello!', { x: 50, y: 700, size: 24 });
-         * ```
-         */
-        Pdf: {
-            read(buffer: Buffer): Promise<IPdfDocument>;
-            create(): Promise<IPdfDocument>;
-            rgb(r: number, g: number, b: number): PdfRgbColor;
-        };
-        /**
-         * Job class for background job execution
-         *
-         * Use `ketrics.Job.runInBackground()` to queue a background job,
-         * `ketrics.Job.getStatus()` to check job status, or
-         * `ketrics.Job.list()` to list jobs.
-         *
-         * @example
-         * ```typescript
-         * const jobId = await ketrics.Job.runInBackground({
-         *   function: 'generateReport',
-         *   payload: { year: 2024 }
-         * });
-         * const status = await ketrics.Job.getStatus(jobId);
-         * ```
-         */
-        Job: {
-            runInBackground(params: RunInBackgroundParams): Promise<string>;
-            getStatus(jobId: string): Promise<JobStatus>;
-            list(params?: JobListParams): Promise<JobListResult>;
-        };
-        /** Base class for all volume errors */
-        VolumeError: typeof VolumeErrorClass;
-        /** Thrown when a volume does not exist */
-        VolumeNotFoundError: typeof VolumeNotFoundErrorClass;
-        /** Thrown when application has no access grant to volume */
-        VolumeAccessDeniedError: typeof VolumeAccessDeniedErrorClass;
-        /** Thrown when operation requires a permission not granted */
-        VolumePermissionDeniedError: typeof VolumePermissionDeniedErrorClass;
-        /** Thrown when a file does not exist */
-        FileNotFoundError: typeof FileNotFoundErrorClass;
-        /** Thrown when file already exists (with ifNotExists option) */
-        FileAlreadyExistsError: typeof FileAlreadyExistsErrorClass;
-        /** Thrown when file path is invalid */
-        InvalidPathError: typeof InvalidPathErrorClass;
-        /** Thrown when file exceeds size limit */
-        FileSizeLimitError: typeof FileSizeLimitErrorClass;
-        /** Thrown when content type is not allowed */
-        ContentTypeNotAllowedError: typeof ContentTypeNotAllowedErrorClass;
-        /** Base class for all database errors */
-        DatabaseError: typeof DatabaseErrorClass;
-        /** Thrown when a database does not exist */
-        DatabaseNotFoundError: typeof DatabaseNotFoundErrorClass;
-        /** Thrown when application has no access grant to database */
-        DatabaseAccessDeniedError: typeof DatabaseAccessDeniedErrorClass;
-        /** Thrown when database connection cannot be established */
-        DatabaseConnectionError: typeof DatabaseConnectionErrorClass;
-        /** Thrown when a database query fails */
-        DatabaseQueryError: typeof DatabaseQueryErrorClass;
-        /** Thrown when a database transaction fails */
-        DatabaseTransactionError: typeof DatabaseTransactionErrorClass;
-        /** Base class for all secret errors */
-        SecretError: typeof SecretErrorClass;
-        /** Thrown when a secret does not exist */
-        SecretNotFoundError: typeof SecretNotFoundErrorClass;
-        /** Thrown when application has no access grant to secret */
-        SecretAccessDeniedError: typeof SecretAccessDeniedErrorClass;
-        /** Thrown when secret decryption fails */
-        SecretDecryptionError: typeof SecretDecryptionErrorClass;
-        /** Base class for all Excel errors */
-        ExcelError: typeof ExcelErrorClass;
-        /** Thrown when an Excel file cannot be parsed */
-        ExcelParseError: typeof ExcelParseErrorClass;
-        /** Thrown when an Excel file cannot be written */
-        ExcelWriteError: typeof ExcelWriteErrorClass;
-        /** Base class for all PDF errors */
-        PdfError: typeof PdfErrorClass;
-        /** Thrown when a PDF file cannot be parsed */
-        PdfParseError: typeof PdfParseErrorClass;
-        /** Thrown when a PDF file cannot be written */
-        PdfWriteError: typeof PdfWriteErrorClass;
-        /** Base class for all job errors */
-        JobError: typeof JobErrorClass;
-        /** Thrown when a job is not found */
-        JobNotFoundError: typeof JobNotFoundErrorClass;
-        /** Thrown when function name is invalid or missing */
-        InvalidFunctionError: typeof InvalidFunctionErrorClass;
-        /** Thrown when cross-app job lacks required permission */
-        CrossAppPermissionError: typeof CrossAppPermissionErrorClass;
-        /** Thrown when job execution fails */
-        JobExecutionError: typeof JobExecutionErrorClass;
-    };
+    const ketrics: KetricsSdkV1;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -15,7 +15,8 @@
  * export async function handler() {
  *   // Access the global ketrics object (auto-typed)
  *   console.log(ketrics.tenant.name);
- *   console.log(ketrics.user.email);
+ *   console.log(ketrics.requestor.name);
+ *   console.log(ketrics.requestor.type); // 'USER' or 'SERVICE_ACCOUNT'
  *
  *   // Use ketrics.Volume.connect() for S3 storage
  *   try {
@@ -56,7 +57,7 @@
  * ```
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.isVolumeErrorType = exports.isVolumeError = exports.ContentTypeNotAllowedError = exports.FileSizeLimitError = exports.InvalidPathError = exports.FileAlreadyExistsError = exports.FileNotFoundError = exports.VolumePermissionDeniedError = exports.VolumeAccessDeniedError = exports.VolumeNotFoundError = exports.VolumeError = exports.isJobErrorType = exports.isJobError = exports.JobExecutionError = exports.CrossAppPermissionError = exports.InvalidFunctionError = exports.JobNotFoundError = exports.JobError = exports.isPdfErrorType = exports.isPdfError = exports.PdfWriteError = exports.PdfParseError = exports.PdfError = exports.isExcelErrorType = exports.isExcelError = exports.ExcelWriteError = exports.ExcelParseError = exports.ExcelError = exports.isSecretErrorType = exports.isSecretError = exports.SecretDecryptionError = exports.SecretAccessDeniedError = exports.SecretNotFoundError = exports.SecretError = exports.isDatabaseErrorType = exports.isDatabaseError = exports.DatabaseTransactionError = exports.DatabaseQueryError = exports.DatabaseConnectionError = exports.DatabaseAccessDeniedError = exports.DatabaseNotFoundError = exports.DatabaseError = void 0;
+exports.isVolumeErrorType = exports.isVolumeError = exports.ContentTypeNotAllowedError = exports.FileSizeLimitError = exports.InvalidPathError = exports.FileAlreadyExistsError = exports.FileNotFoundError = exports.VolumePermissionDeniedError = exports.VolumeAccessDeniedError = exports.VolumeNotFoundError = exports.VolumeError = exports.isMessageErrorType = exports.isMessageError = exports.TenantGrantPermissionDeniedError = exports.GroupNotFoundError = exports.MessageValidationError = exports.MessageError = exports.isJobErrorType = exports.isJobError = exports.JobExecutionError = exports.CrossAppPermissionError = exports.InvalidFunctionError = exports.JobNotFoundError = exports.JobError = exports.isPdfErrorType = exports.isPdfError = exports.PdfWriteError = exports.PdfParseError = exports.PdfError = exports.isExcelErrorType = exports.isExcelError = exports.ExcelWriteError = exports.ExcelParseError = exports.ExcelError = exports.isSecretErrorType = exports.isSecretError = exports.SecretDecryptionError = exports.SecretAccessDeniedError = exports.SecretNotFoundError = exports.SecretError = exports.isDatabaseErrorType = exports.isDatabaseError = exports.DatabaseTransactionError = exports.DatabaseQueryError = exports.DatabaseConnectionError = exports.DatabaseAccessDeniedError = exports.DatabaseNotFoundError = exports.DatabaseError = void 0;
 // ============================================================================
 // Database Error Exports
 // ============================================================================
@@ -109,6 +110,16 @@ Object.defineProperty(exports, "JobExecutionError", { enumerable: true, get: fun
 Object.defineProperty(exports, "isJobError", { enumerable: true, get: function () { return job_errors_1.isJobError; } });
 Object.defineProperty(exports, "isJobErrorType", { enumerable: true, get: function () { return job_errors_1.isJobErrorType; } });
 // ============================================================================
+// Messages Error Exports
+// ============================================================================
+var messages_errors_1 = require("./messages-errors");
+Object.defineProperty(exports, "MessageError", { enumerable: true, get: function () { return messages_errors_1.MessageError; } });
+Object.defineProperty(exports, "MessageValidationError", { enumerable: true, get: function () { return messages_errors_1.MessageValidationError; } });
+Object.defineProperty(exports, "GroupNotFoundError", { enumerable: true, get: function () { return messages_errors_1.GroupNotFoundError; } });
+Object.defineProperty(exports, "TenantGrantPermissionDeniedError", { enumerable: true, get: function () { return messages_errors_1.TenantGrantPermissionDeniedError; } });
+Object.defineProperty(exports, "isMessageError", { enumerable: true, get: function () { return messages_errors_1.isMessageError; } });
+Object.defineProperty(exports, "isMessageErrorType", { enumerable: true, get: function () { return messages_errors_1.isMessageErrorType; } });
+// ============================================================================
 // Volume Error Exports
 // ============================================================================
 var errors_1 = require("./errors");

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuDG;;;AAoCH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,qDAS2B;AARzB,gHAAA,aAAa,OAAA;AACb,wHAAA,qBAAqB,OAAA;AACrB,4HAAA,yBAAyB,OAAA;AACzB,0HAAA,uBAAuB,OAAA;AACvB,qHAAA,kBAAkB,OAAA;AAClB,2HAAA,wBAAwB,OAAA;AACxB,kHAAA,eAAe,OAAA;AACf,sHAAA,mBAAmB,OAAA;AASrB,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,iDAOyB;AANvB,4GAAA,WAAW,OAAA;AACX,oHAAA,mBAAmB,OAAA;AACnB,wHAAA,uBAAuB,OAAA;AACvB,sHAAA,qBAAqB,OAAA;AACrB,8GAAA,aAAa,OAAA;AACb,kHAAA,iBAAiB,OAAA;AAqBnB,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,+CAMwB;AALtB,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA;AACf,+GAAA,eAAe,OAAA;AACf,4GAAA,YAAY,OAAA;AACZ,gHAAA,gBAAgB,OAAA;AA2BlB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAMsB;AALpB,sGAAA,QAAQ,OAAA;AACR,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AAiBhB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAQsB;AAPpB,sGAAA,QAAQ,OAAA;AACR,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AAqChB,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,mCAgBkB;AAbhB,gBAAgB;AAChB,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AACnB,iHAAA,uBAAuB,OAAA;AACvB,qHAAA,2BAA2B,OAAA;AAC3B,2GAAA,iBAAiB,OAAA;AACjB,gHAAA,sBAAsB,OAAA;AACtB,0GAAA,gBAAgB,OAAA;AAChB,4GAAA,kBAAkB,OAAA;AAClB,oHAAA,0BAA0B,OAAA;AAC1B,cAAc;AACd,uGAAA,aAAa,OAAA;AACb,2GAAA,iBAAiB,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwDG;;;AAsCH,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,qDAS2B;AARzB,gHAAA,aAAa,OAAA;AACb,wHAAA,qBAAqB,OAAA;AACrB,4HAAA,yBAAyB,OAAA;AACzB,0HAAA,uBAAuB,OAAA;AACvB,qHAAA,kBAAkB,OAAA;AAClB,2HAAA,wBAAwB,OAAA;AACxB,kHAAA,eAAe,OAAA;AACf,sHAAA,mBAAmB,OAAA;AASrB,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,iDAOyB;AANvB,4GAAA,WAAW,OAAA;AACX,oHAAA,mBAAmB,OAAA;AACnB,wHAAA,uBAAuB,OAAA;AACvB,sHAAA,qBAAqB,OAAA;AACrB,8GAAA,aAAa,OAAA;AACb,kHAAA,iBAAiB,OAAA;AAqBnB,+EAA+E;AAC/E,sBAAsB;AACtB,+EAA+E;AAE/E,+CAMwB;AALtB,0GAAA,UAAU,OAAA;AACV,+GAAA,eAAe,OAAA;AACf,+GAAA,eAAe,OAAA;AACf,4GAAA,YAAY,OAAA;AACZ,gHAAA,gBAAgB,OAAA;AA2BlB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAMsB;AALpB,sGAAA,QAAQ,OAAA;AACR,2GAAA,aAAa,OAAA;AACb,2GAAA,aAAa,OAAA;AACb,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AAiBhB,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E,2CAQsB;AAPpB,sGAAA,QAAQ,OAAA;AACR,8GAAA,gBAAgB,OAAA;AAChB,kHAAA,oBAAoB,OAAA;AACpB,qHAAA,uBAAuB,OAAA;AACvB,+GAAA,iBAAiB,OAAA;AACjB,wGAAA,UAAU,OAAA;AACV,4GAAA,cAAc,OAAA;AAkBhB,+EAA+E;AAC/E,yBAAyB;AACzB,+EAA+E;AAE/E,qDAO2B;AANzB,+GAAA,YAAY,OAAA;AACZ,yHAAA,sBAAsB,OAAA;AACtB,qHAAA,kBAAkB,OAAA;AAClB,mIAAA,gCAAgC,OAAA;AAChC,iHAAA,cAAc,OAAA;AACd,qHAAA,kBAAkB,OAAA;AAqCpB,+EAA+E;AAC/E,uBAAuB;AACvB,+EAA+E;AAE/E,mCAgBkB;AAbhB,gBAAgB;AAChB,qGAAA,WAAW,OAAA;AACX,6GAAA,mBAAmB,OAAA;AACnB,iHAAA,uBAAuB,OAAA;AACvB,qHAAA,2BAA2B,OAAA;AAC3B,2GAAA,iBAAiB,OAAA;AACjB,gHAAA,sBAAsB,OAAA;AACtB,0GAAA,gBAAgB,OAAA;AAChB,4GAAA,kBAAkB,OAAA;AAClB,oHAAA,0BAA0B,OAAA;AAC1B,cAAc;AACd,uGAAA,aAAa,OAAA;AACb,2GAAA,iBAAiB,OAAA"}

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"}

package/dist/messages-errors.js

@@ -0,0 +1,110 @@
+"use strict";
+/**
+ * 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);
+ *   }
+ * }
+ * ```
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TenantGrantPermissionDeniedError = exports.GroupNotFoundError = exports.MessageValidationError = exports.MessageError = void 0;
+exports.isMessageError = isMessageError;
+exports.isMessageErrorType = isMessageErrorType;
+// ============================================================================
+// Base Message Error
+// ============================================================================
+/**
+ * Base error class for message-related errors
+ */
+class MessageError extends Error {
+    constructor(message, code) {
+        super(message);
+        this.name = 'MessageError';
+        this.code = code ?? 'MESSAGE_ERROR';
+    }
+}
+exports.MessageError = MessageError;
+// ============================================================================
+// Specific Message Errors
+// ============================================================================
+/**
+ * Error thrown when message validation fails
+ */
+class MessageValidationError extends MessageError {
+    constructor(message) {
+        super(message, 'VALIDATION_ERROR');
+        this.name = 'MessageValidationError';
+    }
+}
+exports.MessageValidationError = MessageValidationError;
+/**
+ * Error thrown when group is not found
+ */
+class GroupNotFoundError extends MessageError {
+    constructor(groupCode) {
+        super(`Group not found: ${groupCode}`, 'GROUP_NOT_FOUND');
+        this.name = 'GroupNotFoundError';
+    }
+}
+exports.GroupNotFoundError = GroupNotFoundError;
+/**
+ * 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.
+ */
+class TenantGrantPermissionDeniedError extends MessageError {
+    constructor(message, code) {
+        super(message, code ?? 'PERMISSION_DENIED');
+        this.name = 'TenantGrantPermissionDeniedError';
+        // Parse missing permissions from message if it follows the standard format
+        const match = message.match(/permissions: (.+)/);
+        this.missingPermissions = match ? match[1].split(', ') : [];
+    }
+    /**
+     * Factory method to create error with permissions list
+     */
+    static withPermissions(permissions) {
+        return new TenantGrantPermissionDeniedError(`Application is missing required IAM-data permissions: ${permissions.join(', ')}. ` +
+            `Assign a role with these permissions to the application.`);
+    }
+}
+exports.TenantGrantPermissionDeniedError = TenantGrantPermissionDeniedError;
+// ============================================================================
+// Type Guards
+// ============================================================================
+/**
+ * Type guard to check if an error is a MessageError
+ */
+function isMessageError(error) {
+    return error instanceof MessageError;
+}
+/**
+ * Type guard to check if an error is a specific MessageError type
+ */
+function isMessageErrorType(error, 
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+errorClass) {
+    return error instanceof errorClass;
+}
+//# sourceMappingURL=messages-errors.js.map

package/dist/messages-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages-errors.js","sourceRoot":"","sources":["../src/messages-errors.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;;;AA+EH,wCAEC;AAKD,gDAMC;AA1FD,+EAA+E;AAC/E,qBAAqB;AACrB,+EAA+E;AAE/E;;GAEG;AACH,MAAa,YAAa,SAAQ,KAAK;IAGrC,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,IAAI,IAAI,eAAe,CAAC;IACtC,CAAC;CACF;AARD,oCAQC;AAED,+EAA+E;AAC/E,0BAA0B;AAC1B,+EAA+E;AAE/E;;GAEG;AACH,MAAa,sBAAuB,SAAQ,YAAY;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,EAAE,kBAAkB,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;IACvC,CAAC;CACF;AALD,wDAKC;AAED;;GAEG;AACH,MAAa,kBAAmB,SAAQ,YAAY;IAClD,YAAY,SAAiB;QAC3B,KAAK,CAAC,oBAAoB,SAAS,EAAE,EAAE,iBAAiB,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IACnC,CAAC;CACF;AALD,gDAKC;AAED;;;;;;GAMG;AACH,MAAa,gCAAiC,SAAQ,YAAY;IAGhE,YAAY,OAAe,EAAE,IAAa;QACxC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,mBAAmB,CAAC,CAAC;QAC5C,IAAI,CAAC,IAAI,GAAG,kCAAkC,CAAC;QAC/C,2EAA2E;QAC3E,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACjD,IAAI,CAAC,kBAAkB,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC9D,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,WAAqB;QAC1C,OAAO,IAAI,gCAAgC,CACzC,yDAAyD,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACjF,0DAA0D,CAC7D,CAAC;IACJ,CAAC;CACF;AApBD,4EAoBC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;GAEG;AACH,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO,KAAK,YAAY,YAAY,CAAC;AACvC,CAAC;AAED;;GAEG;AACH,SAAgB,kBAAkB,CAChC,KAAc;AACd,8DAA8D;AAC9D,UAAqC;IAErC,OAAO,KAAK,YAAY,UAAU,CAAC;AACrC,CAAC"}

package/dist/messages.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Ketrics SDK - Messages Interfaces and Types
+ *
+ * Provides type definitions for the Messages SDK that allows
+ * tenant applications to send messages to users.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Send single message
+ * const result = await ketrics.Messages.send({
+ *   userId: 'user-123',
+ *   type: 'ORDER_SHIPPED',
+ *   subject: 'Your order has shipped!',
+ *   body: 'Track your package...',
+ *   priority: 'HIGH'
+ * });
+ *
+ * // Send to multiple users
+ * const bulk = await ketrics.Messages.sendBulk({
+ *   userIds: ['user-1', 'user-2'],
+ *   type: 'ANNOUNCEMENT',
+ *   subject: 'Important update',
+ *   body: '...'
+ * });
+ *
+ * // Send to a group (requires IAM-data permissions via application role)
+ * const group = await ketrics.Messages.sendToGroup({
+ *   groupCode: 'engineering-team',
+ *   type: 'TEAM_UPDATE',
+ *   subject: 'Sprint planning tomorrow',
+ *   body: '...'
+ * });
+ * ```
+ *
+ * Key Distinction:
+ * - Messages: Content sent by apps to users, stored in their inbox
+ * - Notifications: Alerts (push) that tell users about new messages
+ */
+/**
+ * Message priority level
+ */
+export type MessagePriorityLevel = 'LOW' | 'MEDIUM' | 'HIGH';
+/**
+ * Channel configuration for message delivery
+ */
+export interface MessageChannelConfig {
+    /** Store in user's inbox (always enabled) */
+    inbox: boolean;
+    /** Send push notification alert */
+    push: boolean;
+}
+/**
+ * Parameters for Messages.send()
+ */
+export interface SendMessageParams {
+    /** Recipient user ID */
+    userId: string;
+    /** Application-defined message type */
+    type: string;
+    /** Message subject/title (max 200 chars) */
+    subject: string;
+    /** Message body (max 10,000 chars, markdown supported) */
+    body: string;
+    /** Priority level (default: MEDIUM) */
+    priority?: MessagePriorityLevel;
+    /** Optional channel overrides */
+    channels?: Partial<MessageChannelConfig>;
+    /** Optional action URL for deep linking */
+    actionUrl?: string;
+    /** Optional custom data for app use */
+    data?: Record<string, unknown>;
+    /** Optional expiration timestamp (ISO) */
+    expiresAt?: string;
+}
+/**
+ * Parameters for Messages.sendBulk()
+ */
+export interface SendBulkMessageParams {
+    /** Array of user IDs to message */
+    userIds: string[];
+    /** Message content (same for all recipients) */
+    type: string;
+    subject: string;
+    body: string;
+    priority?: MessagePriorityLevel;
+    channels?: Partial<MessageChannelConfig>;
+    actionUrl?: string;
+    data?: Record<string, unknown>;
+    expiresAt?: string;
+}
+/**
+ * Parameters for Messages.sendToGroup()
+ */
+export interface SendGroupMessageParams {
+    /** Group code to send message to */
+    groupCode: string;
+    /** Message content (same for all group members) */
+    type: string;
+    subject: string;
+    body: string;
+    priority?: MessagePriorityLevel;
+    channels?: Partial<MessageChannelConfig>;
+    actionUrl?: string;
+    data?: Record<string, unknown>;
+    expiresAt?: string;
+}
+/**
+ * Result of sending a single message
+ */
+export interface SendMessageResult {
+    messageId: string;
+    userId: string;
+    status: 'sent' | 'failed';
+    error?: string;
+}
+/**
+ * Result of sending bulk messages
+ */
+export interface SendBulkMessageResult {
+    total: number;
+    sent: number;
+    failed: number;
+    results: SendMessageResult[];
+}
+/**
+ * Messages SDK module interface
+ *
+ * Provides methods for sending messages to users in tenant applications.
+ */
+export interface MessagesManager {
+    /**
+     * Send message to a single user
+     * No TenantGrant required (userId is explicit)
+     *
+     * @param params - Message parameters
+     * @returns Result with messageId and status
+     * @throws MessageValidationError if parameters are invalid
+     */
+    send(params: SendMessageParams): Promise<SendMessageResult>;
+    /**
+     * Send message to multiple users
+     * No TenantGrant required (userIds are explicit)
+     *
+     * @param params - Bulk message parameters
+     * @returns Results with counts and individual statuses
+     * @throws MessageValidationError if parameters are invalid
+     */
+    sendBulk(params: SendBulkMessageParams): Promise<SendBulkMessageResult>;
+    /**
+     * Send message to all members of a group
+     *
+     * Requires IAM-data permissions: iam:GetGroupData + iam:GetMembershipData
+     * These permissions must be assigned to the application via its role.
+     *
+     * @param params - Group message parameters
+     * @returns Results with counts and individual statuses
+     * @throws MessageValidationError if parameters are invalid
+     * @throws GroupNotFoundError if group doesn't exist
+     * @throws TenantGrantPermissionDeniedError if IAM-data permissions are missing
+     */
+    sendToGroup(params: SendGroupMessageParams): Promise<SendBulkMessageResult>;
+}
+//# sourceMappingURL=messages.d.ts.map

package/dist/messages.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"messages.d.ts","sourceRoot":"","sources":["../src/messages.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqCG;AAMH;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,CAAC;AAM7D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6CAA6C;IAC7C,KAAK,EAAE,OAAO,CAAC;IACf,mCAAmC;IACnC,IAAI,EAAE,OAAO,CAAC;CACf;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,wBAAwB;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,4CAA4C;IAC5C,OAAO,EAAE,MAAM,CAAC;IAChB,0DAA0D;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,uCAAuC;IACvC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,iCAAiC;IACjC,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzC,2CAA2C;IAC3C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,0CAA0C;IAC1C,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,mCAAmC;IACnC,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,gDAAgD;IAChD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,mDAAmD;IACnD,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAChC,QAAQ,CAAC,EAAE,OAAO,CAAC,oBAAoB,CAAC,CAAC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAMD;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,GAAG,QAAQ,CAAC;IAC1B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;GAEG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,iBAAiB,EAAE,CAAC;CAC9B;AAMD;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;;;;OAOG;IACH,IAAI,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAAC;IAE5D;;;;;;;OAOG;IACH,QAAQ,CAAC,MAAM,EAAE,qBAAqB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;IAExE;;;;;;;;;;;OAWG;IACH,WAAW,CAAC,MAAM,EAAE,sBAAsB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;CAC7E"}

package/dist/messages.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * Ketrics SDK - Messages Interfaces and Types
+ *
+ * Provides type definitions for the Messages SDK that allows
+ * tenant applications to send messages to users.
+ *
+ * Usage in tenant code:
+ * ```typescript
+ * // Send single message
+ * const result = await ketrics.Messages.send({
+ *   userId: 'user-123',
+ *   type: 'ORDER_SHIPPED',
+ *   subject: 'Your order has shipped!',
+ *   body: 'Track your package...',
+ *   priority: 'HIGH'
+ * });
+ *
+ * // Send to multiple users
+ * const bulk = await ketrics.Messages.sendBulk({
+ *   userIds: ['user-1', 'user-2'],
+ *   type: 'ANNOUNCEMENT',
+ *   subject: 'Important update',
+ *   body: '...'
+ * });
+ *
+ * // Send to a group (requires IAM-data permissions via application role)
+ * const group = await ketrics.Messages.sendToGroup({
+ *   groupCode: 'engineering-team',
+ *   type: 'TEAM_UPDATE',
+ *   subject: 'Sprint planning tomorrow',
+ *   body: '...'
+ * });
+ * ```
+ *
+ * Key Distinction:
+ * - Messages: Content sent by apps to users, stored in their inbox
+ * - Notifications: Alerts (push) that tell users about new messages
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=messages.js.map

package/dist/messages.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ketrics/sdk-backend",
-  "version": "0.4.0",
+  "version": "0.7.0",
   "description": "Ketrics SDK for backend tenant application code (VM sandbox)",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -32,9 +32,9 @@
     "typescript": "^5.0.0"
   },
   "peerDependencies": {
-    "@types/node": ">=18.0.0"
+    "@types/node": ">=24.0.0"
   },
   "engines": {
-    "node": ">=18.0.0"
+    "node": ">=24.0.0"
   }
 }