@nmtjs/common 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,9 @@
+# NeemataJS - RPC application server for real-time applications (proof of concept)
+
+### Built with following in mind:
+- transport-agnostic (like WebSockets, WebTransport, .etc)
+- format-agnostic (like JSON, MessagePack, BSON, .etc)
+- binary data streaming and event subscriptions
+- contract-based API
+- end-to-end type safety
+- CPU-intensive task execution on separate workers

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from "./lib/binary.js";
+export * from "./lib/enums.js";
+export * from "./lib/format.js";
+export * from "./lib/protocol.js";
+export * from "./lib/types.js";
+export * from "./lib/blob.js";

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../index.ts"],"sourcesContent":["export * from './lib/binary.ts'\nexport * from './lib/enums.ts'\nexport * from './lib/format.ts'\nexport * from './lib/protocol.ts'\nexport * from './lib/types.ts'\nexport * from './lib/blob.ts'\n"],"names":[],"mappings":"AAAA,cAAc,kBAAiB;AAC/B,cAAc,iBAAgB;AAC9B,cAAc,kBAAiB;AAC/B,cAAc,oBAAmB;AACjC,cAAc,iBAAgB;AAC9B,cAAc,gBAAe"}

package/dist/lib/binary.js

@@ -0,0 +1,25 @@
+const utf8decoder = new TextDecoder();
+const utf8encoder = new TextEncoder();
+export const encodeNumber = (value, type, littleEndian = false)=>{
+    const bytesNeeded = globalThis[`${type}Array`].BYTES_PER_ELEMENT;
+    const ab = new ArrayBuffer(bytesNeeded);
+    const dv = new DataView(ab);
+    dv[`set${type}`](0, value, littleEndian);
+    return ab;
+};
+export const decodeNumber = (buffer, type, offset = 0, littleEndian = false)=>{
+    const view = new DataView(buffer);
+    return view[`get${type}`](offset, littleEndian);
+};
+export const encodeText = (text)=>new Uint8Array(utf8encoder.encode(text)).buffer;
+export const decodeText = (buffer)=>utf8decoder.decode(buffer);
+export const concat = (...buffers)=>{
+    const totalLength = buffers.reduce((acc, buffer)=>acc + buffer.byteLength, 0);
+    const view = new Uint8Array(totalLength);
+    let offset = 0;
+    for (const buffer of buffers){
+        view.set(new Uint8Array(buffer), offset);
+        offset += buffer.byteLength;
+    }
+    return view.buffer;
+};

