@elobdev/zoho-projects-wrapper 0.0.0-stage → 0.1.2

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 (86) hide show
  1. package/README.md +72 -2
  2. package/dist/client.d.ts +35 -0
  3. package/dist/client.d.ts.map +1 -0
  4. package/dist/client.js +66 -0
  5. package/dist/client.js.map +1 -0
  6. package/dist/errors.d.ts +22 -0
  7. package/dist/errors.d.ts.map +1 -0
  8. package/dist/errors.js +42 -0
  9. package/dist/errors.js.map +1 -0
  10. package/dist/http.d.ts +14 -0
  11. package/dist/http.d.ts.map +1 -0
  12. package/dist/http.js +136 -0
  13. package/dist/http.js.map +1 -0
  14. package/dist/index.d.ts +20 -0
  15. package/dist/index.d.ts.map +1 -0
  16. package/dist/index.js +20 -0
  17. package/dist/index.js.map +1 -0
  18. package/dist/oauth.d.ts +20 -0
  19. package/dist/oauth.d.ts.map +1 -0
  20. package/dist/oauth.js +103 -0
  21. package/dist/oauth.js.map +1 -0
  22. package/dist/query.d.ts +5 -0
  23. package/dist/query.d.ts.map +1 -0
  24. package/dist/query.js +47 -0
  25. package/dist/query.js.map +1 -0
  26. package/dist/resource-base.d.ts +18 -0
  27. package/dist/resource-base.d.ts.map +1 -0
  28. package/dist/resource-base.js +46 -0
  29. package/dist/resource-base.js.map +1 -0
  30. package/dist/resources/custom-fields.d.ts +17 -0
  31. package/dist/resources/custom-fields.d.ts.map +1 -0
  32. package/dist/resources/custom-fields.js +11 -0
  33. package/dist/resources/custom-fields.js.map +1 -0
  34. package/dist/resources/issues.d.ts +67 -0
  35. package/dist/resources/issues.d.ts.map +1 -0
  36. package/dist/resources/issues.js +107 -0
  37. package/dist/resources/issues.js.map +1 -0
  38. package/dist/resources/module-meta.d.ts +2 -0
  39. package/dist/resources/module-meta.d.ts.map +1 -0
  40. package/dist/resources/module-meta.js +2 -0
  41. package/dist/resources/module-meta.js.map +1 -0
  42. package/dist/resources/phases.d.ts +46 -0
  43. package/dist/resources/phases.d.ts.map +1 -0
  44. package/dist/resources/phases.js +52 -0
  45. package/dist/resources/phases.js.map +1 -0
  46. package/dist/resources/portals.d.ts +15 -0
  47. package/dist/resources/portals.d.ts.map +1 -0
  48. package/dist/resources/portals.js +36 -0
  49. package/dist/resources/portals.js.map +1 -0
  50. package/dist/resources/project-groups.d.ts +18 -0
  51. package/dist/resources/project-groups.d.ts.map +1 -0
  52. package/dist/resources/project-groups.js +19 -0
  53. package/dist/resources/project-groups.js.map +1 -0
  54. package/dist/resources/projects.d.ts +33 -0
  55. package/dist/resources/projects.d.ts.map +1 -0
  56. package/dist/resources/projects.js +40 -0
  57. package/dist/resources/projects.js.map +1 -0
  58. package/dist/resources/records.d.ts +21 -0
  59. package/dist/resources/records.d.ts.map +1 -0
  60. package/dist/resources/records.js +31 -0
  61. package/dist/resources/records.js.map +1 -0
  62. package/dist/resources/settings.d.ts +46 -0
  63. package/dist/resources/settings.d.ts.map +1 -0
  64. package/dist/resources/settings.js +100 -0
  65. package/dist/resources/settings.js.map +1 -0
  66. package/dist/resources/tasklists.d.ts +38 -0
  67. package/dist/resources/tasklists.d.ts.map +1 -0
  68. package/dist/resources/tasklists.js +52 -0
  69. package/dist/resources/tasklists.js.map +1 -0
  70. package/dist/resources/tasks.d.ts +26 -0
  71. package/dist/resources/tasks.d.ts.map +1 -0
  72. package/dist/resources/tasks.js +34 -0
  73. package/dist/resources/tasks.js.map +1 -0
  74. package/dist/resources/time-logs.d.ts +56 -0
  75. package/dist/resources/time-logs.d.ts.map +1 -0
  76. package/dist/resources/time-logs.js +209 -0
  77. package/dist/resources/time-logs.js.map +1 -0
  78. package/dist/tools.d.ts +20 -0
  79. package/dist/tools.d.ts.map +1 -0
  80. package/dist/tools.js +652 -0
  81. package/dist/tools.js.map +1 -0
  82. package/dist/types.d.ts +532 -0
  83. package/dist/types.d.ts.map +1 -0
  84. package/dist/types.js +2 -0
  85. package/dist/types.js.map +1 -0
  86. package/package.json +41 -4
