@displaydev/cli 0.4.0 → 0.6.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,9 +265,58 @@ export var ApiClient = /*#__PURE__*/ function() {
                         }
                     }
                 }
+                if (params.clearShares) {
+                    form.append('clearGuestEmails', 'true');
+                }
+                if (params.showBranding) {
+                    form.append('showBranding', params.showBranding);
+                }
                 return form;
             }
         },
+        {
+            key: "getOrgBranding",
+            value: function getOrgBranding() {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        return [
+                            2,
+                            this.request('GET', '/v1/org/branding')
+                        ];
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "setOrgBranding",
+            value: function setOrgBranding(showBranding) {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        return [
+                            2,
+                            this.request('PUT', '/v1/org/branding', {
+                                showBranding: showBranding
+                            })
+                        ];
+                    });
+                }).call(this);
+            }
+        },
+        {
+            key: "setArtifactBranding",
+            value: function setArtifactBranding(shortId, showBranding) {
+                return _async_to_generator(function() {
+                    return _ts_generator(this, function(_state) {
+                        return [
+                            2,
+                            this.request('POST', "/v1/artifacts/".concat(shortId, "/branding"), {
+                                showBranding: showBranding
+                            })
+                        ];
+                    });
+                }).call(this);
+            }
+        },
         {
             key: "find",
             value: function find(params) {

package/dist/main.js

@@ -287,10 +287,26 @@ var program = new Command().name('dsp').description('display.dev CLI — publish
 function collectEmails(value, prev) {
     return prev.concat(value);
 }
+var SHOW_BRANDING_VALUES = new Set([
+    'show',
+    'hide',
+    'inherit'
+]);
+function parseShowBrandingFlag(raw) {
+    if (!raw) {
+        return undefined;
+    }
+    var normalized = raw.toLowerCase();
+    if (!SHOW_BRANDING_VALUES.has(normalized)) {
+        console.error("Invalid --show-branding: ".concat(raw, ". Use show, hide, or inherit."));
+        process.exit(1);
+    }
+    return normalized;
+}
 // --- 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)').option('--show-branding <mode>', 'display.dev bar override: show, hide, or inherit (paid plans only)').action(function(filePath, opts) {
     return _async_to_generator(function() {
-        var auth, client, ext, content, format, visibility, share, result, verb;
+        var showBranding, auth, client, ext, content, format, visibility, share, result, err, msg, verb;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
@@ -298,6 +314,19 @@ 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);
+                    }
+                    showBranding = parseShowBrandingFlag(opts.showBranding);
                     return [
                         4,
                         resolveAuthOrConfig()
@@ -317,11 +346,23 @@ 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;
+                    _state.label = 3;
+                case 3:
+                    _state.trys.push([
+                        3,
+                        8,
+                        ,
+                        9
+                    ]);
                     if (!opts.id) return [
                         3,
-                        4
+                        5
                     ];
                     return [
                         4,
@@ -331,16 +372,18 @@ program.command('publish <path>').description('Publish an HTML or Markdown file'
                             name: opts.name,
                             theme: opts.theme,
                             share: share,
-                            visibility: visibility
+                            clearShares: opts.clearShares,
+                            visibility: visibility,
+                            showBranding: showBranding
                         })
                     ];
-                case 3:
+                case 4:
                     result = _state.sent();
                     return [
                         3,
-                        6
+                        7
                     ];
-                case 4:
+                case 5:
                     return [
                         4,
                         client.publish({
@@ -349,13 +392,32 @@ program.command('publish <path>').description('Publish an HTML or Markdown file'
                             format: format,
                             theme: opts.theme,
                             share: share,
-                            visibility: visibility
+                            visibility: visibility,
+                            showBranding: showBranding
                         })
                     ];
-                case 5:
-                    result = _state.sent();
-                    _state.label = 6;
                 case 6:
+                    result = _state.sent();
+                    _state.label = 7;
+                case 7:
+                    return [
+                        3,
+                        9
+                    ];
+                case 8:
+                    err = _state.sent();
+                    msg = _instanceof(err, Error) ? err.message : String(err);
+                    if (/paid plan|upgrade/i.test(msg)) {
+                        console.error('Error: Hiding display.dev branding requires a paid plan. See https://display.dev/billing');
+                    } else {
+                        console.error(msg);
+                    }
+                    process.exit(1);
+                    return [
+                        3,
+                        9
+                    ];
+                case 9:
                     console.log(result.url);
                     verb = opts.id ? 'Updated' : 'Published';
                     console.log("".concat(verb, " ").concat(result.name, " (").concat(result.shortId, ") v").concat(result.version));
@@ -1004,6 +1066,65 @@ program.command('login').description('Authenticate with display.dev').option('--
         });
     })();
 });
