@dubsdotapp/node 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,70 @@
+declare const DEFAULT_BASE_URL = "https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1";
+type DubsNetwork = 'devnet' | 'mainnet-beta';
+declare const NETWORK_CONFIG: Record<DubsNetwork, {
+    baseUrl: string;
+}>;
+
+/** Configuration for the Dubs client */
+interface DubsConfig {
+    /** Your Dubs API key (from the developer portal) */
+    apiKey: string;
+    /** Resolution secret for signing resolveGame requests (from the developer portal) */
+    resolutionSecret?: string;
+    /** Explicit base URL — overrides `network` if both provided */
+    baseUrl?: string;
+    /** Network shorthand — sets the base URL automatically */
+    network?: DubsNetwork;
+}
+/** Parameters for resolving a game */
+interface ResolveGameParams {
+    /** Which side won: 'home', 'away', 'draw', or null for refund */
+    winner: 'home' | 'away' | 'draw' | null;
+    /** Optional metadata to attach to the resolution */
+    metadata?: Record<string, unknown>;
+}
+/** Result from resolving a game */
+interface ResolveGameResult {
+    success: boolean;
+    gameId: string;
+    winner: string | null;
+    signature: string;
+    explorerUrl: string;
+}
+/** A parsed webhook event from Dubs */
+interface WebhookEvent {
+    event: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+
+declare class Dubs {
+    private readonly apiKey;
+    private readonly resolutionSecret?;
+    private readonly baseUrl;
+    constructor(config: DubsConfig);
+    /**
+     * Resolve a custom game (game_mode=6).
+     *
+     * Automatically computes the HMAC-SHA256 signature using your resolution secret.
+     */
+    resolveGame(gameId: string, params: ResolveGameParams): Promise<ResolveGameResult>;
+    /**
+     * Verify an incoming Dubs webhook request.
+     *
+     * @param rawBody  - The raw request body (string or Buffer)
+     * @param signature - The X-Dubs-Signature header value
+     * @param secret   - Your webhook secret (from the developer portal)
+     * @returns The parsed webhook event
+     * @throws DubsApiError if the signature is invalid
+     */
+    static verifyWebhook(rawBody: string | Buffer, signature: string, secret: string): WebhookEvent;
+    private request;
+}
+
+declare class DubsApiError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    constructor(code: string, message: string, httpStatus: number);
+}
+
+export { DEFAULT_BASE_URL, Dubs, DubsApiError, type DubsConfig, type DubsNetwork, NETWORK_CONFIG, type ResolveGameParams, type ResolveGameResult, type WebhookEvent };

package/dist/index.d.ts

@@ -0,0 +1,70 @@
+declare const DEFAULT_BASE_URL = "https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1";
+type DubsNetwork = 'devnet' | 'mainnet-beta';
+declare const NETWORK_CONFIG: Record<DubsNetwork, {
+    baseUrl: string;
+}>;
+
+/** Configuration for the Dubs client */
+interface DubsConfig {
+    /** Your Dubs API key (from the developer portal) */
+    apiKey: string;
+    /** Resolution secret for signing resolveGame requests (from the developer portal) */
+    resolutionSecret?: string;
+    /** Explicit base URL — overrides `network` if both provided */
+    baseUrl?: string;
+    /** Network shorthand — sets the base URL automatically */
+    network?: DubsNetwork;
+}
+/** Parameters for resolving a game */
+interface ResolveGameParams {
+    /** Which side won: 'home', 'away', 'draw', or null for refund */
+    winner: 'home' | 'away' | 'draw' | null;
+    /** Optional metadata to attach to the resolution */
+    metadata?: Record<string, unknown>;
+}
+/** Result from resolving a game */
+interface ResolveGameResult {
+    success: boolean;
+    gameId: string;
+    winner: string | null;
+    signature: string;
+    explorerUrl: string;
+}
+/** A parsed webhook event from Dubs */
+interface WebhookEvent {
+    event: string;
+    timestamp: string;
+    data: Record<string, unknown>;
+}
+
+declare class Dubs {
+    private readonly apiKey;
+    private readonly resolutionSecret?;
+    private readonly baseUrl;
+    constructor(config: DubsConfig);
+    /**
+     * Resolve a custom game (game_mode=6).
+     *
+     * Automatically computes the HMAC-SHA256 signature using your resolution secret.
+     */
+    resolveGame(gameId: string, params: ResolveGameParams): Promise<ResolveGameResult>;
+    /**
+     * Verify an incoming Dubs webhook request.
+     *
+     * @param rawBody  - The raw request body (string or Buffer)
+     * @param signature - The X-Dubs-Signature header value
+     * @param secret   - Your webhook secret (from the developer portal)
+     * @returns The parsed webhook event
+     * @throws DubsApiError if the signature is invalid
+     */
+    static verifyWebhook(rawBody: string | Buffer, signature: string, secret: string): WebhookEvent;
+    private request;
+}
+
+declare class DubsApiError extends Error {
+    readonly code: string;
+    readonly httpStatus: number;
+    constructor(code: string, message: string, httpStatus: number);
+}
+
+export { DEFAULT_BASE_URL, Dubs, DubsApiError, type DubsConfig, type DubsNetwork, NETWORK_CONFIG, type ResolveGameParams, type ResolveGameResult, type WebhookEvent };

