@hexclave/shared 1.0.0

package/dist/esm/utils/errors.js

@@ -0,0 +1,385 @@
+import { pick } from "./objects.js";
+import { globalVar } from "./globals.js";
+import { nicify } from "./strings.js";
+
+//#region src/utils/errors.tsx
+function throwErr(...args) {
+	if (typeof args[0] === "string") throw new HexclaveAssertionError(args[0], args[1]);
+	else if (args[0] instanceof Error) throw args[0];
+	else throw new StatusError(...args);
+}
+function removeStacktraceNameLine(stack) {
+	const addsNameLine = (/* @__PURE__ */ new Error()).stack?.startsWith("Error\n");
+	return stack.split("\n").slice(addsNameLine ? 1 : 0).join("\n");
+}
+/**
+* Concatenates the (original) stacktraces of the given errors onto the first.
+*
+* Note: Very often, the concatStacktracesIfRejected function in promises.tsx is an easier way to use this function.
+*
+* Useful when you invoke an async function to receive a promise without awaiting it immediately. Browsers are smart
+* enough to keep track of the call stack in async function calls when you invoke `.then` within the same async tick,
+* but if you don't, the stacktrace will be lost.
+*
+* Here's an example of the unwanted behavior:
+*
+* ```tsx
+* async function log() {
+*   await wait(0);  // put the task on the event loop
+*   console.log(new Error().stack);
+* }
+*
+* async function main() {
+*   await log();  // good; prints both "log" and "main" on the stacktrace
+*   log();  // bad; prints only "log" on the stacktrace
+* }
+* ```
+*/
+function concatStacktraces(first, ...errors) {
+	const addsEmptyLineAtEnd = first.stack?.endsWith("\n");
+	const separator = removeStacktraceNameLine((/* @__PURE__ */ new Error()).stack ?? "").split("\n")[0];
+	for (const error of errors) {
+		const toAppend = removeStacktraceNameLine(error.stack ?? "");
+		first.stack += (addsEmptyLineAtEnd ? "" : "\n") + separator + "\n" + toAppend;
+	}
+}
+var HexclaveAssertionError = class extends Error {
+	constructor(message, extraData) {
+		const disclaimer = `\n\nThis is likely an error in Hexclave. Please make sure you are running the newest version and report it.`;
+		super(`${message}${message.endsWith(disclaimer) ? "" : disclaimer}`, pick(extraData ?? {}, ["cause"]));
+		this.extraData = extraData;
+		Object.defineProperty(this, "customCaptureExtraArgs", {
+			get() {
+				return [this.extraData];
+			},
+			enumerable: false
+		});
+		if ((typeof process !== "undefined" ? process.env.NEXT_PUBLIC_STACK_DEBUGGER_ON_ASSERTION_ERROR : void 0) === "true") debugger;
+	}
+};
+HexclaveAssertionError.prototype.name = "HexclaveAssertionError";
+function errorToNiceString(error) {
+	if (!(error instanceof Error)) return `${typeof error}<${nicify(error)}>`;
+	return nicify(error, { maxDepth: 8 });
+}
+const errorSinks = /* @__PURE__ */ new Set();
+function registerErrorSink(sink) {
+	if (errorSinks.has(sink)) return;
+	errorSinks.add(sink);
+}
+registerErrorSink((location, error, ...extraArgs) => {
+	console.error(`\x1b[41mCaptured error in ${location}:`, errorToNiceString(error), ...extraArgs, "\x1B[0m");
+});
+registerErrorSink((location, error, ...extraArgs) => {
+	globalVar.stackCapturedErrors = globalVar.stackCapturedErrors ?? [];
+	globalVar.stackCapturedErrors.push({
+		location,
+		error,
+		extraArgs
+	});
+});
+/**
+* Captures an error and sends it to the error sinks (most notably, Sentry). Errors caught with captureError are
+* supposed to be seen by an engineer, so they should be actionable and important.
+*
+* The location string is a machine-readable ID, and should hence not contain spaces or anything like that. Good
+* examples are: "api-route-handler", "renderPart()", etc.
+*
+* Errors that bubble up to the top of runAsynchronously or a route handler are already captured with captureError.
+*/
+function captureError(location, error) {
+	for (const sink of errorSinks) sink(location, error, ...error && (typeof error === "object" || typeof error === "function") && "customCaptureExtraArgs" in error && Array.isArray(error.customCaptureExtraArgs) ? error.customCaptureExtraArgs : []);
+}
+var StatusError = class extends Error {
+	static {
+		this.BadRequest = {
+			statusCode: 400,
+			message: "Bad Request"
+		};
+	}
+	static {
+		this.Unauthorized = {
+			statusCode: 401,
+			message: "Unauthorized"
+		};
+	}
+	static {
+		this.PaymentRequired = {
+			statusCode: 402,
+			message: "Payment Required"
+		};
+	}
+	static {
+		this.Forbidden = {
+			statusCode: 403,
+			message: "Forbidden"
+		};
+	}
+	static {
+		this.NotFound = {
+			statusCode: 404,
+			message: "Not Found"
+		};
+	}
+	static {
+		this.MethodNotAllowed = {
+			statusCode: 405,
+			message: "Method Not Allowed"
+		};
+	}
+	static {
+		this.NotAcceptable = {
+			statusCode: 406,
+			message: "Not Acceptable"
+		};
+	}
+	static {
+		this.ProxyAuthenticationRequired = {
+			statusCode: 407,
+			message: "Proxy Authentication Required"
+		};
+	}
+	static {
+		this.RequestTimeout = {
+			statusCode: 408,
+			message: "Request Timeout"
+		};
+	}
+	static {
+		this.Conflict = {
+			statusCode: 409,
+			message: "Conflict"
+		};
+	}
+	static {
+		this.Gone = {
+			statusCode: 410,
+			message: "Gone"
+		};
+	}
+	static {
+		this.LengthRequired = {
+			statusCode: 411,
+			message: "Length Required"
+		};
+	}
+	static {
+		this.PreconditionFailed = {
+			statusCode: 412,
+			message: "Precondition Failed"
+		};
+	}
+	static {
+		this.PayloadTooLarge = {
+			statusCode: 413,
+			message: "Payload Too Large"
+		};
+	}
+	static {
+		this.URITooLong = {
+			statusCode: 414,
+			message: "URI Too Long"
+		};
+	}
+	static {
+		this.UnsupportedMediaType = {
+			statusCode: 415,
+			message: "Unsupported Media Type"
+		};
+	}
+	static {
+		this.RangeNotSatisfiable = {
+			statusCode: 416,
+			message: "Range Not Satisfiable"
+		};
+	}
+	static {
+		this.ExpectationFailed = {
+			statusCode: 417,
+			message: "Expectation Failed"
+		};
+	}
+	static {
+		this.ImATeapot = {
+			statusCode: 418,
+			message: "I'm a teapot"
+		};
+	}
+	static {
+		this.MisdirectedRequest = {
+			statusCode: 421,
+			message: "Misdirected Request"
+		};
+	}
+	static {
+		this.UnprocessableEntity = {
+			statusCode: 422,
+			message: "Unprocessable Entity"
+		};
+	}
+	static {
+		this.Locked = {
+			statusCode: 423,
+			message: "Locked"
+		};
+	}
+	static {
+		this.FailedDependency = {
+			statusCode: 424,
+			message: "Failed Dependency"
+		};
+	}
+	static {
+		this.TooEarly = {
+			statusCode: 425,
+			message: "Too Early"
+		};
+	}
+	static {
+		this.UpgradeRequired = {
+			statusCode: 426,
+			message: "Upgrade Required"
+		};
+	}
+	static {
+		this.PreconditionRequired = {
+			statusCode: 428,
+			message: "Precondition Required"
+		};
+	}
+	static {
+		this.TooManyRequests = {
+			statusCode: 429,
+			message: "Too Many Requests"
+		};
+	}
+	static {
+		this.RequestHeaderFieldsTooLarge = {
+			statusCode: 431,
+			message: "Request Header Fields Too Large"
+		};
+	}
+	static {
+		this.UnavailableForLegalReasons = {
+			statusCode: 451,
+			message: "Unavailable For Legal Reasons"
+		};
+	}
+	static {
+		this.InternalServerError = {
+			statusCode: 500,
+			message: "Internal Server Error"
+		};
+	}
+	static {
+		this.NotImplemented = {
+			statusCode: 501,
+			message: "Not Implemented"
+		};
+	}
+	static {
+		this.BadGateway = {
+			statusCode: 502,
+			message: "Bad Gateway"
+		};
+	}
+	static {
+		this.ServiceUnavailable = {
+			statusCode: 503,
+			message: "Service Unavailable"
+		};
+	}
+	static {
+		this.GatewayTimeout = {
+			statusCode: 504,
+			message: "Gateway Timeout"
+		};
+	}
+	static {
+		this.HTTPVersionNotSupported = {
+			statusCode: 505,
+			message: "HTTP Version Not Supported"
+		};
+	}
+	static {
+		this.VariantAlsoNegotiates = {
+			statusCode: 506,
+			message: "Variant Also Negotiates"
+		};
+	}
+	static {
+		this.InsufficientStorage = {
+			statusCode: 507,
+			message: "Insufficient Storage"
+		};
+	}
+	static {
+		this.LoopDetected = {
+			statusCode: 508,
+			message: "Loop Detected"
+		};
+	}
+	static {
+		this.NotExtended = {
+			statusCode: 510,
+			message: "Not Extended"
+		};
+	}
+	static {
+		this.NetworkAuthenticationRequired = {
+			statusCode: 511,
+			message: "Network Authentication Required"
+		};
+	}
+	constructor(status, message) {
+		if (typeof status === "object") {
+			message ??= status.message;
+			status = status.statusCode;
+		}
+		super(message);
+		this.__stackStatusErrorBrand = "stack-status-error-brand-sentinel";
+		this.name = "StatusError";
+		this.statusCode = status;
+		if (!message) throw new HexclaveAssertionError("StatusError always requires a message unless a Status object is passed", { cause: this });
+	}
+	static isStatusError(error) {
+		return typeof error === "object" && error !== null && "__stackStatusErrorBrand" in error && error.__stackStatusErrorBrand === "stack-status-error-brand-sentinel";
+	}
+	isClientError() {
+		return this.statusCode >= 400 && this.statusCode < 500;
+	}
+	isServerError() {
+		return !this.isClientError();
+	}
+	getStatusCode() {
+		return this.statusCode;
+	}
+	getBody() {
+		return new TextEncoder().encode(this.message);
+	}
+	getHeaders() {
+		return { "Content-Type": ["text/plain; charset=utf-8"] };
+	}
+	toDescriptiveJson() {
+		return {
+			status_code: this.getStatusCode(),
+			message: this.message,
+			headers: this.getHeaders()
+		};
+	}
+	/**
+	* @deprecated this is not a good way to make status errors human-readable, use toDescriptiveJson instead
+	*/
+	toHttpJson() {
+		return {
+			status_code: this.statusCode,
+			body: this.message,
+			headers: this.getHeaders()
+		};
+	}
+};
+StatusError.prototype.name = "StatusError";
+
+//#endregion
+export { HexclaveAssertionError, StatusError, captureError, concatStacktraces, errorToNiceString, registerErrorSink, throwErr };
+//# sourceMappingURL=errors.js.map

