@panoptic-it-solutions/zoho-projects-client 0.2.5 → 0.2.6

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +24 -0
  2. package/package.json +1 -1
package/README.md CHANGED
@@ -479,6 +479,30 @@ ZOHO_API_URL=https://projectsapi.zoho.com
479
479
  ZOHO_ACCOUNTS_URL=https://accounts.zoho.com
480
480
  ```
481
481
 
482
+ ## Changelog
483
+
484
+ ### 1.1.0 (2026-01-13)
485
+
486
+ #### V3 API Response Format Fixes
487
+ - **Fixed count field type coercion**: Changed all count fields (`open`, `closed`, `*_count`, `page`, `per_page`, `total_count`) to use `z.coerce.number()` to handle Zoho API returning counts as strings (e.g., `"0"` instead of `0`)
488
+ - **Fixed V3 response parsing**: V3 API returns data as direct arrays, not wrapped in objects like `{ projects: [...] }`. Updated parsing logic throughout.
489
+
490
+ #### File Attachments
491
+ - **Added file attachment workflow documentation**: Complete guide for attaching files to tasks using WorkDrive integration
492
+ - **Method 1 (Recommended)**: Direct upload via legacy `/restapi/` endpoint with `uploaddoc` form field - single request handles both upload and association
493
+ - **Method 2 (Advanced)**: Manual WorkDrive upload with separate registration step for more control
494
+ - **Added OAuth scopes for attachments**: `ZohoPC.files.ALL`, `WorkDrive.team.ALL`, `WorkDrive.workspace.ALL`, `WorkDrive.files.ALL`, `WorkDrive.teamfolders.ALL`
495
+
496
+ #### Helper Scripts
497
+ - **`scripts/get-refresh-token.ts`**: OAuth helper that opens browser, catches callback, and outputs refresh token with all required scopes
498
+ - **`scripts/delete-test-project.ts`**: Delete projects using V3 API (`POST /projects/{id}/trash`)
499
+ - **`scripts/test-workdrive-upload.ts`**: Test WorkDrive upload and task attachment workflow
500
+
501
+ #### V3 API Discoveries
502
+ - **Project delete**: V3 uses `POST /api/v3/portal/{portalId}/projects/{projectId}/trash` (not `DELETE`)
503
+ - **Attachments**: V3 returns `{ attachment: [...] }` (singular key), not `{ attachments: [...] }`
504
+ - **Projects list**: V3 returns direct array, not wrapped in `{ projects: [...] }`
505
+
482
506
  ## License
483
507
 
484
508
  MIT
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@panoptic-it-solutions/zoho-projects-client",
3
- "version": "0.2.5",
3
+ "version": "0.2.6",
4
4
  "description": "TypeScript client for Zoho Projects V3 API with OAuth 2.0 and rate limiting",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",