@flitt/api 1.0.0

package/dist/cjs/types.d.ts

@@ -0,0 +1,406 @@
+/**
+ * Response types of the Flitt Public API v1 (`/v1/public-api`) and of the
+ * Vote API (`/v1/vote-api`). Dates are ISO 8601 strings, as sent by the API.
+ */
+export type Game = "GMOD" | "FIVEM" | "MC";
+export type Plan = "FREEMIUM" | "PREMIUM" | "ENTERPRISE";
+export type AccessRole = "OWNER" | "ADMIN" | "EDITOR" | "VIEWER";
+export type OnlineStatus = "ONLINE" | "OFFLINE" | "UNKNOWN";
+/** Quota state read from the X-RateLimit-* headers of the last response. */
+export type RateLimit = {
+    /** Requests allowed in the period, `null` when unlimited. */
+    limit: number | null;
+    /** Requests left in the period, `null` when unlimited. */
+    remaining: number | null;
+    /** When the period resets, `null` if the API did not say. */
+    reset: Date | null;
+};
+export type Pagination = {
+    page: number;
+    limit: number;
+    /** `null` when the server is stored on an Edge SDK instance (count unknown). */
+    total: number | null;
+    pages: number | null;
+};
+export type PageParams = {
+    /** 1-based page number. */
+    page?: number;
+    /** Items per page. */
+    limit?: number;
+};
+export type Usage = {
+    enabled: boolean;
+    plan: Plan;
+    /** Monthly quota, -1 when unlimited. */
+    limitPerMonth: number;
+    usedLast30d: number;
+    /** `null` when unlimited. */
+    remaining: number | null;
+    resetAt: string;
+};
+export type ServerSummary = {
+    id: string;
+    game: Game;
+    name: string | null;
+    ip: string | null;
+    port: number | null;
+    domainName: string | null;
+    status: OnlineStatus;
+    playersOnline: number;
+    maxPlayers: number | null;
+    rating: number;
+    reviewsCount: number;
+    verifiedBadge: boolean;
+    createdAt: string | null;
+};
+export type ServerList = {
+    data: ServerSummary[];
+    pagination: Pagination;
+};
+export type Server = {
+    id: string;
+    game: Game;
+    name: string | null;
+    language: string;
+    /** Hidden (null) for the VIEWER role. */
+    ip: string | null;
+    port: number | null;
+    domainName: string | null;
+    createdAt: string | null;
+    /** First connection of the Flitt addon, `null` if never connected. */
+    bridgeConnectedAt: string | null;
+    bridgeLastSeenAt: string | null;
+    bridgeLastAddon: string | null;
+    bridgeLastPlayerCount: number | null;
+    bridgeLastMaxPlayers: number | null;
+    bridgeLastMapName: string | null;
+    bridgeLastGameVersion: string | null;
+    logsEnabled: boolean;
+    publicEnabled: boolean;
+    /** `false` when the server is beyond the plan's connected-server limit (votes only). */
+    planActive: boolean;
+    verifiedBadge: boolean;
+    rating: number;
+    reviewsCount: number;
+    status: OnlineStatus;
+    accessRole: AccessRole;
+};
+export type PlayerStatusFilter = "online" | "offline" | "all";
+export type Player = {
+    playerId: string;
+    externalId: string;
+    name: string | null;
+    isVpn: boolean | null;
+    country: string | null;
+    countryCode: string | null;
+    isp: string | null;
+    joinCount: number;
+    firstJoinedAt: string | null;
+    lastJoinedAt: string | null;
+    lastSeenAt: string | null;
+    lastLeftAt: string | null;
+    lastSessionSeconds: number | null;
+    totalPlaySeconds: number;
+    isOnline: boolean;
+    sessionStartedAt: string | null;
+};
+export type PlayerList = {
+    serverId: string;
+    players: Player[];
+    pagination: Pagination;
+};
+export type FirewallAction = "ALLOW" | "DENY";
+export type FirewallRuleKind = "IDENTIFIER" | "IP" | "COUNTRY";
+export type FirewallSettings = {
+    serverId: string;
+    enabled: boolean;
+    blockVpn: boolean;
+    kickMessage: string;
+    version: number;
+    rules: {
+        total: number;
+        allow: number;
+        deny: number; /** -1 = unlimited */
+        denyMax: number;
+    };
+};
+export type FirewallSettingsUpdate = {
+    enabled?: boolean;
+    blockVpn?: boolean;
+    /** Up to 300 characters, "" resets to the default message. */
+    kickMessage?: string;
+};
+export type FirewallRule = {
+    id: string;
+    action: FirewallAction;
+    kind: FirewallRuleKind;
+    value: string;
+    note: string | null;
+    createdAt: string | null;
+};
+export type FirewallRuleInput = {
+    action: FirewallAction;
+    kind: FirewallRuleKind;
+    /** SteamID / license / Discord id / UUID / name, an IP, or an ISO country code. Max 128 chars. */
+    value: string;
+    /** Up to 120 characters. */
+    note?: string;
+};
+export type FirewallRuleQuery = PageParams & {
+    q?: string;
+    action?: FirewallAction;
+    kind?: FirewallRuleKind;
+};
+export type FirewallRuleList = {
+    serverId: string;
+    rules: FirewallRule[];
+    pagination: {
+        page: number;
+        limit: number;
+        total: number;
+        pages: number;
+    };
+};
+export type FirewallRuleCreateResult = {
+    ok: boolean;
+    created: FirewallRule[];
+    errors: Array<{
+        index: number;
+        code: string;
+        message: string;
+    }>;
+};
+export type FirewallRuleBulkDelete = {
+    /** Up to 500 rule ids. */
+    ids?: string[];
+    action?: FirewallAction;
+    kind?: FirewallRuleKind;
+};
+export type FirewallBlock = {
+    id: string;
+    externalId: string | null;
+    name: string | null;
+    ip: string | null;
+    countryCode: string | null;
+    reason: string;
+    matchedValue: string | null;
+    createdAt: string | null;
+};
+export type DiscordModule = {
+    serverId: string;
+    moduleEnabled: boolean;
+    active: boolean;
+    linkedGuilds: number;
+};
+export type LinkCode = {
+    discordId: string;
+    /** The player types `!flitt CODE` in game (GMod / FiveM) or `/flitt link CODE` (Minecraft). */
+    code: string;
+    /** Seconds before the code expires. */
+    expiresInS: number;
+    instructions: string;
+};
+export type AccountLink = {
+    discordId: string;
+    game: Game;
+    externalId: string;
+    name: string | null;
+    linkedAt: string;
+};
+export type CommandType = "chat" | "set_group" | "set_name" | "kick" | "ban" | "unban" | "notify";
+export type CommandInput = {
+    type: CommandType;
+    payload?: Record<string, unknown>;
+    /** Wait up to this many ms (max 15000) for the addon's result. */
+    waitMs?: number;
+};
+export type QueuedCommand = {
+    id: string;
+    type: CommandType;
+    payload: Record<string, unknown>;
+    requestedBy: string | null;
+    createdAt: string;
+};
+export type CommandResult = {
+    serverId: string;
+    command: QueuedCommand;
+    /** Addon answer when `waitMs` was set and it answered in time, else `null`. */
+    result: {
+        ok: boolean;
+        output?: string | null;
+    } | null;
+    note?: string;
+};
+export type GroupList = {
+    serverId: string;
+    players: Array<{
+        externalId: string;
+        group: string;
+    }>;
+};
+export type WebhookEventType = "server_down" | "server_down_addon" | "server_down_tcp" | "server_up" | "server_up_addon" | "server_up_tcp" | "player_peak" | "player_joined" | "player_left" | "player_first_join" | "player_chat" | "review_created" | "vote_created" | "affluence_low" | "affluence_high";
+/** Body of a generic (HTTP) webhook. */
+export type WebhookEvent<T = Record<string, unknown> | null> = {
+    event: WebhookEventType;
+    timestamp: string;
+    server: {
+        id: string;
+        name: string | null;
+    };
+    data: T;
+};
+type IdentityFields = {
+    /** In-game name typed on the vote page. */
+    player: string;
+    /** SteamID64, STEAM_0:X:Y or [U:1:X]. */
+    steamId: string;
+    discordId: string;
+    /** FiveM license, with or without the "license:" prefix. */
+    license: string;
+    /** Minecraft UUID, with or without dashes. */
+    uuid: string;
+    /** Voter IP (hashed server-side, never stored in clear). */
+    ip: string;
+    voteId: string;
+};
+/** Exactly one way to identify the player (the others are forbidden by the type). */
+export type VoteIdentity = {
+    [K in keyof IdentityFields]: {
+        [P in K]: IdentityFields[P];
+    } & {
+        [P in Exclude<keyof IdentityFields, K>]?: never;
+    };
+}[keyof IdentityFields];
+export type Vote = {
+    id: string;
+    player: string;
+    verified: boolean;
+    createdAt: string;
+    claimableUntil: string;
+};
+export type VoteCheck = {
+    status: "CLAIMABLE" | "CLAIMED" | "NOT_FOUND";
+    vote: Vote | null;
+    /** Minutes before this player can vote again. */
+    nextVoteInMinutes: number;
+};
+export type VoteClaim = {
+    status: "CLAIMED_NOW" | "ALREADY_CLAIMED" | "NOT_FOUND";
+    vote: Vote | null;
+    /** Bonus rewards won in the draw (Premium / Enterprise servers), give them yourself. */
+    rewards?: Array<{
+        id: string;
+        name: string;
+    }>;
+};
+export type VoteListItem = {
+    id: string;
+    player: string;
+    verified: boolean;
+    steamId: string | null;
+    discordId: string | null;
+    uuid: string | null;
+    source: "WEB" | "DISCORD";
+    claimed: boolean;
+    createdAt: string;
+};
+export type VoteList = {
+    votes: VoteListItem[];
+    nextCursor: string | null;
+};
+export type VoteListParams = {
+    /** ISO date, default: last hour, at most 30 days back. */
+    since?: string | Date;
+    /** 1 to 100, default 50. */
+    limit?: number;
+    cursor?: string;
+};
+export type TopVotersPeriod = "current_month" | "last_month" | "all_time" | `${number}-${number}`;
+export type TopVoters = {
+    period: string;
+    players: Array<{
+        rank: number;
+        player: string;
+        votes: number;
+        verified: boolean;
+        lastVoteAt: string;
+    }>;
+};
+export type VoteStats = {
+    daily: Array<{
+        date: string;
+        votes: number;
+        views: number;
+        joinClicks: number;
+    }>;
+    weekly: Array<{
+        week: string;
+        votes: number;
+        views: number;
+        joinClicks: number;
+    }>;
+    monthly: Array<{
+        month: string;
+        votes: number;
+        views: number;
+        joinClicks: number;
+        rank: number | null;
+    }>;
+};
+export type VoteServer = {
+    id: string;
+    name: string | null;
+    game: Game;
+    url: string;
+    voteUrl: string;
+    verified: boolean;
+    addonConnected: boolean;
+    status: {
+        online: boolean;
+        players: number;
+        maxPlayers: number;
+        source: "ADDON" | "QUERY";
+    } | null;
+    votes: {
+        today: number;
+        month: number;
+        total: number;
+    };
+    ranking: {
+        votesRank: number | null;
+        votesRankOf: number;
+        flittScore: number;
+        badges: string[];
+    };
+    reviews: {
+        rating: number | null;
+        count: number;
+    };
+    stats?: VoteStats;
+};
+export type Review = {
+    id: string;
+    rating: number;
+    body: string;
+    author: string;
+    verifiedPlayer: boolean;
+    createdAt: string;
+    ownerReply: {
+        body: string;
+        createdAt: string | null;
+    } | null;
+};
+export type ReviewList = {
+    rating: number | null;
+    count: number;
+    reviews: Review[];
+    nextCursor: string | null;
+};
+export type ReviewListParams = {
+    /** 1 to 50, default 20. */
+    limit?: number;
+    cursor?: string;
+    sort?: "recent" | "rating_desc" | "rating_asc";
+};
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"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"}