+// --- branding ---
+program.command('branding <shortId> <mode>').description('Override display.dev branding for an existing artifact without re-publishing (show|hide|inherit)').action(function(shortId, modeRaw) {
+    return _async_to_generator(function() {
+        var mode, auth, client, result, err, msg;
+        return _ts_generator(this, function(_state) {
+            switch(_state.label){
+                case 0:
+                    mode = parseShowBrandingFlag(modeRaw);
+                    if (!mode) {
+                        console.error('mode is required');
+                        process.exit(1);
+                    }
+                    return [
+                        4,
+                        resolveAuthOrConfig()
+                    ];
+                case 1:
+                    auth = _state.sent();
+                    client = createClient(auth);
+                    _state.label = 2;
+                case 2:
+                    _state.trys.push([
+                        2,
+                        4,
+                        ,
+                        5
+                    ]);
+                    return [
+                        4,
+                        client.setArtifactBranding(shortId, mode)
+                    ];
+                case 3:
+                    result = _state.sent();
+                    console.log("".concat(result.shortId, " branding=").concat(result.showBranding === null ? 'inherit' : result.showBranding ? 'show' : 'hide'));
+                    return [
+                        3,
+                        5
+                    ];
+                case 4:
+                    err = _state.sent();
+                    msg = _instanceof(err, Error) ? err.message : String(err);
+                    if (/paid plan|upgrade/i.test(msg)) {
+                        console.error('Error: Hiding display.dev branding requires a paid plan. See https://display.dev/billing');
+                    } else {
+                        console.error(msg);
+                    }
+                    process.exit(1);
+                    return [
+                        3,
+                        5
+                    ];
+                case 5:
+                    return [
+                        2
+                    ];
+            }
+        });
+    })();
+});
 // --- mcp ---
 program.command('mcp').description('Start MCP server over stdin/stdout').action(function() {
     return _async_to_generator(function() {

package/dist/mcp-server.js

@@ -27,6 +27,14 @@ function _async_to_generator(fn) {
         });
     };
 }
+function _instanceof(left, right) {
+    "@swc/helpers - instanceof";
+    if (right != null && typeof Symbol !== "undefined" && right[Symbol.hasInstance]) {
+        return !!right[Symbol.hasInstance](left);
+    } else {
+        return left instanceof right;
+    }
+}
 function _ts_generator(thisArg, body) {
     var f, y, t, _ = {
         label: 0,
@@ -170,11 +178,17 @@ 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.'),
+        show_branding: z.enum([
+            'show',
+            'hide',
+            'inherit'
+        ]).optional().describe('display.dev attribution bar override. Paid tier only; defaults to org setting when omitted.')
     }, function(args) {
         return _async_to_generator(function() {
             var _args_name, content, hasContent, hasFilePath, absPath, result, _args_name1;
@@ -198,6 +212,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,7 +314,9 @@ 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,
-                                visibility: args.visibility
+                                clearShares: args.clear_shares,
+                                visibility: args.visibility,
+                                showBranding: args.show_branding
                             })
                         ];
                     case 4:
@@ -284,7 +334,8 @@ function registerTools(server, api) {
                                 format: args.format,
                                 theme: args.theme,
                                 share: args.share,
-                                visibility: args.visibility
+                                visibility: args.visibility,
+                                showBranding: args.show_branding
                             })
                         ];
                     case 6:
@@ -425,4 +476,130 @@ function registerTools(server, api) {
             });
         })();
     });
+    // Agent-native parity for the artifact-detail per-artifact toggle.
+    // Metadata-only: does NOT bump the artifact version. Use the `publish`
+    // tool (with `show_branding`) when you're changing content at the same
+    // time so both writes happen in one transaction.
+    server.tool('artifact_set_branding', 'Override display.dev branding for an existing artifact without re-publishing. Paid tiers only (free-tier orgs must keep inherit).', {
+        short_id: z.string().describe('Artifact shortId'),
+        show_branding: z.enum([
+            'show',
+            'hide',
+            'inherit'
+        ]).describe('show = force branding on; hide = force off; inherit = follow org default')
+    }, function(args) {
+        return _async_to_generator(function() {
+            var result, err, msg;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            api.setArtifactBranding(args.short_id, args.show_branding)
+                        ];
+                    case 1:
+                        result = _state.sent();
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: JSON.stringify(result)
+                                    }
+                                ]
+                            }
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        msg = _instanceof(err, Error) ? err.message : String(err);
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: JSON.stringify({
+                                            error: 'request_failed',
+                                            message: msg
+                                        })
+                                    }
+                                ],
+                                isError: true
+                            }
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
+    // Agent-native parity for the Settings → Branding dashboard toggle.
+    // Pairs with `publish`'s `show_branding` param: this tool controls the
+    // default; that param overrides it per-artifact.
+    server.tool('org_set_branding', 'Enable or disable display.dev branding for every artifact in the org (paid tiers only). Per-artifact overrides keep precedence.', {
+        enabled: z.boolean().describe('true to show the bar by default; false to hide it')
+    }, function(args) {
+        return _async_to_generator(function() {
+            var result, err, msg;
+            return _ts_generator(this, function(_state) {
+                switch(_state.label){
+                    case 0:
+                        _state.trys.push([
+                            0,
+                            2,
+                            ,
+                            3
+                        ]);
+                        return [
+                            4,
+                            api.setOrgBranding(args.enabled)
+                        ];
+                    case 1:
+                        result = _state.sent();
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: JSON.stringify(result)
+                                    }
+                                ]
+                            }
+                        ];
+                    case 2:
+                        err = _state.sent();
+                        msg = _instanceof(err, Error) ? err.message : String(err);
+                        return [
+                            2,
+                            {
+                                content: [
+                                    {
+                                        type: 'text',
+                                        text: JSON.stringify({
+                                            error: 'request_failed',
+                                            message: msg
+                                        })
+                                    }
+                                ],
+                                isError: true
+                            }
+                        ];
+                    case 3:
+                        return [
+                            2
+                        ];
+                }
+            });
+        })();
+    });
 }

package/package.json

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