@stemy/backend 6.0.3 → 6.1.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@stemy/backend",
-  "version": "6.0.3",
+  "version": "6.1.0",
   "license": "MIT",
   "repository": "git@github.com:stemyke/node-backend.git",
   "builders": "builders.json",
@@ -46,7 +46,8 @@
     "tz-offset": "^0.0.2",
     "fontkit": "^2.0.4",
     "moment": "^2.30.1",
-    "@stemy/terminal-commands-addon": "1.0.0",
+    "got": "^14.4.5",
+    "@stemy/terminal-commands-addon": "^1.1.0",
     "tslib": "^2.3.0"
   },
   "module": "fesm2022/stemy-backend.mjs",

package/public_api.d.ts

@@ -1,9 +1,10 @@
 import { IBackendConfig, IDependencyContainer, IRequest, IUser, Provider } from "./common-types";
 export { FilterPredicate, isNullOrUndefined, isDefined, getType, isObject, isArray, isBuffer, isBoolean, isDate, isPrimitive, isString, isFunction, isConstructor, isType, isInterface, ucFirst, lcFirst, isObjectId, firstItem, lastItem, regroup, uniqueItems, getValue, groupBy, convertValue, toImage, bufferToStream, streamToBuffer, copyStream, mkdirRecursive, deleteFile, readFile, readAndDeleteFile, writeFile, valueToPromise, promiseTimeout, getConstructorName, getFunctionParams, getFileName, getExtension, createIdString, idToString, createTransformer, broadcast, rand, random, multiSubscription, observableFromFunction, padLeft, padRight, camelCaseToDash, gzipPromised, gunzipPromised, deleteFromBucket, filter, copy, assign, md5, runCommand, ConsoleColor, IJsonColors, colorize, jsonHighlight, replaceSpecialChars, regexEscape, flatten, wrapError, getDirName, prepareUrl, prepareUrlSlash, prepareUrlEmpty, fileTypeFromBuffer } from "./utils";
 export { IsFile, IsObjectId } from "./validators";
-export { FIXTURE, JOB, TERMINAL_COMMAND, EXPRESS, HTTP_SERVER, SOCKET_SERVER, SOCKET_CONTROLLERS, PARAMETER, DI_CONTAINER, OPENAPI_VALIDATION, Type, FactoryProvider, IDependencyContainer, ClassBasedProvider, ValueBasedProvider, FactoryBasedProvider, TokenBasedProvider, SyringeProvider, Provider, Constructor, InferGeneric, PickMatching, OmitFirstArg, IMatchField, IProjectOptions, IUnwindOptions, IFixture, IFixtureOutput, SchemaConverter, OpenApiValidation, ParamResolver, Parameter, SocketParam, SocketParams, ISocketMessage, IMessageBridge, IJob, IJobTask, JobParams, JobScheduleRange, JobScheduleTime, ITerminalFile, ITerminal, ITerminalCommand, IProgress, IAssetCropInfo, IImageMeta, IAssetMeta, IAssetImageParams, IAsset, IAssetUploadStream, IAssetUploadOpts, IAssetDriver, ILazyAsset, IUser, IClientSocket, IRequestBase, IRequest, IGalleryImage, IGallerySize, IGalleryImageHandler, ITranslations, IPaginationMeta, IPaginationBase, IPagination, IPaginationParams, FontFormat, IFileType, RoutingOptions, SocketOptions, IBackendConfig } from "./common-types";
+export { FIXTURE, JOB, TERMINAL_COMMAND, EXPRESS, HTTP_SERVER, SOCKET_SERVER, SOCKET_CONTROLLERS, PARAMETER, DI_CONTAINER, OPENAPI_VALIDATION, Type, FactoryProvider, IDependencyContainer, ClassBasedProvider, ValueBasedProvider, FactoryBasedProvider, TokenBasedProvider, SyringeProvider, Provider, Constructor, InferGeneric, PickMatching, OmitFirstArg, IMatchField, IProjectOptions, IUnwindOptions, IFixture, IFixtureOutput, SchemaConverter, OpenApiValidation, ParamResolver, Parameter, SocketParam, SocketParams, ISocketMessage, IMessageBridge, IJob, IJobTask, JobParams, JobScheduleRange, JobScheduleTime, ITerminalFile, ITerminal, ITerminalCommand, IProgress, IAssetCropInfo, IImageMeta, IAssetMeta, IAssetImageParams, IAsset, IAssetUploadStream, IAssetUploadOpts, IAssetDriver, IAssetDrivers, ILazyAsset, AssetDriverFactoryMap, IUser, IClientSocket, IRequestBase, IRequest, IGalleryImage, IGallerySize, IGalleryImageHandler, ITranslations, IPaginationMeta, IPaginationBase, IPagination, IPaginationParams, FontFormat, IFileType, RoutingOptions, SocketOptions, IBackendConfig } from "./common-types";
 export { AssetLocalDriver } from "./services/drivers/asset-local.driver";
 export { AssetGridDriver } from "./services/drivers/asset-grid.driver";
