@dubsdotapp/node 0.1.1 → 0.2.0

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/client.ts","../src/constants.ts","../src/errors.ts"],"sourcesContent":["import crypto from 'crypto';\nimport { DEFAULT_BASE_URL, NETWORK_CONFIG } from './constants';\nimport { DubsApiError } from './errors';\nimport type { DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';\n\nexport class Dubs {\n  private readonly apiKey: string;\n  private readonly resolutionSecret?: string;\n  private readonly baseUrl: string;\n\n  constructor(config: DubsConfig) {\n    this.apiKey = config.apiKey;\n    this.resolutionSecret = config.resolutionSecret;\n\n    if (config.baseUrl) {\n      this.baseUrl = config.baseUrl;\n    } else if (config.network) {\n      this.baseUrl = NETWORK_CONFIG[config.network].baseUrl;\n    } else {\n      this.baseUrl = DEFAULT_BASE_URL;\n    }\n  }\n\n  /**\n   * Resolve a custom game (game_mode=6).\n   *\n   * Automatically computes the HMAC-SHA256 signature using your resolution secret.\n   */\n  async resolveGame(gameId: string, params: ResolveGameParams): Promise<ResolveGameResult> {\n    if (!this.resolutionSecret) {\n      throw new DubsApiError(\n        'missing_resolution_secret',\n        'resolutionSecret is required for resolveGame(). Pass it in the Dubs constructor.',\n        0,\n      );\n    }\n\n    const body = JSON.stringify({\n      winner: params.winner,\n      ...(params.metadata && { metadata: params.metadata }),\n    });\n\n    const hmac = crypto.createHmac('sha256', this.resolutionSecret).update(body).digest('hex');\n\n    return this.request<ResolveGameResult>('POST', `/games/${gameId}/resolve`, body, {\n      'x-dubs-signature': `sha256=${hmac}`,\n    });\n  }\n\n  /**\n   * Verify an incoming Dubs webhook request.\n   *\n   * @param rawBody  - The raw request body (string or Buffer)\n   * @param signature - The X-Dubs-Signature header value\n   * @param secret   - Your webhook secret (from the developer portal)\n   * @returns The parsed webhook event\n   * @throws DubsApiError if the signature is invalid\n   */\n  static verifyWebhook(rawBody: string | Buffer, signature: string, secret: string): WebhookEvent {\n    const body = typeof rawBody === 'string' ? rawBody : rawBody.toString('utf-8');\n    const expected = crypto.createHmac('sha256', secret).update(body).digest('hex');\n\n    if (\n      signature.length !== expected.length ||\n      !crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))\n    ) {\n      throw new DubsApiError('invalid_signature', 'Webhook signature verification failed', 401);\n    }\n\n    return JSON.parse(body) as WebhookEvent;\n  }\n\n  // ── Private ──\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: string,\n    extraHeaders?: Record<string, string>,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      'x-api-key': this.apiKey,\n      'Content-Type': 'application/json',\n      ...extraHeaders,\n    };\n\n    const res = await fetch(url, {\n      method,\n      headers,\n      ...(body && { body }),\n    });\n\n    const json = (await res.json()) as Record<string, unknown>;\n\n    if (!res.ok) {\n      const msg = typeof json.message === 'string' ? json.message\n        : typeof json.error === 'string' ? json.error\n        : `Request failed with status ${res.status}: ${JSON.stringify(json)}`;\n      throw new DubsApiError(\n        (json.code as string) || 'api_error',\n        msg,\n        res.status,\n      );\n    }\n\n    return json as T;\n  }\n}\n","export const DEFAULT_BASE_URL = 'https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1';\n\nexport type DubsNetwork = 'devnet' | 'mainnet-beta';\n\nexport const NETWORK_CONFIG: Record<DubsNetwork, { baseUrl: string }> = {\n  'mainnet-beta': {\n    baseUrl: 'https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1',\n  },\n  devnet: {\n    baseUrl: 'https://dubs-server-dev-55d1fba09a97.herokuapp.com/api/developer/v1',\n  },\n};\n","export class DubsApiError extends Error {\n  public readonly code: string;\n  public readonly httpStatus: number;\n\n  constructor(code: string, message: string, httpStatus: number) {\n    super(message);\n    this.name = 'DubsApiError';\n    this.code = code;\n    this.httpStatus = httpStatus;\n  }\n}\n"],"mappings":";AAAA,OAAO,YAAY;;;ACAZ,IAAM,mBAAmB;AAIzB,IAAM,iBAA2D;AAAA,EACtE,gBAAgB;AAAA,IACd,SAAS;AAAA,EACX;AAAA,EACA,QAAQ;AAAA,IACN,SAAS;AAAA,EACX;AACF;;;ACXO,IAAM,eAAN,cAA2B,MAAM;AAAA,EACtB;AAAA,EACA;AAAA,EAEhB,YAAY,MAAc,SAAiB,YAAoB;AAC7D,UAAM,OAAO;AACb,SAAK,OAAO;AACZ,SAAK,OAAO;AACZ,SAAK,aAAa;AAAA,EACpB;AACF;;;AFLO,IAAM,OAAN,MAAW;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EAEjB,YAAY,QAAoB;AAC9B,SAAK,SAAS,OAAO;AACrB,SAAK,mBAAmB,OAAO;AAE/B,QAAI,OAAO,SAAS;AAClB,WAAK,UAAU,OAAO;AAAA,IACxB,WAAW,OAAO,SAAS;AACzB,WAAK,UAAU,eAAe,OAAO,OAAO,EAAE;AAAA,IAChD,OAAO;AACL,WAAK,UAAU;AAAA,IACjB;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOA,MAAM,YAAY,QAAgB,QAAuD;AACvF,QAAI,CAAC,KAAK,kBAAkB;AAC1B,YAAM,IAAI;AAAA,QACR;AAAA,QACA;AAAA,QACA;AAAA,MACF;AAAA,IACF;AAEA,UAAM,OAAO,KAAK,UAAU;AAAA,MAC1B,QAAQ,OAAO;AAAA,MACf,GAAI,OAAO,YAAY,EAAE,UAAU,OAAO,SAAS;AAAA,IACrD,CAAC;AAED,UAAM,OAAO,OAAO,WAAW,UAAU,KAAK,gBAAgB,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AAEzF,WAAO,KAAK,QAA2B,QAAQ,UAAU,MAAM,YAAY,MAAM;AAAA,MAC/E,oBAAoB,UAAU,IAAI;AAAA,IACpC,CAAC;AAAA,EACH;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAWA,OAAO,cAAc,SAA0B,WAAmB,QAA8B;AAC9F,UAAM,OAAO,OAAO,YAAY,WAAW,UAAU,QAAQ,SAAS,OAAO;AAC7E,UAAM,WAAW,OAAO,WAAW,UAAU,MAAM,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AAE9E,QACE,UAAU,WAAW,SAAS,UAC9B,CAAC,OAAO,gBAAgB,OAAO,KAAK,SAAS,GAAG,OAAO,KAAK,QAAQ,CAAC,GACrE;AACA,YAAM,IAAI,aAAa,qBAAqB,yCAAyC,GAAG;AAAA,IAC1F;AAEA,WAAO,KAAK,MAAM,IAAI;AAAA,EACxB;AAAA;AAAA,EAIA,MAAc,QACZ,QACA,MACA,MACA,cACY;AACZ,UAAM,MAAM,GAAG,KAAK,OAAO,GAAG,IAAI;AAElC,UAAM,UAAkC;AAAA,MACtC,aAAa,KAAK;AAAA,MAClB,gBAAgB;AAAA,MAChB,GAAG;AAAA,IACL;AAEA,UAAM,MAAM,MAAM,MAAM,KAAK;AAAA,MAC3B;AAAA,MACA;AAAA,MACA,GAAI,QAAQ,EAAE,KAAK;AAAA,IACrB,CAAC;AAED,UAAM,OAAQ,MAAM,IAAI,KAAK;AAE7B,QAAI,CAAC,IAAI,IAAI;AACX,YAAM,MAAM,OAAO,KAAK,YAAY,WAAW,KAAK,UAChD,OAAO,KAAK,UAAU,WAAW,KAAK,QACtC,8BAA8B,IAAI,MAAM,KAAK,KAAK,UAAU,IAAI,CAAC;AACrE,YAAM,IAAI;AAAA,QACP,KAAK,QAAmB;AAAA,QACzB;AAAA,QACA,IAAI;AAAA,MACN;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}
+{"version":3,"sources":["../src/client.ts","../src/constants.ts","../src/errors.ts","../src/resources/base.ts","../src/resources/auth.ts","../src/resources/users.ts","../src/resources/events.ts","../src/resources/games.ts","../src/resources/transactions.ts"],"sourcesContent":["import crypto from 'crypto';\nimport { DEFAULT_BASE_URL, NETWORK_CONFIG } from './constants';\nimport { DubsApiError } from './errors';\nimport {\n  AuthResource,\n  EventsResource,\n  GamesResource,\n  TransactionsResource,\n  UsersResource,\n} from './resources';\nimport type { AppConfigResponse, DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';\n\nexport class Dubs {\n  private readonly apiKey: string;\n  private readonly resolutionSecret?: string;\n  private readonly baseUrl: string;\n\n  readonly auth: AuthResource;\n  readonly users: UsersResource;\n  readonly events: EventsResource;\n  readonly games: GamesResource;\n  readonly transactions: TransactionsResource;\n\n  constructor(config: DubsConfig) {\n    this.apiKey = config.apiKey;\n    this.resolutionSecret = config.resolutionSecret;\n\n    if (config.baseUrl) {\n      this.baseUrl = config.baseUrl;\n    } else if (config.network) {\n      this.baseUrl = NETWORK_CONFIG[config.network].baseUrl;\n    } else {\n      this.baseUrl = DEFAULT_BASE_URL;\n    }\n\n    const boundRequest = this.request.bind(this);\n    this.auth = new AuthResource(boundRequest);\n    this.users = new UsersResource(boundRequest);\n    this.events = new EventsResource(boundRequest);\n    this.games = new GamesResource(boundRequest);\n    this.transactions = new TransactionsResource(boundRequest);\n  }\n\n  /**\n   * Fetch the platform configuration.\n   */\n  async config(): Promise<AppConfigResponse> {\n    return this.request<AppConfigResponse>('GET', '/config');\n  }\n\n  /**\n   * Resolve a custom game (game_mode=6).\n   *\n   * Automatically computes the HMAC-SHA256 signature using your resolution secret.\n   */\n  async resolveGame(gameId: string, params: ResolveGameParams): Promise<ResolveGameResult> {\n    if (!this.resolutionSecret) {\n      throw new DubsApiError(\n        'missing_resolution_secret',\n        'resolutionSecret is required for resolveGame(). Pass it in the Dubs constructor.',\n        0,\n      );\n    }\n\n    const body = JSON.stringify({\n      winner: params.winner,\n      ...(params.metadata && { metadata: params.metadata }),\n    });\n\n    const hmac = crypto.createHmac('sha256', this.resolutionSecret).update(body).digest('hex');\n\n    return this.request<ResolveGameResult>('POST', `/games/${gameId}/resolve`, body, {\n      'x-dubs-signature': `sha256=${hmac}`,\n    });\n  }\n\n  /**\n   * Verify an incoming Dubs webhook request.\n   *\n   * @param rawBody  - The raw request body (string or Buffer)\n   * @param signature - The X-Dubs-Signature header value\n   * @param secret   - Your webhook secret (from the developer portal)\n   * @returns The parsed webhook event\n   * @throws DubsApiError if the signature is invalid\n   */\n  static verifyWebhook(rawBody: string | Buffer, signature: string, secret: string): WebhookEvent {\n    const body = typeof rawBody === 'string' ? rawBody : rawBody.toString('utf-8');\n    const expected = crypto.createHmac('sha256', secret).update(body).digest('hex');\n\n    if (\n      signature.length !== expected.length ||\n      !crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))\n    ) {\n      throw new DubsApiError('invalid_signature', 'Webhook signature verification failed', 401);\n    }\n\n    return JSON.parse(body) as WebhookEvent;\n  }\n\n  // ── Private ──\n\n  private async request<T>(\n    method: string,\n    path: string,\n    body?: string,\n    extraHeaders?: Record<string, string>,\n  ): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      'x-api-key': this.apiKey,\n      'Content-Type': 'application/json',\n      ...extraHeaders,\n    };\n\n    const res = await fetch(url, {\n      method,\n      headers,\n      ...(body && { body }),\n    });\n\n    const json = (await res.json()) as Record<string, unknown>;\n\n    if (!res.ok) {\n      const msg = typeof json.message === 'string' ? json.message\n        : typeof json.error === 'string' ? json.error\n        : `Request failed with status ${res.status}: ${JSON.stringify(json)}`;\n      throw new DubsApiError(\n        (json.code as string) || 'api_error',\n        msg,\n        res.status,\n      );\n    }\n\n    return json as T;\n  }\n}\n","export const DEFAULT_BASE_URL = 'https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1';\n\nexport type DubsNetwork = 'devnet' | 'mainnet-beta';\n\nexport const NETWORK_CONFIG: Record<DubsNetwork, { baseUrl: string }> = {\n  'mainnet-beta': {\n    baseUrl: 'https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1',\n  },\n  devnet: {\n    baseUrl: 'https://dubs-server-dev-55d1fba09a97.herokuapp.com/api/developer/v1',\n  },\n};\n","export class DubsApiError extends Error {\n  public readonly code: string;\n  public readonly httpStatus: number;\n\n  constructor(code: string, message: string, httpStatus: number) {\n    super(message);\n    this.name = 'DubsApiError';\n    this.code = code;\n    this.httpStatus = httpStatus;\n  }\n}\n","export type RequestFn = <T>(\n  method: string,\n  path: string,\n  body?: string,\n  extraHeaders?: Record<string, string>,\n) => Promise<T>;\n\nexport class BaseResource {\n  protected request: RequestFn;\n\n  constructor(request: RequestFn) {\n    this.request = request;\n  }\n}\n","import { BaseResource } from './base';\nimport type {\n  AuthenticateParams,\n  AuthenticateResponse,\n  CheckUsernameResponse,\n  MeResponse,\n  NonceResponse,\n  RegisterParams,\n  RegisterResponse,\n} from '../types';\n\nexport class AuthResource extends BaseResource {\n  async getNonce(walletAddress: string): Promise<NonceResponse> {\n    return this.request<NonceResponse>('GET', `/auth/nonce?walletAddress=${encodeURIComponent(walletAddress)}`);\n  }\n\n  async authenticate(params: AuthenticateParams): Promise<AuthenticateResponse> {\n    return this.request<AuthenticateResponse>('POST', '/auth/authenticate', JSON.stringify(params));\n  }\n\n  async register(params: RegisterParams): Promise<RegisterResponse> {\n    return this.request<RegisterResponse>('POST', '/auth/register', JSON.stringify(params));\n  }\n\n  async me(userToken: string): Promise<MeResponse> {\n    return this.request<MeResponse>('GET', '/auth/me', undefined, {\n      Authorization: `Bearer ${userToken}`,\n    });\n  }\n\n  async logout(userToken: string): Promise<void> {\n    await this.request<Record<string, unknown>>('POST', '/auth/logout', undefined, {\n      Authorization: `Bearer ${userToken}`,\n    });\n  }\n\n  async checkUsername(username: string): Promise<CheckUsernameResponse> {\n    return this.request<CheckUsernameResponse>('GET', `/auth/check-username?username=${encodeURIComponent(username)}`);\n  }\n}\n","import { BaseResource } from './base';\nimport type { UserResponse, UsersListParams, UsersListResponse } from '../types';\n\nexport class UsersResource extends BaseResource {\n  async get(walletAddress: string): Promise<UserResponse> {\n    return this.request<UserResponse>('GET', `/users/${encodeURIComponent(walletAddress)}`);\n  }\n\n  async list(params?: UsersListParams): Promise<UsersListResponse> {\n    const query = new URLSearchParams();\n    if (params?.limit != null) query.set('limit', String(params.limit));\n    if (params?.offset != null) query.set('offset', String(params.offset));\n    const qs = query.toString();\n    return this.request<UsersListResponse>('GET', `/users${qs ? `?${qs}` : ''}`);\n  }\n}\n","import { BaseResource } from './base';\nimport type {\n  EsportsMatchResponse,\n  EsportsParams,\n  EventsResponse,\n  UpcomingEventsParams,\n} from '../types';\n\nexport class EventsResource extends BaseResource {\n  async upcoming(params?: UpcomingEventsParams): Promise<EventsResponse> {\n    const query = new URLSearchParams();\n    if (params?.type) query.set('type', params.type);\n    if (params?.page != null) query.set('page', String(params.page));\n    if (params?.limit != null) query.set('limit', String(params.limit));\n    const qs = query.toString();\n    return this.request<EventsResponse>('GET', `/events/upcoming${qs ? `?${qs}` : ''}`);\n  }\n\n  async sports(league: string): Promise<EventsResponse> {\n    return this.request<EventsResponse>('GET', `/events/sports/${encodeURIComponent(league)}`);\n  }\n\n  async esports(params?: EsportsParams): Promise<EventsResponse> {\n    const query = new URLSearchParams();\n    if (params?.videogame) query.set('videogame', params.videogame);\n    if (params?.page != null) query.set('page', String(params.page));\n    if (params?.limit != null) query.set('limit', String(params.limit));\n    const qs = query.toString();\n    return this.request<EventsResponse>('GET', `/events/esports${qs ? `?${qs}` : ''}`);\n  }\n\n  async esportsMatch(matchId: string): Promise<EsportsMatchResponse> {\n    return this.request<EsportsMatchResponse>('GET', `/events/esports/match/${encodeURIComponent(matchId)}`);\n  }\n}\n","import { BaseResource } from './base';\nimport type {\n  CustomGameConfirmParams,\n  CustomGameConfirmResponse,\n  CustomGameCreateParams,\n  CustomGameCreateResponse,\n  Game,\n  GameConfirmParams,\n  GameConfirmResponse,\n  GameCreateParams,\n  GameCreateResponse,\n  GameJoinParams,\n  GameJoinResponse,\n  GameListParams,\n  GameListResponse,\n  LiveScoreResponse,\n  NetworkGamesParams,\n  NetworkGamesResponse,\n  ValidateResponse,\n} from '../types';\n\nexport class GamesResource extends BaseResource {\n  async validate(eventId: string): Promise<ValidateResponse> {\n    return this.request<ValidateResponse>('GET', `/games/validate?eventId=${encodeURIComponent(eventId)}`);\n  }\n\n  async create(params: GameCreateParams): Promise<GameCreateResponse> {\n    return this.request<GameCreateResponse>('POST', '/games/create', JSON.stringify(params));\n  }\n\n  async join(params: GameJoinParams): Promise<GameJoinResponse> {\n    return this.request<GameJoinResponse>('POST', '/games/join', JSON.stringify(params));\n  }\n\n  async confirm(params: GameConfirmParams): Promise<GameConfirmResponse> {\n    return this.request<GameConfirmResponse>('POST', '/games/confirm', JSON.stringify(params));\n  }\n\n  async get(gameId: string): Promise<{ game: Game }> {\n    return this.request<{ game: Game }>('GET', `/games/${encodeURIComponent(gameId)}`);\n  }\n\n  async list(params?: GameListParams): Promise<GameListResponse> {\n    const query = new URLSearchParams();\n    if (params?.status) query.set('status', params.status);\n    if (params?.limit != null) query.set('limit', String(params.limit));\n    if (params?.offset != null) query.set('offset', String(params.offset));\n    const qs = query.toString();\n    return this.request<GameListResponse>('GET', `/games${qs ? `?${qs}` : ''}`);\n  }\n\n  async network(params?: NetworkGamesParams): Promise<NetworkGamesResponse> {\n    const query = new URLSearchParams();\n    if (params?.limit != null) query.set('limit', String(params.limit));\n    if (params?.offset != null) query.set('offset', String(params.offset));\n    const qs = query.toString();\n    return this.request<NetworkGamesResponse>('GET', `/games/network${qs ? `?${qs}` : ''}`);\n  }\n\n  async liveScore(gameId: string): Promise<LiveScoreResponse> {\n    return this.request<LiveScoreResponse>('GET', `/games/${encodeURIComponent(gameId)}/live-score`);\n  }\n\n  async customCreate(params: CustomGameCreateParams): Promise<CustomGameCreateResponse> {\n    return this.request<CustomGameCreateResponse>('POST', '/games/custom/create', JSON.stringify(params));\n  }\n\n  async customConfirm(params: CustomGameConfirmParams): Promise<CustomGameConfirmResponse> {\n    return this.request<CustomGameConfirmResponse>('POST', '/games/custom/confirm', JSON.stringify(params));\n  }\n}\n","import { BaseResource } from './base';\nimport type { BuildClaimParams, BuildClaimResponse } from '../types';\n\nexport class TransactionsResource extends BaseResource {\n  async buildClaim(params: BuildClaimParams): Promise<BuildClaimResponse> {\n    return this.request<BuildClaimResponse>('POST', '/transactions/build-claim', JSON.stringify(params));\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dubsdotapp/node",
-  "version": "0.1.1",
+  "version": "0.2.0",
   "description": "Server-side Node.js SDK for the Dubs betting platform",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",

package/src/client.ts

@@ -1,13 +1,26 @@
 import crypto from 'crypto';
 import { DEFAULT_BASE_URL, NETWORK_CONFIG } from './constants';
 import { DubsApiError } from './errors';
-import type { DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';
+import {
+  AuthResource,
+  EventsResource,
+  GamesResource,
+  TransactionsResource,
+  UsersResource,
+} from './resources';
+import type { AppConfigResponse, DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';
 
 export class Dubs {
   private readonly apiKey: string;
   private readonly resolutionSecret?: string;
   private readonly baseUrl: string;
 
+  readonly auth: AuthResource;
+  readonly users: UsersResource;
+  readonly events: EventsResource;
+  readonly games: GamesResource;
+  readonly transactions: TransactionsResource;
+
   constructor(config: DubsConfig) {
     this.apiKey = config.apiKey;
     this.resolutionSecret = config.resolutionSecret;
@@ -19,6 +32,20 @@ export class Dubs {
     } else {
       this.baseUrl = DEFAULT_BASE_URL;
     }
+
+    const boundRequest = this.request.bind(this);
+    this.auth = new AuthResource(boundRequest);
+    this.users = new UsersResource(boundRequest);
+    this.events = new EventsResource(boundRequest);
+    this.games = new GamesResource(boundRequest);
+    this.transactions = new TransactionsResource(boundRequest);
+  }
+
+  /**
+   * Fetch the platform configuration.
+   */
+  async config(): Promise<AppConfigResponse> {
+    return this.request<AppConfigResponse>('GET', '/config');
   }
 
   /**

package/src/index.ts

@@ -3,3 +3,59 @@ export { DubsApiError } from './errors';
 export type { DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';
 export { DEFAULT_BASE_URL, NETWORK_CONFIG } from './constants';
 export type { DubsNetwork } from './constants';
+
+// Resource classes
+export { AuthResource, UsersResource, EventsResource, GamesResource, TransactionsResource } from './resources';
+export type { RequestFn } from './resources';
+
+// Auth types
+export type {
+  NonceParams,
+  NonceResponse,
+  AuthenticateParams,
+  AuthenticateResponse,
+  RegisterParams,
+  RegisterResponse,
+  MeResponse,
+  CheckUsernameResponse,
+} from './types';
+
+// Users types
+export type { User, UserResponse, UsersListParams, UsersListResponse } from './types';
+
+// Events types
+export type {
+  Event,
+  UpcomingEventsParams,
+  EventsResponse,
+  EsportsParams,
+  EsportsMatchResponse,
+} from './types';
+
+// Games types
+export type {
+  Game,
+  ValidateParams,
+  ValidateResponse,
+  GameCreateParams,
+  GameCreateResponse,
+  GameJoinParams,
+  GameJoinResponse,
+  GameConfirmParams,
+  GameConfirmResponse,
+  GameListParams,
+  GameListResponse,
+  NetworkGamesParams,
+  NetworkGamesResponse,
+  LiveScoreResponse,
+  CustomGameCreateParams,
+  CustomGameCreateResponse,
+  CustomGameConfirmParams,
+  CustomGameConfirmResponse,
+} from './types';
+
+// Transactions types
+export type { BuildClaimParams, BuildClaimResponse } from './types';
+
+// Config types
+export type { AppConfigResponse } from './types';

package/src/resources/auth.ts

@@ -0,0 +1,40 @@
+import { BaseResource } from './base';
+import type {
+  AuthenticateParams,
+  AuthenticateResponse,
+  CheckUsernameResponse,
+  MeResponse,
+  NonceResponse,
+  RegisterParams,
+  RegisterResponse,
+} from '../types';
+
+export class AuthResource extends BaseResource {
+  async getNonce(walletAddress: string): Promise<NonceResponse> {
+    return this.request<NonceResponse>('GET', `/auth/nonce?walletAddress=${encodeURIComponent(walletAddress)}`);
+  }
+
+  async authenticate(params: AuthenticateParams): Promise<AuthenticateResponse> {
+    return this.request<AuthenticateResponse>('POST', '/auth/authenticate', JSON.stringify(params));
+  }
+
+  async register(params: RegisterParams): Promise<RegisterResponse> {
+    return this.request<RegisterResponse>('POST', '/auth/register', JSON.stringify(params));
+  }
+
+  async me(userToken: string): Promise<MeResponse> {
+    return this.request<MeResponse>('GET', '/auth/me', undefined, {
+      Authorization: `Bearer ${userToken}`,
+    });
+  }
+
+  async logout(userToken: string): Promise<void> {
+    await this.request<Record<string, unknown>>('POST', '/auth/logout', undefined, {
+      Authorization: `Bearer ${userToken}`,
+    });
+  }
+
+  async checkUsername(username: string): Promise<CheckUsernameResponse> {
+    return this.request<CheckUsernameResponse>('GET', `/auth/check-username?username=${encodeURIComponent(username)}`);
+  }
+}

package/src/resources/base.ts

@@ -0,0 +1,14 @@
+export type RequestFn = <T>(
+  method: string,
+  path: string,
+  body?: string,
+  extraHeaders?: Record<string, string>,
+) => Promise<T>;
+
+export class BaseResource {
+  protected request: RequestFn;
+
+  constructor(request: RequestFn) {
+    this.request = request;
+  }
+}

package/src/resources/events.ts

@@ -0,0 +1,35 @@
+import { BaseResource } from './base';
+import type {
+  EsportsMatchResponse,
+  EsportsParams,
+  EventsResponse,
+  UpcomingEventsParams,
+} from '../types';
+
+export class EventsResource extends BaseResource {
+  async upcoming(params?: UpcomingEventsParams): Promise<EventsResponse> {
+    const query = new URLSearchParams();
+    if (params?.type) query.set('type', params.type);
+    if (params?.page != null) query.set('page', String(params.page));
+    if (params?.limit != null) query.set('limit', String(params.limit));
+    const qs = query.toString();
+    return this.request<EventsResponse>('GET', `/events/upcoming${qs ? `?${qs}` : ''}`);
+  }
+
+  async sports(league: string): Promise<EventsResponse> {
+    return this.request<EventsResponse>('GET', `/events/sports/${encodeURIComponent(league)}`);
+  }
+
+  async esports(params?: EsportsParams): Promise<EventsResponse> {
+    const query = new URLSearchParams();
+    if (params?.videogame) query.set('videogame', params.videogame);
+    if (params?.page != null) query.set('page', String(params.page));
+    if (params?.limit != null) query.set('limit', String(params.limit));
+    const qs = query.toString();
+    return this.request<EventsResponse>('GET', `/events/esports${qs ? `?${qs}` : ''}`);
+  }
+
+  async esportsMatch(matchId: string): Promise<EsportsMatchResponse> {
+    return this.request<EsportsMatchResponse>('GET', `/events/esports/match/${encodeURIComponent(matchId)}`);
+  }
+}

package/src/resources/games.ts

@@ -0,0 +1,71 @@
+import { BaseResource } from './base';
+import type {
+  CustomGameConfirmParams,
+  CustomGameConfirmResponse,
+  CustomGameCreateParams,
+  CustomGameCreateResponse,
+  Game,
+  GameConfirmParams,
+  GameConfirmResponse,
+  GameCreateParams,
+  GameCreateResponse,
+  GameJoinParams,
+  GameJoinResponse,
+  GameListParams,
+  GameListResponse,
+  LiveScoreResponse,
+  NetworkGamesParams,
+  NetworkGamesResponse,
+  ValidateResponse,
+} from '../types';
+
+export class GamesResource extends BaseResource {
+  async validate(eventId: string): Promise<ValidateResponse> {
+    return this.request<ValidateResponse>('GET', `/games/validate?eventId=${encodeURIComponent(eventId)}`);
+  }
+
+  async create(params: GameCreateParams): Promise<GameCreateResponse> {
+    return this.request<GameCreateResponse>('POST', '/games/create', JSON.stringify(params));
+  }
+
+  async join(params: GameJoinParams): Promise<GameJoinResponse> {
+    return this.request<GameJoinResponse>('POST', '/games/join', JSON.stringify(params));
+  }
+
+  async confirm(params: GameConfirmParams): Promise<GameConfirmResponse> {
+    return this.request<GameConfirmResponse>('POST', '/games/confirm', JSON.stringify(params));
+  }
+
+  async get(gameId: string): Promise<{ game: Game }> {
+    return this.request<{ game: Game }>('GET', `/games/${encodeURIComponent(gameId)}`);
+  }
+
+  async list(params?: GameListParams): Promise<GameListResponse> {
+    const query = new URLSearchParams();
+    if (params?.status) query.set('status', params.status);
+    if (params?.limit != null) query.set('limit', String(params.limit));
+    if (params?.offset != null) query.set('offset', String(params.offset));
+    const qs = query.toString();
+    return this.request<GameListResponse>('GET', `/games${qs ? `?${qs}` : ''}`);
+  }
+
+  async network(params?: NetworkGamesParams): Promise<NetworkGamesResponse> {
+    const query = new URLSearchParams();
+    if (params?.limit != null) query.set('limit', String(params.limit));
+    if (params?.offset != null) query.set('offset', String(params.offset));
+    const qs = query.toString();
+    return this.request<NetworkGamesResponse>('GET', `/games/network${qs ? `?${qs}` : ''}`);
+  }
+
+  async liveScore(gameId: string): Promise<LiveScoreResponse> {
+    return this.request<LiveScoreResponse>('GET', `/games/${encodeURIComponent(gameId)}/live-score`);
+  }
+
+  async customCreate(params: CustomGameCreateParams): Promise<CustomGameCreateResponse> {
+    return this.request<CustomGameCreateResponse>('POST', '/games/custom/create', JSON.stringify(params));
+  }
+
+  async customConfirm(params: CustomGameConfirmParams): Promise<CustomGameConfirmResponse> {
+    return this.request<CustomGameConfirmResponse>('POST', '/games/custom/confirm', JSON.stringify(params));
+  }
+}

package/src/resources/index.ts

@@ -0,0 +1,7 @@
+export { BaseResource } from './base';
+export type { RequestFn } from './base';
+export { AuthResource } from './auth';
+export { UsersResource } from './users';
+export { EventsResource } from './events';
+export { GamesResource } from './games';
+export { TransactionsResource } from './transactions';

package/src/resources/transactions.ts

@@ -0,0 +1,8 @@
+import { BaseResource } from './base';
+import type { BuildClaimParams, BuildClaimResponse } from '../types';
+
+export class TransactionsResource extends BaseResource {
+  async buildClaim(params: BuildClaimParams): Promise<BuildClaimResponse> {
+    return this.request<BuildClaimResponse>('POST', '/transactions/build-claim', JSON.stringify(params));
+  }
+}

package/src/resources/users.ts

@@ -0,0 +1,16 @@
+import { BaseResource } from './base';
+import type { UserResponse, UsersListParams, UsersListResponse } from '../types';
+
+export class UsersResource extends BaseResource {
+  async get(walletAddress: string): Promise<UserResponse> {
+    return this.request<UserResponse>('GET', `/users/${encodeURIComponent(walletAddress)}`);
+  }
+
+  async list(params?: UsersListParams): Promise<UsersListResponse> {
+    const query = new URLSearchParams();
+    if (params?.limit != null) query.set('limit', String(params.limit));
+    if (params?.offset != null) query.set('offset', String(params.offset));
+    const qs = query.toString();
+    return this.request<UsersListResponse>('GET', `/users${qs ? `?${qs}` : ''}`);
+  }
+}

package/src/types.ts

@@ -35,3 +35,234 @@ export interface WebhookEvent {
   timestamp: string;
   data: Record<string, unknown>;
 }
+
+// ── Shared shapes ──
+
+export interface User {
+  walletAddress: string;
+  username: string;
+  avatar?: string;
+  createdAt: string;
+  updatedAt: string;
+  [key: string]: unknown;
+}
+
+export interface Game {
+  id: string;
+  status: string;
+  gameMode: number;
+  eventId?: string;
+  wagerAmount: number;
+  players: Record<string, unknown>[];
+  winner?: string | null;
+  createdAt: string;
+  updatedAt: string;
+  [key: string]: unknown;
+}
+
+export interface Event {
+  id: string;
+  name: string;
+  type: string;
+  league?: string;
+  startTime: string;
+  status: string;
+  teams: { home: string; away: string };
+  [key: string]: unknown;
+}
+
+// ── Auth types ──
+
+export interface NonceParams {
+  walletAddress: string;
+}
+
+export interface NonceResponse {
+  nonce: string;
+}
+
+export interface AuthenticateParams {
+  walletAddress: string;
+  signature: string;
+  nonce: string;
+}
+
+export interface AuthenticateResponse {
+  token: string;
+  user: User;
+}
+
+export interface RegisterParams {
+  walletAddress: string;
+  signature: string;
+  nonce: string;
+  username: string;
+}
+
+export interface RegisterResponse {
+  token: string;
+  user: User;
+}
+
+export interface MeResponse {
+  user: User;
+}
+
+export interface CheckUsernameResponse {
+  available: boolean;
+  username: string;
+}
+
+// ── Users types ──
+
+export interface UserResponse {
+  user: User;
+}
+
+export interface UsersListParams {
+  limit?: number;
+  offset?: number;
+}
+
+export interface UsersListResponse {
+  users: User[];
+  total: number;
+}
+
+// ── Events types ──
+
+export interface UpcomingEventsParams {
+  type?: string;
+  page?: number;
+  limit?: number;
+}
+
+export interface EventsResponse {
+  events: Event[];
+  total?: number;
+}
+
+export interface EsportsParams {
+  videogame?: string;
+  page?: number;
+  limit?: number;
+}
+
+export interface EsportsMatchResponse {
+  match: Record<string, unknown>;
+}
+
+// ── Games types ──
+
+export interface ValidateParams {
+  eventId: string;
+}
+
+export interface ValidateResponse {
+  valid: boolean;
+  event: Event;
+}
+
+export interface GameCreateParams {
+  id: string;
+  playerWallet: string;
+  teamChoice: string;
+  wagerAmount: number;
+}
+
+export interface GameCreateResponse {
+  game: Game;
+  transaction: string;
+}
+
+export interface GameJoinParams {
+  playerWallet: string;
+  gameId: string;
+  teamChoice: string;
+  amount: number;
+}
+
+export interface GameJoinResponse {
+  game: Game;
+  transaction: string;
+}
+
+export interface GameConfirmParams {
+  gameId: string;
+  playerWallet: string;
+  signature: string;
+  [key: string]: unknown;
+}
+
+export interface GameConfirmResponse {
+  game: Game;
+}
+
+export interface GameListParams {
+  status?: string;
+  limit?: number;
+  offset?: number;
+}
+
+export interface GameListResponse {
+  games: Game[];
+  total: number;
+}
+
+export interface NetworkGamesParams {
+  limit?: number;
+  offset?: number;
+}
+
+export interface NetworkGamesResponse {
+  games: Game[];
+  total: number;
+}
+
+export interface LiveScoreResponse {
+  gameId: string;
+  score: Record<string, unknown>;
+  status: string;
+  [key: string]: unknown;
+}
+
+export interface CustomGameCreateParams {
+  playerWallet: string;
+  teamChoice: string;
+  wagerAmount: number;
+  [key: string]: unknown;
+}
+
+export interface CustomGameCreateResponse {
+  game: Game;
+  transaction: string;
+}
+
+export interface CustomGameConfirmParams {
+  gameId: string;
+  playerWallet: string;
+  signature: string;
+  [key: string]: unknown;
+}
+
+export interface CustomGameConfirmResponse {
+  game: Game;
+}
+
+// ── Transactions types ──
+
+export interface BuildClaimParams {
+  playerWallet: string;
+  gameId: string;
+}
+
+export interface BuildClaimResponse {
+  transaction: string;
+  [key: string]: unknown;
+}
+
+// ── Config types ──
+
+export interface AppConfigResponse {
+  [key: string]: unknown;
+}