cricinfo-cli-go 0.1.0

package/internal/cricinfo/testdata/fixtures/team-competitor/team-789643.json

@@ -0,0 +1,67 @@
+{
+  "$ref": "http://core.espnuk.org/v2/sports/cricket/teams/789643",
+  "id": "789643",
+  "uid": "s:200~t:789643",
+  "location": "Afghanistan",
+  "name": "Boost Region",
+  "nickname": "Boost Region",
+  "abbreviation": "BOOST",
+  "displayName": "Boost Region",
+  "shortDisplayName": "BOOST",
+  "isNational": false,
+  "isActive": true,
+  "countryCode": "AF",
+  "slug": "boost-region",
+  "classes": [
+    4,
+    5,
+    6,
+    14
+  ],
+  "event": {
+    "date": "2026-04-09T05:30Z",
+    "$ref": "http://core.espnuk.org/v2/sports/cricket/leagues/19138/events/1529474"
+  },
+  "defaultLeague": {
+    "$ref": "http://core.espnuk.org/v2/sports/cricket/leagues/19138"
+  },
+  "color": "",
+  "logos": [
+    {
+      "href": "https://a.espncdn.com/i/teamlogos/cricket/500/789643.png",
+      "rel": [
+        "full",
+        "default"
+      ]
+    }
+  ],
+  "athletes": {
+    "$ref": "http://core.espnuk.org/v2/sports/cricket/teams/789643/athletes"
+  },
+  "links": [
+    {
+      "language": "en",
+      "rel": [
+        "clubhouse",
+        "desktop"
+      ],
+      "href": "https://www.espn.in/cricket/team/_/id/789643/boost-region",
+      "text": "Clubhouse",
+      "shortText": "Clubhouse",
+      "isExternal": false,
+      "isPremium": false
+    },
+    {
+      "language": "en",
+      "rel": [
+        "fixtures",
+        "desktop"
+      ],
+      "href": "https://www.espn.in/cricket/scores/team/789643/boost-region",
+      "text": "Fixtures",
+      "shortText": "Fixtures",
+      "isExternal": false,
+      "isPremium": false
+    }
+  ]
+}

package/internal/cricinfo/testdata/golden/match-empty.golden

@@ -0,0 +1 @@
+No matches found.

package/internal/cricinfo/testdata/golden/match-list.golden

@@ -0,0 +1,2 @@
+Matches (1)
+1. 1529474 - 3rd Match,  at Kandahar - 789643 vs 789647 - 2026-04-09T05:30Z

package/internal/cricinfo/testdata/golden/match-partial.golden

@@ -0,0 +1,3 @@
+Partial data returned: plays endpoint returned pointer-only payload
+Matches (1)
+1. 1529474 - 3rd Match,  at Kandahar - 789643 vs 789647 - 2026-04-09T05:30Z

package/internal/cricinfo/types.go

@@ -0,0 +1,54 @@
+package cricinfo
+
+import "encoding/json"
+
+// Ref is the common Cricinfo hypermedia reference object.
+type Ref struct {
+	URL string `json:"$ref"`
+}
+
+// Page is the common paginated response envelope used by many routes.
+type Page[T any] struct {
+	Count     int `json:"count"`
+	Items     []T `json:"items"`
+	PageCount int `json:"pageCount"`
+	PageIndex int `json:"pageIndex"`
+	PageSize  int `json:"pageSize"`
+}
+
+// RootDiscovery is a minimal shape for the API root resource.
+type RootDiscovery struct {
+	Ref     string `json:"$ref,omitempty"`
+	ID      string `json:"id,omitempty"`
+	Name    string `json:"name,omitempty"`
+	Slug    string `json:"slug,omitempty"`
+	UID     string `json:"uid,omitempty"`
+	Events  *Ref   `json:"events,omitempty"`
+	Leagues *Ref   `json:"leagues,omitempty"`
+}
+
+// StatsObject is a minimal single-object stats payload shape.
+type StatsObject struct {
+	Ref         string          `json:"$ref,omitempty"`
+	Athlete     *Ref            `json:"athlete,omitempty"`
+	Competition *Ref            `json:"competition,omitempty"`
+	Team        *Ref            `json:"team,omitempty"`
+	Splits      json.RawMessage `json:"splits"`
+}
+
+// Document is a fetched JSON payload plus request/canonical metadata.
+type Document struct {
+	RequestedRef string
+	CanonicalRef string
+	StatusCode   int
+	Body         []byte
+}
+
+// ResolvedDocument is the result of following a pointer chain.
+type ResolvedDocument struct {
+	RequestedRef string
+	CanonicalRef string
+	TraversedRef []string
+	StatusCode   int
+	Body         []byte
+}

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "cricinfo-cli-go",
+  "version": "0.1.0",
+  "description": "Cricinfo command line interface",
+  "license": "MIT",
+  "author": "amxv",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/amxv/cricinfo-cli.git"
+  },
+  "homepage": "https://github.com/amxv/cricinfo-cli#readme",
+  "bugs": {
+    "url": "https://github.com/amxv/cricinfo-cli/issues"
+  },
+  "bin": {
+    "cricinfo": "bin/cricinfo.js"
+  },
+  "config": {
+    "cliBinaryName": "cricinfo"
+  },
+  "files": [
+    "bin/cricinfo.js",
+    "scripts/postinstall.js",
+    "cmd",
+    "internal",
+    "go.mod",
+    "go.sum",
+    "README.md",
+    "LICENSE",
+    "AGENTS.md",
+    "CONTRIBUTORS.md",
+    "Makefile"
+  ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js",
+    "test": "node --check bin/cricinfo.js && node --check scripts/postinstall.js",
+    "lint": "npm run test",
+    "fixtures:refresh": "go run ./internal/cricinfo/cmd/fixture-refresh --write",
+    "test:live": "CRICINFO_LIVE_MATRIX=1 go test ./internal/cricinfo -run TestLive -count=1"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "go",
+    "cli",
+    "template",
+    "npm",
+    "release"
+  ]
+}

