@casoon/astro-post-audit 0.1.3

package/bin/install.cjs

@@ -0,0 +1,138 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script: downloads the prebuilt astro-post-audit binary
+ * for the current platform from GitHub Releases.
+ */
+
+const { execSync } = require("child_process");
+const fs = require("fs");
+const path = require("path");
+const https = require("https");
+
+const PACKAGE = "astro-post-audit";
+const VERSION = require("../package.json").version;
+const REPO = "casoon/astro-post-audit";
+
+function getPlatformTarget() {
+  const platform = process.platform;
+  const arch = process.arch;
+
+  const targets = {
+    "darwin-x64": "x86_64-apple-darwin",
+    "darwin-arm64": "aarch64-apple-darwin",
+    "linux-x64": "x86_64-unknown-linux-gnu",
+    "linux-arm64": "aarch64-unknown-linux-gnu",
+    "win32-x64": "x86_64-pc-windows-msvc",
+    "win32-arm64": "aarch64-pc-windows-msvc",
+  };
+
+  const key = `${platform}-${arch}`;
+  const target = targets[key];
+
+  if (!target) {
+    console.error(`Unsupported platform: ${key}`);
+    console.error(`Supported platforms: ${Object.keys(targets).join(", ")}`);
+    process.exit(1);
+  }
+
+  return target;
+}
+
+function getBinaryName() {
+  return process.platform === "win32"
+    ? `${PACKAGE}.exe`
+    : PACKAGE;
+}
+
+function getDownloadUrl(target) {
+  const ext = process.platform === "win32" ? ".zip" : ".tar.gz";
+  return `https://github.com/${REPO}/releases/download/v${VERSION}/${PACKAGE}-v${VERSION}-${target}${ext}`;
+}
+
+async function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const follow = (url, redirects = 0) => {
+      if (redirects > 5) {
+        reject(new Error("Too many redirects"));
+        return;
+      }
+
+      https.get(url, (res) => {
+        if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+          follow(res.headers.location, redirects + 1);
+          return;
+        }
+
+        if (res.statusCode !== 200) {
+          reject(new Error(`Download failed: HTTP ${res.statusCode} from ${url}`));
+          return;
+        }
+
+        const file = fs.createWriteStream(dest);
+        res.pipe(file);
+        file.on("finish", () => {
+          file.close(resolve);
+        });
+      }).on("error", reject);
+    };
+
+    follow(url);
+  });
+}
+
+async function main() {
+  const target = getPlatformTarget();
+  const binaryName = getBinaryName();
+  const binDir = path.join(__dirname);
+  const binaryPath = path.join(binDir, binaryName);
+
+  // Skip if binary already exists (e.g., local dev)
+  if (fs.existsSync(binaryPath)) {
+    console.log(`${PACKAGE} binary already exists, skipping download.`);
+    return;
+  }
+
+  const url = getDownloadUrl(target);
+  const archiveExt = process.platform === "win32" ? ".zip" : ".tar.gz";
+  const archivePath = path.join(binDir, `download${archiveExt}`);
+
+  console.log(`Downloading ${PACKAGE} v${VERSION} for ${target}...`);
+  console.log(`  URL: ${url}`);
+
+  try {
+    await download(url, archivePath);
+
+    // Extract
+    if (process.platform === "win32") {
+      // Use PowerShell to extract zip on Windows
+      execSync(
+        `powershell -Command "Expand-Archive -Path '${archivePath}' -DestinationPath '${binDir}' -Force"`,
+        { stdio: "inherit" }
+      );
+    } else {
+      execSync(`tar -xzf "${archivePath}" -C "${binDir}"`, {
+        stdio: "inherit",
+      });
+    }
+
+    // Ensure binary is executable
+    if (process.platform !== "win32") {
+      fs.chmodSync(binaryPath, 0o755);
+    }
+
+    // Cleanup archive
+    fs.unlinkSync(archivePath);
+
+    console.log(`${PACKAGE} v${VERSION} installed successfully.`);
+  } catch (err) {
+    console.warn(`Failed to download ${PACKAGE}: ${err.message}`);
+    console.warn(
+      "You can install it manually from: " +
+        `https://github.com/${REPO}/releases`
+    );
+    // Don't fail the install — the integration will warn if the binary is missing
+  }
+}
+
+main();

package/bin/run.cjs

@@ -0,0 +1,30 @@
+#!/usr/bin/env node
+
+/**
+ * Thin wrapper that executes the platform-specific astro-post-audit binary.
+ */
+
+const { execFileSync } = require("child_process");
+const path = require("path");
+const fs = require("fs");
+
+const binaryName =
+  process.platform === "win32" ? "astro-post-audit.exe" : "astro-post-audit";
+const binaryPath = path.join(__dirname, binaryName);
+
+if (!fs.existsSync(binaryPath)) {
+  console.error(
+    `Error: ${binaryName} not found at ${binaryPath}\n` +
+      "Run 'npm rebuild astro-post-audit' or reinstall the package."
+  );
+  process.exit(2);
+}
+
+try {
+  execFileSync(binaryPath, process.argv.slice(2), {
+    stdio: "inherit",
+  });
+} catch (err) {
+  // execFileSync throws on non-zero exit code, forward it
+  process.exit(err.status ?? 2);
+}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { default } from './integration.js';
+export type { PostAuditOptions } from './integration.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC3C,YAAY,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/index.js