package/dist/esm/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","names":[],"sources":["../../../src/utils/errors.tsx"],"sourcesContent":["import { globalVar } from \"./globals\";\nimport { Json } from \"./json\";\nimport { pick } from \"./objects\";\nimport { nicify } from \"./strings\";\n\n\nexport function throwErr(errorMessage: string, extraData?: any): never;\nexport function throwErr(error: Error): never;\nexport function throwErr(...args: StatusErrorConstructorParameters): never;\nexport function throwErr(...args: any[]): never {\n  if (typeof args[0] === \"string\") {\n    throw new HexclaveAssertionError(args[0], args[1]);\n  } else if (args[0] instanceof Error) {\n    throw args[0];\n  } else {\n    // @ts-expect-error\n    throw new StatusError(...args);\n  }\n}\n\nfunction removeStacktraceNameLine(stack: string): string {\n  // some browsers (eg. Chrome) prepend the stack with an extra line with the error name\n  const addsNameLine = new Error().stack?.startsWith(\"Error\\n\");\n  return stack.split(\"\\n\").slice(addsNameLine ? 1 : 0).join(\"\\n\");\n}\n\n\n/**\n * Concatenates the (original) stacktraces of the given errors onto the first.\n *\n * Note: Very often, the concatStacktracesIfRejected function in promises.tsx is an easier way to use this function.\n *\n * Useful when you invoke an async function to receive a promise without awaiting it immediately. Browsers are smart\n * enough to keep track of the call stack in async function calls when you invoke `.then` within the same async tick,\n * but if you don't, the stacktrace will be lost.\n *\n * Here's an example of the unwanted behavior:\n *\n * ```tsx\n * async function log() {\n *   await wait(0);  // put the task on the event loop\n *   console.log(new Error().stack);\n * }\n *\n * async function main() {\n *   await log();  // good; prints both \"log\" and \"main\" on the stacktrace\n *   log();  // bad; prints only \"log\" on the stacktrace\n * }\n * ```\n */\nexport function concatStacktraces(first: Error, ...errors: Error[]): void {\n  // some browsers (eg. Firefox) add an extra empty line at the end\n  const addsEmptyLineAtEnd = first.stack?.endsWith(\"\\n\");\n\n\n  // Add a reference to this function itself so that we know that stacktraces were concatenated\n  // If you are coming here from a stacktrace, please know that the two parts before and after this line are different\n  // stacktraces that were concatenated with concatStacktraces\n  const separator = removeStacktraceNameLine(new Error().stack ?? \"\").split(\"\\n\")[0];\n\n\n  for (const error of errors) {\n    const toAppend = removeStacktraceNameLine(error.stack ?? \"\");\n    first.stack += (addsEmptyLineAtEnd ? \"\" : \"\\n\") + separator + \"\\n\" + toAppend;\n  }\n}\n\n\nexport class HexclaveAssertionError extends Error {\n  constructor(message: string, public readonly extraData?: Record<string, any> & ErrorOptions) {\n    const disclaimer = `\\n\\nThis is likely an error in Hexclave. Please make sure you are running the newest version and report it.`;\n    super(`${message}${message.endsWith(disclaimer) ? \"\" : disclaimer}`, pick(extraData ?? {}, [\"cause\"]));\n\n    Object.defineProperty(this, \"customCaptureExtraArgs\", {\n      get() {\n        return [this.extraData];\n      },\n      enumerable: false,\n    });\n\n    // Use literal dot-form (guarded with `typeof process`) so Next.js / webpack\n    // DefinePlugin can inline the value at build time. See getProcessEnv in ./env.\n    if ((typeof process !== \"undefined\" ? process.env.NEXT_PUBLIC_STACK_DEBUGGER_ON_ASSERTION_ERROR : undefined) === \"true\") {\n      debugger;\n    }\n  }\n}\nHexclaveAssertionError.prototype.name = \"HexclaveAssertionError\";\n\n\nexport function errorToNiceString(error: unknown): string {\n  if (!(error instanceof Error)) return `${typeof error}<${nicify(error)}>`;\n  return nicify(error, { maxDepth: 8 });\n}\n\n\nconst errorSinks = new Set<(location: string, error: unknown, ...extraArgs: unknown[]) => void>();\nexport function registerErrorSink(sink: (location: string, error: unknown) => void): void {\n  if (errorSinks.has(sink)) {\n    return;\n  }\n  errorSinks.add(sink);\n}\nregisterErrorSink((location, error, ...extraArgs) => {\n  console.error(\n    `\\x1b[41mCaptured error in ${location}:`,\n    // HACK: Log a nicified version of the error to get around buggy Next.js pretty-printing\n    // https://www.reddit.com/r/nextjs/comments/1gkxdqe/comment/m19kxgn/?utm_source=share&utm_medium=web3x&utm_name=web3xcss&utm_term=1&utm_content=share_button\n    errorToNiceString(error),\n    ...extraArgs,\n    \"\\x1b[0m\",\n  );\n});\nregisterErrorSink((location, error, ...extraArgs) => {\n  globalVar.stackCapturedErrors = globalVar.stackCapturedErrors ?? [];\n  globalVar.stackCapturedErrors.push({ location, error, extraArgs });\n});\n\n/**\n * Captures an error and sends it to the error sinks (most notably, Sentry). Errors caught with captureError are\n * supposed to be seen by an engineer, so they should be actionable and important.\n *\n * The location string is a machine-readable ID, and should hence not contain spaces or anything like that. Good\n * examples are: \"api-route-handler\", \"renderPart()\", etc.\n *\n * Errors that bubble up to the top of runAsynchronously or a route handler are already captured with captureError.\n */\nexport function captureError(location: string, error: unknown): void {\n  for (const sink of errorSinks) {\n    sink(\n      location,\n      error,\n      ...error && (typeof error === 'object' || typeof error === 'function') && \"customCaptureExtraArgs\" in error && Array.isArray(error.customCaptureExtraArgs) ? (error.customCaptureExtraArgs as any[]) : [],\n    );\n  }\n}\n\n\ntype Status = {\n  statusCode: number,\n  message: string,\n};\n\ntype StatusErrorConstructorParameters =\n| [\n  status: Status,\n  message?: string\n]\n| [\n  statusCode: number | Status,\n  message: string,\n];\n\nexport class StatusError extends Error {\n  private readonly __stackStatusErrorBrand = \"stack-status-error-brand-sentinel\" as const;\n  public name = \"StatusError\";\n  public readonly statusCode: number;\n\n  public static BadRequest = { statusCode: 400, message: \"Bad Request\" };\n  public static Unauthorized = { statusCode: 401, message: \"Unauthorized\" };\n  public static PaymentRequired = { statusCode: 402, message: \"Payment Required\" };\n  public static Forbidden = { statusCode: 403, message: \"Forbidden\" };\n  public static NotFound = { statusCode: 404, message: \"Not Found\" };\n  public static MethodNotAllowed = { statusCode: 405, message: \"Method Not Allowed\" };\n  public static NotAcceptable = { statusCode: 406, message: \"Not Acceptable\" };\n  public static ProxyAuthenticationRequired = { statusCode: 407, message: \"Proxy Authentication Required\" };\n  public static RequestTimeout = { statusCode: 408, message: \"Request Timeout\" };\n  public static Conflict = { statusCode: 409, message: \"Conflict\" };\n  public static Gone = { statusCode: 410, message: \"Gone\" };\n  public static LengthRequired = { statusCode: 411, message: \"Length Required\" };\n  public static PreconditionFailed = { statusCode: 412, message: \"Precondition Failed\" };\n  public static PayloadTooLarge = { statusCode: 413, message: \"Payload Too Large\" };\n  public static URITooLong = { statusCode: 414, message: \"URI Too Long\" };\n  public static UnsupportedMediaType = { statusCode: 415, message: \"Unsupported Media Type\" };\n  public static RangeNotSatisfiable = { statusCode: 416, message: \"Range Not Satisfiable\" };\n  public static ExpectationFailed = { statusCode: 417, message: \"Expectation Failed\" };\n  public static ImATeapot = { statusCode: 418, message: \"I'm a teapot\" };\n  public static MisdirectedRequest = { statusCode: 421, message: \"Misdirected Request\" };\n  public static UnprocessableEntity = { statusCode: 422, message: \"Unprocessable Entity\" };\n  public static Locked = { statusCode: 423, message: \"Locked\" };\n  public static FailedDependency = { statusCode: 424, message: \"Failed Dependency\" };\n  public static TooEarly = { statusCode: 425, message: \"Too Early\" };\n  public static UpgradeRequired = { statusCode: 426, message: \"Upgrade Required\" };\n  public static PreconditionRequired = { statusCode: 428, message: \"Precondition Required\" };\n  public static TooManyRequests = { statusCode: 429, message: \"Too Many Requests\" };\n  public static RequestHeaderFieldsTooLarge = { statusCode: 431, message: \"Request Header Fields Too Large\" };\n  public static UnavailableForLegalReasons = { statusCode: 451, message: \"Unavailable For Legal Reasons\" };\n\n  public static InternalServerError = { statusCode: 500, message: \"Internal Server Error\" };\n  public static NotImplemented = { statusCode: 501, message: \"Not Implemented\" };\n  public static BadGateway = { statusCode: 502, message: \"Bad Gateway\" };\n  public static ServiceUnavailable = { statusCode: 503, message: \"Service Unavailable\" };\n  public static GatewayTimeout = { statusCode: 504, message: \"Gateway Timeout\" };\n  public static HTTPVersionNotSupported = { statusCode: 505, message: \"HTTP Version Not Supported\" };\n  public static VariantAlsoNegotiates = { statusCode: 506, message: \"Variant Also Negotiates\" };\n  public static InsufficientStorage = { statusCode: 507, message: \"Insufficient Storage\" };\n  public static LoopDetected = { statusCode: 508, message: \"Loop Detected\" };\n  public static NotExtended = { statusCode: 510, message: \"Not Extended\" };\n  public static NetworkAuthenticationRequired = { statusCode: 511, message: \"Network Authentication Required\" };\n\n\n  constructor(...args: StatusErrorConstructorParameters);\n  constructor(\n    status: number | Status,\n    message?: string,\n  ) {\n    if (typeof status === \"object\") {\n      message ??= status.message;\n      status = status.statusCode;\n    }\n    super(message);\n    this.statusCode = status;\n    if (!message) {\n      throw new HexclaveAssertionError(\"StatusError always requires a message unless a Status object is passed\", { cause: this });\n    }\n  }\n\n  public static isStatusError(error: unknown): error is StatusError {\n    // like instanceof, but also works for errors thrown in other realms or by different versions of the same package\n    return typeof error === \"object\" && error !== null && \"__stackStatusErrorBrand\" in error && error.__stackStatusErrorBrand === \"stack-status-error-brand-sentinel\";\n  }\n\n  public isClientError() {\n    return this.statusCode >= 400 && this.statusCode < 500;\n  }\n\n  public isServerError() {\n    return !this.isClientError();\n  }\n\n  public getStatusCode(): number {\n    return this.statusCode;\n  }\n\n  public getBody(): Uint8Array {\n    return new TextEncoder().encode(this.message);\n  }\n\n  public getHeaders(): Record<string, string[]> {\n    return {\n      \"Content-Type\": [\"text/plain; charset=utf-8\"],\n    };\n  }\n\n  public toDescriptiveJson(): Json {\n    return {\n      status_code: this.getStatusCode(),\n      message: this.message,\n      headers: this.getHeaders(),\n    };\n  }\n\n  /**\n   * @deprecated this is not a good way to make status errors human-readable, use toDescriptiveJson instead\n   */\n  public toHttpJson(): Json {\n    return {\n      status_code: this.statusCode,\n      body: this.message,\n      headers: this.getHeaders(),\n    };\n  }\n}\nStatusError.prototype.name = \"StatusError\";\n"],"mappings":"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"}

