@opra/nestjs 0.33.13 → 1.0.0-alpha.10

package/esm/factories/params.factory.js

@@ -1,19 +0,0 @@
-import { HandlerParamType } from '../enums/handler-paramtype.enum.js';
-export class OpraParamsFactory {
-    exchangeKeyForValue(type, data, args) {
-        if (!args) {
-            return null;
-        }
-        args = Array.isArray(args) ? args : [];
-        switch (type) {
-            case HandlerParamType.CONTEXT:
-                return args[3];
-            case HandlerParamType.REQUEST:
-                return args[3].request;
-            case HandlerParamType.RESPONSE:
-                return args[3].response;
-            default:
-                return null;
-        }
-    }
-}

package/esm/opra-core.module.js

@@ -1,137 +0,0 @@
-var OpraCoreModule_1;
-import { __decorate, __metadata, __param } from "tslib";
-import * as crypto from 'crypto';
-import { Global, Inject, Module } from '@nestjs/common';
-import { HttpAdapterHost, ModulesContainer } from '@nestjs/core';
-import { MetadataScanner } from '@nestjs/core/metadata-scanner';
-import { OPRA_INITIALIZER, OPRA_MODULE_ID, OPRA_MODULE_OPTIONS } from './constants.js';
-import { OpraApiFactory } from './factories/opra-api.factory.js';
-import { OpraModuleRef } from './opra-module-ref.js';
-import { NestExplorer } from './services/nest-explorer.js';
-import { OpraApiLoader } from './services/opra-api-loader.js';
-let OpraCoreModule = OpraCoreModule_1 = class OpraCoreModule {
-    constructor(httpAdapterHost, modulesContainer, options, apiLoader) {
-        this.httpAdapterHost = httpAdapterHost;
-        this.modulesContainer = modulesContainer;
-        this.options = options;
-        this.apiLoader = apiLoader;
-    }
-    static forRoot(options) {
-        const providers = [
-            ...(options.providers || []),
-            {
-                provide: OPRA_MODULE_OPTIONS,
-                useValue: options,
-            },
-            {
-                provide: OPRA_INITIALIZER,
-                useClass: OpraApiLoader
-            },
-            {
-                provide: options.id || OpraModuleRef,
-                inject: [OPRA_INITIALIZER],
-                useFactory: (apiLoader) => {
-                    return apiLoader.opraModuleRef;
-                }
-            }
-        ];
-        return {
-            module: OpraCoreModule_1,
-            imports: [...(options.imports || [])],
-            exports: [...(options.exports || [])],
-            providers
-        };
-    }
-    static forRootAsync(asyncOptions) {
-        return {
-            module: OpraCoreModule_1,
-            imports: [...(asyncOptions.imports || [])],
-            providers: [
-                ...(asyncOptions.providers || []),
-                {
-                    provide: OPRA_MODULE_ID,
-                    useValue: crypto.randomUUID()
-                },
-                {
-                    provide: OPRA_INITIALIZER,
-                    useClass: OpraApiLoader
-                },
-                {
-                    provide: asyncOptions.id || OpraModuleRef,
-                    inject: [OPRA_INITIALIZER],
-                    useFactory: (apiLoader) => {
-                        return apiLoader.opraModuleRef;
-                    }
-                },
-                ...this.createAsyncProviders(asyncOptions)
-            ]
-        };
-    }
-    static createAsyncProviders(asyncOptions) {
-        if (asyncOptions.useExisting || asyncOptions.useFactory)
-            return [this.createAsyncOptionsProvider(asyncOptions)];
-        if (asyncOptions.useClass)
-            return [
-                this.createAsyncOptionsProvider(asyncOptions),
-                {
-                    provide: asyncOptions.useClass,
-                    useClass: asyncOptions.useClass
-                }
-            ];
-        throw new Error('Invalid configuration. Must provide useFactory, useClass or useExisting');
-    }
-    static createAsyncOptionsProvider(asyncOptions) {
-        if (asyncOptions.useFactory) {
-            return {
-                provide: OPRA_MODULE_OPTIONS,
-                useFactory: asyncOptions.useFactory,
-                inject: asyncOptions.inject || []
-            };
-        }
-        const useClass = asyncOptions.useClass || asyncOptions.useExisting;
-        if (useClass) {
-            return {
-                provide: OPRA_MODULE_OPTIONS,
-                useFactory: (optionsFactory) => optionsFactory.createOptions(),
-                inject: [useClass]
-            };
-        }
-        throw new Error('Invalid configuration. Must provide useFactory, useClass or useExisting');
-    }
-    async onModuleInit() {
-        const httpAdapter = this.httpAdapterHost?.httpAdapter;
-        if (!httpAdapter)
-            return;
-        const opraModule = (() => {
-            for (const m of this.modulesContainer.values()) {
-                for (const imp of m.imports.values()) {
-                    for (const prv of imp.providers.values())
-                        if (prv.instance === this) {
-                            return imp;
-                        }
-                }
-            }
-        })();
-        if (opraModule) {
-            await this.apiLoader.initialize(opraModule);
-        }
-    }
-    async onModuleDestroy() {
-        await this.apiLoader.stop();
-    }
-};
-OpraCoreModule = OpraCoreModule_1 = __decorate([
-    Module({
-        providers: [
-            OpraApiFactory,
-            MetadataScanner,
-            NestExplorer
-        ]
-    }),
-    Global(),
-    __param(2, Inject(OPRA_MODULE_OPTIONS)),
-    __param(3, Inject(OPRA_INITIALIZER)),
-    __metadata("design:paramtypes", [HttpAdapterHost,
-        ModulesContainer, Object, OpraApiLoader])
-], OpraCoreModule);
-export { OpraCoreModule };

