@opra/core 0.33.13 → 1.0.0-alpha.10

package/types/index.d.ts

@@ -1,30 +1,28 @@
-import "reflect-metadata";
+import 'reflect-metadata';
 import './augmentation/18n.augmentation.js';
-import './augmentation/resource.augmentation.js';
-import './augmentation/collection.augmentation.js';
-import './augmentation/container.augmentation.js';
-import './augmentation/singleton.augmentation.js';
-import './augmentation/storage.augmentation.js';
+import './augmentation/http-controller.augmentation.js';
+import * as HttpIncomingHost_ from './http/impl/http-incoming.host.js';
+import * as HttpOutgoingHost_ from './http/impl/http-outgoing.host.js';
+import * as NodeIncomingMessageHost_ from './http/impl/node-incoming-message.host.js';
+import * as NodeOutgoingMessageHost_ from './http/impl/node-outgoing-message.host.js';
 export * from './execution-context.js';
-export * from './execution-context.host.js';
-export * from './platform-adapter.js';
-export * from './platform-adapter.host.js';
-export * from './request.js';
-export * from './request.host.js';
-export * from './request-context.js';
-export * from './response.js';
-export * from './response.host.js';
-export * from './http/adapters/express-adapter.js';
-export * from './http/adapters/express-adapter.host.js';
-export * from './http/adapters/node-http-adapter.js';
-export * from './http/adapters/node-http-adapter.host.js';
-export * from './http/impl/http-incoming-message.host.js';
-export * from './http/impl/http-outgoing-message.host.js';
-export * from './http/http-server-request.js';
-export * from './http/http-server-response.js';
-export * from './http/helpers/multipart-helper.js';
-export * from './interfaces/interceptor.interface.js';
+export * from './helpers/logger.js';
+export * from './helpers/service-base.js';
+export * from './http/express-adapter.js';
+export * from './http/http-adapter.js';
+export * from './http/http-context.js';
+export * from './http/impl/multipart-reader.js';
+export * from './http/interfaces/http-incoming.interface.js';
+export * from './http/interfaces/http-outgoing.interface.js';
+export * from './http/interfaces/node-incoming-message.interface.js';
+export * from './http/interfaces/node-outgoing-message.interface.js';
+export * from './http/utils/wrap-exception.js';
 export * from './interfaces/logger.interface.js';
-export * from './interfaces/request-handler.interface.js';
-export * from './services/logger.js';
-export * from './services/api-service.js';
+export * from './platform-adapter.js';
+export * from './type-guards.js';
+export declare namespace classes {
+    export import HttpIncomingHost = HttpIncomingHost_.HttpIncomingHost;
+    export import HttpOutgoingHost = HttpOutgoingHost_.HttpOutgoingHost;
+    export import NodeIncomingMessageHost = NodeIncomingMessageHost_.NodeIncomingMessageHost;
+    export import NodeOutgoingMessageHost = NodeOutgoingMessageHost_.NodeOutgoingMessageHost;
+}

package/types/platform-adapter.d.ts

