@crossdelta/platform-sdk 0.5.12 → 0.7.0

package/bin/templates/workspace/.github/workflows/publish-packages.yml

@@ -56,6 +56,8 @@ jobs:
             mapfile -t dirs < <(find packages -mindepth 1 -maxdepth 1 -type d | sort)
             for dir in "${dirs[@]}"; do
               [ -f "$dir/package.json" ] || continue
+              is_private=$(jq -r '.private // false' "$dir/package.json")
+              [ "$is_private" = "true" ] && continue
               pkg_name=$(jq -r '.name // empty' "$dir/package.json")
               [ -n "$pkg_name" ] || continue
               slug=$(basename "$dir")
@@ -69,6 +71,8 @@ jobs:
             changed_dirs=$(git diff --name-only "$base" "$HEAD_SHA" -- 'packages/*' | cut -d/ -f1-2 | sort -u)
             while IFS= read -r dir; do
               [ -f "$dir/package.json" ] || continue
+              is_private=$(jq -r '.private // false' "$dir/package.json")
+              [ "$is_private" = "true" ] && continue
               pkg_name=$(jq -r '.name // empty' "$dir/package.json")
               [ -n "$pkg_name" ] && add_entry "$pkg_name" "$dir"
             done <<< "$changed_dirs"
@@ -98,11 +102,6 @@ jobs:
 
       - uses: oven-sh/setup-bun@v2
 
-      - uses: actions/setup-node@v4
-        with:
-          node-version: '20'
-          registry-url: https://registry.npmjs.org
-
       - name: Install dependencies
         run: bun install
 
@@ -137,8 +136,8 @@ jobs:
       - name: Publish
         working-directory: ${{ matrix.package.dir }}
         env:
-          NODE_AUTH_TOKEN: ${{ secrets.NPMJS_TOKEN }}
-        run: npm publish --access=public
+          NPM_CONFIG_TOKEN: ${{ secrets.NPM_TOKEN }}
+        run: bun publish --access=public --provenance --tolerate-republish
 
       - name: Commit version bump
         if: steps.bump.outputs.bumped == 'true'

package/bin/templates/workspace/package.json.hbs

