@sirena-lwm2m/coap 0.8.0

package/dist/transport/tcp-frame.js

@@ -0,0 +1,112 @@
+import { encodeOptions, decodeOptions } from '../option-parser/index.js';
+export class TcpFrameDecodeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'TcpFrameDecodeError';
+    }
+}
+// RFC 8323 §3.2: Len field encoding
+// Len 0–12 = literal (options+payload length)
+// Len 13   = 8-bit extended  (actual = extended byte + 13)
+// Len 14   = 16-bit extended (actual = extended uint16 BE + 269)
+// Len 15   = 32-bit extended (actual = extended uint32 BE + 65805)
+function encodeLenField(len) {
+    if (len <= 12) {
+        return { nibble: len, extended: new Uint8Array(0) };
+    }
+    else if (len <= 268) {
+        return { nibble: 13, extended: new Uint8Array([len - 13]) };
+    }
+    else if (len <= 65804) {
+        const v = len - 269;
+        return { nibble: 14, extended: new Uint8Array([(v >> 8) & 0xff, v & 0xff]) };
+    }
+    else {
+        const v = len - 65805;
+        return {
+            nibble: 15,
+            extended: new Uint8Array([
+                (v >>> 24) & 0xff,
+                (v >>> 16) & 0xff,
+                (v >>> 8) & 0xff,
+                v & 0xff,
+            ]),
+        };
+    }
+}
+export function encodeTcpFrame(frame) {
+    const tkl = frame.token.length;
+    const encodedOpts = encodeOptions(frame.options);
+    const hasPayload = frame.payload.length > 0;
+    const optPayloadLen = encodedOpts.length + (hasPayload ? 1 + frame.payload.length : 0);
+    const { nibble, extended } = encodeLenField(optPayloadLen);
+    // byte 0: Len(4-bit) | TKL(4-bit)
+    const byte0 = ((nibble & 0x0f) << 4) | (tkl & 0x0f);
+    const totalLen = 1 + extended.length + 1 + tkl + optPayloadLen;
+    const result = new Uint8Array(totalLen);
+    let pos = 0;
+    result[pos++] = byte0;
+    result.set(extended, pos);
+    pos += extended.length;
+    result[pos++] = frame.code & 0xff;
+    result.set(frame.token, pos);
+    pos += tkl;
+    result.set(encodedOpts, pos);
+    pos += encodedOpts.length;
+    if (hasPayload) {
+        result[pos++] = 0xff;
+        result.set(frame.payload, pos);
+    }
+    return result;
+}
+export function decodeTcpFrame(buf) {
+    if (buf.length < 1)
+        return null;
+    const byte0 = buf[0];
+    const lenNibble = (byte0 >> 4) & 0x0f;
+    const tkl = byte0 & 0x0f;
+    let pos = 1;
+    let optPayloadLen;
+    if (lenNibble <= 12) {
+        optPayloadLen = lenNibble;
+    }
+    else if (lenNibble === 13) {
+        if (buf.length < pos + 1)
+            return null;
+        optPayloadLen = buf[pos] + 13;
+        pos += 1;
+    }
+    else if (lenNibble === 14) {
+        if (buf.length < pos + 2)
+            return null;
+        optPayloadLen = ((buf[pos] << 8) | buf[pos + 1]) + 269;
+        pos += 2;
+    }
+    else {
+        // lenNibble === 15
+        if (buf.length < pos + 4)
+            return null;
+        const v = (buf[pos] * 0x1000000) +
+            ((buf[pos + 1] << 16) | (buf[pos + 2] << 8) | buf[pos + 3]);
+        pos += 4;
+        if (v > Number.MAX_SAFE_INTEGER - 65805) {
+            throw new TcpFrameDecodeError('Extended Len=15 value exceeds Number.MAX_SAFE_INTEGER');
+        }
+        optPayloadLen = v + 65805;
+    }
+    // Need: Code byte + TKL bytes + optPayloadLen bytes
+    const totalNeeded = pos + 1 + tkl + optPayloadLen;
+    if (buf.length < totalNeeded)
+        return null;
+    const code = buf[pos++];
+    const token = buf.slice(pos, pos + tkl);
+    pos += tkl;
+    const optPayloadBuf = buf.slice(pos, pos + optPayloadLen);
+    const { options, payloadOffset } = decodeOptions(optPayloadBuf, 0);
+    const payload = optPayloadBuf.slice(payloadOffset);
+    return {
+        frame: { code, token, options, payload },
+        bytesConsumed: totalNeeded,
+    };
+}
+//# sourceMappingURL=tcp-frame.js.map

