chore(types): export common set of types for supabase server (#78)

* chore(types): export common set of types for supabase server

* fix: moving peer dep type re-export to its own module path

* docs: docummenting peer deps types

* fix: creating export entry

* fix: not renaming 'AuthError'

* docs(types): improving 'supabase-js' peer description

* fix: regression, exporting 'AuthError'

---------

Co-authored-by: Kalleby Santos <kalleby_santos@hotmail.com>

Author: awaseem

docs/api-reference.md

@@ -310,6 +310,23 @@ interface JsonWebKeySet {
 }
 ```
 
+### Peer Dependencies
+
+Some peer dependencies types are available from `@supabase/server/peer/*` export
+
+#### supabase-js
+
+Only a curated set of types are available to import — It means that may be missing types from the original lib.
+
+```ts
+import type {
+  SupabaseClient,
+  PostgrestError,
+  AuthError as SupabaseAuthError, // Avoid clashing with this SDK's own `AuthError` class.
+  // ...
+} from '@supabase/server/peer/supabase-js'
+```
+
 ---
 
 ## Error Classes

package.json

@@ -29,6 +29,11 @@
       "import": "./dist/core/index.mjs",
       "require": "./dist/core/index.cjs"
     },
+    "./peer/supabase-js": {
+      "types": "./dist/peer/supabase-js/index.d.mts",
+      "import": "./dist/peer/supabase-js/index.mjs",
+      "require": "./dist/peer/supabase-js/index.cjs"
+    },
     "./adapters/hono": {
       "types": "./dist/adapters/hono/index.d.mts",
       "import": "./dist/adapters/hono/index.mjs",

src/peer/supabase-js/index.ts

@@ -0,0 +1,35 @@
+/**
+ * Curated re-exports of the most commonly needed types from
+ * `@supabase/supabase-js`.
+ *
+ * `@supabase/supabase-js` is a required peer dependency, so these are always
+ * resolvable at the consumer's install site. Re-exporting them here lets users
+ * type their own helpers (`function f(client: SupabaseClient) {}`), narrow
+ * Postgrest responses, and reference auth objects without reaching into a
+ * second package — `@supabase/server` becomes a single import surface.
+ *
+ *
+ * @packageDocumentation
+ */
+
+export type {
+  // Client
+  SupabaseClient,
+  SupabaseClientOptions,
+
+  // Postgrest (querying)
+  PostgrestError,
+  PostgrestResponse,
+  PostgrestSingleResponse,
+  PostgrestMaybeSingleResponse,
+  QueryData,
+  QueryError,
+  QueryResult,
+
+  // Auth identity
+  User,
+  Session,
+  UserResponse,
+  AuthResponse,
+  AuthError,
+} from '@supabase/supabase-js'

tsdown.config.ts

@@ -4,6 +4,7 @@ export default defineConfig({
   entry: [
     'src/index.ts',
     'src/core/index.ts',
+    'src/peer/supabase-js/index.ts',
     'src/adapters/hono/index.ts',
     'src/adapters/h3/index.ts',
     'src/adapters/elysia/index.ts',