@messenger-box/platform-server 10.0.3-alpha.7 → 10.0.3-alpha.74

package/lib/templates/services/ReactionService.ts.template

@@ -1,7 +1,133 @@
-import { IReaction, IReactionInput } from 'common';
-import { IBaseService } from '@common-stack/store-mongo';
+/**
+ * Reaction Service Interface
+ * --------------------------
+ * 
+ * This interface defines the business logic layer for reaction management
+ * within the messenger platform. It provides comprehensive operations for handling
+ * emoji reactions, sentiment tracking, and user engagement features across
+ * posts, messages, and other interactive content.
+ * 
+ * Key capabilities:
+ * - Reaction lifecycle management (addition, removal, updates)
+ * - Emoji and custom reaction support
+ * - User reaction tracking and analytics
+ * - Reaction aggregation and statistics
+ * - Cross-platform reaction synchronization
+ * - Reaction notification management
+ * - Bulk reaction operations
+ * - Reaction validation and moderation
+ * 
+ * The service layer abstracts reaction operations and provides a cohesive API
+ * for engagement-related functionality throughout the messaging platform,
+ * handling user interactions, emotion tracking, and social engagement metrics.
+ */
 
+import { IBaseService, IReactionModel, IReactionInput, Disposable, AsDomainType } from 'common/server';
+
+/**
+ * Reaction Service Input Interface
+ * 
+ * @description Input parameters for reaction creation and management operations,
+ * including user context and reaction metadata.
+ */
 export interface IReactionServiceInput extends IReactionInput {
+    /** User identifier who is creating or managing the reaction */
     user: string;
 }
-export type IReactionService = IBaseService<IReaction, IReactionServiceInput, Partial<IReactionInput>>;
+
+/**
+ * Reaction Service Interface
+ * 
+ * @description Provides comprehensive reaction management capabilities
+ * including emoji reactions, user engagement tracking, and reaction analytics.
+ */
+export interface IReactionService extends IBaseService<IReactionModel, IReactionServiceInput, Partial<IReactionInput>>, Disposable {
+    /**
+     * Adds a reaction to a post or message
+     * 
+     * @description Creates a new reaction entry for a specific content item,
+     * handling duplicate detection and user validation.
+     * 
+     * @param {IReactionServiceInput} data - Reaction creation data including user and reaction type
+     * @returns {Promise<AsDomainType<IReactionModel> | Error>} - Created reaction or error
+     */
+    addReaction(data: IReactionServiceInput): Promise<AsDomainType<IReactionModel> | Error>;
+
+    /**
+     * Removes a reaction from a post or message
+     * 
+     * @description Deletes an existing reaction entry, ensuring proper user
+     * authorization and content validation.
+     * 
+     * @param {string} reactionId - The unique identifier of the reaction to remove
+     * @param {string} userId - The identifier of the user removing the reaction
+     * @returns {Promise<boolean | Error>} - Success status or error
+     */
+    removeReaction(reactionId: string, userId: string): Promise<boolean | Error>;
+
+    /**
+     * Retrieves all reactions for a specific content item
+     * 
+     * @description Fetches reaction data with aggregation and user information
+     * for display in the user interface.
+     * 
+     * @param {string} contentId - The identifier of the content (post, message, etc.)
+     * @param {string} contentType - The type of content being reacted to
+     * @returns {Promise<Array<AsDomainType<IReactionModel>> | Error>} - Array of reactions or error
+     */
+    getReactionsByContent(contentId: string, contentType: string): Promise<Array<AsDomainType<IReactionModel>> | Error>;
+
+    /**
+     * Retrieves reaction statistics for content
+     * 
+     * @description Provides aggregated reaction counts and statistics
+     * for analytics and display purposes.
+     * 
+     * @param {string} contentId - The identifier of the content
+     * @param {string} contentType - The type of content
+     * @returns {Promise<Record<string, any> | Error>} - Reaction statistics or error
+     */
+    getReactionStats(contentId: string, contentType: string): Promise<Record<string, any> | Error>;
+
+    /**
+     * Checks if a user has reacted to specific content
+     * 
+     * @description Determines whether a user has already reacted to
+     * a piece of content, useful for UI state management.
+     * 
+     * @param {string} contentId - The identifier of the content
+     * @param {string} userId - The identifier of the user
+     * @param {string} reactionType - The type of reaction to check
+     * @returns {Promise<boolean | Error>} - True if user has reacted, or error
+     */
+    hasUserReacted(contentId: string, userId: string, reactionType: string): Promise<boolean | Error>;
+
+    /**
+     * Updates an existing reaction
+     * 
+     * @description Modifies an existing reaction, typically changing
+     * the reaction type while maintaining the same user and content association.
+     * 
+     * @param {string} reactionId - The unique identifier of the reaction
+     * @param {Partial<IReactionInput>} updates - The reaction updates to apply
+     * @returns {Promise<AsDomainType<IReactionModel> | Error>} - Updated reaction or error
+     */
+    updateReaction(reactionId: string, updates: Partial<IReactionInput>): Promise<AsDomainType<IReactionModel> | Error>;
+
+    /**
+     * Removes all reactions from specific content
+     * 
+     * @description Bulk removes all reactions from a content item,
+     * typically used during content deletion or moderation.
+     * 
+     * @param {string} contentId - The identifier of the content
+     * @param {string} contentType - The type of content
+     * @returns {Promise<number | Error>} - Number of reactions removed or error
+     */
+    removeAllReactionsByContent(contentId: string, contentType: string): Promise<number | Error>;
+
+    /**
+     * Disposes of resources used by the service
+     */
+    dispose(): void;
+}

