docs: update js sdk docs (2.95.3) (supabase#42557)

Updates JS sdk documentation following stable release. 
Ran `make` in apps/docs/spec to regenerate tsdoc files.

**Details:**
- **Version:** `2.95.3`
- **Source:** `supabase-js-stable-release`
- **Changes:** Regenerated tsdoc files from latest spec files

🤖 Auto-generated from @supabase/supabase-js stable release.

---------

Co-authored-by: supabase-releaser[bot] <223506987+supabase-releaser[bot]@users.noreply.github.com>
Co-authored-by: Katerina Skroumpelou <sk.katherine@gmail.com>

Author: 3 people

apps/docs/app/api/crawlers/route.ts

@@ -13,7 +13,7 @@ import {
   getTypeSpec,
 } from '~/features/docs/Reference.generated.singleton'
 import { getRefMarkdown } from '~/features/docs/Reference.mdx'
-import type { MethodTypes } from '~/features/docs/Reference.typeSpec'
+import type { MethodTypes, VariableTypes } from '~/features/docs/Reference.typeSpec'
 import type { AbbrevApiReferenceSection } from '~/features/docs/Reference.utils'
 import { BASE_PATH } from '~/lib/constants'
 
@@ -136,7 +136,7 @@ async function functionDetails(
   const fn = fns!.find((fn) => fn.id === section.id)
   if (!fn) return ''
 
-  let types: MethodTypes | undefined
+  let types: MethodTypes | VariableTypes | undefined
   if (libraryMeta.typeSpec && '$ref' in fn) {
     types = await getTypeSpec(fn['$ref'] as string)
   }
@@ -176,7 +176,7 @@ function mdxToHtml(markdown: string): string {
   return html
 }
 
-function parametersToHtml(fn: any, types: MethodTypes | undefined) {
+function parametersToHtml(fn: any, types: MethodTypes | VariableTypes | undefined) {
   let result = '<h2 id="parameters">Parameters</h2>'
 
   if ('overwriteParams' in fn || 'params' in fn) {
@@ -200,7 +200,7 @@ function parametersToHtml(fn: any, types: MethodTypes | undefined) {
     return result
   }
 
-  if (!types?.params || types.params.length === 0) return ''
+  if (!types || !('params' in types) || !types.params || types.params.length === 0) return ''
 
   result +=
     '<ul>' +

apps/docs/features/docs/Reference.generated.script.ts

@@ -161,7 +161,7 @@ async function writeTypes() {
   await writeFile(
     join(GENERATED_DIRECTORY, 'typeSpec.json'),
     JSON.stringify(types, (key, value) => {
-      if (key === 'methods') {
+      if (key === 'methods' || key === 'variables') {
         return Object.fromEntries(value.entries())
       } else {
         return value

apps/docs/features/docs/Reference.generated.singleton.ts

@@ -16,7 +16,7 @@ async function _typeSpecSingleton() {
       'utf-8'
     )
     typeSpec = JSON.parse(rawJson, (key, value) => {
-      if (key === 'methods') {
+      if (key === 'methods' || key === 'variables') {
         return new Map(Object.entries(value))
       } else {
         return value
@@ -39,7 +39,8 @@ export async function getTypeSpec(ref: string) {
   const refMod = normalizedRef.substring(0, delimiter)
 
   const mod = modules.find((mod) => mod.name === refMod)
-  return mod?.methods.get(normalizedRef)
+  // Check methods first, then variables
+  return mod?.methods.get(normalizedRef) ?? mod?.variables.get(normalizedRef)
 }
 
 let cliSpec: Json

apps/docs/features/docs/Reference.sections.tsx

@@ -9,7 +9,7 @@ import {
   getTypeSpec,
 } from '~/features/docs/Reference.generated.singleton'
 import { getRefMarkdown, MDXRemoteRefs } from '~/features/docs/Reference.mdx'
-import type { MethodTypes } from '~/features/docs/Reference.typeSpec'
+import type { MethodTypes, VariableTypes } from '~/features/docs/Reference.typeSpec'
 import { formatMethodSignature } from '~/features/docs/Reference.typeSpec'
 import {
   ApiOperationRequestBodyDetails,
@@ -460,7 +460,7 @@ async function FunctionSection({
   const fn = fns?.find((fn) => fn.id === section.id)
   if (!fn) return null
 
-  let types: MethodTypes | undefined
+  let types: MethodTypes | VariableTypes | undefined
   if (useTypeSpec && '$ref' in fn) {
     types = await getTypeSpec(fn['$ref'] as string)
   }
@@ -479,7 +479,7 @@ async function FunctionSection({
       <StickyHeader {...section} className="col-[1_/_-1]" />
 
       {/* Display method signature below title */}
-      {types && formatMethodSignature(types) && (
+      {types && 'params' in types && formatMethodSignature(types) && (
         <div className="col-[1_/_-1] -mt-2 mb-4">
           <code className="text-sm text-foreground-muted font-mono">
             {formatMethodSignature(types)}
@@ -500,12 +500,18 @@ async function FunctionSection({
                 }))
               : 'params' in fn
                 ? (fn.params as Array<object>).map((param) => ({ ...param, __overwritten: true }))
-                : types?.params
+                : types && 'params' in types
+                  ? types.params
+                  : undefined
+          }
+          altParameters={
+            types && 'altSignatures' in types
+              ? types.altSignatures?.map(({ params }) => params)
+              : undefined
           }
-          altParameters={types?.altSignatures?.map(({ params }) => params)}
           className="max-w-[80ch]"
         />
-        {!!types?.ret && <ReturnTypeDetails returnType={types.ret} />}
+        {types && 'ret' in types && !!types.ret && <ReturnTypeDetails returnType={types.ret} />}
       </div>
       <div className="overflow-auto">
         {(() => {

apps/docs/features/docs/Reference.typeSpec.ts

@@ -25,6 +25,7 @@ export const TYPESPEC_NODE_ANONYMOUS = Symbol('anonymous')
 export interface ModuleTypes {
   name: string
   methods: Map<string, MethodTypes>
+  variables: Map<string, VariableTypes>
 }
 
 /**
@@ -43,6 +44,16 @@ export interface MethodTypes {
   ]
 }
 
+/**
+ * Type definitions for a variable or constant.
+ */
+export interface VariableTypes {
+  name: string | typeof TYPESPEC_NODE_ANONYMOUS
+  comment?: Comment
+  type: TypeDetails | undefined
+  isConst?: boolean
+}
+
 interface Comment {
   shortText?: string
   text?: string
@@ -160,6 +171,7 @@ export interface CustomTypePropertyType {
 // The meaning of kind flags from `typedoc`:
 // https://github.com/TypeStrong/typedoc/blob/2953b0148253589448176881a7acb46090f941bd/src/lib/output/themes/default/assets/typedoc/Application.ts#L36
 const KIND_MODULE = 2
+const KIND_VARIABLE = 32
 const KIND_CLASS = 128
 const KIND_INTERFACE = 256
 const KIND_CONSTRUCTOR = 512
@@ -285,6 +297,7 @@ function parseMod(mod: (typeof typeSpec)['children'][number]) {
   const res: ModuleTypes = {
     name: mod.name,
     methods: new Map(),
+    variables: new Map(),
   }
 
   // Build a map of nodes by their IDs for easy cross-referencing.
@@ -365,6 +378,8 @@ function parseModInternal(
         parseConstructor(node, map, currentPath, res)
       } else if (node.kind === KIND_METHOD) {
         return parseMethod(node, map, currentPath, res)
+      } else if (node.kind === KIND_VARIABLE) {
+        return parseVariable(node, map, currentPath, res)
       } else if (node.kind === KIND_PROPERTY) {
         parsePropertyReference(node, map, currentPath, res, processingRefs)
       }
@@ -490,6 +505,27 @@ function parseMethod(
   res.methods.set($ref, types)
 }
 
+function parseVariable(
+  node: any,
+  map: Map<number, any>,
+  currentPath: Array<string>,
+  res: ModuleTypes
+) {
+  const $ref = buildRefPath([...currentPath, node.name])
+
+  const type = parseType(node.type, map)
+  const comment = node.comment ? normalizeComment(node.comment) : undefined
+
+  const types: VariableTypes = {
+    name: $ref,
+    type,
+    comment,
+    isConst: node.flags?.isConst ?? false,
+  }
+
+  res.variables.set($ref, types)
+}
+
 function parseSignature(
   signature: any,
   map: Map<number, any>