zeed 1.2.4 → 1.3.1

package/dist/common/msg/rpc.cjs

@@ -1,2 +1,143 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkRAXM7FU3cjs = require('../../chunk-RAXM7FU3.cjs');require('../../chunk-7UA33BQW.cjs');require('../../chunk-P7XCQ7WV.cjs');exports.RPCMode = _chunkRAXM7FU3cjs.a; exports.useRPC = _chunkRAXM7FU3cjs.b; exports.useRPCHub = _chunkRAXM7FU3cjs.c;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_exec_promise = require('../exec/promise.cjs');
+
+//#region src/common/msg/rpc.ts
+let rpcCounter = 1;
+let RPCMode = /* @__PURE__ */ function(RPCMode) {
+	RPCMode[RPCMode["request"] = 1] = "request";
+	RPCMode[RPCMode["event"] = 2] = "event";
+	RPCMode[RPCMode["resolve"] = 3] = "resolve";
+	RPCMode[RPCMode["reject"] = 4] = "reject";
+	return RPCMode;
+}({});
+const defaultSerialize = (i) => i;
+const defaultDeserialize = defaultSerialize;
+function setupRPCBasic(options, functions, eventNames = []) {
+	const { log, post, on, serialize = defaultSerialize, deserialize = defaultDeserialize, timeout = 6e4, onError, onTimeoutError, onlyEvents = false, exceptions = true, stringHashPool } = options;
+	if (stringHashPool) Object.keys(functions).forEach(stringHashPool.hash);
+	function checkEventNames(eventNames) {}
+	checkEventNames(eventNames);
+	function registerFunctions(additionalFunctions) {
+		Object.assign(functions, additionalFunctions ?? {});
+		if (stringHashPool) Object.keys(additionalFunctions).forEach(stringHashPool.hash);
+	}
+	function registerEventNames(additionalEventNames) {
+		checkEventNames(additionalEventNames);
+		eventNames.push(...additionalEventNames);
+	}
+	const rpcPromiseMap = /* @__PURE__ */ new Map();
+	on(async (data) => {
+		try {
+			const msg = await deserialize(data);
+			const mode = msg?.[0];
+			const id = mode === RPCMode.event ? 0 : msg?.[1];
+			const [method, ...args] = msg.slice(mode === RPCMode.event ? 1 : 2);
+			const methodName = stringHashPool?.stringForHash(method) ?? method;
+			if (mode === RPCMode.request || mode === RPCMode.event) {
+				let result, error;
+				if (method != null) try {
+					const fn = functions[methodName];
+					result = await fn(...args);
+				} catch (e) {
+					error = String(e);
+				}
+				else error = "Method implementation missing";
+				if (error) {
+					log?.warn("error", msg, error);
+					onError?.(error, method ?? "", args);
+				}
+				if (id > 0) await post(await serialize(error ? [
+					RPCMode.reject,
+					id,
+					error
+				] : [
+					RPCMode.resolve,
+					id,
+					result
+				]));
+			} else if (id) {
+				const promise = rpcPromiseMap.get(id);
+				if (promise != null) {
+					clearTimeout(promise.timeoutId);
+					if (mode === RPCMode.reject && exceptions === true) promise.reject(method);
+					else promise.resolve(method);
+				}
+				rpcPromiseMap.delete(id);
+			}
+		} catch (err) {
+			log?.warn("Error on handling RPC data. Invalid?", err, data);
+		}
+	});
+	return {
+		post,
+		serialize,
+		rpcPromiseMap,
+		proxyHandler: { get(_, methodName) {
+			const method = stringHashPool?.hash(methodName) ?? methodName;
+			const sendEvent = async (...args) => await post(await serialize([
+				RPCMode.event,
+				method,
+				...args
+			]));
+			if (onlyEvents || eventNames.includes(methodName)) {
+				sendEvent.asEvent = sendEvent;
+				return sendEvent;
+			}
+			const sendCall = async (...args) => {
+				const [promise, resolve, reject] = require_common_exec_promise.createPromise();
+				const id = rpcCounter++;
+				let timeoutId;
+				if (timeout >= 0) timeoutId = setTimeout(() => {
+					try {
+						onTimeoutError?.(methodName, args);
+						throw new Error(`rpc timeout on calling "${methodName}"`);
+					} catch (e) {
+						if (exceptions === true) reject(e);
+						else resolve(void 0);
+					}
+					rpcPromiseMap.delete(id);
+					clearTimeout(timeoutId);
+					timeoutId = void 0;
+				}, timeout).unref?.();
+				rpcPromiseMap.set(id, {
+					resolve,
+					reject,
+					timeoutId
+				});
+				await post(await serialize([
+					RPCMode.request,
+					id,
+					method,
+					...args
+				]));
+				return promise;
+			};
+			sendCall.asEvent = sendEvent;
+			return sendCall;
+		} },
+		registerFunctions,
+		registerEventNames
+	};
+}
+function useRPC(functions, options) {
+	const { eventNames = [] } = options;
+	const { proxyHandler } = setupRPCBasic(options, functions, eventNames);
+	return new Proxy({}, proxyHandler);
+}
+function useRPCHub(options) {
+	const { proxyHandler, registerFunctions, registerEventNames } = setupRPCBasic(options, {}, []);
+	function createRPCProxy() {
+		return new Proxy({}, proxyHandler);
+	}
+	return function(additionalFunctions, additionalEventNames = []) {
+		registerFunctions(additionalFunctions ?? {});
+		registerEventNames(additionalEventNames);
+		return createRPCProxy();
+	};
+}
+
+//#endregion
+exports.RPCMode = RPCMode;
+exports.useRPC = useRPC;
+exports.useRPCHub = useRPCHub;
 //# sourceMappingURL=rpc.cjs.map

