@channlize/core 0.1.0-alpha.1

package/README.md

@@ -0,0 +1,147 @@
+# @channlize/core
+
+Core TypeScript SDK for the Channlize platform. Provides API client functionality for submitting contact forms and managing chat sessions.
+
+## Installation
+
+```bash
+npm install @channlize/core
+```
+
+## Usage
+
+### Basic Setup
+
+```typescript
+import { ChannlizeClient } from '@channlize/core';
+
+const client = new ChannlizeClient({
+  apiKey: 'your-api-key',
+  projectId: 'your-project-id',
+  baseUrl: 'https://api.channlize.com', // optional
+  timeout: 10000, // optional, default 10s
+});
+```
+
+### Contact Forms
+
+```typescript
+// Submit a contact form
+const response = await client.submitContactForm({
+  name: 'John Doe',
+  email: 'john@example.com',
+  subject: 'Support Request',
+  message: 'I need help with my account',
+  customFields: {
+    department: 'support',
+    priority: 'high',
+  },
+});
+
+console.log('Submission ID:', response.id);
+console.log('Slack thread:', response.slackThreadUrl);
+```
+
+### Chat Sessions
+
+```typescript
+// Create a new chat session
+const sessionResponse = await client.createChatSession({
+  userAgent: navigator.userAgent,
+  pageUrl: window.location.href,
+});
+
+const session = sessionResponse.session;
+
+// Send a message
+await client.sendMessage(session.id, 'Hello, I need help!');
+
+// Send message with file attachments
+const files = [document.querySelector('input[type="file"]').files[0]];
+await client.sendMessage(session.id, 'Please see attached file', files);
+
+// Get session details
+const updatedSession = await client.getChatSession(session.id);
+
+// Get messages
+const messages = await client.getChatMessages(session.id, 50, 0);
+
+// Close session
+await client.closeChatSession(session.id);
+```
+
+### Error Handling
+
+```typescript
+import {
+  ChannlizeError,
+  ValidationError,
+  AuthenticationError,
+  RateLimitError,
+} from '@channlize/core';
+
+try {
+  await client.submitContactForm(formData);
+} catch (error) {
+  if (error instanceof ValidationError) {
+    console.error('Validation failed:', error.message, error.field);
+  } else if (error instanceof AuthenticationError) {
+    console.error('Authentication failed:', error.message);
+  } else if (error instanceof RateLimitError) {
+    console.error('Rate limit exceeded:', error.message);
+  } else if (error instanceof ChannlizeError) {
+    console.error('API error:', error.message, error.statusCode);
+  } else {
+    console.error('Unknown error:', error);
+  }
+}
+```
+
+## API Reference
+
+### ChannlizeClient
+
+#### Constructor Options
+
+```typescript
+interface ChannlizeConfig {
+  apiKey: string;           // Required: Your API key
+  projectId: string;        // Required: Your project ID
+  baseUrl?: string;         // Optional: API base URL
+  timeout?: number;         // Optional: Request timeout in ms
+}
+```
+
+#### Methods
+
+- `submitContactForm(data: ContactFormData): Promise<CreateContactResponse>`
+- `createChatSession(metadata?: Record<string, unknown>): Promise<CreateChatSessionResponse>`
+- `sendMessage(sessionId: string, content: string, attachments?: File[]): Promise<SendMessageResponse>`
+- `getChatSession(sessionId: string): Promise<ChatSession>`
+- `getChatMessages(sessionId: string, limit?: number, offset?: number): Promise<ChatMessage[]>`
+- `closeChatSession(sessionId: string): Promise<ChatSession>`
+
+### Types
+
+All TypeScript types are exported from the package:
+
+```typescript
+import type {
+  ChannlizeConfig,
+  ContactFormData,
+  ChatMessage,
+  ChatSession,
+  FileAttachment,
+  CreateContactResponse,
+  CreateChatSessionResponse,
+  SendMessageResponse,
+  ChannlizeError,
+  ValidationError,
+  AuthenticationError,
+  RateLimitError,
+} from '@channlize/core';
+```
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,159 @@
+/**
+ * Core types for Channlize SDK
+ */
+interface ChannlizeConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the Channlize API */
+    baseUrl?: string;
+    /** Project ID */
+    projectId: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+interface ContactFormData {
+    /** Contact's name */
+    name: string;
+    /** Contact's email address */
+    email: string;
+    /** Subject of the inquiry */
+    subject?: string;
+    /** Message content */
+    message: string;
+    /** Custom fields */
+    customFields?: Record<string, unknown>;
+    /** Page URL where the form was submitted */
+    pageUrl?: string;
+    /** User agent string */
+    userAgent?: string;
+}
+interface ChatMessage {
+    /** Unique message ID */
+    id: string;
+    /** Message content */
+    content: string;
+    /** Message timestamp */
+    timestamp: Date;
+    /** Message author (user or agent) */
+    author: 'user' | 'agent';
+    /** Author metadata */
+    authorData?: {
+        name?: string;
+        email?: string;
+        avatarUrl?: string;
+    };
+    /** Attached files */
+    attachments?: FileAttachment[];
+}
+interface FileAttachment {
+    /** File ID */
+    id: string;
+    /** Original filename */
+    name: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** Download URL */
+    url: string;
+}
+interface ChatSession {
+    /** Session ID */
+    id: string;
+    /** Session status */
+    status: 'active' | 'closed' | 'waiting';
+    /** Messages in the session */
+    messages: ChatMessage[];
+    /** Session metadata */
+    metadata?: Record<string, unknown>;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+}
+interface ApiResponse<T = unknown> {
+    /** Response data */
+    data: T;
+    /** Success status */
+    success: boolean;
+    /** Error message if any */
+    error?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+}
+interface CreateContactResponse {
+    /** Contact form submission ID */
+    id: string;
+    /** Status of the submission */
+    status: 'received' | 'processing' | 'delivered';
+    /** Slack thread URL if available */
+    slackThreadUrl?: string;
+}
+interface CreateChatSessionResponse {
+    /** Chat session data */
+    session: ChatSession;
+    /** SSE endpoint for real-time updates */
+    sseEndpoint?: string;
+}
+interface SendMessageResponse {
+    /** The sent message */
+    message: ChatMessage;
+    /** Updated session */
+    session: ChatSession;
+}
+/**
+ * Error types
+ */
+declare class ChannlizeError extends Error {
+    statusCode?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, code?: string | undefined);
+}
+declare class ValidationError extends ChannlizeError {
+    field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+declare class AuthenticationError extends ChannlizeError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends ChannlizeError {
+    constructor(message?: string);
+}
+
+/**
+ * Channlize API Client
+ * Provides methods to interact with the Channlize platform
+ */
+declare class ChannlizeClient {
+    private readonly config;
+    constructor(config: ChannlizeConfig);
+    private validateConfig;
+    private makeRequest;
+    private handleErrorResponse;
+    /**
+     * Submit a contact form
+     */
+    submitContactForm(data: ContactFormData): Promise<CreateContactResponse>;
+    /**
+     * Create a new chat session
+     */
+    createChatSession(metadata?: Record<string, unknown>): Promise<CreateChatSessionResponse>;
+    /**
+     * Send a message in a chat session
+     */
+    sendMessage(sessionId: string, content: string, attachments?: File[]): Promise<SendMessageResponse>;
+    /**
+     * Get chat session details
+     */
+    getChatSession(sessionId: string): Promise<ChatSession>;
+    /**
+     * Get messages for a chat session
+     */
+    getChatMessages(sessionId: string, limit?: number, offset?: number): Promise<ChatMessage[]>;
+    /**
+     * Close a chat session
+     */
+    closeChatSession(sessionId: string): Promise<ChatSession>;
+}
+
+export { type ApiResponse, AuthenticationError, ChannlizeClient, type ChannlizeConfig, ChannlizeError, type ChatMessage, type ChatSession, type ContactFormData, type CreateChatSessionResponse, type CreateContactResponse, type FileAttachment, RateLimitError, type SendMessageResponse, ValidationError, ChannlizeClient as default };

package/dist/index.d.ts

@@ -0,0 +1,159 @@
+/**
+ * Core types for Channlize SDK
+ */
+interface ChannlizeConfig {
+    /** API key for authentication */
+    apiKey: string;
+    /** Base URL for the Channlize API */
+    baseUrl?: string;
+    /** Project ID */
+    projectId: string;
+    /** Request timeout in milliseconds */
+    timeout?: number;
+}
+interface ContactFormData {
+    /** Contact's name */
+    name: string;
+    /** Contact's email address */
+    email: string;
+    /** Subject of the inquiry */
+    subject?: string;
+    /** Message content */
+    message: string;
+    /** Custom fields */
+    customFields?: Record<string, unknown>;
+    /** Page URL where the form was submitted */
+    pageUrl?: string;
+    /** User agent string */
+    userAgent?: string;
+}
+interface ChatMessage {
+    /** Unique message ID */
+    id: string;
+    /** Message content */
+    content: string;
+    /** Message timestamp */
+    timestamp: Date;
+    /** Message author (user or agent) */
+    author: 'user' | 'agent';
+    /** Author metadata */
+    authorData?: {
+        name?: string;
+        email?: string;
+        avatarUrl?: string;
+    };
+    /** Attached files */
+    attachments?: FileAttachment[];
+}
+interface FileAttachment {
+    /** File ID */
+    id: string;
+    /** Original filename */
+    name: string;
+    /** File size in bytes */
+    size: number;
+    /** MIME type */
+    type: string;
+    /** Download URL */
+    url: string;
+}
+interface ChatSession {
+    /** Session ID */
+    id: string;
+    /** Session status */
+    status: 'active' | 'closed' | 'waiting';
+    /** Messages in the session */
+    messages: ChatMessage[];
+    /** Session metadata */
+    metadata?: Record<string, unknown>;
+    /** Created timestamp */
+    createdAt: Date;
+    /** Updated timestamp */
+    updatedAt: Date;
+}
+interface ApiResponse<T = unknown> {
+    /** Response data */
+    data: T;
+    /** Success status */
+    success: boolean;
+    /** Error message if any */
+    error?: string;
+    /** Additional metadata */
+    meta?: Record<string, unknown>;
+}
+interface CreateContactResponse {
+    /** Contact form submission ID */
+    id: string;
+    /** Status of the submission */
+    status: 'received' | 'processing' | 'delivered';
+    /** Slack thread URL if available */
+    slackThreadUrl?: string;
+}
+interface CreateChatSessionResponse {
+    /** Chat session data */
+    session: ChatSession;
+    /** SSE endpoint for real-time updates */
+    sseEndpoint?: string;
+}
+interface SendMessageResponse {
+    /** The sent message */
+    message: ChatMessage;
+    /** Updated session */
+    session: ChatSession;
+}
+/**
+ * Error types
+ */
+declare class ChannlizeError extends Error {
+    statusCode?: number | undefined;
+    code?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, code?: string | undefined);
+}
+declare class ValidationError extends ChannlizeError {
+    field?: string | undefined;
+    constructor(message: string, field?: string | undefined);
+}
+declare class AuthenticationError extends ChannlizeError {
+    constructor(message?: string);
+}
+declare class RateLimitError extends ChannlizeError {
+    constructor(message?: string);
+}
+
+/**
+ * Channlize API Client
+ * Provides methods to interact with the Channlize platform
+ */
+declare class ChannlizeClient {
+    private readonly config;
+    constructor(config: ChannlizeConfig);
+    private validateConfig;
+    private makeRequest;
+    private handleErrorResponse;
+    /**
+     * Submit a contact form
+     */
+    submitContactForm(data: ContactFormData): Promise<CreateContactResponse>;
+    /**
+     * Create a new chat session
+     */
+    createChatSession(metadata?: Record<string, unknown>): Promise<CreateChatSessionResponse>;
+    /**
+     * Send a message in a chat session
+     */
+    sendMessage(sessionId: string, content: string, attachments?: File[]): Promise<SendMessageResponse>;
+    /**
+     * Get chat session details
+     */
+    getChatSession(sessionId: string): Promise<ChatSession>;
+    /**
+     * Get messages for a chat session
+     */
+    getChatMessages(sessionId: string, limit?: number, offset?: number): Promise<ChatMessage[]>;
+    /**
+     * Close a chat session
+     */
+    closeChatSession(sessionId: string): Promise<ChatSession>;
+}
+
+export { type ApiResponse, AuthenticationError, ChannlizeClient, type ChannlizeConfig, ChannlizeError, type ChatMessage, type ChatSession, type ContactFormData, type CreateChatSessionResponse, type CreateContactResponse, type FileAttachment, RateLimitError, type SendMessageResponse, ValidationError, ChannlizeClient as default };

