@doist/todoist-sdk 9.5.0 → 9.6.0

package/dist/cjs/types/sections/types.js

@@ -1,10 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.SectionSchema = void 0;
+exports.SectionSchema = exports.SectionBaseSchema = void 0;
 const zod_1 = require("zod");
 const url_helpers_1 = require("../../utils/url-helpers");
-exports.SectionSchema = zod_1.z
-    .object({
+/**
+ * Raw section fields (the persisted shape). Exposed so schemas that extend
+ * or override a field — notably the webhook variant — can reuse the base
+ * without duplicating every field.
+ */
+exports.SectionBaseSchema = zod_1.z.object({
     id: zod_1.z.string(),
     userId: zod_1.z.string(),
     projectId: zod_1.z.string(),
@@ -16,7 +20,5 @@ exports.SectionSchema = zod_1.z
     isArchived: zod_1.z.boolean(),
     isDeleted: zod_1.z.boolean(),
     isCollapsed: zod_1.z.boolean(),
-})
-    .transform((data) => {
-    return Object.assign(Object.assign({}, data), { url: (0, url_helpers_1.getSectionUrl)(data.id, data.name) });
 });
+exports.SectionSchema = exports.SectionBaseSchema.transform((data) => (Object.assign(Object.assign({}, data), { url: (0, url_helpers_1.getSectionUrl)(data.id, data.name) })));

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

@@ -17,5 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./comments"), exports);
 __exportStar(require("./envelope"), exports);
 __exportStar(require("./labels"), exports);
+__exportStar(require("./projects"), exports);
+__exportStar(require("./sections"), exports);
 __exportStar(require("./tasks"), exports);
 __exportStar(require("./types"), exports);

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

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ProjectUnarchivedPayloadSchema = exports.ProjectArchivedPayloadSchema = exports.ProjectDeletedPayloadSchema = exports.ProjectUpdatedPayloadSchema = exports.ProjectAddedPayloadSchema = exports.PROJECT_WEBHOOK_EVENTS = exports.ProjectWebhookEventEnum = void 0;
+const zod_1 = require("zod");
+const types_1 = require("../projects/types");
+const envelope_1 = require("./envelope");
+/**
+ * Enum-like object of project (`project:*`) webhook event names. Single
+ * source of truth for the discriminator values — `PROJECT_WEBHOOK_EVENTS`
+ * and every `z.literal()` below derive from it.
+ */
+exports.ProjectWebhookEventEnum = {
+    Added: 'project:added',
+    Updated: 'project:updated',
+    Deleted: 'project:deleted',
+    Archived: 'project:archived',
+    Unarchived: 'project:unarchived',
+};
+/** Webhook events that carry a project as their `eventData`. */
+exports.PROJECT_WEBHOOK_EVENTS = [
+    exports.ProjectWebhookEventEnum.Added,
+    exports.ProjectWebhookEventEnum.Updated,
+    exports.ProjectWebhookEventEnum.Deleted,
+    exports.ProjectWebhookEventEnum.Archived,
+    exports.ProjectWebhookEventEnum.Unarchived,
+];
+/**
+ * Webhook project payloads match the shape of the shared {@link Project}
+ * resource — either a personal or a workspace project. No webhook-specific
+ * schema is needed; `ProjectSchema` already dispatches on `workspaceId`.
+ */
+exports.ProjectAddedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.ProjectWebhookEventEnum.Added), eventData: types_1.ProjectSchema }));
+exports.ProjectUpdatedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.ProjectWebhookEventEnum.Updated), eventData: types_1.ProjectSchema }));
+exports.ProjectDeletedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.ProjectWebhookEventEnum.Deleted), eventData: types_1.ProjectSchema }));
+exports.ProjectArchivedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.ProjectWebhookEventEnum.Archived), eventData: types_1.ProjectSchema }));
+exports.ProjectUnarchivedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.ProjectWebhookEventEnum.Unarchived), eventData: types_1.ProjectSchema }));

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

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SectionUnarchivedPayloadSchema = exports.SectionArchivedPayloadSchema = exports.SectionDeletedPayloadSchema = exports.SectionUpdatedPayloadSchema = exports.SectionAddedPayloadSchema = exports.WebhookSectionSchema = exports.SECTION_WEBHOOK_EVENTS = exports.SectionWebhookEventEnum = void 0;
+const zod_1 = require("zod");
+const url_helpers_1 = require("../../utils/url-helpers");
+const types_1 = require("../sections/types");
+const envelope_1 = require("./envelope");
+/**
+ * Enum-like object of section (`section:*`) webhook event names. Single
+ * source of truth for the discriminator values — `SECTION_WEBHOOK_EVENTS`
+ * and every `z.literal()` below derive from it.
+ */
+exports.SectionWebhookEventEnum = {
+    Added: 'section:added',
+    Updated: 'section:updated',
+    Deleted: 'section:deleted',
+    Archived: 'section:archived',
+    Unarchived: 'section:unarchived',
+};
+/** Webhook events that carry a section as their `eventData`. */
+exports.SECTION_WEBHOOK_EVENTS = [
+    exports.SectionWebhookEventEnum.Added,
+    exports.SectionWebhookEventEnum.Updated,
+    exports.SectionWebhookEventEnum.Deleted,
+    exports.SectionWebhookEventEnum.Archived,
+    exports.SectionWebhookEventEnum.Unarchived,
+];
+/**
+ * A section as delivered in a webhook payload.
+ *
+ * Reuses {@link SectionBaseSchema} and overrides `updatedAt` to tolerate
+ * payloads that deliver it as `null` or omit the key entirely — tombstones
+ * and never-updated sections come through without an `updated_at` value.
+ * The result is normalised to `Date | null` so consumers don't have to
+ * handle three shapes. Surfaces the computed `url` so the exposed shape
+ * matches {@link Section}.
+ */
+exports.WebhookSectionSchema = types_1.SectionBaseSchema.extend({
+    updatedAt: zod_1.z.coerce
+        .date()
+        .nullish()
+        .transform((value) => value !== null && value !== void 0 ? value : null),
+}).transform((data) => (Object.assign(Object.assign({}, data), { url: (0, url_helpers_1.getSectionUrl)(data.id, data.name) })));
+exports.SectionAddedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.SectionWebhookEventEnum.Added), eventData: exports.WebhookSectionSchema }));
+exports.SectionUpdatedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.SectionWebhookEventEnum.Updated), eventData: exports.WebhookSectionSchema }));
+exports.SectionDeletedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.SectionWebhookEventEnum.Deleted), eventData: exports.WebhookSectionSchema }));
+exports.SectionArchivedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.SectionWebhookEventEnum.Archived), eventData: exports.WebhookSectionSchema }));
+exports.SectionUnarchivedPayloadSchema = zod_1.z.object(Object.assign(Object.assign({}, envelope_1.BaseWebhookEnvelopeShape), { eventName: zod_1.z.literal(exports.SectionWebhookEventEnum.Unarchived), eventData: exports.WebhookSectionSchema }));

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