package/dist/common/msg/rpc.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/common/msg/rpc.cjs"],"names":[],"mappings":"AAAA,qIAA2C,oCAAiC,oCAAiC,qHAAgD","file":"/Users/dirk/work/github-zeed/dist/common/msg/rpc.cjs"}
+{"version":3,"file":"rpc.cjs","names":["createPromise"],"sources":["../../../src/common/msg/rpc.ts"],"sourcesContent":["// From https://github.com/antfu/birpc/blob/main/src/index.ts MIT\n\nimport type { UseStringHashPool } from '../data/string-hash-pool'\nimport type { LoggerInterface } from '../log/log-base'\nimport type { Pipe } from './pipe'\nimport { createPromise } from '../exec/promise'\n\nexport type ArgumentsType<T> = T extends (...args: infer A) => any ? A : never\nexport type ReturnType<T> = T extends (...args: any) => infer R ? R : never\n\nexport interface RPCOptionsBasic extends Pipe {\n  /** No return values expected */\n  onlyEvents?: boolean\n  /** Maximum timeout for waiting for response, in milliseconds */\n  timeout?: number\n  /** Custom logger */\n  log?: LoggerInterface\n  /** Custom error handler */\n  onError?: (error: Error, functionName: string, args: any[]) => boolean | void\n  /** Custom error handler for timeouts */\n  onTimeoutError?: (functionName: string, args: any[]) => boolean | void\n  /** Throw execptions. Default: true */\n  exceptions?: boolean\n  /**  */\n  stringHashPool?: UseStringHashPool\n}\n\nexport interface RPCOptions<Remote> extends RPCOptionsBasic {\n  // /** No return values expected */\n  // onlyEvents?: boolean\n  /** Names of remote functions that do not need response. */\n  eventNames?: (keyof Remote)[]\n}\n\nexport interface RPCFn<T> {\n  /** Call the remote function and wait for the result. */\n  (...args: ArgumentsType<T>): Promise<Awaited<ReturnType<T>>>\n  /** Send event without asking for response */\n  asEvent: (...args: ArgumentsType<T>) => void\n}\n\nexport type RPCReturn<RemoteFunctions> = {\n  [K in keyof RemoteFunctions]: RPCFn<RemoteFunctions[K]>\n}\n\nlet rpcCounter = 1\n\nexport enum RPCMode {\n  request = 1,\n  event = 2,\n  resolve = 3,\n  reject = 4,\n}\n\nexport type RPCMessage = [\n  mode: RPCMode,\n  id: number,\n  method: string | number | any,\n  ...any,\n]\n\nconst defaultSerialize = (i: any) => i\nconst defaultDeserialize = defaultSerialize\n\nfunction setupRPCBasic(options: RPCOptionsBasic, functions: Record<string, (...args: any) => Promise<any>>, eventNames: string[] = []) {\n  const {\n    log,\n    post,\n    on,\n    serialize = defaultSerialize,\n    deserialize = defaultDeserialize,\n    timeout = 60e3,\n    onError,\n    onTimeoutError,\n    onlyEvents = false,\n    exceptions = true,\n    stringHashPool,\n  } = options\n\n  if (stringHashPool) {\n    Object.keys(functions).forEach(stringHashPool.hash)\n  }\n\n  function checkEventNames(eventNames: string[]) {\n    // eventNames.forEach((n) => {\n    //   if (functions[n] == null)\n    //     throw new Error(`event name ${n} has no registered function`)\n    // })\n  }\n\n  checkEventNames(eventNames)\n\n  function registerFunctions(additionalFunctions: any) {\n    Object.assign(functions, additionalFunctions ?? {})\n    if (stringHashPool)\n      Object.keys(additionalFunctions).forEach(stringHashPool.hash)\n  }\n\n  function registerEventNames(additionalEventNames: string[]) {\n    checkEventNames(additionalEventNames)\n    eventNames.push(...additionalEventNames)\n  }\n\n  const rpcPromiseMap = new Map<number, {\n    resolve: (...args: any) => any\n    reject: (...args: any) => any\n    timeoutId: Parameters<typeof clearTimeout>[0]\n  }>()\n\n  on(async (data) => {\n    try {\n      const msg = await deserialize(data) as RPCMessage\n      const mode = msg?.[0]\n      const id = mode === RPCMode.event ? 0 : msg?.[1]\n      const [method, ...args] = msg.slice(mode === RPCMode.event ? 1 : 2)\n      const methodName = stringHashPool?.stringForHash(method) ?? method\n      if (mode === RPCMode.request || mode === RPCMode.event) {\n        let result, error: any\n        if (method != null) {\n          try {\n            const fn = functions[methodName]\n            result = await fn(...args)\n          }\n          catch (e) {\n            error = String(e)\n          }\n        }\n        else {\n          error = 'Method implementation missing'\n        }\n        if (error) {\n          log?.warn('error', msg, error)\n          onError?.(error, method ?? '', args)\n        }\n        if (id > 0) {\n          const data = await serialize(error\n            ? [RPCMode.reject, id, error]\n            : [RPCMode.resolve, id, result])\n          await post(data)\n        }\n      }\n      else if (id) {\n        const promise = rpcPromiseMap.get(id)\n        if (promise != null) {\n          clearTimeout(promise.timeoutId)\n          if (mode === RPCMode.reject && exceptions === true)\n            promise.reject(method)\n          else\n            promise.resolve(method)\n        }\n        rpcPromiseMap.delete(id)\n      }\n    }\n    catch (err) {\n      log?.warn('Error on handling RPC data. Invalid?', err, data)\n    }\n  })\n\n  const proxyHandler = {\n    get(_: any, methodName: string) {\n      const method = stringHashPool?.hash(methodName) ?? methodName\n      const sendEvent = async (...args: any[]) => await post(await serialize([RPCMode.event, method, ...args]))\n\n      if (onlyEvents || eventNames.includes(methodName)) {\n        sendEvent.asEvent = sendEvent\n        return sendEvent\n      }\n\n      const sendCall = async (...args: any[]) => {\n        const [promise, resolve, reject] = createPromise()\n        const id = rpcCounter++\n\n        let timeoutId: any\n        if (timeout >= 0) {\n          timeoutId = setTimeout(() => {\n            try {\n              // Custom onTimeoutError handler can throw its own error too\n              onTimeoutError?.(methodName, args)\n              throw new Error(`rpc timeout on calling \"${methodName}\"`)\n            }\n            catch (e) {\n              if (exceptions === true)\n                reject(e)\n              else\n                resolve(undefined)\n            }\n            rpcPromiseMap.delete(id)\n\n            // Garbage Collection https://jakearchibald.com/2024/garbage-collection-and-closures/\n            clearTimeout(timeoutId)\n            timeoutId = undefined\n          }, timeout).unref?.()\n        }\n\n        rpcPromiseMap.set(id, { resolve, reject, timeoutId })\n        const data = await serialize([RPCMode.request, id, method, ...args])\n        await post(data)\n        return promise\n      }\n      sendCall.asEvent = sendEvent\n      return sendCall\n    },\n  }\n\n  return {\n    post,\n    serialize,\n    rpcPromiseMap,\n    proxyHandler,\n    registerFunctions,\n    registerEventNames,\n  }\n}\n\nexport function useRPC<LocalFunctions, RemoteFunctions = LocalFunctions>(\n  functions: LocalFunctions,\n  options: RPCOptions<RemoteFunctions>,\n): RPCReturn<RemoteFunctions> {\n  const { eventNames = [] } = options\n\n  const { proxyHandler } = setupRPCBasic(options, functions as any, eventNames as any)\n\n  return new Proxy({}, proxyHandler)\n}\n\nexport function useRPCHub(options: RPCOptionsBasic) {\n  const eventNames: string[] = []\n  const functions: Record<string, any> = {}\n\n  const {\n    proxyHandler,\n    registerFunctions,\n    registerEventNames,\n  } = setupRPCBasic(options, functions, eventNames)\n\n  function createRPCProxy() {\n    return new Proxy({}, proxyHandler)\n  }\n\n  return function<LocalFunctions, RemoteFunctions = LocalFunctions>(\n    additionalFunctions?: LocalFunctions,\n    additionalEventNames: string[] = [],\n  ): RPCReturn<RemoteFunctions> {\n    registerFunctions(additionalFunctions ?? {})\n    registerEventNames(additionalEventNames)\n    return createRPCProxy()\n  }\n}\n\nexport type UseRPCHubType = ReturnType<typeof useRPCHub>\n\n// Syntax test case\n// async function _demo() {\n//   const hub: UseRPCHubType = {} as any\n//   const x = hub({\n//     test(name: string): string {\n//       return name\n//     },\n//   })\n//   await x.test('dsd')\n// }\n"],"mappings":"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"}

package/dist/common/msg/rpc.d.cts

