@lunora/auth 1.0.0-alpha.2 → 1.0.0-alpha.21

package/dist/packem_shared/LunoraAuthAdminError-D4L7n6gN.mjs

@@ -0,0 +1,510 @@
+import { LunoraError } from '@lunora/errors';
+import { getAuthTables } from 'better-auth/db';
+
+class LunoraAuthAdminError extends LunoraError {
+  constructor(message, code) {
+    super(code, message, { name: "LunoraAuthAdminError" });
+  }
+}
+const DEFAULT_LIMIT = 50;
+const MAX_LIMIT = 500;
+const DEFAULT_IMPERSONATION_SECONDS = 3600;
+const MAX_IMPERSONATION_SECONDS = DEFAULT_IMPERSONATION_SECONDS * 24;
+const MAX_BAN_SECONDS = 100 * 365 * 24 * 60 * 60;
+const INVITATION_TTL_MS = 48 * 60 * 60 * 1e3;
+const SENSITIVE_FIELDS = /* @__PURE__ */ new Set(["accessToken", "backupCodes", "idToken", "password", "publicKey", "refreshToken", "secret", "token"]);
+const clampLimit = (limit) => Math.min(Math.max(Math.trunc(limit ?? DEFAULT_LIMIT), 1), MAX_LIMIT);
+const clampOffset = (offset) => Math.max(0, Math.trunc(offset ?? 0));
+const normalizeRow = (row) => {
+  const out = {};
+  for (const [key, value] of Object.entries(row)) {
+    if (SENSITIVE_FIELDS.has(key)) {
+      continue;
+    }
+    out[key] = value instanceof Date ? value.getTime() : value;
+  }
+  return out;
+};
+const serializeRole = (role) => Array.isArray(role) ? role.join(",") : role;
+const slugify = (value) => value.toLowerCase().replaceAll(/[^\da-z]+/g, "-").replaceAll(/^-|-$/g, "");
+const CORE_USER_FIELDS = /* @__PURE__ */ new Set(["banExpires", "banned", "banReason", "createdAt", "email", "emailVerified", "id", "name", "role", "updatedAt"]);
+const USER_FIELD_PLUGIN = {
+  displayUsername: "username",
+  phoneNumber: "phone-number",
+  phoneNumberVerified: "phone-number",
+  username: "username"
+};
+const mapUserFieldType = (type) => {
+  if (type === "boolean") {
+    return "boolean";
+  }
+  if (type === "date") {
+    return "date";
+  }
+  if (type === "number") {
+    return "number";
+  }
+  return "string";
+};
+const buildUserFields = (userFields) => {
+  const out = [];
+  for (const [name, attribute] of Object.entries(userFields)) {
+    if (attribute.input === false || attribute.references !== void 0 || CORE_USER_FIELDS.has(name)) {
+      continue;
+    }
+    out.push({
+      name,
+      plugin: USER_FIELD_PLUGIN[name],
+      required: attribute.required === true,
+      type: mapUserFieldType(attribute.type),
+      unique: attribute.unique === true
+    });
+  }
+  return out;
+};
+const asAdminError = (error) => {
+  if (error instanceof LunoraAuthAdminError) {
+    return error;
+  }
+  const candidate = error;
+  const code = candidate?.body?.code ?? candidate?.code ?? "AUTH_ADMIN_ERROR";
+  const message = candidate?.body?.message ?? candidate?.message ?? "auth admin operation failed";
+  return new LunoraAuthAdminError(message, code);
+};
+const createAuthAdmin = (auth, options = {}) => {
+  const context = auth.$context;
+  const features = options.features ?? {};
+  const withContext = async (function_) => {
+    try {
+      return await function_(await context);
+    } catch (error) {
+      throw asAdminError(error);
+    }
+  };
+  const toUser = (row) => normalizeRow(row);
+  const page = async (context_, model, options_) => {
+    const where = options_.where && options_.where.length > 0 ? options_.where : void 0;
+    const [rows, total] = await Promise.all([
+      context_.adapter.findMany({
+        limit: clampLimit(options_.limit),
+        model,
+        offset: clampOffset(options_.offset),
+        sortBy: options_.sortBy,
+        where
+      }),
+      context_.adapter.count({ model, where })
+    ]);
+    return { rows: rows.map((row) => normalizeRow(row)), total };
+  };
+  return {
+    banUser: ({ expiresInSeconds, reason, userId }) => withContext(async (context_) => {
+      const seconds = typeof expiresInSeconds === "number" && Number.isFinite(expiresInSeconds) ? Math.min(Math.trunc(expiresInSeconds), MAX_BAN_SECONDS) : 0;
+      const banExpires = seconds > 0 ? new Date(Date.now() + seconds * 1e3) : void 0;
+      const user = await context_.internalAdapter.updateUser(userId, {
+        banExpires,
+        banned: true,
+        banReason: reason ?? "No reason"
+      });
+      await context_.internalAdapter.deleteUserSessions(userId);
+      return toUser(user);
+    }),
+    cancelInvitation: ({ invitationId }) => withContext(async (context_) => {
+      await context_.adapter.delete({ model: "invitation", where: [{ field: "id", value: invitationId }] });
+    }),
+    capabilities: () => withContext((context_) => {
+      const ids = new Set((context_.options.plugins ?? []).map((plugin) => plugin.id));
+      const has = (id) => ids.has(id);
+      return Promise.resolve({
+        accounts: features.accounts ?? true,
+        admin: features.admin ?? has("admin"),
+        organization: features.organization ?? has("organization"),
+        passkey: features.passkey ?? has("passkey"),
+        twoFactor: features.twoFactor ?? has("two-factor")
+      });
+    }),
+    // ── Directly add an existing user to an org (no invitation/acceptance). ──
+    addMember: ({ organizationId, role, userId }) => withContext(async (context_) => {
+      const member = await context_.adapter.create({
+        data: { createdAt: /* @__PURE__ */ new Date(), organizationId, role: role === void 0 || role === "" ? "member" : role, userId },
+        model: "member"
+      });
+      return normalizeRow(member);
+    }),
+    addTeamMember: ({ teamId, userId }) => withContext(async (context_) => {
+      const teamMember = await context_.adapter.create({
+        data: { createdAt: /* @__PURE__ */ new Date(), teamId, userId },
+        model: "teamMember"
+      });
+      return normalizeRow(teamMember);
+    }),
+    // Rich introspection for the config panel + dynamic create-user form. Reads
+    // only from the resolved better-auth options (no DB, no secrets).
+    config: () => withContext((context_) => {
+      const authOptions = context_.options;
+      const ids = new Set((authOptions.plugins ?? []).map((plugin) => plugin.id));
+      const has = (id) => ids.has(id);
+      const capabilities = {
+        accounts: features.accounts ?? true,
+        admin: features.admin ?? has("admin"),
+        organization: features.organization ?? has("organization"),
+        passkey: features.passkey ?? has("passkey"),
+        twoFactor: features.twoFactor ?? has("two-factor")
+      };
+      const tables = getAuthTables(authOptions);
+      const session = authOptions.session ?? {};
+      const rateLimit = authOptions.rateLimit ?? {};
+      return Promise.resolve({
+        capabilities,
+        emailAndPassword: authOptions.emailAndPassword?.enabled ?? false,
+        organization: {
+          enabled: capabilities.organization,
+          roles: Boolean(tables["organizationRole"]),
+          teams: Boolean(tables["team"])
+        },
+        plugins: [...ids].toSorted((a, b) => a.localeCompare(b)),
+        rateLimit: { enabled: rateLimit.enabled ?? false, max: rateLimit.max, window: rateLimit.window },
+        session: {
+          cookieCache: session.cookieCache?.enabled,
+          expiresIn: session.expiresIn,
+          freshAge: session.freshAge,
+          updateAge: session.updateAge
+        },
+        socialProviders: Object.keys(authOptions.socialProviders ?? {}).toSorted((a, b) => a.localeCompare(b)),
+        userFields: buildUserFields(tables["user"]?.fields ?? {})
+      });
+    }),
+    createOrganization: ({ logo, metadata, name, ownerId, slug }) => withContext(async (context_) => {
+      const finalSlug = slug !== void 0 && slug !== "" ? slugify(slug) : slugify(name);
+      if (finalSlug === "") {
+        throw new LunoraAuthAdminError("could not derive a slug from the organization name", "ORG_SLUG_INVALID");
+      }
+      const existing = await context_.adapter.findOne({
+        model: "organization",
+        where: [{ field: "slug", value: finalSlug }]
+      });
+      if (existing) {
+        throw new LunoraAuthAdminError("an organization with this slug already exists", "ORG_SLUG_TAKEN");
+      }
+      const organization = await context_.adapter.create({
+        data: {
+          createdAt: /* @__PURE__ */ new Date(),
+          logo: logo === void 0 || logo === "" ? void 0 : logo,
+          metadata: metadata === void 0 ? void 0 : JSON.stringify(metadata),
+          name,
+          slug: finalSlug
+        },
+        model: "organization"
+      });
+      if (ownerId !== void 0 && ownerId !== "") {
+        await context_.adapter.create({
+          data: { createdAt: /* @__PURE__ */ new Date(), organizationId: organization.id, role: "owner", userId: ownerId },
+          model: "member"
+        });
+      }
+      return normalizeRow(organization);
+    }),
+    createOrgRole: ({ organizationId, permission, role }) => withContext(async (context_) => {
+      const created = await context_.adapter.create({
+        data: { createdAt: /* @__PURE__ */ new Date(), organizationId, permission: JSON.stringify(permission), role },
+        model: "organizationRole"
+      });
+      return normalizeRow(created);
+    }),
+    createTeam: ({ name, organizationId }) => withContext(async (context_) => {
+      const team = await context_.adapter.create({
+        data: { createdAt: /* @__PURE__ */ new Date(), name, organizationId },
+        model: "team"
+      });
+      return normalizeRow(team);
+    }),
+    deleteOrganization: ({ organizationId }) => withContext(async (context_) => {
+      const tables = getAuthTables(context_.options);
+      await context_.adapter.deleteMany({ model: "member", where: [{ field: "organizationId", value: organizationId }] });
+      await context_.adapter.deleteMany({ model: "invitation", where: [{ field: "organizationId", value: organizationId }] });
+      if (tables["team"]) {
+        const teams = await context_.adapter.findMany({
+          model: "team",
+          where: [{ field: "organizationId", value: organizationId }]
+        });
+        for (const team of teams) {
+          await context_.adapter.deleteMany({ model: "teamMember", where: [{ field: "teamId", value: team.id }] });
+        }
+        await context_.adapter.deleteMany({ model: "team", where: [{ field: "organizationId", value: organizationId }] });
+      }
+      if (tables["organizationRole"]) {
+        await context_.adapter.deleteMany({ model: "organizationRole", where: [{ field: "organizationId", value: organizationId }] });
+      }
+      await context_.adapter.delete({ model: "organization", where: [{ field: "id", value: organizationId }] });
+    }),
+    deleteOrgRole: ({ roleId }) => withContext(async (context_) => {
+      await context_.adapter.delete({ model: "organizationRole", where: [{ field: "id", value: roleId }] });
+    }),
+    // Create a pending email invitation. `inviterId` is DB-required; when the
+    // caller omits it, attribute the invite to the org's owner (else any member).
+    inviteMember: ({ email, inviterId, organizationId, role }) => withContext(async (context_) => {
+      let resolvedInviter = inviterId;
+      if (resolvedInviter === void 0 || resolvedInviter === "") {
+        const members = await context_.adapter.findMany({
+          model: "member",
+          where: [{ field: "organizationId", value: organizationId }]
+        });
+        const owner = members.find((member) => typeof member.role === "string" && member.role.includes("owner"));
+        resolvedInviter = (owner ?? members[0])?.userId;
+      }
+      if (resolvedInviter === void 0 || resolvedInviter === "") {
+        throw new LunoraAuthAdminError("provide an inviter — the organization has no members to attribute the invitation to", "INVITER_REQUIRED");
+      }
+      const invitation = await context_.adapter.create({
+        data: {
+          createdAt: /* @__PURE__ */ new Date(),
+          email: email.toLowerCase(),
+          expiresAt: new Date(Date.now() + INVITATION_TTL_MS),
+          inviterId: resolvedInviter,
+          organizationId,
+          role: role === void 0 || role === "" ? "member" : role,
+          status: "pending"
+        },
+        model: "invitation"
+      });
+      return normalizeRow(invitation);
+    }),
+    listOrgRoles: ({ limit, offset, organizationId }) => withContext(
+      (context_) => page(context_, "organizationRole", {
+        limit,
+        offset,
+        sortBy: { direction: "desc", field: "createdAt" },
+        where: [{ field: "organizationId", value: organizationId }]
+      })
+    ),
+    listTeamMembers: ({ limit, offset, teamId }) => withContext(
+      (context_) => page(context_, "teamMember", {
+        limit,
+        offset,
+        where: [{ field: "teamId", value: teamId }]
+      })
+    ),
+    listTeams: ({ limit, offset, organizationId }) => withContext(
+      (context_) => page(context_, "team", {
+        limit,
+        offset,
+        sortBy: { direction: "desc", field: "createdAt" },
+        where: [{ field: "organizationId", value: organizationId }]
+      })
+    ),
+    removeTeam: ({ teamId }) => withContext(async (context_) => {
+      await context_.adapter.deleteMany({ model: "teamMember", where: [{ field: "teamId", value: teamId }] });
+      await context_.adapter.delete({ model: "team", where: [{ field: "id", value: teamId }] });
+    }),
+    removeTeamMember: ({ teamMemberId }) => withContext(async (context_) => {
+      await context_.adapter.delete({ model: "teamMember", where: [{ field: "id", value: teamMemberId }] });
+    }),
+    updateMemberRole: ({ memberId, role }) => withContext(async (context_) => {
+      const member = await context_.adapter.update({
+        model: "member",
+        update: { role: serializeRole(role) },
+        where: [{ field: "id", value: memberId }]
+      });
+      return normalizeRow(member ?? { id: memberId, role: serializeRole(role) });
+    }),
+    updateOrganization: ({ logo, metadata, name, organizationId, slug }) => withContext(async (context_) => {
+      const update = {};
+      if (name !== void 0) {
+        update["name"] = name;
+      }
+      if (slug !== void 0 && slug !== "") {
+        update["slug"] = slugify(slug);
+      }
+      if (logo !== void 0) {
+        update["logo"] = logo === "" ? void 0 : logo;
+      }
+      if (metadata !== void 0) {
+        update["metadata"] = JSON.stringify(metadata);
+      }
+      if (Object.keys(update).length === 0) {
+        return normalizeRow({ id: organizationId });
+      }
+      const organization = await context_.adapter.update({
+        model: "organization",
+        update,
+        where: [{ field: "id", value: organizationId }]
+      });
+      return normalizeRow(organization ?? { id: organizationId });
+    }),
+    updateOrgRole: ({ permission, roleId }) => withContext(async (context_) => {
+      const updated = await context_.adapter.update({
+        model: "organizationRole",
+        update: { permission: JSON.stringify(permission), updatedAt: /* @__PURE__ */ new Date() },
+        where: [{ field: "id", value: roleId }]
+      });
+      return normalizeRow(updated ?? { id: roleId, permission: JSON.stringify(permission) });
+    }),
+    updateTeam: ({ name, teamId }) => withContext(async (context_) => {
+      const team = await context_.adapter.update({
+        model: "team",
+        update: { name, updatedAt: /* @__PURE__ */ new Date() },
+        where: [{ field: "id", value: teamId }]
+      });
+      return normalizeRow(team ?? { id: teamId, name });
+    }),
+    // The one op that genuinely builds a row rather than mutating one. Replicates
+    // the plugin's create-user handler over `internalAdapter` (lowercase + dedupe
+    // email, create the row, then link a credential account when a password is given).
+    createUser: ({ data, email, name, password, role }) => withContext(async (context_) => {
+      const normalizedEmail = email.toLowerCase();
+      if (await context_.internalAdapter.findUserByEmail(normalizedEmail)) {
+        throw new LunoraAuthAdminError("a user with this email already exists", "USER_ALREADY_EXISTS");
+      }
+      const user = await context_.internalAdapter.createUser({
+        email: normalizedEmail,
+        name,
+        role: role === void 0 ? void 0 : serializeRole(role),
+        ...data
+      });
+      if (password !== void 0 && password !== "") {
+        const hashed = await context_.password.hash(password);
+        await context_.internalAdapter.linkAccount({
+          accountId: user.id,
+          password: hashed,
+          providerId: "credential",
+          userId: user.id
+        });
+      }
+      return toUser(user);
+    }),
+    deletePasskey: ({ passkeyId }) => withContext(async (context_) => {
+      await context_.adapter.delete({ model: "passkey", where: [{ field: "id", value: passkeyId }] });
+    }),
+    disableTwoFactor: ({ userId }) => withContext(async (context_) => {
+      await context_.adapter.deleteMany({ model: "twoFactor", where: [{ field: "userId", value: userId }] });
+      await context_.internalAdapter.updateUser(userId, { twoFactorEnabled: false });
+    }),
+    impersonateUser: ({ userId }) => withContext(async (context_) => {
+      const user = await context_.internalAdapter.findUserById(userId);
+      if (!user) {
+        throw new LunoraAuthAdminError("user not found", "USER_NOT_FOUND");
+      }
+      const rawSeconds = options.impersonationSeconds;
+      let ttlSeconds = DEFAULT_IMPERSONATION_SECONDS;
+      if (rawSeconds !== void 0) {
+        if (!Number.isInteger(rawSeconds) || !Number.isFinite(rawSeconds) || rawSeconds <= 0) {
+          throw new LunoraAuthAdminError("impersonationSeconds must be a positive finite integer", "INVALID_IMPERSONATION_SECONDS");
+        }
+        ttlSeconds = Math.min(rawSeconds, MAX_IMPERSONATION_SECONDS);
+      }
+      const expiresAt = new Date(Date.now() + ttlSeconds * 1e3);
+      const session = await context_.internalAdapter.createSession(
+        userId,
+        true,
+        { expiresAt, impersonatedBy: options.impersonatedBy ?? userId },
+        true
+      );
+      return {
+        expiresAt: session.expiresAt instanceof Date ? session.expiresAt.getTime() : expiresAt.getTime(),
+        token: session.token,
+        user: toUser(user)
+      };
+    }),
+    listAccounts: ({ userId }) => withContext(async (context_) => {
+      const rows = await context_.adapter.findMany({ model: "account", where: [{ field: "userId", value: userId }] });
+      return rows.map((row) => normalizeRow(row));
+    }),
+    listInvitations: ({ limit, offset, organizationId }) => withContext(
+      (context_) => page(context_, "invitation", {
+        limit,
+        offset,
+        where: [{ field: "organizationId", value: organizationId }]
+      })
+    ),
+    listMembers: ({ limit, offset, organizationId }) => withContext(
+      (context_) => page(context_, "member", {
+        limit,
+        offset,
+        sortBy: { direction: "desc", field: "createdAt" },
+        where: [{ field: "organizationId", value: organizationId }]
+      })
+    ),
+    listOrganizations: ({ limit, offset }) => withContext((context_) => page(context_, "organization", { limit, offset, sortBy: { direction: "desc", field: "createdAt" } })),
+    listPasskeys: ({ userId }) => withContext(async (context_) => {
+      const rows = await context_.adapter.findMany({ model: "passkey", where: [{ field: "userId", value: userId }] });
+      return rows.map((row) => normalizeRow(row));
+    }),
+    listSessions: ({ limit, offset, userId }) => withContext(
+      (context_) => page(context_, "session", {
+        limit,
+        offset,
+        sortBy: { direction: "desc", field: "createdAt" },
+        where: userId === void 0 || userId === "" ? void 0 : [{ field: "userId", value: userId }]
+      })
+    ),
+    listUsers: ({ filterField, filterValue, limit, offset, search, searchField, sortBy, sortDirection }) => withContext((context_) => {
+      const where = [];
+      if (search !== void 0 && search !== "") {
+        where.push({ field: searchField ?? "email", operator: "contains", value: search });
+      }
+      if (filterValue !== void 0) {
+        where.push({ field: filterField ?? "email", operator: "eq", value: filterValue });
+      }
+      return page(context_, "user", {
+        limit,
+        offset,
+        sortBy: { direction: sortDirection ?? "desc", field: sortBy ?? "createdAt" },
+        where
+      });
+    }),
+    removeMember: ({ memberId }) => withContext(async (context_) => {
+      await context_.adapter.delete({ model: "member", where: [{ field: "id", value: memberId }] });
+    }),
+    removeUser: ({ userId }) => withContext(async (context_) => {
+      await context_.internalAdapter.deleteUserSessions(userId);
+      await context_.internalAdapter.deleteUser(userId);
+    }),
+    // Keyed on the session *id*, not its token: tokens are bearer credentials we
+    // deliberately never surface to the studio. Resolve the row to recover its
+    // token, then delete via `internalAdapter.deleteSession` — which also clears
+    // secondary (KV) storage, unlike a raw `adapter.delete` on the DB row.
+    revokeUserSession: ({ sessionId }) => withContext(async (context_) => {
+      const session = await context_.adapter.findOne({ model: "session", where: [{ field: "id", value: sessionId }] });
+      if (session?.token) {
+        await context_.internalAdapter.deleteSession(session.token);
+      }
+    }),
+    revokeUserSessions: ({ userId }) => withContext(async (context_) => {
+      await context_.internalAdapter.deleteUserSessions(userId);
+    }),
+    setRole: ({ role, userId }) => withContext(async (context_) => {
+      const user = await context_.internalAdapter.updateUser(userId, { role: serializeRole(role) });
+      return toUser(user);
+    }),
+    setUserPassword: ({ newPassword, userId }) => withContext(async (context_) => {
+      const min = context_.password.config.minPasswordLength;
+      const max = context_.password.config.maxPasswordLength;
+      if (newPassword.length < min) {
+        throw new LunoraAuthAdminError(`password must be at least ${min.toString()} characters`, "PASSWORD_TOO_SHORT");
+      }
+      if (newPassword.length > max) {
+        throw new LunoraAuthAdminError(`password must be at most ${max.toString()} characters`, "PASSWORD_TOO_LONG");
+      }
+      const hashed = await context_.password.hash(newPassword);
+      await context_.internalAdapter.updatePassword(userId, hashed);
+    }),
+    unbanUser: ({ userId }) => withContext(async (context_) => {
+      const user = await context_.internalAdapter.updateUser(userId, { banExpires: null, banned: false, banReason: null });
+      return toUser(user);
+    }),
+    unlinkAccount: ({ accountId, userId }) => withContext(async (context_) => {
+      await context_.adapter.delete({
+        model: "account",
+        where: [
+          { field: "id", value: accountId },
+          { connector: "AND", field: "userId", value: userId }
+        ]
+      });
+    }),
+    updateUser: ({ data, userId }) => withContext(async (context_) => {
+      const user = await context_.internalAdapter.updateUser(userId, data);
+      return toUser(user);
+    })
+  };
+};
+
+export { LunoraAuthAdminError, createAuthAdmin };

