codmir 0.1.0

package/README.md

@@ -0,0 +1,322 @@
+# codmir
+
+> TypeScript SDK for codmir API - **the AI that prevents wasted engineering time**.
+
+[![npm version](https://badge.fury.io/js/codmir.svg)](https://www.npmjs.com/package/codmir)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## Features
+
+- ✅ **Full TypeScript support** with complete type definitions
+- 🎫 **Tickets API** - Create and manage project tickets
+- 🧪 **Test Cases API** - Create, update, and manage test cases
+- 🔐 **API Key authentication** 
+- ⚡ **Promise-based** async/await API
+- 🌐 **Works in Node.js and browsers**
+- 📦 **Zero dependencies**
+
+## Installation
+
+```bash
+npm install codmir
+```
+
+or with pnpm:
+
+```bash
+pnpm add codmir
+```
+
+or with yarn:
+
+```bash
+yarn add codmir
+```
+
+## Quick Start
+
+```typescript
+import { CodmirClient } from 'codmir';
+
+// Initialize the client
+const client = new CodmirClient({
+  apiKey: 'your-api-key-here',
+  baseUrl: 'https://codmir.com', // optional, defaults to https://codmir.com
+});
+
+// Create a ticket
+const ticket = await client.tickets.create('project-id', 'board-id', {
+  title: 'Implement user authentication',
+  description: 'Add OAuth2 support for Google and GitHub',
+  priority: 'HIGH',
+  status: 'TODO',
+  type: 'FEATURE',
+});
+
+console.log('Created ticket:', ticket.id);
+
+// Create a test case
+const testCase = await client.testCases.create('project-id', {
+  title: 'Test login functionality',
+  suiteId: 'test-suite-id',
+  template: 'steps',
+  priority: 'High',
+  steps: [
+    { action: 'Navigate to login page', expected: 'Login form is displayed' },
+    { action: 'Enter valid credentials', expected: 'User is authenticated' },
+    { action: 'Click submit button', expected: 'User is redirected to dashboard' },
+  ],
+});
+
+console.log('Created test case:', testCase.id);
+```
+
+## API Reference
+
+### Client Configuration
+
+```typescript
+interface CodmirClientConfig {
+  apiKey?: string;           // Your API key
+  baseUrl?: string;          // API base URL (default: https://codmir.com)
+  timeout?: number;          // Request timeout in ms (default: 30000)
+  headers?: Record<string, string>; // Additional headers
+}
+```
+
+### Tickets API
+
+#### Create Ticket in Board
+
+```typescript
+const ticket = await client.tickets.createInBoard(
+  projectId: string,
+  boardId: string,
+  data: CreateTicketInput
+);
+```
+
+#### Create Ticket in Workspace
+
+```typescript
+const ticket = await client.tickets.createInWorkspace(
+  projectId: string,
+  workspaceId: string,
+  data: CreateTicketInput
+);
+```
+
+#### CreateTicketInput
+
+```typescript
+interface CreateTicketInput {
+  title: string;              // Required
+  description?: string;
+  status?: TicketStatus;      // BACKLOG | TODO | IN_PROGRESS | DONE | CANCELED
+  priority?: TicketPriority;  // LOW | MEDIUM | HIGH | CRITICAL
+  type?: TicketType;          // TASK | BUG | STORY | EPIC | FEATURE | IMPROVEMENT
+  assigneeId?: string;
+  reporterId?: string;
+  groupId?: string;
+  parentId?: string;
+  teamId?: string;
+  labels?: string;
+  dueDate?: string;           // ISO date string
+  order?: number;
+  customFields?: Record<string, any>;
+}
+```
+
+### Test Cases API
+
+#### List Test Cases
+
+```typescript
+const testCases = await client.testCases.list(projectId: string);
+```
+
+#### Get Test Case
+
+```typescript
+const testCase = await client.testCases.get(
+  projectId: string,
+  testCaseId: string | number
+);
+```
+
+#### Create Test Case
+
+```typescript
+const result = await client.testCases.create(
+  projectId: string,
+  data: CreateTestCaseInput
+);
+```
+
+#### Update Test Case
+
+```typescript
+const result = await client.testCases.update(
+  projectId: string,
+  testCaseId: string | number,
+  data: UpdateTestCaseInput
+);
+```
+
+#### Delete Test Case
+
+```typescript
+await client.testCases.delete(
+  projectId: string,
+  testCaseId: string | number
+);
+```
+
+#### CreateTestCaseInput
+
+```typescript
+interface CreateTestCaseInput {
+  title: string;                    // Required
+  suiteId: string;                  // Required - Test suite ID
+  template?: 'steps' | 'text';      // Default: 'steps'
+  type?: string;                    // Default: 'Functional'
+  priority?: 'Low' | 'Medium' | 'High'; // Default: 'Medium'
+  estimate?: string;                // e.g., '5m', '1h', '2d'
+  preconditions?: string;
+  steps?: TestCaseStep[];           // For 'steps' template
+  stepsText?: string;               // For 'text' template
+}
+
+interface TestCaseStep {
+  action: string;
+  expected: string;
+}
+```
+
+#### UpdateTestCaseInput
+
+```typescript
+interface UpdateTestCaseInput extends Partial<CreateTestCaseInput> {
+  status?: 'Not Started' | 'In Progress' | 'Passed' | 'Failed' | 'Blocked';
+}
+```
+
+## Examples
+
+### Create a Bug Ticket
+
+```typescript
+const bug = await client.tickets.create('project-id', 'board-id', {
+  title: 'Fix memory leak in dashboard',
+  description: 'Users report increasing memory usage over time',
+  type: 'BUG',
+  priority: 'CRITICAL',
+  status: 'TODO',
+  assigneeId: 'user-123',
+});
+```
+
+### Create a Test Case with Steps
+
+```typescript
+const testCase = await client.testCases.create('project-id', {
+  title: 'User registration flow',
+  suiteId: 'suite-123',
+  template: 'steps',
+  priority: 'High',
+  estimate: '15m',
+  preconditions: 'User is not logged in',
+  steps: [
+    {
+      action: 'Click "Sign Up" button',
+      expected: 'Registration form is displayed',
+    },
+    {
+      action: 'Fill in email and password',
+      expected: 'Form validation passes',
+    },
+    {
+      action: 'Submit the form',
+      expected: 'User account is created and email is sent',
+    },
+  ],
+});
+```
+
+### Update Test Case Status
+
+```typescript
+await client.testCases.update('project-id', 'TC-123', {
+  status: 'Passed',
+});
+```
+
+### Error Handling
+
+```typescript
+try {
+  const ticket = await client.tickets.create('project-id', 'board-id', {
+    title: 'New ticket',
+  });
+} catch (error) {
+  if (error.statusCode === 401) {
+    console.error('Invalid API key');
+  } else if (error.statusCode === 404) {
+    console.error('Project or board not found');
+  } else {
+    console.error('Error:', error.message);
+  }
+}
+```
+
+## Authentication
+
+To use the API, you need an API key. You can obtain one from your codmir account settings.
+
+Set the API key when initializing the client:
+
+```typescript
+const client = new CodmirClient({
+  apiKey: process.env.CODMIR_API_KEY, // Recommended: use environment variables
+});
+```
+
+The API key will be sent in the `X-API-Key` header with each request.
+
+## TypeScript Support
+
+This package is written in TypeScript and includes complete type definitions. You'll get full IDE autocomplete and type checking out of the box.
+
+```typescript
+import type { 
+  Ticket, 
+  TestCase, 
+  CreateTicketInput,
+  TicketPriority 
+} from 'codmir';
+```
+
+## Requirements
+
+- Node.js >= 18.0.0
+- TypeScript >= 5.0.0 (if using TypeScript)
+
+## Browser Support
+
+This package uses the Fetch API which is available in all modern browsers and Node.js 18+. For older environments, you may need a polyfill.
+
+## License
+
+MIT
+
+## Links
+
+- [codmir Website](https://codmir.com)
+- [Documentation](https://codmir.com/docs)
+- [GitHub Repository](https://github.com/codmir/codmir)
+- [Report Issues](https://github.com/codmir/codmir/issues)
+
+---
+
+**codmir is the AI that prevents wasted engineering time.**

package/dist/index.d.mts

@@ -0,0 +1,220 @@
+/**
+ * codmir API Types
+ */
+type TicketStatus = 'BACKLOG' | 'TODO' | 'IN_PROGRESS' | 'DONE' | 'CANCELED' | 'OPEN';
+type TicketPriority = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+type TicketType = 'TASK' | 'BUG' | 'STORY' | 'EPIC' | 'FEATURE' | 'IMPROVEMENT';
+type TestCasePriority = 'Low' | 'Medium' | 'High';
+type TestCaseStatus = 'Not Started' | 'In Progress' | 'Passed' | 'Failed' | 'Blocked';
+type TestCaseTemplate = 'steps' | 'text';
+interface User {
+    id: string;
+    name: string | null;
+    email: string | null;
+    image?: string | null;
+}
+interface Ticket {
+    id: string;
+    title: string;
+    description: string | null;
+    status: TicketStatus;
+    priority: TicketPriority;
+    type?: TicketType | null;
+    assigneeId?: string | null;
+    assignee?: User | null;
+    reporterId?: string | null;
+    reporter?: User | null;
+    projectId: string;
+    workspaceId?: string | null;
+    organizationId?: string;
+    groupId?: string | null;
+    parentId?: string | null;
+    teamId?: string | null;
+    orderIndex?: number | null;
+    labels?: string | null;
+    due_date?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateTicketInput {
+    title: string;
+    description?: string;
+    status?: TicketStatus | string;
+    priority?: TicketPriority | string;
+    type?: TicketType;
+    assigneeId?: string;
+    reporterId?: string;
+    groupId?: string;
+    parentId?: string;
+    teamId?: string;
+    labels?: string;
+    dueDate?: string;
+    order?: number;
+    customFields?: Record<string, any>;
+}
+interface UpdateTicketInput extends Partial<CreateTicketInput> {
+    id: string;
+}
+interface TestCaseStep {
+    action: string;
+    expected: string;
+}
+interface TestCase {
+    id: string;
+    ud?: number;
+    title: string;
+    status: TestCaseStatus;
+    priority: TestCasePriority;
+    suiteId: string | null;
+    suiteName?: string | null;
+    estimate?: string;
+    template?: TestCaseTemplate;
+    type?: string;
+    preconditions?: string;
+    steps?: TestCaseStep[];
+    stepsText?: string;
+}
+interface CreateTestCaseInput {
+    title: string;
+    suiteId: string;
+    template?: TestCaseTemplate;
+    type?: string;
+    priority?: TestCasePriority;
+    estimate?: string;
+    preconditions?: string;
+    steps?: TestCaseStep[];
+    stepsText?: string;
+}
+interface UpdateTestCaseInput extends Partial<CreateTestCaseInput> {
+    status?: TestCaseStatus;
+}
+interface ApiResponse<T> {
+    data?: T;
+    error?: string;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    total?: number;
+    page?: number;
+    pageSize?: number;
+}
+interface CodmirClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+declare class CodmirError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+
+/**
+ * Main codmir API Client
+ *
+ * @example
+ * ```typescript
+ * const client = new CodmirClient({
+ *   apiKey: 'your-api-key',
+ *   baseUrl: 'https://codmir.com'
+ * });
+ *
+ * // Create a ticket
+ * const ticket = await client.tickets.create('project-id', {
+ *   title: 'New feature request',
+ *   description: 'Add dark mode support',
+ *   priority: 'HIGH'
+ * });
+ * ```
+ */
+declare class CodmirClient {
+    private readonly config;
+    readonly tickets: TicketsAPI;
+    readonly testCases: TestCasesAPI;
+    constructor(config: CodmirClientConfig);
+    /**
+     * Make an HTTP request to the codmir API
+     */
+    private request;
+    private createError;
+}
+/**
+ * Tickets API
+ */
+declare class TicketsAPI {
+    private config;
+    constructor(config: Required<CodmirClientConfig>);
+    private request;
+    /**
+     * Create a ticket in a board
+     *
+     * @param projectId - The project ID
+     * @param boardId - The board ID
+     * @param data - Ticket data
+     */
+    createInBoard(projectId: string, boardId: string, data: CreateTicketInput): Promise<Ticket>;
+    /**
+     * Create a ticket in a workspace
+     *
+     * @param projectId - The project ID
+     * @param workspaceId - The workspace ID
+     * @param data - Ticket data
+     */
+    createInWorkspace(projectId: string, workspaceId: string, data: CreateTicketInput): Promise<Ticket>;
+    /**
+     * Alias for createInBoard - creates a ticket in a board
+     */
+    create(projectId: string, boardId: string, data: CreateTicketInput): Promise<Ticket>;
+}
+/**
+ * Test Cases API
+ */
+declare class TestCasesAPI {
+    private config;
+    constructor(config: Required<CodmirClientConfig>);
+    private request;
+    /**
+     * List all test cases for a project
+     *
+     * @param projectId - The project ID
+     */
+    list(projectId: string): Promise<TestCase[]>;
+    /**
+     * Get a specific test case by ID
+     *
+     * @param projectId - The project ID
+     * @param testCaseId - The test case ID (numeric UD)
+     */
+    get(projectId: string, testCaseId: string | number): Promise<TestCase>;
+    /**
+     * Create a new test case
+     *
+     * @param projectId - The project ID
+     * @param data - Test case data
+     */
+    create(projectId: string, data: CreateTestCaseInput): Promise<{
+        id: string;
+        title: string;
+    }>;
+    /**
+     * Update an existing test case
+     *
+     * @param projectId - The project ID
+     * @param testCaseId - The test case ID (numeric UD)
+     * @param data - Test case update data
+     */
+    update(projectId: string, testCaseId: string | number, data: UpdateTestCaseInput): Promise<{
+        id: string;
+        title: string;
+    }>;
+    /**
+     * Delete a test case
+     *
+     * @param projectId - The project ID
+     * @param testCaseId - The test case ID (numeric UD)
+     */
+    delete(projectId: string, testCaseId: string | number): Promise<void>;
+}
+
+export { type ApiResponse, CodmirClient, type CodmirClientConfig, CodmirError, type CreateTestCaseInput, type CreateTicketInput, type PaginatedResponse, type TestCase, type TestCasePriority, type TestCaseStatus, type TestCaseStep, type TestCaseTemplate, type Ticket, type TicketPriority, type TicketStatus, type TicketType, type UpdateTestCaseInput, type UpdateTicketInput, type User };

package/dist/index.d.ts

@@ -0,0 +1,220 @@
+/**
+ * codmir API Types
+ */
+type TicketStatus = 'BACKLOG' | 'TODO' | 'IN_PROGRESS' | 'DONE' | 'CANCELED' | 'OPEN';
+type TicketPriority = 'LOW' | 'MEDIUM' | 'HIGH' | 'CRITICAL';
+type TicketType = 'TASK' | 'BUG' | 'STORY' | 'EPIC' | 'FEATURE' | 'IMPROVEMENT';
+type TestCasePriority = 'Low' | 'Medium' | 'High';
+type TestCaseStatus = 'Not Started' | 'In Progress' | 'Passed' | 'Failed' | 'Blocked';
+type TestCaseTemplate = 'steps' | 'text';
+interface User {
+    id: string;
+    name: string | null;
+    email: string | null;
+    image?: string | null;
+}
+interface Ticket {
+    id: string;
+    title: string;
+    description: string | null;
+    status: TicketStatus;
+    priority: TicketPriority;
+    type?: TicketType | null;
+    assigneeId?: string | null;
+    assignee?: User | null;
+    reporterId?: string | null;
+    reporter?: User | null;
+    projectId: string;
+    workspaceId?: string | null;
+    organizationId?: string;
+    groupId?: string | null;
+    parentId?: string | null;
+    teamId?: string | null;
+    orderIndex?: number | null;
+    labels?: string | null;
+    due_date?: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}
+interface CreateTicketInput {
+    title: string;
+    description?: string;
+    status?: TicketStatus | string;
+    priority?: TicketPriority | string;
+    type?: TicketType;
+    assigneeId?: string;
+    reporterId?: string;
+    groupId?: string;
+    parentId?: string;
+    teamId?: string;
+    labels?: string;
+    dueDate?: string;
+    order?: number;
+    customFields?: Record<string, any>;
+}
+interface UpdateTicketInput extends Partial<CreateTicketInput> {
+    id: string;
+}
+interface TestCaseStep {
+    action: string;
+    expected: string;
+}
+interface TestCase {
+    id: string;
+    ud?: number;
+    title: string;
+    status: TestCaseStatus;
+    priority: TestCasePriority;
+    suiteId: string | null;
+    suiteName?: string | null;
+    estimate?: string;
+    template?: TestCaseTemplate;
+    type?: string;
+    preconditions?: string;
+    steps?: TestCaseStep[];
+    stepsText?: string;
+}
+interface CreateTestCaseInput {
+    title: string;
+    suiteId: string;
+    template?: TestCaseTemplate;
+    type?: string;
+    priority?: TestCasePriority;
+    estimate?: string;
+    preconditions?: string;
+    steps?: TestCaseStep[];
+    stepsText?: string;
+}
+interface UpdateTestCaseInput extends Partial<CreateTestCaseInput> {
+    status?: TestCaseStatus;
+}
+interface ApiResponse<T> {
+    data?: T;
+    error?: string;
+}
+interface PaginatedResponse<T> {
+    data: T[];
+    total?: number;
+    page?: number;
+    pageSize?: number;
+}
+interface CodmirClientConfig {
+    apiKey?: string;
+    baseUrl?: string;
+    timeout?: number;
+    headers?: Record<string, string>;
+}
+declare class CodmirError extends Error {
+    statusCode?: number | undefined;
+    response?: any | undefined;
+    constructor(message: string, statusCode?: number | undefined, response?: any | undefined);
+}
+
+/**
+ * Main codmir API Client
+ *
+ * @example
+ * ```typescript
+ * const client = new CodmirClient({
+ *   apiKey: 'your-api-key',
+ *   baseUrl: 'https://codmir.com'
+ * });
+ *
+ * // Create a ticket
+ * const ticket = await client.tickets.create('project-id', {
+ *   title: 'New feature request',
+ *   description: 'Add dark mode support',
+ *   priority: 'HIGH'
+ * });
+ * ```
+ */
+declare class CodmirClient {
+    private readonly config;
+    readonly tickets: TicketsAPI;
+    readonly testCases: TestCasesAPI;
+    constructor(config: CodmirClientConfig);
+    /**
+     * Make an HTTP request to the codmir API
+     */
+    private request;
+    private createError;
+}
+/**
+ * Tickets API
+ */
+declare class TicketsAPI {
+    private config;
+    constructor(config: Required<CodmirClientConfig>);
+    private request;
+    /**
+     * Create a ticket in a board
+     *
+     * @param projectId - The project ID
+     * @param boardId - The board ID
+     * @param data - Ticket data
+     */
+    createInBoard(projectId: string, boardId: string, data: CreateTicketInput): Promise<Ticket>;
+    /**
+     * Create a ticket in a workspace
+     *
+     * @param projectId - The project ID
+     * @param workspaceId - The workspace ID
+     * @param data - Ticket data
+     */
+    createInWorkspace(projectId: string, workspaceId: string, data: CreateTicketInput): Promise<Ticket>;
+    /**
+     * Alias for createInBoard - creates a ticket in a board
+     */
+    create(projectId: string, boardId: string, data: CreateTicketInput): Promise<Ticket>;
+}
+/**
+ * Test Cases API
+ */
+declare class TestCasesAPI {
+    private config;
+    constructor(config: Required<CodmirClientConfig>);
+    private request;
+    /**
+     * List all test cases for a project
+     *
+     * @param projectId - The project ID
+     */
+    list(projectId: string): Promise<TestCase[]>;
+    /**
+     * Get a specific test case by ID
+     *
+     * @param projectId - The project ID
+     * @param testCaseId - The test case ID (numeric UD)
+     */
+    get(projectId: string, testCaseId: string | number): Promise<TestCase>;
+    /**
+     * Create a new test case
+     *
+     * @param projectId - The project ID
+     * @param data - Test case data
+     */
+    create(projectId: string, data: CreateTestCaseInput): Promise<{
+        id: string;
+        title: string;
+    }>;
+    /**
+     * Update an existing test case
+     *
+     * @param projectId - The project ID
+     * @param testCaseId - The test case ID (numeric UD)
+     * @param data - Test case update data
+     */
+    update(projectId: string, testCaseId: string | number, data: UpdateTestCaseInput): Promise<{
+        id: string;
+        title: string;
+    }>;
+    /**
+     * Delete a test case
+     *
+     * @param projectId - The project ID
+     * @param testCaseId - The test case ID (numeric UD)
+     */
+    delete(projectId: string, testCaseId: string | number): Promise<void>;
+}
+
+export { type ApiResponse, CodmirClient, type CodmirClientConfig, CodmirError, type CreateTestCaseInput, type CreateTicketInput, type PaginatedResponse, type TestCase, type TestCasePriority, type TestCaseStatus, type TestCaseStep, type TestCaseTemplate, type Ticket, type TicketPriority, type TicketStatus, type TicketType, type UpdateTestCaseInput, type UpdateTicketInput, type User };

package/dist/index.js

@@ -0,0 +1,299 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  CodmirClient: () => CodmirClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var CodmirClient = class {
+  constructor(config) {
+    this.config = {
+      apiKey: config.apiKey || "",
+      baseUrl: config.baseUrl || "https://codmir.com",
+      timeout: config.timeout || 3e4,
+      headers: config.headers || {}
+    };
+    this.tickets = new TicketsAPI(this.config);
+    this.testCases = new TestCasesAPI(this.config);
+  }
+  /**
+   * Make an HTTP request to the codmir API
+   */
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw this.createError(
+          errorData.error || `HTTP ${response.status}: ${response.statusText}`,
+          response.status,
+          errorData
+        );
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        throw this.createError("Request timeout", 408);
+      }
+      if (error instanceof Error && "statusCode" in error) {
+        throw error;
+      }
+      throw this.createError(
+        error.message || "Network error occurred",
+        void 0,
+        error
+      );
+    }
+  }
+  createError(message, statusCode, response) {
+    const error = new Error(message);
+    error.name = "CodmirError";
+    error.statusCode = statusCode;
+    error.response = response;
+    return error;
+  }
+};
+var TicketsAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const error = new Error(errorData.error || `HTTP ${response.status}`);
+        error.statusCode = response.status;
+        error.response = errorData;
+        throw error;
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        const timeoutError = new Error("Request timeout");
+        timeoutError.statusCode = 408;
+        throw timeoutError;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Create a ticket in a board
+   * 
+   * @param projectId - The project ID
+   * @param boardId - The board ID
+   * @param data - Ticket data
+   */
+  async createInBoard(projectId, boardId, data) {
+    const response = await this.request(
+      "POST",
+      `/api/project/${projectId}/board/${boardId}/ticket`,
+      data
+    );
+    return response.ticket;
+  }
+  /**
+   * Create a ticket in a workspace
+   * 
+   * @param projectId - The project ID
+   * @param workspaceId - The workspace ID
+   * @param data - Ticket data
+   */
+  async createInWorkspace(projectId, workspaceId, data) {
+    return this.request(
+      "POST",
+      `/api/project/${projectId}/workspaces/${workspaceId}/tickets`,
+      data
+    );
+  }
+  /**
+   * Alias for createInBoard - creates a ticket in a board
+   */
+  async create(projectId, boardId, data) {
+    return this.createInBoard(projectId, boardId, data);
+  }
+};
+var TestCasesAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const error = new Error(errorData.error || `HTTP ${response.status}`);
+        error.statusCode = response.status;
+        error.response = errorData;
+        throw error;
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        const timeoutError = new Error("Request timeout");
+        timeoutError.statusCode = 408;
+        throw timeoutError;
+      }
+      throw error;
+    }
+  }
+  /**
+   * List all test cases for a project
+   * 
+   * @param projectId - The project ID
+   */
+  async list(projectId) {
+    const response = await this.request(
+      "GET",
+      `/api/project/${projectId}/test-cases`
+    );
+    return response.data || [];
+  }
+  /**
+   * Get a specific test case by ID
+   * 
+   * @param projectId - The project ID
+   * @param testCaseId - The test case ID (numeric UD)
+   */
+  async get(projectId, testCaseId) {
+    const response = await this.request(
+      "GET",
+      `/api/project/${projectId}/test-cases/${testCaseId}`
+    );
+    if (!response.data) {
+      throw new Error("Test case not found");
+    }
+    return response.data;
+  }
+  /**
+   * Create a new test case
+   * 
+   * @param projectId - The project ID
+   * @param data - Test case data
+   */
+  async create(projectId, data) {
+    const response = await this.request(
+      "POST",
+      `/api/project/${projectId}/test-cases`,
+      data
+    );
+    if (!response.data) {
+      throw new Error("Failed to create test case");
+    }
+    return response.data;
+  }
+  /**
+   * Update an existing test case
+   * 
+   * @param projectId - The project ID
+   * @param testCaseId - The test case ID (numeric UD)
+   * @param data - Test case update data
+   */
+  async update(projectId, testCaseId, data) {
+    const response = await this.request(
+      "PATCH",
+      `/api/project/${projectId}/test-cases/${testCaseId}`,
+      data
+    );
+    if (!response.data) {
+      throw new Error("Failed to update test case");
+    }
+    return response.data;
+  }
+  /**
+   * Delete a test case
+   * 
+   * @param projectId - The project ID
+   * @param testCaseId - The test case ID (numeric UD)
+   */
+  async delete(projectId, testCaseId) {
+    await this.request(
+      "DELETE",
+      `/api/project/${projectId}/test-cases/${testCaseId}`
+    );
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CodmirClient
+});

