@nmtjs/json-format 0.0.1

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright (c) 2024 Denis Ilchyshyn
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1 @@
+## JSON format for [Neemata](https://github.com/neematajs/neemata)

package/dist/client.js

@@ -0,0 +1,81 @@
+import { ApiBlob, BaseClientFormat, decodeText, encodeText } from '@nmtjs/common';
+import { deserializeStreamId, isStreamId, serializeStreamId } from "./common.js";
+export class JsonFormat extends BaseClientFormat {
+    contentType = 'application/x-neemata-json';
+    encode(data) {
+        return encodeText(JSON.stringify(data));
+    }
+    encodeRpc(rpc, context) {
+        const { callId, service, procedure } = rpc;
+        const streams = {};
+        const replacer = (key, value)=>{
+            if (value instanceof ApiBlob) {
+                const stream = context.addStream(value);
+                streams[stream.id] = stream.metadata;
+                return serializeStreamId(stream.id);
+            }
+            return value;
+        };
+        const payload = JSON.stringify(rpc.payload, replacer);
+        return this.encode([
+            callId,
+            service,
+            procedure,
+            streams,
+            payload
+        ]);
+    }
+    decode(data) {
+        return JSON.parse(decodeText(data));
+    }
+    decodeRpc(buffer, context) {
+        const [callId, error, streams, formatPayload] = this.decode(buffer);
+        if (error) return {
+            callId,
+            error,
+            payload: null
+        };
+        else {
+            const replacer = (key, value)=>{
+                if (typeof value === 'string' && isStreamId(value)) {
+                    const id = deserializeStreamId(value);
+                    const metadata = streams[id];
+                    return context.addStream(id, metadata);
+                }
+                return value;
+            };
+            const payload = formatPayload ? JSON.parse(formatPayload, replacer) : null;
+            return {
+                callId,
+                error: null,
+                payload
+            };
+        }
+    }
+}
+export class StandardJsonFormat extends BaseClientFormat {
+    contentType = 'application/json';
+    encode(data) {
+        return encodeText(JSON.stringify(data));
+    }
+    encodeRpc(rpc) {
+        const { callId, service, procedure, payload } = rpc;
+        return this.encode([
+            callId,
+            service,
+            procedure,
+            payload
+        ]);
+    }
+    decode(data) {
+        return JSON.parse(decodeText(data));
+    }
+    decodeRpc(buffer) {
+        const [callId, error, payload] = this.decode(buffer);
+        return {
+            callId,
+            error,
+            payload
+        };
+    }
+}

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client.ts"],"sourcesContent":["import {\n  ApiBlob,\n  type ApiBlobMetadata,\n  BaseClientFormat,\n  type DecodeRpcContext,\n  type EncodeRpcContext,\n  type Rpc,\n  decodeText,\n  encodeText,\n} from '@nmtjs/common'\nimport { deserializeStreamId, isStreamId, serializeStreamId } from './common.ts'\n\n/**\n * Custom JSON encoding format with support for Neemata streams.\n */\nexport class JsonFormat extends BaseClientFormat {\n  contentType = 'application/x-neemata-json'\n\n  encode(data: any): ArrayBuffer {\n    return encodeText(JSON.stringify(data))\n  }\n\n  encodeRpc(rpc: Rpc, context: EncodeRpcContext): ArrayBuffer {\n    const { callId, service, procedure } = rpc\n    const streams: Record<number, ApiBlobMetadata> = {}\n    const replacer = (key: string, value: any) => {\n      if (value instanceof ApiBlob) {\n        const stream = context.addStream(value)\n        streams[stream.id] = stream.metadata\n        return serializeStreamId(stream.id)\n      }\n      return value\n    }\n    const payload = JSON.stringify(rpc.payload, replacer)\n    return this.encode([callId, service, procedure, streams, payload])\n  }\n\n  decode(data: ArrayBuffer): any {\n    return JSON.parse(decodeText(data))\n  }\n\n  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext) {\n    const [callId, error, streams, formatPayload] = this.decode(buffer)\n    if (error) return { callId, error, payload: null }\n    else {\n      const replacer = (key: string, value: any) => {\n        if (typeof value === 'string' && isStreamId(value)) {\n          const id = deserializeStreamId(value)\n          const metadata = streams[id]\n          return context.addStream(id, metadata)\n        }\n        return value\n      }\n      const payload = formatPayload ? JSON.parse(formatPayload, replacer) : null\n      return { callId, error: null, payload }\n    }\n  }\n}\n\n/**\n * Standard JSON encoding format with no Neemata streams support.\n */\nexport class StandardJsonFormat extends BaseClientFormat {\n  contentType = 'application/json'\n\n  encode(data: any) {\n    return encodeText(JSON.stringify(data))\n  }\n\n  encodeRpc(rpc: Rpc) {\n    const { callId, service, procedure, payload } = rpc\n    return this.encode([callId, service, procedure, payload])\n  }\n\n  decode(data: ArrayBuffer) {\n    return JSON.parse(decodeText(data))\n  }\n\n  decodeRpc(buffer: ArrayBuffer) {\n    const [callId, error, payload] = this.decode(buffer)\n    return { callId, error, payload }\n  }\n}\n"],"names":["ApiBlob","BaseClientFormat","decodeText","encodeText","deserializeStreamId","isStreamId","serializeStreamId","JsonFormat","contentType","encode","data","JSON","stringify","encodeRpc","rpc","context","callId","service","procedure","streams","replacer","key","value","stream","addStream","id","metadata","payload","decode","parse","decodeRpc","buffer","error","formatPayload","StandardJsonFormat"],"mappings":"AAAA,SACEA,OAAO,EAEPC,gBAAgB,EAIhBC,UAAU,EACVC,UAAU,QACL,gBAAe;AACtB,SAASC,mBAAmB,EAAEC,UAAU,EAAEC,iBAAiB,QAAQ,cAAa;AAKhF,OAAO,MAAMC,mBAAmBN;IAC9BO,cAAc,6BAA4B;IAE1CC,OAAOC,IAAS,EAAe;QAC7B,OAAOP,WAAWQ,KAAKC,SAAS,CAACF;IACnC;IAEAG,UAAUC,GAAQ,EAAEC,OAAyB,EAAe;QAC1D,MAAM,EAAEC,MAAM,EAAEC,OAAO,EAAEC,SAAS,EAAE,GAAGJ;QACvC,MAAMK,UAA2C,CAAC;QAClD,MAAMC,WAAW,CAACC,KAAaC;YAC7B,IAAIA,iBAAiBtB,SAAS;gBAC5B,MAAMuB,SAASR,QAAQS,SAAS,CAACF;gBACjCH,OAAO,CAACI,OAAOE,EAAE,CAAC,GAAGF,OAAOG,QAAQ;gBACpC,OAAOpB,kBAAkBiB,OAAOE,EAAE;YACpC;YACA,OAAOH;QACT;QACA,MAAMK,UAAUhB,KAAKC,SAAS,CAACE,IAAIa,OAAO,EAAEP;QAC5C,OAAO,IAAI,CAACX,MAAM,CAAC;YAACO;YAAQC;YAASC;YAAWC;YAASQ;SAAQ;IACnE;IAEAC,OAAOlB,IAAiB,EAAO;QAC7B,OAAOC,KAAKkB,KAAK,CAAC3B,WAAWQ;IAC/B;IAEAoB,UAAUC,MAAmB,EAAEhB,OAAyB,EAAE;QACxD,MAAM,CAACC,QAAQgB,OAAOb,SAASc,cAAc,GAAG,IAAI,CAACL,MAAM,CAACG;QAC5D,IAAIC,OAAO,OAAO;YAAEhB;YAAQgB;YAAOL,SAAS;QAAK;aAC5C;YACH,MAAMP,WAAW,CAACC,KAAaC;gBAC7B,IAAI,OAAOA,UAAU,YAAYjB,WAAWiB,QAAQ;oBAClD,MAAMG,KAAKrB,oBAAoBkB;oBAC/B,MAAMI,WAAWP,OAAO,CAACM,GAAG;oBAC5B,OAAOV,QAAQS,SAAS,CAACC,IAAIC;gBAC/B;gBACA,OAAOJ;YACT;YACA,MAAMK,UAAUM,gBAAgBtB,KAAKkB,KAAK,CAACI,eAAeb,YAAY;YACtE,OAAO;gBAAEJ;gBAAQgB,OAAO;gBAAML;YAAQ;QACxC;IACF;AACF;AAKA,OAAO,MAAMO,2BAA2BjC;IACtCO,cAAc,mBAAkB;IAEhCC,OAAOC,IAAS,EAAE;QAChB,OAAOP,WAAWQ,KAAKC,SAAS,CAACF;IACnC;IAEAG,UAAUC,GAAQ,EAAE;QAClB,MAAM,EAAEE,MAAM,EAAEC,OAAO,EAAEC,SAAS,EAAES,OAAO,EAAE,GAAGb;QAChD,OAAO,IAAI,CAACL,MAAM,CAAC;YAACO;YAAQC;YAASC;YAAWS;SAAQ;IAC1D;IAEAC,OAAOlB,IAAiB,EAAE;QACxB,OAAOC,KAAKkB,KAAK,CAAC3B,WAAWQ;IAC/B;IAEAoB,UAAUC,MAAmB,EAAE;QAC7B,MAAM,CAACf,QAAQgB,OAAOL,QAAQ,GAAG,IAAI,CAACC,MAAM,CAACG;QAC7C,OAAO;YAAEf;YAAQgB;YAAOL;QAAQ;IAClC;AACF"}