@@ -13,9 +13,27 @@
   },
   "pf": {
     "registry": "{{projectName}}/platform",
-    "dev": {
-      "watchDirs": ["infra/services"],
-      "watchPackages": ["services", "apps"]
+    "commands": {
+      "pulumi": {
+        "cwd": "infra"
+      }
+    },
+    "paths": {
+      "services": {
+        "path": "services",
+        "watch": true
+      },
+      "apps": {
+        "path": "apps",
+        "watch": true
+      },
+      "packages": {
+        "path": "packages",
+        "watch": true
+      },
+      "contracts": {
+        "path": "packages/contracts"
+      }
     }
   },
   "devDependencies": {

package/bin/templates/workspace/packages/contracts/README.md.hbs

@@ -0,0 +1,134 @@
+# {{scope}}/contracts
+
+Shared event contracts for cross-service event consumption.
+
+## Purpose
+
+This package contains **shared event definitions** (contracts) for events that are consumed by multiple services. When an event is used by more than one service, define it here to ensure type consistency across the platform.
+
+## Structure
+
+```
+src/
+├── events/            # Event contracts and mock data
+│   ├── order-created.ts        # Contract definition
+│   ├── order-created.mock.json # Mock data for testing
+│   └── index.ts                # Re-exports
+└── index.ts           # Main exports
+```
+
+**Contract files contain:**
+- Zod schema definition
+- Contract object (type + schema)
+- TypeScript type inference
+- Mock JSON for `pf event:publish`
+
+## Usage
+
+### In Event Handlers (Consumers)
+
+```ts
+import { handleEvent } from '@crossdelta/cloudevents'
+import { OrderCreatedContract, type OrderCreatedData } from '{{scope}}/contracts'
+
+export default handleEvent(OrderCreatedContract, async (data: OrderCreatedData) => {
+  // data is fully typed from contract
+  console.log(data.orderId, data.customerId)
+})
+```
+
+### In Publishers (REST APIs)
+
+```ts
+import { publish } from '@crossdelta/cloudevents'
+import { OrderCreatedContract } from '{{scope}}/contracts'
+
+// Type-safe publishing with contract
+await publish(OrderCreatedContract, {
+  orderId: 'order-123',
+  customerId: 'cust-456',
+  total: 99.99,
+  items: [...]
+})
+```
+
+### In Use-Cases
+
+```ts
+import type { OrderCreatedData } from '{{scope}}/contracts'
+
+export const processOrder = async (data: OrderCreatedData) => {
+  // Use typed event data
+}
+```
+
+## Adding New Contracts
+
+Contracts are **auto-generated** when you create event handlers:
+
+```bash
+# 1. Create service with event handler
+pf new hono-micro notifications --ai -d "Sends emails on order.created events"
+
+# 2. Generate contract (if missing) and mock data
+pf event:generate services/notifications
+```
+
+This creates:
+- `packages/contracts/src/events/order-created.ts` (contract)
+- `packages/contracts/src/events/order-created.mock.json` (mock)
+- Updates `packages/contracts/src/index.ts` (exports)
+
+### Manual Contract Creation
+
+```ts
+// packages/contracts/src/events/order-created.ts
+import { createContract } from '@crossdelta/cloudevents'
+import { z } from 'zod'
+
+export const OrderCreatedSchema = z.object({
+  orderId: z.string(),
+  customerId: z.string(),
+  total: z.number(),
+  items: z.array(z.object({
+    productId: z.string(),
+    quantity: z.number(),
+    price: z.number(),
+  })),
+})
+
+export const OrderCreatedContract = createContract({
+  type: 'order.created',
+  schema: OrderCreatedSchema,
+})
+
+export type OrderCreatedData = z.infer<typeof OrderCreatedContract.schema>
+```
+
+## Testing with Mocks
+
+```bash
+# List all available events
+pf event:list
+
+# Publish mock event
+pf event:publish order.created
+
+# Publish with custom data
+pf event:publish order.created --data '{"orderId":"test-123"}'
+```
+
+## Guidelines
+
+- ✅ Use contracts for **shared events** (multi-consumer)
+- ✅ Export both contract and inferred type
+- ✅ Keep contracts minimal and focused
+- ✅ Generate mocks for all contracts
+- ❌ Don't put business logic in contracts
+- ❌ Don't include event handlers in this package
+
+**Naming conventions:**
+- Contracts: `OrderCreatedContract`
+- Types: `OrderCreatedData`
+- Files: `order-created.ts`
+- Event types: `order.created` (dot notation)

package/bin/templates/workspace/packages/contracts/package.json.hbs

@@ -0,0 +1,19 @@
+{
+  "name": "{{scope}}/contracts",
+  "private": true,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "default": "./src/index.ts"
+    }
+  },
+  "dependencies": {
+    "@crossdelta/cloudevents": "workspace:*",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.9.4",
+    "typescript": "^5.7.2"
+  }
+}

package/bin/templates/workspace/packages/contracts/src/index.ts

@@ -0,0 +1,8 @@
+// Export your event contracts and schemas here
+// Example:
+// export * from './events/order-created.schema'
+// export * from './events/order-created.contract'
+
+export * from './events/order-created'
+export * from './events/user-updated'
+export * from './events/order'

package/bin/templates/workspace/packages/contracts/tsconfig.json.hbs

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

package/install.sh

