@forgecart/cli 1.0.0 → 1.1.0

package/dist/templates/storefront-e2e-additions/playwright.config.ts

@@ -0,0 +1,26 @@
+import { defineConfig, devices } from '@playwright/test'
+import { nxE2EPreset } from '@nx/playwright/preset'
+
+import { workspaceRoot } from '@nx/devkit'
+
+const baseURL = process.env['BASE_URL'] || 'http://localhost:4200'
+
+export default defineConfig({
+  ...nxE2EPreset(__filename, { testDir: './src' }),
+  use: {
+    baseURL,
+    trace: 'on-first-retry',
+  },
+  webServer: {
+    command: 'npx nx run storefront:dev',
+    url: 'http://localhost:4200',
+    reuseExistingServer: !process.env.CI,
+    cwd: workspaceRoot,
+  },
+  projects: [
+    {
+      name: 'chromium',
+      use: { ...devices['Desktop Chrome'] },
+    },
+  ],
+})

package/dist/templates/storefront-e2e-additions/src/example.spec.ts

@@ -0,0 +1,11 @@
+import { test, expect } from '@playwright/test'
+
+test('has title', async ({ page }) => {
+  await page.goto('/')
+  expect(await page.locator('h1').innerText()).toContain('Our Products')
+})
+
+test('has cart link', async ({ page }) => {
+  await page.goto('/')
+  await expect(page.locator('a[href="/cart"]')).toBeVisible()
+})

package/dist/templates/workspace/.nxignore

@@ -0,0 +1,2 @@
+# ForgeCart deployment directories - exclude from Nx project detection
+.forgecart

package/package.json

@@ -1,42 +1,20 @@
 {
   "name": "@forgecart/cli",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "type": "module",
-  "description": "CLI tool for deploying applications to ForgéCart",
+  "description": "CLI tool for deploying applications to ForgeCart",
   "main": "dist/index.js",
   "bin": {
     "forgecart": "./bin/forgecart.js"
   },
-  "scripts": {
-    "build": "tsc",
-    "dev": "ts-node --esm src/index.ts",
-    "prepublishOnly": "npm run build"
+  "dependencies": {
+    "@forgecart/sdk": "1.2.5"
   },
   "files": [
     "dist",
     "bin",
     "templates"
   ],
-  "dependencies": {
-    "archiver": "^7.0.1",
-    "chalk": "^5.3.0",
-    "cli-table3": "^0.6.5",
-    "commander": "^12.1.0",
-    "form-data": "^4.0.0",
-    "graphql": "^16.8.1",
-    "graphql-request": "^6.1.0",
-    "inquirer": "^9.2.23",
-    "node-fetch": "^3.3.2",
-    "ora": "^8.0.1",
-    "ws": "^8.17.1"
-  },
-  "devDependencies": {
-    "@types/archiver": "^6.0.2",
-    "@types/inquirer": "^9.0.7",
-    "@types/node": "^20.11.5",
-    "@types/ws": "^8.5.10",
-    "typescript": "^5.9.3"
-  },
   "engines": {
     "node": ">=18.0.0"
   },
@@ -47,6 +25,6 @@
     "paas",
     "nodejs"
   ],
-  "author": "ForgéCart",
+  "author": "ForgeCart",
   "license": "MIT"
-}
+}

package/templates/application-additions/.forgecartignore

@@ -1,4 +1,4 @@
-# ForgéCart deployment ignore file
+# ForgeCart deployment ignore file
 # Files and directories listed here will not be uploaded during deployment
 
 # Dependencies (will be installed during build)

package/templates/application-additions/Procfile

@@ -1 +1 @@
-web: npm run start:prod
+web: node main.js

package/templates/application-additions/src/app/app.module.ts

@@ -0,0 +1,16 @@
+import { Module } from '@nestjs/common'
+import { ConfigModule } from '@nestjs/config'
+import { AppController } from './app.controller'
+import { AppService } from './app.service'
+import { ForgeCartService, ProductEventListenerService } from '../services'
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({
+      isGlobal: true,
+    }),
+  ],
+  controllers: [AppController],
+  providers: [AppService, ForgeCartService, ProductEventListenerService],
+})
+export class AppModule {}

