@displaydev/cli 0.3.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;
             }
         },
@@ -272,26 +275,44 @@ export var ApiClient = /*#__PURE__*/ function() {
             key: "find",
             value: function find(params) {
                 return _async_to_generator(function() {
-                    var searchParams, qs;
+                    var searchParams, qs, res;
                     return _ts_generator(this, function(_state) {
-                        searchParams = new URLSearchParams();
-                        if (params.query) {
-                            searchParams.set('q', params.query);
-                        }
-                        if (params.published_by) {
-                            searchParams.set('published_by', params.published_by);
-                        }
-                        if (params.since) {
-                            searchParams.set('since', params.since);
-                        }
-                        if (params.limit) {
-                            searchParams.set('limit', String(params.limit));
+                        switch(_state.label){
+                            case 0:
+                                searchParams = new URLSearchParams();
+                                if (params.query) {
+                                    searchParams.set('q', params.query);
+                                }
+                                if (params.mine) {
+                                    searchParams.append('author', 'me');
+                                }
+                                if (params.published_by) {
+                                    searchParams.set('published_by', params.published_by);
+                                }
+                                if (params.since) {
+                                    searchParams.set('since', params.since);
+                                }
+                                if (params.sort) {
+                                    searchParams.set('sort', params.sort);
+                                }
+                                if (params.dir) {
+                                    searchParams.set('dir', params.dir);
+                                }
+                                if (params.limit) {
+                                    searchParams.set('limit', String(params.limit));
+                                }
+                                qs = searchParams.toString();
+                                return [
+                                    4,
+                                    this.request('GET', "/v1/artifacts".concat(qs ? "?".concat(qs) : ''))
+                                ];
+                            case 1:
+                                res = _state.sent();
+                                return [
+                                    2,
+                                    res.data
+                                ];
                         }
-                        qs = searchParams.toString();
-                        return [
-                            2,
-                            this.request('GET', "/v1/artifacts".concat(qs ? "?".concat(qs) : ''))
-                        ];
                     });
                 }).call(this);
             }

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
                         })
                     ];
@@ -367,12 +384,26 @@ program.command('publish <path>').description('Publish an HTML or Markdown file'
     })();
 });
 // --- find ---
-program.command('find [query]').description('Search for artifacts').option('--by <email>', 'Filter by publisher email').option('--since <date>', 'Filter by date (ISO format)').action(function(query, opts) {
+program.command('find [query]').description('Search for artifacts').option('--by <email>', 'Filter by publisher email').option('--mine', 'Show only artifacts you published').option('--since <date>', 'Filter by date (ISO format)').option('--sort <col>', 'Sort column: updated_at, view_count, name', 'updated_at').option('--dir <direction>', 'Sort direction: asc or desc').option('--limit <n>', 'Max rows to fetch (1-100)', function(v) {
+    return parseInt(v, 10);
+}).action(function(query, opts) {
     return _async_to_generator(function() {
         var auth, client, results, _iteratorNormalCompletion, _didIteratorError, _iteratorError, _iterator, _step, a;
         return _ts_generator(this, function(_state) {
             switch(_state.label){
                 case 0:
+                    if (opts.sort && ![
+                        'updated_at',
+                        'view_count',
+                        'name'
+                    ].includes(opts.sort)) {
+                        console.error("Invalid --sort: ".concat(opts.sort, ". Use updated_at, view_count, or name."));
+                        process.exit(1);
+                    }
+                    if (opts.dir && opts.dir !== 'asc' && opts.dir !== 'desc') {
+                        console.error("Invalid --dir: ".concat(opts.dir, ". Use asc or desc."));
+                        process.exit(1);
+                    }
                     return [
                         4,
                         resolveAuthOrConfig()
@@ -385,7 +416,11 @@ program.command('find [query]').description('Search for artifacts').option('--by
                         client.find({
                             query: query,
                             published_by: opts.by,
-                            since: opts.since
+                            mine: opts.mine,
+                            since: opts.since,
+                            sort: opts.sort,
+                            dir: opts.dir,
+                            limit: opts.limit
                         })
                     ];
                 case 2:

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
                             })
                         ];
@@ -309,8 +345,18 @@ function registerTools(server, api) {
     server.tool('find', 'Search for artifacts in the organization', {
         query: z.string().optional().describe('Search by artifact name'),
         published_by: z.string().optional().describe('Filter by publisher email'),
+        mine: z.boolean().optional().describe('Limit results to your own artifacts'),
         since: z.string().optional().describe('Filter by updated since ISO date'),
-        limit: z.number().optional().describe('Max results to return')
+        sort: z.enum([
+            'updated_at',
+            'view_count',
+            'name'
+        ]).optional().describe('Sort column'),
+        dir: z.enum([
+            'asc',
+            'desc'
+        ]).optional().describe('Sort direction'),
+        limit: z.number().optional().describe('Max results to return (1-100)')
     }, function(args) {
         return _async_to_generator(function() {
             var results;

package/package.json

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