@better-auth-ui/core 1.6.0

package/src/lib/utils.ts

@@ -0,0 +1,151 @@
+/**
+ * Type guard that checks whether a value is a non-null, non-array object.
+ */
+function isObject(item: unknown): item is Record<string, unknown> {
+  return item !== null && typeof item === "object" && !Array.isArray(item)
+}
+
+/**
+ * Type guard that checks whether a value is a plain object suitable for deep merging.
+ * Excludes `Date`, `RegExp`, and other special object types.
+ */
+function isPlainObject(item: unknown): item is Record<string, unknown> {
+  if (!isObject(item)) return false
+
+  // Handle special object types that should not be merged
+  if (item instanceof Date) return false
+  if (item instanceof RegExp) return false
+
+  return true
+}
+
+/**
+ * Resize and square-crop an image file for use as an avatar.
+ *
+ * The image is center-cropped to a square, scaled down to at most {@link size} pixels,
+ * and converted to the specified output format.
+ *
+ * @param file - The source image file.
+ * @param size - Max dimension in pixels for the output image.
+ * @param extension - Output format. Use `"inherit"` to keep the original format.
+ * @returns A promise that resolves to the processed `File`.
+ */
+export function resizeAvatar(
+  file: File,
+  size = 256,
+  extension: "png" | "jpg" | "webp" | "inherit" = "png"
+): Promise<File> {
+  const MAX_SIZE = size
+  const resolvedExtension =
+    extension === "inherit" ? file.name.split(".").pop() : extension
+  const mimeType =
+    extension === "inherit"
+      ? file.type
+      : `image/${extension === "jpg" ? "jpeg" : extension}`
+
+  return new Promise((resolve, reject) => {
+    const img = new Image()
+    const url = URL.createObjectURL(file)
+
+    img.onload = () => {
+      URL.revokeObjectURL(url)
+
+      const { naturalWidth: w, naturalHeight: h } = img
+      const side = Math.min(w, h)
+
+      const cropX = (w - side) / 2
+      const cropY = (h - side) / 2
+
+      const outSize = Math.min(side, MAX_SIZE)
+
+      const canvas = document.createElement("canvas")
+      canvas.width = outSize
+      canvas.height = outSize
+
+      const ctx = canvas.getContext("2d")
+      if (!ctx) {
+        reject(new Error("Could not get canvas context"))
+        return
+      }
+
+      ctx.drawImage(img, cropX, cropY, side, side, 0, 0, outSize, outSize)
+
+      canvas.toBlob(
+        (blob) => {
+          if (!blob) {
+            reject(new Error("Could not create blob from canvas"))
+            return
+          }
+          resolve(
+            new File(
+              [blob],
+              file.name.replace(/\.[^.]+$/, `.${resolvedExtension}`),
+              {
+                type: mimeType
+              }
+            )
+          )
+        },
+        mimeType,
+        1
+      )
+    }
+
+    img.onerror = () => {
+      URL.revokeObjectURL(url)
+      reject(new Error("Failed to load image"))
+    }
+
+    img.src = url
+  })
+}
+
+/**
+ * Convert a `File` to a base64-encoded data URL string.
+ *
+ * @param file - The file to encode.
+ * @returns A promise that resolves to the base64 data URL.
+ */
+export function fileToBase64(file: File): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const reader = new FileReader()
+    reader.onload = () => resolve(reader.result as string)
+    reader.onerror = () => reject(new Error("Failed to read file"))
+    reader.readAsDataURL(file)
+  })
+}
+
+/**
+ * Recursively merge `source` into `target`, producing a new object.
+ *
+ * - Plain objects are merged key-by-key; nested objects are merged recursively.
+ * - `undefined` values in `source` are skipped (existing `target` values are preserved).
+ * - Non-plain values (arrays, `Date`, `RegExp`, primitives, functions) in `source`
+ *   replace the corresponding `target` value outright.
+ *
+ * @param target - The base object.
+ * @param source - Partial overrides to apply on top of `target`.
+ * @returns A new merged object of type `T`.
+ */
+export function deepmerge<T>(target: T, source: Partial<T>): T {
+  if (isPlainObject(target) && isPlainObject(source)) {
+    const result: Record<string, unknown> = { ...target }
+
+    for (const [key, value] of Object.entries(source)) {
+      if (value === undefined) continue // skip undefineds
+
+      if (key in target) {
+        result[key] = deepmerge(
+          (target as Record<string, unknown>)[key],
+          value as unknown as Partial<T>
+        )
+      } else {
+        result[key] = value
+      }
+    }
+
+    return result as T
+  }
+
+  return source as T
+}

package/src/lib/view-paths.ts

@@ -0,0 +1,86 @@
+/**
+ * View path segments for authentication routes.
+ */
+export type AuthViewPaths = {
+  /**
+   * Path segment for the sign-in view
+   * @default "sign-in"
+   */
+  signIn: string
+  /**
+   * Path segment for the sign-up view
+   * @default "sign-up"
+   */
+  signUp: string
+  /**
+   * Path segment for the magic link authentication view
+   * @default "magic-link"
+   */
+  magicLink: string
+  /**
+   * Path segment for the forgot password view
+   * @default "forgot-password"
+   */
+  forgotPassword: string
+  /**
+   * Path segment for the reset password view
+   * @default "reset-password"
+   */
+  resetPassword: string
+  /**
+   * Path segment for the sign-out view
+   * @default "sign-out"
+   */
+  signOut: string
+}
+
+/**
+ * View path segments for settings routes.
+ */
+export type SettingsViewPaths = {
+  /**
+   * Path segment for the account settings view
+   * @default "account"
+   */
+  account: string
+  /**
+   * Path segment for the security settings view
+   * @default "security"
+   */
+  security: string
+}
+
+/**
+ * View path configuration for authentication and settings routes.
+ */
+export type ViewPaths = {
+  /** Auth view path segments */
+  auth: AuthViewPaths
+  /** Settings view path segments */
+  settings: SettingsViewPaths
+}
+
+export const viewPaths: ViewPaths = {
+  auth: {
+    signIn: "sign-in",
+    signUp: "sign-up",
+    magicLink: "magic-link",
+    forgotPassword: "forgot-password",
+    resetPassword: "reset-password",
+    signOut: "sign-out"
+  },
+  settings: {
+    account: "account",
+    security: "security"
+  }
+}
+
+/**
+ * Valid auth view key.
+ */
+export type AuthView = keyof AuthViewPaths
+
+/**
+ * Valid settings view key.
+ */
+export type SettingsView = keyof SettingsViewPaths