@plyaz/types 1.45.2 → 1.45.3

package/dist/api/endpoints/index.d.ts

@@ -3,6 +3,7 @@ export type * from './featureFlags';
 export type * from './files';
 export type * from './health';
 export type * from './infobip';
+export type * from './notification';
 export type * from './virustotal';
 export type * from './cdn';
 export type * from './types';

package/dist/api/endpoints/notification/endpoints.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Notification Endpoint Type Definitions
+ *
+ * Uses fetchff's Endpoint and Req types for type-safe API definitions.
+ *
+ * Req<TResponse, TBody?, TQuery?, TParams?> generic parameters:
+ * - TResponse: The response type returned by the endpoint
+ * - TBody: The request body type (use 'never' for GET/DELETE)
+ * - TQuery: URL query parameters type
+ * - TParams: URL path parameters type (use 'never' if no path params)
+ *
+ * Available endpoints:
+ * - GET /notifications (list)
+ * - DELETE /notifications/:id
+ */
+import type { Endpoint, Req } from 'fetchff';
+import type { ListNotificationFilters, ListNotificationResponse, DeleteNotificationParams, DeleteNotificationResponse } from './schemas';
+/**
+ * Notification API endpoint types.
+ * Complete type definitions for notification operation endpoints.
+ */
+export interface NotificationEndpointTypes {
+    /**
+     * GET /notifications - List notifications
+     * Returns paginated list with optional filters.
+     *
+     * Req<Response, Body, Query>
+     * - Response: ListNotificationResponse
+     * - Body: never (GET has no body)
+     * - Query: ListNotificationFilters
+     */
+    listNotifications: Endpoint<Req<ListNotificationResponse, never, ListNotificationFilters>>;
+    /**
+     * DELETE /notifications/:id - Delete a notification
+     *
+     * Req<Response, Body, Query, Params>
+     * - Response: DeleteNotificationResponse
+     * - Body: never (DELETE typically has no body)
+     * - Query: never (no query params)
+     * - Params: DeleteNotificationParams (path params)
+     */
+    deleteNotification: Endpoint<Req<DeleteNotificationResponse, never, never, DeleteNotificationParams>>;
+}
+/**
+ * Type guard for notification endpoint keys.
+ */
+export type NotificationEndpointKey = keyof NotificationEndpointTypes;

package/dist/api/endpoints/notification/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Notification API Endpoint Types
+ * Export all notification operation types and schemas
+ *
+ * Single source of truth: types are inferred from Zod schemas
+ *
+ * Available endpoints:
+ * - GET /notifications (list)
+ * - DELETE /notifications/:id
+ */
+export { NotificationSchema, ListNotificationFiltersSchema, DeleteNotificationParamsSchema, ListNotificationResponseSchema, DeleteNotificationResponseSchema, } from './schemas';
+export type { NotificationTypeValue, NotificationChannelValue, NotificationStatusValue, NotificationCategoryValue, Notification, ListNotificationFilters, DeleteNotificationParams, ListNotificationResponse, DeleteNotificationResponse, } from './schemas';
+export type { NotificationEndpointTypes, NotificationEndpointKey } from './endpoints';

