@heymantle/core-api-client 0.1.11 → 0.1.13

package/README.md

@@ -233,8 +233,9 @@ const { contacts, hasNextPage } = await client.contacts.list({
   socialProfileUrl: 'https://linkedin.com/in/johndoe',
 });
 
-// Create a contact with social profiles
-const { contact } = await client.contacts.create({
+// Create or update a contact (upsert by email)
+// If a contact with the same email exists, it will be updated
+const { contact, created } = await client.contacts.create({
   name: 'John Doe',
   email: 'john@acme.com',
   phone: '+1-555-123-4567',
@@ -248,6 +249,7 @@ const { contact } = await client.contacts.create({
     { key: 'website', value: 'https://johndoe.com' },
   ],
 });
+console.log(created ? 'New contact created' : 'Existing contact updated');
 
 // Update a contact
 const { contact } = await client.contacts.update('contact_123', {

package/dist/index.d.mts

@@ -403,6 +403,14 @@ interface ContactCreateParams {
  */
 interface ContactUpdateParams extends Partial<ContactCreateParams> {
 }
+/**
+ * Response from creating/upserting a contact
+ */
+interface ContactCreateResponse {
+    contact: Contact;
+    /** True if a new contact was created, false if an existing contact was updated */
+    created: boolean;
+}
 
 /**
  * Subscription entity
@@ -1815,11 +1823,30 @@ interface AgentResponse {
 /**
  * Task status
  */
-type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'canceled';
+type TaskStatus = 'new' | 'in_progress' | 'complete';
 /**
  * Task priority
  */
-type TaskPriority = 'low' | 'medium' | 'high' | 'urgent';
+type TaskPriority = 'low' | 'medium' | 'high';
+/**
+ * Task todo item entity
+ */
+interface TodoItem {
+    id: string;
+    content: string;
+    completed: boolean;
+    completedAt?: string | null;
+    displayOrder: number;
+}
+/**
+ * Parameters for creating a todo item (used in task creation/update)
+ */
+interface TodoItemInput {
+    id?: string;
+    content: string;
+    completed?: boolean;
+    displayOrder?: number;
+}
 /**
  * Task entity
  */
@@ -1831,6 +1858,7 @@ interface Task {
     priority: TaskPriority;
     status: TaskStatus;
     dueDate?: string;
+    completedAt?: string | null;
     assigneeId?: string;
     customerId?: string;
     contactId?: string;
@@ -1844,19 +1872,33 @@ interface Task {
         id: string;
         name?: string;
         email?: string;
-    };
+    } | null;
+    createdBy?: {
+        id: string;
+        name?: string;
+        email?: string;
+    } | null;
     customer?: {
         id: string;
         name?: string;
-    };
+    } | null;
     contact?: {
         id: string;
         name?: string;
-    };
+    } | null;
     deal?: {
         id: string;
         name?: string;
-    };
+        dealStage?: {
+            id: string;
+            name?: string;
+        } | null;
+    } | null;
+    dealActivity?: {
+        id: string;
+        name?: string;
+    } | null;
+    todoItems?: TodoItem[];
 }
 /**
  * Parameters for listing tasks
@@ -1891,12 +1933,59 @@ interface TaskCreateParams {
     dealActivityId?: string;
     appInstallationId?: string;
     tags?: string[];
+    todoItems?: TodoItemInput[];
 }
 /**
  * Parameters for updating a task
  */
 interface TaskUpdateParams extends Partial<TaskCreateParams> {
 }
+/**
+ * Response from listing todo items
+ */
+interface TodoItemListResponse {
+    items: TodoItem[];
+    total: number;
+}
+/**
+ * Deal progression information returned when a task update triggers deal stage change
+ */
+interface DealProgression {
+    dealId: string;
+    dealName: string;
+    previousStage: {
+        id: string;
+        name: string;
+    } | null;
+    nextStage: {
+        id: string;
+        name: string;
+    } | null;
+}
+/**
+ * Response from updating a task
+ */
+interface TaskUpdateResponse {
+    task: Task;
+    dealProgressed: boolean;
+    dealProgression: DealProgression | null;
+}
+/**
+ * Parameters for creating a todo item via the dedicated endpoint
+ */
+interface TodoItemCreateParams {
+    content: string;
+    completed?: boolean;
+    displayOrder?: number;
+}
+/**
+ * Parameters for updating a todo item
+ */
+interface TodoItemUpdateParams {
+    content?: string;
+    completed?: boolean;
+    displayOrder?: number;
+}
 
 /**
  * Company entity
@@ -2225,11 +2314,12 @@ declare class ContactsResource extends BaseResource {
         contact: Contact;
     }>;
     /**
-     * Create a new contact
+     * Create or update a contact.
+     * If a contact with the same email exists in the organization, it will be updated.
+     * Otherwise, a new contact will be created.
+     * @returns The contact and a boolean indicating if it was newly created
      */
-    create(data: ContactCreateParams): Promise<{
-        contact: Contact;
-    }>;
+    create(data: ContactCreateParams): Promise<ContactCreateResponse>;
     /**
      * Update an existing contact
      */
@@ -2771,19 +2861,41 @@ declare class TasksResource extends BaseResource {
     /**
      * Create a new task
      */
-    create(data: TaskCreateParams): Promise<{
-        task: Task;
-    }>;
+    create(data: TaskCreateParams): Promise<Task>;
     /**
      * Update an existing task
      */
-    update(taskId: string, data: TaskUpdateParams): Promise<{
-        task: Task;
-    }>;
+    update(taskId: string, data: TaskUpdateParams): Promise<TaskUpdateResponse>;
     /**
      * Delete a task
      */
     del(taskId: string): Promise<DeleteResponse>;
+    /**
+     * List todo items for a task
+     */
+    listTodoItems(taskId: string): Promise<TodoItemListResponse>;
+    /**
+     * Retrieve a single todo item
+     */
+    retrieveTodoItem(taskId: string, itemId: string): Promise<{
+        item: TodoItem;
+    }>;
+    /**
+     * Create a todo item for a task
+     */
+    createTodoItem(taskId: string, data: TodoItemCreateParams): Promise<{
+        item: TodoItem;
+    }>;
+    /**
+     * Update a todo item
+     */
+    updateTodoItem(taskId: string, itemId: string, data: TodoItemUpdateParams): Promise<{
+        item: TodoItem;
+    }>;
+    /**
+     * Delete a todo item
+     */
+    deleteTodoItem(taskId: string, itemId: string): Promise<DeleteResponse>;
 }
 
 /**
@@ -3654,4 +3766,4 @@ interface RateLimitOptions {
  */
 declare function createRateLimitMiddleware(options?: RateLimitOptions): Middleware;
 
-export { type AccountOwner, type AccountOwnersListResponse, type Affiliate, type AffiliateCommission, type AffiliateCommissionListParams, type AffiliateCommissionListResponse, AffiliateCommissionsResource, type AffiliateListParams, type AffiliateListResponse, type AffiliatePayout, type AffiliatePayoutListParams, type AffiliatePayoutListResponse, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramCreateParams, type AffiliateProgramUpdateParams, AffiliateProgramsResource, type AffiliateReferral, type AffiliateReferralListParams, type AffiliateReferralListResponse, AffiliateReferralsResource, type AffiliateUpdateParams, AffiliatesResource, type Agent, type AgentCreateParams, type AgentListResponse, type AgentResponse, AgentsResource, type App, type AppEvent, type AppEventListParams, type AppEventListResponse, type AppInstallation, type AppInstallationParams, type AppListParams, AppsResource, type AuthRefreshOptions, BaseResource, type Channel, type ChannelCreateParams, type ChannelListParams, ChannelsResource, type Charge, type ChargeListParams, type ChargeListResponse, ChargesResource, CompaniesResource, type Company, type CompanyCreateParams, type CompanyListParams, type CompanyListResponse, type CompanyUpdateParams, type Contact, type ContactCreateParams, type ContactEntity, type ContactListParams, type ContactListResponse, type ContactUpdateParams, ContactsResource, type CustomDataDeleteParams, type CustomDataGetParams, CustomDataResource, type CustomDataResourceType, type CustomDataResponse, type CustomDataSetParams, type CustomField, type CustomFieldCreateParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerEntity, type CustomerListParams, type CustomerListResponse, type CustomerRetrieveParams, type CustomerSegment, type CustomerSegmentListParams, type CustomerSegmentListResponse, CustomerSegmentsResource, type CustomerUpdateParams, CustomersResource, type DateRangeType, type Deal, DealActivitiesResource, type DealActivity, type DealActivityCreateParams, type DealActivityUpdateParams, type DealContactInput, type DealCreateParams, type DealCustomerInput, type DealEvent, type DealEventCreateParams, type DealEventCreateResponse, type DealEventListResponse, type DealFlow, type DealFlowCreateParams, type DealFlowUpdateParams, DealFlowsResource, type DealListParams, type DealListResponse, type DealStage, type DealUpdateParams, DealsResource, type DeleteResponse, type DocCollection, type DocCollectionCreateParams, type DocCollectionUpdateParams, type DocGroup, type DocGroupCreateParams, type DocGroupUpdateParams, type DocPage, type DocPageCreateParams, type DocPageListParams, type DocPageListResponse, type DocPageStatus, type DocPageUpdateParams, type DocTreeNode, type DocTreeResponse, DocsResource, EntitiesResource, type EntitiesSearchParams, type EntitiesSearchResponse, type Entity, type EntityType, type Feature, type FeatureCreateParams, type FeatureUpdateParams, type Flow, type FlowCreateParams, type FlowListParams, type FlowListResponse, type FlowStatus, type FlowUpdateParams, FlowsResource, type HttpMethod, type ListParams, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type MeResponse, type MessageAttachment, type MetricDataPoint, type MetricType, type MetricsBaseParams, type MetricsGetParams, MetricsResource, type MetricsResponse, type Middleware, type MiddlewareContext, MiddlewareManager, type MiddlewareOptions, type MiddlewareRequest, type MiddlewareResponse, type NextFunction, type Organization, OrganizationResource, type PaginatedResponse, type Plan, type PlanCreateParams, type PlanFeature, type PlanListParams, type PlanListResponse, type PlanUpdateParams, type PlanUsageCharge, type RateLimitOptions, type RequestOptions, type Review, type ReviewCreateParams, type ReviewUpdateParams, type SocialProfile, type SocialProfileType, type Subscription, type SubscriptionListParams, type SubscriptionListResponse, SubscriptionsResource, type Task, type TaskCreateParams, type TaskListParams, type TaskListResponse, type TaskPriority, type TaskStatus, type TaskUpdateParams, TasksResource, type Ticket, type TicketContactData, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TicketMessage, type TicketMessageCreateParams, type TicketMessageUpdateParams, type TicketUpdateParams, TicketsResource, type TimelineEvent, type TimelineListParams, type TimelineListResponse, type Transaction, type TransactionListParams, type TransactionListResponse, TransactionsResource, type UsageEvent, type UsageEventCreateData, type UsageEventCreateParams, type UsageEventCreateResponse, type UsageEventListParams, type UsageEventListResponse, type UsageEventMetricsParams, UsageEventsResource, type UsageMetric, type UsageMetricCreateParams, type UsageMetricParams, type UsageMetricUpdateParams, type User, type UserListParams, type UserListResponse, UsersResource, type Webhook, type WebhookCreateParams, type WebhookFilter, type WebhookListResponse, type WebhookTopic, type WebhookUpdateParams, WebhooksResource, createAuthRefreshMiddleware, createRateLimitMiddleware };
+export { type AccountOwner, type AccountOwnersListResponse, type Affiliate, type AffiliateCommission, type AffiliateCommissionListParams, type AffiliateCommissionListResponse, AffiliateCommissionsResource, type AffiliateListParams, type AffiliateListResponse, type AffiliatePayout, type AffiliatePayoutListParams, type AffiliatePayoutListResponse, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramCreateParams, type AffiliateProgramUpdateParams, AffiliateProgramsResource, type AffiliateReferral, type AffiliateReferralListParams, type AffiliateReferralListResponse, AffiliateReferralsResource, type AffiliateUpdateParams, AffiliatesResource, type Agent, type AgentCreateParams, type AgentListResponse, type AgentResponse, AgentsResource, type App, type AppEvent, type AppEventListParams, type AppEventListResponse, type AppInstallation, type AppInstallationParams, type AppListParams, AppsResource, type AuthRefreshOptions, BaseResource, type Channel, type ChannelCreateParams, type ChannelListParams, ChannelsResource, type Charge, type ChargeListParams, type ChargeListResponse, ChargesResource, CompaniesResource, type Company, type CompanyCreateParams, type CompanyListParams, type CompanyListResponse, type CompanyUpdateParams, type Contact, type ContactCreateParams, type ContactCreateResponse, type ContactEntity, type ContactListParams, type ContactListResponse, type ContactUpdateParams, ContactsResource, type CustomDataDeleteParams, type CustomDataGetParams, CustomDataResource, type CustomDataResourceType, type CustomDataResponse, type CustomDataSetParams, type CustomField, type CustomFieldCreateParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerEntity, type CustomerListParams, type CustomerListResponse, type CustomerRetrieveParams, type CustomerSegment, type CustomerSegmentListParams, type CustomerSegmentListResponse, CustomerSegmentsResource, type CustomerUpdateParams, CustomersResource, type DateRangeType, type Deal, DealActivitiesResource, type DealActivity, type DealActivityCreateParams, type DealActivityUpdateParams, type DealContactInput, type DealCreateParams, type DealCustomerInput, type DealEvent, type DealEventCreateParams, type DealEventCreateResponse, type DealEventListResponse, type DealFlow, type DealFlowCreateParams, type DealFlowUpdateParams, DealFlowsResource, type DealListParams, type DealListResponse, type DealProgression, type DealStage, type DealUpdateParams, DealsResource, type DeleteResponse, type DocCollection, type DocCollectionCreateParams, type DocCollectionUpdateParams, type DocGroup, type DocGroupCreateParams, type DocGroupUpdateParams, type DocPage, type DocPageCreateParams, type DocPageListParams, type DocPageListResponse, type DocPageStatus, type DocPageUpdateParams, type DocTreeNode, type DocTreeResponse, DocsResource, EntitiesResource, type EntitiesSearchParams, type EntitiesSearchResponse, type Entity, type EntityType, type Feature, type FeatureCreateParams, type FeatureUpdateParams, type Flow, type FlowCreateParams, type FlowListParams, type FlowListResponse, type FlowStatus, type FlowUpdateParams, FlowsResource, type HttpMethod, type ListParams, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type MeResponse, type MessageAttachment, type MetricDataPoint, type MetricType, type MetricsBaseParams, type MetricsGetParams, MetricsResource, type MetricsResponse, type Middleware, type MiddlewareContext, MiddlewareManager, type MiddlewareOptions, type MiddlewareRequest, type MiddlewareResponse, type NextFunction, type Organization, OrganizationResource, type PaginatedResponse, type Plan, type PlanCreateParams, type PlanFeature, type PlanListParams, type PlanListResponse, type PlanUpdateParams, type PlanUsageCharge, type RateLimitOptions, type RequestOptions, type Review, type ReviewCreateParams, type ReviewUpdateParams, type SocialProfile, type SocialProfileType, type Subscription, type SubscriptionListParams, type SubscriptionListResponse, SubscriptionsResource, type Task, type TaskCreateParams, type TaskListParams, type TaskListResponse, type TaskPriority, type TaskStatus, type TaskUpdateParams, type TaskUpdateResponse, TasksResource, type Ticket, type TicketContactData, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TicketMessage, type TicketMessageCreateParams, type TicketMessageUpdateParams, type TicketUpdateParams, TicketsResource, type TimelineEvent, type TimelineListParams, type TimelineListResponse, type TodoItem, type TodoItemCreateParams, type TodoItemInput, type TodoItemListResponse, type TodoItemUpdateParams, type Transaction, type TransactionListParams, type TransactionListResponse, TransactionsResource, type UsageEvent, type UsageEventCreateData, type UsageEventCreateParams, type UsageEventCreateResponse, type UsageEventListParams, type UsageEventListResponse, type UsageEventMetricsParams, UsageEventsResource, type UsageMetric, type UsageMetricCreateParams, type UsageMetricParams, type UsageMetricUpdateParams, type User, type UserListParams, type UserListResponse, UsersResource, type Webhook, type WebhookCreateParams, type WebhookFilter, type WebhookListResponse, type WebhookTopic, type WebhookUpdateParams, WebhooksResource, createAuthRefreshMiddleware, createRateLimitMiddleware };

package/dist/index.d.ts

@@ -403,6 +403,14 @@ interface ContactCreateParams {
  */
 interface ContactUpdateParams extends Partial<ContactCreateParams> {
 }
+/**
+ * Response from creating/upserting a contact
+ */
+interface ContactCreateResponse {
+    contact: Contact;
+    /** True if a new contact was created, false if an existing contact was updated */
+    created: boolean;
+}
 
 /**
  * Subscription entity
@@ -1815,11 +1823,30 @@ interface AgentResponse {
 /**
  * Task status
  */
-type TaskStatus = 'pending' | 'in_progress' | 'completed' | 'canceled';
+type TaskStatus = 'new' | 'in_progress' | 'complete';
 /**
  * Task priority
  */
-type TaskPriority = 'low' | 'medium' | 'high' | 'urgent';
+type TaskPriority = 'low' | 'medium' | 'high';
+/**
+ * Task todo item entity
+ */
+interface TodoItem {
+    id: string;
+    content: string;
+    completed: boolean;
+    completedAt?: string | null;
+    displayOrder: number;
+}
+/**
+ * Parameters for creating a todo item (used in task creation/update)
+ */
+interface TodoItemInput {
+    id?: string;
+    content: string;
+    completed?: boolean;
+    displayOrder?: number;
+}
 /**
  * Task entity
  */
@@ -1831,6 +1858,7 @@ interface Task {
     priority: TaskPriority;
     status: TaskStatus;
     dueDate?: string;
+    completedAt?: string | null;
     assigneeId?: string;
     customerId?: string;
     contactId?: string;
@@ -1844,19 +1872,33 @@ interface Task {
         id: string;
         name?: string;
         email?: string;
-    };
+    } | null;
+    createdBy?: {
+        id: string;
+        name?: string;
+        email?: string;
+    } | null;
     customer?: {
         id: string;
         name?: string;
-    };
+    } | null;
     contact?: {
         id: string;
         name?: string;
-    };
+    } | null;
     deal?: {
         id: string;
         name?: string;
-    };
+        dealStage?: {
+            id: string;
+            name?: string;
+        } | null;
+    } | null;
+    dealActivity?: {
+        id: string;
+        name?: string;
+    } | null;
+    todoItems?: TodoItem[];
 }
 /**
  * Parameters for listing tasks
@@ -1891,12 +1933,59 @@ interface TaskCreateParams {
     dealActivityId?: string;
     appInstallationId?: string;
     tags?: string[];
+    todoItems?: TodoItemInput[];
 }
 /**
  * Parameters for updating a task
  */
 interface TaskUpdateParams extends Partial<TaskCreateParams> {
 }
