@warlock.js/herald 4.0.100

package/cjs/communicators/communicator-registry.js

@@ -0,0 +1,206 @@
+'use strict';var node_events=require('node:events'),communicator=require('./communicator.js');/**
+ * Error thrown when a communicator is not found
+ */
+class MissingCommunicatorError extends Error {
+    communicatorName;
+    constructor(message, communicatorName) {
+        super(message);
+        this.name = "MissingCommunicatorError";
+        this.communicatorName = communicatorName;
+    }
+}
+/**
+ * Communicator Registry
+ *
+ * Maintains registry of named communicators.
+ * Similar to DataSourceRegistry in @warlock.js/cascade
+ *
+ * @example
+ * ```typescript
+ * // Register a communicator
+ * communicatorRegistry.register({
+ *   name: "default",
+ *   driver: rabbitMQDriver,
+ *   isDefault: true,
+ * });
+ *
+ * // Get the default communicator
+ * const comm = communicatorRegistry.get();
+ *
+ * // Get a specific communicator by name
+ * const analytics = communicatorRegistry.get("analytics");
+ *
+ * // Listen for events
+ * communicatorRegistry.on("connected", (comm) => {
+ *   console.log(`${comm.name} connected`);
+ * });
+ * ```
+ */
+class CommunicatorRegistry {
+    sources = new Map();
+    defaultSource;
+    events = new node_events.EventEmitter();
+    /**
+     * Register a new communicator
+     *
+     * Sets up event forwarding from the driver to the registry.
+     *
+     * @param options - Communicator configuration
+     * @returns The registered communicator instance
+     *
+     * @example
+     * ```typescript
+     * const communicator = communicatorRegistry.register({
+     *   name: "primary",
+     *   driver: myDriver,
+     *   isDefault: true,
+     * });
+     * ```
+     */
+    register(options) {
+        const communicator$1 = new communicator.Communicator(options);
+        this.sources.set(communicator$1.name, communicator$1);
+        const isNewDefault = communicator$1.isDefault || !this.defaultSource;
+        if (isNewDefault) {
+            this.defaultSource = communicator$1;
+        }
+        // Emit registration events
+        this.events.emit("registered", communicator$1);
+        if (isNewDefault) {
+            this.events.emit("default-registered", communicator$1);
+        }
+        // Forward driver events to registry
+        communicator$1.driver.on("connected", () => {
+            this.events.emit("connected", communicator$1);
+        });
+        communicator$1.driver.on("disconnected", () => {
+            this.events.emit("disconnected", communicator$1);
+        });
+        return communicator$1;
+    }
+    /**
+     * Clear all registered communicators
+     */
+    clear() {
+        this.defaultSource = undefined;
+        this.sources.clear();
+    }
+    /**
+     * Listen for registry events
+     *
+     * @param event - Event to listen for
+     * @param listener - Callback function
+     *
+     * @example
+     * ```typescript
+     * communicatorRegistry.on("registered", (comm) => {
+     *   console.log(`Communicator "${comm.name}" registered`);
+     * });
+     *
+     * communicatorRegistry.on("connected", (comm) => {
+     *   console.log(`Communicator "${comm.name}" connected`);
+     * });
+     * ```
+     */
+    on(event, listener) {
+        this.events.on(event, listener);
+    }
+    /**
+     * Listen for a registry event once
+     *
+     * @param event - Event to listen for
+     * @param listener - Callback function
+     */
+    once(event, listener) {
+        this.events.once(event, listener);
+    }
+    /**
+     * Remove an event listener
+     *
+     * @param event - Event to stop listening for
+     * @param listener - Callback to remove
+     */
+    off(event, listener) {
+        this.events.off(event, listener);
+    }
+    /**
+     * Get a communicator by name or the default one
+     *
+     * @param name - Optional communicator name
+     * @returns Communicator instance
+     * @throws MissingCommunicatorError if not found
+     *
+     * @example
+     * ```typescript
+     * // Get default communicator
+     * const comm = communicatorRegistry.get();
+     *
+     * // Get specific communicator
+     * const analytics = communicatorRegistry.get("analytics");
+     * ```
+     */
+    get(name) {
+        if (name !== undefined) {
+            const source = this.sources.get(name);
+            if (!source) {
+                throw new MissingCommunicatorError(`Communicator "${name}" is not registered.`, name);
+            }
+            return source;
+        }
+        if (!this.defaultSource) {
+            throw new MissingCommunicatorError("No default communicator registered.");
+        }
+        return this.defaultSource;
+    }
+    /**
+     * Check if a communicator exists
+     *
+     * @param name - Communicator name to check
+     * @returns True if exists
+     */
+    has(name) {
+        return this.sources.has(name);
+    }
+    /**
+     * Check if any communicators are registered
+     */
+    hasAny() {
+        return this.sources.size > 0;
+    }
+    /**
+     * Get all registered communicators
+     *
+     * @returns Array of all communicators
+     *
+     * @example
+     * ```typescript
+     * // Disconnect all communicators
+     * for (const comm of communicatorRegistry.getAll()) {
+     *   await comm.disconnect();
+     * }
+     * ```
+     */
+    getAll() {
+        return Array.from(this.sources.values());
+    }
+    /**
+     * Get all communicator names
+     *
+     * @returns Array of communicator names
+     */
+    getNames() {
+        return Array.from(this.sources.keys());
+    }
+    /**
+     * Get the default communicator (if any)
+     *
+     * @returns Default communicator or undefined
+     */
+    getDefault() {
+        return this.defaultSource;
+    }
+}
+/**
+ * Global communicator registry instance
+ */
+const communicatorRegistry = new CommunicatorRegistry();exports.MissingCommunicatorError=MissingCommunicatorError;exports.communicatorRegistry=communicatorRegistry;//# sourceMappingURL=communicator-registry.js.map

