@sirena-lwm2m/coap 0.8.0

package/dist/blockwise/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/blockwise/index.ts"],"names":[],"mappings":"AAAA,YAAY,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAChG,YAAY,EAAE,sBAAsB,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC;AACtD,YAAY,EAAE,0BAA0B,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/blockwise/index.js

@@ -0,0 +1,5 @@
+export { BlockOptionError, encodeBlockOption, decodeBlockOption, blockSize } from './option.js';
+export { Block1Assembler } from './block1-assembler.js';
+export { Block2Chunker } from './block2-chunker.js';
+export { blockwiseMiddleware } from './middleware.js';
+//# sourceMappingURL=index.js.map

package/dist/blockwise/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/blockwise/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEhG,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAC"}

package/dist/blockwise/middleware.d.ts

@@ -0,0 +1,7 @@
+import type { Middleware } from '../router/router.js';
+export interface BlockwiseMiddlewareOptions {
+    maxBytes?: number;
+    idleTimeoutMs?: number;
+}
+export declare function blockwiseMiddleware(options?: BlockwiseMiddlewareOptions): Middleware;
+//# sourceMappingURL=middleware.d.ts.map

package/dist/blockwise/middleware.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../../src/blockwise/middleware.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAItD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AA0BD,wBAAgB,mBAAmB,CAAC,OAAO,CAAC,EAAE,0BAA0B,GAAG,UAAU,CAyGpF"}

package/dist/blockwise/middleware.js

@@ -0,0 +1,120 @@
+import { OptionNumber } from '../option-parser/index.js';
+import { decodeBlockOption, encodeBlockOption } from './option.js';
+import { Block1Assembler } from './block1-assembler.js';
+import { Block2Chunker } from './block2-chunker.js';
+// RFC 7959 / RFC 7252 CoAP response codes (cls<<5 | detail)
+const CODE_REQUEST_INCOMPLETE = 0x88; // 4.08
+const CODE_TOO_LARGE = 0x8d; // 4.13
+const ETAG_OPTION = 4;
+function makeResponse(statusCode, body, opts) {
+    return {
+        statusCode,
+        status: '',
+        body: body ?? null,
+        headers: {
+            get: (_name) => null,
+            has: (_name) => false,
+            set: (_name, _value) => { },
+            toOptions: () => opts ?? [],
+        },
+    };
+}
+export function blockwiseMiddleware(options) {
+    const assemblers = new Map();
+    const chunkers = new Map();
+    return async (req, ctx, next) => {
+        const tokenKey = Buffer.from(ctx.token).toString('hex');
+        const block1Opt = ctx.options.find(o => o.number === OptionNumber.Block1);
+        const block2Opt = ctx.options.find(o => o.number === OptionNumber.Block2);
+        // Block1 upload path
+        if (block1Opt) {
+            const block = decodeBlockOption(block1Opt.value);
+            let assembler = assemblers.get(tokenKey);
+            if (!assembler) {
+                assembler = new Block1Assembler({
+                    maxBytes: options?.maxBytes,
+                    idleTimeoutMs: options?.idleTimeoutMs,
+                });
+                assemblers.set(tokenKey, assembler);
+                assembler.once('block-transfer-aborted', () => assemblers.delete(tokenKey));
+                assembler.once('block-transfer-complete', () => assemblers.delete(tokenKey));
+            }
+            let chunkPayload;
+            if (req.body) {
+                const reader = req.body.getReader();
+                const chunks = [];
+                while (true) {
+                    const { done, value } = await reader.read();
+                    if (done)
+                        break;
+                    if (value)
+                        chunks.push(value);
+                }
+                const total = chunks.reduce((n, c) => n + c.length, 0);
+                chunkPayload = new Uint8Array(total);
+                let pos = 0;
+                for (const chunk of chunks) {
+                    chunkPayload.set(chunk, pos);
+                    pos += chunk.length;
+                }
+            }
+            else {
+                chunkPayload = new Uint8Array(0);
+            }
+            const result = assembler.addChunk(block.num, block.szx, block.m, chunkPayload);
+            if (result === 'continue') {
+                await ctx.continue();
+                return;
+            }
+            if (result === 'out-of-order') {
+                assembler.abort('out-of-order');
+                await ctx.respond(makeResponse(CODE_REQUEST_INCOMPLETE));
+                return;
+            }
+            if (result === 'too-large') {
+                await ctx.respond(makeResponse(CODE_TOO_LARGE));
+                return;
+            }
+            // 'complete': attach assembled body and forward to handler
+            req.body = assembler.body;
+            await next();
+            return;
+        }
+        // Block2 download path
+        if (block2Opt) {
+            const block = decodeBlockOption(block2Opt.value);
+            let capturedResponse;
+            const originalRespond = ctx.respond.bind(ctx);
+            ctx.respond = async (res) => { capturedResponse = res; };
+            await next();
+            ctx.respond = originalRespond;
+            if (!capturedResponse)
+                return;
+            let chunker = chunkers.get(tokenKey);
+            if (!chunker) {
+                const responseBody = capturedResponse.body;
+                if (!responseBody) {
+                    await originalRespond(capturedResponse);
+                    return;
+                }
+                const reqBlockSize = Math.min(1 << (block.szx + 4), 1024);
+                chunker = new Block2Chunker(Buffer.from(responseBody), { blockSize: reqBlockSize });
+                chunkers.set(tokenKey, chunker);
+                chunker.once('block-transfer-complete', () => chunkers.delete(tokenKey));
+                chunker.once('block-transfer-aborted', () => chunkers.delete(tokenKey));
+            }
+            const { payload, m, etag } = await chunker.getBlock(block.num);
+            const existingOpts = capturedResponse.headers.toOptions();
+            const responseOpts = [
+                ...existingOpts,
+                { number: ETAG_OPTION, value: etag },
+                { number: OptionNumber.Block2, value: encodeBlockOption({ num: block.num, szx: block.szx, m }) },
+            ];
+            await originalRespond(makeResponse(capturedResponse.statusCode, payload, responseOpts));
+            return;
+        }
+        // Plain request — pass through unchanged
+        await next();
+    };
+}
+//# sourceMappingURL=middleware.js.map

