@protobase/server 0.15.5 → 0.16.0

package/dist/app-name.js

@@ -0,0 +1,9 @@
+//#region src/app-name.ts
+const appNameVariable = "PROTOBASE_APP_NAME";
+/**
+* The app's name the platform passes in `PROTOBASE_APP_NAME`, such as `Property Finder`; `undefined` when it is not
+* set. Protobase names the app with it in sign-in prompts and in the mail it sends, unless the app names itself.
+*/
+const readAppName = (env) => env["PROTOBASE_APP_NAME"]?.trim() || void 0;
+//#endregion
+export { appNameVariable, readAppName };

package/dist/better-auth/auth-mail/account-exists-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/account-exists-email.js

@@ -0,0 +1,31 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailButton, EmailNote } from "./auth-email-layout.js";
+import { signInPath } from "@protobase/schema";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/account-exists-email.tsx
+const AccountExistsEmail = ({ app }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `Sign in to ${app.name} with this address instead`,
+	heading: "You already have an account",
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"Someone asked to create an account with ",
+			app.name,
+			" for this address. It has one already, so no new account was made."
+		] }),
+		/* @__PURE__ */ jsxs(EmailButton, {
+			href: new URL(signInPath(), app.url).href,
+			children: ["Sign in to ", app.name]
+		}),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If this was not you, ignore this email: your account stays as it is." })
+	]
+});
+/** The email to an address that asked for a sign-up code while it has an account already: no code, a link to sign in instead. */
+const accountExistsEmail = defineEmail({
+	name: "account-exists",
+	subject: ({ app }) => `You already have an account with ${app.name}`,
+	component: AccountExistsEmail
+});
+//#endregion
+export { accountExistsEmail };

package/dist/better-auth/auth-mail/auth-email-layout.js

@@ -0,0 +1,90 @@
+import { Body, Button, Container, Head, Heading, Hr, Html, Link, Preview, Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/auth-email-layout.tsx
+const styles = {
+	body: {
+		backgroundColor: "#f4f4f5",
+		fontFamily: "Helvetica, Arial, sans-serif",
+		color: "#18181b"
+	},
+	container: {
+		backgroundColor: "#ffffff",
+		padding: "24px",
+		maxWidth: "480px"
+	},
+	heading: { fontSize: "20px" },
+	rule: { borderColor: "#e4e4e7" },
+	footer: {
+		color: "#71717a",
+		fontSize: "13px",
+		margin: "0"
+	},
+	footerLink: { color: "#71717a" },
+	note: {
+		color: "#71717a",
+		fontSize: "13px"
+	},
+	code: {
+		fontFamily: "Menlo, Consolas, monospace",
+		fontSize: "28px",
+		fontWeight: 600,
+		letterSpacing: "4px",
+		margin: "16px 0"
+	},
+	button: {
+		backgroundColor: "#0f766e",
+		color: "#ffffff",
+		padding: "12px 20px",
+		borderRadius: "6px",
+		fontWeight: 600
+	}
+};
+/** An auth email: its heading and body on a card, and a footer naming the app, linked to its home page. */
+const AuthEmailLayout = ({ app, preview, heading, children }) => /* @__PURE__ */ jsxs(Html, {
+	lang: "en",
+	children: [
+		/* @__PURE__ */ jsx(Head, {}),
+		/* @__PURE__ */ jsx(Preview, { children: preview }),
+		/* @__PURE__ */ jsx(Body, {
+			style: styles.body,
+			children: /* @__PURE__ */ jsxs(Container, {
+				style: styles.container,
+				children: [
+					/* @__PURE__ */ jsx(Heading, {
+						as: "h1",
+						style: styles.heading,
+						children: heading
+					}),
+					children,
+					/* @__PURE__ */ jsx(Hr, { style: styles.rule }),
+					/* @__PURE__ */ jsx(Text, {
+						style: styles.footer,
+						children: /* @__PURE__ */ jsx(Link, {
+							href: app.url,
+							style: styles.footerLink,
+							children: app.name
+						})
+					})
+				]
+			})
+		})
+	]
+});
+/** A code to type in, on a line of its own in both parts. */
+const EmailCode = ({ code }) => /* @__PURE__ */ jsx(Text, {
+	style: styles.code,
+	children: code
+});
+/** A remark below the message, such as what to do when the email was not expected. */
+const EmailNote = ({ children }) => /* @__PURE__ */ jsx(Text, {
+	style: styles.note,
+	children
+});
+/** The email's one action, such as signing in: a button, and the label with the link in the plain-text part. */
+const EmailButton = ({ href, children }) => /* @__PURE__ */ jsx(Button, {
+	href,
+	style: styles.button,
+	children
+});
+//#endregion
+export { AuthEmailLayout, EmailButton, EmailCode, EmailNote };

package/dist/better-auth/auth-mail/auth-emails.d.ts

@@ -0,0 +1,7 @@
+import "./account-exists-email.js";
+import "./invitation-email.js";
+import "./reset-password-email.js";
+import "./sign-in-code-email.js";
+import "./sign-up-code-email.js";
+import "./staff-sign-in-email.js";
+import "./two-factor-code-email.js";

package/dist/better-auth/auth-mail/auth-emails.js

@@ -0,0 +1,8 @@
+import { accountExistsEmail } from "./account-exists-email.js";
+import { invitationEmail } from "./invitation-email.js";
+import { resetPasswordEmail } from "./reset-password-email.js";
+import { signInCodeEmail } from "./sign-in-code-email.js";
+import { signUpCodeEmail } from "./sign-up-code-email.js";
+import { staffSignInEmail } from "./staff-sign-in-email.js";
+import { twoFactorCodeEmail } from "./two-factor-code-email.js";
+export { accountExistsEmail, invitationEmail, resetPasswordEmail, signInCodeEmail, signUpCodeEmail, staffSignInEmail, twoFactorCodeEmail };

package/dist/better-auth/auth-mail/invitation-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/invitation-email.js

@@ -0,0 +1,38 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailButton, EmailNote } from "./auth-email-layout.js";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/invitation-email.tsx
+const InvitationEmail = ({ app, inviter, organization, url, expiresAt }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `${inviter} invites you to join ${organization}`,
+	heading: `Join ${organization}`,
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			inviter,
+			" invites you to join ",
+			organization,
+			" on ",
+			app.name,
+			". To accept, open this link:"
+		] }),
+		/* @__PURE__ */ jsx(EmailButton, {
+			href: url,
+			children: "Accept the invitation"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"The link works until ",
+			expiresAt.toUTCString(),
+			"."
+		] }),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If you do not want to join, ignore this email: nothing happens without you." })
+	]
+});
+/** The invitation email: who invites whom to which organization, the link, and until when it works. */
+const invitationEmail = defineEmail({
+	name: "invitation",
+	subject: ({ organization, app }) => `Join ${organization} on ${app.name}`,
+	component: InvitationEmail
+});
+//#endregion
+export { invitationEmail };

