@cstar.help/js 0.4.0 → 0.5.1

package/dist/index.d.ts

@@ -419,6 +419,38 @@ interface WebhookTestResult {
     responseTimeMs: number;
     error: string | null;
 }
+/** Parameters for subscribing (REST Hooks / Zapier protocol). */
+interface WebhookSubscribeParams {
+    targetUrl: string;
+    event: string;
+}
+/** A REST Hooks subscription. */
+interface WebhookSubscription {
+    id: string;
+    object: 'webhook';
+    [key: string]: unknown;
+}
+/** Parameters for registering a CLI listener. */
+interface WebhookListenerParams {
+    forwardUrl: string;
+    events?: string[];
+}
+/** A registered CLI listener. */
+interface WebhookListener {
+    listenerId: string;
+    secret: string;
+}
+/** Parameters for triggering a test webhook event. */
+interface WebhookTriggerTestParams {
+    event: string;
+    data?: Record<string, unknown>;
+}
+/** Result of triggering a test webhook event. */
+interface WebhookTriggerTestResult {
+    event: string;
+    deliveredTo: number;
+    [key: string]: unknown;
+}
 
 /** Manage webhook endpoints. */
 declare class WebhooksResource extends BaseResource<Webhook, WebhookListParams, WebhookCreateParams, WebhookUpdateParams> {
@@ -427,6 +459,178 @@ declare class WebhooksResource extends BaseResource<Webhook, WebhookListParams,
     test(webhookId: string, params?: {
         event?: WebhookEventType;
     }): Promise<ApiResponse<WebhookTestResult>>;
+    /** 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[]>>;
+    /** Subscribe to an event (REST Hooks / Zapier protocol). */
+    subscribe(params: WebhookSubscribeParams, options?: RequestOptions): Promise<ApiResponse<WebhookSubscription>>;
+    /** Unsubscribe from an event (REST Hooks / Zapier protocol). Returns void (204 No Content). */
+    unsubscribe(subscriptionId: string): Promise<void>;
+    /** Register a CLI listener (returns listenerId and signing secret). */
+    listen(params: WebhookListenerParams, options?: RequestOptions): Promise<ApiResponse<WebhookListener>>;
+    /** Deregister a CLI listener. */
+    unlisten(listenerId: string): Promise<ApiResponse<{
+        deleted: true;
+        listenerId: string;
+    }>>;
+}
+
+/** A condition in an automation rule. */
+interface AutomationCondition {
+    field: string;
+    operator: string;
+    value?: unknown;
+}
+/** Condition groups (all must match AND at least one any must match). */
+interface AutomationConditions {
+    all: AutomationCondition[];
+    any: AutomationCondition[];
+}
+/** An action in an automation rule. */
+interface AutomationAction {
+    type: string;
+    [key: string]: unknown;
+}
+/** A cStar automation rule. */
+interface AutomationRule {
+    id: string;
+    object: 'automation_rule';
+    name: string;
+    description: string;
+    triggerEvent: string;
+    triggerFilter: Record<string, unknown>;
+    conditions: AutomationConditions;
+    actions: AutomationAction[];
+    enabled: boolean;
+    position: number;
+    stopAfter: boolean;
+    maxExecutionsPerTicket: number;
+    cooldownSeconds: number;
+    executionCount: number;
+    lastExecutedAt: string | null;
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** An automation execution log entry. */
+interface AutomationExecution {
+    id: string;
+    object: 'automation_execution';
+    ruleId: string;
+    ruleName: string | null;
+    triggerEvent: string;
+    resourceType: string;
+    resourceId: string;
+    conditionsMatched: boolean;
+    actionsExecuted: Array<{
+        action: string;
+        success: boolean;
+        error?: string;
+    }>;
+    skippedReason: string | null;
+    dryRun: boolean;
+    executionMs: number;
+    createdAt: string;
+}
+/** Parameters for listing automation rules. */
+interface AutomationListParams extends PaginationParams {
+    enabled?: boolean;
+    triggerEvent?: string;
+}
+/** Parameters for creating an automation rule. */
+interface AutomationCreateParams {
+    name: string;
+    description?: string;
+    triggerEvent: string;
+    triggerFilter?: Record<string, unknown>;
+    conditions?: AutomationConditions;
+    actions?: AutomationAction[];
+    enabled?: boolean;
+    stopAfter?: boolean;
+    maxExecutionsPerTicket?: number;
+    cooldownSeconds?: number;
+}
+/** Parameters for updating an automation rule. */
+interface AutomationUpdateParams {
+    name?: string;
+    description?: string;
+    triggerEvent?: string;
+    triggerFilter?: Record<string, unknown>;
+    conditions?: AutomationConditions;
+    actions?: AutomationAction[];
+    enabled?: boolean;
+    stopAfter?: boolean;
+    maxExecutionsPerTicket?: number;
+    cooldownSeconds?: number;
+}
+/** Parameters for listing executions. */
+interface AutomationExecutionListParams extends PaginationParams {
+    triggerEvent?: string;
+    resourceId?: string;
+}
+/** Result of a dry-run test. */
+interface AutomationTestResult {
+    wouldMatch: boolean;
+    conditionResults: {
+        all: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+            actual: unknown;
+            passed: boolean;
+        }>;
+        any: Array<{
+            field: string;
+            operator: string;
+            value: unknown;
+            actual: unknown;
+            passed: boolean;
+        }>;
+    };
+    actionsWouldExecute: Array<{
+        action: string;
+        success: boolean;
+        preview?: string;
+    }>;
+}
+
+/** Manage automation rules. */
+declare class AutomationsResource extends BaseResource<AutomationRule, AutomationListParams, AutomationCreateParams, AutomationUpdateParams> {
+    constructor(client: HttpClient);
+    /** 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[]>>;
+    /** Dry-run a rule against a specific resource (no actions executed). */
+    test(ruleId: string, params: {
+        resourceType: string;
+        resourceId: string;
+    }): Promise<ApiResponse<AutomationTestResult>>;
+    /** Get execution history for a specific rule. */
+    executions(ruleId: string, params?: AutomationExecutionListParams): Promise<ListResponse<AutomationExecution>>;
+    /** Get all execution history for the team. */
+    allExecutions(params?: AutomationExecutionListParams): Promise<ListResponse<AutomationExecution>>;
+    /** Test conditions against sample data (without a rule). */
+    evaluate(params: {
+        conditions: {
+            all: Array<{
+                field: string;
+                operator: string;
+                value?: unknown;
+            }>;
+            any: Array<{
+                field: string;
+                operator: string;
+                value?: unknown;
+            }>;
+        };
+        data: Record<string, unknown>;
+        changes?: Record<string, unknown>;
+    }): Promise<ApiResponse<{
+        matched: boolean;
+        conditionResults: unknown;
+    }>>;
 }
 
 /** A cStar article category. */
@@ -572,6 +776,1502 @@ declare class CommunityTopicsResource extends BaseResource<CommunityTopic, Recor
     constructor(client: HttpClient);
 }
 
