fitzroy 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Jack McPherson
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# fitzroy
+
+TypeScript library and CLI for AFL data — match results, player stats, fixtures, ladders, lineups, squads, and teams.
+
+A port of the [fitzRoy R package](https://github.com/jimmyday12/fitzRoy).
+
+## Data Sources
+
+- **AFL API** — official AFL/AFLW match results, player stats, fixtures, lineups, ladders, and teams
+- **FootyWire** — scraped match results
+- **AFL Tables** — historical season results (1897-present)
+
+## Install
+
+```bash
+npm install fitzroy
+```
+
+## Library Usage
+
+```typescript
+import { fetchMatchResults, fetchPlayerStats, fetchLadder } from "fitzroy";
+
+// Match results for a season
+const matches = await fetchMatchResults({ source: "afl-api", season: 2025, competition: "AFLM" });
+
+// Player stats for a specific round
+const stats = await fetchPlayerStats({ source: "afl-api", season: 2025, round: 1 });
+
+// Ladder standings
+const ladder = await fetchLadder({ source: "afl-api", season: 2025 });
+```
+
+All functions return `Result<T, Error>` — check `result.success` before accessing `result.data`.
+
+## CLI
+
+```bash
+# Install globally
+npm install -g fitzroy
+
+# Match results
+fitzroy matches --season 2025 --round 1
+
+# Player stats
+fitzroy stats --season 2025 --round 1
+
+# Ladder
+fitzroy ladder --season 2025
+
+# Fixture
+fitzroy fixture --season 2025
+
+# Output formats
+fitzroy matches --season 2025 --json    # JSON (default when piped)
+fitzroy matches --season 2025 --csv     # CSV with headers
+fitzroy matches --season 2025 --full    # All columns in table view
+```
+
+Run `fitzroy --help` for all commands and options.
+
+## Contributing
+
+1. Clone the repo
+2. Install dependencies: `bun install`
+3. Run quality checks: `npm run typecheck && npm run check && npm run test`
+
+## License
+
+MIT

package/dist/cli.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+import {
+  __require
+} from "./shared/chunk-xv8z2kms.js";
+
+// src/cli.ts
+import { defineCommand, runMain } from "citty";
+import pc from "picocolors";
+
+// src/lib/errors.ts
+class AflApiError extends Error {
+  statusCode;
+  name = "AflApiError";
+  constructor(message, statusCode) {
+    super(message);
+    this.statusCode = statusCode;
+  }
+}
+
+class ScrapeError extends Error {
+  source;
+  name = "ScrapeError";
+  constructor(message, source) {
+    super(message);
+    this.source = source;
+  }
+}
+
+class UnsupportedSourceError extends Error {
+  source;
+  name = "UnsupportedSourceError";
+  constructor(message, source) {
+    super(message);
+    this.source = source;
+  }
+}
+
+class ValidationError extends Error {
+  issues;
+  name = "ValidationError";
+  constructor(message, issues) {
+    super(message);
+    this.issues = issues;
+  }
+}
+
+// src/cli.ts
+var main = defineCommand({
+  meta: {
+    name: "fitzroy",
+    version: "1.0.0",
+    description: "CLI for fetching AFL data — match results, player stats, fixtures, ladders, and more"
+  },
+  subCommands: {
+    matches: () => import("./shared/chunk-kr78ch1j.js").then((m) => m.matchesCommand),
+    stats: () => import("./shared/chunk-ngvkaczn.js").then((m) => m.statsCommand),
+    fixture: () => import("./shared/chunk-99nkfy8s.js").then((m) => m.fixtureCommand),
+    ladder: () => import("./shared/chunk-d6fkap72.js").then((m) => m.ladderCommand),
+    lineup: () => import("./shared/chunk-9zcjfgwe.js").then((m) => m.lineupCommand),
+    squad: () => import("./shared/chunk-c7vawngt.js").then((m) => m.squadCommand),
+    teams: () => import("./shared/chunk-b380x0p6.js").then((m) => m.teamsCommand)
+  }
+});
+function formatError(error) {
+  if (error instanceof ValidationError && error.issues) {
+    const issueLines = error.issues.map((i) => `  ${pc.yellow(i.path)}: ${i.message}`);
+    return `${pc.red("Validation error:")}
+${issueLines.join(`
+`)}`;
+  }
+  if (error instanceof AflApiError) {
+    const status = error.statusCode ? ` (HTTP ${error.statusCode})` : "";
+    return `${pc.red("AFL API error:")} ${error.message}${status}`;
+  }
+  if (error instanceof ScrapeError) {
+    const source = error.source ? ` [${error.source}]` : "";
+    return `${pc.red("Scrape error:")} ${error.message}${source}`;
+  }
+  if (error instanceof UnsupportedSourceError) {
+    return `${pc.red("Unsupported source:")} ${error.message}`;
+  }
+  if (error instanceof Error) {
+    return `${pc.red("Error:")} ${error.message}`;
+  }
+  return `${pc.red("Error:")} ${String(error)}`;
+}
+runMain(main).catch((error) => {
+  console.error(formatError(error));
+  process.exit(1);
+});