@lad-tech/nsc-toolkit 1.3.0 → 1.4.0

package/dist/injector.js

@@ -1,39 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.instance = exports.service = exports.related = exports.InstanceContainer = exports.ServiceContainer = void 0;
-require("reflect-metadata");
-const serviceMetaKey = Symbol('services');
-const instanceMetaKey = Symbol('instance');
-exports.ServiceContainer = new Map();
-exports.InstanceContainer = new Map();
-function related(target) {
-    const dependencies = Reflect.getMetadata(serviceMetaKey, target.prototype);
-    const instances = Reflect.getMetadata(instanceMetaKey, target.prototype);
-    exports.ServiceContainer.set(target.settings.action, dependencies);
-    exports.InstanceContainer.set(target.settings.action, instances);
-}
-exports.related = related;
-function setMetaData(item, itemName, metaKey, target) {
-    let storage;
-    if (Reflect.hasMetadata(metaKey, target)) {
-        storage = Reflect.getMetadata(metaKey, target);
-    }
-    else {
-        storage = new Map();
-        Reflect.defineMetadata(metaKey, storage, target);
-    }
-    storage.set(itemName, item);
-}
-function service(dependence) {
-    return function (target, dependenceName) {
-        setMetaData(dependence, dependenceName, serviceMetaKey, target);
-    };
-}
-exports.service = service;
-function instance(instance) {
-    return function (target, instanceName) {
-        setMetaData(instance, instanceName, instanceMetaKey, target);
-    };
-}
-exports.instance = instance;
-//# sourceMappingURL=injector.js.map

package/dist/injector.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"injector.js","sourceRoot":"","sources":["../src/injector.ts"],"names":[],"mappings":";;;AAAA,4BAA0B;AAQ1B,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAC1C,MAAM,eAAe,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC;AAE9B,QAAA,gBAAgB,GAAmC,IAAI,GAAG,EAAE,CAAC;AAC7D,QAAA,iBAAiB,GAAiC,IAAI,GAAG,EAAE,CAAC;AAEzE,SAAgB,OAAO,CAAmB,MAAS;IACjD,MAAM,YAAY,GAAsB,OAAO,CAAC,WAAW,CAAC,cAAc,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC9F,MAAM,SAAS,GAAoB,OAAO,CAAC,WAAW,CAAC,eAAe,EAAE,MAAM,CAAC,SAAS,CAAC,CAAC;IAC1F,wBAAgB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAC3D,yBAAiB,CAAC,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;AAC3D,CAAC;AALD,0BAKC;AAED,SAAS,WAAW,CAAC,IAA2B,EAAE,QAAgB,EAAE,OAAe,EAAE,MAAW;IAC9F,IAAI,OAA6B,CAAC;IAClC,IAAI,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,EAAE;QACxC,OAAO,GAAG,OAAO,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;KAChD;SAAM;QACL,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;QACpB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC;KAClD;IACD,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,SAAgB,OAAO,CAAC,UAAsB;IAC5C,OAAO,UAAU,MAAW,EAAE,cAAsB;QAClD,WAAW,CAAC,UAAU,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,CAAC,CAAC;IAClE,CAAC,CAAC;AACJ,CAAC;AAJD,0BAIC;AAED,SAAgB,QAAQ,CAAC,QAAkB;IACzC,OAAO,UAAU,MAAW,EAAE,YAAoB;QAChD,WAAW,CAAC,QAAQ,EAAE,YAAY,EAAE,eAAe,EAAE,MAAM,CAAC,CAAC;IAC/D,CAAC,CAAC;AACJ,CAAC;AAJD,4BAIC"}

package/dist/interfaces.js

@@ -1,4 +0,0 @@
-"use strict";
-// COMMON
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=interfaces.js.map

package/dist/interfaces.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"interfaces.js","sourceRoot":"","sources":["../src/interfaces.ts"],"names":[],"mappings":";AAAA,SAAS"}

package/dist/types/Client.d.ts