@@ -1,52 +1,2 @@
-import { UseStringHashPool } from '../data/string-hash-pool.cjs';
-import { LoggerInterface } from '../log/log-base.cjs';
-import { Pipe } from './pipe.cjs';
-
-type ArgumentsType<T> = T extends (...args: infer A) => any ? A : never;
-type ReturnType<T> = T extends (...args: any) => infer R ? R : never;
-interface RPCOptionsBasic extends Pipe {
-    /** No return values expected */
-    onlyEvents?: boolean;
-    /** Maximum timeout for waiting for response, in milliseconds */
-    timeout?: number;
-    /** Custom logger */
-    log?: LoggerInterface;
-    /** Custom error handler */
-    onError?: (error: Error, functionName: string, args: any[]) => boolean | void;
-    /** Custom error handler for timeouts */
-    onTimeoutError?: (functionName: string, args: any[]) => boolean | void;
-    /** Throw execptions. Default: true */
-    exceptions?: boolean;
-    /**  */
-    stringHashPool?: UseStringHashPool;
-}
-interface RPCOptions<Remote> extends RPCOptionsBasic {
-    /** Names of remote functions that do not need response. */
-    eventNames?: (keyof Remote)[];
-}
-interface RPCFn<T> {
-    /** Call the remote function and wait for the result. */
-    (...args: ArgumentsType<T>): Promise<Awaited<ReturnType<T>>>;
-    /** Send event without asking for response */
-    asEvent: (...args: ArgumentsType<T>) => void;
-}
-type RPCReturn<RemoteFunctions> = {
-    [K in keyof RemoteFunctions]: RPCFn<RemoteFunctions[K]>;
-};
-declare enum RPCMode {
-    request = 1,
-    event = 2,
-    resolve = 3,
-    reject = 4
-}
-type RPCMessage = [
-    mode: RPCMode,
-    id: number,
-    method: string | number | any,
-    ...any
-];
-declare function useRPC<LocalFunctions, RemoteFunctions = LocalFunctions>(functions: LocalFunctions, options: RPCOptions<RemoteFunctions>): RPCReturn<RemoteFunctions>;
-declare function useRPCHub(options: RPCOptionsBasic): <LocalFunctions, RemoteFunctions = LocalFunctions>(additionalFunctions?: LocalFunctions, additionalEventNames?: string[]) => RPCReturn<RemoteFunctions>;
-type UseRPCHubType = ReturnType<typeof useRPCHub>;
-
-export { type ArgumentsType, type RPCFn, type RPCMessage, RPCMode, type RPCOptions, type RPCOptionsBasic, type RPCReturn, type ReturnType, type UseRPCHubType, useRPC, useRPCHub };
+import { a as RPCOptions, c as ReturnType, d as useRPCHub, i as RPCMode, l as UseRPCHubType, n as RPCFn, o as RPCOptionsBasic, r as RPCMessage, s as RPCReturn, t as ArgumentsType, u as useRPC } from "../../rpc-5Ln_Xp7t.cjs";
+export { ArgumentsType, RPCFn, RPCMessage, RPCMode, RPCOptions, RPCOptionsBasic, RPCReturn, ReturnType, UseRPCHubType, useRPC, useRPCHub };

package/dist/common/msg/rpc.d.mts

@@ -0,0 +1,2 @@
+import { a as RPCOptions, c as ReturnType, d as useRPCHub, i as RPCMode, l as UseRPCHubType, n as RPCFn, o as RPCOptionsBasic, r as RPCMessage, s as RPCReturn, t as ArgumentsType, u as useRPC } from "../../rpc-DX1FYLVn.mjs";
+export { ArgumentsType, RPCFn, RPCMessage, RPCMode, RPCOptions, RPCOptionsBasic, RPCReturn, ReturnType, UseRPCHubType, useRPC, useRPCHub };

package/dist/common/msg/rpc.mjs

@@ -0,0 +1,140 @@
+import { createPromise } from "../exec/promise.mjs";
+
+//#region src/common/msg/rpc.ts
+let rpcCounter = 1;
+let RPCMode = /* @__PURE__ */ function(RPCMode) {
+	RPCMode[RPCMode["request"] = 1] = "request";
+	RPCMode[RPCMode["event"] = 2] = "event";
+	RPCMode[RPCMode["resolve"] = 3] = "resolve";
+	RPCMode[RPCMode["reject"] = 4] = "reject";
+	return RPCMode;
+}({});
+const defaultSerialize = (i) => i;
+const defaultDeserialize = defaultSerialize;
+function setupRPCBasic(options, functions, eventNames = []) {
+	const { log, post, on, serialize = defaultSerialize, deserialize = defaultDeserialize, timeout = 6e4, onError, onTimeoutError, onlyEvents = false, exceptions = true, stringHashPool } = options;
+	if (stringHashPool) Object.keys(functions).forEach(stringHashPool.hash);
+	function checkEventNames(eventNames) {}
+	checkEventNames(eventNames);
+	function registerFunctions(additionalFunctions) {
+		Object.assign(functions, additionalFunctions ?? {});
+		if (stringHashPool) Object.keys(additionalFunctions).forEach(stringHashPool.hash);
+	}
+	function registerEventNames(additionalEventNames) {
+		checkEventNames(additionalEventNames);
+		eventNames.push(...additionalEventNames);
+	}
+	const rpcPromiseMap = /* @__PURE__ */ new Map();
+	on(async (data) => {
+		try {
+			const msg = await deserialize(data);
+			const mode = msg?.[0];
+			const id = mode === RPCMode.event ? 0 : msg?.[1];
+			const [method, ...args] = msg.slice(mode === RPCMode.event ? 1 : 2);
+			const methodName = stringHashPool?.stringForHash(method) ?? method;
+			if (mode === RPCMode.request || mode === RPCMode.event) {
+				let result, error;
+				if (method != null) try {
+					const fn = functions[methodName];
+					result = await fn(...args);
+				} catch (e) {
+					error = String(e);
+				}
+				else error = "Method implementation missing";
+				if (error) {
+					log?.warn("error", msg, error);
+					onError?.(error, method ?? "", args);
+				}
+				if (id > 0) await post(await serialize(error ? [
+					RPCMode.reject,
+					id,
+					error
+				] : [
+					RPCMode.resolve,
+					id,
+					result
+				]));
+			} else if (id) {
+				const promise = rpcPromiseMap.get(id);
+				if (promise != null) {
+					clearTimeout(promise.timeoutId);
+					if (mode === RPCMode.reject && exceptions === true) promise.reject(method);
+					else promise.resolve(method);
+				}
+				rpcPromiseMap.delete(id);
+			}
+		} catch (err) {
+			log?.warn("Error on handling RPC data. Invalid?", err, data);
+		}
+	});
+	return {
+		post,
+		serialize,
+		rpcPromiseMap,
+		proxyHandler: { get(_, methodName) {
+			const method = stringHashPool?.hash(methodName) ?? methodName;
+			const sendEvent = async (...args) => await post(await serialize([
+				RPCMode.event,
+				method,
+				...args
+			]));
+			if (onlyEvents || eventNames.includes(methodName)) {
+				sendEvent.asEvent = sendEvent;
+				return sendEvent;
+			}
+			const sendCall = async (...args) => {
+				const [promise, resolve, reject] = createPromise();
+				const id = rpcCounter++;
+				let timeoutId;
+				if (timeout >= 0) timeoutId = setTimeout(() => {
+					try {
+						onTimeoutError?.(methodName, args);
+						throw new Error(`rpc timeout on calling "${methodName}"`);
+					} catch (e) {
+						if (exceptions === true) reject(e);
+						else resolve(void 0);
+					}
+					rpcPromiseMap.delete(id);
+					clearTimeout(timeoutId);
+					timeoutId = void 0;
+				}, timeout).unref?.();
+				rpcPromiseMap.set(id, {
+					resolve,
+					reject,
+					timeoutId
+				});
+				await post(await serialize([
+					RPCMode.request,
+					id,
+					method,
+					...args
+				]));
+				return promise;
+			};
+			sendCall.asEvent = sendEvent;
+			return sendCall;
+		} },
+		registerFunctions,
+		registerEventNames
+	};
+}
+function useRPC(functions, options) {
+	const { eventNames = [] } = options;
+	const { proxyHandler } = setupRPCBasic(options, functions, eventNames);
+	return new Proxy({}, proxyHandler);
+}
+function useRPCHub(options) {
+	const { proxyHandler, registerFunctions, registerEventNames } = setupRPCBasic(options, {}, []);
+	function createRPCProxy() {
+		return new Proxy({}, proxyHandler);
+	}
+	return function(additionalFunctions, additionalEventNames = []) {
+		registerFunctions(additionalFunctions ?? {});
+		registerEventNames(additionalEventNames);
+		return createRPCProxy();
+	};
+}
+
+//#endregion
+export { RPCMode, useRPC, useRPCHub };
+//# sourceMappingURL=rpc.mjs.map