package/cjs/communicators/communicator-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communicator-registry.js","sources":["../../src/communicators/communicator-registry.ts"],"sourcesContent":[null],"names":["EventEmitter","communicator","Communicator"],"mappings":"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"}

package/cjs/communicators/communicator.d.ts

@@ -0,0 +1,90 @@
+import type { CommunicatorDriverContract } from "../contracts";
+import type { ChannelOptions } from "../types";
+import type { ChannelContract } from "../contracts/channel.contract";
+/**
+ * Options for creating a Communicator
+ */
+export interface CommunicatorOptions {
+    /** Unique name for this communicator */
+    name: string;
+    /** The underlying driver */
+    driver: CommunicatorDriverContract;
+    /** Whether this is the default communicator */
+    isDefault?: boolean;
+}
+/**
+ * Communicator - wrapper around a driver with metadata
+ *
+ * Similar to DataSource in @warlock.js/cascade
+ *
+ * @example
+ * ```typescript
+ * const communicator = new Communicator({
+ *   name: "default",
+ *   driver: rabbitMQDriver,
+ *   isDefault: true,
+ * });
+ *
+ * // Get a channel
+ * const channel = communicator.channel("user.created");
+ * ```
+ */
+export declare class Communicator {
+    /** Unique name identifying this communicator */
+    readonly name: string;
+    /** The underlying driver */
+    readonly driver: CommunicatorDriverContract;
+    /** Whether this is the default communicator */
+    readonly isDefault: boolean;
+    /**
+     * Create a new Communicator
+     *
+     * @param options - Communicator configuration
+     */
+    constructor(options: CommunicatorOptions);
+    /**
+     * Get or create a channel
+     *
+     * @param name - Channel name
+     * @param options - Channel options
+     * @returns Channel instance
+     *
+     * @example
+     * ```typescript
+     * // Simple channel
+     * const channel = communicator.channel("notifications");
+     *
+     * // Typed channel with schema
+     * const orderChannel = communicator.channel<OrderPayload>("orders", {
+     *   schema: OrderSchema,
+     *   durable: true,
+     * });
+     * ```
+     */
+    channel<TPayload = unknown>(name: string, options?: ChannelOptions<TPayload>): ChannelContract<TPayload>;
+    /**
+     * Check if the communicator is connected
+     */
+    get isConnected(): boolean;
+    /**
+     * Connect the underlying driver
+     */
+    connect(): Promise<void>;
+    /**
+     * Disconnect the underlying driver
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Start consuming messages
+     */
+    startConsuming(): Promise<void>;
+    /**
+     * Stop consuming messages
+     */
+    stopConsuming(): Promise<void>;
+    /**
+     * Health check
+     */
+    healthCheck(): Promise<import("../types").HealthCheckResult>;
+}
+//# sourceMappingURL=communicator.d.ts.map