+export { AssetStorageProxyDriver } from "./services/drivers/asset-storage-proxy.driver";
 export { AssetProcessor } from "./services/asset-processor";
 export { AssetResolver } from "./services/asset-resolver";
 export { Assets } from "./services/assets";

package/services/assets.d.ts

@@ -2,15 +2,23 @@ import { Readable } from "stream";
 import { ObjectId } from "bson";
 import { Collection } from "mongodb";
 import { FilterQuery } from "mongoose";
-import { IAsset, IAssetDriver, IAssetMeta, IFileType } from "../common-types";
+import { AssetDriverFactoryMap, IAsset, IAssetDriver, IAssetDrivers, IAssetMeta, IDependencyContainer, IFileType } from "../common-types";
 import { MongoConnector } from "./mongo-connector";
 import { AssetProcessor } from "./asset-processor";
-export declare class Assets {
+import { Configuration } from "./configuration";
+export declare class Assets implements IAssetDrivers {
     readonly connector: MongoConnector;
     readonly assetProcessor: AssetProcessor;
-    readonly driver: IAssetDriver;
-    readonly collection: Collection<Partial<IAsset>>;
-    constructor(connector: MongoConnector, assetProcessor: AssetProcessor, driver: IAssetDriver);
+    readonly config: Configuration;
+    protected readonly container: IDependencyContainer;
+    protected readonly driverFactoryMap: AssetDriverFactoryMap;
+    protected readonly collection: Collection<Partial<IAsset>>;
+    protected readonly driverMap: Map<string, IAssetDriver>;
+    readonly mainDriver: string;
+    readonly missingDriver: string;
+    readonly drivers: ReadonlyArray<string>;
+    constructor(connector: MongoConnector, assetProcessor: AssetProcessor, config: Configuration, container: IDependencyContainer, driverFactoryMap: AssetDriverFactoryMap);
+    getDriver(name: string): IAssetDriver;
     write(stream: Readable, contentType?: string, metadata?: IAssetMeta): Promise<IAsset>;
     writeBuffer(buffer: Buffer, metadata?: IAssetMeta, contentType?: string): Promise<IAsset>;
     writeUrl(url: string, metadata?: IAssetMeta): Promise<IAsset>;

package/services/cli-terminal.d.ts

@@ -0,0 +1,18 @@
+import { IDisposable, ITerminalAddon } from "@stemy/terminal-commands-addon";
+import { ITerminal } from "../common-types";
+export declare class CliTerminal implements ITerminal {
+    private callbacks;
+    private stdin;
+    constructor();
+    private clearScreen;
+    private handleInput;
+    /**
+     * Registers a listener for data input.
+     * Returns an IDisposable to unregister the listener.
+     */
+    onData(cb: (data: string) => any): IDisposable;
+    write(data: string): void;
+    writeln(data: string): void;
+    loadAddon(addon: ITerminalAddon): void;
+    dispose(): void;
+}

package/services/configuration.d.ts

@@ -1,5 +1,6 @@
 import { Parameter } from "../common-types";
 export declare class Configuration {
+    readonly isCli: boolean;
     protected paramMap: {
         [name: string]: Parameter;
     };
@@ -12,4 +13,5 @@ export declare class Configuration {
     hasParam(name: string): boolean;
     resolve(name: string): any;
     protected resolveInternal(name: string, alreadyResolved: string[]): any;
+    protected log(...args: any[]): void;
 }

package/services/drivers/asset-fallback-driver.d.ts

@@ -0,0 +1,11 @@
+import { Readable } from "stream";
+import { ObjectId } from "bson";
+import { IAssetDriver, IAssetUploadOpts, IAssetUploadStream } from "../../common-types";
+export declare class AssetFallbackDriver implements IAssetDriver {
+    protected main: IAssetDriver;
+    protected fallback: IAssetDriver;
+    constructor(main: IAssetDriver, fallback: IAssetDriver);
+    openDownloadStream(id: ObjectId): Readable;
+    openUploadStream(filename: string, opts?: IAssetUploadOpts): IAssetUploadStream;
+    delete(id: ObjectId): Promise<void>;
+}

package/services/drivers/asset-grid.driver.d.ts

@@ -1,11 +1,10 @@
-import { GridFSBucket, ObjectId } from 'mongodb';
-import { IAssetDriver, IAssetUploadOpts } from '../../common-types';
+import { GridFSBucket } from 'mongodb';
+import { IAsset, IAssetDriver, IAssetUploadOpts } from '../../common-types';
 import { MongoConnector } from "../mongo-connector";
 export declare class AssetGridDriver implements IAssetDriver {
-    readonly metaCollection: string;
     protected bucket: GridFSBucket;
     constructor(connector: MongoConnector);
     openUploadStream(filename: string, opts?: IAssetUploadOpts): import("mongodb").GridFSBucketWriteStream;
-    openDownloadStream(id: ObjectId): import("mongodb").GridFSBucketReadStream;
-    delete(id: ObjectId): Promise<void>;
+    openDownloadStream(asset: IAsset): import("mongodb").GridFSBucketReadStream;
+    delete(asset: IAsset): Promise<void>;
 }

package/services/drivers/asset-local.driver.d.ts

@@ -1,10 +1,10 @@
-import type { ObjectId } from 'mongodb';
-import { IAssetDriver, IAssetUploadOpts, IAssetUploadStream } from '../../common-types';
+import { ObjectId } from 'bson';
+import { IAsset, IAssetDriver, IAssetUploadOpts, IAssetUploadStream } from '../../common-types';
 export declare class AssetLocalDriver implements IAssetDriver {
     protected dir: string;
-    readonly metaCollection: string;
     constructor(dir: string);
-    openUploadStream(filename: string, opts?: IAssetUploadOpts): IAssetUploadStream;
-    openDownloadStream(id: ObjectId): import("fs").ReadStream;
-    delete(id: ObjectId): Promise<void>;
+    openUploadStream(filename: string, opts: IAssetUploadOpts): IAssetUploadStream;
+    openDownloadStream(asset: IAsset): import("fs").ReadStream;
+    delete(asset: IAsset): Promise<void>;
+    protected getPath(id: ObjectId, name: string, ext: string): string;
 }

package/services/drivers/asset-storage-proxy.driver.d.ts

@@ -0,0 +1,14 @@
+import { Readable } from "stream";
+import { ObjectId } from "bson";
+import { IAsset, IAssetDriver, IAssetUploadOpts, IAssetUploadStream } from "../../common-types";
+import { Configuration } from "../configuration";
+export declare class AssetStorageProxyDriver implements IAssetDriver {
+    protected config: Configuration;
+    readonly baseUrl: string;
+    readonly url: string;
+    constructor(config: Configuration);
+    openUploadStream(_: string, opts: IAssetUploadOpts): IAssetUploadStream;
+    openDownloadStream(asset: IAsset): Readable;
+    delete(asset: IAsset): Promise<void>;
+    protected getUrl(id: ObjectId, ext?: string): string;
+}

package/services/drivers/fallback-readable.d.ts

@@ -0,0 +1,2 @@
+import { Readable } from 'stream';
+export declare function createFallbackReadable(primary: Readable, fallbackFactory: () => Readable): Readable;

package/services/drivers/fallback-streams.d.ts

@@ -0,0 +1,2 @@
+import { Readable } from 'stream';
+export declare function createFallbackReadable(primary: Readable, fallbackFactory: () => Readable): Readable;

package/services/entities/asset.d.ts

@@ -1,18 +1,23 @@
 import { Readable } from "stream";
 import { Collection } from "mongodb";
 import { ObjectId } from "bson";
-import { IAsset, IAssetDriver, IAssetImageParams, IAssetMeta } from "../../common-types";
+import { IAsset, IAssetDriver, IAssetDrivers, IAssetImageParams, IAssetMeta } from "../../common-types";
 import { BaseEntity } from "./base-entity";
 export declare class Asset extends BaseEntity<IAsset> implements IAsset {
-    protected driver: IAssetDriver;
+    protected drivers: IAssetDrivers;
     get filename(): string;
+    get streamId(): ObjectId;
+    get driverId(): string;
+    get driver(): IAssetDriver;
     get contentType(): string;
     get metadata(): IAssetMeta;
     get stream(): Readable;
-    constructor(id: ObjectId, data: Partial<IAsset>, collection: Collection, driver: IAssetDriver);
+    constructor(id: ObjectId, data: Partial<IAsset>, collection: Collection, drivers: IAssetDrivers);
     unlink(): Promise<string>;
     setMeta(metadata: Partial<IAssetMeta>): Promise<any>;
     getBuffer(): Promise<Buffer>;
+    move(driverId: string): Promise<IAsset>;
+    protected uploadTo(driver: IAssetDriver): Promise<ObjectId>;
     download(metadata?: IAssetMeta): Promise<Readable>;
     getImage(params?: IAssetImageParams): Promise<Readable>;
     downloadImage(params?: IAssetImageParams, metadata?: IAssetMeta): Promise<Readable>;

package/services/entities/temp-asset.d.ts

@@ -1,16 +1,21 @@
 import { Readable } from "stream";
+import { ObjectId } from "bson";
 import { IAsset, IAssetImageParams, IAssetMeta } from "../../common-types";
 export declare class TempAsset implements IAsset {
     protected buffer: Buffer;
     readonly filename: string;
     readonly contentType: string;
     readonly metadata: IAssetMeta;
-    readonly id: string;
+    get id(): string;
+    get streamId(): ObjectId;
+    get driverId(): string;
     get stream(): Readable;
+    protected readonly oid: ObjectId;
     constructor(buffer: Buffer, filename: string, contentType: string, metadata: IAssetMeta);
     unlink(): Promise<string>;
     setMeta(meta: Partial<IAssetMeta>): Promise<any>;
     getBuffer(): Promise<Buffer>;
+    move(): Promise<IAsset>;
     download(metadata?: IAssetMeta): Promise<Readable>;
     downloadImage(params?: IAssetImageParams, metadata?: IAssetMeta): Promise<Readable>;
     getImage(params?: IAssetImageParams): Promise<Readable>;

package/services/terminal-manager.d.ts

@@ -2,14 +2,17 @@ import { ICommandMap, ISuggestionMap } from "@stemy/terminal-commands-addon";
 import { ITerminal, ITerminalCommand } from "../common-types";
 import { Logger } from "./logger";
 import { Configuration } from "./configuration";
+import { CliTerminal } from "./cli-terminal";
 export declare class TerminalManager {
     protected logger: Logger;
     protected config: Configuration;
+    protected cliTerminal: CliTerminal;
     protected servicePassword: string;
     protected suggestions: ISuggestionMap;
     protected commands: ICommandMap;
     protected loggedOutCommands: string[];
     protected loggedInCommands: string[];
     constructor(logger: Logger, config: Configuration, commands: ITerminalCommand[]);
+    runCli(): void;
     loadAddons(terminal: ITerminal): void;
 }

package/socket-controllers/socket-terminal.d.ts

@@ -0,0 +1,19 @@
+import { BehaviorSubject, Subject } from "rxjs";
+import { IDisposable, ITerminalAddon } from "@stemy/terminal-commands-addon";
+import { IClientSocket, ITerminal, ITerminalFile } from "../common-types";
+export declare class SocketTerminal implements ITerminal {
+    protected client: IClientSocket;
+    protected addons: ITerminalAddon[];
+    protected files$: BehaviorSubject<ITerminalFile[]>;
+    protected input$: Subject<string>;
+    constructor(client: IClientSocket);
+    onData(cb: (data: string) => any): IDisposable;
+    write(data: string): void;
+    writeln(data: string): void;
+    loadAddon(addon: ITerminalAddon): void;
+    dispose(): void;
+    suggestFiles(accept: string): Promise<ITerminalFile[]>;
+    downloadFile(filename: string, buffer: Buffer): Promise<void>;
+    addFile(upload: ITerminalFile): void;
+    input(data: string): void;
+}

package/socket-controllers/terminal.controller.d.ts

@@ -1,10 +1,10 @@
 import { IClientSocket, ITerminalFile } from "../common-types";
 import { TerminalManager } from "../services/terminal-manager";
-import { Terminal } from "./terminal";
+import { SocketTerminal } from "./socket-terminal";
 export declare class TerminalController {
     protected manager: TerminalManager;
     protected terminals: {
-        [id: string]: Terminal;
+        [id: string]: SocketTerminal;
     };
     constructor(manager: TerminalManager);
     terminalInit(client: IClientSocket): Promise<void>;