create-auto-app 0.2.1 → 0.2.2

package/templates/shopping-app/example-integrations/product-catalogue-api/src/index.ts

@@ -0,0 +1,59 @@
+import express, { type Express } from 'express';
+import cors from 'cors';
+import swaggerUi from 'swagger-ui-express';
+import swaggerJsdoc from 'swagger-jsdoc';
+import productsRouter from './routes/products';
+
+const app: Express = express();
+const PORT: string = process.env.PORT ?? '3001';
+
+// Swagger configuration
+const swaggerOptions = {
+  definition: {
+    openapi: '3.0.0',
+    info: {
+      title: 'Product Catalog Service API',
+      version: '1.0.0',
+      description: 'A product catalog service with interactive documentation',
+    },
+    servers: [
+      {
+        url: `http://localhost:${PORT}`,
+        description: 'Development server',
+      },
+    ],
+  },
+  apis: ['./src/routes/products.ts'],
+};
+
+const swaggerSpec = swaggerJsdoc(swaggerOptions);
+
+// Middleware
+app.use(
+  cors({
+    origin: '*',
+  }),
+);
+app.use(express.json());
+
+// Swagger UI
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+app.use('/docs', ...(swaggerUi.serve as any), swaggerUi.setup(swaggerSpec) as any);
+
+// Routes
+app.use('/api/products', productsRouter);
+
+// Health check endpoint
+app.get('/health', (req, res) => {
+  res.json({ status: 'OK', timestamp: new Date().toISOString() });
+});
+
+// Only start server if not in test environment
+if (process.env.NODE_ENV !== 'test') {
+  app.listen(PORT, () => {
+    console.log(`Product catalog service running on port ${PORT}`);
+    console.log(`Swagger UI available at http://localhost:${PORT}/docs`);
+  });
+}
+
+export default app;

package/templates/shopping-app/example-integrations/product-catalogue-api/src/routes/products.ts

@@ -0,0 +1,181 @@
+import { Router, type Request, type Response } from 'express';
+import type { Router as ExpressRouter } from 'express';
+import { mockProducts } from '../data/products';
+
+const router: ExpressRouter = Router();
+
+/**
+ * @swagger
+ * components:
+ *   schemas:
+ *     ProductCatalogItem:
+ *       type: object
+ *       required:
+ *         - productId
+ *         - name
+ *         - category
+ *         - price
+ *         - tags
+ *         - imageUrl
+ *       properties:
+ *         productId:
+ *           type: string
+ *           description: Unique identifier for the product
+ *         name:
+ *           type: string
+ *           description: Product name
+ *         category:
+ *           type: string
+ *           description: Product category
+ *         price:
+ *           type: number
+ *           description: Product price in dollars
+ *         tags:
+ *           type: array
+ *           items:
+ *             type: string
+ *           description: Array of tags associated with the product
+ *         imageUrl:
+ *           type: string
+ *           description: URL of the product image
+ */
+
+/**
+ * @swagger
+ * /api/products:
+ *   get:
+ *     summary: Get all products
+ *     description: Retrieve a list of all products in the catalog
+ *     tags: [Products]
+ *     responses:
+ *       200:
+ *         description: List of all products
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: array
+ *               items:
+ *                 $ref: '#/components/schemas/ProductCatalogItem'
+ */
+router.get('/', (_req: Request, res: Response) => {
+  res.json(mockProducts);
+});
+
+/**
+ * @swagger
+ * /api/products/search:
+ *   get:
+ *     summary: Search products
+ *     description: Search products by name or tags
+ *     tags: [Products]
+ *     parameters:
+ *       - in: query
+ *         name: q
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: Search query for product name or tags
+ *     responses:
+ *       200:
+ *         description: List of matching products
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: array
+ *               items:
+ *                 $ref: '#/components/schemas/ProductCatalogItem'
+ *       400:
+ *         description: Query parameter is missing
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 error:
+ *                   type: string
+ */
+router.get('/search', (req: Request, res: Response) => {
+  const query = req.query.q as string;
+  if (!query) {
+    return res.status(400).json({ error: 'Query parameter "q" is required' });
+  }
+
+  const products = mockProducts.filter(
+    (p) =>
+      p.name.toLowerCase().includes(query.toLowerCase()) ||
+      p.tags.some((tag) => tag.toLowerCase().includes(query.toLowerCase())),
+  );
+  res.json(products);
+});
+
+/**
+ * @swagger
+ * /api/products/category/{category}:
+ *   get:
+ *     summary: Get products by category
+ *     description: Retrieve all products in a specific category
+ *     tags: [Products]
+ *     parameters:
+ *       - in: path
+ *         name: category
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: Category name to filter by
+ *     responses:
+ *       200:
+ *         description: List of products in the category
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: array
+ *               items:
+ *                 $ref: '#/components/schemas/ProductCatalogItem'
+ */
+router.get('/category/:category', (req: Request, res: Response) => {
+  const { category } = req.params as { category: string };
+  const products = mockProducts.filter((p) => p.category.toLowerCase() === category.toLowerCase());
+  res.json(products);
+});
+
+/**
+ * @swagger
+ * /api/products/{id}:
+ *   get:
+ *     summary: Get product by ID
+ *     description: Retrieve a specific product by its ID
+ *     tags: [Products]
+ *     parameters:
+ *       - in: path
+ *         name: id
+ *         required: true
+ *         schema:
+ *           type: string
+ *         description: Product ID
+ *     responses:
+ *       200:
+ *         description: Product details
+ *         content:
+ *           application/json:
+ *             schema:
+ *               $ref: '#/components/schemas/ProductCatalogItem'
+ *       404:
+ *         description: Product not found
+ *         content:
+ *           application/json:
+ *             schema:
+ *               type: object
+ *               properties:
+ *                 error:
+ *                   type: string
+ */
+router.get('/:id', (req: Request, res: Response) => {
+  const { id } = req.params as { id: string };
+  const product = mockProducts.find((p) => p.productId === id);
+  if (!product) {
+    return res.status(404).json({ error: 'Product not found' });
+  }
+  res.json(product);
+});
+
+export default router;

