captify 0.1.18 → 1.1.0

package/dist/notifications/notification.utilities.d.ts

@@ -0,0 +1,12 @@
+import type { Notification as CoreNotification } from "./notifications.interfaces";
+import type { Notification as ShellNotification } from "../shell/shell.interfaces";
+/**
+ * Convert NotificationDisplay from API to shell Notification interface
+ */
+export declare function toShellNotification(notification: ShellNotification): ShellNotification;
+/**
+ * Convert a Notification to the display format used by UI components
+ * (matches the Notification interface in shell.interfaces.ts)
+ */
+export declare function toDisplayNotification(notification: CoreNotification): ShellNotification;
+//# sourceMappingURL=notification.utilities.d.ts.map

package/dist/notifications/notification.utilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.utilities.d.ts","sourceRoot":"","sources":["../../lib/notifications/notification.utilities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,IAAI,gBAAgB,EAAE,MAAM,8CAA8C,CAAC;AACrG,OAAO,KAAK,EAAE,YAAY,IAAI,iBAAiB,EAAE,MAAM,8BAA8B,CAAC;AACtF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,YAAY,EAAE,iBAAiB,GAAG,iBAAiB,CAWtF;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,gBAAgB,GAAG,iBAAiB,CAWvF"}

package/dist/notifications/notification.utilities.js

@@ -0,0 +1,35 @@
+/**
+ * Convert NotificationDisplay from API to shell Notification interface
+ */
+export function toShellNotification(notification) {
+    return {
+        id: notification.id,
+        title: notification.title,
+        message: notification.message,
+        read: notification.read,
+        createdAt: new Date(notification.createdAt),
+        url: notification.url,
+        actorName: notification.actorName,
+        type: notification.type,
+    };
+}
+// ============================================================================
+// Utility Functions
+// ============================================================================
+/**
+ * Convert a Notification to the display format used by UI components
+ * (matches the Notification interface in shell.interfaces.ts)
+ */
+export function toDisplayNotification(notification) {
+    return {
+        id: notification.id,
+        title: notification.title,
+        message: notification.message,
+        read: notification.read,
+        createdAt: new Date(notification.createdAt),
+        url: notification.url,
+        actorName: notification.actorName,
+        type: notification.type,
+    };
+}
+//# sourceMappingURL=notification.utilities.js.map

package/dist/notifications/notification.utilities.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notification.utilities.js","sourceRoot":"","sources":["../../lib/notifications/notification.utilities.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,UAAU,mBAAmB,CAAC,YAA+B;IACjE,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,EAAE;QACnB,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;QAC3C,GAAG,EAAE,YAAY,CAAC,GAAG;QACrB,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,IAAI,EAAE,YAAY,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC;AAED,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;;GAGG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAA8B;IAClE,OAAO;QACL,EAAE,EAAE,YAAY,CAAC,EAAE;QACnB,KAAK,EAAE,YAAY,CAAC,KAAK;QACzB,OAAO,EAAE,YAAY,CAAC,OAAO;QAC7B,IAAI,EAAE,YAAY,CAAC,IAAI;QACvB,SAAS,EAAE,IAAI,IAAI,CAAC,YAAY,CAAC,SAAS,CAAC;QAC3C,GAAG,EAAE,YAAY,CAAC,GAAG;QACrB,SAAS,EAAE,YAAY,CAAC,SAAS;QACjC,IAAI,EAAE,YAAY,CAAC,IAAI;KACxB,CAAC;AACJ,CAAC"}

package/dist/notifications/notifications.constants.d.ts

