@fd-fastest/plugin-psi

PageSpeed Insights integration for the FD-Fastest toolkit.

Installation

pnpm add @fd-fastest/plugin-psi

Setup

Create an API key for the PageSpeed Insights API via the Google Cloud Console and enable the Pagespeed API for your project.

Usage

import { fetchPSI } from '@fd-fastest/plugin-psi';
import { createLogger } from '@fd-fastest/logger';

const logger = createLogger({ name: 'psi-example' });

const result = await fetchPSI({
  url: 'https://example.com',
  strategy: 'mobile',
  apiKey: 'YOUR_API_KEY',
  categories: ['performance', 'accessibility'],
});

logger.info('Performance Score', {
  score: result?.lighthouse?.performance,
});
logger.info('CrUX Metrics', {
  metrics: result?.crux?.loadingExperience.metrics,
});

Batch Fetching

import { fetchPSIBatch } from '@fd-fastest/plugin-psi';

const results = await fetchPSIBatch(
  ['https://example.com/', 'https://example.com/about'],
  {
    strategy: 'mobile',
    apiKey: 'YOUR_API_KEY',
  }
);

Features

• ✅ Lighthouse scores (Performance, Accessibility, Best Practices, SEO)
• ✅ CrUX field data (real-user metrics)
• ✅ Batch fetching with rate limiting
• ✅ Error handling
• ✅ TypeScript support

License

MIT