feature: supabase sdk references

[Rodriguespn]

Summary

Adds 13 SDK reference files covering supabase-js client usage:

• Client Setup (sdk-client-*): Browser singleton via createBrowserClient, server client with cookie handling via createServerClient, and configuration options
• TypeScript (sdk-ts-*): Type generation from database schema and usage with Tables/Enums/QueryData helpers
• Queries (sdk-query-*): CRUD operations, filters/modifiers, relation joins, and RPC calls to Postgres functions
• Error Handling (sdk-error-handling): { data, error } pattern, Edge Function errors, retry with custom fetch
• Performance (sdk-perf-*): Query optimization (select specific columns, parallel queries) and realtime subscription cleanup
• Frameworks (sdk-framework-nextjs): Next.js App Router setup with middleware, Server Components vs Client Components, Server Actions

Uses @supabase/ssr (not deprecated @supabase/auth-helpers-nextjs), getClaims(), and proxy.ts patterns. Updates SKILL.md, AGENTS.md, and _sections.md.

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

🗂️ Base branches to auto review (2)

• !master
• !main

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

✨ Finishing touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch feature/supabase-sdk-references

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[Rodriguespn]

Hey sdk team, I've gave this another look by comparing the information from the reference files and our documentation. Below is the changelog report with the changes for each file and the sources I used for each one.

---

sdk-client-browser.md — Renamed NEXT_PUBLIC_SUPABASE_ANON_KEY → NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY, clarified that cookie sync requires middleware/proxy setup (not automatic).

• https://supabase.com/docs/guides/auth/server-side/creating-a-client

sdk-client-config.md — Added missing react-native-url-polyfill/auto import in React Native example, added startAutoRefresh()/stopAutoRefresh() pattern with AppState listener.

• https://supabase.com/docs/reference/javascript/initializing
• https://supabase.com/docs/guides/getting-started/tutorials/with-expo-react-native

sdk-client-server.md — Renamed NEXT_PUBLIC_SUPABASE_ANON_KEY → NEXT_PUBLIC_SUPABASE_PUBLISHABLE_KEY across all examples, fixed Dashboard path from "Auth > Settings" to "Settings > JWT Signing Keys".

• https://supabase.com/docs/guides/auth/server-side/creating-a-client
• https://supabase.com/docs/guides/auth/signing-keys

sdk-error-handling.md — Changed retryOn from [500, 502, 503, 504] to [520] (Cloudflare errors only), added connection pool exhaustion warning, fixed PGRST116 description from "No rows returned" to "More than 1 or no items returned".

• https://supabase.com/docs/guides/api/automatic-retries-in-supabase-js
• https://supabase.com/docs/guides/api/rest/postgrest-error-codes

sdk-framework-nextjs.md — Changed proxy from getClaims() to getUser() with comments explaining the distinction (local JWT validation vs server-verified), updated pitfalls table with security method details.

• https://supabase.com/docs/guides/auth/server-side/advanced-guide
• https://supabase.com/docs/guides/auth/server-side/creating-a-client

sdk-perf-queries.md — Added SQL prerequisite for explain() (alter role authenticator set pgrst.db_plan_enabled to 'true'), noted it is disabled by default and recommended for non-production only.

• https://supabase.com/docs/guides/database/debugging-performance

sdk-perf-realtime.md — Fixed subscribe callback from (status, err) to single parameter (status), added private channel config, RLS policy, and setAuth() requirement to Broadcast from Database example.

• https://supabase.com/docs/reference/javascript/subscribe
• https://supabase.com/docs/guides/realtime/subscribing-to-database-changes

sdk-query-crud.md — Removed incorrect/correct framing for insert (insert without .select() is valid and is the primary documented pattern), changed single() description from "Throws error" to "Returns error".

• https://supabase.com/docs/reference/javascript/insert
• https://supabase.com/docs/reference/javascript/single

sdk-query-filters.md — Added -> vs ->> distinction for JSON column filtering (-> returns JSONB for non-string comparisons, ->> returns text for string comparisons).

• https://supabase.com/docs/reference/javascript/using-filters

sdk-query-joins.md — Changed filter from alias name (author.status) to table name (users.status) in dot notation, replaced users!sender_id FK disambiguation with two documented forms: column-based (sender_id(name)) and constraint-based (users!messages_sender_id_fkey(name)).

• https://supabase.com/docs/reference/javascript/using-filters
• https://supabase.com/docs/reference/javascript/select

sdk-query-rpc.md — Added missing details and hint fields to error object description, noted code can be PostgREST-specific.

• https://supabase.com/docs/guides/api/rest/postgrest-error-codes

sdk-ts-generation.md — Changed id?: number to id?: never for generated always as identity columns in Insert/Update types, renamed SUPABASE_ANON_KEY → SUPABASE_PUBLISHABLE_KEY.

• https://supabase.com/docs/guides/api/rest/generating-types

sdk-ts-usage.md — Fixed overrideTypes to show Array<> wrapping and { merge: false } option with partial/complete/single-row examples, changed QueryData usage from [number] indexing to direct array type.

• https://supabase.com/docs/reference/javascript/db-overrideTypes
• https://supabase.com/docs/guides/api/rest/generating-types