@agg-build/sdk 1.0.0

package/dist/server.d.mts

@@ -0,0 +1,155 @@
+interface ExternalIdAssertion {
+    externalId: string;
+    timestamp: number;
+    hmac: string;
+}
+declare function signExternalId(appSecret: string, externalId: string): ExternalIdAssertion;
+declare class WebhookVerificationError extends Error {
+    constructor(message: string);
+}
+interface VerifyWebhookOptions {
+    toleranceSeconds?: number;
+}
+declare function verifyWebhook(payload: string, headers: Record<string, string | string[] | undefined>, secret: string, options?: VerifyWebhookOptions): void;
+declare function parseWebhookEvent(payload: string, headers: Record<string, string | string[] | undefined>, secret: string, options?: VerifyWebhookOptions): WebhookEvent;
+interface WebhookEventBase {
+    id: string;
+    createdAt: string;
+}
+interface AccountsCreatedEvent extends WebhookEventBase {
+    type: "accounts.created";
+    data: {
+        userId: string;
+        appId: string;
+    };
+}
+interface AccountsLinkedEvent extends WebhookEventBase {
+    type: "accounts.linked";
+    data: {
+        userId: string;
+        externalId: string;
+        linkedAt: string;
+    };
+}
+interface WalletsReadyEvent extends WebhookEventBase {
+    type: "wallets.ready";
+    data: {
+        userId: string;
+        evmAddress: string;
+        svmAddress: string;
+    };
+}
+interface TradesPlacedEvent extends WebhookEventBase {
+    type: "trades.placed";
+    data: {
+        orderId: string;
+        userId: string;
+        side: string;
+        venue: string;
+        venueMarketId: string;
+    };
+}
+interface TradesFilledEvent extends WebhookEventBase {
+    type: "trades.filled";
+    data: {
+        orderId: string;
+        userId: string;
+        status: string;
+        fillPrice: number;
+        fillSize: number;
+    };
+}
+interface MarketsResolvedEvent extends WebhookEventBase {
+    type: "markets.resolved";
+    data: {
+        venueMarketId: string;
+        outcome: string;
+        affectedUsersCount: number;
+    };
+}
+interface UnknownWebhookEvent extends WebhookEventBase {
+    type: string;
+    data: Record<string, unknown>;
+}
+type KnownWebhookEvent = AccountsCreatedEvent | AccountsLinkedEvent | WalletsReadyEvent | TradesPlacedEvent | TradesFilledEvent | MarketsResolvedEvent;
+type WebhookEvent = KnownWebhookEvent | UnknownWebhookEvent;
+interface AggAdminClientOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+declare class AggAdminClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(options: AggAdminClientOptions);
+    request<T>(path: string, init?: RequestInit & {
+        query?: Record<string, string | string[] | undefined>;
+    }): Promise<T>;
+    private rawFetch;
+    private throwResponseError;
+    listUsers(appId: string, query?: {
+        limit?: number;
+        cursor?: string;
+        search?: string;
+    }): Promise<{
+        data: {
+            id: string;
+            username: string | null;
+            externalId: string | null;
+            suspended: boolean;
+            createdAt: string;
+        }[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+    getUser(appId: string, userId: string): Promise<{
+        id: string;
+        username: string | null;
+        externalId: string | null;
+        suspended: boolean;
+        createdAt: string;
+        updatedAt: string;
+        _count: {
+            orders: number;
+        };
+    }>;
+    getAnalytics(appId: string): Promise<{
+        totalUsers: number;
+        totalOrders: number;
+        ordersByStatus: Record<string, number>;
+        ordersByVenue: Record<string, number>;
+        usersLast30Days: number;
+        ordersLast30Days: number;
+    }>;
+    listOrders(appId: string, query?: {
+        limit?: number;
+        cursor?: string;
+        venue?: string;
+        status?: string;
+    }): Promise<{
+        data: unknown[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+    rotateWebhookSecret(appId: string, webhookId: string): Promise<{
+        secret: string;
+    }>;
+    replayWebhookDeliveries(appId: string, webhookId: string): Promise<{
+        success: boolean;
+    }>;
+    listMarketResolutionUsers(appId: string, venueMarketId: string, query?: {
+        limit?: number;
+        cursor?: string;
+        includeEmails?: boolean;
+    }): Promise<{
+        venueMarketId: string;
+        note: string;
+        data: {
+            userId: string;
+            email?: string | null;
+        }[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+}
+
+export { type AccountsCreatedEvent, type AccountsLinkedEvent, AggAdminClient, type AggAdminClientOptions, type ExternalIdAssertion, type KnownWebhookEvent, type MarketsResolvedEvent, type TradesFilledEvent, type TradesPlacedEvent, type UnknownWebhookEvent, type VerifyWebhookOptions, type WalletsReadyEvent, type WebhookEvent, WebhookVerificationError, parseWebhookEvent, signExternalId, verifyWebhook };

package/dist/server.d.ts

@@ -0,0 +1,155 @@
+interface ExternalIdAssertion {
+    externalId: string;
+    timestamp: number;
+    hmac: string;
+}
+declare function signExternalId(appSecret: string, externalId: string): ExternalIdAssertion;
+declare class WebhookVerificationError extends Error {
+    constructor(message: string);
+}
+interface VerifyWebhookOptions {
+    toleranceSeconds?: number;
+}
+declare function verifyWebhook(payload: string, headers: Record<string, string | string[] | undefined>, secret: string, options?: VerifyWebhookOptions): void;
+declare function parseWebhookEvent(payload: string, headers: Record<string, string | string[] | undefined>, secret: string, options?: VerifyWebhookOptions): WebhookEvent;
+interface WebhookEventBase {
+    id: string;
+    createdAt: string;
+}
+interface AccountsCreatedEvent extends WebhookEventBase {
+    type: "accounts.created";
+    data: {
+        userId: string;
+        appId: string;
+    };
+}
+interface AccountsLinkedEvent extends WebhookEventBase {
+    type: "accounts.linked";
+    data: {
+        userId: string;
+        externalId: string;
+        linkedAt: string;
+    };
+}
+interface WalletsReadyEvent extends WebhookEventBase {
+    type: "wallets.ready";
+    data: {
+        userId: string;
+        evmAddress: string;
+        svmAddress: string;
+    };
+}
+interface TradesPlacedEvent extends WebhookEventBase {
+    type: "trades.placed";
+    data: {
+        orderId: string;
+        userId: string;
+        side: string;
+        venue: string;
+        venueMarketId: string;
+    };
+}
+interface TradesFilledEvent extends WebhookEventBase {
+    type: "trades.filled";
+    data: {
+        orderId: string;
+        userId: string;
+        status: string;
+        fillPrice: number;
+        fillSize: number;
+    };
+}
+interface MarketsResolvedEvent extends WebhookEventBase {
+    type: "markets.resolved";
+    data: {
+        venueMarketId: string;
+        outcome: string;
+        affectedUsersCount: number;
+    };
+}
+interface UnknownWebhookEvent extends WebhookEventBase {
+    type: string;
+    data: Record<string, unknown>;
+}
+type KnownWebhookEvent = AccountsCreatedEvent | AccountsLinkedEvent | WalletsReadyEvent | TradesPlacedEvent | TradesFilledEvent | MarketsResolvedEvent;
+type WebhookEvent = KnownWebhookEvent | UnknownWebhookEvent;
+interface AggAdminClientOptions {
+    baseUrl: string;
+    apiKey: string;
+}
+declare class AggAdminClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    constructor(options: AggAdminClientOptions);
+    request<T>(path: string, init?: RequestInit & {
+        query?: Record<string, string | string[] | undefined>;
+    }): Promise<T>;
+    private rawFetch;
+    private throwResponseError;
+    listUsers(appId: string, query?: {
+        limit?: number;
+        cursor?: string;
+        search?: string;
+    }): Promise<{
+        data: {
+            id: string;
+            username: string | null;
+            externalId: string | null;
+            suspended: boolean;
+            createdAt: string;
+        }[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+    getUser(appId: string, userId: string): Promise<{
+        id: string;
+        username: string | null;
+        externalId: string | null;
+        suspended: boolean;
+        createdAt: string;
+        updatedAt: string;
+        _count: {
+            orders: number;
+        };
+    }>;
+    getAnalytics(appId: string): Promise<{
+        totalUsers: number;
+        totalOrders: number;
+        ordersByStatus: Record<string, number>;
+        ordersByVenue: Record<string, number>;
+        usersLast30Days: number;
+        ordersLast30Days: number;
+    }>;
+    listOrders(appId: string, query?: {
+        limit?: number;
+        cursor?: string;
+        venue?: string;
+        status?: string;
+    }): Promise<{
+        data: unknown[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+    rotateWebhookSecret(appId: string, webhookId: string): Promise<{
+        secret: string;
+    }>;
+    replayWebhookDeliveries(appId: string, webhookId: string): Promise<{
+        success: boolean;
+    }>;
+    listMarketResolutionUsers(appId: string, venueMarketId: string, query?: {
+        limit?: number;
+        cursor?: string;
+        includeEmails?: boolean;
+    }): Promise<{
+        venueMarketId: string;
+        note: string;
+        data: {
+            userId: string;
+            email?: string | null;
+        }[];
+        nextCursor: string | null;
+        hasMore: boolean;
+    }>;
+}
+
+export { type AccountsCreatedEvent, type AccountsLinkedEvent, AggAdminClient, type AggAdminClientOptions, type ExternalIdAssertion, type KnownWebhookEvent, type MarketsResolvedEvent, type TradesFilledEvent, type TradesPlacedEvent, type UnknownWebhookEvent, type VerifyWebhookOptions, type WalletsReadyEvent, type WebhookEvent, WebhookVerificationError, parseWebhookEvent, signExternalId, verifyWebhook };

package/dist/server.js

@@ -0,0 +1,254 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+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);
+var __async = (__this, __arguments, generator) => {
+  return new Promise((resolve, reject) => {
+    var fulfilled = (value) => {
+      try {
+        step(generator.next(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var rejected = (value) => {
+      try {
+        step(generator.throw(value));
+      } catch (e) {
+        reject(e);
+      }
+    };
+    var step = (x) => x.done ? resolve(x.value) : Promise.resolve(x.value).then(fulfilled, rejected);
+    step((generator = generator.apply(__this, __arguments)).next());
+  });
+};
+
+// src/server.ts
+var server_exports = {};
+__export(server_exports, {
+  AggAdminClient: () => AggAdminClient,
+  WebhookVerificationError: () => WebhookVerificationError,
+  parseWebhookEvent: () => parseWebhookEvent,
+  signExternalId: () => signExternalId,
+  verifyWebhook: () => verifyWebhook
+});
+module.exports = __toCommonJS(server_exports);
+var import_node_crypto = require("crypto");
+function signExternalId(appSecret, externalId) {
+  const timestamp = Date.now();
+  const hmac = (0, import_node_crypto.createHmac)("sha256", Buffer.from(appSecret, "hex")).update(`${externalId}:${timestamp}`).digest("hex");
+  return {
+    externalId,
+    timestamp,
+    hmac
+  };
+}
+var WebhookVerificationError = class extends Error {
+  constructor(message) {
+    super(message);
+    this.name = "WebhookVerificationError";
+  }
+};
+function verifyWebhook(payload, headers, secret, options) {
+  var _a;
+  const tolerance = (_a = options == null ? void 0 : options.toleranceSeconds) != null ? _a : 300;
+  const msgId = getHeader(headers, "webhook-id");
+  const timestamp = getHeader(headers, "webhook-timestamp");
+  const signatures = getHeader(headers, "webhook-signature");
+  if (!msgId) throw new WebhookVerificationError("Missing Webhook-Id header");
+  if (!timestamp) throw new WebhookVerificationError("Missing Webhook-Timestamp header");
+  if (!signatures) throw new WebhookVerificationError("Missing Webhook-Signature header");
+  const ts = parseInt(timestamp, 10);
+  if (isNaN(ts)) throw new WebhookVerificationError("Invalid Webhook-Timestamp");
+  const now = Math.floor(Date.now() / 1e3);
+  if (Math.abs(now - ts) > tolerance) {
+    throw new WebhookVerificationError("Webhook timestamp outside tolerance window");
+  }
+  const secretBytes = Buffer.from(secret.replace(/^whsec_/, ""), "base64");
+  const signedContent = `${msgId}.${timestamp}.${payload}`;
+  const expected = (0, import_node_crypto.createHmac)("sha256", secretBytes).update(signedContent).digest("base64");
+  const expectedSig = `v1,${expected}`;
+  const expectedBuf = Buffer.from(expectedSig);
+  const matched = signatures.split(" ").some((sig) => {
+    const sigBuf = Buffer.from(sig);
+    return sigBuf.length === expectedBuf.length && (0, import_node_crypto.timingSafeEqual)(sigBuf, expectedBuf);
+  });
+  if (!matched) {
+    throw new WebhookVerificationError("Invalid webhook signature");
+  }
+}
+function parseWebhookEvent(payload, headers, secret, options) {
+  verifyWebhook(payload, headers, secret, options);
+  const parsed = JSON.parse(payload);
+  return parsed;
+}
+var AggAdminClient = class {
+  constructor(options) {
+    this.baseUrl = options.baseUrl.replace(/\/$/, "");
+    this.apiKey = options.apiKey;
+  }
+  // ── Core HTTP ────────────────────────────────────────────────────────
+  request(path, init) {
+    return __async(this, null, function* () {
+      const response = yield this.rawFetch(path, init);
+      if (!response.ok) {
+        return this.throwResponseError(response);
+      }
+      return response.json();
+    });
+  }
+  rawFetch(path, init) {
+    return __async(this, null, function* () {
+      const headers = {
+        "Content-Type": "application/json",
+        "x-app-api-key": this.apiKey
+      };
+      const url = new URL(`${this.baseUrl}${path}`);
+      if (init == null ? void 0 : init.query) {
+        for (const [key, value] of Object.entries(init.query)) {
+          if (value === void 0) continue;
+          if (Array.isArray(value)) {
+            for (const v of value) url.searchParams.append(key, v);
+          } else {
+            url.searchParams.set(key, value);
+          }
+        }
+      }
+      return fetch(url, __spreadProps(__spreadValues({}, init), {
+        headers: __spreadValues(__spreadValues({}, headers), init == null ? void 0 : init.headers)
+      }));
+    });
+  }
+  throwResponseError(response) {
+    return __async(this, null, function* () {
+      let message = `AGG API error: ${response.status} ${response.statusText}`;
+      try {
+        const body = yield response.json();
+        if (typeof body.message === "string" && body.message.length > 0) {
+          message = body.message;
+        }
+      } catch (e) {
+      }
+      const error = new Error(message);
+      error.status = response.status;
+      throw error;
+    });
+  }
+  // ── Users ────────────────────────────────────────────────────────────
+  listUsers(appId, query) {
+    return __async(this, null, function* () {
+      var _a;
+      return this.request(`/apps/${appId}/users`, {
+        query: {
+          limit: (_a = query == null ? void 0 : query.limit) == null ? void 0 : _a.toString(),
+          cursor: query == null ? void 0 : query.cursor,
+          search: query == null ? void 0 : query.search
+        }
+      });
+    });
+  }
+  getUser(appId, userId) {
+    return __async(this, null, function* () {
+      return this.request(`/apps/${appId}/users/${userId}`);
+    });
+  }
+  // ── Analytics & Orders ───────────────────────────────────────────────
+  getAnalytics(appId) {
+    return __async(this, null, function* () {
+      return this.request(`/apps/${appId}/analytics`);
+    });
+  }
+  listOrders(appId, query) {
+    return __async(this, null, function* () {
+      var _a;
+      return this.request(`/apps/${appId}/orders`, {
+        query: {
+          limit: (_a = query == null ? void 0 : query.limit) == null ? void 0 : _a.toString(),
+          cursor: query == null ? void 0 : query.cursor,
+          venue: query == null ? void 0 : query.venue,
+          status: query == null ? void 0 : query.status
+        }
+      });
+    });
+  }
+  // ── Webhooks ─────────────────────────────────────────────────────────
+  rotateWebhookSecret(appId, webhookId) {
+    return __async(this, null, function* () {
+      return this.request(`/apps/${appId}/webhooks/${webhookId}/rotate-secret`, {
+        method: "POST"
+      });
+    });
+  }
+  replayWebhookDeliveries(appId, webhookId) {
+    return __async(this, null, function* () {
+      return this.request(`/apps/${appId}/webhooks/${webhookId}/replay`, {
+        method: "POST"
+      });
+    });
+  }
+  // ── Market Resolutions ───────────────────────────────────────────────
+  listMarketResolutionUsers(appId, venueMarketId, query) {
+    return __async(this, null, function* () {
+      var _a;
+      return this.request(`/apps/${appId}/market-resolutions/${venueMarketId}/users`, {
+        query: {
+          limit: (_a = query == null ? void 0 : query.limit) == null ? void 0 : _a.toString(),
+          cursor: query == null ? void 0 : query.cursor,
+          includeEmails: (query == null ? void 0 : query.includeEmails) ? "true" : void 0
+        }
+      });
+    });
+  }
+};
+function getHeader(headers, name) {
+  var _a;
+  const val = (_a = headers[name]) != null ? _a : headers[name.toLowerCase()];
+  if (val !== void 0) return Array.isArray(val) ? val[0] : val;
+  const lower = name.toLowerCase();
+  for (const key of Object.keys(headers)) {
+    if (key.toLowerCase() === lower) {
+      const v = headers[key];
+      return Array.isArray(v) ? v[0] : v;
+    }
+  }
+  return void 0;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AggAdminClient,
+  WebhookVerificationError,
+  parseWebhookEvent,
+  signExternalId,
+  verifyWebhook
+});