package/dist/index.js

@@ -0,0 +1,152 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+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 __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  DEFAULT_BASE_URL: () => DEFAULT_BASE_URL,
+  Dubs: () => Dubs,
+  DubsApiError: () => DubsApiError,
+  NETWORK_CONFIG: () => NETWORK_CONFIG
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/client.ts
+var import_crypto = __toESM(require("crypto"));
+
+// src/constants.ts
+var DEFAULT_BASE_URL = "https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1";
+var NETWORK_CONFIG = {
+  "mainnet-beta": {
+    baseUrl: "https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1"
+  },
+  devnet: {
+    baseUrl: "https://dubs-server-dev-55d1fba09a97.herokuapp.com/api/developer/v1"
+  }
+};
+
+// src/errors.ts
+var DubsApiError = class extends Error {
+  code;
+  httpStatus;
+  constructor(code, message, httpStatus) {
+    super(message);
+    this.name = "DubsApiError";
+    this.code = code;
+    this.httpStatus = httpStatus;
+  }
+};
+
+// src/client.ts
+var Dubs = class {
+  apiKey;
+  resolutionSecret;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.resolutionSecret = config.resolutionSecret;
+    if (config.baseUrl) {
+      this.baseUrl = config.baseUrl;
+    } else if (config.network) {
+      this.baseUrl = NETWORK_CONFIG[config.network].baseUrl;
+    } else {
+      this.baseUrl = DEFAULT_BASE_URL;
+    }
+  }
+  /**
+   * Resolve a custom game (game_mode=6).
+   *
+   * Automatically computes the HMAC-SHA256 signature using your resolution secret.
+   */
+  async resolveGame(gameId, params) {
+    if (!this.resolutionSecret) {
+      throw new DubsApiError(
+        "missing_resolution_secret",
+        "resolutionSecret is required for resolveGame(). Pass it in the Dubs constructor.",
+        0
+      );
+    }
+    const body = JSON.stringify({
+      winner: params.winner,
+      ...params.metadata && { metadata: params.metadata }
+    });
+    const hmac = import_crypto.default.createHmac("sha256", this.resolutionSecret).update(body).digest("hex");
+    return this.request("POST", `/games/${gameId}/resolve`, body, {
+      "x-dubs-signature": `sha256=${hmac}`
+    });
+  }
+  /**
+   * Verify an incoming Dubs webhook request.
+   *
+   * @param rawBody  - The raw request body (string or Buffer)
+   * @param signature - The X-Dubs-Signature header value
+   * @param secret   - Your webhook secret (from the developer portal)
+   * @returns The parsed webhook event
+   * @throws DubsApiError if the signature is invalid
+   */
+  static verifyWebhook(rawBody, signature, secret) {
+    const body = typeof rawBody === "string" ? rawBody : rawBody.toString("utf-8");
+    const expected = import_crypto.default.createHmac("sha256", secret).update(body).digest("hex");
+    if (signature.length !== expected.length || !import_crypto.default.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
+      throw new DubsApiError("invalid_signature", "Webhook signature verification failed", 401);
+    }
+    return JSON.parse(body);
+  }
+  // ── Private ──
+  async request(method, path, body, extraHeaders) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "x-api-key": this.apiKey,
+      "Content-Type": "application/json",
+      ...extraHeaders
+    };
+    const res = await fetch(url, {
+      method,
+      headers,
+      ...body && { body }
+    });
+    const json = await res.json();
+    if (!res.ok) {
+      throw new DubsApiError(
+        json.code || "api_error",
+        json.message || json.error || `Request failed with status ${res.status}`,
+        res.status
+      );
+    }
+    return json;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  DEFAULT_BASE_URL,
+  Dubs,
+  DubsApiError,
+  NETWORK_CONFIG
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/client.ts","../src/constants.ts","../src/errors.ts"],"sourcesContent":["export { Dubs } from './client';\nexport { DubsApiError } from './errors';\nexport type { DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';\nexport { DEFAULT_BASE_URL, NETWORK_CONFIG } from './constants';\nexport type { DubsNetwork } from './constants';\n","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      throw new DubsApiError(\n        (json.code as string) || 'api_error',\n        (json.message as string) || (json.error as string) || `Request failed with status ${res.status}`,\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;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,oBAAmB;;;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,cAAAA,QAAO,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,cAAAA,QAAO,WAAW,UAAU,MAAM,EAAE,OAAO,IAAI,EAAE,OAAO,KAAK;AAE9E,QACE,UAAU,WAAW,SAAS,UAC9B,CAAC,cAAAA,QAAO,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,IAAI;AAAA,QACP,KAAK,QAAmB;AAAA,QACxB,KAAK,WAAuB,KAAK,SAAoB,8BAA8B,IAAI,MAAM;AAAA,QAC9F,IAAI;AAAA,MACN;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":["crypto"]}

package/dist/index.mjs

@@ -0,0 +1,112 @@
+// src/client.ts
+import crypto from "crypto";
+
+// src/constants.ts
+var DEFAULT_BASE_URL = "https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1";
+var NETWORK_CONFIG = {
+  "mainnet-beta": {
+    baseUrl: "https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1"
+  },
+  devnet: {
+    baseUrl: "https://dubs-server-dev-55d1fba09a97.herokuapp.com/api/developer/v1"
+  }
+};
+
+// src/errors.ts
+var DubsApiError = class extends Error {
+  code;
+  httpStatus;
+  constructor(code, message, httpStatus) {
+    super(message);
+    this.name = "DubsApiError";
+    this.code = code;
+    this.httpStatus = httpStatus;
+  }
+};
+
+// src/client.ts
+var Dubs = class {
+  apiKey;
+  resolutionSecret;
+  baseUrl;
+  constructor(config) {
+    this.apiKey = config.apiKey;
+    this.resolutionSecret = config.resolutionSecret;
+    if (config.baseUrl) {
+      this.baseUrl = config.baseUrl;
+    } else if (config.network) {
+      this.baseUrl = NETWORK_CONFIG[config.network].baseUrl;
+    } else {
+      this.baseUrl = DEFAULT_BASE_URL;
+    }
+  }
+  /**
+   * Resolve a custom game (game_mode=6).
+   *
+   * Automatically computes the HMAC-SHA256 signature using your resolution secret.
+   */
+  async resolveGame(gameId, params) {
+    if (!this.resolutionSecret) {
+      throw new DubsApiError(
+        "missing_resolution_secret",
+        "resolutionSecret is required for resolveGame(). Pass it in the Dubs constructor.",
+        0
+      );
+    }
+    const body = JSON.stringify({
+      winner: params.winner,
+      ...params.metadata && { metadata: params.metadata }
+    });
+    const hmac = crypto.createHmac("sha256", this.resolutionSecret).update(body).digest("hex");
+    return this.request("POST", `/games/${gameId}/resolve`, body, {
+      "x-dubs-signature": `sha256=${hmac}`
+    });
+  }
+  /**
+   * Verify an incoming Dubs webhook request.
+   *
+   * @param rawBody  - The raw request body (string or Buffer)
+   * @param signature - The X-Dubs-Signature header value
+   * @param secret   - Your webhook secret (from the developer portal)
+   * @returns The parsed webhook event
+   * @throws DubsApiError if the signature is invalid
+   */
+  static verifyWebhook(rawBody, signature, secret) {
+    const body = typeof rawBody === "string" ? rawBody : rawBody.toString("utf-8");
+    const expected = crypto.createHmac("sha256", secret).update(body).digest("hex");
+    if (signature.length !== expected.length || !crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))) {
+      throw new DubsApiError("invalid_signature", "Webhook signature verification failed", 401);
+    }
+    return JSON.parse(body);
+  }
+  // ── Private ──
+  async request(method, path, body, extraHeaders) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "x-api-key": this.apiKey,
+      "Content-Type": "application/json",
+      ...extraHeaders
+    };
+    const res = await fetch(url, {
+      method,
+      headers,
+      ...body && { body }
+    });
+    const json = await res.json();
+    if (!res.ok) {
+      throw new DubsApiError(
+        json.code || "api_error",
+        json.message || json.error || `Request failed with status ${res.status}`,
+        res.status
+      );
+    }
+    return json;
+  }
+};
+export {
+  DEFAULT_BASE_URL,
+  Dubs,
+  DubsApiError,
+  NETWORK_CONFIG
+};
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +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      throw new DubsApiError(\n        (json.code as string) || 'api_error',\n        (json.message as string) || (json.error as string) || `Request failed with status ${res.status}`,\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,IAAI;AAAA,QACP,KAAK,QAAmB;AAAA,QACxB,KAAK,WAAuB,KAAK,SAAoB,8BAA8B,IAAI,MAAM;AAAA,QAC9F,IAAI;AAAA,MACN;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AACF;","names":[]}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@dubsdotapp/node",
+  "version": "0.1.0",
+  "description": "Server-side Node.js SDK for the Dubs betting platform",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "dev": "tsup --watch",
+    "clean": "rm -rf dist"
+  },
+  "devDependencies": {
+    "@types/node": "^25.3.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.3.0"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "solana",
+    "betting",
+    "dubs",
+    "web3",
+    "node",
+    "server"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iheartsolana/dubs-node"
+  }
+}

