@nmtjs/msgpack-format 0.15.0-beta.24 → 0.15.0-beta.26

package/dist/client.d.ts

@@ -0,0 +1,17 @@
+import type { DecodeRPCContext } from '@nmtjs/protocol';
+import type { EncodeRPCContext, ProtocolClientBlobStream, ProtocolServerBlobStream } from '@nmtjs/protocol/client';
+import { BaseClientFormat } from '@nmtjs/protocol/client';
+/**
+ * MessagePack encoding format with support for Neemata streams.
+ * Uses extension types to embed stream ID + metadata directly,
+ * eliminating the need for separate stream metadata chunks.
+ */
+export declare class MsgpackFormat extends BaseClientFormat {
+    contentType: string;
+    encode(data: any): Uint8Array;
+    encodeRPC(data: unknown, context: EncodeRPCContext<ProtocolClientBlobStream>): Uint8Array<ArrayBuffer>;
+    decode(data: ArrayBufferView): any;
+    decodeRPC(buffer: ArrayBufferView, context: DecodeRPCContext<(options?: {
+        signal?: AbortSignal;
+    }) => ProtocolServerBlobStream>): unknown;
+}

package/dist/client.js

@@ -0,0 +1,51 @@
+import { decode, encode } from '@msgpack/msgpack';
+import { ProtocolBlob } from '@nmtjs/protocol';
+import { BaseClientFormat } from '@nmtjs/protocol/client';
+import { decodeStreamExt, encodeStreamExt, extensionCodec } from './common.js';
+/**
+ * MessagePack encoding format with support for Neemata streams.
+ * Uses extension types to embed stream ID + metadata directly,
+ * eliminating the need for separate stream metadata chunks.
+ */
+export class MsgpackFormat extends BaseClientFormat {
+    contentType = 'application/msgpack';
+    encode(data) {
+        return encode(data, { ignoreUndefined: true });
+    }
+    encodeRPC(data, context) {
+        if (typeof data === 'undefined') {
+            return new Uint8Array(0);
+        }
+        return encode(data, {
+            extensionCodec,
+            ignoreUndefined: true,
+            context: {
+                encodeStream: (object) => {
+                    if (object instanceof ProtocolBlob) {
+                        const stream = context.addStream(object);
+                        return encodeStreamExt(stream.id, stream.metadata);
+                    }
+                    return null;
+                },
+            },
+        });
+    }
+    decode(data) {
+        return decode(data);
+    }
+    decodeRPC(buffer, context) {
+        if (buffer.byteLength === 0) {
+            return undefined;
+        }
+        return decode(buffer, {
+            extensionCodec,
+            context: {
+                decodeStream: (data) => {
+                    const { id, metadata } = decodeStreamExt(data);
+                    return context.addStream(id, metadata);
+                },
+            },
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE9E;;;;GAIG;AACH,MAAM,OAAO,aAAc,SAAQ,gBAAgB;IACjD,WAAW,GAAG,qBAAqB,CAAA;IAEnC,MAAM,CAAC,IAAS,EAAc;QAC5B,OAAO,MAAM,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAA;IAAA,CAC/C;IAED,SAAS,CACP,IAAa,EACb,OAAmD,EACnD;QACA,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAA;QAC1B,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,EAAE;YAClB,cAAc;YACd,eAAe,EAAE,IAAI;YACrB,OAAO,EAAE;gBACP,YAAY,EAAE,CAAC,MAAe,EAAqB,EAAE,CAAC;oBACpD,IAAI,MAAM,YAAY,YAAY,EAAE,CAAC;wBACnC,MAAM,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;wBACxC,OAAO,eAAe,CAAC,MAAM,CAAC,EAAE,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;oBACpD,CAAC;oBACD,OAAO,IAAI,CAAA;gBAAA,CACZ;aACF;SACF,CAAC,CAAA;IAAA,CACH;IAED,MAAM,CAAC,IAAqB,EAAO;QACjC,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;IAAA,CACpB;IAED,SAAS,CACP,MAAuB,EACvB,OAEC,EACD;QACA,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,EAAE;YACpB,cAAc;YACd,OAAO,EAAE;gBACP,YAAY,EAAE,CAAC,IAAgB,EAAE,EAAE,CAAC;oBAClC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;oBAC9C,OAAO,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;gBAAA,CACvC;aACF;SACF,CAAC,CAAA;IAAA,CACH;CACF"}

package/dist/common.d.ts

@@ -0,0 +1,13 @@
+import type { ProtocolBlobMetadata } from '@nmtjs/protocol';
+import { ExtensionCodec } from '@msgpack/msgpack';
+export declare const STREAM_EXT_TYPE = 1;
+export declare const encodeStreamExt: (id: number, metadata: ProtocolBlobMetadata) => Uint8Array<ArrayBufferLike>;
+export declare const decodeStreamExt: (data: Uint8Array<ArrayBufferLike>) => {
+    id: number;
+    metadata: ProtocolBlobMetadata;
+};
+export type MsgpackContext = {
+    encodeStream?: (object: unknown) => Uint8Array | null;
+    decodeStream?: (data: Uint8Array) => unknown;
+};
+export declare const extensionCodec: ExtensionCodec<MsgpackContext>;

package/dist/common.js

@@ -0,0 +1,33 @@
+import { decode, ExtensionCodec, encode } from '@msgpack/msgpack';
+// Extension type code for blob streams
+export const STREAM_EXT_TYPE = 0x01;
+// Encodes stream ID + metadata into extension type payload
+export const encodeStreamExt = (id, metadata) => {
+    // Format: [id: u32 BE][metadata: msgpack]
+    const metadataBuffer = encode(metadata);
+    const buffer = new Uint8Array(4 + metadataBuffer.byteLength);
+    const view = new DataView(buffer.buffer);
+    view.setUint32(0, id, false); // big-endian
+    buffer.set(metadataBuffer, 4);
+    return buffer;
+};
+// Decodes stream ID + metadata from extension type payload
+export const decodeStreamExt = (data) => {
+    const view = new DataView(data.buffer, data.byteOffset, data.byteLength);
+    const id = view.getUint32(0, false);
+    const metadata = decode(data.subarray(4));
+    return { id, metadata };
+};
+// Shared extension codec - reused across all encode/decode operations
+// Uses msgpack's context feature to pass dynamic encode/decode handlers
+export const extensionCodec = new ExtensionCodec();
+extensionCodec.register({
+    type: STREAM_EXT_TYPE,
+    encode: (object, context) => {
+        return context.encodeStream(object) ?? null;
+    },
+    decode: (data, _extType, context) => {
+        return context.decodeStream(data);
+    },
+});
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AAEjE,uCAAuC;AACvC,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,CAAA;AAEnC,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,EAAU,EACV,QAA8B,EAClB,EAAE,CAAC;IACf,0CAA0C;IAC1C,MAAM,cAAc,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IACvC,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,GAAG,cAAc,CAAC,UAAU,CAAC,CAAA;IAC5D,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,CAAA;IACxC,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,EAAE,KAAK,CAAC,CAAA,CAAC,aAAa;IAC1C,MAAM,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC,CAAC,CAAA;IAC7B,OAAO,MAAM,CAAA;AAAA,CACd,CAAA;AAED,2DAA2D;AAC3D,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,IAAgB,EACgC,EAAE,CAAC;IACnD,MAAM,IAAI,GAAG,IAAI,QAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;IACxE,MAAM,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;IACnC,MAAM,QAAQ,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAyB,CAAA;IACjE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,CAAA;AAAA,CACxB,CAAA;AAQD,sEAAsE;AACtE,wEAAwE;AACxE,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,cAAc,EAAkB,CAAA;AAElE,cAAc,CAAC,QAAQ,CAAC;IACtB,IAAI,EAAE,eAAe;IACrB,MAAM,EAAE,CAAC,MAAe,EAAE,OAAuB,EAAqB,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC,YAAa,CAAC,MAAM,CAAC,IAAI,IAAI,CAAA;IAAA,CAC7C;IACD,MAAM,EAAE,CAAC,IAAgB,EAAE,QAAgB,EAAE,OAAuB,EAAE,EAAE,CAAC;QACvE,OAAO,OAAO,CAAC,YAAa,CAAC,IAAI,CAAC,CAAA;IAAA,CACnC;CACF,CAAC,CAAA"}

package/dist/server.d.ts

@@ -0,0 +1,26 @@
+import type { DecodeRPCContext, EncodeRPCStreams } from '@nmtjs/protocol';
+import type { ProtocolClientStream } from '@nmtjs/protocol/server';
+import { BaseServerFormat } from '@nmtjs/protocol/server';
+declare class StreamIdMarker {
+    readonly streamId: number;
+    readonly metadata: {
+        type: string;
+        size?: number;
+        filename?: string;
+    };
+    constructor(streamId: number, metadata: {
+        type: string;
+        size?: number;
+        filename?: string;
+    });
+}
+export declare class MsgpackFormat extends BaseServerFormat {
+    contentType: string;
+    accept: string[];
+    encode(data: any): Buffer<ArrayBuffer>;
+    encodeBlob(streamId: number, metadata: EncodeRPCStreams[number]): StreamIdMarker;
+    encodeRPC(data: unknown, _streams: EncodeRPCStreams): Buffer<ArrayBuffer>;
+    decode(data: Buffer): unknown;
+    decodeRPC(buffer: Buffer, context: DecodeRPCContext<() => ProtocolClientStream>): unknown;
+}
+export {};

package/dist/server.js

@@ -0,0 +1,66 @@
+import { decode, encode } from '@msgpack/msgpack';
+import { ProtocolBlob } from '@nmtjs/protocol';
+import { BaseServerFormat } from '@nmtjs/protocol/server';
+import { decodeStreamExt, encodeStreamExt, extensionCodec } from './common.js';
+// Marker class for stream IDs (used internally for msgpack extension encoding)
+class StreamIdMarker {
+    streamId;
+    metadata;
+    constructor(streamId, metadata) {
+        this.streamId = streamId;
+        this.metadata = metadata;
+    }
+}
+export class MsgpackFormat extends BaseServerFormat {
+    contentType = 'application/msgpack';
+    accept = ['application/msgpack'];
+    encode(data) {
+        return typeof data !== 'undefined'
+            ? Buffer.from(encode(data, { ignoreUndefined: true }))
+            : Buffer.alloc(0);
+    }
+    encodeBlob(streamId, metadata) {
+        return new StreamIdMarker(streamId, metadata);
+    }
+    encodeRPC(data, _streams) {
+        if (typeof data === 'undefined') {
+            return Buffer.alloc(0);
+        }
+        return Buffer.from(encode(data, {
+            extensionCodec,
+            ignoreUndefined: true,
+            context: {
+                encodeStream: (object) => {
+                    if (object instanceof StreamIdMarker) {
+                        return encodeStreamExt(object.streamId, object.metadata);
+                    }
+                    if (object instanceof ProtocolBlob && object.encode) {
+                        const marker = object.encode(object.metadata);
+                        if (marker instanceof StreamIdMarker) {
+                            return encodeStreamExt(marker.streamId, marker.metadata);
+                        }
+                    }
+                    return null;
+                },
+            },
+        }));
+    }
+    decode(data) {
+        return decode(data);
+    }
+    decodeRPC(buffer, context) {
+        if (buffer.byteLength === 0) {
+            return undefined;
+        }
+        return decode(buffer, {
+            extensionCodec,
+            context: {
+                decodeStream: (data) => {
+                    const { id, metadata } = decodeStreamExt(data);
+                    return context.addStream(id, metadata);
+                },
+            },
+        });
+    }
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAA;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAA;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAA;AAEzD,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,aAAa,CAAA;AAE9E,+EAA+E;AAC/E,MAAM,cAAc;IAEA,QAAQ;IACR,QAAQ;IAF1B,YACkB,QAAgB,EAChB,QAIf,EACD;wBANgB,QAAQ;wBACR,QAAQ;IAKvB,CAAC;CACL;AAED,MAAM,OAAO,aAAc,SAAQ,gBAAgB;IACjD,WAAW,GAAG,qBAAqB,CAAA;IACnC,MAAM,GAAG,CAAC,qBAAqB,CAAC,CAAA;IAEhC,MAAM,CAAC,IAAS,EAAE;QAChB,OAAO,OAAO,IAAI,KAAK,WAAW;YAChC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,EAAE,eAAe,EAAE,IAAI,EAAE,CAAC,CAAC;YACtD,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;IAAA,CACpB;IAED,UAAU,CAAC,QAAgB,EAAE,QAAkC,EAAE;QAC/D,OAAO,IAAI,cAAc,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAA;IAAA,CAC9C;IAED,SAAS,CAAC,IAAa,EAAE,QAA0B,EAAE;QACnD,IAAI,OAAO,IAAI,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACxB,CAAC;QAED,OAAO,MAAM,CAAC,IAAI,CAChB,MAAM,CAAC,IAAI,EAAE;YACX,cAAc;YACd,eAAe,EAAE,IAAI;YACrB,OAAO,EAAE;gBACP,YAAY,EAAE,CAAC,MAAe,EAAqB,EAAE,CAAC;oBACpD,IAAI,MAAM,YAAY,cAAc,EAAE,CAAC;wBACrC,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;oBAC1D,CAAC;oBACD,IAAI,MAAM,YAAY,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;wBACpD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAmB,CAAA;wBAC/D,IAAI,MAAM,YAAY,cAAc,EAAE,CAAC;4BACrC,OAAO,eAAe,CAAC,MAAM,CAAC,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAA;wBAC1D,CAAC;oBACH,CAAC;oBACD,OAAO,IAAI,CAAA;gBAAA,CACZ;aACF;SACF,CAAC,CACH,CAAA;IAAA,CACF;IAED,MAAM,CAAC,IAAY,EAAE;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC,CAAA;IAAA,CACpB;IAED,SAAS,CACP,MAAc,EACd,OAAqD,EACrD;QACA,IAAI,MAAM,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YAC5B,OAAO,SAAS,CAAA;QAClB,CAAC;QAED,OAAO,MAAM,CAAC,MAAM,EAAE;YACpB,cAAc;YACd,OAAO,EAAE;gBACP,YAAY,EAAE,CAAC,IAAgB,EAAE,EAAE,CAAC;oBAClC,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,GAAG,eAAe,CAAC,IAAI,CAAC,CAAA;oBAC9C,OAAO,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,QAAQ,CAAC,CAAA;gBAAA,CACvC;aACF;SACF,CAAC,CAAA;IAAA,CACH;CACF"}

package/package.json

@@ -7,12 +7,12 @@
   },
   "dependencies": {
     "@msgpack/msgpack": "^3.1.3",
-    "@nmtjs/common": "0.15.0-beta.24",
-    "@nmtjs/protocol": "0.15.0-beta.24"
+    "@nmtjs/common": "0.15.0-beta.26",
+    "@nmtjs/protocol": "0.15.0-beta.26"
   },
   "peerDependencies": {
-    "@nmtjs/protocol": "0.15.0-beta.24",
-    "@nmtjs/common": "0.15.0-beta.24"
+    "@nmtjs/common": "0.15.0-beta.26",
+    "@nmtjs/protocol": "0.15.0-beta.26"
   },
   "files": [
     "dist",
@@ -20,7 +20,7 @@
     "LICENSE.md",
     "README.md"
   ],
-  "version": "0.15.0-beta.24",
+  "version": "0.15.0-beta.26",
   "scripts": {
     "clean-build": "rm -rf ./dist"
   }