@@ -0,0 +1,72 @@
+/**
+ * Notifications Service Constants
+ */
+import { type LucideIcon } from "lucide-react";
+/** Default API endpoint for notifications */
+export declare const NOTIFICATIONS_API_ENDPOINT = "/api/notifications";
+/** Supported notification types */
+export declare const NOTIFICATION_TYPES: {
+    readonly MENTION: "mention";
+    readonly REPLY: "reply";
+    readonly FEEDBACK_CREATED: "feedback_created";
+    readonly FEEDBACK_STATUS_CHANGED: "feedback_status_changed";
+    readonly FEEDBACK_ASSIGNED: "feedback_assigned";
+    readonly FEEDBACK_UPDATED: "feedback_updated";
+};
+export type NotificationType = (typeof NOTIFICATION_TYPES)[keyof typeof NOTIFICATION_TYPES];
+/** Mapping of notification types to their icons and colors for UI display */
+export declare const NOTIFICATION_TYPE_CONFIG: Record<string, {
+    icon: LucideIcon;
+    className: string;
+}>;
+/** Supported notification source types */
+export declare const NOTIFICATION_SOURCE_TYPES: {
+    readonly COMMENT: "comment";
+    readonly FEEDBACK: "feedback";
+};
+export type NotificationSourceType = (typeof NOTIFICATION_SOURCE_TYPES)[keyof typeof NOTIFICATION_SOURCE_TYPES];
+/** Notification titles for different notification types */
+export declare const NOTIFICATION_TITLES: {
+    readonly MENTION: "New Mention";
+    readonly REPLY: "New Reply";
+    readonly FEEDBACK_ASSIGNED: "New Feedback Assigned";
+    readonly FEEDBACK_REASSIGNED: "Feedback Assigned to You";
+    readonly FEEDBACK_STATUS_CHANGED: "Feedback Status Updated";
+    readonly FEEDBACK_UPDATED: "Feedback Updated";
+    readonly FEEDBACK_CREATED: "New Feedback Created";
+};
+/** Default number of notifications to fetch */
+export declare const DEFAULT_NOTIFICATIONS_LIMIT = 20;
+/** Maximum number of notifications to fetch in one request */
+export declare const MAX_NOTIFICATIONS_LIMIT = 100;
+/** Default polling interval for notifications in milliseconds (30 seconds) */
+export declare const DEFAULT_POLLING_INTERVAL_MS: number;
+/** Maximum length of notification title */
+export declare const MAX_TITLE_LENGTH = 100;
+/** Maximum length of notification message */
+export declare const MAX_MESSAGE_LENGTH = 500;
+/** Maximum length of notification URL */
+export declare const MAX_URL_LENGTH = 2000;
+/** Default TTL for notifications in days (90 days). Server-side only - no need to expose to client. */
+export declare const DEFAULT_NOTIFICATION_TTL_DAYS: number;
+/** Convert days to seconds for DynamoDB TTL */
+export declare const NOTIFICATION_TTL_SECONDS: number;
+/**
+ * Notifications service error message constants
+ */
+export declare const NOTIFICATIONS_ERROR_MESSAGES: {
+    readonly NOTIFICATION_NOT_FOUND: (notificationId: string) => string;
+    readonly UNAUTHORIZED: (action: string) => string;
+    readonly INVALID_NOTIFICATION_TYPE: (type: string) => string;
+    readonly CREATE_FAILED: (reason: string) => string;
+    readonly UPDATE_FAILED: (reason: string) => string;
+};
+/** React Query key factory for notifications */
+export declare const NOTIFICATIONS_QUERY_KEYS: {
+    readonly all: readonly ["notifications"];
+    readonly lists: () => readonly ["notifications", "list"];
+    readonly list: (filters: Record<string, unknown>) => readonly ["notifications", "list", Record<string, unknown>];
+    readonly unreadCount: () => readonly ["notifications", "unread-count"];
+    readonly detail: (id: string) => readonly ["notifications", "detail", string];
+};
+//# sourceMappingURL=notifications.constants.d.ts.map