@@ -1,56 +1,28 @@
-import { ApiDocument, FallbackLng, I18n, LanguageResource } from '@opra/common';
-import { Interceptor } from './interfaces/interceptor.interface.js';
-import { ILogger } from './interfaces/logger.interface.js';
-import { RequestHandler } from './interfaces/request-handler.interface.js';
-import { RequestContext } from './request-context.js';
-export type Protocol = 'http' | 'ws' | 'rpc';
-export interface PlatformAdapter extends RequestHandler {
-    readonly api: ApiDocument;
-    readonly protocol: Protocol;
-    readonly platform: string;
-    readonly serviceName: string;
-    /**
-     * Calls shutDown hook for all resources
-     */
-    close(): Promise<void>;
-}
+import './augmentation/18n.augmentation.js';
+import { ApiDocument, I18n, OpraSchema } from '@opra/common';
+import { AsyncEventEmitter } from 'strict-typed-events';
+import { kAssetCache } from './constants.js';
+import { Logger } from './helpers/logger.js';
+import { AssetCache } from './http/impl/asset-cache.js';
+import type { ILogger } from './interfaces/logger.interface';
 /**
  * @namespace PlatformAdapter
  */
 export declare namespace PlatformAdapter {
     interface Options {
-        i18n?: I18n | I18nOptions | (() => Promise<I18n>);
+        i18n?: I18n;
         logger?: ILogger;
-        interceptors?: Interceptor[];
-        on?: {
-            request?: (ctx: RequestContext) => void | Promise<void>;
-        };
-    }
-    interface I18nOptions {
-        /**
-         * Language to use
-         * @default undefined
-         */
-        lng?: string;
-        /**
-         * Language to use if translations in user language are not available.
-         * @default 'dev'
-         */
-        fallbackLng?: false | FallbackLng;
-        /**
-         * Default namespace used if not passed to translation function
-         * @default 'translation'
-         */
-        defaultNS?: string;
-        /**
-         * Resources to initialize with
-         * @default undefined
-         */
-        resources?: LanguageResource;
-        /**
-         * Resource directories to initialize with (if not using loading or not appending using addResourceBundle)
-         * @default undefined
-         */
-        resourceDirs?: string[];
     }
 }
+/**
+ * @class PlatformAdapter
+ */
+export declare abstract class PlatformAdapter extends AsyncEventEmitter {
+    protected [kAssetCache]: AssetCache;
+    readonly document: ApiDocument;
+    abstract readonly protocol: OpraSchema.Protocol;
+    logger: Logger;
+    i18n: I18n;
+    protected constructor(document: ApiDocument, options?: PlatformAdapter.Options);
+    abstract close(): Promise<void>;
+}

package/types/type-guards.d.ts

@@ -0,0 +1,8 @@
+import type { HttpIncoming } from './http/interfaces/http-incoming.interface.js';
+import type { HttpOutgoing } from './http/interfaces/http-outgoing.interface.js';
+import type { NodeIncomingMessage } from './http/interfaces/node-incoming-message.interface.js';
+import type { NodeOutgoingMessage } from './http/interfaces/node-outgoing-message.interface.js';
+export declare function isNodeIncomingMessage(v: any): v is NodeIncomingMessage;
+export declare function isHttpIncoming(v: any): v is HttpIncoming;
+export declare function isNodeOutgoingMessage(v: any): v is NodeOutgoingMessage;
+export declare function isHttpOutgoing(v: any): v is HttpOutgoing;

package/cjs/augmentation/collection.augmentation.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/augmentation/container.augmentation.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/augmentation/resource.augmentation.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const common_1 = require("@opra/common");
-// @ts-ignore
-const oldConstruct = common_1.Resource.prototype._construct;
-// @ts-ignore
-common_1.Resource.prototype._construct = function (init) {
-    oldConstruct.call(this, init);
-    const _this = this;
-    _this.onInit = init.onInit;
-    _this.onShutdown = init.onShutdown;
-};
-common_1.Collection.OnInit = common_1.Singleton.OnInit = function () {
-    return (target, propertyKey) => {
-        const sourceMetadata = (Reflect.getOwnMetadata(common_1.RESOURCE_METADATA, target.constructor) || {});
-        sourceMetadata.onInit = target[propertyKey];
-        Reflect.defineMetadata(common_1.RESOURCE_METADATA, target.constructor, sourceMetadata);
-    };
-};
-common_1.Collection.OnShutdown = common_1.Singleton.OnShutdown = function () {
-    return (target, propertyKey) => {
-        const sourceMetadata = (Reflect.getOwnMetadata(common_1.RESOURCE_METADATA, target.constructor) || {});
-        sourceMetadata.onShutdown = target[propertyKey];
-        Reflect.defineMetadata(common_1.RESOURCE_METADATA, target.constructor, sourceMetadata);
-    };
-};

package/cjs/augmentation/singleton.augmentation.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/augmentation/storage.augmentation.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/cjs/execution-context.host.js

