+22

.tangled/workflows/lint.yml

··· 1 1 + # Biome lint and format checks 2 2 + 3 3 + when: 4 4 + - event: ["push", "manual"] 5 5 + branch: ["main"] 6 6 + - event: ["pull_request"] 7 7 + branch: ["main"] 8 8 + 9 9 + engine: "nixery" 10 10 + 11 11 + dependencies: 12 12 + nixpkgs: 13 13 + - bun 14 14 + - biome 15 15 + 16 16 + steps: 17 17 + - name: "Install dependencies" 18 18 + command: "bun install" 19 19 + - name: "Lint check" 20 20 + command: "cd packages/cli && biome lint ." 21 21 + - name: "Format check" 22 22 + command: "cd packages/cli && biome format ."

+146

CHANGELOG.md

··· 1 1 + ## [0.4.0] - 2026-02-07 2 2 + 3 3 + ### 🚀 Features 4 4 + 5 5 + - Initial ui components 6 6 + 7 7 + ### ⚙️ Miscellaneous Tasks 8 8 + 9 9 + - Small updates 10 10 + - Refactored package into existing cli 11 11 + - Tested comments in docs 12 12 + - Updated thread style and added test.html 13 13 + - Update docs 14 14 + - Updated comments 15 15 + - Lint 16 16 + 17 17 + ## [0.3.3] - 2026-02-05 18 18 + 19 19 + ### ⚙️ Miscellaneous Tasks 20 20 + 21 21 + - Cleaned up remaining auth implementations 22 22 + - Format 23 23 + - Release 0.3.3 24 24 + ## [0.3.2] - 2026-02-05 25 25 + 26 26 + ### 🐛 Bug Fixes 27 27 + 28 28 + - Fixed issue with auth selection in init command 29 29 + 30 30 + ### ⚙️ Miscellaneous Tasks 31 31 + 32 32 + - Release 0.3.2 33 33 + ## [0.3.1] - 2026-02-04 34 34 + 35 35 + ### 🐛 Bug Fixes 36 36 + 37 37 + - Asset subdirectories 38 38 + 39 39 + ### ⚙️ Miscellaneous Tasks 40 40 + 41 41 + - Updated authentication ux 42 42 + - Release 0.3.1 43 43 + - Bumped version 44 44 + ## [0.3.0] - 2026-02-04 45 45 + 46 46 + ### 🚀 Features 47 47 + 48 48 + - Initial oauth implementation 49 49 + - Add stripDatePrefix option for Jekyll-style filenames 50 50 + - Add `update` command 51 51 + 52 52 + ### ⚙️ Miscellaneous Tasks 53 53 + 54 54 + - Update changelog 55 55 + - Added workflows 56 56 + - Updated workflows 57 57 + - Updated workflows 58 58 + - Cleaned up types 59 59 + - Updated icon styles 60 60 + - Updated og image 61 61 + - Updated docs 62 62 + - Docs updates 63 63 + - Bumped version 64 64 + ## [0.2.1] - 2026-02-02 65 65 + 66 66 + ### ⚙️ Miscellaneous Tasks 67 67 + 68 68 + - Added CHANGELOG 69 69 + - Merge main into chore/fronmatter-config-updates 70 70 + - Added linting and formatting 71 71 + - Linting updates 72 72 + - Refactored to use fallback approach if frontmatter.slugField is provided or not 73 73 + - Version bump 74 74 + ## [0.2.0] - 2026-02-01 75 75 + 76 76 + ### 🚀 Features 77 77 + 78 78 + - Added bskyPostRef 79 79 + - Added draft field to frontmatter config 80 80 + 81 81 + ### ⚙️ Miscellaneous Tasks 82 82 + 83 83 + - Resolved action items from issue #3 84 84 + - Adjusted tags to accept yaml multiline arrays for tags 85 85 + - Updated inject to handle new slug options 86 86 + - Updated comments 87 87 + - Update blog post 88 88 + - Fix blog build error 89 89 + - Adjust blog post 90 90 + - Updated docs 91 91 + - Version bump 92 92 + ## [0.1.1] - 2026-01-31 93 93 + 94 94 + ### 🐛 Bug Fixes 95 95 + 96 96 + - Fix tangled url to repo 97 97 + 98 98 + ### ⚙️ Miscellaneous Tasks 99 99 + 100 100 + - Merge branch 'main' into feat/blog-post 101 101 + - Updated blog post 102 102 + - Updated date 103 103 + - Added publishing 104 104 + - Spelling and grammar 105 105 + - Updated package scripts 106 106 + - Refactored codebase to use node and fs instead of bun 107 107 + - Version bump 108 108 + ## [0.1.0] - 2026-01-30 109 109 + 110 110 + ### 🚀 Features 111 111 + 112 112 + - Init 113 113 + - Added blog post 114 114 + 115 115 + ### ⚙️ Miscellaneous Tasks 116 116 + 117 117 + - Updated package.json 118 118 + - Cleaned up commands and libs 119 119 + - Updated init commands 120 120 + - Updated greeting 121 121 + - Updated readme 122 122 + - Link updates 123 123 + - Version bump 124 124 + - Added hugo support through frontmatter parsing 125 125 + - Version bump 126 126 + - Updated docs 127 127 + - Adapted inject.ts pattern 128 128 + - Updated docs 129 129 + - Version bump" 130 130 + - Updated package scripts 131 131 + - Updated scripts 132 132 + - Added ignore field to config 133 133 + - Udpate docs 134 134 + - Version bump 135 135 + - Added tags to flow 136 136 + - Added ability to exit during init flow 137 137 + - Version bump 138 138 + - Updated docs 139 139 + - Updated links 140 140 + - Updated docs 141 141 + - Initial refactor 142 142 + - Checkpoint 143 143 + - Refactored mapping 144 144 + - Docs updates 145 145 + - Docs updates 146 146 + - Version bump

+99 -1

bun.lock

··· 24 24 }, 25 25 "packages/cli": { 26 26 "name": "sequoia-cli", 27 27 - "version": "0.1.0", 27 27 + "version": "0.3.2", 28 28 "bin": { 29 29 "sequoia": "dist/index.js", 30 30 }, 31 31 "dependencies": { 32 32 "@atproto/api": "^0.18.17", 33 33 + "@atproto/oauth-client-node": "^0.3.16", 33 34 "@clack/prompts": "^1.0.0", 34 35 "cmd-ts": "^0.14.3", 35 36 "glob": "^13.0.0", 36 37 "mime-types": "^2.1.35", 37 38 "minimatch": "^10.1.1", 39 39 + "open": "^11.0.0", 38 40 }, 39 41 "devDependencies": { 42 42 + "@biomejs/biome": "^2.3.13", 40 43 "@types/mime-types": "^3.0.1", 41 44 "@types/node": "^20", 42 45 }, ··· 44 47 "typescript": "^5", 45 48 }, 46 49 }, 50 50 + "packages/ui": { 51 51 + "name": "sequoia-ui", 52 52 + "version": "0.1.0", 53 53 + "devDependencies": { 54 54 + "@biomejs/biome": "^2.3.13", 55 55 + "@types/node": "^20", 56 56 + }, 57 57 + "peerDependencies": { 58 58 + "typescript": "^5", 59 59 + }, 60 60 + }, 47 61 }, 48 62 "packages": { 49 63 "@antfu/install-pkg": ["@antfu/install-pkg@1.1.0", "", { "dependencies": { "package-manager-detector": "^1.3.0", "tinyexec": "^1.0.1" } }, "sha512-MGQsmw10ZyI+EJo45CdSER4zEb+p31LpDAFp2Z3gkSd1yqVZGi0Ebx++YTEMonJy4oChEMLsxZ64j8FH6sSqtQ=="], 50 64 65 65 + "@atproto-labs/did-resolver": ["@atproto-labs/did-resolver@0.2.6", "", { "dependencies": { "@atproto-labs/fetch": "0.2.3", "@atproto-labs/pipe": "0.1.1", "@atproto-labs/simple-store": "0.3.0", "@atproto-labs/simple-store-memory": "0.1.4", "@atproto/did": "0.3.0", "zod": "^3.23.8" } }, "sha512-2K1bC04nI2fmgNcvof+yA28IhGlpWn2JKYlPa7To9JTKI45FINCGkQSGiL2nyXlyzDJJ34fZ1aq6/IRFIOIiqg=="], 66 66 + 67 67 + "@atproto-labs/fetch": ["@atproto-labs/fetch@0.2.3", "", { "dependencies": { "@atproto-labs/pipe": "0.1.1" } }, "sha512-NZtbJOCbxKUFRFKMpamT38PUQMY0hX0p7TG5AEYOPhZKZEP7dHZ1K2s1aB8MdVH0qxmqX7nQleNrrvLf09Zfdw=="], 68 68 + 69 69 + "@atproto-labs/fetch-node": ["@atproto-labs/fetch-node@0.2.0", "", { "dependencies": { "@atproto-labs/fetch": "0.2.3", "@atproto-labs/pipe": "0.1.1", "ipaddr.js": "^2.1.0", "undici": "^6.14.1" } }, "sha512-Krq09nH/aeoiU2s9xdHA0FjTEFWG9B5FFenipv1iRixCcPc7V3DhTNDawxG9gI8Ny0k4dBVS9WTRN/IDzBx86Q=="], 70 70 + 71 71 + "@atproto-labs/handle-resolver": ["@atproto-labs/handle-resolver@0.3.6", "", { "dependencies": { "@atproto-labs/simple-store": "0.3.0", "@atproto-labs/simple-store-memory": "0.1.4", "@atproto/did": "0.3.0", "zod": "^3.23.8" } }, "sha512-qnSTXvOBNj1EHhp2qTWSX8MS5q3AwYU5LKlt5fBvSbCjgmTr2j0URHCv+ydrwO55KvsojIkTMgeMOh4YuY4fCA=="], 72 72 + 73 73 + "@atproto-labs/handle-resolver-node": ["@atproto-labs/handle-resolver-node@0.1.25", "", { "dependencies": { "@atproto-labs/fetch-node": "0.2.0", "@atproto-labs/handle-resolver": "0.3.6", "@atproto/did": "0.3.0" } }, "sha512-NY9WYM2VLd3IuMGRkkmvGBg8xqVEaK/fitv1vD8SMXqFTekdpjOLCCyv7EFtqVHouzmDcL83VOvWRfHVa8V9Yw=="], 74 74 + 75 75 + "@atproto-labs/identity-resolver": ["@atproto-labs/identity-resolver@0.3.6", "", { "dependencies": { "@atproto-labs/did-resolver": "0.2.6", "@atproto-labs/handle-resolver": "0.3.6" } }, "sha512-qoWqBDRobln0NR8L8dQjSp79E0chGkBhibEgxQa2f9WD+JbJdjQ0YvwwO5yeQn05pJoJmAwmI2wyJ45zjU7aWg=="], 76 76 + 77 77 + "@atproto-labs/pipe": ["@atproto-labs/pipe@0.1.1", "", {}, "sha512-hdNw2oUs2B6BN1lp+32pF7cp8EMKuIN5Qok2Vvv/aOpG/3tNSJ9YkvfI0k6Zd188LeDDYRUpYpxcoFIcGH/FNg=="], 78 78 + 79 79 + "@atproto-labs/simple-store": ["@atproto-labs/simple-store@0.3.0", "", {}, "sha512-nOb6ONKBRJHRlukW1sVawUkBqReLlLx6hT35VS3imaNPwiXDxLnTK7lxw3Lrl9k5yugSBDQAkZAq3MPTEFSUBQ=="], 80 80 + 81 81 + "@atproto-labs/simple-store-memory": ["@atproto-labs/simple-store-memory@0.1.4", "", { "dependencies": { "@atproto-labs/simple-store": "0.3.0", "lru-cache": "^10.2.0" } }, "sha512-3mKY4dP8I7yKPFj9VKpYyCRzGJOi5CEpOLPlRhoJyLmgs3J4RzDrjn323Oakjz2Aj2JzRU/AIvWRAZVhpYNJHw=="], 82 82 + 51 83 "@atproto/api": ["@atproto/api@0.18.17", "", { "dependencies": { "@atproto/common-web": "^0.4.13", "@atproto/lexicon": "^0.6.1", "@atproto/syntax": "^0.4.3", "@atproto/xrpc": "^0.7.7", "await-lock": "^2.2.2", "multiformats": "^9.9.0", "tlds": "^1.234.0", "zod": "^3.23.8" } }, "sha512-TeJkLGPkiK3jblwTDSNTH+CnS6WgaOiHDZeVVzywtxomyyF0FpQVSMz5eP3sDhxyHJqpI3E2AOYD7PO/JSbzJw=="], 52 84 53 85 "@atproto/common-web": ["@atproto/common-web@0.4.13", "", { "dependencies": { "@atproto/lex-data": "0.0.9", "@atproto/lex-json": "0.0.9", "@atproto/syntax": "0.4.3", "zod": "^3.23.8" } }, "sha512-TewRUyB/dVJ5PtI3QmJzEgT3wDsvpnLJ+48hPl+LuUueJPamZevXKJN6dFjtbKAMFRnl2bKfdsf79qwvdSaLKQ=="], 54 86 87 87 + "@atproto/did": ["@atproto/did@0.3.0", "", { "dependencies": { "zod": "^3.23.8" } }, "sha512-raUPzUGegtW/6OxwCmM8bhZvuIMzxG5t9oWsth6Tp91Kb5fTnHV2h/KKNF1C82doeA4BdXCErTyg7ISwLbQkzA=="], 88 88 + 89 89 + "@atproto/jwk": ["@atproto/jwk@0.6.0", "", { "dependencies": { "multiformats": "^9.9.0", "zod": "^3.23.8" } }, "sha512-bDoJPvt7TrQVi/rBfBrSSpGykhtIriKxeYCYQTiPRKFfyRhbgpElF0wPXADjIswnbzZdOwbY63az4E/CFVT3Tw=="], 90 90 + 91 91 + "@atproto/jwk-jose": ["@atproto/jwk-jose@0.1.11", "", { "dependencies": { "@atproto/jwk": "0.6.0", "jose": "^5.2.0" } }, "sha512-i4Fnr2sTBYmMmHXl7NJh8GrCH+tDQEVWrcDMDnV5DjJfkgT17wIqvojIw9SNbSL4Uf0OtfEv6AgG0A+mgh8b5Q=="], 92 92 + 93 93 + "@atproto/jwk-webcrypto": ["@atproto/jwk-webcrypto@0.2.0", "", { "dependencies": { "@atproto/jwk": "0.6.0", "@atproto/jwk-jose": "0.1.11", "zod": "^3.23.8" } }, "sha512-UmgRrrEAkWvxwhlwe30UmDOdTEFidlIzBC7C3cCbeJMcBN1x8B3KH+crXrsTqfWQBG58mXgt8wgSK3Kxs2LhFg=="], 94 94 + 55 95 "@atproto/lex-data": ["@atproto/lex-data@0.0.9", "", { "dependencies": { "multiformats": "^9.9.0", "tslib": "^2.8.1", "uint8arrays": "3.0.0", "unicode-segmenter": "^0.14.0" } }, "sha512-1slwe4sG0cyWtsq16+rBoWIxNDqGPkkvN+PV6JuzA7dgUK9bjUmXBGQU4eZlUPSS43X1Nhmr/9VjgKmEzU9vDw=="], 56 96 57 97 "@atproto/lex-json": ["@atproto/lex-json@0.0.9", "", { "dependencies": { "@atproto/lex-data": "0.0.9", "tslib": "^2.8.1" } }, "sha512-Q2v1EVZcnd+ndyZj1r2UlGikA7q6It24CFPLbxokcf5Ba4RBupH8IkkQX7mqUDSRWPgQdmZYIdW9wUln+MKDqw=="], 58 98 59 99 "@atproto/lexicon": ["@atproto/lexicon@0.6.1", "", { "dependencies": { "@atproto/common-web": "^0.4.13", "@atproto/syntax": "^0.4.3", "iso-datestring-validator": "^2.2.2", "multiformats": "^9.9.0", "zod": "^3.23.8" } }, "sha512-/vI1kVlY50Si+5MXpvOucelnYwb0UJ6Qto5mCp+7Q5C+Jtp+SoSykAPVvjVtTnQUH2vrKOFOwpb3C375vSKzXw=="], 100 100 + 101 101 + "@atproto/oauth-client": ["@atproto/oauth-client@0.5.14", "", { "dependencies": { "@atproto-labs/did-resolver": "0.2.6", "@atproto-labs/fetch": "0.2.3", "@atproto-labs/handle-resolver": "0.3.6", "@atproto-labs/identity-resolver": "0.3.6", "@atproto-labs/simple-store": "0.3.0", "@atproto-labs/simple-store-memory": "0.1.4", "@atproto/did": "0.3.0", "@atproto/jwk": "0.6.0", "@atproto/oauth-types": "0.6.2", "@atproto/xrpc": "0.7.7", "core-js": "^3", "multiformats": "^9.9.0", "zod": "^3.23.8" } }, "sha512-sPH+vcdq9maTEAhJI0HzmFcFAMrkCS19np+RUssNkX6kS8Xr3OYr57tvYRCbkcnIyYTfYcxKQgpwHKx3RVEaYw=="], 102 102 + 103 103 + "@atproto/oauth-client-node": ["@atproto/oauth-client-node@0.3.16", "", { "dependencies": { "@atproto-labs/did-resolver": "0.2.6", "@atproto-labs/handle-resolver-node": "0.1.25", "@atproto-labs/simple-store": "0.3.0", "@atproto/did": "0.3.0", "@atproto/jwk": "0.6.0", "@atproto/jwk-jose": "0.1.11", "@atproto/jwk-webcrypto": "0.2.0", "@atproto/oauth-client": "0.5.14", "@atproto/oauth-types": "0.6.2" } }, "sha512-2dooMzxAkiQ4MkOAZlEQ3iwbB9SEovrbIKMNuBbVCLQYORVNxe20tMdjs3lvhrzdpzvaHLlQnJJhw5dA9VELFw=="], 104 104 + 105 105 + "@atproto/oauth-types": ["@atproto/oauth-types@0.6.2", "", { "dependencies": { "@atproto/did": "0.3.0", "@atproto/jwk": "0.6.0", "zod": "^3.23.8" } }, "sha512-2cuboM4RQBCYR8NQC5uGRkW6KgCgKyq/B5/+tnMmWZYtZGVUQvsUWQHK/ZiMCnVXbcDNtc/RIEJQJDZ8FXMoxg=="], 60 106 61 107 "@atproto/syntax": ["@atproto/syntax@0.4.3", "", { "dependencies": { "tslib": "^2.8.1" } }, "sha512-YoZUz40YAJr5nPwvCDWgodEOlt5IftZqPJvA0JDWjuZKD8yXddTwSzXSaKQAzGOpuM+/A3uXRtPzJJqlScc+iA=="], 62 108 ··· 104 150 105 151 "@babel/types": ["@babel/types@7.28.6", "", { "dependencies": { "@babel/helper-string-parser": "^7.27.1", "@babel/helper-validator-identifier": "^7.28.5" } }, "sha512-0ZrskXVEHSWIqZM/sQZ4EV3jZJXRkio/WCxaqKZP1g//CEWEPSfeZFcms4XeKBCHU0ZKnIkdJeU/kF+eRp5lBg=="], 106 152 153 153 + "@biomejs/biome": ["@biomejs/biome@2.3.13", "", { "optionalDependencies": { "@biomejs/cli-darwin-arm64": "2.3.13", "@biomejs/cli-darwin-x64": "2.3.13", "@biomejs/cli-linux-arm64": "2.3.13", "@biomejs/cli-linux-arm64-musl": "2.3.13", "@biomejs/cli-linux-x64": "2.3.13", "@biomejs/cli-linux-x64-musl": "2.3.13", "@biomejs/cli-win32-arm64": "2.3.13", "@biomejs/cli-win32-x64": "2.3.13" }, "bin": { "biome": "bin/biome" } }, "sha512-Fw7UsV0UAtWIBIm0M7g5CRerpu1eKyKAXIazzxhbXYUyMkwNrkX/KLkGI7b+uVDQ5cLUMfOC9vR60q9IDYDstA=="], 154 154 + 155 155 + "@biomejs/cli-darwin-arm64": ["@biomejs/cli-darwin-arm64@2.3.13", "", { "os": "darwin", "cpu": "arm64" }, "sha512-0OCwP0/BoKzyJHnFdaTk/i7hIP9JHH9oJJq6hrSCPmJPo8JWcJhprK4gQlhFzrwdTBAW4Bjt/RmCf3ZZe59gwQ=="], 156 156 + 157 157 + "@biomejs/cli-darwin-x64": ["@biomejs/cli-darwin-x64@2.3.13", "", { "os": "darwin", "cpu": "x64" }, "sha512-AGr8OoemT/ejynbIu56qeil2+F2WLkIjn2d8jGK1JkchxnMUhYOfnqc9sVzcRxpG9Ycvw4weQ5sprRvtb7Yhcw=="], 158 158 + 159 159 + "@biomejs/cli-linux-arm64": ["@biomejs/cli-linux-arm64@2.3.13", "", { "os": "linux", "cpu": "arm64" }, "sha512-xvOiFkrDNu607MPMBUQ6huHmBG1PZLOrqhtK6pXJW3GjfVqJg0Z/qpTdhXfcqWdSZHcT+Nct2fOgewZvytESkw=="], 160 160 + 161 161 + "@biomejs/cli-linux-arm64-musl": ["@biomejs/cli-linux-arm64-musl@2.3.13", "", { "os": "linux", "cpu": "arm64" }, "sha512-TUdDCSY+Eo/EHjhJz7P2GnWwfqet+lFxBZzGHldrvULr59AgahamLs/N85SC4+bdF86EhqDuuw9rYLvLFWWlXA=="], 162 162 + 163 163 + "@biomejs/cli-linux-x64": ["@biomejs/cli-linux-x64@2.3.13", "", { "os": "linux", "cpu": "x64" }, "sha512-s+YsZlgiXNq8XkgHs6xdvKDFOj/bwTEevqEY6rC2I3cBHbxXYU1LOZstH3Ffw9hE5tE1sqT7U23C00MzkXztMw=="], 164 164 + 165 165 + "@biomejs/cli-linux-x64-musl": ["@biomejs/cli-linux-x64-musl@2.3.13", "", { "os": "linux", "cpu": "x64" }, "sha512-0bdwFVSbbM//Sds6OjtnmQGp4eUjOTt6kHvR/1P0ieR9GcTUAlPNvPC3DiavTqq302W34Ae2T6u5VVNGuQtGlQ=="], 166 166 + 167 167 + "@biomejs/cli-win32-arm64": ["@biomejs/cli-win32-arm64@2.3.13", "", { "os": "win32", "cpu": "arm64" }, "sha512-QweDxY89fq0VvrxME+wS/BXKmqMrOTZlN9SqQ79kQSIc3FrEwvW/PvUegQF6XIVaekncDykB5dzPqjbwSKs9DA=="], 168 168 + 169 169 + "@biomejs/cli-win32-x64": ["@biomejs/cli-win32-x64@2.3.13", "", { "os": "win32", "cpu": "x64" }, "sha512-trDw2ogdM2lyav9WFQsdsfdVy1dvZALymRpgmWsvSez0BJzBjulhOT/t+wyKeh3pZWvwP3VMs1SoOKwO3wecMQ=="], 170 170 + 107 171 "@braintree/sanitize-url": ["@braintree/sanitize-url@7.1.1", "", {}, "sha512-i1L7noDNxtFyL5DmZafWy1wRVhGehQmzZaz1HiN5e7iylJMSZR7ekOV7NsIqa5qBldlLrsKv4HbgFUVlQrz8Mw=="], 108 172 109 173 "@chevrotain/cst-dts-gen": ["@chevrotain/cst-dts-gen@11.0.3", "", { "dependencies": { "@chevrotain/gast": "11.0.3", "@chevrotain/types": "11.0.3", "lodash-es": "4.17.21" } }, "sha512-BvIKpRLeS/8UbfxXxgC33xOumsacaeCKAjAeLyOn7Pcp95HiRbrpl14S+9vaZLolnbssPIUuiUd8IvgkRyt6NQ=="], ··· 596 660 597 661 "bun-types": ["bun-types@1.3.7", "", { "dependencies": { "@types/node": "*" } }, "sha512-qyschsA03Qz+gou+apt6HNl6HnI+sJJLL4wLDke4iugsE6584CMupOtTY1n+2YC9nGVrEKUlTs99jjRLKgWnjQ=="], 598 662 663 663 + "bundle-name": ["bundle-name@4.1.0", "", { "dependencies": { "run-applescript": "^7.0.0" } }, "sha512-tjwM5exMg6BGRI+kNmTntNsvdZS1X8BFYS6tnJ2hdH0kVxM6/eVZ2xy+FqStSWvYmtfFMDLIxurorHwDKfDz5Q=="], 664 664 + 599 665 "bytes": ["bytes@3.1.2", "", {}, "sha512-/Nf7TyzTx6S3yRJObOAV7956r8cr2+Oj8AC5dt8wSP3BQAoeX58NoHyCU8P8zGkNXStjTSi6fzO6F0pBdcYbEg=="], 600 666 601 667 "cac": ["cac@6.7.14", "", {}, "sha512-b6Ilus+c3RrdDk+JhLKUAQfzzgLEPy6wcXqS7f/xe1EETvsDP6GORG7SFuOs6cID5YkqchW/LXZbX5bc8j7ZcQ=="], ··· 643 709 "convert-source-map": ["convert-source-map@2.0.0", "", {}, "sha512-Kvp459HrV2FEJ1CAsi1Ku+MY3kasH19TFykTz2xWmMeq6bk2NU3XXvfJ+Q61m0xktWwt+1HSYf3JZsTms3aRJg=="], 644 710 645 711 "cookie": ["cookie@1.1.1", "", {}, "sha512-ei8Aos7ja0weRpFzJnEA9UHJ/7XQmqglbRwnf2ATjcB9Wq874VKH9kfjjirM6UhU2/E5fFYadylyhFldcqSidQ=="], 712 712 + 713 713 + "core-js": ["core-js@3.48.0", "", {}, "sha512-zpEHTy1fjTMZCKLHUZoVeylt9XrzaIN2rbPXEt0k+q7JE5CkCZdo6bNq55bn24a69CH7ErAVLKijxJja4fw+UQ=="], 646 714 647 715 "cose-base": ["cose-base@1.0.3", "", { "dependencies": { "layout-base": "^1.0.0" } }, "sha512-s9whTXInMSgAp/NVXVNuVxVKzGH2qck3aQlVHxDCdAEPgtMKwc4Wq6/QKhgdEdgbLSi9rBTAcPoRa6JpiG4ksg=="], 648 716 ··· 742 810 743 811 "deepmerge": ["deepmerge@4.3.1", "", {}, "sha512-3sUqbMEc77XqpdNO7FRyRog+eW3ph+GYCbj+rK+uYyRMuwsVy0rMiVtPn+QJlKFvWP/1PYpapqYn0Me2knFn+A=="], 744 812 813 813 + "default-browser": ["default-browser@5.4.0", "", { "dependencies": { "bundle-name": "^4.1.0", "default-browser-id": "^5.0.0" } }, "sha512-XDuvSq38Hr1MdN47EDvYtx3U0MTqpCEn+F6ft8z2vYDzMrvQhVp0ui9oQdqW3MvK3vqUETglt1tVGgjLuJ5izg=="], 814 814 + 815 815 + "default-browser-id": ["default-browser-id@5.0.1", "", {}, "sha512-x1VCxdX4t+8wVfd1so/9w+vQ4vx7lKd2Qp5tDRutErwmR85OgmfX7RlLRMWafRMY7hbEiXIbudNrjOAPa/hL8Q=="], 816 816 + 817 817 + "define-lazy-prop": ["define-lazy-prop@3.0.0", "", {}, "sha512-N+MeXYoqr3pOgn8xfyRPREN7gHakLYjhsHhWGT3fWAiL4IkAt0iDw14QiiEm2bE30c5XX5q0FtAA3CK5f9/BUg=="], 818 818 + 745 819 "delaunator": ["delaunator@5.0.1", "", { "dependencies": { "robust-predicates": "^3.0.2" } }, "sha512-8nvh+XBe96aCESrGOqMp/84b13H9cdKbG5P2ejQCh4d4sK9RL4371qou9drQjMhvnPmhWl5hnmqbEE0fXr9Xnw=="], 746 820 747 821 "depd": ["depd@2.0.0", "", {}, "sha512-g7nH6P6dyDioJogAAGprGpCtVImJhpPk/roCzdb3fIh61/s/nPsfR6onyMwkCAR/OlC3yBC0lESvUoQEAssIrw=="], ··· 902 976 903 977 "internmap": ["internmap@1.0.1", "", {}, "sha512-lDB5YccMydFBtasVtxnZ3MRBHuaoE8GKsppq+EchKL2U4nK/DmEpPHNH8MZe5HkMtpSiTSOZwfN0tzYjO/lJEw=="], 904 978 979 979 + "ipaddr.js": ["ipaddr.js@2.3.0", "", {}, "sha512-Zv/pA+ciVFbCSBBjGfaKUya/CcGmUHzTydLMaTwrUUEM2DIEO3iZvueGxmacvmN50fGpGVKeTXpb2LcYQxeVdg=="], 980 980 + 905 981 "is-alphabetical": ["is-alphabetical@2.0.1", "", {}, "sha512-FWyyY60MeTNyeSRpkM2Iry0G9hpr7/9kD40mD/cGQEuilcZYS4okz8SN2Q6rLCJ8gbCt6fN+rC+6tMGS99LaxQ=="], 906 982 907 983 "is-alphanumerical": ["is-alphanumerical@2.0.1", "", { "dependencies": { "is-alphabetical": "^2.0.0", "is-decimal": "^2.0.0" } }, "sha512-hmbYhX/9MUMF5uh7tOXyK/n0ZvWpad5caBA17GsC6vyuCqaWliRG5K1qS9inmUhEMaOBIW7/whAnSwveW/LtZw=="], 908 984 909 985 "is-decimal": ["is-decimal@2.0.1", "", {}, "sha512-AAB9hiomQs5DXWcRB1rqsxGUstbRroFOPPVAomNk/3XHR5JyEZChOyTWe2oayKnsSsr/kcGqF+z6yuH6HHpN0A=="], 910 986 987 987 + "is-docker": ["is-docker@3.0.0", "", { "bin": { "is-docker": "cli.js" } }, "sha512-eljcgEDlEns/7AXFosB5K/2nCM4P7FQPkGc/DWLy5rmFEWvZayGrik1d9/QIY5nJ4f9YsVvBkA6kJpHn9rISdQ=="], 988 988 + 911 989 "is-hexadecimal": ["is-hexadecimal@2.0.1", "", {}, "sha512-DgZQp241c8oO6cA1SbTEWiXeoxV42vlcJxgH+B3hi1AiqqKruZR3ZGF8In3fj4+/y/7rHvlOZLZtgJ/4ttYGZg=="], 912 990 991 991 + "is-in-ssh": ["is-in-ssh@1.0.0", "", {}, "sha512-jYa6Q9rH90kR1vKB6NM7qqd1mge3Fx4Dhw5TVlK1MUBqhEOuCagrEHMevNuCcbECmXZ0ThXkRm+Ymr51HwEPAw=="], 992 992 + 993 993 + "is-inside-container": ["is-inside-container@1.0.0", "", { "dependencies": { "is-docker": "^3.0.0" }, "bin": { "is-inside-container": "cli.js" } }, "sha512-KIYLCCJghfHZxqjYBE7rEy0OBuTd5xCHS7tHVgvCLkx7StIoaxwNW3hCALgEUjFfeRk+MG/Qxmp/vtETEF3tRA=="], 994 994 + 913 995 "is-interactive": ["is-interactive@2.0.0", "", {}, "sha512-qP1vozQRI+BMOPcjFzrjXuQvdak2pHNUMZoeG2eRbiSqyvbEf/wQtEOTOX1guk6E3t36RkaqiSt8A/6YElNxLQ=="], 914 996 915 997 "is-plain-obj": ["is-plain-obj@4.1.0", "", {}, "sha512-+Pgi+vMuUNkJyExiMBt5IlFoMyKnr5zhJ4Uspz58WOhBF5QoIZkFyNHIbBAtHwzVAgk5RtndVNsDRN61/mmDqg=="], ··· 918 1000 919 1001 "is-unicode-supported": ["is-unicode-supported@1.3.0", "", {}, "sha512-43r2mRvz+8JRIKnWJ+3j8JtjRKZ6GmjzfaE/qiBJnikNnYv/6bagRJ1kUhNk8R5EX/GkobD+r+sfxCPJsiKBLQ=="], 920 1002 1003 1003 + "is-wsl": ["is-wsl@3.1.0", "", { "dependencies": { "is-inside-container": "^1.0.0" } }, "sha512-UcVfVfaK4Sc4m7X3dUSoHoozQGBEFeDC+zVo06t98xe8CzHSZZBekNXH+tu0NalHolcJ/QAGqS46Hef7QXBIMw=="], 1004 1004 + 921 1005 "isexe": ["isexe@2.0.0", "", {}, "sha512-RHxMLp9lnKHGHRng9QFhRCMbYAcVpn69smSGcq3f36xjgVVWThj4qqLbTLlq7Ssj8B+fIQ1EuCEGI2lKsyQeIw=="], 922 1006 923 1007 "iso-datestring-validator": ["iso-datestring-validator@2.2.2", "", {}, "sha512-yLEMkBbLZTlVQqOnQ4FiMujR6T4DEcCb1xizmvXS+OxuhwcbtynoosRzdMA69zZCShCNAbi+gJ71FxZBBXx1SA=="], ··· 925 1009 "javascript-stringify": ["javascript-stringify@2.1.0", "", {}, "sha512-JVAfqNPTvNq3sB/VHQJAFxN/sPgKnsKrCwyRt15zwNCdrMMJDdcEOdubuy+DuJYYdm0ox1J4uzEuYKkN+9yhVg=="], 926 1010 927 1011 "jiti": ["jiti@2.6.1", "", { "bin": { "jiti": "lib/jiti-cli.mjs" } }, "sha512-ekilCSN1jwRvIbgeg/57YFh8qQDNbwDb9xT/qu2DAHbFFZUicIl4ygVaAvzveMhMVr3LnpSKTNnwt8PoOfmKhQ=="], 1012 1012 + 1013 1013 + "jose": ["jose@5.10.0", "", {}, "sha512-s+3Al/p9g32Iq+oqXxkW//7jk2Vig6FF1CFqzVXoTUXt2qz89YWbL+OwS17NFYEvxC35n0FKeGO2LGYSxeM2Gg=="], 928 1014 929 1015 "js-tokens": ["js-tokens@4.0.0", "", {}, "sha512-RdJUflcE3cUzKiMqQgsCu06FPu9UdIJO0beYbPhHN4k6apgJtifcoCtT9bcxOpYBtpD2kCM6Sbzg4CausW/PKQ=="], 930 1016 ··· 1148 1234 1149 1235 "oniguruma-to-es": ["oniguruma-to-es@2.3.0", "", { "dependencies": { "emoji-regex-xs": "^1.0.0", "regex": "^5.1.1", "regex-recursion": "^5.1.1" } }, "sha512-bwALDxriqfKGfUufKGGepCzu9x7nJQuoRoAFp4AnwehhC2crqrDIAP/uN2qdlsAvSMpeRC3+Yzhqc7hLmle5+g=="], 1150 1236 1237 1237 + "open": ["open@11.0.0", "", { "dependencies": { "default-browser": "^5.4.0", "define-lazy-prop": "^3.0.0", "is-in-ssh": "^1.0.0", "is-inside-container": "^1.0.0", "powershell-utils": "^0.1.0", "wsl-utils": "^0.3.0" } }, "sha512-smsWv2LzFjP03xmvFoJ331ss6h+jixfA4UUV/Bsiyuu4YJPfN+FIQGOIiv4w9/+MoHkfkJ22UIaQWRVFRfH6Vw=="], 1238 1238 + 1151 1239 "ora": ["ora@7.0.1", "", { "dependencies": { "chalk": "^5.3.0", "cli-cursor": "^4.0.0", "cli-spinners": "^2.9.0", "is-interactive": "^2.0.0", "is-unicode-supported": "^1.3.0", "log-symbols": "^5.1.0", "stdin-discarder": "^0.1.0", "string-width": "^6.1.0", "strip-ansi": "^7.1.0" } }, "sha512-0TUxTiFJWv+JnjWm4o9yvuskpEJLXTcng8MJuKd+SzAzp2o+OP3HWqNhB4OdJRt1Vsd9/mR0oyaEYlOnL7XIRw=="], 1152 1240 1153 1241 "p-limit": ["p-limit@5.0.0", "", { "dependencies": { "yocto-queue": "^1.0.0" } }, "sha512-/Eaoq+QyLSiXQ4lyYV23f14mZRQcXnxfHrN0vCai+ak9G0pp9iEQukIIZq5NccEvwRB8PUnZT0KsOoDCINS1qQ=="], ··· 1189 1277 "postcss": ["postcss@8.5.6", "", { "dependencies": { "nanoid": "^3.3.11", "picocolors": "^1.1.1", "source-map-js": "^1.2.1" } }, "sha512-3Ybi1tAuwAP9s0r1UQ2J4n5Y0G05bJkpUIO0/bI9MhwmD70S5aTWbXGBwxHrelT+XM1k6dM0pk+SwNkpTRN7Pg=="], 1190 1278 1191 1279 "postcss-value-parser": ["postcss-value-parser@4.2.0", "", {}, "sha512-1NNCs6uurfkVbeXG4S8JFT9t19m45ICnif8zWLd5oPSZ50QnwMfK+H3jv408d4jw/7Bttv5axS5IiHoLaVNHeQ=="], 1280 1280 + 1281 1281 + "powershell-utils": ["powershell-utils@0.1.0", "", {}, "sha512-dM0jVuXJPsDN6DvRpea484tCUaMiXWjuCn++HGTqUWzGDjv5tZkEZldAJ/UMlqRYGFrD/etByo4/xOuC/snX2A=="], 1192 1282 1193 1283 "property-information": ["property-information@6.5.0", "", {}, "sha512-PgTgs/BlvHxOu8QuEN7wi5A0OmXaBcHpmCSTehcs6Uuu9IkDIEo13Hy7n898RHfrQ49vKCoGeWZSaAK01nwVig=="], 1194 1284 ··· 1263 1353 "rollup": ["rollup@4.57.0", "", { "dependencies": { "@types/estree": "1.0.8" }, "optionalDependencies": { "@rollup/rollup-android-arm-eabi": "4.57.0", "@rollup/rollup-android-arm64": "4.57.0", "@rollup/rollup-darwin-arm64": "4.57.0", "@rollup/rollup-darwin-x64": "4.57.0", "@rollup/rollup-freebsd-arm64": "4.57.0", "@rollup/rollup-freebsd-x64": "4.57.0", "@rollup/rollup-linux-arm-gnueabihf": "4.57.0", "@rollup/rollup-linux-arm-musleabihf": "4.57.0", "@rollup/rollup-linux-arm64-gnu": "4.57.0", "@rollup/rollup-linux-arm64-musl": "4.57.0", "@rollup/rollup-linux-loong64-gnu": "4.57.0", "@rollup/rollup-linux-loong64-musl": "4.57.0", "@rollup/rollup-linux-ppc64-gnu": "4.57.0", "@rollup/rollup-linux-ppc64-musl": "4.57.0", "@rollup/rollup-linux-riscv64-gnu": "4.57.0", "@rollup/rollup-linux-riscv64-musl": "4.57.0", "@rollup/rollup-linux-s390x-gnu": "4.57.0", "@rollup/rollup-linux-x64-gnu": "4.57.0", "@rollup/rollup-linux-x64-musl": "4.57.0", "@rollup/rollup-openbsd-x64": "4.57.0", "@rollup/rollup-openharmony-arm64": "4.57.0", "@rollup/rollup-win32-arm64-msvc": "4.57.0", "@rollup/rollup-win32-ia32-msvc": "4.57.0", "@rollup/rollup-win32-x64-gnu": "4.57.0", "@rollup/rollup-win32-x64-msvc": "4.57.0", "fsevents": "~2.3.2" }, "bin": { "rollup": "dist/bin/rollup" } }, "sha512-e5lPJi/aui4TO1LpAXIRLySmwXSE8k3b9zoGfd42p67wzxog4WHjiZF3M2uheQih4DGyc25QEV4yRBbpueNiUA=="], 1264 1354 1265 1355 "roughjs": ["roughjs@4.6.6", "", { "dependencies": { "hachure-fill": "^0.5.2", "path-data-parser": "^0.1.0", "points-on-curve": "^0.2.0", "points-on-path": "^0.2.1" } }, "sha512-ZUz/69+SYpFN/g/lUlo2FXcIjRkSu3nDarreVdGGndHEBJ6cXPdKguS8JGxwj5HA5xIbVKSmLgr5b3AWxtRfvQ=="], 1356 1356 + 1357 1357 + "run-applescript": ["run-applescript@7.1.0", "", {}, "sha512-DPe5pVFaAsinSaV6QjQ6gdiedWDcRCbUuiQfQa2wmWV7+xC9bGulGI8+TdRmoFkAPaBXk8CrAbnlY2ISniJ47Q=="], 1266 1358 1267 1359 "rw": ["rw@1.3.3", "", {}, "sha512-PdhdWy89SiZogBLaw42zdeqtRJ//zFd2PgQavcICDUgJT5oW10QCRKbJ6bg4r0/UY2M6BWd5tkxuGFRvCkgfHQ=="], 1268 1360 ··· 1278 1370 1279 1371 "sequoia-cli": ["sequoia-cli@workspace:packages/cli"], 1280 1372 1373 1373 + "sequoia-ui": ["sequoia-ui@workspace:packages/ui"], 1374 1374 + 1281 1375 "serve-static": ["serve-static@1.16.3", "", { "dependencies": { "encodeurl": "~2.0.0", "escape-html": "~1.0.3", "parseurl": "~1.3.3", "send": "~0.19.1" } }, "sha512-x0RTqQel6g5SY7Lg6ZreMmsOzncHFU7nhnRWkKgWuMTu5NN0DR5oruckMqRvacAN9d5w6ARnRBXl9xhDCgfMeA=="], 1282 1376 1283 1377 "set-cookie-parser": ["set-cookie-parser@2.7.2", "", {}, "sha512-oeM1lpU/UvhTxw+g3cIfxXHyJRc/uidd3yK1P242gzHds0udQBYzs3y8j4gCCW+ZJ7ad0yctld8RYO+bdurlvw=="], ··· 1356 1450 1357 1451 "uint8arrays": ["uint8arrays@3.0.0", "", { "dependencies": { "multiformats": "^9.4.2" } }, "sha512-HRCx0q6O9Bfbp+HHSfQQKD7wU70+lydKVt4EghkdOvlK/NlrF90z+eXV34mUd48rNvVJXwkrMSPpCATkct8fJA=="], 1358 1452 1453 1453 + "undici": ["undici@6.23.0", "", {}, "sha512-VfQPToRA5FZs/qJxLIinmU59u0r7LXqoJkCzinq3ckNJp3vKEh7jTWN589YQ5+aoAC/TGRLyJLCPKcLQbM8r9g=="], 1454 1454 + 1359 1455 "undici-types": ["undici-types@6.21.0", "", {}, "sha512-iwDZqg0QAGrg9Rav5H4n0M64c3mkR59cJ6wQp+7C4nI0gsmExaedaYLNO44eT4AtBBwjbTiGPMlt2Md0T9H9JQ=="], 1360 1456 1361 1457 "unicode-segmenter": ["unicode-segmenter@0.14.5", "", {}, "sha512-jHGmj2LUuqDcX3hqY12Ql+uhUTn8huuxNZGq7GvtF6bSybzH3aFgedYu/KTzQStEgt1Ra2F3HxadNXsNjb3m3g=="], ··· 1425 1521 "web-namespaces": ["web-namespaces@2.0.1", "", {}, "sha512-bKr1DkiNa2krS7qxNtdrtHAmzuYGFQLiQ13TsorsdT6ULTkPLKuu5+GsFpDlg6JFjUTwX2DyhMPG2be8uPrqsQ=="], 1426 1522 1427 1523 "which": ["which@2.0.2", "", { "dependencies": { "isexe": "^2.0.0" }, "bin": { "node-which": "./bin/node-which" } }, "sha512-BLI3Tl1TW3Pvl70l3yq3Y64i+awpwXqsGBYWkkqMtnbXgrMD+yj7rhW0kuEDxzJaYXGjEW5ogapKNMEKNMjibA=="], 1524 1524 + 1525 1525 + "wsl-utils": ["wsl-utils@0.3.1", "", { "dependencies": { "is-wsl": "^3.1.0", "powershell-utils": "^0.1.0" } }, "sha512-g/eziiSUNBSsdDJtCLB8bdYEUMj4jR7AGeUo96p/3dTafgjHhpF4RiCFPiRILwjQoDXx5MqkBr4fwWtR3Ky4Wg=="], 1428 1526 1429 1527 "yallist": ["yallist@3.1.1", "", {}, "sha512-a4UGQaWPH59mOXUYnAG2ewncQS4i4F43Tv3JoAM+s2VDAmS9NsK8GpDMLrCHPksFT7h3K6TOoUNn2pb7RoXx4g=="], 1430 1528

+16 -1

docs/docs/pages/blog/introducing-sequoia.mdx

··· 24 24 25 25 It's designed to be run inside your existing repo, build a one-time config, and then be part of your regular workflow by publishing content or updating existing content, all following the Standard.site lexicons. The best part? It's designed to be fully interoperable. It doesn't matter if you're using Astro, 11ty, Hugo, Svelte, Next, Gatsby, Zola, you name it. If it's a static blog with markdown, Sequoia will work (and if for some reason it doesn't, [open an issue!](https://tangled.org/stevedylan.dev/sequoia/issues/new)). Here's a quick demo of Sequoia in action: 26 26 27 27 - <iframe width="560" height="315" src="https://www.youtube.com/embed/sxursUHq5kw?si=aZSCmkMdYPiYns8u" title="YouTube video player" frameborder="0" allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" referrerpolicy="strict-origin-when-cross-origin" allowfullscreen></iframe> 27 27 + <iframe 28 28 + class="w-full" 29 29 + style={{aspectRatio: "16/9"}} 30 30 + src="https://www.youtube.com/embed/sxursUHq5kw" 31 31 + title="YouTube video player" 32 32 + frameborder="0" 33 33 + allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share" 34 34 + referrerpolicy="strict-origin-when-cross-origin" 35 35 + allowfullscreen 36 36 + ></iframe> 28 37 29 38 ATProto has proven to be one of the more exciting pieces of technology that has surfaced in the past few years, and it gives some of us hope for a web that is open once more. No more walled gardens, full control of our data, and connected through lexicons. 30 39 ··· 43 52 bun i -g sequoia-cli 44 53 ``` 45 54 ::: 55 55 + 56 56 + <script type="module" src="/sequoia-comments.js"></script> 57 57 + <sequoia-comments 58 58 + document-uri="at://did:plc:kq6bvkw4sxof3vdinuitehn5/site.standard.document/3mdnztyhoem2v" 59 59 + depth="2" 60 60 + ></sequoia-comments>

+52 -1

docs/docs/pages/cli-reference.mdx

··· 1 1 # CLI Reference 2 2 3 3 + ## `login` 4 4 + 5 5 + ```bash [Terminal] 6 6 + sequoia login 7 7 + > Login with OAuth (browser-based authentication) 8 8 + 9 9 + OPTIONS: 10 10 + --logout <str> - Remove OAuth session for a specific DID [optional] 11 11 + 12 12 + FLAGS: 13 13 + --list - List all stored OAuth sessions [optional] 14 14 + --help, -h - show help [optional] 15 15 + ``` 16 16 + 17 17 + OAuth is the recommended authentication method as it scopes permissions and refreshes tokens automatically. 18 18 + 3 19 ## `auth` 4 20 5 21 ```bash [Terminal] 6 22 sequoia auth 7 7 - > Authenticate with your ATProto PDS 23 23 + > Authenticate with your ATProto PDS using an app password 8 24 9 25 OPTIONS: 10 26 --logout <str> - Remove credentials for a specific identity (or all if only one exists) [optional] ··· 14 30 --help, -h - show help [optional] 15 31 ``` 16 32 33 33 + Use this as an alternative to `login` when OAuth isn't available or for CI environments. 34 34 + 35 35 + ## `add` 36 36 + 37 37 + ```bash [Terminal] 38 38 + sequoia add <component> 39 39 + > Add a UI component to your project 40 40 + 41 41 + ARGUMENTS: 42 42 + component - The name of the component to add 43 43 + 44 44 + FLAGS: 45 45 + --help, -h - show help [optional] 46 46 + ``` 47 47 + 48 48 + Available components: 49 49 + - `sequoia-comments` - Display Bluesky replies as comments on your blog posts 50 50 + 51 51 + The component will be installed to the directory specified in `ui.components` (default: `src/components`). See the [Comments guide](/comments) for usage details. 52 52 + 17 53 ## `init` 18 54 19 55 ```bash [Terminal] ··· 61 97 --dry-run, -n - Preview what would be synced without making changes [optional] 62 98 --help, -h - show help [optional] 63 99 ``` 100 100 + 101 101 + ## `update` 102 102 + 103 103 + ```bash [Terminal] 104 104 + sequoia update 105 105 + > Update local config or ATProto publication record 106 106 + 107 107 + FLAGS: 108 108 + --help, -h - show help [optional] 109 109 + ``` 110 110 + 111 111 + Interactive command to modify your existing configuration. Choose between: 112 112 + 113 113 + - **Local configuration**: Edit `sequoia.json` settings including site URL, directory paths, frontmatter mappings, advanced options, and Bluesky settings 114 114 + - **ATProto publication**: Update your publication record's name, description, URL, icon, and discover visibility

+179

docs/docs/pages/comments.mdx

··· 1 1 + # Comments 2 2 + 3 3 + Sequoia has a small UI trick up its sleeve that lets you easily display comments on your blog posts through Bluesky posts. This is the general flow: 4 4 + 5 5 + 1. Setup your blog with `sequoia init`, and when prompted at the end to enable BlueSky posts, select `yes`. 6 6 + 2. When you run `sequoia publish` the CLI will publish a BlueSky post and link it to your `site.standard.document` record for your post. 7 7 + 3. As people reply to the BlueSky post, the replies can be rendered as comments below your post using the Sequoia UI web component. 8 8 + 9 9 + ## Setup 10 10 + 11 11 + Run the following command in your project to install the comments web component. It will ask you where you would like to store the component file. 12 12 + 13 13 + ```bash [Terminal] 14 14 + sequoia add sequoia-comments 15 15 + ``` 16 16 + 17 17 + The web component will look for the `<link rel="site.standard.document" href="atUri"/>` in your HTML head, then using the `atUri` fetch the post and the replies. 18 18 + 19 19 + ::::tip 20 20 + For more information on the `<link>` tags, check out the [verification guide](/verifying) 21 21 + :::: 22 22 + 23 23 + ## Usage 24 24 + 25 25 + Since `sequoia-comments` is a standard Web Component, it works with any framework. Choose your setup below: 26 26 + 27 27 + :::code-group 28 28 + 29 29 + ```html [HTML] 30 30 + <body> 31 31 + <h1>Blog Post Title</h1> 32 32 + <!--Content--> 33 33 + <h2>Comments</h2> 34 34 + 35 35 + <sequoia-comments></sequoia-comments> 36 36 + <script type="module" src="./src/components/sequoia-comments.js"></script> 37 37 + </body> 38 38 + ``` 39 39 + 40 40 + ```tsx [React] 41 41 + // Import the component (registers the custom element) 42 42 + import './components/sequoia-comments.js'; 43 43 + 44 44 + function BlogPost() { 45 45 + return ( 46 46 + <article> 47 47 + <h1>Blog Post Title</h1> 48 48 + {/* Content */} 49 49 + <h2>Comments</h2> 50 50 + <sequoia-comments /> 51 51 + </article> 52 52 + ); 53 53 + } 54 54 + ``` 55 55 + 56 56 + ```vue [Vue] 57 57 + <script setup> 58 58 + import './components/sequoia-comments.js'; 59 59 + </script> 60 60 + 61 61 + <template> 62 62 + <article> 63 63 + <h1>Blog Post Title</h1> 64 64 + <!-- Content --> 65 65 + <h2>Comments</h2> 66 66 + <sequoia-comments /> 67 67 + </article> 68 68 + </template> 69 69 + ``` 70 70 + 71 71 + ```svelte [Svelte] 72 72 + <script> 73 73 + import './components/sequoia-comments.js'; 74 74 + </script> 75 75 + 76 76 + <article> 77 77 + <h1>Blog Post Title</h1> 78 78 + <!-- Content --> 79 79 + <h2>Comments</h2> 80 80 + <sequoia-comments /> 81 81 + </article> 82 82 + ``` 83 83 + 84 84 + ```astro [Astro] 85 85 + <article> 86 86 + <h1>Blog Post Title</h1> 87 87 + <!-- Content --> 88 88 + <h2>Comments</h2> 89 89 + <sequoia-comments /> 90 90 + <script> 91 91 + import './components/sequoia-comments.js'; 92 92 + </script> 93 93 + </article> 94 94 + ``` 95 95 + 96 96 + ::: 97 97 + 98 98 + ### TypeScript Support 99 99 + 100 100 + If you're using TypeScript with React, add this type declaration to avoid JSX errors: 101 101 + 102 102 + ```ts [custom-elements.d.ts] 103 103 + declare namespace JSX { 104 104 + interface IntrinsicElements { 105 105 + 'sequoia-comments': React.DetailedHTMLProps< 106 106 + React.HTMLAttributes<HTMLElement> & { 107 107 + 'document-uri'?: string; 108 108 + depth?: string | number; 109 109 + }, 110 110 + HTMLElement 111 111 + >; 112 112 + } 113 113 + } 114 114 + ``` 115 115 + 116 116 + ### Vue Configuration 117 117 + 118 118 + For Vue, you may need to configure the compiler to recognize custom elements: 119 119 + 120 120 + ```ts [vite.config.ts] 121 121 + export default defineConfig({ 122 122 + plugins: [ 123 123 + vue({ 124 124 + template: { 125 125 + compilerOptions: { 126 126 + isCustomElement: (tag) => tag === 'sequoia-comments' 127 127 + } 128 128 + } 129 129 + }) 130 130 + ] 131 131 + }); 132 132 + ``` 133 133 + 134 134 + ## Configuration 135 135 + 136 136 + The comments web component has several configuration options available. 137 137 + 138 138 + ### Attributes 139 139 + 140 140 + The `<sequoia-comments>` component accepts the following attributes: 141 141 + 142 142 + | Attribute | Type | Default | Description | 143 143 + |-----------|------|---------|-------------| 144 144 + | `document-uri` | `string` | - | AT Protocol URI for the document. Optional if a `<link rel="site.standard.document">` tag exists in the page head. | 145 145 + | `depth` | `number` | `6` | Maximum depth of nested replies to fetch. | 146 146 + 147 147 + ```html 148 148 + <!-- Use attributes for explicit control --> 149 149 + <sequoia-comments 150 150 + document-uri="at://did:plc:example/site.standard.document/abc123" 151 151 + depth="10"> 152 152 + </sequoia-comments> 153 153 + ``` 154 154 + 155 155 + ### Styling 156 156 + 157 157 + The component uses CSS custom properties for theming. Set these in your `:root` or parent element to customize the appearance: 158 158 + 159 159 + | CSS Property | Default | Description | 160 160 + |--------------|---------|-------------| 161 161 + | `--sequoia-fg-color` | `#1f2937` | Text color | 162 162 + | `--sequoia-bg-color` | `#ffffff` | Background color | 163 163 + | `--sequoia-border-color` | `#e5e7eb` | Border color | 164 164 + | `--sequoia-accent-color` | `#2563eb` | Accent/link color | 165 165 + | `--sequoia-secondary-color` | `#6b7280` | Secondary text color (handles, timestamps) | 166 166 + | `--sequoia-border-radius` | `8px` | Border radius for cards and buttons | 167 167 + 168 168 + ### Example: Dark Theme 169 169 + 170 170 + ```css 171 171 + :root { 172 172 + --sequoia-accent-color: #3A5A40; 173 173 + --sequoia-border-radius: 12px; 174 174 + --sequoia-bg-color: #1a1a1a; 175 175 + --sequoia-fg-color: #F5F3EF; 176 176 + --sequoia-border-color: #333; 177 177 + --sequoia-secondary-color: #8B7355; 178 178 + } 179 179 + ```

+46 -2

docs/docs/pages/config.mdx

··· 14 14 | `pdsUrl` | `string` | No | `"https://bsky.social"` | PDS server URL, generated automatically | 15 15 | `identity` | `string` | No | - | Which stored identity to use | 16 16 | `frontmatter` | `object` | No | - | Custom frontmatter field mappings | 17 17 + | `frontmatter.slugField` | `string` | No | - | Frontmatter field to use for slug (defaults to filepath) | 17 18 | `ignore` | `string[]` | No | - | Glob patterns for files to ignore | 19 19 + | `removeIndexFromSlug` | `boolean` | No | `false` | Remove `/index` or `/_index` suffix from slugs | 20 20 + | `stripDatePrefix` | `boolean` | No | `false` | Remove `YYYY-MM-DD-` date prefixes from slugs (Jekyll-style) | 21 21 + | `bluesky` | `object` | No | - | Bluesky posting configuration | 22 22 + | `bluesky.enabled` | `boolean` | No | `false` | Post to Bluesky when publishing documents (also enables [comments](/comments)) | 23 23 + | `bluesky.maxAgeDays` | `number` | No | `30` | Only post documents published within this many days | 24 24 + | `ui` | `object` | No | - | UI components configuration | 25 25 + | `ui.components` | `string` | No | `"src/components"` | Directory where UI components are installed | 18 26 19 27 ### Example 20 28 ··· 31 39 "frontmatter": { 32 40 "publishDate": "date" 33 41 }, 34 34 - "ignore": ["_index.md"] 42 42 + "ignore": ["_index.md"], 43 43 + "bluesky": { 44 44 + "enabled": true, 45 45 + "maxAgeDays": 30 46 46 + }, 47 47 + "ui": { 48 48 + "components": "src/components" 49 49 + } 35 50 } 36 51 ``` 37 52 ··· 44 59 | `publishDate` | `string` | Yes | `"publishDate"`, `"pubDate"`, `"date"`, `"createdAt"`, `"created_at"` | Publication date | 45 60 | `coverImage` | `string` | No | `"ogImage"` | Cover image filename | 46 61 | `tags` | `string[]` | No | `"tags"` | Post tags/categories | 62 62 + | `draft` | `boolean` | No | `"draft"` | If `true`, post is skipped during publish | 47 63 48 64 ### Example 49 65 ··· 54 70 publishDate: 2024-01-15 55 71 ogImage: cover.jpg 56 72 tags: [welcome, intro] 73 73 + draft: false 57 74 --- 58 75 ``` 59 76 ··· 65 82 { 66 83 "frontmatter": { 67 84 "publishDate": "date", 68 68 - "coverImage": "thumbnail" 85 85 + "coverImage": "thumbnail", 86 86 + "draft": "private" 69 87 } 70 88 } 71 89 ``` 90 90 + 91 91 + ### Slug Configuration 92 92 + 93 93 + By default, slugs are generated from the filepath (e.g., `posts/my-post.md` becomes `posts/my-post`). To use a frontmatter field instead: 94 94 + 95 95 + ```json 96 96 + { 97 97 + "frontmatter": { 98 98 + "slugField": "url" 99 99 + } 100 100 + } 101 101 + ``` 102 102 + 103 103 + If the frontmatter field is not found, it falls back to the filepath. 104 104 + 105 105 + ### Jekyll-Style Date Prefixes 106 106 + 107 107 + Jekyll uses date prefixes in filenames (e.g., `2024-01-15-my-post.md`) for ordering posts. To strip these from generated slugs: 108 108 + 109 109 + ```json 110 110 + { 111 111 + "stripDatePrefix": true 112 112 + } 113 113 + ``` 114 114 + 115 115 + This transforms `2024-01-15-my-post.md` into the slug `my-post`. 72 116 73 117 ### Ignoring Files 74 118

+45 -1

docs/docs/pages/publishing.mdx

··· 10 10 sequoia publish --dry-run 11 11 ``` 12 12 13 13 - This will print out the posts that it has discovered, what will be published, and how many. Once everything looks good, send it! 13 13 + This will print out the posts that it has discovered, what will be published, and how many. If Bluesky posting is enabled, it will also show which posts will be shared to Bluesky. Once everything looks good, send it! 14 14 15 15 ```bash [Terminal] 16 16 sequoia publish ··· 27 27 ``` 28 28 29 29 Sync will use your ATProto handle to look through all of the `standard.site.document` records on your PDS, and pull down the records that are for the publication in the config. 30 30 + 31 31 + ## Bluesky Posting 32 32 + 33 33 + Sequoia can automatically post to Bluesky when new documents are published. Enable this in your config: 34 34 + 35 35 + ```json 36 36 + { 37 37 + "bluesky": { 38 38 + "enabled": true, 39 39 + "maxAgeDays": 30 40 40 + } 41 41 + } 42 42 + ``` 43 43 + 44 44 + When enabled, each new document will create a Bluesky post with the title, description, and canonical URL. If a cover image exists, it will be embedded in the post. The combined content is limited to 300 characters. 45 45 + 46 46 + The `maxAgeDays` setting prevents flooding your feed when first setting up Sequoia. For example, if you have 40 existing blog posts, only those published within the last 30 days will be posted to Bluesky. 47 47 + 48 48 + ## Draft Posts 49 49 + 50 50 + Posts with `draft: true` in their frontmatter are automatically skipped during publishing. This lets you work on content without accidentally publishing it. 51 51 + 52 52 + ```yaml 53 53 + --- 54 54 + title: Work in Progress 55 55 + draft: true 56 56 + --- 57 57 + ``` 58 58 + 59 59 + If your framework uses a different field name (like `private` or `hidden`), configure it in `sequoia.json`: 60 60 + 61 61 + ```json 62 62 + { 63 63 + "frontmatter": { 64 64 + "draft": "private" 65 65 + } 66 66 + } 67 67 + ``` 68 68 + 69 69 + ## Comments 70 70 + 71 71 + When Bluesky posting is enabled, Sequoia links each published document to its corresponding Bluesky post. This enables comments on your blog posts through Bluesky replies. 72 72 + 73 73 + To display comments on your site, use the `sequoia-comments` web component. See the [Comments guide](/comments) for setup instructions. 30 74 31 75 ## Troubleshooting 32 76

+9 -7

docs/docs/pages/quickstart.mdx

··· 31 31 sequoia 32 32 ``` 33 33 34 34 - ### Authorize 35 35 - 36 36 - In order for Sequoia to publish or update records on your PDS, you need to authorize it with your ATProto handle and an app password. 34 34 + ### Login 37 35 38 38 - :::tip 39 39 - You can create an app password [here](https://bsky.app/settings/app-passwords) 40 40 - ::: 36 36 + In order for Sequoia to publish or update records on your PDS, you need to authenticate with your ATProto account. 41 37 42 38 ```bash [Terminal] 43 43 - sequoia auth 39 39 + sequoia login 44 40 ``` 41 41 + 42 42 + This will open your browser to complete OAuth authentication, and your sessions will refresh automatically as you use the CLI. 43 43 + 44 44 + :::tip 45 45 + Alternatively, you can use `sequoia auth` to authenticate with an [app password](https://bsky.app/settings/app-passwords) instead of OAuth. 46 46 + ::: 45 47 46 48 ### Initialize 47 49

docs/docs/public/icon-dark.png

This is a binary file and will not be displayed.

docs/docs/public/og.png

This is a binary file and will not be displayed.

+856

docs/docs/public/sequoia-comments.js

··· 1 1 + /** 2 2 + * Sequoia Comments - A Bluesky-powered comments component 3 3 + * 4 4 + * A self-contained Web Component that displays comments from Bluesky posts 5 5 + * linked to documents via the AT Protocol. 6 6 + * 7 7 + * Usage: 8 8 + * <sequoia-comments></sequoia-comments> 9 9 + * 10 10 + * The component looks for a document URI in two places: 11 11 + * 1. The `document-uri` attribute on the element 12 12 + * 2. A <link rel="site.standard.document" href="at://..."> tag in the document head 13 13 + * 14 14 + * Attributes: 15 15 + * - document-uri: AT Protocol URI for the document (optional if link tag exists) 16 16 + * - depth: Maximum depth of nested replies to fetch (default: 6) 17 17 + * 18 18 + * CSS Custom Properties: 19 19 + * - --sequoia-fg-color: Text color (default: #1f2937) 20 20 + * - --sequoia-bg-color: Background color (default: #ffffff) 21 21 + * - --sequoia-border-color: Border color (default: #e5e7eb) 22 22 + * - --sequoia-accent-color: Accent/link color (default: #2563eb) 23 23 + * - --sequoia-secondary-color: Secondary text color (default: #6b7280) 24 24 + * - --sequoia-border-radius: Border radius (default: 8px) 25 25 + */ 26 26 + 27 27 + // ============================================================================ 28 28 + // Styles 29 29 + // ============================================================================ 30 30 + 31 31 + const styles = ` 32 32 + :host { 33 33 + display: block; 34 34 + font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; 35 35 + color: var(--sequoia-fg-color, #1f2937); 36 36 + line-height: 1.5; 37 37 + } 38 38 + 39 39 + * { 40 40 + box-sizing: border-box; 41 41 + } 42 42 + 43 43 + .sequoia-comments-container { 44 44 + max-width: 100%; 45 45 + } 46 46 + 47 47 + .sequoia-loading, 48 48 + .sequoia-error, 49 49 + .sequoia-empty, 50 50 + .sequoia-warning { 51 51 + padding: 1rem; 52 52 + border-radius: var(--sequoia-border-radius, 8px); 53 53 + text-align: center; 54 54 + } 55 55 + 56 56 + .sequoia-loading { 57 57 + background: var(--sequoia-bg-color, #ffffff); 58 58 + border: 1px solid var(--sequoia-border-color, #e5e7eb); 59 59 + color: var(--sequoia-secondary-color, #6b7280); 60 60 + } 61 61 + 62 62 + .sequoia-loading-spinner { 63 63 + display: inline-block; 64 64 + width: 1.25rem; 65 65 + height: 1.25rem; 66 66 + border: 2px solid var(--sequoia-border-color, #e5e7eb); 67 67 + border-top-color: var(--sequoia-accent-color, #2563eb); 68 68 + border-radius: 50%; 69 69 + animation: sequoia-spin 0.8s linear infinite; 70 70 + margin-right: 0.5rem; 71 71 + vertical-align: middle; 72 72 + } 73 73 + 74 74 + @keyframes sequoia-spin { 75 75 + to { transform: rotate(360deg); } 76 76 + } 77 77 + 78 78 + .sequoia-error { 79 79 + background: #fef2f2; 80 80 + border: 1px solid #fecaca; 81 81 + color: #dc2626; 82 82 + } 83 83 + 84 84 + .sequoia-warning { 85 85 + background: #fffbeb; 86 86 + border: 1px solid #fde68a; 87 87 + color: #d97706; 88 88 + } 89 89 + 90 90 + .sequoia-empty { 91 91 + background: var(--sequoia-bg-color, #ffffff); 92 92 + border: 1px solid var(--sequoia-border-color, #e5e7eb); 93 93 + color: var(--sequoia-secondary-color, #6b7280); 94 94 + } 95 95 + 96 96 + .sequoia-comments-header { 97 97 + display: flex; 98 98 + justify-content: space-between; 99 99 + align-items: center; 100 100 + margin-bottom: 1rem; 101 101 + padding-bottom: 0.75rem; 102 102 + } 103 103 + 104 104 + .sequoia-comments-title { 105 105 + font-size: 1.125rem; 106 106 + font-weight: 600; 107 107 + margin: 0; 108 108 + } 109 109 + 110 110 + .sequoia-reply-button { 111 111 + display: inline-flex; 112 112 + align-items: center; 113 113 + gap: 0.375rem; 114 114 + padding: 0.5rem 1rem; 115 115 + background: var(--sequoia-accent-color, #2563eb); 116 116 + color: #ffffff; 117 117 + border: none; 118 118 + border-radius: var(--sequoia-border-radius, 8px); 119 119 + font-size: 0.875rem; 120 120 + font-weight: 500; 121 121 + cursor: pointer; 122 122 + text-decoration: none; 123 123 + transition: background-color 0.15s ease; 124 124 + } 125 125 + 126 126 + .sequoia-reply-button:hover { 127 127 + background: color-mix(in srgb, var(--sequoia-accent-color, #2563eb) 85%, black); 128 128 + } 129 129 + 130 130 + .sequoia-reply-button svg { 131 131 + width: 1rem; 132 132 + height: 1rem; 133 133 + } 134 134 + 135 135 + .sequoia-comments-list { 136 136 + display: flex; 137 137 + flex-direction: column; 138 138 + } 139 139 + 140 140 + .sequoia-thread { 141 141 + border-top: 1px solid var(--sequoia-border-color, #e5e7eb); 142 142 + padding-bottom: 1rem; 143 143 + } 144 144 + 145 145 + .sequoia-thread + .sequoia-thread { 146 146 + margin-top: 0.5rem; 147 147 + } 148 148 + 149 149 + .sequoia-thread:last-child { 150 150 + border-bottom: 1px solid var(--sequoia-border-color, #e5e7eb); 151 151 + } 152 152 + 153 153 + .sequoia-comment { 154 154 + display: flex; 155 155 + gap: 0.75rem; 156 156 + padding-top: 1rem; 157 157 + } 158 158 + 159 159 + .sequoia-comment-avatar-column { 160 160 + display: flex; 161 161 + flex-direction: column; 162 162 + align-items: center; 163 163 + flex-shrink: 0; 164 164 + width: 2.5rem; 165 165 + position: relative; 166 166 + } 167 167 + 168 168 + .sequoia-comment-avatar { 169 169 + width: 2.5rem; 170 170 + height: 2.5rem; 171 171 + border-radius: 50%; 172 172 + background: var(--sequoia-border-color, #e5e7eb); 173 173 + object-fit: cover; 174 174 + flex-shrink: 0; 175 175 + position: relative; 176 176 + z-index: 1; 177 177 + } 178 178 + 179 179 + .sequoia-comment-avatar-placeholder { 180 180 + width: 2.5rem; 181 181 + height: 2.5rem; 182 182 + border-radius: 50%; 183 183 + background: var(--sequoia-border-color, #e5e7eb); 184 184 + display: flex; 185 185 + align-items: center; 186 186 + justify-content: center; 187 187 + flex-shrink: 0; 188 188 + color: var(--sequoia-secondary-color, #6b7280); 189 189 + font-weight: 600; 190 190 + font-size: 1rem; 191 191 + position: relative; 192 192 + z-index: 1; 193 193 + } 194 194 + 195 195 + .sequoia-thread-line { 196 196 + position: absolute; 197 197 + top: 2.5rem; 198 198 + bottom: calc(-1rem - 0.5rem); 199 199 + left: 50%; 200 200 + transform: translateX(-50%); 201 201 + width: 2px; 202 202 + background: var(--sequoia-border-color, #e5e7eb); 203 203 + } 204 204 + 205 205 + .sequoia-comment-content { 206 206 + flex: 1; 207 207 + min-width: 0; 208 208 + } 209 209 + 210 210 + .sequoia-comment-header { 211 211 + display: flex; 212 212 + align-items: baseline; 213 213 + gap: 0.5rem; 214 214 + margin-bottom: 0.25rem; 215 215 + flex-wrap: wrap; 216 216 + } 217 217 + 218 218 + .sequoia-comment-author { 219 219 + font-weight: 600; 220 220 + color: var(--sequoia-fg-color, #1f2937); 221 221 + text-decoration: none; 222 222 + overflow: hidden; 223 223 + text-overflow: ellipsis; 224 224 + white-space: nowrap; 225 225 + } 226 226 + 227 227 + .sequoia-comment-author:hover { 228 228 + color: var(--sequoia-accent-color, #2563eb); 229 229 + } 230 230 + 231 231 + .sequoia-comment-handle { 232 232 + font-size: 0.875rem; 233 233 + color: var(--sequoia-secondary-color, #6b7280); 234 234 + overflow: hidden; 235 235 + text-overflow: ellipsis; 236 236 + white-space: nowrap; 237 237 + } 238 238 + 239 239 + .sequoia-comment-time { 240 240 + font-size: 0.875rem; 241 241 + color: var(--sequoia-secondary-color, #6b7280); 242 242 + flex-shrink: 0; 243 243 + } 244 244 + 245 245 + .sequoia-comment-time::before { 246 246 + content: "·"; 247 247 + margin-right: 0.5rem; 248 248 + } 249 249 + 250 250 + .sequoia-comment-text { 251 251 + margin: 0; 252 252 + white-space: pre-wrap; 253 253 + word-wrap: break-word; 254 254 + } 255 255 + 256 256 + .sequoia-comment-text a { 257 257 + color: var(--sequoia-accent-color, #2563eb); 258 258 + text-decoration: none; 259 259 + } 260 260 + 261 261 + .sequoia-comment-text a:hover { 262 262 + text-decoration: underline; 263 263 + } 264 264 + 265 265 + .sequoia-bsky-logo { 266 266 + width: 1rem; 267 267 + height: 1rem; 268 268 + } 269 269 + `; 270 270 + 271 271 + // ============================================================================ 272 272 + // Utility Functions 273 273 + // ============================================================================ 274 274 + 275 275 + /** 276 276 + * Format a relative time string (e.g., "2 hours ago") 277 277 + * @param {string} dateString - ISO date string 278 278 + * @returns {string} Formatted relative time 279 279 + */ 280 280 + function formatRelativeTime(dateString) { 281 281 + const date = new Date(dateString); 282 282 + const now = new Date(); 283 283 + const diffMs = now.getTime() - date.getTime(); 284 284 + const diffSeconds = Math.floor(diffMs / 1000); 285 285 + const diffMinutes = Math.floor(diffSeconds / 60); 286 286 + const diffHours = Math.floor(diffMinutes / 60); 287 287 + const diffDays = Math.floor(diffHours / 24); 288 288 + const diffWeeks = Math.floor(diffDays / 7); 289 289 + const diffMonths = Math.floor(diffDays / 30); 290 290 + const diffYears = Math.floor(diffDays / 365); 291 291 + 292 292 + if (diffSeconds < 60) { 293 293 + return "just now"; 294 294 + } 295 295 + if (diffMinutes < 60) { 296 296 + return `${diffMinutes}m ago`; 297 297 + } 298 298 + if (diffHours < 24) { 299 299 + return `${diffHours}h ago`; 300 300 + } 301 301 + if (diffDays < 7) { 302 302 + return `${diffDays}d ago`; 303 303 + } 304 304 + if (diffWeeks < 4) { 305 305 + return `${diffWeeks}w ago`; 306 306 + } 307 307 + if (diffMonths < 12) { 308 308 + return `${diffMonths}mo ago`; 309 309 + } 310 310 + return `${diffYears}y ago`; 311 311 + } 312 312 + 313 313 + /** 314 314 + * Escape HTML special characters 315 315 + * @param {string} text - Text to escape 316 316 + * @returns {string} Escaped HTML 317 317 + */ 318 318 + function escapeHtml(text) { 319 319 + const div = document.createElement("div"); 320 320 + div.textContent = text; 321 321 + return div.innerHTML; 322 322 + } 323 323 + 324 324 + /** 325 325 + * Convert post text with facets to HTML 326 326 + * @param {string} text - Post text 327 327 + * @param {Array<{index: {byteStart: number, byteEnd: number}, features: Array<{$type: string, uri?: string, did?: string, tag?: string}>}>} [facets] - Rich text facets 328 328 + * @returns {string} HTML string with links 329 329 + */ 330 330 + function renderTextWithFacets(text, facets) { 331 331 + if (!facets || facets.length === 0) { 332 332 + return escapeHtml(text); 333 333 + } 334 334 + 335 335 + // Convert text to bytes for proper indexing 336 336 + const encoder = new TextEncoder(); 337 337 + const decoder = new TextDecoder(); 338 338 + const textBytes = encoder.encode(text); 339 339 + 340 340 + // Sort facets by start index 341 341 + const sortedFacets = [...facets].sort( 342 342 + (a, b) => a.index.byteStart - b.index.byteStart, 343 343 + ); 344 344 + 345 345 + let result = ""; 346 346 + let lastEnd = 0; 347 347 + 348 348 + for (const facet of sortedFacets) { 349 349 + const { byteStart, byteEnd } = facet.index; 350 350 + 351 351 + // Add text before this facet 352 352 + if (byteStart > lastEnd) { 353 353 + const beforeBytes = textBytes.slice(lastEnd, byteStart); 354 354 + result += escapeHtml(decoder.decode(beforeBytes)); 355 355 + } 356 356 + 357 357 + // Get the facet text 358 358 + const facetBytes = textBytes.slice(byteStart, byteEnd); 359 359 + const facetText = decoder.decode(facetBytes); 360 360 + 361 361 + // Find the first renderable feature 362 362 + const feature = facet.features[0]; 363 363 + if (feature) { 364 364 + if (feature.$type === "app.bsky.richtext.facet#link") { 365 365 + result += `<a href="${escapeHtml(feature.uri)}" target="_blank" rel="noopener noreferrer">${escapeHtml(facetText)}</a>`; 366 366 + } else if (feature.$type === "app.bsky.richtext.facet#mention") { 367 367 + result += `<a href="https://bsky.app/profile/${escapeHtml(feature.did)}" target="_blank" rel="noopener noreferrer">${escapeHtml(facetText)}</a>`; 368 368 + } else if (feature.$type === "app.bsky.richtext.facet#tag") { 369 369 + result += `<a href="https://bsky.app/hashtag/${escapeHtml(feature.tag)}" target="_blank" rel="noopener noreferrer">${escapeHtml(facetText)}</a>`; 370 370 + } else { 371 371 + result += escapeHtml(facetText); 372 372 + } 373 373 + } else { 374 374 + result += escapeHtml(facetText); 375 375 + } 376 376 + 377 377 + lastEnd = byteEnd; 378 378 + } 379 379 + 380 380 + // Add remaining text 381 381 + if (lastEnd < textBytes.length) { 382 382 + const remainingBytes = textBytes.slice(lastEnd); 383 383 + result += escapeHtml(decoder.decode(remainingBytes)); 384 384 + } 385 385 + 386 386 + return result; 387 387 + } 388 388 + 389 389 + /** 390 390 + * Get initials from a name for avatar placeholder 391 391 + * @param {string} name - Display name 392 392 + * @returns {string} Initials (1-2 characters) 393 393 + */ 394 394 + function getInitials(name) { 395 395 + const parts = name.trim().split(/\s+/); 396 396 + if (parts.length >= 2) { 397 397 + return (parts[0][0] + parts[1][0]).toUpperCase(); 398 398 + } 399 399 + return name.substring(0, 2).toUpperCase(); 400 400 + } 401 401 + 402 402 + // ============================================================================ 403 403 + // AT Protocol Client Functions 404 404 + // ============================================================================ 405 405 + 406 406 + /** 407 407 + * Parse an AT URI into its components 408 408 + * Format: at://did/collection/rkey 409 409 + * @param {string} atUri - AT Protocol URI 410 410 + * @returns {{did: string, collection: string, rkey: string} | null} Parsed components or null 411 411 + */ 412 412 + function parseAtUri(atUri) { 413 413 + const match = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/); 414 414 + if (!match) return null; 415 415 + return { 416 416 + did: match[1], 417 417 + collection: match[2], 418 418 + rkey: match[3], 419 419 + }; 420 420 + } 421 421 + 422 422 + /** 423 423 + * Resolve a DID to its PDS URL 424 424 + * Supports did:plc and did:web methods 425 425 + * @param {string} did - Decentralized Identifier 426 426 + * @returns {Promise<string>} PDS URL 427 427 + */ 428 428 + async function resolvePDS(did) { 429 429 + let pdsUrl; 430 430 + 431 431 + if (did.startsWith("did:plc:")) { 432 432 + // Fetch DID document from plc.directory 433 433 + const didDocUrl = `https://plc.directory/${did}`; 434 434 + const didDocResponse = await fetch(didDocUrl); 435 435 + if (!didDocResponse.ok) { 436 436 + throw new Error(`Could not fetch DID document: ${didDocResponse.status}`); 437 437 + } 438 438 + const didDoc = await didDocResponse.json(); 439 439 + 440 440 + // Find the PDS service endpoint 441 441 + const pdsService = didDoc.service?.find( 442 442 + (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 443 443 + ); 444 444 + pdsUrl = pdsService?.serviceEndpoint; 445 445 + } else if (did.startsWith("did:web:")) { 446 446 + // For did:web, fetch the DID document from the domain 447 447 + const domain = did.replace("did:web:", ""); 448 448 + const didDocUrl = `https://${domain}/.well-known/did.json`; 449 449 + const didDocResponse = await fetch(didDocUrl); 450 450 + if (!didDocResponse.ok) { 451 451 + throw new Error(`Could not fetch DID document: ${didDocResponse.status}`); 452 452 + } 453 453 + const didDoc = await didDocResponse.json(); 454 454 + 455 455 + const pdsService = didDoc.service?.find( 456 456 + (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 457 457 + ); 458 458 + pdsUrl = pdsService?.serviceEndpoint; 459 459 + } else { 460 460 + throw new Error(`Unsupported DID method: ${did}`); 461 461 + } 462 462 + 463 463 + if (!pdsUrl) { 464 464 + throw new Error("Could not find PDS URL for user"); 465 465 + } 466 466 + 467 467 + return pdsUrl; 468 468 + } 469 469 + 470 470 + /** 471 471 + * Fetch a record from a PDS using the public API 472 472 + * @param {string} did - DID of the repository owner 473 473 + * @param {string} collection - Collection name 474 474 + * @param {string} rkey - Record key 475 475 + * @returns {Promise<any>} Record value 476 476 + */ 477 477 + async function getRecord(did, collection, rkey) { 478 478 + const pdsUrl = await resolvePDS(did); 479 479 + 480 480 + const url = new URL(`${pdsUrl}/xrpc/com.atproto.repo.getRecord`); 481 481 + url.searchParams.set("repo", did); 482 482 + url.searchParams.set("collection", collection); 483 483 + url.searchParams.set("rkey", rkey); 484 484 + 485 485 + const response = await fetch(url.toString()); 486 486 + if (!response.ok) { 487 487 + throw new Error(`Failed to fetch record: ${response.status}`); 488 488 + } 489 489 + 490 490 + const data = await response.json(); 491 491 + return data.value; 492 492 + } 493 493 + 494 494 + /** 495 495 + * Fetch a document record from its AT URI 496 496 + * @param {string} atUri - AT Protocol URI for the document 497 497 + * @returns {Promise<{$type: string, title: string, site: string, path: string, textContent: string, publishedAt: string, canonicalUrl?: string, description?: string, tags?: string[], bskyPostRef?: {uri: string, cid: string}}>} Document record 498 498 + */ 499 499 + async function getDocument(atUri) { 500 500 + const parsed = parseAtUri(atUri); 501 501 + if (!parsed) { 502 502 + throw new Error(`Invalid AT URI: ${atUri}`); 503 503 + } 504 504 + 505 505 + return getRecord(parsed.did, parsed.collection, parsed.rkey); 506 506 + } 507 507 + 508 508 + /** 509 509 + * Fetch a post thread from the public Bluesky API 510 510 + * @param {string} postUri - AT Protocol URI for the post 511 511 + * @param {number} [depth=6] - Maximum depth of replies to fetch 512 512 + * @returns {Promise<ThreadViewPost>} Thread view post 513 513 + */ 514 514 + async function getPostThread(postUri, depth = 6) { 515 515 + const url = new URL( 516 516 + "https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread", 517 517 + ); 518 518 + url.searchParams.set("uri", postUri); 519 519 + url.searchParams.set("depth", depth.toString()); 520 520 + 521 521 + const response = await fetch(url.toString()); 522 522 + if (!response.ok) { 523 523 + throw new Error(`Failed to fetch post thread: ${response.status}`); 524 524 + } 525 525 + 526 526 + const data = await response.json(); 527 527 + 528 528 + if (data.thread.$type !== "app.bsky.feed.defs#threadViewPost") { 529 529 + throw new Error("Post not found or blocked"); 530 530 + } 531 531 + 532 532 + return data.thread; 533 533 + } 534 534 + 535 535 + /** 536 536 + * Build a Bluesky app URL for a post 537 537 + * @param {string} postUri - AT Protocol URI for the post 538 538 + * @returns {string} Bluesky app URL 539 539 + */ 540 540 + function buildBskyAppUrl(postUri) { 541 541 + const parsed = parseAtUri(postUri); 542 542 + if (!parsed) { 543 543 + throw new Error(`Invalid post URI: ${postUri}`); 544 544 + } 545 545 + 546 546 + return `https://bsky.app/profile/${parsed.did}/post/${parsed.rkey}`; 547 547 + } 548 548 + 549 549 + /** 550 550 + * Type guard for ThreadViewPost 551 551 + * @param {any} post - Post to check 552 552 + * @returns {boolean} True if post is a ThreadViewPost 553 553 + */ 554 554 + function isThreadViewPost(post) { 555 555 + return post?.$type === "app.bsky.feed.defs#threadViewPost"; 556 556 + } 557 557 + 558 558 + // ============================================================================ 559 559 + // Bluesky Icon 560 560 + // ============================================================================ 561 561 + 562 562 + const BLUESKY_ICON = `<svg class="sequoia-bsky-logo" viewBox="0 0 600 530" fill="currentColor" xmlns="http://www.w3.org/2000/svg"> 563 563 + <path d="m135.72 44.03c66.496 49.921 138.02 151.14 164.28 205.46 26.262-54.316 97.782-155.54 164.28-205.46 47.98-36.021 125.72-63.892 125.72 24.795 0 17.712-10.155 148.79-16.111 170.07-20.703 73.984-96.144 92.854-163.25 81.433 117.3 19.964 147.14 86.092 82.697 152.22-122.39 125.59-175.91-31.511-189.63-71.766-2.514-7.3797-3.6904-10.832-3.7077-7.8964-0.0174-2.9357-1.1937 0.51669-3.7077 7.8964-13.714 40.255-67.233 197.36-189.63 71.766-64.444-66.128-34.605-132.26 82.697-152.22-67.108 11.421-142.55-7.4491-163.25-81.433-5.9562-21.282-16.111-152.36-16.111-170.07 0-88.687 77.742-60.816 125.72-24.795z"/> 564 564 + </svg>`; 565 565 + 566 566 + // ============================================================================ 567 567 + // Web Component 568 568 + // ============================================================================ 569 569 + 570 570 + // SSR-safe base class - use HTMLElement in browser, empty class in Node.js 571 571 + const BaseElement = typeof HTMLElement !== "undefined" ? HTMLElement : class {}; 572 572 + 573 573 + class SequoiaComments extends BaseElement { 574 574 + constructor() { 575 575 + super(); 576 576 + this.shadow = this.attachShadow({ mode: "open" }); 577 577 + this.state = { type: "loading" }; 578 578 + this.abortController = null; 579 579 + } 580 580 + 581 581 + static get observedAttributes() { 582 582 + return ["document-uri", "depth"]; 583 583 + } 584 584 + 585 585 + connectedCallback() { 586 586 + this.render(); 587 587 + this.loadComments(); 588 588 + } 589 589 + 590 590 + disconnectedCallback() { 591 591 + this.abortController?.abort(); 592 592 + } 593 593 + 594 594 + attributeChangedCallback() { 595 595 + if (this.isConnected) { 596 596 + this.loadComments(); 597 597 + } 598 598 + } 599 599 + 600 600 + get documentUri() { 601 601 + // First check attribute 602 602 + const attrUri = this.getAttribute("document-uri"); 603 603 + if (attrUri) { 604 604 + return attrUri; 605 605 + } 606 606 + 607 607 + // Then scan for link tag in document head 608 608 + const linkTag = document.querySelector( 609 609 + 'link[rel="site.standard.document"]', 610 610 + ); 611 611 + return linkTag?.href ?? null; 612 612 + } 613 613 + 614 614 + get depth() { 615 615 + const depthAttr = this.getAttribute("depth"); 616 616 + return depthAttr ? parseInt(depthAttr, 10) : 6; 617 617 + } 618 618 + 619 619 + async loadComments() { 620 620 + // Cancel any in-flight request 621 621 + this.abortController?.abort(); 622 622 + this.abortController = new AbortController(); 623 623 + 624 624 + this.state = { type: "loading" }; 625 625 + this.render(); 626 626 + 627 627 + const docUri = this.documentUri; 628 628 + if (!docUri) { 629 629 + this.state = { type: "no-document" }; 630 630 + this.render(); 631 631 + return; 632 632 + } 633 633 + 634 634 + try { 635 635 + // Fetch the document record 636 636 + const document = await getDocument(docUri); 637 637 + 638 638 + // Check if document has a Bluesky post reference 639 639 + if (!document.bskyPostRef) { 640 640 + this.state = { type: "no-comments-enabled" }; 641 641 + this.render(); 642 642 + return; 643 643 + } 644 644 + 645 645 + const postUrl = buildBskyAppUrl(document.bskyPostRef.uri); 646 646 + 647 647 + // Fetch the post thread 648 648 + const thread = await getPostThread(document.bskyPostRef.uri, this.depth); 649 649 + 650 650 + // Check if there are any replies 651 651 + const replies = thread.replies?.filter(isThreadViewPost) ?? []; 652 652 + if (replies.length === 0) { 653 653 + this.state = { type: "empty", postUrl }; 654 654 + this.render(); 655 655 + return; 656 656 + } 657 657 + 658 658 + this.state = { type: "loaded", thread, postUrl }; 659 659 + this.render(); 660 660 + } catch (error) { 661 661 + const message = 662 662 + error instanceof Error ? error.message : "Failed to load comments"; 663 663 + this.state = { type: "error", message }; 664 664 + this.render(); 665 665 + } 666 666 + } 667 667 + 668 668 + render() { 669 669 + const styleTag = `<style>${styles}</style>`; 670 670 + 671 671 + switch (this.state.type) { 672 672 + case "loading": 673 673 + this.shadow.innerHTML = ` 674 674 + ${styleTag} 675 675 + <div class="sequoia-comments-container"> 676 676 + <div class="sequoia-loading"> 677 677 + <span class="sequoia-loading-spinner"></span> 678 678 + Loading comments... 679 679 + </div> 680 680 + </div> 681 681 + `; 682 682 + break; 683 683 + 684 684 + case "no-document": 685 685 + this.shadow.innerHTML = ` 686 686 + ${styleTag} 687 687 + <div class="sequoia-comments-container"> 688 688 + <div class="sequoia-warning"> 689 689 + No document found. Add a <code>&lt;link rel="site.standard.document" href="at://..."&gt;</code> tag to your page. 690 690 + </div> 691 691 + </div> 692 692 + `; 693 693 + break; 694 694 + 695 695 + case "no-comments-enabled": 696 696 + this.shadow.innerHTML = ` 697 697 + ${styleTag} 698 698 + <div class="sequoia-comments-container"> 699 699 + <div class="sequoia-empty"> 700 700 + Comments are not enabled for this post. 701 701 + </div> 702 702 + </div> 703 703 + `; 704 704 + break; 705 705 + 706 706 + case "empty": 707 707 + this.shadow.innerHTML = ` 708 708 + ${styleTag} 709 709 + <div class="sequoia-comments-container"> 710 710 + <div class="sequoia-comments-header"> 711 711 + <h3 class="sequoia-comments-title">Comments</h3> 712 712 + <a href="${this.state.postUrl}" target="_blank" rel="noopener noreferrer" class="sequoia-reply-button"> 713 713 + ${BLUESKY_ICON} 714 714 + Reply on Bluesky 715 715 + </a> 716 716 + </div> 717 717 + <div class="sequoia-empty"> 718 718 + No comments yet. Be the first to reply on Bluesky! 719 719 + </div> 720 720 + </div> 721 721 + `; 722 722 + break; 723 723 + 724 724 + case "error": 725 725 + this.shadow.innerHTML = ` 726 726 + ${styleTag} 727 727 + <div class="sequoia-comments-container"> 728 728 + <div class="sequoia-error"> 729 729 + Failed to load comments: ${escapeHtml(this.state.message)} 730 730 + </div> 731 731 + </div> 732 732 + `; 733 733 + break; 734 734 + 735 735 + case "loaded": { 736 736 + const replies = 737 737 + this.state.thread.replies?.filter(isThreadViewPost) ?? []; 738 738 + const threadsHtml = replies 739 739 + .map((reply) => this.renderThread(reply)) 740 740 + .join(""); 741 741 + const commentCount = this.countComments(replies); 742 742 + 743 743 + this.shadow.innerHTML = ` 744 744 + ${styleTag} 745 745 + <div class="sequoia-comments-container"> 746 746 + <div class="sequoia-comments-header"> 747 747 + <h3 class="sequoia-comments-title">${commentCount} Comment${commentCount !== 1 ? "s" : ""}</h3> 748 748 + <a href="${this.state.postUrl}" target="_blank" rel="noopener noreferrer" class="sequoia-reply-button"> 749 749 + ${BLUESKY_ICON} 750 750 + Reply on Bluesky 751 751 + </a> 752 752 + </div> 753 753 + <div class="sequoia-comments-list"> 754 754 + ${threadsHtml} 755 755 + </div> 756 756 + </div> 757 757 + `; 758 758 + break; 759 759 + } 760 760 + } 761 761 + } 762 762 + 763 763 + /** 764 764 + * Flatten a thread into a linear list of comments 765 765 + * @param {ThreadViewPost} thread - Thread to flatten 766 766 + * @returns {Array<{post: any, hasMoreReplies: boolean}>} Flattened comments 767 767 + */ 768 768 + flattenThread(thread) { 769 769 + const result = []; 770 770 + const nestedReplies = thread.replies?.filter(isThreadViewPost) ?? []; 771 771 + 772 772 + result.push({ 773 773 + post: thread.post, 774 774 + hasMoreReplies: nestedReplies.length > 0, 775 775 + }); 776 776 + 777 777 + // Recursively flatten nested replies 778 778 + for (const reply of nestedReplies) { 779 779 + result.push(...this.flattenThread(reply)); 780 780 + } 781 781 + 782 782 + return result; 783 783 + } 784 784 + 785 785 + /** 786 786 + * Render a complete thread (top-level comment + all nested replies) 787 787 + */ 788 788 + renderThread(thread) { 789 789 + const flatComments = this.flattenThread(thread); 790 790 + const commentsHtml = flatComments 791 791 + .map((item, index) => 792 792 + this.renderComment(item.post, item.hasMoreReplies, index), 793 793 + ) 794 794 + .join(""); 795 795 + 796 796 + return `<div class="sequoia-thread">${commentsHtml}</div>`; 797 797 + } 798 798 + 799 799 + /** 800 800 + * Render a single comment 801 801 + * @param {any} post - Post data 802 802 + * @param {boolean} showThreadLine - Whether to show the connecting thread line 803 803 + * @param {number} _index - Index in the flattened thread (0 = top-level) 804 804 + */ 805 805 + renderComment(post, showThreadLine = false, _index = 0) { 806 806 + const author = post.author; 807 807 + const displayName = author.displayName || author.handle; 808 808 + const avatarHtml = author.avatar 809 809 + ? `<img class="sequoia-comment-avatar" src="${escapeHtml(author.avatar)}" alt="${escapeHtml(displayName)}" loading="lazy" />` 810 810 + : `<div class="sequoia-comment-avatar-placeholder">${getInitials(displayName)}</div>`; 811 811 + 812 812 + const profileUrl = `https://bsky.app/profile/${author.did}`; 813 813 + const textHtml = renderTextWithFacets(post.record.text, post.record.facets); 814 814 + const timeAgo = formatRelativeTime(post.record.createdAt); 815 815 + const threadLineHtml = showThreadLine 816 816 + ? '<div class="sequoia-thread-line"></div>' 817 817 + : ""; 818 818 + 819 819 + return ` 820 820 + <div class="sequoia-comment"> 821 821 + <div class="sequoia-comment-avatar-column"> 822 822 + ${avatarHtml} 823 823 + ${threadLineHtml} 824 824 + </div> 825 825 + <div class="sequoia-comment-content"> 826 826 + <div class="sequoia-comment-header"> 827 827 + <a href="${profileUrl}" target="_blank" rel="noopener noreferrer" class="sequoia-comment-author"> 828 828 + ${escapeHtml(displayName)} 829 829 + </a> 830 830 + <span class="sequoia-comment-handle">@${escapeHtml(author.handle)}</span> 831 831 + <span class="sequoia-comment-time">${timeAgo}</span> 832 832 + </div> 833 833 + <p class="sequoia-comment-text">${textHtml}</p> 834 834 + </div> 835 835 + </div> 836 836 + `; 837 837 + } 838 838 + 839 839 + countComments(replies) { 840 840 + let count = 0; 841 841 + for (const reply of replies) { 842 842 + count += 1; 843 843 + const nested = reply.replies?.filter(isThreadViewPost) ?? []; 844 844 + count += this.countComments(nested); 845 845 + } 846 846 + return count; 847 847 + } 848 848 + } 849 849 + 850 850 + // Register the custom element 851 851 + if (typeof customElements !== "undefined") { 852 852 + customElements.define("sequoia-comments", SequoiaComments); 853 853 + } 854 854 + 855 855 + // Export for module usage 856 856 + export { SequoiaComments };

+8

docs/docs/styles.css

··· 1 1 + :root { 2 2 + --sequoia-fg-color: var(--vocs-color_text); 3 3 + --sequoia-bg-color: var(--vocs-color_background); 4 4 + --sequoia-border-color: var(--vocs-color_border); 5 5 + --sequoia-accent-color: var(--vocs-color_link); 6 6 + --sequoia-secondary-color: var(--vocs-color_text3); 7 7 + --sequoia-border-radius: 8px; 8 8 + }

+18 -13

docs/sequoia.json

··· 1 1 { 2 2 - "siteUrl": "https://sequoia.pub", 3 3 - "contentDir": "docs/pages/blog", 4 4 - "imagesDir": "docs/public", 5 5 - "publicDir": "docs/public", 6 6 - "outputDir": "docs/dist", 7 7 - "pathPrefix": "/blog", 8 8 - "publicationUri": "at://did:plc:kq6bvkw4sxof3vdinuitehn5/site.standard.publication/3mdnzt4rqr42v", 9 9 - "pdsUrl": "https://andromeda.social", 10 10 - "frontmatter": { 11 11 - "publishDate": "date" 12 12 - }, 13 13 - "ignore": ["index.mdx"] 14 14 - } 2 2 + "siteUrl": "https://sequoia.pub", 3 3 + "contentDir": "docs/pages/blog", 4 4 + "imagesDir": "docs/public", 5 5 + "publicDir": "docs/public", 6 6 + "outputDir": "docs/dist", 7 7 + "pathPrefix": "/blog", 8 8 + "publicationUri": "at://did:plc:kq6bvkw4sxof3vdinuitehn5/site.standard.publication/3mdnzt4rqr42v", 9 9 + "pdsUrl": "https://andromeda.social", 10 10 + "frontmatter": { 11 11 + "publishDate": "date" 12 12 + }, 13 13 + "ignore": [ 14 14 + "index.mdx" 15 15 + ], 16 16 + "ui": { 17 17 + "components": "docs/components" 18 18 + } 19 19 + }

+1

docs/vocs.config.ts

··· 34 34 items: [ 35 35 { text: "Setup", link: "/setup" }, 36 36 { text: "Publishing", link: "/publishing" }, 37 37 + { text: "Comments", link: "/comments" }, 37 38 { text: "Verifying", link: "/verifying" }, 38 39 { text: "Workflows", link: "/workflows" }, 39 40 ],

+37

packages/cli/biome.json

··· 1 1 + { 2 2 + "$schema": "https://biomejs.dev/schemas/2.3.13/schema.json", 3 3 + "vcs": { 4 4 + "enabled": true, 5 5 + "clientKind": "git", 6 6 + "useIgnoreFile": true 7 7 + }, 8 8 + "files": { 9 9 + "includes": ["**", "!!**/dist"] 10 10 + }, 11 11 + "formatter": { 12 12 + "enabled": true, 13 13 + "indentStyle": "tab" 14 14 + }, 15 15 + "linter": { 16 16 + "enabled": true, 17 17 + "rules": { 18 18 + "recommended": true, 19 19 + "style": { 20 20 + "noNonNullAssertion": "off" 21 21 + } 22 22 + } 23 23 + }, 24 24 + "javascript": { 25 25 + "formatter": { 26 26 + "quoteStyle": "double" 27 27 + } 28 28 + }, 29 29 + "assist": { 30 30 + "enabled": true, 31 31 + "actions": { 32 32 + "source": { 33 33 + "organizeImports": "on" 34 34 + } 35 35 + } 36 36 + } 37 37 + }

+8 -3

packages/cli/package.json

··· 1 1 { 2 2 "name": "sequoia-cli", 3 3 - "version": "0.1.1", 3 3 + "version": "0.4.0", 4 4 "type": "module", 5 5 "bin": { 6 6 "sequoia": "dist/index.js" ··· 14 14 ".": "./dist/index.js" 15 15 }, 16 16 "scripts": { 17 17 - "build": "bun build src/index.ts --target node --outdir dist", 17 17 + "lint": "biome lint --write", 18 18 + "format": "biome format --write", 19 19 + "build": "bun build src/index.ts --target node --outdir dist && mkdir -p dist/components && cp src/components/*.js dist/components/", 18 20 "dev": "bun run build && bun link", 19 21 "deploy": "bun run build && bun publish" 20 22 }, 21 23 "devDependencies": { 24 24 + "@biomejs/biome": "^2.3.13", 22 25 "@types/mime-types": "^3.0.1", 23 26 "@types/node": "^20" 24 27 }, ··· 27 30 }, 28 31 "dependencies": { 29 32 "@atproto/api": "^0.18.17", 33 33 + "@atproto/oauth-client-node": "^0.3.16", 30 34 "@clack/prompts": "^1.0.0", 31 35 "cmd-ts": "^0.14.3", 32 36 "glob": "^13.0.0", 33 37 "mime-types": "^2.1.35", 34 34 - "minimatch": "^10.1.1" 38 38 + "minimatch": "^10.1.1", 39 39 + "open": "^11.0.0" 35 40 } 36 41 }

+157

packages/cli/src/commands/add.ts

··· 1 1 + import * as fs from "node:fs/promises"; 2 2 + import { existsSync } from "node:fs"; 3 3 + import * as path from "node:path"; 4 4 + import { command, positional, string } from "cmd-ts"; 5 5 + import { intro, outro, text, spinner, log, note } from "@clack/prompts"; 6 6 + import { fileURLToPath } from "node:url"; 7 7 + import { dirname } from "node:path"; 8 8 + import { findConfig, loadConfig } from "../lib/config"; 9 9 + import type { PublisherConfig } from "../lib/types"; 10 10 + 11 11 + const __filename = fileURLToPath(import.meta.url); 12 12 + const __dirname = dirname(__filename); 13 13 + const COMPONENTS_DIR = path.join(__dirname, "components"); 14 14 + 15 15 + const DEFAULT_COMPONENTS_PATH = "src/components"; 16 16 + 17 17 + const AVAILABLE_COMPONENTS = ["sequoia-comments"]; 18 18 + 19 19 + export const addCommand = command({ 20 20 + name: "add", 21 21 + description: "Add a UI component to your project", 22 22 + args: { 23 23 + componentName: positional({ 24 24 + type: string, 25 25 + displayName: "component", 26 26 + description: "The name of the component to add", 27 27 + }), 28 28 + }, 29 29 + handler: async ({ componentName }) => { 30 30 + intro("Add Sequoia Component"); 31 31 + 32 32 + // Validate component name 33 33 + if (!AVAILABLE_COMPONENTS.includes(componentName)) { 34 34 + log.error(`Component '${componentName}' not found`); 35 35 + log.info("Available components:"); 36 36 + for (const comp of AVAILABLE_COMPONENTS) { 37 37 + log.info(` - ${comp}`); 38 38 + } 39 39 + process.exit(1); 40 40 + } 41 41 + 42 42 + // Try to load existing config 43 43 + const configPath = await findConfig(); 44 44 + let config: PublisherConfig | null = null; 45 45 + let componentsDir = DEFAULT_COMPONENTS_PATH; 46 46 + 47 47 + if (configPath) { 48 48 + try { 49 49 + config = await loadConfig(configPath); 50 50 + if (config.ui?.components) { 51 51 + componentsDir = config.ui.components; 52 52 + } 53 53 + } catch { 54 54 + // Config exists but may be incomplete - that's ok for UI components 55 55 + } 56 56 + } 57 57 + 58 58 + // If no UI config, prompt for components directory 59 59 + if (!config?.ui?.components) { 60 60 + log.info("No UI configuration found in sequoia.json"); 61 61 + 62 62 + const inputPath = await text({ 63 63 + message: "Where would you like to install components?", 64 64 + placeholder: DEFAULT_COMPONENTS_PATH, 65 65 + defaultValue: DEFAULT_COMPONENTS_PATH, 66 66 + }); 67 67 + 68 68 + if (inputPath === Symbol.for("cancel")) { 69 69 + outro("Cancelled"); 70 70 + process.exit(0); 71 71 + } 72 72 + 73 73 + componentsDir = inputPath as string; 74 74 + 75 75 + // Update or create config with UI settings 76 76 + if (configPath) { 77 77 + const s = spinner(); 78 78 + s.start("Updating sequoia.json..."); 79 79 + try { 80 80 + const configContent = await fs.readFile(configPath, "utf-8"); 81 81 + const existingConfig = JSON.parse(configContent); 82 82 + existingConfig.ui = { components: componentsDir }; 83 83 + await fs.writeFile( 84 84 + configPath, 85 85 + JSON.stringify(existingConfig, null, 2), 86 86 + "utf-8", 87 87 + ); 88 88 + s.stop("Updated sequoia.json with UI configuration"); 89 89 + } catch (error) { 90 90 + s.stop("Failed to update sequoia.json"); 91 91 + log.warn(`Could not update config: ${error}`); 92 92 + } 93 93 + } else { 94 94 + // Create minimal config just for UI 95 95 + const s = spinner(); 96 96 + s.start("Creating sequoia.json..."); 97 97 + const minimalConfig = { 98 98 + ui: { components: componentsDir }, 99 99 + }; 100 100 + await fs.writeFile( 101 101 + path.join(process.cwd(), "sequoia.json"), 102 102 + JSON.stringify(minimalConfig, null, 2), 103 103 + "utf-8", 104 104 + ); 105 105 + s.stop("Created sequoia.json with UI configuration"); 106 106 + } 107 107 + } 108 108 + 109 109 + // Resolve components directory 110 110 + const resolvedComponentsDir = path.isAbsolute(componentsDir) 111 111 + ? componentsDir 112 112 + : path.join(process.cwd(), componentsDir); 113 113 + 114 114 + // Create components directory if it doesn't exist 115 115 + if (!existsSync(resolvedComponentsDir)) { 116 116 + const s = spinner(); 117 117 + s.start(`Creating ${componentsDir} directory...`); 118 118 + await fs.mkdir(resolvedComponentsDir, { recursive: true }); 119 119 + s.stop(`Created ${componentsDir}`); 120 120 + } 121 121 + 122 122 + // Copy the component 123 123 + const sourceFile = path.join(COMPONENTS_DIR, `${componentName}.js`); 124 124 + const destFile = path.join(resolvedComponentsDir, `${componentName}.js`); 125 125 + 126 126 + if (!existsSync(sourceFile)) { 127 127 + log.error(`Component source file not found: ${sourceFile}`); 128 128 + log.info("This may be a build issue. Try reinstalling sequoia-cli."); 129 129 + process.exit(1); 130 130 + } 131 131 + 132 132 + const s = spinner(); 133 133 + s.start(`Installing ${componentName}...`); 134 134 + 135 135 + try { 136 136 + const componentCode = await fs.readFile(sourceFile, "utf-8"); 137 137 + await fs.writeFile(destFile, componentCode, "utf-8"); 138 138 + s.stop(`Installed ${componentName}`); 139 139 + } catch (error) { 140 140 + s.stop("Failed to install component"); 141 141 + log.error(`Error: ${error}`); 142 142 + process.exit(1); 143 143 + } 144 144 + 145 145 + // Show usage instructions 146 146 + note( 147 147 + `Add to your HTML:\n\n` + 148 148 + `<script type="module" src="${componentsDir}/${componentName}.js"></script>\n` + 149 149 + `<${componentName}></${componentName}>\n\n` + 150 150 + `The component will automatically read the document URI from:\n` + 151 151 + `<link rel="site.standard.document" href="at://...">`, 152 152 + "Usage", 153 153 + ); 154 154 + 155 155 + outro(`${componentName} added successfully!`); 156 156 + }, 157 157 + });

+153 -135

packages/cli/src/commands/auth.ts

··· 1 1 - import { command, flag, option, optional, string } from "cmd-ts"; 2 2 - import { note, text, password, confirm, select, spinner, log } from "@clack/prompts"; 3 1 import { AtpAgent } from "@atproto/api"; 4 2 import { 5 5 - saveCredentials, 6 6 - deleteCredentials, 7 7 - listCredentials, 8 8 - getCredentials, 9 9 - getCredentialsPath, 10 10 - } from "../lib/credentials"; 3 3 + confirm, 4 4 + log, 5 5 + note, 6 6 + password, 7 7 + select, 8 8 + spinner, 9 9 + text, 10 10 + } from "@clack/prompts"; 11 11 + import { command, flag, option, optional, string } from "cmd-ts"; 11 12 import { resolveHandleToPDS } from "../lib/atproto"; 13 13 + import { 14 14 + deleteCredentials, 15 15 + getCredentials, 16 16 + getCredentialsPath, 17 17 + listCredentials, 18 18 + saveCredentials, 19 19 + } from "../lib/credentials"; 12 20 import { exitOnCancel } from "../lib/prompts"; 13 21 14 22 export const authCommand = command({ 15 15 - name: "auth", 16 16 - description: "Authenticate with your ATProto PDS", 17 17 - args: { 18 18 - logout: option({ 19 19 - long: "logout", 20 20 - description: "Remove credentials for a specific identity (or all if only one exists)", 21 21 - type: optional(string), 22 22 - }), 23 23 - list: flag({ 24 24 - long: "list", 25 25 - description: "List all stored identities", 26 26 - }), 27 27 - }, 28 28 - handler: async ({ logout, list }) => { 29 29 - // List identities 30 30 - if (list) { 31 31 - const identities = await listCredentials(); 32 32 - if (identities.length === 0) { 33 33 - log.info("No stored identities"); 34 34 - } else { 35 35 - log.info("Stored identities:"); 36 36 - for (const id of identities) { 37 37 - console.log(` - ${id}`); 38 38 - } 39 39 - } 40 40 - return; 41 41 - } 23 23 + name: "auth", 24 24 + description: "Authenticate with your ATProto PDS", 25 25 + args: { 26 26 + logout: option({ 27 27 + long: "logout", 28 28 + description: 29 29 + "Remove credentials for a specific identity (or all if only one exists)", 30 30 + type: optional(string), 31 31 + }), 32 32 + list: flag({ 33 33 + long: "list", 34 34 + description: "List all stored identities", 35 35 + }), 36 36 + }, 37 37 + handler: async ({ logout, list }) => { 38 38 + // List identities 39 39 + if (list) { 40 40 + const identities = await listCredentials(); 41 41 + if (identities.length === 0) { 42 42 + log.info("No stored identities"); 43 43 + } else { 44 44 + log.info("Stored identities:"); 45 45 + for (const id of identities) { 46 46 + console.log(` - ${id}`); 47 47 + } 48 48 + } 49 49 + return; 50 50 + } 42 51 43 43 - // Logout 44 44 - if (logout !== undefined) { 45 45 - // If --logout was passed without a value, it will be an empty string 46 46 - const identifier = logout || undefined; 52 52 + // Logout 53 53 + if (logout !== undefined) { 54 54 + // If --logout was passed without a value, it will be an empty string 55 55 + const identifier = logout || undefined; 47 56 48 48 - if (!identifier) { 49 49 - // No identifier provided - show available and prompt 50 50 - const identities = await listCredentials(); 51 51 - if (identities.length === 0) { 52 52 - log.info("No saved credentials found"); 53 53 - return; 54 54 - } 55 55 - if (identities.length === 1) { 56 56 - const deleted = await deleteCredentials(identities[0]); 57 57 - if (deleted) { 58 58 - log.success(`Removed credentials for ${identities[0]}`); 59 59 - } 60 60 - return; 61 61 - } 62 62 - // Multiple identities - prompt 63 63 - const selected = exitOnCancel(await select({ 64 64 - message: "Select identity to remove:", 65 65 - options: identities.map(id => ({ value: id, label: id })), 66 66 - })); 67 67 - const deleted = await deleteCredentials(selected); 68 68 - if (deleted) { 69 69 - log.success(`Removed credentials for ${selected}`); 70 70 - } 71 71 - return; 72 72 - } 57 57 + if (!identifier) { 58 58 + // No identifier provided - show available and prompt 59 59 + const identities = await listCredentials(); 60 60 + if (identities.length === 0) { 61 61 + log.info("No saved credentials found"); 62 62 + return; 63 63 + } 64 64 + if (identities.length === 1) { 65 65 + const deleted = await deleteCredentials(identities[0]); 66 66 + if (deleted) { 67 67 + log.success(`Removed credentials for ${identities[0]}`); 68 68 + } 69 69 + return; 70 70 + } 71 71 + // Multiple identities - prompt 72 72 + const selected = exitOnCancel( 73 73 + await select({ 74 74 + message: "Select identity to remove:", 75 75 + options: identities.map((id) => ({ value: id, label: id })), 76 76 + }), 77 77 + ); 78 78 + const deleted = await deleteCredentials(selected); 79 79 + if (deleted) { 80 80 + log.success(`Removed credentials for ${selected}`); 81 81 + } 82 82 + return; 83 83 + } 73 84 74 74 - const deleted = await deleteCredentials(identifier); 75 75 - if (deleted) { 76 76 - log.success(`Removed credentials for ${identifier}`); 77 77 - } else { 78 78 - log.info(`No credentials found for ${identifier}`); 79 79 - } 80 80 - return; 81 81 - } 85 85 + const deleted = await deleteCredentials(identifier); 86 86 + if (deleted) { 87 87 + log.success(`Removed credentials for ${identifier}`); 88 88 + } else { 89 89 + log.info(`No credentials found for ${identifier}`); 90 90 + } 91 91 + return; 92 92 + } 82 93 83 83 - note( 84 84 - "To authenticate, you'll need an App Password.\n\n" + 85 85 - "Create one at: https://bsky.app/settings/app-passwords\n\n" + 86 86 - "App Passwords are safer than your main password and can be revoked.", 87 87 - "Authentication" 88 88 - ); 94 94 + note( 95 95 + "To authenticate, you'll need an App Password.\n\n" + 96 96 + "Create one at: https://bsky.app/settings/app-passwords\n\n" + 97 97 + "App Passwords are safer than your main password and can be revoked.", 98 98 + "Authentication", 99 99 + ); 89 100 90 90 - const identifier = exitOnCancel(await text({ 91 91 - message: "Handle or DID:", 92 92 - placeholder: "yourhandle.bsky.social", 93 93 - })); 101 101 + const identifier = exitOnCancel( 102 102 + await text({ 103 103 + message: "Handle or DID:", 104 104 + placeholder: "yourhandle.bsky.social", 105 105 + }), 106 106 + ); 94 107 95 95 - const appPassword = exitOnCancel(await password({ 96 96 - message: "App Password:", 97 97 - })); 108 108 + const appPassword = exitOnCancel( 109 109 + await password({ 110 110 + message: "App Password:", 111 111 + }), 112 112 + ); 98 113 99 99 - if (!identifier || !appPassword) { 100 100 - log.error("Handle and password are required"); 101 101 - process.exit(1); 102 102 - } 114 114 + if (!identifier || !appPassword) { 115 115 + log.error("Handle and password are required"); 116 116 + process.exit(1); 117 117 + } 103 118 104 104 - // Check if this identity already exists 105 105 - const existing = await getCredentials(identifier); 106 106 - if (existing) { 107 107 - const overwrite = exitOnCancel(await confirm({ 108 108 - message: `Credentials for ${identifier} already exist. Update?`, 109 109 - initialValue: false, 110 110 - })); 111 111 - if (!overwrite) { 112 112 - log.info("Keeping existing credentials"); 113 113 - return; 114 114 - } 115 115 - } 119 119 + // Check if this identity already exists 120 120 + const existing = await getCredentials(identifier); 121 121 + if (existing) { 122 122 + const overwrite = exitOnCancel( 123 123 + await confirm({ 124 124 + message: `Credentials for ${identifier} already exist. Update?`, 125 125 + initialValue: false, 126 126 + }), 127 127 + ); 128 128 + if (!overwrite) { 129 129 + log.info("Keeping existing credentials"); 130 130 + return; 131 131 + } 132 132 + } 116 133 117 117 - // Resolve PDS from handle 118 118 - const s = spinner(); 119 119 - s.start("Resolving PDS..."); 120 120 - let pdsUrl: string; 121 121 - try { 122 122 - pdsUrl = await resolveHandleToPDS(identifier); 123 123 - s.stop(`Found PDS: ${pdsUrl}`); 124 124 - } catch (error) { 125 125 - s.stop("Failed to resolve PDS"); 126 126 - log.error(`Failed to resolve PDS from handle: ${error}`); 127 127 - process.exit(1); 128 128 - } 134 134 + // Resolve PDS from handle 135 135 + const s = spinner(); 136 136 + s.start("Resolving PDS..."); 137 137 + let pdsUrl: string; 138 138 + try { 139 139 + pdsUrl = await resolveHandleToPDS(identifier); 140 140 + s.stop(`Found PDS: ${pdsUrl}`); 141 141 + } catch (error) { 142 142 + s.stop("Failed to resolve PDS"); 143 143 + log.error(`Failed to resolve PDS from handle: ${error}`); 144 144 + process.exit(1); 145 145 + } 129 146 130 130 - // Verify credentials 131 131 - s.start("Verifying credentials..."); 147 147 + // Verify credentials 148 148 + s.start("Verifying credentials..."); 132 149 133 133 - try { 134 134 - const agent = new AtpAgent({ service: pdsUrl }); 135 135 - await agent.login({ 136 136 - identifier: identifier, 137 137 - password: appPassword, 138 138 - }); 150 150 + try { 151 151 + const agent = new AtpAgent({ service: pdsUrl }); 152 152 + await agent.login({ 153 153 + identifier: identifier, 154 154 + password: appPassword, 155 155 + }); 139 156 140 140 - s.stop(`Logged in as ${agent.session?.handle}`); 157 157 + s.stop(`Logged in as ${agent.session?.handle}`); 141 158 142 142 - // Save credentials 143 143 - await saveCredentials({ 144 144 - pdsUrl, 145 145 - identifier: identifier, 146 146 - password: appPassword, 147 147 - }); 159 159 + // Save credentials 160 160 + await saveCredentials({ 161 161 + type: "app-password", 162 162 + pdsUrl, 163 163 + identifier: identifier, 164 164 + password: appPassword, 165 165 + }); 148 166 149 149 - log.success(`Credentials saved to ${getCredentialsPath()}`); 150 150 - } catch (error) { 151 151 - s.stop("Failed to login"); 152 152 - log.error(`Failed to login: ${error}`); 153 153 - process.exit(1); 154 154 - } 155 155 - }, 167 167 + log.success(`Credentials saved to ${getCredentialsPath()}`); 168 168 + } catch (error) { 169 169 + s.stop("Failed to login"); 170 170 + log.error(`Failed to login: ${error}`); 171 171 + process.exit(1); 172 172 + } 173 173 + }, 156 174 });

+76 -12

packages/cli/src/commands/init.ts

··· 1 1 - import * as fs from "fs/promises"; 1 1 + import * as fs from "node:fs/promises"; 2 2 import { command } from "cmd-ts"; 3 3 import { 4 4 intro, ··· 11 11 log, 12 12 group, 13 13 } from "@clack/prompts"; 14 14 - import * as path from "path"; 14 14 + import * as path from "node:path"; 15 15 import { findConfig, generateConfigTemplate } from "../lib/config"; 16 16 - import { loadCredentials } from "../lib/credentials"; 16 16 + import { loadCredentials, listAllCredentials } from "../lib/credentials"; 17 17 import { createAgent, createPublication } from "../lib/atproto"; 18 18 - import type { FrontmatterMapping } from "../lib/types"; 18 18 + import { selectCredential } from "../lib/credential-select"; 19 19 + import type { FrontmatterMapping, BlueskyConfig } from "../lib/types"; 19 20 20 21 async function fileExists(filePath: string): Promise<boolean> { 21 22 try { ··· 138 139 defaultValue: "tags", 139 140 placeholder: "tags, categories, keywords, etc.", 140 141 }), 142 142 + draftField: () => 143 143 + text({ 144 144 + message: "Field name for draft status:", 145 145 + defaultValue: "draft", 146 146 + placeholder: "draft, private, hidden, etc.", 147 147 + }), 141 148 }, 142 149 { onCancel }, 143 150 ); ··· 149 156 ["publishDate", frontmatterConfig.dateField, "publishDate"], 150 157 ["coverImage", frontmatterConfig.coverField, "ogImage"], 151 158 ["tags", frontmatterConfig.tagsField, "tags"], 159 159 + ["draft", frontmatterConfig.draftField, "draft"], 152 160 ]; 153 161 154 162 const builtMapping = fieldMappings.reduce<FrontmatterMapping>( ··· 179 187 } 180 188 181 189 let publicationUri: string; 182 182 - const credentials = await loadCredentials(); 190 190 + let credentials = await loadCredentials(); 183 191 184 192 if (publicationChoice === "create") { 185 193 // Need credentials to create a publication 186 194 if (!credentials) { 195 195 + // Check if there are multiple identities - if so, prompt to select 196 196 + const allCredentials = await listAllCredentials(); 197 197 + if (allCredentials.length > 1) { 198 198 + credentials = await selectCredential(allCredentials); 199 199 + } else if (allCredentials.length === 1) { 200 200 + // Single credential exists but couldn't be loaded - try to load it explicitly 201 201 + credentials = await selectCredential(allCredentials); 202 202 + } else { 203 203 + log.error( 204 204 + "You must authenticate first. Run 'sequoia login' (recommended) or 'sequoia auth' before creating a publication.", 205 205 + ); 206 206 + process.exit(1); 207 207 + } 208 208 + } 209 209 + 210 210 + if (!credentials) { 187 211 log.error( 188 188 - "You must authenticate first. Run 'sequoia auth' before creating a publication.", 212 212 + "Could not load credentials. Try running 'sequoia login' again to re-authenticate.", 189 213 ); 190 214 process.exit(1); 191 215 } 192 216 193 217 const s = spinner(); 194 218 s.start("Connecting to ATProto..."); 195 195 - let agent; 219 219 + let agent: Awaited<ReturnType<typeof createAgent>> | undefined; 196 220 try { 197 221 agent = await createAgent(credentials); 198 222 s.stop("Connected!"); 199 199 - } catch (error) { 223 223 + } catch (_error) { 200 224 s.stop("Failed to connect"); 201 225 log.error( 202 202 - "Failed to connect. Check your credentials with 'sequoia auth'.", 226 226 + "Failed to connect. Try re-authenticating with 'sequoia login' or 'sequoia auth'.", 203 227 ); 204 228 process.exit(1); 205 229 } ··· 263 287 publicationUri = uri as string; 264 288 } 265 289 266 266 - // Get PDS URL from credentials (already loaded earlier) 267 267 - const pdsUrl = credentials?.pdsUrl; 290 290 + // Bluesky posting configuration 291 291 + const enableBluesky = await confirm({ 292 292 + message: "Enable automatic Bluesky posting when publishing?", 293 293 + initialValue: false, 294 294 + }); 295 295 + 296 296 + if (enableBluesky === Symbol.for("cancel")) { 297 297 + onCancel(); 298 298 + } 299 299 + 300 300 + let blueskyConfig: BlueskyConfig | undefined; 301 301 + if (enableBluesky) { 302 302 + const maxAgeDaysInput = await text({ 303 303 + message: "Maximum age (in days) for posts to be shared on Bluesky:", 304 304 + defaultValue: "7", 305 305 + placeholder: "7", 306 306 + validate: (value) => { 307 307 + if (!value) { 308 308 + return "Please enter a number"; 309 309 + } 310 310 + const num = Number.parseInt(value, 10); 311 311 + if (Number.isNaN(num) || num < 1) { 312 312 + return "Please enter a positive number"; 313 313 + } 314 314 + }, 315 315 + }); 316 316 + 317 317 + if (maxAgeDaysInput === Symbol.for("cancel")) { 318 318 + onCancel(); 319 319 + } 320 320 + 321 321 + const maxAgeDays = parseInt(maxAgeDaysInput as string, 10); 322 322 + blueskyConfig = { 323 323 + enabled: true, 324 324 + ...(maxAgeDays !== 7 && { maxAgeDays }), 325 325 + }; 326 326 + } 327 327 + 328 328 + // Get PDS URL from credentials (only available for app-password auth) 329 329 + const pdsUrl = 330 330 + credentials?.type === "app-password" ? credentials.pdsUrl : undefined; 268 331 269 332 // Generate config file 270 333 const configContent = generateConfigTemplate({ ··· 277 340 publicationUri, 278 341 pdsUrl, 279 342 frontmatter: frontmatterMapping, 343 343 + bluesky: blueskyConfig, 280 344 }); 281 345 282 346 const configPath = path.join(process.cwd(), "sequoia.json"); ··· 308 372 if (!gitignoreContent.includes(stateFilename)) { 309 373 await fs.writeFile( 310 374 gitignorePath, 311 311 - gitignoreContent + `\n${stateFilename}\n`, 375 375 + `${gitignoreContent}\n${stateFilename}\n`, 312 376 ); 313 377 log.info(`Added ${stateFilename} to .gitignore`); 314 378 }

+32 -56

packages/cli/src/commands/inject.ts

··· 1 1 - import * as fs from "fs/promises"; 2 2 - import { command, flag, option, optional, string } from "cmd-ts"; 3 1 import { log } from "@clack/prompts"; 4 4 - import * as path from "path"; 2 2 + import { command, flag, option, optional, string } from "cmd-ts"; 5 3 import { glob } from "glob"; 6 6 - import { loadConfig, loadState, findConfig } from "../lib/config"; 4 4 + import * as fs from "node:fs/promises"; 5 5 + import * as path from "node:path"; 6 6 + import { findConfig, loadConfig, loadState } from "../lib/config"; 7 7 8 8 export const injectCommand = command({ 9 9 name: "inject", 10 10 - description: 11 11 - "Inject site.standard.document link tags into built HTML files", 10 10 + description: "Inject site.standard.document link tags into built HTML files", 12 11 args: { 13 12 outputDir: option({ 14 13 long: "output", ··· 44 43 // Load state to get atUri mappings 45 44 const state = await loadState(configDir); 46 45 47 47 - // Generic filenames where the slug is the parent directory, not the filename 48 48 - // Covers: SvelteKit (+page), Astro/Hugo (index), Next.js (page), etc. 49 49 - const genericFilenames = new Set([ 50 50 - "+page", 51 51 - "index", 52 52 - "_index", 53 53 - "page", 54 54 - "readme", 55 55 - ]); 56 56 - 57 57 - // Build a map of slug/path to atUri from state 58 58 - const pathToAtUri = new Map<string, string>(); 46 46 + // Build a map of slug to atUri from state 47 47 + // The slug is stored in state by the publish command, using the configured slug options 48 48 + const slugToAtUri = new Map<string, string>(); 59 49 for (const [filePath, postState] of Object.entries(state.posts)) { 60 60 - if (postState.atUri) { 61 61 - // Extract slug from file path (e.g., ./content/blog/my-post.md -> my-post) 62 62 - let basename = path.basename(filePath, path.extname(filePath)); 63 63 - 64 64 - // If the filename is a generic convention name, use the parent directory as slug 65 65 - if (genericFilenames.has(basename.toLowerCase())) { 66 66 - // Split path and filter out route groups like (blog-article) 67 67 - const pathParts = filePath 68 68 - .split(/[/\\]/) 69 69 - .filter((p) => p && !(p.startsWith("(") && p.endsWith(")"))); 70 70 - // The slug should be the second-to-last part (last is the filename) 71 71 - if (pathParts.length >= 2) { 72 72 - const slug = pathParts[pathParts.length - 2]; 73 73 - if (slug && slug !== "." && slug !== "content" && slug !== "routes" && slug !== "src") { 74 74 - basename = slug; 75 75 - } 76 76 - } 77 77 - } 78 78 - 79 79 - pathToAtUri.set(basename, postState.atUri); 50 50 + if (postState.atUri && postState.slug) { 51 51 + // Use the slug stored in state (computed by publish with config options) 52 52 + slugToAtUri.set(postState.slug, postState.atUri); 80 53 81 81 - // Also add variations that might match HTML file paths 82 82 - // e.g., /blog/my-post, /posts/my-post, my-post/index 83 83 - const dirName = path.basename(path.dirname(filePath)); 84 84 - // Skip route groups and common directory names 85 85 - if (dirName !== "." && dirName !== "content" && !(dirName.startsWith("(") && dirName.endsWith(")"))) { 86 86 - pathToAtUri.set(`${dirName}/${basename}`, postState.atUri); 54 54 + // Also add the last segment for simpler matching 55 55 + // e.g., "other/my-other-post" -> also map "my-other-post" 56 56 + const lastSegment = postState.slug.split("/").pop(); 57 57 + if (lastSegment && lastSegment !== postState.slug) { 58 58 + slugToAtUri.set(lastSegment, postState.atUri); 87 59 } 60 60 + } else if (postState.atUri) { 61 61 + // Fallback for older state files without slug field 62 62 + // Extract slug from file path (e.g., ./content/blog/my-post.md -> my-post) 63 63 + const basename = path.basename(filePath, path.extname(filePath)); 64 64 + slugToAtUri.set(basename.toLowerCase(), postState.atUri); 88 65 } 89 66 } 90 67 91 91 - if (pathToAtUri.size === 0) { 68 68 + if (slugToAtUri.size === 0) { 92 69 log.warn( 93 70 "No published posts found in state. Run 'sequoia publish' first.", 94 71 ); 95 72 return; 96 73 } 97 74 98 98 - log.info(`Found ${pathToAtUri.size} published posts in state`); 75 75 + log.info(`Found ${slugToAtUri.size} slug mappings from published posts`); 99 76 100 77 // Scan for HTML files 101 78 const htmlFiles = await glob("**/*.html", { ··· 125 102 let atUri: string | undefined; 126 103 127 104 // Strategy 1: Direct basename match (e.g., my-post.html -> my-post) 128 128 - atUri = pathToAtUri.get(htmlBasename); 105 105 + atUri = slugToAtUri.get(htmlBasename); 129 106 130 130 - // Strategy 2: Directory name for index.html (e.g., my-post/index.html -> my-post) 107 107 + // Strategy 2: For index.html, try the directory path 108 108 + // e.g., posts/40th-puzzle-box/what-a-gift/index.html -> 40th-puzzle-box/what-a-gift 131 109 if (!atUri && htmlBasename === "index" && htmlDir !== ".") { 132 132 - const slug = path.basename(htmlDir); 133 133 - atUri = pathToAtUri.get(slug); 110 110 + // Try full directory path (for nested subdirectories) 111 111 + atUri = slugToAtUri.get(htmlDir); 134 112 135 135 - // Also try parent/slug pattern 113 113 + // Also try just the last directory segment 136 114 if (!atUri) { 137 137 - const parentDir = path.dirname(htmlDir); 138 138 - if (parentDir !== ".") { 139 139 - atUri = pathToAtUri.get(`${path.basename(parentDir)}/${slug}`); 140 140 - } 115 115 + const lastDir = path.basename(htmlDir); 116 116 + atUri = slugToAtUri.get(lastDir); 141 117 } 142 118 } 143 119 144 120 // Strategy 3: Full path match (e.g., blog/my-post.html -> blog/my-post) 145 121 if (!atUri && htmlDir !== ".") { 146 146 - atUri = pathToAtUri.get(`${htmlDir}/${htmlBasename}`); 122 122 + atUri = slugToAtUri.get(`${htmlDir}/${htmlBasename}`); 147 123 } 148 124 149 125 if (!atUri) {

+305

packages/cli/src/commands/login.ts

··· 1 1 + import * as http from "node:http"; 2 2 + import { log, note, select, spinner, text } from "@clack/prompts"; 3 3 + import { command, flag, option, optional, string } from "cmd-ts"; 4 4 + import { resolveHandleToDid } from "../lib/atproto"; 5 5 + import { 6 6 + getCallbackPort, 7 7 + getOAuthClient, 8 8 + getOAuthScope, 9 9 + } from "../lib/oauth-client"; 10 10 + import { 11 11 + deleteOAuthSession, 12 12 + getOAuthStorePath, 13 13 + listOAuthSessions, 14 14 + listOAuthSessionsWithHandles, 15 15 + setOAuthHandle, 16 16 + } from "../lib/oauth-store"; 17 17 + import { exitOnCancel } from "../lib/prompts"; 18 18 + 19 19 + const CALLBACK_TIMEOUT_MS = 5 * 60 * 1000; // 5 minutes 20 20 + 21 21 + export const loginCommand = command({ 22 22 + name: "login", 23 23 + description: "Login with OAuth (browser-based authentication)", 24 24 + args: { 25 25 + logout: option({ 26 26 + long: "logout", 27 27 + description: "Remove OAuth session for a specific DID", 28 28 + type: optional(string), 29 29 + }), 30 30 + list: flag({ 31 31 + long: "list", 32 32 + description: "List all stored OAuth sessions", 33 33 + }), 34 34 + }, 35 35 + handler: async ({ logout, list }) => { 36 36 + // List sessions 37 37 + if (list) { 38 38 + const sessions = await listOAuthSessionsWithHandles(); 39 39 + if (sessions.length === 0) { 40 40 + log.info("No OAuth sessions stored"); 41 41 + } else { 42 42 + log.info("OAuth sessions:"); 43 43 + for (const { did, handle } of sessions) { 44 44 + console.log(` - ${handle || did} (${did})`); 45 45 + } 46 46 + } 47 47 + return; 48 48 + } 49 49 + 50 50 + // Logout 51 51 + if (logout !== undefined) { 52 52 + const did = logout || undefined; 53 53 + 54 54 + if (!did) { 55 55 + // No DID provided - show available and prompt 56 56 + const sessions = await listOAuthSessions(); 57 57 + if (sessions.length === 0) { 58 58 + log.info("No OAuth sessions found"); 59 59 + return; 60 60 + } 61 61 + if (sessions.length === 1) { 62 62 + const deleted = await deleteOAuthSession(sessions[0]!); 63 63 + if (deleted) { 64 64 + log.success(`Removed OAuth session for ${sessions[0]}`); 65 65 + } 66 66 + return; 67 67 + } 68 68 + // Multiple sessions - prompt 69 69 + const selected = exitOnCancel( 70 70 + await select({ 71 71 + message: "Select session to remove:", 72 72 + options: sessions.map((d) => ({ value: d, label: d })), 73 73 + }), 74 74 + ); 75 75 + const deleted = await deleteOAuthSession(selected); 76 76 + if (deleted) { 77 77 + log.success(`Removed OAuth session for ${selected}`); 78 78 + } 79 79 + return; 80 80 + } 81 81 + 82 82 + const deleted = await deleteOAuthSession(did); 83 83 + if (deleted) { 84 84 + log.success(`Removed OAuth session for ${did}`); 85 85 + } else { 86 86 + log.info(`No OAuth session found for ${did}`); 87 87 + } 88 88 + return; 89 89 + } 90 90 + 91 91 + // OAuth login flow 92 92 + note( 93 93 + "OAuth login will open your browser to authenticate.\n\n" + 94 94 + "This is more secure than app passwords and tokens refresh automatically.", 95 95 + "OAuth Login", 96 96 + ); 97 97 + 98 98 + const handle = exitOnCancel( 99 99 + await text({ 100 100 + message: "Handle or DID:", 101 101 + placeholder: "yourhandle.bsky.social", 102 102 + }), 103 103 + ); 104 104 + 105 105 + if (!handle) { 106 106 + log.error("Handle is required"); 107 107 + process.exit(1); 108 108 + } 109 109 + 110 110 + const s = spinner(); 111 111 + s.start("Resolving identity..."); 112 112 + 113 113 + let did: string; 114 114 + try { 115 115 + did = await resolveHandleToDid(handle); 116 116 + s.stop(`Identity resolved`); 117 117 + } catch (error) { 118 118 + s.stop("Failed to resolve identity"); 119 119 + if (error instanceof Error) { 120 120 + log.error(`Error: ${error.message}`); 121 121 + } else { 122 122 + log.error(`Error: ${error}`); 123 123 + } 124 124 + process.exit(1); 125 125 + } 126 126 + 127 127 + s.start("Initializing OAuth..."); 128 128 + 129 129 + try { 130 130 + const client = await getOAuthClient(); 131 131 + 132 132 + // Generate authorization URL using the resolved DID 133 133 + const authUrl = await client.authorize(did, { 134 134 + scope: getOAuthScope(), 135 135 + }); 136 136 + 137 137 + log.info(`Login URL: ${authUrl}`); 138 138 + 139 139 + s.message("Opening browser..."); 140 140 + 141 141 + // Try to open browser 142 142 + let browserOpened = true; 143 143 + try { 144 144 + const open = (await import("open")).default; 145 145 + await open(authUrl.toString()); 146 146 + } catch { 147 147 + browserOpened = false; 148 148 + } 149 149 + 150 150 + s.message("Waiting for authentication..."); 151 151 + 152 152 + // Show URL info 153 153 + if (!browserOpened) { 154 154 + s.stop("Could not open browser automatically"); 155 155 + log.warn("Please open the following URL in your browser:"); 156 156 + log.info(authUrl.toString()); 157 157 + s.start("Waiting for authentication..."); 158 158 + } 159 159 + 160 160 + // Start HTTP server to receive callback 161 161 + const result = await waitForCallback(); 162 162 + 163 163 + if (!result.success) { 164 164 + s.stop("Authentication failed"); 165 165 + log.error(result.error || "OAuth callback failed"); 166 166 + process.exit(1); 167 167 + } 168 168 + 169 169 + s.message("Completing authentication..."); 170 170 + 171 171 + // Exchange code for tokens 172 172 + const { session } = await client.callback( 173 173 + new URLSearchParams(result.params!), 174 174 + ); 175 175 + 176 176 + // Store the handle for friendly display 177 177 + // Use the original handle input (unless it was a DID) 178 178 + const handleToStore = handle.startsWith("did:") ? undefined : handle; 179 179 + if (handleToStore) { 180 180 + await setOAuthHandle(session.did, handleToStore); 181 181 + } 182 182 + 183 183 + // Try to get the handle for display (use the original handle input as fallback) 184 184 + const displayName = handleToStore || session.did; 185 185 + 186 186 + s.stop(`Logged in as ${displayName}`); 187 187 + 188 188 + log.success(`OAuth session saved to ${getOAuthStorePath()}`); 189 189 + log.info("Your session will refresh automatically when needed."); 190 190 + 191 191 + // Exit cleanly - the OAuth client may have background processes 192 192 + process.exit(0); 193 193 + } catch (error) { 194 194 + s.stop("OAuth login failed"); 195 195 + if (error instanceof Error) { 196 196 + log.error(`Error: ${error.message}`); 197 197 + } else { 198 198 + log.error(`Error: ${error}`); 199 199 + } 200 200 + process.exit(1); 201 201 + } 202 202 + }, 203 203 + }); 204 204 + 205 205 + interface CallbackResult { 206 206 + success: boolean; 207 207 + params?: Record<string, string>; 208 208 + error?: string; 209 209 + } 210 210 + 211 211 + function waitForCallback(): Promise<CallbackResult> { 212 212 + return new Promise((resolve) => { 213 213 + const port = getCallbackPort(); 214 214 + let timeoutId: ReturnType<typeof setTimeout> | undefined; 215 215 + 216 216 + const server = http.createServer((req, res) => { 217 217 + const url = new URL(req.url || "/", `http://127.0.0.1:${port}`); 218 218 + 219 219 + if (url.pathname === "/oauth/callback") { 220 220 + const params: Record<string, string> = {}; 221 221 + url.searchParams.forEach((value, key) => { 222 222 + params[key] = value; 223 223 + }); 224 224 + 225 225 + // Clear the timeout 226 226 + if (timeoutId) clearTimeout(timeoutId); 227 227 + 228 228 + // Check for error 229 229 + if (params.error) { 230 230 + res.writeHead(200, { "Content-Type": "text/html" }); 231 231 + res.end(` 232 232 + <html> 233 233 + <head> 234 234 + <link href="https://fonts.googleapis.com/css2?family=Josefin+Sans:wght@400;700&display=swap" rel="stylesheet"> 235 235 + </head> 236 236 + <body style="background: #1A1A1A; color: #F5F3EF; font-family: 'Josefin Sans', system-ui; padding: 2rem; text-align: center; display: flex; flex-direction: column; justify-content: center; align-items: center; min-height: 100vh; margin: 0;"> 237 237 + <img src="https://sequoia.pub/icon-dark.png" alt="sequoia icon" style="width: 100px; height: 100px;" /> 238 238 + <h1 style="font-weight: 400;">Authentication Failed</h1> 239 239 + <p>${params.error_description || params.error}</p> 240 240 + <p>You can close this window.</p> 241 241 + </body> 242 242 + </html> 243 243 + `); 244 244 + server.close(() => { 245 245 + resolve({ 246 246 + success: false, 247 247 + error: params.error_description || params.error, 248 248 + }); 249 249 + }); 250 250 + return; 251 251 + } 252 252 + 253 253 + // Success 254 254 + res.writeHead(200, { "Content-Type": "text/html" }); 255 255 + res.end(` 256 256 + <html> 257 257 + <head> 258 258 + <link href="https://fonts.googleapis.com/css2?family=Josefin+Sans:wght@400;700&display=swap" rel="stylesheet"> 259 259 + </head> 260 260 + <body style="background: #1A1A1A; color: #F5F3EF; font-family: 'Josefin Sans', system-ui; padding: 2rem; text-align: center; display: flex; flex-direction: column; justify-content: center; align-items: center; min-height: 100vh; margin: 0;"> 261 261 + <img src="https://sequoia.pub/icon-dark.png" alt="sequoia icon" style="width: 100px; height: 100px;" /> 262 262 + <h1 style="font-weight: 400;">Authentication Successful</h1> 263 263 + <p>You can close this window and return to the terminal.</p> 264 264 + </body> 265 265 + </html> 266 266 + `); 267 267 + server.close(() => { 268 268 + resolve({ success: true, params }); 269 269 + }); 270 270 + return; 271 271 + } 272 272 + 273 273 + // Not the callback path 274 274 + res.writeHead(404); 275 275 + res.end("Not found"); 276 276 + }); 277 277 + 278 278 + server.on("error", (err: NodeJS.ErrnoException) => { 279 279 + if (timeoutId) clearTimeout(timeoutId); 280 280 + if (err.code === "EADDRINUSE") { 281 281 + resolve({ 282 282 + success: false, 283 283 + error: `Port ${port} is already in use. Please close the application using that port and try again.`, 284 284 + }); 285 285 + } else { 286 286 + resolve({ 287 287 + success: false, 288 288 + error: `Server error: ${err.message}`, 289 289 + }); 290 290 + } 291 291 + }); 292 292 + 293 293 + server.listen(port, "127.0.0.1"); 294 294 + 295 295 + // Timeout after 5 minutes 296 296 + timeoutId = setTimeout(() => { 297 297 + server.close(() => { 298 298 + resolve({ 299 299 + success: false, 300 300 + error: "Timeout waiting for OAuth callback. Please try again.", 301 301 + }); 302 302 + }); 303 303 + }, CALLBACK_TIMEOUT_MS); 304 304 + }); 305 305 + }

+359 -199

packages/cli/src/commands/publish.ts

··· 1 1 - import * as fs from "fs/promises"; 1 1 + import * as fs from "node:fs/promises"; 2 2 import { command, flag } from "cmd-ts"; 3 3 import { select, spinner, log } from "@clack/prompts"; 4 4 - import * as path from "path"; 4 4 + import * as path from "node:path"; 5 5 import { loadConfig, loadState, saveState, findConfig } from "../lib/config"; 6 6 - import { loadCredentials, listCredentials, getCredentials } from "../lib/credentials"; 7 7 - import { createAgent, createDocument, updateDocument, uploadImage, resolveImagePath } from "../lib/atproto"; 6 6 + import { 7 7 + loadCredentials, 8 8 + listAllCredentials, 9 9 + getCredentials, 10 10 + } from "../lib/credentials"; 11 11 + import { getOAuthHandle, getOAuthSession } from "../lib/oauth-store"; 12 12 + import { 13 13 + createAgent, 14 14 + createDocument, 15 15 + updateDocument, 16 16 + uploadImage, 17 17 + resolveImagePath, 18 18 + createBlueskyPost, 19 19 + addBskyPostRefToDocument, 20 20 + } from "../lib/atproto"; 8 21 import { 9 9 - scanContentDirectory, 10 10 - getContentHash, 11 11 - updateFrontmatterWithAtUri, 22 22 + scanContentDirectory, 23 23 + getContentHash, 24 24 + updateFrontmatterWithAtUri, 12 25 } from "../lib/markdown"; 13 13 - import type { BlogPost, BlobObject } from "../lib/types"; 26 26 + import type { BlogPost, BlobObject, StrongRef } from "../lib/types"; 14 27 import { exitOnCancel } from "../lib/prompts"; 15 28 16 29 export const publishCommand = command({ 17 17 - name: "publish", 18 18 - description: "Publish content to ATProto", 19 19 - args: { 20 20 - force: flag({ 21 21 - long: "force", 22 22 - short: "f", 23 23 - description: "Force publish all posts, ignoring change detection", 24 24 - }), 25 25 - dryRun: flag({ 26 26 - long: "dry-run", 27 27 - short: "n", 28 28 - description: "Preview what would be published without making changes", 29 29 - }), 30 30 - }, 31 31 - handler: async ({ force, dryRun }) => { 32 32 - // Load config 33 33 - const configPath = await findConfig(); 34 34 - if (!configPath) { 35 35 - log.error("No publisher.config.ts found. Run 'publisher init' first."); 36 36 - process.exit(1); 37 37 - } 30 30 + name: "publish", 31 31 + description: "Publish content to ATProto", 32 32 + args: { 33 33 + force: flag({ 34 34 + long: "force", 35 35 + short: "f", 36 36 + description: "Force publish all posts, ignoring change detection", 37 37 + }), 38 38 + dryRun: flag({ 39 39 + long: "dry-run", 40 40 + short: "n", 41 41 + description: "Preview what would be published without making changes", 42 42 + }), 43 43 + }, 44 44 + handler: async ({ force, dryRun }) => { 45 45 + // Load config 46 46 + const configPath = await findConfig(); 47 47 + if (!configPath) { 48 48 + log.error("No publisher.config.ts found. Run 'publisher init' first."); 49 49 + process.exit(1); 50 50 + } 38 51 39 39 - const config = await loadConfig(configPath); 40 40 - const configDir = path.dirname(configPath); 52 52 + const config = await loadConfig(configPath); 53 53 + const configDir = path.dirname(configPath); 41 54 42 42 - log.info(`Site: ${config.siteUrl}`); 43 43 - log.info(`Content directory: ${config.contentDir}`); 55 55 + log.info(`Site: ${config.siteUrl}`); 56 56 + log.info(`Content directory: ${config.contentDir}`); 44 57 45 45 - // Load credentials 46 46 - let credentials = await loadCredentials(config.identity); 58 58 + // Load credentials 59 59 + let credentials = await loadCredentials(config.identity); 47 60 48 48 - // If no credentials resolved, check if we need to prompt for identity selection 49 49 - if (!credentials) { 50 50 - const identities = await listCredentials(); 51 51 - if (identities.length === 0) { 52 52 - log.error("No credentials found. Run 'sequoia auth' first."); 53 53 - log.info("Or set ATP_IDENTIFIER and ATP_APP_PASSWORD environment variables."); 54 54 - process.exit(1); 55 55 - } 61 61 + // If no credentials resolved, check if we need to prompt for identity selection 62 62 + if (!credentials) { 63 63 + const identities = await listAllCredentials(); 64 64 + if (identities.length === 0) { 65 65 + log.error( 66 66 + "No credentials found. Run 'sequoia login' or 'sequoia auth' first.", 67 67 + ); 68 68 + log.info( 69 69 + "Or set ATP_IDENTIFIER and ATP_APP_PASSWORD environment variables.", 70 70 + ); 71 71 + process.exit(1); 72 72 + } 56 73 57 57 - // Multiple identities exist but none selected - prompt user 58 58 - log.info("Multiple identities found. Select one to use:"); 59 59 - const selected = exitOnCancel(await select({ 60 60 - message: "Identity:", 61 61 - options: identities.map(id => ({ value: id, label: id })), 62 62 - })); 74 74 + // Build labels with handles for OAuth sessions 75 75 + const options = await Promise.all( 76 76 + identities.map(async (cred) => { 77 77 + if (cred.type === "oauth") { 78 78 + const handle = await getOAuthHandle(cred.id); 79 79 + return { 80 80 + value: cred.id, 81 81 + label: `${handle || cred.id} (OAuth)`, 82 82 + }; 83 83 + } 84 84 + return { 85 85 + value: cred.id, 86 86 + label: `${cred.id} (App Password)`, 87 87 + }; 88 88 + }), 89 89 + ); 63 90 64 64 - credentials = await getCredentials(selected); 65 65 - if (!credentials) { 66 66 - log.error("Failed to load selected credentials."); 67 67 - process.exit(1); 68 68 - } 91 91 + // Multiple identities exist but none selected - prompt user 92 92 + log.info("Multiple identities found. Select one to use:"); 93 93 + const selected = exitOnCancel( 94 94 + await select({ 95 95 + message: "Identity:", 96 96 + options, 97 97 + }), 98 98 + ); 69 99 70 70 - log.info(`Tip: Add "identity": "${selected}" to sequoia.json to use this by default.`); 71 71 - } 100 100 + // Load the selected credentials 101 101 + const selectedCred = identities.find((c) => c.id === selected); 102 102 + if (selectedCred?.type === "oauth") { 103 103 + const session = await getOAuthSession(selected); 104 104 + if (session) { 105 105 + const handle = await getOAuthHandle(selected); 106 106 + credentials = { 107 107 + type: "oauth", 108 108 + did: selected, 109 109 + handle: handle || selected, 110 110 + }; 111 111 + } 112 112 + } else { 113 113 + credentials = await getCredentials(selected); 114 114 + } 72 115 73 73 - // Resolve content directory 74 74 - const contentDir = path.isAbsolute(config.contentDir) 75 75 - ? config.contentDir 76 76 - : path.join(configDir, config.contentDir); 116 116 + if (!credentials) { 117 117 + log.error("Failed to load selected credentials."); 118 118 + process.exit(1); 119 119 + } 77 120 78 78 - const imagesDir = config.imagesDir 79 79 - ? path.isAbsolute(config.imagesDir) 80 80 - ? config.imagesDir 81 81 - : path.join(configDir, config.imagesDir) 82 82 - : undefined; 121 121 + const displayId = 122 122 + credentials.type === "oauth" 123 123 + ? credentials.handle || credentials.did 124 124 + : credentials.identifier; 125 125 + log.info( 126 126 + `Tip: Add "identity": "${displayId}" to sequoia.json to use this by default.`, 127 127 + ); 128 128 + } 83 129 84 84 - // Load state 85 85 - const state = await loadState(configDir); 130 130 + // Resolve content directory 131 131 + const contentDir = path.isAbsolute(config.contentDir) 132 132 + ? config.contentDir 133 133 + : path.join(configDir, config.contentDir); 86 134 87 87 - // Scan for posts 88 88 - const s = spinner(); 89 89 - s.start("Scanning for posts..."); 90 90 - const posts = await scanContentDirectory(contentDir, config.frontmatter, config.ignore); 91 91 - s.stop(`Found ${posts.length} posts`); 135 135 + const imagesDir = config.imagesDir 136 136 + ? path.isAbsolute(config.imagesDir) 137 137 + ? config.imagesDir 138 138 + : path.join(configDir, config.imagesDir) 139 139 + : undefined; 92 140 93 93 - // Determine which posts need publishing 94 94 - const postsToPublish: Array<{ 95 95 - post: BlogPost; 96 96 - action: "create" | "update"; 97 97 - reason: string; 98 98 - }> = []; 141 141 + // Load state 142 142 + const state = await loadState(configDir); 99 143 100 100 - for (const post of posts) { 101 101 - const contentHash = await getContentHash(post.rawContent); 102 102 - const relativeFilePath = path.relative(configDir, post.filePath); 103 103 - const postState = state.posts[relativeFilePath]; 144 144 + // Scan for posts 145 145 + const s = spinner(); 146 146 + s.start("Scanning for posts..."); 147 147 + const posts = await scanContentDirectory(contentDir, { 148 148 + frontmatterMapping: config.frontmatter, 149 149 + ignorePatterns: config.ignore, 150 150 + slugField: config.frontmatter?.slugField, 151 151 + removeIndexFromSlug: config.removeIndexFromSlug, 152 152 + stripDatePrefix: config.stripDatePrefix, 153 153 + }); 154 154 + s.stop(`Found ${posts.length} posts`); 104 155 105 105 - if (force) { 106 106 - postsToPublish.push({ 107 107 - post, 108 108 - action: post.frontmatter.atUri ? "update" : "create", 109 109 - reason: "forced", 110 110 - }); 111 111 - } else if (!postState) { 112 112 - // New post 113 113 - postsToPublish.push({ 114 114 - post, 115 115 - action: "create", 116 116 - reason: "new post", 117 117 - }); 118 118 - } else if (postState.contentHash !== contentHash) { 119 119 - // Changed post 120 120 - postsToPublish.push({ 121 121 - post, 122 122 - action: post.frontmatter.atUri ? "update" : "create", 123 123 - reason: "content changed", 124 124 - }); 125 125 - } 126 126 - } 156 156 + // Determine which posts need publishing 157 157 + const postsToPublish: Array<{ 158 158 + post: BlogPost; 159 159 + action: "create" | "update"; 160 160 + reason: string; 161 161 + }> = []; 162 162 + const draftPosts: BlogPost[] = []; 127 163 128 128 - if (postsToPublish.length === 0) { 129 129 - log.success("All posts are up to date. Nothing to publish."); 130 130 - return; 131 131 - } 164 164 + for (const post of posts) { 165 165 + // Skip draft posts 166 166 + if (post.frontmatter.draft) { 167 167 + draftPosts.push(post); 168 168 + continue; 169 169 + } 132 170 133 133 - log.info(`\n${postsToPublish.length} posts to publish:\n`); 134 134 - for (const { post, action, reason } of postsToPublish) { 135 135 - const icon = action === "create" ? "+" : "~"; 136 136 - log.message(` ${icon} ${post.frontmatter.title} (${reason})`); 137 137 - } 171 171 + const contentHash = await getContentHash(post.rawContent); 172 172 + const relativeFilePath = path.relative(configDir, post.filePath); 173 173 + const postState = state.posts[relativeFilePath]; 138 174 139 139 - if (dryRun) { 140 140 - log.info("\nDry run complete. No changes made."); 141 141 - return; 142 142 - } 175 175 + if (force) { 176 176 + postsToPublish.push({ 177 177 + post, 178 178 + action: post.frontmatter.atUri ? "update" : "create", 179 179 + reason: "forced", 180 180 + }); 181 181 + } else if (!postState) { 182 182 + // New post 183 183 + postsToPublish.push({ 184 184 + post, 185 185 + action: "create", 186 186 + reason: "new post", 187 187 + }); 188 188 + } else if (postState.contentHash !== contentHash) { 189 189 + // Changed post 190 190 + postsToPublish.push({ 191 191 + post, 192 192 + action: post.frontmatter.atUri ? "update" : "create", 193 193 + reason: "content changed", 194 194 + }); 195 195 + } 196 196 + } 143 197 144 144 - // Create agent 145 145 - s.start(`Connecting to ${credentials.pdsUrl}...`); 146 146 - let agent; 147 147 - try { 148 148 - agent = await createAgent(credentials); 149 149 - s.stop(`Logged in as ${agent.session?.handle}`); 150 150 - } catch (error) { 151 151 - s.stop("Failed to login"); 152 152 - log.error(`Failed to login: ${error}`); 153 153 - process.exit(1); 154 154 - } 198 198 + if (draftPosts.length > 0) { 199 199 + log.info( 200 200 + `Skipping ${draftPosts.length} draft post${draftPosts.length === 1 ? "" : "s"}`, 201 201 + ); 202 202 + } 155 203 156 156 - // Publish posts 157 157 - let publishedCount = 0; 158 158 - let updatedCount = 0; 159 159 - let errorCount = 0; 204 204 + if (postsToPublish.length === 0) { 205 205 + log.success("All posts are up to date. Nothing to publish."); 206 206 + return; 207 207 + } 160 208 161 161 - for (const { post, action } of postsToPublish) { 162 162 - s.start(`Publishing: ${post.frontmatter.title}`); 209 209 + log.info(`\n${postsToPublish.length} posts to publish:\n`); 163 210 164 164 - try { 165 165 - // Handle cover image upload 166 166 - let coverImage: BlobObject | undefined; 167 167 - if (post.frontmatter.ogImage) { 168 168 - const imagePath = await resolveImagePath( 169 169 - post.frontmatter.ogImage, 170 170 - imagesDir, 171 171 - contentDir 172 172 - ); 211 211 + // Bluesky posting configuration 212 212 + const blueskyEnabled = config.bluesky?.enabled ?? false; 213 213 + const maxAgeDays = config.bluesky?.maxAgeDays ?? 7; 214 214 + const cutoffDate = new Date(); 215 215 + cutoffDate.setDate(cutoffDate.getDate() - maxAgeDays); 216 216 + 217 217 + for (const { post, action, reason } of postsToPublish) { 218 218 + const icon = action === "create" ? "+" : "~"; 219 219 + const relativeFilePath = path.relative(configDir, post.filePath); 220 220 + const existingBskyPostRef = state.posts[relativeFilePath]?.bskyPostRef; 221 221 + 222 222 + let bskyNote = ""; 223 223 + if (blueskyEnabled) { 224 224 + if (existingBskyPostRef) { 225 225 + bskyNote = " [bsky: exists]"; 226 226 + } else { 227 227 + const publishDate = new Date(post.frontmatter.publishDate); 228 228 + if (publishDate < cutoffDate) { 229 229 + bskyNote = ` [bsky: skipped, older than ${maxAgeDays} days]`; 230 230 + } else { 231 231 + bskyNote = " [bsky: will post]"; 232 232 + } 233 233 + } 234 234 + } 235 235 + 236 236 + log.message(` ${icon} ${post.frontmatter.title} (${reason})${bskyNote}`); 237 237 + } 238 238 + 239 239 + if (dryRun) { 240 240 + if (blueskyEnabled) { 241 241 + log.info(`\nBluesky posting: enabled (max age: ${maxAgeDays} days)`); 242 242 + } 243 243 + log.info("\nDry run complete. No changes made."); 244 244 + return; 245 245 + } 246 246 + 247 247 + // Create agent 248 248 + const connectingTo = 249 249 + credentials.type === "oauth" ? credentials.handle : credentials.pdsUrl; 250 250 + s.start(`Connecting as ${connectingTo}...`); 251 251 + let agent: Awaited<ReturnType<typeof createAgent>> | undefined; 252 252 + try { 253 253 + agent = await createAgent(credentials); 254 254 + s.stop(`Logged in as ${agent.did}`); 255 255 + } catch (error) { 256 256 + s.stop("Failed to login"); 257 257 + log.error(`Failed to login: ${error}`); 258 258 + process.exit(1); 259 259 + } 260 260 + 261 261 + // Publish posts 262 262 + let publishedCount = 0; 263 263 + let updatedCount = 0; 264 264 + let errorCount = 0; 265 265 + let bskyPostCount = 0; 266 266 + 267 267 + for (const { post, action } of postsToPublish) { 268 268 + s.start(`Publishing: ${post.frontmatter.title}`); 269 269 + 270 270 + try { 271 271 + // Handle cover image upload 272 272 + let coverImage: BlobObject | undefined; 273 273 + if (post.frontmatter.ogImage) { 274 274 + const imagePath = await resolveImagePath( 275 275 + post.frontmatter.ogImage, 276 276 + imagesDir, 277 277 + contentDir, 278 278 + ); 279 279 + 280 280 + if (imagePath) { 281 281 + log.info(` Uploading cover image: ${path.basename(imagePath)}`); 282 282 + coverImage = await uploadImage(agent, imagePath); 283 283 + if (coverImage) { 284 284 + log.info(` Uploaded image blob: ${coverImage.ref.$link}`); 285 285 + } 286 286 + } else { 287 287 + log.warn(` Cover image not found: ${post.frontmatter.ogImage}`); 288 288 + } 289 289 + } 290 290 + 291 291 + // Track atUri, content for state saving, and bskyPostRef 292 292 + let atUri: string; 293 293 + let contentForHash: string; 294 294 + let bskyPostRef: StrongRef | undefined; 295 295 + const relativeFilePath = path.relative(configDir, post.filePath); 296 296 + 297 297 + // Check if bskyPostRef already exists in state 298 298 + const existingBskyPostRef = state.posts[relativeFilePath]?.bskyPostRef; 299 299 + 300 300 + if (action === "create") { 301 301 + atUri = await createDocument(agent, post, config, coverImage); 302 302 + s.stop(`Created: ${atUri}`); 303 303 + 304 304 + // Update frontmatter with atUri 305 305 + const updatedContent = updateFrontmatterWithAtUri( 306 306 + post.rawContent, 307 307 + atUri, 308 308 + ); 309 309 + await fs.writeFile(post.filePath, updatedContent); 310 310 + log.info(` Updated frontmatter in ${path.basename(post.filePath)}`); 173 311 174 174 - if (imagePath) { 175 175 - log.info(` Uploading cover image: ${path.basename(imagePath)}`); 176 176 - coverImage = await uploadImage(agent, imagePath); 177 177 - if (coverImage) { 178 178 - log.info(` Uploaded image blob: ${coverImage.ref.$link}`); 179 179 - } 180 180 - } else { 181 181 - log.warn(` Cover image not found: ${post.frontmatter.ogImage}`); 182 182 - } 183 183 - } 312 312 + // Use updated content (with atUri) for hash so next run sees matching hash 313 313 + contentForHash = updatedContent; 314 314 + publishedCount++; 315 315 + } else { 316 316 + atUri = post.frontmatter.atUri!; 317 317 + await updateDocument(agent, post, atUri, config, coverImage); 318 318 + s.stop(`Updated: ${atUri}`); 184 319 185 185 - // Track atUri and content for state saving 186 186 - let atUri: string; 187 187 - let contentForHash: string; 320 320 + // For updates, rawContent already has atUri 321 321 + contentForHash = post.rawContent; 322 322 + updatedCount++; 323 323 + } 188 324 189 189 - if (action === "create") { 190 190 - atUri = await createDocument(agent, post, config, coverImage); 191 191 - s.stop(`Created: ${atUri}`); 325 325 + // Create Bluesky post if enabled and conditions are met 326 326 + if (blueskyEnabled) { 327 327 + if (existingBskyPostRef) { 328 328 + log.info(` Bluesky post already exists, skipping`); 329 329 + bskyPostRef = existingBskyPostRef; 330 330 + } else { 331 331 + const publishDate = new Date(post.frontmatter.publishDate); 192 332 193 193 - // Update frontmatter with atUri 194 194 - const updatedContent = updateFrontmatterWithAtUri(post.rawContent, atUri); 195 195 - await fs.writeFile(post.filePath, updatedContent); 196 196 - log.info(` Updated frontmatter in ${path.basename(post.filePath)}`); 333 333 + if (publishDate < cutoffDate) { 334 334 + log.info( 335 335 + ` Post is older than ${maxAgeDays} days, skipping Bluesky post`, 336 336 + ); 337 337 + } else { 338 338 + // Create Bluesky post 339 339 + try { 340 340 + const pathPrefix = config.pathPrefix || "/posts"; 341 341 + const canonicalUrl = `${config.siteUrl}${pathPrefix}/${post.slug}`; 197 342 198 198 - // Use updated content (with atUri) for hash so next run sees matching hash 199 199 - contentForHash = updatedContent; 200 200 - publishedCount++; 201 201 - } else { 202 202 - atUri = post.frontmatter.atUri!; 203 203 - await updateDocument(agent, post, atUri, config, coverImage); 204 204 - s.stop(`Updated: ${atUri}`); 343 343 + bskyPostRef = await createBlueskyPost(agent, { 344 344 + title: post.frontmatter.title, 345 345 + description: post.frontmatter.description, 346 346 + canonicalUrl, 347 347 + coverImage, 348 348 + publishedAt: post.frontmatter.publishDate, 349 349 + }); 205 350 206 206 - // For updates, rawContent already has atUri 207 207 - contentForHash = post.rawContent; 208 208 - updatedCount++; 209 209 - } 351 351 + // Update document record with bskyPostRef 352 352 + await addBskyPostRefToDocument(agent, atUri, bskyPostRef); 353 353 + log.info(` Created Bluesky post: ${bskyPostRef.uri}`); 354 354 + bskyPostCount++; 355 355 + } catch (bskyError) { 356 356 + const errorMsg = 357 357 + bskyError instanceof Error 358 358 + ? bskyError.message 359 359 + : String(bskyError); 360 360 + log.warn(` Failed to create Bluesky post: ${errorMsg}`); 361 361 + } 362 362 + } 363 363 + } 364 364 + } 210 365 211 211 - // Update state (use relative path from config directory) 212 212 - const contentHash = await getContentHash(contentForHash); 213 213 - const relativeFilePath = path.relative(configDir, post.filePath); 214 214 - state.posts[relativeFilePath] = { 215 215 - contentHash, 216 216 - atUri, 217 217 - lastPublished: new Date().toISOString(), 218 218 - }; 219 219 - } catch (error) { 220 220 - const errorMessage = error instanceof Error ? error.message : String(error); 221 221 - s.stop(`Error publishing "${path.basename(post.filePath)}"`); 222 222 - log.error(` ${errorMessage}`); 223 223 - errorCount++; 224 224 - } 225 225 - } 366 366 + // Update state (use relative path from config directory) 367 367 + const contentHash = await getContentHash(contentForHash); 368 368 + state.posts[relativeFilePath] = { 369 369 + contentHash, 370 370 + atUri, 371 371 + lastPublished: new Date().toISOString(), 372 372 + slug: post.slug, 373 373 + bskyPostRef, 374 374 + }; 375 375 + } catch (error) { 376 376 + const errorMessage = 377 377 + error instanceof Error ? error.message : String(error); 378 378 + s.stop(`Error publishing "${path.basename(post.filePath)}"`); 379 379 + log.error(` ${errorMessage}`); 380 380 + errorCount++; 381 381 + } 382 382 + } 226 383 227 227 - // Save state 228 228 - await saveState(configDir, state); 384 384 + // Save state 385 385 + await saveState(configDir, state); 229 386 230 230 - // Summary 231 231 - log.message("\n---"); 232 232 - log.info(`Published: ${publishedCount}`); 233 233 - log.info(`Updated: ${updatedCount}`); 234 234 - if (errorCount > 0) { 235 235 - log.warn(`Errors: ${errorCount}`); 236 236 - } 237 237 - }, 387 387 + // Summary 388 388 + log.message("\n---"); 389 389 + log.info(`Published: ${publishedCount}`); 390 390 + log.info(`Updated: ${updatedCount}`); 391 391 + if (bskyPostCount > 0) { 392 392 + log.info(`Bluesky posts: ${bskyPostCount}`); 393 393 + } 394 394 + if (errorCount > 0) { 395 395 + log.warn(`Errors: ${errorCount}`); 396 396 + } 397 397 + }, 238 398 });

+209 -151

packages/cli/src/commands/sync.ts

··· 1 1 - import * as fs from "fs/promises"; 1 1 + import * as fs from "node:fs/promises"; 2 2 import { command, flag } from "cmd-ts"; 3 3 import { select, spinner, log } from "@clack/prompts"; 4 4 - import * as path from "path"; 4 4 + import * as path from "node:path"; 5 5 import { loadConfig, loadState, saveState, findConfig } from "../lib/config"; 6 6 - import { loadCredentials, listCredentials, getCredentials } from "../lib/credentials"; 6 6 + import { 7 7 + loadCredentials, 8 8 + listAllCredentials, 9 9 + getCredentials, 10 10 + } from "../lib/credentials"; 11 11 + import { getOAuthHandle, getOAuthSession } from "../lib/oauth-store"; 7 12 import { createAgent, listDocuments } from "../lib/atproto"; 8 8 - import { scanContentDirectory, getContentHash, updateFrontmatterWithAtUri } from "../lib/markdown"; 13 13 + import { 14 14 + scanContentDirectory, 15 15 + getContentHash, 16 16 + updateFrontmatterWithAtUri, 17 17 + } from "../lib/markdown"; 9 18 import { exitOnCancel } from "../lib/prompts"; 10 19 11 20 export const syncCommand = command({ 12 12 - name: "sync", 13 13 - description: "Sync state from ATProto to restore .sequoia-state.json", 14 14 - args: { 15 15 - updateFrontmatter: flag({ 16 16 - long: "update-frontmatter", 17 17 - short: "u", 18 18 - description: "Update frontmatter atUri fields in local markdown files", 19 19 - }), 20 20 - dryRun: flag({ 21 21 - long: "dry-run", 22 22 - short: "n", 23 23 - description: "Preview what would be synced without making changes", 24 24 - }), 25 25 - }, 26 26 - handler: async ({ updateFrontmatter, dryRun }) => { 27 27 - // Load config 28 28 - const configPath = await findConfig(); 29 29 - if (!configPath) { 30 30 - log.error("No sequoia.json found. Run 'sequoia init' first."); 31 31 - process.exit(1); 32 32 - } 21 21 + name: "sync", 22 22 + description: "Sync state from ATProto to restore .sequoia-state.json", 23 23 + args: { 24 24 + updateFrontmatter: flag({ 25 25 + long: "update-frontmatter", 26 26 + short: "u", 27 27 + description: "Update frontmatter atUri fields in local markdown files", 28 28 + }), 29 29 + dryRun: flag({ 30 30 + long: "dry-run", 31 31 + short: "n", 32 32 + description: "Preview what would be synced without making changes", 33 33 + }), 34 34 + }, 35 35 + handler: async ({ updateFrontmatter, dryRun }) => { 36 36 + // Load config 37 37 + const configPath = await findConfig(); 38 38 + if (!configPath) { 39 39 + log.error("No sequoia.json found. Run 'sequoia init' first."); 40 40 + process.exit(1); 41 41 + } 33 42 34 34 - const config = await loadConfig(configPath); 35 35 - const configDir = path.dirname(configPath); 43 43 + const config = await loadConfig(configPath); 44 44 + const configDir = path.dirname(configPath); 36 45 37 37 - log.info(`Site: ${config.siteUrl}`); 38 38 - log.info(`Publication: ${config.publicationUri}`); 46 46 + log.info(`Site: ${config.siteUrl}`); 47 47 + log.info(`Publication: ${config.publicationUri}`); 39 48 40 40 - // Load credentials 41 41 - let credentials = await loadCredentials(config.identity); 49 49 + // Load credentials 50 50 + let credentials = await loadCredentials(config.identity); 42 51 43 43 - if (!credentials) { 44 44 - const identities = await listCredentials(); 45 45 - if (identities.length === 0) { 46 46 - log.error("No credentials found. Run 'sequoia auth' first."); 47 47 - process.exit(1); 48 48 - } 52 52 + if (!credentials) { 53 53 + const identities = await listAllCredentials(); 54 54 + if (identities.length === 0) { 55 55 + log.error( 56 56 + "No credentials found. Run 'sequoia login' or 'sequoia auth' first.", 57 57 + ); 58 58 + process.exit(1); 59 59 + } 49 60 50 50 - log.info("Multiple identities found. Select one to use:"); 51 51 - const selected = exitOnCancel(await select({ 52 52 - message: "Identity:", 53 53 - options: identities.map(id => ({ value: id, label: id })), 54 54 - })); 61 61 + // Build labels with handles for OAuth sessions 62 62 + const options = await Promise.all( 63 63 + identities.map(async (cred) => { 64 64 + if (cred.type === "oauth") { 65 65 + const handle = await getOAuthHandle(cred.id); 66 66 + return { 67 67 + value: cred.id, 68 68 + label: `${handle || cred.id} (OAuth)`, 69 69 + }; 70 70 + } 71 71 + return { 72 72 + value: cred.id, 73 73 + label: `${cred.id} (App Password)`, 74 74 + }; 75 75 + }), 76 76 + ); 55 77 56 56 - credentials = await getCredentials(selected); 57 57 - if (!credentials) { 58 58 - log.error("Failed to load selected credentials."); 59 59 - process.exit(1); 60 60 - } 61 61 - } 78 78 + log.info("Multiple identities found. Select one to use:"); 79 79 + const selected = exitOnCancel( 80 80 + await select({ 81 81 + message: "Identity:", 82 82 + options, 83 83 + }), 84 84 + ); 62 85 63 63 - // Create agent 64 64 - const s = spinner(); 65 65 - s.start(`Connecting to ${credentials.pdsUrl}...`); 66 66 - let agent; 67 67 - try { 68 68 - agent = await createAgent(credentials); 69 69 - s.stop(`Logged in as ${agent.session?.handle}`); 70 70 - } catch (error) { 71 71 - s.stop("Failed to login"); 72 72 - log.error(`Failed to login: ${error}`); 73 73 - process.exit(1); 74 74 - } 86 86 + // Load the selected credentials 87 87 + const selectedCred = identities.find((c) => c.id === selected); 88 88 + if (selectedCred?.type === "oauth") { 89 89 + const session = await getOAuthSession(selected); 90 90 + if (session) { 91 91 + const handle = await getOAuthHandle(selected); 92 92 + credentials = { 93 93 + type: "oauth", 94 94 + did: selected, 95 95 + handle: handle || selected, 96 96 + }; 97 97 + } 98 98 + } else { 99 99 + credentials = await getCredentials(selected); 100 100 + } 75 101 76 76 - // Fetch documents from PDS 77 77 - s.start("Fetching documents from PDS..."); 78 78 - const documents = await listDocuments(agent, config.publicationUri); 79 79 - s.stop(`Found ${documents.length} documents on PDS`); 102 102 + if (!credentials) { 103 103 + log.error("Failed to load selected credentials."); 104 104 + process.exit(1); 105 105 + } 106 106 + } 80 107 81 81 - if (documents.length === 0) { 82 82 - log.info("No documents found for this publication."); 83 83 - return; 84 84 - } 108 108 + // Create agent 109 109 + const s = spinner(); 110 110 + const connectingTo = 111 111 + credentials.type === "oauth" ? credentials.handle : credentials.pdsUrl; 112 112 + s.start(`Connecting as ${connectingTo}...`); 113 113 + let agent: Awaited<ReturnType<typeof createAgent>> | undefined; 114 114 + try { 115 115 + agent = await createAgent(credentials); 116 116 + s.stop(`Logged in as ${agent.did}`); 117 117 + } catch (error) { 118 118 + s.stop("Failed to login"); 119 119 + log.error(`Failed to login: ${error}`); 120 120 + process.exit(1); 121 121 + } 85 122 86 86 - // Resolve content directory 87 87 - const contentDir = path.isAbsolute(config.contentDir) 88 88 - ? config.contentDir 89 89 - : path.join(configDir, config.contentDir); 123 123 + // Fetch documents from PDS 124 124 + s.start("Fetching documents from PDS..."); 125 125 + const documents = await listDocuments(agent, config.publicationUri); 126 126 + s.stop(`Found ${documents.length} documents on PDS`); 90 127 91 91 - // Scan local posts 92 92 - s.start("Scanning local content..."); 93 93 - const localPosts = await scanContentDirectory(contentDir, config.frontmatter); 94 94 - s.stop(`Found ${localPosts.length} local posts`); 128 128 + if (documents.length === 0) { 129 129 + log.info("No documents found for this publication."); 130 130 + return; 131 131 + } 95 132 96 96 - // Build a map of path -> local post for matching 97 97 - // Document path is like /posts/my-post-slug 98 98 - const postsByPath = new Map<string, typeof localPosts[0]>(); 99 99 - for (const post of localPosts) { 100 100 - const postPath = `/posts/${post.slug}`; 101 101 - postsByPath.set(postPath, post); 102 102 - } 133 133 + // Resolve content directory 134 134 + const contentDir = path.isAbsolute(config.contentDir) 135 135 + ? config.contentDir 136 136 + : path.join(configDir, config.contentDir); 103 137 104 104 - // Load existing state 105 105 - const state = await loadState(configDir); 106 106 - const originalPostCount = Object.keys(state.posts).length; 138 138 + // Scan local posts 139 139 + s.start("Scanning local content..."); 140 140 + const localPosts = await scanContentDirectory(contentDir, { 141 141 + frontmatterMapping: config.frontmatter, 142 142 + ignorePatterns: config.ignore, 143 143 + slugField: config.frontmatter?.slugField, 144 144 + removeIndexFromSlug: config.removeIndexFromSlug, 145 145 + stripDatePrefix: config.stripDatePrefix, 146 146 + }); 147 147 + s.stop(`Found ${localPosts.length} local posts`); 107 148 108 108 - // Track changes 109 109 - let matchedCount = 0; 110 110 - let unmatchedCount = 0; 111 111 - let frontmatterUpdates: Array<{ filePath: string; atUri: string }> = []; 149 149 + // Build a map of path -> local post for matching 150 150 + // Document path is like /posts/my-post-slug (or custom pathPrefix) 151 151 + const pathPrefix = config.pathPrefix || "/posts"; 152 152 + const postsByPath = new Map<string, (typeof localPosts)[0]>(); 153 153 + for (const post of localPosts) { 154 154 + const postPath = `${pathPrefix}/${post.slug}`; 155 155 + postsByPath.set(postPath, post); 156 156 + } 112 157 113 113 - log.message("\nMatching documents to local files:\n"); 158 158 + // Load existing state 159 159 + const state = await loadState(configDir); 160 160 + const originalPostCount = Object.keys(state.posts).length; 114 161 115 115 - for (const doc of documents) { 116 116 - const docPath = doc.value.path; 117 117 - const localPost = postsByPath.get(docPath); 162 162 + // Track changes 163 163 + let matchedCount = 0; 164 164 + let unmatchedCount = 0; 165 165 + const frontmatterUpdates: Array<{ filePath: string; atUri: string }> = []; 118 166 119 119 - if (localPost) { 120 120 - matchedCount++; 121 121 - log.message(` ✓ ${doc.value.title}`); 122 122 - log.message(` Path: ${docPath}`); 123 123 - log.message(` URI: ${doc.uri}`); 124 124 - log.message(` File: ${path.basename(localPost.filePath)}`); 167 167 + log.message("\nMatching documents to local files:\n"); 125 168 126 126 - // Update state (use relative path from config directory) 127 127 - const contentHash = await getContentHash(localPost.rawContent); 128 128 - const relativeFilePath = path.relative(configDir, localPost.filePath); 129 129 - state.posts[relativeFilePath] = { 130 130 - contentHash, 131 131 - atUri: doc.uri, 132 132 - lastPublished: doc.value.publishedAt, 133 133 - }; 169 169 + for (const doc of documents) { 170 170 + const docPath = doc.value.path; 171 171 + const localPost = postsByPath.get(docPath); 134 172 135 135 - // Check if frontmatter needs updating 136 136 - if (updateFrontmatter && localPost.frontmatter.atUri !== doc.uri) { 137 137 - frontmatterUpdates.push({ 138 138 - filePath: localPost.filePath, 139 139 - atUri: doc.uri, 140 140 - }); 141 141 - log.message(` → Will update frontmatter`); 142 142 - } 143 143 - } else { 144 144 - unmatchedCount++; 145 145 - log.message(` ✗ ${doc.value.title} (no matching local file)`); 146 146 - log.message(` Path: ${docPath}`); 147 147 - log.message(` URI: ${doc.uri}`); 148 148 - } 149 149 - log.message(""); 150 150 - } 173 173 + if (localPost) { 174 174 + matchedCount++; 175 175 + log.message(` ✓ ${doc.value.title}`); 176 176 + log.message(` Path: ${docPath}`); 177 177 + log.message(` URI: ${doc.uri}`); 178 178 + log.message(` File: ${path.basename(localPost.filePath)}`); 151 179 152 152 - // Summary 153 153 - log.message("---"); 154 154 - log.info(`Matched: ${matchedCount} documents`); 155 155 - if (unmatchedCount > 0) { 156 156 - log.warn(`Unmatched: ${unmatchedCount} documents (exist on PDS but not locally)`); 157 157 - } 180 180 + // Update state (use relative path from config directory) 181 181 + const contentHash = await getContentHash(localPost.rawContent); 182 182 + const relativeFilePath = path.relative(configDir, localPost.filePath); 183 183 + state.posts[relativeFilePath] = { 184 184 + contentHash, 185 185 + atUri: doc.uri, 186 186 + lastPublished: doc.value.publishedAt, 187 187 + }; 158 188 159 159 - if (dryRun) { 160 160 - log.info("\nDry run complete. No changes made."); 161 161 - return; 162 162 - } 189 189 + // Check if frontmatter needs updating 190 190 + if (updateFrontmatter && localPost.frontmatter.atUri !== doc.uri) { 191 191 + frontmatterUpdates.push({ 192 192 + filePath: localPost.filePath, 193 193 + atUri: doc.uri, 194 194 + }); 195 195 + log.message(` → Will update frontmatter`); 196 196 + } 197 197 + } else { 198 198 + unmatchedCount++; 199 199 + log.message(` ✗ ${doc.value.title} (no matching local file)`); 200 200 + log.message(` Path: ${docPath}`); 201 201 + log.message(` URI: ${doc.uri}`); 202 202 + } 203 203 + log.message(""); 204 204 + } 163 205 164 164 - // Save updated state 165 165 - await saveState(configDir, state); 166 166 - const newPostCount = Object.keys(state.posts).length; 167 167 - log.success(`\nSaved .sequoia-state.json (${originalPostCount} → ${newPostCount} entries)`); 206 206 + // Summary 207 207 + log.message("---"); 208 208 + log.info(`Matched: ${matchedCount} documents`); 209 209 + if (unmatchedCount > 0) { 210 210 + log.warn( 211 211 + `Unmatched: ${unmatchedCount} documents (exist on PDS but not locally)`, 212 212 + ); 213 213 + } 168 214 169 169 - // Update frontmatter if requested 170 170 - if (frontmatterUpdates.length > 0) { 171 171 - s.start(`Updating frontmatter in ${frontmatterUpdates.length} files...`); 172 172 - for (const { filePath, atUri } of frontmatterUpdates) { 173 173 - const content = await fs.readFile(filePath, "utf-8"); 174 174 - const updated = updateFrontmatterWithAtUri(content, atUri); 175 175 - await fs.writeFile(filePath, updated); 176 176 - log.message(` Updated: ${path.basename(filePath)}`); 177 177 - } 178 178 - s.stop("Frontmatter updated"); 179 179 - } 215 215 + if (dryRun) { 216 216 + log.info("\nDry run complete. No changes made."); 217 217 + return; 218 218 + } 219 219 + 220 220 + // Save updated state 221 221 + await saveState(configDir, state); 222 222 + const newPostCount = Object.keys(state.posts).length; 223 223 + log.success( 224 224 + `\nSaved .sequoia-state.json (${originalPostCount} → ${newPostCount} entries)`, 225 225 + ); 226 226 + 227 227 + // Update frontmatter if requested 228 228 + if (frontmatterUpdates.length > 0) { 229 229 + s.start(`Updating frontmatter in ${frontmatterUpdates.length} files...`); 230 230 + for (const { filePath, atUri } of frontmatterUpdates) { 231 231 + const content = await fs.readFile(filePath, "utf-8"); 232 232 + const updated = updateFrontmatterWithAtUri(content, atUri); 233 233 + await fs.writeFile(filePath, updated); 234 234 + log.message(` Updated: ${path.basename(filePath)}`); 235 235 + } 236 236 + s.stop("Frontmatter updated"); 237 237 + } 180 238 181 181 - log.success("\nSync complete!"); 182 182 - }, 239 239 + log.success("\nSync complete!"); 240 240 + }, 183 241 });

+624

packages/cli/src/commands/update.ts

··· 1 1 + import * as fs from "node:fs/promises"; 2 2 + import { command } from "cmd-ts"; 3 3 + import { 4 4 + intro, 5 5 + outro, 6 6 + note, 7 7 + text, 8 8 + confirm, 9 9 + select, 10 10 + spinner, 11 11 + log, 12 12 + } from "@clack/prompts"; 13 13 + import { findConfig, loadConfig, generateConfigTemplate } from "../lib/config"; 14 14 + import { 15 15 + loadCredentials, 16 16 + listAllCredentials, 17 17 + getCredentials, 18 18 + } from "../lib/credentials"; 19 19 + import { getOAuthHandle, getOAuthSession } from "../lib/oauth-store"; 20 20 + import { createAgent, getPublication, updatePublication } from "../lib/atproto"; 21 21 + import { exitOnCancel } from "../lib/prompts"; 22 22 + import type { 23 23 + PublisherConfig, 24 24 + FrontmatterMapping, 25 25 + BlueskyConfig, 26 26 + } from "../lib/types"; 27 27 + 28 28 + export const updateCommand = command({ 29 29 + name: "update", 30 30 + description: "Update local config or ATProto publication record", 31 31 + args: {}, 32 32 + handler: async () => { 33 33 + intro("Sequoia Update"); 34 34 + 35 35 + // Check if config exists 36 36 + const configPath = await findConfig(); 37 37 + if (!configPath) { 38 38 + log.error("No configuration found. Run 'sequoia init' first."); 39 39 + process.exit(1); 40 40 + } 41 41 + 42 42 + const config = await loadConfig(configPath); 43 43 + 44 44 + // Ask what to update 45 45 + const updateChoice = exitOnCancel( 46 46 + await select({ 47 47 + message: "What would you like to update?", 48 48 + options: [ 49 49 + { label: "Local configuration (sequoia.json)", value: "config" }, 50 50 + { label: "ATProto publication record", value: "publication" }, 51 51 + ], 52 52 + }), 53 53 + ); 54 54 + 55 55 + if (updateChoice === "config") { 56 56 + await updateConfigFlow(config, configPath); 57 57 + } else { 58 58 + await updatePublicationFlow(config); 59 59 + } 60 60 + 61 61 + outro("Update complete!"); 62 62 + }, 63 63 + }); 64 64 + 65 65 + async function updateConfigFlow( 66 66 + config: PublisherConfig, 67 67 + configPath: string, 68 68 + ): Promise<void> { 69 69 + // Show current config summary 70 70 + const configSummary = [ 71 71 + `Site URL: ${config.siteUrl}`, 72 72 + `Content Dir: ${config.contentDir}`, 73 73 + `Path Prefix: ${config.pathPrefix || "/posts"}`, 74 74 + `Publication URI: ${config.publicationUri}`, 75 75 + config.imagesDir ? `Images Dir: ${config.imagesDir}` : null, 76 76 + config.outputDir ? `Output Dir: ${config.outputDir}` : null, 77 77 + config.bluesky?.enabled ? `Bluesky: enabled` : null, 78 78 + ] 79 79 + .filter(Boolean) 80 80 + .join("\n"); 81 81 + 82 82 + note(configSummary, "Current Configuration"); 83 83 + 84 84 + let configUpdated = { ...config }; 85 85 + let editing = true; 86 86 + 87 87 + while (editing) { 88 88 + const section = exitOnCancel( 89 89 + await select({ 90 90 + message: "Select a section to edit:", 91 91 + options: [ 92 92 + { label: "Site settings (siteUrl, pathPrefix)", value: "site" }, 93 93 + { 94 94 + label: 95 95 + "Directory paths (contentDir, imagesDir, publicDir, outputDir)", 96 96 + value: "directories", 97 97 + }, 98 98 + { 99 99 + label: 100 100 + "Frontmatter mappings (title, description, publishDate, etc.)", 101 101 + value: "frontmatter", 102 102 + }, 103 103 + { 104 104 + label: 105 105 + "Advanced options (pdsUrl, identity, ignore, removeIndexFromSlug, etc.)", 106 106 + value: "advanced", 107 107 + }, 108 108 + { 109 109 + label: "Bluesky settings (enabled, maxAgeDays)", 110 110 + value: "bluesky", 111 111 + }, 112 112 + { label: "Done editing", value: "done" }, 113 113 + ], 114 114 + }), 115 115 + ); 116 116 + 117 117 + if (section === "done") { 118 118 + editing = false; 119 119 + continue; 120 120 + } 121 121 + 122 122 + switch (section) { 123 123 + case "site": 124 124 + configUpdated = await editSiteSettings(configUpdated); 125 125 + break; 126 126 + case "directories": 127 127 + configUpdated = await editDirectories(configUpdated); 128 128 + break; 129 129 + case "frontmatter": 130 130 + configUpdated = await editFrontmatter(configUpdated); 131 131 + break; 132 132 + case "advanced": 133 133 + configUpdated = await editAdvanced(configUpdated); 134 134 + break; 135 135 + case "bluesky": 136 136 + configUpdated = await editBluesky(configUpdated); 137 137 + break; 138 138 + } 139 139 + } 140 140 + 141 141 + // Confirm before saving 142 142 + const shouldSave = exitOnCancel( 143 143 + await confirm({ 144 144 + message: "Save changes to sequoia.json?", 145 145 + initialValue: true, 146 146 + }), 147 147 + ); 148 148 + 149 149 + if (shouldSave) { 150 150 + const configContent = generateConfigTemplate({ 151 151 + siteUrl: configUpdated.siteUrl, 152 152 + contentDir: configUpdated.contentDir, 153 153 + imagesDir: configUpdated.imagesDir, 154 154 + publicDir: configUpdated.publicDir, 155 155 + outputDir: configUpdated.outputDir, 156 156 + pathPrefix: configUpdated.pathPrefix, 157 157 + publicationUri: configUpdated.publicationUri, 158 158 + pdsUrl: configUpdated.pdsUrl, 159 159 + frontmatter: configUpdated.frontmatter, 160 160 + ignore: configUpdated.ignore, 161 161 + removeIndexFromSlug: configUpdated.removeIndexFromSlug, 162 162 + stripDatePrefix: configUpdated.stripDatePrefix, 163 163 + textContentField: configUpdated.textContentField, 164 164 + bluesky: configUpdated.bluesky, 165 165 + }); 166 166 + 167 167 + await fs.writeFile(configPath, configContent); 168 168 + log.success("Configuration saved!"); 169 169 + } else { 170 170 + log.info("Changes discarded."); 171 171 + } 172 172 + } 173 173 + 174 174 + async function editSiteSettings( 175 175 + config: PublisherConfig, 176 176 + ): Promise<PublisherConfig> { 177 177 + const siteUrl = exitOnCancel( 178 178 + await text({ 179 179 + message: "Site URL:", 180 180 + initialValue: config.siteUrl, 181 181 + validate: (value) => { 182 182 + if (!value) return "Site URL is required"; 183 183 + try { 184 184 + new URL(value); 185 185 + } catch { 186 186 + return "Please enter a valid URL"; 187 187 + } 188 188 + }, 189 189 + }), 190 190 + ); 191 191 + 192 192 + const pathPrefix = exitOnCancel( 193 193 + await text({ 194 194 + message: "URL path prefix for posts:", 195 195 + initialValue: config.pathPrefix || "/posts", 196 196 + }), 197 197 + ); 198 198 + 199 199 + return { 200 200 + ...config, 201 201 + siteUrl, 202 202 + pathPrefix: pathPrefix || undefined, 203 203 + }; 204 204 + } 205 205 + 206 206 + async function editDirectories( 207 207 + config: PublisherConfig, 208 208 + ): Promise<PublisherConfig> { 209 209 + const contentDir = exitOnCancel( 210 210 + await text({ 211 211 + message: "Content directory:", 212 212 + initialValue: config.contentDir, 213 213 + validate: (value) => { 214 214 + if (!value) return "Content directory is required"; 215 215 + }, 216 216 + }), 217 217 + ); 218 218 + 219 219 + const imagesDir = exitOnCancel( 220 220 + await text({ 221 221 + message: "Cover images directory (leave empty to skip):", 222 222 + initialValue: config.imagesDir || "", 223 223 + }), 224 224 + ); 225 225 + 226 226 + const publicDir = exitOnCancel( 227 227 + await text({ 228 228 + message: "Public/static directory:", 229 229 + initialValue: config.publicDir || "./public", 230 230 + }), 231 231 + ); 232 232 + 233 233 + const outputDir = exitOnCancel( 234 234 + await text({ 235 235 + message: "Build output directory:", 236 236 + initialValue: config.outputDir || "./dist", 237 237 + }), 238 238 + ); 239 239 + 240 240 + return { 241 241 + ...config, 242 242 + contentDir, 243 243 + imagesDir: imagesDir || undefined, 244 244 + publicDir: publicDir || undefined, 245 245 + outputDir: outputDir || undefined, 246 246 + }; 247 247 + } 248 248 + 249 249 + async function editFrontmatter( 250 250 + config: PublisherConfig, 251 251 + ): Promise<PublisherConfig> { 252 252 + const currentFrontmatter = config.frontmatter || {}; 253 253 + 254 254 + log.info("Press Enter to keep current value, or type a new field name."); 255 255 + 256 256 + const titleField = exitOnCancel( 257 257 + await text({ 258 258 + message: "Field name for title:", 259 259 + initialValue: currentFrontmatter.title || "title", 260 260 + }), 261 261 + ); 262 262 + 263 263 + const descField = exitOnCancel( 264 264 + await text({ 265 265 + message: "Field name for description:", 266 266 + initialValue: currentFrontmatter.description || "description", 267 267 + }), 268 268 + ); 269 269 + 270 270 + const dateField = exitOnCancel( 271 271 + await text({ 272 272 + message: "Field name for publish date:", 273 273 + initialValue: currentFrontmatter.publishDate || "publishDate", 274 274 + }), 275 275 + ); 276 276 + 277 277 + const coverField = exitOnCancel( 278 278 + await text({ 279 279 + message: "Field name for cover image:", 280 280 + initialValue: currentFrontmatter.coverImage || "ogImage", 281 281 + }), 282 282 + ); 283 283 + 284 284 + const tagsField = exitOnCancel( 285 285 + await text({ 286 286 + message: "Field name for tags:", 287 287 + initialValue: currentFrontmatter.tags || "tags", 288 288 + }), 289 289 + ); 290 290 + 291 291 + const draftField = exitOnCancel( 292 292 + await text({ 293 293 + message: "Field name for draft status:", 294 294 + initialValue: currentFrontmatter.draft || "draft", 295 295 + }), 296 296 + ); 297 297 + 298 298 + const slugField = exitOnCancel( 299 299 + await text({ 300 300 + message: "Field name for slug (leave empty to use filepath):", 301 301 + initialValue: currentFrontmatter.slugField || "", 302 302 + }), 303 303 + ); 304 304 + 305 305 + // Build frontmatter mapping, only including non-default values 306 306 + const fieldMappings: Array<[keyof FrontmatterMapping, string, string]> = [ 307 307 + ["title", titleField, "title"], 308 308 + ["description", descField, "description"], 309 309 + ["publishDate", dateField, "publishDate"], 310 310 + ["coverImage", coverField, "ogImage"], 311 311 + ["tags", tagsField, "tags"], 312 312 + ["draft", draftField, "draft"], 313 313 + ]; 314 314 + 315 315 + const builtMapping = fieldMappings.reduce<FrontmatterMapping>( 316 316 + (acc, [key, value, defaultValue]) => { 317 317 + if (value !== defaultValue) { 318 318 + acc[key] = value; 319 319 + } 320 320 + return acc; 321 321 + }, 322 322 + {}, 323 323 + ); 324 324 + 325 325 + // Handle slugField separately since it has no default 326 326 + if (slugField) { 327 327 + builtMapping.slugField = slugField; 328 328 + } 329 329 + 330 330 + const frontmatter = 331 331 + Object.keys(builtMapping).length > 0 ? builtMapping : undefined; 332 332 + 333 333 + return { 334 334 + ...config, 335 335 + frontmatter, 336 336 + }; 337 337 + } 338 338 + 339 339 + async function editAdvanced(config: PublisherConfig): Promise<PublisherConfig> { 340 340 + const pdsUrl = exitOnCancel( 341 341 + await text({ 342 342 + message: "PDS URL (leave empty for default bsky.social):", 343 343 + initialValue: config.pdsUrl || "", 344 344 + }), 345 345 + ); 346 346 + 347 347 + const identity = exitOnCancel( 348 348 + await text({ 349 349 + message: "Identity/profile to use (leave empty for auto-detect):", 350 350 + initialValue: config.identity || "", 351 351 + }), 352 352 + ); 353 353 + 354 354 + const ignoreInput = exitOnCancel( 355 355 + await text({ 356 356 + message: "Ignore patterns (comma-separated, e.g., _index.md,drafts/**):", 357 357 + initialValue: config.ignore?.join(", ") || "", 358 358 + }), 359 359 + ); 360 360 + 361 361 + const removeIndexFromSlug = exitOnCancel( 362 362 + await confirm({ 363 363 + message: "Remove /index or /_index suffix from paths?", 364 364 + initialValue: config.removeIndexFromSlug || false, 365 365 + }), 366 366 + ); 367 367 + 368 368 + const stripDatePrefix = exitOnCancel( 369 369 + await confirm({ 370 370 + message: "Strip YYYY-MM-DD- prefix from filenames (Jekyll-style)?", 371 371 + initialValue: config.stripDatePrefix || false, 372 372 + }), 373 373 + ); 374 374 + 375 375 + const textContentField = exitOnCancel( 376 376 + await text({ 377 377 + message: 378 378 + "Frontmatter field for textContent (leave empty to use markdown body):", 379 379 + initialValue: config.textContentField || "", 380 380 + }), 381 381 + ); 382 382 + 383 383 + // Parse ignore patterns 384 384 + const ignore = ignoreInput 385 385 + ? ignoreInput 386 386 + .split(",") 387 387 + .map((p) => p.trim()) 388 388 + .filter(Boolean) 389 389 + : undefined; 390 390 + 391 391 + return { 392 392 + ...config, 393 393 + pdsUrl: pdsUrl || undefined, 394 394 + identity: identity || undefined, 395 395 + ignore: ignore && ignore.length > 0 ? ignore : undefined, 396 396 + removeIndexFromSlug: removeIndexFromSlug || undefined, 397 397 + stripDatePrefix: stripDatePrefix || undefined, 398 398 + textContentField: textContentField || undefined, 399 399 + }; 400 400 + } 401 401 + 402 402 + async function editBluesky(config: PublisherConfig): Promise<PublisherConfig> { 403 403 + const enabled = exitOnCancel( 404 404 + await confirm({ 405 405 + message: "Enable automatic Bluesky posting when publishing?", 406 406 + initialValue: config.bluesky?.enabled || false, 407 407 + }), 408 408 + ); 409 409 + 410 410 + if (!enabled) { 411 411 + return { 412 412 + ...config, 413 413 + bluesky: undefined, 414 414 + }; 415 415 + } 416 416 + 417 417 + const maxAgeDaysInput = exitOnCancel( 418 418 + await text({ 419 419 + message: "Maximum age (in days) for posts to be shared on Bluesky:", 420 420 + initialValue: String(config.bluesky?.maxAgeDays || 7), 421 421 + validate: (value) => { 422 422 + if (!value) return "Please enter a number"; 423 423 + const num = Number.parseInt(value, 10); 424 424 + if (Number.isNaN(num) || num < 1) { 425 425 + return "Please enter a positive number"; 426 426 + } 427 427 + }, 428 428 + }), 429 429 + ); 430 430 + 431 431 + const maxAgeDays = parseInt(maxAgeDaysInput, 10); 432 432 + 433 433 + const bluesky: BlueskyConfig = { 434 434 + enabled: true, 435 435 + ...(maxAgeDays !== 7 && { maxAgeDays }), 436 436 + }; 437 437 + 438 438 + return { 439 439 + ...config, 440 440 + bluesky, 441 441 + }; 442 442 + } 443 443 + 444 444 + async function updatePublicationFlow(config: PublisherConfig): Promise<void> { 445 445 + // Load credentials 446 446 + let credentials = await loadCredentials(config.identity); 447 447 + 448 448 + if (!credentials) { 449 449 + const identities = await listAllCredentials(); 450 450 + if (identities.length === 0) { 451 451 + log.error( 452 452 + "No credentials found. Run 'sequoia login' or 'sequoia auth' first.", 453 453 + ); 454 454 + process.exit(1); 455 455 + } 456 456 + 457 457 + // Build labels with handles for OAuth sessions 458 458 + const options = await Promise.all( 459 459 + identities.map(async (cred) => { 460 460 + if (cred.type === "oauth") { 461 461 + const handle = await getOAuthHandle(cred.id); 462 462 + return { 463 463 + value: cred.id, 464 464 + label: `${handle || cred.id} (OAuth)`, 465 465 + }; 466 466 + } 467 467 + return { 468 468 + value: cred.id, 469 469 + label: `${cred.id} (App Password)`, 470 470 + }; 471 471 + }), 472 472 + ); 473 473 + 474 474 + log.info("Multiple identities found. Select one to use:"); 475 475 + const selected = exitOnCancel( 476 476 + await select({ 477 477 + message: "Identity:", 478 478 + options, 479 479 + }), 480 480 + ); 481 481 + 482 482 + // Load the selected credentials 483 483 + const selectedCred = identities.find((c) => c.id === selected); 484 484 + if (selectedCred?.type === "oauth") { 485 485 + const session = await getOAuthSession(selected); 486 486 + if (session) { 487 487 + const handle = await getOAuthHandle(selected); 488 488 + credentials = { 489 489 + type: "oauth", 490 490 + did: selected, 491 491 + handle: handle || selected, 492 492 + }; 493 493 + } 494 494 + } else { 495 495 + credentials = await getCredentials(selected); 496 496 + } 497 497 + 498 498 + if (!credentials) { 499 499 + log.error("Failed to load selected credentials."); 500 500 + process.exit(1); 501 501 + } 502 502 + } 503 503 + 504 504 + const s = spinner(); 505 505 + s.start("Connecting to ATProto..."); 506 506 + 507 507 + let agent: Awaited<ReturnType<typeof createAgent>>; 508 508 + try { 509 509 + agent = await createAgent(credentials); 510 510 + s.stop("Connected!"); 511 511 + } catch (error) { 512 512 + s.stop("Failed to connect"); 513 513 + log.error(`Failed to connect: ${error}`); 514 514 + process.exit(1); 515 515 + } 516 516 + 517 517 + // Fetch existing publication 518 518 + s.start("Fetching publication..."); 519 519 + const publication = await getPublication(agent, config.publicationUri); 520 520 + 521 521 + if (!publication) { 522 522 + s.stop("Publication not found"); 523 523 + log.error(`Could not find publication: ${config.publicationUri}`); 524 524 + process.exit(1); 525 525 + } 526 526 + s.stop("Publication loaded!"); 527 527 + 528 528 + // Show current publication info 529 529 + const pubRecord = publication.value; 530 530 + const pubSummary = [ 531 531 + `Name: ${pubRecord.name}`, 532 532 + `URL: ${pubRecord.url}`, 533 533 + pubRecord.description ? `Description: ${pubRecord.description}` : null, 534 534 + pubRecord.icon ? `Icon: (uploaded)` : null, 535 535 + `Show in Discover: ${pubRecord.preferences?.showInDiscover ?? true}`, 536 536 + `Created: ${pubRecord.createdAt}`, 537 537 + ] 538 538 + .filter(Boolean) 539 539 + .join("\n"); 540 540 + 541 541 + note(pubSummary, "Current Publication"); 542 542 + 543 543 + // Collect updates with pre-populated values 544 544 + const name = exitOnCancel( 545 545 + await text({ 546 546 + message: "Publication name:", 547 547 + initialValue: pubRecord.name, 548 548 + validate: (value) => { 549 549 + if (!value) return "Publication name is required"; 550 550 + }, 551 551 + }), 552 552 + ); 553 553 + 554 554 + const description = exitOnCancel( 555 555 + await text({ 556 556 + message: "Publication description (leave empty to clear):", 557 557 + initialValue: pubRecord.description || "", 558 558 + }), 559 559 + ); 560 560 + 561 561 + const url = exitOnCancel( 562 562 + await text({ 563 563 + message: "Publication URL:", 564 564 + initialValue: pubRecord.url, 565 565 + validate: (value) => { 566 566 + if (!value) return "URL is required"; 567 567 + try { 568 568 + new URL(value); 569 569 + } catch { 570 570 + return "Please enter a valid URL"; 571 571 + } 572 572 + }, 573 573 + }), 574 574 + ); 575 575 + 576 576 + const iconPath = exitOnCancel( 577 577 + await text({ 578 578 + message: "New icon path (leave empty to keep existing):", 579 579 + initialValue: "", 580 580 + }), 581 581 + ); 582 582 + 583 583 + const showInDiscover = exitOnCancel( 584 584 + await confirm({ 585 585 + message: "Show in Discover feed?", 586 586 + initialValue: pubRecord.preferences?.showInDiscover ?? true, 587 587 + }), 588 588 + ); 589 589 + 590 590 + // Confirm before updating 591 591 + const shouldUpdate = exitOnCancel( 592 592 + await confirm({ 593 593 + message: "Update publication on ATProto?", 594 594 + initialValue: true, 595 595 + }), 596 596 + ); 597 597 + 598 598 + if (!shouldUpdate) { 599 599 + log.info("Update cancelled."); 600 600 + return; 601 601 + } 602 602 + 603 603 + // Perform update 604 604 + s.start("Updating publication..."); 605 605 + try { 606 606 + await updatePublication( 607 607 + agent, 608 608 + config.publicationUri, 609 609 + { 610 610 + name, 611 611 + description, 612 612 + url, 613 613 + iconPath: iconPath || undefined, 614 614 + showInDiscover, 615 615 + }, 616 616 + pubRecord, 617 617 + ); 618 618 + s.stop("Publication updated!"); 619 619 + } catch (error) { 620 620 + s.stop("Failed to update publication"); 621 621 + log.error(`Failed to update: ${error}`); 622 622 + process.exit(1); 623 623 + } 624 624 + }

+856

packages/cli/src/components/sequoia-comments.js

··· 1 1 + /** 2 2 + * Sequoia Comments - A Bluesky-powered comments component 3 3 + * 4 4 + * A self-contained Web Component that displays comments from Bluesky posts 5 5 + * linked to documents via the AT Protocol. 6 6 + * 7 7 + * Usage: 8 8 + * <sequoia-comments></sequoia-comments> 9 9 + * 10 10 + * The component looks for a document URI in two places: 11 11 + * 1. The `document-uri` attribute on the element 12 12 + * 2. A <link rel="site.standard.document" href="at://..."> tag in the document head 13 13 + * 14 14 + * Attributes: 15 15 + * - document-uri: AT Protocol URI for the document (optional if link tag exists) 16 16 + * - depth: Maximum depth of nested replies to fetch (default: 6) 17 17 + * 18 18 + * CSS Custom Properties: 19 19 + * - --sequoia-fg-color: Text color (default: #1f2937) 20 20 + * - --sequoia-bg-color: Background color (default: #ffffff) 21 21 + * - --sequoia-border-color: Border color (default: #e5e7eb) 22 22 + * - --sequoia-accent-color: Accent/link color (default: #2563eb) 23 23 + * - --sequoia-secondary-color: Secondary text color (default: #6b7280) 24 24 + * - --sequoia-border-radius: Border radius (default: 8px) 25 25 + */ 26 26 + 27 27 + // ============================================================================ 28 28 + // Styles 29 29 + // ============================================================================ 30 30 + 31 31 + const styles = ` 32 32 + :host { 33 33 + display: block; 34 34 + font-family: system-ui, -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, sans-serif; 35 35 + color: var(--sequoia-fg-color, #1f2937); 36 36 + line-height: 1.5; 37 37 + } 38 38 + 39 39 + * { 40 40 + box-sizing: border-box; 41 41 + } 42 42 + 43 43 + .sequoia-comments-container { 44 44 + max-width: 100%; 45 45 + } 46 46 + 47 47 + .sequoia-loading, 48 48 + .sequoia-error, 49 49 + .sequoia-empty, 50 50 + .sequoia-warning { 51 51 + padding: 1rem; 52 52 + border-radius: var(--sequoia-border-radius, 8px); 53 53 + text-align: center; 54 54 + } 55 55 + 56 56 + .sequoia-loading { 57 57 + background: var(--sequoia-bg-color, #ffffff); 58 58 + border: 1px solid var(--sequoia-border-color, #e5e7eb); 59 59 + color: var(--sequoia-secondary-color, #6b7280); 60 60 + } 61 61 + 62 62 + .sequoia-loading-spinner { 63 63 + display: inline-block; 64 64 + width: 1.25rem; 65 65 + height: 1.25rem; 66 66 + border: 2px solid var(--sequoia-border-color, #e5e7eb); 67 67 + border-top-color: var(--sequoia-accent-color, #2563eb); 68 68 + border-radius: 50%; 69 69 + animation: sequoia-spin 0.8s linear infinite; 70 70 + margin-right: 0.5rem; 71 71 + vertical-align: middle; 72 72 + } 73 73 + 74 74 + @keyframes sequoia-spin { 75 75 + to { transform: rotate(360deg); } 76 76 + } 77 77 + 78 78 + .sequoia-error { 79 79 + background: #fef2f2; 80 80 + border: 1px solid #fecaca; 81 81 + color: #dc2626; 82 82 + } 83 83 + 84 84 + .sequoia-warning { 85 85 + background: #fffbeb; 86 86 + border: 1px solid #fde68a; 87 87 + color: #d97706; 88 88 + } 89 89 + 90 90 + .sequoia-empty { 91 91 + background: var(--sequoia-bg-color, #ffffff); 92 92 + border: 1px solid var(--sequoia-border-color, #e5e7eb); 93 93 + color: var(--sequoia-secondary-color, #6b7280); 94 94 + } 95 95 + 96 96 + .sequoia-comments-header { 97 97 + display: flex; 98 98 + justify-content: space-between; 99 99 + align-items: center; 100 100 + margin-bottom: 1rem; 101 101 + padding-bottom: 0.75rem; 102 102 + } 103 103 + 104 104 + .sequoia-comments-title { 105 105 + font-size: 1.125rem; 106 106 + font-weight: 600; 107 107 + margin: 0; 108 108 + } 109 109 + 110 110 + .sequoia-reply-button { 111 111 + display: inline-flex; 112 112 + align-items: center; 113 113 + gap: 0.375rem; 114 114 + padding: 0.5rem 1rem; 115 115 + background: var(--sequoia-accent-color, #2563eb); 116 116 + color: #ffffff; 117 117 + border: none; 118 118 + border-radius: var(--sequoia-border-radius, 8px); 119 119 + font-size: 0.875rem; 120 120 + font-weight: 500; 121 121 + cursor: pointer; 122 122 + text-decoration: none; 123 123 + transition: background-color 0.15s ease; 124 124 + } 125 125 + 126 126 + .sequoia-reply-button:hover { 127 127 + background: color-mix(in srgb, var(--sequoia-accent-color, #2563eb) 85%, black); 128 128 + } 129 129 + 130 130 + .sequoia-reply-button svg { 131 131 + width: 1rem; 132 132 + height: 1rem; 133 133 + } 134 134 + 135 135 + .sequoia-comments-list { 136 136 + display: flex; 137 137 + flex-direction: column; 138 138 + } 139 139 + 140 140 + .sequoia-thread { 141 141 + border-top: 1px solid var(--sequoia-border-color, #e5e7eb); 142 142 + padding-bottom: 1rem; 143 143 + } 144 144 + 145 145 + .sequoia-thread + .sequoia-thread { 146 146 + margin-top: 0.5rem; 147 147 + } 148 148 + 149 149 + .sequoia-thread:last-child { 150 150 + border-bottom: 1px solid var(--sequoia-border-color, #e5e7eb); 151 151 + } 152 152 + 153 153 + .sequoia-comment { 154 154 + display: flex; 155 155 + gap: 0.75rem; 156 156 + padding-top: 1rem; 157 157 + } 158 158 + 159 159 + .sequoia-comment-avatar-column { 160 160 + display: flex; 161 161 + flex-direction: column; 162 162 + align-items: center; 163 163 + flex-shrink: 0; 164 164 + width: 2.5rem; 165 165 + position: relative; 166 166 + } 167 167 + 168 168 + .sequoia-comment-avatar { 169 169 + width: 2.5rem; 170 170 + height: 2.5rem; 171 171 + border-radius: 50%; 172 172 + background: var(--sequoia-border-color, #e5e7eb); 173 173 + object-fit: cover; 174 174 + flex-shrink: 0; 175 175 + position: relative; 176 176 + z-index: 1; 177 177 + } 178 178 + 179 179 + .sequoia-comment-avatar-placeholder { 180 180 + width: 2.5rem; 181 181 + height: 2.5rem; 182 182 + border-radius: 50%; 183 183 + background: var(--sequoia-border-color, #e5e7eb); 184 184 + display: flex; 185 185 + align-items: center; 186 186 + justify-content: center; 187 187 + flex-shrink: 0; 188 188 + color: var(--sequoia-secondary-color, #6b7280); 189 189 + font-weight: 600; 190 190 + font-size: 1rem; 191 191 + position: relative; 192 192 + z-index: 1; 193 193 + } 194 194 + 195 195 + .sequoia-thread-line { 196 196 + position: absolute; 197 197 + top: 2.5rem; 198 198 + bottom: calc(-1rem - 0.5rem); 199 199 + left: 50%; 200 200 + transform: translateX(-50%); 201 201 + width: 2px; 202 202 + background: var(--sequoia-border-color, #e5e7eb); 203 203 + } 204 204 + 205 205 + .sequoia-comment-content { 206 206 + flex: 1; 207 207 + min-width: 0; 208 208 + } 209 209 + 210 210 + .sequoia-comment-header { 211 211 + display: flex; 212 212 + align-items: baseline; 213 213 + gap: 0.5rem; 214 214 + margin-bottom: 0.25rem; 215 215 + flex-wrap: wrap; 216 216 + } 217 217 + 218 218 + .sequoia-comment-author { 219 219 + font-weight: 600; 220 220 + color: var(--sequoia-fg-color, #1f2937); 221 221 + text-decoration: none; 222 222 + overflow: hidden; 223 223 + text-overflow: ellipsis; 224 224 + white-space: nowrap; 225 225 + } 226 226 + 227 227 + .sequoia-comment-author:hover { 228 228 + color: var(--sequoia-accent-color, #2563eb); 229 229 + } 230 230 + 231 231 + .sequoia-comment-handle { 232 232 + font-size: 0.875rem; 233 233 + color: var(--sequoia-secondary-color, #6b7280); 234 234 + overflow: hidden; 235 235 + text-overflow: ellipsis; 236 236 + white-space: nowrap; 237 237 + } 238 238 + 239 239 + .sequoia-comment-time { 240 240 + font-size: 0.875rem; 241 241 + color: var(--sequoia-secondary-color, #6b7280); 242 242 + flex-shrink: 0; 243 243 + } 244 244 + 245 245 + .sequoia-comment-time::before { 246 246 + content: "·"; 247 247 + margin-right: 0.5rem; 248 248 + } 249 249 + 250 250 + .sequoia-comment-text { 251 251 + margin: 0; 252 252 + white-space: pre-wrap; 253 253 + word-wrap: break-word; 254 254 + } 255 255 + 256 256 + .sequoia-comment-text a { 257 257 + color: var(--sequoia-accent-color, #2563eb); 258 258 + text-decoration: none; 259 259 + } 260 260 + 261 261 + .sequoia-comment-text a:hover { 262 262 + text-decoration: underline; 263 263 + } 264 264 + 265 265 + .sequoia-bsky-logo { 266 266 + width: 1rem; 267 267 + height: 1rem; 268 268 + } 269 269 + `; 270 270 + 271 271 + // ============================================================================ 272 272 + // Utility Functions 273 273 + // ============================================================================ 274 274 + 275 275 + /** 276 276 + * Format a relative time string (e.g., "2 hours ago") 277 277 + * @param {string} dateString - ISO date string 278 278 + * @returns {string} Formatted relative time 279 279 + */ 280 280 + function formatRelativeTime(dateString) { 281 281 + const date = new Date(dateString); 282 282 + const now = new Date(); 283 283 + const diffMs = now.getTime() - date.getTime(); 284 284 + const diffSeconds = Math.floor(diffMs / 1000); 285 285 + const diffMinutes = Math.floor(diffSeconds / 60); 286 286 + const diffHours = Math.floor(diffMinutes / 60); 287 287 + const diffDays = Math.floor(diffHours / 24); 288 288 + const diffWeeks = Math.floor(diffDays / 7); 289 289 + const diffMonths = Math.floor(diffDays / 30); 290 290 + const diffYears = Math.floor(diffDays / 365); 291 291 + 292 292 + if (diffSeconds < 60) { 293 293 + return "just now"; 294 294 + } 295 295 + if (diffMinutes < 60) { 296 296 + return `${diffMinutes}m ago`; 297 297 + } 298 298 + if (diffHours < 24) { 299 299 + return `${diffHours}h ago`; 300 300 + } 301 301 + if (diffDays < 7) { 302 302 + return `${diffDays}d ago`; 303 303 + } 304 304 + if (diffWeeks < 4) { 305 305 + return `${diffWeeks}w ago`; 306 306 + } 307 307 + if (diffMonths < 12) { 308 308 + return `${diffMonths}mo ago`; 309 309 + } 310 310 + return `${diffYears}y ago`; 311 311 + } 312 312 + 313 313 + /** 314 314 + * Escape HTML special characters 315 315 + * @param {string} text - Text to escape 316 316 + * @returns {string} Escaped HTML 317 317 + */ 318 318 + function escapeHtml(text) { 319 319 + const div = document.createElement("div"); 320 320 + div.textContent = text; 321 321 + return div.innerHTML; 322 322 + } 323 323 + 324 324 + /** 325 325 + * Convert post text with facets to HTML 326 326 + * @param {string} text - Post text 327 327 + * @param {Array<{index: {byteStart: number, byteEnd: number}, features: Array<{$type: string, uri?: string, did?: string, tag?: string}>}>} [facets] - Rich text facets 328 328 + * @returns {string} HTML string with links 329 329 + */ 330 330 + function renderTextWithFacets(text, facets) { 331 331 + if (!facets || facets.length === 0) { 332 332 + return escapeHtml(text); 333 333 + } 334 334 + 335 335 + // Convert text to bytes for proper indexing 336 336 + const encoder = new TextEncoder(); 337 337 + const decoder = new TextDecoder(); 338 338 + const textBytes = encoder.encode(text); 339 339 + 340 340 + // Sort facets by start index 341 341 + const sortedFacets = [...facets].sort( 342 342 + (a, b) => a.index.byteStart - b.index.byteStart, 343 343 + ); 344 344 + 345 345 + let result = ""; 346 346 + let lastEnd = 0; 347 347 + 348 348 + for (const facet of sortedFacets) { 349 349 + const { byteStart, byteEnd } = facet.index; 350 350 + 351 351 + // Add text before this facet 352 352 + if (byteStart > lastEnd) { 353 353 + const beforeBytes = textBytes.slice(lastEnd, byteStart); 354 354 + result += escapeHtml(decoder.decode(beforeBytes)); 355 355 + } 356 356 + 357 357 + // Get the facet text 358 358 + const facetBytes = textBytes.slice(byteStart, byteEnd); 359 359 + const facetText = decoder.decode(facetBytes); 360 360 + 361 361 + // Find the first renderable feature 362 362 + const feature = facet.features[0]; 363 363 + if (feature) { 364 364 + if (feature.$type === "app.bsky.richtext.facet#link") { 365 365 + result += `<a href="${escapeHtml(feature.uri)}" target="_blank" rel="noopener noreferrer">${escapeHtml(facetText)}</a>`; 366 366 + } else if (feature.$type === "app.bsky.richtext.facet#mention") { 367 367 + result += `<a href="https://bsky.app/profile/${escapeHtml(feature.did)}" target="_blank" rel="noopener noreferrer">${escapeHtml(facetText)}</a>`; 368 368 + } else if (feature.$type === "app.bsky.richtext.facet#tag") { 369 369 + result += `<a href="https://bsky.app/hashtag/${escapeHtml(feature.tag)}" target="_blank" rel="noopener noreferrer">${escapeHtml(facetText)}</a>`; 370 370 + } else { 371 371 + result += escapeHtml(facetText); 372 372 + } 373 373 + } else { 374 374 + result += escapeHtml(facetText); 375 375 + } 376 376 + 377 377 + lastEnd = byteEnd; 378 378 + } 379 379 + 380 380 + // Add remaining text 381 381 + if (lastEnd < textBytes.length) { 382 382 + const remainingBytes = textBytes.slice(lastEnd); 383 383 + result += escapeHtml(decoder.decode(remainingBytes)); 384 384 + } 385 385 + 386 386 + return result; 387 387 + } 388 388 + 389 389 + /** 390 390 + * Get initials from a name for avatar placeholder 391 391 + * @param {string} name - Display name 392 392 + * @returns {string} Initials (1-2 characters) 393 393 + */ 394 394 + function getInitials(name) { 395 395 + const parts = name.trim().split(/\s+/); 396 396 + if (parts.length >= 2) { 397 397 + return (parts[0][0] + parts[1][0]).toUpperCase(); 398 398 + } 399 399 + return name.substring(0, 2).toUpperCase(); 400 400 + } 401 401 + 402 402 + // ============================================================================ 403 403 + // AT Protocol Client Functions 404 404 + // ============================================================================ 405 405 + 406 406 + /** 407 407 + * Parse an AT URI into its components 408 408 + * Format: at://did/collection/rkey 409 409 + * @param {string} atUri - AT Protocol URI 410 410 + * @returns {{did: string, collection: string, rkey: string} | null} Parsed components or null 411 411 + */ 412 412 + function parseAtUri(atUri) { 413 413 + const match = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/); 414 414 + if (!match) return null; 415 415 + return { 416 416 + did: match[1], 417 417 + collection: match[2], 418 418 + rkey: match[3], 419 419 + }; 420 420 + } 421 421 + 422 422 + /** 423 423 + * Resolve a DID to its PDS URL 424 424 + * Supports did:plc and did:web methods 425 425 + * @param {string} did - Decentralized Identifier 426 426 + * @returns {Promise<string>} PDS URL 427 427 + */ 428 428 + async function resolvePDS(did) { 429 429 + let pdsUrl; 430 430 + 431 431 + if (did.startsWith("did:plc:")) { 432 432 + // Fetch DID document from plc.directory 433 433 + const didDocUrl = `https://plc.directory/${did}`; 434 434 + const didDocResponse = await fetch(didDocUrl); 435 435 + if (!didDocResponse.ok) { 436 436 + throw new Error(`Could not fetch DID document: ${didDocResponse.status}`); 437 437 + } 438 438 + const didDoc = await didDocResponse.json(); 439 439 + 440 440 + // Find the PDS service endpoint 441 441 + const pdsService = didDoc.service?.find( 442 442 + (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 443 443 + ); 444 444 + pdsUrl = pdsService?.serviceEndpoint; 445 445 + } else if (did.startsWith("did:web:")) { 446 446 + // For did:web, fetch the DID document from the domain 447 447 + const domain = did.replace("did:web:", ""); 448 448 + const didDocUrl = `https://${domain}/.well-known/did.json`; 449 449 + const didDocResponse = await fetch(didDocUrl); 450 450 + if (!didDocResponse.ok) { 451 451 + throw new Error(`Could not fetch DID document: ${didDocResponse.status}`); 452 452 + } 453 453 + const didDoc = await didDocResponse.json(); 454 454 + 455 455 + const pdsService = didDoc.service?.find( 456 456 + (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 457 457 + ); 458 458 + pdsUrl = pdsService?.serviceEndpoint; 459 459 + } else { 460 460 + throw new Error(`Unsupported DID method: ${did}`); 461 461 + } 462 462 + 463 463 + if (!pdsUrl) { 464 464 + throw new Error("Could not find PDS URL for user"); 465 465 + } 466 466 + 467 467 + return pdsUrl; 468 468 + } 469 469 + 470 470 + /** 471 471 + * Fetch a record from a PDS using the public API 472 472 + * @param {string} did - DID of the repository owner 473 473 + * @param {string} collection - Collection name 474 474 + * @param {string} rkey - Record key 475 475 + * @returns {Promise<any>} Record value 476 476 + */ 477 477 + async function getRecord(did, collection, rkey) { 478 478 + const pdsUrl = await resolvePDS(did); 479 479 + 480 480 + const url = new URL(`${pdsUrl}/xrpc/com.atproto.repo.getRecord`); 481 481 + url.searchParams.set("repo", did); 482 482 + url.searchParams.set("collection", collection); 483 483 + url.searchParams.set("rkey", rkey); 484 484 + 485 485 + const response = await fetch(url.toString()); 486 486 + if (!response.ok) { 487 487 + throw new Error(`Failed to fetch record: ${response.status}`); 488 488 + } 489 489 + 490 490 + const data = await response.json(); 491 491 + return data.value; 492 492 + } 493 493 + 494 494 + /** 495 495 + * Fetch a document record from its AT URI 496 496 + * @param {string} atUri - AT Protocol URI for the document 497 497 + * @returns {Promise<{$type: string, title: string, site: string, path: string, textContent: string, publishedAt: string, canonicalUrl?: string, description?: string, tags?: string[], bskyPostRef?: {uri: string, cid: string}}>} Document record 498 498 + */ 499 499 + async function getDocument(atUri) { 500 500 + const parsed = parseAtUri(atUri); 501 501 + if (!parsed) { 502 502 + throw new Error(`Invalid AT URI: ${atUri}`); 503 503 + } 504 504 + 505 505 + return getRecord(parsed.did, parsed.collection, parsed.rkey); 506 506 + } 507 507 + 508 508 + /** 509 509 + * Fetch a post thread from the public Bluesky API 510 510 + * @param {string} postUri - AT Protocol URI for the post 511 511 + * @param {number} [depth=6] - Maximum depth of replies to fetch 512 512 + * @returns {Promise<ThreadViewPost>} Thread view post 513 513 + */ 514 514 + async function getPostThread(postUri, depth = 6) { 515 515 + const url = new URL( 516 516 + "https://public.api.bsky.app/xrpc/app.bsky.feed.getPostThread", 517 517 + ); 518 518 + url.searchParams.set("uri", postUri); 519 519 + url.searchParams.set("depth", depth.toString()); 520 520 + 521 521 + const response = await fetch(url.toString()); 522 522 + if (!response.ok) { 523 523 + throw new Error(`Failed to fetch post thread: ${response.status}`); 524 524 + } 525 525 + 526 526 + const data = await response.json(); 527 527 + 528 528 + if (data.thread.$type !== "app.bsky.feed.defs#threadViewPost") { 529 529 + throw new Error("Post not found or blocked"); 530 530 + } 531 531 + 532 532 + return data.thread; 533 533 + } 534 534 + 535 535 + /** 536 536 + * Build a Bluesky app URL for a post 537 537 + * @param {string} postUri - AT Protocol URI for the post 538 538 + * @returns {string} Bluesky app URL 539 539 + */ 540 540 + function buildBskyAppUrl(postUri) { 541 541 + const parsed = parseAtUri(postUri); 542 542 + if (!parsed) { 543 543 + throw new Error(`Invalid post URI: ${postUri}`); 544 544 + } 545 545 + 546 546 + return `https://bsky.app/profile/${parsed.did}/post/${parsed.rkey}`; 547 547 + } 548 548 + 549 549 + /** 550 550 + * Type guard for ThreadViewPost 551 551 + * @param {any} post - Post to check 552 552 + * @returns {boolean} True if post is a ThreadViewPost 553 553 + */ 554 554 + function isThreadViewPost(post) { 555 555 + return post?.$type === "app.bsky.feed.defs#threadViewPost"; 556 556 + } 557 557 + 558 558 + // ============================================================================ 559 559 + // Bluesky Icon 560 560 + // ============================================================================ 561 561 + 562 562 + const BLUESKY_ICON = `<svg class="sequoia-bsky-logo" viewBox="0 0 600 530" fill="currentColor" xmlns="http://www.w3.org/2000/svg"> 563 563 + <path d="m135.72 44.03c66.496 49.921 138.02 151.14 164.28 205.46 26.262-54.316 97.782-155.54 164.28-205.46 47.98-36.021 125.72-63.892 125.72 24.795 0 17.712-10.155 148.79-16.111 170.07-20.703 73.984-96.144 92.854-163.25 81.433 117.3 19.964 147.14 86.092 82.697 152.22-122.39 125.59-175.91-31.511-189.63-71.766-2.514-7.3797-3.6904-10.832-3.7077-7.8964-0.0174-2.9357-1.1937 0.51669-3.7077 7.8964-13.714 40.255-67.233 197.36-189.63 71.766-64.444-66.128-34.605-132.26 82.697-152.22-67.108 11.421-142.55-7.4491-163.25-81.433-5.9562-21.282-16.111-152.36-16.111-170.07 0-88.687 77.742-60.816 125.72-24.795z"/> 564 564 + </svg>`; 565 565 + 566 566 + // ============================================================================ 567 567 + // Web Component 568 568 + // ============================================================================ 569 569 + 570 570 + // SSR-safe base class - use HTMLElement in browser, empty class in Node.js 571 571 + const BaseElement = typeof HTMLElement !== "undefined" ? HTMLElement : class {}; 572 572 + 573 573 + class SequoiaComments extends BaseElement { 574 574 + constructor() { 575 575 + super(); 576 576 + this.shadow = this.attachShadow({ mode: "open" }); 577 577 + this.state = { type: "loading" }; 578 578 + this.abortController = null; 579 579 + } 580 580 + 581 581 + static get observedAttributes() { 582 582 + return ["document-uri", "depth"]; 583 583 + } 584 584 + 585 585 + connectedCallback() { 586 586 + this.render(); 587 587 + this.loadComments(); 588 588 + } 589 589 + 590 590 + disconnectedCallback() { 591 591 + this.abortController?.abort(); 592 592 + } 593 593 + 594 594 + attributeChangedCallback() { 595 595 + if (this.isConnected) { 596 596 + this.loadComments(); 597 597 + } 598 598 + } 599 599 + 600 600 + get documentUri() { 601 601 + // First check attribute 602 602 + const attrUri = this.getAttribute("document-uri"); 603 603 + if (attrUri) { 604 604 + return attrUri; 605 605 + } 606 606 + 607 607 + // Then scan for link tag in document head 608 608 + const linkTag = document.querySelector( 609 609 + 'link[rel="site.standard.document"]', 610 610 + ); 611 611 + return linkTag?.href ?? null; 612 612 + } 613 613 + 614 614 + get depth() { 615 615 + const depthAttr = this.getAttribute("depth"); 616 616 + return depthAttr ? parseInt(depthAttr, 10) : 6; 617 617 + } 618 618 + 619 619 + async loadComments() { 620 620 + // Cancel any in-flight request 621 621 + this.abortController?.abort(); 622 622 + this.abortController = new AbortController(); 623 623 + 624 624 + this.state = { type: "loading" }; 625 625 + this.render(); 626 626 + 627 627 + const docUri = this.documentUri; 628 628 + if (!docUri) { 629 629 + this.state = { type: "no-document" }; 630 630 + this.render(); 631 631 + return; 632 632 + } 633 633 + 634 634 + try { 635 635 + // Fetch the document record 636 636 + const document = await getDocument(docUri); 637 637 + 638 638 + // Check if document has a Bluesky post reference 639 639 + if (!document.bskyPostRef) { 640 640 + this.state = { type: "no-comments-enabled" }; 641 641 + this.render(); 642 642 + return; 643 643 + } 644 644 + 645 645 + const postUrl = buildBskyAppUrl(document.bskyPostRef.uri); 646 646 + 647 647 + // Fetch the post thread 648 648 + const thread = await getPostThread(document.bskyPostRef.uri, this.depth); 649 649 + 650 650 + // Check if there are any replies 651 651 + const replies = thread.replies?.filter(isThreadViewPost) ?? []; 652 652 + if (replies.length === 0) { 653 653 + this.state = { type: "empty", postUrl }; 654 654 + this.render(); 655 655 + return; 656 656 + } 657 657 + 658 658 + this.state = { type: "loaded", thread, postUrl }; 659 659 + this.render(); 660 660 + } catch (error) { 661 661 + const message = 662 662 + error instanceof Error ? error.message : "Failed to load comments"; 663 663 + this.state = { type: "error", message }; 664 664 + this.render(); 665 665 + } 666 666 + } 667 667 + 668 668 + render() { 669 669 + const styleTag = `<style>${styles}</style>`; 670 670 + 671 671 + switch (this.state.type) { 672 672 + case "loading": 673 673 + this.shadow.innerHTML = ` 674 674 + ${styleTag} 675 675 + <div class="sequoia-comments-container"> 676 676 + <div class="sequoia-loading"> 677 677 + <span class="sequoia-loading-spinner"></span> 678 678 + Loading comments... 679 679 + </div> 680 680 + </div> 681 681 + `; 682 682 + break; 683 683 + 684 684 + case "no-document": 685 685 + this.shadow.innerHTML = ` 686 686 + ${styleTag} 687 687 + <div class="sequoia-comments-container"> 688 688 + <div class="sequoia-warning"> 689 689 + No document found. Add a <code>&lt;link rel="site.standard.document" href="at://..."&gt;</code> tag to your page. 690 690 + </div> 691 691 + </div> 692 692 + `; 693 693 + break; 694 694 + 695 695 + case "no-comments-enabled": 696 696 + this.shadow.innerHTML = ` 697 697 + ${styleTag} 698 698 + <div class="sequoia-comments-container"> 699 699 + <div class="sequoia-empty"> 700 700 + Comments are not enabled for this post. 701 701 + </div> 702 702 + </div> 703 703 + `; 704 704 + break; 705 705 + 706 706 + case "empty": 707 707 + this.shadow.innerHTML = ` 708 708 + ${styleTag} 709 709 + <div class="sequoia-comments-container"> 710 710 + <div class="sequoia-comments-header"> 711 711 + <h3 class="sequoia-comments-title">Comments</h3> 712 712 + <a href="${this.state.postUrl}" target="_blank" rel="noopener noreferrer" class="sequoia-reply-button"> 713 713 + ${BLUESKY_ICON} 714 714 + Reply on Bluesky 715 715 + </a> 716 716 + </div> 717 717 + <div class="sequoia-empty"> 718 718 + No comments yet. Be the first to reply on Bluesky! 719 719 + </div> 720 720 + </div> 721 721 + `; 722 722 + break; 723 723 + 724 724 + case "error": 725 725 + this.shadow.innerHTML = ` 726 726 + ${styleTag} 727 727 + <div class="sequoia-comments-container"> 728 728 + <div class="sequoia-error"> 729 729 + Failed to load comments: ${escapeHtml(this.state.message)} 730 730 + </div> 731 731 + </div> 732 732 + `; 733 733 + break; 734 734 + 735 735 + case "loaded": { 736 736 + const replies = 737 737 + this.state.thread.replies?.filter(isThreadViewPost) ?? []; 738 738 + const threadsHtml = replies 739 739 + .map((reply) => this.renderThread(reply)) 740 740 + .join(""); 741 741 + const commentCount = this.countComments(replies); 742 742 + 743 743 + this.shadow.innerHTML = ` 744 744 + ${styleTag} 745 745 + <div class="sequoia-comments-container"> 746 746 + <div class="sequoia-comments-header"> 747 747 + <h3 class="sequoia-comments-title">${commentCount} Comment${commentCount !== 1 ? "s" : ""}</h3> 748 748 + <a href="${this.state.postUrl}" target="_blank" rel="noopener noreferrer" class="sequoia-reply-button"> 749 749 + ${BLUESKY_ICON} 750 750 + Reply on Bluesky 751 751 + </a> 752 752 + </div> 753 753 + <div class="sequoia-comments-list"> 754 754 + ${threadsHtml} 755 755 + </div> 756 756 + </div> 757 757 + `; 758 758 + break; 759 759 + } 760 760 + } 761 761 + } 762 762 + 763 763 + /** 764 764 + * Flatten a thread into a linear list of comments 765 765 + * @param {ThreadViewPost} thread - Thread to flatten 766 766 + * @returns {Array<{post: any, hasMoreReplies: boolean}>} Flattened comments 767 767 + */ 768 768 + flattenThread(thread) { 769 769 + const result = []; 770 770 + const nestedReplies = thread.replies?.filter(isThreadViewPost) ?? []; 771 771 + 772 772 + result.push({ 773 773 + post: thread.post, 774 774 + hasMoreReplies: nestedReplies.length > 0, 775 775 + }); 776 776 + 777 777 + // Recursively flatten nested replies 778 778 + for (const reply of nestedReplies) { 779 779 + result.push(...this.flattenThread(reply)); 780 780 + } 781 781 + 782 782 + return result; 783 783 + } 784 784 + 785 785 + /** 786 786 + * Render a complete thread (top-level comment + all nested replies) 787 787 + */ 788 788 + renderThread(thread) { 789 789 + const flatComments = this.flattenThread(thread); 790 790 + const commentsHtml = flatComments 791 791 + .map((item, index) => 792 792 + this.renderComment(item.post, item.hasMoreReplies, index), 793 793 + ) 794 794 + .join(""); 795 795 + 796 796 + return `<div class="sequoia-thread">${commentsHtml}</div>`; 797 797 + } 798 798 + 799 799 + /** 800 800 + * Render a single comment 801 801 + * @param {any} post - Post data 802 802 + * @param {boolean} showThreadLine - Whether to show the connecting thread line 803 803 + * @param {number} _index - Index in the flattened thread (0 = top-level) 804 804 + */ 805 805 + renderComment(post, showThreadLine = false, _index = 0) { 806 806 + const author = post.author; 807 807 + const displayName = author.displayName || author.handle; 808 808 + const avatarHtml = author.avatar 809 809 + ? `<img class="sequoia-comment-avatar" src="${escapeHtml(author.avatar)}" alt="${escapeHtml(displayName)}" loading="lazy" />` 810 810 + : `<div class="sequoia-comment-avatar-placeholder">${getInitials(displayName)}</div>`; 811 811 + 812 812 + const profileUrl = `https://bsky.app/profile/${author.did}`; 813 813 + const textHtml = renderTextWithFacets(post.record.text, post.record.facets); 814 814 + const timeAgo = formatRelativeTime(post.record.createdAt); 815 815 + const threadLineHtml = showThreadLine 816 816 + ? '<div class="sequoia-thread-line"></div>' 817 817 + : ""; 818 818 + 819 819 + return ` 820 820 + <div class="sequoia-comment"> 821 821 + <div class="sequoia-comment-avatar-column"> 822 822 + ${avatarHtml} 823 823 + ${threadLineHtml} 824 824 + </div> 825 825 + <div class="sequoia-comment-content"> 826 826 + <div class="sequoia-comment-header"> 827 827 + <a href="${profileUrl}" target="_blank" rel="noopener noreferrer" class="sequoia-comment-author"> 828 828 + ${escapeHtml(displayName)} 829 829 + </a> 830 830 + <span class="sequoia-comment-handle">@${escapeHtml(author.handle)}</span> 831 831 + <span class="sequoia-comment-time">${timeAgo}</span> 832 832 + </div> 833 833 + <p class="sequoia-comment-text">${textHtml}</p> 834 834 + </div> 835 835 + </div> 836 836 + `; 837 837 + } 838 838 + 839 839 + countComments(replies) { 840 840 + let count = 0; 841 841 + for (const reply of replies) { 842 842 + count += 1; 843 843 + const nested = reply.replies?.filter(isThreadViewPost) ?? []; 844 844 + count += this.countComments(nested); 845 845 + } 846 846 + return count; 847 847 + } 848 848 + } 849 849 + 850 850 + // Register the custom element 851 851 + if (typeof customElements !== "undefined") { 852 852 + customElements.define("sequoia-comments", SequoiaComments); 853 853 + } 854 854 + 855 855 + // Export for module usage 856 856 + export { SequoiaComments };

+7 -1

packages/cli/src/index.ts

··· 1 1 #!/usr/bin/env node 2 2 3 3 import { run, subcommands } from "cmd-ts"; 4 4 + import { addCommand } from "./commands/add"; 4 5 import { authCommand } from "./commands/auth"; 5 6 import { initCommand } from "./commands/init"; 6 7 import { injectCommand } from "./commands/inject"; 8 8 + import { loginCommand } from "./commands/login"; 7 9 import { publishCommand } from "./commands/publish"; 8 10 import { syncCommand } from "./commands/sync"; 11 11 + import { updateCommand } from "./commands/update"; 9 12 10 13 const app = subcommands({ 11 14 name: "sequoia", ··· 33 36 34 37 > https://tangled.org/stevedylan.dev/sequoia 35 38 `, 36 36 - version: "0.1.1", 39 39 + version: "0.4.0", 37 40 cmds: { 41 41 + add: addCommand, 38 42 auth: authCommand, 39 43 init: initCommand, 40 44 inject: injectCommand, 45 45 + login: loginCommand, 41 46 publish: publishCommand, 42 47 sync: syncCommand, 48 48 + update: updateCommand, 43 49 }, 44 50 }); 45 51

+661 -270

packages/cli/src/lib/atproto.ts

··· 1 1 - import { AtpAgent } from "@atproto/api"; 2 2 - import * as fs from "fs/promises"; 3 3 - import * as path from "path"; 1 1 + import { Agent, AtpAgent } from "@atproto/api"; 4 2 import * as mimeTypes from "mime-types"; 5 5 - import type { Credentials, BlogPost, BlobObject, PublisherConfig } from "./types"; 3 3 + import * as fs from "node:fs/promises"; 4 4 + import * as path from "node:path"; 6 5 import { stripMarkdownForText } from "./markdown"; 6 6 + import { getOAuthClient } from "./oauth-client"; 7 7 + import type { 8 8 + BlobObject, 9 9 + BlogPost, 10 10 + Credentials, 11 11 + PublicationRecord, 12 12 + PublisherConfig, 13 13 + StrongRef, 14 14 + } from "./types"; 15 15 + import { isAppPasswordCredentials, isOAuthCredentials } from "./types"; 16 16 + 17 17 + /** 18 18 + * Type guard to check if a record value is a DocumentRecord 19 19 + */ 20 20 + function isDocumentRecord(value: unknown): value is DocumentRecord { 21 21 + if (!value || typeof value !== "object") return false; 22 22 + const v = value as Record<string, unknown>; 23 23 + return ( 24 24 + v.$type === "site.standard.document" && 25 25 + typeof v.title === "string" && 26 26 + typeof v.site === "string" && 27 27 + typeof v.path === "string" && 28 28 + typeof v.textContent === "string" && 29 29 + typeof v.publishedAt === "string" 30 30 + ); 31 31 + } 7 32 8 33 async function fileExists(filePath: string): Promise<boolean> { 9 9 - try { 10 10 - await fs.access(filePath); 11 11 - return true; 12 12 - } catch { 13 13 - return false; 14 14 - } 34 34 + try { 35 35 + await fs.access(filePath); 36 36 + return true; 37 37 + } catch { 38 38 + return false; 39 39 + } 40 40 + } 41 41 + 42 42 + /** 43 43 + * Resolve a handle to a DID 44 44 + */ 45 45 + export async function resolveHandleToDid(handle: string): Promise<string> { 46 46 + if (handle.startsWith("did:")) { 47 47 + return handle; 48 48 + } 49 49 + 50 50 + // Try to resolve handle via Bluesky API 51 51 + const resolveUrl = `https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=${encodeURIComponent(handle)}`; 52 52 + const resolveResponse = await fetch(resolveUrl); 53 53 + if (!resolveResponse.ok) { 54 54 + throw new Error("Could not resolve handle"); 55 55 + } 56 56 + const resolveData = (await resolveResponse.json()) as { did: string }; 57 57 + return resolveData.did; 15 58 } 16 59 17 60 export async function resolveHandleToPDS(handle: string): Promise<string> { 18 18 - // First, resolve the handle to a DID 19 19 - let did: string; 61 61 + // First, resolve the handle to a DID 62 62 + const did = await resolveHandleToDid(handle); 20 63 21 21 - if (handle.startsWith("did:")) { 22 22 - did = handle; 23 23 - } else { 24 24 - // Try to resolve handle via Bluesky API 25 25 - const resolveUrl = `https://public.api.bsky.app/xrpc/com.atproto.identity.resolveHandle?handle=${encodeURIComponent(handle)}`; 26 26 - const resolveResponse = await fetch(resolveUrl); 27 27 - if (!resolveResponse.ok) { 28 28 - throw new Error("Could not resolve handle"); 29 29 - } 30 30 - const resolveData = (await resolveResponse.json()) as { did: string }; 31 31 - did = resolveData.did; 32 32 - } 64 64 + // Now resolve the DID to get the PDS URL from the DID document 65 65 + let pdsUrl: string | undefined; 33 66 34 34 - // Now resolve the DID to get the PDS URL from the DID document 35 35 - let pdsUrl: string | undefined; 67 67 + if (did.startsWith("did:plc:")) { 68 68 + // Fetch DID document from plc.directory 69 69 + const didDocUrl = `https://plc.directory/${did}`; 70 70 + const didDocResponse = await fetch(didDocUrl); 71 71 + if (!didDocResponse.ok) { 72 72 + throw new Error("Could not fetch DID document"); 73 73 + } 74 74 + const didDoc = (await didDocResponse.json()) as { 75 75 + service?: Array<{ id: string; type: string; serviceEndpoint: string }>; 76 76 + }; 36 77 37 37 - if (did.startsWith("did:plc:")) { 38 38 - // Fetch DID document from plc.directory 39 39 - const didDocUrl = `https://plc.directory/${did}`; 40 40 - const didDocResponse = await fetch(didDocUrl); 41 41 - if (!didDocResponse.ok) { 42 42 - throw new Error("Could not fetch DID document"); 43 43 - } 44 44 - const didDoc = (await didDocResponse.json()) as { 45 45 - service?: Array<{ id: string; type: string; serviceEndpoint: string }>; 46 46 - }; 78 78 + // Find the PDS service endpoint 79 79 + const pdsService = didDoc.service?.find( 80 80 + (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 81 81 + ); 82 82 + pdsUrl = pdsService?.serviceEndpoint; 83 83 + } else if (did.startsWith("did:web:")) { 84 84 + // For did:web, fetch the DID document from the domain 85 85 + const domain = did.replace("did:web:", ""); 86 86 + const didDocUrl = `https://${domain}/.well-known/did.json`; 87 87 + const didDocResponse = await fetch(didDocUrl); 88 88 + if (!didDocResponse.ok) { 89 89 + throw new Error("Could not fetch DID document"); 90 90 + } 91 91 + const didDoc = (await didDocResponse.json()) as { 92 92 + service?: Array<{ id: string; type: string; serviceEndpoint: string }>; 93 93 + }; 47 94 48 48 - // Find the PDS service endpoint 49 49 - const pdsService = didDoc.service?.find( 50 50 - (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 51 51 - ); 52 52 - pdsUrl = pdsService?.serviceEndpoint; 53 53 - } else if (did.startsWith("did:web:")) { 54 54 - // For did:web, fetch the DID document from the domain 55 55 - const domain = did.replace("did:web:", ""); 56 56 - const didDocUrl = `https://${domain}/.well-known/did.json`; 57 57 - const didDocResponse = await fetch(didDocUrl); 58 58 - if (!didDocResponse.ok) { 59 59 - throw new Error("Could not fetch DID document"); 60 60 - } 61 61 - const didDoc = (await didDocResponse.json()) as { 62 62 - service?: Array<{ id: string; type: string; serviceEndpoint: string }>; 63 63 - }; 64 64 - 65 65 - const pdsService = didDoc.service?.find( 66 66 - (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 67 67 - ); 68 68 - pdsUrl = pdsService?.serviceEndpoint; 69 69 - } 95 95 + const pdsService = didDoc.service?.find( 96 96 + (s) => s.id === "#atproto_pds" || s.type === "AtprotoPersonalDataServer", 97 97 + ); 98 98 + pdsUrl = pdsService?.serviceEndpoint; 99 99 + } 70 100 71 71 - if (!pdsUrl) { 72 72 - throw new Error("Could not find PDS URL for user"); 73 73 - } 101 101 + if (!pdsUrl) { 102 102 + throw new Error("Could not find PDS URL for user"); 103 103 + } 74 104 75 75 - return pdsUrl; 105 105 + return pdsUrl; 76 106 } 77 107 78 108 export interface CreatePublicationOptions { 79 79 - url: string; 80 80 - name: string; 81 81 - description?: string; 82 82 - iconPath?: string; 83 83 - showInDiscover?: boolean; 109 109 + url: string; 110 110 + name: string; 111 111 + description?: string; 112 112 + iconPath?: string; 113 113 + showInDiscover?: boolean; 84 114 } 85 115 86 86 - export async function createAgent(credentials: Credentials): Promise<AtpAgent> { 87 87 - const agent = new AtpAgent({ service: credentials.pdsUrl }); 116 116 + export async function createAgent(credentials: Credentials): Promise<Agent> { 117 117 + if (isOAuthCredentials(credentials)) { 118 118 + // OAuth flow - restore session from stored tokens 119 119 + const client = await getOAuthClient(); 120 120 + try { 121 121 + const oauthSession = await client.restore(credentials.did); 122 122 + // Wrap the OAuth session in an Agent which provides the atproto API 123 123 + return new Agent(oauthSession); 124 124 + } catch (error) { 125 125 + if (error instanceof Error) { 126 126 + // Check for common OAuth errors 127 127 + if ( 128 128 + error.message.includes("expired") || 129 129 + error.message.includes("revoked") 130 130 + ) { 131 131 + throw new Error( 132 132 + `OAuth session expired or revoked. Please run 'sequoia login' to re-authenticate.`, 133 133 + ); 134 134 + } 135 135 + } 136 136 + throw error; 137 137 + } 138 138 + } 88 139 89 89 - await agent.login({ 90 90 - identifier: credentials.identifier, 91 91 - password: credentials.password, 92 92 - }); 140 140 + // App password flow 141 141 + if (!isAppPasswordCredentials(credentials)) { 142 142 + throw new Error("Invalid credential type"); 143 143 + } 144 144 + const agent = new AtpAgent({ service: credentials.pdsUrl }); 93 145 94 94 - return agent; 146 146 + await agent.login({ 147 147 + identifier: credentials.identifier, 148 148 + password: credentials.password, 149 149 + }); 150 150 + 151 151 + return agent; 95 152 } 96 153 97 154 export async function uploadImage( 98 98 - agent: AtpAgent, 99 99 - imagePath: string 155 155 + agent: Agent, 156 156 + imagePath: string, 100 157 ): Promise<BlobObject | undefined> { 101 101 - if (!(await fileExists(imagePath))) { 102 102 - return undefined; 103 103 - } 158 158 + if (!(await fileExists(imagePath))) { 159 159 + return undefined; 160 160 + } 104 161 105 105 - try { 106 106 - const imageBuffer = await fs.readFile(imagePath); 107 107 - const mimeType = mimeTypes.lookup(imagePath) || "application/octet-stream"; 162 162 + try { 163 163 + const imageBuffer = await fs.readFile(imagePath); 164 164 + const mimeType = mimeTypes.lookup(imagePath) || "application/octet-stream"; 108 165 109 109 - const response = await agent.com.atproto.repo.uploadBlob( 110 110 - new Uint8Array(imageBuffer), 111 111 - { 112 112 - encoding: mimeType, 113 113 - } 114 114 - ); 166 166 + const response = await agent.com.atproto.repo.uploadBlob( 167 167 + new Uint8Array(imageBuffer), 168 168 + { 169 169 + encoding: mimeType, 170 170 + }, 171 171 + ); 115 172 116 116 - return { 117 117 - $type: "blob", 118 118 - ref: { 119 119 - $link: response.data.blob.ref.toString(), 120 120 - }, 121 121 - mimeType, 122 122 - size: imageBuffer.byteLength, 123 123 - }; 124 124 - } catch (error) { 125 125 - console.error(`Error uploading image ${imagePath}:`, error); 126 126 - return undefined; 127 127 - } 173 173 + return { 174 174 + $type: "blob", 175 175 + ref: { 176 176 + $link: response.data.blob.ref.toString(), 177 177 + }, 178 178 + mimeType, 179 179 + size: imageBuffer.byteLength, 180 180 + }; 181 181 + } catch (error) { 182 182 + console.error(`Error uploading image ${imagePath}:`, error); 183 183 + return undefined; 184 184 + } 128 185 } 129 186 130 187 export async function resolveImagePath( 131 131 - ogImage: string, 132 132 - imagesDir: string | undefined, 133 133 - contentDir: string 188 188 + ogImage: string, 189 189 + imagesDir: string | undefined, 190 190 + contentDir: string, 134 191 ): Promise<string | null> { 135 135 - // Try multiple resolution strategies 136 136 - const filename = path.basename(ogImage); 192 192 + // Try multiple resolution strategies 193 193 + 194 194 + // 1. If imagesDir is specified, look there 195 195 + if (imagesDir) { 196 196 + // Get the base name of the images directory (e.g., "blog-images" from "public/blog-images") 197 197 + const imagesDirBaseName = path.basename(imagesDir); 198 198 + 199 199 + // Check if ogImage contains the images directory name and extract the relative path 200 200 + // e.g., "/blog-images/other/file.png" with imagesDirBaseName "blog-images" -> "other/file.png" 201 201 + const imagesDirIndex = ogImage.indexOf(imagesDirBaseName); 202 202 + let relativePath: string; 203 203 + 204 204 + if (imagesDirIndex !== -1) { 205 205 + // Extract everything after "blog-images/" 206 206 + const afterImagesDir = ogImage.substring( 207 207 + imagesDirIndex + imagesDirBaseName.length, 208 208 + ); 209 209 + // Remove leading slash if present 210 210 + relativePath = afterImagesDir.replace(/^[/\\]/, ""); 211 211 + } else { 212 212 + // Fall back to just the filename 213 213 + relativePath = path.basename(ogImage); 214 214 + } 137 215 138 138 - // 1. If imagesDir is specified, look there 139 139 - if (imagesDir) { 140 140 - const imagePath = path.join(imagesDir, filename); 141 141 - if (await fileExists(imagePath)) { 142 142 - const stat = await fs.stat(imagePath); 143 143 - if (stat.size > 0) { 144 144 - return imagePath; 145 145 - } 146 146 - } 147 147 - } 216 216 + const imagePath = path.join(imagesDir, relativePath); 217 217 + if (await fileExists(imagePath)) { 218 218 + const stat = await fs.stat(imagePath); 219 219 + if (stat.size > 0) { 220 220 + return imagePath; 221 221 + } 222 222 + } 223 223 + } 148 224 149 149 - // 2. Try the ogImage path directly (if it's absolute) 150 150 - if (path.isAbsolute(ogImage)) { 151 151 - return ogImage; 152 152 - } 225 225 + // 2. Try the ogImage path directly (if it's absolute) 226 226 + if (path.isAbsolute(ogImage)) { 227 227 + return ogImage; 228 228 + } 153 229 154 154 - // 3. Try relative to content directory 155 155 - const contentRelative = path.join(contentDir, ogImage); 156 156 - if (await fileExists(contentRelative)) { 157 157 - const stat = await fs.stat(contentRelative); 158 158 - if (stat.size > 0) { 159 159 - return contentRelative; 160 160 - } 161 161 - } 230 230 + // 3. Try relative to content directory 231 231 + const contentRelative = path.join(contentDir, ogImage); 232 232 + if (await fileExists(contentRelative)) { 233 233 + const stat = await fs.stat(contentRelative); 234 234 + if (stat.size > 0) { 235 235 + return contentRelative; 236 236 + } 237 237 + } 162 238 163 163 - return null; 239 239 + return null; 164 240 } 165 241 166 242 export async function createDocument( 167 167 - agent: AtpAgent, 168 168 - post: BlogPost, 169 169 - config: PublisherConfig, 170 170 - coverImage?: BlobObject 243 243 + agent: Agent, 244 244 + post: BlogPost, 245 245 + config: PublisherConfig, 246 246 + coverImage?: BlobObject, 171 247 ): Promise<string> { 172 172 - const pathPrefix = config.pathPrefix || "/posts"; 173 173 - const postPath = `${pathPrefix}/${post.slug}`; 174 174 - const textContent = stripMarkdownForText(post.content); 175 175 - const publishDate = new Date(post.frontmatter.publishDate); 248 248 + const pathPrefix = config.pathPrefix || "/posts"; 249 249 + const postPath = `${pathPrefix}/${post.slug}`; 250 250 + const publishDate = new Date(post.frontmatter.publishDate); 251 251 + 252 252 + // Determine textContent: use configured field from frontmatter, or fallback to markdown body 253 253 + let textContent: string; 254 254 + if ( 255 255 + config.textContentField && 256 256 + post.rawFrontmatter?.[config.textContentField] 257 257 + ) { 258 258 + textContent = String(post.rawFrontmatter[config.textContentField]); 259 259 + } else { 260 260 + textContent = stripMarkdownForText(post.content); 261 261 + } 176 262 177 177 - const record: Record<string, unknown> = { 178 178 - $type: "site.standard.document", 179 179 - title: post.frontmatter.title, 180 180 - site: config.publicationUri, 181 181 - path: postPath, 182 182 - textContent: textContent.slice(0, 10000), 183 183 - publishedAt: publishDate.toISOString(), 184 184 - canonicalUrl: `${config.siteUrl}${postPath}`, 185 185 - }; 263 263 + const record: Record<string, unknown> = { 264 264 + $type: "site.standard.document", 265 265 + title: post.frontmatter.title, 266 266 + site: config.publicationUri, 267 267 + path: postPath, 268 268 + textContent: textContent.slice(0, 10000), 269 269 + publishedAt: publishDate.toISOString(), 270 270 + canonicalUrl: `${config.siteUrl}${postPath}`, 271 271 + }; 186 272 187 187 - if (coverImage) { 188 188 - record.coverImage = coverImage; 189 189 - } 273 273 + if (post.frontmatter.description) { 274 274 + record.description = post.frontmatter.description; 275 275 + } 190 276 191 191 - if (post.frontmatter.tags && post.frontmatter.tags.length > 0) { 192 192 - record.tags = post.frontmatter.tags; 193 193 - } 277 277 + if (coverImage) { 278 278 + record.coverImage = coverImage; 279 279 + } 280 280 + 281 281 + if (post.frontmatter.tags && post.frontmatter.tags.length > 0) { 282 282 + record.tags = post.frontmatter.tags; 283 283 + } 194 284 195 195 - const response = await agent.com.atproto.repo.createRecord({ 196 196 - repo: agent.session!.did, 197 197 - collection: "site.standard.document", 198 198 - record, 199 199 - }); 285 285 + const response = await agent.com.atproto.repo.createRecord({ 286 286 + repo: agent.did!, 287 287 + collection: "site.standard.document", 288 288 + record, 289 289 + }); 200 290 201 201 - return response.data.uri; 291 291 + return response.data.uri; 202 292 } 203 293 204 294 export async function updateDocument( 205 205 - agent: AtpAgent, 206 206 - post: BlogPost, 207 207 - atUri: string, 208 208 - config: PublisherConfig, 209 209 - coverImage?: BlobObject 295 295 + agent: Agent, 296 296 + post: BlogPost, 297 297 + atUri: string, 298 298 + config: PublisherConfig, 299 299 + coverImage?: BlobObject, 210 300 ): Promise<void> { 211 211 - // Parse the atUri to get the collection and rkey 212 212 - // Format: at://did:plc:xxx/collection/rkey 213 213 - const uriMatch = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/); 214 214 - if (!uriMatch) { 215 215 - throw new Error(`Invalid atUri format: ${atUri}`); 216 216 - } 301 301 + // Parse the atUri to get the collection and rkey 302 302 + // Format: at://did:plc:xxx/collection/rkey 303 303 + const uriMatch = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/); 304 304 + if (!uriMatch) { 305 305 + throw new Error(`Invalid atUri format: ${atUri}`); 306 306 + } 217 307 218 218 - const [, , collection, rkey] = uriMatch; 308 308 + const [, , collection, rkey] = uriMatch; 219 309 220 220 - const pathPrefix = config.pathPrefix || "/posts"; 221 221 - const postPath = `${pathPrefix}/${post.slug}`; 222 222 - const textContent = stripMarkdownForText(post.content); 223 223 - const publishDate = new Date(post.frontmatter.publishDate); 310 310 + const pathPrefix = config.pathPrefix || "/posts"; 311 311 + const postPath = `${pathPrefix}/${post.slug}`; 312 312 + const publishDate = new Date(post.frontmatter.publishDate); 224 313 225 225 - const record: Record<string, unknown> = { 226 226 - $type: "site.standard.document", 227 227 - title: post.frontmatter.title, 228 228 - site: config.publicationUri, 229 229 - path: postPath, 230 230 - textContent: textContent.slice(0, 10000), 231 231 - publishedAt: publishDate.toISOString(), 232 232 - canonicalUrl: `${config.siteUrl}${postPath}`, 233 233 - }; 314 314 + // Determine textContent: use configured field from frontmatter, or fallback to markdown body 315 315 + let textContent: string; 316 316 + if ( 317 317 + config.textContentField && 318 318 + post.rawFrontmatter?.[config.textContentField] 319 319 + ) { 320 320 + textContent = String(post.rawFrontmatter[config.textContentField]); 321 321 + } else { 322 322 + textContent = stripMarkdownForText(post.content); 323 323 + } 324 324 + 325 325 + const record: Record<string, unknown> = { 326 326 + $type: "site.standard.document", 327 327 + title: post.frontmatter.title, 328 328 + site: config.publicationUri, 329 329 + path: postPath, 330 330 + textContent: textContent.slice(0, 10000), 331 331 + publishedAt: publishDate.toISOString(), 332 332 + canonicalUrl: `${config.siteUrl}${postPath}`, 333 333 + }; 334 334 + 335 335 + if (post.frontmatter.description) { 336 336 + record.description = post.frontmatter.description; 337 337 + } 234 338 235 235 - if (coverImage) { 236 236 - record.coverImage = coverImage; 237 237 - } 339 339 + if (coverImage) { 340 340 + record.coverImage = coverImage; 341 341 + } 238 342 239 239 - if (post.frontmatter.tags && post.frontmatter.tags.length > 0) { 240 240 - record.tags = post.frontmatter.tags; 241 241 - } 343 343 + if (post.frontmatter.tags && post.frontmatter.tags.length > 0) { 344 344 + record.tags = post.frontmatter.tags; 345 345 + } 242 346 243 243 - await agent.com.atproto.repo.putRecord({ 244 244 - repo: agent.session!.did, 245 245 - collection: collection!, 246 246 - rkey: rkey!, 247 247 - record, 248 248 - }); 347 347 + await agent.com.atproto.repo.putRecord({ 348 348 + repo: agent.did!, 349 349 + collection: collection!, 350 350 + rkey: rkey!, 351 351 + record, 352 352 + }); 249 353 } 250 354 251 251 - export function parseAtUri(atUri: string): { did: string; collection: string; rkey: string } | null { 252 252 - const match = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/); 253 253 - if (!match) return null; 254 254 - return { 255 255 - did: match[1]!, 256 256 - collection: match[2]!, 257 257 - rkey: match[3]!, 258 258 - }; 355 355 + export function parseAtUri( 356 356 + atUri: string, 357 357 + ): { did: string; collection: string; rkey: string } | null { 358 358 + const match = atUri.match(/^at:\/\/([^/]+)\/([^/]+)\/(.+)$/); 359 359 + if (!match) return null; 360 360 + return { 361 361 + did: match[1]!, 362 362 + collection: match[2]!, 363 363 + rkey: match[3]!, 364 364 + }; 259 365 } 260 366 261 367 export interface DocumentRecord { 262 262 - $type: "site.standard.document"; 263 263 - title: string; 264 264 - site: string; 265 265 - path: string; 266 266 - textContent: string; 267 267 - publishedAt: string; 268 268 - canonicalUrl?: string; 269 269 - coverImage?: BlobObject; 270 270 - tags?: string[]; 271 271 - location?: string; 368 368 + $type: "site.standard.document"; 369 369 + title: string; 370 370 + site: string; 371 371 + path: string; 372 372 + textContent: string; 373 373 + publishedAt: string; 374 374 + canonicalUrl?: string; 375 375 + description?: string; 376 376 + coverImage?: BlobObject; 377 377 + tags?: string[]; 378 378 + location?: string; 272 379 } 273 380 274 381 export interface ListDocumentsResult { 275 275 - uri: string; 276 276 - cid: string; 277 277 - value: DocumentRecord; 382 382 + uri: string; 383 383 + cid: string; 384 384 + value: DocumentRecord; 278 385 } 279 386 280 387 export async function listDocuments( 281 281 - agent: AtpAgent, 282 282 - publicationUri?: string 388 388 + agent: Agent, 389 389 + publicationUri?: string, 283 390 ): Promise<ListDocumentsResult[]> { 284 284 - const documents: ListDocumentsResult[] = []; 285 285 - let cursor: string | undefined; 391 391 + const documents: ListDocumentsResult[] = []; 392 392 + let cursor: string | undefined; 286 393 287 287 - do { 288 288 - const response = await agent.com.atproto.repo.listRecords({ 289 289 - repo: agent.session!.did, 290 290 - collection: "site.standard.document", 291 291 - limit: 100, 292 292 - cursor, 293 293 - }); 394 394 + do { 395 395 + const response = await agent.com.atproto.repo.listRecords({ 396 396 + repo: agent.did!, 397 397 + collection: "site.standard.document", 398 398 + limit: 100, 399 399 + cursor, 400 400 + }); 294 401 295 295 - for (const record of response.data.records) { 296 296 - const value = record.value as unknown as DocumentRecord; 402 402 + for (const record of response.data.records) { 403 403 + if (!isDocumentRecord(record.value)) { 404 404 + continue; 405 405 + } 297 406 298 298 - // If publicationUri is specified, only include documents from that publication 299 299 - if (publicationUri && value.site !== publicationUri) { 300 300 - continue; 301 301 - } 407 407 + // If publicationUri is specified, only include documents from that publication 408 408 + if (publicationUri && record.value.site !== publicationUri) { 409 409 + continue; 410 410 + } 302 411 303 303 - documents.push({ 304 304 - uri: record.uri, 305 305 - cid: record.cid, 306 306 - value, 307 307 - }); 308 308 - } 412 412 + documents.push({ 413 413 + uri: record.uri, 414 414 + cid: record.cid, 415 415 + value: record.value, 416 416 + }); 417 417 + } 309 418 310 310 - cursor = response.data.cursor; 311 311 - } while (cursor); 419 419 + cursor = response.data.cursor; 420 420 + } while (cursor); 312 421 313 313 - return documents; 422 422 + return documents; 314 423 } 315 424 316 425 export async function createPublication( 317 317 - agent: AtpAgent, 318 318 - options: CreatePublicationOptions 426 426 + agent: Agent, 427 427 + options: CreatePublicationOptions, 319 428 ): Promise<string> { 320 320 - let icon: BlobObject | undefined; 429 429 + let icon: BlobObject | undefined; 430 430 + 431 431 + if (options.iconPath) { 432 432 + icon = await uploadImage(agent, options.iconPath); 433 433 + } 434 434 + 435 435 + const record: Record<string, unknown> = { 436 436 + $type: "site.standard.publication", 437 437 + url: options.url, 438 438 + name: options.name, 439 439 + createdAt: new Date().toISOString(), 440 440 + }; 441 441 + 442 442 + if (options.description) { 443 443 + record.description = options.description; 444 444 + } 445 445 + 446 446 + if (icon) { 447 447 + record.icon = icon; 448 448 + } 449 449 + 450 450 + if (options.showInDiscover !== undefined) { 451 451 + record.preferences = { 452 452 + showInDiscover: options.showInDiscover, 453 453 + }; 454 454 + } 455 455 + 456 456 + const response = await agent.com.atproto.repo.createRecord({ 457 457 + repo: agent.did!, 458 458 + collection: "site.standard.publication", 459 459 + record, 460 460 + }); 461 461 + 462 462 + return response.data.uri; 463 463 + } 464 464 + 465 465 + export interface GetPublicationResult { 466 466 + uri: string; 467 467 + cid: string; 468 468 + value: PublicationRecord; 469 469 + } 470 470 + 471 471 + export async function getPublication( 472 472 + agent: Agent, 473 473 + publicationUri: string, 474 474 + ): Promise<GetPublicationResult | null> { 475 475 + const parsed = parseAtUri(publicationUri); 476 476 + if (!parsed) { 477 477 + return null; 478 478 + } 479 479 + 480 480 + try { 481 481 + const response = await agent.com.atproto.repo.getRecord({ 482 482 + repo: parsed.did, 483 483 + collection: parsed.collection, 484 484 + rkey: parsed.rkey, 485 485 + }); 486 486 + 487 487 + return { 488 488 + uri: publicationUri, 489 489 + cid: response.data.cid!, 490 490 + value: response.data.value as unknown as PublicationRecord, 491 491 + }; 492 492 + } catch { 493 493 + return null; 494 494 + } 495 495 + } 496 496 + 497 497 + export interface UpdatePublicationOptions { 498 498 + url?: string; 499 499 + name?: string; 500 500 + description?: string; 501 501 + iconPath?: string; 502 502 + showInDiscover?: boolean; 503 503 + } 504 504 + 505 505 + export async function updatePublication( 506 506 + agent: Agent, 507 507 + publicationUri: string, 508 508 + options: UpdatePublicationOptions, 509 509 + existingRecord: PublicationRecord, 510 510 + ): Promise<void> { 511 511 + const parsed = parseAtUri(publicationUri); 512 512 + if (!parsed) { 513 513 + throw new Error(`Invalid publication URI: ${publicationUri}`); 514 514 + } 515 515 + 516 516 + // Build updated record, preserving createdAt and $type 517 517 + const record: Record<string, unknown> = { 518 518 + $type: existingRecord.$type, 519 519 + url: options.url ?? existingRecord.url, 520 520 + name: options.name ?? existingRecord.name, 521 521 + createdAt: existingRecord.createdAt, 522 522 + }; 523 523 + 524 524 + // Handle description - can be cleared with empty string 525 525 + if (options.description !== undefined) { 526 526 + if (options.description) { 527 527 + record.description = options.description; 528 528 + } 529 529 + // If empty string, don't include description (clears it) 530 530 + } else if (existingRecord.description) { 531 531 + record.description = existingRecord.description; 532 532 + } 321 533 322 322 - if (options.iconPath) { 323 323 - icon = await uploadImage(agent, options.iconPath); 324 324 - } 534 534 + // Handle icon - upload new if provided, otherwise keep existing 535 535 + if (options.iconPath) { 536 536 + const icon = await uploadImage(agent, options.iconPath); 537 537 + if (icon) { 538 538 + record.icon = icon; 539 539 + } 540 540 + } else if (existingRecord.icon) { 541 541 + record.icon = existingRecord.icon; 542 542 + } 325 543 326 326 - const record: Record<string, unknown> = { 327 327 - $type: "site.standard.publication", 328 328 - url: options.url, 329 329 - name: options.name, 330 330 - createdAt: new Date().toISOString(), 331 331 - }; 544 544 + // Handle preferences 545 545 + if (options.showInDiscover !== undefined) { 546 546 + record.preferences = { 547 547 + showInDiscover: options.showInDiscover, 548 548 + }; 549 549 + } else if (existingRecord.preferences) { 550 550 + record.preferences = existingRecord.preferences; 551 551 + } 332 552 333 333 - if (options.description) { 334 334 - record.description = options.description; 335 335 - } 553 553 + await agent.com.atproto.repo.putRecord({ 554 554 + repo: parsed.did, 555 555 + collection: parsed.collection, 556 556 + rkey: parsed.rkey, 557 557 + record, 558 558 + }); 559 559 + } 336 560 337 337 - if (icon) { 338 338 - record.icon = icon; 339 339 - } 561 561 + // --- Bluesky Post Creation --- 340 562 341 341 - if (options.showInDiscover !== undefined) { 342 342 - record.preferences = { 343 343 - showInDiscover: options.showInDiscover, 344 344 - }; 345 345 - } 563 563 + export interface CreateBlueskyPostOptions { 564 564 + title: string; 565 565 + description?: string; 566 566 + canonicalUrl: string; 567 567 + coverImage?: BlobObject; 568 568 + publishedAt: string; // Used as createdAt for the post 569 569 + } 346 570 347 347 - const response = await agent.com.atproto.repo.createRecord({ 348 348 - repo: agent.session!.did, 349 349 - collection: "site.standard.publication", 350 350 - record, 351 351 - }); 571 571 + /** 572 572 + * Count graphemes in a string (for Bluesky's 300 grapheme limit) 573 573 + */ 574 574 + function countGraphemes(str: string): number { 575 575 + // Use Intl.Segmenter if available, otherwise fallback to spread operator 576 576 + if (typeof Intl !== "undefined" && Intl.Segmenter) { 577 577 + const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" }); 578 578 + return [...segmenter.segment(str)].length; 579 579 + } 580 580 + return [...str].length; 581 581 + } 352 582 353 353 - return response.data.uri; 583 583 + /** 584 584 + * Truncate a string to a maximum number of graphemes 585 585 + */ 586 586 + function truncateToGraphemes(str: string, maxGraphemes: number): string { 587 587 + if (typeof Intl !== "undefined" && Intl.Segmenter) { 588 588 + const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" }); 589 589 + const segments = [...segmenter.segment(str)]; 590 590 + if (segments.length <= maxGraphemes) return str; 591 591 + return `${segments 592 592 + .slice(0, maxGraphemes - 3) 593 593 + .map((s) => s.segment) 594 594 + .join("")}...`; 595 595 + } 596 596 + // Fallback 597 597 + const chars = [...str]; 598 598 + if (chars.length <= maxGraphemes) return str; 599 599 + return `${chars.slice(0, maxGraphemes - 3).join("")}...`; 600 600 + } 601 601 + 602 602 + /** 603 603 + * Create a Bluesky post with external link embed 604 604 + */ 605 605 + export async function createBlueskyPost( 606 606 + agent: Agent, 607 607 + options: CreateBlueskyPostOptions, 608 608 + ): Promise<StrongRef> { 609 609 + const { title, description, canonicalUrl, coverImage, publishedAt } = options; 610 610 + 611 611 + // Build post text: title + description + URL 612 612 + // Max 300 graphemes for Bluesky posts 613 613 + const MAX_GRAPHEMES = 300; 614 614 + 615 615 + let postText: string; 616 616 + const urlPart = `\n\n${canonicalUrl}`; 617 617 + const urlGraphemes = countGraphemes(urlPart); 618 618 + 619 619 + if (description) { 620 620 + // Try: title + description + URL 621 621 + const fullText = `${title}\n\n${description}${urlPart}`; 622 622 + if (countGraphemes(fullText) <= MAX_GRAPHEMES) { 623 623 + postText = fullText; 624 624 + } else { 625 625 + // Truncate description to fit 626 626 + const availableForDesc = 627 627 + MAX_GRAPHEMES - 628 628 + countGraphemes(title) - 629 629 + countGraphemes("\n\n") - 630 630 + urlGraphemes - 631 631 + countGraphemes("\n\n"); 632 632 + if (availableForDesc > 10) { 633 633 + const truncatedDesc = truncateToGraphemes( 634 634 + description, 635 635 + availableForDesc, 636 636 + ); 637 637 + postText = `${title}\n\n${truncatedDesc}${urlPart}`; 638 638 + } else { 639 639 + // Just title + URL 640 640 + postText = `${title}${urlPart}`; 641 641 + } 642 642 + } 643 643 + } else { 644 644 + // Just title + URL 645 645 + postText = `${title}${urlPart}`; 646 646 + } 647 647 + 648 648 + // Final truncation if still too long (shouldn't happen but safety check) 649 649 + if (countGraphemes(postText) > MAX_GRAPHEMES) { 650 650 + postText = truncateToGraphemes(postText, MAX_GRAPHEMES); 651 651 + } 652 652 + 653 653 + // Calculate byte indices for the URL facet 654 654 + const encoder = new TextEncoder(); 655 655 + const urlStartInText = postText.lastIndexOf(canonicalUrl); 656 656 + const beforeUrl = postText.substring(0, urlStartInText); 657 657 + const byteStart = encoder.encode(beforeUrl).length; 658 658 + const byteEnd = byteStart + encoder.encode(canonicalUrl).length; 659 659 + 660 660 + // Build facets for the URL link 661 661 + const facets = [ 662 662 + { 663 663 + index: { 664 664 + byteStart, 665 665 + byteEnd, 666 666 + }, 667 667 + features: [ 668 668 + { 669 669 + $type: "app.bsky.richtext.facet#link", 670 670 + uri: canonicalUrl, 671 671 + }, 672 672 + ], 673 673 + }, 674 674 + ]; 675 675 + 676 676 + // Build external embed 677 677 + const embed: Record<string, unknown> = { 678 678 + $type: "app.bsky.embed.external", 679 679 + external: { 680 680 + uri: canonicalUrl, 681 681 + title: title.substring(0, 500), // Max 500 chars for title 682 682 + description: (description || "").substring(0, 1000), // Max 1000 chars for description 683 683 + }, 684 684 + }; 685 685 + 686 686 + // Add thumbnail if coverImage is available 687 687 + if (coverImage) { 688 688 + (embed.external as Record<string, unknown>).thumb = coverImage; 689 689 + } 690 690 + 691 691 + // Create the post record 692 692 + const record: Record<string, unknown> = { 693 693 + $type: "app.bsky.feed.post", 694 694 + text: postText, 695 695 + facets, 696 696 + embed, 697 697 + createdAt: new Date(publishedAt).toISOString(), 698 698 + }; 699 699 + 700 700 + const response = await agent.com.atproto.repo.createRecord({ 701 701 + repo: agent.did!, 702 702 + collection: "app.bsky.feed.post", 703 703 + record, 704 704 + }); 705 705 + 706 706 + return { 707 707 + uri: response.data.uri, 708 708 + cid: response.data.cid, 709 709 + }; 710 710 + } 711 711 + 712 712 + /** 713 713 + * Add bskyPostRef to an existing document record 714 714 + */ 715 715 + export async function addBskyPostRefToDocument( 716 716 + agent: Agent, 717 717 + documentAtUri: string, 718 718 + bskyPostRef: StrongRef, 719 719 + ): Promise<void> { 720 720 + const parsed = parseAtUri(documentAtUri); 721 721 + if (!parsed) { 722 722 + throw new Error(`Invalid document URI: ${documentAtUri}`); 723 723 + } 724 724 + 725 725 + // Fetch existing record 726 726 + const existingRecord = await agent.com.atproto.repo.getRecord({ 727 727 + repo: parsed.did, 728 728 + collection: parsed.collection, 729 729 + rkey: parsed.rkey, 730 730 + }); 731 731 + 732 732 + // Add bskyPostRef to the record 733 733 + const updatedRecord = { 734 734 + ...(existingRecord.data.value as Record<string, unknown>), 735 735 + bskyPostRef, 736 736 + }; 737 737 + 738 738 + // Update the record 739 739 + await agent.com.atproto.repo.putRecord({ 740 740 + repo: parsed.did, 741 741 + collection: parsed.collection, 742 742 + rkey: parsed.rkey, 743 743 + record: updatedRecord, 744 744 + }); 354 745 }

+27 -3

packages/cli/src/lib/config.ts

··· 1 1 - import * as fs from "fs/promises"; 2 2 - import * as path from "path"; 3 3 - import type { PublisherConfig, PublisherState, FrontmatterMapping } from "./types"; 1 1 + import * as fs from "node:fs/promises"; 2 2 + import * as path from "node:path"; 3 3 + import type { 4 4 + PublisherConfig, 5 5 + PublisherState, 6 6 + FrontmatterMapping, 7 7 + BlueskyConfig, 8 8 + } from "./types"; 4 9 5 10 const CONFIG_FILENAME = "sequoia.json"; 6 11 const STATE_FILENAME = ".sequoia-state.json"; ··· 76 81 pdsUrl?: string; 77 82 frontmatter?: FrontmatterMapping; 78 83 ignore?: string[]; 84 84 + removeIndexFromSlug?: boolean; 85 85 + stripDatePrefix?: boolean; 86 86 + textContentField?: string; 87 87 + bluesky?: BlueskyConfig; 79 88 }): string { 80 89 const config: Record<string, unknown> = { 81 90 siteUrl: options.siteUrl, ··· 110 119 111 120 if (options.ignore && options.ignore.length > 0) { 112 121 config.ignore = options.ignore; 122 122 + } 123 123 + 124 124 + if (options.removeIndexFromSlug) { 125 125 + config.removeIndexFromSlug = options.removeIndexFromSlug; 126 126 + } 127 127 + 128 128 + if (options.stripDatePrefix) { 129 129 + config.stripDatePrefix = options.stripDatePrefix; 130 130 + } 131 131 + 132 132 + if (options.textContentField) { 133 133 + config.textContentField = options.textContentField; 134 134 + } 135 135 + if (options.bluesky) { 136 136 + config.bluesky = options.bluesky; 113 137 } 114 138 115 139 return JSON.stringify(config, null, 2);

+54

packages/cli/src/lib/credential-select.ts

··· 1 1 + import { select } from "@clack/prompts"; 2 2 + import { getOAuthHandle, getOAuthSession } from "./oauth-store"; 3 3 + import { getCredentials } from "./credentials"; 4 4 + import type { Credentials } from "./types"; 5 5 + import { exitOnCancel } from "./prompts"; 6 6 + 7 7 + /** 8 8 + * Prompt user to select from multiple credentials 9 9 + */ 10 10 + export async function selectCredential( 11 11 + allCredentials: Array<{ id: string; type: "app-password" | "oauth" }>, 12 12 + ): Promise<Credentials | null> { 13 13 + // Build options with friendly labels 14 14 + const options = await Promise.all( 15 15 + allCredentials.map(async ({ id, type }) => { 16 16 + let label = id; 17 17 + if (type === "oauth") { 18 18 + const handle = await getOAuthHandle(id); 19 19 + label = handle ? `${handle} (${id})` : id; 20 20 + } 21 21 + return { 22 22 + value: { id, type }, 23 23 + label: `${label} [${type}]`, 24 24 + }; 25 25 + }), 26 26 + ); 27 27 + 28 28 + const selected = exitOnCancel( 29 29 + await select({ 30 30 + message: "Multiple identities found. Select one:", 31 31 + options, 32 32 + }), 33 33 + ); 34 34 + 35 35 + // Load the full credentials for the selected identity 36 36 + if (selected.type === "oauth") { 37 37 + const session = await getOAuthSession(selected.id); 38 38 + if (session) { 39 39 + const handle = await getOAuthHandle(selected.id); 40 40 + return { 41 41 + type: "oauth", 42 42 + did: selected.id, 43 43 + handle: handle || selected.id, 44 44 + }; 45 45 + } 46 46 + } else { 47 47 + const creds = await getCredentials(selected.id); 48 48 + if (creds) { 49 49 + return creds; 50 50 + } 51 51 + } 52 52 + 53 53 + return null; 54 54 + }

+217 -102

packages/cli/src/lib/credentials.ts

··· 1 1 - import * as fs from "fs/promises"; 2 2 - import * as path from "path"; 3 3 - import * as os from "os"; 4 4 - import type { Credentials } from "./types"; 1 1 + import * as fs from "node:fs/promises"; 2 2 + import * as os from "node:os"; 3 3 + import * as path from "node:path"; 4 4 + import { 5 5 + getOAuthHandle, 6 6 + getOAuthSession, 7 7 + listOAuthSessions, 8 8 + listOAuthSessionsWithHandles, 9 9 + } from "./oauth-store"; 10 10 + import type { 11 11 + AppPasswordCredentials, 12 12 + Credentials, 13 13 + LegacyCredentials, 14 14 + OAuthCredentials, 15 15 + } from "./types"; 5 16 6 17 const CONFIG_DIR = path.join(os.homedir(), ".config", "sequoia"); 7 18 const CREDENTIALS_FILE = path.join(CONFIG_DIR, "credentials.json"); 8 19 9 9 - // Stored credentials keyed by identifier 10 10 - type CredentialsStore = Record<string, Credentials>; 20 20 + // Stored credentials keyed by identifier (can be legacy or typed) 21 21 + type CredentialsStore = Record< 22 22 + string, 23 23 + AppPasswordCredentials | LegacyCredentials 24 24 + >; 11 25 12 26 async function fileExists(filePath: string): Promise<boolean> { 13 13 - try { 14 14 - await fs.access(filePath); 15 15 - return true; 16 16 - } catch { 17 17 - return false; 18 18 - } 27 27 + try { 28 28 + await fs.access(filePath); 29 29 + return true; 30 30 + } catch { 31 31 + return false; 32 32 + } 19 33 } 20 34 21 35 /** 22 22 - * Load all stored credentials 36 36 + * Normalize credentials to have explicit type 23 37 */ 38 38 + function normalizeCredentials( 39 39 + creds: AppPasswordCredentials | LegacyCredentials, 40 40 + ): AppPasswordCredentials { 41 41 + // If it already has type, return as-is 42 42 + if ("type" in creds && creds.type === "app-password") { 43 43 + return creds; 44 44 + } 45 45 + // Migrate legacy format 46 46 + return { 47 47 + type: "app-password", 48 48 + pdsUrl: creds.pdsUrl, 49 49 + identifier: creds.identifier, 50 50 + password: creds.password, 51 51 + }; 52 52 + } 53 53 + 24 54 async function loadCredentialsStore(): Promise<CredentialsStore> { 25 25 - if (!(await fileExists(CREDENTIALS_FILE))) { 26 26 - return {}; 27 27 - } 55 55 + if (!(await fileExists(CREDENTIALS_FILE))) { 56 56 + return {}; 57 57 + } 28 58 29 29 - try { 30 30 - const content = await fs.readFile(CREDENTIALS_FILE, "utf-8"); 31 31 - const parsed = JSON.parse(content); 59 59 + try { 60 60 + const content = await fs.readFile(CREDENTIALS_FILE, "utf-8"); 61 61 + const parsed = JSON.parse(content); 32 62 33 33 - // Handle legacy single-credential format (migrate on read) 34 34 - if (parsed.identifier && parsed.password) { 35 35 - const legacy = parsed as Credentials; 36 36 - return { [legacy.identifier]: legacy }; 37 37 - } 63 63 + // Handle legacy single-credential format (migrate on read) 64 64 + if (parsed.identifier && parsed.password) { 65 65 + const legacy = parsed as LegacyCredentials; 66 66 + return { [legacy.identifier]: legacy }; 67 67 + } 38 68 39 39 - return parsed as CredentialsStore; 40 40 - } catch { 41 41 - return {}; 42 42 - } 69 69 + return parsed as CredentialsStore; 70 70 + } catch { 71 71 + return {}; 72 72 + } 43 73 } 44 74 45 75 /** 46 76 * Save the entire credentials store 47 77 */ 48 78 async function saveCredentialsStore(store: CredentialsStore): Promise<void> { 49 49 - await fs.mkdir(CONFIG_DIR, { recursive: true }); 50 50 - await fs.writeFile(CREDENTIALS_FILE, JSON.stringify(store, null, 2)); 51 51 - await fs.chmod(CREDENTIALS_FILE, 0o600); 79 79 + await fs.mkdir(CONFIG_DIR, { recursive: true }); 80 80 + await fs.writeFile(CREDENTIALS_FILE, JSON.stringify(store, null, 2)); 81 81 + await fs.chmod(CREDENTIALS_FILE, 0o600); 82 82 + } 83 83 + 84 84 + /** 85 85 + * Try to load OAuth credentials for a given profile (DID or handle) 86 86 + */ 87 87 + async function tryLoadOAuthCredentials( 88 88 + profile: string, 89 89 + ): Promise<OAuthCredentials | null> { 90 90 + // If it looks like a DID, try to get the session directly 91 91 + if (profile.startsWith("did:")) { 92 92 + const session = await getOAuthSession(profile); 93 93 + if (session) { 94 94 + const handle = await getOAuthHandle(profile); 95 95 + return { 96 96 + type: "oauth", 97 97 + did: profile, 98 98 + handle: handle || profile, 99 99 + }; 100 100 + } 101 101 + } 102 102 + 103 103 + // Try to find OAuth session by handle 104 104 + const sessions = await listOAuthSessionsWithHandles(); 105 105 + const match = sessions.find((s) => s.handle === profile); 106 106 + if (match) { 107 107 + return { 108 108 + type: "oauth", 109 109 + did: match.did, 110 110 + handle: match.handle || match.did, 111 111 + }; 112 112 + } 113 113 + 114 114 + return null; 52 115 } 53 116 54 117 /** ··· 56 119 * 57 120 * Priority: 58 121 * 1. Full env vars (ATP_IDENTIFIER + ATP_APP_PASSWORD) 59 59 - * 2. SEQUOIA_PROFILE env var - selects from stored credentials 122 122 + * 2. SEQUOIA_PROFILE env var - selects from stored credentials (app-password or OAuth DID) 60 123 * 3. projectIdentity parameter (from sequoia.json) 61 61 - * 4. If only one identity stored, use it 124 124 + * 4. If only one identity stored (app-password or OAuth), use it 62 125 * 5. Return null (caller should prompt user) 63 126 */ 64 127 export async function loadCredentials( 65 65 - projectIdentity?: string 128 128 + projectIdentity?: string, 66 129 ): Promise<Credentials | null> { 67 67 - // 1. Check environment variables first (full override) 68 68 - const envIdentifier = process.env.ATP_IDENTIFIER; 69 69 - const envPassword = process.env.ATP_APP_PASSWORD; 70 70 - const envPdsUrl = process.env.PDS_URL; 130 130 + // 1. Check environment variables first (full override) 131 131 + const envIdentifier = process.env.ATP_IDENTIFIER; 132 132 + const envPassword = process.env.ATP_APP_PASSWORD; 133 133 + const envPdsUrl = process.env.PDS_URL; 71 134 72 72 - if (envIdentifier && envPassword) { 73 73 - return { 74 74 - identifier: envIdentifier, 75 75 - password: envPassword, 76 76 - pdsUrl: envPdsUrl || "https://bsky.social", 77 77 - }; 78 78 - } 135 135 + if (envIdentifier && envPassword) { 136 136 + return { 137 137 + type: "app-password", 138 138 + identifier: envIdentifier, 139 139 + password: envPassword, 140 140 + pdsUrl: envPdsUrl || "https://bsky.social", 141 141 + }; 142 142 + } 79 143 80 80 - const store = await loadCredentialsStore(); 81 81 - const identifiers = Object.keys(store); 144 144 + const store = await loadCredentialsStore(); 145 145 + const appPasswordIds = Object.keys(store); 146 146 + const oauthDids = await listOAuthSessions(); 82 147 83 83 - if (identifiers.length === 0) { 84 84 - return null; 85 85 - } 86 86 - 87 87 - // 2. SEQUOIA_PROFILE env var 88 88 - const profileEnv = process.env.SEQUOIA_PROFILE; 89 89 - if (profileEnv && store[profileEnv]) { 90 90 - return store[profileEnv]; 91 91 - } 148 148 + // 2. SEQUOIA_PROFILE env var 149 149 + const profileEnv = process.env.SEQUOIA_PROFILE; 150 150 + if (profileEnv) { 151 151 + // Try app-password credentials first 152 152 + if (store[profileEnv]) { 153 153 + return normalizeCredentials(store[profileEnv]); 154 154 + } 155 155 + // Try OAuth session (profile could be a DID) 156 156 + const oauth = await tryLoadOAuthCredentials(profileEnv); 157 157 + if (oauth) { 158 158 + return oauth; 159 159 + } 160 160 + } 92 161 93 93 - // 3. Project-specific identity (from sequoia.json) 94 94 - if (projectIdentity && store[projectIdentity]) { 95 95 - return store[projectIdentity]; 96 96 - } 162 162 + // 3. Project-specific identity (from sequoia.json) 163 163 + if (projectIdentity) { 164 164 + if (store[projectIdentity]) { 165 165 + return normalizeCredentials(store[projectIdentity]); 166 166 + } 167 167 + const oauth = await tryLoadOAuthCredentials(projectIdentity); 168 168 + if (oauth) { 169 169 + return oauth; 170 170 + } 171 171 + } 97 172 98 98 - // 4. If only one identity, use it 99 99 - if (identifiers.length === 1 && identifiers[0]) { 100 100 - return store[identifiers[0]] ?? null; 101 101 - } 173 173 + // 4. If only one identity total, use it 174 174 + const totalIdentities = appPasswordIds.length + oauthDids.length; 175 175 + if (totalIdentities === 1) { 176 176 + if (appPasswordIds.length === 1 && appPasswordIds[0]) { 177 177 + return normalizeCredentials(store[appPasswordIds[0]]!); 178 178 + } 179 179 + if (oauthDids.length === 1 && oauthDids[0]) { 180 180 + const session = await getOAuthSession(oauthDids[0]); 181 181 + if (session) { 182 182 + const handle = await getOAuthHandle(oauthDids[0]); 183 183 + return { 184 184 + type: "oauth", 185 185 + did: oauthDids[0], 186 186 + handle: handle || oauthDids[0], 187 187 + }; 188 188 + } 189 189 + } 190 190 + } 102 191 103 103 - // Multiple identities exist but none selected 104 104 - return null; 192 192 + // Multiple identities exist but none selected, or no identities 193 193 + return null; 105 194 } 106 195 107 196 /** 108 108 - * Get a specific identity by identifier 197 197 + * Get a specific identity by identifier (app-password only) 109 198 */ 110 199 export async function getCredentials( 111 111 - identifier: string 112 112 - ): Promise<Credentials | null> { 113 113 - const store = await loadCredentialsStore(); 114 114 - return store[identifier] || null; 200 200 + identifier: string, 201 201 + ): Promise<AppPasswordCredentials | null> { 202 202 + const store = await loadCredentialsStore(); 203 203 + const creds = store[identifier]; 204 204 + if (!creds) return null; 205 205 + return normalizeCredentials(creds); 115 206 } 116 207 117 208 /** 118 118 - * List all stored identities 209 209 + * List all stored app-password identities 119 210 */ 120 211 export async function listCredentials(): Promise<string[]> { 121 121 - const store = await loadCredentialsStore(); 122 122 - return Object.keys(store); 212 212 + const store = await loadCredentialsStore(); 213 213 + return Object.keys(store); 214 214 + } 215 215 + 216 216 + /** 217 217 + * List all credentials (both app-password and OAuth) 218 218 + */ 219 219 + export async function listAllCredentials(): Promise< 220 220 + Array<{ id: string; type: "app-password" | "oauth" }> 221 221 + > { 222 222 + const store = await loadCredentialsStore(); 223 223 + const oauthDids = await listOAuthSessions(); 224 224 + 225 225 + const result: Array<{ id: string; type: "app-password" | "oauth" }> = []; 226 226 + 227 227 + for (const id of Object.keys(store)) { 228 228 + result.push({ id, type: "app-password" }); 229 229 + } 230 230 + 231 231 + for (const did of oauthDids) { 232 232 + result.push({ id: did, type: "oauth" }); 233 233 + } 234 234 + 235 235 + return result; 123 236 } 124 237 125 238 /** 126 126 - * Save credentials for an identity (adds or updates) 239 239 + * Save app-password credentials for an identity (adds or updates) 127 240 */ 128 128 - export async function saveCredentials(credentials: Credentials): Promise<void> { 129 129 - const store = await loadCredentialsStore(); 130 130 - store[credentials.identifier] = credentials; 131 131 - await saveCredentialsStore(store); 241 241 + export async function saveCredentials( 242 242 + credentials: AppPasswordCredentials, 243 243 + ): Promise<void> { 244 244 + const store = await loadCredentialsStore(); 245 245 + store[credentials.identifier] = credentials; 246 246 + await saveCredentialsStore(store); 132 247 } 133 248 134 249 /** 135 250 * Delete credentials for a specific identity 136 251 */ 137 252 export async function deleteCredentials(identifier?: string): Promise<boolean> { 138 138 - const store = await loadCredentialsStore(); 139 139 - const identifiers = Object.keys(store); 253 253 + const store = await loadCredentialsStore(); 254 254 + const identifiers = Object.keys(store); 140 255 141 141 - if (identifiers.length === 0) { 142 142 - return false; 143 143 - } 256 256 + if (identifiers.length === 0) { 257 257 + return false; 258 258 + } 144 259 145 145 - // If identifier specified, delete just that one 146 146 - if (identifier) { 147 147 - if (!store[identifier]) { 148 148 - return false; 149 149 - } 150 150 - delete store[identifier]; 151 151 - await saveCredentialsStore(store); 152 152 - return true; 153 153 - } 260 260 + // If identifier specified, delete just that one 261 261 + if (identifier) { 262 262 + if (!store[identifier]) { 263 263 + return false; 264 264 + } 265 265 + delete store[identifier]; 266 266 + await saveCredentialsStore(store); 267 267 + return true; 268 268 + } 154 269 155 155 - // If only one identity, delete it (backwards compat behavior) 156 156 - if (identifiers.length === 1 && identifiers[0]) { 157 157 - delete store[identifiers[0]]; 158 158 - await saveCredentialsStore(store); 159 159 - return true; 160 160 - } 270 270 + // If only one identity, delete it (backwards compat behavior) 271 271 + if (identifiers.length === 1 && identifiers[0]) { 272 272 + delete store[identifiers[0]]; 273 273 + await saveCredentialsStore(store); 274 274 + return true; 275 275 + } 161 276 162 162 - // Multiple identities but none specified 163 163 - return false; 277 277 + // Multiple identities but none specified 278 278 + return false; 164 279 } 165 280 166 281 export function getCredentialsPath(): string { 167 167 - return CREDENTIALS_FILE; 282 282 + return CREDENTIALS_FILE; 168 283 }

+337 -170

packages/cli/src/lib/markdown.ts

··· 1 1 - import * as fs from "fs/promises"; 2 2 - import * as path from "path"; 1 1 + import * as fs from "node:fs/promises"; 2 2 + import * as path from "node:path"; 3 3 import { glob } from "glob"; 4 4 import { minimatch } from "minimatch"; 5 5 - import type { PostFrontmatter, BlogPost, FrontmatterMapping } from "./types"; 5 5 + import type { BlogPost, FrontmatterMapping, PostFrontmatter } from "./types"; 6 6 7 7 - export function parseFrontmatter(content: string, mapping?: FrontmatterMapping): { 8 8 - frontmatter: PostFrontmatter; 9 9 - body: string; 7 7 + export function parseFrontmatter( 8 8 + content: string, 9 9 + mapping?: FrontmatterMapping, 10 10 + ): { 11 11 + frontmatter: PostFrontmatter; 12 12 + body: string; 13 13 + rawFrontmatter: Record<string, unknown>; 10 14 } { 11 11 - // Support multiple frontmatter delimiters: 12 12 - // --- (YAML) - Jekyll, Astro, most SSGs 13 13 - // +++ (TOML) - Hugo 14 14 - // *** - Alternative format 15 15 - const frontmatterRegex = /^(---|\+\+\+|\*\*\*)\n([\s\S]*?)\n\1\n([\s\S]*)$/; 16 16 - const match = content.match(frontmatterRegex); 15 15 + // Support multiple frontmatter delimiters: 16 16 + // --- (YAML) - Jekyll, Astro, most SSGs 17 17 + // +++ (TOML) - Hugo 18 18 + // *** - Alternative format 19 19 + const frontmatterRegex = /^(---|\+\+\+|\*\*\*)\n([\s\S]*?)\n\1\n([\s\S]*)$/; 20 20 + const match = content.match(frontmatterRegex); 17 21 18 18 - if (!match) { 19 19 - throw new Error("Could not parse frontmatter"); 20 20 - } 22 22 + if (!match) { 23 23 + throw new Error("Could not parse frontmatter"); 24 24 + } 21 25 22 22 - const delimiter = match[1]; 23 23 - const frontmatterStr = match[2] ?? ""; 24 24 - const body = match[3] ?? ""; 26 26 + const delimiter = match[1]; 27 27 + const frontmatterStr = match[2] ?? ""; 28 28 + const body = match[3] ?? ""; 25 29 26 26 - // Determine format based on delimiter: 27 27 - // +++ uses TOML (key = value) 28 28 - // --- and *** use YAML (key: value) 29 29 - const isToml = delimiter === "+++"; 30 30 - const separator = isToml ? "=" : ":"; 30 30 + // Determine format based on delimiter: 31 31 + // +++ uses TOML (key = value) 32 32 + // --- and *** use YAML (key: value) 33 33 + const isToml = delimiter === "+++"; 34 34 + const separator = isToml ? "=" : ":"; 31 35 32 32 - // Parse frontmatter manually 33 33 - const raw: Record<string, unknown> = {}; 34 34 - const lines = frontmatterStr.split("\n"); 36 36 + // Parse frontmatter manually 37 37 + const raw: Record<string, unknown> = {}; 38 38 + const lines = frontmatterStr.split("\n"); 35 39 36 36 - for (const line of lines) { 37 37 - const sepIndex = line.indexOf(separator); 38 38 - if (sepIndex === -1) continue; 40 40 + let i = 0; 41 41 + while (i < lines.length) { 42 42 + const line = lines[i]; 43 43 + if (line === undefined) { 44 44 + i++; 45 45 + continue; 46 46 + } 47 47 + const sepIndex = line.indexOf(separator); 48 48 + if (sepIndex === -1) { 49 49 + i++; 50 50 + continue; 51 51 + } 39 52 40 40 - const key = line.slice(0, sepIndex).trim(); 41 41 - let value = line.slice(sepIndex + 1).trim(); 53 53 + const key = line.slice(0, sepIndex).trim(); 54 54 + let value = line.slice(sepIndex + 1).trim(); 42 55 43 43 - // Handle quoted strings 44 44 - if ( 45 45 - (value.startsWith('"') && value.endsWith('"')) || 46 46 - (value.startsWith("'") && value.endsWith("'")) 47 47 - ) { 48 48 - value = value.slice(1, -1); 49 49 - } 56 56 + // Handle quoted strings 57 57 + if ( 58 58 + (value.startsWith('"') && value.endsWith('"')) || 59 59 + (value.startsWith("'") && value.endsWith("'")) 60 60 + ) { 61 61 + value = value.slice(1, -1); 62 62 + } 50 63 51 51 - // Handle arrays (simple case for tags) 52 52 - if (value.startsWith("[") && value.endsWith("]")) { 53 53 - const arrayContent = value.slice(1, -1); 54 54 - raw[key] = arrayContent 55 55 - .split(",") 56 56 - .map((item) => item.trim().replace(/^["']|["']$/g, "")); 57 57 - } else if (value === "true") { 58 58 - raw[key] = true; 59 59 - } else if (value === "false") { 60 60 - raw[key] = false; 61 61 - } else { 62 62 - raw[key] = value; 63 63 - } 64 64 - } 64 64 + // Handle inline arrays (simple case for tags) 65 65 + if (value.startsWith("[") && value.endsWith("]")) { 66 66 + const arrayContent = value.slice(1, -1); 67 67 + raw[key] = arrayContent 68 68 + .split(",") 69 69 + .map((item) => item.trim().replace(/^["']|["']$/g, "")); 70 70 + } else if (value === "" && !isToml) { 71 71 + // Check for YAML-style multiline array (key with no value followed by - items) 72 72 + const arrayItems: string[] = []; 73 73 + let j = i + 1; 74 74 + while (j < lines.length) { 75 75 + const nextLine = lines[j]; 76 76 + if (nextLine === undefined) { 77 77 + j++; 78 78 + continue; 79 79 + } 80 80 + // Check if line is a list item (starts with whitespace and -) 81 81 + const listMatch = nextLine.match(/^\s+-\s*(.*)$/); 82 82 + if (listMatch && listMatch[1] !== undefined) { 83 83 + let itemValue = listMatch[1].trim(); 84 84 + // Remove quotes if present 85 85 + if ( 86 86 + (itemValue.startsWith('"') && itemValue.endsWith('"')) || 87 87 + (itemValue.startsWith("'") && itemValue.endsWith("'")) 88 88 + ) { 89 89 + itemValue = itemValue.slice(1, -1); 90 90 + } 91 91 + arrayItems.push(itemValue); 92 92 + j++; 93 93 + } else if (nextLine.trim() === "") { 94 94 + // Skip empty lines within the array 95 95 + j++; 96 96 + } else { 97 97 + // Hit a new key or non-list content 98 98 + break; 99 99 + } 100 100 + } 101 101 + if (arrayItems.length > 0) { 102 102 + raw[key] = arrayItems; 103 103 + i = j; 104 104 + continue; 105 105 + } else { 106 106 + raw[key] = value; 107 107 + } 108 108 + } else if (value === "true") { 109 109 + raw[key] = true; 110 110 + } else if (value === "false") { 111 111 + raw[key] = false; 112 112 + } else { 113 113 + raw[key] = value; 114 114 + } 115 115 + i++; 116 116 + } 65 117 66 66 - // Apply field mappings to normalize to standard PostFrontmatter fields 67 67 - const frontmatter: Record<string, unknown> = {}; 118 118 + // Apply field mappings to normalize to standard PostFrontmatter fields 119 119 + const frontmatter: Record<string, unknown> = {}; 68 120 69 69 - // Title mapping 70 70 - const titleField = mapping?.title || "title"; 71 71 - frontmatter.title = raw[titleField] || raw.title; 121 121 + // Title mapping 122 122 + const titleField = mapping?.title || "title"; 123 123 + frontmatter.title = raw[titleField] || raw.title; 72 124 73 73 - // Description mapping 74 74 - const descField = mapping?.description || "description"; 75 75 - frontmatter.description = raw[descField] || raw.description; 125 125 + // Description mapping 126 126 + const descField = mapping?.description || "description"; 127 127 + frontmatter.description = raw[descField] || raw.description; 76 128 77 77 - // Publish date mapping - check custom field first, then fallbacks 78 78 - const dateField = mapping?.publishDate; 79 79 - if (dateField && raw[dateField]) { 80 80 - frontmatter.publishDate = raw[dateField]; 81 81 - } else if (raw.publishDate) { 82 82 - frontmatter.publishDate = raw.publishDate; 83 83 - } else { 84 84 - // Fallback to common date field names 85 85 - const dateFields = ["pubDate", "date", "createdAt", "created_at"]; 86 86 - for (const field of dateFields) { 87 87 - if (raw[field]) { 88 88 - frontmatter.publishDate = raw[field]; 89 89 - break; 90 90 - } 91 91 - } 92 92 - } 129 129 + // Publish date mapping - check custom field first, then fallbacks 130 130 + const dateField = mapping?.publishDate; 131 131 + if (dateField && raw[dateField]) { 132 132 + frontmatter.publishDate = raw[dateField]; 133 133 + } else if (raw.publishDate) { 134 134 + frontmatter.publishDate = raw.publishDate; 135 135 + } else { 136 136 + // Fallback to common date field names 137 137 + const dateFields = ["pubDate", "date", "createdAt", "created_at"]; 138 138 + for (const field of dateFields) { 139 139 + if (raw[field]) { 140 140 + frontmatter.publishDate = raw[field]; 141 141 + break; 142 142 + } 143 143 + } 144 144 + } 145 145 + 146 146 + // Cover image mapping 147 147 + const coverField = mapping?.coverImage || "ogImage"; 148 148 + frontmatter.ogImage = raw[coverField] || raw.ogImage; 93 149 94 94 - // Cover image mapping 95 95 - const coverField = mapping?.coverImage || "ogImage"; 96 96 - frontmatter.ogImage = raw[coverField] || raw.ogImage; 150 150 + // Tags mapping 151 151 + const tagsField = mapping?.tags || "tags"; 152 152 + frontmatter.tags = raw[tagsField] || raw.tags; 97 153 98 98 - // Tags mapping 99 99 - const tagsField = mapping?.tags || "tags"; 100 100 - frontmatter.tags = raw[tagsField] || raw.tags; 154 154 + // Draft mapping 155 155 + const draftField = mapping?.draft || "draft"; 156 156 + const draftValue = raw[draftField] ?? raw.draft; 157 157 + if (draftValue !== undefined) { 158 158 + frontmatter.draft = draftValue === true || draftValue === "true"; 159 159 + } 101 160 102 102 - // Always preserve atUri (internal field) 103 103 - frontmatter.atUri = raw.atUri; 161 161 + // Always preserve atUri (internal field) 162 162 + frontmatter.atUri = raw.atUri; 104 163 105 105 - return { frontmatter: frontmatter as unknown as PostFrontmatter, body }; 164 164 + return { 165 165 + frontmatter: frontmatter as unknown as PostFrontmatter, 166 166 + body, 167 167 + rawFrontmatter: raw, 168 168 + }; 106 169 } 107 170 108 171 export function getSlugFromFilename(filename: string): string { 109 109 - return filename 110 110 - .replace(/\.mdx?$/, "") 111 111 - .toLowerCase() 112 112 - .replace(/\s+/g, "-"); 172 172 + return filename 173 173 + .replace(/\.mdx?$/, "") 174 174 + .toLowerCase() 175 175 + .replace(/\s+/g, "-"); 176 176 + } 177 177 + 178 178 + export interface SlugOptions { 179 179 + slugField?: string; 180 180 + removeIndexFromSlug?: boolean; 181 181 + stripDatePrefix?: boolean; 182 182 + } 183 183 + 184 184 + export function getSlugFromOptions( 185 185 + relativePath: string, 186 186 + rawFrontmatter: Record<string, unknown>, 187 187 + options: SlugOptions = {}, 188 188 + ): string { 189 189 + const { 190 190 + slugField, 191 191 + removeIndexFromSlug = false, 192 192 + stripDatePrefix = false, 193 193 + } = options; 194 194 + 195 195 + let slug: string; 196 196 + 197 197 + // If slugField is set, try to get the value from frontmatter 198 198 + if (slugField) { 199 199 + const frontmatterValue = rawFrontmatter[slugField]; 200 200 + if (frontmatterValue && typeof frontmatterValue === "string") { 201 201 + // Remove leading slash if present 202 202 + slug = frontmatterValue 203 203 + .replace(/^\//, "") 204 204 + .toLowerCase() 205 205 + .replace(/\s+/g, "-"); 206 206 + } else { 207 207 + // Fallback to filepath if frontmatter field not found 208 208 + slug = relativePath 209 209 + .replace(/\.mdx?$/, "") 210 210 + .toLowerCase() 211 211 + .replace(/\s+/g, "-"); 212 212 + } 213 213 + } else { 214 214 + // Default: use filepath 215 215 + slug = relativePath 216 216 + .replace(/\.mdx?$/, "") 217 217 + .toLowerCase() 218 218 + .replace(/\s+/g, "-"); 219 219 + } 220 220 + 221 221 + // Remove /index or /_index suffix if configured 222 222 + if (removeIndexFromSlug) { 223 223 + slug = slug.replace(/\/_?index$/, ""); 224 224 + } 225 225 + 226 226 + // Strip Jekyll-style date prefix (YYYY-MM-DD-) from filename 227 227 + if (stripDatePrefix) { 228 228 + slug = slug.replace(/(^|\/)(\d{4}-\d{2}-\d{2})-/g, "$1"); 229 229 + } 230 230 + 231 231 + return slug; 113 232 } 114 233 115 234 export async function getContentHash(content: string): Promise<string> { 116 116 - const encoder = new TextEncoder(); 117 117 - const data = encoder.encode(content); 118 118 - const hashBuffer = await crypto.subtle.digest("SHA-256", data); 119 119 - const hashArray = Array.from(new Uint8Array(hashBuffer)); 120 120 - return hashArray.map((b) => b.toString(16).padStart(2, "0")).join(""); 235 235 + const encoder = new TextEncoder(); 236 236 + const data = encoder.encode(content); 237 237 + const hashBuffer = await crypto.subtle.digest("SHA-256", data); 238 238 + const hashArray = Array.from(new Uint8Array(hashBuffer)); 239 239 + return hashArray.map((b) => b.toString(16).padStart(2, "0")).join(""); 121 240 } 122 241 123 242 function shouldIgnore(relativePath: string, ignorePatterns: string[]): boolean { 124 124 - for (const pattern of ignorePatterns) { 125 125 - if (minimatch(relativePath, pattern)) { 126 126 - return true; 127 127 - } 128 128 - } 129 129 - return false; 243 243 + for (const pattern of ignorePatterns) { 244 244 + if (minimatch(relativePath, pattern)) { 245 245 + return true; 246 246 + } 247 247 + } 248 248 + return false; 249 249 + } 250 250 + 251 251 + export interface ScanOptions { 252 252 + frontmatterMapping?: FrontmatterMapping; 253 253 + ignorePatterns?: string[]; 254 254 + slugField?: string; 255 255 + removeIndexFromSlug?: boolean; 256 256 + stripDatePrefix?: boolean; 130 257 } 131 258 132 259 export async function scanContentDirectory( 133 133 - contentDir: string, 134 134 - frontmatterMapping?: FrontmatterMapping, 135 135 - ignorePatterns: string[] = [] 260 260 + contentDir: string, 261 261 + frontmatterMappingOrOptions?: FrontmatterMapping | ScanOptions, 262 262 + ignorePatterns: string[] = [], 136 263 ): Promise<BlogPost[]> { 137 137 - const patterns = ["**/*.md", "**/*.mdx"]; 138 138 - const posts: BlogPost[] = []; 264 264 + // Handle both old signature (frontmatterMapping, ignorePatterns) and new signature (options) 265 265 + let options: ScanOptions; 266 266 + if ( 267 267 + frontmatterMappingOrOptions && 268 268 + ("frontmatterMapping" in frontmatterMappingOrOptions || 269 269 + "ignorePatterns" in frontmatterMappingOrOptions || 270 270 + "slugField" in frontmatterMappingOrOptions) 271 271 + ) { 272 272 + options = frontmatterMappingOrOptions as ScanOptions; 273 273 + } else { 274 274 + // Old signature: (contentDir, frontmatterMapping?, ignorePatterns?) 275 275 + options = { 276 276 + frontmatterMapping: frontmatterMappingOrOptions as 277 277 + | FrontmatterMapping 278 278 + | undefined, 279 279 + ignorePatterns, 280 280 + }; 281 281 + } 139 282 140 140 - for (const pattern of patterns) { 141 141 - const files = await glob(pattern, { 142 142 - cwd: contentDir, 143 143 - absolute: false, 144 144 - }); 283 283 + const { 284 284 + frontmatterMapping, 285 285 + ignorePatterns: ignore = [], 286 286 + slugField, 287 287 + removeIndexFromSlug, 288 288 + stripDatePrefix, 289 289 + } = options; 290 290 + 291 291 + const patterns = ["**/*.md", "**/*.mdx"]; 292 292 + const posts: BlogPost[] = []; 293 293 + 294 294 + for (const pattern of patterns) { 295 295 + const files = await glob(pattern, { 296 296 + cwd: contentDir, 297 297 + absolute: false, 298 298 + }); 145 299 146 146 - for (const relativePath of files) { 147 147 - // Skip files matching ignore patterns 148 148 - if (shouldIgnore(relativePath, ignorePatterns)) { 149 149 - continue; 150 150 - } 300 300 + for (const relativePath of files) { 301 301 + // Skip files matching ignore patterns 302 302 + if (shouldIgnore(relativePath, ignore)) { 303 303 + continue; 304 304 + } 151 305 152 152 - const filePath = path.join(contentDir, relativePath); 153 153 - const rawContent = await fs.readFile(filePath, "utf-8"); 306 306 + const filePath = path.join(contentDir, relativePath); 307 307 + const rawContent = await fs.readFile(filePath, "utf-8"); 154 308 155 155 - try { 156 156 - const { frontmatter, body } = parseFrontmatter(rawContent, frontmatterMapping); 157 157 - const filename = path.basename(relativePath); 158 158 - const slug = getSlugFromFilename(filename); 309 309 + try { 310 310 + const { frontmatter, body, rawFrontmatter } = parseFrontmatter( 311 311 + rawContent, 312 312 + frontmatterMapping, 313 313 + ); 314 314 + const slug = getSlugFromOptions(relativePath, rawFrontmatter, { 315 315 + slugField, 316 316 + removeIndexFromSlug, 317 317 + stripDatePrefix, 318 318 + }); 159 319 160 160 - posts.push({ 161 161 - filePath, 162 162 - slug, 163 163 - frontmatter, 164 164 - content: body, 165 165 - rawContent, 166 166 - }); 167 167 - } catch (error) { 168 168 - console.error(`Error parsing ${relativePath}:`, error); 169 169 - } 170 170 - } 171 171 - } 320 320 + posts.push({ 321 321 + filePath, 322 322 + slug, 323 323 + frontmatter, 324 324 + content: body, 325 325 + rawContent, 326 326 + rawFrontmatter, 327 327 + }); 328 328 + } catch (error) { 329 329 + console.error(`Error parsing ${relativePath}:`, error); 330 330 + } 331 331 + } 332 332 + } 172 333 173 173 - // Sort by publish date (newest first) 174 174 - posts.sort((a, b) => { 175 175 - const dateA = new Date(a.frontmatter.publishDate); 176 176 - const dateB = new Date(b.frontmatter.publishDate); 177 177 - return dateB.getTime() - dateA.getTime(); 178 178 - }); 334 334 + // Sort by publish date (newest first) 335 335 + posts.sort((a, b) => { 336 336 + const dateA = new Date(a.frontmatter.publishDate); 337 337 + const dateB = new Date(b.frontmatter.publishDate); 338 338 + return dateB.getTime() - dateA.getTime(); 339 339 + }); 179 340 180 180 - return posts; 341 341 + return posts; 181 342 } 182 343 183 183 - export function updateFrontmatterWithAtUri(rawContent: string, atUri: string): string { 184 184 - // Detect which delimiter is used (---, +++, or ***) 185 185 - const delimiterMatch = rawContent.match(/^(---|\+\+\+|\*\*\*)/); 186 186 - const delimiter = delimiterMatch?.[1] ?? "---"; 187 187 - const isToml = delimiter === "+++"; 344 344 + export function updateFrontmatterWithAtUri( 345 345 + rawContent: string, 346 346 + atUri: string, 347 347 + ): string { 348 348 + // Detect which delimiter is used (---, +++, or ***) 349 349 + const delimiterMatch = rawContent.match(/^(---|\+\+\+|\*\*\*)/); 350 350 + const delimiter = delimiterMatch?.[1] ?? "---"; 351 351 + const isToml = delimiter === "+++"; 188 352 189 189 - // Format the atUri entry based on frontmatter type 190 190 - const atUriEntry = isToml ? `atUri = "${atUri}"` : `atUri: "${atUri}"`; 353 353 + // Format the atUri entry based on frontmatter type 354 354 + const atUriEntry = isToml ? `atUri = "${atUri}"` : `atUri: "${atUri}"`; 191 355 192 192 - // Check if atUri already exists in frontmatter (handle both formats) 193 193 - if (rawContent.includes("atUri:") || rawContent.includes("atUri =")) { 194 194 - // Replace existing atUri (match both YAML and TOML formats) 195 195 - return rawContent.replace(/atUri\s*[=:]\s*["']?[^"'\n]+["']?\n?/, `${atUriEntry}\n`); 196 196 - } 356 356 + // Check if atUri already exists in frontmatter (handle both formats) 357 357 + if (rawContent.includes("atUri:") || rawContent.includes("atUri =")) { 358 358 + // Replace existing atUri (match both YAML and TOML formats) 359 359 + return rawContent.replace( 360 360 + /atUri\s*[=:]\s*["']?[^"'\n]+["']?\n?/, 361 361 + `${atUriEntry}\n`, 362 362 + ); 363 363 + } 197 364 198 198 - // Insert atUri before the closing delimiter 199 199 - const frontmatterEndIndex = rawContent.indexOf(delimiter, 4); 200 200 - if (frontmatterEndIndex === -1) { 201 201 - throw new Error("Could not find frontmatter end"); 202 202 - } 365 365 + // Insert atUri before the closing delimiter 366 366 + const frontmatterEndIndex = rawContent.indexOf(delimiter, 4); 367 367 + if (frontmatterEndIndex === -1) { 368 368 + throw new Error("Could not find frontmatter end"); 369 369 + } 203 370 204 204 - const beforeEnd = rawContent.slice(0, frontmatterEndIndex); 205 205 - const afterEnd = rawContent.slice(frontmatterEndIndex); 371 371 + const beforeEnd = rawContent.slice(0, frontmatterEndIndex); 372 372 + const afterEnd = rawContent.slice(frontmatterEndIndex); 206 373 207 207 - return `${beforeEnd}${atUriEntry}\n${afterEnd}`; 374 374 + return `${beforeEnd}${atUriEntry}\n${afterEnd}`; 208 375 } 209 376 210 377 export function stripMarkdownForText(markdown: string): string { 211 211 - return markdown 212 212 - .replace(/#{1,6}\s/g, "") // Remove headers 213 213 - .replace(/\*\*([^*]+)\*\*/g, "$1") // Remove bold 214 214 - .replace(/\*([^*]+)\*/g, "$1") // Remove italic 215 215 - .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // Remove links, keep text 216 216 - .replace(/`{3}[\s\S]*?`{3}/g, "") // Remove code blocks 217 217 - .replace(/`([^`]+)`/g, "$1") // Remove inline code formatting 218 218 - .replace(/!\[.*?\]\(.*?\)/g, "") // Remove images 219 219 - .replace(/\n{3,}/g, "\n\n") // Normalize multiple newlines 220 220 - .trim(); 378 378 + return markdown 379 379 + .replace(/#{1,6}\s/g, "") // Remove headers 380 380 + .replace(/\*\*([^*]+)\*\*/g, "$1") // Remove bold 381 381 + .replace(/\*([^*]+)\*/g, "$1") // Remove italic 382 382 + .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1") // Remove links, keep text 383 383 + .replace(/`{3}[\s\S]*?`{3}/g, "") // Remove code blocks 384 384 + .replace(/`([^`]+)`/g, "$1") // Remove inline code formatting 385 385 + .replace(/!\[.*?\]\(.*?\)/g, "") // Remove images 386 386 + .replace(/\n{3,}/g, "\n\n") // Normalize multiple newlines 387 387 + .trim(); 221 388 }

+94

packages/cli/src/lib/oauth-client.ts

··· 1 1 + import { 2 2 + NodeOAuthClient, 3 3 + type NodeOAuthClientOptions, 4 4 + } from "@atproto/oauth-client-node"; 5 5 + import { sessionStore, stateStore } from "./oauth-store"; 6 6 + 7 7 + const CALLBACK_PORT = 4000; 8 8 + const CALLBACK_HOST = "127.0.0.1"; 9 9 + const CALLBACK_URL = `http://${CALLBACK_HOST}:${CALLBACK_PORT}/oauth/callback`; 10 10 + 11 11 + // OAuth scope for Sequoia CLI - includes atproto base scope plus our collections 12 12 + const OAUTH_SCOPE = 13 13 + "atproto repo:site.standard.document repo:site.standard.publication repo:app.bsky.feed.post blob:*/*"; 14 14 + 15 15 + let oauthClient: NodeOAuthClient | null = null; 16 16 + 17 17 + // Simple lock implementation for CLI (single process, no contention) 18 18 + // This prevents the "No lock mechanism provided" warning 19 19 + const locks = new Map<string, Promise<void>>(); 20 20 + 21 21 + async function requestLock<T>( 22 22 + key: string, 23 23 + fn: () => T | PromiseLike<T>, 24 24 + ): Promise<T> { 25 25 + // Wait for any existing lock on this key 26 26 + while (locks.has(key)) { 27 27 + await locks.get(key); 28 28 + } 29 29 + 30 30 + // Create our lock 31 31 + let resolve: () => void; 32 32 + const lockPromise = new Promise<void>((r) => { 33 33 + resolve = r; 34 34 + }); 35 35 + locks.set(key, lockPromise); 36 36 + 37 37 + try { 38 38 + return await fn(); 39 39 + } finally { 40 40 + locks.delete(key); 41 41 + resolve!(); 42 42 + } 43 43 + } 44 44 + 45 45 + /** 46 46 + * Get or create the OAuth client singleton 47 47 + */ 48 48 + export async function getOAuthClient(): Promise<NodeOAuthClient> { 49 49 + if (oauthClient) { 50 50 + return oauthClient; 51 51 + } 52 52 + 53 53 + // Build client_id with required parameters 54 54 + const clientIdParams = new URLSearchParams(); 55 55 + clientIdParams.append("redirect_uri", CALLBACK_URL); 56 56 + clientIdParams.append("scope", OAUTH_SCOPE); 57 57 + 58 58 + const clientOptions: NodeOAuthClientOptions = { 59 59 + clientMetadata: { 60 60 + client_id: `http://localhost?${clientIdParams.toString()}`, 61 61 + client_name: "Sequoia CLI", 62 62 + client_uri: "https://github.com/stevedylandev/sequoia", 63 63 + redirect_uris: [CALLBACK_URL], 64 64 + grant_types: ["authorization_code", "refresh_token"], 65 65 + response_types: ["code"], 66 66 + token_endpoint_auth_method: "none", 67 67 + application_type: "web", 68 68 + scope: OAUTH_SCOPE, 69 69 + dpop_bound_access_tokens: false, 70 70 + }, 71 71 + stateStore, 72 72 + sessionStore, 73 73 + // Configure identity resolution 74 74 + plcDirectoryUrl: "https://plc.directory", 75 75 + // Provide lock mechanism to prevent warning 76 76 + requestLock, 77 77 + }; 78 78 + 79 79 + oauthClient = new NodeOAuthClient(clientOptions); 80 80 + 81 81 + return oauthClient; 82 82 + } 83 83 + 84 84 + export function getOAuthScope(): string { 85 85 + return OAUTH_SCOPE; 86 86 + } 87 87 + 88 88 + export function getCallbackUrl(): string { 89 89 + return CALLBACK_URL; 90 90 + } 91 91 + 92 92 + export function getCallbackPort(): number { 93 93 + return CALLBACK_PORT; 94 94 + }

+161

packages/cli/src/lib/oauth-store.ts

··· 1 1 + import * as fs from "node:fs/promises"; 2 2 + import * as os from "node:os"; 3 3 + import * as path from "node:path"; 4 4 + import type { 5 5 + NodeSavedSession, 6 6 + NodeSavedSessionStore, 7 7 + NodeSavedState, 8 8 + NodeSavedStateStore, 9 9 + } from "@atproto/oauth-client-node"; 10 10 + 11 11 + const CONFIG_DIR = path.join(os.homedir(), ".config", "sequoia"); 12 12 + const OAUTH_FILE = path.join(CONFIG_DIR, "oauth.json"); 13 13 + 14 14 + interface OAuthStore { 15 15 + states: Record<string, NodeSavedState>; 16 16 + sessions: Record<string, NodeSavedSession>; 17 17 + handles?: Record<string, string>; // DID -> handle mapping (optional for backwards compat) 18 18 + } 19 19 + 20 20 + async function fileExists(filePath: string): Promise<boolean> { 21 21 + try { 22 22 + await fs.access(filePath); 23 23 + return true; 24 24 + } catch { 25 25 + return false; 26 26 + } 27 27 + } 28 28 + 29 29 + async function loadOAuthStore(): Promise<OAuthStore> { 30 30 + if (!(await fileExists(OAUTH_FILE))) { 31 31 + return { states: {}, sessions: {} }; 32 32 + } 33 33 + 34 34 + try { 35 35 + const content = await fs.readFile(OAUTH_FILE, "utf-8"); 36 36 + return JSON.parse(content) as OAuthStore; 37 37 + } catch { 38 38 + return { states: {}, sessions: {} }; 39 39 + } 40 40 + } 41 41 + 42 42 + async function saveOAuthStore(store: OAuthStore): Promise<void> { 43 43 + await fs.mkdir(CONFIG_DIR, { recursive: true }); 44 44 + await fs.writeFile(OAUTH_FILE, JSON.stringify(store, null, 2)); 45 45 + await fs.chmod(OAUTH_FILE, 0o600); 46 46 + } 47 47 + 48 48 + /** 49 49 + * State store for PKCE flow (temporary, used during auth) 50 50 + */ 51 51 + export const stateStore: NodeSavedStateStore = { 52 52 + async set(key: string, state: NodeSavedState): Promise<void> { 53 53 + const store = await loadOAuthStore(); 54 54 + store.states[key] = state; 55 55 + await saveOAuthStore(store); 56 56 + }, 57 57 + 58 58 + async get(key: string): Promise<NodeSavedState | undefined> { 59 59 + const store = await loadOAuthStore(); 60 60 + return store.states[key]; 61 61 + }, 62 62 + 63 63 + async del(key: string): Promise<void> { 64 64 + const store = await loadOAuthStore(); 65 65 + delete store.states[key]; 66 66 + await saveOAuthStore(store); 67 67 + }, 68 68 + }; 69 69 + 70 70 + /** 71 71 + * Session store for OAuth tokens (persistent) 72 72 + */ 73 73 + export const sessionStore: NodeSavedSessionStore = { 74 74 + async set(sub: string, session: NodeSavedSession): Promise<void> { 75 75 + const store = await loadOAuthStore(); 76 76 + store.sessions[sub] = session; 77 77 + await saveOAuthStore(store); 78 78 + }, 79 79 + 80 80 + async get(sub: string): Promise<NodeSavedSession | undefined> { 81 81 + const store = await loadOAuthStore(); 82 82 + return store.sessions[sub]; 83 83 + }, 84 84 + 85 85 + async del(sub: string): Promise<void> { 86 86 + const store = await loadOAuthStore(); 87 87 + delete store.sessions[sub]; 88 88 + await saveOAuthStore(store); 89 89 + }, 90 90 + }; 91 91 + 92 92 + /** 93 93 + * List all stored OAuth session DIDs 94 94 + */ 95 95 + export async function listOAuthSessions(): Promise<string[]> { 96 96 + const store = await loadOAuthStore(); 97 97 + return Object.keys(store.sessions); 98 98 + } 99 99 + 100 100 + /** 101 101 + * Get an OAuth session by DID 102 102 + */ 103 103 + export async function getOAuthSession( 104 104 + did: string, 105 105 + ): Promise<NodeSavedSession | undefined> { 106 106 + const store = await loadOAuthStore(); 107 107 + return store.sessions[did]; 108 108 + } 109 109 + 110 110 + /** 111 111 + * Delete an OAuth session by DID 112 112 + */ 113 113 + export async function deleteOAuthSession(did: string): Promise<boolean> { 114 114 + const store = await loadOAuthStore(); 115 115 + if (!store.sessions[did]) { 116 116 + return false; 117 117 + } 118 118 + delete store.sessions[did]; 119 119 + await saveOAuthStore(store); 120 120 + return true; 121 121 + } 122 122 + 123 123 + export function getOAuthStorePath(): string { 124 124 + return OAUTH_FILE; 125 125 + } 126 126 + 127 127 + /** 128 128 + * Store handle for an OAuth session (DID -> handle mapping) 129 129 + */ 130 130 + export async function setOAuthHandle( 131 131 + did: string, 132 132 + handle: string, 133 133 + ): Promise<void> { 134 134 + const store = await loadOAuthStore(); 135 135 + if (!store.handles) { 136 136 + store.handles = {}; 137 137 + } 138 138 + store.handles[did] = handle; 139 139 + await saveOAuthStore(store); 140 140 + } 141 141 + 142 142 + /** 143 143 + * Get handle for an OAuth session by DID 144 144 + */ 145 145 + export async function getOAuthHandle(did: string): Promise<string | undefined> { 146 146 + const store = await loadOAuthStore(); 147 147 + return store.handles?.[did]; 148 148 + } 149 149 + 150 150 + /** 151 151 + * List all stored OAuth sessions with their handles 152 152 + */ 153 153 + export async function listOAuthSessionsWithHandles(): Promise< 154 154 + Array<{ did: string; handle?: string }> 155 155 + > { 156 156 + const store = await loadOAuthStore(); 157 157 + return Object.keys(store.sessions).map((did) => ({ 158 158 + did, 159 159 + handle: store.handles?.[did], 160 160 + })); 161 161 + }

+6 -6

packages/cli/src/lib/prompts.ts

··· 1 1 - import { isCancel, cancel } from "@clack/prompts"; 1 1 + import { cancel, isCancel } from "@clack/prompts"; 2 2 3 3 export function exitOnCancel<T>(value: T | symbol): T { 4 4 - if (isCancel(value)) { 5 5 - cancel("Cancelled"); 6 6 - process.exit(0); 7 7 - } 8 8 - return value as T; 4 4 + if (isCancel(value)) { 5 5 + cancel("Cancelled"); 6 6 + process.exit(0); 7 7 + } 8 8 + return value as T; 9 9 }

+62 -1

packages/cli/src/lib/types.ts

··· 4 4 publishDate?: string; // Field name for publish date (default: "publishDate", also checks "pubDate", "date", "createdAt", "created_at") 5 5 coverImage?: string; // Field name for cover image (default: "ogImage") 6 6 tags?: string; // Field name for tags (default: "tags") 7 7 + draft?: string; // Field name for draft status (default: "draft") 8 8 + slugField?: string; // Frontmatter field to use for slug (if set, uses frontmatter value; otherwise uses filepath) 9 9 + } 10 10 + 11 11 + // Strong reference for Bluesky post (com.atproto.repo.strongRef) 12 12 + export interface StrongRef { 13 13 + uri: string; // at:// URI format 14 14 + cid: string; // Content ID 15 15 + } 16 16 + 17 17 + // Bluesky posting configuration 18 18 + export interface BlueskyConfig { 19 19 + enabled: boolean; 20 20 + maxAgeDays?: number; // Only post if published within N days (default: 7) 21 21 + } 22 22 + 23 23 + // UI components configuration 24 24 + export interface UIConfig { 25 25 + components: string; // Directory to install UI components (default: src/components) 7 26 } 8 27 9 28 export interface PublisherConfig { ··· 18 37 identity?: string; // Which stored identity to use (matches identifier) 19 38 frontmatter?: FrontmatterMapping; // Custom frontmatter field mappings 20 39 ignore?: string[]; // Glob patterns for files to ignore (e.g., ["_index.md", "**/drafts/**"]) 40 40 + removeIndexFromSlug?: boolean; // Remove "/index" or "/_index" suffix from paths (default: false) 41 41 + stripDatePrefix?: boolean; // Remove YYYY-MM-DD- prefix from filenames (Jekyll-style, default: false) 42 42 + textContentField?: string; // Frontmatter field to use for textContent instead of markdown body 43 43 + bluesky?: BlueskyConfig; // Optional Bluesky posting configuration 44 44 + ui?: UIConfig; // Optional UI components configuration 21 45 } 22 46 23 23 - export interface Credentials { 47 47 + // Legacy credentials format (for backward compatibility during migration) 48 48 + export interface LegacyCredentials { 49 49 + pdsUrl: string; 50 50 + identifier: string; 51 51 + password: string; 52 52 + } 53 53 + 54 54 + // App password credentials (explicit type) 55 55 + export interface AppPasswordCredentials { 56 56 + type: "app-password"; 24 57 pdsUrl: string; 25 58 identifier: string; 26 59 password: string; 27 60 } 28 61 62 62 + // OAuth credentials (references stored OAuth session) 63 63 + // Note: pdsUrl is not needed for OAuth - the OAuth client resolves PDS from the DID 64 64 + export interface OAuthCredentials { 65 65 + type: "oauth"; 66 66 + did: string; 67 67 + handle: string; 68 68 + } 69 69 + 70 70 + // Union type for all credential types 71 71 + export type Credentials = AppPasswordCredentials | OAuthCredentials; 72 72 + 73 73 + // Helper to check credential type 74 74 + export function isOAuthCredentials( 75 75 + creds: Credentials, 76 76 + ): creds is OAuthCredentials { 77 77 + return creds.type === "oauth"; 78 78 + } 79 79 + 80 80 + export function isAppPasswordCredentials( 81 81 + creds: Credentials, 82 82 + ): creds is AppPasswordCredentials { 83 83 + return creds.type === "app-password"; 84 84 + } 85 85 + 29 86 export interface PostFrontmatter { 30 87 title: string; 31 88 description?: string; ··· 33 90 tags?: string[]; 34 91 ogImage?: string; 35 92 atUri?: string; 93 93 + draft?: boolean; 36 94 } 37 95 38 96 export interface BlogPost { ··· 41 99 frontmatter: PostFrontmatter; 42 100 content: string; 43 101 rawContent: string; 102 102 + rawFrontmatter: Record<string, unknown>; // For accessing custom fields like textContentField 44 103 } 45 104 46 105 export interface BlobRef { ··· 62 121 contentHash: string; 63 122 atUri?: string; 64 123 lastPublished?: string; 124 124 + slug?: string; // The generated slug for this post (used by inject command) 125 125 + bskyPostRef?: StrongRef; // Reference to corresponding Bluesky post 65 126 } 66 127 67 128 export interface PublicationRecord {

+43

packages/cli/test.html

··· 1 1 + <!DOCTYPE html> 2 2 + <html lang="en"> 3 3 + <head> 4 4 + <meta charset="UTF-8"> 5 5 + <meta name="viewport" content="width=device-width, initial-scale=1.0"> 6 6 + <title>Sequoia Comments Test</title> 7 7 + <!-- Link to a published document - replace with your own AT URI --> 8 8 + <link rel="site.standard.document" href="at://did:plc:kq6bvkw4sxof3vdinuitehn5/site.standard.document/3mdnztyhoem2v"> 9 9 + <style> 10 10 + body { 11 11 + font-family: system-ui, -apple-system, sans-serif; 12 12 + max-width: 800px; 13 13 + margin: 2rem auto; 14 14 + padding: 0 1rem; 15 15 + line-height: 1.6; 16 16 + background-color: #1A1A1A; 17 17 + color: #F5F3EF; 18 18 + } 19 19 + h1 { 20 20 + margin-bottom: 2rem; 21 21 + } 22 22 + /* Custom styling example */ 23 23 + :root { 24 24 + --sequoia-accent-color: #3A5A40; 25 25 + --sequoia-border-radius: 12px; 26 26 + --sequoia-bg-color: #1a1a1a; 27 27 + --sequoia-fg-color: #F5F3EF; 28 28 + --sequoia-border-color: #333; 29 29 + --sequoia-secondary-color: #8B7355; 30 30 + } 31 31 + </style> 32 32 + </head> 33 33 + <body> 34 34 + <h1>Blog Post Title</h1> 35 35 + <p>This is a test page for the sequoia-comments web component.</p> 36 36 + <p>The component will look for a <code>&lt;link rel="site.standard.document"&gt;</code> tag in the document head to find the AT Protocol document, then fetch and display Bluesky replies as comments.</p> 37 37 + 38 38 + <h2>Comments</h2> 39 39 + <sequoia-comments></sequoia-comments> 40 40 + 41 41 + <script type="module" src="./src/components/sequoia-comments.js"></script> 42 42 + </body> 43 43 + </html>

+20 -20

packages/cli/tsconfig.json

··· 1 1 { 2 2 - "compilerOptions": { 3 3 - "lib": ["ES2022"], 4 4 - "target": "ES2022", 5 5 - "module": "ESNext", 6 6 - "moduleResolution": "bundler", 7 7 - "outDir": "./dist", 8 8 - "rootDir": "./src", 9 9 - "declaration": true, 10 10 - "sourceMap": true, 11 11 - "strict": true, 12 12 - "skipLibCheck": true, 13 13 - "esModuleInterop": true, 14 14 - "resolveJsonModule": true, 15 15 - "forceConsistentCasingInFileNames": true, 16 16 - "noFallthroughCasesInSwitch": true, 17 17 - "noUncheckedIndexedAccess": true, 18 18 - "noUnusedLocals": false, 19 19 - "noUnusedParameters": false 20 20 - }, 21 21 - "include": ["src"] 2 2 + "compilerOptions": { 3 3 + "lib": ["ES2022"], 4 4 + "target": "ES2022", 5 5 + "module": "ESNext", 6 6 + "moduleResolution": "bundler", 7 7 + "outDir": "./dist", 8 8 + "rootDir": "./src", 9 9 + "declaration": true, 10 10 + "sourceMap": true, 11 11 + "strict": true, 12 12 + "skipLibCheck": true, 13 13 + "esModuleInterop": true, 14 14 + "resolveJsonModule": true, 15 15 + "forceConsistentCasingInFileNames": true, 16 16 + "noFallthroughCasesInSwitch": true, 17 17 + "noUncheckedIndexedAccess": true, 18 18 + "noUnusedLocals": false, 19 19 + "noUnusedParameters": false 20 20 + }, 21 21 + "include": ["src"] 22 22 }