@decohere/http 0.0.1-dev.20261105.97 → 0.0.1-dev.20261106.132

package/commonjs/src/hosting/hosted-service-host.js

@@ -1,88 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "HostedServiceHost", {
-    enumerable: true,
-    get: function() {
-        return HostedServiceHost;
-    }
-});
-const _scribe = require("@decohere/scribe");
-class HostedServiceHost {
-    logger = _scribe.scribe.logger(HostedServiceHost.name);
-    types = [];
-    controller = new AbortController();
-    /** In start order; stopped in reverse. */ started = [];
-    starting;
-    stopping;
-    add(...types) {
-        this.types.push(...types);
-    }
-    get isEmpty() {
-        return this.types.length === 0;
-    }
-    /**
-	 * Start every service in registration order. If one throws, the ones already started are
-	 * stopped and the error is rethrown. Stops launching more once {@link stop} has begun.
-	 */ start(container) {
-        this.starting ??= this.startAll(container);
-        return this.starting;
-    }
-    /** Abort the services' signal: background work should wind down. {@link stop} does this too. */ abort() {
-        this.controller.abort();
-    }
-    /**
-	 * Abort the signal, wait for a start still in progress, then stop the started services in
-	 * reverse order. Every `stop()` runs even if one throws; the failures are rethrown after.
-	 */ stop() {
-        this.stopping ??= this.stopAll();
-        return this.stopping;
-    }
-    /** The started services that report readiness, for `GET /ready`. */ readinessChecks() {
-        return this.started.filter((service)=>typeof service.check === "function").map((service)=>({
-                name: service.constructor.name,
-                check: ()=>service.check?.() ?? Promise.resolve()
-            }));
-    }
-    async startAll(container) {
-        const { signal } = this.controller;
-        for (const type of this.types){
-            if (signal.aborted) return;
-            const service = container.resolve(type);
-            try {
-                await service.start(signal);
-            } catch (error) {
-                this.logger.error(`Hosted service ${type.name} failed to start`, error);
-                // Not stop(): it waits for this start to settle.
-                this.controller.abort();
-                await this.stopStarted().catch(()=>{});
-                throw error;
-            }
-            this.started.push(service);
-            this.logger.debug(`Hosted service ${type.name} started`);
-        }
-    }
-    async stopAll() {
-        this.controller.abort();
-        await Promise.allSettled([
-            this.starting
-        ]);
-        await this.stopStarted();
-    }
-    /** Stop what is started, newest first. Takes each service off the list, so it runs once. */ async stopStarted() {
-        const failures = [];
-        for(let service = this.started.pop(); service != null; service = this.started.pop()){
-            try {
-                await service.stop?.();
-            } catch (error) {
-                this.logger.error(`Hosted service ${service.constructor.name} failed to stop`, error);
-                failures.push(error);
-            }
-        }
-        if (failures.length === 1) throw failures[0];
-        if (failures.length > 1) {
-            throw new AggregateError(failures, `${failures.length} hosted services failed to stop`);
-        }
-    }
-}

package/commonjs/src/hosting/hosted-service.js

@@ -1,11 +0,0 @@
-/**
- * Work that runs for the life of the app outside a request: a feed, a poller, a queue consumer.
- * Register it with `builder.withHostedService(Type)`; it is a singleton, so other services can
- * inject it by its class.
- *
- * The app starts hosted services in registration order before the HTTP server listens, and stops
- * them in reverse order when it stops (`app.dispose()`, SIGTERM or SIGINT, a Flux reboot).
- */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});

package/commonjs/src/hosting/index.js

@@ -1,19 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-_export_star(require("./hosted-service.js"), exports);
-_export_star(require("./hosted-service-host.js"), exports);
-function _export_star(from, to) {
-    Object.keys(from).forEach(function(k) {
-        if (k !== "default" && !Object.prototype.hasOwnProperty.call(to, k)) {
-            Object.defineProperty(to, k, {
-                enumerable: true,
-                get: function() {
-                    return from[k];
-                }
-            });
-        }
-    });
-    return from;
-}

package/commonjs/src/http/http.compression.js

@@ -1,27 +0,0 @@
-/**
- * Response compression (`builder.withCompression`). Provider-neutral options and defaults;
- * the HTTP provider hands them to its compression plugin and the plugin owns the policy
- * (which responses are compressed, `Vary`, `HEAD`, streams). See ADR 0008.
- */ /** A content coding the HTTP package can offer. */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get DEFAULT_COMPRESSION_ENCODINGS () {
-        return DEFAULT_COMPRESSION_ENCODINGS;
-    },
-    get DEFAULT_COMPRESSION_THRESHOLD () {
-        return DEFAULT_COMPRESSION_THRESHOLD;
-    }
-});
-const DEFAULT_COMPRESSION_THRESHOLD = 1024;
-const DEFAULT_COMPRESSION_ENCODINGS = [
-    "br",
-    "gzip"
-];

package/commonjs/src/http/http.extensions.js

