xyne-apps 1.0.0

package/README.md

@@ -0,0 +1,243 @@
+# xyne-apps
+
+A TypeScript SDK for interacting with the **Xyne Apps API**. It provides typed modules for Chat, Tickets, Users, and File uploads.
+
+---
+
+## Installation
+
+```bash
+npm install xyne-apps
+```
+
+> **Requirements:** Node.js 18+ (uses the native `fetch` and `FormData` globals).
+
+---
+
+## Quick Start
+
+```typescript
+import { createClient } from "xyne-apps";
+
+const client = createClient({ authToken: "YOUR_AUTH_TOKEN" });
+```
+
+> All requests are sent to the Xyne Spaces API at:
+> `https://spaces.xyne.juspay.net/api/apps`
+
+---
+
+## Modules
+
+### `client.chat` — Chat Module
+
+#### `postMessage(params)`
+
+Sends a message to a channel or a conversation. Either `channelId` or `conversationId` is required.
+
+```typescript
+const response = await client.chat.postMessage({
+  text: "Hello, world!",
+  channelId: "channel-123",
+  // or: conversationId: "conv-456",
+});
+// response: { eventType, conversationId, messageId }
+```
+
+| Parameter        | Type     | Required |
+| ---------------- | -------- | -------- |
+| `text`           | `string` | ✅       |
+| `channelId`      | `string` | ✅ (one of) |
+| `conversationId` | `string` | ✅ (one of) |
+
+---
+
+#### `updateMessage(params)`
+
+Updates the text of an existing message. Either `channelId` or `conversationId` is required.
+
+```typescript
+const response = await client.chat.updateMessage({
+  messageId: "msg-789",
+  text: "Updated message text",
+  channelId: "channel-123",
+});
+// response: { eventType, conversationId, messageId }
+```
+
+| Parameter        | Type     | Required |
+| ---------------- | -------- | -------- |
+| `messageId`      | `string` | ✅       |
+| `text`           | `string` | ✅       |
+| `channelId`      | `string` | ✅ (one of) |
+| `conversationId` | `string` | ✅ (one of) |
+
+---
+
+#### `channelHistory(params)`
+
+Fetches paginated message history for a channel.
+
+```typescript
+const history = await client.chat.channelHistory({
+  channelId: "channel-123",
+  limit: "50",       // optional, defaults to 1000
+  cursor: "...",     // optional, for pagination
+});
+// history: { items, nextCursor, hasMore }
+```
+
+| Parameter   | Type     | Required |
+| ----------- | -------- | -------- |
+| `channelId` | `string` | ✅       |
+| `limit`     | `string` | ❌ (default: 1000) |
+| `cursor`    | `string` | ❌       |
+
+---
+
+#### `conversationReplies(params)`
+
+Fetches paginated replies for a conversation.
+
+```typescript
+const replies = await client.chat.conversationReplies({
+  conversationId: "conv-456",
+  channelId: "channel-123", // optional
+  limit: "25",
+  cursor: "...",
+});
+// replies: { items, nextCursor, hasMore }
+```
+
+| Parameter        | Type     | Required |
+| ---------------- | -------- | -------- |
+| `conversationId` | `string` | ✅       |
+| `channelId`      | `string` | ❌       |
+| `limit`          | `string` | ❌ (default: 1000) |
+| `cursor`         | `string` | ❌       |
+
+---
+
+### `client.tickets` — Tickets Module
+
+#### `createTicket(params)`
+
+Creates a new ticket.
+
+```typescript
+import { TicketPriority } from "xyne-apps";
+
+const ticket = await client.tickets.createTicket({
+  title: "Bug: login broken",
+  description: "Users cannot log in with SSO.",
+  projectId: "proj-001",
+  boardId: "board-001",
+  channelId: "channel-123",
+  userId: "user-42",
+  priority: TicketPriority.HIGH,            // optional: LOW | MEDIUM | HIGH
+  assignedToEmail: "engineer@example.com",  // optional
+  assignedUserGroupAlias: "backend-team",   // optional
+  text: "Additional context…",              // optional
+});
+// ticket: { eventType, ticketId, xyneId, conversationId, messageId }
+```
+
+| Parameter                | Type             | Required |
+| ------------------------ | ---------------- | -------- |
+| `title`                  | `string`         | ✅       |
+| `description`            | `string`         | ✅       |
+| `projectId`              | `string`         | ✅       |
+| `boardId`                | `string`         | ✅       |
+| `channelId`              | `string`         | ✅       |
+| `userId`                 | `string`         | ✅       |
+| `priority`               | `TicketPriority` | ❌       |
+| `assignedToEmail`        | `string`         | ❌       |
+| `assignedUserGroupAlias` | `string`         | ❌       |
+| `text`                   | `string`         | ❌       |
+
+---
+
+### `client.user` — User Module
+
+#### `info(params)`
+
+Fetches profile information for a user. Either `channelId` or `conversationId` is required.
+
+```typescript
+const user = await client.user.info({
+  user: "user-42",
+  channelId: "channel-123",
+  // or: conversationId: "conv-456",
+});
+// user: { userId, name, email, picture, userType, status, joined }
+```
+
+| Parameter        | Type     | Required |
+| ---------------- | -------- | -------- |
+| `user`           | `string` | ✅       |
+| `channelId`      | `string` | ✅ (one of) |
+| `conversationId` | `string` | ✅ (one of) |
+
+---
+
+### `client.files` — Files Module
+
+#### `filesUpload(params)`
+
+Uploads one or more files to a channel or conversation. Either `channelId` or `conversationId` is required.
+
+```typescript
+import { readFileSync } from "fs";
+
+const blob = new Blob([readFileSync("report.pdf")], { type: "application/pdf" });
+
+const result = await client.files.filesUpload({
+  files: [blob],
+  channelId: "channel-123",
+  // or: conversationId: "conv-456",
+  text: "Here is the report",  // optional caption
+});
+// result: { eventType, conversationId, messageId, attachments }
+```
+
+| Parameter        | Type       | Required |
+| ---------------- | ---------- | -------- |
+| `files`          | `Blob[]`   | ✅ (min 1) |
+| `channelId`      | `string`   | ✅ (one of) |
+| `conversationId` | `string`   | ✅ (one of) |
+| `text`           | `string`   | ❌       |
+
+---
+
+## Error Handling
+
+All methods throw a `XyneApiError` when the server returns a non-2xx response.
+
+```typescript
+import { XyneApiError } from "xyne-apps";
+
+try {
+  await client.chat.postMessage({ text: "Hi", channelId: "channel-123" });
+} catch (err) {
+  if (err instanceof XyneApiError) {
+    console.error(err.status);    // HTTP status code
+    console.error(err.bodyText);  // Raw response body
+    console.error(err.message);   // Human-readable error message
+  }
+}
+```
+
+---
+
+## Building from Source
+
+```bash
+npm install
+npm run build   # runs tsc, output goes to dist/
+```
+
+---
+
+## License
+
+ISC