@@ -7,6 +7,8 @@ Object.defineProperty(exports, "WebhookEventSchema", { enumerable: true, get: fu
 const comments_1 = require("./comments");
 const envelope_1 = require("./envelope");
 const labels_1 = require("./labels");
+const projects_1 = require("./projects");
+const sections_1 = require("./sections");
 const tasks_1 = require("./tasks");
 /**
  * Events whose payloads have been narrowed per resource. Each phase adds to
@@ -17,12 +19,14 @@ const TYPED_WEBHOOK_EVENTS = [
     ...tasks_1.TASK_WEBHOOK_EVENTS,
     ...comments_1.COMMENT_WEBHOOK_EVENTS,
     ...labels_1.LABEL_WEBHOOK_EVENTS,
+    ...projects_1.PROJECT_WEBHOOK_EVENTS,
+    ...sections_1.SECTION_WEBHOOK_EVENTS,
 ];
 const untypedEventNames = types_1.WEBHOOK_EVENTS.filter((event) => !TYPED_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 (projects, sections, filters, reminders).
+ * variants (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() }));
 /**
@@ -34,9 +38,10 @@ exports.UntypedWebhookPayloadSchema = zod_1.z.object(Object.assign(Object.assign
  *
  * Typed today: `item:*` events carry a parsed {@link Task}; `note:*` events
  * carry a parsed comment (item-comment or project-comment); `label:*` events
- * carry a parsed label. Other events still expose `eventData` as `unknown`;
- * they will be narrowed in follow-up PRs (projects, sections, filters,
- * reminders).
+ * carry a parsed label; `project:*` events carry a parsed {@link Project}
+ * (personal or workspace); `section:*` events carry a parsed
+ * {@link WebhookSection}. Other events still expose `eventData` as
+ * `unknown`; they will be narrowed in follow-up PRs (filters, reminders).
  */
 exports.WebhookPayloadSchema = zod_1.z.discriminatedUnion('eventName', [
     tasks_1.TaskAddedPayloadSchema,
@@ -50,5 +55,15 @@ exports.WebhookPayloadSchema = zod_1.z.discriminatedUnion('eventName', [
     labels_1.LabelAddedPayloadSchema,
     labels_1.LabelUpdatedPayloadSchema,
     labels_1.LabelDeletedPayloadSchema,
+    projects_1.ProjectAddedPayloadSchema,
+    projects_1.ProjectUpdatedPayloadSchema,
+    projects_1.ProjectDeletedPayloadSchema,
+    projects_1.ProjectArchivedPayloadSchema,
+    projects_1.ProjectUnarchivedPayloadSchema,
+    sections_1.SectionAddedPayloadSchema,
+    sections_1.SectionUpdatedPayloadSchema,
+    sections_1.SectionDeletedPayloadSchema,
+    sections_1.SectionArchivedPayloadSchema,
+    sections_1.SectionUnarchivedPayloadSchema,
     exports.UntypedWebhookPayloadSchema,
 ]);

package/dist/esm/types/sections/types.js

@@ -1,7 +1,11 @@
 import { z } from 'zod';
 import { getSectionUrl } from '../../utils/url-helpers.js';
-export const SectionSchema = z
-    .object({
+/**
+ * Raw section fields (the persisted shape). Exposed so schemas that extend
+ * or override a field — notably the webhook variant — can reuse the base
+ * without duplicating every field.
+ */
+export const SectionBaseSchema = z.object({
     id: z.string(),
     userId: z.string(),
     projectId: z.string(),
@@ -13,7 +17,5 @@ export const SectionSchema = z
     isArchived: z.boolean(),
     isDeleted: z.boolean(),
     isCollapsed: z.boolean(),
-})
-    .transform((data) => {
-    return Object.assign(Object.assign({}, data), { url: getSectionUrl(data.id, data.name) });
 });
+export const SectionSchema = SectionBaseSchema.transform((data) => (Object.assign(Object.assign({}, data), { url: getSectionUrl(data.id, data.name) })));

package/dist/esm/types/webhooks/index.js

@@ -1,5 +1,7 @@
 export * from './comments.js';
 export * from './envelope.js';
 export * from './labels.js';
+export * from './projects.js';
+export * from './sections.js';
 export * from './tasks.js';
 export * from './types.js';

package/dist/esm/types/webhooks/projects.js

@@ -0,0 +1,33 @@
+import { z } from 'zod';
+import { ProjectSchema } from '../projects/types.js';
+import { BaseWebhookEnvelopeShape } from './envelope.js';
+/**
+ * Enum-like object of project (`project:*`) webhook event names. Single
+ * source of truth for the discriminator values — `PROJECT_WEBHOOK_EVENTS`
+ * and every `z.literal()` below derive from it.
+ */
+export const ProjectWebhookEventEnum = {
+    Added: 'project:added',
+    Updated: 'project:updated',
+    Deleted: 'project:deleted',
+    Archived: 'project:archived',
+    Unarchived: 'project:unarchived',
+};
+/** Webhook events that carry a project as their `eventData`. */
+export const PROJECT_WEBHOOK_EVENTS = [
+    ProjectWebhookEventEnum.Added,
+    ProjectWebhookEventEnum.Updated,
+    ProjectWebhookEventEnum.Deleted,
+    ProjectWebhookEventEnum.Archived,
+    ProjectWebhookEventEnum.Unarchived,
+];
+/**
+ * Webhook project payloads match the shape of the shared {@link Project}
+ * resource — either a personal or a workspace project. No webhook-specific
+ * schema is needed; `ProjectSchema` already dispatches on `workspaceId`.
+ */
+export const ProjectAddedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(ProjectWebhookEventEnum.Added), eventData: ProjectSchema }));
+export const ProjectUpdatedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(ProjectWebhookEventEnum.Updated), eventData: ProjectSchema }));
+export const ProjectDeletedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(ProjectWebhookEventEnum.Deleted), eventData: ProjectSchema }));
+export const ProjectArchivedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(ProjectWebhookEventEnum.Archived), eventData: ProjectSchema }));
+export const ProjectUnarchivedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(ProjectWebhookEventEnum.Unarchived), eventData: ProjectSchema }));

