iii-sdk 0.17.0 → 0.18.0

package/dist/helpers.cjs

@@ -0,0 +1,30 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_utils = require('./utils-CuS1Knym.cjs');
+
+//#region src/helpers.ts
+/**
+* Create a streaming channel pair for worker-to-worker data transfer.
+*
+* Free-function form of the previous `ISdk.createChannel` instance method.
+*/
+function createChannel(iii, bufferSize) {
+	return iii.__helpers_create_channel(bufferSize);
+}
+/**
+* Register a custom stream implementation by wiring its 5 callable methods
+* to `stream::get/set/delete/list/list_groups`.
+*
+* Free-function form of the previous `ISdk.createStream` instance method.
+*/
+function createStream(iii, streamName, stream) {
+	iii.__helpers_create_stream(streamName, stream);
+}
+
+//#endregion
+exports.ChannelDirection = require_utils.ChannelDirection;
+exports.ChannelItem = require_utils.ChannelItem;
+exports.createChannel = createChannel;
+exports.createStream = createStream;
+exports.extractChannelRefs = require_utils.extractChannelRefs;
+exports.isChannelRef = require_utils.isChannelRef;
+//# sourceMappingURL=helpers.cjs.map

package/dist/helpers.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.cjs","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["/**\n * Helper free functions that operate on an {@link ISdk} instance.\n *\n * These were previously instance methods on the SDK. They take the iii\n * instance as the first argument so the public API surface of `ISdk` stays\n * focused on the core lifecycle and registration methods.\n */\nimport type { Channel, ISdk } from './types'\nimport type { IStream } from './stream'\n\nexport { ChannelDirection, ChannelItem } from './channels'\nexport { extractChannelRefs, isChannelRef } from './utils'\n\ntype IIIWithHelperShims = ISdk & {\n  __helpers_create_channel(bufferSize?: number): Promise<Channel>\n  __helpers_create_stream<T>(name: string, stream: IStream<T>): void\n}\n\n/**\n * Create a streaming channel pair for worker-to-worker data transfer.\n *\n * Free-function form of the previous `ISdk.createChannel` instance method.\n */\nexport function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel> {\n  return (iii as IIIWithHelperShims).__helpers_create_channel(bufferSize)\n}\n\n/**\n * Register a custom stream implementation by wiring its 5 callable methods\n * to `stream::get/set/delete/list/list_groups`.\n *\n * Free-function form of the previous `ISdk.createStream` instance method.\n */\nexport function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void {\n  ;(iii as IIIWithHelperShims).__helpers_create_stream(streamName, stream)\n}\n"],"mappings":";;;;;;;;;AAuBA,SAAgB,cAAc,KAAW,YAAuC;AAC9E,QAAQ,IAA2B,yBAAyB,WAAW;;;;;;;;AASzE,SAAgB,aAAoB,KAAW,YAAoB,QAA8B;AAC9F,CAAC,IAA2B,wBAAwB,YAAY,OAAO"}

package/dist/helpers.d.cts

@@ -0,0 +1,20 @@
+import { S as ChannelItem, o as Channel, r as isChannelRef, t as extractChannelRefs, u as ISdk, x as ChannelDirection } from "./utils-DcbZmefT.cjs";
+import { IStream } from "./stream.cjs";
+
+//#region src/helpers.d.ts
+/**
+ * Create a streaming channel pair for worker-to-worker data transfer.
+ *
+ * Free-function form of the previous `ISdk.createChannel` instance method.
+ */
+declare function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel>;
+/**
+ * Register a custom stream implementation by wiring its 5 callable methods
+ * to `stream::get/set/delete/list/list_groups`.
+ *
+ * Free-function form of the previous `ISdk.createStream` instance method.
+ */
+declare function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void;
+//#endregion
+export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
+//# sourceMappingURL=helpers.d.cts.map

package/dist/helpers.d.cts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.cts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;;;;;iBAuBgB,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;AAUvE;;;;iBAAgB,YAAA,OAAA,CAAoB,GAAA,EAAK,IAAA,EAAM,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}

package/dist/helpers.d.mts

@@ -0,0 +1,20 @@
+import { S as ChannelItem, o as Channel, r as isChannelRef, t as extractChannelRefs, u as ISdk, x as ChannelDirection } from "./utils-tcJ0Rzg-.mjs";
+import { IStream } from "./stream.mjs";
+
+//#region src/helpers.d.ts
+/**
+ * Create a streaming channel pair for worker-to-worker data transfer.
+ *
+ * Free-function form of the previous `ISdk.createChannel` instance method.
+ */
+declare function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel>;
+/**
+ * Register a custom stream implementation by wiring its 5 callable methods
+ * to `stream::get/set/delete/list/list_groups`.
+ *
+ * Free-function form of the previous `ISdk.createStream` instance method.
+ */
+declare function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void;
+//#endregion
+export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
+//# sourceMappingURL=helpers.d.mts.map