@@ -0,0 +1,160 @@
+#!/usr/bin/env bash
+set -e
+
+# Colors for output
+RED='\033[0;31m'
+GREEN='\033[0;32m'
+YELLOW='\033[1;33m'
+BLUE='\033[0;34m'
+CYAN='\033[0;36m'
+NC='\033[0m'
+
+printf "${CYAN}"
+cat << "EOF"
+             ______ 
+            / ____/
+    ____   / /_    
+   / __ \ / __/    
+  / /_/ // /       
+ / .___//_/        
+/_/                
+  
+  @crossdelta/platform-sdk installer
+EOF
+printf "${NC}\n"
+
+# Function to check if command exists
+command_exists() {
+  command -v "$1" &> /dev/null
+}
+
+# Detect or install package manager
+detect_or_install_package_manager() {
+  # Check for existing package managers
+  if command_exists bun; then
+    echo "bun"
+    return 0
+  elif command_exists pnpm; then
+    echo "pnpm"
+    return 0
+  elif command_exists yarn; then
+    echo "yarn"
+    return 0
+  elif command_exists npm; then
+    echo "npm"
+    return 0
+  fi
+  
+  # No package manager found - ask user for permission
+  printf "${YELLOW}No package manager found (bun, pnpm, yarn, npm).${NC}\n"
+  printf "${YELLOW}To use @crossdelta/platform-sdk, we recommend installing Bun (fast JavaScript runtime).${NC}\n"
+  printf "\n"
+  read -p "Do you want to install Bun now? (y/n) " -n 1 -r
+  printf "\n"
+  
+  if [[ ! $REPLY =~ ^[Yy]$ ]]; then
+    printf "${RED}Installation cancelled. Please install Bun or another package manager manually.${NC}\n"
+    printf "${BLUE}Visit: https://bun.sh${NC}\n"
+    exit 1
+  fi
+  
+  # Install Bun
+  printf "${BLUE}Installing Bun...${NC}\n"
+  curl -fsSL https://bun.sh/install | bash
+  
+  # Load Bun into current shell
+  export BUN_INSTALL="$HOME/.bun"
+  export PATH="$BUN_INSTALL/bin:$PATH"
+  
+  printf "${GREEN}✓${NC} Bun installed successfully\n"
+  echo "bun"
+}
+
+PM=$(detect_or_install_package_manager)
+
+printf "${GREEN}✓${NC} Using package manager: ${BLUE}$PM${NC}\n"
+printf "\n"
+
+# Check if arguments were provided
+if [ $# -eq 0 ]; then
+  # No arguments: Install pf globally
+  printf "${BLUE}Installing @crossdelta/platform-sdk CLI globally...${NC}\n"
+  printf "\n"
+
+  case $PM in
+    bun)
+      bun add -g @crossdelta/platform-sdk
+      ;;
+    pnpm)
+      pnpm add -g @crossdelta/platform-sdk
+      ;;
+    yarn)
+      yarn global add @crossdelta/platform-sdk
+      ;;
+    npm)
+      npm install -g @crossdelta/platform-sdk
+      ;;
+  esac
+
+  EXIT_CODE=$?
+
+  if [ $EXIT_CODE -eq 0 ]; then
+    printf "\n"
+    printf "${GREEN}✨ Installation successful!${NC}\n"
+    printf "\n"
+    printf "${CYAN}Next steps:${NC}\n"
+    printf "  ${BLUE}pf new workspace my-platform${NC}    # Create a new workspace\n"
+    printf "  ${BLUE}pf --help${NC}                       # Show all available commands\n"
+    printf "\n"
+  else
+    printf "\n"
+    printf "${RED}✗ Installation failed${NC}\n"
+    exit $EXIT_CODE
+  fi
+else
+  # Arguments provided: Run pf command directly
+  PF_ARGS=()
+  
+  while [[ $# -gt 0 ]]; do
+    case $1 in
+      -h|--help)
+        echo "Usage: bash install.sh [COMMAND] [OPTIONS]"
+        echo ""
+        echo "Without arguments:"
+        echo "  Installs pf CLI globally"
+        echo ""
+        echo "With arguments:"
+        echo "  Runs 'pf [COMMAND] [OPTIONS]' directly (via bunx/npx)"
+        echo ""
+        echo "Examples:"
+        echo "  bash install.sh                              # Install pf globally"
+        echo "  bash install.sh new workspace my-platform    # Run command directly"
+        echo "  bash install.sh --help                       # Show pf help"
+        exit 0
+        ;;
+      *)
+        PF_ARGS+=("$1")
+        shift
+        ;;
+    esac
+  done
+
+  printf "${BLUE}Running: pf ${PF_ARGS[*]}${NC}\n"
+  printf "\n"
+
+  # Execute pf command via package runner
+  case $PM in
+    bun)
+      bunx @crossdelta/platform-sdk "${PF_ARGS[@]}"
+      ;;
+    pnpm)
+      pnpm dlx @crossdelta/platform-sdk "${PF_ARGS[@]}"
+      ;;
+    yarn)
+      yarn dlx @crossdelta/platform-sdk "${PF_ARGS[@]}"
+      ;;
+    npm)
+      npx @crossdelta/platform-sdk "${PF_ARGS[@]}"
+      ;;
+  esac
+fi

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.5.12",
-  "description": "CLI toolkit for scaffolding Turborepo workspaces with Pulumi infrastructure and Hono/NestJS microservices",
+  "version": "0.7.0",
+  "description": "Your AI-powered platform engineer. Scaffold complete Turborepo workspaces, generate microservice boilerplate with natural language, and deploy to the cloud — all from one CLI.",
   "keywords": [
     "cli",
     "scaffolding",
@@ -35,7 +35,8 @@
     "dist/",
     "README.md",
     "logo.png",
-    "schemas"
+    "schemas",
+    "install.sh"
   ],
   "exports": {
     "./schemas/event.schema.json": "./schemas/event.schema.json"
@@ -57,14 +58,15 @@
     "build": "npm run build:cli && npm run build:schematics && npm run build:cli:copy",
     "prepublishOnly": "npm run build",
     "lint": "biome lint --fix",
-    "test": "vitest run",
-    "test:watch": "vitest watch"
+    "test": "bun test",
+    "test:watch": "bun test --watch"
   },
   "schematics": "./dist/schematics/collection.json",
   "esbuild": {
     "external": [
       "@crossdelta/infrastructure",
       "@faker-js/faker",
+      "@anatine/zod-mock",
       "ai",
       "@ai-sdk/openai",
       "@ai-sdk/anthropic",
@@ -76,18 +78,22 @@
       "globby",
       "fs-extra",
       "chalk",
-      "ora"
+      "ora",
+      "jiti",
+      "zod"
     ]
   },
   "dependencies": {
     "@ai-sdk/anthropic": "^2.0.53",
     "@ai-sdk/openai": "^2.0.79",
+    "@anatine/zod-mock": "^3.14.0",
     "@angular-devkit/core": "^21.0.0",
     "@faker-js/faker": "^9.8.0",
     "@inquirer/prompts": "^7.5.0",
     "@listr2/prompt-adapter-enquirer": "^2.0.15",
     "ai": "^5.0.108",
     "chalk": "^5.4.1",
+    "chokidar": "^5.0.0",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
     "dotenv": "^17.2.3",
@@ -96,6 +102,7 @@
     "fs-extra": "^11.3.0",
     "globby": "^14.1.0",
     "handlebars": "^4.7.8",
+    "jiti": "^2.6.1",
     "listr2": "^8.3.2",
     "ora": "^8.2.0",
     "os": "^0.1.2",
@@ -107,10 +114,25 @@
     "zx": "^8.5.3"
   },
   "peerDependencies": {
+    "@crossdelta/cloudevents": "*",
     "@crossdelta/infrastructure": "*",
     "@nestjs/schematics": "^11.0.5",
     "turbo": "^2.0.0"
   },
+  "peerDependenciesMeta": {
+    "@crossdelta/cloudevents": {
+      "optional": true
+    },
+    "@crossdelta/infrastructure": {
+      "optional": true
+    },
+    "@nestjs/schematics": {
+      "optional": true
+    },
+    "turbo": {
+      "optional": true
+    }
+  },
   "devDependencies": {
     "@angular-devkit/core": "^21.0.0",
     "@angular-devkit/schematics": "^21.0.0",
@@ -118,14 +140,12 @@
     "@eslint/js": "^9.22.0",
     "@nestjs/schematics": "^11.0.9",
     "@types/fs-extra": "^11.0.4",
-    "@vitest/coverage-v8": "^3.1.2",
-    "@vitest/ui": "^3.1.2",
     "biome": "^0.3.3",
+    "bun-types": "^1.3.4",
     "comment-json": "^4.4.1",
     "esbuild": "^0.25.3",
     "eslint": "^9.25.1",
     "typescript": "^5.8.3",
-    "typescript-eslint": "^8.31.1",
-    "vitest": "^3.1.2"
+    "typescript-eslint": "^8.31.1"
   }
 }