@streamoid/settings 0.14.0 → 0.15.0

package/dist/index.d.mts

@@ -770,8 +770,32 @@ interface UsageHistoryItem {
     /** Stripe transaction id when present. Some usage rows (e.g. internal returns) are emitted without one. */
     transactionId?: string;
 }
+/** Billing's page block on a usage-history response asked for with `limit`. */
+interface UsageHistoryPagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    skip?: number;
+}
 interface UsageHistoryResponse {
     data: UsageHistoryItem[];
+    /** Present when the request carried `limit`; absent from an unpaged one. */
+    pagination?: UsageHistoryPagination;
+}
+/**
+ * `fetchUsageLogs`'s query. Pass each through to billing
+ * (`get-usage-history`'s `page`, `limit` (≤ 100), `startDate`, `endDate`;
+ * dates are ISO strings, both ends inclusive) and return its `pagination`.
+ */
+interface UsageLogsQuery {
+    /** 1-based. */
+    page?: number;
+    limit?: number;
+    startDate?: string;
+    endDate?: string;
 }
 interface InvoicePdfResponse {
     data: {
@@ -1001,8 +1025,14 @@ interface SettingsApiAdapter {
     buyCredits: (input: BuyCreditsPayload) => Promise<BuyCreditsResponse | {
         data: BuyCreditsResponse;
     }>;
-    /** Per-credit usage / deduction logs (CXO: `getUsageHistory(_, "deduct,return")`). */
-    fetchUsageLogs?: () => Promise<UsageHistoryResponse>;
+    /**
+     * Per-credit usage / deduction logs (CXO: `getUsageHistory(_, "deduct,return")`).
+     * Billing asks for one page at a time (`query`) and expects `pagination`
+     * back. An adapter that ignores `query` and returns every row still works:
+     * Billing pages those itself, but the whole history is still downloaded.
+     * Rejecting shows an inline error in the table.
+     */
+    fetchUsageLogs?: (query?: UsageLogsQuery) => Promise<UsageHistoryResponse>;
     /** Upgrade or downgrade a subscription. Returns checkout URL when applicable. */
     updateSubscription?: (payload: UpdateSubscriptionPayload) => Promise<UpdateSubscriptionResponse>;
     /** CXO-only: undo a pending plan downgrade before it takes effect. */
@@ -1447,6 +1477,17 @@ type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width'
 };
 declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
+/** Previous / Next under the Usage logs table, with the page and the total. */
+declare function UsageLogsPager({ page, totalPages, total, loading, onPageChange, }: {
+    /** 1-based. */
+    page: number;
+    totalPages: number;
+    /** Logs across every page. */
+    total: number;
+    /** Disables both buttons while a page loads. */
+    loading?: boolean;
+    onPageChange: (page: number) => void;
+}): react__default.JSX.Element | null;
 declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, showSharedCredits: showSharedCreditsProp, onShowSharedCreditsChange, onEntitlementChange, }?: {
     embedded?: boolean;
     /** Controlled "plans" sub-view flag. When provided, the host (settings
@@ -1472,6 +1513,161 @@ declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlan
     }) => void;
 }): react__default.JSX.Element;
 
+/** Rows on one page of Billing's Usage logs table. */
+declare const USAGE_LOGS_PAGE_SIZE = 50;
+/** Rows per request while exporting: billing's own `limit` ceiling. */
+declare const USAGE_LOGS_EXPORT_BATCH_SIZE = 100;
+/** The most rows one CSV export fetches; a larger range is refused. */
+declare const USAGE_LOGS_EXPORT_MAX_ROWS = 20000;
+/**
+ * Requests an export may make past the pages `USAGE_LOGS_EXPORT_MAX_ROWS`
+ * needs, to pick up rows that writes during the export pushed further back.
+ */
+declare const USAGE_LOGS_EXPORT_EXTRA_REQUESTS = 10;
+type FetchUsageLogs = (query?: UsageLogsQuery) => Promise<UsageHistoryResponse>;
+/** One page of the Usage logs table. `page` is 1-based. */
+interface UsageLogsPage {
+    rows: UsageHistoryItem[];
+    page: number;
+    totalPages: number;
+    total: number;
+    /**
+     * Every row, when the adapter ignored paging and sent them all: Billing
+     * turns pages over these without asking again. Null when billing paged.
+     */
+    unpaged: UsageHistoryItem[] | null;
+}
+/** A page of rows already in hand: an adapter that returned the whole history. */
+declare function sliceUsageLogsPage(all: UsageHistoryItem[], page: number, pageSize?: number): UsageLogsPage;
+/**
+ * The table page for `fetchUsageLogs`'s answer to `{ page, limit: pageSize }`.
+ * With billing's `pagination` it is that page as is; without it the adapter
+ * sent everything, and this is `page` of those. Never more than `pageSize` rows.
+ */
+declare function usageLogsPage(res: UsageHistoryResponse | null | undefined, page: number, pageSize?: number): UsageLogsPage;
+declare const EMPTY_USAGE_LOGS_PAGE: UsageLogsPage;
+/** Billing's Usage logs table: the page on screen and the request behind it. */
+interface UsageLogsState {
+    logs: UsageLogsPage;
+    /** The page last asked for; Try again asks for it again, not the one on screen. */
+    requestedPage: number;
+    loading: boolean;
+    error: string | null;
+}
+declare const INITIAL_USAGE_LOGS_STATE: UsageLogsState;
+type UsageLogsAction = 
+/** A page was asked for. */
+{
+    type: "request";
+    page: number;
+}
+/** The page asked for arrived. */
+ | {
+    type: "loaded";
+    logs: UsageLogsPage;
+}
+/** The page asked for did not; the one on screen stays. */
+ | {
+    type: "failed";
+    error: string;
+}
+/** Turn to `page` of the rows an unpaged adapter already sent. */
+ | {
+    type: "turn";
+    page: number;
+}
+/** Another workspace: start over at page 1. */
+ | {
+    type: "reset";
+};
+declare function usageLogsReducer(state: UsageLogsState, action: UsageLogsAction): UsageLogsState;
+/**
+ * Whether the usage logs in hand have a row another workspace spent from this
+ * one's shared credits. Every row an unpaged adapter sent counts, not only the
+ * page on screen.
+ */
+declare function usageLogsSpentByOthers(logs: UsageLogsPage, workspaceId: string | null | undefined): boolean;
+interface UsedByNamesLoader {
+    /** Look up `workspaceId`'s names, unless they are saved or being looked up. */
+    load: (workspaceId: string, fetchCreditPool: () => Promise<CreditPoolResponse>) => Promise<void>;
+    /**
+     * Forget what was saved, with the names it saved: the next `load` looks up
+     * again, and an answer still out from before is not saved.
+     */
+    reset: () => void;
+}
+/**
+ * Looks up the names of the workspaces that spent a workspace's shared
+ * credits, once per workspace. `save` gets each answer and says whether it
+ * kept it (false: that workspace is no longer shown); only a kept answer ends
+ * the lookups for that workspace. A failed or unkept lookup is tried again on
+ * the next call; a call while one for the same workspace is under way starts
+ * no other.
+ */
+declare function createUsedByNamesLoader(save: (workspaceId: string, names: Record<string, string>) => boolean): UsedByNamesLoader;
+/** The CSV file name for a picked day range, from its local calendar days. */
+declare function usageLogsExportFileName(start: Date, end: Date): string;
+/**
+ * ISO bounds for a picked day range in the user's time zone: from the start
+ * of `start`'s day to the last millisecond of `end`'s.
+ */
+declare function usageLogsDateRange(start: Date, end: Date): {
+    startDate: string;
+    endDate: string;
+};
+type UsageLogsExportResult = {
+    status: "ok";
+    rows: UsageHistoryItem[];
+    total: number;
+}
+/** More than `maxRows` rows in the range, by the first count or a later one. */
+ | {
+    status: "too-large";
+    total: number;
+}
+/**
+ * Rows were still missing after `maxRequests` requests: writes kept
+ * shifting billing's pages. Nothing to download.
+ */
+ | {
+    status: "incomplete";
+    fetched: number;
+    total: number;
+} | {
+    status: "cancelled";
+};
+interface FetchUsageLogsInRangeOptions {
+    batchSize?: number;
+    maxRows?: number;
+    /**
+     * The most requests, the first included. Default: the pages `maxRows`
+     * needs at billing's limit, plus `USAGE_LOGS_EXPORT_EXTRA_REQUESTS`.
+     */
+    maxRequests?: number;
+    /** After each request: rows so far, and the range's total. */
+    onProgress?: (fetched: number, total: number) => void;
+    /** Stops between requests. */
+    signal?: AbortSignal;
+}
+/**
+ * Every usage log in `range`, fetched `batchSize` at a time. Refuses (status
+ * `too-large`) a range with more than `maxRows`, after one request. Billing
+ * pages newest first by offset, so a row written during the export pushes
+ * older ones onto a later page: it keeps asking while billing says there is a
+ * next page and fewer distinct rows than the range's latest total are in
+ * hand, up to `maxRequests` (then status `incomplete`). An adapter that
+ * ignores the query is asked once, and its rows filtered to the range.
+ * Rejects when a request does.
+ */
+declare function fetchUsageLogsInRange(fetchUsageLogs: FetchUsageLogs, range: {
+    startDate: string;
+    endDate: string;
+}, { batchSize, maxRows, maxRequests, onProgress, signal, }?: FetchUsageLogsInRangeOptions): Promise<UsageLogsExportResult>;
+/** Header and one row per log, as the Usage logs CSV export writes them. */
+declare function usageLogsCsvRows(logs: UsageHistoryItem[], userMap: Record<string, string>, formatDate: (iso: string) => string): string[][];
+/** CSV text: every cell quoted, quotes doubled. */
+declare function toCsv(rows: string[][]): string;
+
 /**
  * The one `updateMemberRole` request that saving a member sends, or `null`
  * when there is nothing to save.
@@ -1950,8 +2146,14 @@ interface ExportDateModalProps {
     title: string;
     onClose: () => void;
     onExport: (startDate: Date, endDate: Date) => void;
-}
-declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react.JSX.Element;
+    /** An export is running: the button is disabled and reads `busyText`. */
+    busy?: boolean;
+    /** Shown in place of the range while busy, e.g. "Fetched 200 of 1,000 logs…". */
+    busyText?: string;
+    /** Shown under the range, e.g. why the last export did not run. */
+    notice?: string | null;
+}
+declare function ExportDateModal({ title, onClose, onExport, busy, busyText, notice, }: ExportDateModalProps): react.JSX.Element;
 
 type CreditCycleUnit = "month" | "year";
 type CreditLimitValidation = {
@@ -2434,4 +2636,4 @@ interface AppSettingsRowProps {
 }
 declare function AppSettingsRow({ title, description, summary, href, onClick, disabled, disabledReason, ariaLabel, trailing }: AppSettingsRowProps): react.JSX.Element;
 
-export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEntitlement, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CurrentPlanState, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, entitlementFromBody, entitlementFromFailure, expiryChoiceFor, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, hasPaidFeatures, isLimitBelowUsage, isPaidPlan, isSponsoredEntitlement, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadCurrentPlan, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, parseBillingEntitlement, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, sponsoredCreditsText, toLocalDateInput, useBillingEntitlement, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };
+export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEntitlement, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CurrentPlanState, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, EMPTY_USAGE_LOGS_PAGE, ExportDateModal, type FetchUsageLogs, type FetchUsageLogsInRangeOptions, INITIAL_USAGE_LOGS_STATE, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USAGE_LOGS_EXPORT_BATCH_SIZE, USAGE_LOGS_EXPORT_EXTRA_REQUESTS, USAGE_LOGS_EXPORT_MAX_ROWS, USAGE_LOGS_PAGE_SIZE, USER_LANGUAGES, type UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryPagination, type UsageHistoryResponse, type UsageLogsAction, type UsageLogsExportResult, type UsageLogsPage, UsageLogsPager, type UsageLogsQuery, type UsageLogsState, type UsedByNamesLoader, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, createUsedByNamesLoader, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, entitlementFromBody, entitlementFromFailure, expiryChoiceFor, fetchUsageLogsInRange, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, hasPaidFeatures, isLimitBelowUsage, isPaidPlan, isSponsoredEntitlement, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadCurrentPlan, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, parseBillingEntitlement, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, sliceUsageLogsPage, sponsoredCreditsText, toCsv, toLocalDateInput, usageLogsCsvRows, usageLogsDateRange, usageLogsExportFileName, usageLogsPage, usageLogsReducer, usageLogsSpentByOthers, useBillingEntitlement, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };

