alepha 0.10.2 → 0.10.4

package/topic.d.ts

@@ -79,10 +79,10 @@ type UnSubscribeFn = () => Promise<void>;
  *     name: "user-activity",
  *     schema: {
  *       payload: t.object({
- *         userId: t.string(),
+ *         userId: t.text(),
  *         action: t.enum(["login", "logout", "purchase"]),
  *         timestamp: t.number(),
- *         metadata: t.optional(t.record(t.string(), t.any()))
+ *         metadata: t.optional(t.record(t.text(), t.any()))
  *       })
  *     },
  *     handler: async (message) => {
@@ -121,10 +121,10 @@ type UnSubscribeFn = () => Promise<void>;
  *     description: "Real-time chat messages for all rooms",
  *     schema: {
  *       payload: t.object({
- *         messageId: t.string(),
- *         roomId: t.string(),
- *         userId: t.string(),
- *         content: t.string(),
+ *         messageId: t.text(),
+ *         roomId: t.text(),
+ *         userId: t.text(),
+ *         content: t.text(),
  *         timestamp: t.number(),
  *         messageType: t.enum(["text", "image", "file"])
  *       })
@@ -169,70 +169,6 @@ type UnSubscribeFn = () => Promise<void>;
  * ```
  *
  * @example
- * **Event filtering and waiting for specific messages:**
- * ```ts
- * class OrderService {
- *   orderEvents = $topic({
- *     name: "order-events",
- *     schema: {
- *       payload: t.object({
- *         orderId: t.string(),
- *         status: t.union([
- *           t.literal("created"),
- *           t.literal("paid"),
- *           t.literal("shipped"),
- *           t.literal("delivered"),
- *           t.literal("cancelled")
- *         ]),
- *         timestamp: t.number(),
- *         data: t.optional(t.record(t.string(), t.any()))
- *       })
- *     }
- *   });
- *
- *   async processOrder(orderId: string) {
- *     // Publish order created event
- *     await this.orderEvents.publish({
- *       orderId,
- *       status: "created",
- *       timestamp: Date.now()
- *     });
- *
- *     // Wait for payment confirmation with timeout
- *     try {
- *       const paymentEvent = await this.orderEvents.wait({
- *         timeout: [5, "minutes"],
- *         filter: (message) =>
- *           message.payload.orderId === orderId &&
- *           message.payload.status === "paid"
- *       });
- *
- *       console.log(`Order ${orderId} was paid at ${paymentEvent.payload.timestamp}`);
- *
- *       // Continue with shipping...
- *       await this.initiateShipping(orderId);
- *
- *     } catch (error) {
- *       if (error instanceof TopicTimeoutError) {
- *         console.log(`Payment timeout for order ${orderId}`);
- *         await this.cancelOrder(orderId);
- *       }
- *     }
- *   }
- *
- *   async setupOrderTracking() {
- *     // Subscribe only to shipping events
- *     await this.orderEvents.subscribe(async (message) => {
- *       if (message.payload.status === "shipped") {
- *         await this.updateTrackingInfo(message.payload.orderId, message.payload.data);
- *         await this.notifyCustomer(message.payload.orderId, "Your order has shipped!");
- *       }
- *     });
- *   }
- * }
- * ```
- *
- * @example
  * **Redis-backed topic for distributed systems:**
  * ```ts
  * class DistributedEventSystem {
@@ -241,11 +177,11 @@ type UnSubscribeFn = () => Promise<void>;
  *     provider: RedisTopicProvider,  // Use Redis for cross-service communication
  *     schema: {
  *       payload: t.object({
- *         eventType: t.string(),
- *         serviceId: t.string(),
- *         data: t.record(t.string(), t.any()),
+ *         eventType: t.text(),
+ *         serviceId: t.text(),
+ *         data: t.record(t.text(), t.any()),
  *         timestamp: t.number(),
- *         correlationId: t.optional(t.string())
+ *         correlationId: t.optional(t.text())
  *       })
  *     },
  *     handler: async (message) => {
@@ -380,15 +316,15 @@ interface TopicDescriptorOptions<T extends TopicMessageSchema> {
    * ```ts
    * {
    *   payload: t.object({
-   *     eventId: t.string(),
+   *     eventId: t.text(),
    *     eventType: t.enum(["created", "updated"]),
-   *     data: t.record(t.string(), t.any()),
+   *     data: t.record(t.text(), t.any()),
    *     timestamp: t.number(),
-   *     userId: t.optional(t.string())
+   *     userId: t.optional(t.text())
    *   }),
    *   headers: t.optional(t.object({
-   *     source: t.string(),
-   *     correlationId: t.string()
+   *     source: t.text(),
+   *     correlationId: t.text()
    *   }))
    * }
    * ```
@@ -524,10 +460,10 @@ type TopicHandler<T extends TopicMessageSchema = TopicMessageSchema> = (message:
  *     name: "user-activity",
  *     schema: {
  *       payload: t.object({
- *         userId: t.string(),
+ *         userId: t.text(),
  *         action: t.enum(["login", "logout", "purchase"]),
  *         timestamp: t.number(),
- *         metadata: t.optional(t.record(t.string(), t.any()))
+ *         metadata: t.optional(t.record(t.text(), t.any()))
  *       })
  *     }
  *   });
@@ -563,77 +499,6 @@ type TopicHandler<T extends TopicMessageSchema = TopicMessageSchema> = (message:
  * ```
  *
  * @example
- * **Multiple specialized subscribers for different concerns:**
- * ```ts
- * class OrderEventHandlers {
- *   orderEvents = $topic({
- *     name: "order-events",
- *     schema: {
- *       payload: t.object({
- *         orderId: t.string(),
- *         customerId: t.string(),
- *         status: t.union([
- *           t.literal("created"),
- *           t.literal("paid"),
- *           t.literal("shipped"),
- *           t.literal("delivered")
- *         ]),
- *         data: t.optional(t.record(t.string(), t.any()))
- *       })
- *     }
- *   });
- *
- *   // Analytics subscriber
- *   analyticsSubscriber = $subscriber({
- *     topic: this.orderEvents,
- *     handler: async (message) => {
- *       await this.analytics.track('order_status_changed', {
- *         orderId: message.payload.orderId,
- *         customerId: message.payload.customerId,
- *         status: message.payload.status,
- *         timestamp: Date.now()
- *       });
- *     }
- *   });
- *
- *   // Email notification subscriber
- *   emailSubscriber = $subscriber({
- *     topic: this.orderEvents,
- *     handler: async (message) => {
- *       const { customerId, orderId, status } = message.payload;
- *
- *       const templates = {
- *         'paid': 'order-confirmation',
- *         'shipped': 'order-shipped',
- *         'delivered': 'order-delivered'
- *       };
- *
- *       const template = templates[status];
- *       if (template) {
- *         await this.emailService.send({
- *           customerId,
- *           template,
- *           data: { orderId, status }
- *         });
- *       }
- *     }
- *   });
- *
- *   // Inventory management subscriber
- *   inventorySubscriber = $subscriber({
- *     topic: this.orderEvents,
- *     handler: async (message) => {
- *       if (message.payload.status === 'paid') {
- *         await this.inventoryService.reserveItems(message.payload.orderId);
- *       } else if (message.payload.status === 'delivered') {
- *         await this.inventoryService.confirmDelivery(message.payload.orderId);
- *       }
- *     }
- *   });
- * }
- * ```
- *
- * @example
  * **Subscriber with advanced error handling and filtering:**
  * ```ts
  * class NotificationSubscriber {
@@ -641,11 +506,11 @@ type TopicHandler<T extends TopicMessageSchema = TopicMessageSchema> = (message:
  *     name: "system-events",
  *     schema: {
  *       payload: t.object({
- *         eventType: t.string(),
+ *         eventType: t.text(),
  *         severity: t.enum(["info", "warning", "error"]),
- *         serviceId: t.string(),
- *         message: t.string(),
- *         data: t.optional(t.record(t.string(), t.any()))
+ *         serviceId: t.text(),
+ *         message: t.text(),
+ *         data: t.optional(t.record(t.text(), t.any()))
  *       })
  *     }
  *   });
@@ -714,12 +579,12 @@ type TopicHandler<T extends TopicMessageSchema = TopicMessageSchema> = (message:
  *     name: "user-metrics",
  *     schema: {
  *       payload: t.object({
- *         userId: t.string(),
- *         sessionId: t.string(),
- *         eventType: t.string(),
+ *         userId: t.text(),
+ *         sessionId: t.text(),
+ *         eventType: t.text(),
  *         timestamp: t.number(),
  *         duration: t.optional(t.number()),
- *         metadata: t.optional(t.record(t.string(), t.any()))
+ *         metadata: t.optional(t.record(t.text(), t.any()))
  *       })
  *     }
  *   });
@@ -794,7 +659,7 @@ interface SubscriberDescriptorOptions<T extends TopicMessageSchema> {
    * userEvents = $topic({
    *   name: "user-activity",
    *   schema: {
-   *     payload: t.object({ userId: t.string(), action: t.string() })
+   *     payload: t.object({ userId: t.text(), action: t.text() })
    *   }
    * });
    *