@jjlmoya/utils-developer 1.2.0

package/src/tool/generadorSecurityTxt/component.astro

@@ -0,0 +1,473 @@
+---
+import { Icon } from 'astro-icon/components';
+import type { KnownLocale } from '../../types';
+import type { GeneradorSecurityTxtUI } from './ui';
+
+interface Props {
+  locale?: KnownLocale;
+  ui?: Record<string, unknown>;
+}
+
+const { ui } = Astro.props;
+const t = (ui ?? {}) as GeneradorSecurityTxtUI;
+---
+
+<div id="gst-root" data-i18n={JSON.stringify(t)} class="gst-root">
+  <div class="gst-container">
+    <div class="gst-sections">
+      <div class="gst-section-group gst-glass-card">
+        <div class="gst-group-title">
+          <Icon name="mdi:security" class="gst-icon" />
+          {t.titleBasicFields}
+        </div>
+
+        <div class="gst-input-field">
+          <label for="contact">
+            <Icon name="mdi:email-outline" class="gst-icon-small" />
+            {t.labelContact}
+          </label>
+          <input
+            type="text"
+            id="contact"
+            class="gst-premium-input"
+            placeholder={t.placeholderContact}
+          />
+          <div class="gst-field-tip">{t.contactTip}</div>
+        </div>
+
+        <div class="gst-input-field">
+          <label for="expires">
+            <Icon name="mdi:calendar-clock" class="gst-icon-small" />
+            {t.labelExpires}
+          </label>
+          <input type="date" id="expires" class="gst-premium-input" required />
+          <div class="gst-field-tip">{t.expiresTip}</div>
+        </div>
+      </div>
+
+      <div class="gst-section-group gst-glass-card">
+        <div class="gst-group-title">
+          <Icon name="mdi:plus-circle-outline" class="gst-icon" />
+          {t.titleOptionalFields}
+        </div>
+
+        <div class="gst-input-field">
+          <label for="encryption">
+            <Icon name="mdi:key-variant" class="gst-icon-small" />
+            {t.labelEncryption}
+          </label>
+          <input
+            type="text"
+            id="encryption"
+            class="gst-premium-input"
+            placeholder={t.placeholderEncryption}
+          />
+          <div class="gst-field-tip">{t.encryptionTip}</div>
+        </div>
+
+        <div class="gst-input-field">
+          <label for="policy">
+            <Icon name="mdi:file-document-outline" class="gst-icon-small" />
+            {t.labelPolicy}
+          </label>
+          <input
+            type="text"
+            id="policy"
+            class="gst-premium-input"
+            placeholder={t.placeholderPolicy}
+          />
+          <div class="gst-field-tip">{t.policyTip}</div>
+        </div>
+
+        <div class="gst-input-field">
+          <label for="acknowledgments">
+            <Icon name="mdi:trophy-outline" class="gst-icon-small" />
+            {t.labelAcknowledgments}
+          </label>
+          <input
+            type="text"
+            id="acknowledgments"
+            class="gst-premium-input"
+            placeholder={t.placeholderAcknowledgments}
+          />
+          <div class="gst-field-tip">{t.acknowledgmentsTip}</div>
+        </div>
+
+        <div class="gst-input-field">
+          <label for="hiring">
+            <Icon name="mdi:briefcase-outline" class="gst-icon-small" />
+            {t.labelHiring}
+          </label>
+          <input
+            type="text"
+            id="hiring"
+            class="gst-premium-input"
+            placeholder={t.placeholderHiring}
+          />
+          <div class="gst-field-tip">{t.hiringTip}</div>
+        </div>
+      </div>
+    </div>
+
+    <div class="gst-glass-card">
+      <div class="gst-result-header">
+        <div class="gst-result-title">{t.resultTitle}</div>
+        <div class="gst-actions">
+          <button id="btnCopy" class="gst-btn-secondary">
+            <Icon name="mdi:content-copy" class="gst-icon-small" />
+            {t.btnCopy}
+          </button>
+          <button id="btnDownload" class="gst-btn-primary">
+            <Icon name="mdi:download" class="gst-icon-small" />
+            {t.btnDownload}
+          </button>
+        </div>
+      </div>
+
+      <div class="gst-code-display" id="result-display">
+        <pre id="outputCode">{t.generatingMessage}</pre>
+      </div>
+    </div>
+  </div>
+</div>
+
+<script>
+  const contactInput = document.getElementById('contact') as HTMLInputElement;
+  const expiresInput = document.getElementById('expires') as HTMLInputElement;
+  const encryptionInput = document.getElementById('encryption') as HTMLInputElement;
+  const policyInput = document.getElementById('policy') as HTMLInputElement;
+  const acknowledgmentsInput = document.getElementById('acknowledgments') as HTMLInputElement;
+  const hiringInput = document.getElementById('hiring') as HTMLInputElement;
+  const outputCode = document.getElementById('outputCode') as HTMLPreElement;
+  const btnCopy = document.getElementById('btnCopy') as HTMLButtonElement;
+  const btnDownload = document.getElementById('btnDownload') as HTMLButtonElement;
+
+  function initDefaultExpiry(): void {
+    const today = new Date();
+    const sixMonthsLater = new Date(today.setMonth(today.getMonth() + 6));
+    expiresInput.value = sixMonthsLater.toISOString().split('T')[0];
+  }
+
+  function getUIData(): Record<string, string> {
+    return JSON.parse(document.getElementById('gst-root')?.dataset.i18n ?? '{}');
+  }
+
+  function formatExpiryDate(dateString: string): string {
+    if (!dateString) return '';
+    const expDate = new Date(dateString);
+    return expDate.toISOString();
+  }
+
+  function generateSecurityTxt(): string {
+    const lines: string[] = [];
+
+    if (contactInput.value) {
+      lines.push(`Contact: ${contactInput.value}`);
+    } else {
+      lines.push('# Contact: (Requerido)');
+    }
+
+    if (expiresInput.value) {
+      lines.push(`Expires: ${formatExpiryDate(expiresInput.value)}`);
+    }
+
+    if (encryptionInput.value) {
+      lines.push(`Encryption: ${encryptionInput.value}`);
+    }
+
+    if (policyInput.value) {
+      lines.push(`Policy: ${policyInput.value}`);
+    }
+
+    if (acknowledgmentsInput.value) {
+      lines.push(`Acknowledgments: ${acknowledgmentsInput.value}`);
+    }
+
+    if (hiringInput.value) {
+      lines.push(`Hiring: ${hiringInput.value}`);
+    }
+
+    const uiData = getUIData();
+    lines.push(`\n# ${uiData.comment || 'Generado'}`);
+
+    return lines.join('\n');
+  }
+
+  function updateOutput(): void {
+    outputCode.textContent = generateSecurityTxt();
+  }
+
+  function copyToClipboard(): void {
+    const text = outputCode.textContent || '';
+    navigator.clipboard.writeText(text).then(() => {
+      const originalHTML = btnCopy.innerHTML;
+      const uiData = getUIData();
+      btnCopy.innerHTML = '<svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" stroke-width="2"><polyline points="20 6 9 17 4 12"></polyline></svg> ' + (uiData.copiedMessage || 'Copied');
+      setTimeout(() => {
+        btnCopy.innerHTML = originalHTML;
+      }, 2000);
+    });
+  }
+
+  function downloadFile(): void {
+    const text = outputCode.textContent || '';
+    const blob = new Blob([text], { type: 'text/plain' });
+    const url = window.URL.createObjectURL(blob);
+    const a = document.createElement('a');
+    a.href = url;
+    a.download = 'security.txt';
+    a.click();
+    window.URL.revokeObjectURL(url);
+  }
+
+  initDefaultExpiry();
+  updateOutput();
+
+  const inputs = [
+    contactInput,
+    expiresInput,
+    encryptionInput,
+    policyInput,
+    acknowledgmentsInput,
+    hiringInput,
+  ];
+
+  inputs.forEach((input) => {
+    input.addEventListener('input', updateOutput);
+  });
+
+  btnCopy.addEventListener('click', copyToClipboard);
+  btnDownload.addEventListener('click', downloadFile);
+</script>
+
+<style>
+  .gst-root {
+    width: 100%;
+  }
+
+  .gst-container {
+    max-width: 900px;
+    margin: 0 auto;
+    display: flex;
+    flex-direction: column;
+    gap: 1.5rem;
+    padding-bottom: 2rem;
+  }
+
+  .gst-glass-card {
+    background: rgba(255, 255, 255, 0.7);
+    backdrop-filter: blur(12px);
+    border: 1px solid rgba(255, 255, 255, 0.3);
+    border-radius: 1.5rem;
+    padding: 1.5rem;
+    box-shadow: 0 8px 32px rgba(31, 38, 135, 0.07);
+  }
+
+  :global(.theme-dark) .gst-glass-card {
+    background: rgba(20, 20, 25, 0.7);
+    border: 1px solid rgba(255, 255, 255, 0.05);
+  }
+
+  .gst-sections {
+    display: grid;
+    grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
+    gap: 1.5rem;
+  }
+
+  .gst-section-group {
+    display: flex;
+    flex-direction: column;
+    gap: 1.25rem;
+  }
+
+  .gst-group-title {
+    font-size: 0.875rem;
+    font-weight: 700;
+    color: rgb(100, 116, 139);
+    text-transform: uppercase;
+    letter-spacing: 0.05em;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    margin-bottom: 0.5rem;
+  }
+
+  :global(.theme-dark) .gst-group-title {
+    color: rgb(148, 163, 184);
+  }
+
+  .gst-icon {
+    width: 1rem;
+    height: 1rem;
+    color: var(--gst-theme-color, #4f46e5);
+  }
+
+  .gst-input-field {
+    display: flex;
+    flex-direction: column;
+    gap: 0.5rem;
+  }
+
+  .gst-input-field label {
+    font-size: 0.875rem;
+    font-weight: 600;
+    color: rgb(51, 65, 85);
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+  }
+
+  :global(.theme-dark) .gst-input-field label {
+    color: rgb(203, 213, 225);
+  }
+
+  .gst-icon-small {
+    width: 0.875rem;
+    height: 0.875rem;
+  }
+
+  .gst-premium-input {
+    background: white;
+    border: 1px solid rgb(226, 232, 240);
+    border-radius: 0.75rem;
+    padding: 0.75rem 1rem;
+    font-size: 1rem;
+    outline: none;
+    transition: all 0.2s ease;
+    width: 100%;
+    box-sizing: border-box;
+  }
+
+  :global(.theme-dark) .gst-premium-input {
+    background: rgb(15, 23, 42);
+    border-color: rgb(51, 65, 85);
+    color: white;
+  }
+
+  .gst-premium-input:focus {
+    border-color: var(--gst-theme-color, #4f46e5);
+    box-shadow: 0 0 0 3px rgba(79, 70, 229, 0.1);
+  }
+
+  .gst-field-tip {
+    font-size: 0.75rem;
+    color: rgb(100, 116, 139);
+  }
+
+  :global(.theme-dark) .gst-field-tip {
+    color: rgb(148, 163, 184);
+  }
+
+  .gst-result-header {
+    display: flex;
+    justify-content: space-between;
+    align-items: center;
+    margin-bottom: 1rem;
+    flex-wrap: wrap;
+    gap: 1rem;
+  }
+
+  .gst-result-title {
+    font-size: 1.125rem;
+    font-weight: 700;
+    color: rgb(30, 41, 59);
+  }
+
+  :global(.theme-dark) .gst-result-title {
+    color: white;
+  }
+
+  .gst-code-display {
+    background: rgba(0, 0, 0, 0.03);
+    padding: 1.25rem;
+    border-radius: 1rem;
+    font-size: 0.9rem;
+    line-height: 1.5;
+    color: rgb(51, 65, 85);
+    min-height: 200px;
+    max-height: 400px;
+    overflow-y: auto;
+    border: 1px solid rgba(0, 0, 0, 0.05);
+  }
+
+  :global(.theme-dark) .gst-code-display {
+    background: rgba(255, 255, 255, 0.03);
+    color: rgb(203, 213, 225);
+    border-color: rgba(255, 255, 255, 0.05);
+  }
+
+  .gst-code-display pre {
+    margin: 0;
+    white-space: pre-wrap;
+    word-break: break-all;
+  }
+
+  .gst-actions {
+    display: flex;
+    gap: 0.75rem;
+  }
+
+  .gst-btn-primary {
+    background: var(--gst-theme-color, #4f46e5);
+    color: white;
+    border: none;
+    border-radius: 0.75rem;
+    padding: 0.6rem 1.25rem;
+    font-weight: 600;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    transition: all 0.2s ease;
+  }
+
+  .gst-btn-primary:hover {
+    opacity: 0.9;
+    transform: translateY(-1px);
+  }
+
+  .gst-btn-secondary {
+    background: white;
+    color: rgb(30, 41, 59);
+    border: 1px solid rgb(226, 232, 240);
+    border-radius: 0.75rem;
+    padding: 0.6rem 1.25rem;
+    font-weight: 600;
+    cursor: pointer;
+    display: flex;
+    align-items: center;
+    gap: 0.5rem;
+    transition: all 0.2s ease;
+  }
+
+  :global(.theme-dark) .gst-btn-secondary {
+    background: rgb(30, 41, 59);
+    color: white;
+    border-color: rgb(51, 65, 85);
+  }
+
+  .gst-btn-secondary:hover {
+    background: rgb(248, 250, 252);
+  }
+
+  :global(.theme-dark) .gst-btn-secondary:hover {
+    background: rgb(51, 65, 85);
+  }
+
+  @media (max-width: 640px) {
+    .gst-result-header {
+      flex-direction: column;
+      align-items: stretch;
+    }
+
+    .gst-actions {
+      flex-direction: column;
+      width: 100%;
+    }
+
+    .gst-actions button {
+      width: 100%;
+      justify-content: center;
+    }
+  }
+</style>

package/src/tool/generadorSecurityTxt/i18n/en.ts

@@ -0,0 +1,173 @@
+import type { WithContext, FAQPage, HowToThing, SoftwareApplication } from 'schema-dts';
+import type { ToolLocaleContent } from '../../../types';
+import type { GeneradorSecurityTxtUI } from '../ui';
+
+const slug = 'security-txt-generator-rfc-9116';
+const title = 'Security.txt Generator RFC 9116';
+const description = 'Create your professional security.txt file to facilitate vulnerability reporting and comply with international web security standards.';
+
+const faqData = [
+  {
+    question: 'What is the security.txt file?',
+    answer: 'It is a standard (RFC 9116) that allows websites to define how security researchers should contact them to responsibly report vulnerabilities.',
+  },
+  {
+    question: 'Where should the security.txt file be placed?',
+    answer: 'The recommended standard location is in the /.well-known/ folder of your domain, resulting in the URL https://example.com/.well-known/security.txt.',
+  },
+  {
+    question: 'Why is the expiration date mandatory?',
+    answer: 'To ensure that contact information does not become outdated. If the file does not have a valid expiration date, researchers may not trust that communication channels remain active.',
+  },
+  {
+    question: 'What fields are required in a security.txt?',
+    answer: 'According to RFC 9116, the required fields are "Contact" (with an email address or URL) and "Expires" (with a future date in ISO 8601 format).',
+  },
+];
+
+const howToData = [
+  { name: 'Fill in the fields', text: 'Complete your email address or contact URL and select an expiration date.' },
+  { name: 'Add optional fields', text: 'Include additional information such as your PGP key, security policy or job board.' },
+  { name: 'Download or copy the file', text: 'Click on "Download .txt" or copy the content and save it as security.txt.' },
+  { name: 'Upload to server', text: 'Place the file in the /.well-known/ folder of your domain.' },
+];
+
+const faqSchema: WithContext<FAQPage> = {
+  '@context': 'https://schema.org',
+  '@type': 'FAQPage',
+  mainEntity: faqData.map((item) => ({
+    '@type': 'Question',
+    name: item.question,
+    acceptedAnswer: { '@type': 'Answer', text: item.answer },
+  })),
+};
+
+const howToSchema: WithContext<HowToThing> = {
+  '@context': 'https://schema.org',
+  '@type': 'HowTo',
+  name: title,
+  description,
+  step: howToData.map((s, i) => ({ '@type': 'HowToStep', position: i + 1, name: s.name, text: s.text })),
+};
+
+const appSchema: WithContext<SoftwareApplication> = {
+  '@context': 'https://schema.org',
+  '@type': 'SoftwareApplication',
+  name: title,
+  description,
+  applicationCategory: 'UtilityApplication',
+  operatingSystem: 'All',
+  offers: { '@type': 'Offer', price: '0', priceCurrency: 'EUR' },
+  inLanguage: 'en',
+};
+
+const ui: GeneradorSecurityTxtUI = {
+  titleBasicFields: 'Required Fields',
+  labelContact: 'Contact (Email or URL)',
+  placeholderContact: 'mailto:security@example.com or https://example.com/contact',
+  contactTip: 'Address where vulnerability reports should be sent.',
+  labelExpires: 'Expiration Date',
+  expiresTip: 'Should not exceed one year in the future.',
+  titleOptionalFields: 'Optional Fields',
+  labelEncryption: 'Public Key',
+  placeholderEncryption: 'https://example.com/pgp-key.txt',
+  encryptionTip: 'Link to your PGP key for encrypted reports.',
+  labelPolicy: 'Security Policy',
+  placeholderPolicy: 'https://example.com/security/policy/',
+  policyTip: 'Page detailing how to handle vulnerabilities.',
+  labelAcknowledgments: 'Acknowledgments',
+  placeholderAcknowledgments: 'https://example.com/security/hall-of-fame/',
+  acknowledgmentsTip: 'Page thanking security researchers.',
+  labelHiring: 'Job Board',
+  placeholderHiring: 'https://example.com/jobs',
+  hiringTip: 'Link to security job openings.',
+  resultTitle: 'Preview (security.txt)',
+  btnCopy: 'Copy Code',
+  btnDownload: 'Download .txt',
+  copiedMessage: 'Copied',
+  generatingMessage: 'Generating security.txt file...',
+  comment: 'Generated',
+};
+
+export const content: ToolLocaleContent<GeneradorSecurityTxtUI> = {
+  slug,
+  title,
+  description,
+  ui,
+  faqTitle: 'Frequently Asked Questions',
+  faq: faqData,
+  bibliographyTitle: 'Technical Resources on Security.txt',
+  bibliography: [
+    { name: 'RFC 9116: A File Format to Aid in Security Vulnerability Disclosure', url: 'https://datatracker.ietf.org/doc/html/rfc9116' },
+    { name: 'Security.txt Official Website', url: 'https://securitytxt.org/' },
+    { name: 'OWASP: Vulnerability Disclosure Cheat Sheet', url: 'https://cheatsheetseries.owasp.org/cheatsheets/Vulnerability_Disclosure_Cheat_Sheet.html' },
+  ],
+  howTo: howToData,
+  schemas: [faqSchema, howToSchema, appSchema],
+  seo: [
+    { type: 'title', text: 'What is a Security.txt file and why do you need to generate one?', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'In today\'s cybersecurity landscape, transparency and communication are essential. If you\'re a system administrator, web developer, or digital business owner, you\'re probably already familiar with text files that help machines understand your website, like <code>robots.txt</code> or <code>ads.txt</code>. However, there is a lesser-known but vital standard for your platform\'s integrity: <strong>Security.txt</strong>, defined by <strong>RFC 9116</strong>.',
+    },
+    {
+      type: 'paragraph',
+      html: 'The purpose of <strong>generating a security.txt file</strong> is to provide security researchers with a standardized way to contact your website\'s administrators when they discover a vulnerability. Without this file, an ethical hacker who finds a flaw in your system might not know who to report it to, which often results in the information being lost, published without notice, or exploited by malicious actors.',
+    },
+    { type: 'title', text: 'How to create and install the Security.txt file following RFC 9116', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'The <strong>security researcher contact standard</strong> dictates that this file must reside in a specific location on your server: the <code>/.well-known/</code> folder. Therefore, the final path is usually <code>https://yourdomain.com/.well-known/security.txt</code>. Although it is also allowed to place it in the root (<code>/security.txt</code>), the first option is preferred by automatic scanning tools.',
+    },
+    { type: 'title', text: 'Required fields you cannot miss', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'When <strong>obtaining your security.txt code</strong>, you must ensure it includes at least two critical elements:',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Contact:</strong> The email address or URL of a form where reports should be sent. Must start with <code>mailto:</code> or <code>https://</code>.',
+        '<strong>Expires:</strong> A date in ISO 8601 format that indicates when the file\'s information is no longer valid. It is recommended not to set a date more than one year away.',
+      ],
+    },
+    { type: 'code', text: 'Contact: mailto:security@yourcompany.com\nExpires: 2025-12-31T23:59:59.000Z' },
+    { type: 'title', text: 'Optional fields for advanced security', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'For sites seeking more robust <strong>website protection</strong>, the standard offers additional fields:',
+    },
+    {
+      type: 'list',
+      items: [
+        '<strong>Encryption:</strong> A link to your PGP public key so researchers can send you encrypted and secure information.',
+        '<strong>Policy:</strong> A link to your security policy page where you explain the responsible disclosure process.',
+        '<strong>Acknowledgments:</strong> A link to your "Hall of Fame" or appreciation wall for researchers.',
+        '<strong>Hiring:</strong> A link to your cybersecurity job openings.',
+      ],
+    },
+    { type: 'title', text: 'Benefits of using our free Security.txt generator', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'Many people wonder <strong>how to get a website\'s security contact</strong> quickly. By using our tool, you ensure strict compliance with RFC 9116 format without having to read complex technical documents.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Using a generator saves you common syntax errors. For example, forgetting the <code>mailto:</code> prefix or incorrectly formatting the timezone in the expiration date can cause researchers\' automated tools to ignore your file.',
+    },
+    { type: 'title', text: 'Impact on SEO and web reputation', level: 3 },
+    {
+      type: 'paragraph',
+      html: 'Although the <code>security.txt</code> file is not a direct ranking factor in Google like page speed or HTTPS, it does have an indirect impact. A website that manages vulnerabilities well avoids noisy hacks (defacement, spam injections) that ruin SEO in hours. Additionally, many corporate security rating platforms (such as SecurityScorecard or BitSight) award extra points to domains that implement this standard.',
+    },
+    { type: 'title', text: 'Conclusion: A simple step for a more secure web', level: 2 },
+    {
+      type: 'paragraph',
+      html: 'In summary, <strong>downloading security.txt</strong> and uploading it to your server is one of the fastest and most effective security maintenance tasks you can perform today. You make it easy for the "good guys", discourage the curious, and show the world that you take user privacy and data seriously.',
+    },
+    {
+      type: 'paragraph',
+      html: 'Don\'t wait for a security breach to regret not providing a communication channel. Use our <strong>online security.txt generator</strong> now and keep your digital ecosystem under control.',
+    },
+  ],
+};