@fundedfast/sdk 1.3.0 → 1.5.0

package/dist/cjs/resources/admin.js

@@ -1,6 +1,35 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.AdminSupportApi = exports.AdminTemplatesApi = exports.AdminNotificationChannelsApi = exports.AdminUsersApi = exports.AdminReconciliationApi = exports.AdminAdaptersApi = exports.AdminSelfExclusionApi = exports.AdminRewardRulesApi = exports.AdminRewardsApi = exports.AdminNotificationsApi = exports.AdminAchievementsApi = exports.AdminAnalyticsApi = exports.AdminLoyaltyApi = exports.AdminTournamentsApi = exports.AdminMissionsApi = exports.AdminBonusesApi = exports.AdminSettingsApi = exports.AdminAuditApi = exports.AdminWebhooksApi = exports.AdminBetsApi = exports.AdminRulesetsApi = exports.AdminChallengeTiersApi = exports.AdminApi = void 0;
+exports.AdminSupportApi = exports.AdminTemplatesApi = exports.AdminNotificationChannelsApi = exports.AdminUsersApi = exports.AdminReconciliationApi = exports.AdminAdaptersApi = exports.AdminSelfExclusionApi = exports.AdminRewardRulesApi = exports.AdminRewardsApi = exports.AdminNotificationsApi = exports.AdminAchievementsApi = exports.AdminAnalyticsApi = exports.AdminLoyaltyApi = exports.AdminTournamentsApi = exports.AdminMissionsApi = exports.AdminBonusesApi = exports.AdminSettingsApi = exports.AdminAuditApi = exports.AdminWebhooksApi = exports.AdminPayoutsApi = exports.AdminBetsApi = exports.AdminRulesetsApi = exports.AdminChallengeTiersApi = exports.AdminApi = void 0;
+/** Encode one path segment, so an id containing `/`, `?` or `#` cannot change the route. */
+const seg = (value) => encodeURIComponent(value);
+/** Fill the deprecated `reasonCodes` alias from the API's `rejectionReasons`. */
+const withReasonCodes = (b) => ({ ...b, reasonCodes: b.rejectionReasons ?? [] });
+function toGrantBody(data) {
+    const { rewardValue, value, ...rest } = data;
+    const v = value ?? rewardValue;
+    if (v == null)
+        throw new TypeError('rewards grant: `value` is required');
+    return { ...rest, value: v };
+}
+function toRuleBody(data) {
+    const { triggerType, triggerThreshold, ...rest } = data;
+    const body = { ...rest };
+    if (!rest.criteria && triggerType != null) {
+        body.criteria = { type: triggerType, threshold: triggerThreshold ?? 0 };
+    }
+    return body;
+}
+/** A new rule needs criteria (or the old triggerType), and starts enabled. */
+function toRuleCreateBody(data) {
+    const { enabled: _enabled, ...body } = toRuleBody(data);
+    if (!body.criteria)
+        throw new TypeError('reward rule: `criteria` (or `triggerType`) is required');
+    if (body.name == null || body.rewardType == null || body.rewardValue == null) {
+        throw new TypeError('reward rule: `name`, `rewardType` and `rewardValue` are required');
+    }
+    return body;
+}
 class AdminApi {
     challengeTiers;
     rulesets;
@@ -24,10 +53,12 @@ class AdminApi {
     notificationChannels;
     templates;
     support;
+    payouts;
     constructor(client) {
         this.challengeTiers = new AdminChallengeTiersApi(client);
         this.rulesets = new AdminRulesetsApi(client);
         this.bets = new AdminBetsApi(client);
+        this.payouts = new AdminPayoutsApi(client);
         this.webhooks = new AdminWebhooksApi(client);
         this.audit = new AdminAuditApi(client);
         this.settings = new AdminSettingsApi(client);
@@ -64,11 +95,11 @@ class AdminChallengeTiersApi {
         return res.challengeTier;
     }
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/challenge-tiers/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/challenge-tiers/${seg(id)}`, { body: data });
         return res.challengeTier;
     }
     async delete(id) {
-        return this.client.request('DELETE', `/admin/challenge-tiers/${id}`);
+        return this.client.request('DELETE', `/admin/challenge-tiers/${seg(id)}`);
     }
 }
 exports.AdminChallengeTiersApi = AdminChallengeTiersApi;
@@ -86,11 +117,11 @@ class AdminRulesetsApi {
         return res.ruleset;
     }
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/rulesets/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/rulesets/${seg(id)}`, { body: data });
         return res.ruleset;
     }
     async delete(id) {
-        return this.client.request('DELETE', `/admin/rulesets/${id}`);
+        return this.client.request('DELETE', `/admin/rulesets/${seg(id)}`);
     }
 }
 exports.AdminRulesetsApi = AdminRulesetsApi;
