@nmtjs/client 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/client.js";
+export * from "./lib/common.js";
+export * from "./lib/stream.js";
+export * from "./lib/subscription.js";
+export * from "./lib/transport.js";
+export * from "./lib/utils.js";

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../index.ts"],"sourcesContent":["export * from './lib/client.ts'\nexport * from './lib/common.ts'\nexport * from './lib/stream.ts'\nexport * from './lib/subscription.ts'\nexport * from './lib/transport.ts'\nexport * from './lib/utils.ts'\n"],"names":[],"mappings":"AAAA,cAAc,kBAAiB;AAC/B,cAAc,kBAAiB;AAC/B,cAAc,kBAAiB;AAC/B,cAAc,wBAAuB;AACrC,cAAc,qBAAoB;AAClC,cAAc,iBAAgB"}

package/dist/lib/client-runtime.js

@@ -0,0 +1,70 @@
+import { compile } from '@nmtjs/contract/compiler';
+import { ContractGuard } from '@nmtjs/contract/guards';
+import { Client } from "./client.js";
+export class RuntimeClient extends Client {
+    #callers;
+    constructor(services, options){
+        super(options, Object.values(services).map((s)=>s.contract.name));
+        const callers = {};
+        for (const [serviceKey, serviceContract] of Object.entries(services)){
+            if (!serviceContract.contract.transports[this.transport.type]) throw new Error(`Transport [${this.transport.type}] not supported for service [${serviceContract.contract.name}]`);
+            callers[serviceKey] = {};
+            for(const procedureName in serviceContract.contract.procedures){
+                const { input, output } = serviceContract.contract.procedures[procedureName];
+                callers[serviceKey][procedureName] = this.createCaller(serviceContract.contract.name, procedureName, {
+                    timeout: serviceContract.contract.timeout,
+                    transformInput: (data)=>{
+                        if (ContractGuard.IsNever(data)) return undefined;
+                        const compiled = serviceContract.compiled.get(input);
+                        const result = compiled.encode(data);
+                        if (result.success) {
+                            return result.value;
+                        } else {
+                            console.dir(result.error);
+                            throw new Error('Failed to encode input', {
+                                cause: result.error
+                            });
+                        }
+                    },
+                    transformOutput: (data)=>{
+                        if (ContractGuard.IsNever(data)) return undefined;
+                        const compiled = serviceContract.compiled.get(output);
+                        const result = compiled.decode(data);
+                        if (result.success) {
+                            return result.value;
+                        } else {
+                            console.dir(result.error);
+                            throw new Error('Failed to decode output', {
+                                cause: result.error
+                            });
+                        }
+                    }
+                });
+            }
+        }
+        this.#callers = callers;
+    }
+    get call() {
+        return this.#callers;
+    }
+}
+export const compileContract = (contract)=>{
+    const compiled = new Map();
+    for (const procedureContract of Object.values(contract.procedures)){
+        const { input, output, events } = procedureContract;
+        if (ContractGuard.IsSubscription(procedureContract)) {
+            for (const event of Object.values(events)){
+                compiled.set(event, compile(event));
+            }
+        }
+        compiled.set(input, compile(input));
+        compiled.set(output, compile(output));
+    }
+    for (const eventContract of Object.values(contract.events)){
+        compiled.set(eventContract, compile(eventContract));
+    }
+    return {
+        compiled,
+        contract
+    };
+};

