@blinkdotnew/sdk 0.12.5 → 0.13.2

package/README.md

@@ -196,8 +196,9 @@ const unsubscribe = blink.auth.onAuthStateChanged((state) => {
 ### Database Operations
 
 ```typescript
-// Create
+// Create (ID auto-generated if not provided)
 const todo = await blink.db.todos.create({
+  id: 'todo_12345', // Optional - auto-generated if not provided
   title: 'Learn Blink SDK',
   user_id: user.id
 })
@@ -215,14 +216,22 @@ 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 })
 
 // Delete
 await blink.db.todos.delete(todo.id)
 
-// Bulk operations
-await blink.db.todos.createMany([...])
+// Bulk operations (IDs auto-generated if not provided)
+await blink.db.todos.createMany([
+  { title: 'Task 1', user_id: user.id }, // ID will be auto-generated
+  { id: 'custom_id', title: 'Task 2', user_id: user.id } // Custom ID provided
+])
 await blink.db.todos.upsertMany([...])
 
 // Raw SQL
@@ -292,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',
@@ -1147,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/dist/index.js

@@ -1314,6 +1314,24 @@ var BlinkAuth = class {
 };
 
 // src/database.ts
+function generateSecureId() {
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    const array = new Uint8Array(16);
+    crypto.getRandomValues(array);
+    return Array.from(array, (byte) => byte.toString(16).padStart(2, "0")).join("");
+  } else {
+    const timestamp = Date.now().toString(36);
+    const randomPart = Math.random().toString(36).substring(2, 15);
+    const extraRandom = Math.random().toString(36).substring(2, 15);
+    return `${timestamp}_${randomPart}_${extraRandom}`;
+  }
+}
+function ensureRecordId(record) {
+  if (!record.id) {
+    return { ...record, id: generateSecureId() };
+  }
+  return record;
+}
 var BlinkTable = class {
   constructor(tableName, httpClient) {
     this.tableName = tableName;
@@ -1323,9 +1341,10 @@ var BlinkTable = class {
    * Create a single record
    */
   async create(data, options = {}) {
+    const record = ensureRecordId(data);
     const response = await this.httpClient.dbPost(
       this.tableName,
-      data,
+      record,
       { returning: options.returning !== false }
     );
     const result = Array.isArray(response.data) ? response.data[0] : response.data;
@@ -1338,13 +1357,14 @@ var BlinkTable = class {
    * Create multiple records
    */
   async createMany(data, options = {}) {
+    const records = data.map(ensureRecordId);
     const response = await this.httpClient.dbPost(
       this.tableName,
-      data,
+      records,
       { returning: options.returning !== false }
     );
-    const records = Array.isArray(response.data) ? response.data : [response.data];
-    return records;
+    const results = Array.isArray(response.data) ? response.data : [response.data];
+    return results;
   }
   /**
    * Upsert a single record (insert or update on conflict)
@@ -1357,11 +1377,12 @@ var BlinkTable = class {
     if (options.onConflict) {
       headers["Prefer"] = `${headers["Prefer"] || ""} resolution=merge-duplicates`.trim();
     }
+    const record = ensureRecordId(data);
     const response = await this.httpClient.request(
       `/api/db/${this.httpClient.projectId}/rest/v1/${this.tableName}?on_conflict=${options.onConflict || "id"}`,
       {
         method: "POST",
-        body: data,
+        body: record,
         headers
       }
     );
@@ -1375,6 +1396,7 @@ var BlinkTable = class {
    * Upsert multiple records
    */
   async upsertMany(data, options = {}) {
+    const records = data.map(ensureRecordId);
     const headers = {};
     if (options.returning !== false) {
       headers.Prefer = "return=representation";
@@ -1386,12 +1408,12 @@ var BlinkTable = class {
       `/api/db/${this.httpClient.projectId}/rest/v1/${this.tableName}?on_conflict=${options.onConflict || "id"}`,
       {
         method: "POST",
-        body: data,
+        body: records,
         headers
       }
     );
-    const records = Array.isArray(response.data) ? response.data : [response.data];
-    return records;
+    const results = Array.isArray(response.data) ? response.data : [response.data];
+    return results;
   }
   /**
    * Get a single record by ID

package/dist/index.mjs

@@ -1312,6 +1312,24 @@ var BlinkAuth = class {
 };
 
 // src/database.ts
+function generateSecureId() {
+  if (typeof crypto !== "undefined" && crypto.getRandomValues) {
+    const array = new Uint8Array(16);
+    crypto.getRandomValues(array);
+    return Array.from(array, (byte) => byte.toString(16).padStart(2, "0")).join("");
+  } else {
+    const timestamp = Date.now().toString(36);
+    const randomPart = Math.random().toString(36).substring(2, 15);
+    const extraRandom = Math.random().toString(36).substring(2, 15);
+    return `${timestamp}_${randomPart}_${extraRandom}`;
+  }
+}
+function ensureRecordId(record) {
+  if (!record.id) {
+    return { ...record, id: generateSecureId() };
+  }
+  return record;
+}
 var BlinkTable = class {
   constructor(tableName, httpClient) {
     this.tableName = tableName;
@@ -1321,9 +1339,10 @@ var BlinkTable = class {
    * Create a single record
    */
   async create(data, options = {}) {
+    const record = ensureRecordId(data);
     const response = await this.httpClient.dbPost(
       this.tableName,
-      data,
+      record,
       { returning: options.returning !== false }
     );
     const result = Array.isArray(response.data) ? response.data[0] : response.data;
@@ -1336,13 +1355,14 @@ var BlinkTable = class {
    * Create multiple records
    */
   async createMany(data, options = {}) {
+    const records = data.map(ensureRecordId);
     const response = await this.httpClient.dbPost(
       this.tableName,
-      data,
+      records,
       { returning: options.returning !== false }
     );
-    const records = Array.isArray(response.data) ? response.data : [response.data];
-    return records;
+    const results = Array.isArray(response.data) ? response.data : [response.data];
+    return results;
   }
   /**
    * Upsert a single record (insert or update on conflict)
@@ -1355,11 +1375,12 @@ var BlinkTable = class {
     if (options.onConflict) {
       headers["Prefer"] = `${headers["Prefer"] || ""} resolution=merge-duplicates`.trim();
     }
+    const record = ensureRecordId(data);
     const response = await this.httpClient.request(
       `/api/db/${this.httpClient.projectId}/rest/v1/${this.tableName}?on_conflict=${options.onConflict || "id"}`,
       {
         method: "POST",
-        body: data,
+        body: record,
         headers
       }
     );
@@ -1373,6 +1394,7 @@ var BlinkTable = class {
    * Upsert multiple records
    */
   async upsertMany(data, options = {}) {
+    const records = data.map(ensureRecordId);
     const headers = {};
     if (options.returning !== false) {
       headers.Prefer = "return=representation";
@@ -1384,12 +1406,12 @@ var BlinkTable = class {
       `/api/db/${this.httpClient.projectId}/rest/v1/${this.tableName}?on_conflict=${options.onConflict || "id"}`,
       {
         method: "POST",
-        body: data,
+        body: records,
         headers
       }
     );
-    const records = Array.isArray(response.data) ? response.data : [response.data];
-    return records;
+    const results = Array.isArray(response.data) ? response.data : [response.data];
+    return results;
   }
   /**
    * Get a single record by ID

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@blinkdotnew/sdk",
-  "version": "0.12.5",
+  "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",