@displaydev/cli 0.4.0 → 0.5.0

package/README.md

@@ -52,12 +52,25 @@ Extraction pattern: `/Your verification code is: (\d{6})/`.
 ## Usage
 
 ```bash
-# Publish a file
+# Publish a file (defaults to company auth)
 dsp publish ./report.html --name "Q1 Report"
 
-# Update an existing artifact
+# Publish as public (no login required to view)
+dsp publish ./report.html --name "Q1 Report" --public
+
+# Share with external recipients (repeatable)
+dsp publish ./proposal.html --name "Q1 Proposal" \
+  --share bob@partner.com --share alice@client.com
+
+# Update an existing artifact (keeps current visibility/shares if not specified)
 dsp publish ./report.html --id abc123
 
+# Change an existing artifact back to company auth
+dsp publish ./report.html --id abc123 --company
+
+# Remove all guest shares from an existing artifact
+dsp publish ./report.html --id abc123 --clear-shares
+
 # Search artifacts
 dsp find
 dsp find "quarterly" --by alice@acme.com
@@ -72,6 +85,20 @@ dsp delete abc123 --confirm
 dsp mcp
 ```
 
+### Publish flags
+
+| Flag | Effect |
+|---|---|
+| `--name <name>` | Artifact display name. Required for new artifacts. |
+| `--id <shortId>` | Update an existing artifact (publishes a new version). |
+| `--public` | Set visibility to public (no auth required to view). |
+| `--company` | Set visibility to company auth (default for new artifacts). |
+| `--share <email>` | Grant guest access to an external email (repeatable). |
+| `--clear-shares` | Remove all guest shares. Only valid with `--id`. |
+| `--theme <theme>` | Markdown rendering theme. |
+
+Visibility and share flags **default to "keep current"** on update: omitting `--public`/`--company` leaves visibility unchanged, and omitting `--share`/`--clear-shares` leaves the guest list unchanged. `--public`/`--company` are mutually exclusive; `--share`/`--clear-shares` are mutually exclusive.
+
 ## MCP
 
 The CLI doubles as an MCP server over stdio. Add to your MCP client config:

package/dist/api-client.js

@@ -265,6 +265,9 @@ export var ApiClient = /*#__PURE__*/ function() {
                         }
                     }
                 }
+                if (params.clearShares) {
+                    form.append('clearGuestEmails', 'true');
+                }
                 return form;
             }
         },

package/dist/main.js

@@ -288,7 +288,7 @@ function collectEmails(value, prev) {
     return prev.concat(value);
 }
 // --- publish ---
-program.command('publish <path>').description('Publish an HTML or Markdown file').option('--name <name>', 'Artifact display name').option('--id <shortId>', 'Update existing artifact (new version)').option('--public', 'Make artifact publicly accessible').option('--share <email>', 'Share with guest email (repeatable)', collectEmails, []).option('--theme <theme>', 'Markdown theme (default: github)').action(function(filePath, opts) {
+program.command('publish <path>').description('Publish an HTML or Markdown file').option('--name <name>', 'Artifact display name').option('--id <shortId>', 'Update existing artifact (new version)').option('--public', 'Make artifact publicly accessible').option('--company', 'Restrict artifact to company auth (default for new artifacts)').option('--share <email>', 'Share with guest email (repeatable)', collectEmails, []).option('--clear-shares', 'Remove all guest email shares (update only)').option('--theme <theme>', 'Markdown theme (default: github)').action(function(filePath, opts) {
     return _async_to_generator(function() {
         var auth, client, ext, content, format, visibility, share, result, verb;
         return _ts_generator(this, function(_state) {
@@ -298,6 +298,18 @@ program.command('publish <path>').description('Publish an HTML or Markdown file'
                         console.error('--name is required for new artifacts. Use --id to update an existing one.');
                         process.exit(1);
                     }
+                    if (opts.public && opts.company) {
+                        console.error('Use --public or --company, not both.');
+                        process.exit(1);
+                    }
+                    if (opts.clearShares && opts.share.length > 0) {
+                        console.error('Use --share or --clear-shares, not both.');
+                        process.exit(1);
+                    }
+                    if (opts.clearShares && !opts.id) {
+                        console.error('--clear-shares only applies when updating (--id).');
+                        process.exit(1);
+                    }
                     return [
                         4,
                         resolveAuthOrConfig()
@@ -317,7 +329,11 @@ program.command('publish <path>').description('Publish an HTML or Markdown file'
                 case 2:
                     content = _state.sent();
                     format = ext === '.md' ? 'md' : 'html';
-                    visibility = opts.public ? 'public' : undefined;
+                    if (opts.public) {
+                        visibility = 'public';
+                    } else if (opts.company) {
+                        visibility = 'company';
+                    }
                     share = opts.share.length > 0 ? opts.share : undefined;
                     if (!opts.id) return [
                         3,
@@ -331,6 +347,7 @@ program.command('publish <path>').description('Publish an HTML or Markdown file'
                             name: opts.name,
                             theme: opts.theme,
                             share: share,
+                            clearShares: opts.clearShares,
                             visibility: visibility
                         })
                     ];

package/dist/mcp-server.js

@@ -170,11 +170,12 @@ function registerTools(server, api) {
             'md'
         ]).default('html').describe('Content format'),
         theme: z.string().optional().describe('Theme for Markdown rendering'),
-        share: z.array(z.string()).optional().describe('Email addresses to share with'),
+        share: z.array(z.string()).optional().describe('Email addresses to share with. Omit to keep current shares on update.'),
+        clear_shares: z.boolean().optional().describe('Set true to remove all guest shares (update only, mutually exclusive with share).'),
         visibility: z.enum([
             'public',
             'company'
-        ]).default('company').describe('Artifact visibility')
+        ]).optional().describe('Artifact visibility. Omit to keep current on update; defaults to "company" on create.')
     }, function(args) {
         return _async_to_generator(function() {
             var _args_name, content, hasContent, hasFilePath, absPath, result, _args_name1;
@@ -198,6 +199,40 @@ function registerTools(server, api) {
                                 }
                             ];
                         }
+                        if (args.share && args.clear_shares) {
+                            return [
+                                2,
+                                {
+                                    content: [
+                                        {
+                                            type: 'text',
+                                            text: JSON.stringify({
+                                                error: 'conflicting_params',
+                                                message: 'Pass share or clear_shares, not both'
+                                            })
+                                        }
+                                    ],
+                                    isError: true
+                                }
+                            ];
+                        }
+                        if (args.clear_shares && !args.short_id) {
+                            return [
+                                2,
+                                {
+                                    content: [
+                                        {
+                                            type: 'text',
+                                            text: JSON.stringify({
+                                                error: 'clear_shares_requires_short_id',
+                                                message: 'clear_shares only applies when updating an existing artifact (short_id)'
+                                            })
+                                        }
+                                    ],
+                                    isError: true
+                                }
+                            ];
+                        }
                         hasContent = args.content !== undefined;
                         hasFilePath = args.file_path !== undefined;
                         if (hasContent && hasFilePath) {
@@ -266,6 +301,7 @@ function registerTools(server, api) {
                                 name: ((_args_name1 = args.name) === null || _args_name1 === void 0 ? void 0 : _args_name1.trim()) || undefined,
                                 theme: args.theme,
                                 share: args.share,
+                                clearShares: args.clear_shares,
                                 visibility: args.visibility
                             })
                         ];

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@displaydev/cli",
-  "version": "0.4.0",
+  "version": "0.5.0",
   "type": "module",
   "bin": {
     "dsp": "dist/main.js"