package/dist/packem_shared/{compileMigrationsSql-wZH3oXDu.mjs → compileMigrationsSql-B9bj-mJv.mjs}

@@ -1,4 +1,5 @@
 import { getMigrations } from 'better-auth/db/migration';
+import { resolveAuthOptions } from './createAuth-BVMMllTm.mjs';
 
 const migrating = /* @__PURE__ */ new WeakMap();
 const ensureMigrated = async (auth) => {
@@ -21,7 +22,7 @@ const ensureMigrated = async (auth) => {
   }
 };
 const compileMigrationsSql = async (options) => {
-  const { compileMigrations } = await getMigrations(options);
+  const { compileMigrations } = await getMigrations(resolveAuthOptions(options));
   return compileMigrations();
 };
 

package/dist/packem_shared/create-auth.d-Mwhb4gSc.d.mts

@@ -0,0 +1,128 @@
+import { betterAuth, BetterAuthOptions } from 'better-auth';
+/**
+* Lunora's options pass straight through to better-auth — the only thing we add
+* is requiring `secret` up front so a misconfigured deployment fails loudly
+* instead of at the first sign-in.
+*
+* For `database`, prefer `lunoraD1Adapter` (`database: lunoraD1Adapter(env.DB)`)
+* over passing the raw `env.DB`. better-auth *does* accept a D1Database directly,
+* but it then resolves its Kysely adapter via a runtime `await import(...)` inside
+* `auth.$context` — and that import never settles under `@cloudflare/vite-plugin`'s
+* worker runner, hanging every auth request in `pnpm dev`. The explicit adapter
+* skips it, so dev and prod behave the same. (Raw `env.DB` is still correct for
+* the migration-only instance — see `lunoraD1Adapter`'s note.)
+*
+* Session rotation / richer session policies are configured via the `session`
+* field (a `SessionPolicy`); Lunora validates it for obviously-broken
+* durations and forwards it verbatim to better-auth. See `sessionPresets`
+* for ready-made rotation/expiry trade-offs.
+*
+* ## Serverless background tasks (Cloudflare Workers)
+*
+* better-auth runs some work *after* sending the response — most importantly the
+* password-reset email, whose background send is what keeps reset responses
+* constant-time (a timing-attack defence: the response doesn't reveal whether
+* the account exists). On Cloudflare Workers a promise that isn't handed to
+* `ctx.waitUntil` can be cancelled the moment the response returns, dropping
+* that send and weakening the guarantee. Wire your request's `ctx.waitUntil`
+* into better-auth's background handler so the work survives:
+*
+* ```ts
+* // in your worker fetch handler, where `ctx: ExecutionContext` is in scope
+* const auth = createAuth({
+*     secret: env.AUTH_SECRET,
+*     database: lunoraD1Adapter(env.DB),
+*     advanced: {
+*         backgroundTasks: { handler: (promise) => ctx.waitUntil(promise) },
+*     },
+* });
+* ```
+*
+* (Lunora can't set this for you — `ctx.waitUntil` is per-request, but
+* `createAuth` runs once at worker setup.)
+*/
+type LunoraAuthOptions = BetterAuthOptions;
+/**
+* The full better-auth instance: `auth.handler` accepts a `Request` and
+* returns a `Response` (used by `handleAuthRequest`); `auth.api`
+* exposes the typed endpoint surface for server-side calls (e.g.
+* `auth.api.getSession({ headers })` inside a query/mutation).
+*/
+type LunoraAuth = ReturnType<typeof betterAuth>;
+/**
+* Resolve the caller's options into the exact shape `createAuth` hands to
+* `betterAuth` — the hardened, default-filled options the running worker uses.
+* Exported (and pure) so the migration path can compile the schema from the
+* same resolved options: `compileMigrationsSql` routes through here, so the
+* `rateLimit` table the worker's durable limiter writes to is included in the
+* migration rather than silently omitted (it would be, if migrations saw the
+* raw options while the worker ran the resolved ones).
+*
+* ## What it fills (each gated independently on caller silence)
+*
+* Secure-by-default cookies + secret-strength warning via {@link hardenAuthOptions},
+* applied first so all hardening composes onto one options object.
+*
+* Rate limiting is ON by default for `/api/auth/*`.
+*
+* better-auth's own default is `rateLimit.enabled ?? isProduction`, and its
+* `isProduction` is `"development" === "production"` resolved at
+* module-load time. On Cloudflare Workers that check is unreliable: the
+* runtime has no Node `process.env` (absent entirely without
+* `nodejs_compat`, and even with it `NODE_ENV` is rarely `"production"` at
+* request time). So better-auth would silently leave auth endpoints
+* _unthrottled_ on a real deployment — the surprise we refuse to ship.
+*
+* We therefore default `enabled: true` whenever the caller hasn't made an
+* explicit choice. We only fill the `enabled` flag and otherwise forward
+* the caller's `rateLimit` verbatim, so better-auth's `window` (10s) / `max`
+* (100) defaults and any custom rules still apply. Callers who genuinely
+* want it off can pass `rateLimit: { enabled: false }` (e.g. when fronting
+* auth with their own limiter), and any explicit `enabled` value wins.
+*
+* We also default `storage: "database"` — but only when rate limiting is not
+* explicitly disabled (`enabled !== false`). Filling storage under a disabled
+* limiter is harmless at runtime but makes `getAuthTables` emit an unused
+* `rateLimit` table, so we skip it there.
+*
+* better-auth's own default is `storage: "memory"` — a per-isolate,
+* non-durable counter. On Cloudflare Workers that means each isolate keeps
+* its own tally, counters vanish on isolate recycle, and traffic spread
+* across isolates never sums to the configured `max` — a limiter that
+* reports "enabled" while never enforcing a global limit (the exact
+* brute-force / credential-stuffing protection on `/sign-in`, OTP, and
+* password-reset it is meant to buy). `storage: "database"` rides the counter
+* through the configured `database` adapter — Lunora's store over the D1 auth
+* tables — so the limit is durable *and* atomic (the store's native
+* `incrementOne` gives a one-winner guarantee across isolates). Callers with
+* their own durable store can pass an explicit `rateLimit: { storage: … }`
+* (or `customStorage`), and any explicit value wins.
+*
+* Session cookie cache is ON by default too.
+*
+* Every authenticated call resolves identity through better-auth's
+* `getSession`, which — without a cache — is a DB (D1) read on the hot path
+* of every query/mutation/action that reads `ctx.auth` and of the WebSocket
+* upgrade. better-auth's `session.cookieCache` carries the session payload in
+* a short-lived signed cookie so `getSession` can answer without hitting the
+* database until the cache window elapses. We default it on with a
+* deliberately short 60s `maxAge` (better-auth's own default is 300s): long
+* enough to erase the per-request read for a burst of calls, short enough
+* that a revoked or role-changed session self-corrects within a minute.
+* The one tradeoff — a revoked session stays valid until the cache expires —
+* is bounded by that TTL; callers who need immediate revocation opt out with
+* `session: { cookieCache: { enabled: false } }` (or the `strict` preset).
+*
+* Every explicit caller value is forwarded verbatim. The two `rateLimit` fills
+* merge into a single `rateLimit` object so neither clobbers the other.
+*/
+declare const resolveAuthOptions: (options: LunoraAuthOptions) => LunoraAuthOptions;
+/**
+* Create the auth instance. Thin wrapper around `betterAuth` that enforces
+* the `secret` requirement at construction time so misconfigured deployments
+* fail loudly at the first fetch rather than the first sign-in attempt, then
+* hands {@link resolveAuthOptions}'s hardened, default-filled options to
+* better-auth.
+*/
+declare const createAuth: (options: LunoraAuthOptions) => LunoraAuth;
+export { LunoraAuth as L, LunoraAuthOptions as a, createAuth as c, resolveAuthOptions as r };