package/dist/better-auth/auth-mail/mailing-app.js

@@ -0,0 +1,11 @@
+//#region src/better-auth/auth-mail/mailing-app.ts
+/**
+* The app as an auth email names it: `appName`, and the home page on the origin of `requestURL`, a URL on the origin
+* the request came to (such as Better Auth's `ctx.context.baseURL`), or on `baseURL`'s origin without one.
+*/
+const mailingApp = ({ appName, baseURL }, requestURL) => ({
+	name: appName,
+	url: new URL("/", requestURL ?? baseURL).href
+});
+//#endregion
+export { mailingApp };

package/dist/better-auth/auth-mail/reset-password-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/reset-password-email.js

@@ -0,0 +1,35 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailButton, EmailNote } from "./auth-email-layout.js";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/reset-password-email.tsx
+const ResetPasswordEmail = ({ app, url, lifetime }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `Choose a new password for ${app.name}`,
+	heading: "Reset your password",
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"Someone asked to reset the password of your account with ",
+			app.name,
+			". To choose a new password, open this link:"
+		] }),
+		/* @__PURE__ */ jsx(EmailButton, {
+			href: url,
+			children: "Choose a new password"
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"The link works for ",
+			lifetime,
+			", once."
+		] }),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If you did not ask for this, ignore this email: your password stays as it is." })
+	]
+});
+/** The reset email: the link, how long it works, and that it can be ignored. */
+const resetPasswordEmail = defineEmail({
+	name: "reset-password",
+	subject: ({ app }) => `Reset your ${app.name} password`,
+	component: ResetPasswordEmail
+});
+//#endregion
+export { resetPasswordEmail };

package/dist/better-auth/auth-mail/send-auth-email.d.ts

@@ -0,0 +1 @@
+import "./auth-emails.js";

package/dist/better-auth/auth-mail/send-auth-email.js

@@ -0,0 +1,15 @@
+import { mailingApp } from "./mailing-app.js";
+//#region src/better-auth/auth-mail/send-auth-email.ts
+/**
+* Renders the auth email `name` for `data`, with the app it comes from on the origin of `requestURL` (see `mailingApp`),
+* and sends it to `to`. The templates, and React Email with them, are imported on the first auth email sent, so
+* starting the server loads neither.
+*/
+const sendAuthEmail = async (mail, name, to, data, requestURL) => {
+	await (await import("./auth-emails.js"))[name].send(to, {
+		...data,
+		app: mailingApp(mail, requestURL)
+	}, mail.mailer);
+};
+//#endregion
+export { sendAuthEmail };

