squarefi-bff-api-module 1.36.16 → 1.36.18

package/dist/api/types/autogen/apiV1External.types.d.ts

@@ -43,7 +43,7 @@ export interface paths {
                                     id?: string;
                                     name?: string;
                                     /** @enum {string} */
-                                    role?: "READ_ONLY" | "DEVELOPER" | "PRODUCTION" | "TENANT_ADMIN" | "OWNER";
+                                    role?: "READ_ONLY" | "DEVELOPER" | "PRODUCTION" | "OWNER";
                                     is_enabled?: boolean;
                                     /** Format: date-time */
                                     created_at?: string;
@@ -111,7 +111,7 @@ export interface paths {
                                     id?: string;
                                     name?: string;
                                     /** @enum {string} */
-                                    role?: "READ_ONLY" | "DEVELOPER" | "PRODUCTION" | "TENANT_ADMIN" | "OWNER";
+                                    role?: "READ_ONLY" | "DEVELOPER" | "PRODUCTION" | "OWNER";
                                     /** Format: uuid */
                                     wallet_id?: string;
                                     /** Format: uuid */
@@ -7774,7 +7774,7 @@ export interface components {
              * @description Permission level of the API key
              * @enum {string}
              */
-            role?: "READ_ONLY" | "DEVELOPER" | "PRODUCTION" | "TENANT_ADMIN" | "OWNER";
+            role?: "READ_ONLY" | "DEVELOPER" | "PRODUCTION" | "OWNER";
             /**
              * Format: uuid
              * @description Associated wallet ID

package/dist/api/types/autogen/apiV2.types.d.ts

@@ -2297,6 +2297,10 @@ export interface components {
             readonly support_text?: string | null;
             readonly support_phone?: string | null;
         };
+        SupportedLocalesEntity: {
+            default: string;
+            supported: string[];
+        };
         SystemConfigDto: {
             /** @enum {string} */
             default_theme_mode: "dark" | "light";
@@ -2316,6 +2320,7 @@ export interface components {
             readonly statement_branding?: components["schemas"]["StatementBrandingEntity"] | null;
             /** @enum {string} */
             kyc_data_provider: "persona" | "sumsub";
+            readonly supported_locales?: components["schemas"]["SupportedLocalesEntity"] | null;
             base_currency: string;
         };
         SystemChainsResponseDto: {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { squarefi_bff_api_client } from './api';
 export * from './utils/apiClientFactory';
+export { setAccessTokenProvider, setOnUnauthorized, type AccessTokenProvider, type ResolveTokenOptions, type UnauthorizedHandler, } from './utils/accessTokenProvider';
 export * from './utils/tokensFactory';
 export * from './utils/fileStorage';
 export * from './constants';

package/dist/index.js

@@ -1,5 +1,6 @@
 export { squarefi_bff_api_client } from './api';
 export * from './utils/apiClientFactory';
+export { setAccessTokenProvider, setOnUnauthorized, } from './utils/accessTokenProvider';
 export * from './utils/tokensFactory';
 export * from './utils/fileStorage';
 export * from './constants';

package/dist/utils/accessTokenProvider.d.ts

@@ -0,0 +1,22 @@
+export type ResolveTokenOptions = {
+    /** Force the provider to mint a fresh token, bypassing any cache (used on 401 retry). */
+    forceRefresh?: boolean;
+};
+export type AccessTokenProvider = (options?: ResolveTokenOptions) => Promise<string | null | undefined>;
+export type UnauthorizedHandler = () => void;
+/**
+ * Register an external source of the access token (e.g. Clerk `getToken`).
+ * When set, the API clients stop reading tokens from localStorage and delegate
+ * token acquisition (and refresh) to the provider. Pass `null` to fall back to
+ * the legacy localStorage flow.
+ */
+export declare const setAccessTokenProvider: (provider: AccessTokenProvider | null) => void;
+/**
+ * Register a callback invoked when a request is unauthorized and cannot be
+ * recovered by refreshing the token (e.g. to trigger a Clerk sign-out).
+ */
+export declare const setOnUnauthorized: (handler: UnauthorizedHandler | null) => void;
+/** Whether an external token provider is active (Clerk mode). */
+export declare const isExternalAuthMode: () => boolean;
+export declare const resolveAccessToken: (options?: ResolveTokenOptions) => Promise<string | null>;
+export declare const triggerUnauthorized: () => void;

package/dist/utils/accessTokenProvider.js

@@ -0,0 +1,50 @@
+import { getFromLocalStorage } from './storage';
+let accessTokenProvider = null;
+let unauthorizedHandler = null;
+let inFlightRefresh = null;
+/**
+ * Register an external source of the access token (e.g. Clerk `getToken`).
+ * When set, the API clients stop reading tokens from localStorage and delegate
+ * token acquisition (and refresh) to the provider. Pass `null` to fall back to
+ * the legacy localStorage flow.
+ */
+export const setAccessTokenProvider = (provider) => {
+    accessTokenProvider = provider;
+};
+/**
+ * Register a callback invoked when a request is unauthorized and cannot be
+ * recovered by refreshing the token (e.g. to trigger a Clerk sign-out).
+ */
+export const setOnUnauthorized = (handler) => {
+    unauthorizedHandler = handler;
+};
+/** Whether an external token provider is active (Clerk mode). */
+export const isExternalAuthMode = () => accessTokenProvider !== null;
+export const resolveAccessToken = async (options) => {
+    if (accessTokenProvider) {
+        // Coalesce concurrent force-refreshes so a burst of 401s triggers a single provider refresh.
+        if (options?.forceRefresh) {
+            if (!inFlightRefresh) {
+                const provider = accessTokenProvider;
+                inFlightRefresh = Promise.resolve()
+                    .then(() => provider(options))
+                    .then((token) => token ?? null)
+                    .catch(() => null)
+                    .finally(() => {
+                    inFlightRefresh = null;
+                });
+            }
+            return inFlightRefresh;
+        }
+        try {
+            return (await accessTokenProvider(options)) ?? null;
+        }
+        catch {
+            return null;
+        }
+    }
+    return getFromLocalStorage('access_token');
+};
+export const triggerUnauthorized = () => {
+    unauthorizedHandler?.();
+};

package/dist/utils/apiClientFactory.js

@@ -3,6 +3,7 @@ import { isTMA } from '@telegram-apps/sdk-react';
 import axios from 'axios';
 import { telegramSignUpPath, telegramSignInPath, refreshTokenPath } from '../api/auth';
 import { AppEnviroment, ResponseStatus } from '../constants';
+import { isExternalAuthMode, resolveAccessToken, triggerUnauthorized } from './accessTokenProvider';
 import { deleteTokens, getTokens, refreshTokens } from './tokensFactory';
 // eslint-disable-next-line no-constant-condition
 const apiV1BaseURL = process.env.API_URL ?? 'ENV variable API_URL is not defined';
@@ -17,8 +18,8 @@ export const createApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         baseURL,
         timeout: 60000,
     });
-    instance.interceptors.request.use((config) => {
-        const { access_token } = getTokens();
+    instance.interceptors.request.use(async (config) => {
+        const access_token = await resolveAccessToken();
         const modifiedHeaders = {
             ...config.headers,
             'x-tenant-id': tenantId,
@@ -43,8 +44,27 @@ export const createApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         if (error?.response?.status === ResponseStatus.UNAUTHORIZED &&
             !error?.response?.config.context?.bypassUnauthorizedHandler) {
             const { response, config: failedRequestConfig } = error;
-            const { refresh_token } = getTokens();
             const isRetryRequest = failedRequestConfig.context?.isRetryRequest;
+            // External auth mode (e.g. Clerk): the provider owns token refresh. Force a fresh token and
+            // retry once; sign out if there is no fresh token or the retry still fails.
+            if (isExternalAuthMode()) {
+                if (isRetryRequest) {
+                    triggerUnauthorized();
+                    return Promise.reject(error);
+                }
+                return resolveAccessToken({ forceRefresh: true }).then((freshToken) => {
+                    if (!freshToken) {
+                        triggerUnauthorized();
+                        return Promise.reject(error);
+                    }
+                    failedRequestConfig.context = {
+                        ...failedRequestConfig.context,
+                        isRetryRequest: true,
+                    };
+                    return instance(failedRequestConfig);
+                });
+            }
+            const { refresh_token } = getTokens();
             const isRefreshTokenRequest = failedRequestConfig.url?.includes(refreshTokenPath);
             const isTelegramSignInRequest = failedRequestConfig.url?.includes(telegramSignInPath);
             const isTelegramSignUpRequest = failedRequestConfig.url?.includes(telegramSignUpPath);
@@ -144,8 +164,8 @@ export const createFetchApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         });
         return `${fullUrl}?${searchParams.toString()}`;
     };
-    const getHeaders = (additionalHeaders) => {
-        const { access_token } = getTokens();
+    const getHeaders = async (additionalHeaders) => {
+        const access_token = await resolveAccessToken();
         const headers = {
             'Content-Type': 'application/json',
             'x-tenant-id': tenantId,
@@ -186,7 +206,7 @@ export const createFetchApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         const fullUrl = buildUrl(url, config?.params);
         const response = await fetch(fullUrl, {
             method: 'GET',
-            headers: getHeaders(config?.headers),
+            headers: await getHeaders(config?.headers),
         });
         return handleResponse(response, config?.responseType);
     };
@@ -194,7 +214,7 @@ export const createFetchApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         const fullUrl = buildUrl(url);
         const response = await fetch(fullUrl, {
             method: 'POST',
-            headers: getHeaders(config?.headers),
+            headers: await getHeaders(config?.headers),
             body: config?.data ? JSON.stringify(config.data) : undefined,
         });
         return handleResponse(response, config?.responseType);
@@ -203,7 +223,7 @@ export const createFetchApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         const fullUrl = buildUrl(url);
         const response = await fetch(fullUrl, {
             method: 'PATCH',
-            headers: getHeaders(config?.headers),
+            headers: await getHeaders(config?.headers),
             body: config?.data ? JSON.stringify(config.data) : undefined,
         });
         return handleResponse(response, config?.responseType);
@@ -212,7 +232,7 @@ export const createFetchApiClient = ({ baseURL, isBearerToken, tenantId }) => {
         const fullUrl = buildUrl(url);
         const response = await fetch(fullUrl, {
             method: 'DELETE',
-            headers: getHeaders(config?.headers),
+            headers: await getHeaders(config?.headers),
             body: config?.data ? JSON.stringify(config.data) : undefined,
         });
         return handleResponse(response, config?.responseType);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "squarefi-bff-api-module",
-  "version": "1.36.16",
+  "version": "1.36.18",
   "description": "Squarefi BFF API client module",
   "type": "module",
   "main": "./dist/index.js",