package/dist/client.d.ts

@@ -0,0 +1,29 @@
+import { ChatModule } from "./modules/chat/index.js";
+import { TicketsModule } from "./modules/tickets/index.js";
+import { UserModule } from "./modules/user/index.js";
+import { FilesModule } from "./modules/files/index.js";
+export type HttpMethod = "GET" | "POST";
+export interface XyneClientOptions {
+    authToken: string;
+}
+export declare class XyneApiError extends Error {
+    readonly status: number;
+    readonly bodyText: string;
+    constructor(message: string, status: number, bodyText: string);
+}
+export declare class XyneClient {
+    readonly chat: ChatModule;
+    readonly tickets: TicketsModule;
+    readonly files: FilesModule;
+    readonly user: UserModule;
+    private readonly authToken;
+    constructor(options: XyneClientOptions);
+    request<TResponse = unknown>(args: {
+        method: HttpMethod;
+        path: string;
+        body?: unknown;
+        headers?: Record<string, string>;
+    }): Promise<TResponse>;
+}
+export declare function createClient(options: XyneClientOptions): XyneClient;
+//# 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,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAIvD,MAAM,MAAM,UAAU,GAAG,KAAK,GAAG,MAAM,CAAC;AAExC,MAAM,WAAW,iBAAiB;IAChC,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,YAAa,SAAQ,KAAK;IACrC,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,EAAE,MAAM,CAAC;gBAErB,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;CAM9D;AAED,qBAAa,UAAU;IACrB,SAAgB,IAAI,EAAE,UAAU,CAAC;IACjC,SAAgB,OAAO,EAAE,aAAa,CAAC;IACvC,SAAgB,KAAK,EAAE,WAAW,CAAC;IACnC,SAAgB,IAAI,EAAE,UAAU,CAAC;IAEjC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,iBAAiB;IAQzB,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,IAAI,EAAE;QAC9C,MAAM,EAAE,UAAU,CAAC;QACnB,IAAI,EAAE,MAAM,CAAC;QACb,IAAI,CAAC,EAAE,OAAO,CAAC;QACf,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;KAClC,GAAG,OAAO,CAAC,SAAS,CAAC;CAoCvB;AAED,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,UAAU,CAEnE"}

