create-auto-app 0.1.0 → 0.1.2

package/templates/shopping-app/client/tailwind.config.ts

@@ -0,0 +1,92 @@
+import type { Config } from 'tailwindcss';
+import tailwindAnimate from 'tailwindcss-animate';
+
+export default {
+  darkMode: ['class'],
+  content: ['./pages/**/*.{ts,tsx}', './components/**/*.{ts,tsx}', './app/**/*.{ts,tsx}', './src/**/*.{ts,tsx}'],
+  prefix: '',
+  theme: {
+    container: {
+      center: true,
+      padding: '2rem',
+      screens: {
+        '2xl': '1400px',
+      },
+    },
+    extend: {
+      colors: {
+        border: 'hsl(var(--border))',
+        input: 'hsl(var(--input))',
+        ring: 'hsl(var(--ring))',
+        background: 'hsl(var(--background))',
+        foreground: 'hsl(var(--foreground))',
+        primary: {
+          DEFAULT: 'hsl(var(--primary))',
+          foreground: 'hsl(var(--primary-foreground))',
+        },
+        secondary: {
+          DEFAULT: 'hsl(var(--secondary))',
+          foreground: 'hsl(var(--secondary-foreground))',
+        },
+        destructive: {
+          DEFAULT: 'hsl(var(--destructive))',
+          foreground: 'hsl(var(--destructive-foreground))',
+        },
+        muted: {
+          DEFAULT: 'hsl(var(--muted))',
+          foreground: 'hsl(var(--muted-foreground))',
+        },
+        accent: {
+          DEFAULT: 'hsl(var(--accent))',
+          foreground: 'hsl(var(--accent-foreground))',
+        },
+        popover: {
+          DEFAULT: 'hsl(var(--popover))',
+          foreground: 'hsl(var(--popover-foreground))',
+        },
+        card: {
+          DEFAULT: 'hsl(var(--card))',
+          foreground: 'hsl(var(--card-foreground))',
+        },
+        sidebar: {
+          DEFAULT: 'hsl(var(--sidebar-background))',
+          foreground: 'hsl(var(--sidebar-foreground))',
+          primary: 'hsl(var(--sidebar-primary))',
+          'primary-foreground': 'hsl(var(--sidebar-primary-foreground))',
+          accent: 'hsl(var(--sidebar-accent))',
+          'accent-foreground': 'hsl(var(--sidebar-accent-foreground))',
+          border: 'hsl(var(--sidebar-border))',
+          ring: 'hsl(var(--sidebar-ring))',
+        },
+      },
+      borderRadius: {
+        lg: 'var(--radius)',
+        md: 'calc(var(--radius) - 2px)',
+        sm: 'calc(var(--radius) - 4px)',
+      },
+      keyframes: {
+        'accordion-down': {
+          from: {
+            height: '0',
+          },
+          to: {
+            height: 'var(--radix-accordion-content-height)',
+          },
+        },
+        'accordion-up': {
+          from: {
+            height: 'var(--radix-accordion-content-height)',
+          },
+          to: {
+            height: '0',
+          },
+        },
+      },
+      animation: {
+        'accordion-down': 'accordion-down 0.2s ease-out',
+        'accordion-up': 'accordion-up 0.2s ease-out',
+      },
+    },
+  },
+  plugins: [tailwindAnimate],
+} satisfies Config;

package/templates/shopping-app/client/tsconfig.json

@@ -0,0 +1,49 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "lib": ["ES2023", "DOM", "DOM.Iterable"],
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "isolatedModules": true,
+    "moduleDetection": "force",
+    "noEmit": true,
+    "jsx": "react-jsx",
+    "jsxImportSource": "react",
+
+    /* Type Safety */
+    "strict": false,
+    "strictNullChecks": false,
+    "strictFunctionTypes": false,
+    "strictBindCallApply": false,
+    "strictPropertyInitialization": false,
+    "noImplicitAny": false,
+    "noImplicitThis": false,
+    //    "alwaysStrict": true,
+
+    /* Quality Checks */
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noFallthroughCasesInSwitch": false,
+    "noImplicitReturns": false,
+    "exactOptionalPropertyTypes": false,
+    "forceConsistentCasingInFileNames": false,
+    "skipLibCheck": true,
+    "skipDefaultLibCheck": true,
+    "allowSyntheticDefaultImports": true,
+
+    /* Paths / Aliases */
+    "baseUrl": ".",
+    "paths": {
+      "@/*": ["./src/*"]
+    }
+  },
+  "include": [
+    "src/**/*",
+    "vite.config.ts",
+    "codegen.ts",
+    "tailwind.config.ts",
+    "eslint.config.ts",
+    "auto-configure.ts"
+  ],
+  "exclude": ["node_modules/**", "dist"]
+}

