@geekmidas/constructs 9.0.2 → 9.1.0

package/dist/endpoints/index.cjs

@@ -1,7 +1,8 @@
-const require_Construct = require('../Construct-vXMZJgRp.cjs');
-const require_functions = require('../functions-C8i1kCMM.cjs');
-const require_publisher = require('../publisher-lFQleddL.cjs');
-const require_lazyAccessors = require('../lazyAccessors-DmTG8sQH.cjs');
+const require_Construct = require('../Construct-TGIM_E4o.cjs');
+const require_functions = require('../functions-SqtCDc9c.cjs');
+const require_clone = require('../clone-I_WIpiFf.cjs');
+const require_publisher = require('../publisher-BZgcrVPy.cjs');
+const require_lazyAccessors = require('../lazyAccessors-D04oftGw.cjs');
 const __geekmidas_logger_console = require_Construct.__toESM(require("@geekmidas/logger/console"));
 
 //#region src/endpoints/Authorizer.ts
@@ -111,24 +112,19 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 		this._databaseService = service;
 	}
 	description(description) {
-		this._description = description;
-		return this;
+		return require_clone.cloneWith(this, { _description: description });
 	}
 	status(status) {
-		this._status = status;
-		return this;
+		return require_clone.cloneWith(this, { _status: status });
 	}
 	event(event) {
-		this._events.push(event);
-		return this;
+		return require_clone.cloneWith(this, { _events: [...this._events, event] });
 	}
 	tags(tags) {
-		this._tags = tags;
-		return this;
+		return require_clone.cloneWith(this, { _tags: tags });
 	}
 	memorySize(memorySize) {
-		this._memorySize = memorySize;
-		return this;
+		return require_clone.cloneWith(this, { _memorySize: memorySize });
 	}
 	/**
 	* Set the response content type for this endpoint.
@@ -149,60 +145,55 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 	* ```
 	*/
 	responseType(type) {
-		this._responseType = type;
-		return this;
+		return require_clone.cloneWith(this, { _responseType: type });
 	}
 	publisher(publisher) {
-		this._publisher = publisher;
-		return this;
+		return require_clone.cloneWith(this, { _publisher: publisher });
 	}
 	body(schema) {
-		this.schemas.body = schema;
-		return this;
+		return require_clone.cloneWith(this, { schemas: {
+			...this.schemas,
+			body: schema
+		} });
 	}
 	search(schema) {
-		this.schemas.query = schema;
-		return this;
+		return require_clone.cloneWith(this, { schemas: {
+			...this.schemas,
+			query: schema
+		} });
 	}
 	query(schema) {
 		return this.search(schema);
 	}
 	params(schema) {
-		this.schemas.params = schema;
-		return this;
+		return require_clone.cloneWith(this, { schemas: {
+			...this.schemas,
+			params: schema
+		} });
 	}
 	authorize(fn) {
-		this._authorize = fn;
-		return this;
+		return require_clone.cloneWith(this, { _authorize: fn });
 	}
 	rateLimit(config) {
-		this._rateLimit = config;
-		return this;
+		return require_clone.cloneWith(this, { _rateLimit: config });
 	}
 	authorizer(name) {
-		if (name === "none") {
-			this._authorizerName = void 0;
-			return this;
-		}
+		if (name === "none") return require_clone.cloneWith(this, { _authorizerName: void 0 });
 		const authorizerExists = this._availableAuthorizers.some((a) => a.name === name);
 		if (!authorizerExists && this._availableAuthorizers.length > 0) {
 			const available = this._availableAuthorizers.map((a) => a.name).join(", ");
 			throw new Error(`Authorizer "${name}" not found in available authorizers: ${available}`);
 		}
-		this._authorizerName = name;
-		return this;
+		return require_clone.cloneWith(this, { _authorizerName: name });
 	}
 	services(services) {
-		this._services = (0, import_lodash$1.default)([...this._services, ...services], (s) => s.serviceName);
-		return this;
+		return require_clone.cloneWith(this, { _services: (0, import_lodash$1.default)([...this._services, ...services], (s) => s.serviceName) });
 	}
 	logger(logger) {
-		this._logger = logger;
-		return this;
+		return require_clone.cloneWith(this, { _logger: logger });
 	}
 	output(schema) {
-		this.outputSchema = schema;
-		return this;
+		return require_clone.cloneWith(this, { outputSchema: schema });
 	}
 	/**
 	* Set the auditor storage service for this endpoint.
@@ -210,16 +201,14 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 	* The audit action type is automatically inferred from the storage's generic parameter.
 	*/
 	auditor(storage) {
-		this._auditorStorage = storage;
-		return this;
+		return require_clone.cloneWith(this, { _auditorStorage: storage });
 	}
 	/**
 	* Set the actor extractor function for audit records.
 	* The actor is extracted from the request context and attached to all audits.
 	*/
 	actor(extractor) {
-		this._actorExtractor = extractor;
-		return this;
+		return require_clone.cloneWith(this, { _actorExtractor: extractor });
 	}
 	/**
 	* Add declarative audit definitions that are processed after the handler executes.
@@ -239,8 +228,7 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 	* ```
 	*/
 	audit(audits) {
-		this._audits = audits;
-		return this;
+		return require_clone.cloneWith(this, { _audits: audits });
 	}
 	/**
 	* Set the database service for this endpoint.
@@ -258,8 +246,7 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 	* ```
 	*/
 	database(service) {
-		this._databaseService = service;
-		return this;
+		return require_clone.cloneWith(this, { _databaseService: service });
 	}
 	/**
 	* Configure RLS (Row-Level Security) context for this endpoint.
@@ -281,14 +268,14 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 	* ```
 	*/
 	rls(config) {
-		if (config === false || config === RLS_BYPASS) {
-			this._rlsBypass = true;
-			this._rlsConfig = void 0;
-		} else {
-			this._rlsConfig = config;
-			this._rlsBypass = false;
-		}
-		return this;
+		if (config === false || config === RLS_BYPASS) return require_clone.cloneWith(this, {
+			_rlsBypass: true,
+			_rlsConfig: void 0
+		});
+		return require_clone.cloneWith(this, {
+			_rlsConfig: config,
+			_rlsBypass: false
+		});
 	}
 	/**
 	* Explicitly bypass RLS for this endpoint.
@@ -304,9 +291,10 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 	* ```
 	*/
 	rlsBypass() {
-		this._rlsBypass = true;
-		this._rlsConfig = void 0;
-		return this;
+		return require_clone.cloneWith(this, {
+			_rlsBypass: true,
+			_rlsConfig: void 0
+		});
 	}
 	input(_schema) {
 		throw new Error("EndpointBuilder does not support generic input. Use body(), query(), or params() instead.");
@@ -324,7 +312,7 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 				};
 			}
 		}