package/dist/common/msg/rpc.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.mjs","names":[],"sources":["../../../src/common/msg/rpc.ts"],"sourcesContent":["// From https://github.com/antfu/birpc/blob/main/src/index.ts MIT\n\nimport type { UseStringHashPool } from '../data/string-hash-pool'\nimport type { LoggerInterface } from '../log/log-base'\nimport type { Pipe } from './pipe'\nimport { createPromise } from '../exec/promise'\n\nexport type ArgumentsType<T> = T extends (...args: infer A) => any ? A : never\nexport type ReturnType<T> = T extends (...args: any) => infer R ? R : never\n\nexport interface RPCOptionsBasic extends Pipe {\n  /** No return values expected */\n  onlyEvents?: boolean\n  /** Maximum timeout for waiting for response, in milliseconds */\n  timeout?: number\n  /** Custom logger */\n  log?: LoggerInterface\n  /** Custom error handler */\n  onError?: (error: Error, functionName: string, args: any[]) => boolean | void\n  /** Custom error handler for timeouts */\n  onTimeoutError?: (functionName: string, args: any[]) => boolean | void\n  /** Throw execptions. Default: true */\n  exceptions?: boolean\n  /**  */\n  stringHashPool?: UseStringHashPool\n}\n\nexport interface RPCOptions<Remote> extends RPCOptionsBasic {\n  // /** No return values expected */\n  // onlyEvents?: boolean\n  /** Names of remote functions that do not need response. */\n  eventNames?: (keyof Remote)[]\n}\n\nexport interface RPCFn<T> {\n  /** Call the remote function and wait for the result. */\n  (...args: ArgumentsType<T>): Promise<Awaited<ReturnType<T>>>\n  /** Send event without asking for response */\n  asEvent: (...args: ArgumentsType<T>) => void\n}\n\nexport type RPCReturn<RemoteFunctions> = {\n  [K in keyof RemoteFunctions]: RPCFn<RemoteFunctions[K]>\n}\n\nlet rpcCounter = 1\n\nexport enum RPCMode {\n  request = 1,\n  event = 2,\n  resolve = 3,\n  reject = 4,\n}\n\nexport type RPCMessage = [\n  mode: RPCMode,\n  id: number,\n  method: string | number | any,\n  ...any,\n]\n\nconst defaultSerialize = (i: any) => i\nconst defaultDeserialize = defaultSerialize\n\nfunction setupRPCBasic(options: RPCOptionsBasic, functions: Record<string, (...args: any) => Promise<any>>, eventNames: string[] = []) {\n  const {\n    log,\n    post,\n    on,\n    serialize = defaultSerialize,\n    deserialize = defaultDeserialize,\n    timeout = 60e3,\n    onError,\n    onTimeoutError,\n    onlyEvents = false,\n    exceptions = true,\n    stringHashPool,\n  } = options\n\n  if (stringHashPool) {\n    Object.keys(functions).forEach(stringHashPool.hash)\n  }\n\n  function checkEventNames(eventNames: string[]) {\n    // eventNames.forEach((n) => {\n    //   if (functions[n] == null)\n    //     throw new Error(`event name ${n} has no registered function`)\n    // })\n  }\n\n  checkEventNames(eventNames)\n\n  function registerFunctions(additionalFunctions: any) {\n    Object.assign(functions, additionalFunctions ?? {})\n    if (stringHashPool)\n      Object.keys(additionalFunctions).forEach(stringHashPool.hash)\n  }\n\n  function registerEventNames(additionalEventNames: string[]) {\n    checkEventNames(additionalEventNames)\n    eventNames.push(...additionalEventNames)\n  }\n\n  const rpcPromiseMap = new Map<number, {\n    resolve: (...args: any) => any\n    reject: (...args: any) => any\n    timeoutId: Parameters<typeof clearTimeout>[0]\n  }>()\n\n  on(async (data) => {\n    try {\n      const msg = await deserialize(data) as RPCMessage\n      const mode = msg?.[0]\n      const id = mode === RPCMode.event ? 0 : msg?.[1]\n      const [method, ...args] = msg.slice(mode === RPCMode.event ? 1 : 2)\n      const methodName = stringHashPool?.stringForHash(method) ?? method\n      if (mode === RPCMode.request || mode === RPCMode.event) {\n        let result, error: any\n        if (method != null) {\n          try {\n            const fn = functions[methodName]\n            result = await fn(...args)\n          }\n          catch (e) {\n            error = String(e)\n          }\n        }\n        else {\n          error = 'Method implementation missing'\n        }\n        if (error) {\n          log?.warn('error', msg, error)\n          onError?.(error, method ?? '', args)\n        }\n        if (id > 0) {\n          const data = await serialize(error\n            ? [RPCMode.reject, id, error]\n            : [RPCMode.resolve, id, result])\n          await post(data)\n        }\n      }\n      else if (id) {\n        const promise = rpcPromiseMap.get(id)\n        if (promise != null) {\n          clearTimeout(promise.timeoutId)\n          if (mode === RPCMode.reject && exceptions === true)\n            promise.reject(method)\n          else\n            promise.resolve(method)\n        }\n        rpcPromiseMap.delete(id)\n      }\n    }\n    catch (err) {\n      log?.warn('Error on handling RPC data. Invalid?', err, data)\n    }\n  })\n\n  const proxyHandler = {\n    get(_: any, methodName: string) {\n      const method = stringHashPool?.hash(methodName) ?? methodName\n      const sendEvent = async (...args: any[]) => await post(await serialize([RPCMode.event, method, ...args]))\n\n      if (onlyEvents || eventNames.includes(methodName)) {\n        sendEvent.asEvent = sendEvent\n        return sendEvent\n      }\n\n      const sendCall = async (...args: any[]) => {\n        const [promise, resolve, reject] = createPromise()\n        const id = rpcCounter++\n\n        let timeoutId: any\n        if (timeout >= 0) {\n          timeoutId = setTimeout(() => {\n            try {\n              // Custom onTimeoutError handler can throw its own error too\n              onTimeoutError?.(methodName, args)\n              throw new Error(`rpc timeout on calling \"${methodName}\"`)\n            }\n            catch (e) {\n              if (exceptions === true)\n                reject(e)\n              else\n                resolve(undefined)\n            }\n            rpcPromiseMap.delete(id)\n\n            // Garbage Collection https://jakearchibald.com/2024/garbage-collection-and-closures/\n            clearTimeout(timeoutId)\n            timeoutId = undefined\n          }, timeout).unref?.()\n        }\n\n        rpcPromiseMap.set(id, { resolve, reject, timeoutId })\n        const data = await serialize([RPCMode.request, id, method, ...args])\n        await post(data)\n        return promise\n      }\n      sendCall.asEvent = sendEvent\n      return sendCall\n    },\n  }\n\n  return {\n    post,\n    serialize,\n    rpcPromiseMap,\n    proxyHandler,\n    registerFunctions,\n    registerEventNames,\n  }\n}\n\nexport function useRPC<LocalFunctions, RemoteFunctions = LocalFunctions>(\n  functions: LocalFunctions,\n  options: RPCOptions<RemoteFunctions>,\n): RPCReturn<RemoteFunctions> {\n  const { eventNames = [] } = options\n\n  const { proxyHandler } = setupRPCBasic(options, functions as any, eventNames as any)\n\n  return new Proxy({}, proxyHandler)\n}\n\nexport function useRPCHub(options: RPCOptionsBasic) {\n  const eventNames: string[] = []\n  const functions: Record<string, any> = {}\n\n  const {\n    proxyHandler,\n    registerFunctions,\n    registerEventNames,\n  } = setupRPCBasic(options, functions, eventNames)\n\n  function createRPCProxy() {\n    return new Proxy({}, proxyHandler)\n  }\n\n  return function<LocalFunctions, RemoteFunctions = LocalFunctions>(\n    additionalFunctions?: LocalFunctions,\n    additionalEventNames: string[] = [],\n  ): RPCReturn<RemoteFunctions> {\n    registerFunctions(additionalFunctions ?? {})\n    registerEventNames(additionalEventNames)\n    return createRPCProxy()\n  }\n}\n\nexport type UseRPCHubType = ReturnType<typeof useRPCHub>\n\n// Syntax test case\n// async function _demo() {\n//   const hub: UseRPCHubType = {} as any\n//   const x = hub({\n//     test(name: string): string {\n//       return name\n//     },\n//   })\n//   await x.test('dsd')\n// }\n"],"mappings":";;;AA6CA,IAAI,aAAa;AAEjB,IAAY,UAAL;AACL;AACA;AACA;AACA;;KACD;AASD,MAAM,oBAAoB,MAAW;AACrC,MAAM,qBAAqB;AAE3B,SAAS,cAAc,SAA0B,WAA2D,aAAuB,EAAE,EAAE;CACrI,MAAM,EACJ,KACA,MACA,IACA,YAAY,kBACZ,cAAc,oBACd,UAAU,KACV,SACA,gBACA,aAAa,OACb,aAAa,MACb,mBACE;AAEJ,KAAI,eACF,QAAO,KAAK,UAAU,CAAC,QAAQ,eAAe,KAAK;CAGrD,SAAS,gBAAgB,YAAsB;AAO/C,iBAAgB,WAAW;CAE3B,SAAS,kBAAkB,qBAA0B;AACnD,SAAO,OAAO,WAAW,uBAAuB,EAAE,CAAC;AACnD,MAAI,eACF,QAAO,KAAK,oBAAoB,CAAC,QAAQ,eAAe,KAAK;;CAGjE,SAAS,mBAAmB,sBAAgC;AAC1D,kBAAgB,qBAAqB;AACrC,aAAW,KAAK,GAAG,qBAAqB;;CAG1C,MAAM,gCAAgB,IAAI,KAItB;AAEJ,IAAG,OAAO,SAAS;AACjB,MAAI;GACF,MAAM,MAAM,MAAM,YAAY,KAAK;GACnC,MAAM,OAAO,MAAM;GACnB,MAAM,KAAK,SAAS,QAAQ,QAAQ,IAAI,MAAM;GAC9C,MAAM,CAAC,QAAQ,GAAG,QAAQ,IAAI,MAAM,SAAS,QAAQ,QAAQ,IAAI,EAAE;GACnE,MAAM,aAAa,gBAAgB,cAAc,OAAO,IAAI;AAC5D,OAAI,SAAS,QAAQ,WAAW,SAAS,QAAQ,OAAO;IACtD,IAAI,QAAQ;AACZ,QAAI,UAAU,KACZ,KAAI;KACF,MAAM,KAAK,UAAU;AACrB,cAAS,MAAM,GAAG,GAAG,KAAK;aAErB,GAAG;AACR,aAAQ,OAAO,EAAE;;QAInB,SAAQ;AAEV,QAAI,OAAO;AACT,UAAK,KAAK,SAAS,KAAK,MAAM;AAC9B,eAAU,OAAO,UAAU,IAAI,KAAK;;AAEtC,QAAI,KAAK,EAIP,OAAM,KAHO,MAAM,UAAU,QACzB;KAAC,QAAQ;KAAQ;KAAI;KAAM,GAC3B;KAAC,QAAQ;KAAS;KAAI;KAAO,CAAC,CAClB;cAGX,IAAI;IACX,MAAM,UAAU,cAAc,IAAI,GAAG;AACrC,QAAI,WAAW,MAAM;AACnB,kBAAa,QAAQ,UAAU;AAC/B,SAAI,SAAS,QAAQ,UAAU,eAAe,KAC5C,SAAQ,OAAO,OAAO;SAEtB,SAAQ,QAAQ,OAAO;;AAE3B,kBAAc,OAAO,GAAG;;WAGrB,KAAK;AACV,QAAK,KAAK,wCAAwC,KAAK,KAAK;;GAE9D;AAgDF,QAAO;EACL;EACA;EACA;EACA,cAlDmB,EACnB,IAAI,GAAQ,YAAoB;GAC9B,MAAM,SAAS,gBAAgB,KAAK,WAAW,IAAI;GACnD,MAAM,YAAY,OAAO,GAAG,SAAgB,MAAM,KAAK,MAAM,UAAU;IAAC,QAAQ;IAAO;IAAQ,GAAG;IAAK,CAAC,CAAC;AAEzG,OAAI,cAAc,WAAW,SAAS,WAAW,EAAE;AACjD,cAAU,UAAU;AACpB,WAAO;;GAGT,MAAM,WAAW,OAAO,GAAG,SAAgB;IACzC,MAAM,CAAC,SAAS,SAAS,UAAU,eAAe;IAClD,MAAM,KAAK;IAEX,IAAI;AACJ,QAAI,WAAW,EACb,aAAY,iBAAiB;AAC3B,SAAI;AAEF,uBAAiB,YAAY,KAAK;AAClC,YAAM,IAAI,MAAM,2BAA2B,WAAW,GAAG;cAEpD,GAAG;AACR,UAAI,eAAe,KACjB,QAAO,EAAE;UAET,SAAQ,OAAU;;AAEtB,mBAAc,OAAO,GAAG;AAGxB,kBAAa,UAAU;AACvB,iBAAY;OACX,QAAQ,CAAC,SAAS;AAGvB,kBAAc,IAAI,IAAI;KAAE;KAAS;KAAQ;KAAW,CAAC;AAErD,UAAM,KADO,MAAM,UAAU;KAAC,QAAQ;KAAS;KAAI;KAAQ,GAAG;KAAK,CAAC,CACpD;AAChB,WAAO;;AAET,YAAS,UAAU;AACnB,UAAO;KAEV;EAOC;EACA;EACD;;AAGH,SAAgB,OACd,WACA,SAC4B;CAC5B,MAAM,EAAE,aAAa,EAAE,KAAK;CAE5B,MAAM,EAAE,iBAAiB,cAAc,SAAS,WAAkB,WAAkB;AAEpF,QAAO,IAAI,MAAM,EAAE,EAAE,aAAa;;AAGpC,SAAgB,UAAU,SAA0B;CAIlD,MAAM,EACJ,cACA,mBACA,uBACE,cAAc,SANqB,EAAE,EADZ,EAAE,CAOkB;CAEjD,SAAS,iBAAiB;AACxB,SAAO,IAAI,MAAM,EAAE,EAAE,aAAa;;AAGpC,QAAO,SACL,qBACA,uBAAiC,EAAE,EACP;AAC5B,oBAAkB,uBAAuB,EAAE,CAAC;AAC5C,qBAAmB,qBAAqB;AACxC,SAAO,gBAAgB"}

