@copera.ai/sdk 1.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Copera.ai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,505 @@
+# Copera.ai Node.js SDK
+
+[![npm version](https://img.shields.io/npm/v/@copera.ai/sdk.svg)](https://www.npmjs.com/package/@copera.ai/sdk)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![Node.js Version](https://img.shields.io/node/v/@copera.ai/sdk.svg)](https://nodejs.org)
+
+Official Node.js SDK for [Copera.ai](https://copera.ai) - The ultimate platform for workflow automation and data management.
+
+> **📖 Full Documentation**: For complete guides, tutorials, and API reference, visit [developers.copera.ai](https://developers.copera.ai)
+
+## Features
+
+- ✨ **Full TypeScript Support** - Complete type definitions for all API endpoints
+- 🔄 **Modern ESM & CJS** - Works with both ES modules and CommonJS
+- 🏭 **Factory Pattern** - Clean dependency injection architecture
+- 🧪 **Sandbox Mode** - Test against development environment
+- 🎯 **Type-Safe** - Full IntelliSense support in your IDE
+- 📦 **Zero Dependencies** - Uses native Fetch API
+- ✅ **Fully Tested** - Comprehensive test coverage
+
+## Installation
+
+```bash
+# npm
+npm install @copera.ai/sdk
+
+# yarn
+yarn add @copera.ai/sdk
+
+# pnpm
+pnpm add @copera.ai/sdk
+```
+
+## Requirements
+
+- Node.js 18 or higher
+- An API key from [Copera.ai](https://copera.ai)
+
+## Quick Start
+
+```typescript
+import { CoperaAI } from '@copera.ai/sdk';
+
+// Initialize the SDK
+const copera = CoperaAI({
+  apiKey: 'your-api-key-here'
+});
+
+// List all boards
+const boards = await copera.board.listBoards();
+console.log(boards);
+
+// Send a message to a channel
+await copera.channel.sendMessage({
+  channelId: 'channel-id',
+  message: 'Hello from Copera.ai SDK!'
+});
+```
+
+## Configuration
+
+### Basic Configuration
+
+```typescript
+import { CoperaAI } from '@copera.ai/sdk';
+
+const copera = CoperaAI({
+  apiKey: process.env.COPERA_API_KEY
+});
+```
+
+### Sandbox Mode
+
+Use sandbox mode to test against the development environment:
+
+```typescript
+const copera = CoperaAI({
+  apiKey: process.env.COPERA_API_KEY,
+  sandbox: true  // Use development environment
+});
+```
+
+## API Reference
+
+### Board Methods
+
+#### `listBoards()`
+
+List all boards available in your workspace.
+
+```typescript
+const boards = await copera.board.listBoards();
+```
+
+**Returns:** `Promise<Board[]>`
+
+#### `getBoardDetails(params)`
+
+Get details of a specific board.
+
+```typescript
+const board = await copera.board.getBoardDetails({
+  boardId: 'board-id'
+});
+```
+
+**Parameters:**
+- `boardId` (string, required) - The board ID
+
+**Returns:** `Promise<Board>`
+
+#### `listBoardTables(params)`
+
+List all tables in a specific board.
+
+```typescript
+const tables = await copera.board.listBoardTables({
+  boardId: 'board-id'
+});
+```
+
+**Parameters:**
+- `boardId` (string, required) - The board ID
+
+**Returns:** `Promise<Table[]>`
+
+#### `getBoardTable(params)`
+
+Get details of a specific table.
+
+```typescript
+const table = await copera.board.getBoardTable({
+  boardId: 'board-id',
+  tableId: 'table-id'
+});
+```
+
+**Parameters:**
+- `boardId` (string, required) - The board ID
+- `tableId` (string, required) - The table ID
+
+**Returns:** `Promise<Table>`
+
+#### `listTableRows(params)`
+
+List all rows in a table.
+
+```typescript
+const rows = await copera.board.listTableRows({
+  boardId: 'board-id',
+  tableId: 'table-id'
+});
+```
+
+**Parameters:**
+- `boardId` (string, required) - The board ID
+- `tableId` (string, required) - The table ID
+
+**Returns:** `Promise<Row[]>`
+
+#### `getTableRow(params)`
+
+Get a specific row from a table.
+
+```typescript
+const row = await copera.board.getTableRow({
+  boardId: 'board-id',
+  tableId: 'table-id',
+  rowId: 'row-id'
+});
+```
+
+**Parameters:**
+- `boardId` (string, required) - The board ID
+- `tableId` (string, required) - The table ID
+- `rowId` (string, required) - The row ID
+
+**Returns:** `Promise<Row>`
+
+#### `createTableRow(params)`
+
+Create a new row in a table.
+
+```typescript
+const newRow = await copera.board.createTableRow({
+  boardId: 'board-id',
+  tableId: 'table-id',
+  description: 'Optional description',
+  columns: [
+    { columnId: 'column-1', value: 'Value 1' },
+    { columnId: 'column-2', value: 'Value 2' }
+  ]
+});
+```
+
+**Parameters:**
+- `boardId` (string, required) - The board ID
+- `tableId` (string, required) - The table ID
+- `description` (string, optional) - Row description
+- `columns` (ColumnValue[], required) - Array of column values
+
+**Returns:** `Promise<Row>`
+
+### Channel Methods
+
+#### `sendMessage(params)`
+
+Send a message to a channel.
+
+```typescript
+await copera.channel.sendMessage({
+  channelId: 'channel-id',
+  message: 'Your message here',
+  name: 'Optional sender name'  // optional
+});
+```
+
+**Parameters:**
+- `channelId` (string, required) - The channel ID
+- `message` (string, required) - Message content (1-10000 characters)
+- `name` (string, optional) - Name of the sender
+
+**Returns:** `Promise<void>`
+
+## TypeScript Types
+
+The SDK exports all TypeScript types for your convenience:
+
+```typescript
+import {
+  Board,
+  Table,
+  Row,
+  Column,
+  ColumnValue,
+  SendMessageParams,
+  CoperaAIError
+} from '@copera.ai/sdk';
+```
+
+### Type Definitions
+
+```typescript
+interface Board {
+  _id: string;
+  name: string;
+  description?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface Table {
+  _id: string;
+  name: string;
+  board: string;
+  columns: Column[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface Row {
+  _id: string;
+  rowId: string;
+  owner: string;
+  table: string;
+  board: string;
+  columns: ColumnValue[];
+  createdAt: string;
+  updatedAt: string;
+}
+
+interface Column {
+  columnId: string;
+  label: string;
+  type: string;
+  order?: number;
+}
+
+interface ColumnValue {
+  columnId: string;
+  value: unknown;
+}
+```
+
+## Error Handling
+
+The SDK returns errors in a consistent format:
+
+```typescript
+try {
+  const boards = await copera.board.listBoards();
+
+  if ('error' in boards) {
+    console.error('API Error:', boards.error);
+    return;
+  }
+
+  // Success - process boards
+  console.log(boards);
+} catch (error) {
+  console.error('Network Error:', error);
+}
+```
+
+## Usage with Different Module Systems
+
+### ESM (ES Modules)
+
+```typescript
+import { CoperaAI } from '@copera.ai/sdk';
+
+const copera = CoperaAI({ apiKey: 'your-api-key' });
+```
+
+### CommonJS
+
+```javascript
+const { CoperaAI } = require('@copera.ai/sdk');
+
+const copera = CoperaAI({ apiKey: 'your-api-key' });
+```
+
+### TypeScript with ESM
+
+```typescript
+// tsconfig.json
+{
+  "compilerOptions": {
+    "module": "ESNext",
+    "moduleResolution": "bundler"
+  }
+}
+```
+
+## Examples
+
+### Complete Board Workflow
+
+```typescript
+import { CoperaAI } from '@copera.ai/sdk';
+
+const copera = CoperaAI({ apiKey: process.env.COPERA_API_KEY });
+
+async function manageBoardData() {
+  // 1. Get all boards
+  const boards = await copera.board.listBoards();
+  const firstBoard = boards[0];
+
+  // 2. Get board details
+  const board = await copera.board.getBoardDetails({
+    boardId: firstBoard._id
+  });
+
+  // 3. Get all tables in the board
+  const tables = await copera.board.listBoardTables({
+    boardId: board._id
+  });
+
+  // 4. Get rows from first table
+  const rows = await copera.board.listTableRows({
+    boardId: board._id,
+    tableId: tables[0]._id
+  });
+
+  // 5. Create a new row
+  const newRow = await copera.board.createTableRow({
+    boardId: board._id,
+    tableId: tables[0]._id,
+    columns: [
+      { columnId: 'col-1', value: 'New Value' }
+    ]
+  });
+
+  console.log('Created row:', newRow);
+}
+
+manageBoardData().catch(console.error);
+```
+
+### Send Notifications
+
+```typescript
+import { CoperaAI } from '@copera.ai/sdk';
+
+const copera = CoperaAI({ apiKey: process.env.COPERA_API_KEY });
+
+async function sendNotification() {
+  await copera.channel.sendMessage({
+    channelId: 'your-channel-id',
+    message: 'Task completed successfully!',
+    name: 'Automation Bot'
+  });
+}
+
+sendNotification().catch(console.error);
+```
+
+### Using with Environment Variables
+
+```typescript
+// .env
+COPERA_API_KEY=your-api-key-here
+COPERA_CHANNEL_ID=your-channel-id
+
+// app.ts
+import { CoperaAI } from '@copera.ai/sdk';
+import 'dotenv/config';
+
+const copera = CoperaAI({
+  apiKey: process.env.COPERA_API_KEY!
+});
+
+await copera.channel.sendMessage({
+  channelId: process.env.COPERA_CHANNEL_ID!,
+  message: 'Hello from automation!'
+});
+```
+
+## Best Practices
+
+### 1. Use Environment Variables
+
+Never hardcode API keys in your source code:
+
+```typescript
+// ❌ Bad
+const copera = CoperaAI({ apiKey: 'sk_live_abc123...' });
+
+// ✅ Good
+const copera = CoperaAI({ apiKey: process.env.COPERA_API_KEY });
+```
+
+### 2. Error Handling
+
+Always handle errors appropriately:
+
+```typescript
+try {
+  const boards = await copera.board.listBoards();
+  if ('error' in boards) {
+    // Handle API error
+    logger.error('API Error:', boards.error);
+    return;
+  }
+  // Process successful response
+} catch (error) {
+  // Handle network/unexpected errors
+  logger.error('Unexpected error:', error);
+}
+```
+
+### 3. Use TypeScript
+
+Take advantage of full type safety:
+
+```typescript
+import { CoperaAI, type Board, type Row } from '@copera.ai/sdk';
+
+const copera = CoperaAI({ apiKey: process.env.COPERA_API_KEY });
+
+// TypeScript will provide full autocomplete and type checking
+const boards: Board[] = await copera.board.listBoards();
+```
+
+### 4. Separate Development and Production Keys
+
+Use different API keys for different environments:
+
+```typescript
+const copera = CoperaAI({
+  apiKey: process.env.COPERA_API_KEY,
+  sandbox: process.env.NODE_ENV === 'development'
+});
+```
+
+## Contributing
+
+We welcome contributions! Please see our [Contributing Guide](./CONTRIBUTING.md) for details.
+
+## Security
+
+If you discover a security vulnerability, please email security@copera.ai. Do not create public issues for security vulnerabilities.
+
+See our [Security Policy](./SECURITY.md) for more details.
+
+## License
+
+This project is licensed under the MIT License - see the [LICENSE](./LICENSE) file for details.
+
+## Support
+
+- 📧 Email: support@copera.ai
+- 🐛 Issues: [GitHub Issues](https://github.com/Copera-ai/copera-nodejs-sdk/issues)
+- 📖 Documentation: [developers.copera.ai](https://developers.copera.ai)
+
+## Links
+
+- [Copera.ai Website](https://copera.ai)
+- [API Documentation](https://developers.copera.ai)
+- [GitHub Repository](https://github.com/Copera-ai/copera-nodejs-sdk)
+- [npm Package](https://www.npmjs.com/package/@copera.ai/sdk)
+
+---
+
+Made with ❤️ by the Copera.ai team

package/dist/index.cjs

@@ -0,0 +1,178 @@
+Object.defineProperty(exports, '__esModule', { value: true });
+
+//#region src/version.ts
+const COPERA_SDK_VERSION = "1.1.0";
+
+//#endregion
+//#region src/constants.ts
+const BASE_URL = "https://api.copera.ai/public/v1";
+const BASE_URL_DEV = "https://api-dev.copera.ai/public/v1";
+const COPERA_DOCS = "https://developers.copera.ai";
+function getHeaders(apiKey) {
+	return {
+		Authorization: `Bearer ${apiKey}`,
+		"Content-Type": "application/json",
+		"User-Agent": `NodeJS SDK ${COPERA_SDK_VERSION}`
+	};
+}
+
+//#endregion
+//#region src/exceptions.ts
+/**
+* Default class for CoperaAI exceptions and errors.
+*
+* It can be serialized to JSON through the `toJSON` method.
+*/
+var CoperaAIError = class extends Error {
+	constructor(message) {
+		super(`CoperaAI SDK Error: ${message}\n\nPlease, refer to the documentation at: ${COPERA_DOCS}`);
+		this.name = "CoperaAIError";
+	}
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message
+		};
+	}
+};
+
+//#endregion
+//#region src/requests.ts
+function createRequest(apiKey, sandbox = false) {
+	const defaultHeaders = getHeaders(apiKey);
+	const baseUrl = sandbox ? BASE_URL_DEV : BASE_URL;
+	return async (path, options) => {
+		try {
+			const response = await fetch(`${baseUrl}${path}`, {
+				...options,
+				headers: {
+					...defaultHeaders,
+					...options?.headers
+				}
+			});
+			const data = await response.json();
+			if (!response.ok) return { error: data.message };
+			return data;
+		} catch (error) {
+			return { error: error.message };
+		}
+	};
+}
+
+//#endregion
+//#region src/services/board/create-table-row.ts
+function createCreateTableRow(request) {
+	return async function createTableRow({ boardId, tableId, description, columns }) {
+		return request(`/board/${boardId}/table/${tableId}/row`, {
+			method: "POST",
+			body: JSON.stringify({
+				description,
+				columns
+			})
+		});
+	};
+}
+
+//#endregion
+//#region src/services/board/get-board-details.ts
+function createGetBoardDetails(request) {
+	return async function getBoardDetails({ boardId }) {
+		return request(`/board/${boardId}`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/get-board-table.ts
+function createGetBoardTable(request) {
+	return async function getBoardTable({ boardId, tableId }) {
+		return request(`/board/${boardId}/table/${tableId}`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/get-table-row.ts
+function createGetTableRow(request) {
+	return async function getTableRow({ boardId, tableId, rowId }) {
+		return request(`/board/${boardId}/table/${tableId}/row/${rowId}`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/list-board-tables.ts
+function createListBoardTables(request) {
+	return async function listBoardTables({ boardId }) {
+		return request(`/board/${boardId}/tables`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/list-boards.ts
+function createListBoards(request) {
+	return async function listBoards() {
+		return request("/board/list-boards", { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/list-table-rows.ts
+function createListTableRows(request) {
+	return async function listTableRows({ boardId, tableId }) {
+		return request(`/board/${boardId}/table/${tableId}/rows`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/index.ts
+function createBoardHandlers(request) {
+	return {
+		listBoards: createListBoards(request),
+		getBoardDetails: createGetBoardDetails(request),
+		listBoardTables: createListBoardTables(request),
+		getBoardTable: createGetBoardTable(request),
+		listTableRows: createListTableRows(request),
+		getTableRow: createGetTableRow(request),
+		createTableRow: createCreateTableRow(request)
+	};
+}
+
+//#endregion
+//#region src/services/channel/send-message.ts
+function createSendMessage(request) {
+	return async function sendMessage({ channelId, message, name }) {
+		return request(`/chat/channel/${channelId}/send-message`, {
+			method: "POST",
+			body: JSON.stringify({
+				message,
+				name
+			})
+		});
+	};
+}
+
+//#endregion
+//#region src/services/channel/index.ts
+function createChannelHandlers(request) {
+	return { sendMessage: createSendMessage(request) };
+}
+
+//#endregion
+//#region src/services/index.ts
+function getHandlers(request) {
+	return {
+		board: createBoardHandlers(request),
+		channel: createChannelHandlers(request)
+	};
+}
+
+//#endregion
+//#region src/index.ts
+function CoperaAI({ apiKey, sandbox = false }) {
+	if (!apiKey) throw new CoperaAIError("API key is required!");
+	return getHandlers(createRequest(apiKey, sandbox));
+}
+var src_default = CoperaAI;
+
+//#endregion
+exports.CoperaAI = CoperaAI;
+exports.CoperaAIError = CoperaAIError;
+exports.default = src_default;

package/dist/index.d.cts

@@ -0,0 +1,122 @@
+//#region src/types.d.ts
+interface Board {
+  _id: string;
+  name: string;
+  description?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+interface Column {
+  columnId: string;
+  label: string;
+  type: string;
+  order?: number;
+}
+interface Table {
+  _id: string;
+  name: string;
+  board: string;
+  columns: Column[];
+  createdAt: string;
+  updatedAt: string;
+}
+interface ColumnValue {
+  columnId: string;
+  value: unknown;
+}
+interface Row {
+  _id: string;
+  rowId: string;
+  owner: string;
+  table: string;
+  board: string;
+  columns: ColumnValue[];
+  createdAt: string;
+  updatedAt: string;
+}
+interface SendMessageParams {
+  channelId: string;
+  message: string;
+  name?: string;
+}
+//#endregion
+//#region src/exceptions.d.ts
+/**
+ * Default class for CoperaAI exceptions and errors.
+ *
+ * It can be serialized to JSON through the `toJSON` method.
+ */
+declare class CoperaAIError extends Error {
+  constructor(message: string);
+  toJSON(): {
+    name: string;
+    message: string;
+  };
+}
+//#endregion
+//#region src/index.d.ts
+interface CoperaAIOptions {
+  apiKey: string;
+  sandbox?: boolean;
+}
+declare function CoperaAI({
+  apiKey,
+  sandbox
+}: CoperaAIOptions): {
+  board: {
+    listBoards: () => Promise<Board[]>;
+    getBoardDetails: ({
+      boardId
+    }: {
+      boardId: string;
+    }) => Promise<Board>;
+    listBoardTables: ({
+      boardId
+    }: {
+      boardId: string;
+    }) => Promise<Table[]>;
+    getBoardTable: ({
+      boardId,
+      tableId
+    }: {
+      boardId: string;
+      tableId: string;
+    }) => Promise<Table>;
+    listTableRows: ({
+      boardId,
+      tableId
+    }: {
+      boardId: string;
+      tableId: string;
+    }) => Promise<Row[]>;
+    getTableRow: ({
+      boardId,
+      tableId,
+      rowId
+    }: {
+      boardId: string;
+      tableId: string;
+      rowId: string;
+    }) => Promise<Row>;
+    createTableRow: ({
+      boardId,
+      tableId,
+      description,
+      columns
+    }: {
+      boardId: string;
+      tableId: string;
+      description?: string;
+      columns: ColumnValue[];
+    }) => Promise<Row>;
+  };
+  channel: {
+    sendMessage: ({
+      channelId,
+      message,
+      name
+    }: SendMessageParams) => Promise<void>;
+  };
+};
+//#endregion
+export { CoperaAI, CoperaAI as default, CoperaAIError };

package/dist/index.d.mts

@@ -0,0 +1,122 @@
+//#region src/types.d.ts
+interface Board {
+  _id: string;
+  name: string;
+  description?: string;
+  createdAt: string;
+  updatedAt: string;
+}
+interface Column {
+  columnId: string;
+  label: string;
+  type: string;
+  order?: number;
+}
+interface Table {
+  _id: string;
+  name: string;
+  board: string;
+  columns: Column[];
+  createdAt: string;
+  updatedAt: string;
+}
+interface ColumnValue {
+  columnId: string;
+  value: unknown;
+}
+interface Row {
+  _id: string;
+  rowId: string;
+  owner: string;
+  table: string;
+  board: string;
+  columns: ColumnValue[];
+  createdAt: string;
+  updatedAt: string;
+}
+interface SendMessageParams {
+  channelId: string;
+  message: string;
+  name?: string;
+}
+//#endregion
+//#region src/exceptions.d.ts
+/**
+ * Default class for CoperaAI exceptions and errors.
+ *
+ * It can be serialized to JSON through the `toJSON` method.
+ */
+declare class CoperaAIError extends Error {
+  constructor(message: string);
+  toJSON(): {
+    name: string;
+    message: string;
+  };
+}
+//#endregion
+//#region src/index.d.ts
+interface CoperaAIOptions {
+  apiKey: string;
+  sandbox?: boolean;
+}
+declare function CoperaAI({
+  apiKey,
+  sandbox
+}: CoperaAIOptions): {
+  board: {
+    listBoards: () => Promise<Board[]>;
+    getBoardDetails: ({
+      boardId
+    }: {
+      boardId: string;
+    }) => Promise<Board>;
+    listBoardTables: ({
+      boardId
+    }: {
+      boardId: string;
+    }) => Promise<Table[]>;
+    getBoardTable: ({
+      boardId,
+      tableId
+    }: {
+      boardId: string;
+      tableId: string;
+    }) => Promise<Table>;
+    listTableRows: ({
+      boardId,
+      tableId
+    }: {
+      boardId: string;
+      tableId: string;
+    }) => Promise<Row[]>;
+    getTableRow: ({
+      boardId,
+      tableId,
+      rowId
+    }: {
+      boardId: string;
+      tableId: string;
+      rowId: string;
+    }) => Promise<Row>;
+    createTableRow: ({
+      boardId,
+      tableId,
+      description,
+      columns
+    }: {
+      boardId: string;
+      tableId: string;
+      description?: string;
+      columns: ColumnValue[];
+    }) => Promise<Row>;
+  };
+  channel: {
+    sendMessage: ({
+      channelId,
+      message,
+      name
+    }: SendMessageParams) => Promise<void>;
+  };
+};
+//#endregion
+export { CoperaAI, CoperaAI as default, CoperaAIError };

package/dist/index.mjs

@@ -0,0 +1,174 @@
+//#region src/version.ts
+const COPERA_SDK_VERSION = "1.1.0";
+
+//#endregion
+//#region src/constants.ts
+const BASE_URL = "https://api.copera.ai/public/v1";
+const BASE_URL_DEV = "https://api-dev.copera.ai/public/v1";
+const COPERA_DOCS = "https://developers.copera.ai";
+function getHeaders(apiKey) {
+	return {
+		Authorization: `Bearer ${apiKey}`,
+		"Content-Type": "application/json",
+		"User-Agent": `NodeJS SDK ${COPERA_SDK_VERSION}`
+	};
+}
+
+//#endregion
+//#region src/exceptions.ts
+/**
+* Default class for CoperaAI exceptions and errors.
+*
+* It can be serialized to JSON through the `toJSON` method.
+*/
+var CoperaAIError = class extends Error {
+	constructor(message) {
+		super(`CoperaAI SDK Error: ${message}\n\nPlease, refer to the documentation at: ${COPERA_DOCS}`);
+		this.name = "CoperaAIError";
+	}
+	toJSON() {
+		return {
+			name: this.name,
+			message: this.message
+		};
+	}
+};
+
+//#endregion
+//#region src/requests.ts
+function createRequest(apiKey, sandbox = false) {
+	const defaultHeaders = getHeaders(apiKey);
+	const baseUrl = sandbox ? BASE_URL_DEV : BASE_URL;
+	return async (path, options) => {
+		try {
+			const response = await fetch(`${baseUrl}${path}`, {
+				...options,
+				headers: {
+					...defaultHeaders,
+					...options?.headers
+				}
+			});
+			const data = await response.json();
+			if (!response.ok) return { error: data.message };
+			return data;
+		} catch (error) {
+			return { error: error.message };
+		}
+	};
+}
+
+//#endregion
+//#region src/services/board/create-table-row.ts
+function createCreateTableRow(request) {
+	return async function createTableRow({ boardId, tableId, description, columns }) {
+		return request(`/board/${boardId}/table/${tableId}/row`, {
+			method: "POST",
+			body: JSON.stringify({
+				description,
+				columns
+			})
+		});
+	};
+}
+
+//#endregion
+//#region src/services/board/get-board-details.ts
+function createGetBoardDetails(request) {
+	return async function getBoardDetails({ boardId }) {
+		return request(`/board/${boardId}`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/get-board-table.ts
+function createGetBoardTable(request) {
+	return async function getBoardTable({ boardId, tableId }) {
+		return request(`/board/${boardId}/table/${tableId}`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/get-table-row.ts
+function createGetTableRow(request) {
+	return async function getTableRow({ boardId, tableId, rowId }) {
+		return request(`/board/${boardId}/table/${tableId}/row/${rowId}`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/list-board-tables.ts
+function createListBoardTables(request) {
+	return async function listBoardTables({ boardId }) {
+		return request(`/board/${boardId}/tables`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/list-boards.ts
+function createListBoards(request) {
+	return async function listBoards() {
+		return request("/board/list-boards", { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/list-table-rows.ts
+function createListTableRows(request) {
+	return async function listTableRows({ boardId, tableId }) {
+		return request(`/board/${boardId}/table/${tableId}/rows`, { method: "GET" });
+	};
+}
+
+//#endregion
+//#region src/services/board/index.ts
+function createBoardHandlers(request) {
+	return {
+		listBoards: createListBoards(request),
+		getBoardDetails: createGetBoardDetails(request),
+		listBoardTables: createListBoardTables(request),
+		getBoardTable: createGetBoardTable(request),
+		listTableRows: createListTableRows(request),
+		getTableRow: createGetTableRow(request),
+		createTableRow: createCreateTableRow(request)
+	};
+}
+
+//#endregion
+//#region src/services/channel/send-message.ts
+function createSendMessage(request) {
+	return async function sendMessage({ channelId, message, name }) {
+		return request(`/chat/channel/${channelId}/send-message`, {
+			method: "POST",
+			body: JSON.stringify({
+				message,
+				name
+			})
+		});
+	};
+}
+
+//#endregion
+//#region src/services/channel/index.ts
+function createChannelHandlers(request) {
+	return { sendMessage: createSendMessage(request) };
+}
+
+//#endregion
+//#region src/services/index.ts
+function getHandlers(request) {
+	return {
+		board: createBoardHandlers(request),
+		channel: createChannelHandlers(request)
+	};
+}
+
+//#endregion
+//#region src/index.ts
+function CoperaAI({ apiKey, sandbox = false }) {
+	if (!apiKey) throw new CoperaAIError("API key is required!");
+	return getHandlers(createRequest(apiKey, sandbox));
+}
+var src_default = CoperaAI;
+
+//#endregion
+export { CoperaAI, CoperaAIError, src_default as default };

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "@copera.ai/sdk",
+  "version": "1.1.0",
+  "description": "Copera.ai NodeJS SDK",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git@github.com:Copera-ai/copera-nodejs-sdk.git"
+  },
+  "keywords": [
+    "sdk",
+    "typescript",
+    "copera",
+    "nodejs",
+    "api-client"
+  ],
+  "author": "Christian Curi <c.christiancuri@gmail.com>",
+  "license": "MIT",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.7",
+    "@changesets/cli": "^2.29.7",
+    "@commitlint/cli": "^17.4.4",
+    "@commitlint/config-conventional": "^17.4.4",
+    "husky": "^9.1.7",
+    "lint-staged": "^13.3.0",
+    "tsdown": "^0.16.7",
+    "typescript": "^5.8.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^v3.2.4"
+  },
+  "lint-staged": {
+    "*": [
+      "biome check --no-errors-on-unmatched --files-ignore-unknown=true"
+    ]
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "prebuild": "node -p \"'/*This file is auto generated during build, DO NOT CHANGE OR MODIFY */\\n\\nexport const COPERA_SDK_VERSION = ' + JSON.stringify(require('./package.json').version) + ';'\" > src/version.ts",
+    "build": "tsdown",
+    "test": "vitest --watch false",
+    "test:watch": "vitest --watch",
+    "lint": "biome check .",
+    "typecheck": "tsc --noEmit",
+    "changeset": "changeset",
+    "version": "changeset version",
+    "release": "pnpm build && changeset publish"
+  }
+}