@webda/core 4.0.0-beta.2 → 4.0.0-beta.3

package/lib/contexts/webcontext.js

@@ -0,0 +1,389 @@
+import { OperationContext } from "./operationcontext.js";
+import acceptLanguage from "accept-language";
+import { Readable } from "node:stream";
+import { WritableStreamBuffer } from "stream-buffers";
+import { useCore, useDynamicService, useService } from "../core/hooks.js";
+/**
+ * @category CoreFeatures
+ */
+class Cookie {
+    name;
+    value;
+    options;
+}
+/**
+ * This represent in fact a WebContext
+ * In 3.0 an abstract version of Context will replace this (closer to OperationContext)
+ * @category CoreFeatures
+ *
+ */
+export class WebContext extends OperationContext {
+    /**
+     * Contains the response headers
+     */
+    _outputHeaders;
+    /**
+     * Current status code
+     */
+    statusCode;
+    /**
+     * Cookies to send back
+     */
+    _cookie;
+    /**
+     *
+     */
+    headers;
+    _route;
+    _ended = undefined;
+    /**
+     * If headers were flushed
+     */
+    headersFlushed;
+    _init;
+    /**
+     * Set current http context
+     * @param httpContext current http context
+     */
+    setHttpContext(httpContext) {
+        this.setExtension("http", httpContext);
+        this.reinit();
+    }
+    /**
+     * Get current http context
+     * @returns the result
+     */
+    getHttpContext() {
+        return this.getExtension("http");
+    }
+    /**
+     * @override
+     */
+    async getRawInputAsString(limit = 1024 * 1024 * 10, timeout = 60000, encoding) {
+        return this.getHttpContext().getRawBodyAsString(limit, timeout, encoding);
+    }
+    /**
+     * A multipart body (file upload) is never JSON: return the default value
+     * instead of letting the parent try to `JSON.parse` it and log an error.
+     * The raw body stays available to `getRawInput()`/`getRawStream()`.
+     * @override
+     */
+    async getInput(sanitizedOptions) {
+        if (this.getHttpContext()?.getUniqueHeader("content-type", "").toLowerCase().startsWith("multipart/")) {
+            return sanitizedOptions?.defaultValue;
+        }
+        return super.getInput(sanitizedOptions);
+    }
+    /**
+     * @override
+     */
+    async getRawInput(limit = 1024 * 1024 * 10, timeout = 60000) {
+        return (await this.getHttpContext().getRawBody(limit, timeout)) || Buffer.from("");
+    }
+    /**
+     * @override
+     */
+    getRawStream() {
+        return this.getHttpContext().getRawStream();
+    }
+    /**
+     * Remove everything that was about to be sent
+     */
+    resetResponse() {
+        this._outputHeaders = {};
+        super.resetResponse();
+    }
+    /**
+     * Write data to the client
+     *
+     * @param output If it is an object it will be serializeb with toPublicJSON, if it is a String it will be appended to the result, if it is a buffer it will replace the result
+     * @param ...args any arguments to pass to the toPublicJSON method
+     * @param encoding - the encoding to use
+     * @param cb - the callback function
+     * @returns true if the condition is met
+     */
+    // @ts-ignore
+    write(output, encoding, cb) {
+        if (this.statusCode === 204) {
+            this.statusCode = 200;
+        }
+        if (typeof output === "object" && !(output instanceof Buffer) && !this.hasFlushedHeaders()) {
+            this.setHeader("Content-type", "application/json");
+        }
+        return super.write(output, encoding, cb);
+    }
+    /**
+     * Write the http return code and some headers
+     * Those headers are not flushed yet so can still be overwritten
+     *
+     * @param {Number} statusCode to return to the client
+     * @param {Object} headers to add to the response
+     * @returns this for chaining
+     */
+    writeHead(statusCode, headers = undefined) {
+        Object.entries(headers || {}).forEach(([key, value]) => {
+            this.setHeader(key, value);
+        });
+        if (statusCode !== undefined) {
+            this.statusCode = statusCode;
+        }
+        return this;
+    }
+    /**
+     *
+     * @returns the result
+     */
+    getResponseCode() {
+        return this.statusCode || 200;
+    }
+    /**
+     * Redirect to another url
+     * @param url - the URL
+     */
+    redirect(url) {
+        this.writeHead(302, { Location: url });
+    }
+    /**
+     * For compatibility reason
+     * @param param - the parameter name
+     * @param value - the value to set
+     * @param options - the options
+     */
+    cookie(param, value, options = undefined) {
+        /** @ignore */
+        if (this._cookie === undefined) {
+            this._cookie = new Map();
+        }
+        this._cookie[param] = { name: param, value, options };
+    }
+    /**
+     * Get all cookies set on the response
+     * @returns the result map
+     */
+    getResponseCookies() {
+        return this._cookie;
+    }
+    /**
+     * Whether the response has been ended
+     * @returns the result
+     */
+    isEnded() {
+        return this._ended;
+    }
+    /******************************
+     *
+     * Express Compatibiliy method
+     *
+     ******************************/
+    /**
+     * Express response allow statusCode to be defined this way
+     * @param code to return
+     * @returns this for chaining
+     */
+    status(code) {
+        this.statusCode = code;
+        return this;
+    }
+    /**
+     * Express response allow answer to be sent this way
+     * @param code to return
+     * @param obj - the target object
+     * @returns this for chaining
+     */
+    json(obj) {
+        this.write(obj);
+        return this;
+    }
+    /**
+     * Return the response size
+     * @returns the result
+     */
+    getResponseSize() {
+        return this._body ? Buffer.byteLength(this._body, "utf8") : undefined;
+    }
+    /**
+     * Flush the request
+     *
+     * @emits 'finish' event
+     * @throws Error if the request was already ended
+     * @returns the result
+     */
+    async end() {
+        /** @ignore */
+        if (this._ended) {
+            return this._ended;
+        }
+        this._ended = (async () => {
+            if (this.getExtension("http") && this.session) {
+                try {
+                    const sm = useDynamicService("SessionManager");
+                    if (sm)
+                        await sm.save(this, this.session);
+                }
+                catch {
+                    // SessionManager may not be available
+                }
+            }
+            await super.end();
+            if (this._stream instanceof WritableStreamBuffer && this._stream.size()) {
+                this._body = this._stream.getContents().toString();
+                this.statusCode = this.statusCode < 300 ? 200 : this.statusCode;
+            }
+            // Flush headers and body to the HTTP response stream
+            await this.flushHeaders();
+            if (this._stream && !(this._stream instanceof WritableStreamBuffer) && !this._stream.writableEnded) {
+                if (this._body) {
+                    this._stream.end(this._body);
+                }
+                else {
+                    this._stream.end();
+                }
+            }
+        })();
+        return this._ended;
+    }
+    /**
+     * Alias to keep compatibility with WebContext
+     * @param sanitizedOptions - the sanitized options
+     * @returns the result
+     */
+    async getRequestBody(sanitizedOptions = {
+        allowedTags: [],
+        allowedAttributes: {}
+    }) {
+        return this.getInput(sanitizedOptions);
+    }
+    /**
+     * Get request body
+     * @returns the result
+     */
+    getResponseBody() {
+        if (!this._body && this._stream instanceof WritableStreamBuffer) {
+            return this._stream.getContents();
+        }
+        return this._body;
+    }
+    /**
+     * Retrieve a http.IncomingMessage valid from Context
+     *
+     * Need more testing
+     * @returns the result
+     */
+    getRequest() {
+        const stream = Readable.from([JSON.stringify(this.getRequestBody())]);
+        return {
+            httpVersionMajor: 1,
+            httpVersionMinor: 0,
+            headers: this.headers,
+            httpVersion: "1.0",
+            method: this.getHttpContext().getMethod(),
+            rawHeaders: [], // TODO Regenerate headers based on the map
+            rawTrailers: [],
+            setTimeout: (msec, callback) => {
+                setTimeout(callback, msec);
+            },
+            socket: undefined,
+            statusCode: 200,
+            trailers: {},
+            url: this.getHttpContext().getUrl(),
+            connection: undefined,
+            ...stream
+        };
+    }
+    /**
+     * Get the request locale if found
+     * @returns the result
+     */
+    getLocale() {
+        const locales = useCore().getLocales();
+        acceptLanguage.languages(locales);
+        const header = this.getHttpContext().getUniqueHeader("accept-language");
+        if (header) {
+            return acceptLanguage.get(header);
+        }
+        return locales[0];
+    }
+    /**
+     * Return true if Headers got flushed already
+     * @returns the result
+     */
+    hasFlushedHeaders() {
+        return this.headersFlushed;
+    }
+    /**
+     * Set flushed header status
+     * @param status - the HTTP status code
+     */
+    setFlushedHeaders(status = true) {
+        this.headersFlushed = status;
+    }
+    /**
+     * Flush stored headers and status code to the underlying stream.
+     * For HTTP ServerResponse, writes via res.writeHead().
+     * Called automatically by getOutputStream() before pipeline() and by end().
+     */
+    /**
+     * Return the merged response headers — defaults set by the constructor
+     * (`_outputHeaders`) overlaid with any headers added via `setHeader()` /
+     * `writeHead()`. Same merge order as `flushHeaders` writes to the wire,
+     * so callers (logging, capture, transports) see exactly what the client
+     * will receive.
+     *
+     * @returns the merged response headers
+     */
+    getResponseHeaders() {
+        return { ...this._outputHeaders, ...super.getResponseHeaders() };
+    }
+    /**
+     *
+     */
+    async flushHeaders() {
+        if (this.flushed)
+            return;
+        const headers = this.getResponseHeaders();
+        await super.flushHeaders();
+        // Write to ServerResponse if the stream supports writeHead (not a WritableStreamBuffer)
+        if (this._stream && !(this._stream instanceof WritableStreamBuffer) && typeof this._stream.writeHead === "function") {
+            this.headersFlushed = true;
+            this._stream.writeHead(this.statusCode || 200, headers);
+        }
+        this._outputHeaders = {};
+    }
+    /**
+     * @ignore
+     * Used by Webda framework to set the body, session and output stream if known
+     */
+    constructor(httpContext, stream = undefined, defaultHeaders = undefined) {
+        super(stream);
+        this.setHttpContext(httpContext);
+        this._outputHeaders = defaultHeaders || {
+            // Gotta Cache ‘em all: bending the rules of web cache exploitation
+            // https://defcon.org/html/defcon-32/dc-32-speakers.html
+            "Cache-Control": "private"
+        };
+        this.headersFlushed = false;
+        this.statusCode = 204;
+        this.headers = new Map();
+    }
+    /**
+     * Initialize the web context, loading session and setting up stream listeners
+     * @param force - whether to force the operation
+     * @returns this for chaining
+     */
+    async init(force = false) {
+        if (this._init && !force) {
+            return this._init;
+        }
+        this._stream.on("pipe", () => {
+            // TODO Check for flush
+            //      this._webda.flushHeaders(this);
+            this.headersFlushed = true;
+        });
+        if (this.getExtension("http")) {
+            this.session = (await useService("SessionManager").load(this)).getProxy();
+        }
+        this._init = super.init();
+        return this._init;
+    }
+}
+//# sourceMappingURL=webcontext.js.map

