@e22m4u/ts-rest-router 0.1.1 → 0.2.0

package/dist/esm/decorators/action/action-decorator.spec.js

@@ -1,59 +0,0 @@
-var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-};
-var __metadata = (this && this.__metadata) || function (k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-};
-import { expect } from 'chai';
-import { action } from './action-decorator.js';
-import { HttpMethod } from '@e22m4u/js-trie-router';
-import { ActionReflector } from './action-reflector.js';
-describe('action', function () {
-    it('sets given options to the target metadata', function () {
-        const options = {
-            method: HttpMethod.GET,
-            path: 'myPath',
-            before: () => undefined,
-            after: () => undefined,
-            customOption: 'customOption',
-        };
-        class Target {
-            method() { }
-        }
-        __decorate([
-            action(options),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", []),
-            __metadata("design:returntype", void 0)
-        ], Target.prototype, "method", null);
-        const res = ActionReflector.getMetadata(Target);
-        expect(res.get('method')).to.be.eql({
-            ...options,
-            propertyKey: 'method',
-        });
-    });
-    it('overrides a given "propertyKey" option by the target method name', function () {
-        const options = {
-            propertyKey: 'myMethod',
-            method: HttpMethod.GET,
-            path: 'myPath',
-        };
-        class Target {
-            method() { }
-        }
-        __decorate([
-            action(options),
-            __metadata("design:type", Function),
-            __metadata("design:paramtypes", []),
-            __metadata("design:returntype", void 0)
-        ], Target.prototype, "method", null);
-        const res = ActionReflector.getMetadata(Target);
-        expect(res.get('method')).to.be.eql({
-            ...options,
-            propertyKey: 'method',
-        });
-    });
-});

package/dist/esm/decorators/action/action-metadata.js

@@ -1,5 +0,0 @@
-import { MetadataKey } from '@e22m4u/ts-reflector';
-/**
- * Actions metadata key.
- */
-export const ACTIONS_METADATA_KEY = new MetadataKey('actionsMetadataKey');

package/dist/esm/decorators/action/action-reflector.d.ts

@@ -1,22 +0,0 @@
-import { Constructor } from '../../types.js';
-import { ActionMetadata } from './action-metadata.js';
-import { ActionMetadataMap } from './action-metadata.js';
-/**
- * Action reflector.
- */
-export declare class ActionReflector {
-    /**
-     * Set metadata.
-     *
-     * @param metadata
-     * @param target
-     * @param propertyKey
-     */
-    static setMetadata(metadata: ActionMetadata, target: Constructor, propertyKey: string): void;
-    /**
-     * Get metadata.
-     *
-     * @param target
-     */
-    static getMetadata(target: Constructor): ActionMetadataMap;
-}

package/dist/esm/decorators/action/index.d.ts

@@ -1,3 +0,0 @@
-export * from './action-metadata.js';
-export * from './action-reflector.js';
-export * from './action-decorator.js';

package/dist/esm/decorators/action/index.js

@@ -1,3 +0,0 @@
-export * from './action-metadata.js';
-export * from './action-reflector.js';
-export * from './action-decorator.js';

package/dist/esm/decorators/after/after-decorator.d.ts

