Compare commits

...
Author SHA1 Message Date
jcoffey 1dc0caeae9 Merge pull request #344 from Coffey-Labs/docs/companion-tools
Point to the companion tools near the top of the README
2026-09-13 22:48:01 -07:00
jcoffey-dev 9647ead8d4 Point to the companion tools near the top of the README
ihasmail-oneshot for a new single-host deployment, stalwart-migrator for
an existing 0.15.5 server, each with what it is for and where it starts.
Quick start also says, before its steps, that a host with no Stalwart yet
can use ihasmail-oneshot instead.
2026-09-13 22:46:14 -07:00
jcoffey c587268c97 Merge pull request #343 from Coffey-Labs/docs/features-known-issues-0.16.22
Bring FEATURES and KNOWN-ISSUES up to 0.16.22
2026-09-13 18:00:26 -07:00
jcoffey-dev ce683f94bd Bring FEATURES and KNOWN-ISSUES up to 0.16.22
Both said the live instance runs 0.16.21. KNOWN-ISSUES now records that
0.16.22 was tested and lists what it changed for a client, and notes the one
entry it touches: an event read by its stored id reports a null baseEventId,
while a one-off from an expanded query still carries a base.

The shareWith entry still described calendars and address books leaving the
field out, which 0.16.21 fixed; it now says so, and that Mailbox/get alone
still omits it.
2026-09-13 17:58:50 -07:00
jcoffey 3dd8c7c2dd Merge pull request #342 from Coffey-Labs/mock/stalwart-0.16.22
Follow Stalwart 0.16.22 in the mock
2026-09-13 17:57:27 -07:00
jcoffey-dev de71572b9d Follow Stalwart 0.16.22 in the mock
0.16.22 changed four things a client sees from CalendarEvent/get and
ContactCard/get. Read from its source and the tests that came with it:

- baseEventId is the master's id on a synthetic id and null otherwise; an
  event read by its stored id used to report its own id. A one-off from an
  expanded query still has a synthetic id, so it still carries a base.
- recurrenceRule and recurrenceOverrides named on a synthetic id come back
  null rather than absent.
- useDefaultAlerts is the reader's own and reads false until set.
- an empty properties list returns id alone, for both methods. pick already
  did that, so only a comment changes for contacts.

With properties omitted the stored object comes back as before.

The README said a one-off now carries a null base, which only holds for one
read by its stored id; it now says that, and that the mock follows.
2026-09-13 17:55:36 -07:00
jcoffey 029afc21c4 Merge pull request #341 from Coffey-Labs/docs/stalwart-0.16.22
Say 0.16.22 in the README
2026-09-13 17:52:51 -07:00
jcoffey-dev 64dbb30e70 Credit the testing to 0.16.22, where it was done
The live instance was tested on 0.16.22, not only read against its diff. The
badge says tested against it again, and 0.16.21 becomes the release before.
2026-09-13 17:50:43 -07:00
jcoffey-dev 28acad6865 Say 0.16.22 in the README, and what it changed for a client
The live instance moved to Stalwart 0.16.22 on 2026-09-13. The badge and the
requirements section now say so. The hand validation stays credited to 0.16.21,
because 0.16.22 was read against its diff rather than re-run, and the four
calendar and contacts JMAP changes it makes are listed, along with the fact
that the mock does not follow them yet.
2026-09-13 17:49:08 -07:00
jcoffey 5f808f3033 Merge pull request #340 from Coffey-Labs/fix/translate-admin-errors
Say every Administration refusal in the reader's language
2026-09-13 17:21:07 -07:00
jcoffey-dev 15b1838e21 Say every Administration refusal in the reader's language
Stalwart explains a refused change in English, and several of its words
reached the page as they were: "Invalid domain name" for a reserved TLD,
"Invalid email address" for a catch-all, a grant refusal, and ihasmail's own
proxy messages. Every registry error type now has its own message, and a
value one of the registry's string validators refused is recognised by the
validator's wording and explained again. A domain clash or a missing domain
is worded for a domain rather than an account.

The one exception is kept on purpose: a password policy's reason follows a
translated sentence, because the rule is the server's and dropping it would
leave no way to find out why.

The mock now refuses a reserved TLD and a catch-all without a domain the way
the live server did. KNOWN-ISSUES records the fix, and that the last two live
cases -- an administrator-set password and the outranking guard -- held.

15 new strings in all nine catalogues, 3 retired; strings falling back to
English stay at 16.
2026-09-13 17:18:15 -07:00
jcoffey 822314e8b7 Merge pull request #339 from Coffey-Labs/docs/administration
Record what Administration proved on the live server
2026-09-13 16:49:13 -07:00
jcoffey-dev 5027bd1e73 Record what Administration proved on the live server
KNOWN-ISSUES carried Administration as read from source and untested. It
has now run against production: the Accounts filter was wrong (type, not
@type; fixed in #336) and everything else held -- permission casing, Basic
auth on admin calls, account and domain shapes, the zone file format, DKIM
lookup by domain, catch-all addresses, and removing a domain with its keys.
What remains unproved (an administrator-set password, and the grant-check
gap behind the outranking guard) is said plainly, along with the untranslated
invalidPatch description and the two gates that decide who may administer.

README gains Administration in its feature list and MOCK_ROLE among the mock's
switches.
2026-09-13 16:45:18 -07:00
jcoffey f44987e391 Merge pull request #338 from Coffey-Labs/feat/admin-trusted-device-only
Offer administration only on a device marked as your own
2026-09-13 16:36:45 -07:00
jcoffey b6cc762d23 Merge pull request #337 from Coffey-Labs/feat/admin-nav-in-sidebar
Move Administration's section list into the folder pane
2026-09-13 16:36:22 -07:00
jcoffey-dev f1638b2fee Offer administration only on a device marked as your own
A session signed in without "This is my own device" can no longer
administer. The server withholds the account's permissions from it and the
JMAP proxy refuses registry methods beyond the account's own, the same gate
ADMINISTRATION=0 uses. A borrowed or shared machine is where nobody should
be able to reset a password or remove a domain.

An administrator in such a session still sees Administration in the account
menu, greyed out, with the reason and the fix: sign in again with the box
ticked. The server tells that session only that the account administers.

The gate now reads the body only when it could name a registry method --
"x: in the text, or a \u escape that could spell one -- so ordinary mail
traffic from an untrusted session is forwarded untouched.

1 new string, translated in all nine catalogues, quoting each language's own
label for the tickbox; strings falling back to English stay at 16.
2026-09-13 16:34:20 -07:00
jcoffey-dev 7c0e278ee8 Move Administration's section list into the folder pane
Administration's pages are tables, and the Settings-style second column
took width they need. The list of sections -- Directory > Accounts,
Mail > Domains -- now sits in the folder pane where Mail keeps its folders,
and the page is the open section alone, up to 1120px wide.

On a phone the list is in the drawer like every other section's, so a bare
/admin opens the first section rather than a page that is only a list. The
back link it needed is gone.
2026-09-13 16:27:30 -07:00
jcoffey 93c9660421 Merge pull request #336 from Coffey-Labs/fix/account-type-filter
Filter accounts on @type, the name Stalwart uses
2026-09-13 15:58:52 -07:00
jcoffey-dev 430fc2673c Filter accounts on @type, the name Stalwart uses
The Accounts list sent x:Account/query with {"type": "User"}, and a live
0.16 server refuses it: "unsupportedFilter - type". The registry keys a
filter by the property's name on the object, which for the discriminator is
@type, so the whole list failed to load. {"@type": "User"} is accepted.

The mock took the wrong name without complaint, which is how it shipped. It
now refuses any filter name the real server does not index for that object,
answering the way Stalwart does.
2026-09-13 15:56:16 -07:00
jcoffey b79db9098a Merge pull request #335 from Coffey-Labs/feat/admin-domains
Add Domains to Administration
2026-09-13 15:47:30 -07:00
jcoffey 16e0761ddf Merge pull request #334 from Coffey-Labs/feat/admin-accounts
Add Administration, starting with accounts
2026-09-13 15:46:46 -07:00
jcoffey 5f5672fed3 Merge pull request #333 from Coffey-Labs/fix/multi-server-account-requests
Send account requests to the account's own Stalwart
2026-09-13 15:46:20 -07:00
jcoffey-dev 1dafb4bc79 Add Domains to Administration
A role that can read domains now finds a Domains section beside Accounts:
list and search with each domain's account count and whether its DNS, DKIM
and certificate are managed automatically; add a domain; edit its
description, other names, catch-all address and plus addressing; copy its
DNS records one at a time or as a zone file; see its DKIM keys and their
stage; and remove it once no accounts use it.

The records come from the zone file Stalwart computes per domain. A long
DKIM record, which the BIND serialiser splits into quoted chunks, is joined
back into the single value a DNS provider's form wants.

Removing a domain takes its DKIM keys first, in the same request, because the
server will not remove a domain its keys still name. Removal is not offered
while accounts use the domain, or when the role cannot remove the keys.

The Administration nav is now built from the sections the role can read, and
the menu appears when there is at least one. The mock gains domains, DKIM
keys and zone files.

61 new strings, translated in all nine catalogues; strings falling back to
English stay at 16.
2026-09-13 15:39:16 -07:00
jcoffey-dev d279fe8f90 Let an operator turn administration off
ADMINISTRATION=0 at launch removes in-app administration for everyone. The
account's permissions are no longer sent to the browser, so the menu never
appears, and the JMAP proxy refuses Stalwart registry methods other than the
account's own (settings, password, app passwords, API keys, public keys,
masked addresses). Hiding the menu alone would have left an administrator's
browser console able to make every call the menu made.

With administration on, the request body streams through untouched as before;
only an installation that turns it off reads and checks the body, forwarding
the parsed form so the server receives exactly what was inspected.
2026-09-13 15:27:05 -07:00
jcoffey-dev 82e217155b Add Administration, starting with accounts
An account whose Stalwart role manages accounts now finds Administration in
the account menu. It lists, searches, creates and edits accounts -- display
name, other addresses, role, storage limit -- sets a new password, and
deletes, each offered only when the role holds the matching permission.

The server keeps the permissions list from GET /api/account, which it
already called for the edition and threw the rest away. Everything else is
JMAP x:Account, x:Domain and x:Role calls through the existing /api/jmap
proxy, so nothing new is stored and Stalwart decides every call.

Stalwart checks a grant against the caller's permissions but not a password
change or a delete, so an account that outranks the viewer is shown
read-only. Your own password is changed in Settings, which re-seals the
session; changing it here would strand it.

The mock server gains a directory behind the same permission names, with
MOCK_ROLE choosing admin, tenant-admin, helpdesk or user.

68 new strings, translated in all nine catalogues; strings falling back to
English stay at 16.
2026-09-13 15:11:55 -07:00
jcoffey-dev b5c073955d Send account requests to the account's own Stalwart
Two requests ignored the domain mapping from #238 and went to STALWART_URL:

- /api/account/* re-fetched the upstream session without upstreamFor(), so
  once the five-minute session cache expired, password, app-password and
  2FA calls for a mapped domain reached the default server.
- The locale lookup resolved Stalwart's apiUrl against the default server
  rather than the one that issued the session.

Both now use the session's own server, with a test pinning the second.
2026-09-13 14:45:33 -07:00
jcoffey b0564679e6 Merge pull request #332 from Coffey-Labs/deploy-version-without-node
Let the deploy compute its version without node
2026-09-12 12:29:25 -07:00
jcoffey-dev 724ff0b077 Let the deploy compute its version without node
The deploy script asked node for the build's version string, and that was
the only thing it needed node for. A host that runs everything as
containers has git and docker and nothing else, and today's deploy stopped
at 'node: command not found' before building anything.

The version is the same sum scripts/version.mjs does -- the commit's own
date plus the pull request it arrived through, or its short SHA -- done in
shell. Checked against the script on a merge commit, a plain commit and an
older one; all three agree.
2026-09-12 12:27:22 -07:00
jcoffey a666cdbcdc Merge pull request #331 from Coffey-Labs/fix/composer-maximized-stacking
Paint a full-screen composer above the others
2026-09-12 12:24:34 -07:00
jcoffey-dev 5855da0ba9 Paint a full-screen composer above the others
A maximised composer goes position: fixed but stays a child of the dock,
and had no z-index of its own. The dock is a stacking context, so the
positioned parts of any composer later in the DOM (its recipients row, its
editor) painted straight over the full-screen one.

Give the maximised composer its own layer, and hide the other composers
while one is full screen: they cannot be reached anyway, and the 24px
inset would otherwise show their footers along the bottom edge. They stay
mounted, so nothing being written in them is lost.

Fixes #330
2026-09-12 12:20:58 -07:00
jcoffey c3d2dc2418 Merge pull request #329 from Coffey-Labs/prune-stale-catalogue-keys
Report the stale keys that are stale, and remove them
2026-09-10 16:01:41 -07:00
jcoffey-dev 54b316ae36 Report the stale keys that are stale, and remove them
The check reported 41 stale keys per catalogue. Ten of them were.

The other 31 were strings held in constants and translated where they render --
t(b.description), t(group), t(c.label) -- so they reach t() as a variable and
there is no literal at the call site to find. The script already chased two of
those shapes, `label:` and objects named *_LABELS, with a comment about crying
wolf 33 times. The shapes kept coming: `description:` and `group:` on the
keyboard bindings, the calendar's view names, the read-receipt refusals, the
palette names.

Chasing them one at a time is the wrong shape of fix. Stale detection now asks
only "is this key still written down anywhere in the source" -- any string
literal counts. That under-reports, and that is the right way round: a missed
stale key costs a line of dead translation, a false one costs the credibility
of the check and every real finding after it. Which is what happened here --
these sat unread long enough to need a commit of their own.

Coverage keeps the strict set. The two questions need different nets, and
widening the one that measures what a catalogue *owes* would count every CSS
class and JMAP method name as an untranslated string -- it read 29% while I had
them sharing a set. `wanted` is the obligation, `seen` is the evidence.

What was actually dead, removed from all nine: "Availability on {date}",
"Import vCard", "PDF", two settings hints replaced by rewordings that are still
live, the Catppuccin palette description, and Tuesday through Friday -- left
behind when the week-start dropdown narrowed to the three days a week actually
starts on, and appearing since only in comments.

Coverage is unchanged at 1269/1285: none of the ten was ever owed.
2026-09-10 16:00:00 -07:00
jcoffey 3c4f6a9f8e Merge pull request #328 from Coffey-Labs/i18n-scripts-typescript7
Give the i18n scripts a parser again
2026-09-10 14:24:06 -07:00
jcoffey 2a323d6270 Merge pull request #327 from Coffey-Labs/single-message-view
Let conversation view off mean off
2026-09-10 14:23:52 -07:00
jcoffey-dev d282813bc5 Give the i18n scripts a parser again
TypeScript 7 is the native port: the package ships a `tsc` shim over a Go
binary, and `typescript` now exports `version` and `versionMajorMinor` and no
compiler API. Every `ts.createSourceFile` in scripts/ has been throwing
"Cannot read properties of undefined (reading 'Latest')" since the 5.9.3 → 7.0.2
bump -- four of the five i18n scripts dead, only i18n-extract still running.

Nothing noticed because no workflow runs them. The catalogue gate for nine
languages has been dark, and the only signal was running it by hand.

There is no official TS7 API package (@typescript/ast and @typescript/api are
both 404), and the alternative was rewriting 493 lines and 25 distinct AST
calls, including the JSX guards, against a different tree -- in tooling with no
tests of its own. So `typescript-ast` is an npm alias for the last TypeScript
carrying the JS API. It parses; `typescript` still type-checks and builds. Two
entries, two jobs, said so in each script so the next reader does not delete
one as a leftover.

What the gate says now it can speak: catalogues are green and coverage is 100%.
The "16 falling back to English" it reports in every locale are placeholders,
example domains, a product name, a licence id and the quote glyph -- strings
that should stay English. The 41 stale keys per locale are real dead weight and
are left for their own change.
2026-09-10 14:21:42 -07:00
jcoffey-dev d599e7404f Let conversation view off mean off
The setting reached only as far as the query. It set `collapseThreads`, so the
list correctly showed individual messages -- and then everything downstream
carried on working in threads. Opening one message highlighted every row of its
thread and filled the reading pane with the whole conversation, which is the
grouping the setting was turned off to avoid. The empty pane went on offering
"62 conversations" either way.

Three places had to learn about it, and the two rules behind them now live
together in lib/openMessage.ts:

- the row highlight matched on threadId, so siblings lit up
- ThreadView rendered every message the thread held
- the empty state named conversations regardless

The thread id stays in the path and loading is unchanged; the opened message
rides in `m`. Keeping it in the URL rather than in memory is what makes a
reload or a shared link come back to the same message, and an id that names
nothing in the thread falls back to the conversation -- which is what a link
from somebody with the setting on looks like, and what a stale parameter looks
like after switching back. Better a conversation than an empty pane.

Nine catalogues gain "No message selected" and "Select a message to read it
here"; "{n} messages" was already there, plural forms and all.
2026-09-10 14:15:50 -07:00
jcoffey 9b497af756 Merge pull request #326 from Coffey-Labs/plain-text-line-breaks
Render plain-text mail with its line breaks
2026-09-10 13:39:12 -07:00
jcoffey-dev 73a1bad29f Render plain-text mail with its line breaks
`htmlBody` is a derived list, not a filter: RFC 8621 §4.1.4 gives a message
with no HTML alternative one anyway, holding the text/plain part. Testing
`Boolean(htmlRaw)` therefore answered "this is HTML" for every plain-text
mail, sending it to HtmlBody and `.ihm-email-root`, which is
`white-space: normal` and collapses every line break. Hard-wrapped mail
arrived as a single paragraph with the signature and the quoted reply run
into the prose.

Confirmed live against Stalwart 0.16.21 (2026-09-10): a plain-text message
comes back with `htmlBody` and `textBody` naming the same part, typed
text/plain, while a real multipart/alternative names two different parts.
`type` was already in BODY_PROPS; nothing looked at it.

TextBody was written for exactly these messages and was simply unreachable,
so this also restores what it does -- pre-wrap, quote-depth colouring and the
collapsible quoted block, none of which had ever fired on plain-text mail.
2026-09-10 13:32:37 -07:00
jcoffey a9923c48d9 Merge pull request #325 from Coffey-Labs/funding-username-jcoffey-dev
Point the Sponsor button at the current GitHub username
2026-09-10 09:19:28 -07:00
jcoffey-dev 5b21720312 Point the Sponsor button at the current GitHub username
The account behind it was renamed from LINUXexpert-org to jcoffey-dev,
and GitHub does not redirect the old name: github.com/sponsors/
LINUXexpert-org answers 404 while the new one answers 200. So the
Sponsor button on this repository has been leading nowhere.

Worth fixing rather than leaving to redirect, because a released
username can be registered by anyone -- a stale link stops being a dead
end and starts being someone else's page.
2026-09-10 09:17:02 -07:00
Coffey Labs f2aaa9cea4 Merge pull request #324 from Coffey-Labs/node-26
Move CI, the image and the Node types to 26 together
2026-09-10 08:50:27 -07:00
jcoffey-dev 6632231815 Move CI, the image and the Node types to 26 together
Three pins and a types package all described Node 22, and moving any one
of them alone puts the build somewhere the others are not: @types/node
on its own would typecheck against APIs the runtime does not have, and
the base image on its own would ship a major CI never exercised. So
ci.yml, publish.yml, release.yml, both Dockerfile stages and
@types/node move in one change.

Worth knowing before this is deployed: 26 is Current, not LTS. node:26-
alpine reports lts=none, where 24-alpine is Krypton and the 22-alpine we
are leaving is Jod. 26 is due to become Active LTS in October. Nothing
here needs 26 over 24 -- the pins are a single number if the LTS line is
preferred.

engines stays at >=20.19, which is the floor for running ihasmail rather
than the version we build it on; the README's recommendation follows CI
to 26.

Checked on the runtime, not just in CI: the image builds on 26-alpine,
starts, and answers /api/health, and the login, SSE and body-carrying
POST checks from the node-server upgrade pass against a server on
26.8.1.
2026-09-10 08:44:55 -07:00
Coffey Labs 7d9d5b005c Merge pull request #323 from Coffey-Labs/hono-node-server-2
Take @hono/node-server to 2.1.1
2026-09-10 08:40:20 -07:00
jcoffey-dev 23738501c7 Take @hono/node-server to 2.1.1
All three entry points we import survive the major unchanged: `serve`
keeps its `(options, listeningListener)` signature and still accepts
`fetch`, `hostname` and `port`; `RESPONSE_ALREADY_SENT` is still exported
from `utils/response`; `getConnInfo` is still on `conninfo`. The peer is
hono ^4 and the engine >=20, both of which we already meet.

What v2 adds is two defaults worth knowing about. `overrideGlobalObjects`
swaps in a lighter Request/Response, and `autoCleanupIncoming` destroys
an incoming request the app never finished reading -- which is the
behaviour you want behind a proxy, and is on by default.

Neither is something the unit tests would notice, so this was run rather
than reasoned about. Against the mock: login, an /api/events stream, and
a POST carrying a body through to upstream. The SSE path is the one that
matters, since it writes to the raw ServerResponse and hands back
RESPONSE_ALREADY_SENT; it answers with the same headers, the same
chunked encoding and the same bytes as 1.19.17 does on the same script.
2026-09-10 08:28:21 -07:00
Coffey Labs 91dda348bc Merge pull request #318 from Coffey-Labs/dependabot/npm_and_yarn/typescript-7.0.2
Bump typescript from 5.9.3 to 7.0.2
2026-09-10 08:19:18 -07:00
dependabot[bot] 3240c56e84 Bump typescript from 5.9.3 to 7.0.2
Bumps [typescript](https://github.com/microsoft/TypeScript) from 5.9.3 to 7.0.2.
- [Release notes](https://github.com/microsoft/TypeScript/releases)
- [Commits](https://github.com/microsoft/TypeScript/compare/v5.9.3...v7.0.2)

---
updated-dependencies:
- dependency-name: typescript
  dependency-version: 7.0.2
  dependency-type: direct:development
  update-type: version-update:semver-major
...

Signed-off-by: dependabot[bot] <[email protected]>
2026-09-10 15:16:28 +00:00
Coffey Labs 136c754bcd Merge pull request #322 from Coffey-Labs/vite-8
Move the build to vite 8, and chunk the way rolldown wants
2026-09-10 08:14:33 -07:00
Coffey Labs aa0d594666 Merge pull request #321 from Coffey-Labs/tsconfig-relative-paths
Point the @ alias at a relative path, and drop baseUrl
2026-09-10 08:14:25 -07:00
jcoffey-dev 53ccaad468 Move the build to vite 8, and chunk the way rolldown wants
@vitejs/plugin-react 6 peers on vite ^8 and nothing lower, so the build
had to move before the plugin could. vite 8 bundles with rolldown rather
than rollup, which is most of what is here.

The object form of `manualChunks` -- a chunk name against the list of
packages in it -- is gone; rolldown takes groups tested against module
paths instead. Same two chunks come out, `vendor` and `icons`, with the
same contents; `icons` is tried first because the first matching group
wins. `rollupOptions` is now a deprecated alias, so it is spelled
`rolldownOptions`.

The lockfile is regenerated rather than patched. vitest depends on vite
itself, and an incremental install was happy to leave 6.4.3 hoisted for
vitest while web built against 8.3.0 -- two majors in one tree, which is
not a state to ship. A clean install collapses to one.

vite 8 wants Node ^20.19 || >=22.12, above the >=20.10 the README and
engines promised, so both say 20.19 now. CI and the image are on 22 and
were never affected.

Rolldown reports two modules that are imported both statically and
dynamically, so the dynamic import cannot split them out. That is true
of the source either way -- store/sieve.ts has three static importers
and one dynamic -- and is left alone here.
2026-09-10 08:03:40 -07:00
jcoffey-dev d51d523ce1 Point the @ alias at a relative path, and drop baseUrl
TypeScript 7 removes `baseUrl` outright and refuses a non-relative entry
in `paths`, so the typecheck stops on tsconfig.json before it reaches a
line of our code. A leading `./` says the same thing without it: paths
resolve against the tsconfig's own directory, which is what `baseUrl:
"."` was there to arrange.

Nothing here waits for the upgrade. Relative paths without a baseUrl
have been the supported spelling since 4.4, so this typechecks the same
under 5.9.3 today as it will under 7. Vite resolves `@` from its own
alias in vite.config.ts and never read this.

With this in, 7.0.2 typechecks both workspaces clean -- the two
tsconfig errors were all that stood in the way, not the first two of
many.
2026-09-10 07:57:57 -07:00
Coffey Labs d90a1cef93 Merge pull request #314 from Coffey-Labs/dependabot/npm_and_yarn/minor-and-patch-897b8e30fb
Bump the minor-and-patch group across 1 directory with 4 updates
2026-09-10 07:02:31 -07:00
Coffey Labs 829c5ab14d Merge pull request #316 from Coffey-Labs/dependabot/github_actions/actions-819308dff6
Bump the actions group with 7 updates
2026-09-10 07:02:23 -07:00
dependabot[bot] 1b9058fccb Bump the minor-and-patch group across 1 directory with 4 updates
Bumps the minor-and-patch group with 4 updates in the / directory: [tsx](https://github.com/privatenumber/tsx), [dompurify](https://github.com/cure53/DOMPurify), [wouter](https://github.com/molefrog/wouter) and [@types/react-dom](https://github.com/DefinitelyTyped/DefinitelyTyped/tree/HEAD/types/react-dom).


Updates `tsx` from 4.23.12 to 4.23.13
- [Release notes](https://github.com/privatenumber/tsx/releases)
- [Changelog](https://github.com/privatenumber/tsx/blob/master/release.config.cjs)
- [Commits](https://github.com/privatenumber/tsx/compare/v4.23.12...v4.23.13)

Updates `dompurify` from 3.4.14 to 3.4.15
- [Release notes](https://github.com/cure53/DOMPurify/releases)
- [Commits](https://github.com/cure53/DOMPurify/compare/3.4.14...3.4.15)

Updates `wouter` from 3.10.0 to 3.11.0
- [Release notes](https://github.com/molefrog/wouter/releases)
- [Commits](https://github.com/molefrog/wouter/commits/v3.11.0)

Updates `@types/react-dom` from 19.2.4 to 19.2.7
- [Release notes](https://github.com/DefinitelyTyped/DefinitelyTyped/releases)
- [Commits](https://github.com/DefinitelyTyped/DefinitelyTyped/commits/HEAD/types/react-dom)

---
updated-dependencies:
- dependency-name: "@types/react-dom"
  dependency-version: 19.2.7
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: minor-and-patch
- dependency-name: dompurify
  dependency-version: 3.4.15
  dependency-type: direct:production
  update-type: version-update:semver-patch
  dependency-group: minor-and-patch
- dependency-name: tsx
  dependency-version: 4.23.13
  dependency-type: direct:development
  update-type: version-update:semver-patch
  dependency-group: minor-and-patch
- dependency-name: wouter
  dependency-version: 3.11.0
  dependency-type: direct:production
  update-type: version-update:semver-minor
  dependency-group: minor-and-patch
...

Signed-off-by: dependabot[bot] <[email protected]>
2026-09-10 13:54:14 +00:00
Coffey Labs a2ae868f28 Merge pull request #320 from Coffey-Labs/deps-vitest-4
Take vitest to 4.1.11, and stop two suites leaking their spies
2026-09-10 06:51:36 -07:00
jcoffey-dev 520de85d12 Take vitest to 4.1.11, and stop two suites leaking their spies
GHSA-82fw-gwwq-j7x9 -- arbitrary file read through @vitest/mocker's
redirect mock -- has no fix in the 3.x line. The patched versions are
4.1.11 and 5.0.0-rc.2, so clearing it means the major. vite stays at
6.4.3: vitest 4 accepts ^6, and nothing outside devDependencies moves.

The bump surfaced a bug of ours rather than one of vitest's. vi.spyOn
now hands back the spy already installed on a method instead of wrapping
it in a fresh one, so a spy installed in beforeEach keeps its call count
across tests. compose-from-share expected two uploads and saw three: its
own two, plus the one from the test before it. The assertion was only
ever passing because each test happened to get a new spy.

Both suites now restore between tests, which is what the other five
spying suites already do. webpush had the same leak with no assertion
close enough to catch it.
2026-09-10 06:41:19 -07:00
dependabot[bot] 36ad85feef Bump the actions group with 7 updates
Bumps the actions group with 7 updates:

| Package | From | To |
| --- | --- | --- |
| [actions/checkout](https://github.com/actions/checkout) | `4` | `7` |
| [actions/setup-node](https://github.com/actions/setup-node) | `4` | `7` |
| [docker/setup-buildx-action](https://github.com/docker/setup-buildx-action) | `3` | `4` |
| [docker/login-action](https://github.com/docker/login-action) | `3` | `4` |
| [docker/build-push-action](https://github.com/docker/build-push-action) | `6` | `7` |
| [actions/upload-artifact](https://github.com/actions/upload-artifact) | `4` | `7` |
| [actions/download-artifact](https://github.com/actions/download-artifact) | `4` | `8` |


Updates `actions/checkout` from 4 to 7
- [Release notes](https://github.com/actions/checkout/releases)
- [Changelog](https://github.com/actions/checkout/blob/main/CHANGELOG.md)
- [Commits](https://github.com/actions/checkout/compare/v4...v7)

Updates `actions/setup-node` from 4 to 7
- [Release notes](https://github.com/actions/setup-node/releases)
- [Commits](https://github.com/actions/setup-node/compare/v4...v7)

Updates `docker/setup-buildx-action` from 3 to 4
- [Release notes](https://github.com/docker/setup-buildx-action/releases)
- [Commits](https://github.com/docker/setup-buildx-action/compare/v3...v4)

Updates `docker/login-action` from 3 to 4
- [Release notes](https://github.com/docker/login-action/releases)
- [Commits](https://github.com/docker/login-action/compare/v3...v4)

Updates `docker/build-push-action` from 6 to 7
- [Release notes](https://github.com/docker/build-push-action/releases)
- [Commits](https://github.com/docker/build-push-action/compare/v6...v7)

Updates `actions/upload-artifact` from 4 to 7
- [Release notes](https://github.com/actions/upload-artifact/releases)
- [Commits](https://github.com/actions/upload-artifact/compare/v4...v7)

Updates `actions/download-artifact` from 4 to 8
- [Release notes](https://github.com/actions/download-artifact/releases)
- [Commits](https://github.com/actions/download-artifact/compare/v4...v8)

---
updated-dependencies:
- dependency-name: actions/checkout
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: actions/setup-node
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: docker/setup-buildx-action
  dependency-version: '4'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: docker/login-action
  dependency-version: '4'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: docker/build-push-action
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: actions/upload-artifact
  dependency-version: '7'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
- dependency-name: actions/download-artifact
  dependency-version: '8'
  dependency-type: direct:production
  update-type: version-update:semver-major
  dependency-group: actions
...

Signed-off-by: dependabot[bot] <[email protected]>
2026-09-10 13:26:33 +00:00
Coffey Labs 9418d3f935 Merge pull request #312 from Coffey-Labs/deps-hono-4.13.7-dependabot-config
Take hono to 4.13.7 and let Dependabot open the next one
2026-09-10 06:25:00 -07:00
jcoffey-dev 3e8b1ebb38 Take hono to 4.13.7 and let Dependabot open the next one
Three medium advisories land on hono before 4.13.5: a toSSG() path
escape, a query parser that reads parameters past the URL fragment, and
unbounded dot-notation nesting in parseBody(). Only the second one
touches this server -- c.req.query() is read in imageproxy, icsproxy and
app -- and even there safeFetch validates the value it actually fetches
rather than a separate pre-check, so there was nothing to desync. toSSG
and parseBody are never called. The bump is still worth taking on its
own: it is a patch release with no API change.

The declared range moves with it, from ^4.7.4 to ^4.13.7, so the
security floor is recorded in server/package.json and not only in the
lockfile.

The dependabot.yml is the actual fix for how these were found. There was
no config, so nothing opened a PR and the alerts sat on a dashboard
until someone thought to look. Routine updates now group into one PR a
week; majors stay separate, because they are migrations.
2026-09-10 06:21:56 -07:00
Coffey Labs 38fb78a095 Merge pull request #311 from Coffey-Labs/theme-nested-light-panels
Neutralise light panels nested inside dark painted cards
2026-09-08 21:28:52 -07:00
jcoffey-dev 6f3aba06a6 Neutralise light panels nested inside dark painted cards
Closes #310.

A dark campaign rendered with beige cards inside it. markKeptSurfaces
marks any element whose declared background is below the luminance
threshold, with no area cap, so a 600px layout card is marked exactly
like a button. The CSS then exempted the marked element and its whole
subtree via [data-ihm-keep] *, so a light table nested in that card was
never touched. In the reported specimen 14 of 21 light panels survived.

The rule now is that being inside a painted surface is not inherited past
a sheet. The walk tracks that state and emits a second mark,
data-ihm-in-keep, for elements sitting on paint with no background of
their own; the CSS exempts those explicitly instead of exempting every
descendant. A nested light sheet ends the protection, and paint resumes
below it, so a button inside such a sheet is still kept whole.

The alternatives in the report were not taken. Dropping the descendant
half of the selector outright puts back what #294 fixed: a nested label
on a coloured cell loses its colour. An area threshold is a magic number
that misfires on both a legitimate hero banner and a small dark panel
with a light chip in it.

The tests assert against the neutraliser selector lifted out of
EMAIL_BASE_CSS rather than against the marks. The first draft of them
checked which attributes were set and passed against the unfixed code,
which proved nothing: the bug was in the rule that reads the marks, not
in the marking. All four fail without this change.
2026-09-08 19:32:09 -07:00
Coffey Labs a389b9e8c5 Merge pull request #309 from Coffey-Labs/sw-must-not-be-cached
Never serve the service worker from a cache
2026-09-07 23:04:59 -07:00
jcoffey-dev 0ad19802f8 Never serve the service worker from a cache
The deploy on 2026-09-08 went out at the origin and did not arrive.
Cloudflare went on handing out the previous `sw.js` -- `cf-cache-status:
HIT`, with an edge TTL of four hours, longer than the hour we asked for
-- because the file is neither a hashed asset nor HTML and so fell into
the ordinary `max-age=3600` case.

That is not a freshness preference. The service worker is the app's whole
update mechanism: a browser holding the old one goes on being served the
shell that worker knows and never learns a deploy happened, so the deploy
simply does not land. The manifest matters for a second reason -- the two
have to agree. A fresh manifest advertising a share target, answered by a
worker that has never heard of one, sends the share to the server for a
405. Either being old is survivable; disagreeing is not.

`no-cache` rather than `no-store`: both may still keep a copy, they just
have to revalidate it, which is a 304 and costs nothing. Neither gets to
answer with its own copy without asking.

Narrow on purpose -- two files, named, rather than a policy that quietly
stops the icons and fonts being cached as well.
2026-09-07 23:02:19 -07:00
Coffey Labs 1592f38515 Merge pull request #308 from Coffey-Labs/notification-actions
Archive and mark read from the notification itself
2026-09-07 22:59:14 -07:00
jcoffey-dev acc50f009c Archive and mark read from the notification itself
Both happen in the background. The phone stays where it is.

This was twice described as impossible, here and in FEATURES.md: the
service worker was said to have no session, so anything touching mail had
to open the app. That is wrong, and checking it rather than repeating it
is the whole of this change. ihasmail's session is an httpOnly cookie
against its own origin and the only other thing the API asks for is a
fixed `x-requested-with` header, which is not a secret and is not held
anywhere. A same-origin fetch from the worker carries the cookie like any
other. Confirmed against the mock: logging in with curl and then issuing
`Email/set` with nothing but that cookie and the static headers marked a
message read and moved it to Archive, HTTP 200. Nothing the tab holds in
memory is involved, because the API asks for none of it.

Two actions, because `maxActions` is two on Android and anything past it
is dropped without a word. Archive and Mark as read are the two worth
having: they are what somebody does to a notification they have already
read the whole of. Reply is not among them -- it would have to open the
app, which is what tapping the notification does already.

The worker still cannot reach a catalogue. It is plain JavaScript copied
into the build, outside the bundle, with no i18n and no idea which
mailbox is the archive. So the app writes both down in the same cache it
already uses for handoffs, and rewrites them whenever the language, the
account or the folder list changes. Where there is no such note -- between
installing this worker and next opening ihasmail -- the notification
appears with no buttons at all, rather than English ones over a mailbox
guessed by name. That also fixes two strings the worker had always shown
in English regardless: "New mail" and "(no subject)".

A session can be gone by the time a button is pressed. That comes back as
a refusal and the notification says so, rather than vanishing as though
it had worked. It does not open the app to recover: being interrupted is
what the button existed to avoid.

The two claims that were wrong are corrected rather than quietly deleted,
including the one about push renewal -- which still needs a tab, but for
a different reason than the one given. The reason is when the worker
runs, not what it may do: it wakes only for a push, and the push stops
when the subscription lapses.

Two new strings, in all nine catalogues.
2026-09-07 22:55:55 -07:00
Coffey Labs f42fb014c8 Merge pull request #307 from Coffey-Labs/share-target
Be somewhere a phone can share to
2026-09-07 22:46:24 -07:00
jcoffey-dev a73525f425 Build the shared file from its bytes, not from a Blob
CI caught this on Node 22 while it passed here on 26. `new File([blob],
…)` only puts the blob's contents in the file where that implementation
recognises a Blob as a part; where it does not, it stringifies it, and
the file contains the thirteen characters "[object Blob]". No error
anywhere -- the name, the type and the attachment are all correct and
the contents are gone.

A browser would not have done this. It is worth not relying on that: an
ArrayBuffer is a part on every implementation, and the whole file is in
memory a moment later regardless, since it is about to be uploaded.
2026-09-07 22:43:30 -07:00
jcoffey-dev 82470e8db0 Be somewhere a phone can share to
ihasmail could hand a file to the share sheet as of #306, and was still
not in it. Share a photo from the gallery, a link from the browser or a
document from a file manager and ihasmail was not among the places it
could go, which is the one piece of operating-system integration a mail
app is expected to have.

A share is a POST that navigates, and there is nothing on this side that
can answer one: the app is a client-side router with no endpoint at that
address, and the server behind it would need a route that understood the
composer. So the service worker intercepts it, takes the form body, puts
the files and text in its cache, and redirects to the app -- which finds
them on start and opens a draft holding them. The subject is the shared
title, the text and the link become the body, and files are attached and
begin uploading. Nothing is addressed: a share says what to send, never
who to.

The body is pushed in above the signature rather than passed to open(),
because open() only fits a signature when it is given no body at all --
the obvious version drops the signature from every message that started
as a share, and nothing about the draft looks wrong afterwards.

Collected on every start rather than when the launch URL says so. A share
to a signed-out ihasmail lands on the sign-in page, and there is no
account to attach to until it is done, so the payload has to outlive a
redirect and a login -- which the query string does not. What that costs
is a stash nobody came back for, so it carries a timestamp and expires
after ten minutes.

`accept` names wildcard families and explicit types and extensions both.
A mail client attaches anything, but wildcards are not in the
specification and operating systems differ over which form they match on,
so the explicit list is what holds if the families are ignored.

The cache name the worker and the app have to agree on now has one home
on the app side. It was written out twice, and a drift would not fail --
a push verification would simply never complete and a share would arrive
at an empty composer.

One case is deliberately left to fail loudly: an app still installed
whose worker has been cleared away POSTs to the server, which answers
405. A server route would trade a plain error for a silent nothing, and
the payload is gone in both -- it only ever existed in that request body.

Verified by test, not on a device: Android is the only place this exists
at all, and the extension driving Chrome is not connected here. The
handoff is pinned from the tab's side against a cache shaped exactly as
the worker leaves it, since the two files never see each other.
2026-09-07 22:40:44 -07:00
Coffey Labs f39d6ac30c Merge pull request #306 from Coffey-Labs/mobile-share-and-app-badge
Badge the installed icon, and share to the phone rather than to Downloads
2026-09-07 22:32:39 -07:00
jcoffey-dev 4e61adfe80 Badge the installed icon, and share to the phone rather than to Downloads
Three things an installed ihasmail did not do that a phone user expects,
and all three are about the app once it is off the browser tab.

The unread count was painted into the tab title and the favicon, neither
of which exists in `display: standalone` -- so putting ihasmail on a home
screen threw the count away entirely. It goes to the Badging API as well
now. Web Push marks the icon while the app is closed, and marks it with a
dot rather than a figure: the service worker has no session to ask how
many messages are unread, and a push carries the new mail rather than a
total, so counting the payload would badge "2" over an inbox holding
forty. The next tab to open writes the real count over it.

Sharing is new. Everything that left ihasmail left as a download, which
on a phone is close to a dead end -- the file lands in Downloads and
whoever meant to send it somewhere goes looking for it in a file manager.
The share sheet is now on the message menu, on each attachment row, and
in the file viewer, which is where an attachment is already open and
where both callers meet. A message shares as text rather than as the
.eml beside it: a share sheet is aimed at everything that is not a mail
client, and an .eml in a chat app is an attachment nobody can open.

Every control feature-detects, and sharing a file is a separate question
from sharing at all -- desktop Linux and Firefox have neither, and not
every browser with `share` takes files. Anything that fails, including
the transient activation running out while a large attachment is fetched,
falls through to the download the button sits beside, so the worst case
costs a tap rather than the file. `NotAllowedError` is reported as
unsupported for that reason: it cannot be told apart from a refusal, and
a toast about activation is not something a reader can act on.

The share strings are contextual keys rather than the existing "Share…".
That one means granting another account access, and several languages use
a different verb for it -- German had "Freigeben" where the sheet wants
"Teilen". Three new strings, in all nine catalogues.

The manifest gains `launch_handler: navigate-existing`, so a mailto:, a
shortcut or a notification tapped while ihasmail is running arrives in
the copy that is running: two windows on one inbox disagree about what
has been read. `focus-existing` would have been wrong -- it only focuses
and leaves the target URL to launchQueue, which nothing here consumes, so
it would swallow the mailto. There is deliberately still no `id`, and the
manifest now says why: it is the one member resolved against the origin
of start_url rather than against the manifest's own address, so no
relative form can name a subpath mount, and the default id already is
start_url -- writing one now would give every installed copy a new
identity and orphan it as a second app.

Verified by test rather than on a device: the extension driving Chrome
was not connected, and Chrome on Linux has no Web Share to drive anyway.
The preview dialog is covered by a component test that stubs the browser
both ways.
2026-09-07 22:28:17 -07:00
Coffey Labs b65732ea04 Merge pull request #304 from Coffey-Labs/settings-ownership-wording
Say who owns settings.json, not just where it lives
2026-09-07 18:07:30 -07:00
jcoffey-dev 166a04f578 Say who owns settings.json, not just where it lives
The bullet asserted that ihasmail stays stateless without saying what
that is scoped to, which reads as a claim about the file rather than
about the process. Name both halves: the format is ihasmail's, the file
is the account's.
2026-09-07 18:05:16 -07:00
Coffey Labs 79d891c623 Merge pull request #303 from Coffey-Labs/contributor-notes-in-contributing
Move the translation and UI-verification notes into CONTRIBUTING
2026-09-07 16:49:29 -07:00
jcoffey-dev d13cf6ed6b Move the translation and UI-verification notes into CONTRIBUTING
The plural-key gotcha and the reasons store tests miss visible bugs are
contributor guidance, not a side file: they belong next to the rest of
the pull-request checklist where anybody sending a change will read them.
2026-09-07 16:47:12 -07:00
Coffey Labs b56ffdf268 Merge pull request #302 from Coffey-Labs/claude-md-scope
Limit CLAUDE.md to translations and verifying UI work
2026-09-07 16:43:35 -07:00
jcoffey-dev 0ebdb38a98 Limit CLAUDE.md to translations and verifying UI work
The file was added without being asked for. It stays, but with its scope
stated at the top so it does not grow into a second contributor guide:
the nine catalogues and what it takes to confirm a visible change works,
and nothing else.
2026-09-07 16:41:10 -07:00
Coffey Labs 35935f2d3c Merge pull request #301 from Coffey-Labs/calendar-reimport-updates
Update a re-imported event rather than skipping it
2026-09-07 13:07:29 -07:00
jcoffey-dev 8173e22ccb Update a re-imported event rather than skipping it
Contacts and calendars disagreed on a re-import: a vCard or LDIF entry
whose identity a book already held overwrote the card there (#242, #274),
while an event whose UID a calendar held was counted and thrown away
(#222). The asymmetry was never decided -- it was where each half stopped.

Decided on #279: calendars update too, with two properties held back.
`participants` carries every attendee's accepted/declined and
`recurrenceOverrides` holds every "just this Wednesday" edit made here.
Both are decisions taken after the file was written, and a file that
mentions them at all describes them as they were at export, so writing
either one over would destroy work silently and return no error. A
corrected export now fixes the time, the title and the location, and
leaves who said yes alone. `uid` is held back with them: it is what the
two were matched on, so it is already equal.

The scan returns uid -> id rather than a set of UIDs, since updating
needs something to address, and creates and updates now share one
`maxObjectsInSet` budget the way contacts' `writeCards` does -- 300 new
and 300 changed batched separately would be two calls of 300, neither
over a ceiling of 500 and both refused. Counts become created/updated,
reported as the contacts import reports them.

Still no scheduling messages, on an update as much as on a create. That
is a real cost -- an event a re-import moves is moved here and nowhere
else -- and it is the lesser one: an import is not the place to start
mailing a room full of people who never asked for it.

Driven against the mock end to end: a second file with the same UID
updated the event in place, took the file's title, start and location,
and left an accepted RSVP and a per-occurrence override untouched even
though the file carried participants of its own.
2026-09-07 12:56:36 -07:00
101 changed files with 8883 additions and 2099 deletions
+6
View File
@@ -61,6 +61,12 @@ MAX_UPLOAD_BYTES=52428800
# Remote-image privacy proxy (Gmail-style). Set to 0 to load remote images directly. # Remote-image privacy proxy (Gmail-style). Set to 0 to load remote images directly.
IMAGE_PROXY=1 IMAGE_PROXY=1
# In-app administration, for accounts whose Stalwart role manages accounts and
# domains. 0 turns it off for everyone: no menu, and the JMAP proxy refuses
# Stalwart's registry methods beyond an account's own password, app passwords
# and settings. Stalwart's own admin interface is not affected.
ADMINISTRATION=1
# Branding # Branding
APP_NAME=ihasmail APP_NAME=ihasmail
+1 -1
View File
@@ -1,4 +1,4 @@
# Funding platforms shown behind the repository's Sponsor button. # Funding platforms shown behind the repository's Sponsor button.
# https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository # https://docs.github.com/repositories/managing-your-repositorys-settings-and-features/customizing-your-repository/displaying-a-sponsor-button-in-your-repository
github: LINUXexpert-org github: jcoffey-dev
+44
View File
@@ -0,0 +1,44 @@
version: 2
updates:
# The npm entry sits at the root because that is where the single lockfile
# is: root, server and web are one npm workspace, so one entry covers all
# three. Pointing entries at server/ or web/ would find package.json files
# with no lockfile beside them and update nothing.
- package-ecosystem: npm
directory: "/"
schedule:
interval: weekly
day: tuesday
time: "09:00"
timezone: Etc/UTC
open-pull-requests-limit: 5
groups:
# Everything routine arrives as one PR a week, so the dashboard is not
# the only place these get noticed. Majors are deliberately left out of
# the group: they are migrations, not bumps -- vitest 3 to 4 is one --
# and each deserves its own PR and its own CI run.
minor-and-patch:
update-types:
- minor
- patch
- package-ecosystem: github-actions
directory: "/"
schedule:
interval: weekly
day: tuesday
time: "09:00"
timezone: Etc/UTC
groups:
actions:
patterns:
- "*"
# The runtime and build stages both pin node:22-alpine, so this is what
# keeps the published container images off a stale base between the weekly
# releases.
- package-ecosystem: docker
directory: "/"
schedule:
interval: weekly
day: tuesday
time: "09:00"
timezone: Etc/UTC
+3 -3
View File
@@ -15,10 +15,10 @@ jobs:
build: build:
runs-on: ubuntu-latest runs-on: ubuntu-latest
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v7
- uses: actions/setup-node@v4 - uses: actions/setup-node@v7
with: with:
node-version: 22 node-version: 26
cache: npm cache: npm
- run: npm ci --ignore-scripts - run: npm ci --ignore-scripts
- run: npm run typecheck - run: npm run typecheck
+11 -11
View File
@@ -76,13 +76,13 @@ jobs:
version: ${{ steps.v.outputs.version }} version: ${{ steps.v.outputs.version }}
docker_tag: ${{ steps.v.outputs.docker_tag }} docker_tag: ${{ steps.v.outputs.docker_tag }}
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v7
with: with:
ref: ${{ inputs.ref || github.ref }} ref: ${{ inputs.ref || github.ref }}
fetch-depth: 0 fetch-depth: 0
- uses: actions/setup-node@v4 - uses: actions/setup-node@v7
with: with:
node-version: 22 node-version: 26
- id: v - id: v
run: | run: |
V="$(node scripts/version.mjs)" V="$(node scripts/version.mjs)"
@@ -108,18 +108,18 @@ jobs:
- platform: linux/arm64 - platform: linux/arm64
runner: ubuntu-24.04-arm runner: ubuntu-24.04-arm
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v7
with: with:
ref: ${{ inputs.ref || github.ref }} ref: ${{ inputs.ref || github.ref }}
- uses: docker/setup-buildx-action@v3 - uses: docker/setup-buildx-action@v4
- uses: docker/login-action@v3 - uses: docker/login-action@v4
with: with:
registry: ghcr.io registry: ghcr.io
username: ${{ github.actor }} username: ${{ github.actor }}
password: ${{ secrets.GITHUB_TOKEN }} password: ${{ secrets.GITHUB_TOKEN }}
- name: Build and push by digest - name: Build and push by digest
id: push id: push
uses: docker/build-push-action@v6 uses: docker/build-push-action@v7
with: with:
context: . context: .
platforms: ${{ matrix.platform }} platforms: ${{ matrix.platform }}
@@ -140,7 +140,7 @@ jobs:
# `image@sha256:sha256:...` when the reference is rebuilt. # `image@sha256:sha256:...` when the reference is rebuilt.
digest="${{ steps.push.outputs.digest }}" digest="${{ steps.push.outputs.digest }}"
touch "/tmp/digests/${digest#sha256:}" touch "/tmp/digests/${digest#sha256:}"
- uses: actions/upload-artifact@v4 - uses: actions/upload-artifact@v7
with: with:
# One artifact per platform; the merge job globs them back together. # One artifact per platform; the merge job globs them back together.
name: digest-${{ strategy.job-index }} name: digest-${{ strategy.job-index }}
@@ -157,13 +157,13 @@ jobs:
contents: read contents: read
packages: write packages: write
steps: steps:
- uses: actions/download-artifact@v4 - uses: actions/download-artifact@v8
with: with:
path: /tmp/digests path: /tmp/digests
pattern: digest-* pattern: digest-*
merge-multiple: true merge-multiple: true
- uses: docker/setup-buildx-action@v3 - uses: docker/setup-buildx-action@v4
- uses: docker/login-action@v3 - uses: docker/login-action@v4
with: with:
registry: ghcr.io registry: ghcr.io
username: ${{ github.actor }} username: ${{ github.actor }}
+4 -4
View File
@@ -46,13 +46,13 @@ jobs:
previous: ${{ steps.decide.outputs.previous }} previous: ${{ steps.decide.outputs.previous }}
count: ${{ steps.decide.outputs.count }} count: ${{ steps.decide.outputs.count }}
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v7
with: with:
ref: main ref: main
fetch-depth: 0 fetch-depth: 0
- uses: actions/setup-node@v4 - uses: actions/setup-node@v7
with: with:
node-version: 22 node-version: 26
- id: decide - id: decide
env: env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }} GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}
@@ -122,7 +122,7 @@ jobs:
permissions: permissions:
contents: write contents: write
steps: steps:
- uses: actions/checkout@v4 - uses: actions/checkout@v7
with: with:
ref: main ref: main
fetch-depth: 0 fetch-depth: 0
-2
View File
@@ -7,5 +7,3 @@ server/data/
.vite/ .vite/
coverage/ coverage/
# Worktrees used by parallel agents; never part of a commit.
.claude/worktrees/
-54
View File
@@ -1,54 +0,0 @@
# Notes for Claude
Things that are true of this repository and cost somebody a round trip to
find out. Not a style guide — `CONTRIBUTING.md` is that.
## Translations
Nine languages ship alongside English: German, Spanish, French, Dutch,
Portuguese (Brazil), Russian, Ukrainian, Simplified Chinese and Japanese, in
`web/src/locales/`. A missing key renders its English source rather than
failing, so an untranslated string is invisible until somebody reading that
language finds it.
**Any change that adds or alters a user-visible string adds work in all nine
catalogues.** Say so explicitly when reporting the change — how many keys, and
the fallback count before and after — and say so just as explicitly when a
change adds none, so it is never left to be inferred.
### The catalogue key for a plural is the `other` form
`plural()` looks the entry up by `forms.other`, so a call site written as
```ts
plural(n, { one: "Deleted {n} contact", other: "Deleted {n} contacts" })
```
is keyed on **`"Deleted {n} contacts"`**. Keying the catalogue on the `one`
form type-checks, builds, passes every test, and silently falls back to English
in all nine languages. Nothing errors. The only signal is the fallback count
going up, so read it:
```sh
npm run i18n:check # literals wrapped, and catalogue health
node scripts/i18n-catalog-check.mjs # per-language: translated / used / falling back
```
Compare the "falling back to English" number against `main` before and after.
It should not rise. Do not read the percentage instead — adding keys moves the
denominator, so it can hold steady while new strings go untranslated.
Plural forms are per language, from `Intl.PluralRules`: `one`/`other` for most,
`one`/`few`/`many`/`other` for Russian and Ukrainian, `other` alone for Japanese
and Chinese. Supplying a form a language does not draw is inventing a
distinction, not being thorough.
## Verifying UI work
Store tests do not exercise the component. At least one bug in this repo's
history — a shift-click range measured inside a `setState` updater, which React
runs after the anchor ref has already moved — passed every store assertion and
failed the moment the built app was driven. If a change is visible on screen,
run it: `npm run dev:mock` (mock Stalwart, credentials printed on start), then
drive the real thing. Add a component test for what you find; there are
examples in `web/src/views/*/__tests__/`.
+54 -6
View File
@@ -48,12 +48,10 @@ For larger changes, please open an issue to discuss the approach **before** subm
- Related issue number(s), if any - Related issue number(s), if any
- Screenshots/GIFs for UI changes - Screenshots/GIFs for UI changes
- Any manual testing you performed - Any manual testing you performed
8. **Add translations** for any new user-visible string. Nine languages ship 8. **Add translations** for any new user-visible string — see
alongside English in `web/src/locales/`, and a missing key renders its [Translations](#translations) below — and **drive the built app** for any
English source rather than failing — so an untranslated string is invisible change that is visible on screen, as described in
until somebody reading that language finds it. `npm run i18n:check` and [Verifying UI work](#verifying-ui-work).
`node scripts/i18n-catalog-check.mjs` report where you stand; the catalogue
key for a plural is the `other` form. See [CLAUDE.md](CLAUDE.md).
`main` is protected. A change reaches it through a pull request whose **build** `main` is protected. A change reaches it through a pull request whose **build**
check has passed — not afterwards — and the branch cannot be force-pushed or check has passed — not afterwards — and the branch cannot be force-pushed or
@@ -67,6 +65,56 @@ waiting for one.
- Prefer clarity over cleverness — this is a mail client people rely on for their inbox. - Prefer clarity over cleverness — this is a mail client people rely on for their inbox.
- Comment non-obvious JMAP interactions, especially around state/`changes` handling, since JMAP's delta-sync model can be easy to get subtly wrong. - Comment non-obvious JMAP interactions, especially around state/`changes` handling, since JMAP's delta-sync model can be easy to get subtly wrong.
### Translations
Nine languages ship alongside English: German, Spanish, French, Dutch,
Portuguese (Brazil), Russian, Ukrainian, Simplified Chinese and Japanese, in
`web/src/locales/`. A missing key renders its English source rather than
failing, so an untranslated string is invisible until somebody reading that
language finds it.
**Any change that adds or alters a user-visible string adds work in all nine
catalogues.** Say so explicitly in the PR — how many keys, and the fallback
count before and after — and say so just as explicitly when a change adds none,
so it is never left to be inferred.
#### The catalogue key for a plural is the `other` form
`plural()` looks the entry up by `forms.other`, so a call site written as
```ts
plural(n, { one: "Deleted {n} contact", other: "Deleted {n} contacts" })
```
is keyed on **`"Deleted {n} contacts"`**. Keying the catalogue on the `one`
form type-checks, builds, passes every test, and silently falls back to English
in all nine languages. Nothing errors. The only signal is the fallback count
going up, so read it:
```sh
npm run i18n:check # literals wrapped, and catalogue health
node scripts/i18n-catalog-check.mjs # per-language: translated / used / falling back
```
Compare the "falling back to English" number against `main` before and after.
It should not rise. Do not read the percentage instead — adding keys moves the
denominator, so it can hold steady while new strings go untranslated.
Plural forms are per language, from `Intl.PluralRules`: `one`/`other` for most,
`one`/`few`/`many`/`other` for Russian and Ukrainian, `other` alone for Japanese
and Chinese. Supplying a form a language does not draw is inventing a
distinction, not being thorough.
### Verifying UI work
Store tests do not exercise the component. At least one bug in this repo's
history — a shift-click range measured inside a `setState` updater, which React
runs after the anchor ref has already moved — passed every store assertion and
failed the moment the built app was driven. If a change is visible on screen,
run it: `npm run dev:mock` (mock Stalwart, credentials printed on start), then
drive the real thing. Add a component test for what you find; there are
examples in `web/src/views/*/__tests__/`.
### Development Setup ### Development Setup
1. Clone your fork: 1. Clone your fork:
+2 -2
View File
@@ -1,5 +1,5 @@
# ---- build stage ---- # ---- build stage ----
FROM node:22-alpine AS build FROM node:26-alpine AS build
# What this build calls itself: 2.16.<PR>, worked out by whoever runs the # What this build calls itself: 2.16.<PR>, worked out by whoever runs the
# build. It cannot be worked out in here -- .dockerignore keeps .git out of the # build. It cannot be worked out in here -- .dockerignore keeps .git out of the
# context on purpose, and git is not installed either. `node scripts/version.mjs` # context on purpose, and git is not installed either. `node scripts/version.mjs`
@@ -25,7 +25,7 @@ COPY . .
RUN npm run build RUN npm run build
# ---- runtime stage ---- # ---- runtime stage ----
FROM node:22-alpine AS runtime FROM node:26-alpine AS runtime
# Re-declared: an ARG does not cross stages. # Re-declared: an ARG does not cross stages.
ARG IHASMAIL_VERSION="" ARG IHASMAIL_VERSION=""
ARG BASE_PATH="" ARG BASE_PATH=""
+221 -6
View File
@@ -12,10 +12,12 @@ questions:
| [KNOWN-ISSUES.md](KNOWN-ISSUES.md) | What was verified live, and where Stalwart departs from a spec | | [KNOWN-ISSUES.md](KNOWN-ISSUES.md) | What was verified live, and where Stalwart departs from a spec |
| [docs.ihasmail.org](https://docs.ihasmail.org) | How to install, configure and drive each of these | | [docs.ihasmail.org](https://docs.ihasmail.org) | How to install, configure and drive each of these |
Written against the tree at Stalwart **0.16.21**, which is the version the live Written against the tree at Stalwart **0.16.22**, which is the version the live
instance runs. Behaviours carrying an older version below were checked against instance runs. Behaviours carrying an older version below were checked against
that one and have not changed since; where 0.16.21 changed something, the entry that one and have not changed since; where a later release changed something,
says so and names both. ihasmail the entry says so and names both. 0.16.22 changed nothing described here: its
client-visible changes are in what `CalendarEvent/get` and `ContactCard/get`
return, and [KNOWN-ISSUES.md](KNOWN-ISSUES.md) lists them. ihasmail
requires 0.16 or newer and refuses older servers at sign-in, by name. requires 0.16 or newer and refuses older servers at sign-in, by name.
## The shape of it ## The shape of it
@@ -546,6 +548,24 @@ nothing for anybody else.
- **iCal import** through `CalendarEvent/parse` (a file of any number of - **iCal import** through `CalendarEvent/parse` (a file of any number of
events), from the calendar's own menu, into that calendar. The events are events), from the calendar's own menu, into that calendar. The events are
filed rather than scheduled: no invitations go out to anyone named in them. filed rather than scheduled: no invitations go out to anyone named in them.
- **Re-importing updates rather than duplicates**, as a contacts import does.
An event is recognised by its UID, per calendar, and what the file carries
wins -- so a corrected export corrects what the first attempt got wrong.
Two things are deliberately left alone: **who accepted**, and **edits to a
single occurrence**. Both are answers and decisions taken here after the file
was written, and a file that mentions them at all describes them as they were
at export, so writing either one over would throw away work silently and
return no error anywhere. A corrected export therefore fixes the time, the
title and the location, and leaves the RSVPs and the "just this Wednesday"
changes where they are.
The cost runs both ways and is worth knowing. An attendee added at the source
since the last import does not arrive, because nothing here can tell that
apart from an answer given in ihasmail. And an import still sends no
scheduling messages, so an event a re-import moves is moved *here* --
everybody else's copy still says the old time until whoever is organising
sends the update from the event itself.
- **Subscribed calendars** by URL — a timetable, a rota, a public holiday list. - **Subscribed calendars** by URL — a timetable, a rota, a public holiday list.
Added in Settings Calendar & contacts, read-only, and shown beside your own Added in Settings Calendar & contacts, read-only, and shown beside your own
with their own colour. with their own colour.
@@ -1075,6 +1095,117 @@ needed nothing in either half.
--- ---
# Administration
An account whose Stalwart role manages other accounts finds **Administration**
in the account menu, top right. Nobody else sees the entry, and the page
redirects them to their mail if they type its address in.
## What it offers is what the role allows
At sign-in the server already asks Stalwart's `GET /api/account` for the
edition; it now keeps the account's **permissions** from the same answer and
hands them to the browser with the session. The menu appears for an account
that can query and read accounts (`sysAccountQuery`, `sysAccountGet`) or
domains (`sysDomainQuery`, `sysDomainGet`), and each control inside is there only when the matching permission is:
**New account** with `sysAccountCreate`, editing with `sysAccountUpdate`,
**Delete** with `sysAccountDestroy`. A system administrator, a tenant
administrator and a custom helpdesk role each see the same screen shaped to
what they can do.
None of that is the security boundary. Every read and write is a JMAP `x:`
call through the ordinary `/api/jmap` proxy, authenticated as the signed-in
account, and Stalwart decides each one — scoping a tenant administrator's
queries to their own tenant and refusing anything the role does not allow.
The client's gating only avoids offering what would fail.
## Accounts
- **List and search** by name or address, fifty to a page, newest first — the
server's own order. Role, storage used against the limit, and groups at a
glance.
- **Create** an account on any domain the role can see: display name, address,
a generated password to copy and pass on, role, and storage limit.
- **Edit** the display name, other addresses (aliases), role and storage limit.
One save sends only what changed.
- **Set a new password.** It goes into the account's existing password
credential, and signs the person out of every app and device using the old
one, because Stalwart ties every token to the password.
- **Delete**, after typing the address to confirm. Stalwart removes the
mailbox's data in the background, and says so.
Roles are offered only when the viewer holds every permission they carry,
which is the check Stalwart makes on a grant. It does **not** make that check
when only a password changes, or on a delete, so an account allowed to edit
accounts could otherwise reset the password of one that can do more and sign
in as it. ihasmail shows any account that outranks the viewer read-only, and
counts a role it cannot read as outranking rather than not. Nobody can change
their own role or delete the account they are signed in with.
## Domains
For a role that can read domains (`sysDomainQuery`, `sysDomainGet`):
- **List and search**, with how many accounts use each domain and whether its
DNS records, DKIM keys and certificate are managed automatically or by hand.
- **Add** a domain. Stalwart gives a new one automatic DKIM, so it has keys
straight away.
- **Edit** the description, other names for the domain, the catch-all address,
and plus addressing (`name+anything@`). A plus-addressing rule set on the
server is shown and left alone.
- **DNS records**, one per row with a copy button each, and the lot as a zone
file. Stalwart computes them per domain — MX, SPF, DKIM, DMARC, the service
records, MTA-STS, TLS reporting, CAA — and ihasmail joins a long DKIM record
back into the single value a DNS provider's form wants.
- **DKIM keys** with their stage — signing, published and waiting, retiring —
read-only, because the server creates and rotates them itself when DKIM is
automatic, and a key added by hand needs its private key.
- **Remove** a domain once nothing uses it. While accounts do, removal says how
many and stays unavailable. The domain's own DKIM keys go with it, since the
server will not remove a domain its keys still name — which also means a role
that cannot delete keys cannot remove a domain that has any.
Switching DNS, DKIM or certificate management between automatic and manual,
and choosing a DNS or ACME provider, stay in Stalwart's own interface for now.
## Only on your own device
Administration is available only to a session signed in with **"This is my own
device"** ticked. A borrowed laptop or a shared machine is exactly where nobody
should be able to reset a password or remove a domain, and that tickbox is the
one question the sign-in page already asks about where it is being used.
It is enforced the same way as the switch below: an untrusted session is sent
no permissions, and the JMAP proxy refuses registry methods beyond the account's
own. The menu still shows **Administration** to an administrator in that
session, greyed out, with the reason and what to do about it — signing in again
with the box ticked — rather than losing the entry without a word. All the
server tells that session is that the account administers, never what it may do.
## An operator can turn it off
`ADMINISTRATION=0` at launch removes it for everyone, and not only from the
menu. The permissions are no longer sent to the browser, and the JMAP proxy
refuses Stalwart registry methods except the ones about the signed-in account
itself — its password, app passwords, API keys, public keys, masked addresses
and account settings. Without that, hiding the menu would leave an
administrator's browser console able to make every call the menu made.
Stalwart's own interface is unaffected; this decides what ihasmail offers.
## Stateless, as everything else
Nothing new is stored anywhere. There is no admin route on ihasmail's server,
no database and no cache beyond the permissions list that rides along with the
session information already kept for thirty minutes — so a role granted or
taken away shows in the menu at the next sign-in or within half an hour, and in
the meantime Stalwart refuses what is no longer allowed.
Accounts and domains are the first two sections. Groups, mailing lists, roles
and tenants are Stalwart capabilities the same screen is laid out to take;
reporting, queues, logs and server settings are deliberately out of scope.
---
# Live updates and notifications # Live updates and notifications
- **JMAP push over EventSource**, proxied by ihasmail's server so the browser - **JMAP push over EventSource**, proxied by ihasmail's server so the browser
@@ -1101,9 +1232,14 @@ needed nothing in either half.
when the open page happened to be the root. when the open page happened to be the root.
- **The subscription is renewed on every app start**, because a JMAP push - **The subscription is renewed on every app start**, because a JMAP push
subscription expires — seven days is the ceiling — and re-registering before subscription expires — seven days is the ceiling — and re-registering before
it lapses is the client's job. Renewal can only happen with a page open: it lapses is the client's job. Renewal happens with a page open, and the
registering is a JMAP call and the service worker has no session to make one reason is *when* the service worker runs rather than what it is allowed to
with. So the guarantee is that background notifications keep working as long do: it only wakes for an event, and the event that would wake it is a push
that stops arriving the moment the subscription lapses. A renewal that can
only run while renewal is still unnecessary is no schedule at all. (This
page previously said the worker had no session to register with. That was
wrong — see **Acting on a notification** below.) So the guarantee is that
background notifications keep working as long
as ihasmail is opened now and again, and the two-day renewal window means as ihasmail is opened now and again, and the two-day renewal window means
once a week is enough. A browser that dropped or rotated its subscription on once a week is enough. A browser that dropped or rotated its subscription on
its own is re-subscribed at the same moment, rather than left with a switch its own is re-subscribed at the same moment, rather than left with a switch
@@ -1123,6 +1259,76 @@ needed nothing in either half.
installability and fast loads, API requests never are, and navigations are installability and fast loads, API requests never are, and navigations are
network-first with the shell as fallback. network-first with the shell as fallback.
- **Manifest shortcuts** for Compose, Calendar and Contacts. - **Manifest shortcuts** for Compose, Calendar and Contacts.
- **One window, not one per launch.** A `mailto:` link, a shortcut or a
notification opened while ihasmail is already running arrives in the copy
that is running. Two windows on the same inbox disagree about what has been
read, and only one of them is where the half-written reply is.
- **The unread count on the installed app's icon.** The tab title and the
painted favicon are the same idea for a browser tab, and an installed app has
neither -- in `display: standalone` there is no tab strip and no favicon on
screen, so a home-screen ihasmail showed nothing at all. Web Push marks the
icon while the app is closed, with a dot rather than a figure: the service
worker is not told how many messages are unread — a push carries the new mail
rather than a total, so counting the payload would badge "2" over an inbox
holding forty. The next tab to open writes the real count over it. It could
now ask, which is a change since this was written; whether a badge is worth a
request on every push is a separate question and has not been answered yet.
Unsupported browsers show nothing, as does iOS until notification permission
has been granted, which is that platform's condition for a badge.
- **In the share sheet** — share a photo, a link or a file from any other app
and ihasmail is one of the places it can go, opening a draft that holds it.
The subject comes from the shared title, the text and the link become the
body above your signature, and files are attached and start uploading. It
addresses nothing: a share says what to send, never who to.
A share is a POST, which is not something a client-side router can answer, so
the service worker takes the body, leaves it where a tab can collect it and
redirects to the app. That indirection is also what lets a share to a
signed-out ihasmail work — it waits through the sign-in page and opens after,
which the query string could not have survived. One nobody comes back for
expires after ten minutes rather than opening a composer full of a forgotten
photo the next time you look. Android and Chromium only; iOS does not
implement share targets.
- **Acting on a notification.** Archive and Mark as read sit on the
notification itself, and both happen where you are — the phone stays in your
hand, or in your pocket. They are the two a phone shows: `maxActions` is two
on Android, and anything past it is dropped silently, so these are the two
worth having rather than the two that came first. Reply is deliberately not
among them, because it would have to open the app, and tapping the
notification already does that.
This was described here as impossible, and it is worth saying why it was not.
ihasmail's session is an httpOnly cookie against its own origin, and the only
other thing the API asks for is a fixed header that is not a secret. A
same-origin request from the service worker carries the cookie like any
other, so `Email/set` from a notification is an ordinary call. What the
worker genuinely cannot reach is anything a *tab* holds in memory — and the
API asks for none of it.
What it cannot reach is a catalogue. The worker is plain JavaScript outside
the bundle, with no i18n and no idea which mailbox is the archive, so the app
writes both down for it whenever the language, the account or the folder list
changes. Where there is no such note — between installing a new worker and
next opening ihasmail — the notification appears with no action buttons at
all rather than English ones over a guessed mailbox.
A session can still be gone by the time a button is pressed: expired, signed
out, or a cookie that did not outlive the browser. That comes back as a
refusal, and the notification says so rather than disappearing as though it
had worked. It does not open the app to recover — being interrupted is the
thing the button existed to avoid.
- **Share** — a message, or one attachment, handed to the operating system's
share sheet instead of to the filesystem. On a phone a download is close to a
dead end: the file lands in Downloads and whoever wanted to send it somewhere
goes hunting for it in a file manager. The sheet is on the message menu, on
each attachment row, and in the file viewer, which is where an attachment is
already open. A message shares as text rather than as the `.eml` beside it,
because a share sheet is aimed at everything that is not a mail client and an
`.eml` in a chat app is an attachment nobody can open. Every one of those
controls is drawn only where the browser has Web Share -- absent on desktop
Linux and in Firefox -- and sharing a file is asked about separately from
sharing at all. Where the share cannot be made, the download it sits beside
happens instead, so the worst case costs a tap rather than the file.
- **`mailto:` handler** — registered from Settings General for the browser - **`mailto:` handler** — registered from Settings General for the browser
(needs HTTPS; Safari does not support it), and declared in the manifest so an (needs HTTPS; Safari does not support it), and declared in the manifest so an
installed ihasmail is offered by the operating system wherever something asks installed ihasmail is offered by the operating system wherever something asks
@@ -1183,6 +1389,7 @@ costs something to get wrong is the one that assumes the machine is yours.
| Idle sign-out | after 5 minutes | none | | Idle sign-out | after 5 minutes | none |
| Kept on the computer | nothing | settings cache, recent addresses, username | | Kept on the computer | nothing | settings cache, recent addresses, username |
| Background notifications | refused | available | | Background notifications | refused | available |
| Administration | unavailable | available, if the role allows it |
Local storage is gated on that answer for **reads** as well as writes — a Local storage is gated on that answer for **reads** as well as writes — a
machine trusted once still has residue, and honouring it would let a previous machine trusted once still has residue, and honouring it would let a previous
@@ -1366,6 +1573,7 @@ wizard, because either would be state.
| `UPSTREAM_TIMEOUT` | `30000` | Milliseconds | | `UPSTREAM_TIMEOUT` | `30000` | Milliseconds |
| `MAX_UPLOAD_BYTES` | `52428800` | 50 MB | | `MAX_UPLOAD_BYTES` | `52428800` | 50 MB |
| `IMAGE_PROXY` | `1` | Privacy proxy for remote images | | `IMAGE_PROXY` | `1` | Privacy proxy for remote images |
| `ADMINISTRATION` | `1` | Offer in-app administration to accounts whose Stalwart role allows it; `0` turns it off, in the proxy as well as the menu |
| `LOGIN_RATE_LIMIT` | `10` | Attempts per window | | `LOGIN_RATE_LIMIT` | `10` | Attempts per window |
| `COOKIE_NAME` | `ihm_session` | | | `COOKIE_NAME` | `ihm_session` | |
| `APP_NAME` | `ihasmail` | Branding | | `APP_NAME` | `ihasmail` | Branding |
@@ -1451,6 +1659,13 @@ moves an occurrence renumbering the ids around it. Two switches:
`MOCK_NO_REGISTRY=1` omits the Stalwart capability so the sign-in refusal can be `MOCK_NO_REGISTRY=1` omits the Stalwart capability so the sign-in refusal can be
tested. tested.
Administration works against it too, with a directory of about thirty accounts,
three domains with their DKIM keys and zone files, behind the same permission
names Stalwart uses. `MOCK_ROLE` decides who the
demo user is: `admin` (the default), `tenant-admin`, `helpdesk` — a custom role
that may view and edit accounts but not create or delete them — or `user`, who
is not offered the menu at all.
--- ---
# What it does not do # What it does not do
+31 -3
View File
@@ -4,7 +4,7 @@ What was checked, against which server, and when. For a failure you are hitting
right now, start with [Troubleshooting](https://docs.ihasmail.org/troubleshooting/); right now, start with [Troubleshooting](https://docs.ihasmail.org/troubleshooting/);
for what is not built yet, see [ROADMAP.md](ROADMAP.md). for what is not built yet, see [ROADMAP.md](ROADMAP.md).
The live instance runs **0.16.21**, and as of **2026-08-26 there is nothing The live instance runs **0.16.22**, and as of **2026-08-26 there is nothing
left pending**. Most entries below were exercised against 0.16.19 on the date left pending**. Most entries below were exercised against 0.16.19 on the date
they name, and the dates still say so: each upgrade since was read against the they name, and the dates still say so: each upgrade since was read against the
diff rather than re-run, and nothing in those diffs touches the session diff rather than re-run, and nothing in those diffs touches the session
@@ -17,6 +17,16 @@ things a client can see, one of which resolved an entry below outright. The app
was run against a real 0.16.21 with mail, calendar and contacts exercised by was run against a real 0.16.21 with mail, calendar and contacts exercised by
hand, including editing one occurrence of a recurring series through the hand, including editing one occurrence of a recurring series through the
interface and confirming the rest of the series stayed where it was. interface and confirming the rest of the series stayed where it was.
**0.16.22 (2026-09-13) was tested too.** The app has been tested against it on
the live instance. Its changes a client can see are all in `CalendarEvent/get`
and `ContactCard/get`, and were read from its source before the mock was made
to follow them: `baseEventId` is `null` for an event read by its stored id,
`recurrenceRule` and `recurrenceOverrides` asked for on a synthetic id come back
`null`, `useDefaultAlerts` belongs to the reader and reads `false` until set,
and an empty `properties` list returns `id` alone. None of them contradicts an
entry below.
What remains here is not a list of unknowns but of things worth knowing — where What remains here is not a list of unknowns but of things worth knowing — where
Stalwart departs from a spec, where a setting has to be turned on for a feature Stalwart departs from a spec, where a setting has to be turned on for a feature
to work, and what ihasmail deliberately does not do. to work, and what ihasmail deliberately does not do.
@@ -32,6 +42,24 @@ works the same way — and dropped where 0.15 was the whole subject. Support for
0.15 was removed on 2026-08-26; the last release that runs on it is tagged 0.15 was removed on 2026-08-26; the last release that runs on it is tagged
[`stalwart-0.15-support`](https://github.com/Coffey-Labs/ihasmail/releases/tag/stalwart-0.15-support). [`stalwart-0.15-support`](https://github.com/Coffey-Labs/ihasmail/releases/tag/stalwart-0.15-support).
- **Administration was built from Stalwart's source, and the first live run found the one thing the source reading got wrong.** Accounts and Domains were written on 2026-09-13 against the 0.16.22 source and a mock reproducing it, deployed the same day, and exercised against the live server from an administrator's session. On that server the Accounts list did not load: `x:Account/query` answered **`unsupportedFilter - type`**. A registry filter is keyed by the property's name *as it appears on the object*, and the discriminator is `@type`, so `{"type": "User"}` names nothing the server knows and fails the whole query; `{"@type": "User"}` is accepted. The research that fed the build had listed the field as `type`, and the mock took it without complaint — which is how it shipped. Fixed in [#336](https://github.com/Coffey-Labs/ihasmail/pull/336), and the mock now refuses any filter name the real server does not index, answering the way Stalwart does. Everything else was **confirmed live (2026-09-13)**, mostly read-only, with the domain writes made on a throwaway domain created for the purpose and removed afterwards:
- **Permissions** come from `GET /api/account` in camelCase (`sysAccountGet`); an administrator's list held 641 of them and none were kebab-case, whatever the documentation shows. The menu gates on these.
- **The Basic credential ihasmail proxies with reaches the admin `x:` methods**, as it already reached the self-service ones. No separate token is involved.
- **An account reads back in the shapes the code expects**: `credentials` as `{"0": {"@type": "Password", …}}`, aliases and group memberships as objects, the disk limit under `quotas.maxDiskQuota`.
- **A new domain gets automatic DKIM straight away** — an Ed25519 and an RSA key, both `active`, with their records already in the zone file — and manual DNS and certificates.
- **`dnsZoneFile` is BIND text**, one record per line as `name IN TYPE value`, with a long TXT record split into a parenthesised run of quoted chunks. A throwaway domain's file held 18 records and 3 continuation lines; every record parsed and the panel showed 18 rows. The production domains also carry TLSA records, which show as rows like any other.
- **`x:DkimSignature/query` accepts a `domainId` filter.**
- **`catchAllAddress` wants a whole address.** A bare local part is refused with `invalidPatch`, *"Invalid email address"*.
- **A domain its keys still name cannot be destroyed**: `objectIsLinked`, with `linkedObjects` listing each as `{"object": "DkimSignature", "id": …}` and no description. Removing through the panel destroys the keys first and then the domain; both were gone afterwards.
- **A reserved TLD is refused**: `example` as a domain's top level comes back `invalidPatch`, *"Invalid domain name"*, naming `name`.
The last two were then tried by hand on the live server the same day and behaved as described. **A password set by an administrator** — written to the account's existing credential, `credentials/<index>/secret` — signs in. **The outranking guard** held: an account with more rights than the viewer's role opens read-only. The guard exists because the source shows Stalwart skipping its grant check when only a password changes and on a delete, and it stays for that reason.
- **A refused password shows the server's reason in English.** Every other refusal from the registry is said in the reader's language: each error type has its own message, and a value one of Stalwart's validators refused — a domain name, an address, an empty field — is recognised by the validator's wording and explained again rather than shown. A password policy is the exception, on purpose. Its rule is the server's to set, so there is nothing to translate it from in advance, and its reason follows a translated sentence rather than being dropped, which would leave "not accepted" with no way to find out why.
- **Administration is off for a device not marked as your own, and for an installation that says so.** Both are enforced by the server rather than hidden by the menu: such a session is sent no permissions, and the JMAP proxy refuses registry methods beyond the account's own. That is worth stating because the proxy otherwise forwards whatever the browser sends, and before these gates an administrator's console could make any registry call their role allowed. For a session that may not administer, the proxy reads a request body only when it could name a registry method — a `"x:` in the text, or a `\u` escape that could spell one — so ordinary mail traffic is forwarded untouched.
- **All nine translations have never been read by anybody who speaks them.** They were produced by AI against standard dictionaries on 2026-08-31 — German, Spanish, French, Dutch, Portuguese (Brazil), Russian, Ukrainian, Simplified Chinese and Japanese, which with English makes ten languages in the picker — and every one of the nine is marked **Beta** in the picker, with that stated in Settings beside a link for reporting anything that reads wrongly. This is the entry that matters most on this page, because it is the one thing here that cannot be closed by testing: a translation can be complete, consistent, pass every check, and still read like a machine wrote it, and nobody on this project can tell which. What *is* verified is the machinery around them. A missing key renders its English source, so a bad line can simply be deleted; a stale key — one whose English no longer exists — is caught by `npm run i18n:check` rather than sitting in the file looking correct and never being looked up. Plurals are asked of `Intl.PluralRules` rather than assumed, which is why Russian and Ukrainian carry three forms and Japanese and Chinese carry one; supplying `one` for Japanese would have been filling in a distinction the language does not draw. Confirmed live on the deployed instance (2026-08-31) against a 6,289-message mailbox: role folders localise and the ~20 custom folders keep the names their owner gave them, dates and the calendar follow the language, and 6,289 renders as *6289 листувань* — the genitive plural a number ending in nine takes, which is the first time the plural machinery ran on anything but a hand-picked value. - **All nine translations have never been read by anybody who speaks them.** They were produced by AI against standard dictionaries on 2026-08-31 — German, Spanish, French, Dutch, Portuguese (Brazil), Russian, Ukrainian, Simplified Chinese and Japanese, which with English makes ten languages in the picker — and every one of the nine is marked **Beta** in the picker, with that stated in Settings beside a link for reporting anything that reads wrongly. This is the entry that matters most on this page, because it is the one thing here that cannot be closed by testing: a translation can be complete, consistent, pass every check, and still read like a machine wrote it, and nobody on this project can tell which. What *is* verified is the machinery around them. A missing key renders its English source, so a bad line can simply be deleted; a stale key — one whose English no longer exists — is caught by `npm run i18n:check` rather than sitting in the file looking correct and never being looked up. Plurals are asked of `Intl.PluralRules` rather than assumed, which is why Russian and Ukrainian carry three forms and Japanese and Chinese carry one; supplying `one` for Japanese would have been filling in a distinction the language does not draw. Confirmed live on the deployed instance (2026-08-31) against a 6,289-message mailbox: role folders localise and the ~20 custom folders keep the names their owner gave them, dates and the calendar follow the language, and 6,289 renders as *6289 листувань* — the genitive plural a number ending in nine takes, which is the first time the plural machinery ran on anything but a hand-picked value.
- **`npm run i18n:coverage` reported 100% while about two hundred strings rendered English in every language.** It reads JSX text, and it was not wrong about what it measured — none of them were JSX text. They were `toast.error(...)` arguments, `confirmDialog({ title, confirmLabel })` props, `title=` and `aria-label=` attributes, and template literals: every one built from an expression a codemod cannot read. The calendar's own view switcher was the clearest case, spelling its labels `v[0].toUpperCase() + v.slice(1)` — correct English, untranslatable anywhere else, and galling because **Day**, **Week**, **Month** and **Agenda** were already in all nine catalogues and the buttons simply never asked for them. Reported from production, where the switcher stayed English in a Japanese interface. All of them are now wrapped, and `npm run i18n:check` grew a second half (`scripts/i18n-literals.mjs`) that accepts a string wrapped where it is written *or* present as a catalogue key — the constant-table convention, where `SECTIONS` holds `label: "About"` and the render site calls `t(s.label)` — and refuses one that is neither, because that is a string no catalogue can translate however many languages ship. It found twenty more than a hand sweep had. Worth recording as a general lesson rather than an i18n one: a coverage number measures the thing it can see, and the strings it cannot see are exactly the ones nobody is checking. - **`npm run i18n:coverage` reported 100% while about two hundred strings rendered English in every language.** It reads JSX text, and it was not wrong about what it measured — none of them were JSX text. They were `toast.error(...)` arguments, `confirmDialog({ title, confirmLabel })` props, `title=` and `aria-label=` attributes, and template literals: every one built from an expression a codemod cannot read. The calendar's own view switcher was the clearest case, spelling its labels `v[0].toUpperCase() + v.slice(1)` — correct English, untranslatable anywhere else, and galling because **Day**, **Week**, **Month** and **Agenda** were already in all nine catalogues and the buttons simply never asked for them. Reported from production, where the switcher stayed English in a Japanese interface. All of them are now wrapped, and `npm run i18n:check` grew a second half (`scripts/i18n-literals.mjs`) that accepts a string wrapped where it is written *or* present as a catalogue key — the constant-table convention, where `SECTIONS` holds `label: "About"` and the render site calls `t(s.label)` — and refuses one that is neither, because that is a string no catalogue can translate however many languages ship. It found twenty more than a hand sweep had. Worth recording as a general lesson rather than an i18n one: a coverage number measures the thing it can see, and the strings it cannot see are exactly the ones nobody is checking.
@@ -42,7 +70,7 @@ works the same way — and dropped where 0.15 was the whole subject. Support for
- **Sharing a mail folder is accepted and does nothing.** `Mailbox/set` with a `shareWith` map is applied, `Mailbox/get` reads it back, and the folder never appears for the account it was shared with — **confirmed live on 0.16.19 (2026-08-27)** with a folder shared read-only to another account on the same server, which never saw it. Stalwart's own sharing documentation lists calendars, address books and file storage; mail folders are not among them. Nothing reports a failure at any point, which is the whole problem: the share is stored, so a client that trusts what it reads back shows it as live for ever. The entry point is withdrawn. A folder that is *already* shared still offers **Stop sharing**, because a share nobody can see is exactly the one you want to be able to clear, and there is no other way to. File sharing is unaffected and works end to end. - **Sharing a mail folder is accepted and does nothing.** `Mailbox/set` with a `shareWith` map is applied, `Mailbox/get` reads it back, and the folder never appears for the account it was shared with — **confirmed live on 0.16.19 (2026-08-27)** with a folder shared read-only to another account on the same server, which never saw it. Stalwart's own sharing documentation lists calendars, address books and file storage; mail folders are not among them. Nothing reports a failure at any point, which is the whole problem: the share is stored, so a client that trusts what it reads back shows it as live for ever. The entry point is withdrawn. A folder that is *already* shared still offers **Stop sharing**, because a share nobody can see is exactly the one you want to be able to clear, and there is no other way to. File sharing is unaffected and works end to end.
- **Address book sharing works, and was briefly withdrawn by mistake.** It was taken out alongside mail folders on 2026-08-27 on a report that it behaved the same way; the report was mistaken and the feature was put back the same day. Nothing was ever shown to be wrong with it, and Stalwart documents address books as shareable. Recorded because the withdrawal is in the history and would otherwise read as a finding. Shared books now appear in the Contacts pane under "Shared with me" rather than behind an account switch, and their contacts are offered when addressing a message. - **Address book sharing works, and was briefly withdrawn by mistake.** It was taken out alongside mail folders on 2026-08-27 on a report that it behaved the same way; the report was mistaken and the feature was put back the same day. Nothing was ever shown to be wrong with it, and Stalwart documents address books as shareable. Recorded because the withdrawal is in the history and would otherwise read as a finding. Shared books now appear in the Contacts pane under "Shared with me" rather than behind an account switch, and their contacts are offered when addressing a message.
- **Stalwart lets a sharee subscribe to a shared calendar but not a shared address book.** Subscribing is a write to the *owner's* account -- `isSubscribed` lives on the collection, not on the reader -- and 0.16.19 refuses it for a book shared read-only: `AddressBook/set` answers successfully with the id in `notUpdated`, `forbidden`, *"You are not allowed to modify this address book."* The identical `Calendar/set` on a shared calendar is accepted. **Confirmed live on 0.16.19 (2026-08-27)** from a second account holding both shares, which is the only place it shows: from the owner's own account the write succeeds and everything looks fine. So ihasmail asks the server first, because a preference the server holds is one every client agrees about, and keeps the answer in its own synced settings (`addedShares`) when the server will not. Two things this cost, both worth remembering: the refusal arrives as a *successful* response, so the code that ignored `notUpdated` saw nothing wrong and the button simply did nothing; and it is invisible from the owner's account, so it took two browsers signed in as two accounts to find at all. The mock now refuses the same write for the same reason, since one that accepted it agreed with the belief that shipped. - **Stalwart lets a sharee subscribe to a shared calendar but not a shared address book.** Subscribing is a write to the *owner's* account -- `isSubscribed` lives on the collection, not on the reader -- and 0.16.19 refuses it for a book shared read-only: `AddressBook/set` answers successfully with the id in `notUpdated`, `forbidden`, *"You are not allowed to modify this address book."* The identical `Calendar/set` on a shared calendar is accepted. **Confirmed live on 0.16.19 (2026-08-27)** from a second account holding both shares, which is the only place it shows: from the owner's own account the write succeeds and everything looks fine. So ihasmail asks the server first, because a preference the server holds is one every client agrees about, and keeps the answer in its own synced settings (`addedShares`) when the server will not. Two things this cost, both worth remembering: the refusal arrives as a *successful* response, so the code that ignored `notUpdated` saw nothing wrong and the button simply did nothing; and it is invisible from the owner's account, so it took two browsers signed in as two accounts to find at all. The mock now refuses the same write for the same reason, since one that accepted it agreed with the belief that shipped.
- **`shareWith` is not returned unless a client asks for it by name.** A `Calendar/get` or `AddressBook/get` with no `properties` comes back without the field at all — not null, not empty, absent — **confirmed live on 0.16.19 (2026-08-27)** against a calendar and an address book that were genuinely shared with another account: omit the list and there is no `shareWith`; name it and the sharee is right there. Every consequence was silent. Nothing was badged as shared, "Stop sharing" never appeared because nothing looked shared, and the share dialog opened on *"not shared with anyone yet"* over a live share — so the one screen that existed to manage sharing was the one most confidently wrong about it. Files never had this, because `fileNodeProps` had always named the property; calendars, address books and mail folders fetched everything and got less. Mail folders mattered in a way of their own: sharing one is withdrawn, and the only way to clear a share already made is a **Stop sharing** entry that appears when a folder looks shared — so without the property the escape hatch for the exact situation it was built for was invisible. The mock now omits it the same way, since one that hands it over unasked lets a client that never asks look correct everywhere except against a real server. - **`shareWith` is not returned unless a client asks for it by name.** A `Calendar/get` or `AddressBook/get` with no `properties` comes back without the field at all — not null, not empty, absent — **confirmed live on 0.16.19 (2026-08-27)** against a calendar and an address book that were genuinely shared with another account: omit the list and there is no `shareWith`; name it and the sharee is right there. Every consequence was silent. Nothing was badged as shared, "Stop sharing" never appeared because nothing looked shared, and the share dialog opened on *"not shared with anyone yet"* over a live share — so the one screen that existed to manage sharing was the one most confidently wrong about it. Files never had this, because `fileNodeProps` had always named the property; calendars, address books and mail folders fetched everything and got less. Mail folders mattered in a way of their own: sharing one is withdrawn, and the only way to clear a share already made is a **Stop sharing** entry that appears when a folder looks shared — so without the property the escape hatch for the exact situation it was built for was invisible. The mock omitted it the same way, since one that hands it over unasked lets a client that never asks look correct everywhere except against a real server. **0.16.21 fixed this for calendars and address books**: with `properties` omitted, `Calendar/get` and `AddressBook/get` now return every property, `shareWith` included — **confirmed live on 0.16.21 (2026-09-06)**. `Mailbox/get` on the same server still leaves it out, so the mock now hides it for mail folders alone, and ihasmail keeps naming the property everywhere.
- **Stalwart's `x:PublicKey` registry works, and ihasmail deliberately does not expose it.** A Settings section for it has been built twice — [PR #67](https://github.com/Coffey-Labs/ihasmail/pull/67), closed 2026-08-26, and [PR #285](https://github.com/Coffey-Labs/ihasmail/pull/285) — and withdrawn both times, for a reason that has nothing to do with the server: **nothing in ihasmail signs, encrypts, decrypts or verifies with a key**, so a page for managing them is furniture rather than a feature. It ends up telling the reader, in its own footnote, that adding a key does nothing. The registry is written up here rather than in [ROADMAP.md](ROADMAP.md) because what follows is established fact about Stalwart that cost a live probe, and losing it twice to a closed pull request was how the second attempt came to exist at all. Everything below was **confirmed live on 0.16.20 (2026-09-05)** from a normal account with no administrative rights, and the full round trip — create, read back, rename, patch, destroy — succeeded for both formats. - **Stalwart's `x:PublicKey` registry works, and ihasmail deliberately does not expose it.** A Settings section for it has been built twice — [PR #67](https://github.com/Coffey-Labs/ihasmail/pull/67), closed 2026-08-26, and [PR #285](https://github.com/Coffey-Labs/ihasmail/pull/285) — and withdrawn both times, for a reason that has nothing to do with the server: **nothing in ihasmail signs, encrypts, decrypts or verifies with a key**, so a page for managing them is furniture rather than a feature. It ends up telling the reader, in its own footnote, that adding a key does nothing. The registry is written up here rather than in [ROADMAP.md](ROADMAP.md) because what follows is established fact about Stalwart that cost a live probe, and losing it twice to a closed pull request was how the second attempt came to exist at all. Everything below was **confirmed live on 0.16.20 (2026-09-05)** from a normal account with no administrative rights, and the full round trip — create, read back, rename, patch, destroy — succeeded for both formats.
- **An ordinary user may read *and* write their own keys**, whatever the permissions table says: Stalwart documents every `sysPublicKey*` permission as administrative, and the server granted them anyway. A create carrying a malformed key was refused with `invalidProperties` naming `key` rather than `forbidden` — a rejection of the key, not of the person. Had the documentation been right, any such feature would have been useless to everybody but an administrator, which is why this was probed first. - **An ordinary user may read *and* write their own keys**, whatever the permissions table says: Stalwart documents every `sysPublicKey*` permission as administrative, and the server granted them anyway. A create carrying a malformed key was refused with `invalidProperties` naming `key` rather than `forbidden` — a rejection of the key, not of the person. Had the documentation been right, any such feature would have been useless to everybody but an administrator, which is why this was probed first.
@@ -62,7 +90,7 @@ works the same way — and dropped where 0.15 was the whole subject. Support for
- **Files on 0.16** — the pre-0.16 quirks this entry used to describe are gone with the support for them: `FileNode/query` masking directories out of its own results, `nodeType` not existing, and rights being a single `mayWrite`. What is left is what has actually been exercised on 0.16.19. Finding and creating a folder, creating a node with `nodeType`, uploading and downloading its blob, and pointing an existing node at a new one all ran live on 2026-08-26, as a side effect of the settings file. Rename, move and delete are **confirmed live on 0.16.19 (2026-08-26)** as well, which closes this out: what had been confirmed on 0.15.5 (2026-08-24) was the older code path, and that path no longer exists. Two fallbacks went with the removal and are worth knowing about: `ensureFolder` and `findInFolder` now filter on `parentId`/`isTopLevel` alone and match names client-side, since `name` is not a filter Stalwart is known to implement and one it does not know fails the whole query; and a refused filter or sort no longer drops the view into fetching every node in the account, which would have hidden a real fault behind a performance cliff nobody would notice. - **Files on 0.16** — the pre-0.16 quirks this entry used to describe are gone with the support for them: `FileNode/query` masking directories out of its own results, `nodeType` not existing, and rights being a single `mayWrite`. What is left is what has actually been exercised on 0.16.19. Finding and creating a folder, creating a node with `nodeType`, uploading and downloading its blob, and pointing an existing node at a new one all ran live on 2026-08-26, as a side effect of the settings file. Rename, move and delete are **confirmed live on 0.16.19 (2026-08-26)** as well, which closes this out: what had been confirmed on 0.15.5 (2026-08-24) was the older code path, and that path no longer exists. Two fallbacks went with the removal and are worth knowing about: `ensureFolder` and `findInFolder` now filter on `parentId`/`isTopLevel` alone and match names client-side, since `name` is not a filter Stalwart is known to implement and one it does not know fails the whole query; and a refused filter or sort no longer drops the view into fetching every node in the account, which would have hidden a real fault behind a performance cliff nobody would notice.
- **Self-service credentials** — the registry path is **confirmed live** against Stalwart 0.16.19 (2026-08-25): app passwords created and revoked, password changed, 2FA enabled and disabled, with the browser session surviving the switch to an app password. The 0.15 REST path was confirmed live too, on 0.15.5 (2026-08-24), and has since been removed along with the rest of 0.15 support. The mock enforces the same rules the real server does (current password required, password policy, a TOTP code on every request once 2FA is on, app passwords exempt from it). Password changes are refused by Stalwart for accounts backed by an external directory (LDAP/SQL/OIDC); the server's own message is shown when that happens. - **Self-service credentials** — the registry path is **confirmed live** against Stalwart 0.16.19 (2026-08-25): app passwords created and revoked, password changed, 2FA enabled and disabled, with the browser session surviving the switch to an app password. The 0.15 REST path was confirmed live too, on 0.15.5 (2026-08-24), and has since been removed along with the rest of 0.15 support. The mock enforces the same rules the real server does (current password required, password policy, a TOTP code on every request once 2FA is on, app passwords exempt from it). Password changes are refused by Stalwart for accounts backed by an external directory (LDAP/SQL/OIDC); the server's own message is shown when that happens.
- **Scheduled send needs one setting turned on, and says nothing when it is off.** Stalwart advertises the delay in the account's `urn:ietf:params:jmap:submission` capability — `maxDelayedSend: 2592000` (30 days) and `FUTURERELEASE` among its `submissionExtensions`, and note it is the *account* capability, not the session-level one, which is empty. But the MTA only honours a hold when `futureRelease` is set under the session's MTA extensions, and [that setting defaults to `false`](https://stalw.art/docs/ref/object/mta-extensions/). With it off, Stalwart takes the `HOLDUNTIL` parameter, skips the hold and sends the message immediately **without an error** — the capability still says thirty days. So set `futureRelease` (to the longest hold you want to allow) before relying on this; a value shorter than 30 days is fine, and a request past it is refused honestly, with a `forbiddenMailFrom` naming the limit. `npm run dev:mock:no-future-release` reproduces the silent-drop case. ihasmail asks for the delay the way JMAP requires — a `HOLDUNTIL` parameter on the envelope's `mailFrom`, since RFC 8621 makes `sendAt` read-only and server-derived — and files the held message in a **Scheduled** folder, because `onSuccessUpdateEmail` would otherwise drop it in Sent the moment the submission is created. Nothing moves it out when the hold expires, so ihasmail reconciles the folder on the way in: released messages to Sent, cancelled ones back to Drafts. Three fixes this depends on landed in **0.16.17**, below the live instance's 0.16.19: `HOLDUNTIL` taking RFC 3339 date-times again (0.16.16 had it wanting Unix timestamps), `EmailSubmission/query` on `undoStatus` agreeing with `/get` about held submissions, and `EmailSubmission/get` without `ids` iterating the right index. The hold itself is now **confirmed against the live 0.16.19** (2026-08-25), once `futureRelease` was set to `30d` there: a submission carrying a `HOLDUNTIL` ten minutes out came back `pending`, with `sendAt` equal to the time asked for and a `250 2.1.5 Queued` from the MTA, rather than going out at once. Worth repeating that the capability is no evidence either way — it advertised `maxDelayedSend: 2592000` and `FUTURERELEASE` while the setting was still off. Only a submission tells you. The rest of the journey is **confirmed live too (2026-08-26)**: a hold expired and was delivered, and the **Scheduled** folder reconciled on the way in — a released message moved to Sent, a cancelled one back to Drafts. Nothing in Stalwart does that moving, so if ihasmail is never opened again the message still goes out; it is only the folder that waits to be tidied. - **Scheduled send needs one setting turned on, and says nothing when it is off.** Stalwart advertises the delay in the account's `urn:ietf:params:jmap:submission` capability — `maxDelayedSend: 2592000` (30 days) and `FUTURERELEASE` among its `submissionExtensions`, and note it is the *account* capability, not the session-level one, which is empty. But the MTA only honours a hold when `futureRelease` is set under the session's MTA extensions, and [that setting defaults to `false`](https://stalw.art/docs/ref/object/mta-extensions/). With it off, Stalwart takes the `HOLDUNTIL` parameter, skips the hold and sends the message immediately **without an error** — the capability still says thirty days. So set `futureRelease` (to the longest hold you want to allow) before relying on this; a value shorter than 30 days is fine, and a request past it is refused honestly, with a `forbiddenMailFrom` naming the limit. `npm run dev:mock:no-future-release` reproduces the silent-drop case. ihasmail asks for the delay the way JMAP requires — a `HOLDUNTIL` parameter on the envelope's `mailFrom`, since RFC 8621 makes `sendAt` read-only and server-derived — and files the held message in a **Scheduled** folder, because `onSuccessUpdateEmail` would otherwise drop it in Sent the moment the submission is created. Nothing moves it out when the hold expires, so ihasmail reconciles the folder on the way in: released messages to Sent, cancelled ones back to Drafts. Three fixes this depends on landed in **0.16.17**, below the live instance's 0.16.19: `HOLDUNTIL` taking RFC 3339 date-times again (0.16.16 had it wanting Unix timestamps), `EmailSubmission/query` on `undoStatus` agreeing with `/get` about held submissions, and `EmailSubmission/get` without `ids` iterating the right index. The hold itself is now **confirmed against the live 0.16.19** (2026-08-25), once `futureRelease` was set to `30d` there: a submission carrying a `HOLDUNTIL` ten minutes out came back `pending`, with `sendAt` equal to the time asked for and a `250 2.1.5 Queued` from the MTA, rather than going out at once. Worth repeating that the capability is no evidence either way — it advertised `maxDelayedSend: 2592000` and `FUTURERELEASE` while the setting was still off. Only a submission tells you. The rest of the journey is **confirmed live too (2026-08-26)**: a hold expired and was delivered, and the **Scheduled** folder reconciled on the way in — a released message moved to Sent, a cancelled one back to Drafts. Nothing in Stalwart does that moving, so if ihasmail is never opened again the message still goes out; it is only the folder that waits to be tidied.
- **Stalwart 0.16 and RFC 8984 disagree about the calendar vocabulary, and the server only says so half the time.** A participant's address lives in `calendarAddress`, not RFC 8984's `sendTo`/`email`; the organizer is `organizerCalendarAddress`, not `replyTo`; and a recurrence is a single `recurrenceRule`, not a `recurrenceRules` array. Addressed the RFC's way, `CalendarEvent/set` **keeps the event and discards the whole participant map without an error** — guests disappeared on save and no invitation was ever sent, which is what [#26](https://github.com/Coffey-Labs/ihasmail/issues/26) reported. The array form of the rule is refused honestly, with `invalidProperties`, so recurring events could not be created at all and existing ones showed no repeat ([#30](https://github.com/Coffey-Labs/ihasmail/issues/30)). ihasmail now writes Stalwart's names and reads either, and the mock refuses what the real server refuses, since advertising the RFC spelling is precisely how this got as far as a live server. Verified against 0.16.19 on 2026-08-25, end to end: participants, organizer and rule all survive a create, an update and a re-read; an invitation to an external Gmail address arrived as an invite card, and the decline came back and was applied to the event (`needs-action``declined`, sequence 1). Cancelling the event notified the guest too. Adding guests to an event that had none, and clearing them again with `null`, both work on the update path, as does RSVP — which patches `participants/{key}/participationStatus` (and `participationComment`) rather than sending the whole map. That patch had to be aimed at the base event: through 0.16.19 `CalendarEvent/set` refused a synthetic id with *"Updating synthetic ids is not yet supported"*, which is why RSVP resolves `baseEventId` first. 0.16.20 accepts one, so that resolution is now a choice rather than the only option — an RSVP aimed at an occurrence would answer for that date alone. It still resolves the base, which is the answer people mean. Adding a *new* participant by patch is refused as well (`Patch operation failed`), so a changed guest list is written as the whole `participants` property. One more thing to know when reading this code: an expanded occurrence carries a `recurrenceId` but *no* rule of its own, and `baseEventId` is set on everything an expanded query returns — a one-off included, whose own id differs from its base — so neither is a test for recurrence. - **Stalwart 0.16 and RFC 8984 disagree about the calendar vocabulary, and the server only says so half the time.** A participant's address lives in `calendarAddress`, not RFC 8984's `sendTo`/`email`; the organizer is `organizerCalendarAddress`, not `replyTo`; and a recurrence is a single `recurrenceRule`, not a `recurrenceRules` array. Addressed the RFC's way, `CalendarEvent/set` **keeps the event and discards the whole participant map without an error** — guests disappeared on save and no invitation was ever sent, which is what [#26](https://github.com/Coffey-Labs/ihasmail/issues/26) reported. The array form of the rule is refused honestly, with `invalidProperties`, so recurring events could not be created at all and existing ones showed no repeat ([#30](https://github.com/Coffey-Labs/ihasmail/issues/30)). ihasmail now writes Stalwart's names and reads either, and the mock refuses what the real server refuses, since advertising the RFC spelling is precisely how this got as far as a live server. Verified against 0.16.19 on 2026-08-25, end to end: participants, organizer and rule all survive a create, an update and a re-read; an invitation to an external Gmail address arrived as an invite card, and the decline came back and was applied to the event (`needs-action``declined`, sequence 1). Cancelling the event notified the guest too. Adding guests to an event that had none, and clearing them again with `null`, both work on the update path, as does RSVP — which patches `participants/{key}/participationStatus` (and `participationComment`) rather than sending the whole map. That patch had to be aimed at the base event: through 0.16.19 `CalendarEvent/set` refused a synthetic id with *"Updating synthetic ids is not yet supported"*, which is why RSVP resolves `baseEventId` first. 0.16.20 accepts one, so that resolution is now a choice rather than the only option — an RSVP aimed at an occurrence would answer for that date alone. It still resolves the base, which is the answer people mean. Adding a *new* participant by patch is refused as well (`Patch operation failed`), so a changed guest list is written as the whole `participants` property. One more thing to know when reading this code: an expanded occurrence carries a `recurrenceId` but *no* rule of its own, and `baseEventId` is set on everything an expanded query returns — a one-off included, whose own id differs from its base — so neither is a test for recurrence. Since 0.16.22 the same event read by its *stored* id answers `baseEventId: null` rather than its own id, which changes nothing here: a one-off read through the synthetic id an expanded query gave it still carries a base.
- **Free/busy between accounts needs no sharing, and calendar contents cannot be reached at all.** These are the two halves of the same finding, and the second is what makes the first safe. **Confirmed live on 0.16.20 (2026-09-01)** against the deployed instance: `Principal/getAvailability` was called for all seven principals the directory returns, none of whose calendars are shared with the calling account, and every one was answered — no `forbidden`, no error of any kind, from a server that refuses a malformed call instantly. It returns real data rather than a polite empty list: the caller's own principal reported one busy period against the one event in the next sixty days. And a `Principal` carries only `id`, `type`, `name`, `description` and `email`**no `accountId`** — so there is no handle with which to ask for anybody's calendars. Free/busy is therefore not the weaker of two permissions, it is the only channel between two accounts, and it is open by default. That is the right posture and worth recording, because a client that assumed sharing was a precondition would hide a working feature behind a setting nobody needs to touch. **One thing this did not settle**: the other six principals reported nothing over a nine-month window, which is equally consistent with "those accounts have empty calendars" — likely, since the session reaches one account — and with "an unreadable principal answers with an empty list rather than an error". Distinguishing them needs a second account with an event in it, and until somebody has one, ihasmail assumes the pessimistic reading everywhere it matters: a participant it cannot read is drawn as unknown rather than as free. - **Free/busy between accounts needs no sharing, and calendar contents cannot be reached at all.** These are the two halves of the same finding, and the second is what makes the first safe. **Confirmed live on 0.16.20 (2026-09-01)** against the deployed instance: `Principal/getAvailability` was called for all seven principals the directory returns, none of whose calendars are shared with the calling account, and every one was answered — no `forbidden`, no error of any kind, from a server that refuses a malformed call instantly. It returns real data rather than a polite empty list: the caller's own principal reported one busy period against the one event in the next sixty days. And a `Principal` carries only `id`, `type`, `name`, `description` and `email`**no `accountId`** — so there is no handle with which to ask for anybody's calendars. Free/busy is therefore not the weaker of two permissions, it is the only channel between two accounts, and it is open by default. That is the right posture and worth recording, because a client that assumed sharing was a precondition would hide a working feature behind a setting nobody needs to touch. **One thing this did not settle**: the other six principals reported nothing over a nine-month window, which is equally consistent with "those accounts have empty calendars" — likely, since the session reaches one account — and with "an unreadable principal answers with an empty list rather than an error". Distinguishing them needs a second account with an event in it, and until somebody has one, ihasmail assumes the pessimistic reading everywhere it matters: a participant it cannot read is drawn as unknown rather than as free.
- **An override can move an occurrence, and then `start` and `recurrenceId` mean two different times.** The slot stays where the rule put it and only the clock time moves. **Confirmed live on 0.16.20 (2026-08-31)**: one occurrence of a weekly 09:00 series moved to 14:00 came back `start: 2027-06-14T14:00:00` with `recurrenceId` still `2027-06-14T09:00:00`. This is the right behaviour and it is the reason `recurrenceId` is the handle ihasmail holds: it is the one name for an instance that survives *both* a renumbering and a move, so a mutation can always be re-resolved from it. Worth recording because the mock got it wrong in the other direction — it overwrote an override's `start` with the slot time, so a moved occurrence did not move, and per-occurrence *time* editing looked broken against the mock and correct against the server. Found by asking a real server rather than by reading the mock, which is the only way this kind of disagreement ever surfaces. - **An override can move an occurrence, and then `start` and `recurrenceId` mean two different times.** The slot stays where the rule put it and only the clock time moves. **Confirmed live on 0.16.20 (2026-08-31)**: one occurrence of a weekly 09:00 series moved to 14:00 came back `start: 2027-06-14T14:00:00` with `recurrenceId` still `2027-06-14T09:00:00`. This is the right behaviour and it is the reason `recurrenceId` is the handle ihasmail holds: it is the one name for an instance that survives *both* a renumbering and a move, so a mutation can always be re-resolved from it. Worth recording because the mock got it wrong in the other direction — it overwrote an override's `start` with the slot time, so a moved occurrence did not move, and per-occurrence *time* editing looked broken against the mock and correct against the server. Found by asking a real server rather than by reading the mock, which is the only way this kind of disagreement ever surfaces.
+35 -9
View File
@@ -9,7 +9,7 @@
<p align="center"> <p align="center">
<a href="LICENSE"><img alt="Licence: AGPL-3.0-or-later" src="https://img.shields.io/badge/licence-AGPL--3.0--or--later-2dd4bf?style=flat-square"></a> <a href="LICENSE"><img alt="Licence: AGPL-3.0-or-later" src="https://img.shields.io/badge/licence-AGPL--3.0--or--later-2dd4bf?style=flat-square"></a>
<a href="https://stalw.art" target="_blank" rel="noreferrer"><img alt="Requires Stalwart 0.16 or newer; tested against 0.16.21" src="https://img.shields.io/badge/Stalwart-0.16.21-6366f1?style=flat-square"></a> <a href="https://stalw.art" target="_blank" rel="noreferrer"><img alt="Requires Stalwart 0.16 or newer; tested against 0.16.22" src="https://img.shields.io/badge/Stalwart-0.16.22-6366f1?style=flat-square"></a>
<a href="https://docs.ihasmail.org" target="_blank" rel="noreferrer"><img alt="Documentation: docs.ihasmail.org" src="https://img.shields.io/badge/docs-docs.ihasmail.org-0ea5e9?style=flat-square"></a> <a href="https://docs.ihasmail.org" target="_blank" rel="noreferrer"><img alt="Documentation: docs.ihasmail.org" src="https://img.shields.io/badge/docs-docs.ihasmail.org-0ea5e9?style=flat-square"></a>
<a href="https://coffeylabs.org" target="_blank" rel="noreferrer"><img alt="by Coffey Labs" src="https://img.shields.io/badge/by-Coffey%20Labs-0f766e?style=flat-square"></a> <a href="https://coffeylabs.org" target="_blank" rel="noreferrer"><img alt="by Coffey Labs" src="https://img.shields.io/badge/by-Coffey%20Labs-0f766e?style=flat-square"></a>
</p> </p>
@@ -33,6 +33,16 @@ durable belongs to Stalwart; the container is disposable.
| 🧪 **[KNOWN-ISSUES.md](KNOWN-ISSUES.md)** | What was verified live, and where Stalwart departs from a spec | | 🧪 **[KNOWN-ISSUES.md](KNOWN-ISSUES.md)** | What was verified live, and where Stalwart departs from a spec |
| 🛣 **[ROADMAP.md](ROADMAP.md)** | What ihasmail does not do, and why | | 🛣 **[ROADMAP.md](ROADMAP.md)** | What ihasmail does not do, and why |
### Companion tools
Two tools for getting a Stalwart server ready for ihasmail, one for each place
you might be starting from:
| | Starting from | What it does |
| --- | --- | --- |
| 🚀 **[ihasmail-oneshot](https://github.com/Coffey-Labs/ihasmail-oneshot)** | **Nothing** — a fresh Linux host with Docker | One command deploys a new Stalwart and a new ihasmail on a single host, already linked: certificates for both, the first mailboxes, and the DNS records to publish. Or `--local` for a loopback-only pair to try it |
| ⬆️ **[stalwart-migrator](https://github.com/Coffey-Labs/stalwart-migrator)** | **An existing Stalwart 0.15.5** server | Upgrades it in place to the 0.16 series ihasmail requires, checkpointing every phase so an interrupted run resumes, and validating the server afterwards. Take a snapshot first: it does not undo a migration |
> **Releases are weekly, so `latest` normally lags `main`.** Automation builds > **Releases are weekly, so `latest` normally lags `main`.** Automation builds
> and publishes the GHCR image every **Monday at 09:00 UTC**, in a week that had > and publishes the GHCR image every **Monday at 09:00 UTC**, in a week that had
> changes. Between one Monday and the next, `main` is ahead of the newest image > changes. Between one Monday and the next, `main` is ahead of the newest image
@@ -68,11 +78,12 @@ More, including the mobile layout, on [ihasmail.org](https://ihasmail.org/#scree
- **Contacts** — JMAP Contacts / JSContact: address books, groups, full editor, vCard import/export - **Contacts** — JMAP Contacts / JSContact: address books, groups, full editor, vCard import/export
- **Files** — JMAP FileNode: browse, upload, download, rename, move, delete - **Files** — JMAP FileNode: browse, upload, download, rename, move, delete
- **Signature checking** — S/MIME signed mail is verified as you read it, and the signer is remembered: a later message from the same address signed by somebody else is called out loudly. No certificate authority is involved and none is bundled, so ihasmail never claims more than it can show — see [Checking a signature](FEATURES.md#checking-a-signature) - **Signature checking** — S/MIME signed mail is verified as you read it, and the signer is remembered: a later message from the same address signed by somebody else is called out loudly. No certificate authority is involved and none is bundled, so ihasmail never claims more than it can show — see [Checking a signature](FEATURES.md#checking-a-signature)
- **Settings that follow the account**, not the browser — kept in a `settings.json` in the account's own JMAP Files, so ihasmail itself stays stateless - **Settings that follow the account**, not the browser — kept in a `settings.json` in the account's own JMAP Files. The format is ihasmail's; the file is the account's, under its quota, and outlives any container that read it. ihasmail holds none of it
- **Runs read-only** — one optional write path, and with it switched off the container needs no volume and no writable root. `IMMUTABLE=1` is checked at startup rather than trusted, so a half-applied switch refuses to boot instead of failing quietly. See [Running immutably](#running-immutably) - **Runs read-only** — one optional write path, and with it switched off the container needs no volume and no writable root. `IMMUTABLE=1` is checked at startup rather than trusted, so a half-applied switch refuses to boot instead of failing quietly. See [Running immutably](#running-immutably)
- **Nine new interface languages** — German, Spanish, French, Dutch, Portuguese (Brazil), Russian, Ukrainian, Simplified Chinese and Japanese, alongside English and separate from the date-and-time locale. Every one is marked **Beta**: they were made by AI and no native speaker has read them yet, which Settings says plainly, with a link for reporting anything wrong - **Nine new interface languages** — German, Spanish, French, Dutch, Portuguese (Brazil), Russian, Ukrainian, Simplified Chinese and Japanese, alongside English and separate from the date-and-time locale. Every one is marked **Beta**: they were made by AI and no native speaker has read them yet, which Settings says plainly, with a link for reporting anything wrong
- **Twelve themes** — Classic and ihasmail's own, plus Catppuccin, Dracula, Gruvbox, Rosé Pine, Tokyo Night, Solarized, Ayu, Kanagawa, Everforest and Primer, each with the light and dark half its own project publishes. Palette and light-or-dark are separate choices, and the accent colour still sits on top of any of them. Only published colour values are used, taken from each project's own repository; the shades between them are derived and every text colour is measured against the surface it sits on, so a palette that would not meet the contrast this app claims is not written at all — see [Themes](FEATURES.md#themes) - **Twelve themes** — Classic and ihasmail's own, plus Catppuccin, Dracula, Gruvbox, Rosé Pine, Tokyo Night, Solarized, Ayu, Kanagawa, Everforest and Primer, each with the light and dark half its own project publishes. Palette and light-or-dark are separate choices, and the accent colour still sits on top of any of them. Only published colour values are used, taken from each project's own repository; the shades between them are derived and every text colour is measured against the surface it sits on, so a palette that would not meet the contrast this app claims is not written at all — see [Themes](FEATURES.md#themes)
- **On a phone** — swipe a message to archive or delete it (either direction, your choice), hold one to select it, hold a folder for its menu, pull the list to refresh, swipe back from a conversation - **On a phone** — swipe a message to archive or delete it (either direction, your choice), hold one to select it, hold a folder for its menu, pull the list to refresh, swipe back from a conversation
- **Administration** — for an account whose Stalwart role manages accounts or domains, from the account menu: create, edit and delete accounts and set their passwords; add domains, copy their DNS records one at a time or as a zone file, see their DKIM keys, and remove them once nothing uses them. Each control is there only when the role allows it, and Stalwart decides every call. Only for a session signed in with *This is my own device* ticked, and `ADMINISTRATION=0` turns it off for everyone — see [Administration](FEATURES.md#administration)
- **Platform** — installable PWA, Web Push with ihasmail closed, `mailto:` handler, no credentials in the browser, strict CSP, SSRF-safe image proxy - **Platform** — installable PWA, Web Push with ihasmail closed, `mailto:` handler, no credentials in the browser, strict CSP, SSRF-safe image proxy
The long version is on [ihasmail.org](https://ihasmail.org/#features); how to The long version is on [ihasmail.org](https://ihasmail.org/#features); how to
@@ -87,22 +98,36 @@ wrong guess had somewhere to fall back to, so it failed *quietly* — and that
reached production. With one supported generation a wrong guess is a loud error reached production. With one supported generation a wrong guess is a loud error
on the first call. on the first call.
**Validated against 0.16.21**, released 6 September 2026: the app was run **Validated against 0.16.22**, released 13 September 2026: the live instance
against a real instance of it and the mail, calendar and contacts paths were runs it and the app has been tested against it. Four of its JMAP changes are
exercised by hand. Four of that release's JMAP changes are visible to a client visible to a client, all in calendars and contacts:
`CalendarEvent/get` returns `baseEventId` only for a synthetic id, so an event
read by its stored id now carries `null` there rather than its own id; it
returns `null` for `recurrenceRule` and `recurrenceOverrides` asked for on a
synthetic id; `useDefaultAlerts` is stored per user and reads `false` when never
set; and `CalendarEvent/get` and `ContactCard/get` return only `id` for an empty
`properties` list, rather than everything. The mock reproduces all four.
Before it, **0.16.21**, released 6 September 2026: the app was run against a
real instance of it and the mail, calendar and contacts paths were exercised by
hand. Four of that release's JMAP changes are visible to a client
— an occurrence of a recurring event is now identified by its recurrence id — an occurrence of a recurring event is now identified by its recurrence id
rather than by its position in the series, so an id held across a write no rather than by its position in the series, so an id held across a write no
longer silently names a different date; `Calendar/get` and `AddressBook/get` longer silently names a different date; `Calendar/get` and `AddressBook/get`
return every property when none are named; EventSource advertises its ping return every property when none are named; EventSource advertises its ping
interval in seconds rather than milliseconds; and a calendar write that asks interval in seconds rather than milliseconds; and a calendar write that asks
for scheduling messages is refused when the account may not send them. The mock for scheduling messages is refused when the account may not send them. The mock
reproduces all four. reproduces those four.
- Still on 0.15? The last release that runs on it is tagged [`stalwart-0.15-support`](https://github.com/Coffey-Labs/ihasmail/releases/tag/stalwart-0.15-support). - Still on 0.15? The last release that runs on it is tagged [`stalwart-0.15-support`](https://github.com/Coffey-Labs/ihasmail/releases/tag/stalwart-0.15-support).
- Upgrading? [stalwart-migrator](https://github.com/Coffey-Labs/stalwart-migrator) does it in place, checkpointing every phase and validating afterwards. The live instance moved 0.15.5 → 0.16.19 with eight seconds of downtime and nothing lost. - Upgrading? [stalwart-migrator](https://github.com/Coffey-Labs/stalwart-migrator) does it in place, checkpointing every phase and validating afterwards. The live instance moved 0.15.5 → 0.16.19 with eight seconds of downtime and nothing lost.
## Quick start (Docker) ## Quick start (Docker)
No Stalwart yet? [ihasmail-oneshot](https://github.com/Coffey-Labs/ihasmail-oneshot)
sets up both on one host in a single command. The steps below are for pointing
ihasmail at a Stalwart you already run.
```bash ```bash
cp .env.example .env cp .env.example .env
# edit: STALWART_URL=https://mail.example.com and APP_SECRET=$(openssl rand -base64 48) # edit: STALWART_URL=https://mail.example.com and APP_SECRET=$(openssl rand -base64 48)
@@ -347,7 +372,7 @@ missing.
## Development ## Development
Requirements: Node ≥ 20.10 (22 recommended), npm ≥ 10. Requirements: Node ≥ 20.19 (26 recommended), npm ≥ 10.
```bash ```bash
npm install npm install
@@ -374,11 +399,12 @@ without a real mailbox. It reproduces the things a naive fake would get wrong,
because each cost a live debugging session: `urn:stalwart:jmap` advertised because each cost a live debugging session: `urn:stalwart:jmap` advertised
**per-account** rather than session-level, identity signatures capped at 2047 **per-account** rather than session-level, identity signatures capped at 2047
**bytes**, and `CalendarEvent/set` speaking Stalwart's vocabulary rather than **bytes**, and `CalendarEvent/set` speaking Stalwart's vocabulary rather than
RFC 8984's. Three switches: `MOCK_NO_FUTURE_RELEASE=1` advertises FUTURERELEASE RFC 8984's. Four switches: `MOCK_NO_FUTURE_RELEASE=1` advertises FUTURERELEASE
and then drops every hold; `MOCK_NO_REGISTRY=1` omits the Stalwart capability so and then drops every hold; `MOCK_NO_REGISTRY=1` omits the Stalwart capability so
the sign-in refusal can be tested; and `MOCK_NO_SCHEDULING_SEND=1` refuses a the sign-in refusal can be tested; and `MOCK_NO_SCHEDULING_SEND=1` refuses a
calendar write that asks for scheduling messages, the way an account without calendar write that asks for scheduling messages, the way an account without
that permission is refused. that permission is refused; and `MOCK_ROLE` decides who the demo user is for
Administration — `admin` (the default), `tenant-admin`, `helpdesk` or `user`.
It tracks the current release rather than 0.16 in general, and each behaviour It tracks the current release rather than 0.16 in general, and each behaviour
is confirmed against a real server before it is copied here — the comments say is confirmed against a real server before it is copied here — the comments say
+1
View File
@@ -8,6 +8,7 @@ the rest is here because the answer is "no", not "not yet".
See [KNOWN-ISSUES.md](KNOWN-ISSUES.md) for what is built but worth knowing about. See [KNOWN-ISSUES.md](KNOWN-ISSUES.md) for what is built but worth knowing about.
- **Administration beyond accounts and domains.** The Administration menu manages accounts and domains today — see [FEATURES.md](FEATURES.md#administration). Groups, mailing lists, roles, DNS and ACME providers and tenants are Stalwart registry objects behind the same permission model, and each is a section to add rather than a design to invent; so is switching a domain's DNS, DKIM or certificate management, which is shown but not yet changed from ihasmail. Reporting, queues, logs and server settings are not planned: they are operating the server, which is Stalwart's own interface's job, not managing the people on it.
- **Sharing a mail folder.** Stalwart stores the share and never delivers it; see [KNOWN-ISSUES.md](KNOWN-ISSUES.md). Withdrawn until the server does something with it. Sharing files, calendars and address books is unaffected and works. - **Sharing a mail folder.** Stalwart stores the share and never delivers it; see [KNOWN-ISSUES.md](KNOWN-ISSUES.md). Withdrawn until the server does something with it. Sharing files, calendars and address books is unaffected and works.
- **A scheduling view of its own**, for asking "when is everyone free next week?" without an event in hand. The grid itself is built and lives in the event editor — a row per participant, steppable, and clickable to place the event — which is where the question gets asked while you are arranging something. What is not built is the same thing as a destination you can visit with nothing in progress. Came out of [#172](https://github.com/Coffey-Labs/ihasmail/issues/172), which asked for a separate view and is closed by the panel: the reasoning for putting it in the editor is that a separate surface can only ever tell you a time you then retype, whereas one beside the event can set it. It stays here rather than in the tracker because nobody has yet said they want to ask the question on its own. - **A scheduling view of its own**, for asking "when is everyone free next week?" without an event in hand. The grid itself is built and lives in the event editor — a row per participant, steppable, and clickable to place the event — which is where the question gets asked while you are arranging something. What is not built is the same thing as a destination you can visit with nothing in progress. Came out of [#172](https://github.com/Coffey-Labs/ihasmail/issues/172), which asked for a separate view and is closed by the panel: the reasoning for putting it in the editor is that a separate surface can only ever tell you a time you then retype, whereas one beside the event can set it. It stays here rather than in the tracker because nobody has yet said they want to ask the question on its own.
- **Per-message actions from the message list on a touchscreen.** Reply, Forward and compose-as-new are on the list row's context menu, which is a right-click — and holding a row on a phone starts selection instead, so none of them are reachable there. They are all available inside a thread, which is where the actions on a single message belong; what is missing is the shortcut from the list. Fixing it means deciding what a long press should do when it already means something, which is a bigger question than the actions themselves. - **Per-message actions from the message list on a touchscreen.** Reply, Forward and compose-as-new are on the list row's context menu, which is a right-click — and holding a row on a phone starts selection instead, so none of them are reachable there. They are all available inside a thread, which is where the actions on a single message belong; what is missing is the shortcut from the list. Fixing it means deciding what a long press should do when it already means something, which is a bigger question than the actions themselves.
+17 -1
View File
@@ -214,7 +214,23 @@ prune_old_images() {
printf '%s\n' "$stale" | xargs -r docker rmi >/dev/null 2>&1 || true printf '%s\n' "$stale" | xargs -r docker rmi >/dev/null 2>&1 || true
} }
VERSION="$(node scripts/version.mjs)" # The version is the same sum scripts/version.mjs does -- the commit's own
# date, plus the pull request it arrived through or its short SHA -- done here
# in shell because a host that only runs containers has git and docker and no
# node. Given IHASMAIL_VERSION, use it as given, as the script would.
version_from_git() {
local date subject sha y m d
date="$(git show -s --format=%cs HEAD)"
subject="$(git show -s --format=%s HEAD)"
sha="$(git rev-parse --short HEAD)"
IFS=- read -r y m d <<<"$date"
if [[ "$subject" =~ ^Merge\ pull\ request\ \#([0-9]+) ]]; then
printf '%d.%d.%d+pr%s\n' "$((10#$y))" "$((10#$m))" "$((10#$d))" "${BASH_REMATCH[1]}"
else
printf '%d.%d.%d+g%s\n' "$((10#$y))" "$((10#$m))" "$((10#$d))" "$sha"
fi
}
VERSION="${IHASMAIL_VERSION:-$(version_from_git)}"
# A Docker tag may not contain "+", and every version has one now: # A Docker tag may not contain "+", and every version has one now:
# 2026.8.30+pr129, or +g1fa6578 for a commit that did not come through a pull # 2026.8.30+pr129, or +g1fa6578 for a commit that did not come through a pull
# request. The image is tagged with the "+" turned into "-"; what the build is # request. The image is tagged with the "+" turned into "-"; what the build is
+1109 -1712
View File
File diff suppressed because it is too large Load Diff
+3 -2
View File
@@ -10,7 +10,7 @@
"web" "web"
], ],
"engines": { "engines": {
"node": ">=20.10" "node": ">=20.19"
}, },
"scripts": { "scripts": {
"dev": "concurrently -n server,web -c blue,magenta \"npm run dev -w server\" \"npm run dev -w web\"", "dev": "concurrently -n server,web -c blue,magenta \"npm run dev -w server\" \"npm run dev -w web\"",
@@ -28,6 +28,7 @@
}, },
"devDependencies": { "devDependencies": {
"concurrently": "^9.1.2", "concurrently": "^9.1.2",
"typescript": "^5.7.3" "typescript": "^7.0.2",
"typescript-ast": "npm:typescript@^5.9.3"
} }
} }
+56 -10
View File
@@ -12,20 +12,66 @@
* in the file looking correct, is never looked up, and the app renders English * in the file looking correct, is never looked up, and the app renders English
* for ever. Nothing warns, because a catalogue is only ever read by key. * for ever. Nothing warns, because a catalogue is only ever read by key.
*/ */
import ts from "typescript"; /*
* The parser, not the compiler.
*
* TypeScript 7 is the native port: its package ships a `tsc` shim over a Go
* binary and nothing else, so `typescript` now exports `version` and
* `versionMajorMinor` and no compiler API at all. Every `ts.createSourceFile`
* in this directory started throwing "Cannot read properties of undefined
* (reading 'Latest')" the day the bump landed, and nothing noticed, because no
* workflow runs these.
*
* `typescript-ast` is an npm alias for the last TypeScript that carries the JS
* API (see package.json). It parses; `typescript` still type-checks and builds.
* Two entries, two jobs -- not a version someone forgot to remove.
*/
import ts from "typescript-ast";
import { readFileSync, globSync } from "node:fs"; import { readFileSync, globSync } from "node:fs";
/*
* Two sets, because there are two questions and they need different nets.
*
* `wanted` is what a catalogue *owes*: the strings that actually reach t(),
* tc() or plural(). Coverage is measured against it, so it has to stay strict
* -- widening it would count every CSS class and JMAP method name as an
* untranslated string.
*
* `seen` is every string literal in the source, and answers only "is this
* catalogue key still written down anywhere". Stale detection needs the wide
* net: a key reaches t() as a variable often enough that a strict set reports
* mostly false alarms.
*/
const wanted = new Set(); const wanted = new Set();
const seen = new Set();
for (const file of globSync("web/src/**/*.{ts,tsx}").filter((f) => !f.includes("__tests__") && !f.includes("/locales/"))) { for (const file of globSync("web/src/**/*.{ts,tsx}").filter((f) => !f.includes("__tests__") && !f.includes("/locales/"))) {
const src = ts.createSourceFile(file, readFileSync(file, "utf8"), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX); const src = ts.createSourceFile(file, readFileSync(file, "utf8"), ts.ScriptTarget.Latest, true, ts.ScriptKind.TSX);
const visit = (n) => { const visit = (n) => {
/* /*
* Labels held in a constant and translated where they render -- t(s.label) * Anything held in a constant and translated where it renders -- t(s.label),
* -- reach t() as a variable, so there is no literal for this to find and * t(b.description), t(group) -- reaches t() as a variable, so there is no
* every one of them looked "stale". They are collected from the constants * literal at the call site and every one of them looked "stale".
* instead: a `label:` property, or a value in an object of them. Without *
* this the stale check cried wolf 33 times and would have been switched * This used to chase the shapes one at a time: a `label:` property, then an
* off, which is the only outcome worse than not having it. * object named *_LABELS. It still cried wolf, because the shapes kept
* coming -- `description:` and `group:` on keyboard bindings, the calendar's
* view names, the read-receipt refusals, the palette names. 41 reported,
* 10 of them real. A report that is three-quarters false is one nobody acts
* on, which is how these sat unread long enough to be worth a commit of
* their own.
*
* So: any string literal anywhere in the source counts as a use. That
* under-reports -- a literal that exists but is never passed to t() will not
* be flagged -- and that is the right way round. A missed stale key costs a
* line of dead translation; a false one costs the credibility of the whole
* check, and then every real finding with it.
*/
if (ts.isStringLiteral(n) || ts.isNoSubstitutionTemplateLiteral(n)) seen.add(n.text);
if (ts.isJsxText(n)) { const text = n.text.trim(); if (text) seen.add(text); }
/*
* A `label:` in a constant is still a string somebody has to translate --
* it reaches t() one render later -- so it stays part of what a catalogue
* owes, and out of coverage it would flatter the number.
*/ */
if (ts.isPropertyAssignment(n) && n.name.getText(src) === "label" && ts.isStringLiteral(n.initializer)) wanted.add(n.initializer.text); if (ts.isPropertyAssignment(n) && n.name.getText(src) === "label" && ts.isStringLiteral(n.initializer)) wanted.add(n.initializer.text);
if (ts.isVariableDeclaration(n) && ts.isIdentifier(n.name) && /_LABELS?$/.test(n.name.text)) { if (ts.isVariableDeclaration(n) && ts.isIdentifier(n.name) && /_LABELS?$/.test(n.name.text)) {
@@ -44,6 +90,7 @@ for (const file of globSync("web/src/**/*.{ts,tsx}").filter((f) => !f.includes("
// fallback, not a second obligation -- asking for both would report // fallback, not a second obligation -- asking for both would report
// work that does not exist. // work that does not exist.
wanted.add(`${a0.text}\u0004${n.arguments[1].text}`); wanted.add(`${a0.text}\u0004${n.arguments[1].text}`);
seen.add(`${a0.text}\u0004${n.arguments[1].text}`);
} }
if (fn === "plural" && n.arguments[1] && ts.isObjectLiteralExpression(n.arguments[1])) { if (fn === "plural" && n.arguments[1] && ts.isObjectLiteralExpression(n.arguments[1])) {
for (const p of n.arguments[1].properties) { for (const p of n.arguments[1].properties) {
@@ -91,15 +138,14 @@ for (const file of globSync("web/src/locales/*.ts")) {
ts.forEachChild(n, visit); ts.forEachChild(n, visit);
}; };
visit(src); visit(src);
const stale = [...have].filter((k) => !wanted.has(k) && !["one", "other", "few", "many", "zero", "two"].includes(k)); const stale = [...have].filter((k) => !seen.has(k) && !["one", "other", "few", "many", "zero", "two"].includes(k));
const missing = [...wanted].filter((k) => !have.has(k)); const missing = [...wanted].filter((k) => !have.has(k));
const pct = Math.round(((wanted.size - missing.length) / wanted.size) * 100); const pct = Math.round(((wanted.size - missing.length) / wanted.size) * 100);
console.log(`${tag}: ${wanted.size - missing.length}/${wanted.size} translated (${pct}%), ${missing.length} falling back to English`); console.log(`${tag}: ${wanted.size - missing.length}/${wanted.size} translated (${pct}%), ${missing.length} falling back to English`);
if (stale.length) { if (stale.length) {
failed = true; failed = true;
console.log(`\n ${stale.length} STALE key(s) — translated but never looked up, so they do nothing:`); console.log(`\n ${stale.length} STALE key(s) — translated but never looked up, so they do nothing:`);
for (const k of stale.slice(0, 25)) console.log(` ${JSON.stringify(k)}`); for (const k of stale) console.log(` ${JSON.stringify(k)}`);
if (stale.length > 25) console.log(` …and ${stale.length - 25} more`);
} }
if (process.argv.includes("--missing")) { if (process.argv.includes("--missing")) {
console.log(`\n missing:`); console.log(`\n missing:`);
+15 -1
View File
@@ -11,7 +11,21 @@
* exits non-zero only with --check, so CI can be told to fail on regressions * exits non-zero only with --check, so CI can be told to fail on regressions
* later, once the number is low enough for that to mean something. * later, once the number is low enough for that to mean something.
*/ */
import ts from "typescript"; /*
* The parser, not the compiler.
*
* TypeScript 7 is the native port: its package ships a `tsc` shim over a Go
* binary and nothing else, so `typescript` now exports `version` and
* `versionMajorMinor` and no compiler API at all. Every `ts.createSourceFile`
* in this directory started throwing "Cannot read properties of undefined
* (reading 'Latest')" the day the bump landed, and nothing noticed, because no
* workflow runs these.
*
* `typescript-ast` is an npm alias for the last TypeScript that carries the JS
* API (see package.json). It parses; `typescript` still type-checks and builds.
* Two entries, two jobs -- not a version someone forgot to remove.
*/
import ts from "typescript-ast";
import { readFileSync, globSync } from "node:fs"; import { readFileSync, globSync } from "node:fs";
/** Attributes a person reads. `className` and `key` are not among them. */ /** Attributes a person reads. `className` and `key` are not among them. */
+15 -1
View File
@@ -12,7 +12,21 @@
* node scripts/i18n-extract.mjs <file...> rewrite in place * node scripts/i18n-extract.mjs <file...> rewrite in place
* node scripts/i18n-extract.mjs --dry <file...> * node scripts/i18n-extract.mjs --dry <file...>
*/ */
import ts from "typescript"; /*
* The parser, not the compiler.
*
* TypeScript 7 is the native port: its package ships a `tsc` shim over a Go
* binary and nothing else, so `typescript` now exports `version` and
* `versionMajorMinor` and no compiler API at all. Every `ts.createSourceFile`
* in this directory started throwing "Cannot read properties of undefined
* (reading 'Latest')" the day the bump landed, and nothing noticed, because no
* workflow runs these.
*
* `typescript-ast` is an npm alias for the last TypeScript that carries the JS
* API (see package.json). It parses; `typescript` still type-checks and builds.
* Two entries, two jobs -- not a version someone forgot to remove.
*/
import ts from "typescript-ast";
import { readFileSync, writeFileSync } from "node:fs"; import { readFileSync, writeFileSync } from "node:fs";
const ATTRS = new Set(["title", "aria-label", "placeholder", "alt", "label", "hint", "confirmLabel", "description"]); const ATTRS = new Set(["title", "aria-label", "placeholder", "alt", "label", "hint", "confirmLabel", "description"]);
+15 -1
View File
@@ -18,7 +18,21 @@
* string that is neither -- one no catalogue has a key for, which therefore * string that is neither -- one no catalogue has a key for, which therefore
* cannot be translated at all, however many languages ship. * cannot be translated at all, however many languages ship.
*/ */
import ts from "typescript"; /*
* The parser, not the compiler.
*
* TypeScript 7 is the native port: its package ships a `tsc` shim over a Go
* binary and nothing else, so `typescript` now exports `version` and
* `versionMajorMinor` and no compiler API at all. Every `ts.createSourceFile`
* in this directory started throwing "Cannot read properties of undefined
* (reading 'Latest')" the day the bump landed, and nothing noticed, because no
* workflow runs these.
*
* `typescript-ast` is an npm alias for the last TypeScript that carries the JS
* API (see package.json). It parses; `typescript` still type-checks and builds.
* Two entries, two jobs -- not a version someone forgot to remove.
*/
import ts from "typescript-ast";
import { readFileSync, globSync } from "node:fs"; import { readFileSync, globSync } from "node:fs";
/* Where a string literal in this position is shown to somebody. */ /* Where a string literal in this position is shown to somebody. */
+15 -1
View File
@@ -9,7 +9,21 @@
* exists is dead weight, but a call with no key is an untranslated string * exists is dead weight, but a call with no key is an untranslated string
* nobody noticed. * nobody noticed.
*/ */
import ts from "typescript"; /*
* The parser, not the compiler.
*
* TypeScript 7 is the native port: its package ships a `tsc` shim over a Go
* binary and nothing else, so `typescript` now exports `version` and
* `versionMajorMinor` and no compiler API at all. Every `ts.createSourceFile`
* in this directory started throwing "Cannot read properties of undefined
* (reading 'Latest')" the day the bump landed, and nothing noticed, because no
* workflow runs these.
*
* `typescript-ast` is an npm alias for the last TypeScript that carries the JS
* API (see package.json). It parses; `typescript` still type-checks and builds.
* Two entries, two jobs -- not a version someone forgot to remove.
*/
import ts from "typescript-ast";
import { readFileSync, globSync } from "node:fs"; import { readFileSync, globSync } from "node:fs";
const strings = new Set(); const strings = new Set();
+5 -5
View File
@@ -16,12 +16,12 @@
"mock:no-keyword-sort": "MOCK_NO_KEYWORD_SORT=1 tsx src/mock/index.ts" "mock:no-keyword-sort": "MOCK_NO_KEYWORD_SORT=1 tsx src/mock/index.ts"
}, },
"dependencies": { "dependencies": {
"@hono/node-server": "^1.13.8", "@hono/node-server": "^2.1.1",
"hono": "^4.7.4" "hono": "^4.13.7"
}, },
"devDependencies": { "devDependencies": {
"@types/node": "^22.13.10", "@types/node": "^26.5.1",
"tsx": "^4.19.3", "tsx": "^4.23.13",
"typescript": "^5.7.3" "typescript": "^7.0.2"
} }
} }
+32 -3
View File
@@ -33,8 +33,8 @@ test("an account with no locale set yields none, rather than a guess", () => {
}); });
test("neither answering leaves the locale unknown", () => { test("neither answering leaves the locale unknown", () => {
assert.deepEqual(interpretAccountInfo([failed("s", "forbidden"), failed("a", "forbidden")]), { locale: null, edition: null }); assert.deepEqual(interpretAccountInfo([failed("s", "forbidden"), failed("a", "forbidden")]), { locale: null, edition: null, permissions: [] });
assert.deepEqual(interpretAccountInfo([]), { locale: null, edition: null }); assert.deepEqual(interpretAccountInfo([]), { locale: null, edition: null, permissions: [] });
}); });
test("locales that carry no language are dropped, not passed through", () => { test("locales that carry no language are dropped, not passed through", () => {
@@ -48,7 +48,7 @@ test("a server without the registry is not asked for anything", async () => {
// fails the whole request rather than the one call. // fails the whole request rather than the one call.
const session = { capabilities: { "urn:ietf:params:jmap:core": {}, "urn:ietf:params:jmap:mail": {} }, accounts: {}, primaryAccounts: {} }; const session = { capabilities: { "urn:ietf:params:jmap:core": {}, "urn:ietf:params:jmap:mail": {} }, accounts: {}, primaryAccounts: {} };
const info = await getAccountInfo("session-unsupported", "Basic x", session as never); const info = await getAccountInfo("session-unsupported", "Basic x", session as never);
assert.deepEqual(info, { locale: null, edition: null }); assert.deepEqual(info, { locale: null, edition: null, permissions: [] });
}); });
test("no capabilities at all is treated the same way", async () => { test("no capabilities at all is treated the same way", async () => {
@@ -110,3 +110,32 @@ test("a shared account carrying the capability is enough to recognise the server
true, true,
); );
}); });
/**
* With a domain mapped to its own Stalwart (#238), everything asked about the
* account has to go to that server. The locale lookup resolved Stalwart's
* `apiUrl` against the default server instead, so a mapped account's locale
* was requested from a server that had never heard of it.
*/
test("account info is asked of the server that issued the session", async () => {
const seen: string[] = [];
const realFetch = globalThis.fetch;
globalThis.fetch = (async (input: string | URL | Request) => {
seen.push(String(input instanceof Request ? input.url : input));
return new Response(JSON.stringify({ methodResponses: [], edition: "oss" }), { status: 200, headers: { "content-type": "application/json" } });
}) as typeof fetch;
try {
const session = {
capabilities: baseCaps,
accounts: { a1: { accountCapabilities: { [STALWART]: {} } } },
primaryAccounts: { [STALWART]: "a1" },
apiUrl: "https://mail.mapped.test/jmap/",
baseUrl: "https://mail.mapped.test",
};
await getAccountInfo("session-mapped-domain", "Basic x", session as never);
} finally {
globalThis.fetch = realFetch;
}
assert.ok(seen.length >= 2, "asks for both the locale and the edition");
for (const url of seen) assert.ok(url.startsWith("https://mail.mapped.test/"), `${url} went to the wrong server`);
});
+71
View File
@@ -0,0 +1,71 @@
import { test } from "node:test";
import assert from "node:assert/strict";
import { administrationAllowed, gateAdministration, grantsAdministration, mayNameRegistryMethod } from "./adminGate.js";
const req = (...methods: string[]) => JSON.stringify({ using: ["urn:ietf:params:jmap:core"], methodCalls: methods.map((m, i) => [m, {}, `c${i}`]) });
/**
* With ADMINISTRATION=0 an administrator's browser must not be a way round the
* operator's decision. Hiding the menu would leave the proxy forwarding the
* very calls the menu made.
*/
test("mail, calendars and the rest pass untouched", () => {
const r = gateAdministration(req("Email/query", "Mailbox/get", "CalendarEvent/set", "FileNode/get", "Principal/getAvailability"));
assert.equal(r.ok, true);
});
test("the account's own registry objects pass", () => {
assert.equal(gateAdministration(req("x:AccountSettings/get", "x:AppPassword/set", "x:PublicKey/get", "x:MaskedEmail/set")).ok, true);
});
test("directory and server objects are refused, and named", () => {
for (const m of ["x:Account/get", "x:Domain/set", "x:Role/query", "x:Tenant/get", "x:SystemSettings/set", "x:DkimSignature/get"]) {
assert.deepEqual(gateAdministration(req("Email/get", m)), { ok: false, method: m });
}
});
test("a body that could name a registry method and cannot be read is refused rather than forwarded", () => {
assert.deepEqual(gateAdministration('{"methodCalls": [["x:Account/get"'), { ok: false, method: null });
assert.deepEqual(gateAdministration(JSON.stringify({ methodCalls: "x:Account/get" })), { ok: false, method: null });
assert.deepEqual(gateAdministration(JSON.stringify({ methodCalls: [[{}, {}, "c"]], note: "x:" })), { ok: false, method: null });
});
test("a body that cannot name a registry method is forwarded exactly as it came", () => {
// Most traffic from a session that may not administer: no parse, no rewrite.
const raw = '{"using":["urn:ietf:params:jmap:core"],"methodCalls":[["Email/get",{"ids":["a"]},"c"]]}';
assert.equal(mayNameRegistryMethod(raw), false);
assert.deepEqual(gateAdministration(raw), { ok: true, body: raw });
});
test("a method name hidden behind a unicode escape is still found", () => {
// JSON.parse and the server both read \u0078 as "x"; a substring check alone would not.
const raw = '{"methodCalls":[["\\u0078:Account/get",{},"c"]]}';
assert.equal(mayNameRegistryMethod(raw), true);
assert.deepEqual(gateAdministration(raw), { ok: false, method: "x:Account/get" });
});
/**
* The operator's rule: administration only from a session signed in with
* "This is my own device" ticked, and never when the installation turned it off.
*/
test("administration needs both the installation and a device marked as the person's own", () => {
assert.equal(administrationAllowed(true, true), true);
assert.equal(administrationAllowed(true, false), false);
assert.equal(administrationAllowed(false, true), false);
});
test("an account counts as an administrator by the same test the menu makes", () => {
assert.equal(grantsAdministration(["sysAccountQuery", "sysAccountGet"]), true);
assert.equal(grantsAdministration(["sysDomainQuery", "sysDomainGet"]), true);
assert.equal(grantsAdministration(["sysAccountQuery", "sysDomainGet"]), false);
assert.equal(grantsAdministration(["jmapEmailGet", "sysAccountSettingsGet"]), false);
});
test("what is forwarded is what was checked", () => {
// A duplicate key is read one way by JSON.parse; forwarding the parsed form
// means the server cannot read it the other way.
const raw = '{"methodCalls":[["x:Account/get",{},"a"]],"methodCalls":[["Email/get",{},"b"]]}';
const r = gateAdministration(raw);
assert.equal(r.ok, true);
if (r.ok) assert.equal(r.body, JSON.stringify({ methodCalls: [["Email/get", {}, "b"]] }));
});
+85
View File
@@ -0,0 +1,85 @@
/**
* What the JMAP proxy lets through for a session that may not administer:
* the operator turned it off (`ADMINISTRATION=0`), or the session was signed
* in without "This is my own device".
*
* Hiding the menu is not turning it off. `/api/jmap` forwards any method the
* browser sends, and Stalwart's registry answers whatever the credential's role
* allows -- so without this, an administrator could still manage accounts, or
* the whole server, from the browser console of an installation whose operator
* said no. With it off, the proxy refuses every `x:` method except the few that
* are about the signed-in account itself.
*
* An allowlist rather than a list of administrative objects, because the
* registry has dozens of them -- listeners, stores, tracers, system settings --
* and a new release adds more. An object not named here is refused, which errs
* towards the operator's decision.
*
* The standard JMAP methods (mail, calendars, contacts, files, sharing) are not
* touched: they act on what the account can already reach.
*/
const SELF_SERVICE = new Set(["AccountSettings", "AccountPassword", "AppPassword", "ApiKey", "PublicKey", "MaskedEmail"]);
export type GateResult = { ok: true; body: string } | { ok: false; method: string | null };
/**
* Whether a session may administer at all: the installation allows it, and
* the person signing in said the device is their own.
*
* The second half is the operator's rule, not Stalwart's. A borrowed laptop or
* a library machine is exactly where a session should not be able to reset a
* password or remove a domain, and "This is my own device" is the one thing
* the sign-in form already asks that says where it is being used. An untrusted
* session is also signed out when idle and wipes its local data, so nothing
* about it suits an administrator's work.
*/
export function administrationAllowed(enabled: boolean, remember: boolean): boolean {
return enabled && remember;
}
/**
* Whether an account's permissions would put Administration in its menu --
* the same test the client makes, so the server can say why it is missing
* without handing over the permissions themselves.
*/
export function grantsAdministration(permissions: readonly string[]): boolean {
const has = new Set(permissions);
return (has.has("sysAccountQuery") && has.has("sysAccountGet")) || (has.has("sysDomainQuery") && has.has("sysDomainGet"));
}
/**
* Whether a body could hold a registry method name at all, so the common case
* -- mail, calendars, contacts from a session that may not administer -- skips
* the parse. A method name is a JSON string starting `x:`, which appears in the
* text as `"x:` unless written with a `\u` escape; a body with neither cannot
* contain one, and is forwarded exactly as it came.
*/
export function mayNameRegistryMethod(raw: string): boolean {
return raw.includes('"x:') || raw.includes("\\u");
}
/**
* Check a JMAP request body. On success, hands back the body to forward --
* serialised from what was inspected, so the server can never be sent
* something different from what was checked (a duplicate key, say, read one
* way here and another way there).
*/
export function gateAdministration(raw: string): GateResult {
if (!mayNameRegistryMethod(raw)) return { ok: true, body: raw };
let parsed: unknown;
try {
parsed = JSON.parse(raw);
} catch {
return { ok: false, method: null };
}
const calls = (parsed as { methodCalls?: unknown } | null)?.methodCalls;
if (!Array.isArray(calls)) return { ok: false, method: null };
for (const call of calls) {
const name = Array.isArray(call) ? call[0] : undefined;
if (typeof name !== "string") return { ok: false, method: null };
if (!name.startsWith("x:")) continue;
const object = name.slice(2).split("/")[0] ?? "";
if (!SELF_SERVICE.has(object)) return { ok: false, method: name };
}
return { ok: true, body: JSON.stringify(parsed) };
}
+56 -3
View File
@@ -8,6 +8,7 @@ import { RESPONSE_ALREADY_SENT } from "@hono/node-server/utils/response";
import { attach as pushAttach, attachRelay as pushAttachRelay, prepare as pushPrepare, receive as pushReceive, pushStatus } from "./push.js"; import { attach as pushAttach, attachRelay as pushAttachRelay, prepare as pushPrepare, receive as pushReceive, pushStatus } from "./push.js";
import { getConnInfo } from "@hono/node-server/conninfo"; import { getConnInfo } from "@hono/node-server/conninfo";
import { config } from "./config.js"; import { config } from "./config.js";
import { administrationAllowed, gateAdministration, grantsAdministration } from "./adminGate.js";
import { SessionStore, type SessionBackend, type LiveSession } from "./sessions.js"; import { SessionStore, type SessionBackend, type LiveSession } from "./sessions.js";
import { RateLimiter } from "./ratelimit.js"; import { RateLimiter } from "./ratelimit.js";
import { resolveClientIp } from "./clientip.js"; import { resolveClientIp } from "./clientip.js";
@@ -459,7 +460,11 @@ export function createApp(basePath = config.basePath): Hono<Env> {
*/ */
const accountCtx = async (c: Context<Env>) => { const accountCtx = async (c: Context<Env>) => {
const session = c.get("session"); const session = c.get("session");
const upstream = await getUpstreamSession(session.id, session.authorization); // The account's own server. Without it, the first fetch after the cached
// session expires goes to STALWART_URL -- which, for a domain mapped
// elsewhere, either refuses the password or knows a different account by
// the same name (#238).
const upstream = await getUpstreamSession(session.id, session.authorization, upstreamFor(session.username));
return { authorization: session.authorization, session: upstream, username: session.username }; return { authorization: session.authorization, session: upstream, username: session.username };
}; };
@@ -633,6 +638,30 @@ export function createApp(basePath = config.basePath): Hono<Env> {
if (!ct.toLowerCase().startsWith("application/json")) { if (!ct.toLowerCase().startsWith("application/json")) {
return c.json({ error: "unsupported_media_type" }, 415); return c.json({ error: "unsupported_media_type" }, 415);
} }
/*
* For a session that may not administer -- administration switched off, or
* a device not marked as the person's own -- the body is read and checked
* before it goes anywhere. A session that may streams straight through as
* it always has, and pays nothing for this.
*/
let body: ReadableStream<Uint8Array> | string | null = c.req.raw.body;
if (!administrationAllowed(config.administration, session.remember)) {
let raw: string;
try {
// Counted as it arrives: a chunked body carries no length to refuse up front.
raw = c.req.raw.body ? await new Response(c.req.raw.body.pipeThrough(byteCap(MAX_GATED_REQUEST))).text() : "";
} catch {
return c.json({ error: "too_large" }, 413);
}
const gate = gateAdministration(raw);
if (!gate.ok) {
if (!gate.method) return c.json({ error: "bad_request", message: "Not a JMAP request." }, 400);
return config.administration
? c.json({ error: "administration_needs_own_device", message: `Administration is only available when signed in on a device marked as your own (${gate.method}).` }, 403)
: c.json({ error: "administration_disabled", message: `Administration is turned off on this installation (${gate.method}).` }, 403);
}
body = gate.body;
}
try { try {
const upstream = await getUpstreamSession(session.id, session.authorization, upstreamFor(session.username)); const upstream = await getUpstreamSession(session.id, session.authorization, upstreamFor(session.username));
const res = await fetch(absoluteUpstream(upstream.apiUrl, upstream.baseUrl), { const res = await fetch(absoluteUpstream(upstream.apiUrl, upstream.baseUrl), {
@@ -642,7 +671,7 @@ export function createApp(basePath = config.basePath): Hono<Env> {
"content-type": "application/json", "content-type": "application/json",
accept: "application/json", accept: "application/json",
}, },
body: c.req.raw.body, body,
duplex: "half", duplex: "half",
signal: AbortSignal.timeout(config.upstreamTimeout), signal: AbortSignal.timeout(config.upstreamTimeout),
}); });
@@ -824,7 +853,7 @@ function appPasswordName(c: Context): string {
return `${config.appName} (${browser})`; return `${config.appName} (${browser})`;
} }
function sessionExtras(session: LiveSession, info: AccountInfo = { locale: null, edition: null }) { function sessionExtras(session: LiveSession, info: AccountInfo = { locale: null, edition: null, permissions: [] }) {
return { return {
ihasmail: { ihasmail: {
appName: config.appName, appName: config.appName,
@@ -838,6 +867,24 @@ function sessionExtras(session: LiveSession, info: AccountInfo = { locale: null,
userLocale: info.locale, userLocale: info.locale,
/** What the upstream server would tell us about itself. */ /** What the upstream server would tell us about itself. */
server: { edition: info.edition }, server: { edition: info.edition },
/**
* Whether this session may administer: the installation offers it
* (ADMINISTRATION) and the person signed in on a device marked as their own.
*/
administration: administrationAllowed(config.administration, session.remember),
/**
* An administrator signed in on a device not marked as their own, so the
* menu can say why Administration is unavailable rather than lose it
* without a word. Says only that the account administers, never what it
* may do.
*/
administrationNeedsOwnDevice: config.administration && !session.remember && grantsAdministration(info.permissions),
/**
* The account's permissions on that server, so the client can offer
* administration to those who have it. Stalwart still decides every call.
* Withheld from a session that may not administer: nothing in it needs them.
*/
permissions: administrationAllowed(config.administration, session.remember) ? info.permissions : [],
}, },
}; };
} }
@@ -847,6 +894,12 @@ function sessionExtras(session: LiveSession, info: AccountInfo = { locale: null,
* denylist: everything else it might set — cookies, auth challenges, CORS * denylist: everything else it might set — cookies, auth challenges, CORS
* grants — would be landing on *our* origin, where it means something else. * grants — would be landing on *our* origin, where it means something else.
*/ */
/**
* The largest JMAP request read into memory for the administration check.
* Stalwart's own default `maxSizeRequest` is 10 MB; uploads never come this way.
*/
const MAX_GATED_REQUEST = 16 * 1024 * 1024;
const PASSTHROUGH_HEADERS = new Set(["content-type", "content-disposition", "content-language", "etag", "last-modified", "retry-after"]); const PASSTHROUGH_HEADERS = new Set(["content-type", "content-disposition", "content-language", "etag", "last-modified", "retry-after"]);
/** /**
+7
View File
@@ -295,6 +295,13 @@ export const config = {
upstreamTimeout: int("UPSTREAM_TIMEOUT", 30_000), upstreamTimeout: int("UPSTREAM_TIMEOUT", 30_000),
maxUploadBytes: int("MAX_UPLOAD_BYTES", 50 * 1024 * 1024), maxUploadBytes: int("MAX_UPLOAD_BYTES", 50 * 1024 * 1024),
imageProxy: bool("IMAGE_PROXY", true), imageProxy: bool("IMAGE_PROXY", true),
/*
* Whether ihasmail offers administration to accounts whose Stalwart role
* allows it. Off means off: no menu, no permissions sent to the browser, and
* the JMAP proxy refuses registry methods beyond the account's own -- see
* adminGate.ts. Stalwart's own interface is unaffected either way.
*/
administration: bool("ADMINISTRATION", true),
cookieName: env("COOKIE_NAME", "ihm_session"), cookieName: env("COOKIE_NAME", "ihm_session"),
staticDir: process.env.STATIC_DIR ?? fileURLToPath(new URL("../../web/dist", import.meta.url)), staticDir: process.env.STATIC_DIR ?? fileURLToPath(new URL("../../web/dist", import.meta.url)),
loginRateLimit: int("LOGIN_RATE_LIMIT", 10), loginRateLimit: int("LOGIN_RATE_LIMIT", 10),
+111
View File
@@ -0,0 +1,111 @@
import { test } from "node:test";
import assert from "node:assert/strict";
import { createDirectory, permissionsFor, type MockRole } from "./directory.js";
class Refused extends Error {
constructor(readonly type: string, description?: string) { super(description ?? type); }
}
const make = (role: MockRole) => createDirectory({ accountId: "a1", user: "[email protected]", locale: "en_US", role, fail: (t, d) => new Refused(t, d) });
/**
* The mock stands in for a server that decides what each account may do, so
* the client's administration can be developed against refusals as well as
* successes. These pin the refusals.
*/
test("an ordinary user is refused the directory outright", () => {
const dir = make("user");
assert.throws(() => dir.handlers["x:Account/query"]!({}), (e: Refused) => e.type === "forbidden");
assert.ok(!permissionsFor("user").some((p) => p.startsWith("sysAccountQuery")));
});
test("helpdesk may read and edit but not create or delete", () => {
const dir = make("helpdesk");
const { ids } = dir.handlers["x:Account/query"]!({ filter: { "@type": "User" } }) as { ids: string[] };
assert.ok(ids.length > 20);
assert.throws(() => dir.handlers["x:Account/set"]!({ create: { n: { name: "x", domainId: "d1" } } }), (e: Refused) => e.type === "forbidden");
assert.throws(() => dir.handlers["x:Account/set"]!({ destroy: [ids[0]] }), (e: Refused) => e.type === "forbidden");
});
test("queries page, count and match text the way the client asks", () => {
const dir = make("admin");
const all = dir.handlers["x:Account/query"]!({ filter: { "@type": "User" }, calculateTotal: true }) as { ids: string[]; total: number };
const page = dir.handlers["x:Account/query"]!({ filter: { "@type": "User" }, position: 10, limit: 5, calculateTotal: true }) as { ids: string[]; total: number };
assert.equal(page.total, all.total);
assert.deepEqual(page.ids, all.ids.slice(10, 15));
const ada = dir.handlers["x:Account/query"]!({ filter: { "@type": "User", text: "lovelace" } }) as { ids: string[] };
assert.equal(ada.ids.length, 1);
assert.throws(() => dir.handlers["x:Account/query"]!({ filter: { operator: "OR", conditions: [] } }), (e: Refused) => e.type === "unsupportedFilter");
});
test("an address already used as an alias cannot be taken", () => {
const dir = make("admin");
const res = dir.handlers["x:Account/set"]!({ create: { n: { "@type": "User", name: "postmaster", domainId: "d1", credentials: { "0": { "@type": "Password", secret: "long enough secret" } }, roles: { "@type": "User" } } } }) as { notCreated?: Record<string, { type: string }> };
assert.equal(res.notCreated?.n?.type, "primaryKeyViolation");
});
test("a password is set through its credential's pointer, and a weak one is refused", () => {
const dir = make("admin");
const set = dir.handlers["x:Account/set"]!;
assert.equal((set({ update: { a1: { "credentials/0/secret": "short" } } }) as { notUpdated?: Record<string, { properties: string[] }> }).notUpdated?.a1?.properties[0], "secret");
assert.deepEqual((set({ update: { a1: { "credentials/0/secret": "a much longer secret" } } }) as { updated: object }).updated, { a1: null });
const got = dir.handlers["x:Account/get"]!({ ids: ["a1"], properties: ["credentials"] }) as { list: Array<{ credentials: Record<string, { secret: string }> }> };
assert.equal(got.list[0]!.credentials["0"]!.secret, "[********]", "never echoed back");
});
test("a grant the caller does not hold is refused", () => {
const dir = make("helpdesk");
const res = dir.handlers["x:Account/set"]!({ update: { u101: { roles: { "@type": "Admin" } } } }) as { notUpdated?: Record<string, { type: string }> };
assert.equal(res.notUpdated?.u101?.type, "forbidden");
});
test("an administrator can delete an account, and a group with members is kept", () => {
const dir = make("admin");
const set = dir.handlers["x:Account/set"]!;
assert.deepEqual((set({ destroy: ["u101"] }) as { destroyed: string[] }).destroyed, ["u101"]);
assert.equal((set({ destroy: ["g1"] }) as { notDestroyed?: Record<string, { type: string }> }).notDestroyed?.g1?.type, "objectIsLinked");
});
test("a domain in use is kept, and names what uses it", () => {
const dir = make("admin");
const set = dir.handlers["x:Domain/set"]!;
const res = set({ destroy: ["d1"] }) as { notDestroyed?: Record<string, { type: string; linkedObjects: Array<{ object: string }> }> };
assert.equal(res.notDestroyed?.d1?.type, "objectIsLinked");
const kinds = new Set(res.notDestroyed?.d1?.linkedObjects.map((o) => o.object));
assert.deepEqual([...kinds].sort(), ["Account", "DkimSignature"]);
});
test("an unused domain goes once its keys do", () => {
const dir = make("admin");
const created = dir.handlers["x:Domain/set"]!({ create: { n: { name: "fresh.example.net" } } }) as { created: Record<string, { id: string }> };
const id = created.created.n!.id;
const keys = dir.handlers["x:DkimSignature/query"]!({ filter: { domainId: id } }) as { ids: string[] };
assert.equal(keys.ids.length, 1, "automatic DKIM makes a key straight away");
assert.equal((dir.handlers["x:Domain/set"]!({ destroy: [id] }) as { notDestroyed?: object }).notDestroyed !== undefined, true);
dir.handlers["x:DkimSignature/set"]!({ destroy: keys.ids });
assert.deepEqual((dir.handlers["x:Domain/set"]!({ destroy: [id] }) as { destroyed: string[] }).destroyed, [id]);
});
test("a domain's zone file is computed on read, with long keys split as the server splits them", () => {
const dir = make("admin");
const got = dir.handlers["x:Domain/get"]!({ ids: ["d1"], properties: ["name", "dnsZoneFile"] }) as { list: Array<{ dnsZoneFile: string }> };
const zone = got.list[0]!.dnsZoneFile;
assert.match(zone, /IN MX 10 /);
assert.match(zone, /_domainkey\.example\.com\. IN TXT \(\n {4}"/);
});
test("a filter on a name the registry does not index is refused, as the live server refuses it", () => {
const dir = make("admin");
// Seen on a live 0.16 server: "x:Account/query: unsupportedFilter - type".
assert.throws(() => dir.handlers["x:Account/query"]!({ filter: { type: "User" } }), (e: Refused) => e.type === "unsupportedFilter" && e.message === "type");
assert.doesNotThrow(() => dir.handlers["x:Account/query"]!({ filter: { "@type": "Group", domainId: "d1", text: "x" } }));
});
test("the domain validators refuse what the live server refused, in its words", () => {
const dir = make("admin");
const set = dir.handlers["x:Domain/set"]!;
const created = set({ create: { n: { name: "admin-test.example" } } }) as { notCreated?: Record<string, { type: string; description: string }> };
assert.deepEqual([created.notCreated?.n?.type, created.notCreated?.n?.description], ["invalidPatch", "Invalid domain name"]);
const updated = set({ update: { d2: { catchAllAddress: "postmaster" } } }) as { notUpdated?: Record<string, { type: string; description: string }> };
assert.deepEqual([updated.notUpdated?.d2?.type, updated.notUpdated?.d2?.description], ["invalidPatch", "Invalid email address"]);
});
+427
View File
@@ -0,0 +1,427 @@
/**
* Enough of Stalwart 0.16's directory registry to develop administration
* against: `x:Account`, `x:Domain` and `x:Role`, gated by permission names the
* way the real server gates them.
*
* Shapes follow the 0.16.22 source rather than the documentation, which has
* been wrong about both before:
*
* - a `List<T>` (credentials, aliases) is an object keyed by index -- `{"0": …}`
* -- and a `Set` (memberGroupIds, enabledPermissions) is `{"id": true}`;
* - an account's `name` is the local part only, and it lives on a domain by id;
* - secrets come back masked, and a new one is written through the password
* credential's own pointer, `credentials/<index>/secret`;
* - `x:Account/query` understands AND and nothing else.
*
* What it does not reproduce is tenancy: every caller sees every record. The
* real server scopes a tenant administrator's queries, and nothing in the client
* relies on seeing more or less than it is given.
*
* MOCK_ROLE picks who the demo user is: `admin` (the default), `tenant-admin`,
* `helpdesk` (a custom role that may view and edit accounts but not create or
* delete them) or `user`.
*/
type Obj = Record<string, unknown>;
export type MockRole = "admin" | "tenant-admin" | "helpdesk" | "user";
const OPS = ["Get", "Query", "Create", "Update", "Destroy"] as const;
const all = (...objects: string[]) => objects.flatMap((o) => OPS.map((op) => `sys${o}${op}`));
/** A few of the ordinary ones, so the list looks like what a server sends. */
const USER_PERMISSIONS = ["jmapEmailGet", "jmapEmailSet", "jmapMailboxGet", "sysAccountSettingsGet"];
export function permissionsFor(role: MockRole): string[] {
switch (role) {
case "admin":
return [...USER_PERMISSIONS, ...all("Account", "Domain", "Role", "MailingList", "DkimSignature", "DnsServer", "Tenant"), "impersonate"];
case "tenant-admin":
return [...USER_PERMISSIONS, ...all("Account", "Domain", "Role", "MailingList", "DkimSignature", "DnsServer")];
case "helpdesk":
return [...USER_PERMISSIONS, "sysAccountGet", "sysAccountQuery", "sysAccountUpdate"];
default:
return USER_PERMISSIONS;
}
}
export function mockRole(raw: string | undefined): MockRole {
return raw === "tenant-admin" || raw === "helpdesk" || raw === "user" ? raw : "admin";
}
const MASKED = "[********]";
const GIB = 1024 ** 3;
interface Options {
/** The demo user's JMAP account id, which is also its registry id. */
accountId: string;
/** The demo user's address. */
user: string;
locale: string;
role: MockRole;
/** Build the error a method fails with; the mock server owns the type. */
fail: (type: string, description?: string) => Error;
}
export function createDirectory(opts: Options) {
const permissions = new Set(permissionsFor(opts.role));
const [userLocal, userDomain] = splitAddress(opts.user);
let counter = 100;
const managed = (dns: boolean, dkim: boolean, certs: boolean) => ({
dnsManagement: dns ? { "@type": "Automatic", dnsServerId: "ns1", origin: null, publishRecords: {} } : { "@type": "Manual" },
dkimManagement: dkim ? { "@type": "Automatic", algorithms: { Dkim1Ed25519Sha256: true, Dkim1RsaSha256: true }, selectorTemplate: "v{version}-{algorithm}-{date-%Y%m%d}" } : { "@type": "Manual" },
certificateManagement: certs ? { "@type": "Automatic", acmeProviderId: "acme1", subjectAlternativeNames: {} } : { "@type": "Manual" },
});
const domain = (id: string, name: string, extra: Obj = {}): Obj => ({
id, name, aliases: {}, isEnabled: true, createdAt: "2026-06-01T09:00:00Z", description: null, logo: null,
...managed(false, true, false), memberTenantId: null, directoryId: null, catchAllAddress: null,
subAddressing: { "@type": "Enabled" }, allowRelaying: false, reportAddressUri: "mailto:postmaster", allowScimProvisioning: false, ...extra,
});
const domains: Obj[] = [
domain("d1", userDomain, { ...managed(true, true, true), aliases: { [`mail.${userDomain}`]: true }, description: "Main domain" }),
domain("d2", userDomain === "example.org" ? "example.net" : "example.org", { catchAllAddress: `postmaster@${userDomain}` }),
domain("d3", "old-brand.example", { ...managed(false, false, false), description: "No longer used", subAddressing: { "@type": "Custom", customRule: "..." } }),
];
const dkimKeys: Obj[] = [
{ id: "k1", "@type": "Dkim1Ed25519Sha256", domainId: "d1", selector: "v1-ed25519-20260601", stage: "active", createdAt: "2026-06-01T09:00:00Z", nextTransitionAt: "2026-08-30T09:00:00Z", memberTenantId: null },
{ id: "k2", "@type": "Dkim1RsaSha256", domainId: "d1", selector: "v1-rsa-20260601", stage: "active", createdAt: "2026-06-01T09:00:00Z", nextTransitionAt: "2026-08-30T09:00:00Z", memberTenantId: null },
{ id: "k3", "@type": "Dkim1Ed25519Sha256", domainId: "d2", selector: "v1-ed25519-20260710", stage: "active", createdAt: "2026-07-10T09:00:00Z", nextTransitionAt: null, memberTenantId: null },
];
/** What Stalwart's BIND serialiser writes, including a TXT long enough to be split. */
const zoneFile = (d: Obj): string => {
const n = String(d.name);
const lines = [
`${n}. IN MX 10 mail.${userDomain}.`,
`${n}. IN TXT "v=spf1 mx ra=postmaster -all"`,
];
for (const k of dkimKeys.filter((k) => k.domainId === d.id && k.stage !== "retired")) {
if (String(k["@type"]).includes("Rsa")) {
const p = "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA" + "x".repeat(300) + "IDAQAB";
const txt = `v=DKIM1; k=rsa; h=sha256; p=${p}`;
lines.push(`${k.selector}._domainkey.${n}. IN TXT (`, ...(txt.match(/.{1,255}/g) ?? []).map((c) => ` "${c}"`), ")");
} else {
lines.push(`${k.selector}._domainkey.${n}. IN TXT "v=DKIM1; k=ed25519; h=sha256; p=11qYAYKxCrfVS/7TyWQHOg7hcvPapiMlrwIaaPcHURo="`);
}
}
lines.push(
`_dmarc.${n}. IN TXT "v=DMARC1; p=reject; rua=mailto:postmaster@${n}; ruf=mailto:postmaster@${n}"`,
`_jmap._tcp.${n}. IN SRV 0 1 443 mail.${userDomain}.`,
`_submissions._tcp.${n}. IN SRV 0 1 465 mail.${userDomain}.`,
`_imaps._tcp.${n}. IN SRV 0 1 993 mail.${userDomain}.`,
`mta-sts.${n}. IN CNAME mail.${userDomain}.`,
`_mta-sts.${n}. IN TXT "v=STSv1; id=16837364213434767412"`,
`_smtp._tls.${n}. IN TXT "v=TLSRPTv1; rua=mailto:postmaster@${n}"`,
`autoconfig.${n}. IN CNAME mail.${userDomain}.`,
`${n}. IN CAA 0 issue "letsencrypt.org"`,
);
return lines.join("\n") + "\n";
};
const roles: Obj[] = [
{ id: "r1", description: "User", enabledPermissions: flags(USER_PERMISSIONS), disabledPermissions: {}, roleIds: {} },
{ id: "r2", description: "Helpdesk", enabledPermissions: flags(permissionsFor("helpdesk").filter((p) => p.startsWith("sys"))), disabledPermissions: {}, roleIds: { r1: true } },
{ id: "r3", description: "Directory manager", enabledPermissions: flags(all("Account")), disabledPermissions: {}, roleIds: { r1: true } },
];
const ownRoles = opts.role === "admin" || opts.role === "tenant-admin" ? { "@type": "Admin" } : opts.role === "helpdesk" ? { "@type": "Custom", roleIds: { r2: true } } : { "@type": "User" };
const accounts: Obj[] = [];
const user = (o: { id?: string; name: string; domain?: string; description: string; roles?: Obj; used?: number; quota?: number; aliases?: string[]; groups?: string[]; password?: boolean }) => {
const domainId = o.domain === "d2" ? "d2" : "d1";
const row: Obj = {
id: o.id ?? `u${counter++}`,
"@type": "User",
name: o.name,
domainId,
description: o.description,
credentials: o.password === false ? {} : { "0": { "@type": "Password", credentialId: "0", secret: MASKED, otpAuth: null, expiresAt: null, allowedIps: {} } },
createdAt: new Date(Date.now() - counter * 86_400_000).toISOString().replace(/\.\d{3}Z$/, "Z"),
memberGroupIds: flags(o.groups ?? []),
memberTenantId: null,
roles: o.roles ?? { "@type": "User" },
permissions: { "@type": "Inherit" },
quotas: o.quota ? { maxDiskQuota: o.quota * GIB } : {},
usedDiskQuota: Math.round((o.used ?? 0) * GIB),
aliases: Object.fromEntries((o.aliases ?? []).map((name, i) => [String(i), { enabled: true, name, domainId, description: null }])),
locale: opts.locale,
timeZone: null,
};
accounts.push(row);
return row;
};
const group = (id: string, name: string, description: string) =>
accounts.push({ id, "@type": "Group", name, domainId: "d1", description, memberTenantId: null, roles: { "@type": "User" }, permissions: { "@type": "Inherit" }, quotas: {}, usedDiskQuota: 0, aliases: {} });
group("g1", "support", "Support");
group("g2", "office", "Office");
user({ id: opts.accountId, name: userLocal, description: "Demo User", roles: ownRoles, used: 1.4, quota: 10, aliases: ["postmaster"], groups: ["g1"] });
user({ name: "ada", domain: "d2", description: "Ada Lovelace", used: 3.2, quota: 5, groups: ["g2"] });
user({ name: "grace", domain: "d2", description: "Grace Hopper", used: 4.7, quota: 5, groups: ["g2"] });
user({ name: "alan", domain: "d2", description: "Alan Turing", roles: { "@type": "Custom", roleIds: { r2: true } }, used: 0.8, quota: 5, groups: ["g1"] });
user({ name: "margaret", description: "Margaret Hamilton", roles: { "@type": "Admin" }, used: 2.1, quota: 20 });
user({ name: "katherine", description: "Katherine Johnson", roles: { "@type": "Custom", roleIds: { r3: true } }, used: 0.4, quota: 5 });
user({ name: "sso.only", description: "Signs in with SSO", password: false, used: 0.1 });
const people = ["Edsger Dijkstra", "Barbara Liskov", "Donald Knuth", "Frances Allen", "John Backus", "Radia Perlman", "Ken Thompson", "Hedy Lamarr", "Dennis Ritchie", "Karen Spärck Jones", "Tim Berners-Lee", "Sophie Wilson", "Niklaus Wirth", "Jean Sammet", "Leslie Lamport", "Mary Kenneth Keller", "Tony Hoare", "Evelyn Berezin", "Butler Lampson", "Shafi Goldwasser", "Whitfield Diffie", "Adele Goldberg", "Vint Cerf", "Anita Borg", "Bob Kahn", "Lynn Conway", "Charles Babbage", "Annie Easley"];
people.forEach((description, i) => {
const name = description.toLowerCase().split(" ")[0]!.normalize("NFD").replace(/[^a-z]/g, "");
user({ name, domain: i % 3 === 0 ? "d2" : "d1", description, used: (i % 7) * 0.6, quota: i % 4 === 0 ? 0 : 5 });
});
const demand = (perm: string) => {
if (!permissions.has(perm)) throw opts.fail("forbidden", `You do not have the ${perm} permission.`);
};
const domainName = (id: unknown) => domains.find((d) => d.id === id)?.name as string | undefined;
const addressOf = (o: Obj) => `${o.name}@${domainName(o.domainId) ?? "invalid"}`;
/** Every address in use, primary and alias, across accounts. */
const addressTaken = (address: string, except?: string) =>
accounts.some((a) => a.id !== except && (addressOf(a) === address || Object.values((a.aliases as Obj) ?? {}).some((al) => `${(al as Obj).name}@${domainName((al as Obj).domainId)}` === address)));
const view = (o: Obj, properties: unknown): Obj => {
const full: Obj = { ...o };
if (accounts.includes(o)) full.emailAddress = addressOf(o);
if (domains.includes(o)) full.dnsZoneFile = zoneFile(o);
if (full.credentials) {
full.credentials = Object.fromEntries(Object.entries(full.credentials as Obj).map(([k, c]) => [k, { ...(c as Obj), secret: MASKED }]));
}
if (!Array.isArray(properties)) return full;
const out: Obj = { id: o.id };
for (const p of properties as string[]) if (p in full) out[p] = full[p];
return out;
};
const get = (list: Obj[], perm: string) => (a: Obj) => {
demand(perm);
const ids = a.ids as string[] | null | undefined;
const found = ids ? list.filter((x) => ids.includes(x.id as string)) : list;
return { accountId: opts.accountId, state: "1", list: found.map((x) => view(x, a.properties)), notFound: ids ? ids.filter((id) => !list.some((x) => x.id === id)) : [] };
};
/**
* A query, filtered only on what the real server indexes for that object.
* Any other name is refused the way Stalwart refuses it -- `unsupportedFilter`
* with the name as the whole description -- because a mock that took
* `{"type": "User"}` let exactly that ship, and the live server answers it
* with "unsupportedFilter - type".
*/
const query = (list: () => Obj[], perm: string, filterable: string[], match: (o: Obj, filter: Obj) => boolean) => (a: Obj) => {
demand(perm);
const filter = (a.filter as Obj | undefined) ?? {};
if ("operator" in filter) throw opts.fail("unsupportedFilter", "Only AND is supported in filters");
const unknown = Object.keys(filter).find((k) => !filterable.includes(k));
if (unknown) throw opts.fail("unsupportedFilter", unknown);
// Stalwart's default order is newest first, by id.
const rows = list().filter((o) => match(o, filter)).sort((x, y) => String(y.id).localeCompare(String(x.id), undefined, { numeric: true }));
const position = Math.max(0, Number(a.position ?? 0));
const limit = a.limit == null ? rows.length : Number(a.limit);
return {
accountId: opts.accountId,
queryState: "1",
canCalculateChanges: false,
position,
ids: rows.slice(position, position + limit).map((o) => o.id),
...(a.calculateTotal ? { total: rows.length } : {}),
};
};
const matchText = (o: Obj, text: unknown) => {
if (typeof text !== "string" || !text.trim()) return true;
const needle = text.trim().toLowerCase();
return [o.name, o.description, addressOf(o)].some((v) => typeof v === "string" && v.toLowerCase().includes(needle));
};
const setError = (type: string, description: string, properties?: string[]) => ({ type, description, ...(properties ? { properties } : {}) });
/** The password checks, roughly as strict as a default Stalwart. */
const weakPassword = (secret: unknown) => (typeof secret !== "string" || secret.length < 8 ? "Password must be at least 8 characters long." : null);
/** Stalwart checks a grant against the caller's own permissions. */
const grantRefused = (roles: unknown): string | null => {
const r = roles as Obj | undefined;
if (!r) return null;
if (r["@type"] === "Admin" && opts.role !== "admin" && opts.role !== "tenant-admin") return "You are not authorized to grant permissions: administrator.";
if (r["@type"] === "Custom") {
for (const id of Object.keys((r.roleIds as Obj) ?? {})) {
const role = roles_(id);
if (!role) return "Role does not exist.";
const missing = Object.keys((role.enabledPermissions as Obj) ?? {}).filter((p) => !permissions.has(p));
if (missing.length) return `You are not authorized to grant permissions: ${missing.join(", ")}.`;
}
}
return null;
};
const roles_ = (id: string) => roles.find((r) => r.id === id);
const handlers: Record<string, (a: Obj) => Obj> = {
"x:Account/get": get(accounts, "sysAccountGet"),
"x:Account/query": query(() => accounts, "sysAccountQuery", ["text", "@type", "domainId", "externalId", "memberGroupIds", "memberTenantId", "name"], (o, f) =>
(f["@type"] === undefined || o["@type"] === f["@type"]) && (f.domainId === undefined || o.domainId === f.domainId) && matchText(o, f.text) && matchText(o, f.name)),
"x:Account/set": (a) => {
const created: Obj = {};
const notCreated: Obj = {};
const updated: Obj = {};
const notUpdated: Obj = {};
const destroyed: string[] = [];
const notDestroyed: Obj = {};
for (const [cid, raw] of Object.entries((a.create as Obj) ?? {})) {
demand("sysAccountCreate");
const o = { ...(raw as Obj) };
if (typeof o.name !== "string" || !/^[a-z0-9._-]+$/i.test(o.name)) { notCreated[cid] = setError("invalidProperties", "Invalid account name.", ["name"]); continue; }
if (!domainName(o.domainId)) { notCreated[cid] = setError("invalidForeignKey", "Domain does not exist.", ["domainId"]); continue; }
if (addressTaken(`${o.name}@${domainName(o.domainId)}`)) { notCreated[cid] = setError("primaryKeyViolation", "An account or alias with this email address already exists."); continue; }
const refused = grantRefused(o.roles);
if (refused) { notCreated[cid] = setError("forbidden", refused); continue; }
const password = Object.values((o.credentials as Obj) ?? {})[0] as Obj | undefined;
const weak = password ? weakPassword(password.secret) : null;
if (weak) { notCreated[cid] = setError("invalidProperties", weak, ["secret"]); continue; }
const id = `u${counter++}`;
accounts.push({ memberGroupIds: {}, aliases: {}, quotas: {}, permissions: { "@type": "Inherit" }, ...o, id, memberTenantId: null, usedDiskQuota: 0, createdAt: new Date().toISOString().replace(/\.\d{3}Z$/, "Z"), locale: opts.locale, timeZone: null });
created[cid] = { id, emailAddress: `${o.name}@${domainName(o.domainId)}` };
}
for (const [id, raw] of Object.entries((a.update as Obj) ?? {})) {
demand("sysAccountUpdate");
const target = accounts.find((x) => x.id === id);
if (!target) { notUpdated[id] = setError("notFound", "Account not found."); continue; }
const patch = raw as Obj;
const next = structuredClone(target);
let failure: Obj | null = null;
for (const [path, value] of Object.entries(patch)) {
if (path === "id" || path === "@type" || path === "usedDiskQuota" || path === "emailAddress") { failure = setError("invalidProperties", `Property ${path} cannot be changed.`, [path]); break; }
if (path.endsWith("/secret")) {
const weak = weakPassword(value);
if (weak) { failure = setError("invalidProperties", weak, ["secret"]); break; }
}
if (path.startsWith("credentials/") && value && typeof value === "object") {
const weak = weakPassword((value as Obj).secret);
if (weak) { failure = setError("invalidProperties", weak, ["secret"]); break; }
}
setPointer(next, path, value);
}
if (!failure && ("roles" in patch || "permissions" in patch)) {
const refused = grantRefused(next.roles);
if (refused) failure = setError("forbidden", refused);
}
if (!failure) {
for (const al of Object.values((next.aliases as Obj) ?? {})) {
const address = `${(al as Obj).name}@${domainName((al as Obj).domainId)}`;
if (!domainName((al as Obj).domainId)) { failure = setError("invalidForeignKey", "Domain does not exist.", ["aliases"]); break; }
if (addressTaken(address, id)) { failure = setError("primaryKeyViolation", "An account or alias with this email address already exists."); break; }
}
}
if (failure) { notUpdated[id] = failure; continue; }
// Secrets are stored hashed; the mock just stops echoing them.
for (const c of Object.values((next.credentials as Obj) ?? {})) (c as Obj).secret = MASKED;
Object.assign(target, next);
updated[id] = null;
}
for (const id of (a.destroy as string[]) ?? []) {
demand("sysAccountDestroy");
const i = accounts.findIndex((x) => x.id === id);
if (i < 0) { notDestroyed[id] = setError("notFound", "Account not found."); continue; }
if (accounts[i]!["@type"] === "Group" && accounts.some((x) => (x.memberGroupIds as Obj | undefined)?.[id])) {
notDestroyed[id] = { ...setError("objectIsLinked", "Group still has members."), linkedObjects: {} };
continue;
}
accounts.splice(i, 1);
destroyed.push(id);
}
return { accountId: opts.accountId, oldState: "1", newState: "2", created, updated, destroyed, ...(Object.keys(notCreated).length ? { notCreated } : {}), ...(Object.keys(notUpdated).length ? { notUpdated } : {}), ...(Object.keys(notDestroyed).length ? { notDestroyed } : {}) };
},
"x:Domain/get": get(domains, "sysDomainGet"),
"x:Domain/query": query(() => domains, "sysDomainQuery", ["text", "aliases", "memberTenantId", "name"], (o, f) => matchText(o, f.text) && matchText(o, f.name)),
"x:Domain/set": (a) => {
const created: Obj = {};
const notCreated: Obj = {};
const updated: Obj = {};
const notUpdated: Obj = {};
const destroyed: string[] = [];
const notDestroyed: Obj = {};
const taken = (name: string, except?: string) => domains.some((d) => d.id !== except && (d.name === name || Object.keys((d.aliases as Obj) ?? {}).includes(name)));
for (const [cid, raw] of Object.entries((a.create as Obj) ?? {})) {
demand("sysDomainCreate");
const o = raw as Obj;
const name = String(o.name ?? "");
// Live on 2026-09-13: a reserved TLD is refused by the registry's
// domain validator, as invalidPatch with the validator's own words.
if (!/^([a-z0-9-]+\.)+[a-z0-9-]{2,}$/.test(name) || /\.(example|test|invalid|localhost)$/.test(name)) { notCreated[cid] = setError("invalidPatch", "Invalid domain name", ["name"]); continue; }
if (taken(name)) { notCreated[cid] = setError("primaryKeyViolation", "A domain with this name already exists.", ["name"]); continue; }
const id = `d${counter++}`;
domains.push(domain(id, name, { ...o, id, createdAt: new Date().toISOString().replace(/\.\d{3}Z$/, "Z") }));
// Automatic DKIM, the default, makes its keys straight away.
dkimKeys.push({ id: `k${counter++}`, "@type": "Dkim1Ed25519Sha256", domainId: id, selector: "v1-ed25519-20260913", stage: "active", createdAt: new Date().toISOString(), nextTransitionAt: null, memberTenantId: null });
created[cid] = { id };
}
for (const [id, raw] of Object.entries((a.update as Obj) ?? {})) {
demand("sysDomainUpdate");
const target = domains.find((d) => d.id === id);
if (!target) { notUpdated[id] = setError("notFound", "Domain not found."); continue; }
const next = structuredClone(target);
for (const [path, value] of Object.entries(raw as Obj)) setPointer(next, path, value);
// Live on 2026-09-13: a catch-all that is not a whole address.
if (typeof next.catchAllAddress === "string" && !/^[^@\s]+@[^@\s]+\.[^@\s]+$/.test(next.catchAllAddress)) { notUpdated[id] = setError("invalidPatch", "Invalid email address", ["catchAllAddress"]); continue; }
const clash = Object.keys((next.aliases as Obj) ?? {}).find((alias) => alias === next.name || taken(alias, id));
if (clash) { notUpdated[id] = setError("primaryKeyViolation", `The name ${clash} is already in use.`, ["aliases"]); continue; }
Object.assign(target, next);
updated[id] = null;
}
for (const id of (a.destroy as string[]) ?? []) {
demand("sysDomainDestroy");
const i = domains.findIndex((d) => d.id === id);
if (i < 0) { notDestroyed[id] = setError("notFound", "Domain not found."); continue; }
const linked = [
...accounts.filter((x) => x.domainId === id || Object.values((x.aliases as Obj) ?? {}).some((al) => (al as Obj).domainId === id)).map((x) => ({ object: "Account", id: x.id })),
...dkimKeys.filter((k) => k.domainId === id).map((k) => ({ object: "DkimSignature", id: k.id })),
];
if (linked.length) { notDestroyed[id] = { ...setError("objectIsLinked", "Object is linked to other objects."), linkedObjects: linked }; continue; }
domains.splice(i, 1);
destroyed.push(id);
}
return { accountId: opts.accountId, oldState: "1", newState: "2", created, updated, destroyed, ...(Object.keys(notCreated).length ? { notCreated } : {}), ...(Object.keys(notUpdated).length ? { notUpdated } : {}), ...(Object.keys(notDestroyed).length ? { notDestroyed } : {}) };
},
"x:DkimSignature/get": get(dkimKeys, "sysDkimSignatureGet"),
"x:DkimSignature/query": query(() => dkimKeys, "sysDkimSignatureQuery", ["domainId", "memberTenantId"], (o, f) => f.domainId === undefined || o.domainId === f.domainId),
"x:DkimSignature/set": (a) => {
const destroyed: string[] = [];
for (const id of (a.destroy as string[]) ?? []) {
demand("sysDkimSignatureDestroy");
const i = dkimKeys.findIndex((k) => k.id === id);
if (i >= 0) { dkimKeys.splice(i, 1); destroyed.push(id); }
}
if (a.create) throw opts.fail("forbidden", "The mock does not generate DKIM keys; automatic management does that.");
return { accountId: opts.accountId, oldState: "1", newState: "2", created: {}, updated: {}, destroyed };
},
"x:DnsServer/get": (a) => {
demand("sysDnsServerGet");
return { accountId: opts.accountId, state: "1", list: ((a.ids as string[]) ?? ["ns1"]).filter((id) => id === "ns1").map((id) => ({ id, "@type": "Cloudflare", description: "Cloudflare (main zone)" })), notFound: [] };
},
"x:Role/get": get(roles, "sysRoleGet"),
"x:Role/query": query(() => roles, "sysRoleQuery", ["text", "description", "memberTenantId"], (o, f) => matchText(o, f.description)),
};
return { handlers, permissions: [...permissions], accounts };
}
function flags(names: string[]): Obj {
return Object.fromEntries(names.map((n) => [n, true]));
}
function splitAddress(address: string): [string, string] {
const at = address.lastIndexOf("@");
return at < 0 ? [address, "example.com"] : [address.slice(0, at), address.slice(at + 1)];
}
/**
* Apply one JMAP patch entry. A path walks into nested objects; `null` at the
* end removes the key, which is how an alias or a quota is taken away.
*/
function setPointer(obj: Obj, path: string, value: unknown): void {
const parts = path.split("/").map((p) => p.replace(/~1/g, "/").replace(/~0/g, "~"));
let node = obj;
for (const part of parts.slice(0, -1)) {
if (!node[part] || typeof node[part] !== "object") node[part] = {};
node = node[part] as Obj;
}
const last = parts[parts.length - 1]!;
if (value === null) delete node[last];
else node[last] = value;
}
+23 -11
View File
@@ -6,9 +6,10 @@
import { createServer, type IncomingMessage, type ServerResponse } from "node:http"; import { createServer, type IncomingMessage, type ServerResponse } from "node:http";
import { randomUUID } from "node:crypto"; import { randomUUID } from "node:crypto";
import { signedMessage, type SIGNED_MESSAGES } from "./signedMessages.js"; import { signedMessage, type SIGNED_MESSAGES } from "./signedMessages.js";
import { expandOccurrences, occurrenceAt, occurrenceView, parseSyntheticId, splitOccurrencePatch, syntheticId, type Occurrence } from "./recurrence.js"; import { eventGetView, expandOccurrences, occurrenceAt, occurrenceView, parseSyntheticId, splitOccurrencePatch, syntheticId, type Occurrence } from "./recurrence.js";
import { parseOtpauthUrl, verifyTotp } from "../totp.js"; import { parseOtpauthUrl, verifyTotp } from "../totp.js";
import { holdUntilOf, undoStatusOf } from "./futurerelease.js"; import { holdUntilOf, undoStatusOf } from "./futurerelease.js";
import { createDirectory, mockRole } from "./directory.js";
const PORT = Number(process.env.MOCK_PORT ?? 8788); const PORT = Number(process.env.MOCK_PORT ?? 8788);
/** /**
@@ -885,6 +886,15 @@ function matchSubmissionFilter(sub: Obj, f: Obj | undefined): boolean {
return true; return true;
} }
/** Who the demo user is, for administration. See mock/directory.ts. */
const directory = createDirectory({
accountId: ACCOUNT,
user: USER,
locale: MOCK_LOCALE,
role: mockRole(process.env.MOCK_ROLE),
fail: (type, description) => new MethodError(type, description),
});
const handlers: Record<string, Handler> = { const handlers: Record<string, Handler> = {
// 0.16 exposes the account locale here, under a permission ordinary users // 0.16 exposes the account locale here, under a permission ordinary users
// actually have (unlike x:Account below, which needs sysAccountGet). // actually have (unlike x:Account below, which needs sysAccountGet).
@@ -893,12 +903,10 @@ const handlers: Record<string, Handler> = {
const list = ids.filter((id) => id === "singleton").map((id) => ({ id, locale: MOCK_LOCALE, timeZone: null, description: null })); const list = ids.filter((id) => id === "singleton").map((id) => ({ id, locale: MOCK_LOCALE, timeZone: null, description: null }));
return { accountId: ACCOUNT, state: String(state.n), list: list.map((x) => pick(x, a.properties as string[] | null)), notFound: ids.filter((id) => id !== "singleton") }; return { accountId: ACCOUNT, state: String(state.n), list: list.map((x) => pick(x, a.properties as string[] | null)), notFound: ids.filter((id) => id !== "singleton") };
}, },
// Stalwart's directory extension - the client reads the account locale from here. // Stalwart's directory registry: accounts, domains and roles, behind the
"x:Account/get": (a) => { // same permissions as the real thing. The locale fallback reads x:Account
const ids = (a.ids as string[] | null) ?? [ACCOUNT]; // too, and is refused here exactly when a real server would refuse it.
const list = ids.filter((id) => id === ACCOUNT).map((id) => ({ id, name: USER, locale: MOCK_LOCALE, timeZone: null })); ...directory.handlers,
return { accountId: ACCOUNT, state: String(state.n), list, notFound: ids.filter((id) => id !== ACCOUNT) };
},
"Mailbox/get": (a) => hideShareWithUnlessAsked(a, genericGet(mailboxes)(a) as { list: Obj[] }) as never, "Mailbox/get": (a) => hideShareWithUnlessAsked(a, genericGet(mailboxes)(a) as { list: Obj[] }) as never,
"Mailbox/set": (a) => { const r = genericSet(mailboxes, "m", (o) => Object.assign(o, { ...mb(o.id as string, o.name as string, null, (o.parentId as string) ?? null), ...o }))(a); recount(); return r; }, "Mailbox/set": (a) => { const r = genericSet(mailboxes, "m", (o) => Object.assign(o, { ...mb(o.id as string, o.name as string, null, (o.parentId as string) ?? null), ...o }))(a); recount(); return r; },
"Mailbox/changes": () => ({ accountId: ACCOUNT, oldState: "1", newState: String(state.n), hasMoreChanges: false, created: [], updated: [], destroyed: [] }), "Mailbox/changes": () => ({ accountId: ACCOUNT, oldState: "1", newState: String(state.n), hasMoreChanges: false, created: [], updated: [], destroyed: [] }),
@@ -1255,15 +1263,17 @@ const handlers: Record<string, Handler> = {
"CalendarEvent/get": (a) => { "CalendarEvent/get": (a) => {
const list = eventsFor(a.accountId); const list = eventsFor(a.accountId);
const ids = a.ids as string[] | null | undefined; const ids = a.ids as string[] | null | undefined;
if (!ids) return genericGet(list)(a); const properties = a.properties as string[] | null | undefined;
// With no ids every event comes back under its stored id, none synthetic.
if (!ids) return { accountId: ACCOUNT, state: String(state.n), list: list.map((x) => eventGetView(x, false, properties)), notFound: [] };
const found: Obj[] = []; const found: Obj[] = [];
const notFound: string[] = []; const notFound: string[] = [];
for (const id of ids) { for (const id of ids) {
const resolved = resolveEvent(list, id); const resolved = resolveEvent(list, id);
if (!resolved) { notFound.push(id); continue; } if (!resolved) { notFound.push(id); continue; }
found.push(resolved.occ ? occurrenceView(resolved.base, resolved.occ) : resolved.base); found.push(resolved.occ ? eventGetView(occurrenceView(resolved.base, resolved.occ), true, properties) : eventGetView(resolved.base, false, properties));
} }
return { accountId: ACCOUNT, state: String(state.n), list: found.map((x) => pick(x, a.properties as string[] | null)), notFound }; return { accountId: ACCOUNT, state: String(state.n), list: found, notFound };
}, },
// Stalwart 0.16 rejects the RFC 8984 array outright and silently discards // Stalwart 0.16 rejects the RFC 8984 array outright and silently discards
// participants addressed the RFC 8984 way. The mock did neither, which is how // participants addressed the RFC 8984 way. The mock did neither, which is how
@@ -1303,6 +1313,8 @@ const handlers: Record<string, Handler> = {
return genericSet(booksFor(a.accountId), "ab", (o) => Object.assign(o, { description: null, sortOrder: 0, isDefault: false, isSubscribed: true, shareWith: {}, myRights: abRights(), ...o }))(a); return genericSet(booksFor(a.accountId), "ab", (o) => Object.assign(o, { description: null, sortOrder: 0, isDefault: false, isSubscribed: true, shareWith: {}, myRights: abRights(), ...o }))(a);
}, },
"ContactCard/query": (a) => { const list = a.accountId === SHARED_ACCOUNT ? sharedCards : cards; return { accountId: a.accountId ?? ACCOUNT, queryState: "1", canCalculateChanges: false, position: 0, ids: list.map((c) => c.id), total: list.length }; }, "ContactCard/query": (a) => { const list = a.accountId === SHARED_ACCOUNT ? sharedCards : cards; return { accountId: a.accountId ?? ACCOUNT, queryState: "1", canCalculateChanges: false, position: 0, ids: list.map((c) => c.id), total: list.length }; },
// An empty `properties` list returns `id` alone, which `pick` already does.
// 0.16.22 made Stalwart agree; through 0.16.21 it returned every property.
"ContactCard/get": (a) => genericGet(a.accountId === SHARED_ACCOUNT ? sharedCards : cards)(a), "ContactCard/get": (a) => genericGet(a.accountId === SHARED_ACCOUNT ? sharedCards : cards)(a),
"ContactCard/set": genericSet(cards, "cc"), "ContactCard/set": genericSet(cards, "cc"),
"ContactCard/parse": (a) => { const parsed: Obj = {}; for (const b of a.blobIds as string[]) { const t = blobs.get(b)?.data.toString() ?? ""; const fn = /^FN:(.*)$/m.exec(t)?.[1]?.trim() ?? "Imported"; const em = /^EMAIL[^:]*:(.*)$/m.exec(t)?.[1]?.trim(); parsed[b] = [{ "@type": "Card", version: "1.0", uid: randomUUID(), kind: "individual", name: { full: fn }, emails: em ? { e1: { address: em } } : undefined }]; } return { accountId: ACCOUNT, parsed, notParsable: [] }; }, "ContactCard/parse": (a) => { const parsed: Obj = {}; for (const b of a.blobIds as string[]) { const t = blobs.get(b)?.data.toString() ?? ""; const fn = /^FN:(.*)$/m.exec(t)?.[1]?.trim() ?? "Imported"; const em = /^EMAIL[^:]*:(.*)$/m.exec(t)?.[1]?.trim(); parsed[b] = [{ "@type": "Card", version: "1.0", uid: randomUUID(), kind: "individual", name: { full: fn }, emails: em ? { e1: { address: em } } : undefined }]; } return { accountId: ACCOUNT, parsed, notParsable: [] }; },
@@ -1413,7 +1425,7 @@ export const server = createServer(async (req, res) => {
// The account info endpoint; the only place a server reports its edition. // The account info endpoint; the only place a server reports its edition.
if (url.pathname === "/api/account" && req.method === "GET") { if (url.pathname === "/api/account" && req.method === "GET") {
res.writeHead(200, { "content-type": "application/json" }); res.writeHead(200, { "content-type": "application/json" });
return res.end(JSON.stringify({ permissions: ["jmapEmailGet", "sysAccountSettingsGet"], edition: "oss", locale: MOCK_LOCALE })); return res.end(JSON.stringify({ permissions: directory.permissions, edition: "oss", locale: MOCK_LOCALE }));
} }
if (url.pathname === "/jmap/" && req.method === "POST") { if (url.pathname === "/jmap/" && req.method === "POST") {
const body = JSON.parse((await readBody(req)).toString()) as { methodCalls: [string, Obj, string][]; using?: string[] }; const body = JSON.parse((await readBody(req)).toString()) as { methodCalls: [string, Obj, string][]; using?: string[] };
+49 -1
View File
@@ -1,6 +1,6 @@
import { describe, it } from "node:test"; import { describe, it } from "node:test";
import assert from "node:assert/strict"; import assert from "node:assert/strict";
import { expandOccurrences, occurrenceAt, occurrenceView, parseSyntheticId, splitOccurrencePatch, syntheticId } from "./recurrence.js"; import { eventGetView, expandOccurrences, occurrenceAt, occurrenceView, parseSyntheticId, splitOccurrencePatch, syntheticId } from "./recurrence.js";
/** /**
* The mock expands recurrences so that per-occurrence editing can be developed * The mock expands recurrences so that per-occurrence editing can be developed
@@ -98,6 +98,54 @@ describe("occurrenceView", () => {
}); });
}); });
describe("eventGetView", () => {
/*
* What 0.16.22 changed in `CalendarEvent/get`, read from its source and the
* tests that came with it (`tests/src/jmap/calendar/event.rs` and
* `instance.rs`).
*/
it("reports no base for an event read by its stored id", () => {
// 0.16.21 answered with the event's own id here.
assert.deepEqual(eventGetView(oneOff(), false, ["id", "baseEventId"]), { id: "ev2", baseEventId: null });
assert.equal(eventGetView(series(), false, ["baseEventId"]).baseEventId, null);
});
it("still gives a one-off read through its synthetic id a base", () => {
// An expanded query hands a one-off a synthetic id, so this has not
// changed: `baseEventId` is still no evidence of a series.
const base = oneOff();
const view = eventGetView(occurrenceView(base, occurrenceAt(base, "2026-09-08T12:00:00")!), true, ["baseEventId"]);
assert.equal(view.baseEventId, "ev2");
});
it("answers null for the rule and overrides named on an occurrence", () => {
const base = { ...series(), recurrenceOverrides: { "2026-09-09T09:00:00": { title: "Standup (long)" } } };
const view = eventGetView(occurrenceView(base, occurrenceAt(base, "2026-09-08T09:00:00")!), true,
["recurrenceId", "recurrenceRule", "recurrenceOverrides"]);
assert.deepEqual(view, { id: "ev1-r20260908T090000", recurrenceId: "2026-09-08T09:00:00", recurrenceRule: null, recurrenceOverrides: null });
});
it("leaves the rule on the series itself alone", () => {
assert.deepEqual(eventGetView(series(), false, ["recurrenceRule"]).recurrenceRule, WEEKDAYS);
});
it("reads useDefaultAlerts as false until it is set", () => {
// It used to read true until set.
assert.equal(eventGetView(series(), false, ["useDefaultAlerts"]).useDefaultAlerts, false);
assert.equal(eventGetView({ ...series(), useDefaultAlerts: true }, false, ["useDefaultAlerts"]).useDefaultAlerts, true);
assert.equal(eventGetView({ ...series(), useDefaultAlerts: false }, false, ["useDefaultAlerts"]).useDefaultAlerts, false);
});
it("returns only the id for an empty list", () => {
// 0.16.21 treated an empty list as asking for everything.
assert.deepEqual(eventGetView(series(), false, []), { id: "ev1" });
});
it("returns the object unchanged when no list is given", () => {
assert.deepEqual(eventGetView(series(), false, null), series());
});
});
describe("parseSyntheticId", () => { describe("parseSyntheticId", () => {
it("round-trips", () => { it("round-trips", () => {
assert.deepEqual(parseSyntheticId(syntheticId("ev1", "2026-09-08T09:00:00")), assert.deepEqual(parseSyntheticId(syntheticId("ev1", "2026-09-08T09:00:00")),
+38 -1
View File
@@ -1,5 +1,5 @@
/** /**
* Enough recurrence expansion for the mock to behave like Stalwart 0.16.21. * Enough recurrence expansion for the mock to behave like Stalwart 0.16.22.
* *
* The mock used to hand a recurring event back once, as its stored self. Three * The mock used to hand a recurring event back once, as its stored self. Three
* things that only a live server showed were therefore impossible to develop * things that only a live server showed were therefore impossible to develop
@@ -188,6 +188,43 @@ export function occurrenceView(base: Obj, occ: Occurrence): Obj {
return view; return view;
} }
/** Series properties a synthetic id answers `null` for, when they are named. */
const NULL_ON_OCCURRENCE = new Set(["recurrenceRule", "recurrenceOverrides"]);
/**
* The object a `CalendarEvent/get` with a `properties` list returns, as 0.16.22
* builds it. Omitted or null `properties` returns the stored object unchanged.
*
* Three of the named properties are no longer read off the object:
*
* - `baseEventId` is the master's id on a synthetic id and `null` on anything
* else. Through 0.16.21 an event read by its stored id reported that id as
* its own base. An expanded query still hands a one-off a synthetic id, so
* one read that way still carries a base, and `baseEventId` is still no
* evidence of a series;
* - `recurrenceRule` and `recurrenceOverrides` come back as `null` on a
* synthetic id rather than being left out;
* - `useDefaultAlerts` is the reader's own preference, and `false` when they
* never set one. It used to read `true` until set. The mock has one reader,
* so a value stored on the event stands in for that reader's.
*
* An empty list returns `id` alone, where 0.16.21 treated it as asking for
* everything. `ContactCard/get` changed the same way.
*
* Read from the 0.16.22 source (`calendar_event/get.rs`) and its tests.
*/
export function eventGetView(event: Obj, synthetic: boolean, properties: string[] | null | undefined): Obj {
if (!properties) return event;
const out: Obj = { id: event.id };
for (const p of properties) {
if (p === "baseEventId") out[p] = synthetic ? event.baseEventId : null;
else if (p === "useDefaultAlerts") out[p] = event.useDefaultAlerts === true;
else if (synthetic && NULL_ON_OCCURRENCE.has(p)) out[p] = null;
else if (p in event) out[p] = event[p];
}
return out;
}
/* ---------- what a single occurrence will not take ---------- */ /* ---------- what a single occurrence will not take ---------- */
/** Refused outright, with `invalidProperties`. */ /** Refused outright, with `invalidProperties`. */
+27
View File
@@ -0,0 +1,27 @@
import { test } from "node:test";
import assert from "node:assert/strict";
import { interpretServerAccount, normalizePermission } from "./upstream.js";
/**
* `/api/account` is the only place Stalwart lists what an account may do, and
* ihasmail used to read the edition out of it and throw the rest away.
*/
test("the account's permissions are kept alongside the edition", () => {
const info = interpretServerAccount({ edition: "enterprise", permissions: ["sysAccountGet", "sysAccountQuery"], locale: "en_US" });
assert.deepEqual(info, { edition: "enterprise", permissions: ["sysAccountGet", "sysAccountQuery"] });
});
test("permission names read the same whichever case the server uses", () => {
// The source serialises camelCase; the documentation shows kebab-case.
assert.equal(normalizePermission("sys-account-get"), "sysAccountGet");
assert.equal(normalizePermission("sysAccountGet"), "sysAccountGet");
assert.equal(normalizePermission("sys-dkim-signature-create"), "sysDkimSignatureCreate");
assert.deepEqual(interpretServerAccount({ permissions: ["sys-account-get", "sysAccountGet"] }).permissions, ["sysAccountGet"]);
});
test("a body without a usable list yields no permissions rather than failing", () => {
assert.deepEqual(interpretServerAccount({ edition: "oss" }), { edition: "oss", permissions: [] });
assert.deepEqual(interpretServerAccount({ permissions: "sysAccountGet" }), { edition: null, permissions: [] });
assert.deepEqual(interpretServerAccount({ permissions: [1, null, "sysDomainGet"] }).permissions, ["sysDomainGet"]);
assert.deepEqual(interpretServerAccount(null), { edition: null, permissions: [] });
});
+30 -1
View File
@@ -5,6 +5,35 @@ import { Readable } from "node:stream";
import type { Context, Handler } from "hono"; import type { Context, Handler } from "hono";
import { stripBasePath } from "../../scripts/basePath.mjs"; import { stripBasePath } from "../../scripts/basePath.mjs";
/*
* Files that must not be served from anybody's cache, the way index.html is
* not.
*
* They went out with `max-age=3600` because they are neither hashed assets nor
* HTML, and an hour looks harmless. It is not, for two of them, and a CDN in
* front makes it worse: on a deploy the origin had the new build while
* Cloudflare went on handing out the previous `sw.js` for hours, with
* `cf-cache-status: HIT` and an edge TTL of its own that was longer than what
* we asked for. Caught on the 2026-09-08 deploy, where the new worker was live
* at the origin and the old one was still being installed by every browser
* that asked.
*
* What that costs is specific rather than general. The service worker is the
* app's whole update mechanism: a stale one keeps serving the shell it knows
* and never learns there is a newer build, so the deploy simply does not
* arrive. And a manifest and a worker that disagree is worse than either being
* old -- a fresh manifest advertising a share target to the operating system,
* answered by a worker that has never heard of one, sends the share to the
* server for a 405.
*
* `no-cache` does not mean "do not store": the browser and the CDN may both
* keep it and revalidate, which is a 304 and costs nothing. It means neither
* gets to serve it without asking first, which is the whole requirement.
*/
function isNeverStale(rel: string, ext: string): boolean {
return ext === ".webmanifest" || rel === "/sw.js" || rel === "sw.js";
}
const MIME: Record<string, string> = { const MIME: Record<string, string> = {
".html": "text/html; charset=utf-8", ".html": "text/html; charset=utf-8",
".js": "text/javascript; charset=utf-8", ".js": "text/javascript; charset=utf-8",
@@ -116,7 +145,7 @@ export function staticHandler(root: string, basePath = ""): Handler {
c.header("Content-Length", String(st.size)); c.header("Content-Length", String(st.size));
if (rel.startsWith("/assets/") || rel.startsWith("assets/")) { if (rel.startsWith("/assets/") || rel.startsWith("assets/")) {
c.header("Cache-Control", "public, max-age=31536000, immutable"); c.header("Cache-Control", "public, max-age=31536000, immutable");
} else if (ext === ".html") { } else if (ext === ".html" || isNeverStale(rel, ext)) {
c.header("Cache-Control", "no-cache"); c.header("Cache-Control", "no-cache");
c.header("Content-Security-Policy", APP_CSP); c.header("Content-Security-Policy", APP_CSP);
} else { } else {
+81
View File
@@ -0,0 +1,81 @@
import { test } from "node:test";
import assert from "node:assert/strict";
import { mkdtempSync, writeFileSync, mkdirSync } from "node:fs";
import { tmpdir } from "node:os";
import { join } from "node:path";
/*
* What may be served stale, and what may not.
*
* This is not a preference about freshness. The service worker is the app's
* whole update mechanism: a browser holding an old one goes on being served
* the shell that worker knows and never finds out a deploy happened. On
* 2026-09-08 the origin had the new build while Cloudflare handed out the
* previous `sw.js` for hours, because it was neither a hashed asset nor HTML
* and so went out with an hour's max-age that the CDN then extended.
*
* A static root of our own, since CI runs the tests before the build and
* `web/dist` does not exist yet.
*/
const root = mkdtempSync(join(tmpdir(), "ihasmail-cache-"));
mkdirSync(join(root, "assets"));
writeFileSync(join(root, "assets", "app-a1b2c3.js"), "console.log(1)\n");
writeFileSync(join(root, "sw.js"), "/* worker */\n");
writeFileSync(join(root, "manifest.webmanifest"), `{"name":"ihasmail"}`);
writeFileSync(join(root, "index.html"), "<!doctype html><title>t</title>");
writeFileSync(join(root, "img.png"), "not really a png");
process.env.STATIC_DIR = root;
process.env.STALWART_URL = "http://127.0.0.1:1";
const { createApp } = await import("./app.js");
const cacheControl = async (path: string) => {
const res = await createApp().request(path);
assert.equal(res.status, 200, `${path} should be served`);
return res.headers.get("cache-control") ?? "";
};
test("the service worker is never served from a cache without asking", async () => {
// `no-cache` permits storing it and requires revalidating it, which is a 304
// and costs nothing. What it forbids is a browser or a CDN answering with
// its own copy, which is the whole failure.
assert.match(await cacheControl("/sw.js"), /no-cache/);
});
test("nor is the manifest, which the worker has to agree with", async () => {
// A fresh manifest advertising a share target, answered by a worker that has
// never heard of one, sends the share to the server for a 405. Either being
// old is survivable; the two disagreeing is not.
assert.match(await cacheControl("/manifest.webmanifest"), /no-cache/);
});
test("the manifest is still served as a manifest", async () => {
const res = await createApp().request("/manifest.webmanifest");
assert.match(res.headers.get("content-type") ?? "", /application\/manifest\+json/);
});
test("index.html was already revalidated, and still is", async () => {
assert.match(await cacheControl("/"), /no-cache/);
});
test("hashed assets are still immutable for a year", async () => {
// The name changes when the bytes do, so there is nothing to go stale --
// and this is the caching that makes the app load quickly at all.
const cc = await cacheControl("/assets/app-a1b2c3.js");
assert.match(cc, /immutable/);
assert.match(cc, /max-age=31536000/);
});
test("everything else keeps its ordinary hour", async () => {
// The rule is narrow on purpose: two files, named, rather than a policy that
// quietly stops the icons and fonts being cached too.
assert.match(await cacheControl("/img.png"), /max-age=3600/);
});
test("under a prefix, the worker is still the worker", async () => {
// The mount comes off before the path is matched, so this has to hold for a
// subpath deployment as well -- where a stale worker is exactly as bad.
const res = await createApp("/mail").request("/mail/sw.js");
assert.equal(res.status, 200);
assert.match(res.headers.get("cache-control") ?? "", /no-cache/);
});
+44 -11
View File
@@ -132,11 +132,21 @@ export interface AccountInfo {
locale: string | null; locale: string | null;
/** "oss" | "community" | "enterprise", where the server reports it. */ /** "oss" | "community" | "enterprise", where the server reports it. */
edition: string | null; edition: string | null;
/**
* The account's effective permissions, as Stalwart reports them for the
* credential in use. Empty when the server would not say.
*
* Carried to the browser so it can offer only what the account may do --
* administration above all. It is never a grant: Stalwart checks every call
* it is sent, and a list that is stale or wrong costs a refused request, not
* access.
*/
permissions: string[];
} }
const infoCache = new Map<string, { info: AccountInfo; fetchedAt: number }>(); const infoCache = new Map<string, { info: AccountInfo; fetchedAt: number }>();
const INFO_CACHE_MS = 30 * 60_000; const INFO_CACHE_MS = 30 * 60_000;
const EMPTY_INFO: AccountInfo = { locale: null, edition: null }; const EMPTY_INFO: AccountInfo = { locale: null, edition: null, permissions: [] };
/** /**
* glibc modifiers that name a script rather than a dialect or a currency: * glibc modifiers that name a script rather than a dialect or a currency:
@@ -198,7 +208,9 @@ async function fetchAccountInfo(authorization: string, session: UpstreamSession)
session.primaryAccounts?.["urn:ietf:params:jmap:mail"] ?? session.primaryAccounts?.["urn:ietf:params:jmap:mail"] ??
Object.keys(session.accounts ?? {})[0]; Object.keys(session.accounts ?? {})[0];
if (!accountId) return EMPTY_INFO; if (!accountId) return EMPTY_INFO;
const res = await fetch(absoluteUpstream(session.apiUrl), { // Against the server that issued this session, not the default: with a
// domain mapped elsewhere, the default has never heard of the account.
const res = await fetch(absoluteUpstream(session.apiUrl, session.baseUrl), {
method: "POST", method: "POST",
headers: { authorization, "content-type": "application/json", accept: "application/json" }, headers: { authorization, "content-type": "application/json", accept: "application/json" },
body: JSON.stringify({ body: JSON.stringify({
@@ -226,7 +238,7 @@ async function fetchAccountInfo(authorization: string, session: UpstreamSession)
export function interpretAccountInfo(responses: [string, Record<string, unknown>, string][]): AccountInfo { export function interpretAccountInfo(responses: [string, Record<string, unknown>, string][]): AccountInfo {
const settings = responses.find((r) => r[2] === "s"); const settings = responses.find((r) => r[2] === "s");
const account = responses.find((r) => r[2] === "a"); const account = responses.find((r) => r[2] === "a");
return { locale: localeOf(settings) ?? localeOf(account), edition: null }; return { locale: localeOf(settings) ?? localeOf(account), edition: null, permissions: [] };
} }
function localeOf(call: [string, Record<string, unknown>, string] | undefined): string | null { function localeOf(call: [string, Record<string, unknown>, string] | undefined): string | null {
@@ -237,30 +249,51 @@ function localeOf(call: [string, Record<string, unknown>, string] | undefined):
} }
/** /**
* Which edition the server is running. Stalwart deliberately does not publish * Permission names in the form the source serialises them.
* its version number to clients, but 0.16 does report its edition here. *
* Stalwart 0.16 builds `/api/account`'s list from the same enum as everything
* else, which serialises as camelCase (`sysAccountGet`). Its documentation and
* OpenAPI example show kebab-case (`sys-account-get`) instead. Until a live
* server settles which is true, both are read as the one form, so a check
* written against `sysAccountGet` holds either way.
*/ */
async function fetchEdition(authorization: string, base: string): Promise<string | null> { export function normalizePermission(name: string): string {
return name.includes("-") ? name.replace(/-([a-z0-9])/g, (_m, c: string) => c.toUpperCase()) : name;
}
/**
* What the server says about the signed-in account: its edition and its
* effective permissions. Stalwart deliberately does not publish its version
* number to clients, but 0.16 reports both of these here.
*/
async function fetchServerAccount(authorization: string, base: string): Promise<Pick<AccountInfo, "edition" | "permissions">> {
try { try {
const res = await fetch(`${base}/api/account`, { const res = await fetch(`${base}/api/account`, {
headers: { authorization, accept: "application/json" }, headers: { authorization, accept: "application/json" },
signal: AbortSignal.timeout(config.upstreamTimeout), signal: AbortSignal.timeout(config.upstreamTimeout),
}); });
if (!res.ok) return null; if (!res.ok) return { edition: null, permissions: [] };
const body = (await res.json()) as { edition?: unknown }; return interpretServerAccount(await res.json());
return typeof body.edition === "string" ? body.edition : null;
} catch { } catch {
return null; return { edition: null, permissions: [] };
} }
} }
export function interpretServerAccount(body: unknown): Pick<AccountInfo, "edition" | "permissions"> {
const b = (body ?? {}) as { edition?: unknown; permissions?: unknown };
const permissions = Array.isArray(b.permissions)
? [...new Set(b.permissions.filter((p): p is string => typeof p === "string").map(normalizePermission))]
: [];
return { edition: typeof b.edition === "string" ? b.edition : null, permissions };
}
export async function getAccountInfo(sessionId: string, authorization: string, session: UpstreamSession): Promise<AccountInfo> { export async function getAccountInfo(sessionId: string, authorization: string, session: UpstreamSession): Promise<AccountInfo> {
const cached = infoCache.get(sessionId); const cached = infoCache.get(sessionId);
if (cached && Date.now() - cached.fetchedAt < INFO_CACHE_MS) return cached.info; if (cached && Date.now() - cached.fetchedAt < INFO_CACHE_MS) return cached.info;
let info = EMPTY_INFO; let info = EMPTY_INFO;
try { try {
info = await fetchAccountInfo(authorization, session); info = await fetchAccountInfo(authorization, session);
info = { ...info, edition: await fetchEdition(authorization, session.baseUrl) }; info = { ...info, ...(await fetchServerAccount(authorization, session.baseUrl)) };
} catch { } catch {
/* all of this is a nicety - never fail the session over it */ /* all of this is a nicety - never fail the session over it */
} }
+7 -7
View File
@@ -13,22 +13,22 @@
}, },
"dependencies": { "dependencies": {
"@tanstack/react-virtual": "^3.13.2", "@tanstack/react-virtual": "^3.13.2",
"dompurify": "^3.2.4", "dompurify": "^3.4.15",
"lucide-react": "^0.477.0", "lucide-react": "^0.477.0",
"marked": "^18.0.11", "marked": "^18.0.11",
"qrcode-generator": "^2.0.4", "qrcode-generator": "^2.0.4",
"react": "^19.0.0", "react": "^19.0.0",
"react-dom": "^19.0.0", "react-dom": "^19.0.0",
"wouter": "^3.6.0", "wouter": "^3.11.0",
"zustand": "^5.0.3" "zustand": "^5.0.3"
}, },
"devDependencies": { "devDependencies": {
"@types/react": "^19.0.10", "@types/react": "^19.0.10",
"@types/react-dom": "^19.0.4", "@types/react-dom": "^19.2.7",
"@vitejs/plugin-react": "^4.3.4", "@vitejs/plugin-react": "^6.1.1",
"jsdom": "^26.0.0", "jsdom": "^26.0.0",
"typescript": "^5.7.3", "typescript": "^7.0.2",
"vite": "^6.2.0", "vite": "^8.3.0",
"vitest": "^3.0.8" "vitest": "^4.1.11"
} }
} }
+34
View File
@@ -3,8 +3,42 @@
"short_name": "ihasmail", "short_name": "ihasmail",
"description": "Fast, friendly JMAP webmail for Stalwart", "description": "Fast, friendly JMAP webmail for Stalwart",
"_comment": "JSON has no comments, so: every URL below is relative on purpose. Manifest members resolve against the manifest's own address, so these follow BASE_PATH with nothing substituted into them at build time. Root-absolute values pinned the installed app, its scope and its shortcuts to the domain root whatever the mount was.", "_comment": "JSON has no comments, so: every URL below is relative on purpose. Manifest members resolve against the manifest's own address, so these follow BASE_PATH with nothing substituted into them at build time. Root-absolute values pinned the installed app, its scope and its shortcuts to the domain root whatever the mount was.",
"_comment_id": "There is deliberately no `id`. It is the one member NOT resolved against this file's address -- the spec resolves it against the origin of start_url, so `./`, `mail` and `/mail` all mean the same thing at the domain root and none of them can name a subpath mount. Adding one would therefore break the same thing the note above describes. Worse, the default id IS start_url, which is already mount-correct: writing an id now would give every installed copy a new identity and orphan it as a second app rather than updating it. If one is ever wanted it has to be substituted at build time from BASE_PATH, and the changeover costs everybody their install.",
"start_url": "mail", "start_url": "mail",
"scope": "./", "scope": "./",
"categories": ["productivity", "utilities"],
"_comment_launch": "One window, not one per launch. A `mailto:` link, a manifest shortcut or a notification tapped while ihasmail is already open should arrive in the copy that is running rather than beside it -- two windows on the same inbox disagree about what has been read. `navigate-existing` rather than `focus-existing` because the latter only focuses and leaves the app to handle the target URL through launchQueue, which nothing here consumes: it would swallow the mailto entirely. The navigation goes through the same beforeunload guard as a reload, so an unsent draft still stops it and asks.",
"launch_handler": {
"client_mode": "navigate-existing"
},
"_comment_share_target": "Being in the operating system's share sheet, which is the other half of the Share this app now offers. `action` is relative like everything else here, so it follows the mount; it has to sit inside `scope`, and `./` covers it. POST with multipart because a share can carry files, and a POST to a page is not something the app can answer -- the service worker intercepts it, puts the payload where a tab can collect it, and redirects. `accept` names wildcard families AND explicit types and extensions on purpose: a mail client attaches anything, but wildcard support is not in the specification and operating systems differ over which form they match on, so the explicit list is what holds if the families are ignored. Android and Chromium only -- iOS does not implement share targets at all.",
"share_target": {
"action": "share",
"method": "POST",
"enctype": "multipart/form-data",
"params": {
"title": "title",
"text": "text",
"url": "url",
"files": [
{
"name": "files",
"accept": [
"image/*", "video/*", "audio/*", "text/*",
"application/pdf", "application/zip", "application/json",
"application/msword", "application/vnd.openxmlformats-officedocument.wordprocessingml.document",
"application/vnd.ms-excel", "application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",
"application/vnd.ms-powerpoint", "application/vnd.openxmlformats-officedocument.presentationml.presentation",
"application/vnd.oasis.opendocument.text", "application/vnd.oasis.opendocument.spreadsheet",
"message/rfc822", "text/calendar", "text/vcard",
".pdf", ".zip", ".doc", ".docx", ".xls", ".xlsx", ".ppt", ".pptx",
".odt", ".ods", ".csv", ".txt", ".md", ".eml", ".ics", ".vcf",
".jpg", ".jpeg", ".png", ".gif", ".webp", ".heic", ".mp4", ".mp3"
]
}
]
}
},
"protocol_handlers": [ "protocol_handlers": [
{ {
"protocol": "mailto", "protocol": "mailto",
+227 -13
View File
@@ -30,8 +30,74 @@ self.addEventListener("activate", (event) => {
); );
}); });
/*
* Where a share from the operating system is left for a tab to collect.
*
* Absolute and anchored to the mount, for the same reason the verification key
* below is: a relative key is resolved against the URL of whoever asks, and the
* worker and a tab deep in `/mail/inbox/…` are not at the same place.
*
* The files go in one entry each and the rest in a JSON index beside them,
* because the Cache API stores Responses and a File is already one body.
*/
const SHARE_KEY = `${BASE}/ihasmail-share`;
const SHARE_MAX_FILES = 20;
/*
* Take delivery of a share.
*
* This is a POST that navigates: the operating system submits a form at the
* app and expects a page back. Nothing in ihasmail can answer it directly --
* the app is a client-side router with no endpoint at that address, and the
* server behind it would have to grow one that understood the composer. So the
* worker takes the body, puts it where a tab can find it, and redirects to the
* app, which then opens a draft holding it.
*
* The redirect happens whatever went wrong. A share that fails to stash costs
* whatever was being shared, which is bad; a share that fails to *respond*
* costs that and leaves the reader looking at a browser error page where they
* expected their mail, which is worse.
*
* There is one case this cannot cover, and the server is deliberately not
* taught to: an app still installed whose worker has been cleared away. The
* POST then reaches the server, which answers 405, and the share is lost
* either way -- the payload only ever existed in that request body. A server
* route would trade a plain error for a silent nothing, and a share that
* vanishes without saying so is the harder of the two to notice.
*/
async function stashShare(request) {
try {
const form = await request.formData();
const cache = await caches.open(VERSION);
const meta = {
at: Date.now(),
title: String(form.get("title") ?? ""),
text: String(form.get("text") ?? ""),
url: String(form.get("url") ?? ""),
files: [],
};
const files = form.getAll("files").filter((f) => f && typeof f === "object" && "name" in f && f.size > 0);
for (const [i, f] of files.slice(0, SHARE_MAX_FILES).entries()) {
const key = `${SHARE_KEY}/${i}`;
await cache.put(key, new Response(f, { headers: { "content-type": f.type || "application/octet-stream" } }));
meta.files.push({ key, name: f.name || `file-${i + 1}`, type: f.type || "application/octet-stream" });
}
await cache.put(SHARE_KEY, new Response(JSON.stringify(meta), { headers: { "content-type": "application/json" } }));
} catch {
/* nothing to hand on: the app opens on an empty inbox rather than an error */
}
// Absolute, because `Response.redirect` rejects a bare path outright rather
// than resolving it -- so `${BASE}/mail` would throw here and the share
// would end at a browser error page instead of the inbox.
return Response.redirect(new URL(`${BASE}/mail?share=1`, self.location.origin).href, 303);
}
self.addEventListener("fetch", (event) => { self.addEventListener("fetch", (event) => {
const req = event.request; const req = event.request;
if (req.method === "POST" && new URL(req.url).pathname === `${BASE}/share`) {
event.respondWith(stashShare(req));
return;
}
if (req.method !== "GET") return; if (req.method !== "GET") return;
const url = new URL(req.url); const url = new URL(req.url);
if (url.origin !== self.location.origin) return; if (url.origin !== self.location.origin) return;
@@ -64,14 +130,23 @@ self.addEventListener("fetch", (event) => {
/* /*
* Stalwart signs with VAPID and pushes straight to the browser's push service; * Stalwart signs with VAPID and pushes straight to the browser's push service;
* nothing here talks to ihasmail's server. The payload is an EmailPush object * nothing here talks to ihasmail's server on the way in. The payload is an
* (draft-ietf-jmap-emailpush) carrying enough of the message to show a useful * EmailPush object (draft-ietf-jmap-emailpush) carrying enough of the message
* notification without a round-trip which matters, because when this fires * to show a useful notification without a round-trip, which is what lets a
* there may be no session to make one with. * notification appear immediately rather than after a request.
*
* This file used to say that a round-trip was impossible here, and it was
* wrong: see the note on `jmap()`. What it can do is ask; what it cannot do is
* be sure of an answer, since the session may be gone by the time it does. So
* the payload still carries the message and the request is only made when
* somebody presses something.
* *
* A JMAP subscription also delivers a PushVerification first, and stays silent * A JMAP subscription also delivers a PushVerification first, and stays silent
* until the client echoes its code back. That cannot be done from here (no * until the client echoes its code back. It is stashed for a tab to confirm
* credentials), so it is stashed for a tab to collect and confirm. * rather than answered here on the same reasoning, and because a
* verification that failed silently would leave push looking broken with
* nothing to show for it. Answering it directly is now possible and is worth
* revisiting.
*/ */
/* /*
@@ -87,13 +162,90 @@ self.addEventListener("fetch", (event) => {
*/ */
const VERIFY_KEY = `${BASE}/ihasmail-push-verification`; const VERIFY_KEY = `${BASE}/ihasmail-push-verification`;
function textOf(email) { /*
* What a tab wrote down for this worker: the account, which mailbox is the
* archive, and the worker's own text in the reader's language. See
* `lib/swFacts.ts` for why any of that has to be handed over rather than
* worked out here.
*
* Everything that depends on it is skipped when it is missing, which is the
* state between installing this worker and next opening the app. An action
* button with no label, or one that files mail into a mailbox guessed by name,
* is worse than the notification that was here before.
*/
const FACTS_KEY = `${BASE}/ihasmail-worker-facts`;
async function readFacts() {
try {
const hit = await (await caches.open(VERSION)).match(FACTS_KEY);
return hit ? await hit.json() : null;
} catch {
return null;
}
}
/*
* A JMAP call, made as the reader.
*
* This worker was written believing it could not do this -- that acting on
* mail needed a session it had no way to hold. It does not: ihasmail's session
* is an httpOnly cookie against its own origin, and the only other thing the
* API asks for is a fixed `x-requested-with` header that is not a secret and
* is not held anywhere. A same-origin fetch from here carries the cookie like
* any other, so `Email/set` from a notification is an ordinary request.
*
* What is genuinely not available is anything the *tab* holds in memory, and
* the answer is that the API asks for none of it.
*
* The session can still be gone -- expired, signed out, or a cookie that did
* not survive the browser closing -- which arrives as a 401 and is reported
* rather than swallowed. A tap that silently does nothing is the failure worth
* avoiding here: the reader has already put the phone down.
*/
async function jmap(methodCalls) {
const res = await fetch(`${BASE}/api/jmap`, {
method: "POST",
credentials: "same-origin",
headers: { "content-type": "application/json", accept: "application/json", "x-requested-with": "ihasmail" },
body: JSON.stringify({ using: ["urn:ietf:params:jmap:core", "urn:ietf:params:jmap:mail"], methodCalls }),
});
if (!res.ok) throw new Error(`HTTP ${res.status}`);
const body = await res.json();
// A JMAP method can fail inside a 200. Treat that as a failure too, rather
// than reporting success because the transport was fine.
const first = body?.methodResponses?.[0];
if (!first || first[0] === "error") throw new Error(first?.[1]?.type || "error");
const notUpdated = first[1]?.notUpdated;
if (notUpdated && Object.keys(notUpdated).length) throw new Error("notUpdated");
return body;
}
function textOf(email, strings) {
const from = email?.from?.[0]; const from = email?.from?.[0];
const who = from?.name || from?.email || "New message"; const who = from?.name || from?.email || strings.newMessage;
const what = email?.subject || "(no subject)"; const what = email?.subject || strings.noSubject;
return { title: who, body: what, preview: email?.preview || "" }; return { title: who, body: what, preview: email?.preview || "" };
} }
/*
* Two, because that is what a phone shows. `Notification.maxActions` is 2 on
* Android Chrome, and anything past it is dropped silently -- so these are the
* two worth having rather than the two that happened to come first. Both are
* triage: they are what somebody does to a notification they have read the
* whole of on the lock screen and does not need to open.
*
* Reply is deliberately not among them. It cannot be done from here, so it
* would have to open the app -- and an action that opens the app is what
* tapping the notification already does.
*/
function actionsFor(facts) {
if (!facts) return [];
const actions = [];
if (facts.archiveId) actions.push({ action: "archive", title: facts.strings.archive });
actions.push({ action: "read", title: facts.strings.markRead });
return actions;
}
self.addEventListener("push", (event) => { self.addEventListener("push", (event) => {
let data = null; let data = null;
try { try {
@@ -120,10 +272,24 @@ self.addEventListener("push", (event) => {
const emails = (data && data["@type"] === "EmailPush" && Array.isArray(data.emails)) ? data.emails : []; const emails = (data && data["@type"] === "EmailPush" && Array.isArray(data.emails)) ? data.emails : [];
event.waitUntil((async () => { event.waitUntil((async () => {
const facts = await readFacts();
const strings = facts?.strings ?? { newMail: "New mail", newMessage: "New message", noSubject: "(no subject)" };
/*
* Mark the app icon, without claiming a number.
*
* `setAppBadge()` with no count shows a dot rather than a figure, which is
* the only honest thing to show from here: this worker has no session, so
* it cannot ask how many messages are unread, and a push carries the new
* mail rather than a total. Counting the payload would badge "2" over an
* inbox holding forty. The next time a tab opens, `setUnreadBadge` writes
* the real count over the dot.
*/
if ("setAppBadge" in self.navigator) await self.navigator.setAppBadge().catch(() => {});
if (!emails.length) { if (!emails.length) {
// A StateChange, or a payload too large to carry the message. Say // A StateChange, or a payload too large to carry the message. Say
// something true rather than inventing a sender. // something true rather than inventing a sender.
await self.registration.showNotification("New mail", { await self.registration.showNotification(strings.newMail, {
icon: `${BASE}/img/icon-192.png`, badge: `${BASE}/img/favicon-64.png`, tag: "ihasmail-mail", data: { url: `${BASE}/mail` }, icon: `${BASE}/img/icon-192.png`, badge: `${BASE}/img/favicon-64.png`, tag: "ihasmail-mail", data: { url: `${BASE}/mail` },
}); });
return; return;
@@ -131,21 +297,69 @@ self.addEventListener("push", (event) => {
// One notification per message, collapsing repeats of the same message by // One notification per message, collapsing repeats of the same message by
// tag so a re-push does not stack. // tag so a re-push does not stack.
for (const email of emails.slice(0, 5)) { for (const email of emails.slice(0, 5)) {
const { title, body, preview } = textOf(email); const { title, body, preview } = textOf(email, strings);
await self.registration.showNotification(title, { await self.registration.showNotification(title, {
body: preview ? `${body}\n${preview}` : body, body: preview ? `${body}\n${preview}` : body,
icon: `${BASE}/img/icon-192.png`, icon: `${BASE}/img/icon-192.png`,
badge: `${BASE}/img/favicon-64.png`, badge: `${BASE}/img/favicon-64.png`,
tag: `ihasmail-${email.id || body}`, tag: `ihasmail-${email.id || body}`,
data: { url: email.id ? `${BASE}/mail/inbox/${email.id}` : `${BASE}/mail` }, // Only where there is a message to act on: a payload without an id can
// be shown but not archived, and a button that cannot work should not
// be drawn.
actions: email.id ? actionsFor(facts) : [],
data: {
url: email.id ? `${BASE}/mail/inbox/${email.id}` : `${BASE}/mail`,
id: email.id || null,
title,
accountId: facts?.accountId ?? null,
archiveId: facts?.archiveId ?? null,
failed: strings.failed ?? null,
},
}); });
} }
})()); })());
}); });
/*
* Do what the button said, without opening anything.
*
* The whole point of an action is that the phone goes back in the pocket, so
* this must not fall back to opening the app when the call fails -- that is
* the same interruption the action existed to avoid. It re-notifies instead,
* saying it did not happen, and leaves opening ihasmail to the reader.
*
* Archiving replaces the mailbox set rather than adding to it, which is what
* archiving is: the message leaves the inbox. Marking read is a keyword and
* touches nothing else.
*/
async function runAction(action, data) {
const { id, accountId, archiveId } = data;
if (!id || !accountId) return;
const patch = action === "archive"
? { mailboxIds: { [archiveId]: true } }
: { "keywords/$seen": true };
try {
if (action === "archive" && !archiveId) throw new Error("no archive mailbox");
await jmap([["Email/set", { accountId, update: { [id]: patch } }, "0"]]);
} catch {
await self.registration.showNotification(data.title || "ihasmail", {
body: data.failed || "Could not do that — open ihasmail and try again",
icon: `${BASE}/img/icon-192.png`,
badge: `${BASE}/img/favicon-64.png`,
tag: `ihasmail-failed-${id}`,
data: { url: data.url },
});
}
}
self.addEventListener("notificationclick", (event) => { self.addEventListener("notificationclick", (event) => {
event.notification.close(); event.notification.close();
const url = event.notification.data?.url || `${BASE}/mail`; const data = event.notification.data || {};
if (event.action === "archive" || event.action === "read") {
event.waitUntil(runAction(event.action, data));
return;
}
const url = data.url || `${BASE}/mail`;
event.waitUntil((async () => { event.waitUntil((async () => {
const clients = await self.clients.matchAll({ includeUncontrolled: true, type: "window" }); const clients = await self.clients.matchAll({ includeUncontrolled: true, type: "window" });
// Reuse a tab if one is open rather than piling up windows. Same origin is // Reuse a tab if one is open rather than piling up windows. Same origin is
+19
View File
@@ -17,6 +17,7 @@ import { AppShell } from "@/views/AppShell";
import { MailView } from "@/views/mail/MailView"; import { MailView } from "@/views/mail/MailView";
import { ComposerDock } from "@/views/compose/ComposerDock"; import { ComposerDock } from "@/views/compose/ComposerDock";
import { setUnreadBadge } from "@/lib/notify"; import { setUnreadBadge } from "@/lib/notify";
import { publishWorkerFacts } from "@/lib/swFacts";
import { PAINTED_FROM_CACHE, useSettings, syncedPart } from "@/store/settings"; import { PAINTED_FROM_CACHE, useSettings, syncedPart } from "@/store/settings";
import { armSettingsSync, loadRemoteSettings, queueSettingsPush, settingsAlreadyLoadedFor, settingsSyncAvailable } from "@/lib/settingsSync"; import { armSettingsSync, loadRemoteSettings, queueSettingsPush, settingsAlreadyLoadedFor, settingsSyncAvailable } from "@/lib/settingsSync";
import { loadSettingsPolicy } from "@/lib/settingsPolicy"; import { loadSettingsPolicy } from "@/lib/settingsPolicy";
@@ -30,6 +31,8 @@ const ContactsView = lazy(() => import("@/views/contacts/ContactsView").then((m)
const CalendarView = lazy(() => import("@/views/calendar/CalendarView").then((m) => ({ default: m.CalendarView }))); const CalendarView = lazy(() => import("@/views/calendar/CalendarView").then((m) => ({ default: m.CalendarView })));
const FilesView = lazy(() => import("@/views/files/FilesView").then((m) => ({ default: m.FilesView }))); const FilesView = lazy(() => import("@/views/files/FilesView").then((m) => ({ default: m.FilesView })));
const SettingsView = lazy(() => import("@/views/settings/SettingsView").then((m) => ({ default: m.SettingsView }))); const SettingsView = lazy(() => import("@/views/settings/SettingsView").then((m) => ({ default: m.SettingsView })));
// Only ever opened by the few who administer, so nobody else downloads it.
const AdminView = lazy(() => import("@/views/admin/AdminView").then((m) => ({ default: m.AdminView })));
export function App() { export function App() {
const status = useSession((s) => s.status); const status = useSession((s) => s.status);
@@ -263,6 +266,21 @@ function AuthedApp() {
}); });
}, [inboxUnread, appName]); }, [inboxUnread, appName]);
/*
* Leave the service worker its briefing.
*
* Written from here rather than once at startup because everything in it can
* change while the app is open -- the language from Settings, the archive
* folder from the mailbox list arriving -- and what is written is what the
* worker will still be reading a week from now, with no tab to correct it.
* See lib/swFacts.ts.
*/
const archiveId = useMail((s) => s.roleId("archive"));
const languageVersion = useLanguageVersion();
useEffect(() => {
void publishWorkerFacts(accountId, archiveId);
}, [accountId, archiveId, languageVersion]);
// Request notification permission lazily when enabled // Request notification permission lazily when enabled
const notif = useSettings((s) => s.settings.desktopNotifications); const notif = useSettings((s) => s.settings.desktopNotifications);
useEffect(() => { useEffect(() => {
@@ -289,6 +307,7 @@ function AuthedApp() {
<Route path="/calendar/:view?/:date?">{(p) => <CalendarView view={p.view} date={p.date} />}</Route> <Route path="/calendar/:view?/:date?">{(p) => <CalendarView view={p.view} date={p.date} />}</Route>
<Route path="/files/:nodeId?">{(p) => <FilesView nodeId={p.nodeId} />}</Route> <Route path="/files/:nodeId?">{(p) => <FilesView nodeId={p.nodeId} />}</Route>
<Route path="/settings/:section?">{(p) => <SettingsView section={p.section} />}</Route> <Route path="/settings/:section?">{(p) => <SettingsView section={p.section} />}</Route>
<Route path="/admin/:section?/:id?">{(p) => <AdminView section={p.section} id={p.id} />}</Route>
<Route path="/login"> <Route path="/login">
<Redirect to="/mail" /> <Redirect to="/mail" />
</Route> </Route>
+6
View File
@@ -19,6 +19,9 @@ export const CAP = {
websocket: "urn:ietf:params:jmap:websocket", websocket: "urn:ietf:params:jmap:websocket",
} as const; } as const;
/** Stalwart's own capability, which carries its `x:` registry methods. */
export const STALWART_CAP = "urn:stalwart:jmap";
export class JmapMethodError extends Error { export class JmapMethodError extends Error {
constructor( constructor(
public readonly method: string, public readonly method: string,
@@ -349,6 +352,9 @@ export class JmapClient {
/** Map method name prefix → required capability URNs. */ /** Map method name prefix → required capability URNs. */
function usingFor(method: string): string[] { function usingFor(method: string): string[] {
const type = method.split("/")[0] ?? ""; const type = method.split("/")[0] ?? "";
// Stalwart's registry: accounts, domains, credentials. Advertised per
// account rather than in the session, which supportedUsing() allows for.
if (type.startsWith("x:")) return [STALWART_CAP];
switch (type) { switch (type) {
case "Mailbox": case "Mailbox":
case "Thread": case "Thread":
+13
View File
@@ -39,6 +39,19 @@ export interface JmapSession {
/** "oss" | "community" | "enterprise". Stalwart publishes no version. */ /** "oss" | "community" | "enterprise". Stalwart publishes no version. */
edition?: string | null; edition?: string | null;
}; };
/**
* False when this session may not administer: the operator turned it off,
* or the session was signed in without "This is my own device".
*/
administration?: boolean;
/** An administrator on a device not marked as their own; the menu says so. */
administrationNeedsOwnDevice?: boolean;
/**
* The account's effective permissions on that server, as Stalwart reports
* them. What the client offers is shaped by these; what is allowed is
* decided by Stalwart on every call.
*/
permissions?: string[];
}; };
} }
+95
View File
@@ -0,0 +1,95 @@
import { describe, expect, it } from "vitest";
import { ADMIN_BASELINE, adminSections, can, canGrantRole, generatePassword, hasAdministration, outranks, permissionSet, resolveRoles, type RoleDef } from "@/lib/adminAccess";
const set = (...p: string[]) => permissionSet(p);
const everything = set(...ADMIN_BASELINE, "sysTenantGet", "jmapEmailGet", "impersonate");
const helpdesk = set("sysAccountGet", "sysAccountQuery", "sysAccountUpdate", "jmapEmailGet");
const roles = new Map<string, RoleDef>([
["user", { id: "user", enabledPermissions: { jmapEmailGet: true } }],
["helpdesk", { id: "helpdesk", enabledPermissions: { sysAccountGet: true, sysAccountQuery: true, sysAccountUpdate: true }, roleIds: { user: true } }],
["dns", { id: "dns", enabledPermissions: { sysDnsServerUpdate: true }, roleIds: { user: true } }],
["loop", { id: "loop", enabledPermissions: {}, roleIds: { loop: true } }],
]);
describe("who is offered administration", () => {
it("needs both halves of reading the account list", () => {
expect(hasAdministration(set("sysAccountQuery", "sysAccountGet"))).toBe(true);
expect(hasAdministration(set("sysAccountQuery"))).toBe(false);
expect(hasAdministration(set("sysAccountGet"))).toBe(false);
expect(hasAdministration(permissionSet(undefined))).toBe(false);
});
it("offers each section only with both halves of reading it", () => {
expect(adminSections(set("sysDomainQuery", "sysDomainGet"))).toEqual(["domains"]);
expect(hasAdministration(set("sysDomainQuery", "sysDomainGet"))).toBe(true);
expect(adminSections(set("sysAccountQuery", "sysAccountGet", "sysDomainQuery"))).toEqual(["accounts"]);
});
it("reads one permission per object and operation", () => {
expect(can(helpdesk, "Account", "Update")).toBe(true);
expect(can(helpdesk, "Account", "Destroy")).toBe(false);
expect(can(helpdesk, "Domain", "Get")).toBe(false);
});
});
/**
* Stalwart checks a grant, but not a password change or a delete. Without this,
* anyone allowed to edit accounts could take over one that can do more.
*/
describe("an account that outranks the viewer", () => {
it("an ordinary user never does", () => {
expect(outranks(helpdesk, { roles: { "@type": "User" } }, null)).toBe(false);
expect(outranks(helpdesk, {}, null)).toBe(false);
});
it("an administrator does, unless the viewer is one too", () => {
expect(outranks(helpdesk, { roles: { "@type": "Admin" } }, roles)).toBe(true);
expect(outranks(everything, { roles: { "@type": "Admin" } }, roles)).toBe(false);
});
it("a custom role does when it carries something the viewer lacks", () => {
expect(outranks(helpdesk, { roles: { "@type": "Custom", roleIds: { helpdesk: true } } }, roles)).toBe(false);
expect(outranks(helpdesk, { roles: { "@type": "Custom", roleIds: { dns: true } } }, roles)).toBe(true);
});
it("a role that cannot be read counts against the target, not for it", () => {
expect(outranks(helpdesk, { roles: { "@type": "Custom", roleIds: { helpdesk: true } } }, null)).toBe(true);
expect(outranks(everything, { roles: { "@type": "Custom", roleIds: { gone: true } } }, roles)).toBe(true);
});
it("extra permissions on the account itself are counted", () => {
expect(outranks(helpdesk, { roles: { "@type": "User" }, permissions: { "@type": "Merge", enabledPermissions: { sysDomainDestroy: true } } }, roles)).toBe(true);
// Replace ignores the roles entirely, so only what it lists matters.
expect(outranks(helpdesk, { roles: { "@type": "Custom", roleIds: { dns: true } }, permissions: { "@type": "Replace", enabledPermissions: { jmapEmailGet: true } } }, roles)).toBe(false);
});
it("survives a role that names itself", () => {
expect(resolveRoles(["loop"], roles)).toEqual(new Set());
});
});
describe("granting a role", () => {
it("is offered only for roles whose every permission the viewer holds", () => {
expect(canGrantRole(helpdesk, "helpdesk", roles)).toBe(true);
expect(canGrantRole(helpdesk, "dns", roles)).toBe(false);
expect(canGrantRole(everything, "missing", roles)).toBe(false);
});
});
describe("generated passwords", () => {
it("are four groups of five unambiguous characters", () => {
const p = generatePassword();
expect(p).toMatch(/^[a-zA-Z2-9]{5}(-[a-zA-Z2-9]{5}){3}$/);
expect(p).not.toMatch(/[01lIO]/);
});
it("skip bytes that would favour the start of the alphabet", () => {
// 256 % 55 leaves 36 byte values over; a plain modulo would hand those to
// the first 36 characters twice as often. Bytes of 220 and up are dropped
// and more are drawn, so a batch of nothing but those costs a draw.
let call = 0;
const source = (n: number) => (call++ === 0 ? new Uint8Array(n).fill(250) : Uint8Array.from({ length: n }, (_, i) => i));
expect(generatePassword(source)).toBe("abcde-fghjk-mnpqr-stuvw");
expect(call).toBe(2);
});
});
@@ -0,0 +1,99 @@
import { describe, expect, it, vi } from "vitest";
import { client } from "@/jmap/client";
import { aliasList, describeDirectoryError, DirectoryError, hasPassword, passwordPatch, queryAccounts, quotasWithDisk } from "@/lib/adminDirectory";
describe("setting a password", () => {
it("writes into the existing password credential, keeping its place", () => {
const account = { credentials: { "0": { "@type": "AppPassword" as const }, "2": { "@type": "Password" as const, secret: "[********]" } } };
expect(passwordPatch(account, "new secret")).toEqual({ "credentials/2/secret": "new secret" });
});
it("adds one after the last index when the account has none", () => {
const account = { credentials: { "0": { "@type": "AppPassword" as const }, "3": { "@type": "ApiKey" as const } } };
expect(passwordPatch(account, "s")).toEqual({ "credentials/4": { "@type": "Password", secret: "s" } });
expect(passwordPatch({}, "s")).toEqual({ "credentials/0": { "@type": "Password", secret: "s" } });
expect(hasPassword(account)).toBe(false);
});
});
describe("lists written back", () => {
it("re-index aliases the way the server stores a list", () => {
expect(aliasList([{ name: "b", domainId: "d1" }, { name: "c", domainId: "d2", enabled: false }])).toEqual({
"0": { enabled: true, name: "b", domainId: "d1", description: null },
"1": { enabled: false, name: "c", domainId: "d2", description: null },
});
});
it("change the disk limit without touching the other quotas", () => {
expect(quotasWithDisk({ maxEmails: 10, maxDiskQuota: 5 }, 7)).toEqual({ maxEmails: 10, maxDiskQuota: 7 });
expect(quotasWithDisk({ maxEmails: 10, maxDiskQuota: 5 }, null)).toEqual({ maxEmails: 10 });
expect(quotasWithDisk(undefined, 0)).toEqual({});
});
});
describe("explaining a refusal", () => {
it("says what a taken address means", () => {
expect(describeDirectoryError(new DirectoryError("primaryKeyViolation", "exists"))).toMatch(/already in use/);
});
it("keeps the server's own words for a password policy", () => {
expect(describeDirectoryError(new DirectoryError("invalidProperties", "Password must be at least 8 characters long.", ["secret"]))).toContain("at least 8 characters");
});
it("handles a method-level refusal as well as a set error", () => {
expect(describeDirectoryError({ type: "forbidden", message: "x:Account/set: forbidden" })).toMatch(/refused/);
});
});
describe("the account query", () => {
it("filters on @type, the property's name on the object", async () => {
// A live 0.16 server answers a plain `type` with "unsupportedFilter - type"
// and fails the whole list, which is how this was found.
const call = vi.spyOn(client, "call").mockResolvedValue({ ids: [], total: 0 });
await queryAccounts({ type: "User", text: " ada ", position: 50, limit: 50 });
expect(call).toHaveBeenCalledWith("x:Account/query", { filter: { "@type": "User", text: "ada" }, position: 50, limit: 50, calculateTotal: true });
call.mockRestore();
});
});
/**
* Stalwart explains a refusal in English, and none of it should reach an
* interface in another language as it is. Each case below is a refusal a
* live server gave, or one its source says it gives.
*/
describe("refusals in the reader's language", () => {
it("recognises the registry's validators and says it again, without the server's words", () => {
// Live, 2026-09-13: a reserved TLD, and a catch-all without a domain.
const domain = describeDirectoryError(new DirectoryError("invalidPatch", "Invalid domain name", ["name"]), "domain");
expect(domain).toMatch(/isn't a valid domain name/);
expect(domain).not.toContain("Invalid domain name");
expect(describeDirectoryError(new DirectoryError("invalidPatch", "Invalid email address", ["catchAllAddress"]), "domain")).toMatch(/full address/);
expect(describeDirectoryError(new DirectoryError("invalidProperties", "Invalid email local part", ["name"]))).toMatch(/before the @/);
});
it("never echoes a description it does not know", () => {
const text = describeDirectoryError(new DirectoryError("invalidPatch", "Something only the server would say", ["whatever"]));
expect(text).not.toContain("Something only the server would say");
expect(describeDirectoryError(new DirectoryError("forbidden", "You are not allowed to do that thing"))).not.toContain("not allowed to do that thing");
expect(describeDirectoryError(new DirectoryError("someNewType", "Brand new English"))).not.toContain("Brand new English");
});
it("tells a grant refusal and a directory-backed account apart from a plain no", () => {
expect(describeDirectoryError(new DirectoryError("forbidden", "You are not authorized to grant permissions: sysDomainDestroy."))).toMatch(/permissions your own role/);
expect(describeDirectoryError(new DirectoryError("forbidden", "Cannot set credentials for accounts in an external directory."))).toMatch(/external directory/);
});
it("words a clash and a missing object for what it was about", () => {
expect(describeDirectoryError(new DirectoryError("primaryKeyViolation", undefined, ["name"]), "domain")).toMatch(/domain name is already in use/);
expect(describeDirectoryError(new DirectoryError("primaryKeyViolation", undefined))).toMatch(/address is already in use/);
expect(describeDirectoryError(new DirectoryError("notFound", undefined), "domain")).toMatch(/domain no longer exists/);
});
it("explains ihasmail's own refusals by their code, not their English message", () => {
const own = { status: 403, code: "administration_needs_own_device", message: "Administration is only available when signed in on a device marked as your own (x:Account/query)." };
expect(describeDirectoryError(own)).toMatch(/marked as your own/);
expect(describeDirectoryError(own)).not.toContain("x:Account/query");
expect(describeDirectoryError({ status: 403, code: "administration_disabled", message: "…" })).toMatch(/turned off/);
expect(describeDirectoryError({ method: "x:Account/query", type: "unsupportedFilter", message: "x:Account/query: unsupportedFilter - type" })).toBe("The mail server could not carry out the request (unsupportedFilter).");
});
});
@@ -0,0 +1,69 @@
import { describe, expect, it } from "vitest";
import { describeLinked, dkimAlgorithm, looksLikeDomain, normaliseDomain, parseZoneFile } from "@/lib/adminDomains";
/**
* Written the way Stalwart's BIND serialiser writes it (dns-update's
* `BindSerializer`): `name IN TYPE value`, and a TXT over 255 bytes as a
* parenthesised run of quoted chunks.
*/
const long = "v=DKIM1; k=rsa; h=sha256; p=" + "A".repeat(400);
const zone = [
"example.com. IN MX 10 mail.example.com.",
'example.com. IN TXT "v=spf1 mx ra=postmaster -all"',
"v1-rsa-20260601._domainkey.example.com. IN TXT (",
...(long.match(/.{1,255}/g) ?? []).map((c) => ` "${c}"`),
")",
'_dmarc.example.com. IN TXT "v=DMARC1; p=reject; rua=mailto:\\"postmaster\\"@example.com"',
"_jmap._tcp.example.com. IN SRV 0 1 443 mail.example.com.",
'example.com. IN CAA 0 issue "letsencrypt.org"',
"",
].join("\n");
describe("reading the zone file", () => {
const records = parseZoneFile(zone);
it("gives one row per record, without the root dot", () => {
expect(records.map((r) => r.type)).toEqual(["MX", "TXT", "TXT", "TXT", "SRV", "CAA"]);
expect(records[0]).toMatchObject({ name: "example.com", value: "10 mail.example.com." });
});
it("joins a split TXT record back into the value a DNS form wants", () => {
expect(records[2]!.name).toBe("v1-rsa-20260601._domainkey.example.com");
expect(records[2]!.value).toBe(long);
expect(records[2]!.line).toContain("(");
});
it("unquotes and unescapes TXT values, and leaves other types as written", () => {
expect(records[1]!.value).toBe("v=spf1 mx ra=postmaster -all");
expect(records[3]!.value).toBe('v=DMARC1; p=reject; rua=mailto:"postmaster"@example.com');
expect(records[5]!.value).toBe('0 issue "letsencrypt.org"');
});
it("keeps a line it cannot read rather than dropping it", () => {
expect(parseZoneFile("something unexpected")).toEqual([{ name: "", type: "", value: "something unexpected", line: "something unexpected" }]);
});
});
describe("domain names", () => {
it("are written back lower-case without the root dot", () => {
expect(normaliseDomain(" Example.COM. ")).toBe("example.com");
});
it("are checked loosely before the server decides", () => {
expect(looksLikeDomain("mail.example.co.uk")).toBe(true);
expect(looksLikeDomain("example")).toBe(false);
expect(looksLikeDomain("exa mple.com")).toBe(false);
expect(looksLikeDomain("-bad.example.com")).toBe(false);
});
});
describe("explaining what still uses a domain", () => {
it("counts by kind", () => {
expect(describeLinked(["Account", "Account", "DkimSignature", "MailingList", "Whatever"])).toBe("2 accounts, 1 DKIM key, 1 mailing list, 1 other item");
});
it("names a key's algorithm from its type", () => {
expect(dkimAlgorithm("Dkim1Ed25519Sha256")).toBe("Ed25519 · DKIM1");
expect(dkimAlgorithm("Dkim2RsaSha256")).toBe("RSA · DKIM2");
});
});
+99 -3
View File
@@ -1,5 +1,5 @@
import { describe, expect, it } from "vitest"; import { describe, expect, it } from "vitest";
import { LIGHT_SURFACE_LUMINANCE, htmlDeclaresColors, markKeptSurfaces, relativeLuminance, sanitizeEditorHtml, sanitizeEmailHtml } from "../html"; import { EMAIL_BASE_CSS, LIGHT_SURFACE_LUMINANCE, htmlDeclaresColors, markKeptSurfaces, relativeLuminance, sanitizeEditorHtml, sanitizeEmailHtml } from "../html";
describe("sanitizeEmailHtml", () => { describe("sanitizeEmailHtml", () => {
it("removes scripts and event handlers", () => { it("removes scripts and event handlers", () => {
@@ -96,6 +96,24 @@ describe("markKeptSurfaces", () => {
return d; return d;
}; };
/*
* Marking is only half of it the other half is the rule in EMAIL_BASE_CSS
* that reads the marks, and #310 was a bug in that half rather than in the
* marking. So these assert what the reader actually sees: does the
* neutraliser hit this element? The selector is lifted out of the stylesheet
* rather than copied, so a test cannot quietly drift from the rule it checks.
*/
const NEUTRALISER = (() => {
const m = EMAIL_BASE_CSS.match(
/\.ihm-email-root\.forced\s+(\*:not\([^{]*?)\s*\{\s*color: inherit/,
);
if (!m) throw new Error("could not find the neutraliser rule in EMAIL_BASE_CSS");
return m[1]!.trim();
})();
/** True when the theme is forced onto this element rather than leaving it alone. */
const neutralised = (el: Element) => el.matches(NEUTRALISER);
it("keeps a coloured button and drops the white sheet around it", () => { it("keeps a coloured button and drops the white sheet around it", () => {
// The shape reported in #290: a Shopify/Klaviyo template whose outer 600px // The shape reported in #290: a Shopify/Klaviyo template whose outer 600px
// wrapper carries bgcolor="#ffffff" and whose CTA carries bgcolor="#1155CC". // wrapper carries bgcolor="#ffffff" and whose CTA carries bgcolor="#1155CC".
@@ -103,9 +121,87 @@ describe("markKeptSurfaces", () => {
expect(markKeptSurfaces(d)).toBe(1); expect(markKeptSurfaces(d)).toBe(1);
expect(d.querySelector("table")!.hasAttribute("data-ihm-keep")).toBe(false); expect(d.querySelector("table")!.hasAttribute("data-ihm-keep")).toBe(false);
expect(d.querySelector("td")!.hasAttribute("data-ihm-keep")).toBe(true); expect(d.querySelector("td")!.hasAttribute("data-ihm-keep")).toBe(true);
// The label is not marked itself; the CSS keeps it because it is inside // The label is not a painted surface itself. It is marked as sitting on
// something that is, which is what stops white-on-blue turning unreadable. // one, which is what stops white-on-blue turning unreadable.
expect(d.querySelector("a")!.hasAttribute("data-ihm-keep")).toBe(false); expect(d.querySelector("a")!.hasAttribute("data-ihm-keep")).toBe(false);
expect(d.querySelector("a")!.hasAttribute("data-ihm-in-keep")).toBe(true);
});
it("neutralises a light panel nested inside a dark painted card", () => {
// The shape reported in #310: a dark Klaviyo campaign whose 600px cards
// are dark enough to be marked, with light content tables inside them.
// Those tables used to inherit the card's exemption and render as beige
// sheets in an otherwise themed message.
const d = frag(
'<div style="background-color:#e7e5e2">' +
'<div style="background-color:#2b2b2b">' +
'<table style="background-color:#e7e5e2"><tr><td>copy</td></tr></table>' +
'</div>' +
'</div>',
);
expect(markKeptSurfaces(d)).toBe(1);
const divs = Array.from(d.querySelectorAll("div"));
const surround = divs[0]!;
const card = divs[1]!;
const nested = d.querySelector("table")!;
// The page surround is a sheet and always was.
expect(surround.hasAttribute("data-ihm-keep")).toBe(false);
// The card is paint and stays paint.
expect(card.hasAttribute("data-ihm-keep")).toBe(true);
// The fix, stated the way the reader experiences it: the nested sheet is
// themed, and so is the copy inside it. Before #310 both were exempt for
// being descendants of the card.
expect(neutralised(nested)).toBe(true);
expect(neutralised(d.querySelector("td")!)).toBe(true);
// The card itself is still left alone, and the page surround still goes.
expect(neutralised(card)).toBe(false);
expect(neutralised(surround)).toBe(true);
});
it("still keeps a button that sits inside a nested light panel", () => {
// Paint resumes below a sheet, however deep it is: the fix must not cost
// a call to action its label just because a sheet came between it and the
// card it is on.
const d = frag(
'<div style="background-color:#2b2b2b">' +
'<table style="background-color:#ffffff"><tr>' +
'<td bgcolor="#1155CC"><a style="color:#FFFFFF">Buy</a></td>' +
'</tr></table>' +
'</div>',
);
expect(markKeptSurfaces(d)).toBe(2);
expect(neutralised(d.querySelector("table")!)).toBe(true);
expect(neutralised(d.querySelector("td")!)).toBe(false);
// The label keeps its white, which is the thing #294 bought and this must
// not spend.
expect(neutralised(d.querySelector("a")!)).toBe(false);
});
it("leaves no light panel exempt across the whole reported specimen", () => {
// #310 as reported: a dark campaign with no bgcolor attributes, 21 light
// panels, 14 of them nested inside dark 600px cards. Those fourteen were
// the ones rendering as beige sheets.
let cards = "";
for (let i = 0; i < 7; i++) {
cards +=
'<div style="background-color:#2b2b2b">' +
'<table style="background-color:#e7e5e2"><tr><td>copy</td></tr></table>' +
'<table style="background-color:#e7e5e2"><tr><td>more</td></tr></table>' +
"</div>";
}
let loose = "";
for (let i = 0; i < 7; i++) {
loose += '<table style="background-color:#e7e5e2"><tr><td>loose</td></tr></table>';
}
const d = frag('<div style="background-color:#e7e5e2">' + cards + loose + "</div>");
const panels = Array.from(d.querySelectorAll<HTMLElement>("table"));
expect(panels.length).toBe(21);
expect(markKeptSurfaces(d)).toBe(7);
expect(panels.filter((p) => !neutralised(p))).toHaveLength(0);
}); });
it("reads an inline background as well as the attribute", () => { it("reads an inline background as well as the attribute", () => {
@@ -0,0 +1,54 @@
import { describe, expect, it } from "vitest";
import { hasHtmlAlternative } from "../html";
/*
* The rule: `htmlBody` is derived, so its presence proves nothing. Only the
* part's own type says whether there is an HTML alternative to render.
*
* The shapes below are what Stalwart 0.16.21 actually returned for one thread
* on 2026-09-10, read back through `Email/get` with
* `bodyProperties: ["partId", "type"]`. A plain-text message named the *same*
* part in both lists; a message with a real alternative named two.
*
* Getting this wrong is not a rendering nicety. Plain text went to the HTML
* path, which places the body under `white-space: normal`, so every line break
* collapsed: hard-wrapped mail arrived as one paragraph, and the signature and
* the quoted reply ran into the prose.
*/
describe("deciding whether a message has an HTML alternative", () => {
it("says no to a plain-text message, whose htmlBody holds the text part", () => {
// As returned for [email protected]: htmlBody[0] and textBody[0] are the
// same part, typed text/plain.
expect(hasHtmlAlternative({ type: "text/plain" }, "Hey,\n\nmy earlier response was before\n")).toBe(false);
});
it("says yes to a real multipart/alternative", () => {
expect(hasHtmlAlternative({ type: "text/html" }, "<p>Hello</p>")).toBe(true);
});
it("keeps the parameters that follow a media type", () => {
// `type` arrives bare in practice, but a charset must not turn a real HTML
// part into a plain-text one.
expect(hasHtmlAlternative({ type: "text/html; charset=utf-8" }, "<p>Hi</p>")).toBe(true);
});
it("is not fooled by a type that merely starts with the right letters", () => {
expect(hasHtmlAlternative({ type: "text/htmlish" }, "<p>Hi</p>")).toBe(false);
});
it("matches the type case-insensitively, since a header may be capitalised", () => {
expect(hasHtmlAlternative({ type: "TEXT/HTML" }, "<p>Hi</p>")).toBe(true);
});
it("says no when the part is HTML but its value never arrived", () => {
// maxBodyValueBytes can leave a part named with nothing fetched; falling
// through to the text body is the useful answer, not an empty pane.
expect(hasHtmlAlternative({ type: "text/html" }, undefined)).toBe(false);
expect(hasHtmlAlternative({ type: "text/html" }, "")).toBe(false);
});
it("says no when there is no part at all", () => {
expect(hasHtmlAlternative(undefined, undefined)).toBe(false);
expect(hasHtmlAlternative({}, "something")).toBe(false);
});
});
+66
View File
@@ -0,0 +1,66 @@
import { describe, expect, it } from "vitest";
import { rowIsOpen, visibleMessages } from "../openMessage";
/*
* Reported from the inbox: with conversation view off, the list showed the two
* messages of a thread as separate rows -- correctly -- but clicking either one
* highlighted *both* and filled the reading pane with all five messages of the
* conversation.
*
* The setting reached only as far as `collapseThreads` on the query. These are
* the two rules that were missing downstream.
*/
const msg = (id: string) => ({ id });
describe("which row is drawn as open", () => {
it("marks only the opened message, not its siblings", () => {
// The reported case: two rows, one thread, one of them opened.
expect(rowIsOpen("m1", "t1", "m1", "t1")).toBe(true);
expect(rowIsOpen("m2", "t1", "m1", "t1")).toBe(false);
});
it("still marks the whole thread when conversation view is on", () => {
// No message singled out: every row of the open thread is part of what the
// reading pane is showing, so every one of them is open.
expect(rowIsOpen("m1", "t1", null, "t1")).toBe(true);
expect(rowIsOpen("m2", "t1", null, "t1")).toBe(true);
expect(rowIsOpen("m3", "t2", null, "t1")).toBe(false);
});
it("marks nothing when nothing is open", () => {
expect(rowIsOpen("m1", "t1", null, null)).toBe(false);
});
it("does not mark a row whose thread is unknown", () => {
// A row whose email has not loaded yet has no thread id; `undefined` must
// not match a null openThreadId and light the row up.
expect(rowIsOpen("m1", undefined, null, null)).toBe(false);
});
});
describe("which messages the reading pane shows", () => {
const thread = [msg("a"), msg("b"), msg("c")];
it("shows just the opened message", () => {
expect(visibleMessages(thread, "b")).toEqual([msg("b")]);
});
it("shows the whole thread when none is singled out", () => {
expect(visibleMessages(thread, null)).toEqual(thread);
});
it("falls back to the thread when the id names nothing in it", () => {
/*
* Two ways to arrive here: a link shared by somebody whose conversation
* view is on, and an `m` parameter left in the URL when the setting is
* switched back. A conversation is a better answer to both than an empty
* pane, which is what filtering to nothing would produce.
*/
expect(visibleMessages(thread, "zzz")).toEqual(thread);
});
it("leaves an empty thread empty rather than inventing a message", () => {
expect(visibleMessages([], "b")).toEqual([]);
});
});
+119
View File
@@ -0,0 +1,119 @@
import { afterEach, describe, expect, it, vi } from "vitest";
import { canShare, canShareFiles, resetShareSupport, shareFile, shareText } from "@/lib/share";
/**
* The outcomes are the whole of this module: what the callers do next is
* decided entirely by which of the three comes back, and two of the three are
* reached through an exception rather than a return.
*
* `unsupported` is the one worth guarding. It is the instruction to download
* instead, and it has to cover the browser that cannot share files *and* the
* share that was refused because the tap's activation ran out while the
* attachment was fetched -- which arrives as an error indistinguishable from a
* permissions refusal, and would otherwise reach the reader as a toast about
* something they cannot act on.
*/
function stubNavigator(nav: Partial<Navigator>) {
vi.stubGlobal("navigator", nav as Navigator);
resetShareSupport();
}
const aFile = () => new File(["x"], "note.txt", { type: "text/plain" });
afterEach(() => {
vi.unstubAllGlobals();
resetShareSupport();
});
describe("share availability", () => {
it("is absent where the browser has no Web Share", () => {
stubNavigator({});
expect(canShare()).toBe(false);
expect(canShareFiles()).toBe(false);
});
it("asks about files separately from sharing at all", () => {
// Every iOS and Android browser shares text; not all of them take files,
// and a Share button that turns out to be a download is worse than none.
stubNavigator({ share: vi.fn(), canShare: () => false });
expect(canShare()).toBe(true);
expect(canShareFiles()).toBe(false);
});
it("probes with a real file, since canShare() cannot answer without one", () => {
const canShareFn = vi.fn(() => true);
stubNavigator({ share: vi.fn(), canShare: canShareFn as unknown as Navigator["canShare"] });
expect(canShareFiles()).toBe(true);
const probe = (canShareFn.mock.calls[0] as unknown as [ShareData])[0];
expect(probe.files?.[0]).toBeInstanceOf(File);
expect(probe.files?.[0]?.size).toBeGreaterThan(0);
});
it("asks once and remembers, because the answer is about the browser", () => {
const canShareFn = vi.fn(() => true);
stubNavigator({ share: vi.fn(), canShare: canShareFn as unknown as Navigator["canShare"] });
canShareFiles();
canShareFiles();
canShareFiles();
expect(canShareFn).toHaveBeenCalledTimes(1);
});
});
describe("sharing text", () => {
it("hands the data straight to the sheet", async () => {
const share = vi.fn(async () => undefined);
stubNavigator({ share });
await expect(shareText({ title: "Lunch", text: "One o'clock?" })).resolves.toBe("shared");
expect(share).toHaveBeenCalledWith({ title: "Lunch", text: "One o'clock?" });
});
it("reports unsupported rather than throwing where there is no share", async () => {
stubNavigator({});
await expect(shareText({ text: "hello" })).resolves.toBe("unsupported");
});
});
describe("sharing a file", () => {
it("passes the file through when the browser takes it", async () => {
const share = vi.fn(async () => undefined);
stubNavigator({ share, canShare: (() => true) as unknown as Navigator["canShare"] });
const f = aFile();
await expect(shareFile(f, { title: "note.txt" })).resolves.toBe("shared");
expect(share).toHaveBeenCalledWith({ title: "note.txt", files: [f] });
});
it("does not call share at all when this file is not shareable", async () => {
const share = vi.fn(async () => undefined);
stubNavigator({ share, canShare: (() => false) as unknown as Navigator["canShare"] });
await expect(shareFile(aFile())).resolves.toBe("unsupported");
expect(share).not.toHaveBeenCalled();
});
it("treats a closed sheet as a decision, not a failure", async () => {
stubNavigator({
share: vi.fn(async () => { throw new DOMException("cancelled", "AbortError"); }),
canShare: (() => true) as unknown as Navigator["canShare"],
});
await expect(shareFile(aFile())).resolves.toBe("dismissed");
});
it("falls back rather than reporting an error when the gesture has expired", async () => {
// What NotAllowedError means here is that fetching the attachment outlived
// the tap that asked for it. The caller downloads; the reader sees a file
// rather than a message about transient activation.
stubNavigator({
share: vi.fn(async () => { throw new DOMException("no activation", "NotAllowedError"); }),
canShare: (() => true) as unknown as Navigator["canShare"],
});
await expect(shareFile(aFile())).resolves.toBe("unsupported");
});
it("raises anything it does not recognise, so a real fault is still reported", async () => {
stubNavigator({
share: vi.fn(async () => { throw new DOMException("boom", "DataError"); }),
canShare: (() => true) as unknown as Navigator["canShare"],
});
await expect(shareFile(aFile())).rejects.toThrow("boom");
});
});
+114
View File
@@ -0,0 +1,114 @@
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { collectShare, shareBody, SHARE_MAX_AGE_MS } from "@/lib/shareTarget";
import { SW_CACHE_NAME } from "@/lib/swCache";
/**
* The handoff, from the tab's side. The worker's half cannot be exercised here
* -- sw.js is copied to the build rather than imported, and there is no service
* worker under a test runner -- so what is stood up below is the cache it
* writes into, keyed and shaped exactly as `stashShare` leaves it.
*
* That shape is the contract between two files that never see each other, and
* it is the thing worth pinning: a drift on either side is silent. Nothing
* errors, a share simply arrives at an empty composer.
*/
interface Entry {
body: BodyInit;
type: string;
}
function fakeCaches(entries: Record<string, Entry>) {
const store = new Map(Object.entries(entries));
const cache = {
match: vi.fn(async (key: string) => {
const e = store.get(key);
return e ? new Response(e.body, { headers: { "content-type": e.type } }) : undefined;
}),
delete: vi.fn(async (key: string) => store.delete(key)),
put: vi.fn(async () => undefined),
};
vi.stubGlobal("caches", { open: vi.fn(async (name: string) => (name === SW_CACHE_NAME ? cache : { match: async () => undefined })) });
return { cache, store };
}
/** What the worker writes, at the keys it writes them under. */
function stash(meta: Record<string, unknown>, files: { name: string; type: string; body: string }[] = []) {
const entries: Record<string, Entry> = {};
const index = files.map((f, i) => ({ key: `/ihasmail-share/${i}`, name: f.name, type: f.type }));
entries["/ihasmail-share"] = { body: JSON.stringify({ at: Date.now(), files: index, ...meta }), type: "application/json" };
for (const [i, f] of files.entries()) entries[`/ihasmail-share/${i}`] = { body: f.body, type: f.type };
return entries;
}
beforeEach(() => vi.unstubAllGlobals());
afterEach(() => vi.unstubAllGlobals());
describe("collecting a share", () => {
it("finds nothing on an ordinary start, which is almost every start", async () => {
fakeCaches({});
await expect(collectShare()).resolves.toBeNull();
});
it("survives a browser with no cache storage at all", async () => {
vi.stubGlobal("caches", undefined);
await expect(collectShare()).resolves.toBeNull();
});
it("rebuilds the files, with their names and types intact", async () => {
fakeCaches(stash({ title: "Holiday", text: "", url: "" }, [
{ name: "beach.png", type: "image/png", body: "pixels" },
{ name: "notes.txt", type: "text/plain", body: "later" },
]));
const share = await collectShare();
expect(share?.title).toBe("Holiday");
expect(share?.files.map((f) => [f.name, f.type])).toEqual([["beach.png", "image/png"], ["notes.txt", "text/plain"]]);
// The bytes made the trip, not just the index entry describing them.
expect(share!.files[0]!.size).toBe("pixels".length);
});
it("leaves nothing behind, so it cannot be collected twice", async () => {
const { store } = fakeCaches(stash({ text: "hello" }, [{ name: "a.txt", type: "text/plain", body: "x" }]));
await collectShare();
expect(store.size).toBe(0);
});
it("ignores one nobody came back for, and still clears it", async () => {
// A share to a signed-out ihasmail waits through the sign-in page, so it
// cannot expire quickly -- but it must expire, or it opens a composer full
// of a forgotten photo on some unrelated morning.
const { store } = fakeCaches(stash({ at: Date.now() - SHARE_MAX_AGE_MS - 1000, text: "stale" }));
await expect(collectShare()).resolves.toBeNull();
expect(store.size).toBe(0);
});
it("treats an empty share as no share", async () => {
fakeCaches(stash({ title: "", text: "", url: "" }));
await expect(collectShare()).resolves.toBeNull();
});
it("does not throw on a stash it cannot read", async () => {
fakeCaches({ "/ihasmail-share": { body: "not json", type: "application/json" } });
await expect(collectShare()).resolves.toBeNull();
});
});
describe("the body a share turns into", () => {
it("keeps the link when the text does not already carry it", () => {
expect(shareBody({ text: "Look at this", url: "https://example.com/a" })).toBe("Look at this\n\nhttps://example.com/a");
});
it("does not repeat a link the sharing app already put in the text", () => {
// Which field a link arrives in is up to whatever shared it, and they do
// not agree. Appending unconditionally would double it more often than not.
expect(shareBody({ text: "https://example.com/a", url: "https://example.com/a" })).toBe("https://example.com/a");
});
it("is just the link when that is all there was", () => {
expect(shareBody({ text: "", url: "https://example.com/a" })).toBe("https://example.com/a");
});
it("is just the text when there was no link", () => {
expect(shareBody({ text: "a thought", url: "" })).toBe("a thought");
});
});
+90
View File
@@ -0,0 +1,90 @@
import { afterEach, describe, expect, it, vi } from "vitest";
import { publishWorkerFacts, FACTS_KEY, type WorkerFacts } from "@/lib/swFacts";
import { SW_CACHE_NAME } from "@/lib/swCache";
import { setCatalog } from "@/lib/i18n";
import { catalog as de } from "@/locales/de";
/**
* The briefing is the only thing standing between a notification action and a
* button labelled in a language the reader does not use the worker is plain
* JavaScript outside the bundle and cannot reach a catalogue.
*
* It is also the only place the archive mailbox is named, and getting that
* wrong does not fail visibly: a message would be filed somewhere, just not
* where Archive means.
*/
function fakeCaches() {
const store = new Map<string, string>();
const cache = {
put: vi.fn(async (key: string, res: Response) => void store.set(key, await res.text())),
match: vi.fn(async (key: string) => (store.has(key) ? new Response(store.get(key)) : undefined)),
delete: vi.fn(async () => true),
};
// Only the worker's own cache: a briefing put anywhere else is one the
// worker will never read.
const other = { put: vi.fn(), match: vi.fn(), delete: vi.fn() };
vi.stubGlobal("caches", { open: vi.fn(async (name: string) => (name === SW_CACHE_NAME ? cache : other)) });
return { store, cache };
}
const written = (store: Map<string, string>) => JSON.parse(store.get(FACTS_KEY)!) as WorkerFacts;
afterEach(() => {
vi.unstubAllGlobals();
setCatalog("en", { strings: {}, plurals: {} });
});
describe("the worker's briefing", () => {
it("names the account and the archive mailbox", async () => {
const { store } = fakeCaches();
await publishWorkerFacts("a1", "mb-archive");
const facts = written(store);
expect(facts.accountId).toBe("a1");
expect(facts.archiveId).toBe("mb-archive");
});
it("carries the worker's text in the language the tab is in", async () => {
// The worker has no catalogue. Everything it will say has to be said here
// first, or a German reader gets English buttons on their lock screen.
setCatalog("de", de);
const { store } = fakeCaches();
await publishWorkerFacts("a1", "mb-archive");
const facts = written(store);
expect(facts.strings.archive).toBe("Archivieren");
expect(facts.strings.markRead).toBe("Als gelesen markieren");
expect(facts.strings.newMail).toBe("Neue E-Mail");
expect(facts.strings.noSubject).toBe("(kein Betreff)");
expect(facts.strings.failed).not.toBe("");
});
it("says so when there is no archive folder, rather than inventing one", async () => {
// The worker draws no Archive button on a null. An account without an
// archive is not a reason to file mail somewhere else.
const { store } = fakeCaches();
await publishWorkerFacts("a1", null);
expect(written(store).archiveId).toBeNull();
});
it("writes nothing before there is an account", async () => {
const { cache } = fakeCaches();
await publishWorkerFacts(null, null);
expect(cache.put).not.toHaveBeenCalled();
});
it("does not throw where the browser has no cache storage", async () => {
vi.stubGlobal("caches", undefined);
await expect(publishWorkerFacts("a1", "mb-archive")).resolves.toBeUndefined();
});
it("carries every string the worker looks up", async () => {
// The worker reads these by name and shows `undefined` for a missing one,
// which is the kind of thing that only appears on somebody's lock screen.
const { store } = fakeCaches();
await publishWorkerFacts("a1", "mb-archive");
const facts = written(store);
for (const k of ["newMail", "newMessage", "noSubject", "archive", "markRead", "failed"] as const) {
expect(facts.strings[k], `missing ${k}`).toBeTruthy();
}
});
});
+1
View File
@@ -36,6 +36,7 @@ function session(caps: Record<string, unknown>): JmapSession {
afterEach(() => { afterEach(() => {
client.session = null; client.session = null;
vi.unstubAllGlobals(); vi.unstubAllGlobals();
vi.restoreAllMocks();
}); });
describe("the VAPID key", () => { describe("the VAPID key", () => {
+156
View File
@@ -0,0 +1,156 @@
/**
* What the signed-in account may administer, read from the permissions Stalwart
* reported for it at sign-in.
*
* None of this is a security boundary, and nothing here should read as one.
* Every administrative call is a JMAP `x:` method sent through the ordinary
* proxy, and Stalwart checks each of them against the credential making it --
* scoping a tenant administrator's queries to their own tenant, and refusing a
* write the account may not make. What this decides is only what the client
* *offers*: a menu that appears for the people it can do something for, and
* buttons that are there when pressing them would work.
*
* The one place it is more than presentation is `outranks`, which stands in
* for a check Stalwart does not make. See there.
*/
export type AdminObject = "Account" | "Domain" | "Role" | "MailingList" | "DkimSignature" | "DnsServer" | "Tenant";
export type AdminOp = "Get" | "Query" | "Create" | "Update" | "Destroy";
export type Permissions = ReadonlySet<string>;
export function permissionSet(list: readonly string[] | null | undefined): Permissions {
return new Set(list ?? []);
}
export function can(perms: Permissions, object: AdminObject, op: AdminOp): boolean {
return perms.has(`sys${object}${op}`);
}
export type AdminSection = "accounts" | "domains";
/**
* The sections an account may open, in the order they are listed.
*
* A list that cannot be read is not worth an entry, so each takes both halves
* of reading one: the query that finds the objects and the get that shows them.
*/
export function adminSections(perms: Permissions): AdminSection[] {
const out: AdminSection[] = [];
if (can(perms, "Account", "Query") && can(perms, "Account", "Get")) out.push("accounts");
if (can(perms, "Domain", "Query") && can(perms, "Domain", "Get")) out.push("domains");
return out;
}
/** Whether to offer Administration at all: when there is a section to open. */
export function hasAdministration(perms: Permissions): boolean {
return adminSections(perms).length > 0;
}
/**
* What an administrator holds, at the least: Stalwart's built-in Tenant
* Administrator role, for the parts of it that manage people and domains.
* Anyone who has all of this can already do anything to the accounts an
* "Administrator" account could.
*/
export const ADMIN_BASELINE: readonly string[] = (["Account", "Domain", "Role", "MailingList"] as const).flatMap((o) =>
(["Get", "Query", "Create", "Update", "Destroy"] as const).map((op) => `sys${o}${op}`),
);
export type UserRoles = { "@type": "User" } | { "@type": "Admin" } | { "@type": "Custom"; roleIds: Record<string, boolean> };
export type PermissionsMode =
| { "@type": "Inherit" }
| { "@type": "Merge" | "Replace"; enabledPermissions?: Record<string, boolean>; disabledPermissions?: Record<string, boolean> };
export interface RoleDef {
id: string;
description?: string | null;
enabledPermissions?: Record<string, boolean>;
roleIds?: Record<string, boolean>;
}
/**
* Whether an account can do something the viewer cannot.
*
* Stalwart checks that a caller holds every permission they grant -- when
* roles or permissions change, and when an account is created. It does not
* check when only a password changes, and it does not check a delete. So an
* account allowed to edit accounts could reset the password of one with far
* more rights than its own and sign in as it. ihasmail refuses to offer that,
* and treats such an account as read-only.
*
* It errs towards refusing. A role that cannot be read -- the viewer lacks
* `sysRoleGet`, or the id is not in the list -- counts as outranking, because
* an unknown grant is not a grant the viewer can be shown to hold. What it
* cannot see is tenancy: an "Administrator" account is a tenant administrator
* inside a tenant and a server administrator outside one, and a tenant-scoped
* viewer is not told which it is looking at. It never sees the second kind,
* which is why comparing against the administrator baseline is enough there.
*/
export function outranks(
viewer: Permissions,
target: { roles?: UserRoles | null; permissions?: PermissionsMode | null },
roles: ReadonlyMap<string, RoleDef> | null,
): boolean {
let granted = new Set<string>();
const kind = target.roles?.["@type"] ?? "User";
if (kind === "Admin") {
if (!ADMIN_BASELINE.every((p) => viewer.has(p))) return true;
} else if (kind === "Custom") {
const ids = Object.keys((target.roles as { roleIds?: Record<string, boolean> }).roleIds ?? {});
const resolved = resolveRoles(ids, roles);
if (!resolved) return true;
granted = resolved;
}
const mode = target.permissions;
if (mode && mode["@type"] !== "Inherit") {
const enabled = Object.keys(mode.enabledPermissions ?? {});
granted = mode["@type"] === "Replace" ? new Set(enabled) : new Set([...granted, ...enabled]);
}
for (const p of granted) if (!viewer.has(p)) return true;
return false;
}
/** Every permission a set of roles grants, nested roles included; null if any cannot be read. */
export function resolveRoles(ids: readonly string[], roles: ReadonlyMap<string, RoleDef> | null): Set<string> | null {
if (!ids.length) return new Set();
if (!roles) return null;
const out = new Set<string>();
const seen = new Set<string>();
const walk = (id: string): boolean => {
if (seen.has(id)) return true;
seen.add(id);
const role = roles.get(id);
if (!role) return false;
for (const p of Object.keys(role.enabledPermissions ?? {})) out.add(p);
return Object.keys(role.roleIds ?? {}).every(walk);
};
return ids.every(walk) ? out : null;
}
/** Whether the viewer could grant a role: they hold everything it carries. */
export function canGrantRole(viewer: Permissions, roleId: string, roles: ReadonlyMap<string, RoleDef> | null): boolean {
const granted = resolveRoles([roleId], roles);
return granted !== null && [...granted].every((p) => viewer.has(p));
}
/**
* A password to hand to somebody who will change it.
*
* Twenty characters from an alphabet without the ones people misread aloud
* (0/O, 1/l/I), in groups of five. Rejection sampling, so every character is
* equally likely rather than the first few of the alphabet slightly more.
*/
const ALPHABET = "abcdefghjkmnpqrstuvwxyzABCDEFGHJKLMNPQRSTUVWXYZ23456789";
export function generatePassword(random: (n: number) => Uint8Array = (n) => crypto.getRandomValues(new Uint8Array(n))): string {
const out: string[] = [];
const limit = 256 - (256 % ALPHABET.length);
while (out.length < 20) {
for (const byte of random(32)) {
if (byte < limit && out.length < 20) out.push(ALPHABET[byte % ALPHABET.length]!);
}
}
return [0, 5, 10, 15].map((i) => out.slice(i, i + 5).join("")).join("-");
}
+297
View File
@@ -0,0 +1,297 @@
import { client } from "@/jmap/client";
import { t } from "@/lib/i18n";
import type { PermissionsMode, RoleDef, UserRoles } from "@/lib/adminAccess";
/**
* Stalwart 0.16's directory, over the ordinary JMAP proxy.
*
* 0.16 removed the REST management API (`/api/principal` and the rest); people,
* domains and roles are registry objects now, read and written with `x:Account`,
* `x:Domain` and `x:Role`. These go through `/api/jmap` like every other call,
* authenticated as the signed-in account, so ihasmail holds nothing new: no
* route of its own, no store, no cache beyond the component showing the list.
*
* Shapes, from the 0.16.22 source:
*
* - A list (credentials, aliases) is an object keyed by index, `{"0": …}`. A
* set (memberGroupIds, role ids, permissions) is `{"id": true}`.
* - An account's `name` is its local part, and its domain is a `domainId`.
* `emailAddress` and `usedDiskQuota` are computed by the server.
* - Secrets read back masked. A new password is written to the existing
* password credential, so its id -- which OAuth tokens are tied to -- stays.
* - Filters are AND only, keyed by property name as it appears on the object
* (`@type`, not `type`), and the default order is newest first.
*
* Query and get are two requests rather than one with a result reference.
* Whether the registry methods resolve back-references has not been checked on
* a live server, and a list that loads a moment slower is a better failure than
* one that never loads.
*/
export interface EmailAlias {
enabled?: boolean;
name: string;
domainId: string;
description?: string | null;
}
export interface Credential {
"@type": "Password" | "AppPassword" | "ApiKey";
secret?: string;
description?: string;
}
export interface DirectoryAccount {
id: string;
"@type": "User" | "Group";
name: string;
domainId: string;
emailAddress?: string;
description?: string | null;
roles?: UserRoles;
permissions?: PermissionsMode;
quotas?: Record<string, number>;
usedDiskQuota?: number;
aliases?: Record<string, EmailAlias>;
memberGroupIds?: Record<string, boolean>;
credentials?: Record<string, Credential>;
createdAt?: string;
}
export interface DirectoryDomain {
id: string;
name: string;
}
const ACCOUNT_PROPERTIES = [
"@type", "name", "domainId", "emailAddress", "description", "roles", "permissions", "quotas",
"usedDiskQuota", "aliases", "memberGroupIds", "credentials", "createdAt",
];
/** The one quota ihasmail edits; the others keep whatever they had. */
export const DISK_QUOTA = "maxDiskQuota";
/** An error with a SetError behind it, kept so the caller can explain it. */
export class DirectoryError extends Error {
constructor(
readonly type: string,
readonly description: string | undefined,
readonly properties: string[] = [],
) {
super(description ?? type);
this.name = "DirectoryError";
}
}
interface QueryResult {
ids: string[];
total?: number;
position?: number;
}
export async function queryAccounts(opts: { type: "User" | "Group"; text?: string; position?: number; limit?: number }): Promise<{ ids: string[]; total: number }> {
// The registry names the discriminator `@type`, as it is on the object. A
// plain `type` is not a property it knows and fails the whole query.
const filter: Record<string, unknown> = { "@type": opts.type };
if (opts.text?.trim()) filter.text = opts.text.trim();
const res = await client.call<QueryResult>("x:Account/query", {
filter,
position: opts.position ?? 0,
...(opts.limit ? { limit: opts.limit } : {}),
calculateTotal: true,
});
return { ids: res.ids ?? [], total: res.total ?? res.ids?.length ?? 0 };
}
export async function getAccounts(ids: string[]): Promise<DirectoryAccount[]> {
if (!ids.length) return [];
const res = await client.call<{ list: DirectoryAccount[] }>("x:Account/get", { ids, properties: ACCOUNT_PROPERTIES });
// In the order the query gave, which is the order the list is shown in.
const byId = new Map(res.list.map((a) => [a.id, a]));
return ids.map((id) => byId.get(id)).filter((a): a is DirectoryAccount => Boolean(a));
}
/** Every one of a kind, for the pickers. Capped by what the server allows in a get. */
async function all<T>(object: "Domain" | "Role", properties: string[]): Promise<T[]> {
const q = await client.call<QueryResult>(`x:${object}/query`, { limit: client.maxObjectsInGet });
if (!q.ids?.length) return [];
const res = await client.call<{ list: T[] }>(`x:${object}/get`, { ids: q.ids, properties });
return res.list;
}
export const listDomains = () => all<DirectoryDomain>("Domain", ["name"]);
export const listRoles = () => all<RoleDef>("Role", ["description", "enabledPermissions", "roleIds"]);
export async function listGroups(): Promise<DirectoryAccount[]> {
const q = await queryAccounts({ type: "Group", limit: client.maxObjectsInGet });
if (!q.ids.length) return [];
const res = await client.call<{ list: DirectoryAccount[] }>("x:Account/get", { ids: q.ids, properties: ["name", "emailAddress", "description"] });
return res.list;
}
type SetResponse = Record<string, Record<string, { type: string; description?: string; properties?: string[] } | null> | undefined>;
function throwIfRefused(res: SetResponse, kind: "notCreated" | "notUpdated" | "notDestroyed"): void {
const failure = Object.values(res[kind] ?? {})[0];
if (failure) throw new DirectoryError(failure.type, failure.description, failure.properties);
}
export interface NewAccount {
name: string;
domainId: string;
description: string;
password: string;
roles: UserRoles;
diskQuotaBytes: number | null;
}
export async function createAccount(input: NewAccount): Promise<string> {
const res = await client.call<SetResponse & { created?: Record<string, { id: string }> }>("x:Account/set", {
create: {
n: {
"@type": "User",
name: input.name.trim(),
domainId: input.domainId,
description: input.description.trim() || null,
credentials: { "0": { "@type": "Password", secret: input.password } },
roles: input.roles,
permissions: { "@type": "Inherit" },
quotas: input.diskQuotaBytes ? { [DISK_QUOTA]: input.diskQuotaBytes } : {},
aliases: {},
memberGroupIds: {},
// Required on create. Turning it on is one-way and not offered here.
encryptionAtRest: { "@type": "Disabled" },
},
},
});
throwIfRefused(res, "notCreated");
const id = res.created?.n?.id;
if (!id) throw new DirectoryError("serverFail", t("The server did not say whether the account was created."));
return id;
}
export async function updateAccount(id: string, patch: Record<string, unknown>): Promise<void> {
if (!Object.keys(patch).length) return;
const res = await client.call<SetResponse>("x:Account/set", { update: { [id]: patch } });
throwIfRefused(res, "notUpdated");
}
export async function destroyAccount(id: string): Promise<void> {
const res = await client.call<SetResponse>("x:Account/set", { destroy: [id] });
throwIfRefused(res, "notDestroyed");
}
/**
* The patch that sets a new password.
*
* Into the existing password credential when there is one, which keeps its
* credential id; as a new credential after the last index when there is not --
* an account that has only ever signed in through a directory, say. An account
* holds one password at most, so adding a second is never the answer.
*/
export function passwordPatch(account: Pick<DirectoryAccount, "credentials">, secret: string): Record<string, unknown> {
const entries = Object.entries(account.credentials ?? {});
const existing = entries.find(([, c]) => c["@type"] === "Password");
if (existing) return { [`credentials/${existing[0]}/secret`]: secret };
const next = entries.reduce((max, [k]) => Math.max(max, Number(k) + 1), 0);
return { [`credentials/${next}`]: { "@type": "Password", secret } };
}
export function hasPassword(account: Pick<DirectoryAccount, "credentials">): boolean {
return Object.values(account.credentials ?? {}).some((c) => c["@type"] === "Password");
}
/** Re-index a list of aliases the way the server stores them. */
export function aliasList(aliases: EmailAlias[]): Record<string, EmailAlias> {
return Object.fromEntries(aliases.map((a, i) => [String(i), { enabled: a.enabled ?? true, name: a.name, domainId: a.domainId, description: a.description ?? null }]));
}
/** The quotas object with the disk limit set or cleared, and every other quota kept. */
export function quotasWithDisk(quotas: Record<string, number> | undefined, bytes: number | null): Record<string, number> {
const next = { ...(quotas ?? {}) };
if (bytes && bytes > 0) next[DISK_QUOTA] = bytes;
else delete next[DISK_QUOTA];
return next;
}
/**
* The server's own wording for a value one of its validators refused, and
* what to say instead. These come from the registry's string validators
* (`crates/registry/src/types/string.rs`), which is the whole list: anything
* else Stalwart says about a value is picked up by the fallback below.
*/
const VALIDATOR_MESSAGES: Record<string, () => string> = {
"Invalid domain name": () => t("That isn't a valid domain name. Use a name such as example.com, on a real top-level domain."),
"Invalid email address": () => t("That isn't a valid email address. Use a full address, such as [email protected]."),
"Invalid email local part": () => t("That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @."),
"Invalid hostname or IP address": () => t("That isn't a valid host name or IP address."),
"String cannot be empty": () => t("A required value was left empty."),
};
/** What kind of thing a refusal was about, where the wording has to differ. */
export type DirectoryObject = "account" | "domain";
/**
* Say what went wrong in terms of the person's own action, in their language.
*
* Stalwart explains a refusal in English, and its words are never shown as
* they are: an interface in German that answers in English reads as broken
* even when the English is exact. Every type the registry returns has its
* own message, and a value a validator refused is recognised by the
* validator's wording and said again here.
*
* One exception, on purpose. A password policy is the server's to set -- a
* length, a strength -- and there is no way to know its rule in advance to
* translate it, so its reason is kept after a translated sentence. Dropping it
* would leave "not accepted" with no way to find out why.
*/
export function describeDirectoryError(err: unknown, object: DirectoryObject = "account"): string {
if (!(err instanceof DirectoryError)) {
const e = err as { type?: string; code?: string; status?: number };
// ihasmail's own proxy, refusing for this session or this installation.
if (e?.code === "administration_needs_own_device") return t("Only on a device you've marked as your own. Sign in again with “This is my own device” ticked.");
if (e?.code === "administration_disabled") return t("Administration is turned off on this installation.");
if (e?.code === "network_error" || e?.status === 0) return t("Network error. Please check your connection.");
if (e?.code === "rate_limited" || e?.status === 429) return t("Too many attempts. Please wait a few minutes and try again.");
// A method-level JMAP error: the whole call was refused.
if (e?.type === "forbidden") return t("The mail server refused this. Your role may not allow it.");
if (e?.type) return t("The mail server could not carry out the request ({code}).", { code: e.type });
return t("The mail server could not carry out the request ({code}).", { code: e?.code ?? "error" });
}
const description = err.description ?? "";
switch (err.type) {
case "forbidden":
if (/not authorized to grant/i.test(description)) return t("You can't give an account permissions your own role doesn't have.");
if (/external directory/i.test(description)) return t("This account signs in through an external directory, so its password can't be set here.");
if (/licen[cs]ed account limit/i.test(description)) return t("The server's licence allows no more accounts.");
return t("The mail server refused this. Your role may not allow it.");
case "primaryKeyViolation":
return object === "domain"
? t("That domain name is already in use on this server, as a domain or another domain's other name.")
: t("That address is already in use on this server, as an account, a list or an alias.");
case "invalidForeignKey":
return t("One of the chosen domain, role or group can't be used for this account.");
case "overQuota":
return object === "domain" ? t("Your organisation has reached the number of domains it is allowed.") : t("Your organisation has reached the number of accounts it is allowed.");
case "objectIsLinked":
return t("Something still depends on this, so the server kept it.");
case "notFound":
return object === "domain" ? t("This domain no longer exists. Someone may have removed it.") : t("This account no longer exists. Someone may have deleted it.");
case "rateLimit":
return t("Too many attempts. Please wait a few minutes and try again.");
case "tooLarge":
return t("That is more than the mail server accepts in one change.");
case "invalidPatch":
case "invalidProperties":
case "validationFailed": {
if (err.properties.includes("secret")) {
return description ? t("The password was not accepted: {reason}", { reason: description }) : t("The password was not accepted.");
}
const known = VALIDATOR_MESSAGES[description];
if (known) return known();
return t("The mail server rejected one of the values. Check what you entered and try again.");
}
default:
return t("The mail server refused the change ({code}).", { code: err.type });
}
}
+233
View File
@@ -0,0 +1,233 @@
import { client } from "@/jmap/client";
import { plural, t } from "@/lib/i18n";
import { DirectoryError } from "@/lib/adminDirectory";
/**
* Stalwart 0.16's domains, over the same proxy as accounts.
*
* From the 0.16.22 source (`Domain`, `DkimSignature`, and the registry's get):
*
* - `aliases` are other names for the domain, a set: `{"example.net": true}`.
* - `dkimManagement`, `dnsManagement` and `certificateManagement` are each
* `{"@type": "Manual"}` or `{"@type": "Automatic", …}`. A new domain gets
* automatic DKIM and manual DNS and certificates unless told otherwise.
* - `dnsZoneFile` is computed on read: every record the server wants published
* for the domain, as BIND lines.
* - A DKIM key is created with its private key, which the server validates;
* with automatic management it makes and rotates them itself.
* - Deleting a domain anything still points at is refused with
* `objectIsLinked` and the list of what does -- including the domain's own
* DKIM keys, which is why removing one means removing those first.
*/
export interface Managed {
"@type": "Manual" | "Automatic";
dnsServerId?: string;
acmeProviderId?: string;
}
export interface DirectoryDomainFull {
id: string;
name: string;
aliases?: Record<string, boolean>;
isEnabled?: boolean;
createdAt?: string;
description?: string | null;
catchAllAddress?: string | null;
subAddressing?: { "@type": "Enabled" | "Disabled" | "Custom" };
dkimManagement?: Managed;
dnsManagement?: Managed;
certificateManagement?: Managed;
memberTenantId?: string | null;
directoryId?: string | null;
dnsZoneFile?: string;
}
export interface DkimKey {
id: string;
"@type": string;
selector: string;
stage?: "active" | "pending" | "retiring" | "retired";
createdAt?: string;
nextTransitionAt?: string | null;
}
const DOMAIN_PROPERTIES = [
"name", "aliases", "isEnabled", "createdAt", "description", "catchAllAddress", "subAddressing",
"dkimManagement", "dnsManagement", "certificateManagement", "memberTenantId", "directoryId",
];
type SetFailure = { type: string; description?: string; properties?: string[]; linkedObjects?: { object?: string; id?: string }[] };
type SetResponse = Record<string, Record<string, SetFailure | null | { id: string }> | undefined>;
/** A refusal, with what the server said still depends on the object. */
export class DomainError extends DirectoryError {
constructor(failure: SetFailure) {
super(failure.type, failure.description, failure.properties);
this.linked = (failure.linkedObjects ?? []).map((o) => String(o.object ?? ""));
}
readonly linked: string[];
}
function refused(res: SetResponse, kind: "notCreated" | "notUpdated" | "notDestroyed"): void {
const failure = Object.values(res[kind] ?? {})[0] as SetFailure | undefined;
if (failure) throw new DomainError(failure);
}
export async function queryDomains(opts: { text?: string; position?: number; limit?: number }): Promise<{ ids: string[]; total: number }> {
const filter: Record<string, unknown> = {};
if (opts.text?.trim()) filter.text = opts.text.trim().toLowerCase();
const res = await client.call<{ ids: string[]; total?: number }>("x:Domain/query", {
filter,
position: opts.position ?? 0,
...(opts.limit ? { limit: opts.limit } : {}),
calculateTotal: true,
});
return { ids: res.ids ?? [], total: res.total ?? res.ids?.length ?? 0 };
}
export async function getDomains(ids: string[], opts: { zoneFile?: boolean } = {}): Promise<DirectoryDomainFull[]> {
if (!ids.length) return [];
const properties = opts.zoneFile ? [...DOMAIN_PROPERTIES, "dnsZoneFile"] : DOMAIN_PROPERTIES;
const res = await client.call<{ list: DirectoryDomainFull[] }>("x:Domain/get", { ids, properties });
const byId = new Map(res.list.map((d) => [d.id, d]));
return ids.map((id) => byId.get(id)).filter((d): d is DirectoryDomainFull => Boolean(d));
}
/**
* How many accounts live on each domain. One query per domain, batched into as
* few requests as the server allows; a count that fails is left out rather
* than shown as zero, which would read as "safe to delete".
*/
export async function countAccounts(domainIds: string[]): Promise<Map<string, number>> {
const counts = new Map<string, number>();
await Promise.all(
domainIds.map((domainId) =>
client
.call<{ total?: number; ids?: string[] }>("x:Account/query", { filter: { domainId }, limit: 1, calculateTotal: true })
.then((r) => { if (typeof r.total === "number") counts.set(domainId, r.total); })
.catch(() => {}),
),
);
return counts;
}
export async function listDkimKeys(domainId: string): Promise<DkimKey[]> {
const q = await client.call<{ ids: string[] }>("x:DkimSignature/query", { filter: { domainId } });
if (!q.ids?.length) return [];
const res = await client.call<{ list: DkimKey[] }>("x:DkimSignature/get", { ids: q.ids, properties: ["@type", "selector", "stage", "createdAt", "nextTransitionAt"] });
return res.list;
}
export async function namesOf(object: "Tenant" | "DnsServer", ids: string[]): Promise<Map<string, string>> {
if (!ids.length) return new Map();
const property = object === "Tenant" ? "name" : "description";
const res = await client.call<{ list: Array<{ id: string } & Record<string, unknown>> }>(`x:${object}/get`, { ids, properties: [property] });
return new Map(res.list.map((o) => [o.id, String(o[property] ?? o.id)]));
}
/** Lower-case, no surrounding space or root dot: how a domain is written back. */
export function normaliseDomain(name: string): string {
return name.trim().toLowerCase().replace(/\.$/, "");
}
/** Enough of a check to catch a typo before the server does; the server decides. */
export function looksLikeDomain(name: string): boolean {
return /^(?=.{1,253}$)([a-z0-9](?:[a-z0-9-]{0,61}[a-z0-9])?\.)+[a-z0-9-]{2,63}$/.test(normaliseDomain(name));
}
export async function createDomain(input: { name: string; description: string }): Promise<string> {
const res = await client.call<SetResponse>("x:Domain/set", {
create: { n: { name: normaliseDomain(input.name), description: input.description.trim() || null } },
});
refused(res, "notCreated");
const id = (res.created?.n as { id?: string } | undefined)?.id;
if (!id) throw new DirectoryError("serverFail", t("The server did not say whether the domain was created."));
return id;
}
export async function updateDomain(id: string, patch: Record<string, unknown>): Promise<void> {
if (!Object.keys(patch).length) return;
const res = await client.call<SetResponse>("x:Domain/set", { update: { [id]: patch } });
refused(res, "notUpdated");
}
/**
* Remove a domain, and its DKIM keys with it.
*
* The keys go first, in the same request, because the server will not remove a
* domain its keys still name. Keys that belong to a domain being removed sign
* nothing afterwards, so there is no case for keeping them.
*/
export async function destroyDomain(id: string, dkimKeyIds: string[]): Promise<void> {
if (dkimKeyIds.length) {
const keys = await client.call<SetResponse>("x:DkimSignature/set", { destroy: dkimKeyIds });
refused(keys, "notDestroyed");
}
const res = await client.call<SetResponse>("x:Domain/set", { destroy: [id] });
refused(res, "notDestroyed");
}
export interface DnsRecord {
name: string;
type: string;
value: string;
/** The line as the zone file had it, for copying into a BIND zone. */
line: string;
}
/**
* Read the zone file Stalwart computes for a domain.
*
* Its serialiser writes one record per line as `name IN TYPE value`, and a TXT
* record longer than 255 bytes as a parenthesised run of quoted strings, one
* per line. A DNS provider's form wants the whole value, so the strings are
* joined and unescaped; the original lines are kept for anyone pasting into a
* zone. Anything that does not parse is kept too, as its own row, rather than
* silently dropped from a list somebody is copying from.
*/
export function parseZoneFile(text: string): DnsRecord[] {
const out: DnsRecord[] = [];
const lines = text.split(/\r?\n/);
for (let i = 0; i < lines.length; i++) {
let line = lines[i]!;
if (!line.trim() || line.trim().startsWith(";")) continue;
if (line.includes("(") && !line.includes(")")) {
while (i + 1 < lines.length && !lines[i]!.includes(")")) line += `\n${lines[++i]}`;
}
const m = /^(\S+)\s+(?:\d+\s+)?(?:IN\s+)?([A-Z]+)\s+([\s\S]*)$/.exec(line.trim());
if (!m) {
out.push({ name: "", type: "", value: line.trim(), line: line.trim() });
continue;
}
const [, name, type, rest] = m;
let value = rest!.trim();
if (type === "TXT") {
const parts = [...value.matchAll(/"((?:[^"\\]|\\.)*)"/g)].map((p) => p[1]!.replace(/\\(.)/g, "$1"));
if (parts.length) value = parts.join("");
}
out.push({ name: name!.replace(/\.$/, ""), type: type!, value, line: line.trim() });
}
return out;
}
/** A readable name for a DKIM key's algorithm, from its `@type`. */
export function dkimAlgorithm(type: string): string {
const version = /^Dkim2/.test(type) ? "DKIM2" : "DKIM1";
const algo = /Ed25519/i.test(type) ? "Ed25519" : /Rsa/i.test(type) ? "RSA" : type;
return `${algo} · ${version}`;
}
/** What still points at an object, counted by kind, for a refusal message. */
export function describeLinked(linked: string[]): string {
const counts = new Map<string, number>();
for (const kind of linked) counts.set(kind, (counts.get(kind) ?? 0) + 1);
const parts: string[] = [];
for (const [kind, n] of counts) {
if (kind === "Account") parts.push(plural(n, { one: "{n} account", other: "{n} accounts" }));
else if (kind === "MailingList") parts.push(plural(n, { one: "{n} mailing list", other: "{n} mailing lists" }));
else if (kind === "DkimSignature") parts.push(plural(n, { one: "{n} DKIM key", other: "{n} DKIM keys" }));
else parts.push(plural(n, { one: "{n} other item", other: "{n} other items" }));
}
return parts.join(", ");
}
+81 -16
View File
@@ -194,13 +194,14 @@ export const EMAIL_BASE_CSS = `
/* "Even mail that styles itself" the second, opt-in switch, applied on top of /* "Even mail that styles itself" the second, opt-in switch, applied on top of
.themed. Everything the sender coloured is neutralised except the surfaces .themed. Everything the sender coloured is neutralised except the surfaces
marked by markKeptSurfaces() and their contents, so a white wrapper table marked by markKeptSurfaces() and what it marked as sitting on them, so a
white wrapper table
stops being a bright card while a blue button keeps its white label. The stops being a bright card while a blue button keeps its white label. The
sender's markup is untouched; this is all cascade, so the switch is sender's markup is untouched; this is all cascade, so the switch is
reversible and print still pins the tokens to ink on white. */ reversible and print still pins the tokens to ink on white. */
.ihm-email-root.forced { color: var(--fg, #1f2937) !important; background: var(--bg-elev, #fff) !important; } .ihm-email-root.forced { color: var(--fg, #1f2937) !important; background: var(--bg-elev, #fff) !important; }
.ihm-email-root.forced *:not([data-ihm-keep]):not([data-ihm-keep] *) { color: inherit !important; background-color: transparent !important; } .ihm-email-root.forced *:not([data-ihm-keep]):not([data-ihm-in-keep]) { color: inherit !important; background-color: transparent !important; }
.ihm-email-root.forced a:not([data-ihm-keep]):not([data-ihm-keep] *) { color: var(--link, #0f766e) !important; } .ihm-email-root.forced a:not([data-ihm-keep]):not([data-ihm-in-keep]) { color: var(--link, #0f766e) !important; }
`; `;
/** /**
@@ -275,6 +276,13 @@ export function relativeLuminance(color: string): number | null {
*/ */
export const LIGHT_SURFACE_LUMINANCE = 0.5; export const LIGHT_SURFACE_LUMINANCE = 0.5;
/** The background an element declares itself, or null if it declares none we can read. */
function declaredLuminance(el: HTMLElement): number | null {
const declared = el.getAttribute("bgcolor") ?? el.style?.backgroundColor ?? "";
if (!declared) return null;
return relativeLuminance(declared);
}
/** /**
* Mark the surfaces that must survive being themed, and count them. * Mark the surfaces that must survive being themed, and count them.
* *
@@ -285,26 +293,83 @@ export const LIGHT_SURFACE_LUMINANCE = 0.5;
* a **painted surface** a button, a banner which is kept whole so its * a **painted surface** a button, a banner which is kept whole so its
* label stays legible on it. * label stays legible on it.
* *
* Only the second is marked, with `data-ihm-keep`, and one CSS rule in * Two attributes come out of this. `data-ihm-keep` is a painted surface, which
* EMAIL_BASE_CSS neutralises everything that is not marked or inside something * keeps its own colours. `data-ihm-in-keep` is an element sitting on one with
* marked. Nothing the sender wrote is removed, so turning the switch off puts * no background of its own, whose colour is left alone so a white label on a
* the message back exactly as it was and a colour that arrived from a * blue button stays readable. One rule in EMAIL_BASE_CSS neutralises
* `<style>` block rather than an attribute is covered too, which is most of * everything else.
* them in modern templates. *
* The distinction that matters is that being *inside* a painted surface is not
* inherited past a sheet. A light table nested in a dark 600px card is still a
* sheet and is still neutralised that is issue #310, where a dark campaign
* rendered with beige cards inside it because the exemption used to be
* `[data-ihm-keep] *` in CSS and could not see the difference. Paint resumes
* below it: a dark button inside that nested table is kept as usual.
*
* Nothing the sender wrote is removed, so turning the switch off puts the
* message back exactly as it was and a colour that arrived from a `<style>`
* block rather than an attribute is covered too, which is most of them in
* modern templates.
*/ */
export function markKeptSurfaces(root: ParentNode): number { export function markKeptSurfaces(root: ParentNode): number {
let kept = 0; let kept = 0;
for (const el of Array.from(root.querySelectorAll<HTMLElement>("*"))) {
const declared = el.getAttribute("bgcolor") ?? el.style?.backgroundColor ?? ""; // An explicit stack rather than recursion: this walks untrusted mail, and
if (!declared) continue; // deeply nested tables are exactly what old newsletter HTML is made of.
const lum = relativeLuminance(declared); const stack: Array<{ el: HTMLElement; onPaint: boolean }> = [];
if (lum === null || lum >= LIGHT_SURFACE_LUMINANCE) continue; const push = (parent: ParentNode, onPaint: boolean) => {
el.setAttribute("data-ihm-keep", ""); for (const child of Array.from(parent.children)) {
kept++; stack.push({ el: child as HTMLElement, onPaint });
}
};
push(root, false);
while (stack.length) {
const { el, onPaint } = stack.pop()!;
const lum = declaredLuminance(el);
let childrenOnPaint = onPaint;
if (lum !== null && lum < LIGHT_SURFACE_LUMINANCE) {
// Painted: keep it whole, and anything on it inherits that protection.
el.setAttribute("data-ihm-keep", "");
kept++;
childrenOnPaint = true;
} else if (lum !== null) {
// A sheet, wherever it sits. Left unmarked so it neutralises, and it
// ends the protection rather than passing it on.
childrenOnPaint = false;
} else if (onPaint) {
// No background of its own, sitting on paint: leave its colour alone.
el.setAttribute("data-ihm-in-keep", "");
}
push(el, childrenOnPaint);
} }
return kept; return kept;
} }
/**
* Whether a message really has an HTML alternative to render.
*
* `htmlBody` is a *derived* list, not a filter: RFC 8621 §4.1.4 says a message
* with no HTML alternative still gets one, and it holds the text/plain part.
* Confirmed live against Stalwart 0.16.21 (2026-09-10) -- a plain-text mail
* comes back with `htmlBody` and `textBody` naming the same part, typed
* `text/plain`, while a real multipart/alternative names two different parts.
*
* So "is there a body value under htmlBody" is not the question; the part's own
* type is. Answering the first one sent every plain-text message down the HTML
* path, where the body is placed in `.ihm-email-root` under
* `white-space: normal` and every line break collapses -- hard-wrapped mail
* arrived as a single paragraph with the signature and the quoted reply run
* into the prose.
*/
export function hasHtmlAlternative(part: { type?: string } | undefined, value: string | undefined): boolean {
return /^text\/html\b/i.test(part?.type ?? "") && Boolean(value);
}
export const TEXT_EMAIL_CSS = ` export const TEXT_EMAIL_CSS = `
:host { display:block; } :host { display:block; }
.ihm-text-root { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-size: 13.5px; line-height:1.55; white-space: pre-wrap; overflow-wrap: anywhere; color: inherit; } .ihm-text-root { font-family: ui-monospace, SFMono-Regular, Menlo, Consolas, "Liberation Mono", monospace; font-size: 13.5px; line-height:1.55; white-space: pre-wrap; overflow-wrap: anywhere; color: inherit; }
+25 -1
View File
@@ -8,9 +8,33 @@ export function setBaseTitle(t: string) {
baseTitle = t; baseTitle = t;
} }
/** Update document title and favicon badge with unread count. */ /*
* The unread count on the installed app's icon.
*
* The title and the favicon below are the same idea for a tab, and an
* installed app has neither: in `display: standalone` there is no tab strip
* and no favicon anywhere on screen, so everything this file did for the
* unread count vanished at exactly the moment somebody put ihasmail on a home
* screen. The Badging API is where the count goes instead, and it is the one
* thing every phone user expects a mail icon to do.
*
* Silently nothing where it is unsupported, and silently nothing on iOS until
* notification permission has been granted, which is that platform's condition
* for showing a badge at all. Neither is worth reporting: a count that does not
* appear is not a failure anybody can act on.
*/
function setIconBadge(count: number): void {
if (!("setAppBadge" in navigator)) return;
const done = count > 0 ? navigator.setAppBadge(count) : navigator.clearAppBadge();
void done.catch(() => {
/* unsupported, or not permitted on this platform */
});
}
/** Update document title, favicon and app icon badge with unread count. */
export function setUnreadBadge(count: number): void { export function setUnreadBadge(count: number): void {
document.title = count > 0 ? `(${count > 999 ? "999+" : count}) ${baseTitle}` : baseTitle; document.title = count > 0 ? `(${count > 999 ? "999+" : count}) ${baseTitle}` : baseTitle;
setIconBadge(count);
try { try {
const link = document.querySelector<HTMLLinkElement>('link[rel="icon"][type="image/png"]'); const link = document.querySelector<HTMLLinkElement>('link[rel="icon"][type="image/png"]');
if (!link) return; if (!link) return;
+37
View File
@@ -0,0 +1,37 @@
/**
* What "open" means when conversation view is off.
*
* The setting used to reach only as far as the query -- it set `collapseThreads`
* and nothing else -- so the list showed individual messages while everything
* downstream still worked in threads. Opening one message highlighted every row
* in its thread and filled the reading pane with the whole conversation, which
* is exactly the grouping the setting was turned off to avoid.
*
* Both halves are the same question asked in two places, so they live together.
*/
import type { Id } from "@/jmap/types";
/**
* Whether a list row should be drawn as the open one.
*
* With a message singled out the row must match it exactly. Matching on the
* thread is what lit up every sibling.
*/
export function rowIsOpen(rowId: Id, rowThreadId: Id | undefined, openMessageId: Id | null, openThreadId: Id | null): boolean {
if (openMessageId) return rowId === openMessageId;
return Boolean(openThreadId) && rowThreadId === openThreadId;
}
/**
* The messages the reading pane should render.
*
* Falls back to the whole thread when the id names nothing in it. That is what
* a link from somebody with conversation view *on* looks like, and what a
* lingering `m` parameter looks like after the setting is switched back -- a
* conversation is a better answer to both than an empty pane.
*/
export function visibleMessages<T extends { id: Id }>(messages: T[], openMessageId: Id | null): T[] {
if (!openMessageId) return messages;
const single = messages.filter((m) => m.id === openMessageId);
return single.length ? single : messages;
}
+102
View File
@@ -0,0 +1,102 @@
/*
* The operating system's own share sheet.
*
* Everything that leaves ihasmail today leaves as a download, and on a phone a
* download is close to a dead end: the file lands in Downloads and the person
* who wanted to send it somewhere goes hunting for it in a file manager. Web
* Share hands the bytes straight to whatever they meant to send them to, which
* is the thing they were actually trying to do.
*
* Every entry point feature-detects and disappears where the API is not there
* rather than failing at the tap: `navigator.share` is absent on desktop Linux
* and in Firefox, exists on iOS and Android and on Windows and macOS Chrome,
* and file sharing is a separate question from sharing at all.
*/
/**
* What became of a share.
*
* `unsupported` is the interesting one: it says the share did not happen and
* the caller should do whatever it did before for an attachment, download
* it. It covers both "this browser cannot" and "this browser could not this
* time", because to the caller those are the same instruction.
*/
export type ShareOutcome = "shared" | "dismissed" | "unsupported";
/** Whether the browser can share at all. */
export function canShare(): boolean {
return typeof navigator !== "undefined" && typeof navigator.share === "function";
}
/*
* Whether it can share *files*, asked once and remembered.
*
* `canShare()` needs a real File to answer, and the answer is about the
* browser rather than about any particular file, so a one-byte probe settles
* it for the session. It has to be asked before there is anything to share:
* this is what decides whether a Share button is drawn at all, and drawing one
* that turns out to be a download in disguise is worse than not drawing it.
*
* A byte rather than an empty file on purpose an implementation is entitled
* to refuse a zero-length one, and being told "no" by the probe would hide the
* button everywhere.
*/
let fileShareSupported: boolean | null = null;
export function canShareFiles(): boolean {
if (fileShareSupported === null) {
try {
fileShareSupported =
canShare() &&
typeof navigator.canShare === "function" &&
navigator.canShare({ files: [new File(["x"], "probe.txt", { type: "text/plain" })] });
} catch {
fileShareSupported = false;
}
}
return fileShareSupported;
}
/** Reset the remembered probe. Tests only. */
export function resetShareSupport(): void {
fileShareSupported = null;
}
/** Share text, a title, a URL, or any combination the browser accepts. */
export async function shareText(data: { title?: string; text?: string; url?: string }): Promise<ShareOutcome> {
if (!canShare()) return "unsupported";
return await run(data);
}
/**
* Share one file. `unsupported` means nothing happened and the caller should
* fall back to a download.
*/
export async function shareFile(file: File, extra: { title?: string; text?: string } = {}): Promise<ShareOutcome> {
if (!canShare() || !navigator.canShare?.({ files: [file] })) return "unsupported";
return await run({ ...extra, files: [file] });
}
async function run(data: ShareData): Promise<ShareOutcome> {
try {
await navigator.share(data);
return "shared";
} catch (err) {
const name = err instanceof DOMException ? err.name : "";
// The sheet opened and was closed again. That is a decision, not a fault,
// and a toast for it would be scolding somebody for changing their mind.
if (name === "AbortError") return "dismissed";
/*
* `NotAllowedError` is reported as unsupported rather than raised, because
* what it nearly always means here is that the tap's transient activation
* ran out while the attachment downloaded. `share()` takes files and not a
* promise of them, so there is no way to open the sheet first and fill it
* afterwards the fetch has to happen inside the gesture's window, and on
* a slow connection and a large attachment it will sometimes not fit.
*
* The caller's fallback is a download, which is exactly what the button
* did before this existed, so the failure costs a tap rather than the file.
*/
if (name === "NotAllowedError") return "unsupported";
throw err;
}
}
+119
View File
@@ -0,0 +1,119 @@
/*
* Collecting a share the operating system sent us.
*
* The other end of `share_target` in the manifest: the system POSTs a form at
* `<base>/share`, the service worker takes the body and stashes it, and this
* is the tab picking it up. See the note on `stashShare` in sw.js for why the
* worker answers that request rather than the app or the server.
*
* The handoff goes through the cache rather than postMessage because a share
* usually launches the app: there is no tab to message at the moment it
* arrives, and the one that appears a second later is a different context that
* has to find the payload lying somewhere.
*/
import { withBase } from "./basePath";
import { SW_CACHE_NAME } from "./swCache";
export interface SharedContent {
title: string;
text: string;
url: string;
files: File[];
}
/** The worker writes here; both sides name it absolutely. */
const SHARE_KEY = "/ihasmail-share";
/*
* How long a share is worth acting on.
*
* It is collected on every app start rather than only when the launch URL says
* so, because the launch may not survive the trip: a share to a signed-out
* ihasmail lands on the sign-in page, and the composer can only open once
* there is an account to open it in. Waiting for that means the payload has to
* outlive a redirect and a login, which the query string does not.
*
* What that costs is the possibility of a stash nobody ever came back for, so
* it expires. Ten minutes is long enough for signing in -- password manager,
* app password, a second device -- and short enough that a share abandoned
* this morning does not open a composer full of a forgotten photo tonight.
*/
export const SHARE_MAX_AGE_MS = 10 * 60_000;
interface StashedFile {
key: string;
name: string;
type: string;
}
/**
* Take whatever the worker left, and leave nothing behind.
*
* Returns null when there is nothing waiting, which is almost every start.
* The entries are deleted whether or not the share is still worth opening: a
* stash that stayed would be collected on the next start instead, which is the
* expiry doing nothing.
*/
export async function collectShare(): Promise<SharedContent | null> {
if (typeof caches === "undefined") return null;
try {
const cache = await caches.open(SW_CACHE_NAME);
const key = withBase(SHARE_KEY);
const hit = await cache.match(key);
if (!hit) return null;
const meta = (await hit.json()) as Partial<SharedContent> & { at?: number; files?: StashedFile[] };
await cache.delete(key);
const files: File[] = [];
for (const f of meta.files ?? []) {
const res = await cache.match(f.key);
await cache.delete(f.key);
if (!res) continue;
/*
* The bytes, rather than the Blob holding them.
*
* `new File([blob], …)` is correct and works in a browser, but a Blob
* only counts as a part where the File constructor recognises it as one
* -- and where it does not, it is stringified instead, producing a file
* containing the thirteen characters "[object Blob]" and no error
* anywhere. That is exactly what CI caught on Node 22 while it passed
* here on 26. An ArrayBuffer is a part on any implementation, and this
* has the whole file in memory a moment later regardless: it is about to
* be uploaded as an attachment.
*/
files.push(new File([await res.arrayBuffer()], f.name, { type: f.type }));
}
if (typeof meta.at === "number" && Date.now() - meta.at > SHARE_MAX_AGE_MS) return null;
const share: SharedContent = {
title: meta.title ?? "",
text: meta.text ?? "",
url: meta.url ?? "",
files,
};
// A share with nothing in it is a share that went wrong upstream. Opening
// an empty composer over the inbox would be a worse account of that than
// opening nothing.
return share.title || share.text || share.url || files.length ? share : null;
} catch {
/* no cache, or nothing waiting: not a failure */
return null;
}
}
/**
* The shared text and the shared link as one body.
*
* What arrives in which field is up to whatever did the sharing, and they do
* not agree: a link from Chrome comes as a title and a `url`, from other apps
* as `text` that already *is* the link, and from a few as both. Appending it
* unconditionally would put the same URL in twice as often as not.
*/
export function shareBody(share: Pick<SharedContent, "text" | "url">): string {
const text = share.text.trim();
const url = share.url.trim();
if (!url || text.includes(url)) return text;
return text ? `${text}\n\n${url}` : url;
}
+14
View File
@@ -0,0 +1,14 @@
/**
* The name of the cache the service worker keeps.
*
* It is `VERSION` in `web/public/sw.js`, and the worker is not built from this
* source -- it is copied to `dist` verbatim, so nothing checks that the two
* agree. They have to: the worker uses that cache to leave things for a tab to
* collect when there was no tab to hand them to, and a name that has drifted
* does not fail, it silently finds nothing. A push verification never
* completes; a share arrives at an empty composer.
*
* One copy on this side of the line, so at least the app cannot disagree with
* itself.
*/
export const SW_CACHE_NAME = "ihasmail-v2";
+69
View File
@@ -0,0 +1,69 @@
/*
* What the service worker cannot work out for itself.
*
* The worker can act on mail see the note on `jmap()` in sw.js but it
* cannot read a catalogue or a store. It is plain JavaScript copied into the
* build, outside the bundle, with no i18n and no idea which mailbox is the
* archive. Both of those are things a tab knows and can simply write down.
*
* So the app leaves a short briefing in the same cache it uses for every other
* handoff, and the worker reads it when a notification arrives. Where there is
* none, the worker offers no actions at all rather than guessing: an untitled
* button that files mail somewhere is worse than a notification you have to
* open.
*
* That means the actions appear once ihasmail has been opened since the worker
* was installed, which is the same condition background notifications already
* carry a push subscription has to be renewed from a tab too.
*/
import { withBase } from "./basePath";
import { SW_CACHE_NAME } from "./swCache";
import { t } from "./i18n";
export const FACTS_KEY = "/ihasmail-worker-facts";
export interface WorkerFacts {
/** The account the notifications are about. */
accountId: string;
/** Where Archive files to; null where the account has no archive folder. */
archiveId: string | null;
/** The worker's own user-visible text, in the language this tab is in. */
strings: {
newMail: string;
newMessage: string;
noSubject: string;
archive: string;
markRead: string;
failed: string;
};
}
/**
* Write the briefing.
*
* Called again whenever what is in it could have changed the language, the
* account, the archive folder because it is what the worker will still be
* reading in a week's time. Rewriting it is one cache put; there is nothing to
* gain by working out whether it differs.
*/
export async function publishWorkerFacts(accountId: string | null, archiveId: string | null): Promise<void> {
if (typeof caches === "undefined" || !accountId) return;
const facts: WorkerFacts = {
accountId,
archiveId,
strings: {
newMail: t("New mail"),
newMessage: t("New message"),
noSubject: t("(no subject)"),
archive: t("Archive"),
markRead: t("Mark as read"),
failed: t("Could not do that — open ihasmail and try again"),
},
};
try {
const cache = await caches.open(SW_CACHE_NAME);
await cache.put(withBase(FACTS_KEY), new Response(JSON.stringify(facts), { headers: { "content-type": "application/json" } }));
} catch {
/* no cache storage: the worker falls back to a notification with no actions */
}
}
+2 -1
View File
@@ -7,6 +7,7 @@
*/ */
import { CAP } from "@/jmap/client"; import { CAP } from "@/jmap/client";
import { withBase } from "./basePath"; import { withBase } from "./basePath";
import { SW_CACHE_NAME } from "./swCache";
import { isDeviceTrusted } from "@/lib/storage"; import { isDeviceTrusted } from "@/lib/storage";
import { useSession } from "@/store/session"; import { useSession } from "@/store/session";
import { useMail } from "@/store/mail"; import { useMail } from "@/store/mail";
@@ -48,7 +49,7 @@ export function listenForVerification(): void {
/** Pick up a code that arrived while no tab was open. */ /** Pick up a code that arrived while no tab was open. */
async function collectStoredVerification(): Promise<void> { async function collectStoredVerification(): Promise<void> {
try { try {
const cache = await caches.open("ihasmail-v2"); const cache = await caches.open(SW_CACHE_NAME);
// The same absolute key the worker writes. Relative would be resolved // The same absolute key the worker writes. Relative would be resolved
// against this document's URL, which is a different place on every route. // against this document's URL, which is a different place on every route.
const key = withBase("/ihasmail-push-verification"); const key = withBase("/ihasmail-push-verification");
+157 -12
View File
@@ -55,6 +55,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Domains",
"By hand": "Manuell",
"Signing": "Signiert",
"Published, not signing yet": "Veröffentlicht, signiert noch nicht",
"Retiring": "Wird ausgemustert",
"Retired": "Ausgemustert",
"This domain no longer exists. Someone may have removed it.": "Diese Domain existiert nicht mehr. Möglicherweise hat sie jemand entfernt.",
"That doesn't look like a domain name, such as example.com.": "Das sieht nicht nach einem Domainnamen wie example.com aus.",
"Added {name}. Its DNS records are ready to copy.": "{name} hinzugefügt. Die DNS-Einträge können kopiert werden.",
"Saved {name}": "{name} gespeichert",
"Add domain": "Domain hinzufügen",
"Added {date}": "Hinzugefügt am {date}",
"This domain is disabled on the server.": "Diese Domain ist auf dem Server deaktiviert.",
"Your role lets you view domains but not change them.": "Ihre Rolle erlaubt es, Domains anzusehen, aber nicht zu ändern.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Neue Domains signieren ihre E-Mails mit DKIM-Schlüsseln, die der Server erstellt und wechselt. Die DNS-Einträge erscheinen hier, sobald die Domain hinzugefügt ist.",
"Other names": "Weitere Namen",
"Delivery": "Zustellung",
"Catch-all address": "Sammeladresse",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "E-Mails an eine Adresse, die auf dieser Domain niemand hat, werden hierher zugestellt. Leer lassen, um sie abzulehnen.",
"Plus addressing": "Plus-Adressierung",
"Set by a custom rule on the server.": "Durch eine eigene Regel auf dem Server festgelegt.",
"Mail to name+anything@ is delivered to name@.": "E-Mails an name+beliebig@ werden an name@ zugestellt.",
"DNS records": "DNS-Einträge",
"Published automatically through {provider}.": "Automatisch über {provider} veröffentlicht.",
"Published automatically by the server.": "Automatisch vom Server veröffentlicht.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Tragen Sie diese dort ein, wo das DNS dieser Domain verwaltet wird. Bis dahin werden E-Mails weder zugestellt noch als vertrauenswürdig eingestuft.",
"Copy {type} record for {name}": "{type}-Eintrag für {name} kopieren",
"Copy value": "Wert kopieren",
"Copied the zone file": "Zonendatei kopiert",
"Copy all as a zone file": "Alles als Zonendatei kopieren",
"The server returned no records for this domain.": "Der Server hat für diese Domain keine Einträge geliefert.",
"DKIM keys": "DKIM-Schlüssel",
"The server creates and rotates these keys itself.": "Der Server erstellt und wechselt diese Schlüssel selbst.",
"These keys are managed by hand on the server.": "Diese Schlüssel werden auf dem Server manuell verwaltet.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "Keine DKIM-Schlüssel: E-Mails von dieser Domain werden nicht signiert und landen eher im Spam.",
"Managed by the server": "Vom Server verwaltet",
"Certificate": "Zertifikat",
"Another name for this domain": "Weiterer Name für diese Domain",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "E-Mails an dieselbe Adresse unter einem dieser Namen erreichen dasselbe Konto. Änderungen gelten nach dem Speichern.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "Zuerst müssen die DKIM-Schlüssel entfernt werden, und Ihre Rolle darf sie nicht entfernen.",
"The server stops accepting mail for this domain.": "Der Server nimmt keine E-Mails mehr für diese Domain an.",
"Remove domain…": "Domain entfernen…",
"Remove {name}?": "{name} entfernen?",
"Removed {name}": "{name} entfernt",
"The server kept the domain: it is still used by {things}.": "Der Server hat die Domain behalten: Sie wird noch verwendet von {things}.",
"Remove domain": "Domain entfernen",
"The server stops accepting mail for this domain. This can't be undone.": "Der Server nimmt keine E-Mails mehr für diese Domain an. Dies kann nicht rückgängig gemacht werden.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Wo Ihre Adressen liegen, und die DNS-Einträge, damit E-Mails ankommen und als vertrauenswürdig gelten.",
"Search domains": "Domains durchsuchen",
"No domains match": "Keine passenden Domains",
"No domains yet": "Noch keine Domains",
"DKIM": "DKIM",
"Tenant": "Mandant",
"Disabled": "Deaktiviert",
"also {names}": "auch {names}",
"The server did not say whether the domain was created.": "Der Server hat nicht mitgeteilt, ob die Domain angelegt wurde.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Das ist kein gültiger Domainname. Verwenden Sie einen Namen wie example.com mit einer echten Top-Level-Domain.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Das ist keine gültige E-Mail-Adresse. Verwenden Sie eine vollständige Adresse wie [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Das ist keine gültige Adresse. Verwenden Sie vor dem @ Buchstaben, Ziffern, Punkte, Bindestriche oder Unterstriche.",
"That isn't a valid host name or IP address.": "Das ist kein gültiger Hostname und keine gültige IP-Adresse.",
"A required value was left empty.": "Ein erforderlicher Wert wurde leer gelassen.",
"Administration is turned off on this installation.": "Die Verwaltung ist in dieser Installation deaktiviert.",
"The mail server could not carry out the request ({code}).": "Der Mailserver konnte die Anfrage nicht ausführen ({code}).",
"You can't give an account permissions your own role doesn't have.": "Sie können einem Konto keine Berechtigungen geben, die Ihre eigene Rolle nicht hat.",
"This account signs in through an external directory, so its password can't be set here.": "Dieses Konto meldet sich über ein externes Verzeichnis an, daher kann sein Passwort hier nicht festgelegt werden.",
"The server's licence allows no more accounts.": "Die Lizenz des Servers erlaubt keine weiteren Konten.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Dieser Domainname wird auf diesem Server bereits verwendet als Domain oder als weiterer Name einer anderen Domain.",
"Your organisation has reached the number of domains it is allowed.": "Ihre Organisation hat die Anzahl der erlaubten Domains erreicht.",
"That is more than the mail server accepts in one change.": "Das ist mehr, als der Mailserver in einer Änderung annimmt.",
"The mail server rejected one of the values. Check what you entered and try again.": "Der Mailserver hat einen der Werte abgelehnt. Prüfen Sie Ihre Eingaben und versuchen Sie es erneut.",
"The mail server refused the change ({code}).": "Der Mailserver hat die Änderung abgelehnt ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Nur auf einem Gerät, das Sie als Ihr eigenes markiert haben. Melden Sie sich erneut an und setzen Sie das Häkchen bei „Das ist mein eigenes Gerät“.",
"Change your own password in {settings}.": "Ihr eigenes Passwort ändern Sie unter {settings}.",
"Administration": "Verwaltung",
"Directory": "Verzeichnis",
"User": "Benutzer",
"Administrator": "Administrator",
"Custom role": "Eigene Rolle",
"New account": "Neues Konto",
"The people who sign in to mail on the domains you manage.": "Die Personen, die sich auf den von Ihnen verwalteten Domains bei ihrer E-Mail anmelden.",
"Search by name or address": "Nach Name oder Adresse suchen",
"Search accounts": "Konten durchsuchen",
"No accounts match": "Keine passenden Konten",
"No accounts yet": "Noch keine Konten",
"Nothing on your domains matches “{query}”.": "Auf Ihren Domains passt nichts zu „{query}“.",
"Open {address}": "{address} öffnen",
"{from}{to} of {total}": "{from}{to} von {total}",
"Previous page": "Vorherige Seite",
"Next page": "Nächste Seite",
"Storage": "Speicher",
"Groups": "Gruppen",
"{used} · no limit": "{used} · ohne Begrenzung",
"Profile": "Profil",
"Domain": "Domain",
"No domains are available to create an account on.": "Es gibt keine Domain, auf der ein Konto angelegt werden kann.",
"Sign-in": "Anmeldung",
"Other addresses": "Weitere Adressen",
"Not in any group": "In keiner Gruppe",
"You can't change your own role.": "Sie können Ihre eigene Rolle nicht ändern.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Angeboten werden nur Rollen, deren Berechtigungen Sie selbst besitzen. Bei einem Konto innerhalb eines Mandanten bedeutet Administrator: Administrator dieses Mandanten.",
"Limit in GB": "Begrenzung in GB",
"No limit": "Ohne Begrenzung",
"This account has permissions yours doesn't, so you can view it but not change it.": "Dieses Konto hat Berechtigungen, die Ihres nicht hat. Sie können es ansehen, aber nicht ändern.",
"Your role lets you view accounts but not change them.": "Ihre Rolle erlaubt es, Konten anzusehen, aber nicht zu ändern.",
"This account has permissions yours doesn't.": "Dieses Konto hat Berechtigungen, die Ihres nicht hat.",
"You can't delete the account you're signed in with.": "Das Konto, mit dem Sie angemeldet sind, können Sie nicht löschen.",
"Create account": "Konto anlegen",
"An account needs an address.": "Ein Konto braucht eine Adresse.",
"Created {address}": "{address} angelegt",
"Saved {address}": "{address} gespeichert",
"Generate a password": "Passwort erzeugen",
"Pass it on some way other than email to this address.": "Geben Sie es nicht per E-Mail an diese Adresse weiter.",
"This account has no password. It may sign in through a directory or single sign-on.": "Dieses Konto hat kein Passwort. Möglicherweise meldet es sich über ein Verzeichnis oder Single Sign-on an.",
"Set a new password…": "Neues Passwort festlegen…",
"{name} will be signed out of every app and device using the old password.": "{name} wird in allen Apps und auf allen Geräten abgemeldet, die das alte Passwort verwenden.",
"New password set for {address}": "Neues Passwort für {address} festgelegt",
"Set password": "Passwort festlegen",
"Remove {address}": "{address} entfernen",
"New address": "Neue Adresse",
"another name": "anderer Name",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "E-Mails an diese Adressen werden diesem Konto zugestellt. Änderungen gelten nach dem Speichern.",
"Deletes the mailbox and everything in it.": "Löscht das Postfach und alles darin.",
"Delete account…": "Konto löschen…",
"Delete {address}?": "{address} löschen?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Dadurch werden die E-Mails, Kalender, Kontakte und Dateien dieses Kontos gelöscht. Der Server entfernt sie im Hintergrund, und es kann nicht rückgängig gemacht werden.",
"Type {address} to confirm": "Zur Bestätigung {address} eingeben",
"Delete account": "Konto löschen",
"Deleted {address}": "{address} gelöscht",
"The server did not say whether the account was created.": "Der Server hat nicht mitgeteilt, ob das Konto angelegt wurde.",
"The mail server refused this. Your role may not allow it.": "Der Mailserver hat dies abgelehnt. Ihre Rolle erlaubt es möglicherweise nicht.",
"That address is already in use on this server, as an account, a list or an alias.": "Diese Adresse wird auf diesem Server bereits verwendet als Konto, Liste oder Alias.",
"One of the chosen domain, role or group can't be used for this account.": "Die gewählte Domain, Rolle oder Gruppe kann für dieses Konto nicht verwendet werden.",
"Your organisation has reached the number of accounts it is allowed.": "Ihre Organisation hat die Anzahl der erlaubten Konten erreicht.",
"Something still depends on this, so the server kept it.": "Etwas hängt noch davon ab, daher hat der Server es behalten.",
"This account no longer exists. Someone may have deleted it.": "Dieses Konto existiert nicht mehr. Möglicherweise hat es jemand gelöscht.",
"The password was not accepted: {reason}": "Das Passwort wurde nicht akzeptiert: {reason}",
"The password was not accepted.": "Das Passwort wurde nicht akzeptiert.",
"Go to folder…": "Zu Ordner springen…", "Go to folder…": "Zu Ordner springen…",
"Set for everyone here. You cannot change this.": "Für alle hier festgelegt. Sie können dies nicht ändern.", "Set for everyone here. You cannot change this.": "Für alle hier festgelegt. Sie können dies nicht ändern.",
"Export iCAL file": "iCAL-Datei exportieren", "Export iCAL file": "iCAL-Datei exportieren",
@@ -327,7 +467,6 @@ export const catalog: Catalog = {
"Busy": "Gebucht", "Busy": "Gebucht",
"Free/busy": "Frei/Gebucht", "Free/busy": "Frei/Gebucht",
"Show as": "Anzeigen als", "Show as": "Anzeigen als",
"Availability on {date}": "Verfügbarkeit am {date}",
"Count all events as busy": "Alle Termine als gebucht zählen", "Count all events as busy": "Alle Termine als gebucht zählen",
"Only events I'm attending": "Nur Termine, an denen ich teilnehme", "Only events I'm attending": "Nur Termine, an denen ich teilnehme",
"Don't include in availability": "Nicht in die Verfügbarkeit einbeziehen", "Don't include in availability": "Nicht in die Verfügbarkeit einbeziehen",
@@ -366,7 +505,6 @@ export const catalog: Catalog = {
"New address book": "Neues Adressbuch", "New address book": "Neues Adressbuch",
"No address books yet.": "Noch keine Adressbücher.", "No address books yet.": "Noch keine Adressbücher.",
"Choose from address books": "Aus Adressbüchern wählen", "Choose from address books": "Aus Adressbüchern wählen",
"Import vCard": "vCard importieren",
"Export all contacts": "Alle Kontakte exportieren", "Export all contacts": "Alle Kontakte exportieren",
"Export address book": "Dieses Adressbuch exportieren", "Export address book": "Dieses Adressbuch exportieren",
"Import contacts…": "Kontakte importieren…", "Import contacts…": "Kontakte importieren…",
@@ -437,7 +575,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Machen Sie ihasmail zu Ihrem.", "Make ihasmail yours.": "Machen Sie ihasmail zu Ihrem.",
"Reading": "Lesen", "Reading": "Lesen",
"Reading pane": "Lesebereich", "Reading pane": "Lesebereich",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Verhalten beim Lesen, Senden und in der Liste. Die Einstellungen werden in diesem Browser gespeichert.",
"Right of the list": "Rechts von der Liste", "Right of the list": "Rechts von der Liste",
"Below the list": "Unter der Liste", "Below the list": "Unter der Liste",
"Hidden (open full width)": "Ausgeblendet (in voller Breite öffnen)", "Hidden (open full width)": "Ausgeblendet (in voller Breite öffnen)",
@@ -714,8 +851,6 @@ export const catalog: Catalog = {
"Manage labels": "Labels verwalten", "Manage labels": "Labels verwalten",
"Create “{name}”": "„{name}“ erstellen", "Create “{name}”": "„{name}“ erstellen",
"Type a name to create your first label.": "Geben Sie einen Namen ein, um Ihr erstes Label zu erstellen.", "Type a name to create your first label.": "Geben Sie einen Namen ein, um Ihr erstes Label zu erstellen.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Labels sind IMAP-Schlüsselwörter, die in Ihren Nachrichten gespeichert werden und daher mit anderen Clients synchronisiert werden. Namen und Farben bleiben in diesem Browser.",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Große Anhänge werden von manchen Servern abgelehnt", "Large attachments may be rejected by some servers": "Große Anhänge werden von manchen Servern abgelehnt",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Bilder werden in Ihren Dateien (Ordner „ihasmail“) gespeichert und beim Senden eingebettet.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Bilder werden in Ihren Dateien (Ordner „ihasmail“) gespeichert und beim Senden eingebettet.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Vielen Dank für Ihre Nachricht. Ich bin bis … abwesend und melde mich nach meiner Rückkehr.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Vielen Dank für Ihre Nachricht. Ich bin bis … abwesend und melde mich nach meiner Rückkehr.",
@@ -756,6 +891,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Öffnen Sie die E-Mail-Ansicht, um alle Tastenkürzel zu sehen.", "Open the Mail view to see all shortcuts.": "Öffnen Sie die E-Mail-Ansicht, um alle Tastenkürzel zu sehen.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Tastenkürzel im Gmail-Stil sind immer aktiv. Drücken Sie überall {key}, um diese Liste zu sehen.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Tastenkürzel im Gmail-Stil sind immer aktiv. Drücken Sie überall {key}, um diese Liste zu sehen.",
"Select a conversation to read it here · Press {key} for shortcuts": "Wählen Sie eine Konversation, um sie hier zu lesen · {key} für Tastenkürzel", "Select a conversation to read it here · Press {key} for shortcuts": "Wählen Sie eine Konversation, um sie hier zu lesen · {key} für Tastenkürzel",
"Select a message to read it here · Press {key} for shortcuts": "Wählen Sie eine Nachricht, um sie hier zu lesen · {key} für Tastenkürzel",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Tipp: Drücken Sie {key} auf einer Konversation, um Labels zu vergeben. Suchen Sie mit {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Tipp: Drücken Sie {key} auf einer Konversation, um Labels zu vergeben. Suchen Sie mit {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Eine schnelle, freundliche Open-Source-Webmail für {server}, auf JMAP aufgebaut.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Eine schnelle, freundliche Open-Source-Webmail für {server}, auf JMAP aufgebaut.",
"Defaults for the calendar views and new events.": "Vorgaben für die Kalenderansichten und neue Termine.", "Defaults for the calendar views and new events.": "Vorgaben für die Kalenderansichten und neue Termine.",
@@ -834,19 +970,15 @@ export const catalog: Catalog = {
"Nothing": "Nichts", "Nothing": "Nichts",
"No conversation selected": "Keine Konversation ausgewählt", "No conversation selected": "Keine Konversation ausgewählt",
"No message selected": "Keine Nachricht ausgewählt",
"Drop here for the top level": "Hierher ziehen für die oberste Ebene", "Drop here for the top level": "Hierher ziehen für die oberste Ebene",
// ── Remaining prose ──────────────────────────────────────────────── // ── Remaining prose ────────────────────────────────────────────────
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} ist die Farbpalette von {site} und das, womit ein neues Konto startet. Es ist ein dunkles Design und zählt daher überall dort als dunkel, wo das eine Rolle spielt; die Akzentfarbe unten wirkt weiterhin darauf.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "Die Version von ihasmail ist das Datum des Commits, aus dem es gebaut wurde, gefolgt davon, woher dieser Commit stammt: {example} wurde aus einem Commit vom 30. August 2026 gebaut, der über Pull Request 129 kam. Ein Commit, der nicht über einen solchen kam, trägt stattdessen seinen kurzen SHA — {sha}. Die Version sagt bewusst nichts über Stalwart aus; was dieser Build vom Server benötigt, steht in der Zeile darüber.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "Die Version von ihasmail ist das Datum des Commits, aus dem es gebaut wurde, gefolgt davon, woher dieser Commit stammt: {example} wurde aus einem Commit vom 30. August 2026 gebaut, der über Pull Request 129 kam. Ein Commit, der nicht über einen solchen kam, trägt stattdessen seinen kurzen SHA — {sha}. Die Version sagt bewusst nichts über Stalwart aus; was dieser Build vom Server benötigt, steht in der Zeile darüber.",
// ── Weekdays, schedule presets, rule operators ───────────────────── // ── Weekdays, schedule presets, rule operators ─────────────────────
// Header names (List-Id, X-Spam-Status) stay English: they are the actual // Header names (List-Id, X-Spam-Status) stay English: they are the actual
// field names in the message, not words. // field names in the message, not words.
"Tuesday": "Dienstag",
"Wednesday": "Mittwoch",
"Thursday": "Donnerstag",
"Friday": "Freitag",
"Later today": "Später heute", "Later today": "Später heute",
"Tomorrow morning": "Morgen früh", "Tomorrow morning": "Morgen früh",
"Tomorrow afternoon": "Morgen Nachmittag", "Tomorrow afternoon": "Morgen Nachmittag",
@@ -880,6 +1012,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Spam", "folder\u0004Junk Mail": "Spam",
"folder\u0004Important": "Wichtig", "folder\u0004Important": "Wichtig",
"folder\u0004All mail": "Alle Nachrichten", "folder\u0004All mail": "Alle Nachrichten",
"share sheet\u0004Share": "Teilen",
"share sheet\u0004Share…": "Teilen…",
"folder": "Ordner", "folder": "Ordner",
"“{name}” moved into “{parent}”": "„{name}“ wurde nach „{parent}“ verschoben", "“{name}” moved into “{parent}”": "„{name}“ wurde nach „{parent}“ verschoben",
"“{name}” moved to the top level": "„{name}“ wurde auf die oberste Ebene verschoben", "“{name}” moved to the top level": "„{name}“ wurde auf die oberste Ebene verschoben",
@@ -890,6 +1024,8 @@ export const catalog: Catalog = {
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Neue Nachricht", "New message": "Neue Nachricht",
"New mail": "Neue E-Mail",
"Could not do that — open ihasmail and try again": "Nicht möglich öffnen Sie ihasmail und versuchen Sie es erneut",
"Sending…": "Wird gesendet…", "Sending…": "Wird gesendet…",
"Saving…": "Wird gespeichert…", "Saving…": "Wird gespeichert…",
"Error": "Fehler", "Error": "Fehler",
@@ -930,6 +1066,7 @@ export const catalog: Catalog = {
"Could not copy the address": "Die Adresse konnte nicht kopiert werden", "Could not copy the address": "Die Adresse konnte nicht kopiert werden",
"Could not empty folder: {error}": "Ordner konnte nicht geleert werden: {error}", "Could not empty folder: {error}": "Ordner konnte nicht geleert werden: {error}",
"Could not load source: {error}": "Quelltext konnte nicht geladen werden: {error}", "Could not load source: {error}": "Quelltext konnte nicht geladen werden: {error}",
"Could not share: {error}": "Teilen nicht möglich: {error}",
"Could not mark as read: {error}": "Konnte nicht als gelesen markiert werden: {error}", "Could not mark as read: {error}": "Konnte nicht als gelesen markiert werden: {error}",
"Could not save draft: {error}": "Entwurf konnte nicht gespeichert werden: {error}", "Could not save draft: {error}": "Entwurf konnte nicht gespeichert werden: {error}",
"Could not save filter: {error}": "Filter konnte nicht gespeichert werden: {error}", "Could not save filter: {error}": "Filter konnte nicht gespeichert werden: {error}",
@@ -1378,6 +1515,15 @@ export const catalog: Catalog = {
"no address": "keine Adresse", "no address": "keine Adresse",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "{n} Konto verwendet diese Domain. Verschieben oder löschen Sie es zuerst.", other: "{n} Konten verwenden diese Domain. Verschieben oder löschen Sie sie zuerst." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "Der Server nimmt keine E-Mails mehr für diese Domain an, und ihr {n} DKIM-Schlüssel wird gelöscht. Dies kann nicht rückgängig gemacht werden.", other: "Der Server nimmt keine E-Mails mehr für diese Domain an, und ihre {n} DKIM-Schlüssel werden gelöscht. Dies kann nicht rückgängig gemacht werden." },
"{n} domains": { one: "{n} Domain", other: "{n} Domains" },
"{n} mailing lists": { one: "{n} Mailingliste", other: "{n} Mailinglisten" },
"{n} DKIM keys": { one: "{n} DKIM-Schlüssel", other: "{n} DKIM-Schlüssel" },
"{n} other items": { one: "{n} weiteres Objekt", other: "{n} weitere Objekte" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} Konto", other: "{n} Konten" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "{n} Element löschen", other: "{n} Elemente löschen" }, "Delete {n} items": { one: "{n} Element löschen", other: "{n} Elemente löschen" },
"Delete {n} items?": { one: "{n} Element löschen?", other: "{n} Elemente löschen?" }, "Delete {n} items?": { one: "{n} Element löschen?", other: "{n} Elemente löschen?" },
@@ -1407,8 +1553,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Ihre Administration hat {n} Einstellung geändert", other: "Ihre Administration hat {n} Einstellungen geändert" }, "Your administrator changed {n} settings": { one: "Ihre Administration hat {n} Einstellung geändert", other: "Ihre Administration hat {n} Einstellungen geändert" },
"Exported {n} events": { one: "{n} Termin exportiert", other: "{n} Termine exportiert" }, "Exported {n} events": { one: "{n} Termin exportiert", other: "{n} Termine exportiert" },
"Imported {n} events": { one: "{n} Termin importiert", other: "{n} Termine importiert" }, "Imported {n} events": { one: "{n} Termin importiert", other: "{n} Termine importiert" },
"Already here: {n} events, nothing imported": { one: "Bereits vorhanden: {n} Termin, nichts importiert", other: "Bereits vorhanden: {n} Termine, nichts importiert" }, "Updated {n} events, nothing new": { one: "{n} Termin aktualisiert, nichts Neues", other: "{n} Termine aktualisiert, nichts Neues" },
"{n} were already here": { one: "{n} war bereits vorhanden", other: "{n} waren bereits vorhanden" },
"{n} messages": { one: "{n} Nachricht", other: "{n} Nachrichten" }, "{n} messages": { one: "{n} Nachricht", other: "{n} Nachrichten" },
"{n} selected": { one: "{n} ausgewählt", other: "{n} ausgewählt" }, "{n} selected": { one: "{n} ausgewählt", other: "{n} ausgewählt" },
"{n} conversations": { one: "{n} Konversation", other: "{n} Konversationen" }, "{n} conversations": { one: "{n} Konversation", other: "{n} Konversationen" },
+157 -12
View File
@@ -47,6 +47,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Dominios",
"By hand": "Manual",
"Signing": "Firmando",
"Published, not signing yet": "Publicada, aún no firma",
"Retiring": "Retirándose",
"Retired": "Retirada",
"This domain no longer exists. Someone may have removed it.": "Este dominio ya no existe. Puede que alguien lo haya quitado.",
"That doesn't look like a domain name, such as example.com.": "Eso no parece un nombre de dominio, como example.com.",
"Added {name}. Its DNS records are ready to copy.": "{name} añadido. Sus registros DNS están listos para copiar.",
"Saved {name}": "{name} guardado",
"Add domain": "Añadir dominio",
"Added {date}": "Añadido el {date}",
"This domain is disabled on the server.": "Este dominio está desactivado en el servidor.",
"Your role lets you view domains but not change them.": "Su rol le permite ver los dominios, pero no modificarlos.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Los dominios nuevos firman su correo con claves DKIM que el servidor crea y renueva. Sus registros DNS aparecen aquí una vez añadido.",
"Other names": "Otros nombres",
"Delivery": "Entrega",
"Catch-all address": "Dirección comodín",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "El correo a una dirección que nadie tiene en este dominio se entrega aquí. Déjelo vacío para rechazarlo.",
"Plus addressing": "Subdirecciones con +",
"Set by a custom rule on the server.": "Definido por una regla personalizada en el servidor.",
"Mail to name+anything@ is delivered to name@.": "El correo a nombre+loquesea@ se entrega a nombre@.",
"DNS records": "Registros DNS",
"Published automatically through {provider}.": "Publicados automáticamente mediante {provider}.",
"Published automatically by the server.": "Publicados automáticamente por el servidor.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Añádalos donde esté alojado el DNS de este dominio. El correo no se entrega ni se considera fiable hasta que estén.",
"Copy {type} record for {name}": "Copiar el registro {type} de {name}",
"Copy value": "Copiar valor",
"Copied the zone file": "Archivo de zona copiado",
"Copy all as a zone file": "Copiar todo como archivo de zona",
"The server returned no records for this domain.": "El servidor no devolvió registros para este dominio.",
"DKIM keys": "Claves DKIM",
"The server creates and rotates these keys itself.": "El servidor crea y renueva estas claves por sí mismo.",
"These keys are managed by hand on the server.": "Estas claves se gestionan manualmente en el servidor.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "No hay claves DKIM, así que el correo de este dominio no se firma y es más probable que se marque como spam.",
"Managed by the server": "Gestionado por el servidor",
"Certificate": "Certificado",
"Another name for this domain": "Otro nombre para este dominio",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "El correo a la misma dirección con cualquiera de estos nombres llega a la misma cuenta. Los cambios se aplican al guardar.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "Primero hay que quitar sus claves DKIM, y su rol no puede quitarlas.",
"The server stops accepting mail for this domain.": "El servidor deja de aceptar correo para este dominio.",
"Remove domain…": "Quitar dominio…",
"Remove {name}?": "¿Quitar {name}?",
"Removed {name}": "{name} quitado",
"The server kept the domain: it is still used by {things}.": "El servidor ha conservado el dominio: todavía lo usa {things}.",
"Remove domain": "Quitar dominio",
"The server stops accepting mail for this domain. This can't be undone.": "El servidor deja de aceptar correo para este dominio. No se puede deshacer.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Dónde viven sus direcciones y los registros DNS que permiten que el correo llegue y sea de confianza.",
"Search domains": "Buscar dominios",
"No domains match": "Ningún dominio coincide",
"No domains yet": "Todavía no hay dominios",
"DKIM": "DKIM",
"Tenant": "Inquilino",
"Disabled": "Desactivado",
"also {names}": "también {names}",
"The server did not say whether the domain was created.": "El servidor no indicó si el dominio se creó.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Ese no es un nombre de dominio válido. Use un nombre como example.com, con un dominio de nivel superior real.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Esa no es una dirección de correo válida. Use una dirección completa, como [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Esa no es una dirección válida. Use letras, números, puntos, guiones o guiones bajos antes de la @.",
"That isn't a valid host name or IP address.": "Ese no es un nombre de host ni una dirección IP válidos.",
"A required value was left empty.": "Se dejó vacío un valor obligatorio.",
"Administration is turned off on this installation.": "La administración está desactivada en esta instalación.",
"The mail server could not carry out the request ({code}).": "El servidor de correo no pudo completar la solicitud ({code}).",
"You can't give an account permissions your own role doesn't have.": "No puede dar a una cuenta permisos que su propio rol no tiene.",
"This account signs in through an external directory, so its password can't be set here.": "Esta cuenta inicia sesión mediante un directorio externo, así que su contraseña no se puede establecer aquí.",
"The server's licence allows no more accounts.": "La licencia del servidor no permite más cuentas.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Ese nombre de dominio ya está en uso en este servidor, como dominio o como otro nombre de otro dominio.",
"Your organisation has reached the number of domains it is allowed.": "Su organización ha alcanzado el número de dominios permitido.",
"That is more than the mail server accepts in one change.": "Eso supera lo que el servidor de correo acepta en un solo cambio.",
"The mail server rejected one of the values. Check what you entered and try again.": "El servidor de correo ha rechazado uno de los valores. Revise lo que ha escrito e inténtelo de nuevo.",
"The mail server refused the change ({code}).": "El servidor de correo ha rechazado el cambio ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Solo en un dispositivo que haya marcado como suyo. Vuelva a iniciar sesión con «Este es mi propio dispositivo» marcado.",
"Change your own password in {settings}.": "Cambie su propia contraseña en {settings}.",
"Administration": "Administración",
"Directory": "Directorio",
"User": "Usuario",
"Administrator": "Administrador",
"Custom role": "Rol personalizado",
"New account": "Nueva cuenta",
"The people who sign in to mail on the domains you manage.": "Las personas que inician sesión en el correo en los dominios que usted administra.",
"Search by name or address": "Buscar por nombre o dirección",
"Search accounts": "Buscar cuentas",
"No accounts match": "Ninguna cuenta coincide",
"No accounts yet": "Todavía no hay cuentas",
"Nothing on your domains matches “{query}”.": "Nada en sus dominios coincide con «{query}».",
"Open {address}": "Abrir {address}",
"{from}{to} of {total}": "{from}{to} de {total}",
"Previous page": "Página anterior",
"Next page": "Página siguiente",
"Storage": "Almacenamiento",
"Groups": "Grupos",
"{used} · no limit": "{used} · sin límite",
"Profile": "Perfil",
"Domain": "Dominio",
"No domains are available to create an account on.": "No hay ningún dominio disponible en el que crear una cuenta.",
"Sign-in": "Inicio de sesión",
"Other addresses": "Otras direcciones",
"Not in any group": "No pertenece a ningún grupo",
"You can't change your own role.": "No puede cambiar su propio rol.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Solo se ofrecen los roles cuyos permisos usted tiene. En una cuenta dentro de un inquilino, Administrador significa administrador de ese inquilino.",
"Limit in GB": "Límite en GB",
"No limit": "Sin límite",
"This account has permissions yours doesn't, so you can view it but not change it.": "Esta cuenta tiene permisos que la suya no tiene, así que puede verla pero no modificarla.",
"Your role lets you view accounts but not change them.": "Su rol le permite ver las cuentas, pero no modificarlas.",
"This account has permissions yours doesn't.": "Esta cuenta tiene permisos que la suya no tiene.",
"You can't delete the account you're signed in with.": "No puede eliminar la cuenta con la que ha iniciado sesión.",
"Create account": "Crear cuenta",
"An account needs an address.": "Una cuenta necesita una dirección.",
"Created {address}": "{address} creada",
"Saved {address}": "{address} guardada",
"Generate a password": "Generar una contraseña",
"Pass it on some way other than email to this address.": "Comuníquela por otro medio que no sea un correo a esta dirección.",
"This account has no password. It may sign in through a directory or single sign-on.": "Esta cuenta no tiene contraseña. Puede que inicie sesión mediante un directorio o un inicio de sesión único.",
"Set a new password…": "Establecer una contraseña nueva…",
"{name} will be signed out of every app and device using the old password.": "Se cerrará la sesión de {name} en todas las aplicaciones y dispositivos que usen la contraseña anterior.",
"New password set for {address}": "Nueva contraseña establecida para {address}",
"Set password": "Establecer contraseña",
"Remove {address}": "Quitar {address}",
"New address": "Nueva dirección",
"another name": "otro nombre",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "El correo enviado a estas direcciones se entrega a esta cuenta. Los cambios se aplican al guardar.",
"Deletes the mailbox and everything in it.": "Elimina el buzón y todo su contenido.",
"Delete account…": "Eliminar cuenta…",
"Delete {address}?": "¿Eliminar {address}?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Esto elimina el correo, los calendarios, los contactos y los archivos de esta cuenta. El servidor los borra en segundo plano y no se puede deshacer.",
"Type {address} to confirm": "Escriba {address} para confirmar",
"Delete account": "Eliminar cuenta",
"Deleted {address}": "{address} eliminada",
"The server did not say whether the account was created.": "El servidor no indicó si la cuenta se creó.",
"The mail server refused this. Your role may not allow it.": "El servidor de correo lo ha rechazado. Es posible que su rol no lo permita.",
"That address is already in use on this server, as an account, a list or an alias.": "Esa dirección ya está en uso en este servidor, como cuenta, lista o alias.",
"One of the chosen domain, role or group can't be used for this account.": "El dominio, el rol o el grupo elegido no se puede usar para esta cuenta.",
"Your organisation has reached the number of accounts it is allowed.": "Su organización ha alcanzado el número de cuentas permitido.",
"Something still depends on this, so the server kept it.": "Algo todavía depende de esto, así que el servidor lo ha conservado.",
"This account no longer exists. Someone may have deleted it.": "Esta cuenta ya no existe. Puede que alguien la haya eliminado.",
"The password was not accepted: {reason}": "La contraseña no se ha aceptado: {reason}",
"The password was not accepted.": "La contraseña no se ha aceptado.",
"Go to folder…": "Ir a la carpeta…", "Go to folder…": "Ir a la carpeta…",
"Set for everyone here. You cannot change this.": "Definido para todos aquí. No puedes cambiarlo.", "Set for everyone here. You cannot change this.": "Definido para todos aquí. No puedes cambiarlo.",
"Export iCAL file": "Exportar archivo iCAL", "Export iCAL file": "Exportar archivo iCAL",
@@ -319,7 +459,6 @@ export const catalog: Catalog = {
"Busy": "Ocupado", "Busy": "Ocupado",
"Free/busy": "Disponibilidad", "Free/busy": "Disponibilidad",
"Show as": "Mostrar como", "Show as": "Mostrar como",
"Availability on {date}": "Disponibilidad el {date}",
"Count all events as busy": "Contar todos los eventos como ocupado", "Count all events as busy": "Contar todos los eventos como ocupado",
"Only events I'm attending": "Solo los eventos a los que asisto", "Only events I'm attending": "Solo los eventos a los que asisto",
"Don't include in availability": "No incluir en la disponibilidad", "Don't include in availability": "No incluir en la disponibilidad",
@@ -358,7 +497,6 @@ export const catalog: Catalog = {
"New address book": "Libreta de direcciones nueva", "New address book": "Libreta de direcciones nueva",
"No address books yet.": "Aún no hay libretas de direcciones.", "No address books yet.": "Aún no hay libretas de direcciones.",
"Choose from address books": "Elegir de las libretas de direcciones", "Choose from address books": "Elegir de las libretas de direcciones",
"Import vCard": "Importar una vCard",
"Export all contacts": "Exportar todos los contactos", "Export all contacts": "Exportar todos los contactos",
"Export address book": "Exportar esta libreta de direcciones", "Export address book": "Exportar esta libreta de direcciones",
"Import contacts…": "Importar contactos…", "Import contacts…": "Importar contactos…",
@@ -432,7 +570,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Haga suyo ihasmail.", "Make ihasmail yours.": "Haga suyo ihasmail.",
"Reading": "Lectura", "Reading": "Lectura",
"Reading pane": "Panel de lectura", "Reading pane": "Panel de lectura",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Comportamiento de lectura, envío y lista. La configuración se guarda en este navegador.",
"Right of the list": "A la derecha de la lista", "Right of the list": "A la derecha de la lista",
"Below the list": "Debajo de la lista", "Below the list": "Debajo de la lista",
"Hidden (open full width)": "Oculto (abrir a todo el ancho)", "Hidden (open full width)": "Oculto (abrir a todo el ancho)",
@@ -475,10 +612,6 @@ export const catalog: Catalog = {
"Time zone": "Zona horaria", "Time zone": "Zona horaria",
"Week starts on": "La semana empieza el", "Week starts on": "La semana empieza el",
"Monday": "Lunes", "Monday": "Lunes",
"Tuesday": "Martes",
"Wednesday": "Miércoles",
"Thursday": "Jueves",
"Friday": "Viernes",
"Saturday": "Sábado", "Saturday": "Sábado",
"Sunday": "Domingo", "Sunday": "Domingo",
"12-hour clock (6:23 PM)": "Formato de 12 horas (6:23 PM)", "12-hour clock (6:23 PM)": "Formato de 12 horas (6:23 PM)",
@@ -725,10 +858,8 @@ export const catalog: Catalog = {
"Manage labels": "Gestionar las etiquetas", "Manage labels": "Gestionar las etiquetas",
"Create “{name}”": "Crear «{name}»", "Create “{name}”": "Crear «{name}»",
"Type a name to create your first label.": "Escriba un nombre para crear su primera etiqueta.", "Type a name to create your first label.": "Escriba un nombre para crear su primera etiqueta.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Las etiquetas son palabras clave IMAP guardadas en sus mensajes, así que se sincronizan con otros clientes. Los nombres y colores se guardan en este navegador.",
"New label": "Etiqueta nueva", "New label": "Etiqueta nueva",
"Delete label": "Eliminar la etiqueta", "Delete label": "Eliminar la etiqueta",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Algunos servidores rechazan los adjuntos grandes", "Large attachments may be rejected by some servers": "Algunos servidores rechazan los adjuntos grandes",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Las imágenes se guardan en sus Archivos (carpeta «ihasmail») y se incrustan al enviar.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Las imágenes se guardan en sus Archivos (carpeta «ihasmail») y se incrustan al enviar.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Gracias por su mensaje. Estaré ausente hasta el … y le responderé a mi regreso.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Gracias por su mensaje. Estaré ausente hasta el … y le responderé a mi regreso.",
@@ -801,6 +932,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Spam", "folder\u0004Junk Mail": "Spam",
"folder\u0004Important": "Importante", "folder\u0004Important": "Importante",
"folder\u0004All mail": "Todos los mensajes", "folder\u0004All mail": "Todos los mensajes",
"share sheet\u0004Share": "Compartir",
"share sheet\u0004Share…": "Compartir…",
"folder": "carpeta", "folder": "carpeta",
"“{name}” moved into “{parent}”": "«{name}» se ha movido a «{parent}»", "“{name}” moved into “{parent}”": "«{name}» se ha movido a «{parent}»",
"“{name}” moved to the top level": "«{name}» se ha movido al nivel superior", "“{name}” moved to the top level": "«{name}» se ha movido al nivel superior",
@@ -809,6 +942,7 @@ export const catalog: Catalog = {
"Rename folder": "Cambiar el nombre de la carpeta", "Rename folder": "Cambiar el nombre de la carpeta",
"Search: {query}": "Búsqueda: {query}", "Search: {query}": "Búsqueda: {query}",
"No conversation selected": "Ninguna conversación seleccionada", "No conversation selected": "Ninguna conversación seleccionada",
"No message selected": "Ningún mensaje seleccionado",
"Drop here for the top level": "Suelte aquí para el nivel superior", "Drop here for the top level": "Suelte aquí para el nivel superior",
// ── Longer prose ─────────────────────────────────────────────────── // ── Longer prose ───────────────────────────────────────────────────
@@ -817,6 +951,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Abra la vista de Correo para ver todos los atajos.", "Open the Mail view to see all shortcuts.": "Abra la vista de Correo para ver todos los atajos.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Los atajos al estilo de Gmail están siempre activos. Pulse {key} en cualquier momento para ver esta lista.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Los atajos al estilo de Gmail están siempre activos. Pulse {key} en cualquier momento para ver esta lista.",
"Select a conversation to read it here · Press {key} for shortcuts": "Seleccione una conversación para leerla aquí · {key} para los atajos", "Select a conversation to read it here · Press {key} for shortcuts": "Seleccione una conversación para leerla aquí · {key} para los atajos",
"Select a message to read it here · Press {key} for shortcuts": "Seleccione un mensaje para leerlo aquí · {key} para los atajos",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Consejo: pulse {key} sobre una conversación para aplicar etiquetas. Busque con {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Consejo: pulse {key} sobre una conversación para aplicar etiquetas. Busque con {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Un webmail libre, rápido y agradable para {server}, construido sobre JMAP.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Un webmail libre, rápido y agradable para {server}, construido sobre JMAP.",
"Defaults for the calendar views and new events.": "Valores predeterminados de las vistas del calendario y de los eventos nuevos.", "Defaults for the calendar views and new events.": "Valores predeterminados de las vistas del calendario y de los eventos nuevos.",
@@ -858,11 +993,12 @@ export const catalog: Catalog = {
"Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Aquí solo aparecen los idiomas a los que se ha traducido ihasmail, así que la lista crece a medida que llegan las traducciones y no antes: un idioma ofrecido sin textos detrás haría que la página afirmara estar en un idioma que no es el suyo.", "Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Aquí solo aparecen los idiomas a los que se ha traducido ihasmail, así que la lista crece a medida que llegan las traducciones y no antes: un idioma ofrecido sin textos detrás haría que la página afirmara estar en un idioma que no es el suyo.",
"tell us about it": "cuéntenoslo", "tell us about it": "cuéntenoslo",
"This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Esta traducción la ha generado una IA y no la ha revisado ninguna persona de habla nativa, así que está marcada como Beta hasta que alguien la dé por buena. Todo lo que suene mal merece un aviso: {report}.", "This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Esta traducción la ha generado una IA y no la ha revisado ninguna persona de habla nativa, así que está marcada como Beta hasta que alguien la dé por buena. Todo lo que suene mal merece un aviso: {report}.",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} es la paleta de {site}, y con la que empieza una cuenta nueva. Es un tema oscuro, así que cuenta como oscuro allí donde importa, y el color de acento de abajo se sigue aplicando encima.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "La versión de ihasmail es la fecha del commit a partir del cual se compiló, seguida de su procedencia: {example} se compiló a partir de un commit del 30 de agosto de 2026 que llegó mediante la pull request 129. Un commit que no llegó por esa vía lleva en su lugar su SHA corto: {sha}. La versión no dice nada sobre Stalwart a propósito; lo que esta compilación necesita del servidor está en la línea de arriba.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "La versión de ihasmail es la fecha del commit a partir del cual se compiló, seguida de su procedencia: {example} se compiló a partir de un commit del 30 de agosto de 2026 que llegó mediante la pull request 129. Un commit que no llegó por esa vía lleva en su lugar su SHA corto: {sha}. La versión no dice nada sobre Stalwart a propósito; lo que esta compilación necesita del servidor está en la línea de arriba.",
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Mensaje nuevo", "New message": "Mensaje nuevo",
"New mail": "Correo nuevo",
"Could not do that — open ihasmail and try again": "No se pudo hacer eso: abra ihasmail e inténtelo de nuevo",
"Sending…": "Enviando…", "Sending…": "Enviando…",
"Saving…": "Guardando…", "Saving…": "Guardando…",
"Error": "Error", "Error": "Error",
@@ -903,6 +1039,7 @@ export const catalog: Catalog = {
"Could not copy the address": "No se pudo copiar la dirección", "Could not copy the address": "No se pudo copiar la dirección",
"Could not empty folder: {error}": "No se pudo vaciar la carpeta: {error}", "Could not empty folder: {error}": "No se pudo vaciar la carpeta: {error}",
"Could not load source: {error}": "No se pudo cargar el código fuente: {error}", "Could not load source: {error}": "No se pudo cargar el código fuente: {error}",
"Could not share: {error}": "No se pudo compartir: {error}",
"Could not mark as read: {error}": "No se pudo marcar como leído: {error}", "Could not mark as read: {error}": "No se pudo marcar como leído: {error}",
"Could not save draft: {error}": "No se pudo guardar el borrador: {error}", "Could not save draft: {error}": "No se pudo guardar el borrador: {error}",
"Could not save filter: {error}": "No se pudo guardar el filtro: {error}", "Could not save filter: {error}": "No se pudo guardar el filtro: {error}",
@@ -1351,6 +1488,15 @@ export const catalog: Catalog = {
"no address": "ninguna dirección", "no address": "ninguna dirección",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "{n} cuenta usa este dominio. Muévala o elimínela primero.", other: "{n} cuentas usan este dominio. Muévalas o elimínelas primero." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "El servidor deja de aceptar correo para este dominio y se elimina su {n} clave DKIM. No se puede deshacer.", other: "El servidor deja de aceptar correo para este dominio y se eliminan sus {n} claves DKIM. No se puede deshacer." },
"{n} domains": { one: "{n} dominio", other: "{n} dominios" },
"{n} mailing lists": { one: "{n} lista de correo", other: "{n} listas de correo" },
"{n} DKIM keys": { one: "{n} clave DKIM", other: "{n} claves DKIM" },
"{n} other items": { one: "{n} elemento más", other: "{n} elementos más" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} cuenta", other: "{n} cuentas" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "Eliminar {n} elemento", other: "Eliminar {n} elementos" }, "Delete {n} items": { one: "Eliminar {n} elemento", other: "Eliminar {n} elementos" },
"Delete {n} items?": { one: "¿Eliminar {n} elemento?", other: "¿Eliminar {n} elementos?" }, "Delete {n} items?": { one: "¿Eliminar {n} elemento?", other: "¿Eliminar {n} elementos?" },
@@ -1380,8 +1526,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Tu administración cambió {n} ajuste", other: "Tu administración cambió {n} ajustes" }, "Your administrator changed {n} settings": { one: "Tu administración cambió {n} ajuste", other: "Tu administración cambió {n} ajustes" },
"Exported {n} events": { one: "{n} evento exportado", other: "{n} eventos exportados" }, "Exported {n} events": { one: "{n} evento exportado", other: "{n} eventos exportados" },
"Imported {n} events": { one: "{n} evento importado", other: "{n} eventos importados" }, "Imported {n} events": { one: "{n} evento importado", other: "{n} eventos importados" },
"Already here: {n} events, nothing imported": { one: "Ya estaba aquí: {n} evento, no se importó nada", other: "Ya estaban aquí: {n} eventos, no se importó nada" }, "Updated {n} events, nothing new": { one: "{n} evento actualizado, nada nuevo", other: "{n} eventos actualizados, nada nuevo" },
"{n} were already here": { one: "{n} ya estaba aquí", other: "{n} ya estaban aquí" },
"{n} messages": { one: "{n} mensaje", other: "{n} mensajes" }, "{n} messages": { one: "{n} mensaje", other: "{n} mensajes" },
"{n} selected": { one: "{n} seleccionado", other: "{n} seleccionados" }, "{n} selected": { one: "{n} seleccionado", other: "{n} seleccionados" },
"{n} conversations": { one: "{n} conversación", other: "{n} conversaciones" }, "{n} conversations": { one: "{n} conversación", other: "{n} conversaciones" },
+157 -12
View File
@@ -52,6 +52,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Domaines",
"By hand": "Manuel",
"Signing": "Signe",
"Published, not signing yet": "Publiée, ne signe pas encore",
"Retiring": "En retrait",
"Retired": "Retirée",
"This domain no longer exists. Someone may have removed it.": "Ce domaine nexiste plus. Quelquun la peut-être retiré.",
"That doesn't look like a domain name, such as example.com.": "Cela ne ressemble pas à un nom de domaine, comme example.com.",
"Added {name}. Its DNS records are ready to copy.": "{name} ajouté. Ses enregistrements DNS sont prêts à être copiés.",
"Saved {name}": "{name} enregistré",
"Add domain": "Ajouter un domaine",
"Added {date}": "Ajouté le {date}",
"This domain is disabled on the server.": "Ce domaine est désactivé sur le serveur.",
"Your role lets you view domains but not change them.": "Votre rôle vous permet de consulter les domaines, mais pas de les modifier.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Les nouveaux domaines signent leurs messages avec des clés DKIM que le serveur crée et renouvelle. Leurs enregistrements DNS apparaissent ici une fois le domaine ajouté.",
"Other names": "Autres noms",
"Delivery": "Distribution",
"Catch-all address": "Adresse fourre-tout",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "Les messages envoyés à une adresse que personne na sur ce domaine sont remis ici. Laissez vide pour les refuser.",
"Plus addressing": "Adresses avec +",
"Set by a custom rule on the server.": "Défini par une règle personnalisée sur le serveur.",
"Mail to name+anything@ is delivered to name@.": "Les messages à nom+nimportequoi@ sont remis à nom@.",
"DNS records": "Enregistrements DNS",
"Published automatically through {provider}.": "Publiés automatiquement via {provider}.",
"Published automatically by the server.": "Publiés automatiquement par le serveur.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Ajoutez-les là où le DNS de ce domaine est hébergé. Les messages ne sont ni distribués ni jugés fiables tant quils ne sont pas en place.",
"Copy {type} record for {name}": "Copier lenregistrement {type} pour {name}",
"Copy value": "Copier la valeur",
"Copied the zone file": "Fichier de zone copié",
"Copy all as a zone file": "Tout copier en fichier de zone",
"The server returned no records for this domain.": "Le serveur na renvoyé aucun enregistrement pour ce domaine.",
"DKIM keys": "Clés DKIM",
"The server creates and rotates these keys itself.": "Le serveur crée et renouvelle ces clés lui-même.",
"These keys are managed by hand on the server.": "Ces clés sont gérées manuellement sur le serveur.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "Aucune clé DKIM : les messages de ce domaine ne sont pas signés et risquent davantage d’être classés comme spam.",
"Managed by the server": "Géré par le serveur",
"Certificate": "Certificat",
"Another name for this domain": "Autre nom pour ce domaine",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "Les messages envoyés à la même adresse sous lun de ces noms arrivent dans le même compte. Les modifications sappliquent à lenregistrement.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "Ses clés DKIM doivent dabord être supprimées, et votre rôle ne le permet pas.",
"The server stops accepting mail for this domain.": "Le serveur naccepte plus de messages pour ce domaine.",
"Remove domain…": "Retirer le domaine…",
"Remove {name}?": "Retirer {name} ?",
"Removed {name}": "{name} retiré",
"The server kept the domain: it is still used by {things}.": "Le serveur a conservé le domaine : il est encore utilisé par {things}.",
"Remove domain": "Retirer le domaine",
"The server stops accepting mail for this domain. This can't be undone.": "Le serveur naccepte plus de messages pour ce domaine. Cest irréversible.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Là où vivent vos adresses, et les enregistrements DNS qui permettent aux messages darriver et d’être fiables.",
"Search domains": "Rechercher des domaines",
"No domains match": "Aucun domaine correspondant",
"No domains yet": "Aucun domaine pour linstant",
"DKIM": "DKIM",
"Tenant": "Locataire",
"Disabled": "Désactivé",
"also {names}": "aussi {names}",
"The server did not say whether the domain was created.": "Le serveur na pas indiqué si le domaine a été créé.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Ce nest pas un nom de domaine valide. Utilisez un nom comme example.com, avec un vrai domaine de premier niveau.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Ce nest pas une adresse e-mail valide. Utilisez une adresse complète, comme [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Ce nest pas une adresse valide. Utilisez des lettres, des chiffres, des points, des tirets ou des traits de soulignement avant le @.",
"That isn't a valid host name or IP address.": "Ce nest ni un nom dhôte ni une adresse IP valide.",
"A required value was left empty.": "Une valeur obligatoire a été laissée vide.",
"Administration is turned off on this installation.": "Ladministration est désactivée sur cette installation.",
"The mail server could not carry out the request ({code}).": "Le serveur de messagerie na pas pu traiter la demande ({code}).",
"You can't give an account permissions your own role doesn't have.": "Vous ne pouvez pas donner à un compte des autorisations que votre propre rôle na pas.",
"This account signs in through an external directory, so its password can't be set here.": "Ce compte se connecte via un annuaire externe, son mot de passe ne peut donc pas être défini ici.",
"The server's licence allows no more accounts.": "La licence du serveur ne permet pas de comptes supplémentaires.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Ce nom de domaine est déjà utilisé sur ce serveur, comme domaine ou comme autre nom dun autre domaine.",
"Your organisation has reached the number of domains it is allowed.": "Votre organisation a atteint le nombre de domaines autorisé.",
"That is more than the mail server accepts in one change.": "Cest plus que ce que le serveur de messagerie accepte en une seule modification.",
"The mail server rejected one of the values. Check what you entered and try again.": "Le serveur de messagerie a refusé lune des valeurs. Vérifiez votre saisie et réessayez.",
"The mail server refused the change ({code}).": "Le serveur de messagerie a refusé la modification ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Uniquement sur un appareil que vous avez indiqué comme le vôtre. Reconnectez-vous en cochant « Cet appareil est le mien ».",
"Change your own password in {settings}.": "Modifiez votre propre mot de passe dans {settings}.",
"Administration": "Administration",
"Directory": "Annuaire",
"User": "Utilisateur",
"Administrator": "Administrateur",
"Custom role": "Rôle personnalisé",
"New account": "Nouveau compte",
"The people who sign in to mail on the domains you manage.": "Les personnes qui se connectent à leur messagerie sur les domaines que vous gérez.",
"Search by name or address": "Rechercher par nom ou adresse",
"Search accounts": "Rechercher des comptes",
"No accounts match": "Aucun compte correspondant",
"No accounts yet": "Aucun compte pour linstant",
"Nothing on your domains matches “{query}”.": "Rien ne correspond à « {query} » sur vos domaines.",
"Open {address}": "Ouvrir {address}",
"{from}{to} of {total}": "{from}{to} sur {total}",
"Previous page": "Page précédente",
"Next page": "Page suivante",
"Storage": "Stockage",
"Groups": "Groupes",
"{used} · no limit": "{used} · sans limite",
"Profile": "Profil",
"Domain": "Domaine",
"No domains are available to create an account on.": "Aucun domaine nest disponible pour créer un compte.",
"Sign-in": "Connexion",
"Other addresses": "Autres adresses",
"Not in any group": "Membre daucun groupe",
"You can't change your own role.": "Vous ne pouvez pas modifier votre propre rôle.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Seuls les rôles dont vous détenez vous-même les autorisations sont proposés. Pour un compte au sein dun locataire, Administrateur signifie administrateur de ce locataire.",
"Limit in GB": "Limite en Go",
"No limit": "Sans limite",
"This account has permissions yours doesn't, so you can view it but not change it.": "Ce compte a des autorisations que le vôtre na pas : vous pouvez le consulter, mais pas le modifier.",
"Your role lets you view accounts but not change them.": "Votre rôle vous permet de consulter les comptes, mais pas de les modifier.",
"This account has permissions yours doesn't.": "Ce compte a des autorisations que le vôtre na pas.",
"You can't delete the account you're signed in with.": "Vous ne pouvez pas supprimer le compte avec lequel vous êtes connecté.",
"Create account": "Créer le compte",
"An account needs an address.": "Un compte doit avoir une adresse.",
"Created {address}": "{address} créé",
"Saved {address}": "{address} enregistré",
"Generate a password": "Générer un mot de passe",
"Pass it on some way other than email to this address.": "Transmettez-le autrement que par e-mail à cette adresse.",
"This account has no password. It may sign in through a directory or single sign-on.": "Ce compte na pas de mot de passe. Il se connecte peut-être via un annuaire ou une authentification unique.",
"Set a new password…": "Définir un nouveau mot de passe…",
"{name} will be signed out of every app and device using the old password.": "{name} sera déconnecté de toutes les applications et de tous les appareils qui utilisent lancien mot de passe.",
"New password set for {address}": "Nouveau mot de passe défini pour {address}",
"Set password": "Définir le mot de passe",
"Remove {address}": "Retirer {address}",
"New address": "Nouvelle adresse",
"another name": "autre nom",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "Les messages envoyés à ces adresses sont remis à ce compte. Les modifications sappliquent à lenregistrement.",
"Deletes the mailbox and everything in it.": "Supprime la boîte aux lettres et tout son contenu.",
"Delete account…": "Supprimer le compte…",
"Delete {address}?": "Supprimer {address} ?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Cette action supprime les messages, agendas, contacts et fichiers de ce compte. Le serveur les efface en arrière-plan, et cest irréversible.",
"Type {address} to confirm": "Saisissez {address} pour confirmer",
"Delete account": "Supprimer le compte",
"Deleted {address}": "{address} supprimé",
"The server did not say whether the account was created.": "Le serveur na pas indiqué si le compte a été créé.",
"The mail server refused this. Your role may not allow it.": "Le serveur de messagerie a refusé. Votre rôle ne le permet peut-être pas.",
"That address is already in use on this server, as an account, a list or an alias.": "Cette adresse est déjà utilisée sur ce serveur, par un compte, une liste ou un alias.",
"One of the chosen domain, role or group can't be used for this account.": "Le domaine, le rôle ou le groupe choisi ne peut pas être utilisé pour ce compte.",
"Your organisation has reached the number of accounts it is allowed.": "Votre organisation a atteint le nombre de comptes autorisé.",
"Something still depends on this, so the server kept it.": "Un autre élément en dépend encore, le serveur la donc conservé.",
"This account no longer exists. Someone may have deleted it.": "Ce compte nexiste plus. Quelquun la peut-être supprimé.",
"The password was not accepted: {reason}": "Le mot de passe a été refusé : {reason}",
"The password was not accepted.": "Le mot de passe a été refusé.",
"Go to folder…": "Aller au dossier…", "Go to folder…": "Aller au dossier…",
"Set for everyone here. You cannot change this.": "Défini pour tout le monde ici. Vous ne pouvez pas le modifier.", "Set for everyone here. You cannot change this.": "Défini pour tout le monde ici. Vous ne pouvez pas le modifier.",
"Export iCAL file": "Exporter un fichier iCAL", "Export iCAL file": "Exporter un fichier iCAL",
@@ -324,7 +464,6 @@ export const catalog: Catalog = {
"Busy": "Occupé", "Busy": "Occupé",
"Free/busy": "Disponibilité", "Free/busy": "Disponibilité",
"Show as": "Afficher comme", "Show as": "Afficher comme",
"Availability on {date}": "Disponibilité le {date}",
"Count all events as busy": "Compter tous les événements comme occupé", "Count all events as busy": "Compter tous les événements comme occupé",
"Only events I'm attending": "Uniquement les événements auxquels je participe", "Only events I'm attending": "Uniquement les événements auxquels je participe",
"Don't include in availability": "Ne pas inclure dans la disponibilité", "Don't include in availability": "Ne pas inclure dans la disponibilité",
@@ -363,7 +502,6 @@ export const catalog: Catalog = {
"New address book": "Nouveau carnet d'adresses", "New address book": "Nouveau carnet d'adresses",
"No address books yet.": "Aucun carnet d'adresses pour le moment.", "No address books yet.": "Aucun carnet d'adresses pour le moment.",
"Choose from address books": "Choisir dans les carnets d'adresses", "Choose from address books": "Choisir dans les carnets d'adresses",
"Import vCard": "Importer une vCard",
"Export all contacts": "Exporter tous les contacts", "Export all contacts": "Exporter tous les contacts",
"Export address book": "Exporter ce carnet dadresses", "Export address book": "Exporter ce carnet dadresses",
"Import contacts…": "Importer des contacts…", "Import contacts…": "Importer des contacts…",
@@ -438,7 +576,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Faites de ihasmail le vôtre.", "Make ihasmail yours.": "Faites de ihasmail le vôtre.",
"Reading": "Lecture", "Reading": "Lecture",
"Reading pane": "Volet de lecture", "Reading pane": "Volet de lecture",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Comportement de lecture, d'envoi et de liste. Les paramètres sont enregistrés dans ce navigateur.",
"Right of the list": "À droite de la liste", "Right of the list": "À droite de la liste",
"Below the list": "Sous la liste", "Below the list": "Sous la liste",
"Hidden (open full width)": "Masqué (ouvrir en pleine largeur)", "Hidden (open full width)": "Masqué (ouvrir en pleine largeur)",
@@ -481,10 +618,6 @@ export const catalog: Catalog = {
"Time zone": "Fuseau horaire", "Time zone": "Fuseau horaire",
"Week starts on": "La semaine commence le", "Week starts on": "La semaine commence le",
"Monday": "Lundi", "Monday": "Lundi",
"Tuesday": "Mardi",
"Wednesday": "Mercredi",
"Thursday": "Jeudi",
"Friday": "Vendredi",
"Saturday": "Samedi", "Saturday": "Samedi",
"Sunday": "Dimanche", "Sunday": "Dimanche",
"12-hour clock (6:23 PM)": "Format 12 heures (6:23 PM)", "12-hour clock (6:23 PM)": "Format 12 heures (6:23 PM)",
@@ -730,10 +863,8 @@ export const catalog: Catalog = {
"Manage labels": "Gérer les libellés", "Manage labels": "Gérer les libellés",
"Create “{name}”": "Créer « {name} »", "Create “{name}”": "Créer « {name} »",
"Type a name to create your first label.": "Saisissez un nom pour créer votre premier libellé.", "Type a name to create your first label.": "Saisissez un nom pour créer votre premier libellé.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Les libellés sont des mots-clés IMAP enregistrés dans vos messages : ils se synchronisent donc avec les autres clients. Les noms et couleurs restent dans ce navigateur.",
"New label": "Nouveau libellé", "New label": "Nouveau libellé",
"Delete label": "Supprimer le libellé", "Delete label": "Supprimer le libellé",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Les pièces jointes volumineuses peuvent être refusées par certains serveurs", "Large attachments may be rejected by some servers": "Les pièces jointes volumineuses peuvent être refusées par certains serveurs",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Les images sont enregistrées dans vos Fichiers (dossier « ihasmail ») et intégrées à l'envoi.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Les images sont enregistrées dans vos Fichiers (dossier « ihasmail ») et intégrées à l'envoi.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Merci pour votre message. Je suis absent jusqu'au … et vous répondrai à mon retour.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Merci pour votre message. Je suis absent jusqu'au … et vous répondrai à mon retour.",
@@ -806,6 +937,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Spam", "folder\u0004Junk Mail": "Spam",
"folder\u0004Important": "Important", "folder\u0004Important": "Important",
"folder\u0004All mail": "Tous les messages", "folder\u0004All mail": "Tous les messages",
"share sheet\u0004Share": "Partager",
"share sheet\u0004Share…": "Partager…",
"folder": "dossier", "folder": "dossier",
"“{name}” moved into “{parent}”": "« {name} » a été déplacé dans « {parent} »", "“{name}” moved into “{parent}”": "« {name} » a été déplacé dans « {parent} »",
"“{name}” moved to the top level": "« {name} » a été déplacé au niveau supérieur", "“{name}” moved to the top level": "« {name} » a été déplacé au niveau supérieur",
@@ -814,6 +947,7 @@ export const catalog: Catalog = {
"Rename folder": "Renommer le dossier", "Rename folder": "Renommer le dossier",
"Search: {query}": "Recherche : {query}", "Search: {query}": "Recherche : {query}",
"No conversation selected": "Aucune conversation sélectionnée", "No conversation selected": "Aucune conversation sélectionnée",
"No message selected": "Aucun message sélectionné",
"Drop here for the top level": "Déposer ici pour le niveau supérieur", "Drop here for the top level": "Déposer ici pour le niveau supérieur",
// ── Longer prose ─────────────────────────────────────────────────── // ── Longer prose ───────────────────────────────────────────────────
@@ -822,6 +956,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Ouvrez la vue E-mail pour voir tous les raccourcis.", "Open the Mail view to see all shortcuts.": "Ouvrez la vue E-mail pour voir tous les raccourcis.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Les raccourcis façon Gmail sont toujours actifs. Appuyez sur {key} n'importe où pour afficher cette liste.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Les raccourcis façon Gmail sont toujours actifs. Appuyez sur {key} n'importe où pour afficher cette liste.",
"Select a conversation to read it here · Press {key} for shortcuts": "Sélectionnez une conversation pour la lire ici · {key} pour les raccourcis", "Select a conversation to read it here · Press {key} for shortcuts": "Sélectionnez une conversation pour la lire ici · {key} pour les raccourcis",
"Select a message to read it here · Press {key} for shortcuts": "Sélectionnez un message pour le lire ici · {key} pour les raccourcis",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Astuce : appuyez sur {key} sur une conversation pour appliquer des libellés. Recherchez avec {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Astuce : appuyez sur {key} sur une conversation pour appliquer des libellés. Recherchez avec {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Un webmail libre, rapide et agréable pour {server}, bâti sur JMAP.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Un webmail libre, rapide et agréable pour {server}, bâti sur JMAP.",
"Defaults for the calendar views and new events.": "Valeurs par défaut des vues d'agenda et des nouveaux événements.", "Defaults for the calendar views and new events.": "Valeurs par défaut des vues d'agenda et des nouveaux événements.",
@@ -863,11 +998,12 @@ export const catalog: Catalog = {
"Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Seules les langues dans lesquelles ihasmail a été traduit apparaissent ici : la liste s'allonge donc à mesure que les traductions arrivent, et non avant — une langue proposée sans textes derrière elle ferait prétendre à la page qu'elle est dans une langue qui n'est pas la sienne.", "Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Seules les langues dans lesquelles ihasmail a été traduit apparaissent ici : la liste s'allonge donc à mesure que les traductions arrivent, et non avant — une langue proposée sans textes derrière elle ferait prétendre à la page qu'elle est dans une langue qui n'est pas la sienne.",
"tell us about it": "signalez-le-nous", "tell us about it": "signalez-le-nous",
"This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Cette traduction a été générée par une IA et n'a pas été relue par une personne de langue maternelle française ; elle est donc marquée Beta jusqu'à validation. Tout ce qui sonne faux mérite d'être signalé — {report}.", "This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Cette traduction a été générée par une IA et n'a pas été relue par une personne de langue maternelle française ; elle est donc marquée Beta jusqu'à validation. Tout ce qui sonne faux mérite d'être signalé — {report}.",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} est la palette de {site}, et celle d'un nouveau compte. C'est un thème sombre : il compte donc comme sombre partout où cela importe, et la couleur d'accentuation ci-dessous s'y applique toujours.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "La version de ihasmail est la date du commit à partir duquel elle a été construite, suivie de l'origine de ce commit : {example} provient d'un commit daté du 30 août 2026 arrivé via la pull request 129. Un commit qui n'est pas passé par là porte à la place son SHA court — {sha}. La version ne dit délibérément rien de Stalwart ; ce dont cette build a besoin du serveur figure à la ligne ci-dessus.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "La version de ihasmail est la date du commit à partir duquel elle a été construite, suivie de l'origine de ce commit : {example} provient d'un commit daté du 30 août 2026 arrivé via la pull request 129. Un commit qui n'est pas passé par là porte à la place son SHA court — {sha}. La version ne dit délibérément rien de Stalwart ; ce dont cette build a besoin du serveur figure à la ligne ci-dessus.",
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Nouveau message", "New message": "Nouveau message",
"New mail": "Nouveau courrier",
"Could not do that — open ihasmail and try again": "Impossible : ouvrez ihasmail et réessayez",
"Sending…": "Envoi…", "Sending…": "Envoi…",
"Saving…": "Enregistrement…", "Saving…": "Enregistrement…",
"Error": "Erreur", "Error": "Erreur",
@@ -908,6 +1044,7 @@ export const catalog: Catalog = {
"Could not copy the address": "Impossible de copier ladresse", "Could not copy the address": "Impossible de copier ladresse",
"Could not empty folder: {error}": "Impossible de vider le dossier : {error}", "Could not empty folder: {error}": "Impossible de vider le dossier : {error}",
"Could not load source: {error}": "Impossible de charger la source : {error}", "Could not load source: {error}": "Impossible de charger la source : {error}",
"Could not share: {error}": "Impossible de partager : {error}",
"Could not mark as read: {error}": "Impossible de marquer comme lu : {error}", "Could not mark as read: {error}": "Impossible de marquer comme lu : {error}",
"Could not save draft: {error}": "Impossible denregistrer le brouillon : {error}", "Could not save draft: {error}": "Impossible denregistrer le brouillon : {error}",
"Could not save filter: {error}": "Impossible denregistrer le filtre : {error}", "Could not save filter: {error}": "Impossible denregistrer le filtre : {error}",
@@ -1356,6 +1493,15 @@ export const catalog: Catalog = {
"no address": "aucune adresse", "no address": "aucune adresse",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "{n} compte utilise ce domaine. Déplacez-le ou supprimez-le dabord.", other: "{n} comptes utilisent ce domaine. Déplacez-les ou supprimez-les dabord." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "Le serveur naccepte plus de messages pour ce domaine, et sa {n} clé DKIM est supprimée. Cest irréversible.", other: "Le serveur naccepte plus de messages pour ce domaine, et ses {n} clés DKIM sont supprimées. Cest irréversible." },
"{n} domains": { one: "{n} domaine", other: "{n} domaines" },
"{n} mailing lists": { one: "{n} liste de diffusion", other: "{n} listes de diffusion" },
"{n} DKIM keys": { one: "{n} clé DKIM", other: "{n} clés DKIM" },
"{n} other items": { one: "{n} autre élément", other: "{n} autres éléments" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} compte", other: "{n} comptes" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "Supprimer {n} élément", other: "Supprimer {n} éléments" }, "Delete {n} items": { one: "Supprimer {n} élément", other: "Supprimer {n} éléments" },
"Delete {n} items?": { one: "Supprimer {n} élément ?", other: "Supprimer {n} éléments ?" }, "Delete {n} items?": { one: "Supprimer {n} élément ?", other: "Supprimer {n} éléments ?" },
@@ -1385,8 +1531,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Votre administration a modifié {n} paramètre", other: "Votre administration a modifié {n} paramètres" }, "Your administrator changed {n} settings": { one: "Votre administration a modifié {n} paramètre", other: "Votre administration a modifié {n} paramètres" },
"Exported {n} events": { one: "{n} événement exporté", other: "{n} événements exportés" }, "Exported {n} events": { one: "{n} événement exporté", other: "{n} événements exportés" },
"Imported {n} events": { one: "{n} événement importé", other: "{n} événements importés" }, "Imported {n} events": { one: "{n} événement importé", other: "{n} événements importés" },
"Already here: {n} events, nothing imported": { one: "Déjà présent : {n} événement, rien dimporté", other: "Déjà présents : {n} événements, rien dimporté" }, "Updated {n} events, nothing new": { one: "{n} événement mis à jour, rien de nouveau", other: "{n} événements mis à jour, rien de nouveau" },
"{n} were already here": { one: "{n} était déjà présent", other: "{n} étaient déjà présents" },
"{n} messages": { one: "{n} message", other: "{n} messages" }, "{n} messages": { one: "{n} message", other: "{n} messages" },
"{n} selected": { one: "{n} sélectionné", other: "{n} sélectionnés" }, "{n} selected": { one: "{n} sélectionné", other: "{n} sélectionnés" },
"{n} conversations": { one: "{n} conversation", other: "{n} conversations" }, "{n} conversations": { one: "{n} conversation", other: "{n} conversations" },
+157 -12
View File
@@ -46,6 +46,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "ドメイン",
"By hand": "手動",
"Signing": "署名中",
"Published, not signing yet": "公開済み(まだ署名なし)",
"Retiring": "廃止中",
"Retired": "廃止済み",
"This domain no longer exists. Someone may have removed it.": "このドメインはもう存在しません。誰かが削除した可能性があります。",
"That doesn't look like a domain name, such as example.com.": "example.com のようなドメイン名ではないようです。",
"Added {name}. Its DNS records are ready to copy.": "{name} を追加しました。DNS レコードをコピーできます。",
"Saved {name}": "{name} を保存しました",
"Add domain": "ドメインを追加",
"Added {date}": "{date} に追加",
"This domain is disabled on the server.": "このドメインはサーバーで無効になっています。",
"Your role lets you view domains but not change them.": "あなたのロールでは、ドメインの閲覧はできますが変更はできません。",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "新しいドメインは、サーバーが作成・更新する DKIM 鍵でメールに署名します。DNS レコードはドメインを追加するとここに表示されます。",
"Other names": "別名",
"Delivery": "配信",
"Catch-all address": "キャッチオールアドレス",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "このドメインで誰も持っていないアドレス宛てのメールをここに配信します。空欄にすると、そのメールは拒否されます。",
"Plus addressing": "プラスアドレス",
"Set by a custom rule on the server.": "サーバーのカスタムルールで設定されています。",
"Mail to name+anything@ is delivered to name@.": "名前+任意@ 宛てのメールは 名前@ に配信されます。",
"DNS records": "DNS レコード",
"Published automatically through {provider}.": "{provider} を通じて自動で公開されます。",
"Published automatically by the server.": "サーバーが自動で公開します。",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "このドメインの DNS を管理している場所に追加してください。追加されるまで、メールは配信されず信頼もされません。",
"Copy {type} record for {name}": "{name} の {type} レコードをコピー",
"Copy value": "値をコピー",
"Copied the zone file": "ゾーンファイルをコピーしました",
"Copy all as a zone file": "すべてゾーンファイルとしてコピー",
"The server returned no records for this domain.": "サーバーはこのドメインのレコードを返しませんでした。",
"DKIM keys": "DKIM 鍵",
"The server creates and rotates these keys itself.": "サーバーがこれらの鍵を自動で作成・更新します。",
"These keys are managed by hand on the server.": "これらの鍵はサーバーで手動管理されています。",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "DKIM 鍵がないため、このドメインのメールは署名されず、迷惑メールと判定されやすくなります。",
"Managed by the server": "サーバーによる管理",
"Certificate": "証明書",
"Another name for this domain": "このドメインの別名",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "これらのいずれの名前でも、同じアドレス宛てのメールは同じアカウントに届きます。変更は保存時に反映されます。",
"Its DKIM keys have to be removed first, and your role can't remove them.": "先に DKIM 鍵を削除する必要がありますが、あなたのロールでは削除できません。",
"The server stops accepting mail for this domain.": "サーバーはこのドメイン宛てのメールを受け付けなくなります。",
"Remove domain…": "ドメインを削除…",
"Remove {name}?": "{name} を削除しますか?",
"Removed {name}": "{name} を削除しました",
"The server kept the domain: it is still used by {things}.": "サーバーはドメインを削除しませんでした。まだ {things} が使用しています。",
"Remove domain": "ドメインを削除",
"The server stops accepting mail for this domain. This can't be undone.": "サーバーはこのドメイン宛てのメールを受け付けなくなります。元に戻すことはできません。",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "アドレスの置き場所と、メールが届き信頼されるための DNS レコードです。",
"Search domains": "ドメインを検索",
"No domains match": "一致するドメインはありません",
"No domains yet": "ドメインはまだありません",
"DKIM": "DKIM",
"Tenant": "テナント",
"Disabled": "無効",
"also {names}": "別名: {names}",
"The server did not say whether the domain was created.": "ドメインが作成されたかどうか、サーバーから応答がありませんでした。",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "有効なドメイン名ではありません。example.com のように、実在するトップレベルドメインの名前を使ってください。",
"That isn't a valid email address. Use a full address, such as [email protected].": "有効なメールアドレスではありません。[email protected] のような完全なアドレスを使ってください。",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "有効なアドレスではありません。@ の前には英数字、ドット、ハイフン、アンダースコアを使ってください。",
"That isn't a valid host name or IP address.": "有効なホスト名または IP アドレスではありません。",
"A required value was left empty.": "必須の値が空欄です。",
"Administration is turned off on this installation.": "このインストールでは管理機能が無効になっています。",
"The mail server could not carry out the request ({code}).": "メールサーバーはリクエストを実行できませんでした({code})。",
"You can't give an account permissions your own role doesn't have.": "自分のロールにない権限をアカウントに付与することはできません。",
"This account signs in through an external directory, so its password can't be set here.": "このアカウントは外部ディレクトリでサインインするため、ここではパスワードを設定できません。",
"The server's licence allows no more accounts.": "サーバーのライセンスでは、これ以上アカウントを追加できません。",
"That domain name is already in use on this server, as a domain or another domain's other name.": "このドメイン名は、ドメインまたは別のドメインの別名としてこのサーバーで既に使われています。",
"Your organisation has reached the number of domains it is allowed.": "組織で許可されているドメイン数の上限に達しました。",
"That is more than the mail server accepts in one change.": "メールサーバーが一度の変更で受け付けられる量を超えています。",
"The mail server rejected one of the values. Check what you entered and try again.": "メールサーバーが値のひとつを拒否しました。入力内容を確認して、もう一度お試しください。",
"The mail server refused the change ({code}).": "メールサーバーが変更を拒否しました({code})。",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "自分のデバイスとして指定した端末でのみ使えます。「これは自分のデバイスです」にチェックを入れて、もう一度サインインしてください。",
"Change your own password in {settings}.": "ご自身のパスワードは{settings}で変更してください。",
"Administration": "管理",
"Directory": "ディレクトリ",
"User": "ユーザー",
"Administrator": "管理者",
"Custom role": "カスタムロール",
"New account": "新しいアカウント",
"The people who sign in to mail on the domains you manage.": "管理しているドメインでメールにサインインするユーザーです。",
"Search by name or address": "名前またはアドレスで検索",
"Search accounts": "アカウントを検索",
"No accounts match": "一致するアカウントはありません",
"No accounts yet": "アカウントはまだありません",
"Nothing on your domains matches “{query}”.": "ドメイン内に「{query}」と一致するものはありません。",
"Open {address}": "{address} を開く",
"{from}{to} of {total}": "{from}{to} / {total}",
"Previous page": "前のページ",
"Next page": "次のページ",
"Storage": "ストレージ",
"Groups": "グループ",
"{used} · no limit": "{used} · 上限なし",
"Profile": "プロフィール",
"Domain": "ドメイン",
"No domains are available to create an account on.": "アカウントを作成できるドメインがありません。",
"Sign-in": "サインイン",
"Other addresses": "その他のアドレス",
"Not in any group": "どのグループにも属していません",
"You can't change your own role.": "自分のロールは変更できません。",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "ご自身が持つ権限だけで構成されたロールのみ表示されます。テナント内のアカウントでは、管理者はそのテナントの管理者を意味します。",
"Limit in GB": "上限(GB",
"No limit": "上限なし",
"This account has permissions yours doesn't, so you can view it but not change it.": "このアカウントにはあなたのアカウントにない権限があるため、閲覧はできますが変更はできません。",
"Your role lets you view accounts but not change them.": "あなたのロールでは、アカウントの閲覧はできますが変更はできません。",
"This account has permissions yours doesn't.": "このアカウントにはあなたのアカウントにない権限があります。",
"You can't delete the account you're signed in with.": "サインイン中のアカウントは削除できません。",
"Create account": "アカウントを作成",
"An account needs an address.": "アカウントにはアドレスが必要です。",
"Created {address}": "{address} を作成しました",
"Saved {address}": "{address} を保存しました",
"Generate a password": "パスワードを生成",
"Pass it on some way other than email to this address.": "このアドレス宛てのメール以外の方法で伝えてください。",
"This account has no password. It may sign in through a directory or single sign-on.": "このアカウントにはパスワードがありません。ディレクトリやシングルサインオンでサインインしている可能性があります。",
"Set a new password…": "新しいパスワードを設定…",
"{name} will be signed out of every app and device using the old password.": "{name} は、古いパスワードを使っているすべてのアプリとデバイスからサインアウトされます。",
"New password set for {address}": "{address} の新しいパスワードを設定しました",
"Set password": "パスワードを設定",
"Remove {address}": "{address} を削除",
"New address": "新しいアドレス",
"another name": "別の名前",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "これらのアドレス宛てのメールはこのアカウントに配信されます。変更は保存時に反映されます。",
"Deletes the mailbox and everything in it.": "メールボックスとその中身をすべて削除します。",
"Delete account…": "アカウントを削除…",
"Delete {address}?": "{address} を削除しますか?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "このアカウントのメール、カレンダー、連絡先、ファイルが削除されます。サーバーがバックグラウンドで削除し、元に戻すことはできません。",
"Type {address} to confirm": "確認のため {address} と入力してください",
"Delete account": "アカウントを削除",
"Deleted {address}": "{address} を削除しました",
"The server did not say whether the account was created.": "アカウントが作成されたかどうか、サーバーから応答がありませんでした。",
"The mail server refused this. Your role may not allow it.": "メールサーバーに拒否されました。ロールで許可されていない可能性があります。",
"That address is already in use on this server, as an account, a list or an alias.": "このアドレスは、アカウント、リスト、またはエイリアスとして、このサーバーですでに使われています。",
"One of the chosen domain, role or group can't be used for this account.": "選択したドメイン、ロール、またはグループはこのアカウントには使えません。",
"Your organisation has reached the number of accounts it is allowed.": "組織で許可されているアカウント数の上限に達しました。",
"Something still depends on this, so the server kept it.": "まだこれに依存しているものがあるため、サーバーは削除しませんでした。",
"This account no longer exists. Someone may have deleted it.": "このアカウントはもう存在しません。誰かが削除した可能性があります。",
"The password was not accepted: {reason}": "パスワードは受け付けられませんでした: {reason}",
"The password was not accepted.": "パスワードは受け付けられませんでした。",
"Go to folder…": "フォルダーへ移動…", "Go to folder…": "フォルダーへ移動…",
"Set for everyone here. You cannot change this.": "この環境全体で設定されています。変更できません。", "Set for everyone here. You cannot change this.": "この環境全体で設定されています。変更できません。",
"Export iCAL file": "iCAL ファイルをエクスポート", "Export iCAL file": "iCAL ファイルをエクスポート",
@@ -318,7 +458,6 @@ export const catalog: Catalog = {
"Busy": "予定あり", "Busy": "予定あり",
"Free/busy": "空き時間", "Free/busy": "空き時間",
"Show as": "表示方法", "Show as": "表示方法",
"Availability on {date}": "{date} の空き状況",
"Count all events as busy": "すべての予定を「予定あり」とする", "Count all events as busy": "すべての予定を「予定あり」とする",
"Only events I'm attending": "参加する予定のみ", "Only events I'm attending": "参加する予定のみ",
"Don't include in availability": "空き状況に含めない", "Don't include in availability": "空き状況に含めない",
@@ -357,7 +496,6 @@ export const catalog: Catalog = {
"New address book": "新しいアドレス帳", "New address book": "新しいアドレス帳",
"No address books yet.": "アドレス帳がまだありません。", "No address books yet.": "アドレス帳がまだありません。",
"Choose from address books": "アドレス帳から選択", "Choose from address books": "アドレス帳から選択",
"Import vCard": "vCard をインポート",
"Export all contacts": "すべての連絡先をエクスポート", "Export all contacts": "すべての連絡先をエクスポート",
"Export address book": "このアドレス帳をエクスポート", "Export address book": "このアドレス帳をエクスポート",
"Import contacts…": "連絡先をインポート…", "Import contacts…": "連絡先をインポート…",
@@ -432,7 +570,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "ihasmail を自分好みに整えましょう。", "Make ihasmail yours.": "ihasmail を自分好みに整えましょう。",
"Reading": "閲覧", "Reading": "閲覧",
"Reading pane": "プレビューウィンドウ", "Reading pane": "プレビューウィンドウ",
"Reading, sending and list behaviour. Settings are stored in this browser.": "閲覧・送信・一覧の動作。設定はこのブラウザーに保存されます。",
"Right of the list": "一覧の右", "Right of the list": "一覧の右",
"Below the list": "一覧の下", "Below the list": "一覧の下",
"Hidden (open full width)": "表示しない(全幅で開く)", "Hidden (open full width)": "表示しない(全幅で開く)",
@@ -475,10 +612,6 @@ export const catalog: Catalog = {
"Time zone": "タイムゾーン", "Time zone": "タイムゾーン",
"Week starts on": "週の始まり", "Week starts on": "週の始まり",
"Monday": "月曜日", "Monday": "月曜日",
"Tuesday": "火曜日",
"Wednesday": "水曜日",
"Thursday": "木曜日",
"Friday": "金曜日",
"Saturday": "土曜日", "Saturday": "土曜日",
"Sunday": "日曜日", "Sunday": "日曜日",
"12-hour clock (6:23 PM)": "12 時間制 (6:23 PM)", "12-hour clock (6:23 PM)": "12 時間制 (6:23 PM)",
@@ -729,12 +862,10 @@ export const catalog: Catalog = {
"Manage labels": "ラベルを管理", "Manage labels": "ラベルを管理",
"Create “{name}”": "「{name}」を作成", "Create “{name}”": "「{name}」を作成",
"Type a name to create your first label.": "名前を入力すると、最初のラベルを作成できます。", "Type a name to create your first label.": "名前を入力すると、最初のラベルを作成できます。",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "ラベルはメールに保存される IMAP キーワードなので、他のクライアントにも同期されます。名前と色はこのブラウザーに保存されます。",
"New label": "新しいラベル", "New label": "新しいラベル",
"Delete label": "ラベルを削除", "Delete label": "ラベルを削除",
// ── Attachments, dates, search prose ─────────────────────────────── // ── Attachments, dates, search prose ───────────────────────────────
"PDF": "PDF",
"Large attachments may be rejected by some servers": "大きな添付ファイルは、サーバーによっては拒否されることがあります", "Large attachments may be rejected by some servers": "大きな添付ファイルは、サーバーによっては拒否されることがあります",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "画像は「ファイル」内(フォルダー「ihasmail」)に保存され、送信時にメールへ埋め込まれます。", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "画像は「ファイル」内(フォルダー「ihasmail」)に保存され、送信時にメールへ埋め込まれます。",
"After": "以降", "After": "以降",
@@ -747,6 +878,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "すべてのショートカットはメール画面で確認できます。", "Open the Mail view to see all shortcuts.": "すべてのショートカットはメール画面で確認できます。",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Gmail 形式のショートカットは常に有効です。どこでも {key} を押すとこの一覧を表示します。", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Gmail 形式のショートカットは常に有効です。どこでも {key} を押すとこの一覧を表示します。",
"Select a conversation to read it here · Press {key} for shortcuts": "スレッドを選ぶとここに表示されます · {key} でショートカット一覧", "Select a conversation to read it here · Press {key} for shortcuts": "スレッドを選ぶとここに表示されます · {key} でショートカット一覧",
"Select a message to read it here · Press {key} for shortcuts": "メールを選ぶとここに表示されます · {key} でショートカット一覧",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "ヒント: スレッド上で {key} を押すとラベルを付けられます。検索には {operator} が使えます。", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "ヒント: スレッド上で {key} を押すとラベルを付けられます。検索には {operator} が使えます。",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "{server} のための、軽快で使いやすいオープンソースのウェブメール。JMAP で動作します。", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "{server} のための、軽快で使いやすいオープンソースのウェブメール。JMAP で動作します。",
@@ -808,7 +940,6 @@ export const catalog: Catalog = {
"Copy it into {name} now — it isn't shown again.": "いま {name} にコピーしてください。二度と表示されません。", "Copy it into {name} now — it isn't shown again.": "いま {name} にコピーしてください。二度と表示されません。",
"No other users found in the directory, so nobody new can be added. Sharing already in place is listed below and can still be removed.": "ディレクトリに他のユーザーが見つからないため、新しく追加することはできません。すでに設定されている共有は下に表示され、解除はできます。", "No other users found in the directory, so nobody new can be added. Sharing already in place is listed below and can still be removed.": "ディレクトリに他のユーザーが見つからないため、新しく追加することはできません。すでに設定されている共有は下に表示され、解除はできます。",
"Stalwart does not publish its version number to mail clients, so ihasmail reports the edition where the server gives one. ihasmail requires 0.16 or newer, and sign-in refuses anything older.": "Stalwart はメールクライアントにバージョン番号を公開しないため、ihasmail はサーバーが示すエディションだけを表示します。ihasmail には 0.16 以降が必要で、それより古いサーバーへのサインインは拒否されます。", "Stalwart does not publish its version number to mail clients, so ihasmail reports the edition where the server gives one. ihasmail requires 0.16 or newer, and sign-in refuses anything older.": "Stalwart はメールクライアントにバージョン番号を公開しないため、ihasmail はサーバーが示すエディションだけを表示します。ihasmail には 0.16 以降が必要で、それより古いサーバーへのサインインは拒否されます。",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} は {site} の配色で、新しいアカウントの初期テーマです。ダークテーマなので、明暗が問われる場面ではダークとして扱われます。下のアクセントカラーはその上に重ねて適用されます。",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "ihasmail 自身のバージョンは、ビルド元となったコミットの日付と、そのコミットの出どころを並べたものです。{example} は 2026 年 8 月 30 日付のコミットから作られ、そのコミットはプルリクエスト 129 を通って届きました。プルリクエストを経ていないコミットは、代わりに短い SHA が付きます — {sha}。バージョンには Stalwart に関する情報をあえて含めていません。このビルドがサーバーに求めるものは、上の行に示されています。", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "ihasmail 自身のバージョンは、ビルド元となったコミットの日付と、そのコミットの出どころを並べたものです。{example} は 2026 年 8 月 30 日付のコミットから作られ、そのコミットはプルリクエスト 129 を通って届きました。プルリクエストを経ていないコミットは、代わりに短い SHA が付きます — {sha}。バージョンには Stalwart に関する情報をあえて含めていません。このビルドがサーバーに求めるものは、上の行に示されています。",
// ── Constant labels ──────────────────────────────────────────────── // ── Constant labels ────────────────────────────────────────────────
@@ -843,6 +974,7 @@ export const catalog: Catalog = {
"Not spam": "迷惑メールではない", "Not spam": "迷惑メールではない",
"Nothing": "何もしない", "Nothing": "何もしない",
"No conversation selected": "スレッドが選択されていません", "No conversation selected": "スレッドが選択されていません",
"No message selected": "メールが選択されていません",
"Drop here for the top level": "ここにドロップすると最上位へ移動します", "Drop here for the top level": "ここにドロップすると最上位へ移動します",
"Later today": "今日のうちに", "Later today": "今日のうちに",
"Tomorrow morning": "明日の朝", "Tomorrow morning": "明日の朝",
@@ -861,6 +993,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "迷惑メール", "folder\u0004Junk Mail": "迷惑メール",
"folder\u0004Important": "重要", "folder\u0004Important": "重要",
"folder\u0004All mail": "すべてのメール", "folder\u0004All mail": "すべてのメール",
"share sheet\u0004Share": "共有",
"share sheet\u0004Share…": "共有…",
"folder": "フォルダー", "folder": "フォルダー",
"“{name}” moved into “{parent}”": "「{name}」を「{parent}」に移動しました", "“{name}” moved into “{parent}”": "「{name}」を「{parent}」に移動しました",
"“{name}” moved to the top level": "「{name}」を最上位に移動しました", "“{name}” moved to the top level": "「{name}」を最上位に移動しました",
@@ -871,6 +1005,8 @@ export const catalog: Catalog = {
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "新規メール", "New message": "新規メール",
"New mail": "新着メール",
"Could not do that — open ihasmail and try again": "実行できませんでした - ihasmail を開いてやり直してください",
"Sending…": "送信中…", "Sending…": "送信中…",
"Saving…": "保存中…", "Saving…": "保存中…",
"Error": "エラー", "Error": "エラー",
@@ -911,6 +1047,7 @@ export const catalog: Catalog = {
"Could not copy the address": "アドレスをコピーできませんでした", "Could not copy the address": "アドレスをコピーできませんでした",
"Could not empty folder: {error}": "フォルダーを空にできませんでした: {error}", "Could not empty folder: {error}": "フォルダーを空にできませんでした: {error}",
"Could not load source: {error}": "ソースを読み込めませんでした: {error}", "Could not load source: {error}": "ソースを読み込めませんでした: {error}",
"Could not share: {error}": "共有できませんでした: {error}",
"Could not mark as read: {error}": "既読にできませんでした: {error}", "Could not mark as read: {error}": "既読にできませんでした: {error}",
"Could not save draft: {error}": "下書きを保存できませんでした: {error}", "Could not save draft: {error}": "下書きを保存できませんでした: {error}",
"Could not save filter: {error}": "フィルターを保存できませんでした: {error}", "Could not save filter: {error}": "フィルターを保存できませんでした: {error}",
@@ -1359,6 +1496,15 @@ export const catalog: Catalog = {
"no address": "アドレスなし", "no address": "アドレスなし",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { other: "{n} 件のアカウントがこのドメインを使用しています。先に移動または削除してください。" },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { other: "サーバーはこのドメイン宛てのメールを受け付けなくなり、{n} 個の DKIM 鍵も削除されます。元に戻すことはできません。" },
"{n} domains": { other: "{n} 件のドメイン" },
"{n} mailing lists": { other: "{n} 件のメーリングリスト" },
"{n} DKIM keys": { other: "{n} 個の DKIM 鍵" },
"{n} other items": { other: "その他 {n} 件" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { other: "{n} 件のアカウント" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { other: "{n} 件を削除" }, "Delete {n} items": { other: "{n} 件を削除" },
"Delete {n} items?": { other: "{n} 件を削除しますか?" }, "Delete {n} items?": { other: "{n} 件を削除しますか?" },
@@ -1388,8 +1534,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { other: "管理者が {n} 件の設定を変更しました" }, "Your administrator changed {n} settings": { other: "管理者が {n} 件の設定を変更しました" },
"Exported {n} events": { other: "{n} 件の予定をエクスポートしました" }, "Exported {n} events": { other: "{n} 件の予定をエクスポートしました" },
"Imported {n} events": { other: "{n} 件の予定をインポートしました" }, "Imported {n} events": { other: "{n} 件の予定をインポートしました" },
"Already here: {n} events, nothing imported": { other: "すでに存在: {n} 件、インポートなし" }, "Updated {n} events, nothing new": { other: "{n} 件の予定を更新しました。新規はありません" },
"{n} were already here": { other: "{n} 件はすでに存在していました" },
/* /*
* One form each, because Japanese has one. Intl.PluralRules returns * One form each, because Japanese has one. Intl.PluralRules returns
* `other` for every number, so `one`, `few` and `many` would never be * `other` for every number, so `one`, `few` and `many` would never be
+157 -12
View File
@@ -43,6 +43,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Domeinen",
"By hand": "Handmatig",
"Signing": "Ondertekent",
"Published, not signing yet": "Gepubliceerd, ondertekent nog niet",
"Retiring": "Wordt uitgefaseerd",
"Retired": "Uitgefaseerd",
"This domain no longer exists. Someone may have removed it.": "Dit domein bestaat niet meer. Mogelijk heeft iemand het verwijderd.",
"That doesn't look like a domain name, such as example.com.": "Dat lijkt niet op een domeinnaam, zoals example.com.",
"Added {name}. Its DNS records are ready to copy.": "{name} toegevoegd. De DNS-records staan klaar om te kopiëren.",
"Saved {name}": "{name} opgeslagen",
"Add domain": "Domein toevoegen",
"Added {date}": "Toegevoegd op {date}",
"This domain is disabled on the server.": "Dit domein is op de server uitgeschakeld.",
"Your role lets you view domains but not change them.": "Met uw rol kunt u domeinen bekijken, maar niet wijzigen.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Nieuwe domeinen ondertekenen hun e-mail met DKIM-sleutels die de server aanmaakt en vervangt. De DNS-records verschijnen hier zodra het domein is toegevoegd.",
"Other names": "Andere namen",
"Delivery": "Bezorging",
"Catch-all address": "Catch-alladres",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "E-mail aan een adres dat niemand op dit domein heeft, wordt hier bezorgd. Laat leeg om die e-mail te weigeren.",
"Plus addressing": "Plus-adressering",
"Set by a custom rule on the server.": "Ingesteld door een aangepaste regel op de server.",
"Mail to name+anything@ is delivered to name@.": "E-mail aan naam+wat-dan-ook@ wordt bezorgd bij naam@.",
"DNS records": "DNS-records",
"Published automatically through {provider}.": "Automatisch gepubliceerd via {provider}.",
"Published automatically by the server.": "Automatisch gepubliceerd door de server.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Voeg deze toe waar de DNS van dit domein wordt beheerd. Tot die tijd wordt e-mail niet bezorgd of vertrouwd.",
"Copy {type} record for {name}": "{type}-record voor {name} kopiëren",
"Copy value": "Waarde kopiëren",
"Copied the zone file": "Zonebestand gekopieerd",
"Copy all as a zone file": "Alles als zonebestand kopiëren",
"The server returned no records for this domain.": "De server gaf geen records voor dit domein.",
"DKIM keys": "DKIM-sleutels",
"The server creates and rotates these keys itself.": "De server maakt en vervangt deze sleutels zelf.",
"These keys are managed by hand on the server.": "Deze sleutels worden op de server handmatig beheerd.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "Geen DKIM-sleutels: e-mail van dit domein wordt niet ondertekend en komt eerder in de spam terecht.",
"Managed by the server": "Beheerd door de server",
"Certificate": "Certificaat",
"Another name for this domain": "Andere naam voor dit domein",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "E-mail aan hetzelfde adres onder een van deze namen komt in hetzelfde account. Wijzigingen gelden na opslaan.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "De DKIM-sleutels moeten eerst worden verwijderd, en uw rol mag dat niet.",
"The server stops accepting mail for this domain.": "De server accepteert geen e-mail meer voor dit domein.",
"Remove domain…": "Domein verwijderen…",
"Remove {name}?": "{name} verwijderen?",
"Removed {name}": "{name} verwijderd",
"The server kept the domain: it is still used by {things}.": "De server heeft het domein behouden: het wordt nog gebruikt door {things}.",
"Remove domain": "Domein verwijderen",
"The server stops accepting mail for this domain. This can't be undone.": "De server accepteert geen e-mail meer voor dit domein. Dit kan niet ongedaan worden gemaakt.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Waar uw adressen wonen, en de DNS-records waardoor e-mail aankomt en wordt vertrouwd.",
"Search domains": "Domeinen zoeken",
"No domains match": "Geen domeinen gevonden",
"No domains yet": "Nog geen domeinen",
"DKIM": "DKIM",
"Tenant": "Tenant",
"Disabled": "Uitgeschakeld",
"also {names}": "ook {names}",
"The server did not say whether the domain was created.": "De server heeft niet gemeld of het domein is aangemaakt.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Dat is geen geldige domeinnaam. Gebruik een naam zoals example.com, met een echt topleveldomein.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Dat is geen geldig e-mailadres. Gebruik een volledig adres, zoals [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Dat is geen geldig adres. Gebruik letters, cijfers, punten, koppeltekens of underscores vóór de @.",
"That isn't a valid host name or IP address.": "Dat is geen geldige hostnaam of IP-adres.",
"A required value was left empty.": "Een verplichte waarde is leeg gelaten.",
"Administration is turned off on this installation.": "Beheer is uitgeschakeld in deze installatie.",
"The mail server could not carry out the request ({code}).": "De mailserver kon het verzoek niet uitvoeren ({code}).",
"You can't give an account permissions your own role doesn't have.": "U kunt een account geen rechten geven die uw eigen rol niet heeft.",
"This account signs in through an external directory, so its password can't be set here.": "Dit account logt in via een externe adreslijst, dus het wachtwoord kan hier niet worden ingesteld.",
"The server's licence allows no more accounts.": "De licentie van de server staat geen extra accounts toe.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Die domeinnaam is op deze server al in gebruik, als domein of als andere naam van een ander domein.",
"Your organisation has reached the number of domains it is allowed.": "Uw organisatie heeft het toegestane aantal domeinen bereikt.",
"That is more than the mail server accepts in one change.": "Dat is meer dan de mailserver in één wijziging accepteert.",
"The mail server rejected one of the values. Check what you entered and try again.": "De mailserver heeft een van de waarden geweigerd. Controleer wat u hebt ingevuld en probeer het opnieuw.",
"The mail server refused the change ({code}).": "De mailserver heeft de wijziging geweigerd ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Alleen op een apparaat dat u als uw eigen apparaat hebt aangemerkt. Log opnieuw in met Dit is mijn eigen apparaat aangevinkt.",
"Change your own password in {settings}.": "Wijzig uw eigen wachtwoord bij {settings}.",
"Administration": "Beheer",
"Directory": "Adreslijst",
"User": "Gebruiker",
"Administrator": "Beheerder",
"Custom role": "Aangepaste rol",
"New account": "Nieuw account",
"The people who sign in to mail on the domains you manage.": "De mensen die op de domeinen die u beheert inloggen op hun e-mail.",
"Search by name or address": "Zoeken op naam of adres",
"Search accounts": "Accounts zoeken",
"No accounts match": "Geen accounts gevonden",
"No accounts yet": "Nog geen accounts",
"Nothing on your domains matches “{query}”.": "Niets op uw domeinen komt overeen met {query}.",
"Open {address}": "{address} openen",
"{from}{to} of {total}": "{from}{to} van {total}",
"Previous page": "Vorige pagina",
"Next page": "Volgende pagina",
"Storage": "Opslag",
"Groups": "Groepen",
"{used} · no limit": "{used} · geen limiet",
"Profile": "Profiel",
"Domain": "Domein",
"No domains are available to create an account on.": "Er is geen domein beschikbaar om een account op aan te maken.",
"Sign-in": "Inloggen",
"Other addresses": "Andere adressen",
"Not in any group": "Geen lid van een groep",
"You can't change your own role.": "U kunt uw eigen rol niet wijzigen.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Alleen rollen waarvan u de rechten zelf hebt, worden aangeboden. Bij een account binnen een tenant betekent Beheerder: beheerder van die tenant.",
"Limit in GB": "Limiet in GB",
"No limit": "Geen limiet",
"This account has permissions yours doesn't, so you can view it but not change it.": "Dit account heeft rechten die het uwe niet heeft. U kunt het bekijken, maar niet wijzigen.",
"Your role lets you view accounts but not change them.": "Met uw rol kunt u accounts bekijken, maar niet wijzigen.",
"This account has permissions yours doesn't.": "Dit account heeft rechten die het uwe niet heeft.",
"You can't delete the account you're signed in with.": "U kunt het account waarmee u bent ingelogd niet verwijderen.",
"Create account": "Account aanmaken",
"An account needs an address.": "Een account heeft een adres nodig.",
"Created {address}": "{address} aangemaakt",
"Saved {address}": "{address} opgeslagen",
"Generate a password": "Wachtwoord genereren",
"Pass it on some way other than email to this address.": "Geef het door op een andere manier dan per e-mail naar dit adres.",
"This account has no password. It may sign in through a directory or single sign-on.": "Dit account heeft geen wachtwoord. Mogelijk logt het in via een adreslijst of single sign-on.",
"Set a new password…": "Nieuw wachtwoord instellen…",
"{name} will be signed out of every app and device using the old password.": "{name} wordt uitgelogd in alle apps en op alle apparaten die het oude wachtwoord gebruiken.",
"New password set for {address}": "Nieuw wachtwoord ingesteld voor {address}",
"Set password": "Wachtwoord instellen",
"Remove {address}": "{address} verwijderen",
"New address": "Nieuw adres",
"another name": "andere naam",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "E-mail aan deze adressen wordt in dit account afgeleverd. Wijzigingen gelden na opslaan.",
"Deletes the mailbox and everything in it.": "Verwijdert de mailbox en alles erin.",
"Delete account…": "Account verwijderen…",
"Delete {address}?": "{address} verwijderen?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Hiermee worden de e-mail, agendas, contacten en bestanden in dit account verwijderd. De server wist ze op de achtergrond en dit kan niet ongedaan worden gemaakt.",
"Type {address} to confirm": "Typ {address} om te bevestigen",
"Delete account": "Account verwijderen",
"Deleted {address}": "{address} verwijderd",
"The server did not say whether the account was created.": "De server heeft niet gemeld of het account is aangemaakt.",
"The mail server refused this. Your role may not allow it.": "De mailserver heeft dit geweigerd. Uw rol staat het mogelijk niet toe.",
"That address is already in use on this server, as an account, a list or an alias.": "Dat adres is op deze server al in gebruik, als account, lijst of alias.",
"One of the chosen domain, role or group can't be used for this account.": "Het gekozen domein, de rol of de groep kan niet voor dit account worden gebruikt.",
"Your organisation has reached the number of accounts it is allowed.": "Uw organisatie heeft het toegestane aantal accounts bereikt.",
"Something still depends on this, so the server kept it.": "Er hangt nog iets van af, dus de server heeft het behouden.",
"This account no longer exists. Someone may have deleted it.": "Dit account bestaat niet meer. Mogelijk heeft iemand het verwijderd.",
"The password was not accepted: {reason}": "Het wachtwoord is niet geaccepteerd: {reason}",
"The password was not accepted.": "Het wachtwoord is niet geaccepteerd.",
"Go to folder…": "Ga naar map…", "Go to folder…": "Ga naar map…",
"Set for everyone here. You cannot change this.": "Hier voor iedereen ingesteld. U kunt dit niet wijzigen.", "Set for everyone here. You cannot change this.": "Hier voor iedereen ingesteld. U kunt dit niet wijzigen.",
"Export iCAL file": "iCAL-bestand exporteren", "Export iCAL file": "iCAL-bestand exporteren",
@@ -315,7 +455,6 @@ export const catalog: Catalog = {
"Busy": "Bezet", "Busy": "Bezet",
"Free/busy": "Vrij/bezet", "Free/busy": "Vrij/bezet",
"Show as": "Weergeven als", "Show as": "Weergeven als",
"Availability on {date}": "Beschikbaarheid op {date}",
"Count all events as busy": "Alle afspraken als bezet tellen", "Count all events as busy": "Alle afspraken als bezet tellen",
"Only events I'm attending": "Alleen afspraken waaraan ik deelneem", "Only events I'm attending": "Alleen afspraken waaraan ik deelneem",
"Don't include in availability": "Niet meetellen voor beschikbaarheid", "Don't include in availability": "Niet meetellen voor beschikbaarheid",
@@ -354,7 +493,6 @@ export const catalog: Catalog = {
"New address book": "Nieuw adresboek", "New address book": "Nieuw adresboek",
"No address books yet.": "Nog geen adresboeken.", "No address books yet.": "Nog geen adresboeken.",
"Choose from address books": "Kiezen uit adresboeken", "Choose from address books": "Kiezen uit adresboeken",
"Import vCard": "vCard importeren",
"Export all contacts": "Alle contacten exporteren", "Export all contacts": "Alle contacten exporteren",
"Export address book": "Dit adresboek exporteren", "Export address book": "Dit adresboek exporteren",
"Import contacts…": "Contacten importeren…", "Import contacts…": "Contacten importeren…",
@@ -429,7 +567,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Maak ihasmail van uzelf.", "Make ihasmail yours.": "Maak ihasmail van uzelf.",
"Reading": "Lezen", "Reading": "Lezen",
"Reading pane": "Leesvenster", "Reading pane": "Leesvenster",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Gedrag bij lezen, verzenden en in de lijst. De instellingen worden in deze browser bewaard.",
"Right of the list": "Rechts van de lijst", "Right of the list": "Rechts van de lijst",
"Below the list": "Onder de lijst", "Below the list": "Onder de lijst",
"Hidden (open full width)": "Verborgen (op volle breedte openen)", "Hidden (open full width)": "Verborgen (op volle breedte openen)",
@@ -472,10 +609,6 @@ export const catalog: Catalog = {
"Time zone": "Tijdzone", "Time zone": "Tijdzone",
"Week starts on": "Week begint op", "Week starts on": "Week begint op",
"Monday": "Maandag", "Monday": "Maandag",
"Tuesday": "Dinsdag",
"Wednesday": "Woensdag",
"Thursday": "Donderdag",
"Friday": "Vrijdag",
"Saturday": "Zaterdag", "Saturday": "Zaterdag",
"Sunday": "Zondag", "Sunday": "Zondag",
"12-hour clock (6:23 PM)": "12-uursnotatie (6:23 PM)", "12-hour clock (6:23 PM)": "12-uursnotatie (6:23 PM)",
@@ -721,10 +854,8 @@ export const catalog: Catalog = {
"Manage labels": "Labels beheren", "Manage labels": "Labels beheren",
"Create “{name}”": "“{name}” maken", "Create “{name}”": "“{name}” maken",
"Type a name to create your first label.": "Typ een naam om uw eerste label te maken.", "Type a name to create your first label.": "Typ een naam om uw eerste label te maken.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Labels zijn IMAP-trefwoorden die in uw berichten worden opgeslagen en dus met andere clients synchroniseren. Namen en kleuren blijven in deze browser.",
"New label": "Nieuw label", "New label": "Nieuw label",
"Delete label": "Label verwijderen", "Delete label": "Label verwijderen",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Grote bijlagen worden door sommige servers geweigerd", "Large attachments may be rejected by some servers": "Grote bijlagen worden door sommige servers geweigerd",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Afbeeldingen worden opgeslagen in uw Bestanden (map “ihasmail”) en bij verzending ingesloten.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Afbeeldingen worden opgeslagen in uw Bestanden (map “ihasmail”) en bij verzending ingesloten.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Bedankt voor uw bericht. Ik ben afwezig tot … en reageer zodra ik terug ben.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Bedankt voor uw bericht. Ik ben afwezig tot … en reageer zodra ik terug ben.",
@@ -797,6 +928,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Spam", "folder\u0004Junk Mail": "Spam",
"folder\u0004Important": "Belangrijk", "folder\u0004Important": "Belangrijk",
"folder\u0004All mail": "Alle berichten", "folder\u0004All mail": "Alle berichten",
"share sheet\u0004Share": "Delen",
"share sheet\u0004Share…": "Delen…",
"folder": "map", "folder": "map",
"“{name}” moved into “{parent}”": "“{name}” is verplaatst naar “{parent}”", "“{name}” moved into “{parent}”": "“{name}” is verplaatst naar “{parent}”",
"“{name}” moved to the top level": "“{name}” is naar het hoogste niveau verplaatst", "“{name}” moved to the top level": "“{name}” is naar het hoogste niveau verplaatst",
@@ -805,6 +938,7 @@ export const catalog: Catalog = {
"Rename folder": "Map hernoemen", "Rename folder": "Map hernoemen",
"Search: {query}": "Zoeken: {query}", "Search: {query}": "Zoeken: {query}",
"No conversation selected": "Geen gesprek geselecteerd", "No conversation selected": "Geen gesprek geselecteerd",
"No message selected": "Geen bericht geselecteerd",
"Drop here for the top level": "Hier neerzetten voor het hoogste niveau", "Drop here for the top level": "Hier neerzetten voor het hoogste niveau",
// ── Longer prose ─────────────────────────────────────────────────── // ── Longer prose ───────────────────────────────────────────────────
@@ -813,6 +947,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Open de E-mailweergave om alle sneltoetsen te zien.", "Open the Mail view to see all shortcuts.": "Open de E-mailweergave om alle sneltoetsen te zien.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Sneltoetsen in Gmail-stijl staan altijd aan. Druk overal op {key} om deze lijst te zien.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Sneltoetsen in Gmail-stijl staan altijd aan. Druk overal op {key} om deze lijst te zien.",
"Select a conversation to read it here · Press {key} for shortcuts": "Selecteer een gesprek om het hier te lezen · {key} voor sneltoetsen", "Select a conversation to read it here · Press {key} for shortcuts": "Selecteer een gesprek om het hier te lezen · {key} voor sneltoetsen",
"Select a message to read it here · Press {key} for shortcuts": "Selecteer een bericht om het hier te lezen · {key} voor sneltoetsen",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Tip: druk op {key} bij een gesprek om labels toe te wijzen. Zoek met {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Tip: druk op {key} bij een gesprek om labels toe te wijzen. Zoek met {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Een snelle, prettige, opensource webmail voor {server}, gebouwd op JMAP.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Een snelle, prettige, opensource webmail voor {server}, gebouwd op JMAP.",
"Defaults for the calendar views and new events.": "Standaardwaarden voor de agendaweergaven en nieuwe afspraken.", "Defaults for the calendar views and new events.": "Standaardwaarden voor de agendaweergaven en nieuwe afspraken.",
@@ -854,11 +989,12 @@ export const catalog: Catalog = {
"Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Hier verschijnen alleen talen waarin ihasmail is vertaald; de lijst groeit dus mee met de vertalingen en niet erop vooruit — een taal die wordt aangeboden zonder teksten erachter zou de pagina laten beweren dat ze in een taal is die ze niet is.", "Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Hier verschijnen alleen talen waarin ihasmail is vertaald; de lijst groeit dus mee met de vertalingen en niet erop vooruit — een taal die wordt aangeboden zonder teksten erachter zou de pagina laten beweren dat ze in een taal is die ze niet is.",
"tell us about it": "laat het ons weten", "tell us about it": "laat het ons weten",
"This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Deze vertaling is door AI gemaakt en niet gecontroleerd door iemand met Nederlands als moedertaal; ze is daarom als Beta gemarkeerd tot iemand haar goedkeurt. Alles wat verkeerd klinkt, is een melding waard — {report}.", "This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Deze vertaling is door AI gemaakt en niet gecontroleerd door iemand met Nederlands als moedertaal; ze is daarom als Beta gemarkeerd tot iemand haar goedkeurt. Alles wat verkeerd klinkt, is een melding waard — {report}.",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} is het kleurenpalet van {site}, en waarmee een nieuw account begint. Het is een donker thema en telt dus overal als donker waar dat uitmaakt; de accentkleur hieronder werkt er nog steeds bovenop.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "De eigen versie van ihasmail is de datum van de commit waaruit het is gebouwd, gevolgd door waar die commit vandaan kwam: {example} is gebouwd uit een commit van 30 augustus 2026 die via pull request 129 binnenkwam. Een commit die niet via zo'n verzoek kwam, draagt in plaats daarvan zijn korte SHA — {sha}. De versie zegt bewust niets over Stalwart; wat deze build van de server nodig heeft, staat op de regel hierboven.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "De eigen versie van ihasmail is de datum van de commit waaruit het is gebouwd, gevolgd door waar die commit vandaan kwam: {example} is gebouwd uit een commit van 30 augustus 2026 die via pull request 129 binnenkwam. Een commit die niet via zo'n verzoek kwam, draagt in plaats daarvan zijn korte SHA — {sha}. De versie zegt bewust niets over Stalwart; wat deze build van de server nodig heeft, staat op de regel hierboven.",
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Nieuw bericht", "New message": "Nieuw bericht",
"New mail": "Nieuwe e-mail",
"Could not do that — open ihasmail and try again": "Dat lukte niet — open ihasmail en probeer het opnieuw",
"Sending…": "Bezig met verzenden…", "Sending…": "Bezig met verzenden…",
"Saving…": "Bezig met opslaan…", "Saving…": "Bezig met opslaan…",
"Error": "Fout", "Error": "Fout",
@@ -899,6 +1035,7 @@ export const catalog: Catalog = {
"Could not copy the address": "Het adres kon niet worden gekopieerd", "Could not copy the address": "Het adres kon niet worden gekopieerd",
"Could not empty folder: {error}": "Map legen mislukt: {error}", "Could not empty folder: {error}": "Map legen mislukt: {error}",
"Could not load source: {error}": "De bron kon niet worden geladen: {error}", "Could not load source: {error}": "De bron kon niet worden geladen: {error}",
"Could not share: {error}": "Delen is niet gelukt: {error}",
"Could not mark as read: {error}": "Markeren als gelezen mislukt: {error}", "Could not mark as read: {error}": "Markeren als gelezen mislukt: {error}",
"Could not save draft: {error}": "Concept opslaan mislukt: {error}", "Could not save draft: {error}": "Concept opslaan mislukt: {error}",
"Could not save filter: {error}": "Filter opslaan mislukt: {error}", "Could not save filter: {error}": "Filter opslaan mislukt: {error}",
@@ -1347,6 +1484,15 @@ export const catalog: Catalog = {
"no address": "geen adres", "no address": "geen adres",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "{n} account gebruikt dit domein. Verplaats of verwijder het eerst.", other: "{n} accounts gebruiken dit domein. Verplaats of verwijder ze eerst." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "De server accepteert geen e-mail meer voor dit domein en de {n} DKIM-sleutel wordt verwijderd. Dit kan niet ongedaan worden gemaakt.", other: "De server accepteert geen e-mail meer voor dit domein en de {n} DKIM-sleutels worden verwijderd. Dit kan niet ongedaan worden gemaakt." },
"{n} domains": { one: "{n} domein", other: "{n} domeinen" },
"{n} mailing lists": { one: "{n} mailinglijst", other: "{n} mailinglijsten" },
"{n} DKIM keys": { one: "{n} DKIM-sleutel", other: "{n} DKIM-sleutels" },
"{n} other items": { one: "{n} ander item", other: "{n} andere items" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} account", other: "{n} accounts" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "{n} item verwijderen", other: "{n} items verwijderen" }, "Delete {n} items": { one: "{n} item verwijderen", other: "{n} items verwijderen" },
"Delete {n} items?": { one: "{n} item verwijderen?", other: "{n} items verwijderen?" }, "Delete {n} items?": { one: "{n} item verwijderen?", other: "{n} items verwijderen?" },
@@ -1376,8 +1522,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Uw beheerder heeft {n} instelling gewijzigd", other: "Uw beheerder heeft {n} instellingen gewijzigd" }, "Your administrator changed {n} settings": { one: "Uw beheerder heeft {n} instelling gewijzigd", other: "Uw beheerder heeft {n} instellingen gewijzigd" },
"Exported {n} events": { one: "{n} afspraak geëxporteerd", other: "{n} afspraken geëxporteerd" }, "Exported {n} events": { one: "{n} afspraak geëxporteerd", other: "{n} afspraken geëxporteerd" },
"Imported {n} events": { one: "{n} afspraak geïmporteerd", other: "{n} afspraken geïmporteerd" }, "Imported {n} events": { one: "{n} afspraak geïmporteerd", other: "{n} afspraken geïmporteerd" },
"Already here: {n} events, nothing imported": { one: "Al aanwezig: {n} afspraak, niets geïmporteerd", other: "Al aanwezig: {n} afspraken, niets geïmporteerd" }, "Updated {n} events, nothing new": { one: "{n} afspraak bijgewerkt, niets nieuws", other: "{n} afspraken bijgewerkt, niets nieuws" },
"{n} were already here": { one: "{n} was er al", other: "{n} waren er al" },
"{n} messages": { one: "{n} bericht", other: "{n} berichten" }, "{n} messages": { one: "{n} bericht", other: "{n} berichten" },
"{n} selected": { one: "{n} geselecteerd", other: "{n} geselecteerd" }, "{n} selected": { one: "{n} geselecteerd", other: "{n} geselecteerd" },
"{n} conversations": { one: "{n} gesprek", other: "{n} gesprekken" }, "{n} conversations": { one: "{n} gesprek", other: "{n} gesprekken" },
+157 -12
View File
@@ -50,6 +50,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Domínios",
"By hand": "Manual",
"Signing": "Assinando",
"Published, not signing yet": "Publicada, ainda não assina",
"Retiring": "Sendo retirada",
"Retired": "Retirada",
"This domain no longer exists. Someone may have removed it.": "Este domínio não existe mais. Talvez alguém o tenha removido.",
"That doesn't look like a domain name, such as example.com.": "Isso não parece um nome de domínio, como example.com.",
"Added {name}. Its DNS records are ready to copy.": "{name} adicionado. Os registros DNS estão prontos para copiar.",
"Saved {name}": "{name} salvo",
"Add domain": "Adicionar domínio",
"Added {date}": "Adicionado em {date}",
"This domain is disabled on the server.": "Este domínio está desativado no servidor.",
"Your role lets you view domains but not change them.": "Sua função permite ver os domínios, mas não alterá-los.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Domínios novos assinam os e-mails com chaves DKIM que o servidor cria e renova. Os registros DNS aparecem aqui depois que o domínio é adicionado.",
"Other names": "Outros nomes",
"Delivery": "Entrega",
"Catch-all address": "Endereço pega-tudo",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "E-mails para um endereço que ninguém tem neste domínio são entregues aqui. Deixe vazio para recusá-los.",
"Plus addressing": "Endereços com +",
"Set by a custom rule on the server.": "Definido por uma regra personalizada no servidor.",
"Mail to name+anything@ is delivered to name@.": "E-mails para nome+qualquercoisa@ são entregues a nome@.",
"DNS records": "Registros DNS",
"Published automatically through {provider}.": "Publicados automaticamente via {provider}.",
"Published automatically by the server.": "Publicados automaticamente pelo servidor.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Adicione-os onde o DNS deste domínio está hospedado. Os e-mails não são entregues nem considerados confiáveis até que estejam lá.",
"Copy {type} record for {name}": "Copiar o registro {type} de {name}",
"Copy value": "Copiar valor",
"Copied the zone file": "Arquivo de zona copiado",
"Copy all as a zone file": "Copiar tudo como arquivo de zona",
"The server returned no records for this domain.": "O servidor não retornou registros para este domínio.",
"DKIM keys": "Chaves DKIM",
"The server creates and rotates these keys itself.": "O servidor cria e renova estas chaves sozinho.",
"These keys are managed by hand on the server.": "Estas chaves são gerenciadas manualmente no servidor.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "Sem chaves DKIM: os e-mails deste domínio não são assinados e têm mais chance de ir para o spam.",
"Managed by the server": "Gerenciado pelo servidor",
"Certificate": "Certificado",
"Another name for this domain": "Outro nome para este domínio",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "E-mails para o mesmo endereço em qualquer um destes nomes chegam à mesma conta. As alterações valem ao salvar.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "As chaves DKIM precisam ser removidas primeiro, e sua função não pode removê-las.",
"The server stops accepting mail for this domain.": "O servidor deixa de aceitar e-mails para este domínio.",
"Remove domain…": "Remover domínio…",
"Remove {name}?": "Remover {name}?",
"Removed {name}": "{name} removido",
"The server kept the domain: it is still used by {things}.": "O servidor manteve o domínio: ele ainda é usado por {things}.",
"Remove domain": "Remover domínio",
"The server stops accepting mail for this domain. This can't be undone.": "O servidor deixa de aceitar e-mails para este domínio. Não é possível desfazer.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Onde seus endereços ficam, e os registros DNS que fazem os e-mails chegarem e serem confiáveis.",
"Search domains": "Pesquisar domínios",
"No domains match": "Nenhum domínio corresponde",
"No domains yet": "Ainda não há domínios",
"DKIM": "DKIM",
"Tenant": "Locatário",
"Disabled": "Desativado",
"also {names}": "também {names}",
"The server did not say whether the domain was created.": "O servidor não informou se o domínio foi criado.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Esse não é um nome de domínio válido. Use um nome como example.com, com um domínio de nível superior real.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Esse não é um endereço de e-mail válido. Use um endereço completo, como [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Esse não é um endereço válido. Use letras, números, pontos, hifens ou sublinhados antes do @.",
"That isn't a valid host name or IP address.": "Esse não é um nome de host ou endereço IP válido.",
"A required value was left empty.": "Um valor obrigatório foi deixado em branco.",
"Administration is turned off on this installation.": "A administração está desativada nesta instalação.",
"The mail server could not carry out the request ({code}).": "O servidor de e-mail não conseguiu executar a solicitação ({code}).",
"You can't give an account permissions your own role doesn't have.": "Você não pode dar a uma conta permissões que sua própria função não tem.",
"This account signs in through an external directory, so its password can't be set here.": "Esta conta entra por meio de um diretório externo, então a senha dela não pode ser definida aqui.",
"The server's licence allows no more accounts.": "A licença do servidor não permite mais contas.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Esse nome de domínio já está em uso neste servidor, como domínio ou como outro nome de outro domínio.",
"Your organisation has reached the number of domains it is allowed.": "Sua organização atingiu o número de domínios permitido.",
"That is more than the mail server accepts in one change.": "Isso é mais do que o servidor de e-mail aceita em uma única alteração.",
"The mail server rejected one of the values. Check what you entered and try again.": "O servidor de e-mail recusou um dos valores. Confira o que você digitou e tente novamente.",
"The mail server refused the change ({code}).": "O servidor de e-mail recusou a alteração ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Só em um dispositivo que você marcou como seu. Entre novamente com “Este dispositivo é meu” marcado.",
"Change your own password in {settings}.": "Altere sua própria senha em {settings}.",
"Administration": "Administração",
"Directory": "Diretório",
"User": "Usuário",
"Administrator": "Administrador",
"Custom role": "Função personalizada",
"New account": "Nova conta",
"The people who sign in to mail on the domains you manage.": "As pessoas que entram no e-mail nos domínios que você administra.",
"Search by name or address": "Pesquisar por nome ou endereço",
"Search accounts": "Pesquisar contas",
"No accounts match": "Nenhuma conta corresponde",
"No accounts yet": "Ainda não há contas",
"Nothing on your domains matches “{query}”.": "Nada nos seus domínios corresponde a “{query}”.",
"Open {address}": "Abrir {address}",
"{from}{to} of {total}": "{from}{to} de {total}",
"Previous page": "Página anterior",
"Next page": "Próxima página",
"Storage": "Armazenamento",
"Groups": "Grupos",
"{used} · no limit": "{used} · sem limite",
"Profile": "Perfil",
"Domain": "Domínio",
"No domains are available to create an account on.": "Não há nenhum domínio disponível para criar uma conta.",
"Sign-in": "Acesso",
"Other addresses": "Outros endereços",
"Not in any group": "Não está em nenhum grupo",
"You can't change your own role.": "Você não pode alterar sua própria função.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Só são oferecidas as funções cujas permissões você mesmo tem. Em uma conta dentro de um locatário, Administrador significa administrador desse locatário.",
"Limit in GB": "Limite em GB",
"No limit": "Sem limite",
"This account has permissions yours doesn't, so you can view it but not change it.": "Esta conta tem permissões que a sua não tem, então você pode vê-la, mas não alterá-la.",
"Your role lets you view accounts but not change them.": "Sua função permite ver as contas, mas não alterá-las.",
"This account has permissions yours doesn't.": "Esta conta tem permissões que a sua não tem.",
"You can't delete the account you're signed in with.": "Você não pode excluir a conta com a qual está conectado.",
"Create account": "Criar conta",
"An account needs an address.": "Uma conta precisa de um endereço.",
"Created {address}": "{address} criada",
"Saved {address}": "{address} salva",
"Generate a password": "Gerar uma senha",
"Pass it on some way other than email to this address.": "Repasse-a por outro meio que não seja um e-mail para este endereço.",
"This account has no password. It may sign in through a directory or single sign-on.": "Esta conta não tem senha. Ela pode entrar por meio de um diretório ou de login único.",
"Set a new password…": "Definir nova senha…",
"{name} will be signed out of every app and device using the old password.": "{name} será desconectado de todos os apps e dispositivos que usam a senha antiga.",
"New password set for {address}": "Nova senha definida para {address}",
"Set password": "Definir senha",
"Remove {address}": "Remover {address}",
"New address": "Novo endereço",
"another name": "outro nome",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "Os e-mails enviados a estes endereços são entregues nesta conta. As alterações valem ao salvar.",
"Deletes the mailbox and everything in it.": "Exclui a caixa de correio e tudo o que há nela.",
"Delete account…": "Excluir conta…",
"Delete {address}?": "Excluir {address}?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Isto exclui os e-mails, agendas, contatos e arquivos desta conta. O servidor os remove em segundo plano, e não é possível desfazer.",
"Type {address} to confirm": "Digite {address} para confirmar",
"Delete account": "Excluir conta",
"Deleted {address}": "{address} excluída",
"The server did not say whether the account was created.": "O servidor não informou se a conta foi criada.",
"The mail server refused this. Your role may not allow it.": "O servidor de e-mail recusou. Talvez sua função não permita.",
"That address is already in use on this server, as an account, a list or an alias.": "Esse endereço já está em uso neste servidor, como conta, lista ou alias.",
"One of the chosen domain, role or group can't be used for this account.": "O domínio, a função ou o grupo escolhido não pode ser usado nesta conta.",
"Your organisation has reached the number of accounts it is allowed.": "Sua organização atingiu o número de contas permitido.",
"Something still depends on this, so the server kept it.": "Algo ainda depende disto, então o servidor o manteve.",
"This account no longer exists. Someone may have deleted it.": "Esta conta não existe mais. Talvez alguém a tenha excluído.",
"The password was not accepted: {reason}": "A senha não foi aceita: {reason}",
"The password was not accepted.": "A senha não foi aceita.",
"Go to folder…": "Ir para a pasta…", "Go to folder…": "Ir para a pasta…",
"Set for everyone here. You cannot change this.": "Definido para todos aqui. Você não pode alterar isto.", "Set for everyone here. You cannot change this.": "Definido para todos aqui. Você não pode alterar isto.",
"Export iCAL file": "Exportar arquivo iCAL", "Export iCAL file": "Exportar arquivo iCAL",
@@ -322,7 +462,6 @@ export const catalog: Catalog = {
"Busy": "Ocupado", "Busy": "Ocupado",
"Free/busy": "Disponibilidade", "Free/busy": "Disponibilidade",
"Show as": "Mostrar como", "Show as": "Mostrar como",
"Availability on {date}": "Disponibilidade em {date}",
"Count all events as busy": "Contar todos os eventos como ocupado", "Count all events as busy": "Contar todos os eventos como ocupado",
"Only events I'm attending": "Somente os eventos de que participo", "Only events I'm attending": "Somente os eventos de que participo",
"Don't include in availability": "Não incluir na disponibilidade", "Don't include in availability": "Não incluir na disponibilidade",
@@ -361,7 +500,6 @@ export const catalog: Catalog = {
"New address book": "Novo catálogo de endereços", "New address book": "Novo catálogo de endereços",
"No address books yet.": "Ainda não há catálogos de endereços.", "No address books yet.": "Ainda não há catálogos de endereços.",
"Choose from address books": "Escolher nos catálogos de endereços", "Choose from address books": "Escolher nos catálogos de endereços",
"Import vCard": "Importar um vCard",
"Export all contacts": "Exportar todos os contatos", "Export all contacts": "Exportar todos os contatos",
"Export address book": "Exportar este catálogo de endereços", "Export address book": "Exportar este catálogo de endereços",
"Import contacts…": "Importar contatos…", "Import contacts…": "Importar contatos…",
@@ -435,7 +573,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Deixe o ihasmail do seu jeito.", "Make ihasmail yours.": "Deixe o ihasmail do seu jeito.",
"Reading": "Leitura", "Reading": "Leitura",
"Reading pane": "Painel de leitura", "Reading pane": "Painel de leitura",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Comportamento de leitura, envio e lista. As configurações ficam guardadas neste navegador.",
"Right of the list": "À direita da lista", "Right of the list": "À direita da lista",
"Below the list": "Abaixo da lista", "Below the list": "Abaixo da lista",
"Hidden (open full width)": "Oculto (abrir em largura total)", "Hidden (open full width)": "Oculto (abrir em largura total)",
@@ -478,10 +615,6 @@ export const catalog: Catalog = {
"Time zone": "Fuso horário", "Time zone": "Fuso horário",
"Week starts on": "A semana começa em", "Week starts on": "A semana começa em",
"Monday": "Segunda-feira", "Monday": "Segunda-feira",
"Tuesday": "Terça-feira",
"Wednesday": "Quarta-feira",
"Thursday": "Quinta-feira",
"Friday": "Sexta-feira",
"Saturday": "Sábado", "Saturday": "Sábado",
"Sunday": "Domingo", "Sunday": "Domingo",
"12-hour clock (6:23 PM)": "Formato de 12 horas (6:23 PM)", "12-hour clock (6:23 PM)": "Formato de 12 horas (6:23 PM)",
@@ -728,10 +861,8 @@ export const catalog: Catalog = {
"Manage labels": "Gerenciar os marcadores", "Manage labels": "Gerenciar os marcadores",
"Create “{name}”": "Criar “{name}”", "Create “{name}”": "Criar “{name}”",
"Type a name to create your first label.": "Digite um nome para criar seu primeiro marcador.", "Type a name to create your first label.": "Digite um nome para criar seu primeiro marcador.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Os marcadores são palavras-chave IMAP guardadas nas suas mensagens, então eles sincronizam com outros clientes. Os nomes e as cores ficam neste navegador.",
"New label": "Novo marcador", "New label": "Novo marcador",
"Delete label": "Excluir o marcador", "Delete label": "Excluir o marcador",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Anexos grandes podem ser recusados por alguns servidores", "Large attachments may be rejected by some servers": "Anexos grandes podem ser recusados por alguns servidores",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "As imagens são guardadas nos seus Arquivos (pasta “ihasmail”) e incorporadas no envio.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "As imagens são guardadas nos seus Arquivos (pasta “ihasmail”) e incorporadas no envio.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Obrigado pela sua mensagem. Estarei ausente até … e responderei quando voltar.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Obrigado pela sua mensagem. Estarei ausente até … e responderei quando voltar.",
@@ -804,6 +935,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Spam", "folder\u0004Junk Mail": "Spam",
"folder\u0004Important": "Importante", "folder\u0004Important": "Importante",
"folder\u0004All mail": "Todas as mensagens", "folder\u0004All mail": "Todas as mensagens",
"share sheet\u0004Share": "Compartilhar",
"share sheet\u0004Share…": "Compartilhar…",
"folder": "pasta", "folder": "pasta",
"“{name}” moved into “{parent}”": "“{name}” foi movida para “{parent}”", "“{name}” moved into “{parent}”": "“{name}” foi movida para “{parent}”",
"“{name}” moved to the top level": "“{name}” foi movida para o nível superior", "“{name}” moved to the top level": "“{name}” foi movida para o nível superior",
@@ -812,6 +945,7 @@ export const catalog: Catalog = {
"Rename folder": "Renomear a pasta", "Rename folder": "Renomear a pasta",
"Search: {query}": "Pesquisa: {query}", "Search: {query}": "Pesquisa: {query}",
"No conversation selected": "Nenhuma conversa selecionada", "No conversation selected": "Nenhuma conversa selecionada",
"No message selected": "Nenhuma mensagem selecionada",
"Drop here for the top level": "Solte aqui para o nível superior", "Drop here for the top level": "Solte aqui para o nível superior",
// ── Longer prose ─────────────────────────────────────────────────── // ── Longer prose ───────────────────────────────────────────────────
@@ -820,6 +954,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Abra a visualização de E-mail para ver todos os atalhos.", "Open the Mail view to see all shortcuts.": "Abra a visualização de E-mail para ver todos os atalhos.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Os atalhos no estilo do Gmail estão sempre ativos. Pressione {key} em qualquer lugar para ver esta lista.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Os atalhos no estilo do Gmail estão sempre ativos. Pressione {key} em qualquer lugar para ver esta lista.",
"Select a conversation to read it here · Press {key} for shortcuts": "Selecione uma conversa para lê-la aqui · {key} para os atalhos", "Select a conversation to read it here · Press {key} for shortcuts": "Selecione uma conversa para lê-la aqui · {key} para os atalhos",
"Select a message to read it here · Press {key} for shortcuts": "Selecione uma mensagem para lê-la aqui · {key} para os atalhos",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Dica: pressione {key} em uma conversa para aplicar marcadores. Pesquise com {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Dica: pressione {key} em uma conversa para aplicar marcadores. Pesquise com {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Um webmail livre, rápido e agradável para {server}, feito sobre JMAP.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Um webmail livre, rápido e agradável para {server}, feito sobre JMAP.",
"Defaults for the calendar views and new events.": "Padrões das visualizações da agenda e dos eventos novos.", "Defaults for the calendar views and new events.": "Padrões das visualizações da agenda e dos eventos novos.",
@@ -861,11 +996,12 @@ export const catalog: Catalog = {
"Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Aqui aparecem só os idiomas para os quais o ihasmail foi traduzido, então a lista cresce conforme as traduções chegam, e não antes — um idioma oferecido sem textos por trás faria a página afirmar estar em um idioma que não é o dela.", "Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Aqui aparecem só os idiomas para os quais o ihasmail foi traduzido, então a lista cresce conforme as traduções chegam, e não antes — um idioma oferecido sem textos por trás faria a página afirmar estar em um idioma que não é o dela.",
"tell us about it": "conte para nós", "tell us about it": "conte para nós",
"This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Esta tradução foi gerada por IA e não foi revisada por uma pessoa nativa, então está marcada como Beta até que alguém a aprove. Tudo o que soar errado vale um aviso — {report}.", "This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Esta tradução foi gerada por IA e não foi revisada por uma pessoa nativa, então está marcada como Beta até que alguém a aprove. Tudo o que soar errado vale um aviso — {report}.",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} é a paleta de {site}, e com a qual uma conta nova começa. É um tema escuro, então conta como escuro onde isso importa, e a cor de destaque abaixo continua valendo por cima dele.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "A versão do próprio ihasmail é a data do commit a partir do qual ele foi compilado, seguida da origem desse commit: {example} foi compilado a partir de um commit de 30 de agosto de 2026 que veio pela pull request 129. Um commit que não veio por uma delas carrega no lugar o SHA curto — {sha}. A versão não diz nada sobre o Stalwart de propósito; o que esta compilação precisa do servidor está na linha acima.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "A versão do próprio ihasmail é a data do commit a partir do qual ele foi compilado, seguida da origem desse commit: {example} foi compilado a partir de um commit de 30 de agosto de 2026 que veio pela pull request 129. Um commit que não veio por uma delas carrega no lugar o SHA curto — {sha}. A versão não diz nada sobre o Stalwart de propósito; o que esta compilação precisa do servidor está na linha acima.",
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Nova mensagem", "New message": "Nova mensagem",
"New mail": "Novo e-mail",
"Could not do that — open ihasmail and try again": "Não foi possível fazer isso — abra o ihasmail e tente novamente",
"Sending…": "Enviando…", "Sending…": "Enviando…",
"Saving…": "Salvando…", "Saving…": "Salvando…",
"Error": "Erro", "Error": "Erro",
@@ -906,6 +1042,7 @@ export const catalog: Catalog = {
"Could not copy the address": "Não foi possível copiar o endereço", "Could not copy the address": "Não foi possível copiar o endereço",
"Could not empty folder: {error}": "Não foi possível esvaziar a pasta: {error}", "Could not empty folder: {error}": "Não foi possível esvaziar a pasta: {error}",
"Could not load source: {error}": "Não foi possível carregar o código-fonte: {error}", "Could not load source: {error}": "Não foi possível carregar o código-fonte: {error}",
"Could not share: {error}": "Não foi possível compartilhar: {error}",
"Could not mark as read: {error}": "Não foi possível marcar como lida: {error}", "Could not mark as read: {error}": "Não foi possível marcar como lida: {error}",
"Could not save draft: {error}": "Não foi possível salvar o rascunho: {error}", "Could not save draft: {error}": "Não foi possível salvar o rascunho: {error}",
"Could not save filter: {error}": "Não foi possível salvar o filtro: {error}", "Could not save filter: {error}": "Não foi possível salvar o filtro: {error}",
@@ -1354,6 +1491,15 @@ export const catalog: Catalog = {
"no address": "nenhum endereço", "no address": "nenhum endereço",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "{n} conta usa este domínio. Mova-a ou exclua-a primeiro.", other: "{n} contas usam este domínio. Mova-as ou exclua-as primeiro." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "O servidor deixa de aceitar e-mails para este domínio, e a {n} chave DKIM dele é excluída. Não é possível desfazer.", other: "O servidor deixa de aceitar e-mails para este domínio, e as {n} chaves DKIM dele são excluídas. Não é possível desfazer." },
"{n} domains": { one: "{n} domínio", other: "{n} domínios" },
"{n} mailing lists": { one: "{n} lista de e-mails", other: "{n} listas de e-mails" },
"{n} DKIM keys": { one: "{n} chave DKIM", other: "{n} chaves DKIM" },
"{n} other items": { one: "{n} outro item", other: "{n} outros itens" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} conta", other: "{n} contas" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "Excluir {n} item", other: "Excluir {n} itens" }, "Delete {n} items": { one: "Excluir {n} item", other: "Excluir {n} itens" },
"Delete {n} items?": { one: "Excluir {n} item?", other: "Excluir {n} itens?" }, "Delete {n} items?": { one: "Excluir {n} item?", other: "Excluir {n} itens?" },
@@ -1383,8 +1529,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Sua administração alterou {n} configuração", other: "Sua administração alterou {n} configurações" }, "Your administrator changed {n} settings": { one: "Sua administração alterou {n} configuração", other: "Sua administração alterou {n} configurações" },
"Exported {n} events": { one: "{n} evento exportado", other: "{n} eventos exportados" }, "Exported {n} events": { one: "{n} evento exportado", other: "{n} eventos exportados" },
"Imported {n} events": { one: "{n} evento importado", other: "{n} eventos importados" }, "Imported {n} events": { one: "{n} evento importado", other: "{n} eventos importados" },
"Already here: {n} events, nothing imported": { one: "Já estava aqui: {n} evento, nada importado", other: "Já estavam aqui: {n} eventos, nada importado" }, "Updated {n} events, nothing new": { one: "{n} evento atualizado, nada novo", other: "{n} eventos atualizados, nada novo" },
"{n} were already here": { one: "{n} já estava aqui", other: "{n} já estavam aqui" },
"{n} messages": { one: "{n} mensagem", other: "{n} mensagens" }, "{n} messages": { one: "{n} mensagem", other: "{n} mensagens" },
"{n} selected": { one: "{n} selecionada", other: "{n} selecionadas" }, "{n} selected": { one: "{n} selecionada", other: "{n} selecionadas" },
"{n} conversations": { one: "{n} conversa", other: "{n} conversas" }, "{n} conversations": { one: "{n} conversa", other: "{n} conversas" },
+157 -12
View File
@@ -49,6 +49,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Домены",
"By hand": "Вручную",
"Signing": "Подписывает",
"Published, not signing yet": "Опубликован, ещё не подписывает",
"Retiring": "Выводится из работы",
"Retired": "Выведен из работы",
"This domain no longer exists. Someone may have removed it.": "Этого домена больше нет. Возможно, его кто-то удалил.",
"That doesn't look like a domain name, such as example.com.": "Это не похоже на имя домена вроде example.com.",
"Added {name}. Its DNS records are ready to copy.": "Домен {name} добавлен. Его DNS-записи готовы к копированию.",
"Saved {name}": "Домен {name} сохранён",
"Add domain": "Добавить домен",
"Added {date}": "Добавлен {date}",
"This domain is disabled on the server.": "Этот домен отключён на сервере.",
"Your role lets you view domains but not change them.": "Ваша роль позволяет просматривать домены, но не изменять их.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Новые домены подписывают почту ключами DKIM, которые сервер создаёт и меняет сам. DNS-записи появятся здесь после добавления домена.",
"Other names": "Другие имена",
"Delivery": "Доставка",
"Catch-all address": "Адрес для всей почты",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "Сюда доставляются письма на адреса этого домена, которых ни у кого нет. Оставьте пустым, чтобы отклонять такие письма.",
"Plus addressing": "Адреса с «+»",
"Set by a custom rule on the server.": "Задано особым правилом на сервере.",
"Mail to name+anything@ is delivered to name@.": "Письма на имя+что-угодно@ доставляются на имя@.",
"DNS records": "DNS-записи",
"Published automatically through {provider}.": "Публикуются автоматически через {provider}.",
"Published automatically by the server.": "Публикуются сервером автоматически.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Добавьте их там, где размещён DNS этого домена. Пока их нет, почта не доставляется и не считается надёжной.",
"Copy {type} record for {name}": "Скопировать запись {type} для {name}",
"Copy value": "Скопировать значение",
"Copied the zone file": "Файл зоны скопирован",
"Copy all as a zone file": "Скопировать всё как файл зоны",
"The server returned no records for this domain.": "Сервер не вернул записей для этого домена.",
"DKIM keys": "Ключи DKIM",
"The server creates and rotates these keys itself.": "Сервер создаёт и меняет эти ключи сам.",
"These keys are managed by hand on the server.": "Эти ключи управляются на сервере вручную.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "Ключей DKIM нет, поэтому почта с этого домена не подписывается и чаще попадает в спам.",
"Managed by the server": "Управляется сервером",
"Certificate": "Сертификат",
"Another name for this domain": "Другое имя для этого домена",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "Письма на тот же адрес под любым из этих имён попадают в ту же учётную запись. Изменения вступят в силу после сохранения.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "Сначала нужно удалить его ключи DKIM, а ваша роль этого не позволяет.",
"The server stops accepting mail for this domain.": "Сервер перестанет принимать почту для этого домена.",
"Remove domain…": "Удалить домен…",
"Remove {name}?": "Удалить {name}?",
"Removed {name}": "Домен {name} удалён",
"The server kept the domain: it is still used by {things}.": "Сервер сохранил домен: его ещё используют {things}.",
"Remove domain": "Удалить домен",
"The server stops accepting mail for this domain. This can't be undone.": "Сервер перестанет принимать почту для этого домена. Отменить это нельзя.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Где находятся ваши адреса и DNS-записи, благодаря которым почта доходит и вызывает доверие.",
"Search domains": "Поиск доменов",
"No domains match": "Нет подходящих доменов",
"No domains yet": "Доменов пока нет",
"DKIM": "DKIM",
"Tenant": "Арендатор",
"Disabled": "Отключён",
"also {names}": "также {names}",
"The server did not say whether the domain was created.": "Сервер не сообщил, создан ли домен.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Это недопустимое имя домена. Укажите имя вроде example.com с настоящим доменом верхнего уровня.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Это недопустимый адрес электронной почты. Укажите полный адрес, например [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Это недопустимый адрес. Перед @ используйте буквы, цифры, точки, дефисы или подчёркивания.",
"That isn't a valid host name or IP address.": "Это недопустимое имя хоста или IP-адрес.",
"A required value was left empty.": "Обязательное значение не заполнено.",
"Administration is turned off on this installation.": "Администрирование отключено в этой установке.",
"The mail server could not carry out the request ({code}).": "Почтовый сервер не смог выполнить запрос ({code}).",
"You can't give an account permissions your own role doesn't have.": "Нельзя дать учётной записи разрешения, которых нет у вашей роли.",
"This account signs in through an external directory, so its password can't be set here.": "Эта учётная запись входит через внешний каталог, поэтому её пароль нельзя задать здесь.",
"The server's licence allows no more accounts.": "Лицензия сервера не допускает новых учётных записей.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Это имя домена уже используется на сервере — как домен или как другое имя другого домена.",
"Your organisation has reached the number of domains it is allowed.": "Ваша организация достигла допустимого числа доменов.",
"That is more than the mail server accepts in one change.": "Это больше, чем почтовый сервер принимает за одно изменение.",
"The mail server rejected one of the values. Check what you entered and try again.": "Почтовый сервер отклонил одно из значений. Проверьте введённые данные и попробуйте снова.",
"The mail server refused the change ({code}).": "Почтовый сервер отклонил изменение ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Только на устройстве, отмеченном как ваше. Войдите снова, отметив «Это моё личное устройство».",
"Change your own password in {settings}.": "Свой пароль можно изменить в разделе {settings}.",
"Administration": "Администрирование",
"Directory": "Каталог",
"User": "Пользователь",
"Administrator": "Администратор",
"Custom role": "Особая роль",
"New account": "Новая учётная запись",
"The people who sign in to mail on the domains you manage.": "Люди, которые входят в почту на доменах, которыми вы управляете.",
"Search by name or address": "Поиск по имени или адресу",
"Search accounts": "Поиск учётных записей",
"No accounts match": "Нет подходящих учётных записей",
"No accounts yet": "Учётных записей пока нет",
"Nothing on your domains matches “{query}”.": "На ваших доменах нет совпадений с «{query}».",
"Open {address}": "Открыть {address}",
"{from}{to} of {total}": "{from}{to} из {total}",
"Previous page": "Предыдущая страница",
"Next page": "Следующая страница",
"Storage": "Хранилище",
"Groups": "Группы",
"{used} · no limit": "{used} · без ограничения",
"Profile": "Профиль",
"Domain": "Домен",
"No domains are available to create an account on.": "Нет доменов, на которых можно создать учётную запись.",
"Sign-in": "Вход",
"Other addresses": "Другие адреса",
"Not in any group": "Не состоит ни в одной группе",
"You can't change your own role.": "Нельзя изменить собственную роль.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Предлагаются только роли, все разрешения которых есть у вас самих. Для учётной записи внутри арендатора «Администратор» означает администратора этого арендатора.",
"Limit in GB": "Ограничение в ГБ",
"No limit": "Без ограничения",
"This account has permissions yours doesn't, so you can view it but not change it.": "У этой учётной записи есть разрешения, которых нет у вашей, поэтому её можно просматривать, но не изменять.",
"Your role lets you view accounts but not change them.": "Ваша роль позволяет просматривать учётные записи, но не изменять их.",
"This account has permissions yours doesn't.": "У этой учётной записи есть разрешения, которых нет у вашей.",
"You can't delete the account you're signed in with.": "Нельзя удалить учётную запись, под которой вы вошли.",
"Create account": "Создать учётную запись",
"An account needs an address.": "Учётной записи нужен адрес.",
"Created {address}": "Учётная запись {address} создана",
"Saved {address}": "Учётная запись {address} сохранена",
"Generate a password": "Сгенерировать пароль",
"Pass it on some way other than email to this address.": "Передайте его любым способом, кроме письма на этот адрес.",
"This account has no password. It may sign in through a directory or single sign-on.": "У этой учётной записи нет пароля. Возможно, вход выполняется через каталог или единый вход.",
"Set a new password…": "Задать новый пароль…",
"{name} will be signed out of every app and device using the old password.": "Для {name} будет выполнен выход во всех приложениях и на всех устройствах, где используется старый пароль.",
"New password set for {address}": "Новый пароль для {address} задан",
"Set password": "Задать пароль",
"Remove {address}": "Удалить {address}",
"New address": "Новый адрес",
"another name": "другое имя",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "Письма на эти адреса доставляются в эту учётную запись. Изменения вступят в силу после сохранения.",
"Deletes the mailbox and everything in it.": "Удаляет почтовый ящик и всё его содержимое.",
"Delete account…": "Удалить учётную запись…",
"Delete {address}?": "Удалить {address}?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Будут удалены почта, календари, контакты и файлы этой учётной записи. Сервер удалит их в фоновом режиме, отменить это нельзя.",
"Type {address} to confirm": "Введите {address} для подтверждения",
"Delete account": "Удалить учётную запись",
"Deleted {address}": "Учётная запись {address} удалена",
"The server did not say whether the account was created.": "Сервер не сообщил, создана ли учётная запись.",
"The mail server refused this. Your role may not allow it.": "Почтовый сервер отклонил это действие. Возможно, ваша роль его не допускает.",
"That address is already in use on this server, as an account, a list or an alias.": "Этот адрес уже используется на сервере — учётной записью, списком или псевдонимом.",
"One of the chosen domain, role or group can't be used for this account.": "Выбранный домен, роль или группу нельзя использовать для этой учётной записи.",
"Your organisation has reached the number of accounts it is allowed.": "Ваша организация достигла допустимого числа учётных записей.",
"Something still depends on this, so the server kept it.": "От этого ещё что-то зависит, поэтому сервер это сохранил.",
"This account no longer exists. Someone may have deleted it.": "Этой учётной записи больше нет. Возможно, её кто-то удалил.",
"The password was not accepted: {reason}": "Пароль не принят: {reason}",
"The password was not accepted.": "Пароль не принят.",
"Go to folder…": "Перейти к папке…", "Go to folder…": "Перейти к папке…",
"Set for everyone here. You cannot change this.": "Задано для всех здесь. Изменить нельзя.", "Set for everyone here. You cannot change this.": "Задано для всех здесь. Изменить нельзя.",
"Export iCAL file": "Экспортировать файл iCAL", "Export iCAL file": "Экспортировать файл iCAL",
@@ -321,7 +461,6 @@ export const catalog: Catalog = {
"Busy": "Занят", "Busy": "Занят",
"Free/busy": "Занятость", "Free/busy": "Занятость",
"Show as": "Показывать как", "Show as": "Показывать как",
"Availability on {date}": "Занятость на {date}",
"Count all events as busy": "Считать все события занятостью", "Count all events as busy": "Считать все события занятостью",
"Only events I'm attending": "Только события, где я участвую", "Only events I'm attending": "Только события, где я участвую",
"Don't include in availability": "Не учитывать в занятости", "Don't include in availability": "Не учитывать в занятости",
@@ -360,7 +499,6 @@ export const catalog: Catalog = {
"New address book": "Новая адресная книга", "New address book": "Новая адресная книга",
"No address books yet.": "Адресных книг пока нет.", "No address books yet.": "Адресных книг пока нет.",
"Choose from address books": "Выбрать из адресных книг", "Choose from address books": "Выбрать из адресных книг",
"Import vCard": "Импорт vCard",
"Export all contacts": "Экспортировать все контакты", "Export all contacts": "Экспортировать все контакты",
"Export address book": "Экспортировать эту адресную книгу", "Export address book": "Экспортировать эту адресную книгу",
"Import contacts…": "Импортировать контакты…", "Import contacts…": "Импортировать контакты…",
@@ -435,7 +573,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Настройте ihasmail под себя.", "Make ihasmail yours.": "Настройте ihasmail под себя.",
"Reading": "Чтение", "Reading": "Чтение",
"Reading pane": "Область чтения", "Reading pane": "Область чтения",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Поведение при чтении, отправке и в списке. Настройки хранятся в этом браузере.",
"Right of the list": "Справа от списка", "Right of the list": "Справа от списка",
"Below the list": "Под списком", "Below the list": "Под списком",
"Hidden (open full width)": "Скрыта (открывать во всю ширину)", "Hidden (open full width)": "Скрыта (открывать во всю ширину)",
@@ -478,10 +615,6 @@ export const catalog: Catalog = {
"Time zone": "Часовой пояс", "Time zone": "Часовой пояс",
"Week starts on": "Неделя начинается с", "Week starts on": "Неделя начинается с",
"Monday": "Понедельник", "Monday": "Понедельник",
"Tuesday": "Вторник",
"Wednesday": "Среда",
"Thursday": "Четверг",
"Friday": "Пятница",
"Saturday": "Суббота", "Saturday": "Суббота",
"Sunday": "Воскресенье", "Sunday": "Воскресенье",
"12-hour clock (6:23 PM)": "12-часовой формат (6:23 PM)", "12-hour clock (6:23 PM)": "12-часовой формат (6:23 PM)",
@@ -727,10 +860,8 @@ export const catalog: Catalog = {
"Manage labels": "Управление ярлыками", "Manage labels": "Управление ярлыками",
"Create “{name}”": "Создать «{name}»", "Create “{name}”": "Создать «{name}»",
"Type a name to create your first label.": "Введите название, чтобы создать первый ярлык.", "Type a name to create your first label.": "Введите название, чтобы создать первый ярлык.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Ярлыки — это ключевые слова IMAP, которые хранятся в самих письмах и синхронизируются с другими клиентами. Названия и цвета остаются в этом браузере.",
"New label": "Новый ярлык", "New label": "Новый ярлык",
"Delete label": "Удалить ярлык", "Delete label": "Удалить ярлык",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Некоторые серверы отклоняют большие вложения", "Large attachments may be rejected by some servers": "Некоторые серверы отклоняют большие вложения",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Изображения хранятся в ваших Файлах (папка «ihasmail») и вставляются при отправке.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Изображения хранятся в ваших Файлах (папка «ihasmail») и вставляются при отправке.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Спасибо за письмо. Я отсутствую до … и отвечу после возвращения.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Спасибо за письмо. Я отсутствую до … и отвечу после возвращения.",
@@ -803,6 +934,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Спам", "folder\u0004Junk Mail": "Спам",
"folder\u0004Important": "Важное", "folder\u0004Important": "Важное",
"folder\u0004All mail": "Вся почта", "folder\u0004All mail": "Вся почта",
"share sheet\u0004Share": "Поделиться",
"share sheet\u0004Share…": "Поделиться…",
"folder": "папка", "folder": "папка",
"“{name}” moved into “{parent}”": "«{name}» перемещена в «{parent}»", "“{name}” moved into “{parent}”": "«{name}» перемещена в «{parent}»",
"“{name}” moved to the top level": "«{name}» перемещена на верхний уровень", "“{name}” moved to the top level": "«{name}» перемещена на верхний уровень",
@@ -811,6 +944,7 @@ export const catalog: Catalog = {
"Rename folder": "Переименовать папку", "Rename folder": "Переименовать папку",
"Search: {query}": "Поиск: {query}", "Search: {query}": "Поиск: {query}",
"No conversation selected": "Цепочка не выбрана", "No conversation selected": "Цепочка не выбрана",
"No message selected": "Письмо не выбрано",
"Drop here for the top level": "Перетащите сюда, чтобы вынести на верхний уровень", "Drop here for the top level": "Перетащите сюда, чтобы вынести на верхний уровень",
// ── Longer prose ─────────────────────────────────────────────────── // ── Longer prose ───────────────────────────────────────────────────
@@ -819,6 +953,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Откройте раздел «Почта», чтобы увидеть все сочетания клавиш.", "Open the Mail view to see all shortcuts.": "Откройте раздел «Почта», чтобы увидеть все сочетания клавиш.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Сочетания клавиш в стиле Gmail всегда включены. Нажмите {key} в любом месте, чтобы увидеть этот список.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Сочетания клавиш в стиле Gmail всегда включены. Нажмите {key} в любом месте, чтобы увидеть этот список.",
"Select a conversation to read it here · Press {key} for shortcuts": "Выберите цепочку, чтобы прочитать её здесь · {key} — сочетания клавиш", "Select a conversation to read it here · Press {key} for shortcuts": "Выберите цепочку, чтобы прочитать её здесь · {key} — сочетания клавиш",
"Select a message to read it here · Press {key} for shortcuts": "Выберите письмо, чтобы прочитать его здесь · {key} — сочетания клавиш",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Совет: нажмите {key} на цепочке, чтобы присвоить ярлыки. Ищите через {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Совет: нажмите {key} на цепочке, чтобы присвоить ярлыки. Ищите через {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Быстрая и удобная веб-почта с открытым кодом для {server}, построенная на JMAP.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Быстрая и удобная веб-почта с открытым кодом для {server}, построенная на JMAP.",
"Defaults for the calendar views and new events.": "Значения по умолчанию для видов календаря и новых событий.", "Defaults for the calendar views and new events.": "Значения по умолчанию для видов календаря и новых событий.",
@@ -860,11 +995,12 @@ export const catalog: Catalog = {
"Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Здесь показаны только языки, на которые ihasmail переведён, поэтому список растёт вместе с переводами, а не опережает их: язык без текстов заставил бы страницу утверждать, что она написана на языке, которым не является.", "Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Здесь показаны только языки, на которые ihasmail переведён, поэтому список растёт вместе с переводами, а не опережает их: язык без текстов заставил бы страницу утверждать, что она написана на языке, которым не является.",
"tell us about it": "сообщите нам", "tell us about it": "сообщите нам",
"This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Этот перевод сделан ИИ и не проверен носителем языка, поэтому помечен как Beta до тех пор, пока кто-нибудь его не подтвердит. Обо всём, что звучит неправильно, стоит сообщить — {report}.", "This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Этот перевод сделан ИИ и не проверен носителем языка, поэтому помечен как Beta до тех пор, пока кто-нибудь его не подтвердит. Обо всём, что звучит неправильно, стоит сообщить — {report}.",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} — это палитра с {site}, с которой начинает новая учётная запись. Тема тёмная, поэтому везде, где это важно, считается тёмной, а акцентный цвет ниже применяется поверх неё.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "Собственная версия ihasmail — это дата коммита, из которого он собран, и указание, откуда этот коммит взялся: {example} собран из коммита от 30 августа 2026 года, пришедшего через pull request 129. Коммит, пришедший иначе, несёт вместо этого короткий SHA — {sha}. Версия намеренно ничего не сообщает о Stalwart; то, что этой сборке нужно от сервера, указано строкой выше.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "Собственная версия ihasmail — это дата коммита, из которого он собран, и указание, откуда этот коммит взялся: {example} собран из коммита от 30 августа 2026 года, пришедшего через pull request 129. Коммит, пришедший иначе, несёт вместо этого короткий SHA — {sha}. Версия намеренно ничего не сообщает о Stalwart; то, что этой сборке нужно от сервера, указано строкой выше.",
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Новое письмо", "New message": "Новое письмо",
"New mail": "Новое письмо",
"Could not do that — open ihasmail and try again": "Не удалось — откройте ihasmail и повторите попытку",
"Sending…": "Отправка…", "Sending…": "Отправка…",
"Saving…": "Сохранение…", "Saving…": "Сохранение…",
"Error": "Ошибка", "Error": "Ошибка",
@@ -905,6 +1041,7 @@ export const catalog: Catalog = {
"Could not copy the address": "Не удалось скопировать адрес", "Could not copy the address": "Не удалось скопировать адрес",
"Could not empty folder: {error}": "Не удалось очистить папку: {error}", "Could not empty folder: {error}": "Не удалось очистить папку: {error}",
"Could not load source: {error}": "Не удалось загрузить исходный текст: {error}", "Could not load source: {error}": "Не удалось загрузить исходный текст: {error}",
"Could not share: {error}": "Не удалось поделиться: {error}",
"Could not mark as read: {error}": "Не удалось отметить как прочитанное: {error}", "Could not mark as read: {error}": "Не удалось отметить как прочитанное: {error}",
"Could not save draft: {error}": "Не удалось сохранить черновик: {error}", "Could not save draft: {error}": "Не удалось сохранить черновик: {error}",
"Could not save filter: {error}": "Не удалось сохранить фильтр: {error}", "Could not save filter: {error}": "Не удалось сохранить фильтр: {error}",
@@ -1353,6 +1490,15 @@ export const catalog: Catalog = {
"no address": "нет адреса", "no address": "нет адреса",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "Этот домен использует {n} учётная запись. Сначала перенесите или удалите её.", few: "Этот домен используют {n} учётные записи. Сначала перенесите или удалите их.", many: "Этот домен используют {n} учётных записей. Сначала перенесите или удалите их.", other: "Этот домен используют {n} учётной записи. Сначала перенесите или удалите их." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "Сервер перестанет принимать почту для этого домена, и его {n} ключ DKIM будет удалён. Отменить это нельзя.", few: "Сервер перестанет принимать почту для этого домена, и его {n} ключа DKIM будут удалены. Отменить это нельзя.", many: "Сервер перестанет принимать почту для этого домена, и его {n} ключей DKIM будут удалены. Отменить это нельзя.", other: "Сервер перестанет принимать почту для этого домена, и его {n} ключа DKIM будут удалены. Отменить это нельзя." },
"{n} domains": { one: "{n} домен", few: "{n} домена", many: "{n} доменов", other: "{n} домена" },
"{n} mailing lists": { one: "{n} список рассылки", few: "{n} списка рассылки", many: "{n} списков рассылки", other: "{n} списка рассылки" },
"{n} DKIM keys": { one: "{n} ключ DKIM", few: "{n} ключа DKIM", many: "{n} ключей DKIM", other: "{n} ключа DKIM" },
"{n} other items": { one: "{n} другой объект", few: "{n} других объекта", many: "{n} других объектов", other: "{n} другого объекта" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} учётная запись", few: "{n} учётные записи", many: "{n} учётных записей", other: "{n} учётной записи" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "Удалить {n} объект", few: "Удалить {n} объекта", many: "Удалить {n} объектов", other: "Удалить {n} объекта" }, "Delete {n} items": { one: "Удалить {n} объект", few: "Удалить {n} объекта", many: "Удалить {n} объектов", other: "Удалить {n} объекта" },
"Delete {n} items?": { one: "Удалить {n} объект?", few: "Удалить {n} объекта?", many: "Удалить {n} объектов?", other: "Удалить {n} объекта?" }, "Delete {n} items?": { one: "Удалить {n} объект?", few: "Удалить {n} объекта?", many: "Удалить {n} объектов?", other: "Удалить {n} объекта?" },
@@ -1382,8 +1528,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Администратор изменил {n} настройку", few: "Администратор изменил {n} настройки", many: "Администратор изменил {n} настроек", other: "Администратор изменил {n} настройки" }, "Your administrator changed {n} settings": { one: "Администратор изменил {n} настройку", few: "Администратор изменил {n} настройки", many: "Администратор изменил {n} настроек", other: "Администратор изменил {n} настройки" },
"Exported {n} events": { one: "Экспортировано {n} событие", few: "Экспортировано {n} события", many: "Экспортировано {n} событий", other: "Экспортировано {n} события" }, "Exported {n} events": { one: "Экспортировано {n} событие", few: "Экспортировано {n} события", many: "Экспортировано {n} событий", other: "Экспортировано {n} события" },
"Imported {n} events": { one: "Импортировано {n} событие", few: "Импортировано {n} события", many: "Импортировано {n} событий", other: "Импортировано {n} события" }, "Imported {n} events": { one: "Импортировано {n} событие", few: "Импортировано {n} события", many: "Импортировано {n} событий", other: "Импортировано {n} события" },
"Already here: {n} events, nothing imported": { one: "Уже есть: {n} событие, ничего не импортировано", few: "Уже есть: {n} события, ничего не импортировано", many: "Уже есть: {n} событий, ничего не импортировано", other: "Уже есть: {n} события, ничего не импортировано" }, "Updated {n} events, nothing new": { one: "Обновлено {n} событие, новых нет", few: "Обновлено {n} события, новых нет", many: "Обновлено {n} событий, новых нет", other: "Обновлено {n} события, новых нет" },
"{n} were already here": { one: "{n} уже было здесь", few: "{n} уже были здесь", many: "{n} уже были здесь", other: "{n} уже были здесь" },
/* /*
* Three forms, which is the whole reason plural() takes a map rather than * Three forms, which is the whole reason plural() takes a map rather than
* (one, other). Intl.PluralRules picks: 1 is `one`, 2-4 are `few`, 5-20 * (one, other). Intl.PluralRules picks: 1 is `one`, 2-4 are `few`, 5-20
+157 -12
View File
@@ -43,6 +43,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "Домени",
"By hand": "Вручну",
"Signing": "Підписує",
"Published, not signing yet": "Опубліковано, ще не підписує",
"Retiring": "Виводиться з роботи",
"Retired": "Виведено з роботи",
"This domain no longer exists. Someone may have removed it.": "Цього домену більше немає. Можливо, його хтось видалив.",
"That doesn't look like a domain name, such as example.com.": "Це не схоже на ім'я домену на кшталт example.com.",
"Added {name}. Its DNS records are ready to copy.": "Домен {name} додано. Його DNS-записи готові до копіювання.",
"Saved {name}": "Домен {name} збережено",
"Add domain": "Додати домен",
"Added {date}": "Додано {date}",
"This domain is disabled on the server.": "Цей домен вимкнено на сервері.",
"Your role lets you view domains but not change them.": "Ваша роль дозволяє переглядати домени, але не змінювати їх.",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "Нові домени підписують пошту ключами DKIM, які сервер створює й змінює сам. DNS-записи з'являться тут після додавання домену.",
"Other names": "Інші імена",
"Delivery": "Доставлення",
"Catch-all address": "Адреса для всієї пошти",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "Сюди доставляються листи на адреси цього домену, яких ні в кого немає. Залиште порожнім, щоб відхиляти такі листи.",
"Plus addressing": "Адреси з «+»",
"Set by a custom rule on the server.": "Задано власним правилом на сервері.",
"Mail to name+anything@ is delivered to name@.": "Листи на ім'я+будь-що@ доставляються на ім'я@.",
"DNS records": "DNS-записи",
"Published automatically through {provider}.": "Публікуються автоматично через {provider}.",
"Published automatically by the server.": "Публікуються сервером автоматично.",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "Додайте їх там, де розміщено DNS цього домену. Поки їх немає, пошта не доставляється й не вважається надійною.",
"Copy {type} record for {name}": "Скопіювати запис {type} для {name}",
"Copy value": "Скопіювати значення",
"Copied the zone file": "Файл зони скопійовано",
"Copy all as a zone file": "Скопіювати все як файл зони",
"The server returned no records for this domain.": "Сервер не повернув записів для цього домену.",
"DKIM keys": "Ключі DKIM",
"The server creates and rotates these keys itself.": "Сервер створює й змінює ці ключі сам.",
"These keys are managed by hand on the server.": "Цими ключами керують на сервері вручну.",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "Ключів DKIM немає, тому пошта з цього домену не підписується й частіше потрапляє до спаму.",
"Managed by the server": "Керується сервером",
"Certificate": "Сертифікат",
"Another name for this domain": "Інше ім'я для цього домену",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "Листи на ту саму адресу під будь-яким із цих імен потрапляють до того самого облікового запису. Зміни наберуть чинності після збереження.",
"Its DKIM keys have to be removed first, and your role can't remove them.": "Спершу треба видалити його ключі DKIM, а ваша роль цього не дозволяє.",
"The server stops accepting mail for this domain.": "Сервер перестане приймати пошту для цього домену.",
"Remove domain…": "Видалити домен…",
"Remove {name}?": "Видалити {name}?",
"Removed {name}": "Домен {name} видалено",
"The server kept the domain: it is still used by {things}.": "Сервер зберіг домен: його ще використовують {things}.",
"Remove domain": "Видалити домен",
"The server stops accepting mail for this domain. This can't be undone.": "Сервер перестане приймати пошту для цього домену. Скасувати це неможливо.",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "Де розміщено ваші адреси та DNS-записи, завдяки яким пошта доходить і викликає довіру.",
"Search domains": "Пошук доменів",
"No domains match": "Немає відповідних доменів",
"No domains yet": "Доменів ще немає",
"DKIM": "DKIM",
"Tenant": "Орендар",
"Disabled": "Вимкнено",
"also {names}": "також {names}",
"The server did not say whether the domain was created.": "Сервер не повідомив, чи створено домен.",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "Це недійсне ім'я домену. Вкажіть ім'я на кшталт example.com зі справжнім доменом верхнього рівня.",
"That isn't a valid email address. Use a full address, such as [email protected].": "Це недійсна адреса електронної пошти. Вкажіть повну адресу, наприклад [email protected].",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "Це недійсна адреса. Перед @ використовуйте літери, цифри, крапки, дефіси або підкреслення.",
"That isn't a valid host name or IP address.": "Це недійсне ім'я хоста чи IP-адреса.",
"A required value was left empty.": "Обов'язкове значення не заповнено.",
"Administration is turned off on this installation.": "Адміністрування вимкнено в цьому встановленні.",
"The mail server could not carry out the request ({code}).": "Поштовий сервер не зміг виконати запит ({code}).",
"You can't give an account permissions your own role doesn't have.": "Не можна надати обліковому запису дозволи, яких немає у вашої ролі.",
"This account signs in through an external directory, so its password can't be set here.": "Цей обліковий запис входить через зовнішній каталог, тому його пароль не можна задати тут.",
"The server's licence allows no more accounts.": "Ліцензія сервера не дозволяє нових облікових записів.",
"That domain name is already in use on this server, as a domain or another domain's other name.": "Це ім'я домену вже використовується на сервері — як домен або як інше ім'я іншого домену.",
"Your organisation has reached the number of domains it is allowed.": "Ваша організація досягла дозволеної кількості доменів.",
"That is more than the mail server accepts in one change.": "Це більше, ніж поштовий сервер приймає за одну зміну.",
"The mail server rejected one of the values. Check what you entered and try again.": "Поштовий сервер відхилив одне зі значень. Перевірте введені дані й спробуйте ще раз.",
"The mail server refused the change ({code}).": "Поштовий сервер відхилив зміну ({code}).",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "Лише на пристрої, позначеному як ваш. Увійдіть знову, позначивши «Це мій власний пристрій».",
"Change your own password in {settings}.": "Власний пароль можна змінити в розділі {settings}.",
"Administration": "Адміністрування",
"Directory": "Каталог",
"User": "Користувач",
"Administrator": "Адміністратор",
"Custom role": "Власна роль",
"New account": "Новий обліковий запис",
"The people who sign in to mail on the domains you manage.": "Люди, які входять у пошту на доменах, якими ви керуєте.",
"Search by name or address": "Пошук за іменем або адресою",
"Search accounts": "Пошук облікових записів",
"No accounts match": "Немає відповідних облікових записів",
"No accounts yet": "Облікових записів ще немає",
"Nothing on your domains matches “{query}”.": "На ваших доменах немає збігів із «{query}».",
"Open {address}": "Відкрити {address}",
"{from}{to} of {total}": "{from}{to} із {total}",
"Previous page": "Попередня сторінка",
"Next page": "Наступна сторінка",
"Storage": "Сховище",
"Groups": "Групи",
"{used} · no limit": "{used} · без обмеження",
"Profile": "Профіль",
"Domain": "Домен",
"No domains are available to create an account on.": "Немає доменів, на яких можна створити обліковий запис.",
"Sign-in": "Вхід",
"Other addresses": "Інші адреси",
"Not in any group": "Не входить до жодної групи",
"You can't change your own role.": "Ви не можете змінити власну роль.",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "Пропонуються лише ролі, усі дозволи яких маєте ви самі. Для облікового запису всередині орендаря «Адміністратор» означає адміністратора цього орендаря.",
"Limit in GB": "Обмеження в ГБ",
"No limit": "Без обмеження",
"This account has permissions yours doesn't, so you can view it but not change it.": "Цей обліковий запис має дозволи, яких немає у вашого, тому його можна переглядати, але не змінювати.",
"Your role lets you view accounts but not change them.": "Ваша роль дозволяє переглядати облікові записи, але не змінювати їх.",
"This account has permissions yours doesn't.": "Цей обліковий запис має дозволи, яких немає у вашого.",
"You can't delete the account you're signed in with.": "Не можна видалити обліковий запис, під яким ви ввійшли.",
"Create account": "Створити обліковий запис",
"An account needs an address.": "Обліковому запису потрібна адреса.",
"Created {address}": "Обліковий запис {address} створено",
"Saved {address}": "Обліковий запис {address} збережено",
"Generate a password": "Згенерувати пароль",
"Pass it on some way other than email to this address.": "Передайте його будь-яким способом, окрім листа на цю адресу.",
"This account has no password. It may sign in through a directory or single sign-on.": "Цей обліковий запис не має пароля. Можливо, вхід виконується через каталог або єдиний вхід.",
"Set a new password…": "Задати новий пароль…",
"{name} will be signed out of every app and device using the old password.": "Для {name} буде виконано вихід у всіх застосунках і на всіх пристроях, де використовується старий пароль.",
"New password set for {address}": "Новий пароль для {address} задано",
"Set password": "Задати пароль",
"Remove {address}": "Видалити {address}",
"New address": "Нова адреса",
"another name": "інше ім'я",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "Листи на ці адреси доставляються в цей обліковий запис. Зміни наберуть чинності після збереження.",
"Deletes the mailbox and everything in it.": "Видаляє поштову скриньку й усе, що в ній.",
"Delete account…": "Видалити обліковий запис…",
"Delete {address}?": "Видалити {address}?",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "Буде видалено пошту, календарі, контакти й файли цього облікового запису. Сервер видалить їх у фоновому режимі, скасувати це неможливо.",
"Type {address} to confirm": "Введіть {address} для підтвердження",
"Delete account": "Видалити обліковий запис",
"Deleted {address}": "Обліковий запис {address} видалено",
"The server did not say whether the account was created.": "Сервер не повідомив, чи створено обліковий запис.",
"The mail server refused this. Your role may not allow it.": "Поштовий сервер відхилив цю дію. Можливо, ваша роль її не дозволяє.",
"That address is already in use on this server, as an account, a list or an alias.": "Ця адреса вже використовується на сервері — обліковим записом, списком або псевдонімом.",
"One of the chosen domain, role or group can't be used for this account.": "Вибраний домен, роль або групу не можна використати для цього облікового запису.",
"Your organisation has reached the number of accounts it is allowed.": "Ваша організація досягла дозволеної кількості облікових записів.",
"Something still depends on this, so the server kept it.": "Від цього ще щось залежить, тому сервер це зберіг.",
"This account no longer exists. Someone may have deleted it.": "Цього облікового запису більше немає. Можливо, його хтось видалив.",
"The password was not accepted: {reason}": "Пароль не прийнято: {reason}",
"The password was not accepted.": "Пароль не прийнято.",
"Go to folder…": "Перейти до теки…", "Go to folder…": "Перейти до теки…",
"Set for everyone here. You cannot change this.": "Задано для всіх тут. Змінити не можна.", "Set for everyone here. You cannot change this.": "Задано для всіх тут. Змінити не можна.",
"Export iCAL file": "Експортувати файл iCAL", "Export iCAL file": "Експортувати файл iCAL",
@@ -315,7 +455,6 @@ export const catalog: Catalog = {
"Busy": "Зайнятий", "Busy": "Зайнятий",
"Free/busy": "Зайнятість", "Free/busy": "Зайнятість",
"Show as": "Показувати як", "Show as": "Показувати як",
"Availability on {date}": "Зайнятість на {date}",
"Count all events as busy": "Вважати всі події зайнятістю", "Count all events as busy": "Вважати всі події зайнятістю",
"Only events I'm attending": "Лише події, де я беру участь", "Only events I'm attending": "Лише події, де я беру участь",
"Don't include in availability": "Не враховувати в зайнятості", "Don't include in availability": "Не враховувати в зайнятості",
@@ -354,7 +493,6 @@ export const catalog: Catalog = {
"New address book": "Нова адресна книга", "New address book": "Нова адресна книга",
"No address books yet.": "Адресних книг поки немає.", "No address books yet.": "Адресних книг поки немає.",
"Choose from address books": "Вибрати з адресних книг", "Choose from address books": "Вибрати з адресних книг",
"Import vCard": "Імпорт vCard",
"Export all contacts": "Експортувати всі контакти", "Export all contacts": "Експортувати всі контакти",
"Export address book": "Експортувати цю адресну книгу", "Export address book": "Експортувати цю адресну книгу",
"Import contacts…": "Імпортувати контакти…", "Import contacts…": "Імпортувати контакти…",
@@ -429,7 +567,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "Налаштуйте ihasmail під себе.", "Make ihasmail yours.": "Налаштуйте ihasmail під себе.",
"Reading": "Читання", "Reading": "Читання",
"Reading pane": "Область читання", "Reading pane": "Область читання",
"Reading, sending and list behaviour. Settings are stored in this browser.": "Поведінка під час читання, надсилання та в списку. Налаштування зберігаються в цьому браузері.",
"Right of the list": "Праворуч від списку", "Right of the list": "Праворуч від списку",
"Below the list": "Під списком", "Below the list": "Під списком",
"Hidden (open full width)": "Прихована (відкривати на всю ширину)", "Hidden (open full width)": "Прихована (відкривати на всю ширину)",
@@ -472,10 +609,6 @@ export const catalog: Catalog = {
"Time zone": "Часовий пояс", "Time zone": "Часовий пояс",
"Week starts on": "Тиждень починається з", "Week starts on": "Тиждень починається з",
"Monday": "Понеділок", "Monday": "Понеділок",
"Tuesday": "Вівторок",
"Wednesday": "Середа",
"Thursday": "Четвер",
"Friday": "П'ятниця",
"Saturday": "Субота", "Saturday": "Субота",
"Sunday": "Неділя", "Sunday": "Неділя",
"12-hour clock (6:23 PM)": "12-годинний формат (6:23 PM)", "12-hour clock (6:23 PM)": "12-годинний формат (6:23 PM)",
@@ -721,10 +854,8 @@ export const catalog: Catalog = {
"Manage labels": "Керування мітками", "Manage labels": "Керування мітками",
"Create “{name}”": "Створити «{name}»", "Create “{name}”": "Створити «{name}»",
"Type a name to create your first label.": "Введіть назву, щоб створити першу мітку.", "Type a name to create your first label.": "Введіть назву, щоб створити першу мітку.",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "Мітки — це ключові слова IMAP, які зберігаються в самих листах і синхронізуються з іншими клієнтами. Назви та кольори залишаються в цьому браузері.",
"New label": "Нова мітка", "New label": "Нова мітка",
"Delete label": "Видалити мітку", "Delete label": "Видалити мітку",
"PDF": "PDF",
"Large attachments may be rejected by some servers": "Деякі сервери відхиляють великі вкладення", "Large attachments may be rejected by some servers": "Деякі сервери відхиляють великі вкладення",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Зображення зберігаються у ваших Файлах (тека «ihasmail») і вставляються під час надсилання.", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "Зображення зберігаються у ваших Файлах (тека «ihasmail») і вставляються під час надсилання.",
"Thanks for your message. I'm away until … and will reply when I'm back.": "Дякую за лист. Мене немає до … і я відповім після повернення.", "Thanks for your message. I'm away until … and will reply when I'm back.": "Дякую за лист. Мене немає до … і я відповім після повернення.",
@@ -797,6 +928,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "Спам", "folder\u0004Junk Mail": "Спам",
"folder\u0004Important": "Важливе", "folder\u0004Important": "Важливе",
"folder\u0004All mail": "Уся пошта", "folder\u0004All mail": "Уся пошта",
"share sheet\u0004Share": "Поділитися",
"share sheet\u0004Share…": "Поділитися…",
"folder": "тека", "folder": "тека",
"“{name}” moved into “{parent}”": "«{name}» переміщено до «{parent}»", "“{name}” moved into “{parent}”": "«{name}» переміщено до «{parent}»",
"“{name}” moved to the top level": "«{name}» переміщено на верхній рівень", "“{name}” moved to the top level": "«{name}» переміщено на верхній рівень",
@@ -805,6 +938,7 @@ export const catalog: Catalog = {
"Rename folder": "Перейменувати теку", "Rename folder": "Перейменувати теку",
"Search: {query}": "Пошук: {query}", "Search: {query}": "Пошук: {query}",
"No conversation selected": "Листування не вибрано", "No conversation selected": "Листування не вибрано",
"No message selected": "Лист не вибрано",
"Drop here for the top level": "Перетягніть сюди, щоб винести на верхній рівень", "Drop here for the top level": "Перетягніть сюди, щоб винести на верхній рівень",
// ── Longer prose ─────────────────────────────────────────────────── // ── Longer prose ───────────────────────────────────────────────────
@@ -813,6 +947,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "Відкрийте розділ «Пошта», щоб побачити всі сполучення клавіш.", "Open the Mail view to see all shortcuts.": "Відкрийте розділ «Пошта», щоб побачити всі сполучення клавіш.",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Сполучення клавіш у стилі Gmail завжди увімкнено. Натисніть {key} будь-де, щоб побачити цей список.", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Сполучення клавіш у стилі Gmail завжди увімкнено. Натисніть {key} будь-де, щоб побачити цей список.",
"Select a conversation to read it here · Press {key} for shortcuts": "Виберіть листування, щоб прочитати його тут · {key} — сполучення клавіш", "Select a conversation to read it here · Press {key} for shortcuts": "Виберіть листування, щоб прочитати його тут · {key} — сполучення клавіш",
"Select a message to read it here · Press {key} for shortcuts": "Виберіть лист, щоб прочитати його тут · {key} — сполучення клавіш",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Порада: натисніть {key} на листуванні, щоб додати мітки. Шукайте через {operator}.", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "Порада: натисніть {key} на листуванні, щоб додати мітки. Шукайте через {operator}.",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "Швидка та зручна вебпошта з відкритим кодом для {server}, побудована на JMAP.", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "Швидка та зручна вебпошта з відкритим кодом для {server}, побудована на JMAP.",
"Defaults for the calendar views and new events.": "Значення за замовчуванням для виглядів календаря та нових подій.", "Defaults for the calendar views and new events.": "Значення за замовчуванням для виглядів календаря та нових подій.",
@@ -854,11 +989,12 @@ export const catalog: Catalog = {
"Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Тут показано лише мови, якими перекладено ihasmail, тому список зростає разом із перекладами, а не випереджає їх: мова без текстів змусила б сторінку стверджувати, що вона написана мовою, якою не є.", "Only languages ihasmail has been translated into appear here, so this list grows as translations land rather than ahead of them — a language offered without strings behind it would leave the page claiming to be in a language it is not.": "Тут показано лише мови, якими перекладено ihasmail, тому список зростає разом із перекладами, а не випереджає їх: мова без текстів змусила б сторінку стверджувати, що вона написана мовою, якою не є.",
"tell us about it": "повідомте нам", "tell us about it": "повідомте нам",
"This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Цей переклад зроблено ШІ й не перевірено носієм мови, тому його позначено як Beta, доки хтось його не підтвердить. Про все, що звучить неправильно, варто повідомити — {report}.", "This translation was generated by AI and has not been checked by a native speaker, so it is marked Beta until somebody who speaks it signs it off. Anything that reads wrongly is worth reporting — {report}.": "Цей переклад зроблено ШІ й не перевірено носієм мови, тому його позначено як Beta, доки хтось його не підтвердить. Про все, що звучить неправильно, варто повідомити — {report}.",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} — це палітра з {site}, з якою починає новий обліковий запис. Тема темна, тому скрізь, де це важливо, вважається темною, а акцентний колір нижче застосовується поверх неї.",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "Власна версія ihasmail — це дата коміту, з якого його зібрано, і вказівка, звідки цей коміт узявся: {example} зібрано з коміту від 30 серпня 2026 року, що надійшов через pull request 129. Коміт, який надійшов інакше, несе замість цього короткий SHA — {sha}. Версія навмисно нічого не повідомляє про Stalwart; те, що цій збірці потрібно від сервера, вказано рядком вище.", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "Власна версія ihasmail — це дата коміту, з якого його зібрано, і вказівка, звідки цей коміт узявся: {example} зібрано з коміту від 30 серпня 2026 року, що надійшов через pull request 129. Коміт, який надійшов інакше, несе замість цього короткий SHA — {sha}. Версія навмисно нічого не повідомляє про Stalwart; те, що цій збірці потрібно від сервера, вказано рядком вище.",
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "Новий лист", "New message": "Новий лист",
"New mail": "Новий лист",
"Could not do that — open ihasmail and try again": "Не вдалося — відкрийте ihasmail і повторіть спробу",
"Sending…": "Надсилання…", "Sending…": "Надсилання…",
"Saving…": "Збереження…", "Saving…": "Збереження…",
"Error": "Помилка", "Error": "Помилка",
@@ -899,6 +1035,7 @@ export const catalog: Catalog = {
"Could not copy the address": "Не вдалося скопіювати адресу", "Could not copy the address": "Не вдалося скопіювати адресу",
"Could not empty folder: {error}": "Не вдалося очистити теку: {error}", "Could not empty folder: {error}": "Не вдалося очистити теку: {error}",
"Could not load source: {error}": "Не вдалося завантажити вихідний текст: {error}", "Could not load source: {error}": "Не вдалося завантажити вихідний текст: {error}",
"Could not share: {error}": "Не вдалося поділитися: {error}",
"Could not mark as read: {error}": "Не вдалося позначити як прочитане: {error}", "Could not mark as read: {error}": "Не вдалося позначити як прочитане: {error}",
"Could not save draft: {error}": "Не вдалося зберегти чернетку: {error}", "Could not save draft: {error}": "Не вдалося зберегти чернетку: {error}",
"Could not save filter: {error}": "Не вдалося зберегти фільтр: {error}", "Could not save filter: {error}": "Не вдалося зберегти фільтр: {error}",
@@ -1347,6 +1484,15 @@ export const catalog: Catalog = {
"no address": "немає адреси", "no address": "немає адреси",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { one: "Цей домен використовує {n} обліковий запис. Спершу перенесіть або видаліть його.", few: "Цей домен використовують {n} облікові записи. Спершу перенесіть або видаліть їх.", many: "Цей домен використовують {n} облікових записів. Спершу перенесіть або видаліть їх.", other: "Цей домен використовують {n} облікового запису. Спершу перенесіть або видаліть їх." },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { one: "Сервер перестане приймати пошту для цього домену, і його {n} ключ DKIM буде видалено. Скасувати це неможливо.", few: "Сервер перестане приймати пошту для цього домену, і його {n} ключі DKIM буде видалено. Скасувати це неможливо.", many: "Сервер перестане приймати пошту для цього домену, і його {n} ключів DKIM буде видалено. Скасувати це неможливо.", other: "Сервер перестане приймати пошту для цього домену, і його {n} ключа DKIM буде видалено. Скасувати це неможливо." },
"{n} domains": { one: "{n} домен", few: "{n} домени", many: "{n} доменів", other: "{n} домену" },
"{n} mailing lists": { one: "{n} список розсилки", few: "{n} списки розсилки", many: "{n} списків розсилки", other: "{n} списку розсилки" },
"{n} DKIM keys": { one: "{n} ключ DKIM", few: "{n} ключі DKIM", many: "{n} ключів DKIM", other: "{n} ключа DKIM" },
"{n} other items": { one: "{n} інший об'єкт", few: "{n} інші об'єкти", many: "{n} інших об'єктів", other: "{n} іншого об'єкта" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { one: "{n} обліковий запис", few: "{n} облікові записи", many: "{n} облікових записів", other: "{n} облікового запису" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { one: "Видалити {n} об’єкт", few: "Видалити {n} об’єкти", many: "Видалити {n} об’єктів", other: "Видалити {n} об’єкта" }, "Delete {n} items": { one: "Видалити {n} об’єкт", few: "Видалити {n} об’єкти", many: "Видалити {n} об’єктів", other: "Видалити {n} об’єкта" },
"Delete {n} items?": { one: "Видалити {n} об’єкт?", few: "Видалити {n} об’єкти?", many: "Видалити {n} об’єктів?", other: "Видалити {n} об’єкта?" }, "Delete {n} items?": { one: "Видалити {n} об’єкт?", few: "Видалити {n} об’єкти?", many: "Видалити {n} об’єктів?", other: "Видалити {n} об’єкта?" },
@@ -1376,8 +1522,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { one: "Адміністратор змінив {n} налаштування", few: "Адміністратор змінив {n} налаштування", many: "Адміністратор змінив {n} налаштувань", other: "Адміністратор змінив {n} налаштування" }, "Your administrator changed {n} settings": { one: "Адміністратор змінив {n} налаштування", few: "Адміністратор змінив {n} налаштування", many: "Адміністратор змінив {n} налаштувань", other: "Адміністратор змінив {n} налаштування" },
"Exported {n} events": { one: "Експортовано {n} подію", few: "Експортовано {n} події", many: "Експортовано {n} подій", other: "Експортовано {n} події" }, "Exported {n} events": { one: "Експортовано {n} подію", few: "Експортовано {n} події", many: "Експортовано {n} подій", other: "Експортовано {n} події" },
"Imported {n} events": { one: "Імпортовано {n} подію", few: "Імпортовано {n} події", many: "Імпортовано {n} подій", other: "Імпортовано {n} події" }, "Imported {n} events": { one: "Імпортовано {n} подію", few: "Імпортовано {n} події", many: "Імпортовано {n} подій", other: "Імпортовано {n} події" },
"Already here: {n} events, nothing imported": { one: "Уже є: {n} подія, нічого не імпортовано", few: "Уже є: {n} події, нічого не імпортовано", many: "Уже є: {n} подій, нічого не імпортовано", other: "Уже є: {n} події, нічого не імпортовано" }, "Updated {n} events, nothing new": { one: "Оновлено {n} подію, нових немає", few: "Оновлено {n} події, нових немає", many: "Оновлено {n} подій, нових немає", other: "Оновлено {n} події, нових немає" },
"{n} were already here": { one: "{n} уже була тут", few: "{n} уже були тут", many: "{n} уже були тут", other: "{n} уже були тут" },
/* /*
* Ukrainian takes the same three forms as Russian and the same rule, but * Ukrainian takes the same three forms as Russian and the same rule, but
* not the same words. Sharing a plural structure is not sharing a * not the same words. Sharing a plural structure is not sharing a
+157 -12
View File
@@ -45,6 +45,146 @@ import type { Catalog } from "@/lib/i18n";
*/ */
export const catalog: Catalog = { export const catalog: Catalog = {
strings: { strings: {
// ── Administration: domains ────────────────────────────────────
"Domains": "域名",
"By hand": "手动",
"Signing": "签名中",
"Published, not signing yet": "已发布,尚未签名",
"Retiring": "正在停用",
"Retired": "已停用",
"This domain no longer exists. Someone may have removed it.": "该域名已不存在,可能已被他人移除。",
"That doesn't look like a domain name, such as example.com.": "这看起来不像 example.com 这样的域名。",
"Added {name}. Its DNS records are ready to copy.": "已添加 {name},其 DNS 记录可以复制了。",
"Saved {name}": "已保存 {name}",
"Add domain": "添加域名",
"Added {date}": "添加于 {date}",
"This domain is disabled on the server.": "该域名已在服务器上停用。",
"Your role lets you view domains but not change them.": "您的角色可以查看域名,但不能更改。",
"New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.": "新域名使用服务器创建并轮换的 DKIM 密钥为邮件签名。添加域名后,其 DNS 记录会显示在这里。",
"Other names": "其他名称",
"Delivery": "投递",
"Catch-all address": "全收地址",
"Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.": "发往此域名下不存在地址的邮件会投递到这里。留空则拒收此类邮件。",
"Plus addressing": "加号地址",
"Set by a custom rule on the server.": "由服务器上的自定义规则设定。",
"Mail to name+anything@ is delivered to name@.": "发往 名称+任意内容@ 的邮件会投递到 名称@。",
"DNS records": "DNS 记录",
"Published automatically through {provider}.": "通过 {provider} 自动发布。",
"Published automatically by the server.": "由服务器自动发布。",
"Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.": "请将这些记录添加到托管此域名 DNS 的地方。在此之前,邮件无法投递,也不会被信任。",
"Copy {type} record for {name}": "复制 {name} 的 {type} 记录",
"Copy value": "复制值",
"Copied the zone file": "已复制区域文件",
"Copy all as a zone file": "全部复制为区域文件",
"The server returned no records for this domain.": "服务器没有返回此域名的记录。",
"DKIM keys": "DKIM 密钥",
"The server creates and rotates these keys itself.": "服务器会自行创建并轮换这些密钥。",
"These keys are managed by hand on the server.": "这些密钥在服务器上手动管理。",
"No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.": "没有 DKIM 密钥,因此此域名的邮件不会被签名,更容易被判为垃圾邮件。",
"Managed by the server": "由服务器管理",
"Certificate": "证书",
"Another name for this domain": "此域名的其他名称",
"Mail to the same address at any of these names reaches the same account. Changes apply when you save.": "发往这些名称下相同地址的邮件会到达同一个账户。更改在保存后生效。",
"Its DKIM keys have to be removed first, and your role can't remove them.": "需要先移除其 DKIM 密钥,而您的角色无权移除。",
"The server stops accepting mail for this domain.": "服务器将不再接收此域名的邮件。",
"Remove domain…": "移除域名…",
"Remove {name}?": "移除 {name}",
"Removed {name}": "已移除 {name}",
"The server kept the domain: it is still used by {things}.": "服务器保留了该域名:它仍被 {things} 使用。",
"Remove domain": "移除域名",
"The server stops accepting mail for this domain. This can't be undone.": "服务器将不再接收此域名的邮件。此操作无法撤销。",
"Where your addresses live, and the DNS records that let mail arrive and be trusted.": "您的地址所在之处,以及让邮件送达并获得信任的 DNS 记录。",
"Search domains": "搜索域名",
"No domains match": "没有匹配的域名",
"No domains yet": "暂无域名",
"DKIM": "DKIM",
"Tenant": "租户",
"Disabled": "已停用",
"also {names}": "别名:{names}",
"The server did not say whether the domain was created.": "服务器没有说明域名是否已创建。",
// ── Administration: refusals ───────────────────────────────────
"That isn't a valid domain name. Use a name such as example.com, on a real top-level domain.": "这不是有效的域名。请使用 example.com 这样、带有真实顶级域名的名称。",
"That isn't a valid email address. Use a full address, such as [email protected].": "这不是有效的电子邮件地址。请使用完整地址,例如 [email protected]。",
"That isn't a valid address. Use letters, numbers, dots, hyphens or underscores before the @.": "这不是有效的地址。@ 前请使用字母、数字、点、连字符或下划线。",
"That isn't a valid host name or IP address.": "这不是有效的主机名或 IP 地址。",
"A required value was left empty.": "有必填值未填写。",
"Administration is turned off on this installation.": "此安装已关闭管理功能。",
"The mail server could not carry out the request ({code}).": "邮件服务器无法执行该请求({code})。",
"You can't give an account permissions your own role doesn't have.": "您不能授予账户您自己的角色所没有的权限。",
"This account signs in through an external directory, so its password can't be set here.": "该账户通过外部目录登录,因此无法在此设置其密码。",
"The server's licence allows no more accounts.": "服务器许可证不允许再添加账户。",
"That domain name is already in use on this server, as a domain or another domain's other name.": "该域名已在此服务器上被使用,可能是一个域名,也可能是另一个域名的其他名称。",
"Your organisation has reached the number of domains it is allowed.": "您的组织已达到允许的域名数量上限。",
"That is more than the mail server accepts in one change.": "这超出了邮件服务器单次更改可接受的范围。",
"The mail server rejected one of the values. Check what you entered and try again.": "邮件服务器拒绝了其中一个值。请检查您输入的内容后重试。",
"The mail server refused the change ({code}).": "邮件服务器拒绝了此更改({code})。",
// ── Administration: accounts ───────────────────────────────────
"Only on a device you've marked as your own. Sign in again with \u201cThis is my own device\u201d ticked.": "仅限在您标记为自己设备的设备上使用。请勾选「这是我自己的设备」后重新登录。",
"Change your own password in {settings}.": "请在{settings}中更改您自己的密码。",
"Administration": "管理",
"Directory": "目录",
"User": "用户",
"Administrator": "管理员",
"Custom role": "自定义角色",
"New account": "新建账户",
"The people who sign in to mail on the domains you manage.": "在您管理的域名上登录邮箱的人员。",
"Search by name or address": "按姓名或地址搜索",
"Search accounts": "搜索账户",
"No accounts match": "没有匹配的账户",
"No accounts yet": "暂无账户",
"Nothing on your domains matches “{query}”.": "您的域名中没有与「{query}」匹配的内容。",
"Open {address}": "打开 {address}",
"{from}{to} of {total}": "第 {from}{to} 个,共 {total} 个",
"Previous page": "上一页",
"Next page": "下一页",
"Storage": "存储",
"Groups": "群组",
"{used} · no limit": "{used} · 无限制",
"Profile": "资料",
"Domain": "域名",
"No domains are available to create an account on.": "没有可用于创建账户的域名。",
"Sign-in": "登录",
"Other addresses": "其他地址",
"Not in any group": "不属于任何群组",
"You can't change your own role.": "您无法更改自己的角色。",
"Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.": "仅提供您本人拥有其全部权限的角色。对于租户内的账户,管理员指的是该租户的管理员。",
"Limit in GB": "限额(GB",
"No limit": "无限制",
"This account has permissions yours doesn't, so you can view it but not change it.": "该账户拥有您的账户所没有的权限,因此您只能查看,无法更改。",
"Your role lets you view accounts but not change them.": "您的角色可以查看账户,但不能更改。",
"This account has permissions yours doesn't.": "该账户拥有您的账户所没有的权限。",
"You can't delete the account you're signed in with.": "您无法删除当前登录的账户。",
"Create account": "创建账户",
"An account needs an address.": "账户需要一个地址。",
"Created {address}": "已创建 {address}",
"Saved {address}": "已保存 {address}",
"Generate a password": "生成密码",
"Pass it on some way other than email to this address.": "请通过发往此地址的邮件以外的方式转交。",
"This account has no password. It may sign in through a directory or single sign-on.": "该账户没有密码,可能通过目录服务或单点登录进行登录。",
"Set a new password…": "设置新密码…",
"{name} will be signed out of every app and device using the old password.": "{name} 将在所有使用旧密码的应用和设备上被退出登录。",
"New password set for {address}": "已为 {address} 设置新密码",
"Set password": "设置密码",
"Remove {address}": "移除 {address}",
"New address": "新地址",
"another name": "其他名称",
"Mail to these addresses is delivered to this account. Changes apply when you save.": "发往这些地址的邮件会投递到此账户。更改在保存后生效。",
"Deletes the mailbox and everything in it.": "删除邮箱及其中的全部内容。",
"Delete account…": "删除账户…",
"Delete {address}?": "删除 {address}",
"This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.": "这将删除此账户中的邮件、日历、联系人和文件。服务器会在后台移除它们,且无法撤销。",
"Type {address} to confirm": "输入 {address} 以确认",
"Delete account": "删除账户",
"Deleted {address}": "已删除 {address}",
"The server did not say whether the account was created.": "服务器没有说明账户是否已创建。",
"The mail server refused this. Your role may not allow it.": "邮件服务器拒绝了此操作。您的角色可能不允许。",
"That address is already in use on this server, as an account, a list or an alias.": "该地址已在此服务器上被账户、列表或别名使用。",
"One of the chosen domain, role or group can't be used for this account.": "所选的域名、角色或群组无法用于此账户。",
"Your organisation has reached the number of accounts it is allowed.": "您的组织已达到允许的账户数量上限。",
"Something still depends on this, so the server kept it.": "仍有其他内容依赖于它,因此服务器保留了它。",
"This account no longer exists. Someone may have deleted it.": "该账户已不存在,可能已被他人删除。",
"The password was not accepted: {reason}": "密码未被接受:{reason}",
"The password was not accepted.": "密码未被接受。",
"Go to folder…": "转到文件夹…", "Go to folder…": "转到文件夹…",
"Set for everyone here. You cannot change this.": "已为此处所有人设定,您无法更改。", "Set for everyone here. You cannot change this.": "已为此处所有人设定,您无法更改。",
"Export iCAL file": "导出 iCAL 文件", "Export iCAL file": "导出 iCAL 文件",
@@ -317,7 +457,6 @@ export const catalog: Catalog = {
"Busy": "忙碌", "Busy": "忙碌",
"Free/busy": "忙闲状态", "Free/busy": "忙闲状态",
"Show as": "显示为", "Show as": "显示为",
"Availability on {date}": "{date} 的忙闲状态",
"Count all events as busy": "所有日程都计为忙碌", "Count all events as busy": "所有日程都计为忙碌",
"Only events I'm attending": "仅我参加的日程", "Only events I'm attending": "仅我参加的日程",
"Don't include in availability": "不计入忙闲状态", "Don't include in availability": "不计入忙闲状态",
@@ -356,7 +495,6 @@ export const catalog: Catalog = {
"New address book": "新建通讯录", "New address book": "新建通讯录",
"No address books yet.": "还没有通讯录。", "No address books yet.": "还没有通讯录。",
"Choose from address books": "从通讯录中选择", "Choose from address books": "从通讯录中选择",
"Import vCard": "导入 vCard",
"Export all contacts": "导出所有联系人", "Export all contacts": "导出所有联系人",
"Export address book": "导出此通讯录", "Export address book": "导出此通讯录",
"Import contacts…": "导入联系人…", "Import contacts…": "导入联系人…",
@@ -431,7 +569,6 @@ export const catalog: Catalog = {
"Make ihasmail yours.": "把 ihasmail 调成您喜欢的样子。", "Make ihasmail yours.": "把 ihasmail 调成您喜欢的样子。",
"Reading": "阅读", "Reading": "阅读",
"Reading pane": "阅读窗格", "Reading pane": "阅读窗格",
"Reading, sending and list behaviour. Settings are stored in this browser.": "阅读、发送和列表行为。设置保存在此浏览器中。",
"Right of the list": "列表右侧", "Right of the list": "列表右侧",
"Below the list": "列表下方", "Below the list": "列表下方",
"Hidden (open full width)": "隐藏(全宽打开)", "Hidden (open full width)": "隐藏(全宽打开)",
@@ -474,10 +611,6 @@ export const catalog: Catalog = {
"Time zone": "时区", "Time zone": "时区",
"Week starts on": "每周开始于", "Week starts on": "每周开始于",
"Monday": "星期一", "Monday": "星期一",
"Tuesday": "星期二",
"Wednesday": "星期三",
"Thursday": "星期四",
"Friday": "星期五",
"Saturday": "星期六", "Saturday": "星期六",
"Sunday": "星期日", "Sunday": "星期日",
"12-hour clock (6:23 PM)": "12 小时制 (6:23 PM)", "12-hour clock (6:23 PM)": "12 小时制 (6:23 PM)",
@@ -728,12 +861,10 @@ export const catalog: Catalog = {
"Manage labels": "管理标签", "Manage labels": "管理标签",
"Create “{name}”": "创建「{name}」", "Create “{name}”": "创建「{name}」",
"Type a name to create your first label.": "输入名称以创建您的第一个标签。", "Type a name to create your first label.": "输入名称以创建您的第一个标签。",
"Labels are IMAP keywords stored on your messages, so they sync to other clients. Names and colours are kept in this browser.": "标签是保存在邮件上的 IMAP 关键词,因此会同步到其他客户端。名称和颜色则保存在此浏览器中。",
"New label": "新建标签", "New label": "新建标签",
"Delete label": "删除标签", "Delete label": "删除标签",
// ── Attachments, dates, search prose ─────────────────────────────── // ── Attachments, dates, search prose ───────────────────────────────
"PDF": "PDF",
"Large attachments may be rejected by some servers": "部分服务器可能拒收过大的附件", "Large attachments may be rejected by some servers": "部分服务器可能拒收过大的附件",
"Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "图片保存在您的「文件」中(文件夹「ihasmail」),并在发送时嵌入邮件。", "Images are stored in your Files (folder “ihasmail”) and embedded when you send.": "图片保存在您的「文件」中(文件夹「ihasmail」),并在发送时嵌入邮件。",
"After": "晚于", "After": "晚于",
@@ -746,6 +877,7 @@ export const catalog: Catalog = {
"Open the Mail view to see all shortcuts.": "打开邮件视图以查看全部快捷键。", "Open the Mail view to see all shortcuts.": "打开邮件视图以查看全部快捷键。",
"Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Gmail 风格的快捷键始终启用。在任意位置按 {key} 即可查看此列表。", "Gmail-style shortcuts are always on. Press {key} anywhere to see this list.": "Gmail 风格的快捷键始终启用。在任意位置按 {key} 即可查看此列表。",
"Select a conversation to read it here · Press {key} for shortcuts": "选择一个会话即可在此阅读 · 按 {key} 查看快捷键", "Select a conversation to read it here · Press {key} for shortcuts": "选择一个会话即可在此阅读 · 按 {key} 查看快捷键",
"Select a message to read it here · Press {key} for shortcuts": "选择一封邮件即可在此阅读 · 按 {key} 查看快捷键",
"Tip: press {key} on a conversation to apply labels. Search with {operator}.": "提示:在会话上按 {key} 可添加标签。使用 {operator} 搜索。", "Tip: press {key} on a conversation to apply labels. Search with {operator}.": "提示:在会话上按 {key} 可添加标签。使用 {operator} 搜索。",
"A fast, friendly, open-source webmail for {server}, built on JMAP.": "一款面向 {server} 的快速、友好的开源网页邮箱,基于 JMAP 构建。", "A fast, friendly, open-source webmail for {server}, built on JMAP.": "一款面向 {server} 的快速、友好的开源网页邮箱,基于 JMAP 构建。",
@@ -807,7 +939,6 @@ export const catalog: Catalog = {
"Copy it into {name} now — it isn't shown again.": "请立即把它复制到 {name}——它不会再次显示。", "Copy it into {name} now — it isn't shown again.": "请立即把它复制到 {name}——它不会再次显示。",
"No other users found in the directory, so nobody new can be added. Sharing already in place is listed below and can still be removed.": "目录中没有找到其他用户,因此无法添加新的共享对象。已有的共享列在下方,仍可移除。", "No other users found in the directory, so nobody new can be added. Sharing already in place is listed below and can still be removed.": "目录中没有找到其他用户,因此无法添加新的共享对象。已有的共享列在下方,仍可移除。",
"Stalwart does not publish its version number to mail clients, so ihasmail reports the edition where the server gives one. ihasmail requires 0.16 or newer, and sign-in refuses anything older.": "Stalwart 不会向邮件客户端公布版本号,因此只有在服务器给出版本类型时,ihasmail 才会报告它。ihasmail 需要 0.16 或更高版本,更旧的版本一律无法登录。", "Stalwart does not publish its version number to mail clients, so ihasmail reports the edition where the server gives one. ihasmail requires 0.16 or newer, and sign-in refuses anything older.": "Stalwart 不会向邮件客户端公布版本号,因此只有在服务器给出版本类型时,ihasmail 才会报告它。ihasmail 需要 0.16 或更高版本,更旧的版本一律无法登录。",
"{name} is the palette from {site}, and what a new account starts on. It is a dark theme, so it counts as dark wherever that matters, and the accent colour below still applies on top of it.": "{name} 是 {site} 的配色,也是新账户的初始主题。它属于深色主题,因此在需要区分明暗的地方都算作深色,下方的强调色仍会叠加在它之上。",
"ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "ihasmail 自身的版本号是其构建所用提交的日期,后面跟着该提交的来源:{example} 表示由 2026 年 8 月 30 日的一个提交构建而成,而该提交来自第 129 号拉取请求。未经拉取请求的提交则改用简短 SHA 表示——{sha}。版本号刻意不包含任何关于 Stalwart 的信息;此版本对服务器的要求见上一行。", "ihasmail's own version is the date of the commit it was built from, followed by where that commit came from: {example} was built from a commit dated the 30th of August 2026 that arrived through pull request 129. A commit that did not come through one carries its short SHA instead — {sha}. The version deliberately says nothing about Stalwart; what this build needs from the server is the line above.": "ihasmail 自身的版本号是其构建所用提交的日期,后面跟着该提交的来源:{example} 表示由 2026 年 8 月 30 日的一个提交构建而成,而该提交来自第 129 号拉取请求。未经拉取请求的提交则改用简短 SHA 表示——{sha}。版本号刻意不包含任何关于 Stalwart 的信息;此版本对服务器的要求见上一行。",
// ── Constant labels ──────────────────────────────────────────────── // ── Constant labels ────────────────────────────────────────────────
@@ -842,6 +973,7 @@ export const catalog: Catalog = {
"Not spam": "不是垃圾邮件", "Not spam": "不是垃圾邮件",
"Nothing": "不执行任何操作", "Nothing": "不执行任何操作",
"No conversation selected": "未选择会话", "No conversation selected": "未选择会话",
"No message selected": "未选择邮件",
"Drop here for the top level": "拖放到此处可移至顶层", "Drop here for the top level": "拖放到此处可移至顶层",
"Later today": "今天晚些时候", "Later today": "今天晚些时候",
"Tomorrow morning": "明天上午", "Tomorrow morning": "明天上午",
@@ -860,6 +992,8 @@ export const catalog: Catalog = {
"folder\u0004Junk Mail": "垃圾邮件", "folder\u0004Junk Mail": "垃圾邮件",
"folder\u0004Important": "重要", "folder\u0004Important": "重要",
"folder\u0004All mail": "全部邮件", "folder\u0004All mail": "全部邮件",
"share sheet\u0004Share": "分享",
"share sheet\u0004Share…": "分享…",
"folder": "文件夹", "folder": "文件夹",
"“{name}” moved into “{parent}”": "「{name}」已移入「{parent}」", "“{name}” moved into “{parent}”": "「{name}」已移入「{parent}」",
"“{name}” moved to the top level": "「{name}」已移至顶层", "“{name}” moved to the top level": "「{name}」已移至顶层",
@@ -870,6 +1004,8 @@ export const catalog: Catalog = {
// ── Composer status, calendar title ──────────────────────────────── // ── Composer status, calendar title ────────────────────────────────
"New message": "新邮件", "New message": "新邮件",
"New mail": "新邮件",
"Could not do that — open ihasmail and try again": "无法执行 — 请打开 ihasmail 后重试",
"Sending…": "正在发送…", "Sending…": "正在发送…",
"Saving…": "正在保存…", "Saving…": "正在保存…",
"Error": "错误", "Error": "错误",
@@ -910,6 +1046,7 @@ export const catalog: Catalog = {
"Could not copy the address": "无法复制该地址", "Could not copy the address": "无法复制该地址",
"Could not empty folder: {error}": "无法清空文件夹:{error}", "Could not empty folder: {error}": "无法清空文件夹:{error}",
"Could not load source: {error}": "无法加载原文:{error}", "Could not load source: {error}": "无法加载原文:{error}",
"Could not share: {error}": "无法分享:{error}",
"Could not mark as read: {error}": "无法标为已读:{error}", "Could not mark as read: {error}": "无法标为已读:{error}",
"Could not save draft: {error}": "无法保存草稿:{error}", "Could not save draft: {error}": "无法保存草稿:{error}",
"Could not save filter: {error}": "无法保存过滤器:{error}", "Could not save filter: {error}": "无法保存过滤器:{error}",
@@ -1358,6 +1495,15 @@ export const catalog: Catalog = {
"no address": "无地址", "no address": "无地址",
}, },
plurals: { plurals: {
// ── Administration: domains ────────────────────────────────────
"{n} accounts use this domain. Move or delete them first.": { other: "有 {n} 个账户正在使用此域名。请先移动或删除它们。" },
"The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone.": { other: "服务器将不再接收此域名的邮件,其 {n} 个 DKIM 密钥也会被删除。此操作无法撤销。" },
"{n} domains": { other: "{n} 个域名" },
"{n} mailing lists": { other: "{n} 个邮件列表" },
"{n} DKIM keys": { other: "{n} 个 DKIM 密钥" },
"{n} other items": { other: "其他 {n} 项" },
// ── Administration ────────────────────────────────────────────────
"{n} accounts": { other: "{n} 个账户" },
// ── Third pass ───────────────────────────────────────────────────── // ── Third pass ─────────────────────────────────────────────────────
"Delete {n} items": { other: "删除 {n} 个项目" }, "Delete {n} items": { other: "删除 {n} 个项目" },
"Delete {n} items?": { other: "要删除 {n} 个项目吗?" }, "Delete {n} items?": { other: "要删除 {n} 个项目吗?" },
@@ -1387,8 +1533,7 @@ export const catalog: Catalog = {
"Your administrator changed {n} settings": { other: "管理员更改了 {n} 项设置" }, "Your administrator changed {n} settings": { other: "管理员更改了 {n} 项设置" },
"Exported {n} events": { other: "已导出 {n} 个日程" }, "Exported {n} events": { other: "已导出 {n} 个日程" },
"Imported {n} events": { other: "已导入 {n} 个日程" }, "Imported {n} events": { other: "已导入 {n} 个日程" },
"Already here: {n} events, nothing imported": { other: "已存在 {n} 个,未导入" }, "Updated {n} events, nothing new": { other: "已更新 {n} 个日程,无新增" },
"{n} were already here": { other: "{n} 个已存在" },
/* /*
* One form each, because Chinese has one. Intl.PluralRules returns `other` * One form each, because Chinese has one. Intl.PluralRules returns `other`
* for every number, so `one`, `few` and `many` would never be selected * for every number, so `one`, `few` and `many` would never be selected
@@ -0,0 +1,94 @@
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { useCompose } from "@/store/compose";
import { useMail } from "@/store/mail";
import { client } from "@/jmap/client";
import type { SharedContent } from "@/lib/shareTarget";
/**
* What a share becomes once it reaches the composer.
*
* The signature is the part worth a test. `open()` only fits one when it is
* given no body at all, so the obvious implementation -- pass the shared text
* straight to `open()` -- silently drops the signature from every message that
* started as a share, and nothing about the draft looks wrong.
*/
const IDENTITY = {
id: "i1",
name: "John",
email: "[email protected]",
replyTo: null,
htmlSignature: "<p>-- <br>John</p>",
textSignature: "-- \nJohn",
};
function share(over: Partial<SharedContent> = {}): SharedContent {
return { title: "", text: "", url: "", files: [], ...over };
}
beforeEach(() => {
useCompose.setState({ drafts: [], activeKey: null, pendingSends: {} });
useMail.setState({ accountId: "a1", identities: [IDENTITY] as never });
// addFiles uploads as it goes; nothing here is testing the upload, and a
// real one would reach for the network.
vi.spyOn(client, "upload").mockResolvedValue({ blobId: "b1", type: "image/png", size: 6 } as never);
});
// Without this the spy installed above is the same one every test, so its call
// count is cumulative and "uploaded twice" quietly means "twice, plus whatever
// the test before it uploaded".
afterEach(() => {
vi.restoreAllMocks();
});
const draftFor = (key: string) => useCompose.getState().drafts.find((d) => d.key === key)!;
describe("opening a share as a draft", () => {
it("makes the shared title the subject and addresses nothing", () => {
// A share says what to send, never who to. Anything else would be putting
// a recipient in a field the sharer never filled in.
const d = draftFor(useCompose.getState().openFromShare(share({ title: "Holiday plans" })));
expect(d.subject).toBe("Holiday plans");
expect(d.to).toEqual([]);
expect(d.cc).toEqual([]);
});
it("puts the shared text above the signature, not instead of it", () => {
const d = draftFor(useCompose.getState().openFromShare(share({ text: "Look at this" })));
expect(d.text).toContain("Look at this");
expect(d.text).toContain("John");
expect(d.html).toContain("Look at this");
expect(d.html).toContain("-- ");
// Above, not below: the reply goes where the caret lands.
expect(d.html.indexOf("Look at this")).toBeLessThan(d.html.indexOf("-- "));
});
it("carries a shared link into the body", () => {
const d = draftFor(useCompose.getState().openFromShare(share({ text: "worth reading", url: "https://example.com/a" })));
expect(d.text).toContain("https://example.com/a");
});
it("keeps the signature when a share carried nothing but files", () => {
const key = useCompose.getState().openFromShare(share({ files: [new File(["pixels"], "beach.png", { type: "image/png" })] }));
const d = draftFor(key);
expect(d.html).toContain("John");
expect(d.attachments.map((a) => [a.name, a.type])).toEqual([["beach.png", "image/png"]]);
});
it("attaches every shared file, and starts each one uploading", () => {
const files = [
new File(["a"], "one.png", { type: "image/png" }),
new File(["b"], "two.pdf", { type: "application/pdf" }),
];
const d = draftFor(useCompose.getState().openFromShare(share({ title: "Two things", files })));
expect(d.attachments).toHaveLength(2);
expect(d.attachments.every((a) => a.error === null)).toBe(true);
expect(client.upload).toHaveBeenCalledTimes(2);
});
it("opens a plain draft for a share that carried only a subject", () => {
const d = draftFor(useCompose.getState().openFromShare(share({ title: "Just this" })));
expect(d.subject).toBe("Just this");
expect(d.attachments).toEqual([]);
});
});
+99 -20
View File
@@ -28,17 +28,18 @@ const PARSED = [
}, },
]; ];
interface SetArgs { create?: Record<string, Record<string, unknown>>; sendSchedulingMessages?: boolean } interface SetArgs { create?: Record<string, Record<string, unknown>>; update?: Record<string, Record<string, unknown>>; sendSchedulingMessages?: boolean }
/** /**
* @param parsed what `CalendarEvent/parse` answers with; a bare object rather * @param parsed what `CalendarEvent/parse` answers with; a bare object rather
* than an array is the single-event shape, which Stalwart also returns. * than an array is the single-event shape, which Stalwart also returns.
* @param notCreated refusals to hand back instead of creations. * @param notCreated refusals to hand back instead of creations.
* @param notUpdated refusals to hand back instead of updates.
* @param max the ceiling on objects in one call, refused the way Stalwart * @param max the ceiling on objects in one call, refused the way Stalwart
* refuses it: the whole call, creating nothing. * refuses it: the whole call, creating nothing.
* @param failOn which `/set` call (0-based) answers with an error instead. * @param failOn which `/set` call (0-based) answers with an error instead.
*/ */
function server(parsed: unknown, opts: { notCreated?: Record<string, unknown>; max?: number; failOn?: number; existing?: Array<{ id: string; uid: string; calendarIds: Record<string, boolean> }> } = {}) { function server(parsed: unknown, opts: { notCreated?: Record<string, unknown>; notUpdated?: Record<string, unknown>; max?: number; failOn?: number; existing?: Array<{ id: string; uid: string; calendarIds: Record<string, boolean> }> } = {}) {
const sets: SetArgs[] = []; const sets: SetArgs[] = [];
const existing = opts.existing ?? []; const existing = opts.existing ?? [];
const fetchMock = vi.fn(async (_url: string, init: RequestInit) => { const fetchMock = vi.fn(async (_url: string, init: RequestInit) => {
@@ -50,18 +51,28 @@ function server(parsed: unknown, opts: { notCreated?: Record<string, unknown>; m
} }
if (name === "CalendarEvent/set") { if (name === "CalendarEvent/set") {
const nth = sets.length; const nth = sets.length;
sets.push({ create: args.create as Record<string, Record<string, unknown>>, sendSchedulingMessages: args.sendSchedulingMessages as boolean }); sets.push({
create: args.create as Record<string, Record<string, unknown>>,
update: args.update as Record<string, Record<string, unknown>>,
sendSchedulingMessages: args.sendSchedulingMessages as boolean,
});
const keys = Object.keys((args.create ?? {}) as object); const keys = Object.keys((args.create ?? {}) as object);
// Whole-call refusals, both of them: nothing in this call is created. const patched = Object.keys((args.update ?? {}) as object);
if (opts.max != null && keys.length > opts.max) { /* Whole-call refusals, both of them: nothing in this call gets written.
Creates and updates count against the ceiling together, which is why
the store batches them together. */
if (opts.max != null && keys.length + patched.length > opts.max) {
return ["error", { type: "requestTooLarge", description: "The number of ids requested by the client exceeds the maximum number the server is willing to process in a single method call." }, id]; return ["error", { type: "requestTooLarge", description: "The number of ids requested by the client exceeds the maximum number the server is willing to process in a single method call." }, id];
} }
if (opts.failOn === nth) return ["error", { type: "serverFail", description: "the roof fell in" }, id]; if (opts.failOn === nth) return ["error", { type: "serverFail", description: "the roof fell in" }, id];
const notCreated = opts.notCreated ?? {}; const notCreated = opts.notCreated ?? {};
const notUpdated = opts.notUpdated ?? {};
return [name, { return [name, {
accountId: "a1", oldState: "1", newState: "2", accountId: "a1", oldState: "1", newState: "2",
created: Object.fromEntries(keys.filter((k) => !(k in notCreated)).map((k) => [k, { id: `new-${k}` }])), created: Object.fromEntries(keys.filter((k) => !(k in notCreated)).map((k) => [k, { id: `new-${k}` }])),
notCreated, notCreated,
updated: Object.fromEntries(patched.filter((k) => !(k in notUpdated)).map((k) => [k, null])),
notUpdated,
}, id]; }, id];
} }
// The scan for UIDs already in the calendar: a query for the account's // The scan for UIDs already in the calendar: a query for the account's
@@ -122,7 +133,7 @@ describe("importing an .ics file", () => {
it("creates every event in one call when the file fits in one, not one call each", async () => { it("creates every event in one call when the file fits in one, not one call each", async () => {
const sets = server(PARSED); const sets = server(PARSED);
const n = await useCalendar.getState().importIcs("x", "cal1"); const n = await useCalendar.getState().importIcs("x", "cal1");
expect(n).toEqual({ created: 2, skipped: 0 }); expect(n).toEqual({ created: 2, updated: 0 });
expect(sets).toHaveLength(1); expect(sets).toHaveLength(1);
expect(Object.keys(sets[0]!.create!)).toEqual(["e0", "e1"]); expect(Object.keys(sets[0]!.create!)).toEqual(["e0", "e1"]);
}); });
@@ -163,7 +174,7 @@ describe("importing an .ics file", () => {
it("takes a single event, which is what a one-event file parses to", async () => { it("takes a single event, which is what a one-event file parses to", async () => {
const sets = server(PARSED[0]); const sets = server(PARSED[0]);
const n = await useCalendar.getState().importIcs("x", "cal1"); const n = await useCalendar.getState().importIcs("x", "cal1");
expect(n).toEqual({ created: 1, skipped: 0 }); expect(n).toEqual({ created: 1, updated: 0 });
expect(Object.keys(sets[0]!.create!)).toEqual(["e0"]); expect(Object.keys(sets[0]!.create!)).toEqual(["e0"]);
}); });
@@ -179,7 +190,7 @@ describe("importing an .ics file", () => {
it("counts what got in when only some of it did", async () => { it("counts what got in when only some of it did", async () => {
server(PARSED, { notCreated: { e1: { type: "invalidProperties" } } }); server(PARSED, { notCreated: { e1: { type: "invalidProperties" } } });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 1, skipped: 0 }); await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 1, updated: 0 });
}); });
}); });
@@ -202,14 +213,14 @@ describe("importing a file bigger than the server will take at once", () => {
it("splits it into calls the server will accept, and files all of it", async () => { it("splits it into calls the server will accept, and files all of it", async () => {
const sets = server(many(1200), { max: MAX }); const sets = server(many(1200), { max: MAX });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 1200, skipped: 0 }); await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 1200, updated: 0 });
expect(sets.map((s) => Object.keys(s.create!).length)).toEqual([500, 500, 200]); expect(sets.map((s) => Object.keys(s.create!).length)).toEqual([500, 500, 200]);
}); });
it("splits by what the session advertises, not by a number of its own", async () => { it("splits by what the session advertises, not by a number of its own", async () => {
client.session!.capabilities[CAP.core] = { maxObjectsInGet: 40, maxObjectsInSet: 40 }; client.session!.capabilities[CAP.core] = { maxObjectsInGet: 40, maxObjectsInSet: 40 };
const sets = server(many(100), { max: 40 }); const sets = server(many(100), { max: 40 });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 100, skipped: 0 }); await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 100, updated: 0 });
expect(sets.map((s) => Object.keys(s.create!).length)).toEqual([40, 40, 20]); expect(sets.map((s) => Object.keys(s.create!).length)).toEqual([40, 40, 20]);
}); });
@@ -256,23 +267,59 @@ describe("importing a file bigger than the server will take at once", () => {
* whole of what is needed to recognise an event that is already here -- and * whole of what is needed to recognise an event that is already here -- and
* nothing looked. Importing an export twice left second copies of everything, * nothing looked. Importing an export twice left second copies of everything,
* which the reporter's colleague hit during testing (#173, decided there: * which the reporter's colleague hit during testing (#173, decided there:
* "duplicate checks on UIDs if UID present in event"). Issue #222. * "duplicate checks on UIDs if UID present in event"). Issue #222 made that a
* skip; #279 made it an update, because the reason to import a file a second
* time is usually that the first one was not right.
*/ */
describe("re-importing events the calendar already has", () => { describe("re-importing events the calendar already has", () => {
const here = (uid: string, calendarId = "cal1") => ({ id: `srv-${uid}`, uid, calendarIds: { [calendarId]: true } }); const here = (uid: string, calendarId = "cal1") => ({ id: `srv-${uid}`, uid, calendarIds: { [calendarId]: true } });
it("skips an event whose uid is already in this calendar", async () => { it("updates an event whose uid is already in this calendar", async () => {
const sets = server(PARSED, { existing: [here("[email protected]")] }); const sets = server(PARSED, { existing: [here("[email protected]")] });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 1, skipped: 1 }); await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 1, updated: 1 });
// Only the second event, which has no uid of its own, was sent. // Only the second event, which has no uid of its own, is new.
expect(Object.values(sets[0]!.create!).map((e) => e.title)).toEqual(["Retro (no uid)"]); expect(Object.values(sets[0]!.create!).map((e) => e.title)).toEqual(["Retro (no uid)"]);
// The update is addressed to the event that is here, not to the file's id.
expect(Object.keys(sets[0]!.update!)).toEqual(["[email protected]"]);
expect(sets[0]!.update!["[email protected]"]!.title).toBe("Kickoff");
});
it("holds back the answers and the per-occurrence edits, which live on the event", async () => {
/*
* The one thing #279 turned on. `participants` carries who accepted and
* `recurrenceOverrides` carries every "just this Wednesday" change made
* here; a file describes both as they were at export, so writing either one
* over throws away work with no error anywhere. Everything else in the file
* wins, which is the point of importing it again.
*/
const withPeople = [{
...PARSED[0],
title: "Kickoff (moved)",
participants: { "[email protected]": { "@type": "Participant", participationStatus: "needs-action" } },
recurrenceOverrides: { "2026-09-09T09:00:00": { title: "Skip" } },
}];
const sets = server(withPeople, { existing: [here("[email protected]")] });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 0, updated: 1 });
const patch = sets[0]!.update!["[email protected]"]!;
expect(patch.title).toBe("Kickoff (moved)");
expect(patch).not.toHaveProperty("participants");
expect(patch).not.toHaveProperty("recurrenceOverrides");
// The identity the two were matched on is not re-asserted as a field.
expect(patch).not.toHaveProperty("uid");
});
it("does not mail anyone about an event it updated", async () => {
// Filing a file is not scheduling, on an update as much as on a create.
const sets = server(PARSED, { existing: [here("[email protected]")] });
await useCalendar.getState().importIcs("x", "cal1");
expect(sets[0]!.sendSchedulingMessages).toBe(false);
}); });
it("imports an event whose uid is in a different calendar", async () => { it("imports an event whose uid is in a different calendar", async () => {
// A UID is what makes an event the same event *across* calendars, so the // A UID is what makes an event the same event *across* calendars, so the
// same event legitimately being in two of them is not a duplicate. // same event legitimately being in two of them is not a duplicate.
const sets = server(PARSED, { existing: [here("[email protected]", "cal2")] }); const sets = server(PARSED, { existing: [here("[email protected]", "cal2")] });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 2, skipped: 0 }); await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 2, updated: 0 });
expect(Object.keys(sets[0]!.create!)).toHaveLength(2); expect(Object.keys(sets[0]!.create!)).toHaveLength(2);
}); });
@@ -282,12 +329,44 @@ describe("re-importing events the calendar already has", () => {
expect(Object.values(sets[0]!.create!)[0]!.uid).toEqual(expect.any(String)); expect(Object.values(sets[0]!.create!)[0]!.uid).toEqual(expect.any(String));
}); });
it("sends nothing at all when the whole file is already here", async () => { it("updates the lot when the whole file is already here, creating nothing", async () => {
// A file whose every event carries a uid the calendar holds: there is
// nothing to create, and nothing wrong either.
const both = [PARSED[0], { ...PARSED[1], uid: "[email protected]" }]; const both = [PARSED[0], { ...PARSED[1], uid: "[email protected]" }];
const sets = server(both, { existing: [here("[email protected]"), here("[email protected]")] }); const sets = server(both, { existing: [here("[email protected]"), here("[email protected]")] });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 0, skipped: 2 }); await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 0, updated: 2 });
expect(sets).toHaveLength(0); expect(sets).toHaveLength(1);
expect(Object.keys(sets[0]!.create!)).toHaveLength(0);
expect(Object.keys(sets[0]!.update!)).toHaveLength(2);
});
it("reports a refusal to update, rather than reporting nothing imported", async () => {
// Everything in the file is already here, so an update is the whole of the
// import -- and a refusal of it is the only thing there is to say.
const both = [PARSED[0], { ...PARSED[1], uid: "[email protected]" }];
server(both, {
existing: [here("[email protected]"), here("[email protected]")],
notUpdated: {
"[email protected]": { type: "forbidden", description: "the calendar is read-only" },
"[email protected]": { type: "forbidden" },
},
});
await expect(useCalendar.getState().importIcs("x", "cal1")).rejects.toThrow(/read-only/);
});
it("splits creates and updates against one ceiling, not one each", async () => {
/*
* Stalwart counts every object in a `/set` against `maxObjectsInSet`
* together and refuses the whole call over it. 300 new and 300 changed
* batched separately would be two calls of 300 -- neither over 500, both
* refused.
*/
const MAX = 500;
const file = Array.from({ length: 600 }, (_, i) => ({
"@type": "Event", uid: `uid-${i}@example.org`, title: `Event ${i}`,
start: "2026-09-02T09:00:00", duration: "PT1H", timeZone: "Etc/UTC",
}));
const existing = Array.from({ length: 300 }, (_, i) => here(`uid-${i}@example.org`));
const sets = server(file, { max: MAX, existing });
await expect(useCalendar.getState().importIcs("x", "cal1")).resolves.toEqual({ created: 300, updated: 300 });
expect(sets.map((s) => Object.keys(s.create ?? {}).length + Object.keys(s.update ?? {}).length)).toEqual([500, 100]);
}); });
}); });
+83 -26
View File
@@ -296,8 +296,8 @@ interface CalendarState {
findByUid(uid: string): Promise<CalendarEvent | null>; findByUid(uid: string): Promise<CalendarEvent | null>;
parseIcs(blobId: Id): Promise<CalendarEvent[]>; parseIcs(blobId: Id): Promise<CalendarEvent[]>;
importEvent(event: Partial<CalendarEvent>, calendarId: Id): Promise<Id>; importEvent(event: Partial<CalendarEvent>, calendarId: Id): Promise<Id>;
/** Import a whole .ics file. Says how many it created, and how many were already here. */ /** Import a whole .ics file. Says how many it created and how many it updated. */
importIcs(text: string, calendarId: Id): Promise<{ created: number; skipped: number }>; importIcs(text: string, calendarId: Id): Promise<{ created: number; updated: number }>;
/** The whole calendar as one .ics document, and how many events went into it. */ /** The whole calendar as one .ics document, and how many events went into it. */
exportIcs(calendarId: Id): Promise<{ text: string; count: number }>; exportIcs(calendarId: Id): Promise<{ text: string; count: number }>;
applyChanges(types: Set<string>): void; applyChanges(types: Set<string>): void;
@@ -333,7 +333,7 @@ function forImport(event: Partial<CalendarEvent>): Partial<CalendarEvent> {
} }
/** /**
* The UIDs a calendar already holds. * The events a calendar already holds, for recognising a re-import.
* *
* A UID is what makes an event the same event across calendars, and the import * A UID is what makes an event the same event across calendars, and the import
* already keeps the file's own wherever there is one -- so the thing needed to * already keeps the file's own wherever there is one -- so the thing needed to
@@ -367,10 +367,21 @@ async function eventsInCalendar(accountId: Id, calendarId: Id, properties: strin
return found; return found;
} }
/** Just the UIDs, for deciding what a re-import would duplicate. */ /**
async function uidsInCalendar(accountId: Id, calendarId: Id): Promise<Set<string>> { * uid -> the id of the event carrying it, for deciding what a re-import updates.
*
* The id and not just the UID, because an event already here is now updated
* rather than skipped and updating needs something to address -- the same
* arrangement, and for the same reason, as contacts' `scanBook`. A UID the
* calendar somehow holds twice keeps the first: two events with one UID is
* already a state nothing here can make sense of, and addressing one of them
* is better than writing the file over both.
*/
async function eventIdsByUid(accountId: Id, calendarId: Id): Promise<Map<string, Id>> {
const events = await eventsInCalendar(accountId, calendarId, ["uid", "calendarIds"]); const events = await eventsInCalendar(accountId, calendarId, ["uid", "calendarIds"]);
return new Set(events.map((e) => e.uid).filter(Boolean)); const byUid = new Map<string, Id>();
for (const e of events) if (e.uid && !byUid.has(e.uid)) byUid.set(e.uid, e.id);
return byUid;
} }
export const useCalendar = create<CalendarState>((set, get) => ({ export const useCalendar = create<CalendarState>((set, get) => ({
@@ -862,17 +873,24 @@ export const useCalendar = create<CalendarState>((set, get) => ({
* year of events one at a time would refetch the calendar a few hundred * year of events one at a time would refetch the calendar a few hundred
* times. One invalidate here, after the last batch. * times. One invalidate here, after the last batch.
* *
* No scheduling messages. Importing a file is filing something you already * No scheduling messages, on a create or an update. Importing a file is
* have, and mailing its participants would be a surprise to everyone. * filing something you already have, and mailing its participants would be a
* surprise to everyone. That is plainly right for a create and it is a real
* cost on an update -- moving an event without telling anyone leaves every
* attendee's own copy saying the old time, with nothing anywhere reporting
* the disagreement. Weighed on #279 and kept: an import is not the place to
* start sending mail on somebody's behalf, and the alternative is a file
* dropped into a calendar mailing a room full of people who never asked for
* it. Whoever is organising can send the update from the event itself.
*/ */
async importIcs(text, calendarId) { async importIcs(text, calendarId) {
const accountId = get().accountId!; const accountId = get().accountId!;
const up = await client.upload(accountId, new Blob([text], { type: "text/calendar" }), { type: "text/calendar" }); const up = await client.upload(accountId, new Blob([text], { type: "text/calendar" }), { type: "text/calendar" });
const events = await get().parseIcs(up.blobId); const events = await get().parseIcs(up.blobId);
if (!events.length) throw new Error("it has no events in it"); if (!events.length) throw new Error("it has no events in it");
const already = await uidsInCalendar(accountId, calendarId); const already = await eventIdsByUid(accountId, calendarId);
const create: Record<string, unknown> = {}; const create: Record<string, unknown> = {};
let skipped = 0; const update: Record<Id, unknown> = {};
events.forEach((e, i) => { events.forEach((e, i) => {
const rest = forImport(e); const rest = forImport(e);
/* /*
@@ -883,39 +901,78 @@ export const useCalendar = create<CalendarState>((set, get) => ({
* about. Re-importing an export used to leave second copies of * about. Re-importing an export used to leave second copies of
* everything; asked for on #173, decided there. * everything; asked for on #173, decided there.
*/ */
if (rest.uid && already.has(rest.uid)) { const existing = rest.uid ? already.get(rest.uid) : undefined;
skipped++; if (existing) {
/*
* An event this calendar already holds is updated from the file, the
* way a re-imported contact is (#242, #274): the reason to import a
* file a second time is usually that the first one was not right, and
* skipping meant a corrected export corrected nothing.
*
* Two properties are held back, decided on #279. `participants` carries
* every attendee's accepted/declined and `recurrenceOverrides` holds
* every "just this Wednesday" edit made here -- both are answers and
* decisions that happened after the file was written, and a file that
* mentions them at all describes them as they were at export. Writing
* either one over would destroy work nobody asked to lose, silently,
* with no error returned anywhere. So a corrected export fixes the
* time, the title and the location and leaves who said yes alone.
*
* The cost runs the other way: an attendee added at the source since
* the last import does not arrive, and nothing here can tell that apart
* from an RSVP given in ihasmail. Losing an answer somebody gave is
* worse than not gaining an attendee somebody can still be told about.
*
* `uid` is held back too -- it is what the two were matched on, so it
* is already equal, and it is the event's identity rather than a field
* of it worth re-asserting.
*/
const { uid: _u, participants: _p, recurrenceOverrides: _r, ...patch } = rest;
update[existing] = patch;
return; return;
} }
create[`e${i}`] = { "@type": "Event", ...rest, uid: rest.uid || crypto.randomUUID(), calendarIds: { [calendarId]: true } }; create[`e${i}`] = { "@type": "Event", ...rest, uid: rest.uid || crypto.randomUUID(), calendarIds: { [calendarId]: true } };
}); });
// Everything in the file was already here. Nothing to send, and nothing /*
// wrong either -- say so rather than reporting an import of no events. * Creates and updates share one budget. Stalwart counts every object in a
if (!Object.keys(create).length) return { created: 0, skipped }; * `/set` against `maxObjectsInSet` together, so batching the two separately
const keys = Object.keys(create); * would send a file of 300 new events and 300 changed ones as two calls of
* 300 and be refused for a ceiling of 500 that neither half crosses.
* Contacts' `writeCards` splits the same way for the same reason.
*/
const keys = [
...Object.keys(create).map((k) => ["create", k] as const),
...Object.keys(update).map((k) => ["update", k] as const),
];
let created = 0; let created = 0;
let updated = 0;
let refused: SetError | undefined; let refused: SetError | undefined;
try { try {
for (const part of chunk(keys, client.maxObjectsInSet)) { for (const part of chunk(keys, client.maxObjectsInSet)) {
const sub: Record<string, unknown> = {}; const subCreate: Record<string, unknown> = {};
for (const k of part) sub[k] = create[k]; const subUpdate: Record<string, unknown> = {};
const res = await client.call<SetResponse<CalendarEvent>>("CalendarEvent/set", { accountId, create: sub, sendSchedulingMessages: false }); for (const [kind, k] of part) {
if (kind === "create") subCreate[k] = create[k];
else subUpdate[k] = update[k];
}
const res = await client.call<SetResponse<CalendarEvent>>("CalendarEvent/set", { accountId, create: subCreate, update: subUpdate, sendSchedulingMessages: false });
created += Object.keys(res.created ?? {}).length; created += Object.keys(res.created ?? {}).length;
refused ??= Object.values(res.notCreated ?? {})[0]; updated += Object.keys(res.updated ?? {}).length;
refused ??= Object.values(res.notCreated ?? {})[0] ?? Object.values(res.notUpdated ?? {})[0];
} }
} catch (err) { } catch (err) {
// A batch that failed with earlier ones already filed: those events are // A batch that failed with earlier ones already written: those events are
// in the calendar, and an error saying only that the import failed sends // in the calendar, and an error saying only that the import failed sends
// someone looking for events that are already there. // someone looking for events that are already there.
if (!created) throw err; if (!created && !updated) throw err;
throw new Error(`${created} of ${keys.length} events were imported before this happened: ${(err as Error).message}`); throw new Error(`${created + updated} of ${keys.length} events were imported before this happened: ${(err as Error).message}`);
} finally { } finally {
if (created) get().invalidate(); if (created || updated) get().invalidate();
} }
// Nothing at all got in: say why rather than report importing zero events // Nothing at all got in: say why rather than report importing zero events
// as though the file had been empty. // as though the file had been empty.
if (!created) throw new Error(refused ? setErrorMessage(refused) : "the server did not accept any of its events"); if (!created && !updated) throw new Error(refused ? setErrorMessage(refused) : "the server did not accept any of its events");
return { created, skipped }; return { created, updated };
}, },
/* /*
+26
View File
@@ -14,6 +14,7 @@ import { BASE_PATH } from "@/lib/basePath";
import { settings } from "./settings"; import { settings } from "./settings";
import { emlFilename } from "@/lib/emlName"; import { emlFilename } from "@/lib/emlName";
import { fillPlaceholders, type PlaceholderContext } from "@/lib/templatePlaceholders"; import { fillPlaceholders, type PlaceholderContext } from "@/lib/templatePlaceholders";
import { shareBody, type SharedContent } from "@/lib/shareTarget";
export interface ComposeAttachment { export interface ComposeAttachment {
id: string; id: string;
@@ -83,6 +84,8 @@ interface ComposeState {
activeKey: string | null; activeKey: string | null;
pendingSends: Record<string, { timer: number; toastId: number; draft: Draft }>; pendingSends: Record<string, { timer: number; toastId: number; draft: Draft }>;
open(init?: Partial<Draft>): string; open(init?: Partial<Draft>): string;
/** Open a draft holding what the operating system's share sheet sent us. */
openFromShare(share: SharedContent): string;
openDraftEmail(email: Email): Promise<string>; openDraftEmail(email: Email): Promise<string>;
/** Open a message again as a mail that has not been sent yet. */ /** Open a message again as a mail that has not been sent yet. */
composeAsNew(email: Email): Promise<string>; composeAsNew(email: Email): Promise<string>;
@@ -182,6 +185,29 @@ export const useCompose = create<ComposeState>((set, get) => ({
return d.key; return d.key;
}, },
/*
* A share from the operating system, as a message being written.
*
* The subject and body are filled in but nothing is addressed and nothing is
* sent: a share says what to send, never who to. What arrives is somebody
* part-way through a thought, and the composer is where the rest of it goes.
*
* Opened empty first and the body pushed in above afterwards, rather than
* passed to `open()`. `open()` only fits a signature when it is given no
* body at all, so handing it the shared text would quietly drop the
* signature from every message that started as a share.
*/
openFromShare(share) {
const body = shareBody(share);
const key = get().open({ subject: share.title.trim() });
if (body) {
const d = get().drafts.find((x) => x.key === key);
if (d) get().update(key, { html: `<div>${textToHtml(body)}</div>${d.html}`, text: `${body}\n${d.text}` });
}
if (share.files.length) get().addFiles(key, share.files);
return key;
},
async openDraftEmail(email) { async openDraftEmail(email) {
const existing = get().drafts.find((d) => d.draftId === email.id); const existing = get().drafts.find((d) => d.draftId === email.id);
if (existing) { if (existing) {
+77 -1
View File
@@ -1547,7 +1547,13 @@ a.menu-item:hover { color: var(--fg); }
.composer-dock { position: fixed; right: 16px; bottom: 0; display: flex; align-items: flex-end; gap: 12px; z-index: 955; pointer-events: none; } .composer-dock { position: fixed; right: 16px; bottom: 0; display: flex; align-items: flex-end; gap: 12px; z-index: 955; pointer-events: none; }
.composer { pointer-events: auto; width: 580px; max-width: calc(100vw - 32px); height: 600px; max-height: calc(100vh - 24px); display: flex; flex-direction: column; background: var(--bg-elev); border-radius: var(--radius-lg) var(--radius-lg) 0 0; box-shadow: var(--shadow-3); border: 1px solid var(--border); border-bottom: 0; overflow: hidden; animation: rise .2s var(--ease); } .composer { pointer-events: auto; width: 580px; max-width: calc(100vw - 32px); height: 600px; max-height: calc(100vh - 24px); display: flex; flex-direction: column; background: var(--bg-elev); border-radius: var(--radius-lg) var(--radius-lg) 0 0; box-shadow: var(--shadow-3); border: 1px solid var(--border); border-bottom: 0; overflow: hidden; animation: rise .2s var(--ease); }
.composer.minimized { height: 44px; width: 280px; } .composer.minimized { height: 44px; width: 280px; }
.composer.maximized { position: fixed; inset: 24px; width: auto; height: auto; max-width: none; max-height: none; border-radius: var(--radius-lg); border-bottom: 1px solid var(--border); } /* Full screen is still a child of the dock, so without a layer of its own the
positioned parts of any composer after it in the DOM (its recipients row,
its editor) would paint straight over it. The others are hidden while one
is full screen: they cannot be reached anyway, and the strip left under the
24px inset would otherwise show their footers. */
.composer.maximized { position: fixed; inset: 24px; z-index: 1; width: auto; height: auto; max-width: none; max-height: none; border-radius: var(--radius-lg); border-bottom: 1px solid var(--border); }
.composer-dock.has-maximized > .composer:not(.maximized) { display: none; }
.composer-head { display: flex; align-items: center; gap: 4px; height: 44px; padding: 0 6px 0 14px; background: var(--bg-sunken); border-bottom: 1px solid var(--border); flex: 0 0 auto; cursor: default; } .composer-head { display: flex; align-items: center; gap: 4px; height: 44px; padding: 0 6px 0 14px; background: var(--bg-sunken); border-bottom: 1px solid var(--border); flex: 0 0 auto; cursor: default; }
.composer-head .title { flex: 1; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; } .composer-head .title { flex: 1; font-weight: 600; white-space: nowrap; overflow: hidden; text-overflow: ellipsis; }
.composer-head .status { color: var(--fg-faint); font-size: .8em; margin-right: 6px; white-space: nowrap; } .composer-head .status { color: var(--fg-faint); font-size: .8em; margin-right: 6px; white-space: nowrap; }
@@ -1667,6 +1673,74 @@ select optgroup { background-color: var(--bg-elev); color: var(--fg); }
.sessions-table th, .sessions-table td { text-align: left; padding: 8px 10px; border-bottom: 1px solid var(--border); } .sessions-table th, .sessions-table td { text-align: left; padding: 8px 10px; border-bottom: 1px solid var(--border); }
.sessions-table th { color: var(--fg-muted); font-weight: 600; font-size: .85em; } .sessions-table th { color: var(--fg-muted); font-weight: 600; font-size: .85em; }
/* ==========================================================================
Administration
Settings' layout, with a table for the list and a panel beside it for the
one that is open. The panel is positioned against the layout rather than the
scrolling content, so it stays put while the list scrolls under it.
========================================================================== */
/* One column: the section list is in the folder pane (AdminNav), so the
table gets the width a second column would take. The height and scrolling
are what .settings-layout gave it. */
.admin-layout { position: relative; height: 100%; min-height: 0; flex: 1; display: flex; flex-direction: column; }
.admin-content { max-width: 1120px; flex: 1; min-height: 0; }
.admin-head { display: flex; align-items: flex-start; gap: 16px; flex-wrap: wrap; }
.admin-head .grow { min-width: 220px; }
.admin-toolbar { display: flex; gap: 8px; align-items: center; margin-bottom: 12px; }
.admin-search { position: relative; flex: 1; max-width: 360px; }
.admin-search svg { position: absolute; left: 10px; top: 50%; transform: translateY(-50%); color: var(--fg-faint); pointer-events: none; }
.admin-search .input { width: 100%; padding-left: 34px; }
.admin-table-wrap { border: 1px solid var(--border); border-radius: var(--radius); overflow-x: auto; }
.admin-table { width: 100%; border-collapse: collapse; font-size: .93em; }
.admin-table th { text-align: left; padding: 9px 12px; font-size: .78em; font-weight: 700; text-transform: uppercase; letter-spacing: .05em; color: var(--fg-faint); background: var(--bg-sunken); border-bottom: 1px solid var(--border); white-space: nowrap; }
.admin-table td { padding: 8px 12px; border-bottom: 1px solid var(--border); vertical-align: middle; }
.admin-table tbody tr:last-child td { border-bottom: 0; }
.admin-table tbody tr { cursor: pointer; }
.admin-table tbody tr:hover { background: var(--bg-hover); }
.admin-table tbody tr.selected { background: var(--bg-active); }
.admin-table tbody tr:focus-visible { outline: none; box-shadow: inset var(--focus-ring); }
.admin-who { display: flex; align-items: center; gap: 10px; min-width: 200px; }
.admin-who-name { font-weight: 550; display: flex; align-items: center; gap: 6px; }
.admin-groups { display: block; max-width: 180px; }
.admin-role { display: inline-flex; align-items: center; height: 22px; padding: 0 8px; border-radius: 999px; font-size: .85em; font-weight: 550; white-space: nowrap; background: var(--bg-sunken); color: var(--fg-muted); }
.admin-role.admin { background: var(--accent-soft); color: var(--accent-soft-fg); }
.admin-role.custom { background: transparent; border: 1px solid var(--border-strong); }
.admin-meter { min-width: 120px; }
.admin-meter .quota-bar { margin: 0 0 4px; }
.admin-pager { display: flex; align-items: center; justify-content: flex-end; gap: 4px; margin-top: 8px; }
.admin-pager .hint { margin-right: 8px; font-variant-numeric: tabular-nums; }
.admin-count { margin-top: 8px; }
.admin-notice { display: flex; gap: 10px; align-items: flex-start; padding: 10px 12px; border-radius: var(--radius-sm); background: var(--bg-sunken); color: var(--fg-muted); font-size: .92em; margin: 8px 0; }
.admin-notice svg { flex: none; margin-top: 2px; }
.admin-notice.warn { background: var(--warn-soft); color: var(--fg); }
.admin-notice.warn svg { color: var(--warn); }
.admin-notice.error { background: var(--danger-soft); color: var(--fg); }
.admin-sheet { position: absolute; top: 0; right: 0; bottom: 0; width: min(460px, 100%); z-index: 20; display: flex; flex-direction: column; background: var(--bg-elev); border-left: 1px solid var(--border); box-shadow: var(--shadow-3); animation: admin-sheet-in .18s var(--ease); }
@keyframes admin-sheet-in { from { transform: translateX(24px); opacity: 0; } }
.admin-sheet-head { display: flex; align-items: center; gap: 12px; padding: 14px 12px 12px 20px; border-bottom: 1px solid var(--border); }
.admin-sheet-head h2 { margin: 0; padding: 0; border: 0; font-size: 1.1em; font-weight: 650; }
.admin-sheet-body { flex: 1; overflow-y: auto; padding: 4px 20px 24px; }
.admin-sheet-body h3 { margin: 22px 0 10px; font-size: .78em; font-weight: 700; text-transform: uppercase; letter-spacing: .06em; color: var(--fg-faint); }
.admin-sheet-foot { display: flex; justify-content: flex-end; gap: 8px; padding: 12px 20px; border-top: 1px solid var(--border); }
.admin-address .input:first-child { flex: 0 1 160px; min-width: 0; }
.admin-address select.input { flex: 1; min-width: 0; }
.admin-wide { width: 100%; }
.admin-narrow { max-width: 140px; }
.admin-danger { border: 1px solid color-mix(in srgb, var(--danger) 35%, transparent); border-radius: var(--radius); padding: 12px 14px; }
.admin-danger p { margin: 0 0 10px; color: var(--fg-muted); font-size: .92em; }
.admin-danger-btn { color: var(--danger); border-color: color-mix(in srgb, var(--danger) 45%, transparent); }
.admin-danger-btn:hover:not(:disabled) { background: var(--danger-soft); }
.admin-dns { border: 1px solid var(--border); border-radius: var(--radius); }
.admin-dns-row { display: flex; gap: 10px; align-items: flex-start; padding: 8px 8px 8px 10px; border-bottom: 1px solid var(--border); }
.admin-dns-row:last-child { border-bottom: 0; }
.admin-dns-type { flex: 0 0 48px; font-family: var(--font-mono); font-size: .78em; font-weight: 700; color: var(--accent-soft-fg); padding-top: 2px; }
.admin-dns-name { font-size: .88em; font-weight: 550; word-break: break-all; }
.admin-dns-value { display: block; font-family: var(--font-mono); font-size: .8em; color: var(--fg-muted); word-break: break-all; margin-top: 2px; max-height: 4.8em; overflow: hidden; }
.admin-kv { display: grid; grid-template-columns: auto 1fr; gap: 8px 16px; align-items: center; margin: 0; font-size: .92em; }
.admin-kv dt { color: var(--fg-muted); }
.admin-kv dd { margin: 0; }
@media (prefers-reduced-motion: reduce) { .admin-sheet { animation: none; } }
/* ========================================================================== /* ==========================================================================
Contacts Contacts
========================================================================== */ ========================================================================== */
@@ -1950,6 +2024,8 @@ select optgroup { background-color: var(--bg-elev); color: var(--fg); }
.settings-layout.root .settings-nav { display: block; border-right: 0; } .settings-layout.root .settings-nav { display: block; border-right: 0; }
.settings-layout.root .settings-content { display: none; } .settings-layout.root .settings-content { display: none; }
.settings-content { --pad-b: 80px; padding: 16px 16px var(--pad-b); } .settings-content { --pad-b: 80px; padding: 16px 16px var(--pad-b); }
.admin-table .hide-mobile { display: none; }
.admin-sheet { width: 100%; border-left: 0; box-shadow: none; }
.contacts-layout { grid-template-columns: 1fr; } .contacts-layout { grid-template-columns: 1fr; }
.contacts-books { display: none; } .contacts-books { display: none; }
.contacts-layout.detail .contacts-list { display: none; } .contacts-layout.detail .contacts-list { display: none; }
@@ -0,0 +1,102 @@
import { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { FilePreviewDialog, type PreviewFile } from "../filepreview";
import { resetShareSupport } from "@/lib/share";
(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
/**
* The share sheet is wiring rather than arithmetic, and wiring is what a store
* test cannot see: whether the button is drawn at all is a question about the
* browser, and what it does is a fetch, a File and a fallback that has to fire
* on any failure rather than leaving the reader with nothing.
*
* The dialog is also where both callers meet -- an attachment opened from a
* message and a file opened from Files land in this same component -- so it is
* the one place worth driving.
*/
const FILE: PreviewFile = {
name: "photo.png",
type: "image/png",
size: 12,
url: "/api/blob/photo.png",
inlineUrl: "/api/blob/photo.png?inline=1",
};
function stubNavigator(nav: Partial<Navigator>) {
vi.stubGlobal("navigator", nav as Navigator);
resetShareSupport();
}
describe("sharing from the file preview", () => {
let host: HTMLDivElement;
let root: Root;
beforeEach(() => {
host = document.createElement("div");
document.body.appendChild(host);
root = createRoot(host);
vi.stubGlobal("fetch", vi.fn(async () => new Response(new Blob(["bytes"], { type: "image/png" }), { status: 200 })));
});
afterEach(() => {
act(() => root.unmount());
host.remove();
vi.unstubAllGlobals();
vi.restoreAllMocks();
resetShareSupport();
});
const show = () => act(() => root.render(<FilePreviewDialog file={FILE} onClose={() => undefined} />));
/* The dialog portals to the body, so the buttons are not under `host`. */
const shareButton = () => [...document.body.querySelectorAll("button")].find((b) => b.textContent?.trim() === "Share") ?? null;
it("draws no Share button where the browser cannot share files", () => {
// Desktop Linux and Firefox. A control that could only ever fall back to
// the Download beside it is one worth not drawing.
stubNavigator({});
show();
expect(shareButton()).toBeNull();
expect(document.body.textContent).toContain("Download");
});
it("hands the bytes to the sheet as a File, not the URL", async () => {
const share = vi.fn(async () => undefined);
stubNavigator({ share, canShare: (() => true) as unknown as Navigator["canShare"] });
show();
const btn = shareButton();
expect(btn).not.toBeNull();
await act(async () => {
btn!.click();
await Promise.resolve();
});
await act(async () => { await Promise.resolve(); });
expect(fetch).toHaveBeenCalledWith(FILE.url, { credentials: "same-origin" });
const shared = (share.mock.calls[0] as unknown as [ShareData])[0];
const file = shared.files?.[0];
expect(file).toBeInstanceOf(File);
expect(file?.name).toBe("photo.png");
expect(file?.type).toBe("image/png");
});
it("downloads instead when the blob cannot be fetched", async () => {
// The failure that matters is silent: without the fallback the tap does
// nothing at all and the file is simply unreachable from a phone.
const clicked = vi.spyOn(HTMLAnchorElement.prototype, "click").mockImplementation(() => undefined);
vi.stubGlobal("fetch", vi.fn(async () => new Response(null, { status: 500 })));
stubNavigator({ share: vi.fn(), canShare: (() => true) as unknown as Navigator["canShare"] });
show();
await act(async () => {
shareButton()!.click();
await Promise.resolve();
});
await act(async () => { await Promise.resolve(); });
expect(clicked).toHaveBeenCalled();
});
});
+41 -2
View File
@@ -1,10 +1,11 @@
import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react"; import { useCallback, useEffect, useMemo, useRef, useState, type ReactNode } from "react";
import { Code2, Download, Eye, Pencil, Printer, Save, X } from "lucide-react"; import { Code2, Download, Eye, Pencil, Printer, Save, Share2, X } from "lucide-react";
import { confirmDialog, Dialog } from "./dialog"; import { confirmDialog, Dialog } from "./dialog";
import { formatSize } from "@/lib/format"; import { formatSize } from "@/lib/format";
import { previewKind, TEXT_PREVIEW_CHARS, TEXT_PREVIEW_MAX } from "@/lib/preview"; import { previewKind, TEXT_PREVIEW_CHARS, TEXT_PREVIEW_MAX } from "@/lib/preview";
import { isMarkdown, renderMarkdown } from "@/lib/markdown"; import { isMarkdown, renderMarkdown } from "@/lib/markdown";
import { t } from "@/lib/i18n"; import { canShareFiles, shareFile } from "@/lib/share";
import { t, tc } from "@/lib/i18n";
/** /**
* One blob, described the way both callers can describe it. The URLs are built * One blob, described the way both callers can describe it. The URLs are built
@@ -144,6 +145,43 @@ export function FilePreviewDialog({
void confirmDialog({ title: t("Close without saving?"), confirmLabel: t("Discard"), danger: true }).then((yes) => yes && onClose()); void confirmDialog({ title: t("Close without saving?"), confirmLabel: t("Discard"), danger: true }).then((yes) => yes && onClose());
}; };
/*
* Hand the file to another app rather than to the filesystem.
*
* This is the surface where it matters most on a phone: opening an
* attachment lands here, and until now the only way onward was Download,
* which on Android and iOS means "put it somewhere and go and find it".
*
* The bytes have to be fetched rather than the URL passed along, because the
* share sheet takes a File. `same-origin` credentials because both URLs are
* ihasmail's own blob proxy and it is the session cookie that authorises the
* read -- which is also why this does not break the rule about `ui/` not
* reaching for the JMAP client: it is a plain fetch of a URL the caller
* already handed over.
*
* Anything that goes wrong, including a share the browser turned out not to
* support, falls through to the download. That is the button that was here
* before, so the worst case costs a tap rather than the file.
*/
const shareIt = useCallback(async () => {
if (!file) return;
const download = () => {
const l = document.createElement("a");
l.href = file.url;
l.download = file.name;
l.click();
};
try {
const res = await fetch(file.url, { credentials: "same-origin" });
if (!res.ok) throw new Error(String(res.status));
const blob = await res.blob();
const out = await shareFile(new File([blob], file.name, { type: file.type || blob.type || "application/octet-stream" }));
if (out === "unsupported") download();
} catch {
download();
}
}, [file]);
/* /*
* Print what is on screen, not the mail or the file list behind it. * Print what is on screen, not the mail or the file list behind it.
* *
@@ -209,6 +247,7 @@ export function FilePreviewDialog({
</div> </div>
)} )}
{editable && <button className="btn" onClick={startEditing}><Pencil size={16} /> {t("Edit")}</button>} {editable && <button className="btn" onClick={startEditing}><Pencil size={16} /> {t("Edit")}</button>}
{canShareFiles() && <button className="btn" onClick={() => void shareIt()}><Share2 size={16} /> {tc("share sheet", "Share")}</button>}
{kind && !tooBig && <button className="btn" onClick={print}><Printer size={16} /> {t("Print")}</button>} {kind && !tooBig && <button className="btn" onClick={print}><Printer size={16} /> {t("Print")}</button>}
<a className="btn" href={file.url} download={file.name}><Download size={16} /> {t("Download")}</a> <a className="btn" href={file.url} download={file.name}><Download size={16} /> {t("Download")}</a>
</> </>
+49 -1
View File
@@ -1,6 +1,6 @@
import { useEffect, useState, type ReactNode } from "react"; import { useEffect, useState, type ReactNode } from "react";
import { Link, useLocation } from "wouter"; import { Link, useLocation } from "wouter";
import { BookOpen, Calendar, ChevronsUpDown, FolderOpen, Globe, HelpCircle, LogOut, Mail, Menu as MenuIcon, Moon, PenSquare, Plus, RefreshCw, Settings, Sun, Upload, Users, X } from "lucide-react"; import { BookOpen, Calendar, ChevronsUpDown, FolderOpen, Globe, HelpCircle, LogOut, Mail, Menu as MenuIcon, Moon, PenSquare, Plus, RefreshCw, Settings, ShieldCheck, Sun, Upload, Users, X } from "lucide-react";
import { useSession } from "@/store/session"; import { useSession } from "@/store/session";
import { withBase } from "@/lib/basePath"; import { withBase } from "@/lib/basePath";
import { DEFAULT_APP_NAME } from "@/lib/brand"; import { DEFAULT_APP_NAME } from "@/lib/brand";
@@ -18,8 +18,12 @@ import { CalendarSidebar } from "./calendar/CalendarSidebar";
import { ShortcutsDialog, useGlobalShortcuts } from "./Shortcuts"; import { ShortcutsDialog, useGlobalShortcuts } from "./Shortcuts";
import { MailboxPicker } from "./mail/MailboxPicker"; import { MailboxPicker } from "./mail/MailboxPicker";
import { formatSize } from "@/lib/format"; import { formatSize } from "@/lib/format";
import { collectShare } from "@/lib/shareTarget";
import { TranslateBoundary } from "@/ui/TranslateBoundary"; import { TranslateBoundary } from "@/ui/TranslateBoundary";
import { t } from "@/lib/i18n"; import { t } from "@/lib/i18n";
import { hasAdministration } from "@/lib/adminAccess";
import { usePermissions } from "./admin/usePermissions";
import { AdminNav } from "./admin/AdminNav";
const PUSH_LABEL = { const PUSH_LABEL = {
connected: "Live updates connected", connected: "Live updates connected",
@@ -35,11 +39,14 @@ export function AppShell({ children }: { children: ReactNode }) {
const [drawer, setDrawer] = useState(false); const [drawer, setDrawer] = useState(false);
const [helpOpen, setHelpOpen] = useState(false); const [helpOpen, setHelpOpen] = useState(false);
const openCompose = useCompose((s) => s.open); const openCompose = useCompose((s) => s.open);
const openShare = useCompose((s) => s.openFromShare);
const pushState = useSession((s) => s.pushState); const pushState = useSession((s) => s.pushState);
const session = useSession((s) => s.session); const session = useSession((s) => s.session);
const logout = useSession((s) => s.logout); const logout = useSession((s) => s.logout);
const appName = useSession((s) => s.session?.ihasmail?.appName) || DEFAULT_APP_NAME; const appName = useSession((s) => s.session?.ihasmail?.appName) || DEFAULT_APP_NAME;
const acctMenu = useMenu(); const acctMenu = useMenu();
const administers = hasAdministration(usePermissions());
const needsOwnDevice = useSession((s) => Boolean(s.session?.ihasmail?.administrationNeedsOwnDevice));
/* /*
* "Go to folder" (#233), hosted here rather than in the mail view because * "Go to folder" (#233), hosted here rather than in the mail view because
* the `g` shortcuts are global: pressing it from the calendar should still * the `g` shortcuts are global: pressing it from the calendar should still
@@ -73,6 +80,28 @@ export function AppShell({ children }: { children: ReactNode }) {
} }
}, [openCompose, navigate]); }, [openCompose, navigate]);
/*
* A share from the operating system, collected rather than read off the URL.
*
* The other deep links above arrive as a query the app can read on the spot.
* A share cannot: it is a POST, the service worker answered it, and what it
* left behind has to survive the redirect -- and, when nobody was signed in,
* a trip through the sign-in page as well. So this asks on every start
* instead of only when `?share=1` says so, and finds nothing almost every
* time. The `at` stamp is what stops an abandoned one turning up days later.
*
* It runs here rather than in `main.tsx` because attaching needs an account:
* `addFiles` uploads as it goes, and there is nothing to upload to until the
* session is in place. AppShell only exists once there is one.
*/
useEffect(() => {
void collectShare().then((share) => {
if (!share) return;
openShare(share);
if (new URLSearchParams(window.location.search).has("share")) navigate("/mail", { replace: true });
});
}, [openShare, navigate]);
/* /*
* There is no account switcher any more. * There is no account switcher any more.
* *
@@ -132,6 +161,24 @@ export function AppShell({ children }: { children: ReactNode }) {
app there was no way back to it. */} app there was no way back to it. */}
<MenuItem icon={<Globe size={16} />} label={t("About ihasmail")} href="https://ihasmail.org" external /> <MenuItem icon={<Globe size={16} />} label={t("About ihasmail")} href="https://ihasmail.org" external />
<MenuItem icon={<Settings size={16} />} label={t("Settings")} onClick={() => navigate("/settings")} /> <MenuItem icon={<Settings size={16} />} label={t("Settings")} onClick={() => navigate("/settings")} />
{/* Only for an account whose Stalwart role manages other accounts.
Nobody else is shown an entry that would open onto refusals. */}
{administers && <MenuItem icon={<ShieldCheck size={16} />} label={t("Administration")} active={section === "admin"} onClick={() => navigate("/admin")} />}
{/* An administrator who signed in without "This is my own device". The
server withholds administration from that session, so the entry is
shown dead with the reason, rather than gone without one. */}
{!administers && needsOwnDevice && (
<MenuItem
icon={<ShieldCheck size={16} />}
disabled
label={
<>
<span style={{ display: "block" }}>{t("Administration")}</span>
<span className="hint" style={{ display: "block", whiteSpace: "normal" }}>{t("Only on a device you've marked as your own. Sign in again with “This is my own device” ticked.")}</span>
</>
}
/>
)}
<MenuItem icon={<RefreshCw size={16} />} label={t("Refresh")} onClick={() => window.location.reload()} /> <MenuItem icon={<RefreshCw size={16} />} label={t("Refresh")} onClick={() => window.location.reload()} />
<MenuItem icon={<LogOut size={16} />} label={t("Sign out")} onClick={() => void logout()} /> <MenuItem icon={<LogOut size={16} />} label={t("Sign out")} onClick={() => void logout()} />
</Popover> </Popover>
@@ -183,6 +230,7 @@ export function AppShell({ children }: { children: ReactNode }) {
{section === "contacts" && <ContactsSidebar />} {section === "contacts" && <ContactsSidebar />}
{section === "files" && <FilesTree />} {section === "files" && <FilesTree />}
{section === "settings" && <div className="nav-section"><span>{t("Settings")}</span></div>} {section === "settings" && <div className="nav-section"><span>{t("Settings")}</span></div>}
{section === "admin" && <AdminNav />}
</div> </div>
{(section === "mail" || section === "search") && <QuotaBar />} {(section === "mail" || section === "search") && <QuotaBar />}
<nav className="module-bar" aria-label={t("Go to")}> <nav className="module-bar" aria-label={t("Go to")}>
+459
View File
@@ -0,0 +1,459 @@
import { useEffect, useMemo, useState } from "react";
import { Copy, Dices, KeyRound, Lock, Plus, Trash2, X } from "lucide-react";
import {
ADMIN_BASELINE,
can,
canGrantRole,
generatePassword,
outranks,
type UserRoles,
} from "@/lib/adminAccess";
import {
aliasList,
createAccount,
describeDirectoryError,
destroyAccount,
hasPassword,
passwordPatch,
quotasWithDisk,
updateAccount,
DISK_QUOTA,
type DirectoryAccount,
type EmailAlias,
} from "@/lib/adminDirectory";
import { formatSize } from "@/lib/format";
import { t, tNode } from "@/lib/i18n";
import { Link } from "wouter";
import { Avatar } from "@/ui/misc";
import { Dialog } from "@/ui/dialog";
import { toast } from "@/ui/toast";
import { isSelf, roleName, type DirectoryContext } from "./directoryContext";
import { usePermissions } from "./usePermissions";
const GIB = 1024 ** 3;
interface Props {
/** Null to create one. */
account: DirectoryAccount | null;
ctx: DirectoryContext;
onClose: () => void;
onChanged: () => void;
onCreated: (id: string) => void;
onDeleted: () => void;
}
/** A role as one select value: "User", "Admin", or "custom:<ids>". */
function roleKey(roles: UserRoles | undefined): string {
if (!roles || roles["@type"] === "User") return "User";
if (roles["@type"] === "Admin") return "Admin";
return `custom:${Object.keys(roles.roleIds ?? {}).sort().join(",")}`;
}
function rolesFromKey(key: string): UserRoles {
if (key === "Admin") return { "@type": "Admin" };
if (key.startsWith("custom:")) {
return { "@type": "Custom", roleIds: Object.fromEntries(key.slice(7).split(",").filter(Boolean).map((id) => [id, true])) };
}
return { "@type": "User" };
}
const gibOf = (bytes: number | undefined) => (bytes ? String(Math.round((bytes / GIB) * 10) / 10) : "");
const bytesOf = (gib: string) => {
const n = Number(gib.replace(",", "."));
return Number.isFinite(n) && n > 0 ? Math.round(n * GIB) : null;
};
/**
* One account, opened beside the list.
*
* A panel rather than a dialog, so the list stays visible and the next account
* is one click away. Saving sends one `x:Account/set` with only what changed;
* a password and a delete are their own calls, because each is a decision of
* its own and should never ride along with a renamed display name.
*/
export function AccountSheet({ account, ctx, onClose, onChanged, onCreated, onDeleted }: Props) {
const perms = usePermissions();
const creating = account === null;
const self = account ? isSelf(account, ctx) : false;
const locked = account ? outranks(perms, account, ctx.roles) : false;
const editable = creating ? can(perms, "Account", "Create") : can(perms, "Account", "Update") && !locked;
const [description, setDescription] = useState(account?.description ?? "");
const [name, setName] = useState("");
const [domainId, setDomainId] = useState(ctx.domains[0]?.id ?? "");
const [password, setPassword] = useState(() => (creating ? generatePassword() : ""));
const [role, setRole] = useState(roleKey(account?.roles));
const [quota, setQuota] = useState(gibOf(account?.quotas?.[DISK_QUOTA]));
const [aliases, setAliases] = useState<EmailAlias[]>(() => Object.values(account?.aliases ?? {}));
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
useEffect(() => {
if (!domainId && ctx.domains[0]) setDomainId(ctx.domains[0].id);
}, [ctx.domains, domainId]);
useEffect(() => {
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape" && !document.querySelector(".dialog-backdrop")) onClose();
};
window.addEventListener("keydown", onKey);
return () => window.removeEventListener("keydown", onKey);
}, [onClose]);
const domainName = (id: string) => ctx.domains.find((d) => d.id === id)?.name ?? "";
const address = account?.emailAddress ?? `${name}@${domainName(domainId)}`;
const roleOptions = useMemo(() => {
const options: { value: string; label: string }[] = [{ value: "User", label: t("User") }];
if (ADMIN_BASELINE.every((p) => perms.has(p)) || role === "Admin") options.push({ value: "Admin", label: t("Administrator") });
for (const r of ctx.roles?.values() ?? []) {
if (canGrantRole(perms, r.id, ctx.roles)) options.push({ value: `custom:${r.id}`, label: r.description || r.id });
}
if (!options.some((o) => o.value === role)) options.push({ value: role, label: account ? roleName(account, ctx.roles) : role });
return options;
}, [perms, ctx.roles, role, account]);
const run = async (work: () => Promise<void>) => {
setBusy(true);
setError(null);
try {
await work();
} catch (err) {
setError(describeDirectoryError(err));
} finally {
setBusy(false);
}
};
const save = () =>
run(async () => {
if (!account) {
if (!name.trim() || !domainId) {
setError(t("An account needs an address."));
return;
}
const id = await createAccount({ name, domainId, description, password, roles: rolesFromKey(role), diskQuotaBytes: bytesOf(quota) });
toast.success(t("Created {address}", { address }));
onCreated(id);
return;
}
const patch: Record<string, unknown> = {};
if ((account.description ?? "") !== description) patch.description = description.trim() || null;
if (roleKey(account.roles) !== role) patch.roles = rolesFromKey(role);
if ((account.quotas?.[DISK_QUOTA] ?? null) !== bytesOf(quota)) patch.quotas = quotasWithDisk(account.quotas, bytesOf(quota));
const before = JSON.stringify(aliasList(Object.values(account.aliases ?? {})));
if (before !== JSON.stringify(aliasList(aliases))) patch.aliases = aliasList(aliases);
if (!Object.keys(patch).length) {
onClose();
return;
}
await updateAccount(account.id, patch);
toast.success(t("Saved {address}", { address }));
onChanged();
});
const used = account?.usedDiskQuota ?? 0;
const limit = account?.quotas?.[DISK_QUOTA];
return (
<aside className="admin-sheet" aria-label={creating ? t("New account") : address}>
<div className="admin-sheet-head">
{account && <Avatar who={{ name: account.description || account.name, email: account.emailAddress }} />}
<div className="grow">
<h2 className="truncate">{creating ? t("New account") : account.description || account.name}</h2>
{account && <div className="hint truncate notranslate" translate="no">{account.emailAddress}</div>}
</div>
<button className="icon-btn" onClick={onClose} aria-label={t("Close")}>
<X size={20} />
</button>
</div>
<div className="admin-sheet-body">
{locked && (
<p className="admin-notice warn">
<Lock size={16} aria-hidden="true" />
<span>{t("This account has permissions yours doesn't, so you can view it but not change it.")}</span>
</p>
)}
{!creating && !locked && !can(perms, "Account", "Update") && (
<p className="admin-notice">{t("Your role lets you view accounts but not change them.")}</p>
)}
<h3>{t("Profile")}</h3>
<div className="field">
<label htmlFor="admin-description">{t("Display name")}</label>
<input id="admin-description" className="input" value={description} disabled={!editable} onChange={(e) => setDescription(e.target.value)} />
</div>
{creating && (
<div className="field">
<label htmlFor="admin-name">{t("Address")}</label>
<div className="row admin-address">
<input id="admin-name" className="input" value={name} autoComplete="off" spellCheck={false} onChange={(e) => setName(e.target.value.trim().toLowerCase())} />
<span className="muted">@</span>
<select className="input" aria-label={t("Domain")} value={domainId} onChange={(e) => setDomainId(e.target.value)}>
{ctx.domains.map((d) => <option key={d.id} value={d.id}>{d.name}</option>)}
</select>
</div>
{!ctx.domains.length && <span className="hint">{t("No domains are available to create an account on.")}</span>}
</div>
)}
<h3>{t("Sign-in")}</h3>
{creating ? (
<PasswordField value={password} onChange={setPassword} />
) : (
self ? (
// This session signs in with the password; changing it here would
// strand it. Settings re-seals the session as it changes, so that is
// the door for one's own.
<p className="hint" style={{ marginTop: 0 }}>
{tNode("Change your own password in {settings}.", { settings: <Link href="/settings/security">{t("Security & sessions")}</Link> })}
</p>
) : (
<PasswordReset account={account} disabled={!editable} onDone={onChanged} />
)
)}
{!creating && (
<>
<h3>{t("Other addresses")}</h3>
<Aliases aliases={aliases} setAliases={setAliases} editable={editable} domains={ctx.domains} defaultDomain={account.domainId} domainName={domainName} />
</>
)}
{!creating && (
<>
<h3>{t("Groups")}</h3>
<div className="row wrap gap-4">
{Object.keys(account.memberGroupIds ?? {}).length ? (
Object.keys(account.memberGroupIds ?? {}).map((id) => {
const g = ctx.groups.get(id);
return <span key={id} className="chip">{g ? g.description || g.name : id}</span>;
})
) : (
<span className="hint">{t("Not in any group")}</span>
)}
</div>
</>
)}
<h3>{t("Role")}</h3>
<select className="input admin-wide" aria-label={t("Role")} value={role} disabled={!editable || self} onChange={(e) => setRole(e.target.value)}>
{roleOptions.map((o) => <option key={o.value} value={o.value}>{o.label}</option>)}
</select>
<p className="hint">
{self ? t("You can't change your own role.") : t("Only roles whose permissions you hold yourself are offered. On an account inside a tenant, Administrator means administrator of that tenant.")}
</p>
<h3>{t("Storage")}</h3>
{!creating && (
<p className="hint" style={{ marginTop: 0 }}>
{limit ? t("{used} of {total}", { used: formatSize(used), total: formatSize(limit) }) : t("{used} · no limit", { used: formatSize(used) })}
</p>
)}
<div className="field">
<label htmlFor="admin-quota">{t("Limit in GB")}</label>
<input id="admin-quota" className="input admin-narrow" inputMode="decimal" value={quota} disabled={!editable} placeholder={t("No limit")} onChange={(e) => setQuota(e.target.value)} />
</div>
{error && <p className="admin-notice error" role="alert">{error}</p>}
{!creating && can(perms, "Account", "Destroy") && (
<DeleteAccount account={account} blocked={self ? t("You can't delete the account you're signed in with.") : locked ? t("This account has permissions yours doesn't.") : null} onDeleted={onDeleted} />
)}
</div>
{editable && (
<div className="admin-sheet-foot">
<button className="btn btn-ghost" onClick={onClose}>{t("Cancel")}</button>
<button className="btn btn-primary" disabled={busy || (creating && (!name || !domainId || !password))} onClick={() => void save()}>
{creating ? t("Create account") : t("Save changes")}
</button>
</div>
)}
</aside>
);
}
function PasswordField({ value, onChange, id = "admin-password" }: { value: string; onChange: (v: string) => void; id?: string }) {
return (
<div className="field">
<label htmlFor={id}>{t("Password")}</label>
<div className="row">
<input id={id} className="input grow mono" value={value} autoComplete="new-password" spellCheck={false} onChange={(e) => onChange(e.target.value)} />
<button type="button" className="icon-btn" aria-label={t("Generate a password")} title={t("Generate a password")} onClick={() => onChange(generatePassword())}>
<Dices size={18} />
</button>
<button
type="button"
className="icon-btn"
aria-label={t("Copy")}
title={t("Copy")}
onClick={() => void navigator.clipboard?.writeText(value).then(() => toast.success(t("Copied")), () => toast.error(t("Could not copy")))}
>
<Copy size={18} />
</button>
</div>
<span className="hint">{t("Pass it on some way other than email to this address.")}</span>
</div>
);
}
function PasswordReset({ account, disabled, onDone }: { account: DirectoryAccount; disabled: boolean; onDone: () => void }) {
const [open, setOpen] = useState(false);
const [value, setValue] = useState("");
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const first = account.description?.split(" ")[0] || account.name;
if (!open) {
return (
<div>
{!hasPassword(account) && <p className="hint" style={{ marginTop: 0 }}>{t("This account has no password. It may sign in through a directory or single sign-on.")}</p>}
<button className="btn" disabled={disabled} onClick={() => { setValue(generatePassword()); setOpen(true); }}>
<KeyRound size={16} /> {t("Set a new password…")}
</button>
</div>
);
}
return (
<div>
<PasswordField id="admin-reset-password" value={value} onChange={setValue} />
<p className="hint">{t("{name} will be signed out of every app and device using the old password.", { name: first })}</p>
{error && <p className="admin-notice error" role="alert">{error}</p>}
<div className="row">
<button
className="btn btn-primary btn-sm"
disabled={busy || !value}
onClick={async () => {
setBusy(true);
setError(null);
try {
await updateAccount(account.id, passwordPatch(account, value));
toast.success(t("New password set for {address}", { address: account.emailAddress ?? account.name }));
setOpen(false);
onDone();
} catch (err) {
setError(describeDirectoryError(err));
} finally {
setBusy(false);
}
}}
>
{t("Set password")}
</button>
<button className="btn btn-ghost btn-sm" onClick={() => setOpen(false)}>{t("Cancel")}</button>
</div>
</div>
);
}
function Aliases({ aliases, setAliases, editable, domains, defaultDomain, domainName }: {
aliases: EmailAlias[];
setAliases: (a: EmailAlias[]) => void;
editable: boolean;
domains: { id: string; name: string }[];
defaultDomain: string;
domainName: (id: string) => string;
}) {
const [local, setLocal] = useState("");
const [domain, setDomain] = useState(defaultDomain);
const add = () => {
const name = local.trim().toLowerCase();
if (!name || aliases.some((a) => a.name === name && a.domainId === domain)) return;
setAliases([...aliases, { enabled: true, name, domainId: domain }]);
setLocal("");
};
return (
<div>
<div className="row wrap gap-4">
{aliases.length ? (
aliases.map((a, i) => (
<span key={`${a.name}@${a.domainId}`} className="chip notranslate" translate="no">
{a.name}@{domainName(a.domainId) || "…"}
{editable && (
<button className="chip-x" aria-label={t("Remove {address}", { address: `${a.name}@${domainName(a.domainId)}` })} onClick={() => setAliases(aliases.filter((_, j) => j !== i))}>
<X size={12} />
</button>
)}
</span>
))
) : (
<span className="hint">{t("None")}</span>
)}
</div>
{editable && (
<div className="row admin-address mt-8">
<input className="input" aria-label={t("New address")} placeholder={t("another name")} value={local} spellCheck={false} onChange={(e) => setLocal(e.target.value)} onKeyDown={(e) => { if (e.key === "Enter") { e.preventDefault(); add(); } }} />
<span className="muted">@</span>
<select className="input" aria-label={t("Domain")} value={domain} onChange={(e) => setDomain(e.target.value)}>
{(domains.some((d) => d.id === defaultDomain) ? domains : [{ id: defaultDomain, name: domainName(defaultDomain) || "…" }, ...domains]).map((d) => (
<option key={d.id} value={d.id}>{d.name}</option>
))}
</select>
<button className="btn btn-sm" onClick={add} disabled={!local.trim()}>
<Plus size={14} /> {t("Add")}
</button>
</div>
)}
{editable && <p className="hint">{t("Mail to these addresses is delivered to this account. Changes apply when you save.")}</p>}
</div>
);
}
function DeleteAccount({ account, blocked, onDeleted }: { account: DirectoryAccount; blocked: string | null; onDeleted: () => void }) {
const [open, setOpen] = useState(false);
const [typed, setTyped] = useState("");
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const address = account.emailAddress ?? account.name;
return (
<>
<h3>{t("Delete")}</h3>
<div className="admin-danger">
<p>{blocked ?? t("Deletes the mailbox and everything in it.")}</p>
<button className="btn btn-sm admin-danger-btn" disabled={!!blocked} onClick={() => { setTyped(""); setError(null); setOpen(true); }}>
<Trash2 size={14} /> {t("Delete account…")}
</button>
</div>
<Dialog
open={open}
onClose={() => setOpen(false)}
title={t("Delete {address}?", { address })}
size="sm"
footer={
<>
<button className="btn" onClick={() => setOpen(false)}>{t("Cancel")}</button>
<button
className="btn btn-danger"
disabled={busy || typed.trim().toLowerCase() !== address.toLowerCase()}
onClick={async () => {
setBusy(true);
setError(null);
try {
await destroyAccount(account.id);
toast.success(t("Deleted {address}", { address }));
setOpen(false);
onDeleted();
} catch (err) {
setError(describeDirectoryError(err));
} finally {
setBusy(false);
}
}}
>
{t("Delete account")}
</button>
</>
}
>
<p style={{ marginTop: 0 }}>{t("This deletes the mail, calendars, contacts and files in this account. The server removes them in the background, and it can't be undone.")}</p>
<div className="field">
<label htmlFor="admin-delete-confirm">{t("Type {address} to confirm", { address })}</label>
<input id="admin-delete-confirm" className="input notranslate" translate="no" value={typed} autoComplete="off" spellCheck={false} onChange={(e) => setTyped(e.target.value)} />
</div>
{error && <p className="admin-notice error" role="alert">{error}</p>}
</Dialog>
</>
);
}
+267
View File
@@ -0,0 +1,267 @@
import { useEffect, useMemo, useState } from "react";
import { useLocation } from "wouter";
import { ChevronLeft, ChevronRight, Search, UserPlus, Users } from "lucide-react";
import { useSession } from "@/store/session";
import { STALWART_CAP } from "@/jmap/client";
import { can, type RoleDef } from "@/lib/adminAccess";
import {
describeDirectoryError,
getAccounts,
listDomains,
listGroups,
listRoles,
queryAccounts,
DISK_QUOTA,
type DirectoryAccount,
type DirectoryDomain,
} from "@/lib/adminDirectory";
import { formatSize } from "@/lib/format";
import { plural, t } from "@/lib/i18n";
import { Avatar, Empty, Spinner } from "@/ui/misc";
import { usePermissions } from "./usePermissions";
import { isSelf, roleName, type DirectoryContext } from "./directoryContext";
import { AccountSheet } from "./AccountSheet";
const PAGE_SIZE = 50;
export function AccountsAdmin({ selectedId }: { selectedId?: string }) {
const [, navigate] = useLocation();
const perms = usePermissions();
const session = useSession((s) => s.session);
const [text, setText] = useState("");
const [query, setQuery] = useState("");
const [position, setPosition] = useState(0);
const [page, setPage] = useState<{ accounts: DirectoryAccount[]; total: number } | null>(null);
const [error, setError] = useState<string | null>(null);
const [reload, setReload] = useState(0);
const [serverDomains, setServerDomains] = useState<DirectoryDomain[] | null>(null);
const [roles, setRoles] = useState<Map<string, RoleDef> | null>(null);
const [groups, setGroups] = useState<Map<string, DirectoryAccount>>(new Map());
const [loose, setLoose] = useState<DirectoryAccount | null>(null);
// Typing is not a query per keystroke.
useEffect(() => {
const id = window.setTimeout(() => {
setQuery(text);
setPosition(0);
}, 250);
return () => window.clearTimeout(id);
}, [text]);
useEffect(() => {
let cancelled = false;
setError(null);
void (async () => {
try {
const q = await queryAccounts({ type: "User", text: query, position, limit: PAGE_SIZE });
const accounts = await getAccounts(q.ids);
if (!cancelled) setPage({ accounts, total: q.total });
} catch (err) {
if (!cancelled) {
setPage({ accounts: [], total: 0 });
setError(describeDirectoryError(err));
}
}
})();
return () => {
cancelled = true;
};
}, [query, position, reload]);
// The lists the account sheet picks from. Each is a nicety: without it the
// sheet falls back to what it can see, or offers less.
useEffect(() => {
if (can(perms, "Domain", "Query") && can(perms, "Domain", "Get")) void listDomains().then(setServerDomains, () => setServerDomains(null));
if (can(perms, "Role", "Query") && can(perms, "Role", "Get")) void listRoles().then((list) => setRoles(new Map(list.map((r) => [r.id, r]))), () => setRoles(null));
void listGroups().then((list) => setGroups(new Map(list.map((g) => [g.id, g]))), () => setGroups(new Map()));
}, [perms, reload]);
// An account opened by address that is not on the page being shown.
useEffect(() => {
if (!selectedId || selectedId === "new" || page?.accounts.some((a) => a.id === selectedId)) {
setLoose(null);
return;
}
let cancelled = false;
void getAccounts([selectedId]).then(
([a]) => { if (!cancelled) setLoose(a ?? null); },
() => { if (!cancelled) setLoose(null); },
);
return () => {
cancelled = true;
};
}, [selectedId, page]);
const ctx: DirectoryContext = useMemo(() => {
const seen = new Map<string, DirectoryDomain>();
for (const a of page?.accounts ?? []) {
const domain = a.emailAddress?.split("@")[1];
if (domain && !seen.has(a.domainId)) seen.set(a.domainId, { id: a.domainId, name: domain });
}
const ownId = session?.primaryAccounts?.[STALWART_CAP];
return {
domains: (serverDomains ?? [...seen.values()]).slice().sort((x, y) => x.name.localeCompare(y.name)),
roles,
groups,
self: { ids: new Set(ownId ? [ownId] : []), address: (session?.username ?? "").toLowerCase() },
};
}, [page, serverDomains, roles, groups, session]);
const selected = selectedId && selectedId !== "new" ? (page?.accounts.find((a) => a.id === selectedId) ?? loose) : null;
const close = () => navigate("/admin/accounts");
const changed = () => setReload((n) => n + 1);
return (
<div>
<div className="admin-head">
<div className="grow">
<h1>{t("Accounts")}</h1>
<p className="lead">{t("The people who sign in to mail on the domains you manage.")}</p>
</div>
{can(perms, "Account", "Create") && (
<button className="btn btn-primary" onClick={() => navigate("/admin/accounts/new")}>
<UserPlus size={16} /> {t("New account")}
</button>
)}
</div>
<div className="admin-toolbar">
<label className="admin-search">
<Search size={16} aria-hidden="true" />
<input
className="input"
type="search"
value={text}
onChange={(e) => setText(e.target.value)}
placeholder={t("Search by name or address")}
aria-label={t("Search accounts")}
/>
</label>
</div>
{error && <p className="admin-notice error" role="alert">{error}</p>}
{page === null ? (
<Spinner />
) : page.accounts.length === 0 ? (
!error && (
<Empty icon={<Users size={32} />} title={query ? t("No accounts match") : t("No accounts yet")}>
{query ? t("Nothing on your domains matches “{query}”.", { query }) : undefined}
</Empty>
)
) : (
<>
<div className="admin-table-wrap">
<table className="admin-table">
<thead>
<tr>
<th>{t("Account")}</th>
<th>{t("Role")}</th>
<th>{t("Storage")}</th>
<th className="hide-mobile">{t("Groups")}</th>
</tr>
</thead>
<tbody>
{page.accounts.map((a) => (
<tr
key={a.id}
className={a.id === selectedId ? "selected" : ""}
tabIndex={0}
onClick={() => navigate(`/admin/accounts/${a.id}`)}
onKeyDown={(e) => {
if (e.key === "Enter" || e.key === " ") {
e.preventDefault();
navigate(`/admin/accounts/${a.id}`);
}
}}
aria-label={t("Open {address}", { address: a.emailAddress ?? a.name })}
>
<td>
<div className="admin-who">
<Avatar who={{ name: a.description || a.name, email: a.emailAddress }} size="sm" />
<div className="grow">
<div className="admin-who-name truncate">
{a.description || a.name}
{isSelf(a, ctx) && <span className="badge muted">{t("You")}</span>}
</div>
<div className="hint truncate notranslate" translate="no">{a.emailAddress}</div>
</div>
</div>
</td>
<td><RoleLabel account={a} roles={ctx.roles} /></td>
<td><StorageMeter account={a} /></td>
<td className="hide-mobile muted">
<span className="truncate admin-groups">{groupNames(a, ctx.groups) || "—"}</span>
</td>
</tr>
))}
</tbody>
</table>
</div>
<Pager position={position} shown={page.accounts.length} total={page.total} onMove={setPosition} />
</>
)}
{(selectedId === "new" || selected) && (
<AccountSheet
key={selectedId}
account={selectedId === "new" ? null : selected}
ctx={ctx}
onClose={close}
onChanged={changed}
onCreated={(id) => {
changed();
navigate(`/admin/accounts/${id}`);
}}
onDeleted={() => {
changed();
close();
}}
/>
)}
</div>
);
}
function groupNames(a: DirectoryAccount, groups: Map<string, DirectoryAccount>): string {
return Object.keys(a.memberGroupIds ?? {})
.map((id) => groups.get(id))
.filter(Boolean)
.map((g) => g!.description || g!.name)
.join(", ");
}
function RoleLabel({ account, roles }: { account: DirectoryAccount; roles: Map<string, RoleDef> | null }) {
const kind = account.roles?.["@type"] ?? "User";
return <span className={`admin-role ${kind === "Admin" ? "admin" : kind === "Custom" ? "custom" : ""}`}>{roleName(account, roles)}</span>;
}
function StorageMeter({ account }: { account: DirectoryAccount }) {
const used = account.usedDiskQuota ?? 0;
const limit = account.quotas?.[DISK_QUOTA] ?? 0;
if (!limit) return <span className="muted small">{t("{used} · no limit", { used: formatSize(used) })}</span>;
const pct = Math.min(100, Math.round((used / limit) * 100));
return (
<div className="admin-meter" title={t("{used} of {total}", { used: formatSize(used), total: formatSize(limit) })}>
<div className="quota-bar"><span className={pct > 95 ? "danger" : pct > 80 ? "warn" : ""} style={{ width: `${pct}%` }} /></div>
<span className="small muted">{t("{used} of {total}", { used: formatSize(used), total: formatSize(limit) })}</span>
</div>
);
}
function Pager({ position, shown, total, onMove }: { position: number; shown: number; total: number; onMove: (p: number) => void }) {
if (total <= PAGE_SIZE && position === 0) {
return <p className="hint admin-count">{plural(total, { one: "{n} account", other: "{n} accounts" })}</p>;
}
return (
<div className="admin-pager">
<span className="hint">{t("{from}{to} of {total}", { from: position + 1, to: position + shown, total })}</span>
<button className="icon-btn sm" aria-label={t("Previous page")} disabled={position === 0} onClick={() => onMove(Math.max(0, position - PAGE_SIZE))}>
<ChevronLeft size={18} />
</button>
<button className="icon-btn sm" aria-label={t("Next page")} disabled={position + shown >= total} onClick={() => onMove(position + PAGE_SIZE)}>
<ChevronRight size={18} />
</button>
</div>
);
}
+48
View File
@@ -0,0 +1,48 @@
import type { ReactNode } from "react";
import { Link, useLocation } from "wouter";
import { Globe, User } from "lucide-react";
import { adminSections, type AdminSection } from "@/lib/adminAccess";
import { t } from "@/lib/i18n";
import { usePermissions } from "./usePermissions";
export const ADMIN_SECTIONS: Record<AdminSection, { group: string; label: string; icon: ReactNode }> = {
accounts: { group: "Directory", label: "Accounts", icon: <User size={20} /> },
domains: { group: "Mail", label: "Domains", icon: <Globe size={20} /> },
};
/** The section the address names, or the first the role can open. */
export function currentAdminSection(allowed: AdminSection[], requested: string | undefined): AdminSection | undefined {
return allowed.find((s) => s === requested) ?? allowed[0];
}
/**
* Administration's sections, in the folder pane.
*
* Settings keeps its list inside the page; Administration's pages are tables
* that want the width, so the list lives where Mail keeps its folders. On a
* phone that puts it in the drawer, which is where every other section's list
* already is. Only sections the role can read are listed.
*/
export function AdminNav() {
const [location] = useLocation();
const allowed = adminSections(usePermissions());
const current = currentAdminSection(allowed, location.split("/")[2]);
const groups = [...new Set(allowed.map((s) => ADMIN_SECTIONS[s].group))];
return (
<nav aria-label={t("Administration")}>
{groups.map((group) => (
<div key={group}>
<div className="nav-section"><span>{t(group)}</span></div>
{allowed
.filter((s) => ADMIN_SECTIONS[s].group === group)
.map((s) => (
<Link key={s} href={`/admin/${s}`} className={`nav-item ${current === s ? "active" : ""}`} title={t(ADMIN_SECTIONS[s].label)} aria-current={current === s ? "page" : undefined}>
{ADMIN_SECTIONS[s].icon}
<span className="nav-label">{t(ADMIN_SECTIONS[s].label)}</span>
</Link>
))}
</div>
))}
</nav>
);
}
+33
View File
@@ -0,0 +1,33 @@
import type { ReactNode } from "react";
import { Redirect } from "wouter";
import { adminSections, type AdminSection } from "@/lib/adminAccess";
import { AccountsAdmin } from "./AccountsAdmin";
import { DomainsAdmin } from "./DomainsAdmin";
import { currentAdminSection } from "./AdminNav";
import { usePermissions } from "./usePermissions";
const RENDER: Record<AdminSection, (id?: string) => ReactNode> = {
accounts: (id) => <AccountsAdmin selectedId={id} />,
domains: (id) => <DomainsAdmin selectedId={id} />,
};
/**
* Administration: what the signed-in account's Stalwart role lets it manage.
*
* The page is only the open section. Its list of sections is in the folder
* pane (see AdminNav), so the tables here get the width Settings spends on a
* second column. A section the role cannot read -- typed into the address bar,
* say -- opens the first one it can.
*/
export function AdminView({ section, id }: { section?: string; id?: string }) {
const allowed = adminSections(usePermissions());
// A role taken away since the menu was drawn. Stalwart would refuse every
// call anyway; this spares the page of refusals.
if (!allowed.length) return <Redirect to="/mail" />;
const current = currentAdminSection(allowed, section)!;
return (
<div className="admin-layout">
<div className="settings-content admin-content">{RENDER[current](section === current ? id : undefined)}</div>
</div>
);
}
+417
View File
@@ -0,0 +1,417 @@
import { useEffect, useMemo, useState } from "react";
import { Copy, Globe, Plus, Trash2, X } from "lucide-react";
import { can } from "@/lib/adminAccess";
import { describeDirectoryError } from "@/lib/adminDirectory";
import {
createDomain,
describeLinked,
destroyDomain,
dkimAlgorithm,
DomainError,
getDomains,
listDkimKeys,
looksLikeDomain,
namesOf,
normaliseDomain,
parseZoneFile,
updateDomain,
type DirectoryDomainFull,
type DkimKey,
type Managed,
} from "@/lib/adminDomains";
import { formatFullDate } from "@/lib/format";
import { plural, t } from "@/lib/i18n";
import { Dialog } from "@/ui/dialog";
import { Spinner, Switch } from "@/ui/misc";
import { toast } from "@/ui/toast";
import { usePermissions } from "./usePermissions";
interface Props {
/** Null to add one. */
id: string | null;
/** How many accounts use it, when the list could count them. */
accountCount?: number;
onClose: () => void;
onChanged: () => void;
onCreated: (id: string) => void;
onDeleted: () => void;
}
export function ManagedLabel({ value }: { value?: Managed }) {
const automatic = value?.["@type"] === "Automatic";
return <span className={`admin-role ${automatic ? "admin" : ""}`}>{automatic ? t("Automatic") : t("By hand")}</span>;
}
const STAGE_LABEL: Record<string, string> = { active: "Signing", pending: "Published, not signing yet", retiring: "Retiring", retired: "Retired" };
const copy = (text: string, done: string) =>
void navigator.clipboard?.writeText(text).then(() => toast.success(done), () => toast.error(t("Could not copy")));
/**
* One domain, beside the list: what it is called, where its mail goes, and the
* records the world needs to see before any of that works.
*
* The DNS records are the part people come here for. Stalwart computes them
* per domain -- MX, SPF, DKIM, DMARC, the service records, MTA-STS -- so they
* are shown one per row, each with its own copy button, because a DNS
* provider's form takes one record at a time.
*/
export function DomainSheet({ id, accountCount, onClose, onChanged, onCreated, onDeleted }: Props) {
const perms = usePermissions();
const creating = id === null;
const editable = creating ? can(perms, "Domain", "Create") : can(perms, "Domain", "Update");
const [domain, setDomain] = useState<DirectoryDomainFull | null>(null);
const [keys, setKeys] = useState<DkimKey[] | null>(null);
const [provider, setProvider] = useState<string | null>(null);
const [loadError, setLoadError] = useState<string | null>(null);
const [name, setName] = useState("");
const [description, setDescription] = useState("");
const [aliases, setAliases] = useState<string[]>([]);
const [catchAll, setCatchAll] = useState("");
const [plus, setPlus] = useState<"Enabled" | "Disabled" | "Custom">("Enabled");
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const [revision, setRevision] = useState(0);
useEffect(() => {
if (!id) return;
let cancelled = false;
void (async () => {
try {
const [d] = await getDomains([id], { zoneFile: true });
if (cancelled) return;
if (!d) {
setLoadError(t("This domain no longer exists. Someone may have removed it."));
return;
}
setDomain(d);
setDescription(d.description ?? "");
setAliases(Object.keys(d.aliases ?? {}));
setCatchAll(d.catchAllAddress ?? "");
setPlus(d.subAddressing?.["@type"] ?? "Enabled");
if (can(perms, "DkimSignature", "Query") && can(perms, "DkimSignature", "Get")) {
void listDkimKeys(id).then((k) => { if (!cancelled) setKeys(k); }, () => { if (!cancelled) setKeys(null); });
}
const serverId = d.dnsManagement?.["@type"] === "Automatic" ? d.dnsManagement.dnsServerId : undefined;
if (serverId && can(perms, "DnsServer", "Get")) {
void namesOf("DnsServer", [serverId]).then((n) => { if (!cancelled) setProvider(n.get(serverId) ?? null); }, () => {});
}
} catch (err) {
if (!cancelled) setLoadError(describeDirectoryError(err, "domain"));
}
})();
return () => {
cancelled = true;
};
}, [id, perms, revision]);
useEffect(() => {
const onKey = (e: KeyboardEvent) => {
if (e.key === "Escape" && !document.querySelector(".dialog-backdrop")) onClose();
};
window.addEventListener("keydown", onKey);
return () => window.removeEventListener("keydown", onKey);
}, [onClose]);
const records = useMemo(() => (domain?.dnsZoneFile ? parseZoneFile(domain.dnsZoneFile) : []), [domain]);
const save = async () => {
setBusy(true);
setError(null);
try {
if (creating) {
if (!looksLikeDomain(name)) {
setError(t("That doesn't look like a domain name, such as example.com."));
return;
}
const newId = await createDomain({ name, description });
toast.success(t("Added {name}. Its DNS records are ready to copy.", { name: normaliseDomain(name) }));
onCreated(newId);
return;
}
if (!domain) return;
const patch: Record<string, unknown> = {};
if ((domain.description ?? "") !== description) patch.description = description.trim() || null;
const nextAliases = [...new Set(aliases.map(normaliseDomain).filter(Boolean))];
if (JSON.stringify(Object.keys(domain.aliases ?? {}).sort()) !== JSON.stringify([...nextAliases].sort())) {
patch.aliases = Object.fromEntries(nextAliases.map((a) => [a, true]));
}
if ((domain.catchAllAddress ?? "") !== catchAll.trim()) patch.catchAllAddress = catchAll.trim() || null;
if ((domain.subAddressing?.["@type"] ?? "Enabled") !== plus && plus !== "Custom") patch.subAddressing = { "@type": plus };
if (!Object.keys(patch).length) {
onClose();
return;
}
await updateDomain(domain.id, patch);
toast.success(t("Saved {name}", { name: domain.name }));
setRevision((n) => n + 1);
onChanged();
} catch (err) {
setError(describeDirectoryError(err, "domain"));
} finally {
setBusy(false);
}
};
const title = creating ? t("Add domain") : (domain?.name ?? "");
return (
<aside className="admin-sheet" aria-label={title}>
<div className="admin-sheet-head">
<span className="avatar" style={{ background: "var(--accent-soft)", color: "var(--accent-soft-fg)" }} aria-hidden="true"><Globe size={18} /></span>
<div className="grow">
<h2 className="truncate notranslate" translate="no">{title}</h2>
{domain?.createdAt && <div className="hint truncate">{t("Added {date}", { date: formatFullDate(domain.createdAt) })}</div>}
</div>
<button className="icon-btn" onClick={onClose} aria-label={t("Close")}>
<X size={20} />
</button>
</div>
<div className="admin-sheet-body">
{loadError ? (
<p className="admin-notice error" role="alert">{loadError}</p>
) : !creating && !domain ? (
<Spinner />
) : (
<>
{domain?.isEnabled === false && <p className="admin-notice warn"><span>{t("This domain is disabled on the server.")}</span></p>}
{!creating && !editable && <p className="admin-notice">{t("Your role lets you view domains but not change them.")}</p>}
{creating && (
<>
<h3>{t("Domain")}</h3>
<div className="field">
<label htmlFor="admin-domain-name">{t("Name")}</label>
<input id="admin-domain-name" className="input notranslate" translate="no" placeholder="example.com" value={name} autoComplete="off" spellCheck={false} onChange={(e) => setName(e.target.value)} />
<span className="hint">{t("New domains sign their mail with DKIM keys the server creates and rotates. Its DNS records appear here once it's added.")}</span>
</div>
</>
)}
<h3>{t("Profile")}</h3>
<div className="field">
<label htmlFor="admin-domain-description">{t("Description")}</label>
<input id="admin-domain-description" className="input" value={description} disabled={!editable} onChange={(e) => setDescription(e.target.value)} />
</div>
{!creating && domain && (
<>
<h3>{t("Other names")}</h3>
<AliasList aliases={aliases} setAliases={setAliases} editable={editable} />
<h3>{t("Delivery")}</h3>
<div className="field">
<label htmlFor="admin-domain-catchall">{t("Catch-all address")}</label>
<input id="admin-domain-catchall" className="input notranslate" translate="no" value={catchAll} disabled={!editable} placeholder={t("None")} spellCheck={false} onChange={(e) => setCatchAll(e.target.value)} />
<span className="hint">{t("Mail to an address nobody has on this domain is delivered here. Leave it empty to refuse that mail.")}</span>
</div>
<Switch
checked={plus !== "Disabled"}
disabled={!editable || plus === "Custom"}
onChange={(on) => setPlus(on ? "Enabled" : "Disabled")}
label={t("Plus addressing")}
hint={plus === "Custom" ? t("Set by a custom rule on the server.") : t("Mail to name+anything@ is delivered to name@.")}
/>
<h3>{t("DNS records")}</h3>
{domain.dnsManagement?.["@type"] === "Automatic" ? (
<p className="hint" style={{ marginTop: 0 }}>
{provider ? t("Published automatically through {provider}.", { provider }) : t("Published automatically by the server.")}
</p>
) : (
<p className="hint" style={{ marginTop: 0 }}>{t("Add these where this domain's DNS is hosted. Mail isn't delivered or trusted until they're in place.")}</p>
)}
{records.length ? (
<>
<div className="admin-dns">
{records.map((r, i) => (
<div className="admin-dns-row" key={i}>
<span className="admin-dns-type">{r.type || "?"}</span>
<div className="grow">
<div className="admin-dns-name notranslate" translate="no">{r.name}</div>
<code className="admin-dns-value notranslate" translate="no">{r.value}</code>
</div>
<button className="icon-btn xs" aria-label={t("Copy {type} record for {name}", { type: r.type, name: r.name })} title={t("Copy value")} onClick={() => copy(r.value, t("Copied"))}>
<Copy size={14} />
</button>
</div>
))}
</div>
<button className="btn btn-sm mt-8" onClick={() => copy(domain.dnsZoneFile ?? "", t("Copied the zone file"))}>
<Copy size={14} /> {t("Copy all as a zone file")}
</button>
</>
) : (
<p className="hint">{t("The server returned no records for this domain.")}</p>
)}
{keys && (
<>
<h3>{t("DKIM keys")}</h3>
<p className="hint" style={{ marginTop: 0 }}>
{domain.dkimManagement?.["@type"] === "Automatic" ? t("The server creates and rotates these keys itself.") : t("These keys are managed by hand on the server.")}
</p>
{keys.length ? (
<table className="sessions-table">
<tbody>
{keys.map((k) => (
<tr key={k.id}>
<td><code className="notranslate" translate="no">{k.selector}</code><div className="hint">{dkimAlgorithm(k["@type"])}</div></td>
<td><span className={`admin-role ${k.stage === "active" ? "admin" : ""}`}>{t(STAGE_LABEL[k.stage ?? "active"] ?? "Signing")}</span></td>
<td className="hint">{k.createdAt ? formatFullDate(k.createdAt) : ""}</td>
</tr>
))}
</tbody>
</table>
) : (
<p className="admin-notice warn"><span>{t("No DKIM keys, so mail from this domain isn't signed and is more likely to be marked as spam.")}</span></p>
)}
</>
)}
<h3>{t("Managed by the server")}</h3>
<dl className="admin-kv">
<dt>{t("DNS records")}</dt><dd><ManagedLabel value={domain.dnsManagement} /></dd>
<dt>{t("DKIM keys")}</dt><dd><ManagedLabel value={domain.dkimManagement} /></dd>
<dt>{t("Certificate")}</dt><dd><ManagedLabel value={domain.certificateManagement} /></dd>
</dl>
</>
)}
{error && <p className="admin-notice error" role="alert">{error}</p>}
{!creating && domain && can(perms, "Domain", "Destroy") && (
<RemoveDomain domain={domain} accountCount={accountCount} keys={keys} canRemoveKeys={can(perms, "DkimSignature", "Destroy")} onDeleted={onDeleted} />
)}
</>
)}
</div>
{editable && !loadError && (creating || domain) && (
<div className="admin-sheet-foot">
<button className="btn btn-ghost" onClick={onClose}>{t("Cancel")}</button>
<button className="btn btn-primary" disabled={busy || (creating && !name.trim())} onClick={() => void save()}>
{creating ? t("Add domain") : t("Save changes")}
</button>
</div>
)}
</aside>
);
}
function AliasList({ aliases, setAliases, editable }: { aliases: string[]; setAliases: (a: string[]) => void; editable: boolean }) {
const [value, setValue] = useState("");
const add = () => {
const name = normaliseDomain(value);
if (!looksLikeDomain(name) || aliases.includes(name)) return;
setAliases([...aliases, name]);
setValue("");
};
return (
<div>
<div className="row wrap gap-4">
{aliases.length ? (
aliases.map((a) => (
<span key={a} className="chip notranslate" translate="no">
{a}
{editable && (
<button className="chip-x" aria-label={t("Remove {address}", { address: a })} onClick={() => setAliases(aliases.filter((x) => x !== a))}>
<X size={12} />
</button>
)}
</span>
))
) : (
<span className="hint">{t("None")}</span>
)}
</div>
{editable && (
<div className="row mt-8">
<input className="input grow notranslate" translate="no" aria-label={t("Another name for this domain")} placeholder="example.net" value={value} spellCheck={false} onChange={(e) => setValue(e.target.value)} onKeyDown={(e) => { if (e.key === "Enter") { e.preventDefault(); add(); } }} />
<button className="btn btn-sm" onClick={add} disabled={!looksLikeDomain(value)}>
<Plus size={14} /> {t("Add")}
</button>
</div>
)}
{editable && <p className="hint">{t("Mail to the same address at any of these names reaches the same account. Changes apply when you save.")}</p>}
</div>
);
}
function RemoveDomain({ domain, accountCount, keys, canRemoveKeys, onDeleted }: {
domain: DirectoryDomainFull;
accountCount?: number;
keys: DkimKey[] | null;
canRemoveKeys: boolean;
onDeleted: () => void;
}) {
const [open, setOpen] = useState(false);
const [typed, setTyped] = useState("");
const [busy, setBusy] = useState(false);
const [error, setError] = useState<string | null>(null);
const keyCount = keys?.length ?? 0;
const blocked = accountCount
? plural(accountCount, { one: "{n} account uses this domain. Move or delete it first.", other: "{n} accounts use this domain. Move or delete them first." })
: keyCount && !canRemoveKeys
? t("Its DKIM keys have to be removed first, and your role can't remove them.")
: null;
return (
<>
<h3>{t("Remove")}</h3>
<div className="admin-danger">
<p>{blocked ?? t("The server stops accepting mail for this domain.")}</p>
<button className="btn btn-sm admin-danger-btn" disabled={!!blocked} onClick={() => { setTyped(""); setError(null); setOpen(true); }}>
<Trash2 size={14} /> {t("Remove domain…")}
</button>
</div>
<Dialog
open={open}
onClose={() => setOpen(false)}
title={t("Remove {name}?", { name: domain.name })}
size="sm"
footer={
<>
<button className="btn" onClick={() => setOpen(false)}>{t("Cancel")}</button>
<button
className="btn btn-danger"
disabled={busy || normaliseDomain(typed) !== domain.name}
onClick={async () => {
setBusy(true);
setError(null);
try {
await destroyDomain(domain.id, canRemoveKeys ? (keys ?? []).map((k) => k.id) : []);
toast.success(t("Removed {name}", { name: domain.name }));
setOpen(false);
onDeleted();
} catch (err) {
setError(
err instanceof DomainError && err.type === "objectIsLinked" && err.linked.length
? t("The server kept the domain: it is still used by {things}.", { things: describeLinked(err.linked) })
: describeDirectoryError(err, "domain"),
);
} finally {
setBusy(false);
}
}}
>
{t("Remove domain")}
</button>
</>
}
>
<p style={{ marginTop: 0 }}>
{keyCount
? plural(keyCount, { one: "The server stops accepting mail for this domain, and its {n} DKIM key is deleted. This can't be undone.", other: "The server stops accepting mail for this domain, and its {n} DKIM keys are deleted. This can't be undone." })
: t("The server stops accepting mail for this domain. This can't be undone.")}
</p>
<div className="field">
<label htmlFor="admin-domain-confirm">{t("Type {address} to confirm", { address: domain.name })}</label>
<input id="admin-domain-confirm" className="input notranslate" translate="no" value={typed} autoComplete="off" spellCheck={false} onChange={(e) => setTyped(e.target.value)} />
</div>
{error && <p className="admin-notice error" role="alert">{error}</p>}
</Dialog>
</>
);
}
+168
View File
@@ -0,0 +1,168 @@
import { useEffect, useState } from "react";
import { useLocation } from "wouter";
import { ChevronLeft, ChevronRight, Globe, Plus, Search } from "lucide-react";
import { can } from "@/lib/adminAccess";
import { describeDirectoryError } from "@/lib/adminDirectory";
import { countAccounts, getDomains, namesOf, queryDomains, type DirectoryDomainFull } from "@/lib/adminDomains";
import { plural, t } from "@/lib/i18n";
import { Empty, Spinner } from "@/ui/misc";
import { usePermissions } from "./usePermissions";
import { DomainSheet, ManagedLabel } from "./DomainSheet";
const PAGE_SIZE = 50;
export function DomainsAdmin({ selectedId }: { selectedId?: string }) {
const [, navigate] = useLocation();
const perms = usePermissions();
const [text, setText] = useState("");
const [query, setQuery] = useState("");
const [position, setPosition] = useState(0);
const [page, setPage] = useState<{ domains: DirectoryDomainFull[]; total: number } | null>(null);
const [counts, setCounts] = useState<Map<string, number>>(new Map());
const [tenants, setTenants] = useState<Map<string, string>>(new Map());
const [error, setError] = useState<string | null>(null);
const [reload, setReload] = useState(0);
useEffect(() => {
const id = window.setTimeout(() => {
setQuery(text);
setPosition(0);
}, 250);
return () => window.clearTimeout(id);
}, [text]);
useEffect(() => {
let cancelled = false;
setError(null);
void (async () => {
try {
const q = await queryDomains({ text: query, position, limit: PAGE_SIZE });
const domains = await getDomains(q.ids);
if (cancelled) return;
setPage({ domains, total: q.total });
// Both are extras on top of the list, and each needs a permission of its own.
if (can(perms, "Account", "Query")) void countAccounts(domains.map((d) => d.id)).then((c) => { if (!cancelled) setCounts(c); });
const tenantIds = [...new Set(domains.map((d) => d.memberTenantId).filter((x): x is string => Boolean(x)))];
if (tenantIds.length && can(perms, "Tenant", "Get")) void namesOf("Tenant", tenantIds).then((n) => { if (!cancelled) setTenants(n); }, () => {});
} catch (err) {
if (!cancelled) {
setPage({ domains: [], total: 0 });
setError(describeDirectoryError(err, "domain"));
}
}
})();
return () => {
cancelled = true;
};
}, [query, position, reload, perms]);
const close = () => navigate("/admin/domains");
const showTenants = tenants.size > 0;
return (
<div>
<div className="admin-head">
<div className="grow">
<h1>{t("Domains")}</h1>
<p className="lead">{t("Where your addresses live, and the DNS records that let mail arrive and be trusted.")}</p>
</div>
{can(perms, "Domain", "Create") && (
<button className="btn btn-primary" onClick={() => navigate("/admin/domains/new")}>
<Plus size={16} /> {t("Add domain")}
</button>
)}
</div>
<div className="admin-toolbar">
<label className="admin-search">
<Search size={16} aria-hidden="true" />
<input className="input" type="search" value={text} onChange={(e) => setText(e.target.value)} placeholder={t("Search domains")} aria-label={t("Search domains")} />
</label>
</div>
{error && <p className="admin-notice error" role="alert">{error}</p>}
{page === null ? (
<Spinner />
) : page.domains.length === 0 ? (
!error && <Empty icon={<Globe size={32} />} title={query ? t("No domains match") : t("No domains yet")} />
) : (
<>
<div className="admin-table-wrap">
<table className="admin-table">
<thead>
<tr>
<th>{t("Domain")}</th>
<th>{t("Accounts")}</th>
<th>{t("DNS records")}</th>
<th className="hide-mobile">{t("DKIM")}</th>
<th className="hide-mobile">{t("Certificate")}</th>
{showTenants && <th className="hide-mobile">{t("Tenant")}</th>}
</tr>
</thead>
<tbody>
{page.domains.map((d) => (
<tr
key={d.id}
className={d.id === selectedId ? "selected" : ""}
tabIndex={0}
onClick={() => navigate(`/admin/domains/${d.id}`)}
onKeyDown={(e) => {
if (e.key === "Enter" || e.key === " ") {
e.preventDefault();
navigate(`/admin/domains/${d.id}`);
}
}}
aria-label={t("Open {address}", { address: d.name })}
>
<td>
<div className="admin-who-name notranslate" translate="no">
{d.name}
{d.isEnabled === false && <span className="badge muted">{t("Disabled")}</span>}
</div>
{Object.keys(d.aliases ?? {}).length > 0 && (
<div className="hint truncate notranslate" translate="no">{t("also {names}", { names: Object.keys(d.aliases ?? {}).join(", ") })}</div>
)}
</td>
<td className="muted" style={{ fontVariantNumeric: "tabular-nums" }}>{counts.has(d.id) ? counts.get(d.id) : "—"}</td>
<td><ManagedLabel value={d.dnsManagement} /></td>
<td className="hide-mobile"><ManagedLabel value={d.dkimManagement} /></td>
<td className="hide-mobile"><ManagedLabel value={d.certificateManagement} /></td>
{showTenants && <td className="hide-mobile muted">{d.memberTenantId ? (tenants.get(d.memberTenantId) ?? "—") : "—"}</td>}
</tr>
))}
</tbody>
</table>
</div>
{page.total <= PAGE_SIZE && position === 0 ? (
<p className="hint admin-count">{plural(page.total, { one: "{n} domain", other: "{n} domains" })}</p>
) : (
<div className="admin-pager">
<span className="hint">{t("{from}{to} of {total}", { from: position + 1, to: position + page.domains.length, total: page.total })}</span>
<button className="icon-btn sm" aria-label={t("Previous page")} disabled={position === 0} onClick={() => setPosition(Math.max(0, position - PAGE_SIZE))}><ChevronLeft size={18} /></button>
<button className="icon-btn sm" aria-label={t("Next page")} disabled={position + page.domains.length >= page.total} onClick={() => setPosition(position + PAGE_SIZE)}><ChevronRight size={18} /></button>
</div>
)}
</>
)}
{selectedId && (
<DomainSheet
key={selectedId}
id={selectedId === "new" ? null : selectedId}
accountCount={selectedId === "new" ? undefined : counts.get(selectedId)}
onClose={close}
onChanged={() => setReload((n) => n + 1)}
onCreated={(id) => {
setReload((n) => n + 1);
navigate(`/admin/domains/${id}`);
}}
onDeleted={() => {
setReload((n) => n + 1);
close();
}}
/>
)}
</div>
);
}
@@ -0,0 +1,94 @@
import { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { Router } from "wouter";
import { memoryLocation } from "wouter/memory-location";
import { useSession } from "@/store/session";
import type { JmapSession } from "@/jmap/types";
import type { DirectoryAccount } from "@/lib/adminDirectory";
import { AccountSheet } from "../AccountSheet";
import type { DirectoryContext } from "../directoryContext";
(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
const HELPDESK = ["sysAccountGet", "sysAccountQuery", "sysAccountUpdate"];
function signIn(permissions: string[], username = "[email protected]") {
useSession.setState({
session: { capabilities: {}, accounts: {}, primaryAccounts: { "urn:stalwart:jmap": "self" }, username, ihasmail: { permissions } } as unknown as JmapSession,
});
}
const account = (over: Partial<DirectoryAccount>): DirectoryAccount => ({
id: "u1",
"@type": "User",
name: "ada",
domainId: "d1",
emailAddress: "[email protected]",
description: "Ada Lovelace",
roles: { "@type": "User" },
credentials: { "0": { "@type": "Password", secret: "[********]" } },
...over,
});
const ctx: DirectoryContext = { domains: [{ id: "d1", name: "example.com" }], roles: null, groups: new Map(), self: { ids: new Set(["self"]), address: "[email protected]" } };
const button = (host: HTMLElement, text: string) => [...host.querySelectorAll("button")].find((b) => b.textContent?.includes(text));
/**
* The guards that stand in for checks Stalwart does not make. A store test
* cannot see these: they are what the sheet renders, and what it leaves out.
*/
describe("the account sheet", () => {
let host: HTMLDivElement;
let root: Root;
const render = async (a: DirectoryAccount) => {
const { hook } = memoryLocation({ path: `/admin/accounts/${a.id}` });
await act(async () => {
root.render(
<Router hook={hook}>
<AccountSheet account={a} ctx={ctx} onClose={() => {}} onChanged={() => {}} onCreated={() => {}} onDeleted={() => {}} />
</Router>,
);
});
};
beforeEach(() => {
host = document.createElement("div");
document.body.appendChild(host);
root = createRoot(host);
});
afterEach(async () => {
await act(async () => root.unmount());
host.remove();
});
it("shows an account that outranks the viewer read-only, password included", async () => {
signIn(HELPDESK);
await render(account({ roles: { "@type": "Admin" } }));
expect(host.textContent).toContain("permissions yours doesn't");
expect(button(host, "Set a new password")?.disabled).toBe(true);
expect((host.querySelector("#admin-description") as HTMLInputElement).disabled).toBe(true);
expect(host.textContent).not.toContain("Save changes");
});
it("lets the same viewer edit an ordinary account, but not delete it", async () => {
signIn(HELPDESK);
await render(account({}));
expect(button(host, "Set a new password")?.disabled).toBe(false);
expect(host.textContent).toContain("Save changes");
expect(host.textContent).not.toContain("Delete account");
});
it("sends your own password to Settings, and keeps your role and account out of reach", async () => {
signIn([...HELPDESK, "sysAccountDestroy"]);
await render(account({ id: "self", emailAddress: "[email protected]" }));
expect(host.textContent).toContain("Change your own password in");
expect(host.querySelector('a[href="/settings/security"]')).not.toBeNull();
expect(button(host, "Set a new password")).toBeUndefined();
expect((host.querySelector('select[aria-label="Role"]') as HTMLSelectElement).disabled).toBe(true);
expect(button(host, "Delete account")?.disabled).toBe(true);
});
});
@@ -0,0 +1,54 @@
import { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it } from "vitest";
import { Router } from "wouter";
import { memoryLocation } from "wouter/memory-location";
import { useSession } from "@/store/session";
import type { JmapSession } from "@/jmap/types";
import { AdminNav } from "../AdminNav";
(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
const signIn = (permissions: string[]) =>
useSession.setState({ session: { capabilities: {}, accounts: {}, primaryAccounts: {}, username: "[email protected]", ihasmail: { permissions } } as unknown as JmapSession });
/** The folder pane's list of Administration sections: only what the role can read. */
describe("the Administration list in the folder pane", () => {
let host: HTMLDivElement;
let root: Root;
const render = async (path: string) => {
const { hook } = memoryLocation({ path });
await act(async () => {
root.render(<Router hook={hook}><AdminNav /></Router>);
});
};
beforeEach(() => {
host = document.createElement("div");
document.body.appendChild(host);
root = createRoot(host);
});
afterEach(async () => {
await act(async () => root.unmount());
host.remove();
});
it("lists each readable section under its group and marks the open one", async () => {
signIn(["sysAccountQuery", "sysAccountGet", "sysDomainQuery", "sysDomainGet"]);
await render("/admin/domains/d1");
expect([...host.querySelectorAll(".nav-section")].map((e) => e.textContent)).toEqual(["Directory", "Mail"]);
expect(host.querySelector(".nav-item.active")?.textContent).toBe("Domains");
});
it("treats a bare /admin as the first section, which is what the page opens", async () => {
signIn(["sysAccountQuery", "sysAccountGet", "sysDomainQuery", "sysDomainGet"]);
await render("/admin");
expect(host.querySelector(".nav-item.active")?.textContent).toBe("Accounts");
});
it("leaves out what the role cannot read", async () => {
signIn(["sysDomainQuery", "sysDomainGet"]);
await render("/admin");
expect(host.textContent).not.toContain("Accounts");
expect(host.querySelector(".nav-item.active")?.textContent).toBe("Domains");
});
});
@@ -0,0 +1,85 @@
import { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { useSession } from "@/store/session";
import type { JmapSession } from "@/jmap/types";
(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
const domain = {
id: "d1",
name: "example.com",
aliases: {},
subAddressing: { "@type": "Custom" },
dnsManagement: { "@type": "Manual" },
dkimManagement: { "@type": "Automatic" },
certificateManagement: { "@type": "Manual" },
dnsZoneFile: 'example.com. IN MX 10 mail.example.com.\nexample.com. IN TXT "v=spf1 mx -all"\n',
};
vi.mock("@/lib/adminDomains", async (original) => ({
...(await original<typeof import("@/lib/adminDomains")>()),
getDomains: vi.fn(async () => [domain]),
listDkimKeys: vi.fn(async () => [{ id: "k1", "@type": "Dkim1Ed25519Sha256", selector: "v1-ed25519", stage: "active" }]),
}));
const { DomainSheet } = await import("../DomainSheet");
const signIn = (permissions: string[]) =>
useSession.setState({ session: { capabilities: {}, accounts: {}, primaryAccounts: {}, username: "[email protected]", ihasmail: { permissions } } as unknown as JmapSession });
const button = (host: HTMLElement, text: string) => [...host.querySelectorAll("button")].find((b) => b.textContent?.includes(text));
/**
* What decides whether a domain can be removed is not the button but what
* still uses it, and some of that is the domain's own keys.
*/
describe("the domain sheet", () => {
let host: HTMLDivElement;
let root: Root;
const render = async (accountCount: number | undefined) => {
await act(async () => {
root.render(<DomainSheet id="d1" accountCount={accountCount} onClose={() => {}} onChanged={() => {}} onCreated={() => {}} onDeleted={() => {}} />);
});
await act(async () => {});
};
beforeEach(() => {
host = document.createElement("div");
document.body.appendChild(host);
root = createRoot(host);
});
afterEach(async () => {
await act(async () => root.unmount());
host.remove();
});
it("lists the records one per row, unquoted", async () => {
signIn(["sysDomainGet", "sysDomainQuery"]);
await render(0);
expect(host.querySelectorAll(".admin-dns-row").length).toBe(2);
expect(host.textContent).toContain("v=spf1 mx -all");
expect(host.textContent).not.toContain('"v=spf1');
});
it("will not offer removal while accounts use the domain", async () => {
signIn(["sysDomainGet", "sysDomainQuery", "sysDomainDestroy", "sysDkimSignatureQuery", "sysDkimSignatureGet", "sysDkimSignatureDestroy"]);
await render(3);
expect(host.textContent).toContain("3 accounts use this domain");
expect(button(host, "Remove domain")?.disabled).toBe(true);
});
it("will not offer removal when the keys that must go first cannot be removed", async () => {
signIn(["sysDomainGet", "sysDomainQuery", "sysDomainDestroy", "sysDkimSignatureQuery", "sysDkimSignatureGet"]);
await render(0);
expect(host.textContent).toContain("your role can't remove them");
expect(button(host, "Remove domain")?.disabled).toBe(true);
});
it("leaves a plus-addressing rule set on the server alone", async () => {
signIn(["sysDomainGet", "sysDomainQuery", "sysDomainUpdate"]);
await render(0);
expect(host.textContent).toContain("Set by a custom rule on the server.");
expect((host.querySelector('button[role="switch"]') as HTMLButtonElement).disabled).toBe(true);
});
});
+25
View File
@@ -0,0 +1,25 @@
import type { RoleDef } from "@/lib/adminAccess";
import type { DirectoryAccount, DirectoryDomain } from "@/lib/adminDirectory";
import { t } from "@/lib/i18n";
export interface DirectoryContext {
/** Domains to offer. Read from the server when allowed, else seen on accounts. */
domains: DirectoryDomain[];
/** Null when the viewer cannot read roles, which `outranks` treats as unknown. */
roles: Map<string, RoleDef> | null;
groups: Map<string, DirectoryAccount>;
/** Registry ids and addresses that are the signed-in account itself. */
self: { ids: Set<string>; address: string };
}
export function isSelf(a: Pick<DirectoryAccount, "id" | "emailAddress">, ctx: DirectoryContext): boolean {
return ctx.self.ids.has(a.id) || (!!a.emailAddress && a.emailAddress.toLowerCase() === ctx.self.address);
}
export function roleName(a: Pick<DirectoryAccount, "roles">, roles: Map<string, RoleDef> | null): string {
const r = a.roles;
if (!r || r["@type"] === "User") return t("User");
if (r["@type"] === "Admin") return t("Administrator");
const names = Object.keys(r.roleIds ?? {}).map((id) => roles?.get(id)?.description).filter(Boolean);
return names.length ? names.join(", ") : t("Custom role");
}
+17
View File
@@ -0,0 +1,17 @@
import { useMemo } from "react";
import { useSession } from "@/store/session";
import { permissionSet, type Permissions } from "@/lib/adminAccess";
/**
* The signed-in account's permissions, as a set, stable between renders.
*
* Keyed on the contents, not the array. The session is fetched again whenever
* a response carries a different session state, and each fetch brings a new
* array with the same names in it; a set rebuilt from identity would re-run
* everything that depends on it, whose requests could bring another refresh.
*/
export function usePermissions(): Permissions {
// An installation with administration off sends none; this is belt and braces.
const key = useSession((s) => (s.session?.ihasmail?.administration === false ? "" : (s.session?.ihasmail?.permissions ?? []).join(",")));
return useMemo(() => permissionSet(key ? key.split(",") : []), [key]);
}
+11 -8
View File
@@ -65,16 +65,19 @@ export function CalendarSidebar() {
const calendarId = importInto.current; const calendarId = importInto.current;
if (!calendarId) return; if (!calendarId) return;
try { try {
const { created, skipped } = await cal.importIcs(await file.text(), calendarId); const { created, updated } = await cal.importIcs(await file.text(), calendarId);
/* /*
* The two counts are kept apart on purpose. "Imported 40 events" over a * The two counts are kept apart on purpose, the way the contacts import
* file of 240 reads as a failure when 200 of them were simply already * keeps them. "Imported 40 events" over a file of 240 reads as a failure
* here, and a re-import where everything is already here would otherwise * when the other 200 were updated, and a re-import of a corrected export
* report importing nothing at all. * -- the reason for doing this at all -- creates nothing and would
* otherwise report importing nothing at all.
*/ */
if (!created) toast.success(plural(skipped, { one: "Already here: {n} event, nothing imported", other: "Already here: {n} events, nothing imported" })); const imported = plural(created, { one: "Imported {n} event", other: "Imported {n} events" });
else if (skipped) toast.success(`${plural(created, { one: "Imported {n} event", other: "Imported {n} events" })} · ${plural(skipped, { one: "{n} was already here", other: "{n} were already here" })}`); const refreshed = plural(updated, { one: "{n} updated", other: "{n} updated" });
else toast.success(plural(created, { one: "Imported {n} event", other: "Imported {n} events" })); if (!created) toast.success(plural(updated, { one: "Updated {n} event, nothing new", other: "Updated {n} events, nothing new" }));
else if (updated) toast.success(`${imported} · ${refreshed}`);
else toast.success(imported);
} catch (err) { } catch (err) {
toast.error(t("Could not import this file: {error}", { error: (err as Error).message })); toast.error(t("Could not import this file: {error}", { error: (err as Error).message }));
} }
+3 -1
View File
@@ -9,8 +9,10 @@ export function ComposerDock() {
if (!drafts.length) return null; if (!drafts.length) return null;
// On mobile only the active composer is shown (full screen); others are minimized bars. // On mobile only the active composer is shown (full screen); others are minimized bars.
const visible = isMobile ? drafts.filter((d) => d.key === activeKey || d.minimized) : drafts; const visible = isMobile ? drafts.filter((d) => d.key === activeKey || d.minimized) : drafts;
// On desktop a full-screen composer stands alone: the rest are hidden until it is restored.
const hasMaximized = !isMobile && drafts.some((d) => d.maximized && !d.minimized);
return ( return (
<div className="composer-dock"> <div className={`composer-dock${hasMaximized ? " has-maximized" : ""}`}>
{visible.map((d) => ( {visible.map((d) => (
<Composer key={d.key} draft={isMobile && d.key !== activeKey ? { ...d, minimized: true } : d} /> <Composer key={d.key} draft={isMobile && d.key !== activeKey ? { ...d, minimized: true } : d} />
))} ))}
@@ -0,0 +1,76 @@
import { act } from "react";
import { createRoot, type Root } from "react-dom/client";
import { afterEach, beforeEach, describe, expect, it, vi } from "vitest";
import { useCompose, type Draft } from "@/store/compose";
import { ComposerDock } from "../ComposerDock";
(globalThis as { IS_REACT_ACT_ENVIRONMENT?: boolean }).IS_REACT_ACT_ENVIRONMENT = true;
// The question is which composers the dock puts on screen, not what is inside
// them, so each composer is a bare marker carrying the state it was given.
vi.mock("../Composer", () => ({
Composer: ({ draft }: { draft: Draft }) => (
<div className={`composer ${draft.maximized ? "maximized" : ""} ${draft.minimized ? "minimized" : ""}`} data-key={draft.key} />
),
}));
/* jsdom has no matchMedia; each test says which side of the 768px breakpoint it stands at. */
function setWidth(px: number) {
window.matchMedia = ((q: string) => ({
matches: /max-width:\s*(\d+)px/.test(q) ? px <= Number(RegExp.$1) : false,
media: q,
addEventListener() {},
removeEventListener() {},
})) as unknown as typeof window.matchMedia;
}
const draft = (key: string, init: Partial<Draft> = {}) => ({ key, minimized: false, maximized: false, ...init }) as Draft;
describe("ComposerDock with a full-screen composer", () => {
let host: HTMLDivElement;
let root: Root;
beforeEach(() => {
host = document.createElement("div");
document.body.appendChild(host);
root = createRoot(host);
});
afterEach(() => {
act(() => root.unmount());
host.remove();
useCompose.setState({ drafts: [], activeKey: null });
});
const render = (drafts: Draft[], activeKey: string) => {
useCompose.setState({ drafts, activeKey });
act(() => root.render(<ComposerDock />));
};
const dock = () => host.querySelector(".composer-dock")!;
it("marks the dock so the other composers are hidden behind it", () => {
setWidth(1300);
render([draft("a"), draft("b", { maximized: true }), draft("c")], "b");
expect(dock().classList.contains("has-maximized")).toBe(true);
// Every composer stays mounted: the hiding is the stylesheet's, so nothing being typed elsewhere is lost.
expect(host.querySelectorAll(".composer").length).toBe(3);
});
it("leaves the dock alone while nobody is full screen", () => {
setWidth(1300);
render([draft("a"), draft("b")], "b");
expect(dock().classList.contains("has-maximized")).toBe(false);
});
it("does not count a full-screen composer that has since been minimised", () => {
setWidth(1300);
render([draft("a"), draft("b", { maximized: true, minimized: true })], "a");
expect(dock().classList.contains("has-maximized")).toBe(false);
});
it("is not a phone concern: there the active composer is already the only one open", () => {
setWidth(400);
render([draft("a"), draft("b", { maximized: true })], "b");
expect(dock().classList.contains("has-maximized")).toBe(false);
});
});
+54 -8
View File
@@ -107,15 +107,40 @@ export function MailView({ mailboxId, threadId, search }: { mailboxId?: string;
if (mailboxesLoaded && mailboxId && mailboxId === scheduledId) void reconcile(); if (mailboxesLoaded && mailboxId && mailboxId === scheduledId) void reconcile();
}, [mailboxId, scheduledId, mailboxesLoaded, reconcile]); }, [mailboxId, scheduledId, mailboxesLoaded, reconcile]);
/*
* With conversation view off, a row is a message rather than a thread, and
* opening one must show that message and highlight that row -- not its whole
* thread and every sibling row in the list.
*
* The thread id stays in the path, so loading is unchanged; the message rides
* in `m`. Putting it in the URL rather than in memory is what makes a reload
* or a shared link land back on the same message, and dropping the parameter
* degrades to the conversation, which is the right thing for a link sent to
* somebody whose setting differs.
*/
const openThread = useCallback( const openThread = useCallback(
(tid: Id | null) => { (tid: Id | null, messageId?: Id | null) => {
const base = search ? `/search` : `/mail/${mailboxId}`; const base = search ? `/search` : `/mail/${mailboxId}`;
const qs = search ? `?q=${encodeURIComponent(q)}` : ""; const params = new URLSearchParams();
if (search) params.set("q", q);
if (tid && messageId) params.set("m", messageId);
const qs = params.size ? `?${params}` : "";
navigate(tid ? `${base}/${tid}${qs}` : `${base}${qs}`); navigate(tid ? `${base}/${tid}${qs}` : `${base}${qs}`);
}, },
[navigate, search, mailboxId, q], [navigate, search, mailboxId, q],
); );
/**
* The message the URL singles out, if any. Only meaningful with conversation
* view off; ThreadView decides what to do when the id names nothing in the
* thread, since it is the part that knows what the thread holds.
*/
const openMessageId = useMemo(() => {
if (settings.conversationMode) return null;
const m = new URLSearchParams(searchStr).get("m");
return m || null;
}, [settings.conversationMode, searchStr]);
// Row ids in list + helpers for keyboard nav // Row ids in list + helpers for keyboard nav
const ids = list?.ids ?? []; const ids = list?.ids ?? [];
const emails = useMail((s) => s.emails); const emails = useMail((s) => s.emails);
@@ -129,9 +154,17 @@ export function MailView({ mailboxId, threadId, search }: { mailboxId?: string;
const i = ids.indexOf(focusId); const i = ids.indexOf(focusId);
if (i >= 0) return i; if (i >= 0) return i;
} }
// A cold load has no focus yet. With conversation view off the URL names the
// row exactly; matching on the thread instead would land on whichever of its
// messages sorts first, so j/k and the scroll-into-view would start from the
// wrong row on any thread with more than one message in the folder.
if (openMessageId) {
const i = ids.indexOf(openMessageId);
if (i >= 0) return i;
}
if (threadId) return ids.findIndex((id) => rowThreadId(id) === threadId); if (threadId) return ids.findIndex((id) => rowThreadId(id) === threadId);
return -1; return -1;
}, [ids, focusId, threadId, rowThreadId]); }, [ids, focusId, openMessageId, threadId, rowThreadId]);
/** Email ids affected by an action on rows (selection or focused/open row). */ /** Email ids affected by an action on rows (selection or focused/open row). */
const targetIds = useCallback( const targetIds = useCallback(
@@ -339,9 +372,9 @@ export function MailView({ mailboxId, threadId, search }: { mailboxId?: string;
void openDraft(e); void openDraft(e);
return; return;
} }
openThread(e.threadId); openThread(e.threadId, settings.conversationMode ? null : rowId);
}, },
[emails, mailboxId, mailboxes, openThread, openDraft], [emails, mailboxId, mailboxes, openThread, openDraft, settings.conversationMode],
); );
const title = search ? translate("Search: {query}", { query: listQuery?.label ?? q }) : (mailboxId && mailboxDisplayName(mailboxes[mailboxId])) || translate("Mail"); const title = search ? translate("Search: {query}", { query: listQuery?.label ?? q }) : (mailboxId && mailboxDisplayName(mailboxes[mailboxId])) || translate("Mail");
@@ -373,6 +406,7 @@ export function MailView({ mailboxId, threadId, search }: { mailboxId?: string;
title={title} title={title}
list={list} list={list}
openThreadId={threadId ?? null} openThreadId={threadId ?? null}
openMessageId={openMessageId}
focusId={focusId} focusId={focusId}
setFocusId={setFocusId} setFocusId={setFocusId}
onOpen={onOpenRow} onOpen={onOpenRow}
@@ -387,12 +421,24 @@ export function MailView({ mailboxId, threadId, search }: { mailboxId?: string;
{showReading && ( {showReading && (
<div className="mail-reading-pane"> <div className="mail-reading-pane">
{threadId ? ( {threadId ? (
<ThreadView key={threadId} threadId={threadId} mailboxId={mailboxId ?? null} onBack={() => openThread(null)} actions={actions} onNavigate={(delta) => { const idx = currentRowIndex; const next = ids[idx + delta]; const t = next ? rowThreadId(next) : undefined; if (t) { setFocusId(next!); openThread(t); } }} hasPrev={currentRowIndex > 0} hasNext={currentRowIndex >= 0 && currentRowIndex < ids.length - 1} /> <ThreadView key={`${threadId}:${openMessageId ?? ""}`} threadId={threadId} messageId={openMessageId} mailboxId={mailboxId ?? null} onBack={() => openThread(null)} actions={actions} onNavigate={(delta) => { const idx = currentRowIndex; const next = ids[idx + delta]; const t = next ? rowThreadId(next) : undefined; if (t) { setFocusId(next!); openThread(t, settings.conversationMode ? null : next!); } }} hasPrev={currentRowIndex > 0} hasNext={currentRowIndex >= 0 && currentRowIndex < ids.length - 1} />
) : ( ) : (
<div className="no-thread"> <div className="no-thread">
<img src={withBase("/img/logo.png")} alt="" /> <img src={withBase("/img/logo.png")} alt="" />
<div>{list?.total ? plural(list.total, { one: "{n} conversation", other: "{n} conversations" }) : translate("No conversation selected")}</div> <div>
<div className="hint">{tNode("Select a conversation to read it here · Press {key} for shortcuts", { key: <kbd className="kbd">?</kbd> })}</div> {list?.total
? settings.conversationMode
? plural(list.total, { one: "{n} conversation", other: "{n} conversations" })
: plural(list.total, { one: "{n} message", other: "{n} messages" })
: settings.conversationMode
? translate("No conversation selected")
: translate("No message selected")}
</div>
<div className="hint">
{settings.conversationMode
? tNode("Select a conversation to read it here · Press {key} for shortcuts", { key: <kbd className="kbd">?</kbd> })
: tNode("Select a message to read it here · Press {key} for shortcuts", { key: <kbd className="kbd">?</kbd> })}
</div>
</div> </div>
)} )}
</div> </div>
+9 -2
View File
@@ -9,6 +9,7 @@ import { formatListDate } from "@/lib/format";
import { mailboxDisplayName } from "@/lib/mailboxName"; import { mailboxDisplayName } from "@/lib/mailboxName";
import { groupByArchivePath, archivePath, type ArchiveGranularity } from "@/lib/archiveDate"; import { groupByArchivePath, archivePath, type ArchiveGranularity } from "@/lib/archiveDate";
import { canEmpty, confirmAndEmpty, emptyLabel } from "@/lib/emptyFolder"; import { canEmpty, confirmAndEmpty, emptyLabel } from "@/lib/emptyFolder";
import { rowIsOpen } from "@/lib/openMessage";
import { displayName, shortName } from "@/lib/address"; import { displayName, shortName } from "@/lib/address";
import { Avatar, Empty, useIsMobile, useIsTouch } from "@/ui/misc"; import { Avatar, Empty, useIsMobile, useIsTouch } from "@/ui/misc";
import { rowClick } from "@/lib/listSelection"; import { rowClick } from "@/lib/listSelection";
@@ -53,6 +54,12 @@ interface Props {
title: string; title: string;
list: ListState | null; list: ListState | null;
openThreadId: Id | null; openThreadId: Id | null;
/**
* With conversation view off, the one message the reading pane is showing.
* The row highlight follows this instead of the thread, or every message in
* a thread lights up when one of them is opened.
*/
openMessageId: Id | null;
focusId: Id | null; focusId: Id | null;
setFocusId: (id: Id | null) => void; setFocusId: (id: Id | null) => void;
onOpen: (rowId: Id) => void; onOpen: (rowId: Id) => void;
@@ -61,7 +68,7 @@ interface Props {
isSearch: boolean; isSearch: boolean;
} }
export function MessageList({ title, list, openThreadId, focusId, setFocusId, onOpen, actions, mailboxId, isSearch }: Props) { export function MessageList({ title, list, openThreadId, openMessageId, focusId, setFocusId, onOpen, actions, mailboxId, isSearch }: Props) {
const [, navigate] = useLocation(); const [, navigate] = useLocation();
const emails = useMail((s) => s.emails); const emails = useMail((s) => s.emails);
const threads = useMail((s) => s.threads); const threads = useMail((s) => s.threads);
@@ -485,7 +492,7 @@ export function MessageList({ title, list, openThreadId, focusId, setFocusId, on
height={vi.size} height={vi.size}
selected={Boolean(selected[id])} selected={Boolean(selected[id])}
focused={focusId === id} focused={focusId === id}
open={openThreadId === e.threadId} open={rowIsOpen(id, e.threadId, openMessageId, openThreadId)}
twoLine={twoLine} twoLine={twoLine}
showAvatar={settings.showAvatars} showAvatar={settings.showAvatars}
showPreview={settings.showPreview} showPreview={settings.showPreview}
+60 -6
View File
@@ -1,5 +1,5 @@
import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react"; import { memo, useCallback, useEffect, useMemo, useRef, useState } from "react";
import { ChevronDown, ChevronUp, Download, ExternalLink, Forward, MailPlus, MoreVertical, Printer, Reply, ReplyAll, Star, Trash2, Code, FileText, Image as ImageIcon, File, Eye, Calendar, CalendarPlus, UserPlus, ShieldAlert, Mail, Ban, Clock, CheckCheck, Paperclip, FileArchive, FileSpreadsheet, Film, Music, Filter } from "lucide-react"; import { ChevronDown, ChevronUp, Download, ExternalLink, Forward, MailPlus, MoreVertical, Printer, Reply, ReplyAll, Star, Trash2, Code, FileText, Image as ImageIcon, File as FileIcon, Eye, Calendar, CalendarPlus, UserPlus, ShieldAlert, Mail, Ban, Clock, CheckCheck, Paperclip, FileArchive, FileSpreadsheet, Film, Music, Filter, Share2 } from "lucide-react";
import { useLocation } from "wouter"; import { useLocation } from "wouter";
import { FilterFromMessageDialog } from "./FilterFromMessage"; import { FilterFromMessageDialog } from "./FilterFromMessage";
import type { Email, EmailAddress, EmailBodyPart, Id } from "@/jmap/types"; import type { Email, EmailAddress, EmailBodyPart, Id } from "@/jmap/types";
@@ -18,10 +18,11 @@ import { internalDomains, isExternalSender, linkVerdict } from "@/lib/warnings";
import { spamReport, type SpamReport } from "@/lib/spamScore"; import { spamReport, type SpamReport } from "@/lib/spamScore";
import { formatFullDate, formatListDate, formatSize } from "@/lib/format"; import { formatFullDate, formatListDate, formatSize } from "@/lib/format";
import { displayName, domainOf, formatAddress } from "@/lib/address"; import { displayName, domainOf, formatAddress } from "@/lib/address";
import { EMAIL_BASE_CSS, TEXT_EMAIL_CSS, htmlDeclaresColors, markKeptSurfaces, sanitizeEmailHtml } from "@/lib/html"; import { EMAIL_BASE_CSS, TEXT_EMAIL_CSS, hasHtmlAlternative, htmlDeclaresColors, markKeptSurfaces, sanitizeEmailHtml } from "@/lib/html";
import { openableInTab, previewKind } from "@/lib/preview"; import { openableInTab, previewKind } from "@/lib/preview";
import { FilePreviewDialog } from "@/ui/filepreview"; import { FilePreviewDialog } from "@/ui/filepreview";
import { findQuoteStart, textToHtml } from "@/lib/text"; import { findQuoteStart, htmlToText, textToHtml } from "@/lib/text";
import { canShare, canShareFiles, shareFile, shareText } from "@/lib/share";
import { Avatar } from "@/ui/misc"; import { Avatar } from "@/ui/misc";
import { MenuItem, MenuSep, Popover, useMenu } from "@/ui/popover"; import { MenuItem, MenuSep, Popover, useMenu } from "@/ui/popover";
import { Dialog, choiceDialog} from "@/ui/dialog"; import { Dialog, choiceDialog} from "@/ui/dialog";
@@ -35,7 +36,7 @@ import { useScheduled } from "@/store/scheduled";
import { formatScheduleTime } from "@/lib/schedule"; import { formatScheduleTime } from "@/lib/schedule";
import { mdnDecision, refusalText } from "@/lib/mdn"; import { mdnDecision, refusalText } from "@/lib/mdn";
import { sendReadReceipt } from "@/store/mdn"; import { sendReadReceipt } from "@/store/mdn";
import { t as translate, tNode } from "@/lib/i18n"; import { t as translate, tc, tNode } from "@/lib/i18n";
interface Props { interface Props {
email: Email; email: Email;
@@ -136,7 +137,9 @@ export const MessageView = memo(function MessageView({ email: e, expanded, wasUn
const textPart = e.textBody?.[0]; const textPart = e.textBody?.[0];
const htmlRaw = htmlPart?.partId ? e.bodyValues?.[htmlPart.partId]?.value : undefined; const htmlRaw = htmlPart?.partId ? e.bodyValues?.[htmlPart.partId]?.value : undefined;
const textRaw = textPart?.partId ? e.bodyValues?.[textPart.partId]?.value : undefined; const textRaw = textPart?.partId ? e.bodyValues?.[textPart.partId]?.value : undefined;
const showHtml = Boolean(htmlRaw); // Not `Boolean(htmlRaw)`: `htmlBody` carries the text part when there is no
// HTML alternative. See hasHtmlAlternative().
const showHtml = hasHtmlAlternative(htmlPart, htmlRaw);
const themeMessageBody = settings.themeMessageBody; const themeMessageBody = settings.themeMessageBody;
const themeStyledMessages = settings.themeStyledMessages; const themeStyledMessages = settings.themeStyledMessages;
@@ -211,6 +214,25 @@ export const MessageView = memo(function MessageView({ email: e, expanded, wasUn
a.click(); a.click();
}; };
/*
* Pass the message itself to another app -- the reply that has to go to
* somebody who is not on mail, the address read out over a chat.
*
* Text rather than the `.eml` above, and the difference is who the other end
* is. A message file is for another mail client; a share sheet is aimed at
* everything that is not one, and handing WhatsApp an `.eml` gives it an
* attachment nobody can open. So the plain-text body goes, falling back to
* the HTML flattened, which is the same body the sender wrote either way.
*/
const shareMessage = async () => {
const body = textRaw ?? (htmlRaw ? htmlToText(htmlRaw) : "");
try {
await shareText({ title: e.subject || translate("(no subject)"), text: body });
} catch (err) {
toast.error(translate("Could not share: {error}", { error: (err as Error).message }));
}
};
const onUnsubscribe = async () => { const onUnsubscribe = async () => {
if (!unsubscribe) return; if (!unsubscribe) return;
const urls = [...unsubscribe.matchAll(/<([^>]+)>/g)].map((m) => m[1]!); const urls = [...unsubscribe.matchAll(/<([^>]+)>/g)].map((m) => m[1]!);
@@ -322,6 +344,7 @@ export const MessageView = memo(function MessageView({ email: e, expanded, wasUn
<MenuItem icon={<Eye size={16} />} label={translate("Show original")} onClick={() => void openSource()} /> <MenuItem icon={<Eye size={16} />} label={translate("Show original")} onClick={() => void openSource()} />
<MenuItem icon={<Code size={16} />} label={translate("Show headers")} onClick={() => setShowHeaders(true)} /> <MenuItem icon={<Code size={16} />} label={translate("Show headers")} onClick={() => setShowHeaders(true)} />
<MenuItem icon={<Download size={16} />} label={translate("Download (.eml)")} onClick={downloadEml} /> <MenuItem icon={<Download size={16} />} label={translate("Download (.eml)")} onClick={downloadEml} />
{canShare() && <MenuItem icon={<Share2 size={16} />} label={tc("share sheet", "Share…")} onClick={() => void shareMessage()} />}
<MenuItem icon={<Printer size={16} />} label={translate("Print")} onClick={printThis} /> <MenuItem icon={<Printer size={16} />} label={translate("Print")} onClick={printThis} />
<MenuItem icon={<Filter size={16} />} label={translate("Filter messages like this…")} onClick={() => setFilterOpen(true)} /> <MenuItem icon={<Filter size={16} />} label={translate("Filter messages like this…")} onClick={() => setFilterOpen(true)} />
{hasCalendar && <MenuItem icon={<CalendarPlus size={16} />} label={translate("Create event…")} onClick={() => void startAppointment(e, navigate).catch((err: unknown) => toast.error((err as Error).message))} />} {hasCalendar && <MenuItem icon={<CalendarPlus size={16} />} label={translate("Create event…")} onClick={() => void startAppointment(e, navigate).catch((err: unknown) => toast.error((err as Error).message))} />}
@@ -743,7 +766,7 @@ export function attachmentIcon(type: string, name?: string | null) {
if (t === "text/calendar") return <Calendar size={18} />; if (t === "text/calendar") return <Calendar size={18} />;
if (t.includes("vcard")) return <UserPlus size={18} />; if (t.includes("vcard")) return <UserPlus size={18} />;
if (t.startsWith("text/") || /word|document/.test(t)) return <FileText size={18} />; if (t.startsWith("text/") || /word|document/.test(t)) return <FileText size={18} />;
return <File size={18} />; return <FileIcon size={18} />;
} }
/** /**
@@ -822,6 +845,36 @@ function TnefContents({ part, accountId }: { part: EmailBodyPart; accountId: Id
function AttachmentList({ attachments, accountId, email }: { attachments: EmailBodyPart[]; accountId: Id; email: Email }) { function AttachmentList({ attachments, accountId, email }: { attachments: EmailBodyPart[]; accountId: Id; email: Email }) {
const [preview, setPreview] = useState<EmailBodyPart | null>(null); const [preview, setPreview] = useState<EmailBodyPart | null>(null);
/*
* The same share the preview dialog offers, on the row itself.
*
* Both are wanted: a photo is opened and then passed on, but a spreadsheet
* cannot be previewed at all and passing it on is the only thing anybody
* wants to do with it from a phone.
*
* Falls back to the download it sits beside where the browser turns out not
* to take the file -- see the note on `shareFile`, which is where the
* transient-activation case is explained.
*/
const shareAttachment = async (a: EmailBodyPart) => {
if (!a.blobId) return;
const name = a.name ?? "attachment";
const download = () => {
const l = document.createElement("a");
l.href = client.downloadUrl(accountId, a.blobId!, name, a.type);
l.download = name;
l.click();
};
try {
const blob = await client.fetchBlob(accountId, a.blobId, a.type);
const out = await shareFile(new File([blob], name, { type: a.type || blob.type || "application/octet-stream" }));
if (out === "unsupported") download();
} catch {
download();
}
};
/* Whether we can show it, and whether the server will serve it inline, are /* Whether we can show it, and whether the server will serve it inline, are
different questions -- see the note in lib/preview.ts. */ different questions -- see the note in lib/preview.ts. */
const viewable = (a: EmailBodyPart) => Boolean(a.blobId) && previewKind(a.type, a.name) !== null; const viewable = (a: EmailBodyPart) => Boolean(a.blobId) && previewKind(a.type, a.name) !== null;
@@ -842,6 +895,7 @@ function AttachmentList({ attachments, accountId, email }: { attachments: EmailB
<span className="att-size">{formatSize(a.size)}</span> <span className="att-size">{formatSize(a.size)}</span>
<span className="att-actions"> <span className="att-actions">
<button className="icon-btn xs" title={translate("Download")} onClick={(ev) => { ev.preventDefault(); ev.stopPropagation(); const l = document.createElement("a"); l.href = url; l.download = a.name ?? ""; l.click(); }}><Download size={14} /></button> <button className="icon-btn xs" title={translate("Download")} onClick={(ev) => { ev.preventDefault(); ev.stopPropagation(); const l = document.createElement("a"); l.href = url; l.download = a.name ?? ""; l.click(); }}><Download size={14} /></button>
{canShareFiles() && a.blobId && <button className="icon-btn xs" title={tc("share sheet", "Share")} onClick={(ev) => { ev.preventDefault(); ev.stopPropagation(); void shareAttachment(a); }}><Share2 size={14} /></button>}
{openableInTab(a.type) && a.blobId && <button className="icon-btn xs" title={translate("Open in new tab")} onClick={(ev) => { ev.preventDefault(); ev.stopPropagation(); window.open(inlineUrl, "_blank", "noopener"); }}><ExternalLink size={14} /></button>} {openableInTab(a.type) && a.blobId && <button className="icon-btn xs" title={translate("Open in new tab")} onClick={(ev) => { ev.preventDefault(); ev.stopPropagation(); window.open(inlineUrl, "_blank", "noopener"); }}><ExternalLink size={14} /></button>}
</span> </span>
</span> </span>
+11 -3
View File
@@ -1,6 +1,7 @@
import { useCallback, useEffect, useMemo, useRef, useState } from "react"; import { useCallback, useEffect, useMemo, useRef, useState } from "react";
import { AlertOctagon, Archive, ArrowLeft, ChevronDown, ChevronUp, FolderInput, Forward, Mail, MailOpen, MailPlus, MoreVertical, Printer, Reply, ReplyAll, ShieldCheck, Star, Tag, Trash2, Download , Paperclip} from "lucide-react"; import { AlertOctagon, Archive, ArrowLeft, ChevronDown, ChevronUp, FolderInput, Forward, Mail, MailOpen, MailPlus, MoreVertical, Printer, Reply, ReplyAll, ShieldCheck, Star, Tag, Trash2, Download , Paperclip} from "lucide-react";
import { useMail } from "@/store/mail"; import { useMail } from "@/store/mail";
import { visibleMessages } from "@/lib/openMessage";
import { useSettings } from "@/store/settings"; import { useSettings } from "@/store/settings";
import { useCompose } from "@/store/compose"; import { useCompose } from "@/store/compose";
import type { Email, Id } from "@/jmap/types"; import type { Email, Id } from "@/jmap/types";
@@ -25,9 +26,15 @@ interface Props {
onNavigate: (delta: number) => void; onNavigate: (delta: number) => void;
hasPrev: boolean; hasPrev: boolean;
hasNext: boolean; hasNext: boolean;
/**
* With conversation view off, the single message to show. The thread is still
* what loads -- one request, and the reply/forward paths keep the context
* they need -- but only this message is rendered.
*/
messageId?: Id | null;
} }
export function ThreadView({ threadId, mailboxId, onBack, actions, onNavigate, hasPrev, hasNext }: Props) { export function ThreadView({ threadId, mailboxId, onBack, actions, onNavigate, hasPrev, hasNext, messageId = null }: Props) {
const loadThread = useMail((s) => s.loadThread); const loadThread = useMail((s) => s.loadThread);
const thread = useMail((s) => s.threads[threadId]); const thread = useMail((s) => s.threads[threadId]);
const emails = useMail((s) => s.emails); const emails = useMail((s) => s.emails);
@@ -82,8 +89,9 @@ export function ThreadView({ threadId, mailboxId, onBack, actions, onNavigate, h
if (junk && e.mailboxIds[junk]) return false; if (junk && e.mailboxIds[junk]) return false;
return true; return true;
}); });
return (filtered.length ? filtered : all).sort((a, b) => a.receivedAt.localeCompare(b.receivedAt)); const shown = filtered.length ? filtered : all;
}, [thread, emails, fullIds, mailboxId]); return visibleMessages(shown, messageId).sort((a, b) => a.receivedAt.localeCompare(b.receivedAt));
}, [thread, emails, fullIds, mailboxId, messageId]);
/* /*
* Which messages were unread when this conversation was opened. * Which messages were unread when this conversation was opened.
+1 -2
View File
@@ -16,8 +16,7 @@
"allowImportingTsExtensions": true, "allowImportingTsExtensions": true,
"noEmit": true, "noEmit": true,
"types": ["vite/client"], "types": ["vite/client"],
"baseUrl": ".", "paths": { "@/*": ["./src/*"] }
"paths": { "@/*": ["src/*"] }
}, },
"include": ["src", "vite.config.ts"] "include": ["src", "vite.config.ts"]
} }

Some files were not shown because too many files have changed in this diff Show More