package/dist/common.js

@@ -0,0 +1,9 @@
+const STREAM_SERIALIZE_KEY = '%neemata:stream:%\f';
+export const serializeStreamId = (id)=>{
+    return `${STREAM_SERIALIZE_KEY}${id}`;
+};
+export const deserializeStreamId = (value)=>{
+    const streamId = value.slice(STREAM_SERIALIZE_KEY.length);
+    return Number.parseInt(streamId);
+};
+export const isStreamId = (value)=>typeof value === 'string' && value.length && value.startsWith(STREAM_SERIALIZE_KEY);

package/dist/common.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/common.ts"],"sourcesContent":["// TODO: is this a good way to serialize streams within json?\nconst STREAM_SERIALIZE_KEY = '%neemata:stream:%\\f'\n\nexport const serializeStreamId = (id: number) => {\n  return `${STREAM_SERIALIZE_KEY}${id}`\n}\n\nexport const deserializeStreamId = (value: string) => {\n  const streamId = value.slice(STREAM_SERIALIZE_KEY.length)\n  return Number.parseInt(streamId)\n}\n\nexport const isStreamId = (value: any) =>\n  typeof value === 'string' &&\n  value.length &&\n  value.startsWith(STREAM_SERIALIZE_KEY)\n"],"names":["STREAM_SERIALIZE_KEY","serializeStreamId","id","deserializeStreamId","value","streamId","slice","length","Number","parseInt","isStreamId","startsWith"],"mappings":"AACA,MAAMA,uBAAuB;AAE7B,OAAO,MAAMC,oBAAoB,CAACC;IAChC,OAAO,CAAC,EAAEF,qBAAqB,EAAEE,GAAG,CAAC;AACvC,EAAC;AAED,OAAO,MAAMC,sBAAsB,CAACC;IAClC,MAAMC,WAAWD,MAAME,KAAK,CAACN,qBAAqBO,MAAM;IACxD,OAAOC,OAAOC,QAAQ,CAACJ;AACzB,EAAC;AAED,OAAO,MAAMK,aAAa,CAACN,QACzB,OAAOA,UAAU,YACjBA,MAAMG,MAAM,IACZH,MAAMO,UAAU,CAACX,sBAAqB"}

