@crossdelta/platform-sdk 0.18.0 → 0.18.2

package/bin/docs/generators/hono-bun.md

@@ -129,14 +129,8 @@ const envSchema = z.object({
   MY_SERVICE_PORT: z.string().optional(),
 })
 
-const result = envSchema.safeParse(process.env)
-if (!result.success) {
-  console.error('❌ Environment validation failed:')
-  console.error(result.error.format())
-  process.exit(1)
-}
-
-export const env = result.data
+// Use .parse() - throws ZodError if validation fails
+export const env = envSchema.parse(process.env)
 ```
 
 **Add required environment variables:**
@@ -154,21 +148,16 @@ const envSchema = z.object({
   REDIS_URL: z.string().url().optional(),
 })
 
-const result = envSchema.safeParse(process.env)
-if (!result.success) {
-  console.error('❌ Environment validation failed:')
-  console.error(result.error.format())
-  process.exit(1)
-}
-
-export const env = result.data
+// Use .parse() - throws ZodError if validation fails
+export const env = envSchema.parse(process.env)
 ```
 
 **Rules:**
-- ✅ Use `safeParse()` + explicit error handling for better error messages
+- ✅ Use `.parse()` - throws error automatically (better separation of concerns)
 - ✅ Export validated `env` object for type-safe access
 - ✅ Use Zod v4 syntax (no params on `.email()`, `.url()`, etc.)
 - ✅ Port is always optional (has fallback in index.ts)
+- ❌ DO NOT use `safeParse()` + `process.exit()` - breaks testability
 - ❌ DO NOT add PORT to env schema - it's read directly from process.env
 
 ---
@@ -193,15 +182,9 @@ const envSchema = z.object({
 
 export type Env = z.infer<typeof envSchema>
 
-// Validate and crash process if invalid (like @nestjs/config)
-const result = envSchema.safeParse(process.env)
-if (!result.success) {
-  console.error('❌ Environment validation failed:')
-  console.error(result.error.format())
-  process.exit(1)  // ← Force crash with exit code 1
-}
-
-export const env = result.data
+// Use .parse() - throws ZodError if validation fails
+// Let the caller (index.ts) decide how to handle the error
+export const env = envSchema.parse(process.env)
 ```
 
 ### 2️⃣ **CRITICAL: Import in `src/index.ts` early!**
@@ -235,8 +218,9 @@ console.log(`Service running on http://localhost:${port}`)
 **CRITICAL:**
 - ✅ **MUST import `env` in `src/index.ts`** - without import, validation never runs!
 - ✅ Import early (after telemetry, before everything else)
-- ✅ Use `safeParse()` + `process.exit(1)` - Bun doesn't crash on top-level throws
-- ✅ Explicit exit ensures Turbo shows red X (like NestJS)
+- ✅ Use `.parse()` - throws ZodError automatically (better than process.exit!)
+- ✅ Uncaught error causes process to crash with proper stack trace
+- ❌ **DO NOT** use `safeParse()` + `process.exit()` - breaks separation of concerns
 - ❌ **DO NOT** include `SERVICE_NAME_PORT` in env schema - already handled by CLI template
 - ❌ **DO NOT** validate inside handlers or use-cases
 

package/bin/docs/generators/hono-node.md

@@ -134,14 +134,8 @@ const envSchema = z.object({
   MY_SERVICE_PORT: z.string().optional(),
 })
 
-const result = envSchema.safeParse(process.env)
-if (!result.success) {
-  console.error('❌ Environment validation failed:')
-  console.error(result.error.format())
-  process.exit(1)
-}
-
-export const env = result.data
+// Use .parse() - throws ZodError if validation fails
+export const env = envSchema.parse(process.env)
 ```
 
 **Add required environment variables:**
@@ -159,21 +153,16 @@ const envSchema = z.object({
   REDIS_URL: z.string().url().optional(),
 })
 
-const result = envSchema.safeParse(process.env)
-if (!result.success) {
-  console.error('❌ Environment validation failed:')
-  console.error(result.error.format())
-  process.exit(1)
-}
-
-export const env = result.data
+// Use .parse() - throws ZodError if validation fails
+export const env = envSchema.parse(process.env)
 ```
 
 **Rules:**
-- ✅ Use `safeParse()` + explicit error handling for better error messages
+- ✅ Use `.parse()` - throws error automatically (better separation of concerns)
 - ✅ Export validated `env` object for type-safe access
 - ✅ Use Zod v4 syntax (no params on `.email()`, `.url()`, etc.)
 - ✅ Port is always optional (has fallback in index.ts)
+- ❌ DO NOT use `safeParse()` + `process.exit()` - breaks testability
 - ❌ DO NOT add PORT to env schema - it's read directly from process.env
 
 ---
@@ -197,15 +186,9 @@ const envSchema = z.object({
 
 export type Env = z.infer<typeof envSchema>
 
-// Validate and crash process if invalid (like @nestjs/config)
-const result = envSchema.safeParse(process.env)
-if (!result.success) {
-  console.error('❌ Environment validation failed:')
-  console.error(result.error.format())
-  process.exit(1)  // ← Force crash with exit code 1
-}
-
-export const env = result.data
+// Use .parse() - throws ZodError if validation fails
+// Let the caller (index.ts) decide how to handle the error
+export const env = envSchema.parse(process.env)
 ```
 
 ### 2️⃣ **CRITICAL: Import in `src/index.ts` early!**
@@ -215,7 +198,7 @@ export const env = result.data
 import '@crossdelta/telemetry'  // ← MUST be first!
 
 // ⚠️ CRITICAL: Import env IMMEDIATELY after telemetry
-// This executes validation and crashes process if env invalid
+// This executes validation and throws ZodError if invalid
 import { env } from './config/env'  // ← THIS LINE IS REQUIRED!
 
 import { serve } from '@hono/node-server'
@@ -248,8 +231,9 @@ serve({ fetch: app.fetch, port }, (info) => {
 **CRITICAL:**
 - ✅ **MUST import `env` in `src/index.ts`** - without import, validation never runs!
 - ✅ Import early (after telemetry, before everything else)
-- ✅ Use `safeParse()` + `process.exit(1)` - ensures proper crash behavior
-- ✅ Explicit exit ensures Turbo shows red X (like NestJS)
+- ✅ Use `.parse()` - throws ZodError automatically (better than process.exit!)
+- ✅ Uncaught error causes process to crash with proper stack trace
+- ❌ **DO NOT** use `safeParse()` + `process.exit()` - breaks separation of concerns
 - ❌ **DO NOT** include `SERVICE_NAME_PORT` in env schema - already handled by CLI template
 - ❌ **DO NOT** validate inside handlers or use-cases
 

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

@@ -2,7 +2,7 @@
   "name": "infra",
   "private": true,
   "scripts": {
-    "generate-env": "bunx generate-env",
+    "generate-env": "generate-env",
     "lint": "biome lint --fix",
     "pulumi": "pulumi"
   },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@crossdelta/platform-sdk",
-  "version": "0.18.0",
+  "version": "0.18.2",
   "description": "Platform toolkit for event-driven microservices — keeping code and infrastructure in lockstep.",
   "keywords": [
     "cli",