@base44/sdk/dist/modules/functions.js

JavaScript SDK for Base44 API

/**
 * Creates the functions module for the Base44 SDK.
 *
 * @param axios - Axios instance
 * @param appId - Application ID
 * @param config - Optional configuration for fetch functionality
 * @returns Functions module with methods to invoke custom backend functions
 * @internal
 */
export function createFunctionsModule(axios, appId, config) {
    const joinBaseUrl = (base, path) => {
        if (!base)
            return path;
        return `${String(base).replace(/\/$/, "")}${path}`;
    };
    const toHeaders = (inputHeaders) => {
        const headers = new Headers();
        // Get auth headers from the getter function if provided
        if (config === null || config === void 0 ? void 0 : config.getAuthHeaders) {
            const authHeaders = config.getAuthHeaders();
            Object.entries(authHeaders).forEach(([key, value]) => {
                if (value !== undefined && value !== null) {
                    headers.set(key, String(value));
                }
            });
        }
        if (inputHeaders) {
            new Headers(inputHeaders).forEach((value, key) => {
                headers.set(key, value);
            });
        }
        return headers;
    };
    return {
        // Invoke a custom backend function by name
        async invoke(functionName, data) {
            // Validate input
            if (typeof data === "string") {
                throw new Error(`Function ${functionName} must receive an object with named parameters, received: ${data}`);
            }
            let formData;
            let contentType;
            // Handle file uploads with FormData
            if (data instanceof FormData ||
                (data && Object.values(data).some((value) => value instanceof File))) {
                formData = new FormData();
                Object.keys(data).forEach((key) => {
                    if (data[key] instanceof File) {
                        formData.append(key, data[key], data[key].name);
                    }
                    else if (typeof data[key] === "object" && data[key] !== null) {
                        formData.append(key, JSON.stringify(data[key]));
                    }
                    else {
                        formData.append(key, data[key]);
                    }
                });
                contentType = "multipart/form-data";
            }
            else {
                formData = data;
                contentType = "application/json";
            }
            return axios.post(`/apps/${appId}/functions/${functionName}`, formData || data, { headers: { "Content-Type": contentType } });
        },
        // Fetch a backend function endpoint directly.
        async fetch(path, init = {}) {
            const normalizedPath = path.startsWith("/") ? path : `/${path}`;
            const primaryPath = `/functions${normalizedPath}`;
            const headers = toHeaders(init.headers);
            const requestInit = {
                ...init,
                headers,
            };
            const response = await fetch(joinBaseUrl(config === null || config === void 0 ? void 0 : config.baseURL, primaryPath), requestInit);
            return response;
        },
    };
}