+/** A team member (agent). */
+interface Member {
+    id: string;
+    object: 'member';
+    userId: string;
+    name: string;
+    email: string;
+    avatarUrl: string | null;
+    role: string;
+    roleDisplayName: string;
+    permissions: string[];
+    level: number;
+    xp: number;
+    joinedAt: string;
+}
+/** Parameters for listing members. */
+interface MemberListParams extends PaginationParams {
+    role?: string;
+}
+/** Parameters for updating a member. */
+interface MemberUpdateParams {
+    role?: string;
+}
+/** A team invite. */
+interface Invite {
+    id: string;
+    object: 'invite';
+    email: string;
+    role: string;
+    status: string;
+    inviterName: string | null;
+    inviterEmail: string | null;
+    createdAt: string;
+    expiresAt: string;
+}
+/** Parameters for listing invites. */
+interface InviteListParams extends PaginationParams {
+    status?: string;
+}
+/** Parameters for creating an invite. */
+interface InviteCreateParams {
+    email: string;
+    role?: string;
+}
+
+/** Manage team invites as a sub-resource. */
+declare class InvitesResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List pending invites. */
+    list(params?: InviteListParams): Promise<ListResponse<Invite>>;
+    /** Create and send a new invite. */
+    create(params: InviteCreateParams, options?: RequestOptions): Promise<ApiResponse<Invite>>;
+    /** Revoke a pending invite. */
+    del(inviteId: string): Promise<ApiResponse<DeleteResponse>>;
+}
+/** Manage team members. */
+declare class MembersResource {
+    private readonly client;
+    /** Sub-resource for team invites. */
+    readonly invites: InvitesResource;
+    constructor(client: HttpClient);
+    /** List all team members. */
+    list(params?: MemberListParams): Promise<ListResponse<Member>>;
+    /** Get a single member by membership ID. */
+    get(memberId: string): Promise<ApiResponse<Member>>;
+    /** Update a member's role. */
+    update(memberId: string, params: MemberUpdateParams): Promise<ApiResponse<Member>>;
+    /** Remove a member from the team. */
+    del(memberId: string): Promise<ApiResponse<DeleteResponse>>;
+}
+
+/** Team settings object. */
+interface TeamSettings {
+    object: 'settings';
+    teamName: string;
+    teamSlug: string;
+    [key: string]: unknown;
+}
+/** Parameters for updating team settings. */
+interface TeamSettingsUpdateParams {
+    [key: string]: unknown;
+}
+/** A ticket status configuration. */
+interface TicketStatus {
+    key: string;
+    object: 'status';
+    label: string;
+    color: string;
+    position: number;
+    isDefault: boolean;
+    isProtected: boolean;
+}
+/** Parameters for creating a status. */
+interface StatusCreateParams {
+    key: string;
+    label: string;
+    color?: string;
+}
+/** Parameters for updating a status. */
+interface StatusUpdateParams {
+    label?: string;
+    color?: string;
+}
+/** A quick reply template. */
+interface QuickReply {
+    id: string;
+    object: 'quick_reply';
+    title: string;
+    body: string;
+    category: string | null;
+    position: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Parameters for creating a quick reply. */
+interface QuickReplyCreateParams {
+    title: string;
+    body: string;
+    category?: string;
+}
+/** Parameters for updating a quick reply. */
+interface QuickReplyUpdateParams {
+    title?: string;
+    body?: string;
+    category?: string;
+}
+/** Business hours configuration. */
+interface BusinessHours {
+    object: 'business_hours';
+    enabled: boolean;
+    timezone: string;
+    schedule: Record<string, {
+        enabled: boolean;
+        start: string;
+        end: string;
+    }>;
+}
+/** Parameters for updating business hours. */
+interface BusinessHoursUpdateParams {
+    enabled?: boolean;
+    timezone?: string;
+    schedule?: Record<string, {
+        enabled: boolean;
+        start: string;
+        end: string;
+    }>;
+}
+/** Widget configuration. */
+interface WidgetSettings {
+    object: 'widget_settings';
+    [key: string]: unknown;
+}
+/** Parameters for updating widget settings. */
+interface WidgetSettingsUpdateParams {
+    [key: string]: unknown;
+}
+
+/** Manage ticket status configurations. */
+declare class StatusesResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List all statuses. */
+    list(): Promise<ApiResponse<TicketStatus[]>>;
+    /** Create a new status. */
+    create(params: StatusCreateParams, options?: RequestOptions): Promise<ApiResponse<TicketStatus>>;
+    /** Update a status. */
+    update(statusKey: string, params: StatusUpdateParams): Promise<ApiResponse<TicketStatus>>;
+    /** Delete a status. */
+    del(statusKey: string): Promise<ApiResponse<DeleteResponse>>;
+    /** Reorder statuses. */
+    reorder(orderedKeys: string[]): Promise<ApiResponse<TicketStatus[]>>;
+}
+/** Manage quick reply templates. */
+declare class QuickRepliesResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List all quick replies. */
+    list(): Promise<ApiResponse<QuickReply[]>>;
+    /** Create a new quick reply. */
+    create(params: QuickReplyCreateParams, options?: RequestOptions): Promise<ApiResponse<QuickReply>>;
+    /** Update a quick reply. */
+    update(replyId: string, params: QuickReplyUpdateParams): Promise<ApiResponse<QuickReply>>;
+    /** Delete a quick reply. */
+    del(replyId: string): Promise<ApiResponse<DeleteResponse>>;
+    /** Reorder quick replies. */
+    reorder(orderedIds: string[]): Promise<ApiResponse<QuickReply[]>>;
+}
+/** Manage team settings. */
+declare class SettingsResource {
+    private readonly client;
+    /** Ticket status configuration. */
+    readonly statuses: StatusesResource;
+    /** Quick reply templates. */
+    readonly quickReplies: QuickRepliesResource;
+    constructor(client: HttpClient);
+    /** Get all team settings. */
+    get(): Promise<ApiResponse<TeamSettings>>;
+    /** Update team settings (bulk). */
+    update(params: TeamSettingsUpdateParams): Promise<ApiResponse<TeamSettings>>;
+    /** Get business hours configuration. */
+    getBusinessHours(): Promise<ApiResponse<BusinessHours>>;
+    /** Update business hours configuration. */
+    updateBusinessHours(params: BusinessHoursUpdateParams): Promise<ApiResponse<BusinessHours>>;
+    /** Get widget settings. */
+    getWidget(): Promise<ApiResponse<WidgetSettings>>;
+    /** Update widget settings. */
+    updateWidget(params: WidgetSettingsUpdateParams): Promise<ApiResponse<WidgetSettings>>;
+}
+
+/** A notification. */
+interface Notification {
+    id: string;
+    object: 'notification';
+    type: string;
+    title: string;
+    body: string | null;
+    resourceType: string | null;
+    resourceId: string | null;
+    actorId: string | null;
+    actorName: string | null;
+    read: boolean;
+    readAt: string | null;
+    createdAt: string;
+}
+/** Parameters for listing notifications. */
+interface NotificationListParams extends PaginationParams {
+    unreadOnly?: boolean;
+}
+/** Unread count response. */
+interface UnreadCount {
+    object: 'unread_count';
+    count: number;
+}
+
+/** Manage notifications. */
+declare class NotificationsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List notifications for a user. */
+    list(params: NotificationListParams & {
+        userId: string;
+    }): Promise<ListResponse<Notification>>;
+    /** Get unread notification count for a user. */
+    unreadCount(userId: string): Promise<ApiResponse<UnreadCount>>;
+    /** Mark a single notification as read. */
+    markRead(notificationId: string, userId: string): Promise<ApiResponse<Notification>>;
+    /** Mark all notifications as read. */
+    markAllRead(userId: string): Promise<ApiResponse<{
+        markedRead: number;
+    }>>;
+    /** Delete (dismiss) a notification. For broadcast notifications, pass userId as a query param. */
+    del(notificationId: string, params?: {
+        userId?: string;
+    }): Promise<ApiResponse<DeleteResponse>>;
+}
+
+/** A mention. */
+interface Mention {
+    id: string;
+    object: 'mention';
+    senderId: string;
+    senderName: string | null;
+    recipientId: string;
+    recipientName: string | null;
+    ticketId: string | null;
+    ticketTitle: string | null;
+    isRead: boolean;
+    createdAt: string;
+}
+/** Parameters for listing mentions. */
+interface MentionListParams extends PaginationParams {
+    isRead?: string;
+}
+/** Unread mention count. */
+interface MentionUnreadCount {
+    unreadCount: number;
+}
+
+/** Manage @mentions. */
+declare class MentionsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List mentions for a user. */
+    list(params: MentionListParams & {
+        userId: string;
+    }): Promise<ListResponse<Mention>>;
+    /** Get unread mention count for a user. */
+    unreadCount(userId: string): Promise<ApiResponse<MentionUnreadCount>>;
+    /** Mark a single mention as read. */
+    markRead(mentionId: string): Promise<ApiResponse<{
+        id: string;
+        isRead: true;
+    }>>;
+    /** Mark all mentions as read for a user. */
+    markAllRead(userId: string): Promise<ApiResponse<{
+        markedRead: number;
+    }>>;
+}
+
+/** A file attachment. */
+interface Attachment {
+    id: string;
+    object: 'attachment';
+    filename: string;
+    contentType: string;
+    size: number;
+    url: string;
+    ticketId: string | null;
+    uploadedBy: string | null;
+    createdAt: string;
+}
+/** Parameters for listing attachments. */
+interface AttachmentListParams extends PaginationParams {
+    ticketId?: string;
+}
+
+/** Manage file attachments. */
+declare class AttachmentsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List attachments. */
+    list(params?: AttachmentListParams): Promise<ListResponse<Attachment>>;
+    /** Get a single attachment. */
+    get(attachmentId: string): Promise<ApiResponse<Attachment>>;
+    /** Delete an attachment. */
+    del(attachmentId: string): Promise<ApiResponse<DeleteResponse>>;
+}
+
+/** A custom field definition. */
+interface CustomField {
+    id: string;
+    object: 'custom_field';
+    name: string;
+    key: string;
+    type: 'text' | 'number' | 'select' | 'multiselect' | 'date' | 'boolean';
+    entityType: 'tickets' | 'customers';
+    description: string | null;
+    required: boolean;
+    options: string[] | null;
+    position: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Parameters for listing custom fields. */
+interface CustomFieldListParams extends PaginationParams {
+    entityType?: 'tickets' | 'customers';
+}
+/** Parameters for creating a custom field. */
+interface CustomFieldCreateParams {
+    name: string;
+    key: string;
+    type: 'text' | 'number' | 'select' | 'multiselect' | 'date' | 'boolean';
+    entityType: 'tickets' | 'customers';
+    description?: string;
+    required?: boolean;
+    options?: string[];
+}
+/** Parameters for updating a custom field. */
+interface CustomFieldUpdateParams {
+    name?: string;
+    description?: string;
+    required?: boolean;
+    options?: string[];
+}
+
+/** Manage custom field definitions. */
+declare class CustomFieldsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List custom fields. */
+    list(params?: CustomFieldListParams): Promise<ListResponse<CustomField>>;
+    /** Get a single custom field. */
+    get(fieldId: string): Promise<ApiResponse<CustomField>>;
+    /** Create a custom field. */
+    create(params: CustomFieldCreateParams, options?: RequestOptions): Promise<ApiResponse<CustomField>>;
+    /** Update a custom field. */
+    update(fieldId: string, params: CustomFieldUpdateParams): Promise<ApiResponse<CustomField>>;
+    /** Delete a custom field. */
+    del(fieldId: string): Promise<ApiResponse<DeleteResponse>>;
+    /** Reorder custom fields. */
+    reorder(orderedIds: string[]): Promise<ApiResponse<CustomField[]>>;
+}
+
+/** An SLA rule. */
+interface SlaRule {
+    id: string;
+    object: 'sla_rule';
+    name: string;
+    description: string | null;
+    priority: string;
+    responseTarget: number;
+    resolutionTarget: number;
+    businessHoursOnly: boolean;
+    enabled: boolean;
+    position: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Parameters for listing SLA rules. */
+interface SlaRuleListParams extends PaginationParams {
+    enabled?: boolean;
+}
+/** Parameters for creating an SLA rule. */
+interface SlaRuleCreateParams {
+    name: string;
+    description?: string;
+    priority: string;
+    responseTarget: number;
+    resolutionTarget: number;
+    businessHoursOnly?: boolean;
+    enabled?: boolean;
+}
+/** Parameters for updating an SLA rule. */
+interface SlaRuleUpdateParams {
+    name?: string;
+    description?: string;
+    priority?: string;
+    responseTarget?: number;
+    resolutionTarget?: number;
+    businessHoursOnly?: boolean;
+    enabled?: boolean;
+}
+/** Parameters for SLA metrics query. */
+interface SlaMetricsParams {
+    period?: 'day' | 'week' | 'month' | 'quarter';
+    startDate?: string;
+    endDate?: string;
+    agentId?: string;
+}
+/** SLA compliance metrics response. */
+interface SlaMetrics {
+    object: 'sla_metrics';
+    period: string;
+    [key: string]: unknown;
+}
+
+/** Manage SLA rules and metrics. */
+declare class SlaResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List SLA rules. */
+    list(params?: SlaRuleListParams): Promise<ListResponse<SlaRule>>;
+    /** Create an SLA rule. */
+    create(params: SlaRuleCreateParams, options?: RequestOptions): Promise<ApiResponse<SlaRule>>;
+    /** Update an SLA rule. */
+    update(ruleId: string, params: SlaRuleUpdateParams): Promise<ApiResponse<SlaRule>>;
+    /** 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[]>>;
+    /** Get SLA compliance metrics. */
+    metrics(params?: SlaMetricsParams): Promise<ApiResponse<SlaMetrics>>;
+}
+
+/**
+ * Analytics response. Shape varies by `type` parameter:
+ * - overview/tickets: tickets, priorities, statusBreakdown, responseTime, resolutionTime
+ * - performance: agents array
+ * - library: totalArticles, publishedArticles, draftArticles
+ */
+interface AnalyticsOverview {
+    object: 'analytics';
+    type: string;
+    period: string;
+    /** Present for type=overview and type=tickets */
+    tickets?: {
+        total: number;
+        new: number;
+        closed: number;
+        open: number;
+    };
+    priorities?: Record<string, number>;
+    statusBreakdown?: Record<string, number>;
+    responseTime?: {
+        avgSeconds: number | null;
+        samplesCount: number;
+    };
+    resolutionTime?: {
+        avgSeconds: number | null;
+        samplesCount: number;
+    };
+    /** Present for type=performance */
+    agents?: Array<{
+        agentId: string;
+        ticketsClosed: number;
+        avgResponseSeconds: number | null;
+        goldTier: number;
+        missedSla: number;
+    }>;
+    /** Present for type=library */
+    totalArticles?: number;
+    publishedArticles?: number;
+    draftArticles?: number;
+    [key: string]: unknown;
+}
+/** Analytics query parameters. */
+interface AnalyticsParams {
+    type?: 'overview' | 'tickets' | 'performance' | 'library';
+    period?: 'day' | 'week' | 'month' | 'quarter';
+    agentId?: string;
+}
+/** CSAT statistics (from /csat/stats). */
+interface CsatStats {
+    object: 'csat_stats';
+    period: string;
+    totalSent: number;
+    totalCompleted: number;
+    responseRate: number;
+    averageRating: number | null;
+    distribution: Record<string, number>;
+    positiveRate: number;
+}
+/** A CSAT survey (from /csat/surveys). */
+interface CsatSurvey {
+    id: string;
+    object: 'csat_survey';
+    ticketId: string;
+    customerId: string | null;
+    agentId: string | null;
+    rating: number | null;
+    comment: string | null;
+    sentAt: string | null;
+    completedAt: string | null;
+    expiresAt: string | null;
+    createdAt: string;
+}
+/** Parameters for listing CSAT surveys. */
+interface CsatSurveyListParams extends PaginationParams {
+    completed?: string;
+    agentId?: string;
+}
+/** Parameters for creating a CSAT survey. */
+interface CsatSurveyCreateParams {
+    ticketId: string;
+    customerId?: string;
+    agentId?: string;
+}
+/** CSAT settings. */
+interface CsatSettings {
+    object: 'csat_settings';
+    enabled: boolean;
+    delayMinutes: number;
+    expirationDays: number;
+}
+/** Parameters for updating CSAT settings. */
+interface CsatSettingsUpdateParams {
+    enabled?: boolean;
+    delayMinutes?: number;
+    expirationDays?: number;
+}
+
+/** Manage CSAT surveys. */
+declare class CsatSurveysResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List CSAT surveys. */
+    list(params?: CsatSurveyListParams): Promise<ListResponse<CsatSurvey>>;
+    /** Get a single CSAT survey. */
+    get(surveyId: string): Promise<ApiResponse<CsatSurvey>>;
+    /** Create and send a CSAT survey. */
+    create(params: CsatSurveyCreateParams): Promise<ApiResponse<CsatSurvey>>;
+}
+/** Access analytics and CSAT data. */
+declare class AnalyticsResource {
+    private readonly client;
+    /** CSAT surveys sub-resource. */
+    readonly csatSurveys: CsatSurveysResource;
+    constructor(client: HttpClient);
+    /** Get analytics data. Specify type to control the response shape. */
+    get(params?: AnalyticsParams): Promise<ApiResponse<AnalyticsOverview>>;
+    /** Get analytics overview (shortcut for type=overview). */
+    overview(params?: Omit<AnalyticsParams, 'type'>): Promise<ApiResponse<AnalyticsOverview>>;
+    /** Get agent performance stats (shortcut for type=performance). */
+    performance(params?: Omit<AnalyticsParams, 'type'> & {
+        agentId?: string;
+    }): Promise<ApiResponse<AnalyticsOverview>>;
+    /** Get library analytics (shortcut for type=library). */
+    library(params?: Omit<AnalyticsParams, 'type'>): Promise<ApiResponse<AnalyticsOverview>>;
+    /** Get CSAT statistics. */
+    csatStats(params?: {
+        period?: string;
+        agentId?: string;
+    }): Promise<ApiResponse<CsatStats>>;
+    /** Get CSAT settings. */
+    csatSettings(): Promise<ApiResponse<CsatSettings>>;
+    /** Update CSAT settings. */
+    updateCsatSettings(params: CsatSettingsUpdateParams): Promise<ApiResponse<CsatSettings>>;
+}
+
+/** Bulk operation result. */
+interface BulkResult {
+    object: 'bulk_result';
+    action: string;
+    resource: string;
+    total: number;
+    succeeded: number;
+    failed: number;
+    errors: Array<{
+        id: string;
+        error: string;
+    }>;
+}
+/** Parameters for a bulk update. */
+interface BulkUpdateParams {
+    resource: 'tickets' | 'customers' | 'articles';
+    ids: string[];
+    data: Record<string, unknown>;
+}
+/** Parameters for a bulk delete. */
+interface BulkDeleteParams {
+    resource: 'tickets' | 'customers' | 'articles';
+    ids: string[];
+}
+
+/** Perform bulk operations on resources. */
+declare class BulkResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Bulk update resources. */
+    update(params: BulkUpdateParams, options?: RequestOptions): Promise<ApiResponse<BulkResult>>;
+    /** Bulk delete resources. */
+    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. */
+interface ExportResult {
+    object: 'export';
+    format: string;
+    resources: Record<string, unknown[]> | string;
+    totalRows: number;
+}
+
+/** Import request parameters. */
+interface ImportCreateParams {
+    resource: 'tickets' | 'customers' | 'articles';
+    records: Record<string, unknown>[];
+    mergeStrategy?: 'skip' | 'overwrite' | 'merge';
+}
+/** Import result. */
+interface ImportResult {
+    object: 'import_result';
+    resource: string;
+    total: number;
+    created: number;
+    updated: number;
+    skipped: number;
+    errors: Array<{
+        index: number;
+        error: string;
+    }>;
+}
+/** Import log entry. */
+interface ImportLog {
+    id: string;
+    object: 'import_log';
+    resource: string;
+    status: string;
+    totalRecords: number;
+    created: number;
+    updated: number;
+    skipped: number;
+    errors: number;
+    createdAt: string;
+}
+/** Parameters for listing import logs. */
+interface ImportLogListParams extends PaginationParams {
+    resource?: string;
+}
+
+/** Export data from your team. */
+declare class ExportResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Create an export. Returns exported data synchronously. */
+    create(params: ExportCreateParams, options?: RequestOptions): Promise<ApiResponse<ExportResult>>;
+}
+/** Import data into your team. */
+declare class ImportResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Run an import. Processes records synchronously (max 500). */
+    create(params: ImportCreateParams, options?: RequestOptions): Promise<ApiResponse<ImportResult>>;
+    /** List import history logs. */
+    logs(params?: ImportLogListParams): Promise<ListResponse<ImportLog>>;
+    /** Get a single import log. */
+    getLog(logId: string): Promise<ApiResponse<ImportLog>>;
+}
+
+/** An audit log entry. */
+interface AuditLogEntry {
+    id: string;
+    object: 'audit_log_entry';
+    action: string;
+    resourceType: string;
+    resourceId: string | null;
+    actorId: string | null;
+    actorName: string | null;
+    actorType: string;
+    details: Record<string, unknown>;
+    ipAddress: string | null;
+    createdAt: string;
+}
+/** Parameters for listing audit log entries. */
+interface AuditLogListParams extends PaginationParams {
+    action?: string;
+    resourceType?: string;
+    resourceId?: string;
+    actorId?: string;
+    startDate?: string;
+    endDate?: string;
+}
+
+/** Access the audit log. */
+declare class AuditLogResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List audit log entries. */
+    list(params?: AuditLogListParams): Promise<ListResponse<AuditLogEntry>>;
+}
+
+/** Search result item. Shape varies by type. */
+interface SearchResult {
+    type: 'ticket' | 'customer' | 'article';
+    id: string;
+    /** Title (tickets, articles) or name (customers). */
+    title?: string;
+    name?: string;
+    email?: string;
+    status?: string;
+    priority?: string;
+    [key: string]: unknown;
+}
+/** Search parameters. */
+interface SearchParams {
+    query: string;
+    types?: Array<'tickets' | 'customers' | 'articles'>;
+    limit?: number;
+}
+
+/** 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[]>>;
+}
+
+/** A tag with usage count. */
+interface Tag {
+    object: 'tag';
+    name: string;
+    count: number;
+}
+/** Parameters for listing tags. */
+interface TagListParams extends PaginationParams {
+    search?: string;
+}
+
+/** Manage tags. */
+declare class TagsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List all tags with usage counts. */
+    list(params?: TagListParams): Promise<ListResponse<Tag>>;
+    /** Create a tag. */
+    create(name: string, options?: RequestOptions): Promise<ApiResponse<Tag>>;
+    /** Delete a tag. */
+    del(name: string): Promise<ApiResponse<DeleteResponse>>;
+}
+
+/** An activity/timeline event. */
+interface ActivityEvent {
+    id: string;
+    object: 'activity';
+    type: string;
+    resourceType: string;
+    resourceId: string | null;
+    actorId: string | null;
+    actorName: string | null;
+    description: string;
+    details: Record<string, unknown>;
+    createdAt: string;
+}
+/** Parameters for listing activity. */
+interface ActivityListParams extends PaginationParams {
+    resourceType?: string;
+    resourceId?: string;
+    type?: string;
+}
+
+/** Access the activity feed. */
+declare class ActivityResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List recent activity events. */
+    list(params?: ActivityListParams): Promise<ListResponse<ActivityEvent>>;
+}
+
+/** A customer group/segment. */
+interface CustomerGroup {
+    id: string;
+    object: 'customer_group';
+    name: string;
+    description: string | null;
+    filters: Record<string, unknown>;
+    customerCount: number;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Parameters for listing customer groups. */
+interface CustomerGroupListParams extends PaginationParams {
+    search?: string;
+}
+/** Parameters for creating a customer group. */
+interface CustomerGroupCreateParams {
+    name: string;
+    description?: string;
+    filters?: Record<string, unknown>;
+}
+/** Parameters for updating a customer group. */
+interface CustomerGroupUpdateParams {
+    name?: string;
+    description?: string;
+    filters?: Record<string, unknown>;
+}
+/** Parameters for listing group members. */
+interface CustomerGroupMemberListParams extends PaginationParams {
+}
+/** Parameters for adding members to a group. */
+interface CustomerGroupAddMembersParams {
+    customerId?: string;
+    customerIds?: string[];
+}
+/** Group members list result. */
+interface CustomerGroupMembersResult {
+    data: Array<{
+        id: string;
+        object: 'customer';
+        name: string | null;
+        email: string | null;
+        sentiment: string;
+        tags: string[];
+        joinedGroupAt: string;
+    }>;
+    pagination: {
+        total: number;
+        page: number;
+        pageSize: number;
+        hasMore: boolean;
+    };
+}
+/** Result of adding members to a group. */
+interface CustomerGroupAddResult {
+    added: number;
+    total: number;
+    skipped: number;
+}
+/** Result of removing a member from a group. */
+interface CustomerGroupRemoveResult {
+    removed: true;
+    customerId: string;
+    groupId: string;
+}
+
+/** Manage group memberships as a sub-resource. */
+declare class CustomerGroupMembersResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List members in a group. */
+    list(groupId: string, params?: CustomerGroupMemberListParams): Promise<ApiResponse<CustomerGroupMembersResult>>;
+    /** Add member(s) to a group. */
+    add(groupId: string, params: CustomerGroupAddMembersParams, options?: RequestOptions): Promise<ApiResponse<CustomerGroupAddResult>>;
+    /** Remove a member from a group. */
+    remove(groupId: string, customerId: string): Promise<ApiResponse<CustomerGroupRemoveResult>>;
+}
+/** Manage customer groups/segments. */
+declare class CustomerGroupsResource extends BaseResource<CustomerGroup, CustomerGroupListParams, CustomerGroupCreateParams, CustomerGroupUpdateParams> {
+    /** Sub-resource for group memberships. */
+    readonly members: CustomerGroupMembersResource;
+    constructor(client: HttpClient);
+}
+
+/** Player stats. */
+interface Player {
+    object: 'player';
+    userId: string;
+    name: string | null;
+    level: number;
+    xp: number;
+    xpToNextLevel: number;
+    totalXp: number;
+    streak: number;
+    ticketsResolved: number;
+    rank: number | null;
+    scores: {
+        daily: number;
+        weekly: number;
+        allTime: number;
+    };
+    [key: string]: unknown;
+}
+/** Boss state. */
+interface Boss {
+    object: 'boss';
+    active: boolean;
+    name: string | null;
+    title: string | null;
+    difficulty: string | null;
+    health: number;
+    maxHealth: number;
+    healthPercent: number;
+    abilities: Record<string, unknown> | null;
+    participants: Array<{
+        userId: string;
+        name: string | null;
+        damage: number;
+    }>;
+    spawnedAt: string | null;
+}
+/** Boss damage result. */
+interface BossDamageResult {
+    object: 'boss_damage';
+    damage: number;
+    bossHealth: number;
+    bossMaxHealth: number;
+    defeated: boolean;
+    [key: string]: unknown;
+}
+/** Boss defeat record. */
+interface BossDefeat {
+    id: string;
+    object: 'boss_defeat';
+    bossName: string;
+    difficulty: string;
+    defeatedAt: string;
+    participants: Array<{
+        userId: string;
+        name: string | null;
+        damage: number;
+    }>;
+    [key: string]: unknown;
+}
+/** Parameters for listing boss defeats. */
+interface BossDefeatListParams extends PaginationParams {
+}
+/** Parameters for spawning a boss. */
+interface BossSpawnParams {
+    difficulty?: 'easy' | 'medium' | 'hard';
+}
+/** Parameters for dealing boss damage. */
+interface BossDamageParams {
+    userId: string;
+    ticketId: string;
+}
+/** Leaderboard entry. */
+interface LeaderboardEntry {
+    object: 'leaderboard_entry';
+    rank: number;
+    userId: string;
+    name: string | null;
+    avatarUrl: string | null;
+    score: number;
+    level: number;
+}
+/** Leaderboard parameters. */
+interface LeaderboardParams extends PaginationParams {
+    period?: 'daily' | 'weekly' | 'allTime';
+}
+/** An achievement. */
+interface Achievement {
+    id: string;
+    object: 'achievement';
+    name: string;
+    description: string | null;
+    category: string | null;
+    icon: string | null;
+    xpReward: number;
+    unlocked: boolean;
+    unlockedAt: string | null;
+    progress?: {
+        current: number;
+        target: number;
+    };
+}
+/** Parameters for listing achievements. */
+interface AchievementListParams extends PaginationParams {
+    category?: string;
+}
+/** A daily quest. */
+interface Quest {
+    id: string;
+    object: 'quest';
+    title: string;
+    description: string | null;
+    type: string;
+    target: number;
+    current: number;
+    completed: boolean;
+    xpReward: number;
+    completedAt: string | null;
+}
+/** A daily puzzle. */
+interface Puzzle {
+    id: string;
+    object: 'puzzle';
+    type: string;
+    difficulty: string;
+    data: Record<string, unknown>;
+    completed: boolean;
+    xpReward: number;
+}
+/** Puzzle completion parameters. */
+interface PuzzleCompleteParams {
+    userId: string;
+    answer: string;
+}
+/** Puzzle completion result. */
+interface PuzzleCompleteResult {
+    object: 'puzzle_result';
+    correct: boolean;
+    xpAwarded: number;
+    streak: number;
+}
+/** Puzzle streak info. */
+interface PuzzleStreak {
+    object: 'puzzle_streak';
+    userId: string;
+    currentStreak: number;
+    longestStreak: number;
+    totalCompleted: number;
+}
+/** A one-up (kudos to a teammate). */
+interface OneUp {
+    id: string;
+    object: 'one_up';
+    senderId: string;
+    senderName: string | null;
+    recipientId: string;
+    recipientName: string | null;
+    message: string | null;
+    createdAt: string;
+}
+/** Parameters for listing one-ups. */
+interface OneUpListParams extends PaginationParams {
+    userId?: string;
+}
+/** Parameters for sending a one-up. */
+interface OneUpCreateParams {
+    recipientId: string;
+    message?: string;
+    userId: string;
+}
+/** Remaining one-ups info. */
+interface OneUpRemaining {
+    object: 'one_up_remaining';
+    remaining: number;
+    limit: number;
+    resetsAt: string;
+}
+/** A high five (kudos between teams). */
+interface HighFive {
+    id: string;
+    object: 'high_five';
+    senderTeamId: string;
+    senderTeamName: string | null;
+    recipientTeamId: string;
+    recipientTeamName: string | null;
+    senderId: string;
+    senderName: string | null;
+    message: string | null;
+    createdAt: string;
+}
+/** Parameters for listing high fives. */
+interface HighFiveListParams extends PaginationParams {
+}
+/** Parameters for sending a high five. */
+interface HighFiveCreateParams {
+    recipientTeamId: string;
+    message?: string;
+    userId: string;
+}
+/** Can-send check result. */
+interface HighFiveCanSend {
+    object: 'high_five_can_send';
+    canSend: boolean;
+    reason: string | null;
+}
+/** An unlocked cosmetic. */
+interface Cosmetic {
+    id: string;
+    object: 'cosmetic';
+    type: string;
+    name: string;
+    rarity: string | null;
+    unlockedAt: string;
+}
+/** Cosmetic preferences. */
+interface CosmeticPreferences {
+    object: 'cosmetic_preferences';
+    [key: string]: unknown;
+}
+/** A game season. */
+interface Season {
+    id: string;
+    object: 'season';
+    name: string;
+    number: number;
+    startDate: string;
+    endDate: string;
+    active: boolean;
+    daysRemaining: number | null;
+}
+/** Season stats for a user. */
+interface SeasonStats {
+    object: 'season_stats';
+    seasonId: string;
+    userId: string;
+    xp: number;
+    level: number;
+    ticketsResolved: number;
+    [key: string]: unknown;
+}
+/** Skill tree data. */
+interface SkillTree {
+    object: 'skill_tree';
+    skills: Array<{
+        id: string;
+        name: string;
+        description: string;
+        category: string;
+        maxLevel: number;
+        currentLevel: number;
+        bonuses: Record<string, unknown>;
+    }>;
+    availablePoints: number;
+    totalPointsSpent: number;
+}
+/** Skill allocation parameters. */
+interface SkillAllocateParams {
+    skillId: string;
+    userId: string;
+}
+/** Skill allocation result. */
+interface SkillAllocateResult {
+    object: 'skill_allocate';
+    skillId: string;
+    newLevel: number;
+    remainingPoints: number;
+}
+/** Game balance configuration (read-only constants from /game/config). */
+interface GameConfig {
+    object: 'game_config';
+    rewards: Record<string, unknown>;
+    streaks: Record<string, unknown>;
+    combo: Record<string, unknown>;
+    boss: Record<string, unknown>;
+    scoring: Record<string, unknown>;
+    leveling: Record<string, unknown>;
+    social: Record<string, unknown>;
+}
+
+declare class BossResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Get current boss state. */
+    current(): Promise<ApiResponse<Boss>>;
+    /** Check if a boss is active (lightweight). */
+    isActive(): Promise<ApiResponse<{
+        active: boolean;
+    }>>;
+    /** Spawn a new boss. */
+    spawn(params?: BossSpawnParams, options?: RequestOptions): Promise<ApiResponse<Boss>>;
+    /** Deal damage to the current boss. */
+    damage(params: BossDamageParams, options?: RequestOptions): Promise<ApiResponse<BossDamageResult>>;
+    /** List boss defeat history. */
+    defeats(params?: BossDefeatListParams): Promise<ListResponse<BossDefeat>>;
+    /** Get a single defeat record. */
+    getDefeat(defeatId: string): Promise<ApiResponse<BossDefeat>>;
+}
+declare class AchievementsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List all achievements with progress. */
+    list(params?: AchievementListParams): Promise<ApiResponse<{
+        object: 'achievement_list';
+        data: Achievement[];
+        summary: {
+            total: number;
+            unlocked: number;
+            totalXpEarned: number;
+            totalGoldEarned: number;
+            byCategory: Record<string, {
+                total: number;
+                unlocked: number;
+            }>;
+            byRarity: Record<string, {
+                total: number;
+                unlocked: number;
+            }>;
+        };
+    }>>;
+    /** List unlocked achievements only. */
+    unlocked(params?: {
+        userId: string;
+    }): Promise<ApiResponse<Achievement[]>>;
+    /** Get a single achievement. */
+    get(achievementId: string, params?: {
+        userId?: string;
+    }): Promise<ApiResponse<Achievement>>;
+    /** Get recently unlocked achievements across the team. */
+    recent(params?: {
+        limit?: number;
+    }): Promise<ApiResponse<{
+        object: 'list';
+        data: Achievement[];
+    }>>;
+}
+declare class GameActivityResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Get the team activity feed. */
+    list(params?: {
+        limit?: number;
+        before?: string;
+    }): Promise<ApiResponse<{
+        object: 'list';
+        data: unknown[];
+        cursor: string | null;
+    }>>;
+    /** Get activity for a specific member. */
+    forMember(memberId: string, params?: {
+        limit?: number;
+    }): Promise<ApiResponse<{
+        object: 'list';
+        data: unknown[];
+    }>>;
+}
+declare class QuestsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Get today's quests. */
+    today(params?: {
+        userId?: string;
+    }): Promise<ApiResponse<Quest[]>>;
+    /** Get quest history. */
+    history(params?: {
+        userId?: string;
+        page?: number;
+        pageSize?: number;
+    }): Promise<ApiResponse<unknown>>;
+}
+declare class PuzzlesResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Get today's puzzle. */
+    today(params?: {
+        userId?: string;
+    }): Promise<ApiResponse<Puzzle>>;
+    /** Submit a puzzle answer. */
+    complete(params: PuzzleCompleteParams, options?: RequestOptions): Promise<ApiResponse<PuzzleCompleteResult>>;
+    /** Get puzzle streak for a user. */
+    streak(params: {
+        userId: string;
+    }): Promise<ApiResponse<PuzzleStreak>>;
+    /** Get puzzle leaderboard. */
+    leaderboard(params?: {
+        type?: 'scores' | 'streaks';
+        limit?: number;
+    }): Promise<ApiResponse<unknown>>;
+}
+declare class OneUpsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List one-ups. */
+    list(params?: OneUpListParams): Promise<ListResponse<OneUp>>;
+    /** Send a one-up. */
+    send(params: OneUpCreateParams, options?: RequestOptions): Promise<ApiResponse<OneUp>>;
+    /** Check remaining free one-ups today. */
+    remaining(params: {
+        userId: string;
+    }): Promise<ApiResponse<OneUpRemaining>>;
+}
+declare class HighFivesResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List high fives. */
+    list(params?: HighFiveListParams): Promise<ListResponse<HighFive>>;
+    /** Send a high five. */
+    send(params: HighFiveCreateParams, options?: RequestOptions): Promise<ApiResponse<HighFive>>;
+    /** Check if you can send a high five to a team. */
+    canSend(recipientTeamId: string, params: {
+        userId: string;
+    }): Promise<ApiResponse<HighFiveCanSend>>;
+}
+declare class CosmeticsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List unlocked cosmetics. */
+    list(params?: {
+        userId?: string;
+    }): Promise<ApiResponse<Cosmetic[]>>;
+    /** Get cosmetic preferences. */
+    getPreferences(params: {
+        userId: string;
+    }): Promise<ApiResponse<CosmeticPreferences>>;
+    /** Update cosmetic preferences. */
+    updatePreferences(params: Record<string, unknown>): Promise<ApiResponse<CosmeticPreferences>>;
+}
+declare class SeasonsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** List all seasons. */
+    list(): Promise<ApiResponse<Season[]>>;
+    /** Get the current active season. */
+    current(): Promise<ApiResponse<Season>>;
+    /** Get user stats for a season. */
+    stats(seasonId: string, params: {
+        userId: string;
+    }): Promise<ApiResponse<SeasonStats>>;
+}
+declare class SkillsResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Get the skill tree with current allocations. */
+    get(params: {
+        userId: string;
+    }): Promise<ApiResponse<SkillTree>>;
+    /** Allocate a skill point. */
+    allocate(params: SkillAllocateParams, options?: RequestOptions): Promise<ApiResponse<SkillAllocateResult>>;
+    /** Reset all skill allocations. */
+    reset(params: {
+        userId: string;
+    }, options?: RequestOptions): Promise<ApiResponse<SkillTree>>;
+}
+/** Access all gamification features. */
+declare class GameResource {
+    private readonly client;
+    /** Boss battles. */
+    readonly boss: BossResource;
+    /** Achievements. */
+    readonly achievements: AchievementsResource;
+    /** Daily quests. */
+    readonly quests: QuestsResource;
+    /** Daily puzzles. */
+    readonly puzzles: PuzzlesResource;
+    /** One-ups (teammate kudos). */
+    readonly oneUps: OneUpsResource;
+    /** High fives (team-to-team kudos). */
+    readonly highFives: HighFivesResource;
+    /** Cosmetics. */
+    readonly cosmetics: CosmeticsResource;
+    /** Seasons. */
+    readonly seasons: SeasonsResource;
+    /** Skill tree. */
+    readonly skills: SkillsResource;
+    /** Game activity feed. */
+    readonly activity: GameActivityResource;
+    constructor(client: HttpClient);
+    /** Get current player stats. */
+    player(params?: {
+        userId?: string;
+    }): Promise<ApiResponse<Player>>;
+    /** Get a specific player's stats by membership ID. */
+    getPlayer(memberId: string): Promise<ApiResponse<Player>>;
+    /** Get the team leaderboard. */
+    leaderboard(params?: LeaderboardParams): Promise<ApiResponse<LeaderboardEntry[]>>;
+    /** Get the current user's leaderboard position. */
+    myRank(params?: {
+        userId?: string;
+        period?: string;
+    }): Promise<ApiResponse<LeaderboardEntry>>;
+    /** Get game balance configuration (read-only constants). */
+    config(): Promise<ApiResponse<GameConfig>>;
+}
+
+/** AI action types. */
+type AiAction = 'auto-tag' | 'suggest-reply' | 'summarize' | 'improve';
+/** Parameters for an AI action. */
+interface AiActionParams {
+    action: AiAction;
+    ticketId?: string;
+    text?: string;
+    context?: Record<string, unknown>;
+}
+/** AI action result. */
+interface AiActionResult {
+    object: 'ai_result';
+    action: AiAction;
+    result: unknown;
+}
+
+/** AI-powered actions (auto-tag, suggest reply, summarize, improve). */
+declare class AiResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Run an AI action. */
+    run(params: AiActionParams, options?: RequestOptions): Promise<ApiResponse<AiActionResult>>;
+    /** Auto-tag a ticket. */
+    autoTag(ticketId: string): Promise<ApiResponse<AiActionResult>>;
+    /** Suggest a reply for a ticket. */
+    suggestReply(ticketId: string): Promise<ApiResponse<AiActionResult>>;
+    /** Summarize a ticket. */
+    summarize(ticketId: string): Promise<ApiResponse<AiActionResult>>;
+    /** Improve text. */
+    improve(text: string): Promise<ApiResponse<AiActionResult>>;
+}
+
+/** A saved view / filter preset. */
+interface SavedView {
+    id: string;
+    object: 'saved_view';
+    name: string;
+    description: string | null;
+    entityType: 'tickets' | 'customers' | 'articles' | 'community_posts';
+    filters: Record<string, unknown>;
+    sortField: string;
+    sortDirection: 'asc' | 'desc';
+    visibility: 'private' | 'team';
+    createdBy: string | null;
+    createdAt: string;
+    updatedAt: string;
+}
+/** Parameters for listing views. */
+interface ViewListParams extends PaginationParams {
+    entityType?: string;
+}
+/** Parameters for creating a view. */
+interface ViewCreateParams {
+    name: string;
+    description?: string;
+    entityType: 'tickets' | 'customers' | 'articles' | 'community_posts';
+    filters?: Record<string, unknown>;
+    sortField?: string;
+    sortDirection?: 'asc' | 'desc';
+    visibility?: 'private' | 'team';
+}
+/** Parameters for updating a view. */
+interface ViewUpdateParams {
+    name?: string;
+    description?: string;
+    filters?: Record<string, unknown>;
+    sortField?: string;
+    sortDirection?: 'asc' | 'desc';
+    visibility?: 'private' | 'team';
+}
+/** Parameters for executing a view. */
+interface ViewExecuteParams extends PaginationParams {
+}
+
+/** Manage saved views (saved filters). */
+declare class ViewsResource extends BaseResource<SavedView, ViewListParams, ViewCreateParams, ViewUpdateParams> {
+    constructor(client: HttpClient);
+    /** Execute a view — returns the filtered results. The server uses the view's entity_type to determine which table to query. */
+    execute(viewId: string, params?: ViewExecuteParams): Promise<ListResponse<unknown>>;
+}
+
+/** Subscription status. */
+interface Subscription {
+    object: 'subscription';
+    status: string;
+    plan: string | null;
+    currentPeriodStart: string | null;
+    currentPeriodEnd: string | null;
+    cancelAtPeriodEnd: boolean;
+    memberCount: number;
+    [key: string]: unknown;
+}
+/** Billing portal result. */
+interface BillingPortal {
+    object: 'billing_portal';
+    url: string;
+}
+/** Parameters for creating a billing portal session. */
+interface BillingPortalParams {
+    returnUrl?: string;
+}
+
+/** Access billing and subscription data. */
+declare class BillingResource {
+    private readonly client;
+    constructor(client: HttpClient);
+    /** Get current subscription status. */
+    subscription(): Promise<ApiResponse<Subscription>>;
+    /** Create a Stripe billing portal session. */
+    portal(params?: BillingPortalParams): Promise<ApiResponse<BillingPortal>>;
+}
+
 /** Error type constants matching the cStar API. */
 declare const ErrorType: {
     readonly AUTHENTICATION_ERROR: "authentication_error";
@@ -633,12 +2333,23 @@ interface CStarClientConfig {
     timeout?: number;
 }
 /**
- * The cStar API client.
+ * The cStar admin API client. **Server-side only.**
+ *
+ * Requires a secret API key (`sk_live_*` or `sk_test_*`). Never use this in
+ * client-side / browser code — your secret key would be exposed to anyone
+ * viewing your site.
+ *
+ * For client-side integrations, use:
+ * - `@cstar.help/js/chat` — Customer chat widget (publishable key)
+ * - `@cstar.help/js/library` — Public knowledge base (no auth)
+ * - `@cstar.help/js/community` — Public community forum (no auth)
  *
  * ```typescript
+ * import { CStarClient } from '@cstar.help/js';
+ *
  * const cstar = new CStarClient({
- *   apiKey: 'sk_test_abc123...',
- *   teamId: 'your-team-id',
+ *   apiKey: process.env.CSTAR_SECRET_KEY, // sk_live_... or sk_test_...
+ *   teamId: process.env.CSTAR_TEAM_ID,
  * });
  *
  * const { data } = await cstar.tickets.list({ status: 'open' });
@@ -653,6 +2364,8 @@ declare class CStarClient {
     readonly articles: ArticlesResource;
     /** Manage webhook endpoints. */
     readonly webhooks: WebhooksResource;
+    /** Manage automation rules. */
+    readonly automations: AutomationsResource;
     /** Manage article categories. */
     readonly categories: CategoriesResource;
     /** Manage community posts and topics. */
@@ -660,10 +2373,50 @@ declare class CStarClient {
         readonly posts: CommunityPostsResource;
         readonly topics: CommunityTopicsResource;
     };
+    /** Manage team members and invites. */
+    readonly members: MembersResource;
+    /** Manage team settings, statuses, quick replies, business hours, and widget. */
+    readonly settings: SettingsResource;
+    /** Manage notifications. */
+    readonly notifications: NotificationsResource;
+    /** Manage @mentions. */
+    readonly mentions: MentionsResource;
+    /** Manage file attachments. */
+    readonly attachments: AttachmentsResource;
+    /** Manage custom field definitions. */
+    readonly customFields: CustomFieldsResource;
+    /** Manage SLA rules. */
+    readonly sla: SlaResource;
+    /** Access analytics and CSAT data. */
+    readonly analytics: AnalyticsResource;
+    /** Perform bulk operations. */
+    readonly bulk: BulkResource;
+    /** Export data. */
+    readonly export: ExportResource;
+    /** Import data. */
+    readonly import: ImportResource;
+    /** Access the audit log. */
+    readonly auditLog: AuditLogResource;
+    /** Search across resources. */
+    readonly search: SearchResource;
+    /** Manage tags. */
+    readonly tags: TagsResource;
+    /** Access the activity feed. */
+    readonly activity: ActivityResource;
+    /** Manage customer groups/segments. */
+    readonly customerGroups: CustomerGroupsResource;
+    /** Access all gamification features. */
+    readonly game: GameResource;
+    /** AI-powered actions. */
+    readonly ai: AiResource;
+    /** Manage saved views. */
+    readonly views: ViewsResource;
+    /** Access billing and subscription data. */
+    readonly billing: BillingResource;
     private readonly client;
     constructor(config: CStarClientConfig);
     /** Whether this client is using test mode keys (sk_test_* or pk_test_*). */
     get isTestMode(): boolean;
 }
 
