@hiliosai/sdk 0.1.24 → 0.1.27

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { Context, ServiceBroker, ServiceSchema as ServiceSchema$1, ServiceSettingSchema, Service, ActionSchema, ServiceEvents, ServiceMethods, ServiceHooks, Middleware, BrokerOptions } from 'moleculer';
+import { Context, ServiceBroker, ServiceSchema as ServiceSchema$1, ServiceSettingSchema, Service, ActionSchema, ServiceEvents, ServiceHooks, Middleware, BrokerOptions } from 'moleculer';
 import env from '@ltv/env';
 export { default as env } from '@ltv/env';
 import { PrismaPg } from '@prisma/adapter-pg';
@@ -488,6 +488,7 @@ declare enum IntegrationPlatform {
     FACEBOOK = "facebook",
     DISCORD = "discord",
     WEBCHAT = "webchat",
+    ZALO = "zalo",
     CUSTOM = "custom"
 }
 declare enum IntegrationStatus {
@@ -659,29 +660,11 @@ type DatasourceInstanceTypes<T extends Record<string, new (...args: unknown[]) =
     [K in keyof T]: InstanceType<T[K]>;
 };
 
-type InferParamsType<T> = T extends Record<string, any> ? {
-    [K in keyof T]: T[K] extends 'string' ? string : T[K] extends 'number' ? number : T[K] extends 'boolean' ? boolean : T[K] extends 'array' ? any[] : T[K] extends 'object' ? Record<string, any> : T[K] extends {
-        type: 'string';
-    } ? string : T[K] extends {
-        type: 'number';
-    } ? number : T[K] extends {
-        type: 'boolean';
-    } ? boolean : T[K] extends {
-        type: 'array';
-    } ? any[] : T[K] extends {
-        type: 'object';
-    } ? Record<string, any> : unknown;
-} : unknown;
-type ActionSchemaWithContext<TDatasources = unknown, TParams = unknown> = Pick<ActionSchema, 'name' | 'rest' | 'visibility' | 'service' | 'cache' | 'tracing' | 'bulkhead' | 'circuitBreaker' | 'retryPolicy' | 'fallback' | 'hooks'> & {
-    params?: TParams;
-    handler: (ctx: AppContext<TDatasources, InferParamsType<TParams>>) => Promise<unknown> | unknown;
-    permissions?: string | string[];
-};
-type ActionHandler<TDatasources = unknown> = (ctx: AppContext<TDatasources>) => Promise<unknown> | unknown;
-type ServiceActionsSchema<TDatasources = unknown> = {
+type ActionHandler<TDatasources = unknown> = (this: Service, ctx: AppContext<TDatasources>) => Promise<unknown> | unknown;
+type ServiceActionsSchema<TDatasources = unknown, TSettings = unknown> = {
     [key: string]: ({
         params?: any;
-        handler: (ctx: AppContext<TDatasources, any>) => Promise<unknown> | unknown;
+        handler: (this: Service<TSettings>, ctx: AppContext<TDatasources, any>) => Promise<unknown> | unknown;
         permissions?: string | string[];
     } & Pick<ActionSchema, 'name' | 'rest' | 'visibility' | 'service' | 'cache' | 'tracing' | 'bulkhead' | 'circuitBreaker' | 'retryPolicy' | 'fallback' | 'hooks'>) | ActionHandler<TDatasources> | false;
 };
@@ -689,9 +672,9 @@ interface ServiceSchema<TSettings = unknown, TDatasources = unknown> extends Omi
     name: string;
     version?: string | number;
     settings?: TSettings;
-    actions?: ServiceActionsSchema<TDatasources>;
+    actions?: ServiceActionsSchema<TDatasources, TSettings>;
     events?: ServiceEvents;
-    methods?: ServiceMethods;
+    methods?: ThisType<Service<TSettings>>;
     hooks?: ServiceHooks;
     dependencies?: string | string[];
     metadata?: Record<string, any>;
@@ -704,11 +687,13 @@ type ServiceConfig<TSettings = unknown, TDatasourceConstructors extends Datasour
 };
 interface IntegrationServiceConfig<TSettings = unknown, TDatasourceConstructors extends DatasourceConstructorRegistry = DatasourceConstructorRegistry, TContext extends AppContext<DatasourceInstanceTypes<TDatasourceConstructors>> = AppContext<DatasourceInstanceTypes<TDatasourceConstructors>>> extends ServiceConfig<TSettings, TDatasourceConstructors> {
     name: string;
+    version: string;
     spec: BaseSpec;
     normalize<TPayload = any>(webhook: WebhookEvent<TPayload>): Promise<Message[]>;
     getChannelConfig(ctx: TContext, channelId: string): Promise<IntegrationConfig | null>;
     validateWebhook?<TPayload = any>(webhook: WebhookEvent<TPayload>): boolean;
     sendMessage(ctx: TContext, message: Message, config: IntegrationConfig): Promise<SendResult>;
+    createChannel<TChannel>(ctx: TContext, integration: TChannel): Promise<boolean>;
     verifyWebhook?(params: {
         mode: string;
         token: string;
@@ -748,31 +733,36 @@ interface IntegrationServiceSchema<TSettings = unknown> extends ServiceSchema$1<
 declare const NAMESPACE: string;
 declare const CHANNELS: {
     readonly WEBHOOK: {
-        readonly PATTERN: `${string}.webhook.*.*`;
-        readonly PREFIX: `${string}.webhook`;
+        readonly PATTERN: "webhook.*.*";
+        readonly PREFIX: "webhook";
         readonly build: (tenantId: string, platform: string) => string;
     };
     readonly PROCESSING: {
-        readonly PATTERN: `${string}.processing.*.*`;
-        readonly PREFIX: `${string}.processing`;
+        readonly PATTERN: "processing.*.*";
+        readonly PREFIX: "processing";
         readonly build: (tenantId: string, messageType: string) => string;
     };
     readonly RESPONSE: {
-        readonly PATTERN: `${string}.response.*.*`;
-        readonly PREFIX: `${string}.response`;
+        readonly PATTERN: "response.*.*";
+        readonly PREFIX: "response";
         readonly build: (tenantId: string, platform: string) => string;
     };
     readonly SYSTEM: {
-        readonly ERRORS: `${string}.system.errors`;
-        readonly METRICS: `${string}.system.metrics`;
-        readonly HEALTH: `${string}.system.health`;
-        readonly INTEGRATION_REGISTERED: `${string}.system.integration.registered`;
-        readonly INTEGRATION_UNREGISTERED: `${string}.system.integration.unregistered`;
+        readonly ERRORS: "system.errors";
+        readonly METRICS: "system.metrics";
+        readonly HEALTH: "system.health";
+    };
+    readonly INTEGRATION: {
+        readonly STARTED: "integration.started";
+        readonly STOPPED: "integration.stopped";
+        readonly REGISTERED: "integration.registered";
+        readonly UNREGISTERED: "integration.unregistered";
+        readonly UPDATED: "integration.updated";
     };
     readonly DLQ: {
-        readonly WEBHOOK_FAILED: `${string}.dlq.webhook.failed`;
-        readonly SEND_FAILED: `${string}.dlq.send.failed`;
-        readonly PROCESSING_FAILED: `${string}.dlq.processing.failed`;
+        readonly WEBHOOK_FAILED: "dlq.webhook.failed";
+        readonly SEND_FAILED: "dlq.send.failed";
+        readonly PROCESSING_FAILED: "dlq.processing.failed";
         readonly buildSendFailed: (platform: string) => string;
     };
 };
@@ -780,9 +770,9 @@ declare const CHANNELS: {
  * Integration-specific channel names
  */
 declare const INTEGRATION_CHANNELS: {
-    readonly MESSAGE_RECEIVED: `${string}.processing.message.received`;
-    readonly MESSAGE_SENT: `${string}.processing.message.sent`;
-    readonly MESSAGE_FAILED: `${string}.processing.message.failed`;
+    readonly MESSAGE_RECEIVED: "processing.message.received";
+    readonly MESSAGE_SENT: "processing.message.sent";
+    readonly MESSAGE_FAILED: "processing.message.failed";
 };
 type IntegrationChannelName = (typeof INTEGRATION_CHANNELS)[keyof typeof INTEGRATION_CHANNELS];
 
@@ -910,4 +900,4 @@ declare function DatasourceMixin(datasourceConstructors?: DatasourceConstructorR
 
 declare function omit<T extends Record<string, unknown>, K extends keyof T>(obj: T, keys: K[]): Omit<T, K>;
 
-export { AbstractDatasource, type ActionHandler, type ActionSchemaWithContext, type ActionWithPermissions, type AppContext, type AppMeta, type AuditTrailExtension, type BaseDatasource, type BaseSpec, CHANNELS, type CarouselItem, type ChannelSendOptions, ContextHelpersMiddleware, CreateHealthCheckMiddleware, DEFAULT_DATASOURCE_CACHE_TTL, type DatasourceConstructorRegistry, type DatasourceContext, type DatasourceInstanceRegistry, type DatasourceInstanceTypes, DatasourceMixin, type Env, HEALTH_CHECK_DEFAULTS, INTEGRATION_CHANNELS, IntegrationCapability, type IntegrationChannelName, type IntegrationConfig, type IntegrationMessageFailedPayload, type IntegrationMessageReceivedPayload, type IntegrationMessageSentPayload, IntegrationPlatform, type IntegrationRegisteredPayload, type IntegrationServiceConfig, type IntegrationServiceSchema, IntegrationStatus, type IntegrationUnregisteredPayload, MemoizeMixin, type MemoizeMixinOptions, type Message, type MessageAttachment, type MessageButton, type MessageContent, MessageContentType, type MessageDirection, type MessageParticipant, type MessageStatus, type MessageType, NAMESPACE, PERMISSIONS, type Permission, type PermissionHelpers, PermissionsMiddleware, type PlatformMessage, type PrismaClientLike, type PrismaClientWithTenant, PrismaDatasource, PrismaPgDatasource, REDIS_URL, ROLE_PERMISSIONS, type SendResult, type SendToChannelMethod, type ServiceActionsSchema, type ServiceConfig, type ServiceSchema, type ServiceWithDatasources, type SoftDeleteExtension, type Tenant, type TenantExtension, type User, UserRole, type WebhookEvent, createDatasourceMiddleware, createTenantExtension, defineIntegration, defineService, isDev, isProd, isTest, configs as moleculer, nodeEnv, omit, retryExtension, softDeleteExtension };
+export { AbstractDatasource, type ActionHandler, type ActionWithPermissions, type AppContext, type AppMeta, type AuditTrailExtension, type BaseDatasource, type BaseSpec, CHANNELS, type CarouselItem, type ChannelSendOptions, ContextHelpersMiddleware, CreateHealthCheckMiddleware, DEFAULT_DATASOURCE_CACHE_TTL, type DatasourceConstructorRegistry, type DatasourceContext, type DatasourceInstanceRegistry, type DatasourceInstanceTypes, DatasourceMixin, type Env, HEALTH_CHECK_DEFAULTS, INTEGRATION_CHANNELS, IntegrationCapability, type IntegrationChannelName, type IntegrationConfig, type IntegrationMessageFailedPayload, type IntegrationMessageReceivedPayload, type IntegrationMessageSentPayload, IntegrationPlatform, type IntegrationRegisteredPayload, type IntegrationServiceConfig, type IntegrationServiceSchema, IntegrationStatus, type IntegrationUnregisteredPayload, MemoizeMixin, type MemoizeMixinOptions, type Message, type MessageAttachment, type MessageButton, type MessageContent, MessageContentType, type MessageDirection, type MessageParticipant, type MessageStatus, type MessageType, NAMESPACE, PERMISSIONS, type Permission, type PermissionHelpers, PermissionsMiddleware, type PlatformMessage, type PrismaClientLike, type PrismaClientWithTenant, PrismaDatasource, PrismaPgDatasource, REDIS_URL, ROLE_PERMISSIONS, type SendResult, type SendToChannelMethod, type ServiceActionsSchema, type ServiceConfig, type ServiceSchema, type ServiceWithDatasources, type SoftDeleteExtension, type Tenant, type TenantExtension, type User, UserRole, type WebhookEvent, createDatasourceMiddleware, createTenantExtension, defineIntegration, defineService, isDev, isProd, isTest, configs as moleculer, nodeEnv, omit, retryExtension, softDeleteExtension };

package/dist/index.js

@@ -682,53 +682,57 @@ var CHANNELS = {
   // Webhook processing channels
   WEBHOOK: {
     // Pattern: hios.webhook.{tenantId}.{platform}
-    PATTERN: `${NAMESPACE}.webhook.*.*`,
-    PREFIX: `${NAMESPACE}.webhook`,
-    build: (tenantId, platform) => `${NAMESPACE}.webhook.${tenantId}.${platform}`
+    PATTERN: "webhook.*.*",
+    PREFIX: "webhook",
+    build: (tenantId, platform) => `webhook.${tenantId}.${platform}`
   },
   // Message processing channels
   PROCESSING: {
     // Pattern: hios.processing.{tenantId}.{messageType}
-    PATTERN: `${NAMESPACE}.processing.*.*`,
-    PREFIX: `${NAMESPACE}.processing`,
-    build: (tenantId, messageType) => `${NAMESPACE}.processing.${tenantId}.${messageType}`
+    PATTERN: "processing.*.*",
+    PREFIX: "processing",
+    build: (tenantId, messageType) => `processing.${tenantId}.${messageType}`
   },
   // Response/outbound message channels
   RESPONSE: {
     // Pattern: hios.response.{tenantId}.{platform}
-    PATTERN: `${NAMESPACE}.response.*.*`,
-    PREFIX: `${NAMESPACE}.response`,
-    build: (tenantId, platform) => `${NAMESPACE}.response.${tenantId}.${platform}`
+    PATTERN: "response.*.*",
+    PREFIX: "response",
+    build: (tenantId, platform) => `response.${tenantId}.${platform}`
   },
   // System channels
   SYSTEM: {
     // Error handling
-    ERRORS: `${NAMESPACE}.system.errors`,
+    ERRORS: "system.errors",
     // Metrics and monitoring
-    METRICS: `${NAMESPACE}.system.metrics`,
+    METRICS: "system.metrics",
     // Health checks
-    HEALTH: `${NAMESPACE}.system.health`,
-    // Integration lifecycle events
-    INTEGRATION_REGISTERED: `${NAMESPACE}.system.integration.registered`,
-    INTEGRATION_UNREGISTERED: `${NAMESPACE}.system.integration.unregistered`
+    HEALTH: "system.health"
+  },
+  INTEGRATION: {
+    STARTED: "integration.started",
+    STOPPED: "integration.stopped",
+    REGISTERED: "integration.registered",
+    UNREGISTERED: "integration.unregistered",
+    UPDATED: "integration.updated"
   },
   // Dead letter queues
   DLQ: {
     // Failed webhook processing
-    WEBHOOK_FAILED: `${NAMESPACE}.dlq.webhook.failed`,
+    WEBHOOK_FAILED: "dlq.webhook.failed",
     // Failed message sends
-    SEND_FAILED: `${NAMESPACE}.dlq.send.failed`,
+    SEND_FAILED: "dlq.send.failed",
     // Failed processing
-    PROCESSING_FAILED: `${NAMESPACE}.dlq.processing.failed`,
+    PROCESSING_FAILED: "dlq.processing.failed",
     // Build DLQ name for specific integration
-    buildSendFailed: (platform) => `${NAMESPACE}.dlq.send.${platform}.failed`
+    buildSendFailed: (platform) => `dlq.send.${platform}.failed`
   }
 };
 var INTEGRATION_CHANNELS = {
   // Message events
-  MESSAGE_RECEIVED: `${NAMESPACE}.processing.message.received`,
-  MESSAGE_SENT: `${NAMESPACE}.processing.message.sent`,
-  MESSAGE_FAILED: `${NAMESPACE}.processing.message.failed`
+  MESSAGE_RECEIVED: "processing.message.received",
+  MESSAGE_SENT: "processing.message.sent",
+  MESSAGE_FAILED: "processing.message.failed"
 };
 var CHANNEL_CONFIG = {
   // Default settings for message channels
@@ -758,15 +762,17 @@ var CHANNEL_CONFIG = {
 };
 var SUBJECTS = {
   // All webhook subjects
-  WEBHOOK_ALL: `${NAMESPACE}.webhook.>`,
+  WEBHOOK_ALL: "webhook.>",
   // All processing subjects
-  PROCESSING_ALL: `${NAMESPACE}.processing.>`,
+  PROCESSING_ALL: "processing.>",
   // All response subjects
-  RESPONSE_ALL: `${NAMESPACE}.response.>`,
+  RESPONSE_ALL: "response.>",
   // All system subjects
-  SYSTEM_ALL: `${NAMESPACE}.system.>`,
+  SYSTEM_ALL: "system.>",
+  // All integrations subjects
+  INTEGRATION_ALL: "integration.>",
   // All DLQ subjects
-  DLQ_ALL: `${NAMESPACE}.dlq.>`};
+  DLQ_ALL: "dlq.>"};
 
 // src/service/define-integration.ts
 var SecurityHelpers = {
@@ -1011,6 +1017,24 @@ function defineIntegration(config) {
         }
         return true;
       }
+    },
+    i_createChannel: {
+      params: {
+        integration: "object"
+      },
+      async handler(ctx) {
+        try {
+          ctx.broker.logger.info(
+            `Creating channel for integration ${config.name}`
+          );
+          await config.createChannel(ctx, ctx.params.integration);
+        } catch (err) {
+          ctx.broker.logger.error(
+            `Failed to create channel for integration ${config.name}`,
+            err
+          );
+        }
+      }
     }
   };
   if (config.actions) {
@@ -1048,7 +1072,36 @@ function defineIntegration(config) {
     },
     created: config.created,
     started: config.started,
-    stopped: config.stopped
+    stopped: config.stopped,
+    mixins: [
+      {
+        started() {
+          this.broker.logger.info("Integration service started");
+          this.broker.emit(CHANNELS.INTEGRATION.STARTED, {
+            name: config.name,
+            version: config.version,
+            spec: config.spec
+          });
+        }
+      }
+    ],
+    channels: {
+      [`${CHANNELS.INTEGRATION.REGISTERED}.${config.spec.id}`]: {
+        context: true,
+        handler(ctx, payload) {
+          const integration = payload.json();
+          payload.ackAck().then(() => {
+            ctx.broker.logger.debug("Integration registered", {
+              name: this.name,
+              version: this.version
+            });
+          });
+          ctx.broker.call(`v${this.version}.${this.name}.i_createChannel`, {
+            integration
+          });
+        }
+      }
+    }
   });
   return {
     ...baseService,
@@ -1068,6 +1121,7 @@ var IntegrationPlatform = /* @__PURE__ */ ((IntegrationPlatform2) => {
   IntegrationPlatform2["FACEBOOK"] = "facebook";
   IntegrationPlatform2["DISCORD"] = "discord";
   IntegrationPlatform2["WEBCHAT"] = "webchat";
+  IntegrationPlatform2["ZALO"] = "zalo";
   IntegrationPlatform2["CUSTOM"] = "custom";
   return IntegrationPlatform2;
 })(IntegrationPlatform || {});
@@ -1166,8 +1220,9 @@ var middleware = Middleware({
             SUBJECTS.PROCESSING_ALL,
             SUBJECTS.RESPONSE_ALL,
             SUBJECTS.SYSTEM_ALL,
-            SUBJECTS.DLQ_ALL
-          ],
+            SUBJECTS.DLQ_ALL,
+            SUBJECTS.INTEGRATION_ALL
+          ].map((subject) => `${NAMESPACE2.toLowerCase()}.${subject}`),
           retention: "limits",
           max_msgs: env4.int("NATS_MAX_MESSAGES", 1e5),
           // 100K for dev, 10M+ for prod
@@ -1226,9 +1281,7 @@ var middleware = Middleware({
     }
   }
 });
-var ChannelsMiddleware = {
-  ...middleware
-};
+var ChannelsMiddleware = middleware;
 
 // src/configs/moleculer/circuit-breaker.ts
 var circuitBreakerConfig = {
@@ -1507,7 +1560,9 @@ function createTenantExtension() {
             args.where ?? (args.where = {});
             (_a = args.where).tenantId ?? (_a.tenantId = tenantContext.currentTenantId);
           } else if (tenantContext.strictMode && !tenantContext.bypassMode && !tenantContext.currentTenantId) {
-            throw new Error("Tenant context required for this operation. Use $withSystemMode() for system-level operations.");
+            throw new Error(
+              "Tenant context required for this operation. Use $withSystemMode() for system-level operations."
+            );
           }
           return query(args);
         },
@@ -1517,7 +1572,9 @@ function createTenantExtension() {
             args.where ?? (args.where = {});
             (_a = args.where).tenantId ?? (_a.tenantId = tenantContext.currentTenantId);
           } else if (tenantContext.strictMode && !tenantContext.bypassMode && !tenantContext.currentTenantId) {
-            throw new Error("Tenant context required for this operation. Use $withSystemMode() for system-level operations.");
+            throw new Error(
+              "Tenant context required for this operation. Use $withSystemMode() for system-level operations."
+            );
           }
           return query(args);
         },