package/dist/api/endpoints/notification/schemas.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Notification API Endpoint Schemas
+ *
+ * Zod schemas for notification API operations.
+ * Types are inferred from schemas (single source of truth).
+ *
+ * Enum schemas are imported from core/domain (match DB ENUMs)
+ *
+ * Available endpoints:
+ * - GET /notifications (list)
+ * - DELETE /notifications/:id
+ */
+import { z } from 'zod';
+import { NotificationCategorySchema } from '../../../notifications/schemas';
+import { NotificationTypeSchema, NotificationChannelSchema, NotificationStatusSchema } from '../../../core/domain/notifications/schemas';
+/**
+ * Notification entity schema
+ * Matches migration 006_notifications_media.sql
+ */
+export declare const NotificationSchema: z.ZodObject<{
+    id: z.ZodString;
+    user_id: z.ZodString;
+    type: z.ZodEnum<{
+        SYSTEM: "SYSTEM";
+        CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+    }>;
+    title: z.ZodString;
+    message: z.ZodString;
+    link_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reference_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    reference_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    correlation_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    recipient_id: z.ZodString;
+    template_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    channel: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+        IN_APP: "IN_APP";
+        EMAIL: "EMAIL";
+        SMS: "SMS";
+        PUSH: "PUSH";
+    }>>>;
+    category: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodEnum<{
+        system: "system";
+        transactional: "transactional";
+        marketing: "marketing";
+        social: "social";
+        promotional: "promotional";
+    }>>>>;
+    provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        processing: "processing";
+        failed: "failed";
+        sent: "sent";
+        delivered: "delivered";
+        bounced: "bounced";
+        queued: "queued";
+    }>>;
+    sent_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    is_read: z.ZodDefault<z.ZodBoolean>;
+    read_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    error_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    retry_count: z.ZodDefault<z.ZodNumber>;
+    created_at: z.ZodString;
+    deleted_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+}, z.core.$strip>;
+/**
+ * GET /notifications - Query filters
+ */
+export declare const ListNotificationFiltersSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    sort_by: z.ZodOptional<z.ZodEnum<{
+        created_at: "created_at";
+        sent_at: "sent_at";
+        delivered_at: "delivered_at";
+    }>>;
+    sort_order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    user_id: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        IN_APP: "IN_APP";
+        EMAIL: "EMAIL";
+        SMS: "SMS";
+        PUSH: "PUSH";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        processing: "processing";
+        failed: "failed";
+        sent: "sent";
+        delivered: "delivered";
+        bounced: "bounced";
+        queued: "queued";
+    }>>;
+    category: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        system: "system";
+        transactional: "transactional";
+        marketing: "marketing";
+        social: "social";
+        promotional: "promotional";
+    }>>>;
+    template_id: z.ZodOptional<z.ZodString>;
+    recipient_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        SYSTEM: "SYSTEM";
+        CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+    }>>;
+    is_read: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    created_after: z.ZodOptional<z.ZodString>;
+    created_before: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * DELETE /notifications/:id - Delete params
+ */
+export declare const DeleteNotificationParamsSchema: z.ZodObject<{
+    id: z.ZodString;
+}, z.core.$strip>;
+/**
+ * GET /notifications - List response
+ * Pagination fields inlined (no separate schema needed)
+ */
+export declare const ListNotificationResponseSchema: z.ZodObject<{
+    data: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        user_id: z.ZodString;
+        type: z.ZodEnum<{
+            SYSTEM: "SYSTEM";
+            CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+        }>;
+        title: z.ZodString;
+        message: z.ZodString;
+        link_url: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reference_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        reference_type: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        correlation_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        recipient_id: z.ZodString;
+        template_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        channel: z.ZodOptional<z.ZodNullable<z.ZodEnum<{
+            IN_APP: "IN_APP";
+            EMAIL: "EMAIL";
+            SMS: "SMS";
+            PUSH: "PUSH";
+        }>>>;
+        category: z.ZodOptional<z.ZodNullable<z.ZodDefault<z.ZodEnum<{
+            system: "system";
+            transactional: "transactional";
+            marketing: "marketing";
+            social: "social";
+            promotional: "promotional";
+        }>>>>;
+        provider: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        provider_message_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<{
+            processing: "processing";
+            failed: "failed";
+            sent: "sent";
+            delivered: "delivered";
+            bounced: "bounced";
+            queued: "queued";
+        }>>;
+        sent_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        delivered_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        is_read: z.ZodDefault<z.ZodBoolean>;
+        read_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        error_message: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        retry_count: z.ZodDefault<z.ZodNumber>;
+        created_at: z.ZodString;
+        deleted_at: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    }, z.core.$strip>>;
+    pagination: z.ZodOptional<z.ZodObject<{
+        page: z.ZodNumber;
+        limit: z.ZodNumber;
+        total: z.ZodNumber;
+        totalPages: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+/**
+ * DELETE /notifications/:id - Delete response
+ */
+export declare const DeleteNotificationResponseSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    id: z.ZodString;
+}, z.core.$strip>;
+export type NotificationTypeValue = z.infer<typeof NotificationTypeSchema>;
+export type NotificationChannelValue = z.infer<typeof NotificationChannelSchema>;
+export type NotificationStatusValue = z.infer<typeof NotificationStatusSchema>;
+export type NotificationCategoryValue = z.infer<typeof NotificationCategorySchema>;
+export type Notification = z.infer<typeof NotificationSchema>;
+export type ListNotificationFilters = z.input<typeof ListNotificationFiltersSchema>;
+export type DeleteNotificationParams = z.input<typeof DeleteNotificationParamsSchema>;
+export type ListNotificationResponse = z.infer<typeof ListNotificationResponseSchema>;
+export type DeleteNotificationResponse = z.infer<typeof DeleteNotificationResponseSchema>;

