captify 0.1.18 → 1.1.0

package/dist/notifications/notifications.schemas.js

@@ -0,0 +1,167 @@
+/**
+ * Notifications Zod Schemas
+ *
+ * Validation schemas for notifications operations.
+ */
+import { DEFAULT_NOTIFICATIONS_LIMIT, MAX_MESSAGE_LENGTH, MAX_NOTIFICATIONS_LIMIT, MAX_TITLE_LENGTH, MAX_URL_LENGTH, NOTIFICATION_SOURCE_TYPES, NOTIFICATION_TYPES, } from "./notifications.constants";
+import { baseEntitySchema } from "../shared/shared.schemas";
+import { z } from "zod";
+// ============================================================================
+// Base Schemas
+// ============================================================================
+/** Notification type enum schema */
+export const notificationTypeSchema = z.enum([
+    NOTIFICATION_TYPES.MENTION,
+    NOTIFICATION_TYPES.REPLY,
+    NOTIFICATION_TYPES.FEEDBACK_CREATED,
+    NOTIFICATION_TYPES.FEEDBACK_STATUS_CHANGED,
+    NOTIFICATION_TYPES.FEEDBACK_ASSIGNED,
+    NOTIFICATION_TYPES.FEEDBACK_UPDATED,
+]);
+/** Notification source type enum schema */
+export const notificationSourceTypeSchema = z.enum([
+    NOTIFICATION_SOURCE_TYPES.COMMENT,
+    NOTIFICATION_SOURCE_TYPES.FEEDBACK,
+]);
+// ============================================================================
+// Create Notification Schema
+// ============================================================================
+/**
+ * Schema for creating a notification
+ */
+export const createNotificationSchema = z.object({
+    tenantId: z.string().trim().min(1, "Tenant ID is required"),
+    userId: z.string().trim().min(1, "User ID is required"),
+    type: notificationTypeSchema,
+    title: z
+        .string()
+        .trim()
+        .min(1, "Title is required")
+        .max(MAX_TITLE_LENGTH, `Title must be at most ${MAX_TITLE_LENGTH} characters`),
+    message: z
+        .string()
+        .trim()
+        .min(1, "Message is required")
+        .max(MAX_MESSAGE_LENGTH, `Message must be at most ${MAX_MESSAGE_LENGTH} characters`),
+    url: z
+        .string()
+        .trim()
+        .min(1, "URL is required")
+        .max(MAX_URL_LENGTH, `URL must be at most ${MAX_URL_LENGTH} characters`),
+    actorId: z.string().trim().min(1, "Actor ID is required"),
+    actorName: z.string().trim().min(1, "Actor name is required"),
+    entityId: z.string().trim().min(1, "Entity ID is required"),
+    entityType: z.string().trim().min(1, "Entity type is required"),
+    sourceId: z.string().trim().min(1, "Source ID is required"),
+    sourceType: notificationSourceTypeSchema,
+});
+// ============================================================================
+// List Notifications Schema
+// ============================================================================
+/**
+ * Schema for listing notifications (query parameters)
+ */
+export const listNotificationsSchema = z.object({
+    tenantId: z.string().trim().min(1, "Tenant ID is required"),
+    userId: z.string().trim().min(1, "User ID is required"),
+    limit: z.coerce
+        .number()
+        .int()
+        .min(1)
+        .max(MAX_NOTIFICATIONS_LIMIT)
+        .default(DEFAULT_NOTIFICATIONS_LIMIT)
+        .optional(),
+    cursor: z.string().optional(),
+    unreadOnly: z
+        .union([z.boolean(), z.enum(["true", "false"]).transform((val) => val === "true")])
+        .default(false)
+        .optional(),
+    includeDismissed: z
+        .union([z.boolean(), z.enum(["true", "false"]).transform((val) => val === "true")])
+        .default(false)
+        .optional(),
+});
+// ============================================================================
+// Get Unread Count Schema
+// ============================================================================
+/**
+ * Schema for getting unread count
+ */
+export const getUnreadCountSchema = z.object({
+    tenantId: z.string().trim().min(1, "Tenant ID is required"),
+    userId: z.string().trim().min(1, "User ID is required"),
+});
+// ============================================================================
+// Mark as Read Schema
+// ============================================================================
+/**
+ * Schema for marking a notification as read
+ */
+export const markAsReadSchema = z.object({
+    tenantId: z.string().trim().min(1, "Tenant ID is required"),
+    userId: z.string().trim().min(1, "User ID is required"),
+    notificationId: z.string().trim().min(1, "Notification ID is required"),
+});
+// ============================================================================
+// Mark All as Read Schema
+// ============================================================================
+/**
+ * Schema for marking all notifications as read
+ */
+export const markAllAsReadSchema = z.object({
+    tenantId: z.string().trim().min(1, "Tenant ID is required"),
+    userId: z.string().trim().min(1, "User ID is required"),
+});
+// ============================================================================
+// Dismiss Notification Schema
+// ============================================================================
+/**
+ * Schema for dismissing a notification
+ */
+export const dismissNotificationSchema = z.object({
+    tenantId: z.string().trim().min(1, "Tenant ID is required"),
+    userId: z.string().trim().min(1, "User ID is required"),
+    notificationId: z.string().trim().min(1, "Notification ID is required"),
+});
+// ============================================================================
+// Notification Entity Schema
+// ============================================================================
+/**
+ * Full notification entity schema (for validation/transformation)
+ * Extends baseEntitySchema for consistent id, timestamps, and audit fields.
+ */
+export const notificationEntitySchema = baseEntitySchema
+    .extend({
+    /** Tenant ID for multi-tenancy */
+    tenantId: z.string(),
+    /** User ID of the notification recipient */
+    userId: z.string(),
+    /** Type of notification */
+    type: notificationTypeSchema,
+    /** Notification title (e.g., "New Mention") */
+    title: z.string(),
+    /** Notification message (e.g., "John mentioned you in a comment") */
+    message: z.string(),
+    /** Whether the notification has been read */
+    read: z.boolean(),
+    /** Whether the notification has been dismissed (soft delete) */
+    isDismissed: z.boolean(),
+    /** URL to navigate to when notification is clicked */
+    url: z.string(),
+    /** User ID of the actor who triggered the notification */
+    actorId: z.string(),
+    /** Display name of the actor (denormalized) */
+    actorName: z.string(),
+    /** Entity ID where the action occurred (e.g., document ID) */
+    entityId: z.string(),
+    /** Entity type where the action occurred (e.g., "document", "task") */
+    entityType: z.string(),
+    /** Source ID that triggered this notification (e.g., comment ID) */
+    sourceId: z.string(),
+    /** Source type that triggered this notification */
+    sourceType: notificationSourceTypeSchema,
+    /** TTL timestamp for auto-expiry (Unix seconds) - DynamoDB will auto-delete after this time */
+    ttl: z.number().int().nonnegative(),
+})
+    .describe("Notification entity stored in DynamoDB");
+//# sourceMappingURL=notifications.schemas.js.map

