@crossdelta/platform-sdk 0.12.0 → 0.13.0

package/README.md

@@ -190,7 +190,7 @@ pf event publish orders.created
 
 | Command | What it does |
 |:--------|:-------------|
-| `pf dev` | 🚀 Start NATS + all services in watch mode |
+| `pf dev` | 🚀 Start development infrastructure (NATS) + all services in watch mode |
 | `pf new hono-micro <path>` | ⚡ Create a Hono service (lightweight, Bun-optimized) |
 | `pf new nest-micro <path>` | 🏢 Create a NestJS service (full-featured, decorators) |
 | `pf event add <type> --service <path>` | 🔗 Add contract + handler + wire stream |
@@ -390,12 +390,13 @@ See [@crossdelta/infrastructure](https://www.npmjs.com/package/@crossdelta/infra
 **Contracts** live in `packages/contracts/` as the single source of truth:
 
 ```typescript
-// packages/contracts/src/events/orders-created.ts
+// packages/contracts/src/events/orders/created.ts
 import { createContract } from '@crossdelta/cloudevents'
 import { z } from 'zod'
 
 export const OrdersCreatedContract = createContract({
   type: 'orders.created',
+  channel: { stream: 'ORDERS' },
   schema: z.object({ orderId: z.string(), total: z.number() }),
 })
 ```
@@ -424,11 +425,23 @@ See [@crossdelta/cloudevents](https://www.npmjs.com/package/@crossdelta/cloudeve
 
 <br />
 
-Every workspace includes pre-configured NATS with JetStream:
+> **Local NATS started by `pf dev` is development infrastructure.**
+> **Production streams are materialized via Pulumi from contracts.**
 
-- Auto-started with `pf dev`
+Every workspace includes pre-configured NATS with JetStream for development:
+
+**Development:**
+- Auto-started with `pf dev` (docker-based, ephemeral)
 - Ports: `4222` (client), `8222` (monitoring)
 - Health check: `curl http://localhost:8222/healthz`
+- Streams: Auto-created by services (transient)
+
+**Production:**
+- Deployed via Pulumi (`infra/`)
+- Streams materialized from contracts
+- Persistent storage with retention policies
+
+See `infra/dev/README.md` for Dev-Infra vs Platform-Infra separation.
 
 </details>