feat: add content property commands (list, get, set, delete) by mshddev · Pull Request #38 · pchuri/confluence-cli

mshddev · 2026-02-14T09:07:53Z

Summary

Add four new commands for managing Confluence content properties (key-value metadata on pages)
property-list — list all properties on a page
property-get — get a single property by key
property-set — create or update a property with auto-versioning (accepts --value JSON or --file)
property-delete — delete a property with confirmation prompt

Changes

lib/confluence-client.js — 4 new client methods (listProperties, getProperty, setProperty, deleteProperty)
bin/confluence.js — 4 new CLI commands with standard analytics, chalk output, and error handling
tests/confluence-client.test.js — 11 new tests covering success, error, URL resolution, and auto-versioning
README.md — Feature bullet, commands table entries, and usage examples section

Test plan

npm test — all 60 tests pass (11 new)
node bin/confluence.js property-list --help — help text renders correctly
node bin/confluence.js --help — all 4 new commands appear in help output

Closes #37

🤖 Generated with Claude Code

- Add listProperties, getProperty, setProperty, deleteProperty to client - Add property-list, property-get, property-set, property-delete CLI commands - setProperty auto-versions (creates at v1, increments on update) - Add 11 tests for content property methods - Update README with commands table and usage examples Closes pchuri#37 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Copilot

Pull request overview

Adds first-class CLI support for Confluence content properties (entity properties) by extending the Confluence client and wiring new commands into the CLI, with accompanying tests and documentation updates.

Changes:

Added ConfluenceClient methods to list/get/set (with auto-versioning)/delete content properties.
Added four CLI commands: property-list, property-get, property-set, property-delete (with formatting and delete confirmation).
Added Jest tests for the new client methods and updated README with usage and command-table entries.

Reviewed changes

Copilot reviewed 3 out of 4 changed files in this pull request and generated 5 comments.

File	Description
`lib/confluence-client.js`	Adds property CRUD methods (including auto-versioning for set).
`bin/confluence.js`	Adds 4 new CLI commands for managing content properties.
`tests/confluence-client.test.js`	Adds tests covering property list/get/set/delete and versioning behaviors.
`README.md`	Documents the new “Content Properties” feature, commands, and examples.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Copilot · 2026-02-14T10:22:26Z

