@adonix.org/cloud-spark 2.2.0 → 2.3.0

package/dist/index.d.ts

@@ -2,6 +2,7 @@ import CacheLib from 'cache-control-parser';
 import { W as WorkerClass, M as Method, a as Worker, b as Middleware } from './middleware-CfKw8AlN.js';
 export { D as DELETE, G as GET, H as HEAD, O as OPTIONS, d as PATCH, c as POST, P as PUT } from './middleware-CfKw8AlN.js';
 import { MatchFunction } from 'path-to-regexp';
+export { C as CustomEventMap, a as CustomEventType, E as EventOptions, d as ExtendedEventListener, b as ExtendedEventMap, c as ExtendedEventType, e as WSAttachment, W as WarnEvent, f as WebSocketConnection } from './websocket-DR6W2q9z.js';
 
 /**
  * @see {@link https://github.com/etienne-martin/cache-control-parser | cache-control-parser}

package/dist/sessions.d.ts

@@ -1,119 +1,4 @@
-/**
- * Represents a warning event emitted by a WebSocket.
- */
-type WarnEvent = {
-    type: "warn";
-    message: string;
-};
-/**
- * Map of custom WebSocket events.
- * - `warn`: internal warning notifications
- * - `open`: triggered when the WebSocket is accepted
- */
-type CustomEventMap = {
-    warn: WarnEvent;
-    open: Event;
-};
-/** Options for registering WebSocket event listeners. */
-type EventOptions = {
-    once?: boolean;
-};
-/** Map of all events, combining native WebSocket events and custom events. */
-type ExtendedEventMap = WebSocketEventMap & CustomEventMap;
-/** Names of all events, including standard and custom WebSocket events. */
-type ExtendedEventType = keyof ExtendedEventMap;
-/** Event listener type for an extended WebSocket event. */
-type ExtendedEventListener<K extends ExtendedEventType> = (ev: ExtendedEventMap[K]) => void;
-/**
- * Represents a user-defined attachment object that can be associated with a WebSocket connection.
- */
-type WSAttachment = object;
-/**
- * Represents a managed WebSocket connection with typed attachment and extended event support.
- *
- * @template A - Type of the attachment object associated with this connection.
- */
-interface WebSocketConnection<A extends WSAttachment> {
-    /**
-     * Current readyState of the WebSocket (0 = CONNECTING, 1 = OPEN, 2 = CLOSING, 3 = CLOSED).
-     */
-    get readyState(): number;
-    /**
-     * Checks whether the WebSocket is currently in one of the provided states.
-     *
-     * @param states - List of WebSocket readyState values to check against.
-     * @returns `true` if the WebSocket's readyState matches any of the provided states.
-     */
-    isState(...states: number[]): boolean;
-    /**
-     * Accepts the WebSocket connection if not already accepted.
-     *
-     * @returns The readonly native WebSocket instance.
-     */
-    accept(): Readonly<WebSocket>;
-    /**
-     * Accepts the WebSocket connection in the context of a Durable Object.
-     * Optionally associates tags for filtering.
-     *
-     * @param ctx - DurableObjectState for the WebSocket.
-     * @param tags - Optional list of string tags.
-     * @returns The readonly native WebSocket instance.
-     */
-    acceptWebSocket(ctx: DurableObjectState, tags?: string[]): Readonly<WebSocket>;
-    /**
-     * Retrieves the user-defined attachment object associated with this connection.
-     *
-     * The returned object is a read-only view of the attachment to prevent
-     * accidental mutation. To modify the attachment, call {@link attach}.
-     *
-     * @returns A read-only view of the current attachment.
-     */
-    get attachment(): Readonly<A>;
-    /**
-     * Attaches or updates a user-defined object on this connection.
-     *
-     * Passing a partial object merges the new properties into the existing
-     * attachment, leaving other fields unchanged. Pass `null` to clear
-     * the attachment entirely.
-     *
-     * @param attachment - Partial object containing metadata to attach or update,
-     *                     or `null` to clear the attachment.
-     */
-    attach(attachment?: Partial<A> | null): void;
-    /**
-     * Sends a message to the connected WebSocket client.
-     *
-     * @param message - Message to send, either string or binary data.
-     */
-    send(message: string | ArrayBuffer): void;
-    /**
-     * Closes the WebSocket connection with an optional code and reason.
-     *
-     * @param code - Close code (default is `1000` NORMAL).
-     * @param reason - Optional reason string (sanitized to valid characters).
-     */
-    close(code?: number, reason?: string): void;
-    /**
-     * Registers an event listener for a WebSocket event.
-     *
-     * Supports both standard WebSocket events (`message`, `close`, etc.)
-     * and custom events (`open`, `warn`).
-     *
-     * @param type - Event type to listen for.
-     * @param listener - Callback invoked when the event occurs.
-     * @param options - Optional event listener options (`once`).
-     */
-    addEventListener<K extends ExtendedEventType>(type: K, listener: ExtendedEventListener<K>, options?: EventOptions): void;
-    /**
-     * Removes a previously registered WebSocket event listener.
-     *
-     * Works for both standard and custom events.
-     *
-     * @param type - Event type to remove.
-     * @param listener - Listener function to remove.
-     */
-    removeEventListener<K extends ExtendedEventType>(type: K, listener: ExtendedEventListener<K>): void;
-}
+import { e as WSAttachment, f as WebSocketConnection } from './websocket-DR6W2q9z.js';
 
 /**
  * Manages active WebSocket connections in a Cloudflare Workers environment.

package/dist/websocket-DR6W2q9z.d.ts

@@ -0,0 +1,120 @@
+/**
+ * Represents a warning event emitted by a WebSocket.
+ */
+type WarnEvent = {
+    type: "warn";
+    message: string;
+};
+/**
+ * Map of custom WebSocket events.
+ * - `warn`: internal warning notifications
+ * - `open`: triggered when the WebSocket is accepted
+ */
+type CustomEventMap = {
+    warn: WarnEvent;
+    open: Event;
+};
+/** Options for registering WebSocket event listeners. */
+type EventOptions = {
+    once?: boolean;
+};
+/** Names of custom WebSocket events (`warn`, `open`). */
+type CustomEventType = keyof CustomEventMap;
+/** Map of all events, combining native WebSocket events and custom events. */
+type ExtendedEventMap = WebSocketEventMap & CustomEventMap;
+/** Names of all events, including standard and custom WebSocket events. */
+type ExtendedEventType = keyof ExtendedEventMap;
+/** Event listener type for an extended WebSocket event. */
+type ExtendedEventListener<K extends ExtendedEventType> = (ev: ExtendedEventMap[K]) => void;
+/**
+ * Represents a user-defined attachment object that can be associated with a WebSocket connection.
+ */
+type WSAttachment = object;
+/**
+ * Represents a managed WebSocket connection with typed attachment and extended event support.
+ *
+ * @template A - Type of the attachment object associated with this connection.
+ */
+interface WebSocketConnection<A extends WSAttachment> {
+    /**
+     * Current readyState of the WebSocket (0 = CONNECTING, 1 = OPEN, 2 = CLOSING, 3 = CLOSED).
+     */
+    get readyState(): number;
+    /**
+     * Checks whether the WebSocket is currently in one of the provided states.
+     *
+     * @param states - List of WebSocket readyState values to check against.
+     * @returns `true` if the WebSocket's readyState matches any of the provided states.
+     */
+    isState(...states: number[]): boolean;
+    /**
+     * Accepts the WebSocket connection if not already accepted.
+     *
+     * @returns The readonly native WebSocket instance.
+     */
+    accept(): Readonly<WebSocket>;
+    /**
+     * Accepts the WebSocket connection in the context of a Durable Object.
+     * Optionally associates tags for filtering.
+     *
+     * @param ctx - DurableObjectState for the WebSocket.
+     * @param tags - Optional list of string tags.
+     * @returns The readonly native WebSocket instance.
+     */
+    acceptWebSocket(ctx: DurableObjectState, tags?: string[]): Readonly<WebSocket>;
+    /**
+     * Retrieves the user-defined attachment object associated with this connection.
+     *
+     * The returned object is a read-only view of the attachment to prevent
+     * accidental mutation. To modify the attachment, call {@link attach}.
+     *
+     * @returns A read-only view of the current attachment.
+     */
+    get attachment(): Readonly<A>;
+    /**
+     * Attaches or updates a user-defined object on this connection.
+     *
+     * Passing a partial object merges the new properties into the existing
+     * attachment, leaving other fields unchanged. Pass `null` to clear
+     * the attachment entirely.
+     *
+     * @param attachment - Partial object containing metadata to attach or update,
+     *                     or `null` to clear the attachment.
+     */
+    attach(attachment?: Partial<A> | null): void;
+    /**
+     * Sends a message to the connected WebSocket client.
+     *
+     * @param message - Message to send, either string or binary data.
+     */
+    send(message: string | ArrayBuffer): void;
+    /**
+     * Closes the WebSocket connection with an optional code and reason.
+     *
+     * @param code - Close code (default is `1000` NORMAL).
+     * @param reason - Optional reason string (sanitized to valid characters).
+     */
+    close(code?: number, reason?: string): void;
+    /**
+     * Registers an event listener for a WebSocket event.
+     *
+     * Supports both standard WebSocket events (`message`, `close`, etc.)
+     * and custom events (`open`, `warn`).
+     *
+     * @param type - Event type to listen for.
+     * @param listener - Callback invoked when the event occurs.
+     * @param options - Optional event listener options (`once`).
+     */
+    addEventListener<K extends ExtendedEventType>(type: K, listener: ExtendedEventListener<K>, options?: EventOptions): void;
+    /**
+     * Removes a previously registered WebSocket event listener.
+     *
+     * Works for both standard and custom events.
+     *
+     * @param type - Event type to remove.
+     * @param listener - Listener function to remove.
+     */
+    removeEventListener<K extends ExtendedEventType>(type: K, listener: ExtendedEventListener<K>): void;
+}
+
+export type { CustomEventMap as C, EventOptions as E, WarnEvent as W, CustomEventType as a, ExtendedEventMap as b, ExtendedEventType as c, ExtendedEventListener as d, WSAttachment as e, WebSocketConnection as f };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@adonix.org/cloud-spark",
-    "version": "2.2.0",
+    "version": "2.3.0",
     "description": "Ignite your Cloudflare Workers with a type-safe library for rapid development.",
     "license": "Apache-2.0",
     "type": "module",