@heymantle/core-api-client 0.3.4 → 0.4.5

package/dist/index.d.mts

@@ -4887,6 +4887,8 @@ type paths = {
                     appIds?: string[];
                     /** @description The cursor to paginate from */
                     cursor?: components["parameters"]["cursor"];
+                    /** @description An optional custom domain to filter customers by (e.g. example.com). */
+                    domain?: string;
                     /** @description Email addresses to filter customers by. Can be passed as an array (email=test1@example.com&email=test2@example.com) or a single string. Returns customers with emails matching any of the provided addresses. */
                     email?: string[] | string;
                     /** @description The maximum date/time (ISO 8601) of the last update to the Customer */
@@ -4897,7 +4899,7 @@ type paths = {
                     page?: components["parameters"]["page"];
                     /** @description The search term to filter by */
                     search?: components["parameters"]["search"];
-                    /** @description An optional shopify shop domain to filter customers by. */
+                    /** @description An optional shopify shop domain (myshopify.com domain) to filter customers by. */
                     shopifyShopDomain?: string;
                     /** @description An optional shopify shop id to filter customers by. */
                     shopifyShopId?: string;
@@ -19406,6 +19408,15 @@ type components = {
     pathItems: never;
 };
 
+/**
+ * Result returned by the refreshAccessToken callback.
+ */
+interface TokenRefreshResult {
+    /** The new access token */
+    accessToken: string;
+    /** When the new token expires. Used for preemptive refresh on subsequent requests. */
+    expiresAt?: Date;
+}
 /**
  * Configuration for the MantleCoreClient
  */
@@ -19416,6 +19427,21 @@ interface MantleCoreClientConfig {
     apiKey?: string;
     /** OAuth access token for authentication */
     accessToken?: string;
+    /**
+     * When the access token expires. If set, the client will proactively
+     * call refreshAccessToken before sending a request with an expired token.
+     */
+    accessTokenExpiresAt?: Date;
+    /**
+     * Callback to obtain a fresh access token. Called automatically when:
+     * - accessTokenExpiresAt is in the past (preemptive, before the request)
+     * - A 401 response is received for an expired/revoked token (reactive)
+     *
+     * The callback owns the full refresh lifecycle: look up the refresh token,
+     * call the auth server, persist the new credentials, and return the new
+     * access token. Concurrent requests will share a single in-flight refresh.
+     */
+    refreshAccessToken?: () => Promise<TokenRefreshResult>;
     /** Request timeout in milliseconds. Defaults to 30000 */
     timeout?: number;
     /** openapi-fetch middleware to register on instantiation */
@@ -27489,6 +27515,9 @@ declare class MantleCoreClient {
     readonly _api: Client<paths>;
     private apiKey?;
     private accessToken?;
+    private accessTokenExpiresAt?;
+    private refreshAccessToken?;
+    private refreshPromise?;
     readonly affiliateCommissions: AffiliateCommissionsResource;
     readonly affiliatePayouts: AffiliatePayoutsResource;
     readonly affiliatePrograms: AffiliateProgramsResource;
@@ -27547,7 +27576,17 @@ declare class MantleCoreClient {
     updateAuth(credentials: {
         apiKey?: string;
         accessToken?: string;
+        accessTokenExpiresAt?: Date;
     }): void;
+    /**
+     * Check if the access token is expired (with a 30-second buffer).
+     */
+    private isTokenExpired;
+    /**
+     * Execute a token refresh, deduplicating concurrent calls.
+     * All concurrent requests will await the same in-flight refresh promise.
+     */
+    private doRefresh;
 }
 
 type AccountOwner = components['schemas']['AccountOwner'];
@@ -27729,7 +27768,9 @@ declare class MantleAPIError extends Error {
  * Authentication failed (401)
  */
 declare class MantleAuthenticationError extends MantleAPIError {
-    constructor(message?: string);
+    /** Whether the token has expired (as opposed to being invalid/malformed) */
+    readonly isExpired: boolean;
+    constructor(message?: string, isExpired?: boolean);
 }
 /**
  * Permission denied (403)
@@ -27757,48 +27798,6 @@ declare class MantleRateLimitError extends MantleAPIError {
     constructor(message?: string, retryAfter?: number);
 }
 
-/**
- * Options for the auth refresh middleware
- */
-interface AuthRefreshOptions {
-    /**
-     * Function to refresh the access token.
-     * Should return the new access token.
-     */
-    refreshToken: () => Promise<string>;
-    /**
-     * Callback invoked when the client instance's auth should be updated.
-     * Receives the new token string.
-     */
-    updateAuth: (newToken: string) => void;
-    /** Optional callback when refresh succeeds */
-    onRefreshSuccess?: (newToken: string) => void;
-    /** Optional callback when refresh fails */
-    onRefreshFailed?: (error: Error) => void;
-    /** Maximum refresh attempts per request (default: 1) */
-    maxRefreshAttempts?: number;
-}
-/**
- * Creates an openapi-fetch middleware that automatically refreshes access
- * tokens on 401 responses.
- *
- * @example
- * ```typescript
- * const client = new MantleCoreClient({ accessToken: 'initial-token' });
- *
- * client.use(createAuthRefreshMiddleware({
- *   refreshToken: async () => {
- *     const res = await fetch('/refresh', { method: 'POST' });
- *     const data = await res.json();
- *     return data.accessToken;
- *   },
- *   updateAuth: (newToken) => client.updateAuth({ accessToken: newToken }),
- *   onRefreshSuccess: (newToken) => localStorage.setItem('accessToken', newToken),
- * }));
- * ```
- */
-declare function createAuthRefreshMiddleware(options: AuthRefreshOptions): Middleware;
-
 /**
  * Options for the rate limit middleware
  */
@@ -27837,4 +27836,4 @@ interface RateLimitOptions {
  */
 declare function createRateLimitMiddleware(options?: RateLimitOptions): Middleware;
 
-export { type AccountOwner, type AccountOwnerType, type Action, type ActiveSubscriptionsResponse, type Affiliate, type AffiliateAttributionWebhook, type AffiliateCommission, AffiliateCommissionsResource, type AffiliateMembershipWebhook, type AffiliatePayout, type AffiliatePayoutWebhook, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramGroup, type AffiliateProgramMembership, type AffiliateProgramWebhook, AffiliateProgramsResource, type AffiliateReferral, AffiliateReferralsResource, type AffiliateRules, type AffiliateRulesWebhook, type AffiliateWebhook, AffiliatesResource, type Agent, type AgentRun, AgentsResource, AiAgentRunsResource, type App, type AppChargeWebhook, type AppEvent, type AppInstallation, type AppInstallationWebhook, type AppWebhook, AppsResource, type AuthRefreshOptions, type BaseCustomerWebhook, BaseResource, ChannelsResource, type Charge, ChargesResource, type Checklist, type ChecklistStep, CompaniesResource, type Company, type Contact, type ContactWebhook, ContactsResource, type CursorPagination, CustomDataResource, type CustomField, type CustomFieldDefaultValue, type Customer, type CustomerContact, type CustomerContactWebhook, type CustomerSegment, CustomerSegmentsResource, type CustomerWebhook, type CustomerWithoutSubscriptionWebhook, CustomersResource, type Deal, type DealAcquirer, DealActivitiesResource, type DealActivity, type DealAffiliate, type DealApp, type DealContact, type DealCustomData, type DealCustomer, type DealEvent, type DealFlow, type DealFlowAffiliate, type DealFlowDefaultSource, type DealFlowPartnership, type DealFlowStage, type DealFlowUser, DealFlowsResource, type DealOwner, type DealPartnership, type DealPlan, type DealStage, DealsResource, type DetailedAffiliate, type DetailedFlow, type DocsCollection, type DocsCollectionResponse, type DocsGenerateJobResponse, type DocsGenerateStatusCompleted, type DocsGenerateStatusFailed, type DocsGenerateStatusPending, type DocsGroup, type DocsGroupResponse, type DocsPage, type DocsPageResponse, type DocsPageSummary, type DocsRepository, DocsResource, type EmailCampaign, type EmailDelivery, type EmailDeliveryStats, type EmailLayout, type EmailPreview, type EmailSender, type EmailUnsubscribeGroup, type EmailUnsubscribeGroupMember, EmailUnsubscribeGroupsResource, EntitiesResource, type EventWebhook, type ExtensionUninstallPayload, type ExtensionWebhook, type Feature, type Flow, type FlowActionRun, FlowExtensionsResource, FlowsResource, type InvalidTokenError, type Invoice, type InvoiceWebhook, JournalEntriesResource, type JournalEntry, type JournalEntryApp, type JournalEntryFile, type List, ListsResource, type LogoChurnResponse, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type Meeting, type MeetingAttendee, type MeetingAttendeeRef, type MeetingContactRef, type MeetingCustomer, type MeetingDeal, type MeetingPermission, type MeetingTaskSuggestion, type MeetingTranscript, type MeetingUser, type MeetingUtterance, MeetingsResource, MetricsResource, type MissingScopesError, type MrrResponse, type NetInstallsResponse, type NetRevenueResponse, type NetRevenueRetentionResponse, type Organization, OrganizationResource, type Pagination, type PayoutResponse, type Plan, type PlanFeature, type PlanFeatureWebhook, type PlanUsageChargeWebhook, type PlanWebhook, type PredictedLtvResponse, type RateLimitOptions, type RevenueRetentionResponse, type Review, type ReviewWebhook, type StandardMetricResponse, type Subscription, type SubscriptionWebhook, SubscriptionsResource, type SyncedEmail, type SyncedEmailContact, type SyncedEmailCustomer, type SyncedEmailDeal, type SyncedEmailMessage, type SyncedEmailUser, SyncedEmailsResource, type Task, type TaskComment, type TaskTodoItem, TasksResource, type ThreadEventType, type ThreadMessageWebhook, type ThreadWebhook, type Ticket, type TicketAgent, type TicketApp, type TicketAttachment, type TicketChannel, type TicketContact, type TicketCustomer, type TicketEvent, type TicketLoop, type TicketMessage, TicketsResource, type TimeSeriesDataPoint, type TimelineComment, TimelineCommentsResource, type Transaction, type TransactionWebhook, TransactionsResource, type Trigger, type UninstallEventWebhook, type UsageEvent, type UsageEventResponse, UsageEventsResource, type UsageMetric, type UsageMetricResponse, type User, UsersResource, type Webhook, WebhooksResource, type components, createAuthRefreshMiddleware, createRateLimitMiddleware, type paths };
+export { type AccountOwner, type AccountOwnerType, type Action, type ActiveSubscriptionsResponse, type Affiliate, type AffiliateAttributionWebhook, type AffiliateCommission, AffiliateCommissionsResource, type AffiliateMembershipWebhook, type AffiliatePayout, type AffiliatePayoutWebhook, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramGroup, type AffiliateProgramMembership, type AffiliateProgramWebhook, AffiliateProgramsResource, type AffiliateReferral, AffiliateReferralsResource, type AffiliateRules, type AffiliateRulesWebhook, type AffiliateWebhook, AffiliatesResource, type Agent, type AgentRun, AgentsResource, AiAgentRunsResource, type App, type AppChargeWebhook, type AppEvent, type AppInstallation, type AppInstallationWebhook, type AppWebhook, AppsResource, type BaseCustomerWebhook, BaseResource, ChannelsResource, type Charge, ChargesResource, type Checklist, type ChecklistStep, CompaniesResource, type Company, type Contact, type ContactWebhook, ContactsResource, type CursorPagination, CustomDataResource, type CustomField, type CustomFieldDefaultValue, type Customer, type CustomerContact, type CustomerContactWebhook, type CustomerSegment, CustomerSegmentsResource, type CustomerWebhook, type CustomerWithoutSubscriptionWebhook, CustomersResource, type Deal, type DealAcquirer, DealActivitiesResource, type DealActivity, type DealAffiliate, type DealApp, type DealContact, type DealCustomData, type DealCustomer, type DealEvent, type DealFlow, type DealFlowAffiliate, type DealFlowDefaultSource, type DealFlowPartnership, type DealFlowStage, type DealFlowUser, DealFlowsResource, type DealOwner, type DealPartnership, type DealPlan, type DealStage, DealsResource, type DetailedAffiliate, type DetailedFlow, type DocsCollection, type DocsCollectionResponse, type DocsGenerateJobResponse, type DocsGenerateStatusCompleted, type DocsGenerateStatusFailed, type DocsGenerateStatusPending, type DocsGroup, type DocsGroupResponse, type DocsPage, type DocsPageResponse, type DocsPageSummary, type DocsRepository, DocsResource, type EmailCampaign, type EmailDelivery, type EmailDeliveryStats, type EmailLayout, type EmailPreview, type EmailSender, type EmailUnsubscribeGroup, type EmailUnsubscribeGroupMember, EmailUnsubscribeGroupsResource, EntitiesResource, type EventWebhook, type ExtensionUninstallPayload, type ExtensionWebhook, type Feature, type Flow, type FlowActionRun, FlowExtensionsResource, FlowsResource, type InvalidTokenError, type Invoice, type InvoiceWebhook, JournalEntriesResource, type JournalEntry, type JournalEntryApp, type JournalEntryFile, type List, ListsResource, type LogoChurnResponse, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type Meeting, type MeetingAttendee, type MeetingAttendeeRef, type MeetingContactRef, type MeetingCustomer, type MeetingDeal, type MeetingPermission, type MeetingTaskSuggestion, type MeetingTranscript, type MeetingUser, type MeetingUtterance, MeetingsResource, MetricsResource, type MissingScopesError, type MrrResponse, type NetInstallsResponse, type NetRevenueResponse, type NetRevenueRetentionResponse, type Organization, OrganizationResource, type Pagination, type PayoutResponse, type Plan, type PlanFeature, type PlanFeatureWebhook, type PlanUsageChargeWebhook, type PlanWebhook, type PredictedLtvResponse, type RateLimitOptions, type RevenueRetentionResponse, type Review, type ReviewWebhook, type StandardMetricResponse, type Subscription, type SubscriptionWebhook, SubscriptionsResource, type SyncedEmail, type SyncedEmailContact, type SyncedEmailCustomer, type SyncedEmailDeal, type SyncedEmailMessage, type SyncedEmailUser, SyncedEmailsResource, type Task, type TaskComment, type TaskTodoItem, TasksResource, type ThreadEventType, type ThreadMessageWebhook, type ThreadWebhook, type Ticket, type TicketAgent, type TicketApp, type TicketAttachment, type TicketChannel, type TicketContact, type TicketCustomer, type TicketEvent, type TicketLoop, type TicketMessage, TicketsResource, type TimeSeriesDataPoint, type TimelineComment, TimelineCommentsResource, type TokenRefreshResult, type Transaction, type TransactionWebhook, TransactionsResource, type Trigger, type UninstallEventWebhook, type UsageEvent, type UsageEventResponse, UsageEventsResource, type UsageMetric, type UsageMetricResponse, type User, UsersResource, type Webhook, WebhooksResource, type components, createRateLimitMiddleware, type paths };

package/dist/index.d.ts

@@ -4887,6 +4887,8 @@ type paths = {
                     appIds?: string[];
                     /** @description The cursor to paginate from */
                     cursor?: components["parameters"]["cursor"];
+                    /** @description An optional custom domain to filter customers by (e.g. example.com). */
+                    domain?: string;
                     /** @description Email addresses to filter customers by. Can be passed as an array (email=test1@example.com&email=test2@example.com) or a single string. Returns customers with emails matching any of the provided addresses. */
                     email?: string[] | string;
                     /** @description The maximum date/time (ISO 8601) of the last update to the Customer */
@@ -4897,7 +4899,7 @@ type paths = {
                     page?: components["parameters"]["page"];
                     /** @description The search term to filter by */
                     search?: components["parameters"]["search"];
-                    /** @description An optional shopify shop domain to filter customers by. */
+                    /** @description An optional shopify shop domain (myshopify.com domain) to filter customers by. */
                     shopifyShopDomain?: string;
                     /** @description An optional shopify shop id to filter customers by. */
                     shopifyShopId?: string;
@@ -19406,6 +19408,15 @@ type components = {
     pathItems: never;
 };
 
+/**
+ * Result returned by the refreshAccessToken callback.
+ */
+interface TokenRefreshResult {
+    /** The new access token */
+    accessToken: string;
+    /** When the new token expires. Used for preemptive refresh on subsequent requests. */
+    expiresAt?: Date;
+}
 /**
  * Configuration for the MantleCoreClient
  */
@@ -19416,6 +19427,21 @@ interface MantleCoreClientConfig {
     apiKey?: string;
     /** OAuth access token for authentication */
     accessToken?: string;
+    /**
+     * When the access token expires. If set, the client will proactively
+     * call refreshAccessToken before sending a request with an expired token.
+     */
+    accessTokenExpiresAt?: Date;
+    /**
+     * Callback to obtain a fresh access token. Called automatically when:
+     * - accessTokenExpiresAt is in the past (preemptive, before the request)
+     * - A 401 response is received for an expired/revoked token (reactive)
+     *
+     * The callback owns the full refresh lifecycle: look up the refresh token,
+     * call the auth server, persist the new credentials, and return the new
+     * access token. Concurrent requests will share a single in-flight refresh.
+     */
+    refreshAccessToken?: () => Promise<TokenRefreshResult>;
     /** Request timeout in milliseconds. Defaults to 30000 */
     timeout?: number;
     /** openapi-fetch middleware to register on instantiation */
@@ -27489,6 +27515,9 @@ declare class MantleCoreClient {
     readonly _api: Client<paths>;
     private apiKey?;
     private accessToken?;
+    private accessTokenExpiresAt?;
+    private refreshAccessToken?;
+    private refreshPromise?;
     readonly affiliateCommissions: AffiliateCommissionsResource;
     readonly affiliatePayouts: AffiliatePayoutsResource;
     readonly affiliatePrograms: AffiliateProgramsResource;
@@ -27547,7 +27576,17 @@ declare class MantleCoreClient {
     updateAuth(credentials: {
         apiKey?: string;
         accessToken?: string;
+        accessTokenExpiresAt?: Date;
     }): void;
+    /**
+     * Check if the access token is expired (with a 30-second buffer).
+     */
+    private isTokenExpired;
+    /**
+     * Execute a token refresh, deduplicating concurrent calls.
+     * All concurrent requests will await the same in-flight refresh promise.
+     */
+    private doRefresh;
 }
 
 type AccountOwner = components['schemas']['AccountOwner'];
@@ -27729,7 +27768,9 @@ declare class MantleAPIError extends Error {
  * Authentication failed (401)
  */
 declare class MantleAuthenticationError extends MantleAPIError {
-    constructor(message?: string);
+    /** Whether the token has expired (as opposed to being invalid/malformed) */
+    readonly isExpired: boolean;
+    constructor(message?: string, isExpired?: boolean);
 }
 /**
  * Permission denied (403)
@@ -27757,48 +27798,6 @@ declare class MantleRateLimitError extends MantleAPIError {
     constructor(message?: string, retryAfter?: number);
 }
 
-/**
- * Options for the auth refresh middleware
- */
-interface AuthRefreshOptions {
-    /**
-     * Function to refresh the access token.
-     * Should return the new access token.
-     */
-    refreshToken: () => Promise<string>;
-    /**
-     * Callback invoked when the client instance's auth should be updated.
-     * Receives the new token string.
-     */
-    updateAuth: (newToken: string) => void;
-    /** Optional callback when refresh succeeds */
-    onRefreshSuccess?: (newToken: string) => void;
-    /** Optional callback when refresh fails */
-    onRefreshFailed?: (error: Error) => void;
-    /** Maximum refresh attempts per request (default: 1) */
-    maxRefreshAttempts?: number;
-}
-/**
- * Creates an openapi-fetch middleware that automatically refreshes access
- * tokens on 401 responses.
- *
- * @example
- * ```typescript
- * const client = new MantleCoreClient({ accessToken: 'initial-token' });
- *
- * client.use(createAuthRefreshMiddleware({
- *   refreshToken: async () => {
- *     const res = await fetch('/refresh', { method: 'POST' });
- *     const data = await res.json();
- *     return data.accessToken;
- *   },
- *   updateAuth: (newToken) => client.updateAuth({ accessToken: newToken }),
- *   onRefreshSuccess: (newToken) => localStorage.setItem('accessToken', newToken),
- * }));
- * ```
- */
-declare function createAuthRefreshMiddleware(options: AuthRefreshOptions): Middleware;
-
 /**
  * Options for the rate limit middleware
  */
@@ -27837,4 +27836,4 @@ interface RateLimitOptions {
  */
 declare function createRateLimitMiddleware(options?: RateLimitOptions): Middleware;
 
-export { type AccountOwner, type AccountOwnerType, type Action, type ActiveSubscriptionsResponse, type Affiliate, type AffiliateAttributionWebhook, type AffiliateCommission, AffiliateCommissionsResource, type AffiliateMembershipWebhook, type AffiliatePayout, type AffiliatePayoutWebhook, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramGroup, type AffiliateProgramMembership, type AffiliateProgramWebhook, AffiliateProgramsResource, type AffiliateReferral, AffiliateReferralsResource, type AffiliateRules, type AffiliateRulesWebhook, type AffiliateWebhook, AffiliatesResource, type Agent, type AgentRun, AgentsResource, AiAgentRunsResource, type App, type AppChargeWebhook, type AppEvent, type AppInstallation, type AppInstallationWebhook, type AppWebhook, AppsResource, type AuthRefreshOptions, type BaseCustomerWebhook, BaseResource, ChannelsResource, type Charge, ChargesResource, type Checklist, type ChecklistStep, CompaniesResource, type Company, type Contact, type ContactWebhook, ContactsResource, type CursorPagination, CustomDataResource, type CustomField, type CustomFieldDefaultValue, type Customer, type CustomerContact, type CustomerContactWebhook, type CustomerSegment, CustomerSegmentsResource, type CustomerWebhook, type CustomerWithoutSubscriptionWebhook, CustomersResource, type Deal, type DealAcquirer, DealActivitiesResource, type DealActivity, type DealAffiliate, type DealApp, type DealContact, type DealCustomData, type DealCustomer, type DealEvent, type DealFlow, type DealFlowAffiliate, type DealFlowDefaultSource, type DealFlowPartnership, type DealFlowStage, type DealFlowUser, DealFlowsResource, type DealOwner, type DealPartnership, type DealPlan, type DealStage, DealsResource, type DetailedAffiliate, type DetailedFlow, type DocsCollection, type DocsCollectionResponse, type DocsGenerateJobResponse, type DocsGenerateStatusCompleted, type DocsGenerateStatusFailed, type DocsGenerateStatusPending, type DocsGroup, type DocsGroupResponse, type DocsPage, type DocsPageResponse, type DocsPageSummary, type DocsRepository, DocsResource, type EmailCampaign, type EmailDelivery, type EmailDeliveryStats, type EmailLayout, type EmailPreview, type EmailSender, type EmailUnsubscribeGroup, type EmailUnsubscribeGroupMember, EmailUnsubscribeGroupsResource, EntitiesResource, type EventWebhook, type ExtensionUninstallPayload, type ExtensionWebhook, type Feature, type Flow, type FlowActionRun, FlowExtensionsResource, FlowsResource, type InvalidTokenError, type Invoice, type InvoiceWebhook, JournalEntriesResource, type JournalEntry, type JournalEntryApp, type JournalEntryFile, type List, ListsResource, type LogoChurnResponse, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type Meeting, type MeetingAttendee, type MeetingAttendeeRef, type MeetingContactRef, type MeetingCustomer, type MeetingDeal, type MeetingPermission, type MeetingTaskSuggestion, type MeetingTranscript, type MeetingUser, type MeetingUtterance, MeetingsResource, MetricsResource, type MissingScopesError, type MrrResponse, type NetInstallsResponse, type NetRevenueResponse, type NetRevenueRetentionResponse, type Organization, OrganizationResource, type Pagination, type PayoutResponse, type Plan, type PlanFeature, type PlanFeatureWebhook, type PlanUsageChargeWebhook, type PlanWebhook, type PredictedLtvResponse, type RateLimitOptions, type RevenueRetentionResponse, type Review, type ReviewWebhook, type StandardMetricResponse, type Subscription, type SubscriptionWebhook, SubscriptionsResource, type SyncedEmail, type SyncedEmailContact, type SyncedEmailCustomer, type SyncedEmailDeal, type SyncedEmailMessage, type SyncedEmailUser, SyncedEmailsResource, type Task, type TaskComment, type TaskTodoItem, TasksResource, type ThreadEventType, type ThreadMessageWebhook, type ThreadWebhook, type Ticket, type TicketAgent, type TicketApp, type TicketAttachment, type TicketChannel, type TicketContact, type TicketCustomer, type TicketEvent, type TicketLoop, type TicketMessage, TicketsResource, type TimeSeriesDataPoint, type TimelineComment, TimelineCommentsResource, type Transaction, type TransactionWebhook, TransactionsResource, type Trigger, type UninstallEventWebhook, type UsageEvent, type UsageEventResponse, UsageEventsResource, type UsageMetric, type UsageMetricResponse, type User, UsersResource, type Webhook, WebhooksResource, type components, createAuthRefreshMiddleware, createRateLimitMiddleware, type paths };
+export { type AccountOwner, type AccountOwnerType, type Action, type ActiveSubscriptionsResponse, type Affiliate, type AffiliateAttributionWebhook, type AffiliateCommission, AffiliateCommissionsResource, type AffiliateMembershipWebhook, type AffiliatePayout, type AffiliatePayoutWebhook, AffiliatePayoutsResource, type AffiliateProgram, type AffiliateProgramGroup, type AffiliateProgramMembership, type AffiliateProgramWebhook, AffiliateProgramsResource, type AffiliateReferral, AffiliateReferralsResource, type AffiliateRules, type AffiliateRulesWebhook, type AffiliateWebhook, AffiliatesResource, type Agent, type AgentRun, AgentsResource, AiAgentRunsResource, type App, type AppChargeWebhook, type AppEvent, type AppInstallation, type AppInstallationWebhook, type AppWebhook, AppsResource, type BaseCustomerWebhook, BaseResource, ChannelsResource, type Charge, ChargesResource, type Checklist, type ChecklistStep, CompaniesResource, type Company, type Contact, type ContactWebhook, ContactsResource, type CursorPagination, CustomDataResource, type CustomField, type CustomFieldDefaultValue, type Customer, type CustomerContact, type CustomerContactWebhook, type CustomerSegment, CustomerSegmentsResource, type CustomerWebhook, type CustomerWithoutSubscriptionWebhook, CustomersResource, type Deal, type DealAcquirer, DealActivitiesResource, type DealActivity, type DealAffiliate, type DealApp, type DealContact, type DealCustomData, type DealCustomer, type DealEvent, type DealFlow, type DealFlowAffiliate, type DealFlowDefaultSource, type DealFlowPartnership, type DealFlowStage, type DealFlowUser, DealFlowsResource, type DealOwner, type DealPartnership, type DealPlan, type DealStage, DealsResource, type DetailedAffiliate, type DetailedFlow, type DocsCollection, type DocsCollectionResponse, type DocsGenerateJobResponse, type DocsGenerateStatusCompleted, type DocsGenerateStatusFailed, type DocsGenerateStatusPending, type DocsGroup, type DocsGroupResponse, type DocsPage, type DocsPageResponse, type DocsPageSummary, type DocsRepository, DocsResource, type EmailCampaign, type EmailDelivery, type EmailDeliveryStats, type EmailLayout, type EmailPreview, type EmailSender, type EmailUnsubscribeGroup, type EmailUnsubscribeGroupMember, EmailUnsubscribeGroupsResource, EntitiesResource, type EventWebhook, type ExtensionUninstallPayload, type ExtensionWebhook, type Feature, type Flow, type FlowActionRun, FlowExtensionsResource, FlowsResource, type InvalidTokenError, type Invoice, type InvoiceWebhook, JournalEntriesResource, type JournalEntry, type JournalEntryApp, type JournalEntryFile, type List, ListsResource, type LogoChurnResponse, MantleAPIError, MantleAuthenticationError, MantleCoreClient, type MantleCoreClientConfig, MantleNotFoundError, MantlePermissionError, MantleRateLimitError, MantleValidationError, MeResource, type Meeting, type MeetingAttendee, type MeetingAttendeeRef, type MeetingContactRef, type MeetingCustomer, type MeetingDeal, type MeetingPermission, type MeetingTaskSuggestion, type MeetingTranscript, type MeetingUser, type MeetingUtterance, MeetingsResource, MetricsResource, type MissingScopesError, type MrrResponse, type NetInstallsResponse, type NetRevenueResponse, type NetRevenueRetentionResponse, type Organization, OrganizationResource, type Pagination, type PayoutResponse, type Plan, type PlanFeature, type PlanFeatureWebhook, type PlanUsageChargeWebhook, type PlanWebhook, type PredictedLtvResponse, type RateLimitOptions, type RevenueRetentionResponse, type Review, type ReviewWebhook, type StandardMetricResponse, type Subscription, type SubscriptionWebhook, SubscriptionsResource, type SyncedEmail, type SyncedEmailContact, type SyncedEmailCustomer, type SyncedEmailDeal, type SyncedEmailMessage, type SyncedEmailUser, SyncedEmailsResource, type Task, type TaskComment, type TaskTodoItem, TasksResource, type ThreadEventType, type ThreadMessageWebhook, type ThreadWebhook, type Ticket, type TicketAgent, type TicketApp, type TicketAttachment, type TicketChannel, type TicketContact, type TicketCustomer, type TicketEvent, type TicketLoop, type TicketMessage, TicketsResource, type TimeSeriesDataPoint, type TimelineComment, TimelineCommentsResource, type TokenRefreshResult, type Transaction, type TransactionWebhook, TransactionsResource, type Trigger, type UninstallEventWebhook, type UsageEvent, type UsageEventResponse, UsageEventsResource, type UsageMetric, type UsageMetricResponse, type User, UsersResource, type Webhook, WebhooksResource, type components, createRateLimitMiddleware, type paths };

package/dist/index.js

@@ -76,7 +76,6 @@ __export(index_exports, {
   UsageEventsResource: () => UsageEventsResource,
   UsersResource: () => UsersResource,
   WebhooksResource: () => WebhooksResource,
-  createAuthRefreshMiddleware: () => createAuthRefreshMiddleware,
   createRateLimitMiddleware: () => createRateLimitMiddleware
 });
 module.exports = __toCommonJS(index_exports);
@@ -98,9 +97,10 @@ var MantleAPIError = class _MantleAPIError extends Error {
   }
 };
 var MantleAuthenticationError = class _MantleAuthenticationError extends MantleAPIError {
-  constructor(message = "Authentication failed") {
+  constructor(message = "Authentication failed", isExpired = false) {
     super(message, 401);
     this.name = "MantleAuthenticationError";
+    this.isExpired = isExpired;
     Object.setPrototypeOf(this, _MantleAuthenticationError.prototype);
   }
 };
@@ -166,7 +166,10 @@ var BaseResource = class {
     const details = typeof err?.details === "string" ? err.details : void 0;
     switch (response.status) {
       case 401:
-        return new MantleAuthenticationError(message);
+        return new MantleAuthenticationError(
+          message,
+          message.startsWith("token_expired")
+        );
       case 403:
         return new MantlePermissionError(message);
       case 404:
@@ -1162,6 +1165,8 @@ var MantleCoreClient = class {
     }
     this.apiKey = config.apiKey;
     this.accessToken = config.accessToken;
+    this.accessTokenExpiresAt = config.accessTokenExpiresAt;
+    this.refreshAccessToken = config.refreshAccessToken;
     const timeoutMs = config.timeout ?? 3e4;
     this._api = (0, import_openapi_fetch.default)({
       baseUrl: config.baseURL || "https://api.heymantle.com/v1",
@@ -1171,12 +1176,39 @@ var MantleCoreClient = class {
       ...config.fetch ? { fetch: config.fetch } : {}
     });
     this._api.use({
-      onRequest: ({ request }) => {
+      onRequest: async ({ request }) => {
+        if (this.refreshAccessToken && this.isTokenExpired()) {
+          await this.doRefresh();
+        }
         const token = this.accessToken || this.apiKey;
         if (token) {
           request.headers.set("Authorization", `Bearer ${token}`);
         }
         return request;
+      },
+      onResponse: async ({ request, response }) => {
+        if (response.status !== 401 || !this.refreshAccessToken) return void 0;
+        try {
+          const body = await response.clone().json();
+          const errorMsg = typeof body?.error === "string" ? body.error : "";
+          if (errorMsg.startsWith("invalid_token") || errorMsg.startsWith("invalid_client")) {
+            return void 0;
+          }
+        } catch {
+        }
+        try {
+          const newToken = await this.doRefresh();
+          const headers = new Headers(request.headers);
+          headers.set("Authorization", `Bearer ${newToken}`);
+          return fetch(new Request(request.url, {
+            method: request.method,
+            headers,
+            body: request.body,
+            signal: request.signal
+          }));
+        } catch {
+          return void 0;
+        }
       }
     });
     if (timeoutMs > 0) {
@@ -1260,48 +1292,38 @@ var MantleCoreClient = class {
     if (credentials.accessToken !== void 0) {
       this.accessToken = credentials.accessToken;
     }
+    if (credentials.accessTokenExpiresAt !== void 0) {
+      this.accessTokenExpiresAt = credentials.accessTokenExpiresAt;
+    }
   }
-};
-
-// src/middleware/auth-refresh.ts
-function createAuthRefreshMiddleware(options) {
-  const {
-    refreshToken,
-    updateAuth,
-    onRefreshSuccess,
-    onRefreshFailed,
-    maxRefreshAttempts = 1
-  } = options;
-  let refreshAttempts = 0;
-  return {
-    async onResponse({ request, response }) {
-      if (response.status !== 401) return void 0;
-      if (refreshAttempts >= maxRefreshAttempts) {
-        refreshAttempts = 0;
-        return void 0;
-      }
-      refreshAttempts++;
+  /**
+   * Check if the access token is expired (with a 30-second buffer).
+   */
+  isTokenExpired() {
+    if (!this.accessTokenExpiresAt) return false;
+    return this.accessTokenExpiresAt.getTime() - Date.now() <= 3e4;
+  }
+  /**
+   * Execute a token refresh, deduplicating concurrent calls.
+   * All concurrent requests will await the same in-flight refresh promise.
+   */
+  async doRefresh() {
+    if (this.refreshPromise) return this.refreshPromise;
+    this.refreshPromise = (async () => {
       try {
-        const newToken = await refreshToken();
-        updateAuth(newToken);
-        onRefreshSuccess?.(newToken);
-        refreshAttempts = 0;
-        const headers = new Headers(request.headers);
-        headers.set("Authorization", `Bearer ${newToken}`);
-        return fetch(new Request(request.url, {
-          method: request.method,
-          headers,
-          body: request.body,
-          signal: request.signal
-        }));
-      } catch (refreshError) {
-        refreshAttempts = 0;
-        onRefreshFailed?.(refreshError);
-        return void 0;
+        const result = await this.refreshAccessToken();
+        this.accessToken = result.accessToken;
+        if (result.expiresAt) {
+          this.accessTokenExpiresAt = result.expiresAt;
+        }
+        return result.accessToken;
+      } finally {
+        this.refreshPromise = void 0;
       }
-    }
-  };
-}
+    })();
+    return this.refreshPromise;
+  }
+};
 
 // src/middleware/rate-limit.ts
 var RateLimiter = class {
@@ -1468,6 +1490,5 @@ function createRateLimitMiddleware(options = {}) {
   UsageEventsResource,
   UsersResource,
   WebhooksResource,
-  createAuthRefreshMiddleware,
   createRateLimitMiddleware
 });

package/dist/index.mjs

@@ -15,9 +15,10 @@ var MantleAPIError = class _MantleAPIError extends Error {
   }
 };
 var MantleAuthenticationError = class _MantleAuthenticationError extends MantleAPIError {
-  constructor(message = "Authentication failed") {
+  constructor(message = "Authentication failed", isExpired = false) {
     super(message, 401);
     this.name = "MantleAuthenticationError";
+    this.isExpired = isExpired;
     Object.setPrototypeOf(this, _MantleAuthenticationError.prototype);
   }
 };
@@ -83,7 +84,10 @@ var BaseResource = class {
     const details = typeof err?.details === "string" ? err.details : void 0;
     switch (response.status) {
       case 401:
-        return new MantleAuthenticationError(message);
+        return new MantleAuthenticationError(
+          message,
+          message.startsWith("token_expired")
+        );
       case 403:
         return new MantlePermissionError(message);
       case 404:
@@ -1079,6 +1083,8 @@ var MantleCoreClient = class {
     }
     this.apiKey = config.apiKey;
     this.accessToken = config.accessToken;
+    this.accessTokenExpiresAt = config.accessTokenExpiresAt;
+    this.refreshAccessToken = config.refreshAccessToken;
     const timeoutMs = config.timeout ?? 3e4;
     this._api = createClient({
       baseUrl: config.baseURL || "https://api.heymantle.com/v1",
@@ -1088,12 +1094,39 @@ var MantleCoreClient = class {
       ...config.fetch ? { fetch: config.fetch } : {}
     });
     this._api.use({
-      onRequest: ({ request }) => {
+      onRequest: async ({ request }) => {
+        if (this.refreshAccessToken && this.isTokenExpired()) {
+          await this.doRefresh();
+        }
         const token = this.accessToken || this.apiKey;
         if (token) {
           request.headers.set("Authorization", `Bearer ${token}`);
         }
         return request;
+      },
+      onResponse: async ({ request, response }) => {
+        if (response.status !== 401 || !this.refreshAccessToken) return void 0;
+        try {
+          const body = await response.clone().json();
+          const errorMsg = typeof body?.error === "string" ? body.error : "";
+          if (errorMsg.startsWith("invalid_token") || errorMsg.startsWith("invalid_client")) {
+            return void 0;
+          }
+        } catch {
+        }
+        try {
+          const newToken = await this.doRefresh();
+          const headers = new Headers(request.headers);
+          headers.set("Authorization", `Bearer ${newToken}`);
+          return fetch(new Request(request.url, {
+            method: request.method,
+            headers,
+            body: request.body,
+            signal: request.signal
+          }));
+        } catch {
+          return void 0;
+        }
       }
     });
     if (timeoutMs > 0) {
@@ -1177,48 +1210,38 @@ var MantleCoreClient = class {
     if (credentials.accessToken !== void 0) {
       this.accessToken = credentials.accessToken;
     }
+    if (credentials.accessTokenExpiresAt !== void 0) {
+      this.accessTokenExpiresAt = credentials.accessTokenExpiresAt;
+    }
   }
-};
-
-// src/middleware/auth-refresh.ts
-function createAuthRefreshMiddleware(options) {
-  const {
-    refreshToken,
-    updateAuth,
-    onRefreshSuccess,
-    onRefreshFailed,
-    maxRefreshAttempts = 1
-  } = options;
-  let refreshAttempts = 0;
-  return {
-    async onResponse({ request, response }) {
-      if (response.status !== 401) return void 0;
-      if (refreshAttempts >= maxRefreshAttempts) {
-        refreshAttempts = 0;
-        return void 0;
-      }
-      refreshAttempts++;
+  /**
+   * Check if the access token is expired (with a 30-second buffer).
+   */
+  isTokenExpired() {
+    if (!this.accessTokenExpiresAt) return false;
+    return this.accessTokenExpiresAt.getTime() - Date.now() <= 3e4;
+  }
+  /**
+   * Execute a token refresh, deduplicating concurrent calls.
+   * All concurrent requests will await the same in-flight refresh promise.
+   */
+  async doRefresh() {
+    if (this.refreshPromise) return this.refreshPromise;
+    this.refreshPromise = (async () => {
       try {
-        const newToken = await refreshToken();
-        updateAuth(newToken);
-        onRefreshSuccess?.(newToken);
-        refreshAttempts = 0;
-        const headers = new Headers(request.headers);
-        headers.set("Authorization", `Bearer ${newToken}`);
-        return fetch(new Request(request.url, {
-          method: request.method,
-          headers,
-          body: request.body,
-          signal: request.signal
-        }));
-      } catch (refreshError) {
-        refreshAttempts = 0;
-        onRefreshFailed?.(refreshError);
-        return void 0;
+        const result = await this.refreshAccessToken();
+        this.accessToken = result.accessToken;
+        if (result.expiresAt) {
+          this.accessTokenExpiresAt = result.expiresAt;
+        }
+        return result.accessToken;
+      } finally {
+        this.refreshPromise = void 0;
       }
-    }
-  };
-}
+    })();
+    return this.refreshPromise;
+  }
+};
 
 // src/middleware/rate-limit.ts
 var RateLimiter = class {
@@ -1384,6 +1407,5 @@ export {
   UsageEventsResource,
   UsersResource,
   WebhooksResource,
-  createAuthRefreshMiddleware,
   createRateLimitMiddleware
 };

package/package.json

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