package/dist/cjs/types.js

@@ -0,0 +1,7 @@
+"use strict";
+/**
+ * Response types of the Flitt Public API v1 (`/v1/public-api`) and of the
+ * Vote API (`/v1/vote-api`). Dates are ISO 8601 strings, as sent by the API.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/cjs/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":";AAAA;;;GAGG"}

package/dist/cjs/version.d.ts

@@ -0,0 +1,3 @@
+/** Package version, kept in sync with package.json by scripts/sync-version.mjs. */
+export declare const VERSION = "1.0.0";
+//# sourceMappingURL=version.d.ts.map

package/dist/cjs/version.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/cjs/version.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.VERSION = void 0;
+/** Package version, kept in sync with package.json by scripts/sync-version.mjs. */
+exports.VERSION = "1.0.0";
+//# sourceMappingURL=version.js.map

package/dist/cjs/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../../src/version.ts"],"names":[],"mappings":";;;AAAA,mFAAmF;AACtE,QAAA,OAAO,GAAG,OAAO,CAAC"}

package/dist/cjs/webhooks.d.ts

@@ -0,0 +1,40 @@
+import { FlittError } from "./errors.js";
+import type { WebhookEvent } from "./types.js";
+/** The webhook signature is missing, invalid, too old or already used. */
+export declare class FlittWebhookError extends FlittError {
+}
+export type HeaderSource = Headers | Record<string, string | string[] | undefined>;
+export type VerifyWebhookOptions = {
+    /** Raw request body, exactly as received (do not re-serialise parsed JSON). */
+    payload: string | Uint8Array | ArrayBuffer;
+    /** Request headers (Fetch `Headers`, or Node / Express `req.headers`). */
+    headers: HeaderSource;
+    /** Secret shown when you created the webhook in the dashboard. */
+    secret: string;
+    /** Maximum age of a delivery, in seconds. Default 300 (5 minutes). */
+    toleranceSec?: number;
+    /**
+     * Replay protection: return true if this nonce was already accepted (store
+     * it for `toleranceSec`). Optional, strongly recommended.
+     */
+    isReplay?: (nonce: string, webhookId: string | null) => boolean | Promise<boolean>;
+    /** Clock used for the age check, in ms. Default `Date.now()`. */
+    now?: number;
+};
+/**
+ * Checks that a webhook really comes from Flitt and returns the parsed event.
+ *
+ * Flitt signs `${timestamp}.${nonce}.${rawBody}` with HMAC-SHA256 and sends
+ * `X-Webhook-Signature: t=<ms>,v1=<hex>`, `X-Webhook-Nonce` and
+ * `X-Webhook-Timestamp`. Throws `FlittWebhookError` if anything is off.
+ *
+ * ```ts
+ * app.post("/flitt", express.raw({ type: "application/json" }), async (req, res) => {
+ *   const event = await verifyWebhook({ payload: req.body, headers: req.headers, secret: process.env.FLITT_WEBHOOK_SECRET! });
+ *   if (event.event === "server_down") alertTeam(event.server.name);
+ *   res.sendStatus(204);
+ * });
+ * ```
+ */
+export declare function verifyWebhook<T = Record<string, unknown> | null>(options: VerifyWebhookOptions): Promise<WebhookEvent<T>>;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/cjs/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,0EAA0E;AAC1E,qBAAa,iBAAkB,SAAQ,UAAU;CAAG;AAEpD,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;AAEnF,MAAM,MAAM,oBAAoB,GAAG;IACjC,+EAA+E;IAC/E,OAAO,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAC;IAC3C,0EAA0E;IAC1E,OAAO,EAAE,YAAY,CAAC;IACtB,kEAAkE;IAClE,MAAM,EAAE,MAAM,CAAC;IACf,sEAAsE;IACtE,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,KAAK,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACnF,iEAAiE;IACjE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd,CAAC;AA8BF;;;;;;;;;;;;;;GAcG;AACH,wBAAsB,aAAa,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,CA6C/H"}

