@memobit/libs 3.8.3 → 3.10.0

package/dist/errors.d.ts

@@ -0,0 +1,78 @@
+export declare type ErrorReportContext = Record<string, unknown>;
+
+export declare interface ErrorReportingConfig {
+    /** The app id registered in the hub, e.g. `garage`. */
+    appId: string;
+    /** The hub ingest URL, e.g. `https://hub.memobit.ro/api/errors/ingest`. */
+    endpoint: string;
+    /** Turns reporting off for this run, e.g. `import.meta.env.PROD` to report only from production builds. Defaults to true. */
+    enabled?: boolean;
+    /** Shown in the hub next to each error. Defaults to `production`. */
+    environment?: string;
+    /** Build or commit the errors came from. */
+    release?: string;
+    /** Also report `console.error` and `console.warn` calls. Defaults to true. */
+    captureConsole?: boolean;
+    /** Messages to drop, on top of the built-in browser noise filters. */
+    ignore?: (string | RegExp)[];
+    /** Most events sent per page load or process run. Defaults to 200. */
+    maxEventsPerSession?: number;
+}
+
+/**
+ * Error reporting shared by every memobit app, in the browser and in Node. Errors and
+ * warnings are batched and POSTed to the hub's errors/ingest endpoint, which groups them,
+ * lists them on the hub's Errors page and emails on new errors and on spikes.
+ *
+ * React-free on purpose (it ships through the `@memobit/libs/errors` entry), so Node
+ * servers can use it too. The hub can switch reporting off — globally, per app, or
+ * automatically on a spike — and the reporter then stays quiet for as long as it is told.
+ */
+export declare type ErrorReportLevel = 'error' | 'warning';
+
+/** Sends whatever is queued now instead of waiting for the next batch. */
+export declare const flushErrorReports: () => Promise<void>;
+
+/** Browser apps: call once, before rendering. */
+export declare const installErrorReporting: (config: ErrorReportingConfig) => void;
+
+/**
+ * Node servers: call once at startup, passing `process`. Unhandled rejections reach
+ * Node's uncaught-exception path, so both are covered. Listening there would stop the
+ * crash Node normally does, so — unless the server has its own handler — the process
+ * still exits with code 1, once the report is sent (or after 3s).
+ */
+export declare const installNodeErrorReporting: (nodeProcess: NodeProcessLike, config: ErrorReportingConfig) => void;
+
+/**
+ * Use in place of `console.*` in app code. `debug` and `info` only write to the console;
+ * `warn` and `error` also report to the hub once error reporting is installed — and only
+ * once, even though the console capture is on.
+ */
+export declare const logger: {
+    debug: (message: string, context?: ErrorReportContext) => void;
+    info: (message: string, context?: ErrorReportContext) => void;
+    warn: (message: string, context?: ErrorReportContext) => void;
+    /** `error` is the caught value, if there is one; its stack is kept. */
+    error: (message: string, error?: unknown, context?: ErrorReportContext) => void;
+};
+
+/** The part of Node's `process` the reporter needs; pass `process` itself. */
+export declare interface NodeProcessLike {
+    on(event: 'uncaughtException', listener: (error: Error) => void): unknown;
+    listenerCount(event: 'uncaughtException'): number;
+    exit(code?: number): void;
+}
+
+/** Reports a caught error you handled but still want to know about. */
+declare const reportError_2: (error: unknown, context?: ErrorReportContext) => void;
+export { reportError_2 as reportError }
+
+export { }
+
+
+declare global {
+    interface Window {
+        __VERSIONS__: FullVersionInfo;
+    }
+}

package/dist/errors.js

@@ -0,0 +1,9 @@
+import { flushErrorReports as o, installErrorReporting as t, installNodeErrorReporting as e, reportError as p } from "./helpers/ErrorReporting.js";
+import { logger as l } from "./helpers/Logger.js";
+export {
+  o as flushErrorReports,
+  t as installErrorReporting,
+  e as installNodeErrorReporting,
+  l as logger,
+  p as reportError
+};

package/dist/helpers/ErrorReporting.js

