dupr-js-client 0.1.1 → 1.0.1

package/dist/index.cjs

@@ -1,603 +0,0 @@
-'use strict';
-
-// src/config.ts
-function resolveConfig(opts) {
-  const cfg = {
-    baseUrl: opts.baseUrl ?? "https://uat.mydupr.com/api",
-    version: opts.version ?? "v1.0",
-    timeoutMs: opts.timeoutMs ?? 3e4,
-    auth: opts.auth ?? { type: "none" },
-    userAgent: opts.userAgent ?? "dupr-js-client/0.1.0",
-    customFetch: opts.customFetch ?? globalThis.fetch.bind(globalThis),
-    retry: opts.retry === false ? false : {
-      maxRetries: opts.retry?.maxRetries ?? 3,
-      baseDelayMs: opts.retry?.baseDelayMs ?? 1e3,
-      maxDelayMs: opts.retry?.maxDelayMs ?? 3e4
-    }
-  };
-  if (opts.onRequest) cfg.onRequest = opts.onRequest;
-  if (opts.onResponse) cfg.onResponse = opts.onResponse;
-  return cfg;
-}
-
-// src/errors.ts
-var DuprApiError = class extends Error {
-  constructor(message, statusCode, details, duprRequestId) {
-    super(message);
-    this.statusCode = statusCode;
-    this.details = details;
-    this.duprRequestId = duprRequestId;
-    this.name = "DuprApiError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var AuthenticationError = class extends DuprApiError {
-  constructor(message, statusCode, details, duprRequestId) {
-    super(message, statusCode, details, duprRequestId);
-    this.name = "AuthenticationError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var ValidationError = class extends DuprApiError {
-  constructor(message, statusCode, details, duprRequestId) {
-    super(message, statusCode, details, duprRequestId);
-    this.name = "ValidationError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var NotFoundError = class extends DuprApiError {
-  constructor(message, statusCode, details, duprRequestId) {
-    super(message, statusCode, details, duprRequestId);
-    this.name = "NotFoundError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var RateLimitError = class extends DuprApiError {
-  constructor(message, statusCode, details, duprRequestId) {
-    super(message, statusCode, details, duprRequestId);
-    this.name = "RateLimitError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-var ServerError = class extends DuprApiError {
-  constructor(message, statusCode, details, duprRequestId) {
-    super(message, statusCode, details, duprRequestId);
-    this.name = "ServerError";
-    Object.setPrototypeOf(this, new.target.prototype);
-  }
-};
-async function buildError(res) {
-  let body;
-  const requestId = res.headers.get("x-request-id") ?? res.headers.get("x-dupr-request-id") ?? void 0;
-  try {
-    body = await res.json();
-  } catch {
-  }
-  const msg = (typeof body === "object" && body !== null && "message" in body && typeof body["message"] === "string" ? body["message"] : null) ?? `DUPR API error ${res.status}`;
-  switch (true) {
-    case (res.status === 401 || res.status === 403):
-      return new AuthenticationError(msg, res.status, body, requestId);
-    case res.status === 404:
-      return new NotFoundError(msg, res.status, body, requestId);
-    case res.status === 400:
-      return new ValidationError(msg, res.status, body, requestId);
-    case res.status === 429:
-      return new RateLimitError(msg, res.status, body, requestId);
-    case res.status >= 500:
-      return new ServerError(msg, res.status, body, requestId);
-    default:
-      return new DuprApiError(msg, res.status, body, requestId);
-  }
-}
-
-// src/http.ts
-function sleep(ms) {
-  return new Promise((resolve) => setTimeout(resolve, ms));
-}
-function retryDelayMs(attempt, baseDelayMs, maxDelayMs) {
-  const exp = Math.min(baseDelayMs * 2 ** attempt, maxDelayMs);
-  return exp * (0.8 + Math.random() * 0.4);
-}
-function isRetryable(err) {
-  if (err instanceof RateLimitError) return true;
-  if (err instanceof ServerError) return true;
-  if (err instanceof TypeError) return true;
-  return false;
-}
-var HttpClient = class {
-  constructor(config) {
-    this.config = config;
-    this.token = null;
-    this.tokenExpiresAt = 0;
-  }
-  async getBearerToken() {
-    if (this.config.overrideBearerToken) {
-      return this.config.overrideBearerToken;
-    }
-    if (this.config.auth.type === "staticBearer") {
-      return this.config.auth.bearerToken;
-    }
-    if (this.config.auth.type !== "clientCredentials") {
-      throw new AuthenticationError("No auth configured \u2014 set auth in DuprClientOptions or call setBearerToken()", 401);
-    }
-    if (this.token && Date.now() < this.tokenExpiresAt) {
-      return this.token;
-    }
-    const { clientKey, clientSecret } = this.config.auth;
-    const encoded = Buffer.from(`${clientKey}:${clientSecret}`).toString("base64");
-    const url = `${this.config.baseUrl}/auth/${this.config.version}/token`;
-    const start = Date.now();
-    const res = await this.config.customFetch(url, {
-      method: "POST",
-      headers: {
-        "x-authorization": encoded,
-        "User-Agent": this.config.userAgent
-      },
-      signal: AbortSignal.timeout(this.config.timeoutMs)
-    });
-    this.config.onResponse?.({ status: res.status, url, durationMs: Date.now() - start });
-    if (!res.ok) throw await buildError(res);
-    const body = await res.json();
-    this.token = body.token ?? body.accessToken ?? null;
-    if (!this.token) throw new AuthenticationError("Token response contained no token", 401);
-    const ttlSec = body.expiresIn ?? 3600;
-    this.tokenExpiresAt = Date.now() + (ttlSec - 60) * 1e3;
-    return this.token;
-  }
-  async get(path, init) {
-    return this.request("GET", path, init);
-  }
-  async post(path, body, init) {
-    const extra = { headers: { "Content-Type": "application/json", ...init?.headers ?? {} } };
-    if (body !== void 0) extra.body = JSON.stringify(body);
-    return this.request("POST", path, { ...init, ...extra });
-  }
-  async delete(path, body, init) {
-    const extra = { headers: { "Content-Type": "application/json", ...init?.headers ?? {} } };
-    if (body !== void 0) extra.body = JSON.stringify(body);
-    return this.request("DELETE", path, { ...init, ...extra });
-  }
-  async request(method, path, init) {
-    const retryCfg = this.config.retry;
-    const maxAttempts = retryCfg === false ? 1 : retryCfg.maxRetries + 1;
-    let lastErr;
-    for (let attempt = 0; attempt < maxAttempts; attempt++) {
-      try {
-        return await this.rawRequest(method, path, init);
-      } catch (err) {
-        lastErr = err;
-        if (attempt >= maxAttempts - 1) break;
-        if (!isRetryable(err)) break;
-        if (retryCfg === false) break;
-        let delay;
-        if (err instanceof RateLimitError) {
-          const retryAfterSec = err.details !== null && typeof err.details === "object" && "retryAfterSeconds" in err.details ? Number(err.details.retryAfterSeconds) : NaN;
-          delay = Number.isFinite(retryAfterSec) && retryAfterSec > 0 ? retryAfterSec * 1e3 : retryDelayMs(attempt, retryCfg.baseDelayMs, retryCfg.maxDelayMs);
-        } else {
-          delay = retryDelayMs(attempt, retryCfg.baseDelayMs, retryCfg.maxDelayMs);
-        }
-        await sleep(delay);
-      }
-    }
-    throw lastErr;
-  }
-  async rawRequest(method, path, init) {
-    const token = await this.getBearerToken();
-    const url = `${this.config.baseUrl}${path}`;
-    const headers = {
-      Authorization: `Bearer ${token}`,
-      "User-Agent": this.config.userAgent,
-      ...init?.headers ?? {}
-    };
-    this.config.onRequest?.({ method, url, headers });
-    const start = Date.now();
-    const res = await this.config.customFetch(url, {
-      method,
-      ...init,
-      headers,
-      signal: AbortSignal.timeout(this.config.timeoutMs)
-    });
-    this.config.onResponse?.({ status: res.status, url, durationMs: Date.now() - start });
-    if (!res.ok) {
-      const err = await buildError(res);
-      if (err instanceof RateLimitError) {
-        const retryAfter = res.headers.get("Retry-After");
-        if (retryAfter) {
-          err.details = typeof err.details === "object" && err.details !== null ? { ...err.details, retryAfterSeconds: Number(retryAfter) } : { retryAfterSeconds: Number(retryAfter) };
-        }
-      }
-      throw err;
-    }
-    if (res.status === 204 || res.headers.get("content-length") === "0") {
-      return void 0;
-    }
-    return res.json();
-  }
-};
-
-// src/auth.ts
-var AuthModule = class {
-  constructor(http, config) {
-    this.http = http;
-    this.config = config;
-  }
-  /**
-   * Explicitly request a new access token using client credentials.
-   * Normally you don't need to call this — the HTTP client handles token refresh automatically.
-   */
-  async getToken() {
-    if (this.config.auth.type !== "clientCredentials") {
-      throw new AuthenticationError("getToken() requires clientCredentials auth mode", 401);
-    }
-    const { clientKey, clientSecret } = this.config.auth;
-    const encoded = Buffer.from(`${clientKey}:${clientSecret}`).toString("base64");
-    const url = `${this.config.baseUrl}/auth/${this.config.version}/token`;
-    const res = await this.config.customFetch(url, {
-      method: "POST",
-      headers: {
-        "x-authorization": encoded,
-        "User-Agent": this.config.userAgent
-      },
-      signal: AbortSignal.timeout(this.config.timeoutMs)
-    });
-    if (!res.ok) {
-      const body = await res.json().catch(() => void 0);
-      throw new AuthenticationError(
-        body?.["message"] ?? `Auth failed: ${res.status}`,
-        res.status,
-        body
-      );
-    }
-    return res.json();
-  }
-  // ── Authorization Code Flow ───────────────────────────────────────────────
-  //
-  // Use this flow to let end-users authorise your app to act on their behalf
-  // (e.g. the "Connect DUPR" button). The user is redirected to DUPR's login
-  // page, then back to your redirectUri with an authorization code.
-  //
-  // NOTE: This requires a DUPR OAuth application with an authorization endpoint
-  // separate from the Partner API client credentials. Confirm the exact
-  // authorization URL with DUPR support.
-  //
-  // Typical flow:
-  //   1. client.auth.getAuthorizationUrl({ redirectUri, state }) → redirect user
-  //   2. User approves → DUPR calls back to redirectUri?code=xxx&state=yyy
-  //   3. client.auth.exchangeCode({ code, redirectUri }) → tokens
-  //   4. Store access_token + refresh_token; call client.setBearerToken(access_token)
-  //   5. When access_token expires: client.auth.refreshToken(refresh_token)
-  /**
-   * Build the DUPR authorization URL to redirect the user to for login.
-   * The `authorizationUrl` config option must be set (see above note).
-   */
-  getAuthorizationUrl(params) {
-    const authUrl = this.config.authorizationUrl;
-    if (!authUrl) {
-      throw new Error(
-        "authorizationUrl is not configured. Pass it in DuprClientOptions to use the Authorization Code flow."
-      );
-    }
-    const url = new URL(authUrl);
-    const clientId = this.config.auth.type === "clientCredentials" ? this.config.auth.clientKey : "";
-    url.searchParams.set("response_type", "code");
-    url.searchParams.set("client_id", clientId);
-    url.searchParams.set("redirect_uri", params.redirectUri);
-    if (params.scopes?.length) url.searchParams.set("scope", params.scopes.join(" "));
-    if (params.state) url.searchParams.set("state", params.state);
-    return url.toString();
-  }
-  /**
-   * Exchange an authorization code (from the OAuth callback) for access + refresh tokens.
-   * Uses `POST /auth/{version}/token` with `grant_type=authorization_code`.
-   */
-  async exchangeCode(params) {
-    if (this.config.auth.type !== "clientCredentials") {
-      throw new AuthenticationError("exchangeCode() requires clientCredentials auth configured with clientKey/clientSecret", 401);
-    }
-    const { clientKey, clientSecret } = this.config.auth;
-    const url = `${this.config.baseUrl}/auth/${this.config.version}/token`;
-    const body = new URLSearchParams({
-      grant_type: "authorization_code",
-      code: params.code,
-      redirect_uri: params.redirectUri,
-      client_id: clientKey,
-      client_secret: clientSecret
-    });
-    const res = await this.config.customFetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/x-www-form-urlencoded",
-        "User-Agent": this.config.userAgent
-      },
-      body: body.toString(),
-      signal: AbortSignal.timeout(this.config.timeoutMs)
-    });
-    if (!res.ok) {
-      const errBody = await res.json().catch(() => void 0);
-      throw new AuthenticationError(
-        errBody?.["message"] ?? `Code exchange failed: ${res.status}`,
-        res.status,
-        errBody
-      );
-    }
-    return res.json();
-  }
-  /**
-   * Obtain a new access token using a refresh token from a previous Authorization Code flow.
-   * Uses `POST /auth/{version}/token` with `grant_type=refresh_token`.
-   */
-  async refreshToken(refreshToken) {
-    if (this.config.auth.type !== "clientCredentials") {
-      throw new AuthenticationError("refreshToken() requires clientCredentials auth configured", 401);
-    }
-    const { clientKey, clientSecret } = this.config.auth;
-    const url = `${this.config.baseUrl}/auth/${this.config.version}/token`;
-    const body = new URLSearchParams({
-      grant_type: "refresh_token",
-      refresh_token: refreshToken,
-      client_id: clientKey,
-      client_secret: clientSecret
-    });
-    const res = await this.config.customFetch(url, {
-      method: "POST",
-      headers: {
-        "Content-Type": "application/x-www-form-urlencoded",
-        "User-Agent": this.config.userAgent
-      },
-      body: body.toString(),
-      signal: AbortSignal.timeout(this.config.timeoutMs)
-    });
-    if (!res.ok) {
-      const errBody = await res.json().catch(() => void 0);
-      throw new AuthenticationError(
-        errBody?.["message"] ?? `Token refresh failed: ${res.status}`,
-        res.status,
-        errBody
-      );
-    }
-    return res.json();
-  }
-};
-
-// src/resources/users.ts
-var UsersModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** GET /user/{version}/{id} — basic player profile */
-  getUser(duprId) {
-    return this.http.get(`/user/${this.cfg.version}/${duprId}`);
-  }
-  /** GET /user/{version}/{id}/details — extended profile (requires USER_EMAIL::VIEW permission) */
-  getExtendedUser(duprId) {
-    return this.http.get(`/user/${this.cfg.version}/${duprId}/details`);
-  }
-  /** GET /user/{version}/{id}/clubs — club memberships for a player */
-  getClubMemberships(duprId) {
-    return this.http.get(`/user/${this.cfg.version}/${duprId}/clubs`);
-  }
-  /** POST /user/{version}/search — full-text player search with optional filters */
-  search(req) {
-    return this.http.post(`/user/${this.cfg.version}/search`, req);
-  }
-  /** POST /user/{version}/batch — fetch multiple players by DUPR ID in one request */
-  getBatch(req) {
-    return this.http.post(`/user/${this.cfg.version}/batch`, req);
-  }
-  /** POST /user/{version}/invite — pre-generate a DUPR ID and send an invite email */
-  invite(req) {
-    return this.http.post(`/user/${this.cfg.version}/invite`, req);
-  }
-  /** POST /user/{version}/subscription/grants — grant a subscription to a user */
-  grantSubscription(req) {
-    return this.http.post(`/user/${this.cfg.version}/subscription/grants`, req);
-  }
-  // ── Provisional ratings ──────────────────────────────────────
-  /** POST /user/{version}/provisional_rating — get provisional ratings for a player */
-  getProvisionalRating(req) {
-    return this.http.post(`/user/${this.cfg.version}/provisional_rating`, req);
-  }
-  /** POST /user/{version}/provisional_rating/create */
-  createProvisionalRating(req) {
-    return this.http.post(`/user/${this.cfg.version}/provisional_rating/create`, req);
-  }
-  /** POST /user/{version}/provisional_rating/update */
-  updateProvisionalRating(req) {
-    return this.http.post(`/user/${this.cfg.version}/provisional_rating/update`, req);
-  }
-  /** DELETE /user/{version}/provisional_rating/delete */
-  deleteProvisionalRating(req) {
-    return this.http.delete(`/user/${this.cfg.version}/provisional_rating/delete`, req);
-  }
-};
-
-// src/resources/players.ts
-var PlayersModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** POST /{version}/player/duprid-by-email — resolve a DUPR ID from an email address */
-  getDuprIdByEmail(req) {
-    return this.http.post(`/${this.cfg.version}/player/duprid-by-email`, req);
-  }
-};
-
-// src/resources/playerRating.ts
-var PlayerRatingModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** POST /history — get rating history for a player */
-  getHistory(req) {
-    return this.http.post(`/history`, req);
-  }
-  /** GET /{version}/subscribe/rating-changes — list currently subscribed DUPR IDs */
-  getSubscriptions() {
-    return this.http.get(`/${this.cfg.version}/subscribe/rating-changes`);
-  }
-  /** POST /{version}/subscribe/rating-changes — subscribe to rating-change events for a list of players */
-  subscribe(req) {
-    return this.http.post(`/${this.cfg.version}/subscribe/rating-changes`, req);
-  }
-  /** DELETE /{version}/subscribe/rating-changes — unsubscribe from rating-change events */
-  unsubscribe(req) {
-    return this.http.delete(`/${this.cfg.version}/subscribe/rating-changes`, req);
-  }
-};
-
-// src/resources/matches.ts
-var MatchesModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** GET /match/{version}/{id} — view a single match */
-  get(matchId) {
-    return this.http.get(`/match/${this.cfg.version}/${matchId}`);
-  }
-  /** POST /match/{version}/create — submit a new match result */
-  create(match) {
-    return this.http.post(`/match/${this.cfg.version}/create`, match);
-  }
-  /** POST /match/{version}/batch — submit multiple match results in one call */
-  createBulk(matches) {
-    return this.http.post(`/match/${this.cfg.version}/batch`, matches);
-  }
-  /** POST /match/{version}/update — update an existing match */
-  update(req) {
-    return this.http.post(`/match/${this.cfg.version}/update`, req);
-  }
-  /** DELETE /match/{version}/delete — delete a match */
-  delete(req) {
-    return this.http.delete(`/match/${this.cfg.version}/delete`, req);
-  }
-  /** POST /match/{version}/annotate — attach vendor-specific metadata to a match */
-  annotate(req) {
-    return this.http.post(`/match/${this.cfg.version}/annotate`, req);
-  }
-  /** DELETE /match/{version}/annotate/{matchId} — remove a match annotation */
-  deleteAnnotation(matchId) {
-    return this.http.delete(`/match/${this.cfg.version}/annotate/${matchId}`);
-  }
-  /** POST /match/history/search — search a player's match history */
-  searchHistory(req) {
-    return this.http.post(`/match/history/search`, req);
-  }
-};
-
-// src/resources/clubs.ts
-var ClubsModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** POST /club/{version}/members — get ratings for all members of a club */
-  membersRating(req) {
-    return this.http.post(`/club/${this.cfg.version}/members`, req);
-  }
-  /** POST /club/{version}/match/search — search matches associated with a club */
-  searchMatches(req) {
-    return this.http.post(`/club/${this.cfg.version}/match/search`, req);
-  }
-};
-
-// src/resources/events.ts
-var EventsModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** POST /events/{version}/create */
-  create(req) {
-    return this.http.post(`/events/${this.cfg.version}/create`, req);
-  }
-  /** GET /events/{version}/get */
-  get(req) {
-    return this.http.post(`/events/${this.cfg.version}/get`, req);
-  }
-  /** POST /events/{version}/update */
-  update(req) {
-    return this.http.post(`/events/${this.cfg.version}/update`, req);
-  }
-  /** POST /events/{version}/delete */
-  delete(req) {
-    return this.http.post(`/events/${this.cfg.version}/delete`, req);
-  }
-};
-
-// src/resources/webhooks.ts
-var WebhooksModule = class {
-  constructor(http, cfg) {
-    this.http = http;
-    this.cfg = cfg;
-  }
-  /** POST /{version}/webhook — register a webhook endpoint */
-  register(req) {
-    return this.http.post(`/${this.cfg.version}/webhook`, req);
-  }
-  /** GET /{version}/topic — list all available webhook topics */
-  getTopics() {
-    return this.http.get(`/${this.cfg.version}/topic`);
-  }
-  /** GET /{version}/webhook/schema — list available webhook schemas */
-  listSchemas() {
-    return this.http.get(`/${this.cfg.version}/webhook/schema`);
-  }
-  /** GET /{version}/webhook/schema/{topic} — get the JSON schema for a specific topic */
-  getSchema(topic) {
-    return this.http.get(`/${this.cfg.version}/webhook/schema/${topic}`);
-  }
-  /** POST /user/{version}/subscribe/webhook-event — subscribe specific users to a webhook topic */
-  subscribeUsers(req) {
-    return this.http.post(`/user/${this.cfg.version}/subscribe/webhook-event`, req);
-  }
-  /** DELETE /user/{version}/subscribe/webhook-event — unsubscribe specific users from a webhook topic */
-  unsubscribeUsers(req) {
-    return this.http.delete(`/user/${this.cfg.version}/subscribe/webhook-event`, req);
-  }
-};
-
-// src/client.ts
-var DuprClient = class {
-  constructor(opts = {}) {
-    this.config = resolveConfig(opts);
-    const http = new HttpClient(this.config);
-    this.auth = new AuthModule(http, this.config);
-    this.users = new UsersModule(http, this.config);
-    this.players = new PlayersModule(http, this.config);
-    this.playerRating = new PlayerRatingModule(http, this.config);
-    this.matches = new MatchesModule(http, this.config);
-    this.clubs = new ClubsModule(http, this.config);
-    this.events = new EventsModule(http, this.config);
-    this.webhooks = new WebhooksModule(http, this.config);
-  }
-  /** Override the bearer token at runtime — useful when your backend handles auth separately. */
-  setBearerToken(token) {
-    this.config.overrideBearerToken = token;
-  }
-  /** Clear the runtime bearer token override and fall back to configured auth. */
-  clearBearerToken() {
-    delete this.config.overrideBearerToken;
-  }
-};
-
-exports.AuthModule = AuthModule;
-exports.AuthenticationError = AuthenticationError;
-exports.ClubsModule = ClubsModule;
-exports.DuprApiError = DuprApiError;
-exports.DuprClient = DuprClient;
-exports.EventsModule = EventsModule;
-exports.MatchesModule = MatchesModule;
-exports.NotFoundError = NotFoundError;
-exports.PlayerRatingModule = PlayerRatingModule;
-exports.PlayersModule = PlayersModule;
-exports.RateLimitError = RateLimitError;
-exports.ServerError = ServerError;
-exports.UsersModule = UsersModule;
-exports.ValidationError = ValidationError;
-exports.WebhooksModule = WebhooksModule;
-//# sourceMappingURL=index.cjs.map
-//# sourceMappingURL=index.cjs.map