package/templates/application-additions/src/services/forgecart.service.ts

@@ -0,0 +1,62 @@
+import { Injectable, OnModuleInit, OnModuleDestroy } from '@nestjs/common'
+import { ConfigService } from '@nestjs/config'
+import { ForgeCartSDK } from '@forgecart/sdk'
+
+/**
+ * ForgeCart SDK Service
+ *
+ * Singleton service that manages the ForgeCart SDK instance.
+ * The SDK is initialized once on module init to maintain
+ * persistent socket connections for real-time features.
+ */
+@Injectable()
+export class ForgeCartService implements OnModuleInit, OnModuleDestroy {
+  private sdk: ForgeCartSDK | null = null
+
+  constructor(private configService: ConfigService) {}
+
+  onModuleInit(): void {
+    const endpoint = this.configService.get<string>('FORGECART_API_URL')
+    const token = this.configService.get<string>('FORGECART_CHANNEL_TOKEN')
+
+    if (!token) {
+      throw new Error('FORGECART_CHANNEL_TOKEN environment variable is required')
+    }
+
+    this.sdk = new ForgeCartSDK({
+      endpoint: endpoint || 'http://localhost:3000',
+      token,
+    })
+  }
+
+  onModuleDestroy(): void {
+    if (this.sdk) {
+      this.sdk.dispose()
+    }
+    this.sdk = null
+  }
+
+  /**
+   * Get the ForgeCart SDK instance
+   */
+  getSDK(): ForgeCartSDK {
+    if (!this.sdk) {
+      throw new Error('ForgeCart SDK not initialized')
+    }
+    return this.sdk
+  }
+
+  /**
+   * Access Shop API operations
+   */
+  get shop() {
+    return this.getSDK().shop
+  }
+
+  /**
+   * Access Admin API operations (requires admin token)
+   */
+  get admin() {
+    return this.getSDK().admin
+  }
+}

package/templates/application-additions/src/services/index.ts

@@ -0,0 +1,2 @@
+export { ForgeCartService } from './forgecart.service'
+export { ProductEventListenerService } from './product-event-listener.service'

package/templates/application-additions/src/services/product-event-listener.service.ts

