@geekmidas/constructs 7.0.1 → 9.1.0

package/dist/{functions-C8i1kCMM.cjs → functions-SqtCDc9c.cjs}

@@ -1,8 +1,85 @@
-const require_Construct = require('./Construct-vXMZJgRp.cjs');
+const require_Construct = require('./Construct-TGIM_E4o.cjs');
+const require_clone = require('./clone-I_WIpiFf.cjs');
 const __geekmidas_errors = require_Construct.__toESM(require("@geekmidas/errors"));
 const __geekmidas_logger_console = require_Construct.__toESM(require("@geekmidas/logger/console"));
 const __geekmidas_schema_parser = require_Construct.__toESM(require("@geekmidas/schema/parser"));
 
+//#region src/monitor.ts
+/**
+* Add a monitor to a construct's list, refusing one that is already there.
+*
+* Services are cached by name, so two monitors with one name would silently
+* share an instance: two heartbeats reading `HEARTBEAT_URL` would both ping
+* whichever was registered first, and the other provider would never hear
+* from the construct.
+*/
+function addMonitor(monitors, monitor) {
+	if (monitors.some((m) => m.serviceName === monitor.serviceName)) throw new Error(`Monitor "${monitor.serviceName}" is already set on this construct. Two heartbeats reading the same env var would share one URL; give one its own, e.g. heartbeat.healthchecks('HEALTHCHECKS_HEARTBEAT_URL').`);
+	return [...monitors, monitor];
+}
+const NOOP_RUN = {
+	async success() {},
+	async failure() {},
+	async settle() {}
+};
+/**
+* Start a construct's monitors for one run.
+*
+* Never throws: a monitor that fails to register, start or report is logged,
+* and the run goes on without it.
+*/
+async function startMonitors(construct, serviceDiscovery, logger) {
+	if (!construct.monitors.length) return NOOP_RUN;
+	const ctx = {
+		type: construct.type,
+		logger
+	};
+	let started;
+	try {
+		const registered = await serviceDiscovery.register([...construct.monitors]);
+		started = await Promise.all(construct.monitors.map(async ({ serviceName }) => {
+			const monitor = registered[serviceName];
+			let run$1;
+			try {
+				run$1 = await monitor.start?.(ctx);
+			} catch (error) {
+				logger.warn({
+					error,
+					monitor: serviceName
+				}, "Monitor failed to start");
+			}
+			return {
+				monitor,
+				run: run$1
+			};
+		}));
+	} catch (error) {
+		logger.warn({ error }, "Monitors could not be registered");
+		return NOOP_RUN;
+	}
+	const report = async (call) => {
+		const results = await Promise.allSettled(started.map(({ monitor, run: run$1 }) => call(monitor, run$1)));
+		for (const result of results) if (result.status === "rejected") logger.warn({ error: result.reason }, "Monitor failed to report");
+	};
+	const run = {
+		success: (output, status) => report((monitor, r) => monitor.success({
+			...ctx,
+			run: r,
+			output,
+			status
+		})),
+		failure: (error, status) => report((monitor, r) => monitor.failure({
+			...ctx,
+			run: r,
+			error,
+			status
+		})),
+		settle: (status, error) => status >= 500 ? run.failure(error ?? new Error(`Responded with ${status}`), status) : run.success(void 0, status)
+	};
+	return run;
+}
+
+//#endregion
 //#region ../../node_modules/.pnpm/lodash.uniqby@4.7.0/node_modules/lodash.uniqby/index.js
 var require_lodash$1 = require_Construct.__commonJS({ "../../node_modules/.pnpm/lodash.uniqby@4.7.0/node_modules/lodash.uniqby/index.js"(exports, module) {
 	/**
@@ -2668,17 +2745,18 @@ var require_lodash = require_Construct.__commonJS({ "../../node_modules/.pnpm/lo
 //#endregion
 //#region src/functions/BaseFunctionBuilder.ts
 var import_lodash$2 = require_Construct.__toESM(require_lodash(), 1);
-const DEFAULT_LOGGER$2 = new __geekmidas_logger_console.ConsoleLogger();
+const DEFAULT_LOGGER$1 = new __geekmidas_logger_console.ConsoleLogger();
 var BaseFunctionBuilder = class BaseFunctionBuilder {
 	inputSchema;
 	outputSchema;
 	_timeout;
 	_services = [];
-	_logger = DEFAULT_LOGGER$2;
+	_logger = DEFAULT_LOGGER$1;
 	_events = [];
 	_publisher;
 	_auditorStorage;
 	_databaseService;
+	_monitors = [];
 	static isStandardSchemaV1(s) {
 		const schema = s["~standard"];
 		return schema && typeof schema.validate === "function";
@@ -2705,35 +2783,37 @@ var BaseFunctionBuilder = class BaseFunctionBuilder {
 		this.type = type;
 	}
 	timeout(timeout) {
-		this._timeout = timeout;
-		return this;
+		return require_clone.cloneWith(this, { _timeout: timeout });
+	}
+	/**
+	* Report each run to a monitor — a heartbeat, an uptime check, an error
+	* tracker. Can be called more than once; every monitor is told.
+	*/
+	monitor(monitor) {
+		return require_clone.cloneWith(this, { _monitors: addMonitor(this._monitors, monitor) });
 	}
 	event(event) {
-		this._events.push(event);
-		return this;
+		return require_clone.cloneWith(this, { _events: [...this._events, event] });
 	}
 	publisher(publisher) {
-		this._publisher = publisher;
-		return this;
+		return require_clone.cloneWith(this, { _publisher: publisher });
 	}
 	auditor(storage) {
-		this._auditorStorage = storage;
-		return this;
+		return require_clone.cloneWith(this, { _auditorStorage: storage });
 	}
 	/**
 	* Set the database service for this function.
 	* The database will be available in the handler context as `db`.
 	*/
 	database(service) {
-		this._databaseService = service;
-		return this;
+		return require_clone.cloneWith(this, { _databaseService: service });
 	}
 };
 
 //#endregion
 //#region src/functions/Function.ts
 var import_lodash$1 = require_Construct.__toESM(require_lodash$1(), 1);
-const DEFAULT_LOGGER$1 = new __geekmidas_logger_console.ConsoleLogger();
+const DEFAULT_LOGGER = new __geekmidas_logger_console.ConsoleLogger();
 var Function$1 = class Function$1 extends require_Construct.Construct {
 	__IS_FUNCTION__ = true;
 	static isFunction(obj) {
@@ -2774,7 +2854,7 @@ var Function$1 = class Function$1 extends require_Construct.Construct {
 	async parseOutput(output) {
 		return Function$1.parseSchema(this.outputSchema, output);
 	}
-	constructor(fn, timeout = 3e4, type = require_Construct.ConstructType.Function, input, outputSchema, services = [], logger = DEFAULT_LOGGER$1, publisherService, events = [], memorySize, auditorStorageService, databaseService) {
+	constructor(fn, timeout = 3e4, type = require_Construct.ConstructType.Function, input, outputSchema, services = [], logger = DEFAULT_LOGGER, publisherService, events = [], memorySize, auditorStorageService, databaseService) {
 		super(type, logger, services, events, publisherService, outputSchema, timeout, memorySize, auditorStorageService);
 		this.fn = fn;
 		this.input = input;
@@ -2785,7 +2865,6 @@ var Function$1 = class Function$1 extends require_Construct.Construct {
 //#endregion
 //#region src/functions/FunctionBuilder.ts
 var import_lodash = require_Construct.__toESM(require_lodash$1(), 1);
-const DEFAULT_LOGGER = new __geekmidas_logger_console.ConsoleLogger();
 var FunctionBuilder = class extends BaseFunctionBuilder {
 	_memorySize;
 	constructor(type = require_Construct.ConstructType.Function) {
@@ -2793,36 +2872,28 @@ var FunctionBuilder = class extends BaseFunctionBuilder {
 		this.type = type;
 	}
 	timeout(timeout) {
-		this._timeout = timeout;
-		return this;
+		return require_clone.cloneWith(this, { _timeout: timeout });
 	}
 	memorySize(memorySize) {
-		this._memorySize = memorySize;
-		return this;
+		return require_clone.cloneWith(this, { _memorySize: memorySize });
 	}
 	output(schema) {
-		this.outputSchema = schema;
-		return this;
+		return require_clone.cloneWith(this, { outputSchema: schema });
 	}
 	input(schema) {
-		this.inputSchema = schema;
-		return this;
+		return require_clone.cloneWith(this, { inputSchema: schema });
 	}
 	services(services) {
-		this._services = (0, import_lodash.default)([...this._services, ...services], (s) => s.serviceName);
-		return this;
+		return require_clone.cloneWith(this, { _services: (0, import_lodash.default)([...this._services, ...services], (s) => s.serviceName) });
 	}
 	logger(logger) {
-		this._logger = logger;
-		return this;
+		return require_clone.cloneWith(this, { _logger: logger });
 	}
 	publisher(publisher) {
-		this._publisher = publisher;
-		return this;
+		return require_clone.cloneWith(this, { _publisher: publisher });
 	}
 	auditor(storage) {
-		this._auditorStorage = storage;
-		return this;
+		return require_clone.cloneWith(this, { _auditorStorage: storage });
 	}
 	/**
 	* Set the audit action types for this function.
@@ -2836,21 +2907,11 @@ var FunctionBuilder = class extends BaseFunctionBuilder {
 	* The database will be available in the handler context as `db`.
 	*/
 	database(service) {
-		this._databaseService = service;
-		return this;
+		return require_clone.cloneWith(this, { _databaseService: service });
 	}
 	handle(fn) {
 		const func = new Function$1(fn, this._timeout, this.type, this.inputSchema, this.outputSchema, this._services, this._logger, this._publisher, this._events, this._memorySize, this._auditorStorage, this._databaseService);
-		this._services = [];
-		this._logger = DEFAULT_LOGGER;
-		this._events = [];
-		this._publisher = void 0;
-		this._auditorStorage = void 0;
-		this._databaseService = void 0;
-		this.inputSchema = void 0;
-		this.outputSchema = void 0;
-		this._timeout = void 0;
-		this._memorySize = void 0;
+		func.monitors = this._monitors;
 		return func;
 	}
 };
@@ -2878,6 +2939,12 @@ Object.defineProperty(exports, 'FunctionBuilder', {
     return FunctionBuilder;
   }
 });
+Object.defineProperty(exports, 'addMonitor', {
+  enumerable: true,
+  get: function () {
+    return addMonitor;
+  }
+});
 Object.defineProperty(exports, 'f', {
   enumerable: true,
   get: function () {
@@ -2890,4 +2957,10 @@ Object.defineProperty(exports, 'require_lodash', {
     return require_lodash$1;
   }
 });
-//# sourceMappingURL=functions-C8i1kCMM.cjs.map
+Object.defineProperty(exports, 'startMonitors', {
+  enumerable: true,
+  get: function () {
+    return startMonitors;
+  }
+});
+//# sourceMappingURL=functions-SqtCDc9c.cjs.map