@novu/framework 2.0.2 → 2.1.0

package/dist/{handler-xDdUZXcL.d.ts → handler-8vDLpUDh.d.ts}

@@ -1,4 +1,4 @@
-import { ChannelTypeEnum, TriggerEventStatusEnum, ITriggerPayload, TriggerRecipientSubscriber, TriggerRecipientsPayload } from '@novu/shared';
+import { TriggerEventStatusEnum, ITriggerPayload, TriggerRecipientSubscriber, TriggerRecipientsPayload, WorkflowPreferencesPartial } from '@novu/shared';
 import { JSONSchema, FromSchema as FromSchema$1 } from 'json-schema-to-ts';
 import zod from 'zod';
 
@@ -55,6 +55,19 @@ declare enum ActionStepEnum {
     CUSTOM = "custom"
 }
 
+/**
+ * A developer-friendly variant of ChannelTypeEnum, utilizing camelCase instead of snake_case
+ * to use consistent casing throughout the Framework.
+ */
+declare enum WorkflowChannelEnum {
+    EMAIL = "email",
+    SMS = "sms",
+    PUSH = "push",
+    CHAT = "chat",
+    /** Differs from ChannelTypeEnum in capitalization / snake_case */
+    IN_APP = "inApp"
+}
+
 type JsonSchema = JSONSchema;
 /**
  * A schema used to validate a JSON object.
@@ -4049,6 +4062,12 @@ type PickRequiredKeys<T, DEEP extends boolean = true> = keyof PickRequired<T, DE
  * Optionally, recurses through nested objects if `DEEP` is true.
  */
 type PickOptionalKeys<T, DEEP extends boolean = true> = keyof PickOptional<T, DEEP>;