@@ -1,29 +0,0 @@
-/// <reference types="node" />
-import { Readable } from 'stream';
-import { Emitter, Listener, MethodSettings, ClientParam, GetListenerOptions } from './interfaces';
-import { Root } from './Root';
-declare type RequestData = Record<string, unknown> | Readable;
-export declare class Client<E extends Emitter = Emitter> extends Root {
-    private serviceName;
-    private baggage?;
-    private cache?;
-    private events?;
-    private subscriptions;
-    private REQUEST_HTTP_SETTINGS_TIMEOUT;
-    constructor({ broker, events, loggerOutputFormatter, serviceName, baggage, cache }: ClientParam<E>);
-    private startWatch;
-    /**
-     * Make listener for service events. Auto subscribe and unsubscribe to subject
-     */
-    getListener<A extends keyof E>(serviceNameFrom: string, options?: GetListenerOptions): Listener<E>;
-    private createCacheKey;
-    private validate;
-    protected request<R = any, P extends RequestData = RequestData>(subject: string, data: P, { options, request, response }: MethodSettings): Promise<R>;
-    private getHTTPSettingsFromRemoteService;
-    private isStream;
-    private makeBrokerRequest;
-    private makeHttpRequest;
-    private convertBaggaggeToExternalHeader;
-    private isJsMessage;
-}
-export {};

package/dist/types/Method.d.ts

@@ -1,6 +0,0 @@
-import { Logs } from '@lad-tech/toolbelt';
-import { Emitter } from './interfaces';
-export declare class BaseMethod<E extends Emitter = Record<string, () => void>> {
-    protected logger: Logs.Logger;
-    protected emitter: E;
-}

package/dist/types/Root.d.ts

@@ -1,26 +0,0 @@
-import { Logs } from '@lad-tech/toolbelt';
-import * as opentelemetry from '@opentelemetry/api';
-import { NatsConnection } from 'nats';
-import { Baggage } from './interfaces';
-export declare class Root {
-    protected brocker: NatsConnection;
-    protected readonly SERVICE_SUBJECT_FOR_GET_HTTP_SETTINGS = "get_http_settings";
-    protected readonly CACHE_SERVICE_KEY = "CACHE";
-    protected readonly SUBJECT_DELIMITER = ".";
-    protected logger: Logs.Logger;
-    constructor(brocker: NatsConnection, outputFormatter?: Logs.OutputFormatter);
-    protected castToNumber(value?: string): number;
-    protected getSettingFromEnv(name: string, required?: boolean): string | undefined;
-    /**
-     * Make opentelemetry context from baggagge
-     */
-    protected getContext(baggage?: Baggage): opentelemetry.Context | undefined;
-    protected getExpired(expired?: number, ownTimeout?: number): number;
-    protected buildErrorMessage(error: string | Error, code?: number): {
-        payload: null;
-        error: {
-            message: string;
-            code: number | undefined;
-        };
-    };
-}

package/dist/types/Service.d.ts

