@uveysservetoglu/kobil-chat 1.0.0

package/README.md

@@ -0,0 +1,57 @@
+# @uveysservetoglu/kobil-chat
+
+KOBIL Chat (Mercury) client for Node.js / TypeScript, with automatic OAuth token management.
+
+```bash
+npm install @uveysservetoglu/kobil-chat
+```
+
+```ts
+import { ChatClient } from "@uveysservetoglu/kobil-chat";
+
+const chat = new ChatClient({
+  // credentials (or KOBIL_* env vars):
+  tokenEndpoint: process.env.KOBIL_TOKEN_ENDPOINT!,
+  clientId: process.env.KOBIL_CLIENT_ID!,
+  clientSecret: process.env.KOBIL_CLIENT_SECRET!,
+  tokenAuthMode: "basic", // the chat token endpoint may require Basic auth
+  // chat-specific:
+  chatBaseUrl: "https://idp.cloud.kobil.com/auth/realms/{TENANT}/mpower/v1/users/{USER_ID}",
+  tenantName: "acme",
+  mediaDownloadUrl: "https://idp.cloud.kobil.com/v1/mpower/tenants/{TENANT}/media/{MEDIA_ID}/download",
+});
+```
+
+`{TENANT}` is filled from `tenantName`, `{USER_ID}` from the call, `{MEDIA_ID}` from
+`getAttachmentFile`. `/message` or `/media` is appended to `chatBaseUrl` per operation.
+Message text supports styling: `*bold*`, `_italic_`, `~strike~`, `\n`.
+
+## The five operations
+
+```ts
+// 1. Plain text
+await chat.sendText({ userId, text: "Hi, how are you?", title: "Update" });
+
+// 2. Multi-choice
+await chat.sendChoice({ userId, text: "Continue?", choices: ["Yes", "No"] });
+
+// 3. SmartScreen
+await chat.sendSmartScreen({ userId, text: "Opening…", smartScreenServiceUuid: "service_client_id" });
+
+// 4. Attachment (content type inferred from the file name)
+await chat.sendAttachment({ userId, file: pdfBytes, fileName: "agreement.pdf", text: "Please review" });
+
+// 5. Download media
+const bytes = await chat.getAttachmentFile(mediaId);
+```
+
+All send operations return `{ messageId, instanceId }`. JavaScript usage is identical
+(`const { ChatClient } = require("@uveysservetoglu/kobil-chat")`).
+
+## Errors
+
+Failures throw `KobilChatError` (extends `KobilError`) with `statusCode` / `responseBody`.
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,39 @@
+import { KobilCredentials, KobilError, KobilServiceClient, TokenProvider } from "@uveysservetoglu/kobil-core";
+import { ChatMessageResult, SendAttachmentInput, SendChoiceInput, SendSmartScreenInput, SendTextInput } from "./types";
+export interface ChatClientOptions extends Partial<KobilCredentials> {
+    /** Message endpoint template up to the user segment, with {TENANT} and {USER_ID}. */
+    chatBaseUrl: string;
+    /** Media download template with {TENANT} and {MEDIA_ID}. Required for getAttachmentFile. */
+    mediaDownloadUrl?: string;
+    /** Tenant/realm name substituted for {TENANT}. */
+    tenantName?: string;
+    /** serviceUuid sent with messages. Optional: defaults to clientId. */
+    serviceUuid?: string;
+    /** Wire protocol version. Default: 3. */
+    version?: number;
+    /** Escape non-ASCII in the attachment message part (backend compatibility). Default: true. */
+    escapeAttachmentUnicode?: boolean;
+    tokenProvider?: TokenProvider;
+}
+/** Client for the KOBIL Chat (Mercury) API. */
+export declare class ChatClient extends KobilServiceClient {
+    private readonly chatBaseUrl;
+    private readonly mediaDownloadUrl?;
+    private readonly tenantName?;
+    private readonly clientId;
+    private readonly serviceUuidOption?;
+    private readonly version;
+    private readonly escapeUnicode;
+    constructor(options: ChatClientOptions);
+    protected makeError(message: string, statusCode?: number, responseBody?: string, cause?: unknown): KobilError;
+    sendText(input: SendTextInput, signal?: AbortSignal): Promise<ChatMessageResult>;
+    sendChoice(input: SendChoiceInput, signal?: AbortSignal): Promise<ChatMessageResult>;
+    sendSmartScreen(input: SendSmartScreenInput, signal?: AbortSignal): Promise<ChatMessageResult>;
+    sendAttachment(input: SendAttachmentInput, signal?: AbortSignal): Promise<ChatMessageResult>;
+    getAttachmentFile(mediaId: string, signal?: AbortSignal): Promise<Uint8Array>;
+    private messageUrl;
+    private mediaUrl;
+    private userBaseUrl;
+    private serviceUuid;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAEL,gBAAgB,EAChB,UAAU,EACV,kBAAkB,EAClB,aAAa,EAEd,MAAM,6BAA6B,CAAC;AAGrC,OAAO,EACL,iBAAiB,EACjB,mBAAmB,EACnB,eAAe,EACf,oBAAoB,EACpB,aAAa,EACd,MAAM,SAAS,CAAC;AAEjB,MAAM,WAAW,iBAAkB,SAAQ,OAAO,CAAC,gBAAgB,CAAC;IAClE,qFAAqF;IACrF,WAAW,EAAE,MAAM,CAAC;IACpB,4FAA4F;IAC5F,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,yCAAyC;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,uBAAuB,CAAC,EAAE,OAAO,CAAC;IAClC,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,+CAA+C;AAC/C,qBAAa,UAAW,SAAQ,kBAAkB;IAChD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAU;gBAE5B,OAAO,EAAE,iBAAiB;cAsBnB,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO,GAAG,UAAU;IAItH,QAAQ,CAAC,KAAK,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAUhF,UAAU,CAAC,KAAK,EAAE,eAAe,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAcpF,eAAe,CAAC,KAAK,EAAE,oBAAoB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAc9F,cAAc,CAAC,KAAK,EAAE,mBAAmB,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAqBtF,iBAAiB,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;IAOnF,OAAO,CAAC,UAAU;IAIlB,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,WAAW;CAGpB"}

package/dist/client.js

@@ -0,0 +1,141 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChatClient = void 0;
+const kobil_core_1 = require("@uveysservetoglu/kobil-core");
+const error_1 = require("./error");
+const mime_1 = require("./mime");
+/** Client for the KOBIL Chat (Mercury) API. */
+class ChatClient extends kobil_core_1.KobilServiceClient {
+    chatBaseUrl;
+    mediaDownloadUrl;
+    tenantName;
+    clientId;
+    serviceUuidOption;
+    version;
+    escapeUnicode;
+    constructor(options) {
+        const credentials = (0, kobil_core_1.credentialsFromEnv)({
+            tokenEndpoint: options.tokenEndpoint,
+            clientId: options.clientId,
+            clientSecret: options.clientSecret,
+            tokenAuthMode: options.tokenAuthMode,
+            defaultTokenTtlSeconds: options.defaultTokenTtlSeconds,
+            tokenExpirySkewSeconds: options.tokenExpirySkewSeconds,
+        });
+        super(options.tokenProvider ?? new kobil_core_1.DefaultTokenProvider(credentials));
+        if (!options.chatBaseUrl)
+            throw new kobil_core_1.KobilError("chatBaseUrl is required.");
+        this.chatBaseUrl = options.chatBaseUrl;
+        this.mediaDownloadUrl = options.mediaDownloadUrl;
+        this.tenantName = options.tenantName;
+        this.clientId = credentials.clientId;
+        this.serviceUuidOption = options.serviceUuid;
+        this.version = options.version ?? 3;
+        this.escapeUnicode = options.escapeAttachmentUnicode ?? true;
+    }
+    makeError(message, statusCode, responseBody, cause) {
+        return new error_1.KobilChatError(message, { statusCode, responseBody, cause });
+    }
+    sendText(input, signal) {
+        if (!input.userId)
+            throw new error_1.KobilChatError("userId cannot be empty.");
+        return this.sendJson("POST", this.messageUrl(input.userId), {
+            serviceUuid: this.serviceUuid(),
+            messageType: "processChatMessage",
+            version: this.version,
+            messageContent: { messageText: composeText(input.title, input.text) },
+        }, signal);
+    }
+    sendChoice(input, signal) {
+        if (!input.userId)
+            throw new error_1.KobilChatError("userId cannot be empty.");
+        if (!input.choices || input.choices.length === 0)
+            throw new error_1.KobilChatError("At least one choice is required.");
+        return this.sendJson("POST", this.messageUrl(input.userId), {
+            serviceUuid: this.serviceUuid(),
+            messageType: "choiceRequest",
+            version: this.version,
+            messageContent: {
+                messageText: input.text ?? "",
+                choices: input.choices.map((text) => ({ text })),
+            },
+        }, signal);
+    }
+    sendSmartScreen(input, signal) {
+        if (!input.userId)
+            throw new error_1.KobilChatError("userId cannot be empty.");
+        if (!input.smartScreenServiceUuid)
+            throw new error_1.KobilChatError("smartScreenServiceUuid cannot be empty.");
+        return this.sendJson("POST", this.messageUrl(input.userId), {
+            serviceUuid: this.serviceUuid(),
+            messageType: "smartScreenService",
+            version: this.version,
+            messageContent: {
+                messageText: input.text ?? "",
+                smartScreenServiceUuid: input.smartScreenServiceUuid,
+            },
+        }, signal);
+    }
+    sendAttachment(input, signal) {
+        if (!input.userId)
+            throw new error_1.KobilChatError("userId cannot be empty.");
+        if (!input.file || input.file.length === 0)
+            throw new error_1.KobilChatError("file cannot be empty.");
+        const message = {
+            serviceUuid: this.serviceUuid(),
+            messageType: "attachmentMessage",
+            version: this.version,
+            messageContent: { messageText: composeAttachmentText(input.title, input.text) },
+        };
+        let messageJson = JSON.stringify(message);
+        if (this.escapeUnicode)
+            messageJson = (0, mime_1.escapeNonAscii)(messageJson);
+        const form = new FormData();
+        const blob = new Blob([input.file], { type: (0, mime_1.resolveContentType)(input) });
+        form.append("attachment", blob, (0, mime_1.resolveFileName)(input));
+        form.append("message", messageJson);
+        return this.send("POST", this.mediaUrl(input.userId), form, signal);
+    }
+    async getAttachmentFile(mediaId, signal) {
+        if (!mediaId)
+            throw new error_1.KobilChatError("mediaId cannot be empty.");
+        if (!this.mediaDownloadUrl)
+            throw new kobil_core_1.KobilError("mediaDownloadUrl is required to download attachments.");
+        const url = replaceTokens(this.mediaDownloadUrl, { "{TENANT}": this.tenantName, "{MEDIA_ID}": mediaId });
+        return this.sendForBytes("POST", url, signal);
+    }
+    messageUrl(userId) {
+        return `${this.userBaseUrl(userId)}/message`;
+    }
+    mediaUrl(userId) {
+        return `${this.userBaseUrl(userId)}/media`;
+    }
+    userBaseUrl(userId) {
+        return replaceTokens(this.chatBaseUrl, { "{TENANT}": this.tenantName, "{USER_ID}": userId }).replace(/\/+$/, "");
+    }
+    serviceUuid() {
+        return this.serviceUuidOption && this.serviceUuidOption.length > 0 ? this.serviceUuidOption : this.clientId;
+    }
+}
+exports.ChatClient = ChatClient;
+function composeText(title, text) {
+    return title ? `${title}\n\n${text}` : text ?? "";
+}
+function composeAttachmentText(title, text) {
+    let out = "";
+    if (title)
+        out += `*${title}*`;
+    if (title && text)
+        out += `\n\n${text}`;
+    else if (!title && text)
+        out += text;
+    return out;
+}
+function replaceTokens(template, tokens) {
+    let result = template;
+    for (const [token, value] of Object.entries(tokens)) {
+        result = result.split(token).join(encodeURIComponent(value ?? ""));
+    }
+    return result;
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/error.d.ts

@@ -0,0 +1,5 @@
+import { KobilError } from "@uveysservetoglu/kobil-core";
+/** Thrown when a chat operation fails. */
+export declare class KobilChatError extends KobilError {
+}
+//# sourceMappingURL=error.d.ts.map

package/dist/error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.d.ts","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,0CAA0C;AAC1C,qBAAa,cAAe,SAAQ,UAAU;CAAG"}

package/dist/error.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KobilChatError = void 0;
+const kobil_core_1 = require("@uveysservetoglu/kobil-core");
+/** Thrown when a chat operation fails. */
+class KobilChatError extends kobil_core_1.KobilError {
+}
+exports.KobilChatError = KobilChatError;
+//# sourceMappingURL=error.js.map

package/dist/error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error.js","sourceRoot":"","sources":["../src/error.ts"],"names":[],"mappings":";;;AAAA,4DAAyD;AAEzD,0CAA0C;AAC1C,MAAa,cAAe,SAAQ,uBAAU;CAAG;AAAjD,wCAAiD"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ChatClient } from "./client";
+export type { ChatClientOptions } from "./client";
+export { KobilChatError } from "./error";
+export type { SendTextInput, SendChoiceInput, SendSmartScreenInput, SendAttachmentInput, ChatMessageResult, } from "./types";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACtC,YAAY,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AACzC,YAAY,EACV,aAAa,EACb,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,iBAAiB,GAClB,MAAM,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KobilChatError = exports.ChatClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "ChatClient", { enumerable: true, get: function () { return client_1.ChatClient; } });
+var error_1 = require("./error");
+Object.defineProperty(exports, "KobilChatError", { enumerable: true, get: function () { return error_1.KobilChatError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAAsC;AAA7B,oGAAA,UAAU,OAAA;AAEnB,iCAAyC;AAAhC,uGAAA,cAAc,OAAA"}

package/dist/mime.d.ts

@@ -0,0 +1,6 @@
+import { SendAttachmentInput } from "./types";
+export declare function resolveContentType(input: SendAttachmentInput): string;
+export declare function resolveFileName(input: SendAttachmentInput): string;
+/** Escapes non-ASCII characters to \uXXXX sequences (backend compatibility). */
+export declare function escapeNonAscii(text: string): string;
+//# sourceMappingURL=mime.d.ts.map

package/dist/mime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.d.ts","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AA8B9C,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAQrE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,mBAAmB,GAAG,MAAM,CAKlE;AAED,gFAAgF;AAChF,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAOnD"}

package/dist/mime.js

@@ -0,0 +1,61 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveContentType = resolveContentType;
+exports.resolveFileName = resolveFileName;
+exports.escapeNonAscii = escapeNonAscii;
+const crypto_1 = require("crypto");
+const MIME_BY_EXT = {
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".bmp": "image/bmp",
+    ".webp": "image/webp",
+    ".svg": "image/svg+xml",
+    ".pdf": "application/pdf",
+    ".doc": "application/msword",
+    ".docx": "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
+    ".xls": "application/vnd.ms-excel",
+    ".xlsx": "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
+    ".ppt": "application/vnd.ms-powerpoint",
+    ".pptx": "application/vnd.openxmlformats-officedocument.presentationml.presentation",
+    ".txt": "text/plain",
+    ".csv": "text/csv",
+    ".json": "application/json",
+    ".xml": "application/xml",
+    ".zip": "application/zip",
+    ".rar": "application/vnd.rar",
+    ".7z": "application/x-7z-compressed",
+    ".mp3": "audio/mpeg",
+    ".mp4": "video/mp4",
+    ".avi": "video/x-msvideo",
+    ".mov": "video/quicktime",
+};
+function resolveContentType(input) {
+    if (input.contentType)
+        return input.contentType;
+    let ext = input.fileExtension?.toLowerCase();
+    if (!ext && input.fileName) {
+        const idx = input.fileName.lastIndexOf(".");
+        ext = idx >= 0 ? input.fileName.slice(idx).toLowerCase() : undefined;
+    }
+    return (ext && MIME_BY_EXT[ext]) || "application/octet-stream";
+}
+function resolveFileName(input) {
+    if (input.fileName)
+        return input.fileName;
+    let ext = input.fileExtension?.toLowerCase() ?? ".bin";
+    if (!ext.startsWith("."))
+        ext = "." + ext;
+    return `${(0, crypto_1.randomUUID)()}${ext}`;
+}
+/** Escapes non-ASCII characters to \uXXXX sequences (backend compatibility). */
+function escapeNonAscii(text) {
+    let out = "";
+    for (const ch of text) {
+        const code = ch.codePointAt(0);
+        out += code > 127 ? "\\u" + code.toString(16).padStart(4, "0") : ch;
+    }
+    return out;
+}
+//# sourceMappingURL=mime.js.map

package/dist/mime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mime.js","sourceRoot":"","sources":["../src/mime.ts"],"names":[],"mappings":";;AA+BA,gDAQC;AAED,0CAKC;AAGD,wCAOC;AAxDD,mCAAoC;AAGpC,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,WAAW;IACnB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,oBAAoB;IAC5B,OAAO,EAAE,yEAAyE;IAClF,MAAM,EAAE,0BAA0B;IAClC,OAAO,EAAE,mEAAmE;IAC5E,MAAM,EAAE,+BAA+B;IACvC,OAAO,EAAE,2EAA2E;IACpF,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,UAAU;IAClB,OAAO,EAAE,kBAAkB;IAC3B,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,qBAAqB;IAC7B,KAAK,EAAE,6BAA6B;IACpC,MAAM,EAAE,YAAY;IACpB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,iBAAiB;IACzB,MAAM,EAAE,iBAAiB;CAC1B,CAAC;AAEF,SAAgB,kBAAkB,CAAC,KAA0B;IAC3D,IAAI,KAAK,CAAC,WAAW;QAAE,OAAO,KAAK,CAAC,WAAW,CAAC;IAChD,IAAI,GAAG,GAAG,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,CAAC;IAC7C,IAAI,CAAC,GAAG,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;QAC3B,MAAM,GAAG,GAAG,KAAK,CAAC,QAAQ,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;QAC5C,GAAG,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC;IACD,OAAO,CAAC,GAAG,IAAI,WAAW,CAAC,GAAG,CAAC,CAAC,IAAI,0BAA0B,CAAC;AACjE,CAAC;AAED,SAAgB,eAAe,CAAC,KAA0B;IACxD,IAAI,KAAK,CAAC,QAAQ;QAAE,OAAO,KAAK,CAAC,QAAQ,CAAC;IAC1C,IAAI,GAAG,GAAG,KAAK,CAAC,aAAa,EAAE,WAAW,EAAE,IAAI,MAAM,CAAC;IACvD,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC1C,OAAO,GAAG,IAAA,mBAAU,GAAE,GAAG,GAAG,EAAE,CAAC;AACjC,CAAC;AAED,gFAAgF;AAChF,SAAgB,cAAc,CAAC,IAAY;IACzC,IAAI,GAAG,GAAG,EAAE,CAAC;IACb,KAAK,MAAM,EAAE,IAAI,IAAI,EAAE,CAAC;QACtB,MAAM,IAAI,GAAG,EAAE,CAAC,WAAW,CAAC,CAAC,CAAE,CAAC;QAChC,GAAG,IAAI,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IACtE,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,35 @@
+export interface SendTextInput {
+    userId: string;
+    /** Message body. Supports styling: *bold*, _italic_, ~strike~, \n. */
+    text: string;
+    title?: string;
+}
+export interface SendChoiceInput {
+    userId: string;
+    text: string;
+    choices: string[];
+}
+export interface SendSmartScreenInput {
+    userId: string;
+    text: string;
+    smartScreenServiceUuid: string;
+}
+export interface SendAttachmentInput {
+    userId: string;
+    /** Raw file bytes. */
+    file: Uint8Array;
+    /** File name. If omitted, one is generated from the extension. */
+    fileName?: string;
+    /** MIME type. If omitted, inferred from the file name/extension. */
+    contentType?: string;
+    /** Extension (e.g. ".png") used to infer content type / file name when not given. */
+    fileExtension?: string;
+    title?: string;
+    text?: string;
+}
+export interface ChatMessageResult {
+    messageId?: string;
+    instanceId?: string;
+    [key: string]: unknown;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,sBAAsB,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,mBAAmB;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,sBAAsB;IACtB,IAAI,EAAE,UAAU,CAAC;IACjB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,oEAAoE;IACpE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB"}

package/dist/types.js

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

package/dist/types.js.map

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

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@uveysservetoglu/kobil-chat",
+  "version": "1.0.0",
+  "description": "KOBIL Chat (Mercury) client for Node.js: send text, multi-choice and SmartScreen messages, send attachments and download media, with automatic OAuth token management.",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "keywords": [
+    "kobil",
+    "chat",
+    "mercury",
+    "messaging"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/uveysservetoglu/kobil-sdks"
+  },
+  "dependencies": {
+    "@uveysservetoglu/kobil-core": "^1.0.0"
+  },
+  "scripts": {
+    "build": "tsc -b"
+  }
+}