@crossdelta/platform-sdk 0.17.5 → 0.18.1

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/.github/workflows/publish-packages.yml

@@ -62,6 +62,7 @@ jobs:
             [ ! -f "$dir/package.json" ] && continue
             
             slug=$(basename "$dir")
+            dir="${dir%/}"  # Remove trailing slash
             name=$(jq -r '.name // empty' "$dir/package.json")
             is_private=$(jq -r '.private // false' "$dir/package.json")
             
@@ -115,12 +116,11 @@ jobs:
           path: |
             packages/*/dist
             packages/*/bin
-            packages/*/README.md
-            packages/*/CHANGELOG.md
+            packages/*/*.md
             packages/*/LICENSE
-            packages/*/logo.png
+            packages/*/*.png
             packages/*/schemas
-            packages/*/install.sh
+            packages/*/*.sh
           retention-days: 1
 
   # Publish packages sequentially (max-parallel: 1)
@@ -145,12 +145,16 @@ jobs:
         uses: actions/download-artifact@v4
         with:
           name: dist-packages
-          path: packages/
+          path: packages
 
       - name: Verify build artifacts
         run: |
-          if [ ! -d "${{ matrix.package.dir }}/dist" ]; then
+          echo "📂 Checking ${{ matrix.package.dir }}"
+          ls -la "${{ matrix.package.dir }}" || true
+          if [ ! -d "${{ matrix.package.dir }}/dist" ] && [ ! -d "${{ matrix.package.dir }}/bin" ]; then
             echo "❌ Build artifacts missing for ${{ matrix.package.name }}"
+            echo "📂 packages/ contents:"
+            ls -la packages/
             exit 1
           fi
           echo "✅ Build artifacts found for ${{ matrix.package.name }}"

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.17.5",
+  "version": "0.18.1",
   "description": "Platform toolkit for event-driven microservices — keeping code and infrastructure in lockstep.",
   "keywords": [
     "cli",
@@ -33,6 +33,8 @@
     "!bin/**/*.map",
     "dist/",
     "README.md",
+    "CHANGELOG.md",
+    "LICENSE",
     "logo.png",
     "schemas",
     "install.sh"