@nhost/nhost-js 3.2.8 → 5.0.0-beta.2

package/dist/src/graphql/index.d.ts

@@ -0,0 +1,10 @@
+/**
+ * This is the main module to interact with Nhost's GraphQL service.
+ * Typically you would use this modula via the main [Nhost client](main#createclient)
+ * but you can also use it directly if you have a specific use case.
+ *
+ * @module graphql
+ * @packageDocumentation
+ */
+export * from "./client";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/graphql/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,UAAU,CAAC"}

package/dist/src/graphql/index.js

@@ -0,0 +1,10 @@
+/**
+ * This is the main module to interact with Nhost's GraphQL service.
+ * Typically you would use this modula via the main [Nhost client](main#createclient)
+ * but you can also use it directly if you have a specific use case.
+ *
+ * @module graphql
+ * @packageDocumentation
+ */
+export * from "./client";
+//# sourceMappingURL=index.js.map

package/dist/src/graphql/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/graphql/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,cAAc,UAAU,CAAC"}

package/dist/src/index.d.ts

@@ -0,0 +1,184 @@
+/**
+ * Main entry point for the Nhost JavaScript SDK.
+ *
+ * This package provides a unified client for interacting with Nhost services:
+ * - Authentication
+ * - Storage
+ * - GraphQL
+ * - Functions
+ *
+ * @example
+ * You can import and use this package with:
+ *
+ * ```ts
+ * import { createClient } from "@nhost/nhost-js";
+ * ```
+ *
+ * and use it like:
+ *
+ * {@includeCode ./__tests__/docstrings.test.ts#mainExample}
+ *
+ * ## Error handling
+ *
+ * The SDK will throw errors on most operations if the request returns a non-2xx status code or
+ * if the request fails entirely (i.e., due to network errors). A continuation you can see
+ * how you can handle errors thrown by the SDK.
+ *
+ * ### Auth
+ *
+ * {@includeCode ./__tests__/docstrings-auth.test.ts#errorHandling}
+ *
+ * ### Storage
+ *
+ * {@includeCode ./__tests__/docstrings-storage.test.ts#errorHandling}
+ *
+ * ### GraphQL
+ *
+ * {@includeCode ./__tests__/docstrings-graphql.test.ts#errorHandling}
+ *
+ * ### Functions
+ *
+ * {@includeCode ./__tests__/docstrings-functions.test.ts#errorHandling}
+ *
+ * @packageDocumentation
+ */
+import { type Client as AuthClient, type Session } from "./auth";
+import { type Client as StorageClient } from "./storage";
+import { type Client as GraphQLClient } from "./graphql";
+import { type Client as FunctionsClient } from "./functions";
+import { type SessionStorageInterface } from "./sessionStorage";
+export { type SessionStorageInterface, DEFAULT_SESSION_KEY, LocalStorage, MemoryStorage, CookieStorage, } from "./sessionStorage";
+export { type SessionRefreshOptions, createSessionRefreshMiddleware, } from "./middlewareRefreshSession";
+export { createAttachAccessTokenMiddleware } from "./middlewareAttachToken";
+export { createSessionResponseMiddleware } from "./middlewareResponseSession";
+/**
+ * Generates a base URL for a Nhost service based on configuration
+ *
+ * @param serviceType - Type of service (auth, storage, graphql, functions)
+ * @param subdomain - Nhost project subdomain
+ * @param region - Nhost region
+ * @param customUrl - Custom URL override if provided
+ * @returns The base URL for the service
+ *
+ * @internal
+ */
+export declare const generateServiceUrl: (serviceType: "auth" | "storage" | "graphql" | "functions", subdomain?: string, region?: string, customUrl?: string) => string;
+/**
+ * Configuration options for creating an Nhost client
+ */
+export interface NhostClientOptions {
+    /**
+     * Nhost project subdomain (e.g., 'abcdefgh'). Used to construct the base URL for services for the Nhost cloud.
+     */
+    subdomain?: string;
+    /**
+     * Nhost region (e.g., 'eu-central-1'). Used to construct the base URL for services for the Nhost cloud.
+     */
+    region?: string;
+    /**
+     * Complete base URL for the auth service (overrides subdomain/region)
+     */
+    authUrl?: string;
+    /**
+     * Complete base URL for the storage service (overrides subdomain/region)
+     */
+    storageUrl?: string;
+    /**
+     * Complete base URL for the GraphQL service (overrides subdomain/region)
+     */
+    graphqlUrl?: string;
+    /**
+     * Complete base URL for the functions service (overrides subdomain/region)
+     */
+    functionsUrl?: string;
+    /**
+     * Storage implementation to use for session persistence. If not provided, the SDK will
+     * default to localStorage in the browser or memory in other environments.
+     */
+    storage?: SessionStorageInterface;
+    /**
+     * Disable automatic session refresh. If set to true, the SDK will not attempt to refresh
+     */
+    disableAutoRefreshToken?: boolean;
+}
+/**
+ * Main client class that provides access to all Nhost services
+ */
+export declare class NhostClient {
+    /**
+     * Authentication client providing methods for user sign-in, sign-up, and session management
+     */
+    auth: AuthClient;
+    /**
+     * Storage client providing methods for file operations (upload, download, delete)
+     */
+    storage: StorageClient;
+    /**
+     * GraphQL client providing methods for executing GraphQL operations against your Hasura backend
+     */
+    graphql: GraphQLClient;
+    /**
+     * Functions client providing methods for invoking serverless functions
+     */
+    functions: FunctionsClient;
+    /**
+     * Storage implementation used for persisting session information
+     */
+    sessionStorage: SessionStorageInterface;
+    /**
+     * Create a new Nhost client. This constructor is reserved for advanced use cases.
+     * For typical usage, use [createClient](#createclient) instead.
+     *
+     * @param auth - Authentication client
+     * @param storage - Storage client
+     * @param graphql - GraphQL client
+     * @param functions - Functions client
+     * @param sessionStorage - Storage implementation for session persistence
+     */
+    constructor(auth: AuthClient, storage: StorageClient, graphql: GraphQLClient, functions: FunctionsClient, sessionStorage: SessionStorageInterface);
+    /**
+     * Get the current session from storage
+     *
+     * @returns The current session or null if no session exists
+     *
+     * @example
+     * ```ts
+     * const session = nhost.getUserSession();
+     * if (session) {
+     *   console.log('User is authenticated:', session.user.id);
+     * } else {
+     *   console.log('No active session');
+     * }
+     * ```
+     */
+    getUserSession(): Session | null;
+    /**
+     * Refresh the session using the current refresh token
+     * in the storage and update the storage with the new session.
+     * @param marginSeconds - The number of seconds before the token expiration to refresh the session. If the token is still valid for this duration, it will not be refreshed. Set to 0 to force the refresh.
+     *
+     * @returns The new session or null if there is currently no session or if refresh fails
+     */
+    refreshSession(marginSeconds?: number): Promise<Session | null>;
+    private _refreshSession;
+    /**
+     * Clear the session from storage
+     */
+    clearSession(): Promise<void>;
+}
+/**
+ * Creates and configures a new Nhost client instance.
+ *
+ * This helper method instantiates a fully configured Nhost client by:
+ * - Instantiating the various service clients (auth, storage, functions and graphql)
+ * - Configuring a session storage if none is provided
+ * - Setting up the necessary middleware for automatic session management:
+ *   - Automatically attaching the authorization token to requests
+ *   - Refreshing the session when it expires
+ *   - Applying session tokens to function calls
+ *
+ * @param options - Configuration options for the client
+ * @returns A configured Nhost client
+ */
+export declare function createClient(options?: NhostClientOptions): NhostClient;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2CG;AAEH,OAAO,EAEL,KAAK,MAAM,IAAI,UAAU,EACzB,KAAK,OAAO,EAGb,MAAM,QAAQ,CAAC;AAChB,OAAO,EACL,KAAK,MAAM,IAAI,aAAa,EAE7B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,MAAM,IAAI,aAAa,EAE7B,MAAM,WAAW,CAAC;AACnB,OAAO,EACL,KAAK,MAAM,IAAI,eAAe,EAE/B,MAAM,aAAa,CAAC;AAErB,OAAO,EAAE,KAAK,uBAAuB,EAAiB,MAAM,kBAAkB,CAAC;AAQ/E,OAAO,EACL,KAAK,uBAAuB,EAC5B,mBAAmB,EACnB,YAAY,EACZ,aAAa,EACb,aAAa,GACd,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACL,KAAK,qBAAqB,EAC1B,8BAA8B,GAC/B,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,iCAAiC,EAAE,MAAM,yBAAyB,CAAC;AAC5E,OAAO,EAAE,+BAA+B,EAAE,MAAM,6BAA6B,CAAC;AAE9E;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,GAC7B,aAAa,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,WAAW,EACzD,YAAY,MAAM,EAClB,SAAS,MAAM,EACf,YAAY,MAAM,KACjB,MAUF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,YAAY,CAAC,EAAE,MAAM,CAAC;IAEtB;;;OAGG;IACH,OAAO,CAAC,EAAE,uBAAuB,CAAC;IAElC;;OAEG;IACH,uBAAuB,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,IAAI,EAAE,UAAU,CAAC;IAEjB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;OAEG;IACH,OAAO,EAAE,aAAa,CAAC;IAEvB;;OAEG;IACH,SAAS,EAAE,eAAe,CAAC;IAE3B;;OAEG;IACH,cAAc,EAAE,uBAAuB,CAAC;IAExC;;;;;;;;;OASG;gBAED,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,aAAa,EACtB,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,eAAe,EAC1B,cAAc,EAAE,uBAAuB;IASzC;;;;;;;;;;;;;;OAcG;IACH,cAAc,IAAI,OAAO,GAAG,IAAI;IAIhC;;;;;;OAMG;IACG,cAAc,CAAC,aAAa,GAAE,MAAW,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;YAqB3D,eAAe;IAkC7B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,IAAI,CAAC;CAGpC;AAmBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CAwD1E"}