package/dist/blockwise/middleware.js.map

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

package/dist/blockwise/option.d.ts

@@ -0,0 +1,12 @@
+export interface BlockOption {
+    num: number;
+    szx: number;
+    m: boolean;
+}
+export declare class BlockOptionError extends Error {
+    constructor(message: string);
+}
+export declare function blockSize(szx: number): number;
+export declare function encodeBlockOption(opt: BlockOption): Uint8Array;
+export declare function decodeBlockOption(value: Uint8Array): BlockOption;
+//# sourceMappingURL=option.d.ts.map

package/dist/blockwise/option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.d.ts","sourceRoot":"","sources":["../../src/blockwise/option.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,CAAC,EAAE,OAAO,CAAC;CACZ;AAED,qBAAa,gBAAiB,SAAQ,KAAK;gBAC7B,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CAqB9D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,UAAU,GAAG,WAAW,CAwBhE"}

package/dist/blockwise/option.js

@@ -0,0 +1,55 @@
+// RFC 7959 §2.2 — Block option encoding/decoding
+export class BlockOptionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'BlockOptionError';
+    }
+}
+export function blockSize(szx) {
+    return 2 ** (szx + 4);
+}
+export function encodeBlockOption(opt) {
+    const { num, szx, m } = opt;
+    const mBit = m ? 1 : 0;
+    // Lower 4 bits of first byte: M(1) | SZX(3)
+    const lsb = (mBit << 3) | (szx & 0x07);
+    if (num < 16) {
+        // 1 byte: NUM(4) | M(1) | SZX(3)
+        return new Uint8Array([(num << 4) | lsb]);
+    }
+    else if (num < 4096) {
+        // 2 bytes: 4 high bits of NUM in first byte, 8 low bits in second
+        return new Uint8Array([((num >> 4) & 0xff), ((num & 0x0f) << 4) | lsb]);
+    }
+    else {
+        // 3 bytes: 12 high bits split across first two bytes, 8 low bits in third
+        return new Uint8Array([
+            (num >> 12) & 0xff,
+            (num >> 4) & 0xff,
+            ((num & 0x0f) << 4) | lsb,
+        ]);
+    }
+}
+export function decodeBlockOption(value) {
+    if (value.length === 0 || value.length > 3) {
+        throw new BlockOptionError(`Block option value must be 1–3 bytes, got ${value.length}`);
+    }
+    const lastByte = value[value.length - 1];
+    const szx = lastByte & 0x07;
+    if (szx === 7) {
+        throw new BlockOptionError('SZX value 7 is reserved');
+    }
+    const m = ((lastByte >> 3) & 0x01) === 1;
+    let num;
+    if (value.length === 1) {
+        num = (lastByte >> 4) & 0x0f;
+    }
+    else if (value.length === 2) {
+        num = (value[0] << 4) | ((lastByte >> 4) & 0x0f);
+    }
+    else {
+        num = (value[0] << 12) | (value[1] << 4) | ((lastByte >> 4) & 0x0f);
+    }
+    return { num, szx, m };
+}
+//# sourceMappingURL=option.js.map

