AI Prompt: Writing Supabase Edge Functions

1
# Writing Supabase Edge Functions
2
3
You're an expert in writing TypeScript and Deno JavaScript runtime. Generate **high-quality Supabase Edge Functions** that adhere to the following best practices:
4
5
## Guidelines
6
7
1. Try to use Web APIs and Deno’s core APIs instead of external dependencies (eg: use fetch instead of Axios, use WebSockets API instead of node-ws)
8
2. If you are reusing utility methods between Edge Functions, add them to `supabase/functions/_shared` and import using a relative path. Do NOT have cross dependencies between Edge Functions.
9
3. Do NOT use bare specifiers when importing dependencies. If you need to use an external dependency, make sure it's prefixed with either `npm:` or `jsr:`. For example, `@supabase/supabase-js` should be written as `npm:@supabase/supabase-js`.
10
4. For external imports, always define a version. For example, `npm:@express` should be written as `npm:express@4.18.2`.
11
5. For external dependencies, importing via `npm:` and `jsr:` is preferred. Minimize the use of imports from @`deno.land/x` , `esm.sh` and @`unpkg.com` . If you have a package from one of those CDNs, you can replace the CDN hostname with `npm:` specifier.
12
6. You can also use Node built-in APIs. You will need to import them using `node:` specifier. For example, to import Node process: `import process from "node:process". Use Node APIs when you find gaps in Deno APIs.
13
7. Do NOT use `import { serve } from "https://deno.land/std@0.168.0/http/server.ts"`. Instead use the built-in `Deno.serve`.
14
8. Following environment variables (ie. secrets) are pre-populated in both local and hosted Supabase environments. Users don't need to manually set them:
15
   - SUPABASE_URL
16
   - SUPABASE_PUBLISHABLE_KEYS
17
   - SUPABASE_SECRET_KEYS
18
   - SUPABASE_DB_URL
19
20
You then need to use `JSON.parse(Deno.env.get('SUPABASE_SECRET_KEYS')!)` or `JSON.parse(Deno.env.get('SUPABASE_PUBLISHABLE_KEYS')!)` to access the actual keys in the code. For example, `Deno.env.get(SUPABASE_SECRET_KEYS['default'])` to access the default service key. 9. To set other environment variables (ie. secrets) users can put them in a env file and run the `supabase secrets set --env-file path/to/env-file` 10. A single Edge Function can handle multiple routes. It is recommended to use a library like Express or Hono to handle the routes as it's easier for developer to understand and maintain. Each route must be prefixed with `/function-name` so they are routed correctly. 11. File write operations are ONLY permitted on `/tmp` directory. You can use either Deno or Node File APIs. 12. Use `EdgeRuntime.waitUntil(promise)` static method to run long-running tasks in the background without blocking response to a request. Do NOT assume it is available in the request / execution context.
21
22
## Example Templates
23
24
### Simple Hello World Function
25
26
```tsx
27
interface reqPayload {
28
  name: string
29
}
30
31
console.info('server started')
32
33
Deno.serve(async (req: Request) => {
34
  const { name }: reqPayload = await req.json()
35
  const data = {
36
    message: `Hello ${name} from foo!`,
37
  }
38
39
  return new Response(JSON.stringify(data), {
40
    headers: { 'Content-Type': 'application/json', Connection: 'keep-alive' },
41
  })
42
})
43
```
44
45
### Example Function using Node built-in API
46
47
```tsx
48
import { randomBytes } from 'node:crypto'
49
import { createServer } from 'node:http'
50
import process from 'node:process'
51
52
const generateRandomString = (length) => {
53
  const buffer = randomBytes(length)
54
  return buffer.toString('hex')
55
}
56
57
const randomString = generateRandomString(10)
58
console.log(randomString)
59
60
const server = createServer((req, res) => {
61
  const message = `Hello`
62
  res.end(message)
63
})
64
65
server.listen(9999)
66
```
67
68
### Using npm packages in Functions
69
70
```tsx
71
import express from 'npm:express@4.18.2'
72
73
const app = express()
74
75
app.get(/(.*)/, (req, res) => {
76
  res.send('Welcome to Supabase')
77
})
78
79
app.listen(8000)
80
```
81
82
### Generate embeddings using built-in @Supabase.ai API
83
84
```tsx
85
const model = new Supabase.ai.Session('gte-small')
86
87
Deno.serve(async (req: Request) => {
88
  const params = new URL(req.url).searchParams
89
  const input = params.get('text')
90
  const output = await model.run(input, { mean_pool: true, normalize: true })
91
  return new Response(JSON.stringify(output), {
92
    headers: {
93
      'Content-Type': 'application/json',
94
      Connection: 'keep-alive',
95
    },
96
  })
97
})
98
```