package/dist/common/network.cjs

@@ -1,2 +1,130 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true});var _chunkB75IPNYGcjs = require('../chunk-B75IPNYG.cjs');require('../chunk-HTEAHUXG.cjs');require('../chunk-CGNAZMNO.cjs');require('../chunk-X764QBCC.cjs');require('../chunk-KYDHX5HW.cjs');require('../chunk-B2XPF5R4.cjs');require('../chunk-VX3R7DUJ.cjs');require('../chunk-JLB5ALZ5.cjs');require('../chunk-ZJQITDTA.cjs');require('../chunk-CWGNDC2T.cjs');require('../chunk-DLVWYIS2.cjs');require('../chunk-SEQAFKIV.cjs');require('../chunk-IVUEQANC.cjs');require('../chunk-IXH5D35S.cjs');require('../chunk-DRKHTT76.cjs');require('../chunk-TNMEWZPW.cjs');require('../chunk-UXW3L3L6.cjs');require('../chunk-5RHVNJKM.cjs');require('../chunk-P7XCQ7WV.cjs');exports.fetchBasic = _chunkB75IPNYGcjs.b; exports.fetchJson = _chunkB75IPNYGcjs.c; exports.fetchOptionsBasicAuth = _chunkB75IPNYGcjs.g; exports.fetchOptionsFormURLEncoded = _chunkB75IPNYGcjs.e; exports.fetchOptionsJson = _chunkB75IPNYGcjs.f; exports.fetchText = _chunkB75IPNYGcjs.d; exports.parseBasicAuth = _chunkB75IPNYGcjs.a;
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+const require_common_data_json = require('./data/json.cjs');
+const require_common_data_is = require('./data/is.cjs');
+const require_common_log_log = require('./log/log.cjs');
+const require_bin = require('../bin-Ddaz2lxM.cjs');
+const require_common_data_array = require('./data/array.cjs');
+const require_common_data_deep = require('./data/deep.cjs');
+const require_common_data_url = require('./data/url.cjs');
+
+//#region src/common/network.ts
+const defaultOptions = {
+	cache: "no-cache",
+	redirect: "follow",
+	headers: {}
+};
+function parseBasicAuth(url) {
+	const m = /:\/\/([^@]*)@/.exec(url);
+	if (m && m[1]) {
+		const [username, password] = m[1].split(":", 2);
+		return {
+			url: url.replace(`${m[1]}@`, ""),
+			username,
+			password
+		};
+	}
+}
+/**
+* Simplified `fetch` wrapper.
+* - Accepts a single fetch options object or an array of options which will be deep-merged.
+* - Supports basic auth embedded in the URL (e.g. https://user:pass@host/path).
+* - Normalizes headers to a `Headers` instance.
+* - Returns the `Response` when status < 400, otherwise returns `undefined`.
+* @category Network
+*/
+async function fetchBasic(url, fetchOptions = {}, fetchFn = fetch) {
+	try {
+		if (require_common_data_is.isArray(fetchOptions)) fetchOptions = require_common_data_deep.deepMerge({}, ...require_common_data_array.arrayFlatten(fetchOptions));
+		const auth = parseBasicAuth(String(url));
+		if (auth) {
+			url = auth.url;
+			fetchOptions = require_common_data_deep.deepMerge({}, fetchOptions, fetchOptionsBasicAuth(auth.username, auth.password));
+		}
+		if (fetchOptions.headers != null && !(fetchOptions.headers instanceof Headers)) fetchOptions.headers = new Headers(fetchOptions.headers);
+		const response = await fetchFn(String(url), fetchOptions);
+		if (response.status < 400) return response;
+		const log = require_common_log_log.DefaultLogger("zeed:network");
+		try {
+			log.warn(`Fetch of ${String(url)} returned status=${response.status}. Options:`, fetchOptions);
+			log.warn(`Response: ${await response.text()}`);
+		} catch (err) {
+			log.error("Exception:", err);
+		}
+	} catch (err) {
+		require_common_log_log.DefaultLogger("zeed:network").error("fetchBasic", err);
+	}
+}
+/**
+* Fetch and parse JSON.
+* Returns the parsed JSON object or `undefined` on error.
+* @category Network
+*/
+async function fetchJson(url, fetchOptions = {}, fetchFn = fetch) {
+	try {
+		const res = await fetchBasic(url, [{
+			method: "GET",
+			headers: { Accept: "application/json" }
+		}, fetchOptions], fetchFn);
+		if (res) return require_common_data_json.jsonParse(await res.text());
+	} catch (err) {
+		require_common_log_log.DefaultLogger("zeed:network").error("fetchJSON error:", err);
+	}
+}
+/**
+* Fetch text content.
+* Returns the response text or `undefined` on error.
+* @category Network
+*/
+async function fetchText(url, fetchOptions = {}, fetchFn = fetch) {
+	try {
+		const res = await fetchBasic(url, [
+			defaultOptions,
+			{ method: "GET" },
+			fetchOptions
+		], fetchFn);
+		if (res) return await res.text();
+	} catch (err) {
+		require_common_log_log.DefaultLogger("zeed:network").error("fetchHTML error:", err);
+	}
+}
+/**
+* Options for `fetchBasic` to send data as application/x-www-form-urlencoded.
+* @category Network
+*/
+function fetchOptionsFormURLEncoded(data, method = "POST") {
+	return {
+		method,
+		...defaultOptions,
+		headers: { "Content-Type": "application/x-www-form-urlencoded; charset=utf-8" },
+		body: require_common_data_url.encodeQuery(data)
+	};
+}
+/**
+* Options for `fetchBasic` to send JSON data.
+* @category Network
+*/
+function fetchOptionsJson(data, method = "POST") {
+	return {
+		method,
+		...defaultOptions,
+		headers: { "Content-Type": "application/json; charset=utf-8" },
+		body: require_common_data_json.jsonStringifySafe(data)
+	};
+}
+/**
+* Create options to add Basic Authorization header using given username/password.
+* @category Network
+*/
+function fetchOptionsBasicAuth(username, password) {
+	return { headers: { Authorization: `Basic ${require_bin.toBase64(`${username}:${password}`)}` } };
+}
+
+//#endregion
+exports.fetchBasic = fetchBasic;
+exports.fetchJson = fetchJson;
+exports.fetchOptionsBasicAuth = fetchOptionsBasicAuth;
+exports.fetchOptionsFormURLEncoded = fetchOptionsFormURLEncoded;
+exports.fetchOptionsJson = fetchOptionsJson;
+exports.fetchText = fetchText;
+exports.parseBasicAuth = parseBasicAuth;
 //# sourceMappingURL=network.cjs.map

