astrocoins 2.1.0

package/README.md

@@ -0,0 +1,59 @@
+# astrocoins
+
+Node.js / TypeScript client for the AstroCoins API. A 1:1 port of the Python
+`astrocoins` library — it talks to the same REST endpoints
+(`GET /balance/:id`, `POST /add`, `POST /remove`, `POST /transfer`,
+`GET|POST /blacklist`, `GET|DELETE /blacklist/:id`) and maps HTTP errors to
+typed exceptions. No other logic.
+
+## Install (once published)
+
+```bash
+npm install astrocoins
+```
+
+## Usage
+
+```ts
+import {
+  AstroCoinsClient,
+  InsufficientFundsError,
+  BlacklistedError,
+} from "astrocoins";
+
+const client = new AstroCoinsClient({
+  apiKey: "your-api-key", // or set ASTROCOINS_API_KEY env var
+});
+
+const balance = await client.getBalance(123456789);
+console.log(balance);
+
+await client.addCoins(123456789, 50, "daily reward");
+
+try {
+  await client.removeCoins(123456789, 1000, "purchase");
+} catch (err) {
+  if (err instanceof InsufficientFundsError) {
+    console.log(`Only has ${err.available}, needed ${err.requested}`);
+  }
+}
+
+// Transfer coins between two users, within this key's wallet space
+const result = await client.transfer(123456789, 987654321, 25, "trade");
+console.log(result.from_balance, result.to_balance);
+
+// Per-key blacklist — blocks a user from send/receive through this key only
+await client.blacklistUser(123456789, "chargeback abuse");
+const blocked = await client.isBlacklisted(123456789);
+await client.unblacklistUser(123456789);
+
+try {
+  await client.addCoins(123456789, 50);
+} catch (err) {
+  if (err instanceof BlacklistedError) {
+    console.log(`${err.userId} is blacklisted: ${err.reason}`);
+  }
+}
+```
+
+Works with CommonJS `require("astrocoins")` too, since it compiles to CommonJS.

package/dist/client.d.ts

@@ -0,0 +1,48 @@
+export interface AstroCoinsClientOptions {
+    /** API key. Falls back to the ASTROCOINS_API_KEY env var if omitted. */
+    apiKey?: string;
+    /** Base URL for the API. Falls back to ASTROCOINS_BASE_URL, then a default. */
+    baseUrl?: string;
+    /** Request timeout in milliseconds. Default 8000. */
+    timeoutMs?: number;
+}
+export interface TransferResult {
+    from_user_id: number;
+    to_user_id: number;
+    amount: number;
+    from_balance: number;
+    to_balance: number;
+}
+export interface BlacklistEntry {
+    user_id: string;
+    reason: string;
+    added_at: number;
+}
+export declare class AstroCoinsClient {
+    readonly apiKey: string;
+    readonly baseUrl: string;
+    private readonly timeoutMs;
+    constructor(options?: AstroCoinsClientOptions);
+    private request;
+    private safeJson;
+    private safeText;
+    getBalance(userId: number): Promise<number>;
+    addCoins(userId: number, amount: number, reason?: string): Promise<number>;
+    removeCoins(userId: number, amount: number, reason?: string): Promise<number>;
+    /**
+     * Moves coins from one user to another within this key's wallet space.
+     * Throws BlacklistedError if either side is blacklisted for this key,
+     * InsufficientFundsError if the sender's balance isn't enough.
+     */
+    transfer(fromUserId: number, toUserId: number, amount: number, reason?: string): Promise<TransferResult>;
+    /**
+     * Blacklists a user within this key's wallet space only. They will no
+     * longer be able to send/receive coins through this key until removed
+     * with unblacklistUser.
+     */
+    blacklistUser(userId: number, reason?: string): Promise<void>;
+    unblacklistUser(userId: number): Promise<void>;
+    isBlacklisted(userId: number): Promise<boolean>;
+    /** Returns every blacklist entry for this key. */
+    listBlacklist(): Promise<BlacklistEntry[]>;
+}

package/dist/client.js

