@heymantle/core-api-client 0.1.7 → 0.1.9

package/dist/index.d.mts

@@ -362,6 +362,7 @@ interface Contact {
     customers?: Array<{
         id: string;
         name?: string;
+        label?: string;
     }>;
     createdAt: string;
     updatedAt: string;
@@ -393,7 +394,7 @@ interface ContactCreateParams {
     tags?: string[];
     customers?: string[] | Array<{
         id: string;
-        name?: string;
+        label?: string;
     }>;
     socialProfiles?: SocialProfile[];
 }
@@ -1058,6 +1059,76 @@ interface DealActivityCreateParams {
  */
 interface DealActivityUpdateParams extends Partial<Omit<DealActivityCreateParams, 'dealFlowId'>> {
 }
+/**
+ * Deal event entity
+ */
+interface DealEvent {
+    id: string;
+    type: string;
+    notes?: string;
+    occurredAt: string;
+    user?: {
+        id: string;
+        name?: string;
+        email?: string;
+    } | null;
+    previousDealStage?: {
+        id: string;
+        name: string;
+    } | null;
+    dealStage?: {
+        id: string;
+        name: string;
+    } | null;
+    dealActivity?: {
+        id: string;
+        name: string;
+    } | null;
+    task?: {
+        id: string;
+        name?: string;
+    } | null;
+    appEvent?: {
+        id: string;
+    } | null;
+}
+/**
+ * Parameters for creating a deal event
+ */
+interface DealEventCreateParams {
+    /** Notes or description for the event */
+    notes?: string;
+    /** Associated deal activity ID */
+    dealActivityId?: string;
+    /** Custom activity name (for ad-hoc activities not in the predefined list) */
+    customActivityName?: string;
+    /** Stage to progress the deal to */
+    dealStageId?: string;
+    /** Associated task ID */
+    taskId?: string;
+    /** Associated app event ID */
+    appEventId?: string;
+    /** When the event occurred (default: now) */
+    occurredAt?: string;
+    /** User ID who created the event (default: authenticated user) */
+    userId?: string;
+}
+/**
+ * Response from listing deal events
+ */
+interface DealEventListResponse extends PaginatedResponse {
+    events: DealEvent[];
+}
+/**
+ * Response from creating a deal event
+ */
+interface DealEventCreateResponse {
+    event: DealEvent;
+    /** Whether the deal was progressed to a new stage */
+    dealProgressed?: boolean;
+    /** The updated deal if progression occurred */
+    deal?: Deal;
+}
 
 /**
  * Ticket entity
@@ -2428,13 +2499,29 @@ declare class DealsResource extends BaseResource {
     /**
      * Get deal activity timeline
      */
-    getTimeline(dealId: string): Promise<TimelineListResponse>;
+    timeline(dealId: string): Promise<TimelineListResponse>;
     /**
-     * Get deal events
+     * List deal events
      */
-    getEvents(dealId: string): Promise<{
-        events: unknown[];
-    }>;
+    listEvents(dealId: string): Promise<DealEventListResponse>;
+    /**
+     * Create a deal event
+     *
+     * Creates an event on a deal. If `dealStageId` is provided, the deal will
+     * progress to that stage. If `dealActivityId` is provided and the activity
+     * is configured for a future stage, the deal will automatically progress.
+     *
+     * @example
+     * // Create a simple note
+     * await client.deals.createEvent('deal_123', { notes: 'Follow-up call completed' });
+     *
+     * // Create an event and progress to a new stage
+     * await client.deals.createEvent('deal_123', {
+     *   dealStageId: 'stage_456',
+     *   notes: 'Moving to negotiation phase',
+     * });
+     */
+    createEvent(dealId: string, data: DealEventCreateParams): Promise<DealEventCreateResponse>;
 }
 
 /**
@@ -3387,4 +3474,4 @@ interface AuthRefreshOptions {
  */
 declare function createAuthRefreshMiddleware(options: AuthRefreshOptions): 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 AgentListResponse, 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 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 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 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 };
+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 AgentListResponse, 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 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 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 };

package/dist/index.d.ts