package/dist/index.mjs

@@ -0,0 +1,272 @@
+// src/client.ts
+var CodmirClient = class {
+  constructor(config) {
+    this.config = {
+      apiKey: config.apiKey || "",
+      baseUrl: config.baseUrl || "https://codmir.com",
+      timeout: config.timeout || 3e4,
+      headers: config.headers || {}
+    };
+    this.tickets = new TicketsAPI(this.config);
+    this.testCases = new TestCasesAPI(this.config);
+  }
+  /**
+   * Make an HTTP request to the codmir API
+   */
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        throw this.createError(
+          errorData.error || `HTTP ${response.status}: ${response.statusText}`,
+          response.status,
+          errorData
+        );
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        throw this.createError("Request timeout", 408);
+      }
+      if (error instanceof Error && "statusCode" in error) {
+        throw error;
+      }
+      throw this.createError(
+        error.message || "Network error occurred",
+        void 0,
+        error
+      );
+    }
+  }
+  createError(message, statusCode, response) {
+    const error = new Error(message);
+    error.name = "CodmirError";
+    error.statusCode = statusCode;
+    error.response = response;
+    return error;
+  }
+};
+var TicketsAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const error = new Error(errorData.error || `HTTP ${response.status}`);
+        error.statusCode = response.status;
+        error.response = errorData;
+        throw error;
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        const timeoutError = new Error("Request timeout");
+        timeoutError.statusCode = 408;
+        throw timeoutError;
+      }
+      throw error;
+    }
+  }
+  /**
+   * Create a ticket in a board
+   * 
+   * @param projectId - The project ID
+   * @param boardId - The board ID
+   * @param data - Ticket data
+   */
+  async createInBoard(projectId, boardId, data) {
+    const response = await this.request(
+      "POST",
+      `/api/project/${projectId}/board/${boardId}/ticket`,
+      data
+    );
+    return response.ticket;
+  }
+  /**
+   * Create a ticket in a workspace
+   * 
+   * @param projectId - The project ID
+   * @param workspaceId - The workspace ID
+   * @param data - Ticket data
+   */
+  async createInWorkspace(projectId, workspaceId, data) {
+    return this.request(
+      "POST",
+      `/api/project/${projectId}/workspaces/${workspaceId}/tickets`,
+      data
+    );
+  }
+  /**
+   * Alias for createInBoard - creates a ticket in a board
+   */
+  async create(projectId, boardId, data) {
+    return this.createInBoard(projectId, boardId, data);
+  }
+};
+var TestCasesAPI = class {
+  constructor(config) {
+    this.config = config;
+  }
+  async request(method, path, body) {
+    const url = `${this.config.baseUrl}${path}`;
+    const headers = {
+      "Content-Type": "application/json",
+      ...this.config.headers
+    };
+    if (this.config.apiKey) {
+      headers["X-API-Key"] = this.config.apiKey;
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), this.config.timeout);
+    try {
+      const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : void 0,
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+      if (!response.ok) {
+        const errorData = await response.json().catch(() => ({}));
+        const error = new Error(errorData.error || `HTTP ${response.status}`);
+        error.statusCode = response.status;
+        error.response = errorData;
+        throw error;
+      }
+      if (response.status === 204) {
+        return {};
+      }
+      return await response.json();
+    } catch (error) {
+      clearTimeout(timeoutId);
+      if (error.name === "AbortError") {
+        const timeoutError = new Error("Request timeout");
+        timeoutError.statusCode = 408;
+        throw timeoutError;
+      }
+      throw error;
+    }
+  }
+  /**
+   * List all test cases for a project
+   * 
+   * @param projectId - The project ID
+   */
+  async list(projectId) {
+    const response = await this.request(
+      "GET",
+      `/api/project/${projectId}/test-cases`
+    );
+    return response.data || [];
+  }
+  /**
+   * Get a specific test case by ID
+   * 
+   * @param projectId - The project ID
+   * @param testCaseId - The test case ID (numeric UD)
+   */
+  async get(projectId, testCaseId) {
+    const response = await this.request(
+      "GET",
+      `/api/project/${projectId}/test-cases/${testCaseId}`
+    );
+    if (!response.data) {
+      throw new Error("Test case not found");
+    }
+    return response.data;
+  }
+  /**
+   * Create a new test case
+   * 
+   * @param projectId - The project ID
+   * @param data - Test case data
+   */
+  async create(projectId, data) {
+    const response = await this.request(
+      "POST",
+      `/api/project/${projectId}/test-cases`,
+      data
+    );
+    if (!response.data) {
+      throw new Error("Failed to create test case");
+    }
+    return response.data;
+  }
+  /**
+   * Update an existing test case
+   * 
+   * @param projectId - The project ID
+   * @param testCaseId - The test case ID (numeric UD)
+   * @param data - Test case update data
+   */
+  async update(projectId, testCaseId, data) {
+    const response = await this.request(
+      "PATCH",
+      `/api/project/${projectId}/test-cases/${testCaseId}`,
+      data
+    );
+    if (!response.data) {
+      throw new Error("Failed to update test case");
+    }
+    return response.data;
+  }
+  /**
+   * Delete a test case
+   * 
+   * @param projectId - The project ID
+   * @param testCaseId - The test case ID (numeric UD)
+   */
+  async delete(projectId, testCaseId) {
+    await this.request(
+      "DELETE",
+      `/api/project/${projectId}/test-cases/${testCaseId}`
+    );
+  }
+};
+export {
+  CodmirClient
+};

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "codmir",
+  "version": "0.1.0",
+  "description": "TypeScript SDK for codmir API - the AI that prevents wasted engineering time",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsup src/index.ts --format cjs,esm --dts --clean",
+    "dev": "tsup src/index.ts --format cjs,esm --dts --watch",
+    "prepublishOnly": "pnpm build",
+    "test": "jest"
+  },
+  "keywords": [
+    "codmir",
+    "api-client",
+    "typescript",
+    "sdk",
+    "developer-tools",
+    "project-management",
+    "test-automation"
+  ],
+  "author": "codmir",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/codmir/codmir.git",
+    "directory": "packages/codmir-client"
+  },
+  "bugs": {
+    "url": "https://github.com/codmir/codmir/issues"
+  },
+  "homepage": "https://codmir.com",
+  "devDependencies": {
+    "@types/node": "^20.10.0",
+    "tsup": "^8.0.1",
+    "typescript": "^5.8.3"
+  },
+  "dependencies": {},
+  "peerDependencies": {},
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}