is-it-down-now 0.0.0-stage → 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 IsItDown.now
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,15 @@
-# Temporary Holding Version
+# Is It Down
 
-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.
+Check whether a website or popular service is down from your terminal.
+
+```sh
+npm install --global is-it-down-now
+isitdown github.com
+isitdown down
+isitdown outages youtube.com --days 30
+isitdown search cloud
+```
+
+Add `--json` for machine-readable output. Set `ISITDOWN_API_KEY` when an API key is needed for additional live checks.
+
+Documentation: <https://isitdown.now/cli>

package/bin/isitdown.js

@@ -0,0 +1,112 @@
+#!/usr/bin/env node
+'use strict';
+
+const pkg = require('../package.json');
+const endpoint = (process.env.ISITDOWN_MCP_URL || 'https://mcp.isitdown.now').replace(/\/$/, '');
+
+function help() {
+  return `Is It Down ${pkg.version}
+
+Usage:
+  isitdown <service-or-domain>
+  isitdown status <service>
+  isitdown check <domain>
+  isitdown down
+  isitdown outages [service] [--days 7]
+  isitdown search <words>
+
+Options:
+  --json       Print JSON
+  --days N     Outage-history window, 1–90 days
+  --help       Show help
+  --version    Show version
+
+Environment:
+  ISITDOWN_API_KEY   Optional API key for additional live checks`;
+}
+
+function parse(argv) {
+  const args = [...argv];
+  if (!args.length || args.includes('--help') || args.includes('-h')) return { help: true };
+  if (args.includes('--version') || args.includes('-v')) return { version: true };
+  const json = args.includes('--json');
+  if (json) args.splice(args.indexOf('--json'), 1);
+  let days = 7;
+  const daysIndex = args.indexOf('--days');
+  if (daysIndex >= 0) {
+    days = Number(args[daysIndex + 1]);
+    args.splice(daysIndex, 2);
+  }
+  if (!Number.isInteger(days) || days < 1 || days > 90) throw new Error('--days must be an integer from 1 to 90.');
+  const commands = new Set(['status', 'check', 'down', 'outages', 'search']);
+  const command = commands.has(args[0]) ? args.shift() : 'auto';
+  return { command, target: args.join(' ').trim(), days, json };
+}
+
+async function call(name, args) {
+  const response = await fetch(endpoint, {
+    method: 'POST',
+    headers: {
+      Accept: 'application/json, text/event-stream',
+      'Content-Type': 'application/json',
+      'User-Agent': `is-it-down/${pkg.version}`,
+      ...(process.env.ISITDOWN_API_KEY ? { Authorization: `Bearer ${process.env.ISITDOWN_API_KEY}` } : {}),
+    },
+    body: JSON.stringify({ jsonrpc: '2.0', id: 1, method: 'tools/call', params: { name, arguments: args } }),
+    signal: AbortSignal.timeout(20_000),
+  });
+  const body = await response.json().catch(() => ({}));
+  if (!response.ok || body.error) throw new Error(body.error?.message || `IsItDown.now returned HTTP ${response.status}.`);
+  if (body.result?.isError) throw new Error(body.result.content?.[0]?.text || 'The status check failed.');
+  return body.result?.structuredContent || {};
+}
+
+function format(data) {
+  if (Array.isArray(data.services)) {
+    if (!data.services.length) return 'No monitored services have a confirmed outage right now.';
+    return data.services.map((item) => `${item.service || item.name} (${item.domain}) — ${item.state || 'down'}`).join('\n');
+  }
+  if (Array.isArray(data.outages)) {
+    if (!data.outages.length) return 'No confirmed outages found.';
+    return data.outages.map((item) => `${item.service}: ${item.started_at} to ${item.ongoing ? 'ongoing' : item.ended_at}`).join('\n');
+  }
+  return [
+    `${data.service || data.host || data.domain}: ${data.summary || data.state || 'unknown'}`,
+    data.http_status != null ? `HTTP: ${data.http_status}` : null,
+    data.response_ms != null ? `Response: ${data.response_ms} ms` : null,
+    data.status_page ? `Details: ${data.status_page}` : null,
+  ].filter(Boolean).join('\n');
+}
+
+async function main() {
+  const options = parse(process.argv.slice(2));
+  if (options.help) return process.stdout.write(`${help()}\n`);
+  if (options.version) return process.stdout.write(`${pkg.version}\n`);
+  const target = options.target;
+  let data;
+  if (options.command === 'down') data = await call('list_down_services', {});
+  else if (options.command === 'outages') data = await call('recent_outages', { days: options.days, ...(target ? { service: target } : {}) });
+  else if (options.command === 'search') {
+    if (!target) throw new Error('search needs a service name.');
+    data = await call('search_services', { query: target });
+  } else if (options.command === 'check') {
+    if (!target) throw new Error('check needs a domain.');
+    data = await call('check_website', { url: target });
+  } else {
+    if (!target) throw new Error('Add a service name or domain.');
+    try { data = await call('get_service_status', { service: target }); }
+    catch (error) {
+      if (options.command === 'status') throw error;
+      data = await call('check_website', { url: target });
+    }
+  }
+  process.stdout.write(options.json ? `${JSON.stringify(data, null, 2)}\n` : `${format(data)}\n`);
+  if (data.state === 'down') process.exitCode = 1;
+}
+
+if (require.main === module) main().catch((error) => {
+  process.stderr.write(`isitdown: ${error.name === 'TimeoutError' ? 'The request timed out.' : error.message}\n`);
+  process.exitCode = 2;
+});
+
+module.exports = { parse };

package/package.json

@@ -1,6 +1,14 @@
 {
   "name": "is-it-down-now",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.0",
+  "description": "Check website and service status, current outages, and outage history from your terminal.",
+  "bin": { "isitdown": "bin/isitdown.js" },
+  "files": ["bin", "README.md", "LICENSE"],
+  "scripts": { "test": "node --check bin/isitdown.js && node bin/isitdown.js --version", "prepublishOnly": "npm test" },
+  "engines": { "node": ">=20" },
+  "keywords": ["uptime", "outage", "status", "website-monitoring", "cli", "is-it-down"],
+  "homepage": "https://isitdown.now/cli",
+  "license": "MIT",
+  "author": "IsItDown.now",
+  "publishConfig": { "access": "public" }
+}