@blinkdotnew/sdk 0.13.0 → 0.13.2

package/README.md

@@ -216,6 +216,11 @@ const todos = await blink.db.todos.list({
 })
 // `todos` is a direct array: Todo[]
 
+// Note: Boolean fields are returned as "0"/"1" strings from SQLite
+// Check boolean values using Number(value) > 0
+const completedTodos = todos.filter(todo => Number(todo.completed) > 0)
+const incompleteTodos = todos.filter(todo => Number(todo.completed) === 0)
+
 // Update
 await blink.db.todos.update(todo.id, { completed: true })
 
@@ -296,6 +301,42 @@ const { object } = await blink.ai.generateObject({
   }
 })
 
+// ⚠️ IMPORTANT: Schema Rule for generateObject()
+// The top-level schema MUST use type: "object" - you cannot use type: "array" at the top level
+// This ensures clear, robust, and extensible API calls with named parameters
+
+// ✅ Correct: Array inside object
+const { object: todoList } = await blink.ai.generateObject({
+  prompt: 'Generate a list of 5 daily tasks',
+  schema: {
+    type: 'object',
+    properties: {
+      tasks: {
+        type: 'array',
+        items: { 
+          type: 'object',
+          properties: {
+            title: { type: 'string' },
+            priority: { type: 'string', enum: ['low', 'medium', 'high'] }
+          }
+        }
+      }
+    },
+    required: ['tasks']
+  }
+})
+// Result: { tasks: [{ title: "Exercise", priority: "high" }, ...] }
+
+// ❌ Wrong: Top-level array (will fail)
+// const { object } = await blink.ai.generateObject({
+//   prompt: 'Generate tasks',
+//   schema: {
+//     type: 'array',  // ❌ This will throw an error
+//     items: { type: 'string' }
+//   }
+// })
+// Error: "schema must be a JSON Schema of 'type: \"object\"', got 'type: \"array\"'"
+
 // Image generation
 const { data } = await blink.ai.generateImage({
   prompt: 'A serene landscape',
@@ -1151,17 +1192,22 @@ The SDK is written in TypeScript and provides full type safety:
 interface Todo {
   id: string
   title: string
-  completed: boolean
+  completed: boolean  // Will be returned as "0" or "1" string from SQLite
   user_id: string
   created_at: string
 }
 
-// Note: Boolean fields are stored as integers (0/1) in SQLite
+// Note: Boolean fields are returned as "0"/"1" strings from SQLite
 // Use Number(value) > 0 to check boolean values
-const completed = Number(todo.completed) > 0
+const todos = await blink.db.todos.list<Todo>()
+
+// Check boolean values properly
+const completedTodos = todos.filter(todo => Number(todo.completed) > 0)
+const incompleteTodos = todos.filter(todo => Number(todo.completed) === 0)
 
-const todos = await blink.db.todos.list<Todo>({
-  where: { completed: false }
+// When filtering by boolean values in queries, use "0"/"1" strings
+const onlyCompleted = await blink.db.todos.list<Todo>({
+  where: { completed: "1" }  // Use string "1" for true, "0" for false
 })
 // todos is fully typed as Todo[]
 ```

package/package.json

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