package/dist/lib/binary.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/binary.ts"],"sourcesContent":["// TODO: get rid of lib DOM somehow...\n/// <reference lib=\"dom\" />\n\nconst utf8decoder = new TextDecoder()\nconst utf8encoder = new TextEncoder()\n\nexport type BinaryTypes = {\n  Int8: number\n  Int16: number\n  Int32: number\n  Uint8: number\n  Uint16: number\n  Uint32: number\n  Float32: number\n  Float64: number\n  BigInt64: bigint\n  BigUint64: bigint\n}\n\nexport const encodeNumber = <T extends keyof BinaryTypes>(\n  value: BinaryTypes[T],\n  type: T,\n  littleEndian = false,\n) => {\n  const bytesNeeded = globalThis[`${type}Array`].BYTES_PER_ELEMENT\n  const ab = new ArrayBuffer(bytesNeeded)\n  const dv = new DataView(ab)\n  dv[`set${type}`](0, value as never, littleEndian)\n  return ab\n}\n\nexport const decodeNumber = <T extends keyof BinaryTypes>(\n  buffer: ArrayBuffer,\n  type: T,\n  offset = 0,\n  littleEndian = false,\n): BinaryTypes[T] => {\n  const view = new DataView(buffer)\n  return view[`get${type}`](offset, littleEndian) as BinaryTypes[T]\n}\n\nexport const encodeText = (text: string) =>\n  new Uint8Array(utf8encoder.encode(text)).buffer as ArrayBuffer\n\nexport const decodeText = (buffer: Parameters<typeof utf8decoder.decode>[0]) =>\n  utf8decoder.decode(buffer)\n\nexport const concat = (...buffers: ArrayBuffer[]) => {\n  const totalLength = buffers.reduce(\n    (acc, buffer) => acc + buffer.byteLength,\n    0,\n  )\n  const view = new Uint8Array(totalLength)\n  let offset = 0\n  for (const buffer of buffers) {\n    view.set(new Uint8Array(buffer), offset)\n    offset += buffer.byteLength\n  }\n  return view.buffer as ArrayBuffer\n}\n"],"names":["utf8decoder","TextDecoder","utf8encoder","TextEncoder","encodeNumber","value","type","littleEndian","bytesNeeded","globalThis","BYTES_PER_ELEMENT","ab","ArrayBuffer","dv","DataView","decodeNumber","buffer","offset","view","encodeText","text","Uint8Array","encode","decodeText","decode","concat","buffers","totalLength","reduce","acc","byteLength","set"],"mappings":"AAGA,MAAMA,cAAc,IAAIC;AACxB,MAAMC,cAAc,IAAIC;AAexB,OAAO,MAAMC,eAAe,CAC1BC,OACAC,MACAC,eAAe,KAAK;IAEpB,MAAMC,cAAcC,UAAU,CAAC,CAAC,EAAEH,KAAK,KAAK,CAAC,CAAC,CAACI,iBAAiB;IAChE,MAAMC,KAAK,IAAIC,YAAYJ;IAC3B,MAAMK,KAAK,IAAIC,SAASH;IACxBE,EAAE,CAAC,CAAC,GAAG,EAAEP,KAAK,CAAC,CAAC,CAAC,GAAGD,OAAgBE;IACpC,OAAOI;AACT,EAAC;AAED,OAAO,MAAMI,eAAe,CAC1BC,QACAV,MACAW,SAAS,CAAC,EACVV,eAAe,KAAK;IAEpB,MAAMW,OAAO,IAAIJ,SAASE;IAC1B,OAAOE,IAAI,CAAC,CAAC,GAAG,EAAEZ,KAAK,CAAC,CAAC,CAACW,QAAQV;AACpC,EAAC;AAED,OAAO,MAAMY,aAAa,CAACC,OACzB,IAAIC,WAAWnB,YAAYoB,MAAM,CAACF,OAAOJ,MAAM,CAAe;AAEhE,OAAO,MAAMO,aAAa,CAACP,SACzBhB,YAAYwB,MAAM,CAACR,QAAO;AAE5B,OAAO,MAAMS,SAAS,CAAC,GAAGC;IACxB,MAAMC,cAAcD,QAAQE,MAAM,CAChC,CAACC,KAAKb,SAAWa,MAAMb,OAAOc,UAAU,EACxC;IAEF,MAAMZ,OAAO,IAAIG,WAAWM;IAC5B,IAAIV,SAAS;IACb,KAAK,MAAMD,UAAUU,QAAS;QAC5BR,KAAKa,GAAG,CAAC,IAAIV,WAAWL,SAASC;QACjCA,UAAUD,OAAOc,UAAU;IAC7B;IACA,OAAOZ,KAAKF,MAAM;AACpB,EAAC"}

package/dist/lib/blob.js