package/dist/notifications/notifications.constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.constants.d.ts","sourceRoot":"","sources":["../../lib/notifications/notifications.constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAGL,KAAK,UAAU,EAKhB,MAAM,cAAc,CAAC;AAMtB,6CAA6C;AAC7C,eAAO,MAAM,0BAA0B,uBAAuB,CAAC;AAM/D,mCAAmC;AACnC,eAAO,MAAM,kBAAkB;;;;;;;CAOrB,CAAC;AAEX,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,OAAO,kBAAkB,CAAC,CAAC;AAE5F,6EAA6E;AAC7E,eAAO,MAAM,wBAAwB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,CAU5F,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,yBAAyB;;;CAG5B,CAAC;AAEX,MAAM,MAAM,sBAAsB,GAChC,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,OAAO,yBAAyB,CAAC,CAAC;AAM7E,2DAA2D;AAC3D,eAAO,MAAM,mBAAmB;;;;;;;;CAQtB,CAAC;AAMX,+CAA+C;AAC/C,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C,8DAA8D;AAC9D,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAM3C,8EAA8E;AAC9E,eAAO,MAAM,2BAA2B,QACoC,CAAC;AAM7E,2CAA2C;AAC3C,eAAO,MAAM,gBAAgB,MAAM,CAAC;AAEpC,6CAA6C;AAC7C,eAAO,MAAM,kBAAkB,MAAM,CAAC;AAEtC,yCAAyC;AACzC,eAAO,MAAM,cAAc,OAAO,CAAC;AAMnC,uGAAuG;AACvG,eAAO,MAAM,6BAA6B,QACoB,CAAC;AAE/D,+CAA+C;AAC/C,eAAO,MAAM,wBAAwB,QAA+C,CAAC;AAMrF;;GAEG;AACH,eAAO,MAAM,4BAA4B;sDACE,MAAM;oCAExB,MAAM;+CACK,MAAM;qCAEhB,MAAM;qCACN,MAAM;CACtB,CAAC;AAMX,gDAAgD;AAChD,eAAO,MAAM,wBAAwB;;;6BAGnB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;;0BAG1B,MAAM;CACX,CAAC"}

package/dist/notifications/notifications.constants.js

@@ -0,0 +1,104 @@
+/**
+ * Notifications Service Constants
+ */
+import { AtSign, FilePlus, MessageSquare, Pencil, RefreshCw, UserCheck, } from "lucide-react";
+// ============================================================================
+// API Configuration
+// ============================================================================
+/** Default API endpoint for notifications */
+export const NOTIFICATIONS_API_ENDPOINT = "/api/notifications";
+// ============================================================================
+// Notification Types
+// ============================================================================
+/** Supported notification types */
+export const NOTIFICATION_TYPES = {
+    MENTION: "mention",
+    REPLY: "reply",
+    FEEDBACK_CREATED: "feedback_created",
+    FEEDBACK_STATUS_CHANGED: "feedback_status_changed",
+    FEEDBACK_ASSIGNED: "feedback_assigned",
+    FEEDBACK_UPDATED: "feedback_updated",
+};
+/** Mapping of notification types to their icons and colors for UI display */
+export const NOTIFICATION_TYPE_CONFIG = {
+    [NOTIFICATION_TYPES.MENTION]: { icon: AtSign, className: "bg-blue-500 text-white" },
+    [NOTIFICATION_TYPES.REPLY]: { icon: MessageSquare, className: "bg-green-500 text-white" },
+    [NOTIFICATION_TYPES.FEEDBACK_CREATED]: { icon: FilePlus, className: "bg-purple-500 text-white" },
+    [NOTIFICATION_TYPES.FEEDBACK_STATUS_CHANGED]: {
+        icon: RefreshCw,
+        className: "bg-orange-500 text-white",
+    },
+    [NOTIFICATION_TYPES.FEEDBACK_ASSIGNED]: { icon: UserCheck, className: "bg-teal-500 text-white" },
+    [NOTIFICATION_TYPES.FEEDBACK_UPDATED]: { icon: Pencil, className: "bg-amber-500 text-white" },
+};
+/** Supported notification source types */
+export const NOTIFICATION_SOURCE_TYPES = {
+    COMMENT: "comment",
+    FEEDBACK: "feedback",
+};
+// ============================================================================
+// Notification Titles
+// ============================================================================
+/** Notification titles for different notification types */
+export const NOTIFICATION_TITLES = {
+    MENTION: "New Mention",
+    REPLY: "New Reply",
+    FEEDBACK_ASSIGNED: "New Feedback Assigned",
+    FEEDBACK_REASSIGNED: "Feedback Assigned to You",
+    FEEDBACK_STATUS_CHANGED: "Feedback Status Updated",
+    FEEDBACK_UPDATED: "Feedback Updated",
+    FEEDBACK_CREATED: "New Feedback Created",
+};
+// ============================================================================
+// Pagination
+// ============================================================================
+/** Default number of notifications to fetch */
+export const DEFAULT_NOTIFICATIONS_LIMIT = 20;
+/** Maximum number of notifications to fetch in one request */
+export const MAX_NOTIFICATIONS_LIMIT = 100;
+// ============================================================================
+// Polling Configuration
+// ============================================================================
+/** Default polling interval for notifications in milliseconds (30 seconds) */
+export const DEFAULT_POLLING_INTERVAL_MS = parseInt(process.env.NOTIFICATIONS_POLLING_INTERVAL_MS || "", 10) || 30000;
+// ============================================================================
+// Content Limits
+// ============================================================================
+/** Maximum length of notification title */
+export const MAX_TITLE_LENGTH = 100;
+/** Maximum length of notification message */
+export const MAX_MESSAGE_LENGTH = 500;
+/** Maximum length of notification URL */
+export const MAX_URL_LENGTH = 2000;
+// ============================================================================
+// TTL (Time To Live) Configuration
+// ============================================================================
+/** Default TTL for notifications in days (90 days). Server-side only - no need to expose to client. */
+export const DEFAULT_NOTIFICATION_TTL_DAYS = parseInt(process.env.NOTIFICATIONS_TTL_DAYS || "", 10) || 90;
+/** Convert days to seconds for DynamoDB TTL */
+export const NOTIFICATION_TTL_SECONDS = DEFAULT_NOTIFICATION_TTL_DAYS * 24 * 60 * 60;
+// ============================================================================
+// Error Messages
+// ============================================================================
+/**
+ * Notifications service error message constants
+ */
+export const NOTIFICATIONS_ERROR_MESSAGES = {
+    NOTIFICATION_NOT_FOUND: (notificationId) => `Notification with ID '${notificationId}' not found`,
+    UNAUTHORIZED: (action) => `You are not authorized to ${action}`,
+    INVALID_NOTIFICATION_TYPE: (type) => `Invalid notification type '${type}'. Allowed types: mention, reply, feedback_created, feedback_status_changed, feedback_assigned, feedback_updated`,
+    CREATE_FAILED: (reason) => `Failed to create notification: ${reason}`,
+    UPDATE_FAILED: (reason) => `Failed to update notification: ${reason}`,
+};
+// ============================================================================
+// React Query Keys
+// ============================================================================
+/** React Query key factory for notifications */
+export const NOTIFICATIONS_QUERY_KEYS = {
+    all: ["notifications"],
+    lists: () => [...NOTIFICATIONS_QUERY_KEYS.all, "list"],
+    list: (filters) => [...NOTIFICATIONS_QUERY_KEYS.lists(), filters],
+    unreadCount: () => [...NOTIFICATIONS_QUERY_KEYS.all, "unread-count"],
+    detail: (id) => [...NOTIFICATIONS_QUERY_KEYS.all, "detail", id],
+};
+//# sourceMappingURL=notifications.constants.js.map