package/scripts/postinstall.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+
+const fs = require("node:fs");
+const path = require("node:path");
+const https = require("node:https");
+const { spawnSync } = require("node:child_process");
+
+const pkg = require("../package.json");
+const cliName = resolveCLIName(pkg);
+
+const repoURL = pkg.repository?.url || "";
+const repoMatch = repoURL.match(/github\.com[:/](.+?)\/(.+?)(?:\.git)?$/);
+if (!repoMatch) {
+  console.error("package.json repository.url must point to a GitHub repo.");
+  process.exit(1);
+}
+
+const repoOwner = repoMatch[1];
+const repoName = repoMatch[2];
+
+const goosMap = {
+  darwin: "darwin",
+  linux: "linux",
+  win32: "windows"
+};
+
+const goarchMap = {
+  x64: "amd64",
+  arm64: "arm64"
+};
+
+const goos = goosMap[process.platform];
+const goarch = goarchMap[process.arch];
+
+const rootDir = path.resolve(__dirname, "..");
+const binDir = path.join(rootDir, "bin");
+const binaryName = process.platform === "win32" ? `${cliName}.exe` : `${cliName}-bin`;
+const destination = path.join(binDir, binaryName);
+
+function buildLdflags(version) {
+  const resolvedVersion = `${version || ""}`.trim() || "dev";
+  return `-s -w -X github.com/amxv/cricinfo-cli/internal/buildinfo.Version=${resolvedVersion}`;
+}
+
+async function main() {
+  if (!goos || !goarch) {
+    console.warn(`Unsupported platform/arch: ${process.platform}/${process.arch}`);
+    fallbackBuildOrExit();
+    return;
+  }
+
+  fs.mkdirSync(binDir, { recursive: true });
+
+  const version = pkg.version;
+  const assetName = `${cliName}_${goos}_${goarch}${goos === "windows" ? ".exe" : ""}`;
+  const assetURL = `https://github.com/${repoOwner}/${repoName}/releases/download/v${version}/${assetName}`;
+
+  try {
+    await downloadToFile(assetURL, destination);
+    if (goos !== "windows") {
+      fs.chmodSync(destination, 0o755);
+    }
+    console.log(`Installed ${cliName} binary from ${assetURL}`);
+  } catch (err) {
+    console.warn(`Failed to download prebuilt binary: ${err.message}`);
+    fallbackBuildOrExit();
+  }
+}
+
+function fallbackBuildOrExit() {
+  const hasGo = spawnSync("go", ["version"], { stdio: "ignore" }).status === 0;
+  const hasSource = fs.existsSync(path.join(rootDir, "cmd", cliName, "main.go"));
+
+  if (!hasGo || !hasSource) {
+    console.error("Unable to install CLI binary. Missing release asset and local Go build fallback.");
+    process.exit(1);
+  }
+
+  const result = spawnSync(
+    "go",
+    ["build", "-trimpath", `-ldflags=${buildLdflags(pkg.version)}`, "-o", destination, `./cmd/${cliName}`],
+    { cwd: rootDir, stdio: "inherit" }
+  );
+
+  if (result.status !== 0) {
+    process.exit(result.status || 1);
+  }
+
+  if (goos !== "windows") {
+    fs.chmodSync(destination, 0o755);
+  }
+
+  console.log("Installed CLI binary by building from source.");
+}
+
+function downloadToFile(url, destinationPath) {
+  return new Promise((resolve, reject) => {
+    const request = https.get(url, (response) => {
+      if (response.statusCode >= 300 && response.statusCode < 400 && response.headers.location) {
+        response.resume();
+        downloadToFile(response.headers.location, destinationPath).then(resolve).catch(reject);
+        return;
+      }
+
+      if (response.statusCode !== 200) {
+        response.resume();
+        reject(new Error(`HTTP ${response.statusCode}`));
+        return;
+      }
+
+      const file = fs.createWriteStream(destinationPath);
+      response.pipe(file);
+
+      file.on("finish", () => {
+        file.close((err) => {
+          if (err) {
+            reject(err);
+            return;
+          }
+          resolve();
+        });
+      });
+
+      file.on("error", (err) => {
+        fs.rmSync(destinationPath, { force: true });
+        reject(err);
+      });
+    });
+
+    request.on("error", reject);
+  });
+}
+
+main().catch((err) => {
+  console.error(err.message);
+  process.exit(1);
+});
+
+function resolveCLIName(packageJSON) {
+  const configured = `${packageJSON?.config?.cliBinaryName || ""}`.trim();
+  if (configured) {
+    return configured;
+  }
+
+  if (packageJSON?.bin && typeof packageJSON.bin === "object") {
+    const names = Object.keys(packageJSON.bin);
+    if (names.length > 0 && `${names[0]}`.trim()) {
+      return `${names[0]}`.trim();
+    }
+  }
+
+  return "cricinfo";
+}