@opra/core 1.0.0-alpha.3 → 1.0.0-alpha.30

package/types/http/{impl/http-handler.d.ts → http-handler.d.ts}

@@ -1,9 +1,8 @@
-import { HttpOperationResponse } from '@opra/common';
-import { kAssetCache } from '../../constants.js';
-import type { HttpAdapter } from '../http-adapter.js';
-import { HttpContext } from '../http-context.js';
-import { HttpOutgoing } from '../interfaces/http-outgoing.interface.js';
-import { AssetCache } from './asset-cache.js';
+import { HttpOperationResponse, OpraException, OpraHttpError } from '@opra/common';
+import { kAssetCache } from '../constants';
+import type { HttpAdapter } from './http-adapter';
+import { HttpContext } from './http-context';
+import { AssetCache } from './impl/asset-cache';
 /**
  * @namespace
  */
@@ -16,6 +15,7 @@ export declare namespace HttpHandler {
         contentType?: string;
         operationResponse?: HttpOperationResponse;
         body?: any;
+        projection?: string[] | '*';
     }
 }
 /**
@@ -24,6 +24,7 @@ export declare namespace HttpHandler {
 export declare class HttpHandler {
     readonly adapter: HttpAdapter;
     protected [kAssetCache]: AssetCache;
+    onError?: (context: HttpContext, error: OpraException) => void | Promise<void>;
     constructor(adapter: HttpAdapter);
     /**
      * Main http request handler
@@ -60,7 +61,9 @@ export declare class HttpHandler {
      * @param responseValue
      * @protected
      */
-    protected _sendResponse(context: HttpContext, responseValue: any): Promise<void>;
+    sendResponse(context: HttpContext, responseValue?: any): Promise<void>;
+    protected _sendErrorResponse(context: HttpContext): Promise<void>;
+    sendDocumentSchema(context: HttpContext): Promise<void>;
     /**
      *
      * @param context
@@ -68,6 +71,5 @@ export declare class HttpHandler {
      * @protected
      */
     protected _determineResponseArgs(context: HttpContext, body: any): HttpHandler.ResponseArgs;
-    sendDocumentSchema(context: HttpContext): Promise<void>;
-    sendErrorResponse(response: HttpOutgoing, errors: any[]): Promise<void>;
+    protected _wrapExceptions(exceptions: any[]): OpraHttpError[];
 }

package/types/http/impl/http-incoming.host.d.ts

@@ -1,6 +1,5 @@
-/// <reference types="node" />
 import parseRange from 'range-parser';
-import type { HttpIncoming } from '../interfaces/http-incoming.interface';
+import type { HttpIncoming } from '../interfaces/http-incoming.interface.js';
 import { BodyReader } from '../utils/body-reader.js';
 export interface HttpIncomingHost extends HttpIncoming {
 }

package/types/http/impl/http-outgoing.host.d.ts