package/cjs/communicators/communicator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"communicator.d.ts","sourceRoot":"","sources":["../../src/communicators/communicator.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC/C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAC;IACb,4BAA4B;IAC5B,MAAM,EAAE,0BAA0B,CAAC;IACnC,+CAA+C;IAC/C,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,YAAY;IACvB,gDAAgD;IAChD,SAAgB,IAAI,EAAE,MAAM,CAAC;IAE7B,4BAA4B;IAC5B,SAAgB,MAAM,EAAE,0BAA0B,CAAC;IAEnD,+CAA+C;IAC/C,SAAgB,SAAS,EAAE,OAAO,CAAC;IAEnC;;;;OAIG;gBACgB,OAAO,EAAE,mBAAmB;IAM/C;;;;;;;;;;;;;;;;;;OAkBG;IACI,OAAO,CAAC,QAAQ,GAAG,OAAO,EAC/B,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE,cAAc,CAAC,QAAQ,CAAC,GACjC,eAAe,CAAC,QAAQ,CAAC;IAI5B;;OAEG;IACH,IAAW,WAAW,IAAI,OAAO,CAEhC;IAED;;OAEG;IACU,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrC;;OAEG;IACU,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC;;OAEG;IACU,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5C;;OAEG;IACU,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC;IAI3C;;OAEG;IACU,WAAW;CAGzB"}

package/cjs/communicators/communicator.js

@@ -0,0 +1,93 @@
+'use strict';/**
+ * Communicator - wrapper around a driver with metadata
+ *
+ * Similar to DataSource in @warlock.js/cascade
+ *
+ * @example
+ * ```typescript
+ * const communicator = new Communicator({
+ *   name: "default",
+ *   driver: rabbitMQDriver,
+ *   isDefault: true,
+ * });
+ *
+ * // Get a channel
+ * const channel = communicator.channel("user.created");
+ * ```
+ */
+class Communicator {
+    /** Unique name identifying this communicator */
+    name;
+    /** The underlying driver */
+    driver;
+    /** Whether this is the default communicator */
+    isDefault;
+    /**
+     * Create a new Communicator
+     *
+     * @param options - Communicator configuration
+     */
+    constructor(options) {
+        this.name = options.name;
+        this.driver = options.driver;
+        this.isDefault = Boolean(options.isDefault);
+    }
+    /**
+     * Get or create a channel
+     *
+     * @param name - Channel name
+     * @param options - Channel options
+     * @returns Channel instance
+     *
+     * @example
+     * ```typescript
+     * // Simple channel
+     * const channel = communicator.channel("notifications");
+     *
+     * // Typed channel with schema
+     * const orderChannel = communicator.channel<OrderPayload>("orders", {
+     *   schema: OrderSchema,
+     *   durable: true,
+     * });
+     * ```
+     */
+    channel(name, options) {
+        return this.driver.channel(name, options);
+    }
+    /**
+     * Check if the communicator is connected
+     */
+    get isConnected() {
+        return this.driver.isConnected;
+    }
+    /**
+     * Connect the underlying driver
+     */
+    async connect() {
+        await this.driver.connect();
+    }
+    /**
+     * Disconnect the underlying driver
+     */
+    async disconnect() {
+        await this.driver.disconnect();
+    }
+    /**
+     * Start consuming messages
+     */
+    async startConsuming() {
+        await this.driver.startConsuming();
+    }
+    /**
+     * Stop consuming messages
+     */
+    async stopConsuming() {
+        await this.driver.stopConsuming();
+    }
+    /**
+     * Health check
+     */
+    async healthCheck() {
+        return this.driver.healthCheck();
+    }
+}exports.Communicator=Communicator;//# sourceMappingURL=communicator.js.map