package/dist/common/network.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/Users/dirk/work/github-zeed/dist/common/network.cjs"],"names":[],"mappings":"AAAA,kIAAgD,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,iCAA8B,wUAA2J","file":"/Users/dirk/work/github-zeed/dist/common/network.cjs"}
+{"version":3,"file":"network.cjs","names":["isArray","deepMerge","arrayFlatten","DefaultLogger","jsonParse","encodeQuery","jsonStringifySafe","toBase64"],"sources":["../../src/common/network.ts"],"sourcesContent":["import type { Json } from './types'\nimport { arrayFlatten } from './data/array'\nimport { toBase64 } from './data/bin'\nimport { deepMerge } from './data/deep'\nimport { isArray } from './data/is'\nimport { jsonParse, jsonStringifySafe } from './data/json'\nimport { encodeQuery } from './data/url'\nimport { DefaultLogger } from './log/log'\n\n// TODO: Abort signal https://codedrivendevelopment.com/posts/everything-about-abort-signal-timeout\n\n/**\n * Options for fetch requests.\n * @category Network\n */\nexport interface fetchOptionType {\n  /** Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching. */\n  cache?: RequestCache\n  /** Returns the credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL. */\n  credentials?: RequestCredentials\n  /** Returns the kind of resource requested by request, e.g., \"document\" or \"script\". */\n  destination?: RequestDestination\n  /** Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the \"Host\" header. */\n  headers?: Record<string, string>\n  /** Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI] */\n  integrity?: string\n  /** Returns a boolean indicating whether or not request can outlive the global in which it was created. */\n  keepalive?: boolean\n  /** Returns request's HTTP method, which is \"GET\" by default. */\n  method?: string\n  /** Returns the mode associated with request, which is a string indicating whether the request will use CORS, or will be restricted to same-origin URLs. */\n  mode?: RequestMode\n  /** Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default. */\n  redirect?: RequestRedirect\n  /** Returns the referrer of request. Its value can be a same-origin URL if explicitly set in init, the empty string to indicate no referrer, and \"about:client\" when defaulting to the global's default. This is used during fetching to determine the value of the `Referer` header of the request being made. */\n  referrer?: string\n  /** Returns the referrer policy associated with request. This is used during fetching to compute the value of the request's referrer. */\n  referrerPolicy?: ReferrerPolicy\n  /** Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler. */\n  signal?: AbortSignal\n  /** Returns the URL of request as a string. */\n  url?: string\n  body?: any\n}\n\n/**\n * Type for fetch options, can be a single option or an array of options.\n * @category Network\n */\nexport type fetchOptionsType = fetchOptionType | fetchOptionsType[]\n\nconst defaultOptions: fetchOptionType = {\n  cache: 'no-cache',\n  redirect: 'follow',\n  headers: {},\n}\n\n// Source https://developer.mozilla.org/de/docs/Web/HTTP/Methods\nexport type httpMethod\n  = | 'GET'\n    | 'POST'\n    | 'PUT'\n    | 'DELETE'\n    | 'HEAD'\n    | 'CONNECT'\n    | 'OPTIONS'\n    | 'TRACE'\n    | 'PATCH'\n\nexport function parseBasicAuth(url: string) {\n  const m = /:\\/\\/([^@]*)@/.exec(url)\n  if (m && m[1]) {\n    const [username, password] = m[1].split(':', 2)\n    return {\n      url: url.replace(`${m[1]}@`, ''),\n      username,\n      password,\n    }\n  }\n}\n\n/**\n * Simplified `fetch` wrapper.\n * - Accepts a single fetch options object or an array of options which will be deep-merged.\n * - Supports basic auth embedded in the URL (e.g. https://user:pass@host/path).\n * - Normalizes headers to a `Headers` instance.\n * - Returns the `Response` when status < 400, otherwise returns `undefined`.\n * @category Network\n */\nexport async function fetchBasic(\n  url: string | URL,\n  fetchOptions: fetchOptionsType = {},\n  fetchFn: (input: RequestInfo, init?: RequestInit) => Promise<Response> = fetch,\n): Promise<Response | undefined> {\n  try {\n    if (isArray(fetchOptions))\n      fetchOptions = deepMerge({}, ...arrayFlatten(fetchOptions))\n\n    const auth = parseBasicAuth(String(url))\n    if (auth) {\n      url = auth.url\n      fetchOptions = deepMerge(\n        {},\n        fetchOptions,\n        fetchOptionsBasicAuth(auth.username, auth.password),\n      )\n    }\n\n    if (\n      // @ts-expect-error headers\n      fetchOptions.headers != null\n      // @ts-expect-error headers\n      && !(fetchOptions.headers instanceof Headers)\n    ) {\n      // @ts-expect-error headers\n      fetchOptions.headers = new Headers(fetchOptions.headers)\n    }\n\n    // log(\"fetch\", url, fetchOptions)\n    const response = await fetchFn(String(url), fetchOptions as RequestInit)\n\n    // https://developer.mozilla.org/en-US/docs/Web/HTTP/Status\n    if (response.status < 400)\n      return response\n\n    const log = DefaultLogger('zeed:network')\n\n    try {\n      log.warn(`Fetch of ${String(url)} returned status=${response.status}. Options:`, fetchOptions)\n      log.warn(`Response: ${await response.text()}`)\n    }\n    catch (err) {\n      log.error('Exception:', err)\n    }\n  }\n  catch (err) {\n    const log = DefaultLogger('zeed:network')\n    log.error('fetchBasic', err)\n  }\n}\n/**\n * Fetch and parse JSON.\n * Returns the parsed JSON object or `undefined` on error.\n * @category Network\n */\nexport async function fetchJson<T = Json>(\n  url: string | URL,\n  fetchOptions: fetchOptionsType = {},\n  fetchFn: (input: RequestInfo, init?: RequestInit) => Promise<Response> = fetch,\n): Promise<T | undefined> {\n  try {\n    const res = await fetchBasic(\n      url,\n      [\n        {\n          method: 'GET',\n          headers: {\n            Accept: 'application/json',\n          },\n        },\n        fetchOptions,\n      ],\n      fetchFn,\n    )\n    if (res)\n      return jsonParse(await res.text())\n  }\n  catch (err) {\n    const log = DefaultLogger('zeed:network')\n    log.error('fetchJSON error:', err)\n  }\n}\n/**\n * Fetch text content.\n * Returns the response text or `undefined` on error.\n * @category Network\n */\nexport async function fetchText(\n  url: string | URL,\n  fetchOptions: fetchOptionsType = {},\n  fetchFn: (input: RequestInfo, init?: RequestInit) => Promise<Response> = fetch,\n): Promise<string | undefined> {\n  try {\n    const res = await fetchBasic(\n      url,\n      [defaultOptions, { method: 'GET' }, fetchOptions],\n      fetchFn,\n    )\n    if (res)\n      return await res.text()\n  }\n  catch (err) {\n    const log = DefaultLogger('zeed:network')\n    log.error('fetchHTML error:', err)\n  }\n}\n\n///\n\n/**\n * Options for `fetchBasic` to send data as application/x-www-form-urlencoded.\n * @category Network\n */\nexport function fetchOptionsFormURLEncoded(\n  data: object,\n  method: httpMethod = 'POST',\n): fetchOptionType {\n  return {\n    method,\n    ...defaultOptions,\n    headers: {\n      'Content-Type': 'application/x-www-form-urlencoded; charset=utf-8',\n    },\n    body: encodeQuery(data),\n  }\n}\n\n/**\n * Options for `fetchBasic` to send JSON data.\n * @category Network\n */\nexport function fetchOptionsJson(\n  data: object,\n  method: httpMethod = 'POST',\n): fetchOptionType {\n  return {\n    method,\n    ...defaultOptions,\n    headers: {\n      'Content-Type': 'application/json; charset=utf-8',\n      // Accept: \"application/json\",\n    },\n    body: jsonStringifySafe(data),\n  }\n}\n\n/**\n * Create options to add Basic Authorization header using given username/password.\n * @category Network\n */\nexport function fetchOptionsBasicAuth(\n  username: string,\n  password: string,\n): fetchOptionType {\n  return {\n    headers: {\n      Authorization: `Basic ${toBase64(`${username}:${password}`)}`,\n    },\n  }\n}\n"],"mappings":";;;;;;;;;;AAmDA,MAAM,iBAAkC;CACtC,OAAO;CACP,UAAU;CACV,SAAS,EAAE;CACZ;AAcD,SAAgB,eAAe,KAAa;CAC1C,MAAM,IAAI,gBAAgB,KAAK,IAAI;AACnC,KAAI,KAAK,EAAE,IAAI;EACb,MAAM,CAAC,UAAU,YAAY,EAAE,GAAG,MAAM,KAAK,EAAE;AAC/C,SAAO;GACL,KAAK,IAAI,QAAQ,GAAG,EAAE,GAAG,IAAI,GAAG;GAChC;GACA;GACD;;;;;;;;;;;AAYL,eAAsB,WACpB,KACA,eAAiC,EAAE,EACnC,UAAyE,OAC1C;AAC/B,KAAI;AACF,MAAIA,+BAAQ,aAAa,CACvB,gBAAeC,mCAAU,EAAE,EAAE,GAAGC,uCAAa,aAAa,CAAC;EAE7D,MAAM,OAAO,eAAe,OAAO,IAAI,CAAC;AACxC,MAAI,MAAM;AACR,SAAM,KAAK;AACX,kBAAeD,mCACb,EAAE,EACF,cACA,sBAAsB,KAAK,UAAU,KAAK,SAAS,CACpD;;AAGH,MAEE,aAAa,WAAW,QAErB,EAAE,aAAa,mBAAmB,SAGrC,cAAa,UAAU,IAAI,QAAQ,aAAa,QAAQ;EAI1D,MAAM,WAAW,MAAM,QAAQ,OAAO,IAAI,EAAE,aAA4B;AAGxE,MAAI,SAAS,SAAS,IACpB,QAAO;EAET,MAAM,MAAME,qCAAc,eAAe;AAEzC,MAAI;AACF,OAAI,KAAK,YAAY,OAAO,IAAI,CAAC,mBAAmB,SAAS,OAAO,aAAa,aAAa;AAC9F,OAAI,KAAK,aAAa,MAAM,SAAS,MAAM,GAAG;WAEzC,KAAK;AACV,OAAI,MAAM,cAAc,IAAI;;UAGzB,KAAK;AAEV,EADYA,qCAAc,eAAe,CACrC,MAAM,cAAc,IAAI;;;;;;;;AAQhC,eAAsB,UACpB,KACA,eAAiC,EAAE,EACnC,UAAyE,OACjD;AACxB,KAAI;EACF,MAAM,MAAM,MAAM,WAChB,KACA,CACE;GACE,QAAQ;GACR,SAAS,EACP,QAAQ,oBACT;GACF,EACD,aACD,EACD,QACD;AACD,MAAI,IACF,QAAOC,mCAAU,MAAM,IAAI,MAAM,CAAC;UAE/B,KAAK;AAEV,EADYD,qCAAc,eAAe,CACrC,MAAM,oBAAoB,IAAI;;;;;;;;AAQtC,eAAsB,UACpB,KACA,eAAiC,EAAE,EACnC,UAAyE,OAC5C;AAC7B,KAAI;EACF,MAAM,MAAM,MAAM,WAChB,KACA;GAAC;GAAgB,EAAE,QAAQ,OAAO;GAAE;GAAa,EACjD,QACD;AACD,MAAI,IACF,QAAO,MAAM,IAAI,MAAM;UAEpB,KAAK;AAEV,EADYA,qCAAc,eAAe,CACrC,MAAM,oBAAoB,IAAI;;;;;;;AAUtC,SAAgB,2BACd,MACA,SAAqB,QACJ;AACjB,QAAO;EACL;EACA,GAAG;EACH,SAAS,EACP,gBAAgB,oDACjB;EACD,MAAME,oCAAY,KAAK;EACxB;;;;;;AAOH,SAAgB,iBACd,MACA,SAAqB,QACJ;AACjB,QAAO;EACL;EACA,GAAG;EACH,SAAS,EACP,gBAAgB,mCAEjB;EACD,MAAMC,2CAAkB,KAAK;EAC9B;;;;;;AAOH,SAAgB,sBACd,UACA,UACiB;AACjB,QAAO,EACL,SAAS,EACP,eAAe,SAASC,qBAAS,GAAG,SAAS,GAAG,WAAW,IAC5D,EACF"}