@@ -1,99 +0,0 @@
-import { Root } from './Root';
-import { Emitter, ServiceOptions, Baggage, ExternalBaggage, ClientService } from './interfaces';
-export declare class Service<E extends Emitter = Emitter> extends Root {
-    private options;
-    emitter: E;
-    private serviceName;
-    private httpServer?;
-    private httpProbServer?;
-    protected httpPort?: number;
-    protected ipAddress?: string;
-    private subscriptions;
-    private httpMethods;
-    private rootSpans;
-    constructor(options: ServiceOptions<E>);
-    /**
-     * Create global Tracer
-     */
-    private createTracer;
-    /**
-     * Wrapper for async methods. Create span
-     */
-    private perform;
-    /**
-     * Creating an object to inject into Method (business logic)
-     */
-    private createObjectWithDependencies;
-    /**
-     * Create Method (business logic) context
-     */
-    private createMethodContext;
-    /**
-     * Create Baggage from span. Expired one-on-one business logic call
-     */
-    private getNextBaggage;
-    /**
-     * If there is no baggage. For example, in HTTP Gateway
-     */
-    getRootBaggage(subject: string, headers?: ExternalBaggage, ownTimeout?: number): {
-        expired: number;
-        traceId: string;
-        spanId: string;
-        traceFlags: number;
-    };
-    /**
-     * End root baggage
-     */
-    endRootSpan(traceId: string, error?: Error): void;
-    buildService<C extends ClientService>(Client: C, baggage?: Baggage): InstanceType<C>;
-    /**
-     * Create service Method for send HTTP settings
-     */
-    private runServiceMethodForHttp;
-    private makeHttpSingleResponse;
-    /**
-     * Create transform stream for convert object to string in stream pipeline
-     */
-    private getStringifyTransform;
-    private makeHttpStreamResponse;
-    /**
-     *  Up HTTP server and start listen http routes
-     */
-    private buildHTTPHandlers;
-    /**
-     * Run business logic for request
-     */
-    private handled;
-    /**
-     * Start service. Subscribe for subject and up http server
-     */
-    start(): Promise<void>;
-    /**
-     * Correct finish all connections
-     */
-    private cleanupAndExit;
-    /**
-     * Handler for OS Signal
-     */
-    private handleSignal;
-    /**
-     * Handler for Force OS Signal
-     */
-    private handleFatalError;
-    /**
-     * Register listeners for Graceful Shutdown
-     */
-    private registerGracefulShutdown;
-    /**
-     * Up Probe Route for container orchestration service
-     */
-    private upProbeRoutes;
-    /**
-     * Build message for broker
-     */
-    private buildMessage;
-    private upHTTPServer;
-    private getMyIpV4;
-    private getHttpSettings;
-    private getBaggageFromHTTPHeader;
-}

package/dist/types/StreamManager.d.ts

@@ -1,20 +0,0 @@
-import { StreamManagerParam, GetListenerOptions } from '.';
-import { JetStreamSubscription } from 'nats';
-import { Root } from './Root';
-export declare class StreamManager extends Root {
-    private param;
-    private readonly STAR_WILDCARD;
-    private readonly GREATER_WILDCARD;
-    private readonly TWO_WEEKS_IN_SECOND;
-    private readonly ONE_DAY_IN_SECOND;
-    private readonly defaultStreamOption;
-    private jsm?;
-    constructor(param: StreamManagerParam);
-    createStreams(): Promise<void>;
-    createConsumer(serviceNameFrom: string, eventName: string, setting?: GetListenerOptions): Promise<JetStreamSubscription>;
-    private getStreamName;
-    private isNotFoundStreamError;
-    private buildPrefixForStreamName;
-    private capitalizeFirstLetter;
-    private convertSecondsToNanoseconds;
-}

package/dist/types/index.d.ts

@@ -1,5 +0,0 @@
-export * from './Service';
-export * from './Client';
-export * from './Method';
-export * from './injector';
-export * from './interfaces';

package/dist/types/injector.d.ts

@@ -1,11 +0,0 @@
-import 'reflect-metadata';
-import { Method, ClientService } from './interfaces';
-export declare type Instance = Record<string, (props: unknown) => Promise<unknown>>;
-export declare type Dependence = ClientService<unknown>;
-export declare type DependenceStorage = Map<string, Dependence>;
-export declare type InstanceStorage = Map<string, Instance>;
-export declare const ServiceContainer: Map<string, DependenceStorage>;
-export declare const InstanceContainer: Map<string, InstanceStorage>;
-export declare function related<T extends Method>(target: T): void;
-export declare function service(dependence: Dependence): (target: any, dependenceName: string) => void;
-export declare function instance(instance: Instance): (target: any, instanceName: string) => void;

package/dist/types/interfaces.d.ts

