@eka-care/medassist-core 1.0.0

package/dist/resources/index.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * Init class to fetch agent configuration from the platform
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ResourceManager = void 0;
+const HttpClient_1 = require("../internal/Api/HttpClient");
+const Session_1 = require("./session/Session");
+const Error_1 = require("../internal/Error/Error");
+class ResourceManager {
+    resourceConfig;
+    httpClient;
+    session;
+    constructor(config) {
+        this.resourceConfig = config;
+        // Set up HTTP client with agentId header for all requests
+        this.httpClient = new HttpClient_1.HttpClient({
+            baseUrl: this.resourceConfig.serverUrl,
+            headers: {
+                "X-agent-id": this.resourceConfig.agentId, // This will be included in ALL requests
+            },
+            // authorization: config.authorization,
+        });
+        // Initialize sessions resource with the configured client
+        this.session = new Session_1.Session(this.httpClient);
+    }
+    /**
+     * Fetch agent configuration and create session
+     */
+    async createSession(userId) {
+        try {
+            // Use SessionsResource to start a session
+            // The X-agent-id header is automatically included from httpClient config
+            const sessionData = await this.session.create(userId);
+            if (!sessionData?.session_id || !sessionData?.session_token) {
+                throw new Error_1.APIError("Failed to start session.", 500, undefined, undefined);
+            }
+            return sessionData;
+        }
+        catch (error) {
+            if (error instanceof Error_1.APIError) {
+                throw error;
+            }
+            throw new Error_1.APIError("Failed to start session.", 500, undefined, undefined);
+        }
+    }
+    /**
+     * Validate a session if it's still active or not
+     * GET /med-assist/session/:sessionId
+     */
+    async validateSession(sessionId) {
+        try {
+            const sessionData = await this.session.retrieve(sessionId);
+            if (sessionData.msg && sessionData.msg === "Session Active") {
+                return {
+                    expired: false,
+                    active: true,
+                };
+            }
+            return {
+                expired: true,
+                active: false,
+            };
+        }
+        catch (error) {
+            if (error instanceof Error_1.APIError) {
+                switch (error.status) {
+                    case 404:
+                        return {
+                            expired: false,
+                            active: false,
+                        };
+                    case 500:
+                        return {
+                            expired: false,
+                            active: false,
+                        };
+                    case 401:
+                        return {
+                            expired: true,
+                            active: false,
+                        };
+                    default:
+                        return {
+                            expired: false,
+                            active: false,
+                        };
+                }
+            }
+            throw new Error_1.APIError("Failed to validate session.", 500, undefined, undefined);
+        }
+    }
+    /**
+     * Refresh a session
+     * POST /med-assist/session/:sessionId/refresh
+     */
+    async refreshSession(sessionId, sessionToken) {
+        return await this.session.refresh(sessionId, sessionToken);
+    }
+    /**
+     * Feedback on a message
+     * PATCH /med-assist/session/:sessionId/:messageId
+     */
+    async sendFeedback(sessionId, messageId, feedback, feedbackReason) {
+        return await this.session.feedback(sessionId, messageId, feedback, feedbackReason);
+    }
+}
+exports.ResourceManager = ResourceManager;

package/dist/resources/session/Session.d.ts

@@ -0,0 +1,21 @@
+import { BaseResource } from "../../internal/Api/BaseResource";
+import { type SessionResponse, USER_FEEDBACK } from "./types";
+/**
+ * SessionsResource class for managing sessions-related api calls
+ */
+export declare class Session extends BaseResource {
+    /**
+     * create a new session
+     * POST /med-assist/session
+     */
+    private basePath;
+    create(userId: string): Promise<SessionResponse>;
+    retrieve(sessionId: string): Promise<SessionResponse>;
+    /**
+     * refresh a session
+     * POST /med-assist/session/refresh
+     */
+    refresh(sessionId: string, sessionToken: string): Promise<SessionResponse>;
+    feedback(sessionId: string, messageId: string, feedback: USER_FEEDBACK, feedback_reason?: string): Promise<void>;
+}
+//# sourceMappingURL=Session.d.ts.map

package/dist/resources/session/Session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Session.d.ts","sourceRoot":"","sources":["../../../src/resources/session/Session.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAC/D,OAAO,EAAE,KAAK,eAAe,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,qBAAa,OAAQ,SAAQ,YAAY;IAEvC;;;OAGG;IACH,OAAO,CAAC,QAAQ,CAAyB;IAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIhD,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,CAAC;IAIlE;;;OAGG;IACU,OAAO,CAClB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC;IAYd,QAAQ,CACnB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,aAAa,EACvB,eAAe,CAAC,EAAE,MAAM,GACvB,OAAO,CAAC,IAAI,CAAC;CAMjB"}

