@doist/todoist-sdk 9.2.0 → 9.4.0

package/dist/cjs/types/webhooks/tasks.js

@@ -0,0 +1,68 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TaskDeletedPayloadSchema = exports.TaskUncompletedPayloadSchema = exports.TaskCompletedPayloadSchema = exports.TaskUpdatedPayloadSchema = exports.TaskAddedPayloadSchema = exports.TaskUpdatedExtraSchema = exports.UpdateIntentSchema = exports.UPDATE_INTENTS = exports.TASK_WEBHOOK_EVENTS = exports.TaskWebhookEventEnum = void 0;
+const zod_1 = require("zod");
+const types_1 = require("../tasks/types");
+const envelope_1 = require("./envelope");
+/**
+ * Enum-like object of task (`item:*`) webhook event names. Single source of
+ * truth for the discriminator values — `TASK_WEBHOOK_EVENTS` and every
+ * `z.literal()` below derive from it.
+ */
+exports.TaskWebhookEventEnum = {
+    Added: 'item:added',
+    Updated: 'item:updated',
+    Completed: 'item:completed',
+    Uncompleted: 'item:uncompleted',
+    Deleted: 'item:deleted',
+};
+/**
+ * Webhook events that carry a {@link Task} as their `eventData`.
+ *
+ * The on-the-wire event names remain `item:*` for historical reasons; the
+ * SDK types call them `Task*` to match the rest of the public API where the
+ * resource is named `Task`.
+ */
+exports.TASK_WEBHOOK_EVENTS = [
+    exports.TaskWebhookEventEnum.Added,
+    exports.TaskWebhookEventEnum.Updated,
+    exports.TaskWebhookEventEnum.Completed,
+    exports.TaskWebhookEventEnum.Uncompleted,
+    exports.TaskWebhookEventEnum.Deleted,
+];
+/**
+ * Possible values for the `updateIntent` field on `item:updated`'s
+ * `eventDataExtra`. `item_updated` is the default; the others narrow the
+ * reason for the update (for example, a recurring completion or a change of
+ * assignee).
+ *
+ * @see https://developer.todoist.com/sync/v1/#webhooks (Events Extra)
+ */
+exports.UPDATE_INTENTS = [
+    'item_updated',
+    'item_completed',
+    'item_uncompleted',
+    'responsible_uid_changed',
+];
+/**
+ * An unrecognised value from a future backend release degrades gracefully to
+ * `'item_updated'` rather than crashing the whole payload parse.
+ */
+exports.UpdateIntentSchema = zod_1.z.enum(exports.UPDATE_INTENTS).catch('item_updated');
+/**
+ * Extra info delivered alongside an `item:updated` event when the initiator
+ * is the acting user. Contains the pre-update task state plus the reason for
+ * the update — useful for diffing or for distinguishing manual edits from
+ * recurring-task completions.
+ *
+ * @see https://developer.todoist.com/sync/v1/#webhooks (Events Extra)
+ */
+exports.TaskUpdatedExtraSchema = zod_1.z.object({
+    oldItem: types_1.TaskSchema,
+    updateIntent: exports.UpdateIntentSchema,
+});
+exports.TaskAddedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.TaskWebhookEventEnum.Added), eventData: types_1.TaskSchema }));
+exports.TaskUpdatedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.TaskWebhookEventEnum.Updated), eventData: types_1.TaskSchema, eventDataExtra: exports.TaskUpdatedExtraSchema.optional() }));
+exports.TaskCompletedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.TaskWebhookEventEnum.Completed), eventData: types_1.TaskSchema }));
+exports.TaskUncompletedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.TaskWebhookEventEnum.Uncompleted), eventData: types_1.TaskSchema }));
+exports.TaskDeletedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.TaskWebhookEventEnum.Deleted), eventData: types_1.TaskSchema }));