package/dist/helpers.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.d.mts","names":[],"sources":["../src/helpers.ts"],"mappings":";;;;;;;;;iBAuBgB,aAAA,CAAc,GAAA,EAAK,IAAA,EAAM,UAAA,YAAsB,OAAA,CAAQ,OAAA;;;AAUvE;;;;iBAAgB,YAAA,OAAA,CAAoB,GAAA,EAAK,IAAA,EAAM,UAAA,UAAoB,MAAA,EAAQ,OAAA,CAAQ,KAAA"}

package/dist/helpers.mjs

@@ -0,0 +1,24 @@
+import { a as ChannelDirection, i as isChannelRef, n as extractChannelRefs, o as ChannelItem } from "./utils-DXL7JI0q.mjs";
+
+//#region src/helpers.ts
+/**
+* Create a streaming channel pair for worker-to-worker data transfer.
+*
+* Free-function form of the previous `ISdk.createChannel` instance method.
+*/
+function createChannel(iii, bufferSize) {
+	return iii.__helpers_create_channel(bufferSize);
+}
+/**
+* Register a custom stream implementation by wiring its 5 callable methods
+* to `stream::get/set/delete/list/list_groups`.
+*
+* Free-function form of the previous `ISdk.createStream` instance method.
+*/
+function createStream(iii, streamName, stream) {
+	iii.__helpers_create_stream(streamName, stream);
+}
+
+//#endregion
+export { ChannelDirection, ChannelItem, createChannel, createStream, extractChannelRefs, isChannelRef };
+//# sourceMappingURL=helpers.mjs.map

package/dist/helpers.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"helpers.mjs","names":[],"sources":["../src/helpers.ts"],"sourcesContent":["/**\n * Helper free functions that operate on an {@link ISdk} instance.\n *\n * These were previously instance methods on the SDK. They take the iii\n * instance as the first argument so the public API surface of `ISdk` stays\n * focused on the core lifecycle and registration methods.\n */\nimport type { Channel, ISdk } from './types'\nimport type { IStream } from './stream'\n\nexport { ChannelDirection, ChannelItem } from './channels'\nexport { extractChannelRefs, isChannelRef } from './utils'\n\ntype IIIWithHelperShims = ISdk & {\n  __helpers_create_channel(bufferSize?: number): Promise<Channel>\n  __helpers_create_stream<T>(name: string, stream: IStream<T>): void\n}\n\n/**\n * Create a streaming channel pair for worker-to-worker data transfer.\n *\n * Free-function form of the previous `ISdk.createChannel` instance method.\n */\nexport function createChannel(iii: ISdk, bufferSize?: number): Promise<Channel> {\n  return (iii as IIIWithHelperShims).__helpers_create_channel(bufferSize)\n}\n\n/**\n * Register a custom stream implementation by wiring its 5 callable methods\n * to `stream::get/set/delete/list/list_groups`.\n *\n * Free-function form of the previous `ISdk.createStream` instance method.\n */\nexport function createStream<TData>(iii: ISdk, streamName: string, stream: IStream<TData>): void {\n  ;(iii as IIIWithHelperShims).__helpers_create_stream(streamName, stream)\n}\n"],"mappings":";;;;;;;;AAuBA,SAAgB,cAAc,KAAW,YAAuC;AAC9E,QAAQ,IAA2B,yBAAyB,WAAW;;;;;;;;AASzE,SAAgB,aAAoB,KAAW,YAAoB,QAA8B;AAC9F,CAAC,IAA2B,wBAAwB,YAAY,OAAO"}

package/dist/index.cjs

@@ -1,228 +1,13 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
-//#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");
+const require_utils = require('./utils-CuS1Knym.cjs');
 let ws = require("ws");
 let _opentelemetry_api = require("@opentelemetry/api");
 let node_module = require("node:module");
 let node_os = require("node:os");
-node_os = __toESM(node_os);
+node_os = require_utils.__toESM(node_os);
 let _iii_dev_observability = require("@iii-dev/observability");
 let _iii_dev_observability_internal = require("@iii-dev/observability/internal");