package/dist/notifications/notifications.schemas.js.map

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

package/dist/notifications/services/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Notifications Services
+ */
+export { getNotificationsService, resetNotificationsService, } from "./notifications.factory";
+export { NotificationsService } from "./notifications.service";
+//# sourceMappingURL=index.d.ts.map

package/dist/notifications/services/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/notifications/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/notifications/services/index.js

@@ -0,0 +1,6 @@
+/**
+ * Notifications Services
+ */
+export { getNotificationsService, resetNotificationsService, } from "./notifications.factory";
+export { NotificationsService } from "./notifications.service";
+//# sourceMappingURL=index.js.map

package/dist/notifications/services/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/notifications/services/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,oDAAoD,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC"}

package/dist/notifications/services/notifications.factory.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Notifications Service Factory
+ *
+ * Factory for creating NotificationsService instances.
+ */
+import type { NotificationsServiceDependencies } from "../notifications.interfaces";
+import { NotificationsService } from "./notifications.service";
+/**
+ * Get or create a NotificationsService instance
+ *
+ * @param deps - Optional dependencies for testing/customization
+ * @returns NotificationsService instance
+ */
+export declare function getNotificationsService(deps?: NotificationsServiceDependencies): NotificationsService;
+/**
+ * Reset the singleton instance (for testing)
+ */
+export declare function resetNotificationsService(): void;
+//# sourceMappingURL=notifications.factory.d.ts.map

