@heymantle/core-api-client 0.1.12 → 0.1.14

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
@@ -2196,6 +2204,129 @@ interface CustomDataDeleteParams {
     key: string;
 }
 
+/**
+ * User information attached to a timeline comment
+ */
+interface TimelineCommentUser {
+    id: string;
+    name?: string;
+    email?: string;
+}
+/**
+ * Attachment on a timeline comment
+ */
+interface TimelineCommentAttachment {
+    id: string;
+    fileName: string;
+    fileKey: string;
+    fileType: string;
+    fileSize: number;
+    url?: string;
+}
+/**
+ * Tagged user on a timeline comment
+ */
+interface TimelineCommentTaggedUser {
+    id: string;
+    userId: string;
+}
+/**
+ * Timeline comment entity
+ */
+interface TimelineComment {
+    id: string;
+    comment?: string;
+    commentHtml?: string;
+    appInstallationId?: string | null;
+    customerId?: string | null;
+    dealId?: string | null;
+    userId?: string | null;
+    user?: TimelineCommentUser | null;
+    originalCommentId?: string | null;
+    attachments?: TimelineCommentAttachment[];
+    taggedUsers?: TimelineCommentTaggedUser[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Parameters for listing timeline comments
+ */
+interface TimelineCommentListParams extends ListParams {
+    /** Filter by app installation ID */
+    appInstallationId?: string;
+    /** Filter by customer ID */
+    customerId?: string;
+    /** Filter by deal ID */
+    dealId?: string;
+}
+/**
+ * Response from listing timeline comments
+ */
+interface TimelineCommentListResponse extends PaginatedResponse {
+    timelineComments: TimelineComment[];
+}
+/**
+ * Attachment input for creating a timeline comment
+ */
+interface TimelineCommentAttachmentInput {
+    fileKey: string;
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+}
+/**
+ * Tagged user input for creating a timeline comment
+ */
+interface TimelineCommentTaggedUserInput {
+    id: string;
+}
+/**
+ * Parameters for creating a timeline comment
+ */
+interface TimelineCommentCreateParams {
+    /** App installation to associate with the comment */
+    appInstallationId?: string;
+    /** Customer to associate with the comment */
+    customerId?: string;
+    /** Deal to associate with the comment */
+    dealId?: string;
+    /** Plain text version of the comment */
+    comment?: string;
+    /** HTML content of the comment (required) */
+    commentHtml: string;
+    /** File attachments */
+    attachments?: TimelineCommentAttachmentInput[];
+    /** Users to tag in the comment */
+    taggedUsers?: TimelineCommentTaggedUserInput[];
+}
+/**
+ * Parameters for updating a timeline comment
+ */
+interface TimelineCommentUpdateParams {
+    /** Updated HTML content of the comment */
+    commentHtml: string;
+    /** App event ID to update (optional) */
+    appEventId?: string;
+    /** Deal event ID to update (optional) */
+    dealEventId?: string;
+}
+/**
+ * Response from creating a timeline comment
+ */
+interface TimelineCommentCreateResponse {
+    timelineComment: TimelineComment;
+    appEventId?: string | null;
+    dealEventId?: string | null;
+}
+/**
+ * Response from updating a timeline comment
+ */
+interface TimelineCommentUpdateResponse {
+    timelineComment: TimelineComment;
+    appEventId?: string | null;
+    dealEventId?: string | null;
+}
+
 /**
  * Resource for managing customers
  */
@@ -2306,11 +2437,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
      */
@@ -3414,6 +3546,34 @@ declare class CustomDataResource extends BaseResource {
     del(params: CustomDataDeleteParams): Promise<void>;
 }
 
+/**
+ * Resource for managing timeline comments
+ */
+declare class TimelineCommentsResource extends BaseResource {
+    /**
+     * List timeline comments with optional filters and pagination
+     */
+    list(params?: TimelineCommentListParams): Promise<TimelineCommentListResponse>;
+    /**
+     * Retrieve a single timeline comment by ID
+     */
+    retrieve(id: string): Promise<{
+        timelineComment: TimelineComment;
+    }>;
+    /**
+     * Create a new timeline comment
+     */
+    create(data: TimelineCommentCreateParams): Promise<TimelineCommentCreateResponse>;
+    /**
+     * Update an existing timeline comment
+     */
+    update(id: string, data: TimelineCommentUpdateParams): Promise<TimelineCommentUpdateResponse>;
+    /**
+     * Delete a timeline comment
+     */
+    del(id: string): Promise<DeleteResponse>;
+}
+
 /**
  * Mantle Core API Client
  *
@@ -3469,6 +3629,7 @@ declare class MantleCoreClient {
     readonly docs: DocsResource;
     readonly entities: EntitiesResource;
     readonly customData: CustomDataResource;
+    readonly timelineComments: TimelineCommentsResource;
     constructor(config: MantleCoreClientConfig);
     /**
      * Register a middleware function
@@ -3757,4 +3918,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 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 };
+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 TimelineComment, type TimelineCommentAttachment, type TimelineCommentAttachmentInput, type TimelineCommentCreateParams, type TimelineCommentCreateResponse, type TimelineCommentListParams, type TimelineCommentListResponse, type TimelineCommentTaggedUser, type TimelineCommentTaggedUserInput, type TimelineCommentUpdateParams, type TimelineCommentUpdateResponse, type TimelineCommentUser, 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
@@ -2196,6 +2204,129 @@ interface CustomDataDeleteParams {
     key: string;
 }
 
+/**
+ * User information attached to a timeline comment
+ */
+interface TimelineCommentUser {
+    id: string;
+    name?: string;
+    email?: string;
+}
+/**
+ * Attachment on a timeline comment
+ */
+interface TimelineCommentAttachment {
+    id: string;
+    fileName: string;
+    fileKey: string;
+    fileType: string;
+    fileSize: number;
+    url?: string;
+}
+/**
+ * Tagged user on a timeline comment
+ */
+interface TimelineCommentTaggedUser {
+    id: string;
+    userId: string;
+}
+/**
+ * Timeline comment entity
+ */
+interface TimelineComment {
+    id: string;
+    comment?: string;
+    commentHtml?: string;
+    appInstallationId?: string | null;
+    customerId?: string | null;
+    dealId?: string | null;
+    userId?: string | null;
+    user?: TimelineCommentUser | null;
+    originalCommentId?: string | null;
+    attachments?: TimelineCommentAttachment[];
+    taggedUsers?: TimelineCommentTaggedUser[];
+    createdAt: string;
+    updatedAt: string;
+}
+/**
+ * Parameters for listing timeline comments
+ */
+interface TimelineCommentListParams extends ListParams {
+    /** Filter by app installation ID */
+    appInstallationId?: string;
+    /** Filter by customer ID */
+    customerId?: string;
+    /** Filter by deal ID */
+    dealId?: string;
+}
+/**
+ * Response from listing timeline comments
+ */
+interface TimelineCommentListResponse extends PaginatedResponse {
+    timelineComments: TimelineComment[];
+}
+/**
+ * Attachment input for creating a timeline comment
+ */
+interface TimelineCommentAttachmentInput {
+    fileKey: string;
+    fileName: string;
+    fileType: string;
+    fileSize: number;
+}
+/**
+ * Tagged user input for creating a timeline comment
+ */
+interface TimelineCommentTaggedUserInput {
+    id: string;
+}
+/**
+ * Parameters for creating a timeline comment
+ */
+interface TimelineCommentCreateParams {
+    /** App installation to associate with the comment */
+    appInstallationId?: string;
+    /** Customer to associate with the comment */
+    customerId?: string;
+    /** Deal to associate with the comment */
+    dealId?: string;
+    /** Plain text version of the comment */
+    comment?: string;
+    /** HTML content of the comment (required) */
+    commentHtml: string;
+    /** File attachments */
+    attachments?: TimelineCommentAttachmentInput[];
+    /** Users to tag in the comment */
+    taggedUsers?: TimelineCommentTaggedUserInput[];
+}
+/**
+ * Parameters for updating a timeline comment
+ */
+interface TimelineCommentUpdateParams {
+    /** Updated HTML content of the comment */
+    commentHtml: string;
+    /** App event ID to update (optional) */
+    appEventId?: string;
+    /** Deal event ID to update (optional) */
+    dealEventId?: string;
+}
+/**
+ * Response from creating a timeline comment
+ */
+interface TimelineCommentCreateResponse {
+    timelineComment: TimelineComment;
+    appEventId?: string | null;
+    dealEventId?: string | null;
+}
+/**
+ * Response from updating a timeline comment
+ */
+interface TimelineCommentUpdateResponse {
+    timelineComment: TimelineComment;
+    appEventId?: string | null;
+    dealEventId?: string | null;
+}
+
 /**
  * Resource for managing customers
  */
@@ -2306,11 +2437,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
      */
@@ -3414,6 +3546,34 @@ declare class CustomDataResource extends BaseResource {
     del(params: CustomDataDeleteParams): Promise<void>;
 }
 
+/**
+ * Resource for managing timeline comments
+ */
+declare class TimelineCommentsResource extends BaseResource {
+    /**
+     * List timeline comments with optional filters and pagination
+     */
+    list(params?: TimelineCommentListParams): Promise<TimelineCommentListResponse>;
+    /**
+     * Retrieve a single timeline comment by ID
+     */
+    retrieve(id: string): Promise<{
+        timelineComment: TimelineComment;
+    }>;
+    /**
+     * Create a new timeline comment
+     */
+    create(data: TimelineCommentCreateParams): Promise<TimelineCommentCreateResponse>;
+    /**
+     * Update an existing timeline comment
+     */
+    update(id: string, data: TimelineCommentUpdateParams): Promise<TimelineCommentUpdateResponse>;
+    /**
+     * Delete a timeline comment
+     */
+    del(id: string): Promise<DeleteResponse>;
+}
+
 /**
  * Mantle Core API Client
  *
@@ -3469,6 +3629,7 @@ declare class MantleCoreClient {
     readonly docs: DocsResource;
     readonly entities: EntitiesResource;
     readonly customData: CustomDataResource;
+    readonly timelineComments: TimelineCommentsResource;
     constructor(config: MantleCoreClientConfig);
     /**
      * Register a middleware function
@@ -3757,4 +3918,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 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 };
+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 TimelineComment, type TimelineCommentAttachment, type TimelineCommentAttachmentInput, type TimelineCommentCreateParams, type TimelineCommentCreateResponse, type TimelineCommentListParams, type TimelineCommentListResponse, type TimelineCommentTaggedUser, type TimelineCommentTaggedUserInput, type TimelineCommentUpdateParams, type TimelineCommentUpdateResponse, type TimelineCommentUser, 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);
@@ -1961,6 +1964,55 @@ var CustomDataResource = class extends BaseResource {
   }
 };
 
+// src/resources/timelineComments.ts
+var TimelineCommentsResource = class extends BaseResource {
+  /**
+   * List timeline comments with optional filters and pagination
+   */
+  async list(params) {
+    const response = await this.get(
+      "/timeline_comments",
+      params
+    );
+    return {
+      timelineComments: response.timelineComments || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single timeline comment by ID
+   */
+  async retrieve(id) {
+    return this.get(
+      `/timeline_comments/${id}`
+    );
+  }
+  /**
+   * Create a new timeline comment
+   */
+  async create(data) {
+    return this.post("/timeline_comments", data);
+  }
+  /**
+   * Update an existing timeline comment
+   */
+  async update(id, data) {
+    return this.put(
+      `/timeline_comments/${id}`,
+      data
+    );
+  }
+  /**
+   * Delete a timeline comment
+   */
+  async del(id) {
+    return this._delete(`/timeline_comments/${id}`);
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -2013,6 +2065,7 @@ var MantleCoreClient = class {
     this.docs = new DocsResource(this);
     this.entities = new EntitiesResource(this);
     this.customData = new CustomDataResource(this);
+    this.timelineComments = new TimelineCommentsResource(this);
   }
   /**
    * Register a middleware function

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);
@@ -1895,6 +1898,55 @@ var CustomDataResource = class extends BaseResource {
   }
 };
 
+// src/resources/timelineComments.ts
+var TimelineCommentsResource = class extends BaseResource {
+  /**
+   * List timeline comments with optional filters and pagination
+   */
+  async list(params) {
+    const response = await this.get(
+      "/timeline_comments",
+      params
+    );
+    return {
+      timelineComments: response.timelineComments || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Retrieve a single timeline comment by ID
+   */
+  async retrieve(id) {
+    return this.get(
+      `/timeline_comments/${id}`
+    );
+  }
+  /**
+   * Create a new timeline comment
+   */
+  async create(data) {
+    return this.post("/timeline_comments", data);
+  }
+  /**
+   * Update an existing timeline comment
+   */
+  async update(id, data) {
+    return this.put(
+      `/timeline_comments/${id}`,
+      data
+    );
+  }
+  /**
+   * Delete a timeline comment
+   */
+  async del(id) {
+    return this._delete(`/timeline_comments/${id}`);
+  }
+};
+
 // src/client.ts
 var MantleCoreClient = class {
   constructor(config) {
@@ -1947,6 +1999,7 @@ var MantleCoreClient = class {
     this.docs = new DocsResource(this);
     this.entities = new EntitiesResource(this);
     this.customData = new CustomDataResource(this);
+    this.timelineComments = new TimelineCommentsResource(this);
   }
   /**
    * Register a middleware function

package/package.json

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