+/**
+ * Response from listing todo items
+ */
+interface TodoItemListResponse {
+    items: TodoItem[];
+    total: number;
+}
+/**
+ * Deal progression information returned when a task update triggers deal stage change
+ */
+interface DealProgression {
+    dealId: string;
+    dealName: string;
+    previousStage: {
+        id: string;
+        name: string;
+    } | null;
+    nextStage: {
+        id: string;
+        name: string;
+    } | null;
+}
+/**
+ * Response from updating a task
+ */
+interface TaskUpdateResponse {
+    task: Task;
+    dealProgressed: boolean;
+    dealProgression: DealProgression | null;
+}
+/**
+ * Parameters for creating a todo item via the dedicated endpoint
+ */
+interface TodoItemCreateParams {
+    content: string;
+    completed?: boolean;
+    displayOrder?: number;
+}
+/**
+ * Parameters for updating a todo item
+ */
+interface TodoItemUpdateParams {
+    content?: string;
+    completed?: boolean;
+    displayOrder?: number;
+}
 
 /**
  * Company entity
@@ -2225,11 +2314,12 @@ declare class ContactsResource extends BaseResource {
         contact: Contact;
     }>;
     /**
-     * Create a new contact
+     * Create or update a contact.
+     * If a contact with the same email exists in the organization, it will be updated.
+     * Otherwise, a new contact will be created.
+     * @returns The contact and a boolean indicating if it was newly created
      */
