@fundedfast/sdk 1.3.0

package/dist/esm/client.js

@@ -0,0 +1,355 @@
+/**
+ * @fundedfast/sdk - Client
+ *
+ * Production-grade HTTP client for the FAST platform API.
+ * Features: automatic retries with exponential backoff, rate limit awareness,
+ * request/response hooks, idempotency support, debug logging, and proper error handling.
+ *
+ * @example
+ * ```typescript
+ * import { FastClient } from '@fundedfast/sdk';
+ *
+ * const fast = new FastClient({
+ *   apiKey: process.env.FAST_API_KEY!,
+ *   retry: { maxRetries: 3 },
+ *   onResponse: ({ status, durationMs, correlationId }) => {
+ *     metrics.histogram('fast.request.duration', durationMs, { status });
+ *   },
+ * });
+ *
+ * const result = await fast.bets.validate({
+ *   userId: 'player-42',
+ *   externalBetId: 'BET-001',
+ *   stakeAmount: 5.00,
+ *   odds: 2.10,
+ *   status: 'placed',
+ * });
+ * ```
+ *
+ * @module client
+ */
+import { ChallengesApi, BetsApi, UsersApi, ReconciliationApi, EventsApi, SandboxApi, WidgetApi, } from './resources/public.js';
+import { AdminApi } from './resources/admin.js';
+// ============================================================================
+// CONSTANTS
+// ============================================================================
+const DEFAULT_BASE_URL = 'https://api.fundedfast.eu/v1';
+const DEFAULT_TIMEOUT = 10_000;
+export const SDK_VERSION = '1.3.0';
+const USER_AGENT = `fundedfast-sdk/${SDK_VERSION} node/${typeof globalThis !== 'undefined' && 'process' in globalThis ? globalThis.process?.version || 'unknown' : 'unknown'}`;
+const DEFAULT_RETRY = {
+    maxRetries: 3,
+    initialDelay: 300,
+    maxDelay: 10_000,
+    retryableStatuses: [429, 500, 502, 503, 504],
+};
+/** The key as it may appear in logs: its prefix and last four characters. */
+function redactKey(key) {
+    if (key.length <= 8)
+        return '***';
+    const prefix = /^[a-z]+[-_]/i.exec(key)?.[0] ?? '';
+    return `${prefix}***${key.slice(-4)}`;
+}
+/** Random idempotency key (crypto.randomUUID where available - Node 19+/browsers). */
+function generateIdempotencyKey() {
+    const c = globalThis.crypto;
+    if (c && typeof c.randomUUID === 'function')
+        return c.randomUUID();
+    return `sdk-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 12)}-${Math.random().toString(36).slice(2, 12)}`;
+}
+function sleep(ms) {
+    return new Promise(resolve => setTimeout(resolve, ms));
+}
+// ============================================================================
+// ERROR CLASSES
+// ============================================================================
+/**
+ * Error thrown when the FAST API returns a non-2xx response.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   await fast.challenges.purchase({ userId: 'x', challengeTierId: 'invalid' });
+ * } catch (err) {
+ *   if (err instanceof FastApiError) {
+ *     console.log(err.status);        // 400
+ *     console.log(err.code);          // 'validation_error'
+ *     console.log(err.correlationId); // 'abc-123' (for support)
+ *     console.log(err.isRetryable);   // false
+ *   }
+ * }
+ * ```
+ */
+export class FastApiError extends Error {
+    status;
+    code;
+    correlationId;
+    isRetryable;
+    rateLimitReset;
+    constructor(status, body, rateLimitReset) {
+        super(body.message || body.error || `HTTP ${status}`);
+        this.name = 'FastApiError';
+        this.status = status;
+        this.code = body.error || `http_${status}`;
+        this.correlationId = body.correlationId || '';
+        this.isRetryable = DEFAULT_RETRY.retryableStatuses.includes(status);
+        this.rateLimitReset = rateLimitReset;
+    }
+}
+/**
+ * Error thrown when a request times out.
+ */
+export class FastTimeoutError extends Error {
+    timeoutMs;
+    constructor(timeoutMs) {
+        super(`Request timed out after ${timeoutMs}ms`);
+        this.name = 'FastTimeoutError';
+        this.timeoutMs = timeoutMs;
+    }
+}
+/**
+ * Error thrown when a network error occurs (DNS, connection refused, etc.)
+ */
+export class FastNetworkError extends Error {
+    cause;
+    constructor(cause) {
+        super(`Network error: ${cause.message}`);
+        this.name = 'FastNetworkError';
+        this.cause = cause;
+    }
+}
+// ============================================================================
+// CLIENT
+// ============================================================================
+/**
+ * FAST Platform API client.
+ *
+ * Provides typed access to all operator-facing endpoints with automatic retry,
+ * rate limit handling, and observability hooks.
+ *
+ * @example
+ * ```typescript
+ * const fast = new FastClient({ apiKey: 'key-...' });
+ *
+ * // Namespaced APIs
+ * const tiers = await fast.challenges.listTiers();
+ * const result = await fast.bets.validate(betEvent);
+ * const progress = await fast.users.getProgress('player-42');
+ * ```
+ */
+export class FastClient {
+    baseUrl;
+    apiKey;
+    timeout;
+    retryConfig;
+    onRequest;
+    onResponse;
+    _fetch;
+    customHeaders;
+    debug;
+    /** Challenge purchase and tier management */
+    challenges;
+    /** Bet validation and ingestion */
+    bets;
+    /** User progress, history, and withdrawals */
+    users;
+    /** Bet event reconciliation */
+    reconciliation;
+    /** Real-time event streaming (SSE) */
+    events;
+    /** Sandbox operations (staging only) */
+    sandbox;
+    /** Widget module and branding configuration */
+    widget;
+    /** Admin / backoffice operations (tenant management) */
+    admin;
+    constructor(config) {
+        if (!config.apiKey) {
+            throw new Error('FastClient: apiKey is required');
+        }
+        // A server key in a page is a server key published to every visitor.
+        const inBrowser = typeof globalThis.window !== 'undefined'
+            && typeof globalThis.document !== 'undefined';
+        if (inBrowser && !config.dangerouslyAllowBrowser && !config.apiKey.startsWith('pk_')) {
+            throw new Error('FastClient: refusing to run in a browser with a server API key. Call FAST from your backend, '
+                + 'and use the widget (public pk_ key + user token) in the browser. '
+                + 'Pass dangerouslyAllowBrowser: true only if you understand the key will be exposed.');
+        }
+        this.baseUrl = (config.baseUrl || DEFAULT_BASE_URL).replace(/\/$/, '');
+        this.apiKey = config.apiKey;
+        this.timeout = config.timeout ?? DEFAULT_TIMEOUT;
+        this.onRequest = config.onRequest;
+        this.onResponse = config.onResponse;
+        this._fetch = config.fetch ?? globalThis.fetch.bind(globalThis);
+        this.customHeaders = config.headers ?? {};
+        this.debug = config.debug ?? false;
+        if (config.retry === false) {
+            this.retryConfig = null;
+        }
+        else {
+            this.retryConfig = { ...DEFAULT_RETRY, ...(config.retry || {}) };
+        }
+        this.challenges = new ChallengesApi(this);
+        this.bets = new BetsApi(this);
+        this.users = new UsersApi(this);
+        this.reconciliation = new ReconciliationApi(this);
+        this.events = new EventsApi(this);
+        this.sandbox = new SandboxApi(this);
+        this.widget = new WidgetApi(this);
+        this.admin = new AdminApi(this);
+    }
+    /**
+     * Execute an authenticated request against the FAST API.
+     * Handles retries, timeouts, rate limits, and hooks automatically.
+     *
+     * @internal Use the namespaced APIs (challenges, bets, users, etc.) instead.
+     */
+    async request(method, path, options) {
+        let url = `${this.baseUrl}${path}`;
+        if (options?.query) {
+            const params = new URLSearchParams();
+            for (const [k, v] of Object.entries(options.query)) {
+                if (v !== undefined && v !== '')
+                    params.set(k, v);
+            }
+            const qs = params.toString();
+            if (qs)
+                url += `?${qs}`;
+        }
+        const headers = {
+            'X-API-Key': this.apiKey,
+            'User-Agent': USER_AGENT,
+            ...this.customHeaders,
+        };
+        if (options?.body) {
+            headers['Content-Type'] = 'application/json';
+        }
+        // Money-mutation endpoints (withdraw, refund-stake) REQUIRE X-Idempotency-Key.
+        // Auto-generate one per logical request when the caller does not supply one:
+        // the same key is reused across the retry loop below, so SDK retries are
+        // exactly-once on the server.
+        if (method === 'POST') {
+            headers['X-Idempotency-Key'] = options?.idempotencyKey || generateIdempotencyKey();
+        }
+        else if (options?.idempotencyKey) {
+            headers['X-Idempotency-Key'] = options.idempotencyKey;
+        }
+        const bodyStr = options?.body ? JSON.stringify(options.body) : undefined;
+        // Hook: onRequest
+        if (this.onRequest) {
+            // The hook is for logging and tracing; hand it the headers without the
+            // key, so a request logger does not write the server key to disk.
+            await this.onRequest({ method, url, headers: { ...headers, 'X-API-Key': redactKey(this.apiKey) }, body: bodyStr });
+        }
+        if (this.debug) {
+            console.log(`[fast-sdk] ${method} ${url}`);
+        }
+        const maxAttempts = this.retryConfig ? this.retryConfig.maxRetries + 1 : 1;
+        let lastError = null;
+        for (let attempt = 1; attempt <= maxAttempts; attempt++) {
+            const start = Date.now();
+            try {
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), this.timeout);
+                const res = await this._fetch(url, {
+                    method,
+                    headers,
+                    body: bodyStr,
+                    signal: controller.signal,
+                });
+                clearTimeout(timer);
+                const durationMs = Date.now() - start;
+                if (res.ok) {
+                    const body = await res.json();
+                    if (this.onResponse) {
+                        const correlationId = (body && typeof body === 'object' && 'correlationId' in body)
+                            ? body.correlationId
+                            : undefined;
+                        await this.onResponse({
+                            status: res.status,
+                            headers: Object.fromEntries(res.headers.entries()),
+                            body,
+                            durationMs,
+                            correlationId,
+                        });
+                    }
+                    if (this.debug) {
+                        console.log(`[fast-sdk] ${method} ${url} -> ${res.status} (${durationMs}ms)`);
+                    }
+                    return body;
+                }
+                // Non-2xx response
+                const errBody = await res.json().catch(() => ({
+                    error: `http_${res.status}`,
+                    message: res.statusText,
+                    correlationId: '',
+                }));
+                // Rate limit: respect Retry-After header
+                const retryAfter = res.headers.get('Retry-After');
+                const rateLimitReset = retryAfter ? parseInt(retryAfter, 10) * 1000 : undefined;
+                const error = new FastApiError(res.status, errBody, rateLimitReset);
+                if (this.onResponse) {
+                    await this.onResponse({
+                        status: res.status,
+                        headers: Object.fromEntries(res.headers.entries()),
+                        body: errBody,
+                        durationMs,
+                        correlationId: errBody.correlationId,
+                    });
+                }
+                // Should we retry?
+                if (this.retryConfig && attempt < maxAttempts && this.retryConfig.retryableStatuses.includes(res.status)) {
+                    const delay = this.calculateDelay(attempt, rateLimitReset);
+                    if (this.debug) {
+                        console.log(`[fast-sdk] Retrying (${attempt}/${this.retryConfig.maxRetries}) after ${delay}ms...`);
+                    }
+                    await sleep(delay);
+                    lastError = error;
+                    continue;
+                }
+                throw error;
+            }
+            catch (err) {
+                if (err instanceof FastApiError)
+                    throw err;
+                if (err instanceof Error && err.name === 'AbortError') {
+                    const timeoutErr = new FastTimeoutError(this.timeout);
+                    if (this.retryConfig && attempt < maxAttempts) {
+                        const delay = this.calculateDelay(attempt);
+                        if (this.debug) {
+                            console.log(`[fast-sdk] Timeout, retrying (${attempt}/${this.retryConfig.maxRetries}) after ${delay}ms...`);
+                        }
+                        await sleep(delay);
+                        lastError = timeoutErr;
+                        continue;
+                    }
+                    throw timeoutErr;
+                }
+                // Network error
+                const netErr = new FastNetworkError(err instanceof Error ? err : new Error(String(err)));
+                if (this.retryConfig && attempt < maxAttempts) {
+                    const delay = this.calculateDelay(attempt);
+                    if (this.debug) {
+                        console.log(`[fast-sdk] Network error, retrying (${attempt}/${this.retryConfig.maxRetries}) after ${delay}ms...`);
+                    }
+                    await sleep(delay);
+                    lastError = netErr;
+                    continue;
+                }
+                throw netErr;
+            }
+        }
+        // Should not reach here, but just in case
+        throw lastError || new Error('Request failed after all retry attempts');
+    }
+    calculateDelay(attempt, rateLimitReset) {
+        if (rateLimitReset && rateLimitReset > 0) {
+            return Math.min(rateLimitReset, this.retryConfig.maxDelay);
+        }
+        // Exponential backoff with jitter
+        const base = this.retryConfig.initialDelay * Math.pow(2, attempt - 1);
+        const jitter = base * 0.2 * Math.random();
+        return Math.min(base + jitter, this.retryConfig.maxDelay);
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/esm/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../../src/client.ts"],"names":[],"mappings":"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"}

package/dist/esm/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * @fundedfast/sdk
+ *
+ * Official TypeScript SDK for the FAST platform.
+ * Zero dependencies. Works in Node.js 18+, Deno, Bun, and edge runtimes.
+ *
+ * @example
+ * ```typescript
+ * import { FastClient } from '@fundedfast/sdk';
+ *
+ * const fast = new FastClient({ apiKey: process.env.FAST_API_KEY! });
+ *
+ * // Validate a bet
+ * const result = await fast.bets.validate({
+ *   userId: 'player-42',
+ *   externalBetId: 'BET-001',
+ *   stakeAmount: 5.00,
+ *   odds: 2.10,
+ *   status: 'placed',
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { FastClient, FastApiError, FastTimeoutError, FastNetworkError } from './client.js';
+export type { FastClientConfig, FastError, RetryConfig, RequestHook, ResponseHook, ChallengeStatus, FailureReason, BetStatus, ValidationStatus, FundedAccountStatus, WebhookDeliveryStatus, RejectionCode, IntegrationMode, WebhookEventType, RewardType, RewardApplyMode, LeaderboardPeriod, PurchaseRequest, BetEvent, WithdrawRequest, Challenge, ChallengeTier, ChallengeTierFull, TierTerms, ValidationResult, BetIngestResult, BatchBetResult, Ruleset, UserProgress, ChallengeProgress, ChallengePassedProgress, FundedAccountProgress, NoProgress, WithdrawableInfo, WithdrawalResult, ReconciliationData, SseToken, WebhookPayload, Achievement, UserAchievements, Reward, UserRewards, RewardClaimResult, LeaderboardEntry, TimelineEvent, WithdrawalEventResult, SandboxResetResult, SandboxUserResetResult, AdminBetEvent, BetSettleRequest, BulkSettleRequest, BulkSettleResult, WebhookDelivery, AuditEntry, TenantSettings, AdminOverview, BonusOffer, BonusStats, MissionDef, TournamentDef, TournamentLeaderboardEntry, LoyaltyConfig, LoyaltyTier, LoyaltyStats, WebhookEchoEntry, AdapterMapping, ReconciliationFlag, RewardRule, SelfExclusionRecord, } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE3F,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,WAAW,EACX,WAAW,EACX,YAAY,EAGZ,eAAe,EACf,aAAa,EACb,SAAS,EACT,gBAAgB,EAChB,mBAAmB,EACnB,qBAAqB,EACrB,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,UAAU,EACV,eAAe,EACf,iBAAiB,EAGjB,eAAe,EACf,QAAQ,EACR,eAAe,EAGf,SAAS,EACT,aAAa,EACb,iBAAiB,EACjB,SAAS,EACT,gBAAgB,EAChB,eAAe,EACf,cAAc,EACd,OAAO,EACP,YAAY,EACZ,iBAAiB,EACjB,uBAAuB,EACvB,qBAAqB,EACrB,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,kBAAkB,EAClB,QAAQ,EACR,cAAc,EAGd,WAAW,EACX,gBAAgB,EAChB,MAAM,EACN,WAAW,EACX,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EAGtB,aAAa,EACb,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,eAAe,EACf,UAAU,EACV,cAAc,EACd,aAAa,EACb,UAAU,EACV,UAAU,EACV,UAAU,EACV,aAAa,EACb,0BAA0B,EAC1B,aAAa,EACb,WAAW,EACX,YAAY,EACZ,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,mBAAmB,GACpB,MAAM,YAAY,CAAC"}

package/dist/esm/index.js

@@ -0,0 +1,26 @@
+/**
+ * @fundedfast/sdk
+ *
+ * Official TypeScript SDK for the FAST platform.
+ * Zero dependencies. Works in Node.js 18+, Deno, Bun, and edge runtimes.
+ *
+ * @example
+ * ```typescript
+ * import { FastClient } from '@fundedfast/sdk';
+ *
+ * const fast = new FastClient({ apiKey: process.env.FAST_API_KEY! });
+ *
+ * // Validate a bet
+ * const result = await fast.bets.validate({
+ *   userId: 'player-42',
+ *   externalBetId: 'BET-001',
+ *   stakeAmount: 5.00,
+ *   odds: 2.10,
+ *   status: 'placed',
+ * });
+ * ```
+ *
+ * @packageDocumentation
+ */
+export { FastClient, FastApiError, FastTimeoutError, FastNetworkError } from './client.js';
+//# sourceMappingURL=index.js.map

package/dist/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}