@gravity-rail/cli 0.40.0 → 0.42.0

package/dist/lib.js

@@ -7510,6 +7510,23 @@ async function readBindings(hctx) {
   }
   return payload;
 }
+var CREATE_INBOX_ARG = {
+  name: "create-inbox",
+  description: "Comma-separated Inbox slot keys to fill by creating an Inbox (one per installation, named for the Bundle; needs inboxes:write)"
+};
+async function readSlotTargets(hctx) {
+  const bindings = await readBindings(hctx);
+  const keys = (optionalString(hctx.args, "create-inbox") ?? "").split(",").map((key) => key.trim()).filter(Boolean);
+  if (keys.length === 0) return bindings;
+  const merged = { ...bindings };
+  for (const key of keys) {
+    if (merged[key]) {
+      throw new CLIError(`--create-inbox "${key}" is also set in --bindings; choose one`);
+    }
+    merged[key] = { kind: "new_inbox" };
+  }
+  return merged;
+}
 async function guardConflict(run, hint2) {
   try {
     return await run();
@@ -7583,18 +7600,20 @@ var installationCommands = [
       {
         name: "bindings",
         description: "Path to a JSON object mapping slot keys to targets"
-      }
+      },
+      CREATE_INBOX_ARG
     ],
     examples: [
       "gr bundles install -w $WID --bundle <bundle-uuid> --allow-write",
-      "gr bundles install -w $WID --bundle <bundle-uuid> --bindings bindings.json --allow-write"
+      "gr bundles install -w $WID --bundle <bundle-uuid> --bindings bindings.json --allow-write",
+      "gr bundles install -w $WID --bundle <bundle-uuid> --create-inbox program.inbox --allow-write"
     ],
     handler: async (hctx) => {
       const bundle = requireBundleUuid(hctx);
       const summary = await getBundleSummary(hctx, bundle);
       const version = summary.publishedVersion;
       if (version == null) throw new CLIError("Publish the Bundle before installing it");
-      const bindings = await readBindings(hctx);
+      const bindings = await readSlotTargets(hctx);
       const result2 = await guardConflict(
         () => client(hctx).installBundle(hctx.workspace, bundle, {
           version,
@@ -7709,6 +7728,7 @@ var installationCommands = [
         name: "bindings",
         description: "Path to a JSON object mapping new slot keys to targets"
       },
+      CREATE_INBOX_ARG,
       { name: "preview", description: "Show what would change and write nothing", isFlag: true }
     ],
     examples: [
@@ -7725,7 +7745,7 @@ var installationCommands = [
         );
         return;
       }
-      const bindings = await readBindings(hctx);
+      const bindings = await readSlotTargets(hctx);
       const result2 = await guardConflict(
         () => client(hctx).upgradeInstallation(hctx.workspace, uuid, {
           toVersion: to,
@@ -7767,17 +7787,17 @@ var installationCommands = [
       INSTALLATION_ARG,
       {
         name: "bindings",
-        description: "Path to a JSON object mapping slot keys to targets",
-        required: true
-      }
+        description: "Path to a JSON object mapping slot keys to targets"
+      },
+      CREATE_INBOX_ARG
     ],
     examples: [
       "gr bundles bind -w $WID --installation <installation-uuid> --bindings bindings.json --allow-write"
     ],
     handler: async (hctx) => {
-      const bindings = await readBindings(hctx);
+      const bindings = await readSlotTargets(hctx);
       if (!bindings || Object.keys(bindings).length === 0) {
-        throw new CLIError("--bindings must name at least one slot");
+        throw new CLIError("--bindings or --create-inbox must name at least one slot");
       }
       const result2 = await guardConflict(
         () => client(hctx).bindInstallationSlots(hctx.workspace, installationUuid(hctx), {
@@ -7862,6 +7882,18 @@ function parseDraftItems(payload) {
   });
   return items;
 }
+function parseDraftLinks(payload) {
+  const links = payload.links;
+  if (links === void 0) return void 0;
+  if (!Array.isArray(links)) throw new CLIError('"links" must be an array');
+  links.forEach((link, index) => {
+    const record2 = link;
+    if (typeof record2 !== "object" || record2 === null || typeof record2.label !== "string" || typeof record2.url !== "string") {
+      throw new CLIError(`links[${index}] needs string "label" and "url"`);
+    }
+  });
+  return links;
+}
 async function currentGeneration(hctx, uuid) {
   const expected2 = optionalNumber(hctx.args, "expected-generation");
   if (expected2 !== void 0) {
@@ -7937,6 +7969,14 @@ Draft generation: ${version.draftGeneration}
     hctx.ctx,
     ITEM_COLUMNS
   );
+  if (version.links?.length) {
+    process.stdout.write(
+      `
+Links:
+${version.links.map((link) => `  ${link.label}: ${link.url}`).join("\n")}
+`
+    );
+  }
   if (version.releaseNotes) {
     process.stdout.write(`
 Release notes:
@@ -8106,7 +8146,7 @@ var bundlesDomain = {
     },
     {
       path: ["bundles", "draft", "set"],
-      description: 'Replace draft items from {"items": [...]}; use --expected-generation from draft get to protect edits.',
+      description: 'Replace draft items from {"items": [...]}; an optional "links": [{"label", "url"}] replaces the draft links. Use --expected-generation from draft get to protect edits.',
       requiresWorkspace: true,
       mutates: true,
       args: [BUNDLE_ARG, GENERATION_ARG],
@@ -8115,11 +8155,13 @@ var bundlesDomain = {
       ],
       handler: async (hctx) => {
         const items = parseDraftItems(hctx.data);
+        const links = parseDraftLinks(hctx.data);
         const uuid = bundleUuid(hctx);
         const expectedGeneration = await currentGeneration(hctx, uuid);
         const result2 = await client2(hctx).replaceBundleDraft(hctx.workspace, uuid, {
           expectedGeneration,
-          items
+          items,
+          ...links ? { links } : {}
         });
         writeVersionDetail(hctx, result2);
       }
@@ -8168,28 +8210,30 @@ var bundlesDomain = {
     },
     {
       path: ["bundles", "grant"],
-      description: "Share a published Bundle within its organization with full source visibility",
+      description: "Share a published Bundle with its organization, or with everyone as a superuser",
       requiresWorkspace: true,
       mutates: true,
       args: [
         BUNDLE_ARG,
         ...sharingArgs.filter((arg) => arg.name !== "disclosure").map(
-          (arg) => arg.name === "to" ? { ...arg, description: "organization (publishing organization only)" } : arg.name === "uuid" ? { ...arg, description: "Publishing organization UUID", required: true } : arg
+          (arg) => arg.name === "to" ? {
+            ...arg,
+            description: "organization (publishing organization only) | global (everyone; superuser only)"
+          } : arg.name === "uuid" ? {
+            ...arg,
+            description: "Publishing organization UUID (omit with --to global)"
+          } : arg
         )
       ],
       examples: [
-        "gr bundles grant -w $WID --allow-write --bundle <bundle-uuid> --to organization --uuid <org-uuid>"
+        "gr bundles grant -w $WID --allow-write --bundle <bundle-uuid> --to organization --uuid <org-uuid>",
+        "gr bundles grant -w $WID --allow-write --bundle <bundle-uuid> --to global"
       ],
       handler: async (hctx) => {
-        if (requireString(hctx.args, "to") === "global") {
-          throw new CLIError(
-            "Bundle sharing is organization-only; official solution approval uses the staff catalog command"
-          );
-        }
         const request = sharingRequest(hctx.args, "full");
-        if (request.granteeType !== "organization") {
+        if (request.granteeType === "workspace") {
           throw new CLIError(
-            "Share Bundles with their organization, then install per workspace"
+            "Share Bundles with their organization or with everyone, then install per workspace"
           );
         }
         const bundleRequest = {