package/dist/better-auth/auth-mail/sign-in-code-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/sign-in-code-email.js

@@ -0,0 +1,32 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailCode, EmailNote } from "./auth-email-layout.js";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/sign-in-code-email.tsx
+const SignInCodeEmail = ({ app, code, lifetime }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `Your code to sign in to ${app.name}`,
+	heading: "Your sign-in code",
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"Use this code to sign in to ",
+			app.name,
+			":"
+		] }),
+		/* @__PURE__ */ jsx(EmailCode, { code }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"It works for ",
+			lifetime,
+			", once."
+		] }),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If you did not try to sign in, ignore this email: nobody can sign in without the code." })
+	]
+});
+/** The email with a code to sign in with instead of a password. */
+const signInCodeEmail = defineEmail({
+	name: "sign-in-code",
+	subject: ({ app }) => `Your ${app.name} sign-in code`,
+	component: SignInCodeEmail
+});
+//#endregion
+export { signInCodeEmail };

package/dist/better-auth/auth-mail/sign-up-code-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/sign-up-code-email.js

@@ -0,0 +1,32 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailCode, EmailNote } from "./auth-email-layout.js";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/sign-up-code-email.tsx
+const SignUpCodeEmail = ({ app, code, lifetime }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `Your code to create an account with ${app.name}`,
+	heading: "Create your account",
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"Use this code to create your account with ",
+			app.name,
+			":"
+		] }),
+		/* @__PURE__ */ jsx(EmailCode, { code }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"It works for ",
+			lifetime,
+			", once."
+		] }),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If you did not try to create an account, ignore this email: nobody can create one for your address without the code." })
+	]
+});
+/** The email with the code that makes an account for the address. */
+const signUpCodeEmail = defineEmail({
+	name: "sign-up-code",
+	subject: ({ app }) => `Your code to create an account with ${app.name}`,
+	component: SignUpCodeEmail
+});
+//#endregion
+export { signUpCodeEmail };

package/dist/better-auth/auth-mail/staff-sign-in-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/staff-sign-in-email.js

@@ -0,0 +1,39 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailNote } from "./auth-email-layout.js";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/staff-sign-in-email.tsx
+const StaffSignInEmail = ({ app, staff, reason, expiresAt }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `${staff} signed in as you to help`,
+	heading: "Staff signed in as you",
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			staff,
+			", of the team that runs ",
+			app.name,
+			", signed in as you to help. The reason they gave:"
+		] }),
+		/* @__PURE__ */ jsx(Text, {
+			style: {
+				borderLeft: "3px solid #e4e4e7",
+				paddingLeft: "12px"
+			},
+			children: reason
+		}),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"Their session ends by ",
+			expiresAt.toUTCString(),
+			". The app's admins see it in the app's log of staff sign-ins."
+		] }),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If you did not expect this, tell your admin." })
+	]
+});
+/** The email to someone whose app lets staff sign in as people only when they are told: who, why, and until when. */
+const staffSignInEmail = defineEmail({
+	name: "staff-sign-in",
+	subject: ({ app }) => `Staff signed in to ${app.name} as you`,
+	component: StaffSignInEmail
+});
+//#endregion
+export { staffSignInEmail };

package/dist/better-auth/auth-mail/two-factor-code-email.d.ts

@@ -0,0 +1 @@
+import "../../index.js";

package/dist/better-auth/auth-mail/two-factor-code-email.js

@@ -0,0 +1,32 @@
+import { defineEmail } from "../../mail/define-email.js";
+import { AuthEmailLayout, EmailCode, EmailNote } from "./auth-email-layout.js";
+import { Text } from "react-email";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/better-auth/auth-mail/two-factor-code-email.tsx
+const TwoFactorCodeEmail = ({ app, code, lifetime }) => /* @__PURE__ */ jsxs(AuthEmailLayout, {
+	app,
+	preview: `Your code to finish signing in to ${app.name}`,
+	heading: "Finish signing in",
+	children: [
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"Use this code to finish signing in to ",
+			app.name,
+			":"
+		] }),
+		/* @__PURE__ */ jsx(EmailCode, { code }),
+		/* @__PURE__ */ jsxs(Text, { children: [
+			"It works for ",
+			lifetime,
+			", once."
+		] }),
+		/* @__PURE__ */ jsx(EmailNote, { children: "If you did not just sign in, someone else may know your password or have your sign-in code: change your password." })
+	]
+});
+/** The email with the second step of a sign-in, for an account with two-factor authentication by email. */
+const twoFactorCodeEmail = defineEmail({
+	name: "two-factor-code",
+	subject: ({ app }) => `Your ${app.name} verification code`,
+	component: TwoFactorCodeEmail
+});
+//#endregion
+export { twoFactorCodeEmail };