@@ -0,0 +1,149 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AstroCoinsClient = void 0;
+const errors_1 = require("./errors");
+const ENV_API_KEY = "ASTROCOINS_API_KEY";
+const ENV_BASE_URL = "ASTROCOINS_BASE_URL";
+const DEFAULT_BASE_URL = "https://astrobot.adevs.site/api/coins";
+class AstroCoinsClient {
+    constructor(options = {}) {
+        const apiKey = options.apiKey ??
+            (typeof process !== "undefined" ? process.env[ENV_API_KEY] : undefined);
+        if (!apiKey) {
+            throw new errors_1.ConfigurationError("An API key is required: pass { apiKey } or set the " +
+                `${ENV_API_KEY} environment variable. You can get a key ` +
+                "from an AstroCoins administrator.");
+        }
+        this.apiKey = apiKey;
+        const baseUrl = options.baseUrl ??
+            (typeof process !== "undefined" ? process.env[ENV_BASE_URL] : undefined) ??
+            DEFAULT_BASE_URL;
+        this.baseUrl = baseUrl.replace(/\/+$/, "");
+        this.timeoutMs = options.timeoutMs ?? 8000;
+    }
+    async request(method, path, body) {
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), this.timeoutMs);
+        let resp;
+        try {
+            resp = await fetch(`${this.baseUrl}${path}`, {
+                method,
+                headers: {
+                    "X-API-Key": this.apiKey,
+                    ...(body ? { "Content-Type": "application/json" } : {}),
+                },
+                body: body ? JSON.stringify(body) : undefined,
+                signal: controller.signal,
+            });
+        }
+        catch (exc) {
+            const reason = exc instanceof Error ? exc.message : String(exc);
+            throw new errors_1.APIError(0, `Could not connect to the AstroCoins server: ${reason}`);
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        if (resp.status === 401) {
+            throw new errors_1.AuthenticationError("The API key is invalid or has been revoked.");
+        }
+        if (resp.status === 429) {
+            throw new errors_1.RateLimitError("Daily limit for this key has been exceeded.");
+        }
+        if (resp.status === 403) {
+            const errBody = await this.safeJson(resp);
+            const blockedId = body
+                ?.user_id ??
+                body?.from_user_id ??
+                body?.to_user_id;
+            throw new errors_1.BlacklistedError(blockedId, errBody.error ?? "");
+        }
+        if (resp.status === 400 && body && "amount" in body) {
+            const errBody = await this.safeJson(resp);
+            if ("current_balance" in errBody) {
+                const subjectId = body.user_id ?? body.from_user_id;
+                throw new errors_1.InsufficientFundsError(subjectId, body.amount ?? 0, errBody.current_balance ?? 0);
+            }
+            const detail = errBody.error ?? errBody.detail ?? (await this.safeText(resp));
+            throw new errors_1.APIError(resp.status, detail);
+        }
+        if (!resp.ok) {
+            const errBody = await this.safeJson(resp);
+            const detail = errBody.error ?? errBody.detail ?? (await this.safeText(resp));
+            throw new errors_1.APIError(resp.status, detail);
+        }
+        return (await this.safeJson(resp));
+    }
+    async safeJson(resp) {
+        try {
+            return (await resp.clone().json());
+        }
+        catch {
+            return {};
+        }
+    }
+    async safeText(resp) {
+        try {
+            return await resp.text();
+        }
+        catch {
+            return "";
+        }
+    }
+    async getBalance(userId) {
+        const data = await this.request("GET", `/balance/${Math.trunc(userId)}`);
+        return data.balance ?? 0;
+    }
+    async addCoins(userId, amount, reason = "") {
+        const data = await this.request("POST", "/add", {
+            user_id: Math.trunc(userId),
+            amount: Math.trunc(amount),
+            reason,
+        });
+        return data.balance ?? 0;
+    }
+    async removeCoins(userId, amount, reason = "") {
+        const data = await this.request("POST", "/remove", {
+            user_id: Math.trunc(userId),
+            amount: Math.trunc(amount),
+            reason,
+        });
+        return data.balance ?? 0;
+    }
+    /**
+     * Moves coins from one user to another within this key's wallet space.
+     * Throws BlacklistedError if either side is blacklisted for this key,
+     * InsufficientFundsError if the sender's balance isn't enough.
+     */
+    async transfer(fromUserId, toUserId, amount, reason = "") {
+        return this.request("POST", "/transfer", {
+            from_user_id: Math.trunc(fromUserId),
+            to_user_id: Math.trunc(toUserId),
+            amount: Math.trunc(amount),
+            reason,
+        });
+    }
+    /**
+     * Blacklists a user within this key's wallet space only. They will no
+     * longer be able to send/receive coins through this key until removed
+     * with unblacklistUser.
+     */
+    async blacklistUser(userId, reason = "") {
+        await this.request("POST", "/blacklist", {
+            user_id: Math.trunc(userId),
+            reason,
+        });
+    }
+    async unblacklistUser(userId) {
+        await this.request("DELETE", `/blacklist/${Math.trunc(userId)}`);
+    }
+    async isBlacklisted(userId) {
+        const data = await this.request("GET", `/blacklist/${Math.trunc(userId)}`);
+        return data.blacklisted ?? false;
+    }
+    /** Returns every blacklist entry for this key. */
+    async listBlacklist() {
+        return this.request("GET", "/blacklist");
+    }
+}
+exports.AstroCoinsClient = AstroCoinsClient;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":";;;AAAA,qCAOkB;AAElB,MAAM,WAAW,GAAG,oBAAoB,CAAC;AACzC,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAE3C,MAAM,gBAAgB,GAAG,uCAAuC,CAAC;AA6CjE,MAAa,gBAAgB;IAK3B,YAAY,UAAmC,EAAE;QAC/C,MAAM,MAAM,GACV,OAAO,CAAC,MAAM;YACd,CAAC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;QAE1E,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,MAAM,IAAI,2BAAkB,CAC1B,qDAAqD;gBACnD,GAAG,WAAW,2CAA2C;gBACzD,mCAAmC,CACtC,CAAC;QACJ,CAAC;QACD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QAErB,MAAM,OAAO,GACX,OAAO,CAAC,OAAO;YACf,CAAC,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACxE,gBAAgB,CAAC;QACnB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAE3C,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC;IAC7C,CAAC;IAEO,KAAK,CAAC,OAAO,CACnB,MAAc,EACd,IAAY,EACZ,IAAkB;QAElB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAEnE,IAAI,IAAc,CAAC;QACnB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,KAAK,CAAC,GAAG,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,EAAE;gBAC3C,MAAM;gBACN,OAAO,EAAE;oBACP,WAAW,EAAE,IAAI,CAAC,MAAM;oBACxB,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACxD;gBACD,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,SAAS;gBAC7C,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAChE,MAAM,IAAI,iBAAQ,CAAC,CAAC,EAAE,+CAA+C,MAAM,EAAE,CAAC,CAAC;QACjF,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QAED,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,4BAAmB,CAAC,6CAA6C,CAAC,CAAC;QAC/E,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,IAAI,uBAAc,CAAC,6CAA6C,CAAC,CAAC;QAC1E,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACxB,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,SAAS,GACZ,IAAqF;gBACpF,EAAE,OAAO;gBACV,IAA8C,EAAE,YAAY;gBAC5D,IAA4C,EAAE,UAAU,CAAC;YAC5D,MAAM,IAAI,yBAAgB,CAAC,SAAS,EAAG,OAAO,CAAC,KAAgB,IAAI,EAAE,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,IAAI,IAAI,IAAI,QAAQ,IAAI,IAAI,EAAE,CAAC;YACpD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1C,IAAI,iBAAiB,IAAI,OAAO,EAAE,CAAC;gBACjC,MAAM,SAAS,GACZ,IAA6B,CAAC,OAAO,IAAK,IAAkC,CAAC,YAAY,CAAC;gBAC7F,MAAM,IAAI,+BAAsB,CAC9B,SAAmB,EACnB,IAAI,CAAC,MAAM,IAAI,CAAC,EACf,OAAO,CAAC,eAA0B,IAAI,CAAC,CACzC,CAAC;YACJ,CAAC;YACD,MAAM,MAAM,GAAI,OAAO,CAAC,KAAgB,IAAK,OAAO,CAAC,MAAiB,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACtG,MAAM,IAAI,iBAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC;YACb,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;YAC1C,MAAM,MAAM,GAAI,OAAO,CAAC,KAAgB,IAAK,OAAO,CAAC,MAAiB,IAAI,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC;YACtG,MAAM,IAAI,iBAAQ,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC1C,CAAC;QAED,OAAO,CAAC,MAAM,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAM,CAAC;IAC1C,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAc;QACnC,IAAI,CAAC;YACH,OAAO,CAAC,MAAM,IAAI,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,CAA4B,CAAC;QAChE,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,QAAQ,CAAC,IAAc;QACnC,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAC,IAAI,EAAE,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED,KAAK,CAAC,UAAU,CAAC,MAAc;QAC7B,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,KAAK,EACL,YAAY,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CACjC,CAAC;QACF,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,MAAc,EAAE,MAAc,EAAE,MAAM,GAAG,EAAE;QACxD,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAuB,MAAM,EAAE,MAAM,EAAE;YACpE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,MAAM;SACP,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,MAAc,EAAE,MAAc,EAAE,MAAM,GAAG,EAAE;QAC3D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAAuB,MAAM,EAAE,SAAS,EAAE;YACvE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC3B,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,MAAM;SACP,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;IAC3B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,QAAQ,CACZ,UAAkB,EAClB,QAAgB,EAChB,MAAc,EACd,MAAM,GAAG,EAAE;QAEX,OAAO,IAAI,CAAC,OAAO,CAAiB,MAAM,EAAE,WAAW,EAAE;YACvD,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC;YACpC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;YAChC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC1B,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,aAAa,CAAC,MAAc,EAAE,MAAM,GAAG,EAAE;QAC7C,MAAM,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE;YACvC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC;YAC3B,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,MAAc;QAClC,MAAM,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,cAAc,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IACnE,CAAC;IAED,KAAK,CAAC,aAAa,CAAC,MAAc;QAChC,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,OAAO,CAC7B,KAAK,EACL,cAAc,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CACnC,CAAC;QACF,OAAO,IAAI,CAAC,WAAW,IAAI,KAAK,CAAC;IACnC,CAAC;IAED,kDAAkD;IAClD,KAAK,CAAC,aAAa;QACjB,OAAO,IAAI,CAAC,OAAO,CAAmB,KAAK,EAAE,YAAY,CAAC,CAAC;IAC7D,CAAC;CACF;AArLD,4CAqLC"}

