\n\n## Requirements\n\n- **Node.js 20 or later** (Node.js 18 support dropped as of October 31, 2025)\n- For browser support, all modern browsers are supported\n\n> ⚠️ **Node.js 18 Deprecation Notice**\n>\n> Node.js 18 reached end-of-life on April 30, 2025. As announced in [our deprecation notice](https://github.com/orgs/supabase/discussions/37217), support for Node.js 18 was dropped on October 31, 2025.\n\n## Quick Start\n\n### Installation\n\n```bash\nnpm install @supabase/functions-js\n```\n\n### Usage\n\n```js\nimport { FunctionsClient } from '@supabase/functions-js'\n\nconst functionsUrl = 'https://.supabase.co/functions/v1'\nconst anonKey = ''\n\nconst functions = new FunctionsClient(functionsUrl, {\n headers: {\n Authorization: `Bearer ${anonKey}`,\n },\n})\n\n// Invoke a function\nconst { data, error } = await functions.invoke('hello-world', {\n body: { name: 'Functions' },\n})\n```\n\n## Development\n\nThis package is part of the [Supabase JavaScript monorepo](https://github.com/supabase/supabase-js). To work on this package:\n\n### Building\n\n```bash\n# Complete build (from monorepo root)\nnpx nx build functions-js\n\n# Build with watch mode for development\nnpx nx build functions-js --watch\n\n# Individual build targets\nnpx nx build:main functions-js # CommonJS build (dist/main/)\nnpx nx build:module functions-js # ES Modules build (dist/module/)\n\n# Other useful commands\nnpx nx clean functions-js # Clean build artifacts\nnpx nx typecheck functions-js # TypeScript type checking\nnpx nx docs functions-js # Generate documentation\n```\n\n#### Build Outputs\n\n- **CommonJS (`dist/main/`)** - For Node.js environments\n- **ES Modules (`dist/module/`)** - For modern bundlers (Webpack, Vite, Rollup)\n- **TypeScript definitions (`dist/module/index.d.ts`)** - Type definitions for TypeScript projects\n\n### Testing\n\n**Docker Required** for relay tests. The functions-js tests use testcontainers to spin up a Deno relay server for testing Edge Function invocations.\n\n```bash\n# Run all tests (from monorepo root)\nnpx nx test functions-js\n\n# Run tests with coverage report\nnpx nx test functions-js --coverage\n\n# Run tests in watch mode during development\nnpx nx test functions-js --watch\n\n# CI test command (runs with coverage)\nnpx nx test:ci functions-js\n```\n\n#### Test Requirements\n\n- **Node.js 20+** - Required for testcontainers\n- **Docker** - Must be installed and running for relay tests\n- No Supabase instance needed - Tests use mocked services and testcontainers\n\n#### What Gets Tested\n\n- **Function invocation** - Testing the `invoke()` method with various options\n- **Relay functionality** - Using a containerized Deno relay to test real Edge Function scenarios\n- **Error handling** - Ensuring proper error responses and retries\n- **Request/response models** - Validating headers, body, and response formats\n\n### Contributing\n\nWe welcome contributions! Please see our [Contributing Guide](../../../CONTRIBUTING.md) for details on how to get started.\n\nFor major changes or if you're unsure about something, please open an issue first to discuss your proposed changes.","users":{}}
![\"Supabase](\"https://raw.githubusercontent.com/supabase/supabase/master/packages/common/assets/images/logo-preview.jpg\"){kind=logo}
\n