@@ -0,0 +1,179 @@
+var b = 5e3, A = 10, U = 25, _ = 1e3, f = 4e3, m = 60, R = 3e3, T = [/ResizeObserver loop/, /^Script error\.?$/], l = null, u = !1, E = /* @__PURE__ */ new WeakSet(), d = {}, p = (e, r) => e.length > r ? `${e.slice(0, r)}…` : e, v = (e) => typeof e == "object" && e !== null && !Array.isArray(e), $ = (e) => v(e) && (e.enabled === void 0 || typeof e.enabled == "boolean"), s = (e) => {
+  if (e instanceof Error) return e.message ? `${e.name}: ${e.message}` : e.name;
+  if (typeof e == "string") return e;
+  try {
+    return p(JSON.stringify(e) ?? String(e), 500);
+  } catch {
+    return String(e);
+  }
+}, C = (e) => {
+  const [r, ...n] = e;
+  return typeof r != "string" || !/%[sdifoOc]/.test(r) ? e.map(s).join(" ") : [r.replace(/%([sdifoOc%])/g, (t, o) => {
+    if (o === "%") return "%";
+    if (n.length === 0) return t;
+    const a = n.shift();
+    return o === "c" ? "" : s(a);
+  }), ...n.map(s)].join(" ");
+}, O = (e) => {
+  if (e)
+    try {
+      const r = JSON.stringify(e);
+      if (r.length > f) return { truncated: p(r, f) };
+      const n = JSON.parse(r);
+      return v(n) ? n : void 0;
+    } catch {
+      return { unserializable: s(e) };
+    }
+}, N = () => typeof location > "u" ? void 0 : location.origin + location.pathname, q = (e, r, n) => n?.includes("-extension://") ? !0 : e.ignore.some((t) => typeof t == "string" ? r.includes(t) : t.test(r)), h = (e, r) => {
+  e.pausedUntil = Date.now() + Math.max(30, r) * 1e3, e.queue.clear();
+}, g = (e) => {
+  e.timer === null && (e.timer = setTimeout(() => {
+    c();
+  }, b));
+}, y = (e, r) => {
+  (d[e] ?? console[e]).apply(console, r);
+}, i = (e) => {
+  const r = l;
+  if (!(!r || u)) {
+    if (typeof e.error == "object" && e.error !== null) {
+      if (E.has(e.error)) return;
+      E.add(e.error);
+    }
+    if (!(Date.now() < r.pausedUntil || q(r, e.message, e.stack))) {
+      u = !0;
+      try {
+        const n = p(e.message, _), t = `${e.level}|${n}|${e.stack?.split(`
+`, 2).join("|") ?? ""}`, o = r.queue.get(t);
+        if (o) {
+          o.count += 1;
+          return;
+        }
+        if (r.sent + r.queue.size >= r.maxEvents) {
+          r.capReached || (r.capReached = !0, y("warn", [`[memobit] Error reporting stopped for this session after ${r.maxEvents} events.`]));
+          return;
+        }
+        r.queue.set(t, {
+          level: e.level,
+          message: n,
+          stack: e.stack,
+          url: N(),
+          context: O(e.context),
+          count: 1
+        }), r.queue.size >= A ? c() : g(r);
+      } finally {
+        u = !1;
+      }
+    }
+  }
+}, x = (e, r) => {
+  i({
+    level: "error",
+    message: s(e),
+    stack: e instanceof Error ? e.stack : void 0,
+    context: r,
+    error: e
+  });
+}, c = async () => {
+  const e = l;
+  if (!e) return;
+  e.timer !== null && (clearTimeout(e.timer), e.timer = null);
+  const r = [...e.queue.entries()].slice(0, U);
+  if (r.length === 0) return;
+  r.forEach(([t]) => e.queue.delete(t)), e.sent += r.length;
+  const n = JSON.stringify({
+    app: e.appId,
+    source: e.source,
+    environment: e.environment,
+    release: e.release,
+    events: r.map(([, t]) => t)
+  });
+  try {
+    const t = await (await fetch(e.endpoint, {
+      method: "POST",
+      headers: { "Content-Type": "text/plain;charset=UTF-8" },
+      body: n,
+      credentials: "omit",
+      keepalive: n.length < 6e4
+    })).json().catch(() => null);
+    $(t) && t.enabled === !1 && h(e, t.retryAfter ?? m);
+  } catch {
+    h(e, m);
+  }
+  e.queue.size > 0 && g(e);
+}, w = (e, r) => l || e.enabled === !1 || !e.appId || !e.endpoint ? !1 : (l = {
+  appId: e.appId,
+  endpoint: e.endpoint,
+  source: r,
+  environment: e.environment ?? "production",
+  release: e.release,
+  ignore: [...T, ...e.ignore ?? []],
+  maxEvents: e.maxEventsPerSession ?? 200,
+  queue: /* @__PURE__ */ new Map(),
+  sent: 0,
+  pausedUntil: 0,
+  capReached: !1,
+  timer: null
+}, !0), S = () => {
+  const e = console.error, r = console.warn;
+  d.error = e, d.warn = r;
+  const n = (t, o) => {
+    const a = o.find((k) => k instanceof Error);
+    i({
+      level: t,
+      message: C(o),
+      stack: a instanceof Error ? a.stack : void 0,
+      error: a
+    });
+  };
+  console.error = (...t) => {
+    e.apply(console, t), n("error", t);
+  }, console.warn = (...t) => {
+    r.apply(console, t), n("warning", t);
+  };
+}, I = (e) => {
+  if (typeof window > "u" || !w(e, "client")) return;
+  window.addEventListener("error", (n) => {
+    const t = n.error;
+    i({
+      level: "error",
+      message: t instanceof Error ? s(t) : n.message || "Unknown error",
+      stack: t instanceof Error ? t.stack : `at ${n.filename}:${n.lineno}:${n.colno}`,
+      error: t
+    });
+  }), window.addEventListener("unhandledrejection", (n) => {
+    const t = n.reason;
+    i({
+      level: "error",
+      message: `Unhandled rejection: ${s(t)}`,
+      stack: t instanceof Error ? t.stack : void 0,
+      error: t
+    });
+  });
+  const r = () => {
+    c();
+  };
+  window.addEventListener("pagehide", r), document.addEventListener("visibilitychange", () => {
+    document.visibilityState === "hidden" && r();
+  }), e.captureConsole !== !1 && S();
+}, L = (e, r) => {
+  w(r, "server") && (e.on("uncaughtException", (n) => {
+    if (i({
+      level: "error",
+      message: `Uncaught ${s(n)}`,
+      stack: n.stack,
+      error: n
+    }), e.listenerCount("uncaughtException") > 1) return;
+    y("error", [n]);
+    const t = new Promise((o) => setTimeout(o, R));
+    Promise.race([c(), t]).finally(() => e.exit(1));
+  }), r.captureConsole !== !1 && S());
+};
+export {
+  i as captureEvent,
+  s as describeValue,
+  c as flushErrorReports,
+  I as installErrorReporting,
+  L as installNodeErrorReporting,
+  x as reportError,
+  y as writeNativeConsole
+};

