@nmtjs/http-client 0.15.0-beta.37 → 0.15.0-beta.39

package/LICENSE.md

@@ -1,4 +1,4 @@
-Copyright (c) 2024 Denis Ilchyshyn
+Copyright (c) 2025 Denys 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:
 

package/README.md

@@ -6,4 +6,4 @@
 - binary data streaming and event subscriptions
 - contract-based API
 - end-to-end type safety
-- CPU-intensive task execution on separate workers
+- CPU-intensive task execution on separate workers

package/dist/index.d.ts

@@ -1,22 +1,53 @@
-import type { ClientMessageType } from '@nmtjs/protocol';
-import type { BaseProtocol, ProtocolBaseClientCallOptions, ProtocolBaseTransformer, ProtocolClientCall, ProtocolSendMetadata } from '@nmtjs/protocol/client';
-import { ProtocolTransport, ProtocolTransportStatus } from '@nmtjs/protocol/client';
+import type { ClientTransport, ClientTransportFactory, ClientTransportMessageOptions, ClientTransportRpcParams } from '@nmtjs/client';
+import type { ProtocolVersion } from '@nmtjs/protocol';
+import type { BaseClientFormat } from '@nmtjs/protocol/client';
+import { ConnectionType } from '@nmtjs/protocol';
+type DecodeBase64Function = (data: string) => ArrayBufferView;
 export type HttpClientTransportOptions = {
     /**
      * The origin of the server
      * @example 'http://localhost:3000'
      */
-    origin: string;
+    url: string;
     debug?: boolean;
+    EventSource?: typeof EventSource;
+    decodeBase64?: DecodeBase64Function;
 };
