@superblocksteam/vite-plugin-file-sync 2.0.93 → 2.0.94-next.0

package/dist/ai-service/skills/system/superblocks-api/references/rest-apis.generated.d.ts

@@ -1,2 +1,2 @@
-export declare const content = "# REST API Integrations\n\nReference documentation for working with REST APIs and OpenAPI integrations in Superblocks.\n\n## REST API vs OpenAPI\n\n**Use RestApi** when:\n- Making calls to custom endpoints\n- No OpenAPI spec available\n- Simple GET/POST operations\n\n**Use OpenApi** when:\n- Integration metadata shows `spec: \"openapi\"` or `specType: \"OPEN_API_SPEC\"`\n- Working with documented APIs (Stripe, Twilio, etc.)\n- Need type-safe operations\n\n## RestApi Class\n\n```typescript\nimport { RestApi } from \"@superblocksteam/library\";\n\nnew RestApi(\"fetch_data\", \"rest-integration-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/data\",\n  params: { page: \"1\", limit: \"10\" },\n  headers: { \"X-Custom-Header\": \"value\" }\n})\n```\n\n### Dynamic Configuration\n\n```typescript\nnew RestApi(\"create_item\", \"rest-id\", {\n  method: \"POST\",\n  url: ({ baseUrl }: { baseUrl: string }) => `${baseUrl}/items`,\n  params: ({ page }: { page: number }) => ({ page: String(page) }),\n  headers: ({ authToken }: { authToken: string }) => ({\n    \"Authorization\": `Bearer ${authToken}`,\n    \"Content-Type\": \"application/json\"\n  }),\n  body: ({ itemData }: { itemData: object }) => JSON.stringify(itemData)\n})\n```\n\n### Common REST Patterns\n\n```typescript\n// GET with query params\nnew RestApi(\"search\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/search\",\n  params: ({ query, page }: { query: string; page: number }) => ({\n    q: query,\n    page: String(page),\n    limit: \"20\"\n  })\n})\n\n// POST with JSON body\nnew RestApi(\"create\", \"rest-id\", {\n  method: \"POST\",\n  url: \"https://api.example.com/items\",\n  headers: { \"Content-Type\": \"application/json\" },\n  body: ({ data }: { data: object }) => JSON.stringify(data)\n})\n\n// PUT for updates\nnew RestApi(\"update\", \"rest-id\", {\n  method: \"PUT\",\n  url: ({ id }: { id: string }) => `https://api.example.com/items/${id}`,\n  headers: { \"Content-Type\": \"application/json\" },\n  body: ({ data }: { data: object }) => JSON.stringify(data)\n})\n\n// DELETE\nnew RestApi(\"delete\", \"rest-id\", {\n  method: \"DELETE\",\n  url: ({ id }: { id: string }) => `https://api.example.com/items/${id}`\n})\n```\n\n## OpenApi Class\n\n```typescript\nimport { OpenApi } from \"@superblocksteam/library\";\n\nnew OpenApi(\"list_customers\", \"stripe-integration-id\", {\n  operation: \"listCustomers\",\n  params: { limit: 10 }\n})\n```\n\n### OpenAPI Operations\n\nOperation names are defined by the API spec. Common patterns:\n- `list{Resource}` - List all resources\n- `get{Resource}` - Get a single resource\n- `create{Resource}` - Create a resource\n- `update{Resource}` - Update a resource\n- `delete{Resource}` - Delete a resource\n\n### Dynamic OpenAPI Params\n\n```typescript\nnew OpenApi(\"get_customer\", \"stripe-id\", {\n  operation: \"getCustomer\",\n  params: ({ customerId }: { customerId: string }) => ({\n    customer_id: customerId\n  })\n})\n```\n\n## Response Handling\n\nREST and OpenAPI responses are available via `.output`:\n\n```typescript\nnew RestApi(\"fetch\", \"rest-id\", { ... }),\n\nnew JavaScript(\"process\", {\n  fn: ({ fetch }) => {\n    const data = fetch.output;\n    // For REST APIs, output is typically the JSON response\n    // For OpenAPI, output structure depends on the operation\n    return data.items.map(item => item.name);\n  }\n})\n```\n\n## Error Handling\n\nHTTP errors (4xx, 5xx) are captured in the output:\n\n```typescript\nnew TryCatch(\"safe_api_call\", {\n  try: [\n    new RestApi(\"risky_call\", \"rest-id\", {\n      method: \"POST\",\n      url: \"https://api.example.com/sensitive\"\n    })\n  ],\n  catch: [\n    new JavaScript(\"handle_error\", {\n      fn: ({ apiError }) => ({\n        success: false,\n        error: apiError.value.message,\n        statusCode: apiError.value.statusCode\n      })\n    })\n  ],\n  variables: { error: \"apiError\" }\n})\n```\n\n## Pagination Patterns\n\n### Cursor-Based Pagination\n\n```typescript\nnew Variables(\"state\", [\n  { key: \"allItems\", value: () => [] },\n  { key: \"cursor\", value: () => null },\n  { key: \"hasMore\", value: () => true }\n]),\n\nnew Loop(\"paginate\", {\n  type: \"TYPE_FOREACH\",\n  over: () => [...Array(100).keys()],\n  variables: { item: \"_\", index: \"i\" },\n  blocks: [\n    new Conditional(\"check_done\", {\n      if: {\n        when: ({ hasMore }) => !hasMore.value,\n        then: [new Break(\"exit\", { condition: () => true })]\n      }\n    }),\n    new RestApi(\"fetch_page\", \"rest-id\", {\n      method: \"GET\",\n      url: \"https://api.example.com/items\",\n      params: ({ cursor }) => cursor.value ? { cursor: cursor.value } : {}\n    }),\n    new JavaScript(\"accumulate\", {\n      fn: ({ fetch_page, allItems, cursor, hasMore }) => {\n        const response = fetch_page.output;\n        allItems.set([...allItems.value, ...response.items]);\n        cursor.set(response.nextCursor);\n        hasMore.set(!!response.nextCursor);\n        return allItems.value;\n      }\n    })\n  ]\n})\n```\n\n### Offset-Based Pagination\n\n```typescript\nnew Variables(\"state\", [\n  { key: \"allItems\", value: () => [] },\n  { key: \"page\", value: () => 0 },\n  { key: \"hasMore\", value: () => true }\n]),\n\nnew Loop(\"paginate\", {\n  type: \"TYPE_WHILE\",\n  condition: ({ hasMore }) => hasMore.value,\n  blocks: [\n    new RestApi(\"fetch_page\", \"rest-id\", {\n      method: \"GET\",\n      url: \"https://api.example.com/items\",\n      params: ({ page }) => ({\n        offset: String(page.value * 100),\n        limit: \"100\"\n      })\n    }),\n    new JavaScript(\"accumulate\", {\n      fn: ({ fetch_page, allItems, page, hasMore }) => {\n        const items = fetch_page.output.items;\n        allItems.set([...allItems.value, ...items]);\n        page.set(page.value + 1);\n        hasMore.set(items.length === 100);\n        return allItems.value;\n      }\n    })\n  ]\n})\n```\n\n## Authentication Patterns\n\n### Bearer Token\n\n```typescript\nnew RestApi(\"authenticated_call\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/secure\",\n  headers: ({ token }: { token: string }) => ({\n    \"Authorization\": `Bearer ${token}`\n  })\n})\n```\n\n### API Key\n\n```typescript\nnew RestApi(\"api_key_call\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/data\",\n  headers: ({ apiKey }: { apiKey: string }) => ({\n    \"X-API-Key\": apiKey\n  })\n})\n```\n\n### Basic Auth\n\n```typescript\nnew RestApi(\"basic_auth_call\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/data\",\n  headers: ({ username, password }: { username: string; password: string }) => ({\n    \"Authorization\": `Basic ${Buffer.from(`${username}:${password}`).toString(\"base64\")}`\n  })\n})\n```\n";
+export declare const content = "# REST API Integrations\n\nReference documentation for working with REST APIs and OpenAPI integrations in Superblocks.\n\n## REST API vs OpenAPI\n\n**Use RestApi** when:\n\n- Making calls to custom endpoints\n- No OpenAPI spec available\n- Simple GET/POST operations\n\n**Use OpenApi** when:\n\n- Integration metadata shows `spec: \"openapi\"` or `specType: \"OPEN_API_SPEC\"`\n- Working with documented APIs (Stripe, Twilio, etc.)\n- Need type-safe operations\n\n## RestApi Class\n\n```typescript\nimport { RestApi } from \"@superblocksteam/library\";\n\nnew RestApi(\"fetch_data\", \"rest-integration-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/data\",\n  params: { page: \"1\", limit: \"10\" },\n  headers: { \"X-Custom-Header\": \"value\" },\n});\n```\n\n### Dynamic Configuration\n\n```typescript\nnew RestApi(\"create_item\", \"rest-id\", {\n  method: \"POST\",\n  url: ({ baseUrl }: { baseUrl: string }) => `${baseUrl}/items`,\n  params: ({ page }: { page: number }) => ({ page: String(page) }),\n  headers: ({ authToken }: { authToken: string }) => ({\n    Authorization: `Bearer ${authToken}`,\n    \"Content-Type\": \"application/json\",\n  }),\n  body: ({ itemData }: { itemData: object }) => JSON.stringify(itemData),\n});\n```\n\n### Common REST Patterns\n\n```typescript\n// GET with query params\nnew RestApi(\"search\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/search\",\n  params: ({ query, page }: { query: string; page: number }) => ({\n    q: query,\n    page: String(page),\n    limit: \"20\",\n  }),\n});\n\n// POST with JSON body\nnew RestApi(\"create\", \"rest-id\", {\n  method: \"POST\",\n  url: \"https://api.example.com/items\",\n  headers: { \"Content-Type\": \"application/json\" },\n  body: ({ data }: { data: object }) => JSON.stringify(data),\n});\n\n// PUT for updates\nnew RestApi(\"update\", \"rest-id\", {\n  method: \"PUT\",\n  url: ({ id }: { id: string }) => `https://api.example.com/items/${id}`,\n  headers: { \"Content-Type\": \"application/json\" },\n  body: ({ data }: { data: object }) => JSON.stringify(data),\n});\n\n// DELETE\nnew RestApi(\"delete\", \"rest-id\", {\n  method: \"DELETE\",\n  url: ({ id }: { id: string }) => `https://api.example.com/items/${id}`,\n});\n```\n\n## OpenApi Class\n\n```typescript\nimport { OpenApi } from \"@superblocksteam/library\";\n\nnew OpenApi(\"list_customers\", \"stripe-integration-id\", {\n  operation: \"listCustomers\",\n  params: { limit: 10 },\n});\n```\n\n### OpenAPI Operations\n\nOperation names are defined by the API spec. Common patterns:\n\n- `list{Resource}` - List all resources\n- `get{Resource}` - Get a single resource\n- `create{Resource}` - Create a resource\n- `update{Resource}` - Update a resource\n- `delete{Resource}` - Delete a resource\n\n### Dynamic OpenAPI Params\n\n```typescript\nnew OpenApi(\"get_customer\", \"stripe-id\", {\n  operation: \"getCustomer\",\n  params: ({ customerId }: { customerId: string }) => ({\n    customer_id: customerId,\n  }),\n});\n```\n\n## Response Handling\n\nREST and OpenAPI responses are available via `.output`:\n\n```typescript\nnew RestApi(\"fetch\", \"rest-id\", { ... }),\n\nnew JavaScript(\"process\", {\n  fn: ({ fetch }) => {\n    const data = fetch.output;\n    // For REST APIs, output is typically the JSON response\n    // For OpenAPI, output structure depends on the operation\n    return data.items.map(item => item.name);\n  }\n})\n```\n\n## Error Handling\n\nHTTP errors (4xx, 5xx) are captured in the output:\n\n```typescript\nnew TryCatch(\"safe_api_call\", {\n  try: [\n    new RestApi(\"risky_call\", \"rest-id\", {\n      method: \"POST\",\n      url: \"https://api.example.com/sensitive\",\n    }),\n  ],\n  catch: [\n    new JavaScript(\"handle_error\", {\n      fn: ({ apiError }) => ({\n        success: false,\n        error: apiError.value.message,\n        statusCode: apiError.value.statusCode,\n      }),\n    }),\n  ],\n  variables: { error: \"apiError\" },\n});\n```\n\n## Pagination Patterns\n\n### Cursor-Based Pagination\n\n```typescript\n(new Variables(\"state\", [\n  { key: \"allItems\", value: () => [] },\n  { key: \"cursor\", value: () => null },\n  { key: \"hasMore\", value: () => true },\n]),\n  new Loop(\"paginate\", {\n    type: \"TYPE_FOREACH\",\n    over: () => [...Array(100).keys()],\n    variables: { item: \"_\", index: \"i\" },\n    blocks: [\n      new Conditional(\"check_done\", {\n        if: {\n          when: ({ hasMore }) => !hasMore.value,\n          then: [new Break(\"exit\", { condition: () => true })],\n        },\n      }),\n      new RestApi(\"fetch_page\", \"rest-id\", {\n        method: \"GET\",\n        url: \"https://api.example.com/items\",\n        params: ({ cursor }) => (cursor.value ? { cursor: cursor.value } : {}),\n      }),\n      new JavaScript(\"accumulate\", {\n        fn: ({ fetch_page, allItems, cursor, hasMore }) => {\n          const response = fetch_page.output;\n          allItems.set([...allItems.value, ...response.items]);\n          cursor.set(response.nextCursor);\n          hasMore.set(!!response.nextCursor);\n          return allItems.value;\n        },\n      }),\n    ],\n  }));\n```\n\n### Offset-Based Pagination\n\n```typescript\n(new Variables(\"state\", [\n  { key: \"allItems\", value: () => [] },\n  { key: \"page\", value: () => 0 },\n  { key: \"hasMore\", value: () => true },\n]),\n  new Loop(\"paginate\", {\n    type: \"TYPE_WHILE\",\n    condition: ({ hasMore }) => hasMore.value,\n    blocks: [\n      new RestApi(\"fetch_page\", \"rest-id\", {\n        method: \"GET\",\n        url: \"https://api.example.com/items\",\n        params: ({ page }) => ({\n          offset: String(page.value * 100),\n          limit: \"100\",\n        }),\n      }),\n      new JavaScript(\"accumulate\", {\n        fn: ({ fetch_page, allItems, page, hasMore }) => {\n          const items = fetch_page.output.items;\n          allItems.set([...allItems.value, ...items]);\n          page.set(page.value + 1);\n          hasMore.set(items.length === 100);\n          return allItems.value;\n        },\n      }),\n    ],\n  }));\n```\n\n## Authentication Patterns\n\n### Bearer Token\n\n```typescript\nnew RestApi(\"authenticated_call\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/secure\",\n  headers: ({ token }: { token: string }) => ({\n    Authorization: `Bearer ${token}`,\n  }),\n});\n```\n\n### API Key\n\n```typescript\nnew RestApi(\"api_key_call\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/data\",\n  headers: ({ apiKey }: { apiKey: string }) => ({\n    \"X-API-Key\": apiKey,\n  }),\n});\n```\n\n### Basic Auth\n\n```typescript\nnew RestApi(\"basic_auth_call\", \"rest-id\", {\n  method: \"GET\",\n  url: \"https://api.example.com/data\",\n  headers: ({\n    username,\n    password,\n  }: {\n    username: string;\n    password: string;\n  }) => ({\n    Authorization: `Basic ${Buffer.from(`${username}:${password}`).toString(\"base64\")}`,\n  }),\n});\n```\n";
 //# sourceMappingURL=rest-apis.generated.d.ts.map

