fedipod-server 0.9.0 → 0.11.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/claims.js +1 -1
- package/dist/handler.d.ts +1 -1
- package/dist/handler.js +35 -2
- package/dist/handler.jsonld +1 -1
- package/lib/admin.mjs +3 -3
- package/lib/c2s.mjs +27 -2
- package/lib/deliver.mjs +6 -0
- package/lib/embed.mjs +1 -0
- package/lib/export-collections.mjs +1 -1
- package/lib/front-core.mjs +272 -49
- package/lib/gateway-core.mjs +3 -7
- package/lib/httpsig.mjs +33 -2
- package/lib/import.mjs +1 -1
- package/lib/intake.mjs +357 -118
- package/lib/links.mjs +6 -32
- package/lib/mastoapi.mjs +449 -38
- package/lib/migrate.mjs +4 -18
- package/lib/pod/README.md +61 -0
- package/lib/pod/actor.mjs +96 -0
- package/lib/pod/collection.mjs +77 -0
- package/lib/pod/containers.mjs +136 -0
- package/lib/pod/discovery.mjs +46 -0
- package/lib/pod/featured.mjs +18 -0
- package/lib/pod/followers.mjs +24 -0
- package/lib/pod/following.mjs +10 -0
- package/lib/pod/http.mjs +74 -0
- package/lib/pod/inbox.mjs +144 -0
- package/lib/pod/links.mjs +35 -0
- package/lib/pod/media.mjs +27 -0
- package/lib/pod/notes.mjs +80 -0
- package/lib/pod/notifications.mjs +89 -0
- package/lib/pod/outbox.mjs +18 -0
- package/lib/pod/package.json +19 -0
- package/lib/pod/policy.mjs +58 -0
- package/lib/pod/private.mjs +19 -0
- package/lib/pod/root.mjs +63 -0
- package/lib/pod/state.mjs +39 -0
- package/lib/pod/transport.mjs +477 -0
- package/lib/pod/urls.mjs +71 -0
- package/lib/polls.mjs +105 -0
- package/lib/publisher.mjs +357 -188
- package/lib/remote.mjs +30 -395
- package/lib/social.mjs +20 -9
- package/lib/storage.mjs +2 -2
- package/lib/store.mjs +8 -1
- package/lib/tagfeed.mjs +19 -2
- package/lib/wire.mjs +87 -67
- package/package.json +1 -1
- package/run-agent.mjs +20 -39
- package/web/admin/admin.js +141 -74
- package/web/admin/bar.css +9 -13
- package/web/admin/bar.js +2 -2
- package/web/admin/client/client.js +1 -1
- package/web/admin/client/index.html +5 -6
- package/web/admin/index.html +53 -65
- package/web/admin/setup/index.html +2 -1
- package/web/admin/setup/setup.js +1 -1
- package/web/admin/tokens.css +56 -0
- package/web/app/README.md +77 -0
- package/web/app/admin-facade.mjs +549 -0
- package/web/app/agent.mjs +490 -0
- package/web/app/atproto-browser.mjs +86 -0
- package/web/app/boot.mjs +340 -0
- package/web/app/deliver-relay.mjs +72 -0
- package/web/app/dist/boot.js +34067 -0
- package/web/app/dist/boot.js.map +7 -0
- package/web/app/dist/sw.js +53745 -0
- package/web/app/dist/sw.js.map +7 -0
- package/web/app/fediacct-browser.mjs +146 -0
- package/web/app/idb-kv.mjs +35 -0
- package/web/app/index.html +203 -0
- package/web/app/index.html~ +152 -0
- package/web/app/keys-browser.mjs +46 -0
- package/web/app/keystore.mjs +99 -0
- package/web/app/oidc-session.mjs +189 -0
- package/web/app/pod-auth.mjs +248 -0
- package/web/app/pod-remote.mjs +84 -0
- package/web/app/shims/_globals.mjs +2 -0
- package/web/app/shims/fedify-sig.mjs +77 -0
- package/web/app/shims/node-crypto.mjs +113 -0
- package/web/app/shims/node-fs.mjs +17 -0
- package/web/app/shims/node-path.mjs +19 -0
- package/web/app/shims/node-url.mjs +7 -0
- package/web/app/shims/prelude.js +58 -0
- package/web/app/shims/safefetch.mjs +58 -0
- package/web/app/shims/web-push.mjs +14 -0
- package/web/app/signup.mjs +248 -0
- package/web/app/site/_headers +9 -0
- package/web/app/site/_redirects +21 -0
- package/web/app/site/admin/admin.js +1181 -0
- package/web/app/site/admin/bar.css +60 -0
- package/web/app/site/admin/bar.js +61 -0
- package/web/app/site/admin/client/client.js +66 -0
- package/web/app/site/admin/client/index.html +43 -0
- package/web/app/site/admin/index.html +556 -0
- package/web/app/site/admin/setup/index.html +191 -0
- package/web/app/site/admin/setup/setup.js +308 -0
- package/web/app/site/admin/tokens.css +56 -0
- package/web/app/site/admin/window.css +55 -0
- package/web/app/site/admin/window.js +136 -0
- package/web/app/site/app/404.html +40 -0
- package/web/app/site/app/_headers +2 -0
- package/web/app/site/app/apple-touch-icon.png +0 -0
- package/web/app/site/app/assets/ICONS-DIPJeU0C.js +2 -0
- package/web/app/site/app/assets/ICONS-DIPJeU0C.js.map +1 -0
- package/web/app/site/app/assets/ScheduledAtField-D-Abfo4J.js +183 -0
- package/web/app/site/app/assets/ScheduledAtField-D-Abfo4J.js.map +1 -0
- package/web/app/site/app/assets/Temml-CCjoacWt.woff2 +0 -0
- package/web/app/site/app/assets/__vite-browser-external-C7iut881.js +2 -0
- package/web/app/site/app/assets/__vite-browser-external-C7iut881.js.map +1 -0
- package/web/app/site/app/assets/boosts-carousel-BiOaNdMT.jpg +0 -0
- package/web/app/site/app/assets/catch-up-O5q5C75Z.png +0 -0
- package/web/app/site/app/assets/chunk-aKtaBQYM.js +1 -0
- package/web/app/site/app/assets/compose-CFEx7wb4.js +2 -0
- package/web/app/site/app/assets/compose-CFEx7wb4.js.map +1 -0
- package/web/app/site/app/assets/compose-ZJN5xSb4.js +35 -0
- package/web/app/site/app/assets/compose-ZJN5xSb4.js.map +1 -0
- package/web/app/site/app/assets/debug.module-YFQgwnIr.js +52 -0
- package/web/app/site/app/assets/debug.module-YFQgwnIr.js.map +1 -0
- package/web/app/site/app/assets/dom-p1YcJ5Rw.js +2 -0
- package/web/app/site/app/assets/dom-p1YcJ5Rw.js.map +1 -0
- package/web/app/site/app/assets/home-mobile-dark@2x-Dc-J8-SM.png +0 -0
- package/web/app/site/app/assets/home-mobile-light@2x-Bd3fod8m.png +0 -0
- package/web/app/site/app/assets/home-tablet-dark@2x-BgcNI8le.png +0 -0
- package/web/app/site/app/assets/home-tablet-light@2x-BW2RV9T6.png +0 -0
- package/web/app/site/app/assets/icons/add-circle-line-WD0mwORD.js +1 -0
- package/web/app/site/app/assets/icons/alert-line-CpFUMf9s.js +1 -0
- package/web/app/site/app/assets/icons/android-2-line-Bzxnrd3S.js +1 -0
- package/web/app/site/app/assets/icons/announcement-line-5nwaJFJm.js +1 -0
- package/web/app/site/app/assets/icons/arrow-down-circle-line-a7Id9-Iv.js +1 -0
- package/web/app/site/app/assets/icons/arrow-down-line-B8uzXzq6.js +1 -0
- package/web/app/site/app/assets/icons/arrow-left-line-CGrGT9C-.js +1 -0
- package/web/app/site/app/assets/icons/arrow-right-line-CE-HERfX.js +1 -0
- package/web/app/site/app/assets/icons/arrow-to-up-line-CvdQjmcy.js +1 -0
- package/web/app/site/app/assets/icons/arrow-up-circle-line-DEparSNF.js +1 -0
- package/web/app/site/app/assets/icons/arrow-up-line-C7yBeugc.js +1 -0
- package/web/app/site/app/assets/icons/arrows-right-line-BtbXmJGP.js +1 -0
- package/web/app/site/app/assets/icons/at-line-CF66Bznk.js +1 -0
- package/web/app/site/app/assets/icons/attachment-line-BY8It-l9.js +1 -0
- package/web/app/site/app/assets/icons/blockquote-line-BS6pU_hm.js +1 -0
- package/web/app/site/app/assets/icons/board-line-C0UWXyA6.js +1 -0
- package/web/app/site/app/assets/icons/bookmark-line-1CtX5JLF.js +1 -0
- package/web/app/site/app/assets/icons/building-5-line-Dd59MzbO.js +1 -0
- package/web/app/site/app/assets/icons/bus-2-line-6_dvA0GG.js +1 -0
- package/web/app/site/app/assets/icons/calendar-day-line-Crpl_fmu.js +1 -0
- package/web/app/site/app/assets/icons/calendar-month-line-vommts2C.js +1 -0
- package/web/app/site/app/assets/icons/calendar-time-add-line-BU_DTlQk.js +1 -0
- package/web/app/site/app/assets/icons/camera-line-Cv69MEei.js +1 -0
- package/web/app/site/app/assets/icons/celebrate-line-B8DvIoi0.js +1 -0
- package/web/app/site/app/assets/icons/chart-bar-line-FK-QOmtF.js +1 -0
- package/web/app/site/app/assets/icons/chart-line-line-BGcJAFWw.js +1 -0
- package/web/app/site/app/assets/icons/chat-3-line-YFK2-hwz.js +1 -0
- package/web/app/site/app/assets/icons/check-circle-line-DsAxFr5-.js +1 -0
- package/web/app/site/app/assets/icons/clipboard-line-BBp364gJ.js +1 -0
- package/web/app/site/app/assets/icons/close-circle-line-CICdiuGz.js +1 -0
- package/web/app/site/app/assets/icons/close-line-DYrFWcjv.js +1 -0
- package/web/app/site/app/assets/icons/cloud-line-tiQAbah8.js +1 -0
- package/web/app/site/app/assets/icons/code-line-fAl8iiV3.js +1 -0
- package/web/app/site/app/assets/icons/comment-2-line-CR3g7WeB.js +1 -0
- package/web/app/site/app/assets/icons/copy-2-line-CLW69yF5.js +1 -0
- package/web/app/site/app/assets/icons/delete-2-line-B8xmbr4n.js +1 -0
- package/web/app/site/app/assets/icons/document-3-line-DBGNhAg2.js +1 -0
- package/web/app/site/app/assets/icons/document-line-C7mb9sb7.js +1 -0
- package/web/app/site/app/assets/icons/down-line-BGqSSThd.js +1 -0
- package/web/app/site/app/assets/icons/edit-4-line-DcgGaEhx.js +1 -0
- package/web/app/site/app/assets/icons/emoji-2-line-D8YgnM-y.js +1 -0
- package/web/app/site/app/assets/icons/exit-line-Dc07BS-x.js +1 -0
- package/web/app/site/app/assets/icons/external-link-line-BvpSkmjO.js +1 -0
- package/web/app/site/app/assets/icons/eye-2-line-CiWXx-f_.js +1 -0
- package/web/app/site/app/assets/icons/eye-close-line-BgTaSJ4P.js +1 -0
- package/web/app/site/app/assets/icons/filter-2-line-B_mR2usy.js +1 -0
- package/web/app/site/app/assets/icons/filter-line-C_nm-3cU.js +1 -0
- package/web/app/site/app/assets/icons/flag-1-line-C2HB05I0.js +1 -0
- package/web/app/site/app/assets/icons/forbid-circle-line-D3LTT9yd.js +1 -0
- package/web/app/site/app/assets/icons/formula-line-DLrt2d6j.js +1 -0
- package/web/app/site/app/assets/icons/grid-line-CgUmEikf.js +1 -0
- package/web/app/site/app/assets/icons/group-line-C5fnX0wU.js +1 -0
- package/web/app/site/app/assets/icons/hand-finger-2-line-BGgxbuL9.js +1 -0
- package/web/app/site/app/assets/icons/hashtag-line-CyTEEXBb.js +1 -0
- package/web/app/site/app/assets/icons/heart-crack-line-BZddbO2C.js +1 -0
- package/web/app/site/app/assets/icons/heart-line-CJ7K47J4.js +1 -0
- package/web/app/site/app/assets/icons/history-2-line-kWWvFzqv.js +1 -0
- package/web/app/site/app/assets/icons/history-line-bGQiwbTH.js +1 -0
- package/web/app/site/app/assets/icons/home-3-line-fRU1zeLG.js +1 -0
- package/web/app/site/app/assets/icons/information-line-iNk6-sOY.js +1 -0
- package/web/app/site/app/assets/icons/keyboard-line-DsCyuQNz.js +1 -0
- package/web/app/site/app/assets/icons/layout-4-line-CZkOX52Z.js +1 -0
- package/web/app/site/app/assets/icons/layout-5-line-B_znt5wO.js +1 -0
- package/web/app/site/app/assets/icons/left-line-eUw0tya4.js +1 -0
- package/web/app/site/app/assets/icons/lightning-line-DaKoDdix.js +1 -0
- package/web/app/site/app/assets/icons/link-2-line-DCqLmMA7.js +1 -0
- package/web/app/site/app/assets/icons/list-check-line-BAxosBh9.js +1 -0
- package/web/app/site/app/assets/icons/lock-line-CPoaXeUW.js +1 -0
- package/web/app/site/app/assets/icons/mail-line-B0P8aa1L.js +1 -0
- package/web/app/site/app/assets/icons/moon-line-CEqNAToP.js +1 -0
- package/web/app/site/app/assets/icons/more-1-fill-Dw2e5xab.js +1 -0
- package/web/app/site/app/assets/icons/more-3-line-BIiVjYTz.js +1 -0
- package/web/app/site/app/assets/icons/notification-line-BZZq2Gtu.js +1 -0
- package/web/app/site/app/assets/icons/pencil-line-CKh8-A1v.js +1 -0
- package/web/app/site/app/assets/icons/photo-album-line-Bnfg2u40.js +1 -0
- package/web/app/site/app/assets/icons/pin-line-DpTolyhs.js +1 -0
- package/web/app/site/app/assets/icons/play-fill-B0-G_8lX.js +1 -0
- package/web/app/site/app/assets/icons/qrcode-2-line-B6SPCaHn.js +1 -0
- package/web/app/site/app/assets/icons/quill-pen-line-B6LUrnCP.js +1 -0
- package/web/app/site/app/assets/icons/quote-left-fill-hQZ1cj_6.js +1 -0
- package/web/app/site/app/assets/icons/radar-line-CKyroTth.js +1 -0
- package/web/app/site/app/assets/icons/react-line-CoIKhhtK.js +1 -0
- package/web/app/site/app/assets/icons/refresh-2-line-D0mTF97S.js +1 -0
- package/web/app/site/app/assets/icons/right-line-B3KWJaqc.js +1 -0
- package/web/app/site/app/assets/icons/rocket-line-4KZl537D.js +1 -0
- package/web/app/site/app/assets/icons/round-fill-C69NTrZ0.js +1 -0
- package/web/app/site/app/assets/icons/round-line-B9k_1uo-.js +1 -0
- package/web/app/site/app/assets/icons/route-line-B28ReHcE.js +1 -0
- package/web/app/site/app/assets/icons/rows-4-line-CrBniagM.js +1 -0
- package/web/app/site/app/assets/icons/scan-line-DSf74YdP.js +1 -0
- package/web/app/site/app/assets/icons/search-2-line-B6geIU1z.js +1 -0
- package/web/app/site/app/assets/icons/settings-3-line-azJwK47w.js +1 -0
- package/web/app/site/app/assets/icons/settings-6-line-C_5zc5YR.js +1 -0
- package/web/app/site/app/assets/icons/share-2-line-D5MxWjrm.js +1 -0
- package/web/app/site/app/assets/icons/share-forward-line-Cp61fZzZ.js +1 -0
- package/web/app/site/app/assets/icons/sparkles-2-line-DYYyXTaW.js +1 -0
- package/web/app/site/app/assets/icons/sparkles-line-C2hY1s6I.js +1 -0
- package/web/app/site/app/assets/icons/time-line-BF3eet1v.js +1 -0
- package/web/app/site/app/assets/icons/transfer-4-line-oisfvTBw.js +1 -0
- package/web/app/site/app/assets/icons/translate-line-BFWol2Ce.js +1 -0
- package/web/app/site/app/assets/icons/unlock-line-X_x5vwv3.js +1 -0
- package/web/app/site/app/assets/icons/upload-3-line-DgzwUJeW.js +1 -0
- package/web/app/site/app/assets/icons/user-4-line-BVSynZCp.js +1 -0
- package/web/app/site/app/assets/icons/user-add-2-line-BlGS5Q8q.js +1 -0
- package/web/app/site/app/assets/icons/user-add-line-BbXdHG4z.js +1 -0
- package/web/app/site/app/assets/icons/user-edit-line-BFAHOV0X.js +1 -0
- package/web/app/site/app/assets/icons/user-follow-line-BXux0wSd.js +1 -0
- package/web/app/site/app/assets/icons/user-star-line-DdYlpHLU.js +1 -0
- package/web/app/site/app/assets/icons/user-warning-line-Cj43j0_E.js +1 -0
- package/web/app/site/app/assets/icons/user-x-line-DIDgNlPH.js +1 -0
- package/web/app/site/app/assets/icons/volume-line-Bs390KQt.js +1 -0
- package/web/app/site/app/assets/icons/volume-mute-line-DzlzIqFZ.js +1 -0
- package/web/app/site/app/assets/icons/walk-line-yNXfB-md.js +1 -0
- package/web/app/site/app/assets/icons/world-2-line-CenkGIwj.js +1 -0
- package/web/app/site/app/assets/icons/zoom-in-line-CaENUphf.js +1 -0
- package/web/app/site/app/assets/icons/zoom-out-line-BDNk0EWo.js +1 -0
- package/web/app/site/app/assets/instances-BNPptnn-.json +333 -0
- package/web/app/site/app/assets/locales/ar-SA-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/ca-ES-DHRW86Tz.js +1 -0
- package/web/app/site/app/assets/locales/cs-CZ-CKoqEuA1.js +1 -0
- package/web/app/site/app/assets/locales/de-DE-ByRPMRFy.js +1 -0
- package/web/app/site/app/assets/locales/eo-UY-CPC7wLCS.js +1 -0
- package/web/app/site/app/assets/locales/es-ES-dJa0Fd9t.js +1 -0
- package/web/app/site/app/assets/locales/eu-ES-C3djlPR2.js +1 -0
- package/web/app/site/app/assets/locales/fa-IR-DTT490Ck.js +1 -0
- package/web/app/site/app/assets/locales/fi-FI-B23MCPuz.js +1 -0
- package/web/app/site/app/assets/locales/fr-FR-BcaQsO5C.js +1 -0
- package/web/app/site/app/assets/locales/gl-ES-BR-CVKBN.js +1 -0
- package/web/app/site/app/assets/locales/he-IL-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/hu-HU-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/it-IT-C1136UFV.js +1 -0
- package/web/app/site/app/assets/locales/ja-JP-CRZmRAhD.js +1 -0
- package/web/app/site/app/assets/locales/kab-Cz8xH_TT.js +1 -0
- package/web/app/site/app/assets/locales/ko-KR-CG9UiY4o.js +1 -0
- package/web/app/site/app/assets/locales/lt-LT-CJcI6sHZ.js +1 -0
- package/web/app/site/app/assets/locales/nb-NO-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/nl-NL-DxN4Yc1t.js +1 -0
- package/web/app/site/app/assets/locales/oc-FR-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/pl-PL-DkwGXf6P.js +1 -0
- package/web/app/site/app/assets/locales/pseudo-LOCALE-CQ4XxkQ0.js +1 -0
- package/web/app/site/app/assets/locales/pt-BR-nGL0HdFS.js +1 -0
- package/web/app/site/app/assets/locales/pt-PT-Cp17aj2z.js +1 -0
- package/web/app/site/app/assets/locales/ru-RU-0Y8cIoaK.js +1 -0
- package/web/app/site/app/assets/locales/th-TH-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/tok-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/tr-TR-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/locales/uk-UA-C5E3dFBf.js +1 -0
- package/web/app/site/app/assets/locales/zh-CN-BHJi7_et.js +1 -0
- package/web/app/site/app/assets/locales/zh-TW-CfheRbCu.js +1 -0
- package/web/app/site/app/assets/main-BdqNbG-a.js +26 -0
- package/web/app/site/app/assets/main-BdqNbG-a.js.map +1 -0
- package/web/app/site/app/assets/mock-home-DGhR__He.js +2 -0
- package/web/app/site/app/assets/mock-home-DGhR__He.js.map +1 -0
- package/web/app/site/app/assets/multi-column-ROck0NVt.jpg +0 -0
- package/web/app/site/app/assets/multi-hashtag-timeline-DH5INVHi.jpg +0 -0
- package/web/app/site/app/assets/nested-comments-thread-hv59kZLc.jpg +0 -0
- package/web/app/site/app/assets/polyfill-force-H8sUkLGp.js +2 -0
- package/web/app/site/app/assets/polyfill-force-H8sUkLGp.js.map +1 -0
- package/web/app/site/app/assets/pwa-viewport-ogKbF51K.js +20 -0
- package/web/app/site/app/assets/pwa-viewport-ogKbF51K.js.map +1 -0
- package/web/app/site/app/assets/style-B1iLPTPR.css +2 -0
- package/web/app/site/app/assets/temml-DuyIQMei.js +97 -0
- package/web/app/site/app/assets/temml-DuyIQMei.js.map +1 -0
- package/web/app/site/app/assets/tinyld.light.node-DtbBhLYC.js +2 -0
- package/web/app/site/app/assets/tinyld.light.node-DtbBhLYC.js.map +1 -0
- package/web/app/site/app/assets/year-in-posts-B2lywqdx.png +0 -0
- package/web/app/site/app/assets/year-in-posts-DJv_star.js +3 -0
- package/web/app/site/app/assets/year-in-posts-DJv_star.js.map +1 -0
- package/web/app/site/app/compose/index.html +20 -0
- package/web/app/site/app/favicon.ico +0 -0
- package/web/app/site/app/index.html +73 -0
- package/web/app/site/app/logo-192.png +0 -0
- package/web/app/site/app/logo-512.png +0 -0
- package/web/app/site/app/logo-badge-72.png +0 -0
- package/web/app/site/app/logo-maskable-512.png +0 -0
- package/web/app/site/app/logo-monochrome-512.png +0 -0
- package/web/app/site/app/logo-monochrome-maskable-512.png +0 -0
- package/web/app/site/app/manifest.webmanifest +1 -0
- package/web/app/site/app/og-image-2.jpg +0 -0
- package/web/app/site/app/og-image.png +0 -0
- package/web/app/site/app/robots.txt +2 -0
- package/web/app/site/app/version.json +1 -0
- package/web/app/site/boot.js +34067 -0
- package/web/app/site/index.html +203 -0
- package/web/app/site/sw.js +53745 -0
- package/web/app/sw-src.mjs +205 -0
- package/web/front/#new-account.html# +43 -0
- package/web/front/admin.html +1 -81
- package/web/front/admin.js +85 -0
- package/web/front/new-account.html +1 -9
- package/web/front/new-account.js +13 -0
- package/web/front/run.html +1 -92
- package/web/front/run.js +107 -0
- package/lib/podrdf.mjs +0 -132
package/lib/migrate.mjs
CHANGED
|
@@ -94,13 +94,12 @@ export function classifyRemoteState(urls, base) {
|
|
|
94
94
|
return { drop, keep };
|
|
95
95
|
}
|
|
96
96
|
|
|
97
|
-
// Copy the private half — every state document
|
|
98
|
-
//
|
|
99
|
-
//
|
|
97
|
+
// Copy the private half — every state document — from one storage to the
|
|
98
|
+
// other. Copy and verify only: nothing is repointed and nothing is deleted, so
|
|
99
|
+
// a failure part-way leaves the source authoritative.
|
|
100
100
|
// Used by both `state --to` and the record page's Move private data.
|
|
101
101
|
export async function copyPrivateHalf({ from, to, log = () => {} }) {
|
|
102
102
|
const { PodStore } = await import('./store.mjs');
|
|
103
|
-
const { PodRdf } = await import('./podrdf.mjs');
|
|
104
103
|
const src = new PodStore({ log: () => {} });
|
|
105
104
|
src.attach(from.state);
|
|
106
105
|
await src.load();
|
|
@@ -110,18 +109,5 @@ export async function copyPrivateHalf({ from, to, log = () => {} }) {
|
|
|
110
109
|
if (!await dst.commit()) {
|
|
111
110
|
throw new Error('some state documents did not land — nothing was repointed, nothing was deleted');
|
|
112
111
|
}
|
|
113
|
-
|
|
114
|
-
const rdfTo = new PodRdf({ storage: to.fediverse });
|
|
115
|
-
let notes = 0;
|
|
116
|
-
for (const doc of ['settings', 'contacts']) {
|
|
117
|
-
try { await rdfTo.put(rdfTo.fedi + doc, await rdfFrom.get(rdfFrom.fedi + doc)); }
|
|
118
|
-
catch (e) { if (!/ 404$/.test(e.message)) throw e; }
|
|
119
|
-
}
|
|
120
|
-
for (const kind of ['posts', 'timeline']) {
|
|
121
|
-
for (const url of await rdfFrom.listNotes(kind)) {
|
|
122
|
-
await rdfTo.put(`${rdfTo.fedi}${kind}/${url.split('/').pop()}`, await rdfFrom.get(url));
|
|
123
|
-
notes++;
|
|
124
|
-
}
|
|
125
|
-
}
|
|
126
|
-
return { docs: src.cache.size, notes };
|
|
112
|
+
return { docs: src.cache.size };
|
|
127
113
|
}
|
|
@@ -0,0 +1,61 @@
|
|
|
1
|
+
# solid-ap-pod
|
|
2
|
+
|
|
3
|
+
Reading and writing an ActivityPub actor's documents on a Solid pod.
|
|
4
|
+
|
|
5
|
+
It knows **where each document lives and how it lands safely** — the container
|
|
6
|
+
layout, the transport, the WAC access-control documents, the deletion deny-list,
|
|
7
|
+
the byte budgets. It does not know **what is in them**: every AS2 document is
|
|
8
|
+
built by the caller and passed in. That line is why this can be lifted out of
|
|
9
|
+
the application it grew up in.
|
|
10
|
+
|
|
11
|
+
It currently lives inside FediPod at `lib/pod/`. Extracting it is a directory
|
|
12
|
+
move plus this `package.json`; `scripts/check-pod-calls.mjs` in the parent repo
|
|
13
|
+
exists to keep that true.
|
|
14
|
+
|
|
15
|
+
## Rules it holds itself to
|
|
16
|
+
|
|
17
|
+
1. **No upward imports.** Nothing here reaches outside this directory.
|
|
18
|
+
2. **No Node built-ins.** It runs unmodified in a service worker, which is why
|
|
19
|
+
it carries its own `readCapped`/`retryAfterMs` in `http.mjs` rather than
|
|
20
|
+
using a host application's SSRF-guarding fetch.
|
|
21
|
+
3. **One runtime dependency, rdflib**, reached only by `transport.mjs` (listings,
|
|
22
|
+
ACL documents, ACP detection, the WebID patch). Resource modules must stay
|
|
23
|
+
free of it so a size-sensitive host — a serverless function answering every
|
|
24
|
+
request — can import one without paying for a parser.
|
|
25
|
+
4. **Everything injected.** It never builds a session, mints a credential, or
|
|
26
|
+
reads config or environment.
|
|
27
|
+
5. **No opinions with defaults.** `apUrls` requires the container root rather
|
|
28
|
+
than guessing one, because a guessed root put an identity's state in one
|
|
29
|
+
container and its published documents in another.
|
|
30
|
+
|
|
31
|
+
## Layout
|
|
32
|
+
|
|
33
|
+
| file | what |
|
|
34
|
+
|---|---|
|
|
35
|
+
| `urls.mjs` | the container layout; `apUrls(remotePod, root, { publicBase })` |
|
|
36
|
+
| `transport.mjs` | `PodTransport` — verbs, ACLs, listings, cooldown, deny-list |
|
|
37
|
+
| `http.mjs` | `readCapped`, `retryAfterMs` |
|
|
38
|
+
| `links.mjs` | RFC 8288 `Link` header parsing |
|
|
39
|
+
|
|
40
|
+
## The transport
|
|
41
|
+
|
|
42
|
+
`PodTransport` takes a session — `{ fetch(url, init) }` — and never makes one.
|
|
43
|
+
A Node agent hands it a DPoP client-credentials grant, a browser hands it a
|
|
44
|
+
Solid-OIDC session, a pod server hands it a shim straight onto its own store.
|
|
45
|
+
|
|
46
|
+
Three manners hold for every request, and they are in `fetch()` so nothing can
|
|
47
|
+
route around them:
|
|
48
|
+
|
|
49
|
+
- **The cooldown.** A 429 or 503 arms a pod-wide pause. `cooldownMode: 'refuse'`
|
|
50
|
+
fails fast for the window (right for a daemon with timers behind it);
|
|
51
|
+
`'wait'` sleeps it out (right for a tab with a person in front of it).
|
|
52
|
+
- **The url map.** A fronted identity's advertised ids are mapped to their pod
|
|
53
|
+
locations at this one choke point, so callers pass advertised ids throughout.
|
|
54
|
+
- **The deletion deny-list.** A pod's profile, settings, discovery documents,
|
|
55
|
+
access-control documents and lease are never deletable. A pod was crippled
|
|
56
|
+
exactly this way; the list is a DENY-list rather than an allow-prefix because
|
|
57
|
+
the next caller will have a different prefix and the same things it must
|
|
58
|
+
never touch.
|
|
59
|
+
|
|
60
|
+
Subclasses override **`_send`**, not `fetch` — an override of `_send` cannot
|
|
61
|
+
skip any of the three.
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
// actor.mjs — ap/actor and the documents that speak for it.
|
|
2
|
+
//
|
|
3
|
+
// "Actor" here always means the ActivityPub actor DOCUMENT — the thing remote
|
|
4
|
+
// servers fetch to learn this identity's inbox, keys and collections. It is
|
|
5
|
+
// not the party performing an operation; a transport carries that as its
|
|
6
|
+
// `role`.
|
|
7
|
+
//
|
|
8
|
+
// The actor is public, and its Read rule travels with every write for the same
|
|
9
|
+
// reason it does in discovery.mjs: an actor nobody can fetch is an identity
|
|
10
|
+
// nobody can follow, and the failure is silent from this side.
|
|
11
|
+
|
|
12
|
+
const PUBLIC_READ = ['Read'];
|
|
13
|
+
|
|
14
|
+
// What ActivityPub §3.2 requires a client to send: the profiled JSON-LD type is
|
|
15
|
+
// the MUST, activity+json only the SHOULD a server ought to treat as equivalent.
|
|
16
|
+
// Asking for both is the only form every implementation answers.
|
|
17
|
+
const ACCEPT_AP = 'application/activity+json, application/ld+json; profile="https://www.w3.org/ns/activitystreams"';
|
|
18
|
+
|
|
19
|
+
// ---- the owner's agent ----
|
|
20
|
+
|
|
21
|
+
/** Publish the actor document. */
|
|
22
|
+
export async function write(pod, urls, doc) {
|
|
23
|
+
await pod.putJson(urls.actor, doc);
|
|
24
|
+
await pod.setAcl(urls.actor, PUBLIC_READ);
|
|
25
|
+
}
|
|
26
|
+
|
|
27
|
+
/** What this pod currently publishes as its actor, or null if nothing does. */
|
|
28
|
+
export function read(pod, urls) {
|
|
29
|
+
return pod.getJson(urls.actor);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Replace the actor with a Tombstone.
|
|
34
|
+
*
|
|
35
|
+
* Still public-Read, deliberately: a retired actor that 404s reads to a remote
|
|
36
|
+
* server as a temporary failure worth retrying, where a Tombstone reads as an
|
|
37
|
+
* answer.
|
|
38
|
+
*/
|
|
39
|
+
export async function writeTombstone(pod, urls, doc) {
|
|
40
|
+
await pod.putJson(urls.actor, doc);
|
|
41
|
+
await pod.setAcl(urls.actor, PUBLIC_READ);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Publish the actor carrying `movedTo`.
|
|
46
|
+
*
|
|
47
|
+
* The same document in the same place — but named apart from `write` because
|
|
48
|
+
* what it means is not "the profile changed", it is "this identity is now
|
|
49
|
+
* somewhere else", and a caller should have to say which it intends.
|
|
50
|
+
*/
|
|
51
|
+
export async function writeMoved(pod, urls, doc) {
|
|
52
|
+
await pod.putJson(urls.actor, doc);
|
|
53
|
+
await pod.setAcl(urls.actor, PUBLIC_READ);
|
|
54
|
+
}
|
|
55
|
+
|
|
56
|
+
/** The human half: a page a person can open and follow from. */
|
|
57
|
+
export async function writeProfilePage(pod, urls, html) {
|
|
58
|
+
await pod.put(urls.profileHtml, html, 'text/html');
|
|
59
|
+
await pod.setAcl(urls.profileHtml, PUBLIC_READ);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Record the actor in the pod owner's WebID profile, as `foaf:account`.
|
|
64
|
+
*
|
|
65
|
+
* The inverse of the actor's own `alsoKnownAs`: together they let a reader of
|
|
66
|
+
* either document verify the other, rather than taking one side's word.
|
|
67
|
+
*
|
|
68
|
+
* Delegated to the transport, which reads the profile, refuses to write if the
|
|
69
|
+
* parsed graph does not mention the WebID, and patches exactly the statements
|
|
70
|
+
* involved rather than rewriting a document full of things that are not ours.
|
|
71
|
+
*/
|
|
72
|
+
export function linkInWebIdProfile(pod, { actorUrl, accountName, kind = 'person' }) {
|
|
73
|
+
return pod.linkAccountInProfile({ actorUrl, accountName, kind });
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
// ---- anyone at all ----
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* The OIDC issuer a published actor names, read without credentials.
|
|
80
|
+
*
|
|
81
|
+
* Asked of a stranger's pod during sign-in, before there is any session to ask
|
|
82
|
+
* with — so a plain fetch, and a null rather than a throw when the actor is
|
|
83
|
+
* not there or says nothing.
|
|
84
|
+
*/
|
|
85
|
+
export async function readIssuer(actorUrl, fetchImpl = fetch) {
|
|
86
|
+
try {
|
|
87
|
+
// Both media types, and the profile with it. `application/activity+json`
|
|
88
|
+
// alone is what ActivityPub calls the SHOULD, not the MUST — and a pod that
|
|
89
|
+
// stores its actor as JSON-LD answers 501 to it, which would read here as
|
|
90
|
+
// "this pod names no issuer" and send the caller off to guess one.
|
|
91
|
+
const res = await fetchImpl(actorUrl, { headers: { accept: ACCEPT_AP } });
|
|
92
|
+
if (res.status >= 400) return null;
|
|
93
|
+
const doc = await res.json();
|
|
94
|
+
return doc?.endpoints?.oauthAuthorizationEndpoint || null;
|
|
95
|
+
} catch { return null; }
|
|
96
|
+
}
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
// collection.mjs — the mechanics every AS2 collection on a pod shares.
|
|
2
|
+
//
|
|
3
|
+
// Not a resource itself: the outbox, the followers list and the block list are
|
|
4
|
+
// each their own document with their own meaning, and each has a module that
|
|
5
|
+
// says so. What they have in common is how a collection is written and walked,
|
|
6
|
+
// and that is here so it is written once.
|
|
7
|
+
//
|
|
8
|
+
// A paged collection is a HEAD carrying counts and bounds, plus page documents
|
|
9
|
+
// carrying the items. A remote server reads the small head and walks only as
|
|
10
|
+
// far as it needs, instead of pulling one enormous document.
|
|
11
|
+
|
|
12
|
+
const PUBLIC_READ = ['Read'];
|
|
13
|
+
|
|
14
|
+
/**
|
|
15
|
+
* One page.
|
|
16
|
+
*
|
|
17
|
+
* `publicRead` is false for a page that already exists: the ACL is set when a
|
|
18
|
+
* page is first created and not rewritten on every republish, because a page
|
|
19
|
+
* is written on every change and its rule is not what changed.
|
|
20
|
+
*/
|
|
21
|
+
export async function writePage(pod, pageUrl, doc, { publicRead = false } = {}) {
|
|
22
|
+
await pod.putJson(pageUrl, doc);
|
|
23
|
+
if (publicRead) await pod.setAcl(pageUrl, PUBLIC_READ);
|
|
24
|
+
}
|
|
25
|
+
|
|
26
|
+
/** The head — counts, bounds, and the pointer at the first page. */
|
|
27
|
+
export async function writeHead(pod, url, doc, { publicRead = false } = {}) {
|
|
28
|
+
await pod.putJson(url, doc);
|
|
29
|
+
if (publicRead) await pod.setAcl(url, PUBLIC_READ);
|
|
30
|
+
}
|
|
31
|
+
|
|
32
|
+
/**
|
|
33
|
+
* Remove a page that is no longer within bounds.
|
|
34
|
+
*
|
|
35
|
+
* Best-effort: a surplus page left behind is stale but harmless — the head no
|
|
36
|
+
* longer points at it — where a failed publish over a delete is not.
|
|
37
|
+
*/
|
|
38
|
+
export async function dropPage(pod, pageUrl) {
|
|
39
|
+
await pod.delete(pageUrl).catch(() => {});
|
|
40
|
+
}
|
|
41
|
+
|
|
42
|
+
/** A whole flat collection, written as one document. */
|
|
43
|
+
export async function writeFlat(pod, url, doc, { publicRead = false } = {}) {
|
|
44
|
+
await pod.putJson(url, doc);
|
|
45
|
+
if (publicRead) await pod.setAcl(url, PUBLIC_READ);
|
|
46
|
+
}
|
|
47
|
+
|
|
48
|
+
/**
|
|
49
|
+
* Every item in a published collection, walking pages.
|
|
50
|
+
*
|
|
51
|
+
* Also reads a FLAT collection, so a collection published before this project
|
|
52
|
+
* paged them is still readable — which matters because a rebuild reads these
|
|
53
|
+
* to recover what a lost machine no longer has.
|
|
54
|
+
*
|
|
55
|
+
* `seen` guards a cycle and `max` a collection that lies about its own size;
|
|
56
|
+
* both are the pod's data but not necessarily ours, since a restored backup or
|
|
57
|
+
* a half-finished write can leave either.
|
|
58
|
+
*
|
|
59
|
+
* @returns items, or null when there is no collection there at all
|
|
60
|
+
*/
|
|
61
|
+
export async function readPaged(pod, headUrl, { max = 10_000, alsoItems = false } = {}) {
|
|
62
|
+
const head = await pod.getJson(headUrl).catch(() => null);
|
|
63
|
+
if (!head) return null;
|
|
64
|
+
if (Array.isArray(head.orderedItems) && head.orderedItems.length) return head.orderedItems;
|
|
65
|
+
if (alsoItems && Array.isArray(head.items) && head.items.length) return head.items;
|
|
66
|
+
const items = [];
|
|
67
|
+
const seen = new Set();
|
|
68
|
+
let next = head.first;
|
|
69
|
+
while (next && !seen.has(next) && items.length < max) {
|
|
70
|
+
seen.add(next);
|
|
71
|
+
const page = await pod.getJson(next).catch(() => null);
|
|
72
|
+
if (!page) break;
|
|
73
|
+
items.push(...(page.orderedItems || []));
|
|
74
|
+
next = page.next;
|
|
75
|
+
}
|
|
76
|
+
return items;
|
|
77
|
+
}
|
|
@@ -0,0 +1,136 @@
|
|
|
1
|
+
// containers.mjs — making a container exist, and making its access right.
|
|
2
|
+
//
|
|
3
|
+
// A container on a Solid pod is not created; it is implied by something being
|
|
4
|
+
// in it. So every provisioning here writes one small canary document and then
|
|
5
|
+
// states the access rule the container is supposed to have. The two are one
|
|
6
|
+
// operation on purpose: a container that exists without its ACL is either
|
|
7
|
+
// world-readable when it should not be, or unreachable when it should not be,
|
|
8
|
+
// and both have happened by writing one and not the other.
|
|
9
|
+
//
|
|
10
|
+
// The probes at the bottom take a `probe` function rather than a transport,
|
|
11
|
+
// and that is the whole point of them: they ask what a STRANGER sees. Handing
|
|
12
|
+
// them a credential would answer a different question, and answer it wrongly.
|
|
13
|
+
|
|
14
|
+
const KEEP = { keep: true };
|
|
15
|
+
const KEEP_CT = 'application/json';
|
|
16
|
+
|
|
17
|
+
/** The canary this module writes, and reads back to ask whether it was here. */
|
|
18
|
+
const keepUrl = (base) => `${base}.keep`;
|
|
19
|
+
|
|
20
|
+
// ---- the owner's agent, holding the pod's own credential ----
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Whether this container has already been provisioned.
|
|
24
|
+
*
|
|
25
|
+
* Only a definite "yes" counts: anything else falls through to the write,
|
|
26
|
+
* which is idempotent anyway, so a failed probe costs a request and never
|
|
27
|
+
* correctness. Worth asking because the alternative is re-provisioning — and
|
|
28
|
+
* rewriting an ACL — every time a service worker restarts, which is whenever
|
|
29
|
+
* the browser feels like it.
|
|
30
|
+
*/
|
|
31
|
+
export async function exists(pod, base) {
|
|
32
|
+
try {
|
|
33
|
+
const r = await pod.fetch(keepUrl(base), { method: 'HEAD' });
|
|
34
|
+
return r?.status >= 200 && r.status < 300;
|
|
35
|
+
} catch { return false; }
|
|
36
|
+
}
|
|
37
|
+
|
|
38
|
+
/** Bring a container into being with an owner-only rule. */
|
|
39
|
+
export async function provisionOwnerOnly(pod, base) {
|
|
40
|
+
await pod.putJson(keepUrl(base), KEEP, KEEP_CT);
|
|
41
|
+
await pod.setAcl(base, []);
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** Bring a container into being, world-readable — a published tree. */
|
|
45
|
+
export async function provisionPublic(pod, base) {
|
|
46
|
+
await pod.putJson(keepUrl(base), KEEP, KEEP_CT);
|
|
47
|
+
await pod.setAcl(base, ['Read']);
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
/**
|
|
51
|
+
* The private half: the home itself and the state container.
|
|
52
|
+
*
|
|
53
|
+
* Idempotent, so two devices doing it at once is harmless — which is what
|
|
54
|
+
* makes it safe to run on every boot rather than only at setup.
|
|
55
|
+
*/
|
|
56
|
+
export async function provisionPrivate(pod, urls) {
|
|
57
|
+
await pod.putJson(keepUrl(urls.state), KEEP, KEEP_CT);
|
|
58
|
+
await pod.setAcl(urls.state, []);
|
|
59
|
+
await pod.setAcl(urls.home, []);
|
|
60
|
+
}
|
|
61
|
+
|
|
62
|
+
/**
|
|
63
|
+
* Check the private trees are actually private, and put back any that are not.
|
|
64
|
+
*
|
|
65
|
+
* An ACL write that silently failed — or that something else changed
|
|
66
|
+
* afterwards — leaves the private trees, signing keys among them, readable by
|
|
67
|
+
* anyone. Setup writes them once and never returns, so this is what makes it a
|
|
68
|
+
* standing property rather than a one-time hope.
|
|
69
|
+
*
|
|
70
|
+
* Returns what it found rather than logging: what a finding MEANS, and how
|
|
71
|
+
* loudly to say it, belongs to the application.
|
|
72
|
+
*
|
|
73
|
+
* `isPublic` is supplied rather than assumed: how you decide a tree is
|
|
74
|
+
* world-readable — which headers, which timeout — is the caller's business.
|
|
75
|
+
*
|
|
76
|
+
* @returns {Promise<Array<{url, rewritten, stillPublic, error}>>} one entry per
|
|
77
|
+
* tree that was readable without credentials; empty when all is well.
|
|
78
|
+
*/
|
|
79
|
+
export async function repairPrivateAcls(pod, trees, { isPublic } = {}) {
|
|
80
|
+
const findings = [];
|
|
81
|
+
for (const url of trees) {
|
|
82
|
+
if (!await isPublic(url)) continue;
|
|
83
|
+
const finding = { url, rewritten: false, stillPublic: false, error: null };
|
|
84
|
+
findings.push(finding);
|
|
85
|
+
try {
|
|
86
|
+
await pod.setAcl(url, []);
|
|
87
|
+
finding.rewritten = true;
|
|
88
|
+
} catch (e) {
|
|
89
|
+
finding.error = e.message;
|
|
90
|
+
continue;
|
|
91
|
+
}
|
|
92
|
+
finding.stillPublic = await isPublic(url);
|
|
93
|
+
}
|
|
94
|
+
return findings;
|
|
95
|
+
}
|
|
96
|
+
|
|
97
|
+
// ---- anyone at all: what a stranger can see ----
|
|
98
|
+
|
|
99
|
+
/**
|
|
100
|
+
* Is this readable with no credentials?
|
|
101
|
+
*
|
|
102
|
+
* `accept: *\/*` matters. Asking for turtle makes a server answer 501 on the
|
|
103
|
+
* JSON documents — webfinger, the actor — which reads as "unreachable" when
|
|
104
|
+
* the world can in fact see them perfectly well.
|
|
105
|
+
*
|
|
106
|
+
* Unreachable is not a finding: a pod that failed to answer has not been shown
|
|
107
|
+
* to be public, and treating that as one would rewrite ACLs on a network blip.
|
|
108
|
+
*/
|
|
109
|
+
export async function probePublicReadability(probe, url, { headers = {}, timeoutMs = 20_000 } = {}) {
|
|
110
|
+
try {
|
|
111
|
+
const res = await probe(url, {
|
|
112
|
+
headers: { accept: '*/*', ...headers },
|
|
113
|
+
signal: AbortSignal.timeout(timeoutMs),
|
|
114
|
+
});
|
|
115
|
+
return res.status < 400;
|
|
116
|
+
} catch { return false; }
|
|
117
|
+
}
|
|
118
|
+
|
|
119
|
+
/**
|
|
120
|
+
* Does this pod actually ENFORCE an owner-only rule?
|
|
121
|
+
*
|
|
122
|
+
* A bare, unauthenticated read of the private container's canary must be
|
|
123
|
+
* refused. Anything else — including a redirect to a login page, which is why
|
|
124
|
+
* redirects are not followed — means documents meant to be private would not
|
|
125
|
+
* be, and the caller should decline to put private things here.
|
|
126
|
+
*
|
|
127
|
+
* Takes a POD-SPACE url: an identity whose ids are advertised elsewhere must
|
|
128
|
+
* map back to the pod first, because the rule being tested is the pod's.
|
|
129
|
+
*
|
|
130
|
+
* @returns {Promise<true|string>} true, or why not
|
|
131
|
+
*/
|
|
132
|
+
export async function probePrivateEnforcement(probe, podKeepUrl) {
|
|
133
|
+
const r = await probe(podKeepUrl, { redirect: 'manual' });
|
|
134
|
+
if (r.status === 401 || r.status === 403) return true;
|
|
135
|
+
return `this pod serves private documents to strangers (HTTP ${r.status})`;
|
|
136
|
+
}
|
|
@@ -0,0 +1,46 @@
|
|
|
1
|
+
// discovery.mjs — the documents that make a handle resolve.
|
|
2
|
+
//
|
|
3
|
+
// These live at the HOST root, not in the actor's container, because that is
|
|
4
|
+
// the only place the fediverse looks: @name@host is resolved at
|
|
5
|
+
// https://host/.well-known/webfinger and nowhere else. A pod that does not own
|
|
6
|
+
// the root of its host can still publish them, but nothing will ever ask.
|
|
7
|
+
//
|
|
8
|
+
// Every one is public by definition — a discovery document nobody may read
|
|
9
|
+
// discovers nothing — so the Read rule is not a parameter here. It travels
|
|
10
|
+
// with the write because publishing one of these unreadable is a failure mode
|
|
11
|
+
// with an entire verification pass devoted to catching it.
|
|
12
|
+
|
|
13
|
+
const PUBLIC_READ = ['Read'];
|
|
14
|
+
|
|
15
|
+
// ---- the owner's agent ----
|
|
16
|
+
|
|
17
|
+
/** The JRD that answers `acct:name@host`. */
|
|
18
|
+
export async function writeWebfinger(pod, urls, jrd) {
|
|
19
|
+
await pod.putJson(urls.webfinger, jrd, 'application/jrd+json');
|
|
20
|
+
await pod.setAcl(urls.webfinger, PUBLIC_READ);
|
|
21
|
+
}
|
|
22
|
+
|
|
23
|
+
/** RFC 6415 host-meta: the LRDD template some implementations prefer. */
|
|
24
|
+
export async function writeHostMeta(pod, urls, xml) {
|
|
25
|
+
const url = urls.base + '.well-known/host-meta';
|
|
26
|
+
await pod.put(url, xml, 'application/xrd+xml');
|
|
27
|
+
await pod.setAcl(url, PUBLIC_READ);
|
|
28
|
+
}
|
|
29
|
+
|
|
30
|
+
/**
|
|
31
|
+
* NodeInfo, which is two documents: a pointer at the protocol-required root,
|
|
32
|
+
* and the document itself in the actor's own tree.
|
|
33
|
+
*
|
|
34
|
+
* Four requests, one fact — "this pod answers nodeinfo". Split into separate
|
|
35
|
+
* operations, a caller could write the pointer and not what it points at,
|
|
36
|
+
* which is worse than neither.
|
|
37
|
+
*/
|
|
38
|
+
export async function writeNodeinfo(pod, urls, { pointer, doc }) {
|
|
39
|
+
const pointerUrl = urls.base + '.well-known/nodeinfo';
|
|
40
|
+
const docUrl = urls.home + 'ap/nodeinfo-2.0';
|
|
41
|
+
await pod.putJson(pointerUrl, pointer, 'application/json');
|
|
42
|
+
await pod.setAcl(pointerUrl, PUBLIC_READ);
|
|
43
|
+
await pod.putJson(docUrl, doc, 'application/json');
|
|
44
|
+
await pod.setAcl(docUrl, PUBLIC_READ);
|
|
45
|
+
return docUrl;
|
|
46
|
+
}
|
|
@@ -0,0 +1,18 @@
|
|
|
1
|
+
// featured.mjs — ap/featured and ap/moderators: the two small public rosters.
|
|
2
|
+
//
|
|
3
|
+
// Together because both are short, flat, public lists that say "these are the
|
|
4
|
+
// ones that matter", and neither is big enough to page. `featured` is the
|
|
5
|
+
// pinned posts; `moderators` is FEP-1b12's roster, which a recipient validates
|
|
6
|
+
// a group's announced moderation against — published only when a group
|
|
7
|
+
// actually has moderators, since an empty roster and no roster mean different
|
|
8
|
+
// things.
|
|
9
|
+
|
|
10
|
+
import * as collection from './collection.mjs';
|
|
11
|
+
|
|
12
|
+
// ---- the owner's agent ----
|
|
13
|
+
|
|
14
|
+
export const write = (pod, urls, doc) =>
|
|
15
|
+
collection.writeFlat(pod, urls.featured, doc, { publicRead: true });
|
|
16
|
+
|
|
17
|
+
export const writeModerators = (pod, urls, doc) =>
|
|
18
|
+
collection.writeFlat(pod, urls.moderators, doc, { publicRead: true });
|
|
@@ -0,0 +1,24 @@
|
|
|
1
|
+
// followers.mjs — ap/followers: who follows this actor, paged.
|
|
2
|
+
//
|
|
3
|
+
// Paged like the outbox, and for the same reason: a popular account's follower
|
|
4
|
+
// list is large, and a remote server should read a small head rather than pull
|
|
5
|
+
// all of it. Read back to reconcile — anyone the pod says follows us that we
|
|
6
|
+
// have no record of is a sign the local half is BEHIND the pod, and publishing
|
|
7
|
+
// blindly over them would drop them from the wire.
|
|
8
|
+
|
|
9
|
+
import * as collection from './collection.mjs';
|
|
10
|
+
|
|
11
|
+
// ---- the owner's agent ----
|
|
12
|
+
|
|
13
|
+
export const writePage = (pod, pageUrl, doc, opts) => collection.writePage(pod, pageUrl, doc, opts);
|
|
14
|
+
export const writeHead = (pod, urls, doc, opts) => collection.writeHead(pod, urls.followers, doc, opts);
|
|
15
|
+
export const dropPage = (pod, pageUrl) => collection.dropPage(pod, pageUrl);
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* Every follower the pod currently publishes, or null if it publishes none.
|
|
19
|
+
*
|
|
20
|
+
* `alsoItems`, unlike the outbox: the flat followers collection this project
|
|
21
|
+
* used to write put them under `items` rather than `orderedItems`.
|
|
22
|
+
*/
|
|
23
|
+
export const readPublished = (pod, urls) =>
|
|
24
|
+
collection.readPaged(pod, urls.followers, { max: 100_000, alsoItems: true });
|
|
@@ -0,0 +1,10 @@
|
|
|
1
|
+
// following.mjs — ap/following: who this actor follows.
|
|
2
|
+
//
|
|
3
|
+
// Flat, not paged: it is bounded by what one person chose to do, where the
|
|
4
|
+
// followers list is bounded by what everyone else chose.
|
|
5
|
+
|
|
6
|
+
import * as collection from './collection.mjs';
|
|
7
|
+
|
|
8
|
+
// ---- the owner's agent ----
|
|
9
|
+
|
|
10
|
+
export const write = (pod, urls, doc, opts) => collection.writeFlat(pod, urls.following, doc, opts);
|
package/lib/pod/http.mjs
ADDED
|
@@ -0,0 +1,74 @@
|
|
|
1
|
+
// http.mjs — the two HTTP manners this library needs, and nothing else.
|
|
2
|
+
//
|
|
3
|
+
// FediPod has lib/safefetch.mjs, which does far more: DNS pinning, private
|
|
4
|
+
// address refusal, redirect re-checking. None of that can come here, because
|
|
5
|
+
// it imports node:dns and node:net and this library must run unmodified inside
|
|
6
|
+
// a service worker. What IS needed on both sides is a byte budget and a reading
|
|
7
|
+
// of Retry-After, so they live here in a form with no runtime of their own.
|
|
8
|
+
//
|
|
9
|
+
// Deliberately NOT a fetch wrapper. The library never opens a connection by
|
|
10
|
+
// itself; every request goes through a transport or a fetcher the caller
|
|
11
|
+
// supplies, which is what lets the same code serve an authenticated agent, a
|
|
12
|
+
// keyless gateway, and a test with no network at all.
|
|
13
|
+
|
|
14
|
+
// Five megabytes is what the wider project uses as a body budget, and a
|
|
15
|
+
// document this library reads is a pod resource, not a stranger's timeline.
|
|
16
|
+
const MAX_BYTES = 5 * 1024 * 1024;
|
|
17
|
+
|
|
18
|
+
// Thirty minutes is a ceiling, not a policy: a hostile or confused header must
|
|
19
|
+
// not be able to park a caller for a day. Callers that want a tighter ceiling
|
|
20
|
+
// pass their own — the browser transport does.
|
|
21
|
+
const COOLDOWN_MAX_MS = 30 * 60_000;
|
|
22
|
+
|
|
23
|
+
/**
|
|
24
|
+
* How long a server asked to be left alone, or **null** when it did not say.
|
|
25
|
+
*
|
|
26
|
+
* The null matters and must not become a default. The caller decides what
|
|
27
|
+
* absence means: a pod falls back to a flat cooldown, while a delivery queue
|
|
28
|
+
* keeps its exponential ladder — and returning a default here once collapsed
|
|
29
|
+
* that ladder to a flat 60s for every 503 without the header, which is most
|
|
30
|
+
* of them.
|
|
31
|
+
*/
|
|
32
|
+
export function retryAfterMs(res, max = COOLDOWN_MAX_MS) {
|
|
33
|
+
const raw = res?.headers?.get?.('retry-after');
|
|
34
|
+
if (!raw) return null;
|
|
35
|
+
const secs = Number(raw);
|
|
36
|
+
// A floor of one second: a server answering `Retry-After: 0` is still asking
|
|
37
|
+
// for a pause, and honouring it as "none" is how a throttle becomes a spin.
|
|
38
|
+
if (Number.isFinite(secs)) return Math.min(Math.max(secs, 1) * 1000, max);
|
|
39
|
+
const when = Date.parse(raw); // the HTTP-date spelling
|
|
40
|
+
if (Number.isFinite(when)) return Math.min(Math.max(when - Date.now(), 1000), max);
|
|
41
|
+
return null;
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/**
|
|
45
|
+
* Read a response body with a hard byte budget.
|
|
46
|
+
*
|
|
47
|
+
* Checking `content-length` and then handing back `res.text()` is not a cap: a
|
|
48
|
+
* chunked response carries no `content-length` at all, and an inbox listing is
|
|
49
|
+
* public-Append, so its size is in other people's hands. Stream it and stop at
|
|
50
|
+
* the budget.
|
|
51
|
+
*
|
|
52
|
+
* TextDecoder rather than Buffer — it exists in both runtimes — and
|
|
53
|
+
* `stream: true` so a UTF-8 sequence split across two chunks still decodes.
|
|
54
|
+
*/
|
|
55
|
+
export async function readCapped(res, max = MAX_BYTES) {
|
|
56
|
+
const len = Number(res.headers?.get?.('content-length') || 0);
|
|
57
|
+
if (len > max) throw new Error(`response too large (${len} bytes)`);
|
|
58
|
+
if (!res.body) return res.text();
|
|
59
|
+
const reader = res.body.getReader();
|
|
60
|
+
const decoder = new TextDecoder('utf-8');
|
|
61
|
+
let out = '';
|
|
62
|
+
let total = 0;
|
|
63
|
+
for (;;) {
|
|
64
|
+
const { done, value } = await reader.read();
|
|
65
|
+
if (done) break;
|
|
66
|
+
total += value.length;
|
|
67
|
+
if (total > max) {
|
|
68
|
+
await reader.cancel();
|
|
69
|
+
throw new Error(`response exceeded ${max} bytes`);
|
|
70
|
+
}
|
|
71
|
+
out += decoder.decode(value, { stream: true });
|
|
72
|
+
}
|
|
73
|
+
return out + decoder.decode();
|
|
74
|
+
}
|