package/src/client.ts

@@ -0,0 +1,107 @@
+import crypto from 'crypto';
+import { DEFAULT_BASE_URL, NETWORK_CONFIG } from './constants';
+import { DubsApiError } from './errors';
+import type { DubsConfig, ResolveGameParams, ResolveGameResult, WebhookEvent } from './types';
+
+export class Dubs {
+  private readonly apiKey: string;
+  private readonly resolutionSecret?: string;
+  private readonly baseUrl: string;
+
+  constructor(config: DubsConfig) {
+    this.apiKey = config.apiKey;
+    this.resolutionSecret = config.resolutionSecret;
+
+    if (config.baseUrl) {
+      this.baseUrl = config.baseUrl;
+    } else if (config.network) {
+      this.baseUrl = NETWORK_CONFIG[config.network].baseUrl;
+    } else {
+      this.baseUrl = DEFAULT_BASE_URL;
+    }
+  }
+
+  /**
+   * Resolve a custom game (game_mode=6).
+   *
+   * Automatically computes the HMAC-SHA256 signature using your resolution secret.
+   */
+  async resolveGame(gameId: string, params: ResolveGameParams): Promise<ResolveGameResult> {
+    if (!this.resolutionSecret) {
+      throw new DubsApiError(
+        'missing_resolution_secret',
+        'resolutionSecret is required for resolveGame(). Pass it in the Dubs constructor.',
+        0,
+      );
+    }
+
+    const body = JSON.stringify({
+      winner: params.winner,
+      ...(params.metadata && { metadata: params.metadata }),
+    });
+
+    const hmac = crypto.createHmac('sha256', this.resolutionSecret).update(body).digest('hex');
+
+    return this.request<ResolveGameResult>('POST', `/games/${gameId}/resolve`, body, {
+      'x-dubs-signature': `sha256=${hmac}`,
+    });
+  }
+
+  /**
+   * Verify an incoming Dubs webhook request.
+   *
+   * @param rawBody  - The raw request body (string or Buffer)
+   * @param signature - The X-Dubs-Signature header value
+   * @param secret   - Your webhook secret (from the developer portal)
+   * @returns The parsed webhook event
+   * @throws DubsApiError if the signature is invalid
+   */
+  static verifyWebhook(rawBody: string | Buffer, signature: string, secret: string): WebhookEvent {
+    const body = typeof rawBody === 'string' ? rawBody : rawBody.toString('utf-8');
+    const expected = crypto.createHmac('sha256', secret).update(body).digest('hex');
+
+    if (
+      signature.length !== expected.length ||
+      !crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expected))
+    ) {
+      throw new DubsApiError('invalid_signature', 'Webhook signature verification failed', 401);
+    }
+
+    return JSON.parse(body) as WebhookEvent;
+  }
+
+  // ── Private ──
+
+  private async request<T>(
+    method: string,
+    path: string,
+    body?: string,
+    extraHeaders?: Record<string, string>,
+  ): Promise<T> {
+    const url = `${this.baseUrl}${path}`;
+
+    const headers: Record<string, string> = {
+      'x-api-key': this.apiKey,
+      'Content-Type': 'application/json',
+      ...extraHeaders,
+    };
+
+    const res = await fetch(url, {
+      method,
+      headers,
+      ...(body && { body }),
+    });
+
+    const json = (await res.json()) as Record<string, unknown>;
+
+    if (!res.ok) {
+      throw new DubsApiError(
+        (json.code as string) || 'api_error',
+        (json.message as string) || (json.error as string) || `Request failed with status ${res.status}`,
+        res.status,
+      );
+    }
+
+    return json as T;
+  }
+}