package/dist/cjs/webhooks.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlittWebhookError = void 0;
+exports.verifyWebhook = verifyWebhook;
+const errors_js_1 = require("./errors.js");
+/** The webhook signature is missing, invalid, too old or already used. */
+class FlittWebhookError extends errors_js_1.FlittError {
+}
+exports.FlittWebhookError = FlittWebhookError;
+function header(headers, name) {
+    if (typeof headers.get === "function")
+        return headers.get(name);
+    const record = headers;
+    const key = Object.keys(record).find((k) => k.toLowerCase() === name.toLowerCase());
+    const value = key ? record[key] : undefined;
+    return Array.isArray(value) ? value[0] ?? null : value ?? null;
+}
+function toBytes(payload) {
+    if (typeof payload === "string")
+        return new TextEncoder().encode(payload);
+    return payload instanceof Uint8Array ? payload : new Uint8Array(payload);
+}
+/** Web Crypto: global in Node.js 20+, Deno, Bun, browsers and edge runtimes. */
+function subtle() {
+    const c = globalThis.crypto;
+    if (c?.subtle)
+        return c.subtle;
+    throw new FlittWebhookError("Web Crypto (globalThis.crypto.subtle) is not available: use Node.js 20 or newer.");
+}
+/** Constant-time comparison of two hex strings. */
+function safeEqualHex(a, b) {
+    if (a.length !== b.length)
+        return false;
+    let diff = 0;
+    for (let i = 0; i < a.length; i++)
+        diff |= a.charCodeAt(i) ^ b.charCodeAt(i);
+    return diff === 0;
+}
+/**
+ * Checks that a webhook really comes from Flitt and returns the parsed event.
+ *
+ * Flitt signs `${timestamp}.${nonce}.${rawBody}` with HMAC-SHA256 and sends
+ * `X-Webhook-Signature: t=<ms>,v1=<hex>`, `X-Webhook-Nonce` and
+ * `X-Webhook-Timestamp`. Throws `FlittWebhookError` if anything is off.
+ *
+ * ```ts
+ * app.post("/flitt", express.raw({ type: "application/json" }), async (req, res) => {
+ *   const event = await verifyWebhook({ payload: req.body, headers: req.headers, secret: process.env.FLITT_WEBHOOK_SECRET! });
+ *   if (event.event === "server_down") alertTeam(event.server.name);
+ *   res.sendStatus(204);
+ * });
+ * ```
+ */
+async function verifyWebhook(options) {
+    const secret = String(options.secret ?? "");
+    if (!secret)
+        throw new FlittWebhookError("Missing webhook secret.");
+    const signature = header(options.headers, "x-webhook-signature");
+    const nonce = header(options.headers, "x-webhook-nonce");
+    const webhookId = header(options.headers, "x-webhook-id");
+    if (!signature)
+        throw new FlittWebhookError("Missing X-Webhook-Signature header (is a secret set on this webhook?).");
+    if (!nonce || !/^[A-Za-z0-9_-]{8,128}$/.test(nonce))
+        throw new FlittWebhookError("Missing or invalid X-Webhook-Nonce header.");
+    const parts = Object.fromEntries(signature.split(",").map((p) => {
+        const i = p.indexOf("=");
+        return [p.slice(0, i).trim(), p.slice(i + 1).trim()];
+    }));
+    const timestamp = parts.t;
+    const expected = parts.v1;
+    if (!timestamp || !/^\d{10,16}$/.test(timestamp) || !expected || !/^[0-9a-f]{64}$/i.test(expected)) {
+        throw new FlittWebhookError("Malformed X-Webhook-Signature header.");
+    }
+    const toleranceMs = Math.max(1, options.toleranceSec ?? 300) * 1000;
+    const age = Math.abs((options.now ?? Date.now()) - Number(timestamp));
+    if (age > toleranceMs)
+        throw new FlittWebhookError("Webhook timestamp outside the tolerance window (replayed or clock skew).");
+    const body = toBytes(options.payload);
+    const prefix = new TextEncoder().encode(`${timestamp}.${nonce}.`);
+    const signed = new Uint8Array(prefix.length + body.length);
+    signed.set(prefix, 0);
+    signed.set(body, prefix.length);
+    const s = subtle();
+    const key = await s.importKey("raw", new TextEncoder().encode(secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+    const mac = new Uint8Array(await s.sign("HMAC", key, signed));
+    const actual = Array.from(mac, (b) => b.toString(16).padStart(2, "0")).join("");
+    if (!safeEqualHex(actual, expected.toLowerCase()))
+        throw new FlittWebhookError("Invalid webhook signature.");
+    if (options.isReplay && (await options.isReplay(nonce, webhookId)))
+        throw new FlittWebhookError("Webhook already processed (replayed nonce).");
+    try {
+        return JSON.parse(new TextDecoder().decode(body));
+    }
+    catch {
+        throw new FlittWebhookError("Webhook body is not valid JSON.");
+    }
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/cjs/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/webhooks.ts"],"names":[],"mappings":"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"}