package/dist/notifications/services/notifications.factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.factory.d.ts","sourceRoot":"","sources":["../../../lib/notifications/services/notifications.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,KAAK,EAAE,gCAAgC,EAAE,MAAM,8CAA8C,CAAC;AACrG,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAsB1F;;;;;GAKG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,CAAC,EAAE,gCAAgC,GACtC,oBAAoB,CA4BtB;AAED;;GAEG;AACH,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/dist/notifications/services/notifications.factory.js

@@ -0,0 +1,58 @@
+/**
+ * Notifications Service Factory
+ *
+ * Factory for creating NotificationsService instances.
+ */
+import { NotificationsService } from "./notifications.service";
+import { DynamoDbInstances } from "../../shared/services/dynamodb";
+import { LoggerFactory } from "../../shared/services/logger";
+import { TABLES } from "../../shared/shared.constants";
+// ============================================================================
+// Service Dependencies (for testing)
+// ============================================================================
+/**
+ * Dependencies that can be injected for testing
+ */
+// ============================================================================
+// Singleton Factory
+// ============================================================================
+/**
+ * Singleton instance of NotificationsService
+ */
+let notificationsServiceInstance = null;
+/**
+ * Get or create a NotificationsService instance
+ *
+ * @param deps - Optional dependencies for testing/customization
+ * @returns NotificationsService instance
+ */
+export function getNotificationsService(deps) {
+    var _a, _b, _c, _d;
+    if (!notificationsServiceInstance) {
+        const tableName = (_b = (_a = deps === null || deps === void 0 ? void 0 : deps.config) === null || _a === void 0 ? void 0 : _a.tableName) !== null && _b !== void 0 ? _b : TABLES.notifications;
+        const dynamoDb = (_c = deps === null || deps === void 0 ? void 0 : deps.dynamoDb) !== null && _c !== void 0 ? _c : DynamoDbInstances.getInstance(tableName);
+        // Create default logger for the service
+        const logger = (_d = deps === null || deps === void 0 ? void 0 : deps.logger) !== null && _d !== void 0 ? _d : LoggerFactory.createLogger({
+            serviceName: "NotificationsService",
+            userContext: {
+                userId: "system",
+                email: "system@captify.local",
+                name: "System",
+                roles: ["service"],
+            },
+        });
+        notificationsServiceInstance = new NotificationsService({
+            dynamoDb,
+            logger,
+            config: deps === null || deps === void 0 ? void 0 : deps.config,
+        });
+    }
+    return notificationsServiceInstance;
+}
+/**
+ * Reset the singleton instance (for testing)
+ */
+export function resetNotificationsService() {
+    notificationsServiceInstance = null;
+}
+//# sourceMappingURL=notifications.factory.js.map