package/templates/shopping-app/example-integrations/product-catalogue-api/tsconfig.json

@@ -0,0 +1,9 @@
+{
+  "extends": "../../tsconfig.base.json",
+  "compilerOptions": {
+    "outDir": "./dist",
+    "rootDir": "./src"
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}

package/templates/shopping-app/flows/shopping-assistant.flow.ts

@@ -15,7 +15,7 @@ import {
   type Command,
   type Event,
   type State,
-} from '@auto-engineer/flowlang';
+} from '@auto-engineer/flow';
 
 import { AI, ProductCatalog, type DoChat, type ChatCompleted, type Products } from '../server/src/integrations';
 

package/templates/shopping-app/package.json

@@ -3,18 +3,22 @@
   "type": "module",
   "scripts": {
     "start": "dotenv -e .env -- pnpm --parallel start",
-    "build": "pnpm --parallel build"
+    "build": "pnpm --parallel build",
+    "start:ecommerce-site": "cd examples/ecommerce-site && pnpm start",
+    "start:product-api": "cd examples/product-catalogue-api && pnpm start",
+    "start:cart-api": "cd examples/cart-api && pnpm start",
+    "start:examples": "pnpm --parallel --filter @examples/* start 2>&1 | grep -E '(localhost|Local)' || true"
   },
   "dependencies": {
     "@auto-engineer/message-bus": "latest",
-    "@auto-engineer/backend-checks": "latest",
+    "@auto-engineer/server-checks": "latest",
     "@auto-engineer/design-system-importer": "latest",
-    "@auto-engineer/emmett-generator": "latest",
-    "@auto-engineer/flowlang": "latest",
+    "@auto-engineer/server-generator-apollo-emmett": "latest",
+    "@auto-engineer/flow": "latest",
     "@auto-engineer/frontend-checks": "latest",
-    "@auto-engineer/frontend-implementation": "latest",
+    "@auto-engineer/frontend-implementer": "latest",
     "@auto-engineer/information-architect": "latest",
-    "@auto-engineer/react-graphql-generator": "latest",
+    "@auto-engineer/frontend-generator-react-graphql": "latest",
     "@auto-engineer/server-implementer": "latest"
   },
   "devDependencies": {

package/templates/shopping-app/server/package.json

@@ -11,7 +11,7 @@
   },
   "dependencies": {
     "@auto-engineer/ai-gateway": "latest",
-    "@auto-engineer/flowlang": "latest",
+    "@auto-engineer/flow": "latest",
     "axios": "^1.11.0",
     "@event-driven-io/emmett": "^0.38.2",
     "type-graphql": "^2.0.0-rc.2",

package/templates/shopping-app/server/src/integrations/ai-integration.ts

@@ -1,4 +1,4 @@
-import { Integration, Event, Command } from '@auto-engineer/flowlang';
+import { Integration, Event, Command } from '@auto-engineer/flow';
 import {
   generateStructuredDataWithAI,
   AIProvider,

package/templates/shopping-app/server/src/integrations/cart-integration.ts

@@ -1,4 +1,4 @@
-import type { State, Integration } from '@auto-engineer/flowlang';
+import type { State, Integration } from '@auto-engineer/flow';
 import axios from 'axios';
 import { z } from '@auto-engineer/ai-gateway';
 

package/templates/shopping-app/server/src/integrations/product-catalogue-integration.ts

@@ -1,4 +1,4 @@
-import type { State, Integration } from '@auto-engineer/flowlang';
+import type { State, Integration } from '@auto-engineer/flow';
 import axios from 'axios';
 import { registerTool, z } from '@auto-engineer/ai-gateway';