@novu/framework 2.10.1-alpha.7 → 2.11.1

package/dist/cjs/{health-check.types-S8oS3AQZ.d.cts → health-check.types-D4NEyjyC.d.cts}

@@ -1,4 +1,4 @@
-import { b as ContextPayload, c as ConditionalPartial, P as PickRequiredKeys, d as Step, e as Prettify, S as Subscriber, E as EnvironmentSystemVariables, C as ContextResolved, D as DeepPartial$1, f as ChannelStepEnum, A as ActionStepEnum, g as Awaitable, W as WithPassthrough, h as StepOptions } from './subscriber.types-DgRgSKMw.cjs';
+import { b as ContextPayload, c as ConditionalPartial, P as PickRequiredKeys, d as Step, e as Prettify, S as Subscriber, E as EnvironmentSystemVariables, C as ContextResolved, D as DeepPartial$1, f as ChannelStepEnum, A as ActionStepEnum, g as Awaitable, W as WithPassthrough, h as StepOptions } from './subscriber.types-PRaHFLJu.cjs';
 import { S as Schema, J as JsonSchema } from './base.schema.types-BApIn9jr.cjs';
 
 declare enum ChannelTypeEnum {
@@ -66,7 +66,8 @@ declare enum ChatProviderIdEnum {
     GetStream = "getstream",
     RocketChat = "rocket-chat",
     WhatsAppBusiness = "whatsapp-business",
-    ChatWebhook = "chat-webhook"
+    ChatWebhook = "chat-webhook",
+    Telegram = "telegram"
 }
 declare enum PushProviderIdEnum {
     FCM = "fcm",
@@ -141,6 +142,21 @@ type CodeResult = {
     code: string;
 };
 
+/**
+ * A minimal logger interface used for all of the framework's internal logging
+ * (workflow discovery, execution and bridge error reporting).
+ *
+ * The methods (`info`/`warn`/`error`) are chosen so that both the global
+ * `console` and common structured loggers (pino, winston, ...) satisfy this
+ * interface directly, with no adapter. The global `console` is the default;
+ * provide your own to route Novu's internal logs wherever the rest of your
+ * application logs go.
+ */
+type Logger = {
+    info: typeof console.info;
+    warn: typeof console.warn;
+    error: typeof console.error;
+};
 type ClientOptions = {
     /**
      * Use Novu Cloud US (https://api.novu.co) or EU deployment (https://eu.api.novu.co). Defaults to US.
@@ -170,6 +186,19 @@ type ClientOptions = {
      * Defaults to `true` in development, `false` in production.
      */
     verbose?: boolean;
+    /**
+     * A custom logger used for all of the framework's internal logging
+     * (workflow discovery, execution and bridge error reporting).
+     *
+     * Defaults to the global `console`. Provide your own logger to route Novu's
+     * internal logs through your application's structured logger.
+     *
+     * Note: `verbose` still controls *whether* discovery and execution logs are
+     * emitted; `logger` only controls *where* all logs are written. Bridge errors
+     * (HTTP status >= 500) are always logged via this logger, regardless of
+     * `verbose`.
+     */
+    logger?: Logger;
 };
 
 declare enum PostActionEnum {
@@ -699,4 +728,4 @@ type HealthCheck = {
     };
 };
 
-export { type ClientOptions as C, type DiscoverAgentOutput as D, type ExecuteInput as E, GetActionEnum as G, type HealthCheck as H, PostActionEnum as P, SeverityLevelEnum as S, type TriggerRecipientsPayload as T, type Workflow as W, CronExpression as a, type CancelEventTriggerResponse as b, type ChannelPreference as c, type CodeResult as d, type DiscoverOutput as e, type DiscoverProviderOutput as f, type DiscoverStepOutput as g, type DiscoverWorkflowOutput as h, type Event as i, type EventTriggerParams as j, type EventTriggerResponse as k, type EventTriggerResult as l, type Execute as m, type ExecuteOutput as n, type ExecuteOutputMetadata as o, type ExecuteOutputOptions as p, type State as q, type StepType as r, WorkflowChannelEnum as s, type WorkflowOptions as t, type WorkflowPreference as u, type WorkflowPreferences as v };
+export { type ClientOptions as C, type DiscoverAgentOutput as D, type ExecuteInput as E, GetActionEnum as G, type HealthCheck as H, type Logger as L, PostActionEnum as P, SeverityLevelEnum as S, type TriggerRecipientsPayload as T, type Workflow as W, CronExpression as a, type CancelEventTriggerResponse as b, type ChannelPreference as c, type CodeResult as d, type DiscoverOutput as e, type DiscoverProviderOutput as f, type DiscoverStepOutput as g, type DiscoverWorkflowOutput as h, type Event as i, type EventTriggerParams as j, type EventTriggerResponse as k, type EventTriggerResult as l, type Execute as m, type ExecuteOutput as n, type ExecuteOutputMetadata as o, type ExecuteOutputOptions as p, type State as q, type StepType as r, WorkflowChannelEnum as s, type WorkflowOptions as t, type WorkflowPreference as u, type WorkflowPreferences as v };

package/dist/cjs/{index-DtCBrkhW.d.cts → index-BNiIiOE-.d.cts}

@@ -1,6 +1,6 @@
 import { ChatElement, Emoji, CardElement } from 'chat';
-import { T as TriggerRecipientsPayload, C as ClientOptions, W as Workflow, H as HealthCheck, e as DiscoverOutput, i as Event, n as ExecuteOutput, d as CodeResult, j as EventTriggerParams, m as Execute, t as WorkflowOptions } from './health-check.types-S8oS3AQZ.cjs';
-import { g as Awaitable } from './subscriber.types-DgRgSKMw.cjs';
+import { T as TriggerRecipientsPayload, L as Logger, C as ClientOptions, W as Workflow, H as HealthCheck, e as DiscoverOutput, i as Event, n as ExecuteOutput, d as CodeResult, j as EventTriggerParams, m as Execute, t as WorkflowOptions } from './health-check.types-D4NEyjyC.cjs';
+import { g as Awaitable } from './subscriber.types-PRaHFLJu.cjs';
 import { S as Schema, a as FromSchema, F as FromSchemaUnvalidated } from './base.schema.types-BApIn9jr.cjs';
 import './step-resolver.cjs';
 
@@ -85,6 +85,27 @@ interface AgentHistoryEntry {
     };
     createdAt: string;
 }
+/** Resolved inbound email domain metadata (present when `platform === 'email'`). */
+interface AgentEmailDomainContext {
+    id: string;
+    name: string;
+    data?: Record<string, string>;
+}
+/** Resolved inbound email route metadata (present when `platform === 'email'`). */
+interface AgentEmailRouteContext {
+    address: string;
+    data?: Record<string, string>;
+}
+/** Resolved inbound email envelope (present when `platform === 'email'`). */
+interface AgentEmailContext {
+    domain?: AgentEmailDomainContext;
+    route?: AgentEmailRouteContext;
+    /**
+     * Platform-native Message-ID of the message that started this email thread.
+     * Equals the current message ID on the first message of a thread.
+     */
+    rootMessageId?: string;
+}
 /** Platform-specific identifiers for the thread and channel. */
 interface AgentPlatformContext {
     /** Platform-native thread ID (e.g. Slack thread `ts`, Teams conversation ID). */
@@ -93,6 +114,10 @@ interface AgentPlatformContext {
     channelId: string;
     /** Whether the message arrived in a direct message rather than a shared channel. */
     isDM: boolean;
+    /** Platform-native raw message payload from the chat SDK adapter (e.g. email `NovuEmailRawMessage`). */
+    message?: unknown;
+    /** Resolved inbound email routing metadata extracted from the raw payload. */
+    email?: AgentEmailContext;
 }
 interface FileRef {
     filename: string;
@@ -118,6 +143,7 @@ interface FileRef {
  * - `ChatElement` — interactive card built with Card(), Button(), etc.
  *
  * For file attachments, pass a `files` array as the second argument to reply()/edit().
+ * Cards and files can be combined on platforms that support it (e.g. WhatsApp sends media then the card).
  */
 type MessageContent = string | ChatElement;
 /** Normalized content shape sent over HTTP to the reply endpoint. */
@@ -446,6 +472,7 @@ declare class Client {
     version: string;
     strictAuthentication: boolean;
     verbose: boolean;
+    logger: Logger;
     constructor(options?: ClientOptions);
     private buildOptions;
     private log;