package/dist/esm/types/webhooks/sections.js

@@ -0,0 +1,45 @@
+import { z } from 'zod';
+import { getSectionUrl } from '../../utils/url-helpers.js';
+import { SectionBaseSchema } from '../sections/types.js';
+import { BaseWebhookEnvelopeShape } from './envelope.js';
+/**
+ * Enum-like object of section (`section:*`) webhook event names. Single
+ * source of truth for the discriminator values — `SECTION_WEBHOOK_EVENTS`
+ * and every `z.literal()` below derive from it.
+ */
+export const SectionWebhookEventEnum = {
+    Added: 'section:added',
+    Updated: 'section:updated',
+    Deleted: 'section:deleted',
+    Archived: 'section:archived',
+    Unarchived: 'section:unarchived',
+};
+/** Webhook events that carry a section as their `eventData`. */
+export const SECTION_WEBHOOK_EVENTS = [
+    SectionWebhookEventEnum.Added,
+    SectionWebhookEventEnum.Updated,
+    SectionWebhookEventEnum.Deleted,
+    SectionWebhookEventEnum.Archived,
+    SectionWebhookEventEnum.Unarchived,
+];
+/**
+ * A section as delivered in a webhook payload.
+ *
+ * Reuses {@link SectionBaseSchema} and overrides `updatedAt` to tolerate
+ * payloads that deliver it as `null` or omit the key entirely — tombstones
+ * and never-updated sections come through without an `updated_at` value.
+ * The result is normalised to `Date | null` so consumers don't have to
+ * handle three shapes. Surfaces the computed `url` so the exposed shape
+ * matches {@link Section}.
+ */
+export const WebhookSectionSchema = SectionBaseSchema.extend({
+    updatedAt: z.coerce
+        .date()
+        .nullish()
+        .transform((value) => value !== null && value !== void 0 ? value : null),
+}).transform((data) => (Object.assign(Object.assign({}, data), { url: getSectionUrl(data.id, data.name) })));
+export const SectionAddedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(SectionWebhookEventEnum.Added), eventData: WebhookSectionSchema }));
+export const SectionUpdatedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(SectionWebhookEventEnum.Updated), eventData: WebhookSectionSchema }));
+export const SectionDeletedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(SectionWebhookEventEnum.Deleted), eventData: WebhookSectionSchema }));
+export const SectionArchivedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(SectionWebhookEventEnum.Archived), eventData: WebhookSectionSchema }));
+export const SectionUnarchivedPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.literal(SectionWebhookEventEnum.Unarchived), eventData: WebhookSectionSchema }));

