@better-auth/core 1.4.0-beta.7 → 1.4.0-beta.8

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @better-auth/core@1.4.0-beta.7 build /home/runner/work/better-auth/better-auth/packages/core
+> @better-auth/core@1.4.0-beta.8 build /home/runner/work/better-auth/better-auth/packages/core
 > unbuild --clean
 
 [info] Building core
@@ -13,15 +13,23 @@ Generated an empty chunk: "db/adapter/index".
 
 [log]   dist/async_hooks/index.cjs (total size: 922 B, chunk size: 922 B, exports: getAsyncLocalStorage)
 
-[log]   dist/db/index.cjs (total size: 2.09 kB, chunk size: 2.09 kB, exports: accountSchema, coreSchema, sessionSchema, userSchema, verificationSchema)
+[log]   dist/env/index.cjs (total size: 8.71 kB, chunk size: 8.71 kB, exports: ENV, TTY_COLORS, createLogger, env, getBooleanEnvVar, getColorDepth, getEnvVar, isDevelopment, isProduction, isTest, levels, logger, nodeENV, shouldPublishLog)
+
+[log]   dist/oauth2/index.cjs (total size: 10.3 kB, chunk size: 10.3 kB, exports: clientCredentialsToken, createAuthorizationCodeRequest, createAuthorizationURL, createClientCredentialsTokenRequest, createRefreshAccessTokenRequest, generateCodeChallenge, getOAuth2Tokens, refreshAccessToken, validateAuthorizationCode, validateToken)
+
+[log]   dist/db/index.cjs (total size: 2.43 kB, chunk size: 2.43 kB, exports: accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema)
 
 [log]   dist/db/adapter/index.cjs (total size: 15 B, chunk size: 15 B)
 [log]   dist/index.mjs (total size: 1 B, chunk size: 1 B)
 
 [log]   dist/async_hooks/index.mjs (total size: 887 B, chunk size: 887 B, exports: getAsyncLocalStorage)
 
-[log]   dist/db/index.mjs (total size: 1.4 kB, chunk size: 1.4 kB, exports: accountSchema, coreSchema, sessionSchema, userSchema, verificationSchema)
+[log]   dist/env/index.mjs (total size: 8.42 kB, chunk size: 8.42 kB, exports: ENV, TTY_COLORS, createLogger, env, getBooleanEnvVar, getColorDepth, getEnvVar, isDevelopment, isProduction, isTest, levels, logger, nodeENV, shouldPublishLog)
+
+[log]   dist/oauth2/index.mjs (total size: 9.88 kB, chunk size: 9.88 kB, exports: clientCredentialsToken, createAuthorizationCodeRequest, createAuthorizationURL, createClientCredentialsTokenRequest, createRefreshAccessTokenRequest, generateCodeChallenge, getOAuth2Tokens, refreshAccessToken, validateAuthorizationCode, validateToken)
+
+[log]   dist/db/index.mjs (total size: 1.67 kB, chunk size: 1.67 kB, exports: accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema)
 
 [log]   dist/db/adapter/index.mjs (total size: 1 B, chunk size: 1 B)
-Σ Total dist size (byte size): 41.9 kB
+Σ Total dist size (byte size): 119 kB
 [log]

package/build.config.ts

@@ -13,5 +13,7 @@ export default defineBuildConfig({
 		"./src/db/index.ts",
 		"./src/db/adapter/index.ts",
 		"./src/async_hooks/index.ts",
+		"./src/env/index.ts",
+		"./src/oauth2/index.ts",
 	],
 });

package/dist/db/index.cjs

@@ -68,8 +68,24 @@ const verificationSchema = coreSchema.extend({
   identifier: z__namespace.string()
 });
 
+const rateLimitSchema = z__namespace.object({
+  /**
+   * The key to use for rate limiting
+   */
+  key: z__namespace.string(),
+  /**
+   * The number of requests made
+   */
+  count: z__namespace.number(),
+  /**
+   * The last request time in milliseconds
+   */
+  lastRequest: z__namespace.number()
+});
+
 exports.accountSchema = accountSchema;
 exports.coreSchema = coreSchema;
+exports.rateLimitSchema = rateLimitSchema;
 exports.sessionSchema = sessionSchema;
 exports.userSchema = userSchema;
 exports.verificationSchema = verificationSchema;

package/dist/db/index.d.cts