package/dist/esm/utils/esbuild.d.ts

@@ -0,0 +1,16 @@
+import { Result } from "./results";
+
+//#region src/utils/esbuild.d.ts
+declare function initializeEsbuild(): Promise<void>;
+declare function bundleJavaScript(sourceFiles: Record<string, string> & {
+  '/entry.js': string;
+}, options?: {
+  format?: 'iife' | 'esm' | 'cjs';
+  externalPackages?: Record<string, string>;
+  keepAsImports?: string[];
+  sourcemap?: false | 'inline';
+  allowHttpImports?: boolean;
+}): Promise<Result<string, string>>;
+//#endregion
+export { bundleJavaScript, initializeEsbuild };
+//# sourceMappingURL=esbuild.d.ts.map

package/dist/esm/utils/esbuild.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.d.ts","names":[],"sources":["../../../src/utils/esbuild.tsx"],"mappings":";;;iBA2BgB,iBAAA,CAAA,GAAqB,OAAA;AAAA,iBAgDf,gBAAA,CAAiB,WAAA,EAAa,MAAA;EAA2B,WAAA;AAAA,GAAuB,OAAA;EACpG,MAAA;EACA,gBAAA,GAAmB,MAAA;EACnB,aAAA;EACA,SAAA;EACA,gBAAA;AAAA,IACO,OAAA,CAAQ,MAAA"}