@@ -0,0 +1,42 @@
+export class ApiBlob {
+    metadata;
+    source;
+    constructor(source, size = -1, type = 'application/octet-stream', filename){
+        if (size < -1 || size === 0) throw new Error('Blob size is invalid');
+        this.source = source;
+        this.metadata = {
+            size,
+            type,
+            filename
+        };
+    }
+    static from(source, metadata = {}) {
+        let _source = undefined;
+        if (source instanceof ReadableStream) {
+            _source = source;
+        } else if ('File' in globalThis && source instanceof globalThis.File) {
+            _source = source.stream();
+            metadata.size = source.size;
+            metadata.filename = source.name;
+        } else if (source instanceof Blob) {
+            _source = source.stream();
+            metadata.size = source.size;
+        } else if (typeof source === 'string') {
+            const blob = new Blob([
+                source
+            ]);
+            _source = blob.stream();
+            metadata.size = blob.size;
+            metadata.type = metadata.type || 'text/plain';
+        } else if (source instanceof ArrayBuffer) {
+            const blob = new Blob([
+                source
+            ]);
+            _source = blob.stream();
+            metadata.size = blob.size;
+        } else {
+            _source = source;
+        }
+        return new ApiBlob(_source, metadata.size, metadata.type, metadata.filename);
+    }
+}

package/dist/lib/blob.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/blob.ts"],"sourcesContent":["import type { ApiBlobMetadata } from './types.ts'\n\nexport interface ApiBlobInterface {\n  readonly metadata: ApiBlobMetadata\n}\n\nexport type Exact<A, B> = [A] extends [B]\n  ? [B] extends [A]\n    ? true\n    : false\n  : false\n\nexport class ApiBlob implements ApiBlobInterface {\n  public readonly metadata: ApiBlobMetadata\n  public readonly source: any\n\n  constructor(\n    source: any,\n    size = -1,\n    type = 'application/octet-stream',\n    filename?: string,\n  ) {\n    if (size < -1 || size === 0) throw new Error('Blob size is invalid')\n\n    this.source = source\n    this.metadata = {\n      size,\n      type,\n      filename,\n    }\n  }\n\n  static from(\n    source: any,\n    metadata: {\n      size?: number\n      type?: string\n      filename?: string\n    } = {},\n  ) {\n    let _source: any = undefined\n\n    if (source instanceof ReadableStream) {\n      _source = source\n    } else if ('File' in globalThis && source instanceof globalThis.File) {\n      _source = source.stream()\n      metadata.size = source.size\n      metadata.filename = source.name\n    } else if (source instanceof Blob) {\n      _source = source.stream()\n      metadata.size = source.size\n    } else if (typeof source === 'string') {\n      const blob = new Blob([source])\n      _source = blob.stream()\n      metadata.size = blob.size\n      metadata.type = metadata.type || 'text/plain'\n    } else if (source instanceof ArrayBuffer) {\n      const blob = new Blob([source])\n      _source = blob.stream()\n      metadata.size = blob.size\n    } else {\n      _source = source\n    }\n\n    return new ApiBlob(_source, metadata.size, metadata.type, metadata.filename)\n  }\n}\n"],"names":["ApiBlob","metadata","source","constructor","size","type","filename","Error","from","_source","undefined","ReadableStream","globalThis","File","stream","name","Blob","blob","ArrayBuffer"],"mappings":"AAYA,OAAO,MAAMA;IACKC,SAAyB;IACzBC,OAAW;IAE3BC,YACED,MAAW,EACXE,OAAO,CAAC,CAAC,EACTC,OAAO,0BAA0B,EACjCC,QAAiB,CACjB;QACA,IAAIF,OAAO,CAAC,KAAKA,SAAS,GAAG,MAAM,IAAIG,MAAM;QAE7C,IAAI,CAACL,MAAM,GAAGA;QACd,IAAI,CAACD,QAAQ,GAAG;YACdG;YACAC;YACAC;QACF;IACF;IAEA,OAAOE,KACLN,MAAW,EACXD,WAII,CAAC,CAAC,EACN;QACA,IAAIQ,UAAeC;QAEnB,IAAIR,kBAAkBS,gBAAgB;YACpCF,UAAUP;QACZ,OAAO,IAAI,UAAUU,cAAcV,kBAAkBU,WAAWC,IAAI,EAAE;YACpEJ,UAAUP,OAAOY,MAAM;YACvBb,SAASG,IAAI,GAAGF,OAAOE,IAAI;YAC3BH,SAASK,QAAQ,GAAGJ,OAAOa,IAAI;QACjC,OAAO,IAAIb,kBAAkBc,MAAM;YACjCP,UAAUP,OAAOY,MAAM;YACvBb,SAASG,IAAI,GAAGF,OAAOE,IAAI;QAC7B,OAAO,IAAI,OAAOF,WAAW,UAAU;YACrC,MAAMe,OAAO,IAAID,KAAK;gBAACd;aAAO;YAC9BO,UAAUQ,KAAKH,MAAM;YACrBb,SAASG,IAAI,GAAGa,KAAKb,IAAI;YACzBH,SAASI,IAAI,GAAGJ,SAASI,IAAI,IAAI;QACnC,OAAO,IAAIH,kBAAkBgB,aAAa;YACxC,MAAMD,OAAO,IAAID,KAAK;gBAACd;aAAO;YAC9BO,UAAUQ,KAAKH,MAAM;YACrBb,SAASG,IAAI,GAAGa,KAAKb,IAAI;QAC3B,OAAO;YACLK,UAAUP;QACZ;QAEA,OAAO,IAAIF,QAAQS,SAASR,SAASG,IAAI,EAAEH,SAASI,IAAI,EAAEJ,SAASK,QAAQ;IAC7E;AACF"}