package/lib/contexts/webcontext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webcontext.js","sourceRoot":"","sources":["../../src/contexts/webcontext.ts"],"names":[],"mappings":"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"}

package/lib/core/authorizer.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Give your opinion about an action
+ *
+ * You have 3 choices:
+ *  - yes: the action is allowed
+ *  - no: the action is denied
+ *  - hard no: the action is denied no matter what (even if another authorizer say yes)
+ */
+export type AuthorizerFunction = (...args: any[]) => boolean | Promise<boolean>;
+/**
+ * Check authorizer functions
+ *
+ * Return true if one of the authorizer allow the action
+ * Return false if all authorizer deny the action
+ * Throw exeption if one of the authorizer return a hard no
+ *
+ * @param authorizer - the authorizer function
+ * @param args - additional arguments
+ * @returns true if the condition is met
+ * @see AuthorizerFunction
+ */
+export declare function checkAuthorizer(authorizer: AuthorizerFunction[], ...args: any[]): Promise<boolean>;
+//# sourceMappingURL=authorizer.d.ts.map

package/lib/core/authorizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorizer.d.ts","sourceRoot":"","sources":["../../src/core/authorizer.ts"],"names":[],"mappings":"AACA;;;;;;;GAOG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAAC,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;AAEhF;;;;;;;;;;;GAWG;AACH,wBAAsB,eAAe,CAAC,UAAU,EAAE,kBAAkB,EAAE,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,GAAG,OAAO,CAAC,OAAO,CAAC,CAGxG"}