-    create(data: ContactCreateParams): Promise<{
-        contact: Contact;
-    }>;
+    create(data: ContactCreateParams): Promise<ContactCreateResponse>;
     /**
      * Update an existing contact
      */
@@ -2771,19 +2861,41 @@ declare class TasksResource extends BaseResource {
     /**
      * Create a new task
      */
-    create(data: TaskCreateParams): Promise<{
-        task: Task;
-    }>;
+    create(data: TaskCreateParams): Promise<Task>;
     /**
      * Update an existing task
      */
-    update(taskId: string, data: TaskUpdateParams): Promise<{
-        task: Task;
-    }>;
+    update(taskId: string, data: TaskUpdateParams): Promise<TaskUpdateResponse>;
     /**
      * Delete a task
      */
     del(taskId: string): Promise<DeleteResponse>;
+    /**
+     * List todo items for a task
+     */
+    listTodoItems(taskId: string): Promise<TodoItemListResponse>;
+    /**
+     * Retrieve a single todo item
+     */
+    retrieveTodoItem(taskId: string, itemId: string): Promise<{
+        item: TodoItem;
+    }>;
+    /**
+     * Create a todo item for a task
+     */
+    createTodoItem(taskId: string, data: TodoItemCreateParams): Promise<{
+        item: TodoItem;
+    }>;
+    /**
+     * Update a todo item
+     */
+    updateTodoItem(taskId: string, itemId: string, data: TodoItemUpdateParams): Promise<{
+        item: TodoItem;
+    }>;
+    /**
+     * Delete a todo item
+     */
+    deleteTodoItem(taskId: string, itemId: string): Promise<DeleteResponse>;
 }
 
 /**
@@ -3654,4 +3766,4 @@ interface RateLimitOptions {
  */
 declare function createRateLimitMiddleware(options?: RateLimitOptions): Middleware;
 
