docs: weekly update — 2026-05-30

[dobby-coder]

Summary

Weekly docs drift sweep for encryption4all changes merged 2026-05-23 .. 2026-05-30.

postguard-examples

• New page /repos/pg-node for the new Node.js CLI example. Added to the sidebar under postguard-examples and to the overview table. Source: encryption4all/postguard-examples#46.

postguard-js

• Server-side usage section on /repos/postguard-js covering Node 20.3+, Bun, and Deno support, and the new upfront YiviSessionError when pg.sign.yivi(...) is called without a DOM. Source: encryption4all/postguard-js#76.
• Prerequisites bumped from "Node.js 20+" to "Node.js 20.3+ (or Bun / Deno)" to match the new engines.node.
• YiviSessionError "thrown when" list in /sdk/js-errors now includes the non-browser-runtime case.
• Notify options in /sdk/js-encryption now mentions the shape validator and the one-time console.info reminder when notify is omitted (the new behaviour from encryption4all/postguard-js#77).

postguard-dotnet

• NetworkException in /sdk/dotnet-errors gains the Url property and the new HTTP {status} at {url}: {body} message format. Source: encryption4all/postguard-dotnet#31.

Skipped

• postguard-business docs(js-sdk): Opened.decrypt({uuid}) may return DecryptDataResult #90 / chore: update dependencies #91 / chore: bump @e4a/pg-js to 1.7.1 #92 — internal/admin behaviour, no public docs surface.
• postguard-tb-addon #125, postguard-docs chore: bump @e4a/pg-js to 1.10.0 #107 — dependency bumps tracked in changelogs.
• postguard-website #237, postguard-outlook-addon docs: add irmars repo page, sidebar entry, and overview row #102, postguard-examples docs: drop em-dashes from prose in SDK encryption pages #50, postguard-js Add search #73 / security: add baseline security headers to nginx config #75 — dependency/security bumps.
• postguard-docs docs(README): correct deploy claim; CI builds and pushes the image only #110 / docs: replace staging *.yivi.app URLs with canonical postguard.eu hosts #111 — already in docs repo.
• postguard-dotnet Major / breaking version bump tracking #29 / Missing button #30 — README typo / internal perf, no docs surface.
• postguard-examples docs(ibs): document inherent byte serialization API and MSRV #48 / chore: update dependencies #55 — follow-ups to docs(cryptify): document notifyRecipients on /fileupload/init #46, no additional doc surface.

Test plan

• npx vitepress build docs — clean
• docs/.vitepress/dist/repos/pg-node.html exists---

Update 2026-06-20

Weekly docs drift sweep for changes merged 2026-06-13 .. 2026-06-20.

Client version reporting (cross-SDK)

The PostGuard SDKs now stamp an X-POSTGUARD-CLIENT-VERSION header on every PKG and Cryptify request so the servers can attribute traffic by SDK and version. Documented the header, its 4-field value, and the caller-override behaviour on both SDK pages:

• /repos/postguard-js — new "Client version header" subsection. Source: encryption4all/postguard-js#90.
• /repos/postguard-dotnet — new "Client version header" subsection, including the bring-your-own-HttpClient caveat. Source: encryption4all/postguard-dotnet#33.

The server side of this (Cryptify capturing the header into logs and a cryptify_uploads_by_app_total metric, plus adding it to the CORS allowlist) is internal telemetry with no public docs surface. Source: encryption4all/cryptify#174.

Skipped this week

• cryptify#178 / postguard-examples#59 — PKG URL pointed at pkg.postguard.eu / staging; docs already use the correct URLs.
• irmars#15 (health()), irmars#17 (frontendRequest on SessionData) — library API additions, but /repos/irmars documents the fork rationale and consumption, not a per-method API surface, so nothing to keep in sync.
• postguard-website#261/#262, postguard-outlook-addon#109, postguard-tb-addon#134, postguard-examples#60 — UI/test/example changes, no public docs surface.
• postguard-dotnet#32/docs(repos/postguard-website): document /decrypt ?uuid= and ?recipient= query params #36, cryptify#168 — release-please / test / dep-bump.

Test plan (update)

• npx vitepress build docs — clean

---

Update 2026-06-27

Weekly docs drift sweep for changes merged 2026-06-20 .. 2026-06-27.

postguard-dotnet / pg-dotnet

• .NET SDK prerequisite bumped from 8.0+ to 10.0+ on /repos/postguard-dotnet and /repos/pg-dotnet. The SDK's E4A.PostGuard.csproj and the example's PostGuard.Example.csproj both multi-target net8.0;net10.0, so a .NET 10 SDK is required to build the highest target. Source: encryption4all/postguard-dotnet#35 (verified the example csproj directly for the pg-dotnet page).

postguard-outlook-addon

• Read dialog documented on /repos/postguard-outlook-addon. Read-mode decryption now shows the plaintext message in a larger popup read dialog (src/read-dialog/, manifest ReadDialog.Url) instead of the cramped taskpane; the taskpane inline render is kept only as a fallback when the dialog cannot open. Updated the architecture section and the read-mode flow note. Source: encryption4all/postguard-outlook-addon#110.

Skipped this week

• irmars#18 (host QR override), irmars#19 (nextSession chained sessions) — library API additions, but /repos/irmars documents the fork rationale and consumption, not a per-method API surface (same call as irmars#15/Use mermaid for diagrams #17 above).
• cryptify#179 (CORS allow Office add-in origins) — deployment/config, no public docs surface.
• postguard-outlook-addon#108 (callback guard), postguard-tb-addon#135/#136/#137 (UI fixes), postguard-website#242 (a11y) — UI/behaviour fixes, no documented surface.
• postguard-dotnet#34 (inclusive Content-Range end), docs(sdk/js): document YiviSessionError class #37 (CI), postguard-tb-addon#138 (deps), dobby-code#78 (agent infra) — internal/CI/dep, no docs surface.

Test plan (update)

• npx vitepress build docs — clean