@hiliosai/sdk 0.1.2 → 0.1.3

package/INTEGRATION_SERVICE.md

@@ -139,9 +139,9 @@ Integration-specific logic is implemented as service methods:
 
 ```typescript
 import {defineIntegration} from '@pkg/sdk';
-import type {BaseIntegration, NormalizedMessage, WebhookEvent} from '@pkg/sdk';
+import type {BaseSpec, NormalizedMessage, WebhookEvent} from '@pkg/sdk';
 
-const whatsappIntegration: BaseIntegration = {
+const whatsappIntegration: BaseSpec = {
   id: 'whatsapp-business',
   name: 'WhatsApp Business',
   platform: 'whatsapp',
@@ -152,7 +152,7 @@ const whatsappIntegration: BaseIntegration = {
 
 export default defineIntegration({
   name: 'whatsapp',
-  integration: whatsappIntegration,
+  spec: whatsappIntegration,
   
   // Required: Convert WhatsApp webhook to normalized message
   async normalize(webhook: WebhookEvent): Promise<NormalizedMessage[]> {
@@ -296,7 +296,7 @@ import {WhatsAppDatasource} from './datasources';
 
 export default defineIntegration({
   name: 'whatsapp',
-  integration: whatsappIntegration,
+  spec: whatsappIntegration,
   
   // Configure per-service datasources
   datasources: {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hiliosai/sdk",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "type": "module",
   "exports": {
     ".": "./src/index.ts"

package/src/service/define-integration.ts

@@ -91,7 +91,7 @@ export function defineIntegration<
     i_receiveWebhook: {
       rest: {
         method: 'POST' as const,
-        path: '/webhook',
+        path: '/:tenantId',
       },
       params: {
         tenantId: 'string',
@@ -181,20 +181,20 @@ export function defineIntegration<
           () => config.sendMessage(ctx, message, integrationConfig),
           3,
           1000,
-          `Send message via ${config.integration.platform}`
+          `Send message via ${config.spec.platform}`
         );
 
         // Emit event based on result
         if (result.success) {
           ctx.emit('integration.message.sent', {
             messageId: result.messageId,
-            platform: config.integration.platform,
+            platform: config.spec.platform,
             metadata: result.metadata,
           });
         } else {
           ctx.emit('integration.message.failed', {
             error: result.error,
-            platform: config.integration.platform,
+            platform: config.spec.platform,
             message,
           });
         }
@@ -224,12 +224,12 @@ export function defineIntegration<
 
           return {
             status: 'healthy',
-            message: `${config.integration.name} integration is running`,
+            message: `${config.spec.name} integration is running`,
             details: {
-              integration: config.integration.id,
-              version: config.integration.version,
+              id: config.spec.id,
+              version: config.spec.version,
               timestamp: new Date().toISOString(),
-              capabilities: config.integration.capabilities,
+              capabilities: config.spec.capabilities,
             },
           };
         } catch (error: unknown) {
@@ -238,7 +238,7 @@ export function defineIntegration<
             status: 'unhealthy',
             message: err.message,
             details: {
-              integration: config.integration.id,
+              id: config.spec.id,
               timestamp: new Date().toISOString(),
             },
           };
@@ -249,9 +249,10 @@ export function defineIntegration<
     i_verifyWebhook: {
       rest: {
         method: 'GET' as const,
-        path: '/webhook',
+        path: '/:tenantId',
       },
       params: {
+        tenantId: 'string',
         mode: 'string',
         token: 'string',
         challenge: 'string',
@@ -259,7 +260,7 @@ export function defineIntegration<
       handler(
         ctx: AppContext<
           TDatasources,
-          {mode: string; token: string; challenge: string}
+          {tenantId: string; mode: string; token: string; challenge: string}
         >
       ): string {
         if (config.verifyWebhook) {
@@ -277,12 +278,12 @@ export function defineIntegration<
       },
       handler(): object {
         return {
-          id: config.integration.id,
-          name: config.integration.name,
-          platform: config.integration.platform,
-          version: config.integration.version,
-          status: config.integration.status,
-          capabilities: config.integration.capabilities,
+          id: config.spec.id,
+          name: config.spec.name,
+          platform: config.spec.platform,
+          version: config.spec.version,
+          status: config.spec.status,
+          capabilities: config.spec.capabilities,
         };
       },
     },
@@ -316,7 +317,7 @@ export function defineIntegration<
     datasources: config.datasources,
     metadata: {
       ...config.metadata,
-      integration: config.integration,
+      spec: config.spec,
     },
     actions,
     events: config.events ?? {},
@@ -347,7 +348,7 @@ export function defineIntegration<
   // Return the service schema - integration methods are available via service methods
   return {
     ...baseService,
-    // Only add the integration metadata
-    integration: config.integration,
+    // Only add the integration spec
+    spec: config.spec,
   } as IntegrationServiceSchema<TPlatformMessage, TSettings>;
 }

package/src/types/integration.ts

@@ -5,7 +5,7 @@ import type {
   IntegrationStatus,
 } from './platform';
 
-export interface BaseIntegration {
+export interface BaseSpec {
   id: string;
   name: string;
   platform: IntegrationPlatform;

package/src/types/service.ts

@@ -9,7 +9,7 @@ import type {
 
 import type {DatasourceConstructorRegistry} from '../middlewares/datasource.middleware';
 import type {AppContext} from './context';
-import type {BaseIntegration, IntegrationConfig} from './integration';
+import type {BaseSpec, IntegrationConfig} from './integration';
 import type {
   NormalizedMessage,
   PlatformMessage,
@@ -134,7 +134,7 @@ export interface IntegrationServiceConfig<
   TDatasources = unknown
 > extends ServiceConfig<TSettings, TDatasources> {
   name: string;
-  integration: BaseIntegration;
+  spec: BaseSpec;
 
   // Core integration methods
   normalize(webhook: WebhookEvent): Promise<NormalizedMessage[]>;
@@ -177,7 +177,7 @@ export interface IntegrationServiceSchema<
   TPlatformMessage extends PlatformMessage = PlatformMessage,
   TSettings = unknown
 > extends MoleculerServiceSchema<TSettings> {
-  integration: BaseIntegration;
+  spec: BaseSpec;
   normalize(webhook: WebhookEvent): Promise<NormalizedMessage[]>;
   transform?(
     message: NormalizedMessage,