ocpp-ws-io 2.1.3 → 2.1.5

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { E as EventAdapterInterface, A as AuthCallback, L as LoggerLike, a as LoggingConfig, M as MiddlewareFunction, b as MiddlewareContext, C as ConnectionMiddleware, T as TypedEventEmitter, S as ServerEvents, c as CORSOptions, R as RouterConfig, O as OCPPProtocol, d as AllMethodNames, e as RouterHandlerContext, f as OCPPRequestType, g as OCPPResponseType, h as RouterWildcardHandler, i as ServerOptions, j as LoggerLikeNotOptional, k as OCPPServerClient, l as OCPPServerStats, m as ListenOptions, n as CloseOptions, o as CallOptions, V as Validator } from './index-BixJj_yJ.js';
-export { p as AnyOCPPProtocol, q as AuthAccept, r as CallHandler, s as ClientEvents, t as ClientOptions, u as ConnectionContext, v as ConnectionState, H as HandlerContext, w as HandshakeInfo, x as MessageType, y as MiddlewareNext, z as MiddlewareStack, N as NOREPLY, B as OCPP16Methods, D as OCPP201Methods, F as OCPP21Methods, G as OCPPCall, I as OCPPCallError, J as OCPPCallResult, K as OCPPClient, P as OCPPMessage, Q as OCPPMethodMap, U as OCPPProtocolKey, W as RedisAdapter, X as SecurityProfile, Y as SessionData, Z as TLSOptions, _ as WildcardHandler, $ as createValidator } from './index-BixJj_yJ.js';
+import { E as EventAdapterInterface, A as AuthCallback, L as LoggerLike, a as LoggingConfig, M as MiddlewareFunction, b as MiddlewareContext, C as ConnectionMiddleware, T as TypedEventEmitter, S as ServerEvents, c as CORSOptions, R as RouterConfig, O as OCPPProtocol, d as AllMethodNames, e as RouterHandlerContext, f as OCPPRequestType, g as OCPPResponseType, h as RouterWildcardHandler, i as ServerOptions, j as LoggerLikeNotOptional, k as OCPPServerClient, l as OCPPServerStats, m as ListenOptions, n as TLSOptions, o as CloseOptions, p as CallOptions, V as Validator } from './index-1QBeqAuc.js';
+export { q as AnyOCPPProtocol, r as AuthAccept, s as CallHandler, t as ClientEvents, u as ClientOptions, v as ConnectionContext, w as ConnectionState, H as HandlerContext, x as HandshakeInfo, y as MessageType, z as MiddlewareNext, B as MiddlewareStack, N as NOREPLY, D as OCPP16Methods, F as OCPP201Methods, G as OCPP21Methods, I as OCPPCall, J as OCPPCallError, K as OCPPCallResult, P as OCPPClient, Q as OCPPMessage, U as OCPPMethodMap, W as OCPPProtocolKey, X as RedisAdapter, Y as SecurityProfile, Z as SessionData, _ as WildcardHandler, $ as createValidator } from './index-1QBeqAuc.js';
 import { Server, IncomingMessage } from 'node:http';
 import { Duplex } from 'node:stream';
 import 'ws';
@@ -28,6 +28,11 @@ declare class InMemoryAdapter implements EventAdapterInterface {
     getPresence(identity: string): Promise<string | null>;
     getPresenceBatch(identities: string[]): Promise<(string | null)[]>;
     removePresence(identity: string): Promise<void>;
+    setPresenceBatch(entries: {
+        identity: string;
+        nodeId: string;
+        ttl?: number;
+    }[]): Promise<void>;
 }
 /**
  * Helper function to create a custom EventAdapter without needing to define a rigid Class.
@@ -160,6 +165,38 @@ declare function combineAuth(...cbs: AuthCallback[]): AuthCallback;
  */
 declare function createLoggingMiddleware(logger: LoggerLike, identity: string, config?: LoggingConfig | boolean): MiddlewareFunction<MiddlewareContext, any>;
 
+/**
+ * LRUMap — A zero-dependency, drop-in Map replacement with a maximum capacity.
+ *
+ * Evicts the **least recently used** entry when the capacity is exceeded.
+ * Uses native Map insertion-order semantics for O(1) LRU tracking
+ * (delete + re-insert moves a key to the "most recent" end).
+ *
+ * @remarks
+ * This is used by OCPPServer to bound the `_sessions` map and prevent OOM under
+ * DDoS or reconnection storms with transient identities.
+ */
+declare class LRUMap<K, V> extends Map<K, V> {
+    private _maxSize;
+    constructor(maxSize: number);
+    /**
+     * Returns the configured maximum capacity of this LRU cache.
+     */
+    get maxSize(): number;
+    /**
+     * Sets a key-value pair. If the key already exists, it is promoted to the
+     * most-recently-used position. If inserting a new key would exceed capacity,
+     * the oldest (least-recently-used) entry is evicted.
+     */
+    set(key: K, value: V): this;
+    /**
+     * Gets a value by key and promotes it to the most-recently-used position.
+     * Uses `this.has(key)` instead of a value truthiness check to correctly
+     * handle stored values of `undefined`, `null`, `0`, `""`, etc.
+     */
+    get(key: K): V | undefined;
+}
+
 /**
  * Compiled regex pattern for RegExp-based route fallback.
  * Only used when a user registers a RegExp pattern (not string patterns).
@@ -280,6 +317,7 @@ declare class OCPPServer extends OCPPServer_base {
     private _httpServerAbortControllers;
     private _logger;
     private _globalCORS?;
+    private _connectionBuckets;
     private readonly _nodeId;
     private _sessions;
     private _gcInterval;
@@ -361,6 +399,28 @@ declare class OCPPServer extends OCPPServer_base {
      */
     private _registerRouter;
     listen(port?: number, host?: string, options?: ListenOptions): Promise<Server>;
