datagrok-tools 6.7.6 → 6.7.7

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> datagrok-tools@6.7.6 build /home/runner/work/public/public/tools
+> datagrok-tools@6.7.7 build /home/runner/work/public/public/tools
 > node build.js
 
 Successfully compiled 51 files with Babel.

package/CHANGELOG.md

@@ -1,7 +1,8 @@
 # Datagrok-tools changelog
 
-## v.next
+## 6.7.7 (2026-10-09)
 
+* GROK-21156: `grok s users invite [<email>] [--prefix <P>] [--send-email]`: invites a user and prints a link that logs them in (no email sent; the email may be omitted); `--prefix` starts the code with `<P>`; `--send-email` mails the invitation instead
 * `grok test --skip-gc` launches the browser without `--expose-gc`, so the test runner skips its garbage collection after every test; a suite of small unit tests runs several times faster (ComputeUtils driver tests: 92 s to 19 s)
 * `grok setup` installs corepack when it is missing instead of asking for it by hand: Node 25 no longer bundles corepack, so every fresh checkout on current Node stopped at that step
 * `grok setup` also removes the `.js`/`.d.ts` files the npm-era tsc emitted beside js-api and library sources: the workspace emits into `dist/`, and a leftover `js-api/grok.js` shadowed the `grok` command in cmd.exe

package/GROK_S.md

@@ -16,6 +16,7 @@ browser or a logged-in session.
 |-------------------------------------------------------------|--------------------------------------------------------|
 | Create / update a user                                      | `grok s users save --json user.json`                   |
 | Block / unblock a user                                      | `grok s users block <login>` / `users unblock <login>` |
+| Invite a user, get a login link                             | `grok s users invite [<email>] [--prefix <P>]`         |
 | Create / update a group                                     | `grok s groups save --json group.json`                 |
 | Add or remove users in a group                              | `grok s groups add-members <group> <user>...`          |
 | List members of a group                                     | `grok s groups list-members <group>`                   |
@@ -165,8 +166,17 @@ personal groups.
 ```bash
 grok s users block   alice.mendel        # accept login, UUID, or namespace:name
 grok s users unblock alice.mendel
+grok s users invite  alice@corp.com      # prints a login link; no email is sent
+grok s users invite                      # same, for an account with no email
+grok s users invite  --prefix ALEX-      # code starts with ALEX- (letters, digits, - and _, up to 32)
+grok s users invite  alice@corp.com --send-email   # mail the invitation instead
 ```
 
+`users invite` creates the user in state `new` and prints `<server>?inviteCode=<code>`. The
+link logs straight in as that user, every time, for a year. Inviting the same email again
+prints a new link, and the earlier ones keep working. An account that has already been used
+cannot be sent a link.
+
 Both commands resolve the argument to a full user record first, so the server receives
 the entire object (matching the Python client's `grok.users.block(user)`). Blocking
 flips `status` to `Blocked` and terminates active sessions; unblocking restores `Active`.

package/bin/commands/server.js

@@ -111,6 +111,7 @@ async function server(argv) {
     if (entity === 'groups' && (verb === 'list-members' || verb === 'list-memberships')) return await handleGroupListMembers(dapi, verb, rest, argv, output);
     if (entity === 'users' && verb === 'block') return await handleUserBlock(dapi, rest, output);
     if (entity === 'users' && verb === 'unblock') return await handleUserUnblock(dapi, rest, output);
+    if (entity === 'users' && verb === 'invite') return await handleUserInvite(dapi, rest, argv, output);
     if (entity === 'tables' && verb === 'download') return await handleTablesDownload(dapi, rest, argv, output);
     if (entity === 'tables' && verb === 'upload') return await handleTablesUpload(dapi, rest, output);
     if (entity === 'packages' && verb === 'install') return await handlePackagesInstall(dapi, rest, argv, output);
@@ -214,6 +215,20 @@ async function handleUserUnblock(dapi, rest, output) {
   if (output !== 'quiet') console.log(`Unblocked ${user?.login ?? rest[0]}`);
   return true;
 }
+async function handleUserInvite(dapi, rest, argv, output) {
+  const email = rest[0] !== undefined ? String(rest[0]) : undefined;
+  const prefix = argv.prefix !== undefined ? String(argv.prefix) : undefined;
+  if (argv['send-email'] && (!email || prefix !== undefined)) {
+    (0, _serverOutput.printError)(new Error('Usage: grok s users invite <email> --send-email (no --prefix: only a link has a code)'));
+    return false;
+  }
+  const link = await dapi.users.invite(email, !!argv['send-email'], prefix);
+  if (output === 'json') (0, _serverOutput.printOutput)({
+    email: email ?? null,
+    link: link || null
+  }, output);else if (link) console.log(link);else if (output !== 'quiet') console.log(`Invitation sent to ${email}`);
+  return true;
+}
 async function handleTablesDownload(dapi, rest, argv, output) {
   const name = rest[0];
   if (!name) {
@@ -949,6 +964,10 @@ Special commands:
                                                       List parent groups
   grok s users block <id-or-login>                    Block a user from the platform
   grok s users unblock <id-or-login>                  Unblock a previously blocked user
+  grok s users invite [<email>] [--prefix <P>] [--send-email]
+                                                      Invite a user; prints a login link (no email sent).
+                                                      --prefix starts the code with <P> (e.g. ALEX-);
+                                                      --send-email mails the invitation instead
   grok s tables upload <name> <file.csv|file.d42>     Upload a CSV or d42 binary as a Datagrok table
   grok s tables download <name|Project:Table|id> [-O <file>]
                                                       Download a table as CSV (stdout by default)

package/bin/grok.js

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
 const argv = require('minimist')(process.argv.slice(2), {
   alias: {k: 'key', h: 'help', r: 'recursive'},
-  boolean: ['dartium'],
+  boolean: ['dartium', 'send-email'],
   // keep versions verbatim — minimist would coerce '1.10' to the number 1.1
-  string: ['version'],
+  string: ['version', 'prefix'],
 });
 // minimist maps `--no-retry` to `{retry: false}`, so the `args['no-retry']` checks in
 // test.ts / playwright-runner.ts never fired and `--no-retry` was silently ignored

package/bin/utils/node-dapi.js

@@ -595,6 +595,20 @@ class NodeUsersDataSource extends NodeHttpDataSource {
   async unblock(user) {
     await this.client.post('/public/v1/users/unblock', user);
   }
+
+  /**
+   * Creates the invitee (status `new`) and returns a link that logs them in, sending no email; the
+   * email may be omitted, and [prefix] goes in front of the link's code. With [sendEmail] the
+   * server mails the invitation and returns '' instead.
+   */
+  async invite(email, sendEmail = false, prefix) {
+    return this.client.post(`/users/invite${buildQuery({
+      email: email ?? '',
+      target: 'Datagrok',
+      link: sendEmail ? undefined : true,
+      prefix
+    })}`);
+  }
 }
 exports.NodeUsersDataSource = NodeUsersDataSource;
 class NodeConnectionsDataSource extends NodeHttpDataSource {

package/package.json

@@ -4,7 +4,7 @@
     "type": "git",
     "url": "https://github.com/datagrok-ai/public.git"
   },
-  "version": "6.7.6",
+  "version": "6.7.7",
   "description": "Utility to upload and publish packages to Datagrok",
   "homepage": "https://github.com/datagrok-ai/public/tree/master/tools#readme",
   "dependencies": {