@@ -362,6 +362,7 @@ interface Contact {
     customers?: Array<{
         id: string;
         name?: string;
+        label?: string;
     }>;
     createdAt: string;
     updatedAt: string;
@@ -393,7 +394,7 @@ interface ContactCreateParams {
     tags?: string[];
     customers?: string[] | Array<{
         id: string;
-        name?: string;
+        label?: string;
     }>;
     socialProfiles?: SocialProfile[];
 }
@@ -1058,6 +1059,76 @@ interface DealActivityCreateParams {
  */
 interface DealActivityUpdateParams extends Partial<Omit<DealActivityCreateParams, 'dealFlowId'>> {
 }
+/**
+ * Deal event entity
+ */
+interface DealEvent {
+    id: string;
+    type: string;
+    notes?: string;
+    occurredAt: string;
+    user?: {
+        id: string;
+        name?: string;
+        email?: string;
+    } | null;
+    previousDealStage?: {
+        id: string;
+        name: string;
+    } | null;
+    dealStage?: {
+        id: string;
+        name: string;
+    } | null;
+    dealActivity?: {
+        id: string;
+        name: string;
+    } | null;
+    task?: {
+        id: string;
+        name?: string;
+    } | null;
+    appEvent?: {
+        id: string;
+    } | null;
+}
+/**
+ * Parameters for creating a deal event
+ */
+interface DealEventCreateParams {
+    /** Notes or description for the event */
+    notes?: string;
+    /** Associated deal activity ID */
+    dealActivityId?: string;
+    /** Custom activity name (for ad-hoc activities not in the predefined list) */
+    customActivityName?: string;
+    /** Stage to progress the deal to */
+    dealStageId?: string;
+    /** Associated task ID */
+    taskId?: string;
+    /** Associated app event ID */
+    appEventId?: string;
+    /** When the event occurred (default: now) */
+    occurredAt?: string;
+    /** User ID who created the event (default: authenticated user) */
+    userId?: string;
+}
+/**
+ * Response from listing deal events
+ */
+interface DealEventListResponse extends PaginatedResponse {
+    events: DealEvent[];
+}
+/**
+ * Response from creating a deal event
+ */
+interface DealEventCreateResponse {
+    event: DealEvent;
+    /** Whether the deal was progressed to a new stage */
+    dealProgressed?: boolean;
+    /** The updated deal if progression occurred */
+    deal?: Deal;
+}
 
 /**
  * Ticket entity
@@ -2428,13 +2499,29 @@ declare class DealsResource extends BaseResource {
     /**
      * Get deal activity timeline
      */
-    getTimeline(dealId: string): Promise<TimelineListResponse>;
+    timeline(dealId: string): Promise<TimelineListResponse>;
     /**
-     * Get deal events
+     * List deal events
      */
-    getEvents(dealId: string): Promise<{
-        events: unknown[];
-    }>;
+    listEvents(dealId: string): Promise<DealEventListResponse>;
+    /**
+     * Create a deal event
+     *
+     * Creates an event on a deal. If `dealStageId` is provided, the deal will
+     * progress to that stage. If `dealActivityId` is provided and the activity
+     * is configured for a future stage, the deal will automatically progress.
+     *
+     * @example
+     * // Create a simple note
+     * await client.deals.createEvent('deal_123', { notes: 'Follow-up call completed' });
+     *
+     * // Create an event and progress to a new stage
+     * await client.deals.createEvent('deal_123', {
+     *   dealStageId: 'stage_456',
+     *   notes: 'Moving to negotiation phase',
+     * });
+     */
+    createEvent(dealId: string, data: DealEventCreateParams): Promise<DealEventCreateResponse>;
 }
 
 /**
@@ -3387,4 +3474,4 @@ interface AuthRefreshOptions {
  */
 declare function createAuthRefreshMiddleware(options: AuthRefreshOptions): 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 AgentListResponse, 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 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 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 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 };
+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 AgentListResponse, 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 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 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 };

package/dist/index.js

@@ -849,7 +849,7 @@ var DealsResource = class extends BaseResource {
   /**
    * Get deal activity timeline
    */
-  async getTimeline(dealId) {
+  async timeline(dealId) {
     const response = await this.get(
       `/deals/${dealId}/timeline`
     );
@@ -861,10 +861,39 @@ var DealsResource = class extends BaseResource {
     };
   }
   /**
-   * Get deal events
+   * List deal events
    */
-  async getEvents(dealId) {
-    return this.get(`/deals/${dealId}/events`);
+  async listEvents(dealId) {
+    const response = await this.get(
+      `/deals/${dealId}/events`
+    );
+    return {
+      events: response.events || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Create a deal event
+   *
+   * Creates an event on a deal. If `dealStageId` is provided, the deal will
+   * progress to that stage. If `dealActivityId` is provided and the activity
+   * is configured for a future stage, the deal will automatically progress.
+   *
+   * @example
+   * // Create a simple note
+   * await client.deals.createEvent('deal_123', { notes: 'Follow-up call completed' });
+   *
+   * // Create an event and progress to a new stage
+   * await client.deals.createEvent('deal_123', {
+   *   dealStageId: 'stage_456',
+   *   notes: 'Moving to negotiation phase',
+   * });
+   */
+  async createEvent(dealId, data) {
+    return this.post(`/deals/${dealId}/events`, data);
   }
 };
 

package/dist/index.mjs

@@ -785,7 +785,7 @@ var DealsResource = class extends BaseResource {
   /**
    * Get deal activity timeline
    */
-  async getTimeline(dealId) {
+  async timeline(dealId) {
     const response = await this.get(
       `/deals/${dealId}/timeline`
     );
@@ -797,10 +797,39 @@ var DealsResource = class extends BaseResource {
     };
   }
   /**
-   * Get deal events
+   * List deal events
    */
-  async getEvents(dealId) {
-    return this.get(`/deals/${dealId}/events`);
+  async listEvents(dealId) {
+    const response = await this.get(
+      `/deals/${dealId}/events`
+    );
+    return {
+      events: response.events || [],
+      hasNextPage: response.hasNextPage || false,
+      hasPreviousPage: response.hasPreviousPage || false,
+      total: response.total,
+      cursor: response.cursor
+    };
+  }
+  /**
+   * Create a deal event
+   *
+   * Creates an event on a deal. If `dealStageId` is provided, the deal will
+   * progress to that stage. If `dealActivityId` is provided and the activity
+   * is configured for a future stage, the deal will automatically progress.
+   *
+   * @example
+   * // Create a simple note
+   * await client.deals.createEvent('deal_123', { notes: 'Follow-up call completed' });
+   *
+   * // Create an event and progress to a new stage
+   * await client.deals.createEvent('deal_123', {
+   *   dealStageId: 'stage_456',
+   *   notes: 'Moving to negotiation phase',
+   * });
+   */
+  async createEvent(dealId, data) {
+    return this.post(`/deals/${dealId}/events`, data);
   }
 };
 

package/package.json

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