@hazeljs/messaging 0.2.0-alpha.1

package/dist/types/response-handler.types.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Response handler types - for Agent, RAG, and external integrations
+ */
+import type { IncomingMessage } from './message.types';
+import type { ConversationTurn } from '../store/conversation-context.interface';
+/** Minimal RAG search interface - compatible with @hazeljs/rag RAGService */
+export interface IRAGSearch {
+    search(query: string, options?: {
+        topK?: number;
+        minScore?: number;
+    }): Promise<Array<{
+        id?: string;
+        content: string;
+        score?: number;
+        metadata?: Record<string, unknown>;
+    }>>;
+}
+/** Result from agent/external handler - can include sources for citations */
+export interface AgentHandlerResult {
+    response: string;
+    sources?: Array<{
+        id?: string;
+        content: string;
+        score?: number;
+        metadata?: Record<string, unknown>;
+    }>;
+}
+/** Input for agent handler - CSR-style integration */
+export interface AgentHandlerInput {
+    message: IncomingMessage;
+    sessionId: string;
+    conversationTurns: ConversationTurn[];
+}
+/**
+ * Agent handler - wire your CSRService, AgentRuntime, or custom logic.
+ * Return response string or { response, sources }.
+ *
+ * @example
+ * ```ts
+ * agentHandler: async ({ message, sessionId }) => {
+ *   const result = await csrService.chat(message.text, sessionId, message.userId);
+ *   return { response: result.response, sources: result.sources };
+ * }
+ * ```
+ */
+export type AgentHandler = (input: AgentHandlerInput) => Promise<string | AgentHandlerResult>;
+//# sourceMappingURL=response-handler.types.d.ts.map

package/dist/types/response-handler.types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-handler.types.d.ts","sourceRoot":"","sources":["../../src/types/response-handler.types.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yCAAyC,CAAC;AAEhF,6EAA6E;AAC7E,MAAM,WAAW,UAAU;IACzB,MAAM,CACJ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,GAC7C,OAAO,CACR,KAAK,CAAC;QAAE,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC,CAC5F,CAAC;CACH;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,OAAO,EAAE,MAAM,CAAC;QAChB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACpC,CAAC,CAAC;CACJ;AAED,sDAAsD;AACtD,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,eAAe,CAAC;IACzB,SAAS,EAAE,MAAM,CAAC;IAClB,iBAAiB,EAAE,gBAAgB,EAAE,CAAC;CACvC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,OAAO,CAAC,MAAM,GAAG,kBAAkB,CAAC,CAAC"}

package/dist/types/response-handler.types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=response-handler.types.js.map

package/dist/types/response-handler.types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response-handler.types.js","sourceRoot":"","sources":["../../src/types/response-handler.types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,88 @@
+{
+  "name": "@hazeljs/messaging",
+  "version": "0.2.0-alpha.1",
+  "description": "Multichannel messaging for HazelJS - WhatsApp, Telegram, Viber with LLM-powered bot responses",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc --skipLibCheck",
+    "clean": "rm -rf dist",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "test": "jest --coverage --passWithNoTests",
+    "test:watch": "jest --watch"
+  },
+  "keywords": [
+    "hazeljs",
+    "messaging",
+    "whatsapp",
+    "telegram",
+    "viber",
+    "bot",
+    "llm",
+    "ai-chatbot"
+  ],
+  "author": "Muhammad Arslan <muhammad.arslan@hazeljs.com>",
+  "license": "Apache-2.0",
+  "bugs": {
+    "url": "https://github.com/hazeljs/hazel-js/issues"
+  },
+  "homepage": "https://hazeljs.com",
+  "dependencies": {
+    "reflect-metadata": "^0.2.1",
+    "telegraf": "^4.16.3"
+  },
+  "peerDependencies": {
+    "@hazeljs/ai": ">=0.2.0-beta.0",
+    "@hazeljs/core": ">=0.2.0-beta.0",
+    "@hazeljs/kafka": ">=0.2.0-beta.0",
+    "@hazeljs/rag": ">=0.2.0-beta.0",
+    "ioredis": ">=5.0.0",
+    "viber-bot": ">=1.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@hazeljs/kafka": {
+      "optional": true,
+      "description": "Required for Kafka async processing - npm install @hazeljs/kafka"
+    },
+    "ioredis": {
+      "optional": true,
+      "description": "Required for Redis context store - npm install ioredis"
+    },
+    "viber-bot": {
+      "optional": true,
+      "description": "Required for Viber channel - npm install viber-bot"
+    },
+    "@hazeljs/agent": {
+      "optional": true,
+      "description": "Required for agent-based bot responses"
+    },
+    "@hazeljs/rag": {
+      "optional": true,
+      "description": "Required for RAG-enhanced responses"
+    },
+    "@hazeljs/queue": {
+      "optional": true,
+      "description": "Required for async message processing"
+    }
+  },
+  "devDependencies": {
+    "@types/jest": "^29.5.11",
+    "@types/node": "^20.17.50",
+    "jest": "^29.7.0",
+    "ts-jest": "^29.1.2",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hazel-js/hazeljs.git",
+    "directory": "packages/messaging"
+  },
+  "gitHead": "cbc5ee2c12ced28fd0576faf13c5f078c1e8421e"
+}