package/dist/lib/enums.js

@@ -0,0 +1,15 @@
+export var ErrorCode;
+(function(ErrorCode) {
+    ErrorCode["ValidationError"] = "ValidationError";
+    ErrorCode["BadRequest"] = "BadRequest";
+    ErrorCode["NotFound"] = "NotFound";
+    ErrorCode["Forbidden"] = "Forbidden";
+    ErrorCode["Unauthorized"] = "Unauthorized";
+    ErrorCode["InternalServerError"] = "InternalServerError";
+    ErrorCode["NotAcceptable"] = "NotAcceptable";
+    ErrorCode["RequestTimeout"] = "RequestTimeout";
+    ErrorCode["GatewayTimeout"] = "GatewayTimeout";
+    ErrorCode["ServiceUnavailable"] = "ServiceUnavailable";
+    ErrorCode["ClientRequestError"] = "ClientRequestError";
+    ErrorCode["ConnectionError"] = "ConnectionError";
+})(ErrorCode || (ErrorCode = {}));

package/dist/lib/enums.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/enums.ts"],"sourcesContent":["export enum ErrorCode {\n  ValidationError = 'ValidationError',\n  BadRequest = 'BadRequest',\n  NotFound = 'NotFound',\n  Forbidden = 'Forbidden',\n  Unauthorized = 'Unauthorized',\n  InternalServerError = 'InternalServerError',\n  NotAcceptable = 'NotAcceptable',\n  RequestTimeout = 'RequestTimeout',\n  GatewayTimeout = 'GatewayTimeout',\n  ServiceUnavailable = 'ServiceUnavailable',\n  ClientRequestError = 'ClientRequestError',\n  ConnectionError = 'ConnectionError',\n}\n"],"names":["ErrorCode"],"mappings":";UAAYA;;;;;;;;;;;;;GAAAA,cAAAA"}

package/dist/lib/format.js

@@ -0,0 +1,4 @@
+export class BaseClientFormat {
+}
+export class BaseServerFormat {
+}