package/esm/opra-module-ref.js

@@ -1,12 +0,0 @@
-import { kAdapter, kOptions } from './constants.js';
-export class OpraModuleRef {
-    get adapter() {
-        return this[kAdapter];
-    }
-    get api() {
-        return this[kAdapter].api;
-    }
-    get options() {
-        return this[kOptions];
-    }
-}

package/esm/opra.module.js

@@ -1,22 +0,0 @@
-var OpraModule_1;
-import { __decorate } from "tslib";
-import { Module } from '@nestjs/common';
-import { OpraCoreModule } from './opra-core.module.js';
-let OpraModule = OpraModule_1 = class OpraModule {
-    static forRoot(options) {
-        return {
-            module: OpraModule_1,
-            imports: [OpraCoreModule.forRoot(options)]
-        };
-    }
-    static forRootAsync(asyncOptions) {
-        return {
-            module: OpraModule_1,
-            imports: [OpraCoreModule.forRootAsync(asyncOptions)]
-        };
-    }
-};
-OpraModule = OpraModule_1 = __decorate([
-    Module({})
-], OpraModule);
-export { OpraModule };

package/esm/services/nest-explorer.js

@@ -1,34 +0,0 @@
-import { OpraSchema, RESOURCE_METADATA } from '@opra/common';
-export class NestExplorer {
-    exploreProviders(rootModule, callback) {
-        const modules = new Set();
-        const tree = [];
-        const scanModules = (m) => {
-            if (modules.has(m))
-                return;
-            modules.add(m);
-            tree.push(m);
-            for (const mm of m.imports.values()) {
-                scanModules(mm);
-            }
-            for (const wrapper of m.providers.values()) {
-                callback(wrapper, tree);
-                if (wrapper.host)
-                    scanModules(wrapper.host);
-            }
-            tree.pop();
-        };
-        scanModules(rootModule);
-    }
-    exploreResources(rootModule, callback) {
-        this.exploreProviders(rootModule, (wrapper, tree) => {
-            if (wrapper.instance
-                && typeof wrapper.instance === 'object'
-                && wrapper.instance.constructor
-                && OpraSchema.isResource(Reflect.getMetadata(RESOURCE_METADATA, wrapper.instance.constructor))) {
-                callback(wrapper, tree);
-            }
-            return false;
-        });
-    }
-}

package/esm/services/opra-api-loader.js

