cloudevents/dist/message/index.d.ts

CloudEvents SDK for JavaScript

/// <reference types="node" />
/// <reference types="node" />
import { IncomingHttpHeaders } from "http";
import { CloudEventV1 } from "..";
export * from "./http";
export * from "./kafka";
export * from "./mqtt";
/**
 * Binding is an interface for transport protocols to implement,
 * which provides functions for sending CloudEvent Messages over
 * the wire.
 * @interface
 *
 * @property {@link Serializer} `binary`     - converts a CloudEvent into a Message in binary mode
 * @property {@link Serializer} `structured` - converts a CloudEvent into a Message in structured mode
 * @property {@link Deserializer} `toEvent`  - converts a Message into a CloudEvent
 * @property {@link Detector} `isEvent`      - determines if a Message can be converted to a CloudEvent
 */
export interface Binding<B extends Message = Message, S extends Message = Message> {
    binary: Serializer<B>;
    structured: Serializer<S>;
    toEvent: Deserializer;
    isEvent: Detector;
}
/**
 * Headers is an interface representing transport-agnostic headers as
 * key/value string pairs
 * @interface
 */
export interface Headers extends IncomingHttpHeaders {
    [key: string]: string | string[] | undefined;
}
/**
 * Message is an interface representing a CloudEvent as a
 * transport-agnostic message
 * @interface
 * @property {@linkcode Headers} `headers` - the headers for the event Message
 * @property {T | string | Buffer | unknown} `body` - the body of the event Message
 */
export interface Message<T = string> {
    headers: Headers;
    body: T | string | Buffer | unknown;
}
/**
 * An enum representing the two transport modes, binary and structured
 * @interface
 */
export declare enum Mode {
    BINARY = "binary",
    STRUCTURED = "structured",
    BATCH = "batch"
}
/**
 * Serializer is an interface for functions that can convert a
 * CloudEvent into a Message.
 * @interface
 */
export interface Serializer<M extends Message> {
    <T>(event: CloudEventV1<T>): M;
}
/**
 * Deserializer is a function interface that converts a
 * Message to a CloudEvent
 * @interface
 */
export interface Deserializer {
    <T>(message: Message): CloudEventV1<T> | CloudEventV1<T>[];
}
/**
 * Detector is a function interface that detects whether
 * a message contains a valid CloudEvent
 * @interface
 */
export interface Detector {
    (message: Message): boolean;
}