package/lib/templates/services/RedisCacheManager.ts.template

@@ -0,0 +1,22 @@
+import { DocumentNode } from '@apollo/client/index.js';
+
+export interface CacheContext {
+    userId?: string;
+    tenantId?: string;
+}
+export interface IRedisCacheManager {
+    get<T>(query: string | DocumentNode, variables: Record<string, any>, ctx?: CacheContext): Promise<T | null>;
+    set<T>(
+        query: string | DocumentNode,
+        variables: Record<string, any>,
+        data: T,
+        ctx?: CacheContext,
+        cachePolicy?: { maxAge: number; scope: string },
+    ): Promise<void>;
+    del(
+        query: string | DocumentNode,
+        variables?: Record<string, unknown>,
+        ctx?: CacheContext,
+        shouldRemoveAll?: boolean,
+    ): Promise<void>;
+}

package/lib/templates/services/SandboxErrorService.ts.template

@@ -0,0 +1,125 @@
+/**
+ * Sandbox Error Service Interface
+ * --------------------------------
+ *
+ * This interface defines the monitoring and reporting layer for sandbox runtime,
+ * build, and compilation errors during ephemeral development sessions.
+ *
+ * Key capabilities:
+ * - Start/stop intensive error monitoring for a sandbox
+ * - Detect compilation, build, server start, and runtime errors
+ * - Deduplicate and publish structured error events
+ * - Manual error reporting and test error generation
+ */
+
+/**
+ * Structured error payload captured from a sandbox
+ */
+// export interface ISandboxError {
+//     /** Unique error id */
+//     id: string;
+//     /** Project identifier that owns the sandbox */
+//     projectId: string;
+//     /** Sandbox identifier */
+//     sandboxId: string;
+//     /** Error classification, e.g. COMPILATION_ERROR, BUILD_ERROR */
+//     errorType: string;
+//     /** Human-readable error message */
+//     message: string;
+//     /** Optional stack trace if available */
+//     stack?: string;
+//     /** ISO timestamp when the error was observed */
+//     timestamp: string;
+//     /** Optional URL referencing the sandbox */
+//     url?: string;
+//     /** Whether the error appears programmatically fixable */
+//     fixable: boolean;
+// }
+
+/**
+ * Alias to align with implementation naming where needed
+ */
+// export type SandboxError = ISandboxError;
+
+/**
+ * Common sandbox error categories
+ */
+export enum SandboxErrorType {
+    COMPILATION_ERROR = 'COMPILATION_ERROR',
+    BUILD_ERROR = 'BUILD_ERROR',
+    SERVER_START_ERROR = 'SERVER_START_ERROR',
+    SANDBOX_DISCONNECTED = 'SANDBOX_DISCONNECTED',
+    UNCAUGHT_EXCEPTION = 'UNCAUGHT_EXCEPTION',
+    UNHANDLED_REJECTION = 'UNHANDLED_REJECTION',
+    RUNTIME_ERROR = 'RUNTIME_ERROR',
+    DEPENDENCY_ERROR = 'DEPENDENCY_ERROR',
+    TEST_ERROR = 'TEST_ERROR',
+}
+
+/**
+ * PubSub topic for sandbox error events
+ */
+export const SANDBOX_ERROR_TOPIC = 'SANDBOX_ERROR';
+
+/**
+ * PubSub payload for sandbox error events
+ */
+// export interface ISandboxErrorEventPayload {
+//     sandboxError: {
+//         projectId: string;
+//         sandboxId: string;
+//         error: ISandboxError;
+//     };
+// }
+
+/**
+ * Sandbox Error Service contract
+ */
+export interface ISandboxErrorService {
+    /**
+     * Starts intensive error monitoring for the given sandbox.
+     *
+     * @param {string} projectId - Project identifier
+     * @param {string} sandboxId - Sandbox identifier
+     * @param {string} url - Optional friendly URL for the sandbox
+     * @returns {Promise<void>}
+     */
+    startErrorMonitoring(projectId: string, sandboxId: string, url: string,id?:string): Promise<void>;
+
+    /**
+     * Stops error monitoring for the given sandbox and clears any state.
+     *
+     * @param {string} sandboxId - Sandbox identifier
+     * @returns {Promise<void>}
+     */
+    stopErrorMonitoring(sandboxId: string): Promise<void>;
+
+    /**
+     * Manually reports an error for a sandbox.
+     *
+     * @param {string} projectId - Project identifier
+     * @param {string} sandboxId - Sandbox identifier
+     * @param {string} errorType - Error classification
+     * @param {string} message - Error message
+     * @param {string} [stack] - Optional stack trace
+     * @param {string} [url] - Optional sandbox URL
+     * @returns {Promise<void>}
+     */
+    reportError(
+        projectId: string,
+        sandboxId: string,
+        errorType: string,
+        message: string,
+        stack?: string,
+        url?: string,
+        id?:string
+    ): Promise<void>;
+
+    /**
+     * Triggers a test error publication for diagnostics.
+     *
+     * @param {string} projectId - Project identifier
+     * @returns {Promise<void>}
+     */
+    triggerTestError(projectId: string,id?:string): Promise<void>;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@messenger-box/platform-server",
-    "version": "10.0.3-alpha.7",
+    "version": "10.0.3-alpha.74",
     "description": "Sample core for higher packages to depend on",
     "license": "ISC",
     "author": "CDMBase LLC",
@@ -19,10 +19,13 @@
         "watch": "yarn build:lib:watch"
     },
     "dependencies": {
-        "@container-stack/mailing-api": "5.4.1-alpha.2",
-        "@messenger-box/core": "10.0.3-alpha.7",
+        "@container-stack/mailing-api": "5.4.1-alpha.9",
+        "@e2b/code-interpreter": "^1.5.1",
+        "@inngest/agent-kit": "^0.8.3",
+        "@messenger-box/core": "10.0.3-alpha.74",
         "@skoropletov/moleculer-cron-tasks": "~0.0.8",
-        "date-fns": "^4.1.0"
+        "date-fns": "^4.1.0",
+        "inngest": "^3.39.2"
     },
     "peerDependencies": {
         "@adminide-stack/account-api-server": "*",
@@ -56,18 +59,22 @@
                 "./${libDir}/templates/services/MessengerNotificationService.ts.template",
                 "./${libDir}/templates/services/PostService.ts.template",
                 "./${libDir}/templates/services/PostThreadService.ts.template",
-                "./${libDir}/templates/services/ReactionService.ts.template"
+                "./${libDir}/templates/services/ReactionService.ts.template",
+                "./${libDir}/templates/services/RedisCacheManager.ts.template",
+                "./${libDir}/templates/services/SandboxErrorService.ts.template",
+                "./${libDir}/templates/services/AiFragmentService.ts.template"
             ],
             "repositories": [
                 "./${libDir}/templates/repositories/ChannelRepository.ts.template",
                 "./${libDir}/templates/repositories/PostRepository.ts.template",
                 "./${libDir}/templates/repositories/PostThreadRepository.ts.template",
-                "./${libDir}/templates/repositories/ReactionRepository.ts.template"
+                "./${libDir}/templates/repositories/ReactionRepository.ts.template",
+                "./${libDir}/templates/repositories/AiFragmentRepository.ts.template"
             ]
         }
     },
     "typescript": {
         "definition": "lib/index.d.ts"
     },