+/**
+ * Recursively make all properties of type `T` optional.
+ */
+type DeepPartial<T> = T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;
 
 type Passthrough = {
     body?: Record<string, unknown>;
@@ -4256,15 +4275,15 @@ type DigestResult = FromSchema<(typeof actionStepSchemas)[ActionStepEnum.DIGEST]
  */
 type Step = {
     /** Send an email. */
-    email: ChannelStep<ChannelStepEnum.EMAIL, EmailOutputUnvalidated, EmailResult>;
+    [WorkflowChannelEnum.EMAIL]: ChannelStep<ChannelStepEnum.EMAIL, EmailOutputUnvalidated, EmailResult>;
     /** Send an SMS. */
-    sms: ChannelStep<ChannelStepEnum.SMS, SmsOutputUnvalidated, SmsResult>;
+    [WorkflowChannelEnum.SMS]: ChannelStep<ChannelStepEnum.SMS, SmsOutputUnvalidated, SmsResult>;
     /** Send a push notification. */
-    push: ChannelStep<ChannelStepEnum.PUSH, PushOutputUnvalidated, PushResult>;
+    [WorkflowChannelEnum.PUSH]: ChannelStep<ChannelStepEnum.PUSH, PushOutputUnvalidated, PushResult>;
     /** Send a chat message. */
-    chat: ChannelStep<ChannelStepEnum.CHAT, ChatOutputUnvalidated, ChatResult>;
+    [WorkflowChannelEnum.CHAT]: ChannelStep<ChannelStepEnum.CHAT, ChatOutputUnvalidated, ChatResult>;
     /** Send an in-app notification. */
-    inApp: ChannelStep<ChannelStepEnum.IN_APP, InAppOutputUnvalidated, InAppResult>;
+    [WorkflowChannelEnum.IN_APP]: ChannelStep<ChannelStepEnum.IN_APP, InAppOutputUnvalidated, InAppResult>;
     /** Aggregate events for a period of time. */
     digest: ActionStep<DigestOutputUnvalidated, DigestResult>;
     /** Delay the workflow for a period of time. */
@@ -4308,16 +4327,42 @@ type ExecuteInput<T_Payload extends Record<string, unknown>, T_Controls extends
  * The function to execute the workflow.
  */
 type Execute<T_Payload extends Record<string, unknown>, T_Controls extends Record<string, unknown>> = (event: ExecuteInput<T_Payload, T_Controls>) => Promise<void>;
-type WorkflowOptionChannelPreference = {
-    defaultValue?: boolean;
-    readOnly?: boolean;
-};
-type WorkflowOptionsPreferences = {
-    workflow?: WorkflowOptionChannelPreference;
-    channels?: {
-        [key in (typeof ChannelTypeEnum)[keyof typeof ChannelTypeEnum]]?: WorkflowOptionChannelPreference;
-    };
+/** A preference for a notification delivery channel. */
+type ChannelPreference = {
+    /**
+     * A flag specifying if notification delivery is enabled for the channel.
+     *
+     * If `true`, notification delivery is enabled.
+     *
+     * @default true
+     */
+    enabled: boolean;
+    /**
+     * A flag specifying if the preference is read-only.
+     *
+     * If `true`, the preference cannot be changed by the Subscriber.
+     *
+     * @default false
+     */
+    readOnly: boolean;
 };
+/**
+ * A partial set of workflow preferences.
+ */
+type WorkflowPreferences = DeepPartial<{
+    /**
+     * A preference for the workflow.
+     *
+     * The values specified here will be used if no preference is specified for a channel.
+     */
+    workflow: ChannelPreference;
+    /**
+     * A preference for each notification delivery channel.
+     *
+     * If no preference is specified for a channel, the `workflow` preference will be used.
+     */
+    channels: Record<WorkflowChannelEnum, ChannelPreference>;
+}>;
 /**
  * The options for the workflow.
  */
@@ -4330,8 +4375,63 @@ type WorkflowOptions<T_PayloadSchema extends Schema, T_ControlSchema extends Sch
      * @deprecated Use `controlSchema` instead
      */
     inputSchema?: T_ControlSchema;
+    /** The schema for the controls. */
     controlSchema?: T_ControlSchema;
-    preferences?: WorkflowOptionsPreferences;
+    /**
+     * The preferences for the notification workflow.
+     *
+     * If no preference is specified for a channel, the `workflow` preference will be used.
+     *
+     * @example
+     * ```ts
+     * // Enable notification delivery for only the in-app channel by default.
+     * {
+     *   workflow: { enabled: false },
+     *   channels: {
+     *     inApp: { enabled: true },
+     *   },
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * // Enable notification delivery for all channels by default.
+     * {
+     *   workflow: { enabled: true }
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * // Enable notification delivery for all channels by default,
+     * // disallowing the Subscriber to change the preference.
+     * {
+     *   workflow: { enabled: true, readOnly: true },
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * // Disable notification delivery for all channels by default,
+     * // allowing the Subscriber to change the preference.
+     * {
+     *   workflow: { enabled: false, readOnly: false },
+     * }
+     * ```
+     *
+     * @example
+     * ```ts
+     * // Disable notification delivery for only the in-app channel by default,
+     * // allowing the Subscriber to change the preference.
+     * {
+     *   channels: {
+     *     inApp: { enabled: false, readOnly: false },
+     *   },
+     * }
+     * ```
+     */
+    preferences?: WorkflowPreferences;
+    /** The tags for the workflow. */
     tags?: string[];
 };
 
@@ -4449,16 +4549,6 @@ type DiscoverStepOutput = {
     providers: Array<DiscoverProviderOutput>;
     options: StepOptions;
 };
-type ChannelPreference = {
-    defaultValue: boolean;
-    readOnly: boolean;
-};
-type DiscoverWorkflowOutputPreferences = {
-    workflow: ChannelPreference;
-    channels: {
-        [key in (typeof ChannelTypeEnum)[keyof typeof ChannelTypeEnum]]: ChannelPreference;
-    };
-};
 type DiscoverWorkflowOutput = {
     workflowId: string;
     execute: Execute<Record<string, unknown>, Record<string, unknown>>;
@@ -4483,7 +4573,7 @@ type DiscoverWorkflowOutput = {
         schema: JsonSchema;
         unknownSchema: Schema;
     };
-    preferences: DiscoverWorkflowOutputPreferences;
+    preferences: WorkflowPreferencesPartial;
     tags: string[];
 };
 type Workflow<T_Payload = any> = {
@@ -4644,4 +4734,4 @@ declare class NovuRequestHandler<Input extends any[] = any[], Output = any> {
     private hashHmac;
 }
 
-export { type ChatResult as $, ActionStepEnum as A, type StepOutput as B, Client as C, type DiscoverProviderOutput as D, type Execute as E, type FromSchemaUnvalidated as F, GetActionEnum as G, type HealthCheck as H, type ActionStep as I, type JsonSchema as J, type CustomStep as K, type ChannelStep as L, type EmailOutput as M, NovuRequestHandler as N, type EmailOutputUnvalidated as O, PostActionEnum as P, type EmailResult as Q, type SmsOutput as R, type Schema as S, type SmsOutputUnvalidated as T, type SmsResult as U, type PushOutput as V, type WorkflowOptions as W, type PushOutputUnvalidated as X, type PushResult as Y, type ChatOutput as Z, type ChatOutputUnvalidated as _, type FromSchema as a, type InAppOutput as a0, type InAppOutputUnvalidated as a1, type InAppResult as a2, type DelayOutput as a3, type DelayOutputUnvalidated as a4, type DelayResult as a5, type DigestRegularOutput as a6, type DigestRegularOutputUnvalidated as a7, type DigestTimedOutput as a8, type DigestTimedOutputUnvalidated as a9, type DigestOutput as aa, type DigestOutputUnvalidated as ab, type DigestResult as ac, type Step as ad, type Subscriber as ae, type Either as af, type Awaitable as ag, type Prettify as ah, type ConditionalPartial as ai, type Indexable as aj, type PickOptional as ak, type PickRequired as al, type PickRequiredKeys as am, type PickOptionalKeys as an, type ExecuteInput as ao, type WorkflowOptionChannelPreference as ap, type WorkflowOptionsPreferences as aq, type Workflow as b, type ServeHandlerOptions as c, ChannelStepEnum as d, type CodeResult as e, type ClientOptions as f, type StepType as g, type DiscoverStepOutput as h, type ChannelPreference as i, type DiscoverWorkflowOutputPreferences as j, type DiscoverWorkflowOutput as k, type DiscoverOutput as l, type EventTriggerResult as m, type EventTriggerParams as n, type EventTriggerResponse as o, type CancelEventTriggerResponse as p, type Event as q, type State as r, type ExecuteOutputMetadata as s, type ExecuteOutputOptions as t, type ExecuteOutput as u, type SupportedFrameworkName as v, type Skip as w, type StepOptions as x, JobStatusEnum as y, type StepContext as z };
+export { type InAppOutput as $, ActionStepEnum as A, type ActionStep as B, Client as C, type DiscoverProviderOutput as D, type Execute as E, type FromSchemaUnvalidated as F, GetActionEnum as G, type HealthCheck as H, type CustomStep as I, type JsonSchema as J, type ChannelStep as K, type EmailOutput as L, type EmailOutputUnvalidated as M, NovuRequestHandler as N, type EmailResult as O, PostActionEnum as P, type SmsOutput as Q, type SmsOutputUnvalidated as R, type Schema as S, type SmsResult as T, type PushOutput as U, type PushOutputUnvalidated as V, type WorkflowOptions as W, type PushResult as X, type ChatOutput as Y, type ChatOutputUnvalidated as Z, type ChatResult as _, type FromSchema as a, type InAppOutputUnvalidated as a0, type InAppResult as a1, type DelayOutput as a2, type DelayOutputUnvalidated as a3, type DelayResult as a4, type DigestRegularOutput as a5, type DigestRegularOutputUnvalidated as a6, type DigestTimedOutput as a7, type DigestTimedOutputUnvalidated as a8, type DigestOutput as a9, type DigestOutputUnvalidated as aa, type DigestResult as ab, type Step as ac, type Subscriber as ad, type Either as ae, type Awaitable as af, type Prettify as ag, type ConditionalPartial as ah, type Indexable as ai, type PickOptional as aj, type PickRequired as ak, type PickRequiredKeys as al, type PickOptionalKeys as am, type DeepPartial as an, type ExecuteInput as ao, type ChannelPreference as ap, type WorkflowPreferences as aq, type Workflow as b, type ServeHandlerOptions as c, ChannelStepEnum as d, WorkflowChannelEnum as e, type CodeResult as f, type ClientOptions as g, type StepType as h, type DiscoverStepOutput as i, type DiscoverWorkflowOutput as j, type DiscoverOutput as k, type EventTriggerResult as l, type EventTriggerParams as m, type EventTriggerResponse as n, type CancelEventTriggerResponse as o, type Event as p, type State as q, type ExecuteOutputMetadata as r, type ExecuteOutputOptions as s, type ExecuteOutput as t, type SupportedFrameworkName as u, type Skip as v, type StepOptions as w, JobStatusEnum as x, type StepContext as y, type StepOutput as z };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { S as Schema, F as FromSchemaUnvalidated, a as FromSchema, J as JsonSchema, E as Execute, W as WorkflowOptions, b as Workflow } from './handler-xDdUZXcL.js';
-export { I as ActionStep, A as ActionStepEnum, ag as Awaitable, p as CancelEventTriggerResponse, i as ChannelPreference, L as ChannelStep, d as ChannelStepEnum, Z as ChatOutput, _ as ChatOutputUnvalidated, $ as ChatResult, C as Client, f as ClientOptions, e as CodeResult, ai as ConditionalPartial, K as CustomStep, a3 as DelayOutput, a4 as DelayOutputUnvalidated, a5 as DelayResult, aa as DigestOutput, ab as DigestOutputUnvalidated, a6 as DigestRegularOutput, a7 as DigestRegularOutputUnvalidated, ac as DigestResult, a8 as DigestTimedOutput, a9 as DigestTimedOutputUnvalidated, l as DiscoverOutput, D as DiscoverProviderOutput, h as DiscoverStepOutput, k as DiscoverWorkflowOutput, j as DiscoverWorkflowOutputPreferences, af as Either, M as EmailOutput, O as EmailOutputUnvalidated, Q as EmailResult, q as Event, n as EventTriggerParams, o as EventTriggerResponse, m as EventTriggerResult, ao as ExecuteInput, u as ExecuteOutput, s as ExecuteOutputMetadata, t as ExecuteOutputOptions, G as GetActionEnum, H as HealthCheck, a0 as InAppOutput, a1 as InAppOutputUnvalidated, a2 as InAppResult, aj as Indexable, y as JobStatusEnum, N as NovuRequestHandler, ak as PickOptional, an as PickOptionalKeys, al as PickRequired, am as PickRequiredKeys, P as PostActionEnum, ah as Prettify, V as PushOutput, X as PushOutputUnvalidated, Y as PushResult, c as ServeHandlerOptions, w as Skip, R as SmsOutput, T as SmsOutputUnvalidated, U as SmsResult, r as State, ad as Step, z as StepContext, x as StepOptions, B as StepOutput, g as StepType, ae as Subscriber, v as SupportedFrameworkName, ap as WorkflowOptionChannelPreference, aq as WorkflowOptionsPreferences } from './handler-xDdUZXcL.js';
+import { S as Schema, F as FromSchemaUnvalidated, a as FromSchema, J as JsonSchema, E as Execute, W as WorkflowOptions, b as Workflow } from './handler-8vDLpUDh.js';
+export { B as ActionStep, A as ActionStepEnum, af as Awaitable, o as CancelEventTriggerResponse, ap as ChannelPreference, K as ChannelStep, d as ChannelStepEnum, Y as ChatOutput, Z as ChatOutputUnvalidated, _ as ChatResult, C as Client, g as ClientOptions, f as CodeResult, ah as ConditionalPartial, I as CustomStep, an as DeepPartial, a2 as DelayOutput, a3 as DelayOutputUnvalidated, a4 as DelayResult, a9 as DigestOutput, aa as DigestOutputUnvalidated, a5 as DigestRegularOutput, a6 as DigestRegularOutputUnvalidated, ab as DigestResult, a7 as DigestTimedOutput, a8 as DigestTimedOutputUnvalidated, k as DiscoverOutput, D as DiscoverProviderOutput, i as DiscoverStepOutput, j as DiscoverWorkflowOutput, ae as Either, L as EmailOutput, M as EmailOutputUnvalidated, O as EmailResult, p as Event, m as EventTriggerParams, n as EventTriggerResponse, l as EventTriggerResult, ao as ExecuteInput, t as ExecuteOutput, r as ExecuteOutputMetadata, s as ExecuteOutputOptions, G as GetActionEnum, H as HealthCheck, $ as InAppOutput, a0 as InAppOutputUnvalidated, a1 as InAppResult, ai as Indexable, x as JobStatusEnum, N as NovuRequestHandler, aj as PickOptional, am as PickOptionalKeys, ak as PickRequired, al as PickRequiredKeys, P as PostActionEnum, ag as Prettify, U as PushOutput, V as PushOutputUnvalidated, X as PushResult, c as ServeHandlerOptions, v as Skip, Q as SmsOutput, R as SmsOutputUnvalidated, T as SmsResult, q as State, ac as Step, y as StepContext, w as StepOptions, z as StepOutput, h as StepType, ad as Subscriber, u as SupportedFrameworkName, e as WorkflowChannelEnum, aq as WorkflowPreferences } from './handler-8vDLpUDh.js';
 import { ValidateFunction as ValidateFunction$1 } from 'ajv';
 import { ParseReturnType } from 'zod';
 import '@novu/shared';