@panoptic-it-solutions/zoho-projects-client 0.1.4 → 0.2.0

package/dist/__tests__/unit/client/tasks.test.js

@@ -0,0 +1,157 @@
+/**
+ * Unit tests for tasks API
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { http, HttpResponse } from "msw";
+import { server } from "../../mocks/server.js";
+import { createZohoProjectsClient } from "../../../client.js";
+import { createTaskFixture, createTaskListFixture, createTaskListResponse, } from "../../fixtures/tasks.js";
+const TEST_PORTAL_ID = "12345";
+const TEST_PROJECT_ID = "proj-1";
+const BASE_URL = `https://projectsapi.zoho.com/restapi/portal/${TEST_PORTAL_ID}`;
+describe("tasks", () => {
+    let client;
+    beforeEach(() => {
+        client = createZohoProjectsClient({
+            clientId: "test-client-id",
+            clientSecret: "test-client-secret",
+            refreshToken: "test-refresh-token",
+            portalId: TEST_PORTAL_ID,
+        });
+    });
+    describe("list", () => {
+        it("should list tasks for a project", async () => {
+            const mockTasks = createTaskListFixture(3);
+            server.use(http.get(`${BASE_URL}/projects/:projectId/tasks/`, () => {
+                return HttpResponse.json(createTaskListResponse(mockTasks));
+            }));
+            const result = await client.tasks.list(TEST_PROJECT_ID);
+            expect(result.data).toHaveLength(3);
+            expect(result.data[0]).toMatchObject({
+                id: expect.any(Number),
+                id_string: expect.any(String),
+                name: expect.any(String),
+            });
+        });
+        it("should pass pagination and sort parameters", async () => {
+            let capturedParams;
+            server.use(http.get(`${BASE_URL}/projects/:projectId/tasks/`, ({ request }) => {
+                capturedParams = new URL(request.url).searchParams;
+                return HttpResponse.json(createTaskListResponse([]));
+            }));
+            await client.tasks.list(TEST_PROJECT_ID, {
+                index: 20,
+                range: 50,
+                sort_column: "name",
+                sort_order: "ascending",
+            });
+            expect(capturedParams?.get("index")).toBe("20");
+            expect(capturedParams?.get("range")).toBe("50");
+            expect(capturedParams?.get("sort_column")).toBe("name");
+            expect(capturedParams?.get("sort_order")).toBe("ascending");
+        });
+    });
+    describe("get", () => {
+        it("should get a single task by ID", async () => {
+            const mockTask = createTaskFixture({ id: 456, id_string: "456" });
+            server.use(http.get(`${BASE_URL}/projects/:projectId/tasks/:taskId/`, () => {
+                return HttpResponse.json({ tasks: [mockTask] });
+            }));
+            const result = await client.tasks.get(TEST_PROJECT_ID, "456");
+            expect(result.id_string).toBe("456");
+            expect(result.name).toBeDefined();
+        });
+        it("should throw error when task not found", async () => {
+            server.use(http.get(`${BASE_URL}/projects/:projectId/tasks/:taskId/`, () => {
+                return HttpResponse.json({ tasks: [] });
+            }));
+            await expect(client.tasks.get(TEST_PROJECT_ID, "999")).rejects.toThrow("Task not found: 999");
+        });
+    });
+    describe("listAll", () => {
+        it("should auto-paginate through all tasks", async () => {
+            const page1 = createTaskListFixture(100);
+            const page2 = createTaskListFixture(50);
+            let requestCount = 0;
+            server.use(http.get(`${BASE_URL}/projects/:projectId/tasks/`, ({ request }) => {
+                requestCount++;
+                const url = new URL(request.url);
+                const index = parseInt(url.searchParams.get("index") || "0");
+                if (index === 0) {
+                    return HttpResponse.json(createTaskListResponse(page1, true));
+                }
+                else {
+                    return HttpResponse.json(createTaskListResponse(page2, false));
+                }
+            }));
+            const result = await client.tasks.listAll(TEST_PROJECT_ID);
+            expect(requestCount).toBe(2);
+            expect(result).toHaveLength(150);
+        });
+    });
+    describe("iterate", () => {
+        it("should yield tasks one at a time", async () => {
+            const mockTasks = createTaskListFixture(3);
+            server.use(http.get(`${BASE_URL}/projects/:projectId/tasks/`, () => {
+                return HttpResponse.json(createTaskListResponse(mockTasks));
+            }));
+            const results = [];
+            for await (const task of client.tasks.iterate(TEST_PROJECT_ID)) {
+                results.push(task);
+            }
+            expect(results).toHaveLength(3);
+        });
+    });
+    describe("create", () => {
+        it("should create a task with required fields", async () => {
+            const newTask = createTaskFixture({ name: "New Task" });
+            let capturedBody;
+            server.use(http.post(`${BASE_URL}/projects/:projectId/tasks/`, async ({ request }) => {
+                capturedBody = await request.json();
+                return HttpResponse.json({ tasks: [newTask] });
+            }));
+            const result = await client.tasks.create(TEST_PROJECT_ID, { name: "New Task" });
+            expect(capturedBody).toMatchObject({ name: "New Task" });
+            expect(result.name).toBe("New Task");
+        });
+        it("should create a task with optional fields", async () => {
+            const newTask = createTaskFixture({ name: "Full Task" });
+            server.use(http.post(`${BASE_URL}/projects/:projectId/tasks/`, () => {
+                return HttpResponse.json({ tasks: [newTask] });
+            }));
+            const result = await client.tasks.create(TEST_PROJECT_ID, {
+                name: "Full Task",
+                description: "A detailed task",
+                priority: "High",
+                start_date: "01-01-2025",
+                end_date: "01-15-2025",
+            });
+            expect(result.name).toBe("Full Task");
+        });
+    });
+    describe("update", () => {
+        it("should update a task", async () => {
+            const updatedTask = createTaskFixture({
+                id: 456,
+                id_string: "456",
+                name: "Updated Task",
+            });
+            server.use(http.put(`${BASE_URL}/projects/:projectId/tasks/:taskId/`, () => {
+                return HttpResponse.json({ tasks: [updatedTask] });
+            }));
+            const result = await client.tasks.update(TEST_PROJECT_ID, "456", {
+                name: "Updated Task",
+            });
+            expect(result.name).toBe("Updated Task");
+        });
+    });
+    describe("delete", () => {
+        it("should delete a task", async () => {
+            server.use(http.delete(`${BASE_URL}/projects/:projectId/tasks/:taskId/`, () => {
+                return new HttpResponse(null, { status: 204 });
+            }));
+            await expect(client.tasks.delete(TEST_PROJECT_ID, "456")).resolves.toBeUndefined();
+        });
+    });
+});
+//# sourceMappingURL=tasks.test.js.map

package/dist/__tests__/unit/client/tasks.test.js.map

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

package/dist/__tests__/unit/client/timers.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=timers.test.d.ts.map

package/dist/__tests__/unit/client/timers.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"timers.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/unit/client/timers.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/client/timers.test.js

@@ -0,0 +1,122 @@
+/**
+ * Unit tests for timers API
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { http, HttpResponse } from "msw";
+import { server } from "../../mocks/server.js";
+import { createZohoProjectsClient } from "../../../client.js";
+import { mockTimer, mockTimers, mockPausedTimer } from "../../fixtures/timers.js";
+const TEST_PORTAL_ID = "12345";
+const BASE_URL = `https://projectsapi.zoho.com/restapi/portal/${TEST_PORTAL_ID}`;
+describe("timers", () => {
+    let client;
+    beforeEach(() => {
+        client = createZohoProjectsClient({
+            clientId: "test-client-id",
+            clientSecret: "test-client-secret",
+            refreshToken: "test-refresh-token",
+            portalId: TEST_PORTAL_ID,
+        });
+    });
+    describe("list", () => {
+        it("should list all running timers", async () => {
+            server.use(http.get(`${BASE_URL}/mytimers/`, () => {
+                return HttpResponse.json({ timers: mockTimers });
+            }));
+            const result = await client.timers.list();
+            expect(result).toHaveLength(2);
+            expect(result[0]).toMatchObject({
+                id: expect.any(String),
+                status: expect.any(String),
+            });
+        });
+        it("should return empty array when no timers", async () => {
+            server.use(http.get(`${BASE_URL}/mytimers/`, () => {
+                return new HttpResponse("", { status: 204 });
+            }));
+            const result = await client.timers.list();
+            expect(result).toHaveLength(0);
+        });
+    });
+    describe("getCurrent", () => {
+        it("should get the current running timer", async () => {
+            server.use(http.get(`${BASE_URL}/mytimers/`, () => {
+                return HttpResponse.json({ timers: [mockTimer] });
+            }));
+            const result = await client.timers.getCurrent();
+            expect(result).not.toBeNull();
+            expect(result?.status).toBe("running");
+        });
+        it("should return null when no timer is running", async () => {
+            server.use(http.get(`${BASE_URL}/mytimers/`, () => {
+                return new HttpResponse("", { status: 204 });
+            }));
+            const result = await client.timers.getCurrent();
+            expect(result).toBeNull();
+        });
+    });
+    describe("start", () => {
+        it("should start a timer for a task", async () => {
+            server.use(http.post(`${BASE_URL}/projects/proj_001/tasks/task_123/timer/start/`, () => {
+                return HttpResponse.json({ timer: mockTimer });
+            }));
+            const result = await client.timers.start({
+                entity_id: "task_123",
+                type: "Task",
+                project_id: "proj_001",
+            });
+            expect(result.status).toBe("running");
+        });
+    });
+    describe("stop", () => {
+        it("should stop the current timer", async () => {
+            const stoppedTimer = { ...mockTimer, status: "stopped" };
+            server.use(http.post(`${BASE_URL}/mytimers/stop/`, () => {
+                return HttpResponse.json({ timer: stoppedTimer });
+            }));
+            const result = await client.timers.stop({});
+            expect(result.status).toBe("stopped");
+        });
+    });
+    describe("pause", () => {
+        it("should pause the current timer", async () => {
+            server.use(http.post(`${BASE_URL}/mytimers/pause/`, () => {
+                return HttpResponse.json({ timer: mockPausedTimer });
+            }));
+            const result = await client.timers.pause();
+            expect(result.status).toBe("paused");
+        });
+    });
+    describe("resume", () => {
+        it("should resume a paused timer", async () => {
+            server.use(http.post(`${BASE_URL}/mytimers/resume/`, () => {
+                return HttpResponse.json({ timer: mockTimer });
+            }));
+            const result = await client.timers.resume();
+            expect(result.status).toBe("running");
+        });
+    });
+    describe("startForTask", () => {
+        it("should start a timer for a specific task", async () => {
+            server.use(http.post(`${BASE_URL}/projects/proj_001/tasks/task_123/timer/start/`, () => {
+                return HttpResponse.json({ timer: mockTimer });
+            }));
+            const result = await client.timers.startForTask("proj_001", "task_123", {
+                notes: "Starting work",
+                bill_status: "billable",
+            });
+            expect(result).toBeDefined();
+        });
+    });
+    describe("startForIssue", () => {
+        it("should start a timer for a specific issue", async () => {
+            const issueTimer = { ...mockTimer, entity_type: "issue" };
+            server.use(http.post(`${BASE_URL}/projects/proj_001/issues/issue_123/timer/start/`, () => {
+                return HttpResponse.json({ timer: issueTimer });
+            }));
+            const result = await client.timers.startForIssue("proj_001", "issue_123");
+            expect(result).toBeDefined();
+        });
+    });
+});
+//# sourceMappingURL=timers.test.js.map

package/dist/__tests__/unit/client/timers.test.js.map

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

package/dist/__tests__/unit/client/users.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=users.test.d.ts.map

package/dist/__tests__/unit/client/users.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.test.d.ts","sourceRoot":"","sources":["../../../../src/__tests__/unit/client/users.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/unit/client/users.test.js

@@ -0,0 +1,89 @@
+/**
+ * Unit tests for users API
+ */
+import { describe, it, expect, beforeEach } from "vitest";
+import { http, HttpResponse } from "msw";
+import { server } from "../../mocks/server.js";
+import { createZohoProjectsClient } from "../../../client.js";
+import { createUserFixture, createUserListFixture, createUserListResponse, } from "../../fixtures/users.js";
+const TEST_PORTAL_ID = "12345";
+const BASE_URL = `https://projectsapi.zoho.com/restapi/portal/${TEST_PORTAL_ID}`;
+describe("users", () => {
+    let client;
+    beforeEach(() => {
+        client = createZohoProjectsClient({
+            clientId: "test-client-id",
+            clientSecret: "test-client-secret",
+            refreshToken: "test-refresh-token",
+            portalId: TEST_PORTAL_ID,
+        });
+    });
+    describe("list", () => {
+        it("should list users with default pagination", async () => {
+            const mockUsers = createUserListFixture(3);
+            server.use(http.get(`${BASE_URL}/users/`, () => {
+                return HttpResponse.json(createUserListResponse(mockUsers));
+            }));
+            const result = await client.users.list();
+            expect(result.data).toHaveLength(3);
+            expect(result.data[0]).toMatchObject({
+                id: expect.any(String),
+                name: expect.any(String),
+                email: expect.any(String),
+            });
+        });
+        it("should handle empty response", async () => {
+            server.use(http.get(`${BASE_URL}/users/`, () => {
+                return HttpResponse.json(createUserListResponse([]));
+            }));
+            const result = await client.users.list();
+            expect(result.data).toHaveLength(0);
+        });
+    });
+    describe("get", () => {
+        it("should get a single user by ID", async () => {
+            const mockUser = createUserFixture({ id: "123" });
+            server.use(http.get(`${BASE_URL}/users/123/`, () => {
+                return HttpResponse.json({ users: [mockUser] });
+            }));
+            const result = await client.users.get("123");
+            expect(result.id).toBe("123");
+            expect(result.name).toBeDefined();
+        });
+    });
+    describe("listAll", () => {
+        it("should auto-paginate through all users", async () => {
+            const page1 = createUserListFixture(100);
+            const page2 = createUserListFixture(50);
+            let requestCount = 0;
+            server.use(http.get(`${BASE_URL}/users/`, ({ request }) => {
+                requestCount++;
+                const url = new URL(request.url);
+                const index = parseInt(url.searchParams.get("index") || "0");
+                if (index === 0) {
+                    return HttpResponse.json(createUserListResponse(page1, true));
+                }
+                else {
+                    return HttpResponse.json(createUserListResponse(page2, false));
+                }
+            }));
+            const result = await client.users.listAll();
+            expect(requestCount).toBe(2);
+            expect(result).toHaveLength(150);
+        });
+    });
+    describe("iterate", () => {
+        it("should yield users one at a time", async () => {
+            const mockUsers = createUserListFixture(3);
+            server.use(http.get(`${BASE_URL}/users/`, () => {
+                return HttpResponse.json(createUserListResponse(mockUsers));
+            }));
+            const results = [];
+            for await (const user of client.users.iterate()) {
+                results.push(user);
+            }
+            expect(results).toHaveLength(3);
+        });
+    });
+});
+//# sourceMappingURL=users.test.js.map

