tools.ts

// Single source of truth for the tool set. The home grid, per-tool metadata,
// JSON-LD, hero, FAQ, CTA, sitemap, web manifest, and command palette all derive
// from this array — adding a tool means adding one entry here (plus its route).

export interface ToolFaq {
  q: string;
  a: string;
}

export interface ToolCta {
  headline: string;
  sub: string;
  primaryLabel: string;
  primaryHref: string;
  secondaryLabel: string;
  secondaryHref: string;
}

export interface Tool {
  slug: string;
  path: string;
  // Home card
  title: string;
  tagline: string;
  cardDescription: string;
  features: string[];
  /** Theme-aware CSS variable name, e.g. "--sky" (accessible in both themes). */
  accentVar: string;
  /** Raw hex for the decorative hover glow only (cosmetic, low opacity). */
  accentHex: string;
  // Metadata
  metaTitle: string;
  metaDescription: string;
  ogTitle: string;
  ogDescription: string;
  // Hero
  heroBreadcrumb: string;
  heroHeading: string;
  /** Substring of heroHeading rendered in a dimmed span (e.g. "&"). */
  heroDim: string;
  heroDescription: string;
  // JSON-LD
  jsonLdName: string;
  jsonLdDescription: string;
  applicationCategory: "DeveloperApplication" | "BusinessApplication";
  // FAQ + CTA
  faqs: ToolFaq[];
  cta: ToolCta;
  sitemapPriority: number;
}

const CTA_PROJECTS = "https://www.codercops.com/projects";
const CTA_CONTACT = "https://www.codercops.com/contact";