package/lib/core/authorizer.js

@@ -0,0 +1,17 @@
+/**
+ * Check authorizer functions
+ *
+ * Return true if one of the authorizer allow the action
+ * Return false if all authorizer deny the action
+ * Throw exeption if one of the authorizer return a hard no
+ *
+ * @param authorizer - the authorizer function
+ * @param args - additional arguments
+ * @returns true if the condition is met
+ * @see AuthorizerFunction
+ */
+export async function checkAuthorizer(authorizer, ...args) {
+    // Run all authorizer in parallel and return true if one of them authorize the action
+    return await Promise.all(authorizer.map(fn => fn(...args))).then(results => results.find(r => r));
+}
+//# sourceMappingURL=authorizer.js.map

package/lib/core/authorizer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"authorizer.js","sourceRoot":"","sources":["../../src/core/authorizer.ts"],"names":[],"mappings":"AAWA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,UAAgC,EAAE,GAAG,IAAW;IACpF,qFAAqF;IACrF,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC;AACpG,CAAC"}

package/lib/core/core.d.ts

@@ -0,0 +1,225 @@
+import { WorkerLogLevel } from "@webda/workout";
+import type { Application } from "../application/application.js";
+import { Configuration } from "../application/iconfiguration.js";
+import { BinaryService } from "../services/binary.service.js";
+import { Model, type ModelClass } from "@webda/models";
+import { Store } from "../stores/store.js";
+import { Logger } from "../loggers/ilogger.js";
+import { ICore, AbstractService, OperationDefinitionInfo } from "./icore.js";
+import { Modda } from "../services/iservice.js";
+import { CustomConstructor } from "@webda/tsc-esm";
+export type CoreStates = "initial" | "loading" | "resolving" | "resolved" | "initializing" | "reinitializing" | "ready" | "stopping" | "stopped";
+/**
+ * This is the main class of the framework, it handles the routing, the services initialization and resolution
+ *
+ * @class Core
+ * @category CoreFeatures
+ */
+export declare class Core implements ICore {
+    /**
+     * Webda Services
+     * @hidden
+     */
+    protected services: Record<string, AbstractService>;
+    /**
+     * Modda for services
+     * @hidden
+     */
+    protected moddas: Record<string, Modda>;
+    /**
+     * Application that generates this Core
+     */
+    protected application: Application;
+    /**
+     * Configuration loaded from webda.config.json
+     * @hidden
+     */
+    protected configuration: Record<string, any>;
+    /**
+     * Console logger
+     * @hidden
+     */
+    protected logger: Logger;
+    /**
+     * Store the instance id
+     */
+    private instanceId;
+    /**
+     * Contains all operations defined by services
+     */
+    protected operations: {
+        [key: string]: OperationDefinitionInfo;
+    };
+    /**
+     * Order of services initialization
+     */
+    initOrders: string[];
+    /**
+     * Dependencies for each service
+     */
+    dependencies: Record<string, Set<string>>;
+    /**
+     * Configuration service name
+     */
+    configurationService?: string;
+    applicationConfiguration: Configuration;
+    /**
+     * Create a new Core
+     * @param application - the application instance
+     */
+    constructor(application?: Application);
+    /**
+     * Get the configuration object
+     * @returns {Configuration} the result
+     */
+    getConfiguration(): Record<string, any>;
+    /**
+     * Get the store assigned to this model
+     * @param model - the model to use
+     * @param modelOrConstructor - the model or its constructor
+     * @returns the result
+     */
+    getModelStore<T extends Model>(modelOrConstructor: CustomConstructor<T> | T | string): Store;
+    /**
+     * Get the model store for a specific model
+     * Leverage the Process cache
+     *
+     * @param model - the model to use
+     * @returns the result
+     */
+    private getModelStoreCached;
+    /**
+     * Get the service that manage a model
+     * @param modelOrConstructor - the model or its constructor
+     * @param attribute - the attribute name
+     * @returns the result
+     */
+    getBinaryStore<T extends Model>(modelOrConstructor: ModelClass<T> | T | string, attribute: string): AbstractService;
+    /**
+     * Find the best matching BinaryService for a given model and attribute, with caching
+     * @param model - the model to use
+     * @param attribute - the attribute name
+     * @returns the result
+     */
+    protected getBinaryStoreCached<T extends Model>(model: string, attribute: string): BinaryService;
+    /**
+     * Return Core instance id
+     *
+     * It is a random generated string
+     * @returns the result string
+     */
+    getInstanceId(): string;
+    /**
+     * Get absolute url with subpath
+     * @param subpath - the subpath to append
+     * @returns the result string
+     */
+    getApiUrl(subpath?: string): string;
+    /**
+     * Init one service
+     * @param service - the service instance
+     */
+    protected initService(service: string): Promise<void>;
+    /**
+     * Resolve services and their dependencies WITHOUT calling service.init().
+     *
+     * After this completes:
+     * - All services declared in configuration are constructed.
+     * - Each service's `resolve()` has been called (via createService / bean registration).
+     * - `this.initOrders` is finalized (Store services first).
+     * - The configuration service (if any) has been fully initialized — it must run
+     *   early so other services can read config during construction.
+     *
+     * No non-configuration service.init() calls — no DB/network I/O is performed.
+     * Build-time hooks (`@BuildCommand`) run after this phase.
+     */
+    resolve(): Promise<void>;
+    /**
+     * Init Webda
+     *
+     * It will resolve Services init method and autolink.
+     *
+     * Delegates to {@link resolve} for service creation + resolve, then calls
+     * `init()` on every remaining non-configuration service.
+     */
+    init(): Promise<void>;
+    /**
+     * Return webda current version
+     *
+     * @returns package version
+     * @since 0.4.0
+     */
+    getVersion(): string;
+    /**
+     * To define the locales just add a locales: ['en-GB', 'fr-FR'] in your host global configuration
+     *
+     * @return The configured locales or "en-GB" if none are defined
+     * @returns the list of results
+     */
+    getLocales(): string[];
+    /**
+     * Check for a service name and return the wanted singleton or undefined if none found
+     *
+     * @param {String} name The service name to retrieve
+     * @returns the result
+     */
+    getService<T = AbstractService>(name?: string): T;
+    /**
+     * Return a map of defined services
+     * @returns {{}} the map of services
+     */
+    getServices(): {
+        [key: string]: AbstractService;
+    };
+    /**
+     * Return if Webda is in debug mode
+     * @returns true if the condition is met
+     */
+    isDebug(): boolean;
+    /**
+     * Log a message
+     * @param level - the log level
+     * @param args - additional arguments
+     */
+    log(level: WorkerLogLevel, ...args: any[]): void;
+    /**
+     * Update the configuration with new values
+     * @param updates - the updates to apply
+     */
+    updateConfiguration(updates: any): void;
+    /**
+     * Create a specific service
+     * @param service - the service instance
+     * @returns the result
+     */
+    protected createService(service: string): AbstractService<import("../index.js").ServiceParameters, {}>;
+    /**
+     * Auto-register application beans as services if not already configured.
+     * Tests can disable by overriding getBeans() to return empty/undefined.
+     */
+    registerBeans(): void;
+    /**
+     * Get application beans
+     * @returns the result
+     */
+    getBeans(): any;
+    /**
+     * Stop all services
+     */
+    stop(): Promise<void>;
+    /**
+     * Allow serialization
+     * @returns the result
+     */
+    toJSON(): {
+        configuration: Record<string, any>;
+        application: Application;
+    };
+    /**
+     * Deserialize a Core instance from a plain JSON object
+     * @param json - the JSON data
+     * @returns the result
+     */
+    static deserialize(json: any): Core;
+}
+//# sourceMappingURL=core.d.ts.map

package/lib/core/core.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.ts","sourceRoot":"","sources":["../../src/core/core.ts"],"names":[],"mappings":"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"}