package/dist/resources/session/Session.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Session = void 0;
+const BaseResource_1 = require("../../internal/Api/BaseResource");
+/**
+ * SessionsResource class for managing sessions-related api calls
+ */
+class Session extends BaseResource_1.BaseResource {
+    //Ts implicitly calls super() here
+    /**
+     * create a new session
+     * POST /med-assist/session
+     */
+    basePath = "/med-assist/session";
+    async create(userId) {
+        return this.post(this.basePath, { user_id: userId });
+    }
+    async retrieve(sessionId) {
+        return this.get(`${this.basePath}/${sessionId}`);
+    }
+    /**
+     * refresh a session
+     * POST /med-assist/session/refresh
+     */
+    async refresh(sessionId, sessionToken) {
+        return this.get(`${this.basePath}/${sessionId}/refresh`, undefined, {
+            headers: {
+                "x-sess-token": sessionToken,
+            },
+        });
+    }
+    async feedback(sessionId, messageId, feedback, feedback_reason) {
+        return this.patch(`${this.basePath}/${sessionId}/${messageId}`, {
+            feedback,
+            feedback_reason,
+        });
+    }
+}
+exports.Session = Session;

package/dist/resources/session/types.d.ts

@@ -0,0 +1,17 @@
+export declare const USER_FEEDBACK: {
+    readonly LIKE: "LIKE";
+    readonly DISLIKE: "DISLIKE";
+    readonly NONE: "NONE";
+};
+export type USER_FEEDBACK = (typeof USER_FEEDBACK)[keyof typeof USER_FEEDBACK];
+export interface SessionResponse {
+    session_id: string;
+    session_token?: string;
+    session_validity_s?: string;
+    msg?: string;
+    error?: {
+        code: string;
+        msg: string;
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resources/session/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/resources/session/types.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa;;;;CAIhB,CAAC;AAEX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E,MAAM,WAAW,eAAe;IAC9B,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE;QACN,IAAI,EAAE,MAAM,CAAC;QACb,GAAG,EAAE,MAAM,CAAC;KACb,CAAC;CACH"}

package/dist/resources/session/types.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.USER_FEEDBACK = void 0;
+exports.USER_FEEDBACK = {
+    LIKE: "LIKE",
+    DISLIKE: "DISLIKE",
+    NONE: "NONE",
+};

package/dist/resources/types.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Types for agent configuration initialization
+ */
+export interface AgentConfig {
+    agentId: string;
+    name: string;
+    prompt: string;
+    firstMessage: string;
+    language: string;
+    theme?: {
+        primaryColor?: string;
+        backgroundColor?: string;
+        fontFamily?: string;
+    };
+    metadata?: Record<string, unknown>;
+}
+export interface ResourceConfig {
+    agentId: string;
+    serverUrl: string;
+    authorization?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/resources/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/resources/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE;QACN,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,eAAe,CAAC,EAAE,MAAM,CAAC;QACzB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,CAAC;IACF,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB"}

package/dist/resources/types.js

@@ -0,0 +1,5 @@
+"use strict";
+/**
+ * Types for agent configuration initialization
+ */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/types/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Shared types across the SDK
+ */
+export * from '../internal/connection/types';
+export * from '../internal/Error/types';
+export * from '../messages/types';
+export * from '../resources/session/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,8BAA8B,CAAC;AAC7C,cAAc,yBAAyB,CAAC;AACxC,cAAc,mBAAmB,CAAC;AAClC,cAAc,4BAA4B,CAAC"}

package/dist/types/index.js

@@ -0,0 +1,24 @@
+"use strict";
+/**
+ * Shared types across the SDK
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Re-export common types from other modules
+__exportStar(require("../internal/connection/types"), exports);
+__exportStar(require("../internal/Error/types"), exports);
+__exportStar(require("../messages/types"), exports);
+__exportStar(require("../resources/session/types"), exports);

package/dist/utils/Error.d.ts

@@ -0,0 +1,45 @@
+import { APIError, SynapseErrorCode } from "../internal/Error/Error";
+export declare class ErrorUtils {
+    /**
+     * Check if an error is a specific API error type
+     */
+    static isAPIError(error: unknown): error is APIError<number, Headers, Record<string, unknown>>;
+    /**
+     * Check if an error is a network-related error
+     */
+    static isNetworkError(error: unknown): boolean;
+    /**
+     * Check if an error is a timeout error
+     */
+    static isTimeoutError(error: unknown): boolean;
+    /**
+     * Check if an error is an authentication error
+     */
+    static isAuthError(error: unknown): boolean;
+    /**
+     * Check if an error is a client error (4xx)
+     */
+    static isClientError(error: unknown): boolean;
+    /**
+     * Check if an error is a server error (5xx)
+     */
+    static isServerError(error: unknown): boolean;
+    /**
+     * Get user-friendly error message
+     */
+    static getUserFriendlyMessage(error: unknown): string;
+    /**
+     * Extract error details for logging
+     */
+    static getErrorDetails(error: unknown): {
+        type: string;
+        message: string;
+        code?: SynapseErrorCode | string;
+        status?: number;
+        timestamp?: Date;
+        stack?: string;
+        context?: Record<string, unknown>;
+        hint?: string;
+    };
+}
+//# sourceMappingURL=Error.d.ts.map

package/dist/utils/Error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Error.d.ts","sourceRoot":"","sources":["../../src/utils/Error.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,QAAQ,EAGR,gBAAgB,EAEjB,MAAM,yBAAyB,CAAC;AAGjC,qBAAa,UAAU;IACrB;;OAEG;IACH,MAAM,CAAC,UAAU,CACf,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,QAAQ,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAI9D;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAO9C;;OAEG;IACH,MAAM,CAAC,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI9C;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAO3C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAS7C;;OAEG;IACH,MAAM,CAAC,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAQ7C;;OAEG;IACH,MAAM,CAAC,sBAAsB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM;IA4BrD;;OAEG;IACH,MAAM,CAAC,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG;QACtC,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC;QACjC,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,SAAS,CAAC,EAAE,IAAI,CAAC;QACjB,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAClC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CAuCF"}

package/dist/utils/Error.js

@@ -0,0 +1,114 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ErrorUtils = void 0;
+const Error_1 = require("../internal/Error/Error");
+// Utility functions for error handling
+class ErrorUtils {
+    /**
+     * Check if an error is a specific API error type
+     */
+    static isAPIError(error) {
+        return error instanceof Error_1.APIError;
+    }
+    /**
+     * Check if an error is a network-related error
+     */
+    static isNetworkError(error) {
+        return (error instanceof Error_1.APIError &&
+            (error.status === 0 || error.status === undefined));
+    }
+    /**
+     * Check if an error is a timeout error
+     */
+    static isTimeoutError(error) {
+        return error instanceof Error_1.APIConnectionTimeoutError;
+    }
+    /**
+     * Check if an error is an authentication error
+     */
+    static isAuthError(error) {
+        return (error instanceof Error_1.UnauthorizedError ||
+            error instanceof Error_1.PermissionDeniedError);
+    }
+    /**
+     * Check if an error is a client error (4xx)
+     */
+    static isClientError(error) {
+        return (error instanceof Error_1.APIError &&
+            error.status !== undefined &&
+            error.status >= 400 &&
+            error.status < 500);
+    }
+    /**
+     * Check if an error is a server error (5xx)
+     */
+    static isServerError(error) {
+        return (error instanceof Error_1.APIError &&
+            error.status !== undefined &&
+            error.status >= 500);
+    }
+    /**
+     * Get user-friendly error message
+     */
+    static getUserFriendlyMessage(error) {
+        if (ErrorUtils.isNetworkError(error)) {
+            return "Unable to connect to the server. Please check your internet connection.";
+        }
+        if (ErrorUtils.isTimeoutError(error)) {
+            return "Request timed out. Please try again.";
+        }
+        if (ErrorUtils.isAuthError(error)) {
+            return "Authentication failed. Please log in again.";
+        }
+        if (ErrorUtils.isServerError(error)) {
+            return "Server error occurred. Please try again later.";
+        }
+        if (ErrorUtils.isAPIError(error)) {
+            return error.message;
+        }
+        if (error instanceof Error) {
+            return error.message;
+        }
+        return "An unexpected error occurred.";
+    }
+    /**
+     * Extract error details for logging
+     */
+    static getErrorDetails(error) {
+        if (ErrorUtils.isAPIError(error)) {
+            return {
+                type: error.name,
+                message: error.message,
+                code: error.code,
+                status: error.status,
+                timestamp: error.timestamp,
+                stack: error.stack,
+                context: error.context,
+                hint: error.hint,
+            };
+        }
+        if (error instanceof Error_1.SynapseError) {
+            return {
+                type: error.name,
+                message: error.message,
+                code: error.code,
+                timestamp: error.timestamp,
+                stack: error.stack,
+                context: error.context,
+                hint: error.hint,
+            };
+        }
+        if (error instanceof Error) {
+            return {
+                type: error.name,
+                message: error.message,
+                stack: error.stack,
+            };
+        }
+        return {
+            type: "Unknown",
+            message: String(error),
+        };
+    }
+}
+exports.ErrorUtils = ErrorUtils;

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@eka-care/medassist-core",
+  "version": "1.0.0",
+  "description": "TypeScript SDK for real-time medical chatbot experiences with session management, WebSocket connectivity, and media handling",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc --project tsconfig.build.json",
+    "prepublishOnly": "npm run build",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "synapse",
+    "sdk",
+    "medical",
+    "chatbot",
+    "websocket",
+    "typescript"
+  ],
+  "author": "Geethanjali S",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/eka-care/synapse-sdk.git"
+  },
+  "homepage": "https://github.com/eka-care/synapse-sdk/blob/main/README.md",
+  "dependencies": {
+    "jszip": "^3.10.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.0.0"
+  },
+  "peerDependencies": {},
+  "publishConfig": {
+    "access": "public"
+  }
+}