@celerity-sdk/types 0.3.0 → 0.4.0

package/README.md

@@ -20,6 +20,9 @@ pnpm add @celerity-sdk/types
 | **Modules** | `ModuleMetadata`, `FunctionHandlerDefinition` |
 | **Validation** | `Schema` |
 | **Telemetry** | `LogLevel`, `CelerityLogger`, `CelerityTracer`, `CeleritySpan` |
+| **WebSocket** | `WebSocketRequest`, `WebSocketResponse`, `WebSocketHandlerContext` |
+| **Consumer** | `ConsumerMessage`, `ConsumerHandlerContext`, `ConsumerResult` |
+| **Schedule** | `ScheduleEvent`, `ScheduleHandlerContext` |
 
 ## Conventions
 

package/dist/index.cjs

@@ -3,6 +3,10 @@ var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
 var __copyProps = (to, from, except, desc) => {
   if (from && typeof from === "object" || typeof from === "function") {
     for (let key of __getOwnPropNames(from))
@@ -15,5 +19,39 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 
 // src/index.ts
 var index_exports = {};
+__export(index_exports, {
+  BucketEventType: () => BucketEventType,
+  DatastoreEventType: () => DatastoreEventType,
+  SourceType: () => SourceType,
+  WebSocketSender: () => WebSocketSender
+});
 module.exports = __toCommonJS(index_exports);
+
+// src/websocket.ts
+var WebSocketSender = /* @__PURE__ */ Symbol.for("celerity:websocket-sender");
+
+// src/consumer.ts
+var SourceType = {
+  Bucket: "bucket",
+  Datastore: "datastore",
+  Queue: "queue",
+  Topic: "topic"
+};
+var BucketEventType = {
+  Created: "created",
+  Deleted: "deleted",
+  MetadataUpdated: "metadataUpdated"
+};
+var DatastoreEventType = {
+  Inserted: "inserted",
+  Modified: "modified",
+  Removed: "removed"
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  BucketEventType,
+  DatastoreEventType,
+  SourceType,
+  WebSocketSender
+});
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["export type {\n  Type,\n  InjectionToken,\n  Closeable,\n  ClassProvider,\n  FactoryProvider,\n  ValueProvider,\n  Provider,\n} from \"./common\";\n\nexport type {\n  HttpMethod,\n  HttpRequest,\n  HttpResponse,\n  HandlerMetadata,\n  HandlerContext,\n} from \"./http\";\n\nexport type { ServiceContainer } from \"./container\";\n\nexport type { HandlerResponse, NextFunction, CelerityLayer } from \"./layer\";\n\nexport type { Schema } from \"./validation\";\n\nexport type { FunctionHandlerDefinition, ModuleMetadata } from \"./module\";\n\nexport type { LogLevel, CelerityLogger, CelerityTracer, CeleritySpan } from \"./telemetry\";\n"],"mappings":";;;;;;;;;;;;;;;;AA0BA;;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/websocket.ts","../src/consumer.ts"],"sourcesContent":["export type {\n  Type,\n  InjectionToken,\n  Closeable,\n  ClassProvider,\n  FactoryProvider,\n  ValueProvider,\n  Provider,\n} from \"./common\";\n\nexport type { HandlerType, BaseHandlerContext } from \"./handler\";\n\nexport type {\n  HttpMethod,\n  HttpRequest,\n  HttpResponse,\n  HandlerMetadata,\n  HttpHandlerContext,\n  GuardHandlerRequest,\n  GuardHandlerContext,\n} from \"./http\";\n\nexport type { ServiceContainer } from \"./container\";\n\nexport type { HandlerResponse, NextFunction, CelerityLayer } from \"./layer\";\n\nexport type { Schema } from \"./validation\";\n\nexport type { FunctionHandlerDefinition, GuardDefinition, ModuleMetadata } from \"./module\";\n\nexport type { LogLevel, CelerityLogger, CelerityTracer, CeleritySpan } from \"./telemetry\";\n\nexport type {\n  WebSocketEventType,\n  WebSocketMessageType,\n  WebSocketMessage,\n  WebSocketRequestContext,\n  WebSocketHandlerContext,\n  WebSocketSendOptions,\n} from \"./websocket\";\n\n// WebSocketSender is both a type (interface) and a value (DI token symbol).\n// The regular export allows both to be re-exported.\nexport { WebSocketSender } from \"./websocket\";\n\nexport type {\n  MessageAttributeValue,\n  MessageAttributes,\n  ConsumerMessage,\n  ConsumerEventInput,\n  ConsumerHandlerContext,\n  MessageProcessingFailure,\n  EventResult,\n  ValidatedConsumerMessage,\n  BucketEvent,\n  DatastoreEvent,\n} from \"./consumer\";\n\nexport { SourceType, BucketEventType, DatastoreEventType } from \"./consumer\";\n\nexport type { ScheduleEventInput, ScheduleHandlerContext } from \"./schedule\";\n","import type { BaseHandlerContext } from \"./handler\";\n\nexport type WebSocketEventType = \"connect\" | \"message\" | \"disconnect\";\nexport type WebSocketMessageType = \"json\" | \"binary\";\n\n/** SDK representation of a WebSocket message from the runtime. */\nexport type WebSocketMessage = {\n  messageType: WebSocketMessageType;\n  eventType: WebSocketEventType;\n  connectionId: string;\n  messageId: string;\n  jsonBody?: unknown;\n  binaryBody?: Buffer;\n  requestContext?: WebSocketRequestContext;\n  traceContext?: Record<string, string> | null;\n};\n\n/** HTTP context from the original WebSocket upgrade request. */\nexport type WebSocketRequestContext = {\n  requestId: string;\n  requestTime: number;\n  path: string;\n  protocolVersion: string;\n  headers: Record<string, string | string[]>;\n  userAgent?: string;\n  clientIp: string;\n  query: Record<string, string | string[]>;\n  cookies: Record<string, string>;\n  auth?: Record<string, unknown>;\n  traceContext?: Record<string, string>;\n};\n\n/** Context for WebSocket handlers. */\nexport type WebSocketHandlerContext = BaseHandlerContext & {\n  message: WebSocketMessage;\n};\n\nexport type WebSocketSendOptions = {\n  messageId?: string;\n  messageType?: \"json\" | \"binary\";\n};\n\n/** Platform-agnostic abstraction for sending WebSocket messages. */\nexport interface WebSocketSender {\n  /** Send a message to a specific WebSocket connection. */\n  sendMessage(connectionId: string, data: unknown, options?: WebSocketSendOptions): Promise<void>;\n}\n\n/**\n * DI token for WebSocketSender.\n * TypeScript uses the interface in type position and the symbol in value position.\n */\nexport const WebSocketSender: unique symbol = Symbol.for(\"celerity:websocket-sender\");\n","import type { BaseHandlerContext } from \"./handler\";\n\n/**\n * A single attribute value in the SQS-compatible format used by all consumers.\n * `stringValue` is optional because binary-typed attributes may omit it.\n */\nexport type MessageAttributeValue = {\n  dataType: string;\n  stringValue?: string;\n  binaryValue?: string;\n};\n\n/** Key-value map of message attributes attached to a consumer message. */\nexport type MessageAttributes = Record<string, MessageAttributeValue>;\n\n/** A single message from an event source. */\nexport type ConsumerMessage = {\n  messageId: string;\n  body: string;\n  source: string;\n  sourceType?: string;\n  sourceName?: string;\n  eventType?: string;\n  messageAttributes: MessageAttributes;\n  vendor: unknown;\n};\n\n/** Consumer source types corresponding to Celerity resource kinds. */\nexport const SourceType = {\n  Bucket: \"bucket\",\n  Datastore: \"datastore\",\n  Queue: \"queue\",\n  Topic: \"topic\",\n} as const;\nexport type SourceType = (typeof SourceType)[keyof typeof SourceType];\n\n/** Celerity-standard bucket event types (mapped from cloud-specific names). */\nexport const BucketEventType = {\n  Created: \"created\",\n  Deleted: \"deleted\",\n  MetadataUpdated: \"metadataUpdated\",\n} as const;\nexport type BucketEventType = (typeof BucketEventType)[keyof typeof BucketEventType];\n\n/** Celerity-standard datastore event types (mapped from cloud-specific names). */\nexport const DatastoreEventType = {\n  Inserted: \"inserted\",\n  Modified: \"modified\",\n  Removed: \"removed\",\n} as const;\nexport type DatastoreEventType = (typeof DatastoreEventType)[keyof typeof DatastoreEventType];\n\n/** Celerity-standard bucket event body shape. */\nexport type BucketEvent = {\n  key: string;\n  size?: number;\n  eTag?: string;\n};\n\n/** Celerity-standard datastore event body shape. */\nexport type DatastoreEvent = {\n  keys: Record<string, unknown>;\n  newItem?: Record<string, unknown>;\n  oldItem?: Record<string, unknown>;\n};\n\n/** Input provided to a consumer handler — a batch of messages. */\nexport type ConsumerEventInput = {\n  handlerTag: string;\n  messages: ConsumerMessage[];\n  vendor: unknown;\n  traceContext?: Record<string, string> | null;\n};\n\n/** Context for consumer event handlers. */\nexport type ConsumerHandlerContext = BaseHandlerContext & {\n  event: ConsumerEventInput;\n};\n\n/** Individual message processing failure for partial failure reporting. */\nexport type MessageProcessingFailure = {\n  messageId: string;\n  errorMessage?: string;\n};\n\n/** Result returned from consumer and schedule handlers. */\nexport type EventResult = {\n  success: boolean;\n  failures?: MessageProcessingFailure[];\n  errorMessage?: string;\n};\n\n/**\n * A consumer message with a schema-validated parsed body.\n * Returned by @Messages(schema) and createConsumerHandler({ messageSchema }).\n * Retains all original ConsumerMessage fields so the handler can\n * correlate parsed bodies with message metadata (messageId, source, etc.).\n */\nexport type ValidatedConsumerMessage<T> = ConsumerMessage & {\n  parsedBody: T;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAyCA;;;;;;;;;;ACWO,IAAMA,kBAAiCC,uBAAOC,IAAI,2BAAA;;;ACxBlD,IAAMC,aAAa;EACxBC,QAAQ;EACRC,WAAW;EACXC,OAAO;EACPC,OAAO;AACT;AAIO,IAAMC,kBAAkB;EAC7BC,SAAS;EACTC,SAAS;EACTC,iBAAiB;AACnB;AAIO,IAAMC,qBAAqB;EAChCC,UAAU;EACVC,UAAU;EACVC,SAAS;AACX;","names":["WebSocketSender","Symbol","for","SourceType","Bucket","Datastore","Queue","Topic","BucketEventType","Created","Deleted","MetadataUpdated","DatastoreEventType","Inserted","Modified","Removed"]}