package/dist/lib/format.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/format.ts"],"sourcesContent":["import type { ApiBlob } from './blob.ts'\nimport type { ApiBlobMetadata, Pattern, Rpc, RpcResponse } from './types.ts'\n\nexport interface EncodeRpcContext {\n  getStream: (id: number) => any\n  addStream: (blob: ApiBlob) => { id: number; metadata: ApiBlobMetadata }\n}\n\nexport interface DecodeRpcContext {\n  getStream: (id: number) => any\n  addStream: (id: number, metadata: ApiBlobMetadata) => any\n}\n\nexport interface BaseClientDecoder {\n  decode(buffer: ArrayBuffer): any\n  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext): RpcResponse\n}\n\nexport interface BaseClientEncoder {\n  encode(data: any): ArrayBuffer\n  encodeRpc(rpc: Rpc, context: EncodeRpcContext): ArrayBuffer\n}\n\nexport abstract class BaseClientFormat\n  implements BaseClientDecoder, BaseClientEncoder\n{\n  abstract contentType: string\n\n  abstract encode(data: any): ArrayBuffer\n  abstract encodeRpc(rpc: Rpc, context: EncodeRpcContext): ArrayBuffer\n  abstract decode(buffer: ArrayBuffer): any\n  abstract decodeRpc(\n    buffer: ArrayBuffer,\n    context: DecodeRpcContext,\n  ): RpcResponse\n}\n\nexport interface BaseServerDecoder {\n  accept: Pattern[]\n  decode(buffer: ArrayBuffer): any\n  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext): Rpc\n}\n\nexport interface BaseServerEncoder {\n  contentType: string\n  encode(data: any): ArrayBuffer\n  encodeRpc(rpc: RpcResponse, context: EncodeRpcContext): ArrayBuffer\n}\n\nexport abstract class BaseServerFormat\n  implements BaseServerDecoder, BaseServerEncoder\n{\n  abstract accept: Pattern[]\n  abstract contentType: string\n\n  abstract encode(data: any): ArrayBuffer\n  abstract encodeRpc(rpc: RpcResponse, context: EncodeRpcContext): ArrayBuffer\n  abstract decode(buffer: ArrayBuffer): any\n  abstract decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext): Rpc\n}\n"],"names":["BaseClientFormat","BaseServerFormat"],"mappings":"AAuBA,OAAO,MAAeA;AAYtB;AAcA,OAAO,MAAeC;AAUtB"}

package/dist/lib/protocol.js

@@ -0,0 +1,27 @@
+export const MessageType = Object.freeze({
+    Event: 10,
+    Rpc: 11,
+    RpcBatch: 12,
+    RpcAbort: 14,
+    RpcSubscription: 15,
+    UpStreamAbort: 30,
+    UpStreamPush: 31,
+    UpStreamPull: 32,
+    UpStreamEnd: 33,
+    ClientUnsubscribe: 34,
+    DownStreamAbort: 50,
+    DownStreamPull: 51,
+    DownStreamPush: 52,
+    DownStreamEnd: 53,
+    ServerUnsubscribe: 54,
+    ServerSubscriptionEvent: 55
+});
+export const MessageTypeName = Object.fromEntries(Object.entries(MessageType).map(([k, v])=>[
+        v,
+        k
+    ]));
+export var TransportType;
+(function(TransportType) {
+    TransportType["WS"] = "WS";
+    TransportType["HTTP"] = "HTTP";
+})(TransportType || (TransportType = {}));