-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
-/**
-* Write end of a streaming channel. Provides both a Node.js `Writable` stream
-* and a `sendMessage` method for sending structured text messages.
-*
-* @example
-* ```typescript
-* const channel = await iii.createChannel()
-*
-* // Stream binary data
-* channel.writer.stream.write(Buffer.from('hello'))
-* channel.writer.stream.end()
-*
-* // Or send text messages
-* channel.writer.sendMessage(JSON.stringify({ type: 'event', data: 'test' }))
-* channel.writer.close()
-* ```
-*/
-var ChannelWriter = class ChannelWriter {
-	static {
-		this.FRAME_SIZE = 64 * 1024;
-	}
-	constructor(engineWsBase, ref) {
-		this.ws = null;
-		this.wsReady = false;
-		this.pendingMessages = [];
-		this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, "write");
-		this.stream = new node_stream.Writable({
-			write: (chunk, _encoding, callback) => {
-				const buf = Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk);
-				this.sendChunked(buf, callback);
-			},
-			final: (callback) => {
-				if (!this.ws) {
-					callback();
-					return;
-				}
-				const doClose = () => {
-					if (this.ws) this.ws.close(1e3, "stream_complete");
-					callback();
-				};
-				if (this.wsReady) setTimeout(doClose, 10);
-				else this.ws.on("open", () => setTimeout(doClose, 10));
-			},
-			destroy: (err, callback) => {
-				if (this.ws) this.ws.terminate();
-				callback(err);
-			}
-		});
-	}
-	ensureConnected() {
-		if (this.ws) return;
-		this.ws = new ws.WebSocket(this.url);
-		this.ws.on("open", () => {
-			this.wsReady = true;
-			for (const { data, callback } of this.pendingMessages) this.ws?.send(data, callback);
-			this.pendingMessages.length = 0;
-		});
-		this.ws.on("error", (err) => {
-			this.stream.destroy(err);
-		});
-		this.ws.on("close", () => {
-			if (!this.stream.destroyed) this.stream.destroy();
-		});
-	}
-	/** Send a text message through the channel. */
-	sendMessage(msg) {
-		this.ensureConnected();
-		this.sendRaw(msg, (err) => {
-			if (err) this.stream.destroy(err);
-		});
-	}
-	/** Close the channel writer. */
-	close() {
-		if (!this.ws) return;
-		const doClose = () => {
-			if (this.ws) this.ws.close(1e3, "channel_close");
-		};
-		if (this.wsReady) doClose();
-		else this.ws.on("open", () => doClose());
-	}
-	sendChunked(data, callback) {
-		let offset = 0;
-		const sendNext = (err) => {
-			if (err) {
-				callback(err);
-				return;
-			}
-			if (offset >= data.length) {
-				callback(null);
-				return;
-			}
-			const end = Math.min(offset + ChannelWriter.FRAME_SIZE, data.length);
-			const part = data.subarray(offset, end);
-			offset = end;
-			this.sendRaw(part, sendNext);
-		};
-		sendNext(null);
-	}
-	sendRaw(data, callback) {
-		this.ensureConnected();
-		if (this.wsReady && this.ws) this.ws.send(data, (err) => callback(err ?? null));
-		else this.pendingMessages.push({
-			data,
-			callback
-		});
-	}
-};
-/**
-* Read end of a streaming channel. Provides both a Node.js `Readable` stream
-* for binary data and an `onMessage` callback for structured text messages.
-*
-* @example
-* ```typescript
-* const channel = await iii.createChannel()
-*
-* // Stream binary data
-* channel.reader.stream.on('data', (chunk) => console.log(chunk))
-*
-* // Or receive text messages
-* channel.reader.onMessage((msg) => console.log('Got:', msg))
-* ```
-*/
-var ChannelReader = class {
-	constructor(engineWsBase, ref) {
-		this.ws = null;
-		this.connected = false;
-		this.messageCallbacks = [];
-		this.url = buildChannelUrl(engineWsBase, ref.channel_id, ref.access_key, "read");
-		const self = this;
-		this.stream = new node_stream.Readable({
-			read() {
-				self.ensureConnected();
-				if (self.ws) self.ws.resume();
-			},
-			destroy(err, callback) {
-				if (self.ws && self.ws.readyState !== ws.WebSocket.CLOSED) self.ws.terminate();
-				self.ws = null;
-				callback(err);
-			}
-		});
-	}
-	ensureConnected() {
-		if (this.connected) return;
-		this.connected = true;
-		this.ws = new ws.WebSocket(this.url);
-		this.ws.on("open", () => {
-			this.ws.binaryType = "nodebuffer";
-		});
-		this.ws.on("message", (data, isBinary) => {
-			if (isBinary) {
-				if (!this.stream.push(data)) this.ws?.pause();
-			} else {
-				const msg = data.toString("utf-8");
-				for (const cb of this.messageCallbacks) cb(msg);
-			}
-		});
-		this.ws.on("close", () => {
-			this.ws = null;
-			if (!this.stream.destroyed) this.stream.push(null);
-		});
-		this.ws.on("error", (err) => {
-			this.stream.destroy(err);
-		});
-	}
-	/** Register a callback to receive text messages from the channel. */
-	onMessage(callback) {
-		this.messageCallbacks.push(callback);
-	}
-	async readAll() {
-		this.ensureConnected();
-		const chunks = [];
-		for await (const chunk of this.stream) chunks.push(Buffer.isBuffer(chunk) ? chunk : Buffer.from(chunk));
-		return Buffer.concat(chunks);
-	}
-	close() {
-		if (this.ws && this.ws.readyState !== ws.WebSocket.CLOSED) this.ws.close(1e3, "channel_close");
-	}
-};
-function buildChannelUrl(engineWsBase, channelId, accessKey, direction) {
-	return `${engineWsBase.replace(/\/$/, "")}/ws/channels/${channelId}?key=${encodeURIComponent(accessKey)}&dir=${direction}`;
-}
-
-//#endregion
 //#region src/errors.ts
 var IIIInvocationError = class extends Error {
 	constructor(init) {
@@ -302,81 +87,6 @@ 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");
@@ -536,14 +246,14 @@ var Sdk = class {
 				}
 			};
 		};