@@ -1,9 +0,0 @@
-import { Prototype } from '../../types.js';
-import { Constructor } from '../../types.js';
-import { AfterMetadata } from './after-metadata.js';
-/**
- * After decorator.
- *
- * @param options
- */
-export declare function after<T extends object>(middleware: AfterMetadata['middleware']): (target: Constructor<T> | Prototype<T>, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/esm/decorators/after/after-metadata.js

@@ -1,5 +0,0 @@
-import { MetadataKey } from '@e22m4u/ts-reflector';
-/**
- * After metadata key.
- */
-export const AFTER_METADATA_KEY = new MetadataKey('afterMetadataKey');

package/dist/esm/decorators/after/index.d.ts

@@ -1,3 +0,0 @@
-export * from './after-metadata.js';
-export * from './after-reflector.js';
-export * from './after-decorator.js';

package/dist/esm/decorators/after/index.js

@@ -1,3 +0,0 @@
-export * from './after-metadata.js';
-export * from './after-reflector.js';
-export * from './after-decorator.js';

package/dist/esm/decorators/before/before-decorator.d.ts

@@ -1,9 +0,0 @@
-import { Prototype } from '../../types.js';
-import { Constructor } from '../../types.js';
-import { BeforeMetadata } from './before-metadata.js';
-/**
- * Before decorator.
- *
- * @param options
- */
-export declare function before<T extends object>(middleware: BeforeMetadata['middleware']): (target: Constructor<T> | Prototype<T>, propertyKey?: string, descriptor?: PropertyDescriptor) => void;

package/dist/esm/decorators/before/before-metadata.js

@@ -1,5 +0,0 @@
-import { MetadataKey } from '@e22m4u/ts-reflector';
-/**
- * Before metadata key.
- */
-export const BEFORE_METADATA_KEY = new MetadataKey('beforeMetadataKey');

package/dist/esm/decorators/before/index.d.ts

@@ -1,3 +0,0 @@
-export * from './before-metadata.js';
-export * from './before-reflector.js';
-export * from './before-decorator.js';

package/dist/esm/decorators/before/index.js

@@ -1,3 +0,0 @@
-export * from './before-metadata.js';
-export * from './before-reflector.js';
-export * from './before-decorator.js';

package/dist/esm/decorators/controller/controller-decorator.d.ts

@@ -1,14 +0,0 @@
-import { Flatten } from '../../types.js';
-import { Constructor } from '../../types.js';
-import { ControllerMetadata } from './controller-metadata.js';
-/**
- * Controller options.
- */
-export type ControllerOptions = Flatten<Omit<ControllerMetadata, 'className'>>;
-/**
- * Controller decorator.
- *
- * @param pathOrOptions
- * @param options
- */
-export declare function controller<T extends object>(pathOrOptions?: string | ControllerOptions, options?: ControllerOptions): (target: Constructor<T>) => void;

package/dist/esm/decorators/controller/controller-metadata.js

@@ -1,5 +0,0 @@
-import { MetadataKey } from '@e22m4u/ts-reflector';
-/**
- * Controller metadata key.
- */
-export const CONTROLLER_METADATA_KEY = new MetadataKey('controllerMetadataKey');

package/dist/esm/decorators/controller/controller-reflector.d.ts

@@ -1,20 +0,0 @@
-import { Constructor } from '../../types.js';
-import { ControllerMetadata } from './controller-metadata.js';
-/**
- * Controller reflector.
- */
-export declare class ControllerReflector {
-    /**
-     * Set metadata.
-     *
-     * @param metadata
-     * @param target
-     */
-    static setMetadata(metadata: ControllerMetadata, target: Constructor): void;
-    /**
-     * Get metadata.
-     *
-     * @param target
-     */
-    static getMetadata(target: Constructor): ControllerMetadata | undefined;
-}

package/dist/esm/decorators/controller/controller-reflector.js

@@ -1,24 +0,0 @@
-import { Reflector } from '@e22m4u/ts-reflector';
-import { CONTROLLER_METADATA_KEY } from './controller-metadata.js';
-/**
- * Controller reflector.
- */
-export class ControllerReflector {
-    /**
-     * Set metadata.
-     *
-     * @param metadata
-     * @param target
-     */
-    static setMetadata(metadata, target) {
-        return Reflector.defineMetadata(CONTROLLER_METADATA_KEY, metadata, target);
-    }
-    /**
-     * Get metadata.
-     *
-     * @param target
-     */
-    static getMetadata(target) {
-        return Reflector.getOwnMetadata(CONTROLLER_METADATA_KEY, target);
-    }
-}

package/dist/esm/decorators/controller/index.d.ts

@@ -1,3 +0,0 @@
-export * from './controller-metadata.js';
-export * from './controller-decorator.js';
-export * from './controller-reflector.js';

package/dist/esm/decorators/controller/index.js

@@ -1,3 +0,0 @@
-export * from './controller-metadata.js';
-export * from './controller-decorator.js';
-export * from './controller-reflector.js';

package/dist/esm/utils/create-debugger.d.ts

@@ -1,44 +0,0 @@
-/**
- * Debugger.
- */
-export type Debugger = (messageOrData: string | unknown, ...args: any[]) => void;
-/**
- * Create debugger.
- *
- * Base usage:
- * ```ts
- * const debug = createDebugger('myService');
- * debug('Service created.');
- * // ujut:myService Service created.
- * ```
- *
- * Nested namespaces:
- * ```ts
- * const debug1 = debug.bind('namespace1');
- * const debug2 = debug.bind('namespace2');
- * debug1('Application started');    // ujut:myService [namespace1] Application started
- * debug2('Connection established'); // ujut:myService [namespace2] Connection established
- * ```
- *
- * Value inspection:
- * ```ts
- * debug({foo: 'lorem', bar: 'ipsum'})
- * // ujut:myService {
- * // ujut:myService   "foo": "lorem",
- * // ujut:myService   "bar": "ipsum"
- * // ujut:myService }
- * ```
- *
- * Titled inspection output:
- * ```ts
- * debug({foo: 'lorem', bar: 'ipsum'}, 'My awesome output:')
- * // ujut:myService My awesome output:
- * // ujut:myService {
- * // ujut:myService   "foo": "lorem",
- * // ujut:myService   "bar": "ipsum"
- * // ujut:myService }
- * ```
- *
- * @param name
- */
-export declare function createDebugger(name: string): Debugger;

package/dist/esm/utils/create-debugger.js

@@ -1,81 +0,0 @@
-import { inspect } from 'util';
-import DebugModule from 'debug';
-import { format } from '@e22m4u/js-format';
-/**
- * Colorize string.
- *
- * @param input
- */
-function colorizeString(input) {
-    const c = Number(DebugModule['selectColor'](input));
-    const colorCode = '\u001B[3' + (c < 8 ? c : '8;5;' + c);
-    return `${colorCode};1m${input}\u001B[0m`;
-}
-/**
- * Create debugger.
- *
- * Base usage:
- * ```ts
- * const debug = createDebugger('myService');
- * debug('Service created.');
- * // ujut:myService Service created.
- * ```
- *
- * Nested namespaces:
- * ```ts
- * const debug1 = debug.bind('namespace1');
- * const debug2 = debug.bind('namespace2');
- * debug1('Application started');    // ujut:myService [namespace1] Application started
- * debug2('Connection established'); // ujut:myService [namespace2] Connection established
- * ```
- *
- * Value inspection:
- * ```ts
- * debug({foo: 'lorem', bar: 'ipsum'})
- * // ujut:myService {
- * // ujut:myService   "foo": "lorem",
- * // ujut:myService   "bar": "ipsum"
- * // ujut:myService }
- * ```
- *
- * Titled inspection output:
- * ```ts
- * debug({foo: 'lorem', bar: 'ipsum'}, 'My awesome output:')
- * // ujut:myService My awesome output:
- * // ujut:myService {
- * // ujut:myService   "foo": "lorem",
- * // ujut:myService   "bar": "ipsum"
- * // ujut:myService }
- * ```
- *
- * @param name
- */
-export function createDebugger(name) {
-    const debuggerName = `tsRestRouter:${name}`;
-    // включить вывод логов можно принудительно
-    // if (!process.env.DEBUG) DebugModule.enable('ujut*');
-    const debug = DebugModule(debuggerName);
-    return function (messageOrData, 
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ...args) {
-        let prefix = '';
-        if (typeof this === 'string') {
-            const isDebugUsesColors = debug.useColors;
-            prefix = isDebugUsesColors ? colorizeString(`[${this}] `) : `[${this}] `;
-        }
-        if (typeof messageOrData === 'string') {
-            const interpolatedMessage = format(messageOrData, ...args);
-            return debug(prefix + interpolatedMessage);
-        }
-        const inspectOptions = {
-            showHidden: false,
-            depth: null,
-            colors: true,
-            compact: false,
-        };
-        const multiString = inspect(messageOrData, inspectOptions);
-        const rows = multiString.split('\n');
-        const colorizedDebuggerName = colorizeString(debuggerName);
-        [...args, ...rows].forEach(v => console.log(`  ${colorizedDebuggerName} ${prefix}${v}`));
-    };
-}

package/dist/esm/utils/create-debugger.spec.d.ts

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

package/dist/esm/utils/create-debugger.spec.js

@@ -1,8 +0,0 @@
-import { expect } from 'chai';
-import { createDebugger } from './create-debugger.js';
-describe('createDebugger', function () {
-    it('returns a function', function () {
-        const res = createDebugger('name');
-        expect(typeof res).to.be.eq('function');
-    });
-});

package/src/decorators/action/action-decorator.spec.ts

@@ -1,42 +0,0 @@
-import {expect} from 'chai';
-import {action} from './action-decorator.js';
-import {HttpMethod} from '@e22m4u/js-trie-router';
-import {ActionReflector} from './action-reflector.js';
-
-describe('action', function () {
-  it('sets given options to the target metadata', function () {
-    const options = {
-      method: HttpMethod.GET,
-      path: 'myPath',
-      before: () => undefined,
-      after: () => undefined,
-      customOption: 'customOption',
-    };
-    class Target {
-      @action(options)
-      method() {}
-    }
-    const res = ActionReflector.getMetadata(Target);
-    expect(res.get('method')).to.be.eql({
-      ...options,
-      propertyKey: 'method',
-    });
-  });
-
-  it('overrides a given "propertyKey" option by the target method name', function () {
-    const options = {
-      propertyKey: 'myMethod',
-      method: HttpMethod.GET,
-      path: 'myPath',
-    };
-    class Target {
-      @action(options)
-      method() {}
-    }
-    const res = ActionReflector.getMetadata(Target);
-    expect(res.get('method')).to.be.eql({
-      ...options,
-      propertyKey: 'method',
-    });
-  });
-});

package/src/decorators/action/action-decorator.ts

@@ -1,98 +0,0 @@
-import {Flatten} from '../../types.js';
-import {Prototype} from '../../types.js';
-import {Constructor} from '../../types.js';
-import {HttpMethod} from '@e22m4u/js-trie-router';
-import {ActionMetadata} from './action-metadata.js';
-import {ActionReflector} from './action-reflector.js';
-import {DecoratorTargetType} from '@e22m4u/ts-reflector';
-import {getDecoratorTargetType} from '@e22m4u/ts-reflector';
-
-/**
- * Action options.
- */
-export type ActionOptions = Flatten<Omit<ActionMetadata, 'propertyKey'>>;
-
-/**
- * Action decorator.
- *
- * @param options
- */
-export function action<T extends object>(options: ActionOptions) {
-  return function (
-    target: Prototype<T>,
-    propertyKey: string,
-    descriptor: PropertyDescriptor,
-  ) {
-    const decoratorType = getDecoratorTargetType(
-      target,
-      propertyKey,
-      descriptor,
-    );
-    if (decoratorType !== DecoratorTargetType.INSTANCE_METHOD)
-      throw new Error(
-        '@action decorator is only supported on an instance method.',
-      );
-    ActionReflector.setMetadata(
-      {...options, propertyKey},
-      target.constructor as Constructor<T>,
-      propertyKey,
-    );
-  };
-}
-
-/**
- * Action method options.
- */
-export type ActionMethodOptions = Flatten<
-  Omit<ActionOptions, 'method' | 'path'>
->;
-
-/**
- * Get decorator.
- *
- * @param path
- * @param options
- */
-export const get = (path: string, options?: ActionMethodOptions) => {
-  return action({...options, path, method: HttpMethod.GET});
-};
-
-/**
- * Post decorator.
- *
- * @param path
- * @param options
- */
-export const post = (path: string, options?: ActionMethodOptions) => {
-  return action({...options, path, method: HttpMethod.POST});
-};
-
-/**
- * Put decorator.
- *
- * @param path
- * @param options
- */
-export const put = (path: string, options?: ActionMethodOptions) => {
-  return action({...options, path, method: HttpMethod.PUT});
-};
-
-/**
- * Patch decorator.
- *
- * @param path
- * @param options
- */
-export const patch = (path: string, options?: ActionMethodOptions) => {
-  return action({...options, path, method: HttpMethod.PATCH});
-};
-
-/**
- * Del decorator.
- *
- * @param path
- * @param options
- */
-export const del = (path: string, options?: ActionMethodOptions) => {
-  return action({...options, path, method: HttpMethod.DELETE});
-};

package/src/decorators/action/action-reflector.ts

@@ -1,38 +0,0 @@
-import {Constructor} from '../../types.js';
-import {Reflector} from '@e22m4u/ts-reflector';
-import {ActionMetadata} from './action-metadata.js';
-import {ActionMetadataMap} from './action-metadata.js';
-import {ACTIONS_METADATA_KEY} from './action-metadata.js';
-
-/**
- * Action reflector.
- */
-export class ActionReflector {
-  /**
-   * Set metadata.
-   *
-   * @param metadata
-   * @param target
-   * @param propertyKey
-   */
-  static setMetadata(
-    metadata: ActionMetadata,
-    target: Constructor,
-    propertyKey: string,
-  ) {
-    const oldMap = Reflector.getOwnMetadata(ACTIONS_METADATA_KEY, target);
-    const newMap = new Map(oldMap);
-    newMap.set(propertyKey, metadata);
-    Reflector.defineMetadata(ACTIONS_METADATA_KEY, newMap, target);
-  }
-
-  /**
-   * Get metadata.
-   *
-   * @param target
-   */
-  static getMetadata(target: Constructor): ActionMetadataMap {
-    const metadata = Reflector.getOwnMetadata(ACTIONS_METADATA_KEY, target);
-    return metadata ?? new Map();
-  }
-}

package/src/decorators/action/index.ts

@@ -1,3 +0,0 @@
-export * from './action-metadata.js';
-export * from './action-reflector.js';
-export * from './action-decorator.js';

package/src/decorators/after/index.ts

@@ -1,3 +0,0 @@
-export * from './after-metadata.js';
-export * from './after-reflector.js';
-export * from './after-decorator.js';

package/src/decorators/before/before-metadata.ts

@@ -1,17 +0,0 @@
-import {MetadataKey} from '@e22m4u/ts-reflector';
-import {RoutePreHandler} from '@e22m4u/js-trie-router';
-
-/**
- * Before metadata.
- */
-export type BeforeMetadata = {
-  propertyKey?: string;
-  middleware: RoutePreHandler | RoutePreHandler[];
-};
-
-/**
- * Before metadata key.
- */
-export const BEFORE_METADATA_KEY = new MetadataKey<BeforeMetadata[]>(
-  'beforeMetadataKey',
-);

package/src/decorators/before/index.ts

@@ -1,3 +0,0 @@
-export * from './before-metadata.js';
-export * from './before-reflector.js';
-export * from './before-decorator.js';

package/src/decorators/controller/controller-reflector.ts

@@ -1,28 +0,0 @@
-import {Constructor} from '../../types.js';
-import {Reflector} from '@e22m4u/ts-reflector';
-import {ControllerMetadata} from './controller-metadata.js';
-import {CONTROLLER_METADATA_KEY} from './controller-metadata.js';
-
-/**
- * Controller reflector.
- */
-export class ControllerReflector {
-  /**
-   * Set metadata.
-   *
-   * @param metadata
-   * @param target
-   */
-  static setMetadata(metadata: ControllerMetadata, target: Constructor) {
-    return Reflector.defineMetadata(CONTROLLER_METADATA_KEY, metadata, target);
-  }
-
-  /**
-   * Get metadata.
-   *
-   * @param target
-   */
-  static getMetadata(target: Constructor): ControllerMetadata | undefined {
-    return Reflector.getOwnMetadata(CONTROLLER_METADATA_KEY, target);
-  }
-}

package/src/decorators/controller/index.ts

@@ -1,3 +0,0 @@
-export * from './controller-metadata.js';
-export * from './controller-decorator.js';
-export * from './controller-reflector.js';

package/src/utils/create-debugger.spec.ts

@@ -1,9 +0,0 @@
-import {expect} from 'chai';
-import {createDebugger} from './create-debugger.js';
-
-describe('createDebugger', function () {
-  it('returns a function', function () {
-    const res = createDebugger('name');
-    expect(typeof res).to.be.eq('function');
-  });
-});