export const TOOLS: Tool[] = [
  {
    slug: "json-formatter",
    path: "/json-formatter",
    title: "JSON Formatter & Validator",
    tagline: "Formatter",
    cardDescription:
      "Format, validate, minify. Syntax-highlighted output with collapsible tree view, plus JSON → CSV / TypeScript / YAML conversion.",
    features: ["Beautify", "Validate", "Tree view", "TypeScript", "CSV", "YAML"],
    accentVar: "--sky",
    accentHex: "#5AB5FF",
    metaTitle: "JSON Formatter & Validator - Free Online Tool",
    metaDescription:
      "Free online JSON formatter, validator, and beautifier. Format, minify, and validate JSON instantly with syntax highlighting and JSON-to-TypeScript. No signup.",
    ogTitle: "JSON Formatter & Validator - CODERCOPS Tools",
    ogDescription:
      "Format, validate, and minify JSON with syntax highlighting and JSON-to-TypeScript conversion. Runs entirely in your browser.",
    heroBreadcrumb: "100% client-side",
    heroHeading: "JSON Formatter & Validator",
    heroDim: "&",
    heroDescription:
      "Paste your JSON below to format, validate, and convert it — all in your browser, nothing is uploaded.",
    jsonLdName: "JSON Formatter & Validator",
    jsonLdDescription:
      "Free online JSON formatter, validator, and minifier with syntax highlighting and JSON-to-TypeScript/CSV/YAML conversion.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "Is my JSON uploaded anywhere?",
        a: "No. All formatting, validation, and conversion run locally in your browser. The JSON you paste never leaves your tab, is never sent to a server, and is never logged.",
      },
      {
        q: "Why does my JSON fail to validate?",
        a: "The usual causes are trailing commas, single quotes instead of double quotes, unquoted keys, and unbalanced brackets. The validator points to the line and character where parsing breaks so you can fix it quickly.",
      },
      {
        q: "Does it keep large numbers accurate?",
        a: "Yes. It parses with lossless-json, so very large integers and high-precision decimals keep every digit instead of being rounded by the browser's native JSON parser.",
      },
    ],
    cta: {
      headline: "Building an app that handles JSON APIs?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "jwt-decoder",
    path: "/jwt-decoder",
    title: "JWT Decoder & Inspector",
    tagline: "Auth",
    cardDescription:
      "Decode any JWT into header, payload, and signature. Human-readable claims, expiry status, and a built-in HS256 encoder.",
    features: ["Decode", "Encode", "Health panel", "HS256/384/512", "URL share"],
    accentVar: "--violet",
    accentHex: "#9E7BFF",
    metaTitle: "JWT Decoder & Verifier - Free Online Tool",
    metaDescription:
      "Free online JWT decoder and verifier. Decode any token to read its header, payload, claims, and expiry, and verify HS/RS/ES signatures in your browser. No login.",
    ogTitle: "JWT Decoder & Verifier - CODERCOPS Tools",
    ogDescription:
      "Decode JWT tokens in-browser. Humanized claims, expiry status, built-in HS256 encoder.",
    heroBreadcrumb: "Decoder · Inspector · Encoder",
    heroHeading: "JWT Decoder & Inspector",
    heroDim: "&",
    heroDescription:
      "Paste any JWT token to instantly decode its header, payload, and claims — everything runs in your browser.",
    jsonLdName: "JWT Decoder & Inspector",
    jsonLdDescription:
      "Decode and inspect JWT tokens, view humanized claims, check expiry, and generate signed HS256/384/512 tokens — all in your browser.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What is a JWT?",
        a: "A JSON Web Token is a compact, URL-safe format for asserting claims between parties. It has three parts — header, payload, signature — separated by dots and encoded with base64url.",
      },
      {
        q: "Is it safe to paste my JWT here?",
        a: "Yes — all decoding happens locally in your browser. Nothing is sent to our servers, logged, or stored. That said, avoid pasting production access tokens into any online tool if you can help it.",
      },
      {
        q: "Can this tool verify JWT signatures?",
        a: "Yes. The Verify tab checks HMAC (HS256/384/512) signatures with your secret, and RSA, ECDSA, or PSS signatures with a PEM or JWK public key, all in your browser via WebCrypto. It can also fetch a JWKS URL to pick the right key. Your production apps should still verify server-side.",
      },
      {
        q: "What is the difference between decoding and verifying a JWT?",
        a: "Decoding just base64url-decodes the header and payload so you can read the claims; it does not prove the token is authentic. Verifying checks the signature against a secret or public key to confirm the token was issued by who it claims and has not been tampered with. This tool does both.",
      },
    ],
    cta: {
      headline: "Building an app with JWT authentication?",
      sub: "CODERCOPS implements secure auth systems — OAuth2, JWT, SSO, and custom identity solutions — for startups and enterprise apps.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Let's build together",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "base64",
    path: "/base64",
    title: "Base64 Encoder & Decoder",
    tagline: "Encoding",
    cardDescription:
      "Text, images, files — encode to Base64 or decode back. URL-safe variant, data URIs, and magic-byte file detection.",
    features: ["Text", "Image → URI", "Files", "URL-safe", "Auto-detect"],
    accentVar: "--amber",
    accentHex: "#FFB547",
    metaTitle: "Base64 Encoder & Decoder - Free Online Tool",
    metaDescription:
      "Free online Base64 encoder and decoder for text, images, and files. URL-safe Base64, data URIs, and magic-byte detection. Runs in your browser, no upload.",
    ogTitle: "Base64 Encoder & Decoder - CODERCOPS Tools",
    ogDescription:
      "Encode and decode Base64 for text, images, and files — all in your browser.",
    heroBreadcrumb: "Text · Image · File · Decode",
    heroHeading: "Base64 Encoder & Decoder",
    heroDim: "&",
    heroDescription:
      "Encode text, images, and files to Base64 — or decode any Base64 string — all in your browser with zero uploads.",
    jsonLdName: "Base64 Encoder & Decoder",
    jsonLdDescription:
      "Free online Base64 encoder and decoder for text, images, and files, with URL-safe variant and magic-byte detection.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What is Base64 encoding?",
        a: "Base64 is a way of representing binary data as ASCII text using 64 printable characters. It's widely used to embed images in HTML/CSS, transmit binary data in JSON, and carry credentials in HTTP headers.",
      },
      {
        q: "What's the difference between Base64 and Base64URL?",
        a: "Standard Base64 uses + and / characters. Base64URL is a URL-safe variant that replaces + with - and / with _ (and often omits padding =), so the output is safe to put in URLs and JWTs.",
      },
      {
        q: "Does my data get uploaded anywhere?",
        a: "No. All encoding and decoding runs entirely in your browser. Text, images, and files you paste or drop here never leave your tab.",
      },
      {
        q: "Why is Base64 output larger than the input?",
        a: "Base64 represents every 3 input bytes as 4 output characters, so the output is roughly 4/3 of the input — about 33% larger. That overhead is the trade-off for ASCII-safe transport.",
      },
      {
        q: "Can I encode an image or PDF to Base64?",
        a: "Yes. Drop or select any file and it is encoded to a Base64 string or a ready-to-use data URI. It works for images, PDFs, and other binary files, and every byte is processed in your browser.",
      },
    ],
    cta: {
      headline: "Building an API or system that handles binary data?",
      sub: "CODERCOPS builds production APIs, file storage systems, and data pipelines for startups and enterprises.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "invoice-generator",
    path: "/invoice-generator",
    title: "Invoice Generator",
    tagline: "Billing",
    cardDescription:
      "Fill in your details, preview live, and download a crisp invoice PDF. Saves invoices in your browser — reusable sender profile, deductions, and auto-numbering.",
    features: ["Live preview", "PDF export", "Saved locally", "Deductions", "Auto-number"],
    accentVar: "--lime",
    accentHex: "#A6F36B",
    metaTitle: "Free Invoice Generator - Make & Download PDF",
    metaDescription:
      "Free invoice generator: create professional invoices and download a PDF. Live preview, reusable sender profile, and auto-numbering, saved in your browser.",
    ogTitle: "Invoice Generator - CODERCOPS Tools",
    ogDescription:
      "Build invoices in your browser and download a crisp PDF. Saved locally, no account, no data leaves your tab.",
    heroBreadcrumb: "Builder · Saved locally · PDF",
    heroHeading: "Invoice Generator",
    heroDim: "Generator",
    heroDescription:
      "Fill in your details, watch the live preview, and download a clean invoice PDF. Everything is saved in your browser — no account, no server, no data leaves your tab.",
    jsonLdName: "Invoice Generator",
    jsonLdDescription:
      "Create, save, and download professional invoices as PDF. Reusable sender profile, line items with deductions, tax, and auto-incrementing invoice numbers — all stored locally in your browser.",
    applicationCategory: "BusinessApplication",
    faqs: [
      {
        q: "Where are my invoices stored?",
        a: "In your browser's local storage on this device. There is no backend and no account. Clearing your browser data or using a different device or browser will not carry the invoices over.",
      },
      {
        q: "Is the PDF a real, printable invoice?",
        a: "Yes. The PDF is drawn as vector text and lines, so it stays sharp at any zoom and the text is selectable. It matches the live preview and downloads with your invoice number as the filename.",
      },
      {
        q: "Can I reuse my details and edit past invoices?",
        a: "Your sender details are saved as a reusable profile that pre-fills every new invoice. Saved invoices can be edited, duplicated, or deleted, and numbers auto-increment from the highest one.",
      },
      {
        q: "Can I add tax and discounts to an invoice?",
        a: "Yes. Each line item takes a rate and quantity, and you can apply a tax rate and per-item deductions. The subtotal, tax, and total are calculated and rounded to the cent as you type.",
      },
    ],
    cta: {
      headline: "Need billing baked into your product?",
      sub: "CODERCOPS builds invoicing, payments, and subscription systems — Stripe, tax handling, PDF generation, and dashboards — for startups and enterprises.",
      primaryLabel: "See our projects",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Let's build together",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "url-encoder",
    path: "/url-encoder",
    title: "URL Encoder & Decoder",
    tagline: "Encoding",
    cardDescription:
      "Percent-encode or decode a URL, a query value, or form data. See every query param broken out, with duplicates kept in order.",
    features: ["Encode", "Decode", "Component or full URL", "Query params", "Plus as space"],
    accentVar: "--cyan",
    accentHex: "#00E5C7",
    metaTitle: "URL Encoder & Decoder - Free Online Tool",
    metaDescription:
      "Free online URL encoder and decoder. Percent-encode query values, decode a messy redirect URL, and see every query param broken out. Runs in your browser.",
    ogTitle: "URL Encoder & Decoder - CODERCOPS Tools",
    ogDescription: "Encode and decode URLs and query values, with a full query param breakdown.",
    heroBreadcrumb: "Encode · Decode · Query params",
    heroHeading: "URL Encoder & Decoder",
    heroDim: "&",
    heroDescription:
      "Percent-encode a query value or decode a messy redirect URL, with a breakdown of every query param, all in your browser with zero uploads.",
    jsonLdName: "URL Encoder & Decoder",
    jsonLdDescription:
      "Free online URL encoder and decoder with component and full-URL modes, plus-as-space support, and a query param breakdown.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What's the difference between Component and Full URL encoding?",
        a: "Component mode (encodeURIComponent) escapes every reserved character, including /, ?, =, and &, so it's safe for a single value inside a query string. Full URL mode (encodeURI) leaves those structural characters alone, since it expects a complete URL, not just one piece of it.",
      },
      {
        q: "Why does decoding sometimes fail?",
        a: "A percent-encoded string can contain an incomplete or invalid sequence, like %E0 cut off before its second byte. Decoding reports this as an error instead of crashing, so you can see exactly what's wrong with the input.",
      },
      {
        q: "What does \"Treat + as space\" do?",
        a: "Form data encoded as application/x-www-form-urlencoded uses + for spaces instead of %20. Turn this on when decoding a query string or form submission, off when decoding a path that happens to contain a literal plus sign.",
      },
      {
        q: "Does my data get uploaded anywhere?",
        a: "No. All encoding, decoding, and URL parsing runs entirely in your browser. Nothing you paste here is sent anywhere.",
      },
    ],
    cta: {
      headline: "Building an app that juggles URLs and query params?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "timestamp-converter",
    path: "/timestamp-converter",
    title: "Unix Timestamp Converter",
    tagline: "Time",
    cardDescription:
      "Convert Unix timestamps and dates with automatic unit detection, UTC, local time, ISO 8601, and relative time.",
    features: ["Epoch to date", "Date to epoch", "Seconds or ms", "ISO 8601", "Relative time"],
    accentVar: "--green",
    accentHex: "#3FDD6B",
    metaTitle: "Unix Timestamp Converter - Free Online Tool",
    metaDescription:
      "Convert Unix timestamps to readable dates and dates to epoch time. Detect seconds or milliseconds, view UTC and local time, and copy ISO 8601 output.",
    ogTitle: "Unix Timestamp Converter - CODERCOPS Tools",
    ogDescription:
      "Convert Unix timestamps and dates. Detect seconds or milliseconds, inspect UTC and local time, and copy ISO 8601 output.",
    heroBreadcrumb: "Time",
    heroHeading: "Unix Timestamp Converter",
    heroDim: "",
    heroDescription:
      "Convert epoch timestamps to readable dates or dates to Unix time. All conversions run locally in your browser.",
    jsonLdName: "Unix Timestamp Converter",
    jsonLdDescription:
      "Free online Unix timestamp converter for epoch-to-date and date-to-epoch conversions, with automatic unit detection and ISO 8601 output.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "What is a Unix timestamp?",
        a: "A Unix timestamp measures elapsed time from 1970-01-01 00:00:00 UTC. It is commonly represented in seconds or milliseconds.",
      },
      {
        q: "How can I tell seconds from milliseconds?",
        a: "This tool estimates the unit from the number's magnitude. You can also select seconds, milliseconds, microseconds, or nanoseconds manually.",
      },
      {
        q: "Are my timestamps sent to a server?",
        a: "No. Conversion happens locally in your browser. The values you enter are not uploaded by this tool.",
      },
      {
        q: "Which date formats are supported?",
        a: "ISO 8601 timestamps and date strings understood by your browser are supported. For unambiguous results, include a timezone such as Z or an explicit UTC offset.",
      },
    ],
    cta: {
      headline: "Building tools that handle dates and APIs?",
      sub: "CODERCOPS builds production-grade backends, REST APIs, and full-stack applications for startups and businesses.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get a free quote",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
  {
    slug: "color-converter",
    path: "/color-converter",
    title: "Color Converter & Contrast Checker",
    tagline: "Design",
    cardDescription:
      "Convert between HEX, RGB, and HSL formats with alpha support, live swatch preview, and WCAG AA and AAA accessibility contrast checking.",
    features: ["HEX", "RGB", "HSL", "Alpha", "WCAG contrast"],
    accentVar: "--fuchsia",
    accentHex: "#F26DF0",
    metaTitle: "Color Converter & Contrast Checker - Free Tool",
    metaDescription:
      "Convert colors between HEX, RGB, and HSL formats with alpha support, live swatch preview, and WCAG AA/AAA contrast ratio checking. Fast, free, and private.",
    ogTitle: "Color Converter & Contrast Checker - CODERCOPS Tools",
    ogDescription:
      "Convert between HEX, RGB, and HSL with alpha channel support, live swatch, and WCAG contrast ratios.",
    heroBreadcrumb: "Convert · Preview · Contrast",
    heroHeading: "Color Converter & Contrast Checker",
    heroDim: "&",
    heroDescription:
      "Convert colors between HEX, RGB, and HSL formats and check WCAG accessibility contrast ratios in real time — 100% in your browser.",
    jsonLdName: "Color Converter & Contrast Checker",
    jsonLdDescription:
      "Free online color converter and contrast checker supporting HEX, RGB, HSL, alpha channel, and WCAG AA/AAA contrast ratios.",
    applicationCategory: "DeveloperApplication",
    faqs: [
      {
        q: "How does the color converter handle alpha transparency?",
        a: "Alpha transparency is supported in 8-digit HEX (#rrggbbaa), rgba(), and hsla() notations. Alpha is normalized between 0 and 1 and factored into contrast calculations when blended over backgrounds.",
      },
      {
        q: "What are WCAG AA and AAA contrast requirements?",
        a: "Under WCAG 2.1 guidelines, normal text requires a contrast ratio of at least 4.5:1 for level AA and 7:1 for level AAA. Large text (at least 18pt or 14pt bold) requires at least 3:1 for AA and 4.5:1 for AAA.",
      },
      {
        q: "Can I enter modern CSS space-separated color syntax?",
        a: "Yes. Both legacy comma-separated syntax like rgb(255, 0, 0) and modern CSS Color 4 space-separated syntax like rgb(255 0 0 / 0.5) and hsl(200 100% 50% / 0.8) are supported.",
      },
      {
        q: "Is any color data sent to a server?",
        a: "No. All conversions, swatch rendering, and contrast calculations run entirely in your browser using client-side JavaScript. No data ever leaves your device.",
      },
    ],
    cta: {
      headline: "Building accessible web apps and design systems?",
      sub: "CODERCOPS designs and builds accessible, high-performance web applications and UI component systems for startups and enterprises.",
      primaryLabel: "View our work",
      primaryHref: CTA_PROJECTS,
      secondaryLabel: "Get in touch",
      secondaryHref: CTA_CONTACT,
    },
    sitemapPriority: 0.9,
  },
];

export function getTool(slug: string): Tool | undefined {
  return TOOLS.find((t) => t.slug === slug);
}

// Sibling tools for a tool page: same application category first, then the
// rest of the registry in declaration order. Deterministic (no randomness),
// never includes the current tool, and never reorders the registry — the same
// slug always yields the same list. `tools` is injectable for tests.
export function getRelatedTools(
  currentSlug: string,
  limit = 3,
  tools: Tool[] = TOOLS
): Tool[] {
  const current = tools.find((t) => t.slug === currentSlug);
  if (!current) return [];

  const sameCategory: Tool[] = [];
  const others: Tool[] = [];
  for (const t of tools) {
    if (t.slug === currentSlug) continue;
    if (t.applicationCategory === current.applicationCategory) {
      sameCategory.push(t);
    } else {
      others.push(t);
    }
  }

  return [...sameCategory, ...others].slice(0, limit);
}

export const SITE_URL = "https://tools.codercops.com";

// The open-source repo. GITHUB_REPO is the "owner/name" slug used for the API.
export const GITHUB_REPO = "codercops/toolbelt";
export const GITHUB_REPO_URL = `https://github.com/${GITHUB_REPO}`;