@robelest/convex-auth 0.0.4-preview.2 → 0.0.4-preview.21

package/dist/component/server/runtime.d.ts

@@ -0,0 +1,136 @@
+import { ConvexAuthConfig, Doc, SessionInfo } from "./types.js";
+import * as convex_server25 from "convex/server";
+import * as convex_values926 from "convex/values";
+
+//#region src/server/runtime.d.ts
+/**
+ * Configure the Convex Auth library. Returns an object with
+ * functions and `auth` helper. You must export the functions
+ * from `convex/auth.ts` to make them callable:
+ *
+ * ```ts filename="convex/auth.ts"
+ * import { createAuth } from "@robelest/convex-auth/component";
+ * import { components } from "./_generated/api";
+ *
+ * export const auth = createAuth(components.auth, {
+ *   providers: [],
+ * });
+ * export const { signIn, signOut, store } = auth;
+ * ```
+ *
+ * @returns An object with fields you should reexport from your
+ *          `convex/auth.ts` file.
+ */
+declare function Auth(config_: ConvexAuthConfig): {
+  /**
+   * Helper for configuring HTTP actions.
+   */
+  auth: any;
+  /**
+   * Action called by the client to sign the user in.
+   *
+   * Also used for refreshing the session.
+   */
+  signIn: convex_server25.RegisteredAction<"public", {
+    provider?: string | undefined;
+    verifier?: string | undefined;
+    params?: any;
+    refreshToken?: string | undefined;
+    calledBy?: string | undefined;
+  }, Promise<SignInActionResult>>;
+  /**
+   * Action called by the client to invalidate the current session.
+   */
+  signOut: convex_server25.RegisteredAction<"public", {}, Promise<void>>;
+  /**
+   * Internal mutation used by the library to read and write
+   * to the database during signin and signout.
+   */
+  store: convex_server25.RegisteredMutation<"internal", {
+    args: {
+      sessionId?: string | undefined;
+      userId: string;
+      type: "signIn";
+      generateTokens: boolean;
+    } | {
+      type: "signOut";
+    } | {
+      type: "refreshSession";
+      refreshToken: string;
+    } | {
+      provider?: string | undefined;
+      verifier?: string | undefined;
+      type: "verifyCodeAndSignIn";
+      params: any;
+      generateTokens: boolean;
+      allowExtraProviders: boolean;
+    } | {
+      type: "verifier";
+    } | {
+      type: "verifierSignature";
+      verifier: string;
+      signature: string;
+    } | {
+      accountExtend?: any;
+      type: "userOAuth";
+      provider: string;
+      providerAccountId: string;
+      signature: string;
+      profile: any;
+    } | {
+      email?: string | undefined;
+      phone?: string | undefined;
+      accountId?: string | undefined;
+      type: "createVerificationCode";
+      expirationTime: number;
+      provider: string;
+      code: string;
+      allowExtraProviders: boolean;
+    } | {
+      shouldLinkViaEmail?: boolean | undefined;
+      shouldLinkViaPhone?: boolean | undefined;
+      type: "createAccountFromCredentials";
+      provider: string;
+      profile: any;
+      account: {
+        secret?: string | undefined;
+        id: string;
+      };
+    } | {
+      type: "retrieveAccountWithCredentials";
+      provider: string;
+      account: {
+        secret?: string | undefined;
+        id: string;
+      };
+    } | {
+      type: "modifyAccount";
+      provider: string;
+      account: {
+        id: string;
+        secret: string;
+      };
+    } | {
+      except?: string[] | undefined;
+      userId: string;
+      type: "invalidateSessions";
+    };
+  }, Promise<string | void | {
+    userId: convex_values926.GenericId<"User">;
+    sessionId: convex_values926.GenericId<"Session">;
+  } | (string & {
+    __tableName: "AuthVerifier";
+  }) | SessionInfo | {
+    token: string;
+    refreshToken: string;
+  } | {
+    account: Doc<"Account">;
+    user: Doc<"User">;
+  } | {
+    account: Doc<"Account">;
+    user: Doc<"User">;
+  } | null>>;
+};
+//#endregion
+export { Auth };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/component/server/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","names":[],"sources":["../../../src/server/runtime.ts"],"mappings":";;;;;;;;;AAqJA;;;;;;;;;;;;;;iBAAgB,IAAA,CAAK,OAAA,EAAS,gBAAA"}

package/dist/component/server/runtime.js