-    "gitHead": "6c95ed48d37a8f95b0c3db71c1922c0e9e76bcfe"
+    "gitHead": "2bfc901f9f0a9da1919294e1ebd8246edec0a3b0"
 }

package/lib/interfaces/context.d.ts

@@ -1,14 +0,0 @@
-import { ServerContext as AdminIdeServerContext, IConfigurationServerService } from '@adminide-stack/core';
-import { IUserProfile, IBaseAccountService, IUserAccount, IConfigurationModel } from 'common';
-import { IServices } from './services';
-export interface IServerContext extends AdminIdeServerContext {
-    user: IUserProfile;
-    accountService?: {
-        findAccountById: (id: string) => IUserAccount | undefined;
-        findAccountByUser: (id: string) => IUserAccount | undefined;
-    } & IBaseAccountService;
-    configurationService: IConfigurationServerService & {
-        parser(resource: string, value: string): IConfigurationModel | Error;
-    };
-}
-export type IContext = IServerContext & IServices;

package/lib/store/models/common-options.js

@@ -1,20 +0,0 @@
-const commonModeSchemaOptions = {
-  timestamps: true,
-  toJSON: {
-    virtuals: true
-  },
-  toObject: {
-    virtuals: true,
-    getters: true,
-    transform(doc, ret) {
-      delete ret.__v;
-      delete ret._id;
-    }
-  }
-};
-const addIdVirtualFields = schema => {
-  schema.set('toJSON', {
-    virtuals: true
-  });
-  return schema;
-};export{addIdVirtualFields,commonModeSchemaOptions};//# sourceMappingURL=common-options.js.map

package/lib/store/models/common-options.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"common-options.js","sources":["../../../src/store/models/common-options.ts"],"sourcesContent":[null],"names":[],"mappings":"AAGa,MAAA,uBAAuB,GAAG;AACnC,EAAA,UAAA,EAAU,IAAM;AAChB,EAAA,MAAA,EAAM;AACF,IAAA,QAAA,EAAA;AACH,GAAA;AACD,EAAA,QAAA,EAAQ;AACJ,IAAA,QAAA,EAAA,IAAU;AACV,IAAA,OAAA,EAAA,IAAS;aACA,CAAA,GAAA,EAAI,GAAA,EAAK;aACP,GAAA,CAAA,GAAA;aACA,GAAA,CAAA,GAAA;;AAEd;;AAGQ,MAAA,kBAAkB,GAAG,MAAC,IAAkB;AACjD,EAAA,MAAA,CAAA,GAAO,CAAA,QAAI,EAAQ;AACf,IAAA,QAAA,EAAA;AACH,GAAA,CAAA;AACD,EAAA,OAAA;AACJ"}