@astroscope/excludes

Note: This package is in active development. APIs may change between versions.

Shared exclude patterns for Astro middleware packages.

Installation

npm install @astroscope/excludes

Usage

import {
  RECOMMENDED_EXCLUDES,
  DEV_EXCLUDES,
  ASTRO_STATIC_EXCLUDES,
  STATIC_EXCLUDES,
  shouldExclude,
} from '@astroscope/excludes';

if (shouldExclude(ctx, RECOMMENDED_EXCLUDES)) {
  return next();
}

const excludes = [
  ...RECOMMENDED_EXCLUDES,
  { exact: '/health' },
  { prefix: '/api/internal/' },
  { pattern: /\.map$/ },
];

if (shouldExclude(ctx, (ctx) => ctx.url.pathname.startsWith('/admin'))) {
  return next();
}

Exclude Pattern Sets

RECOMMENDED_EXCLUDES

Combines DEV_EXCLUDES and ASTRO_STATIC_EXCLUDES. Use this as a starting point.

Note: STATIC_EXCLUDES is not included by default, as these paths (like /robots.txt or /sitemap.xml) may be served dynamically. Use it on your own risk.

DEV_EXCLUDES

Vite/Astro dev server paths (only relevant in development):

• /@id/*
• /@fs/*
• /@vite/*
• /src/*
• /node_modules/*

ASTRO_STATIC_EXCLUDES

Astro internal paths:

• /_astro/* - bundled assets
• /_image* - image optimization

STATIC_EXCLUDES

Common static files:

• /favicon.ico
• /robots.txt
• /sitemap.xml
• /browserconfig.xml
• /manifest.json
• /manifest.webmanifest

Pattern Types

type ExcludePattern =
  | { exact: string }   // Exact match
  | { prefix: string }  // Starts with
  | { pattern: RegExp } // Regex match

License

MIT