@wix/ditto-codegen-public 1.0.241 → 1.0.242

package/dist/examples-apps/ai-chatbot/src/dashboard/pages/product/ProductChat.tsx

@@ -1,5 +1,6 @@
 import { useCallback, useState, type FC } from "react";
 import { productsV3 } from "@wix/stores";
+import { httpClient } from "@wix/essentials";
 import { Text, Box, Card, Input, Loader } from "@wix/design-system";
 import * as Icons from "@wix/wix-ui-icons-common";
 import styles from "./ProductChat.module.css";
@@ -9,12 +10,14 @@ export type ChatMessage = {
   author: "Business Buddy" | "User";
 };
 
+const baseApiUrl = new URL(import.meta.url).origin;
+
 async function submitProductChatMessage(
   messages: ChatMessage[],
   product: productsV3.V3Product,
 ) {
   try {
-    const response = await fetch("/api/chat", {
+    const response = await httpClient.fetchWithAuth(`${baseApiUrl}/api/chat`, {
       method: "POST",
       headers: {
         "Content-Type": "application/json",

package/dist/out.js

@@ -91124,6 +91124,21 @@ 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.
 
+<http_client_usage>
+IMPORTANT: Always use httpClient.fetchWithAuth() from @wix/essentials for API calls.
+This ensures proper authentication and authorization for all requests.
+
+Import pattern:
+\`\`\`typescript
+import { httpClient } from '@wix/essentials';
+\`\`\`
+
+Base URL construction:
+\`\`\`typescript
+const baseApiUrl = new URL(import.meta.url).origin;
+\`\`\`
+</http_client_usage>
+
 <example_api_spec>
 ${JSON.stringify({
       name: "Todo Management API",
@@ -91217,16 +91232,20 @@ ${JSON.stringify({
 </example_api_spec>
 
 <example_output_code>
+import { httpClient } from '@wix/essentials';
+
+const baseApiUrl = new URL(import.meta.url).origin;
+
 // Reading data - GET request
 async function getTodos(): Promise<Todo[]> {
-  const response = await fetch('/api/todos');
+  const response = await httpClient.fetchWithAuth(\`\${baseApiUrl}/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', {
+  const response = await httpClient.fetchWithAuth(\`\${baseApiUrl}/api/todos\`, {
     method: 'POST',
     headers: {
       'Content-Type': 'application/json',
@@ -91239,7 +91258,7 @@ async function createTodo(todo: Omit<Todo, 'id' | 'createdAt'>): Promise<Todo> {
 
 // 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}\`, {
+  const response = await httpClient.fetchWithAuth(\`\${baseApiUrl}/api/todos/\${id}\`, {
     method: 'PUT',
     headers: {
       'Content-Type': 'application/json',
@@ -122138,7 +122157,7 @@ var require_backend_api_instructions = __commonJS({
     "use strict";
     Object.defineProperty(exports2, "__esModule", { value: true });
     exports2.backendApiInstructions = void 0;
-    var backendApiRole = `You are a specialized code-generation agent for creating Astro Server Endpoints (API Routes) for fullstack applications.`;
+    var backendApiRole = `You are a specialized code-generation agent for creating Astro Server Endpoints (API Routes) for Wix CLI applications.`;
     var backendApiImplementationGuidelines = `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.`;
     var backendApiCoreKnowledge = `<astro_server_endpoints_overview>
@@ -122147,70 +122166,159 @@ Focus on creating maintainable, secure, and efficient API routes that integrate
 - 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
 </astro_server_endpoints_overview>
+
 <file_structure_and_naming>
 - API routes are created in \`src/pages/api/\` directory
-- File names become the endpoint path (e.g., \`/api/users.ts\` \u2192 \`/api/users\`)
-- The file name should be the same as the endpoint path (e.g., \`/api/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
+- File names become the endpoint path (e.g., \`src/pages/api/users.ts\` \u2192 \`/api/users\`)
+- For dynamic routes with parameters, use square brackets in the filename:
+  - \`src/pages/api/users/[id].ts\` \u2192 \`/api/users/:id\`
+  - \`src/pages/api/posts/[slug].ts\` \u2192 \`/api/posts/:slug\`
+  - \`src/pages/api/users/[userId]/posts/[postId].ts\` \u2192 \`/api/users/:userId/posts/:postId\`
+</file_structure_and_naming>
 
-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",
-    });
-  }
+<http_methods>
+Export named functions for each HTTP method. ALWAYS type with \`APIRoute\` from \`astro\`:
+
+\`\`\`typescript
+import type { APIRoute } from "astro";
 
-  return new Response(JSON.stringify(user), {
+export const GET: APIRoute = async ({ request }) => {
+  return new Response(JSON.stringify({ message: "Hello" }), {
     status: 200,
-    headers: {
-      "Content-Type": "application/json",
-    },
+    headers: { "Content-Type": "application/json" },
   });
-}
+};
+
+export const POST: APIRoute = async ({ request }) => {
+  const data = await request.json();
+  return new Response(JSON.stringify(data), {
+    status: 201,
+    headers: { "Content-Type": "application/json" },
+  });
+};
 \`\`\`
-</file_structure_and_naming>
-<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
-</typescript_patterns>
+</http_methods>
+
 <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\`
+### Path Parameters
+\`\`\`typescript
+export const GET: APIRoute = async ({ params }) => {
+  const { id } = params; // From /api/users/[id]
+
+  if (!id) {
+    return new Response(JSON.stringify({ error: "ID required" }), {
+      status: 400,
+      statusText: "Bad Request",
+      headers: { "Content-Type": "application/json" },
+    });
+  }
+
+  // Use id to fetch data
+};
+\`\`\`
+
+### Query Parameters
+\`\`\`typescript
+export const GET: APIRoute = async ({ request }) => {
+  const url = new URL(request.url);
+  const search = url.searchParams.get("search");
+  const limit = parseInt(url.searchParams.get("limit") || "10", 10);
+  const offset = parseInt(url.searchParams.get("offset") || "0", 10);
+
+  // Use query parameters
+};
+\`\`\`
+
+### Request Body (POST/PUT/PATCH)
+\`\`\`typescript
+export const POST: APIRoute = async ({ request }) => {
+  try {
+    const body = await request.json();
+    const { title, content } = body;
+
+    if (!title || !content) {
+      return new Response(
+        JSON.stringify({ error: "Title and content required" }),
+        {
+          status: 400,
+          statusText: "Bad Request",
+          headers: { "Content-Type": "application/json" },
+        }
+      );
+    }
+
+    // Process data
+  } catch {
+    return new Response(JSON.stringify({ error: "Invalid JSON" }), {
+      status: 400,
+      statusText: "Bad Request",
+      headers: { "Content-Type": "application/json" },
+    });
+  }
+};
+\`\`\`
+
+### Headers
+\`\`\`typescript
+const authHeader = request.headers.get("Authorization");
+const contentType = request.headers.get("Content-Type");
+\`\`\`
 </request_handling>
+
 <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\`
+Always return a \`Response\` object with proper status codes and headers:
+
+\`\`\`typescript
+// 200 OK
+return new Response(JSON.stringify({ data: result }), {
+  status: 200,
+  headers: { "Content-Type": "application/json" },
+});
+
+// 201 Created
+return new Response(JSON.stringify({ id: newId, ...data }), {
+  status: 201,
+  headers: { "Content-Type": "application/json" },
+});
+
+// 204 No Content (for DELETE)
+return new Response(null, { status: 204 });
+
+// 400 Bad Request
+return new Response(JSON.stringify({ error: "Invalid input" }), {
+  status: 400,
+  statusText: "Bad Request",
+  headers: { "Content-Type": "application/json" },
+});
+
+// 404 Not Found
+return new Response(JSON.stringify({ error: "Not found" }), {
+  status: 404,
+  statusText: "Not Found",
+  headers: { "Content-Type": "application/json" },
+});
+
+// 500 Internal Server Error
+return new Response(JSON.stringify({ error: "Internal server error" }), {
+  status: 500,
+  statusText: "Internal Server Error",
+  headers: { "Content-Type": "application/json" },
+});
+\`\`\`
 </response_patterns>
-<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
-</common_patterns>
-<best_practices>
-- Use proper TypeScript types
-- Return appropriate HTTP status codes
-- Include proper headers
+
+<code_quality_requirements>
+- Strict TypeScript: no \`any\`, explicit return types
+- ALWAYS type handlers with \`APIRoute\` from 'astro'
+- ALWAYS return \`Response\` objects with \`JSON.stringify()\` for JSON
+- ALWAYS include \`Content-Type: application/json\` header on JSON responses
+- ALWAYS include \`statusText\` in error responses (400, 404, 500)
+- ALWAYS handle errors with try/catch blocks
+- ALWAYS validate input parameters and request bodies
 - Use async/await for asynchronous operations
+- No \`@ts-ignore\` comments
 - Keep endpoints focused and single-purpose
-</best_practices>`;
+</code_quality_requirements>`;
     exports2.backendApiInstructions = {
       role: backendApiRole,
       implementationGuidelines: backendApiImplementationGuidelines,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@wix/ditto-codegen-public",
-  "version": "1.0.241",
+  "version": "1.0.242",
   "description": "AI-powered Wix CLI app generator - standalone executable",
   "scripts": {
     "build": "node build.mjs",
@@ -28,5 +28,5 @@
     "@wix/ditto-codegen": "1.0.0",
     "esbuild": "^0.27.2"
   },
-  "falconPackageHash": "656fb2b43ba0d3b3f04d85269efb0910cf864bb7f4695e0cde17decc"
+  "falconPackageHash": "90cb464e6901cf2953e1124fe897dd26936f1de6b224508edb726c64"
 }