@@ -1527,7 +1584,9 @@ function createTenantExtension() {
             args.where ?? (args.where = {});
             (_a = args.where).tenantId ?? (_a.tenantId = tenantContext.currentTenantId);
           } else if (tenantContext.strictMode && !tenantContext.bypassMode && !tenantContext.currentTenantId) {
-            throw new Error("Tenant context required for this operation. Use $withSystemMode() for system-level operations.");
+            throw new Error(
+              "Tenant context required for this operation. Use $withSystemMode() for system-level operations."
+            );
           }
           return query(args);
         },
@@ -1538,7 +1597,9 @@ function createTenantExtension() {
             args.data ?? (args.data = {});
             (_a = args.data).tenantId ?? (_a.tenantId = tenantContext.currentTenantId);
           } else if (tenantContext.strictMode && !tenantContext.bypassMode && !tenantContext.currentTenantId) {
-            throw new Error("Tenant context required for this operation. Use $withSystemMode() for system-level operations.");
+            throw new Error(
+              "Tenant context required for this operation. Use $withSystemMode() for system-level operations."
+            );
           }
           return query(args);
         },
@@ -1549,7 +1610,9 @@ function createTenantExtension() {
             args.where ?? (args.where = {});
             (_a = args.where).tenantId ?? (_a.tenantId = tenantContext.currentTenantId);
           } else if (tenantContext.strictMode && !tenantContext.bypassMode && !tenantContext.currentTenantId) {
-            throw new Error("Tenant context required for this operation. Use $withSystemMode() for system-level operations.");
+            throw new Error(
+              "Tenant context required for this operation. Use $withSystemMode() for system-level operations."
+            );
           }
           return query(args);
         },
@@ -1560,7 +1623,9 @@ function createTenantExtension() {
             args.where ?? (args.where = {});
             (_a = args.where).tenantId ?? (_a.tenantId = tenantContext.currentTenantId);
           } else if (tenantContext.strictMode && !tenantContext.bypassMode && !tenantContext.currentTenantId) {
-            throw new Error("Tenant context required for this operation. Use $withSystemMode() for system-level operations.");
+            throw new Error(
+              "Tenant context required for this operation. Use $withSystemMode() for system-level operations."
+            );
           }
           return query(args);
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiliosai/sdk",
-  "version": "0.1.24",
+  "version": "0.1.27",
   "type": "module",
   "license": "UNLICENSED",
   "main": "./dist/index.js",
@@ -29,7 +29,8 @@
     "@hiliosai/typescript": "workspace:*",
     "@pkg/dev-utils": "workspace:*",
     "@prisma/adapter-pg": "7.2.0",
-    "bun-types": "latest"
+    "bun-types": "latest",
+    "nats": "2.29.3"
   },
   "prettier": "@hiliosai/prettier"
 }