package/dist/esm/utils/esbuild.js

@@ -0,0 +1,182 @@
+import { join } from "path";
+import { HexclaveAssertionError, captureError, throwErr } from "./errors.js";
+import { getProcessEnv, isBrowserLike } from "./env.js";
+import { ignoreUnhandledRejection, runAsynchronously } from "./promises.js";
+import { createGlobalAsync } from "./globals.js";
+import { Result } from "./results.js";
+import * as esbuild from "esbuild-wasm/lib/browser.js";
+import { traceSpan, withTraceSpan } from "./telemetry.js";
+
+//#region src/utils/esbuild.tsx
+globalThis.self ??= globalThis;
+let esbuildInitializePromise = null;
+if (typeof process !== "undefined" && typeof process.exit === "function" && getProcessEnv("NODE_ENV") === "development") runAsynchronously(async () => {
+	try {
+		await initializeEsbuild();
+	} catch (e) {
+		captureError("initialize-esbuild-in-dev", e);
+		globalThis.process?.exit?.(1);
+	}
+});
+function initializeEsbuild() {
+	const esbuildWasmUrl = `https://unpkg.com/esbuild-wasm@${esbuild.version}/esbuild.wasm`;
+	if (esbuildInitializePromise == null) {
+		esbuildInitializePromise = withTraceSpan("initializeEsbuild", async () => {
+			try {
+				let initOptions;
+				if (isBrowserLike()) initOptions = { wasmURL: esbuildWasmUrl };
+				else initOptions = {
+					wasmModule: await createGlobalAsync("esbuildWasmModule", async () => {
+						const esbuildWasmResponse = await fetch(esbuildWasmUrl);
+						if (!esbuildWasmResponse.ok) throw new HexclaveAssertionError(`Failed to fetch esbuild.wasm: ${esbuildWasmResponse.status} ${esbuildWasmResponse.statusText}: ${await esbuildWasmResponse.text()}`);
+						const esbuildWasm = await esbuildWasmResponse.arrayBuffer();
+						const esbuildWasmArray = new Uint8Array(esbuildWasm);
+						if (esbuildWasmArray[0] !== 0 || esbuildWasmArray[1] !== 97 || esbuildWasmArray[2] !== 115 || esbuildWasmArray[3] !== 109) throw new HexclaveAssertionError(`Invalid esbuild.wasm file: ${new TextDecoder().decode(esbuildWasmArray)}`);
+						return new WebAssembly.Module(esbuildWasm);
+					}),
+					worker: false
+				};
+				try {
+					await esbuild.initialize(initOptions);
+				} catch (e) {
+					if (e instanceof Error && e.message === "Cannot call \"initialize\" more than once") {} else throw e;
+				}
+			} catch (e) {
+				esbuildInitializePromise = null;
+				throw new HexclaveAssertionError("Failed to initialize ESBuild", { cause: e });
+			}
+		})();
+		ignoreUnhandledRejection(esbuildInitializePromise);
+	}
+	return esbuildInitializePromise;
+}
+async function bundleJavaScript(sourceFiles, options = {}) {
+	await initializeEsbuild();
+	const sourceFilesMap = new Map(Object.entries(sourceFiles));
+	const externalPackagesMap = new Map(Object.entries(options.externalPackages ?? {}));
+	const keepAsImports = options.keepAsImports ?? [];
+	const httpImportCache = /* @__PURE__ */ new Map();
+	const extToLoader = new Map([
+		["tsx", "tsx"],
+		["ts", "ts"],
+		["js", "js"],
+		["jsx", "jsx"],
+		["json", "json"],
+		["css", "css"]
+	]);
+	let result;
+	try {
+		result = await traceSpan("bundleJavaScript", async () => await esbuild.build({
+			entryPoints: ["/entry.js"],
+			bundle: true,
+			write: false,
+			format: options.format ?? "iife",
+			platform: "browser",
+			target: "es2015",
+			jsx: "automatic",
+			sourcemap: options.sourcemap ?? "inline",
+			external: keepAsImports,
+			plugins: [
+				...options.allowHttpImports ? [{
+					name: "esm-sh-only",
+					setup(build) {
+						build.onResolve({ filter: /.*/ }, (args) => {
+							const isHttp = args.path.startsWith("http://") || args.path.startsWith("https://");
+							const fromEsmNs = args.namespace === "esm-sh";
+							if (!isHttp && !fromEsmNs) return null;
+							const url = new URL(args.path, fromEsmNs ? args.importer : void 0);
+							if (url.protocol !== "https:" || url.host !== "esm.sh") throw new Error(`Blocked non-esm.sh URL import: ${url.href}`);
+							return {
+								path: url.href,
+								namespace: "esm-sh"
+							};
+						});
+						build.onLoad({
+							filter: /.*/,
+							namespace: "esm-sh"
+						}, async (args) => {
+							if (httpImportCache.has(args.path)) return httpImportCache.get(args.path);
+							const res = await fetch(args.path, { redirect: "follow" });
+							if (!res.ok) throw new Error(`Fetch ${res.status} ${res.statusText} for ${args.path}`);
+							const finalUrl = new URL(res.url);
+							if (finalUrl.host !== "esm.sh") throw new Error(`Redirect escaped esm.sh: ${finalUrl.href}`);
+							const ct = (res.headers.get("content-type") || "").toLowerCase();
+							let loader = ct.includes("css") ? "css" : ct.includes("json") ? "json" : ct.includes("typescript") ? "ts" : ct.includes("jsx") ? "jsx" : ct.includes("tsx") ? "tsx" : "js";
+							const p = finalUrl.pathname;
+							if (p.endsWith(".css")) loader = "css";
+							else if (p.endsWith(".json")) loader = "json";
+							else if (p.endsWith(".ts")) loader = "ts";
+							else if (p.endsWith(".tsx")) loader = "tsx";
+							else if (p.endsWith(".jsx")) loader = "jsx";
+							const result = {
+								contents: await res.text(),
+								loader,
+								resolveDir: new URL(".", finalUrl.href).toString(),
+								watchFiles: [finalUrl.href]
+							};
+							httpImportCache.set(args.path, result);
+							return result;
+						});
+					}
+				}] : [],
+				{
+					name: "replace-packages-with-globals",
+					setup(build) {
+						build.onResolve({ filter: /.*/ }, (args) => {
+							if (keepAsImports.includes(args.path)) return;
+							if (externalPackagesMap.has(args.path)) return {
+								path: args.path,
+								namespace: "package-shim"
+							};
+						});
+						build.onLoad({
+							filter: /.*/,
+							namespace: "package-shim"
+						}, (args) => {
+							const contents = externalPackagesMap.get(args.path);
+							if (contents == null) throw new HexclaveAssertionError(`esbuild requested file ${args.path} that is not in the virtual file system`);
+							return {
+								contents,
+								loader: "ts"
+							};
+						});
+					}
+				},
+				{
+					name: "virtual-fs",
+					setup(build) {
+						build.onResolve({ filter: /.*/ }, (args) => {
+							const absolutePath = join("/", args.path);
+							if (sourceFilesMap.has(absolutePath)) return {
+								path: absolutePath,
+								namespace: "virtual"
+							};
+						});
+						build.onLoad({
+							filter: /.*/,
+							namespace: "virtual"
+						}, (args) => {
+							const contents = sourceFilesMap.get(args.path);
+							if (contents == null) throw new HexclaveAssertionError(`esbuild requested file ${args.path} that is not in the virtual file system`);
+							const ext = args.path.split(".").pop() ?? "";
+							return {
+								contents,
+								loader: extToLoader.get(ext) ?? throwErr(`esbuild requested file ${args.path} with unknown extension ${ext}`)
+							};
+						});
+					}
+				}
+			]
+		}));
+	} catch (e) {
+		if (e instanceof Error && e.message.startsWith("Build failed with ")) return Result.error(e.message);
+		throw e;
+	}
+	if (result.errors.length > 0) return Result.error(result.errors.map((e) => e.text).join("\n"));
+	if (result.outputFiles.length > 0) return Result.ok(result.outputFiles[0].text);
+	return throwErr("No output generated??");
+}
+
+//#endregion
+export { bundleJavaScript, initializeEsbuild };
+//# sourceMappingURL=esbuild.js.map