-export declare class HttpClientTransport extends ProtocolTransport<HttpClientTransportOptions> {
-    #private;
-    protected readonly protocol: BaseProtocol;
-    protected readonly options: HttpClientTransportOptions;
-    status: ProtocolTransportStatus;
-    constructor(protocol: BaseProtocol, options: HttpClientTransportOptions);
-    call(procedure: string, payload: any, options: ProtocolBaseClientCallOptions, transformer: ProtocolBaseTransformer): Promise<ProtocolClientCall>;
-    connect(auth: any): Promise<void>;
-    disconnect(): Promise<void>;
-    send(_messageType: ClientMessageType, _buffer: ArrayBuffer, _metadata: ProtocolSendMetadata): Promise<void>;
+export declare class HttpTransportClient implements ClientTransport<ConnectionType.Unidirectional> {
+    protected readonly format: BaseClientFormat;
+    protected readonly protocol: ProtocolVersion;
+    protected options: HttpClientTransportOptions;
+    type: ConnectionType.Unidirectional;
+    decodeBase64: DecodeBase64Function;
+    constructor(format: BaseClientFormat, protocol: ProtocolVersion, options: HttpClientTransportOptions);
+    url({ procedure, application, payload }: {
+        procedure: string;
+        application?: string;
+        payload?: unknown;
+    }): URL;
+    call(client: ClientTransportRpcParams, rpc: {
+        callId: number;
+        procedure: string;
+        payload: unknown;
+    }, options: ClientTransportMessageOptions): Promise<{
+        type: "rpc_stream";
+        stream: ReadableStream<ArrayBufferView<ArrayBufferLike>>;
+    } | {
+        type: "blob";
+        metadata: {
+            type: string;
+            size: number | undefined;
+            filename: string | undefined;
+        };
+        source: ReadableStream<Uint8Array<ArrayBuffer>>;
+        result?: undefined;
+    } | {
+        metadata?: undefined;
+        source?: undefined;
+        type: "rpc";
+        result: Uint8Array<ArrayBuffer>;
+    }>;
 }
+export type HttpTransportFactory = ClientTransportFactory<ConnectionType.Unidirectional, HttpClientTransportOptions, HttpTransportClient>;
+export declare const HttpTransportFactory: HttpTransportFactory;
+export {};

package/dist/index.js

@@ -1,84 +1,137 @@
-import { ClientError } from '@nmtjs/client';
-import { ErrorCode, ProtocolBlob } from '@nmtjs/protocol';
-import { ProtocolServerBlobStream, ProtocolTransport, ProtocolTransportStatus, } from '@nmtjs/protocol/client';
-export class HttpClientTransport extends ProtocolTransport {
+import { createFuture } from '@nmtjs/common';
+import { ConnectionType, ErrorCode, ProtocolBlob } from '@nmtjs/protocol';
+import { ProtocolError } from '@nmtjs/protocol/client';
+const createDecodeBase64 = (customFn) => {
+    return (string) => {
+        if ('fromBase64' in Uint8Array &&
+            typeof Uint8Array.fromBase64 === 'function') {
+            return Uint8Array.fromBase64(string);
+        }
+        else if (typeof atob === 'function') {
+            return Uint8Array.from(atob(string), (c) => c.charCodeAt(0));
+        }
+        else if (customFn) {
+            return customFn(string);
+        }
+        else {
+            throw new Error('No base64 decoding function available');
+        }
+    };
+};
+const NEEMATA_BLOB_HEADER = 'X-Neemata-Blob';
+export class HttpTransportClient {
+    format;
     protocol;
     options;
-    #auth = null;
-    status = ProtocolTransportStatus.CONNECTED;
-    constructor(protocol, options) {
-        super();
+    type = ConnectionType.Unidirectional;
+    decodeBase64;
+    constructor(format, protocol, options) {
+        this.format = format;
         this.protocol = protocol;
         this.options = options;
+        this.options = { debug: false, ...options };
+        this.decodeBase64 = createDecodeBase64(options.decodeBase64);
     }
-    async call(procedure, payload, options, transformer) {
-        const call = this.protocol.createCall(procedure, options);
-        const headers = new Headers();
-        headers.set('Content-Type', this.protocol.contentType);
-        headers.set('Accept', this.protocol.contentType);
-        if (this.#auth)
-            headers.set('Authorization', this.#auth);
-        const isBlob = payload instanceof ProtocolBlob;
-        if (isBlob)
-            headers.set('x-neemata-blob', 'true');
-        const response = fetch(`${this.options.origin}/api/${procedure}`, {
-            method: 'POST',
-            headers,
-            credentials: 'include',
-            body: isBlob
-                ? payload.source
-                : this.protocol.format.encode(transformer.encodeRPC(procedure, payload)),
-            signal: call.signal,
-            // @ts-expect-error
-            duplex: 'half',
-        });
-        response
-            .catch((error) => Promise.reject(new Error('Network error', { cause: error })))
-            .then((response) => {
-            const isBlob = response.headers.get('x-neemata-blob') === 'true';
-            if (isBlob) {
-                const contentLength = response.headers.get('content-length');
-                const size = contentLength
-                    ? Number.parseInt(contentLength, 10) || undefined
-                    : undefined;
-                const type = response.headers.get('content-type') || 'application/octet-stream';
-                const stream = new ProtocolServerBlobStream(-1, { size, type });
-                response.body?.pipeThrough(stream);
-                return stream;
+    url({ procedure, application, payload, }) {
+        const base = application ? `/${application}/${procedure}` : `/${procedure}`;
+        const url = new URL(base, this.options.url);
+        if (payload)
+            url.searchParams.set('payload', JSON.stringify(payload));
+        return url;
+    }
+    async call(client, rpc, options) {
+        const { procedure, payload } = rpc;
+        const requestHeaders = new Headers();
+        const url = this.url({ application: client.application, procedure });
+        if (client.auth)
+            requestHeaders.set('Authorization', client.auth);
+        let body;
+        if (payload instanceof ProtocolBlob) {
+            requestHeaders.set('Content-Type', payload.metadata.type);
+            requestHeaders.set(NEEMATA_BLOB_HEADER, 'true');
+        }
+        else {
+            requestHeaders.set('Content-Type', client.format.contentType);
+            const buffer = client.format.encode(payload);
+            body = buffer;
+        }
+        if (options._stream_response) {
+            const _constructor = this.options.EventSource
+                ? this.options.EventSource
+                : EventSource;
+            const source = new _constructor(url.toString(), { withCredentials: true });
+            const future = createFuture();
+            const { readable, writable } = new TransformStream();
+            const writer = writable.getWriter();
+            source.addEventListener('open', () => future.resolve({ type: 'rpc_stream', stream: readable }));
+            source.addEventListener('close', () => writable.close());
+            source.addEventListener('error', (event) => {
+                const error = new Error('Stream error', { cause: event });
+                future.reject(error);
+                writable.abort(error);
+            });
+            source.addEventListener('message', (event) => {
+                try {
+                    const buffer = this.decodeBase64(event.data);
+                    writer.write(buffer);
+                }
+                catch (cause) {
+                    const error = new Error('Failed to decode stream message', { cause });
+                    writable.abort(error);
+                    source.close();
+                }
+            });
+            return future.promise;
+        }
+        else {
+            const response = await fetch(url.toString(), {
+                body,
+                method: 'POST',
+                headers: requestHeaders,
+                signal: options.signal,
+                credentials: 'include',
+                keepalive: true,
+            });
+            if (response.ok) {
+                const isBlob = !!response.headers.get(NEEMATA_BLOB_HEADER);
+                if (isBlob) {
+                    const contentLength = response.headers.get('content-length');
+                    const size = (contentLength && Number.parseInt(contentLength, 10)) || undefined;
+                    const type = response.headers.get('content-type') || 'application/octet-stream';
+                    const disposition = response.headers.get('content-disposition');
+                    let filename;
+                    if (disposition) {
+                        const match = disposition.match(/filename="?([^"]+)"?/);
+                        if (match)
+                            filename = match[1];
+                    }
+                    return {
+                        type: 'blob',
+                        metadata: { type, size, filename },
+                        source: response.body,
+                    };
+                }
+                else {
+                    return { type: 'rpc', result: await response.bytes() };
+                }
             }
             else {
-                const body = response.arrayBuffer();
-                return body.then((buffer) => {
-                    if (response.ok) {
-                        const decoded = this.protocol.format.decode(buffer);
-                        return transformer.decodeRPC(procedure, decoded);
-                    }
-                    else {
-                        if (buffer.byteLength === 0) {
-                            const error = new ClientError(ErrorCode.InternalServerError, `Empty response with ${response.status} status code`);
-                            return Promise.reject(error);
-                        }
-                        else {
-                            const payload = this.protocol.format.decode(buffer);
-                            const error = new ClientError(payload.code, payload.message, payload.data);
-                            return Promise.reject(error);
-                        }
-                    }
-                });
+                try {
+                    const buffer = await response.bytes();
+                    const error = client.format.decode(buffer);
+                    throw new ProtocolError(error.code || ErrorCode.ClientRequestError, error.message || response.statusText, error.data);
+                }
+                catch (cause) {
+                    if (cause instanceof ProtocolError)
+                        throw cause;
+                    // If decoding fails, throw generic error with status info
+                    throw new ProtocolError(ErrorCode.ClientRequestError, `HTTP ${response.status}: ${response.statusText}`);
+                }
             }
-        })
-            .then(call.resolve)
-            .catch(call.reject);
-        return call;
-    }
-    async connect(auth) {
-        this.#auth = auth;
-        this.emit('connected');
-    }
-    async disconnect() {
-        this.emit('disconnected', 'client');
-    }
-    async send(_messageType, _buffer, _metadata) {
-        throw new Error('Not supported');
+        }
     }
 }
+export const HttpTransportFactory = (params, options) => {
+    return new HttpTransportClient(params.format, params.protocol, options);
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -1,5 +1,6 @@
 {
   "name": "@nmtjs/http-client",
+  "description": "HTTP client transport for Neemata.",
   "type": "module",
   "exports": {
     ".": {
@@ -9,23 +10,23 @@
     }
   },
   "dependencies": {
-    "@nmtjs/client": "0.15.0-beta.37",
-    "@nmtjs/common": "0.15.0-beta.37",
-    "@nmtjs/protocol": "0.15.0-beta.37"
+    "@nmtjs/client": "0.15.0-beta.39",
+    "@nmtjs/common": "0.15.0-beta.39",
+    "@nmtjs/protocol": "0.15.0-beta.39"
   },
   "peerDependencies": {
-    "@nmtjs/client": "0.15.0-beta.37",
-    "@nmtjs/protocol": "0.15.0-beta.37",
-    "@nmtjs/common": "0.15.0-beta.37"
+    "@nmtjs/client": "0.15.0-beta.39",
+    "@nmtjs/common": "0.15.0-beta.39",
+    "@nmtjs/protocol": "0.15.0-beta.39"
   },
   "files": [
     "dist",
+    "src",
     "LICENSE.md",
     "README.md"
   ],
-  "version": "0.15.0-beta.37",
+  "version": "0.15.0-beta.39",
   "scripts": {
-    "build": "tsc",
-    "type-check": "tsc --noEmit"
+    "clean-build": "rm -rf ./dist"
   }
 }

package/src/index.ts

@@ -0,0 +1,197 @@
+import type {
+  ClientTransport,
+  ClientTransportFactory,
+  ClientTransportMessageOptions,
+  ClientTransportRpcParams,
+} from '@nmtjs/client'
+import type { ProtocolVersion } from '@nmtjs/protocol'
+import type { BaseClientFormat } from '@nmtjs/protocol/client'
+import { createFuture } from '@nmtjs/common'
+import { ConnectionType, ErrorCode, ProtocolBlob } from '@nmtjs/protocol'
+import { ProtocolError } from '@nmtjs/protocol/client'
+
+type DecodeBase64Function = (data: string) => ArrayBufferView
+
+const createDecodeBase64 = (
+  customFn?: DecodeBase64Function,
+): DecodeBase64Function => {
+  return (string: string) => {
+    if (
+      'fromBase64' in Uint8Array &&
+      typeof Uint8Array.fromBase64 === 'function'
+    ) {
+      return Uint8Array.fromBase64(string)
+    } else if (typeof atob === 'function') {
+      return Uint8Array.from(atob(string), (c) => c.charCodeAt(0))
+    } else if (customFn) {
+      return customFn(string)
+    } else {
+      throw new Error('No base64 decoding function available')
+    }
+  }
+}
+
+const NEEMATA_BLOB_HEADER = 'X-Neemata-Blob'
+
+export type HttpClientTransportOptions = {
+  /**
+   * The origin of the server
+   * @example 'http://localhost:3000'
+   */
+  url: string
+  debug?: boolean
+  EventSource?: typeof EventSource
+  decodeBase64?: DecodeBase64Function
+}
+
+export class HttpTransportClient
+  implements ClientTransport<ConnectionType.Unidirectional>
+{
+  type: ConnectionType.Unidirectional = ConnectionType.Unidirectional
+  decodeBase64: DecodeBase64Function
+
+  constructor(
+    protected readonly format: BaseClientFormat,
+    protected readonly protocol: ProtocolVersion,
+    protected options: HttpClientTransportOptions,
+  ) {
+    this.options = { debug: false, ...options }
+    this.decodeBase64 = createDecodeBase64(options.decodeBase64)
+  }
+
+  url({
+    procedure,
+    application,
+    payload,
+  }: {
+    procedure: string
+    application?: string
+    payload?: unknown
+  }) {
+    const base = application ? `/${application}/${procedure}` : `/${procedure}`
+    const url = new URL(base, this.options.url)
+    if (payload) url.searchParams.set('payload', JSON.stringify(payload))
+    return url
+  }
+
+  async call(
+    client: ClientTransportRpcParams,
+    rpc: { callId: number; procedure: string; payload: unknown },
+    options: ClientTransportMessageOptions,
+  ) {
+    const { procedure, payload } = rpc
+    const requestHeaders = new Headers()
+
+    const url = this.url({ application: client.application, procedure })
+
+    if (client.auth) requestHeaders.set('Authorization', client.auth)
+
+    let body: any
+
+    if (payload instanceof ProtocolBlob) {
+      requestHeaders.set('Content-Type', payload.metadata.type)
+      requestHeaders.set(NEEMATA_BLOB_HEADER, 'true')
+    } else {
+      requestHeaders.set('Content-Type', client.format.contentType)
+      const buffer = client.format.encode(payload)
+      body = buffer
+    }
+
+    if (options._stream_response) {
+      const _constructor = this.options.EventSource
+        ? this.options.EventSource
+        : EventSource
+      const source = new _constructor(url.toString(), { withCredentials: true })
+      const future = createFuture<{
+        type: 'rpc_stream'
+        stream: ReadableStream<ArrayBufferView>
+      }>()
+      const { readable, writable } = new TransformStream()
+      const writer = writable.getWriter()
+      source.addEventListener('open', () =>
+        future.resolve({ type: 'rpc_stream', stream: readable }),
+      )
+      source.addEventListener('close', () => writable.close())
+      source.addEventListener('error', (event) => {
+        const error = new Error('Stream error', { cause: event })
+        future.reject(error)
+        writable.abort(error)
+      })
+      source.addEventListener('message', (event) => {
+        try {
+          const buffer = this.decodeBase64(event.data)
+          writer.write(buffer)
+        } catch (cause) {
+          const error = new Error('Failed to decode stream message', { cause })
+          writable.abort(error)
+          source.close()
+        }
+      })
+      return future.promise
+    } else {
+      const response = await fetch(url.toString(), {
+        body,
+        method: 'POST',
+        headers: requestHeaders,
+        signal: options.signal,
+        credentials: 'include',
+        keepalive: true,
+      })
+
+      if (response.ok) {
+        const isBlob = !!response.headers.get(NEEMATA_BLOB_HEADER)
+        if (isBlob) {
+          const contentLength = response.headers.get('content-length')
+          const size =
+            (contentLength && Number.parseInt(contentLength, 10)) || undefined
+          const type =
+            response.headers.get('content-type') || 'application/octet-stream'
+          const disposition = response.headers.get('content-disposition')
+          let filename: string | undefined
+          if (disposition) {
+            const match = disposition.match(/filename="?([^"]+)"?/)
+            if (match) filename = match[1]
+          }
+          return {
+            type: 'blob' as const,
+            metadata: { type, size, filename },
+            source: response.body!,
+          }
+        } else {
+          return { type: 'rpc' as const, result: await response.bytes() }
+        }
+      } else {
+        try {
+          const buffer = await response.bytes()
+          const error = client.format.decode(buffer) as {
+            code?: string
+            message?: string
+            data?: unknown
+          }
+          throw new ProtocolError(
+            error.code || ErrorCode.ClientRequestError,
+            error.message || response.statusText,
+            error.data,
+          )
+        } catch (cause) {
+          if (cause instanceof ProtocolError) throw cause
+          // If decoding fails, throw generic error with status info
+          throw new ProtocolError(
+            ErrorCode.ClientRequestError,
+            `HTTP ${response.status}: ${response.statusText}`,
+          )
+        }
+      }
+    }
+  }
+}
+
+export type HttpTransportFactory = ClientTransportFactory<
+  ConnectionType.Unidirectional,
+  HttpClientTransportOptions,
+  HttpTransportClient
+>
+
+export const HttpTransportFactory: HttpTransportFactory = (params, options) => {
+  return new HttpTransportClient(params.format, params.protocol, options)
+}