@redeemid/emdash 0.0.9 → 0.0.10

package/README.md

@@ -2,7 +2,7 @@
 
 Shopify customer accounts, member levels and paywalls for [EmDash](https://github.com/emdash-cms/emdash) sites. Shopify runs the store and the customer account; EmDash runs the content.
 
-**Status: 0.0.9, early.** Runs on Node and Cloudflare Workers. Sign-in, the member mirror, webhooks, levels, rules, the meter and drip, teasers, badges, the page gate, the Shopify cart and checkout, the staff tools and outbound events are covered by an end-to-end test against a fake store.
+**Status: 0.0.10, early.** Runs on Node and Cloudflare Workers. Sign-in, the member mirror, webhooks, levels, rules, the meter and drip, teasers, badges, the page gate, the Shopify cart and checkout, the staff tools, preferences, protected files, replacement text and outbound events are covered by an end-to-end test against a fake store.
 
 ## What it does
 
@@ -22,6 +22,9 @@ Shopify customer accounts, member levels and paywalls for [EmDash](https://githu
 - **Shop.** `<Product>`, `<Collection>` and `<CartView>` (with the Product and Collection blocks) give the site product pages, collection grids and a cart page with quantities and discount codes. `<Contribution>` (and its block) takes pay-what-you-want amounts. Carts note the page each sale started on.
 - **Features.** Name perks members hold through levels or tags (ad-free, a supporter thank-you) and show them with `<Feature>` or `hasFeature()`.
 - **In the admin.** RedeemID shows under Plugins with a Members page (Shopify customers, tags, levels; open a member to resync them or add and remove tags, which are written to Shopify), a bulk resync you start yourself, a Status page (secrets, store discovery, webhook subscriptions with a Register button, recent deliveries, levels and rules), an Access test and a dashboard widget.
+- **Member preferences.** Members see and change customer fields you define in Shopify, such as topics or a newsletter choice, with `<Preferences>` or its block. Answers are saved on the Shopify customer, ready for Flow, segments and email; the site keeps no copy.
+- **Protected files.** Put uploads in a media folder named in `files`, and every download checks the reader's levels, features or the entries that use the file. Copied links are no use to anyone else.
+- **Replacement text.** Put any string members and visitors see in your own words, one string at a time, with `text`.
 - **Outbound events.** Signed JSON POSTs to a URL of yours when a member signs in, their levels change, or they use the meter, for a CRM, an email tool or your own code.
 - **Keeps members out of EmDash's own APIs**, so the gate is the only way to read locked content.
 
@@ -135,6 +138,74 @@ import { hasFeature } from "@redeemid/emdash/features";
 {!(await hasFeature(Astro, "ad-free")) && <aside class="ad">…</aside>}
 ```
 
+### Preferences
+
+```ts
+preferences: [
+	{ key: "preferences.topics" },                  // members can change it
+	{ key: "preferences.level", access: "view" },   // members only see it
+],
+```
+
+Define each field in Shopify (**Settings → Custom data → Customers**). The definition sets its name, type and limits, such as allowed choices or a minimum and maximum. List the ones members get in `preferences`, in the order to show them. Reading and saving use the Admin API app (`REDEEMID_SHOPIFY_ADMIN_APP_CLIENT_ID`, with `read_customers` and `write_customers`), always on the signed-in member's own customer. Fields in the `membership` namespace are never offered. Preferences never open content.
+
+`<Preferences>` (or the Preferences block) is a form with a control for each field. It works without JavaScript and comes back with the `preferences_saved`, `preferences_refused` or `preferences_unavailable` notice. Visitors see its `signed-out` slot.
+
+| Shopify type | Value |
+| --- | --- |
+| Single line text | A string; with choices, one of them |
+| Multi-line text | A string |
+| List of single line text | A list of strings; with choices, each one of them |
+| True or false | `true` or `false` |
+| Integer | A whole number |
+| Decimal | A number, as a string |
+| Date | `YYYY-MM-DD` |
+
+Every value is checked against the definition before it goes to Shopify; one refusal saves nothing, and an empty value clears the field. Scripts can use `/_emdash/api/auth/redeemid/preferences` too: `GET` returns `{ fields }` with values, `POST` with JSON `{ values: { "namespace.key": value } }` saves. A refused save answers `400` with `fields` mapping each key to `unknown_field`, `read_only`, `invalid_type`, `invalid_choice`, `invalid_length` or `invalid_range`. Saves are limited to 10 a minute per member (`429`). From your own code, `readPreferences()` and `savePreferences()` in `@redeemid/emdash/preferences` do the same.
+
+A save sends the `preferences.saved` event with the field names changed, never the answers.
+
+### Protected files
+
+```ts
+files: [
+	{ folder: "Gold downloads", levels: ["gold"] },
+	{ folder: "Member downloads", levels: [] },             // any signed-in member
+	{ folder: "Supporter extras", features: ["supporter"] },
+	{ folder: "Story files", entries: true },               // whoever can read an entry that uses it
+],
+```
+
+Upload files into a folder in the EmDash media library. Folder names match without regard to case. Every request for a file in a protected folder at `/_emdash/api/media/file/…` is checked before EmDash serves it:
+
+- **Allowed:** the file, sent with `Cache-Control: private, no-store`.
+- **Signed out:** a 401 page with a sign-in link that comes back to the file.
+- **Signed in without access:** a 403 page.
+
+A rule lets in members who hold any of its `levels` (an empty list means any signed-in member) or `features`. With `entries: true`, it also lets in whoever can read a published entry that uses the file: its rule, its drip, and the levels picked on its Paywall break or Members only parts. Staff can always download. Disabled members can't. If a file can't be checked, it isn't served.
+
+Limits:
+
+- Only EmDash's file route is checked. Don't give the storage bucket a public URL of its own.
+- Image services that fetch the file without the reader's cookies, such as a CDN image resizer, get refused, so keep protected images out of resized `<Image>` output.
+- Moving a file out of the folder makes it public again.
+
+### Replacement text
+
+```ts
+text: {
+	"Sign in": "Log in",
+	"This is for members. {signIn} to read on.": "Members only. {signIn} to keep reading.",
+	"This is for {level} members.": "{level} members only.",
+},
+```
+
+Each key is a string's original English; its value is the new text. Only the strings you name change. There is no find-and-replace across strings, so replacing "Sign in" leaves "Sign in to download this file." alone: to change a word everywhere, replace each string that uses it. `STRINGS` in `@redeemid/emdash/text` lists every string, grouped by where it shows (account, badge, cart, wall, meter, member card, notices, plan, preferences, product, files).
+
+Some strings have placeholders such as `{level}` or `{signIn}` (a link), filled in when the text shows. A replacement may use its original's placeholders, in any order or not at all, but no others. Text is plain: HTML in a replacement shows as typed. A replacement that uses another placeholder, or names a string RedeemID doesn't show, is ignored, so the original shows, and the Status page lists it with the reason.
+
+Props win over `text`: a `label` or `title` you pass, or Notices `messages`, is used as given. Staff screens in the admin aren't covered.
+
 ### Events
 
 ```ts
@@ -149,12 +220,13 @@ With `REDEEMID_EVENTS_SECRET` set, RedeemID POSTs `{ id, event, at, data }` to t
 | `member.levels_changed` | `customerId`, `levels`, `added`, `removed`, `source` (`sign-in`, the webhook topic, or a staff resync or tag edit) |
 | `meter.used` | `userId` (EmDash), `entry` (`collection:id`), `used`, `limit`, `period` (`2026-11`, or `2026-W45` by week) |
 | `meter.exhausted` | the same, sent with the last free read |
+| `preferences.saved` | `customerId`, `fields` (the `namespace.key` names changed) |
 
 No event carries an email address or a name: match people by the Shopify `customerId`. `only` limits which events are sent; leave it out for all of them.
 
 ### Staff tools
 
-With `REDEEMID_SHOPIFY_ADMIN_APP_CLIENT_ID` set, RedeemID gets an Admin API token for the webhook app with the client credentials grant (the app must belong to the same Shopify organization as the store, as Dev Dashboard apps do) and needs the `read_customers` and `write_customers` scopes. Then, in the admin:
+With `REDEEMID_SHOPIFY_ADMIN_APP_CLIENT_ID` set (it also runs member preferences), RedeemID gets an Admin API token for the webhook app with the client credentials grant (the app must belong to the same Shopify organization as the store, as Dev Dashboard apps do) and needs the `read_customers` and `write_customers` scopes. Then, in the admin:
 
 - **Member detail.** Open a member from the Members page to see their levels, tags and features, resync them from Shopify, or add and remove tags. Tag edits are made in Shopify, then read back; nothing is granted on the EmDash side.
 - **Bulk resync.** Reads the 50 members synced longest ago from Shopify in one request. Run it again for the next 50. It never runs on its own.

package/docs/shopify-setup.md

@@ -29,7 +29,7 @@ RedeemID keeps tags and status current from webhooks. Point these topics at `htt
 
 Subscribe them from a Shopify app on the store (for example a Dev Dashboard app). If the app already sends webhooks to another site, add this URL as extra subscriptions. `customers/merge` needs the `read_customer_merge` scope. Shopify signs every webhook with that app's **client secret**, which is the site's webhook secret.
 
-For the staff tools (member resync, tag edits written to Shopify, the Register webhooks button), give the same app the `read_customers` and `write_customers` Admin API scopes and set its **client ID** as well. RedeemID uses the client credentials grant, which works when the app and the store are in the same Shopify organization.
+For the staff tools (member resync, tag edits written to Shopify, the Register webhooks button) and member preferences, give the same app the `read_customers` and `write_customers` Admin API scopes and set its **client ID** as well. RedeemID uses the client credentials grant, which works when the app and the store are in the same Shopify organization.
 
 ## 3. The site
 
@@ -57,4 +57,4 @@ The Workers free plan is enough: RedeemID is a native plugin and doesn't need sa
 3. Click **Sign in**, sign in with that customer's email, and you come back to the post, unlocked.
 4. Add or remove the tag in Shopify; the post opens or locks again once the webhook arrives.
 
-If sign-in sends you back with `?redeemid_notice=…`, the code says why: `not_configured` (secrets or `shop` missing), `sign_in_unavailable` (store discovery failed), `sign_in_expired`, `staff_account`, `site_not_ready`, `email_required`, `token_failed`, `bad_id_token`, `identity_failed`. A Buy button can return `plan_unavailable` (no such product, or sold out) or `checkout_failed`. The Cart link returns `cart_empty` when there's nothing in the cart, and Account returns `account_unavailable` when store discovery fails. Cart changes return `cart_added`, `cart_updated`, `discount_applied` or `discount_not_applicable`. Refresh membership returns `refreshed` once it has read the member's tags again.
+If sign-in sends you back with `?redeemid_notice=…`, the code says why: `not_configured` (secrets or `shop` missing), `sign_in_unavailable` (store discovery failed), `sign_in_expired`, `staff_account`, `site_not_ready`, `email_required`, `token_failed`, `bad_id_token`, `identity_failed`. A Buy button can return `plan_unavailable` (no such product, or sold out) or `checkout_failed`. The Cart link returns `cart_empty` when there's nothing in the cart, and Account returns `account_unavailable` when store discovery fails. Cart changes return `cart_added`, `cart_updated`, `discount_applied` or `discount_not_applicable`. Refresh membership returns `refreshed` once it has read the member's tags again. Preferences return `preferences_saved`, `preferences_refused` or `preferences_unavailable`.

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@redeemid/emdash",
-	"version": "0.0.9",
+	"version": "0.0.10",
 	"description": "Shopify customer accounts, member levels and paywalls for EmDash sites. Shopify runs commerce; EmDash runs content.",
 	"type": "module",
 	"license": "MIT",
@@ -17,6 +17,8 @@
 		"./storefront": "./src/storefront.ts",
 		"./features": "./src/features.ts",
 		"./events": "./src/events.ts",
+		"./preferences": "./src/preferences.ts",
+		"./text": "./src/text.ts",
 		"./plugin": "./src/plugin.ts",
 		"./blocks": "./src/blocks/index.ts",
 		"./components/*": "./src/components/*",

package/src/access.ts

@@ -277,11 +277,11 @@ export function passes(held: string[], required: string[][]): boolean {
  * The requirement in words, for badges and admin pages: "Gold + Silver",
  * "Silver or Gold", "Signed in". `null` gives `open`.
  */
-export function describe(required: Requirement, levels: LevelConfig[] = [], open = "Free"): string {
+export function describe(required: Requirement, levels: LevelConfig[] = [], open = "Free", signedIn = "Signed in"): string {
 	if (required === null) return open;
 	const name = (slug: string) => levels.find((l) => l.slug === slug)?.name ?? slug;
 	const parts = reduce(required).filter((c) => c.length > 0).map((c) => c.map(name).join(" or "));
-	return parts.length ? parts.join(" + ") : "Signed in";
+	return parts.length ? parts.join(" + ") : signedIn;
 }
 
 /**

package/src/blocks/ContributionBlock.astro

@@ -18,7 +18,7 @@ const amounts = (node.amounts ?? "")
 	<Contribution
 		handle={handle}
 		title={node.title?.trim() || undefined}
-		label={node.label?.trim() || "Give"}
+		label={node.label?.trim() || undefined}
 		amounts={amounts.length ? amounts : undefined}
 	/>
 )}

package/src/blocks/PlanBlock.astro

@@ -10,4 +10,4 @@ const { node } = Astro.props;
 const handle = (node.handle ?? "").trim();
 ---
 
-{handle && <Plan handle={handle} title={node.title?.trim() || undefined} label={node.label?.trim() || "Join"} levels={Array.isArray(node.levels) ? node.levels : []} />}
+{handle && <Plan handle={handle} title={node.title?.trim() || undefined} label={node.label?.trim() || undefined} levels={Array.isArray(node.levels) ? node.levels : []} />}

package/src/blocks/PreferencesBlock.astro

@@ -0,0 +1,12 @@
+---
+/** The "Preferences" block: the signed-in member's preferences form. */
+import Preferences from "../components/Preferences.astro";
+
+interface Props {
+	node: { title?: string; label?: string };
+}
+
+const { node } = Astro.props;
+---
+
+<Preferences title={node.title?.trim() || undefined} label={node.label?.trim() || undefined} />

package/src/blocks/index.ts

@@ -6,6 +6,7 @@ import Marker from "./PaywallBreak.astro";
 import CollectionBlock from "./CollectionBlock.astro";
 import ContributionBlock from "./ContributionBlock.astro";
 import PlanBlock from "./PlanBlock.astro";
+import PreferencesBlock from "./PreferencesBlock.astro";
 import ProductBlock from "./ProductBlock.astro";
 
 export const blockComponents = {
@@ -16,4 +17,5 @@ export const blockComponents = {
 	"redeemid-product": ProductBlock,
 	"redeemid-collection": CollectionBlock,
 	"redeemid-contribution": ContributionBlock,
+	"redeemid-preferences": PreferencesBlock,
 };

package/src/blocks-names.ts

@@ -4,6 +4,7 @@ export const PLAN_BLOCK = "redeemid-plan";
 export const PRODUCT_BLOCK = "redeemid-product";
 export const COLLECTION_BLOCK = "redeemid-collection";
 export const CONTRIBUTION_BLOCK = "redeemid-contribution";
+export const PREFERENCES_BLOCK = "redeemid-preferences";
 /** Starts a members-only part of the body; it runs to the next end block. */
 export const MEMBERS_BLOCK = "redeemid-members";
 export const MEMBERS_END_BLOCK = "redeemid-members-end";

package/src/components/AccessBadge.astro

@@ -12,6 +12,7 @@
 import { canRead, describe, entryRequirement, type Terms } from "../access.js";
 import { splitAtPaywall } from "../blocks-names.js";
 import { siteConfig } from "../site-config.js";
+import { text } from "../text.js";
 
 interface Props {
 	collection: string;
@@ -22,13 +23,13 @@ interface Props {
 	class?: string;
 }
 
-const { collection, terms, content, free = "Free", class: className } = Astro.props;
 const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).emdash?.config);
+const { collection, terms, content, free = text(config, "Free"), class: className } = Astro.props;
 const split = splitAtPaywall(content);
 const required = split.paywall && split.levels.length
 	? [split.levels]
 	: await entryRequirement(config, collection, terms);
-const label = describe(required, config?.levels, free);
+const label = describe(required, config?.levels, free, text(config, "Signed in"));
 const locked = required !== null && !(await canRead(Astro, { collection, terms }, { required })).allowed;
 const slugs = required?.flat().join(" ") || (required ? "signed-in" : "free");
 ---
@@ -40,6 +41,6 @@ const slugs = required?.flat().join(" ") || (required ? "signed-in" : "free");
 	>
 		{locked && <span class="redeemid-badge__lock" aria-hidden="true">🔒&#xFE0E; </span>}
 		{label}
-		{locked && <span style="position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap"> (locked)</span>}
+		{locked && <span style="position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap">{text(config, " (locked)")}</span>}
 	</span>
 )}

package/src/components/Account.astro

@@ -4,6 +4,7 @@
  */
 import { siteConfig } from "../site-config.js";
 import { accountUrl, signInUrl, signOutUrl, viewer } from "../access.js";
+import { text } from "../text.js";
 
 const v = await viewer(Astro);
 const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).emdash?.config);
@@ -14,14 +15,14 @@ const names = (config?.levels ?? []).filter((l) => v.levels.includes(l.slug)).ma
 <div class="redeemid-account" data-redeemid-signed-in={v.signedIn ? "true" : "false"}>
 	{v.signedIn ? (
 		<>
-			<span class="redeemid-account__who">{v.member?.firstName ?? v.member?.email ?? "Signed in"}</span>
+			<span class="redeemid-account__who">{v.member?.firstName ?? v.member?.email ?? text(config, "Signed in")}</span>
 			{names.length > 0 && <span class="redeemid-account__levels">{names.join(", ")}</span>}
-			<a class="redeemid-account__link" href={accountUrl(here)}>Account</a>
+			<a class="redeemid-account__link" href={accountUrl(here)}>{text(config, "Account")}</a>
 			<form method="post" action={signOutUrl(here)}>
-				<button type="submit">Sign out</button>
+				<button type="submit">{text(config, "Sign out")}</button>
 			</form>
 		</>
 	) : (
-		<a href={signInUrl(here)}>{config?.label ?? "Sign in"}</a>
+		<a href={signInUrl(here)}>{config?.label ?? text(config, "Sign in")}</a>
 	)}
 </div>

package/src/components/Cart.astro

@@ -5,12 +5,15 @@
  */
 import { cartUrl } from "../access.js";
 import { readCart } from "../cart.js";
+import { siteConfig } from "../site-config.js";
+import { text } from "../text.js";
 
 interface Props {
 	label?: string;
 }
 
-const { label = "Cart" } = Astro.props;
+const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).emdash?.config);
+const { label = text(config, "Cart") } = Astro.props;
 const ref = await readCart(Astro.session);
 const count = ref?.count ?? 0;
 const here = Astro.url.pathname + Astro.url.search;

package/src/components/CartView.astro

@@ -11,6 +11,7 @@ import { cartUrl } from "../access.js";
 import { readCart, saveCart } from "../cart.js";
 import { siteConfig } from "../site-config.js";
 import { cartDetails, money, type CartDetails } from "../storefront.js";
+import { text } from "../text.js";
 
 interface Props {
 	/** Link for each line's product; `{handle}` is replaced. */
@@ -19,8 +20,8 @@ interface Props {
 	empty?: string;
 }
 
-const { productHref, empty = "Your cart is empty." } = Astro.props;
 const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).emdash?.config);
+const { productHref, empty = text(config, "Your cart is empty.") } = Astro.props;
 const ref = await readCart(Astro.session);
 let cart: CartDetails | null = null;
 let failed = false;
@@ -43,7 +44,7 @@ const code = cart?.discountCodes[0];
 
 <section class="redeemid-cartview" data-redeemid-cart-count={cart?.totalQuantity ?? 0}>
 	{failed ? (
-		<p>Your cart isn't available right now. Try again in a few minutes.</p>
+		<p>{text(config, "Your cart isn't available right now. Try again in a few minutes.")}</p>
 	) : !cart || cart.lines.length === 0 ? (
 		<p class="redeemid-cartview__empty">{empty}</p>
 	) : (
@@ -57,20 +58,20 @@ const code = cart?.discountCodes[0];
 								{href(l.productHandle) ? <a href={href(l.productHandle)}>{l.productTitle}</a> : l.productTitle}
 								{l.variantTitle && l.variantTitle !== "Default Title" && <span> · {l.variantTitle}</span>}
 							</p>
-							<p class="redeemid-cartview__price">{money(l.price)} each · {money(l.total)}</p>
+							<p class="redeemid-cartview__price">{text(config, "{price} each · {total}", { price: money(l.price), total: money(l.total) })}</p>
 							<form method="post" action={action} class="redeemid-cartview__quantity">
 								<input type="hidden" name="action" value="update" />
 								<input type="hidden" name="line" value={l.id} />
 								<input type="hidden" name="return" value={here} />
-								<label for={`q-${l.id}`}>Quantity</label>
+								<label for={`q-${l.id}`}>{text(config, "Quantity")}</label>
 								<input id={`q-${l.id}`} name="quantity" type="number" min="0" max="1000" value={l.quantity} inputmode="numeric" />
-								<button type="submit">Update</button>
+								<button type="submit">{text(config, "Update")}</button>
 							</form>
 							<form method="post" action={action}>
 								<input type="hidden" name="action" value="remove" />
 								<input type="hidden" name="line" value={l.id} />
 								<input type="hidden" name="return" value={here} />
-								<button type="submit" class="redeemid-cartview__remove">Remove<span style="position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap"> {l.productTitle}</span></button>
+								<button type="submit" class="redeemid-cartview__remove">{text(config, "Remove")}<span style="position:absolute;width:1px;height:1px;overflow:hidden;clip:rect(0 0 0 0);white-space:nowrap"> {l.productTitle}</span></button>
 							</form>
 						</div>
 					</li>
@@ -79,19 +80,19 @@ const code = cart?.discountCodes[0];
 			<form method="post" action={action} class="redeemid-cartview__discount">
 				<input type="hidden" name="action" value="discount" />
 				<input type="hidden" name="return" value={here} />
-				<label for="redeemid-discount">Discount code</label>
+				<label for="redeemid-discount">{text(config, "Discount code")}</label>
 				<input id="redeemid-discount" name="code" type="text" value={code?.code ?? ""} autocomplete="off" />
-				<button type="submit">Apply</button>
-				{code && !code.applicable && <p class="redeemid-cartview__code-note">{code.code} doesn't apply to this cart.</p>}
+				<button type="submit">{text(config, "Apply")}</button>
+				{code && !code.applicable && <p class="redeemid-cartview__code-note">{text(config, "{code} doesn't apply to this cart.", { code: code.code })}</p>}
 			</form>
 			<dl class="redeemid-cartview__totals">
-				<dt>Subtotal</dt>
+				<dt>{text(config, "Subtotal")}</dt>
 				<dd>{money(cart.subtotal)}</dd>
-				<dt>Total</dt>
+				<dt>{text(config, "Total")}</dt>
 				<dd>{money(cart.total)}</dd>
 			</dl>
-			<p class="redeemid-cartview__note">Taxes and shipping are worked out at checkout.</p>
-			<a class="redeemid-cartview__checkout" href={cartUrl(here)}>Checkout</a>
+			<p class="redeemid-cartview__note">{text(config, "Taxes and shipping are worked out at checkout.")}</p>
+			<a class="redeemid-cartview__checkout" href={cartUrl(here)}>{text(config, "Checkout")}</a>
 		</>
 	)}
 </section>

package/src/components/Collection.astro

@@ -8,6 +8,7 @@
  */
 import { siteConfig } from "../site-config.js";
 import { collection as loadCollection, money, type Collection } from "../storefront.js";
+import { text } from "../text.js";
 
 interface Props {
 	handle: string;
@@ -45,7 +46,7 @@ const href = (h: string) => productHref?.replaceAll("{handle}", encodeURICompone
 				<li class="redeemid-collection__item" data-redeemid-product={p.handle}>
 					{p.image && <img src={p.image.url} alt={p.image.altText ?? ""} loading="lazy" />}
 					<h3>{href(p.handle) ? <a href={href(p.handle)}>{p.title}</a> : p.title}</h3>
-					<p class="redeemid-collection__price">{p.availableForSale ? (p.price ? `From ${money(p.price)}` : "") : "Sold out"}</p>
+					<p class="redeemid-collection__price">{p.availableForSale ? (p.price ? text(config, "From {price}", { price: money(p.price) }) : "") : text(config, "Sold out")}</p>
 				</li>
 			))}
 		</ul>

package/src/components/Content.astro

@@ -26,6 +26,7 @@ import { PortableText } from "emdash/ui";
 import { canRead, entryRequirement, readEntry, type Terms, type Verdict } from "../access.js";
 import { sections, splitAtPaywall, teaser } from "../blocks-names.js";
 import { siteConfig } from "../site-config.js";
+import { text } from "../text.js";
 import LockedPanel from "./LockedPanel.astro";
 
 interface Props {
@@ -69,14 +70,19 @@ async function parts(blocks: unknown[]) {
 const before = await parts(shown);
 const after = await parts(rest);
 const metered = verdict.reason === "metered" ? (verdict as Verdict) : null;
-const per = metered?.meter?.period === "week" ? "this week" : "this month";
+const week = metered?.meter?.period === "week";
+const left = metered?.meterLeft ?? 0;
+const meterText =
+	left === 0
+		? text(config, week ? "This is your last free read this week." : "This is your last free read this month.")
+		: left === 1
+			? text(config, week ? "You have 1 free read left this week." : "You have 1 free read left this month.")
+			: text(config, week ? "You have {count} free reads left this week." : "You have {count} free reads left this month.", { count: left });
 ---
 
 {metered && (
 	<p class="redeemid-meter" role="status" data-redeemid-left={metered.meterLeft}>
-		{metered.meterLeft === 0
-			? `This is your last free read ${per}.`
-			: `You have ${metered.meterLeft} free ${metered.meterLeft === 1 ? "read" : "reads"} left ${per}.`}
+		{meterText}
 	</p>
 )}
 {before.map((p) =>

package/src/components/Contribution.astro

@@ -9,6 +9,7 @@
  */
 import { siteConfig } from "../site-config.js";
 import { money, product as loadProduct, type Product } from "../storefront.js";
+import { text } from "../text.js";
 
 interface Props {
 	handle: string;
@@ -20,8 +21,8 @@ interface Props {
 	title?: string;
 }
 
-const { handle, amounts = [5, 10, 25], initial = 10, label = "Give", title } = Astro.props;
 const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).emdash?.config);
+const { handle, amounts = [5, 10, 25], initial = 10, label = text(config, "Give"), title } = Astro.props;
 let p: Product | null = null;
 if (config) {
 	try {
@@ -57,13 +58,13 @@ const id = `redeemid-give-${handle}`;
 					</p>
 				)}
 				<p>
-					<label for={`${id}-amount`}>Another amount ({currency})</label>
+					<label for={`${id}-amount`}>{text(config, "Another amount ({currency})", { currency })}</label>
 					<input id={`${id}-amount`} name="quantity" type="number" min="1" max="1000" step="1" value={initial} inputmode="numeric" />
 				</p>
 			</>
 		) : (
 			<p>
-				<label for={`${id}-amount`}>Quantity ({money(variant.price)} each)</label>
+				<label for={`${id}-amount`}>{text(config, "Quantity ({price} each)", { price: money(variant.price) })}</label>
 				<input id={`${id}-amount`} name="quantity" type="number" min="1" max="1000" value="1" inputmode="numeric" />
 			</p>
 		)}

package/src/components/LockedPanel.astro

@@ -10,6 +10,7 @@
  */
 import { passes, signInUrl, type Reason } from "../access.js";
 import { siteConfig } from "../site-config.js";
+import { text, textParts } from "../text.js";
 
 interface Props {
 	reason: Reason;
@@ -32,7 +33,8 @@ const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).em
 const missing = required.find((clause) => clause.length > 0 && !passes(held, [clause]));
 const level = missing ? config?.levels?.find((l) => l.slug === missing[0]) : undefined;
 const joinHref = level?.joinUrl ?? config?.join?.href;
-const joinLabel = config?.join?.label ?? "Become a member";
+const joinLabel = config?.join?.label ?? text(config, "Become a member");
+const week = meterPeriod === "week";
 const here = Astro.url.pathname + Astro.url.search;
 ---
 
@@ -41,24 +43,24 @@ const here = Astro.url.pathname + Astro.url.search;
 	{level?.wall && (reason === "sign_in" || reason === "upgrade") && <p class="redeemid-locked__wall">{level.wall}</p>}
 	{reason === "sign_in" && (
 		<p>
-			This is for members. <a href={signInUrl(here)}>Sign in</a> to read on.
-			{joinHref && <> Not a member yet? <a href={joinHref}>{joinLabel}</a>.</>}
+			{textParts(config, "This is for members. {signIn} to read on.", { signIn: <a href={signInUrl(here)}>{text(config, "Sign in")}</a> })}
+			{joinHref && <> {textParts(config, "Not a member yet? {join}.", { join: <a href={joinHref}>{joinLabel}</a> })}</>}
 		</p>
 	)}
 	{reason === "upgrade" && meterLeft === 0 && (
-		<p class="redeemid-locked__meter">You've used your free reads {meterPeriod === "week" ? "this week" : "this month"}.</p>
+		<p class="redeemid-locked__meter">{text(config, week ? "You've used your free reads this week." : "You've used your free reads this month.")}</p>
 	)}
 	{reason === "drip" && (
 		<p>
-			{opens ? <>This opens for you on <time datetime={opensAt?.toISOString()}>{opens}</time>.</> : "This opens for you after you've been a member a little longer."}
+			{opens ? textParts(config, "This opens for you on {date}.", { date: <time datetime={opensAt?.toISOString()}>{opens}</time> }) : text(config, "This opens for you after you've been a member a little longer.")}
 		</p>
 	)}
 	{reason === "upgrade" && (
 		<p>
-			{level ? `This is for ${level.name} members.` : "Your membership doesn't include this yet."}
+			{level ? text(config, "This is for {level} members.", { level: level.name }) : text(config, "Your membership doesn't include this yet.")}
 			{joinHref && <> <a href={joinHref}>{joinLabel}</a></>}
 		</p>
 	)}
-	{reason === "disabled" && <p>Your account is turned off. Contact the store for help.</p>}
-	{reason === "unconfigured" && <p>This is for members.</p>}
+	{reason === "disabled" && <p>{text(config, "Your account is turned off. Contact the store for help.")}</p>}
+	{reason === "unconfigured" && <p>{text(config, "This is for members.")}</p>}
 </div>

package/src/components/MemberCard.astro

@@ -12,15 +12,16 @@
 import { accountUrl, membership, meterUsage, refreshUrl, signInUrl, signOutUrl, viewer } from "../access.js";
 import { featuresFor } from "../features.js";
 import { siteConfig } from "../site-config.js";
+import { text, textParts } from "../text.js";
 
 interface Props {
 	/** Heading text; the member's first name is added after it. */
 	title?: string;
 }
 
-const { title = "Your membership" } = Astro.props;
-const v = await viewer(Astro);
 const config = siteConfig((Astro.locals as { emdash?: { config?: unknown } }).emdash?.config);
+const { title = text(config, "Your membership") } = Astro.props;
+const v = await viewer(Astro);
 const here = Astro.url.pathname + Astro.url.search;
 const m = v.member;
 const disabled = m?.status === "disabled";
@@ -48,34 +49,34 @@ const join = config?.join;
 				</p>
 			)}
 			{disabled ? (
-				<p class="redeemid-member__disabled">Your account is turned off. Contact the store for help.</p>
+				<p class="redeemid-member__disabled">{text(config, "Your account is turned off. Contact the store for help.")}</p>
 			) : current.length > 0 ? (
 				<ul class="redeemid-member__levels">
 					{current.map((l) => (
 						<li data-redeemid-level={l.slug}>
 							<strong>{l.name}</strong>
-							{date(l.since) && <> since <time datetime={l.since ?? undefined}>{date(l.since)}</time></>}
+							{date(l.since) && <> {textParts(config, "since {date}", { date: <time datetime={l.since ?? undefined}>{date(l.since)}</time> })}</>}
 						</li>
 					))}
 				</ul>
 			) : (
 				<p class="redeemid-member__none">
-					You don't have a membership yet.{join && <> <a href={join.href}>{join.label ?? "Become a member"}</a></>}
+					{text(config, "You don't have a membership yet.")}{join && <> <a href={join.href}>{join.label ?? text(config, "Become a member")}</a></>}
 				</p>
 			)}
 			{features.length > 0 && (
 				<p class="redeemid-member__features">
-					Includes: {features.map((f) => f.name).join(", ")}
+					{text(config, "Includes: {features}", { features: features.map((f) => f.name).join(", ") })}
 				</p>
 			)}
 			{past.length > 0 && (
 				<>
-					<h3 class="redeemid-member__subtitle">Before</h3>
+					<h3 class="redeemid-member__subtitle">{text(config, "Before")}</h3>
 					<ul class="redeemid-member__past">
 						{past.map((l) => (
 							<li data-redeemid-level={l.slug}>
 								{l.name}
-								{date(l.from) ? `, ${date(l.from)} to ${date(l.to)}` : `, until ${date(l.to)}`}
+								{", "}{date(l.from) ? text(config, "{from} to {to}", { from: date(l.from) ?? "", to: date(l.to) ?? "" }) : text(config, "until {to}", { to: date(l.to) ?? "" })}
 							</li>
 						))}
 					</ul>
@@ -83,21 +84,21 @@ const join = config?.join;
 			)}
 			{meter && current.length === 0 && !disabled && (
 				<p class="redeemid-member__meter" data-redeemid-used={meter.used}>
-					Free reads {meter.period === "week" ? "this week" : "this month"}: {meter.used} of {meter.limit} used.
+					{text(config, meter.period === "week" ? "Free reads this week: {used} of {limit} used." : "Free reads this month: {used} of {limit} used.", { used: meter.used, limit: meter.limit })}
 				</p>
 			)}
 			<p class="redeemid-member__actions">
-				<a href={accountUrl(here)}>Orders and details</a>
-				<a href={refreshUrl(here)}>Refresh membership</a>
+				<a href={accountUrl(here)}>{text(config, "Orders and details")}</a>
+				<a href={refreshUrl(here)}>{text(config, "Refresh membership")}</a>
 			</p>
 			<form method="post" action={signOutUrl("/")}>
-				<button type="submit">Sign out</button>
+				<button type="submit">{text(config, "Sign out")}</button>
 			</form>
-			<p class="redeemid-member__note">Just bought a plan? It can take a minute to show here. Refresh membership checks again.</p>
+			<p class="redeemid-member__note">{text(config, "Just bought a plan? It can take a minute to show here. Refresh membership checks again.")}</p>
 		</>
 	) : (
 		<p>
-			<a href={signInUrl(here)}>{config?.label ?? "Sign in"}</a> to see your membership.
+			{textParts(config, "{signIn} to see your membership.", { signIn: <a href={signInUrl(here)}>{config?.label ?? text(config, "Sign in")}</a> })}
 		</p>
 	)}
 </section>