package/dist/notifications/notifications.constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.constants.js","sourceRoot":"","sources":["../../lib/notifications/notifications.constants.ts"],"names":[],"mappings":"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"}

package/dist/notifications/notifications.errors.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Notifications Service Error Classes
+ */
+import { ForbiddenError, InternalServerError, NotFoundError, ValidationError } from "../shared/services/services.errors";
+/**
+ * Notification not found error
+ */
+export declare class NotificationNotFoundError extends NotFoundError {
+    constructor(notificationId: string);
+}
+/**
+ * Unauthorized access to notification
+ */
+export declare class NotificationUnauthorizedError extends ForbiddenError {
+    constructor(action: string);
+}
+/**
+ * Invalid notification type error
+ */
+export declare class InvalidNotificationTypeError extends ValidationError {
+    constructor(type: string);
+}
+/**
+ * Notification creation failed error
+ */
+export declare class NotificationCreateError extends InternalServerError {
+    constructor(reason: string);
+}
+/**
+ * Notification update failed error
+ */
+export declare class NotificationUpdateError extends InternalServerError {
+    constructor(reason: string);
+}
+//# sourceMappingURL=notifications.errors.d.ts.map

package/dist/notifications/notifications.errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.errors.d.ts","sourceRoot":"","sources":["../../lib/notifications/notifications.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,EAChB,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,aAAa;gBAC9C,cAAc,EAAE,MAAM;CAInC;AAED;;GAEG;AACH,qBAAa,6BAA8B,SAAQ,cAAc;gBACnD,MAAM,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,qBAAa,4BAA6B,SAAQ,eAAe;gBACnD,IAAI,EAAE,MAAM;CAIzB;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;gBAClD,MAAM,EAAE,MAAM;CAI3B;AAED;;GAEG;AACH,qBAAa,uBAAwB,SAAQ,mBAAmB;gBAClD,MAAM,EAAE,MAAM;CAI3B"}

