@crossdelta/platform-sdk 0.13.0 → 0.13.2

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>
 
@@ -404,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) => {
@@ -434,12 +434,14 @@ Every workspace includes pre-configured NATS with JetStream for 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)
+- Streams: Auto-created by `pf dev` from contracts (memory, 1h retention)
 
 **Production:**
 - Deployed via Pulumi (`infra/`)
-- Streams materialized from contracts
-- Persistent storage with retention policies
+- 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.
 

package/package.json

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