package/dist/common/network.d.cts

@@ -1,84 +1,2 @@
-import { Json } from './types.cjs';
-
-/**
- * Options for fetch requests.
- * @category Network
- */
-interface fetchOptionType {
-    /** Returns the cache mode associated with request, which is a string indicating how the request will interact with the browser's cache when fetching. */
-    cache?: RequestCache;
-    /** Returns the credentials mode associated with request, which is a string indicating whether credentials will be sent with the request always, never, or only when sent to a same-origin URL. */
-    credentials?: RequestCredentials;
-    /** Returns the kind of resource requested by request, e.g., "document" or "script". */
-    destination?: RequestDestination;
-    /** Returns a Headers object consisting of the headers associated with request. Note that headers added in the network layer by the user agent will not be accounted for in this object, e.g., the "Host" header. */
-    headers?: Record<string, string>;
-    /** Returns request's subresource integrity metadata, which is a cryptographic hash of the resource being fetched. Its value consists of multiple hashes separated by whitespace. [SRI] */
-    integrity?: string;
-    /** Returns a boolean indicating whether or not request can outlive the global in which it was created. */
-    keepalive?: boolean;
-    /** Returns request's HTTP method, which is "GET" by default. */
-    method?: string;
-    /** Returns the mode associated with request, which is a string indicating whether the request will use CORS, or will be restricted to same-origin URLs. */
-    mode?: RequestMode;
-    /** Returns the redirect mode associated with request, which is a string indicating how redirects for the request will be handled during fetching. A request will follow redirects by default. */
-    redirect?: RequestRedirect;
-    /** Returns the referrer of request. Its value can be a same-origin URL if explicitly set in init, the empty string to indicate no referrer, and "about:client" when defaulting to the global's default. This is used during fetching to determine the value of the `Referer` header of the request being made. */
-    referrer?: string;
-    /** Returns the referrer policy associated with request. This is used during fetching to compute the value of the request's referrer. */
-    referrerPolicy?: ReferrerPolicy;
-    /** Returns the signal associated with request, which is an AbortSignal object indicating whether or not request has been aborted, and its abort event handler. */
-    signal?: AbortSignal;
-    /** Returns the URL of request as a string. */
-    url?: string;
-    body?: any;
-}
-/**
- * Type for fetch options, can be a single option or an array of options.
- * @category Network
- */
-type fetchOptionsType = fetchOptionType | fetchOptionsType[];
-type httpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'HEAD' | 'CONNECT' | 'OPTIONS' | 'TRACE' | 'PATCH';
-declare function parseBasicAuth(url: string): {
-    url: string;
-    username: string;
-    password: string;
-} | undefined;
-/**
- * Simplified `fetch` wrapper.
- * - Accepts a single fetch options object or an array of options which will be deep-merged.
- * - Supports basic auth embedded in the URL (e.g. https://user:pass@host/path).
- * - Normalizes headers to a `Headers` instance.
- * - Returns the `Response` when status < 400, otherwise returns `undefined`.
- * @category Network
- */
-declare function fetchBasic(url: string | URL, fetchOptions?: fetchOptionsType, fetchFn?: (input: RequestInfo, init?: RequestInit) => Promise<Response>): Promise<Response | undefined>;
-/**
- * Fetch and parse JSON.
- * Returns the parsed JSON object or `undefined` on error.
- * @category Network
- */
-declare function fetchJson<T = Json>(url: string | URL, fetchOptions?: fetchOptionsType, fetchFn?: (input: RequestInfo, init?: RequestInit) => Promise<Response>): Promise<T | undefined>;
-/**
- * Fetch text content.
- * Returns the response text or `undefined` on error.
- * @category Network
- */
-declare function fetchText(url: string | URL, fetchOptions?: fetchOptionsType, fetchFn?: (input: RequestInfo, init?: RequestInit) => Promise<Response>): Promise<string | undefined>;
-/**
- * Options for `fetchBasic` to send data as application/x-www-form-urlencoded.
- * @category Network
- */
-declare function fetchOptionsFormURLEncoded(data: object, method?: httpMethod): fetchOptionType;
-/**
- * Options for `fetchBasic` to send JSON data.
- * @category Network
- */
-declare function fetchOptionsJson(data: object, method?: httpMethod): fetchOptionType;
-/**
- * Create options to add Basic Authorization header using given username/password.
- * @category Network
- */
-declare function fetchOptionsBasicAuth(username: string, password: string): fetchOptionType;
-
-export { fetchBasic, fetchJson, type fetchOptionType, fetchOptionsBasicAuth, fetchOptionsFormURLEncoded, fetchOptionsJson, type fetchOptionsType, fetchText, type httpMethod, parseBasicAuth };
+import { a as fetchOptionsFormURLEncoded, c as fetchText, i as fetchOptionsBasicAuth, l as httpMethod, n as fetchJson, o as fetchOptionsJson, r as fetchOptionType, s as fetchOptionsType, t as fetchBasic, u as parseBasicAuth } from "../network-B9L87z99.cjs";
+export { fetchBasic, fetchJson, fetchOptionType, fetchOptionsBasicAuth, fetchOptionsFormURLEncoded, fetchOptionsJson, fetchOptionsType, fetchText, httpMethod, parseBasicAuth };

package/dist/common/network.d.mts

@@ -0,0 +1,2 @@
+import { a as fetchOptionsFormURLEncoded, c as fetchText, i as fetchOptionsBasicAuth, l as httpMethod, n as fetchJson, o as fetchOptionsJson, r as fetchOptionType, s as fetchOptionsType, t as fetchBasic, u as parseBasicAuth } from "../network-BAUAZ5kG.mjs";
+export { fetchBasic, fetchJson, fetchOptionType, fetchOptionsBasicAuth, fetchOptionsFormURLEncoded, fetchOptionsJson, fetchOptionsType, fetchText, httpMethod, parseBasicAuth };