package/dist/blockwise/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../../src/blockwise/option.ts"],"names":[],"mappings":"AAAA,iDAAiD;AAQjD,MAAM,OAAO,gBAAiB,SAAQ,KAAK;IACzC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;IACjC,CAAC;CACF;AAED,MAAM,UAAU,SAAS,CAAC,GAAW;IACnC,OAAO,CAAC,IAAI,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,GAAgB;IAChD,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,GAAG,CAAC;IAC5B,MAAM,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEvB,4CAA4C;IAC5C,MAAM,GAAG,GAAG,CAAC,IAAI,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAEvC,IAAI,GAAG,GAAG,EAAE,EAAE,CAAC;QACb,iCAAiC;QACjC,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC5C,CAAC;SAAM,IAAI,GAAG,GAAG,IAAI,EAAE,CAAC;QACtB,kEAAkE;QAClE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,CAAC;IAC1E,CAAC;SAAM,CAAC;QACN,0EAA0E;QAC1E,OAAO,IAAI,UAAU,CAAC;YACpB,CAAC,GAAG,IAAI,EAAE,CAAC,GAAG,IAAI;YAClB,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI;YACjB,CAAC,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,GAAG;SAC1B,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAiB;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,gBAAgB,CAAC,6CAA6C,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAC1F,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IACzC,MAAM,GAAG,GAAG,QAAQ,GAAG,IAAI,CAAC;IAE5B,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACd,MAAM,IAAI,gBAAgB,CAAC,yBAAyB,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC;IAEzC,IAAI,GAAW,CAAC;IAChB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,GAAG,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC;IAC/B,CAAC;SAAM,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC9B,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACnD,CAAC;SAAM,CAAC;QACN,GAAG,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACtE,CAAC;IAED,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,EAAE,CAAC;AACzB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export { encodeOptions, decodeOptions, uintToBytes, bytesToUint, stringToBytes, bytesToString, OptionNumber, } from './option-parser/index.js';
+export type { CoapOption, EncodeOptionsOpts, DecodeOptionsResult } from './option-parser/index.js';
+export { encodeMessage, decodeMessage, codeToString, stringToCode, CoapDecodeError, } from './message/index.js';
+export type { CoapMessage, CoapMessageType, CoapCode } from './message/index.js';
+export { Request, Response, Headers } from './api/index.js';
+export type { ExchangeContext, Peer } from './api/index.js';
+export { createServer } from './transport/index.js';
+export type { Server, ServerOptions, ListenAddress, Logger, ServerEventMap, SecurityOptions, PskSecurityOptions, X509SecurityOptions, DtlsHandshakeEvent } from './transport/index.js';
+export type { Observable, Observer, Unsubscribe } from './observe.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,0BAA0B,CAAC;AAClC,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEnG,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAC5B,YAAY,EAAE,WAAW,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAEjF,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAC5D,YAAY,EAAE,eAAe,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AAE5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EAAE,MAAM,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAEvL,YAAY,EAAE,UAAU,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// @sirena-lwm2m/coap — RFC 7252 CoAP stack
+export { encodeOptions, decodeOptions, uintToBytes, bytesToUint, stringToBytes, bytesToString, OptionNumber, } from './option-parser/index.js';
+export { encodeMessage, decodeMessage, codeToString, stringToCode, CoapDecodeError, } from './message/index.js';
+export { Request, Response, Headers } from './api/index.js';
+export { createServer } from './transport/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAC3C,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,aAAa,EACb,YAAY,GACb,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EACL,aAAa,EACb,aAAa,EACb,YAAY,EACZ,YAAY,EACZ,eAAe,GAChB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AAG5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC"}

