peakurl 1.1.1 → 1.1.2

package/README.md

@@ -6,7 +6,7 @@ The official command-line interface for PeakURL.
 
 Use `peakurl` to create short links, inspect existing links, and manage your PeakURL account from the terminal.
 
-Learn more in the full CLI docs: <https://go.peakurl.org/7a0e0b>
+Learn more in the full CLI docs [here.](https://go.peakurl.org/2aae02)
 
 ## Install
 
@@ -66,6 +66,7 @@ export PEAKURL_API_KEY=0123456789abcdef0123456789abcdef0123456789abcdef
 | `peakurl status`                  | Show the current system status snapshot for the site.       |
 | `peakurl core download`           | Download and extract the latest PeakURL core package.       |
 | `peakurl create <url>`            | Create a new short link.                                    |
+| `peakurl edit <id-or-alias>`      | Update an existing link's destination URL or metadata.      |
 | `peakurl import <file>`           | Import links from a local CSV, JSON, or XML file.           |
 | `peakurl export`                  | Export accessible links as CSV, JSON, or XML.               |
 | `peakurl list`                    | List links in your account.                                 |
@@ -84,9 +85,24 @@ Create a short link:
 peakurl create \
     https://example.com \
     --alias example \
-    --title "Example"
+    --title "Example" \
+    --social-title "Example — Official Site" \
+    --social-description "Explore the Example platform." \
+    --social-image-url https://example.com/og.png
 ```
 
+Edit an existing short link:
+
+```bash
+peakurl edit example \
+    --url https://example.com/updated-page \
+    --social-title "Example — Updated Preview" \
+    --social-description "Updated Open Graph description." \
+    --social-image-url https://example.com/new-og.png
+```
+
+You can update a link's destination URL (`--url`), title, status, expiration, password, and social preview fields.
+
 List links as JSON:
 
 ```bash
@@ -268,8 +284,8 @@ export PEAKURL_DISABLE_UPDATE_CHECK=1
 
 ## Links
 
-- Website: <https://peakurl.org/>
-- CLI docs: <https://go.peakurl.org/7a0e0b>
-- API docs: <https://go.peakurl.org/d373f6>
-- npm package: <https://www.npmjs.com/package/peakurl>
-- Issues: <https://github.com/PeakURL/CLI/issues>
+- [Website](https://peakurl.org/)
+- [CLI docs](https://go.peakurl.org/2aae02)
+- [API docs](https://go.peakurl.org/d373f6)
+- [npm package](https://go.peakurl.org/cli)
+- [Issues](https://github.com/PeakURL/CLI/issues)

package/bin/peakurl.js

@@ -1,9 +1,13 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { readFile as readFile3 } from "fs/promises";
+import { readFile as readFile4 } from "fs/promises";
 import { Command, CommanderError, InvalidArgumentError } from "commander";
 
+// src/api/client.ts
+import { readFile, stat } from "fs/promises";
+import { basename, extname } from "path";
+
 // src/lib/errors.ts
 var CliError = class extends Error {
   exitCode;
@@ -100,6 +104,54 @@ function normalizeWebhookUrl(value) {
 }
 
 // src/api/client.ts
+var IMAGE_MIME_BY_EXTENSION = {
+  ".jpg": "image/jpeg",
+  ".jpeg": "image/jpeg",
+  ".png": "image/png",
+  ".webp": "image/webp",
+  ".gif": "image/gif"
+};
+var MAX_SOCIAL_IMAGE_BYTES = 5 * 1024 * 1024;
+async function toFormData(fields, socialImagePath) {
+  const ext = extname(socialImagePath).toLowerCase();
+  const mimeType = IMAGE_MIME_BY_EXTENSION[ext];
+  if (!mimeType) {
+    throw new CliError(
+      "Invalid social image file type. Only JPG, PNG, WEBP, and GIF images are allowed."
+    );
+  }
+  let fileStats;
+  try {
+    fileStats = await stat(socialImagePath);
+  } catch (error) {
+    throw new CliError(
+      `Could not read social image file ${socialImagePath}.`,
+      1,
+      {
+        cause: error instanceof Error ? error : void 0
+      }
+    );
+  }
+  if (fileStats.size > MAX_SOCIAL_IMAGE_BYTES) {
+    throw new CliError(
+      "Social image file is too large. Maximum size is 5MB."
+    );
+  }
+  const buffer = await readFile(socialImagePath);
+  const formData = new FormData();
+  for (const [key, value] of Object.entries(fields)) {
+    if (key === "socialImagePath" || typeof value !== "string" && typeof value !== "number" && typeof value !== "boolean") {
+      continue;
+    }
+    formData.append(key, String(value));
+  }
+  formData.append(
+    "socialImage",
+    new Blob([buffer], { type: mimeType }),
+    basename(socialImagePath)
+  );
+  return formData;
+}
 function isApiResponse(value) {
   return Boolean(
     value && typeof value === "object" && "success" in value && "message" in value && "timestamp" in value
@@ -145,8 +197,38 @@ var ApiClient = class {
    * @param payload Request body accepted by `POST /api/v1/urls`.
    * @returns API response envelope containing the created link.
    */
-  createUrl(payload) {
-    return this.request("POST", "urls", payload);
+  async createUrl(payload) {
+    if (payload.socialImagePath) {
+      const formData = await toFormData(
+        payload,
+        payload.socialImagePath
+      );
+      return this.request("POST", "urls", formData);
+    }
+    const { socialImagePath: _unused, ...jsonPayload } = payload;
+    return this.request("POST", "urls", jsonPayload);
+  }
+  /**
+   * Updates an existing short URL by its stable row ID.
+   *
+   * Sends `POST /api/v1/urls/{id}` with `multipart/form-data` when uploading a
+   * local social preview image, or `PUT /api/v1/urls/{id}` with JSON otherwise.
+   *
+   * @param id Stable link row ID.
+   * @param payload Fields to update on the short link.
+   * @returns API response envelope containing the updated link.
+   */
+  async updateUrl(id, payload) {
+    const path = `urls/${encodeURIComponent(id)}`;
+    if (payload.socialImagePath) {
+      const formData = await toFormData(
+        payload,
+        payload.socialImagePath
+      );
+      return this.request("POST", path, formData);
+    }
+    const { socialImagePath: _unused, ...jsonPayload } = payload;
+    return this.request("PUT", path, jsonPayload);
   }
   /**
    * Lists short URLs with optional pagination and filtering.
@@ -406,15 +488,16 @@ var ApiClient = class {
   async request(method, path, body, query) {
     const url = buildApiUrl(this.config.apiBaseUrl, path, query);
     let response;
+    const isFormData = body instanceof FormData;
     try {
       response = await fetch(url, {
         method,
         headers: {
           Accept: "application/json",
           Authorization: `Bearer ${this.config.apiKey}`,
-          ...body ? { "Content-Type": "application/json" } : {}
+          ...body && !isFormData ? { "Content-Type": "application/json" } : {}
         },
-        body: body ? JSON.stringify(body) : void 0
+        body: isFormData ? body : body ? JSON.stringify(body) : void 0
       });
     } catch (error) {
       throw new CliError(networkError(this.config.apiBaseUrl, error), 1, {
@@ -692,7 +775,7 @@ function formatActivitySummary(data, count) {
 }
 
 // src/config/store.ts
-import { chmod, mkdir, readFile, unlink, writeFile } from "fs/promises";
+import { chmod, mkdir, readFile as readFile2, unlink, writeFile } from "fs/promises";
 import { dirname, join } from "path";
 import envPaths from "env-paths";
 var CONFIG_FILENAME = "config.json";
@@ -731,7 +814,7 @@ var ConfigStore = class {
    */
   async load() {
     try {
-      const content = await readFile(this.filePath, "utf8");
+      const content = await readFile2(this.filePath, "utf8");
       const parsed = JSON.parse(content);
       const apiBaseUrl = typeof parsed?.apiBaseUrl === "string" ? parsed.apiBaseUrl : typeof parsed?.baseUrl === "string" ? parsed.baseUrl : void 0;
       if (typeof apiBaseUrl !== "string" || typeof parsed?.apiKey !== "string") {
@@ -821,7 +904,7 @@ var StateStore = class {
    */
   async load() {
     try {
-      const content = await readFile(this.filePath, "utf8");
+      const content = await readFile2(this.filePath, "utf8");
       const parsed = JSON.parse(content);
       return parsed && typeof parsed === "object" ? parsed : {};
     } catch {
@@ -1240,7 +1323,10 @@ var EXPORT_HEADERS = [
   "short_url",
   "clicks",
   "unique_clicks",
-  "created_at"
+  "created_at",
+  "social_title",
+  "social_description",
+  "social_image_url"
 ];
 function text(value) {
   if (typeof value === "string") {
@@ -1299,7 +1385,10 @@ function buildExportRows(links) {
     short_url: text(link.shortUrl),
     clicks: typeof link.clicks === "number" ? link.clicks : "",
     unique_clicks: typeof link.uniqueClicks === "number" ? link.uniqueClicks : "",
-    created_at: text(link.createdAt)
+    created_at: text(link.createdAt),
+    social_title: text(link.socialTitle) || text(link.socialPreview?.title),
+    social_description: text(link.socialDescription) || text(link.socialPreview?.description),
+    social_image_url: text(link.socialImageUrl) || text(link.socialPreview?.externalImageUrl) || text(link.socialPreview?.imageUrl)
   }));
 }
 function serializeLinkExport(links, format) {
@@ -1319,6 +1408,9 @@ function serializeLinkExport(links, format) {
     <clicks>${xmlValue(row2.clicks)}</clicks>
     <uniqueClicks>${xmlValue(row2.unique_clicks)}</uniqueClicks>
     <createdAt>${xmlValue(row2.created_at)}</createdAt>
+    <socialTitle>${xmlValue(row2.social_title)}</socialTitle>
+    <socialDescription>${xmlValue(row2.social_description)}</socialDescription>
+    <socialImageUrl>${xmlValue(row2.social_image_url)}</socialImageUrl>
   </url>`
     ).join("\n");
     return `<urls>
@@ -1337,7 +1429,7 @@ ${body}
 }
 
 // src/lib/imports.ts
-import { readFile as readFile2 } from "fs/promises";
+import { readFile as readFile3 } from "fs/promises";
 function text2(value) {
   return typeof value === "string" && value.trim() ? value.trim() : void 0;
 }
@@ -1424,7 +1516,16 @@ function normalizeImportRow(value) {
     ...text2(value.utmMedium) ? { utmMedium: text2(value.utmMedium) } : {},
     ...text2(value.utmCampaign) ? { utmCampaign: text2(value.utmCampaign) } : {},
     ...text2(value.utmTerm) ? { utmTerm: text2(value.utmTerm) } : {},
-    ...text2(value.utmContent) ? { utmContent: text2(value.utmContent) } : {}
+    ...text2(value.utmContent) ? { utmContent: text2(value.utmContent) } : {},
+    ...text2(value.socialTitle) || text2(value.social_title) ? {
+      socialTitle: text2(value.socialTitle) || text2(value.social_title)
+    } : {},
+    ...text2(value.socialDescription) || text2(value.social_description) ? {
+      socialDescription: text2(value.socialDescription) || text2(value.social_description)
+    } : {},
+    ...text2(value.socialImageUrl) || text2(value.social_image_url) ? {
+      socialImageUrl: text2(value.socialImageUrl) || text2(value.social_image_url)
+    } : {}
   };
 }
 function parseJson(text6) {
@@ -1495,6 +1596,18 @@ function parseCsv(text6) {
       }
       if (header === "utmcontent") {
         entry.utmContent = value;
+        return;
+      }
+      if (header === "socialtitle") {
+        entry.socialTitle = value;
+        return;
+      }
+      if (header === "socialdescription") {
+        entry.socialDescription = value;
+        return;
+      }
+      if (header === "socialimageurl" || header === "socialimage") {
+        entry.socialImageUrl = value;
       }
     });
     const link = normalizeImportRow(entry);
@@ -1532,7 +1645,10 @@ function parseXml(text6) {
       utmMedium: getValue("utmMedium"),
       utmCampaign: getValue("utmCampaign"),
       utmTerm: getValue("utmTerm"),
-      utmContent: getValue("utmContent")
+      utmContent: getValue("utmContent"),
+      socialTitle: getValue("socialTitle"),
+      socialDescription: getValue("socialDescription"),
+      socialImageUrl: getValue("socialImageUrl")
     });
   }).filter((item) => Boolean(item));
 }
@@ -1551,7 +1667,7 @@ function getImportFormat(filePath, value) {
 async function readImportRows(filePath, format) {
   let textContent;
   try {
-    textContent = await readFile2(filePath, "utf8");
+    textContent = await readFile3(filePath, "utf8");
   } catch (error) {
     throw new CliError(`Could not read import file ${filePath}.`, 1, {
       cause: error instanceof Error ? error : void 0
@@ -1672,6 +1788,10 @@ function getQuietLinkValue(link) {
   return getLinkShortUrl(link) || getLinkAlias(link) || getLinkId(link) || "";
 }
 function formatLinkDetails(link) {
+  const socialPreview = asObject2(link.socialPreview);
+  const socialTitle = asString3(link.socialTitle) || asString3(socialPreview?.title);
+  const socialDescription = asString3(link.socialDescription) || asString3(socialPreview?.description);
+  const socialImage = asString3(link.socialImageUrl) || asString3(socialPreview?.externalImageUrl) || asString3(socialPreview?.imageUrl);
   const rows2 = [
     ["ID", getLinkId(link)],
     ["Alias", getLinkAlias(link)],
@@ -1679,6 +1799,9 @@ function formatLinkDetails(link) {
     ["Destination", getLinkDestination(link)],
     ["Title", asString3(link.title)],
     ["Status", asString3(link.status)],
+    ["Social Title", socialTitle],
+    ["Social Description", socialDescription],
+    ["Social Image", socialImage],
     [
       "Clicks",
       asNumber2(link.clicks) === void 0 ? void 0 : String(link.clicks)
@@ -2667,6 +2790,11 @@ function normalizeExpiresAt(value) {
   return value;
 }
 async function createLink(destinationUrl, options) {
+  if (options.socialImage && options.socialImageUrl) {
+    throw new CliError(
+      "Use either --social-image or --social-image-url, not both."
+    );
+  }
   const config = await getAuthConfig(process.env);
   const response = await new ApiClient(config).createUrl({
     destinationUrl: normalizeDestinationUrl(destinationUrl),
@@ -2679,7 +2807,15 @@ async function createLink(destinationUrl, options) {
     ...options.utmMedium ? { utmMedium: options.utmMedium } : {},
     ...options.utmCampaign ? { utmCampaign: options.utmCampaign } : {},
     ...options.utmTerm ? { utmTerm: options.utmTerm } : {},
-    ...options.utmContent ? { utmContent: options.utmContent } : {}
+    ...options.utmContent ? { utmContent: options.utmContent } : {},
+    ...options.socialTitle ? { socialTitle: options.socialTitle } : {},
+    ...options.socialDescription ? { socialDescription: options.socialDescription } : {},
+    ...options.socialImageUrl ? {
+      socialImageUrl: normalizeDestinationUrl(
+        options.socialImageUrl
+      )
+    } : {},
+    ...options.socialImage ? { socialImagePath: resolve2(options.socialImage) } : {}
   });
   if (options.json) {
     writeJson(response);
@@ -2692,6 +2828,67 @@ async function createLink(destinationUrl, options) {
   writeStdout(successLine(response.message));
   writeStdout(formatLinkDetails(response.data));
 }
+async function editLink(idOrAlias, options) {
+  if (options.socialImage && options.socialImageUrl) {
+    throw new CliError(
+      "Use either --social-image or --social-image-url, not both."
+    );
+  }
+  if (options.removeSocialImage && (options.socialImage || options.socialImageUrl)) {
+    throw new CliError(
+      "Cannot combine --remove-social-image with --social-image or --social-image-url."
+    );
+  }
+  if (options.password !== void 0 && options.clearPassword) {
+    throw new CliError(
+      "Use either --password or --clear-password, not both."
+    );
+  }
+  if (options.expiresAt !== void 0 && options.clearExpiresAt) {
+    throw new CliError(
+      "Use either --expires-at or --clear-expires-at, not both."
+    );
+  }
+  const payload = {
+    ...options.url !== void 0 ? { destinationUrl: normalizeDestinationUrl(options.url) } : {},
+    ...options.title !== void 0 ? { title: options.title } : {},
+    ...options.clearPassword ? { clearPassword: true } : options.password !== void 0 ? { password: options.password } : {},
+    ...options.status !== void 0 ? { status: options.status } : {},
+    ...options.clearExpiresAt ? { expiresAt: "" } : options.expiresAt !== void 0 ? { expiresAt: normalizeExpiresAt(options.expiresAt) } : {},
+    ...options.socialTitle !== void 0 ? { socialTitle: options.socialTitle } : {},
+    ...options.socialDescription !== void 0 ? { socialDescription: options.socialDescription } : {},
+    ...options.socialImageUrl !== void 0 ? {
+      socialImageUrl: options.socialImageUrl ? normalizeDestinationUrl(options.socialImageUrl) : ""
+    } : {},
+    ...options.socialImage ? { socialImagePath: resolve2(options.socialImage) } : {},
+    ...options.removeSocialImage ? { removeSocialImage: true } : {}
+  };
+  if (Object.keys(payload).length === 0) {
+    throw new CliError(
+      "Specify at least one field to update (for example --title, --url, --social-title, --social-description, or --social-image-url)."
+    );
+  }
+  const config = await getAuthConfig(process.env);
+  const client = new ApiClient(config);
+  const lookupResponse = await client.getUrl(idOrAlias.trim());
+  const resolvedId = getLinkId(lookupResponse.data);
+  if (!resolvedId) {
+    throw new CliError(
+      "PeakURL returned a link record without an ID, so the CLI cannot update it safely."
+    );
+  }
+  const response = await client.updateUrl(resolvedId, payload);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(getQuietLinkValue(response.data));
+    return;
+  }
+  writeStdout(successLine(response.message || "Short URL updated."));
+  writeStdout(formatLinkDetails(response.data));
+}
 async function importLinks(filePath, options) {
   const format = getImportFormat(filePath, options.format);
   const urls = await readImportRows(filePath, format);
@@ -3365,12 +3562,12 @@ Examples:
 ${lines.map((line) => `  ${line}`).join("\n")}
 
 Documentation:
-  https://peakurl.org/docs/cli`
+  https://go.peakurl.org/2aae02`
   );
 }
 async function getCliVersion() {
   const packageJson = new URL("../package.json", import.meta.url);
-  const content = await readFile3(packageJson, "utf8");
+  const content = await readFile4(packageJson, "utf8");
   const parsed = JSON.parse(content);
   return parsed.version || "0.0.0";
 }
@@ -3425,6 +3622,7 @@ Common Commands:
   peakurl status
   peakurl core download
   peakurl list --limit 10
+  peakurl edit docs --social-title "Docs" --social-image-url https://example.com/og.png
   peakurl import ./links.csv
   peakurl export --format csv
   peakurl activity list
@@ -3433,7 +3631,7 @@ Common Commands:
   peakurl update --check
 
 Documentation:
-  https://peakurl.org/docs/cli
+  https://go.peakurl.org/2aae02
 
 Run 'peakurl <command> --help' for command-specific flags and examples.`
   ).exitOverride();
@@ -3488,13 +3686,50 @@ Run 'peakurl <command> --help' for command-specific flags and examples.`
     ).option(
       "--expires-at <iso>",
       "Expiration timestamp in ISO-8601 format"
-    ).option("--utm-source <value>", "UTM source").option("--utm-medium <value>", "UTM medium").option("--utm-campaign <value>", "UTM campaign").option("--utm-term <value>", "UTM term").option("--utm-content <value>", "UTM content").option("--json", "Print machine-readable output").option("--quiet", "Print only the created short URL").action(createLink),
+    ).option("--utm-source <value>", "UTM source").option("--utm-medium <value>", "UTM medium").option("--utm-campaign <value>", "UTM campaign").option("--utm-term <value>", "UTM term").option("--utm-content <value>", "UTM content").option("--social-title <title>", "Social preview title").option("--social-description <text>", "Social preview description").option(
+      "--social-image-url <url>",
+      "Remote image URL for social preview"
+    ).option(
+      "--social-image <path>",
+      "Local image file path for social preview"
+    ).option("--json", "Print machine-readable output").option("--quiet", "Print only the created short URL").action(createLink),
     [
       "peakurl create https://example.com/docs --alias docs",
-      'peakurl create https://example.com/launch --title "Launch Page"',
+      'peakurl create https://example.com/launch --title "Launch Page" --social-title "Launch Page" --social-image-url https://example.com/og.png',
       "peakurl create https://example.com --json"
     ]
   );
+  addExamples(
+    program.command("edit").summary("Edit an existing short link").description(
+      "Update an existing short link's destination URL, settings, or social preview by ID or alias."
+    ).helpOption("-h, --help", "Show help").argument("<id-or-alias>", "Link identifier or alias").option("--url <url>", "Updated destination URL").option("--title <title>", "Updated title").option(
+      "--password <password>",
+      "Set or update password protection"
+    ).option("--clear-password", "Remove password protection").option(
+      "--status <status>",
+      "Updated link status, for example active, inactive, or expired"
+    ).option(
+      "--expires-at <iso>",
+      "Updated expiration timestamp in ISO-8601 format"
+    ).option("--clear-expires-at", "Remove expiration timestamp").option("--social-title <title>", "Updated social preview title").option(
+      "--social-description <text>",
+      "Updated social preview description"
+    ).option(
+      "--social-image-url <url>",
+      "Updated remote image URL for social preview"
+    ).option(
+      "--social-image <path>",
+      "Upload a local image file for social preview"
+    ).option(
+      "--remove-social-image",
+      "Remove existing social preview image"
+    ).option("--json", "Print machine-readable output").option("--quiet", "Print only the short URL").action(editLink),
+    [
+      'peakurl edit docs --social-title "PeakURL Docs" --social-description "Documentation and guides" --social-image-url https://peakurl.org/og.png',
+      'peakurl edit docs --url https://peakurl.org/docs/v2 --title "Updated Docs"',
+      "peakurl edit url_123 --remove-social-image --json"
+    ]
+  );
   addExamples(
     program.command("import").summary("Import links from a file").description(
       "Import multiple short links from a local CSV, JSON, or XML file."

package/man/peakurl.1

@@ -25,6 +25,24 @@
 .Ar url
 .Op Fl -alias Ar alias
 .Op Fl -title Ar title
+.Op Fl -social-title Ar title
+.Op Fl -social-description Ar text
+.Op Fl -social-image-url Ar url
+.Op Fl -social-image Ar path
+.Op Fl -json
+.Op Fl -quiet
+.Pp
+.Nm
+.Cm edit
+.Ar id-or-alias
+.Op Fl -url Ar url
+.Op Fl -alias Ar alias
+.Op Fl -title Ar title
+.Op Fl -social-title Ar title
+.Op Fl -social-description Ar text
+.Op Fl -social-image-url Ar url
+.Op Fl -social-image Ar path
+.Op Fl -remove-social-image
 .Op Fl -json
 .Op Fl -quiet
 .Pp
@@ -44,8 +62,8 @@
 .Sh DESCRIPTION
 .Nm
 is the official command-line interface for PeakURL.
-It wraps the PeakURL HTTP API for creating, listing, importing, exporting,
-and deleting short links.
+It wraps the PeakURL HTTP API for creating, editing, listing, importing,
+exporting, and deleting short links.
 It also supports authenticated account inspection, site system status,
 outbound webhooks, CLI update checks, and public PeakURL core package
 downloads.
@@ -136,7 +154,15 @@ peakurl core download --force
 Create a short link for a destination URL.
 .Bd -literal -offset indent
 peakurl create https://example.com/docs --alias docs
-peakurl create https://example.com/launch --title "Launch Page"
+peakurl create https://example.com/launch --title "Launch Page" --social-title "Launch Page" --social-image-url https://example.com/og.png
+.Ed
+.It Cm edit Ar id-or-alias
+Update an existing short link's destination URL, title, status, expiration,
+password, or social preview fields by ID, alias, or short code.
+.Bd -literal -offset indent
+peakurl edit docs --social-title "PeakURL Docs" --social-description "Documentation and guides" --social-image-url https://peakurl.org/og.png
+peakurl edit docs --url https://peakurl.org/docs/v2 --title "Updated Docs"
+peakurl edit url_123 --remove-social-image
 .Ed
 .It Cm import Ar file
 Import short links from a local CSV, JSON, or XML file.
@@ -268,14 +294,18 @@ Print machine-readable JSON where supported.
 Print minimal output for scripts or suppress success output for destructive
 commands.
 .El
-.Ss Link Creation Options
-.Bl -tag -width "--utm-campaign"
+.Ss Link Creation And Editing Options
+.Bl -tag -width "--remove-social-image"
+.It Fl -url Ar url
+Updated destination URL when editing an existing short link.
 .It Fl -alias Ar alias
-Custom alias for the short link.
+Custom alias when creating a short link.
 .It Fl -title Ar title
 Title stored with the short link.
 .It Fl -password Ar password
 Password-protect the short link.
+.It Fl -clear-password
+Remove password protection when editing a short link.
 .It Fl -status Ar status
 Link status, for example
 .Sy active
@@ -283,16 +313,28 @@ or
 .Sy paused .
 .It Fl -expires-at Ar iso
 Expiration timestamp in ISO-8601 format.
+.It Fl -clear-expires-at
+Remove the expiration timestamp when editing a short link.
 .It Fl -utm-source Ar value
-UTM source value.
+UTM source value when creating a short link.
 .It Fl -utm-medium Ar value
-UTM medium value.
+UTM medium value when creating a short link.
 .It Fl -utm-campaign Ar value
-UTM campaign value.
+UTM campaign value when creating a short link.
 .It Fl -utm-term Ar value
-UTM term value.
+UTM term value when creating a short link.
 .It Fl -utm-content Ar value
-UTM content value.
+UTM content value when creating a short link.
+.It Fl -social-title Ar title
+Social preview (Open Graph / Twitter Card) title.
+.It Fl -social-description Ar text
+Social preview description.
+.It Fl -social-image-url Ar url
+Remote image URL for the social preview card.
+.It Fl -social-image Ar path
+Local image file (JPG, PNG, WEBP, or GIF up to 5 MB) to upload for the social preview card.
+.It Fl -remove-social-image
+Remove the existing social preview image when editing a short link.
 .El
 .Ss List Options
 .Bl -tag -width "--sort-order"
@@ -394,6 +436,7 @@ when environment credentials should no longer apply.
 .Bd -literal -offset indent
 peakurl login --base-url https://example.com/api/v1 --api-key YOUR_API_KEY
 peakurl create https://example.com/docs --alias docs
+peakurl edit docs --social-title "PeakURL Docs" --social-image-url https://peakurl.org/og.png
 peakurl list --limit 10
 peakurl get docs
 peakurl export --format json --stdout
@@ -401,11 +444,11 @@ peakurl webhook create https://example.com/api/webhooks/peakurl --event link.cli
 peakurl core download
 .Ed
 .Sh SEE ALSO
-.Lk https://peakurl.org/docs/cli "PeakURL CLI documentation"
+.Lk https://go.peakurl.org/2aae02 "PeakURL CLI documentation"
 .Pp
-.Lk https://peakurl.org/docs/api "PeakURL API documentation"
+.Lk https://go.peakurl.org/d373f6 "PeakURL API documentation"
 .Pp
-.Lk https://www.npmjs.com/package/peakurl "peakurl npm package"
+.Lk https://go.peakurl.org/cli "peakurl npm package"
 .Sh BUGS
 Report issues at
 .Lk https://github.com/PeakURL/CLI/issues .

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "peakurl",
-    "version": "1.1.1",
+    "version": "1.1.2",
     "description": "Official CLI for creating, listing, and managing PeakURL short links from the terminal",
     "homepage": "https://peakurl.org",
     "bugs": {