-export { type ApiErrorBody, type ApiResponse, type Article, type ArticleCreateParams, type ArticleListParams, type ArticleUpdateParams, CStarAuthenticationError, CStarClient, type CStarClientConfig, CStarError, CStarNotFoundError, CStarRateLimitError, CStarValidationError, type Category, type CategoryCreateParams, type CategoryListParams, type CategoryUpdateParams, type CommunityComment, type CommunityCommentCreateParams, type CommunityPost, type CommunityPostCreateParams, type CommunityPostListParams, type CommunityPostUpdateParams, type CommunityTopic, type Customer, type CustomerCreateParams, type CustomerListParams, type CustomerUpdateParams, type DeleteResponse, ErrorType, type ListResponse, type Message, type MessageCreateParams, type Metadata, type PaginationInfo, type PaginationParams, type RequestOptions, type Ticket, type TicketCreateParams, type TicketCustomerSummary, type TicketListParams, type TicketUpdateParams, type Webhook, type WebhookCreateParams, type WebhookEvent, type WebhookEventData, type WebhookEventType, type WebhookListParams, type WebhookTestResult, type WebhookUpdateParams };
+export { type Achievement, type AchievementListParams, type ActivityEvent, type ActivityListParams, type AiAction, type AiActionParams, type AiActionResult, type AnalyticsOverview, type AnalyticsParams, type ApiErrorBody, 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, CStarAuthenticationError, CStarClient, type CStarClientConfig, CStarError, CStarNotFoundError, CStarRateLimitError, CStarValidationError, type Category, type CategoryCreateParams, type CategoryListParams, type CategoryUpdateParams, type CommunityComment, type CommunityCommentCreateParams, type CommunityPost, type CommunityPostCreateParams, type CommunityPostListParams, type CommunityPostUpdateParams, type CommunityTopic, type Cosmetic, type CosmeticPreferences, type CsatSettings, type CsatSettingsUpdateParams, type CsatStats, type CsatSurvey, type CsatSurveyCreateParams, type CsatSurveyListParams, 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, ErrorType, 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, type OneUp, type OneUpCreateParams, type OneUpListParams, type OneUpRemaining, type PaginationInfo, type PaginationParams, type Player, type Puzzle, type PuzzleCompleteParams, type PuzzleCompleteResult, type PuzzleStreak, type Quest, type QuickReply, type QuickReplyCreateParams, type QuickReplyUpdateParams, 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, type Subscription, type Tag, type TagListParams, type TeamSettings, type TeamSettingsUpdateParams, type Ticket, type TicketCreateParams, type TicketCustomerSummary, type TicketListParams, type TicketStatus, type TicketUpdateParams, type UnreadCount, type ViewCreateParams, type ViewExecuteParams, type ViewListParams, type ViewUpdateParams, type Webhook, type WebhookCreateParams, type WebhookEvent, type WebhookEventData, type WebhookEventType, type WebhookListParams, type WebhookListener, type WebhookListenerParams, type WebhookSubscribeParams, type WebhookSubscription, type WebhookTestResult, type WebhookTriggerTestParams, type WebhookTriggerTestResult, type WebhookUpdateParams, type WidgetSettings, type WidgetSettingsUpdateParams };