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 | CODERCOPS Tools",
    metaDescription:
      "Format, beautify, validate, and minify JSON instantly. Free online JSON formatter with syntax highlighting, error detection, and JSON-to-TypeScript conversion. No signup required.",
    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: [],
    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 & Inspector — Free Online Tool | CODERCOPS Tools",
    metaDescription:
      "Decode and inspect any JWT token instantly. See header, payload, expiry status, and all claims in a human-readable format. Free, no login, runs in your browser.",
    ogTitle: "JWT Decoder & Inspector — 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.",
      },
    ],
    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 | CODERCOPS Tools",
    metaDescription:
      "Encode and decode Base64 instantly. Supports text, images, and files. URL-safe Base64, data URI generation, and file encoding. Free, 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.",
      },
    ],
    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: "Invoice Generator — Free Online Invoice Maker with PDF | CODERCOPS Tools",
    metaDescription:
      "Create professional invoices and download them as PDF, free. Fill in your details, save invoices in your browser, and export a clean PDF. No login, no backend, runs entirely 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.",
      },
    ],
    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,
  },
];

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

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}`;