@delopay/sdk 0.35.1 → 0.37.0

package/dist/internal.d.cts

@@ -1,5 +1,5 @@
-import { ProjectResponse, ShopResponse, PaymentResponse, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, BillingProfileResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.cjs';
-export { Address, AddressDetails, AllocationListResponse, AllocationResponse, AllocationTransferRequest, AllocationTransferResponse, Analytics, AnalyticsDashboard, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyExpiration, ApiKeyResponse, ApiKeyRevokeResponse, ApiKeyUpdateRequest, ApplePayVerificationRequest, ApplePayVerificationResponse, ApplePayVerifiedDomainsResponse, AuthenticationCreateRequest, AuthenticationResponse, AuthenticationStatus, AuthenticationType, AutoRechargeConfig, AutoRechargeUpdateRequest, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, BillingCompleteSetupRequest, BillingSetupRequest, BillingSetupResponse, BlocklistAddRequest, BlocklistDataKind, BlocklistResponse, BrandingExport, BrandingSource, BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, CancelSubscriptionRequest, CancelSubscriptionResponse, CaptureMethod, CardDetail, CardDetailFromLocker, Cards, ChangePasswordRequest, CheckoutBranding, ConfirmSubscriptionPaymentDetails, ConfirmSubscriptionRequest, ConfirmSubscriptionResponse, Connector, ConnectorCreateRequest, ConnectorListResponse, ConnectorResponse, ConnectorType, ConnectorUpdateRequest, ConnectorVolumeSplit, ConnectorWebhookEntry, ConnectorWebhookEventType, ConnectorWebhookListResponse, ConnectorWebhookRegisterRequest, ConnectorWebhookRegisterResponse, CornerRadius, CreateAndConfirmSubscriptionRequest, CreateSubscriptionPaymentDetails, CreateSubscriptionRequest, Currency, CustomerCreateRequest, CustomerListParams, CustomerPaymentMethodsListParams, CustomerPaymentMethodsListResponse, CustomerResponse, CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, DeleteAccountRequest, DelopayAuthenticationError, DelopayError, DelopayLogger, DelopayOptions, DisputeEvidenceRequest, DisputeListParams, DisputeResponse, DisputeStage, DisputeStatus, EncodedBranding, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EventClass, EventDeliveryAttemptResponse, EventDetailResponse, EventListParams, EventListResponse, EventResponse, EventType, Export, FeatureMatrix, FeeOwner, FeeType, Files, FontFamily, FontWeight, Forex, ForgotPasswordRequest, FromEmailRequest, FutureUsage, GatewayConnectRequest, GatewayResponse, GetSubscriptionItemsParams, GetSubscriptionItemsResponse, GlobalSearchRequest, IntentStatus, InviteUsersRequest, InviteUsersResponse, InvoiceStatus, LabelStyle, LayoutStyle, LedgerEntry, LedgerListParams, LedgerResponse, LinkedRoutingConfigRetrieveResponse, ListInvitableRolesParams, LoginHistoryEntry, LoginHistoryParams, LoginHistoryResponse, LogoShape, LogoSize, MandateListParams, MandateResponse, MandateRevokedResponse, MandateStatus, MandateType, MerchantAccountCreateRequest, MerchantAccountType, MerchantOverviewResponse, MerchantOverviewStat, MerchantRoutingAlgorithm, NonPillRadius, ParentGroup, ParentGroupInfo, PauseSubscriptionRequest, PauseSubscriptionResponse, PaymentCancelRequest, PaymentCaptureRequest, PaymentConfirmRequest, PaymentCreateRequest, PaymentLayout, PaymentLinkBackgroundImageConfig, PaymentLinkConfigRequest, PaymentLinkListParams, PaymentLinkListResponse, PaymentLinkResponse, PaymentLinkTransactionDetails, PaymentListParams, PaymentListResponse, PaymentMethod, PaymentMethodCreateRequest, PaymentMethodDeleteResponse, PaymentMethodListParams, PaymentMethodResponse, PaymentMethodType, PaymentMethodUpdateRequest, PaymentRetrieveOptions, PaymentUpdateRequest, PayoutCreateRequest, PayoutListParams, PayoutListResponse, PayoutResponse, PayoutStatus, PayoutType, PayoutUpdateRequest, PermissionScope, PhoneDetails, PhoneOtpRequest, PhoneOtpResponse, PhoneOtpVerifyRequest, PhoneOtpVerifyResponse, PollStatus, PollStatusResponse, ProfileAcquirerCreateRequest, ProfileAcquirerResponse, ProfileAcquirerUpdateRequest, ProfileCreateRequest, ProfileDefaultRoutingConfig, ProfileLogoUploadResponse, ProfileUpdateRequest, ProjectCreateRequest, ProjectStats, ProjectStatsResponse, ProjectUpdateRequest, RecoveryCodesResponse, RefundCreateRequest, RefundListParams, RefundListResponse, RefundResponse, RefundStatus, RefundType, RefundUpdateRequest, RegionCreateRequest, RegionResponse, RegionUpdateRequest, Regions, RelayRequest, RelayResponse, RelayStatus, RelayType, RequestExtras, RequestOptions, ResetPasswordRequest, ResumeSubscriptionRequest, ResumeSubscriptionResponse, RoutableConnectorChoice, RoutingActivatePayload, RoutingConfigCreateRequest, RoutingConfigResponse, RoutingDeactivateRequest, RoutingDictionary, RoutingDictionaryRecord, Search, SearchGroupResponse, SearchIndex, SearchStatus, ShopCreateRequest, ShopStats, ShopUpdateRequest, SignInRequest, SignUpRequest, SignUpWithMerchantRequest, SizeScale, SpacingScale, StaticRoutingAlgorithm, StripeConnectAccountRequest, StripeConnectAccountResponse, StripeConnectLinkRequest, StripeConnectLinkResponse, SubscriptionEstimateParams, SubscriptionEstimateResponse, SubscriptionInvoice, SubscriptionItem, SubscriptionItemPrice, SubscriptionItemType, SubscriptionLineItem, SubscriptionListParams, SubscriptionPaymentData, SubscriptionPaymentDetails, SubscriptionPeriodUnit, SubscriptionResponse, SubscriptionStatus, Subscriptions, SummaryPosition, SurfaceStyle, SwitchMerchantRequest, SwitchProfileRequest, Terminate2faQueryParams, ThreeDSDecision, ThreeDsRuleExecuteRequest, ThreeDsRuleResponse, TierSummary, TokenPurpose, TokenResponse, TopupRequest, TopupResponse, TotpResponse, TransactionType, TrustBadge, UpdateSubscriptionRequest, UpdateUserDetailsRequest, UserResponse, UserSessionEntry, UserSessionListResponse, UserSessionRevokeResponse, VerifyTotpRequest, WebhookDeliveryAttempt, WebhookEvent, Webhooks, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, logoDimensions, parseImportedBranding, radiusValue, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue } from './index.cjs';
+import { ProjectResponse, ShopResponse, PaymentResponse, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, AnalyticsScopeRequest, AnalyticsScopeResponse, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, BillingProfileResponse, PlatformFeeRuleInput, PlatformFeeRuleRecord, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.cjs';
+export { Address, AddressDetails, AllocationListResponse, AllocationResponse, AllocationTransferRequest, AllocationTransferResponse, Analytics, AnalyticsChild, AnalyticsConnectorDay, AnalyticsConnectorSeries, AnalyticsDashboard, AnalyticsDayBucket, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyExpiration, ApiKeyResponse, ApiKeyRevokeResponse, ApiKeyUpdateRequest, ApplePayVerificationRequest, ApplePayVerificationResponse, ApplePayVerifiedDomainsResponse, AuthenticationCreateRequest, AuthenticationResponse, AuthenticationStatus, AuthenticationType, AutoRechargeConfig, AutoRechargeUpdateRequest, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, BillingCompleteSetupRequest, BillingSetupRequest, BillingSetupResponse, BlocklistAddRequest, BlocklistDataKind, BlocklistResponse, BrandingExport, BrandingSource, BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, CancelSubscriptionRequest, CancelSubscriptionResponse, CaptureMethod, CardDetail, CardDetailFromLocker, Cards, ChangePasswordRequest, CheckoutBranding, ConfirmSubscriptionPaymentDetails, ConfirmSubscriptionRequest, ConfirmSubscriptionResponse, Connector, ConnectorCreateRequest, ConnectorListResponse, ConnectorResponse, ConnectorType, ConnectorUpdateRequest, ConnectorVolumeSplit, ConnectorWebhookEntry, ConnectorWebhookEventType, ConnectorWebhookListResponse, ConnectorWebhookRegisterRequest, ConnectorWebhookRegisterResponse, CornerRadius, CreateAndConfirmSubscriptionRequest, CreateSubscriptionPaymentDetails, CreateSubscriptionRequest, Currency, CustomerCreateRequest, CustomerListParams, CustomerPaymentMethodsListParams, CustomerPaymentMethodsListResponse, CustomerResponse, CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, DeleteAccountRequest, DelopayAuthenticationError, DelopayError, DelopayLogger, DelopayOptions, DisputeEvidenceRequest, DisputeListParams, DisputeResponse, DisputeStage, DisputeStatus, EncodedBranding, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EuclidComparison, EuclidComparisonType, EuclidIfStatement, EuclidValue, EventClass, EventDeliveryAttemptResponse, EventDetailResponse, EventListParams, EventListResponse, EventResponse, EventType, Export, FeatureMatrix, FeeOwner, FeeProgramBuilder, FeeRuleConditions, FeeRuleInput, FeeSpecInput, FeeType, Files, FontFamily, FontWeight, Forex, ForgotPasswordRequest, FromEmailRequest, FutureUsage, GatewayConnectRequest, GatewayResponse, GetSubscriptionItemsParams, GetSubscriptionItemsResponse, GlobalSearchRequest, IntentStatus, InviteUsersRequest, InviteUsersResponse, InvoiceStatus, LabelStyle, LayoutStyle, LedgerEntry, LedgerListParams, LedgerResponse, LinkedRoutingConfigRetrieveResponse, ListInvitableRolesParams, LoginHistoryEntry, LoginHistoryParams, LoginHistoryResponse, LogoShape, LogoSize, MandateListParams, MandateResponse, MandateRevokedResponse, MandateStatus, MandateType, MerchantAccountCreateRequest, MerchantAccountType, MerchantOverviewResponse, MerchantOverviewStat, MerchantRoutingAlgorithm, NonPillRadius, ParentGroup, ParentGroupInfo, PauseSubscriptionRequest, PauseSubscriptionResponse, PaymentCancelRequest, PaymentCaptureRequest, PaymentConfirmRequest, PaymentCreateRequest, PaymentLayout, PaymentLinkBackgroundImageConfig, PaymentLinkConfigRequest, PaymentLinkListParams, PaymentLinkListResponse, PaymentLinkResponse, PaymentLinkTransactionDetails, PaymentListParams, PaymentListResponse, PaymentMethod, PaymentMethodCreateRequest, PaymentMethodDeleteResponse, PaymentMethodListParams, PaymentMethodResponse, PaymentMethodType, PaymentMethodUpdateRequest, PaymentRetrieveOptions, PaymentUpdateRequest, PayoutCreateRequest, PayoutListParams, PayoutListResponse, PayoutResponse, PayoutStatus, PayoutType, PayoutUpdateRequest, PermissionScope, PhoneDetails, PhoneOtpRequest, PhoneOtpResponse, PhoneOtpVerifyRequest, PhoneOtpVerifyResponse, PlatformFeeKind, PlatformFeeOutput, PlatformFeeProgram, PlatformFeeRule, PlatformFeeRuleOutput, PlatformFeeRuleRequest, PollStatus, PollStatusResponse, ProfileAcquirerCreateRequest, ProfileAcquirerResponse, ProfileAcquirerUpdateRequest, ProfileCreateRequest, ProfileDefaultRoutingConfig, ProfileLogoUploadResponse, ProfileUpdateRequest, ProjectCreateRequest, ProjectStats, ProjectStatsResponse, ProjectUpdateRequest, RecoveryCodesResponse, RefundCreateRequest, RefundListParams, RefundListResponse, RefundResponse, RefundStatus, RefundType, RefundUpdateRequest, RegionCreateRequest, RegionResponse, RegionUpdateRequest, Regions, RelayRequest, RelayResponse, RelayStatus, RelayType, RequestExtras, RequestOptions, ResetPasswordRequest, ResumeSubscriptionRequest, ResumeSubscriptionResponse, RoutableConnectorChoice, RoutingActivatePayload, RoutingConfigCreateRequest, RoutingConfigResponse, RoutingDeactivateRequest, RoutingDictionary, RoutingDictionaryRecord, Search, SearchGroupResponse, SearchIndex, SearchStatus, ShopCreateRequest, ShopStats, ShopUpdateRequest, SignInRequest, SignUpRequest, SignUpWithMerchantRequest, SizeScale, SpacingScale, StaticRoutingAlgorithm, StripeConnectAccountRequest, StripeConnectAccountResponse, StripeConnectLinkRequest, StripeConnectLinkResponse, SubscriptionEstimateParams, SubscriptionEstimateResponse, SubscriptionInvoice, SubscriptionItem, SubscriptionItemPrice, SubscriptionItemType, SubscriptionLineItem, SubscriptionListParams, SubscriptionPaymentData, SubscriptionPaymentDetails, SubscriptionPeriodUnit, SubscriptionResponse, SubscriptionStatus, Subscriptions, SummaryPosition, SurfaceStyle, SwitchMerchantRequest, SwitchProfileRequest, Terminate2faQueryParams, ThreeDSDecision, ThreeDsRuleExecuteRequest, ThreeDsRuleResponse, TierSummary, TokenPurpose, TokenResponse, TopupRequest, TopupResponse, TotpResponse, TransactionType, TrustBadge, UpdateSubscriptionRequest, UpdateUserDetailsRequest, UserResponse, UserSessionEntry, UserSessionListResponse, UserSessionRevokeResponse, VerifyTotpRequest, WebhookDeliveryAttempt, WebhookEvent, Webhooks, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, feeProgram, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, logoDimensions, parseImportedBranding, radiusValue, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue } from './index.cjs';
 
 /**
  * Internal-only type surface. Exposed via `'@delopay/sdk/internal'` only.
@@ -152,8 +152,6 @@ interface AdminCustomerDetail {
     customer_id: string;
     organization_id: string;
     employee_count: number;
-    total_transactions: number;
-    total_volume: number;
     created_at: string;
     customer_name?: string | null;
     projects: ProjectResponse[];
@@ -197,22 +195,128 @@ interface PlatformAnalyticsResponse {
     period_end: string;
 }
 interface PaymentAnalyticsRequest {
+    /** Rolling window in days. Ignored when start_date is provided. */
     period?: number | null;
+    /** Naive ISO 8601 datetime (e.g. 2026-06-01T00:00:00). Takes precedence over period. */
+    start_date?: string | null;
+    /** Naive ISO 8601 datetime. Defaults to now when only start_date is set. */
+    end_date?: string | null;
+    /** Limit stats to a single customer/merchant. Omitted = platform-wide. */
+    merchant_id?: string | null;
+    /** Limit stats to the shops of one project. Requires merchant_id. */
+    project_id?: string | null;
+    /** Limit stats to a single shop. Requires merchant_id; wins over project_id. */
+    shop_id?: string | null;
     currency?: string | null;
 }
-interface PaymentStat {
-    label: string;
-    value: number;
-    change_percent: number;
+/**
+ * The four independent payment measures for one reporting window. Derived
+ * figures (success rate, averages, period-over-period deltas) are computed
+ * by the consumer.
+ */
+interface PaymentPeriodStats {
+    /** Sum of all payment intent amounts, in major units. */
+    total_volume: number;
+    /** Sum of succeeded payment intent amounts, in major units. */
+    successful_volume: number;
+    /** Count of all payment intents. */
+    transactions: number;
+    /** Count of succeeded payment intents. */
+    successful_transactions: number;
+    /** Count of successful refunds created in the window. */
+    refunds: number;
+    /** Sum of successful refund amounts created in the window, in major units. */
+    refund_volume: number;
 }
 interface PaymentAnalyticsResponse {
-    total_volume: PaymentStat;
-    success_rate: PaymentStat;
-    transactions: PaymentStat;
-    avg_transaction: PaymentStat;
+    /** Base measures for the requested window. */
+    current: PaymentPeriodStats;
+    /** Base measures for the equal-length window immediately before it. */
+    previous: PaymentPeriodStats;
     currency: string;
     period_days: number;
 }
+
+/** Query for the platform ledger-analytics endpoint. */
+interface AdminLedgerAnalyticsRequest {
+    /** Trailing days for a rolling window. Default 30, capped at 90. */
+    days?: number | null;
+    /** Naive ISO 8601 datetime for the window start (custom range; span ≤ 90 days). */
+    start_date?: string | null;
+    /** Naive ISO 8601 datetime for the inclusive last day. Defaults to now. */
+    end_date?: string | null;
+    /**
+     * Comma-separated selector for which response blocks the server computes, so
+     * a pinned card fetches only what it renders. Tokens: `summary` (total
+     * balance, net change, account-status counts, the `current` aggregate +
+     * `previous` window), `series` (the day-by-day flow) and `merchants` (the
+     * biggest-top-ups donut — the only block paying the per-merchant
+     * name-resolution cost). Omit for all blocks. Unrequested blocks come back
+     * empty / zero.
+     */
+    sections?: string | null;
+}
+/** One day of platform-wide ledger movement, in USD minor units. */
+interface LedgerDayBucket {
+    /** Balance merchants added by paying in (topup_credit), positive. */
+    topup_amount: number;
+    topup_count: number;
+    /** Platform fees collected (fee_debit + merchant_fee_debit), positive. */
+    fee_amount: number;
+    fee_count: number;
+    /** Other credits (admin_credit + promo_credit), positive. */
+    credit_amount: number;
+    credit_count: number;
+    /** Other debits (admin_debit), positive. */
+    debit_amount: number;
+    debit_count: number;
+    /** Net of every entry that day (signed) — the day's platform balance change. */
+    net_amount: number;
+}
+/**
+ * Platform ledger-analytics response. All money is in USD minor units
+ * (`currency`). `series` is the current window day by day; `previous` is the
+ * equal-length prior window aggregated, for deltas.
+ */
+interface AdminLedgerAnalyticsResponse {
+    currency: string;
+    days: number;
+    end_date: string;
+    /** Sum of every billing account's current balance (USD minor). */
+    total_balance: number;
+    /** Net balance change over the window (USD minor) = balance now − at start. */
+    net_change: number;
+    accounts_total: number;
+    accounts_active: number;
+    accounts_delinquent: number;
+    accounts_suspended: number;
+    /**
+     * The current window aggregated into a single bucket (the sum of `series`),
+     * so a totals-only card (e.g. fee revenue) reads `current.fee_amount` without
+     * iterating `series`. Part of the `summary` section.
+     */
+    current: LedgerDayBucket;
+    series: LedgerDayBucket[];
+    /**
+     * The previous period day by day, same length as `series`, for the over-time
+     * period-over-period overlay (e.g. "top-ups over time"). Empty unless the
+     * `series` section is requested.
+     */
+    previous_series: LedgerDayBucket[];
+    previous: LedgerDayBucket;
+    /** Merchants with the largest top-up totals this window (USD minor), capped. */
+    top_merchants: LedgerMerchant[];
+    /** Combined top-ups of merchants beyond the cap (USD minor). */
+    other_merchants_topup: number;
+    /** How many merchants fell into `other_merchants_topup`. */
+    other_merchants_count: number;
+}
+/** One merchant's top-up total over the window (USD minor). */
+interface LedgerMerchant {
+    id: string;
+    name: string;
+    topup_amount: number;
+}
 interface AuditLogListParams {
     user_id?: string | null;
     merchant_id?: string | null;
@@ -407,6 +511,19 @@ declare class AdminPortal {
     analytics(params: AdminAnalyticsRequest): Promise<PlatformAnalyticsResponse>;
     overviewStats(): Promise<OverviewStatsResponse>;
     paymentAnalytics(params: PaymentAnalyticsRequest): Promise<PaymentAnalyticsResponse>;
+    /**
+     * One drill level of the analytics dashboard: the scope's daily series +
+     * processor mix and its direct children's series. Range / metric / donut
+     * toggles apply client-side; only a drill (passing merchant_id / project_id
+     * / shop_id) fetches the next level.
+     */
+    analyticsScope(params?: AnalyticsScopeRequest): Promise<AnalyticsScopeResponse>;
+    /**
+     * Platform billing dashboard: total balance across all ledger accounts (+
+     * the net change), top-ups, fees collected, and the day-by-day ledger flow.
+     * All amounts are in USD minor units.
+     */
+    ledgerAnalytics(params?: AdminLedgerAnalyticsRequest): Promise<AdminLedgerAnalyticsResponse>;
     /**
      * Retrieve a merchant account via the admin portal. Unlike
      * `merchantAccounts.retrieve`, this route accepts an admin JWT (or admin API
@@ -584,9 +701,15 @@ declare class PlatformBilling {
 /**
  * Platform-wide fee schedule management. Admin-only routes under
  * `/admin/fees/*`. Exposed only via `'@delopay/sdk/internal'`.
+ *
+ * `platformFees.rules` manages the platform-owned Euclid fee-rule program per
+ * merchant, which takes precedence over the flat platform schedules. Build the
+ * program with `feeProgram()`.
  */
 declare class PlatformFees {
     private readonly request;
+    /** Platform-owned Euclid fee-rule program (`/admin/fees/rules`). */
+    readonly rules: PlatformFeeRulesManager;
     constructor(request: RequestFn);
     /** Create a platform fee schedule for a specific merchant. */
     create(params: FeeScheduleCreateRequest, merchantId: string): Promise<FeeScheduleResponse>;
@@ -599,6 +722,21 @@ declare class PlatformFees {
     /** Delete a platform fee schedule. */
     delete(feeId: string): Promise<FeeScheduleResponse>;
 }
+/**
+ * Manages a merchant's platform-owned Euclid fee-rule program (admin surface).
+ * Build the `algorithm` with `feeProgram()`. The SDK injects
+ * `fee_owner: 'platform'`.
+ */
+declare class PlatformFeeRulesManager {
+    private readonly request;
+    constructor(request: RequestFn);
+    /** Create or replace the platform fee-rule program for a merchant. */
+    upsert(params: PlatformFeeRuleInput, merchantId: string): Promise<PlatformFeeRuleRecord>;
+    /** Retrieve the active platform fee-rule program for a merchant, or `null`. */
+    retrieve(merchantId: string): Promise<PlatformFeeRuleRecord | null>;
+    /** Deactivate the platform fee-rule program for a merchant. Idempotent. */
+    delete(merchantId: string): Promise<void>;
+}
 
 /**
  * Internal-only Delopay client for DeloPay staff tooling (the admin
@@ -634,4 +772,4 @@ declare class DelopayInternal extends Delopay {
     constructor(...args: ConstructorParameters<typeof Delopay>);
 }
 
-export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, AdminPortal, type AdminSetTrustedRequest, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, Configs, type ConnectorRestrictionResponse, ConnectorRestrictions, type ConnectorVisibility, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, PaymentResponse, type PaymentStat, type PlatformAnalyticsResponse, PlatformBilling, PlatformFees, ProfileResponse, ProjectResponse, RequestFn, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, type UpsertConnectorRestrictionRequest };
+export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, type AdminLedgerAnalyticsRequest, type AdminLedgerAnalyticsResponse, AdminPortal, type AdminSetTrustedRequest, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, Configs, type ConnectorRestrictionResponse, ConnectorRestrictions, type ConnectorVisibility, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, type LedgerDayBucket, type LedgerMerchant, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, type PaymentPeriodStats, PaymentResponse, type PlatformAnalyticsResponse, PlatformBilling, PlatformFeeRuleInput, PlatformFeeRuleRecord, PlatformFees, ProfileResponse, ProjectResponse, RequestFn, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, type UpsertConnectorRestrictionRequest };

package/dist/internal.d.ts

@@ -1,5 +1,5 @@
-import { ProjectResponse, ShopResponse, PaymentResponse, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, BillingProfileResponse, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.js';
-export { Address, AddressDetails, AllocationListResponse, AllocationResponse, AllocationTransferRequest, AllocationTransferResponse, Analytics, AnalyticsDashboard, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyExpiration, ApiKeyResponse, ApiKeyRevokeResponse, ApiKeyUpdateRequest, ApplePayVerificationRequest, ApplePayVerificationResponse, ApplePayVerifiedDomainsResponse, AuthenticationCreateRequest, AuthenticationResponse, AuthenticationStatus, AuthenticationType, AutoRechargeConfig, AutoRechargeUpdateRequest, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, BillingCompleteSetupRequest, BillingSetupRequest, BillingSetupResponse, BlocklistAddRequest, BlocklistDataKind, BlocklistResponse, BrandingExport, BrandingSource, BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, CancelSubscriptionRequest, CancelSubscriptionResponse, CaptureMethod, CardDetail, CardDetailFromLocker, Cards, ChangePasswordRequest, CheckoutBranding, ConfirmSubscriptionPaymentDetails, ConfirmSubscriptionRequest, ConfirmSubscriptionResponse, Connector, ConnectorCreateRequest, ConnectorListResponse, ConnectorResponse, ConnectorType, ConnectorUpdateRequest, ConnectorVolumeSplit, ConnectorWebhookEntry, ConnectorWebhookEventType, ConnectorWebhookListResponse, ConnectorWebhookRegisterRequest, ConnectorWebhookRegisterResponse, CornerRadius, CreateAndConfirmSubscriptionRequest, CreateSubscriptionPaymentDetails, CreateSubscriptionRequest, Currency, CustomerCreateRequest, CustomerListParams, CustomerPaymentMethodsListParams, CustomerPaymentMethodsListResponse, CustomerResponse, CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, DeleteAccountRequest, DelopayAuthenticationError, DelopayError, DelopayLogger, DelopayOptions, DisputeEvidenceRequest, DisputeListParams, DisputeResponse, DisputeStage, DisputeStatus, EncodedBranding, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EventClass, EventDeliveryAttemptResponse, EventDetailResponse, EventListParams, EventListResponse, EventResponse, EventType, Export, FeatureMatrix, FeeOwner, FeeType, Files, FontFamily, FontWeight, Forex, ForgotPasswordRequest, FromEmailRequest, FutureUsage, GatewayConnectRequest, GatewayResponse, GetSubscriptionItemsParams, GetSubscriptionItemsResponse, GlobalSearchRequest, IntentStatus, InviteUsersRequest, InviteUsersResponse, InvoiceStatus, LabelStyle, LayoutStyle, LedgerEntry, LedgerListParams, LedgerResponse, LinkedRoutingConfigRetrieveResponse, ListInvitableRolesParams, LoginHistoryEntry, LoginHistoryParams, LoginHistoryResponse, LogoShape, LogoSize, MandateListParams, MandateResponse, MandateRevokedResponse, MandateStatus, MandateType, MerchantAccountCreateRequest, MerchantAccountType, MerchantOverviewResponse, MerchantOverviewStat, MerchantRoutingAlgorithm, NonPillRadius, ParentGroup, ParentGroupInfo, PauseSubscriptionRequest, PauseSubscriptionResponse, PaymentCancelRequest, PaymentCaptureRequest, PaymentConfirmRequest, PaymentCreateRequest, PaymentLayout, PaymentLinkBackgroundImageConfig, PaymentLinkConfigRequest, PaymentLinkListParams, PaymentLinkListResponse, PaymentLinkResponse, PaymentLinkTransactionDetails, PaymentListParams, PaymentListResponse, PaymentMethod, PaymentMethodCreateRequest, PaymentMethodDeleteResponse, PaymentMethodListParams, PaymentMethodResponse, PaymentMethodType, PaymentMethodUpdateRequest, PaymentRetrieveOptions, PaymentUpdateRequest, PayoutCreateRequest, PayoutListParams, PayoutListResponse, PayoutResponse, PayoutStatus, PayoutType, PayoutUpdateRequest, PermissionScope, PhoneDetails, PhoneOtpRequest, PhoneOtpResponse, PhoneOtpVerifyRequest, PhoneOtpVerifyResponse, PollStatus, PollStatusResponse, ProfileAcquirerCreateRequest, ProfileAcquirerResponse, ProfileAcquirerUpdateRequest, ProfileCreateRequest, ProfileDefaultRoutingConfig, ProfileLogoUploadResponse, ProfileUpdateRequest, ProjectCreateRequest, ProjectStats, ProjectStatsResponse, ProjectUpdateRequest, RecoveryCodesResponse, RefundCreateRequest, RefundListParams, RefundListResponse, RefundResponse, RefundStatus, RefundType, RefundUpdateRequest, RegionCreateRequest, RegionResponse, RegionUpdateRequest, Regions, RelayRequest, RelayResponse, RelayStatus, RelayType, RequestExtras, RequestOptions, ResetPasswordRequest, ResumeSubscriptionRequest, ResumeSubscriptionResponse, RoutableConnectorChoice, RoutingActivatePayload, RoutingConfigCreateRequest, RoutingConfigResponse, RoutingDeactivateRequest, RoutingDictionary, RoutingDictionaryRecord, Search, SearchGroupResponse, SearchIndex, SearchStatus, ShopCreateRequest, ShopStats, ShopUpdateRequest, SignInRequest, SignUpRequest, SignUpWithMerchantRequest, SizeScale, SpacingScale, StaticRoutingAlgorithm, StripeConnectAccountRequest, StripeConnectAccountResponse, StripeConnectLinkRequest, StripeConnectLinkResponse, SubscriptionEstimateParams, SubscriptionEstimateResponse, SubscriptionInvoice, SubscriptionItem, SubscriptionItemPrice, SubscriptionItemType, SubscriptionLineItem, SubscriptionListParams, SubscriptionPaymentData, SubscriptionPaymentDetails, SubscriptionPeriodUnit, SubscriptionResponse, SubscriptionStatus, Subscriptions, SummaryPosition, SurfaceStyle, SwitchMerchantRequest, SwitchProfileRequest, Terminate2faQueryParams, ThreeDSDecision, ThreeDsRuleExecuteRequest, ThreeDsRuleResponse, TierSummary, TokenPurpose, TokenResponse, TopupRequest, TopupResponse, TotpResponse, TransactionType, TrustBadge, UpdateSubscriptionRequest, UpdateUserDetailsRequest, UserResponse, UserSessionEntry, UserSessionListResponse, UserSessionRevokeResponse, VerifyTotpRequest, WebhookDeliveryAttempt, WebhookEvent, Webhooks, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, logoDimensions, parseImportedBranding, radiusValue, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue } from './index.js';
+import { ProjectResponse, ShopResponse, PaymentResponse, RequestFn, AuthResponse, SignUpWithMerchantIdRequest, AnalyticsScopeRequest, AnalyticsScopeResponse, MerchantAccountResponse, MerchantAccountUpdateRequest, ProfileResponse, BillingProfileResponse, PlatformFeeRuleInput, PlatformFeeRuleRecord, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Delopay } from './index.js';
+export { Address, AddressDetails, AllocationListResponse, AllocationResponse, AllocationTransferRequest, AllocationTransferResponse, Analytics, AnalyticsChild, AnalyticsConnectorDay, AnalyticsConnectorSeries, AnalyticsDashboard, AnalyticsDayBucket, ApiKeyCreateRequest, ApiKeyCreateResponse, ApiKeyExpiration, ApiKeyResponse, ApiKeyRevokeResponse, ApiKeyUpdateRequest, ApplePayVerificationRequest, ApplePayVerificationResponse, ApplePayVerifiedDomainsResponse, AuthenticationCreateRequest, AuthenticationResponse, AuthenticationStatus, AuthenticationType, AutoRechargeConfig, AutoRechargeUpdateRequest, BRANDING_EXPORT_FORMAT, BRANDING_EXPORT_VERSION, BillingCompleteSetupRequest, BillingSetupRequest, BillingSetupResponse, BlocklistAddRequest, BlocklistDataKind, BlocklistResponse, BrandingExport, BrandingSource, BusinessPaymentLinkConfig, CUSTOM_CSS_MAX_LENGTH, CancelSubscriptionRequest, CancelSubscriptionResponse, CaptureMethod, CardDetail, CardDetailFromLocker, Cards, ChangePasswordRequest, CheckoutBranding, ConfirmSubscriptionPaymentDetails, ConfirmSubscriptionRequest, ConfirmSubscriptionResponse, Connector, ConnectorCreateRequest, ConnectorListResponse, ConnectorResponse, ConnectorType, ConnectorUpdateRequest, ConnectorVolumeSplit, ConnectorWebhookEntry, ConnectorWebhookEventType, ConnectorWebhookListResponse, ConnectorWebhookRegisterRequest, ConnectorWebhookRegisterResponse, CornerRadius, CreateAndConfirmSubscriptionRequest, CreateSubscriptionPaymentDetails, CreateSubscriptionRequest, Currency, CustomerCreateRequest, CustomerListParams, CustomerPaymentMethodsListParams, CustomerPaymentMethodsListResponse, CustomerResponse, CustomerUpdateRequest, DEFAULT_BADGES, DEFAULT_BADGES_DARK, DEFAULT_BRANDING, DEFAULT_BRANDING_DARK, DeleteAccountRequest, DelopayAuthenticationError, DelopayError, DelopayLogger, DelopayOptions, DisputeEvidenceRequest, DisputeListParams, DisputeResponse, DisputeStage, DisputeStatus, EncodedBranding, EphemeralKeyCreateRequest, EphemeralKeyCreateResponse, EuclidComparison, EuclidComparisonType, EuclidIfStatement, EuclidValue, EventClass, EventDeliveryAttemptResponse, EventDetailResponse, EventListParams, EventListResponse, EventResponse, EventType, Export, FeatureMatrix, FeeOwner, FeeProgramBuilder, FeeRuleConditions, FeeRuleInput, FeeSpecInput, FeeType, Files, FontFamily, FontWeight, Forex, ForgotPasswordRequest, FromEmailRequest, FutureUsage, GatewayConnectRequest, GatewayResponse, GetSubscriptionItemsParams, GetSubscriptionItemsResponse, GlobalSearchRequest, IntentStatus, InviteUsersRequest, InviteUsersResponse, InvoiceStatus, LabelStyle, LayoutStyle, LedgerEntry, LedgerListParams, LedgerResponse, LinkedRoutingConfigRetrieveResponse, ListInvitableRolesParams, LoginHistoryEntry, LoginHistoryParams, LoginHistoryResponse, LogoShape, LogoSize, MandateListParams, MandateResponse, MandateRevokedResponse, MandateStatus, MandateType, MerchantAccountCreateRequest, MerchantAccountType, MerchantOverviewResponse, MerchantOverviewStat, MerchantRoutingAlgorithm, NonPillRadius, ParentGroup, ParentGroupInfo, PauseSubscriptionRequest, PauseSubscriptionResponse, PaymentCancelRequest, PaymentCaptureRequest, PaymentConfirmRequest, PaymentCreateRequest, PaymentLayout, PaymentLinkBackgroundImageConfig, PaymentLinkConfigRequest, PaymentLinkListParams, PaymentLinkListResponse, PaymentLinkResponse, PaymentLinkTransactionDetails, PaymentListParams, PaymentListResponse, PaymentMethod, PaymentMethodCreateRequest, PaymentMethodDeleteResponse, PaymentMethodListParams, PaymentMethodResponse, PaymentMethodType, PaymentMethodUpdateRequest, PaymentRetrieveOptions, PaymentUpdateRequest, PayoutCreateRequest, PayoutListParams, PayoutListResponse, PayoutResponse, PayoutStatus, PayoutType, PayoutUpdateRequest, PermissionScope, PhoneDetails, PhoneOtpRequest, PhoneOtpResponse, PhoneOtpVerifyRequest, PhoneOtpVerifyResponse, PlatformFeeKind, PlatformFeeOutput, PlatformFeeProgram, PlatformFeeRule, PlatformFeeRuleOutput, PlatformFeeRuleRequest, PollStatus, PollStatusResponse, ProfileAcquirerCreateRequest, ProfileAcquirerResponse, ProfileAcquirerUpdateRequest, ProfileCreateRequest, ProfileDefaultRoutingConfig, ProfileLogoUploadResponse, ProfileUpdateRequest, ProjectCreateRequest, ProjectStats, ProjectStatsResponse, ProjectUpdateRequest, RecoveryCodesResponse, RefundCreateRequest, RefundListParams, RefundListResponse, RefundResponse, RefundStatus, RefundType, RefundUpdateRequest, RegionCreateRequest, RegionResponse, RegionUpdateRequest, Regions, RelayRequest, RelayResponse, RelayStatus, RelayType, RequestExtras, RequestOptions, ResetPasswordRequest, ResumeSubscriptionRequest, ResumeSubscriptionResponse, RoutableConnectorChoice, RoutingActivatePayload, RoutingConfigCreateRequest, RoutingConfigResponse, RoutingDeactivateRequest, RoutingDictionary, RoutingDictionaryRecord, Search, SearchGroupResponse, SearchIndex, SearchStatus, ShopCreateRequest, ShopStats, ShopUpdateRequest, SignInRequest, SignUpRequest, SignUpWithMerchantRequest, SizeScale, SpacingScale, StaticRoutingAlgorithm, StripeConnectAccountRequest, StripeConnectAccountResponse, StripeConnectLinkRequest, StripeConnectLinkResponse, SubscriptionEstimateParams, SubscriptionEstimateResponse, SubscriptionInvoice, SubscriptionItem, SubscriptionItemPrice, SubscriptionItemType, SubscriptionLineItem, SubscriptionListParams, SubscriptionPaymentData, SubscriptionPaymentDetails, SubscriptionPeriodUnit, SubscriptionResponse, SubscriptionStatus, Subscriptions, SummaryPosition, SurfaceStyle, SwitchMerchantRequest, SwitchProfileRequest, Terminate2faQueryParams, ThreeDSDecision, ThreeDsRuleExecuteRequest, ThreeDsRuleResponse, TierSummary, TokenPurpose, TokenResponse, TopupRequest, TopupResponse, TotpResponse, TransactionType, TrustBadge, UpdateSubscriptionRequest, UpdateUserDetailsRequest, UserResponse, UserSessionEntry, UserSessionListResponse, UserSessionRevokeResponse, VerifyTotpRequest, WebhookDeliveryAttempt, WebhookEvent, Webhooks, applyBrandingVariables, buildBrandingExport, buttonPadValue, cloneBranding, decodeBadges, decodeBranding, defaultBranding, encodeBadges, encodeBranding, feeProgram, fontStack, fontWeightValue, inputPadValue, isDarkSurface, isHexColor, logoDimensions, parseImportedBranding, radiusValue, sanitizeCustomCss, shadowFor, surfacePadValue, verticalGapValue } from './index.js';
 
 /**
  * Internal-only type surface. Exposed via `'@delopay/sdk/internal'` only.
@@ -152,8 +152,6 @@ interface AdminCustomerDetail {
     customer_id: string;
     organization_id: string;
     employee_count: number;
-    total_transactions: number;
-    total_volume: number;
     created_at: string;
     customer_name?: string | null;
     projects: ProjectResponse[];
@@ -197,22 +195,128 @@ interface PlatformAnalyticsResponse {
     period_end: string;
 }
 interface PaymentAnalyticsRequest {
+    /** Rolling window in days. Ignored when start_date is provided. */
     period?: number | null;
+    /** Naive ISO 8601 datetime (e.g. 2026-06-01T00:00:00). Takes precedence over period. */
+    start_date?: string | null;
+    /** Naive ISO 8601 datetime. Defaults to now when only start_date is set. */
+    end_date?: string | null;
+    /** Limit stats to a single customer/merchant. Omitted = platform-wide. */
+    merchant_id?: string | null;
+    /** Limit stats to the shops of one project. Requires merchant_id. */
+    project_id?: string | null;
+    /** Limit stats to a single shop. Requires merchant_id; wins over project_id. */
+    shop_id?: string | null;
     currency?: string | null;
 }
-interface PaymentStat {
-    label: string;
-    value: number;
-    change_percent: number;
+/**
+ * The four independent payment measures for one reporting window. Derived
+ * figures (success rate, averages, period-over-period deltas) are computed
+ * by the consumer.
+ */
+interface PaymentPeriodStats {
+    /** Sum of all payment intent amounts, in major units. */
+    total_volume: number;
+    /** Sum of succeeded payment intent amounts, in major units. */
+    successful_volume: number;
+    /** Count of all payment intents. */
+    transactions: number;
+    /** Count of succeeded payment intents. */
+    successful_transactions: number;
+    /** Count of successful refunds created in the window. */
+    refunds: number;
+    /** Sum of successful refund amounts created in the window, in major units. */
+    refund_volume: number;
 }
 interface PaymentAnalyticsResponse {
-    total_volume: PaymentStat;
-    success_rate: PaymentStat;
-    transactions: PaymentStat;
-    avg_transaction: PaymentStat;
+    /** Base measures for the requested window. */
+    current: PaymentPeriodStats;
+    /** Base measures for the equal-length window immediately before it. */
+    previous: PaymentPeriodStats;
     currency: string;
     period_days: number;
 }
+
+/** Query for the platform ledger-analytics endpoint. */
+interface AdminLedgerAnalyticsRequest {
+    /** Trailing days for a rolling window. Default 30, capped at 90. */
+    days?: number | null;
+    /** Naive ISO 8601 datetime for the window start (custom range; span ≤ 90 days). */
+    start_date?: string | null;
+    /** Naive ISO 8601 datetime for the inclusive last day. Defaults to now. */
+    end_date?: string | null;
+    /**
+     * Comma-separated selector for which response blocks the server computes, so
+     * a pinned card fetches only what it renders. Tokens: `summary` (total
+     * balance, net change, account-status counts, the `current` aggregate +
+     * `previous` window), `series` (the day-by-day flow) and `merchants` (the
+     * biggest-top-ups donut — the only block paying the per-merchant
+     * name-resolution cost). Omit for all blocks. Unrequested blocks come back
+     * empty / zero.
+     */
+    sections?: string | null;
+}
+/** One day of platform-wide ledger movement, in USD minor units. */
+interface LedgerDayBucket {
+    /** Balance merchants added by paying in (topup_credit), positive. */
+    topup_amount: number;
+    topup_count: number;
+    /** Platform fees collected (fee_debit + merchant_fee_debit), positive. */
+    fee_amount: number;
+    fee_count: number;
+    /** Other credits (admin_credit + promo_credit), positive. */
+    credit_amount: number;
+    credit_count: number;
+    /** Other debits (admin_debit), positive. */
+    debit_amount: number;
+    debit_count: number;
+    /** Net of every entry that day (signed) — the day's platform balance change. */
+    net_amount: number;
+}
+/**
+ * Platform ledger-analytics response. All money is in USD minor units
+ * (`currency`). `series` is the current window day by day; `previous` is the
+ * equal-length prior window aggregated, for deltas.
+ */
+interface AdminLedgerAnalyticsResponse {
+    currency: string;
+    days: number;
+    end_date: string;
+    /** Sum of every billing account's current balance (USD minor). */
+    total_balance: number;
+    /** Net balance change over the window (USD minor) = balance now − at start. */
+    net_change: number;
+    accounts_total: number;
+    accounts_active: number;
+    accounts_delinquent: number;
+    accounts_suspended: number;
+    /**
+     * The current window aggregated into a single bucket (the sum of `series`),
+     * so a totals-only card (e.g. fee revenue) reads `current.fee_amount` without
+     * iterating `series`. Part of the `summary` section.
+     */
+    current: LedgerDayBucket;
+    series: LedgerDayBucket[];
+    /**
+     * The previous period day by day, same length as `series`, for the over-time
+     * period-over-period overlay (e.g. "top-ups over time"). Empty unless the
+     * `series` section is requested.
+     */
+    previous_series: LedgerDayBucket[];
+    previous: LedgerDayBucket;
+    /** Merchants with the largest top-up totals this window (USD minor), capped. */
+    top_merchants: LedgerMerchant[];
+    /** Combined top-ups of merchants beyond the cap (USD minor). */
+    other_merchants_topup: number;
+    /** How many merchants fell into `other_merchants_topup`. */
+    other_merchants_count: number;
+}
+/** One merchant's top-up total over the window (USD minor). */
+interface LedgerMerchant {
+    id: string;
+    name: string;
+    topup_amount: number;
+}
 interface AuditLogListParams {
     user_id?: string | null;
     merchant_id?: string | null;
@@ -407,6 +511,19 @@ declare class AdminPortal {
     analytics(params: AdminAnalyticsRequest): Promise<PlatformAnalyticsResponse>;
     overviewStats(): Promise<OverviewStatsResponse>;
     paymentAnalytics(params: PaymentAnalyticsRequest): Promise<PaymentAnalyticsResponse>;
+    /**
+     * One drill level of the analytics dashboard: the scope's daily series +
+     * processor mix and its direct children's series. Range / metric / donut
+     * toggles apply client-side; only a drill (passing merchant_id / project_id
+     * / shop_id) fetches the next level.
+     */
+    analyticsScope(params?: AnalyticsScopeRequest): Promise<AnalyticsScopeResponse>;
+    /**
+     * Platform billing dashboard: total balance across all ledger accounts (+
+     * the net change), top-ups, fees collected, and the day-by-day ledger flow.
+     * All amounts are in USD minor units.
+     */
+    ledgerAnalytics(params?: AdminLedgerAnalyticsRequest): Promise<AdminLedgerAnalyticsResponse>;
     /**
      * Retrieve a merchant account via the admin portal. Unlike
      * `merchantAccounts.retrieve`, this route accepts an admin JWT (or admin API
@@ -584,9 +701,15 @@ declare class PlatformBilling {
 /**
  * Platform-wide fee schedule management. Admin-only routes under
  * `/admin/fees/*`. Exposed only via `'@delopay/sdk/internal'`.
+ *
+ * `platformFees.rules` manages the platform-owned Euclid fee-rule program per
+ * merchant, which takes precedence over the flat platform schedules. Build the
+ * program with `feeProgram()`.
  */
 declare class PlatformFees {
     private readonly request;
+    /** Platform-owned Euclid fee-rule program (`/admin/fees/rules`). */
+    readonly rules: PlatformFeeRulesManager;
     constructor(request: RequestFn);
     /** Create a platform fee schedule for a specific merchant. */
     create(params: FeeScheduleCreateRequest, merchantId: string): Promise<FeeScheduleResponse>;
@@ -599,6 +722,21 @@ declare class PlatformFees {
     /** Delete a platform fee schedule. */
     delete(feeId: string): Promise<FeeScheduleResponse>;
 }
+/**
+ * Manages a merchant's platform-owned Euclid fee-rule program (admin surface).
+ * Build the `algorithm` with `feeProgram()`. The SDK injects
+ * `fee_owner: 'platform'`.
+ */
+declare class PlatformFeeRulesManager {
+    private readonly request;
+    constructor(request: RequestFn);
+    /** Create or replace the platform fee-rule program for a merchant. */
+    upsert(params: PlatformFeeRuleInput, merchantId: string): Promise<PlatformFeeRuleRecord>;
+    /** Retrieve the active platform fee-rule program for a merchant, or `null`. */
+    retrieve(merchantId: string): Promise<PlatformFeeRuleRecord | null>;
+    /** Deactivate the platform fee-rule program for a merchant. Idempotent. */
+    delete(merchantId: string): Promise<void>;
+}
 
 /**
  * Internal-only Delopay client for DeloPay staff tooling (the admin
@@ -634,4 +772,4 @@ declare class DelopayInternal extends Delopay {
     constructor(...args: ConstructorParameters<typeof Delopay>);
 }
 
-export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, AdminPortal, type AdminSetTrustedRequest, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, Configs, type ConnectorRestrictionResponse, ConnectorRestrictions, type ConnectorVisibility, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, PaymentResponse, type PaymentStat, type PlatformAnalyticsResponse, PlatformBilling, PlatformFees, ProfileResponse, ProjectResponse, RequestFn, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, type UpsertConnectorRestrictionRequest };
+export { Admin, type AdminAdjustmentRequest, type AdminAdjustmentResponse, type AdminAnalyticsRequest, type AdminCreateUserForMerchantRequest, type AdminCustomerDetail, type AdminCustomerListParams, type AdminCustomerListResponse, type AdminLedgerAnalyticsRequest, type AdminLedgerAnalyticsResponse, AdminPortal, type AdminSetTrustedRequest, type AdminSignInRequest, type AdminSuspendRequest, type AdminTransactionListParams, type AdminTransactionListResponse, type AdminUnsuspendRequest, type AdminUpdateUserRequest, type AdminUserResponse, AnalyticsScopeRequest, AnalyticsScopeResponse, type AuditLogListParams, type AuditLogListResponse, type AuditLogResponse, AuditLogs, AuthResponse, type AuthorizeResponse, BillingProfileResponse, Cache, type CardIssuerCreateRequest, type CardIssuerListResponse, type CardIssuerResponse, type CardIssuerUpdateRequest, CardIssuers, Configs, type ConnectorRestrictionResponse, ConnectorRestrictions, type ConnectorVisibility, type CreateInternalUserRequest, type CreateTenantUserRequest, type CustomerSummary, type CustomerUser, Delopay, DelopayInternal, FeeScheduleCreateRequest, FeeScheduleResponse, FeeScheduleUpdateRequest, Gsm, type GsmDecision, type GsmRuleCreateRequest, type GsmRuleResponse, type GsmRuleUpdateRequest, type LedgerDayBucket, type LedgerMerchant, MerchantAccountResponse, MerchantAccountUpdateRequest, type OnboardMerchantRequest, type OnboardMerchantResponse, type OverviewStat, type OverviewStatsResponse, type PaymentAnalyticsRequest, type PaymentAnalyticsResponse, type PaymentPeriodStats, PaymentResponse, type PlatformAnalyticsResponse, PlatformBilling, PlatformFeeRuleInput, PlatformFeeRuleRecord, PlatformFees, ProfileResponse, ProjectResponse, RequestFn, ShopResponse, SignUpWithMerchantIdRequest, type SignupToggleRequest, type SignupToggleResponse, type UpsertConnectorRestrictionRequest };

package/dist/internal.js

@@ -14,6 +14,7 @@ import {
   DelopayError,
   Export,
   FeatureMatrix,
+  FeeProgramBuilder,
   Files,
   Forex,
   Regions,
@@ -29,6 +30,7 @@ import {
   defaultBranding,
   encodeBadges,
   encodeBranding,
+  feeProgram,
   fontStack,
   fontWeightValue,
   inputPadValue,
@@ -41,7 +43,7 @@ import {
   shadowFor,
   surfacePadValue,
   verticalGapValue
-} from "./chunk-45OPT3EW.js";
+} from "./chunk-IQKFNKHU.js";
 
 // src/internal/resources/admin.ts
 var Admin = class {
@@ -114,6 +116,27 @@ var AdminPortal = class {
       query: params
     });
   }
+  /**
+   * One drill level of the analytics dashboard: the scope's daily series +
+   * processor mix and its direct children's series. Range / metric / donut
+   * toggles apply client-side; only a drill (passing merchant_id / project_id
+   * / shop_id) fetches the next level.
+   */
+  async analyticsScope(params) {
+    return this.request("GET", "/admin-portal/analytics/scope", {
+      query: params
+    });
+  }
+  /**
+   * Platform billing dashboard: total balance across all ledger accounts (+
+   * the net change), top-ups, fees collected, and the day-by-day ledger flow.
+   * All amounts are in USD minor units.
+   */
+  async ledgerAnalytics(params) {
+    return this.request("GET", "/admin-portal/ledger-analytics", {
+      query: params
+    });
+  }
   /**
    * Retrieve a merchant account via the admin portal. Unlike
    * `merchantAccounts.retrieve`, this route accepts an admin JWT (or admin API
@@ -375,6 +398,7 @@ var PlatformBilling = class {
 var PlatformFees = class {
   constructor(request) {
     this.request = request;
+    this.rules = new PlatformFeeRulesManager(request);
   }
   /** Create a platform fee schedule for a specific merchant. */
   async create(params, merchantId) {
@@ -402,6 +426,31 @@ var PlatformFees = class {
     return this.request("DELETE", `/admin/fees/${encodeURIComponent(feeId)}`);
   }
 };
+var PlatformFeeRulesManager = class {
+  constructor(request) {
+    this.request = request;
+  }
+  /** Create or replace the platform fee-rule program for a merchant. */
+  async upsert(params, merchantId) {
+    const body = { ...params, fee_owner: "platform" };
+    return this.request("PUT", "/admin/fees/rules", {
+      body,
+      query: { merchant_id: merchantId }
+    });
+  }
+  /** Retrieve the active platform fee-rule program for a merchant, or `null`. */
+  async retrieve(merchantId) {
+    return this.request("GET", "/admin/fees/rules", {
+      query: { merchant_id: merchantId }
+    });
+  }
+  /** Deactivate the platform fee-rule program for a merchant. Idempotent. */
+  async delete(merchantId) {
+    await this.request("DELETE", "/admin/fees/rules", {
+      query: { merchant_id: merchantId }
+    });
+  }
+};
 
 // src/internal/client.ts
 var DelopayInternal = class extends Delopay {
@@ -444,6 +493,7 @@ export {
   DelopayInternal,
   Export,
   FeatureMatrix,
+  FeeProgramBuilder,
   Files,
   Forex,
   Gsm,
@@ -462,6 +512,7 @@ export {
   defaultBranding,
   encodeBadges,
   encodeBranding,
+  feeProgram,
   fontStack,
   fontWeightValue,
   inputPadValue,