package/dist/notifications/notifications.errors.js

@@ -0,0 +1,51 @@
+/**
+ * Notifications Service Error Classes
+ */
+import { NOTIFICATIONS_ERROR_MESSAGES } from "./notifications.constants";
+import { ForbiddenError, InternalServerError, NotFoundError, ValidationError, } from "../shared/services/services.errors";
+/**
+ * Notification not found error
+ */
+export class NotificationNotFoundError extends NotFoundError {
+    constructor(notificationId) {
+        super(NOTIFICATIONS_ERROR_MESSAGES.NOTIFICATION_NOT_FOUND(notificationId));
+        this.name = "NotificationNotFoundError";
+    }
+}
+/**
+ * Unauthorized access to notification
+ */
+export class NotificationUnauthorizedError extends ForbiddenError {
+    constructor(action) {
+        super(NOTIFICATIONS_ERROR_MESSAGES.UNAUTHORIZED(action));
+        this.name = "NotificationUnauthorizedError";
+    }
+}
+/**
+ * Invalid notification type error
+ */
+export class InvalidNotificationTypeError extends ValidationError {
+    constructor(type) {
+        super(NOTIFICATIONS_ERROR_MESSAGES.INVALID_NOTIFICATION_TYPE(type));
+        this.name = "InvalidNotificationTypeError";
+    }
+}
+/**
+ * Notification creation failed error
+ */
+export class NotificationCreateError extends InternalServerError {
+    constructor(reason) {
+        super(NOTIFICATIONS_ERROR_MESSAGES.CREATE_FAILED(reason));
+        this.name = "NotificationCreateError";
+    }
+}
+/**
+ * Notification update failed error
+ */
+export class NotificationUpdateError extends InternalServerError {
+    constructor(reason) {
+        super(NOTIFICATIONS_ERROR_MESSAGES.UPDATE_FAILED(reason));
+        this.name = "NotificationUpdateError";
+    }
+}
+//# sourceMappingURL=notifications.errors.js.map

package/dist/notifications/notifications.errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.errors.js","sourceRoot":"","sources":["../../lib/notifications/notifications.errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,4BAA4B,EAAE,MAAM,6CAA6C,CAAC;AAC3F,OAAO,EACL,cAAc,EACd,mBAAmB,EACnB,aAAa,EACb,eAAe,GAChB,MAAM,uCAAuC,CAAC;AAE/C;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,aAAa;IAC1D,YAAY,cAAsB;QAChC,KAAK,CAAC,4BAA4B,CAAC,sBAAsB,CAAC,cAAc,CAAC,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,6BAA8B,SAAQ,cAAc;IAC/D,YAAY,MAAc;QACxB,KAAK,CAAC,4BAA4B,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,+BAA+B,CAAC;IAC9C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,4BAA6B,SAAQ,eAAe;IAC/D,YAAY,IAAY;QACtB,KAAK,CAAC,4BAA4B,CAAC,yBAAyB,CAAC,IAAI,CAAC,CAAC,CAAC;QACpE,IAAI,CAAC,IAAI,GAAG,8BAA8B,CAAC;IAC7C,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAC9D,YAAY,MAAc;QACxB,KAAK,CAAC,4BAA4B,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,uBAAwB,SAAQ,mBAAmB;IAC9D,YAAY,MAAc;QACxB,KAAK,CAAC,4BAA4B,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;QAC1D,IAAI,CAAC,IAAI,GAAG,yBAAyB,CAAC;IACxC,CAAC;CACF"}