package/cjs/communicators/communicator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"communicator.js","sources":["../../src/communicators/communicator.ts"],"sourcesContent":[null],"names":[],"mappings":"aAgBA;;;;;;;;;;;;;;;;AAgBG;MACU,YAAY,CAAA;;AAEP,IAAA,IAAI,CAAS;;AAGb,IAAA,MAAM,CAA6B;;AAGnC,IAAA,SAAS,CAAU;AAEnC;;;;AAIG;AACH,IAAA,WAAA,CAAmB,OAA4B,EAAA;AAC7C,QAAA,IAAI,CAAC,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;AACzB,QAAA,IAAI,CAAC,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;QAC7B,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;KAC7C;AAED;;;;;;;;;;;;;;;;;;AAkBG;IACI,OAAO,CACZ,IAAY,EACZ,OAAkC,EAAA;QAElC,OAAO,IAAI,CAAC,MAAM,CAAC,OAAO,CAAW,IAAI,EAAE,OAAO,CAAC,CAAC;KACrD;AAED;;AAEG;AACH,IAAA,IAAW,WAAW,GAAA;AACpB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC;KAChC;AAED;;AAEG;AACI,IAAA,MAAM,OAAO,GAAA;AAClB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;KAC7B;AAED;;AAEG;AACI,IAAA,MAAM,UAAU,GAAA;AACrB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;KAChC;AAED;;AAEG;AACI,IAAA,MAAM,cAAc,GAAA;AACzB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,cAAc,EAAE,CAAC;KACpC;AAED;;AAEG;AACI,IAAA,MAAM,aAAa,GAAA;AACxB,QAAA,MAAM,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,CAAC;KACnC;AAED;;AAEG;AACI,IAAA,MAAM,WAAW,GAAA;AACtB,QAAA,OAAO,IAAI,CAAC,MAAM,CAAC,WAAW,EAAE,CAAC;KAClC;AACF"}

package/cjs/communicators/index.d.ts

@@ -0,0 +1,3 @@
+export * from "./communicator";
+export * from "./communicator-registry";
+//# sourceMappingURL=index.d.ts.map

package/cjs/communicators/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/communicators/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,cAAc,yBAAyB,CAAC"}

package/cjs/contracts/channel.contract.d.ts