package/dist/__tests__/unit/client/users.test.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=init.d.ts.map

package/dist/cli/init.d.ts.map

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

package/dist/cli/init.js

@@ -0,0 +1,130 @@
+#!/usr/bin/env node
+import { execSync } from "child_process";
+import fs from "fs/promises";
+import path from "path";
+import { fileURLToPath } from "url";
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+async function fileExists(filePath) {
+    try {
+        await fs.access(filePath);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function init(options) {
+    const projectRoot = process.cwd();
+    const templatesDir = path.join(__dirname, "..", "..", "templates");
+    console.log("Initializing Zoho Projects Client...\n");
+    // 1. Install the package (unless skipped)
+    if (!options.skipInstall) {
+        console.log("Installing @panoptic-it-solutions/zoho-projects-client...");
+        try {
+            execSync("npm install @panoptic-it-solutions/zoho-projects-client", {
+                cwd: projectRoot,
+                stdio: "inherit",
+            });
+            console.log("");
+        }
+        catch (error) {
+            console.error("Failed to install package. You can install manually with:");
+            console.error("  npm install @panoptic-it-solutions/zoho-projects-client\n");
+        }
+    }
+    // 2. Create .claude/commands/
+    const commandsDir = path.join(projectRoot, ".claude", "commands");
+    const templateCommandsDir = path.join(templatesDir, "commands");
+    try {
+        await fs.mkdir(commandsDir, { recursive: true });
+        await fs.cp(templateCommandsDir, commandsDir, { recursive: true });
+        console.log("Created .claude/commands/ with slash commands");
+    }
+    catch (error) {
+        console.error("Failed to create .claude/commands/:", error);
+    }
+    // 3. Create CLAUDE.md (if it doesn't exist)
+    const claudeMdPath = path.join(projectRoot, "CLAUDE.md");
+    const templateClaudeMd = path.join(templatesDir, "CLAUDE.md");
+    if (await fileExists(claudeMdPath)) {
+        console.log("CLAUDE.md already exists, skipping");
+    }
+    else {
+        try {
+            await fs.copyFile(templateClaudeMd, claudeMdPath);
+            console.log("Created CLAUDE.md");
+        }
+        catch (error) {
+            console.error("Failed to create CLAUDE.md:", error);
+        }
+    }
+    // 4. Optionally copy types
+    if (options.withTypes) {
+        const typesDir = path.join(projectRoot, ".ai-types");
+        const templateTypesDir = path.join(templatesDir, "types");
+        try {
+            await fs.mkdir(typesDir, { recursive: true });
+            await fs.cp(templateTypesDir, typesDir, { recursive: true });
+            console.log("Copied type definitions to .ai-types/");
+        }
+        catch (error) {
+            console.error("Failed to copy type definitions:", error);
+        }
+    }
+    console.log("\nSetup complete!\n");
+    console.log("Available slash commands in Claude Code:");
+    console.log("  /zoho-projects  - Full API reference");
+    console.log("  /zoho-auth      - OAuth 2.0 setup guide");
+    console.log("  /zoho-examples  - Common usage patterns\n");
+    console.log("Next steps:");
+    console.log("  1. Set up your environment variables (see /zoho-auth)");
+    console.log("  2. Import and use the client in your code");
+    console.log("");
+}
+function printHelp() {
+    console.log(`
+Zoho Projects Client - AI Agent Setup
+
+Usage:
+  npx @panoptic-it-solutions/zoho-projects-client init [options]
+
+Commands:
+  init          Initialize project with Claude Code configuration
+
+Options:
+  --with-types    Copy type definitions to .ai-types/ for enhanced AI visibility
+  --skip-install  Skip npm install of the package (if already installed)
+  --help, -h      Show this help message
+
+Examples:
+  npx @panoptic-it-solutions/zoho-projects-client init
+  npx @panoptic-it-solutions/zoho-projects-client init --with-types
+  npx @panoptic-it-solutions/zoho-projects-client init --skip-install
+`);
+}
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.includes("--help") || args.includes("-h")) {
+        printHelp();
+        process.exit(0);
+    }
+    const command = args[0];
+    if (command !== "init") {
+        if (command) {
+            console.error(`Unknown command: ${command}\n`);
+        }
+        printHelp();
+        process.exit(command ? 1 : 0);
+    }
+    const options = {
+        withTypes: args.includes("--with-types"),
+        skipInstall: args.includes("--skip-install"),
+    };
+    await init(options);
+}
+main().catch((error) => {
+    console.error("Error:", error.message);
+    process.exit(1);
+});
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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