package/dist/notifications/notifications.interfaces.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Notifications Module Interfaces
+ *
+ * Contains all interfaces related to the notifications system:
+ * - Core notification types (derived from schema)
+ * - Service operation parameters
+ * - API response types
+ */
+import { NotificationsTableSchema } from "../db/schemas";
+import type { CreateNotificationSchemaInput, DismissNotificationSchemaInput, GetUnreadCountSchemaInput, ListNotificationsSchemaInput, MarkAllAsReadSchemaInput, MarkAsReadSchemaInput, NotificationEntity } from "./notifications.schemas";
+import { DynamoDbService } from "../shared/services/dynamodb";
+import type { Logger } from "../shared/services/logger";
+import type { UserAwsCredentials } from "../shared/services/services.interfaces";
+/**
+ * Core notification entity - derived from schema (single source of truth)
+ * Includes base entity fields (id, createdAt, updatedAt, createdById, modifiedById)
+ */
+export type Notification = NotificationEntity;
+/**
+ * Options for notification service operations
+ */
+export interface NotificationsOperationOptions {
+    /** AWS credentials for user-scoped access */
+    userCredentials?: UserAwsCredentials;
+}
+/**
+ * Parameters for creating a single notification - derived from schema (single source of truth)
+ */
+export type CreateNotificationParams = CreateNotificationSchemaInput;
+/**
+ * Parameters for listing notifications - derived from schema (single source of truth)
+ */
+export type ListNotificationsParams = ListNotificationsSchemaInput;
+/**
+ * Parameters for getting unread count - derived from schema (single source of truth)
+ */
+export type GetUnreadCountParams = GetUnreadCountSchemaInput;
+/**
+ * Parameters for marking a notification as read - derived from schema (single source of truth)
+ */
+export type MarkAsReadParams = MarkAsReadSchemaInput;
+/**
+ * Parameters for marking all notifications as read - derived from schema (single source of truth)
+ */
+export type MarkAllAsReadParams = MarkAllAsReadSchemaInput;
+/**
+ * Parameters for dismissing a notification - derived from schema (single source of truth)
+ */
+export type DismissNotificationParams = DismissNotificationSchemaInput;
+/**
+ * Paginated notifications data (used by service)
+ */
+export interface PaginatedNotifications {
+    /** Array of notifications */
+    notifications: Notification[];
+    /** Pagination cursor for next page */
+    nextCursor?: string;
+}
+/**
+ * Configuration for NotificationsService
+ */
+export interface NotificationsServiceConfig {
+    /** Override table name (defaults to TABLES.notifications) */
+    tableName?: string;
+    /** Default page size for list operations */
+    defaultPageSize?: number;
+}
+/**
+ * Options for the notifications API hook
+ */
+export interface UseNotificationsApiOptions {
+    /** Maximum number of notifications to fetch */
+    limit?: number;
+    /** Enable polling for notifications */
+    enablePolling?: boolean;
+    /** Polling interval in milliseconds */
+    pollingInterval?: number;
+    /** Only fetch unread notifications */
+    unreadOnly?: boolean;
+}
+/**
+ * Props for the notification container
+ */
+export interface NotificationContainerProps {
+    /** Maximum number of notifications to show initially */
+    notificationsLimit?: number;
+    /** Polling interval in milliseconds (default: 30000) */
+    pollingInterval?: number;
+    /** Whether to enable polling (default: true) */
+    enablePolling?: boolean;
+}
+/**
+ * Parameters for fetching notifications
+ */
+export interface FetchNotificationsParams {
+    /** Maximum number of notifications to return */
+    limit?: number;
+    /** Pagination cursor */
+    cursor?: string;
+    /** Only return unread notifications */
+    unreadOnly?: boolean;
+    /** Include dismissed notifications */
+    includeDismissed?: boolean;
+}
+/**
+ * Dependencies for NotificationsService
+ */
+export interface NotificationsServiceDependencies {
+    /** Logger instance */
+    logger?: Logger;
+    /** DynamoDB service instance */
+    dynamoDb?: DynamoDbService<NotificationsTableSchema>;
+    /** Service configuration */
+    config?: NotificationsServiceConfig;
+}
+//# sourceMappingURL=notifications.interfaces.d.ts.map

