@superblocksteam/vite-plugin-file-sync 2.0.37-next.23 → 2.0.37-next.25

package/dist/ai-service/state-machine/handlers/simple-prompt-builder.js

@@ -854,6 +854,109 @@ To have the API run when the page loads, use the onLoad property on Page.
 \`\`\`
 
 </using_apis>
+
+<api_state_updates>
+## 🚨 CRITICAL: Frontend/Backend Separation for State Updates
+
+**APIs are backend workflows that can only READ state. State mutations MUST happen on the frontend through EventFlow.**
+
+### The Rule:
+- **Backend (API files)**: Read state, process data, return results
+- **Frontend (scope.ts/pages)**: Update state based on API results using onSuccess/onError handlers
+- **Other frontend state updates**: Can happen anywhere via EventFlow (button clicks, input changes, etc.)
+
+### ❌ WRONG: APIs CANNOT set state variables
+APIs cannot modify StateVars or component properties. They only return data.
+
+### ✅ CORRECT: For API-triggered state updates, use onSuccess/onError handlers in scope
+When registering APIs in the scope file, use onSuccess/onError to handle state updates based on API results:
+
+\`\`\`tsx
+// In scope.ts - registering the API with state update handlers
+export const Page1Scope = registerScope("Page1", {
+  // ... other entities ...
+
+  createUserApi: {
+    onSuccess: EventFlow.runJS(({ createUserApi }) => {
+      // Update state based on API response
+      userNameVar.value = createUserApi.response.name;
+      userListVar.value = [...userListVar.value, createUserApi.response];
+      isLoadingVar.value = false;
+      CreateUserDialog.isOpen = false;
+
+      toast.success("User created successfully!");
+    }),
+    onError: EventFlow.runJS(() => {
+      isLoadingVar.value = false;
+      toast.error("Failed to create user");
+    })
+  },
+
+  fetchDataApi: {
+    onSuccess: EventFlow.setStateVar(dataVar, {
+      value: computed(() => fetchDataApi.response)
+    })
+  }
+});
+\`\`\`
+
+### Common Patterns:
+
+**Loading states:**
+\`\`\`tsx
+// In scope.ts
+searchApi: {
+  onSuccess: EventFlow.runJS(({ searchApi }) => {
+    searchResultsVar.value = searchApi.response;
+    isSearchingVar.value = false;
+  }),
+  onError: EventFlow.runJS(() => {
+    isSearchingVar.value = false;
+    searchResultsVar.value = [];
+  })
+}
+
+// In page - set loading state before API call
+<Button onClick={EventFlow
+  .setStateVar(isSearchingVar, { value: true })
+  .runApis([searchApi])
+} />
+\`\`\`
+
+**Form submissions:**
+\`\`\`tsx
+// In scope.ts
+submitFormApi: {
+  onSuccess: EventFlow
+    .runJS(({ submitFormApi }) => {
+      submittedDataVar.value = submitFormApi.response;
+      toast.success("Form submitted!");
+    })
+    .resetComponent(FormInput1)
+    .resetComponent(FormInput2)
+    .setComponentProperty(FormDialog, { property: "isOpen", value: false })
+}
+\`\`\`
+
+**Data refresh after mutation:**
+\`\`\`tsx
+// In scope.ts
+deleteItemApi: {
+  onSuccess: EventFlow
+    .runJS(() => {
+      toast.success("Item deleted");
+    })
+    .runApis([fetchItemsApi])  // Refresh the list
+}
+\`\`\`
+
+### Why this separation matters for APIs:
+- Keeps data flow unidirectional and predictable
+- APIs remain pure data processors
+- API-triggered state updates are centralized in onSuccess/onError handlers
+- Makes debugging and testing easier
+- Aligns with the Superblocks visual editor model
+</api_state_updates>
 </apis>
 
 <superblocks_state>

package/dist/ai-service/state-machine/handlers/simple-prompt-builder.js.map

@@ -1 +1 @@
-{"version":3,"file":"simple-prompt-builder.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/handlers/simple-prompt-builder.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,GAAG,EAAE,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAiuEd,CAAC"}
+{"version":3,"file":"simple-prompt-builder.js","sourceRoot":"","sources":["../../../../src/ai-service/state-machine/handlers/simple-prompt-builder.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,iBAAiB,GAC5B,GAAG,EAAE,CAAC,MAAM,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAw0Ed,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@superblocksteam/vite-plugin-file-sync",
-  "version": "2.0.37-next.23",
+  "version": "2.0.37-next.25",
   "type": "module",
   "engines": {
     "node": ">=20.11.0"
@@ -70,12 +70,12 @@
     "@lezer/python": "^1.1.15",
     "@opentelemetry/api": "^1.9.0",
     "@opentelemetry/api-logs": "^0.203.0",
-    "@superblocksteam/ai-service-templates": "2.0.37-next.23",
-    "@superblocksteam/library": "2.0.37-next.23",
-    "@superblocksteam/library-shared": "2.0.37-next.23",
-    "@superblocksteam/linter": "2.0.37-next.23",
+    "@superblocksteam/ai-service-templates": "2.0.37-next.25",
+    "@superblocksteam/library": "2.0.37-next.25",
+    "@superblocksteam/library-shared": "2.0.37-next.25",
+    "@superblocksteam/linter": "2.0.37-next.25",
     "@superblocksteam/shared": "0.9453.0",
-    "@superblocksteam/util": "2.0.37-next.23",
+    "@superblocksteam/util": "2.0.37-next.25",
     "@typescript-eslint/parser": "^8.32.1",
     "acorn": "^8.14.0",
     "ai": "5.0.33",