@crossdelta/platform-sdk 0.12.0 → 0.13.1

package/README.md

@@ -13,7 +13,7 @@
 </p>
 
 <p align="center">
-  <sub>Fontend SDK coming soon — contract-based client models.</sub>
+  <sub>Frontend SDK coming soon — contract-based client models.</sub>
 
 </p>
 
@@ -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() }),
 })
 ```
@@ -403,9 +404,9 @@ export const OrdersCreatedContract = createContract({
 **Handlers** import contracts and delegate to use cases:
 
 ```typescript
-// services/notifications/src/events/orders-created.event.ts
+// services/notifications/src/events/orders-created.handler.ts
 import { handleEvent } from '@crossdelta/cloudevents'
-import { OrdersCreatedContract } from '@my-org/contracts'
+import { OrdersCreatedContract } from '@my-platform/contracts'
 import { sendOrderNotification } from '../use-cases/send-notification.use-case'
 
 export default handleEvent(OrdersCreatedContract, async (data) => {
@@ -424,11 +425,25 @@ 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 `pf dev` from contracts (memory, 1h retention)
+
+**Production:**
+- Deployed via Pulumi (`infra/`)
+- Streams materialized from contracts with retention policies
+- Persistent storage (file-based) with explicit limits
+
+> **Services never create streams** — in dev: `pf dev` auto-creates from contracts, in prod: Pulumi materializes.
+
+See `infra/dev/README.md` for Dev-Infra vs Platform-Infra separation.
 
 </details>