package/dist/notifications/services/notifications.factory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.factory.js","sourceRoot":"","sources":["../../../lib/notifications/services/notifications.factory.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,OAAO,EAAE,oBAAoB,EAAE,MAAM,oDAAoD,CAAC;AAC1F,OAAO,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,MAAM,EAAE,MAAM,+BAA+B,CAAC;AAEvD,+EAA+E;AAC/E,qCAAqC;AACrC,+EAA+E;AAE/E;;GAEG;AAEH,+EAA+E;AAC/E,oBAAoB;AACpB,+EAA+E;AAE/E;;GAEG;AACH,IAAI,4BAA4B,GAAgC,IAAI,CAAC;AAErE;;;;;GAKG;AACH,MAAM,UAAU,uBAAuB,CACrC,IAAuC;;IAEvC,IAAI,CAAC,4BAA4B,EAAE,CAAC;QAClC,MAAM,SAAS,GAAG,MAAA,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,0CAAE,SAAS,mCAAI,MAAM,CAAC,aAAa,CAAC;QAElE,MAAM,QAAQ,GACZ,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,QAAQ,mCAAI,iBAAiB,CAAC,WAAW,CAA2B,SAAS,CAAC,CAAC;QAEvF,wCAAwC;QACxC,MAAM,MAAM,GACV,MAAA,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM,mCACZ,aAAa,CAAC,YAAY,CAAC;YACzB,WAAW,EAAE,sBAAsB;YACnC,WAAW,EAAE;gBACX,MAAM,EAAE,QAAQ;gBAChB,KAAK,EAAE,sBAAsB;gBAC7B,IAAI,EAAE,QAAQ;gBACd,KAAK,EAAE,CAAC,SAAS,CAAC;aACnB;SACF,CAAC,CAAC;QAEL,4BAA4B,GAAG,IAAI,oBAAoB,CAAC;YACtD,QAAQ;YACR,MAAM;YACN,MAAM,EAAE,IAAI,aAAJ,IAAI,uBAAJ,IAAI,CAAE,MAAM;SACrB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,4BAA4B,CAAC;AACtC,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,yBAAyB;IACvC,4BAA4B,GAAG,IAAI,CAAC;AACtC,CAAC"}

package/dist/notifications/services/notifications.service.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Notifications Service
+ *
+ * Core service for managing in-app notifications.
+ * Handles CRUD operations for notifications stored in DynamoDB.
+ */
+import type { CreateNotificationParams, DismissNotificationParams, GetUnreadCountParams, ListNotificationsParams, MarkAllAsReadParams, MarkAsReadParams, Notification, NotificationsOperationOptions, NotificationsServiceDependencies, PaginatedNotifications } from "../notifications.interfaces";
+import { BaseAwsService } from "../../shared/services/base-aws-service";
+export declare class NotificationsService extends BaseAwsService {
+    private readonly db;
+    private readonly defaultPageSize;
+    constructor(deps?: NotificationsServiceDependencies);
+    /**
+     * Create a single notification
+     *
+     * Includes deduplication check - if a notification already exists for the same
+     * (userId, sourceId, sourceType, type) combination, returns the existing one.
+     */
+    createNotification(params: CreateNotificationParams, options?: NotificationsOperationOptions): Promise<Notification>;
+    /**
+     * Create multiple notifications in bulk using DynamoDB BatchWrite
+     * More efficient than creating notifications one by one.
+     *
+     * Includes deduplication - skips notifications that already exist for the same
+     * (userId, sourceId, sourceType, type) combination.
+     */
+    createBulkNotifications(params: CreateNotificationParams[], options?: NotificationsOperationOptions): Promise<Notification[]>;
+    /**
+     * Build a notification document from validated params
+     *
+     * ID format: {createdAt}-{uuid} (e.g., "1704067200000-550e8400-e29b-41d4-a716-446655440000")
+     * This format allows direct SK reconstruction for efficient point lookups.
+     */
+    private buildNotificationDocument;
+    /**
+     * Parse notification ID to extract createdAt timestamp
+     *
+     * New format: {createdAt}-{uuid} -> returns createdAt
+     * Old format: {uuid} -> returns null (fallback to query)
+     */
+    private parseNotificationId;
+    /**
+     * List notifications for a user with pagination
+     */
+    listNotifications(params: ListNotificationsParams, options?: NotificationsOperationOptions): Promise<PaginatedNotifications>;
+    /**
+     * Get unread notification count for a user
+     */
+    getUnreadCount(params: GetUnreadCountParams, options?: NotificationsOperationOptions): Promise<number>;
+    /**
+     * Mark a notification as read
+     */
+    markAsRead(params: MarkAsReadParams, options?: NotificationsOperationOptions): Promise<Notification>;
+    /**
+     * Mark all notifications as read for a user
+     */
+    markAllAsRead(params: MarkAllAsReadParams, options?: NotificationsOperationOptions): Promise<number>;
+    /**
+     * Dismiss a notification (soft delete)
+     */
+    dismissNotification(params: DismissNotificationParams, options?: NotificationsOperationOptions): Promise<Notification>;
+    /**
+     * Dismiss all notifications for a user (bulk soft delete)
+     */
+    dismissAllNotifications(params: MarkAllAsReadParams, // Reuse same params (just tenantId + userId)
+    options?: NotificationsOperationOptions): Promise<number>;
+    /**
+     * Find an existing notification by source to prevent duplicates.
+     *
+     * Checks if a notification already exists for the same user, source, and type combination.
+     * This prevents duplicate notifications when the same action triggers multiple times.
+     *
+     * @returns The existing notification if found, null otherwise
+     */
+    private findExistingNotification;
+    /**
+     * Find a notification by ID using the most efficient method available.
+     *
+     * For new IDs (format: {createdAt}-{uuid}): Uses direct getItem (O(1) lookup)
+     * For old IDs (format: {uuid}): Falls back to query + filter (scans user's notifications)
+     */
+    private findNotificationById;
+    /**
+     * Convert DynamoDB item to Notification entity
+     */
+    private dynamoItemToNotification;
+}
+//# sourceMappingURL=notifications.service.d.ts.map