package/dist/index.d.ts

@@ -770,8 +770,32 @@ interface UsageHistoryItem {
     /** Stripe transaction id when present. Some usage rows (e.g. internal returns) are emitted without one. */
     transactionId?: string;
 }
+/** Billing's page block on a usage-history response asked for with `limit`. */
+interface UsageHistoryPagination {
+    page: number;
+    limit: number;
+    total: number;
+    totalPages: number;
+    hasNextPage: boolean;
+    hasPreviousPage: boolean;
+    skip?: number;
+}
 interface UsageHistoryResponse {
     data: UsageHistoryItem[];
+    /** Present when the request carried `limit`; absent from an unpaged one. */
+    pagination?: UsageHistoryPagination;
+}
+/**
+ * `fetchUsageLogs`'s query. Pass each through to billing
+ * (`get-usage-history`'s `page`, `limit` (≤ 100), `startDate`, `endDate`;
+ * dates are ISO strings, both ends inclusive) and return its `pagination`.
+ */
+interface UsageLogsQuery {
+    /** 1-based. */
+    page?: number;
+    limit?: number;
+    startDate?: string;
+    endDate?: string;
 }
 interface InvoicePdfResponse {
     data: {
@@ -1001,8 +1025,14 @@ interface SettingsApiAdapter {
     buyCredits: (input: BuyCreditsPayload) => Promise<BuyCreditsResponse | {
         data: BuyCreditsResponse;
     }>;
-    /** Per-credit usage / deduction logs (CXO: `getUsageHistory(_, "deduct,return")`). */
-    fetchUsageLogs?: () => Promise<UsageHistoryResponse>;
+    /**
+     * Per-credit usage / deduction logs (CXO: `getUsageHistory(_, "deduct,return")`).
+     * Billing asks for one page at a time (`query`) and expects `pagination`
+     * back. An adapter that ignores `query` and returns every row still works:
+     * Billing pages those itself, but the whole history is still downloaded.
+     * Rejecting shows an inline error in the table.
+     */
+    fetchUsageLogs?: (query?: UsageLogsQuery) => Promise<UsageHistoryResponse>;
     /** Upgrade or downgrade a subscription. Returns checkout URL when applicable. */
     updateSubscription?: (payload: UpdateSubscriptionPayload) => Promise<UpdateSubscriptionResponse>;
     /** CXO-only: undo a pending plan downgrade before it takes effect. */
@@ -1447,6 +1477,17 @@ type IconProps = Omit<SVGProps<SVGSVGElement>, 'color' | 'strokeWidth' | 'width'
 };
 declare const SiconKey: ({ color, strokeWidth, size, ...props }: IconProps) => react.JSX.Element;
 
+/** Previous / Next under the Usage logs table, with the page and the total. */
+declare function UsageLogsPager({ page, totalPages, total, loading, onPageChange, }: {
+    /** 1-based. */
+    page: number;
+    totalPages: number;
+    /** Logs across every page. */
+    total: number;
+    /** Disables both buttons while a page loads. */
+    loading?: boolean;
+    onPageChange: (page: number) => void;
+}): react__default.JSX.Element | null;
 declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlansChange, showPerUserLimits: showPerUserLimitsProp, onShowPerUserLimitsChange, showSharedCredits: showSharedCreditsProp, onShowSharedCreditsChange, onEntitlementChange, }?: {
     embedded?: boolean;
     /** Controlled "plans" sub-view flag. When provided, the host (settings
@@ -1472,6 +1513,161 @@ declare function BillingContent({ embedded, showPlans: showPlansProp, onShowPlan
     }) => void;
 }): react__default.JSX.Element;
 
+/** Rows on one page of Billing's Usage logs table. */
+declare const USAGE_LOGS_PAGE_SIZE = 50;
+/** Rows per request while exporting: billing's own `limit` ceiling. */
+declare const USAGE_LOGS_EXPORT_BATCH_SIZE = 100;
+/** The most rows one CSV export fetches; a larger range is refused. */
+declare const USAGE_LOGS_EXPORT_MAX_ROWS = 20000;
+/**
+ * Requests an export may make past the pages `USAGE_LOGS_EXPORT_MAX_ROWS`
+ * needs, to pick up rows that writes during the export pushed further back.
+ */
+declare const USAGE_LOGS_EXPORT_EXTRA_REQUESTS = 10;
+type FetchUsageLogs = (query?: UsageLogsQuery) => Promise<UsageHistoryResponse>;
+/** One page of the Usage logs table. `page` is 1-based. */
+interface UsageLogsPage {
+    rows: UsageHistoryItem[];
+    page: number;
+    totalPages: number;
+    total: number;
+    /**
+     * Every row, when the adapter ignored paging and sent them all: Billing
+     * turns pages over these without asking again. Null when billing paged.
+     */
+    unpaged: UsageHistoryItem[] | null;
+}
+/** A page of rows already in hand: an adapter that returned the whole history. */
+declare function sliceUsageLogsPage(all: UsageHistoryItem[], page: number, pageSize?: number): UsageLogsPage;
+/**
+ * The table page for `fetchUsageLogs`'s answer to `{ page, limit: pageSize }`.
+ * With billing's `pagination` it is that page as is; without it the adapter
+ * sent everything, and this is `page` of those. Never more than `pageSize` rows.
+ */
+declare function usageLogsPage(res: UsageHistoryResponse | null | undefined, page: number, pageSize?: number): UsageLogsPage;
+declare const EMPTY_USAGE_LOGS_PAGE: UsageLogsPage;
+/** Billing's Usage logs table: the page on screen and the request behind it. */
+interface UsageLogsState {
+    logs: UsageLogsPage;
+    /** The page last asked for; Try again asks for it again, not the one on screen. */
+    requestedPage: number;
+    loading: boolean;
+    error: string | null;
+}
+declare const INITIAL_USAGE_LOGS_STATE: UsageLogsState;
+type UsageLogsAction = 
+/** A page was asked for. */
+{
+    type: "request";
+    page: number;
+}
+/** The page asked for arrived. */
+ | {
+    type: "loaded";
+    logs: UsageLogsPage;
+}
+/** The page asked for did not; the one on screen stays. */
+ | {
+    type: "failed";
+    error: string;
+}
+/** Turn to `page` of the rows an unpaged adapter already sent. */
+ | {
+    type: "turn";
+    page: number;
+}
+/** Another workspace: start over at page 1. */
+ | {
+    type: "reset";
+};
+declare function usageLogsReducer(state: UsageLogsState, action: UsageLogsAction): UsageLogsState;
+/**
+ * Whether the usage logs in hand have a row another workspace spent from this
+ * one's shared credits. Every row an unpaged adapter sent counts, not only the
+ * page on screen.
+ */
+declare function usageLogsSpentByOthers(logs: UsageLogsPage, workspaceId: string | null | undefined): boolean;
+interface UsedByNamesLoader {
+    /** Look up `workspaceId`'s names, unless they are saved or being looked up. */
+    load: (workspaceId: string, fetchCreditPool: () => Promise<CreditPoolResponse>) => Promise<void>;
+    /**
+     * Forget what was saved, with the names it saved: the next `load` looks up
+     * again, and an answer still out from before is not saved.
+     */
+    reset: () => void;
+}
+/**
+ * Looks up the names of the workspaces that spent a workspace's shared
+ * credits, once per workspace. `save` gets each answer and says whether it
+ * kept it (false: that workspace is no longer shown); only a kept answer ends
+ * the lookups for that workspace. A failed or unkept lookup is tried again on
+ * the next call; a call while one for the same workspace is under way starts
+ * no other.
+ */
+declare function createUsedByNamesLoader(save: (workspaceId: string, names: Record<string, string>) => boolean): UsedByNamesLoader;
+/** The CSV file name for a picked day range, from its local calendar days. */
+declare function usageLogsExportFileName(start: Date, end: Date): string;
+/**
+ * ISO bounds for a picked day range in the user's time zone: from the start
+ * of `start`'s day to the last millisecond of `end`'s.
+ */
+declare function usageLogsDateRange(start: Date, end: Date): {
+    startDate: string;
+    endDate: string;
+};
+type UsageLogsExportResult = {
+    status: "ok";
+    rows: UsageHistoryItem[];
+    total: number;
+}
+/** More than `maxRows` rows in the range, by the first count or a later one. */
+ | {
+    status: "too-large";
+    total: number;
+}
+/**
+ * Rows were still missing after `maxRequests` requests: writes kept
+ * shifting billing's pages. Nothing to download.
+ */
+ | {
+    status: "incomplete";
+    fetched: number;
+    total: number;
+} | {
+    status: "cancelled";
+};
+interface FetchUsageLogsInRangeOptions {
+    batchSize?: number;
+    maxRows?: number;
+    /**
+     * The most requests, the first included. Default: the pages `maxRows`
+     * needs at billing's limit, plus `USAGE_LOGS_EXPORT_EXTRA_REQUESTS`.
+     */
+    maxRequests?: number;
+    /** After each request: rows so far, and the range's total. */
+    onProgress?: (fetched: number, total: number) => void;
+    /** Stops between requests. */
+    signal?: AbortSignal;
+}
+/**
+ * Every usage log in `range`, fetched `batchSize` at a time. Refuses (status
+ * `too-large`) a range with more than `maxRows`, after one request. Billing
+ * pages newest first by offset, so a row written during the export pushes
+ * older ones onto a later page: it keeps asking while billing says there is a
+ * next page and fewer distinct rows than the range's latest total are in
+ * hand, up to `maxRequests` (then status `incomplete`). An adapter that
+ * ignores the query is asked once, and its rows filtered to the range.
+ * Rejects when a request does.
+ */
+declare function fetchUsageLogsInRange(fetchUsageLogs: FetchUsageLogs, range: {
+    startDate: string;
+    endDate: string;
+}, { batchSize, maxRows, maxRequests, onProgress, signal, }?: FetchUsageLogsInRangeOptions): Promise<UsageLogsExportResult>;
+/** Header and one row per log, as the Usage logs CSV export writes them. */
+declare function usageLogsCsvRows(logs: UsageHistoryItem[], userMap: Record<string, string>, formatDate: (iso: string) => string): string[][];
+/** CSV text: every cell quoted, quotes doubled. */
+declare function toCsv(rows: string[][]): string;
+
 /**
  * The one `updateMemberRole` request that saving a member sends, or `null`
  * when there is nothing to save.
@@ -1950,8 +2146,14 @@ interface ExportDateModalProps {
     title: string;
     onClose: () => void;
     onExport: (startDate: Date, endDate: Date) => void;
-}
-declare function ExportDateModal({ title, onClose, onExport, }: ExportDateModalProps): react.JSX.Element;
+    /** An export is running: the button is disabled and reads `busyText`. */
+    busy?: boolean;
+    /** Shown in place of the range while busy, e.g. "Fetched 200 of 1,000 logs…". */
+    busyText?: string;
+    /** Shown under the range, e.g. why the last export did not run. */
+    notice?: string | null;
+}
+declare function ExportDateModal({ title, onClose, onExport, busy, busyText, notice, }: ExportDateModalProps): react.JSX.Element;
 
 type CreditCycleUnit = "month" | "year";
 type CreditLimitValidation = {
@@ -2434,4 +2636,4 @@ interface AppSettingsRowProps {
 }
 declare function AppSettingsRow({ title, description, summary, href, onClick, disabled, disabledReason, ariaLabel, trailing }: AppSettingsRowProps): react.JSX.Element;
 
-export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEntitlement, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CurrentPlanState, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, ExportDateModal, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USER_LANGUAGES, type UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryResponse, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, entitlementFromBody, entitlementFromFailure, expiryChoiceFor, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, hasPaidFeatures, isLimitBelowUsage, isPaidPlan, isSponsoredEntitlement, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadCurrentPlan, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, parseBillingEntitlement, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, sponsoredCreditsText, toLocalDateInput, useBillingEntitlement, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };
+export { APP_KEYS, type AddCreditPoolMemberInput, AdministrationOverview, type AdministrationOverviewProps, type AdministrativeNavigationOptions, type ApiToken, type AppKey, AppSettingsHeader, type AppSettingsHeaderProps, AppSettingsPage, type AppSettingsPageProps, AppSettingsRow, type AppSettingsRowProps, AppSettingsSection, type AppSettingsSectionProps, type AvailableCreditsResponse, BillingContent, type BillingEntitlement, type BillingEventPayload, type BillingProduct, type BillingSubscription, BuyCreditsModal, type BuyCreditsPayload, type BuyCreditsResponse, ConfirmDeleteModal, ConfirmLeaveModal, type ConnectedApp, ConnectedAppsContent, type CreatedToken, type CreditCycleUnit, type CreditLimitValidation, type CreditPoolCandidate, type CreditPoolFormerMember, type CreditPoolMember, CreditPoolMemberModal, type CreditPoolMemberModalProps, type CreditPoolMemberStatus, type CreditPoolMode, type CreditPoolResponse, type CreditsMeter, type CurrentPlanState, type CustomCreditInfo, type CustomCreditResponse, DEFAULT_PERMISSIONS, DEFAULT_USER_LANGUAGE, EMPTY_USAGE_LOGS_PAGE, ExportDateModal, type FetchUsageLogs, type FetchUsageLogsInRangeOptions, INITIAL_USAGE_LOGS_STATE, InviteUpdateModal, type InvoicePdfResponse, type MemberCreditLimit, MemberCreditLimitModal, type MemberCreditLimitRow, type MemberCreditLimitSource, type MemberCreditLimitsResponse, MemberListFrame, type MemberListFrameProps, type MemberListTab, MemberListToolbar, type MemberListToolbarProps, type MemberPermissionsPayload, OrganizationContent, type OrganizationData, type OrganizationDetails, OrganizationIntegrationsContent, type OrganizationInvite, type OrganizationJoinRequest, type OrganizationJoinableWorkspace, type OrganizationMember, OrganizationMemberModal, type OrganizationMemberModalProps, type OrganizationMemberRole, OrganizationModal, OrganizationPicker, type OrganizationPickerItem, type OrganizationPickerProps, type OrganizationPickerType, type OrganizationView, type OrganizationWorkspaceItem, POOL_ERROR_CODES, POOL_EXPIRY_MAX_MONTHS, POOL_NOTE_MAX_LENGTH, PerUserLimitsView, type PoolEndsAtResult, type PoolErrorCode, type PoolExpiryChoice, type PoolValueValidation, type Price, type PriceMetadata, type ProductsResponse, ProfileAvatar, ProfileTab, REMOVE_REASON_MAX_LENGTH, ReferralTab, RemovePoolMemberModal, type RemovePoolMemberModalProps, SCOPE_LABELS, ScopeHeader, type ScopeHeaderProps, type ServiceItem, type SettingsAdapters, SettingsAdaptersProvider, type SettingsApiAdapter, type SettingsAuthAdapter, type SettingsAuthUser, SettingsContent, type SettingsContentProps, type SettingsImageUploadAdapter, type SettingsIntegrationsAdapter, type SettingsNavigationAdapter, type SettingsOrganizationAdapter, type SettingsOrganizationCreateOptions, type SettingsOrganizationCurrent, type SettingsOrganizationJoinableItem, type SettingsOrganizationListItem, type SettingsOrganizationType, type SettingsScope, type SettingsTab, type SettingsToastAdapter, SettingsTooltip, type SettingsTooltipPlacement, type SettingsTooltipProps, type SettingsWorkspaceAdapter, type SettingsWorkspaceCurrent, type SettingsWorkspaceListItem, SharedCreditsView, type SharedPoolBalance, SiconKey, type StoreItem, type SubscriptionPlan, type SubscriptionResponse, TAB_DESCRIPTIONS, TAB_LABELS, TAB_SCOPE, TAB_TO_URL, type TeamMember, TeamsContent, type TokenExpiry, TokensContent, URL_TO_TAB, USAGE_LOGS_EXPORT_BATCH_SIZE, USAGE_LOGS_EXPORT_EXTRA_REQUESTS, USAGE_LOGS_EXPORT_MAX_ROWS, USAGE_LOGS_PAGE_SIZE, USER_LANGUAGES, type UpdateCreditPoolMemberInput, type UpdateSubscriptionPayload, type UpdateSubscriptionResponse, type UsageHistoryItem, type UsageHistoryPagination, type UsageHistoryResponse, type UsageLogsAction, type UsageLogsExportResult, type UsageLogsPage, UsageLogsPager, type UsageLogsQuery, type UsageLogsState, type UsedByNamesLoader, type UserLanguage, type UserPermissions, WORKSPACE_LIST_PAGE_SIZE, type WorkspaceData, WorkspaceGeneralTab, type WorkspaceGeneralTabProps, type WorkspaceInvite, type WorkspaceListOrganization, WorkspaceListTab, type WorkspaceMember, WorkspaceModal, type WorkspaceOrganization, type WorkspaceOrganizationRequest, WorkspacePicker, type WorkspacePickerGroup, type WorkspacePickerItem, type WorkspacePickerProps, WorkspaceTab, type WorkspaceUsageResponse, belowUsageReason, canShowSharedCredits, cleanCreditLimitInput, cleanPoolValueInput, countLabel, createUsedByNamesLoader, creditCycleUnit, creditsMeter, deriveWorkspaceInvitePermission, describeAllowance, describeDefaultLimit, describeMemberLimit, entitlementFromBody, entitlementFromFailure, expiryChoiceFor, fetchUsageLogsInRange, findBillingError, findPoolError, formatCreditLimit, formatCredits, formatPoolEndsAt, formatPoolSplit, groupWorkspaceList, hasPaidFeatures, isLimitBelowUsage, isPaidPlan, isSponsoredEntitlement, joinMembersWithLimits, lastUsedLabel, limitBelowUsageUsed, limitSourceLabel, loadCurrentPlan, loadWorkspaceOrganization, memberRoleUpdate, minPoolEndDate, minimumCreditLimit, ownCreditsFirstText, parseBillingEntitlement, pausedOwnCreditsText, poolEndsAtFrom, poolErrorMessage, poolRenewsAtCycleEnd, poolWorkspaceName, readSettingsCaller, rememberSettingsCaller, resolveSettingsTabFromPath, roundCredits, settingsReturnTarget, sharedPoolBannerText, sharedPoolEndsText, sliceUsageLogsPage, sponsoredCreditsText, toCsv, toLocalDateInput, usageLogsCsvRows, usageLogsDateRange, usageLogsExportFileName, usageLogsPage, usageLogsReducer, usageLogsSpentByOthers, useBillingEntitlement, useSettingsAdapters, useWorkspaceInvitePermission, useWorkspaceOrganization, usedByNamesFrom, usedByWorkspaceKey, userLanguageLabel, validateCreditLimitInput, validateDefaultCreditLimitInput, validatePoolText, validatePoolValue };