package/dist/message/index.d.ts

@@ -0,0 +1,21 @@
+import type { CoapOption } from '../option-parser/index.js';
+export type { CoapOption };
+export type CoapMessageType = 'CON' | 'NON' | 'ACK' | 'RST';
+export type CoapCode = number;
+export interface CoapMessage {
+    version: number;
+    type: CoapMessageType;
+    token: Uint8Array;
+    code: CoapCode;
+    messageId: number;
+    options: CoapOption[];
+    payload: Uint8Array;
+}
+export declare class CoapDecodeError extends Error {
+    constructor(message: string);
+}
+export declare function codeToString(code: CoapCode): string;
+export declare function stringToCode(s: string): CoapCode;
+export declare function encodeMessage(msg: CoapMessage): Uint8Array;
+export declare function decodeMessage(buf: Uint8Array): CoapMessage;
+//# sourceMappingURL=index.d.ts.map

package/dist/message/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/message/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,YAAY,EAAE,UAAU,EAAE,CAAC;AAE3B,MAAM,MAAM,eAAe,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG,MAAM,CAAC;AAE9B,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,EAAE,CAAC;IACtB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAID,wBAAgB,YAAY,CAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAInD;AAED,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,GAAG,QAAQ,CAKhD;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CA6B1D;AAED,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,WAAW,CAyC1D"}

package/dist/message/index.js