package/dist/client.js

@@ -0,0 +1,61 @@
+import { ChatModule } from "./modules/chat/index.js";
+import { TicketsModule } from "./modules/tickets/index.js";
+import { UserModule } from "./modules/user/index.js";
+import { FilesModule } from "./modules/files/index.js";
+const BASE_URL = "https://spaces.xyne.juspay.net/api/apps";
+export class XyneApiError extends Error {
+    status;
+    bodyText;
+    constructor(message, status, bodyText) {
+        super(message);
+        this.name = "XyneApiError";
+        this.status = status;
+        this.bodyText = bodyText;
+    }
+}
+export class XyneClient {
+    chat;
+    tickets;
+    files;
+    user;
+    authToken;
+    constructor(options) {
+        this.authToken = options.authToken;
+        this.chat = new ChatModule(this);
+        this.tickets = new TicketsModule(this);
+        this.files = new FilesModule(this);
+        this.user = new UserModule(this);
+    }
+    async request(args) {
+        const url = `${BASE_URL}${args.path}`;
+        const headers = {
+            ...(args.headers ?? {}),
+            Authorization: `Bearer ${this.authToken}`,
+        };
+        const init = { method: args.method, headers };
+        if (args.body !== undefined) {
+            const formDataCtor = globalThis["FormData"];
+            const isFormData = !!formDataCtor && args.body instanceof formDataCtor;
+            if (isFormData) {
+                // Let the runtime set the correct `Content-Type` boundary for multipart.
+                init.body = args.body;
+            }
+            else {
+                headers["Content-Type"] = "application/json";
+                init.body = JSON.stringify(args.body);
+            }
+        }
+        const res = await globalThis.fetch(url, init);
+        const bodyText = await res.text();
+        if (!res.ok) {
+            throw new XyneApiError(`Request failed with status ${res.status} for ${args.method} ${url}`, res.status, bodyText);
+        }
+        if (!bodyText)
+            return undefined;
+        return JSON.parse(bodyText);
+    }
+}
+export function createClient(options) {
+    return new XyneClient(options);
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAEvD,MAAM,QAAQ,GAAG,yCAAyC,CAAC;AAQ3D,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrB,MAAM,CAAS;IACf,QAAQ,CAAS;IAEjC,YAAY,OAAe,EAAE,MAAc,EAAE,QAAgB;QAC3D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;CACF;AAED,MAAM,OAAO,UAAU;IACL,IAAI,CAAa;IACjB,OAAO,CAAgB;IACvB,KAAK,CAAc;IACnB,IAAI,CAAa;IAEhB,SAAS,CAAS;IAEnC,YAAY,OAA0B;QACpC,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;QACjC,IAAI,CAAC,OAAO,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;QACvC,IAAI,CAAC,KAAK,GAAG,IAAI,WAAW,CAAC,IAAI,CAAC,CAAC;QACnC,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC,IAAI,CAAC,CAAC;IACnC,CAAC;IAEM,KAAK,CAAC,OAAO,CAAsB,IAKzC;QACC,MAAM,GAAG,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAEtC,MAAM,OAAO,GAA2B;YACtC,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,CAAC;YACvB,aAAa,EAAE,UAAU,IAAI,CAAC,SAAS,EAAE;SAC1C,CAAC;QAEF,MAAM,IAAI,GAAgB,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC;QAE3D,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC5B,MAAM,YAAY,GAAI,UAAsC,CAAC,UAAU,CAAC,CAAC;YACzE,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,IAAI,IAAI,CAAC,IAAI,YAAa,YAAgC,CAAC;YAC5F,IAAI,UAAU,EAAE,CAAC;gBACf,yEAAyE;gBACzE,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,IAAgB,CAAC;YACpC,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;gBAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;QACH,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC9C,MAAM,QAAQ,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAElC,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;YACZ,MAAM,IAAI,YAAY,CACpB,8BAA8B,GAAG,CAAC,MAAM,QAAQ,IAAI,CAAC,MAAM,IAAI,GAAG,EAAE,EACpE,GAAG,CAAC,MAAM,EACV,QAAQ,CACT,CAAC;QACJ,CAAC;QAED,IAAI,CAAC,QAAQ;YAAE,OAAO,SAAsB,CAAC;QAC7C,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAc,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,YAAY,CAAC,OAA0B;IACrD,OAAO,IAAI,UAAU,CAAC,OAAO,CAAC,CAAC;AACjC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export { createClient, XyneApiError, XyneClient } from "./client.js";
+export type { XyneClientOptions } from "./client.js";
+export { ChatModule } from "./modules/chat/index.js";
+export { TicketsModule } from "./modules/tickets/index.js";
+export { UserModule } from "./modules/user/index.js";
+export { FilesModule } from "./modules/files/index.js";
+export type { ChatPostMessageParams, ChatPostMessageResponse, ChatUpdateMessageParams, ChatUpdateMessageResponse, AppEventAttachment, ChannelHistoryQueryParams, ChannelHistoryItem, ConversationRepliesQueryParams, ConversationRepliesItem, ChatPaginatedResponse, } from "./modules/chat/schema.js";
+export { CreateTicketBodySchema, type CreateTicketBodyParams, type TicketActionResponse, TicketPriority, } from "./modules/tickets/schema.js";
+export { UserInfoQuerySchema, type UserInfoQueryParams, type UserResponse, } from "./modules/user/schema.js";
+export { UploadFilesInputSchema, type UploadFilesInput, type FileUploadResponse, } from "./modules/files/schema.js";
+//# 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,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACrE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,YAAY,EACV,qBAAqB,EACrB,uBAAuB,EACvB,uBAAuB,EACvB,yBAAyB,EACzB,kBAAkB,EAClB,yBAAyB,EACzB,kBAAkB,EAClB,8BAA8B,EAC9B,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,sBAAsB,EACtB,KAAK,sBAAsB,EAC3B,KAAK,oBAAoB,EACzB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,mBAAmB,EACnB,KAAK,mBAAmB,EACxB,KAAK,YAAY,GAClB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,EACrB,KAAK,kBAAkB,GACxB,MAAM,2BAA2B,CAAC"}

package/dist/index.js

@@ -0,0 +1,9 @@
+export { createClient, XyneApiError, XyneClient } from "./client.js";
+export { ChatModule } from "./modules/chat/index.js";
+export { TicketsModule } from "./modules/tickets/index.js";
+export { UserModule } from "./modules/user/index.js";
+export { FilesModule } from "./modules/files/index.js";
+export { CreateTicketBodySchema, TicketPriority, } from "./modules/tickets/schema.js";
+export { UserInfoQuerySchema, } from "./modules/user/schema.js";
+export { UploadFilesInputSchema, } from "./modules/files/schema.js";
+//# 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,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGrE,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAcvD,OAAO,EACL,sBAAsB,EAGtB,cAAc,GACf,MAAM,6BAA6B,CAAC;AAErC,OAAO,EACL,mBAAmB,GAGpB,MAAM,0BAA0B,CAAC;AAElC,OAAO,EACL,sBAAsB,GAGvB,MAAM,2BAA2B,CAAC"}

package/dist/modules/chat/index.d.ts

@@ -0,0 +1,23 @@
+import type { XyneClient } from "../../client.js";
+import { type ChatPostMessageParams, type ChatPostMessageResponse, type ChatUpdateMessageParams, type ChatUpdateMessageResponse, type ChannelHistoryQueryParams, type ConversationRepliesQueryParams, type ChatPaginatedResponse } from "./schema.js";
+export declare class ChatModule {
+    private readonly client;
+    constructor(client: XyneClient);
+    /**
+     * Sends a message to either a channel or a conversation.
+     */
+    postMessage(params: ChatPostMessageParams): Promise<ChatPostMessageResponse>;
+    /**
+     * Updates an existing message.
+     */
+    updateMessage(params: ChatUpdateMessageParams): Promise<ChatUpdateMessageResponse>;
+    /**
+     * Fetches channel/conversation message history with pagination.
+     */
+    channelHistory(params: ChannelHistoryQueryParams): Promise<ChatPaginatedResponse>;
+    /**
+     * Fetches replies for a given conversation with pagination.
+     */
+    conversationReplies(params: ConversationRepliesQueryParams): Promise<ChatPaginatedResponse>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/modules/chat/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/modules/chat/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAKL,KAAK,qBAAqB,EAC1B,KAAK,uBAAuB,EAC5B,KAAK,uBAAuB,EAC5B,KAAK,yBAAyB,EAC9B,KAAK,yBAAyB,EAC9B,KAAK,8BAA8B,EACnC,KAAK,qBAAqB,EAC3B,MAAM,aAAa,CAAC;AAErB,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAAN,MAAM,EAAE,UAAU;IAE/C;;OAEG;IACU,WAAW,CACtB,MAAM,EAAE,qBAAqB,GAC5B,OAAO,CAAC,uBAAuB,CAAC;IAgBnC;;OAEG;IACU,aAAa,CACxB,MAAM,EAAE,uBAAuB,GAC9B,OAAO,CAAC,yBAAyB,CAAC;IAkBrC;;OAEG;IACU,cAAc,CACzB,MAAM,EAAE,yBAAyB,GAChC,OAAO,CAAC,qBAAqB,CAAC;IAgBjC;;OAEG;IACU,mBAAmB,CAC9B,MAAM,EAAE,8BAA8B,GACrC,OAAO,CAAC,qBAAqB,CAAC;CAgBlC"}

package/dist/modules/chat/index.js

@@ -0,0 +1,76 @@
+import { ChatPostMessageSchema, ChatUpdateMessageSchema, ChannelHistoryQuerySchema, ConversationRepliesQuerySchema, } from "./schema.js";
+export class ChatModule {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    /**
+     * Sends a message to either a channel or a conversation.
+     */
+    async postMessage(params) {
+        const parsed = ChatPostMessageSchema.parse(params);
+        const body = {
+            text: parsed.text,
+            ...(parsed.channelId && { channelId: parsed.channelId }),
+            ...(parsed.conversationId && { conversationId: parsed.conversationId }),
+        };
+        return this.client.request({
+            method: "POST",
+            path: "/chat/postMessage",
+            body,
+        });
+    }
+    /**
+     * Updates an existing message.
+     */
+    async updateMessage(params) {
+        const parsed = ChatUpdateMessageSchema.parse(params);
+        const body = {
+            messageId: parsed.messageId,
+            text: parsed.text,
+            ...(parsed.channelId
+                ? { channelId: parsed.channelId }
+                : { conversationId: parsed.conversationId }),
+        };
+        return this.client.request({
+            method: "POST",
+            path: "/chat/updateMessage",
+            body,
+        });
+    }
+    /**
+     * Fetches channel/conversation message history with pagination.
+     */
+    async channelHistory(params) {
+        const parsed = ChannelHistoryQuerySchema.parse(params);
+        const queryParams = new URLSearchParams();
+        queryParams.set("channelId", parsed.channelId);
+        queryParams.set("limit", String(parsed.limit));
+        if (parsed.cursor)
+            queryParams.set("cursor", parsed.cursor);
+        const result = await this.client.request({
+            method: "GET",
+            path: `/chat/channelHistory?${queryParams.toString()}`,
+        });
+        return result;
+    }
+    /**
+     * Fetches replies for a given conversation with pagination.
+     */
+    async conversationReplies(params) {
+        const parsed = ConversationRepliesQuerySchema.parse(params);
+        const queryParams = new URLSearchParams();
+        queryParams.set("conversationId", parsed.conversationId);
+        if (parsed.channelId)
+            queryParams.set("channelId", parsed.channelId);
+        queryParams.set("limit", String(parsed.limit));
+        if (parsed.cursor)
+            queryParams.set("cursor", parsed.cursor);
+        const result = await this.client.request({
+            method: "GET",
+            path: `/chat/conversationReplies?${queryParams.toString()}`,
+        });
+        return result;
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/chat/index.js.map

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

package/dist/modules/chat/schema.d.ts

@@ -0,0 +1,124 @@
+import { z } from "zod";
+export declare const ChatPostMessageSchema: z.ZodEffects<z.ZodObject<{
+    text: z.ZodString;
+} & {
+    channelId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}, {
+    text: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}>, {
+    text: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}, {
+    text: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}>;
+export type ChatPostMessageParams = z.infer<typeof ChatPostMessageSchema>;
+export interface ChatPostMessageResponse {
+    eventType: string;
+    conversationId: string;
+    messageId: string;
+}
+export declare const ChatUpdateMessageSchema: z.ZodEffects<z.ZodObject<{
+    messageId: z.ZodString;
+    text: z.ZodString;
+} & {
+    channelId: z.ZodOptional<z.ZodString>;
+    conversationId: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    text: string;
+    messageId: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}, {
+    text: string;
+    messageId: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}>, {
+    text: string;
+    messageId: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}, {
+    text: string;
+    messageId: string;
+    channelId?: string | undefined;
+    conversationId?: string | undefined;
+}>;
+export type ChatUpdateMessageParams = z.infer<typeof ChatUpdateMessageSchema>;
+export interface ChatUpdateMessageResponse {
+    eventType: string;
+    conversationId: string;
+    messageId: string;
+}
+export declare const ChannelHistoryQuerySchema: z.ZodObject<{
+    channelId: z.ZodString;
+    limit: z.ZodEffects<z.ZodOptional<z.ZodString>, number, string | undefined>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    channelId: string;
+    limit: number;
+    cursor?: string | undefined;
+}, {
+    channelId: string;
+    limit?: string | undefined;
+    cursor?: string | undefined;
+}>;
+export type ChannelHistoryQueryParams = z.input<typeof ChannelHistoryQuerySchema>;
+export declare const ConversationRepliesQuerySchema: z.ZodObject<{
+    conversationId: z.ZodString;
+    channelId: z.ZodOptional<z.ZodString>;
+    limit: z.ZodEffects<z.ZodOptional<z.ZodString>, number, string | undefined>;
+    cursor: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    conversationId: string;
+    limit: number;
+    channelId?: string | undefined;
+    cursor?: string | undefined;
+}, {
+    conversationId: string;
+    channelId?: string | undefined;
+    limit?: string | undefined;
+    cursor?: string | undefined;
+}>;
+export type ConversationRepliesQueryParams = z.input<typeof ConversationRepliesQuerySchema>;
+export interface AppEventAttachment {
+    attachmentId: string;
+    fileName: string;
+    fileSize: number;
+    mimeType: string;
+    fileUrl: string;
+}
+export interface ChannelHistoryItem {
+    initialMessageId: string;
+    conversationId: string;
+    content: string;
+    cleanContent: string;
+    userId: string;
+    createdAt: Date;
+    attachments?: AppEventAttachment[];
+}
+export interface ConversationRepliesItem {
+    messageId: string;
+    conversationId: string;
+    content: string;
+    cleanContent: string;
+    userId: string;
+    createdAt: Date;
+    attachments?: AppEventAttachment[];
+}
+export interface ChatPaginatedResponse {
+    items: ChannelHistoryItem[] | ConversationRepliesItem[];
+    nextCursor?: string;
+    hasMore: boolean;
+}
+//# sourceMappingURL=schema.d.ts.map

package/dist/modules/chat/schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.d.ts","sourceRoot":"","sources":["../../../src/modules/chat/schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;EAc/B,CAAC;AAEJ,MAAM,MAAM,qBAAqB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAE1E,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;EAgBhC,CAAC;AAEL,MAAM,MAAM,uBAAuB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAE9E,MAAM,WAAW,yBAAyB;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,eAAO,MAAM,yBAAyB;;;;;;;;;;;;EAQlC,CACD;AAEH,MAAM,MAAM,yBAAyB,GAAG,CAAC,CAAC,KAAK,CAC7C,OAAO,yBAAyB,CACjC,CAAC;AAEF,eAAO,MAAM,8BAA8B;;;;;;;;;;;;;;;EAYvC,CAAC;AAEL,MAAM,MAAM,8BAA8B,GAAG,CAAC,CAAC,KAAK,CAClD,OAAO,8BAA8B,CACtC,CAAC;AAEF,MAAM,WAAW,kBAAkB;IACjC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,kBAAkB;IACjC,gBAAgB,EAAE,MAAM,CAAC;IACzB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,cAAc,EAAE,MAAM,CAAC;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,YAAY,EAAE,MAAM,CAAC;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,IAAI,CAAC;IAChB,WAAW,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACpC;AAED,MAAM,WAAW,qBAAqB;IACpC,KAAK,EAAE,kBAAkB,EAAE,GAAG,uBAAuB,EAAE,CAAC;IACxD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,OAAO,CAAC;CAClB"}

package/dist/modules/chat/schema.js

@@ -0,0 +1,53 @@
+import { z } from "zod";
+export const ChatPostMessageSchema = z
+    .object({
+    text: z.string().min(1, "text is required").trim(),
+})
+    .extend({
+    channelId: z.string().min(1, "Channel ID is required").trim().optional(),
+    conversationId: z.string().trim().optional(),
+})
+    .refine((data) => !!data.channelId || !!data.conversationId, {
+    message: "Either channelId or conversationId is required",
+    path: ["channelId"],
+});
+export const ChatUpdateMessageSchema = z
+    .object({
+    messageId: z.string().min(1, "messageId is required").trim(),
+    text: z.string().min(1, "text is required").trim(),
+})
+    .extend({
+    channelId: z.string().min(1, "channelId is required").trim().optional(),
+    conversationId: z
+        .string()
+        .min(1, "conversationId is required")
+        .trim()
+        .optional(),
+})
+    .refine((data) => !!data.channelId || !!data.conversationId, {
+    message: "At least one of channelId or conversationId is required",
+    path: ["channelId"],
+});
+export const ChannelHistoryQuerySchema = z
+    .object({
+    channelId: z.string().min(1, "Channel ID is required").trim(),
+    limit: z
+        .string()
+        .optional()
+        .transform((val) => (val ? parseInt(val, 10) : 1000)),
+    cursor: z.string().optional(),
+});
+export const ConversationRepliesQuerySchema = z
+    .object({
+    conversationId: z
+        .string()
+        .min(1, "Conversation ID is required")
+        .trim(),
+    channelId: z.string().min(1, "Channel ID is required").trim().optional(),
+    limit: z
+        .string()
+        .optional()
+        .transform((val) => (val ? parseInt(val, 10) : 1000)),
+    cursor: z.string().optional(),
+});
+//# sourceMappingURL=schema.js.map