package/dist/lib/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/protocol.ts"],"sourcesContent":["export const MessageType = Object.freeze({\n  // Common\n  Event: 10,\n  Rpc: 11,\n  RpcBatch: 12,\n  RpcAbort: 14,\n  RpcSubscription: 15,\n\n  // Client streams\n  UpStreamAbort: 30,\n  UpStreamPush: 31,\n  UpStreamPull: 32,\n  UpStreamEnd: 33,\n\n  // Client subsctiption\n  ClientUnsubscribe: 34,\n\n  // Server streams\n  DownStreamAbort: 50,\n  DownStreamPull: 51,\n  DownStreamPush: 52,\n  DownStreamEnd: 53,\n\n  // Server subsctiption\n  ServerUnsubscribe: 54,\n  ServerSubscriptionEvent: 55,\n} as const)\n\nexport type MessageType = (typeof MessageType)[keyof typeof MessageType]\n\nexport const MessageTypeName = Object.fromEntries(\n  Object.entries(MessageType).map(([k, v]) => [v, k]),\n)\nexport type MessageTypeName = keyof typeof MessageType\n\n// TODO: Should it be hardcoded ??\nexport enum TransportType {\n  WS = 'WS',\n  HTTP = 'HTTP',\n}\n"],"names":["MessageType","Object","freeze","Event","Rpc","RpcBatch","RpcAbort","RpcSubscription","UpStreamAbort","UpStreamPush","UpStreamPull","UpStreamEnd","ClientUnsubscribe","DownStreamAbort","DownStreamPull","DownStreamPush","DownStreamEnd","ServerUnsubscribe","ServerSubscriptionEvent","MessageTypeName","fromEntries","entries","map","k","v","TransportType"],"mappings":"AAAA,OAAO,MAAMA,cAAcC,OAAOC,MAAM,CAAC;IAEvCC,OAAO;IACPC,KAAK;IACLC,UAAU;IACVC,UAAU;IACVC,iBAAiB;IAGjBC,eAAe;IACfC,cAAc;IACdC,cAAc;IACdC,aAAa;IAGbC,mBAAmB;IAGnBC,iBAAiB;IACjBC,gBAAgB;IAChBC,gBAAgB;IAChBC,eAAe;IAGfC,mBAAmB;IACnBC,yBAAyB;AAC3B,GAAW;AAIX,OAAO,MAAMC,kBAAkBlB,OAAOmB,WAAW,CAC/CnB,OAAOoB,OAAO,CAACrB,aAAasB,GAAG,CAAC,CAAC,CAACC,GAAGC,EAAE,GAAK;QAACA;QAAGD;KAAE,GACnD;;UAIWE;;;GAAAA,kBAAAA"}

package/dist/lib/types.js

@@ -0,0 +1 @@
+export { };

package/dist/lib/types.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/types.ts"],"sourcesContent":["export type ApiBlobMetadata = {\n  type: string\n  size: number\n  filename?: string\n}\n\nexport type Rpc = {\n  callId: number\n  service: string\n  procedure: string\n  payload: any\n}\n\nexport type RpcResponse = {\n  callId: number\n  error?: any\n  payload?: any\n}\n\nexport interface TypeProvider {\n  readonly input: unknown\n  readonly output: unknown\n}\n\nexport type CallTypeProvider<T extends TypeProvider, V> = (T & {\n  input: V\n})['output']\n\nexport type Pattern = RegExp | string | ((value: string) => boolean)\n"],"names":[],"mappings":"AA4BA,WAAoE"}

package/index.ts

@@ -0,0 +1,6 @@
+export * from './lib/binary.ts'
+export * from './lib/enums.ts'
+export * from './lib/format.ts'
+export * from './lib/protocol.ts'
+export * from './lib/types.ts'
+export * from './lib/blob.ts'

package/lib/binary.ts

@@ -0,0 +1,60 @@
+// TODO: get rid of lib DOM somehow...
+/// <reference lib="dom" />
+
+const utf8decoder = new TextDecoder()
+const utf8encoder = new TextEncoder()
+
+export type BinaryTypes = {
+  Int8: number
+  Int16: number
+  Int32: number
+  Uint8: number
+  Uint16: number
+  Uint32: number
+  Float32: number
+  Float64: number
+  BigInt64: bigint
+  BigUint64: bigint
+}
+
+export const encodeNumber = <T extends keyof BinaryTypes>(
+  value: BinaryTypes[T],
+  type: T,
+  littleEndian = false,
+) => {
+  const bytesNeeded = globalThis[`${type}Array`].BYTES_PER_ELEMENT
+  const ab = new ArrayBuffer(bytesNeeded)
+  const dv = new DataView(ab)
+  dv[`set${type}`](0, value as never, littleEndian)
+  return ab
+}
+
+export const decodeNumber = <T extends keyof BinaryTypes>(
+  buffer: ArrayBuffer,
+  type: T,
+  offset = 0,
+  littleEndian = false,
+): BinaryTypes[T] => {
+  const view = new DataView(buffer)
+  return view[`get${type}`](offset, littleEndian) as BinaryTypes[T]
+}
+
+export const encodeText = (text: string) =>
+  new Uint8Array(utf8encoder.encode(text)).buffer as ArrayBuffer
+
+export const decodeText = (buffer: Parameters<typeof utf8decoder.decode>[0]) =>
+  utf8decoder.decode(buffer)
+
+export const concat = (...buffers: ArrayBuffer[]) => {
+  const totalLength = buffers.reduce(
+    (acc, buffer) => acc + buffer.byteLength,
+    0,
+  )
+  const view = new Uint8Array(totalLength)
+  let offset = 0
+  for (const buffer of buffers) {
+    view.set(new Uint8Array(buffer), offset)
+    offset += buffer.byteLength
+  }
+  return view.buffer as ArrayBuffer
+}

package/lib/blob.ts

@@ -0,0 +1,67 @@
+import type { ApiBlobMetadata } from './types.ts'
+
+export interface ApiBlobInterface {
+  readonly metadata: ApiBlobMetadata
+}
+
+export type Exact<A, B> = [A] extends [B]
+  ? [B] extends [A]
+    ? true
+    : false
+  : false
+
+export class ApiBlob implements ApiBlobInterface {
+  public readonly metadata: ApiBlobMetadata
+  public readonly source: any
+
+  constructor(
+    source: any,
+    size = -1,
+    type = 'application/octet-stream',
+    filename?: string,
+  ) {
+    if (size < -1 || size === 0) throw new Error('Blob size is invalid')
+
+    this.source = source
+    this.metadata = {
+      size,
+      type,
+      filename,
+    }
+  }
+
+  static from(
+    source: any,
+    metadata: {
+      size?: number
+      type?: string
+      filename?: string
+    } = {},
+  ) {
+    let _source: any = undefined
+
+    if (source instanceof ReadableStream) {
+      _source = source
+    } else if ('File' in globalThis && source instanceof globalThis.File) {
+      _source = source.stream()
+      metadata.size = source.size
+      metadata.filename = source.name
+    } else if (source instanceof Blob) {
+      _source = source.stream()
+      metadata.size = source.size
+    } else if (typeof source === 'string') {
+      const blob = new Blob([source])
+      _source = blob.stream()
+      metadata.size = blob.size
+      metadata.type = metadata.type || 'text/plain'
+    } else if (source instanceof ArrayBuffer) {
+      const blob = new Blob([source])
+      _source = blob.stream()
+      metadata.size = blob.size
+    } else {
+      _source = source
+    }
+
+    return new ApiBlob(_source, metadata.size, metadata.type, metadata.filename)
+  }
+}

package/lib/enums.ts

@@ -0,0 +1,14 @@
+export enum ErrorCode {
+  ValidationError = 'ValidationError',
+  BadRequest = 'BadRequest',
+  NotFound = 'NotFound',
+  Forbidden = 'Forbidden',
+  Unauthorized = 'Unauthorized',
+  InternalServerError = 'InternalServerError',
+  NotAcceptable = 'NotAcceptable',
+  RequestTimeout = 'RequestTimeout',
+  GatewayTimeout = 'GatewayTimeout',
+  ServiceUnavailable = 'ServiceUnavailable',
+  ClientRequestError = 'ClientRequestError',
+  ConnectionError = 'ConnectionError',
+}

package/lib/format.ts

@@ -0,0 +1,60 @@
+import type { ApiBlob } from './blob.ts'
+import type { ApiBlobMetadata, Pattern, Rpc, RpcResponse } from './types.ts'
+
+export interface EncodeRpcContext {
+  getStream: (id: number) => any
+  addStream: (blob: ApiBlob) => { id: number; metadata: ApiBlobMetadata }
+}
+
+export interface DecodeRpcContext {
+  getStream: (id: number) => any
+  addStream: (id: number, metadata: ApiBlobMetadata) => any
+}
+
+export interface BaseClientDecoder {
+  decode(buffer: ArrayBuffer): any
+  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext): RpcResponse
+}
+
+export interface BaseClientEncoder {
+  encode(data: any): ArrayBuffer
+  encodeRpc(rpc: Rpc, context: EncodeRpcContext): ArrayBuffer
+}
+
+export abstract class BaseClientFormat
+  implements BaseClientDecoder, BaseClientEncoder
+{
+  abstract contentType: string
+
+  abstract encode(data: any): ArrayBuffer
+  abstract encodeRpc(rpc: Rpc, context: EncodeRpcContext): ArrayBuffer
+  abstract decode(buffer: ArrayBuffer): any
+  abstract decodeRpc(
+    buffer: ArrayBuffer,
+    context: DecodeRpcContext,
+  ): RpcResponse
+}
+
+export interface BaseServerDecoder {
+  accept: Pattern[]
+  decode(buffer: ArrayBuffer): any
+  decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext): Rpc
+}
+
+export interface BaseServerEncoder {
+  contentType: string
+  encode(data: any): ArrayBuffer
+  encodeRpc(rpc: RpcResponse, context: EncodeRpcContext): ArrayBuffer
+}
+
+export abstract class BaseServerFormat
+  implements BaseServerDecoder, BaseServerEncoder
+{
+  abstract accept: Pattern[]
+  abstract contentType: string
+
+  abstract encode(data: any): ArrayBuffer
+  abstract encodeRpc(rpc: RpcResponse, context: EncodeRpcContext): ArrayBuffer
+  abstract decode(buffer: ArrayBuffer): any
+  abstract decodeRpc(buffer: ArrayBuffer, context: DecodeRpcContext): Rpc
+}