package/dist/transport/tcp-frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-frame.js","sourceRoot":"","sources":["../../src/transport/tcp-frame.ts"],"names":[],"mappings":"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"}

package/dist/transport/tcp-stream.d.ts

@@ -0,0 +1,21 @@
+import { EventEmitter } from 'node:events';
+import net from 'node:net';
+import type { Logger } from './udp.js';
+export interface ExchangeHandle {
+    token: Uint8Array;
+    createdAt: number;
+}
+export declare class TcpFrameStream extends EventEmitter {
+    private readonly log;
+    private accumulator;
+    private readonly exchanges;
+    constructor({ socket, logger }: {
+        socket: net.Socket;
+        logger: Logger;
+    });
+    protected _onData(chunk: Buffer): void;
+    registerExchange(token: Uint8Array): void;
+    resolveExchange(token: Uint8Array): ExchangeHandle | undefined;
+    activeCount(): number;
+}
+//# sourceMappingURL=tcp-stream.d.ts.map

package/dist/transport/tcp-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-stream.d.ts","sourceRoot":"","sources":["../../src/transport/tcp-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,GAAG,MAAM,UAAU,CAAC;AAG3B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAEvC,MAAM,WAAW,cAAc;IAC7B,KAAK,EAAE,UAAU,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,cAAe,SAAQ,YAAY;IAC9C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAS;IAC7B,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAqC;gBAEnD,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE;QAAE,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC;QAAC,MAAM,EAAE,MAAM,CAAA;KAAE;IAmBtE,SAAS,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAWtC,gBAAgB,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAKzC,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,cAAc,GAAG,SAAS;IAS9D,WAAW,IAAI,MAAM;CAGtB"}

package/dist/transport/tcp-stream.js

@@ -0,0 +1,52 @@
+import { EventEmitter } from 'node:events';
+import { decodeTcpFrame, TcpFrameDecodeError } from './tcp-frame.js';
+export class TcpFrameStream extends EventEmitter {
+    log;
+    accumulator = Buffer.alloc(0);
+    exchanges = new Map();
+    constructor({ socket, logger }) {
+        super();
+        this.log = logger;
+        socket.on('data', (chunk) => {
+            try {
+                this._onData(chunk);
+            }
+            catch (err) {
+                if (err instanceof TcpFrameDecodeError) {
+                    this.log.error('tcp frame decode error', { err: err.message });
+                    this.accumulator = Buffer.alloc(0);
+                    this.emit('frame-error', err);
+                }
+                else {
+                    throw err;
+                }
+            }
+        });
+    }
+    _onData(chunk) {
+        this.accumulator = Buffer.concat([this.accumulator, chunk]);
+        while (this.accumulator.length > 0) {
+            const result = decodeTcpFrame(this.accumulator);
+            if (result === null)
+                break;
+            this.accumulator = this.accumulator.subarray(result.bytesConsumed);
+            this.emit('frame', result.frame);
+        }
+    }
+    registerExchange(token) {
+        const key = Buffer.from(token).toString('hex');
+        this.exchanges.set(key, { token, createdAt: Date.now() });
+    }
+    resolveExchange(token) {
+        const key = Buffer.from(token).toString('hex');
+        const handle = this.exchanges.get(key);
+        if (handle !== undefined) {
+            this.exchanges.delete(key);
+        }
+        return handle;
+    }
+    activeCount() {
+        return this.exchanges.size;
+    }
+}
+//# sourceMappingURL=tcp-stream.js.map

package/dist/transport/tcp-stream.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tcp-stream.js","sourceRoot":"","sources":["../../src/transport/tcp-stream.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAO,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AASrE,MAAM,OAAO,cAAe,SAAQ,YAAY;IAC7B,GAAG,CAAS;IACrB,WAAW,GAAW,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAC7B,SAAS,GAAG,IAAI,GAAG,EAA0B,CAAC;IAE/D,YAAY,EAAE,MAAM,EAAE,MAAM,EAA0C;QACpE,KAAK,EAAE,CAAC;QACR,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC;QAElB,MAAM,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAa,EAAE,EAAE;YAClC,IAAI,CAAC;gBACH,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACtB,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,IAAI,GAAG,YAAY,mBAAmB,EAAE,CAAC;oBACvC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,wBAAwB,EAAE,EAAE,GAAG,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC;oBAC/D,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;oBACnC,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;gBAChC,CAAC;qBAAM,CAAC;oBACN,MAAM,GAAG,CAAC;gBACZ,CAAC;YACH,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAES,OAAO,CAAC,KAAa;QAC7B,IAAI,CAAC,WAAW,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,CAAC;QAE5D,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACnC,MAAM,MAAM,GAAG,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;YAChD,IAAI,MAAM,KAAK,IAAI;gBAAE,MAAM;YAC3B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC,QAAQ,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC;YACnE,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;QACnC,CAAC;IACH,CAAC;IAED,gBAAgB,CAAC,KAAiB;QAChC,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,eAAe,CAAC,KAAiB;QAC/B,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAC/C,MAAM,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;QACD,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,WAAW;QACT,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;IAC7B,CAAC;CACF"}

