@e22m4u/ts-rest-router 0.1.2 → 0.2.0

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');
-  });
-});

package/src/utils/create-debugger.ts

@@ -1,98 +0,0 @@
-import {inspect} from 'util';
-import DebugModule from 'debug';
-import {AnyObject} from '../types.js';
-import {format} from '@e22m4u/js-format';
-
-/**
- * Debugger.
- */
-export type Debugger = (
-  messageOrData: string | unknown,
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  ...args: any[]
-) => void;
-
-/**
- * Colorize string.
- *
- * @param input
- */
-function colorizeString(input: string): string {
-  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: string): Debugger {
-  const debuggerName = `tsRestRouter:${name}`;
-  // включить вывод логов можно принудительно
-  // if (!process.env.DEBUG) DebugModule.enable('ujut*');
-  const debug = DebugModule(debuggerName);
-  return function (
-    this: unknown,
-    messageOrData: string | unknown,
-    // eslint-disable-next-line @typescript-eslint/no-explicit-any
-    ...args: any[]
-  ) {
-    let prefix = '';
-    if (typeof this === 'string') {
-      const isDebugUsesColors = (debug as AnyObject).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}`),
-    );
-  };
-}