@@ -0,0 +1 @@
+export { default } from './integration.js';

package/dist/integration.d.ts

@@ -0,0 +1,27 @@
+import type { AstroIntegration } from 'astro';
+export interface PostAuditOptions {
+    /** Path to rules.toml config file */
+    config?: string;
+    /** Base URL (auto-detected from Astro site config if not set) */
+    site?: string;
+    /** Treat warnings as errors */
+    strict?: boolean;
+    /** Output format: 'text' or 'json' */
+    format?: 'text' | 'json';
+    /** Glob patterns to exclude */
+    exclude?: string[];
+    /** Skip sitemap checks */
+    noSitemapCheck?: boolean;
+    /** Enable asset reference checking */
+    checkAssets?: boolean;
+    /** Enable structured data validation */
+    checkStructuredData?: boolean;
+    /** Enable security heuristic checks */
+    checkSecurity?: boolean;
+    /** Enable duplicate content detection */
+    checkDuplicates?: boolean;
+    /** Disable the integration (useful for dev) */
+    disable?: boolean;
+}
+export default function postAudit(options?: PostAuditOptions): AstroIntegration;
+//# sourceMappingURL=integration.d.ts.map

package/dist/integration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"integration.d.ts","sourceRoot":"","sources":["../src/integration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,OAAO,CAAC;AAM9C,MAAM,WAAW,gBAAgB;IAC/B,qCAAqC;IACrC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,iEAAiE;IACjE,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,+BAA+B;IAC/B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACzB,+BAA+B;IAC/B,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,0BAA0B;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,sCAAsC;IACtC,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,wCAAwC;IACxC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,uCAAuC;IACvC,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,yCAAyC;IACzC,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,+CAA+C;IAC/C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,CAAC,OAAO,UAAU,SAAS,CAC/B,OAAO,GAAE,gBAAqB,GAC7B,gBAAgB,CAyElB"}

package/dist/integration.js

@@ -0,0 +1,71 @@
+import { execFileSync } from 'node:child_process';
+import { existsSync } from 'node:fs';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+export default function postAudit(options = {}) {
+    let siteUrl;
+    return {
+        name: 'astro-post-audit',
+        hooks: {
+            'astro:config:done': ({ config }) => {
+                siteUrl = config.site?.toString();
+            },
+            'astro:build:done': ({ dir, logger }) => {
+                if (options.disable)
+                    return;
+                const distPath = fileURLToPath(dir);
+                const binDir = join(dirname(fileURLToPath(import.meta.url)), '..', 'bin');
+                const binaryName = process.platform === 'win32'
+                    ? 'astro-post-audit.exe'
+                    : 'astro-post-audit';
+                const binaryPath = join(binDir, binaryName);
+                if (!existsSync(binaryPath)) {
+                    logger.warn('astro-post-audit binary not found. Run "npm rebuild @casoon/astro-post-audit".');
+                    return;
+                }
+                const args = [distPath];
+                // Use site from options, or auto-detect from Astro config
+                const site = options.site ?? siteUrl;
+                if (site)
+                    args.push('--site', site);
+                if (options.strict)
+                    args.push('--strict');
+                if (options.format)
+                    args.push('--format', options.format);
+                if (options.config)
+                    args.push('--config', options.config);
+                if (options.noSitemapCheck)
+                    args.push('--no-sitemap-check');
+                if (options.checkAssets)
+                    args.push('--check-assets');
+                if (options.checkStructuredData)
+                    args.push('--check-structured-data');
+                if (options.checkSecurity)
+                    args.push('--check-security');
+                if (options.checkDuplicates)
+                    args.push('--check-duplicates');
+                if (options.exclude) {
+                    for (const pattern of options.exclude) {
+                        args.push('--exclude', pattern);
+                    }
+                }
+                logger.info('Running post-build audit...');
+                try {
+                    execFileSync(binaryPath, args, { stdio: 'inherit' });
+                    logger.info('All checks passed!');
+                }
+                catch (err) {
+                    const exitCode = err && typeof err === 'object' && 'status' in err
+                        ? err.status
+                        : undefined;
+                    if (exitCode === 1) {
+                        logger.warn('Audit found issues. See output above.');
+                    }
+                    else {
+                        logger.error(`Audit failed with exit code ${exitCode ?? 'unknown'}`);
+                    }
+                }
+            },
+        },
+    };
+}

package/package.json

@@ -0,0 +1,66 @@
+{
+  "name": "@casoon/astro-post-audit",
+  "version": "0.1.3",
+  "description": "Fast post-build auditor for Astro sites: SEO, links, and lightweight WCAG checks",
+  "license": "MIT",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "bin": {
+    "astro-post-audit": "bin/run.cjs"
+  },
+  "scripts": {
+    "build": "tsc",
+    "postinstall": "node bin/install.cjs"
+  },
+  "files": [
+    "bin/",
+    "dist/"
+  ],
+  "keywords": [
+    "astro",
+    "astro-integration",
+    "seo",
+    "audit",
+    "accessibility",
+    "static-site",
+    "wcag",
+    "canonical",
+    "links"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/casoon/astro-post-audit"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "peerDependencies": {
+    "astro": "^5.0.0 || ^6.0.0-beta.0 || ^6.0.0"
+  },
+  "peerDependenciesMeta": {
+    "astro": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.1",
+    "astro": "^6.0.0-beta.15",
+    "typescript": "^5.9.3"
+  }
+}