package/dist/errors.d.ts

@@ -0,0 +1,28 @@
+export declare class AstroCoinsError extends Error {
+    constructor(message: string);
+}
+export declare class ConfigurationError extends AstroCoinsError {
+    constructor(message: string);
+}
+export declare class AuthenticationError extends AstroCoinsError {
+    constructor(message: string);
+}
+export declare class InsufficientFundsError extends AstroCoinsError {
+    readonly userId: number;
+    readonly requested: number;
+    readonly available: number;
+    constructor(userId: number, requested: number, available: number);
+}
+export declare class RateLimitError extends AstroCoinsError {
+    constructor(message: string);
+}
+export declare class BlacklistedError extends AstroCoinsError {
+    readonly userId?: number;
+    readonly reason: string;
+    constructor(userId: number | undefined, reason?: string);
+}
+export declare class APIError extends AstroCoinsError {
+    readonly statusCode: number;
+    readonly detail: string;
+    constructor(statusCode: number, detail: string);
+}

package/dist/errors.js

@@ -0,0 +1,70 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.APIError = exports.BlacklistedError = exports.RateLimitError = exports.InsufficientFundsError = exports.AuthenticationError = exports.ConfigurationError = exports.AstroCoinsError = void 0;
+class AstroCoinsError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "AstroCoinsError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.AstroCoinsError = AstroCoinsError;
+class ConfigurationError extends AstroCoinsError {
+    constructor(message) {
+        super(message);
+        this.name = "ConfigurationError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.ConfigurationError = ConfigurationError;
+class AuthenticationError extends AstroCoinsError {
+    constructor(message) {
+        super(message);
+        this.name = "AuthenticationError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.AuthenticationError = AuthenticationError;
+class InsufficientFundsError extends AstroCoinsError {
+    constructor(userId, requested, available) {
+        super(`User ${userId} has ${available} coins, which is not enough to cover ${requested}.`);
+        this.name = "InsufficientFundsError";
+        this.userId = userId;
+        this.requested = requested;
+        this.available = available;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.InsufficientFundsError = InsufficientFundsError;
+class RateLimitError extends AstroCoinsError {
+    constructor(message) {
+        super(message);
+        this.name = "RateLimitError";
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.RateLimitError = RateLimitError;
+class BlacklistedError extends AstroCoinsError {
+    constructor(userId, reason = "") {
+        let message = `User ${userId ?? "unknown"} is blacklisted for this API key.`;
+        if (reason)
+            message += ` Reason: ${reason}`;
+        super(message);
+        this.name = "BlacklistedError";
+        this.userId = userId;
+        this.reason = reason;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.BlacklistedError = BlacklistedError;
+class APIError extends AstroCoinsError {
+    constructor(statusCode, detail) {
+        super(`AstroCoins API error (${statusCode}): ${detail}`);
+        this.name = "APIError";
+        this.statusCode = statusCode;
+        this.detail = detail;
+        Object.setPrototypeOf(this, new.target.prototype);
+    }
+}
+exports.APIError = APIError;
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA,MAAa,eAAgB,SAAQ,KAAK;IACxC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;QAC9B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,0CAMC;AAED,MAAa,kBAAmB,SAAQ,eAAe;IACrD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,gDAMC;AAED,MAAa,mBAAoB,SAAQ,eAAe;IACtD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;QAClC,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,kDAMC;AAED,MAAa,sBAAuB,SAAQ,eAAe;IAKzD,YAAY,MAAc,EAAE,SAAiB,EAAE,SAAiB;QAC9D,KAAK,CACH,QAAQ,MAAM,QAAQ,SAAS,wCAAwC,SAAS,GAAG,CACpF,CAAC;QACF,IAAI,CAAC,IAAI,GAAG,wBAAwB,CAAC;QACrC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAfD,wDAeC;AAED,MAAa,cAAe,SAAQ,eAAe;IACjD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;QAC7B,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAND,wCAMC;AAED,MAAa,gBAAiB,SAAQ,eAAe;IAInD,YAAY,MAA0B,EAAE,MAAM,GAAG,EAAE;QACjD,IAAI,OAAO,GAAG,QAAQ,MAAM,IAAI,SAAS,mCAAmC,CAAC;QAC7E,IAAI,MAAM;YAAE,OAAO,IAAI,YAAY,MAAM,EAAE,CAAC;QAC5C,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAbD,4CAaC;AAED,MAAa,QAAS,SAAQ,eAAe;IAI3C,YAAY,UAAkB,EAAE,MAAc;QAC5C,KAAK,CAAC,yBAAyB,UAAU,MAAM,MAAM,EAAE,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;QAC7B,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,CAAC,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACpD,CAAC;CACF;AAXD,4BAWC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { AstroCoinsClient, AstroCoinsClientOptions, TransferResult, BlacklistEntry, } from "./client";
+export { AstroCoinsError, ConfigurationError, AuthenticationError, InsufficientFundsError, RateLimitError, APIError, BlacklistedError, } from "./errors";

package/dist/index.js

@@ -0,0 +1,14 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlacklistedError = exports.APIError = exports.RateLimitError = exports.InsufficientFundsError = exports.AuthenticationError = exports.ConfigurationError = exports.AstroCoinsError = exports.AstroCoinsClient = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "AstroCoinsClient", { enumerable: true, get: function () { return client_1.AstroCoinsClient; } });
+var errors_1 = require("./errors");
+Object.defineProperty(exports, "AstroCoinsError", { enumerable: true, get: function () { return errors_1.AstroCoinsError; } });
+Object.defineProperty(exports, "ConfigurationError", { enumerable: true, get: function () { return errors_1.ConfigurationError; } });
+Object.defineProperty(exports, "AuthenticationError", { enumerable: true, get: function () { return errors_1.AuthenticationError; } });
+Object.defineProperty(exports, "InsufficientFundsError", { enumerable: true, get: function () { return errors_1.InsufficientFundsError; } });
+Object.defineProperty(exports, "RateLimitError", { enumerable: true, get: function () { return errors_1.RateLimitError; } });
+Object.defineProperty(exports, "APIError", { enumerable: true, get: function () { return errors_1.APIError; } });
+Object.defineProperty(exports, "BlacklistedError", { enumerable: true, get: function () { return errors_1.BlacklistedError; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,mCAKkB;AAJhB,0GAAA,gBAAgB,OAAA;AAKlB,mCAQkB;AAPhB,yGAAA,eAAe,OAAA;AACf,4GAAA,kBAAkB,OAAA;AAClB,6GAAA,mBAAmB,OAAA;AACnB,gHAAA,sBAAsB,OAAA;AACtB,wGAAA,cAAc,OAAA;AACd,kGAAA,QAAQ,OAAA;AACR,0GAAA,gBAAgB,OAAA"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "astrocoins",
+  "version": "2.1.0",
+  "description": "Node.js/TypeScript client for the AstroCoins API",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "type": "commonjs",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "astrocoins",
+    "api-client",
+    "discord"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "typescript": "^5.5.4",
+    "@types/node": "^20.14.9"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}