package/dist/helpers/Logger.js

@@ -0,0 +1,31 @@
+import { captureEvent as e, describeValue as d, writeNativeConsole as n } from "./ErrorReporting.js";
+var v = (o, i, r) => {
+  const a = [o];
+  return r !== void 0 && a.push(r), i !== void 0 && a.push(i), a;
+}, t = {
+  debug: (o, i) => {
+    n("debug", v(o, i));
+  },
+  info: (o, i) => {
+    n("info", v(o, i));
+  },
+  warn: (o, i) => {
+    n("warn", v(o, i)), e({
+      level: "warning",
+      message: o,
+      context: i
+    });
+  },
+  error: (o, i, r) => {
+    n("error", v(o, r, i)), e({
+      level: "error",
+      message: i === void 0 ? o : `${o}: ${d(i)}`,
+      stack: i instanceof Error ? i.stack : void 0,
+      context: r,
+      error: i
+    });
+  }
+};
+export {
+  t as logger
+};

package/dist/helpers/VersionInfo.js

@@ -23,7 +23,7 @@ var r = (i) => {
   const o = {
     ...i,
     lib: d,
-    libBuildNumber: 3,
+    libBuildNumber: 501,
     libCommit: n,
     libBuildDate: t
   };

package/dist/index.d.ts

@@ -1481,8 +1481,8 @@ export declare interface ErrorBoundaryProps {
     /** Label for the reset button. Defaults to "Try again". */
     resetLabel?: string;
     /**
-     * Optional callback invoked when an error is caught. Use this to forward to
-     * a logging service. Console logging is always done as a fallback.
+     * Optional callback invoked when an error is caught. Caught errors are already
+     * reported to the hub once error reporting is installed, and always logged to the console.
      */
     onError?: (error: Error, info: ErrorInfo) => void;
     /**
@@ -3242,7 +3242,7 @@ export declare interface TimelineMarkerInfo {
     dateLabel: string;
 }
 
-export declare const TimelineMarkers: <T extends TimelineMarkersItem>({ items, renderItem, className, }: TimelineMarkersProps<T>) => JSX.Element;
+export declare const TimelineMarkers: <T extends TimelineMarkersItem>({ items, renderItem, className }: TimelineMarkersProps<T>) => JSX.Element;
 
 export declare interface TimelineMarkersItem {
     id: string | number;

package/dist/memobit-icons.json

@@ -5,54 +5,14 @@
     "arrow-left",
     "arrow-right",
     "arrow-up",
-    "bullet",
-    "burst",
-    "calendar",
     "calendar-month",
     "calendar-week",
     "caret-down",
     "caret-left",
     "caret-right",
     "caret-up",
-    "checkmark",
-    "clear",
-    "clipboard",
-    "comment",
-    "confetti",
     "credit-card",
-    "empty",
-    "file",
-    "filters",
-    "fireworks",
-    "folder",
-    "food",
-    "gallery",
-    "grid",
-    "key",
-    "link",
-    "lock",
-    "logout",
-    "map",
     "menu-hamburger",
-    "next",
-    "other",
-    "ownership",
-    "pin",
-    "plus",
-    "previous",
-    "radio",
-    "return",
-    "save",
-    "scss",
-    "search",
-    "sparkle",
-    "star",
-    "table",
-    "target",
-    "theme-picker",
-    "time",
-    "tree",
-    "tune",
-    "warning"
+    "theme-picker"
   ]
 }

package/dist/styles/base.scss

@@ -1,36 +1,36 @@
-// Universal body painting + sizing. Consumed via themes.scss so every memobit
-// app picks it up automatically.
-//
-// Why this lives here:
-// Theme backgrounds are gradients (multi-stop linear/radial). If the body is
-// shorter than the viewport during initial render — empty content, loading
-// state — the gradient gets tiled vertically by default, producing visible
-// horizontal banding. `min-height: 100vh` ensures the body is at least as tall
-// as the viewport so the gradient renders at full size on first paint;
-// `background-repeat: no-repeat` is a defensive guard for edge cases (zoom,
-// tall viewport with short content after HMR).
-//
-// Do NOT use the `background` shorthand in consumer App.scss — it resets
-// `background-repeat` to its initial `repeat` value and re-introduces the
-// banding. Set `background-image` long-hand if a per-project override is
-// needed; otherwise omit and let this rule own it.
-
-html,
-body {
-    background: var(--body-background);
-    background-repeat: no-repeat;
-    margin: 0;
-    padding: 0;
-    min-height: 100vh;
-}
-
-// Ambient glow overlay — themes opt in via `--body-background-glow`. Pinned to
-// the viewport so it stays put on scroll; z-index: -1 keeps it behind app content.
-body::before {
-    content: '';
-    position: fixed;
-    inset: 0;
-    z-index: -1;
-    background: var(--body-background-glow, none);
-    pointer-events: none;
-}
+// Universal body painting + sizing. Consumed via themes.scss so every memobit
+// app picks it up automatically.
+//
+// Why this lives here:
+// Theme backgrounds are gradients (multi-stop linear/radial). If the body is
+// shorter than the viewport during initial render — empty content, loading
+// state — the gradient gets tiled vertically by default, producing visible
+// horizontal banding. `min-height: 100vh` ensures the body is at least as tall
+// as the viewport so the gradient renders at full size on first paint;
+// `background-repeat: no-repeat` is a defensive guard for edge cases (zoom,
+// tall viewport with short content after HMR).
+//
+// Do NOT use the `background` shorthand in consumer App.scss — it resets
+// `background-repeat` to its initial `repeat` value and re-introduces the
+// banding. Set `background-image` long-hand if a per-project override is
+// needed; otherwise omit and let this rule own it.
+
+html,
+body {
+    background: var(--body-background);
+    background-repeat: no-repeat;
+    margin: 0;
+    padding: 0;
+    min-height: 100vh;
+}
+
+// Ambient glow overlay — themes opt in via `--body-background-glow`. Pinned to
+// the viewport so it stays put on scroll; z-index: -1 keeps it behind app content.
+body::before {
+    content: '';
+    position: fixed;
+    inset: 0;
+    z-index: -1;
+    background: var(--body-background-glow, none);
+    pointer-events: none;
+}

package/dist/styles/effects.scss

@@ -1,72 +1,72 @@
-.note-container-effect {
-    font-size: var(--font-size-md);
-    line-height: 1.6;
-    padding: var(--spacing-16);
-    border-radius: var(--spacing-12);
-    border-left: var(--spacing-2) solid var(--note-container-effect-border-left-color);
-    background-color: var(--note-container-effect-background-color);
-    color: var(--note-container-effect-color);
-}
-
-.infuse-effect {
-    border-width: var(--spacing-1);
-    border-style: solid;
-    transition: all 0.3s;
-    position: relative;
-
-    &::before {
-        content: '';
-        position: absolute;
-        top: 0;
-        left: 0;
-        background: var(--infuse-effect-before-background);
-        width: var(--spacing-4);
-        height: 100%;
-        opacity: 0;
-        transition: opacity 0.3s;
-    }
-
-    &:hover {
-        transform: translateY(-5px);
-        border-color: var(--infuse-effect-hover-border-color);
-        box-shadow: 0 var(--spacing-12) var(--spacing-24) var(--infuse-effect-hover-box-shadow-color);
-
-        &::before {
-            opacity: 1;
-        }
-    }
-}
-
-.up-lift-effect {
-    border-width: var(--spacing-1);
-    border-style: solid;
-    box-shadow: 0 var(--spacing-4) var(--spacing-12) var(--up-lift-effect-box-shadow-color);
-    transition: all 0.3s ease;
-    position: relative;
-
-    &::before {
-        content: '';
-        position: absolute;
-        top: 0;
-        left: 0;
-        width: 5px;
-        height: 100%;
-        background: var(--up-lift-effect-before-background);
-    }
-
-    &:hover {
-        transform: translateY(-5px);
-        border-color: var(--up-lift-effect-hover-border-color);
-        box-shadow: 0 var(--spacing-12) var(--spacing-24) var(--up-lift-effect-hover-box-shadow-color);
-    }
-}
-
-.glow-effect {
-    transition: 0.3s;
-
-    &:hover {
-        box-shadow: var(--glow-box-shadow-color);
-        transform: translateY(-2px);
-        border-color: var(--glow-hover-border-color);
-    }
-}
+.note-container-effect {
+    font-size: var(--font-size-md);
+    line-height: 1.6;
+    padding: var(--spacing-16);
+    border-radius: var(--spacing-12);
+    border-left: var(--spacing-2) solid var(--note-container-effect-border-left-color);
+    background-color: var(--note-container-effect-background-color);
+    color: var(--note-container-effect-color);
+}
+
+.infuse-effect {
+    border-width: var(--spacing-1);
+    border-style: solid;
+    transition: all 0.3s;
+    position: relative;
+
+    &::before {
+        content: '';
+        position: absolute;
+        top: 0;
+        left: 0;
+        background: var(--infuse-effect-before-background);
+        width: var(--spacing-4);
+        height: 100%;
+        opacity: 0;
+        transition: opacity 0.3s;
+    }
+
+    &:hover {
+        transform: translateY(-5px);
+        border-color: var(--infuse-effect-hover-border-color);
+        box-shadow: 0 var(--spacing-12) var(--spacing-24) var(--infuse-effect-hover-box-shadow-color);
+
+        &::before {
+            opacity: 1;
+        }
+    }
+}
+
+.up-lift-effect {
+    border-width: var(--spacing-1);
+    border-style: solid;
+    box-shadow: 0 var(--spacing-4) var(--spacing-12) var(--up-lift-effect-box-shadow-color);
+    transition: all 0.3s ease;
+    position: relative;
+
+    &::before {
+        content: '';
+        position: absolute;
+        top: 0;
+        left: 0;
+        width: 5px;
+        height: 100%;
+        background: var(--up-lift-effect-before-background);
+    }
+
+    &:hover {
+        transform: translateY(-5px);
+        border-color: var(--up-lift-effect-hover-border-color);
+        box-shadow: 0 var(--spacing-12) var(--spacing-24) var(--up-lift-effect-hover-box-shadow-color);
+    }
+}
+
+.glow-effect {
+    transition: 0.3s;
+
+    &:hover {
+        box-shadow: var(--glow-box-shadow-color);
+        transform: translateY(-2px);
+        border-color: var(--glow-hover-border-color);
+    }
+}

package/dist/styles/highlight.scss

@@ -1,6 +1,6 @@
-mark {
-    background-color: var(--button-warning-background-color);
-    color: var(--button-warning-color);
-    padding: var(--spacing-1) var(--spacing-4);
-    border-radius: var(--radius-sm);
-}
+mark {
+    background-color: var(--button-warning-background-color);
+    color: var(--button-warning-color);
+    padding: var(--spacing-1) var(--spacing-4);
+    border-radius: var(--radius-sm);
+}

package/dist/styles/scrollbars.scss

@@ -1,30 +1,30 @@
-:root {
-    --scrollbar-size: 6px;
-    --scrollbar-track-color: transparent;
-    --scrollbar-thumb-color: var(--delimiter-color, rgba(128, 128, 128, 0.45));
-    --scrollbar-thumb-hover-color: var(--body-color-muted, rgba(128, 128, 128, 0.65));
-    --scrollbar-radius: var(--radius-full, 9999px);
-}
-
-* {
-    scrollbar-color: var(--scrollbar-thumb-color) var(--scrollbar-track-color);
-    scrollbar-width: thin;
-}
-
-*::-webkit-scrollbar {
-    width: var(--scrollbar-size);
-    height: var(--scrollbar-size);
-}
-
-*::-webkit-scrollbar-track {
-    background: var(--scrollbar-track-color);
-}
-
-*::-webkit-scrollbar-thumb {
-    background: var(--scrollbar-thumb-color);
-    border-radius: var(--scrollbar-radius);
-}
-
-*::-webkit-scrollbar-thumb:hover {
-    background: var(--scrollbar-thumb-hover-color);
-}
+:root {
+    --scrollbar-size: 6px;
+    --scrollbar-track-color: transparent;
+    --scrollbar-thumb-color: var(--delimiter-color, rgba(128, 128, 128, 0.45));
+    --scrollbar-thumb-hover-color: var(--body-color-muted, rgba(128, 128, 128, 0.65));
+    --scrollbar-radius: var(--radius-full, 9999px);
+}
+
+* {
+    scrollbar-color: var(--scrollbar-thumb-color) var(--scrollbar-track-color);
+    scrollbar-width: thin;
+}
+
+*::-webkit-scrollbar {
+    width: var(--scrollbar-size);
+    height: var(--scrollbar-size);
+}
+
+*::-webkit-scrollbar-track {
+    background: var(--scrollbar-track-color);
+}
+
+*::-webkit-scrollbar-thumb {
+    background: var(--scrollbar-thumb-color);
+    border-radius: var(--scrollbar-radius);
+}
+
+*::-webkit-scrollbar-thumb:hover {
+    background: var(--scrollbar-thumb-hover-color);
+}