package/dist/esm/utils/esbuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"esbuild.js","names":[],"sources":["../../../src/utils/esbuild.tsx"],"sourcesContent":["import * as esbuild from 'esbuild-wasm/lib/browser.js';\nimport { join } from 'path';\nimport { getProcessEnv, isBrowserLike } from './env';\nimport { captureError, HexclaveAssertionError, throwErr } from \"./errors\";\nimport { createGlobalAsync } from './globals';\nimport { ignoreUnhandledRejection, runAsynchronously } from './promises';\nimport { Result } from \"./results\";\nimport { traceSpan, withTraceSpan } from './telemetry';\n\n\n// esbuild requires self property to be set, and it is not set by default in nodejs\n(globalThis.self as any) ??= globalThis as any;\n\nlet esbuildInitializePromise: Promise<void> | null = null;\n\nif (typeof process !== \"undefined\" && typeof process.exit === \"function\" && getProcessEnv(\"NODE_ENV\") === 'development') {\n  // On development Node.js servers, initialize ESBuild as soon as the module is imported so we have to wait less on the first request\n  runAsynchronously(async () => {\n    try {\n      await initializeEsbuild();\n    } catch (e) {\n      captureError(\"initialize-esbuild-in-dev\", e);\n      (globalThis as any).process?.exit?.(1);\n    }\n  });\n}\n\nexport function initializeEsbuild(): Promise<void> {\n  const esbuildWasmUrl = `https://unpkg.com/esbuild-wasm@${esbuild.version}/esbuild.wasm`;\n  if (esbuildInitializePromise == null) {\n    esbuildInitializePromise = withTraceSpan('initializeEsbuild', async () => {\n      try {\n        let initOptions;\n        if (isBrowserLike()) {\n          initOptions = {\n            wasmURL: esbuildWasmUrl,\n          };\n        } else {\n          const esbuildWasmModule = await createGlobalAsync('esbuildWasmModule', async () => {\n            const esbuildWasmResponse = await fetch(esbuildWasmUrl);\n            if (!esbuildWasmResponse.ok) {\n              throw new HexclaveAssertionError(`Failed to fetch esbuild.wasm: ${esbuildWasmResponse.status} ${esbuildWasmResponse.statusText}: ${await esbuildWasmResponse.text()}`);\n            }\n            const esbuildWasm = await esbuildWasmResponse.arrayBuffer();\n            const esbuildWasmArray = new Uint8Array(esbuildWasm);\n            if (esbuildWasmArray[0] !== 0x00 || esbuildWasmArray[1] !== 0x61 || esbuildWasmArray[2] !== 0x73 || esbuildWasmArray[3] !== 0x6d) {\n              throw new HexclaveAssertionError(`Invalid esbuild.wasm file: ${new TextDecoder().decode(esbuildWasmArray)}`);\n            }\n            return new WebAssembly.Module(esbuildWasm);\n          });\n          initOptions = {\n            wasmModule: esbuildWasmModule,\n            worker: false,\n          };\n        }\n        try {\n          await esbuild.initialize(initOptions);\n        } catch (e) {\n          if (e instanceof Error && e.message === 'Cannot call \"initialize\" more than once') {\n            // this happens especially in local development, just ignore\n          } else {\n            throw e;\n          }\n        }\n      } catch (e) {\n        esbuildInitializePromise = null;\n        throw new HexclaveAssertionError(\"Failed to initialize ESBuild\", { cause: e });\n      }\n    })();\n    ignoreUnhandledRejection(esbuildInitializePromise);\n  }\n\n  return esbuildInitializePromise;\n}\n\nexport async function bundleJavaScript(sourceFiles: Record<string, string> & { '/entry.js': string }, options: {\n  format?: 'iife' | 'esm' | 'cjs',\n  externalPackages?: Record<string, string>,\n  keepAsImports?: string[],\n  sourcemap?: false | 'inline',\n  allowHttpImports?: boolean,\n} = {}): Promise<Result<string, string>> {\n  await initializeEsbuild();\n\n  const sourceFilesMap = new Map(Object.entries(sourceFiles));\n  const externalPackagesMap = new Map(Object.entries(options.externalPackages ?? {}));\n  const keepAsImports = options.keepAsImports ?? [];\n\n  const httpImportCache = new Map<string, { contents: string, loader: esbuild.Loader, resolveDir: string }>();\n\n  const extToLoader: Map<string, esbuild.Loader> = new Map([\n    ['tsx', 'tsx'],\n    ['ts', 'ts'],\n    ['js', 'js'],\n    ['jsx', 'jsx'],\n    ['json', 'json'],\n    ['css', 'css'],\n  ]);\n  let result;\n  try {\n    result = await traceSpan('bundleJavaScript', async () => await esbuild.build({\n      entryPoints: ['/entry.js'],\n      bundle: true,\n      write: false,\n      format: options.format ?? 'iife',\n      platform: 'browser',\n      target: 'es2015',\n      jsx: 'automatic',\n      sourcemap: options.sourcemap ?? 'inline',\n      external: keepAsImports,\n      plugins: [\n        ...options.allowHttpImports ? [{\n          name: \"esm-sh-only\",\n          setup(build: esbuild.PluginBuild) {\n            // Handle absolute URLs and relative imports from esm.sh modules.\n            build.onResolve({ filter: /.*/ }, (args) => {\n              // Only touch absolute http(s) specifiers or children of our own namespace\n              const isHttp = args.path.startsWith(\"http://\") || args.path.startsWith(\"https://\");\n              const fromEsmNs = args.namespace === \"esm-sh\";\n\n              if (!isHttp && !fromEsmNs) return null; // Let other plugins handle bare/relative/local\n\n              // Resolve relative URLs inside esm.sh-fetched modules\n              const url = new URL(args.path, fromEsmNs ? args.importer : undefined);\n\n              if (url.protocol !== \"https:\" || url.host !== \"esm.sh\") {\n                throw new Error(`Blocked non-esm.sh URL import: ${url.href}`);\n              }\n\n              return { path: url.href, namespace: \"esm-sh\" };\n            });\n\n            build.onLoad({ filter: /.*/, namespace: \"esm-sh\" }, async (args) => {\n              if (httpImportCache.has(args.path)) return httpImportCache.get(args.path)!;\n\n              const res = await fetch(args.path, { redirect: \"follow\" });\n              if (!res.ok) throw new Error(`Fetch ${res.status} ${res.statusText} for ${args.path}`);\n              const finalUrl = new URL(res.url);\n              // Defensive: follow shouldn’t leave esm.sh, but re-check.\n              if (finalUrl.host !== \"esm.sh\") {\n                throw new Error(`Redirect escaped esm.sh: ${finalUrl.href}`);\n              }\n\n              const ct = (res.headers.get(\"content-type\") || \"\").toLowerCase();\n              let loader: esbuild.Loader =\n                ct.includes(\"css\") ? \"css\" :\n                ct.includes(\"json\") ? \"json\" :\n                ct.includes(\"typescript\") ? \"ts\" :\n                ct.includes(\"jsx\") ? \"jsx\" :\n                ct.includes(\"tsx\") ? \"tsx\" :\n                  \"js\";\n\n              // Fallback by extension (esm.sh sometimes omits CT)\n              const p = finalUrl.pathname;\n              if (p.endsWith(\".css\")) loader = \"css\";\n              else if (p.endsWith(\".json\")) loader = \"json\";\n              else if (p.endsWith(\".ts\")) loader = \"ts\";\n              else if (p.endsWith(\".tsx\")) loader = \"tsx\";\n              else if (p.endsWith(\".jsx\")) loader = \"jsx\";\n\n              const contents = await res.text();\n              const result = {\n                contents,\n                loader,\n                // Ensures relative imports inside that module resolve against the file’s URL\n                resolveDir: new URL(\".\", finalUrl.href).toString(),\n                watchFiles: [finalUrl.href],\n              };\n              httpImportCache.set(args.path, result);\n              return result;\n            });\n          },\n        } as esbuild.Plugin] : [],\n        {\n          name: 'replace-packages-with-globals',\n          setup(build) {\n            build.onResolve({ filter: /.*/ }, args => {\n              // Skip packages that should remain external (not be shimmed)\n              if (keepAsImports.includes(args.path)) {\n                return undefined;\n              }\n              if (externalPackagesMap.has(args.path)) {\n                return { path: args.path, namespace: 'package-shim' };\n              }\n              return undefined;\n            });\n\n            build.onLoad({ filter: /.*/, namespace: 'package-shim' }, (args) => {\n              const contents = externalPackagesMap.get(args.path);\n              if (contents == null) throw new HexclaveAssertionError(`esbuild requested file ${args.path} that is not in the virtual file system`);\n\n              return { contents, loader: 'ts' };\n            });\n          },\n        },\n        {\n          name: 'virtual-fs',\n          setup(build) {\n            build.onResolve({ filter: /.*/ }, args => {\n              const absolutePath = join(\"/\", args.path);\n              if (sourceFilesMap.has(absolutePath)) {\n                return { path: absolutePath, namespace: 'virtual' };\n              }\n              return undefined;\n            });\n\n            /* 2️⃣  Load the module from the map */\n            build.onLoad({ filter: /.*/, namespace: 'virtual' }, args => {\n              const contents = sourceFilesMap.get(args.path);\n              if (contents == null) throw new HexclaveAssertionError(`esbuild requested file ${args.path} that is not in the virtual file system`);\n\n              const ext = args.path.split('.').pop() ?? '';\n              const loader = extToLoader.get(ext) ?? throwErr(`esbuild requested file ${args.path} with unknown extension ${ext}`);\n\n              return { contents, loader };\n            });\n          },\n        },\n      ],\n    }));\n  } catch (e) {\n    if (e instanceof Error && e.message.startsWith(\"Build failed with \")) {\n      return Result.error(e.message);\n    }\n    throw e;\n  }\n\n  if (result.errors.length > 0) {\n    return Result.error(result.errors.map(e => e.text).join('\\n'));\n  }\n\n  if (result.outputFiles.length > 0) {\n    return Result.ok(result.outputFiles[0].text);\n  }\n  return throwErr(\"No output generated??\");\n}\n"],"mappings":"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"}

package/dist/esm/utils/featurebase.d.ts

@@ -0,0 +1,30 @@
+//#region src/utils/featurebase.d.ts
+type FeaturebaseUser = {
+  userId: string;
+  email: string;
+  name?: string;
+  profilePicture?: string;
+};
+type StackAuthUser = {
+  id: string;
+  primaryEmail: string | null;
+  displayName?: string | null;
+  profileImageUrl?: string | null;
+};
+/**
+ * Get or create a Featurebase user based on Hexclave user data.
+ * This function ensures that:
+ * 1. We never change a user's email address on Featurebase
+ * 2. We use Hexclave user ID as the primary identifier
+ * 3. We handle email conflicts by using fallback emails
+ * 4. We update profile information when needed
+ */
+declare function getOrCreateFeaturebaseUser(stackAuthUser: StackAuthUser, options?: {
+  apiKey?: string;
+}): Promise<{
+  userId: string;
+  email: string;
+}>;
+//#endregion
+export { FeaturebaseUser, StackAuthUser, getOrCreateFeaturebaseUser };
+//# sourceMappingURL=featurebase.d.ts.map