package/dist/ai-service/skills/system/superblocks-api/references/rest-apis.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"rest-apis.generated.d.ts","sourceRoot":"","sources":["../../../../../../src/ai-service/skills/system/superblocks-api/references/rest-apis.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,4sNAyQnB,CAAC"}
+{"version":3,"file":"rest-apis.generated.d.ts","sourceRoot":"","sources":["../../../../../../src/ai-service/skills/system/superblocks-api/references/rest-apis.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,03NAgRnB,CAAC"}

package/dist/ai-service/skills/system/superblocks-api/references/rest-apis.generated.js

@@ -7,11 +7,13 @@ Reference documentation for working with REST APIs and OpenAPI integrations in S
 ## REST API vs OpenAPI
 
 **Use RestApi** when:
+
 - Making calls to custom endpoints
 - No OpenAPI spec available
 - Simple GET/POST operations
 
 **Use OpenApi** when:
+
 - Integration metadata shows \`spec: "openapi"\` or \`specType: "OPEN_API_SPEC"\`
 - Working with documented APIs (Stripe, Twilio, etc.)
 - Need type-safe operations
@@ -25,8 +27,8 @@ new RestApi("fetch_data", "rest-integration-id", {
   method: "GET",
   url: "https://api.example.com/data",
   params: { page: "1", limit: "10" },
-  headers: { "X-Custom-Header": "value" }
-})
+  headers: { "X-Custom-Header": "value" },
+});
 \`\`\`
 
 ### Dynamic Configuration
@@ -37,11 +39,11 @@ new RestApi("create_item", "rest-id", {
   url: ({ baseUrl }: { baseUrl: string }) => \`\${baseUrl}/items\`,
   params: ({ page }: { page: number }) => ({ page: String(page) }),
   headers: ({ authToken }: { authToken: string }) => ({
-    "Authorization": \`Bearer \${authToken}\`,
-    "Content-Type": "application/json"
+    Authorization: \`Bearer \${authToken}\`,
+    "Content-Type": "application/json",
   }),
-  body: ({ itemData }: { itemData: object }) => JSON.stringify(itemData)
-})
+  body: ({ itemData }: { itemData: object }) => JSON.stringify(itemData),
+});
 \`\`\`
 
 ### Common REST Patterns
@@ -54,31 +56,31 @@ new RestApi("search", "rest-id", {
   params: ({ query, page }: { query: string; page: number }) => ({
     q: query,
     page: String(page),
-    limit: "20"
-  })
-})
+    limit: "20",
+  }),
+});
 
 // POST with JSON body
 new RestApi("create", "rest-id", {
   method: "POST",
   url: "https://api.example.com/items",
   headers: { "Content-Type": "application/json" },
-  body: ({ data }: { data: object }) => JSON.stringify(data)
-})
+  body: ({ data }: { data: object }) => JSON.stringify(data),
+});
 
 // PUT for updates
 new RestApi("update", "rest-id", {
   method: "PUT",
   url: ({ id }: { id: string }) => \`https://api.example.com/items/\${id}\`,
   headers: { "Content-Type": "application/json" },
-  body: ({ data }: { data: object }) => JSON.stringify(data)
-})
+  body: ({ data }: { data: object }) => JSON.stringify(data),
+});
 
 // DELETE
 new RestApi("delete", "rest-id", {
   method: "DELETE",
-  url: ({ id }: { id: string }) => \`https://api.example.com/items/\${id}\`
-})
+  url: ({ id }: { id: string }) => \`https://api.example.com/items/\${id}\`,
+});
 \`\`\`
 
 ## OpenApi Class
@@ -88,13 +90,14 @@ import { OpenApi } from "@superblocksteam/library";
 
 new OpenApi("list_customers", "stripe-integration-id", {
   operation: "listCustomers",
-  params: { limit: 10 }
-})
+  params: { limit: 10 },
+});
 \`\`\`
 
 ### OpenAPI Operations
 
 Operation names are defined by the API spec. Common patterns:
+
 - \`list{Resource}\` - List all resources
 - \`get{Resource}\` - Get a single resource
 - \`create{Resource}\` - Create a resource
@@ -107,9 +110,9 @@ Operation names are defined by the API spec. Common patterns:
 new OpenApi("get_customer", "stripe-id", {
   operation: "getCustomer",
   params: ({ customerId }: { customerId: string }) => ({
-    customer_id: customerId
-  })
-})
+    customer_id: customerId,
+  }),
+});
 \`\`\`
 
 ## Response Handling
@@ -138,20 +141,20 @@ new TryCatch("safe_api_call", {
   try: [
     new RestApi("risky_call", "rest-id", {
       method: "POST",
-      url: "https://api.example.com/sensitive"
-    })
+      url: "https://api.example.com/sensitive",
+    }),
   ],
   catch: [
     new JavaScript("handle_error", {
       fn: ({ apiError }) => ({
         success: false,
         error: apiError.value.message,
-        statusCode: apiError.value.statusCode
-      })
-    })
+        statusCode: apiError.value.statusCode,
+      }),
+    }),
   ],
-  variables: { error: "apiError" }
-})
+  variables: { error: "apiError" },
+});
 \`\`\`
 
 ## Pagination Patterns
@@ -159,73 +162,71 @@ new TryCatch("safe_api_call", {
 ### Cursor-Based Pagination
 
 \`\`\`typescript
-new Variables("state", [
+(new Variables("state", [
   { key: "allItems", value: () => [] },
   { key: "cursor", value: () => null },
-  { key: "hasMore", value: () => true }
+  { key: "hasMore", value: () => true },
 ]),
-
-new Loop("paginate", {
-  type: "TYPE_FOREACH",
-  over: () => [...Array(100).keys()],
-  variables: { item: "_", index: "i" },
-  blocks: [
-    new Conditional("check_done", {
-      if: {
-        when: ({ hasMore }) => !hasMore.value,
-        then: [new Break("exit", { condition: () => true })]
-      }
-    }),
-    new RestApi("fetch_page", "rest-id", {
-      method: "GET",
-      url: "https://api.example.com/items",
-      params: ({ cursor }) => cursor.value ? { cursor: cursor.value } : {}
-    }),
-    new JavaScript("accumulate", {
-      fn: ({ fetch_page, allItems, cursor, hasMore }) => {
-        const response = fetch_page.output;
-        allItems.set([...allItems.value, ...response.items]);
-        cursor.set(response.nextCursor);
-        hasMore.set(!!response.nextCursor);
-        return allItems.value;
-      }
-    })
-  ]
-})
+  new Loop("paginate", {
+    type: "TYPE_FOREACH",
+    over: () => [...Array(100).keys()],
+    variables: { item: "_", index: "i" },
+    blocks: [
+      new Conditional("check_done", {
+        if: {
+          when: ({ hasMore }) => !hasMore.value,
+          then: [new Break("exit", { condition: () => true })],
+        },
+      }),
+      new RestApi("fetch_page", "rest-id", {
+        method: "GET",
+        url: "https://api.example.com/items",
+        params: ({ cursor }) => (cursor.value ? { cursor: cursor.value } : {}),
+      }),
+      new JavaScript("accumulate", {
+        fn: ({ fetch_page, allItems, cursor, hasMore }) => {
+          const response = fetch_page.output;
+          allItems.set([...allItems.value, ...response.items]);
+          cursor.set(response.nextCursor);
+          hasMore.set(!!response.nextCursor);
+          return allItems.value;
+        },
+      }),
+    ],
+  }));
 \`\`\`
 
 ### Offset-Based Pagination
 
 \`\`\`typescript
-new Variables("state", [
+(new Variables("state", [
   { key: "allItems", value: () => [] },
   { key: "page", value: () => 0 },
-  { key: "hasMore", value: () => true }
+  { key: "hasMore", value: () => true },
 ]),
-
-new Loop("paginate", {
-  type: "TYPE_WHILE",
-  condition: ({ hasMore }) => hasMore.value,
-  blocks: [
-    new RestApi("fetch_page", "rest-id", {
-      method: "GET",
-      url: "https://api.example.com/items",
-      params: ({ page }) => ({
-        offset: String(page.value * 100),
-        limit: "100"
-      })
-    }),
-    new JavaScript("accumulate", {
-      fn: ({ fetch_page, allItems, page, hasMore }) => {
-        const items = fetch_page.output.items;
-        allItems.set([...allItems.value, ...items]);
-        page.set(page.value + 1);
-        hasMore.set(items.length === 100);
-        return allItems.value;
-      }
-    })
-  ]
-})
+  new Loop("paginate", {
+    type: "TYPE_WHILE",
+    condition: ({ hasMore }) => hasMore.value,
+    blocks: [
+      new RestApi("fetch_page", "rest-id", {
+        method: "GET",
+        url: "https://api.example.com/items",
+        params: ({ page }) => ({
+          offset: String(page.value * 100),
+          limit: "100",
+        }),
+      }),
+      new JavaScript("accumulate", {
+        fn: ({ fetch_page, allItems, page, hasMore }) => {
+          const items = fetch_page.output.items;
+          allItems.set([...allItems.value, ...items]);
+          page.set(page.value + 1);
+          hasMore.set(items.length === 100);
+          return allItems.value;
+        },
+      }),
+    ],
+  }));
 \`\`\`
 
 ## Authentication Patterns
@@ -237,9 +238,9 @@ new RestApi("authenticated_call", "rest-id", {
   method: "GET",
   url: "https://api.example.com/secure",
   headers: ({ token }: { token: string }) => ({
-    "Authorization": \`Bearer \${token}\`
-  })
-})
+    Authorization: \`Bearer \${token}\`,
+  }),
+});
 \`\`\`
 
 ### API Key
@@ -249,9 +250,9 @@ new RestApi("api_key_call", "rest-id", {
   method: "GET",
   url: "https://api.example.com/data",
   headers: ({ apiKey }: { apiKey: string }) => ({
-    "X-API-Key": apiKey
-  })
-})
+    "X-API-Key": apiKey,
+  }),
+});
 \`\`\`
 
 ### Basic Auth
@@ -260,10 +261,16 @@ new RestApi("api_key_call", "rest-id", {
 new RestApi("basic_auth_call", "rest-id", {
   method: "GET",
   url: "https://api.example.com/data",
-  headers: ({ username, password }: { username: string; password: string }) => ({
-    "Authorization": \`Basic \${Buffer.from(\`\${username}:\${password}\`).toString("base64")}\`
-  })
-})
+  headers: ({
+    username,
+    password,
+  }: {
+    username: string;
+    password: string;
+  }) => ({
+    Authorization: \`Basic \${Buffer.from(\`\${username}:\${password}\`).toString("base64")}\`,
+  }),
+});
 \`\`\`
 `;
 //# sourceMappingURL=rest-apis.generated.js.map

package/dist/ai-service/skills/system/superblocks-api/references/rest-apis.generated.js.map

@@ -1 +1 @@
-{"version":3,"file":"rest-apis.generated.js","sourceRoot":"","sources":["../../../../../../src/ai-service/skills/system/superblocks-api/references/rest-apis.generated.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,mDAAmD;AAEnD,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAyQtB,CAAC"}
+{"version":3,"file":"rest-apis.generated.js","sourceRoot":"","sources":["../../../../../../src/ai-service/skills/system/superblocks-api/references/rest-apis.generated.ts"],"names":[],"mappings":"AAAA,2FAA2F;AAC3F,mDAAmD;AAEnD,MAAM,CAAC,MAAM,OAAO,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgRtB,CAAC"}

package/dist/ai-service/skills/system/superblocks-api/references/sql-databases.generated.d.ts

@@ -1,2 +1,2 @@
-export declare const content = "# SQL Database Integrations\n\nReference documentation for working with SQL databases in Superblocks APIs.\n\n## Supported Databases\n\n- PostgreSQL, MySQL, MariaDB, MSSQL\n- Snowflake, Redshift, BigQuery, Athena\n- Databricks, SingleStore, Lakebase\n- CockroachDB, YugabyteDB, OracleDB\n\n## SQL Block Classes\n\n```typescript\n// Available SQL integrations\nimport {\n  PostgreSQL,\n  MySQL,\n  MariaDB,\n  MSSQL,\n  Snowflake,\n  Redshift,\n  BigQuery,\n  Athena,\n  Databricks,\n  SingleStore,\n  OracleDB,\n} from \"@superblocksteam/library\";\n```\n\n## Basic Usage\n\n```typescript\nnew PostgreSQL(\"get_users\", \"postgres-integration-id\", {\n  statement: \"SELECT * FROM users WHERE active = true LIMIT 100\"\n})\n```\n\n## Parameterized Queries\n\n### SQL Security Priority\n\n**ALWAYS prefer parameterized queries over string interpolation for user input values.**\n\nUse `parameters: \"[var1, var2]\"` with the database-specific SQL placeholders:\n\n| Database | Placeholder Syntax | Example |\n|----------|-------------------|---------|\n| PostgreSQL, Redshift, CockroachDB | `$1`, `$2`, `$3` | `WHERE id = $1 AND status = $2` |\n| MySQL, MariaDB, Snowflake, BigQuery, Athena | `?`, `?`, `?` | `WHERE id = ? AND status = ?` |\n| MSSQL | `@PARAM_1`, `@PARAM_2` | `WHERE id = @PARAM_1 AND status = @PARAM_2` |\n| Databricks | `:PARAM_1`, `:PARAM_2` | `WHERE id = :PARAM_1 AND status = :PARAM_2` |\n| OracleDB | `:1`, `:2`, `:3` | `WHERE id = :1 AND status = :2` |\n\nOnly use binding functions for truly dynamic SQL elements like table/column names.\n\n### Parameters Syntax vs Statement Syntax\n\n**Important:** `parameters` is a JavaScript expression string that gets evaluated directly. Do NOT use `${}` interpolation or binding functions.\n\n```typescript\n// \u274C WRONG - Don't use ${} interpolation in parameters\nparameters: \"[${build_query.output.userId}, ${searchTerm}]\"\n\n// \u274C WRONG - Don't use binding functions for parameters  \nparameters: ({ build_query }) => JSON.stringify(build_query.output.params)\n\n// \u2705 CORRECT - Write expressions directly (they get evaluated as JS)\nparameters: \"[build_query.output.userId, searchTerm, limit]\"\n\n// \u2705 CORRECT - Reference block output array directly\nparameters: \"build_query.output.params\"\n```\n\nThis is different from `statement`, where binding functions with `${}` ARE used to interpolate values into SQL.\n\n### String Interpolation (Alternative)\n\nFor simpler cases, string interpolation also works:\n\n```typescript\n// \u2705 CORRECT - String interpolation for WHERE clauses\nnew PostgreSQL(\"search\", \"postgres-id\", {\n  statement: ({ searchTerm, limit }: { searchTerm: string; limit: number }) =>\n    `SELECT * FROM users WHERE name ILIKE '%${searchTerm}%' LIMIT ${limit}`\n})\n\n// \u2705 CORRECT - For INSERT statements\nnew PostgreSQL(\"insert_user\", \"postgres-id\", {\n  statement: ({ name, email }: { name: string; email: string }) =>\n    `INSERT INTO users (name, email) VALUES ('${name}', '${email}') RETURNING *`\n})\n```\n\n### Dynamic SQL with Optional Filters\n\nUse the `parameters` array with the \"OR NULL\" pattern for optional filters:\n- `WHERE (column = $1 OR $1::type IS NULL)` makes the condition a no-op when parameter is null\n- Cast parameters to their type when checking for NULL (PostgreSQL can't infer types from NULL values)\n- Always pass all parameters, using null for unused filters\n- NEVER interpolate user values directly into SQL strings\n\n## Best Practices\n\n### 1. ONE Query Per Block Rule\n\nEach SQL block (PostgreSQL, Snowflake, MySQL, MicrosoftSql, Databricks) can execute **ONLY ONE SQL query**.\n\n\u274C **WRONG - Multiple queries in one block:**\n```sql\nUPDATE users SET status = 'active';\nDELETE FROM logs WHERE created < '2023-01-01';\nINSERT INTO audit VALUES ('done');\n```\n\n\u2705 **CORRECT - One query per block:**\n```typescript\nnew PostgreSQL(\"update_status\", \"postgres-id\", {\n  statement: \"UPDATE users SET status = 'active'\"\n}),\nnew PostgreSQL(\"clean_logs\", \"postgres-id\", {\n  statement: \"DELETE FROM logs WHERE created < '2023-01-01'\"\n})\n```\n\n### 2. Use Meaningful Block Names\n\n```typescript\n// \u2705 GOOD\nnew PostgreSQL(\"fetch_active_users\", \"pg-id\", { ... })\nnew PostgreSQL(\"insert_order_item\", \"pg-id\", { ... })\n\n// \u274C BAD\nnew PostgreSQL(\"query1\", \"pg-id\", { ... })\nnew PostgreSQL(\"sql\", \"pg-id\", { ... })\n```\n\n### 3. Always Specify Columns\n\n```typescript\n// \u2705 PREFERRED - Explicit columns\nSELECT id, name, email, created_at FROM users\n\n// \u26A0\uFE0F AVOID - Select all\nSELECT * FROM users\n```\n\n### 4. Always Add Defensive Row Limits\n\nAlways include a row limit clause to prevent runaway queries. Use 100 as the default unless user specifies otherwise.\n\nDifferent SQL dialects have different syntax:\n- **MySQL/PostgreSQL/SQLite**: `LIMIT N`\n- **SQL Server**: `SELECT TOP N`\n- **ANSI SQL (SQL Server, Oracle, DB2)**: `OFFSET 0 ROWS FETCH NEXT N ROWS ONLY`\n\n```sql\n-- \u2705 PostgreSQL/MySQL\nSELECT * FROM orders ORDER BY created_at DESC LIMIT 100;\n\n-- \u2705 SQL Server\nSELECT TOP 100 * FROM orders ORDER BY created_at DESC;\n\n-- \u2705 ANSI SQL (SQL Server with ORDER BY)\nSELECT * FROM orders ORDER BY created_at DESC OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;\n\n-- \u274C Avoid unlimited queries\nSELECT * FROM orders ORDER BY created_at DESC;  -- Can timeout or crash\n```\n\n### 5. Sort, Don't Filter by Date (Default)\n\nDo NOT add automatic date filters (e.g., \"last 90 days\") unless the user explicitly requests them. This is a common cause of unexpected empty SQL results.\n\n```sql\n-- \u2705 Default approach\nSELECT * FROM orders ORDER BY created_at DESC LIMIT 100;\n\n-- \u274C Avoid automatic filtering\nSELECT * FROM orders WHERE created_at >= CURRENT_DATE - INTERVAL '90 days';  -- Can return empty results\n```\n\nOnly add date WHERE clauses when users explicitly ask for time-based filtering.\n\n### 6. Handle NULL Values\n\n```typescript\n// \u2705 Use COALESCE for default values\nSELECT COALESCE(description, 'No description') as description FROM products\n\n// \u2705 Use IS NULL / IS NOT NULL\nSELECT * FROM users WHERE deleted_at IS NULL\n```\n\n## Database-Specific Notes\n\n### PostgreSQL\n\n```typescript\n// Array operations\nnew PostgreSQL(\"array_query\", \"pg-id\", {\n  statement: ({ tags }: { tags: string[] }) =>\n    `SELECT * FROM posts WHERE tags && ARRAY[${tags.map(t => `'${t}'`).join(',')}]`\n})\n\n// JSON operations\nnew PostgreSQL(\"json_query\", \"pg-id\", {\n  statement: \"SELECT data->>'name' as name FROM json_data\"\n})\n```\n\n- Use schema-qualified names: `schema.table` or `\"schema\".\"table\"`\n- Case sensitivity: Unquoted identifiers are lowercase\n- Use `::type` for type casting\n\n### Snowflake\n\n```typescript\n// Use QUALIFY for window function filtering\nnew Snowflake(\"ranked_query\", \"snowflake-id\", {\n  statement: `\n    SELECT *, ROW_NUMBER() OVER (PARTITION BY category ORDER BY sales DESC) as rank\n    FROM products\n    QUALIFY rank <= 3\n  `\n})\n```\n\n**Snowflake Two-Part Naming:** Snowflake uses `schema.table`\n\nWhen you see Snowflake metadata where tables have a `schema` property, **you MUST qualify table names**:\n\n```sql\n-- If table has schema property \"MASTERDATA\"\nSELECT * FROM MASTERDATA.PRODUCTLINE  -- \u2705 Fully qualified\nSELECT * FROM PRODUCTLINE             -- \u274C Will fail if no default schema\n```\n\n**Rule**: If a table object has a non-empty `schema` property, use `{schema}.{name}` format in your SQL queries.\n\n### Databricks\n\n**Databricks Three-Part Naming:** Databricks uses `catalog.schema.table`\n\nWhen you see Databricks metadata like:\n- `uber.default.orders` - Use the FULL path: `uber.default.orders`\n- `production.analytics.users` - Use: `production.analytics.users`\n\n```sql\n-- Metadata shows: uber.default.orders\nSELECT * FROM uber.default.orders     -- \u2705 Full path\nSELECT * FROM uber.orders            -- \u274C Missing schema part\nSELECT * FROM orders                 -- \u274C Missing catalog and schema\n```\n\n**Note:** The word \"default\" in Databricks paths is NOT optional - it's the actual schema name. Always include all three parts exactly as shown in the metadata.\n\n### BigQuery\n\n```typescript\n// Use backticks for table names\nnew BigQuery(\"query\", \"bq-id\", {\n  statement: \"SELECT * FROM \\`project.dataset.table\\` LIMIT 100\"\n})\n```\n\n## Common Patterns\n\n### Pagination\n\n```typescript\nnew PostgreSQL(\"paginated_fetch\", \"pg-id\", {\n  statement: ({ page, pageSize }: { page: number; pageSize: number }) =>\n    `SELECT * FROM orders ORDER BY created_at DESC LIMIT ${pageSize} OFFSET ${(page - 1) * pageSize}`\n})\n```\n\n### Search with Multiple Conditions\n\n```typescript\nnew PostgreSQL(\"advanced_search\", \"pg-id\", {\n  statement: ({ name, status, minAmount }: { name?: string; status?: string; minAmount?: number }) => {\n    const conditions = [\"1=1\"];\n    if (name) conditions.push(`name ILIKE '%${name}%'`);\n    if (status) conditions.push(`status = '${status}'`);\n    if (minAmount !== undefined) conditions.push(`amount >= ${minAmount}`);\n    return `SELECT * FROM orders WHERE ${conditions.join(\" AND \")} LIMIT 100`;\n  }\n})\n```\n\n### Batch Insert\n\n```typescript\nnew PostgreSQL(\"batch_insert\", \"pg-id\", {\n  statement: ({ items }: { items: Array<{ name: string; value: number }> }) => {\n    const values = items\n      .map(item => `('${item.name}', ${item.value})`)\n      .join(\", \");\n    return `INSERT INTO items (name, value) VALUES ${values} RETURNING *`;\n  }\n})\n```\n\n### Upsert (Insert or Update)\n\n```typescript\n// PostgreSQL\nnew PostgreSQL(\"upsert_user\", \"pg-id\", {\n  statement: ({ id, name, email }: { id: string; name: string; email: string }) =>\n    `INSERT INTO users (id, name, email) \n     VALUES ('${id}', '${name}', '${email}')\n     ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name, email = EXCLUDED.email\n     RETURNING *`\n})\n```\n\n## Error Handling\n\nSQL errors are returned in the block's output. Common errors:\n- Syntax errors in SQL\n- Table/column doesn't exist\n- Constraint violations\n- Connection timeouts\n\nFor critical operations, wrap in TryCatch:\n\n```typescript\nnew TryCatch(\"safe_delete\", {\n  try: [\n    new PostgreSQL(\"delete_record\", \"pg-id\", {\n      statement: ({ id }: { id: string }) => `DELETE FROM sensitive_data WHERE id = '${id}'`\n    })\n  ],\n  catch: [\n    new JavaScript(\"log_error\", {\n      fn: ({ deleteError }) => ({\n        success: false,\n        error: deleteError.value.message\n      })\n    })\n  ],\n  variables: { error: \"deleteError\" }\n})\n```\n";
+export declare const content = "# SQL Database Integrations\n\nReference documentation for working with SQL databases in Superblocks APIs.\n\n## Supported Databases\n\n- PostgreSQL, MySQL, MariaDB, MSSQL\n- Snowflake, Redshift, BigQuery, Athena\n- Databricks, SingleStore, Lakebase\n- CockroachDB, YugabyteDB, OracleDB\n\n## SQL Block Classes\n\n```typescript\n// Available SQL integrations\nimport {\n  PostgreSQL,\n  MySQL,\n  MariaDB,\n  MSSQL,\n  Snowflake,\n  Redshift,\n  BigQuery,\n  Athena,\n  Databricks,\n  SingleStore,\n  OracleDB,\n} from \"@superblocksteam/library\";\n```\n\n## Basic Usage\n\n```typescript\nnew PostgreSQL(\"get_users\", \"postgres-integration-id\", {\n  statement: \"SELECT * FROM users WHERE active = true LIMIT 100\",\n});\n```\n\n## Parameterized Queries\n\n### SQL Security Priority\n\n**ALWAYS prefer parameterized queries over string interpolation for user input values.**\n\nUse `parameters: \"[var1, var2]\"` with the database-specific SQL placeholders:\n\n| Database                                    | Placeholder Syntax     | Example                                     |\n| ------------------------------------------- | ---------------------- | ------------------------------------------- |\n| PostgreSQL, Redshift, CockroachDB           | `$1`, `$2`, `$3`       | `WHERE id = $1 AND status = $2`             |\n| MySQL, MariaDB, Snowflake, BigQuery, Athena | `?`, `?`, `?`          | `WHERE id = ? AND status = ?`               |\n| MSSQL                                       | `@PARAM_1`, `@PARAM_2` | `WHERE id = @PARAM_1 AND status = @PARAM_2` |\n| Databricks                                  | `:PARAM_1`, `:PARAM_2` | `WHERE id = :PARAM_1 AND status = :PARAM_2` |\n| OracleDB                                    | `:1`, `:2`, `:3`       | `WHERE id = :1 AND status = :2`             |\n\nOnly use binding functions for truly dynamic SQL elements like table/column names.\n\n### Parameters Syntax vs Statement Syntax\n\n**Important:** `parameters` is a JavaScript expression string that gets evaluated directly. Do NOT use `${}` interpolation or binding functions.\n\n```typescript\n// \u274C WRONG - Don't use ${} interpolation in parameters\nparameters: \"[${build_query.output.userId}, ${searchTerm}]\";\n\n// \u274C WRONG - Don't use binding functions for parameters\nparameters: ({ build_query }) => JSON.stringify(build_query.output.params);\n\n// \u2705 CORRECT - Write expressions directly (they get evaluated as JS)\nparameters: \"[build_query.output.userId, searchTerm, limit]\";\n\n// \u2705 CORRECT - Reference block output array directly\nparameters: \"build_query.output.params\";\n```\n\nThis is different from `statement`, where binding functions with `${}` ARE used to interpolate values into SQL.\n\n### String Interpolation (Alternative)\n\nFor simpler cases, string interpolation also works:\n\n```typescript\n// \u2705 CORRECT - String interpolation for WHERE clauses\nnew PostgreSQL(\"search\", \"postgres-id\", {\n  statement: ({ searchTerm, limit }: { searchTerm: string; limit: number }) =>\n    `SELECT * FROM users WHERE name ILIKE '%${searchTerm}%' LIMIT ${limit}`,\n});\n\n// \u2705 CORRECT - For INSERT statements\nnew PostgreSQL(\"insert_user\", \"postgres-id\", {\n  statement: ({ name, email }: { name: string; email: string }) =>\n    `INSERT INTO users (name, email) VALUES ('${name}', '${email}') RETURNING *`,\n});\n```\n\n### Dynamic SQL with Optional Filters\n\nUse the `parameters` array with the \"OR NULL\" pattern for optional filters:\n\n- `WHERE (column = $1 OR $1::type IS NULL)` makes the condition a no-op when parameter is null\n- Cast parameters to their type when checking for NULL (PostgreSQL can't infer types from NULL values)\n- Always pass all parameters, using null for unused filters\n- NEVER interpolate user values directly into SQL strings\n\n## Best Practices\n\n### 1. ONE Query Per Block Rule\n\nEach SQL block (PostgreSQL, Snowflake, MySQL, MicrosoftSql, Databricks) can execute **ONLY ONE SQL query**.\n\n\u274C **WRONG - Multiple queries in one block:**\n\n```sql\nUPDATE users SET status = 'active';\nDELETE FROM logs WHERE created < '2023-01-01';\nINSERT INTO audit VALUES ('done');\n```\n\n\u2705 **CORRECT - One query per block:**\n\n```typescript\n(new PostgreSQL(\"update_status\", \"postgres-id\", {\n  statement: \"UPDATE users SET status = 'active'\",\n}),\n  new PostgreSQL(\"clean_logs\", \"postgres-id\", {\n    statement: \"DELETE FROM logs WHERE created < '2023-01-01'\",\n  }));\n```\n\n### 2. Use Meaningful Block Names\n\n```typescript\n// \u2705 GOOD\nnew PostgreSQL(\"fetch_active_users\", \"pg-id\", { ... })\nnew PostgreSQL(\"insert_order_item\", \"pg-id\", { ... })\n\n// \u274C BAD\nnew PostgreSQL(\"query1\", \"pg-id\", { ... })\nnew PostgreSQL(\"sql\", \"pg-id\", { ... })\n```\n\n### 3. Always Specify Columns\n\n```typescript\n// \u2705 PREFERRED - Explicit columns\nSELECT id, name, email, created_at FROM users\n\n// \u26A0\uFE0F AVOID - Select all\nSELECT * FROM users\n```\n\n### 4. Always Add Defensive Row Limits\n\nAlways include a row limit clause to prevent runaway queries. Use 100 as the default unless user specifies otherwise.\n\nDifferent SQL dialects have different syntax:\n\n- **MySQL/PostgreSQL/SQLite**: `LIMIT N`\n- **SQL Server**: `SELECT TOP N`\n- **ANSI SQL (SQL Server, Oracle, DB2)**: `OFFSET 0 ROWS FETCH NEXT N ROWS ONLY`\n\n```sql\n-- \u2705 PostgreSQL/MySQL\nSELECT * FROM orders ORDER BY created_at DESC LIMIT 100;\n\n-- \u2705 SQL Server\nSELECT TOP 100 * FROM orders ORDER BY created_at DESC;\n\n-- \u2705 ANSI SQL (SQL Server with ORDER BY)\nSELECT * FROM orders ORDER BY created_at DESC OFFSET 0 ROWS FETCH NEXT 100 ROWS ONLY;\n\n-- \u274C Avoid unlimited queries\nSELECT * FROM orders ORDER BY created_at DESC;  -- Can timeout or crash\n```\n\n### 5. Sort, Don't Filter by Date (Default)\n\nDo NOT add automatic date filters (e.g., \"last 90 days\") unless the user explicitly requests them. This is a common cause of unexpected empty SQL results.\n\n```sql\n-- \u2705 Default approach\nSELECT * FROM orders ORDER BY created_at DESC LIMIT 100;\n\n-- \u274C Avoid automatic filtering\nSELECT * FROM orders WHERE created_at >= CURRENT_DATE - INTERVAL '90 days';  -- Can return empty results\n```\n\nOnly add date WHERE clauses when users explicitly ask for time-based filtering.\n\n### 6. Handle NULL Values\n\n```typescript\n// \u2705 Use COALESCE for default values\nSELECT COALESCE(description, 'No description') as description FROM products\n\n// \u2705 Use IS NULL / IS NOT NULL\nSELECT * FROM users WHERE deleted_at IS NULL\n```\n\n## Database-Specific Notes\n\n### PostgreSQL\n\n```typescript\n// Array operations\nnew PostgreSQL(\"array_query\", \"pg-id\", {\n  statement: ({ tags }: { tags: string[] }) =>\n    `SELECT * FROM posts WHERE tags && ARRAY[${tags.map((t) => `'${t}'`).join(\",\")}]`,\n});\n\n// JSON operations\nnew PostgreSQL(\"json_query\", \"pg-id\", {\n  statement: \"SELECT data->>'name' as name FROM json_data\",\n});\n```\n\n- Use schema-qualified names: `schema.table` or `\"schema\".\"table\"`\n- Case sensitivity: Unquoted identifiers are lowercase\n- Use `::type` for type casting\n\n### Snowflake\n\n```typescript\n// Use QUALIFY for window function filtering\nnew Snowflake(\"ranked_query\", \"snowflake-id\", {\n  statement: `\n    SELECT *, ROW_NUMBER() OVER (PARTITION BY category ORDER BY sales DESC) as rank\n    FROM products\n    QUALIFY rank <= 3\n  `,\n});\n```\n\n**Snowflake Two-Part Naming:** Snowflake uses `schema.table`\n\nWhen you see Snowflake metadata where tables have a `schema` property, **you MUST qualify table names**:\n\n```sql\n-- If table has schema property \"MASTERDATA\"\nSELECT * FROM MASTERDATA.PRODUCTLINE  -- \u2705 Fully qualified\nSELECT * FROM PRODUCTLINE             -- \u274C Will fail if no default schema\n```\n\n**Rule**: If a table object has a non-empty `schema` property, use `{schema}.{name}` format in your SQL queries.\n\n### Databricks\n\n**Databricks Three-Part Naming:** Databricks uses `catalog.schema.table`\n\nWhen you see Databricks metadata like:\n\n- `uber.default.orders` - Use the FULL path: `uber.default.orders`\n- `production.analytics.users` - Use: `production.analytics.users`\n\n```sql\n-- Metadata shows: uber.default.orders\nSELECT * FROM uber.default.orders     -- \u2705 Full path\nSELECT * FROM uber.orders            -- \u274C Missing schema part\nSELECT * FROM orders                 -- \u274C Missing catalog and schema\n```\n\n**Note:** The word \"default\" in Databricks paths is NOT optional - it's the actual schema name. Always include all three parts exactly as shown in the metadata.\n\n### BigQuery\n\n```typescript\n// Use backticks for table names\nnew BigQuery(\"query\", \"bq-id\", {\n  statement: \"SELECT * FROM \\`project.dataset.table\\` LIMIT 100\",\n});\n```\n\n## Common Patterns\n\n### Pagination\n\n```typescript\nnew PostgreSQL(\"paginated_fetch\", \"pg-id\", {\n  statement: ({ page, pageSize }: { page: number; pageSize: number }) =>\n    `SELECT * FROM orders ORDER BY created_at DESC LIMIT ${pageSize} OFFSET ${(page - 1) * pageSize}`,\n});\n```\n\n### Search with Multiple Conditions\n\n```typescript\nnew PostgreSQL(\"advanced_search\", \"pg-id\", {\n  statement: ({\n    name,\n    status,\n    minAmount,\n  }: {\n    name?: string;\n    status?: string;\n    minAmount?: number;\n  }) => {\n    const conditions = [\"1=1\"];\n    if (name) conditions.push(`name ILIKE '%${name}%'`);\n    if (status) conditions.push(`status = '${status}'`);\n    if (minAmount !== undefined) conditions.push(`amount >= ${minAmount}`);\n    return `SELECT * FROM orders WHERE ${conditions.join(\" AND \")} LIMIT 100`;\n  },\n});\n```\n\n### Batch Insert\n\n```typescript\nnew PostgreSQL(\"batch_insert\", \"pg-id\", {\n  statement: ({ items }: { items: Array<{ name: string; value: number }> }) => {\n    const values = items\n      .map((item) => `('${item.name}', ${item.value})`)\n      .join(\", \");\n    return `INSERT INTO items (name, value) VALUES ${values} RETURNING *`;\n  },\n});\n```\n\n### Upsert (Insert or Update)\n\n```typescript\n// PostgreSQL\nnew PostgreSQL(\"upsert_user\", \"pg-id\", {\n  statement: ({\n    id,\n    name,\n    email,\n  }: {\n    id: string;\n    name: string;\n    email: string;\n  }) =>\n    `INSERT INTO users (id, name, email) \n     VALUES ('${id}', '${name}', '${email}')\n     ON CONFLICT (id) DO UPDATE SET name = EXCLUDED.name, email = EXCLUDED.email\n     RETURNING *`,\n});\n```\n\n## Error Handling\n\nSQL errors are returned in the block's output. Common errors:\n\n- Syntax errors in SQL\n- Table/column doesn't exist\n- Constraint violations\n- Connection timeouts\n\nFor critical operations, wrap in TryCatch:\n\n```typescript\nnew TryCatch(\"safe_delete\", {\n  try: [\n    new PostgreSQL(\"delete_record\", \"pg-id\", {\n      statement: ({ id }: { id: string }) =>\n        `DELETE FROM sensitive_data WHERE id = '${id}'`,\n    }),\n  ],\n  catch: [\n    new JavaScript(\"log_error\", {\n      fn: ({ deleteError }) => ({\n        success: false,\n        error: deleteError.value.message,\n      }),\n    }),\n  ],\n  variables: { error: \"deleteError\" },\n});\n```\n";
 //# sourceMappingURL=sql-databases.generated.d.ts.map

package/dist/ai-service/skills/system/superblocks-api/references/sql-databases.generated.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sql-databases.generated.d.ts","sourceRoot":"","sources":["../../../../../../src/ai-service/skills/system/superblocks-api/references/sql-databases.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,w+UAyVnB,CAAC"}
+{"version":3,"file":"sql-databases.generated.d.ts","sourceRoot":"","sources":["../../../../../../src/ai-service/skills/system/superblocks-api/references/sql-databases.generated.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,+7VAgXnB,CAAC"}