@forgecart/cli 1.0.0

package/package.json

@@ -0,0 +1,52 @@
+{
+  "name": "@forgecart/cli",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "CLI tool for deploying applications to ForgéCart",
+  "main": "dist/index.js",
+  "bin": {
+    "forgecart": "./bin/forgecart.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "ts-node --esm src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "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"
+  },
+  "keywords": [
+    "forgecart",
+    "cli",
+    "deploy",
+    "paas",
+    "nodejs"
+  ],
+  "author": "ForgéCart",
+  "license": "MIT"
+}

package/templates/application-additions/.forgecartignore

@@ -0,0 +1,37 @@
+# ForgéCart deployment ignore file
+# Files and directories listed here will not be uploaded during deployment
+
+# Dependencies (will be installed during build)
+node_modules/
+
+# Development files
+.git/
+.gitignore
+.env
+.env.local
+.env.development
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Build artifacts (we build on the server)
+dist/
+
+# Test files
+__tests__/
+test/
+*.test.ts
+*.spec.ts
+coverage/
+
+# Documentation
+README.md
+CHANGELOG.md
+docs/
+
+# OS files
+.DS_Store
+Thumbs.db

package/templates/application-additions/Procfile

@@ -0,0 +1 @@
+web: npm run start:prod

package/templates/application-additions/src/services/price-fetcher.service.ts

@@ -0,0 +1,72 @@
+import { Injectable, OnModuleInit } from '@nestjs/common'
+import { ForgecartClient } from '@forgecart/sdk'
+
+// Example service demonstrating ForgéCart SDK integration
+// This can be used for custom backend tasks like:
+// - Scheduled price updates
+// - Inventory synchronization
+// - Custom order processing
+// - Third-party integrations
+
+@Injectable()
+export class PriceFetcherService implements OnModuleInit {
+  private client: ForgecartClient
+
+  onModuleInit() {
+    this.client = new ForgecartClient({
+      channelToken: process.env.FORGECART_CHANNEL_TOKEN || '',
+      apiUrl: process.env.FORGECART_API_URL || 'https://api.forgecart.com',
+    })
+  }
+
+  async getProductPrices(productIds: string[]): Promise<
+    Array<{
+      productId: string
+      name: string
+      price: number
+      currencyCode: string
+    }>
+  > {
+    const prices = []
+
+    for (const productId of productIds) {
+      try {
+        const product = await this.client.shop.products.get(productId)
+        if (product && product.variants?.[0]) {
+          prices.push({
+            productId,
+            name: product.name,
+            price: product.variants[0].price,
+            currencyCode: product.variants[0].currencyCode,
+          })
+        }
+      } catch (error) {
+        console.error(`Failed to fetch price for product ${productId}:`, error)
+      }
+    }
+
+    return prices
+  }
+
+  async syncInventory(): Promise<{ synced: number; errors: number }> {
+    // Example: Sync inventory with external system
+    // This is a placeholder for custom business logic
+    let synced = 0
+    let errors = 0
+
+    try {
+      const products = await this.client.shop.products.list({ take: 100 })
+
+      for (const product of products.items || []) {
+        // Here you would implement your custom sync logic
+        // e.g., update external ERP, sync with warehouse system, etc.
+        synced++
+      }
+    } catch (error) {
+      console.error('Inventory sync failed:', error)
+      errors++
+    }
+
+    return { synced, errors }
+  }
+}

package/templates/storefront-additions/.forgecartignore

@@ -0,0 +1,40 @@
+# ForgéCart deployment ignore file
+# Files and directories listed here will not be uploaded during deployment
+
+# Dependencies (will be installed during build)
+node_modules/
+
+# Development files
+.git/
+.gitignore
+.env
+.env.local
+.env.development
+.env.development.local
+
+# IDE
+.idea/
+.vscode/
+*.swp
+*.swo
+
+# Build artifacts (we build on the server)
+.next/
+out/
+
+# Test files
+__tests__/
+*.test.ts
+*.test.tsx
+*.spec.ts
+*.spec.tsx
+coverage/
+
+# Documentation
+README.md
+CHANGELOG.md
+docs/
+
+# OS files
+.DS_Store
+Thumbs.db

package/templates/storefront-additions/Procfile

@@ -0,0 +1 @@
+web: npm run start

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

@@ -0,0 +1,78 @@
+import forgecart from '../../lib/forgecart'
+
+// Example product page using ForgéCart SDK
+// This demonstrates how to fetch and display products
+
+interface Product {
+  id: string
+  name: string
+  slug: string
+  description: string
+  featuredAsset?: {
+    preview: string
+  }
+  variants: Array<{
+    id: string
+    name: string
+    price: number
+    currencyCode: string
+  }>
+}
+
+async function getProducts(): Promise<Product[]> {
+  try {
+    // Fetch products from ForgéCart API
+    const result = await forgecart.shop.products.list({
+      take: 12,
+    })
+    return result.items || []
+  } catch (error) {
+    console.error('Failed to fetch products:', error)
+    return []
+  }
+}
+
+export default async function ProductsPage() {
+  const products = await getProducts()
+
+  return (
+    <div className="container mx-auto px-4 py-8">
+      <h1 className="text-3xl font-bold mb-8">Products</h1>
+
+      {products.length === 0 ? (
+        <p className="text-gray-600">
+          No products found. Make sure your ForgéCart channel is configured correctly.
+        </p>
+      ) : (
+        <div className="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 xl:grid-cols-4 gap-6">
+          {products.map((product) => (
+            <div
+              key={product.id}
+              className="border rounded-lg overflow-hidden shadow-sm hover:shadow-md transition-shadow"
+            >
+              {product.featuredAsset && (
+                <img
+                  src={product.featuredAsset.preview}
+                  alt={product.name}
+                  className="w-full h-48 object-cover"
+                />
+              )}
+              <div className="p-4">
+                <h2 className="text-lg font-semibold mb-2">{product.name}</h2>
+                <p className="text-gray-600 text-sm mb-3 line-clamp-2">
+                  {product.description}
+                </p>
+                {product.variants[0] && (
+                  <p className="text-lg font-bold text-blue-600">
+                    {(product.variants[0].price / 100).toFixed(2)}{' '}
+                    {product.variants[0].currencyCode}
+                  </p>
+                )}
+              </div>
+            </div>
+          ))}
+        </div>
+      )}
+    </div>
+  )
+}

package/templates/storefront-additions/src/lib/forgecart.ts

@@ -0,0 +1,11 @@
+import { ForgecartClient } from '@forgecart/sdk'
+
+// Initialize the ForgéCart SDK client
+// The channel token is read from environment variables
+export const forgecart = new ForgecartClient({
+  channelToken: process.env.FORGECART_CHANNEL_TOKEN || '',
+  apiUrl: process.env.FORGECART_API_URL || 'https://api.forgecart.com',
+})
+
+// Export for use in server components
+export default forgecart