package/templates/shopping-app/client/vite.config.ts

@@ -0,0 +1,17 @@
+import { defineConfig } from 'vite';
+import react from '@vitejs/plugin-react';
+import path from 'path';
+
+// https://vitejs.dev/config/
+export default defineConfig(({ mode }) => ({
+  server: {
+    host: '::',
+    port: 8080,
+  },
+  plugins: [react()],
+  resolve: {
+    alias: {
+      '@': path.resolve(__dirname, './src'),
+    },
+  },
+}));

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

@@ -0,0 +1,369 @@
+import {
+  commandSlice,
+  querySlice,
+  reactSlice,
+  flow,
+  createBuilders,
+  should,
+  given,
+  when,
+  specs,
+  gql,
+  source,
+  data,
+  sink,
+  type Command,
+  type Event,
+  type State,
+  registerIntegrations,
+} from '@auto-engineer/flowlang';
+
+import  { AI, ProductCatalog, type DoChat, type ChatCompleted, type Products } from '../server/src/integrations';
+
+registerIntegrations(ProductCatalog, AI);
+
+type ShoppingCriteriaEntered = Event<
+  'ShoppingCriteriaEntered',
+  {
+    sessionId: string;
+    criteria: string;
+    timestamp: Date;
+  }
+>;
+
+type ItemsAddedToCart = Event<
+  'ItemsAddedToCart',
+  {
+    sessionId: string;
+    items: { productId: string; quantity: number }[];
+    timestamp: Date;
+  }
+>;
+
+type EnterShoppingCriteria = Command<
+  'EnterShoppingCriteria',
+  {
+    sessionId: string;
+    criteria: string;
+  }
+>;
+
+type SuggestedItems = State<
+  'SuggestedItems',
+  {
+    sessionId: string;
+    items: { productId: string; name: string; quantity: number; reason: string }[];
+  }
+>;
+
+type SuggestShoppingItems = Command<
+  'SuggestShoppingItems',
+  {
+    sessionId: string;
+    prompt: string;
+  }
+>;
+
+type ShoppingItemsSuggested = Event<
+  'ShoppingItemsSuggested',
+  {
+    sessionId: string;
+    suggestedItems: { productId: string; name: string; quantity: number; reason: string }[];
+  }
+>;
+
+type AddItemsToCart = Command<
+  'AddItemsToCart',
+  {
+    sessionId: string;
+    items: { productId: string; quantity: number }[];
+  }
+>;
+
+const { Events, Commands, State } = createBuilders()
+  .events<ShoppingCriteriaEntered | ShoppingItemsSuggested | ChatCompleted | ItemsAddedToCart>()
+  .commands<EnterShoppingCriteria | SuggestShoppingItems | DoChat | AddItemsToCart>()
+  .state<{
+    Products: Products['data'];
+    SuggestedItems: SuggestedItems['data'];
+  }>();
+
+flow('Seasonal Assistant', () => {
+  commandSlice('enters shopping criteria into assistant')
+    .client(() => {
+      specs('Assistant Chat Interface', () => {
+        should('allow shopper to describe their shopping needs in natural language');
+        should('provide a text input for entering criteria');
+        should('show examples of what to include (age, interests, budget)');
+        should('show a button to submit the criteria');
+        should('generate a persisted session id for a visit');
+        should('show the header on top of the page');
+      });
+    })
+    .request(gql`
+      mutation EnterShoppingCriteria($input: EnterShoppingCriteriaInput!) {
+        enterShoppingCriteria(input: $input) {
+          success
+          error {
+            type
+            message
+          }
+        }
+      }
+    `)
+    .server(() => {
+      data([sink().event('ShoppingCriteriaEntered').toStream('shopping-session-${sessionId}')]);
+      specs('When shopper submits criteria, a shopping session is started', () => {
+        when(
+          Commands.EnterShoppingCriteria({
+            sessionId: 'shopper-123',
+            criteria:
+              'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+          }),
+        ).then([
+          Events.ShoppingCriteriaEntered({
+            sessionId: 'shopper-123',
+            criteria:
+              'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+            timestamp: new Date(),
+          }),
+        ]);
+      });
+    });
+
+  reactSlice('creates a chat session ').server(() => {
+    specs('When shopping criteria are entered, request wishlist creation', () => {
+      when([
+        Events.ShoppingCriteriaEntered({
+          sessionId: 'session-abc',
+          criteria:
+            'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+          timestamp: new Date(),
+        }),
+      ]).then([
+        Commands.SuggestShoppingItems({
+          sessionId: 'session-abc',
+          prompt:
+            'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+        }),
+      ]);
+    });
+  });
+
+  commandSlice('selects items relevant to the shopping criteria ').server(() => {
+    data([
+      sink()
+        .command('SuggestShoppingItems')
+        .toIntegration(AI, 'DoChat', 'command')
+        .withState(source().state('Products').fromIntegration(ProductCatalog))
+        .additionalInstructions(
+          'add the following to the DoChat: schemaName: Products, systemPrompt: use the PRODUCT_CATALOGUE_PRODUCTS MCP tool to get product data',
+        ),
+      sink().event('ShoppingItemsSuggested').toStream('shopping-session-${sessionId}'),
+    ]);
+
+    specs('When chat is triggered, AI suggests items based on product catalog', () => {
+      given([
+        State.Products({
+          products: [
+            {
+              productId: 'prod-soccer-ball',
+              name: 'Super Soccer Ball',
+              category: 'Sports',
+              price: 10,
+              tags: ['soccer', 'sports'],
+              imageUrl: 'https://example.com/soccer-ball.jpg',
+            },
+            {
+              productId: 'prod-craft-kit',
+              name: 'Deluxe Craft Kit',
+              category: 'Arts & Crafts',
+              price: 25,
+              tags: ['crafts', 'art', 'creative'],
+              imageUrl: 'https://example.com/craft-kit.jpg',
+            },
+            {
+              productId: 'prod-laptop-bag',
+              name: 'Tech Laptop Backpack',
+              category: 'School Supplies',
+              price: 45,
+              tags: ['computers', 'tech', 'school'],
+              imageUrl: 'https://example.com/laptop-bag.jpg',
+            },
+            {
+              productId: 'prod-mtg-starter',
+              name: 'Magic the Gathering Starter Set',
+              category: 'Games',
+              price: 30,
+              tags: ['magic', 'tcg', 'games'],
+              imageUrl: 'https://example.com/mtg-starter.jpg',
+            },
+          ],
+        }),
+      ])
+        .when(
+          Commands.SuggestShoppingItems({
+            sessionId: 'session-abc',
+            prompt:
+              'I need back-to-school items for my 7-year-old daughter who loves soccer and crafts, and my 12-year-old son who is into computers and Magic the Gathering.',
+          }),
+        )
+        .then([
+          Events.ShoppingItemsSuggested({
+            sessionId: 'session-abc',
+            suggestedItems: [
+              {
+                productId: 'prod-soccer-ball',
+                name: 'Super Soccer Ball',
+                quantity: 1,
+                reason: 'Perfect for your daughter who loves soccer',
+              },
+              {
+                productId: 'prod-craft-kit',
+                name: 'Deluxe Craft Kit',
+                quantity: 1,
+                reason: 'Great for creative activities and crafts',
+              },
+              {
+                productId: 'prod-laptop-bag',
+                name: 'Tech Laptop Backpack',
+                quantity: 1,
+                reason: `Essential for your son's school computer needs`,
+              },
+              {
+                productId: 'prod-mtg-starter',
+                name: 'Magic the Gathering Starter Set',
+                quantity: 1,
+                reason: 'Ideal starter set for Magic the Gathering enthusiasts',
+              },
+            ],
+          }),
+        ]);
+    });
+  });
+
+  querySlice('views suggested items')
+    .request(gql`
+      query GetSuggestedItems($sessionId: ID!) {
+        suggestedItems(sessionId: $sessionId) {
+          items {
+            productId
+            name
+            quantity
+            reason
+          }
+        }
+      }
+    `)
+    .client(() => {
+      specs('Suggested Items Screen', () => {
+        should('display all suggested items with names and reasons');
+        should('show quantity selectors for each item');
+        should('have an "Add to Cart" button for selected items');
+        should('allow removing items from the suggestions');
+      });
+    })
+    .server(() => {
+      data([source().state('SuggestedItems').fromProjection('SuggestedItemsProjection', 'sessionId')]);
+
+      specs('Suggested items are available for viewing', () => {
+        given([
+          Events.ShoppingItemsSuggested({
+            sessionId: 'session-abc',
+            suggestedItems: [
+              {
+                productId: 'prod-soccer-ball',
+                name: 'Super Soccer Ball',
+                quantity: 1,
+                reason: 'Perfect for your daughter who loves soccer',
+              },
+              {
+                productId: 'prod-craft-kit',
+                name: 'Deluxe Craft Kit',
+                quantity: 1,
+                reason: 'Great for creative activities and crafts',
+              },
+              {
+                productId: 'prod-laptop-bag',
+                name: 'Tech Laptop Backpack',
+                quantity: 1,
+                reason: `Essential for your son's school computer needs`,
+              },
+              {
+                productId: 'prod-mtg-starter',
+                name: 'Magic the Gathering Starter Set',
+                quantity: 1,
+                reason: 'Ideal starter set for Magic the Gathering enthusiasts',
+              },
+            ],
+          }),
+        ]).then([
+          State.SuggestedItems({
+            sessionId: 'session-abc',
+            items: [
+              {
+                productId: 'prod-soccer-ball',
+                name: 'Super Soccer Ball',
+                quantity: 1,
+                reason: 'Perfect for your daughter who loves soccer',
+              },
+              {
+                productId: 'prod-craft-kit',
+                name: 'Deluxe Craft Kit',
+                quantity: 1,
+                reason: 'Great for creative activities and crafts',
+              },
+              {
+                productId: 'prod-laptop-bag',
+                name: 'Tech Laptop Backpack',
+                quantity: 1,
+                reason: `Essential for your son's school computer needs`,
+              },
+              {
+                productId: 'prod-mtg-starter',
+                name: 'Magic the Gathering Starter Set',
+                quantity: 1,
+                reason: 'Ideal starter set for Magic the Gathering enthusiasts',
+              },
+            ],
+          }),
+        ]);
+      });
+    });
+
+  commandSlice('accepts items and adds to their cart')
+    .client(() => {
+      specs('Suggested Items Screen', () => {
+        should('allow selecting specific items to add');
+        should('update quantities before adding to cart');
+        should('provide feedback when items are added');
+      });
+    })
+    .server(() => {
+      data([sink().event('ItemsAddedToCart').toStream('shopping-session-${sessionId}')]);
+      specs('When shopper accepts items, they are added to cart', () => {
+        when(
+          Commands.AddItemsToCart({
+            sessionId: 'session-abc',
+            items: [
+              { productId: 'prod-soccer-ball', quantity: 1 },
+              { productId: 'prod-craft-kit', quantity: 1 },
+              { productId: 'prod-laptop-bag', quantity: 1 },
+              { productId: 'prod-mtg-starter', quantity: 1 },
+            ],
+          }),
+        ).then([
+          Events.ItemsAddedToCart({
+            sessionId: 'session-abc',
+            items: [
+              { productId: 'prod-soccer-ball', quantity: 1 },
+              { productId: 'prod-craft-kit', quantity: 1 },
+              { productId: 'prod-laptop-bag', quantity: 1 },
+              { productId: 'prod-mtg-starter', quantity: 1 },
+            ],
+            timestamp: new Date(),
+          }),
+        ]);
+      });
+    });
+});

package/templates/shopping-app/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "shopping-assistant",
+  "type": "module",
+  "scripts": {
+    "start": "dotenv -e .env -- pnpm --parallel start",
+    "build": "pnpm --parallel build"
+  },
+  "dependencies": {
+    "@auto-engineer/message-bus": "latest",
+    "@auto-engineer/backend-checks": "latest",
+    "@auto-engineer/design-system-importer": "latest",
+    "@auto-engineer/emmett-generator": "latest",
+    "@auto-engineer/flowlang": "latest",
+    "@auto-engineer/frontend-checks": "latest",
+    "@auto-engineer/frontend-implementation": "latest",
+    "@auto-engineer/information-architect": "latest",
+    "@auto-engineer/react-graphql-generator": "latest",
+    "@auto-engineer/server-implementer": "latest"
+  },
+  "devDependencies": {
+    "dotenv": "^16.4.5",
+    "dotenv-cli": "^9.0.0",
+    "tsx": "^3.12.7"
+  }
+}

package/templates/shopping-app/pnpm-workspace.yaml

@@ -0,0 +1,2 @@
+  packages:
+    - '*'

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

@@ -0,0 +1,25 @@
+{
+  "name": "generated-server",
+  "version": "0.0.0",
+  "private": true,
+  "type": "module",
+  "scripts": {
+    "start": "tsx --no-deprecation src/server.ts",
+    "type-check": "tsc --noEmit",
+    "test": "vitest run",
+    "dev": "tsx --no-deprecation src/server.ts"
+  },
+  "dependencies": {
+    "@auto-engineer/ai-gateway": "latest",
+    "@auto-engineer/flowlang": "latest",
+    "axios": "^1.11.0",
+    "@event-driven-io/emmett": "^0.38.2",
+    "type-graphql": "^2.0.0-rc.2",
+    "graphql": "^16.11.0",
+    "fast-glob": "^3.3.3",
+    "reflect-metadata": "^0.2.2",
+    "apollo-server": "^3.13.0",
+    "uuid": "^10.0.0"
+  },
+  "devDependencies": {}
+}

package/templates/shopping-app/server/scripts/generate-schema.ts

@@ -0,0 +1,31 @@
+import 'reflect-metadata';
+import { buildSchema } from 'type-graphql';
+import { printSchema } from 'graphql';
+import { writeFile } from 'fs/promises';
+import * as path from 'path';
+import { loadResolvers } from '../src/utils/loadResolvers.js';
+
+async function main() {
+  try {
+    const resolvers = await loadResolvers('src/domain/flows/**/*.resolver.{ts,js}');
+    const schema = await buildSchema({
+      resolvers: resolvers as any,
+      emitSchemaFile: false,
+    });
+    const printedSchema = printSchema(schema);
+
+    const contextDir = path.resolve('/Users/sam/WebstormProjects/top/my-shop', '.context');
+    const schemaPath = path.join(contextDir, 'schema.graphql');
+    await writeFile(schemaPath, printedSchema, 'utf-8');
+
+    console.log(`✅ GraphQL schema generated at: ${schemaPath}`);
+  } catch (error) {
+    console.error(`❌ GraphQL schema generation failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    process.exit(1);
+  }
+}
+
+main().catch((err) => {
+  console.error(err);
+  process.exit(1);
+});

package/templates/shopping-app/server/src/domain/flows/seasonal-assistant/accepts-items-and-adds-to-their-cart/commands.ts

@@ -0,0 +1,8 @@
+import { Command } from "@event-driven-io/emmett";
+export type AddItemsToCart = Command<
+  "AddItemsToCart",
+  {
+    sessionId: string;
+    items: Array<{ productId: string; quantity: number }>;
+  }
+>;

package/templates/shopping-app/server/src/domain/flows/seasonal-assistant/accepts-items-and-adds-to-their-cart/decide.specs.ts

@@ -0,0 +1,46 @@
+import { describe, it } from "vitest";
+import { DeciderSpecification } from "@event-driven-io/emmett";
+import { decide } from "./decide";
+import { evolve } from "./evolve";
+import { initialState } from "./state";
+
+describe("Seasonal Assistant | accepts items and adds to their cart", () => {
+  const given = DeciderSpecification.for({
+    decide,
+    evolve,
+    initialState,
+  });
+
+  it("should emit ItemsAddedToCart for valid AddItemsToCart", () => {
+    given([])
+      .when({
+        type: "AddItemsToCart",
+        data: {
+          sessionId: "session-abc",
+          items: [
+            { productId: "prod-soccer-ball", quantity: 1 },
+            { productId: "prod-craft-kit", quantity: 1 },
+            { productId: "prod-laptop-bag", quantity: 1 },
+            { productId: "prod-mtg-starter", quantity: 1 },
+          ],
+        },
+        metadata: { now: new Date() },
+      })
+
+      .then([
+        {
+          type: "ItemsAddedToCart",
+          data: {
+            sessionId: "session-abc",
+            items: [
+              { productId: "prod-soccer-ball", quantity: 1 },
+              { productId: "prod-craft-kit", quantity: 1 },
+              { productId: "prod-laptop-bag", quantity: 1 },
+              { productId: "prod-mtg-starter", quantity: 1 },
+            ],
+            timestamp: new Date("2025-08-28T04:56:47.409Z"),
+          },
+        },
+      ]);
+  });
+});