package/dist/api/endpoints/types.d.ts

@@ -6,6 +6,7 @@ import type { CloudflareEndpointTypes, CloudFrontEndpointTypes, FastlyEndpointTy
 import type { FeatureFlagEndpointTypes } from './featureFlags';
 import type { PaymentEndpointTypes } from './payments';
 import type { FilesEndpointTypes } from './files';
+import type { NotificationEndpointTypes } from './notification';
 /**
  * Query parameters type - matches fetchff's flexible param handling
  * Supports objects, URLSearchParams, and arrays of name-value pairs
@@ -14,5 +15,5 @@ export type QueryParams = Record<string, string | number | boolean | string[] |
 /**
  * All endpoint types combined
  */
-export interface EndpointTypes extends CampaignEndpointTypes, PaymentEndpointTypes, PollingEndpointTypes, InfobipEndpointTypes, VirusTotalEndpointTypes, CloudflareEndpointTypes, CloudFrontEndpointTypes, FastlyEndpointTypes, FeatureFlagEndpointTypes, FilesEndpointTypes {
+export interface EndpointTypes extends CampaignEndpointTypes, PaymentEndpointTypes, PollingEndpointTypes, InfobipEndpointTypes, VirusTotalEndpointTypes, CloudflareEndpointTypes, CloudFrontEndpointTypes, FastlyEndpointTypes, FeatureFlagEndpointTypes, FilesEndpointTypes, NotificationEndpointTypes {
 }

package/dist/api/index.d.ts

@@ -45,6 +45,7 @@ export type * from './endpoints/health/types';
 export type * from './endpoints/campaigns/types';
 export type * from './endpoints/featureFlags';
 export type * from './endpoints/files';
+export type * from './endpoints/notification';
 export type * from './endpoints/infobip/types';
 export type * from './endpoints/virustotal/types';
 export type * from './endpoints/cdn/types';

package/dist/core/domain/index.d.ts

@@ -5,3 +5,4 @@
 export type { EmptyDTO, CoreDeleteOptions, CoreBaseDomainServiceInterface, CoreEventSubscribable, CoreProviderSubscribable, CoreValidationResult, CoreValidatorConfig, CoreBaseValidatorInstance, CoreBaseMapperInstance, CoreBaseDomainServiceConfig, CoreBaseBackendServiceConfig, CoreMapperClass, CoreValidatorClass, CoreBaseServiceConfig, CoreInjectedServices, } from './types';
 export type { CrudCacheOptions, CrudTransactionOptions, CrudOperationOptions, } from './crud';
 export * from './files';
+export * from './notifications';

package/dist/core/domain/notifications/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Notifications Domain Types
+ *
+ * Type definitions for notifications domain.
+ *
+ * @module core/domain/notifications
+ */
+export type * from './types';
+export * from './schemas';
+export * from './streaming';
+export type { NotificationStoreItem } from '../../../store/notifications';

package/dist/core/domain/notifications/schemas.d.ts

@@ -0,0 +1,195 @@
+/**
+ * Notifications Domain Schemas
+ *
+ * Zod validation schemas for notifications operations.
+ * Single source of truth - types are inferred from schemas.
+ *
+ * Used by:
+ * - NotificationsValidator in @plyaz/core for validation
+ * - NotificationsRepository for type safety
+ * - NotificationsMapper for transformations
+ *
+ * Note: Enum schemas are imported from @plyaz/types/notifications/schemas
+ * to avoid duplication. This file defines domain-specific schemas only.
+ */
+import { z } from 'zod';
+/**
+ * Notification type enum - matches notification_type DB ENUM
+ * Simplified for now - expand as needed
+ */
+export declare const NotificationTypeSchema: z.ZodEnum<{
+    SYSTEM: "SYSTEM";
+    CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+}>;
+export type NotificationTypeValue = z.infer<typeof NotificationTypeSchema>;
+/**
+ * Notification channel enum - matches notification_channel DB ENUM
+ */
+export declare const NotificationChannelSchema: z.ZodEnum<{
+    IN_APP: "IN_APP";
+    EMAIL: "EMAIL";
+    SMS: "SMS";
+    PUSH: "PUSH";
+}>;
+export type NotificationChannelValue = z.infer<typeof NotificationChannelSchema>;
+/**
+ * Notification status enum
+ */
+export declare const NotificationStatusSchema: z.ZodEnum<{
+    processing: "processing";
+    failed: "failed";
+    sent: "sent";
+    delivered: "delivered";
+    bounced: "bounced";
+    queued: "queued";
+}>;
+export type NotificationStatusValue = z.infer<typeof NotificationStatusSchema>;
+/**
+ * Full notifications database row schema
+ * Matches migration 006_notifications_media.sql schema
+ */
+export declare const NotificationsDatabaseRowSchema: z.ZodObject<{
+    id: z.ZodString;
+    created_at: z.ZodString;
+    user_id: z.ZodString;
+    type: z.ZodEnum<{
+        SYSTEM: "SYSTEM";
+        CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+    }>;
+    title: z.ZodString;
+    message: z.ZodString;
+    recipient_id: z.ZodString;
+    link_url: z.ZodNullable<z.ZodString>;
+    reference_id: z.ZodNullable<z.ZodString>;
+    reference_type: z.ZodNullable<z.ZodString>;
+    correlation_id: z.ZodNullable<z.ZodString>;
+    template_id: z.ZodNullable<z.ZodString>;
+    channel: z.ZodNullable<z.ZodEnum<{
+        IN_APP: "IN_APP";
+        EMAIL: "EMAIL";
+        SMS: "SMS";
+        PUSH: "PUSH";
+    }>>;
+    category: z.ZodNullable<z.ZodDefault<z.ZodEnum<{
+        system: "system";
+        transactional: "transactional";
+        marketing: "marketing";
+        social: "social";
+        promotional: "promotional";
+    }>>>;
+    provider: z.ZodNullable<z.ZodString>;
+    provider_message_id: z.ZodNullable<z.ZodString>;
+    status: z.ZodDefault<z.ZodEnum<{
+        processing: "processing";
+        failed: "failed";
+        sent: "sent";
+        delivered: "delivered";
+        bounced: "bounced";
+        queued: "queued";
+    }>>;
+    sent_at: z.ZodNullable<z.ZodString>;
+    delivered_at: z.ZodNullable<z.ZodString>;
+    is_read: z.ZodDefault<z.ZodBoolean>;
+    read_at: z.ZodNullable<z.ZodString>;
+    error_message: z.ZodNullable<z.ZodString>;
+    retry_count: z.ZodDefault<z.ZodNumber>;
+    deleted_at: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+/**
+ * Database row type - inferred from schema
+ */
+export type NotificationsDatabaseRow = z.infer<typeof NotificationsDatabaseRowSchema>;
+/**
+ * Delete Notifications Schema
+ * Validates delete params (id)
+ */
+export declare const DeleteNotificationsSchema: z.ZodObject<{
+    id: z.ZodOptional<z.ZodString>;
+    soft: z.ZodOptional<z.ZodBoolean>;
+    reason: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type DeleteNotificationsDTO = z.infer<typeof DeleteNotificationsSchema>;
+/**
+ * Query Notifications Schema
+ * GET /notifications filters
+ */
+export declare const QueryNotificationsSchema: z.ZodObject<{
+    page: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    limit: z.ZodDefault<z.ZodOptional<z.ZodCoercedNumber<unknown>>>;
+    offset: z.ZodOptional<z.ZodCoercedNumber<unknown>>;
+    sort_by: z.ZodOptional<z.ZodEnum<{
+        created_at: "created_at";
+        sent_at: "sent_at";
+        delivered_at: "delivered_at";
+    }>>;
+    sort_order: z.ZodOptional<z.ZodEnum<{
+        asc: "asc";
+        desc: "desc";
+    }>>;
+    user_id: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        IN_APP: "IN_APP";
+        EMAIL: "EMAIL";
+        SMS: "SMS";
+        PUSH: "PUSH";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        processing: "processing";
+        failed: "failed";
+        sent: "sent";
+        delivered: "delivered";
+        bounced: "bounced";
+        queued: "queued";
+    }>>;
+    category: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        system: "system";
+        transactional: "transactional";
+        marketing: "marketing";
+        social: "social";
+        promotional: "promotional";
+    }>>>;
+    template_id: z.ZodOptional<z.ZodString>;
+    recipient_id: z.ZodOptional<z.ZodString>;
+    type: z.ZodOptional<z.ZodEnum<{
+        SYSTEM: "SYSTEM";
+        CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+    }>>;
+    is_read: z.ZodOptional<z.ZodCoercedBoolean<unknown>>;
+    created_after: z.ZodOptional<z.ZodString>;
+    created_before: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type QueryNotificationsDTO = z.input<typeof QueryNotificationsSchema>;
+/**
+ * Create Notifications Schema (for backend)
+ */
+export declare const CreateNotificationsSchema: z.ZodObject<{
+    user_id: z.ZodString;
+    type: z.ZodEnum<{
+        SYSTEM: "SYSTEM";
+        CAMPAIGN_BACKED: "CAMPAIGN_BACKED";
+    }>;
+    title: z.ZodString;
+    message: z.ZodString;
+    link_url: z.ZodOptional<z.ZodString>;
+    reference_id: z.ZodOptional<z.ZodString>;
+    reference_type: z.ZodOptional<z.ZodString>;
+    correlation_id: z.ZodOptional<z.ZodString>;
+    recipient_id: z.ZodString;
+    template_id: z.ZodOptional<z.ZodString>;
+    channel: z.ZodOptional<z.ZodEnum<{
+        IN_APP: "IN_APP";
+        EMAIL: "EMAIL";
+        SMS: "SMS";
+        PUSH: "PUSH";
+    }>>;
+    category: z.ZodOptional<z.ZodDefault<z.ZodEnum<{
+        system: "system";
+        transactional: "transactional";
+        marketing: "marketing";
+        social: "social";
+        promotional: "promotional";
+    }>>>;
+    provider: z.ZodOptional<z.ZodString>;
+    provider_message_id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type CreateNotificationsDTO = z.infer<typeof CreateNotificationsSchema>;

package/dist/core/domain/notifications/streaming.d.ts

@@ -0,0 +1,97 @@
+/**
+ * Notifications Domain Streaming Types
+ *
+ * Stream message types for IN_APP notification delivery.
+ * Only supports notification:created - user receives new notifications in real-time.
+ *
+ * NOTE: Only IN_APP notifications are supported for streaming.
+ * Email, SMS, and Push notifications are backend-only operations via @plyaz/notifications.
+ *
+ * Flow:
+ * 1. Backend creates notification with user_id
+ * 2. Backend emits notification:created event
+ * 3. Channel controller broadcasts to user:notifications:{userId}
+ * 4. User's connected clients receive the notification
+ */
+import type { NotificationStatus, NotificationCategory } from '../../../notifications';
+/**
+ * SSE/WebSocket event names for notifications domain.
+ * Only notification:created is needed - user receives new notifications.
+ */
+export declare const NOTIFICATIONS_STREAM_EVENT: {
+    /** New notification created for user */
+    readonly NOTIFICATION_CREATED: "notification:created";
+};
+export type NotificationsStreamEventName = (typeof NOTIFICATIONS_STREAM_EVENT)[keyof typeof NOTIFICATIONS_STREAM_EVENT];
+/**
+ * Channel prefixes for notifications domain subscriptions.
+ */
+export declare const NOTIFICATIONS_STREAM_CHANNEL_PREFIX: {
+    /** Per-user channel - user subscribes to receive their notifications */
+    readonly USER: "user:notifications:";
+};
+export type NotificationsStreamChannelPrefix = (typeof NOTIFICATIONS_STREAM_CHANNEL_PREFIX)[keyof typeof NOTIFICATIONS_STREAM_CHANNEL_PREFIX];
+/**
+ * Broadcast channels for notifications domain.
+ */
+export declare const NOTIFICATIONS_STREAM_BROADCAST_CHANNEL: {
+    /** All notifications broadcast (admin/debug) */
+    readonly ALL_NOTIFICATIONS: "notifications";
+};
+export type NotificationsStreamBroadcastChannel = (typeof NOTIFICATIONS_STREAM_BROADCAST_CHANNEL)[keyof typeof NOTIFICATIONS_STREAM_BROADCAST_CHANNEL];
+/**
+ * All notifications stream channels.
+ */
+export declare const NOTIFICATIONS_STREAM_CHANNEL: {
+    readonly PREFIX: {
+        /** Per-user channel - user subscribes to receive their notifications */
+        readonly USER: "user:notifications:";
+    };
+    readonly BROADCAST: {
+        /** All notifications broadcast (admin/debug) */
+        readonly ALL_NOTIFICATIONS: "notifications";
+    };
+};
+/**
+ * Channel patterns for notifications domain subscriptions.
+ *
+ * - `user:notifications:{userId}` - User subscribes to receive their notifications
+ * - `notifications` - Broadcast channel (admin/debug)
+ */
+export type NotificationsStreamChannel = `user:notifications:${string}` | NotificationsStreamBroadcastChannel;
+/**
+ * Notification created event data.
+ * Contains all info needed to display the notification to the user.
+ *
+ * IMPORTANT: userId is required for routing to the correct user's channel.
+ */
+export interface NotificationCreatedStreamData {
+    /** Notification ID */
+    notificationId: string;
+    /** User ID - REQUIRED for routing to correct user */
+    userId: string;
+    /** Notification type (system, alert, info, etc.) */
+    type: string;
+    /** Notification title */
+    title: string;
+    /** Notification message/body */
+    message: string;
+    /** Link URL for action */
+    linkUrl?: string;
+    /** Reference ID (e.g., order ID, campaign ID) */
+    referenceId?: string;
+    /** Reference type (e.g., 'order', 'campaign') */
+    referenceType?: string;
+    /** Notification category */
+    category: NotificationCategory;
+    /** Current status */
+    status: NotificationStatus;
+    /** When the notification was created */
+    createdAt: string;
+    /** Timestamp of the stream event */
+    timestamp?: string;
+}
+/**
+ * Union of all notifications stream data types.
+ */
+export type NotificationsStreamData = NotificationCreatedStreamData;