-export { type AccountOwner, type AccountOwnersListResponse, type Affiliate, type AffiliateCommission, type AffiliateCommissionListParams, type AffiliateCommissionListResponse, AffiliateCommissionsResource, type AffiliateListParams, type AffiliateListResponse, type AffiliatePayout, type AffiliatePayoutListParams, type AffiliatePayoutListResponse, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramCreateParams, type AffiliateProgramUpdateParams, AffiliateProgramsResource, type AffiliateReferral, type AffiliateReferralListParams, type AffiliateReferralListResponse, AffiliateReferralsResource, type AffiliateUpdateParams, AffiliatesResource, type Agent, type AgentCreateParams, type AgentListResponse, type AgentResponse, AgentsResource, type App, type AppEvent, type AppEventListParams, type AppEventListResponse, type AppInstallation, type AppInstallationParams, type AppListParams, AppsResource, type AuthRefreshOptions, BaseResource, type Channel, type ChannelCreateParams, type ChannelListParams, ChannelsResource, type Charge, type ChargeListParams, type ChargeListResponse, ChargesResource, CompaniesResource, type Company, type CompanyCreateParams, type CompanyListParams, type CompanyListResponse, type CompanyUpdateParams, type Contact, type ContactCreateParams, type ContactEntity, type ContactListParams, type ContactListResponse, type ContactUpdateParams, ContactsResource, type CustomDataDeleteParams, type CustomDataGetParams, CustomDataResource, type CustomDataResourceType, type CustomDataResponse, type CustomDataSetParams, type CustomField, type CustomFieldCreateParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerEntity, type CustomerListParams, type CustomerListResponse, type CustomerRetrieveParams, type CustomerSegment, type CustomerSegmentListParams, type CustomerSegmentListResponse, CustomerSegmentsResource, type CustomerUpdateParams, CustomersResource, type DateRangeType, type Deal, DealActivitiesResource, type DealActivity, type DealActivityCreateParams, type DealActivityUpdateParams, type DealContactInput, type DealCreateParams, type DealCustomerInput, type DealEvent, type DealEventCreateParams, type DealEventCreateResponse, type DealEventListResponse, type DealFlow, type DealFlowCreateParams, type DealFlowUpdateParams, DealFlowsResource, type DealListParams, type DealListResponse, type DealStage, type DealUpdateParams, DealsResource, type DeleteResponse, type DocCollection, type DocCollectionCreateParams, type DocCollectionUpdateParams, type DocGroup, type DocGroupCreateParams, type DocGroupUpdateParams, type DocPage, type DocPageCreateParams, type DocPageListParams, type DocPageListResponse, type DocPageStatus, type DocPageUpdateParams, type DocTreeNode, type DocTreeResponse, DocsResource, EntitiesResource, type EntitiesSearchParams, type EntitiesSearchResponse, type Entity, type EntityType, type Feature, type FeatureCreateParams, type FeatureUpdateParams, type Flow, type FlowCreateParams, type FlowListParams, type FlowListResponse, type FlowStatus, type FlowUpdateParams, FlowsResource, type HttpMethod, type ListParams, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type MeResponse, type MessageAttachment, type MetricDataPoint, type MetricType, type MetricsBaseParams, type MetricsGetParams, MetricsResource, type MetricsResponse, type Middleware, type MiddlewareContext, MiddlewareManager, type MiddlewareOptions, type MiddlewareRequest, type MiddlewareResponse, type NextFunction, type Organization, OrganizationResource, type PaginatedResponse, type Plan, type PlanCreateParams, type PlanFeature, type PlanListParams, type PlanListResponse, type PlanUpdateParams, type PlanUsageCharge, type RateLimitOptions, type RequestOptions, type Review, type ReviewCreateParams, type ReviewUpdateParams, type SocialProfile, type SocialProfileType, type Subscription, type SubscriptionListParams, type SubscriptionListResponse, SubscriptionsResource, type Task, type TaskCreateParams, type TaskListParams, type TaskListResponse, type TaskPriority, type TaskStatus, type TaskUpdateParams, TasksResource, type Ticket, type TicketContactData, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TicketMessage, type TicketMessageCreateParams, type TicketMessageUpdateParams, type TicketUpdateParams, TicketsResource, type TimelineEvent, type TimelineListParams, type TimelineListResponse, type Transaction, type TransactionListParams, type TransactionListResponse, TransactionsResource, type UsageEvent, type UsageEventCreateData, type UsageEventCreateParams, type UsageEventCreateResponse, type UsageEventListParams, type UsageEventListResponse, type UsageEventMetricsParams, UsageEventsResource, type UsageMetric, type UsageMetricCreateParams, type UsageMetricParams, type UsageMetricUpdateParams, type User, type UserListParams, type UserListResponse, UsersResource, type Webhook, type WebhookCreateParams, type WebhookFilter, type WebhookListResponse, type WebhookTopic, type WebhookUpdateParams, WebhooksResource, createAuthRefreshMiddleware, createRateLimitMiddleware };
+export { type AccountOwner, type AccountOwnersListResponse, type Affiliate, type AffiliateCommission, type AffiliateCommissionListParams, type AffiliateCommissionListResponse, AffiliateCommissionsResource, type AffiliateListParams, type AffiliateListResponse, type AffiliatePayout, type AffiliatePayoutListParams, type AffiliatePayoutListResponse, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramCreateParams, type AffiliateProgramUpdateParams, AffiliateProgramsResource, type AffiliateReferral, type AffiliateReferralListParams, type AffiliateReferralListResponse, AffiliateReferralsResource, type AffiliateUpdateParams, AffiliatesResource, type Agent, type AgentCreateParams, type AgentListResponse, type AgentResponse, AgentsResource, type App, type AppEvent, type AppEventListParams, type AppEventListResponse, type AppInstallation, type AppInstallationParams, type AppListParams, AppsResource, type AuthRefreshOptions, BaseResource, type Channel, type ChannelCreateParams, type ChannelListParams, ChannelsResource, type Charge, type ChargeListParams, type ChargeListResponse, ChargesResource, CompaniesResource, type Company, type CompanyCreateParams, type CompanyListParams, type CompanyListResponse, type CompanyUpdateParams, type Contact, type ContactCreateParams, type ContactCreateResponse, type ContactEntity, type ContactListParams, type ContactListResponse, type ContactUpdateParams, ContactsResource, type CustomDataDeleteParams, type CustomDataGetParams, CustomDataResource, type CustomDataResourceType, type CustomDataResponse, type CustomDataSetParams, type CustomField, type CustomFieldCreateParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerEntity, type CustomerListParams, type CustomerListResponse, type CustomerRetrieveParams, type CustomerSegment, type CustomerSegmentListParams, type CustomerSegmentListResponse, CustomerSegmentsResource, type CustomerUpdateParams, CustomersResource, type DateRangeType, type Deal, DealActivitiesResource, type DealActivity, type DealActivityCreateParams, type DealActivityUpdateParams, type DealContactInput, type DealCreateParams, type DealCustomerInput, type DealEvent, type DealEventCreateParams, type DealEventCreateResponse, type DealEventListResponse, type DealFlow, type DealFlowCreateParams, type DealFlowUpdateParams, DealFlowsResource, type DealListParams, type DealListResponse, type DealProgression, type DealStage, type DealUpdateParams, DealsResource, type DeleteResponse, type DocCollection, type DocCollectionCreateParams, type DocCollectionUpdateParams, type DocGroup, type DocGroupCreateParams, type DocGroupUpdateParams, type DocPage, type DocPageCreateParams, type DocPageListParams, type DocPageListResponse, type DocPageStatus, type DocPageUpdateParams, type DocTreeNode, type DocTreeResponse, DocsResource, EntitiesResource, type EntitiesSearchParams, type EntitiesSearchResponse, type Entity, type EntityType, type Feature, type FeatureCreateParams, type FeatureUpdateParams, type Flow, type FlowCreateParams, type FlowListParams, type FlowListResponse, type FlowStatus, type FlowUpdateParams, FlowsResource, type HttpMethod, type ListParams, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type MeResponse, type MessageAttachment, type MetricDataPoint, type MetricType, type MetricsBaseParams, type MetricsGetParams, MetricsResource, type MetricsResponse, type Middleware, type MiddlewareContext, MiddlewareManager, type MiddlewareOptions, type MiddlewareRequest, type MiddlewareResponse, type NextFunction, type Organization, OrganizationResource, type PaginatedResponse, type Plan, type PlanCreateParams, type PlanFeature, type PlanListParams, type PlanListResponse, type PlanUpdateParams, type PlanUsageCharge, type RateLimitOptions, type RequestOptions, type Review, type ReviewCreateParams, type ReviewUpdateParams, type SocialProfile, type SocialProfileType, type Subscription, type SubscriptionListParams, type SubscriptionListResponse, SubscriptionsResource, type Task, type TaskCreateParams, type TaskListParams, type TaskListResponse, type TaskPriority, type TaskStatus, type TaskUpdateParams, type TaskUpdateResponse, TasksResource, type Ticket, type TicketContactData, type TicketCreateParams, type TicketListParams, type TicketListResponse, type TicketMessage, type TicketMessageCreateParams, type TicketMessageUpdateParams, type TicketUpdateParams, TicketsResource, type TimelineEvent, type TimelineListParams, type TimelineListResponse, type TodoItem, type TodoItemCreateParams, type TodoItemInput, type TodoItemListResponse, type TodoItemUpdateParams, type Transaction, type TransactionListParams, type TransactionListResponse, TransactionsResource, type UsageEvent, type UsageEventCreateData, type UsageEventCreateParams, type UsageEventCreateResponse, type UsageEventListParams, type UsageEventListResponse, type UsageEventMetricsParams, UsageEventsResource, type UsageMetric, type UsageMetricCreateParams, type UsageMetricParams, type UsageMetricUpdateParams, type User, type UserListParams, type UserListResponse, UsersResource, type Webhook, type WebhookCreateParams, type WebhookFilter, type WebhookListResponse, type WebhookTopic, type WebhookUpdateParams, WebhooksResource, createAuthRefreshMiddleware, createRateLimitMiddleware };