@@ -0,0 +1,413 @@
+import { AuthError } from "./authError.js";
+import { LOG_LEVELS, decryptSecret, encryptSecret, generateRandomString, logError, logWithLevel, requireEnv, sha256 } from "./utils.js";
+import { configDefaults, listAvailableProviders } from "./config.js";
+import { callModifyAccount } from "./mutations/account.js";
+import { callInvalidateSessions } from "./mutations/invalidate.js";
+import { enterpriseOidcProviderId, getEnterpriseOidcUrls, isEnterpriseSamlSourceActive, normalizeDomain } from "./enterprise/shared.js";
+import { normalizeEnterprisePolicy, patchEnterprisePolicy } from "./enterprise/policy.js";
+import { callUserOAuth } from "./mutations/oauth.js";
+import { callCreateAccountFromCredentials } from "./mutations/register.js";
+import { callRetrieveAccountWithCredentials } from "./mutations/retrieve.js";
+import { callVerifierSignature } from "./mutations/signature.js";
+import { callSignOut } from "./mutations/signout.js";
+import { storeArgs, storeImpl } from "./mutations/store.js";
+import { redirectAbsoluteUrl, setURLSearchParam } from "./redirects.js";
+import { signInImpl } from "./signin.js";
+import { createCoreDomains } from "./core.js";
+import { redirectToParamCookie, useRedirectToParam } from "./cookies.js";
+import { createEnterpriseDomain } from "./enterprise/domain.js";
+import { addAuthRoutes, addOpenIdRoutes, convertErrorsToResponse, createHttpAction, createHttpRoute, getCookies } from "./http.js";
+import { createOAuthAuthorizationURL, handleOAuthCallback } from "./oauth.js";
+import { getOidcConfig, getPublicOidcConfig, getSamlConfig, upsertProtocolConfig, withOidcSecretState } from "./enterprise/config.js";
+import { createServiceProviderMetadata, getSamlServiceProviderOptions, parseSamlIdpMetadata } from "./enterprise/saml.js";
+import { parseScimPath } from "./enterprise/scim.js";
+import { addEnterpriseHttpRuntime } from "./enterprise/http.js";
+import { actionGeneric, internalMutationGeneric } from "convex/server";
+import { v } from "convex/values";
+import { serialize } from "cookie";
+import { Fx } from "@robelest/fx";
+
+//#region src/server/runtime.ts
+const ENTERPRISE_OIDC_CLIENT_SECRET_KIND = "oidc_client_secret";
+/**
+* Configure the Convex Auth library. Returns an object with
+* functions and `auth` helper. You must export the functions
+* from `convex/auth.ts` to make them callable:
+*
+* ```ts filename="convex/auth.ts"
+* import { createAuth } from "@robelest/convex-auth/component";
+* import { components } from "./_generated/api";
+*
+* export const auth = createAuth(components.auth, {
+*   providers: [],
+* });
+* export const { signIn, signOut, store } = auth;
+* ```
+*
+* @returns An object with fields you should reexport from your
+*          `convex/auth.ts` file.
+*/
+function Auth(config_) {
+	const config = configDefaults(config_);
+	const hasOAuth = config.providers.some((provider) => provider.type === "oauth");
+	const hasSSO = config.providers.some((provider) => provider.type === "sso");
+	const getProviderOrThrow = (id, allowExtraProviders = false) => {
+		const provider = config.providers.find((configuredProvider) => configuredProvider.id === id) ?? (allowExtraProviders ? config.extraProviders.find((configuredProvider) => configuredProvider.id === id) : void 0);
+		if (provider === void 0) {
+			const detail = `Provider \`${id}\` is not configured, available providers are ${listAvailableProviders(config, allowExtraProviders)}.`;
+			logWithLevel(LOG_LEVELS.ERROR, detail);
+			throw new AuthError("PROVIDER_NOT_CONFIGURED", detail, { provider: id }).toConvexError();
+		}
+		return provider;
+	};
+	const getEnterpriseSecret = async (ctx, enterpriseId, kind) => {
+		return await ctx.runQuery(config.component.public.enterpriseSecretGet, {
+			enterpriseId,
+			kind
+		});
+	};
+	const getEnterpriseOidcConfigWithSecret = async (ctx, enterprise) => {
+		const oidc = getOidcConfig(enterprise.config);
+		const secret = await getEnterpriseSecret(ctx, enterprise._id, ENTERPRISE_OIDC_CLIENT_SECRET_KIND);
+		return {
+			...oidc,
+			...secret ? { clientSecret: await decryptSecret(secret.ciphertext) } : {}
+		};
+	};
+	const INVITE_TOKEN_ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789";
+	const INVITE_TOKEN_LENGTH = 48;
+	const enterpriseNotFoundError = "Enterprise not found.";
+	const ENTERPRISE_CONTROL_ROUTE_BASE = "/api/auth/sso";
+	const getPolicyFromEnterprise = (enterprise) => normalizeEnterprisePolicy(enterprise.policy);
+	const loadEnterpriseOrThrow = async (ctx, enterpriseId) => {
+		const enterprise = await ctx.runQuery(config.component.public.enterpriseGet, { enterpriseId });
+		if (!enterprise) throw new AuthError("INVALID_PARAMETERS", enterpriseNotFoundError).toConvexError();
+		return enterprise;
+	};
+	const loadActiveEnterpriseOrThrow = async (ctx, enterpriseId) => {
+		const enterprise = await loadEnterpriseOrThrow(ctx, enterpriseId);
+		if (enterprise.status !== "active") throw new AuthError("INVALID_PARAMETERS", "Enterprise connection is not active.").toConvexError();
+		return enterprise;
+	};
+	const loadActiveEnterpriseSamlOrThrow = async (ctx, enterpriseId) => {
+		const enterprise = await loadEnterpriseOrThrow(ctx, enterpriseId);
+		const loaded = {
+			source: {
+				kind: "enterprise",
+				id: enterpriseId
+			},
+			config: enterprise.config,
+			status: enterprise.status,
+			enterprise
+		};
+		if (!isEnterpriseSamlSourceActive(loaded)) throw new AuthError("INVALID_PARAMETERS", "Enterprise connection is not active.").toConvexError();
+		const saml = getSamlConfig(loaded.config);
+		if (!saml.idp?.metadataXml) throw new AuthError("PROVIDER_NOT_CONFIGURED", "SAML is not configured for this enterprise.").toConvexError();
+		return {
+			loaded,
+			enterprise,
+			saml
+		};
+	};
+	const loadEnterpriseOidcOrThrow = async (ctx, enterpriseId) => {
+		const enterprise = await loadActiveEnterpriseOrThrow(ctx, enterpriseId);
+		const oidc = await getEnterpriseOidcConfigWithSecret(ctx, enterprise);
+		if (oidc.enabled !== true) throw new AuthError("PROVIDER_NOT_CONFIGURED", "OIDC is not configured for this enterprise.").toConvexError();
+		return {
+			enterprise,
+			oidc
+		};
+	};
+	const validateEnterprisePolicy = (policy) => {
+		const checks = [];
+		checks.push({
+			name: "policy_version",
+			ok: policy.version === 1
+		});
+		checks.push({
+			name: "jit_default_role_ids_present",
+			ok: policy.provisioning.jit.mode !== "createUserAndMembership" || policy.provisioning.jit.defaultRoleIds.length > 0,
+			message: policy.provisioning.jit.mode === "createUserAndMembership" && policy.provisioning.jit.defaultRoleIds.length === 0 ? "At least one default roleId is required when JIT membership provisioning is enabled." : void 0
+		});
+		checks.push({
+			name: "jit_default_role_ids_known",
+			ok: policy.provisioning.jit.defaultRoleIds.every((roleId) => config.authorization.roles[roleId] !== void 0),
+			message: policy.provisioning.jit.defaultRoleIds.every((roleId) => config.authorization.roles[roleId] !== void 0) ? void 0 : "JIT defaultRoleIds contains unknown roleIds."
+		});
+		checks.push({
+			name: "scim_reuse_supported",
+			ok: policy.provisioning.scimReuse.user === "externalId" || policy.provisioning.scimReuse.user === "none"
+		});
+		return checks;
+	};
+	const recordEnterpriseAuditEvent = async (ctx, data) => {
+		const { ok, ...rest } = data;
+		return await ctx.runMutation(config.component.public.enterpriseAuditEventCreate, {
+			...rest,
+			status: ok ? "success" : "failure",
+			occurredAt: Date.now()
+		});
+	};
+	const emitEnterpriseWebhookDeliveries = async (ctx, data) => {
+		const endpoints = await ctx.runQuery(config.component.public.enterpriseWebhookEndpointList, { enterpriseId: data.enterpriseId });
+		for (const endpoint of endpoints) {
+			if (endpoint.status !== "active" || !endpoint.subscriptions.includes(data.eventType)) continue;
+			await ctx.runMutation(config.component.public.enterpriseWebhookDeliveryEnqueue, {
+				enterpriseId: data.enterpriseId,
+				endpointId: endpoint._id,
+				auditEventId: data.auditEventId,
+				eventType: data.eventType,
+				payload: data.payload,
+				nextAttemptAt: Date.now()
+			});
+		}
+	};
+	const getEnterpriseScimContext = async (ctx, request) => {
+		const authHeader = request.headers.get("Authorization");
+		if (!authHeader?.startsWith("Bearer ")) throw new AuthError("MISSING_BEARER_TOKEN").toConvexError();
+		const token = authHeader.slice(7);
+		const scimConfig = await ctx.runQuery(config.component.public.enterpriseScimConfigGetByTokenHash, { tokenHash: await sha256(token) });
+		if (!scimConfig || scimConfig.status !== "active") throw new AuthError("INVALID_API_KEY", "Invalid SCIM token.").toConvexError();
+		const parsedPath = parseScimPath(new URL(request.url).pathname);
+		if (parsedPath.enterpriseId !== scimConfig.enterpriseId) throw new AuthError("INVALID_API_KEY", "SCIM token/tenant mismatch.").toConvexError();
+		const enterprise = await ctx.runQuery(config.component.public.enterpriseGet, { enterpriseId: scimConfig.enterpriseId });
+		if (enterprise === null) throw new AuthError("INVALID_PARAMETERS", "Enterprise not found.").toConvexError();
+		return {
+			scimConfig,
+			enterprise,
+			parsedPath
+		};
+	};
+	let auth;
+	auth = {
+		...createCoreDomains({
+			config,
+			getAuth: () => auth,
+			callInvalidateSessions,
+			callCreateAccountFromCredentials,
+			callRetrieveAccountWithCredentials,
+			callModifyAccount,
+			getEnrichCtx: () => enrichCtx,
+			inviteTokenAlphabet: INVITE_TOKEN_ALPHABET,
+			inviteTokenLength: INVITE_TOKEN_LENGTH
+		}),
+		sso: createEnterpriseDomain({
+			config,
+			getAuth: () => auth,
+			normalizeEnterprisePolicy,
+			normalizeDomain,
+			getEnterpriseSecret,
+			loadEnterpriseOrThrow,
+			validateEnterprisePolicy,
+			recordEnterpriseAuditEvent,
+			emitEnterpriseWebhookDeliveries,
+			enterpriseNotFoundError,
+			ENTERPRISE_OIDC_CLIENT_SECRET_KIND,
+			requireEnv,
+			generateRandomString,
+			INVITE_TOKEN_ALPHABET,
+			sha256,
+			encryptSecret,
+			upsertProtocolConfig,
+			parseSamlIdpMetadata,
+			createServiceProviderMetadata,
+			getSamlServiceProviderOptions,
+			getPublicOidcConfig,
+			withOidcSecretState,
+			getOidcConfig,
+			getEnterpriseOidcUrls,
+			enterpriseOidcProviderId,
+			getPolicyFromEnterprise,
+			patchEnterprisePolicy
+		}),
+		http: {
+			add: (http) => {
+				addOpenIdRoutes(http, {
+					getIssuer: () => requireEnv("CONVEX_SITE_URL"),
+					getJwks: () => requireEnv("JWKS")
+				});
+				addEnterpriseHttpRuntime({
+					http,
+					hasSSO,
+					auth,
+					config,
+					routeBase: ENTERPRISE_CONTROL_ROUTE_BASE,
+					requireEnv,
+					loadActiveEnterpriseSamlOrThrow,
+					loadEnterpriseOidcOrThrow,
+					getEnterpriseScimContext,
+					getPolicyFromEnterprise,
+					normalizeEnterprisePolicy,
+					recordEnterpriseAuditEvent,
+					emitEnterpriseWebhookDeliveries,
+					generateRandomString,
+					inviteTokenAlphabet: INVITE_TOKEN_ALPHABET,
+					callUserOAuth,
+					callVerifierSignature
+				});
+				if (hasOAuth) addAuthRoutes(http, {
+					handleSignIn: convertErrorsToResponse(400, async (ctx, request) => {
+						const url = new URL(request.url);
+						const providerId = url.pathname.split("/").at(-1);
+						if (providerId === null) throw new AuthError("OAUTH_MISSING_PROVIDER").toConvexError();
+						const verifier = url.searchParams.get("code");
+						if (verifier === null) throw new AuthError("OAUTH_MISSING_VERIFIER").toConvexError();
+						const oauthConfig = getProviderOrThrow(providerId);
+						const { redirect, cookies, signature } = await createOAuthAuthorizationURL(providerId, oauthConfig.provider, oauthConfig);
+						await callVerifierSignature(ctx, {
+							verifier,
+							signature
+						});
+						const redirectTo = url.searchParams.get("redirectTo");
+						if (redirectTo !== null) cookies.push(redirectToParamCookie(providerId, redirectTo));
+						const headers = new Headers({ Location: redirect });
+						for (const { name, value, options } of cookies) headers.append("Set-Cookie", serialize(name, value, options));
+						return new Response(null, {
+							status: 302,
+							headers
+						});
+					}),
+					handleCallback: async (ctx, request) => {
+						const url = new URL(request.url);
+						const providerId = new URL(request.url).pathname.split("/").at(-1);
+						if (!providerId) throw new AuthError("OAUTH_MISSING_PROVIDER").toConvexError();
+						logWithLevel(LOG_LEVELS.DEBUG, "Handling OAuth callback for provider:", providerId);
+						const provider = getProviderOrThrow(providerId);
+						const cookies = getCookies(request);
+						const maybeRedirectTo = useRedirectToParam(provider.id, cookies);
+						const destinationUrl = await redirectAbsoluteUrl(config, { redirectTo: maybeRedirectTo?.redirectTo });
+						const params = url.searchParams;
+						if (request.headers.get("Content-Type") === "application/x-www-form-urlencoded") (await request.formData()).forEach((value, key) => {
+							if (typeof value === "string") params.append(key, value);
+						});
+						return Fx.run(Fx.from({
+							ok: async () => {
+								const oauthConfig = provider;
+								const result = await Fx.run(handleOAuthCallback(providerId, oauthConfig.provider, oauthConfig, Object.fromEntries(params.entries()), cookies));
+								const oauthCookies = result.cookies;
+								const { id: profileId, ...profileData } = result.profile;
+								const { signature } = result;
+								const redirUrl = setURLSearchParam(destinationUrl, "code", await callUserOAuth(ctx, {
+									provider: providerId,
+									providerAccountId: profileId,
+									profile: profileData,
+									signature
+								}));
+								const redirHeaders = new Headers({ Location: redirUrl });
+								redirHeaders.set("Cache-Control", "must-revalidate");
+								for (const { name, value, options } of [...oauthCookies, ...maybeRedirectTo !== null ? [maybeRedirectTo.updatedCookie] : []]) redirHeaders.append("Set-Cookie", serialize(name, value, options));
+								return new Response(null, {
+									status: 302,
+									headers: redirHeaders
+								});
+							},
+							err: (error) => error
+						}).pipe(Fx.recover((error) => {
+							logError(error);
+							const respHeaders = new Headers({ Location: destinationUrl });
+							for (const { name, value, options } of maybeRedirectTo !== null ? [maybeRedirectTo.updatedCookie] : []) respHeaders.append("Set-Cookie", serialize(name, value, options));
+							return Fx.succeed(new Response(null, {
+								status: 302,
+								headers: respHeaders
+							}));
+						})));
+					}
+				});
+			},
+			action: createHttpAction(auth),
+			route: createHttpRoute(createHttpAction(auth))
+		}
+	};
+	const enrichCtx = (ctx) => ({
+		...ctx,
+		auth: {
+			...ctx.auth,
+			config,
+			account: auth.account,
+			session: auth.session,
+			member: auth.member,
+			provider: auth.provider
+		}
+	});
+	return {
+		auth,
+		signIn: actionGeneric({
+			args: {
+				provider: v.optional(v.string()),
+				params: v.optional(v.any()),
+				verifier: v.optional(v.string()),
+				refreshToken: v.optional(v.string()),
+				calledBy: v.optional(v.string())
+			},
+			handler: async (ctx, args) => {
+				if (args.calledBy !== void 0) logWithLevel("INFO", `\`auth:signIn\` called by ${args.calledBy}`);
+				const provider = args.provider !== void 0 ? getProviderOrThrow(args.provider) : null;
+				const result = await signInImpl(enrichCtx(ctx), provider, args, {
+					generateTokens: true,
+					allowExtraProviders: false
+				});
+				return Fx.run(Fx.match(result, result.kind, {
+					redirect: (r) => Fx.succeed({
+						kind: "redirect",
+						redirect: r.redirect,
+						verifier: r.verifier
+					}),
+					signedIn: (r) => Fx.succeed({
+						kind: "signedIn",
+						tokens: r.signedIn?.tokens ?? null
+					}),
+					refreshTokens: (r) => Fx.succeed({
+						kind: "signedIn",
+						tokens: r.signedIn?.tokens ?? null
+					}),
+					started: () => Fx.succeed({ kind: "started" }),
+					passkeyOptions: (r) => Fx.succeed({
+						kind: "passkeyOptions",
+						options: r.options,
+						verifier: r.verifier
+					}),
+					totpRequired: (r) => Fx.succeed({
+						kind: "totpRequired",
+						verifier: r.verifier
+					}),
+					totpSetup: (r) => Fx.succeed({
+						kind: "totpSetup",
+						totpSetup: {
+							uri: r.uri,
+							secret: r.secret,
+							totpId: r.totpId
+						},
+						verifier: r.verifier
+					}),
+					deviceCode: (r) => Fx.succeed({
+						kind: "deviceCode",
+						deviceCode: {
+							deviceCode: r.deviceCode,
+							userCode: r.userCode,
+							verificationUri: r.verificationUri,
+							verificationUriComplete: r.verificationUriComplete,
+							expiresIn: r.expiresIn,
+							interval: r.interval
+						}
+					})
+				}));
+			}
+		}),
+		signOut: actionGeneric({
+			args: {},
+			handler: async (ctx) => {
+				await callSignOut(ctx);
+			}
+		}),
+		store: internalMutationGeneric({
+			args: storeArgs,
+			handler: async (ctx, args) => {
+				return storeImpl(ctx, args, getProviderOrThrow, config);
+			}
+		})
+	};
+}
+
+//#endregion
+export { Auth };
+//# sourceMappingURL=runtime.js.map

