@snail-js/api 0.1.28 → 1.0.0

package/dist/chunks/download-lBC7oOTT.js

@@ -0,0 +1,160 @@
+//#region src/utils/emitter.ts
+/**
+* Minimal typed event emitter.
+*
+* Used for the `SnailMethod` event surface (`onSuccess`, `onError`, …). It is
+* deliberately tiny: no wildcard events, no `once`, no async scheduling.
+*/
+var Emitter = class {
+	constructor() {
+		this.listeners = /* @__PURE__ */ new Map();
+	}
+	/**
+	* Register a listener.
+	*
+	* @returns an unsubscribe function — the ergonomic alternative to keeping a
+	* reference around just to call {@link off}.
+	*/
+	on(type, listener) {
+		let set = this.listeners.get(type);
+		if (!set) {
+			set = /* @__PURE__ */ new Set();
+			this.listeners.set(type, set);
+		}
+		set.add(listener);
+		return () => this.off(type, listener);
+	}
+	/** Remove a previously registered listener. */
+	off(type, listener) {
+		this.listeners.get(type)?.delete(listener);
+	}
+	/** Number of listeners registered for `type`. */
+	count(type) {
+		return this.listeners.get(type)?.size ?? 0;
+	}
+	/**
+	* Invoke every listener for `type`.
+	*
+	* A throwing listener must not derail the request lifecycle: the promise from
+	* `send()` has already settled correctly, and one broken UI callback has no
+	* business turning a successful request into a failure. The other listeners for
+	* the same event still run.
+	*
+	* The error is therefore *reported*, not rethrown. Rethrowing from a microtask
+	* was the obvious alternative and is wrong: in Node it becomes an uncaught
+	* exception, so a throwing toast handler could take the process down.
+	*/
+	emit(type, payload) {
+		const set = this.listeners.get(type);
+		if (!set || set.size === 0) return;
+		for (const listener of [...set]) try {
+			listener(payload);
+		} catch (error) {
+			reportListenerError(type, error);
+		}
+	}
+	/** Drop every listener, optionally only for one event type. */
+	clear(type) {
+		if (type === void 0) {
+			this.listeners.clear();
+			return;
+		}
+		this.listeners.delete(type);
+	}
+};
+/**
+* Surface a listener's exception without letting it escape.
+*
+* `globalThis.reportError` is the HTML standard for exactly this situation —
+* asynchronous callback failure — and exists in every modern browser, where it
+* reaches `window.onerror` and devtools without unwinding anything. Node and
+* older runtimes get `console.error`.
+*
+* Swallowing it silently is deliberately not an option: hiding a developer's bug
+* is worse than a log line.
+*/
+function reportListenerError(type, error) {
+	const reporter = globalThis.reportError;
+	if (typeof reporter === "function") {
+		reporter(error);
+		return;
+	}
+	console.error(`[snail] a listener for "${String(type)}" threw`, error);
+}
+//#endregion
+//#region src/utils/download.ts
+/**
+* Navigate the browser to `url` as a download.
+*
+* Works for a same-origin path, a cross-origin absolute URL and a `blob:` object
+* URL alike. Throws when there is no DOM, because silently doing nothing is the
+* worst possible outcome for a function whose entire job is a side effect.
+*/
+function triggerDownload(url, options = {}) {
+	if (typeof document === "undefined") throw new ReferenceError("[snail] triggerDownload() needs a DOM. On a server, return the url to the client and let the browser fetch it, or write the bytes with node:fs.");
+	const anchor = document.createElement("a");
+	if (options.openInNewTab) {
+		anchor.target = "_blank";
+		anchor.rel = "noopener noreferrer";
+	} else if (options.filename) anchor.download = options.filename;
+	if (options.referrerPolicy) anchor.referrerPolicy = options.referrerPolicy;
+	anchor.href = url;
+	anchor.style.display = "none";
+	(options.container ?? document.body).appendChild(anchor);
+	try {
+		anchor.click();
+	} finally {
+		anchor.remove();
+	}
+	return {
+		url,
+		filename: options.filename
+	};
+}
+/**
+* Download an in-memory `Blob` by handing the browser an object URL.
+*
+* Use this only when the bytes are already in hand. The object URL is revoked on
+* the next macrotask rather than immediately: revoking it in the same tick races
+* the navigation in Safari and Firefox, and the download silently never starts.
+* The cost is a short-lived duplicate in memory, which is why {@link triggerDownload}
+* remains the recommended path.
+*/
+function triggerBlobDownload(blob, options = {}) {
+	if (typeof URL === "undefined" || typeof URL.createObjectURL !== "function") throw new ReferenceError("[snail] triggerBlobDownload() needs URL.createObjectURL, which this runtime does not provide");
+	const objectUrl = URL.createObjectURL(blob);
+	try {
+		return triggerDownload(objectUrl, options);
+	} finally {
+		setTimeout(() => URL.revokeObjectURL(objectUrl), 0);
+	}
+}
+/**
+* Build a filename from a `Content-Disposition` header.
+*
+* Servers send the header, not a JSON field, and parsing it is fiddlier than it
+* looks: `filename*` (RFC 5987, percent-encoded UTF-8) wins over `filename`, which
+* may itself be quoted. Returns `undefined` when the header is absent or names
+* nothing, so a caller can fall back to its own default instead of writing a
+* literal `"undefined"` to disk.
+*/
+function filenameFromDisposition(header) {
+	if (!header) return void 0;
+	const extended = /filename\*\s*=\s*([^;]+)/i.exec(header);
+	if (extended) {
+		const value = extended[1].trim();
+		const encoded = value.includes("''") ? value.slice(value.indexOf("''") + 2) : value;
+		try {
+			return decodeURIComponent(encoded.replace(/^["']|["']$/g, ""));
+		} catch {}
+	}
+	const plain = /filename\s*=\s*("([^"]*)"|([^;]+))/i.exec(header);
+	if (plain) {
+		const value = (plain[2] ?? plain[3] ?? "").trim();
+		if (value.length > 0) return value;
+	}
+}
+//#endregion
+export { Emitter as i, triggerBlobDownload as n, triggerDownload as r, filenameFromDisposition as t };
+
+//# sourceMappingURL=download-lBC7oOTT.js.map

package/dist/chunks/download-lBC7oOTT.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"download-lBC7oOTT.js","names":[],"sources":["../../src/utils/emitter.ts","../../src/utils/download.ts"],"sourcesContent":["/**\n * Minimal typed event emitter.\n *\n * Used for the `SnailMethod` event surface (`onSuccess`, `onError`, …). It is\n * deliberately tiny: no wildcard events, no `once`, no async scheduling.\n */\nexport class Emitter<Events extends Record<string, unknown>> {\n  private readonly listeners = new Map<keyof Events, Set<(payload: any) => void>>();\n\n  /**\n   * Register a listener.\n   *\n   * @returns an unsubscribe function — the ergonomic alternative to keeping a\n   * reference around just to call {@link off}.\n   */\n  on<K extends keyof Events>(\n    type: K,\n    listener: (payload: Events[K]) => void\n  ): () => void {\n    let set = this.listeners.get(type);\n    if (!set) {\n      set = new Set();\n      this.listeners.set(type, set);\n    }\n    set.add(listener);\n    return () => this.off(type, listener);\n  }\n\n  /** Remove a previously registered listener. */\n  off<K extends keyof Events>(type: K, listener: (payload: Events[K]) => void): void {\n    this.listeners.get(type)?.delete(listener);\n  }\n\n  /** Number of listeners registered for `type`. */\n  count<K extends keyof Events>(type: K): number {\n    return this.listeners.get(type)?.size ?? 0;\n  }\n\n  /**\n   * Invoke every listener for `type`.\n   *\n   * A throwing listener must not derail the request lifecycle: the promise from\n   * `send()` has already settled correctly, and one broken UI callback has no\n   * business turning a successful request into a failure. The other listeners for\n   * the same event still run.\n   *\n   * The error is therefore *reported*, not rethrown. Rethrowing from a microtask\n   * was the obvious alternative and is wrong: in Node it becomes an uncaught\n   * exception, so a throwing toast handler could take the process down.\n   */\n  emit<K extends keyof Events>(type: K, payload: Events[K]): void {\n    const set = this.listeners.get(type);\n    if (!set || set.size === 0) return;\n\n    for (const listener of [...set]) {\n      try {\n        listener(payload);\n      } catch (error) {\n        reportListenerError(type, error);\n      }\n    }\n  }\n\n  /** Drop every listener, optionally only for one event type. */\n  clear<K extends keyof Events>(type?: K): void {\n    if (type === undefined) {\n      this.listeners.clear();\n      return;\n    }\n    this.listeners.delete(type);\n  }\n}\n\n/**\n * Surface a listener's exception without letting it escape.\n *\n * `globalThis.reportError` is the HTML standard for exactly this situation —\n * asynchronous callback failure — and exists in every modern browser, where it\n * reaches `window.onerror` and devtools without unwinding anything. Node and\n * older runtimes get `console.error`.\n *\n * Swallowing it silently is deliberately not an option: hiding a developer's bug\n * is worse than a log line.\n */\nfunction reportListenerError(type: PropertyKey, error: unknown): void {\n  const reporter = (globalThis as { reportError?: (error: unknown) => void }).reportError;\n  if (typeof reporter === \"function\") {\n    reporter(error);\n    return;\n  }\n\n  console.error(`[snail] a listener for \"${String(type)}\" threw`, error);\n}\n","/**\n * Trigger a browser download from a URL, without ever holding the bytes.\n *\n * ## Why the library does not download for you\n *\n * The obvious design — `responseType: \"blob\"`, `await`, then an object URL — is\n * wrong for anything but a small file. It forces the whole payload through\n * JavaScript memory, so a 200 MB export becomes a 200 MB `Blob` plus a second copy\n * when the object URL is created, with no progress reporting and no way to resume.\n * On a slow connection the tab simply runs out of memory, and the user has no idea\n * whether anything is happening.\n *\n * The design that scales is the one every large site already uses: the server\n * mints a short-lived download URL, and the browser fetches it natively. That gives\n * you a real progress bar in the browser's own download manager, resume support,\n * streaming to disk instead of RAM, and a download that survives navigation. All\n * this library does is ask for the URL and then click a link.\n *\n * ```ts\n * @Api(\"/report\")\n * class ReportApi {\n *   /** Ask the server to prepare the export; it answers with a temp URL. *\\/\n *   @Post(\"/export\")\n *   create(@Data() query: ReportQuery): Promise<{ url: string; filename: string }> {\n *     return null!;\n *   }\n * }\n *\n * const { url, filename } = (await reportApi.create(query).send()).data;\n * triggerDownload(url, { filename });\n * ```\n *\n * ## When you genuinely need the blob\n *\n * If the response must be transformed, or the backend cannot issue a URL, request\n * `responseType: \"blob\"` and use {@link triggerBlobDownload} instead — it accepts\n * an already-materialised `Blob` and takes care of revoking the object URL.\n */\n\n/** Options accepted by {@link triggerDownload}. */\nexport interface TriggerDownloadOptions {\n  /**\n   * Filename to suggest to the browser.\n   *\n   * A cross-origin `href` ignores this — the browser honours the server's\n   * `Content-Disposition` instead, because letting a page rename a cross-origin\n   * download would be a security problem. For a cross-origin file, make the server\n   * send the name in that header.\n   */\n  filename?: string;\n\n  /** Open in a new tab instead of downloading. Defaults to `false`. */\n  openInNewTab?: boolean;\n\n  /**\n   * Where to attach the temporary anchor.\n   *\n   * Needed only for the old Firefox behaviour where an anchor that was never in the\n   * document ignores `click()`. Defaults to `document.body`.\n   */\n  container?: HTMLElement;\n\n  /** `referrerpolicy` for the navigation. */\n  referrerPolicy?: string;\n}\n\n/** Result of a successful {@link triggerDownload}. */\nexport interface TriggerDownloadResult {\n  /** The URL that was navigated to. */\n  url: string;\n\n  /** The filename the browser was asked to use, when one was supplied. */\n  filename: string | undefined;\n}\n\n/**\n * Navigate the browser to `url` as a download.\n *\n * Works for a same-origin path, a cross-origin absolute URL and a `blob:` object\n * URL alike. Throws when there is no DOM, because silently doing nothing is the\n * worst possible outcome for a function whose entire job is a side effect.\n */\nexport function triggerDownload(\n  url: string,\n  options: TriggerDownloadOptions = {}\n): TriggerDownloadResult {\n  if (typeof document === \"undefined\") {\n    throw new ReferenceError(\n      \"[snail] triggerDownload() needs a DOM. On a server, return the url to the \" +\n        \"client and let the browser fetch it, or write the bytes with node:fs.\"\n    );\n  }\n\n  const anchor = document.createElement(\"a\");\n\n  // `target=\"_blank\"` without `rel=\"noopener\"` hands the opened page a handle on\n  // this one through `window.opener`, which is a well known tabnabbing vector.\n  if (options.openInNewTab) {\n    anchor.target = \"_blank\";\n    anchor.rel = \"noopener noreferrer\";\n  } else if (options.filename) {\n    // `download` is what turns a navigation into a download. Setting it on a\n    // cross-origin URL is ignored by the browser (see the filename note above),\n    // which is why the server must send `Content-Disposition` in that case.\n    anchor.download = options.filename;\n  }\n\n  if (options.referrerPolicy) anchor.referrerPolicy = options.referrerPolicy;\n\n  anchor.href = url;\n  anchor.style.display = \"none\";\n\n  const container = options.container ?? document.body;\n  container.appendChild(anchor);\n\n  try {\n    anchor.click();\n  } finally {\n    // Always detached: a hidden anchor left in the DOM leaks for the lifetime of\n    // the page, and in a single-page app that is unbounded.\n    anchor.remove();\n  }\n\n  return { url, filename: options.filename };\n}\n\n/**\n * Download an in-memory `Blob` by handing the browser an object URL.\n *\n * Use this only when the bytes are already in hand. The object URL is revoked on\n * the next macrotask rather than immediately: revoking it in the same tick races\n * the navigation in Safari and Firefox, and the download silently never starts.\n * The cost is a short-lived duplicate in memory, which is why {@link triggerDownload}\n * remains the recommended path.\n */\nexport function triggerBlobDownload(\n  blob: Blob,\n  options: TriggerDownloadOptions = {}\n): TriggerDownloadResult {\n  if (typeof URL === \"undefined\" || typeof URL.createObjectURL !== \"function\") {\n    throw new ReferenceError(\n      \"[snail] triggerBlobDownload() needs URL.createObjectURL, which this runtime does not provide\"\n    );\n  }\n\n  const objectUrl = URL.createObjectURL(blob);\n\n  try {\n    return triggerDownload(objectUrl, options);\n  } finally {\n    setTimeout(() => URL.revokeObjectURL(objectUrl), 0);\n  }\n}\n\n/**\n * Build a filename from a `Content-Disposition` header.\n *\n * Servers send the header, not a JSON field, and parsing it is fiddlier than it\n * looks: `filename*` (RFC 5987, percent-encoded UTF-8) wins over `filename`, which\n * may itself be quoted. Returns `undefined` when the header is absent or names\n * nothing, so a caller can fall back to its own default instead of writing a\n * literal `\"undefined\"` to disk.\n */\nexport function filenameFromDisposition(header: string | undefined): string | undefined {\n  if (!header) return undefined;\n\n  const extended = /filename\\*\\s*=\\s*([^;]+)/i.exec(header);\n  if (extended) {\n    const value = extended[1]!.trim();\n    const encoded = value.includes(\"''\") ? value.slice(value.indexOf(\"''\") + 2) : value;\n    try {\n      return decodeURIComponent(encoded.replace(/^[\"']|[\"']$/g, \"\"));\n    } catch {\n      // A malformed escape is not worth failing a download over.\n    }\n  }\n\n  const plain = /filename\\s*=\\s*(\"([^\"]*)\"|([^;]+))/i.exec(header);\n  if (plain) {\n    const value = (plain[2] ?? plain[3] ?? \"\").trim();\n    if (value.length > 0) return value;\n  }\n\n  return undefined;\n}\n"],"mappings":"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"}

package/dist/chunks/object-Ct0w-h4i.js

@@ -0,0 +1,74 @@
+import { L as isPlainObject } from "./plugin-D3RDffDG.js";
+//#region src/utils/object.ts
+/** Return a copy of `source` without the listed keys. */
+function omit(source, keys) {
+	const result = { ...source };
+	for (const key of keys) delete result[key];
+	return result;
+}
+/** Return a copy of `source` containing only the listed keys. */
+function pick(source, keys) {
+	const result = {};
+	for (const key of keys) if (key in source) result[key] = source[key];
+	return result;
+}
+/** Drop keys whose value is `undefined`. `null` is preserved deliberately. */
+function omitUndefined(source) {
+	const result = {};
+	for (const [key, value] of Object.entries(source)) if (value !== void 0) result[key] = value;
+	return result;
+}
+/**
+* Recursively merge plain objects.
+*
+* Accepts **deeply partial** sources, so
+* `deepMerge({ a: { b: 1, c: 2 } }, { a: { c: 3 } })` type-checks without a cast —
+* which is the whole point of overriding one nested default.
+*
+* Arrays are replaced, not concatenated: concatenating them would make it
+* impossible for a method-level option to override a server-level list.
+*/
+function deepMerge(...sources) {
+	const result = {};
+	for (const source of sources) {
+		if (!isPlainObject(source)) continue;
+		for (const [key, value] of Object.entries(source)) {
+			const current = result[key];
+			if (isPlainObject(current) && isPlainObject(value)) result[key] = deepMerge(current, value);
+			else if (value !== void 0) result[key] = value;
+		}
+	}
+	return result;
+}
+/** Run `fn`, returning `fallback` if it throws. */
+function tryCatch(fn, fallback) {
+	try {
+		return fn();
+	} catch {
+		return fallback;
+	}
+}
+/**
+* Create a promise together with its resolve/reject handles.
+*
+* Used by strategies to hand a "ready" promise out before the underlying
+* request is actually started.
+*/
+function deferred() {
+	let resolve;
+	let reject;
+	return {
+		promise: new Promise((res, rej) => {
+			resolve = res;
+			reject = rej;
+		}),
+		resolve,
+		reject
+	};
+}
+/** A function that does nothing — used as a default callback. */
+function noop() {}
+//#endregion
+export { omitUndefined as a, omit as i, deferred as n, pick as o, noop as r, tryCatch as s, deepMerge as t };
+
+//# sourceMappingURL=object-Ct0w-h4i.js.map

package/dist/chunks/object-Ct0w-h4i.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"object-Ct0w-h4i.js","names":[],"sources":["../../src/utils/object.ts"],"sourcesContent":["import { isFunction, isPlainObject } from \"./is\";\n\n/** Return a copy of `source` without the listed keys. */\nexport function omit<T extends Record<string, any>, K extends keyof T>(\n  source: T,\n  keys: readonly K[]\n): Omit<T, K> {\n  const result = { ...source } as Record<string, any>;\n  for (const key of keys) delete result[key as string];\n  return result as Omit<T, K>;\n}\n\n/** Return a copy of `source` containing only the listed keys. */\nexport function pick<T extends Record<string, any>, K extends keyof T>(\n  source: T,\n  keys: readonly K[]\n): Pick<T, K> {\n  const result = {} as Record<string, any>;\n  for (const key of keys) {\n    if (key in source) result[key as string] = source[key];\n  }\n  return result as Pick<T, K>;\n}\n\n/** Drop keys whose value is `undefined`. `null` is preserved deliberately. */\nexport function omitUndefined<T extends Record<string, any>>(source: T): T {\n  const result = {} as Record<string, any>;\n  for (const [key, value] of Object.entries(source)) {\n    if (value !== undefined) result[key] = value;\n  }\n  return result as T;\n}\n\n/** A deeply optional version of `T`, for merge inputs. */\nexport type DeepPartial<T> = {\n  [K in keyof T]?: T[K] extends readonly unknown[]\n    ? T[K]\n    : T[K] extends object\n      ? DeepPartial<T[K]>\n      : T[K];\n};\n\n/**\n * Recursively merge plain objects.\n *\n * Accepts **deeply partial** sources, so\n * `deepMerge({ a: { b: 1, c: 2 } }, { a: { c: 3 } })` type-checks without a cast —\n * which is the whole point of overriding one nested default.\n *\n * Arrays are replaced, not concatenated: concatenating them would make it\n * impossible for a method-level option to override a server-level list.\n */\nexport function deepMerge<T extends Record<string, any>>(\n  ...sources: Array<DeepPartial<T> | undefined | null>\n): T {\n  const result: Record<string, any> = {};\n\n  for (const source of sources) {\n    if (!isPlainObject(source)) continue;\n    for (const [key, value] of Object.entries(source)) {\n      const current = result[key];\n      if (isPlainObject(current) && isPlainObject(value)) {\n        result[key] = deepMerge(current, value);\n      } else if (value !== undefined) {\n        result[key] = value;\n      }\n    }\n  }\n\n  return result as T;\n}\n\n/**\n * Resolve a possibly-functional option value.\n *\n * Options such as `@Header(...)` often need values computed per request, so most\n * option fields accept `T | ((ctx) => T)`.\n */\nexport function resolveValue<T, A>(value: T | ((arg: A) => T), arg: A): T {\n  return isFunction(value) ? (value as (arg: A) => T)(arg) : value;\n}\n\n/** Run `fn`, returning `fallback` if it throws. */\nexport function tryCatch<T>(fn: () => T, fallback: T): T {\n  try {\n    return fn();\n  } catch {\n    return fallback;\n  }\n}\n\n/**\n * Create a promise together with its resolve/reject handles.\n *\n * Used by strategies to hand a \"ready\" promise out before the underlying\n * request is actually started.\n */\nexport function deferred<T = void>(): {\n  promise: Promise<T>;\n  resolve: (value: T | PromiseLike<T>) => void;\n  reject: (reason?: unknown) => void;\n} {\n  let resolve!: (value: T | PromiseLike<T>) => void;\n  let reject!: (reason?: unknown) => void;\n  const promise = new Promise<T>((res, rej) => {\n    resolve = res;\n    reject = rej;\n  });\n  return { promise, resolve, reject };\n}\n\n/** A function that does nothing — used as a default callback. */\nexport function noop(): void {\n  /* intentionally empty */\n}\n"],"mappings":";;;AAGA,SAAgB,KACd,QACA,MACY;CACZ,MAAM,SAAS,EAAE,GAAG,OAAO;CAC3B,KAAK,MAAM,OAAO,MAAM,OAAO,OAAO;CACtC,OAAO;AACT;;AAGA,SAAgB,KACd,QACA,MACY;CACZ,MAAM,SAAS,CAAC;CAChB,KAAK,MAAM,OAAO,MAChB,IAAI,OAAO,QAAQ,OAAO,OAAiB,OAAO;CAEpD,OAAO;AACT;;AAGA,SAAgB,cAA6C,QAAc;CACzE,MAAM,SAAS,CAAC;CAChB,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAC9C,IAAI,UAAU,KAAA,GAAW,OAAO,OAAO;CAEzC,OAAO;AACT;;;;;;;;;;;AAqBA,SAAgB,UACd,GAAG,SACA;CACH,MAAM,SAA8B,CAAC;CAErC,KAAK,MAAM,UAAU,SAAS;EAC5B,IAAI,CAAC,cAAc,MAAM,GAAG;EAC5B,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,MAAM,GAAG;GACjD,MAAM,UAAU,OAAO;GACvB,IAAI,cAAc,OAAO,KAAK,cAAc,KAAK,GAC/C,OAAO,OAAO,UAAU,SAAS,KAAK;QACjC,IAAI,UAAU,KAAA,GACnB,OAAO,OAAO;EAElB;CACF;CAEA,OAAO;AACT;;AAaA,SAAgB,SAAY,IAAa,UAAgB;CACvD,IAAI;EACF,OAAO,GAAG;CACZ,QAAQ;EACN,OAAO;CACT;AACF;;;;;;;AAQA,SAAgB,WAId;CACA,IAAI;CACJ,IAAI;CAKJ,OAAO;EAAE,SAAA,IAJW,SAAY,KAAK,QAAQ;GAC3C,UAAU;GACV,SAAS;EACX,CACS;EAAS;EAAS;CAAO;AACpC;;AAGA,SAAgB,OAAa,CAE7B"}