@@ -0,0 +1,150 @@
+import {
+  Injectable,
+  OnModuleInit,
+  OnModuleDestroy,
+  Logger,
+} from '@nestjs/common'
+import { ConfigService } from '@nestjs/config'
+import { ForgeCartService } from './forgecart.service'
+
+interface EventSubscription {
+  unsubscribe: () => void
+}
+
+@Injectable()
+export class ProductEventListenerService
+  implements OnModuleInit, OnModuleDestroy
+{
+  private readonly logger = new Logger(ProductEventListenerService.name)
+  private subscriptions: EventSubscription[] = []
+  private isAuthenticated = false
+
+  constructor(
+    private readonly forgeCart: ForgeCartService,
+    private readonly configService: ConfigService
+  ) {}
+
+  async onModuleInit(): Promise<void> {
+    await this.initialize()
+  }
+
+  onModuleDestroy(): void {
+    this.cleanup()
+  }
+
+  private async initialize(): Promise<void> {
+    const username = this.configService.get<string>('FORGECART_ADMIN_USERNAME')
+    const password = this.configService.get<string>('FORGECART_ADMIN_PASSWORD')
+
+    // Skip if credentials are not provided
+    if (!username || !password) {
+      this.logger.warn(
+        'FORGECART_ADMIN_USERNAME and FORGECART_ADMIN_PASSWORD not set. ' +
+          'Product event listeners will not be registered.'
+      )
+      return
+    }
+
+    try {
+      // Login with admin credentials
+      const loginResult = await this.forgeCart.admin.administrator.login({
+        username,
+        password,
+      })
+
+      const login = (
+        loginResult as { login?: { __typename?: string; message?: string } }
+      )?.login
+      if (login?.__typename !== 'CurrentUser') {
+        this.logger.error(
+          'Admin login failed:',
+          login?.message || 'Unknown error'
+        )
+        return
+      }
+
+      this.isAuthenticated = true
+      this.logger.log('Successfully authenticated as admin')
+
+      // Register event handlers
+      this.registerEventHandlers()
+    } catch (error) {
+      this.logger.error('Failed to initialize product event listener:', error)
+    }
+  }
+
+  private registerEventHandlers(): void {
+    if (!this.isAuthenticated) return
+
+    const sdk = this.forgeCart.getSDK()
+
+    // Non-blocking handlers
+    const productUpdatedSub = sdk.admin.registerEventHandler(
+      'product.updated',
+      (event) => {
+        this.logger.log(`Product updated: ${JSON.stringify(event)}`)
+        this.handleProductUpdated(event)
+      }
+    )
+    this.subscriptions.push(productUpdatedSub)
+
+    const productCreatedSub = sdk.admin.registerEventHandler(
+      'product.created',
+      (event) => {
+        this.logger.log(`Product created: ${JSON.stringify(event)}`)
+        this.handleProductCreated(event)
+      }
+    )
+    this.subscriptions.push(productCreatedSub)
+
+    const productDeletedSub = sdk.admin.registerEventHandler(
+      'product.deleted',
+      (event) => {
+        this.logger.log(`Product deleted: ${JSON.stringify(event)}`)
+        this.handleProductDeleted(event)
+      }
+    )
+    this.subscriptions.push(productDeletedSub)
+
+    // Blocking handler (must complete within 1000ms)
+    const variantUpdatedSub = sdk.admin.registerBlockingEventHandler(
+      'product.variant.updated',
+      async (event) => {
+        this.logger.log(
+          `Product variant updated (blocking): ${JSON.stringify(event)}`
+        )
+        await this.handleVariantUpdated(event)
+      }
+    )
+    this.subscriptions.push(variantUpdatedSub)
+
+    this.logger.log('Product event handlers registered successfully')
+  }
+
+  private handleProductUpdated(event: unknown): void {
+    // Implement custom logic here
+    this.logger.debug('handleProductUpdated called', event)
+  }
+
+  private handleProductCreated(event: unknown): void {
+    // Implement custom logic here
+    this.logger.debug('handleProductCreated called', event)
+  }
+
+  private handleProductDeleted(event: unknown): void {
+    // Implement custom logic here
+    this.logger.debug('handleProductDeleted called', event)
+  }
+
+  private async handleVariantUpdated(event: unknown): Promise<void> {
+    // Blocking handler - must complete within 1000ms
+    this.logger.debug('handleVariantUpdated called', event)
+  }
+
+  private cleanup(): void {
+    for (const subscription of this.subscriptions) {
+      subscription.unsubscribe()
+    }
+    this.subscriptions = []
+  }
+}

package/templates/application-e2e-additions/src/support/global-setup.ts

@@ -0,0 +1,16 @@
+import { waitForPortOpen } from '@nx/node/utils'
+
+/* eslint-disable */
+var __TEARDOWN_MESSAGE__: string
+
+module.exports = async function () {
+  // Start services that the app needs to run (e.g. database, docker-compose, etc.).
+  console.log('\nSetting up...\n')
+
+  const host = process.env.HOST ?? 'localhost'
+  const port = process.env.PORT ? Number(process.env.PORT) : 8080 // Match application's default port
+  await waitForPortOpen(port, { host })
+
+  // Hint: Use `globalThis` to pass variables to global teardown.
+  globalThis.__TEARDOWN_MESSAGE__ = '\nTearing down...\n'
+}

package/templates/application-e2e-additions/src/support/test-setup.ts

@@ -0,0 +1,9 @@
+/* eslint-disable */
+import axios from 'axios'
+
+module.exports = async function () {
+  // Configure axios for tests to use.
+  const host = process.env.HOST ?? 'localhost'
+  const port = process.env.PORT ?? '8080' // Match application's default port
+  axios.defaults.baseURL = `http://${host}:${port}`
+}

