@blinkdotnew/sdk 0.18.7 → 0.18.8

package/README.md

@@ -187,8 +187,7 @@ const blink = createClient({
   auth: { mode: 'managed' } // Manual token management
 })
 
-// Set JWT manually
-blink.auth.setToken(jwtFromHeader)
+// Token injection is only needed when calling blink.auth.* methods on the server
 ```
 
 ## 📖 API Reference
@@ -235,6 +234,22 @@ const user = await blink.auth.signInWithGitHub()
 const user = await blink.auth.signInWithApple()
 const user = await blink.auth.signInWithMicrosoft()
 
+// ✅ Store custom signup fields inside metadata
+await blink.auth.signUp({
+  email: 'founder@example.com',
+  password: 'SuperSecret123',
+  displayName: 'Alex Founder',
+  role: 'operations',
+  metadata: {
+    company: 'Acme Freight',
+    marketingConsent: true
+  }
+})
+// `displayName`, `avatar`, and `role` map to dedicated auth columns.
+// Everything else goes into auth.users.metadata automatically.
+// Keep custom fields in metadata or your own profile table—avoid adding NOT NULL
+// columns directly to auth tables.
+
 // Magic links (passwordless)
 await blink.auth.sendMagicLink(email)
 
@@ -427,6 +442,8 @@ function EditButton() {
 
 #### Core Methods
 
+> ⚠️ Tokens are managed automatically for Blink APIs. Use `getValidToken()` only if you must manually pass a token to your own backend or third-party services.
+
 ```typescript
 // User management
 const user = await blink.auth.me()
@@ -435,6 +452,7 @@ await blink.auth.updateMe({ displayName: 'New Name' })
 // Token management
 blink.auth.setToken(jwt, persist?)
 const isAuth = blink.auth.isAuthenticated()
+const token = await blink.auth.getValidToken() // Get valid token (auto-refreshes)
 
 // Password management
 await blink.auth.sendPasswordResetEmail('user@example.com')
@@ -2356,9 +2374,6 @@ const blink = createClient({
 })
 
 export default async function handler(req, res) {
-  const jwt = req.headers.authorization?.replace('Bearer ', '')
-  blink.auth.setToken(jwt)
-
   const todos = await blink.db.todos.list()
   res.json(todos)
 }
@@ -2376,9 +2391,6 @@ const blink = createClient({
 })
 
 Deno.serve(async (req) => {
-  const jwt = req.headers.get('authorization')?.replace('Bearer ', '')
-  blink.auth.setToken(jwt)
-
   const todos = await blink.db.todos.list()
   return Response.json(todos)
 })

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.18.7",
+  "version": "0.18.8",
   "description": "Blink TypeScript SDK for client-side applications - Zero-boilerplate CRUD + auth + AI + analytics + notifications for modern SaaS/AI apps",
   "keywords": [
     "blink",