@workbenchcrm/sdk 1.0.3 → 1.1.0

package/dist/index.d.mts

@@ -98,9 +98,13 @@ interface ApiError {
     meta: ResponseMeta;
 }
 /**
- * Client status values
+ * Client status values (lifecycle status)
  */
-type ClientStatus = 'active' | 'inactive' | 'lead' | 'prospect' | 'archived';
+type ClientStatus = 'active' | 'inactive' | 'archived';
+/**
+ * Lead status values (pipeline stage for leads)
+ */
+type LeadStatus = 'new' | 'contacted' | 'qualified' | 'proposal' | 'negotiation' | 'won' | 'lost';
 /**
  * Client record
  */
@@ -113,6 +117,8 @@ interface Client {
     email: string | null;
     phone: string | null;
     status: ClientStatus;
+    /** Lead pipeline stage */
+    lead_status: LeadStatus | null;
     source: string | null;
     notes: string | null;
     /** Internal notes visible only to business users */
@@ -132,7 +138,10 @@ interface CreateClientOptions {
     company?: string | null;
     email?: string | null;
     phone?: string | null;
+    /** Client lifecycle status (defaults to 'active') */
     status?: ClientStatus;
+    /** Lead pipeline stage (defaults to 'new') */
+    lead_status?: LeadStatus | null;
     source?: string | null;
     notes?: string | null;
     internal_notes?: string | null;
@@ -150,6 +159,7 @@ interface UpdateClientOptions extends Partial<CreateClientOptions> {
  */
 interface ListClientsOptions extends ListOptions {
     status?: ClientStatus;
+    lead_status?: LeadStatus;
 }
 /**
  * Invoice status values
@@ -519,6 +529,89 @@ interface WebhookEventTypeInfo {
     description: string;
     category: 'client' | 'invoice' | 'quote' | 'job' | 'service_request';
 }
+/**
+ * Notification type - who receives the notification
+ */
+type NotificationType = 'CLIENT' | 'BUSINESS';
+/**
+ * Notification events supported by the SDK
+ * - sdk_client_created: Welcome notification for new clients
+ * - sdk_request_created: New service request notification
+ * - sdk_quote_created: Quote sent notification
+ * - sdk_invoice_created: Invoice sent notification
+ * - sdk_job_created: Job scheduled notification
+ * - sdk_custom: Custom notification (requires subject/html overrides)
+ */
+type NotificationEvent = 'sdk_client_created' | 'sdk_request_created' | 'sdk_quote_created' | 'sdk_invoice_created' | 'sdk_job_created' | 'sdk_custom';
+/**
+ * Business user roles for BUSINESS notifications
+ */
+type BusinessUserRole = 'owner' | 'admin' | 'manager' | 'member';
+/**
+ * Base options for sending notifications
+ */
+interface SendNotificationBaseOptions {
+    /** Template data for variable interpolation (e.g., client_name, quote_total) */
+    templateData?: Record<string, string | number>;
+    /** Custom subject line (overrides template) */
+    subjectOverride?: string;
+    /** Custom HTML body (overrides template) */
+    htmlOverride?: string;
+    /** Entity type for audit logging (e.g., 'client', 'invoice') */
+    entityType?: string;
+    /** Entity ID for audit logging */
+    entityId?: string;
+}
+/**
+ * Options for sending a notification to a client
+ */
+interface SendToClientOptions extends SendNotificationBaseOptions {
+    /** Client ID to send the notification to */
+    clientId: string;
+    /** Event type for template selection */
+    event: NotificationEvent;
+}
+/**
+ * Options for sending a notification to business team members
+ */
+interface SendToTeamOptions extends SendNotificationBaseOptions {
+    /** Event type for template selection */
+    event: NotificationEvent;
+    /** Roles to notify (defaults to all if not specified) */
+    roles?: BusinessUserRole[];
+}
+/**
+ * Options for sending a custom notification
+ */
+interface SendCustomNotificationOptions extends SendNotificationBaseOptions {
+    /** Notification type - CLIENT or BUSINESS */
+    type: NotificationType;
+    /** Client ID (required for CLIENT type) */
+    clientId?: string;
+    /** Roles to notify (for BUSINESS type) */
+    roles?: BusinessUserRole[];
+    /** Required: Custom subject line */
+    subject: string;
+    /** Required: Custom HTML body */
+    html: string;
+}
+/**
+ * Result of sending notifications
+ */
+interface NotificationResult {
+    /** Whether at least one notification was sent successfully */
+    success: boolean;
+    /** Unique ID for this notification batch */
+    notification_id: string;
+    /** Total number of recipients */
+    recipients_count: number;
+    /** Number of successful email sends */
+    sent_count: number;
+    /** Number of failed email sends */
+    failed_count: number;
+    /** Error messages if any failures occurred */
+    errors?: string[];
+}
 
 /**
  * @file resources/clients.ts
@@ -1386,6 +1479,156 @@ declare class WebhooksResource {
     listEventTypes(): Promise<ApiResponse<WebhookEventTypeInfo[]>>;
 }
 
+/**
+ * Notifications Resource
+ *
+ * Provides methods for sending email notifications to clients and
+ * business team members via the Workbench API.
+ *
+ * @module resources/notifications
+ *
+ * @example
+ * // Send a welcome notification to a new client
+ * await workbench.notifications.sendToClient({
+ *   clientId: 'client-uuid',
+ *   event: 'sdk_client_created',
+ *   templateData: { client_name: 'John Doe' }
+ * });
+ *
+ * @example
+ * // Notify business admins about a new request
+ * await workbench.notifications.sendToTeam({
+ *   event: 'sdk_request_created',
+ *   roles: ['owner', 'admin'],
+ *   templateData: { request_title: 'AC Repair', client_name: 'John' }
+ * });
+ *
+ * @example
+ * // Send a custom notification
+ * await workbench.notifications.sendCustom({
+ *   type: 'CLIENT',
+ *   clientId: 'client-uuid',
+ *   subject: 'Your appointment is confirmed!',
+ *   html: '<h1>Confirmed!</h1><p>See you tomorrow at 10am.</p>'
+ * });
+ */
+
+/**
+ * Notifications resource for sending email notifications via the SDK
+ */
+declare class NotificationsResource {
+    private readonly client;
+    constructor(client: WorkbenchClient);
+    /**
+     * Send a notification to a specific client
+     *
+     * Sends an email notification to a client using a predefined template
+     * or custom content. The client must have a valid email address.
+     *
+     * @param options - Notification options
+     * @returns Notification result with delivery statistics
+     *
+     * @example
+     * // Welcome a new client
+     * const result = await workbench.notifications.sendToClient({
+     *   clientId: 'client-uuid',
+     *   event: 'sdk_client_created',
+     *   templateData: {
+     *     client_name: 'John Doe'
+     *   }
+     * });
+     * console.log(`Sent to ${result.data.sent_count} recipient(s)`);
+     *
+     * @example
+     * // Notify client about a new quote with custom subject
+     * const result = await workbench.notifications.sendToClient({
+     *   clientId: 'client-uuid',
+     *   event: 'sdk_quote_created',
+     *   templateData: {
+     *     client_name: 'John',
+     *     quote_number: 'Q-001',
+     *     quote_total: '$1,500.00'
+     *   },
+     *   subjectOverride: 'Your custom quote is ready!'
+     * });
+     */
+    sendToClient(options: SendToClientOptions): Promise<ApiResponse<NotificationResult>>;
+    /**
+     * Send a notification to business team members
+     *
+     * Sends an email notification to team members, optionally filtered
+     * by their role in the business.
+     *
+     * @param options - Notification options
+     * @returns Notification result with delivery statistics
+     *
+     * @example
+     * // Notify all team members about a new service request
+     * const result = await workbench.notifications.sendToTeam({
+     *   event: 'sdk_request_created',
+     *   templateData: {
+     *     request_title: 'Emergency AC Repair',
+     *     client_name: 'John Doe',
+     *     request_description: 'AC not cooling, needs urgent attention'
+     *   }
+     * });
+     *
+     * @example
+     * // Notify only owners and admins
+     * const result = await workbench.notifications.sendToTeam({
+     *   event: 'sdk_invoice_created',
+     *   roles: ['owner', 'admin'],
+     *   templateData: {
+     *     invoice_number: 'INV-001',
+     *     invoice_total: '$2,500.00',
+     *     client_name: 'Acme Corp'
+     *   }
+     * });
+     */
+    sendToTeam(options: SendToTeamOptions): Promise<ApiResponse<NotificationResult>>;
+    /**
+     * Send a custom notification
+     *
+     * Sends a notification with fully custom subject and HTML content.
+     * Can be sent to either a client or business team members.
+     *
+     * @param options - Custom notification options
+     * @returns Notification result with delivery statistics
+     *
+     * @example
+     * // Send custom appointment confirmation to client
+     * const result = await workbench.notifications.sendCustom({
+     *   type: 'CLIENT',
+     *   clientId: 'client-uuid',
+     *   subject: 'Your appointment is confirmed for tomorrow!',
+     *   html: `
+     *     <h1>Appointment Confirmed</h1>
+     *     <p>Hi John,</p>
+     *     <p>Your appointment has been confirmed:</p>
+     *     <ul>
+     *       <li><strong>Date:</strong> January 23, 2026</li>
+     *       <li><strong>Time:</strong> 10:00 AM</li>
+     *       <li><strong>Service:</strong> AC Maintenance</li>
+     *     </ul>
+     *     <p>See you tomorrow!</p>
+     *   `
+     * });
+     *
+     * @example
+     * // Send custom alert to admins
+     * const result = await workbench.notifications.sendCustom({
+     *   type: 'BUSINESS',
+     *   roles: ['owner', 'admin'],
+     *   subject: 'High-value quote approved!',
+     *   html: '<p>Quote Q-001 for $10,000 has been approved by Acme Corp.</p>',
+     *   templateData: {
+     *     quote_number: 'Q-001'
+     *   }
+     * });
+     */
+    sendCustom(options: SendCustomNotificationOptions): Promise<ApiResponse<NotificationResult>>;
+}
+
 /**
  * @file client.ts
  * @description Main Workbench API client class
@@ -1474,6 +1717,8 @@ declare class WorkbenchClient {
     readonly serviceRequests: ServiceRequestsResource;
     /** Webhooks resource */
     readonly webhooks: WebhooksResource;
+    /** Notifications resource */
+    readonly notifications: NotificationsResource;
     /**
      * Create a new Workbench client
      *
@@ -1655,4 +1900,4 @@ declare function constructWebhookEvent<T = Record<string, unknown>>(payload: str
     timestamp: string;
 };
 
-export { type ApiError, type ApiResponse, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, type ResponseMeta, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, ServiceRequestsResource, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };
+export { type ApiError, type ApiResponse, type BusinessUserRole, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type NotificationEvent, type NotificationResult, type NotificationType, NotificationsResource, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, type ResponseMeta, type SendCustomNotificationOptions, type SendToClientOptions, type SendToTeamOptions, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, ServiceRequestsResource, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };

package/dist/index.d.ts

@@ -98,9 +98,13 @@ interface ApiError {
     meta: ResponseMeta;
 }
 /**
- * Client status values
+ * Client status values (lifecycle status)
  */
-type ClientStatus = 'active' | 'inactive' | 'lead' | 'prospect' | 'archived';
+type ClientStatus = 'active' | 'inactive' | 'archived';
+/**
+ * Lead status values (pipeline stage for leads)
+ */
+type LeadStatus = 'new' | 'contacted' | 'qualified' | 'proposal' | 'negotiation' | 'won' | 'lost';
 /**
  * Client record
  */
@@ -113,6 +117,8 @@ interface Client {
     email: string | null;
     phone: string | null;
     status: ClientStatus;
+    /** Lead pipeline stage */
+    lead_status: LeadStatus | null;
     source: string | null;
     notes: string | null;
     /** Internal notes visible only to business users */
@@ -132,7 +138,10 @@ interface CreateClientOptions {
     company?: string | null;
     email?: string | null;
     phone?: string | null;
+    /** Client lifecycle status (defaults to 'active') */
     status?: ClientStatus;
+    /** Lead pipeline stage (defaults to 'new') */
+    lead_status?: LeadStatus | null;
     source?: string | null;
     notes?: string | null;
     internal_notes?: string | null;
@@ -150,6 +159,7 @@ interface UpdateClientOptions extends Partial<CreateClientOptions> {
  */
 interface ListClientsOptions extends ListOptions {
     status?: ClientStatus;
+    lead_status?: LeadStatus;
 }
 /**
  * Invoice status values
@@ -519,6 +529,89 @@ interface WebhookEventTypeInfo {
     description: string;
     category: 'client' | 'invoice' | 'quote' | 'job' | 'service_request';
 }
+/**
+ * Notification type - who receives the notification
+ */
+type NotificationType = 'CLIENT' | 'BUSINESS';
+/**
+ * Notification events supported by the SDK
+ * - sdk_client_created: Welcome notification for new clients
+ * - sdk_request_created: New service request notification
+ * - sdk_quote_created: Quote sent notification
+ * - sdk_invoice_created: Invoice sent notification
+ * - sdk_job_created: Job scheduled notification
+ * - sdk_custom: Custom notification (requires subject/html overrides)
+ */
+type NotificationEvent = 'sdk_client_created' | 'sdk_request_created' | 'sdk_quote_created' | 'sdk_invoice_created' | 'sdk_job_created' | 'sdk_custom';
+/**
+ * Business user roles for BUSINESS notifications
+ */
+type BusinessUserRole = 'owner' | 'admin' | 'manager' | 'member';
+/**
+ * Base options for sending notifications
+ */
+interface SendNotificationBaseOptions {
+    /** Template data for variable interpolation (e.g., client_name, quote_total) */
+    templateData?: Record<string, string | number>;
+    /** Custom subject line (overrides template) */
+    subjectOverride?: string;
+    /** Custom HTML body (overrides template) */
+    htmlOverride?: string;
+    /** Entity type for audit logging (e.g., 'client', 'invoice') */
+    entityType?: string;
+    /** Entity ID for audit logging */
+    entityId?: string;
+}
+/**
+ * Options for sending a notification to a client
+ */
+interface SendToClientOptions extends SendNotificationBaseOptions {
+    /** Client ID to send the notification to */
+    clientId: string;
+    /** Event type for template selection */
+    event: NotificationEvent;
+}
+/**
+ * Options for sending a notification to business team members
+ */
+interface SendToTeamOptions extends SendNotificationBaseOptions {
+    /** Event type for template selection */
+    event: NotificationEvent;
+    /** Roles to notify (defaults to all if not specified) */
+    roles?: BusinessUserRole[];
+}
+/**
+ * Options for sending a custom notification
+ */
+interface SendCustomNotificationOptions extends SendNotificationBaseOptions {
+    /** Notification type - CLIENT or BUSINESS */
+    type: NotificationType;
+    /** Client ID (required for CLIENT type) */
+    clientId?: string;
+    /** Roles to notify (for BUSINESS type) */
+    roles?: BusinessUserRole[];
+    /** Required: Custom subject line */
+    subject: string;
+    /** Required: Custom HTML body */
+    html: string;
+}
+/**
+ * Result of sending notifications
+ */
+interface NotificationResult {
+    /** Whether at least one notification was sent successfully */
+    success: boolean;
+    /** Unique ID for this notification batch */
+    notification_id: string;
+    /** Total number of recipients */
+    recipients_count: number;
+    /** Number of successful email sends */
+    sent_count: number;
+    /** Number of failed email sends */
+    failed_count: number;
+    /** Error messages if any failures occurred */
+    errors?: string[];
+}
 
 /**
  * @file resources/clients.ts
@@ -1386,6 +1479,156 @@ declare class WebhooksResource {
     listEventTypes(): Promise<ApiResponse<WebhookEventTypeInfo[]>>;
 }
 
+/**
+ * Notifications Resource
+ *
+ * Provides methods for sending email notifications to clients and
+ * business team members via the Workbench API.
+ *
+ * @module resources/notifications
+ *
+ * @example
+ * // Send a welcome notification to a new client
+ * await workbench.notifications.sendToClient({
+ *   clientId: 'client-uuid',
+ *   event: 'sdk_client_created',
+ *   templateData: { client_name: 'John Doe' }
+ * });
+ *
+ * @example
+ * // Notify business admins about a new request
+ * await workbench.notifications.sendToTeam({
+ *   event: 'sdk_request_created',
+ *   roles: ['owner', 'admin'],
+ *   templateData: { request_title: 'AC Repair', client_name: 'John' }
+ * });
+ *
+ * @example
+ * // Send a custom notification
+ * await workbench.notifications.sendCustom({
+ *   type: 'CLIENT',
+ *   clientId: 'client-uuid',
+ *   subject: 'Your appointment is confirmed!',
+ *   html: '<h1>Confirmed!</h1><p>See you tomorrow at 10am.</p>'
+ * });
+ */
+
+/**
+ * Notifications resource for sending email notifications via the SDK
+ */
+declare class NotificationsResource {
+    private readonly client;
+    constructor(client: WorkbenchClient);
+    /**
+     * Send a notification to a specific client
+     *
+     * Sends an email notification to a client using a predefined template
+     * or custom content. The client must have a valid email address.
+     *
+     * @param options - Notification options
+     * @returns Notification result with delivery statistics
+     *
+     * @example
+     * // Welcome a new client
+     * const result = await workbench.notifications.sendToClient({
+     *   clientId: 'client-uuid',
+     *   event: 'sdk_client_created',
+     *   templateData: {
+     *     client_name: 'John Doe'
+     *   }
+     * });
+     * console.log(`Sent to ${result.data.sent_count} recipient(s)`);
+     *
+     * @example
+     * // Notify client about a new quote with custom subject
+     * const result = await workbench.notifications.sendToClient({
+     *   clientId: 'client-uuid',
+     *   event: 'sdk_quote_created',
+     *   templateData: {
+     *     client_name: 'John',
+     *     quote_number: 'Q-001',
+     *     quote_total: '$1,500.00'
+     *   },
+     *   subjectOverride: 'Your custom quote is ready!'
+     * });
+     */
+    sendToClient(options: SendToClientOptions): Promise<ApiResponse<NotificationResult>>;
+    /**
+     * Send a notification to business team members
+     *
+     * Sends an email notification to team members, optionally filtered
+     * by their role in the business.
+     *
+     * @param options - Notification options
+     * @returns Notification result with delivery statistics
+     *
+     * @example
+     * // Notify all team members about a new service request
+     * const result = await workbench.notifications.sendToTeam({
+     *   event: 'sdk_request_created',
+     *   templateData: {
+     *     request_title: 'Emergency AC Repair',
+     *     client_name: 'John Doe',
+     *     request_description: 'AC not cooling, needs urgent attention'
+     *   }
+     * });
+     *
+     * @example
+     * // Notify only owners and admins
+     * const result = await workbench.notifications.sendToTeam({
+     *   event: 'sdk_invoice_created',
+     *   roles: ['owner', 'admin'],
+     *   templateData: {
+     *     invoice_number: 'INV-001',
+     *     invoice_total: '$2,500.00',
+     *     client_name: 'Acme Corp'
+     *   }
+     * });
+     */
+    sendToTeam(options: SendToTeamOptions): Promise<ApiResponse<NotificationResult>>;
+    /**
+     * Send a custom notification
+     *
+     * Sends a notification with fully custom subject and HTML content.
+     * Can be sent to either a client or business team members.
+     *
+     * @param options - Custom notification options
+     * @returns Notification result with delivery statistics
+     *
+     * @example
+     * // Send custom appointment confirmation to client
+     * const result = await workbench.notifications.sendCustom({
+     *   type: 'CLIENT',
+     *   clientId: 'client-uuid',
+     *   subject: 'Your appointment is confirmed for tomorrow!',
+     *   html: `
+     *     <h1>Appointment Confirmed</h1>
+     *     <p>Hi John,</p>
+     *     <p>Your appointment has been confirmed:</p>
+     *     <ul>
+     *       <li><strong>Date:</strong> January 23, 2026</li>
+     *       <li><strong>Time:</strong> 10:00 AM</li>
+     *       <li><strong>Service:</strong> AC Maintenance</li>
+     *     </ul>
+     *     <p>See you tomorrow!</p>
+     *   `
+     * });
+     *
+     * @example
+     * // Send custom alert to admins
+     * const result = await workbench.notifications.sendCustom({
+     *   type: 'BUSINESS',
+     *   roles: ['owner', 'admin'],
+     *   subject: 'High-value quote approved!',
+     *   html: '<p>Quote Q-001 for $10,000 has been approved by Acme Corp.</p>',
+     *   templateData: {
+     *     quote_number: 'Q-001'
+     *   }
+     * });
+     */
+    sendCustom(options: SendCustomNotificationOptions): Promise<ApiResponse<NotificationResult>>;
+}
+
 /**
  * @file client.ts
  * @description Main Workbench API client class
@@ -1474,6 +1717,8 @@ declare class WorkbenchClient {
     readonly serviceRequests: ServiceRequestsResource;
     /** Webhooks resource */
     readonly webhooks: WebhooksResource;
+    /** Notifications resource */
+    readonly notifications: NotificationsResource;
     /**
      * Create a new Workbench client
      *
@@ -1655,4 +1900,4 @@ declare function constructWebhookEvent<T = Record<string, unknown>>(payload: str
     timestamp: string;
 };
 
-export { type ApiError, type ApiResponse, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, type ResponseMeta, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, ServiceRequestsResource, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };
+export { type ApiError, type ApiResponse, type BusinessUserRole, type Client, type ClientStatus, ClientsResource, type CreateClientOptions, type CreateInvoiceOptions, type CreateJobOptions, type CreateQuoteOptions, type CreateServiceRequestOptions, type CreateWebhookOptions, type Invoice, type InvoiceItem, type InvoiceStatus, InvoicesResource, type Job, type JobPriority, type JobStatus, JobsResource, type ListClientsOptions, type ListInvoicesOptions, type ListJobsOptions, type ListOptions, type ListQuotesOptions, type ListResponse, type ListServiceRequestsOptions, type ListWebhookDeliveriesOptions, type NotificationEvent, type NotificationResult, type NotificationType, NotificationsResource, type Pagination, type Quote, type QuoteItem, type QuoteStatus, QuotesResource, type RequestOptions, type ResponseMeta, type SendCustomNotificationOptions, type SendToClientOptions, type SendToTeamOptions, type ServiceRequest, type ServiceRequestPriority, type ServiceRequestStatus, ServiceRequestsResource, type UpdateClientOptions, type UpdateInvoiceOptions, type UpdateJobOptions, type UpdateQuoteOptions, type UpdateServiceRequestOptions, type UpdateWebhookOptions, type VerifyOptions, type Webhook, type WebhookDelivery, type WebhookEvent, type WebhookSignature, WebhookVerificationError, WebhooksResource, WorkbenchClient, type WorkbenchConfig, WorkbenchError, computeSignature, constructWebhookEvent, parseSignatureHeader, verifyWebhookSignature };

package/dist/index.js

@@ -23,6 +23,7 @@ __export(index_exports, {
   ClientsResource: () => ClientsResource,
   InvoicesResource: () => InvoicesResource,
   JobsResource: () => JobsResource,
+  NotificationsResource: () => NotificationsResource,
   QuotesResource: () => QuotesResource,
   ServiceRequestsResource: () => ServiceRequestsResource,
   WebhookVerificationError: () => WebhookVerificationError,
@@ -859,6 +860,159 @@ var WebhooksResource = class {
   }
 };
 
+// src/resources/notifications.ts
+var NotificationsResource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Send a notification to a specific client
+   *
+   * Sends an email notification to a client using a predefined template
+   * or custom content. The client must have a valid email address.
+   *
+   * @param options - Notification options
+   * @returns Notification result with delivery statistics
+   *
+   * @example
+   * // Welcome a new client
+   * const result = await workbench.notifications.sendToClient({
+   *   clientId: 'client-uuid',
+   *   event: 'sdk_client_created',
+   *   templateData: {
+   *     client_name: 'John Doe'
+   *   }
+   * });
+   * console.log(`Sent to ${result.data.sent_count} recipient(s)`);
+   *
+   * @example
+   * // Notify client about a new quote with custom subject
+   * const result = await workbench.notifications.sendToClient({
+   *   clientId: 'client-uuid',
+   *   event: 'sdk_quote_created',
+   *   templateData: {
+   *     client_name: 'John',
+   *     quote_number: 'Q-001',
+   *     quote_total: '$1,500.00'
+   *   },
+   *   subjectOverride: 'Your custom quote is ready!'
+   * });
+   */
+  async sendToClient(options) {
+    const body = {
+      type: "CLIENT",
+      event: options.event,
+      client_id: options.clientId,
+      template_data: options.templateData,
+      subject_override: options.subjectOverride,
+      html_override: options.htmlOverride,
+      entity_type: options.entityType,
+      entity_id: options.entityId
+    };
+    return this.client.post("/v1/notifications", body);
+  }
+  /**
+   * Send a notification to business team members
+   *
+   * Sends an email notification to team members, optionally filtered
+   * by their role in the business.
+   *
+   * @param options - Notification options
+   * @returns Notification result with delivery statistics
+   *
+   * @example
+   * // Notify all team members about a new service request
+   * const result = await workbench.notifications.sendToTeam({
+   *   event: 'sdk_request_created',
+   *   templateData: {
+   *     request_title: 'Emergency AC Repair',
+   *     client_name: 'John Doe',
+   *     request_description: 'AC not cooling, needs urgent attention'
+   *   }
+   * });
+   *
+   * @example
+   * // Notify only owners and admins
+   * const result = await workbench.notifications.sendToTeam({
+   *   event: 'sdk_invoice_created',
+   *   roles: ['owner', 'admin'],
+   *   templateData: {
+   *     invoice_number: 'INV-001',
+   *     invoice_total: '$2,500.00',
+   *     client_name: 'Acme Corp'
+   *   }
+   * });
+   */
+  async sendToTeam(options) {
+    const body = {
+      type: "BUSINESS",
+      event: options.event,
+      roles: options.roles,
+      template_data: options.templateData,
+      subject_override: options.subjectOverride,
+      html_override: options.htmlOverride,
+      entity_type: options.entityType,
+      entity_id: options.entityId
+    };
+    return this.client.post("/v1/notifications", body);
+  }
+  /**
+   * Send a custom notification
+   *
+   * Sends a notification with fully custom subject and HTML content.
+   * Can be sent to either a client or business team members.
+   *
+   * @param options - Custom notification options
+   * @returns Notification result with delivery statistics
+   *
+   * @example
+   * // Send custom appointment confirmation to client
+   * const result = await workbench.notifications.sendCustom({
+   *   type: 'CLIENT',
+   *   clientId: 'client-uuid',
+   *   subject: 'Your appointment is confirmed for tomorrow!',
+   *   html: `
+   *     <h1>Appointment Confirmed</h1>
+   *     <p>Hi John,</p>
+   *     <p>Your appointment has been confirmed:</p>
+   *     <ul>
+   *       <li><strong>Date:</strong> January 23, 2026</li>
+   *       <li><strong>Time:</strong> 10:00 AM</li>
+   *       <li><strong>Service:</strong> AC Maintenance</li>
+   *     </ul>
+   *     <p>See you tomorrow!</p>
+   *   `
+   * });
+   *
+   * @example
+   * // Send custom alert to admins
+   * const result = await workbench.notifications.sendCustom({
+   *   type: 'BUSINESS',
+   *   roles: ['owner', 'admin'],
+   *   subject: 'High-value quote approved!',
+   *   html: '<p>Quote Q-001 for $10,000 has been approved by Acme Corp.</p>',
+   *   templateData: {
+   *     quote_number: 'Q-001'
+   *   }
+   * });
+   */
+  async sendCustom(options) {
+    const body = {
+      type: options.type,
+      event: "sdk_custom",
+      client_id: options.clientId,
+      roles: options.roles,
+      template_data: options.templateData,
+      subject_override: options.subject,
+      html_override: options.html,
+      entity_type: options.entityType,
+      entity_id: options.entityId
+    };
+    return this.client.post("/v1/notifications", body);
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.tryworkbench.app";
 var DEFAULT_TIMEOUT = 3e4;
@@ -898,6 +1052,8 @@ var WorkbenchClient = class {
   serviceRequests;
   /** Webhooks resource */
   webhooks;
+  /** Notifications resource */
+  notifications;
   /**
    * Create a new Workbench client
    *
@@ -919,6 +1075,7 @@ var WorkbenchClient = class {
     this.jobs = new JobsResource(this);
     this.serviceRequests = new ServiceRequestsResource(this);
     this.webhooks = new WebhooksResource(this);
+    this.notifications = new NotificationsResource(this);
   }
   /**
    * Build URL with query parameters
@@ -1133,6 +1290,7 @@ function constructWebhookEvent(payload, signature, secret, options = {}) {
   ClientsResource,
   InvoicesResource,
   JobsResource,
+  NotificationsResource,
   QuotesResource,
   ServiceRequestsResource,
   WebhookVerificationError,

package/dist/index.mjs

@@ -821,6 +821,159 @@ var WebhooksResource = class {
   }
 };
 
+// src/resources/notifications.ts
+var NotificationsResource = class {
+  client;
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Send a notification to a specific client
+   *
+   * Sends an email notification to a client using a predefined template
+   * or custom content. The client must have a valid email address.
+   *
+   * @param options - Notification options
+   * @returns Notification result with delivery statistics
+   *
+   * @example
+   * // Welcome a new client
+   * const result = await workbench.notifications.sendToClient({
+   *   clientId: 'client-uuid',
+   *   event: 'sdk_client_created',
+   *   templateData: {
+   *     client_name: 'John Doe'
+   *   }
+   * });
+   * console.log(`Sent to ${result.data.sent_count} recipient(s)`);
+   *
+   * @example
+   * // Notify client about a new quote with custom subject
+   * const result = await workbench.notifications.sendToClient({
+   *   clientId: 'client-uuid',
+   *   event: 'sdk_quote_created',
+   *   templateData: {
+   *     client_name: 'John',
+   *     quote_number: 'Q-001',
+   *     quote_total: '$1,500.00'
+   *   },
+   *   subjectOverride: 'Your custom quote is ready!'
+   * });
+   */
+  async sendToClient(options) {
+    const body = {
+      type: "CLIENT",
+      event: options.event,
+      client_id: options.clientId,
+      template_data: options.templateData,
+      subject_override: options.subjectOverride,
+      html_override: options.htmlOverride,
+      entity_type: options.entityType,
+      entity_id: options.entityId
+    };
+    return this.client.post("/v1/notifications", body);
+  }
+  /**
+   * Send a notification to business team members
+   *
+   * Sends an email notification to team members, optionally filtered
+   * by their role in the business.
+   *
+   * @param options - Notification options
+   * @returns Notification result with delivery statistics
+   *
+   * @example
+   * // Notify all team members about a new service request
+   * const result = await workbench.notifications.sendToTeam({
+   *   event: 'sdk_request_created',
+   *   templateData: {
+   *     request_title: 'Emergency AC Repair',
+   *     client_name: 'John Doe',
+   *     request_description: 'AC not cooling, needs urgent attention'
+   *   }
+   * });
+   *
+   * @example
+   * // Notify only owners and admins
+   * const result = await workbench.notifications.sendToTeam({
+   *   event: 'sdk_invoice_created',
+   *   roles: ['owner', 'admin'],
+   *   templateData: {
+   *     invoice_number: 'INV-001',
+   *     invoice_total: '$2,500.00',
+   *     client_name: 'Acme Corp'
+   *   }
+   * });
+   */
+  async sendToTeam(options) {
+    const body = {
+      type: "BUSINESS",
+      event: options.event,
+      roles: options.roles,
+      template_data: options.templateData,
+      subject_override: options.subjectOverride,
+      html_override: options.htmlOverride,
+      entity_type: options.entityType,
+      entity_id: options.entityId
+    };
+    return this.client.post("/v1/notifications", body);
+  }
+  /**
+   * Send a custom notification
+   *
+   * Sends a notification with fully custom subject and HTML content.
+   * Can be sent to either a client or business team members.
+   *
+   * @param options - Custom notification options
+   * @returns Notification result with delivery statistics
+   *
+   * @example
+   * // Send custom appointment confirmation to client
+   * const result = await workbench.notifications.sendCustom({
+   *   type: 'CLIENT',
+   *   clientId: 'client-uuid',
+   *   subject: 'Your appointment is confirmed for tomorrow!',
+   *   html: `
+   *     <h1>Appointment Confirmed</h1>
+   *     <p>Hi John,</p>
+   *     <p>Your appointment has been confirmed:</p>
+   *     <ul>
+   *       <li><strong>Date:</strong> January 23, 2026</li>
+   *       <li><strong>Time:</strong> 10:00 AM</li>
+   *       <li><strong>Service:</strong> AC Maintenance</li>
+   *     </ul>
+   *     <p>See you tomorrow!</p>
+   *   `
+   * });
+   *
+   * @example
+   * // Send custom alert to admins
+   * const result = await workbench.notifications.sendCustom({
+   *   type: 'BUSINESS',
+   *   roles: ['owner', 'admin'],
+   *   subject: 'High-value quote approved!',
+   *   html: '<p>Quote Q-001 for $10,000 has been approved by Acme Corp.</p>',
+   *   templateData: {
+   *     quote_number: 'Q-001'
+   *   }
+   * });
+   */
+  async sendCustom(options) {
+    const body = {
+      type: options.type,
+      event: "sdk_custom",
+      client_id: options.clientId,
+      roles: options.roles,
+      template_data: options.templateData,
+      subject_override: options.subject,
+      html_override: options.html,
+      entity_type: options.entityType,
+      entity_id: options.entityId
+    };
+    return this.client.post("/v1/notifications", body);
+  }
+};
+
 // src/client.ts
 var DEFAULT_BASE_URL = "https://api.tryworkbench.app";
 var DEFAULT_TIMEOUT = 3e4;
@@ -860,6 +1013,8 @@ var WorkbenchClient = class {
   serviceRequests;
   /** Webhooks resource */
   webhooks;
+  /** Notifications resource */
+  notifications;
   /**
    * Create a new Workbench client
    *
@@ -881,6 +1036,7 @@ var WorkbenchClient = class {
     this.jobs = new JobsResource(this);
     this.serviceRequests = new ServiceRequestsResource(this);
     this.webhooks = new WebhooksResource(this);
+    this.notifications = new NotificationsResource(this);
   }
   /**
    * Build URL with query parameters
@@ -1094,6 +1250,7 @@ export {
   ClientsResource,
   InvoicesResource,
   JobsResource,
+  NotificationsResource,
   QuotesResource,
   ServiceRequestsResource,
   WebhookVerificationError,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@workbenchcrm/sdk",
-  "version": "1.0.3",
+  "version": "1.1.0",
   "description": "Official Node.js SDK for the Workbench CRM API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",