@@ -0,0 +1,175 @@
+import type { ChannelOptions, ChannelStats, MessageHandler, PublishOptions, RequestOptions, ResponseHandler, Subscription, SubscribeOptions } from "../types";
+/**
+ * Channel contract - represents a queue (RabbitMQ) or topic (Kafka)
+ *
+ * Provides a unified pub/sub interface across different message brokers.
+ *
+ * @template TPayload - The typed payload for messages on this channel
+ *
+ * @example
+ * ```typescript
+ * // Get a typed channel
+ * const userChannel = communicators().channel<UserPayload>("user.created");
+ *
+ * // Publish
+ * await userChannel.publish({ userId: 1, email: "test@example.com" });
+ *
+ * // Subscribe
+ * userChannel.subscribe(async (message, ctx) => {
+ *   console.log(message.payload.userId);
+ *   await ctx.ack();
+ * });
+ * ```
+ */
+export interface ChannelContract<TPayload = unknown> {
+    /**
+     * Channel name/routing key
+     */
+    readonly name: string;
+    /**
+     * Channel options
+     */
+    readonly options: ChannelOptions<TPayload>;
+    /**
+     * Publish a message to this channel
+     *
+     * @param payload - The message payload
+     * @param options - Optional publish options
+     *
+     * @example
+     * ```typescript
+     * await channel.publish({ orderId: 123 });
+     *
+     * // With options
+     * await channel.publish({ orderId: 123 }, {
+     *   priority: 5,
+     *   persistent: true,
+     *   correlationId: "req-123",
+     * });
+     * ```
+     */
+    publish(payload: TPayload, options?: PublishOptions): Promise<void>;
+    /**
+     * Publish multiple messages in a batch
+     *
+     * More efficient than publishing one by one.
+     *
+     * @param messages - Array of payloads to publish
+     * @param options - Optional publish options (applied to all messages)
+     *
+     * @example
+     * ```typescript
+     * await channel.publishBatch([
+     *   { event: "page_view", page: "/home" },
+     *   { event: "page_view", page: "/products" },
+     * ]);
+     * ```
+     */
+    publishBatch(messages: TPayload[], options?: PublishOptions): Promise<void>;
+    /**
+     * Subscribe to messages on this channel
+     *
+     * @param handler - Function to handle incoming messages
+     * @param options - Optional subscribe options
+     * @returns Subscription object for managing the subscription
+     *
+     * @example
+     * ```typescript
+     * const subscription = await channel.subscribe(
+     *   async (message, ctx) => {
+     *     await processOrder(message.payload);
+     *     await ctx.ack();
+     *   },
+     *   {
+     *     prefetch: 10,
+     *     retry: { maxRetries: 3, delay: 1000 },
+     *   }
+     * );
+     *
+     * // Later: unsubscribe
+     * await subscription.unsubscribe();
+     * ```
+     */
+    subscribe(handler: MessageHandler<TPayload>, options?: SubscribeOptions): Promise<Subscription>;
+    /**
+     * Request-Response pattern (RPC)
+     *
+     * Publishes a message and waits for a response.
+     *
+     * @param payload - The request payload
+     * @param options - Request options including timeout
+     * @returns Promise resolving to the response
+     *
+     * @example
+     * ```typescript
+     * const result = await channel.request<ProcessResult>(
+     *   { imageUrl: "https://..." },
+     *   { timeout: 30000 }
+     * );
+     * console.log(result.processedUrl);
+     * ```
+     */
+    request<TResponse = unknown>(payload: TPayload, options?: RequestOptions): Promise<TResponse>;
+    /**
+     * Register a response handler for RPC pattern
+     *
+     * The return value of the handler becomes the response.
+     *
+     * @param handler - Function to handle requests and return responses
+     * @returns Subscription for managing the responder
+     *
+     * @example
+     * ```typescript
+     * channel.respond(async (message, ctx) => {
+     *   const result = await processImage(message.payload);
+     *   return { processedUrl: result.url };
+     * });
+     * ```
+     */
+    respond<TResponse = unknown>(handler: ResponseHandler<TPayload, TResponse>): Promise<Subscription>;
+    /**
+     * Get channel statistics
+     *
+     * @returns Channel stats including message count and consumer count
+     *
+     * @example
+     * ```typescript
+     * const stats = await channel.stats();
+     * console.log(`Messages: ${stats.messageCount}, Consumers: ${stats.consumerCount}`);
+     * ```
+     */
+    stats(): Promise<ChannelStats>;
+    /**
+     * Purge all messages from the channel
+     *
+     * Use with caution - this deletes all pending messages.
+     *
+     * @returns Number of messages purged
+     *
+     * @example
+     * ```typescript
+     * const purgedCount = await channel.purge();
+     * console.log(`Purged ${purgedCount} messages`);
+     * ```
+     */
+    purge(): Promise<number>;
+    /**
+     * Check if the channel exists
+     *
+     * @returns True if the channel exists on the broker
+     */
+    exists(): Promise<boolean>;
+    /**
+     * Delete the channel
+     *
+     * Use with caution - this removes the queue/topic entirely.
+     */
+    delete(): Promise<void>;
+    /**
+     * Assert/create the channel with its options
+     *
+     * Creates the channel if it doesn't exist, or verifies options match.
+     */
+    assert(): Promise<void>;
+}
+//# sourceMappingURL=channel.contract.d.ts.map

package/cjs/contracts/channel.contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"channel.contract.d.ts","sourceRoot":"","sources":["../../src/contracts/channel.contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,YAAY,EAEZ,cAAc,EACd,cAAc,EACd,cAAc,EACd,eAAe,EACf,YAAY,EACZ,gBAAgB,EACjB,MAAM,UAAU,CAAC;AAElB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,eAAe,CAAC,QAAQ,GAAG,OAAO;IACjD;;OAEG;IACH,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,CAAC;IAE3C;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAEpE;;;;;;;;;;;;;;;OAeG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5E;;;;;;;;;;;;;;;;;;;;;;;OAuBG;IACH,SAAS,CAAC,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEhG;;;;;;;;;;;;;;;;;OAiBG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC;IAE9F;;;;;;;;;;;;;;;OAeG;IACH,OAAO,CAAC,SAAS,GAAG,OAAO,EAAE,OAAO,EAAE,eAAe,CAAC,QAAQ,EAAE,SAAS,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC;IAEnG;;;;;;;;;;OAUG;IACH,KAAK,IAAI,OAAO,CAAC,YAAY,CAAC,CAAC;IAE/B;;;;;;;;;;;;OAYG;IACH,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAEzB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;IAE3B;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAExB;;;;OAIG;IACH,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACzB"}