package/dist/transport/udp.d.ts

@@ -0,0 +1,97 @@
+import { EventEmitter } from 'node:events';
+import type { TransactionStore } from '../store/index.js';
+import { Request } from '../api/index.js';
+import type { ExchangeContext, Peer } from '../api/index.js';
+import type { CoapMetrics } from '../observability.js';
+export interface Logger {
+    debug(msg: string, meta?: object): void;
+    info(msg: string, meta?: object): void;
+    warn(msg: string, meta?: object): void;
+    error(msg: string, meta?: object): void;
+}
+export interface ListenAddress {
+    host: string;
+    port: number;
+}
+export type ResolvedAddress = {
+    host: string;
+    port: number;
+    transport: 'udp' | 'tcp' | 'dtls' | 'tls';
+};
+export interface PskSecurityOptions {
+    mode: 'psk';
+    psk: (identity: string) => Buffer | null;
+    sessionCacheSize?: number;
+}
+export interface X509SecurityOptions {
+    mode: 'x509';
+    key: string | Buffer;
+    cert: string | Buffer;
+    ca?: string | Buffer;
+    requestClientCert?: boolean;
+    sessionCacheSize?: number;
+}
+export type SecurityOptions = PskSecurityOptions | X509SecurityOptions;
+export declare function parseListenAddress(addr: string | ListenAddress): ResolvedAddress;
+export interface ServerOptions {
+    listen: Array<string | ListenAddress>;
+    security?: SecurityOptions;
+    store?: TransactionStore;
+    logger?: Logger;
+    metrics?: CoapMetrics;
+    queueSize?: number;
+    drainTimeoutMs?: number;
+    ackTimeoutMs?: number;
+    ackRandomFactor?: number;
+    maxRetransmit?: number;
+    nonTimeoutMs?: number;
+    nstart?: number;
+    perEndpointLruCap?: number;
+}
+export interface StoreSummaryEntry {
+    transport: 'udp' | 'tcp' | 'dtls' | 'tls';
+    isDefault: boolean;
+}
+export interface DtlsHandshakeEvent {
+    peer: Peer;
+    durationMs: number;
+}
+export interface TlsHandshakeEvent {
+    peer: Peer;
+    durationMs: number;
+}
+export interface UpdateTlsOptions {
+    cert: string | Buffer;
+    key: string | Buffer;
+}
+export interface Server extends EventEmitter {
+    start(): Promise<void>;
+    stop(opts?: {
+        drainTimeoutMs?: number;
+    }): Promise<void>;
+    on(event: 'request', listener: (req: Request, ctx: ExchangeContext) => void): this;
+    on(event: 'response', listener: (ctx: ExchangeContext) => void): this;
+    on(event: 'exchange-error', listener: (err: Error) => void): this;
+    on(event: 'message-dropped', listener: (reason: string) => void): this;
+    on(event: 'dtls-handshake', listener: (event: DtlsHandshakeEvent) => void): this;
+    on(event: 'tls-handshake', listener: (event: TlsHandshakeEvent) => void): this;
+    on(event: string, listener: (...args: unknown[]) => void): this;
+    isReady(): boolean;
+    activeExchanges(): number;
+    listenerSummary(): Array<{
+        host: string;
+        port: number;
+        transport: 'udp' | 'tcp' | 'dtls' | 'tls';
+    }>;
+    storeSummary(): StoreSummaryEntry[];
+    /**
+     * Rotate the TLS certificate and key for all active TLS listeners.
+     *
+     * Only affects new TLS handshakes — existing TLSSockets are not renegotiated.
+     * If called before start(), the new certs are stored and picked up by start().
+     * A no-op on servers with no TLS (coaps+tcp://) listeners.
+     */
+    updateTls(opts: UpdateTlsOptions): void;
+}
+export declare function createServer(options: ServerOptions): Server;
+//# sourceMappingURL=udp.d.ts.map

package/dist/transport/udp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"udp.d.ts","sourceRoot":"","sources":["../../src/transport/udp.ts"],"names":[],"mappings":"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"}