package/dist/server.js

@@ -0,0 +1,95 @@
+import { ApiBlob, BaseServerFormat, decodeText, encodeText } from '@nmtjs/common';
+import { deserializeStreamId, isStreamId, serializeStreamId } from "./common.js";
+export class JsonFormat extends BaseServerFormat {
+    contentType = 'application/x-neemata-json';
+    accept = [
+        'application/x-neemata-json'
+    ];
+    encode(data) {
+        return encodeText(JSON.stringify(data));
+    }
+    encodeRpc(rpc, context) {
+        const { callId, error } = rpc;
+        if (error) return this.encode([
+            callId,
+            error,
+            null
+        ]);
+        else {
+            const streams = {};
+            const replacer = (key, value)=>{
+                if (value instanceof ApiBlob) {
+                    const stream = context.addStream(value);
+                    streams[stream.id] = stream.metadata;
+                    return serializeStreamId(stream.id);
+                }
+                return value;
+            };
+            const payload = JSON.stringify(rpc.payload, replacer);
+            return this.encode([
+                callId,
+                null,
+                streams,
+                payload
+            ]);
+        }
+    }
+    decode(data) {
+        return JSON.parse(decodeText(data));
+    }
+    decodeRpc(buffer, context) {
+        const [callId, service, procedure, streams, formatPayload] = this.decode(buffer);
+        const replacer = (key, value)=>{
+            if (typeof value === 'string' && isStreamId(value)) {
+                const id = deserializeStreamId(value);
+                const metadata = streams[id];
+                return context.addStream(id, metadata);
+            }
+            return value;
+        };
+        const payload = formatPayload ? JSON.parse(formatPayload, replacer) : null;
+        return {
+            callId,
+            service,
+            procedure,
+            payload
+        };
+    }
+}
+export class StandardJsonFormat extends BaseServerFormat {
+    contentType = 'application/json';
+    accept = [
+        'application/json',
+        'application/vnd.api+json'
+    ];
+    encode(data) {
+        return encodeText(JSON.stringify(data));
+    }
+    encodeRpc(rpc) {
+        const { callId, error } = rpc;
+        if (error) return this.encode([
+            callId,
+            error,
+            null
+        ]);
+        else {
+            return this.encode([
+                callId,
+                null,
+                rpc.payload
+            ]);
+        }
+    }
+    decode(buffer) {
+        return JSON.parse(decodeText(buffer));
+    }
+    decodeRpc(buffer) {
+        const [callId, service, procedure, payload] = this.decode(buffer);
+        return {
+            callId,
+            service,
+            procedure,
+            payload
+        };
+    }
+}

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/server.ts"],"sourcesContent":["import {\n  ApiBlob,\n  BaseServerFormat,\n  type DecodeRpcContext,\n  type EncodeRpcContext,\n  type RpcResponse,\n  decodeText,\n  encodeText,\n} from '@nmtjs/common'\nimport { deserializeStreamId, isStreamId, serializeStreamId } from './common.ts'\n\n/**\n * Custom JSON encoding format with Neemata streams support.\n */\nexport class JsonFormat extends BaseServerFormat {\n  contentType = 'application/x-neemata-json'\n  accept = ['application/x-neemata-json']\n\n  encode(data: any): ArrayBuffer {\n    return encodeText(JSON.stringify(data))\n  }\n\n  encodeRpc(rpc: RpcResponse, context: EncodeRpcContext): ArrayBuffer {\n    const { callId, error } = rpc\n    if (error) return this.encode([callId, error, null])\n    else {\n      const streams: any = {}\n      const replacer = (key: string, value: any) => {\n        if (value instanceof ApiBlob) {\n          const stream = context.addStream(value)\n          streams[stream.id] = stream.metadata\n          return serializeStreamId(stream.id)\n        }\n        return value\n      }\n      const payload = JSON.stringify(rpc.payload, replacer)\n      return this.encode([callId, null, streams, payload])\n    }\n  }\n\n  decode(data: ArrayBuffer): any {\n    return JSON.parse(decodeText(data))\n  }\n\n  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext) {\n    const [callId, service, procedure, streams, formatPayload] =\n      this.decode(buffer)\n\n    const replacer = (key: string, value: any) => {\n      if (typeof value === 'string' && isStreamId(value)) {\n        const id = deserializeStreamId(value)\n        const metadata = streams[id]\n        return context.addStream(id, metadata)\n      }\n      return value\n    }\n\n    const payload = formatPayload ? JSON.parse(formatPayload, replacer) : null\n\n    return {\n      callId,\n      service,\n      procedure,\n      payload,\n    }\n  }\n}\n\n/**\n * Standard JSON encoding format with no Neemata streams support.\n */\nexport class StandardJsonFormat extends BaseServerFormat {\n  contentType = 'application/json'\n  accept = ['application/json', 'application/vnd.api+json']\n\n  encode(data: any) {\n    return encodeText(JSON.stringify(data))\n  }\n\n  encodeRpc(rpc: RpcResponse) {\n    const { callId, error } = rpc\n    if (error) return this.encode([callId, error, null])\n    else {\n      return this.encode([callId, null, rpc.payload])\n    }\n  }\n\n  decode(buffer: ArrayBuffer) {\n    return JSON.parse(decodeText(buffer))\n  }\n\n  decodeRpc(buffer: ArrayBuffer) {\n    const [callId, service, procedure, payload] = this.decode(buffer)\n    return { callId, service, procedure, payload }\n  }\n}\n"],"names":["ApiBlob","BaseServerFormat","decodeText","encodeText","deserializeStreamId","isStreamId","serializeStreamId","JsonFormat","contentType","accept","encode","data","JSON","stringify","encodeRpc","rpc","context","callId","error","streams","replacer","key","value","stream","addStream","id","metadata","payload","decode","parse","decodeRpc","buffer","service","procedure","formatPayload","StandardJsonFormat"],"mappings":"AAAA,SACEA,OAAO,EACPC,gBAAgB,EAIhBC,UAAU,EACVC,UAAU,QACL,gBAAe;AACtB,SAASC,mBAAmB,EAAEC,UAAU,EAAEC,iBAAiB,QAAQ,cAAa;AAKhF,OAAO,MAAMC,mBAAmBN;IAC9BO,cAAc,6BAA4B;IAC1CC,SAAS;QAAC;KAA6B,CAAA;IAEvCC,OAAOC,IAAS,EAAe;QAC7B,OAAOR,WAAWS,KAAKC,SAAS,CAACF;IACnC;IAEAG,UAAUC,GAAgB,EAAEC,OAAyB,EAAe;QAClE,MAAM,EAAEC,MAAM,EAAEC,KAAK,EAAE,GAAGH;QAC1B,IAAIG,OAAO,OAAO,IAAI,CAACR,MAAM,CAAC;YAACO;YAAQC;YAAO;SAAK;aAC9C;YACH,MAAMC,UAAe,CAAC;YACtB,MAAMC,WAAW,CAACC,KAAaC;gBAC7B,IAAIA,iBAAiBtB,SAAS;oBAC5B,MAAMuB,SAASP,QAAQQ,SAAS,CAACF;oBACjCH,OAAO,CAACI,OAAOE,EAAE,CAAC,GAAGF,OAAOG,QAAQ;oBACpC,OAAOpB,kBAAkBiB,OAAOE,EAAE;gBACpC;gBACA,OAAOH;YACT;YACA,MAAMK,UAAUf,KAAKC,SAAS,CAACE,IAAIY,OAAO,EAAEP;YAC5C,OAAO,IAAI,CAACV,MAAM,CAAC;gBAACO;gBAAQ;gBAAME;gBAASQ;aAAQ;QACrD;IACF;IAEAC,OAAOjB,IAAiB,EAAO;QAC7B,OAAOC,KAAKiB,KAAK,CAAC3B,WAAWS;IAC/B;IAEAmB,UAAUC,MAAmB,EAAEf,OAAyB,EAAE;QACxD,MAAM,CAACC,QAAQe,SAASC,WAAWd,SAASe,cAAc,GACxD,IAAI,CAACN,MAAM,CAACG;QAEd,MAAMX,WAAW,CAACC,KAAaC;YAC7B,IAAI,OAAOA,UAAU,YAAYjB,WAAWiB,QAAQ;gBAClD,MAAMG,KAAKrB,oBAAoBkB;gBAC/B,MAAMI,WAAWP,OAAO,CAACM,GAAG;gBAC5B,OAAOT,QAAQQ,SAAS,CAACC,IAAIC;YAC/B;YACA,OAAOJ;QACT;QAEA,MAAMK,UAAUO,gBAAgBtB,KAAKiB,KAAK,CAACK,eAAed,YAAY;QAEtE,OAAO;YACLH;YACAe;YACAC;YACAN;QACF;IACF;AACF;AAKA,OAAO,MAAMQ,2BAA2BlC;IACtCO,cAAc,mBAAkB;IAChCC,SAAS;QAAC;QAAoB;KAA2B,CAAA;IAEzDC,OAAOC,IAAS,EAAE;QAChB,OAAOR,WAAWS,KAAKC,SAAS,CAACF;IACnC;IAEAG,UAAUC,GAAgB,EAAE;QAC1B,MAAM,EAAEE,MAAM,EAAEC,KAAK,EAAE,GAAGH;QAC1B,IAAIG,OAAO,OAAO,IAAI,CAACR,MAAM,CAAC;YAACO;YAAQC;YAAO;SAAK;aAC9C;YACH,OAAO,IAAI,CAACR,MAAM,CAAC;gBAACO;gBAAQ;gBAAMF,IAAIY,OAAO;aAAC;QAChD;IACF;IAEAC,OAAOG,MAAmB,EAAE;QAC1B,OAAOnB,KAAKiB,KAAK,CAAC3B,WAAW6B;IAC/B;IAEAD,UAAUC,MAAmB,EAAE;QAC7B,MAAM,CAACd,QAAQe,SAASC,WAAWN,QAAQ,GAAG,IAAI,CAACC,MAAM,CAACG;QAC1D,OAAO;YAAEd;YAAQe;YAASC;YAAWN;QAAQ;IAC/C;AACF"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@nmtjs/json-format",
+  "type": "module",
+  "exports": {
+    "./client": {
+      "bun": "./src/client.ts",
+      "default": "./dist/client.js",
+      "types": "./src/client.ts"
+    },
+    "./server": {
+      "bun": "./src/server.ts",
+      "default": "./dist/server.js",
+      "types": "./src/server.ts"
+    }
+  },
+  "peerDependencies": {
+    "@nmtjs/common": "^0.0.1"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^1.8.3",
+    "@nmtjs/builder": "github:neematajs/builder#a9139aa321ebf2054ce2f7d26e40a346338be149",
+    "@nmtjs/common": "^0.0.1",
+    "husky": "^9.1.1",
+    "typescript": "^5.5.3",
+    "vitest": "^2.0.3"
+  },
+  "files": [
+    "src",
+    "dist",
+    "tsconfig.json",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "version": "0.0.1",
+  "scripts": {
+    "build": "neemata-build --root=./src './**/*.ts'",
+    "clean": "rm -rf dist node_modules && pnpm -r exec rm -rf dist node_modules",
+    "test": "vitest run --passWithNoTests",
+    "test:watch": "vitest watch",
+    "check:type": "tsc --noEmit",
+    "check:lint": "biome lint .",
+    "check:fmt": "biome format .",
+    "check": "pnpm run check:fmt && pnpm run check:lint && pnpm run check:type",
+    "fmt": "biome check --write ."
+  }
+}