-		this.createChannel = async (bufferSize) => {
+		this.__helpers_create_channel = async (bufferSize) => {
 			const result = await this.trigger({
 				function_id: "engine::channels::create",
 				payload: { buffer_size: bufferSize }
 			});
 			return {
-				writer: new ChannelWriter(this.address, result.writer),
-				reader: new ChannelReader(this.address, result.reader),
+				writer: new require_utils.ChannelWriter(this.address, result.writer),
+				reader: new require_utils.ChannelReader(this.address, result.reader),
 				writerRef: result.writer,
 				readerRef: result.reader
 			};
@@ -599,7 +309,7 @@ var Sdk = class {
 				});
 			});
 		};
-		this.createStream = (streamName, stream) => {
+		this.__helpers_create_stream = (streamName, stream) => {
 			this.registerFunction(`stream::get(${streamName})`, stream.get.bind(stream));
 			this.registerFunction(`stream::set(${streamName})`, stream.set.bind(stream));
 			this.registerFunction(`stream::delete(${streamName})`, stream.delete.bind(stream));
@@ -653,7 +363,7 @@ var Sdk = class {
 				isolation: process.env.III_ISOLATION || null,
 				telemetry: {
 					language,
-					project_name: telemetryOpts?.project_name ?? detectProjectName(),
+					project_name: telemetryOpts?.project_name ?? require_utils.detectProjectName(),
 					framework: telemetryOpts?.framework?.trim() || "iii-node",
 					amplitude_api_key: telemetryOpts?.amplitude_api_key
 				}
@@ -835,7 +545,7 @@ var Sdk = class {
 		});
 	}
 	resolveChannelValue(value) {
-		if (isChannelRef(value)) return value.direction === "read" ? new ChannelReader(this.address, value) : new ChannelWriter(this.address, value);
+		if (require_utils.isChannelRef(value)) return value.direction === "read" ? new require_utils.ChannelReader(this.address, value) : new require_utils.ChannelWriter(this.address, value);
 		if (Array.isArray(value)) return value.map((item) => this.resolveChannelValue(item));
 		if (value !== null && typeof value === "object") {
 			const out = {};
@@ -1017,8 +727,8 @@ const TriggerAction = {
 const registerWorker = (address, options) => new Sdk(address, options);
 
 //#endregion
-exports.ChannelReader = ChannelReader;
-exports.ChannelWriter = ChannelWriter;
+exports.ChannelReader = require_utils.ChannelReader;
+exports.ChannelWriter = require_utils.ChannelWriter;
 exports.EngineFunctions = EngineFunctions;
 exports.EngineTriggers = EngineTriggers;
 exports.IIIInvocationError = IIIInvocationError;
@@ -1029,6 +739,6 @@ Object.defineProperty(exports, 'Logger', {
   }
 });
 exports.TriggerAction = TriggerAction;
-exports.http = http;
+exports.http = require_utils.http;
 exports.registerWorker = registerWorker;
 //# sourceMappingURL=index.cjs.map