package/dist/index.js

@@ -0,0 +1,232 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  AuthenticationError: () => AuthenticationError,
+  ChannlizeClient: () => ChannlizeClient,
+  ChannlizeError: () => ChannlizeError,
+  RateLimitError: () => RateLimitError,
+  ValidationError: () => ValidationError,
+  default: () => ChannlizeClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_cross_fetch = __toESM(require("cross-fetch"));
+
+// src/types.ts
+var ChannlizeError = class extends Error {
+  constructor(message, statusCode, code) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "ChannlizeError";
+  }
+};
+var ValidationError = class extends ChannlizeError {
+  constructor(message, field) {
+    super(message, 400, "VALIDATION_ERROR");
+    this.field = field;
+    this.name = "ValidationError";
+  }
+};
+var AuthenticationError = class extends ChannlizeError {
+  constructor(message = "Authentication failed") {
+    super(message, 401, "AUTHENTICATION_ERROR");
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends ChannlizeError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429, "RATE_LIMIT_ERROR");
+    this.name = "RateLimitError";
+  }
+};
+
+// src/client.ts
+var ChannlizeClient = class {
+  config;
+  constructor(config) {
+    this.config = {
+      baseUrl: config.baseUrl || "https://api.channlize.com",
+      timeout: 1e4,
+      ...config
+    };
+    this.validateConfig();
+  }
+  validateConfig() {
+    if (!this.config.apiKey) {
+      throw new ValidationError("Widget key is required");
+    }
+  }
+  async makeRequest(endpoint, options = {}) {
+    const url = `${this.config.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await (0, import_cross_fetch.default)(url, {
+        ...options,
+        signal: controller.signal,
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers
+        }
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof ChannlizeError) {
+        throw error;
+      }
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new ChannlizeError("Request timeout", 408, "TIMEOUT");
+      }
+      throw new ChannlizeError(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+  async handleErrorResponse(response) {
+    const contentType = response.headers.get("content-type");
+    let errorData = {};
+    if (contentType?.includes("application/json")) {
+      try {
+        errorData = await response.json();
+      } catch {
+      }
+    }
+    const message = errorData.error || `HTTP ${response.status}: ${response.statusText}`;
+    switch (response.status) {
+      case 401:
+        throw new AuthenticationError(message);
+      case 400:
+        throw new ValidationError(message, errorData.field);
+      case 429:
+        throw new RateLimitError(message);
+      default:
+        throw new ChannlizeError(message, response.status, errorData.code);
+    }
+  }
+  /**
+   * Submit a contact form
+   */
+  async submitContactForm(data) {
+    const response = await this.makeRequest("/public/contact", {
+      method: "POST",
+      body: JSON.stringify({
+        widgetKey: this.config.apiKey,
+        // apiKey is actually the widgetKey
+        subject: data.subject,
+        message: data.message,
+        email: data.email,
+        name: data.name,
+        pageUrl: data.pageUrl || (typeof window !== "undefined" ? window.location.href : void 0),
+        userAgent: data.userAgent || (typeof navigator !== "undefined" ? navigator.userAgent : void 0)
+      })
+    });
+    return response.data || response;
+  }
+  /**
+   * Create a new chat session
+   */
+  async createChatSession(metadata) {
+    const response = await this.makeRequest("/v1/chat/sessions", {
+      method: "POST",
+      body: JSON.stringify({
+        widgetKey: this.config.apiKey,
+        // apiKey is actually the widgetKey
+        metadata: {
+          ...metadata,
+          pageUrl: typeof window !== "undefined" ? window.location.href : void 0,
+          userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0
+        }
+      })
+    });
+    return response.data;
+  }
+  /**
+   * Send a message in a chat session
+   */
+  async sendMessage(sessionId, content, attachments) {
+    const idempotencyKey = `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    const response = await this.makeRequest(
+      `/v1/chat/sessions/${sessionId}/messages`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          content,
+          idempotencyKey
+        })
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get chat session details
+   */
+  async getChatSession(sessionId) {
+    const response = await this.makeRequest(`/v1/chat/sessions/${sessionId}`);
+    return response.data;
+  }
+  /**
+   * Get messages for a chat session
+   */
+  async getChatMessages(sessionId, limit = 50, offset = 0) {
+    const response = await this.makeRequest(
+      `/v1/chat/sessions/${sessionId}/messages?limit=${limit}&offset=${offset}`
+    );
+    return response.data;
+  }
+  /**
+   * Close a chat session
+   */
+  async closeChatSession(sessionId) {
+    const response = await this.makeRequest(
+      `/v1/chat/sessions/${sessionId}/close`,
+      { method: "POST" }
+    );
+    return response.data;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AuthenticationError,
+  ChannlizeClient,
+  ChannlizeError,
+  RateLimitError,
+  ValidationError
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/types.ts"],"sourcesContent":["/**\n * @channlize/core\n * Core TypeScript SDK for Channlize platform\n */\n\nexport { ChannlizeClient } from './client';\nexport * from './types';\n\n// Re-export for convenience\nexport { ChannlizeClient as default } from './client';\n","import fetch from 'cross-fetch';\nimport type {\n  ChannlizeConfig,\n  ContactFormData,\n  ChatMessage,\n  ApiResponse,\n  CreateContactResponse,\n  CreateChatSessionResponse,\n  SendMessageResponse,\n  ChatSession,\n} from './types';\nimport {\n  ChannlizeError,\n  AuthenticationError,\n  ValidationError,\n  RateLimitError,\n} from './types';\n\n/**\n * Channlize API Client\n * Provides methods to interact with the Channlize platform\n */\nexport class ChannlizeClient {\n  private readonly config: Required<ChannlizeConfig>;\n\n  constructor(config: ChannlizeConfig) {\n    this.config = {\n      baseUrl: config.baseUrl || 'https://api.channlize.com',\n      timeout: 10000,\n      ...config,\n    };\n\n    this.validateConfig();\n  }\n\n  private validateConfig(): void {\n    if (!this.config.apiKey) {\n      throw new ValidationError('Widget key is required');\n    }\n  }\n\n  private async makeRequest<T>(\n    endpoint: string,\n    options: RequestInit = {}\n  ): Promise<ApiResponse<T>> {\n    const url = `${this.config.baseUrl}${endpoint}`;\n    \n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...options,\n        signal: controller.signal,\n        headers: {\n          'Content-Type': 'application/json',\n          ...options.headers,\n        },\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      const data = await response.json();\n      return data as ApiResponse<T>;\n    } catch (error) {\n      clearTimeout(timeoutId);\n      \n      if (error instanceof ChannlizeError) {\n        throw error;\n      }\n      \n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new ChannlizeError('Request timeout', 408, 'TIMEOUT');\n      }\n      \n      throw new ChannlizeError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    const contentType = response.headers.get('content-type');\n    let errorData: any = {};\n\n    if (contentType?.includes('application/json')) {\n      try {\n        errorData = await response.json();\n      } catch {\n        // Ignore JSON parsing errors\n      }\n    }\n\n    const message = errorData.error || `HTTP ${response.status}: ${response.statusText}`;\n\n    switch (response.status) {\n      case 401:\n        throw new AuthenticationError(message);\n      case 400:\n        throw new ValidationError(message, errorData.field);\n      case 429:\n        throw new RateLimitError(message);\n      default:\n        throw new ChannlizeError(message, response.status, errorData.code);\n    }\n  }\n\n  /**\n   * Submit a contact form\n   */\n  async submitContactForm(data: ContactFormData): Promise<CreateContactResponse> {\n    const response = await this.makeRequest<CreateContactResponse>('/public/contact', {\n      method: 'POST',\n      body: JSON.stringify({\n        widgetKey: this.config.apiKey, // apiKey is actually the widgetKey\n        subject: data.subject,\n        message: data.message,\n        email: data.email,\n        name: data.name,\n        pageUrl: data.pageUrl || (typeof window !== 'undefined' ? window.location.href : undefined),\n        userAgent: data.userAgent || (typeof navigator !== 'undefined' ? navigator.userAgent : undefined),\n      }),\n    });\n\n    return response.data || response;\n  }\n\n  /**\n   * Create a new chat session\n   */\n  async createChatSession(metadata?: Record<string, unknown>): Promise<CreateChatSessionResponse> {\n    const response = await this.makeRequest<CreateChatSessionResponse>('/v1/chat/sessions', {\n      method: 'POST',\n      body: JSON.stringify({\n        widgetKey: this.config.apiKey, // apiKey is actually the widgetKey\n        metadata: {\n          ...metadata,\n          pageUrl: typeof window !== 'undefined' ? window.location.href : undefined,\n          userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n        },\n      }),\n    });\n\n    return response.data;\n  }\n\n  /**\n   * Send a message in a chat session\n   */\n  async sendMessage(\n    sessionId: string,\n    content: string,\n    attachments?: File[]\n  ): Promise<SendMessageResponse> {\n    // Generate idempotency key to prevent duplicate message creation\n    const idempotencyKey = `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    \n    // For now, we send as JSON. File attachments support can be added later.\n    // TODO: Implement file upload support\n    const response = await this.makeRequest<SendMessageResponse>(\n      `/v1/chat/sessions/${sessionId}/messages`,\n      {\n        method: 'POST',\n        body: JSON.stringify({\n          content,\n          idempotencyKey,\n        }),\n      }\n    );\n\n    return response.data;\n  }\n\n  /**\n   * Get chat session details\n   */\n  async getChatSession(sessionId: string): Promise<ChatSession> {\n    const response = await this.makeRequest<ChatSession>(`/v1/chat/sessions/${sessionId}`);\n    return response.data;\n  }\n\n  /**\n   * Get messages for a chat session\n   */\n  async getChatMessages(sessionId: string, limit = 50, offset = 0): Promise<ChatMessage[]> {\n    const response = await this.makeRequest<ChatMessage[]>(\n      `/v1/chat/sessions/${sessionId}/messages?limit=${limit}&offset=${offset}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Close a chat session\n   */\n  async closeChatSession(sessionId: string): Promise<ChatSession> {\n    const response = await this.makeRequest<ChatSession>(\n      `/v1/chat/sessions/${sessionId}/close`,\n      { method: 'POST' }\n    );\n    return response.data;\n  }\n}\n","/**\n * Core types for Channlize SDK\n */\n\nexport interface ChannlizeConfig {\n  /** API key for authentication */\n  apiKey: string;\n  /** Base URL for the Channlize API */\n  baseUrl?: string;\n  /** Project ID */\n  projectId: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\nexport interface ContactFormData {\n  /** Contact's name */\n  name: string;\n  /** Contact's email address */\n  email: string;\n  /** Subject of the inquiry */\n  subject?: string;\n  /** Message content */\n  message: string;\n  /** Custom fields */\n  customFields?: Record<string, unknown>;\n  /** Page URL where the form was submitted */\n  pageUrl?: string;\n  /** User agent string */\n  userAgent?: string;\n}\n\nexport interface ChatMessage {\n  /** Unique message ID */\n  id: string;\n  /** Message content */\n  content: string;\n  /** Message timestamp */\n  timestamp: Date;\n  /** Message author (user or agent) */\n  author: 'user' | 'agent';\n  /** Author metadata */\n  authorData?: {\n    name?: string;\n    email?: string;\n    avatarUrl?: string;\n  };\n  /** Attached files */\n  attachments?: FileAttachment[];\n}\n\nexport interface FileAttachment {\n  /** File ID */\n  id: string;\n  /** Original filename */\n  name: string;\n  /** File size in bytes */\n  size: number;\n  /** MIME type */\n  type: string;\n  /** Download URL */\n  url: string;\n}\n\nexport interface ChatSession {\n  /** Session ID */\n  id: string;\n  /** Session status */\n  status: 'active' | 'closed' | 'waiting';\n  /** Messages in the session */\n  messages: ChatMessage[];\n  /** Session metadata */\n  metadata?: Record<string, unknown>;\n  /** Created timestamp */\n  createdAt: Date;\n  /** Updated timestamp */\n  updatedAt: Date;\n}\n\nexport interface ApiResponse<T = unknown> {\n  /** Response data */\n  data: T;\n  /** Success status */\n  success: boolean;\n  /** Error message if any */\n  error?: string;\n  /** Additional metadata */\n  meta?: Record<string, unknown>;\n}\n\nexport interface CreateContactResponse {\n  /** Contact form submission ID */\n  id: string;\n  /** Status of the submission */\n  status: 'received' | 'processing' | 'delivered';\n  /** Slack thread URL if available */\n  slackThreadUrl?: string;\n}\n\nexport interface CreateChatSessionResponse {\n  /** Chat session data */\n  session: ChatSession;\n  /** SSE endpoint for real-time updates */\n  sseEndpoint?: string;\n}\n\nexport interface SendMessageResponse {\n  /** The sent message */\n  message: ChatMessage;\n  /** Updated session */\n  session: ChatSession;\n}\n\n/**\n * Error types\n */\nexport class ChannlizeError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public code?: string\n  ) {\n    super(message);\n    this.name = 'ChannlizeError';\n  }\n}\n\nexport class ValidationError extends ChannlizeError {\n  constructor(message: string, public field?: string) {\n    super(message, 400, 'VALIDATION_ERROR');\n    this.name = 'ValidationError';\n  }\n}\n\nexport class AuthenticationError extends ChannlizeError {\n  constructor(message: string = 'Authentication failed') {\n    super(message, 401, 'AUTHENTICATION_ERROR');\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class RateLimitError extends ChannlizeError {\n  constructor(message: string = 'Rate limit exceeded') {\n    super(message, 429, 'RATE_LIMIT_ERROR');\n    this.name = 'RateLimitError';\n  }\n}\n"],"mappings":"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","names":["fetch"]}

package/dist/index.mjs

@@ -0,0 +1,191 @@
+// src/client.ts
+import fetch from "cross-fetch";
+
+// src/types.ts
+var ChannlizeError = class extends Error {
+  constructor(message, statusCode, code) {
+    super(message);
+    this.statusCode = statusCode;
+    this.code = code;
+    this.name = "ChannlizeError";
+  }
+};
+var ValidationError = class extends ChannlizeError {
+  constructor(message, field) {
+    super(message, 400, "VALIDATION_ERROR");
+    this.field = field;
+    this.name = "ValidationError";
+  }
+};
+var AuthenticationError = class extends ChannlizeError {
+  constructor(message = "Authentication failed") {
+    super(message, 401, "AUTHENTICATION_ERROR");
+    this.name = "AuthenticationError";
+  }
+};
+var RateLimitError = class extends ChannlizeError {
+  constructor(message = "Rate limit exceeded") {
+    super(message, 429, "RATE_LIMIT_ERROR");
+    this.name = "RateLimitError";
+  }
+};
+
+// src/client.ts
+var ChannlizeClient = class {
+  config;
+  constructor(config) {
+    this.config = {
+      baseUrl: config.baseUrl || "https://api.channlize.com",
+      timeout: 1e4,
+      ...config
+    };
+    this.validateConfig();
+  }
+  validateConfig() {
+    if (!this.config.apiKey) {
+      throw new ValidationError("Widget key is required");
+    }
+  }
+  async makeRequest(endpoint, options = {}) {
+    const url = `${this.config.baseUrl}${endpoint}`;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        ...options,
+        signal: controller.signal,
+        headers: {
+          "Content-Type": "application/json",
+          ...options.headers
+        }
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        await this.handleErrorResponse(response);
+      }
+      const data = await response.json();
+      return data;
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error instanceof ChannlizeError) {
+        throw error;
+      }
+      if (error instanceof Error && error.name === "AbortError") {
+        throw new ChannlizeError("Request timeout", 408, "TIMEOUT");
+      }
+      throw new ChannlizeError(
+        `Network error: ${error instanceof Error ? error.message : "Unknown error"}`
+      );
+    }
+  }
+  async handleErrorResponse(response) {
+    const contentType = response.headers.get("content-type");
+    let errorData = {};
+    if (contentType?.includes("application/json")) {
+      try {
+        errorData = await response.json();
+      } catch {
+      }
+    }
+    const message = errorData.error || `HTTP ${response.status}: ${response.statusText}`;
+    switch (response.status) {
+      case 401:
+        throw new AuthenticationError(message);
+      case 400:
+        throw new ValidationError(message, errorData.field);
+      case 429:
+        throw new RateLimitError(message);
+      default:
+        throw new ChannlizeError(message, response.status, errorData.code);
+    }
+  }
+  /**
+   * Submit a contact form
+   */
+  async submitContactForm(data) {
+    const response = await this.makeRequest("/public/contact", {
+      method: "POST",
+      body: JSON.stringify({
+        widgetKey: this.config.apiKey,
+        // apiKey is actually the widgetKey
+        subject: data.subject,
+        message: data.message,
+        email: data.email,
+        name: data.name,
+        pageUrl: data.pageUrl || (typeof window !== "undefined" ? window.location.href : void 0),
+        userAgent: data.userAgent || (typeof navigator !== "undefined" ? navigator.userAgent : void 0)
+      })
+    });
+    return response.data || response;
+  }
+  /**
+   * Create a new chat session
+   */
+  async createChatSession(metadata) {
+    const response = await this.makeRequest("/v1/chat/sessions", {
+      method: "POST",
+      body: JSON.stringify({
+        widgetKey: this.config.apiKey,
+        // apiKey is actually the widgetKey
+        metadata: {
+          ...metadata,
+          pageUrl: typeof window !== "undefined" ? window.location.href : void 0,
+          userAgent: typeof navigator !== "undefined" ? navigator.userAgent : void 0
+        }
+      })
+    });
+    return response.data;
+  }
+  /**
+   * Send a message in a chat session
+   */
+  async sendMessage(sessionId, content, attachments) {
+    const idempotencyKey = `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;
+    const response = await this.makeRequest(
+      `/v1/chat/sessions/${sessionId}/messages`,
+      {
+        method: "POST",
+        body: JSON.stringify({
+          content,
+          idempotencyKey
+        })
+      }
+    );
+    return response.data;
+  }
+  /**
+   * Get chat session details
+   */
+  async getChatSession(sessionId) {
+    const response = await this.makeRequest(`/v1/chat/sessions/${sessionId}`);
+    return response.data;
+  }
+  /**
+   * Get messages for a chat session
+   */
+  async getChatMessages(sessionId, limit = 50, offset = 0) {
+    const response = await this.makeRequest(
+      `/v1/chat/sessions/${sessionId}/messages?limit=${limit}&offset=${offset}`
+    );
+    return response.data;
+  }
+  /**
+   * Close a chat session
+   */
+  async closeChatSession(sessionId) {
+    const response = await this.makeRequest(
+      `/v1/chat/sessions/${sessionId}/close`,
+      { method: "POST" }
+    );
+    return response.data;
+  }
+};
+export {
+  AuthenticationError,
+  ChannlizeClient,
+  ChannlizeError,
+  RateLimitError,
+  ValidationError,
+  ChannlizeClient as default
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts","../src/types.ts"],"sourcesContent":["import fetch from 'cross-fetch';\nimport type {\n  ChannlizeConfig,\n  ContactFormData,\n  ChatMessage,\n  ApiResponse,\n  CreateContactResponse,\n  CreateChatSessionResponse,\n  SendMessageResponse,\n  ChatSession,\n} from './types';\nimport {\n  ChannlizeError,\n  AuthenticationError,\n  ValidationError,\n  RateLimitError,\n} from './types';\n\n/**\n * Channlize API Client\n * Provides methods to interact with the Channlize platform\n */\nexport class ChannlizeClient {\n  private readonly config: Required<ChannlizeConfig>;\n\n  constructor(config: ChannlizeConfig) {\n    this.config = {\n      baseUrl: config.baseUrl || 'https://api.channlize.com',\n      timeout: 10000,\n      ...config,\n    };\n\n    this.validateConfig();\n  }\n\n  private validateConfig(): void {\n    if (!this.config.apiKey) {\n      throw new ValidationError('Widget key is required');\n    }\n  }\n\n  private async makeRequest<T>(\n    endpoint: string,\n    options: RequestInit = {}\n  ): Promise<ApiResponse<T>> {\n    const url = `${this.config.baseUrl}${endpoint}`;\n    \n    const controller = new AbortController();\n    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);\n\n    try {\n      const response = await fetch(url, {\n        ...options,\n        signal: controller.signal,\n        headers: {\n          'Content-Type': 'application/json',\n          ...options.headers,\n        },\n      });\n\n      clearTimeout(timeoutId);\n\n      if (!response.ok) {\n        await this.handleErrorResponse(response);\n      }\n\n      const data = await response.json();\n      return data as ApiResponse<T>;\n    } catch (error) {\n      clearTimeout(timeoutId);\n      \n      if (error instanceof ChannlizeError) {\n        throw error;\n      }\n      \n      if (error instanceof Error && error.name === 'AbortError') {\n        throw new ChannlizeError('Request timeout', 408, 'TIMEOUT');\n      }\n      \n      throw new ChannlizeError(\n        `Network error: ${error instanceof Error ? error.message : 'Unknown error'}`\n      );\n    }\n  }\n\n  private async handleErrorResponse(response: Response): Promise<never> {\n    const contentType = response.headers.get('content-type');\n    let errorData: any = {};\n\n    if (contentType?.includes('application/json')) {\n      try {\n        errorData = await response.json();\n      } catch {\n        // Ignore JSON parsing errors\n      }\n    }\n\n    const message = errorData.error || `HTTP ${response.status}: ${response.statusText}`;\n\n    switch (response.status) {\n      case 401:\n        throw new AuthenticationError(message);\n      case 400:\n        throw new ValidationError(message, errorData.field);\n      case 429:\n        throw new RateLimitError(message);\n      default:\n        throw new ChannlizeError(message, response.status, errorData.code);\n    }\n  }\n\n  /**\n   * Submit a contact form\n   */\n  async submitContactForm(data: ContactFormData): Promise<CreateContactResponse> {\n    const response = await this.makeRequest<CreateContactResponse>('/public/contact', {\n      method: 'POST',\n      body: JSON.stringify({\n        widgetKey: this.config.apiKey, // apiKey is actually the widgetKey\n        subject: data.subject,\n        message: data.message,\n        email: data.email,\n        name: data.name,\n        pageUrl: data.pageUrl || (typeof window !== 'undefined' ? window.location.href : undefined),\n        userAgent: data.userAgent || (typeof navigator !== 'undefined' ? navigator.userAgent : undefined),\n      }),\n    });\n\n    return response.data || response;\n  }\n\n  /**\n   * Create a new chat session\n   */\n  async createChatSession(metadata?: Record<string, unknown>): Promise<CreateChatSessionResponse> {\n    const response = await this.makeRequest<CreateChatSessionResponse>('/v1/chat/sessions', {\n      method: 'POST',\n      body: JSON.stringify({\n        widgetKey: this.config.apiKey, // apiKey is actually the widgetKey\n        metadata: {\n          ...metadata,\n          pageUrl: typeof window !== 'undefined' ? window.location.href : undefined,\n          userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n        },\n      }),\n    });\n\n    return response.data;\n  }\n\n  /**\n   * Send a message in a chat session\n   */\n  async sendMessage(\n    sessionId: string,\n    content: string,\n    attachments?: File[]\n  ): Promise<SendMessageResponse> {\n    // Generate idempotency key to prevent duplicate message creation\n    const idempotencyKey = `msg_${Date.now()}_${Math.random().toString(36).substr(2, 9)}`;\n    \n    // For now, we send as JSON. File attachments support can be added later.\n    // TODO: Implement file upload support\n    const response = await this.makeRequest<SendMessageResponse>(\n      `/v1/chat/sessions/${sessionId}/messages`,\n      {\n        method: 'POST',\n        body: JSON.stringify({\n          content,\n          idempotencyKey,\n        }),\n      }\n    );\n\n    return response.data;\n  }\n\n  /**\n   * Get chat session details\n   */\n  async getChatSession(sessionId: string): Promise<ChatSession> {\n    const response = await this.makeRequest<ChatSession>(`/v1/chat/sessions/${sessionId}`);\n    return response.data;\n  }\n\n  /**\n   * Get messages for a chat session\n   */\n  async getChatMessages(sessionId: string, limit = 50, offset = 0): Promise<ChatMessage[]> {\n    const response = await this.makeRequest<ChatMessage[]>(\n      `/v1/chat/sessions/${sessionId}/messages?limit=${limit}&offset=${offset}`\n    );\n    return response.data;\n  }\n\n  /**\n   * Close a chat session\n   */\n  async closeChatSession(sessionId: string): Promise<ChatSession> {\n    const response = await this.makeRequest<ChatSession>(\n      `/v1/chat/sessions/${sessionId}/close`,\n      { method: 'POST' }\n    );\n    return response.data;\n  }\n}\n","/**\n * Core types for Channlize SDK\n */\n\nexport interface ChannlizeConfig {\n  /** API key for authentication */\n  apiKey: string;\n  /** Base URL for the Channlize API */\n  baseUrl?: string;\n  /** Project ID */\n  projectId: string;\n  /** Request timeout in milliseconds */\n  timeout?: number;\n}\n\nexport interface ContactFormData {\n  /** Contact's name */\n  name: string;\n  /** Contact's email address */\n  email: string;\n  /** Subject of the inquiry */\n  subject?: string;\n  /** Message content */\n  message: string;\n  /** Custom fields */\n  customFields?: Record<string, unknown>;\n  /** Page URL where the form was submitted */\n  pageUrl?: string;\n  /** User agent string */\n  userAgent?: string;\n}\n\nexport interface ChatMessage {\n  /** Unique message ID */\n  id: string;\n  /** Message content */\n  content: string;\n  /** Message timestamp */\n  timestamp: Date;\n  /** Message author (user or agent) */\n  author: 'user' | 'agent';\n  /** Author metadata */\n  authorData?: {\n    name?: string;\n    email?: string;\n    avatarUrl?: string;\n  };\n  /** Attached files */\n  attachments?: FileAttachment[];\n}\n\nexport interface FileAttachment {\n  /** File ID */\n  id: string;\n  /** Original filename */\n  name: string;\n  /** File size in bytes */\n  size: number;\n  /** MIME type */\n  type: string;\n  /** Download URL */\n  url: string;\n}\n\nexport interface ChatSession {\n  /** Session ID */\n  id: string;\n  /** Session status */\n  status: 'active' | 'closed' | 'waiting';\n  /** Messages in the session */\n  messages: ChatMessage[];\n  /** Session metadata */\n  metadata?: Record<string, unknown>;\n  /** Created timestamp */\n  createdAt: Date;\n  /** Updated timestamp */\n  updatedAt: Date;\n}\n\nexport interface ApiResponse<T = unknown> {\n  /** Response data */\n  data: T;\n  /** Success status */\n  success: boolean;\n  /** Error message if any */\n  error?: string;\n  /** Additional metadata */\n  meta?: Record<string, unknown>;\n}\n\nexport interface CreateContactResponse {\n  /** Contact form submission ID */\n  id: string;\n  /** Status of the submission */\n  status: 'received' | 'processing' | 'delivered';\n  /** Slack thread URL if available */\n  slackThreadUrl?: string;\n}\n\nexport interface CreateChatSessionResponse {\n  /** Chat session data */\n  session: ChatSession;\n  /** SSE endpoint for real-time updates */\n  sseEndpoint?: string;\n}\n\nexport interface SendMessageResponse {\n  /** The sent message */\n  message: ChatMessage;\n  /** Updated session */\n  session: ChatSession;\n}\n\n/**\n * Error types\n */\nexport class ChannlizeError extends Error {\n  constructor(\n    message: string,\n    public statusCode?: number,\n    public code?: string\n  ) {\n    super(message);\n    this.name = 'ChannlizeError';\n  }\n}\n\nexport class ValidationError extends ChannlizeError {\n  constructor(message: string, public field?: string) {\n    super(message, 400, 'VALIDATION_ERROR');\n    this.name = 'ValidationError';\n  }\n}\n\nexport class AuthenticationError extends ChannlizeError {\n  constructor(message: string = 'Authentication failed') {\n    super(message, 401, 'AUTHENTICATION_ERROR');\n    this.name = 'AuthenticationError';\n  }\n}\n\nexport class RateLimitError extends ChannlizeError {\n  constructor(message: string = 'Rate limit exceeded') {\n    super(message, 429, 'RATE_LIMIT_ERROR');\n    this.name = 'RateLimitError';\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "@channlize/core",
+  "version": "0.1.0-alpha.1",
+  "description": "Channlize Core SDK - TypeScript API wrapper for Channlize platform",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src --ext .ts",
+    "lint:fix": "eslint src --ext .ts --fix",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist"
+  },
+  "keywords": [
+    "channlize",
+    "api",
+    "typescript",
+    "sdk"
+  ],
+  "author": "Channlize Team",
+  "license": "MIT",
+  "dependencies": {
+    "cross-fetch": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.5",
+    "@typescript-eslint/eslint-plugin": "^6.21.0",
+    "@typescript-eslint/parser": "^6.21.0",
+    "eslint": "^8.56.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/channlize/sdk.git",
+    "directory": "packages/core"
+  }
+}