package/src/client.ts

@@ -0,0 +1,83 @@
+import {
+  ApiBlob,
+  type ApiBlobMetadata,
+  BaseClientFormat,
+  type DecodeRpcContext,
+  type EncodeRpcContext,
+  type Rpc,
+  decodeText,
+  encodeText,
+} from '@nmtjs/common'
+import { deserializeStreamId, isStreamId, serializeStreamId } from './common.ts'
+
+/**
+ * Custom JSON encoding format with support for Neemata streams.
+ */
+export class JsonFormat extends BaseClientFormat {
+  contentType = 'application/x-neemata-json'
+
+  encode(data: any): ArrayBuffer {
+    return encodeText(JSON.stringify(data))
+  }
+
+  encodeRpc(rpc: Rpc, context: EncodeRpcContext): ArrayBuffer {
+    const { callId, service, procedure } = rpc
+    const streams: Record<number, ApiBlobMetadata> = {}
+    const replacer = (key: string, value: any) => {
+      if (value instanceof ApiBlob) {
+        const stream = context.addStream(value)
+        streams[stream.id] = stream.metadata
+        return serializeStreamId(stream.id)
+      }
+      return value
+    }
+    const payload = JSON.stringify(rpc.payload, replacer)
+    return this.encode([callId, service, procedure, streams, payload])
+  }
+
+  decode(data: ArrayBuffer): any {
+    return JSON.parse(decodeText(data))
+  }
+
+  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext) {
+    const [callId, error, streams, formatPayload] = this.decode(buffer)
+    if (error) return { callId, error, payload: null }
+    else {
+      const replacer = (key: string, value: any) => {
+        if (typeof value === 'string' && isStreamId(value)) {
+          const id = deserializeStreamId(value)
+          const metadata = streams[id]
+          return context.addStream(id, metadata)
+        }
+        return value
+      }
+      const payload = formatPayload ? JSON.parse(formatPayload, replacer) : null
+      return { callId, error: null, payload }
+    }
+  }
+}
+
+/**
+ * Standard JSON encoding format with no Neemata streams support.
+ */
+export class StandardJsonFormat extends BaseClientFormat {
+  contentType = 'application/json'
+
+  encode(data: any) {
+    return encodeText(JSON.stringify(data))
+  }
+
+  encodeRpc(rpc: Rpc) {
+    const { callId, service, procedure, payload } = rpc
+    return this.encode([callId, service, procedure, payload])
+  }
+
+  decode(data: ArrayBuffer) {
+    return JSON.parse(decodeText(data))
+  }
+
+  decodeRpc(buffer: ArrayBuffer) {
+    const [callId, error, payload] = this.decode(buffer)
+    return { callId, error, payload }
+  }
+}