package/lib/protocol.ts

@@ -0,0 +1,40 @@
+export const MessageType = Object.freeze({
+  // Common
+  Event: 10,
+  Rpc: 11,
+  RpcBatch: 12,
+  RpcAbort: 14,
+  RpcSubscription: 15,
+
+  // Client streams
+  UpStreamAbort: 30,
+  UpStreamPush: 31,
+  UpStreamPull: 32,
+  UpStreamEnd: 33,
+
+  // Client subsctiption
+  ClientUnsubscribe: 34,
+
+  // Server streams
+  DownStreamAbort: 50,
+  DownStreamPull: 51,
+  DownStreamPush: 52,
+  DownStreamEnd: 53,
+
+  // Server subsctiption
+  ServerUnsubscribe: 54,
+  ServerSubscriptionEvent: 55,
+} as const)
+
+export type MessageType = (typeof MessageType)[keyof typeof MessageType]
+
+export const MessageTypeName = Object.fromEntries(
+  Object.entries(MessageType).map(([k, v]) => [v, k]),
+)
+export type MessageTypeName = keyof typeof MessageType
+
+// TODO: Should it be hardcoded ??
+export enum TransportType {
+  WS = 'WS',
+  HTTP = 'HTTP',
+}

package/lib/types.ts

@@ -0,0 +1,29 @@
+export type ApiBlobMetadata = {
+  type: string
+  size: number
+  filename?: string
+}
+
+export type Rpc = {
+  callId: number
+  service: string
+  procedure: string
+  payload: any
+}
+
+export type RpcResponse = {
+  callId: number
+  error?: any
+  payload?: any
+}
+
+export interface TypeProvider {
+  readonly input: unknown
+  readonly output: unknown
+}
+
+export type CallTypeProvider<T extends TypeProvider, V> = (T & {
+  input: V
+})['output']
+
+export type Pattern = RegExp | string | ((value: string) => boolean)

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "@nmtjs/common",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./index.ts",
+      "default": "./dist/index.js",
+      "types": "./index.ts"
+    }
+  },
+  "files": [
+    "index.ts",
+    "lib",
+    "dist",
+    "tsconfig.json",
+    "LICENSE.md",
+    "README.md"
+  ],
+  "version": "0.0.1",
+  "scripts": {
+    "build": "neemata-build -p neutral ./index.ts './lib/**/*.ts'",
+    "type-check": "tsc --noEmit"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,3 @@
+{
+  "extends": "../../tsconfig.json"
+}