@crossdelta/cloudevents 0.5.7 → 0.6.1

package/README.md

@@ -33,7 +33,7 @@ bun add @crossdelta/cloudevents zod@4
 > - **Development**: Use [NATS CLI](https://docs.nats.io/running-a-nats-service/nats_admin/jetstream_admin/streams) or [Platform SDK](https://www.npmjs.com/package/@crossdelta/platform-sdk) (`pf dev` auto-creates from contracts)
 > - **Production**: Use infrastructure-as-code (Pulumi, Terraform) or the [Stream Setup](#stream-setup) function below
 
-**1. Create an event handler** (`src/events/orders-created.handler.ts`):
+**1. Create an event handler** (`src/events/order-created.handler.ts`):
 
 ```typescript
 import { handleEvent } from '@crossdelta/cloudevents'
@@ -209,6 +209,26 @@ NATS_USER=myuser        # optional
 NATS_PASSWORD=mypass    # optional
 ```
 
+### Optional: Google Cloud Pub/Sub
+
+To use Google Cloud Pub/Sub instead of NATS, install the optional dependency:
+
+```bash
+bun add @google-cloud/pubsub
+# or
+npm install @google-cloud/pubsub
+```
+
+Then use the `publishToPubSub` function:
+
+```typescript
+import { publishToPubSub } from '@crossdelta/cloudevents'
+
+await publishToPubSub('order.created', { orderId: 'ord_123', total: 99.99 })
+```
+
+**Note:** `@google-cloud/pubsub` is not bundled with this library to keep the package size small. Install it only if you need Google Cloud Pub/Sub support.
+
 ### Stream Options
 
 ```typescript
@@ -402,7 +422,7 @@ export const LegacyContract = createContract({
 When multiple services consume the same event, use `createContract` to create shared event contracts:
 
 ```typescript
-// packages/contracts/src/events/orders-created.ts
+// packages/contracts/src/events/orders/created.ts
 import { createContract } from '@crossdelta/cloudevents'
 import { z } from 'zod'