package/src/common.ts

@@ -0,0 +1,16 @@
+// TODO: is this a good way to serialize streams within json?
+const STREAM_SERIALIZE_KEY = '%neemata:stream:%\f'
+
+export const serializeStreamId = (id: number) => {
+  return `${STREAM_SERIALIZE_KEY}${id}`
+}
+
+export const deserializeStreamId = (value: string) => {
+  const streamId = value.slice(STREAM_SERIALIZE_KEY.length)
+  return Number.parseInt(streamId)
+}
+
+export const isStreamId = (value: any) =>
+  typeof value === 'string' &&
+  value.length &&
+  value.startsWith(STREAM_SERIALIZE_KEY)

package/src/server.ts

@@ -0,0 +1,96 @@
+import {
+  ApiBlob,
+  BaseServerFormat,
+  type DecodeRpcContext,
+  type EncodeRpcContext,
+  type RpcResponse,
+  decodeText,
+  encodeText,
+} from '@nmtjs/common'
+import { deserializeStreamId, isStreamId, serializeStreamId } from './common.ts'
+
+/**
+ * Custom JSON encoding format with Neemata streams support.
+ */
+export class JsonFormat extends BaseServerFormat {
+  contentType = 'application/x-neemata-json'
+  accept = ['application/x-neemata-json']
+
+  encode(data: any): ArrayBuffer {
+    return encodeText(JSON.stringify(data))
+  }
+
+  encodeRpc(rpc: RpcResponse, context: EncodeRpcContext): ArrayBuffer {
+    const { callId, error } = rpc
+    if (error) return this.encode([callId, error, null])
+    else {
+      const streams: any = {}
+      const replacer = (key: string, value: any) => {
+        if (value instanceof ApiBlob) {
+          const stream = context.addStream(value)
+          streams[stream.id] = stream.metadata
+          return serializeStreamId(stream.id)
+        }
+        return value
+      }
+      const payload = JSON.stringify(rpc.payload, replacer)
+      return this.encode([callId, null, streams, payload])
+    }
+  }
+
+  decode(data: ArrayBuffer): any {
+    return JSON.parse(decodeText(data))
+  }
+
+  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext) {
+    const [callId, service, procedure, streams, formatPayload] =
+      this.decode(buffer)
+
+    const replacer = (key: string, value: any) => {
+      if (typeof value === 'string' && isStreamId(value)) {
+        const id = deserializeStreamId(value)
+        const metadata = streams[id]
+        return context.addStream(id, metadata)
+      }
+      return value
+    }
+
+    const payload = formatPayload ? JSON.parse(formatPayload, replacer) : null
+
+    return {
+      callId,
+      service,
+      procedure,
+      payload,
+    }
+  }
+}
+
+/**
+ * Standard JSON encoding format with no Neemata streams support.
+ */
+export class StandardJsonFormat extends BaseServerFormat {
+  contentType = 'application/json'
+  accept = ['application/json', 'application/vnd.api+json']
+
+  encode(data: any) {
+    return encodeText(JSON.stringify(data))
+  }
+
+  encodeRpc(rpc: RpcResponse) {
+    const { callId, error } = rpc
+    if (error) return this.encode([callId, error, null])
+    else {
+      return this.encode([callId, null, rpc.payload])
+    }
+  }
+
+  decode(buffer: ArrayBuffer) {
+    return JSON.parse(decodeText(buffer))
+  }
+
+  decodeRpc(buffer: ArrayBuffer) {
+    const [callId, service, procedure, payload] = this.decode(buffer)
+    return { callId, service, procedure, payload }
+  }
+}

package/tsconfig.json

@@ -0,0 +1,27 @@
+{
+  "compilerOptions": {
+    // Enable latest features
+    "lib": ["ESNext"],
+    "target": "ESNext",
+    "module": "NodeNext",
+    "moduleDetection": "force",
+    "allowJs": true,
+
+    // Bundler mode
+    "moduleResolution": "NodeNext",
+    "allowImportingTsExtensions": true,
+    "verbatimModuleSyntax": true,
+    "noEmit": true,
+    "noImplicitAny": false,
+
+    // Best practices
+    "strict": true,
+    "skipLibCheck": true,
+    "noFallthroughCasesInSwitch": true,
+
+    // Some stricter flags (disabled by default)
+    "noUnusedLocals": false,
+    "noUnusedParameters": false,
+    "noPropertyAccessFromIndexSignature": false
+  }
+}