package/dist/src/index.js

@@ -0,0 +1,251 @@
+/**
+ * Main entry point for the Nhost JavaScript SDK.
+ *
+ * This package provides a unified client for interacting with Nhost services:
+ * - Authentication
+ * - Storage
+ * - GraphQL
+ * - Functions
+ *
+ * @example
+ * You can import and use this package with:
+ *
+ * ```ts
+ * import { createClient } from "@nhost/nhost-js";
+ * ```
+ *
+ * and use it like:
+ *
+ * {@includeCode ./__tests__/docstrings.test.ts#mainExample}
+ *
+ * ## Error handling
+ *
+ * The SDK will throw errors on most operations if the request returns a non-2xx status code or
+ * if the request fails entirely (i.e., due to network errors). A continuation you can see
+ * how you can handle errors thrown by the SDK.
+ *
+ * ### Auth
+ *
+ * {@includeCode ./__tests__/docstrings-auth.test.ts#errorHandling}
+ *
+ * ### Storage
+ *
+ * {@includeCode ./__tests__/docstrings-storage.test.ts#errorHandling}
+ *
+ * ### GraphQL
+ *
+ * {@includeCode ./__tests__/docstrings-graphql.test.ts#errorHandling}
+ *
+ * ### Functions
+ *
+ * {@includeCode ./__tests__/docstrings-functions.test.ts#errorHandling}
+ *
+ * @packageDocumentation
+ */
+import { createAPIClient as createAuthClient, } from "./auth";
+import { createAPIClient as createStorageClient, } from "./storage";
+import { createAPIClient as createGraphQLClient, } from "./graphql";
+import { createAPIClient as createFunctionsClient, } from "./functions";
+import { detectStorage } from "./sessionStorage";
+import { extractTokenExpiration, createSessionRefreshMiddleware, } from "./middlewareRefreshSession";
+import { createAttachAccessTokenMiddleware } from "./middlewareAttachToken";
+import { createSessionResponseMiddleware } from "./middlewareResponseSession";
+export { DEFAULT_SESSION_KEY, LocalStorage, MemoryStorage, CookieStorage, } from "./sessionStorage";
+export { createSessionRefreshMiddleware, } from "./middlewareRefreshSession";
+export { createAttachAccessTokenMiddleware } from "./middlewareAttachToken";
+export { createSessionResponseMiddleware } from "./middlewareResponseSession";
+/**
+ * Generates a base URL for a Nhost service based on configuration
+ *
+ * @param serviceType - Type of service (auth, storage, graphql, functions)
+ * @param subdomain - Nhost project subdomain
+ * @param region - Nhost region
+ * @param customUrl - Custom URL override if provided
+ * @returns The base URL for the service
+ *
+ * @internal
+ */
+export const generateServiceUrl = (serviceType, subdomain, region, customUrl) => {
+    if (customUrl) {
+        return customUrl;
+    }
+    else if (subdomain && region) {
+        return `https://${subdomain}.${serviceType}.${region}.nhost.run/v1`;
+    }
+    else if (subdomain) {
+        return `https://${subdomain}.${serviceType}.nhost.run/v1`;
+    }
+    else {
+        return `https://local.${serviceType}.local.nhost.run/v1`;
+    }
+};
+/**
+ * Main client class that provides access to all Nhost services
+ */
+export class NhostClient {
+    /**
+     * Authentication client providing methods for user sign-in, sign-up, and session management
+     */
+    auth;
+    /**
+     * Storage client providing methods for file operations (upload, download, delete)
+     */
+    storage;
+    /**
+     * GraphQL client providing methods for executing GraphQL operations against your Hasura backend
+     */
+    graphql;
+    /**
+     * Functions client providing methods for invoking serverless functions
+     */
+    functions;
+    /**
+     * Storage implementation used for persisting session information
+     */
+    sessionStorage;
+    /**
+     * Create a new Nhost client. This constructor is reserved for advanced use cases.
+     * For typical usage, use [createClient](#createclient) instead.
+     *
+     * @param auth - Authentication client
+     * @param storage - Storage client
+     * @param graphql - GraphQL client
+     * @param functions - Functions client
+     * @param sessionStorage - Storage implementation for session persistence
+     */
+    constructor(auth, storage, graphql, functions, sessionStorage) {
+        this.auth = auth;
+        this.storage = storage;
+        this.graphql = graphql;
+        this.functions = functions;
+        this.sessionStorage = sessionStorage;
+    }
+    /**
+     * Get the current session from storage
+     *
+     * @returns The current session or null if no session exists
+     *
+     * @example
+     * ```ts
+     * const session = nhost.getUserSession();
+     * if (session) {
+     *   console.log('User is authenticated:', session.user.id);
+     * } else {
+     *   console.log('No active session');
+     * }
+     * ```
+     */
+    getUserSession() {
+        return this.sessionStorage.get();
+    }
+    /**
+     * Refresh the session using the current refresh token
+     * in the storage and update the storage with the new session.
+     * @param marginSeconds - The number of seconds before the token expiration to refresh the session. If the token is still valid for this duration, it will not be refreshed. Set to 0 to force the refresh.
+     *
+     * @returns The new session or null if there is currently no session or if refresh fails
+     */
+    async refreshSession(marginSeconds = 60) {
+        try {
+            return await this._refreshSession(marginSeconds);
+        }
+        catch (error) {
+            try {
+                // we retry the refresh token in case of transient error
+                // or race conditions
+                console.warn("error refreshing session, retrying:", error);
+                return await this._refreshSession(marginSeconds);
+            }
+            catch (error) {
+                const errResponse = error;
+                if (errResponse?.status === 401) {
+                    // this probably means the refresh token is invalid
+                    console.error("session probably expired");
+                    this.sessionStorage.remove();
+                }
+                return null;
+            }
+        }
+    }
+    async _refreshSession(marginSeconds = 60) {
+        const session = this.sessionStorage.get();
+        if (!session) {
+            return null;
+        }
+        const tokenExpiresAt = extractTokenExpiration(session?.accessToken || "");
+        const currentTime = Date.now();
+        const sessionExpired = tokenExpiresAt < currentTime;
+        if (tokenExpiresAt - currentTime > marginSeconds * 1000) {
+            return session; // No need to refresh
+        }
+        try {
+            const response = await this.auth.refreshToken({
+                refreshToken: session.refreshToken,
+            });
+            this.sessionStorage.set(response.body);
+            return response.body;
+        }
+        catch (error) {
+            if (!sessionExpired) {
+                // If the session is not expired, we can still use the current session
+                // so there is no need to error for now
+                return session;
+            }
+            // we throw the error so the caller can handle it
+            throw error;
+        }
+    }
+    /**
+     * Clear the session from storage
+     */
+    async clearSession() {
+        this.sessionStorage.remove();
+    }
+}
+function getMiddlewareChain(auth, storage, autoRefresh) {
+    const mwChain = [
+        createSessionResponseMiddleware(storage),
+        createAttachAccessTokenMiddleware(storage),
+    ];
+    if (autoRefresh) {
+        // we need to process this one first to make sure any following middlewares
+        // run after the session has been refreshed
+        mwChain.unshift(createSessionRefreshMiddleware(auth, storage));
+    }
+    return mwChain;
+}
+/**
+ * Creates and configures a new Nhost client instance.
+ *
+ * This helper method instantiates a fully configured Nhost client by:
+ * - Instantiating the various service clients (auth, storage, functions and graphql)
+ * - Configuring a session storage if none is provided
+ * - Setting up the necessary middleware for automatic session management:
+ *   - Automatically attaching the authorization token to requests
+ *   - Refreshing the session when it expires
+ *   - Applying session tokens to function calls
+ *
+ * @param options - Configuration options for the client
+ * @returns A configured Nhost client
+ */
+export function createClient(options = {}) {
+    const { subdomain, region, authUrl, storageUrl, graphqlUrl, functionsUrl, storage = detectStorage(), disableAutoRefreshToken = false, } = options;
+    // Determine base URLs for each service
+    const authBaseUrl = generateServiceUrl("auth", subdomain, region, authUrl);
+    const storageBaseUrl = generateServiceUrl("storage", subdomain, region, storageUrl);
+    const graphqlBaseUrl = generateServiceUrl("graphql", subdomain, region, graphqlUrl);
+    const functionsBaseUrl = generateServiceUrl("functions", subdomain, region, functionsUrl);
+    // Create auth client
+    const auth = createAuthClient(authBaseUrl);
+    const mwChain = getMiddlewareChain(auth, storage, !disableAutoRefreshToken);
+    for (const mw of mwChain) {
+        auth.pushChainFunction(mw);
+    }
+    // Create storage and graphql clients with the refresh and attach token middlewares
+    const storageClient = createStorageClient(storageBaseUrl, mwChain);
+    const graphqlClient = createGraphQLClient(graphqlBaseUrl, mwChain);
+    const functionsClient = createFunctionsClient(functionsBaseUrl, mwChain);
+    // Return an initialized NhostClient
+    return new NhostClient(auth, storageClient, graphqlClient, functionsClient, storage);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

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

package/dist/src/middlewareAttachToken.d.ts

@@ -0,0 +1,24 @@
+/**
+ * @fileoverview Authorization token attachment middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically attach
+ * authorization tokens to outgoing API requests, ensuring the client
+ * is properly authenticated.
+ */
+import { type SessionStorageInterface } from "./sessionStorage";
+import { type ChainFunction } from "./fetch";
+/**
+ * Creates a fetch middleware that adds the Authorization header with the current access token.
+ *
+ * This middleware:
+ * 1. Gets the current session from storage
+ * 2. Adds the authorization header with the access token to outgoing requests
+ *
+ * This middleware should be used after the refresh middleware in the chain to
+ * ensure the most recent token is used.
+ *
+ * @param storage - Storage implementation for retrieving session data
+ * @returns A middleware function that adds Authorization headers
+ */
+export declare const createAttachAccessTokenMiddleware: (storage: SessionStorageInterface) => ChainFunction;
+//# sourceMappingURL=middlewareAttachToken.d.ts.map

package/dist/src/middlewareAttachToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareAttachToken.d.ts","sourceRoot":"","sources":["../../src/middlewareAttachToken.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,iCAAiC,GAC5C,SAAS,uBAAuB,KAC/B,aA+BF,CAAC"}

package/dist/src/middlewareAttachToken.js

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview Authorization token attachment middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically attach
+ * authorization tokens to outgoing API requests, ensuring the client
+ * is properly authenticated.
+ */
+import {} from "./sessionStorage";
+import {} from "./fetch";
+/**
+ * Creates a fetch middleware that adds the Authorization header with the current access token.
+ *
+ * This middleware:
+ * 1. Gets the current session from storage
+ * 2. Adds the authorization header with the access token to outgoing requests
+ *
+ * This middleware should be used after the refresh middleware in the chain to
+ * ensure the most recent token is used.
+ *
+ * @param storage - Storage implementation for retrieving session data
+ * @returns A middleware function that adds Authorization headers
+ */
+export const createAttachAccessTokenMiddleware = (storage) => {
+    return (next) => {
+        return async (url, options = {}) => {
+            const headers = new Headers(options.headers || {});
+            // Skip if Authorization header is already set
+            if (headers.has("Authorization")) {
+                return next(url, options);
+            }
+            // Get current session from storage
+            const session = storage.get();
+            if (session?.accessToken) {
+                // Add authorization header
+                const newOptions = {
+                    ...options,
+                    headers: addAuthorizationHeader(headers, session),
+                };
+                // Continue with the fetch chain
+                return next(url, newOptions);
+            }
+            // No session or no access token, continue without authorization
+            return next(url, options);
+        };
+    };
+};
+/**
+ * Adds the Authorization header with the access token to the request headers
+ *
+ * @param headers - Original request headers
+ * @param session - Current session containing the access token
+ * @returns Modified headers with Authorization header
+ */
+function addAuthorizationHeader(headers, session) {
+    if (session.accessToken) {
+        headers.set("Authorization", `Bearer ${session.accessToken}`);
+    }
+    return headers;
+}
+//# sourceMappingURL=middlewareAttachToken.js.map

package/dist/src/middlewareAttachToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareAttachToken.js","sourceRoot":"","sources":["../../src/middlewareAttachToken.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAgC,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAA0C,MAAM,SAAS,CAAC;AAEjE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,iCAAiC,GAAG,CAC/C,OAAgC,EACjB,EAAE;IACjB,OAAO,CAAC,IAAmB,EAAiB,EAAE;QAC5C,OAAO,KAAK,EACV,GAAW,EACX,UAAuB,EAAE,EACN,EAAE;YACrB,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,OAAO,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAEnD,8CAA8C;YAC9C,IAAI,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,EAAE,CAAC;gBACjC,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;YAC5B,CAAC;YAED,mCAAmC;YACnC,MAAM,OAAO,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC;YAE9B,IAAI,OAAO,EAAE,WAAW,EAAE,CAAC;gBACzB,2BAA2B;gBAC3B,MAAM,UAAU,GAAG;oBACjB,GAAG,OAAO;oBACV,OAAO,EAAE,sBAAsB,CAAC,OAAO,EAAE,OAAO,CAAC;iBAClD,CAAC;gBAEF,gCAAgC;gBAChC,OAAO,IAAI,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;YAC/B,CAAC;YAED,gEAAgE;YAChE,OAAO,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAC5B,CAAC,CAAC;IACJ,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,SAAS,sBAAsB,CAAC,OAAgB,EAAE,OAAgB;IAChE,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC;QACxB,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,UAAU,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IAChE,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/src/middlewareRefreshSession.d.ts

@@ -0,0 +1,43 @@
+/**
+ * @fileoverview Auth token refresh middleware for the Nhost SDK.
+ *
+ * This module provides middleware functionality to automatically refresh
+ * authentication tokens before they expire, ensuring seamless API access
+ * without requiring manual token refresh by the application.
+ */
+import type { Client } from "./auth";
+import { type SessionStorageInterface } from "./sessionStorage";
+import { type ChainFunction } from "./fetch";
+/**
+ * Extracts the expiration time from a JWT token
+ * @param token - JWT token string
+ * @returns Expiration timestamp in milliseconds, or 0 if unable to extract
+ */
+export declare const extractTokenExpiration: (token: string) => number;
+/**
+ * Configuration options for the session refresh middleware
+ */
+export type SessionRefreshOptions = {
+    /**
+     * Number of seconds before token expiration when a refresh should be triggered.
+     * Default is 60 seconds (1 minute).
+     */
+    marginSeconds?: number;
+};
+/**
+ * Creates a fetch middleware that automatically refreshes authentication tokens.
+ *
+ * This middleware:
+ * 1. Checks if the current token is about to expire
+ * 2. If so, uses the refresh token to obtain a new access token
+ *
+ * The middleware handles token refresh transparently, so the application
+ * doesn't need to manually refresh tokens.
+ *
+ * @param authClient - Auth API client for token refresh operations
+ * @param storage - Storage implementation for persisting session data
+ * @param options - Configuration options for token refresh behavior
+ * @returns A middleware function that can be used in the fetch chain
+ */
+export declare const createSessionRefreshMiddleware: (authClient: Client, storage: SessionStorageInterface, options?: SessionRefreshOptions) => ChainFunction;
+//# sourceMappingURL=middlewareRefreshSession.d.ts.map

package/dist/src/middlewareRefreshSession.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middlewareRefreshSession.d.ts","sourceRoot":"","sources":["../../src/middlewareRefreshSession.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAW,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,KAAK,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAChE,OAAO,EAAE,KAAK,aAAa,EAAsB,MAAM,SAAS,CAAC;AAEjE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,OAAO,MAAM,KAAG,MAgCtD,CAAC;AAkCF;;GAEG;AACH,MAAM,MAAM,qBAAqB,GAAG;IAClC;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,8BAA8B,GACzC,YAAY,MAAM,EAClB,SAAS,uBAAuB,EAChC,UAAU,qBAAqB,KAC9B,aA4DF,CAAC"}