@kultify/kmicro-js 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kultify
+
+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,2 @@
+# kmicro-js
+Simple microservice framework based on nats micro

package/dist/index.cjs

@@ -0,0 +1,264 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var src_exports = {};
+__export(src_exports, {
+  CallError: () => CallError,
+  Kmicro: () => Kmicro,
+  RequestContext: () => RequestContext,
+  init: () => init
+});
+module.exports = __toCommonJS(src_exports);
+
+// src/KMicro.ts
+var import_node_assert = __toESM(require("assert"), 1);
+var import_services = require("@nats-io/services");
+var import_transport_node = require("@nats-io/transport-node");
+var import_api = require("@opentelemetry/api");
+var import_exporter_trace_otlp_proto = require("@opentelemetry/exporter-trace-otlp-proto");
+var import_resources = require("@opentelemetry/resources");
+var import_sdk_node = require("@opentelemetry/sdk-node");
+var import_incubating = require("@opentelemetry/semantic-conventions/incubating");
+async function init(nats, serviceName, version, description) {
+  const kmicro = new Kmicro({
+    name: serviceName,
+    version,
+    description
+  });
+  await kmicro.init(nats);
+  return kmicro;
+}
+var codec = (0, import_transport_node.JSONCodec)();
+var Kmicro = class {
+  constructor(meta) {
+    this.meta = meta;
+  }
+  service;
+  group;
+  nc;
+  otel;
+  async init(natsConnection) {
+    this.nc = await (0, import_transport_node.connect)({
+      name: this.meta.name,
+      servers: natsConnection
+    });
+    const svc = new import_services.Svc(this.nc);
+    this.service = await svc.add({
+      name: this.meta.name,
+      version: this.meta.version,
+      description: this.meta.description
+    });
+    this.group = this.service.addGroup(this.meta.name);
+    this.otel = new import_sdk_node.NodeSDK({
+      serviceName: this.meta.name,
+      traceExporter: new import_exporter_trace_otlp_proto.OTLPTraceExporter(),
+      resource: new import_resources.Resource({
+        [import_incubating.ATTR_SERVICE_NAME]: this.meta.name,
+        [import_incubating.ATTR_MESSAGING_SYSTEM]: "nats"
+      })
+    });
+    this.otel.start();
+  }
+  async stop() {
+    await this.service?.stop().catch((error) => {
+      console.error(error);
+    });
+    await this.nc?.close().catch((error) => {
+      console.error(error);
+    });
+    await this.otel?.shutdown().catch((error) => {
+      console.error(error);
+    });
+  }
+  addEndpoint(name, handler) {
+    (0, import_node_assert.default)(this.group);
+    this.group.addEndpoint(name, async (error, message) => {
+      (0, import_node_assert.default)(this.nc);
+      if (error) {
+        console.error(error);
+        return;
+      }
+      const currentCallDepth = Number.parseInt(
+        message.headers?.get("kmc-depth") ?? "0",
+        10
+      );
+      if (currentCallDepth >= 20) {
+        throw new Error("max call depth reached: " + currentCallDepth);
+      }
+      const contextWithOtel = import_api.propagation.extract(
+        import_api.context.active(),
+        message.headers,
+        {
+          get(carrier, key) {
+            return carrier?.get(key);
+          },
+          keys(carrier) {
+            return carrier?.keys() ?? [];
+          }
+        }
+      );
+      const tracer = import_api.trace.getTracer(name, this.meta.version);
+      const spanName = `handle: ${this.meta.name}.${name}`;
+      await tracer.startActiveSpan(
+        spanName,
+        {
+          kind: import_api.SpanKind.SERVER
+        },
+        contextWithOtel,
+        async (span) => {
+          try {
+            const requestContext = new RequestContext(
+              contextWithOtel,
+              span,
+              this.nc,
+              {
+                callDepth: currentCallDepth,
+                currentService: this.meta.name
+              }
+            );
+            const result = await handler(requestContext, message.json());
+            message.respond(codec.encode(result));
+            span.setStatus({ code: import_api.SpanStatusCode.OK });
+          } catch (error_) {
+            span.recordException(error_);
+            message.respondError(500, error_.message);
+            span.setStatus({ code: import_api.SpanStatusCode.ERROR });
+          } finally {
+            span.end();
+          }
+        }
+      );
+    });
+  }
+  /**
+   * Start a new call
+   */
+  async call(target, payload, options) {
+    (0, import_node_assert.default)(this.nc);
+    return doCall(
+      this.nc,
+      target,
+      payload,
+      {
+        callDepth: 0,
+        context: void 0,
+        currentService: this.meta.name
+      },
+      options
+    );
+  }
+};
+var RequestContext = class {
+  constructor(context2, span, nc, meta) {
+    this.context = context2;
+    this.span = span;
+    this.nc = nc;
+    this.meta = meta;
+  }
+  async call(target, payload, options) {
+    return doCall(
+      this.nc,
+      target,
+      payload,
+      {
+        callDepth: this.meta.callDepth,
+        context: this.context,
+        currentService: this.meta.currentService
+      },
+      options
+    );
+  }
+};
+var CallError = class extends Error {
+  constructor(message, target, payload) {
+    super(message);
+    this.target = target;
+    this.payload = payload;
+    this.name = "CallError";
+  }
+};
+async function doCall(nc, target, payload, meta, options) {
+  if (meta.callDepth >= 20) {
+    throw new Error("max call depth reached: " + meta.callDepth);
+  }
+  const callingContext = import_api.propagation.extract(
+    import_api.context.active(),
+    meta.context ?? {}
+  );
+  const tracer = import_api.trace.getTracer("default");
+  const [service, action] = target.split(".");
+  return tracer.startActiveSpan(
+    `call: ${target}`,
+    {
+      kind: import_api.SpanKind.CLIENT,
+      attributes: {
+        [import_incubating.ATTR_RPC_SERVICE]: service,
+        [import_incubating.ATTR_RPC_METHOD]: action
+      }
+    },
+    callingContext,
+    async (span) => {
+      const natsHeadersMap = (0, import_transport_node.headers)();
+      natsHeadersMap.set("kmc-depth", (meta.callDepth + 1).toFixed(0));
+      import_api.propagation.inject(import_api.context.active(), natsHeadersMap, {
+        set(carrier, key, value) {
+          carrier.set(key, value);
+        }
+      });
+      try {
+        const result = await nc.request(target, codec.encode(payload), {
+          headers: natsHeadersMap,
+          timeout: options?.timeout ?? 5e3
+        });
+        span.setStatus({ code: import_api.SpanStatusCode.OK });
+        if (result.headers?.get("Nats-Service-Error-Code")) {
+          span.setStatus({ code: import_api.SpanStatusCode.ERROR });
+          span.recordException(result.headers.get("Nats-Service-Error"));
+          throw new CallError(
+            "received error: " + result.headers.get("Nats-Service-Error"),
+            target,
+            payload
+          );
+        }
+        return result.json();
+      } finally {
+        span.end();
+      }
+    }
+  );
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  CallError,
+  Kmicro,
+  RequestContext,
+  init
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/KMicro.ts"],"sourcesContent":["export * from './KMicro.js';\n","import assert from 'node:assert';\nimport {Svc, type Service, type ServiceGroup} from '@nats-io/services';\nimport {\n\tconnect,\n\theaders,\n\tJSONCodec,\n\ttype NatsConnection,\n} from '@nats-io/transport-node';\nimport {\n\tcontext,\n\tpropagation,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n\ttype Context,\n\ttype Span,\n} from '@opentelemetry/api';\nimport {OTLPTraceExporter} from '@opentelemetry/exporter-trace-otlp-proto';\nimport {Resource} from '@opentelemetry/resources';\nimport {NodeSDK} from '@opentelemetry/sdk-node';\nimport {\n\tATTR_MESSAGING_SYSTEM,\n\tATTR_RPC_METHOD,\n\tATTR_RPC_SERVICE,\n\tATTR_SERVICE_NAME,\n} from '@opentelemetry/semantic-conventions/incubating';\n\nexport async function init(\n\tnats: string,\n\tserviceName: string,\n\tversion: string,\n\tdescription?: string,\n) {\n\tconst kmicro = new Kmicro({\n\t\tname: serviceName,\n\t\tversion,\n\t\tdescription,\n\t});\n\tawait kmicro.init(nats);\n\treturn kmicro;\n}\n\nconst codec = JSONCodec(); // eslint-disable-line new-cap\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface Callable {\n\tcall(\n\t\ttarget: string,\n\t\tpayload: Record<string, any>,\n\t\toptions?: {\n\t\t\t/**\n\t\t\t * @default 5000 ms\n\t\t\t */\n\t\t\ttimeout?: number;\n\t\t},\n\t): Promise<Record<string, unknown>>;\n}\n\nexport class Kmicro implements Callable {\n\tprivate service: Service | undefined;\n\tprivate group: ServiceGroup | undefined;\n\tprivate nc: NatsConnection | undefined;\n\tprivate otel: NodeSDK | undefined;\n\n\tconstructor(\n\t\tprivate readonly meta: {\n\t\t\tname: string;\n\t\t\tversion: string;\n\t\t\tdescription: string | undefined;\n\t\t},\n\t) {}\n\n\tpublic async init(natsConnection: string) {\n\t\tthis.nc = await connect({\n\t\t\tname: this.meta.name,\n\t\t\tservers: natsConnection,\n\t\t});\n\t\tconst svc = new Svc(this.nc);\n\t\tthis.service = await svc.add({\n\t\t\tname: this.meta.name,\n\t\t\tversion: this.meta.version,\n\t\t\tdescription: this.meta.description,\n\t\t});\n\t\tthis.group = this.service.addGroup(this.meta.name);\n\t\tthis.otel = new NodeSDK({\n\t\t\tserviceName: this.meta.name,\n\t\t\ttraceExporter: new OTLPTraceExporter(),\n\t\t\tresource: new Resource({\n\t\t\t\t[ATTR_SERVICE_NAME]: this.meta.name,\n\t\t\t\t[ATTR_MESSAGING_SYSTEM]: 'nats',\n\t\t\t}),\n\t\t});\n\n\t\tthis.otel.start();\n\t}\n\n\tpublic async stop() {\n\t\tawait this.service?.stop().catch((error: unknown) => {\n\t\t\tconsole.error(error);\n\t\t});\n\t\tawait this.nc?.close().catch((error: unknown) => {\n\t\t\tconsole.error(error);\n\t\t});\n\t\tawait this.otel?.shutdown().catch((error: unknown) => {\n\t\t\tconsole.error(error);\n\t\t});\n\t}\n\n\tpublic addEndpoint(\n\t\tname: string,\n\t\thandler: (\n\t\t\tcontext_: RequestContext,\n\t\t\tdata: Record<string, any>,\n\t\t) => Promise<Record<string, any>>,\n\t) {\n\t\tassert(this.group);\n\n\t\tthis.group.addEndpoint(name, async (error, message) => {\n\t\t\tassert(this.nc);\n\t\t\tif (error) {\n\t\t\t\tconsole.error(error);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Prevent infinite loops\n\t\t\tconst currentCallDepth = Number.parseInt(\n\t\t\t\tmessage.headers?.get('kmc-depth') ?? '0',\n\t\t\t\t10,\n\t\t\t);\n\t\t\tif (currentCallDepth >= 20) {\n\t\t\t\tthrow new Error('max call depth reached: ' + currentCallDepth);\n\t\t\t}\n\n\t\t\tconst contextWithOtel: Context = propagation.extract(\n\t\t\t\tcontext.active(),\n\t\t\t\tmessage.headers,\n\t\t\t\t{\n\t\t\t\t\tget(carrier, key) {\n\t\t\t\t\t\treturn carrier?.get(key);\n\t\t\t\t\t},\n\t\t\t\t\tkeys(carrier) {\n\t\t\t\t\t\treturn carrier?.keys() ?? [];\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t);\n\n\t\t\tconst tracer = trace.getTracer(name, this.meta.version);\n\t\t\tconst spanName = `handle: ${this.meta.name}.${name}`;\n\t\t\tawait tracer.startActiveSpan(\n\t\t\t\tspanName,\n\t\t\t\t{\n\t\t\t\t\tkind: SpanKind.SERVER,\n\t\t\t\t},\n\t\t\t\tcontextWithOtel,\n\t\t\t\tasync (span) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst requestContext = new RequestContext(\n\t\t\t\t\t\t\tcontextWithOtel,\n\t\t\t\t\t\t\tspan,\n\t\t\t\t\t\t\tthis.nc!,\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tcallDepth: currentCallDepth,\n\t\t\t\t\t\t\t\tcurrentService: this.meta.name,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst result = await handler(requestContext, message.json());\n\t\t\t\t\t\tmessage.respond(codec.encode(result));\n\t\t\t\t\t\tspan.setStatus({code: SpanStatusCode.OK});\n\t\t\t\t\t} catch (error_) {\n\t\t\t\t\t\tspan.recordException(error_ as Error);\n\t\t\t\t\t\tmessage.respondError(500, (error_ as Error).message);\n\t\t\t\t\t\tspan.setStatus({code: SpanStatusCode.ERROR});\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tspan.end();\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t}\n\n\t/**\n\t * Start a new call\n\t */\n\tpublic async call(\n\t\ttarget: string,\n\t\tpayload: Record<string, any>,\n\t\toptions?: {\n\t\t\t/**\n\t\t\t * @default 5000 ms\n\t\t\t */\n\t\t\ttimeout?: number;\n\t\t},\n\t): Promise<Record<string, unknown>> {\n\t\tassert(this.nc);\n\t\treturn doCall(\n\t\t\tthis.nc,\n\t\t\ttarget,\n\t\t\tpayload,\n\t\t\t{\n\t\t\t\tcallDepth: 0,\n\t\t\t\tcontext: undefined,\n\t\t\t\tcurrentService: this.meta.name,\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t}\n}\n\nexport class RequestContext {\n\tconstructor(\n\t\treadonly context: Context,\n\t\treadonly span: Span,\n\t\treadonly nc: NatsConnection,\n\t\treadonly meta: {\n\t\t\tcallDepth: number;\n\t\t\tcurrentService: string;\n\t\t},\n\t) {}\n\n\tpublic async call(\n\t\ttarget: string,\n\t\tpayload: Record<string, any>,\n\t\toptions?: {\n\t\t\t/**\n\t\t\t * @default 5000 ms\n\t\t\t */\n\t\t\ttimeout?: number;\n\t\t},\n\t): Promise<Record<string, unknown>> {\n\t\treturn doCall(\n\t\t\tthis.nc,\n\t\t\ttarget,\n\t\t\tpayload,\n\t\t\t{\n\t\t\t\tcallDepth: this.meta.callDepth,\n\t\t\t\tcontext: this.context,\n\t\t\t\tcurrentService: this.meta.currentService,\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t}\n}\n\nexport class CallError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tprivate readonly target: string,\n\t\tprivate readonly payload: Record<string, unknown>,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'CallError';\n\t}\n}\n\n// eslint-disable-next-line max-params\nasync function doCall(\n\tnc: NatsConnection,\n\ttarget: string,\n\tpayload: Record<string, any>,\n\tmeta: {\n\t\tcallDepth: number;\n\t\t/**\n\t\t * The otel context\n\t\t */\n\t\tcontext: Context | undefined;\n\t\tcurrentService: string;\n\t},\n\toptions?: {\n\t\t/**\n\t\t * @default 5000 ms\n\t\t */\n\t\ttimeout?: number;\n\t},\n): Promise<Record<string, unknown>> {\n\tif (meta.callDepth >= 20) {\n\t\tthrow new Error('max call depth reached: ' + meta.callDepth);\n\t}\n\n\tconst callingContext: Context = propagation.extract(\n\t\tcontext.active(),\n\t\tmeta.context ?? {},\n\t);\n\tconst tracer = trace.getTracer('default');\n\tconst [service, action] = target.split('.');\n\treturn tracer.startActiveSpan(\n\t\t`call: ${target}`,\n\t\t{\n\t\t\tkind: SpanKind.CLIENT,\n\t\t\tattributes: {\n\t\t\t\t[ATTR_RPC_SERVICE]: service,\n\t\t\t\t[ATTR_RPC_METHOD]: action,\n\t\t\t},\n\t\t},\n\t\tcallingContext,\n\t\tasync (span) => {\n\t\t\t// Add kmicro and otel headers to the nats message headers\n\t\t\tconst natsHeadersMap = headers();\n\t\t\tnatsHeadersMap.set('kmc-depth', (meta.callDepth + 1).toFixed(0));\n\t\t\tpropagation.inject(context.active(), natsHeadersMap, {\n\t\t\t\tset(carrier, key, value) {\n\t\t\t\t\tcarrier.set(key, value);\n\t\t\t\t},\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\tconst result = await nc.request(target, codec.encode(payload), {\n\t\t\t\t\theaders: natsHeadersMap,\n\t\t\t\t\ttimeout: options?.timeout ?? 5000,\n\t\t\t\t});\n\t\t\t\tspan.setStatus({code: SpanStatusCode.OK});\n\t\t\t\tif (result.headers?.get('Nats-Service-Error-Code')) {\n\t\t\t\t\tspan.setStatus({code: SpanStatusCode.ERROR});\n\t\t\t\t\tspan.recordException(result.headers.get('Nats-Service-Error'));\n\t\t\t\t\tthrow new CallError(\n\t\t\t\t\t\t'received error: ' + result.headers.get('Nats-Service-Error'),\n\t\t\t\t\t\ttarget,\n\t\t\t\t\t\tpayload,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn result.json<Record<string, unknown>>();\n\t\t\t} finally {\n\t\t\t\tspan.end();\n\t\t\t}\n\t\t},\n\t);\n}\n"],"mappings":"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","names":["assert","context"]}

package/dist/index.d.cts

@@ -0,0 +1,62 @@
+import { NatsConnection } from '@nats-io/transport-node';
+import { Context, Span } from '@opentelemetry/api';
+
+declare function init(nats: string, serviceName: string, version: string, description?: string): Promise<Kmicro>;
+interface Callable {
+    call(target: string, payload: Record<string, any>, options?: {
+        /**
+         * @default 5000 ms
+         */
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+declare class Kmicro implements Callable {
+    private readonly meta;
+    private service;
+    private group;
+    private nc;
+    private otel;
+    constructor(meta: {
+        name: string;
+        version: string;
+        description: string | undefined;
+    });
+    init(natsConnection: string): Promise<void>;
+    stop(): Promise<void>;
+    addEndpoint(name: string, handler: (context_: RequestContext, data: Record<string, any>) => Promise<Record<string, any>>): void;
+    /**
+     * Start a new call
+     */
+    call(target: string, payload: Record<string, any>, options?: {
+        /**
+         * @default 5000 ms
+         */
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+declare class RequestContext {
+    readonly context: Context;
+    readonly span: Span;
+    readonly nc: NatsConnection;
+    readonly meta: {
+        callDepth: number;
+        currentService: string;
+    };
+    constructor(context: Context, span: Span, nc: NatsConnection, meta: {
+        callDepth: number;
+        currentService: string;
+    });
+    call(target: string, payload: Record<string, any>, options?: {
+        /**
+         * @default 5000 ms
+         */
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+declare class CallError extends Error {
+    private readonly target;
+    private readonly payload;
+    constructor(message: string, target: string, payload: Record<string, unknown>);
+}
+
+export { CallError, Kmicro, RequestContext, init };

package/dist/index.d.ts

@@ -0,0 +1,62 @@
+import { NatsConnection } from '@nats-io/transport-node';
+import { Context, Span } from '@opentelemetry/api';
+
+declare function init(nats: string, serviceName: string, version: string, description?: string): Promise<Kmicro>;
+interface Callable {
+    call(target: string, payload: Record<string, any>, options?: {
+        /**
+         * @default 5000 ms
+         */
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+declare class Kmicro implements Callable {
+    private readonly meta;
+    private service;
+    private group;
+    private nc;
+    private otel;
+    constructor(meta: {
+        name: string;
+        version: string;
+        description: string | undefined;
+    });
+    init(natsConnection: string): Promise<void>;
+    stop(): Promise<void>;
+    addEndpoint(name: string, handler: (context_: RequestContext, data: Record<string, any>) => Promise<Record<string, any>>): void;
+    /**
+     * Start a new call
+     */
+    call(target: string, payload: Record<string, any>, options?: {
+        /**
+         * @default 5000 ms
+         */
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+declare class RequestContext {
+    readonly context: Context;
+    readonly span: Span;
+    readonly nc: NatsConnection;
+    readonly meta: {
+        callDepth: number;
+        currentService: string;
+    };
+    constructor(context: Context, span: Span, nc: NatsConnection, meta: {
+        callDepth: number;
+        currentService: string;
+    });
+    call(target: string, payload: Record<string, any>, options?: {
+        /**
+         * @default 5000 ms
+         */
+        timeout?: number;
+    }): Promise<Record<string, unknown>>;
+}
+declare class CallError extends Error {
+    private readonly target;
+    private readonly payload;
+    constructor(message: string, target: string, payload: Record<string, unknown>);
+}
+
+export { CallError, Kmicro, RequestContext, init };

package/dist/index.js

@@ -0,0 +1,239 @@
+// src/KMicro.ts
+import assert from "node:assert";
+import { Svc } from "@nats-io/services";
+import {
+  connect,
+  headers,
+  JSONCodec
+} from "@nats-io/transport-node";
+import {
+  context,
+  propagation,
+  SpanKind,
+  SpanStatusCode,
+  trace
+} from "@opentelemetry/api";
+import { OTLPTraceExporter } from "@opentelemetry/exporter-trace-otlp-proto";
+import { Resource } from "@opentelemetry/resources";
+import { NodeSDK } from "@opentelemetry/sdk-node";
+import {
+  ATTR_MESSAGING_SYSTEM,
+  ATTR_RPC_METHOD,
+  ATTR_RPC_SERVICE,
+  ATTR_SERVICE_NAME
+} from "@opentelemetry/semantic-conventions/incubating";
+async function init(nats, serviceName, version, description) {
+  const kmicro = new Kmicro({
+    name: serviceName,
+    version,
+    description
+  });
+  await kmicro.init(nats);
+  return kmicro;
+}
+var codec = JSONCodec();
+var Kmicro = class {
+  constructor(meta) {
+    this.meta = meta;
+  }
+  service;
+  group;
+  nc;
+  otel;
+  async init(natsConnection) {
+    this.nc = await connect({
+      name: this.meta.name,
+      servers: natsConnection
+    });
+    const svc = new Svc(this.nc);
+    this.service = await svc.add({
+      name: this.meta.name,
+      version: this.meta.version,
+      description: this.meta.description
+    });
+    this.group = this.service.addGroup(this.meta.name);
+    this.otel = new NodeSDK({
+      serviceName: this.meta.name,
+      traceExporter: new OTLPTraceExporter(),
+      resource: new Resource({
+        [ATTR_SERVICE_NAME]: this.meta.name,
+        [ATTR_MESSAGING_SYSTEM]: "nats"
+      })
+    });
+    this.otel.start();
+  }
+  async stop() {
+    await this.service?.stop().catch((error) => {
+      console.error(error);
+    });
+    await this.nc?.close().catch((error) => {
+      console.error(error);
+    });
+    await this.otel?.shutdown().catch((error) => {
+      console.error(error);
+    });
+  }
+  addEndpoint(name, handler) {
+    assert(this.group);
+    this.group.addEndpoint(name, async (error, message) => {
+      assert(this.nc);
+      if (error) {
+        console.error(error);
+        return;
+      }
+      const currentCallDepth = Number.parseInt(
+        message.headers?.get("kmc-depth") ?? "0",
+        10
+      );
+      if (currentCallDepth >= 20) {
+        throw new Error("max call depth reached: " + currentCallDepth);
+      }
+      const contextWithOtel = propagation.extract(
+        context.active(),
+        message.headers,
+        {
+          get(carrier, key) {
+            return carrier?.get(key);
+          },
+          keys(carrier) {
+            return carrier?.keys() ?? [];
+          }
+        }
+      );
+      const tracer = trace.getTracer(name, this.meta.version);
+      const spanName = `handle: ${this.meta.name}.${name}`;
+      await tracer.startActiveSpan(
+        spanName,
+        {
+          kind: SpanKind.SERVER
+        },
+        contextWithOtel,
+        async (span) => {
+          try {
+            const requestContext = new RequestContext(
+              contextWithOtel,
+              span,
+              this.nc,
+              {
+                callDepth: currentCallDepth,
+                currentService: this.meta.name
+              }
+            );
+            const result = await handler(requestContext, message.json());
+            message.respond(codec.encode(result));
+            span.setStatus({ code: SpanStatusCode.OK });
+          } catch (error_) {
+            span.recordException(error_);
+            message.respondError(500, error_.message);
+            span.setStatus({ code: SpanStatusCode.ERROR });
+          } finally {
+            span.end();
+          }
+        }
+      );
+    });
+  }
+  /**
+   * Start a new call
+   */
+  async call(target, payload, options) {
+    assert(this.nc);
+    return doCall(
+      this.nc,
+      target,
+      payload,
+      {
+        callDepth: 0,
+        context: void 0,
+        currentService: this.meta.name
+      },
+      options
+    );
+  }
+};
+var RequestContext = class {
+  constructor(context2, span, nc, meta) {
+    this.context = context2;
+    this.span = span;
+    this.nc = nc;
+    this.meta = meta;
+  }
+  async call(target, payload, options) {
+    return doCall(
+      this.nc,
+      target,
+      payload,
+      {
+        callDepth: this.meta.callDepth,
+        context: this.context,
+        currentService: this.meta.currentService
+      },
+      options
+    );
+  }
+};
+var CallError = class extends Error {
+  constructor(message, target, payload) {
+    super(message);
+    this.target = target;
+    this.payload = payload;
+    this.name = "CallError";
+  }
+};
+async function doCall(nc, target, payload, meta, options) {
+  if (meta.callDepth >= 20) {
+    throw new Error("max call depth reached: " + meta.callDepth);
+  }
+  const callingContext = propagation.extract(
+    context.active(),
+    meta.context ?? {}
+  );
+  const tracer = trace.getTracer("default");
+  const [service, action] = target.split(".");
+  return tracer.startActiveSpan(
+    `call: ${target}`,
+    {
+      kind: SpanKind.CLIENT,
+      attributes: {
+        [ATTR_RPC_SERVICE]: service,
+        [ATTR_RPC_METHOD]: action
+      }
+    },
+    callingContext,
+    async (span) => {
+      const natsHeadersMap = headers();
+      natsHeadersMap.set("kmc-depth", (meta.callDepth + 1).toFixed(0));
+      propagation.inject(context.active(), natsHeadersMap, {
+        set(carrier, key, value) {
+          carrier.set(key, value);
+        }
+      });
+      try {
+        const result = await nc.request(target, codec.encode(payload), {
+          headers: natsHeadersMap,
+          timeout: options?.timeout ?? 5e3
+        });
+        span.setStatus({ code: SpanStatusCode.OK });
+        if (result.headers?.get("Nats-Service-Error-Code")) {
+          span.setStatus({ code: SpanStatusCode.ERROR });
+          span.recordException(result.headers.get("Nats-Service-Error"));
+          throw new CallError(
+            "received error: " + result.headers.get("Nats-Service-Error"),
+            target,
+            payload
+          );
+        }
+        return result.json();
+      } finally {
+        span.end();
+      }
+    }
+  );
+}
+export {
+  CallError,
+  Kmicro,
+  RequestContext,
+  init
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/KMicro.ts"],"sourcesContent":["import assert from 'node:assert';\nimport {Svc, type Service, type ServiceGroup} from '@nats-io/services';\nimport {\n\tconnect,\n\theaders,\n\tJSONCodec,\n\ttype NatsConnection,\n} from '@nats-io/transport-node';\nimport {\n\tcontext,\n\tpropagation,\n\tSpanKind,\n\tSpanStatusCode,\n\ttrace,\n\ttype Context,\n\ttype Span,\n} from '@opentelemetry/api';\nimport {OTLPTraceExporter} from '@opentelemetry/exporter-trace-otlp-proto';\nimport {Resource} from '@opentelemetry/resources';\nimport {NodeSDK} from '@opentelemetry/sdk-node';\nimport {\n\tATTR_MESSAGING_SYSTEM,\n\tATTR_RPC_METHOD,\n\tATTR_RPC_SERVICE,\n\tATTR_SERVICE_NAME,\n} from '@opentelemetry/semantic-conventions/incubating';\n\nexport async function init(\n\tnats: string,\n\tserviceName: string,\n\tversion: string,\n\tdescription?: string,\n) {\n\tconst kmicro = new Kmicro({\n\t\tname: serviceName,\n\t\tversion,\n\t\tdescription,\n\t});\n\tawait kmicro.init(nats);\n\treturn kmicro;\n}\n\nconst codec = JSONCodec(); // eslint-disable-line new-cap\n\n// eslint-disable-next-line @typescript-eslint/consistent-type-definitions\ninterface Callable {\n\tcall(\n\t\ttarget: string,\n\t\tpayload: Record<string, any>,\n\t\toptions?: {\n\t\t\t/**\n\t\t\t * @default 5000 ms\n\t\t\t */\n\t\t\ttimeout?: number;\n\t\t},\n\t): Promise<Record<string, unknown>>;\n}\n\nexport class Kmicro implements Callable {\n\tprivate service: Service | undefined;\n\tprivate group: ServiceGroup | undefined;\n\tprivate nc: NatsConnection | undefined;\n\tprivate otel: NodeSDK | undefined;\n\n\tconstructor(\n\t\tprivate readonly meta: {\n\t\t\tname: string;\n\t\t\tversion: string;\n\t\t\tdescription: string | undefined;\n\t\t},\n\t) {}\n\n\tpublic async init(natsConnection: string) {\n\t\tthis.nc = await connect({\n\t\t\tname: this.meta.name,\n\t\t\tservers: natsConnection,\n\t\t});\n\t\tconst svc = new Svc(this.nc);\n\t\tthis.service = await svc.add({\n\t\t\tname: this.meta.name,\n\t\t\tversion: this.meta.version,\n\t\t\tdescription: this.meta.description,\n\t\t});\n\t\tthis.group = this.service.addGroup(this.meta.name);\n\t\tthis.otel = new NodeSDK({\n\t\t\tserviceName: this.meta.name,\n\t\t\ttraceExporter: new OTLPTraceExporter(),\n\t\t\tresource: new Resource({\n\t\t\t\t[ATTR_SERVICE_NAME]: this.meta.name,\n\t\t\t\t[ATTR_MESSAGING_SYSTEM]: 'nats',\n\t\t\t}),\n\t\t});\n\n\t\tthis.otel.start();\n\t}\n\n\tpublic async stop() {\n\t\tawait this.service?.stop().catch((error: unknown) => {\n\t\t\tconsole.error(error);\n\t\t});\n\t\tawait this.nc?.close().catch((error: unknown) => {\n\t\t\tconsole.error(error);\n\t\t});\n\t\tawait this.otel?.shutdown().catch((error: unknown) => {\n\t\t\tconsole.error(error);\n\t\t});\n\t}\n\n\tpublic addEndpoint(\n\t\tname: string,\n\t\thandler: (\n\t\t\tcontext_: RequestContext,\n\t\t\tdata: Record<string, any>,\n\t\t) => Promise<Record<string, any>>,\n\t) {\n\t\tassert(this.group);\n\n\t\tthis.group.addEndpoint(name, async (error, message) => {\n\t\t\tassert(this.nc);\n\t\t\tif (error) {\n\t\t\t\tconsole.error(error);\n\t\t\t\treturn;\n\t\t\t}\n\n\t\t\t// Prevent infinite loops\n\t\t\tconst currentCallDepth = Number.parseInt(\n\t\t\t\tmessage.headers?.get('kmc-depth') ?? '0',\n\t\t\t\t10,\n\t\t\t);\n\t\t\tif (currentCallDepth >= 20) {\n\t\t\t\tthrow new Error('max call depth reached: ' + currentCallDepth);\n\t\t\t}\n\n\t\t\tconst contextWithOtel: Context = propagation.extract(\n\t\t\t\tcontext.active(),\n\t\t\t\tmessage.headers,\n\t\t\t\t{\n\t\t\t\t\tget(carrier, key) {\n\t\t\t\t\t\treturn carrier?.get(key);\n\t\t\t\t\t},\n\t\t\t\t\tkeys(carrier) {\n\t\t\t\t\t\treturn carrier?.keys() ?? [];\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t);\n\n\t\t\tconst tracer = trace.getTracer(name, this.meta.version);\n\t\t\tconst spanName = `handle: ${this.meta.name}.${name}`;\n\t\t\tawait tracer.startActiveSpan(\n\t\t\t\tspanName,\n\t\t\t\t{\n\t\t\t\t\tkind: SpanKind.SERVER,\n\t\t\t\t},\n\t\t\t\tcontextWithOtel,\n\t\t\t\tasync (span) => {\n\t\t\t\t\ttry {\n\t\t\t\t\t\tconst requestContext = new RequestContext(\n\t\t\t\t\t\t\tcontextWithOtel,\n\t\t\t\t\t\t\tspan,\n\t\t\t\t\t\t\tthis.nc!,\n\t\t\t\t\t\t\t{\n\t\t\t\t\t\t\t\tcallDepth: currentCallDepth,\n\t\t\t\t\t\t\t\tcurrentService: this.meta.name,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t);\n\t\t\t\t\t\tconst result = await handler(requestContext, message.json());\n\t\t\t\t\t\tmessage.respond(codec.encode(result));\n\t\t\t\t\t\tspan.setStatus({code: SpanStatusCode.OK});\n\t\t\t\t\t} catch (error_) {\n\t\t\t\t\t\tspan.recordException(error_ as Error);\n\t\t\t\t\t\tmessage.respondError(500, (error_ as Error).message);\n\t\t\t\t\t\tspan.setStatus({code: SpanStatusCode.ERROR});\n\t\t\t\t\t} finally {\n\t\t\t\t\t\tspan.end();\n\t\t\t\t\t}\n\t\t\t\t},\n\t\t\t);\n\t\t});\n\t}\n\n\t/**\n\t * Start a new call\n\t */\n\tpublic async call(\n\t\ttarget: string,\n\t\tpayload: Record<string, any>,\n\t\toptions?: {\n\t\t\t/**\n\t\t\t * @default 5000 ms\n\t\t\t */\n\t\t\ttimeout?: number;\n\t\t},\n\t): Promise<Record<string, unknown>> {\n\t\tassert(this.nc);\n\t\treturn doCall(\n\t\t\tthis.nc,\n\t\t\ttarget,\n\t\t\tpayload,\n\t\t\t{\n\t\t\t\tcallDepth: 0,\n\t\t\t\tcontext: undefined,\n\t\t\t\tcurrentService: this.meta.name,\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t}\n}\n\nexport class RequestContext {\n\tconstructor(\n\t\treadonly context: Context,\n\t\treadonly span: Span,\n\t\treadonly nc: NatsConnection,\n\t\treadonly meta: {\n\t\t\tcallDepth: number;\n\t\t\tcurrentService: string;\n\t\t},\n\t) {}\n\n\tpublic async call(\n\t\ttarget: string,\n\t\tpayload: Record<string, any>,\n\t\toptions?: {\n\t\t\t/**\n\t\t\t * @default 5000 ms\n\t\t\t */\n\t\t\ttimeout?: number;\n\t\t},\n\t): Promise<Record<string, unknown>> {\n\t\treturn doCall(\n\t\t\tthis.nc,\n\t\t\ttarget,\n\t\t\tpayload,\n\t\t\t{\n\t\t\t\tcallDepth: this.meta.callDepth,\n\t\t\t\tcontext: this.context,\n\t\t\t\tcurrentService: this.meta.currentService,\n\t\t\t},\n\t\t\toptions,\n\t\t);\n\t}\n}\n\nexport class CallError extends Error {\n\tconstructor(\n\t\tmessage: string,\n\t\tprivate readonly target: string,\n\t\tprivate readonly payload: Record<string, unknown>,\n\t) {\n\t\tsuper(message);\n\t\tthis.name = 'CallError';\n\t}\n}\n\n// eslint-disable-next-line max-params\nasync function doCall(\n\tnc: NatsConnection,\n\ttarget: string,\n\tpayload: Record<string, any>,\n\tmeta: {\n\t\tcallDepth: number;\n\t\t/**\n\t\t * The otel context\n\t\t */\n\t\tcontext: Context | undefined;\n\t\tcurrentService: string;\n\t},\n\toptions?: {\n\t\t/**\n\t\t * @default 5000 ms\n\t\t */\n\t\ttimeout?: number;\n\t},\n): Promise<Record<string, unknown>> {\n\tif (meta.callDepth >= 20) {\n\t\tthrow new Error('max call depth reached: ' + meta.callDepth);\n\t}\n\n\tconst callingContext: Context = propagation.extract(\n\t\tcontext.active(),\n\t\tmeta.context ?? {},\n\t);\n\tconst tracer = trace.getTracer('default');\n\tconst [service, action] = target.split('.');\n\treturn tracer.startActiveSpan(\n\t\t`call: ${target}`,\n\t\t{\n\t\t\tkind: SpanKind.CLIENT,\n\t\t\tattributes: {\n\t\t\t\t[ATTR_RPC_SERVICE]: service,\n\t\t\t\t[ATTR_RPC_METHOD]: action,\n\t\t\t},\n\t\t},\n\t\tcallingContext,\n\t\tasync (span) => {\n\t\t\t// Add kmicro and otel headers to the nats message headers\n\t\t\tconst natsHeadersMap = headers();\n\t\t\tnatsHeadersMap.set('kmc-depth', (meta.callDepth + 1).toFixed(0));\n\t\t\tpropagation.inject(context.active(), natsHeadersMap, {\n\t\t\t\tset(carrier, key, value) {\n\t\t\t\t\tcarrier.set(key, value);\n\t\t\t\t},\n\t\t\t});\n\n\t\t\ttry {\n\t\t\t\tconst result = await nc.request(target, codec.encode(payload), {\n\t\t\t\t\theaders: natsHeadersMap,\n\t\t\t\t\ttimeout: options?.timeout ?? 5000,\n\t\t\t\t});\n\t\t\t\tspan.setStatus({code: SpanStatusCode.OK});\n\t\t\t\tif (result.headers?.get('Nats-Service-Error-Code')) {\n\t\t\t\t\tspan.setStatus({code: SpanStatusCode.ERROR});\n\t\t\t\t\tspan.recordException(result.headers.get('Nats-Service-Error'));\n\t\t\t\t\tthrow new CallError(\n\t\t\t\t\t\t'received error: ' + result.headers.get('Nats-Service-Error'),\n\t\t\t\t\t\ttarget,\n\t\t\t\t\t\tpayload,\n\t\t\t\t\t);\n\t\t\t\t}\n\n\t\t\t\treturn result.json<Record<string, unknown>>();\n\t\t\t} finally {\n\t\t\t\tspan.end();\n\t\t\t}\n\t\t},\n\t);\n}\n"],"mappings":"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","names":["context"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "@kultify/kmicro-js",
+  "version": "0.0.1",
+  "description": "",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/kultify-com/kmicro-js.git"
+  },
+  "main": "src/index.js",
+  "scripts": {
+    "build": "tsup",
+    "test": "vitest src/",
+    "lint": "xo src/**/*.ts",
+    "ci": "pnpm lint && pnpm vitest run",
+    "run-nats": "docker run -p 4222:4222 nats -js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.cjs"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist/**/*"
+  ],
+  "tsup": {
+    "format": [
+      "cjs",
+      "esm"
+    ],
+    "sourcemap": true,
+    "clean": true,
+    "dts": true,
+    "entry": [
+      "src/index.ts"
+    ]
+  },
+  "keywords": [
+    "microservice"
+  ],
+  "author": "Kultify GmbH",
+  "license": "MIT",
+  "dependencies": {
+    "@nats-io/services": "3.0.0-6",
+    "@nats-io/transport-node": "3.0.0-12",
+    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/exporter-trace-otlp-proto": "^0.53.0",
+    "@opentelemetry/resources": "^1.26.0",
+    "@opentelemetry/sdk-node": "^0.53.0",
+    "@opentelemetry/sdk-trace-node": "^1.26.0",
+    "@opentelemetry/semantic-conventions": "^1.27.0"
+  },
+  "devDependencies": {
+    "@tsconfig/node20": "^20.1.4",
+    "@types/node": "^22.7.4",
+    "tsup": "^8.3.0",
+    "typescript": "5.6.2",
+    "vitest": "^2.0.5",
+    "xo": "^0.59.3"
+  }
+}