@cstar.help/js 0.17.3 → 0.17.5

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 import { W as WebhookEventType, a as WebhookEventDataMap } from './webhookEvents-1N2i2GcQ.cjs';
 export { b as WEBHOOK_EVENT_CATALOG, c as WEBHOOK_EVENT_SAMPLES, d as WebhookEvent } from './webhookEvents-1N2i2GcQ.cjs';
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, h as CStarServerError, i as CStarValidationError, E as ErrorType } from './errors-b5A4wfAg.cjs';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, h as CStarServerError, i as CStarValidationError, E as ErrorType } from './errors-bW8CwTn4.cjs';
 
 /** Metadata: string key-value pairs. Max 50 keys, 40-char keys, 500-char values. */
 type Metadata = Record<string, string>;
@@ -79,6 +79,8 @@ interface FetchOptions {
     body?: unknown;
     query?: Record<string, string | string[] | number | boolean | undefined>;
     idempotencyKey?: string;
+    /** Decode successful downloads as text; error responses still use JSON. */
+    responseType?: 'json' | 'text';
 }
 /**
  * Low-level HTTP client for the cStar API.
@@ -277,6 +279,9 @@ declare class CStarRealtime {
 interface Message {
     id: string;
     object: 'message';
+    ticketId: string;
+    /** True for a note visible only to the support team. */
+    isInternal: boolean;
     sender: 'customer' | 'agent' | 'system';
     content: string;
     senderId: string | null;
@@ -291,7 +296,12 @@ interface MessageCreateParams {
     sender?: 'customer' | 'agent' | 'system';
     senderId?: string;
     senderName?: string;
+    messageType?: 'public' | 'internal';
+    /** Boolean alias for messageType. If both are supplied, they must agree. */
+    isInternal?: boolean;
 }
