iii-sdk 0.14.0-next.2 → 0.16.0-next.2

package/dist/index.cjs

@@ -1,12 +1,42 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-const require_telemetry_system = require('./telemetry-system-BGZS9Vit.cjs');
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
 let node_stream = require("node:stream");
 let ws = require("ws");
 let _opentelemetry_api = require("@opentelemetry/api");
 let node_module = require("node:module");
 let node_os = require("node:os");
-node_os = require_telemetry_system.__toESM(node_os);
-let _opentelemetry_api_logs = require("@opentelemetry/api-logs");
+node_os = __toESM(node_os);
+let _iii_dev_observability = require("@iii-dev/observability");
+let node_fs = require("node:fs");
+node_fs = __toESM(node_fs);
+let node_path = require("node:path");
+node_path = __toESM(node_path);
 
 //#region src/channels.ts
 /**
@@ -214,6 +244,47 @@ function isErrorBody(value) {
 	return typeof v.code === "string" && typeof v.message === "string" && (v.stacktrace === void 0 || typeof v.stacktrace === "string");
 }
 
+//#endregion
+//#region src/iii-constants.ts
+/**
+* Constants for the III module.
+*/
+/**
+* Engine function paths for internal operations.
+*
+* Naming note: `LIST_TRIGGERS` / `INFO_TRIGGERS` cover trigger TYPES
+* (templates). `LIST_REGISTERED_TRIGGERS` / `INFO_REGISTERED_TRIGGERS`
+* cover trigger INSTANCES (subscriber rows). The old
+* `engine::trigger-types::list` builtin has been removed and is now
+* served by `engine::triggers::list`.
+*/
+const EngineFunctions = {
+	LIST_FUNCTIONS: "engine::functions::list",
+	INFO_FUNCTIONS: "engine::functions::info",
+	LIST_WORKERS: "engine::workers::list",
+	INFO_WORKERS: "engine::workers::info",
+	LIST_TRIGGERS: "engine::triggers::list",
+	INFO_TRIGGERS: "engine::triggers::info",
+	LIST_REGISTERED_TRIGGERS: "engine::registered-triggers::list",
+	INFO_REGISTERED_TRIGGERS: "engine::registered-triggers::info",
+	REGISTER_WORKER: "engine::workers::register"
+};
+/** Engine trigger types */
+const EngineTriggers = {
+	FUNCTIONS_AVAILABLE: "engine::functions-available",
+	LOG: "log"
+};
+/** Default reconnection configuration */
+const DEFAULT_BRIDGE_RECONNECTION_CONFIG = {
+	initialDelayMs: 1e3,
+	maxDelayMs: 3e4,
+	backoffMultiplier: 2,
+	jitterFactor: .3,
+	maxRetries: -1
+};
+/** Default invocation timeout in milliseconds */
+const DEFAULT_INVOCATION_TIMEOUT_MS = 3e4;
+
 //#endregion
 //#region src/iii-types.ts
 let MessageType = /* @__PURE__ */ function(MessageType) {
@@ -230,6 +301,81 @@ let MessageType = /* @__PURE__ */ function(MessageType) {
 	return MessageType;
 }({});
 
+//#endregion
+//#region src/utils.ts
+/**
+* Returns a project identifier for telemetry, derived from the current working
+* directory. Reads `package.json` `name` if present at `cwd`; otherwise falls
+* back to the basename of `cwd`. Returns `undefined` only when both signals
+* are unavailable (e.g. cwd is the filesystem root).
+*
+* No directory walking — only inspects `cwd` itself, so the SDK never reads
+* files outside the user's explicit working directory.
+*/
+function detectProjectName(cwd = process.cwd()) {
+	try {
+		const manifest = node_path.join(cwd, "package.json");
+		if (node_fs.existsSync(manifest)) {
+			const parsed = JSON.parse(node_fs.readFileSync(manifest, "utf8"));
+			if (typeof parsed.name === "string") {
+				const trimmed = parsed.name.trim();
+				if (trimmed) return trimmed;
+			}
+		}
+	} catch {}
+	return node_path.basename(cwd).trim() || void 0;
+}
+/**
+* Helper that wraps an HTTP-style handler (with separate `req`/`res` arguments)
+* into the function handler format expected by the SDK.
+*
+* @param callback - Async handler receiving an {@link HttpRequest} and {@link HttpResponse}.
+* @returns A function handler compatible with {@link ISdk.registerFunction}.
+*
+* @example
+* ```typescript
+* import { http } from 'iii-sdk'
+*
+* iii.registerFunction(
+*   'my-api',
+*   http(async (req, res) => {
+*     res.status(200)
+*     res.headers({ 'content-type': 'application/json' })
+*     res.stream.end(JSON.stringify({ hello: 'world' }))
+*     res.close()
+*   }),
+* )
+* ```
+*/
+const http = (callback) => {
+	return async (req) => {
+		const { response, ...request } = req;
+		return callback(request, {
+			status: (status_code) => response.sendMessage(JSON.stringify({
+				type: "set_status",
+				status_code
+			})),
+			headers: (headers) => response.sendMessage(JSON.stringify({
+				type: "set_headers",
+				headers
+			})),
+			stream: response.stream,
+			close: () => response.close()
+		});
+	};
+};
+/**
+* Type guard that checks if a value is a {@link StreamChannelRef}.
+*
+* @param value - Value to check.
+* @returns `true` if the value is a valid `StreamChannelRef`.
+*/
+const isChannelRef = (value) => {
+	if (typeof value !== "object" || value === null) return false;
+	const maybe = value;
+	return typeof maybe.channel_id === "string" && typeof maybe.access_key === "string" && (maybe.direction === "read" || maybe.direction === "write");
+};
+
 //#endregion
 //#region src/iii.ts
 const { version: SDK_VERSION } = (0, node_module.createRequire)(require("url").pathToFileURL(__filename).href)("../package.json");
@@ -334,11 +480,11 @@ var Sdk = class {
 					message: fullMessage,
 					handler: async (input, traceparent, baggage) => {
 						const tracePayloads = !(process.env.III_DISABLE_TRACE_PAYLOADS === "1" || process.env.III_DISABLE_TRACE_PAYLOADS?.toLowerCase() === "true");
-						const payloadMaxBytes = require_telemetry_system.resolveMaxBytesFromEnv();
+						const payloadMaxBytes = (0, _iii_dev_observability.resolveMaxBytesFromEnv)();
 						const runHandler = async () => {
 							if (tracePayloads) {
-								const { json, truncated } = require_telemetry_system.redactAndTruncate(input, payloadMaxBytes);
-								require_telemetry_system.recordSpanEvent("iii.invocation.input", {
+								const { json, truncated } = (0, _iii_dev_observability.redactAndTruncate)(input, payloadMaxBytes);
+								(0, _iii_dev_observability.recordSpanEvent)("iii.invocation.input", {
 									"iii.payload.json": json,
 									"iii.payload.truncated": truncated
 								});
@@ -346,8 +492,8 @@ var Sdk = class {
 							try {
 								const result = await handler(input);
 								if (tracePayloads) {
-									const { json, truncated } = require_telemetry_system.redactAndTruncate(result, payloadMaxBytes);
-									require_telemetry_system.recordSpanEvent("iii.invocation.output", {
+									const { json, truncated } = (0, _iii_dev_observability.redactAndTruncate)(result, payloadMaxBytes);
+									(0, _iii_dev_observability.recordSpanEvent)("iii.invocation.output", {
 										"iii.payload.json": json,
 										"iii.payload.truncated": truncated,
 										"iii.payload.ok": true
@@ -356,8 +502,8 @@ var Sdk = class {
 								return result;
 							} catch (err) {
 								if (tracePayloads) {
-									const { json, truncated } = require_telemetry_system.redactAndTruncate({ error: err instanceof Error ? err.message : String(err) }, payloadMaxBytes);
-									require_telemetry_system.recordSpanEvent("iii.invocation.output", {
+									const { json, truncated } = (0, _iii_dev_observability.redactAndTruncate)({ error: err instanceof Error ? err.message : String(err) }, payloadMaxBytes);
+									(0, _iii_dev_observability.recordSpanEvent)("iii.invocation.output", {
 										"iii.payload.json": json,
 										"iii.payload.truncated": truncated,
 										"iii.payload.ok": false
@@ -366,9 +512,9 @@ var Sdk = class {
 								throw err;
 							}
 						};
-						if (require_telemetry_system.getTracer()) {
-							const parentContext = require_telemetry_system.extractContext(traceparent, baggage);
-							return _opentelemetry_api.context.with(parentContext, () => require_telemetry_system.withSpan(`call ${functionId}`, { kind: _opentelemetry_api.SpanKind.SERVER }, async () => await runHandler()));
+						if ((0, _iii_dev_observability.getTracer)()) {
+							const parentContext = (0, _iii_dev_observability.extractContext)(traceparent, baggage);
+							return _opentelemetry_api.context.with(parentContext, () => (0, _iii_dev_observability.withSpan)(`call ${functionId}`, { kind: _iii_dev_observability.SpanKind.SERVER }, async () => await runHandler()));
 						}
 						const traceId = crypto.randomUUID().replace(/-/g, "");
 						const spanId = crypto.randomUUID().replace(/-/g, "").slice(0, 16);
@@ -405,8 +551,8 @@ var Sdk = class {
 			const { function_id, payload, action, timeoutMs } = request;
 			const effectiveTimeout = timeoutMs ?? this.invocationTimeoutMs;
 			if (action?.type === "void") {
-				const traceparent = require_telemetry_system.injectTraceparent();
-				const baggage = require_telemetry_system.injectBaggage();
+				const traceparent = (0, _iii_dev_observability.injectTraceparent)();
+				const baggage = (0, _iii_dev_observability.injectBaggage)();
 				this.sendMessage(MessageType.InvokeFunction, {
 					function_id,
 					data: payload,
@@ -417,8 +563,8 @@ var Sdk = class {
 				return;
 			}
 			const invocation_id = crypto.randomUUID();
-			const traceparent = require_telemetry_system.injectTraceparent();
-			const baggage = require_telemetry_system.injectBaggage();
+			const traceparent = (0, _iii_dev_observability.injectTraceparent)();
+			const baggage = (0, _iii_dev_observability.injectBaggage)();
 			return new Promise((resolve, reject) => {
 				const timeout = setTimeout(() => {
 					if (this.invocations.get(invocation_id)) {
@@ -462,7 +608,7 @@ var Sdk = class {
 		this.shutdown = async () => {
 			this.isShuttingDown = true;
 			this.stopMetricsReporting();
-			await require_telemetry_system.shutdownOtel();
+			await (0, _iii_dev_observability.shutdownOtel)();
 			this.clearReconnectTimeout();
 			for (const [_id, invocation] of this.invocations) {
 				if (invocation.timeout) clearTimeout(invocation.timeout);
@@ -483,10 +629,10 @@ var Sdk = class {
 		this.metricsReportingEnabled = options?.enableMetricsReporting ?? true;
 		this.invocationTimeoutMs = options?.invocationTimeoutMs ?? 3e4;
 		this.reconnectionConfig = {
-			...require_telemetry_system.DEFAULT_BRIDGE_RECONNECTION_CONFIG,
+			...DEFAULT_BRIDGE_RECONNECTION_CONFIG,
 			...options?.reconnectionConfig
 		};
-		require_telemetry_system.initOtel({
+		(0, _iii_dev_observability.initOtel)({
 			...options?.otel,
 			engineWsUrl: this.address
 		});
@@ -496,7 +642,7 @@ var Sdk = class {
 		const telemetryOpts = this.options?.telemetry;
 		const language = telemetryOpts?.language ?? Intl.DateTimeFormat().resolvedOptions().locale ?? process.env.LANG?.split(".")[0];
 		this.trigger({
-			function_id: require_telemetry_system.EngineFunctions.REGISTER_WORKER,
+			function_id: EngineFunctions.REGISTER_WORKER,
 			payload: {
 				runtime: "node",
 				version: SDK_VERSION,
@@ -506,7 +652,7 @@ var Sdk = class {
 				isolation: process.env.III_ISOLATION || null,
 				telemetry: {
 					language,
-					project_name: telemetryOpts?.project_name ?? require_telemetry_system.detectProjectName(),
+					project_name: telemetryOpts?.project_name ?? detectProjectName(),
 					framework: telemetryOpts?.framework?.trim() || "iii-node",
 					amplitude_api_key: telemetryOpts?.amplitude_api_key
 				}
@@ -557,18 +703,18 @@ var Sdk = class {
 	}
 	startMetricsReporting() {
 		if (!this.metricsReportingEnabled || !this.workerId) return;
-		const meter = require_telemetry_system.getMeter();
+		const meter = (0, _iii_dev_observability.getMeter)();
 		if (!meter) {
 			console.warn("[iii] Worker metrics disabled: OpenTelemetry not initialized. Call initOtel() with metricsEnabled: true before creating the iii.");
 			return;
 		}
-		require_telemetry_system.registerWorkerGauges(meter, {
+		(0, _iii_dev_observability.registerWorkerGauges)(meter, {
 			workerId: this.workerId,
 			workerName: this.workerName
 		});
 	}
 	stopMetricsReporting() {
-		require_telemetry_system.stopWorkerGauges();
+		(0, _iii_dev_observability.stopWorkerGauges)();
 	}
 	onSocketClose() {
 		this.ws?.removeAllListeners();
@@ -649,10 +795,10 @@ var Sdk = class {
 		else if (!skipIfClosed) this.messagesToSend.push(wireMessage);
 	}
 	logError(message, error) {
-		const otelLogger = require_telemetry_system.getLogger();
+		const otelLogger = (0, _iii_dev_observability.getLogger)();
 		const errorMessage = error instanceof Error ? error.message : String(error ?? "");
 		if (otelLogger) otelLogger.emit({
-			severityNumber: _opentelemetry_api_logs.SeverityNumber.ERROR,
+			severityNumber: _iii_dev_observability.SeverityNumber.ERROR,
 			body: `[iii] ${message}${errorMessage ? `: ${errorMessage}` : ""}`
 		});
 		else console.error(`[iii] ${message}`, error ?? "");
@@ -688,7 +834,7 @@ var Sdk = class {
 		});
 	}
 	resolveChannelValue(value) {
-		if (require_telemetry_system.isChannelRef(value)) return value.direction === "read" ? new ChannelReader(this.address, value) : new ChannelWriter(this.address, value);
+		if (isChannelRef(value)) return value.direction === "read" ? new ChannelReader(this.address, value) : new ChannelWriter(this.address, value);
 		if (Array.isArray(value)) return value.map((item) => this.resolveChannelValue(item));
 		if (value !== null && typeof value === "object") {
 			const out = {};
@@ -699,8 +845,8 @@ var Sdk = class {
 	}
 	async onInvokeFunction(invocation_id, function_id, input, traceparent, baggage) {
 		const fn = this.functions.get(function_id);
-		const getResponseTraceparent = () => require_telemetry_system.injectTraceparent() ?? traceparent;
-		const getResponseBaggage = () => require_telemetry_system.injectBaggage() ?? baggage;
+		const getResponseTraceparent = () => (0, _iii_dev_observability.injectTraceparent)() ?? traceparent;
+		const getResponseBaggage = () => (0, _iii_dev_observability.injectBaggage)() ?? baggage;
 		const resolvedInput = this.resolveChannelValue(input);
 		if (fn?.handler) {
 			if (!invocation_id) {
@@ -869,148 +1015,19 @@ const TriggerAction = {
 */
 const registerWorker = (address, options) => new Sdk(address, options);
 
-//#endregion
-//#region src/logger.ts
-/**
-* Structured logger that emits logs as OpenTelemetry LogRecords.
-*
-* Every log call automatically captures the active trace and span context,
-* correlating your logs with distributed traces without any manual wiring.
-* When OTel is not initialized, Logger gracefully falls back to `console.*`.
-*
-* Pass structured data as the second argument to any log method. Using an
-* object of key-value pairs (instead of string interpolation) lets you
-* filter, aggregate, and build dashboards in your observability backend.
-*
-* @example
-* ```typescript
-* import { Logger } from 'iii-sdk'
-*
-* const logger = new Logger()
-*
-* // Basic logging — trace context is injected automatically
-* logger.info('Worker connected')
-*
-* // Structured context for dashboards and alerting
-* logger.info('Order processed', { orderId: 'ord_123', amount: 49.99, currency: 'USD' })
-* logger.warn('Retry attempt', { attempt: 3, maxRetries: 5, endpoint: '/api/charge' })
-* logger.error('Payment failed', { orderId: 'ord_123', gateway: 'stripe', errorCode: 'card_declined' })
-* ```
-*/
-var Logger = class {
-	get otelLogger() {
-		if (!this._otelLogger) this._otelLogger = require_telemetry_system.getLogger();
-		return this._otelLogger;
-	}
-	constructor(traceId, serviceName, spanId) {
-		this.traceId = traceId;
-		this.serviceName = serviceName;
-		this.spanId = spanId;
-		this._otelLogger = null;
-	}
-	emit(message, severity, data) {
-		const attributes = {};
-		const traceId = this.traceId ?? require_telemetry_system.currentTraceId();
-		const spanId = this.spanId ?? require_telemetry_system.currentSpanId();
-		if (traceId) attributes.trace_id = traceId;
-		if (spanId) attributes.span_id = spanId;
-		if (this.serviceName) attributes["service.name"] = this.serviceName;
-		if (data !== void 0) attributes["log.data"] = data;
-		if (this.otelLogger) this.otelLogger.emit({
-			severityNumber: severity,
-			body: message,
-			attributes: Object.keys(attributes).length > 0 ? attributes : void 0
-		});
-		else switch (severity) {
-			case _opentelemetry_api_logs.SeverityNumber.DEBUG:
-				console.debug(message, data);
-				break;
-			case _opentelemetry_api_logs.SeverityNumber.INFO:
-				console.info(message, data);
-				break;
-			case _opentelemetry_api_logs.SeverityNumber.WARN:
-				console.warn(message, data);
-				break;
-			case _opentelemetry_api_logs.SeverityNumber.ERROR:
-				console.error(message, data);
-				break;
-			default: console.log(message, data);
-		}
-	}
-	/**
-	* Log an info-level message.
-	*
-	* @param message - Human-readable log message.
-	* @param data - Structured context attached as OTel log attributes.
-	*   Use key-value objects to enable filtering and aggregation in your
-	*   observability backend (e.g. Grafana, Datadog, New Relic).
-	*
-	* @example
-	* ```typescript
-	* logger.info('Order processed', { orderId: 'ord_123', status: 'completed' })
-	* ```
-	*/
-	info(message, data) {
-		this.emit(message, _opentelemetry_api_logs.SeverityNumber.INFO, data);
-	}
-	/**
-	* Log a warning-level message.
-	*
-	* @param message - Human-readable log message.
-	* @param data - Structured context attached as OTel log attributes.
-	*   Use key-value objects to enable filtering and aggregation in your
-	*   observability backend (e.g. Grafana, Datadog, New Relic).
-	*
-	* @example
-	* ```typescript
-	* logger.warn('Retry attempt', { attempt: 3, maxRetries: 5, endpoint: '/api/charge' })
-	* ```
-	*/
-	warn(message, data) {
-		this.emit(message, _opentelemetry_api_logs.SeverityNumber.WARN, data);
-	}
-	/**
-	* Log an error-level message.
-	*
-	* @param message - Human-readable log message.
-	* @param data - Structured context attached as OTel log attributes.
-	*   Use key-value objects to enable filtering and aggregation in your
-	*   observability backend (e.g. Grafana, Datadog, New Relic).
-	*
-	* @example
-	* ```typescript
-	* logger.error('Payment failed', { orderId: 'ord_123', gateway: 'stripe', errorCode: 'card_declined' })
-	* ```
-	*/
-	error(message, data) {
-		this.emit(message, _opentelemetry_api_logs.SeverityNumber.ERROR, data);
-	}
-	/**
-	* Log a debug-level message.
-	*
-	* @param message - Human-readable log message.
-	* @param data - Structured context attached as OTel log attributes.
-	*   Use key-value objects to enable filtering and aggregation in your
-	*   observability backend (e.g. Grafana, Datadog, New Relic).
-	*
-	* @example
-	* ```typescript
-	* logger.debug('Cache lookup', { key: 'user:42', hit: false })
-	* ```
-	*/
-	debug(message, data) {
-		this.emit(message, _opentelemetry_api_logs.SeverityNumber.DEBUG, data);
-	}
-};
-
 //#endregion
 exports.ChannelReader = ChannelReader;
 exports.ChannelWriter = ChannelWriter;
-exports.EngineFunctions = require_telemetry_system.EngineFunctions;
-exports.EngineTriggers = require_telemetry_system.EngineTriggers;
+exports.EngineFunctions = EngineFunctions;
+exports.EngineTriggers = EngineTriggers;
 exports.IIIInvocationError = IIIInvocationError;
-exports.Logger = Logger;
+Object.defineProperty(exports, 'Logger', {
+  enumerable: true,
+  get: function () {
+    return _iii_dev_observability.Logger;
+  }
+});
 exports.TriggerAction = TriggerAction;
-exports.http = require_telemetry_system.http;
+exports.http = http;
 exports.registerWorker = registerWorker;
 //# sourceMappingURL=index.cjs.map