@wix/ditto-codegen-public 1.0.46 → 1.0.47

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) {
@@ -117906,10 +118101,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 +120016,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 +120069,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 +121784,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 +123326,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 +123480,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 +123510,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 +123591,8 @@ ${wdsPrompt}
 </typescript_quality_guidelines>
 
 ${useData ? data_1.dataPrompt : ""}
+
+${useApiSpec ? apiSpecPrompt_1.apiSpecPrompt : ""}
 </WIXCLI_DASHBOARD_PAGE_SYSTEM_PROMPT>
 `;
     };
@@ -123085,14 +123616,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 +123917,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 +124142,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 +124542,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 +124574,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}`);
         }
@@ -126621,9 +127153,13 @@ var require_extensionGenerators = __commonJS({
     var ExtensionFactory = class {
       static generateExtension(extension, outputPath, scaffoldPath) {
         const config = this.extensionConfigs[extension.type];
-        if (!config) {
+        if (typeof config === "undefined") {
           throw new Error(`Unsupported extension type: ${extension.type}`);
         }
+        if (config === null) {
+          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;
+        }
         const scaffoldDir = path_1.default.dirname(scaffoldPath);
         const name = extension.name || config.defaultName;
         const id = (0, crypto_1.randomUUID)();
@@ -126726,7 +127262,8 @@ var require_extensionGenerators = __commonJS({
         builderMethod: "customElement",
         defaultName: "my-custom-element",
         createExtensionData: _a2.createCustomElementData.bind(_a2)
-      }
+      },
+      [types_1.ExtensionType.BACKEND_API]: null
     };
     ExtensionFactory.servicePluginBuilderMap = {
       "ecom-shipping-rates": "ecomShippingRates",
@@ -133467,19 +134004,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 +134034,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 +134112,7 @@ var require_orchestrator = __commonJS({
             extension,
             blueprint,
             outputPath,
-            createdCollections,
+            planAndResources,
             scaffolds
           });
         }
@@ -133603,14 +134123,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 +134147,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 +134176,7 @@ var require_orchestrator = __commonJS({
             extension: spiExtension,
             blueprint,
             scaffold,
-            createdCollections,
+            planAndResources,
             basePath: outputPath
           });
           this.writeFile(files, outputPath);
@@ -133686,7 +134206,7 @@ var require_orchestrator = __commonJS({
               blueprint: { extensions: [], appName: "", summary: "" },
               // Minimal blueprint for iteration
               outputPath,
-              createdCollections: [],
+              planAndResources: {},
               scaffolds
             });
             return;
@@ -133753,19 +134273,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);

package/dist/wix-cli-templates/src/pages/api/my-api.ts

@@ -0,0 +1,31 @@
+// A frontend API based on Astor's Server Endpoints (API Routes)
+// See https://docs.astro.build/en/guides/endpoints/#server-endpoints-api-routes
+import type { APIRoute } from "astro";
+
+export const GET: APIRoute = async ({ request }) => {
+  return new Response(
+    JSON.stringify({
+      message: `This was a GET to ${request.url}`,
+    }),
+  );
+};
+
+export const POST: APIRoute = async ({ request }) => {
+  const body = await request.json();
+
+  const { name } = body;
+
+  console.log("name:", name);
+
+  return new Response(
+    JSON.stringify({
+      greeting: `Hello ${name}`,
+    }),
+    {
+      status: 200,
+      headers: {
+        "Content-Type": "application/json",
+      },
+    },
+  );
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.46",
+  "version": "1.0.47",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -24,5 +24,5 @@
     "@wix/ditto-codegen": "1.0.0",
     "esbuild": "^0.25.9"
   },
-  "falconPackageHash": "7c7d2461323857981a78949ab4a5a9fdcafedf192742fa80e66bde4a"
+  "falconPackageHash": "343aa69a85dc9adacb60daa8817207e375875acff998406df25af5cf"
 }

package/dist/wix-cli-templates/src/backend/api/my-api/api.ts

@@ -1,29 +0,0 @@
-/**
-This file allows you to call backend APIs from your frontend of this app.
-You can generate various API methods including GET, POST, PUT, and DELETE.
-To learn more, check out our documentation: https://wix.to/Iabrrso
-
-Here's how you can call your API from your frontend code:
-
-import { httpClient } from '@wix/essentials';
-
-function MyComponent() {
-  const callMyBackend = async () => {
-    const res = await httpClient.fetchWithAuth(`${import.meta.env.BASE_API_URL}/my-api`);
-    console.log(await res.text());
-  };
-
-  return <button onClick={callMyBackend}>Call backend GET function</button>;
-};
-*/
-
-export async function GET(req: Request) {
-  console.log('Log from GET.');
-  return new Response('Response from GET.');
-};
-
-export async function POST(req: Request) {
-  const data = await req.json();
-  console.log('Log POST with body:', data);
-  return Response.json(data);
-};

package/dist/wix-cli-templates/src/backend/my-web-method.web.ts

@@ -1,21 +0,0 @@
-/**
-This file allows you to define backend functions that you can call from the front end of this app with type-safety.
-
-Here's how you can call your web method from your frontend code:
-
-import { multiply } from '<path-to-your-web-methods-directory>/my-web-method.web';
-
-multiply(3, 4)
-    .then(result => console.log(result));
-
-To learn more, check out our documentation: https://wix.to/6LV6Oka.
-*/
-
-import { webMethod, Permissions } from '@wix/web-methods';
-
-export const multiply = webMethod(
-  Permissions.Anyone,
-  (a: number, b: number) => {
-    return a * b;
-  },
-);