peakurl 1.1.0 → 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://peakurl.org/docs/cli>
+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.                                 |
@@ -73,6 +74,7 @@ export PEAKURL_API_KEY=0123456789abcdef0123456789abcdef0123456789abcdef
 | `peakurl delete [id-or-alias...]` | Delete links by ID or alias, in bulk, or clear all links.   |
 | `peakurl activity <subcommand>`   | View audit logs, delete activity records, or clear history. |
 | `peakurl webhook <subcommand>`    | List, create, delete, and inspect supported webhook events. |
+| `peakurl job <cmd>`               | Manage server-side scheduled jobs.                          |
 | `peakurl update`                  | Show the latest available CLI version and install command.  |
 
 ## Examples
@@ -83,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
@@ -228,6 +245,19 @@ Check the latest available CLI version:
 peakurl update --check
 ```
 
+Manage scheduled jobs:
+
+```bash
+# List all registered scheduled jobs
+peakurl job list
+
+# Force a job to run immediately
+peakurl job run peakurl_version_check
+
+# Trigger all currently due jobs
+peakurl job run-due
+```
+
 Show the recommended install command:
 
 ```bash
@@ -254,8 +284,8 @@ export PEAKURL_DISABLE_UPDATE_CHECK=1
 
 ## Links
 
-- Website: <https://peakurl.org/>
-- CLI docs: <https://peakurl.org/docs/cli>
-- API docs: <https://peakurl.org/docs/api>
-- 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
@@ -120,7 +172,6 @@ var ApiClient = class {
   constructor(config) {
     this.config = config;
   }
-  config;
   /**
    * Loads the currently authenticated user.
    *
@@ -146,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.
@@ -314,6 +395,86 @@ var ApiClient = class {
       `webhooks/${encodeURIComponent(id)}`
     );
   }
+  /**
+   * Loads the current status of the cron scheduler.
+   *
+   * @returns API response envelope containing the scheduler status.
+   */
+  getJobStatus() {
+    return this.request("GET", "system/cron");
+  }
+  /**
+   * Triggers all due cron jobs to run.
+   *
+   * @returns API response envelope containing the execution results.
+   */
+  runDueJobs() {
+    return this.request("POST", "system/cron/run");
+  }
+  /**
+   * Forces a specific cron job to run immediately.
+   *
+   * @param id Job identifier.
+   * @returns API response envelope containing the execution result.
+   */
+  runJob(id) {
+    return this.request(
+      "POST",
+      `system/cron/run/${encodeURIComponent(id)}`
+    );
+  }
+  /**
+   * Clears cron execution history.
+   *
+   * @param jobId Optional job identifier to clear history only for one job.
+   * @returns API response envelope containing the deleted count.
+   */
+  clearJobHistory(jobId) {
+    return this.request(
+      "POST",
+      "system/cron/history/clear",
+      jobId ? { job_id: jobId } : void 0
+    );
+  }
+  /**
+   * Updates the schedule configuration for a cron job.
+   *
+   * @param id Job identifier.
+   * @param payload New configuration options.
+   * @returns API response envelope containing the updated job.
+   */
+  updateJobSchedule(id, payload) {
+    return this.request(
+      "PATCH",
+      `system/cron/jobs/${encodeURIComponent(id)}`,
+      payload
+    );
+  }
+  /**
+   * Resets a cron job schedule to its default configuration.
+   *
+   * @param id Job identifier.
+   * @returns API response envelope containing the restored job.
+   */
+  resetJobSchedule(id) {
+    return this.request(
+      "POST",
+      `system/cron/jobs/${encodeURIComponent(id)}/reset`
+    );
+  }
+  /**
+   * Updates the global cron settings, such as history retention.
+   *
+   * @param payload New global settings.
+   * @returns API response envelope containing the updated retention settings.
+   */
+  updateJobSettings(payload) {
+    return this.request(
+      "POST",
+      "system/cron/settings",
+      payload
+    );
+  }
   /**
    * Performs one authenticated API request and normalizes the response.
    *
@@ -327,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, {
@@ -613,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";
@@ -652,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") {
@@ -742,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 {
@@ -1161,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") {
@@ -1220,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) {
@@ -1240,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>
@@ -1258,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;
 }
@@ -1345,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) {
@@ -1416,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);
@@ -1453,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));
 }
@@ -1472,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
@@ -1593,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)],
@@ -1600,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)
@@ -1985,6 +2187,121 @@ ${checks}` : void 0,
   return sections.length > 0 ? sections.join("\n\n") : "No system status fields returned.";
 }
 
+// src/lib/job.ts
+function formatInterval(seconds) {
+  if (seconds < 60) return `${seconds}s`;
+  const minutes = Math.floor(seconds / 60);
+  if (minutes < 60) return `${minutes}m`;
+  const hours = Math.floor(minutes / 60);
+  if (hours < 24) return `${hours}h`;
+  const days = Math.floor(hours / 24);
+  return `${days}d`;
+}
+function formatDate(date) {
+  if (!date) return "never";
+  return new Date(date).toISOString().replace("T", " ").substring(0, 19);
+}
+function formatJobsList(status2) {
+  const rows2 = status2.jobs.map((job) => [
+    job.id,
+    job.title,
+    job.status,
+    job.is_enabled ? "yes" : "no",
+    formatDate(job.next_run_at)
+  ]);
+  const table = formatTable(
+    ["ID", "Job", "Status", "Enabled", "Next Run"],
+    rows2
+  );
+  const summary = `
+${status2.jobs_count} jobs registered.
+Timezone: ${status2.timezone}
+History retention: ${status2.retention_days} days`;
+  return `${table}${summary}`;
+}
+function formatJobDetails(job) {
+  const rows2 = [
+    ["ID", job.id],
+    ["Title", job.title],
+    ["Status", job.status],
+    ["Enabled", job.is_enabled ? "yes" : "no"],
+    ["Current interval", formatInterval(job.interval_seconds)],
+    [
+      "Recommended interval",
+      formatInterval(job.recommended_interval_seconds)
+    ],
+    ["Preferred run time", job.preferred_run_time || "none"],
+    ["Customized", job.is_customized ? "yes" : "no"],
+    ["Next run", formatDate(job.next_run_at)],
+    ["Last run", formatDate(job.last_run_at)],
+    ["Last finished", formatDate(job.last_finished_at)],
+    ["Attempts", String(job.attempts)],
+    ["Maximum attempts", String(job.max_attempts)],
+    ["Last error", job.last_error || "none"]
+  ];
+  let out = formatDetailsTable(rows2);
+  if (job.recent_runs && job.recent_runs.length > 0) {
+    out += `
+
+Recent Runs:
+${formatJobHistory(job.recent_runs)}`;
+  }
+  return out;
+}
+function formatJobHistory(runs) {
+  if (!runs || runs.length === 0) {
+    return "No recent runs.";
+  }
+  const rows2 = runs.map((run) => [
+    run.id,
+    run.status,
+    String(run.attempt),
+    formatDate(run.started_at),
+    formatDate(run.finished_at),
+    run.duration_ms ? `${run.duration_ms}ms` : "-",
+    run.output_summary || "-",
+    run.error_message || "-"
+  ]);
+  return formatTable(
+    [
+      "Run ID",
+      "Status",
+      "Attempt",
+      "Started",
+      "Finished",
+      "Duration",
+      "Summary",
+      "Error"
+    ],
+    rows2
+  );
+}
+function formatRunJobResult(result) {
+  let out = `Job: ${result.job_id}
+Status: ${result.status}`;
+  if (result.summary) {
+    out += `
+Summary: ${result.summary}`;
+  }
+  if (result.error) {
+    out += `
+Error: ${result.error}`;
+  }
+  return out;
+}
+function formatRunDueResult(result) {
+  if (!result.results || result.results.length === 0) {
+    return "No jobs were due.";
+  }
+  const rows2 = result.results.map((r) => [
+    r.job_id,
+    r.status,
+    r.summary || "-",
+    r.error || "-"
+  ]);
+  return formatTable(["Job ID", "Status", "Summary", "Error"], rows2);
+}
+
 // src/lib/update.ts
 var PACKAGE_NAME = "peakurl";
 var DEFAULT_REGISTRY_URL = "https://registry.npmjs.org";
@@ -2473,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),
@@ -2485,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);
@@ -2498,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);
@@ -2927,6 +3318,230 @@ async function whoami(options) {
   writeStdout(userTable(response.data, config.apiBaseUrl));
 }
 
+// src/commands/job.ts
+async function getClient() {
+  const config = await getAuthConfig(process.env);
+  return new ApiClient(config);
+}
+async function listJobs(options) {
+  const client = await getClient();
+  const response = await client.getJobStatus();
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    const ids = response.data.jobs.map((job) => job.id).join("\n");
+    if (ids) {
+      writeStdout(ids);
+    }
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatJobsList(response.data));
+}
+async function getJob(id, options) {
+  const client = await getClient();
+  const response = await client.getJobStatus();
+  const job = response.data.jobs.find((j) => j.id === id);
+  if (!job) {
+    throw new CliError(`Job '${id}' not found.`, 1);
+  }
+  if (options.json) {
+    writeJson({
+      success: true,
+      message: "Job loaded.",
+      data: job,
+      timestamp: response.timestamp
+    });
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(job.id);
+    return;
+  }
+  writeStdout(successLine(`Job ${job.id} loaded.`));
+  writeStdout();
+  writeStdout(formatJobDetails(job));
+}
+async function runJob(id, options) {
+  const client = await getClient();
+  const response = await client.runJob(id);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(response.data.status);
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatRunJobResult(response.data));
+}
+async function runDueJobs(options) {
+  const client = await getClient();
+  const response = await client.runDueJobs();
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    const statuses = response.data.results.map((r) => r.status).join("\n");
+    if (statuses) {
+      writeStdout(statuses);
+    }
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatRunDueResult(response.data));
+}
+async function listJobHistory(id, options) {
+  const client = await getClient();
+  const response = await client.getJobStatus();
+  const job = response.data.jobs.find((j) => j.id === id);
+  if (!job) {
+    throw new CliError(`Job '${id}' not found.`, 1);
+  }
+  if (options.json) {
+    writeJson({
+      success: true,
+      message: "History loaded.",
+      data: job.recent_runs || [],
+      timestamp: response.timestamp
+    });
+    return;
+  }
+  if (options.quiet) {
+    const ids = (job.recent_runs || []).map((r) => r.id).join("\n");
+    if (ids) {
+      writeStdout(ids);
+    }
+    return;
+  }
+  writeStdout(successLine(`History for job ${job.id} loaded.`));
+  writeStdout();
+  writeStdout(formatJobHistory(job.recent_runs || []));
+}
+async function clearJobHistory(options) {
+  const client = await getClient();
+  const response = await client.clearJobHistory(options.job);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message));
+}
+async function updateJobSchedule(id, options) {
+  const client = await getClient();
+  if (options.enabled && options.disabled) {
+    throw new CliError("Cannot specify both --enabled and --disabled.", 1);
+  }
+  const payload = {};
+  if (options.interval !== void 0) {
+    const interval = parseInt(options.interval, 10);
+    if (isNaN(interval) || interval <= 0) {
+      throw new CliError("Interval must be a positive integer.", 1);
+    }
+    payload.interval_seconds = interval;
+  }
+  if (options.preferredTime !== void 0) {
+    if (options.preferredTime.toLowerCase() === "none" || options.preferredTime === "") {
+      payload.preferred_run_time = null;
+    } else if (/^([0-1]?[0-9]|2[0-3]):[0-5][0-9]$/.test(options.preferredTime)) {
+      payload.preferred_run_time = options.preferredTime;
+    } else {
+      throw new CliError(
+        "Preferred time must be in HH:MM format or 'none'.",
+        1
+      );
+    }
+  }
+  if (options.enabled !== void 0) {
+    payload.is_enabled = true;
+  } else if (options.disabled !== void 0) {
+    payload.is_enabled = false;
+  }
+  if (Object.keys(payload).length === 0) {
+    throw new CliError("No schedule changes requested.", 1);
+  }
+  const response = await client.updateJobSchedule(id, payload);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatJobDetails(response.data));
+}
+async function resetJobSchedule(id, options) {
+  const client = await getClient();
+  const response = await client.resetJobSchedule(id);
+  if (options.json) {
+    writeJson(response);
+    return;
+  }
+  if (options.quiet) {
+    return;
+  }
+  writeStdout(successLine(response.message));
+  writeStdout();
+  writeStdout(formatJobDetails(response.data));
+}
+async function updateJobSettings(options) {
+  const client = await getClient();
+  if (options.retentionDays !== void 0) {
+    const days = parseInt(options.retentionDays, 10);
+    if (isNaN(days) || days < 0) {
+      throw new CliError(
+        "Retention days must be a non-negative integer.",
+        1
+      );
+    }
+    const response2 = await client.updateJobSettings({
+      retention_days: days
+    });
+    if (options.json) {
+      writeJson(response2);
+      return;
+    }
+    if (options.quiet) {
+      writeStdout(String(response2.data.retention_days));
+      return;
+    }
+    writeStdout(successLine(response2.message));
+    return;
+  }
+  const response = await client.getJobStatus();
+  if (options.json) {
+    writeJson({
+      success: true,
+      message: "Settings loaded.",
+      data: {
+        retention_days: response.data.retention_days,
+        timezone: response.data.timezone
+      },
+      timestamp: response.timestamp
+    });
+    return;
+  }
+  if (options.quiet) {
+    writeStdout(String(response.data.retention_days));
+    return;
+  }
+  writeStdout(successLine("Settings loaded."));
+  writeStdout(`History retention: ${response.data.retention_days} days`);
+  writeStdout(`Timezone: ${response.data.timezone}`);
+}
+
 // src/index.ts
 function parseNumber(label) {
   return (value) => {
@@ -2947,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";
 }
@@ -2961,7 +3576,7 @@ function getRetryCommandName(argv) {
   if (!first || first.startsWith("-")) {
     return void 0;
   }
-  if (first === "webhook" || first === "webhooks" || first === "activity" || first === "activities") {
+  if (first === "webhook" || first === "activity" || first === "job") {
     const second = argv[3]?.trim();
     if (second && !second.startsWith("-")) {
       return `${first} ${second}`;
@@ -2969,10 +3584,33 @@ function getRetryCommandName(argv) {
   }
   return first;
 }
+var COMMAND_SUGGESTIONS = {
+  activities: "activity",
+  webhooks: "webhook",
+  jobs: "job",
+  cron: "job",
+  "scheduled-jobs": "job",
+  links: "list",
+  urls: "list"
+};
 async function main() {
   const program = new Command();
   const version = await getCliVersion();
-  program.name("peakurl").description("Manage your PeakURL site from the terminal.").helpOption("-h, --help", "Show help").helpCommand("help [command]", "Show help for a command").version(version, "-v, --version", "Show CLI version").showHelpAfterError().showSuggestionAfterError().addHelpText(
+  program.name("peakurl").description("Manage your PeakURL site from the terminal.").helpOption("-h, --help", "Show help").helpCommand("help [command]", "Show help for a command").version(version, "-v, --version", "Show CLI version").configureOutput({
+    outputError: (str, write) => {
+      const match = /error: unknown command '([^']+)'/.exec(str);
+      if (match && COMMAND_SUGGESTIONS[match[1]]) {
+        const suggestion = COMMAND_SUGGESTIONS[match[1]];
+        write(
+          `error: unknown command '${match[1]}'. Did you mean 'peakurl ${suggestion}'?
+
+`
+        );
+        return;
+      }
+      write(str);
+    }
+  }).showHelpAfterError().showSuggestionAfterError().addHelpText(
     "after",
     `
 Get Started:
@@ -2984,13 +3622,16 @@ 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
+  peakurl job list
   peakurl webhook list
   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();
@@ -3045,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."
@@ -3104,7 +3782,7 @@ Run 'peakurl <command> --help' for command-specific flags and examples.`
       "peakurl delete --all"
     ]
   );
-  const activity = program.command("activity").alias("activities").summary("View and manage activity logs").helpOption("-h, --help", "Show help").description(
+  const activity = program.command("activity").summary("View and manage activity logs").helpOption("-h, --help", "Show help").description(
     "View audit log activity entries, delete specific records, or clear all history."
   );
   addExamples(activity, [
@@ -3150,7 +3828,92 @@ Run 'peakurl <command> --help' for command-specific flags and examples.`
     ),
     ["peakurl update", "peakurl update --check", "peakurl update --json"]
   );
-  const webhook = program.command("webhook").alias("webhooks").summary("Manage webhooks").helpOption("-h, --help", "Show help").description("Manage outbound webhook integrations.");
+  const jobCmd = program.command("job").summary("Manage scheduled jobs").description(
+    "Manage server-side scheduled jobs, view their execution history, and run them manually."
+  ).helpOption("-h, --help", "Show help");
+  addExamples(jobCmd, [
+    "peakurl job",
+    "peakurl job list",
+    "peakurl job get peakurl_version_check",
+    "peakurl job run peakurl_version_check",
+    "peakurl job run-due"
+  ]);
+  addExamples(
+    jobCmd.command("list", { isDefault: true }).summary("List scheduled jobs").description("List all registered scheduled jobs.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Print only job IDs").action(listJobs),
+    [
+      "peakurl job",
+      "peakurl job list",
+      "peakurl job list --json",
+      "peakurl job list --quiet"
+    ]
+  );
+  addExamples(
+    jobCmd.command("get").summary("Show job details").description(
+      "Show detailed configuration and status for one scheduled job."
+    ).helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Print only the job ID").action(getJob),
+    [
+      "peakurl job get peakurl_version_check",
+      "peakurl job get peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("run").summary("Run a scheduled job").description("Force a specific scheduled job to run immediately.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Print only the execution status").action(runJob),
+    [
+      "peakurl job run peakurl_version_check",
+      "peakurl job run peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("run-due").summary("Run due jobs").description("Trigger all scheduled jobs that are currently due.").helpOption("-h, --help", "Show help").option("--json", "Print machine-readable output").option("--quiet", "Print only the execution statuses").action(runDueJobs),
+    ["peakurl job run-due", "peakurl job run-due --json"]
+  );
+  addExamples(
+    jobCmd.command("history").summary("View job history").description("View recent execution history for a scheduled job.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Print only history record IDs").action(listJobHistory),
+    [
+      "peakurl job history peakurl_version_check",
+      "peakurl job history peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("clear-history").summary("Clear job history").description(
+      "Clear execution history for all jobs or a specific job."
+    ).helpOption("-h, --help", "Show help").option("--job <id>", "Specific job identifier to clear").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(clearJobHistory),
+    [
+      "peakurl job clear-history",
+      "peakurl job clear-history --job peakurl_version_check",
+      "peakurl job clear-history --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("schedule").summary("Update job schedule").description("Update the schedule configuration for a job.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--interval <seconds>", "Execution interval in seconds").option(
+      "--preferred-time <time>",
+      "Preferred run time (HH:MM or 'none')"
+    ).option("--enabled", "Enable the job").option("--disabled", "Disable the job").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(updateJobSchedule),
+    [
+      "peakurl job schedule peakurl_version_check --interval 43200",
+      "peakurl job schedule peakurl_version_check --preferred-time 03:00",
+      "peakurl job schedule peakurl_version_check --disabled"
+    ]
+  );
+  addExamples(
+    jobCmd.command("reset").summary("Reset job schedule").description("Reset a job's schedule to its default configuration.").helpOption("-h, --help", "Show help").argument("<id>", "Job identifier").option("--json", "Print machine-readable output").option("--quiet", "Suppress success output").action(resetJobSchedule),
+    [
+      "peakurl job reset peakurl_version_check",
+      "peakurl job reset peakurl_version_check --json"
+    ]
+  );
+  addExamples(
+    jobCmd.command("settings").summary("Manage scheduler settings").description("View or update global scheduler settings.").helpOption("-h, --help", "Show help").option(
+      "--retention-days <days>",
+      "Number of days to keep execution history"
+    ).option("--json", "Print machine-readable output").option("--quiet", "Print minimal output").action(updateJobSettings),
+    [
+      "peakurl job settings",
+      "peakurl job settings --retention-days 14",
+      "peakurl job settings --json"
+    ]
+  );
+  const webhook = program.command("webhook").summary("Manage webhooks").helpOption("-h, --help", "Show help").description("Manage outbound webhook integrations.");
   addExamples(webhook, [
     "peakurl webhook",
     "peakurl webhook list",

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.
@@ -195,6 +221,54 @@ List supported webhook event identifiers.
 .Bd -literal -offset indent
 peakurl webhook events
 .Ed
+.It Cm job list
+List all registered scheduled jobs.
+.Bd -literal -offset indent
+peakurl job list
+peakurl job list --json
+.Ed
+.It Cm job get Ar id
+Fetch one scheduled job by ID.
+.Bd -literal -offset indent
+peakurl job get peakurl_version_check
+.Ed
+.It Cm job run Ar id
+Force a specific scheduled job to run immediately.
+.Bd -literal -offset indent
+peakurl job run peakurl_version_check
+.Ed
+.It Cm job run-due
+Trigger all scheduled jobs that are currently due.
+.Bd -literal -offset indent
+peakurl job run-due
+.Ed
+.It Cm job history Ar id
+View recent execution history for a scheduled job.
+.Bd -literal -offset indent
+peakurl job history peakurl_version_check
+.Ed
+.It Cm job clear-history
+Clear execution history for all jobs or a specific job.
+.Bd -literal -offset indent
+peakurl job clear-history
+peakurl job clear-history --job peakurl_version_check
+.Ed
+.It Cm job schedule Ar id
+Update the schedule configuration for a job.
+.Bd -literal -offset indent
+peakurl job schedule peakurl_version_check --interval 43200 --preferred-time 03:00 --enabled
+.Ed
+.It Cm job reset Ar id
+Reset a job's schedule to its default configuration.
+.Bd -literal -offset indent
+peakurl job reset peakurl_version_check
+.Ed
+.It Cm job settings
+View or update global scheduler settings.
+.Bd -literal -offset indent
+peakurl job settings
+peakurl job settings --retention-days 14
+.Ed
 .It Cm update
 Check for a newer CLI version and print the npm install command when an
 update is available.
@@ -220,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
@@ -235,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"
@@ -346,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
@@ -353,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.0",
+    "version": "1.1.2",
     "description": "Official CLI for creating, listing, and managing PeakURL short links from the terminal",
     "homepage": "https://peakurl.org",
     "bugs": {
@@ -55,16 +55,16 @@
     },
     "devDependencies": {
         "@eslint/js": "^10.0.1",
-        "@types/node": "^26.4.1",
-        "eslint": "^10.9.1",
+        "@types/node": "^26.6.2",
+        "eslint": "^10.11.0",
         "eslint-config-prettier": "^10.1.8",
         "eslint-plugin-prettier": "^5.5.6",
         "globals": "^17.12.0",
-        "prettier": "^3.9.6",
+        "prettier": "^3.9.8",
         "tsup": "^8.5.1",
-        "tsx": "^4.23.13",
+        "tsx": "^4.23.15",
         "typescript": "^5.9.3",
-        "typescript-eslint": "^8.69.0"
+        "typescript-eslint": "^8.70.1"
     },
     "license": "MIT"
 }