@@ -1,81 +0,0 @@
-import { __decorate, __metadata } from "tslib";
-import { Inject, Logger } from '@nestjs/common';
-import { ApplicationConfig, HttpAdapterHost } from '@nestjs/core';
-import { OpraURLPath } from '@opra/common';
-import { ExpressAdapter } from '@opra/core';
-import { kAdapter, kOptions, OPRA_MODULE_OPTIONS } from '../constants.js';
-import { OpraApiFactory } from '../factories/opra-api.factory.js';
-import { OpraModuleRef } from '../opra-module-ref.js';
-export class OpraApiLoader {
-    constructor() {
-        this.logger = new Logger(OpraApiLoader.name, { timestamp: true });
-        this.opraModuleRef = new OpraModuleRef();
-    }
-    async initialize(rootModule) {
-        const httpAdapter = this.httpAdapterHost?.httpAdapter;
-        const globalPrefix = this.applicationConfig.getGlobalPrefix();
-        const platformName = httpAdapter.getType();
-        const moduleOptions = this.options;
-        this.opraModuleRef[kOptions] = this.options;
-        let prefixPath = new OpraURLPath((moduleOptions.useGlobalPrefix !== false ? globalPrefix : ''));
-        if (moduleOptions.basePath)
-            prefixPath = prefixPath.join(moduleOptions.basePath);
-        const name = moduleOptions.document?.info?.title || 'untitled service';
-        const options = {
-            ...moduleOptions,
-            basePath: prefixPath.toString()
-        };
-        try {
-            const apiDocument = await this.opraFactory.generateService(rootModule, 'http', options.document);
-            if (!Object.keys(apiDocument.root).length) {
-                this.logger.warn(`No Sources found (${name})`);
-                return;
-            }
-            if (platformName === 'express') {
-                this.opraModuleRef[kAdapter] = await this.registerExpress(apiDocument, options);
-                // else if (platformName === 'fastify')
-                // await this.registerFastify();
-            }
-            else { // noinspection ExceptionCaughtLocallyJS
-                throw new Error(`No support for current HttpAdapter: ${platformName}`);
-            }
-            this.logger.log(`Mapped {${prefixPath.toString() || '/'}} to "${name}" service`);
-        }
-        catch (e) {
-            this.logger.error(e);
-            throw e;
-        }
-    }
-    async stop() {
-        //
-    }
-    async registerExpress(apiDocument, moduleOptions) {
-        const httpAdapter = this.httpAdapterHost.httpAdapter;
-        /* istanbul ignore next */
-        if (!httpAdapter)
-            throw new Error('HttpAdapterHost is not initialized');
-        const app = httpAdapter.getInstance();
-        const logger = moduleOptions.logger ||
-            (process.env.NODE_ENV === 'test' ? undefined : new Logger(apiDocument.info.title));
-        return await ExpressAdapter.create(app, apiDocument, {
-            ...moduleOptions,
-            logger,
-        });
-    }
-}
-__decorate([
-    Inject(),
-    __metadata("design:type", HttpAdapterHost)
-], OpraApiLoader.prototype, "httpAdapterHost", void 0);
-__decorate([
-    Inject(),
-    __metadata("design:type", ApplicationConfig)
-], OpraApiLoader.prototype, "applicationConfig", void 0);
-__decorate([
-    Inject(),
-    __metadata("design:type", OpraApiFactory)
-], OpraApiLoader.prototype, "opraFactory", void 0);
-__decorate([
-    Inject(OPRA_MODULE_OPTIONS),
-    __metadata("design:type", Object)
-], OpraApiLoader.prototype, "options", void 0);

package/esm/types.js

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

package/esm/utils/class.utils.js

@@ -1,19 +0,0 @@
-import { isFunction, isString } from '@nestjs/common/utils/shared.utils';
-export function isConstructor(obj) {
-    return typeof obj === 'function' &&
-        !!(obj.prototype && obj.prototype.constructor);
-}
-export function getClassOrUndefined(typeOrFunc) {
-    return isConstructor(typeOrFunc)
-        ? typeOrFunc
-        : isFunction(typeOrFunc)
-            ? typeOrFunc()
-            : undefined;
-}
-export function getClassName(nameOrType) {
-    if (isString(nameOrType)) {
-        return nameOrType;
-    }
-    const classOrUndefined = getClassOrUndefined(nameOrType);
-    return classOrUndefined && classOrUndefined.name;
-}

package/esm/utils/function.utils.js