package/dist/component/server/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":["serializeCookie"],"sources":["../../../src/server/runtime.ts"],"sourcesContent":["import {\n  Auth,\n  GenericActionCtx,\n  GenericDataModel,\n  HttpRouter,\n  actionGeneric,\n  internalMutationGeneric,\n} from \"convex/server\";\nimport { v } from \"convex/values\";\nimport { serialize as serializeCookie } from \"cookie\";\n\nimport { createCoreDomains } from \"./core\";\nimport { redirectToParamCookie, useRedirectToParam } from \"./cookies\";\nimport { createEnterpriseDomain } from \"./enterprise/domain\";\nimport { addEnterpriseHttpRuntime } from \"./enterprise/http\";\nimport {\n  getOidcConfig,\n  getPublicOidcConfig,\n  getSamlConfig,\n  upsertProtocolConfig,\n  withOidcSecretState,\n} from \"./enterprise/config\";\nimport { normalizeEnterprisePolicy, patchEnterprisePolicy } from \"./enterprise/policy\";\nimport {\n  createServiceProviderMetadata,\n  getSamlServiceProviderOptions,\n  parseSamlIdpMetadata,\n} from \"./enterprise/saml\";\nimport {\n  parseScimPath,\n} from \"./enterprise/scim\";\nimport {\n  enterpriseOidcProviderId,\n  getEnterpriseOidcUrls,\n  isEnterpriseSamlSourceActive,\n  normalizeDomain,\n} from \"./enterprise/shared\";\nimport { Fx } from \"@robelest/fx\";\n\nimport { AuthError } from \"./authError\";\nimport {\n  addAuthRoutes,\n  addOpenIdRoutes,\n  convertErrorsToResponse,\n  createHttpAction,\n  createHttpRoute,\n  getCookies,\n} from \"./http\";\nimport {\n  callCreateAccountFromCredentials,\n  callInvalidateSessions,\n  callModifyAccount,\n  callRetrieveAccountWithCredentials,\n  callSignOut,\n  callUserOAuth,\n  callVerifierSignature,\n  storeArgs,\n  storeImpl,\n} from \"./mutations/index\";\nimport { createOAuthAuthorizationURL, handleOAuthCallback } from \"./oauth\";\nimport { GetProviderOrThrowFunc } from \"./crypto\";\nimport { configDefaults, listAvailableProviders } from \"./config\";\nimport { redirectAbsoluteUrl, setURLSearchParam } from \"./redirects\";\nimport { signInImpl } from \"./signin\";\nimport type {\n  ConvexAuthConfig,\n  FunctionReferenceFromExport,\n  OAuthMaterializedConfig,\n  Tokens,\n} from \"./types\";\nimport { MutationCtx } from \"./types\";\nimport {\n  decryptSecret,\n  encryptSecret,\n  generateRandomString,\n  LOG_LEVELS,\n  logError,\n  logWithLevel,\n  sha256,\n} from \"./utils\";\nimport { requireEnv } from \"./utils\";\n\nconst ENTERPRISE_OIDC_CLIENT_SECRET_KIND = \"oidc_client_secret\" as const;\n\n/**\n * The type of the signIn Convex Action returned from the auth() helper.\n *\n * This type is exported for implementors of other client integrations.\n * However it is not stable, and may change until this library reaches 1.0.\n *\n * @internal\n */\nexport type SignInAction = FunctionReferenceFromExport<\n  ReturnType<typeof Auth>[\"signIn\"]\n>;\n\n/** @internal */\nexport type SignInActionResult =\n  | { kind: \"signedIn\"; tokens: Tokens | null }\n  | { kind: \"redirect\"; redirect: string; verifier: string }\n  | { kind: \"started\" }\n  | { kind: \"passkeyOptions\"; options: Record<string, any>; verifier: string }\n  | { kind: \"totpRequired\"; verifier: string }\n  | {\n      kind: \"totpSetup\";\n      totpSetup: { uri: string; secret: string; totpId: string };\n      verifier: string;\n    }\n  | {\n      kind: \"deviceCode\";\n      deviceCode: {\n        deviceCode: string;\n        userCode: string;\n        verificationUri: string;\n        verificationUriComplete: string;\n        expiresIn: number;\n        interval: number;\n      };\n    };\n/**\n * The type of the signOut Convex Action returned from the auth() helper.\n *\n * This type is exported for implementors of other client integrations.\n * However it is not stable, and may change until this library reaches 1.0.\n *\n * @internal\n */\nexport type SignOutAction = FunctionReferenceFromExport<\n  ReturnType<typeof Auth>[\"signOut\"]\n>;\n\n/**\n * Configure the Convex Auth library. Returns an object with\n * functions and `auth` helper. You must export the functions\n * from `convex/auth.ts` to make them callable:\n *\n * ```ts filename=\"convex/auth.ts\"\n * import { createAuth } from \"@robelest/convex-auth/component\";\n * import { components } from \"./_generated/api\";\n *\n * export const auth = createAuth(components.auth, {\n *   providers: [],\n * });\n * export const { signIn, signOut, store } = auth;\n * ```\n *\n * @returns An object with fields you should reexport from your\n *          `convex/auth.ts` file.\n */\nexport function Auth(config_: ConvexAuthConfig) {\n  const config = configDefaults(config_);\n  const hasOAuth = config.providers.some(\n    (provider) => provider.type === \"oauth\",\n  );\n  const hasSSO = config.providers.some((provider) => provider.type === \"sso\");\n  const getProviderOrThrow: GetProviderOrThrowFunc = (\n    id: string,\n    allowExtraProviders: boolean = false,\n  ) => {\n    const provider =\n      config.providers.find(\n        (configuredProvider) => configuredProvider.id === id,\n      ) ??\n      (allowExtraProviders\n        ? config.extraProviders.find(\n            (configuredProvider) => configuredProvider.id === id,\n          )\n        : undefined);\n    if (provider === undefined) {\n      const detail =\n        `Provider \\`${id}\\` is not configured, ` +\n        `available providers are ${listAvailableProviders(config, allowExtraProviders)}.`;\n      logWithLevel(LOG_LEVELS.ERROR, detail);\n      throw new AuthError(\"PROVIDER_NOT_CONFIGURED\", detail, {\n        provider: id,\n      }).toConvexError();\n    }\n    return provider;\n  };\n  type ComponentCtx = Pick<\n    GenericActionCtx<GenericDataModel>,\n    \"runQuery\" | \"runMutation\"\n  >;\n  type ComponentReadCtx = Pick<GenericActionCtx<GenericDataModel>, \"runQuery\">;\n  const getEnterpriseSecret = async (\n    ctx: ComponentReadCtx | ComponentCtx,\n    enterpriseId: string,\n    kind: typeof ENTERPRISE_OIDC_CLIENT_SECRET_KIND,\n  ) => {\n    return await ctx.runQuery(config.component.public.enterpriseSecretGet, {\n      enterpriseId,\n      kind,\n    });\n  };\n  const getEnterpriseOidcConfigWithSecret = async (\n    ctx: ComponentReadCtx | ComponentCtx,\n    enterprise: { _id: string; config?: unknown },\n  ): Promise<Record<string, any>> => {\n    const oidc = getOidcConfig(enterprise.config);\n    const secret = await getEnterpriseSecret(\n      ctx,\n      enterprise._id,\n      ENTERPRISE_OIDC_CLIENT_SECRET_KIND,\n    );\n    return {\n      ...oidc,\n      ...(secret\n        ? { clientSecret: await decryptSecret(secret.ciphertext) }\n        : {}),\n    };\n  };\n  const INVITE_TOKEN_ALPHABET =\n    \"ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789\";\n  const INVITE_TOKEN_LENGTH = 48;\n\n  const enterpriseNotFoundError = \"Enterprise not found.\";\n\n  const ENTERPRISE_CONTROL_ROUTE_BASE = \"/api/auth/sso\";\n\n  const getPolicyFromEnterprise = (enterprise: { policy?: unknown }) =>\n    normalizeEnterprisePolicy(enterprise.policy);\n\n  const loadEnterpriseOrThrow = async (\n    ctx: ComponentReadCtx,\n    enterpriseId: string,\n  ) => {\n    const enterprise = await ctx.runQuery(\n      config.component.public.enterpriseGet,\n      {\n        enterpriseId,\n      },\n    );\n    if (!enterprise) {\n      throw new AuthError(\n        \"INVALID_PARAMETERS\",\n        enterpriseNotFoundError,\n      ).toConvexError();\n    }\n    return enterprise;\n  };\n\n  const loadActiveEnterpriseOrThrow = async (\n    ctx: ComponentReadCtx,\n    enterpriseId: string,\n  ) => {\n    const enterprise = await loadEnterpriseOrThrow(ctx, enterpriseId);\n    if (enterprise.status !== \"active\") {\n      throw new AuthError(\n        \"INVALID_PARAMETERS\",\n        \"Enterprise connection is not active.\",\n      ).toConvexError();\n    }\n    return enterprise;\n  };\n\n  const loadActiveEnterpriseSamlOrThrow = async (\n    ctx: ComponentReadCtx,\n    enterpriseId: string,\n  ) => {\n    const enterprise = await loadEnterpriseOrThrow(ctx, enterpriseId);\n    const loaded = {\n      source: {\n        kind: \"enterprise\" as const,\n        id: enterpriseId,\n      },\n      config: enterprise.config,\n      status: enterprise.status,\n      enterprise,\n    };\n    if (!isEnterpriseSamlSourceActive(loaded)) {\n      throw new AuthError(\n        \"INVALID_PARAMETERS\",\n        \"Enterprise connection is not active.\",\n      ).toConvexError();\n    }\n    const saml = getSamlConfig(loaded.config);\n    if (!saml.idp?.metadataXml) {\n      throw new AuthError(\n        \"PROVIDER_NOT_CONFIGURED\",\n        \"SAML is not configured for this enterprise.\",\n      ).toConvexError();\n    }\n    return { loaded, enterprise, saml };\n  };\n\n  const loadEnterpriseOidcOrThrow = async (\n    ctx: ComponentReadCtx,\n    enterpriseId: string,\n  ) => {\n    const enterprise = await loadActiveEnterpriseOrThrow(ctx, enterpriseId);\n    const oidc = await getEnterpriseOidcConfigWithSecret(ctx, enterprise);\n    if (oidc.enabled !== true) {\n      throw new AuthError(\n        \"PROVIDER_NOT_CONFIGURED\",\n        \"OIDC is not configured for this enterprise.\",\n      ).toConvexError();\n    }\n    return { enterprise, oidc };\n  };\n\n  const validateEnterprisePolicy = (\n    policy: ReturnType<typeof normalizeEnterprisePolicy>,\n  ) => {\n    const checks: Array<{\n      name: string;\n      ok: boolean;\n      message?: string;\n    }> = [];\n\n    checks.push({ name: \"policy_version\", ok: policy.version === 1 });\n    checks.push({\n      name: \"jit_default_role_ids_present\",\n      ok:\n        policy.provisioning.jit.mode !== \"createUserAndMembership\" ||\n        policy.provisioning.jit.defaultRoleIds.length > 0,\n      message:\n        policy.provisioning.jit.mode === \"createUserAndMembership\" &&\n        policy.provisioning.jit.defaultRoleIds.length === 0\n          ? \"At least one default roleId is required when JIT membership provisioning is enabled.\"\n          : undefined,\n    });\n    checks.push({\n      name: \"jit_default_role_ids_known\",\n      ok: policy.provisioning.jit.defaultRoleIds.every(\n        (roleId) => config.authorization.roles[roleId] !== undefined,\n      ),\n      message: policy.provisioning.jit.defaultRoleIds.every(\n        (roleId) => config.authorization.roles[roleId] !== undefined,\n      )\n        ? undefined\n        : \"JIT defaultRoleIds contains unknown roleIds.\",\n    });\n    checks.push({\n      name: \"scim_reuse_supported\",\n      ok:\n        policy.provisioning.scimReuse.user === \"externalId\" ||\n        policy.provisioning.scimReuse.user === \"none\",\n    });\n\n    return checks;\n  };\n\n  const recordEnterpriseAuditEvent = async (\n    ctx: ComponentCtx,\n    data: {\n      enterpriseId: string;\n      groupId: string;\n      eventType: string;\n      actorType: \"user\" | \"system\" | \"scim\" | \"api_key\" | \"webhook\";\n      actorId?: string;\n      subjectType: string;\n      subjectId?: string;\n      ok: boolean;\n      requestId?: string;\n      ip?: string;\n      metadata?: Record<string, unknown>;\n    },\n  ) => {\n    const { ok, ...rest } = data;\n    return (await ctx.runMutation(\n      config.component.public.enterpriseAuditEventCreate,\n      {\n        ...rest,\n        status: ok ? \"success\" : \"failure\",\n        occurredAt: Date.now(),\n      },\n    )) as string;\n  };\n\n  const emitEnterpriseWebhookDeliveries = async (\n    ctx: ComponentCtx,\n    data: {\n      enterpriseId: string;\n      eventType: string;\n      payload: Record<string, unknown>;\n      auditEventId?: string;\n    },\n  ) => {\n    const endpoints = await ctx.runQuery(\n      config.component.public.enterpriseWebhookEndpointList,\n      { enterpriseId: data.enterpriseId },\n    );\n    for (const endpoint of endpoints) {\n      if (\n        endpoint.status !== \"active\" ||\n        !endpoint.subscriptions.includes(data.eventType)\n      ) {\n        continue;\n      }\n      await ctx.runMutation(\n        config.component.public.enterpriseWebhookDeliveryEnqueue,\n        {\n          enterpriseId: data.enterpriseId,\n          endpointId: endpoint._id,\n          auditEventId: data.auditEventId,\n          eventType: data.eventType,\n          payload: data.payload,\n          nextAttemptAt: Date.now(),\n        },\n      );\n    }\n  };\n\n  const getEnterpriseScimContext = async (\n    ctx: ComponentReadCtx,\n    request: Request,\n  ) => {\n    const authHeader = request.headers.get(\"Authorization\");\n    if (!authHeader?.startsWith(\"Bearer \")) {\n      throw new AuthError(\"MISSING_BEARER_TOKEN\").toConvexError();\n    }\n    const token = authHeader.slice(7);\n    const scimConfig = await ctx.runQuery(\n      config.component.public.enterpriseScimConfigGetByTokenHash,\n      { tokenHash: await sha256(token) },\n    );\n    if (!scimConfig || scimConfig.status !== \"active\") {\n      throw new AuthError(\n        \"INVALID_API_KEY\",\n        \"Invalid SCIM token.\",\n      ).toConvexError();\n    }\n    const parsedPath = parseScimPath(new URL(request.url).pathname);\n    if (parsedPath.enterpriseId !== scimConfig.enterpriseId) {\n      throw new AuthError(\n        \"INVALID_API_KEY\",\n        \"SCIM token/tenant mismatch.\",\n      ).toConvexError();\n    }\n    const enterprise = await ctx.runQuery(\n      config.component.public.enterpriseGet,\n      {\n        enterpriseId: scimConfig.enterpriseId,\n      },\n    );\n    if (enterprise === null) {\n      throw new AuthError(\n        \"INVALID_PARAMETERS\",\n        \"Enterprise not found.\",\n      ).toConvexError();\n    }\n    return { scimConfig, enterprise, parsedPath };\n  };\n\n  let auth: any;\n  auth = {\n    ...createCoreDomains({\n      config,\n      getAuth: () => auth,\n      callInvalidateSessions,\n      callCreateAccountFromCredentials,\n      callRetrieveAccountWithCredentials,\n      callModifyAccount,\n      getEnrichCtx: () => enrichCtx,\n      inviteTokenAlphabet: INVITE_TOKEN_ALPHABET,\n      inviteTokenLength: INVITE_TOKEN_LENGTH,\n    }),\n    /**\n     * SSO namespace — enterprise SSO connection management, domain, OIDC,\n     * SAML, SCIM, audit, and webhook helpers.\n     */\n    sso: createEnterpriseDomain({\n      config,\n      getAuth: () => auth,\n      normalizeEnterprisePolicy,\n      normalizeDomain,\n      getEnterpriseSecret,\n      loadEnterpriseOrThrow,\n      validateEnterprisePolicy,\n      recordEnterpriseAuditEvent,\n      emitEnterpriseWebhookDeliveries,\n      enterpriseNotFoundError,\n      ENTERPRISE_OIDC_CLIENT_SECRET_KIND,\n      requireEnv,\n      generateRandomString,\n      INVITE_TOKEN_ALPHABET,\n      sha256,\n      encryptSecret,\n      upsertProtocolConfig,\n      parseSamlIdpMetadata,\n      createServiceProviderMetadata,\n      getSamlServiceProviderOptions,\n      getPublicOidcConfig,\n      withOidcSecretState,\n      getOidcConfig,\n      getEnterpriseOidcUrls,\n      enterpriseOidcProviderId,\n      getPolicyFromEnterprise,\n      patchEnterprisePolicy,\n    }),\n    // HTTP wiring stays local to the factory because it still depends on a\n    // dense mix of OAuth, SAML, SCIM, cookie, and response helpers.\n    http: {\n      /**\n       * Register core HTTP routes for JWT verification and OAuth sign-in.\n       *\n       * ```ts\n       * import { httpRouter } from \"convex/server\";\n       * import { auth } from \"./auth\";\n       *\n       * const http = httpRouter();\n       *\n       * auth.http.add(http);\n       *\n       * export default http;\n       * ```\n       *\n       * The following routes are handled always:\n       *\n       * - `/.well-known/openid-configuration`\n       * - `/.well-known/jwks.json`\n       *\n       * The following routes are handled if OAuth is configured:\n       *\n       * - `/api/auth/signin/*`\n       * - `/api/auth/callback/*`\n       *\n       * @param http your HTTP router\n       */\n      add: (http: HttpRouter) => {\n        addOpenIdRoutes(http, {\n          getIssuer: () => requireEnv(\"CONVEX_SITE_URL\"),\n          getJwks: () => requireEnv(\"JWKS\"),\n        });\n\n        addEnterpriseHttpRuntime({\n          http,\n          hasSSO,\n          auth,\n          config,\n          routeBase: ENTERPRISE_CONTROL_ROUTE_BASE,\n          requireEnv,\n          loadActiveEnterpriseSamlOrThrow,\n          loadEnterpriseOidcOrThrow,\n          getEnterpriseScimContext,\n          getPolicyFromEnterprise,\n          normalizeEnterprisePolicy,\n          recordEnterpriseAuditEvent,\n          emitEnterpriseWebhookDeliveries,\n          generateRandomString,\n          inviteTokenAlphabet: INVITE_TOKEN_ALPHABET,\n          callUserOAuth,\n          callVerifierSignature,\n        });\n\n        if (hasOAuth) {\n          addAuthRoutes(http, {\n            handleSignIn: convertErrorsToResponse(400, async (ctx, request) => {\n              const url = new URL(request.url);\n              const pathParts = url.pathname.split(\"/\");\n              const providerId = pathParts.at(-1)!;\n              if (providerId === null) {\n                throw new AuthError(\"OAUTH_MISSING_PROVIDER\").toConvexError();\n              }\n              const verifier = url.searchParams.get(\"code\");\n              if (verifier === null) {\n                throw new AuthError(\"OAUTH_MISSING_VERIFIER\").toConvexError();\n              }\n              const provider = getProviderOrThrow(providerId);\n\n              const oauthConfig = provider as OAuthMaterializedConfig;\n              const { redirect, cookies, signature } =\n                await createOAuthAuthorizationURL(\n                  providerId,\n                  oauthConfig.provider,\n                  oauthConfig,\n                );\n\n              await callVerifierSignature(ctx, {\n                verifier,\n                signature,\n              });\n\n              const redirectTo = url.searchParams.get(\"redirectTo\");\n              if (redirectTo !== null) {\n                cookies.push(redirectToParamCookie(providerId, redirectTo));\n              }\n\n              const headers = new Headers({ Location: redirect });\n              for (const { name, value, options } of cookies) {\n                headers.append(\n                  \"Set-Cookie\",\n                  serializeCookie(name, value, options as any),\n                );\n              }\n\n              return new Response(null, { status: 302, headers });\n            }),\n            handleCallback: async (ctx, request) => {\n              const url = new URL(request.url);\n              const providerId = new URL(request.url).pathname\n                .split(\"/\")\n                .at(-1);\n              if (!providerId) {\n                throw new AuthError(\"OAUTH_MISSING_PROVIDER\").toConvexError();\n              }\n              logWithLevel(\n                LOG_LEVELS.DEBUG,\n                \"Handling OAuth callback for provider:\",\n                providerId,\n              );\n              const provider = getProviderOrThrow(providerId);\n\n              const cookies = getCookies(request);\n\n              const maybeRedirectTo = useRedirectToParam(provider.id, cookies);\n\n              const destinationUrl = await redirectAbsoluteUrl(config, {\n                redirectTo: maybeRedirectTo?.redirectTo,\n              });\n\n              const params = url.searchParams;\n\n              if (\n                request.headers.get(\"Content-Type\") ===\n                \"application/x-www-form-urlencoded\"\n              ) {\n                const formData = await request.formData();\n                formData.forEach((value, key) => {\n                  if (typeof value === \"string\") {\n                    params.append(key, value);\n                  }\n                });\n              }\n\n              return Fx.run(\n                Fx.from({\n                  ok: async () => {\n                    const oauthConfig = provider as OAuthMaterializedConfig;\n                    const result = await Fx.run(\n                      handleOAuthCallback(\n                        providerId,\n                        oauthConfig.provider,\n                        oauthConfig,\n                        Object.fromEntries(params.entries()),\n                        cookies,\n                      ),\n                    );\n                    const oauthCookies = result.cookies;\n                    const { id: profileId, ...profileData } = result.profile;\n                    const { signature } = result;\n\n                    const verificationCode = await callUserOAuth(ctx, {\n                      provider: providerId,\n                      providerAccountId: profileId,\n                      profile: profileData,\n                      signature,\n                    });\n\n                    const redirUrl = setURLSearchParam(\n                      destinationUrl,\n                      \"code\",\n                      verificationCode,\n                    );\n                    const redirHeaders = new Headers({ Location: redirUrl });\n                    redirHeaders.set(\"Cache-Control\", \"must-revalidate\");\n                    for (const { name, value, options } of [\n                      ...oauthCookies,\n                      ...(maybeRedirectTo !== null\n                        ? [maybeRedirectTo.updatedCookie]\n                        : []),\n                    ] as any) {\n                      redirHeaders.append(\n                        \"Set-Cookie\",\n                        serializeCookie(name, value, options),\n                      );\n                    }\n                    return new Response(null, {\n                      status: 302,\n                      headers: redirHeaders,\n                    });\n                  },\n                  err: (error) => error,\n                }).pipe(\n                  Fx.recover((error) => {\n                    logError(error);\n                    const respHeaders = new Headers({\n                      Location: destinationUrl,\n                    });\n                    for (const { name, value, options } of maybeRedirectTo !==\n                    null\n                      ? [maybeRedirectTo.updatedCookie]\n                      : []) {\n                      respHeaders.append(\n                        \"Set-Cookie\",\n                        serializeCookie(name, value, options),\n                      );\n                    }\n                    return Fx.succeed(\n                      new Response(null, {\n                        status: 302,\n                        headers: respHeaders,\n                      }),\n                    );\n                  }),\n                ),\n              );\n            },\n          });\n        }\n      },\n\n      /**\n       * Wrap an HTTP action handler with Bearer token authentication.\n       *\n       * Extracts the `Authorization: Bearer <key>` header, verifies the\n       * API key via `auth.key.verify()`, and injects `ctx.key` with the\n       * verified key info. Returns structured JSON error responses for\n       * missing/invalid/revoked/expired/rate-limited keys.\n       *\n       * If the handler returns a plain object, it is auto-wrapped in a\n       * `200 JSON` response. If it returns a `Response`, CORS headers\n       * are merged and the response is passed through.\n       *\n       * ```ts\n       * const handler = auth.http.action(async (ctx, request) => {\n       *   const data = await ctx.runQuery(api.data.get, { userId: ctx.key.userId });\n       *   return { data };\n       * });\n       * http.route({ path: \"/api/data\", method: \"GET\", handler });\n       * ```\n       *\n       * @param handler - Receives enriched `ctx` (with `ctx.key`) and the raw `Request`.\n       * @param options.scope - Optional scope check; returns 403 if the key lacks permission.\n       * @param options.cors - CORS config; defaults to permissive (`*`).\n       */\n      action: createHttpAction(auth),\n\n      /**\n       * Register a Bearer-authenticated route **and** its OPTIONS preflight\n       * in a single call.\n       *\n       * ```ts\n       * auth.http.route(http, {\n       *   path: \"/api/messages\",\n       *   method: \"POST\",\n       *   handler: async (ctx, request) => {\n       *     const { body } = await request.json();\n       *     await ctx.runMutation(internal.messages.sendAsUser, {\n       *       userId: ctx.key.userId,\n       *       body,\n       *     });\n       *     return { success: true };\n       *   },\n       * });\n       * ```\n       *\n       * @param http - The Convex HTTP router.\n       * @param routeConfig.path - The URL path to match.\n       * @param routeConfig.method - HTTP method (GET, POST, PUT, PATCH, DELETE).\n       * @param routeConfig.handler - Receives enriched `ctx` (with `ctx.key`) and the raw `Request`.\n       * @param routeConfig.scope - Optional scope check; returns 403 if the key lacks permission.\n       * @param routeConfig.cors - CORS config; defaults to permissive (`*`).\n       */\n      route: createHttpRoute(createHttpAction(auth)),\n    },\n  };\n\n  const enrichCtx = <DataModel extends GenericDataModel>(\n    ctx: GenericActionCtx<DataModel>,\n  ) => ({\n    ...ctx,\n    auth: {\n      ...ctx.auth,\n      config,\n      account: auth.account,\n      session: auth.session,\n      member: auth.member,\n      provider: auth.provider,\n    },\n  });\n\n  return {\n    /**\n     * Helper for configuring HTTP actions.\n     */\n    auth,\n    /**\n     * Action called by the client to sign the user in.\n     *\n     * Also used for refreshing the session.\n     */\n    signIn: actionGeneric({\n      args: {\n        provider: v.optional(v.string()),\n        params: v.optional(v.any()),\n        verifier: v.optional(v.string()),\n        refreshToken: v.optional(v.string()),\n        calledBy: v.optional(v.string()),\n      },\n      handler: async (ctx, args): Promise<SignInActionResult> => {\n        if (args.calledBy !== undefined) {\n          logWithLevel(\"INFO\", `\\`auth:signIn\\` called by ${args.calledBy}`);\n        }\n        const provider =\n          args.provider !== undefined\n            ? getProviderOrThrow(args.provider)\n            : null;\n        const result = await signInImpl(enrichCtx(ctx), provider, args, {\n          generateTokens: true,\n          allowExtraProviders: false,\n        });\n        return Fx.run(\n          Fx.match(result, result.kind, {\n            redirect: (r) =>\n              Fx.succeed({\n                kind: \"redirect\" as const,\n                redirect: r.redirect,\n                verifier: r.verifier,\n              }),\n            signedIn: (r) =>\n              Fx.succeed({\n                kind: \"signedIn\" as const,\n                tokens: r.signedIn?.tokens ?? null,\n              }),\n            refreshTokens: (r) =>\n              Fx.succeed({\n                kind: \"signedIn\" as const,\n                tokens: r.signedIn?.tokens ?? null,\n              }),\n            started: () => Fx.succeed({ kind: \"started\" as const }),\n            passkeyOptions: (r) =>\n              Fx.succeed({\n                kind: \"passkeyOptions\" as const,\n                options: r.options,\n                verifier: r.verifier,\n              }),\n            totpRequired: (r) =>\n              Fx.succeed({\n                kind: \"totpRequired\" as const,\n                verifier: r.verifier,\n              }),\n            totpSetup: (r) =>\n              Fx.succeed({\n                kind: \"totpSetup\" as const,\n                totpSetup: {\n                  uri: r.uri,\n                  secret: r.secret,\n                  totpId: r.totpId,\n                },\n                verifier: r.verifier,\n              }),\n            deviceCode: (r) =>\n              Fx.succeed({\n                kind: \"deviceCode\" as const,\n                deviceCode: {\n                  deviceCode: r.deviceCode,\n                  userCode: r.userCode,\n                  verificationUri: r.verificationUri,\n                  verificationUriComplete: r.verificationUriComplete,\n                  expiresIn: r.expiresIn,\n                  interval: r.interval,\n                },\n              }),\n          }),\n        );\n      },\n    }),\n    /**\n     * Action called by the client to invalidate the current session.\n     */\n    signOut: actionGeneric({\n      args: {},\n      handler: async (ctx) => {\n        await callSignOut(ctx);\n      },\n    }),\n\n    /**\n     * Internal mutation used by the library to read and write\n     * to the database during signin and signout.\n     */\n    store: internalMutationGeneric({\n      args: storeArgs,\n      handler: async (ctx: MutationCtx, args) => {\n        return storeImpl(ctx, args, getProviderOrThrow, config);\n      },\n    }),\n  };\n}\n"],"mappings":"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"}