package/dist/lib/client-runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/client-runtime.ts"],"sourcesContent":["import type {\n  Decoded,\n  TEventContract,\n  TSchema,\n  TServiceContract,\n  TSubscriptionContract,\n} from '@nmtjs/contract'\nimport { type Compiled, compile } from '@nmtjs/contract/compiler'\nimport { ContractGuard } from '@nmtjs/contract/guards'\nimport { Client, type ClientOptions } from './client.ts'\nimport type { Subscription } from './subscription.ts'\nimport type { ClientCallOptions, InputType, OutputType } from './types.ts'\n\ntype CompiledContract<T extends TServiceContract = TServiceContract> = {\n  compiled: Map<TSchema, Compiled>\n  contract: T\n}\n\ntype ClientServices = Record<string, CompiledContract>\n\ntype ClientCallers<Services extends ClientServices> = {\n  [K in keyof Services]: {\n    [P in keyof Services[K]['contract']['procedures']]: (\n      ...args: Decoded<\n        Services[K]['contract']['procedures'][P]['input']\n      > extends never\n        ? [options?: ClientCallOptions]\n        : [\n            data: InputType<\n              Decoded<Services[K]['contract']['procedures'][P]['input']>\n            >,\n            options?: ClientCallOptions,\n          ]\n    ) => Promise<\n      Services[K]['contract']['procedures'][P] extends TSubscriptionContract\n        ? {\n            payload: Decoded<\n              Services[K]['contract']['procedures'][P]['output']\n            > extends never\n              ? undefined\n              : Decoded<Services[K]['contract']['procedures'][P]['output']>\n            subscription: Subscription<Services[K]['contract']['procedures'][P]>\n          }\n        : Decoded<\n              Services[K]['contract']['procedures'][P]['static']\n            > extends never\n          ? void\n          : OutputType<\n              Decoded<Services[K]['contract']['procedures'][P]['output']>\n            >\n    >\n  }\n}\n\nexport class RuntimeClient<Services extends ClientServices> extends Client {\n  #callers: ClientCallers<Services>\n\n  constructor(services: Services, options: ClientOptions) {\n    super(\n      options,\n      Object.values(services).map((s) => s.contract.name),\n    )\n\n    const callers = {} as any\n    for (const [serviceKey, serviceContract] of Object.entries(services)) {\n      if (!serviceContract.contract.transports[this.transport.type])\n        throw new Error(\n          `Transport [${this.transport.type}] not supported for service [${serviceContract.contract.name}]`,\n        )\n\n      callers[serviceKey] = {} as any\n\n      for (const procedureName in serviceContract.contract.procedures) {\n        const { input, output } =\n          serviceContract.contract.procedures[procedureName]\n\n        callers[serviceKey][procedureName] = this.createCaller(\n          serviceContract.contract.name,\n          procedureName,\n          {\n            timeout: serviceContract.contract.timeout,\n            transformInput: (data: any) => {\n              if (ContractGuard.IsNever(data)) return undefined\n              const compiled = serviceContract.compiled.get(input)!\n              const result = compiled.encode(data)\n              if (result.success) {\n                return result.value\n              } else {\n                console.dir(result.error)\n                throw new Error('Failed to encode input', {\n                  cause: result.error,\n                })\n              }\n            },\n            transformOutput: (data: any) => {\n              if (ContractGuard.IsNever(data)) return undefined\n              const compiled = serviceContract.compiled.get(output)!\n              const result = compiled.decode(data)\n              if (result.success) {\n                return result.value\n              } else {\n                console.dir(result.error)\n                throw new Error('Failed to decode output', {\n                  cause: result.error,\n                })\n              }\n            },\n          },\n        )\n      }\n    }\n    this.#callers = callers\n  }\n\n  get call() {\n    return this.#callers\n  }\n}\n\nexport const compileContract = <T extends TServiceContract>(\n  contract: T,\n): CompiledContract<T> => {\n  const compiled = new Map<TSchema, Compiled>()\n  for (const procedureContract of Object.values(contract.procedures)) {\n    const { input, output, events } = procedureContract\n    if (ContractGuard.IsSubscription(procedureContract)) {\n      for (const event of Object.values(events) as TEventContract[]) {\n        compiled.set(event, compile(event))\n      }\n    }\n    compiled.set(input, compile(input))\n    compiled.set(output, compile(output))\n  }\n  for (const eventContract of Object.values(contract.events)) {\n    compiled.set(eventContract, compile(eventContract))\n  }\n\n  return {\n    compiled,\n    contract,\n  }\n}\n"],"names":["compile","ContractGuard","Client","RuntimeClient","constructor","services","options","Object","values","map","s","contract","name","callers","serviceKey","serviceContract","entries","transports","transport","type","Error","procedureName","procedures","input","output","createCaller","timeout","transformInput","data","IsNever","undefined","compiled","get","result","encode","success","value","console","dir","error","cause","transformOutput","decode","call","compileContract","Map","procedureContract","events","IsSubscription","event","set","eventContract"],"mappings":"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"}

package/dist/lib/client-static.js

@@ -0,0 +1,19 @@
+import { Client } from "./client.js";
+export class StaticClient extends Client {
+    #callers;
+    constructor(services, options){
+        super(options, Object.values(services));
+        const callers = {};
+        for (const [serviceKey, serviceName] of Object.entries(services)){
+            callers[serviceKey] = new Proxy(Object(), {
+                get: (target, prop, receiver)=>{
+                    return this.createCaller(serviceName, prop);
+                }
+            });
+        }
+        this.#callers = callers;
+    }
+    get call() {
+        return this.#callers;
+    }
+}

package/dist/lib/client-static.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/client-static.ts"],"sourcesContent":["import type {\n  Encoded,\n  TServiceContract,\n  TSubscriptionContract,\n} from '@nmtjs/contract'\nimport { Client, type ClientOptions } from './client.ts'\nimport type { Subscription } from './subscription.ts'\nimport type { ClientCallOptions, InputType, OutputType } from './types.ts'\n\ntype ClientServices = Record<string, TServiceContract>\n\ntype ClientCallers<Services extends ClientServices> = {\n  [K in keyof Services]: {\n    [P in keyof Services[K]['procedures']]: (\n      ...args: Encoded<Services[K]['procedures'][P]['input']> extends never\n        ? [options?: ClientCallOptions]\n        : [\n            data: InputType<Encoded<Services[K]['procedures'][P]['input']>>,\n            options?: ClientCallOptions,\n          ]\n    ) => Promise<\n      Services[K]['procedures'][P] extends TSubscriptionContract\n        ? {\n            payload: Encoded<\n              Services[K]['procedures'][P]['output']\n            > extends never\n              ? undefined\n              : Encoded<Services[K]['procedures'][P]['output']>\n            subscription: Subscription<Services[K]['procedures'][P]>\n          }\n        : Encoded<Services[K]['procedures'][P]['static']> extends never\n          ? void\n          : OutputType<Encoded<Services[K]['procedures'][P]['output']>>\n    >\n  }\n}\n\nexport class StaticClient<Services extends ClientServices> extends Client {\n  #callers: ClientCallers<Services>\n\n  constructor(\n    services: { [K in keyof Services]: Services[K]['name'] },\n    options: ClientOptions,\n  ) {\n    super(options, Object.values(services))\n\n    const callers = {} as any\n\n    for (const [serviceKey, serviceName] of Object.entries(services)) {\n      callers[serviceKey] = new Proxy(Object(), {\n        get: (target, prop, receiver) => {\n          return this.createCaller(serviceName, prop as string)\n        },\n      })\n    }\n\n    this.#callers = callers\n  }\n\n  get call() {\n    return this.#callers\n  }\n}\n"],"names":["Client","StaticClient","constructor","services","options","Object","values","callers","serviceKey","serviceName","entries","Proxy","get","target","prop","receiver","createCaller","call"],"mappings":"AAKA,SAASA,MAAM,QAA4B,cAAa;AAgCxD,OAAO,MAAMC,qBAAsDD;IACjE,CAAA,OAAQ,CAAyB;IAEjCE,YACEC,QAAwD,EACxDC,OAAsB,CACtB;QACA,KAAK,CAACA,SAASC,OAAOC,MAAM,CAACH;QAE7B,MAAMI,UAAU,CAAC;QAEjB,KAAK,MAAM,CAACC,YAAYC,YAAY,IAAIJ,OAAOK,OAAO,CAACP,UAAW;YAChEI,OAAO,CAACC,WAAW,GAAG,IAAIG,MAAMN,UAAU;gBACxCO,KAAK,CAACC,QAAQC,MAAMC;oBAClB,OAAO,IAAI,CAACC,YAAY,CAACP,aAAaK;gBACxC;YACF;QACF;QAEA,IAAI,CAAC,CAAA,OAAQ,GAAGP;IAClB;IAEA,IAAIU,OAAO;QACT,OAAO,IAAI,CAAC,CAAA,OAAQ;IACtB;AACF"}

package/dist/lib/client.js

@@ -0,0 +1,92 @@
+import { ErrorCode } from '@nmtjs/common';
+import { ClientError } from "./common.js";
+import * as utils from "./utils.js";
+export class Client extends utils.EventEmitter {
+    options;
+    services;
+    transport;
+    format;
+    auth;
+    ids;
+    constructor(options, services){
+        super();
+        this.options = options;
+        this.services = services;
+        this.ids = {
+            call: 0,
+            stream: 0
+        };
+        if (!options.defaultTimeout) options.defaultTimeout = 15000;
+    }
+    useTransport(transportClass, ...options) {
+        this.transport = new transportClass(...options);
+        this.transport.client = Object.freeze({
+            services: this.services,
+            format: this.format,
+            auth: this.auth
+        });
+        return this;
+    }
+    useFormat(format) {
+        this.format = format;
+        return this;
+    }
+    async connect() {
+        await this.transport.connect();
+    }
+    async disconnect() {
+        await this.transport.disconnect();
+    }
+    async reconnect() {
+        await this.disconnect();
+        await this.connect();
+    }
+    createCaller(service, procedure, { timeout = this.options.defaultTimeout, transformInput, transformOutput } = {}) {
+        return async (payload, options = {})=>{
+            const { signal } = options;
+            const abortSignal = signal ? AbortSignal.any([
+                signal,
+                AbortSignal.timeout(timeout)
+            ]) : AbortSignal.timeout(timeout);
+            const callId = ++this.ids.call;
+            if (this.options.debug) {
+                console.groupCollapsed(`RPC [${callId}] ${service}/${procedure}`);
+                console.log(payload);
+                console.groupEnd();
+            }
+            const callExecution = this.transport.rpc({
+                callId,
+                service,
+                procedure,
+                payload: transformInput ? transformInput(payload) : payload,
+                signal: abortSignal
+            }).then((result)=>{
+                if (result.success) return result.value;
+                throw new ClientError(result.error.code, result.error.message, result.error.data);
+            });
+            const callTimeout = utils.forAborted(abortSignal).catch(()=>{
+                const error = new ClientError(ErrorCode.RequestTimeout);
+                return Promise.reject(error);
+            });
+            try {
+                const response = await Promise.race([
+                    callTimeout,
+                    callExecution
+                ]);
+                if (this.options.debug) {
+                    console.groupCollapsed(`RPC [${callId}] Success`);
+                    console.log(response);
+                    console.groupEnd();
+                }
+                return transformOutput ? transformOutput(response) : response;
+            } catch (error) {
+                if (this.options.debug) {
+                    console.groupCollapsed(`RPC [${callId}] Error`);
+                    console.log(error);
+                    console.groupEnd();
+                }
+                throw error;
+            }
+        };
+    }
+}

package/dist/lib/client.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/client.ts"],"sourcesContent":["import { type BaseClientFormat, ErrorCode } from '@nmtjs/common'\n\nimport { ClientError } from './common.ts'\nimport type { ClientTransport } from './transport.ts'\nimport type { ClientCallOptions } from './types.ts'\nimport * as utils from './utils.ts'\n\nexport type ClientOptions = {\n  defaultTimeout: number\n  debug?: boolean\n}\n\nexport abstract class Client extends utils.EventEmitter {\n  protected transport!: ClientTransport\n  protected format!: BaseClientFormat\n\n  auth?: string\n\n  private ids = {\n    call: 0,\n    stream: 0,\n  }\n\n  constructor(\n    protected readonly options: ClientOptions,\n    protected services: string[],\n  ) {\n    super()\n    if (!options.defaultTimeout) options.defaultTimeout = 15000\n  }\n\n  useTransport<T extends new (...args: any[]) => ClientTransport>(\n    transportClass: T,\n    ...options: ConstructorParameters<T>\n  ) {\n    this.transport = new transportClass(...options)\n    this.transport.client = Object.freeze({\n      services: this.services,\n      format: this.format,\n      auth: this.auth,\n    })\n    return this as Omit<this, 'useTransport'>\n  }\n\n  useFormat(format: BaseClientFormat) {\n    this.format = format\n    return this as Omit<this, 'useFormat'>\n  }\n\n  async connect() {\n    await this.transport.connect()\n  }\n\n  async disconnect() {\n    await this.transport.disconnect()\n  }\n\n  async reconnect() {\n    await this.disconnect()\n    await this.connect()\n  }\n\n  protected createCaller(\n    service: string,\n    procedure: string,\n    {\n      timeout = this.options.defaultTimeout,\n      transformInput,\n      transformOutput,\n    }: {\n      timeout?: number\n      transformInput?: (input: any) => any\n      transformOutput?: (output: any) => any\n    } = {},\n  ) {\n    return async (payload: any, options: ClientCallOptions = {}) => {\n      const { signal } = options\n\n      const abortSignal = signal\n        ? AbortSignal.any([signal, AbortSignal.timeout(timeout)])\n        : AbortSignal.timeout(timeout)\n\n      const callId = ++this.ids.call\n\n      if (this.options.debug) {\n        console.groupCollapsed(`RPC [${callId}] ${service}/${procedure}`)\n        console.log(payload)\n        console.groupEnd()\n      }\n\n      const callExecution = this.transport\n        .rpc({\n          callId,\n          service,\n          procedure,\n          payload: transformInput ? transformInput(payload) : payload,\n          signal: abortSignal,\n        })\n        .then((result) => {\n          if (result.success) return result.value\n          throw new ClientError(\n            result.error.code,\n            result.error.message,\n            result.error.data,\n          )\n        })\n\n      const callTimeout = utils.forAborted(abortSignal).catch(() => {\n        const error = new ClientError(ErrorCode.RequestTimeout)\n        return Promise.reject(error)\n      })\n\n      try {\n        const response = await Promise.race([callTimeout, callExecution])\n\n        if (this.options.debug) {\n          console.groupCollapsed(`RPC [${callId}] Success`)\n          console.log(response)\n          console.groupEnd()\n        }\n\n        return transformOutput ? transformOutput(response) : response\n      } catch (error) {\n        if (this.options.debug) {\n          console.groupCollapsed(`RPC [${callId}] Error`)\n          console.log(error)\n          console.groupEnd()\n        }\n\n        throw error\n      }\n    }\n  }\n}\n"],"names":["ErrorCode","ClientError","utils","Client","EventEmitter","transport","format","auth","ids","constructor","options","services","call","stream","defaultTimeout","useTransport","transportClass","client","Object","freeze","useFormat","connect","disconnect","reconnect","createCaller","service","procedure","timeout","transformInput","transformOutput","payload","signal","abortSignal","AbortSignal","any","callId","debug","console","groupCollapsed","log","groupEnd","callExecution","rpc","then","result","success","value","error","code","message","data","callTimeout","forAborted","catch","RequestTimeout","Promise","reject","response","race"],"mappings":"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"}

package/dist/lib/common.js

@@ -0,0 +1,9 @@
+export class ClientError extends Error {
+    code;
+    data;
+    constructor(code, message, data){
+        super(message);
+        this.code = code;
+        this.data = data;
+    }
+}

package/dist/lib/common.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/common.ts"],"sourcesContent":["export class ClientError extends Error {\n  constructor(\n    public code: string,\n    message?: string,\n    public data?: any,\n  ) {\n    super(message)\n  }\n}\n"],"names":["ClientError","Error","constructor","code","message","data"],"mappings":"AAAA,OAAO,MAAMA,oBAAoBC;;;IAC/BC,YACE,AAAOC,IAAY,EACnBC,OAAgB,EAChB,AAAOC,IAAU,CACjB;QACA,KAAK,CAACD;aAJCD,OAAAA;aAEAE,OAAAA;IAGT;AACF"}

package/dist/lib/stream.js

@@ -0,0 +1,51 @@
+export class ClientUpStream {
+    id;
+    blob;
+    reader;
+    constructor(id, blob){
+        this.id = id;
+        this.blob = blob;
+        if (this.blob.source instanceof ReadableStream === false) throw new Error('Blob source is not a ReadableStream');
+        this.reader = this.blob.source.getReader({
+            mode: 'byob'
+        });
+    }
+}
+export const createClientDownStream = (metadata, pull)=>{
+    let bytes = 0;
+    const { readable, writable } = new TransformStream({
+        start: ()=>pull,
+        transform (chunk, controller) {
+            if (metadata.size !== -1) {
+                bytes += chunk.byteLength;
+                if (bytes > metadata.size) {
+                    const error = new Error('Stream size exceeded');
+                    controller.error(error);
+                } else {
+                    try {
+                        controller.enqueue(chunk);
+                    } catch (error) {
+                        console.error(error);
+                    }
+                }
+            } else {
+                controller.enqueue(chunk);
+            }
+        }
+    }, {
+        highWaterMark: 1
+    });
+    const writer = writable.getWriter();
+    const blob = {
+        get metadata () {
+            return metadata;
+        },
+        get stream () {
+            return readable;
+        }
+    };
+    return {
+        blob,
+        writer
+    };
+};

package/dist/lib/stream.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/stream.ts"],"sourcesContent":["import type { ApiBlob, ApiBlobMetadata } from '@nmtjs/common'\nimport type { AnyFn } from './utils.ts'\n\nexport class ClientUpStream {\n  readonly reader: ReadableStreamBYOBReader\n\n  constructor(\n    readonly id: number,\n    readonly blob: ApiBlob,\n  ) {\n    if (this.blob.source instanceof ReadableStream === false)\n      throw new Error('Blob source is not a ReadableStream')\n    this.reader = this.blob.source.getReader({ mode: 'byob' })\n  }\n}\n\nexport type ClientDownStreamBlob = {\n  readonly metadata: ApiBlobMetadata\n  readonly stream: ReadableStream<Uint8Array>\n}\n\nexport type ClientDownStreamWrapper = {\n  writer: WritableStreamDefaultWriter\n  blob: ClientDownStreamBlob\n}\n\nexport const createClientDownStream = (\n  metadata: ApiBlobMetadata,\n  pull: AnyFn,\n): ClientDownStreamWrapper => {\n  let bytes = 0\n\n  const { readable, writable } = new TransformStream<Uint8Array, Uint8Array>(\n    {\n      start: () => pull,\n      transform(chunk, controller) {\n        if (metadata.size !== -1) {\n          bytes += chunk.byteLength\n          if (bytes > metadata.size) {\n            const error = new Error('Stream size exceeded')\n            controller.error(error)\n          } else {\n            try {\n              controller.enqueue(chunk)\n            } catch (error) {\n              console.error(error)\n            }\n          }\n        } else {\n          controller.enqueue(chunk)\n        }\n      },\n    },\n    { highWaterMark: 1 },\n  )\n\n  const writer = writable.getWriter()\n\n  const blob: ClientDownStreamBlob = {\n    get metadata() {\n      return metadata\n    },\n    get stream() {\n      return readable\n    },\n  }\n\n  return {\n    blob,\n    writer,\n  }\n}\n"],"names":["ClientUpStream","reader","constructor","id","blob","source","ReadableStream","Error","getReader","mode","createClientDownStream","metadata","pull","bytes","readable","writable","TransformStream","start","transform","chunk","controller","size","byteLength","error","enqueue","console","highWaterMark","writer","getWriter","stream"],"mappings":"AAGA,OAAO,MAAMA;;;IACFC,OAAgC;IAEzCC,YACE,AAASC,EAAU,EACnB,AAASC,IAAa,CACtB;aAFSD,KAAAA;aACAC,OAAAA;QAET,IAAI,IAAI,CAACA,IAAI,CAACC,MAAM,YAAYC,mBAAmB,OACjD,MAAM,IAAIC,MAAM;QAClB,IAAI,CAACN,MAAM,GAAG,IAAI,CAACG,IAAI,CAACC,MAAM,CAACG,SAAS,CAAC;YAAEC,MAAM;QAAO;IAC1D;AACF;AAYA,OAAO,MAAMC,yBAAyB,CACpCC,UACAC;IAEA,IAAIC,QAAQ;IAEZ,MAAM,EAAEC,QAAQ,EAAEC,QAAQ,EAAE,GAAG,IAAIC,gBACjC;QACEC,OAAO,IAAML;QACbM,WAAUC,KAAK,EAAEC,UAAU;YACzB,IAAIT,SAASU,IAAI,KAAK,CAAC,GAAG;gBACxBR,SAASM,MAAMG,UAAU;gBACzB,IAAIT,QAAQF,SAASU,IAAI,EAAE;oBACzB,MAAME,QAAQ,IAAIhB,MAAM;oBACxBa,WAAWG,KAAK,CAACA;gBACnB,OAAO;oBACL,IAAI;wBACFH,WAAWI,OAAO,CAACL;oBACrB,EAAE,OAAOI,OAAO;wBACdE,QAAQF,KAAK,CAACA;oBAChB;gBACF;YACF,OAAO;gBACLH,WAAWI,OAAO,CAACL;YACrB;QACF;IACF,GACA;QAAEO,eAAe;IAAE;IAGrB,MAAMC,SAASZ,SAASa,SAAS;IAEjC,MAAMxB,OAA6B;QACjC,IAAIO,YAAW;YACb,OAAOA;QACT;QACA,IAAIkB,UAAS;YACX,OAAOf;QACT;IACF;IAEA,OAAO;QACLV;QACAuB;IACF;AACF,EAAC"}

package/dist/lib/subscription.js

@@ -0,0 +1,10 @@
+import { EventEmitter } from "./utils.js";
+export class Subscription extends EventEmitter {
+    key;
+    unsubscribe;
+    constructor(key, unsubscribe){
+        super();
+        this.key = key;
+        this.unsubscribe = unsubscribe;
+    }
+}

package/dist/lib/subscription.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/subscription.ts"],"sourcesContent":["import type { TSubscriptionContract } from '@nmtjs/contract'\nimport { EventEmitter } from './utils.ts'\n\nexport class Subscription<\n  Contact extends TSubscriptionContract = TSubscriptionContract,\n> extends EventEmitter<{\n  [K in keyof Contact['events']]: [Contact['events'][K]['static']['payload']]\n}> {\n  constructor(\n    readonly key: string,\n    readonly unsubscribe: () => void,\n  ) {\n    super()\n  }\n}\n"],"names":["EventEmitter","Subscription","constructor","key","unsubscribe"],"mappings":"AACA,SAASA,YAAY,QAAQ,aAAY;AAEzC,OAAO,MAAMC,qBAEHD;;;IAGRE,YACE,AAASC,GAAW,EACpB,AAASC,WAAuB,CAChC;QACA,KAAK;aAHID,MAAAA;aACAC,cAAAA;IAGX;AACF"}

package/dist/lib/transport.js

@@ -0,0 +1,4 @@
+import { EventEmitter } from "./utils.js";
+export class ClientTransport extends EventEmitter {
+    client;
+}

package/dist/lib/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/transport.ts"],"sourcesContent":["import type { BaseClientFormat } from '@nmtjs/common'\nimport { EventEmitter, type EventMap } from './utils.ts'\n\nexport type ClientTransportRpcCall = {\n  service: string\n  procedure: string\n  callId: number\n  payload: any\n  signal: AbortSignal\n}\n\nexport type ClientTransportRpcResult =\n  | {\n      success: false\n      error: { code: string; message?: string; data?: any }\n    }\n  | {\n      success: true\n      value: any\n    }\n\nexport abstract class ClientTransport<\n  T extends EventMap = {},\n> extends EventEmitter<\n  T & { event: [service: string, event: string, payload: any] }\n> {\n  abstract type: string\n\n  client!: {\n    readonly services: string[]\n    readonly format: BaseClientFormat\n    readonly auth?: string\n  }\n\n  abstract connect(): Promise<void>\n  abstract disconnect(): Promise<void>\n  abstract rpc(\n    params: ClientTransportRpcCall,\n  ): Promise<ClientTransportRpcResult>\n}\n"],"names":["EventEmitter","ClientTransport","client"],"mappings":"AACA,SAASA,YAAY,QAAuB,aAAY;AAoBxD,OAAO,MAAeC,wBAEZD;IAKRE,OAIC;AAOH"}

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":["import type { ApiBlob, ApiBlobInterface } from '@nmtjs/common'\nimport type { ClientDownStreamBlob } from './stream.ts'\n\nexport type ClientCallOptions = {\n  signal?: AbortSignal\n}\n\nexport type InputType<T> = T extends any[]\n  ? InputType<T[number]>[]\n  : T extends ApiBlobInterface\n    ? ApiBlob\n    : T extends object\n      ? { [K in keyof T]: InputType<T[K]> }\n      : T\n\nexport type OutputType<T> = T extends any[]\n  ? OutputType<T[number]>[]\n  : T extends ApiBlobInterface\n    ? ClientDownStreamBlob\n    : T extends object\n      ? { [K in keyof T]: OutputType<T[K]> }\n      : T\n"],"names":[],"mappings":"AAeA,WAMS"}

package/dist/lib/utils.js

@@ -0,0 +1,40 @@
+export function forAborted(signal) {
+    return new Promise((_, reject)=>{
+        const handler = ()=>reject(new Error('aborted'));
+        const options = {
+            once: true
+        };
+        signal.addEventListener('abort', handler, options);
+    });
+}
+export function onAbort(signal, listener) {
+    signal.addEventListener('abort', listener, {
+        once: true
+    });
+    return ()=>signal.removeEventListener('abort', listener);
+}
+export class EventEmitter {
+    #target = new EventTarget();
+    #listeners = new Map();
+    on(event, listener, options) {
+        const wrapper = (event)=>listener(...event.detail);
+        this.#listeners.set(listener, wrapper);
+        this.#target.addEventListener(event, wrapper, options);
+        return ()=>this.#target.removeEventListener(event, wrapper);
+    }
+    once(event, listener) {
+        return this.on(event, listener, {
+            once: true
+        });
+    }
+    off(event, listener) {
+        const wrapper = this.#listeners.get(listener);
+        if (wrapper) this.#target.removeEventListener(event, wrapper);
+    }
+    emit(event, ...args) {
+        return this.#target.dispatchEvent(new CustomEvent(event, {
+            detail: args
+        }));
+    }
+}
+export const once = (ee, event)=>new Promise((resolve)=>ee.once(event, resolve));