@@ -1,4 +1,4 @@
-import type { CookieOptions, HttpOutgoing } from '../interfaces/http-outgoing.interface';
+import type { CookieOptions, HttpOutgoing } from '../interfaces/http-outgoing.interface.js';
 export interface HttpOutgoingHost extends HttpOutgoing {
 }
 export declare class HttpOutgoingHost {

package/types/http/impl/multipart-reader.d.ts

@@ -1,28 +1,46 @@
-/// <reference types="node" />
+import { HttpMediaType } from '@opra/common';
+import busboy from 'busboy';
 import { EventEmitter } from 'events';
-import formidable from 'formidable';
-import type IncomingForm from 'formidable/Formidable.js';
-import type { NodeIncomingMessage } from '../interfaces/node-incoming-message.interface.js';
-export type MultipartFile = formidable.File;
-export type MultipartItem = {
-    fieldName: string;
-    type: 'field' | 'file';
-    value?: string;
-    file?: MultipartFile;
-};
+import { StrictOmit } from 'ts-gems';
+import { HttpContext } from '../http-context';
+export declare namespace MultipartReader {
+    interface Options extends StrictOmit<busboy.BusboyConfig, 'headers'> {
+        tempDirectory?: string;
+    }
+    interface FieldInfo {
+        kind: 'field';
+        field: string;
+        value?: any;
+        mimeType?: string;
+        encoding?: string;
+    }
+    interface FileInfo {
+        kind: 'file';
+        field: string;
+        filename: string;
+        storedPath: string;
+        mimeType?: string;
+        encoding?: string;
+    }
+    type Item = FieldInfo | FileInfo;
+}
 export declare class MultipartReader extends EventEmitter {
-    protected _incoming: NodeIncomingMessage;
+    protected context: HttpContext;
+    protected mediaType?: HttpMediaType | undefined;
     protected _started: boolean;
+    protected _finished: boolean;
     protected _cancelled: boolean;
-    protected _form: IncomingForm;
-    protected _items: MultipartItem[];
-    protected _stack: MultipartItem[];
-    constructor(incoming: NodeIncomingMessage, options?: formidable.Options);
-    get items(): MultipartItem[];
-    getNext(): Promise<MultipartItem | undefined>;
-    getAll(): Promise<MultipartItem[]>;
+    protected _form: busboy.Busboy;
+    protected _items: MultipartReader.Item[];
+    protected _stack: MultipartReader.Item[];
+    protected tempDirectory: string;
+    constructor(context: HttpContext, options?: MultipartReader.Options, mediaType?: HttpMediaType | undefined);
+    get items(): MultipartReader.Item[];
+    getNext(): Promise<MultipartReader.Item | undefined>;
+    getAll(): Promise<MultipartReader.Item[]>;
+    getAll_(): Promise<MultipartReader.Item[]>;
     cancel(): void;
     resume(): void;
     pause(): void;
-    deleteTempFiles(): Promise<PromiseSettledResult<any>[]>;
+    purge(): Promise<PromiseSettledResult<any>[]>;
 }

package/types/http/impl/node-incoming-message.host.d.ts

@@ -1,11 +1,7 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
+import { HTTPParserJS } from '@browsery/http-parser';
 import { IncomingHttpHeaders } from 'http';
 import { Duplex, Readable } from 'stream';
-import { HTTPParserJS } from '@browsery/http-parser';
-import type { NodeIncomingMessage } from '../interfaces/node-incoming-message.interface';
+import type { NodeIncomingMessage } from '../interfaces/node-incoming-message.interface.js';
 export declare const CRLF: Buffer;
 export declare const kHeaders: unique symbol;
 export declare const kHeadersDistinct: unique symbol;

package/types/http/impl/node-outgoing-message.host.d.ts

@@ -1,10 +1,7 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
 import { OutgoingHttpHeaders } from 'http';
 import { Duplex } from 'stream';
-import type { NodeIncomingMessage } from '../interfaces/node-incoming-message.interface';
-import type { NodeOutgoingMessage } from '../interfaces/node-outgoing-message.interface';
+import type { NodeIncomingMessage } from '../interfaces/node-incoming-message.interface.js';
+import type { NodeOutgoingMessage } from '../interfaces/node-outgoing-message.interface.js';
 export declare const kOutHeaders: unique symbol;
 export declare const kOutTrailers: unique symbol;
 declare global {
@@ -18,8 +15,8 @@ declare global {
  * @class NodeOutgoingMessageHost
  */
 export declare class NodeOutgoingMessageHost extends Duplex implements NodeOutgoingMessage {
-    protected [kOutHeaders]: Record<string, any>;
-    protected [kOutTrailers]: Record<string, any>;
+    protected [kOutHeaders]?: Record<string, any>;
+    protected [kOutTrailers]?: Record<string, any>;
     protected _headersSent: boolean;
     protected _httpVersionMajor?: number;
     protected _httpVersionMinor?: number;

package/types/http/interfaces/http-incoming.interface.d.ts

@@ -1,7 +1,6 @@
-/// <reference types="node" />
 import { Options as RangeParserOptions, Ranges as RangeParserRanges, Result as RangeParserResult } from 'range-parser';
 import { BodyReader } from '../utils/body-reader.js';
-import type { HttpOutgoing } from './http-outgoing.interface';
+import type { HttpOutgoing } from './http-outgoing.interface.js';
 import { NodeIncomingMessage } from './node-incoming-message.interface.js';
 /**
  * @interface HttpIncoming

package/types/http/interfaces/http-outgoing.interface.d.ts

@@ -1,5 +1,5 @@
 import { StrictOmit } from 'ts-gems';
-import type { HttpIncoming } from './http-incoming.interface';
+import type { HttpIncoming } from './http-incoming.interface.js';
 import { NodeOutgoingMessage } from './node-outgoing-message.interface.js';
 export interface HttpOutgoing extends StrictOmit<NodeOutgoingMessage, 'req' | 'appendHeader' | 'setHeader'> {
     req: HttpIncoming;

package/types/http/interfaces/node-incoming-message.interface.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import http from 'http';
 import { Readable } from 'stream';
 /**

package/types/http/interfaces/node-outgoing-message.interface.d.ts

@@ -1,5 +1,3 @@
-/// <reference types="node" />
-/// <reference types="node" />
 import http, { OutgoingHttpHeaders } from 'http';
 import { Writable } from 'stream';
 import { NodeIncomingMessage } from './node-incoming-message.interface.js';

package/types/http/utils/body-reader.d.ts

@@ -1,8 +1,5 @@
-/// <reference types="node" />
-/// <reference types="node" />
-/// <reference types="node" />
-import { EventEmitter } from 'events';
 import nodeStream from 'node:stream';
+import { EventEmitter } from 'events';
 import type { HttpIncoming } from '../interfaces/http-incoming.interface.js';
 /**
  *
@@ -21,7 +18,7 @@ type Callback = (...args: any[]) => any;
 export declare class BodyReader extends EventEmitter {
     readonly req: HttpIncoming;
     limit?: number;
-    protected _stream: nodeStream.Readable;
+    protected _stream?: nodeStream.Readable;
     protected _buffer?: string | Buffer[];
     protected _completed?: boolean | undefined;
     protected _receivedSize: number;

package/types/http/utils/concat-readable.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="node" />
 import { Readable } from 'stream';
 export declare function concatReadable(...streams: Readable[]): Readable;

package/types/http/utils/convert-to-raw-headers.d.ts

@@ -1,3 +1,2 @@
-/// <reference types="node" />
 import { IncomingHttpHeaders } from 'http';
 export declare function convertToRawHeaders(src: IncomingHttpHeaders | Record<string, any>): string[];

package/types/index.d.ts

@@ -6,20 +6,20 @@ 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 './platform-adapter.js';
-export * from './type-guards.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/http-handler.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/impl/multipart-reader.js';
 export * from './http/utils/wrap-exception.js';
 export * from './interfaces/logger.interface.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;

package/types/platform-adapter.d.ts

@@ -1,17 +1,14 @@
 import './augmentation/18n.augmentation.js';
-import { AsyncEventEmitter } from 'strict-typed-events';
 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;
-        logger?: ILogger;
     }
 }
 /**
@@ -21,7 +18,6 @@ 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/cjs/helpers/logger.js

@@ -1,35 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.Logger = void 0;
-class Logger {
-    constructor(options = {}) {
-        this._instance = options.instance || (!(process.env.NODE_ENV || '').includes('test') ? globalThis.console : {});
-    }
-    info(message, ...optionalParams) {
-        (this._instance.info || this._instance.log)?.(message, ...optionalParams);
-    }
-    error(message, ...optionalParams) {
-        if (this._instance.error) {
-            this._instance.error(message, ...optionalParams);
-            return;
-        }
-        this.info(message, ...optionalParams);
-    }
-    fatal(message, ...optionalParams) {
-        if (this._instance.fatal) {
-            this._instance.fatal(message, ...optionalParams);
-            return;
-        }
-        this.error(message, ...optionalParams);
-    }
-    warn(message, ...optionalParams) {
-        this._instance.warn?.(message, ...optionalParams);
-    }
-    debug(message, ...optionalParams) {
-        this._instance.debug?.(message, ...optionalParams);
-    }
-    verbose(message, ...optionalParams) {
-        this._instance.verbose?.(message, ...optionalParams);
-    }
-}
-exports.Logger = Logger;

package/esm/helpers/logger.js

@@ -1,31 +0,0 @@
-export class Logger {
-    constructor(options = {}) {
-        this._instance = options.instance || (!(process.env.NODE_ENV || '').includes('test') ? globalThis.console : {});
-    }
-    info(message, ...optionalParams) {
-        (this._instance.info || this._instance.log)?.(message, ...optionalParams);
-    }
-    error(message, ...optionalParams) {
-        if (this._instance.error) {
-            this._instance.error(message, ...optionalParams);
-            return;
-        }
-        this.info(message, ...optionalParams);
-    }
-    fatal(message, ...optionalParams) {
-        if (this._instance.fatal) {
-            this._instance.fatal(message, ...optionalParams);
-            return;
-        }
-        this.error(message, ...optionalParams);
-    }
-    warn(message, ...optionalParams) {
-        this._instance.warn?.(message, ...optionalParams);
-    }
-    debug(message, ...optionalParams) {
-        this._instance.debug?.(message, ...optionalParams);
-    }
-    verbose(message, ...optionalParams) {
-        this._instance.verbose?.(message, ...optionalParams);
-    }
-}

package/types/helpers/logger.d.ts

@@ -1,14 +0,0 @@
-import { ILogger } from '../interfaces/logger.interface.js';
-export interface LoggerOptions {
-    instance?: ILogger;
-}
-export declare class Logger implements ILogger {
-    protected _instance: ILogger;
-    constructor(options?: LoggerOptions);
-    info(message: any, ...optionalParams: any[]): void;
-    error(message: any, ...optionalParams: any[]): void;
-    fatal(message: any, ...optionalParams: any[]): void;
-    warn(message: any, ...optionalParams: any[]): void;
-    debug(message: any, ...optionalParams: any[]): void;
-    verbose(message: any, ...optionalParams: any[]): void;
-}