package/dist/notifications/notifications.interfaces.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.interfaces.d.ts","sourceRoot":"","sources":["../../lib/notifications/notifications.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,KAAK,EACV,6BAA6B,EAC7B,8BAA8B,EAC9B,yBAAyB,EACzB,4BAA4B,EAC5B,wBAAwB,EACxB,qBAAqB,EACrB,kBAAkB,EACnB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,2CAA2C,CAAC;AAMpF;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG,kBAAkB,CAAC;AAM9C;;GAEG;AACH,MAAM,WAAW,6BAA6B;IAC5C,6CAA6C;IAC7C,eAAe,CAAC,EAAE,kBAAkB,CAAC;CACtC;AAED;;GAEG;AACH,MAAM,MAAM,wBAAwB,GAAG,6BAA6B,CAAC;AAErE;;GAEG;AACH,MAAM,MAAM,uBAAuB,GAAG,4BAA4B,CAAC;AAEnE;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,yBAAyB,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,qBAAqB,CAAC;AAErD;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,wBAAwB,CAAC;AAE3D;;GAEG;AACH,MAAM,MAAM,yBAAyB,GAAG,8BAA8B,CAAC;AAMvE;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,6BAA6B;IAC7B,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,sCAAsC;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAMD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,6DAA6D;IAC7D,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4CAA4C;IAC5C,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,+CAA+C;IAC/C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,uCAAuC;IACvC,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sCAAsC;IACtC,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wDAAwD;IACxD,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,wDAAwD;IACxD,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,gDAAgD;IAChD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED;;GAEG;AACH,MAAM,WAAW,wBAAwB;IACvC,gDAAgD;IAChD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,uCAAuC;IACvC,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,sCAAsC;IACtC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C,sBAAsB;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,gCAAgC;IAChC,QAAQ,CAAC,EAAE,eAAe,CAAC,wBAAwB,CAAC,CAAC;IACrD,4BAA4B;IAC5B,MAAM,CAAC,EAAE,0BAA0B,CAAC;CACrC"}

package/dist/notifications/notifications.interfaces.js

@@ -0,0 +1,10 @@
+/**
+ * Notifications Module Interfaces
+ *
+ * Contains all interfaces related to the notifications system:
+ * - Core notification types (derived from schema)
+ * - Service operation parameters
+ * - API response types
+ */
+export {};
+//# sourceMappingURL=notifications.interfaces.js.map

package/dist/notifications/notifications.interfaces.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.interfaces.js","sourceRoot":"","sources":["../../lib/notifications/notifications.interfaces.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

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