package/dist/notifications/services/notifications.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"notifications.service.d.ts","sourceRoot":"","sources":["../../../lib/notifications/services/notifications.service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAYH,OAAO,KAAK,EACV,wBAAwB,EACxB,yBAAyB,EACzB,oBAAoB,EACpB,uBAAuB,EACvB,mBAAmB,EACnB,gBAAgB,EAChB,YAAY,EACZ,6BAA6B,EAC7B,gCAAgC,EAChC,sBAAsB,EACvB,MAAM,8CAA8C,CAAC;AAStD,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AAKxE,qBAAa,oBAAqB,SAAQ,cAAc;IACtD,OAAO,CAAC,QAAQ,CAAC,EAAE,CAA4C;IAC/D,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,IAAI,GAAE,gCAAqC;IAevD;;;;;OAKG;IACG,kBAAkB,CACtB,MAAM,EAAE,wBAAwB,EAChC,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,YAAY,CAAC;IA4CxB;;;;;;OAMG;IACG,uBAAuB,CAC3B,MAAM,EAAE,wBAAwB,EAAE,EAClC,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,YAAY,EAAE,CAAC;IAkI1B;;;;;OAKG;IACH,OAAO,CAAC,yBAAyB;IAqCjC;;;;;OAKG;IACH,OAAO,CAAC,mBAAmB;IAiB3B;;OAEG;IACG,iBAAiB,CACrB,MAAM,EAAE,uBAAuB,EAC/B,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,sBAAsB,CAAC;IAkFlC;;OAEG;IACG,cAAc,CAClB,MAAM,EAAE,oBAAoB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,MAAM,CAAC;IA2ClB;;OAEG;IACG,UAAU,CACd,MAAM,EAAE,gBAAgB,EACxB,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,YAAY,CAAC;IAkDxB;;OAEG;IACG,aAAa,CACjB,MAAM,EAAE,mBAAmB,EAC3B,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,MAAM,CAAC;IA8ElB;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,yBAAyB,EACjC,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,YAAY,CAAC;IAiDxB;;OAEG;IACG,uBAAuB,CAC3B,MAAM,EAAE,mBAAmB,EAAE,6CAA6C;IAC1E,OAAO,CAAC,EAAE,6BAA6B,GACtC,OAAO,CAAC,MAAM,CAAC;IAgFlB;;;;;;;OAOG;YACW,wBAAwB;IAkCtC;;;;;OAKG;YACW,oBAAoB;IAsDlC;;OAEG;IACH,OAAO,CAAC,wBAAwB;CAwBjC"}