package/dist/index.js

@@ -423,7 +423,10 @@ var ContactsResource = class extends BaseResource {
     return this.get(`/contacts/${contactId}`);
   }
   /**
-   * Create a new contact
+   * Create or update a contact.
+   * If a contact with the same email exists in the organization, it will be updated.
+   * Otherwise, a new contact will be created.
+   * @returns The contact and a boolean indicating if it was newly created
    */
   async create(data) {
     return this.post("/contacts", data);
@@ -1155,6 +1158,40 @@ var TasksResource = class extends BaseResource {
   async del(taskId) {
     return this._delete(`/tasks/${taskId}`);
   }
+  // ========== Todo Items ==========
+  /**
+   * List todo items for a task
+   */
+  async listTodoItems(taskId) {
+    return this.get(`/tasks/${taskId}/todo-items`);
+  }
+  /**
+   * Retrieve a single todo item
+   */
+  async retrieveTodoItem(taskId, itemId) {
+    return this.get(`/tasks/${taskId}/todo-items/${itemId}`);
+  }
+  /**
+   * Create a todo item for a task
+   */
+  async createTodoItem(taskId, data) {
+    return this.post(`/tasks/${taskId}/todo-items`, data);
+  }
+  /**
+   * Update a todo item
+   */
+  async updateTodoItem(taskId, itemId, data) {
+    return this.put(
+      `/tasks/${taskId}/todo-items/${itemId}`,
+      data
+    );
+  }
+  /**
+   * Delete a todo item
+   */
+  async deleteTodoItem(taskId, itemId) {
+    return this._delete(`/tasks/${taskId}/todo-items/${itemId}`);
+  }
 };
 
 // src/resources/webhooks.ts

package/dist/index.mjs

@@ -357,7 +357,10 @@ var ContactsResource = class extends BaseResource {
     return this.get(`/contacts/${contactId}`);
   }
   /**
-   * Create a new contact
+   * Create or update a contact.
+   * If a contact with the same email exists in the organization, it will be updated.
+   * Otherwise, a new contact will be created.
+   * @returns The contact and a boolean indicating if it was newly created
    */
   async create(data) {
     return this.post("/contacts", data);
@@ -1089,6 +1092,40 @@ var TasksResource = class extends BaseResource {
   async del(taskId) {
     return this._delete(`/tasks/${taskId}`);
   }
+  // ========== Todo Items ==========
+  /**
+   * List todo items for a task
+   */
+  async listTodoItems(taskId) {
+    return this.get(`/tasks/${taskId}/todo-items`);
+  }
+  /**
+   * Retrieve a single todo item
+   */
+  async retrieveTodoItem(taskId, itemId) {
+    return this.get(`/tasks/${taskId}/todo-items/${itemId}`);
+  }
+  /**
+   * Create a todo item for a task
+   */
+  async createTodoItem(taskId, data) {
+    return this.post(`/tasks/${taskId}/todo-items`, data);
+  }
+  /**
+   * Update a todo item
+   */
+  async updateTodoItem(taskId, itemId, data) {
+    return this.put(
+      `/tasks/${taskId}/todo-items/${itemId}`,
+      data
+    );
+  }
+  /**
+   * Delete a todo item
+   */
+  async deleteTodoItem(taskId, itemId) {
+    return this._delete(`/tasks/${taskId}/todo-items/${itemId}`);
+  }
 };
 
 // src/resources/webhooks.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@heymantle/core-api-client",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "description": "TypeScript SDK for the Mantle Core API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",