package/README.md CHANGED
@@ -1,3 +1,73 @@
1
- # Temporary Holding Version
1
+ # Zoho Projects Wrapper
2
2
 
3
- This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
3
+ TypeScript SDK for the Zoho Projects V3 API.
4
+
5
+ ## Features
6
+
7
+ - OAuth helper for auth URL generation, code exchange, refresh, and revoke
8
+ - Typed client namespaces for portals, projects, task lists, tasks, issues, custom fields, module metadata, and records
9
+ - OpenAI-compatible tool definitions and a dispatcher so a model can call the SDK through function calling
10
+ - Root exports for the resource classes, so you can import from the package entrypoint instead of deep paths
11
+ - Raw `request()` escape hatch for undocumented endpoints
12
+ - Zoho-style JSON query serialization and form-data support
13
+ - Typed API errors with status, request id, retryability, and raw response payload
14
+
15
+ ## Installation
16
+
17
+ ```bash
18
+ npm install @elobdev/zoho-projects-wrapper
19
+ ```
20
+
21
+ The package requires Node.js 22.6 or later.
22
+
23
+ ## Usage
24
+
25
+ Set the Zoho OAuth access token in the application that consumes this package. Do not put credentials in the package source:
26
+
27
+ ```env
28
+ ZOHO_ACCESS_TOKEN=your-access-token
29
+ ```
30
+
31
+ Then run your application with the environment file, for example `node --env-file=.env app.mjs`:
32
+
33
+ ```ts
34
+ import { ZohoProjectsClient } from '@elobdev/zoho-projects-wrapper';
35
+
36
+ const accessToken = process.env.ZOHO_ACCESS_TOKEN;
37
+
38
+ if (!accessToken) {
39
+ throw new Error('ZOHO_ACCESS_TOKEN is required');
40
+ }
41
+
42
+ const client = new ZohoProjectsClient({
43
+ accessToken,
44
+ });
45
+
46
+ const portals = await client.portals.listPortals();
47
+ ```
48
+
49
+ ### Tooling for model runtimes
50
+
51
+ ```ts
52
+ import { ZohoProjectsClient, executeZohoProjectsTool, zohoProjectsTools } from '@elobdev/zoho-projects-wrapper';
53
+
54
+ const client = new ZohoProjectsClient({
55
+ accessToken: process.env.ZOHO_ACCESS_TOKEN!,
56
+ });
57
+
58
+ // Pass `zohoProjectsTools` to your model/runtime as function tools.
59
+ // When the model picks one, call the dispatcher with the same name and payload.
60
+ const result = await executeZohoProjectsTool(client, 'zoho_projects_projects', {
61
+ action: 'list',
62
+ portal_id: 123456789,
63
+ query: { page: 1, per_page: 10 },
64
+ });
65
+ ```
66
+
67
+ ## Test
68
+
69
+ ```bash
70
+ npm test
71
+ ```
72
+
73
+ The tests use Node's built-in TypeScript stripping, so no extra toolchain is required for local verification.
@@ -0,0 +1,35 @@
1
+ import { ZohoHttpClient } from './http.js';
2
+ import { ZohoOAuthClient } from './oauth.js';
3
+ import { CustomFieldsResource } from './resources/custom-fields.js';
4
+ import { IssuesResource } from './resources/issues.js';
5
+ import { PhasesResource } from './resources/phases.js';
6
+ import { RecordsResource } from './resources/records.js';
7
+ import { PortalsResource } from './resources/portals.js';
8
+ import { ProjectsResource } from './resources/projects.js';
9
+ import { ProjectGroupsResource } from './resources/project-groups.js';
10
+ import { SettingsResource } from './resources/settings.js';
11
+ import { TimeLogsResource } from './resources/time-logs.js';
12
+ import { TasklistsResource } from './resources/tasklists.js';
13
+ import { TasksResource } from './resources/tasks.js';
14
+ import type { ZohoClientConfig } from './types.js';
15
+ export declare class ZohoProjectsClient {
16
+ private readonly config;
17
+ readonly oauth: ZohoOAuthClient;
18
+ readonly portals: PortalsResource;
19
+ readonly projects: ProjectsResource;
20
+ readonly projectGroups: ProjectGroupsResource;
21
+ readonly phases: PhasesResource;
22
+ readonly tasklists: TasklistsResource;
23
+ readonly tasks: TasksResource;
24
+ readonly issues: IssuesResource;
25
+ readonly customFields: CustomFieldsResource;
26
+ readonly settings: SettingsResource;
27
+ readonly moduleMeta: SettingsResource;
28
+ readonly records: RecordsResource;
29
+ readonly timeLogs: TimeLogsResource;
30
+ private http;
31
+ constructor(config?: ZohoClientConfig);
32
+ setAccessToken(accessToken: string): this;
33
+ request<T>(path: string, init?: Parameters<ZohoHttpClient['request']>[1]): Promise<T>;
34
+ }
35
+ //# sourceMappingURL=client.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAA2B,cAAc,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,oBAAoB,EAAE,MAAM,8BAA8B,CAAC;AACpE,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,+BAA+B,CAAC;AACtE,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmB;IAC1C,QAAQ,CAAC,KAAK,EAAE,eAAe,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,aAAa,EAAE,qBAAqB,CAAC;IAC9C,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,QAAQ,CAAC,YAAY,EAAE,oBAAoB,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,OAAO,CAAC,IAAI,CAAiB;gBAEjB,MAAM,GAAE,gBAAqB;IAkCzC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,IAAI;IAKnC,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,GAAE,UAAU,CAAC,cAAc,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAM,GAAG,OAAO,CAAC,CAAC,CAAC;CAGhG"}
package/dist/client.js ADDED
@@ -0,0 +1,66 @@
1
+ import { createDefaultHttpClient, ZohoHttpClient } from './http.js';
2
+ import { ZohoOAuthClient } from './oauth.js';
3
+ import { CustomFieldsResource } from './resources/custom-fields.js';
4
+ import { IssuesResource } from './resources/issues.js';
5
+ import { PhasesResource } from './resources/phases.js';
6
+ import { RecordsResource } from './resources/records.js';
7
+ import { PortalsResource } from './resources/portals.js';
8
+ import { ProjectsResource } from './resources/projects.js';
9
+ import { ProjectGroupsResource } from './resources/project-groups.js';
10
+ import { SettingsResource } from './resources/settings.js';
11
+ import { TimeLogsResource } from './resources/time-logs.js';
12
+ import { TasklistsResource } from './resources/tasklists.js';
13
+ import { TasksResource } from './resources/tasks.js';
14
+ export class ZohoProjectsClient {
15
+ config;
16
+ oauth;
17
+ portals;
18
+ projects;
19
+ projectGroups;
20
+ phases;
21
+ tasklists;
22
+ tasks;
23
+ issues;
24
+ customFields;
25
+ settings;
26
+ moduleMeta;
27
+ records;
28
+ timeLogs;
29
+ http;
30
+ constructor(config = {}) {
31
+ this.config = config;
32
+ this.http = createDefaultHttpClient({
33
+ fetchImpl: config.fetch ?? fetch,
34
+ ...(config.apiBaseUrl !== undefined ? { baseUrl: config.apiBaseUrl } : {}),
35
+ ...(config.accessToken !== undefined ? { accessToken: config.accessToken } : {}),
36
+ ...(config.userAgent !== undefined ? { userAgent: config.userAgent } : {}),
37
+ });
38
+ this.oauth = new ZohoOAuthClient({
39
+ clientId: config.clientId ?? '',
40
+ ...(config.clientSecret !== undefined ? { clientSecret: config.clientSecret } : {}),
41
+ ...(config.redirectUri !== undefined ? { redirectUri: config.redirectUri } : {}),
42
+ ...(config.accountsBaseUrl !== undefined ? { accountsBaseUrl: config.accountsBaseUrl } : {}),
43
+ ...(config.scope !== undefined ? { scope: config.scope } : {}),
44
+ }, config.fetch ?? fetch);
45
+ this.portals = new PortalsResource(this.http);
46
+ this.projects = new ProjectsResource(this.http);
47
+ this.projectGroups = new ProjectGroupsResource(this.http);
48
+ this.phases = new PhasesResource(this.http);
49
+ this.tasklists = new TasklistsResource(this.http);
50
+ this.tasks = new TasksResource(this.http);
51
+ this.issues = new IssuesResource(this.http);
52
+ this.customFields = new CustomFieldsResource(this.http);
53
+ this.settings = new SettingsResource(this.http);
54
+ this.moduleMeta = this.settings;
55
+ this.records = new RecordsResource(this.http);
56
+ this.timeLogs = new TimeLogsResource(this.http);
57
+ }
58
+ setAccessToken(accessToken) {
59
+ this.http = this.http.setAccessToken(accessToken);
60
+ return this;
61
+ }
62
+ async request(path, init = {}) {
63
+ return this.http.request(path, init);
64
+ }
65
+ }
66
+ //# sourceMappingURL=client.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,22 @@
1
+ import type { ZohoApiErrorInfo } from './types.js';
2
+ export declare class APIError extends Error {
3
+ readonly status: number;
4
+ readonly requestId?: string | undefined;
5
+ readonly retryable: boolean;
6
+ readonly responseBody: unknown;
7
+ constructor(message: string, info: ZohoApiErrorInfo);
8
+ }
9
+ export declare class ValidationError extends APIError {
10
+ }
11
+ export declare class AuthenticationError extends APIError {
12
+ }
13
+ export declare class ForbiddenError extends APIError {
14
+ }
15
+ export declare class NotFoundError extends APIError {
16
+ }
17
+ export declare class RateLimitError extends APIError {
18
+ }
19
+ export declare class ServerError extends APIError {
20
+ }
21
+ export declare function createApiError(message: string, info: ZohoApiErrorInfo): APIError;
22
+ //# sourceMappingURL=errors.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAEnD,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,SAAS,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;gBAEnB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB;CAQpD;AAED,qBAAa,eAAgB,SAAQ,QAAQ;CAAG;AAChD,qBAAa,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAC/C,qBAAa,aAAc,SAAQ,QAAQ;CAAG;AAC9C,qBAAa,cAAe,SAAQ,QAAQ;CAAG;AAC/C,qBAAa,WAAY,SAAQ,QAAQ;CAAG;AAE5C,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB,GAAG,QAAQ,CAQhF"}
package/dist/errors.js ADDED
@@ -0,0 +1,42 @@
1
+ export class APIError extends Error {
2
+ status;
3
+ requestId;
4
+ retryable;
5
+ responseBody;
6
+ constructor(message, info) {
7
+ super(message);
8
+ this.name = this.constructor.name;
9
+ this.status = info.status;
10
+ this.requestId = info.requestId;
11
+ this.retryable = info.retryable;
12
+ this.responseBody = info.responseBody;
13
+ }
14
+ }
15
+ export class ValidationError extends APIError {
16
+ }
17
+ export class AuthenticationError extends APIError {
18
+ }
19
+ export class ForbiddenError extends APIError {
20
+ }
21
+ export class NotFoundError extends APIError {
22
+ }
23
+ export class RateLimitError extends APIError {
24
+ }
25
+ export class ServerError extends APIError {
26
+ }
27
+ export function createApiError(message, info) {
28
+ if (info.status === 400)
29
+ return new ValidationError(message, info);
30
+ if (info.status === 401)
31
+ return new AuthenticationError(message, info);
32
+ if (info.status === 403)
33
+ return new ForbiddenError(message, info);
34
+ if (info.status === 404)
35
+ return new NotFoundError(message, info);
36
+ if (info.status === 429)
37
+ return new RateLimitError(message, info);
38
+ if (info.status >= 500)
39
+ return new ServerError(message, info);
40
+ return new APIError(message, info);
41
+ }
42
+ //# sourceMappingURL=errors.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,QAAS,SAAQ,KAAK;IACxB,MAAM,CAAS;IACf,SAAS,CAAsB;IAC/B,SAAS,CAAU;IACnB,YAAY,CAAU;IAE/B,YAAY,OAAe,EAAE,IAAsB;QACjD,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;QAChC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;CACF;AAED,MAAM,OAAO,eAAgB,SAAQ,QAAQ;CAAG;AAChD,MAAM,OAAO,mBAAoB,SAAQ,QAAQ;CAAG;AACpD,MAAM,OAAO,cAAe,SAAQ,QAAQ;CAAG;AAC/C,MAAM,OAAO,aAAc,SAAQ,QAAQ;CAAG;AAC9C,MAAM,OAAO,cAAe,SAAQ,QAAQ;CAAG;AAC/C,MAAM,OAAO,WAAY,SAAQ,QAAQ;CAAG;AAE5C,MAAM,UAAU,cAAc,CAAC,OAAe,EAAE,IAAsB;IACpE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACnE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,mBAAmB,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACvE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,aAAa,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjE,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG;QAAE,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAClE,IAAI,IAAI,CAAC,MAAM,IAAI,GAAG;QAAE,OAAO,IAAI,WAAW,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAC9D,OAAO,IAAI,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACrC,CAAC"}
package/dist/http.d.ts ADDED
@@ -0,0 +1,14 @@
1
+ import type { RequestContext, RequestOptions } from './types.js';
2
+ export declare class ZohoHttpClient {
3
+ private readonly context;
4
+ constructor(context: RequestContext);
5
+ setAccessToken(accessToken: string): ZohoHttpClient;
6
+ request<T>(path: string, options?: RequestOptions): Promise<T>;
7
+ }
8
+ export declare function createDefaultHttpClient(config: {
9
+ baseUrl?: string | undefined;
10
+ accessToken?: string | undefined;
11
+ userAgent?: string | undefined;
12
+ fetchImpl: typeof fetch;
13
+ }): ZohoHttpClient;
14
+ //# sourceMappingURL=http.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAoB,MAAM,YAAY,CAAC;AAsDnF,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,OAAO,EAAE,cAAc;IAInC,cAAc,CAAC,WAAW,EAAE,MAAM,GAAG,cAAc;IAI7C,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,CAAC,CAAC;CAkFzE;AAED,wBAAgB,uBAAuB,CACrC,MAAM,EAAE;IACN,OAAO,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,SAAS,EAAE,OAAO,KAAK,CAAC;CACzB,GACA,cAAc,CAOhB"}
package/dist/http.js ADDED
@@ -0,0 +1,136 @@
1
+ import { createApiError } from './errors.js';
2
+ import { serializeQuery } from './query.js';
3
+ const DEFAULT_API_BASE_URL = 'https://projectsapi.zoho.com/api/v3';
4
+ function joinPath(baseUrl, path) {
5
+ const normalizedBase = baseUrl.replace(/\/+$/, '');
6
+ const normalizedPath = path.replace(/^\/+/, '');
7
+ return `${normalizedBase}/${normalizedPath}`;
8
+ }
9
+ function extractRequestId(headers) {
10
+ return (headers.get('x-request-id') ??
11
+ headers.get('request-id') ??
12
+ headers.get('x-zohos-request-id') ??
13
+ headers.get('x-zoho-request-id') ??
14
+ undefined);
15
+ }
16
+ async function safeReadBody(response) {
17
+ const contentType = response.headers.get('content-type') ?? '';
18
+ if (response.status === 204)
19
+ return null;
20
+ const raw = await response.text();
21
+ if (!raw)
22
+ return null;
23
+ if (contentType.includes('application/json') || raw.startsWith('{') || raw.startsWith('[')) {
24
+ try {
25
+ return JSON.parse(raw);
26
+ }
27
+ catch {
28
+ return raw;
29
+ }
30
+ }
31
+ return raw;
32
+ }
33
+ function buildHeaders(context, headers, hasJsonBody = false) {
34
+ const out = new Headers(headers);
35
+ if (context.accessToken) {
36
+ out.set('Authorization', `Zoho-oauthtoken ${context.accessToken}`);
37
+ }
38
+ out.set('User-Agent', context.userAgent);
39
+ if (hasJsonBody && !out.has('Content-Type')) {
40
+ out.set('Content-Type', 'application/json');
41
+ }
42
+ return out;
43
+ }
44
+ function shouldRetryStatus(status) {
45
+ return status === 429 || status >= 500;
46
+ }
47
+ export class ZohoHttpClient {
48
+ context;
49
+ constructor(context) {
50
+ this.context = context;
51
+ }
52
+ setAccessToken(accessToken) {
53
+ return new ZohoHttpClient({ ...this.context, accessToken });
54
+ }
55
+ async request(path, options = {}) {
56
+ if (!this.context.accessToken && !(options.headers && new Headers(options.headers).has('Authorization'))) {
57
+ throw new Error('Zoho Projects access token is required for API requests');
58
+ }
59
+ const method = (options.method ?? 'GET').toUpperCase();
60
+ const retry = options.retry ?? 0;
61
+ const url = /^https?:\/\//i.test(path)
62
+ ? new URL(path)
63
+ : new URL(joinPath(this.context.baseUrl ?? DEFAULT_API_BASE_URL, path));
64
+ const queryString = serializeQuery(options.query);
65
+ if (queryString) {
66
+ url.search = queryString;
67
+ }
68
+ const hasJsonBody = options.body !== undefined && options.formData === undefined;
69
+ const headers = buildHeaders(this.context, options.headers, hasJsonBody);
70
+ let body;
71
+ if (options.formData) {
72
+ body = options.formData;
73
+ }
74
+ else if (options.body !== undefined) {
75
+ body = JSON.stringify(options.body);
76
+ }
77
+ let attempt = 0;
78
+ // Keep requests simple by only retrying when the caller opts in.
79
+ while (true) {
80
+ const init = {
81
+ method,
82
+ headers,
83
+ };
84
+ if (body !== undefined) {
85
+ init.body = body;
86
+ }
87
+ const response = await this.context.fetchImpl(url, init);
88
+ if (response.ok) {
89
+ if (response.status === 204) {
90
+ return undefined;
91
+ }
92
+ const contentType = response.headers.get('content-type') ?? '';
93
+ if (contentType.includes('application/json')) {
94
+ return (await response.json());
95
+ }
96
+ const text = await response.text();
97
+ if (!text)
98
+ return undefined;
99
+ try {
100
+ return JSON.parse(text);
101
+ }
102
+ catch {
103
+ return text;
104
+ }
105
+ }
106
+ const responseBody = await safeReadBody(response);
107
+ const requestId = extractRequestId(response.headers);
108
+ const message = (typeof responseBody === 'object' && responseBody !== null
109
+ ? responseBody.message ?? responseBody.error
110
+ : undefined) ??
111
+ response.statusText ??
112
+ `Zoho Projects request failed with status ${response.status}`;
113
+ const errorInfo = {
114
+ status: response.status,
115
+ retryable: shouldRetryStatus(response.status),
116
+ responseBody,
117
+ ...(requestId !== undefined ? { requestId } : {}),
118
+ };
119
+ const error = createApiError(message, errorInfo);
120
+ if (attempt < retry && error.retryable) {
121
+ attempt += 1;
122
+ continue;
123
+ }
124
+ throw error;
125
+ }
126
+ }
127
+ }
128
+ export function createDefaultHttpClient(config) {
129
+ return new ZohoHttpClient({
130
+ baseUrl: config.baseUrl ?? DEFAULT_API_BASE_URL,
131
+ accessToken: config.accessToken,
132
+ userAgent: config.userAgent ?? 'zoho-projects-wrapper/0.1.0',
133
+ fetchImpl: config.fetchImpl,
134
+ });
135
+ }
136
+ //# sourceMappingURL=http.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,20 @@
1
+ export * from './client.js';
2
+ export * from './errors.js';
3
+ export * from './http.js';
4
+ export * from './oauth.js';
5
+ export * from './query.js';
6
+ export * from './types.js';
7
+ export * from './resources/custom-fields.js';
8
+ export * from './resources/issues.js';
9
+ export * from './resources/module-meta.js';
10
+ export * from './resources/project-groups.js';
11
+ export * from './resources/portals.js';
12
+ export * from './resources/projects.js';
13
+ export * from './resources/phases.js';
14
+ export * from './resources/records.js';
15
+ export * from './resources/time-logs.js';
16
+ export * from './resources/tasklists.js';
17
+ export * from './resources/tasks.js';
18
+ export * from './resources/settings.js';
19
+ export * from './tools.js';
20
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}
package/dist/index.js ADDED
@@ -0,0 +1,20 @@
1
+ export * from './client.js';
2
+ export * from './errors.js';
3
+ export * from './http.js';
4
+ export * from './oauth.js';
5
+ export * from './query.js';
6
+ export * from './types.js';
7
+ export * from './resources/custom-fields.js';
8
+ export * from './resources/issues.js';
9
+ export * from './resources/module-meta.js';
10
+ export * from './resources/project-groups.js';
11
+ export * from './resources/portals.js';
12
+ export * from './resources/projects.js';
13
+ export * from './resources/phases.js';
14
+ export * from './resources/records.js';
15
+ export * from './resources/time-logs.js';
16
+ export * from './resources/tasklists.js';
17
+ export * from './resources/tasks.js';
18
+ export * from './resources/settings.js';
19
+ export * from './tools.js';
20
+ //# sourceMappingURL=index.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,aAAa,CAAC;AAC5B,cAAc,WAAW,CAAC;AAC1B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uBAAuB,CAAC;AACtC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,+BAA+B,CAAC;AAC9C,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,0BAA0B,CAAC;AACzC,cAAc,0BAA0B,CAAC;AACzC,cAAc,sBAAsB,CAAC;AACrC,cAAc,yBAAyB,CAAC;AACxC,cAAc,YAAY,CAAC"}
@@ -0,0 +1,20 @@
1
+ import type { ZohoOAuthConfig, ZohoOAuthTokens } from './types.js';
2
+ export declare class ZohoOAuthClient {
3
+ private readonly config;
4
+ private readonly fetchImpl;
5
+ constructor(config: ZohoOAuthConfig, fetchImpl?: typeof fetch);
6
+ authorizationUrl(overrides?: Partial<ZohoOAuthConfig>): string;
7
+ exchangeCode(params: {
8
+ code: string;
9
+ redirectUri?: string;
10
+ }): Promise<ZohoOAuthTokens>;
11
+ refreshAccessToken(params: {
12
+ refreshToken: string;
13
+ }): Promise<ZohoOAuthTokens>;
14
+ revokeToken(params: {
15
+ token: string;
16
+ }): Promise<{
17
+ status: string;
18
+ }>;
19
+ }
20
+ //# sourceMappingURL=oauth.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth.d.ts","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAwCnE,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAkB;IACzC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAe;gBAGvC,MAAM,EAAE,eAAe,EACvB,SAAS,GAAE,OAAO,KAAa;IAMjC,gBAAgB,CAAC,SAAS,GAAE,OAAO,CAAC,eAAe,CAAM,GAAG,MAAM;IAsB5D,YAAY,CAAC,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAiBtF,kBAAkB,CAAC,MAAM,EAAE;QAAE,YAAY,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,eAAe,CAAC;IAgB9E,WAAW,CAAC,MAAM,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAa1E"}
package/dist/oauth.js ADDED
@@ -0,0 +1,103 @@
1
+ function toScopeValue(scope) {
2
+ if (!scope)
3
+ return undefined;
4
+ return Array.isArray(scope) ? scope.join(',') : scope;
5
+ }
6
+ function buildAccountsUrl(baseUrl, path) {
7
+ const normalizedBase = (baseUrl ?? 'https://accounts.zoho.com').replace(/\/+$/, '');
8
+ return `${normalizedBase}${path.startsWith('/') ? path : `/${path}`}`;
9
+ }
10
+ function createQuery(params) {
11
+ const searchParams = new URLSearchParams();
12
+ for (const [key, value] of Object.entries(params)) {
13
+ if (value !== undefined && value !== '') {
14
+ searchParams.set(key, value);
15
+ }
16
+ }
17
+ return searchParams.toString();
18
+ }
19
+ async function postForm(fetchImpl, url, form) {
20
+ const body = new URLSearchParams(form);
21
+ const response = await fetchImpl(url, {
22
+ method: 'POST',
23
+ headers: {
24
+ 'Content-Type': 'application/x-www-form-urlencoded',
25
+ },
26
+ body,
27
+ });
28
+ const text = await response.text();
29
+ if (!response.ok) {
30
+ throw new Error(text || `OAuth request failed with status ${response.status}`);
31
+ }
32
+ return (text ? JSON.parse(text) : {});
33
+ }
34
+ export class ZohoOAuthClient {
35
+ config;
36
+ fetchImpl;
37
+ constructor(config, fetchImpl = fetch) {
38
+ this.config = config;
39
+ this.fetchImpl = fetchImpl;
40
+ }
41
+ authorizationUrl(overrides = {}) {
42
+ const merged = { ...this.config, ...overrides };
43
+ if (!merged.clientId) {
44
+ throw new Error('clientId is required to build the Zoho authorization URL');
45
+ }
46
+ const url = new URL(buildAccountsUrl(merged.accountsBaseUrl, '/oauth/v2/auth'));
47
+ const scope = toScopeValue(merged.scope);
48
+ const params = createQuery({
49
+ client_id: merged.clientId,
50
+ redirect_uri: merged.redirectUri,
51
+ response_type: 'code',
52
+ scope,
53
+ access_type: merged.accessType ?? 'offline',
54
+ prompt: merged.prompt,
55
+ state: merged.state,
56
+ });
57
+ url.search = params;
58
+ return url.toString();
59
+ }
60
+ async exchangeCode(params) {
61
+ if (!this.config.clientId) {
62
+ throw new Error('clientId is required to exchange an authorization code');
63
+ }
64
+ if (!this.config.clientSecret) {
65
+ throw new Error('clientSecret is required to exchange an authorization code');
66
+ }
67
+ const url = buildAccountsUrl(this.config.accountsBaseUrl, '/oauth/v2/token');
68
+ return postForm(this.fetchImpl, url, {
69
+ code: params.code,
70
+ client_id: this.config.clientId,
71
+ client_secret: this.config.clientSecret ?? '',
72
+ redirect_uri: params.redirectUri ?? this.config.redirectUri ?? '',
73
+ grant_type: 'authorization_code',
74
+ });
75
+ }
76
+ async refreshAccessToken(params) {
77
+ if (!this.config.clientId) {
78
+ throw new Error('clientId is required to refresh a Zoho access token');
79
+ }
80
+ if (!this.config.clientSecret) {
81
+ throw new Error('clientSecret is required to refresh a Zoho access token');
82
+ }
83
+ const url = buildAccountsUrl(this.config.accountsBaseUrl, '/oauth/v2/token');
84
+ return postForm(this.fetchImpl, url, {
85
+ refresh_token: params.refreshToken,
86
+ client_id: this.config.clientId,
87
+ client_secret: this.config.clientSecret ?? '',
88
+ grant_type: 'refresh_token',
89
+ });
90
+ }
91
+ async revokeToken(params) {
92
+ const url = `${buildAccountsUrl(this.config.accountsBaseUrl, '/oauth/v2/token/revoke')}?${createQuery({
93
+ token: params.token,
94
+ })}`;
95
+ const response = await this.fetchImpl(url, { method: 'POST' });
96
+ const text = await response.text();
97
+ if (!response.ok) {
98
+ throw new Error(text || `Token revoke failed with status ${response.status}`);
99
+ }
100
+ return (text ? JSON.parse(text) : { status: 'success' });
101
+ }
102
+ }
103
+ //# sourceMappingURL=oauth.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"oauth.js","sourceRoot":"","sources":["../src/oauth.ts"],"names":[],"mappings":"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"}
@@ -0,0 +1,5 @@
1
+ import type { ZohoFilter } from './types.js';
2
+ export declare function serializeQuery(query?: Record<string, unknown>): string;
3
+ export declare function normalizeFilter(filter?: ZohoFilter): Record<string, unknown> | undefined;
4
+ export declare function mergeQuery(query?: Record<string, unknown>, filter?: ZohoFilter): Record<string, unknown> | undefined;
5
+ //# sourceMappingURL=query.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../src/query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAc7C,wBAAgB,cAAc,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAsBtE;AAED,wBAAgB,eAAe,CAAC,MAAM,CAAC,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAGxF;AAED,wBAAgB,UAAU,CACxB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/B,MAAM,CAAC,EAAE,UAAU,GAClB,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,CAIrC"}