@@ -1,135 +0,0 @@
-import type { NatsConnection } from 'nats';
-import type { Client } from './Client';
-import type { Logs } from '@lad-tech/toolbelt';
-export interface MethodOptions {
-    useStream?: {
-        request?: boolean;
-        response?: boolean;
-    };
-    cache?: number;
-    timeout?: number;
-    runTimeValidation?: {
-        request?: boolean;
-        response?: boolean;
-    };
-}
-export interface MethodSettings {
-    action: string;
-    options?: MethodOptions;
-    request?: Record<string, unknown>;
-    response?: Record<string, unknown>;
-}
-export interface Method {
-    settings: MethodSettings;
-    new (): {
-        handler: (params: any) => Promise<any>;
-    };
-}
-export declare type ClientService<C = Client> = new (natsConnection: NatsConnection, baggage?: Baggage, cache?: CacheSettings, loggerOutputFormatter?: Logs.OutputFormatter) => C;
-export declare type Baggage = {
-    traceId: string;
-    spanId: string;
-    traceFlags: number;
-    expired?: number;
-};
-export declare type ExternalBaggage = {
-    'nsc-expired'?: number;
-    'nsc-trace-id'?: string;
-    'nsc-span-id'?: string;
-    'nsc-trace-flags'?: number;
-};
-export interface Message<M = any> {
-    payload: M;
-    baggage?: Baggage;
-    error?: {
-        message: string;
-        code?: number;
-    };
-}
-export declare type Emitter = Record<string, (params: unknown) => void>;
-export interface CacheSettings {
-    service: CacheService;
-    timeout: number;
-}
-export interface GracefulShutdownAdditionalService {
-    close: () => Promise<any>;
-}
-export interface ClientParam<E extends Emitter = Emitter> {
-    broker: NatsConnection;
-    serviceName: string;
-    baggage?: Baggage;
-    cache?: CacheSettings;
-    loggerOutputFormatter?: Logs.OutputFormatter;
-    events?: Events<E>;
-}
-export interface GetListenerOptions {
-    queue?: string;
-    deliver?: 'all' | 'new';
-    maxPending?: number;
-}
-export interface StreamManagerParam {
-    serviceName: string;
-    options: StreamOptions;
-    broker: NatsConnection;
-    outputFormatter?: Logs.OutputFormatter;
-}
-export interface EmitterEvent<D extends Record<string, any>> {
-    data: D;
-}
-export interface EmitterStreamEvent<D extends Record<string, any>> extends EmitterEvent<D> {
-    ack: () => void;
-    nak: (millis: number) => void;
-}
-export interface StreamAction {
-    action: string;
-    storage?: 'file' | 'memory' | string;
-    retentionPolicy?: 'limits' | 'interest' | 'workQueue' | string;
-    discardPolicy?: 'old' | 'new' | string;
-    messageTTL?: number;
-    duplicateTrackingTime?: number;
-    replication?: number;
-    rollUps?: boolean;
-}
-export interface StreamOptions {
-    prefix: string;
-    actions: StreamAction[];
-}
-export interface Event {
-    action: string;
-    options?: {
-        stream?: boolean;
-    };
-    description: string;
-    event: Record<string, unknown>;
-}
-export interface Events<E extends Emitter> {
-    list: Record<keyof E, Event>;
-    streamOptions: StreamOptions;
-}
-export interface ServiceOptions<E extends Emitter> {
-    name: string;
-    brokerConnection: NatsConnection;
-    methods: Method[];
-    events?: Events<E>;
-    cache?: CacheSettings;
-    loggerOutputFormatter?: Logs.OutputFormatter;
-    gracefulShutdown?: {
-        additional?: GracefulShutdownAdditionalService[];
-        timeout?: number;
-    };
-}
-export declare type EventStreamHandler<P extends Record<string, any>> = (params: EmitterStreamEvent<P>) => void;
-export declare type EventHandler<P extends Record<string, any>> = (params: EmitterEvent<P>) => void;
-export interface Listener<E extends Emitter> {
-    on<A extends keyof E>(action: A, handler: E[A]): void;
-    off<A extends keyof E>(action: A, handler: E[A]): void;
-}
-export interface HttpSettings {
-    ip?: string;
-    port?: number;
-}
-export interface CacheService {
-    set: (key: string, value: string, expired?: number) => Promise<void>;
-    get: (key: string) => Promise<string | undefined>;
-    delete: (key: string) => Promise<void>;
-}