+  async deleteProperty(pageIdOrUrl, key) {
+    const pageId = await this.extractPageId(pageIdOrUrl);
+    await this.client.delete(`/content/${pageId}/property/${key}`);
+    return { pageId: String(pageId), key };


deleteProperty interpolates key directly into the URL path. Use URL-encoding for the key to ensure properties with reserved characters can be deleted reliably.

Copilot · 2026-02-14T10:22:27Z

+    test('getProperty should return property data', async () => {
+      const mock = new MockAdapter(client.client);
+      mock.onGet('/content/123/property/color').reply(200, {
+        key: 'color',
+        value: { hex: '#ff0000' },


Consider adding a test case for a property key that requires URL-encoding (e.g., contains a space or "/"). This will catch regressions once the client encodes keys in request paths.

Copilot · 2026-02-14T10:22:27Z

+  async getProperty(pageIdOrUrl, key) {
+    const pageId = await this.extractPageId(pageIdOrUrl);
+    const response = await this.client.get(`/content/${pageId}/property/${key}`);
+    return response.data;


Property keys are interpolated directly into the URL path. If a key contains characters that require URL-encoding (e.g., spaces, slashes, unicode), requests will hit the wrong endpoint or fail. Encode the key when building the request URL (e.g., via encodeURIComponent) and keep the unencoded key in the request body.

Property keys containing reserved characters (spaces, slashes) would break API requests. Wrap keys with encodeURIComponent() in URL paths for getProperty, setProperty, and deleteProperty. Also update README to show <pageId_or_url> for property commands. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mshddev · 2026-02-14T11:27:20Z

@pchuri All 5 review comments addressed in fdc63d6:

Property keys are now encodeURIComponent()-encoded in all URL paths (getProperty, setProperty, deleteProperty)
README updated to <pageId_or_url> for property commands
Added test covering keys with reserved characters (my prop/key)

Ready for re-review when you get a chance.

pchuri

Thanks for the additions! A few things to consider:

Pagination: listProperties only returns the first page. The Confluence API paginates properties, so consider adding limit/start + nextStart support (and a getAllProperties helper) to avoid missing data (lib/confluence-client.js:878).
CLI: property-list currently has no pagination controls. Adding --limit/--start/--all (similar to comments/attachments) would let users access full results (bin/confluence.js:602).
Tests: URL-encoding coverage only exists for getProperty. Add cases for setProperty and deleteProperty to prevent regressions (tests/confluence-client.test.js:845).

…est coverage listProperties now supports limit/start params and returns {results, nextStart}. Added getAllProperties helper for fetching all pages. CLI property-list command gains --limit, --start, and --all options. Added URL-encoding regression tests for setProperty and deleteProperty. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

mshddev · 2026-02-14T15:18:17Z

Thanks for the additions! A few things to consider:

Pagination: listProperties only returns the first page. The Confluence API paginates properties, so consider adding limit/start + nextStart support (and a getAllProperties helper) to avoid missing data (lib/confluence-client.js:878).

CLI: property-list currently has no pagination controls. Adding --limit/--start/--all (similar to comments/attachments) would let users access full results (bin/confluence.js:602).

Tests: URL-encoding coverage only exists for getProperty. Add cases for setProperty and deleteProperty to prevent regressions (tests/confluence-client.test.js:845).

good points. Updated. Please recheck @pchuri

pchuri

Thank you for the follow-up changes. I noticed one CI-related issue and a small doc update:

CI: npm audit --audit-level moderate fails because of the markdown-it advisory (>=13.0.0 <14.1.1). Would you mind bumping markdown-it to ^14.1.1 (or running npm audit fix) and updating package-lock.json? That should clear the audit gate.
Docs: property-list now supports --limit/--start/--all, but the README command table still lists only --format. Could we update the options list?

Thanks!

mshddev · 2026-02-15T08:21:10Z

Thank you for the follow-up changes. I noticed one CI-related issue and a small doc update:

CI: npm audit --audit-level moderate fails because of the markdown-it advisory (>=13.0.0 <14.1.1). Would you mind bumping markdown-it to ^14.1.1 (or running npm audit fix) and updating package-lock.json? That should clear the audit gate.

Docs: property-list now supports --limit/--start/--all, but the README command table still lists only --format. Could we update the options list?

Thanks!

Updated! Please recheck when you have time @pchuri

# [1.18.0](v1.17.0...v1.18.0) (2026-02-15) ### Features * add content property commands (list, get, set, delete) ([#38](#38)) ([506515d](506515d)), closes [#37](#37)

github-actions · 2026-02-15T08:42:14Z

🎉 This PR is included in version 1.18.0 🎉

The release is available on:

Your semantic-release bot 📦🚀

pchuri requested a review from Copilot February 14, 2026 10:18

Copilot started reviewing on behalf of pchuri February 14, 2026 10:19 View session

Copilot AI reviewed Feb 14, 2026

View reviewed changes

This comment was marked as duplicate.

Sign in to view

pchuri reviewed Feb 14, 2026

View reviewed changes

pchuri reviewed Feb 15, 2026

View reviewed changes

update README and package-lock for content properties pagination support

3edb3b2

pchuri merged commit 506515d into pchuri:main Feb 15, 2026
5 checks passed

github-actions Bot added the released label Feb 15, 2026

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

feat: add content property commands (list, get, set, delete)#38

feat: add content property commands (list, get, set, delete)#38
pchuri merged 4 commits intopchuri:mainfrom
mshddev:feature/add-content-properties

mshddev commented Feb 14, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

Uh oh!

Copilot AI Feb 14, 2026

Uh oh!

Uh oh!

Copilot AI Feb 14, 2026

Uh oh!

Copilot AI Feb 14, 2026

Uh oh!

mshddev commented Feb 14, 2026 •

edited

Loading

Uh oh!

This comment was marked as duplicate.

Uh oh!

pchuri left a comment •

edited

Loading

Uh oh!

mshddev commented Feb 14, 2026 •

edited

Loading

Uh oh!

pchuri left a comment

Uh oh!

mshddev commented Feb 15, 2026

Uh oh!

Uh oh!

github-actions Bot commented Feb 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

Conversation

mshddev commented Feb 14, 2026

Summary

Changes

Test plan

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

Copilot AI Feb 14, 2026

Choose a reason for hiding this comment

Uh oh!

mshddev commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

This comment was marked as duplicate.

Uh oh!

pchuri left a comment • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

mshddev commented Feb 14, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

pchuri left a comment

Choose a reason for hiding this comment

Uh oh!

mshddev commented Feb 15, 2026

Uh oh!

Uh oh!

github-actions Bot commented Feb 15, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

mshddev commented Feb 14, 2026 •

edited

Loading

pchuri left a comment •

edited

Loading

mshddev commented Feb 14, 2026 •

edited

Loading