goto-now 0.0.0-stage → 1.0.0

package/README.md

@@ -1,3 +1,16 @@
-# Temporary Holding Version
+# Link Shortener
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Create and manage GoTo.now short links from your terminal.
+
+```sh
+npm install --global goto-now
+goto login
+goto shorten https://example.com/long-page --slug example
+goto list
+goto get example
+goto analytics example
+goto qr example -o example.png
+goto delete example
+```
+
+Create an approved API key in your GoTo.now dashboard. For CI, set `GOTO_API_KEY`.

package/bin/goto.js

@@ -0,0 +1,156 @@
+#!/usr/bin/env node
+'use strict';
+
+const fs = require('node:fs');
+const os = require('node:os');
+const path = require('node:path');
+const pkg = require('../package.json');
+
+const defaultBase = 'https://goto.now';
+
+function configFile() {
+  const root = process.env.XDG_CONFIG_HOME || (process.platform === 'win32' && process.env.APPDATA) || path.join(os.homedir(), '.config');
+  return path.join(root, 'goto-now', 'config.json');
+}
+
+function config() {
+  try { return JSON.parse(fs.readFileSync(configFile(), 'utf8')); }
+  catch (error) { if (error.code === 'ENOENT') return {}; throw error; }
+}
+
+function save(value) {
+  fs.mkdirSync(path.dirname(configFile()), { recursive: true, mode: 0o700 });
+  fs.writeFileSync(configFile(), `${JSON.stringify(value, null, 2)}\n`, { mode: 0o600 });
+  try { fs.chmodSync(configFile(), 0o600); } catch {}
+}
+
+function secret(label) {
+  if (!process.stdin.isTTY || !process.stdout.isTTY || !process.stdin.setRawMode) throw new Error('Interactive login requires a terminal; use GOTO_API_KEY in scripts.');
+  return new Promise((resolve, reject) => {
+    let value = '';
+    process.stdout.write(label); process.stdin.setRawMode(true); process.stdin.resume(); process.stdin.setEncoding('utf8');
+    const done = (error) => { process.stdin.setRawMode(false); process.stdin.pause(); process.stdin.off('data', input); process.stdout.write('\n'); error ? reject(error) : resolve(value.trim()); };
+    const input = (key) => {
+      if (key === '\u0003') return done(new Error('Cancelled.'));
+      if (key === '\r' || key === '\n') return done();
+      if (key === '\u007f' || key === '\b') value = value.slice(0, -1); else if (key >= ' ') value += key;
+    };
+    process.stdin.on('data', input);
+  });
+}
+
+function credentials() {
+  const stored = config();
+  return {
+    key: process.env.GOTO_API_KEY || stored.apiKey,
+    base: (process.env.GOTO_BASE_URL || stored.baseUrl || defaultBase).replace(/\/$/, ''),
+  };
+}
+
+async function request(endpoint, { method = 'GET', body, binary = false, headers = {} } = {}) {
+  const auth = credentials();
+  if (!auth.key) throw new Error('No API key found. Run `goto login` or set GOTO_API_KEY.');
+  const response = await fetch(`${auth.base}${endpoint}`, {
+    method,
+    headers: { Authorization: `Bearer ${auth.key}`, 'User-Agent': `goto-now/${pkg.version}`, ...(body ? { 'Content-Type': 'application/json' } : {}), ...headers },
+    body: body ? JSON.stringify(body) : undefined,
+    signal: AbortSignal.timeout(30_000),
+  });
+  if (binary && response.ok) return Buffer.from(await response.arrayBuffer());
+  const data = await response.json().catch(() => ({}));
+  if (!response.ok) throw new Error(data.error || `GoTo.now returned HTTP ${response.status}.`);
+  return data;
+}
+
+function help() {
+  return `Link Shortener ${pkg.version}
+
+Usage:
+  goto login
+  goto logout
+  goto shorten <url> [--slug NAME] [--domain DOMAIN] [--reuse]
+  goto list [--limit 50] [--query TEXT] [--tag TAG]
+  goto get <short-code>
+  goto update <short-code> --url <destination>
+  goto analytics <short-code>
+  goto qr <short-code> [-o file.png] [--format png|svg|pdf]
+  goto suggest <url>
+  goto delete <short-code> --yes
+
+Options:
+  --json   Print JSON`;
+}
+
+function parse(argv) {
+  const args = [...argv];
+  const command = args.shift();
+  const flag = (name, fallback) => {
+    const index = args.indexOf(name);
+    if (index < 0) return fallback;
+    const value = args[index + 1];
+    if (!value || value.startsWith('--')) throw new Error(`${name} requires a value.`);
+    args.splice(index, 2); return value;
+  };
+  const boolean = (name) => { const found = args.includes(name); if (found) args.splice(args.indexOf(name), 1); return found; };
+  return {
+    command, json: boolean('--json'), yes: boolean('--yes'), reuse: boolean('--reuse'),
+    output: flag('-o', flag('--output')), slug: flag('--slug'), domain: flag('--domain'),
+    url: flag('--url'), limit: flag('--limit', '50'), query: flag('--query'), tag: flag('--tag'),
+    format: flag('--format', 'png'), args,
+  };
+}
+
+async function main() {
+  const argv = process.argv.slice(2);
+  if (!argv.length || argv.includes('--help') || argv.includes('-h')) return process.stdout.write(`${help()}\n`);
+  if (argv.includes('--version') || argv.includes('-v')) return process.stdout.write(`${pkg.version}\n`);
+  const options = parse(argv);
+  if (options.command === 'login') {
+    const key = await secret('GoTo.now API key: ');
+    if (!key.startsWith('gtn_')) throw new Error('That does not look like a GoTo.now API key.');
+    const stored = config(); stored.apiKey = key; save(stored);
+    process.stdout.write(`API key saved in ${configFile()}\n`); return;
+  }
+  if (options.command === 'logout') {
+    const stored = config(); delete stored.apiKey; save(stored); process.stdout.write('API key removed.\n'); return;
+  }
+  let data;
+  if (options.command === 'shorten') {
+    if (!options.args[0]) throw new Error('shorten requires a URL.');
+    data = await request('/api/v1/links', { method: 'POST', body: { url: options.args[0], ...(options.slug ? { slug: options.slug } : {}), ...(options.domain ? { domain: options.domain } : {}), findIfExists: options.reuse } });
+  } else if (options.command === 'list') {
+    const params = new URLSearchParams({ limit: options.limit });
+    if (options.query) params.set('q', options.query); if (options.tag) params.set('tag', options.tag);
+    data = await request(`/api/v1/links?${params}`);
+  } else if (['get', 'analytics'].includes(options.command)) {
+    if (!options.args[0]) throw new Error(`${options.command} requires a short code.`);
+    data = await request(`/api/v1/links/${encodeURIComponent(options.args[0])}${options.command === 'analytics' ? '/analytics' : ''}`);
+  } else if (options.command === 'update') {
+    if (!options.args[0] || !options.url) throw new Error('Usage: goto update <short-code> --url <destination>');
+    data = await request(`/api/v1/links/${encodeURIComponent(options.args[0])}`, { method: 'PATCH', body: { url: options.url } });
+  } else if (options.command === 'delete') {
+    if (!options.args[0] || !options.yes) throw new Error('Deletion is permanent. Repeat with `goto delete <short-code> --yes`.');
+    await request(`/api/v1/links/${encodeURIComponent(options.args[0])}`, { method: 'DELETE' });
+    process.stdout.write(`Deleted ${options.args[0]}.\n`); return;
+  } else if (options.command === 'suggest') {
+    if (!options.args[0]) throw new Error('suggest requires a URL.');
+    data = await request('/api/v1/slug-suggestions', { method: 'POST', body: { url: options.args[0] } });
+  } else if (options.command === 'qr') {
+    if (!options.args[0]) throw new Error('qr requires a short code.');
+    if (!['png', 'svg', 'pdf'].includes(options.format)) throw new Error('--format must be png, svg, or pdf.');
+    const bytes = await request(`/api/v1/links/${encodeURIComponent(options.args[0])}/qr?format=${options.format}`, { binary: true });
+    const output = path.resolve(options.output || `${options.args[0]}.${options.format}`);
+    if (fs.existsSync(output)) throw new Error(`Output already exists: ${output}`);
+    fs.writeFileSync(output, bytes, { mode: 0o600 }); process.stdout.write(`Saved ${output}\n`); return;
+  } else throw new Error(`Unknown command: ${options.command || ''}`);
+
+  if (options.json) process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+  else if (options.command === 'list') process.stdout.write(`${(data.data || []).map((item) => `${item.short_url}\t${item.original_url}`).join('\n')}\n`);
+  else if (options.command === 'shorten') process.stdout.write(`${data.shortUrl}\n`);
+  else if (options.command === 'suggest') process.stdout.write(`${(data.data || []).join('\n')}\n`);
+  else process.stdout.write(`${JSON.stringify(data, null, 2)}\n`);
+}
+
+if (require.main === module) main().catch((error) => { process.stderr.write(`goto: ${error.message}\n`); process.exitCode = 1; });
+
+module.exports = { parse };

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "goto-now",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Create, manage, inspect, and measure short links from your terminal.",
+  "bin": { "goto": "bin/goto.js" },
+  "files": ["bin", "README.md"],
+  "scripts": { "test": "node --check bin/goto.js && node bin/goto.js --version", "prepublishOnly": "npm test" },
+  "engines": { "node": ">=20" },
+  "keywords": ["url-shortener", "short-link", "link-management", "analytics", "qr-code", "cli"],
+  "homepage": "https://goto.now/developers",
+  "license": "UNLICENSED",
+  "author": "GoTo.now",
+  "publishConfig": { "access": "public" }
+}