package/templates/storefront-additions/.forgecartignore

@@ -1,8 +1,8 @@
-# ForgéCart deployment ignore file
+# ForgeCart deployment ignore file
 # Files and directories listed here will not be uploaded during deployment
 
-# Dependencies (will be installed during build)
-node_modules/
+# Dependencies - only exclude root node_modules (standalone has its own)
+/node_modules/
 
 # Development files
 .git/
@@ -18,9 +18,17 @@ node_modules/
 *.swp
 *.swo
 
-# Build artifacts (we build on the server)
-.next/
-out/
+# Build artifacts - exclude root level only (standalone has nested .next that must be kept)
+/.next/cache/
+/.next/server/
+/.next/types/
+/.next/trace
+/.next/trace-build
+/.next/dev/
+/.next/build/
+/.next/diagnostics/
+# Keep .next/standalone/ and everything inside it
+/out/
 
 # Test files
 __tests__/
@@ -29,6 +37,22 @@ __tests__/
 *.spec.ts
 *.spec.tsx
 coverage/
+specs/
+
+# Source files - not needed for runtime
+src/
+
+# Config files not needed at runtime
+tsconfig.json
+tsconfig.spec.json
+project.json
+jest.config.cts
+eslint.config.mjs
+postcss.config.js
+tailwind.config.js
+.swcrc
+index.d.ts
+next-env.d.ts
 
 # Documentation
 README.md

package/templates/storefront-additions/Procfile

@@ -1 +1 @@
-web: npm run start
+web: node .next/standalone/apps/storefront/server.js

package/templates/storefront-additions/package.json

@@ -0,0 +1,11 @@
+{
+  "name": "storefront",
+  "version": "1.0.0",
+  "private": true,
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "scripts": {
+    "start": "node .next/standalone/apps/storefront/server.js"
+  }
+}

package/templates/storefront-additions/postcss.config.js

@@ -0,0 +1,5 @@
+module.exports = {
+  plugins: {
+    '@tailwindcss/postcss': {},
+  },
+}

package/templates/storefront-additions/src/app/cart/page.tsx

@@ -0,0 +1,77 @@
+'use client'
+
+import Link from 'next/link'
+import { useCart } from '../../context/CartContext'
+import { CartItem } from '../../components/CartItem'
+
+export default function CartPage() {
+  const { cart, loading, itemCount } = useCart()
+
+  if (loading && !cart) {
+    return (
+      <div className="max-w-4xl mx-auto px-4 py-8">
+        <h1 className="text-3xl font-bold mb-8 text-gray-900">Your Cart</h1>
+        <p className="text-gray-600">Loading cart...</p>
+      </div>
+    )
+  }
+
+  if (!cart || cart.lines.length === 0) {
+    return (
+      <div className="max-w-4xl mx-auto px-4 py-8">
+        <h1 className="text-3xl font-bold mb-8 text-gray-900">Your Cart</h1>
+        <p className="text-gray-600 mb-4">Your cart is empty.</p>
+        <Link
+          href="/"
+          className="inline-block bg-blue-600 text-white py-2 px-4 rounded-lg hover:bg-blue-700"
+        >
+          Continue Shopping
+        </Link>
+      </div>
+    )
+  }
+
+  const subtotal = (cart.subTotalWithTax / 100).toFixed(2)
+  const total = (cart.totalWithTax / 100).toFixed(2)
+
+  return (
+    <div className="max-w-4xl mx-auto px-4 py-8">
+      <h1 className="text-3xl font-bold mb-8 text-gray-900">Your Cart</h1>
+
+      <div className="bg-white rounded-lg shadow p-6">
+        {cart.lines
+          .filter((line) => line.productVariant)
+          .map((line) => (
+            <CartItem key={line.id} line={line as never} />
+          ))}
+
+        <div className="mt-6 pt-4 border-t">
+          <div className="flex justify-between text-lg mb-2">
+            <span className="text-gray-600">Subtotal ({itemCount} items)</span>
+            <span className="font-semibold">
+              {subtotal} {cart.currencyCode}
+            </span>
+          </div>
+          <div className="flex justify-between text-xl font-bold">
+            <span>Total</span>
+            <span>
+              {total} {cart.currencyCode}
+            </span>
+          </div>
+        </div>
+
+        <div className="mt-6 flex gap-4">
+          <Link
+            href="/"
+            className="flex-1 text-center border border-gray-300 py-3 rounded-lg hover:bg-gray-50"
+          >
+            Continue Shopping
+          </Link>
+          <button className="flex-1 bg-blue-600 text-white py-3 rounded-lg hover:bg-blue-700">
+            Checkout
+          </button>
+        </div>
+      </div>
+    </div>
+  )
+}