package/src/constants.ts

@@ -0,0 +1,12 @@
+export const DEFAULT_BASE_URL = 'https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1';
+
+export type DubsNetwork = 'devnet' | 'mainnet-beta';
+
+export const NETWORK_CONFIG: Record<DubsNetwork, { baseUrl: string }> = {
+  'mainnet-beta': {
+    baseUrl: 'https://dubs-server-prod-9c91d3f01199.herokuapp.com/api/developer/v1',
+  },
+  devnet: {
+    baseUrl: 'https://dubs-server-dev-55d1fba09a97.herokuapp.com/api/developer/v1',
+  },
+};

package/src/errors.ts

@@ -0,0 +1,11 @@
+export class DubsApiError extends Error {
+  public readonly code: string;
+  public readonly httpStatus: number;
+
+  constructor(code: string, message: string, httpStatus: number) {
+    super(message);
+    this.name = 'DubsApiError';
+    this.code = code;
+    this.httpStatus = httpStatus;
+  }
+}

package/src/index.ts

@@ -0,0 +1,5 @@
+export { Dubs } from './client';
+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';

package/src/types.ts

@@ -0,0 +1,37 @@
+import type { DubsNetwork } from './constants';
+
+/** Configuration for the Dubs client */
+export interface DubsConfig {
+  /** Your Dubs API key (from the developer portal) */
+  apiKey: string;
+  /** Resolution secret for signing resolveGame requests (from the developer portal) */
+  resolutionSecret?: string;
+  /** Explicit base URL — overrides `network` if both provided */
+  baseUrl?: string;
+  /** Network shorthand — sets the base URL automatically */
+  network?: DubsNetwork;
+}
+
+/** Parameters for resolving a game */
+export interface ResolveGameParams {
+  /** Which side won: 'home', 'away', 'draw', or null for refund */
+  winner: 'home' | 'away' | 'draw' | null;
+  /** Optional metadata to attach to the resolution */
+  metadata?: Record<string, unknown>;
+}
+
+/** Result from resolving a game */
+export interface ResolveGameResult {
+  success: boolean;
+  gameId: string;
+  winner: string | null;
+  signature: string;
+  explorerUrl: string;
+}
+
+/** A parsed webhook event from Dubs */
+export interface WebhookEvent {
+  event: string;
+  timestamp: string;
+  data: Record<string, unknown>;
+}