package/dist/esm/types/webhooks/types.js

@@ -3,6 +3,8 @@ import { WEBHOOK_EVENTS, WebhookEventSchema } from '../apps/types.js';
 import { COMMENT_WEBHOOK_EVENTS, CommentAddedPayloadSchema, CommentDeletedPayloadSchema, CommentUpdatedPayloadSchema, } from './comments.js';
 import { BaseWebhookEnvelopeShape } from './envelope.js';
 import { LABEL_WEBHOOK_EVENTS, LabelAddedPayloadSchema, LabelDeletedPayloadSchema, LabelUpdatedPayloadSchema, } from './labels.js';
+import { PROJECT_WEBHOOK_EVENTS, ProjectAddedPayloadSchema, ProjectArchivedPayloadSchema, ProjectDeletedPayloadSchema, ProjectUnarchivedPayloadSchema, ProjectUpdatedPayloadSchema, } from './projects.js';
+import { SECTION_WEBHOOK_EVENTS, SectionAddedPayloadSchema, SectionArchivedPayloadSchema, SectionDeletedPayloadSchema, SectionUnarchivedPayloadSchema, SectionUpdatedPayloadSchema, } from './sections.js';
 import { TASK_WEBHOOK_EVENTS, TaskAddedPayloadSchema, TaskCompletedPayloadSchema, TaskDeletedPayloadSchema, TaskUncompletedPayloadSchema, TaskUpdatedPayloadSchema, } from './tasks.js';
 /**
  * Events whose payloads have been narrowed per resource. Each phase adds to
@@ -13,12 +15,14 @@ const TYPED_WEBHOOK_EVENTS = [
     ...TASK_WEBHOOK_EVENTS,
     ...COMMENT_WEBHOOK_EVENTS,
     ...LABEL_WEBHOOK_EVENTS,
+    ...PROJECT_WEBHOOK_EVENTS,
+    ...SECTION_WEBHOOK_EVENTS,
 ];
 const untypedEventNames = WEBHOOK_EVENTS.filter((event) => !TYPED_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 (projects, sections, filters, reminders).
+ * variants (filters, reminders).
  */
 export const UntypedWebhookPayloadSchema = z.object(Object.assign(Object.assign({}, BaseWebhookEnvelopeShape), { eventName: z.enum(untypedEventNames), eventData: z.unknown(), eventDataExtra: z.unknown().optional() }));
 /**
@@ -30,9 +34,10 @@ export const UntypedWebhookPayloadSchema = z.object(Object.assign(Object.assign(
  *
  * Typed today: `item:*` events carry a parsed {@link Task}; `note:*` events
  * carry a parsed comment (item-comment or project-comment); `label:*` events
- * carry a parsed label. Other events still expose `eventData` as `unknown`;
- * they will be narrowed in follow-up PRs (projects, sections, filters,
- * reminders).
+ * carry a parsed label; `project:*` events carry a parsed {@link Project}
+ * (personal or workspace); `section:*` events carry a parsed
+ * {@link WebhookSection}. Other events still expose `eventData` as
+ * `unknown`; they will be narrowed in follow-up PRs (filters, reminders).
  */
 export const WebhookPayloadSchema = z.discriminatedUnion('eventName', [
     TaskAddedPayloadSchema,
@@ -46,6 +51,16 @@ export const WebhookPayloadSchema = z.discriminatedUnion('eventName', [
     LabelAddedPayloadSchema,
     LabelUpdatedPayloadSchema,
     LabelDeletedPayloadSchema,
+    ProjectAddedPayloadSchema,
+    ProjectUpdatedPayloadSchema,
+    ProjectDeletedPayloadSchema,
+    ProjectArchivedPayloadSchema,
+    ProjectUnarchivedPayloadSchema,
+    SectionAddedPayloadSchema,
+    SectionUpdatedPayloadSchema,
+    SectionDeletedPayloadSchema,
+    SectionArchivedPayloadSchema,
+    SectionUnarchivedPayloadSchema,
     UntypedWebhookPayloadSchema,
 ]);
 export { WebhookEventSchema };

package/dist/types/types/sections/types.d.ts

@@ -1,4 +1,22 @@
 import { z } from 'zod';
+/**
+ * Raw section fields (the persisted shape). Exposed so schemas that extend
+ * or override a field — notably the webhook variant — can reuse the base
+ * without duplicating every field.
+ */
+export declare const SectionBaseSchema: z.ZodObject<{
+    id: z.ZodString;
+    userId: z.ZodString;
+    projectId: z.ZodString;
+    addedAt: z.ZodCoercedDate<unknown>;
+    updatedAt: z.ZodCoercedDate<unknown>;
+    archivedAt: z.ZodNullable<z.ZodCoercedDate<unknown>>;
+    name: z.ZodString;
+    sectionOrder: z.ZodNumber;
+    isArchived: z.ZodBoolean;
+    isDeleted: z.ZodBoolean;
+    isCollapsed: z.ZodBoolean;
+}, z.core.$strip>;
 export declare const SectionSchema: z.ZodPipe<z.ZodObject<{
     id: z.ZodString;
     userId: z.ZodString;

package/dist/types/types/webhooks/index.d.ts

@@ -1,5 +1,7 @@
 export * from './comments.js';
 export * from './envelope.js';
 export * from './labels.js';
+export * from './projects.js';
+export * from './sections.js';
 export * from './tasks.js';
 export * from './types.js';