package/templates/storefront-additions/src/app/global.css

@@ -0,0 +1 @@
+@import "tailwindcss";

package/templates/storefront-additions/src/app/layout.tsx

@@ -0,0 +1,25 @@
+import './global.css'
+import { CartProvider } from '../context/CartContext'
+import { Header } from '../components/Header'
+
+export const metadata = {
+  title: 'Store',
+  description: 'Your ecommerce store',
+}
+
+export default function RootLayout({
+  children,
+}: {
+  children: React.ReactNode
+}) {
+  return (
+    <html lang="en">
+      <body className="bg-gray-50 min-h-screen">
+        <CartProvider>
+          <Header />
+          <main>{children}</main>
+        </CartProvider>
+      </body>
+    </html>
+  )
+}

package/templates/storefront-additions/src/app/page.tsx

@@ -0,0 +1,43 @@
+import { ProductList, Product } from '@forgecart/sdk/shop'
+import forgecart from '../lib/forgecart'
+import { ProductCard } from '../components/ProductCard'
+
+async function getProducts(): Promise<ProductList> {
+  try {
+    const result = await forgecart.shop.products.products({
+      options: {
+        take: 20,
+      },
+    })
+    return (result.products as ProductList) || { items: [], totalItems: 0 }
+  } catch (error) {
+    console.error('Failed to fetch products:', error)
+    return {
+      items: [] as Product[],
+      totalItems: 0,
+    }
+  }
+}
+
+export default async function HomePage() {
+  const products = await getProducts()
+
+  return (
+    <div className="max-w-7xl mx-auto px-4 py-8">
+      <h1 className="text-3xl font-bold mb-8 text-gray-900">Our Products</h1>
+
+      {products.items.length === 0 ? (
+        <p className="text-gray-600">
+          No products found. Make sure your ForgeCart channel is configured
+          correctly.
+        </p>
+      ) : (
+        <div className="grid grid-cols-1 sm:grid-cols-2 md:grid-cols-3 lg:grid-cols-4 gap-6">
+          {products.items.map((product: Product) => (
+            <ProductCard key={product.id} product={product as never} />
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}

package/templates/storefront-additions/src/components/AddToCartButton.tsx

@@ -0,0 +1,29 @@
+'use client'
+
+import { useState } from 'react'
+import { useCart } from '../context/CartContext'
+
+interface AddToCartButtonProps {
+  productVariantId: string
+}
+
+export function AddToCartButton({ productVariantId }: AddToCartButtonProps) {
+  const { addToCart } = useCart()
+  const [isAdding, setIsAdding] = useState(false)
+
+  const handleClick = async () => {
+    setIsAdding(true)
+    await addToCart(productVariantId, 1)
+    setIsAdding(false)
+  }
+
+  return (
+    <button
+      onClick={handleClick}
+      disabled={isAdding}
+      className="w-full bg-blue-600 text-white py-2 px-4 rounded-lg hover:bg-blue-700 disabled:bg-blue-300 disabled:cursor-not-allowed transition-colors"
+    >
+      {isAdding ? 'Adding...' : 'Add to Cart'}
+    </button>
+  )
+}