@@ -1,46 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExecutionContextHost = void 0;
-const strict_typed_events_1 = require("strict-typed-events");
-class ExecutionContextHost extends strict_typed_events_1.AsyncEventEmitter {
-    constructor(api, platform, protocol) {
-        super();
-        this.api = api;
-        this.platform = platform;
-        this.ws = protocol.ws;
-        this.rpc = protocol.rpc;
-        if (protocol.http) {
-            this.protocol = 'http';
-            this.http = {
-                platform,
-                incoming: protocol.http.incoming,
-                outgoing: protocol.http.outgoing,
-                switchToContext: () => this
-            };
-        }
-        else if (protocol.ws) {
-            this.protocol = 'ws';
-            this.ws = protocol.ws;
-        }
-        else if (protocol.rpc) {
-            this.protocol = 'rpc';
-            this.rpc = protocol.rpc;
-        }
-    }
-    switchToHttp() {
-        if (this.http)
-            return this.http;
-        throw new TypeError('Not executing in an "Http" context');
-    }
-    switchToWs() {
-        if (this.ws)
-            return this.ws;
-        throw new TypeError('Not executing in an "WebSocket" context');
-    }
-    switchToRpc() {
-        if (this.rpc)
-            return this.rpc;
-        throw new TypeError('Not executing in an "RPC" context');
-    }
-}
-exports.ExecutionContextHost = ExecutionContextHost;

package/cjs/http/adapters/express-adapter.host.js

@@ -1,34 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpressAdapterHost = void 0;
-const common_1 = require("@opra/common");
-const http_adapter_host_js_1 = require("../http-adapter-host.js");
-const http_server_request_js_1 = require("../http-server-request.js");
-const http_server_response_js_1 = require("../http-server-response.js");
-class ExpressAdapterHost extends http_adapter_host_js_1.HttpAdapterHost {
-    constructor(app) {
-        super();
-        this._platform = 'express';
-        this._app = app;
-    }
-    get app() {
-        return this._app;
-    }
-    async init(api, options) {
-        await super.init(api, options);
-        this._api = api;
-        const basePath = new common_1.OpraURLPath(options?.basePath);
-        this._app.use(basePath.toString(), (_req, _res) => {
-            const req = http_server_request_js_1.HttpServerRequest.from(_req);
-            const res = http_server_response_js_1.HttpServerResponse.from(_res);
-            this.handleHttp(req, res)
-                .catch((e) => this._logger.fatal(e));
-        });
-    }
-    static async create(app, api, options) {
-        const adapter = new ExpressAdapterHost(app);
-        await adapter.init(api, options);
-        return adapter;
-    }
-}
-exports.ExpressAdapterHost = ExpressAdapterHost;

package/cjs/http/adapters/express-adapter.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.ExpressAdapter = void 0;
-const express_adapter_host_js_1 = require("./express-adapter.host.js");
-/**
- * @namespace
- */
-var ExpressAdapter;
-(function (ExpressAdapter) {
-    async function create(app, api, options) {
-        return express_adapter_host_js_1.ExpressAdapterHost.create(app, api, options);
-    }
-    ExpressAdapter.create = create;
-})(ExpressAdapter || (exports.ExpressAdapter = ExpressAdapter = {}));

package/cjs/http/adapters/node-http-adapter.host.js