@@ -1,4 +1,5 @@
-import { D as DBFieldAttribute, b as DBFieldAttributeConfig, c as DBFieldType, d as DBPrimitive, B as BetterAuthDBSchema } from '../shared/core.CnvFgghY.cjs';
+import { D as DBFieldAttribute, b as DBFieldAttributeConfig, c as DBFieldType, d as DBPrimitive, B as BetterAuthDBSchema } from '../shared/core.DeNN5HMO.cjs';
+export { S as SecondaryStorage } from '../shared/core.DeNN5HMO.cjs';
 import * as z from 'zod';
 
 type BetterAuthPluginDBSchema = {
@@ -87,6 +88,16 @@ declare const verificationSchema: z.ZodObject<{
  */
 type Verification = z.infer<typeof verificationSchema>;
 
+declare const rateLimitSchema: z.ZodObject<{
+    key: z.ZodString;
+    count: z.ZodNumber;
+    lastRequest: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Rate limit schema type used by better-auth for rate limiting
+ */
+type RateLimit = z.infer<typeof rateLimitSchema>;
+
 /**
  * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
  */
@@ -112,5 +123,5 @@ type Primitive = DBPrimitive;
  */
 type BetterAuthDbSchema = BetterAuthDBSchema;
 
-export { BetterAuthDBSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, accountSchema, coreSchema, sessionSchema, userSchema, verificationSchema };
-export type { Account, AuthPluginSchema, BetterAuthDbSchema, BetterAuthPluginDBSchema, FieldAttribute, FieldAttributeConfig, FieldType, Primitive, Session, User, Verification };
+export { BetterAuthDBSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema };
+export type { Account, AuthPluginSchema, BetterAuthDbSchema, BetterAuthPluginDBSchema, FieldAttribute, FieldAttributeConfig, FieldType, Primitive, RateLimit, Session, User, Verification };

package/dist/db/index.d.mts

@@ -1,4 +1,5 @@
-import { D as DBFieldAttribute, b as DBFieldAttributeConfig, c as DBFieldType, d as DBPrimitive, B as BetterAuthDBSchema } from '../shared/core.CnvFgghY.mjs';
+import { D as DBFieldAttribute, b as DBFieldAttributeConfig, c as DBFieldType, d as DBPrimitive, B as BetterAuthDBSchema } from '../shared/core.DeNN5HMO.mjs';
+export { S as SecondaryStorage } from '../shared/core.DeNN5HMO.mjs';
 import * as z from 'zod';
 
 type BetterAuthPluginDBSchema = {
@@ -87,6 +88,16 @@ declare const verificationSchema: z.ZodObject<{
  */
 type Verification = z.infer<typeof verificationSchema>;
 
+declare const rateLimitSchema: z.ZodObject<{
+    key: z.ZodString;
+    count: z.ZodNumber;
+    lastRequest: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Rate limit schema type used by better-auth for rate limiting
+ */
+type RateLimit = z.infer<typeof rateLimitSchema>;
+
 /**
  * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
  */
@@ -112,5 +123,5 @@ type Primitive = DBPrimitive;
  */
 type BetterAuthDbSchema = BetterAuthDBSchema;
 
-export { BetterAuthDBSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, accountSchema, coreSchema, sessionSchema, userSchema, verificationSchema };
-export type { Account, AuthPluginSchema, BetterAuthDbSchema, BetterAuthPluginDBSchema, FieldAttribute, FieldAttributeConfig, FieldType, Primitive, Session, User, Verification };
+export { BetterAuthDBSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema };
+export type { Account, AuthPluginSchema, BetterAuthDbSchema, BetterAuthPluginDBSchema, FieldAttribute, FieldAttributeConfig, FieldType, Primitive, RateLimit, Session, User, Verification };

package/dist/db/index.d.ts

@@ -1,4 +1,5 @@
-import { D as DBFieldAttribute, b as DBFieldAttributeConfig, c as DBFieldType, d as DBPrimitive, B as BetterAuthDBSchema } from '../shared/core.CnvFgghY.js';
+import { D as DBFieldAttribute, b as DBFieldAttributeConfig, c as DBFieldType, d as DBPrimitive, B as BetterAuthDBSchema } from '../shared/core.DeNN5HMO.js';
+export { S as SecondaryStorage } from '../shared/core.DeNN5HMO.js';
 import * as z from 'zod';
 
 type BetterAuthPluginDBSchema = {
@@ -87,6 +88,16 @@ declare const verificationSchema: z.ZodObject<{
  */
 type Verification = z.infer<typeof verificationSchema>;
 
+declare const rateLimitSchema: z.ZodObject<{
+    key: z.ZodString;
+    count: z.ZodNumber;
+    lastRequest: z.ZodNumber;
+}, z.core.$strip>;
+/**
+ * Rate limit schema type used by better-auth for rate limiting
+ */
+type RateLimit = z.infer<typeof rateLimitSchema>;
+
 /**
  * @deprecated Backport for 1.3.x, we will remove this in 1.4.x
  */
@@ -112,5 +123,5 @@ type Primitive = DBPrimitive;
  */
 type BetterAuthDbSchema = BetterAuthDBSchema;
 
-export { BetterAuthDBSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, accountSchema, coreSchema, sessionSchema, userSchema, verificationSchema };
-export type { Account, AuthPluginSchema, BetterAuthDbSchema, BetterAuthPluginDBSchema, FieldAttribute, FieldAttributeConfig, FieldType, Primitive, Session, User, Verification };
+export { BetterAuthDBSchema, DBFieldAttribute, DBFieldAttributeConfig, DBFieldType, DBPrimitive, accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema };
+export type { Account, AuthPluginSchema, BetterAuthDbSchema, BetterAuthPluginDBSchema, FieldAttribute, FieldAttributeConfig, FieldType, Primitive, RateLimit, Session, User, Verification };

package/dist/db/index.mjs

@@ -52,4 +52,19 @@ const verificationSchema = coreSchema.extend({
   identifier: z.string()
 });
 
-export { accountSchema, coreSchema, sessionSchema, userSchema, verificationSchema };
+const rateLimitSchema = z.object({
+  /**
+   * The key to use for rate limiting
+   */
+  key: z.string(),
+  /**
+   * The number of requests made
+   */
+  count: z.number(),
+  /**
+   * The last request time in milliseconds
+   */
+  lastRequest: z.number()
+});
+
+export { accountSchema, coreSchema, rateLimitSchema, sessionSchema, userSchema, verificationSchema };

package/dist/env/index.cjs

@@ -0,0 +1,315 @@
+'use strict';
+
+const _envShim = /* @__PURE__ */ Object.create(null);
+const _getEnv = (useShim) => globalThis.process?.env || //@ts-expect-error
+globalThis.Deno?.env.toObject() || //@ts-expect-error
+globalThis.__env__ || (useShim ? _envShim : globalThis);
+const env = new Proxy(_envShim, {
+  get(_, prop) {
+    const env2 = _getEnv();
+    return env2[prop] ?? _envShim[prop];
+  },
+  has(_, prop) {
+    const env2 = _getEnv();
+    return prop in env2 || prop in _envShim;
+  },
+  set(_, prop, value) {
+    const env2 = _getEnv(true);
+    env2[prop] = value;
+    return true;
+  },
+  deleteProperty(_, prop) {
+    if (!prop) {
+      return false;
+    }
+    const env2 = _getEnv(true);
+    delete env2[prop];
+    return true;
+  },
+  ownKeys() {
+    const env2 = _getEnv(true);
+    return Object.keys(env2);
+  }
+});
+function toBoolean(val) {
+  return val ? val !== "false" : false;
+}
+const nodeENV = typeof process !== "undefined" && process.env && process.env.NODE_ENV || "";
+const isProduction = nodeENV === "production";
+const isDevelopment = nodeENV === "dev" || nodeENV === "development";
+const isTest = () => nodeENV === "test" || toBoolean(env.TEST);
+function getEnvVar(key, fallback) {
+  if (typeof process !== "undefined" && process.env) {
+    return process.env[key] ?? fallback;
+  }
+  if (typeof Deno !== "undefined") {
+    return Deno.env.get(key) ?? fallback;
+  }
+  if (typeof Bun !== "undefined") {
+    return Bun.env[key] ?? fallback;
+  }
+  return fallback;
+}
+function getBooleanEnvVar(key, fallback = true) {
+  const value = getEnvVar(key);
+  if (!value) return fallback;
+  return value !== "0" && value.toLowerCase() !== "false" && value !== "";
+}
+const ENV = Object.freeze({
+  get BETTER_AUTH_SECRET() {
+    return getEnvVar("BETTER_AUTH_SECRET");
+  },
+  get AUTH_SECRET() {
+    return getEnvVar("AUTH_SECRET");
+  },
+  get BETTER_AUTH_TELEMETRY() {
+    return getEnvVar("BETTER_AUTH_TELEMETRY");
+  },
+  get BETTER_AUTH_TELEMETRY_ID() {
+    return getEnvVar("BETTER_AUTH_TELEMETRY_ID");
+  },
+  get NODE_ENV() {
+    return getEnvVar("NODE_ENV", "development");
+  },
+  get PACKAGE_VERSION() {
+    return getEnvVar("PACKAGE_VERSION", "0.0.0");
+  },
+  get BETTER_AUTH_TELEMETRY_ENDPOINT() {
+    return getEnvVar(
+      "BETTER_AUTH_TELEMETRY_ENDPOINT",
+      "https://telemetry.better-auth.com/v1/track"
+    );
+  }
+});
+
+const COLORS_2 = 1;
+const COLORS_16 = 4;
+const COLORS_256 = 8;
+const COLORS_16m = 24;
+const TERM_ENVS = {
+  eterm: COLORS_16,
+  cons25: COLORS_16,
+  console: COLORS_16,
+  cygwin: COLORS_16,
+  dtterm: COLORS_16,
+  gnome: COLORS_16,
+  hurd: COLORS_16,
+  jfbterm: COLORS_16,
+  konsole: COLORS_16,
+  kterm: COLORS_16,
+  mlterm: COLORS_16,
+  mosh: COLORS_16m,
+  putty: COLORS_16,
+  st: COLORS_16,
+  // http://lists.schmorp.de/pipermail/rxvt-unicode/2016q2/002261.html
+  "rxvt-unicode-24bit": COLORS_16m,
+  // https://bugs.launchpad.net/terminator/+bug/1030562
+  terminator: COLORS_16m,
+  "xterm-kitty": COLORS_16m
+};
+const CI_ENVS_MAP = new Map(
+  Object.entries({
+    APPVEYOR: COLORS_256,
+    BUILDKITE: COLORS_256,
+    CIRCLECI: COLORS_16m,
+    DRONE: COLORS_256,
+    GITEA_ACTIONS: COLORS_16m,
+    GITHUB_ACTIONS: COLORS_16m,
+    GITLAB_CI: COLORS_256,
+    TRAVIS: COLORS_256
+  })
+);
+const TERM_ENVS_REG_EXP = [
+  /ansi/,
+  /color/,
+  /linux/,
+  /direct/,
+  /^con[0-9]*x[0-9]/,
+  /^rxvt/,
+  /^screen/,
+  /^xterm/,
+  /^vt100/,
+  /^vt220/
+];
+function getColorDepth() {
+  if (getEnvVar("FORCE_COLOR") !== void 0) {
+    switch (getEnvVar("FORCE_COLOR")) {
+      case "":
+      case "1":
+      case "true":
+        return COLORS_16;
+      case "2":
+        return COLORS_256;
+      case "3":
+        return COLORS_16m;
+      default:
+        return COLORS_2;
+    }
+  }
+  if (getEnvVar("NODE_DISABLE_COLORS") !== void 0 && getEnvVar("NODE_DISABLE_COLORS") !== "" || // See https://no-color.org/
+  getEnvVar("NO_COLOR") !== void 0 && getEnvVar("NO_COLOR") !== "" || // The "dumb" special terminal, as defined by terminfo, doesn't support
+  // ANSI color control codes.
+  // See https://invisible-island.net/ncurses/terminfo.ti.html#toc-_Specials
+  getEnvVar("TERM") === "dumb") {
+    return COLORS_2;
+  }
+  if (typeof process !== "undefined" && process.platform === "win32") {
+    return COLORS_16m;
+  }
+  if (getEnvVar("TMUX")) {
+    return COLORS_16m;
+  }
+  if ("TF_BUILD" in env && "AGENT_NAME" in env) {
+    return COLORS_16;
+  }
+  if ("CI" in env) {
+    for (const { 0: envName, 1: colors } of CI_ENVS_MAP) {
+      if (envName in env) {
+        return colors;
+      }
+    }
+    if (getEnvVar("CI_NAME") === "codeship") {
+      return COLORS_256;
+    }
+    return COLORS_2;
+  }
+  if ("TEAMCITY_VERSION" in env) {
+    return /^(9\.(0*[1-9]\d*)\.|\d{2,}\.)/.exec(
+      getEnvVar("TEAMCITY_VERSION")
+    ) !== null ? COLORS_16 : COLORS_2;
+  }
+  switch (getEnvVar("TERM_PROGRAM")) {
+    case "iTerm.app":
+      if (!getEnvVar("TERM_PROGRAM_VERSION") || /^[0-2]\./.exec(getEnvVar("TERM_PROGRAM_VERSION")) !== null) {
+        return COLORS_256;
+      }
+      return COLORS_16m;
+    case "HyperTerm":
+    case "MacTerm":
+      return COLORS_16m;
+    case "Apple_Terminal":
+      return COLORS_256;
+  }
+  if (getEnvVar("COLORTERM") === "truecolor" || getEnvVar("COLORTERM") === "24bit") {
+    return COLORS_16m;
+  }
+  if (getEnvVar("TERM")) {
+    if (/truecolor/.exec(getEnvVar("TERM")) !== null) {
+      return COLORS_16m;
+    }
+    if (/^xterm-256/.exec(getEnvVar("TERM")) !== null) {
+      return COLORS_256;
+    }
+    const termEnv = getEnvVar("TERM").toLowerCase();
+    if (TERM_ENVS[termEnv]) {
+      return TERM_ENVS[termEnv];
+    }
+    if (TERM_ENVS_REG_EXP.some((term) => term.exec(termEnv) !== null)) {
+      return COLORS_16;
+    }
+  }
+  if (getEnvVar("COLORTERM")) {
+    return COLORS_16;
+  }
+  return COLORS_2;
+}
+
+const TTY_COLORS = {
+  reset: "\x1B[0m",
+  bright: "\x1B[1m",
+  dim: "\x1B[2m",
+  undim: "\x1B[22m",
+  underscore: "\x1B[4m",
+  blink: "\x1B[5m",
+  reverse: "\x1B[7m",
+  hidden: "\x1B[8m",
+  fg: {
+    black: "\x1B[30m",
+    red: "\x1B[31m",
+    green: "\x1B[32m",
+    yellow: "\x1B[33m",
+    blue: "\x1B[34m",
+    magenta: "\x1B[35m",
+    cyan: "\x1B[36m",
+    white: "\x1B[37m"
+  },
+  bg: {
+    black: "\x1B[40m",
+    red: "\x1B[41m",
+    green: "\x1B[42m",
+    yellow: "\x1B[43m",
+    blue: "\x1B[44m",
+    magenta: "\x1B[45m",
+    cyan: "\x1B[46m",
+    white: "\x1B[47m"
+  }
+};
+const levels = ["info", "success", "warn", "error", "debug"];
+function shouldPublishLog(currentLogLevel, logLevel) {
+  return levels.indexOf(logLevel) <= levels.indexOf(currentLogLevel);
+}
+const levelColors = {
+  info: TTY_COLORS.fg.blue,
+  success: TTY_COLORS.fg.green,
+  warn: TTY_COLORS.fg.yellow,
+  error: TTY_COLORS.fg.red,
+  debug: TTY_COLORS.fg.magenta
+};
+const formatMessage = (level, message, colorsEnabled) => {
+  const timestamp = (/* @__PURE__ */ new Date()).toISOString();
+  if (colorsEnabled) {
+    return `${TTY_COLORS.dim}${timestamp}${TTY_COLORS.reset} ${levelColors[level]}${level.toUpperCase()}${TTY_COLORS.reset} ${TTY_COLORS.bright}[Better Auth]:${TTY_COLORS.reset} ${message}`;
+  }
+  return `${timestamp} ${level.toUpperCase()} [Better Auth]: ${message}`;
+};
+const createLogger = (options) => {
+  const enabled = options?.disabled !== true;
+  const logLevel = options?.level ?? "error";
+  const isDisableColorsSpecified = options?.disableColors !== void 0;
+  const colorsEnabled = isDisableColorsSpecified ? !options.disableColors : getColorDepth() !== 1;
+  const LogFunc = (level, message, args = []) => {
+    if (!enabled || !shouldPublishLog(logLevel, level)) {
+      return;
+    }
+    const formattedMessage = formatMessage(level, message, colorsEnabled);
+    if (!options || typeof options.log !== "function") {
+      if (level === "error") {
+        console.error(formattedMessage, ...args);
+      } else if (level === "warn") {
+        console.warn(formattedMessage, ...args);
+      } else {
+        console.log(formattedMessage, ...args);
+      }
+      return;
+    }
+    options.log(level === "success" ? "info" : level, message, ...args);
+  };
+  const logger2 = Object.fromEntries(
+    levels.map((level) => [
+      level,
+      (...[message, ...args]) => LogFunc(level, message, args)
+    ])
+  );
+  return {
+    ...logger2,
+    get level() {
+      return logLevel;
+    }
+  };
+};
+const logger = createLogger();
+
+exports.ENV = ENV;
+exports.TTY_COLORS = TTY_COLORS;
+exports.createLogger = createLogger;
+exports.env = env;
+exports.getBooleanEnvVar = getBooleanEnvVar;
+exports.getColorDepth = getColorDepth;
+exports.getEnvVar = getEnvVar;
+exports.isDevelopment = isDevelopment;
+exports.isProduction = isProduction;
+exports.isTest = isTest;
+exports.levels = levels;
+exports.logger = logger;
+exports.nodeENV = nodeENV;
+exports.shouldPublishLog = shouldPublishLog;

package/dist/env/index.d.cts

@@ -0,0 +1,85 @@
+type EnvObject = Record<string, string | undefined>;
+declare const env: EnvObject;
+declare const nodeENV: string;
+/** Detect if `NODE_ENV` environment variable is `production` */
+declare const isProduction: boolean;
+/** Detect if `NODE_ENV` environment variable is `dev` or `development` */
+declare const isDevelopment: boolean;
+/** Detect if `NODE_ENV` environment variable is `test` */
+declare const isTest: () => boolean;
+/**
+ * Get environment variable with fallback
+ */
+declare function getEnvVar<Fallback extends string>(key: string, fallback?: Fallback): Fallback extends string ? string : string | undefined;
+/**
+ * Get boolean environment variable
+ */
+declare function getBooleanEnvVar(key: string, fallback?: boolean): boolean;
+/**
+ * Common environment variables used in Better Auth
+ */
+declare const ENV: Readonly<{
+    readonly BETTER_AUTH_SECRET: string;
+    readonly AUTH_SECRET: string;
+    readonly BETTER_AUTH_TELEMETRY: string;
+    readonly BETTER_AUTH_TELEMETRY_ID: string;
+    readonly NODE_ENV: string;
+    readonly PACKAGE_VERSION: string;
+    readonly BETTER_AUTH_TELEMETRY_ENDPOINT: string;
+}>;
+
+declare function getColorDepth(): number;
+
+declare const TTY_COLORS: {
+    readonly reset: "\u001B[0m";
+    readonly bright: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly undim: "\u001B[22m";
+    readonly underscore: "\u001B[4m";
+    readonly blink: "\u001B[5m";
+    readonly reverse: "\u001B[7m";
+    readonly hidden: "\u001B[8m";
+    readonly fg: {
+        readonly black: "\u001B[30m";
+        readonly red: "\u001B[31m";
+        readonly green: "\u001B[32m";
+        readonly yellow: "\u001B[33m";
+        readonly blue: "\u001B[34m";
+        readonly magenta: "\u001B[35m";
+        readonly cyan: "\u001B[36m";
+        readonly white: "\u001B[37m";
+    };
+    readonly bg: {
+        readonly black: "\u001B[40m";
+        readonly red: "\u001B[41m";
+        readonly green: "\u001B[42m";
+        readonly yellow: "\u001B[43m";
+        readonly blue: "\u001B[44m";
+        readonly magenta: "\u001B[45m";
+        readonly cyan: "\u001B[46m";
+        readonly white: "\u001B[47m";
+    };
+};
+type LogLevel = "info" | "success" | "warn" | "error" | "debug";
+declare const levels: readonly ["info", "success", "warn", "error", "debug"];
+declare function shouldPublishLog(currentLogLevel: LogLevel, logLevel: LogLevel): boolean;
+interface Logger {
+    disabled?: boolean;
+    disableColors?: boolean;
+    level?: Exclude<LogLevel, "success">;
+    log?: (level: Exclude<LogLevel, "success">, message: string, ...args: any[]) => void;
+}
+type LogHandlerParams = Parameters<NonNullable<Logger["log"]>> extends [
+    LogLevel,
+    ...infer Rest
+] ? Rest : never;
+type InternalLogger = {
+    [K in LogLevel]: (...params: LogHandlerParams) => void;
+} & {
+    get level(): LogLevel;
+};
+declare const createLogger: (options?: Logger) => InternalLogger;
+declare const logger: InternalLogger;
+
+export { ENV, TTY_COLORS, createLogger, env, getBooleanEnvVar, getColorDepth, getEnvVar, isDevelopment, isProduction, isTest, levels, logger, nodeENV, shouldPublishLog };
+export type { EnvObject, InternalLogger, LogHandlerParams, LogLevel, Logger };

package/dist/env/index.d.mts

@@ -0,0 +1,85 @@
+type EnvObject = Record<string, string | undefined>;
+declare const env: EnvObject;
+declare const nodeENV: string;
+/** Detect if `NODE_ENV` environment variable is `production` */
+declare const isProduction: boolean;
+/** Detect if `NODE_ENV` environment variable is `dev` or `development` */
+declare const isDevelopment: boolean;
+/** Detect if `NODE_ENV` environment variable is `test` */
+declare const isTest: () => boolean;
+/**
+ * Get environment variable with fallback
+ */
+declare function getEnvVar<Fallback extends string>(key: string, fallback?: Fallback): Fallback extends string ? string : string | undefined;
+/**
+ * Get boolean environment variable
+ */
+declare function getBooleanEnvVar(key: string, fallback?: boolean): boolean;
+/**
+ * Common environment variables used in Better Auth
+ */
+declare const ENV: Readonly<{
+    readonly BETTER_AUTH_SECRET: string;
+    readonly AUTH_SECRET: string;
+    readonly BETTER_AUTH_TELEMETRY: string;
+    readonly BETTER_AUTH_TELEMETRY_ID: string;
+    readonly NODE_ENV: string;
+    readonly PACKAGE_VERSION: string;
+    readonly BETTER_AUTH_TELEMETRY_ENDPOINT: string;
+}>;
+
+declare function getColorDepth(): number;
+
+declare const TTY_COLORS: {
+    readonly reset: "\u001B[0m";
+    readonly bright: "\u001B[1m";
+    readonly dim: "\u001B[2m";
+    readonly undim: "\u001B[22m";
+    readonly underscore: "\u001B[4m";
+    readonly blink: "\u001B[5m";
+    readonly reverse: "\u001B[7m";
+    readonly hidden: "\u001B[8m";
+    readonly fg: {
+        readonly black: "\u001B[30m";
+        readonly red: "\u001B[31m";
+        readonly green: "\u001B[32m";
+        readonly yellow: "\u001B[33m";
+        readonly blue: "\u001B[34m";
+        readonly magenta: "\u001B[35m";
+        readonly cyan: "\u001B[36m";
+        readonly white: "\u001B[37m";
+    };
+    readonly bg: {
+        readonly black: "\u001B[40m";
+        readonly red: "\u001B[41m";
+        readonly green: "\u001B[42m";
+        readonly yellow: "\u001B[43m";
+        readonly blue: "\u001B[44m";
+        readonly magenta: "\u001B[45m";
+        readonly cyan: "\u001B[46m";
+        readonly white: "\u001B[47m";
+    };
+};
+type LogLevel = "info" | "success" | "warn" | "error" | "debug";
+declare const levels: readonly ["info", "success", "warn", "error", "debug"];
+declare function shouldPublishLog(currentLogLevel: LogLevel, logLevel: LogLevel): boolean;
+interface Logger {
+    disabled?: boolean;
+    disableColors?: boolean;
+    level?: Exclude<LogLevel, "success">;
+    log?: (level: Exclude<LogLevel, "success">, message: string, ...args: any[]) => void;
+}
+type LogHandlerParams = Parameters<NonNullable<Logger["log"]>> extends [
+    LogLevel,
+    ...infer Rest
+] ? Rest : never;
+type InternalLogger = {
+    [K in LogLevel]: (...params: LogHandlerParams) => void;
+} & {
+    get level(): LogLevel;
+};
+declare const createLogger: (options?: Logger) => InternalLogger;
+declare const logger: InternalLogger;
+
+export { ENV, TTY_COLORS, createLogger, env, getBooleanEnvVar, getColorDepth, getEnvVar, isDevelopment, isProduction, isTest, levels, logger, nodeENV, shouldPublishLog };
+export type { EnvObject, InternalLogger, LogHandlerParams, LogLevel, Logger };