package/dist/index.d.cts

@@ -84,18 +84,51 @@ interface HandlerMetadata {
     /** Check if key exists (either scope). */
     has(key: string): boolean;
 }
-type HandlerContext = {
+type HttpHandlerContext = BaseHandlerContext & {
     request: HttpRequest;
+};
+/** Request data available to guard handlers from the runtime. */
+type GuardHandlerRequest = {
+    method: string;
+    path: string;
+    headers: Record<string, string | string[]>;
+    query: Record<string, string | string[]>;
+    cookies: Record<string, string>;
+    body: unknown;
+    requestId: string;
+    clientIp: string;
+};
+/** Context passed to guard `check()` methods. */
+type GuardHandlerContext = {
+    /** Auth token extracted by the runtime (using the configured token source and auth scheme). */
+    token: string;
+    /** Accumulated auth from preceding guards, keyed by guard name. */
+    auth: Record<string, unknown>;
+    /** Request data available from the runtime. */
+    request: GuardHandlerRequest;
+    /** Handler metadata from decorators (e.g. `@Action`). */
     metadata: HandlerMetadata;
+    /** DI container for resolving services. */
     container: ServiceContainer;
-    /** Request-scoped logger set by TelemetryLayer. Enriched with requestId, method, path. */
+    /** Request-scoped logger, when available. */
     logger?: CelerityLogger;
 };
 
-type HandlerResponse = HttpResponse;
-type NextFunction = () => Promise<HandlerResponse>;
-interface CelerityLayer<TContext extends HandlerContext = HandlerContext> {
-    handle(context: TContext, next: NextFunction): Promise<HandlerResponse>;
+type HandlerType = "http" | "websocket" | "consumer" | "schedule" | "custom";
+/** Shared fields present in every handler context. */
+type BaseHandlerContext = {
+    metadata: HandlerMetadata;
+    container: ServiceContainer;
+    /** Request-scoped logger set by TelemetryLayer. */
+    logger?: CelerityLogger;
+};
+
+type HandlerResponse = unknown;
+type NextFunction = () => Promise<unknown>;
+interface CelerityLayer<TContext extends BaseHandlerContext = HttpHandlerContext> {
+    /** When defined, the layer only executes for the returned handler types. Omit to run for all types. */
+    supports?(handlerType: HandlerType): boolean;
+    handle(context: TContext, next: NextFunction): Promise<unknown>;
     dispose?(): Promise<void> | void;
 }
 
@@ -106,13 +139,20 @@ interface Schema<T = unknown> {
 type FunctionHandlerDefinition = {
     __celerity_handler: true;
     id?: string;
-    type: "http" | "consumer" | "schedule" | "websocket";
+    type: "http" | "consumer" | "schedule" | "websocket" | "workflow" | "custom";
     metadata: Record<string, unknown>;
     handler: (...args: unknown[]) => unknown;
 };
+type GuardDefinition = {
+    __celerity_guard: true;
+    name?: string;
+    handler: (...args: unknown[]) => unknown;
+    metadata?: Record<string, unknown>;
+};
 type ModuleMetadata = {
     controllers?: Type[];
     functionHandlers?: FunctionHandlerDefinition[];
+    guards?: (Type | GuardDefinition)[];
     providers?: (Type | (Provider & {
         provide: InjectionToken;
     }))[];
@@ -120,4 +160,153 @@ type ModuleMetadata = {
     exports?: InjectionToken[];
 };
 
-export type { CelerityLayer, CelerityLogger, CeleritySpan, CelerityTracer, ClassProvider, Closeable, FactoryProvider, FunctionHandlerDefinition, HandlerContext, HandlerMetadata, HandlerResponse, HttpMethod, HttpRequest, HttpResponse, InjectionToken, LogLevel, ModuleMetadata, NextFunction, Provider, Schema, ServiceContainer, Type, ValueProvider };
+type WebSocketEventType = "connect" | "message" | "disconnect";
+type WebSocketMessageType = "json" | "binary";
+/** SDK representation of a WebSocket message from the runtime. */
+type WebSocketMessage = {
+    messageType: WebSocketMessageType;
+    eventType: WebSocketEventType;
+    connectionId: string;
+    messageId: string;
+    jsonBody?: unknown;
+    binaryBody?: Buffer;
+    requestContext?: WebSocketRequestContext;
+    traceContext?: Record<string, string> | null;
+};
+/** HTTP context from the original WebSocket upgrade request. */
+type WebSocketRequestContext = {
+    requestId: string;
+    requestTime: number;
+    path: string;
+    protocolVersion: string;
+    headers: Record<string, string | string[]>;
+    userAgent?: string;
+    clientIp: string;
+    query: Record<string, string | string[]>;
+    cookies: Record<string, string>;
+    auth?: Record<string, unknown>;
+    traceContext?: Record<string, string>;
+};
+/** Context for WebSocket handlers. */
+type WebSocketHandlerContext = BaseHandlerContext & {
+    message: WebSocketMessage;
+};
+type WebSocketSendOptions = {
+    messageId?: string;
+    messageType?: "json" | "binary";
+};
+/** Platform-agnostic abstraction for sending WebSocket messages. */
+interface WebSocketSender {
+    /** Send a message to a specific WebSocket connection. */
+    sendMessage(connectionId: string, data: unknown, options?: WebSocketSendOptions): Promise<void>;
+}
+/**
+ * DI token for WebSocketSender.
+ * TypeScript uses the interface in type position and the symbol in value position.
+ */
+declare const WebSocketSender: unique symbol;
+
+/**
+ * A single attribute value in the SQS-compatible format used by all consumers.
+ * `stringValue` is optional because binary-typed attributes may omit it.
+ */
+type MessageAttributeValue = {
+    dataType: string;
+    stringValue?: string;
+    binaryValue?: string;
+};
+/** Key-value map of message attributes attached to a consumer message. */
+type MessageAttributes = Record<string, MessageAttributeValue>;
+/** A single message from an event source. */
+type ConsumerMessage = {
+    messageId: string;
+    body: string;
+    source: string;
+    sourceType?: string;
+    sourceName?: string;
+    eventType?: string;
+    messageAttributes: MessageAttributes;
+    vendor: unknown;
+};
+/** Consumer source types corresponding to Celerity resource kinds. */
+declare const SourceType: {
+    readonly Bucket: "bucket";
+    readonly Datastore: "datastore";
+    readonly Queue: "queue";
+    readonly Topic: "topic";
+};
+type SourceType = (typeof SourceType)[keyof typeof SourceType];
+/** Celerity-standard bucket event types (mapped from cloud-specific names). */
+declare const BucketEventType: {
+    readonly Created: "created";
+    readonly Deleted: "deleted";
+    readonly MetadataUpdated: "metadataUpdated";
+};
+type BucketEventType = (typeof BucketEventType)[keyof typeof BucketEventType];
+/** Celerity-standard datastore event types (mapped from cloud-specific names). */
+declare const DatastoreEventType: {
+    readonly Inserted: "inserted";
+    readonly Modified: "modified";
+    readonly Removed: "removed";
+};
+type DatastoreEventType = (typeof DatastoreEventType)[keyof typeof DatastoreEventType];
+/** Celerity-standard bucket event body shape. */
+type BucketEvent = {
+    key: string;
+    size?: number;
+    eTag?: string;
+};
+/** Celerity-standard datastore event body shape. */
+type DatastoreEvent = {
+    keys: Record<string, unknown>;
+    newItem?: Record<string, unknown>;
+    oldItem?: Record<string, unknown>;
+};
+/** Input provided to a consumer handler — a batch of messages. */
+type ConsumerEventInput = {
+    handlerTag: string;
+    messages: ConsumerMessage[];
+    vendor: unknown;
+    traceContext?: Record<string, string> | null;
+};
+/** Context for consumer event handlers. */
+type ConsumerHandlerContext = BaseHandlerContext & {
+    event: ConsumerEventInput;
+};
+/** Individual message processing failure for partial failure reporting. */
+type MessageProcessingFailure = {
+    messageId: string;
+    errorMessage?: string;
+};
+/** Result returned from consumer and schedule handlers. */
+type EventResult = {
+    success: boolean;
+    failures?: MessageProcessingFailure[];
+    errorMessage?: string;
+};
+/**
+ * A consumer message with a schema-validated parsed body.
+ * Returned by @Messages(schema) and createConsumerHandler({ messageSchema }).
+ * Retains all original ConsumerMessage fields so the handler can
+ * correlate parsed bodies with message metadata (messageId, source, etc.).
+ */
+type ValidatedConsumerMessage<T> = ConsumerMessage & {
+    parsedBody: T;
+};
+
+/** Input provided to a schedule handler. */
+type ScheduleEventInput = {
+    handlerTag: string;
+    scheduleId: string;
+    messageId: string;
+    schedule: string;
+    input?: unknown;
+    vendor: unknown;
+    traceContext?: Record<string, string> | null;
+};
+/** Context for schedule event handlers. */
+type ScheduleHandlerContext = BaseHandlerContext & {
+    event: ScheduleEventInput;
+};
+
+export { type BaseHandlerContext, type BucketEvent, BucketEventType, type CelerityLayer, type CelerityLogger, type CeleritySpan, type CelerityTracer, type ClassProvider, type Closeable, type ConsumerEventInput, type ConsumerHandlerContext, type ConsumerMessage, type DatastoreEvent, DatastoreEventType, type EventResult, type FactoryProvider, type FunctionHandlerDefinition, type GuardDefinition, type GuardHandlerContext, type GuardHandlerRequest, type HandlerMetadata, type HandlerResponse, type HandlerType, type HttpHandlerContext, type HttpMethod, type HttpRequest, type HttpResponse, type InjectionToken, type LogLevel, type MessageAttributeValue, type MessageAttributes, type MessageProcessingFailure, type ModuleMetadata, type NextFunction, type Provider, type ScheduleEventInput, type ScheduleHandlerContext, type Schema, type ServiceContainer, SourceType, type Type, type ValidatedConsumerMessage, type ValueProvider, type WebSocketEventType, type WebSocketHandlerContext, type WebSocketMessage, type WebSocketMessageType, type WebSocketRequestContext, type WebSocketSendOptions, WebSocketSender };

package/dist/index.d.ts

@@ -84,18 +84,51 @@ interface HandlerMetadata {
     /** Check if key exists (either scope). */
     has(key: string): boolean;
 }
-type HandlerContext = {
+type HttpHandlerContext = BaseHandlerContext & {
     request: HttpRequest;
+};
+/** Request data available to guard handlers from the runtime. */
+type GuardHandlerRequest = {
+    method: string;
+    path: string;
+    headers: Record<string, string | string[]>;
+    query: Record<string, string | string[]>;
+    cookies: Record<string, string>;
+    body: unknown;
+    requestId: string;
+    clientIp: string;
+};
+/** Context passed to guard `check()` methods. */
+type GuardHandlerContext = {
+    /** Auth token extracted by the runtime (using the configured token source and auth scheme). */
+    token: string;
+    /** Accumulated auth from preceding guards, keyed by guard name. */
+    auth: Record<string, unknown>;
+    /** Request data available from the runtime. */
+    request: GuardHandlerRequest;
+    /** Handler metadata from decorators (e.g. `@Action`). */
     metadata: HandlerMetadata;
+    /** DI container for resolving services. */
     container: ServiceContainer;
-    /** Request-scoped logger set by TelemetryLayer. Enriched with requestId, method, path. */
+    /** Request-scoped logger, when available. */
     logger?: CelerityLogger;
 };
 
-type HandlerResponse = HttpResponse;
-type NextFunction = () => Promise<HandlerResponse>;
-interface CelerityLayer<TContext extends HandlerContext = HandlerContext> {
-    handle(context: TContext, next: NextFunction): Promise<HandlerResponse>;
+type HandlerType = "http" | "websocket" | "consumer" | "schedule" | "custom";
+/** Shared fields present in every handler context. */
+type BaseHandlerContext = {
+    metadata: HandlerMetadata;
+    container: ServiceContainer;
+    /** Request-scoped logger set by TelemetryLayer. */
+    logger?: CelerityLogger;
+};
+
+type HandlerResponse = unknown;
+type NextFunction = () => Promise<unknown>;
+interface CelerityLayer<TContext extends BaseHandlerContext = HttpHandlerContext> {
+    /** When defined, the layer only executes for the returned handler types. Omit to run for all types. */
+    supports?(handlerType: HandlerType): boolean;
+    handle(context: TContext, next: NextFunction): Promise<unknown>;
     dispose?(): Promise<void> | void;
 }
 
@@ -106,13 +139,20 @@ interface Schema<T = unknown> {
 type FunctionHandlerDefinition = {
     __celerity_handler: true;
     id?: string;
-    type: "http" | "consumer" | "schedule" | "websocket";
+    type: "http" | "consumer" | "schedule" | "websocket" | "workflow" | "custom";
     metadata: Record<string, unknown>;
     handler: (...args: unknown[]) => unknown;
 };
+type GuardDefinition = {
+    __celerity_guard: true;
+    name?: string;
+    handler: (...args: unknown[]) => unknown;
+    metadata?: Record<string, unknown>;
+};
 type ModuleMetadata = {
     controllers?: Type[];
     functionHandlers?: FunctionHandlerDefinition[];
+    guards?: (Type | GuardDefinition)[];
     providers?: (Type | (Provider & {
         provide: InjectionToken;
     }))[];
@@ -120,4 +160,153 @@ type ModuleMetadata = {
     exports?: InjectionToken[];
 };
 
-export type { CelerityLayer, CelerityLogger, CeleritySpan, CelerityTracer, ClassProvider, Closeable, FactoryProvider, FunctionHandlerDefinition, HandlerContext, HandlerMetadata, HandlerResponse, HttpMethod, HttpRequest, HttpResponse, InjectionToken, LogLevel, ModuleMetadata, NextFunction, Provider, Schema, ServiceContainer, Type, ValueProvider };
+type WebSocketEventType = "connect" | "message" | "disconnect";
+type WebSocketMessageType = "json" | "binary";
+/** SDK representation of a WebSocket message from the runtime. */
+type WebSocketMessage = {
+    messageType: WebSocketMessageType;
+    eventType: WebSocketEventType;
+    connectionId: string;
+    messageId: string;
+    jsonBody?: unknown;
+    binaryBody?: Buffer;
+    requestContext?: WebSocketRequestContext;
+    traceContext?: Record<string, string> | null;
+};
+/** HTTP context from the original WebSocket upgrade request. */
+type WebSocketRequestContext = {
+    requestId: string;
+    requestTime: number;
+    path: string;
+    protocolVersion: string;
+    headers: Record<string, string | string[]>;
+    userAgent?: string;
+    clientIp: string;
+    query: Record<string, string | string[]>;
+    cookies: Record<string, string>;
+    auth?: Record<string, unknown>;
+    traceContext?: Record<string, string>;
+};
+/** Context for WebSocket handlers. */
+type WebSocketHandlerContext = BaseHandlerContext & {
+    message: WebSocketMessage;
+};
+type WebSocketSendOptions = {
+    messageId?: string;
+    messageType?: "json" | "binary";
+};
+/** Platform-agnostic abstraction for sending WebSocket messages. */
+interface WebSocketSender {
+    /** Send a message to a specific WebSocket connection. */
+    sendMessage(connectionId: string, data: unknown, options?: WebSocketSendOptions): Promise<void>;
+}
+/**
+ * DI token for WebSocketSender.
+ * TypeScript uses the interface in type position and the symbol in value position.
+ */
+declare const WebSocketSender: unique symbol;
+
+/**
+ * A single attribute value in the SQS-compatible format used by all consumers.
+ * `stringValue` is optional because binary-typed attributes may omit it.
+ */
+type MessageAttributeValue = {
+    dataType: string;
+    stringValue?: string;
+    binaryValue?: string;
+};
+/** Key-value map of message attributes attached to a consumer message. */
+type MessageAttributes = Record<string, MessageAttributeValue>;
+/** A single message from an event source. */
+type ConsumerMessage = {
+    messageId: string;
+    body: string;
+    source: string;
+    sourceType?: string;
+    sourceName?: string;
+    eventType?: string;
+    messageAttributes: MessageAttributes;
+    vendor: unknown;
+};
+/** Consumer source types corresponding to Celerity resource kinds. */
+declare const SourceType: {
+    readonly Bucket: "bucket";
+    readonly Datastore: "datastore";
+    readonly Queue: "queue";
+    readonly Topic: "topic";
+};
+type SourceType = (typeof SourceType)[keyof typeof SourceType];
+/** Celerity-standard bucket event types (mapped from cloud-specific names). */
+declare const BucketEventType: {
+    readonly Created: "created";
+    readonly Deleted: "deleted";
+    readonly MetadataUpdated: "metadataUpdated";
+};
+type BucketEventType = (typeof BucketEventType)[keyof typeof BucketEventType];
+/** Celerity-standard datastore event types (mapped from cloud-specific names). */
+declare const DatastoreEventType: {
+    readonly Inserted: "inserted";
+    readonly Modified: "modified";
+    readonly Removed: "removed";
+};
+type DatastoreEventType = (typeof DatastoreEventType)[keyof typeof DatastoreEventType];
+/** Celerity-standard bucket event body shape. */
+type BucketEvent = {
+    key: string;
+    size?: number;
+    eTag?: string;
+};
+/** Celerity-standard datastore event body shape. */
+type DatastoreEvent = {
+    keys: Record<string, unknown>;
+    newItem?: Record<string, unknown>;
+    oldItem?: Record<string, unknown>;
+};
+/** Input provided to a consumer handler — a batch of messages. */
+type ConsumerEventInput = {
+    handlerTag: string;
+    messages: ConsumerMessage[];
+    vendor: unknown;
+    traceContext?: Record<string, string> | null;
+};
+/** Context for consumer event handlers. */
+type ConsumerHandlerContext = BaseHandlerContext & {
+    event: ConsumerEventInput;
+};
+/** Individual message processing failure for partial failure reporting. */
+type MessageProcessingFailure = {
+    messageId: string;
+    errorMessage?: string;
+};
+/** Result returned from consumer and schedule handlers. */
+type EventResult = {
+    success: boolean;
+    failures?: MessageProcessingFailure[];
+    errorMessage?: string;
+};
+/**
+ * A consumer message with a schema-validated parsed body.
+ * Returned by @Messages(schema) and createConsumerHandler({ messageSchema }).
+ * Retains all original ConsumerMessage fields so the handler can
+ * correlate parsed bodies with message metadata (messageId, source, etc.).
+ */
+type ValidatedConsumerMessage<T> = ConsumerMessage & {
+    parsedBody: T;
+};
+
+/** Input provided to a schedule handler. */
+type ScheduleEventInput = {
+    handlerTag: string;
+    scheduleId: string;
+    messageId: string;
+    schedule: string;
+    input?: unknown;
+    vendor: unknown;
+    traceContext?: Record<string, string> | null;
+};
+/** Context for schedule event handlers. */
+type ScheduleHandlerContext = BaseHandlerContext & {
+    event: ScheduleEventInput;
+};
+
+export { type BaseHandlerContext, type BucketEvent, BucketEventType, type CelerityLayer, type CelerityLogger, type CeleritySpan, type CelerityTracer, type ClassProvider, type Closeable, type ConsumerEventInput, type ConsumerHandlerContext, type ConsumerMessage, type DatastoreEvent, DatastoreEventType, type EventResult, type FactoryProvider, type FunctionHandlerDefinition, type GuardDefinition, type GuardHandlerContext, type GuardHandlerRequest, type HandlerMetadata, type HandlerResponse, type HandlerType, type HttpHandlerContext, type HttpMethod, type HttpRequest, type HttpResponse, type InjectionToken, type LogLevel, type MessageAttributeValue, type MessageAttributes, type MessageProcessingFailure, type ModuleMetadata, type NextFunction, type Provider, type ScheduleEventInput, type ScheduleHandlerContext, type Schema, type ServiceContainer, SourceType, type Type, type ValidatedConsumerMessage, type ValueProvider, type WebSocketEventType, type WebSocketHandlerContext, type WebSocketMessage, type WebSocketMessageType, type WebSocketRequestContext, type WebSocketSendOptions, WebSocketSender };

package/dist/index.js

@@ -1 +1,27 @@
+// src/websocket.ts
+var WebSocketSender = /* @__PURE__ */ Symbol.for("celerity:websocket-sender");
+
+// src/consumer.ts
+var SourceType = {
+  Bucket: "bucket",
+  Datastore: "datastore",
+  Queue: "queue",
+  Topic: "topic"
+};
+var BucketEventType = {
+  Created: "created",
+  Deleted: "deleted",
+  MetadataUpdated: "metadataUpdated"
+};
+var DatastoreEventType = {
+  Inserted: "inserted",
+  Modified: "modified",
+  Removed: "removed"
+};
+export {
+  BucketEventType,
+  DatastoreEventType,
+  SourceType,
+  WebSocketSender
+};
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}
+{"version":3,"sources":["../src/websocket.ts","../src/consumer.ts"],"sourcesContent":["import type { BaseHandlerContext } from \"./handler\";\n\nexport type WebSocketEventType = \"connect\" | \"message\" | \"disconnect\";\nexport type WebSocketMessageType = \"json\" | \"binary\";\n\n/** SDK representation of a WebSocket message from the runtime. */\nexport type WebSocketMessage = {\n  messageType: WebSocketMessageType;\n  eventType: WebSocketEventType;\n  connectionId: string;\n  messageId: string;\n  jsonBody?: unknown;\n  binaryBody?: Buffer;\n  requestContext?: WebSocketRequestContext;\n  traceContext?: Record<string, string> | null;\n};\n\n/** HTTP context from the original WebSocket upgrade request. */\nexport type WebSocketRequestContext = {\n  requestId: string;\n  requestTime: number;\n  path: string;\n  protocolVersion: string;\n  headers: Record<string, string | string[]>;\n  userAgent?: string;\n  clientIp: string;\n  query: Record<string, string | string[]>;\n  cookies: Record<string, string>;\n  auth?: Record<string, unknown>;\n  traceContext?: Record<string, string>;\n};\n\n/** Context for WebSocket handlers. */\nexport type WebSocketHandlerContext = BaseHandlerContext & {\n  message: WebSocketMessage;\n};\n\nexport type WebSocketSendOptions = {\n  messageId?: string;\n  messageType?: \"json\" | \"binary\";\n};\n\n/** Platform-agnostic abstraction for sending WebSocket messages. */\nexport interface WebSocketSender {\n  /** Send a message to a specific WebSocket connection. */\n  sendMessage(connectionId: string, data: unknown, options?: WebSocketSendOptions): Promise<void>;\n}\n\n/**\n * DI token for WebSocketSender.\n * TypeScript uses the interface in type position and the symbol in value position.\n */\nexport const WebSocketSender: unique symbol = Symbol.for(\"celerity:websocket-sender\");\n","import type { BaseHandlerContext } from \"./handler\";\n\n/**\n * A single attribute value in the SQS-compatible format used by all consumers.\n * `stringValue` is optional because binary-typed attributes may omit it.\n */\nexport type MessageAttributeValue = {\n  dataType: string;\n  stringValue?: string;\n  binaryValue?: string;\n};\n\n/** Key-value map of message attributes attached to a consumer message. */\nexport type MessageAttributes = Record<string, MessageAttributeValue>;\n\n/** A single message from an event source. */\nexport type ConsumerMessage = {\n  messageId: string;\n  body: string;\n  source: string;\n  sourceType?: string;\n  sourceName?: string;\n  eventType?: string;\n  messageAttributes: MessageAttributes;\n  vendor: unknown;\n};\n\n/** Consumer source types corresponding to Celerity resource kinds. */\nexport const SourceType = {\n  Bucket: \"bucket\",\n  Datastore: \"datastore\",\n  Queue: \"queue\",\n  Topic: \"topic\",\n} as const;\nexport type SourceType = (typeof SourceType)[keyof typeof SourceType];\n\n/** Celerity-standard bucket event types (mapped from cloud-specific names). */\nexport const BucketEventType = {\n  Created: \"created\",\n  Deleted: \"deleted\",\n  MetadataUpdated: \"metadataUpdated\",\n} as const;\nexport type BucketEventType = (typeof BucketEventType)[keyof typeof BucketEventType];\n\n/** Celerity-standard datastore event types (mapped from cloud-specific names). */\nexport const DatastoreEventType = {\n  Inserted: \"inserted\",\n  Modified: \"modified\",\n  Removed: \"removed\",\n} as const;\nexport type DatastoreEventType = (typeof DatastoreEventType)[keyof typeof DatastoreEventType];\n\n/** Celerity-standard bucket event body shape. */\nexport type BucketEvent = {\n  key: string;\n  size?: number;\n  eTag?: string;\n};\n\n/** Celerity-standard datastore event body shape. */\nexport type DatastoreEvent = {\n  keys: Record<string, unknown>;\n  newItem?: Record<string, unknown>;\n  oldItem?: Record<string, unknown>;\n};\n\n/** Input provided to a consumer handler — a batch of messages. */\nexport type ConsumerEventInput = {\n  handlerTag: string;\n  messages: ConsumerMessage[];\n  vendor: unknown;\n  traceContext?: Record<string, string> | null;\n};\n\n/** Context for consumer event handlers. */\nexport type ConsumerHandlerContext = BaseHandlerContext & {\n  event: ConsumerEventInput;\n};\n\n/** Individual message processing failure for partial failure reporting. */\nexport type MessageProcessingFailure = {\n  messageId: string;\n  errorMessage?: string;\n};\n\n/** Result returned from consumer and schedule handlers. */\nexport type EventResult = {\n  success: boolean;\n  failures?: MessageProcessingFailure[];\n  errorMessage?: string;\n};\n\n/**\n * A consumer message with a schema-validated parsed body.\n * Returned by @Messages(schema) and createConsumerHandler({ messageSchema }).\n * Retains all original ConsumerMessage fields so the handler can\n * correlate parsed bodies with message metadata (messageId, source, etc.).\n */\nexport type ValidatedConsumerMessage<T> = ConsumerMessage & {\n  parsedBody: T;\n};\n"],"mappings":";AAoDO,IAAMA,kBAAiCC,uBAAOC,IAAI,2BAAA;;;ACxBlD,IAAMC,aAAa;EACxBC,QAAQ;EACRC,WAAW;EACXC,OAAO;EACPC,OAAO;AACT;AAIO,IAAMC,kBAAkB;EAC7BC,SAAS;EACTC,SAAS;EACTC,iBAAiB;AACnB;AAIO,IAAMC,qBAAqB;EAChCC,UAAU;EACVC,UAAU;EACVC,SAAS;AACX;","names":["WebSocketSender","Symbol","for","SourceType","Bucket","Datastore","Queue","Topic","BucketEventType","Created","Deleted","MetadataUpdated","DatastoreEventType","Inserted","Modified","Removed"]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@celerity-sdk/types",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Shared TypeScript interfaces and types for the Celerity Node SDK",
   "license": "Apache-2.0",
   "repository": {