@@ -1,33 +0,0 @@
-import { splitString, tokenize } from 'fast-tokenizer';
-export function getNumberOfArguments(fn) {
-    const functionAsString = fn.toString();
-    const tokenizer = tokenize(functionAsString, {
-        // keepBrackets: true,
-        keepDelimiters: true,
-        keepQuotes: true,
-        brackets: {}
-    });
-    let k = 0;
-    let s = '';
-    for (const token of tokenizer) {
-        if (token.startsWith('(')) {
-            s += token.substring(1);
-            k++;
-        }
-        else if (token.startsWith(')')) {
-            if (k === 1)
-                break;
-        }
-        else if (k)
-            s += token;
-    }
-    const x = splitString(s, {
-        brackets: {
-            '{': '}',
-            '(': ')',
-            '[': ']',
-            '/*': '*/'
-        }, delimiters: ','
-    });
-    return x.length > 1 ? x.length : (x[0] ? 1 : 0);
-}

package/esm/utils/param.utils.js

@@ -1,20 +0,0 @@
-import 'reflect-metadata';
-import { PARAM_ARGS_METADATA } from '../constants.js';
-function assignMetadata(args, paramType, index, data, ...pipes) {
-    return {
-        ...args,
-        [`${paramType}:${index}`]: {
-            index,
-            data,
-            pipes,
-        },
-    };
-}
-export function createOpraParamDecorator(paramType) {
-    return (target, key, index) => {
-        if (!key)
-            return;
-        const args = Reflect.getMetadata(PARAM_ARGS_METADATA, target.constructor, key) || {};
-        Reflect.defineMetadata(PARAM_ARGS_METADATA, assignMetadata(args, paramType, index), target.constructor, key);
-    };
-}

package/types/augmentation/common-decorator.augmentation.d.ts

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

package/types/decorators/context.decorator.d.ts

@@ -1,5 +0,0 @@
-/**
- * Handler method parameter decorator. Populates the decorated
- * parameter with the value of `RequestContext`.
- */
-export declare const Context: ParameterDecorator;

package/types/enums/handler-paramtype.enum.d.ts

@@ -1,5 +0,0 @@
-export declare enum HandlerParamType {
-    CONTEXT = 0,
-    REQUEST = 1,
-    RESPONSE = 2
-}

package/types/factories/opra-api.factory.d.ts

@@ -1,15 +0,0 @@
-import { ContextType } from '@nestjs/common';
-import { Module } from '@nestjs/core/injector/module.js';
-import { ApiDocument, ApiDocumentFactory } from '@opra/common';
-export declare class OpraApiFactory {
-    private readonly paramsFactory;
-    private readonly injector;
-    private readonly modulesContainer;
-    private readonly externalContextCreator;
-    private readonly explorerService;
-    generateService(rootModule: Module, contextType: ContextType, apiSchema?: Partial<ApiDocumentFactory.InitArguments>): Promise<ApiDocument>;
-    private _createHandler;
-    private _createContextCallback;
-    private getContextId;
-    private registerContextProvider;
-}

package/types/factories/params.factory.d.ts

@@ -1,4 +0,0 @@
-import { ParamsFactory } from '@nestjs/core/helpers/external-context-creator.js';
-export declare class OpraParamsFactory implements ParamsFactory {
-    exchangeKeyForValue(type: number, data: any, args: any): any;
-}

package/types/opra-core.module.d.ts

@@ -1,17 +0,0 @@
-import { DynamicModule, OnModuleDestroy, OnModuleInit } from '@nestjs/common';
-import { HttpAdapterHost, ModulesContainer } from '@nestjs/core';
-import { OpraModuleAsyncOptions, OpraModuleOptions } from './interfaces/opra-module-options.interface.js';
-import { OpraApiLoader } from './services/opra-api-loader.js';
-export declare class OpraCoreModule implements OnModuleInit, OnModuleDestroy {
-    private readonly httpAdapterHost;
-    protected readonly modulesContainer: ModulesContainer;
-    private readonly options;
-    private readonly apiLoader;
-    constructor(httpAdapterHost: HttpAdapterHost, modulesContainer: ModulesContainer, options: OpraModuleOptions, apiLoader: OpraApiLoader);
-    static forRoot(options: OpraModuleOptions & Pick<DynamicModule, 'imports' | 'providers' | 'exports'>): DynamicModule;
-    static forRootAsync(asyncOptions: OpraModuleAsyncOptions): DynamicModule;
-    private static createAsyncProviders;
-    private static createAsyncOptionsProvider;
-    onModuleInit(): Promise<void>;
-    onModuleDestroy(): Promise<void>;
-}

