@jant/core 0.7.1 → 0.8.1
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/bin/commands/assets/prepare.js +3 -3
- package/bin/commands/db/export.js +115 -2
- package/bin/commands/deploy.js +11 -3
- package/bin/commands/{search-reindex.js → search/reindex.js} +5 -5
- package/bin/commands/site/export.js +48 -36
- package/bin/commands/site/import.js +3074 -2
- package/bin/commands/site/snapshot/import.js +2 -0
- package/bin/commands/telegram/register-webhooks.js +48 -23
- package/bin/jant.js +16 -11
- package/bin/lib/command-registry.js +120 -0
- package/bin/lib/migration-artifacts.js +19 -0
- package/bin/lib/renamed-arguments.js +56 -0
- package/bin/lib/site-snapshot.js +83 -1
- package/dist/{app-ZcaI1kPN.js → app--uxnaIRV.js} +8339 -740
- package/dist/client/.vite/manifest.json +3 -3
- package/dist/client/_assets/{client-DAhoqPdr.css → client-BCumu1-D.css} +1 -1
- package/dist/client/_assets/{client-knSEyUJO.js → client-BT6kpcuG.js} +1 -1
- package/dist/client/_assets/{client-auth-CAMfTrKW.js → client-auth-begiT1tq.js} +1 -1
- package/dist/index.js +2 -3
- package/dist/node.js +2 -3
- package/dist/url-CKlGzvdN.js +428 -0
- package/package.json +1 -5
- package/src/__tests__/cli-commands.test.ts +144 -0
- package/src/__tests__/config-docs.test.ts +148 -0
- package/src/__tests__/export-import-roundtrip.test.ts +1 -1
- package/src/__tests__/feed-docs.test.ts +36 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/README.md +89 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/0x4nv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/faqyt/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/archive/_index.md +7 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/city-walks/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/collections/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/current-tea-rotation/_index.md +31 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/desk-but-better/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/e0kcg/_index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/featured/_index.md +7 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-basho/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-epictetus/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-marcus-aurelius/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-seneca/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/from-thoreau/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/2cl6d/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/3zqv7/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/5oxsv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/gkbvv/_index.md +36 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/home-cooking/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/a83qu/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/c91j0/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/qyucy/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/qgfcu/wsgck/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/reading-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/cxiu6/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/t77ms/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/tiny-projects/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/useful-links/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/weekend-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/data/jant.toml +119 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/hugo.toml +43 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/custom.css +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/site-export/themes/jant/static/favicon.ico +0 -0
- package/src/__tests__/fixtures/releases/0.7.0/snapshot/db.sql +218 -0
- package/src/__tests__/fixtures/releases/0.7.0/snapshot/meta.json +9 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/README.md +89 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/0x4nv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/faqyt/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/archive/_index.md +7 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/bought-too-many-lemons-again/_index.md +34 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/city-walks/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/collections/_index.md +4 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/current-tea-rotation/_index.md +31 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/desk-but-better/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/e0kcg/_index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/featured/_index.md +7 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-basho/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-epictetus/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-marcus-aurelius/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-seneca/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/from-thoreau/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/2cl6d/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/3zqv7/index.md +28 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/5oxsv/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/gkbvv/_index.md +36 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/home-cooking/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/a83qu/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/k5vh8/from-seneca-5hibo/index.md +19 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/mynoise-for-rainy-afternoons/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/nts-archives-are-good-cleaning-music/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/c91j0/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/qyucy/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/qgfcu/wsgck/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +43 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/reading-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/cxiu6/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/t77ms/index.md +16 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/te812/the-soup-trick-i-always-forget/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/telk3/from-thoreau-pawt2/index.md +17 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +27 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/tiny-projects/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/useful-links/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/weekend-notes/_index.md +11 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/content/what-i-actually-use-my-notebook-for/_index.md +49 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/data/jant.toml +119 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/hugo.toml +43 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/021801c20ab3-med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/0f868ce9ac84-med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/50c2ad911bad-med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/7a91f0960491-med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8714116d3c8e-med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/8a0b4277443f-med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/a7d1c8a1afd9-med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e25570b405f5-med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/static/media/e89ea4eabf01-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/apple-touch-icon.png +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/custom.css +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/site-export/themes/jant/static/favicon.ico +0 -0
- package/src/__tests__/fixtures/releases/0.7.1/snapshot/db.sql +322 -0
- package/src/__tests__/fixtures/releases/0.7.1/snapshot/meta.json +9 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/README.md +130 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2thjq/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/2u5e5/_index.md +35 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/0x4nv/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/_index.md +44 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/faqyt/index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/41q27/the-potting-mix-guide-i-keep-rereading/index.md +20 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5kayp/_index.md +23 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/_index.md +31 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/5ynfs/hu597/index.md +21 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/_index.md +5 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-night-heron-field-guide-for-my-walk-folder/_index.md +31 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/a-quiet-saturday-after-a-busy-week/_index.md +36 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/archive/_index.md +8 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/are-na-is-the-only-bookmark-pile-i-still-revisit/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/bought-too-many-lemons-again/_index.md +37 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/city-walks/_index.md +12 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshot-for-screenshots-ocr-and-screen-recording-on-the-mac/_index.md +33 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/cleanshotmac-shang-de-jie-tu-ocr-lu-ping-gong-ju/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/co344/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/collections/_index.md +5 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/current-tea-rotation/_index.md +34 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/derek-sivers-still-writes-the-kind-of-internet-i-want-more-of/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/desk-but-better/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/e0kcg/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/egi3c/_index.md +24 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/evf9j/_index.md +152 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/featured/_index.md +8 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-basho/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-epictetus/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-marcus-aurelius/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-seneca/_index.md +26 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/from-thoreau/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/2cl6d/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/3zqv7/index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/5oxsv/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gkbvv/_index.md +39 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/gwob9/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/home-cooking/_index.md +12 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/hz729/_index.md +24 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/inaturalist-ai-zi-ran-she-qu/_index.md +44 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/j4v0q/_index.md +35 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k278t/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k4eee/_index.md +22 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a-reading-log-idea-i-might-steal/index.md +20 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/a83qu/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/k5vh8/from-seneca-5hibo/index.md +21 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/kan-qi-lai-bi-jiao-ku-de-gong-si-men/_index.md +41 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/l2m7y/_index.md +29 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/lan-ya-yao-kong-qi-chuang-shang-yue-du-de-fan-ye-shen-qi/_index.md +57 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/mynoise-for-rainy-afternoons/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/n09le/_index.md +23 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/ni-fu-jin-de-wei-ji-bai-ke-tiao-mu/_index.md +42 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/nts-archives-are-good-cleaning-music/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/c91j0/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/qyucy/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/qgfcu/wsgck/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/rain-makes-my-neighborhood-look-better/_index.md +46 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/reading-notes/_index.md +12 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/s4r3e/_index.md +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/serious-eats-on-tomato-and-egg-soup/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/_index.md +44 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/cxiu6/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/t77ms/index.md +18 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/te812/the-soup-trick-i-always-forget/index.md +20 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/telk3/from-thoreau-pawt2/index.md +21 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-five-minute-reset-is-still-the-best-habit-i-have/_index.md +36 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-hallway-light-took-12-minutes-and-3-months/_index.md +32 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/the-recurse-center-manual-is-weirdly-calming/_index.md +30 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tiny-projects/_index.md +12 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tong-wang-xing-fu-zhi-lu/_index.md +68 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/tou-ma-yan-jiang-ju-le-bu-chu-ti-yan/_index.md +62 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/useful-links/_index.md +12 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/weekend-notes/_index.md +12 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/content/what-i-actually-use-my-notebook-for/_index.md +52 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/data/jant.toml +124 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/hugo.toml +45 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/_redirects +25 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/15d51730a4f7-med_01kn8jtq3penf98tfq4gzmh9g9.png +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jtx8qenf98tm9ahxr48sw.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv0jdenf98tp6qr9zgjjc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jv452enf98trbkwrvhvgd.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvb16enf98txp7p0pf5ge.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jve5nenf98tzap11gpxzr.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvq58enf98v538w5vsqp4.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jvsaeenf98v6ct4gjzppc.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01kn8jw26cenf98vc7k0ppz5k8.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q1hme4e8cmby77dn66yy.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q2w7e4e8cmc20036yh66.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q7d2e4e8cmdeqjmyafby.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m313q887e4e8cmdjssych7yh.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp-poster.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167jx2f6ct88pkz45j3ycp.mp4 +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf-poster.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167mbdf6ct88pr4ga1b9kf.mp4 +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb-poster.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167nsvf6ct88q1anhz4svb.mp4 +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83-poster.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167qaxf6ct88qfndwzxx83.mp4 +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167sm0f6ct88qw5brtsgcw.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167tf8f6ct88r169s51j49.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167vaaf6ct88rbx5ztenwb.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167w51f6ct88rp19pybkw1.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167x0nf6ct88rzajb84tw3.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167xxbf6ct88s5t2300bjk.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167yq5f6ct88s9pjwt5fxg.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/static/media/med_01m3167zg4f6ct88sge8jp28ja.webp +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/apple-touch-icon.png +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/custom.css +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/themes/jant/static/favicon.ico +0 -0
- package/src/__tests__/fixtures/releases/0.8.0/site-export/wrangler.jsonc +24 -0
- package/src/__tests__/fixtures/releases/0.8.0/snapshot/db.sql +322 -0
- package/src/__tests__/fixtures/releases/0.8.0/snapshot/meta.json +11 -0
- package/src/__tests__/helpers/cursor-walk.ts +52 -0
- package/src/__tests__/helpers/site-export-import.ts +97 -0
- package/src/__tests__/import-site-command.test.ts +27 -1
- package/src/__tests__/release-fixtures.test.ts +136 -0
- package/src/__tests__/site-export-canonical-import.test.ts +11 -47
- package/src/__tests__/theme-docs.test.ts +109 -0
- package/src/app.tsx +1 -5
- package/src/db/rehearsal-fixtures/pg-demo-current.json +55 -0
- package/src/db/rehearsal-fixtures/pg-demo-current.sql +431 -0
- package/src/i18n/locales/public/en.po +0 -2
- package/src/i18n/locales/public/zh-Hans.po +0 -2
- package/src/i18n/locales/public/zh-Hant.po +0 -2
- package/src/index.ts +6 -77
- package/src/lib/__tests__/post-list-cursor.test.ts +105 -0
- package/src/lib/__tests__/timeline.test.ts +14 -14
- package/src/lib/__tests__/view.test.ts +0 -46
- package/src/lib/feed.ts +0 -6
- package/src/lib/post-list-cursor.ts +211 -0
- package/src/lib/view.ts +0 -27
- package/src/node/__tests__/cli-export.test.ts +2 -2
- package/src/node/__tests__/cli-site-snapshot.test.ts +6 -0
- package/src/node/__tests__/cli-site-token-env.test.ts +4 -1
- package/src/node/__tests__/cli-snapshot-meta.test.ts +64 -0
- package/src/routes/api/__tests__/mcp.test.ts +58 -0
- package/src/routes/api/__tests__/posts.test.ts +79 -0
- package/src/routes/api/internal/search-reindex.ts +1 -1
- package/src/routes/api/posts.ts +5 -9
- package/src/routes/api/public/__tests__/archive.test.ts +261 -0
- package/src/routes/api/public/__tests__/posts.test.ts +344 -19
- package/src/routes/api/public/archive.ts +18 -16
- package/src/routes/api/public/posts.ts +15 -16
- package/src/services/__tests__/media.test.ts +0 -271
- package/src/services/__tests__/post.test.ts +342 -36
- package/src/services/export.ts +13 -5
- package/src/services/mcp.ts +6 -11
- package/src/services/media.ts +1 -219
- package/src/services/post.ts +513 -319
- package/src/styles/ui.css +0 -118
- package/src/ui/shared/Pagination.tsx +1 -1
- package/bin/commands/export.js +0 -120
- package/bin/commands/import-site.js +0 -3034
- package/bin/commands/migrate-text-attachments.js +0 -181
- package/dist/github-sync-Gw4orAHk.js +0 -8398
- package/src/client/multipart-upload.ts +0 -206
- package/src/routes/api/__tests__/upload-multipart.test.ts +0 -739
- package/src/routes/api/internal/text-attachments.ts +0 -60
- package/src/routes/api/upload-multipart.ts +0 -366
|
@@ -12,6 +12,7 @@ import { deleteR2Object, uploadR2Object } from "../../../lib/r2-query.js";
|
|
|
12
12
|
import {
|
|
13
13
|
assertSnapshotDialectMatches,
|
|
14
14
|
assertSnapshotMeta,
|
|
15
|
+
assertSnapshotSchemaInstalled,
|
|
15
16
|
buildMediaProviderSql,
|
|
16
17
|
DEFER_FOREIGN_KEYS_SQL,
|
|
17
18
|
buildReplaceSql,
|
|
@@ -273,6 +274,7 @@ export async function run(argv) {
|
|
|
273
274
|
try {
|
|
274
275
|
const meta = await readSnapshotJson(materialized.rootDir, "meta.json");
|
|
275
276
|
assertSnapshotMeta(meta);
|
|
277
|
+
assertSnapshotSchemaInstalled(meta);
|
|
276
278
|
assertSnapshotDialectMatches(meta, context.dialect);
|
|
277
279
|
const explicitRemap = values["remap-site"] === true;
|
|
278
280
|
const snapshotSite = getSnapshotBootstrapSite(meta);
|
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import { parseArgs } from "node:util";
|
|
2
2
|
import { autoloadNodeEnv } from "../../lib/node-env.js";
|
|
3
|
+
import { findRenamedOption } from "../../lib/renamed-arguments.js";
|
|
4
|
+
import { resolveSiteUrl } from "../../lib/site-url.js";
|
|
3
5
|
|
|
4
6
|
const TELEGRAM_API_BASE = "https://api.telegram.org";
|
|
5
7
|
|
|
@@ -16,40 +18,63 @@ async function callTelegram(token, method, body) {
|
|
|
16
18
|
return payload.result;
|
|
17
19
|
}
|
|
18
20
|
|
|
21
|
+
function printUsage() {
|
|
22
|
+
console.log("Usage: jant telegram register-webhooks [--url <url>]");
|
|
23
|
+
console.log("");
|
|
24
|
+
console.log(
|
|
25
|
+
"Registers a webhook for every bot in TELEGRAM_BOT_TOKENS, pointing at",
|
|
26
|
+
);
|
|
27
|
+
console.log("<url>/api/telegram/webhook/<bot_id> with the shared");
|
|
28
|
+
console.log("TELEGRAM_WEBHOOK_SECRET. Run once after configuring the pool.");
|
|
29
|
+
console.log("");
|
|
30
|
+
console.log("Options:");
|
|
31
|
+
console.log(" --url The site's public URL");
|
|
32
|
+
console.log("");
|
|
33
|
+
console.log(
|
|
34
|
+
"If --url is omitted, uses SITE_ORIGIN + SITE_PATH_PREFIX from the environment.",
|
|
35
|
+
);
|
|
36
|
+
console.log("");
|
|
37
|
+
console.log("Environment (also read from .env.node):");
|
|
38
|
+
console.log(
|
|
39
|
+
" TELEGRAM_BOT_TOKENS Comma-separated <bot_id>:<secret> tokens",
|
|
40
|
+
);
|
|
41
|
+
console.log(
|
|
42
|
+
" TELEGRAM_WEBHOOK_SECRET Shared secret_token for the webhooks",
|
|
43
|
+
);
|
|
44
|
+
}
|
|
45
|
+
|
|
19
46
|
export async function run(argv) {
|
|
47
|
+
const renamed = findRenamedOption("telegram register-webhooks", argv, {
|
|
48
|
+
"--base-url": "--url",
|
|
49
|
+
});
|
|
50
|
+
if (renamed) {
|
|
51
|
+
console.error(`Error: ${renamed}`);
|
|
52
|
+
process.exit(1);
|
|
53
|
+
}
|
|
54
|
+
|
|
20
55
|
const { values } = parseArgs({
|
|
21
56
|
args: argv,
|
|
22
57
|
options: {
|
|
23
|
-
|
|
58
|
+
url: { type: "string" },
|
|
24
59
|
help: { type: "boolean", short: "h" },
|
|
25
60
|
},
|
|
26
61
|
});
|
|
27
62
|
|
|
28
|
-
if (values.help
|
|
29
|
-
|
|
30
|
-
|
|
31
|
-
);
|
|
32
|
-
console.log("");
|
|
33
|
-
console.log(
|
|
34
|
-
"Registers a webhook for every bot in TELEGRAM_BOT_TOKENS, pointing at",
|
|
35
|
-
);
|
|
36
|
-
console.log("<base-url>/api/telegram/webhook/<bot_id> with the shared");
|
|
37
|
-
console.log(
|
|
38
|
-
"TELEGRAM_WEBHOOK_SECRET. Run once after configuring the pool.",
|
|
39
|
-
);
|
|
40
|
-
console.log("");
|
|
41
|
-
console.log("Environment (also read from .env.node):");
|
|
42
|
-
console.log(
|
|
43
|
-
" TELEGRAM_BOT_TOKENS Comma-separated <bot_id>:<secret> tokens",
|
|
44
|
-
);
|
|
45
|
-
console.log(
|
|
46
|
-
" TELEGRAM_WEBHOOK_SECRET Shared secret_token for the webhooks",
|
|
47
|
-
);
|
|
48
|
-
process.exit(values.help ? 0 : 1);
|
|
63
|
+
if (values.help) {
|
|
64
|
+
printUsage();
|
|
65
|
+
process.exit(0);
|
|
49
66
|
}
|
|
50
67
|
|
|
51
68
|
autoloadNodeEnv();
|
|
52
69
|
|
|
70
|
+
const siteUrl = resolveSiteUrl({ url: values.url });
|
|
71
|
+
if (!siteUrl) {
|
|
72
|
+
console.error(
|
|
73
|
+
"Error: telegram register-webhooks requires --url or SITE_ORIGIN in the environment.",
|
|
74
|
+
);
|
|
75
|
+
process.exit(1);
|
|
76
|
+
}
|
|
77
|
+
|
|
53
78
|
const rawTokens = process.env.TELEGRAM_BOT_TOKENS ?? "";
|
|
54
79
|
const secret = process.env.TELEGRAM_WEBHOOK_SECRET ?? "";
|
|
55
80
|
if (!rawTokens.trim()) {
|
|
@@ -61,7 +86,7 @@ export async function run(argv) {
|
|
|
61
86
|
process.exit(1);
|
|
62
87
|
}
|
|
63
88
|
|
|
64
|
-
const baseUrl =
|
|
89
|
+
const baseUrl = siteUrl.replace(/\/+$/, "");
|
|
65
90
|
const tokens = rawTokens
|
|
66
91
|
.split(",")
|
|
67
92
|
.map((entry) => entry.trim())
|
package/bin/jant.js
CHANGED
|
@@ -2,7 +2,8 @@
|
|
|
2
2
|
|
|
3
3
|
import { readdir } from "node:fs/promises";
|
|
4
4
|
import { fileURLToPath } from "node:url";
|
|
5
|
-
import { dirname, join,
|
|
5
|
+
import { dirname, join, relative } from "node:path";
|
|
6
|
+
import { PUBLIC_COMMAND_GROUPS } from "./lib/command-registry.js";
|
|
6
7
|
|
|
7
8
|
const __dirname = dirname(fileURLToPath(import.meta.url));
|
|
8
9
|
const commandsDir = join(__dirname, "commands");
|
|
@@ -32,15 +33,19 @@ async function listCommands() {
|
|
|
32
33
|
return commands;
|
|
33
34
|
}
|
|
34
35
|
|
|
35
|
-
|
|
36
|
-
const
|
|
36
|
+
function showHelp() {
|
|
37
|
+
const width = Math.max(
|
|
38
|
+
...PUBLIC_COMMAND_GROUPS.flatMap((group) =>
|
|
39
|
+
group.commands.map((command) => command.name.length),
|
|
40
|
+
),
|
|
41
|
+
);
|
|
37
42
|
console.log("Usage: jant <command> [options]");
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
43
|
+
for (const group of PUBLIC_COMMAND_GROUPS) {
|
|
44
|
+
console.log("");
|
|
45
|
+
console.log(`${group.title}:`);
|
|
46
|
+
for (const command of group.commands) {
|
|
47
|
+
console.log(` ${command.name.padEnd(width)} ${command.summary}`);
|
|
48
|
+
}
|
|
44
49
|
}
|
|
45
50
|
console.log("");
|
|
46
51
|
console.log("Run 'jant <command> --help' for command-specific help.");
|
|
@@ -49,7 +54,7 @@ async function showHelp() {
|
|
|
49
54
|
const argv = process.argv.slice(2);
|
|
50
55
|
const commandStart = argv.findIndex((arg) => !arg.startsWith("-"));
|
|
51
56
|
if (commandStart === -1) {
|
|
52
|
-
|
|
57
|
+
showHelp();
|
|
53
58
|
process.exit(0);
|
|
54
59
|
}
|
|
55
60
|
|
|
@@ -80,7 +85,7 @@ for (let length = positionalTail.length; length >= 1; length -= 1) {
|
|
|
80
85
|
if (!matched) {
|
|
81
86
|
console.error(`Unknown command: ${positionalTail[0]}`);
|
|
82
87
|
console.error("");
|
|
83
|
-
|
|
88
|
+
showHelp();
|
|
84
89
|
process.exit(1);
|
|
85
90
|
}
|
|
86
91
|
|
|
@@ -0,0 +1,120 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Every `jant` command, classified.
|
|
3
|
+
*
|
|
4
|
+
* Public commands are part of Jant's compatibility promise: their names,
|
|
5
|
+
* options, and behavior change only in a major release, and `docs/cli.md`
|
|
6
|
+
* documents each one. Internal commands are build and operations tooling for
|
|
7
|
+
* the Jant repository and the hosted service. They still run, but help leaves
|
|
8
|
+
* them out and they can change in any release.
|
|
9
|
+
*
|
|
10
|
+
* `src/__tests__/cli-commands.test.ts` fails when a file under
|
|
11
|
+
* `bin/commands/` is in neither list, so a new command has to be classified
|
|
12
|
+
* before it ships.
|
|
13
|
+
*/
|
|
14
|
+
|
|
15
|
+
/**
|
|
16
|
+
* @typedef {object} PublicCommand
|
|
17
|
+
* @property {string} name Space-separated command path, e.g. `site export`
|
|
18
|
+
* @property {string} summary One-line description shown by `jant --help`
|
|
19
|
+
*/
|
|
20
|
+
|
|
21
|
+
/**
|
|
22
|
+
* @typedef {object} PublicCommandGroup
|
|
23
|
+
* @property {string} title Group heading shown by `jant --help`
|
|
24
|
+
* @property {PublicCommand[]} commands Commands in display order
|
|
25
|
+
*/
|
|
26
|
+
|
|
27
|
+
/** @type {PublicCommandGroup[]} */
|
|
28
|
+
export const PUBLIC_COMMAND_GROUPS = [
|
|
29
|
+
{
|
|
30
|
+
title: "Set up and run",
|
|
31
|
+
commands: [
|
|
32
|
+
{
|
|
33
|
+
name: "setup",
|
|
34
|
+
summary: "Create the owner account and site without a browser",
|
|
35
|
+
},
|
|
36
|
+
{ name: "start", summary: "Start the Node.js server" },
|
|
37
|
+
{
|
|
38
|
+
name: "migrate",
|
|
39
|
+
summary: "Apply database migrations and data backfills",
|
|
40
|
+
},
|
|
41
|
+
{
|
|
42
|
+
name: "deploy",
|
|
43
|
+
summary: "Apply remote migrations and deploy to Cloudflare Workers",
|
|
44
|
+
},
|
|
45
|
+
{
|
|
46
|
+
name: "reset-password",
|
|
47
|
+
summary: "Generate a password reset token",
|
|
48
|
+
},
|
|
49
|
+
],
|
|
50
|
+
},
|
|
51
|
+
{
|
|
52
|
+
title: "Move and back up content",
|
|
53
|
+
commands: [
|
|
54
|
+
{
|
|
55
|
+
name: "site export",
|
|
56
|
+
summary: "Export a site as a Hugo site, as a ZIP or a directory",
|
|
57
|
+
},
|
|
58
|
+
{ name: "site import", summary: "Import a Hugo site export into a site" },
|
|
59
|
+
{
|
|
60
|
+
name: "site pull-media",
|
|
61
|
+
summary: "Download the media a site export refers to",
|
|
62
|
+
},
|
|
63
|
+
{
|
|
64
|
+
name: "site snapshot export",
|
|
65
|
+
summary: "Export a snapshot that keeps IDs, storage keys, and files",
|
|
66
|
+
},
|
|
67
|
+
{
|
|
68
|
+
name: "site snapshot import",
|
|
69
|
+
summary: "Restore a snapshot into a site",
|
|
70
|
+
},
|
|
71
|
+
{ name: "db export", summary: "Export the database to a SQL file" },
|
|
72
|
+
],
|
|
73
|
+
},
|
|
74
|
+
{
|
|
75
|
+
title: "Maintenance",
|
|
76
|
+
commands: [
|
|
77
|
+
{ name: "search reindex", summary: "Rebuild the search index" },
|
|
78
|
+
{
|
|
79
|
+
name: "posts rebuild-html",
|
|
80
|
+
summary: "Rebuild stored post HTML at the current format",
|
|
81
|
+
},
|
|
82
|
+
{
|
|
83
|
+
name: "uploads cleanup",
|
|
84
|
+
summary: "Clear expired uploads and purge deleted media",
|
|
85
|
+
},
|
|
86
|
+
{
|
|
87
|
+
name: "telegram register-webhooks",
|
|
88
|
+
summary: "Register the webhooks of the Telegram bots",
|
|
89
|
+
},
|
|
90
|
+
],
|
|
91
|
+
},
|
|
92
|
+
];
|
|
93
|
+
|
|
94
|
+
/**
|
|
95
|
+
* Build and operations tooling, left out of help and out of the
|
|
96
|
+
* compatibility promise.
|
|
97
|
+
*
|
|
98
|
+
* @type {string[]}
|
|
99
|
+
*/
|
|
100
|
+
export const INTERNAL_COMMANDS = [
|
|
101
|
+
"assets prepare",
|
|
102
|
+
"assets upload",
|
|
103
|
+
"db execute-file",
|
|
104
|
+
"db rehearse",
|
|
105
|
+
];
|
|
106
|
+
|
|
107
|
+
/**
|
|
108
|
+
* Names of all public commands, in display order.
|
|
109
|
+
*
|
|
110
|
+
* @returns {string[]} Space-separated command paths
|
|
111
|
+
* @example
|
|
112
|
+
* ```js
|
|
113
|
+
* listPublicCommandNames(); // ["setup", "start", …, "telegram register-webhooks"]
|
|
114
|
+
* ```
|
|
115
|
+
*/
|
|
116
|
+
export function listPublicCommandNames() {
|
|
117
|
+
return PUBLIC_COMMAND_GROUPS.flatMap((group) =>
|
|
118
|
+
group.commands.map((command) => command.name),
|
|
119
|
+
);
|
|
120
|
+
}
|
|
@@ -19,6 +19,25 @@ export function resolveBundledBackfillsDir(moduleUrl = import.meta.url) {
|
|
|
19
19
|
return join(resolveBundledDbDir(moduleUrl), "backfills");
|
|
20
20
|
}
|
|
21
21
|
|
|
22
|
+
/**
|
|
23
|
+
* Directory of the schema migrations this package ships for a dialect.
|
|
24
|
+
*
|
|
25
|
+
* @param {"sqlite" | "pg"} dialect SQLite (D1 and Node) or Postgres
|
|
26
|
+
* @param {string} [moduleUrl] Module URL the package root is resolved from
|
|
27
|
+
* @returns {string} Absolute path of the migrations directory
|
|
28
|
+
* @example
|
|
29
|
+
* ```js
|
|
30
|
+
* resolveBundledSchemaMigrationsDir("pg"); // ".../src/db/migrations/pg"
|
|
31
|
+
* ```
|
|
32
|
+
*/
|
|
33
|
+
export function resolveBundledSchemaMigrationsDir(
|
|
34
|
+
dialect,
|
|
35
|
+
moduleUrl = import.meta.url,
|
|
36
|
+
) {
|
|
37
|
+
const dir = join(resolveBundledDbDir(moduleUrl), "migrations");
|
|
38
|
+
return dialect === "pg" ? join(dir, "pg") : dir;
|
|
39
|
+
}
|
|
40
|
+
|
|
22
41
|
export function extractNumberPrefix(name) {
|
|
23
42
|
const match = String(name).match(/^(\d+)/);
|
|
24
43
|
return match ? match[1] : null;
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Answer the argument forms that 0.8.0 renamed with their replacement.
|
|
3
|
+
*
|
|
4
|
+
* `parseArgs` would report an old option as a bare "Unknown option", and an
|
|
5
|
+
* old positional site URL as an unexpected argument. These helpers name the
|
|
6
|
+
* form to use instead, so a script written for 0.7 fails with the fix in the
|
|
7
|
+
* message.
|
|
8
|
+
*/
|
|
9
|
+
|
|
10
|
+
/**
|
|
11
|
+
* Find the first option in `argv` that was renamed.
|
|
12
|
+
*
|
|
13
|
+
* @param {string} command Command path, e.g. `site export`
|
|
14
|
+
* @param {string[]} argv Arguments after the command path
|
|
15
|
+
* @param {Record<string, string>} renamed Old option (`--directory`, `-d`) → what to pass instead
|
|
16
|
+
* @returns {string | null} An error message, or null when no renamed option is used
|
|
17
|
+
* @example
|
|
18
|
+
* ```js
|
|
19
|
+
* findRenamedOption("deploy", ["--site-path-prefix", "/blog"], {
|
|
20
|
+
* "--site-path-prefix": "--path-prefix",
|
|
21
|
+
* });
|
|
22
|
+
* // "jant deploy no longer takes --site-path-prefix. Use --path-prefix."
|
|
23
|
+
* ```
|
|
24
|
+
*/
|
|
25
|
+
export function findRenamedOption(command, argv, renamed) {
|
|
26
|
+
for (const arg of argv) {
|
|
27
|
+
if (arg === "--") break;
|
|
28
|
+
if (!arg.startsWith("-")) continue;
|
|
29
|
+
const option = arg.split("=")[0];
|
|
30
|
+
if (Object.hasOwn(renamed, option)) {
|
|
31
|
+
return `jant ${command} no longer takes ${option}. Use ${renamed[option]}.`;
|
|
32
|
+
}
|
|
33
|
+
}
|
|
34
|
+
return null;
|
|
35
|
+
}
|
|
36
|
+
|
|
37
|
+
/**
|
|
38
|
+
* Describe a positional site URL, which `--url` replaced.
|
|
39
|
+
*
|
|
40
|
+
* @param {string} command Command path, e.g. `site import`
|
|
41
|
+
* @param {string[]} positionals Positional arguments `parseArgs` collected
|
|
42
|
+
* @returns {string | null} An error message, or null when there are none
|
|
43
|
+
* @example
|
|
44
|
+
* ```js
|
|
45
|
+
* findPositionalUrl("site export", ["https://example.com"]);
|
|
46
|
+
* // "jant site export takes the site as --url. Run: jant site export --url https://example.com"
|
|
47
|
+
* ```
|
|
48
|
+
*/
|
|
49
|
+
export function findPositionalUrl(command, positionals) {
|
|
50
|
+
if (positionals.length === 0) return null;
|
|
51
|
+
const [first] = positionals;
|
|
52
|
+
if (/^https?:\/\//i.test(first)) {
|
|
53
|
+
return `jant ${command} takes the site as --url. Run: jant ${command} --url ${first}`;
|
|
54
|
+
}
|
|
55
|
+
return `jant ${command} takes no positional arguments: ${positionals.join(" ")}`;
|
|
56
|
+
}
|
package/bin/lib/site-snapshot.js
CHANGED
|
@@ -1,5 +1,10 @@
|
|
|
1
|
+
import { readFileSync } from "node:fs";
|
|
1
2
|
import { readdir } from "node:fs/promises";
|
|
2
3
|
import { join, relative } from "node:path";
|
|
4
|
+
import {
|
|
5
|
+
listSchemaMigrationFiles,
|
|
6
|
+
resolveBundledSchemaMigrationsDir,
|
|
7
|
+
} from "./migration-artifacts.js";
|
|
3
8
|
|
|
4
9
|
export const SNAPSHOT_FORMAT = "jant-site-snapshot";
|
|
5
10
|
export const SNAPSHOT_VERSION = 2;
|
|
@@ -346,6 +351,43 @@ export function snapshotObjectPath(key) {
|
|
|
346
351
|
|
|
347
352
|
export const SNAPSHOT_DIALECTS = ["sqlite", "pg"];
|
|
348
353
|
|
|
354
|
+
/**
|
|
355
|
+
* Version of the installed `@jant/core`, which a snapshot records as `jant`.
|
|
356
|
+
*
|
|
357
|
+
* @returns {string} The package version, e.g. `0.8.0`
|
|
358
|
+
*/
|
|
359
|
+
export function readInstalledJantVersion() {
|
|
360
|
+
const packageJson = JSON.parse(
|
|
361
|
+
readFileSync(new URL("../../package.json", import.meta.url), "utf8"),
|
|
362
|
+
);
|
|
363
|
+
return String(packageJson.version);
|
|
364
|
+
}
|
|
365
|
+
|
|
366
|
+
/**
|
|
367
|
+
* Schema migrations the installed `@jant/core` ships for a dialect, oldest
|
|
368
|
+
* first.
|
|
369
|
+
*
|
|
370
|
+
* @param {"sqlite" | "pg"} dialect Snapshot dialect
|
|
371
|
+
* @returns {string[]} Migration tags, e.g. `0034_cheerful_rumiko_fujikawa`
|
|
372
|
+
*/
|
|
373
|
+
export function listInstalledSchemaTags(dialect) {
|
|
374
|
+
return listSchemaMigrationFiles(
|
|
375
|
+
resolveBundledSchemaMigrationsDir(dialect),
|
|
376
|
+
).map((migration) => migration.tag);
|
|
377
|
+
}
|
|
378
|
+
|
|
379
|
+
/**
|
|
380
|
+
* Build a snapshot's `meta.json`.
|
|
381
|
+
*
|
|
382
|
+
* Besides the format, it records the `@jant/core` version that wrote the
|
|
383
|
+
* snapshot (`jant`) and, when the dialect is known, the last schema migration
|
|
384
|
+
* that version ships (`schema`). The CLI that exports is the one the site
|
|
385
|
+
* runs and migrates with, so `schema` is the schema the rows were read from.
|
|
386
|
+
*
|
|
387
|
+
* @param {{ id: string, key: string }} site The exported site
|
|
388
|
+
* @param {{ dialect?: "sqlite" | "pg" }} [options] Source database dialect
|
|
389
|
+
* @returns {SnapshotMeta} The object to write as `meta.json`
|
|
390
|
+
*/
|
|
349
391
|
export function buildSnapshotMeta(site, options = {}) {
|
|
350
392
|
const dialect = options.dialect;
|
|
351
393
|
if (dialect && !SNAPSHOT_DIALECTS.includes(dialect)) {
|
|
@@ -354,10 +396,14 @@ export function buildSnapshotMeta(site, options = {}) {
|
|
|
354
396
|
);
|
|
355
397
|
}
|
|
356
398
|
|
|
399
|
+
const schema = dialect ? listInstalledSchemaTags(dialect).at(-1) : undefined;
|
|
400
|
+
|
|
357
401
|
return {
|
|
358
402
|
format: SNAPSHOT_FORMAT,
|
|
359
403
|
version: SNAPSHOT_VERSION,
|
|
360
404
|
...(dialect ? { dialect } : {}),
|
|
405
|
+
jant: readInstalledJantVersion(),
|
|
406
|
+
...(schema ? { schema } : {}),
|
|
361
407
|
site: {
|
|
362
408
|
id: site.id,
|
|
363
409
|
key: site.key,
|
|
@@ -372,6 +418,10 @@ export function buildSnapshotMeta(site, options = {}) {
|
|
|
372
418
|
* @property {typeof SNAPSHOT_FORMAT} format
|
|
373
419
|
* @property {number} version One of `SUPPORTED_SNAPSHOT_VERSIONS`
|
|
374
420
|
* @property {"sqlite" | "pg"} [dialect] Absent from snapshots that predate it
|
|
421
|
+
* @property {string} [jant] The `@jant/core` version that wrote the snapshot;
|
|
422
|
+
* absent before 0.8.0
|
|
423
|
+
* @property {string} [schema] The last schema migration of that version, for
|
|
424
|
+
* `dialect`; absent before 0.8.0
|
|
375
425
|
* @property {{ id: string, key: string }} [site] The site the snapshot was
|
|
376
426
|
* exported from; absent from legacy snapshots
|
|
377
427
|
* @property {unknown} [tables] Listed by legacy snapshots only
|
|
@@ -419,6 +469,38 @@ export function assertSnapshotMeta(meta) {
|
|
|
419
469
|
) {
|
|
420
470
|
throw new Error("Snapshot meta site must contain string id and key.");
|
|
421
471
|
}
|
|
472
|
+
|
|
473
|
+
for (const field of ["jant", "schema"]) {
|
|
474
|
+
if (meta[field] !== undefined && typeof meta[field] !== "string") {
|
|
475
|
+
throw new Error(`Snapshot meta ${field} must be a string.`);
|
|
476
|
+
}
|
|
477
|
+
}
|
|
478
|
+
}
|
|
479
|
+
|
|
480
|
+
/**
|
|
481
|
+
* Refuse a snapshot written by a newer Jant than the installed one.
|
|
482
|
+
*
|
|
483
|
+
* A snapshot's rows fit the schema it records. When the installed
|
|
484
|
+
* `@jant/core` does not ship that migration, its schema is older than the
|
|
485
|
+
* snapshot's, and the rows can name columns it doesn't have. Snapshots from
|
|
486
|
+
* before 0.8.0 record no schema and are accepted.
|
|
487
|
+
*
|
|
488
|
+
* @param {SnapshotMeta} meta Checked by `assertSnapshotMeta`
|
|
489
|
+
* @returns {void}
|
|
490
|
+
* @throws {Error} When the installed package lacks the snapshot's schema
|
|
491
|
+
* @example
|
|
492
|
+
* assertSnapshotSchemaInstalled({ format: "jant-site-snapshot", version: 2, schema: "9999_later" });
|
|
493
|
+
* // throws: This snapshot was written by a newer Jant …
|
|
494
|
+
*/
|
|
495
|
+
export function assertSnapshotSchemaInstalled(meta) {
|
|
496
|
+
if (typeof meta.schema !== "string") return;
|
|
497
|
+
const dialect = meta.dialect ?? "sqlite";
|
|
498
|
+
if (listInstalledSchemaTags(dialect).includes(meta.schema)) return;
|
|
499
|
+
|
|
500
|
+
const writer = meta.jant ? `Jant ${meta.jant}` : "a newer Jant";
|
|
501
|
+
throw new Error(
|
|
502
|
+
`This snapshot was written by ${writer}, whose schema reaches ${meta.schema}. The installed @jant/core (${readInstalledJantVersion()}) doesn't have that migration. Upgrade @jant/core, run jant migrate, then import again.`,
|
|
503
|
+
);
|
|
422
504
|
}
|
|
423
505
|
|
|
424
506
|
/**
|
|
@@ -451,7 +533,7 @@ export function assertSnapshotDialectMatches(meta, targetDialect) {
|
|
|
451
533
|
`Snapshot dialect mismatch: source is ${sourceDialect}, target is ${targetDialect}.`,
|
|
452
534
|
"Snapshot db.sql is dialect-specific (BLOB literals, generated columns, FTS, etc.)",
|
|
453
535
|
"and cannot be replayed across SQLite and Postgres safely.",
|
|
454
|
-
"Use `jant site export <url>` (HTTP, dialect-neutral) to move content between",
|
|
536
|
+
"Use `jant site export --url <url>` (HTTP, dialect-neutral) to move content between",
|
|
455
537
|
"different DB engines.",
|
|
456
538
|
].join("\n"),
|
|
457
539
|
);
|