@bestend/confluence-cli 1.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.eslintrc.js ADDED
@@ -0,0 +1,23 @@
1
+ module.exports = {
2
+ env: {
3
+ es2021: true,
4
+ node: true,
5
+ jest: true
6
+ },
7
+ extends: [
8
+ 'eslint:recommended'
9
+ ],
10
+ parserOptions: {
11
+ ecmaVersion: 12,
12
+ sourceType: 'module'
13
+ },
14
+ rules: {
15
+ 'indent': ['error', 2],
16
+ 'linebreak-style': ['error', 'unix'],
17
+ 'quotes': ['error', 'single'],
18
+ 'semi': ['error', 'always'],
19
+ 'no-unused-vars': ['error', { argsIgnorePattern: '^_' }],
20
+ 'no-console': 'off',
21
+ 'no-process-exit': 'off'
22
+ }
23
+ };
@@ -0,0 +1,34 @@
1
+ ---
2
+ name: Bug report
3
+ about: Create a report to help us improve
4
+ title: '[BUG] '
5
+ labels: bug
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ **Describe the bug**
11
+ A clear and concise description of what the bug is.
12
+
13
+ **To Reproduce**
14
+ Steps to reproduce the behavior:
15
+ 1. Run command '...'
16
+ 2. See error
17
+
18
+ **Expected behavior**
19
+ A clear and concise description of what you expected to happen.
20
+
21
+ **Screenshots**
22
+ If applicable, add screenshots to help explain your problem.
23
+
24
+ **Environment (please complete the following information):**
25
+ - OS: [e.g. macOS, Windows, Linux]
26
+ - Node.js version: [e.g. 18.17.0]
27
+ - confluence-cli version: [e.g. 1.0.0]
28
+ - Confluence version: [e.g. Cloud, Server 8.5]
29
+
30
+ **Additional context**
31
+ Add any other context about the problem here.
32
+
33
+ **Error logs**
34
+ If applicable, add error logs or stack traces.
@@ -0,0 +1,26 @@
1
+ ---
2
+ name: Feature request
3
+ about: Suggest an idea for this project
4
+ title: '[FEATURE] '
5
+ labels: enhancement
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ **Is your feature request related to a problem? Please describe.**
11
+ A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]
12
+
13
+ **Describe the solution you'd like**
14
+ A clear and concise description of what you want to happen.
15
+
16
+ **Describe alternatives you've considered**
17
+ A clear and concise description of any alternative solutions or features you've considered.
18
+
19
+ **Use case**
20
+ Describe how this feature would be used and who would benefit from it.
21
+
22
+ **Additional context**
23
+ Add any other context or screenshots about the feature request here.
24
+
25
+ **Implementation suggestions**
26
+ If you have ideas about how this could be implemented, please share them here.
@@ -0,0 +1,37 @@
1
+ ---
2
+ name: General Feedback
3
+ about: Share your thoughts, suggestions, or general feedback about confluence-cli
4
+ title: '[FEEDBACK] '
5
+ labels: feedback, enhancement
6
+ assignees: ''
7
+
8
+ ---
9
+
10
+ ## 📝 Your Feedback
11
+
12
+ Thank you for taking the time to share your thoughts about confluence-cli!
13
+
14
+ ### What did you try to accomplish?
15
+ A clear description of what you were trying to do with confluence-cli.
16
+
17
+ ### How was your experience?
18
+ Tell us about your experience using the tool:
19
+ - What worked well?
20
+ - What was confusing or difficult?
21
+ - What features are you missing?
22
+
23
+ ### Your environment
24
+ - OS: [e.g. macOS, Windows, Linux]
25
+ - Node.js version: [e.g. 18.17.0]
26
+ - confluence-cli version: [e.g. 1.0.1]
27
+ - Confluence instance: [e.g. Cloud, Server, Data Center]
28
+
29
+ ### Feature requests or improvements
30
+ What would make confluence-cli more useful for you?
31
+
32
+ ### Additional context
33
+ Anything else you'd like to share about your experience with confluence-cli?
34
+
35
+ ---
36
+
37
+ 💡 **Tip**: You can also join our [Discussions](https://github.com/pchuri/confluence-cli/discussions) for general questions and community chat!
@@ -0,0 +1,31 @@
1
+ ## Pull Request Template
2
+
3
+ ### Description
4
+ Brief description of what this PR does.
5
+
6
+ ### Type of Change
7
+ - [ ] Bug fix (non-breaking change which fixes an issue)
8
+ - [ ] New feature (non-breaking change which adds functionality)
9
+ - [ ] Breaking change (fix or feature that would cause existing functionality to not work as expected)
10
+ - [ ] Documentation update
11
+ - [ ] Performance improvement
12
+ - [ ] Code refactoring
13
+
14
+ ### Testing
15
+ - [ ] Tests pass locally with my changes
16
+ - [ ] I have added tests that prove my fix is effective or that my feature works
17
+ - [ ] New and existing unit tests pass locally with my changes
18
+
19
+ ### Checklist
20
+ - [ ] My code follows the style guidelines of this project
21
+ - [ ] I have performed a self-review of my own code
22
+ - [ ] I have commented my code, particularly in hard-to-understand areas
23
+ - [ ] I have made corresponding changes to the documentation
24
+ - [ ] My changes generate no new warnings
25
+ - [ ] Any dependent changes have been merged and published in downstream modules
26
+
27
+ ### Screenshots (if applicable)
28
+ Add screenshots to help explain your changes.
29
+
30
+ ### Additional Context
31
+ Add any other context about the pull request here.
@@ -0,0 +1,67 @@
1
+ name: CI/CD
2
+
3
+ on:
4
+ push:
5
+ branches: [ main, develop ]
6
+ pull_request:
7
+ branches: [ main ]
8
+
9
+ jobs:
10
+ test:
11
+ runs-on: ubuntu-latest
12
+
13
+ strategy:
14
+ matrix:
15
+ node-version: [16.x, 18.x, 20.x]
16
+
17
+ steps:
18
+ - uses: actions/checkout@v3
19
+
20
+ - name: Use Node.js ${{ matrix.node-version }}
21
+ uses: actions/setup-node@v3
22
+ with:
23
+ node-version: ${{ matrix.node-version }}
24
+ cache: 'npm'
25
+
26
+ - run: npm ci
27
+ - run: npm run lint
28
+ - run: npm test
29
+
30
+ security:
31
+ runs-on: ubuntu-latest
32
+ steps:
33
+ - uses: actions/checkout@v3
34
+ - name: Run npm audit
35
+ run: npm audit --audit-level moderate
36
+
37
+ publish:
38
+ needs: [test, security]
39
+ runs-on: ubuntu-latest
40
+ if: github.ref == 'refs/heads/main'
41
+ permissions:
42
+ contents: write
43
+ issues: write
44
+ pull-requests: write
45
+
46
+ steps:
47
+ - uses: actions/checkout@v3
48
+ with:
49
+ fetch-depth: 0
50
+ token: ${{ secrets.GITHUB_TOKEN }}
51
+
52
+ - name: Setup Node.js
53
+ uses: actions/setup-node@v3
54
+ with:
55
+ node-version: '18'
56
+ registry-url: 'https://registry.npmjs.org'
57
+ env:
58
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
59
+
60
+ - run: npm ci
61
+ - run: npm test
62
+
63
+ - name: Semantic Release
64
+ uses: cycjimmy/semantic-release-action@v3
65
+ env:
66
+ GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
67
+ NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
@@ -0,0 +1,26 @@
1
+ name: Publish to npm
2
+
3
+ on:
4
+ push:
5
+ tags:
6
+ - 'v*' # e.g., v1.2.3
7
+
8
+ jobs:
9
+ publish:
10
+ runs-on: ubuntu-latest
11
+ permissions:
12
+ contents: read
13
+ id-token: write # required for npm trusted publishing (OIDC)
14
+ steps:
15
+ - uses: actions/checkout@v4
16
+
17
+ - uses: actions/setup-node@v4
18
+ with:
19
+ node-version: '20.x'
20
+ registry-url: 'https://registry.npmjs.org'
21
+
22
+ - name: Install dependencies
23
+ run: npm ci
24
+
25
+ - name: Publish with provenance via OIDC
26
+ run: npm publish --provenance --access public
package/.releaserc ADDED
@@ -0,0 +1,17 @@
1
+ {
2
+ "branches": ["main"],
3
+ "plugins": [
4
+ "@semantic-release/commit-analyzer",
5
+ "@semantic-release/release-notes-generator",
6
+ "@semantic-release/changelog",
7
+ "@semantic-release/npm",
8
+ "@semantic-release/github",
9
+ [
10
+ "@semantic-release/git",
11
+ {
12
+ "assets": ["package.json", "CHANGELOG.md"],
13
+ "message": "chore(release): ${nextRelease.version} [skip ci]\n\n${nextRelease.notes}"
14
+ }
15
+ ]
16
+ ]
17
+ }
package/CHANGELOG.md ADDED
@@ -0,0 +1,232 @@
1
+ # [1.15.0](https://github.com/pchuri/confluence-cli/compare/v1.14.0...v1.15.0) (2026-02-06)
2
+
3
+
4
+ ### Features
5
+
6
+ * Add CLI flags to confluence init for non-interactive setup ([#30](https://github.com/pchuri/confluence-cli/issues/30)) ([09b6b85](https://github.com/pchuri/confluence-cli/commit/09b6b85a243da5ab86eb61a1a2376a64ce6979c7))
7
+
8
+ # [1.14.0](https://github.com/pchuri/confluence-cli/compare/v1.13.0...v1.14.0) (2026-02-03)
9
+
10
+
11
+ ### Features
12
+
13
+ * add comments support to CLI ([d40de55](https://github.com/pchuri/confluence-cli/commit/d40de55573aa71409b3aa2743531f2a4cb5a4eda)), closes [#28](https://github.com/pchuri/confluence-cli/issues/28)
14
+
15
+ # [1.13.0](https://github.com/pchuri/confluence-cli/compare/v1.12.1...v1.13.0) (2026-01-08)
16
+
17
+
18
+ ### Features
19
+
20
+ * add children command to list child pages ([#27](https://github.com/pchuri/confluence-cli/issues/27)) ([7e8b4ed](https://github.com/pchuri/confluence-cli/commit/7e8b4ed1b0ed69a7e1de52dfaf0c1ff36973f78b))
21
+
22
+ ## [1.12.1](https://github.com/pchuri/confluence-cli/compare/v1.12.0...v1.12.1) (2025-12-31)
23
+
24
+
25
+ ### Bug Fixes
26
+
27
+ * align README with CLI behavior ([#26](https://github.com/pchuri/confluence-cli/issues/26)) ([b24c7cf](https://github.com/pchuri/confluence-cli/commit/b24c7cf4a645383812a1cb7239b1db41ded77f8d))
28
+
29
+ # [1.12.0](https://github.com/pchuri/confluence-cli/compare/v1.11.1...v1.12.0) (2025-12-31)
30
+
31
+
32
+ ### Features
33
+
34
+ * add page delete command ([#25](https://github.com/pchuri/confluence-cli/issues/25)) ([bc3e412](https://github.com/pchuri/confluence-cli/commit/bc3e412a6ccd0774d62ab0816a6c2735cbd470a4))
35
+
36
+ ## [1.11.1](https://github.com/pchuri/confluence-cli/compare/v1.11.0...v1.11.1) (2025-12-17)
37
+
38
+
39
+ ### Bug Fixes
40
+
41
+ * support children macro, improve macro handling, and filter attachments ([#23](https://github.com/pchuri/confluence-cli/issues/23)) ([15b721a](https://github.com/pchuri/confluence-cli/commit/15b721acdc296e72470ee438c9fe3470e09ae52e))
42
+
43
+ # [1.11.0](https://github.com/pchuri/confluence-cli/compare/v1.10.1...v1.11.0) (2025-12-12)
44
+
45
+
46
+ ### Features
47
+
48
+ * Support for Confluence display URLs ([#20](https://github.com/pchuri/confluence-cli/issues/20)) ([3bda7c2](https://github.com/pchuri/confluence-cli/commit/3bda7c2aad8ec02dac60f3b7c34c31b549a31cce))
49
+
50
+ ## [1.10.1](https://github.com/pchuri/confluence-cli/compare/v1.10.0...v1.10.1) (2025-12-08)
51
+
52
+
53
+ ### Bug Fixes
54
+
55
+ * improve markdown export and attachment download ([#19](https://github.com/pchuri/confluence-cli/issues/19)) ([978275d](https://github.com/pchuri/confluence-cli/commit/978275dbe71eea83138bbd537ce7d4edda8180f8))
56
+
57
+ # [1.10.0](https://github.com/pchuri/confluence-cli/compare/v1.9.0...v1.10.0) (2025-12-05)
58
+
59
+
60
+ ### Features
61
+
62
+ * export page with attachments ([#18](https://github.com/pchuri/confluence-cli/issues/18)) ([bdd9da4](https://github.com/pchuri/confluence-cli/commit/bdd9da474f13a8b6f96e64836443f65f846257a2))
63
+
64
+ # [1.9.0](https://github.com/pchuri/confluence-cli/compare/v1.8.0...v1.9.0) (2025-12-04)
65
+
66
+
67
+ ### Features
68
+
69
+ * add attachments list and download command ([#17](https://github.com/pchuri/confluence-cli/issues/17)) ([fb3d4f8](https://github.com/pchuri/confluence-cli/commit/fb3d4f81a3926fec832a39c78f4eda3b4a22130a))
70
+
71
+ # [1.8.0](https://github.com/pchuri/confluence-cli/compare/v1.7.0...v1.8.0) (2025-09-28)
72
+
73
+
74
+ ### Features
75
+
76
+ * make Confluence API path configurable ([#14](https://github.com/pchuri/confluence-cli/issues/14)) ([be000e0](https://github.com/pchuri/confluence-cli/commit/be000e0d92881d65329b84bad6555dcad0bbb455)), closes [#13](https://github.com/pchuri/confluence-cli/issues/13)
77
+
78
+ ## [Unreleased]
79
+
80
+ ### Added
81
+ - Make the Confluence REST base path configurable to support both `/rest/api` and `/wiki/rest/api`.
82
+
83
+ # [1.7.0](https://github.com/pchuri/confluence-cli/compare/v1.6.0...v1.7.0) (2025-09-28)
84
+
85
+
86
+ ### Features
87
+
88
+ * support basic auth for Atlassian API tokens ([#12](https://github.com/pchuri/confluence-cli/issues/12)) ([e80ea9b](https://github.com/pchuri/confluence-cli/commit/e80ea9b7913d5f497b60bf72149737b6f704c6b8))
89
+
90
+ # [1.6.0](https://github.com/pchuri/confluence-cli/compare/v1.5.0...v1.6.0) (2025-09-05)
91
+
92
+
93
+ ### Features
94
+
95
+ * Add copy-tree command for recursive page copying with children ([#9](https://github.com/pchuri/confluence-cli/issues/9)) ([29efa5b](https://github.com/pchuri/confluence-cli/commit/29efa5b2f8edeee1c5072ad8d7077f38f860c2ba))
96
+
97
+ # [1.5.0](https://github.com/pchuri/confluence-cli/compare/v1.4.1...v1.5.0) (2025-08-13)
98
+
99
+
100
+ ### Features
101
+
102
+ * Align README with implementation and fix update command ([#7](https://github.com/pchuri/confluence-cli/issues/7)) ([87f48e0](https://github.com/pchuri/confluence-cli/commit/87f48e03c6310bb9bfc7fda2930247c0d61414ec))
103
+
104
+ ## [1.4.1](https://github.com/pchuri/confluence-cli/compare/v1.4.0...v1.4.1) (2025-06-30)
105
+
106
+
107
+ ### Bug Fixes
108
+
109
+ * correct version display in CLI ([#6](https://github.com/pchuri/confluence-cli/issues/6)) ([36f8419](https://github.com/pchuri/confluence-cli/commit/36f8419b309ae1ff99fa94c12ace9a527ee3f162))
110
+
111
+ # [1.4.0](https://github.com/pchuri/confluence-cli/compare/v1.3.2...v1.4.0) (2025-06-30)
112
+
113
+
114
+ ### Features
115
+
116
+ * Enhanced Markdown Support with Bidirectional Conversion ([#5](https://github.com/pchuri/confluence-cli/issues/5)) ([d17771b](https://github.com/pchuri/confluence-cli/commit/d17771b40d8d60ed68c0ac0a3594fed6b9a4e771))
117
+
118
+ ## [1.3.2](https://github.com/pchuri/confluence-cli/compare/v1.3.1...v1.3.2) (2025-06-27)
119
+
120
+
121
+ ### Bug Fixes
122
+
123
+ * resolve merge conflict in CHANGELOG.md ([8565c1a](https://github.com/pchuri/confluence-cli/commit/8565c1a90243663f206285e5af3616541ee1a1d0))
124
+
125
+ ## [1.3.1](https://github.com/pchuri/confluence-cli/compare/v1.3.0...v1.3.1) (2025-06-27)
126
+
127
+
128
+ ### Bug Fixes
129
+
130
+ * clean up duplicate CHANGELOG entries ([0163deb](https://github.com/pchuri/confluence-cli/commit/0163deb7f007e1d64ce4693eb8e86280d27eb6cc))
131
+
132
+ # [1.3.0](https://github.com/pchuri/confluence-cli/compare/v1.2.0...v1.3.0) (2025-06-27)
133
+
134
+
135
+ ### Bug Fixes
136
+
137
+ * improve format handling based on production testing ([820f9cd](https://github.com/pchuri/confluence-cli/commit/820f9cdc7e59b6aa4b676eda6cff7e22865ec8fb))
138
+
139
+
140
+ ### Features
141
+
142
+ * implement page creation and update capabilities ([3c43b19](https://github.com/pchuri/confluence-cli/commit/3c43b19765f94318d01fea3a22b324ada00a77d1))
143
+
144
+ # [1.2.1](https://github.com/pchuri/confluence-cli/compare/v1.2.0...v1.2.1) (2025-06-27)
145
+
146
+
147
+ ### Bug Fixes
148
+
149
+ * **format handling**: improve compatibility across Confluence instances
150
+ - Switch from 'html' macro to 'markdown' macro for better compatibility
151
+ - Change HTML processing to direct Storage format (no macro wrapper)
152
+ - Add markdownToNativeStorage method for alternative conversion
153
+ - Fix issues discovered during production testing in real Confluence environments
154
+
155
+ # [1.2.0](https://github.com/pchuri/confluence-cli/compare/v1.1.0...v1.2.0) (2025-06-27)
156
+
157
+
158
+ ### Features
159
+
160
+ * **page management**: add page creation and update capabilities ([#2](https://github.com/pchuri/confluence-cli/issues/2)) ([b814ddf](https://github.com/pchuri/confluence-cli/commit/b814ddfd056aeac83cc7eb5d8d6db47ba9c70cdf))
161
+ - `confluence create` - Create new pages with support for Markdown, HTML, and Storage formats
162
+ - `confluence update` - Update existing page content and titles
163
+ - `confluence edit` - Export page content for editing workflow
164
+ - Support for reading content from files or inline
165
+ - Markdown to Confluence Storage format conversion
166
+ * **content formats**: support multiple input formats
167
+ - Markdown format with automatic conversion using `markdown` macro
168
+ - HTML format with direct Storage format integration
169
+ - Native Confluence Storage format
170
+ * **examples**: add sample files and demo scripts for new features
171
+
172
+ ### Breaking Changes
173
+
174
+ * None - all new features are additive
175
+
176
+ # [1.1.0](https://github.com/pchuri/confluence-cli/compare/v1.0.0...v1.1.0) (2025-06-26)
177
+
178
+
179
+ ### Features
180
+
181
+ * add analytics tracking to spaces command ([265e8f4](https://github.com/pchuri/confluence-cli/commit/265e8f42b5ba86fb50398e8b1fcfd1d85fcc54d9))
182
+ * add community feedback and analytics infrastructure ([a7ff6e8](https://github.com/pchuri/confluence-cli/commit/a7ff6e87cdc92d98f3d927ee98fac9e33aedbaae))
183
+
184
+ # 1.0.0 (2025-06-26)
185
+
186
+
187
+ ### Bug Fixes
188
+
189
+ * add explicit permissions for GitHub Actions ([fa36b29](https://github.com/pchuri/confluence-cli/commit/fa36b2974b1261c144a415ced324383b35a938fb))
190
+ * add NODE_AUTH_TOKEN for npm authentication ([2031314](https://github.com/pchuri/confluence-cli/commit/2031314ad01fc1d9b4f9557a3d1321a046cad8f3))
191
+ * resolve eslint errors and npm publish warnings ([b93285e](https://github.com/pchuri/confluence-cli/commit/b93285ee098d96c8b750dbf2be5a93f28f44706c))
192
+
193
+
194
+ ### Features
195
+
196
+ * initial release of confluence-cli ([ec04e06](https://github.com/pchuri/confluence-cli/commit/ec04e06bb0c785dcff84dabcafeeb60bf9e1658f))
197
+
198
+ # Confluence CLI Changelog
199
+
200
+ All notable changes to this project will be documented in this file.
201
+
202
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
203
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
204
+
205
+ ## [1.0.0] - 2025-06-26
206
+
207
+ ### Added
208
+ - Initial release of Confluence CLI
209
+ - Read Confluence pages by ID or URL
210
+ - Search functionality with customizable limits
211
+ - Page information display
212
+ - List all Confluence spaces
213
+ - Interactive configuration setup
214
+ - Environment variable support
215
+ - HTML and text output formats
216
+ - Comprehensive README with examples
217
+ - MIT License
218
+
219
+ ### Features
220
+ - `confluence init` - Interactive configuration setup
221
+ - `confluence read <pageId>` - Read page content with format options
222
+ - `confluence info <pageId>` - Display page information
223
+ - `confluence search <query>` - Search pages with optional limit
224
+ - `confluence spaces` - List all available spaces
225
+
226
+ ### Dependencies
227
+ - commander for CLI framework
228
+ - axios for HTTP requests
229
+ - chalk for colored output
230
+ - inquirer for interactive prompts
231
+ - html-to-text for content conversion
232
+ - ora for loading indicators