jotview 0.1.0 → 0.2.0

package/README.md

@@ -24,6 +24,7 @@ jotview                   read markdown from stdin
 
   --raw                   never shorten; always the full /d URL
   --short                 always shorten, even when small
+  --keep                  make a shortened link permanent
   --open                  open the link in your browser
   --copy                  copy the link to your clipboard
   --base-url <url>        override https://jotbins.com
@@ -51,6 +52,7 @@ jotview tells you on stderr when that happens:
 
 ```
 note: uploaded to jotbins to shorten (8768 → 30 chars). use --raw to keep it local.
+note: short link expires after 30 days unused. use --keep to keep it forever.
 ```
 
 **Shortening uploads your document.** The fragment *is* the markdown, so storing
@@ -58,6 +60,12 @@ the URL stores the text. Below the threshold nothing is uploaded and no network
 request is made at all. Use `--raw` to keep a long document local, accepting a
 URL too long to paste into most places.
 
+**Short links clean up after themselves.** One nobody opens for 30 days is
+deleted, with a 60-day window to bring it back from its waiting page. Pass
+`--keep` to make it permanent from the start, or click **Save link** on the
+waiting page any time before then. Full `/d` links are never stored, so they
+never expire.
+
 If the shortener is unreachable or rate-limited, jotview prints the full link
 and exits 0 — it never fails your pipeline over a shortening problem.
 

package/package.json

@@ -1,15 +1,36 @@
 {
   "name": "jotview",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Turn a markdown file into a jotbins /d link. Zero dependencies.",
   "type": "module",
-  "bin": { "jotview": "bin/jotview.js" },
-  "files": ["bin", "src", "vectors.json", "README.md"],
-  "engines": { "node": ">=18" },
-  "scripts": { "test": "node --test" },
-  "keywords": ["markdown", "jotbins", "cli", "share"],
+  "bin": {
+    "jotview": "bin/jotview.js"
+  },
+  "files": [
+    "bin",
+    "src",
+    "vectors.json",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "markdown",
+    "jotbins",
+    "cli",
+    "share"
+  ],
   "license": "MIT",
-  "repository": { "type": "git", "url": "git+https://github.com/jotbins/jotview.git" },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jotbins/jotview.git"
+  },
   "homepage": "https://github.com/jotbins/jotview#readme",
-  "bugs": { "url": "https://github.com/jotbins/jotview/issues" }
+  "bugs": {
+    "url": "https://github.com/jotbins/jotview/issues"
+  }
 }

package/src/cli.js

@@ -19,6 +19,7 @@ Usage:
 Options:
   --raw                     never shorten; always the full /d URL
   --short                   always shorten, even when small
+  --keep                    make a shortened link permanent
   --open                    open the link in your browser
   --copy                    copy the link to your clipboard
   --base-url <url>          override ${DEFAULT_BASE_URL}
@@ -28,6 +29,9 @@ Options:
 Links 2000 characters or fewer are printed as-is and never leave your machine.
 Longer ones are shortened via surl.jotbins.com, which uploads the document.
 Use --raw to keep it local regardless of size.
+
+Short links are deleted after 30 days unused, unless made with --keep or
+saved from the link's waiting page. Full /d links never expire.
 `;
 
 /**
@@ -35,6 +39,7 @@ Use --raw to keep it local regardless of size.
  * @property {string|null} file
  * @property {boolean} raw
  * @property {boolean} short
+ * @property {boolean} keep
  * @property {boolean} open
  * @property {boolean} copy
  * @property {string} baseUrl
@@ -49,7 +54,7 @@ Use --raw to keep it local regardless of size.
 export function parseArgs(argv) {
   /** @type {Options} */
   const opts = {
-    file: null, raw: false, short: false, open: false, copy: false,
+    file: null, raw: false, short: false, keep: false, open: false, copy: false,
     baseUrl: DEFAULT_BASE_URL, help: false, version: false,
   };
   for (let i = 0; i < argv.length; i++) {
@@ -57,6 +62,7 @@ export function parseArgs(argv) {
     switch (arg) {
       case "--raw": opts.raw = true; break;
       case "--short": opts.short = true; break;
+      case "--keep": opts.keep = true; break;
       case "--open": opts.open = true; break;
       case "--copy": opts.copy = true; break;
       case "-h": case "--help": opts.help = true; break;
@@ -83,6 +89,9 @@ export function parseArgs(argv) {
   if (opts.raw && opts.short) {
     throw new JotviewError("usage", "--raw and --short cannot be combined");
   }
+  if (opts.raw && opts.keep) {
+    throw new JotviewError("usage", "--keep has no effect with --raw: full links never expire");
+  }
   if (opts.short && opts.baseUrl !== DEFAULT_BASE_URL) {
     throw new JotviewError("usage", `--short only works with ${DEFAULT_BASE_URL}`);
   }
@@ -190,7 +199,7 @@ export async function run(argv, io) {
       return 0;
     }
 
-    const result = await shorten(rawUrl);
+    const result = await shorten(rawUrl, { permanent: opts.keep });
     let printed = rawUrl;
     if (result.ok) {
       printed = result.short;
@@ -198,6 +207,11 @@ export async function run(argv, io) {
         `note: uploaded to jotbins to shorten (${rawUrl.length} → ` +
           `${printed.length} chars). use --raw to keep it local.\n`,
       );
+      io.stderr(
+        opts.keep
+          ? "note: short link kept forever.\n"
+          : "note: short link expires after 30 days unused. use --keep to keep it forever.\n",
+      );
     } else {
       io.stderr(
         `note: upload to the shortener failed (${result.reason}); using the full ` +

package/src/shorten.js

@@ -28,7 +28,9 @@ export function shouldShorten(url, opts) {
 /**
  * Shorten a URL. Never throws — the caller falls back to the raw URL.
  * @param {string} url
- * @param {{endpoint?: string}} [options]
+ * @param {{endpoint?: string, permanent?: boolean}} [options]
+ *   `permanent` asks surl for a link that never expires. Left out of the body
+ *   when false, so the request matches what older surl versions expect.
  * @returns {Promise<{ok: true, short: string} | {ok: false, reason: string}>}
  */
 export async function shorten(url, options = {}) {
@@ -37,7 +39,7 @@ export async function shorten(url, options = {}) {
     const response = await fetch(endpoint, {
       method: "POST",
       headers: { "content-type": "application/json" },
-      body: JSON.stringify({ url }),
+      body: JSON.stringify(options.permanent ? { url, permanent: true } : { url }),
       signal: AbortSignal.timeout(TIMEOUT_MS),
     });
     if (!response.ok) {