@@ -99,6 +130,7 @@ class AdminBetsApi {
     constructor(client) {
         this.client = client;
     }
+    /** Bet events, newest first (max 200). */
     async list(options) {
         const query = {};
         if (options?.status)
@@ -106,18 +138,29 @@ class AdminBetsApi {
         if (options?.userId)
             query.userId = options.userId;
         const res = await this.client.request('GET', '/admin/bet-events', { query });
-        return res.betEvents;
+        return res.betEvents.map(withReasonCodes);
     }
     async settle(id, outcome) {
-        const res = await this.client.request('POST', `/admin/bet-events/${id}/settle`, { body: { outcome } });
-        return res.betEvent;
+        const res = await this.client.request('POST', `/admin/bet-events/${seg(id)}/settle`, { body: { outcome } });
+        return res.betEvent ? withReasonCodes(res.betEvent) : res.betEvent;
     }
+    /**
+     * Settle up to 50 placed bets in one call. Each result says `settled` or
+     * `error` (with the reason, e.g. `not_found`, `already_settled`).
+     */
     async bulkSettle(settlements) {
-        return this.client.request('POST', '/admin/bet-events/bulk-settle', { body: { settlements } });
+        const res = await this.client.request('POST', '/admin/bet-events/bulk-settle', { body: { settlements } });
+        return { ...res, results: (res.results ?? []).map(r => ({ ...r, success: r.status === 'settled' })) };
     }
     async bulkExpire() {
         return this.client.request('POST', '/admin/challenges/bulk-expire');
     }
+    /**
+     * Export bet events as CSV (up to 10,000 rows), header line included.
+     *
+     * @param options.from / options.to - full ISO 8601 date-times (e.g. `2026-10-01T00:00:00Z`); a bare date is rejected
+     * @returns The CSV text
+     */
     async export(options) {
         const query = {};
         if (options?.from)
@@ -126,10 +169,46 @@ class AdminBetsApi {
             query.to = options.to;
         if (options?.userId)
             query.userId = options.userId;
-        return this.client.request('GET', '/admin/bet-events/export', { query });
+        if (options?.status)
+            query.status = options.status;
+        return this.client.request('GET', '/admin/bet-events/export', { query, responseType: 'text' });
     }
 }
 exports.AdminBetsApi = AdminBetsApi;
+/** Funded payout requests waiting for the operator, and the decision on them. */
+class AdminPayoutsApi {
+    client;
+    constructor(client) {
+        this.client = client;
+    }
+    async list(options) {
+        const query = {};
+        if (options?.status)
+            query.status = options.status;
+        if (options?.userId)
+            query.userId = options.userId;
+        if (options?.limit)
+            query.limit = String(options.limit);
+        const res = await this.client.request('GET', '/admin/payout-requests', { query });
+        return res.requests;
+    }
+    /**
+     * Execute a pending request: the money moves and the cycle closes.
+     *
+     * @throws {FastApiError} 409 `open_bets` while the account has bets not yet settled; confirm once they have
+     * @throws {FastApiError} 409 `payout_amount_changed` when a full-amount request no longer matches what is available
+     *   (a bet settled since it was made). The request is updated to the new amount; review it and confirm again.
+     * @throws {FastApiError} 409 `payout_request_not_pending` if it was already decided
+     */
+    async confirm(id) {
+        return this.client.request('POST', `/admin/payout-requests/${seg(id)}/confirm`, { body: {} });
+    }
+    /** Reject a pending request. Nothing on the account changes. */
+    async reject(id, reason) {
+        return this.client.request('POST', `/admin/payout-requests/${seg(id)}/reject`, { body: { reason: reason ?? null } });
+    }
+}
+exports.AdminPayoutsApi = AdminPayoutsApi;
 class AdminWebhooksApi {
     client;
     constructor(client) {
@@ -143,12 +222,16 @@ class AdminWebhooksApi {
         const res = await this.client.request('GET', '/admin/webhooks/dead-letters');
         return res.deadLetters;
     }
+    /**
+     * Replay a dead-lettered webhook delivery.
+     * @throws {FastApiError} 404 `not_found`, 409 `already_replayed`
+     */
     async replay(id) {
-        return this.client.request('POST', `/admin/webhooks/dead-letters/${id}/replay`);
+        return this.client.request('POST', `/admin/webhooks/dead-letters/${seg(id)}/replay`);
     }
     /** Retry a failed webhook delivery (resets it to pending and re-dispatches). */
     async retry(id) {
-        return this.client.request('POST', `/admin/webhooks/${id}/retry`);
+        return this.client.request('POST', `/admin/webhooks/${seg(id)}/retry`);
     }
     /**
      * List dead-letter post-bet hook runs (gamification, bonuses, missions,
@@ -158,12 +241,20 @@ class AdminWebhooksApi {
     async hookDeadLetters() {
         return this.client.request('GET', '/admin/hooks/dead-letters');
     }
-    /** Replay a dead-letter post-bet hook run. Double-counting is prevented server-side. */
+    /**
+     * Replay a dead-letter post-bet hook run. Double-counting is prevented server-side.
+     * @throws {FastApiError} 404 `not_found`, 409 `already_replayed`, 502 `hook_failed` when the hook fails again (a 5xx, so the client's retry policy applies first)
+     */
     async replayHook(id) {
-        return this.client.request('POST', `/admin/hooks/dead-letters/${id}/replay`);
+        return this.client.request('POST', `/admin/hooks/dead-letters/${seg(id)}/replay`);
     }
+    /**
+     * Rotate the webhook signing secret. The new secret is in `newSecret` and is
+     * shown only here; the old one stays valid for `gracePeriodHours`.
+     */
     async rotateSecret() {
-        return this.client.request('POST', '/admin/webhooks/rotate-secret');
+        const res = await this.client.request('POST', '/admin/webhooks/rotate-secret');
+        return { ...res, webhookSecret: res.newSecret };
     }
     async health() {
         return this.client.request('GET', '/admin/webhooks/health');
@@ -184,23 +275,44 @@ class AdminAuditApi {
     constructor(client) {
         this.client = client;
     }
+    /**
+     * Ledger audit view: bet events (`type: 'bets'`, the default) or webhook
+     * deliveries (`type: 'webhooks'`). For the admin action log use {@link adminLog}.
+     */
     async list(options) {
         const query = {};
         if (options?.type)
             query.type = options.type;
+        if (options?.userId)
+            query.userId = options.userId;
+        if (options?.from)
+            query.from = options.from;
+        if (options?.to)
+            query.to = options.to;
         if (options?.limit)
             query.limit = String(options.limit);
         if (options?.offset)
             query.offset = String(options.offset);
         return this.client.request('GET', '/audit/log', { query });
     }
-    /** Admin audit log (different view from /audit/log) */
+    /**
+     * Admin action log: who changed what. Filter by `actor` (an admin email, or
+     * `api-key`), `action`, `resourceType` and a full ISO 8601 `from`/`to`.
+     * `userId` is a deprecated alias of `actor`.
+     */
     async adminLog(options) {
         const query = {};
         if (options?.action)
             query.action = options.action;
-        if (options?.userId)
-            query.userId = options.userId;
+        const actor = options?.actor ?? options?.userId;
+        if (actor)
+            query.actor = actor;
+        if (options?.resourceType)
+            query.resourceType = options.resourceType;
+        if (options?.from)
+            query.from = options.from;
+        if (options?.to)
+            query.to = options.to;
         if (options?.limit)
             query.limit = String(options.limit);
         if (options?.offset)
@@ -243,6 +355,7 @@ class AdminSettingsApi {
     async getIntegrationMode() {
         return this.client.request('GET', '/admin/integration-mode');
     }
+    /** Set the webhook URL. Pass null to stop deliveries. */
     async setWebhookUrl(url) {
         return this.client.request('PUT', '/admin/settings/webhook', { body: { webhookUrl: url } });
     }
@@ -257,9 +370,18 @@ class AdminSettingsApi {
     async setChallengeLimit(limit) {
         return this.client.request('PUT', '/admin/settings/challenge-limit', { body: { operatorChallengeLimit: limit } });
     }
-    async setCurrency(currency, symbol) {
-        return this.client.request('PUT', '/admin/settings/currency', { body: { currency, currencySymbol: symbol } });
+    /**
+     * Set the default currency (ISO 4217) and, optionally, the list of supported
+     * currencies. The API has no currency symbol setting; a string passed as the
+     * second argument (the old `symbol` parameter) is ignored.
+     */
+    async setCurrency(defaultCurrency, supportedCurrencies) {
+        const body = { defaultCurrency };
+        if (Array.isArray(supportedCurrencies))
+            body.supportedCurrencies = supportedCurrencies;
+        return this.client.request('PUT', '/admin/settings/currency', { body });
     }
+    /** Set the funded exposure alert threshold. Pass null to disable. */
     async setExposureAlert(threshold) {
         return this.client.request('PUT', '/admin/exposure-alert', { body: { threshold } });
     }
@@ -273,8 +395,11 @@ class AdminSettingsApi {
     async downloadExport(date) {
         return this.client.request('GET', '/admin/settings/export/download', { query: { date } });
     }
-    async testExport() {
-        return this.client.request('POST', '/admin/settings/export/test');
+    /**
+     * Generate the daily export now, for yesterday (UTC) or `date` (YYYY-MM-DD).
+     */
+    async testExport(date) {
+        return this.client.request('POST', '/admin/settings/export/test', { body: date ? { date } : {} });
     }
     async getTheme() {
         const res = await this.client.request('GET', '/admin/theme');
@@ -313,30 +438,35 @@ class AdminBonusesApi {
         return res.offer;
     }
     async updateOffer(id, data) {
-        const res = await this.client.request('PUT', `/admin/bonus-offers/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/bonus-offers/${seg(id)}`, { body: data });
         return res.offer;
     }
+    /** Disable an offer. The API keeps the row (sets `enabled: false`) rather than deleting it. */
     async deleteOffer(id) {
-        return this.client.request('DELETE', `/admin/bonus-offers/${id}`);
+        return this.client.request('DELETE', `/admin/bonus-offers/${seg(id)}`);
     }
+    /** Active user bonuses across the tenant. */
     async listActive() {
         const res = await this.client.request('GET', '/admin/bonuses');
         return res.bonuses;
     }
     async cancel(id) {
-        return this.client.request('POST', `/admin/bonuses/${id}/cancel`);
+        return this.client.request('POST', `/admin/bonuses/${seg(id)}/cancel`);
     }
+    /** @param data.depositAmount - Integer cents, like every bonus amount (5000 = 50.00). */
     async grantToUser(data) {
         return this.client.request('POST', '/admin/bonuses/grant', { body: data });
     }
     async stats() {
-        return this.client.request('GET', '/admin/bonuses/stats');
+        const { correlationId: _c, ...stats } = await this.client.request('GET', '/admin/bonuses/stats');
+        return stats;
     }
     async getUserBonuses(userId) {
-        return this.client.request('GET', `/users/${userId}/bonuses`);
+        return this.client.request('GET', `/users/${seg(userId)}/bonuses`);
     }
+    /** @param depositAmount - Integer cents (5000 = 50.00); required for deposit_match and reload offers. */
     async activate(userId, bonusOfferId, depositAmount) {
-        return this.client.request('POST', `/users/${userId}/bonuses/activate`, { body: { bonusOfferId, depositAmount } });
+        return this.client.request('POST', `/users/${seg(userId)}/bonuses/activate`, { body: { bonusOfferId, depositAmount } });
     }
 }
 exports.AdminBonusesApi = AdminBonusesApi;
@@ -354,23 +484,25 @@ class AdminMissionsApi {
         return res.mission;
     }
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/missions/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/missions/${seg(id)}`, { body: data });
         return res.mission;
     }
+    /** Disable a mission. The API keeps the row (sets `enabled: false`) rather than deleting it. */
     async delete(id) {
-        return this.client.request('DELETE', `/admin/missions/${id}`);
+        return this.client.request('DELETE', `/admin/missions/${seg(id)}`);
     }
     async stats() {
         return this.client.request('GET', '/admin/missions/stats');
     }
     async statsForMission(id) {
-        return this.client.request('GET', `/admin/missions/${id}/stats`);
+        const res = await this.client.request('GET', `/admin/missions/${seg(id)}/stats`);
+        return res.stats;
     }
     async getUserMissions(userId) {
-        return this.client.request('GET', `/users/${userId}/missions`);
+        return this.client.request('GET', `/users/${seg(userId)}/missions`);
     }
     async join(userId, missionId) {
-        return this.client.request('POST', `/users/${userId}/missions/${missionId}/join`);
+        return this.client.request('POST', `/users/${seg(userId)}/missions/${seg(missionId)}/join`);
     }
 }
 exports.AdminMissionsApi = AdminMissionsApi;
@@ -388,24 +520,27 @@ class AdminTournamentsApi {
         return res.tournament;
     }
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/tournaments/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/tournaments/${seg(id)}`, { body: data });
         return res.tournament;
     }
-    /** Cancel an upcoming or active tournament. */
+    /**
+     * Cancel an upcoming or active tournament. `cancelled` is false when the
+     * tournament is unknown, already finished or already cancelled.
+     */
     async cancel(id) {
-        return this.client.request('POST', `/admin/tournaments/${id}/cancel`);
+        return this.client.request('POST', `/admin/tournaments/${seg(id)}/cancel`);
     }
     async settle(id) {
-        return this.client.request('POST', `/admin/tournaments/${id}/settle`);
+        return this.client.request('POST', `/admin/tournaments/${seg(id)}/settle`);
     }
     async entries(id) {
-        return this.client.request('GET', `/admin/tournaments/${id}/entries`);
+        return this.client.request('GET', `/admin/tournaments/${seg(id)}/entries`);
     }
     async invite(id, userIds) {
-        return this.client.request('POST', `/admin/tournaments/${id}/invite`, { body: { userIds } });
+        return this.client.request('POST', `/admin/tournaments/${seg(id)}/invite`, { body: { userIds } });
     }
     async invites(id) {
-        return this.client.request('GET', `/admin/tournaments/${id}/invites`);
+        return this.client.request('GET', `/admin/tournaments/${seg(id)}/invites`);
     }
     async stats() {
         return this.client.request('GET', '/admin/tournaments/stats');
@@ -415,10 +550,10 @@ class AdminTournamentsApi {
         return res.tournaments;
     }
     async leaderboard(tournamentId, limit = 10) {
-        return this.client.request('GET', `/tournaments/${tournamentId}/leaderboard`, { query: { limit: String(limit) } });
+        return this.client.request('GET', `/tournaments/${seg(tournamentId)}/leaderboard`, { query: { limit: String(limit) } });
     }
     async join(userId, tournamentId) {
-        return this.client.request('POST', `/users/${userId}/tournaments/${tournamentId}/join`);
+        return this.client.request('POST', `/users/${seg(userId)}/tournaments/${seg(tournamentId)}/join`);
     }
 }
 exports.AdminTournamentsApi = AdminTournamentsApi;
@@ -444,26 +579,44 @@ class AdminLoyaltyApi {
         return res.tier;
     }
     async updateTier(id, data) {
-        const res = await this.client.request('PUT', `/admin/loyalty/tiers/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/loyalty/tiers/${seg(id)}`, { body: data });
         return res.tier;
     }
     async deleteTier(id) {
-        return this.client.request('DELETE', `/admin/loyalty/tiers/${id}`);
+        return this.client.request('DELETE', `/admin/loyalty/tiers/${seg(id)}`);
     }
+    /**
+     * Users' loyalty state, most points first. Filter by `tier`, the tier
+     * **name**. `tierId` is still accepted: the SDK looks the name up first.
+     */
     async listUsers(options) {
         const query = {};
-        if (options?.tierId)
-            query.tierId = options.tierId;
+        let tier = options?.tier;
+        if (!tier && options?.tierId) {
+            const match = (await this.getTiers()).find(t => t.id === options.tierId);
+            // An unknown id must not widen the result to every user.
+            tier = match ? match.name : options.tierId;
+        }
+        if (tier)
+            query.tier = tier;
         if (options?.limit)
             query.limit = String(options.limit);
+        if (options?.offset)
+            query.offset = String(options.offset);
         return this.client.request('GET', '/admin/loyalty/users', { query });
     }
+    /** One user's loyalty state and recent point history. `loyalty` is null when the user has none yet. */
     async getUser(userId) {
-        const res = await this.client.request('GET', `/admin/loyalty/users/${userId}`);
-        return res.user;
+        const { loyalty, history } = await this.client.request('GET', `/admin/loyalty/users/${seg(userId)}`);
+        return { loyalty, history };
     }
+    /**
+     * Add (positive) or remove (negative) points. The API records a reason with
+     * every adjustment; when none is given the SDK sends `'Manual adjustment'`.
+     */
     async adjustPoints(userId, points, reason) {
-        return this.client.request('POST', `/admin/loyalty/users/${userId}/adjust`, { body: { points, reason } });
+        const { newTotal } = await this.client.request('POST', `/admin/loyalty/users/${seg(userId)}/adjust`, { body: { points, reason: reason || 'Manual adjustment' } });
+        return { newTotal };
     }
     async getPublicTiers() {
         const res = await this.client.request('GET', '/loyalty/tiers');
@@ -474,7 +627,7 @@ class AdminLoyaltyApi {
         return res.stats;
     }
     async getUserLoyalty(userId) {
-        const res = await this.client.request('GET', `/users/${userId}/loyalty`);
+        const res = await this.client.request('GET', `/users/${seg(userId)}/loyalty`);
         return res.loyalty;
     }
 }
@@ -484,26 +637,42 @@ class AdminAnalyticsApi {
     constructor(client) {
         this.client = client;
     }
-    async overview() {
-        return this.client.request('GET', '/admin/overview');
+    /** Dashboard overview for a month (default: the current one). */
+    async overview(options) {
+        const query = {};
+        if (options?.month)
+            query.month = String(options.month);
+        if (options?.year)
+            query.year = String(options.year);
+        return this.client.request('GET', '/admin/overview', { query });
     }
+    /**
+     * Recent API requests for the tenant, newest first (max 200). Filter by
+     * `path` prefix, `status` (e.g. `500`, `4xx`) or `correlationId`.
+     * The API does not paginate; `offset` is ignored.
+     */
     async requestLog(options) {
         const query = {};
+        if (options?.path)
+            query.path = options.path;
+        if (options?.status)
+            query.status = options.status;
+        if (options?.correlationId)
+            query.correlationId = options.correlationId;
         if (options?.limit)
             query.limit = String(options.limit);
-        if (options?.offset)
-            query.offset = String(options.offset);
-        return this.client.request('GET', '/admin/request-log', { query });
+        const { requests } = await this.client.request('GET', '/admin/request-log', { query });
+        return { requests };
     }
-    /** Challenge analytics (pass/fail rates, volumes) with optional ISO 8601 date range. */
+    /** Challenge analytics (pass/fail rates, volumes). `from`/`to` are full ISO 8601 date-times; a bare date is rejected. */
     async challenges(options) {
         return this.client.request('GET', '/analytics/challenges', { query: { from: options?.from, to: options?.to } });
     }
-    /** Revenue analytics with optional ISO 8601 date range. */
+    /** Revenue analytics. `from`/`to` are full ISO 8601 date-times; a bare date is rejected. */
     async revenue(options) {
         return this.client.request('GET', '/analytics/revenue', { query: { from: options?.from, to: options?.to } });
     }
-    /** User cohort analytics with optional ISO 8601 date range. */
+    /** User cohort analytics. `from`/`to` are full ISO 8601 date-times; a bare date is rejected. */
     async users(options) {
         return this.client.request('GET', '/analytics/users', { query: { from: options?.from, to: options?.to } });
     }
@@ -551,27 +720,29 @@ class AdminAchievementsApi {
         return res.achievement;
     }
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/achievements/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/achievements/${seg(id)}`, { body: data });
         return res.achievement;
     }
     async delete(id) {
-        return this.client.request('DELETE', `/admin/achievements/${id}`);
+        return this.client.request('DELETE', `/admin/achievements/${seg(id)}`);
     }
     async forUser(userId) {
-        return this.client.request('GET', `/admin/users/${userId}/achievements`);
+        return this.client.request('GET', `/admin/users/${seg(userId)}/achievements`);
     }
+    /** @throws {FastApiError} 409 `already_earned` if the user has it */
     async grant(userId, achievementId) {
-        const res = await this.client.request('POST', `/admin/users/${userId}/achievements`, { body: { achievementId } });
+        const res = await this.client.request('POST', `/admin/users/${seg(userId)}/achievements`, { body: { achievementId } });
         return res.userAchievement;
     }
+    /** Grant one achievement to up to 500 users. Users who already have it are counted in `skipped`. */
     async bulkGrant(data) {
         return this.client.request('POST', '/admin/achievements/bulk-grant', { body: data });
     }
     async gdprExport(userId) {
-        return this.client.request('GET', `/admin/users/${userId}/gdpr-export`);
+        return this.client.request('GET', `/admin/users/${seg(userId)}/gdpr-export`);
     }
     async gdprErase(userId, confirmUserId) {
-        return this.client.request('POST', `/admin/users/${userId}/gdpr-erase`, { body: { confirmUserId } });
+        return this.client.request('POST', `/admin/users/${seg(userId)}/gdpr-erase`, { body: { confirmUserId } });
     }
 }
 exports.AdminAchievementsApi = AdminAchievementsApi;
@@ -613,19 +784,33 @@ class AdminRewardsApi {
         const query = { userId };
         if (options?.limit)
             query.limit = String(options.limit);
-        return this.client.request('GET', '/admin/rewards/history', { query });
+        const { history } = await this.client.request('GET', '/admin/rewards/history', { query });
+        return { history };
     }
-    /** Manually grant a reward to a user. */
+    /**
+     * Manually grant a reward to a user.
+     *
+     * `value` is in EUR for money types, otherwise percent or days.
+     * `rewardValue` is accepted as a deprecated alias of `value`.
+     *
+     * @returns The id of the new pending reward
+     */
     async grant(data) {
-        return this.client.request('POST', '/admin/rewards/grant', { body: data });
+        const { rewardId } = await this.client.request('POST', '/admin/rewards/grant', { body: toGrantBody(data) });
+        return { rewardId };
     }
-    /** Bulk grant a reward to multiple users. */
+    /** Grant the same reward to up to 500 users. `rewardValue` is a deprecated alias of `value`. */
     async bulkGrant(data) {
-        return this.client.request('POST', '/admin/rewards/bulk-grant', { body: data });
+        const { granted, failed } = await this.client.request('POST', '/admin/rewards/bulk-grant', { body: toGrantBody(data) });
+        return { granted, failed };
     }
-    /** Delete (revoke) a pending reward. */
+    /**
+     * Revoke a pending (unconsumed) reward.
+     * @throws {FastApiError} 404 if it does not exist or was already consumed
+     */
     async delete(id) {
-        return this.client.request('DELETE', `/admin/rewards/${id}`);
+        const { revoked } = await this.client.request('DELETE', `/admin/rewards/${seg(id)}`);
+        return { revoked, deleted: revoked };
     }
 }
 exports.AdminRewardsApi = AdminRewardsApi;
@@ -640,18 +825,22 @@ class AdminRewardRulesApi {
         return res.rules;
     }
     /** Create a new reward rule. */
+    /**
+     * Create a reward rule. `name`, `criteria`, `rewardType` and `rewardValue`
+     * are required. The deprecated `triggerType`/`triggerThreshold` are mapped to `criteria`.
+     */
     async create(data) {
-        const res = await this.client.request('POST', '/admin/reward-rules', { body: data });
+        const res = await this.client.request('POST', '/admin/reward-rules', { body: toRuleCreateBody(data) });
         return res.rule;
     }
     /** Update an existing reward rule. */
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/reward-rules/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/reward-rules/${seg(id)}`, { body: toRuleBody(data) });
         return res.rule;
     }
     /** Delete a reward rule. */
     async delete(id) {
-        return this.client.request('DELETE', `/admin/reward-rules/${id}`);
+        return this.client.request('DELETE', `/admin/reward-rules/${seg(id)}`);
     }
 }
 exports.AdminRewardRulesApi = AdminRewardRulesApi;
@@ -660,21 +849,46 @@ class AdminSelfExclusionApi {
     constructor(client) {
         this.client = client;
     }
-    /** List all currently excluded users. */
-    async list() {
-        return this.client.request('GET', '/admin/self-exclusion');
+    /** List currently excluded users (paginated: limit default 100, max 500). */
+    async list(options) {
+        const query = {};
+        if (options?.limit != null)
+            query.limit = String(options.limit);
+        if (options?.offset != null)
+            query.offset = String(options.offset);
+        const { entries, total, limit, offset } = await this.client.request('GET', '/admin/self-exclusion', { query });
+        return { entries, total, limit, offset, exclusions: entries };
     }
-    /** Get exclusion status for a specific user. Returns 404 if not excluded. */
+    /**
+     * Get the exclusion for a user.
+     * @throws {FastApiError} 404 if the user is not excluded
+     */
     async get(userId) {
-        return this.client.request('GET', `/admin/self-exclusion/${userId}`);
+        const res = await this.client.request('GET', `/admin/self-exclusion/${seg(userId)}`);
+        return res.entry;
     }
-    /** Exclude a user from purchasing challenges. Upsert: re-excluding updates the record. */
+    /**
+     * Exclude a user from purchasing challenges. Upsert: re-excluding updates the record.
+     *
+     * Give `expiresAt` (ISO 8601) for a temporary exclusion; omit it (or pass
+     * null) for a permanent one. `durationDays` is converted to `expiresAt`
+     * client-side (now + days).
+     */
     async exclude(data) {
-        return this.client.request('POST', '/admin/self-exclusion', { body: data });
+        const { durationDays, ...body } = data;
+        if (body.expiresAt === undefined && durationDays != null) {
+            body.expiresAt = new Date(Date.now() + durationDays * 86_400_000).toISOString();
+        }
+        const res = await this.client.request('POST', '/admin/self-exclusion', { body });
+        return res.entry;
     }
-    /** Lift (remove) self-exclusion for a user. */
+    /**
+     * Lift the exclusion for a user (the record is removed).
+     * @throws {FastApiError} 404 if the user is not excluded
+     */
     async lift(userId) {
-        return this.client.request('DELETE', `/admin/self-exclusion/${userId}`);
+        const res = await this.client.request('DELETE', `/admin/self-exclusion/${seg(userId)}`);
+        return { reinstated: res.reinstated, userId: res.userId, lifted: res.reinstated };
     }
 }
 exports.AdminSelfExclusionApi = AdminSelfExclusionApi;
@@ -695,12 +909,12 @@ class AdminAdaptersApi {
     }
     /** Update an adapter mapping. */
     async update(id, data) {
-        const res = await this.client.request('PUT', `/admin/adapters/${id}`, { body: data });
+        const res = await this.client.request('PUT', `/admin/adapters/${seg(id)}`, { body: data });
         return res.adapter;
     }
     /** Delete an adapter mapping. */
     async delete(id) {
-        return this.client.request('DELETE', `/admin/adapters/${id}`);
+        return this.client.request('DELETE', `/admin/adapters/${seg(id)}`);
     }
 }
 exports.AdminAdaptersApi = AdminAdaptersApi;
@@ -735,7 +949,7 @@ class AdminUsersApi {
      * bet events, achievements, and pending/applied rewards.
      */
     async get(userId) {
-        return this.client.request('GET', `/admin/users/${userId}`);
+        return this.client.request('GET', `/admin/users/${seg(userId)}`);
     }
     /**
      * Manually revoke the active funded account for a user.
@@ -748,7 +962,7 @@ class AdminUsersApi {
      * @throws {FastApiError} 404 if the user has no active funded account
      */
     async revokeFunded(userId, reason) {
-        return this.client.request('POST', `/admin/users/${userId}/revoke-funded`, { body: reason ? { reason } : {} });
+        return this.client.request('POST', `/admin/users/${seg(userId)}/revoke-funded`, { body: reason ? { reason } : {} });
     }
 }
 exports.AdminUsersApi = AdminUsersApi;
@@ -771,14 +985,14 @@ class AdminNotificationChannelsApi {
         return this.client.request('POST', '/admin/notification-channels', { body: data });
     }
     async update(id, data) {
-        return this.client.request('PUT', `/admin/notification-channels/${id}`, { body: data });
+        return this.client.request('PUT', `/admin/notification-channels/${seg(id)}`, { body: data });
     }
     async delete(id) {
-        return this.client.request('DELETE', `/admin/notification-channels/${id}`);
+        return this.client.request('DELETE', `/admin/notification-channels/${seg(id)}`);
     }
     /** Send a test notification to the channel. */
     async test(id) {
-        return this.client.request('POST', `/admin/notification-channels/${id}/test`);
+        return this.client.request('POST', `/admin/notification-channels/${seg(id)}/test`);
     }
 }
 exports.AdminNotificationChannelsApi = AdminNotificationChannelsApi;
@@ -795,14 +1009,15 @@ class AdminTemplatesApi {
         return this.client.request('GET', '/admin/templates');
     }
     async get(id) {
-        return this.client.request('GET', `/admin/templates/${id}`);
+        const res = await this.client.request('GET', `/admin/templates/${seg(id)}`);
+        return res.template;
     }
     /**
      * Clone a template into your tenant. Creates a new ruleset and challenge
      * tier; you can override the tier name, own stake, and duration.
      */
     async clone(id, overrides) {
-        return this.client.request('POST', `/admin/templates/${id}/clone`, { body: overrides ?? {} });
+        return this.client.request('POST', `/admin/templates/${seg(id)}/clone`, { body: overrides ?? {} });
     }
 }
 exports.AdminTemplatesApi = AdminTemplatesApi;
@@ -814,28 +1029,40 @@ class AdminSupportApi {
     constructor(client) {
         this.client = client;
     }
+    /** Support requests for the tenant. The API does not paginate; `limit` is ignored. */
     async list(options) {
         const query = {};
         if (options?.status)
             query.status = options.status;
-        if (options?.limit)
-            query.limit = String(options.limit);
         return this.client.request('GET', '/admin/support/requests', { query });
     }
+    /** A support request with its messages. */
     async get(id) {
-        return this.client.request('GET', `/admin/support/requests/${id}`);
+        return this.client.request('GET', `/admin/support/requests/${seg(id)}`);
     }
-    /** Open a new support request. Category defaults to 'other'. */
+    /**
+     * Open a new support request. Category defaults to 'other'.
+     *
+     * @deprecated Needs an admin session: the API records which admin wrote it
+     * and answers 400 `unauthorized` to a server API key. It works only if the
+     * client sends an admin JWT, e.g. `new FastClient({ apiKey, headers: { Authorization: 'Bearer <admin JWT>' } })`.
+     * Open requests from the backoffice instead.
+     */
     async create(data) {
         return this.client.request('POST', '/admin/support/requests', { body: data });
     }
-    /** Add a message to an existing support request. */
+    /**
+     * Add a message to an existing support request.
+     *
+     * @deprecated Needs an admin session, like {@link create}: a server API key
+     * gets 400 `unauthorized`. Reply from the backoffice instead.
+     */
     async addMessage(id, body) {
-        return this.client.request('POST', `/admin/support/requests/${id}/messages`, { body: { body } });
+        return this.client.request('POST', `/admin/support/requests/${seg(id)}/messages`, { body: { body } });
     }
     /** Close a support request. */
     async close(id) {
-        return this.client.request('POST', `/admin/support/requests/${id}/close`);
+        return this.client.request('POST', `/admin/support/requests/${seg(id)}/close`);
     }
 }
 exports.AdminSupportApi = AdminSupportApi;