package/dist/cjs/types/webhooks/types.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WebhookEventSchema = exports.WebhookPayloadSchema = exports.UntypedWebhookPayloadSchema = void 0;
+const zod_1 = require("zod");
+const types_1 = require("../apps/types");
+Object.defineProperty(exports, "WebhookEventSchema", { enumerable: true, get: function () { return types_1.WebhookEventSchema; } });
+const envelope_1 = require("./envelope");
+const tasks_1 = require("./tasks");
+const untypedEventNames = types_1.WEBHOOK_EVENTS.filter((event) => !tasks_1.TASK_WEBHOOK_EVENTS.includes(event));
+/**
+ * A single branch covering every event whose payload has not yet been typed
+ * per resource. Follow-up PRs will replace slices of this with dedicated
+ * variants (notes, projects, sections, labels, filters, reminders).
+ */
+exports.UntypedWebhookPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.enum(untypedEventNames), eventData: zod_1.z.unknown(), eventDataExtra: zod_1.z.unknown().optional() }));
+/**
+ * Wrapper schema for an incoming webhook payload.
+ *
+ * The backend sends snake_case keys and uses the public event form
+ * (`item:added`) in the `event_name` field, so consumers using
+ * `parseWebhookPayload` receive camelCase fields directly.
+ *
+ * Typed today: `item:*` events carry a parsed {@link Task}. Other events
+ * still expose `eventData` as `unknown`; they will be narrowed in follow-up
+ * PRs (notes, projects, sections, labels, filters, reminders).
+ */
+exports.WebhookPayloadSchema = zod_1.z.discriminatedUnion('eventName', [
+    tasks_1.TaskAddedPayloadSchema,
+    tasks_1.TaskUpdatedPayloadSchema,
+    tasks_1.TaskCompletedPayloadSchema,
+    tasks_1.TaskUncompletedPayloadSchema,
+    tasks_1.TaskDeletedPayloadSchema,
+    exports.UntypedWebhookPayloadSchema,
+]);

package/dist/cjs/utils/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.createCommand = exports.getSectionUrl = exports.getProjectUrl = exports.getTaskUrl = void 0;
+exports.verifyWebhookSignature = exports.parseWebhookPayload = exports.createCommand = exports.getSectionUrl = exports.getProjectUrl = exports.getTaskUrl = void 0;
 __exportStar(require("./colors"), exports);
 __exportStar(require("./sanitization"), exports);
 var url_helpers_1 = require("./url-helpers");
