Monorepo (pnpm workspaces) with two deployable apps and three pure packages. apps/api (Hono on Node): Zod validated env that fails fast and names the problem, Kysely factories for SQLite and Postgres chosen by DATABASE_URL scheme, portable migrations covering the whole SPEC section 5 schema, Better Auth with the four roles and seeded demo accounts, localized error envelope, /healthz and /readyz, graceful SIGTERM drain. Dialect specific SQL is confined to the two factories. apps/web (Next.js App Router): locale routed shell in es and en with a language switcher, sign in screen, and a runtime /api proxy so the browser only ever sees one origin and cookies stay first party. packages/i18n ships both catalogs complete; es is generated from COPY.md and a test re-derives it from the document on every run so it cannot drift. packages/contracts holds the Zod schemas and the typed client the web app uses. Verified: 43 vitest tests, 14 Playwright tests on mobile and desktop, typecheck and lint clean, migrate and seed from a clean database, sign in through the proxy with CSRF rejection of foreign origins. Not verified here: docker compose. This user has no access to the docker socket. RULES.md is absent from docs/, so packages/rules exports only RULES_VERSION and no tax rule, check digit or deadline was invented. See DECISIONS.md. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
34 lines
1.2 KiB
TypeScript
34 lines
1.2 KiB
TypeScript
/** Adding a locale: add the code here and add one catalog file. Nothing else. */
|
|
export const SUPPORTED_LOCALES = ['es', 'en'] as const;
|
|
|
|
export type Locale = (typeof SUPPORTED_LOCALES)[number];
|
|
|
|
export const DEFAULT_LOCALE: Locale = 'es';
|
|
|
|
export function isLocale(value: unknown): value is Locale {
|
|
return typeof value === 'string' && (SUPPORTED_LOCALES as readonly string[]).includes(value);
|
|
}
|
|
|
|
/**
|
|
* Picks a locale from an `Accept-Language` header. Used by the API only as the
|
|
* last fallback: a stored `profiles.locale` always wins when the user is known.
|
|
*/
|
|
export function localeFromAcceptLanguage(header: string | null | undefined): Locale {
|
|
if (!header) return DEFAULT_LOCALE;
|
|
const ranked = header
|
|
.split(',')
|
|
.map((part) => {
|
|
const [tag = '', ...rest] = part.trim().split(';');
|
|
const q = rest.find((p) => p.trim().startsWith('q='))?.split('=')[1];
|
|
return { tag: tag.trim().toLowerCase(), q: q ? Number(q) : 1 };
|
|
})
|
|
.filter((entry) => entry.tag.length > 0 && Number.isFinite(entry.q))
|
|
.sort((a, b) => b.q - a.q);
|
|
|
|
for (const { tag } of ranked) {
|
|
const base = tag.split('-')[0];
|
|
if (isLocale(base)) return base;
|
|
}
|
|
return DEFAULT_LOCALE;
|
|
}
|