@@ -1,70 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeHttpAdapterHost = void 0;
-const tslib_1 = require("tslib");
-const http_1 = tslib_1.__importDefault(require("http"));
-const common_1 = require("@opra/common");
-const http_adapter_host_js_1 = require("../http-adapter-host.js");
-const http_server_request_js_1 = require("../http-server-request.js");
-const http_server_response_js_1 = require("../http-server-response.js");
-/**
- * @class NodeHttpAdapterHost
- */
-class NodeHttpAdapterHost extends http_adapter_host_js_1.HttpAdapterHost {
-    constructor() {
-        super(...arguments);
-        this._platform = 'http';
-    }
-    get basePath() {
-        return this._basePath;
-    }
-    get server() {
-        return this._server;
-    }
-    async close() {
-        await super.close();
-        if (this.server.listening)
-            await new Promise((resolve, reject) => {
-                this.server.close((err) => {
-                    if (err)
-                        return reject(err);
-                    resolve();
-                });
-            });
-    }
-    async init(api, options) {
-        await super.init(api, options);
-        this._basePath = new common_1.OpraURLPath(options?.basePath);
-        this._server = http_1.default.createServer((incomingMessage, serverResponse) => this._serverListener(incomingMessage, serverResponse));
-    }
-    _serverListener(incomingMessage, serverResponse) {
-        const originalUrl = incomingMessage.url;
-        const parsedUrl = new common_1.OpraURL(originalUrl);
-        const relativePath = common_1.OpraURLPath.relative(parsedUrl.path, this.basePath);
-        if (!relativePath) {
-            serverResponse.statusCode = common_1.HttpStatusCode.NOT_FOUND;
-            serverResponse.statusMessage = common_1.HttpStatusMessages[common_1.HttpStatusCode.NOT_FOUND];
-            serverResponse.end();
-            return;
-        }
-        parsedUrl.path = relativePath;
-        incomingMessage.originalUrl = originalUrl;
-        incomingMessage.baseUrl = this.basePath.toString();
-        incomingMessage.parsedUrl = parsedUrl;
-        Object.defineProperty(incomingMessage, 'searchParams', {
-            get() {
-                return incomingMessage.parsedUrl.searchParams;
-            }
-        });
-        const req = http_server_request_js_1.HttpServerRequest.from(incomingMessage);
-        const res = http_server_response_js_1.HttpServerResponse.from(serverResponse);
-        this.handleHttp(req, res)
-            .catch((e) => this._logger.fatal(e));
-    }
-    static async create(api, options) {
-        const adapter = new NodeHttpAdapterHost();
-        await adapter.init(api, options);
-        return adapter;
-    }
-}
-exports.NodeHttpAdapterHost = NodeHttpAdapterHost;

package/cjs/http/adapters/node-http-adapter.js

@@ -1,14 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NodeHttpAdapter = void 0;
-const node_http_adapter_host_js_1 = require("./node-http-adapter.host.js");
-/**
- * @namespace NodeHttpAdapter
- */
-var NodeHttpAdapter;
-(function (NodeHttpAdapter) {
-    async function create(api, options) {
-        return node_http_adapter_host_js_1.NodeHttpAdapterHost.create(api, options);
-    }
-    NodeHttpAdapter.create = create;
-})(NodeHttpAdapter || (exports.NodeHttpAdapter = NodeHttpAdapter = {}));

package/cjs/http/helpers/json-body-loader.js

@@ -1,29 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.jsonBodyLoader = void 0;
-const tslib_1 = require("tslib");
-const body_parser_1 = tslib_1.__importDefault(require("body-parser"));
-const bodyLoaderCache = new WeakMap();
-function jsonBodyLoader(options, cachePoint) {
-    let bodyLoader = cachePoint ? bodyLoaderCache.get(cachePoint) : undefined;
-    if (bodyLoader)
-        return bodyLoader;
-    const parser = body_parser_1.default.json({
-        ...options,
-        type: 'json'
-    });
-    bodyLoader = (incoming) => {
-        return new Promise((resolve, reject) => {
-            const next = (error) => {
-                if (error)
-                    return reject(error);
-                resolve(incoming.body);
-            };
-            parser(incoming, {}, next);
-        });
-    };
-    if (cachePoint)
-        bodyLoaderCache.set(cachePoint, bodyLoader);
-    return bodyLoader;
-}
-exports.jsonBodyLoader = jsonBodyLoader;

package/cjs/http/helpers/query-parsers.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.parseArrayParam = void 0;
-const fast_tokenizer_1 = require("fast-tokenizer");
-function parseArrayParam(v) {
-    if (!v)
-        return;
-    return (0, fast_tokenizer_1.splitString)(v, {
-        delimiters: ',',
-        quotes: true,
-        brackets: true,
-        keepBrackets: true,
-        keepQuotes: true
-    }).map(x => x.trim());
-}
-exports.parseArrayParam = parseArrayParam;