@wix/ditto-codegen-public 1.0.46 → 1.0.48

package/dist/out.js

@@ -117469,7 +117469,7 @@ var require_utils14 = __commonJS({
       return loadRelevantFiles(srcOnlyPaths, basePath).join("\n\n---\n\n");
     }
     var buildUserPromptForCodeGenerationAgent = (params, primaryAction) => {
-      const { extension, blueprint, scaffold, userRequestSummary, relevantFilePaths, createdCollections, basePath } = params;
+      const { extension, blueprint, scaffold, userRequestSummary, relevantFilePaths, planAndResources, basePath } = params;
       const contextSections = [];
       if (extension.name)
         contextSections.push(`Extension Name: ${extension.name}`);
@@ -117497,10 +117497,15 @@ Path: ${scaffold.path}
 ${scaffold.content}
 \`\`\``);
       }
-      if (createdCollections) {
+      if (planAndResources?.createdCollections) {
         contextSections.push(`
 ## CREATED COLLECTIONS
-${JSON.stringify(createdCollections, null, 2)}`);
+${JSON.stringify(planAndResources.createdCollections, null, 2)}`);
+      }
+      if (planAndResources?.apiSpec) {
+        contextSections.push(`
+## API SPEC
+${JSON.stringify(planAndResources.apiSpec, null, 2)}`);
       }
       const userMessage = `${primaryAction}:
 ${contextSections.join("\n")}`;
@@ -117761,10 +117766,10 @@ var require_SPIAgent = __commonJS({
         return (0, servicePluginPrompt_1.getServicePluginPrompt)(spiNames, useData);
       }
       async generate(params) {
-        const { extension, blueprint, createdCollections } = params;
+        const { extension, blueprint, planAndResources } = params;
         const examples = (0, load_examples_1.loadExamples)([load_examples_1.types.ServicePluginExtension]);
         const allSpiNames = extension.relatedSpis?.map((spi) => spi.name).filter((name) => !!name) || [];
-        const useData = Boolean(createdCollections && createdCollections.length > 0);
+        const useData = Boolean(planAndResources?.createdCollections?.length);
         const systemPrompt = `${this.buildSystemPrompt(allSpiNames, useData)}
 ${examples}
 `;
@@ -117804,6 +117809,196 @@ ${examples}
   }
 });
 
+// dist/system-prompts/planner/apiSpec.js
+var require_apiSpec = __commonJS({
+  "dist/system-prompts/planner/apiSpec.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.apiSpecPrompt = void 0;
+    var todoExample = {
+      name: "Todo API",
+      description: "A simple todo application API for managing tasks",
+      endpoints: [
+        {
+          id: "get-todos",
+          path: "/api/todos",
+          method: "GET",
+          name: "Get All Todos",
+          description: "Retrieve all todo items",
+          parameters: [],
+          response: {
+            statusCode: 200,
+            type: "array"
+          }
+        },
+        {
+          id: "create-todo",
+          path: "/api/todos",
+          method: "POST",
+          name: "Create Todo",
+          description: "Create a new todo item",
+          parameters: [
+            {
+              name: "title",
+              type: "string",
+              required: true,
+              location: "body"
+            },
+            {
+              name: "description",
+              type: "string",
+              required: false,
+              location: "body"
+            },
+            {
+              name: "completed",
+              type: "boolean",
+              required: false,
+              location: "body"
+            }
+          ],
+          response: {
+            statusCode: 201,
+            type: "object"
+          }
+        },
+        {
+          id: "get-todo-by-id",
+          path: "/api/todos/[id]",
+          method: "GET",
+          name: "Get Todo by ID",
+          description: "Retrieve a specific todo item by its ID",
+          parameters: [
+            {
+              name: "id",
+              type: "string",
+              required: true,
+              location: "path"
+            }
+          ],
+          response: {
+            statusCode: 200,
+            type: "object"
+          }
+        },
+        {
+          id: "update-todo",
+          path: "/api/todos/[id]",
+          method: "PUT",
+          name: "Update Todo",
+          description: "Update an existing todo item",
+          parameters: [
+            {
+              name: "id",
+              type: "string",
+              required: true,
+              location: "path"
+            },
+            {
+              name: "title",
+              type: "string",
+              required: false,
+              location: "body"
+            },
+            {
+              name: "description",
+              type: "string",
+              required: false,
+              location: "body"
+            },
+            {
+              name: "completed",
+              type: "boolean",
+              required: false,
+              location: "body"
+            }
+          ],
+          response: {
+            statusCode: 200,
+            type: "object"
+          }
+        },
+        {
+          id: "delete-todo",
+          path: "/api/todos/[id]",
+          method: "DELETE",
+          name: "Delete Todo",
+          description: "Delete a todo item",
+          parameters: [
+            {
+              name: "id",
+              type: "string",
+              required: true,
+              location: "path"
+            }
+          ],
+          response: {
+            statusCode: 204,
+            type: "object"
+          }
+        }
+      ],
+      dataModels: [
+        {
+          name: "Todo",
+          properties: {
+            id: {
+              type: "string",
+              required: true
+            },
+            title: {
+              type: "string",
+              required: true
+            },
+            description: {
+              type: "string",
+              required: false
+            },
+            completed: {
+              type: "boolean",
+              required: true
+            },
+            createdAt: {
+              type: "string",
+              required: true
+            },
+            updatedAt: {
+              type: "string",
+              required: true
+            }
+          }
+        }
+      ]
+    };
+    var apiSpecPrompt = () => `
+<API_SPEC_PLANNER_SYSTEM_PROMPT>
+
+<role>
+You are a Fullstack API Endpoints planning expert.
+Given a blueprint describing an app (name, summary, and extensions), you must produce a concrete API spec.
+
+Your output must be strictly JSON that conforms to the provided schema (no markdown).
+</role>
+
+<constraints>
+- An API Spec is only needed if the blueprint contains an extension with type "BACKEND_API".
+</constraints>
+
+<example_output>
+Expected plan (abbreviated):
+
+\`\`\`
+${JSON.stringify({
+      apiSpec: todoExample
+    }, null, 2)}
+\`\`\`
+</example_output>
+
+</API_SPEC_PLANNER_SYSTEM_PROMPT>`;
+    exports2.apiSpecPrompt = apiSpecPrompt;
+  }
+});
+
 // dist/system-prompts/planner/data.js
 var require_data2 = __commonJS({
   "dist/system-prompts/planner/data.js"(exports2) {
@@ -117859,32 +118054,30 @@ Your output must be strictly JSON that conforms to the provided schema (no markd
 <example>
 Blueprint indicates a handling fees system for products.
 
-Expected plan (abbreviated):
-{
-  "collections": [
-    {
-      "id": "handling-fees-rules",
-      "displayName": "Handling Fees Rules",
-      "displayField": "productId",
-      "fields": [
-        {
-          "key": "productId",
-          "displayName": "Product",
-          "type": "REFERENCE",
-          "typeMetadata": {
-            "reference": {
-              "referencedCollectionId": "Stores/Products"
-            }
+For the collections field, return:
+[
+  {
+    "id": "handling-fees-rules",
+    "displayName": "Handling Fees Rules",
+    "displayField": "productId",
+    "fields": [
+      {
+        "key": "productId",
+        "displayName": "Product",
+        "type": "REFERENCE",
+        "typeMetadata": {
+          "reference": {
+            "referencedCollectionId": "Stores/Products"
           }
-        },
-        { "key": "oversizedFee", "displayName": "Oversized Fee", "type": "NUMBER" },
-        { "key": "fragileFee", "displayName": "Fragile Fee", "type": "NUMBER" }
-      ],
-      "permissions": { "read": "ADMIN", "insert": "ADMIN", "update": "ADMIN", "remove": "ADMIN" },
-      "plugins": []
-    }
-  ]
-}
+        }
+      },
+      { "key": "oversizedFee", "displayName": "Oversized Fee", "type": "NUMBER" },
+      { "key": "fragileFee", "displayName": "Fragile Fee", "type": "NUMBER" }
+    ],
+    "permissions": { "read": "ADMIN", "insert": "ADMIN", "update": "ADMIN", "remove": "ADMIN" },
+    "plugins": []
+  }
+]
 </example>
 
 <approach>
@@ -117906,10 +118099,13 @@ var require_planner = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.plannerPrompt = void 0;
+    var apiSpec_1 = require_apiSpec();
     var data_1 = require_data2();
     var plannerPrompt = () => `
 <WIXCLI_PLANNER_SYSTEM_PROMPT>
 ${(0, data_1.cmsPlannerPrompt)()}
+
+${(0, apiSpec_1.apiSpecPrompt)()}
 </WIXCLI_PLANNER_SYSTEM_PROMPT>
 `;
     exports2.plannerPrompt = plannerPrompt;
@@ -119818,6 +120014,47 @@ var require_CMSAgent = __commonJS({
   }
 });
 
+// dist/ApiSpecSchema.js
+var require_ApiSpecSchema = __commonJS({
+  "dist/ApiSpecSchema.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.ApiSpecSchema = void 0;
+    var zod_1 = require_zod();
+    var HttpMethodSchema = zod_1.z.enum(["GET", "POST", "PUT", "PATCH", "DELETE"]);
+    var EndpointSchema = zod_1.z.object({
+      id: zod_1.z.string().describe("Unique identifier for the endpoint"),
+      path: zod_1.z.string().describe("API endpoint path (e.g., '/api/users', '/api/users/[id]')"),
+      method: HttpMethodSchema.describe("HTTP method for the endpoint"),
+      name: zod_1.z.string().describe("Human-readable name for the endpoint"),
+      description: zod_1.z.string().describe("What the endpoint does"),
+      parameters: zod_1.z.array(zod_1.z.object({
+        name: zod_1.z.string(),
+        type: zod_1.z.enum(["string", "number", "boolean", "object", "array"]),
+        required: zod_1.z.boolean().default(false),
+        location: zod_1.z.enum(["path", "query", "body"]).default("body")
+      })).default([]).describe("Input parameters"),
+      response: zod_1.z.object({
+        statusCode: zod_1.z.number().default(200),
+        type: zod_1.z.enum(["string", "number", "boolean", "object", "array"]).default("object")
+      }).describe("Expected response")
+    });
+    var DataModelSchema = zod_1.z.object({
+      name: zod_1.z.string().describe("Name of the data model"),
+      properties: zod_1.z.record(zod_1.z.string(), zod_1.z.object({
+        type: zod_1.z.enum(["string", "number", "boolean", "object", "array"]),
+        required: zod_1.z.boolean().default(false)
+      })).describe("Properties of the model")
+    });
+    exports2.ApiSpecSchema = zod_1.z.object({
+      name: zod_1.z.string().describe("Name of the API"),
+      description: zod_1.z.string().describe("Overall description of the API"),
+      endpoints: zod_1.z.array(EndpointSchema).describe("List of API endpoints to implement"),
+      dataModels: zod_1.z.array(DataModelSchema).default([]).describe("Shared data models/types")
+    }).describe("Complete API specification");
+  }
+});
+
 // dist/agents/PlannerAgent.js
 var require_PlannerAgent = __commonJS({
   "dist/agents/PlannerAgent.js"(exports2) {
@@ -119830,8 +120067,10 @@ var require_PlannerAgent = __commonJS({
     var planner_1 = require_planner();
     var CMSAgent_1 = require_CMSAgent();
     var utils_1 = require_utils14();
+    var ApiSpecSchema_1 = require_ApiSpecSchema();
     exports2.PlannerOutputSchema = zod_1.z.object({
-      collections: zod_1.z.array(CMSAgent_1.CmsCollectionSchema).default([])
+      collections: zod_1.z.array(CMSAgent_1.CmsCollectionSchema).default([]),
+      apiSpec: ApiSpecSchema_1.ApiSpecSchema.optional()
     });
     var PlannerAgent = class {
       constructor(apiKey) {
@@ -121543,6 +121782,149 @@ var require_SiteComponentAgent = __commonJS({
   }
 });
 
+// dist/system-prompts/backend/backendApi.js
+var require_backendApi = __commonJS({
+  "dist/system-prompts/backend/backendApi.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.backendApiPrompt = void 0;
+    var backendApiPrompt = () => {
+      return `
+You are a specialized code-generation agent for creating Astro Server Endpoints (API Routes) for fullstack applications.
+
+## Core Knowledge
+
+### Astro Server Endpoints Overview
+- Astro Server Endpoints are API routes that run on the server side
+- They are located in the \`src/pages/api/\` directory
+- Each file exports named functions for HTTP methods (GET, POST, PUT, DELETE, etc.)
+- Files use the \`.ts\` extension and are automatically converted to API endpoints
+
+### File Structure and Naming
+- API routes are created in \`src/pages/api/\` directory
+- File names become the endpoint path (e.g., \`users.ts\` \u2192 \`/api/users\`)
+- For dynamic routes with parameters, use square brackets in the filename (e.g., \`/api/users/[id]\`)
+- Dynamic parameters can be extracted at runtime using the \`params\` parameter in the function
+
+Example for dynamic route:
+\`\`\`
+// src/pages/api/user/[id].ts
+ 
+export async function GET({ params }) {
+  const id = params.id;
+  const user = await getUser(id);
+
+  if (!user) {
+    return new Response(null, {
+      status: 404,
+      statusText: "Not found",
+    });
+  }
+
+  return new Response(JSON.stringify(user), {
+    status: 200,
+    headers: {
+      "Content-Type": "application/json",
+    },
+  });
+}
+\`\`\`
+
+### TypeScript Patterns
+- Import \`APIRoute\` type from 'astro'
+- Export named functions for HTTP methods: \`GET\`, \`POST\`, \`PUT\`, \`DELETE\`, \`PATCH\`
+- Use async/await for handling asynchronous operations
+- Always return a \`Response\` object
+
+### Request Handling
+- Access request data through the \`request\` parameter
+- Use \`request.json()\` for POST/PUT request bodies
+- Use \`request.url\` for the full URL
+- Use \`new URL(request.url).searchParams\` for query parameters
+- Access headers via \`request.headers\`
+
+### Response Patterns
+- Always return a \`Response\` object
+- Use \`JSON.stringify()\` for JSON responses
+- Set appropriate status codes (200, 201, 400, 404, 500, etc.)
+- Include proper headers, especially \`Content-Type: application/json\`
+
+### Common Patterns
+- GET endpoints for data retrieval
+- POST endpoints for data creation
+- PUT/PATCH endpoints for data updates
+- DELETE endpoints for data removal
+- Use proper HTTP status codes
+
+### Best Practices
+- Use proper TypeScript types
+- Return appropriate HTTP status codes
+- Include proper headers
+- Use async/await for asynchronous operations
+- Keep endpoints focused and single-purpose
+
+## Your Task
+Generate clean, well-structured Astro Server Endpoints based on the API Spec that follow these patterns and best practices.
+Focus on creating maintainable, secure, and efficient API routes that integrate well with frontend applications.
+`;
+    };
+    exports2.backendApiPrompt = backendApiPrompt;
+  }
+});
+
+// dist/agents/BackendApiAgent.js
+var require_BackendApiAgent = __commonJS({
+  "dist/agents/BackendApiAgent.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.BackendApiAgent = void 0;
+    var anthropic_1 = require_dist5();
+    var backendApi_1 = require_backendApi();
+    var utils_1 = require_utils14();
+    var ai_1 = require_dist7();
+    var BackendApiAgent = class {
+      constructor(apiKey) {
+        this.apiKey = apiKey;
+        this.name = "BackendApiAgent";
+      }
+      buildSystemPrompt() {
+        return (0, backendApi_1.backendApiPrompt)();
+      }
+      async generate(params) {
+        const { blueprint } = params;
+        const systemPrompt = this.buildSystemPrompt();
+        const primaryAction = `Create Astro Server Endpoints for the app ${blueprint?.appName}`;
+        const userMessage = (0, utils_1.buildUserPromptForCodeGenerationAgent)(params, primaryAction);
+        const model = (0, anthropic_1.createAnthropic)({ apiKey: this.apiKey })("claude-sonnet-4-20250514");
+        const result = await (0, ai_1.generateObject)({
+          model,
+          schema: utils_1.FileSchema,
+          messages: [
+            {
+              role: "system",
+              content: systemPrompt,
+              providerOptions: (0, utils_1.withCaching)("1h")
+            },
+            {
+              role: "user",
+              content: userMessage
+            }
+          ],
+          experimental_telemetry: {
+            isEnabled: true,
+            functionId: this.name
+          },
+          maxOutputTokens: 1e4,
+          maxRetries: 3,
+          temperature: 0
+        });
+        return result.object.files;
+      }
+    };
+    exports2.BackendApiAgent = BackendApiAgent;
+  }
+});
+
 // dist/system-prompts/iterationAgent/iterationAgentPrompt.js
 var require_iterationAgentPrompt = __commonJS({
   "dist/system-prompts/iterationAgent/iterationAgentPrompt.js"(exports2) {
@@ -122942,6 +123324,150 @@ var require_data3 = __commonJS({
   }
 });
 
+// dist/system-prompts/dashboardPage/apiSpecPrompt.js
+var require_apiSpecPrompt = __commonJS({
+  "dist/system-prompts/dashboardPage/apiSpecPrompt.js"(exports2) {
+    "use strict";
+    Object.defineProperty(exports2, "__esModule", { value: true });
+    exports2.apiSpecPrompt = void 0;
+    exports2.apiSpecPrompt = `
+<api_spec_docs>
+You will be given an API specification under the "API SPEC" spec.
+The dashboard page code you generate can make API calls to these endpoints to read and write data.
+You cannot write the API calls yourself, you must use the API calls provided in the API SPEC.
+
+<example_api_spec>
+${JSON.stringify({
+      name: "Todo Management API",
+      description: "A simple API for managing todo items with CRUD operations",
+      endpoints: [
+        {
+          id: "get-todos",
+          path: "/api/todos",
+          method: "GET",
+          name: "Get All Todos",
+          description: "Retrieve all todo items",
+          parameters: [],
+          response: {
+            statusCode: 200,
+            type: "array"
+          }
+        },
+        {
+          id: "create-todo",
+          path: "/api/todos",
+          method: "POST",
+          name: "Create Todo",
+          description: "Create a new todo item",
+          parameters: [
+            {
+              name: "todo",
+              type: "object",
+              required: true,
+              location: "body"
+            }
+          ],
+          response: {
+            statusCode: 201,
+            type: "object"
+          }
+        },
+        {
+          id: "update-todo",
+          path: "/api/todos/[id]",
+          method: "PUT",
+          name: "Update Todo",
+          description: "Update an existing todo item",
+          parameters: [
+            {
+              name: "id",
+              type: "string",
+              required: true,
+              location: "path"
+            },
+            {
+              name: "todo",
+              type: "object",
+              required: true,
+              location: "body"
+            }
+          ],
+          response: {
+            statusCode: 200,
+            type: "object"
+          }
+        }
+      ],
+      dataModels: [
+        {
+          name: "Todo",
+          properties: {
+            id: {
+              type: "string",
+              required: true
+            },
+            title: {
+              type: "string",
+              required: true
+            },
+            description: {
+              type: "string",
+              required: false
+            },
+            completed: {
+              type: "boolean",
+              required: true
+            },
+            createdAt: {
+              type: "string",
+              required: true
+            }
+          }
+        }
+      ]
+    }, null, 2)}
+</example_api_spec>
+
+<example_output_code>
+// Reading data - GET request
+async function getTodos(): Promise<Todo[]> {
+  const response = await fetch('/api/todos');
+  const data = await response.json();
+  return data;
+}
+
+// Writing data - POST request with data model entity
+async function createTodo(todo: Omit<Todo, 'id' | 'createdAt'>): Promise<Todo> {
+  const response = await fetch('/api/todos', {
+    method: 'POST',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(todo),
+  });
+  const data = await response.json();
+  return data;
+}
+
+// Writing data - PUT request with data model entity
+async function updateTodo(id: string, todo: Partial<Todo>): Promise<Todo> {
+  const response = await fetch(\`/api/todos/\${id}\`, {
+    method: 'PUT',
+    headers: {
+      'Content-Type': 'application/json',
+    },
+    body: JSON.stringify(todo),
+  });
+  const data = await response.json();
+  return data;
+}
+</example_output_code>
+
+</api_spec_docs>
+`;
+  }
+});
+
 // dist/system-prompts/dashboardPage/dashboardPagePrompt.js
 var require_dashboardPagePrompt = __commonJS({
   "dist/system-prompts/dashboardPage/dashboardPagePrompt.js"(exports2) {
@@ -122952,6 +123478,7 @@ var require_dashboardPagePrompt = __commonJS({
     var dashboardPackage_1 = require_dashboardPackage();
     var wdsPackage_1 = require_wdsPackage();
     var data_1 = require_data3();
+    var apiSpecPrompt_1 = require_apiSpecPrompt();
     var wdsPackage_2 = require_wdsPackage();
     Object.defineProperty(exports2, "buildWdsSystemPrompt", { enumerable: true, get: function() {
       return wdsPackage_2.buildWdsSystemPrompt;
@@ -122981,7 +123508,7 @@ var require_dashboardPagePrompt = __commonJS({
       "ToggleSwitch",
       "InfoIcon"
     ];
-    var dashboardPagePrompt = async (useData) => {
+    var dashboardPagePrompt = async ({ useData, useApiSpec }) => {
       const wdsPrompt = await (0, wdsPackage_1.buildWdsSystemPrompt)(listOfWdsComponents);
       return `
 <WIXCLI_DASHBOARD_PAGE_SYSTEM_PROMPT>
@@ -123062,6 +123589,8 @@ ${wdsPrompt}
 </typescript_quality_guidelines>
 
 ${useData ? data_1.dataPrompt : ""}
+
+${useApiSpec ? apiSpecPrompt_1.apiSpecPrompt : ""}
 </WIXCLI_DASHBOARD_PAGE_SYSTEM_PROMPT>
 `;
     };
@@ -123085,14 +123614,15 @@ var require_DashboardPageAgent = __commonJS({
         this.apiKey = apiKey;
         this.name = "DashboardPageAgent";
       }
-      async buildSystemPrompt(useData) {
-        return (0, dashboardPagePrompt_1.dashboardPagePrompt)(useData);
+      async buildSystemPrompt(opts) {
+        return (0, dashboardPagePrompt_1.dashboardPagePrompt)(opts);
       }
       async generate(params) {
-        const { blueprint, createdCollections } = params;
+        const { blueprint, planAndResources } = params;
         const examples = (0, load_examples_1.loadExamples)([load_examples_1.types.DashboardPage]);
-        const useData = Boolean(createdCollections && createdCollections.length > 0);
-        const systemPrompt = `${await this.buildSystemPrompt(useData)}
+        const useData = Boolean(planAndResources?.createdCollections?.length);
+        const useApiSpec = Boolean(planAndResources?.apiSpec);
+        const systemPrompt = `${await this.buildSystemPrompt({ useData, useApiSpec })}
 ${examples}
 `;
         console.log(`Dashboard Agent System Prompt length: ${systemPrompt.length} (is that what you expect?)`);
@@ -123385,12 +123915,13 @@ Dashboard Page Description: ${extension.description}
 ${collectionsInfo}
 </available-collections>`;
       }
-      async generate({ blueprint, extension, createdCollections }) {
-        if (createdCollections.length === 0) {
+      async generate({ blueprint, extension, planAndResources }) {
+        if (!planAndResources.createdCollections?.length) {
           return {
             useAutoPatterns: false
           };
         }
+        const { createdCollections } = planAndResources;
         const model = (0, anthropic_1.createAnthropic)({ apiKey: this.apiKey })("claude-3-5-haiku-latest");
         const collectionsInfo = createdCollections.map((collection, index) => {
           const userFields = collection.fields?.filter((field) => !field.key?.startsWith("_")) || [];
@@ -123609,15 +124140,11 @@ var require_scaffolding = __commonJS({
     }
     async function copyBackendApiScaffolding(extension, outputPath) {
       const uniqueFolderName = toKebabCase(extension.name || "my-api");
-      const apiScaffoldingSubPath = "src/backend/api/my-api";
-      const webMethodFile = "src/backend/my-web-method.web.ts";
-      const apiOutputFolder = `src/backend/api/${uniqueFolderName}`;
-      const webMethodOutputFile = `src/backend/${uniqueFolderName}.web.ts`;
-      console.log(`  \u{1F50C} Copying backend API scaffolding from: ${apiScaffoldingSubPath} to ${apiOutputFolder}`);
-      const apiFiles = (0, tools_1.copyScaffolding)(apiScaffoldingSubPath, outputPath, apiOutputFolder);
-      console.log(`  \u{1F310} Copying web method from: ${webMethodFile} to ${webMethodOutputFile}`);
-      const webMethodFiles = (0, tools_1.copyScaffolding)(webMethodFile, outputPath, webMethodOutputFile);
-      return [...apiFiles, ...webMethodFiles];
+      const apiScaffoldingFile = "src/pages/api/my-api.ts";
+      const apiOutputFile = `src/pages/api/${uniqueFolderName}.ts`;
+      console.log(`  \u{1F50C} Copying backend API scaffolding from: ${apiScaffoldingFile} to ${apiOutputFile}`);
+      const apiFiles = (0, tools_1.copyScaffolding)(apiScaffoldingFile, outputPath, apiOutputFile);
+      return apiFiles;
     }
     async function copyBackendEventScaffolding(extension, outputPath) {
       const scaffoldingSubPath = "src/backend/events/my-event";
@@ -124013,6 +124540,7 @@ var require_AgentsFactory = __commonJS({
     var CMSAgent_1 = require_CMSAgent();
     var CMSDataAgent_1 = require_CMSDataAgent();
     var SiteComponentAgent_1 = __importDefault2(require_SiteComponentAgent());
+    var BackendApiAgent_1 = require_BackendApiAgent();
     var IterationAgent_1 = __importDefault2(require_IterationAgent());
     var CustomElementAgent_1 = __importDefault2(require_CustomElementAgent());
     var DashboardPageAgent_1 = __importDefault2(require_DashboardPageAgent());
@@ -124044,6 +124572,8 @@ var require_AgentsFactory = __commonJS({
             return new SiteComponentAgent_1.default(this.apiKey);
           case types_1.ExtensionType.SITE_WIDGET:
             return new CustomElementAgent_1.default(this.apiKey);
+          case types_1.ExtensionType.BACKEND_API:
+            return new BackendApiAgent_1.BackendApiAgent(this.apiKey);
           default:
             throw new Error(`Unsupported extension type for AI customization: ${extension.type}`);
         }
@@ -126609,7 +127139,6 @@ var require_extensionGenerators = __commonJS({
     var __importDefault2 = exports2 && exports2.__importDefault || function(mod2) {
       return mod2 && mod2.__esModule ? mod2 : { "default": mod2 };
     };
-    var _a2;
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.ExtensionFactory = void 0;
     var path_1 = __importDefault2(require("path"));
@@ -126620,62 +127149,117 @@ var require_extensionGenerators = __commonJS({
     var ditto_scaffolding_2 = require_dist11();
     var ExtensionFactory = class {
       static generateExtension(extension, outputPath, scaffoldPath) {
-        const config = this.extensionConfigs[extension.type];
-        if (!config) {
-          throw new Error(`Unsupported extension type: ${extension.type}`);
-        }
         const scaffoldDir = path_1.default.dirname(scaffoldPath);
-        const name = extension.name || config.defaultName;
         const id = (0, crypto_1.randomUUID)();
-        const builderMethod = typeof config.builderMethod === "function" ? config.builderMethod(extension, scaffoldDir, outputPath) : config.builderMethod;
-        const baseData = {
-          id,
-          name,
-          extensionType: extension.type,
-          builderMethod,
-          ...config.createExtensionData(extension, scaffoldDir, id)
-        };
-        writeExtensionTs(outputPath, name, baseData, scaffoldDir);
-      }
-      static getServicePluginBuilderMethod(ext) {
-        if (!ext.relatedSpis || ext.relatedSpis.length !== 1) {
-          throw new Error("Service plugin extension must have only one related SPI");
-        }
-        const scaffoldingSubPath = findScaffoldingSubPath(ext.relatedSpis[0]);
-        if (!scaffoldingSubPath) {
-          throw new Error("No valid scaffolding subpath found for service plugin");
-        }
-        if (!this.servicePluginBuilderMap[scaffoldingSubPath]) {
-          throw new Error(`Unsupported scaffolding subpath: ${scaffoldingSubPath}`);
+        switch (extension.type) {
+          case types_1.ExtensionType.SERVICE_PLUGIN: {
+            const name = extension.name || "My Service Plugin";
+            const servicePluginType = this.getServicePluginType(extension);
+            const builderMethod = this.servicePluginBuilderMap[servicePluginType];
+            const extensionConfig = this.createServicePluginData(name, scaffoldDir, id, servicePluginType);
+            writeExtensionFile({
+              outputPath,
+              name,
+              builderMethodName: builderMethod,
+              extensionConfig,
+              extensionType: extension.type,
+              scaffoldDir
+            });
+            break;
+          }
+          case types_1.ExtensionType.DASHBOARD_PAGE: {
+            const name = extension.name || "My Backoffice Page";
+            const extensionConfig = this.createDashboardPageData(id, name, scaffoldDir);
+            writeExtensionFile({
+              outputPath,
+              name,
+              builderMethodName: "backofficePage",
+              extensionConfig,
+              extensionType: extension.type,
+              scaffoldDir
+            });
+            break;
+          }
+          case types_1.ExtensionType.SITE_COMPONENT: {
+            const name = extension.name || "My Site Component";
+            const extensionConfig = this.createSiteComponentData(name, scaffoldDir, id);
+            writeExtensionFile({
+              outputPath,
+              name,
+              builderMethodName: "siteComponent",
+              extensionConfig,
+              extensionType: extension.type,
+              scaffoldDir
+            });
+            break;
+          }
+          case types_1.ExtensionType.SITE_WIDGET: {
+            const name = extension.name || "My Site Widget";
+            const extensionConfig = this.createCustomElementData(id, name, scaffoldDir);
+            writeExtensionFile({
+              outputPath,
+              name,
+              builderMethodName: "customElement",
+              extensionConfig,
+              extensionType: extension.type,
+              scaffoldDir
+            });
+            break;
+          }
+          default:
+            console.log(`Skipping extension type: ${extension.type}. It doesn't need presence in the extensions.ts file (e.g. Backend API is astro only)`);
+            return;
         }
-        return this.servicePluginBuilderMap[scaffoldingSubPath];
       }
-      static createServicePluginData(ext, scaffoldDir) {
+      static getServicePluginType(ext) {
         if (!ext.relatedSpis || ext.relatedSpis.length !== 1) {
           throw new Error("Service plugin extension must have only one related SPI");
         }
-        const scaffoldingSubPath = findScaffoldingSubPath(ext.relatedSpis[0]);
-        if (!scaffoldingSubPath) {
-          throw new Error("No valid scaffolding subpath found for service plugin");
+        const relatedSpi = ext.relatedSpis[0];
+        if (relatedSpi?.name && ditto_scaffolding_1.spiToSubPath[relatedSpi.name]) {
+          return ditto_scaffolding_1.spiToSubPath[relatedSpi.name];
         }
+        throw new Error("No valid service plugin type found for service plugin");
+      }
+      static createServicePluginData(name, scaffoldDir, id, servicePluginType) {
         const source = "./" + path_1.default.join(scaffoldDir, "plugin.ts").replace(/^src\//, "");
-        return { source, name: ext.name };
+        switch (servicePluginType) {
+          case "ecom-shipping-rates":
+            return {
+              id,
+              source,
+              name
+            };
+          case "ecom-additional-fees":
+            return { id, source };
+          case "ecom-validations":
+            return { id, source };
+          case "ecom-discounts-trigger":
+            return { id, source };
+          case "gift-cards-provider":
+            return { id, source };
+          case "ecom-payment-settings":
+            return { id, source };
+          default:
+            throw new Error(`Unsupported service plugin type ${servicePluginType}`);
+        }
       }
-      static createDashboardPageData(ext, scaffoldDir) {
-        const title = ext.name || "My Backoffice Page";
-        const routePath = ext.name?.toLowerCase().replace(/\s+/g, "-");
+      static createDashboardPageData(id, name, scaffoldDir) {
+        const routePath = name.toLowerCase().replace(/\s+/g, "-");
         const component = "./" + path_1.default.join(scaffoldDir, "page.tsx").replace(/^src\//, "");
         return {
-          title,
+          id,
+          title: name,
           routePath,
           component
         };
       }
-      static createCustomElementData(ext, scaffoldDir) {
-        const componentName = ext.name ?? "custom-element";
-        const kebabCaseComponentName = (0, ditto_scaffolding_2.toKebabCase)(componentName);
+      static createCustomElementData(id, name, scaffoldDir) {
+        const kebabCaseComponentName = (0, ditto_scaffolding_2.toKebabCase)(name);
         const componentPath = "./" + path_1.default.join(scaffoldDir, "widget.tsx").replace(/^src\//, "");
         return {
+          id,
+          name,
           tagName: "custom-element",
           element: componentPath,
           installation: { base: { autoAdd: true } },
@@ -126685,15 +127269,15 @@ var require_extensionGenerators = __commonJS({
           size: { height: { defaultHeight: 500 }, width: { defaultWidth: 500 } }
         };
       }
-      static createSiteComponentData(ext, scaffoldDir, id) {
-        const componentName = ext.name ?? "my-component";
-        const kebabCaseComponentName = (0, ditto_scaffolding_2.toKebabCase)(componentName);
+      static createSiteComponentData(name, scaffoldDir, id) {
+        const kebabCaseComponentName = (0, ditto_scaffolding_2.toKebabCase)(name);
         const componentPath = "./" + path_1.default.join(scaffoldDir, "component.tsx").replace(/^src\//, "");
         return {
-          description: ext.name,
+          id,
+          description: name,
           type: `platform.builder.${id}`,
           editorElement: {
-            displayName: componentName,
+            displayName: name,
             selector: kebabCaseComponentName
           },
           resources: {
@@ -126705,29 +127289,6 @@ var require_extensionGenerators = __commonJS({
       }
     };
     exports2.ExtensionFactory = ExtensionFactory;
-    _a2 = ExtensionFactory;
-    ExtensionFactory.extensionConfigs = {
-      [types_1.ExtensionType.SERVICE_PLUGIN]: {
-        builderMethod: _a2.getServicePluginBuilderMethod.bind(_a2),
-        defaultName: "My Service Plugin",
-        createExtensionData: _a2.createServicePluginData.bind(_a2)
-      },
-      [types_1.ExtensionType.DASHBOARD_PAGE]: {
-        builderMethod: "backofficePage",
-        defaultName: "My Backoffice Page",
-        createExtensionData: _a2.createDashboardPageData.bind(_a2)
-      },
-      [types_1.ExtensionType.SITE_COMPONENT]: {
-        builderMethod: "siteComponent",
-        defaultName: "my-component",
-        createExtensionData: _a2.createSiteComponentData.bind(_a2)
-      },
-      [types_1.ExtensionType.SITE_WIDGET]: {
-        builderMethod: "customElement",
-        defaultName: "my-custom-element",
-        createExtensionData: _a2.createCustomElementData.bind(_a2)
-      }
-    };
     ExtensionFactory.servicePluginBuilderMap = {
       "ecom-shipping-rates": "ecomShippingRates",
       "ecom-additional-fees": "ecomAdditionalFees",
@@ -126736,12 +127297,12 @@ var require_extensionGenerators = __commonJS({
       "gift-cards-provider": "ecomGiftCardsProvider",
       "ecom-payment-settings": "ecomPaymentSettings"
     };
-    function writeExtensionTs(outputPath, name, extensionData, scaffoldPath) {
+    function writeExtensionFile({ outputPath, name, builderMethodName, extensionConfig, extensionType, scaffoldDir }) {
       const sanitizedName = name.replace(/[^a-zA-Z0-9\s-_]/g, "").trim();
       if (!sanitizedName) {
         throw new Error(`Invalid extension name: "${name}"`);
       }
-      const absoluteScaffoldPath = path_1.default.isAbsolute(scaffoldPath) ? scaffoldPath : path_1.default.resolve(outputPath, scaffoldPath);
+      const absoluteScaffoldPath = path_1.default.isAbsolute(scaffoldDir) ? scaffoldDir : path_1.default.resolve(outputPath, scaffoldDir);
       const filePath = path_1.default.join(absoluteScaffoldPath, "extensions.ts");
       const relativePath = path_1.default.relative(outputPath, filePath);
       const normalizedFilePath = path_1.default.resolve(filePath);
@@ -126749,16 +127310,15 @@ var require_extensionGenerators = __commonJS({
       if (!normalizedFilePath.startsWith(normalizedOutputPath)) {
         throw new Error(`Attempted to write extension file outside output path: ${filePath}`);
       }
-      const tsContent = generateExtensionTsContent(extensionData);
+      const tsContent = generateExtensionTsContent(builderMethodName, extensionConfig, extensionType, name);
       fs_extra_1.default.outputFileSync(filePath, tsContent);
       return relativePath;
     }
-    function generateExtensionTsContent(extensionData) {
-      const { builderMethod, extensionType, name, ...config } = extensionData;
+    function generateExtensionTsContent(builderMethodName, extensionConfig, extensionType, name) {
       const extensionName = generateUniqueExtensionName(extensionType, name);
-      const configString = JSON.stringify(config, null, 2);
+      const configString = JSON.stringify(extensionConfig, null, 2);
       return `import * as extensions from '@wix/astro/builders';
-export const ${extensionName} = extensions.${builderMethod}(${configString})
+export const ${extensionName} = extensions.${builderMethodName}(${configString})
 `;
     }
     function generateUniqueExtensionName(extensionType, name) {
@@ -126767,12 +127327,6 @@ export const ${extensionName} = extensions.${builderMethod}(${configString})
       const camelCaseName = toCamelCase(sanitizedName);
       return `${typePrefix}${camelCaseName}`;
     }
-    function findScaffoldingSubPath(relatedSpis) {
-      if (relatedSpis?.name && ditto_scaffolding_1.spiToSubPath[relatedSpis.name]) {
-        return ditto_scaffolding_1.spiToSubPath[relatedSpis.name];
-      }
-      return null;
-    }
     function sanitizeName(name) {
       return name.replace(/[^a-zA-Z0-9\s-_]/g, "").replace(/\s+/g, " ").trim();
     }
@@ -133467,19 +134021,26 @@ var require_orchestrator = __commonJS({
           this.emitEvent("cms:start", {});
           const cmsAgent = this.agentsFactory.getAgent({ type: "CMS" });
           for (const collection of plan.collections) {
-            const result = await cmsAgent.generate({
+            const result2 = await cmsAgent.generate({
               blueprint,
               siteId,
               accessToken,
               collection
             });
-            createdCollections.push(result.collection);
+            createdCollections.push(result2.collection);
           }
           this.emitEvent("cms:done", {
             numberOfCollections: plan.collections.length
           });
         }
-        return { createdCollections };
+        const result = {};
+        if (createdCollections.length > 0) {
+          result.createdCollections = createdCollections;
+        }
+        if (plan?.apiSpec) {
+          result.apiSpec = plan.apiSpec;
+        }
+        return result;
       }
       async runIterationPlanningAndAugmentExtensions(outputPath, chatHistory) {
         const iterationAgent = this.agentsFactory.getAgent({
@@ -133490,94 +134051,70 @@ var require_orchestrator = __commonJS({
         const iterationPlan = await iterationAgent.generate(outputPath, candidateFiles, currentUserRequest, chatHistory);
         return iterationPlan;
       }
-      async processExtension({ extension, blueprint, outputPath, createdCollections }) {
+      async processExtension({ extension, blueprint, outputPath, planAndResources }) {
         switch (extension.type) {
           case types_1.ExtensionType.DASHBOARD_PAGE:
             return this.processDashboardPage({
               extension,
               blueprint,
               outputPath,
-              createdCollections
+              planAndResources
             });
           case types_1.ExtensionType.SERVICE_PLUGIN:
             return this.processServicePlugin({
               extension,
               blueprint,
               outputPath,
-              createdCollections
+              planAndResources
             });
           default:
             return this.processStandardExtension({
               extension,
               blueprint,
               outputPath,
-              createdCollections
+              planAndResources
             });
         }
       }
-      async processDashboardPage({ extension, blueprint, outputPath, createdCollections }) {
+      async processDashboardPage(opts) {
         const decisionAgent = this.agentsFactory.getAgent({
           type: "DASHBOARD_DECISION"
         });
-        const decision = await decisionAgent.generate({
-          blueprint,
-          extension,
-          createdCollections
-        });
+        const decision = await decisionAgent.generate(opts);
         const useAutoPatterns = decision.useAutoPatterns && decision.schema && decision.relevantCollectionId;
-        if (useAutoPatterns) {
-          console.log("\u{1F3AF} Using auto-patterns for dashboard generation");
-          const relevantCollection = createdCollections.find((c) => c.id === decision.relevantCollectionId);
-          if (!relevantCollection) {
-            throw new Error(`\u274C Collection with ID ${decision.relevantCollectionId} not found in created collections`);
-          }
-          const autoPatternsGenerator = this.agentsFactory.getAgent({
-            type: "AUTO_PATTERNS_GENERATOR"
-          });
-          this.emitEvent("agent:start", {
-            extension,
-            name: "AutoPatternsGenerator"
-          });
-          const files = autoPatternsGenerator.generate({
-            collection: relevantCollection,
-            decision,
-            extensionName: extension.name || ""
-          });
-          this.writeFile(files, outputPath);
-          const pagePath = files[0].path || "";
-          extensionGenerators_1.ExtensionFactory.generateExtension(extension, outputPath, pagePath);
-          this.emitEvent("agent:done", {
-            extension,
-            name: "AutoPatternsGenerator",
-            files
-          });
-        } else {
+        if (!useAutoPatterns) {
           console.log("\u{1F3A8} Using custom code generation for dashboard");
-          this.emitEvent("scaffold:start", { extension });
-          const scaffolds = await (0, ditto_scaffolding_1.copyScaffoldingTemplate)(extension, outputPath);
-          if (!scaffolds || scaffolds.length === 0) {
-            throw new Error(`\u274C Failed to scaffold ${extension.type}`);
-          }
-          const scaffold = scaffolds[0];
-          this.emitEvent("scaffold:done", {
-            extension,
-            scaffoldPath: scaffolds.map((s) => s.path).join(", ")
-          });
-          const agent = this.agentsFactory.getAgent(extension);
-          this.emitEvent("agent:start", { extension, name: agent.name });
-          const files = await agent.generate({
-            extension,
-            blueprint,
-            scaffold,
-            createdCollections,
-            basePath: outputPath
-          });
-          this.writeFile(files, outputPath);
-          extensionGenerators_1.ExtensionFactory.generateExtension(extension, outputPath, scaffold.path);
-          this.emitEvent("agent:done", { extension, name: agent.name, files });
+          await this.processStandardExtension(opts);
+          return;
         }
+        console.log("\u{1F3AF} Using auto-patterns for dashboard generation");
+        const { extension, outputPath, planAndResources: { createdCollections = [] } = {} } = opts;
+        const relevantCollection = createdCollections.find((c) => c.id === decision.relevantCollectionId);
+        if (!relevantCollection) {
+          throw new Error(`\u274C Collection with ID ${decision.relevantCollectionId} not found in created collections`);
+        }
+        const autoPatternsGenerator = this.agentsFactory.getAgent({
+          type: "AUTO_PATTERNS_GENERATOR"
+        });
+        this.emitEvent("agent:start", {
+          extension,
+          name: "AutoPatternsGenerator"
+        });
+        const files = autoPatternsGenerator.generate({
+          collection: relevantCollection,
+          decision,
+          extensionName: extension.name || ""
+        });
+        this.writeFile(files, outputPath);
+        const pagePath = files[0].path || "";
+        extensionGenerators_1.ExtensionFactory.generateExtension(extension, outputPath, pagePath);
+        this.emitEvent("agent:done", {
+          extension,
+          name: "AutoPatternsGenerator",
+          files
+        });
       }
-      async processServicePlugin({ extension, blueprint, outputPath, createdCollections }) {
+      async processServicePlugin({ extension, blueprint, outputPath, planAndResources }) {
         this.emitEvent("scaffold:start", { extension });
         const scaffolds = await (0, ditto_scaffolding_1.copyScaffoldingTemplate)(extension, outputPath);
         if (!scaffolds || scaffolds.length === 0) {
@@ -133592,7 +134129,7 @@ var require_orchestrator = __commonJS({
             extension,
             blueprint,
             outputPath,
-            createdCollections,
+            planAndResources,
             scaffolds
           });
         }
@@ -133603,14 +134140,14 @@ var require_orchestrator = __commonJS({
           extension,
           blueprint,
           scaffold,
-          createdCollections,
+          planAndResources,
           basePath: outputPath
         });
         this.writeFile(files, outputPath);
         extensionGenerators_1.ExtensionFactory.generateExtension(extension, outputPath, scaffold.path);
         this.emitEvent("agent:done", { extension, name: agent.name, files });
       }
-      async processStandardExtension({ extension, blueprint, outputPath, createdCollections }) {
+      async processStandardExtension({ extension, blueprint, outputPath, planAndResources }) {
         this.emitEvent("scaffold:start", { extension });
         const scaffolds = await (0, ditto_scaffolding_1.copyScaffoldingTemplate)(extension, outputPath);
         if (!scaffolds || scaffolds.length === 0) {
@@ -133627,14 +134164,14 @@ var require_orchestrator = __commonJS({
           extension,
           blueprint,
           scaffold,
-          createdCollections,
+          planAndResources,
           basePath: outputPath
         });
         this.writeFile(files, outputPath);
         extensionGenerators_1.ExtensionFactory.generateExtension(extension, outputPath, scaffold.path);
         this.emitEvent("agent:done", { extension, name: agent.name, files });
       }
-      async processMultipleServicePluginScaffolds({ extension, blueprint, outputPath, createdCollections, scaffolds }) {
+      async processMultipleServicePluginScaffolds({ extension, blueprint, outputPath, planAndResources, scaffolds }) {
         if (!extension.relatedSpis || extension.relatedSpis.length === 0) {
           throw new Error("Service plugin extension must have related SPIs");
         }
@@ -133656,7 +134193,7 @@ var require_orchestrator = __commonJS({
             extension: spiExtension,
             blueprint,
             scaffold,
-            createdCollections,
+            planAndResources,
             basePath: outputPath
           });
           this.writeFile(files, outputPath);
@@ -133686,7 +134223,7 @@ var require_orchestrator = __commonJS({
               blueprint: { extensions: [], appName: "", summary: "" },
               // Minimal blueprint for iteration
               outputPath,
-              createdCollections: [],
+              planAndResources: {},
               scaffolds
             });
             return;
@@ -133753,19 +134290,16 @@ var require_orchestrator = __commonJS({
         });
         const start = Date.now();
         const { extensions = [] } = blueprint;
-        const createdCollections = [];
-        if (siteId && siteId !== "N/A" && accessToken) {
-          const planAndResourcesResult = await this.generatePlanAndResources(request);
-          createdCollections.push(...planAndResourcesResult.createdCollections);
-        }
+        const planAndResources = await this.generatePlanAndResources(request);
         const parallelTasks = extensions.map((extension) => this.processExtension({
           extension,
           blueprint,
           outputPath,
-          createdCollections
+          planAndResources
         }));
-        if (createdCollections.length > 0 && siteId && accessToken) {
-          parallelTasks.push(this.generateCMSData(request, createdCollections));
+        const collections = planAndResources.createdCollections ?? [];
+        if (collections.length > 0 && siteId && siteId !== "N/A" && accessToken) {
+          parallelTasks.push(this.generateCMSData(request, collections));
         }
         await Promise.all(parallelTasks.filter(Boolean));
         await (0, extensionIndexer_1.generateMainExtensionsFile)(outputPath);