@multitenantkit/adapter-transport-supabase-edge

Supabase Edge Functions transport adapter for MultiTenantKit HTTP API.

This adapter enables running MultiTenantKit API endpoints as a single Supabase Edge Function with internal routing (the "fat function" pattern).

Features

• Single Edge Function: All endpoints run in one function, minimizing cold starts
• Native Deno: Uses Deno.serve() directly without additional frameworks
• Full Compatibility: Works with all @multitenantkit/api-handlers HandlerPackages
• Built-in CORS: Configurable CORS handling for browser clients
• Authentication: Integrates with @multitenantkit/adapter-auth-supabase for JWT validation
• Request Validation: Zod-based validation for body, params, and query

Installation

npm install @multitenantkit/adapter-transport-supabase-edge

Usage

Basic Setup

// supabase/functions/multitenantkit/index.ts

import { buildEdgeFunction } from '@multitenantkit/adapter-transport-supabase-edge';
import { buildHandlers } from '@multitenantkit/api-handlers';
import { createUseCases } from '@multitenantkit/composition';
import { SupabaseAuthService } from '@multitenantkit/adapter-auth-supabase';

// Initialize your adapters and use cases
const useCases = createUseCases(adapters);
const handlers = buildHandlers(useCases);

// Create auth service
const authService = new SupabaseAuthService({
    supabaseUrl: Deno.env.get('SUPABASE_URL')!,
    supabaseServiceKey: Deno.env.get('SUPABASE_SERVICE_ROLE_KEY')!
});

// Build the Edge Function handler
const handler = buildEdgeFunction(handlers, authService, {
    basePath: '/multitenantkit',
    cors: {
        allowOrigin: '*',
        allowHeaders: ['authorization', 'x-client-info', 'apikey', 'content-type'],
        allowMethods: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'OPTIONS']
    },
    debug: true // Enable for development
});

// Start the server
Deno.serve(handler);

Configuration Options

interface EdgeFunctionOptions {
    /** Base path prefix for all routes (usually the function name) */
    basePath: string;

    /** CORS configuration */
    cors?: {
        allowOrigin: string | string[];
        allowHeaders: string[];
        allowMethods: string[];
        maxAge?: number;
    };

    /** Enable debug logging */
    debug?: boolean;
}

Project Structure

For a Supabase project using this adapter:

supabase/
├── functions/
│   ├── import_map.json
│   ├── _shared/
│   │   └── multitenantkit.ts    # Shared configuration
│   └── multitenantkit/
│       └── index.ts             # Entry point
├── migrations/
└── config.toml

Supabase Config (config.toml)

[functions.multitenantkit]
verify_jwt = false  # We handle JWT verification ourselves

Available Endpoints

Once deployed, the following endpoints are available (prefixed with your function path):

Users

• POST /users - Create user
• GET /users/me - Get current user
• PATCH /users/me - Update current user
• DELETE /users/me - Delete current user
• GET /users/me/organizations - List user's organizations

Organizations

• POST /organizations - Create organization
• GET /organizations/:id - Get organization
• PATCH /organizations/:id - Update organization
• DELETE /organizations/:id - Delete organization

Memberships

• POST /organizations/:organizationId/memberships - Add member
• GET /organizations/:organizationId/memberships - List members
• GET /organizations/:organizationId/memberships/:memberId - Get member
• PATCH /organizations/:organizationId/memberships/:memberId - Update member
• DELETE /organizations/:organizationId/memberships/:memberId - Remove member

Health

• GET /health - Health check endpoint (built-in)

API Reference

buildEdgeFunction(handlers, authService, options)

Creates a Deno.serve() compatible handler function.

Parameters:

• handlers - Array of HandlerPackages from @multitenantkit/api-handlers
• authService - AuthService implementation (e.g., SupabaseAuthService)
• options - Configuration options

Returns: (request: Request) => Promise<Response>

EdgeRouter

Low-level router class for advanced use cases.

import { EdgeRouter } from '@multitenantkit/adapter-transport-supabase-edge';

const router = new EdgeRouter('/api', handlers);
const match = router.match('GET', '/api/users/me');

Middleware Utilities

For custom implementations:

import {
    authenticateRequest,
    buildCorsHeaders,
    handleCorsPreflightRequest,
    getRequestId,
    validateRequest
} from '@multitenantkit/adapter-transport-supabase-edge';

Differences from Express Adapter

| Aspect | Express | Supabase Edge | |--------|---------|---------------| | Runtime | Node.js | Deno | | Deploy | Manual | Automatic (Supabase) | | Scaling | Manual | Automatic (edge) | | CORS | cors middleware | Manual headers | | Body parsing | express.json() | Native request.json() | | Path params | Express router | Regex matching |

License

MIT