@@ -0,0 +1,79 @@
+import { encodeOptions, decodeOptions } from '../option-parser/index.js';
+export class CoapDecodeError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CoapDecodeError';
+    }
+}
+const TYPE_MAP = ['CON', 'NON', 'ACK', 'RST'];
+export function codeToString(code) {
+    const cls = (code >> 5) & 0x07;
+    const detail = code & 0x1f;
+    return `${cls}.${detail.toString().padStart(2, '0')}`;
+}
+export function stringToCode(s) {
+    const [clsStr, detailStr] = s.split('.');
+    const cls = parseInt(clsStr, 10);
+    const detail = parseInt(detailStr, 10);
+    return ((cls & 0x07) << 5) | (detail & 0x1f);
+}
+export function encodeMessage(msg) {
+    const tkl = msg.token.length;
+    const typeVal = TYPE_MAP.indexOf(msg.type);
+    // byte 0: Ver=1 (bits 7-6), T (bits 5-4), TKL (bits 3-0)
+    const byte0 = (1 << 6) | ((typeVal & 0x03) << 4) | (tkl & 0x0f);
+    const byte1 = msg.code & 0xff;
+    const byte2 = (msg.messageId >> 8) & 0xff;
+    const byte3 = msg.messageId & 0xff;
+    const header = new Uint8Array([byte0, byte1, byte2, byte3]);
+    const encodedOptions = encodeOptions(msg.options);
+    const hasPayload = msg.payload.length > 0;
+    const totalLen = 4 + tkl + encodedOptions.length + (hasPayload ? 1 + msg.payload.length : 0);
+    const result = new Uint8Array(totalLen);
+    let pos = 0;
+    result.set(header, pos);
+    pos += 4;
+    result.set(msg.token, pos);
+    pos += tkl;
+    result.set(encodedOptions, pos);
+    pos += encodedOptions.length;
+    if (hasPayload) {
+        result[pos++] = 0xff;
+        result.set(msg.payload, pos);
+    }
+    return result;
+}
+export function decodeMessage(buf) {
+    if (buf.length < 4) {
+        throw new CoapDecodeError(`Buffer too short: ${buf.length} bytes (minimum 4)`);
+    }
+    const byte0 = buf[0];
+    const ver = (byte0 >> 6) & 0x03;
+    if (ver !== 1) {
+        throw new CoapDecodeError(`Invalid CoAP version: ${ver} (expected 1)`);
+    }
+    const typeVal = (byte0 >> 4) & 0x03;
+    const tkl = byte0 & 0x0f;
+    if (tkl > 8) {
+        throw new CoapDecodeError(`Invalid TKL: ${tkl} (max 8)`);
+    }
+    const code = buf[1];
+    const messageId = (buf[2] << 8) | buf[3];
+    if (buf.length < 4 + tkl) {
+        throw new CoapDecodeError(`Buffer too short for token: need ${4 + tkl}, got ${buf.length}`);
+    }
+    const token = buf.slice(4, 4 + tkl);
+    const optionsStart = 4 + tkl;
+    const { options, payloadOffset } = decodeOptions(buf, optionsStart);
+    const payload = payloadOffset < buf.length ? buf.slice(payloadOffset) : new Uint8Array(0);
+    return {
+        version: 1,
+        type: TYPE_MAP[typeVal],
+        token,
+        code,
+        messageId,
+        options,
+        payload,
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/message/index.js.map

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

package/dist/observability.d.ts

@@ -0,0 +1,44 @@
+export interface Counter {
+    add(value: number, attributes?: Record<string, string | number | boolean>): void;
+}
+export interface UpDownCounter {
+    add(value: number, attributes?: Record<string, string | number | boolean>): void;
+}
+export interface Histogram {
+    record(value: number, attributes?: Record<string, string | number | boolean>): void;
+}
+export interface CoapMetrics {
+    /** Incremented on every incoming request (CON or NON). */
+    requestRate: Counter;
+    /** Tracks the number of currently-active exchanges (in-flight handlers). */
+    activeExchanges: UpDownCounter;
+    /** Tracks the number of active Observe registrations. */
+    observeRegistrations: UpDownCounter;
+    /** Incremented when a block-wise transfer completes successfully. */
+    blockTransferComplete: Counter;
+    /** Incremented when a block-wise transfer is aborted. */
+    blockTransferAborted: Counter;
+    /** Incremented on every dedup-store hit (CON retransmission replayed). */
+    dedupHits: Counter;
+    /** Incremented on every transport-level error (decode failure, socket error). */
+    transportErrors: Counter;
+}
+export declare function createNoopMetrics(): CoapMetrics;
+interface OtelMeter {
+    createCounter(name: string, options?: {
+        description?: string;
+        unit?: string;
+    }): Counter;
+    createUpDownCounter(name: string, options?: {
+        description?: string;
+        unit?: string;
+    }): UpDownCounter;
+    createHistogram(name: string, options?: {
+        description?: string;
+        unit?: string;
+    }): Histogram;
+}
+export declare function bindOtel(meter: OtelMeter): CoapMetrics;
+export declare function tryBindOtel(meterName: string): Promise<CoapMetrics>;
+export {};
+//# sourceMappingURL=observability.d.ts.map

package/dist/observability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.d.ts","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAQA,MAAM,WAAW,OAAO;IACtB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,aAAa;IAC5B,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CAClF;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,GAAG,IAAI,CAAC;CACrF;AAED,MAAM,WAAW,WAAW;IAC1B,0DAA0D;IAC1D,WAAW,EAAE,OAAO,CAAC;IACrB,4EAA4E;IAC5E,eAAe,EAAE,aAAa,CAAC;IAC/B,yDAAyD;IACzD,oBAAoB,EAAE,aAAa,CAAC;IACpC,qEAAqE;IACrE,qBAAqB,EAAE,OAAO,CAAC;IAC/B,yDAAyD;IACzD,oBAAoB,EAAE,OAAO,CAAC;IAC9B,0EAA0E;IAC1E,SAAS,EAAE,OAAO,CAAC;IACnB,iFAAiF;IACjF,eAAe,EAAE,OAAO,CAAC;CAC1B;AAOD,wBAAgB,iBAAiB,IAAI,WAAW,CAU/C;AAID,UAAU,SAAS;IACjB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC;IACxF,mBAAmB,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,aAAa,CAAC;IACpG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,WAAW,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,SAAS,CAAC;CAC7F;AAID,wBAAgB,QAAQ,CAAC,KAAK,EAAE,SAAS,GAAG,WAAW,CA+BtD;AAID,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAezE"}

package/dist/observability.js

@@ -0,0 +1,71 @@
+// Lazy OTel metrics — zero cost when @opentelemetry/api is absent.
+//
+// Callers that want real metrics must either:
+//   a) call bindOtel(meter) with a Meter they obtained from their OTel SDK, or
+//   b) call tryBindOtel(meterName) to auto-detect and bind, falling back to no-ops.
+//
+// Import of @opentelemetry/api never happens at module-load time.
+// ── No-op implementations ─────────────────────────────────────────────────────
+const NOOP_COUNTER = { add: () => { } };
+const NOOP_UPDOWN = { add: () => { } };
+export function createNoopMetrics() {
+    return {
+        requestRate: NOOP_COUNTER,
+        activeExchanges: NOOP_UPDOWN,
+        observeRegistrations: NOOP_UPDOWN,
+        blockTransferComplete: NOOP_COUNTER,
+        blockTransferAborted: NOOP_COUNTER,
+        dedupHits: NOOP_COUNTER,
+        transportErrors: NOOP_COUNTER,
+    };
+}
+// ── bindOtel — synchronous, caller supplies the Meter ────────────────────────
+export function bindOtel(meter) {
+    return {
+        requestRate: meter.createCounter('coap.requests', {
+            description: 'Number of incoming CoAP requests',
+            unit: '{request}',
+        }),
+        activeExchanges: meter.createUpDownCounter('coap.exchanges.active', {
+            description: 'Number of currently in-flight CoAP exchanges',
+            unit: '{exchange}',
+        }),
+        observeRegistrations: meter.createUpDownCounter('coap.observe.registrations', {
+            description: 'Number of active Observe registrations',
+            unit: '{registration}',
+        }),
+        blockTransferComplete: meter.createCounter('coap.block.complete', {
+            description: 'Number of successfully completed block-wise transfers',
+            unit: '{transfer}',
+        }),
+        blockTransferAborted: meter.createCounter('coap.block.aborted', {
+            description: 'Number of aborted block-wise transfers',
+            unit: '{transfer}',
+        }),
+        dedupHits: meter.createCounter('coap.dedup.hits', {
+            description: 'Number of CON retransmissions that were served from the dedup store',
+            unit: '{hit}',
+        }),
+        transportErrors: meter.createCounter('coap.transport.errors', {
+            description: 'Number of transport-level errors (decode failures, socket errors)',
+            unit: '{error}',
+        }),
+    };
+}
+// ── tryBindOtel — lazy import, falls back to no-ops ──────────────────────────
+export async function tryBindOtel(meterName) {
+    try {
+        // Dynamic import kept as a string expression so the TypeScript compiler does
+        // not chase the type declaration of the optional peer dep.
+        const specifier = '@opentelemetry/api';
+        // eslint-disable-next-line @typescript-eslint/no-implied-eval
+        const api = await (new Function('s', 'return import(s)')(specifier));
+        const meter = api.metrics.getMeter(meterName);
+        return bindOtel(meter);
+    }
+    catch {
+        // @opentelemetry/api not installed — return zero-cost no-ops.
+        return createNoopMetrics();
+    }
+}
+//# sourceMappingURL=observability.js.map

package/dist/observability.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability.js","sourceRoot":"","sources":["../src/observability.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,EAAE;AACF,8CAA8C;AAC9C,+EAA+E;AAC/E,oFAAoF;AACpF,EAAE;AACF,kEAAkE;AA+BlE,iFAAiF;AAEjF,MAAM,YAAY,GAAY,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;AAChD,MAAM,WAAW,GAAkB,EAAE,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC,EAAE,CAAC;AAErD,MAAM,UAAU,iBAAiB;IAC/B,OAAO;QACL,WAAW,EAAW,YAAY;QAClC,eAAe,EAAO,WAAW;QACjC,oBAAoB,EAAE,WAAW;QACjC,qBAAqB,EAAE,YAAY;QACnC,oBAAoB,EAAG,YAAY;QACnC,SAAS,EAAa,YAAY;QAClC,eAAe,EAAO,YAAY;KACnC,CAAC;AACJ,CAAC;AAUD,gFAAgF;AAEhF,MAAM,UAAU,QAAQ,CAAC,KAAgB;IACvC,OAAO;QACL,WAAW,EAAE,KAAK,CAAC,aAAa,CAAC,eAAe,EAAE;YAChD,WAAW,EAAE,kCAAkC;YAC/C,IAAI,EAAE,WAAW;SAClB,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,mBAAmB,CAAC,uBAAuB,EAAE;YAClE,WAAW,EAAE,8CAA8C;YAC3D,IAAI,EAAE,YAAY;SACnB,CAAC;QACF,oBAAoB,EAAE,KAAK,CAAC,mBAAmB,CAAC,4BAA4B,EAAE;YAC5E,WAAW,EAAE,wCAAwC;YACrD,IAAI,EAAE,gBAAgB;SACvB,CAAC;QACF,qBAAqB,EAAE,KAAK,CAAC,aAAa,CAAC,qBAAqB,EAAE;YAChE,WAAW,EAAE,uDAAuD;YACpE,IAAI,EAAE,YAAY;SACnB,CAAC;QACF,oBAAoB,EAAE,KAAK,CAAC,aAAa,CAAC,oBAAoB,EAAE;YAC9D,WAAW,EAAE,wCAAwC;YACrD,IAAI,EAAE,YAAY;SACnB,CAAC;QACF,SAAS,EAAE,KAAK,CAAC,aAAa,CAAC,iBAAiB,EAAE;YAChD,WAAW,EAAE,qEAAqE;YAClF,IAAI,EAAE,OAAO;SACd,CAAC;QACF,eAAe,EAAE,KAAK,CAAC,aAAa,CAAC,uBAAuB,EAAE;YAC5D,WAAW,EAAE,mEAAmE;YAChF,IAAI,EAAE,SAAS;SAChB,CAAC;KACH,CAAC;AACJ,CAAC;AAED,gFAAgF;AAEhF,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,SAAiB;IACjD,IAAI,CAAC;QACH,6EAA6E;QAC7E,2DAA2D;QAC3D,MAAM,SAAS,GAAG,oBAAoB,CAAC;QACvC,8DAA8D;QAC9D,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,QAAQ,CAAC,GAAG,EAAE,kBAAkB,CAAC,CAAC,SAAS,CAAC,CAElE,CAAC;QACF,MAAM,KAAK,GAAc,GAAG,CAAC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACzD,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACP,8DAA8D;QAC9D,OAAO,iBAAiB,EAAE,CAAC;IAC7B,CAAC;AACH,CAAC"}

package/dist/observe-notification.d.ts

@@ -0,0 +1,21 @@
+import type { Observable } from './observe.js';
+export declare const MAX_OBSERVE_SEQ = 16777215;
+export interface NotificationLoopOptions {
+    initialSeq?: number;
+}
+export declare class NotificationLoop {
+    private seq;
+    constructor(opts?: NotificationLoopOptions);
+    nextSeq(): number;
+}
+export interface ActiveObserveOptions {
+    notifyEveryValue?: boolean;
+}
+export interface NotificationSender {
+    (seq: number, payload: Uint8Array): void;
+}
+export declare function startNotificationLoop(observable: Observable<unknown>, encodeValue: (value: unknown) => Uint8Array, send: NotificationSender, onCancel: () => void, opts?: ActiveObserveOptions): {
+    ackReceived(): void;
+    cancel(): void;
+};
+//# sourceMappingURL=observe-notification.d.ts.map

package/dist/observe-notification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observe-notification.d.ts","sourceRoot":"","sources":["../src/observe-notification.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AAE5D,eAAO,MAAM,eAAe,WAAW,CAAC;AAExC,MAAM,WAAW,uBAAuB;IACtC,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAGD,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,GAAG,CAAS;gBAER,IAAI,GAAE,uBAA4B;IAK9C,OAAO,IAAI,MAAM;CAKlB;AAED,MAAM,WAAW,oBAAoB;IACnC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1C;AAcD,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,UAAU,CAAC,OAAO,CAAC,EAC/B,WAAW,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,UAAU,EAC3C,IAAI,EAAE,kBAAkB,EACxB,QAAQ,EAAE,MAAM,IAAI,EACpB,IAAI,GAAE,oBAAyB,GAC9B;IAAE,WAAW,IAAI,IAAI,CAAC;IAAC,MAAM,IAAI,IAAI,CAAA;CAAE,CAuEzC"}

package/dist/observe-notification.js

@@ -0,0 +1,87 @@
+// RFC 7641 §4: Observe notification delivery with sequence-number management and conflation
+export const MAX_OBSERVE_SEQ = 0xffffff; // 2^24 - 1
+// Exported for unit-testability of the sequence-number logic
+export class NotificationLoop {
+    seq;
+    constructor(opts = {}) {
+        // initialSeq is the *next* value to return; caller advances from there
+        this.seq = opts.initialSeq ?? 0;
+    }
+    nextSeq() {
+        const current = this.seq;
+        this.seq = current >= MAX_OBSERVE_SEQ ? 0 : current + 1;
+        return current;
+    }
+}
+// Drives the notification loop for one (remote, token) registration.
+// Returns a handle with two methods:
+//   - ackReceived(): call when the remote ACKs the last CON notification
+//   - cancel(): tear down and unsubscribe
+export function startNotificationLoop(observable, encodeValue, send, onCancel, opts = {}) {
+    const notifyEveryValue = opts.notifyEveryValue ?? false;
+    const state = {
+        seq: 1, // 0 was used in the initial ACK
+        pendingAck: false,
+        queued: null,
+        unsub: null,
+        cancelled: false,
+    };
+    function nextSeq() {
+        const s = state.seq;
+        state.seq = s >= MAX_OBSERVE_SEQ ? 0 : s + 1;
+        return s;
+    }
+    function sendNext(payload) {
+        state.pendingAck = true;
+        state.queued = null;
+        send(nextSeq(), payload);
+    }
+    function teardown() {
+        if (state.cancelled)
+            return;
+        state.cancelled = true;
+        if (state.unsub) {
+            state.unsub();
+            state.unsub = null;
+        }
+        onCancel();
+    }
+    state.unsub = observable.subscribe({
+        next(value) {
+            if (state.cancelled)
+                return;
+            const payload = encodeValue(value);
+            if (notifyEveryValue) {
+                sendNext(payload);
+                return;
+            }
+            if (state.pendingAck) {
+                // Conflation: replace queued value with latest
+                state.queued = payload;
+                return;
+            }
+            sendNext(payload);
+        },
+        complete() {
+            teardown();
+        },
+        error(_err) {
+            teardown();
+        },
+    });
+    return {
+        ackReceived() {
+            if (state.cancelled || !state.pendingAck)
+                return;
+            state.pendingAck = false;
+            if (state.queued !== null) {
+                const payload = state.queued;
+                sendNext(payload);
+            }
+        },
+        cancel() {
+            teardown();
+        },
+    };
+}
+//# sourceMappingURL=observe-notification.js.map

package/dist/observe-notification.js.map

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

package/dist/observe.d.ts

@@ -0,0 +1,10 @@
+export type Unsubscribe = () => void;
+export interface Observer<T> {
+    next(value: T): void;
+    error?(err: unknown): void;
+    complete?(): void;
+}
+export interface Observable<T> {
+    subscribe(observer: Observer<T>): Unsubscribe;
+}
+//# sourceMappingURL=observe.d.ts.map