@flitt/api 1.0.0

package/dist/cjs/client.js

@@ -0,0 +1,470 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FlittVotes = exports.Flitt = exports.DEFAULT_BASE_URL = void 0;
+const errors_js_1 = require("./errors.js");
+const http_js_1 = require("./http.js");
+exports.DEFAULT_BASE_URL = "https://api.flitt.me";
+const API_KEY_FORMAT = /^flt_[A-Za-z0-9_-]{30,120}$/;
+const VOTE_TOKEN_FORMAT = /^flv_[A-Za-z0-9_-]{40,60}$/;
+const INSPECT = Symbol.for("nodejs.util.inspect.custom");
+function envVar(name) {
+    const p = globalThis.process;
+    return p?.env?.[name];
+}
+function buildTransport(token, opts, unwrapData) {
+    if ((0, http_js_1.isBrowserLike)() && !opts.dangerouslyAllowBrowser) {
+        throw new errors_js_1.FlittConfigError("The Flitt client is running in a browser: your secret key would be exposed to every visitor. " +
+            "Call Flitt from your server (Node.js, Deno, Bun, a Worker…) or set dangerouslyAllowBrowser: true if you understand the risk.");
+    }
+    const num = (v, def, min, max, name) => {
+        if (v === undefined)
+            return def;
+        if (!Number.isFinite(v) || v < min || v > max)
+            throw new errors_js_1.FlittConfigError(`${name} must be between ${min} and ${max}.`);
+        return v;
+    };
+    return new http_js_1.Transport({
+        baseUrl: (0, http_js_1.normalizeBaseUrl)(opts.baseUrl ?? exports.DEFAULT_BASE_URL),
+        token,
+        timeoutMs: num(opts.timeoutMs, 15_000, 1, 600_000, "timeoutMs"),
+        maxRetries: num(opts.maxRetries, 2, 0, 10, "maxRetries"),
+        maxRetryDelayMs: num(opts.maxRetryDelayMs, 30_000, 0, 600_000, "maxRetryDelayMs"),
+        fetch: (0, http_js_1.resolveFetch)(opts.fetch),
+        userAgent: opts.userAgent,
+        unwrapData,
+        onRateLimit: opts.onRateLimit,
+    });
+}
+function positiveInt(value, name, max) {
+    if (value === undefined)
+        return undefined;
+    if (!Number.isInteger(value) || value < 1 || value > max)
+        throw new errors_js_1.FlittConfigError(`${name} must be an integer between 1 and ${max}.`);
+    return value;
+}
+// ===========================================================================
+// Public API client
+// ===========================================================================
+/**
+ * Client of the Flitt Public API v1.
+ *
+ * ```ts
+ * import { Flitt } from "@flitt/api";
+ * const flitt = new Flitt({ apiKey: process.env.FLITT_API_KEY });
+ * const { data } = await flitt.servers.list();
+ * ```
+ */
+class Flitt {
+    #http;
+    /** Your account's monthly quota. */
+    usage;
+    servers;
+    players;
+    firewall;
+    discord;
+    commands;
+    constructor(options = {}) {
+        const apiKey = (options.apiKey ?? envVar("FLITT_API_KEY") ?? "").trim();
+        if (!apiKey)
+            throw new errors_js_1.FlittConfigError("Missing API key: pass { apiKey } or set FLITT_API_KEY.");
+        if (!API_KEY_FORMAT.test(apiKey)) {
+            throw new errors_js_1.FlittConfigError(apiKey.startsWith("flv_")
+                ? "This is a Vote API token (flv_…): use `new FlittVotes({ token })` instead."
+                : "Invalid API key format: Flitt API keys start with flt_ (Profile → API).");
+        }
+        this.#http = buildTransport(apiKey, options, false);
+        const http = this.#http;
+        const base = "/v1/public-api";
+        this.usage = { get: async (o) => http.request("GET", `${base}/usage`, o) };
+        this.servers = new ServersResource(http, base);
+        this.players = new PlayersResource(http, base);
+        this.firewall = new FirewallResource(http, base);
+        this.discord = new DiscordResource(http, base);
+        this.commands = new CommandsResource(http, base);
+    }
+    /** Quota state from the last response (`null` before the first request). */
+    get rateLimit() {
+        return this.#http.lastRateLimit;
+    }
+    /** Never prints the key. */
+    toJSON() {
+        return { client: "Flitt", apiKey: "[redacted]" };
+    }
+    [INSPECT]() {
+        return "Flitt { apiKey: [redacted] }";
+    }
+}
+exports.Flitt = Flitt;
+class ServersResource {
+    http;
+    base;
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+    }
+    /** Servers you own or are a member of, newest first. `limit`: 1 to 100 (default 25). */
+    async list(params = {}, options) {
+        return this.http.request("GET", `${this.base}/servers`, {
+            ...options,
+            query: { page: positiveInt(params.page, "page", 1_000_000), limit: positiveInt(params.limit, "limit", 100) },
+        });
+    }
+    /** Iterates over every server, page after page. */
+    async *listAll(params = {}, options) {
+        for (let page = 1;; page++) {
+            const res = await this.list({ ...params, page }, options);
+            yield* res.data;
+            if (!res.data.length || (res.pagination.pages !== null && page >= res.pagination.pages))
+                return;
+        }
+    }
+    /** One server. IP, port and addon details are hidden for the VIEWER role. */
+    async get(serverId, options) {
+        const res = await this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}`, options);
+        return res.server;
+    }
+}
+class PlayersResource {
+    http;
+    base;
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+    }
+    /** Players of a server, last joined first. `limit`: 1 to 50 (default 15). */
+    async list(serverId, params = {}, options) {
+        return this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/players`, {
+            ...options,
+            query: {
+                page: positiveInt(params.page, "page", 1_000_000),
+                limit: positiveInt(params.limit, "limit", 50),
+                status: params.status,
+            },
+        });
+    }
+    /** Iterates over every player of a server. */
+    async *listAll(serverId, params = {}, options) {
+        const limit = params.limit ?? 50;
+        for (let page = 1;; page++) {
+            const res = await this.list(serverId, { ...params, limit, page }, options);
+            yield* res.players;
+            const pages = res.pagination.pages;
+            // Edge SDK servers do not report a total: stop on a short page.
+            if (!res.players.length || (pages !== null ? page >= pages : res.players.length < limit))
+                return;
+        }
+    }
+    /** One player, by Flitt player id or by external id (SteamID64, license, UUID…). */
+    async get(serverId, playerId, options) {
+        const res = await this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/players/${(0, http_js_1.segment)(playerId, "playerId")}`, options);
+        return res.player;
+    }
+}
+class FirewallResource {
+    http;
+    base;
+    rules;
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+        this.rules = new FirewallRulesResource(http, base);
+    }
+    /** Firewall settings and rule counts. */
+    async get(serverId, options) {
+        return this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall`, options);
+    }
+    /** Turns the firewall / VPN blocking on or off, changes the kick message. OWNER or ADMIN. */
+    async update(serverId, changes, options) {
+        if (changes.kickMessage !== undefined && changes.kickMessage.length > 300)
+            throw new errors_js_1.FlittConfigError("kickMessage: 300 characters max.");
+        await this.http.request("PATCH", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall`, { ...options, body: changes });
+    }
+    /** Latest blocked connections (1 to 200, default 50). */
+    async blocks(serverId, params = {}, options) {
+        const res = await this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall/blocks`, {
+            ...options,
+            query: { limit: positiveInt(params.limit, "limit", 200) },
+        });
+        return res.blocks;
+    }
+}
+class FirewallRulesResource {
+    http;
+    base;
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+    }
+    async list(serverId, query = {}, options) {
+        return this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall/rules`, {
+            ...options,
+            query: {
+                q: query.q,
+                action: query.action,
+                kind: query.kind,
+                page: positiveInt(query.page, "page", 1_000_000),
+                limit: positiveInt(query.limit, "limit", 100),
+            },
+        });
+    }
+    /**
+     * Adds one rule, or up to 100 in one call (e.g. to sync a ban list). OWNER
+     * or ADMIN. Partial success is possible: check `errors` in the result.
+     */
+    async create(serverId, rules, options) {
+        const list = Array.isArray(rules) ? rules : [rules];
+        if (!list.length || list.length > 100)
+            throw new errors_js_1.FlittConfigError("Provide 1 to 100 rules.");
+        for (const r of list) {
+            if (!r?.value || String(r.value).length > 128)
+                throw new errors_js_1.FlittConfigError("Each rule needs a value of 1 to 128 characters.");
+            if (r.note !== undefined && r.note.length > 120)
+                throw new errors_js_1.FlittConfigError("note: 120 characters max.");
+        }
+        return this.http
+            .request("POST", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall/rules`, {
+            ...options,
+            body: { rules: list },
+        })
+            .catch((err) => {
+            // Every rule refused (duplicates, plan limit…): the API answers 400
+            // with the per-rule errors. Return them like a partial success.
+            const details = err instanceof errors_js_1.FlittValidationError ? err.details : undefined;
+            if (details && Array.isArray(details.errors)) {
+                return { ok: false, created: Array.isArray(details.created) ? details.created : [], errors: details.errors };
+            }
+            throw err;
+        });
+    }
+    /** Removes one rule. */
+    async delete(serverId, ruleId, options) {
+        await this.http.request("DELETE", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall/rules/${(0, http_js_1.segment)(ruleId, "ruleId")}`, options);
+    }
+    /** Removes rules by ids (up to 500) and / or by action / kind. Returns the number deleted. */
+    async deleteMany(serverId, filter, options) {
+        if (!filter.ids?.length && !filter.action && !filter.kind) {
+            throw new errors_js_1.FlittConfigError("deleteMany needs ids, action or kind: refusing to delete every rule by accident.");
+        }
+        if (filter.ids && filter.ids.length > 500)
+            throw new errors_js_1.FlittConfigError("ids: 500 max per call.");
+        const res = await this.http.request("DELETE", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/firewall/rules`, {
+            ...options,
+            body: filter,
+        });
+        return res.deleted;
+    }
+}
+class DiscordResource {
+    http;
+    base;
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+    }
+    /** Discord module state of a server (for API-only setups, without the Flitt bot). */
+    async getModule(serverId, options) {
+        return this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/discord`, options);
+    }
+    /** Turns the addon's Discord module on or off. ADMIN. */
+    async setModule(serverId, enabled, options) {
+        return this.http.request("PATCH", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/discord`, { ...options, body: { enabled: Boolean(enabled) } });
+    }
+    /** Code a player types in game to link their Discord account (same flow as the bot's /link). */
+    async createLinkCode(discordId, options) {
+        return this.http.request("POST", `${this.base}/discord/link-codes`, { ...options, body: { discordId: snowflake(discordId) } });
+    }
+    /** Links of a Discord user or of a game identity, limited to players seen on your servers. */
+    async findLinks(query, options) {
+        const q = "discordId" in query ? { discordId: snowflake(query.discordId) } : { externalId: String(query.externalId ?? "").trim() };
+        if (!("discordId" in q) && !q.externalId)
+            throw new errors_js_1.FlittConfigError("Provide discordId or externalId.");
+        const res = await this.http.request("GET", `${this.base}/discord/links`, { ...options, query: q });
+        return res.links;
+    }
+    /** Links a player you verified yourself. The player must have joined the server. ADMIN. */
+    async link(serverId, input, options) {
+        const res = await this.http.request("POST", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/discord/links`, {
+            ...options,
+            body: { discordId: snowflake(input.discordId), externalId: input.externalId, ...(input.name ? { name: input.name } : {}) },
+        });
+        return res.link;
+    }
+    /** Removes the Discord link of a player. ADMIN. */
+    async unlink(serverId, externalId, options) {
+        const res = await this.http.request("DELETE", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/discord/links/${(0, http_js_1.segment)(externalId, "externalId")}`, options);
+        return res.deleted;
+    }
+}
+class CommandsResource {
+    http;
+    base;
+    constructor(http, base) {
+        this.http = http;
+        this.base = base;
+    }
+    /**
+     * Queues a command for the game server's addon. `chat` and `notify` need the
+     * EDITOR role, everything else ADMIN. Set `waitMs` (max 15000) to wait for
+     * the addon's answer. Not retried automatically: a retry could run it twice.
+     */
+    async send(serverId, input, options) {
+        if (input.waitMs !== undefined && (!Number.isInteger(input.waitMs) || input.waitMs < 0 || input.waitMs > 15_000)) {
+            throw new errors_js_1.FlittConfigError("waitMs must be an integer between 0 and 15000.");
+        }
+        return this.http.request("POST", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/commands`, {
+            ...options,
+            body: { type: input.type, payload: input.payload ?? {}, ...(input.waitMs !== undefined ? { waitMs: input.waitMs } : {}) },
+        });
+    }
+    /** Message in the game chat. */
+    async chat(serverId, text, options) {
+        return this.send(serverId, { type: "chat", payload: { text }, waitMs: options?.waitMs }, options);
+    }
+    /** Private message to one online player. */
+    async notify(serverId, externalId, message, options) {
+        return this.send(serverId, { type: "notify", payload: { externalId, message }, waitMs: options?.waitMs }, options);
+    }
+    async kick(serverId, externalId, reason, options) {
+        return this.send(serverId, { type: "kick", payload: { externalId, ...(reason ? { reason } : {}) }, waitMs: options?.waitMs }, options);
+    }
+    /** `durationSeconds`: 0 or omitted = permanent. */
+    async ban(serverId, externalId, params = {}, options) {
+        return this.send(serverId, { type: "ban", payload: { externalId, ...params }, waitMs: options?.waitMs }, options);
+    }
+    async unban(serverId, externalId, options) {
+        return this.send(serverId, { type: "unban", payload: { externalId }, waitMs: options?.waitMs }, options);
+    }
+    /** Adds (default) or removes an in-game group (ULX, SAM, CAMI, ace groups, LuckPerms or your hooks). */
+    async setGroup(serverId, externalId, group, params = {}, options) {
+        return this.send(serverId, { type: "set_group", payload: { externalId, group, add: params.add !== false }, waitMs: options?.waitMs }, options);
+    }
+    async setName(serverId, externalId, name, options) {
+        return this.send(serverId, { type: "set_name", payload: { externalId, name }, waitMs: options?.waitMs }, options);
+    }
+    /** Current in-game groups of the online players, as reported by the addon. */
+    async groups(serverId, options) {
+        return this.http.request("GET", `${this.base}/servers/${(0, http_js_1.segment)(serverId, "serverId")}/groups`, options);
+    }
+}
+function snowflake(value) {
+    const v = String(value ?? "").trim();
+    if (!/^\d{15,22}$/.test(v))
+        throw new errors_js_1.FlittConfigError("discordId must be a Discord user id (15 to 22 digits).");
+    return v;
+}
+// ===========================================================================
+// Vote API client
+// ===========================================================================
+const IDENTITY_PARAMS = {
+    player: "player",
+    steamId: "steam_id",
+    discordId: "discord_id",
+    license: "license",
+    uuid: "uuid",
+    ip: "ip",
+    voteId: "vote_id",
+};
+function identityParams(identity) {
+    const given = Object.entries(identity ?? {}).filter(([, v]) => v !== undefined && v !== null && String(v).trim() !== "");
+    if (given.length !== 1 || !(given[0][0] in IDENTITY_PARAMS)) {
+        throw new errors_js_1.FlittConfigError("Identify the player with exactly one of: player, steamId, discordId, license, uuid, ip, voteId.");
+    }
+    const [key, value] = given[0];
+    const v = String(value).trim();
+    if (v.length > 128)
+        throw new errors_js_1.FlittConfigError(`${key} is too long.`);
+    return { [IDENTITY_PARAMS[key]]: v };
+}
+/**
+ * Client of the Flitt Vote API: reward voters from your own scripts when the
+ * Flitt addon is not installed. One token = one server.
+ *
+ * ```ts
+ * import { FlittVotes } from "@flitt/api";
+ * const votes = new FlittVotes({ token: process.env.FLITT_VOTE_TOKEN });
+ * const claim = await votes.claim({ player: "Alex_RP" });
+ * if (claim.status === "CLAIMED_NOW") giveReward("Alex_RP");
+ * ```
+ */
+class FlittVotes {
+    #http;
+    constructor(options = {}) {
+        const token = (options.token ?? envVar("FLITT_VOTE_TOKEN") ?? "").trim();
+        if (!token)
+            throw new errors_js_1.FlittConfigError("Missing vote token: pass { token } or set FLITT_VOTE_TOKEN.");
+        if (!VOTE_TOKEN_FORMAT.test(token)) {
+            throw new errors_js_1.FlittConfigError(token.startsWith("flt_")
+                ? "This is a Public API key (flt_…): use `new Flitt({ apiKey })` instead."
+                : "Invalid vote token format: vote tokens start with flv_ (Dashboard → your server → Votes → Vote API).");
+        }
+        this.#http = buildTransport(token, options, true);
+    }
+    /** Quota state from the last response (120 requests / minute per token). */
+    get rateLimit() {
+        return this.#http.lastRateLimit;
+    }
+    /** Whether the player has a vote waiting to be claimed (last 24 h). */
+    async check(identity, options) {
+        return this.#http.request("GET", "/v1/vote-api/votes/check", { ...options, query: identityParams(identity) });
+    }
+    /**
+     * Claims the player's oldest unclaimed vote, exactly once across every
+     * channel (addon, API, NuVotifier). Give the reward only when `status` is
+     * `CLAIMED_NOW`. An idempotency key is generated so automatic retries can
+     * never claim twice; pass your own to make your retries safe too.
+     */
+    async claim(identity, options) {
+        const idempotencyKey = options?.idempotencyKey ?? (0, http_js_1.randomKey)();
+        if (idempotencyKey.length > 128)
+            throw new errors_js_1.FlittConfigError("idempotencyKey: 128 characters max.");
+        return this.#http.request("POST", "/v1/vote-api/votes/claim", { ...options, body: identityParams(identity), idempotencyKey });
+    }
+    /** Recent votes, oldest first (up to 30 days back), cursor pagination. */
+    async list(params = {}, options) {
+        return this.#http.request("GET", "/v1/vote-api/votes", {
+            ...options,
+            query: { since: params.since, limit: positiveInt(params.limit, "limit", 100), cursor: params.cursor },
+        });
+    }
+    /** Iterates over every vote since `since`. */
+    async *listAll(params = {}, options) {
+        let cursor;
+        for (;;) {
+            const res = await this.list({ ...params, cursor }, options);
+            yield* res.votes;
+            if (!res.nextCursor)
+                return;
+            cursor = res.nextCursor;
+        }
+    }
+    /** Top voters of a month (`current_month`, `last_month`, `all_time` or `YYYY-MM`). */
+    async top(params = {}, options) {
+        return this.#http.request("GET", "/v1/vote-api/votes/top", {
+            ...options,
+            query: { period: params.period, limit: positiveInt(params.limit, "limit", 50) },
+        });
+    }
+    /** Server info: status, votes, ranking, reviews (and stats with `includeStats`). */
+    async server(params = {}, options) {
+        return this.#http.request("GET", "/v1/vote-api/server", { ...options, query: { include: params.includeStats ? "stats" : undefined } });
+    }
+    /** Daily, weekly and monthly votes, page views and join clicks. */
+    async stats(options) {
+        return this.#http.request("GET", "/v1/vote-api/server/stats", options);
+    }
+    /** Published reviews of the server. */
+    async reviews(params = {}, options) {
+        return this.#http.request("GET", "/v1/vote-api/server/reviews", {
+            ...options,
+            query: { limit: positiveInt(params.limit, "limit", 50), cursor: params.cursor, sort: params.sort },
+        });
+    }
+    toJSON() {
+        return { client: "FlittVotes", token: "[redacted]" };
+    }
+    [INSPECT]() {
+        return "FlittVotes { token: [redacted] }";
+    }
+}
+exports.FlittVotes = FlittVotes;
+//# sourceMappingURL=client.js.map

package/dist/cjs/client.js.map

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

package/dist/cjs/errors.d.ts

@@ -0,0 +1,71 @@
+import type { RateLimit } from "./types.js";
+/** Base class of every error thrown by this package. */
+export declare class FlittError extends Error {
+    constructor(message: string, options?: {
+        cause?: unknown;
+    });
+}
+/** Invalid options or arguments, detected before any request is sent. */
+export declare class FlittConfigError extends FlittError {
+}
+/** The request never got an HTTP response (DNS, TLS, connection reset…). */
+export declare class FlittConnectionError extends FlittError {
+}
+/** No response within `timeoutMs`. */
+export declare class FlittTimeoutError extends FlittConnectionError {
+}
+/** The caller aborted the request with its AbortSignal. */
+export declare class FlittAbortError extends FlittError {
+}
+export type FlittAPIErrorInit = {
+    status: number;
+    code: string;
+    message: string;
+    details?: unknown;
+    method: string;
+    path: string;
+    rateLimit?: RateLimit | null;
+    retryAfterMs?: number | null;
+};
+/** The API answered with an error status. Never contains your API key. */
+export declare class FlittAPIError extends FlittError {
+    /** HTTP status code. */
+    readonly status: number;
+    /** Machine-readable code, e.g. `NOT_FOUND`, `PLAN_LIMIT`, `RATE_LIMITED`. */
+    readonly code: string;
+    /** Extra fields sent by the API, if any. */
+    readonly details: unknown;
+    /** HTTP method of the failed request. */
+    readonly method: string;
+    /** Path of the failed request, relative to the base URL (query string removed). */
+    readonly path: string;
+    /** Quota headers of the failed response, when present. */
+    readonly rateLimit: RateLimit | null;
+    /** Delay suggested by the API before retrying (Retry-After), in ms. */
+    readonly retryAfterMs: number | null;
+    constructor(init: FlittAPIErrorInit);
+}
+/** 400: missing, invalid or duplicated parameter. */
+export declare class FlittValidationError extends FlittAPIError {
+}
+/** 401: missing, invalid or revoked API key / vote token. */
+export declare class FlittAuthenticationError extends FlittAPIError {
+}
+/** 403: your plan or your role on the server does not allow this. */
+export declare class FlittPermissionError extends FlittAPIError {
+}
+/** 404: the resource does not exist or does not belong to you. */
+export declare class FlittNotFoundError extends FlittAPIError {
+}
+/** 409: conflict (rule already exists, server inactive…). */
+export declare class FlittConflictError extends FlittAPIError {
+}
+/** 429: quota or rate limit reached. See `retryAfterMs` and `rateLimit.reset`. */
+export declare class FlittRateLimitError extends FlittAPIError {
+}
+/** 5xx: temporary error on Flitt's side. Safe to retry later. */
+export declare class FlittServerError extends FlittAPIError {
+}
+/** Builds the most specific error class for a status code. */
+export declare function apiErrorFor(init: FlittAPIErrorInit): FlittAPIError;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAE5C,wDAAwD;AACxD,qBAAa,UAAW,SAAQ,KAAK;gBACvB,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE;CAO3D;AAED,yEAAyE;AACzE,qBAAa,gBAAiB,SAAQ,UAAU;CAAG;AAEnD,4EAA4E;AAC5E,qBAAa,oBAAqB,SAAQ,UAAU;CAAG;AAEvD,sCAAsC;AACtC,qBAAa,iBAAkB,SAAQ,oBAAoB;CAAG;AAE9D,2DAA2D;AAC3D,qBAAa,eAAgB,SAAQ,UAAU;CAAG;AAElD,MAAM,MAAM,iBAAiB,GAAG;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,SAAS,GAAG,IAAI,CAAC;IAC7B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B,CAAC;AAEF,0EAA0E;AAC1E,qBAAa,aAAc,SAAQ,UAAU;IAC3C,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,6EAA6E;IAC7E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,mFAAmF;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,0DAA0D;IAC1D,QAAQ,CAAC,SAAS,EAAE,SAAS,GAAG,IAAI,CAAC;IACrC,uEAAuE;IACvE,QAAQ,CAAC,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;gBAEzB,IAAI,EAAE,iBAAiB;CAUpC;AAED,qDAAqD;AACrD,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAC1D,6DAA6D;AAC7D,qBAAa,wBAAyB,SAAQ,aAAa;CAAG;AAC9D,qEAAqE;AACrE,qBAAa,oBAAqB,SAAQ,aAAa;CAAG;AAC1D,kEAAkE;AAClE,qBAAa,kBAAmB,SAAQ,aAAa;CAAG;AACxD,6DAA6D;AAC7D,qBAAa,kBAAmB,SAAQ,aAAa;CAAG;AACxD,kFAAkF;AAClF,qBAAa,mBAAoB,SAAQ,aAAa;CAAG;AACzD,iEAAiE;AACjE,qBAAa,gBAAiB,SAAQ,aAAa;CAAG;AAEtD,8DAA8D;AAC9D,wBAAgB,WAAW,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAUlE"}