package/types/opra-module-ref.d.ts

@@ -1,11 +0,0 @@
-import { ApiDocument } from '@opra/common';
-import { PlatformAdapter } from '@opra/core';
-import { kAdapter, kOptions } from './constants.js';
-import { OpraModuleOptions } from './interfaces/opra-module-options.interface.js';
-export declare class OpraModuleRef {
-    protected [kOptions]: OpraModuleOptions;
-    protected [kAdapter]: PlatformAdapter;
-    get adapter(): PlatformAdapter;
-    get api(): ApiDocument;
-    get options(): OpraModuleOptions;
-}

package/types/opra.module.d.ts

@@ -1,6 +0,0 @@
-import { DynamicModule } from '@nestjs/common';
-import { OpraModuleAsyncOptions, OpraModuleOptions } from './interfaces/opra-module-options.interface.js';
-export declare class OpraModule {
-    static forRoot(options: OpraModuleOptions & Pick<DynamicModule, 'imports' | 'providers' | 'exports'>): DynamicModule;
-    static forRootAsync(asyncOptions: OpraModuleAsyncOptions): DynamicModule;
-}

package/types/services/nest-explorer.d.ts

@@ -1,8 +0,0 @@
-import { InstanceWrapper } from '@nestjs/core/injector/instance-wrapper';
-import { Module } from '@nestjs/core/injector/module';
-type WrapperCallback = (wrapper: InstanceWrapper, tree: Module[]) => void;
-export declare class NestExplorer {
-    exploreProviders(rootModule: Module, callback: WrapperCallback): void;
-    exploreResources(rootModule: Module, callback: WrapperCallback): void;
-}
-export {};

package/types/services/opra-api-loader.d.ts

@@ -1,19 +0,0 @@
-import { Logger } from '@nestjs/common';
-import { ApplicationConfig, HttpAdapterHost } from '@nestjs/core';
-import { Module } from '@nestjs/core/injector/module.js';
-import { ApiDocument } from '@opra/common';
-import { ExpressAdapter } from '@opra/core';
-import { OpraApiFactory } from '../factories/opra-api.factory.js';
-import { OpraModuleOptions } from '../interfaces/opra-module-options.interface.js';
-import { OpraModuleRef } from '../opra-module-ref.js';
-export declare class OpraApiLoader {
-    protected readonly logger: Logger;
-    readonly opraModuleRef: OpraModuleRef;
-    protected readonly httpAdapterHost: HttpAdapterHost;
-    protected readonly applicationConfig: ApplicationConfig;
-    protected readonly opraFactory: OpraApiFactory;
-    protected readonly options: OpraModuleOptions;
-    initialize(rootModule: Module): Promise<void>;
-    stop(): Promise<void>;
-    protected registerExpress(apiDocument: ApiDocument, moduleOptions: OpraModuleOptions): Promise<ExpressAdapter>;
-}

package/types/types.d.ts

@@ -1,2 +0,0 @@
-import { DynamicModule, ForwardReference, Type } from '@nestjs/common';
-export type ModuleThunk = Type | DynamicModule | Promise<DynamicModule> | ForwardReference;

package/types/utils/class.utils.d.ts

@@ -1,4 +0,0 @@
-import { Type } from '@nestjs/common';
-export declare function isConstructor(obj: any): obj is Type;
-export declare function getClassOrUndefined(typeOrFunc: Function | Type): Type | undefined;
-export declare function getClassName(nameOrType: string | Function | Type): string | undefined;

package/types/utils/function.utils.d.ts

@@ -1 +0,0 @@
-export declare function getNumberOfArguments(fn: Function): number | undefined;

package/types/utils/param.utils.d.ts

@@ -1,8 +0,0 @@
-import 'reflect-metadata';
-import { HandlerParamType } from '../enums/handler-paramtype.enum.js';
-export type ParamData = object | string | number;
-export type ParamsMetadata = Record<number, {
-    index: number;
-    data?: ParamData;
-}>;
-export declare function createOpraParamDecorator(paramType: HandlerParamType): ParameterDecorator;