-		return new require_lazyAccessors.Endpoint({
+		const endpoint = new require_lazyAccessors.Endpoint({
 			fn,
 			method: this.method,
 			route: this.route,
@@ -351,6 +339,8 @@ var EndpointBuilder = class extends require_functions.BaseFunctionBuilder {
 			rlsBypass: this._rlsBypass,
 			responseType: this._responseType
 		});
+		endpoint.monitors = this._monitors;
+		return endpoint;
 	}
 };
 
@@ -372,7 +362,8 @@ var EndpointFactory = class EndpointFactory {
 	defaultActorExtractor;
 	customSecuritySchemes = {};
 	defaultRlsConfig;
-	constructor({ basePath, defaultAuthorizeFn, defaultLogger, defaultSessionExtractor, defaultServices = [], defaultEventPublisher, availableAuthorizers = [], defaultAuthorizerName, defaultAuditorStorage, defaultDatabaseService, defaultActorExtractor, customSecuritySchemes = {}, defaultRlsConfig } = {}) {
+	defaultMonitors = [];
+	constructor({ basePath, defaultAuthorizeFn, defaultLogger, defaultSessionExtractor, defaultServices = [], defaultEventPublisher, availableAuthorizers = [], defaultAuthorizerName, defaultAuditorStorage, defaultDatabaseService, defaultActorExtractor, customSecuritySchemes = {}, defaultRlsConfig, defaultMonitors = [] } = {}) {
 		this.defaultServices = (0, import_lodash.default)(defaultServices, (s) => s.serviceName);
 		this.basePath = basePath || "";
 		this.defaultAuthorizeFn = defaultAuthorizeFn;
@@ -386,6 +377,14 @@ var EndpointFactory = class EndpointFactory {
 		this.defaultActorExtractor = defaultActorExtractor;
 		this.customSecuritySchemes = customSecuritySchemes;
 		this.defaultRlsConfig = defaultRlsConfig;
+		this.defaultMonitors = defaultMonitors;
+	}
+	/**
+	* Report every endpoint's requests to a monitor. Endpoints built from this
+	* factory inherit it, and can add their own with `.monitor()`.
+	*/
+	monitor(monitor) {
+		return require_clone.cloneWith(this, { defaultMonitors: require_functions.addMonitor(this.defaultMonitors, monitor) });
 	}
 	static joinPaths(path, basePath = "") {
 		if (!basePath && !path) return "/";
@@ -411,6 +410,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: authorizerConfigs,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -444,6 +444,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -481,6 +482,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: name === "none" ? void 0 : name,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -499,6 +501,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -516,6 +519,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -533,6 +537,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -550,6 +555,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: logger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -567,6 +573,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: publisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -584,6 +591,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: session,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -605,6 +613,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -626,6 +635,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: storage,
@@ -647,6 +657,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -682,6 +693,7 @@ var EndpointFactory = class EndpointFactory {
 			defaultLogger: this.defaultLogger,
 			defaultSessionExtractor: this.defaultSessionExtractor,
 			defaultEventPublisher: this.defaultEventPublisher,
+			defaultMonitors: this.defaultMonitors,
 			availableAuthorizers: this.availableAuthorizers,
 			defaultAuthorizerName: this.defaultAuthorizerName,
 			defaultAuditorStorage: this.defaultAuditorStorage,
@@ -699,6 +711,7 @@ var EndpointFactory = class EndpointFactory {
 		if (this.defaultLogger) builder._logger = this.defaultLogger;
 		if (this.defaultSessionExtractor) builder._getSession = this.defaultSessionExtractor;
 		if (this.defaultEventPublisher) builder._setPublisher(this.defaultEventPublisher);
+		builder._monitors = [...this.defaultMonitors];
 		builder._availableAuthorizers = this.availableAuthorizers;
 		if (this.defaultAuthorizerName) builder._authorizerName = this.defaultAuthorizerName;
 		if (this.defaultAuditorStorage) builder._setAuditorStorage(this.defaultAuditorStorage);