Files
supabase/apps/docs/content/navigation.references.ts
Jeremias Menichelli f20cd22dc3 docs: improve SDK automation build step on docs (#46163)
# Second try of making a new better process for SDK automation

Instead of building a new pipeline. We will take the lessons learned
form round 1, plus the good design and improvement on DX quality for
drop-in file as a single step required from SDK team and produce almost
identical set of files as used right now to render using the current
pipeline.



<!-- This is an auto-generated comment: release notes by coderabbit.ai
-->
## Summary by CodeRabbit

* **New Features**
* New reference-content pipeline producing per-library reference
artifacts and integrating into prebuilds, search ingestion, and
rendering (type-aware examples).

* **Documentation**
* Added comprehensive JavaScript SDK v2 reference content and partials
(Auth MFA, passkeys, admin, TypeScript support, filters, modifiers,
Installing, Initializing, Buckets, etc.).

* **Tests & CI**
* Added regression snapshot test and updated workflows to refresh
reference snapshots and ensure spec downloads.

* **Chores**
* Updated ignore rules, build scripts, Makefile targets, and package
lifecycle hooks.
<!-- end of auto-generated comment: release notes by coderabbit.ai -->

---------

Co-authored-by: Katerina Skroumpelou <mandarini@users.noreply.github.com>
Co-authored-by: Katerina Skroumpelou <sk.katherine@gmail.com>
2026-06-03 11:46:02 +03:00

186 lines
4.3 KiB
TypeScript

import { isFeatureEnabled } from 'common/enabled-features'
const {
sdkCsharp: sdkCsharpEnabled,
sdkDart: sdkDartEnabled,
sdkKotlin: sdkKotlinEnabled,
sdkPython: sdkPythonEnabled,
sdkSwift: sdkSwiftEnabled,
} = isFeatureEnabled(['sdk:csharp', 'sdk:dart', 'sdk:kotlin', 'sdk:python', 'sdk:swift'])
export const REFERENCES = {
javascript: {
type: 'sdk',
name: 'JavaScript',
library: 'supabase-js',
libPath: 'javascript',
versions: ['v2', 'v1'],
typeSpec: true,
icon: 'reference-javascript',
meta: {
v2: {
// JS v2 is driven by the new reference pipeline
// (`scripts/build-reference-content.ts` + `spec/reference/javascript/v2/`).
// It intentionally has no `specFile` — the legacy YAML loader skips it.
libId: 'reference_javascript_v2',
},
v1: {
libId: 'reference_javascript_v1',
specFile: 'supabase_js_v1',
},
},
},
dart: {
type: 'sdk',
name: 'Flutter',
library: 'supabase-dart',
libPath: 'dart',
versions: ['v2', 'v1'],
icon: 'reference-dart',
meta: {
v2: {
libId: 'reference_dart_v2',
specFile: 'supabase_dart_v2',
},
v1: {
libId: 'reference_dart_v1',
specFile: 'supabase_dart_v1',
},
},
enabled: sdkDartEnabled,
},
csharp: {
type: 'sdk',
name: 'C#',
library: 'supabase-csharp',
libPath: 'csharp',
versions: ['v1', 'v0'],
icon: 'reference-csharp',
meta: {
v1: {
libId: 'reference_csharp_v1',
specFile: 'supabase_csharp_v1',
},
v0: {
libId: 'reference_csharp_v0',
specFile: 'supabase_csharp_v0',
},
},
enabled: sdkCsharpEnabled,
},
swift: {
type: 'sdk',
name: 'Swift',
library: 'supabase-swift',
libPath: 'swift',
versions: ['v2', 'v1'],
icon: 'reference-swift',
meta: {
v2: {
libId: 'reference_swift_v2',
specFile: 'supabase_swift_v2',
},
v1: {
libId: 'reference_swift_v1',
specFile: 'supabase_swift_v1',
},
},
enabled: sdkSwiftEnabled,
},
kotlin: {
type: 'sdk',
name: 'Kotlin',
library: 'supabase-kt',
libPath: 'kotlin',
versions: ['v3', 'v2', 'v1'],
icon: 'reference-kotlin',
meta: {
v3: {
libId: 'reference_kotlin_v3',
specFile: 'supabase_kt_v3',
},
v2: {
libId: 'reference_kotlin_v2',
specFile: 'supabase_kt_v2',
},
v1: {
libId: 'reference_kotlin_v1',
specFile: 'supabase_kt_v1',
},
},
enabled: sdkKotlinEnabled,
},
python: {
type: 'sdk',
name: 'Python',
library: 'supabase-py',
libPath: 'python',
versions: ['v2'],
icon: 'reference-python',
meta: {
v2: {
libId: 'reference_python_v2',
specFile: 'supabase_py_v2',
},
},
enabled: sdkPythonEnabled,
},
cli: {
type: 'cli',
name: 'CLI',
libPath: 'cli',
versions: [],
icon: 'reference-cli',
},
api: {
type: 'api',
name: 'API',
libPath: 'api',
versions: [],
icon: 'reference-api',
},
self_hosting_analytics: {
type: 'self-hosting',
name: 'Self-Hosting Analytics',
libPath: 'self-hosting-analytics',
versions: [],
icon: 'reference-analytics',
},
self_hosting_auth: {
type: 'self-hosting',
name: 'Self-Hosting Auth',
libPath: 'self-hosting-auth',
versions: [],
icon: 'self-hosting',
},
self_hosting_functions: {
type: 'self-hosting',
name: 'Self-Hosting Functions',
libPath: 'self-hosting-functions',
versions: [],
icon: 'reference-functions',
},
self_hosting_realtime: {
type: 'self-hosting',
name: 'Self-Hosting Realtime',
libPath: 'self-hosting-realtime',
versions: [],
icon: 'self-hosting',
},
self_hosting_storage: {
type: 'self-hosting',
name: 'Self-Hosting Storage',
libPath: 'self-hosting-storage',
versions: [],
icon: 'self-hosting',
},
} as const
export const clientSdkIds = Object.keys(REFERENCES).filter(
(reference) => REFERENCES[reference].type === 'sdk' && REFERENCES[reference].enabled !== false
)
export const selfHostingServices = Object.keys(REFERENCES).filter(
(reference) => REFERENCES[reference].type === 'self-hosting'
)