@@ -1,269 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "BuilderExtensions", {
-    enumerable: true,
-    get: function() {
-        return BuilderExtensions;
-    }
-});
-const _extensibility = require("@decohere/core/extensibility");
-const _scribe = require("@decohere/scribe");
-const _principalprovider = require("../auth/principal-provider.js");
-const _builder = require("../builder/builder.js");
-const _const = require("../const.js");
-const _exceptionfilterhost = require("../routing/filters/exception-filter-host.js");
-const _httpaccesslogmiddleware = require("../routing/middleware/http-access-log.middleware.js");
-const _routeregistry = require("../routing/services/route-registry.js");
-const _router = require("../routing/services/router.js");
-const _httpoptionsstore = require("./http.options.store.js");
-const _httpstatic = require("./http.static.js");
-function _ts_decorate(decorators, target, key, desc) {
-    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
-    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
-    else for(var i = decorators.length - 1; i >= 0; i--)if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
-    return c > 3 && r && Object.defineProperty(target, key, r), r;
-}
-function _ts_metadata(k, v) {
-    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
-}
-const httpProviderStore = new WeakMap();
-const controllersStore = new WeakMap();
-class BuilderExtensions {
-    static withHttpProvider(builder, type) {
-        httpProviderStore.set(builder, type);
-        const httpOptions = (0, _httpoptionsstore.getOrCreateHttpOptions)(builder);
-        builder.withServices((containerBuilder)=>{
-            const logger = _scribe.scribe.logger("BuilderExtensions");
-            logger.trace("Configuring Http Provider");
-            const http = httpProviderStore.get(builder);
-            if (!http) {
-                return;
-            }
-            containerBuilder.registerSingleton(_const.HttpOptionsToken, httpOptions);
-            containerBuilder.registerSingleton(_const.HttpProviderToken, http);
-            containerBuilder.registerSingleton(_const.RouterToken, _router.Router);
-            containerBuilder.registerSingleton(_const.RouteRegistryToken, _routeregistry.RouteRegistry);
-            containerBuilder.registerSingleton(_const.ExceptionFilterHostToken, _exceptionfilterhost.ExceptionFilterHost);
-            containerBuilder.registerRequestScoped(_const.IPrincipalProviderToken, _principalprovider.PrincipalProvider);
-            for (const middlewareType of httpOptions.middlewareTypes){
-                containerBuilder.registerSingleton(middlewareType);
-            }
-            for (const filterType of httpOptions.filterTypes){
-                containerBuilder.registerSingleton(filterType);
-            }
-            const controllers = controllersStore.get(builder) || [];
-            for (const controllerFn of controllers){
-                containerBuilder.registerRequestScoped(controllerFn);
-            }
-        });
-        builder.registerPostBuildStep((container)=>{
-            const logger = _scribe.scribe.logger("BuilderExtensions");
-            const registry = container.resolve(_const.RouteRegistryToken);
-            const controllers = controllersStore.get(builder) || [];
-            for (const controllerFn of controllers){
-                logger.trace(`Add routes from ${controllerFn.name}`);
-                registry.addController(controllerFn);
-            }
-        });
-        return builder;
-    }
-    static withHttp(builder, type, options) {
-        const accessLog = options?.accessLog !== false;
-        if (accessLog) {
-            const httpOptions = (0, _httpoptionsstore.getOrCreateHttpOptions)(builder);
-            if (!httpOptions.middlewareTypes.includes(_httpaccesslogmiddleware.HttpAccessLogMiddleware)) {
-                httpOptions.middlewareTypes = [
-                    ...httpOptions.middlewareTypes,
-                    _httpaccesslogmiddleware.HttpAccessLogMiddleware
-                ];
-            }
-        }
-        return BuilderExtensions.withHttpProvider(builder, type);
-    }
-    static withControllers(builder, ...controllers) {
-        const existing = controllersStore.get(builder) || [];
-        controllersStore.set(builder, [
-            ...existing,
-            ...controllers
-        ]);
-        return builder;
-    }
-    static withGlobalPrefix(builder, prefix) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).globalPrefix = prefix;
-        return builder;
-    }
-    static withCors(builder, options) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).cors = options;
-        return builder;
-    }
-    static withHelmet(builder, options = {}) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).helmet = options;
-        return builder;
-    }
-    static withRateLimit(builder, options = {}) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).rateLimit = options;
-        return builder;
-    }
-    static withCompression(builder, options = {}) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).compression = options;
-        return builder;
-    }
-    static withBodyLimit(builder, bytes) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).bodyLimit = bytes;
-        return builder;
-    }
-    static withMiddleware(builder, ...middlewares) {
-        const httpOptions = (0, _httpoptionsstore.getOrCreateHttpOptions)(builder);
-        httpOptions.middlewareTypes = [
-            ...httpOptions.middlewareTypes,
-            ...middlewares
-        ];
-        return builder;
-    }
-    static withExceptionFilters(builder, ...filters) {
-        const httpOptions = (0, _httpoptionsstore.getOrCreateHttpOptions)(builder);
-        httpOptions.filterTypes = [
-            ...httpOptions.filterTypes,
-            ...filters
-        ];
-        return builder;
-    }
-    static withOpenApi(builder, options) {
-        (0, _httpoptionsstore.getOrCreateHttpOptions)(builder).openapi = {
-            validateRequests: true,
-            path: "/openapi.json",
-            ...options
-        };
-        return builder;
-    }
-    static withStatic(builder, prefix, directory, options) {
-        const httpOptions = (0, _httpoptionsstore.getOrCreateHttpOptions)(builder);
-        httpOptions.statics = [
-            ...httpOptions.statics,
-            _httpstatic.staticFiles.toMount(prefix, directory, options)
-        ];
-        return builder;
-    }
-}
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof Thttp === "undefined" ? Object : Thttp
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withHttpProvider", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof Thttp === "undefined" ? Object : Thttp,
-        typeof WithHttpOptions === "undefined" ? Object : WithHttpOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withHttp", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        Array
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withControllers", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        String
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withGlobalPrefix", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof CorsOptions === "undefined" ? Object : CorsOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withCors", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof HelmetOptions === "undefined" ? Object : HelmetOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withHelmet", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof RateLimitOptions === "undefined" ? Object : RateLimitOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withRateLimit", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof CompressionOptions === "undefined" ? Object : CompressionOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withCompression", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        Number
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withBodyLimit", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        Array
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withMiddleware", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        Array
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withExceptionFilters", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        typeof OpenApiOptions === "undefined" ? Object : OpenApiOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withOpenApi", null);
-_ts_decorate([
-    (0, _extensibility.extension)(_builder.Builder),
-    _ts_metadata("design:type", Function),
-    _ts_metadata("design:paramtypes", [
-        typeof _builder.Builder === "undefined" ? Object : _builder.Builder,
-        String,
-        String,
-        typeof StaticOptions === "undefined" ? Object : StaticOptions
-    ]),
-    _ts_metadata("design:returntype", void 0)
-], BuilderExtensions, "withStatic", null);