+    /**
+     * Hot-reloads the TLS certificate on all active HTTPS servers without
+     * dropping any existing WebSocket connections.
+     *
+     * **When to use:** Call this whenever your TLS certificate is renewed —
+     * for example, after a Let's Encrypt auto-renewal (every ~90 days).
+     * Without this, you would need to restart the Node.js process to pick up
+     * the new certificate, disconnecting all connected charging stations.
+     *
+     * **How to use:**
+     * ```ts
+     * server.updateTLS({ cert: newCert, key: newKey });
+     * ```
+     *
+     * **Optional:** Only relevant if you are terminating TLS directly in Node.js
+     * (i.e. `SecurityProfile.TLS_BASIC_AUTH` or `TLS_CLIENT_CERT`). If you are
+     * running behind a reverse proxy (Nginx, AWS ALB, etc.) that handles TLS,
+     * you do not need this method — just rotate the cert on the proxy.
+     *
+     * @throws If the server is not using a TLS Security Profile.
+     */
+    updateTLS(tlsOpts: TLSOptions): void;
     get handleUpgrade(): (req: IncomingMessage, socket: Duplex, head: Buffer) => Promise<void>;
     /**
      * Core upgrade handler. Follows a strict pipeline:
@@ -418,11 +478,7 @@ declare class OCPPServer extends OCPPServer_base {
     broadcastBatch<V extends AllMethodNames<any>>(identities: string[], method: V, params: OCPPRequestType<any, V>, options?: CallOptions): Promise<void>;
 }
 
-/**
- * Pre-built validators for all supported OCPP protocol versions.
- * These are automatically registered when strict mode is enabled.
- */
-declare const standardValidators: Validator[];
+declare function getStandardValidators(): Validator[];
 
 /**
  * Instantiate a typed RPCError from a string error code.
@@ -446,4 +502,4 @@ declare function getErrorPlainObject(err: Error): Record<string, unknown>;
  */
 declare function getPackageIdent(): string;
 
-export { AllMethodNames, AuthCallback, CORSOptions, CallOptions, CloseOptions, ConnectionMiddleware, EventAdapterInterface, InMemoryAdapter, ListenOptions, LoggerLike, LoggingConfig, MiddlewareFunction, OCPPProtocol, OCPPRequestType, OCPPResponseType, OCPPRouter, OCPPServer, OCPPServerClient, type RPCError, RPCFormatViolationError, RPCFormationViolationError, RPCFrameworkError, RPCGenericError, RPCInternalError, RPCMessageTypeNotSupportedError, RPCNotImplementedError, RPCNotSupportedError, RPCOccurrenceConstraintViolationError, RPCPropertyConstraintViolationError, RPCProtocolError, RPCSecurityError, RPCTypeConstraintViolationError, RouterConfig, ServerEvents, ServerOptions, TimeoutError, TypedEventEmitter, UnexpectedHttpResponse, Validator, WebsocketUpgradeError, combineAuth, createLoggingMiddleware, createRPCError, createRouter, defineAdapter, defineAuth, defineMiddleware, defineRpcMiddleware, getErrorPlainObject, getPackageIdent, standardValidators };
+export { AllMethodNames, AuthCallback, CORSOptions, CallOptions, CloseOptions, ConnectionMiddleware, EventAdapterInterface, InMemoryAdapter, LRUMap, ListenOptions, LoggerLike, LoggingConfig, MiddlewareFunction, OCPPProtocol, OCPPRequestType, OCPPResponseType, OCPPRouter, OCPPServer, OCPPServerClient, type RPCError, RPCFormatViolationError, RPCFormationViolationError, RPCFrameworkError, RPCGenericError, RPCInternalError, RPCMessageTypeNotSupportedError, RPCNotImplementedError, RPCNotSupportedError, RPCOccurrenceConstraintViolationError, RPCPropertyConstraintViolationError, RPCProtocolError, RPCSecurityError, RPCTypeConstraintViolationError, RouterConfig, ServerEvents, ServerOptions, TLSOptions, TimeoutError, TypedEventEmitter, UnexpectedHttpResponse, Validator, WebsocketUpgradeError, combineAuth, createLoggingMiddleware, createRPCError, createRouter, defineAdapter, defineAuth, defineMiddleware, defineRpcMiddleware, getErrorPlainObject, getPackageIdent, getStandardValidators };