@deliverart/sdk-js-email-notification-configuration

Email notification configuration management package for the DeliverArt JavaScript SDK.

Installation

npm install @deliverart/sdk-js-email-notification-configuration @deliverart/sdk-js-core

Exported Types

Core Types

• EmailNotificationConfiguration - Email notification configuration with all details
• EmailNotificationConfigurationListItem - Email notification configuration list item
• EmailNotificationConfigurationConfig - Configuration object containing notification settings
• WritableEmailNotificationConfiguration - Writable email notification configuration
• WritableCreateEmailNotificationConfiguration - Writable create email notification configuration

Template Keys

Available email template keys:

• delivery_started - Notification when delivery starts
• delivery_taken_over - Notification when delivery is taken over
• order_created - Notification when order is created
• order_delivered - Notification when order is delivered
• order_in_preparation - Notification when order enters preparation
• order_preparation_done - Notification when order preparation is complete

Order Sources

Configuration supports the following order sources:

• application - Orders from mobile/web application
• ecommerce - Orders from ecommerce platform
• partner - Orders from partner integrations

IRI Types

• EmailNotificationConfigurationIri - Email notification configuration IRI (/email_notification_configurations/:id)

Configuration Structure

Each email notification configuration contains a config object with template-specific settings. The configuration structure is designed to be extensible for future template-specific fields.

Config Object

{
  sourcesEnabled: string[] // Array of enabled order sources
}

Fields:

• sourcesEnabled?: string[] - Array of order sources for which the notification should be sent

Available Requests

CreateEmailNotificationConfiguration

import { CreateEmailNotificationConfiguration } from '@deliverart/sdk-js-email-notification-configuration';

const config = await sdk.call(new CreateEmailNotificationConfiguration({
  pointOfSale: '/point_of_sales/123',
  templateKey: 'order_preparation_done',
  isActive: true,
  config: {
    sourcesEnabled: ['application']
  }
}));

Input Parameters:

• pointOfSale: string (required) - Point of sale IRI
• templateKey: string (required) - Email template key
• isActive: boolean (required) - Enable/disable notification
• config: object (required) - Configuration object with sourcesEnabled

GetEmailNotificationConfigurations

import { GetEmailNotificationConfigurations } from '@deliverart/sdk-js-email-notification-configuration';

const configs = await sdk.call(new GetEmailNotificationConfigurations({
  query: {
    templateKey: 'order_created',
    page: 1
  }
}));

Query Parameters:

• id?: string | string[] - Filter by configuration ID
• templateKey?: string | string[] - Filter by template key
• order[createdAt]?: string - Sort by creation date
• order[updatedAt]?: string - Sort by update date
• page?: number - Page number
• createdAtFrom?: string - Filter by creation date (from)
• createdAtTo?: string - Filter by creation date (to)
• updatedAtFrom?: string - Filter by update date (from)
• updatedAtTo?: string - Filter by update date (to)

GetEmailNotificationConfigurationDetails

import { GetEmailNotificationConfigurationDetails } from '@deliverart/sdk-js-email-notification-configuration';

const config = await sdk.call(new GetEmailNotificationConfigurationDetails('config-123'));

UpdateEmailNotificationConfiguration

import { UpdateEmailNotificationConfiguration } from '@deliverart/sdk-js-email-notification-configuration';

const updated = await sdk.call(new UpdateEmailNotificationConfiguration('config-123', {
  templateKey: 'order_preparation_done',
  isActive: false,
  config: {
    sourcesEnabled: ['application', 'ecommerce']
  }
}));

Input Parameters:

• templateKey: string (required) - Email template key
• isActive: boolean (required) - Enable/disable notification
• config: object (required) - Configuration object
  • sourcesEnabled: string[] - Array of enabled order sources

DeleteEmailNotificationConfiguration

import { DeleteEmailNotificationConfiguration } from '@deliverart/sdk-js-email-notification-configuration';

await sdk.call(new DeleteEmailNotificationConfiguration('config-123'));

License

This package is part of the DeliverArt JavaScript SDK.