maven-api-client 0.0.1 → 1.0.0

package/README.md

@@ -0,0 +1,214 @@
+# maven-api-client
+
+<p align="center">
+  <img src="https://maven.apache.org/images/maven-logo-black-on-white.png" alt="Maven logo" width="200" />
+</p>
+
+[![npm version](https://img.shields.io/npm/v/maven-api-client)](https://www.npmjs.com/package/maven-api-client)
+[![npm downloads](https://img.shields.io/npm/dm/maven-api-client)](https://www.npmjs.com/package/maven-api-client)
+[![Bundle size](https://img.shields.io/bundlephobia/minzip/maven-api-client)](https://bundlephobia.com/package/maven-api-client)
+[![CI](https://github.com/ElJijuna/maven-api-client/actions/workflows/ci.yml/badge.svg)](https://github.com/ElJijuna/maven-api-client/actions/workflows/ci.yml)
+[![semantic-release: angular](https://img.shields.io/badge/semantic--release-angular-e10079?logo=semantic-release)](https://github.com/semantic-release/semantic-release)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](LICENSE)
+[![TypeScript](https://img.shields.io/badge/TypeScript-6.x-blue?logo=typescript&logoColor=white)](https://www.typescriptlang.org/)
+[![Node.js](https://img.shields.io/node/v/maven-api-client)](https://nodejs.org/)
+
+TypeScript client for the [Maven Central Search API](https://central.sonatype.com/). Covers artifact metadata, version listings, search, and suggestions. Works in **Node.js** and the **browser** (isomorphic). Fully typed, zero runtime dependencies.
+
+**Data source:**
+
+| Source | What it provides |
+| --- | --- |
+| [search.maven.org](https://search.maven.org) | Full-text search, artifact versions, and metadata via the Solr search API |
+
+---
+
+## Installation
+
+```bash
+npm install maven-api-client
+```
+
+---
+
+## Quick start
+
+```typescript
+import { MavenClient } from 'maven-api-client';
+
+// Public API — no auth required
+const maven = new MavenClient();
+
+// Custom registry (e.g. a private Nexus/Artifactory instance)
+const privateFeed = new MavenClient({
+  baseUrl: 'https://my-nexus.example.com',
+});
+```
+
+---
+
+## API reference
+
+### Artifact versions
+
+```typescript
+// All published versions
+const versions = await maven.artifact('com.fasterxml.jackson.core', 'jackson-databind').versions();
+console.log(versions); // ['2.0.0', '2.1.0', ..., '2.17.0']
+
+// Latest version (highest timestamp)
+const latest = await maven.artifact('com.fasterxml.jackson.core', 'jackson-databind').latest();
+console.log(latest.v);         // '2.17.0'
+console.log(latest.g);         // 'com.fasterxml.jackson.core'
+console.log(latest.a);         // 'jackson-databind'
+console.log(latest.timestamp); // 1712000000000
+
+// Specific version metadata
+const v2 = await maven.artifact('com.fasterxml.jackson.core', 'jackson-databind').version('2.15.0');
+console.log(v2.v);  // '2.15.0'
+console.log(v2.p);  // 'jar'
+console.log(v2.ec); // ['-sources.jar', '-javadoc.jar', '.jar', '.pom']
+```
+
+### Search
+
+```typescript
+const results = await maven.search({ query: 'jackson databind', rows: 10 });
+
+console.log(results.response.numFound); // total matching artifacts
+
+results.response.docs.forEach(doc => {
+  console.log(doc.id);            // 'com.fasterxml.jackson.core:jackson-databind'
+  console.log(doc.g);             // 'com.fasterxml.jackson.core'
+  console.log(doc.a);             // 'jackson-databind'
+  console.log(doc.latestVersion); // '2.17.0'
+  console.log(doc.versionCount);  // 120
+});
+
+// Paginate
+const page2 = await maven.search({ query: 'logging', rows: 20, start: 20 });
+```
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `query` | `string` | Search text (optional — omit for all artifacts) |
+| `rows` | `number` | Results per page (default: 20) |
+| `start` | `number` | Offset for pagination (default: 0) |
+
+### Suggest
+
+```typescript
+const suggestions = await maven.suggest({ query: 'jackson', rows: 5 });
+
+suggestions.response.docs.forEach(doc => {
+  console.log(doc.id); // 'com.fasterxml.jackson.core:jackson-databind'
+});
+```
+
+| Parameter | Type | Description |
+| --- | --- | --- |
+| `query` | `string` | Prefix or keyword to match |
+| `rows` | `number` | Results to return |
+
+---
+
+## Cancelling requests
+
+Pass an `AbortSignal` to any method to cancel the in-flight request:
+
+```typescript
+const controller = new AbortController();
+setTimeout(() => controller.abort(), 5000);
+
+await maven.artifact('com.example', 'my-lib').versions(controller.signal);
+await maven.artifact('com.example', 'my-lib').latest(controller.signal);
+await maven.artifact('com.example', 'my-lib').version('1.0.0', controller.signal);
+await maven.search({ query: 'jackson' }, controller.signal);
+await maven.suggest({ query: 'jackson' }, controller.signal);
+```
+
+When aborted, `fetch` throws a `DOMException` with `name === 'AbortError'`. The `request` event is still emitted with the error attached.
+
+---
+
+## Request events
+
+Subscribe to every HTTP request for logging, monitoring, or debugging:
+
+```typescript
+maven.on('request', (event) => {
+  console.log(`[${event.statusCode}] ${event.method} ${event.url} (${event.durationMs}ms)`);
+  if (event.error) {
+    console.error('Request failed:', event.error.message);
+  }
+});
+```
+
+| Field | Type | Description |
+| --- | --- | --- |
+| `url` | `string` | Full URL requested |
+| `method` | `'GET'` | HTTP method |
+| `startedAt` | `Date` | When the request started |
+| `finishedAt` | `Date` | When the request finished |
+| `durationMs` | `number` | Duration in milliseconds |
+| `statusCode` | `number \| undefined` | HTTP status code, if a response was received |
+| `error` | `Error \| undefined` | Present only if the request failed |
+
+`on()` is chainable and supports multiple listeners:
+
+```typescript
+maven
+  .on('request', logToConsole)
+  .on('request', sendToDatadog);
+```
+
+---
+
+## Error handling
+
+Non-2xx responses throw a `MavenApiError`:
+
+```typescript
+import { MavenApiError } from 'maven-api-client';
+
+try {
+  await maven.artifact('com.example', 'non-existent').versions();
+} catch (err) {
+  if (err instanceof MavenApiError) {
+    console.log(err.status);     // 404
+    console.log(err.statusText); // 'Not Found'
+    console.log(err.message);    // 'Maven API error: 404 Not Found'
+  }
+}
+```
+
+---
+
+## TypeScript types
+
+All domain types are exported:
+
+```typescript
+import type {
+  // Client
+  MavenClientOptions,
+  RequestEvent,
+  MavenClientEvents,
+
+  // Search & suggest
+  MavenSearchParams,
+  MavenSuggestParams,
+  MavenSearchResult,
+  MavenSearchDoc,
+
+  // Versions
+  MavenVersionsResult,
+  MavenVersionDoc,
+} from 'maven-api-client';
+```
+
+---
+
+## License
+
+[MIT](LICENSE)

package/dist/index.cjs

@@ -0,0 +1,207 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ArtifactResource: () => ArtifactResource,
+  MavenApiError: () => MavenApiError,
+  MavenClient: () => MavenClient
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/errors/MavenApiError.ts
+var MavenApiError = class _MavenApiError extends Error {
+  status;
+  statusText;
+  constructor(status, statusText) {
+    super(`Maven API error: ${status} ${statusText}`);
+    this.name = "MavenApiError";
+    this.status = status;
+    this.statusText = statusText;
+    Object.setPrototypeOf(this, _MavenApiError.prototype);
+  }
+};
+
+// src/resources/ArtifactResource.ts
+var ArtifactResource = class {
+  groupId;
+  artifactId;
+  request;
+  /** @internal */
+  constructor(request, groupId, artifactId) {
+    this.request = request;
+    this.groupId = groupId;
+    this.artifactId = artifactId;
+  }
+  async versions(signal) {
+    const data = await this.request(
+      "/solrsearch/select",
+      {
+        q: `g:${this.groupId} AND a:${this.artifactId}`,
+        core: "gav",
+        rows: 200,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+    return data.response.docs.map((d) => d.v);
+  }
+  async version(v, signal) {
+    const data = await this.request(
+      "/solrsearch/select",
+      {
+        q: `g:${this.groupId} AND a:${this.artifactId}`,
+        core: "gav",
+        rows: 200,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+    const doc = data.response.docs.find((d) => d.v === v);
+    if (!doc) {
+      throw new Error(`Version ${v} not found for ${this.groupId}:${this.artifactId}`);
+    }
+    return doc;
+  }
+  async latest(signal) {
+    const data = await this.request(
+      "/solrsearch/select",
+      {
+        q: `g:${this.groupId} AND a:${this.artifactId}`,
+        core: "gav",
+        rows: 200,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+    const docs = data.response.docs;
+    if (docs.length === 0) {
+      throw new Error(`No versions found for ${this.groupId}:${this.artifactId}`);
+    }
+    return docs.slice().sort((a, b) => b.timestamp - a.timestamp)[0];
+  }
+};
+
+// src/MavenClient.ts
+var DEFAULT_BASE_URL = "https://search.maven.org";
+var MavenClient = class {
+  baseUrl;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  on(event, callback) {
+    const cbs = this.listeners.get(event) ?? [];
+    cbs.push(callback);
+    this.listeners.set(event, cbs);
+    return this;
+  }
+  emit(event, payload) {
+    const cbs = this.listeners.get(event) ?? [];
+    for (const cb of cbs) {
+      cb(payload);
+    }
+  }
+  /** @internal */
+  async request(path, params, _baseUrl, signal) {
+    const url = buildUrl(`${this.baseUrl}${path}`, params);
+    const startedAt = /* @__PURE__ */ new Date();
+    let statusCode;
+    try {
+      const response = await fetch(url, {
+        headers: { Accept: "application/json" },
+        signal
+      });
+      statusCode = response.status;
+      if (!response.ok) {
+        throw new MavenApiError(response.status, response.statusText);
+      }
+      const data = await response.json();
+      this.emit("request", {
+        url,
+        method: "GET",
+        startedAt,
+        finishedAt: /* @__PURE__ */ new Date(),
+        durationMs: Date.now() - startedAt.getTime(),
+        statusCode
+      });
+      return data;
+    } catch (err) {
+      const finishedAt = /* @__PURE__ */ new Date();
+      this.emit("request", {
+        url,
+        method: "GET",
+        startedAt,
+        finishedAt,
+        durationMs: finishedAt.getTime() - startedAt.getTime(),
+        statusCode,
+        error: err instanceof Error ? err : new Error(String(err))
+      });
+      throw err;
+    }
+  }
+  artifact(groupId, artifactId) {
+    return new ArtifactResource(
+      (path, params, baseUrl, signal) => this.request(path, params, baseUrl, signal),
+      groupId,
+      artifactId
+    );
+  }
+  async search(params, signal) {
+    return this.request(
+      "/solrsearch/select",
+      {
+        q: params.query ?? "",
+        rows: params.rows ?? 20,
+        start: params.start ?? 0,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+  }
+  async suggest(params, signal) {
+    return this.request(
+      "/solrsearch/select",
+      {
+        q: params.query,
+        ...params.rows !== void 0 && { rows: params.rows },
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+  }
+};
+function buildUrl(base, params) {
+  if (!params) {
+    return base;
+  }
+  const entries = Object.entries(params).filter(([, v]) => v !== void 0);
+  if (entries.length === 0) {
+    return base;
+  }
+  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));
+  return `${base}?${search.toString()}`;
+}
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/errors/MavenApiError.ts","../src/resources/ArtifactResource.ts","../src/MavenClient.ts"],"sourcesContent":["export type {\n  MavenSearchDoc,\n  MavenSearchParams,\n  MavenSearchResult,\n  MavenSuggestParams,\n} from './domain/Search';\nexport type { MavenVersionDoc, MavenVersionsResult } from './domain/Versions';\nexport { MavenApiError } from './errors/MavenApiError';\nexport type { MavenClientEvents, MavenClientOptions, RequestEvent } from './MavenClient';\nexport { MavenClient } from './MavenClient';\nexport { ArtifactResource } from './resources/ArtifactResource';\n","export class MavenApiError extends Error {\n  readonly status: number;\n  readonly statusText: string;\n\n  constructor(status: number, statusText: string) {\n    super(`Maven API error: ${status} ${statusText}`);\n    this.name = 'MavenApiError';\n    this.status = status;\n    this.statusText = statusText;\n    Object.setPrototypeOf(this, MavenApiError.prototype);\n  }\n}\n","import type { MavenVersionDoc, MavenVersionsResult } from '../domain/Versions';\nimport type { RequestFn } from './types';\n\nexport class ArtifactResource {\n  private readonly groupId: string;\n  private readonly artifactId: string;\n  private readonly request: RequestFn;\n\n  /** @internal */\n  constructor(request: RequestFn, groupId: string, artifactId: string) {\n    this.request = request;\n    this.groupId = groupId;\n    this.artifactId = artifactId;\n  }\n\n  async versions(signal?: AbortSignal): Promise<string[]> {\n    const data = await this.request<MavenVersionsResult>(\n      '/solrsearch/select',\n      {\n        q: `g:${this.groupId} AND a:${this.artifactId}`,\n        core: 'gav',\n        rows: 200,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n    return data.response.docs.map((d) => d.v);\n  }\n\n  async version(v: string, signal?: AbortSignal): Promise<MavenVersionDoc> {\n    const data = await this.request<MavenVersionsResult>(\n      '/solrsearch/select',\n      {\n        q: `g:${this.groupId} AND a:${this.artifactId}`,\n        core: 'gav',\n        rows: 200,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n    const doc = data.response.docs.find((d) => d.v === v);\n    if (!doc) {\n      throw new Error(`Version ${v} not found for ${this.groupId}:${this.artifactId}`);\n    }\n    return doc;\n  }\n\n  async latest(signal?: AbortSignal): Promise<MavenVersionDoc> {\n    const data = await this.request<MavenVersionsResult>(\n      '/solrsearch/select',\n      {\n        q: `g:${this.groupId} AND a:${this.artifactId}`,\n        core: 'gav',\n        rows: 200,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n    const docs = data.response.docs;\n    if (docs.length === 0) {\n      throw new Error(`No versions found for ${this.groupId}:${this.artifactId}`);\n    }\n    return docs.slice().sort((a, b) => b.timestamp - a.timestamp)[0];\n  }\n}\n","import type { MavenSearchParams, MavenSearchResult, MavenSuggestParams } from './domain/Search';\nimport { MavenApiError } from './errors/MavenApiError';\nimport { ArtifactResource } from './resources/ArtifactResource';\n\nconst DEFAULT_BASE_URL = 'https://search.maven.org';\n\nexport interface RequestEvent {\n  url: string;\n  method: 'GET';\n  startedAt: Date;\n  finishedAt: Date;\n  durationMs: number;\n  statusCode?: number;\n  error?: Error;\n}\n\nexport interface MavenClientEvents {\n  request: (event: RequestEvent) => void;\n}\n\nexport interface MavenClientOptions {\n  baseUrl?: string;\n}\n\nexport class MavenClient {\n  private readonly baseUrl: string;\n  private readonly listeners: Map<\n    keyof MavenClientEvents,\n    MavenClientEvents[keyof MavenClientEvents][]\n  > = new Map();\n\n  constructor(options: MavenClientOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  }\n\n  on<K extends keyof MavenClientEvents>(event: K, callback: MavenClientEvents[K]): this {\n    const cbs = this.listeners.get(event) ?? [];\n    cbs.push(callback);\n    this.listeners.set(event, cbs);\n    return this;\n  }\n\n  private emit<K extends keyof MavenClientEvents>(\n    event: K,\n    payload: Parameters<MavenClientEvents[K]>[0],\n  ): void {\n    const cbs = this.listeners.get(event) ?? [];\n    for (const cb of cbs) {\n      (cb as (p: typeof payload) => void)(payload);\n    }\n  }\n\n  /** @internal */\n  private async request<T>(\n    path: string,\n    params?: Record<string, string | number | boolean>,\n    _baseUrl?: string,\n    signal?: AbortSignal,\n  ): Promise<T> {\n    const url = buildUrl(`${this.baseUrl}${path}`, params);\n    const startedAt = new Date();\n    let statusCode: number | undefined;\n    try {\n      const response = await fetch(url, {\n        headers: { Accept: 'application/json' },\n        signal,\n      });\n      statusCode = response.status;\n      if (!response.ok) {\n        throw new MavenApiError(response.status, response.statusText);\n      }\n      const data = (await response.json()) as T;\n      this.emit('request', {\n        url,\n        method: 'GET',\n        startedAt,\n        finishedAt: new Date(),\n        durationMs: Date.now() - startedAt.getTime(),\n        statusCode,\n      });\n      return data;\n    } catch (err) {\n      const finishedAt = new Date();\n      this.emit('request', {\n        url,\n        method: 'GET',\n        startedAt,\n        finishedAt,\n        durationMs: finishedAt.getTime() - startedAt.getTime(),\n        statusCode,\n        error: err instanceof Error ? err : new Error(String(err)),\n      });\n      throw err;\n    }\n  }\n\n  artifact(groupId: string, artifactId: string): ArtifactResource {\n    return new ArtifactResource(\n      <T>(\n        path: string,\n        params?: Record<string, string | number | boolean>,\n        baseUrl?: string,\n        signal?: AbortSignal,\n      ) => this.request<T>(path, params, baseUrl, signal),\n      groupId,\n      artifactId,\n    );\n  }\n\n  async search(params: MavenSearchParams, signal?: AbortSignal): Promise<MavenSearchResult> {\n    return this.request<MavenSearchResult>(\n      '/solrsearch/select',\n      {\n        q: params.query ?? '',\n        rows: params.rows ?? 20,\n        start: params.start ?? 0,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n  }\n\n  async suggest(params: MavenSuggestParams, signal?: AbortSignal): Promise<MavenSearchResult> {\n    return this.request<MavenSearchResult>(\n      '/solrsearch/select',\n      {\n        q: params.query,\n        ...(params.rows !== undefined && { rows: params.rows }),\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n  }\n}\n\nfunction buildUrl(base: string, params?: Record<string, string | number | boolean>): string {\n  if (!params) {\n    return base;\n  }\n  const entries = Object.entries(params).filter(([, v]) => v !== undefined);\n  if (entries.length === 0) {\n    return base;\n  }\n  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));\n  return `${base}?${search.toString()}`;\n}\n"],"mappings":"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","names":[]}

package/dist/index.d.cts

@@ -0,0 +1,96 @@
+interface MavenSearchParams {
+    query?: string;
+    rows?: number;
+    start?: number;
+}
+interface MavenSuggestParams {
+    query: string;
+    rows?: number;
+}
+interface MavenSearchDoc {
+    id: string;
+    g: string;
+    a: string;
+    latestVersion: string;
+    repositoryId: string;
+    p: string;
+    timestamp: number;
+    versionCount: number;
+    ec: string[];
+}
+interface MavenSearchResult {
+    responseHeader: {
+        status: number;
+        QTime: number;
+    };
+    response: {
+        numFound: number;
+        start: number;
+        docs: MavenSearchDoc[];
+    };
+}
+
+interface MavenVersionDoc {
+    id: string;
+    g: string;
+    a: string;
+    v: string;
+    p: string;
+    timestamp: number;
+    ec: string[];
+}
+interface MavenVersionsResult {
+    response: {
+        numFound: number;
+        docs: MavenVersionDoc[];
+    };
+}
+
+declare class MavenApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    constructor(status: number, statusText: string);
+}
+
+type RequestFn = <T>(path: string, params?: Record<string, string | number | boolean>, baseUrl?: string, signal?: AbortSignal) => Promise<T>;
+
+declare class ArtifactResource {
+    private readonly groupId;
+    private readonly artifactId;
+    private readonly request;
+    /** @internal */
+    constructor(request: RequestFn, groupId: string, artifactId: string);
+    versions(signal?: AbortSignal): Promise<string[]>;
+    version(v: string, signal?: AbortSignal): Promise<MavenVersionDoc>;
+    latest(signal?: AbortSignal): Promise<MavenVersionDoc>;
+}
+
+interface RequestEvent {
+    url: string;
+    method: 'GET';
+    startedAt: Date;
+    finishedAt: Date;
+    durationMs: number;
+    statusCode?: number;
+    error?: Error;
+}
+interface MavenClientEvents {
+    request: (event: RequestEvent) => void;
+}
+interface MavenClientOptions {
+    baseUrl?: string;
+}
+declare class MavenClient {
+    private readonly baseUrl;
+    private readonly listeners;
+    constructor(options?: MavenClientOptions);
+    on<K extends keyof MavenClientEvents>(event: K, callback: MavenClientEvents[K]): this;
+    private emit;
+    /** @internal */
+    private request;
+    artifact(groupId: string, artifactId: string): ArtifactResource;
+    search(params: MavenSearchParams, signal?: AbortSignal): Promise<MavenSearchResult>;
+    suggest(params: MavenSuggestParams, signal?: AbortSignal): Promise<MavenSearchResult>;
+}
+
+export { ArtifactResource, MavenApiError, MavenClient, type MavenClientEvents, type MavenClientOptions, type MavenSearchDoc, type MavenSearchParams, type MavenSearchResult, type MavenSuggestParams, type MavenVersionDoc, type MavenVersionsResult, type RequestEvent };

package/dist/index.d.ts

@@ -0,0 +1,96 @@
+interface MavenSearchParams {
+    query?: string;
+    rows?: number;
+    start?: number;
+}
+interface MavenSuggestParams {
+    query: string;
+    rows?: number;
+}
+interface MavenSearchDoc {
+    id: string;
+    g: string;
+    a: string;
+    latestVersion: string;
+    repositoryId: string;
+    p: string;
+    timestamp: number;
+    versionCount: number;
+    ec: string[];
+}
+interface MavenSearchResult {
+    responseHeader: {
+        status: number;
+        QTime: number;
+    };
+    response: {
+        numFound: number;
+        start: number;
+        docs: MavenSearchDoc[];
+    };
+}
+
+interface MavenVersionDoc {
+    id: string;
+    g: string;
+    a: string;
+    v: string;
+    p: string;
+    timestamp: number;
+    ec: string[];
+}
+interface MavenVersionsResult {
+    response: {
+        numFound: number;
+        docs: MavenVersionDoc[];
+    };
+}
+
+declare class MavenApiError extends Error {
+    readonly status: number;
+    readonly statusText: string;
+    constructor(status: number, statusText: string);
+}
+
+type RequestFn = <T>(path: string, params?: Record<string, string | number | boolean>, baseUrl?: string, signal?: AbortSignal) => Promise<T>;
+
+declare class ArtifactResource {
+    private readonly groupId;
+    private readonly artifactId;
+    private readonly request;
+    /** @internal */
+    constructor(request: RequestFn, groupId: string, artifactId: string);
+    versions(signal?: AbortSignal): Promise<string[]>;
+    version(v: string, signal?: AbortSignal): Promise<MavenVersionDoc>;
+    latest(signal?: AbortSignal): Promise<MavenVersionDoc>;
+}
+
+interface RequestEvent {
+    url: string;
+    method: 'GET';
+    startedAt: Date;
+    finishedAt: Date;
+    durationMs: number;
+    statusCode?: number;
+    error?: Error;
+}
+interface MavenClientEvents {
+    request: (event: RequestEvent) => void;
+}
+interface MavenClientOptions {
+    baseUrl?: string;
+}
+declare class MavenClient {
+    private readonly baseUrl;
+    private readonly listeners;
+    constructor(options?: MavenClientOptions);
+    on<K extends keyof MavenClientEvents>(event: K, callback: MavenClientEvents[K]): this;
+    private emit;
+    /** @internal */
+    private request;
+    artifact(groupId: string, artifactId: string): ArtifactResource;
+    search(params: MavenSearchParams, signal?: AbortSignal): Promise<MavenSearchResult>;
+    suggest(params: MavenSuggestParams, signal?: AbortSignal): Promise<MavenSearchResult>;
+}
+
+export { ArtifactResource, MavenApiError, MavenClient, type MavenClientEvents, type MavenClientOptions, type MavenSearchDoc, type MavenSearchParams, type MavenSearchResult, type MavenSuggestParams, type MavenVersionDoc, type MavenVersionsResult, type RequestEvent };

package/dist/index.js

@@ -0,0 +1,184 @@
+// src/errors/MavenApiError.ts
+var MavenApiError = class _MavenApiError extends Error {
+  status;
+  statusText;
+  constructor(status, statusText) {
+    super(`Maven API error: ${status} ${statusText}`);
+    this.name = "MavenApiError";
+    this.status = status;
+    this.statusText = statusText;
+    Object.setPrototypeOf(this, _MavenApiError.prototype);
+  }
+};
+
+// src/resources/ArtifactResource.ts
+var ArtifactResource = class {
+  groupId;
+  artifactId;
+  request;
+  /** @internal */
+  constructor(request, groupId, artifactId) {
+    this.request = request;
+    this.groupId = groupId;
+    this.artifactId = artifactId;
+  }
+  async versions(signal) {
+    const data = await this.request(
+      "/solrsearch/select",
+      {
+        q: `g:${this.groupId} AND a:${this.artifactId}`,
+        core: "gav",
+        rows: 200,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+    return data.response.docs.map((d) => d.v);
+  }
+  async version(v, signal) {
+    const data = await this.request(
+      "/solrsearch/select",
+      {
+        q: `g:${this.groupId} AND a:${this.artifactId}`,
+        core: "gav",
+        rows: 200,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+    const doc = data.response.docs.find((d) => d.v === v);
+    if (!doc) {
+      throw new Error(`Version ${v} not found for ${this.groupId}:${this.artifactId}`);
+    }
+    return doc;
+  }
+  async latest(signal) {
+    const data = await this.request(
+      "/solrsearch/select",
+      {
+        q: `g:${this.groupId} AND a:${this.artifactId}`,
+        core: "gav",
+        rows: 200,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+    const docs = data.response.docs;
+    if (docs.length === 0) {
+      throw new Error(`No versions found for ${this.groupId}:${this.artifactId}`);
+    }
+    return docs.slice().sort((a, b) => b.timestamp - a.timestamp)[0];
+  }
+};
+
+// src/MavenClient.ts
+var DEFAULT_BASE_URL = "https://search.maven.org";
+var MavenClient = class {
+  baseUrl;
+  listeners = /* @__PURE__ */ new Map();
+  constructor(options = {}) {
+    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\/$/, "");
+  }
+  on(event, callback) {
+    const cbs = this.listeners.get(event) ?? [];
+    cbs.push(callback);
+    this.listeners.set(event, cbs);
+    return this;
+  }
+  emit(event, payload) {
+    const cbs = this.listeners.get(event) ?? [];
+    for (const cb of cbs) {
+      cb(payload);
+    }
+  }
+  /** @internal */
+  async request(path, params, _baseUrl, signal) {
+    const url = buildUrl(`${this.baseUrl}${path}`, params);
+    const startedAt = /* @__PURE__ */ new Date();
+    let statusCode;
+    try {
+      const response = await fetch(url, {
+        headers: { Accept: "application/json" },
+        signal
+      });
+      statusCode = response.status;
+      if (!response.ok) {
+        throw new MavenApiError(response.status, response.statusText);
+      }
+      const data = await response.json();
+      this.emit("request", {
+        url,
+        method: "GET",
+        startedAt,
+        finishedAt: /* @__PURE__ */ new Date(),
+        durationMs: Date.now() - startedAt.getTime(),
+        statusCode
+      });
+      return data;
+    } catch (err) {
+      const finishedAt = /* @__PURE__ */ new Date();
+      this.emit("request", {
+        url,
+        method: "GET",
+        startedAt,
+        finishedAt,
+        durationMs: finishedAt.getTime() - startedAt.getTime(),
+        statusCode,
+        error: err instanceof Error ? err : new Error(String(err))
+      });
+      throw err;
+    }
+  }
+  artifact(groupId, artifactId) {
+    return new ArtifactResource(
+      (path, params, baseUrl, signal) => this.request(path, params, baseUrl, signal),
+      groupId,
+      artifactId
+    );
+  }
+  async search(params, signal) {
+    return this.request(
+      "/solrsearch/select",
+      {
+        q: params.query ?? "",
+        rows: params.rows ?? 20,
+        start: params.start ?? 0,
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+  }
+  async suggest(params, signal) {
+    return this.request(
+      "/solrsearch/select",
+      {
+        q: params.query,
+        ...params.rows !== void 0 && { rows: params.rows },
+        wt: "json"
+      },
+      void 0,
+      signal
+    );
+  }
+};
+function buildUrl(base, params) {
+  if (!params) {
+    return base;
+  }
+  const entries = Object.entries(params).filter(([, v]) => v !== void 0);
+  if (entries.length === 0) {
+    return base;
+  }
+  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));
+  return `${base}?${search.toString()}`;
+}
+export {
+  ArtifactResource,
+  MavenApiError,
+  MavenClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors/MavenApiError.ts","../src/resources/ArtifactResource.ts","../src/MavenClient.ts"],"sourcesContent":["export class MavenApiError extends Error {\n  readonly status: number;\n  readonly statusText: string;\n\n  constructor(status: number, statusText: string) {\n    super(`Maven API error: ${status} ${statusText}`);\n    this.name = 'MavenApiError';\n    this.status = status;\n    this.statusText = statusText;\n    Object.setPrototypeOf(this, MavenApiError.prototype);\n  }\n}\n","import type { MavenVersionDoc, MavenVersionsResult } from '../domain/Versions';\nimport type { RequestFn } from './types';\n\nexport class ArtifactResource {\n  private readonly groupId: string;\n  private readonly artifactId: string;\n  private readonly request: RequestFn;\n\n  /** @internal */\n  constructor(request: RequestFn, groupId: string, artifactId: string) {\n    this.request = request;\n    this.groupId = groupId;\n    this.artifactId = artifactId;\n  }\n\n  async versions(signal?: AbortSignal): Promise<string[]> {\n    const data = await this.request<MavenVersionsResult>(\n      '/solrsearch/select',\n      {\n        q: `g:${this.groupId} AND a:${this.artifactId}`,\n        core: 'gav',\n        rows: 200,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n    return data.response.docs.map((d) => d.v);\n  }\n\n  async version(v: string, signal?: AbortSignal): Promise<MavenVersionDoc> {\n    const data = await this.request<MavenVersionsResult>(\n      '/solrsearch/select',\n      {\n        q: `g:${this.groupId} AND a:${this.artifactId}`,\n        core: 'gav',\n        rows: 200,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n    const doc = data.response.docs.find((d) => d.v === v);\n    if (!doc) {\n      throw new Error(`Version ${v} not found for ${this.groupId}:${this.artifactId}`);\n    }\n    return doc;\n  }\n\n  async latest(signal?: AbortSignal): Promise<MavenVersionDoc> {\n    const data = await this.request<MavenVersionsResult>(\n      '/solrsearch/select',\n      {\n        q: `g:${this.groupId} AND a:${this.artifactId}`,\n        core: 'gav',\n        rows: 200,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n    const docs = data.response.docs;\n    if (docs.length === 0) {\n      throw new Error(`No versions found for ${this.groupId}:${this.artifactId}`);\n    }\n    return docs.slice().sort((a, b) => b.timestamp - a.timestamp)[0];\n  }\n}\n","import type { MavenSearchParams, MavenSearchResult, MavenSuggestParams } from './domain/Search';\nimport { MavenApiError } from './errors/MavenApiError';\nimport { ArtifactResource } from './resources/ArtifactResource';\n\nconst DEFAULT_BASE_URL = 'https://search.maven.org';\n\nexport interface RequestEvent {\n  url: string;\n  method: 'GET';\n  startedAt: Date;\n  finishedAt: Date;\n  durationMs: number;\n  statusCode?: number;\n  error?: Error;\n}\n\nexport interface MavenClientEvents {\n  request: (event: RequestEvent) => void;\n}\n\nexport interface MavenClientOptions {\n  baseUrl?: string;\n}\n\nexport class MavenClient {\n  private readonly baseUrl: string;\n  private readonly listeners: Map<\n    keyof MavenClientEvents,\n    MavenClientEvents[keyof MavenClientEvents][]\n  > = new Map();\n\n  constructor(options: MavenClientOptions = {}) {\n    this.baseUrl = (options.baseUrl ?? DEFAULT_BASE_URL).replace(/\\/$/, '');\n  }\n\n  on<K extends keyof MavenClientEvents>(event: K, callback: MavenClientEvents[K]): this {\n    const cbs = this.listeners.get(event) ?? [];\n    cbs.push(callback);\n    this.listeners.set(event, cbs);\n    return this;\n  }\n\n  private emit<K extends keyof MavenClientEvents>(\n    event: K,\n    payload: Parameters<MavenClientEvents[K]>[0],\n  ): void {\n    const cbs = this.listeners.get(event) ?? [];\n    for (const cb of cbs) {\n      (cb as (p: typeof payload) => void)(payload);\n    }\n  }\n\n  /** @internal */\n  private async request<T>(\n    path: string,\n    params?: Record<string, string | number | boolean>,\n    _baseUrl?: string,\n    signal?: AbortSignal,\n  ): Promise<T> {\n    const url = buildUrl(`${this.baseUrl}${path}`, params);\n    const startedAt = new Date();\n    let statusCode: number | undefined;\n    try {\n      const response = await fetch(url, {\n        headers: { Accept: 'application/json' },\n        signal,\n      });\n      statusCode = response.status;\n      if (!response.ok) {\n        throw new MavenApiError(response.status, response.statusText);\n      }\n      const data = (await response.json()) as T;\n      this.emit('request', {\n        url,\n        method: 'GET',\n        startedAt,\n        finishedAt: new Date(),\n        durationMs: Date.now() - startedAt.getTime(),\n        statusCode,\n      });\n      return data;\n    } catch (err) {\n      const finishedAt = new Date();\n      this.emit('request', {\n        url,\n        method: 'GET',\n        startedAt,\n        finishedAt,\n        durationMs: finishedAt.getTime() - startedAt.getTime(),\n        statusCode,\n        error: err instanceof Error ? err : new Error(String(err)),\n      });\n      throw err;\n    }\n  }\n\n  artifact(groupId: string, artifactId: string): ArtifactResource {\n    return new ArtifactResource(\n      <T>(\n        path: string,\n        params?: Record<string, string | number | boolean>,\n        baseUrl?: string,\n        signal?: AbortSignal,\n      ) => this.request<T>(path, params, baseUrl, signal),\n      groupId,\n      artifactId,\n    );\n  }\n\n  async search(params: MavenSearchParams, signal?: AbortSignal): Promise<MavenSearchResult> {\n    return this.request<MavenSearchResult>(\n      '/solrsearch/select',\n      {\n        q: params.query ?? '',\n        rows: params.rows ?? 20,\n        start: params.start ?? 0,\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n  }\n\n  async suggest(params: MavenSuggestParams, signal?: AbortSignal): Promise<MavenSearchResult> {\n    return this.request<MavenSearchResult>(\n      '/solrsearch/select',\n      {\n        q: params.query,\n        ...(params.rows !== undefined && { rows: params.rows }),\n        wt: 'json',\n      },\n      undefined,\n      signal,\n    );\n  }\n}\n\nfunction buildUrl(base: string, params?: Record<string, string | number | boolean>): string {\n  if (!params) {\n    return base;\n  }\n  const entries = Object.entries(params).filter(([, v]) => v !== undefined);\n  if (entries.length === 0) {\n    return base;\n  }\n  const search = new URLSearchParams(entries.map(([k, v]) => [k, String(v)]));\n  return `${base}?${search.toString()}`;\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "maven-api-client",
-  "version": "0.0.1",
-  "description": "",
+  "version": "1.0.0",
+  "description": "TypeScript client for the Maven Central REST API",
   "homepage": "https://github.com/ElJijuna/maven-api-client#readme",
   "bugs": {
     "url": "https://github.com/ElJijuna/maven-api-client/issues"
@@ -11,10 +11,60 @@
     "url": "git+https://github.com/ElJijuna/maven-api-client.git"
   },
   "license": "MIT",
-  "author": "pilmee <pilmee@gmail.com>",
+  "author": "pilmee <pilmee@gmail.com> (https://github.com/ElJijuna)",
   "type": "module",
-  "main": "index.js",
+  "main": "dist/index.cjs",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "maven",
+    "maven-central",
+    "registry",
+    "api-client",
+    "rest",
+    "typescript"
+  ],
   "scripts": {
-    "test": "jest"
+    "build": "tsup",
+    "check": "npm run lint && npm run format:check",
+    "format": "biome check --write .",
+    "format:check": "biome check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint . --fix",
+    "test": "jest",
+    "test:coverage": "jest --coverage",
+    "test:client": "npm run build && node test-client/test.js",
+    "docs": "typedoc"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.16",
+    "@semantic-release/changelog": "^6.0.3",
+    "@semantic-release/github": "^12.0.8",
+    "@types/jest": "^30.0.0",
+    "eslint": "^9.39.4",
+    "jest": "^30.4.2",
+    "semantic-release": "^25.0.3",
+    "super-configs": "^1.12.0",
+    "ts-jest": "^29.4.11",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "typedoc": "^0.28.19",
+    "typescript": "^6.0.3"
+  },
+  "publishConfig": {
+    "access": "public"
   }
 }