@@ -0,0 +1,139 @@
+/**
+ * Notifications Zod Schemas
+ *
+ * Validation schemas for notifications operations.
+ */
+import { z } from "zod";
+/** Notification type enum schema */
+export declare const notificationTypeSchema: z.ZodEnum<{
+    mention: "mention";
+    reply: "reply";
+    feedback_created: "feedback_created";
+    feedback_status_changed: "feedback_status_changed";
+    feedback_assigned: "feedback_assigned";
+    feedback_updated: "feedback_updated";
+}>;
+/** Notification source type enum schema */
+export declare const notificationSourceTypeSchema: z.ZodEnum<{
+    feedback: "feedback";
+    comment: "comment";
+}>;
+/**
+ * Schema for creating a notification
+ */
+export declare const createNotificationSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+    type: z.ZodEnum<{
+        mention: "mention";
+        reply: "reply";
+        feedback_created: "feedback_created";
+        feedback_status_changed: "feedback_status_changed";
+        feedback_assigned: "feedback_assigned";
+        feedback_updated: "feedback_updated";
+    }>;
+    title: z.ZodString;
+    message: z.ZodString;
+    url: z.ZodString;
+    actorId: z.ZodString;
+    actorName: z.ZodString;
+    entityId: z.ZodString;
+    entityType: z.ZodString;
+    sourceId: z.ZodString;
+    sourceType: z.ZodEnum<{
+        feedback: "feedback";
+        comment: "comment";
+    }>;
+}, z.core.$strip>;
+export type CreateNotificationSchemaInput = z.infer<typeof createNotificationSchema>;
+/**
+ * Schema for listing notifications (query parameters)
+ */
+export declare const listNotificationsSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+    limit: z.ZodOptional<z.ZodDefault<z.ZodCoercedNumber<unknown>>>;
+    cursor: z.ZodOptional<z.ZodString>;
+    unreadOnly: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>]>>>;
+    includeDismissed: z.ZodOptional<z.ZodDefault<z.ZodUnion<readonly [z.ZodBoolean, z.ZodPipe<z.ZodEnum<{
+        true: "true";
+        false: "false";
+    }>, z.ZodTransform<boolean, "true" | "false">>]>>>;
+}, z.core.$strip>;
+export type ListNotificationsSchemaInput = z.infer<typeof listNotificationsSchema>;
+/**
+ * Schema for getting unread count
+ */
+export declare const getUnreadCountSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type GetUnreadCountSchemaInput = z.infer<typeof getUnreadCountSchema>;
+/**
+ * Schema for marking a notification as read
+ */
+export declare const markAsReadSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+    notificationId: z.ZodString;
+}, z.core.$strip>;
+export type MarkAsReadSchemaInput = z.infer<typeof markAsReadSchema>;
+/**
+ * Schema for marking all notifications as read
+ */
+export declare const markAllAsReadSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+}, z.core.$strip>;
+export type MarkAllAsReadSchemaInput = z.infer<typeof markAllAsReadSchema>;
+/**
+ * Schema for dismissing a notification
+ */
+export declare const dismissNotificationSchema: z.ZodObject<{
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+    notificationId: z.ZodString;
+}, z.core.$strip>;
+export type DismissNotificationSchemaInput = z.infer<typeof dismissNotificationSchema>;
+/**
+ * Full notification entity schema (for validation/transformation)
+ * Extends baseEntitySchema for consistent id, timestamps, and audit fields.
+ */
+export declare const notificationEntitySchema: z.ZodObject<{
+    id: z.ZodString;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    createdById: z.ZodString;
+    modifiedById: z.ZodOptional<z.ZodString>;
+    tenantId: z.ZodString;
+    userId: z.ZodString;
+    type: z.ZodEnum<{
+        mention: "mention";
+        reply: "reply";
+        feedback_created: "feedback_created";
+        feedback_status_changed: "feedback_status_changed";
+        feedback_assigned: "feedback_assigned";
+        feedback_updated: "feedback_updated";
+    }>;
+    title: z.ZodString;
+    message: z.ZodString;
+    read: z.ZodBoolean;
+    isDismissed: z.ZodBoolean;
+    url: z.ZodString;
+    actorId: z.ZodString;
+    actorName: z.ZodString;
+    entityId: z.ZodString;
+    entityType: z.ZodString;
+    sourceId: z.ZodString;
+    sourceType: z.ZodEnum<{
+        feedback: "feedback";
+        comment: "comment";
+    }>;
+    ttl: z.ZodNumber;
+}, z.core.$strip>;
+/** Notification entity type derived from schema */
+export type NotificationEntity = z.infer<typeof notificationEntitySchema>;
+//# sourceMappingURL=notifications.schemas.d.ts.map

package/dist/notifications/notifications.schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.schemas.d.ts","sourceRoot":"","sources":["../../lib/notifications/notifications.schemas.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAYH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAMxB,oCAAoC;AACpC,eAAO,MAAM,sBAAsB;;;;;;;EAOjC,CAAC;AAEH,2CAA2C;AAC3C,eAAO,MAAM,4BAA4B;;;EAGvC,CAAC;AAMH;;GAEG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;iBAyBnC,CAAC;AAEH,MAAM,MAAM,6BAA6B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC;AAMrF;;GAEG;AACH,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;iBAmBlC,CAAC;AAEH,MAAM,MAAM,4BAA4B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAMnF;;GAEG;AACH,eAAO,MAAM,oBAAoB;;;iBAG/B,CAAC;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAM7E;;GAEG;AACH,eAAO,MAAM,gBAAgB;;;;iBAI3B,CAAC;AAEH,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAMrE;;GAEG;AACH,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AAEH,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAM3E;;GAEG;AACH,eAAO,MAAM,yBAAyB;;;;iBAIpC,CAAC;AAEH,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAMvF;;;GAGG;AACH,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAiCgB,CAAC;AAEtD,mDAAmD;AACnD,MAAM,MAAM,kBAAkB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,wBAAwB,CAAC,CAAC"}