@crossdelta/platform-sdk 0.4.47 → 0.5.0

package/bin/services/ai/instructions/ai-instructions.md

@@ -31,6 +31,7 @@ Rules:
 - One package per line.
 - No versions.
 - Only packages not included in the scaffold.
+- **CRITICAL:** Only use packages that actually exist on npm. Verify package names are correct (e.g., `@pusher/push-notifications-server` not `pusher-beams`). When unsure, use well-known, established packages.
 
 ---
 
@@ -97,11 +98,28 @@ Contains only:
 
 ---
 
-# 6. Use-Case Rules
-- All domain logic lives in `use-cases`.
-- Pure functions preferred.
-- No framework imports.
-- Use inferred schema types.
+# 6. Use-Case Rules (Lean Hexagonal Architecture)
+
+Services follow a **Lean Hexagonal Architecture** pattern:
+- **Handlers** = Adapters (receive events, delegate to use-cases)
+- **Use-Cases** = Application Core (business logic, orchestration)
+- No explicit ports/interfaces unless needed
+
+**IMPORTANT:** A single service description may result in **multiple use-cases**. Break down complex functionality into focused, single-responsibility use-cases.
+
+Example: "Payment processing service" might generate:
+- `validate-payment.use-case.ts` - Validate payment details
+- `process-payment.use-case.ts` - Execute payment with provider
+- `notify-payment-status.use-case.ts` - Send payment notifications
+- `refund-payment.use-case.ts` - Handle refund requests
+
+Use-Case Rules:
+- All domain logic lives in `use-cases/`
+- One use-case = one responsibility
+- Pure functions preferred
+- No framework imports
+- Use inferred schema types from handlers
+- Compose use-cases when needed (call one from another)
 
 ---
 
@@ -157,7 +175,7 @@ Forbidden in handlers:
 
 # 8. Testing Rules
 
-**CRITICAL:** 
+**CRITICAL:**
 - Test ONLY use-cases (NOT event handlers)
 - Use Bun's native test runner: `import { describe, expect, it, beforeEach, afterEach } from 'bun:test'`
 - **NO mocking available** - Bun does NOT have `vi`, `mock`, `jest.fn()`, or module mocking
@@ -195,7 +213,7 @@ describe('Send Notification Use Case', () => {
 
   it('should throw error if credentials not set', async () => {
     delete process.env.PUSHER_BEAMS_INSTANCE_ID
-    
+
     await expect(
       sendNotification({ orderId: '123', customerId: 'cust-1' })
     ).rejects.toThrow('Missing Pusher Beams credentials')

package/bin/templates/hono-microservice/src/index.ts.hbs

@@ -10,9 +10,9 @@ app.get('/health', (c) => {
   return c.json({ status: 'ok' })
 })
 
-console.log('Starting {{serviceName}} service on port', port)
-
 Bun.serve({
   port,
   fetch: app.fetch,
 })
+
+console.log(`🚀 Service ready at http://localhost:${port}`)

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

@@ -4,12 +4,12 @@
   "scripts": {
     "dev": "pf dev",
     "generate-env": "turbo run generate-env --ui=stream",
-    "build": "bun --env-file .env.local turbo run build",
-    "preview": "bun --env-file .env.local turbo run preview",
-    "lint": "bun turbo run lint",
-    "format": "bun turbo run format",
+    "build": "dotenv -e .env.local -- turbo run build",
+    "preview": "dotenv -e .env.local -- turbo run preview",
+    "lint": "turbo run lint",
+    "format": "turbo run format",
     "pulumi": "cd infra && pulumi",
-    "test": "bun --env-file .env.local turbo run test"
+    "test": "dotenv -e .env.local -- turbo run test"
   },
   "pf": {
     "registry": "{{projectName}}/platform",
@@ -21,8 +21,10 @@
   "devDependencies": {
     "@biomejs/biome": "2.3.7",
     "@crossdelta/platform-sdk": "latest",
+    "bun": "^1.2.7",
+    "dotenv-cli": "^8.0.0",
     "turbo": "^2.5.6"
   },
-  "packageManager": "bun@1.2.7",
+  "packageManager": "{{packageManagerVersion}}",
   "workspaces": ["packages/*", "apps/*", "services/*", "infra"]
 }

package/bin/templates/workspace/pnpm-workspace.yaml.hbs

@@ -0,0 +1,5 @@
+packages:
+  - 'packages/*'
+  - 'apps/*'
+  - 'services/*'
+  - 'infra'

package/bin/templates/workspace/services/nats/scripts/start-dev.sh.hbs

@@ -11,7 +11,7 @@ if [[ -f "$ENV_FILE" ]]; then
   source "$ENV_FILE"
   set +a
 else
-  echo "[NATS] Warning: $ENV_FILE not found. Run 'bun run generate-env' first."
+  echo "[NATS] Warning: $ENV_FILE not found. Run 'pf dev' or your package manager's 'generate-env' script first."
 fi
 
 # Container name (local dev only)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.4.47",
+  "version": "0.5.0",
   "description": "CLI toolkit for scaffolding Turborepo workspaces with Pulumi infrastructure and Hono/NestJS microservices",
   "keywords": [
     "cli",
@@ -88,6 +88,7 @@
     "chalk": "^5.4.1",
     "cli-table3": "^0.6.5",
     "commander": "^13.1.0",
+    "dotenv": "^17.2.3",
     "enquirer": "^2.4.1",
     "execa": "^9.5.2",
     "fs-extra": "^11.3.0",