@flitt/api 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,9 +1,14 @@
 # Changelog
 
-## 1.2.0 — 2026-09-30
+## 1.2.1 — 2026-10-01
+
+- Same content as 1.2.0, which could not be published (version number already used by a cancelled staged publish).
+
+## 1.2.0 — 2026-09-30 (not published)
 
 - `hold` on `servers.list()` items and `servers.get()`: maintenance, development or temporary closure set by the owner (`kind`, `message`, `since`, `until`), `null` otherwise. While set, the uptime is paused and up / down alerts are muted.
 - New webhook events `server_hold_started` and `server_hold_ended` in `WebhookEventType`.
+- README: list of webhook events with their `data`, and the Premium quota granted by a Server Premium server.
 
 ## 1.1.0 — 2026-09-29
 

package/README.md

@@ -61,6 +61,8 @@ const flitt = new Flitt({ serverToken: process.env.FLITT_SERVER_TOKEN });
 | Premium | 20,000 requests / month | 120 requests / minute |
 | Enterprise | Unlimited | 120 requests / minute |
 
+An account that owns a server with **Server Premium** (or a Flitt partner server) gets the Premium quota.
+
 The quota state of the last response is available on `flitt.rateLimit` (`{ limit, remaining, reset }`, `null` values meaning unlimited), or through the `onRateLimit` callback.
 
 ## Public API
@@ -242,6 +244,28 @@ export async function POST(request: Request) {
 }
 ```
 
+### Events
+
+Every event has the same envelope, typed as `WebhookEvent`: `{ event, timestamp, server: { id, name }, data }`.
+
+| Event | `data` |
+|---|---|
+| `server_down`, `server_down_addon`, `server_down_tcp`, `server_up`, `server_up_addon`, `server_up_tcp` | status change |
+| `player_peak`, `player_joined`, `player_left`, `player_first_join`, `player_chat` | player |
+| `review_created`, `vote_created` | review / vote |
+| `affluence_low`, `affluence_high` | `{ current, expectedP50, p10, p90, durationMinutes }` |
+| `server_hold_started` | `{ kind, message, until }` |
+| `server_hold_ended` | `{ kind, reason, durationMinutes }` (`reason`: `"manual"`, `"planned"` or `"max_duration"`) |
+
+`kind` is `"MAINTENANCE"`, `"DEVELOPMENT"` or `"CLOSED"`. While a server is on hold, the up / down events are not sent.
+
+```ts
+if (event.event === "server_hold_started") {
+  const { kind, until } = event.data as { kind: string; until: string | null };
+  console.log(`${event.server.name}: ${kind} until ${until ?? "further notice"}`);
+}
+```
+
 The signature is HMAC-SHA256 of `timestamp.nonce.body`, compared in constant time; deliveries older than 5 minutes are refused (`toleranceSec`).
 
 ## Errors

package/dist/cjs/version.d.ts

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

package/dist/cjs/version.js

@@ -2,5 +2,5 @@
 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.2.0";
+exports.VERSION = "1.2.1";
 //# sourceMappingURL=version.js.map

package/dist/esm/version.d.ts

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

package/dist/esm/version.js

@@ -1,3 +1,3 @@
 /** Package version, kept in sync with package.json by scripts/sync-version.mjs. */
-export const VERSION = "1.2.0";
+export const VERSION = "1.2.1";
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@flitt/api",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "Official TypeScript / JavaScript client for the Flitt Public API: servers, players, firewall, commands, Discord linking, votes and reviews (FiveM, Garry's Mod, Minecraft).",
   "keywords": [
     "flitt",

package/src/version.ts

@@ -1,2 +1,2 @@
 /** Package version, kept in sync with package.json by scripts/sync-version.mjs. */
-export const VERSION = "1.2.0";
+export const VERSION = "1.2.1";