package/commonjs/src/http/http.options.js

@@ -1,26 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "HttpOptions", {
-    enumerable: true,
-    get: function() {
-        return HttpOptions;
-    }
-});
-class HttpOptions {
-    globalPrefix = "";
-    /**
-	 * Controllers put under the global prefix although they declare `globalPrefix: false`
-	 * (`withHealth({ underGlobalPrefix: true })`).
-	 */ underGlobalPrefix = new Set();
-    cors;
-    openapi;
-    /** `undefined` = helmet on with defaults; `false` = off; object = plugin options. */ helmet;
-    /** `undefined` = rate-limit on with defaults; `false` = off; object = plugin options. */ rateLimit;
-    /** `undefined` = compression on with defaults; `false` = off; object = options. See `withCompression`. */ compression;
-    /** Request body size limit in bytes; `undefined` uses the 1 MiB default. */ bodyLimit;
-    /** Built UIs served from this API, see `withStatic`. */ statics = [];
-    middlewareTypes = [];
-    filterTypes = [];
-}

package/commonjs/src/http/http.options.store.js

@@ -1,20 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-Object.defineProperty(exports, "getOrCreateHttpOptions", {
-    enumerable: true,
-    get: function() {
-        return getOrCreateHttpOptions;
-    }
-});
-const _httpoptions = require("./http.options.js");
-const httpOptionsStore = new WeakMap();
-function getOrCreateHttpOptions(builder) {
-    let options = httpOptionsStore.get(builder);
-    if (options == null) {
-        options = new _httpoptions.HttpOptions();
-        httpOptionsStore.set(builder, options);
-    }
-    return options;
-}

package/commonjs/src/http/http.security.js

@@ -1,27 +0,0 @@
-/**
- * Default HTTP security settings applied by {@link FastifyProvider} when
- * `withHttpProvider` is used. Override via `withHelmet` / `withRateLimit` /
- * `withBodyLimit` (pass `false` to disable helmet or rate-limit).
- */ /** Fastify body size limit (bytes). Matches Fastify's built-in default, made explicit and overridable. */ "use strict";
-Object.defineProperty(exports, "__esModule", {
-    value: true
-});
-function _export(target, all) {
-    for(var name in all)Object.defineProperty(target, name, {
-        enumerable: true,
-        get: Object.getOwnPropertyDescriptor(all, name).get
-    });
-}
-_export(exports, {
-    get DEFAULT_HTTP_BODY_LIMIT () {
-        return DEFAULT_HTTP_BODY_LIMIT;
-    },
-    get DEFAULT_HTTP_RATE_LIMIT () {
-        return DEFAULT_HTTP_RATE_LIMIT;
-    }
-});
-const DEFAULT_HTTP_BODY_LIMIT = 1_048_576;
-const DEFAULT_HTTP_RATE_LIMIT = {
-    max: 100,
-    timeWindow: "1 minute"
-};