+/** Pagination options for a ticket message history. */
+type MessageListParams = PaginationParams;
 
 /** A cStar support ticket. */
 interface Ticket {
@@ -469,8 +479,8 @@ declare abstract class BaseResource<TEntity, TListParams extends PaginationParam
 declare class TicketMessagesResource {
     private readonly client;
     constructor(client: HttpClient);
-    /** List all messages on a ticket. */
-    list(ticketId: string): Promise<ListResponse<Message>>;
+    /** List one page of a ticket history. Use pagination.hasMore to request the next page. */
+    list(ticketId: string, params?: MessageListParams): Promise<ListResponse<Message>>;
     /** Add a message to a ticket. */
     create(ticketId: string, params: MessageCreateParams, options?: RequestOptions): Promise<Message>;
 }
@@ -708,7 +718,7 @@ declare class WebhooksResource extends BaseResource<Webhook, WebhookListParams,
     /** Fire a test webhook event to all active webhooks and CLI listeners. */
     triggerTest(params: WebhookTriggerTestParams, options?: RequestOptions): Promise<ApiResponse<WebhookTriggerTestResult>>;
     /** Get a sample webhook payload for an event type (used by Zapier). */
-    sample(event: string): Promise<ApiResponse<unknown[]>>;
+    sample(event: string): Promise<ListResponse<unknown>>;
     /** Subscribe to an event (REST Hooks / Zapier protocol). */
     restSubscribe(params: WebhookSubscribeParams, options?: RequestOptions): Promise<ApiResponse<WebhookSubscription>>;
     /** Unsubscribe from an event (REST Hooks / Zapier protocol). Returns void (204 No Content). */
@@ -847,7 +857,7 @@ declare class AutomationsResource extends BaseResource<AutomationRule, Automatio
     /** Toggle a rule's enabled state. */
     toggle(ruleId: string, enabled?: boolean): Promise<ApiResponse<AutomationRule>>;
     /** Reorder rules by providing an ordered array of IDs. */
-    reorder(orderedIds: string[]): Promise<ApiResponse<AutomationRule[]>>;
+    reorder(orderedIds: string[]): Promise<ListResponse<AutomationRule>>;
     /** Dry-run a rule against a specific resource (no actions executed). */
     test(ruleId: string, params: {
         resourceType: string;
@@ -1053,7 +1063,7 @@ declare class CommunityPostsResource extends BaseResource<CommunityPost, Communi
         following: boolean;
     }>>;
     /** List all comments on a post. */
-    listComments(postId: string): Promise<ApiResponse<CommunityComment[]>>;
+    listComments(postId: string): Promise<ListResponse<CommunityComment>>;
     /** Add a comment to a post. */
     createComment(postId: string, params: CommunityCommentCreateParams): Promise<ApiResponse<CommunityComment>>;
 }
@@ -1282,7 +1292,7 @@ declare class StatusesResource {
     private readonly client;
     constructor(client: HttpClient);
     /** List all statuses. */
-    list(): Promise<ApiResponse<TicketStatus[]>>;
+    list(): Promise<ListResponse<TicketStatus>>;
     /** Create a new status. */
     create(params: StatusCreateParams, options?: RequestOptions): Promise<ApiResponse<TicketStatus>>;
     /** Update a status. */
@@ -1290,14 +1300,14 @@ declare class StatusesResource {
     /** Delete a status. */
     del(statusKey: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder statuses. */
-    reorder(orderedKeys: string[]): Promise<ApiResponse<TicketStatus[]>>;
+    reorder(orderedKeys: string[]): Promise<ListResponse<TicketStatus>>;
 }
 /** Manage quick reply templates. */
 declare class QuickRepliesResource {
     private readonly client;
     constructor(client: HttpClient);
     /** List all quick replies. */
-    list(): Promise<ApiResponse<QuickReply[]>>;
+    list(): Promise<ListResponse<QuickReply>>;
     /** Create a new quick reply. */
     create(params: QuickReplyCreateParams, options?: RequestOptions): Promise<ApiResponse<QuickReply>>;
     /** Update a quick reply. */
@@ -1305,7 +1315,7 @@ declare class QuickRepliesResource {
     /** Delete a quick reply. */
     del(replyId: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder quick replies. */
-    reorder(orderedIds: string[]): Promise<ApiResponse<QuickReply[]>>;
+    reorder(orderedIds: string[]): Promise<ListResponse<QuickReply>>;
 }
 /** Manage team settings. */
 declare class SettingsResource {
@@ -1500,7 +1510,10 @@ declare class CustomFieldsResource {
     /** Delete a custom field. */
     del(fieldId: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder custom fields within a content type. */
-    reorder(contentType: 'ticket' | 'customer' | 'article', orderedIds: string[]): Promise<ApiResponse<CustomField[]>>;
+    reorder(contentType: 'ticket' | 'customer' | 'article', orderedIds: string[]): Promise<{
+        success: true;
+        reordered: number;
+    }>;
 }
 
 /** An SLA rule. */
@@ -1569,7 +1582,7 @@ declare class SlaResource {
     /** Delete an SLA rule. */
     del(ruleId: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder SLA rules by providing an ordered array of IDs. */
-    reorder(orderedIds: string[]): Promise<ApiResponse<SlaRule[]>>;
+    reorder(orderedIds: string[]): Promise<ListResponse<SlaRule>>;
     /** Get SLA compliance metrics. */
     metrics(params?: SlaMetricsParams): Promise<ApiResponse<SlaMetrics>>;
 }
@@ -1744,20 +1757,41 @@ declare class BulkResource {
     del(params: BulkDeleteParams, options?: RequestOptions): Promise<ApiResponse<BulkResult>>;
 }
 
-/** Export request parameters. */
-interface ExportCreateParams {
-    resources: Array<{
-        type: 'tickets' | 'customers' | 'articles';
-        filters?: Record<string, unknown>;
-    }>;
-    format?: 'json' | 'csv';
-}
-/** Export response. */
+/** Resource tables supported by the export endpoint. */
+type ExportResourceType = 'tickets' | 'customers' | 'articles';
+/** Filters shared by all selected resources. */
+interface ExportFilters {
+    status?: string;
+    priority?: string;
+    createdAfter?: string;
+    createdBefore?: string;
+}
+/** JSON may export multiple resources or default to all three. */
+interface ExportJsonParams {
+    resources?: readonly [ExportResourceType, ...ExportResourceType[]];
+    format?: 'json';
+    filters?: ExportFilters;
+}
+/** CSV must select exactly one resource, including when passed through a helper. */
+interface ExportCsvParams {
+    resources: readonly [ExportResourceType];
+    format: 'csv';
+    filters?: ExportFilters;
+}
+/** Export parameters preserve the relationship between format and resources. */
+type ExportCreateParams = ExportJsonParams | ExportCsvParams;
+/** JSON export with raw database rows, unlike the mapped API resource objects. */
 interface ExportResult {
     object: 'export';
-    format: string;
-    resources: Record<string, unknown[]> | string;
-    totalRows: number;
+    format: 'json';
+    exportedAt: string;
+    teamId: string;
+    tickets?: Record<string, unknown>[];
+    customers?: Record<string, unknown>[];
+    articles?: Record<string, unknown>[];
+    /** Included when the selected tickets have messages. */
+    messages?: Record<string, unknown>[];
+    summary: Partial<Record<ExportResourceType | 'messages', number>>;
 }
 
 /** Import request parameters. */
@@ -1828,8 +1862,12 @@ interface ImportLogListParams extends PaginationParams {
 declare class ExportResource {
     private readonly client;
     constructor(client: HttpClient);
-    /** Create an export. Returns exported data synchronously. */
-    create(params: ExportCreateParams, options?: RequestOptions): Promise<ApiResponse<ExportResult>>;
+    /** Create a CSV export. The API returns text for a single resource. */
+    create(params: ExportCsvParams, options?: RequestOptions): Promise<string>;
+    /** Create a JSON export with raw rows and per-resource counts. */
+    create(params: ExportJsonParams, options?: RequestOptions): Promise<ExportResult>;
+    /** A runtime-selected format returns JSON or CSV text accordingly. */
+    create(params: ExportCreateParams, options?: RequestOptions): Promise<ExportResult | string>;
 }
 /** Import data into your team. */
 declare class ImportResource {
@@ -1893,13 +1931,19 @@ interface SearchParams {
     types?: Array<'tickets' | 'customers' | 'articles'>;
     limit?: number;
 }
+/** Cross-resource search results with the original query and returned count. */
+interface SearchResponse {
+    results: SearchResult[];
+    total: number;
+    query: string;
+}
 
 /** Search across tickets, customers, and articles. */
 declare class SearchResource {
     private readonly client;
     constructor(client: HttpClient);
     /** Perform a cross-resource search. */
-    query(params: SearchParams): Promise<ApiResponse<SearchResult[]>>;
+    query(params: SearchParams): Promise<SearchResponse>;
 }
 
 /** A tag with usage count. */
@@ -2489,7 +2533,7 @@ declare class AchievementsResource {
     /** List unlocked achievements only. */
     unlocked(params?: {
         userId: string;
-    }): Promise<ApiResponse<Achievement[]>>;
+    }): Promise<ListResponse<Achievement>>;
     /** Get a single achievement. */
     get(achievementId: string, params?: {
         userId?: string;
@@ -2909,7 +2953,7 @@ interface CStarClientConfig {
  * viewing your site.
  *
  * For client-side integrations, use:
- * - `@cstar.help/js/chat` — Customer chat widget (publishable key)
+ * - `@cstar.help/js/chat` — Customer chat widget (HMAC or customer session)
  * - `@cstar.help/js/library` — Public knowledge base (no auth)
  * - `@cstar.help/js/community` — Public community forum (no auth)
  *
@@ -3037,4 +3081,4 @@ declare class CStarClient {
     get lastMeta(): LastMeta;
 }
 
-export { type Achievement, type AchievementListParams, type ActivityEvent, type ActivityListParams, type AiAction, type AiActionParams, type AiActionResult, type AnalyticsOverview, type AnalyticsParams, type ApiResponse, type Article, type ArticleCreateParams, type ArticleListParams, type ArticleUpdateParams, type Attachment, type AttachmentListParams, type AuditLogEntry, type AuditLogListParams, type AutomationAction, type AutomationCondition, type AutomationConditions, type AutomationCreateParams, type AutomationExecution, type AutomationExecutionListParams, type AutomationListParams, type AutomationRule, type AutomationTestResult, type AutomationUpdateParams, type BillingPortal, type BillingPortalParams, type Boss, type BossDamageParams, type BossDamageResult, type BossDefeat, type BossDefeatListParams, type BossSpawnParams, type BulkDeleteParams, type BulkResult, type BulkUpdateParams, type BusinessHours, type BusinessHoursUpdateParams, CStarClient, type CStarClientConfig, CStarRealtime, type Category, type CategoryCreateParams, type CategoryListParams, type CategoryUpdateParams, type CommunityComment, type CommunityCommentCreateParams, type CommunityPost, type CommunityPostCreateParams, type CommunityPostListParams, type CommunityPostUpdateParams, type CommunityTopic, type ConnectionHandler, type Cosmetic, type CosmeticListParams, type CosmeticPreferences, type CsatSettings, type CsatSettingsUpdateParams, type CsatStats, type CsatSurvey, type CsatSurveyCreateParams, type CsatSurveyListParams, type CurrentSeason, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerGroup, type CustomerGroupAddMembersParams, type CustomerGroupAddResult, type CustomerGroupCreateParams, type CustomerGroupListParams, type CustomerGroupMemberListParams, type CustomerGroupMembersResult, type CustomerGroupRemoveResult, type CustomerGroupUpdateParams, type CustomerListParams, type CustomerUpdateParams, type DeleteResponse, type ErrorHandler, type EventHandler, type ExportCreateParams, type ExportResult, type GameConfig, type HighFive, type HighFiveCanSend, type HighFiveCreateParams, type HighFiveListParams, type ImportCreateParams, type ImportLog, type ImportLogListParams, type ImportResult, type Invite, type InviteCreateParams, type InviteListParams, type LeaderboardEntry, type LeaderboardParams, type ListResponse, type Member, type MemberListParams, type MemberUpdateParams, type Mention, type MentionListParams, type MentionUnreadCount, type Message, type MessageCreateParams, type Metadata, type Notification, type NotificationListParams, OfflineQueue, type OfflineQueueOptions, type OneUp, type OneUpCreateParams, type OneUpListParams, type OneUpRemaining, type OneUpSendResult, type PaginationInfo, type PaginationParams, type Player, type Puzzle, type PuzzleCompleteParams, type PuzzleCompleteResult, type PuzzleLeaderboardParams, type PuzzleLeaderboardResult, type PuzzleStreak, type Quest, type QuestHistory, type QuestHistoryParams, type QuestList, type QueueItem, type QueueResult, type QuickReply, type QuickReplyCreateParams, type QuickReplyUpdateParams, type RealtimeEvent, type RealtimeOptions, type RequestOptions, type SavedView, type SearchParams, type SearchResult, type Season, type SeasonStats, type SkillAllocateParams, type SkillAllocateResult, type SkillTree, type SlaMetrics, type SlaMetricsParams, type SlaRule, type SlaRuleCreateParams, type SlaRuleListParams, type SlaRuleUpdateParams, type StatusCreateParams, type StatusUpdateParams, Subscription$1 as Subscription, type Tag, type TagListParams, type TeamSettings, type TeamSettingsUpdateParams, type Ticket, type TicketCreateParams, type TicketCustomerSummary, type TicketListParams, type TicketStatus, type TicketUpdateParams, type TopicCustomField, type UnreadCount, type ViewCreateParams, type ViewExecuteParams, type ViewListParams, type ViewUpdateParams, type Webhook, type WebhookCreateParams, type WebhookEventData, WebhookEventType, type WebhookListParams, type WebhookListener, type WebhookListenerParams, type WebhookSubscribeParams, type WebhookSubscription, type WebhookTestResult, type WebhookTriggerTestParams, type WebhookTriggerTestResult, type WebhookUpdateParams, type WidgetSettings, type WidgetSettingsUpdateParams };
+export { type Achievement, type AchievementListParams, type ActivityEvent, type ActivityListParams, type AiAction, type AiActionParams, type AiActionResult, type AnalyticsOverview, type AnalyticsParams, type ApiResponse, type Article, type ArticleCreateParams, type ArticleListParams, type ArticleUpdateParams, type Attachment, type AttachmentListParams, type AuditLogEntry, type AuditLogListParams, type AutomationAction, type AutomationCondition, type AutomationConditions, type AutomationCreateParams, type AutomationExecution, type AutomationExecutionListParams, type AutomationListParams, type AutomationRule, type AutomationTestResult, type AutomationUpdateParams, type BillingPortal, type BillingPortalParams, type Boss, type BossDamageParams, type BossDamageResult, type BossDefeat, type BossDefeatListParams, type BossSpawnParams, type BulkDeleteParams, type BulkResult, type BulkUpdateParams, type BusinessHours, type BusinessHoursUpdateParams, CStarClient, type CStarClientConfig, CStarRealtime, type Category, type CategoryCreateParams, type CategoryListParams, type CategoryUpdateParams, type CommunityComment, type CommunityCommentCreateParams, type CommunityPost, type CommunityPostCreateParams, type CommunityPostListParams, type CommunityPostUpdateParams, type CommunityTopic, type ConnectionHandler, type Cosmetic, type CosmeticListParams, type CosmeticPreferences, type CsatSettings, type CsatSettingsUpdateParams, type CsatStats, type CsatSurvey, type CsatSurveyCreateParams, type CsatSurveyListParams, type CurrentSeason, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerGroup, type CustomerGroupAddMembersParams, type CustomerGroupAddResult, type CustomerGroupCreateParams, type CustomerGroupListParams, type CustomerGroupMemberListParams, type CustomerGroupMembersResult, type CustomerGroupRemoveResult, type CustomerGroupUpdateParams, type CustomerListParams, type CustomerUpdateParams, type DeleteResponse, type ErrorHandler, type EventHandler, type ExportCreateParams, type ExportCsvParams, type ExportFilters, type ExportJsonParams, type ExportResourceType, type ExportResult, type GameConfig, type HighFive, type HighFiveCanSend, type HighFiveCreateParams, type HighFiveListParams, type ImportCreateParams, type ImportLog, type ImportLogListParams, type ImportResult, type Invite, type InviteCreateParams, type InviteListParams, type LeaderboardEntry, type LeaderboardParams, type ListResponse, type Member, type MemberListParams, type MemberUpdateParams, type Mention, type MentionListParams, type MentionUnreadCount, type Message, type MessageCreateParams, type MessageListParams, type Metadata, type Notification, type NotificationListParams, OfflineQueue, type OfflineQueueOptions, type OneUp, type OneUpCreateParams, type OneUpListParams, type OneUpRemaining, type OneUpSendResult, type PaginationInfo, type PaginationParams, type Player, type Puzzle, type PuzzleCompleteParams, type PuzzleCompleteResult, type PuzzleLeaderboardParams, type PuzzleLeaderboardResult, type PuzzleStreak, type Quest, type QuestHistory, type QuestHistoryParams, type QuestList, type QueueItem, type QueueResult, type QuickReply, type QuickReplyCreateParams, type QuickReplyUpdateParams, type RealtimeEvent, type RealtimeOptions, type RequestOptions, type SavedView, type SearchParams, type SearchResponse, type SearchResult, type Season, type SeasonStats, type SkillAllocateParams, type SkillAllocateResult, type SkillTree, type SlaMetrics, type SlaMetricsParams, type SlaRule, type SlaRuleCreateParams, type SlaRuleListParams, type SlaRuleUpdateParams, type StatusCreateParams, type StatusUpdateParams, Subscription$1 as Subscription, type Tag, type TagListParams, type TeamSettings, type TeamSettingsUpdateParams, type Ticket, type TicketCreateParams, type TicketCustomerSummary, type TicketListParams, type TicketStatus, type TicketUpdateParams, type TopicCustomField, type UnreadCount, type ViewCreateParams, type ViewExecuteParams, type ViewListParams, type ViewUpdateParams, type Webhook, type WebhookCreateParams, type WebhookEventData, WebhookEventType, type WebhookListParams, type WebhookListener, type WebhookListenerParams, type WebhookSubscribeParams, type WebhookSubscription, type WebhookTestResult, type WebhookTriggerTestParams, type WebhookTriggerTestResult, type WebhookUpdateParams, type WidgetSettings, type WidgetSettingsUpdateParams };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { W as WebhookEventType, a as WebhookEventDataMap } from './webhookEvents-1N2i2GcQ.js';
 export { b as WEBHOOK_EVENT_CATALOG, c as WEBHOOK_EVENT_SAMPLES, d as WebhookEvent } from './webhookEvents-1N2i2GcQ.js';
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, h as CStarServerError, i as CStarValidationError, E as ErrorType } from './errors-b5A4wfAg.js';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, h as CStarServerError, i as CStarValidationError, E as ErrorType } from './errors-bW8CwTn4.js';
 
 /** Metadata: string key-value pairs. Max 50 keys, 40-char keys, 500-char values. */
 type Metadata = Record<string, string>;
@@ -79,6 +79,8 @@ interface FetchOptions {
     body?: unknown;
     query?: Record<string, string | string[] | number | boolean | undefined>;
     idempotencyKey?: string;
+    /** Decode successful downloads as text; error responses still use JSON. */
+    responseType?: 'json' | 'text';
 }
 /**
  * Low-level HTTP client for the cStar API.
@@ -277,6 +279,9 @@ declare class CStarRealtime {
 interface Message {
     id: string;
     object: 'message';
+    ticketId: string;
+    /** True for a note visible only to the support team. */
+    isInternal: boolean;
     sender: 'customer' | 'agent' | 'system';
     content: string;
     senderId: string | null;
@@ -291,7 +296,12 @@ interface MessageCreateParams {
     sender?: 'customer' | 'agent' | 'system';
     senderId?: string;
     senderName?: string;
+    messageType?: 'public' | 'internal';
+    /** Boolean alias for messageType. If both are supplied, they must agree. */
+    isInternal?: boolean;
 }
+/** Pagination options for a ticket message history. */
+type MessageListParams = PaginationParams;
 
 /** A cStar support ticket. */
 interface Ticket {
@@ -469,8 +479,8 @@ declare abstract class BaseResource<TEntity, TListParams extends PaginationParam
 declare class TicketMessagesResource {
     private readonly client;
     constructor(client: HttpClient);
-    /** List all messages on a ticket. */
-    list(ticketId: string): Promise<ListResponse<Message>>;
+    /** List one page of a ticket history. Use pagination.hasMore to request the next page. */
+    list(ticketId: string, params?: MessageListParams): Promise<ListResponse<Message>>;
     /** Add a message to a ticket. */
     create(ticketId: string, params: MessageCreateParams, options?: RequestOptions): Promise<Message>;
 }
@@ -708,7 +718,7 @@ declare class WebhooksResource extends BaseResource<Webhook, WebhookListParams,
     /** Fire a test webhook event to all active webhooks and CLI listeners. */
     triggerTest(params: WebhookTriggerTestParams, options?: RequestOptions): Promise<ApiResponse<WebhookTriggerTestResult>>;
     /** Get a sample webhook payload for an event type (used by Zapier). */
-    sample(event: string): Promise<ApiResponse<unknown[]>>;
+    sample(event: string): Promise<ListResponse<unknown>>;
     /** Subscribe to an event (REST Hooks / Zapier protocol). */
     restSubscribe(params: WebhookSubscribeParams, options?: RequestOptions): Promise<ApiResponse<WebhookSubscription>>;
     /** Unsubscribe from an event (REST Hooks / Zapier protocol). Returns void (204 No Content). */
@@ -847,7 +857,7 @@ declare class AutomationsResource extends BaseResource<AutomationRule, Automatio
     /** Toggle a rule's enabled state. */
     toggle(ruleId: string, enabled?: boolean): Promise<ApiResponse<AutomationRule>>;
     /** Reorder rules by providing an ordered array of IDs. */
-    reorder(orderedIds: string[]): Promise<ApiResponse<AutomationRule[]>>;
+    reorder(orderedIds: string[]): Promise<ListResponse<AutomationRule>>;
     /** Dry-run a rule against a specific resource (no actions executed). */
     test(ruleId: string, params: {
         resourceType: string;
@@ -1053,7 +1063,7 @@ declare class CommunityPostsResource extends BaseResource<CommunityPost, Communi
         following: boolean;
     }>>;
     /** List all comments on a post. */
-    listComments(postId: string): Promise<ApiResponse<CommunityComment[]>>;
+    listComments(postId: string): Promise<ListResponse<CommunityComment>>;
     /** Add a comment to a post. */
     createComment(postId: string, params: CommunityCommentCreateParams): Promise<ApiResponse<CommunityComment>>;
 }
@@ -1282,7 +1292,7 @@ declare class StatusesResource {
     private readonly client;
     constructor(client: HttpClient);
     /** List all statuses. */
-    list(): Promise<ApiResponse<TicketStatus[]>>;
+    list(): Promise<ListResponse<TicketStatus>>;
     /** Create a new status. */
     create(params: StatusCreateParams, options?: RequestOptions): Promise<ApiResponse<TicketStatus>>;
     /** Update a status. */
@@ -1290,14 +1300,14 @@ declare class StatusesResource {
     /** Delete a status. */
     del(statusKey: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder statuses. */
-    reorder(orderedKeys: string[]): Promise<ApiResponse<TicketStatus[]>>;
+    reorder(orderedKeys: string[]): Promise<ListResponse<TicketStatus>>;
 }
 /** Manage quick reply templates. */
 declare class QuickRepliesResource {
     private readonly client;
     constructor(client: HttpClient);
     /** List all quick replies. */
-    list(): Promise<ApiResponse<QuickReply[]>>;
+    list(): Promise<ListResponse<QuickReply>>;
     /** Create a new quick reply. */
     create(params: QuickReplyCreateParams, options?: RequestOptions): Promise<ApiResponse<QuickReply>>;
     /** Update a quick reply. */
@@ -1305,7 +1315,7 @@ declare class QuickRepliesResource {
     /** Delete a quick reply. */
     del(replyId: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder quick replies. */
-    reorder(orderedIds: string[]): Promise<ApiResponse<QuickReply[]>>;
+    reorder(orderedIds: string[]): Promise<ListResponse<QuickReply>>;
 }
 /** Manage team settings. */
 declare class SettingsResource {
@@ -1500,7 +1510,10 @@ declare class CustomFieldsResource {
     /** Delete a custom field. */
     del(fieldId: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder custom fields within a content type. */
-    reorder(contentType: 'ticket' | 'customer' | 'article', orderedIds: string[]): Promise<ApiResponse<CustomField[]>>;
+    reorder(contentType: 'ticket' | 'customer' | 'article', orderedIds: string[]): Promise<{
+        success: true;
+        reordered: number;
+    }>;
 }
 
 /** An SLA rule. */
@@ -1569,7 +1582,7 @@ declare class SlaResource {
     /** Delete an SLA rule. */
     del(ruleId: string): Promise<ApiResponse<DeleteResponse>>;
     /** Reorder SLA rules by providing an ordered array of IDs. */
-    reorder(orderedIds: string[]): Promise<ApiResponse<SlaRule[]>>;
+    reorder(orderedIds: string[]): Promise<ListResponse<SlaRule>>;
     /** Get SLA compliance metrics. */
     metrics(params?: SlaMetricsParams): Promise<ApiResponse<SlaMetrics>>;
 }
@@ -1744,20 +1757,41 @@ declare class BulkResource {
     del(params: BulkDeleteParams, options?: RequestOptions): Promise<ApiResponse<BulkResult>>;
 }
 
-/** Export request parameters. */
-interface ExportCreateParams {
-    resources: Array<{
-        type: 'tickets' | 'customers' | 'articles';
-        filters?: Record<string, unknown>;
-    }>;
-    format?: 'json' | 'csv';
-}
-/** Export response. */
+/** Resource tables supported by the export endpoint. */
+type ExportResourceType = 'tickets' | 'customers' | 'articles';
+/** Filters shared by all selected resources. */
+interface ExportFilters {
+    status?: string;
+    priority?: string;
+    createdAfter?: string;
+    createdBefore?: string;
+}
+/** JSON may export multiple resources or default to all three. */
+interface ExportJsonParams {
+    resources?: readonly [ExportResourceType, ...ExportResourceType[]];
+    format?: 'json';
+    filters?: ExportFilters;
+}
+/** CSV must select exactly one resource, including when passed through a helper. */
+interface ExportCsvParams {
+    resources: readonly [ExportResourceType];
+    format: 'csv';
+    filters?: ExportFilters;
+}
+/** Export parameters preserve the relationship between format and resources. */
+type ExportCreateParams = ExportJsonParams | ExportCsvParams;
+/** JSON export with raw database rows, unlike the mapped API resource objects. */
 interface ExportResult {
     object: 'export';
-    format: string;
-    resources: Record<string, unknown[]> | string;
-    totalRows: number;
+    format: 'json';
+    exportedAt: string;
+    teamId: string;
+    tickets?: Record<string, unknown>[];
+    customers?: Record<string, unknown>[];
+    articles?: Record<string, unknown>[];
+    /** Included when the selected tickets have messages. */
+    messages?: Record<string, unknown>[];
+    summary: Partial<Record<ExportResourceType | 'messages', number>>;
 }
 
 /** Import request parameters. */
@@ -1828,8 +1862,12 @@ interface ImportLogListParams extends PaginationParams {
 declare class ExportResource {
     private readonly client;
     constructor(client: HttpClient);
-    /** Create an export. Returns exported data synchronously. */
-    create(params: ExportCreateParams, options?: RequestOptions): Promise<ApiResponse<ExportResult>>;
+    /** Create a CSV export. The API returns text for a single resource. */
+    create(params: ExportCsvParams, options?: RequestOptions): Promise<string>;
+    /** Create a JSON export with raw rows and per-resource counts. */
+    create(params: ExportJsonParams, options?: RequestOptions): Promise<ExportResult>;
+    /** A runtime-selected format returns JSON or CSV text accordingly. */
+    create(params: ExportCreateParams, options?: RequestOptions): Promise<ExportResult | string>;
 }
 /** Import data into your team. */
 declare class ImportResource {
@@ -1893,13 +1931,19 @@ interface SearchParams {
     types?: Array<'tickets' | 'customers' | 'articles'>;
     limit?: number;
 }
+/** Cross-resource search results with the original query and returned count. */
+interface SearchResponse {
+    results: SearchResult[];
+    total: number;
+    query: string;
+}
 
 /** Search across tickets, customers, and articles. */
 declare class SearchResource {
     private readonly client;
     constructor(client: HttpClient);
     /** Perform a cross-resource search. */
-    query(params: SearchParams): Promise<ApiResponse<SearchResult[]>>;
+    query(params: SearchParams): Promise<SearchResponse>;
 }
 
 /** A tag with usage count. */
@@ -2489,7 +2533,7 @@ declare class AchievementsResource {
     /** List unlocked achievements only. */
     unlocked(params?: {
         userId: string;
-    }): Promise<ApiResponse<Achievement[]>>;
+    }): Promise<ListResponse<Achievement>>;
     /** Get a single achievement. */
     get(achievementId: string, params?: {
         userId?: string;
@@ -2909,7 +2953,7 @@ interface CStarClientConfig {
  * viewing your site.
  *
  * For client-side integrations, use:
- * - `@cstar.help/js/chat` — Customer chat widget (publishable key)
+ * - `@cstar.help/js/chat` — Customer chat widget (HMAC or customer session)
  * - `@cstar.help/js/library` — Public knowledge base (no auth)
  * - `@cstar.help/js/community` — Public community forum (no auth)
  *
@@ -3037,4 +3081,4 @@ declare class CStarClient {
     get lastMeta(): LastMeta;
 }
 
-export { type Achievement, type AchievementListParams, type ActivityEvent, type ActivityListParams, type AiAction, type AiActionParams, type AiActionResult, type AnalyticsOverview, type AnalyticsParams, type ApiResponse, type Article, type ArticleCreateParams, type ArticleListParams, type ArticleUpdateParams, type Attachment, type AttachmentListParams, type AuditLogEntry, type AuditLogListParams, type AutomationAction, type AutomationCondition, type AutomationConditions, type AutomationCreateParams, type AutomationExecution, type AutomationExecutionListParams, type AutomationListParams, type AutomationRule, type AutomationTestResult, type AutomationUpdateParams, type BillingPortal, type BillingPortalParams, type Boss, type BossDamageParams, type BossDamageResult, type BossDefeat, type BossDefeatListParams, type BossSpawnParams, type BulkDeleteParams, type BulkResult, type BulkUpdateParams, type BusinessHours, type BusinessHoursUpdateParams, CStarClient, type CStarClientConfig, CStarRealtime, type Category, type CategoryCreateParams, type CategoryListParams, type CategoryUpdateParams, type CommunityComment, type CommunityCommentCreateParams, type CommunityPost, type CommunityPostCreateParams, type CommunityPostListParams, type CommunityPostUpdateParams, type CommunityTopic, type ConnectionHandler, type Cosmetic, type CosmeticListParams, type CosmeticPreferences, type CsatSettings, type CsatSettingsUpdateParams, type CsatStats, type CsatSurvey, type CsatSurveyCreateParams, type CsatSurveyListParams, type CurrentSeason, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerGroup, type CustomerGroupAddMembersParams, type CustomerGroupAddResult, type CustomerGroupCreateParams, type CustomerGroupListParams, type CustomerGroupMemberListParams, type CustomerGroupMembersResult, type CustomerGroupRemoveResult, type CustomerGroupUpdateParams, type CustomerListParams, type CustomerUpdateParams, type DeleteResponse, type ErrorHandler, type EventHandler, type ExportCreateParams, type ExportResult, type GameConfig, type HighFive, type HighFiveCanSend, type HighFiveCreateParams, type HighFiveListParams, type ImportCreateParams, type ImportLog, type ImportLogListParams, type ImportResult, type Invite, type InviteCreateParams, type InviteListParams, type LeaderboardEntry, type LeaderboardParams, type ListResponse, type Member, type MemberListParams, type MemberUpdateParams, type Mention, type MentionListParams, type MentionUnreadCount, type Message, type MessageCreateParams, type Metadata, type Notification, type NotificationListParams, OfflineQueue, type OfflineQueueOptions, type OneUp, type OneUpCreateParams, type OneUpListParams, type OneUpRemaining, type OneUpSendResult, type PaginationInfo, type PaginationParams, type Player, type Puzzle, type PuzzleCompleteParams, type PuzzleCompleteResult, type PuzzleLeaderboardParams, type PuzzleLeaderboardResult, type PuzzleStreak, type Quest, type QuestHistory, type QuestHistoryParams, type QuestList, type QueueItem, type QueueResult, type QuickReply, type QuickReplyCreateParams, type QuickReplyUpdateParams, type RealtimeEvent, type RealtimeOptions, type RequestOptions, type SavedView, type SearchParams, type SearchResult, type Season, type SeasonStats, type SkillAllocateParams, type SkillAllocateResult, type SkillTree, type SlaMetrics, type SlaMetricsParams, type SlaRule, type SlaRuleCreateParams, type SlaRuleListParams, type SlaRuleUpdateParams, type StatusCreateParams, type StatusUpdateParams, Subscription$1 as Subscription, type Tag, type TagListParams, type TeamSettings, type TeamSettingsUpdateParams, type Ticket, type TicketCreateParams, type TicketCustomerSummary, type TicketListParams, type TicketStatus, type TicketUpdateParams, type TopicCustomField, type UnreadCount, type ViewCreateParams, type ViewExecuteParams, type ViewListParams, type ViewUpdateParams, type Webhook, type WebhookCreateParams, type WebhookEventData, WebhookEventType, type WebhookListParams, type WebhookListener, type WebhookListenerParams, type WebhookSubscribeParams, type WebhookSubscription, type WebhookTestResult, type WebhookTriggerTestParams, type WebhookTriggerTestResult, type WebhookUpdateParams, type WidgetSettings, type WidgetSettingsUpdateParams };
+export { type Achievement, type AchievementListParams, type ActivityEvent, type ActivityListParams, type AiAction, type AiActionParams, type AiActionResult, type AnalyticsOverview, type AnalyticsParams, type ApiResponse, type Article, type ArticleCreateParams, type ArticleListParams, type ArticleUpdateParams, type Attachment, type AttachmentListParams, type AuditLogEntry, type AuditLogListParams, type AutomationAction, type AutomationCondition, type AutomationConditions, type AutomationCreateParams, type AutomationExecution, type AutomationExecutionListParams, type AutomationListParams, type AutomationRule, type AutomationTestResult, type AutomationUpdateParams, type BillingPortal, type BillingPortalParams, type Boss, type BossDamageParams, type BossDamageResult, type BossDefeat, type BossDefeatListParams, type BossSpawnParams, type BulkDeleteParams, type BulkResult, type BulkUpdateParams, type BusinessHours, type BusinessHoursUpdateParams, CStarClient, type CStarClientConfig, CStarRealtime, type Category, type CategoryCreateParams, type CategoryListParams, type CategoryUpdateParams, type CommunityComment, type CommunityCommentCreateParams, type CommunityPost, type CommunityPostCreateParams, type CommunityPostListParams, type CommunityPostUpdateParams, type CommunityTopic, type ConnectionHandler, type Cosmetic, type CosmeticListParams, type CosmeticPreferences, type CsatSettings, type CsatSettingsUpdateParams, type CsatStats, type CsatSurvey, type CsatSurveyCreateParams, type CsatSurveyListParams, type CurrentSeason, type CustomField, type CustomFieldCreateParams, type CustomFieldListParams, type CustomFieldUpdateParams, type Customer, type CustomerCreateParams, type CustomerGroup, type CustomerGroupAddMembersParams, type CustomerGroupAddResult, type CustomerGroupCreateParams, type CustomerGroupListParams, type CustomerGroupMemberListParams, type CustomerGroupMembersResult, type CustomerGroupRemoveResult, type CustomerGroupUpdateParams, type CustomerListParams, type CustomerUpdateParams, type DeleteResponse, type ErrorHandler, type EventHandler, type ExportCreateParams, type ExportCsvParams, type ExportFilters, type ExportJsonParams, type ExportResourceType, type ExportResult, type GameConfig, type HighFive, type HighFiveCanSend, type HighFiveCreateParams, type HighFiveListParams, type ImportCreateParams, type ImportLog, type ImportLogListParams, type ImportResult, type Invite, type InviteCreateParams, type InviteListParams, type LeaderboardEntry, type LeaderboardParams, type ListResponse, type Member, type MemberListParams, type MemberUpdateParams, type Mention, type MentionListParams, type MentionUnreadCount, type Message, type MessageCreateParams, type MessageListParams, type Metadata, type Notification, type NotificationListParams, OfflineQueue, type OfflineQueueOptions, type OneUp, type OneUpCreateParams, type OneUpListParams, type OneUpRemaining, type OneUpSendResult, type PaginationInfo, type PaginationParams, type Player, type Puzzle, type PuzzleCompleteParams, type PuzzleCompleteResult, type PuzzleLeaderboardParams, type PuzzleLeaderboardResult, type PuzzleStreak, type Quest, type QuestHistory, type QuestHistoryParams, type QuestList, type QueueItem, type QueueResult, type QuickReply, type QuickReplyCreateParams, type QuickReplyUpdateParams, type RealtimeEvent, type RealtimeOptions, type RequestOptions, type SavedView, type SearchParams, type SearchResponse, type SearchResult, type Season, type SeasonStats, type SkillAllocateParams, type SkillAllocateResult, type SkillTree, type SlaMetrics, type SlaMetricsParams, type SlaRule, type SlaRuleCreateParams, type SlaRuleListParams, type SlaRuleUpdateParams, type StatusCreateParams, type StatusUpdateParams, Subscription$1 as Subscription, type Tag, type TagListParams, type TeamSettings, type TeamSettingsUpdateParams, type Ticket, type TicketCreateParams, type TicketCustomerSummary, type TicketListParams, type TicketStatus, type TicketUpdateParams, type TopicCustomField, type UnreadCount, type ViewCreateParams, type ViewExecuteParams, type ViewListParams, type ViewUpdateParams, type Webhook, type WebhookCreateParams, type WebhookEventData, WebhookEventType, type WebhookListParams, type WebhookListener, type WebhookListenerParams, type WebhookSubscribeParams, type WebhookSubscription, type WebhookTestResult, type WebhookTriggerTestParams, type WebhookTriggerTestResult, type WebhookUpdateParams, type WidgetSettings, type WidgetSettingsUpdateParams };

package/dist/index.js

@@ -237,7 +237,7 @@ function parseError(statusCode, body, retryAfter) {
 }
 
 // src/client.ts
-var SDK_VERSION = "0.17.3";
+var SDK_VERSION = "0.17.5";
 var DEFAULT_BASE_URL = "https://www.cstar.help";
 var DEFAULT_API_VERSION = "2026-03-01";
 var DEFAULT_MAX_RETRIES = 3;
@@ -343,8 +343,13 @@ var HttpClient = class {
       }
       if (response.ok) {
         if (response.status === 204) return void 0;
-        const json = await response.json();
         const headerRequestId = response.headers.get("x-request-id") ?? response.headers.get("x-cstar-request-id");
+        if (options?.responseType === "text") {
+          const text = await response.text();
+          this.captureMeta(null, headerRequestId);
+          return text;
+        }
+        const json = await response.json();
         this.captureMeta(json, headerRequestId);
         return this.unwrapEnvelope(json);
       }
@@ -1116,9 +1121,11 @@ var TicketMessagesResource = class {
   constructor(client) {
     this.client = client;
   }
-  /** List all messages on a ticket. */
-  async list(ticketId) {
-    return this.client.request("GET", `/tickets/${ticketId}/messages`);
+  /** List one page of a ticket history. Use pagination.hasMore to request the next page. */
+  async list(ticketId, params) {
+    return this.client.request("GET", `/tickets/${ticketId}/messages`, {
+      query: params ? { ...params } : void 0
+    });
   }
   /** Add a message to a ticket. */
   async create(ticketId, params, options) {
@@ -1454,11 +1461,9 @@ var QuickRepliesResource = class {
   }
   /** Reorder quick replies. */
   async reorder(orderedIds) {
-    return this.client.request(
-      "PUT",
-      "/settings/quick-replies/reorder",
-      { body: { orderedIds } }
-    );
+    return this.client.request("PUT", "/settings/quick-replies/reorder", {
+      body: { orderedIds }
+    });
   }
 };
 var SettingsResource = class {
@@ -1632,9 +1637,13 @@ var CustomFieldsResource = class {
   }
   /** Reorder custom fields within a content type. */
   async reorder(contentType, orderedIds) {
-    return this.client.request("PUT", "/custom-fields/reorder", {
-      body: { contentType, orderedIds }
-    });
+    return this.client.request(
+      "PUT",
+      "/custom-fields/reorder",
+      {
+        body: { contentType, orderedIds }
+      }
+    );
   }
 };
 
@@ -1769,11 +1778,11 @@ var ExportResource = class {
   constructor(client) {
     this.client = client;
   }
-  /** Create an export. Returns exported data synchronously. */
   async create(params, options) {
     return this.client.request("POST", "/export", {
       body: params,
-      idempotencyKey: options?.idempotencyKey
+      idempotencyKey: options?.idempotencyKey,
+      responseType: params.format === "csv" ? "text" : "json"
     });
   }
 };

package/dist/library/index.d.cts

@@ -1,4 +1,4 @@
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-b5A4wfAg.cjs';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.cjs';
 
 /** Configuration for the LibraryClient. */
 interface LibraryConfig {

package/dist/library/index.d.ts

@@ -1,4 +1,4 @@
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-b5A4wfAg.js';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.js';
 
 /** Configuration for the LibraryClient. */
 interface LibraryConfig {

package/dist/quickhelp/index.d.cts

@@ -1,4 +1,4 @@
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-b5A4wfAg.cjs';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.cjs';
 
 /**
  * Options for the QuickHelpClient. No auth — Quick Help is anonymous by

package/dist/quickhelp/index.d.ts

@@ -1,4 +1,4 @@
-export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-b5A4wfAg.js';
+export { A as ApiErrorBody, C as CStarAuthenticationError, a as CStarConflictError, b as CStarError, c as CStarFeatureDisabledError, d as CStarNotFoundError, e as CStarPermissionError, f as CStarRateLimitError, g as CStarRealtimeUnavailableError, h as CStarServerError, i as CStarValidationError, E as ErrorType, p as parseError, j as parsePublicError } from '../errors-bW8CwTn4.js';
 
 /**
  * Options for the QuickHelpClient. No auth — Quick Help is anonymous by

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cstar.help/js",
-	"version": "0.17.3",
+	"version": "0.17.5",
 	"description": "Official TypeScript SDK for the cStar customer support platform",
 	"type": "module",
 	"main": "./dist/index.cjs",