@@ -24,3 +24,6 @@ Object.defineProperty(exports, "getSectionUrl", { enumerable: true, get: functio
 var sync_helpers_1 = require("./sync-helpers");
 Object.defineProperty(exports, "createCommand", { enumerable: true, get: function () { return sync_helpers_1.createCommand; } });
 __exportStar(require("./project-helpers"), exports);
+var webhook_parser_1 = require("./webhook-parser");
+Object.defineProperty(exports, "parseWebhookPayload", { enumerable: true, get: function () { return webhook_parser_1.parseWebhookPayload; } });
+Object.defineProperty(exports, "verifyWebhookSignature", { enumerable: true, get: function () { return webhook_parser_1.verifyWebhookSignature; } });

package/dist/cjs/utils/validators.js

@@ -1,8 +1,8 @@
 "use strict";
 var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6, _7, _8, _9, _10, _11, _12;
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.validateFolderArray = exports.validateFolder = exports.validateCollaboratorStateArray = exports.validateCollaboratorState = exports.validateCollaboratorArray = exports.validateCollaborator = exports.validateFilterArray = exports.validateFilter = exports.validateMovedIdArray = exports.validateMovedId = exports.validateIdMappingArray = exports.validateIdMapping = exports.validateBackupArray = exports.validateBackup = exports.validateWorkspaceInsights = exports.validateProjectProgress = exports.validateProjectHealthContext = exports.validateProjectHealth = exports.validateProjectActivityStats = exports.validateWorkspaceUserTaskArray = exports.validateWorkspaceUserTask = exports.validateMemberActivityInfoArray = exports.validateMemberActivityInfo = exports.validateWorkspaceArray = exports.validateWorkspace = exports.validateJoinWorkspaceResult = exports.validateWorkspacePlanDetails = exports.validateWorkspaceInvitationArray = exports.validateWorkspaceInvitation = exports.validateWorkspaceUserArray = exports.validateWorkspaceUser = exports.validateAttachment = exports.validateActivityEventArray = exports.validateActivityEvent = exports.validateCurrentUser = exports.validateProductivityStats = exports.validateUserArray = exports.validateUser = exports.validateCommentArray = exports.validateComment = exports.validateLabelArray = exports.validateLabel = exports.validateSectionArray = exports.validateSection = exports.validateWorkspaceProjectArray = exports.validateWorkspaceProject = exports.validateProjectArray = exports.validateProject = exports.validateTaskArray = exports.validateTask = void 0;
-exports.validateUiExtensionArray = exports.validateUiExtension = exports.validateUserAuthorizationArray = exports.validateUserAuthorization = exports.validateAppInstallationArray = exports.validateAppInstallation = exports.validateAppWebhook = exports.validateAppByDistributionToken = exports.validateAppDistributionToken = exports.validateAppTestToken = exports.validateAppVerificationToken = exports.validateAppSecrets = exports.validateAppWithUserCount = exports.validateAppArray = exports.validateApp = exports.validateSuggestionArray = exports.validateSuggestion = exports.validateUserSettings = exports.validateSyncUser = exports.validateSyncWorkspaceArray = exports.validateSyncWorkspace = exports.validateLiveNotificationArray = exports.validateLiveNotification = exports.validateUserPlanLimits = exports.validateProjectViewOptionsDefaultsArray = exports.validateProjectViewOptionsDefaults = exports.validateViewOptionsArray = exports.validateViewOptions = exports.validateCompletedInfoArray = exports.validateCompletedInfo = exports.validateLocationReminderArray = exports.validateLocationReminder = exports.validateReminderArray = exports.validateReminder = exports.validateCalendarAccountArray = exports.validateCalendarAccount = exports.validateCalendarArray = exports.validateCalendar = exports.validateWorkspaceGoalArray = exports.validateWorkspaceGoal = exports.validateWorkspaceFilterArray = exports.validateWorkspaceFilter = exports.validateTooltips = exports.validateNoteArray = exports.validateNote = void 0;
+exports.validateFolder = exports.validateCollaboratorStateArray = exports.validateCollaboratorState = exports.validateCollaboratorArray = exports.validateCollaborator = exports.validateFilterArray = exports.validateFilter = exports.validateMovedIdArray = exports.validateMovedId = exports.validateIdMappingArray = exports.validateIdMapping = exports.validateBackupArray = exports.validateBackup = exports.validateWorkspaceInsights = exports.validateProjectProgress = exports.validateProjectHealthContext = exports.validateProjectHealth = exports.validateProjectActivityStats = exports.validateWorkspaceUserTaskArray = exports.validateWorkspaceUserTask = exports.validateMemberActivityInfoArray = exports.validateMemberActivityInfo = exports.validateWorkspaceArray = exports.validateWorkspace = exports.validateJoinWorkspaceResult = exports.validateWorkspacePlanDetails = exports.validateWorkspaceInvitationArray = exports.validateWorkspaceInvitation = exports.validateWorkspaceUserArray = exports.validateWorkspaceUser = exports.validateAttachment = exports.validateActivityEventArray = exports.validateActivityEvent = exports.validateCurrentUser = exports.validateProductivityStats = exports.validateUserArray = exports.validateUser = exports.validateCommentArray = exports.validateComment = exports.validateLabelArray = exports.validateLabel = exports.validateSectionArray = exports.validateSection = exports.validateWorkspaceProjectArray = exports.validateWorkspaceProject = exports.validateProjectArray = exports.validateProject = exports.validateTaskArray = exports.validateTask = exports.IdSchema = void 0;
+exports.validateUiExtensionArray = exports.validateUiExtension = exports.validateUserAuthorizationArray = exports.validateUserAuthorization = exports.validateAppInstallationArray = exports.validateAppInstallation = exports.validateAppWebhook = exports.validateAppByDistributionToken = exports.validateAppDistributionToken = exports.validateAppTestToken = exports.validateAppVerificationToken = exports.validateAppSecrets = exports.validateAppWithUserCount = exports.validateAppArray = exports.validateApp = exports.validateSuggestionArray = exports.validateSuggestion = exports.validateUserSettings = exports.validateSyncUser = exports.validateSyncWorkspaceArray = exports.validateSyncWorkspace = exports.validateLiveNotificationArray = exports.validateLiveNotification = exports.validateUserPlanLimits = exports.validateProjectViewOptionsDefaultsArray = exports.validateProjectViewOptionsDefaults = exports.validateViewOptionsArray = exports.validateViewOptions = exports.validateCompletedInfoArray = exports.validateCompletedInfo = exports.validateLocationReminderArray = exports.validateLocationReminder = exports.validateReminderArray = exports.validateReminder = exports.validateCalendarAccountArray = exports.validateCalendarAccount = exports.validateCalendarArray = exports.validateCalendar = exports.validateWorkspaceGoalArray = exports.validateWorkspaceGoal = exports.validateWorkspaceFilterArray = exports.validateWorkspaceFilter = exports.validateTooltips = exports.validateNoteArray = exports.validateNote = exports.validateFolderArray = void 0;
 exports.parseSyncResponse = parseSyncResponse;
 const zod_1 = require("zod");
 const types_1 = require("../types/activity/types");
@@ -27,6 +27,11 @@ function createValidator(schema) {
         validateArray: (input) => zod_1.z.array(schema).parse(input),
     };
 }
+const TMP_ID_MESSAGE = 'This looks like a client-side placeholder — wait for sync to complete before calling the API.';
+exports.IdSchema = zod_1.z
+    .string()
+    .min(1)
+    .refine((id) => !id.startsWith('tmp-'), { message: TMP_ID_MESSAGE });
 // Entity validators
 _a = createValidator(types_11.TaskSchema), exports.validateTask = _a.validate, exports.validateTaskArray = _a.validateArray;
 /**

package/dist/cjs/utils/webhook-parser.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseWebhookPayload = parseWebhookPayload;
+exports.verifyWebhookSignature = verifyWebhookSignature;
+const types_1 = require("../types/webhooks/types");
+const case_conversion_1 = require("./case-conversion");
+/**
+ * Parses an incoming webhook request body into a typed payload.
+ *
+ * The backend sends snake_case keys (e.g. `event_name`, `user_id`, `added_at`);
+ * this converts them to camelCase and validates against
+ * {@link WebhookPayloadSchema}. Event-specific `eventData` is returned as
+ * `unknown` for events that are not yet narrowed per-resource.
+ *
+ * Pass the parsed JSON body (or any unknown value) — validation throws on
+ * unexpected shape.
+ */
+function parseWebhookPayload(raw) {
+    return types_1.WebhookPayloadSchema.parse((0, case_conversion_1.camelCaseKeys)(raw));
+}
+const encoder = new TextEncoder();
+function base64ToBytes(base64) {
+    const binary = atob(base64);
+    const bytes = new Uint8Array(binary.length);
+    for (let i = 0; i < binary.length; i++) {
+        bytes[i] = binary.charCodeAt(i);
+    }
+    return bytes;
+}
+/**
+ * Verifies a webhook request's HMAC signature.
+ *
+ * Todoist signs webhook deliveries with an HMAC-SHA256 of the raw request body
+ * using the app's `client_secret` as the key, base64-encoded in the
+ * `X-Todoist-Hmac-SHA256` header.
+ *
+ * Uses the Web Crypto API (`crypto.subtle`), which is available in Node ≥ 20,
+ * modern browsers, React Native (with polyfills), and edge runtimes. The
+ * comparison is constant-time.
+ *
+ * @returns `true` when the signature is valid, `false` otherwise. Never throws
+ * on malformed input.
+ */
+async function verifyWebhookSignature({ rawBody, signature, clientSecret, }) {
+    let provided;
+    try {
+        provided = base64ToBytes(signature);
+    }
+    catch (_a) {
+        return false;
+    }
+    const key = await crypto.subtle.importKey('raw', encoder.encode(clientSecret), { name: 'HMAC', hash: 'SHA-256' }, false, ['verify']);
+    const body = typeof rawBody === 'string' ? encoder.encode(rawBody) : rawBody;
+    try {
+        return await crypto.subtle.verify('HMAC', key, provided, body);
+    }
+    catch (_b) {
+        return false;
+    }
+}

package/dist/esm/clients/app-client.js

@@ -15,7 +15,7 @@ import { isSuccess, request } from '../transport/http-client.js';
 import { webhookEventToWireName } from '../types/apps/index.js';
 import { camelCaseKeys } from '../utils/case-conversion.js';
 import { uploadMultipartFile } from '../utils/multipart-upload.js';
-import { validateApp, validateAppArray, validateAppByDistributionToken, validateAppDistributionToken, validateAppInstallation, validateAppInstallationArray, validateAppSecrets, validateAppTestToken, validateAppVerificationToken, validateAppWebhook, validateAppWithUserCount, validateUserAuthorizationArray, } from '../utils/validators.js';
+import { IdSchema, validateApp, validateAppArray, validateAppByDistributionToken, validateAppDistributionToken, validateAppInstallation, validateAppInstallationArray, validateAppSecrets, validateAppTestToken, validateAppVerificationToken, validateAppWebhook, validateAppWithUserCount, validateUserAuthorizationArray, } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all developer-app management endpoints
@@ -38,7 +38,7 @@ export class AppClient extends BaseClient {
         return validateAppArray(response.data);
     }
     async getApp(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -62,7 +62,7 @@ export class AppClient extends BaseClient {
         return validateApp(response.data);
     }
     async updateApp(appId, args, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const { appTokenScopes } = args, rest = __rest(args, ["appTokenScopes"]);
         const payload = Object.assign({}, rest);
         if (appTokenScopes !== undefined) {
@@ -80,7 +80,7 @@ export class AppClient extends BaseClient {
         return validateAppWithUserCount(response.data);
     }
     async deleteApp(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.apiRootBase,
@@ -92,7 +92,7 @@ export class AppClient extends BaseClient {
         return isSuccess(response);
     }
     async getAppSecrets(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -104,7 +104,7 @@ export class AppClient extends BaseClient {
         return validateAppSecrets(response.data);
     }
     async resetAppClientSecret(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.apiRootBase,
@@ -116,7 +116,7 @@ export class AppClient extends BaseClient {
         return validateAppWithUserCount(response.data);
     }
     async revokeAppTokens(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.apiRootBase,
@@ -128,7 +128,7 @@ export class AppClient extends BaseClient {
         return validateAppWithUserCount(response.data);
     }
     async uploadAppIcon({ appId, file, fileName = '', size = 'medium' }, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         if (Buffer.isBuffer(file) && file.length === 0) {
             throw new Error('Cannot upload empty image file');
         }
@@ -145,7 +145,7 @@ export class AppClient extends BaseClient {
         return validateAppWithUserCount(camelCaseKeys(data));
     }
     async getAppTestToken(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -157,7 +157,7 @@ export class AppClient extends BaseClient {
         return validateAppTestToken(response.data);
     }
     async createAppTestToken(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'PUT',
             baseUri: this.apiRootBase,
@@ -169,7 +169,7 @@ export class AppClient extends BaseClient {
         return validateAppTestToken(response.data);
     }
     async getAppDistributionToken(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -181,7 +181,7 @@ export class AppClient extends BaseClient {
         return validateAppDistributionToken(response.data);
     }
     async getAppVerificationToken(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -193,7 +193,7 @@ export class AppClient extends BaseClient {
         return validateAppVerificationToken(response.data);
     }
     async resetAppVerificationToken(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.apiRootBase,
@@ -218,7 +218,7 @@ export class AppClient extends BaseClient {
     }
     // --- App webhooks ---
     async getAppWebhook(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -243,7 +243,7 @@ export class AppClient extends BaseClient {
         return validateAppWebhook(response.data);
     }
     async deleteAppWebhook(appId, requestId) {
-        z.string().min(1).parse(appId);
+        IdSchema.parse(appId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.apiRootBase,
@@ -279,7 +279,7 @@ export class AppClient extends BaseClient {
         return validateAppInstallation(response.data);
     }
     async getAppInstallation(installationId, requestId) {
-        z.string().min(1).parse(installationId);
+        IdSchema.parse(installationId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.apiRootBase,
@@ -291,7 +291,7 @@ export class AppClient extends BaseClient {
         return validateAppInstallation(response.data);
     }
     async updateAppInstallation(installationId, args, requestId) {
-        z.string().min(1).parse(installationId);
+        IdSchema.parse(installationId);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.apiRootBase,
@@ -304,7 +304,7 @@ export class AppClient extends BaseClient {
         return validateAppInstallation(response.data);
     }
     async uninstallApp(installationId, requestId) {
-        z.string().min(1).parse(installationId);
+        IdSchema.parse(installationId);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.apiRootBase,

package/dist/esm/clients/comment-client.js

@@ -9,11 +9,10 @@ var __rest = (this && this.__rest) || function (s, e) {
         }
     return t;
 };
-import { z } from 'zod';
 import { ENDPOINT_REST_COMMENTS } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
 import { generatePath } from '../utils/request-helpers.js';
-import { validateComment, validateCommentArray } from '../utils/validators.js';
+import { IdSchema, validateComment, validateCommentArray } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all comment-domain endpoints.
@@ -37,7 +36,7 @@ export class CommentClient extends BaseClient {
         };
     }
     async getComment(id) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -61,7 +60,7 @@ export class CommentClient extends BaseClient {
         return validateComment(response.data);
     }
     async updateComment(id, args, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -74,7 +73,7 @@ export class CommentClient extends BaseClient {
         return validateComment(response.data);
     }
     async deleteComment(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,

package/dist/esm/clients/folder-client.js

@@ -1,8 +1,7 @@
-import { z } from 'zod';
 import { ENDPOINT_REST_FOLDERS } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
 import { generatePath } from '../utils/request-helpers.js';
-import { validateFolder, validateFolderArray } from '../utils/validators.js';
+import { IdSchema, validateFolder, validateFolderArray } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all folder-domain endpoints.
@@ -26,7 +25,7 @@ export class FolderClient extends BaseClient {
         };
     }
     async getFolder(id) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -49,7 +48,7 @@ export class FolderClient extends BaseClient {
         return validateFolder(response.data);
     }
     async updateFolder(id, args, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -62,7 +61,7 @@ export class FolderClient extends BaseClient {
         return validateFolder(response.data);
     }
     async deleteFolder(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,

package/dist/esm/clients/insights-client.js

@@ -1,7 +1,6 @@
-import { z } from 'zod';
 import { getProjectInsightsActivityStatsEndpoint, getProjectInsightsHealthAnalyzeEndpoint, getProjectInsightsHealthContextEndpoint, getProjectInsightsHealthEndpoint, getProjectInsightsProgressEndpoint, getWorkspaceInsightsEndpoint, } from '../consts/endpoints.js';
 import { request } from '../transport/http-client.js';
-import { validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, } from '../utils/validators.js';
+import { IdSchema, validateProjectActivityStats, validateProjectHealth, validateProjectHealthContext, validateProjectProgress, validateWorkspaceInsights, } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all insights-domain endpoints
@@ -13,7 +12,7 @@ import { BaseClient } from './base-client.js';
  */
 export class InsightsClient extends BaseClient {
     async getProjectActivityStats(projectId, args = {}) {
-        z.string().min(1).parse(projectId);
+        IdSchema.parse(projectId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -25,7 +24,7 @@ export class InsightsClient extends BaseClient {
         return validateProjectActivityStats(response.data);
     }
     async getProjectHealth(projectId) {
-        z.string().min(1).parse(projectId);
+        IdSchema.parse(projectId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -36,7 +35,7 @@ export class InsightsClient extends BaseClient {
         return validateProjectHealth(response.data);
     }
     async getProjectHealthContext(projectId) {
-        z.string().min(1).parse(projectId);
+        IdSchema.parse(projectId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -47,7 +46,7 @@ export class InsightsClient extends BaseClient {
         return validateProjectHealthContext(response.data);
     }
     async getProjectProgress(projectId) {
-        z.string().min(1).parse(projectId);
+        IdSchema.parse(projectId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -58,7 +57,7 @@ export class InsightsClient extends BaseClient {
         return validateProjectProgress(response.data);
     }
     async getWorkspaceInsights(workspaceId, args = {}) {
-        z.string().min(1).parse(workspaceId);
+        IdSchema.parse(workspaceId);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -70,7 +69,7 @@ export class InsightsClient extends BaseClient {
         return validateWorkspaceInsights(response.data);
     }
     async analyzeProjectHealth(projectId, requestId) {
-        z.string().min(1).parse(projectId);
+        IdSchema.parse(projectId);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,

package/dist/esm/clients/label-client.js

@@ -1,8 +1,7 @@
-import { z } from 'zod';
 import { ENDPOINT_REST_LABELS, ENDPOINT_REST_LABELS_SEARCH, ENDPOINT_REST_LABELS_SHARED, ENDPOINT_REST_LABELS_SHARED_REMOVE, ENDPOINT_REST_LABELS_SHARED_RENAME, } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
 import { generatePath } from '../utils/request-helpers.js';
-import { validateLabel, validateLabelArray } from '../utils/validators.js';
+import { IdSchema, validateLabel, validateLabelArray } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all label-domain endpoints.
@@ -12,7 +11,7 @@ import { BaseClient } from './base-client.js';
  */
 export class LabelClient extends BaseClient {
     async getLabel(id) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -63,7 +62,7 @@ export class LabelClient extends BaseClient {
         return validateLabel(response.data);
     }
     async updateLabel(id, args, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -76,7 +75,7 @@ export class LabelClient extends BaseClient {
         return validateLabel(response.data);
     }
     async deleteLabel(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,

package/dist/esm/clients/project-client.js

@@ -1,8 +1,7 @@
-import { z } from 'zod';
 import { ENDPOINT_REST_PROJECTS, ENDPOINT_REST_PROJECTS_ARCHIVED, ENDPOINT_REST_PROJECTS_ARCHIVED_COUNT, ENDPOINT_REST_PROJECTS_MOVE_TO_PERSONAL, ENDPOINT_REST_PROJECTS_MOVE_TO_WORKSPACE, ENDPOINT_REST_PROJECTS_PERMISSIONS, ENDPOINT_REST_PROJECTS_SEARCH, ENDPOINT_REST_PROJECT_COLLABORATORS, ENDPOINT_REST_PROJECT_FULL, ENDPOINT_REST_PROJECT_JOIN, PROJECT_ARCHIVE, PROJECT_UNARCHIVE, } from '../consts/endpoints.js';
 import { isSuccess, request } from '../transport/http-client.js';
 import { generatePath } from '../utils/request-helpers.js';
-import { validateCollaboratorArray, validateCollaboratorStateArray, validateCommentArray, validateFolder, validateNoteArray, validateProject, validateProjectArray, validateSectionArray, validateTaskArray, validateUserArray, validateWorkspaceProject, validateWorkspaceProjectArray, } from '../utils/validators.js';
+import { IdSchema, validateCollaboratorArray, validateCollaboratorStateArray, validateCommentArray, validateFolder, validateNoteArray, validateProject, validateProjectArray, validateSectionArray, validateTaskArray, validateUserArray, validateWorkspaceProject, validateWorkspaceProjectArray, } from '../utils/validators.js';
 import { BaseClient } from './base-client.js';
 /**
  * Internal sub-client handling all project-domain endpoints.
@@ -12,7 +11,7 @@ import { BaseClient } from './base-client.js';
  */
 export class ProjectClient extends BaseClient {
     async getProject(id) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -77,7 +76,7 @@ export class ProjectClient extends BaseClient {
         return validateProject(response.data);
     }
     async updateProject(id, args, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -90,7 +89,7 @@ export class ProjectClient extends BaseClient {
         return validateProject(response.data);
     }
     async deleteProject(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'DELETE',
             baseUri: this.syncApiBase,
@@ -102,7 +101,7 @@ export class ProjectClient extends BaseClient {
         return isSuccess(response);
     }
     async archiveProject(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -114,7 +113,7 @@ export class ProjectClient extends BaseClient {
         return validateProject(response.data);
     }
     async unarchiveProject(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const response = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -171,7 +170,7 @@ export class ProjectClient extends BaseClient {
         return data;
     }
     async getFullProject(id, args = {}) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const { data } = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,
@@ -190,7 +189,7 @@ export class ProjectClient extends BaseClient {
         };
     }
     async joinProject(id, requestId) {
-        z.string().min(1).parse(id);
+        IdSchema.parse(id);
         const { data } = await request({
             httpMethod: 'POST',
             baseUri: this.syncApiBase,
@@ -211,7 +210,7 @@ export class ProjectClient extends BaseClient {
         };
     }
     async getProjectCollaborators(projectId, args = {}) {
-        z.string().min(1).parse(projectId);
+        IdSchema.parse(projectId);
         const { data: { results, nextCursor }, } = await request({
             httpMethod: 'GET',
             baseUri: this.syncApiBase,