package/dist/lib/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../lib/utils.ts"],"sourcesContent":["export type AnyFn = (...args: any[]) => any\n\nexport type EventMap = { [K: string]: any[] }\n\nexport function forAborted(signal: AbortSignal) {\n  return new Promise((_, reject) => {\n    const handler = () => reject(new Error('aborted'))\n    const options = { once: true }\n    signal.addEventListener('abort', handler, options)\n  })\n}\n\nexport function onAbort(signal: AbortSignal, listener: () => void) {\n  signal.addEventListener('abort', listener, { once: true })\n  return () => signal.removeEventListener('abort', listener)\n}\n\n/**\n * Very simple node-like event emitter wrapper around EventTarget\n *\n * @todo add errors and promise rejections handling\n */\nexport class EventEmitter<\n  Events extends EventMap = EventMap,\n  EventNames extends Extract<keyof Events, string> = Extract<\n    keyof Events,\n    string\n  >,\n> {\n  #target = new EventTarget()\n  #listeners = new Map<AnyFn, AnyFn>()\n\n  on<E extends EventNames>(\n    event: E | (Object & string),\n    listener: (...args: Events[E]) => void,\n    options?: AddEventListenerOptions,\n  ) {\n    const wrapper = (event) => listener(...event.detail)\n    this.#listeners.set(listener, wrapper)\n    this.#target.addEventListener(event, wrapper, options)\n    return () => this.#target.removeEventListener(event, wrapper)\n  }\n\n  once<E extends EventNames>(\n    event: E | (Object & string),\n    listener: (...args: Events[E]) => void,\n  ) {\n    return this.on(event, listener, { once: true })\n  }\n\n  off(event: EventNames | (Object & string), listener: AnyFn) {\n    const wrapper = this.#listeners.get(listener)\n    if (wrapper) this.#target.removeEventListener(event, wrapper)\n  }\n\n  emit<E extends EventNames | (Object & string)>(\n    event: E,\n    ...args: E extends EventEmitter ? Events[E] : any[]\n  ) {\n    return this.#target.dispatchEvent(new CustomEvent(event, { detail: args }))\n  }\n}\n\nexport const once = (ee: EventEmitter, event: string) =>\n  new Promise((resolve) => ee.once(event, resolve))\n"],"names":["forAborted","signal","Promise","_","reject","handler","Error","options","once","addEventListener","onAbort","listener","removeEventListener","EventEmitter","EventTarget","Map","on","event","wrapper","detail","set","off","get","emit","args","dispatchEvent","CustomEvent","ee","resolve"],"mappings":"AAIA,OAAO,SAASA,WAAWC,MAAmB;IAC5C,OAAO,IAAIC,QAAQ,CAACC,GAAGC;QACrB,MAAMC,UAAU,IAAMD,OAAO,IAAIE,MAAM;QACvC,MAAMC,UAAU;YAAEC,MAAM;QAAK;QAC7BP,OAAOQ,gBAAgB,CAAC,SAASJ,SAASE;IAC5C;AACF;AAEA,OAAO,SAASG,QAAQT,MAAmB,EAAEU,QAAoB;IAC/DV,OAAOQ,gBAAgB,CAAC,SAASE,UAAU;QAAEH,MAAM;IAAK;IACxD,OAAO,IAAMP,OAAOW,mBAAmB,CAAC,SAASD;AACnD;AAOA,OAAO,MAAME;IAOX,CAAA,MAAO,GAAG,IAAIC,cAAa;IAC3B,CAAA,SAAU,GAAG,IAAIC,MAAmB;IAEpCC,GACEC,KAA4B,EAC5BN,QAAsC,EACtCJ,OAAiC,EACjC;QACA,MAAMW,UAAU,CAACD,QAAUN,YAAYM,MAAME,MAAM;QACnD,IAAI,CAAC,CAAA,SAAU,CAACC,GAAG,CAACT,UAAUO;QAC9B,IAAI,CAAC,CAAA,MAAO,CAACT,gBAAgB,CAACQ,OAAOC,SAASX;QAC9C,OAAO,IAAM,IAAI,CAAC,CAAA,MAAO,CAACK,mBAAmB,CAACK,OAAOC;IACvD;IAEAV,KACES,KAA4B,EAC5BN,QAAsC,EACtC;QACA,OAAO,IAAI,CAACK,EAAE,CAACC,OAAON,UAAU;YAAEH,MAAM;QAAK;IAC/C;IAEAa,IAAIJ,KAAqC,EAAEN,QAAe,EAAE;QAC1D,MAAMO,UAAU,IAAI,CAAC,CAAA,SAAU,CAACI,GAAG,CAACX;QACpC,IAAIO,SAAS,IAAI,CAAC,CAAA,MAAO,CAACN,mBAAmB,CAACK,OAAOC;IACvD;IAEAK,KACEN,KAAQ,EACR,GAAGO,IAAgD,EACnD;QACA,OAAO,IAAI,CAAC,CAAA,MAAO,CAACC,aAAa,CAAC,IAAIC,YAAYT,OAAO;YAAEE,QAAQK;QAAK;IAC1E;AACF;AAEA,OAAO,MAAMhB,OAAO,CAACmB,IAAkBV,QACrC,IAAIf,QAAQ,CAAC0B,UAAYD,GAAGnB,IAAI,CAACS,OAAOW,UAAS"}

package/index.ts

@@ -0,0 +1,6 @@
+export * from './lib/client.ts'
+export * from './lib/common.ts'
+export * from './lib/stream.ts'
+export * from './lib/subscription.ts'
+export * from './lib/transport.ts'
+export * from './lib/utils.ts'

package/lib/client-runtime.ts

@@ -0,0 +1,142 @@
+import type {
+  Decoded,
+  TEventContract,
+  TSchema,
+  TServiceContract,
+  TSubscriptionContract,
+} from '@nmtjs/contract'
+import { type Compiled, compile } from '@nmtjs/contract/compiler'
+import { ContractGuard } from '@nmtjs/contract/guards'
+import { Client, type ClientOptions } from './client.ts'
+import type { Subscription } from './subscription.ts'
+import type { ClientCallOptions, InputType, OutputType } from './types.ts'
+
+type CompiledContract<T extends TServiceContract = TServiceContract> = {
+  compiled: Map<TSchema, Compiled>
+  contract: T
+}
+
+type ClientServices = Record<string, CompiledContract>
+
+type ClientCallers<Services extends ClientServices> = {
+  [K in keyof Services]: {
+    [P in keyof Services[K]['contract']['procedures']]: (
+      ...args: Decoded<
+        Services[K]['contract']['procedures'][P]['input']
+      > extends never
+        ? [options?: ClientCallOptions]
+        : [
+            data: InputType<
+              Decoded<Services[K]['contract']['procedures'][P]['input']>
+            >,
+            options?: ClientCallOptions,
+          ]
+    ) => Promise<
+      Services[K]['contract']['procedures'][P] extends TSubscriptionContract
+        ? {
+            payload: Decoded<
+              Services[K]['contract']['procedures'][P]['output']
+            > extends never
+              ? undefined
+              : Decoded<Services[K]['contract']['procedures'][P]['output']>
+            subscription: Subscription<Services[K]['contract']['procedures'][P]>
+          }
+        : Decoded<
+              Services[K]['contract']['procedures'][P]['static']
+            > extends never
+          ? void
+          : OutputType<
+              Decoded<Services[K]['contract']['procedures'][P]['output']>
+            >
+    >
+  }
+}
+
+export class RuntimeClient<Services extends ClientServices> extends Client {
+  #callers: ClientCallers<Services>
+
+  constructor(services: Services, options: ClientOptions) {
+    super(
+      options,
+      Object.values(services).map((s) => s.contract.name),
+    )
+
+    const callers = {} as any
+    for (const [serviceKey, serviceContract] of Object.entries(services)) {
+      if (!serviceContract.contract.transports[this.transport.type])
+        throw new Error(
+          `Transport [${this.transport.type}] not supported for service [${serviceContract.contract.name}]`,
+        )
+
+      callers[serviceKey] = {} as any
+
+      for (const procedureName in serviceContract.contract.procedures) {
+        const { input, output } =
+          serviceContract.contract.procedures[procedureName]
+
+        callers[serviceKey][procedureName] = this.createCaller(
+          serviceContract.contract.name,
+          procedureName,
+          {
+            timeout: serviceContract.contract.timeout,
+            transformInput: (data: any) => {
+              if (ContractGuard.IsNever(data)) return undefined
+              const compiled = serviceContract.compiled.get(input)!
+              const result = compiled.encode(data)
+              if (result.success) {
+                return result.value
+              } else {
+                console.dir(result.error)
+                throw new Error('Failed to encode input', {
+                  cause: result.error,
+                })
+              }
+            },
+            transformOutput: (data: any) => {
+              if (ContractGuard.IsNever(data)) return undefined
+              const compiled = serviceContract.compiled.get(output)!
+              const result = compiled.decode(data)
+              if (result.success) {
+                return result.value
+              } else {
+                console.dir(result.error)
+                throw new Error('Failed to decode output', {
+                  cause: result.error,
+                })
+              }
+            },
+          },
+        )
+      }
+    }
+    this.#callers = callers
+  }
+
+  get call() {
+    return this.#callers
+  }
+}
+
+export const compileContract = <T extends TServiceContract>(
+  contract: T,
+): CompiledContract<T> => {
+  const compiled = new Map<TSchema, Compiled>()
+  for (const procedureContract of Object.values(contract.procedures)) {
+    const { input, output, events } = procedureContract
+    if (ContractGuard.IsSubscription(procedureContract)) {
+      for (const event of Object.values(events) as TEventContract[]) {
+        compiled.set(event, compile(event))
+      }
+    }
+    compiled.set(input, compile(input))
+    compiled.set(output, compile(output))
+  }
+  for (const eventContract of Object.values(contract.events)) {
+    compiled.set(eventContract, compile(eventContract))
+  }
+
+  return {
+    compiled,
+    contract,
+  }
+}

package/lib/client-static.ts

@@ -0,0 +1,63 @@
+import type {
+  Encoded,
+  TServiceContract,
+  TSubscriptionContract,
+} from '@nmtjs/contract'
+import { Client, type ClientOptions } from './client.ts'
+import type { Subscription } from './subscription.ts'
+import type { ClientCallOptions, InputType, OutputType } from './types.ts'
+
+type ClientServices = Record<string, TServiceContract>
+
+type ClientCallers<Services extends ClientServices> = {
+  [K in keyof Services]: {
+    [P in keyof Services[K]['procedures']]: (
+      ...args: Encoded<Services[K]['procedures'][P]['input']> extends never
+        ? [options?: ClientCallOptions]
+        : [
+            data: InputType<Encoded<Services[K]['procedures'][P]['input']>>,
+            options?: ClientCallOptions,
+          ]
+    ) => Promise<
+      Services[K]['procedures'][P] extends TSubscriptionContract
+        ? {
+            payload: Encoded<
+              Services[K]['procedures'][P]['output']
+            > extends never
+              ? undefined
+              : Encoded<Services[K]['procedures'][P]['output']>
+            subscription: Subscription<Services[K]['procedures'][P]>
+          }
+        : Encoded<Services[K]['procedures'][P]['static']> extends never
+          ? void
+          : OutputType<Encoded<Services[K]['procedures'][P]['output']>>
+    >
+  }
+}
+
+export class StaticClient<Services extends ClientServices> extends Client {
+  #callers: ClientCallers<Services>
+
+  constructor(
+    services: { [K in keyof Services]: Services[K]['name'] },
+    options: ClientOptions,
+  ) {
+    super(options, Object.values(services))
+
+    const callers = {} as any
+
+    for (const [serviceKey, serviceName] of Object.entries(services)) {
+      callers[serviceKey] = new Proxy(Object(), {
+        get: (target, prop, receiver) => {
+          return this.createCaller(serviceName, prop as string)
+        },
+      })
+    }
+
+    this.#callers = callers
+  }
+
+  get call() {
+    return this.#callers
+  }
+}

package/lib/client.ts

@@ -0,0 +1,134 @@
+import { type BaseClientFormat, ErrorCode } from '@nmtjs/common'
+
+import { ClientError } from './common.ts'
+import type { ClientTransport } from './transport.ts'
+import type { ClientCallOptions } from './types.ts'
+import * as utils from './utils.ts'
+
+export type ClientOptions = {
+  defaultTimeout: number
+  debug?: boolean
+}
+
+export abstract class Client extends utils.EventEmitter {
+  protected transport!: ClientTransport
+  protected format!: BaseClientFormat
+
+  auth?: string
+
+  private ids = {
+    call: 0,
+    stream: 0,
+  }
+
+  constructor(
+    protected readonly options: ClientOptions,
+    protected services: string[],
+  ) {
+    super()
+    if (!options.defaultTimeout) options.defaultTimeout = 15000
+  }
+
+  useTransport<T extends new (...args: any[]) => ClientTransport>(
+    transportClass: T,
+    ...options: ConstructorParameters<T>
+  ) {
+    this.transport = new transportClass(...options)
+    this.transport.client = Object.freeze({
+      services: this.services,
+      format: this.format,
+      auth: this.auth,
+    })
+    return this as Omit<this, 'useTransport'>
+  }
+
+  useFormat(format: BaseClientFormat) {
+    this.format = format
+    return this as Omit<this, 'useFormat'>
+  }
+
+  async connect() {
+    await this.transport.connect()
+  }
+
+  async disconnect() {
+    await this.transport.disconnect()
+  }
+
+  async reconnect() {
+    await this.disconnect()
+    await this.connect()
+  }
+
+  protected createCaller(
+    service: string,
+    procedure: string,
+    {
+      timeout = this.options.defaultTimeout,
+      transformInput,
+      transformOutput,
+    }: {
+      timeout?: number
+      transformInput?: (input: any) => any
+      transformOutput?: (output: any) => any
+    } = {},
+  ) {
+    return async (payload: any, options: ClientCallOptions = {}) => {
+      const { signal } = options
+
+      const abortSignal = signal
+        ? AbortSignal.any([signal, AbortSignal.timeout(timeout)])
+        : AbortSignal.timeout(timeout)
+
+      const callId = ++this.ids.call
+
+      if (this.options.debug) {
+        console.groupCollapsed(`RPC [${callId}] ${service}/${procedure}`)
+        console.log(payload)
+        console.groupEnd()
+      }
+
+      const callExecution = this.transport
+        .rpc({
+          callId,
+          service,
+          procedure,
+          payload: transformInput ? transformInput(payload) : payload,
+          signal: abortSignal,
+        })
+        .then((result) => {
+          if (result.success) return result.value
+          throw new ClientError(
+            result.error.code,
+            result.error.message,
+            result.error.data,
+          )
+        })
+
+      const callTimeout = utils.forAborted(abortSignal).catch(() => {
+        const error = new ClientError(ErrorCode.RequestTimeout)
+        return Promise.reject(error)
+      })
+
+      try {
+        const response = await Promise.race([callTimeout, callExecution])
+
+        if (this.options.debug) {
+          console.groupCollapsed(`RPC [${callId}] Success`)
+          console.log(response)
+          console.groupEnd()
+        }
+
+        return transformOutput ? transformOutput(response) : response
+      } catch (error) {
+        if (this.options.debug) {
+          console.groupCollapsed(`RPC [${callId}] Error`)
+          console.log(error)
+          console.groupEnd()
+        }
+
+        throw error
+      }
+    }
+  }
+}

package/lib/common.ts

@@ -0,0 +1,9 @@
+export class ClientError extends Error {
+  constructor(
+    public code: string,
+    message?: string,
+    public data?: any,
+  ) {
+    super(message)
+  }
+}

package/lib/stream.ts

@@ -0,0 +1,72 @@
+import type { ApiBlob, ApiBlobMetadata } from '@nmtjs/common'
+import type { AnyFn } from './utils.ts'
+
+export class ClientUpStream {
+  readonly reader: ReadableStreamBYOBReader
+
+  constructor(
+    readonly id: number,
+    readonly blob: ApiBlob,
+  ) {
+    if (this.blob.source instanceof ReadableStream === false)
+      throw new Error('Blob source is not a ReadableStream')
+    this.reader = this.blob.source.getReader({ mode: 'byob' })
+  }
+}
+
+export type ClientDownStreamBlob = {
+  readonly metadata: ApiBlobMetadata
+  readonly stream: ReadableStream<Uint8Array>
+}
+
+export type ClientDownStreamWrapper = {
+  writer: WritableStreamDefaultWriter
+  blob: ClientDownStreamBlob
+}
+
+export const createClientDownStream = (
+  metadata: ApiBlobMetadata,
+  pull: AnyFn,
+): ClientDownStreamWrapper => {
+  let bytes = 0
+
+  const { readable, writable } = new TransformStream<Uint8Array, Uint8Array>(
+    {
+      start: () => pull,
+      transform(chunk, controller) {
+        if (metadata.size !== -1) {
+          bytes += chunk.byteLength
+          if (bytes > metadata.size) {
+            const error = new Error('Stream size exceeded')
+            controller.error(error)
+          } else {
+            try {
+              controller.enqueue(chunk)
+            } catch (error) {
+              console.error(error)
+            }
+          }
+        } else {
+          controller.enqueue(chunk)
+        }
+      },
+    },
+    { highWaterMark: 1 },
+  )
+
+  const writer = writable.getWriter()
+
+  const blob: ClientDownStreamBlob = {
+    get metadata() {
+      return metadata
+    },
+    get stream() {
+      return readable
+    },
+  }
+
+  return {
+    blob,
+    writer,
+  }
+}

package/lib/subscription.ts

@@ -0,0 +1,15 @@
+import type { TSubscriptionContract } from '@nmtjs/contract'
+import { EventEmitter } from './utils.ts'
+
+export class Subscription<
+  Contact extends TSubscriptionContract = TSubscriptionContract,
+> extends EventEmitter<{
+  [K in keyof Contact['events']]: [Contact['events'][K]['static']['payload']]
+}> {
+  constructor(
+    readonly key: string,
+    readonly unsubscribe: () => void,
+  ) {
+    super()
+  }
+}

package/lib/transport.ts

@@ -0,0 +1,40 @@
+import type { BaseClientFormat } from '@nmtjs/common'
+import { EventEmitter, type EventMap } from './utils.ts'
+
+export type ClientTransportRpcCall = {
+  service: string
+  procedure: string
+  callId: number
+  payload: any
+  signal: AbortSignal
+}
+
+export type ClientTransportRpcResult =
+  | {
+      success: false
+      error: { code: string; message?: string; data?: any }
+    }
+  | {
+      success: true
+      value: any
+    }
+
+export abstract class ClientTransport<
+  T extends EventMap = {},
+> extends EventEmitter<
+  T & { event: [service: string, event: string, payload: any] }
+> {
+  abstract type: string
+
+  client!: {
+    readonly services: string[]
+    readonly format: BaseClientFormat
+    readonly auth?: string
+  }
+
+  abstract connect(): Promise<void>
+  abstract disconnect(): Promise<void>
+  abstract rpc(
+    params: ClientTransportRpcCall,
+  ): Promise<ClientTransportRpcResult>
+}

package/lib/types.ts

@@ -0,0 +1,22 @@
+import type { ApiBlob, ApiBlobInterface } from '@nmtjs/common'
+import type { ClientDownStreamBlob } from './stream.ts'
+
+export type ClientCallOptions = {
+  signal?: AbortSignal
+}
+
+export type InputType<T> = T extends any[]
+  ? InputType<T[number]>[]
+  : T extends ApiBlobInterface
+    ? ApiBlob
+    : T extends object
+      ? { [K in keyof T]: InputType<T[K]> }
+      : T
+
+export type OutputType<T> = T extends any[]
+  ? OutputType<T[number]>[]
+  : T extends ApiBlobInterface
+    ? ClientDownStreamBlob
+    : T extends object
+      ? { [K in keyof T]: OutputType<T[K]> }
+      : T

package/lib/utils.ts

@@ -0,0 +1,65 @@
+export type AnyFn = (...args: any[]) => any
+
+export type EventMap = { [K: string]: any[] }
+
+export function forAborted(signal: AbortSignal) {
+  return new Promise((_, reject) => {
+    const handler = () => reject(new Error('aborted'))
+    const options = { once: true }
+    signal.addEventListener('abort', handler, options)
+  })
+}
+
+export function onAbort(signal: AbortSignal, listener: () => void) {
+  signal.addEventListener('abort', listener, { once: true })
+  return () => signal.removeEventListener('abort', listener)
+}
+
+/**
+ * Very simple node-like event emitter wrapper around EventTarget
+ *
+ * @todo add errors and promise rejections handling
+ */
+export class EventEmitter<
+  Events extends EventMap = EventMap,
+  EventNames extends Extract<keyof Events, string> = Extract<
+    keyof Events,
+    string
+  >,
+> {
+  #target = new EventTarget()
+  #listeners = new Map<AnyFn, AnyFn>()
+
+  on<E extends EventNames>(
+    event: E | (Object & string),
+    listener: (...args: Events[E]) => void,
+    options?: AddEventListenerOptions,
+  ) {
+    const wrapper = (event) => listener(...event.detail)
+    this.#listeners.set(listener, wrapper)
+    this.#target.addEventListener(event, wrapper, options)
+    return () => this.#target.removeEventListener(event, wrapper)
+  }
+
+  once<E extends EventNames>(
+    event: E | (Object & string),
+    listener: (...args: Events[E]) => void,
+  ) {
+    return this.on(event, listener, { once: true })
+  }
+
+  off(event: EventNames | (Object & string), listener: AnyFn) {
+    const wrapper = this.#listeners.get(listener)
+    if (wrapper) this.#target.removeEventListener(event, wrapper)
+  }
+
+  emit<E extends EventNames | (Object & string)>(
+    event: E,
+    ...args: E extends EventEmitter ? Events[E] : any[]
+  ) {
+    return this.#target.dispatchEvent(new CustomEvent(event, { detail: args }))
+  }
+}
+
+export const once = (ee: EventEmitter, event: string) =>
+  new Promise((resolve) => ee.once(event, resolve))

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@nmtjs/client",
+  "type": "module",
+  "exports": {
+    ".": {
+      "bun": "./index.ts",
+      "default": "./dist/index.js",
+      "types": "./index.ts"
+    },
+    "./runtime": {
+      "bun": "./lib/client-runtime.ts",
+      "default": "./dist/lib/client-runtime.js",
+      "types": "./lib/client-runtime.ts"
+    },
+    "./static": {
+      "bun": "./lib/client-static.ts",
+      "default": "./dist/lib/client-static.js",
+      "types": "./lib/client-static.ts"
+    }
+  },
+  "peerDependencies": {
+    "@nmtjs/contract": "0.0.1",
+    "@nmtjs/common": "0.0.1"
+  },
+  "devDependencies": {
+    "@nmtjs/contract": "0.0.1",
+    "@nmtjs/common": "0.0.1"
+  },
+  "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"
+}