@noctaly/sdk 1.0.0

package/dist/index.cjs

@@ -0,0 +1,370 @@
+'use strict';
+
+// src/errors.ts
+var NoctalyError = class extends Error {
+  /**
+   * Machine-readable error code.
+   */
+  code;
+  /**
+   * HTTP status code.
+   */
+  status;
+  /**
+   * Seconds to wait before retrying. Only present when `code` is
+   * `"rate_limited"`.
+   */
+  retryAfter;
+  /**
+   * `true` when the rate limit that was exceeded is the global one.
+   * Only present when `code` is `"rate_limited"`.
+   */
+  global;
+  /**
+   * Zod validation issues. Only present when `code` is
+   * `"validation_error"`.
+   */
+  details;
+  constructor(opts) {
+    super(opts.message);
+    this.name = "NoctalyError";
+    this.code = opts.code;
+    this.status = opts.status;
+    if (opts.retryAfter !== void 0) this.retryAfter = opts.retryAfter;
+    if (opts.global !== void 0) this.global = opts.global;
+    if (opts.details !== void 0) this.details = opts.details;
+  }
+};
+
+// src/request.ts
+var MAX_RETRY_DELAY_MS = 6e4;
+async function sleep(ms) {
+  return new Promise((resolve) => {
+    setTimeout(resolve, ms);
+  });
+}
+function parseRateLimitHeaders(headers) {
+  const limit = headers.get("X-RateLimit-Limit");
+  const remaining = headers.get("X-RateLimit-Remaining");
+  const reset = headers.get("X-RateLimit-Reset");
+  const resetAfter = headers.get("X-RateLimit-Reset-After");
+  if (!limit || !remaining || !reset || !resetAfter) return void 0;
+  return {
+    limit: Number(limit),
+    remaining: Number(remaining),
+    reset: Number(reset),
+    resetAfter: Number(resetAfter)
+  };
+}
+async function executeRequest(url, opts, config) {
+  const signal = config.timeout > 0 ? AbortSignal.timeout(config.timeout) : void 0;
+  return fetch(url, {
+    method: opts.method ?? "GET",
+    headers: {
+      Authorization: config.apiKey,
+      "Content-Type": "application/json",
+      "User-Agent": "@noctaly/sdk"
+    },
+    signal,
+    ...opts.body === void 0 ? {} : { body: JSON.stringify(opts.body) }
+  });
+}
+async function request(path, opts, config, attempt = 0) {
+  let url = `${config.baseURL}${path}`;
+  if (opts.query) {
+    const params = new URLSearchParams();
+    for (const [key, value] of Object.entries(opts.query)) {
+      if (value !== void 0 && value !== false) {
+        params.set(key, String(value));
+      }
+    }
+    const qs = params.toString();
+    if (qs) url += `?${qs}`;
+  }
+  const res = await executeRequest(url, opts, config);
+  const json = await res.json();
+  if (!res.ok) {
+    const err = json;
+    if (res.status === 429 && config.retry && attempt < config.maxRetries) {
+      const delayMs = Math.min((err.retryAfter ?? 1) * 1e3, MAX_RETRY_DELAY_MS);
+      await sleep(delayMs);
+      return request(path, opts, config, attempt + 1);
+    }
+    throw new NoctalyError({
+      code: err.code,
+      message: err.message,
+      status: res.status,
+      ...err.retryAfter === void 0 ? {} : { retryAfter: err.retryAfter },
+      ...err.global === void 0 ? {} : { global: err.global },
+      ...err.details === void 0 ? {} : { details: err.details }
+    });
+  }
+  const rateLimit = parseRateLimitHeaders(res.headers);
+  const response = { data: json };
+  if (rateLimit !== void 0) response.rateLimit = rateLimit;
+  return response;
+}
+
+// src/resources/GuildChestsResource.ts
+var GuildChestsResource = class {
+  #guildID;
+  #config;
+  constructor(guildID, config) {
+    this.#guildID = guildID;
+    this.#config = config;
+  }
+  /**
+   * Returns all chests configured in the guild's economy.
+   *
+   * `GET /guilds/{guildID}/chests`
+   */
+  async list() {
+    return request(`/guilds/${this.#guildID}/chests`, {}, this.#config);
+  }
+};
+
+// src/resources/GuildItemsResource.ts
+var GuildItemsResource = class {
+  #guildID;
+  #config;
+  constructor(guildID, config) {
+    this.#guildID = guildID;
+    this.#config = config;
+  }
+  /**
+   * Returns all items configured in the guild's economy.
+   *
+   * `GET /guilds/{guildID}/items`
+   */
+  async list() {
+    return request(`/guilds/${this.#guildID}/items`, {}, this.#config);
+  }
+};
+
+// src/resources/UserChestsResource.ts
+var UserChestsResource = class {
+  #guildID;
+  #userID;
+  #config;
+  constructor(guildID, userID, config) {
+    this.#guildID = guildID;
+    this.#userID = userID;
+    this.#config = config;
+  }
+  /**
+   * Adds a quantity of a chest to the member's inventory.
+   *
+   * `POST /guilds/{guildID}/users/{userID}/chests`
+   */
+  async add(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/chests`, { method: "POST", body }, this.#config);
+  }
+  /**
+   * Removes a quantity of a chest from the member's inventory. If the
+   * resulting quantity reaches `0` or below the chest is removed entirely.
+   *
+   * `DELETE /guilds/{guildID}/users/{userID}/chests`
+   */
+  async remove(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/chests`, { method: "DELETE", body }, this.#config);
+  }
+  /**
+   * Sets the exact quantity of a chest in the member's inventory.
+   * Passing `0` removes the chest entirely.
+   *
+   * `PUT /guilds/{guildID}/users/{userID}/chests`
+   */
+  async set(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/chests`, { method: "PUT", body }, this.#config);
+  }
+};
+
+// src/resources/UserItemsResource.ts
+var UserItemsResource = class {
+  #guildID;
+  #userID;
+  #config;
+  constructor(guildID, userID, config) {
+    this.#guildID = guildID;
+    this.#userID = userID;
+    this.#config = config;
+  }
+  /**
+   * Adds a quantity of an item to the member's inventory.
+   *
+   * `POST /guilds/{guildID}/users/{userID}/items`
+   */
+  async add(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/items`, { method: "POST", body }, this.#config);
+  }
+  /**
+   * Removes a quantity of an item from the member's inventory. If the
+   * resulting quantity reaches `0` or below the item is removed entirely.
+   *
+   * `DELETE /guilds/{guildID}/users/{userID}/items`
+   */
+  async remove(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/items`, { method: "DELETE", body }, this.#config);
+  }
+  /**
+   * Sets the exact quantity of an item in the member's inventory.
+   * Passing `0` removes the item entirely.
+   *
+   * `PUT /guilds/{guildID}/users/{userID}/items`
+   */
+  async set(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/items`, { method: "PUT", body }, this.#config);
+  }
+  /**
+   * Triggers the item's configured actions (give/remove money, XP, roles,
+   * other items…). Only works for items of type `CUSTOM` with at least one
+   * action. The item is consumed unless it has the `KEEP_AFTER_USE` flag.
+   *
+   * `POST /guilds/{guildID}/users/{userID}/items/{itemID}/use`
+   */
+  async use(itemID, body = {}) {
+    return request(
+      `/guilds/${this.#guildID}/users/${this.#userID}/items/${itemID}/use`,
+      { method: "POST", body },
+      this.#config
+    );
+  }
+};
+
+// src/resources/UserResource.ts
+var UserResource = class {
+  /**
+   * Item inventory operations for this member.
+   */
+  items;
+  /**
+   * Chest inventory operations for this member.
+   */
+  chests;
+  #guildID;
+  #userID;
+  #config;
+  constructor(guildID, userID, config) {
+    this.#guildID = guildID;
+    this.#userID = userID;
+    this.#config = config;
+    this.items = new UserItemsResource(guildID, userID, config);
+    this.chests = new UserChestsResource(guildID, userID, config);
+  }
+  async getEcoProfile(options) {
+    return request(
+      `/guilds/${this.#guildID}/users/${this.#userID}/eco-profile`,
+      {
+        query: {
+          items: options?.items,
+          chests: options?.chests,
+          dailyStreak: options?.dailyStreak
+        }
+      },
+      this.#config
+    );
+  }
+  /**
+   * Returns the member's full levelling profile.
+   *
+   * `GET /guilds/{guildID}/users/{userID}/level-profile`
+   */
+  async getLevelProfile() {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/level-profile`, {}, this.#config);
+  }
+  /**
+   * Adds or removes XP from the member.
+   *
+   * `POST /guilds/{guildID}/users/{userID}/xp`
+   */
+  async updateXP(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/xp`, { method: "POST", body }, this.#config);
+  }
+  /**
+   * Adds or removes levels from the member.
+   *
+   * `POST /guilds/{guildID}/users/{userID}/level`
+   */
+  async updateLevel(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/level`, { method: "POST", body }, this.#config);
+  }
+  /**
+   * Adds or removes money from the member.
+   *
+   * `POST /guilds/{guildID}/users/{userID}/money`
+   */
+  async updateMoney(body) {
+    return request(`/guilds/${this.#guildID}/users/${this.#userID}/money`, { method: "POST", body }, this.#config);
+  }
+};
+
+// src/resources/GuildResource.ts
+var GuildResource = class {
+  #guildID;
+  #config;
+  /**
+   * Guild-wide item catalogue operations.
+   */
+  items;
+  /**
+   * Guild-wide chest catalogue operations.
+   */
+  chests;
+  constructor(guildID, config) {
+    this.#guildID = guildID;
+    this.#config = config;
+    this.items = new GuildItemsResource(guildID, config);
+    this.chests = new GuildChestsResource(guildID, config);
+  }
+  /**
+   * Returns a {@link UserResource} scoped to the given guild member.
+   *
+   * @param userID - Discord user ID of the member.
+   */
+  users(userID) {
+    return new UserResource(this.#guildID, userID, this.#config);
+  }
+};
+
+// src/client.ts
+var DEFAULT_BASE_URL = "https://noctaly.com/api/v1";
+var DEFAULT_TIMEOUT = 3e4;
+var DEFAULT_MAX_RETRIES = 3;
+var NoctalyClient = class {
+  #config;
+  constructor({
+    apiKey,
+    baseURL = DEFAULT_BASE_URL,
+    timeout = DEFAULT_TIMEOUT,
+    retry = true,
+    maxRetries = DEFAULT_MAX_RETRIES
+  }) {
+    if (!apiKey) throw new Error("apiKey is required.");
+    this.#config = {
+      apiKey,
+      baseURL: baseURL.replace(/\/$/, ""),
+      timeout,
+      retry,
+      maxRetries
+    };
+  }
+  /**
+   * Returns a {@link GuildResource} scoped to the given guild.
+   *
+   * @param guildID - Discord guild (server) ID.
+   */
+  guilds(guildID) {
+    return new GuildResource(guildID, this.#config);
+  }
+};
+
+exports.GuildChestsResource = GuildChestsResource;
+exports.GuildItemsResource = GuildItemsResource;
+exports.GuildResource = GuildResource;
+exports.NoctalyClient = NoctalyClient;
+exports.NoctalyError = NoctalyError;
+exports.UserChestsResource = UserChestsResource;
+exports.UserItemsResource = UserItemsResource;
+exports.UserResource = UserResource;
+//# sourceMappingURL=index.cjs.map
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/request.ts","../src/resources/GuildChestsResource.ts","../src/resources/GuildItemsResource.ts","../src/resources/UserChestsResource.ts","../src/resources/UserItemsResource.ts","../src/resources/UserResource.ts","../src/resources/GuildResource.ts","../src/client.ts"],"names":[],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * All possible error codes returned by the Noctaly API.\n */\nexport type ApiErrorCode =\n\t| \"module_disabled\"\n\t| \"not_found\"\n\t| \"rate_limited\"\n\t| \"unauthenticated\"\n\t| \"unauthorized\"\n\t| \"unexpected_error\"\n\t| \"validation_error\";\n\n/**\n * A single Zod validation issue surfaced by the API.\n */\nexport interface ValidationIssue {\n\t/**\n\t * Zod error code.\n\t */\n\tcode: string;\n\t/**\n\t * Human-readable error message.\n\t */\n\tmessage: string;\n\t/**\n\t * Path to the field that failed validation.\n\t */\n\tpath: (number | string)[];\n}\n\n/**\n * Thrown by all SDK methods on a non-2xx API response.\n */\nexport class NoctalyError extends Error {\n\t/**\n\t * Machine-readable error code.\n\t */\n\tpublic readonly code: ApiErrorCode;\n\n\t/**\n\t * HTTP status code.\n\t */\n\tpublic readonly status: number;\n\n\t/**\n\t * Seconds to wait before retrying. Only present when `code` is\n\t * `\"rate_limited\"`.\n\t */\n\tpublic readonly retryAfter?: number;\n\n\t/**\n\t * `true` when the rate limit that was exceeded is the global one.\n\t * Only present when `code` is `\"rate_limited\"`.\n\t */\n\tpublic readonly global?: boolean;\n\n\t/**\n\t * Zod validation issues. Only present when `code` is\n\t * `\"validation_error\"`.\n\t */\n\tpublic readonly details?: ValidationIssue[];\n\n\tpublic constructor(opts: {\n\t\tcode: ApiErrorCode;\n\t\tdetails?: ValidationIssue[];\n\t\tglobal?: boolean;\n\t\tmessage: string;\n\t\tretryAfter?: number;\n\t\tstatus: number;\n\t}) {\n\t\tsuper(opts.message);\n\t\tthis.name = \"NoctalyError\";\n\t\tthis.code = opts.code;\n\t\tthis.status = opts.status;\n\t\tif (opts.retryAfter !== undefined) this.retryAfter = opts.retryAfter;\n\t\tif (opts.global !== undefined) this.global = opts.global;\n\t\tif (opts.details !== undefined) this.details = opts.details;\n\t}\n}\n","import type { ClientConfig } from \"./config.js\";\nimport type { ApiErrorCode, ValidationIssue } from \"./errors.js\";\nimport { NoctalyError } from \"./errors.js\";\nimport type { RateLimitInfo } from \"./types.js\";\n\ninterface ErrorBody {\n\tcode: string;\n\tdetails?: ValidationIssue[];\n\tglobal?: boolean;\n\tmessage: string;\n\tretryAfter?: number;\n}\n\nexport interface RequestOptions {\n\tbody?: unknown;\n\tmethod?: \"DELETE\" | \"GET\" | \"POST\" | \"PUT\";\n\t/**\n\t * Query-string parameters. `false` and `undefined` values are omitted.\n\t */\n\tquery?: Record<string, boolean | string | undefined>;\n}\n\nexport interface NoctalyResponse<T> {\n\t/**\n\t * The parsed response data.\n\t */\n\tdata: T;\n\t/**\n\t * Rate-limit info from the response headers.\n\t * Present on all successful responses that include rate-limit headers.\n\t */\n\trateLimit?: RateLimitInfo;\n}\n\n/**\n * Maximum seconds to honour from a `retryAfter` field before capping.\n */\nconst MAX_RETRY_DELAY_MS = 60_000;\n\nasync function sleep(ms: number): Promise<void> {\n\treturn new Promise((resolve) => {\n\t\tsetTimeout(resolve, ms);\n\t});\n}\n\nfunction parseRateLimitHeaders(headers: Headers): RateLimitInfo | undefined {\n\tconst limit = headers.get(\"X-RateLimit-Limit\");\n\tconst remaining = headers.get(\"X-RateLimit-Remaining\");\n\tconst reset = headers.get(\"X-RateLimit-Reset\");\n\tconst resetAfter = headers.get(\"X-RateLimit-Reset-After\");\n\n\tif (!limit || !remaining || !reset || !resetAfter) return undefined;\n\n\treturn {\n\t\tlimit: Number(limit),\n\t\tremaining: Number(remaining),\n\t\treset: Number(reset),\n\t\tresetAfter: Number(resetAfter),\n\t};\n}\n\nasync function executeRequest(url: string, opts: RequestOptions, config: ClientConfig): Promise<Response> {\n\tconst signal = config.timeout > 0 ? AbortSignal.timeout(config.timeout) : undefined;\n\n\treturn fetch(url, {\n\t\tmethod: opts.method ?? \"GET\",\n\t\theaders: {\n\t\t\tAuthorization: config.apiKey,\n\t\t\t\"Content-Type\": \"application/json\",\n\t\t\t\"User-Agent\": \"@noctaly/sdk\",\n\t\t},\n\t\tsignal,\n\t\t...(opts.body === undefined ? {} : { body: JSON.stringify(opts.body) }),\n\t});\n}\n\nexport async function request<T>(\n\tpath: string,\n\topts: RequestOptions,\n\tconfig: ClientConfig,\n\tattempt = 0,\n): Promise<NoctalyResponse<T>> {\n\tlet url = `${config.baseURL}${path}`;\n\n\tif (opts.query) {\n\t\tconst params = new URLSearchParams();\n\t\tfor (const [key, value] of Object.entries(opts.query)) {\n\t\t\tif (value !== undefined && value !== false) {\n\t\t\t\tparams.set(key, String(value));\n\t\t\t}\n\t\t}\n\n\t\tconst qs = params.toString();\n\t\tif (qs) url += `?${qs}`;\n\t}\n\n\tconst res = await executeRequest(url, opts, config);\n\tconst json = (await res.json()) as unknown;\n\n\tif (!res.ok) {\n\t\tconst err = json as ErrorBody;\n\n\t\tif (res.status === 429 && config.retry && attempt < config.maxRetries) {\n\t\t\tconst delayMs = Math.min((err.retryAfter ?? 1) * 1_000, MAX_RETRY_DELAY_MS);\n\t\t\tawait sleep(delayMs);\n\t\t\treturn request<T>(path, opts, config, attempt + 1);\n\t\t}\n\n\t\tthrow new NoctalyError({\n\t\t\tcode: err.code as ApiErrorCode,\n\t\t\tmessage: err.message,\n\t\t\tstatus: res.status,\n\t\t\t...(err.retryAfter === undefined ? {} : { retryAfter: err.retryAfter }),\n\t\t\t...(err.global === undefined ? {} : { global: err.global }),\n\t\t\t...(err.details === undefined ? {} : { details: err.details }),\n\t\t});\n\t}\n\n\tconst rateLimit = parseRateLimitHeaders(res.headers);\n\tconst response: NoctalyResponse<T> = { data: json as T };\n\tif (rateLimit !== undefined) response.rateLimit = rateLimit;\n\treturn response;\n}\n","import type { ClientConfig } from \"../config.js\";\nimport type { NoctalyResponse } from \"../request.js\";\nimport { request } from \"../request.js\";\nimport type { Chest } from \"../types.js\";\n\n/**\n * Manages guild-level chest operations.\n */\nexport class GuildChestsResource {\n\treadonly #guildID: string;\n\n\treadonly #config: ClientConfig;\n\n\tpublic constructor(guildID: string, config: ClientConfig) {\n\t\tthis.#guildID = guildID;\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * Returns all chests configured in the guild's economy.\n\t *\n\t * `GET /guilds/{guildID}/chests`\n\t */\n\tpublic async list(): Promise<NoctalyResponse<{ chests: Chest[] }>> {\n\t\treturn request(`/guilds/${this.#guildID}/chests`, {}, this.#config);\n\t}\n}\n","import type { ClientConfig } from \"../config.js\";\nimport type { NoctalyResponse } from \"../request.js\";\nimport { request } from \"../request.js\";\nimport type { Item } from \"../types.js\";\n\n/**\n * Manages guild-level item operations.\n */\nexport class GuildItemsResource {\n\treadonly #guildID: string;\n\n\treadonly #config: ClientConfig;\n\n\tpublic constructor(guildID: string, config: ClientConfig) {\n\t\tthis.#guildID = guildID;\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * Returns all items configured in the guild's economy.\n\t *\n\t * `GET /guilds/{guildID}/items`\n\t */\n\tpublic async list(): Promise<NoctalyResponse<{ items: Item[] }>> {\n\t\treturn request(`/guilds/${this.#guildID}/items`, {}, this.#config);\n\t}\n}\n","import type { ClientConfig } from \"../config.js\";\nimport type { NoctalyResponse } from \"../request.js\";\nimport { request } from \"../request.js\";\n\nexport interface AddChestsBody {\n\t/**\n\t * UUID of the chest to add.\n\t */\n\tchestID: string;\n\t/**\n\t * Quantity to add. Min: `1`. Max: `1,000,000`.\n\t */\n\tquantity: number;\n}\n\nexport interface RemoveChestsBody {\n\t/**\n\t * UUID of the chest to remove.\n\t */\n\tchestID: string;\n\t/**\n\t * Quantity to remove. Min: `1`. Max: `1,000,000`.\n\t */\n\tquantity: number;\n}\n\nexport interface SetChestQuantityBody {\n\t/**\n\t * UUID of the chest.\n\t */\n\tchestID: string;\n\t/**\n\t * Target quantity. Min: `0` (removes the chest entirely). Max: `1,000,000`.\n\t */\n\tquantity: number;\n}\n\n/**\n * Manages chest operations for a specific guild member.\n */\nexport class UserChestsResource {\n\treadonly #guildID: string;\n\n\treadonly #userID: string;\n\n\treadonly #config: ClientConfig;\n\n\tpublic constructor(guildID: string, userID: string, config: ClientConfig) {\n\t\tthis.#guildID = guildID;\n\t\tthis.#userID = userID;\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * Adds a quantity of a chest to the member's inventory.\n\t *\n\t * `POST /guilds/{guildID}/users/{userID}/chests`\n\t */\n\tpublic async add(body: AddChestsBody): Promise<NoctalyResponse<{ quantity: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/chests`, { method: \"POST\", body }, this.#config);\n\t}\n\n\t/**\n\t * Removes a quantity of a chest from the member's inventory. If the\n\t * resulting quantity reaches `0` or below the chest is removed entirely.\n\t *\n\t * `DELETE /guilds/{guildID}/users/{userID}/chests`\n\t */\n\tpublic async remove(body: RemoveChestsBody): Promise<NoctalyResponse<{ quantity: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/chests`, { method: \"DELETE\", body }, this.#config);\n\t}\n\n\t/**\n\t * Sets the exact quantity of a chest in the member's inventory.\n\t * Passing `0` removes the chest entirely.\n\t *\n\t * `PUT /guilds/{guildID}/users/{userID}/chests`\n\t */\n\tpublic async set(body: SetChestQuantityBody): Promise<NoctalyResponse<{ quantity: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/chests`, { method: \"PUT\", body }, this.#config);\n\t}\n}\n","import type { ClientConfig } from \"../config.js\";\nimport type { NoctalyResponse } from \"../request.js\";\nimport { request } from \"../request.js\";\nimport type { UseItemResult } from \"../types.js\";\n\nexport interface AddItemsBody {\n\t/**\n\t * UUID of the item to add.\n\t */\n\titemID: string;\n\t/**\n\t * Quantity to add. Min: `1`. Max: `1,000,000`.\n\t */\n\tquantity: number;\n}\n\nexport interface RemoveItemsBody {\n\t/**\n\t * UUID of the item to remove.\n\t */\n\titemID: string;\n\t/**\n\t * Quantity to remove. Min: `1`. Max: `1,000,000`.\n\t */\n\tquantity: number;\n}\n\nexport interface SetItemQuantityBody {\n\t/**\n\t * UUID of the item.\n\t */\n\titemID: string;\n\t/**\n\t * Target quantity. Min: `0` (removes the item entirely). Max: `1,000,000`.\n\t */\n\tquantity: number;\n}\n\nexport interface UseItemBody {\n\t/**\n\t * Number of uses. Min: `1`. Max: `1,000,000`. Defaults to `1`.\n\t */\n\tquantity?: number;\n}\n\n/**\n * Manages item operations for a specific guild member.\n */\nexport class UserItemsResource {\n\treadonly #guildID: string;\n\n\treadonly #userID: string;\n\n\treadonly #config: ClientConfig;\n\n\tpublic constructor(guildID: string, userID: string, config: ClientConfig) {\n\t\tthis.#guildID = guildID;\n\t\tthis.#userID = userID;\n\t\tthis.#config = config;\n\t}\n\n\t/**\n\t * Adds a quantity of an item to the member's inventory.\n\t *\n\t * `POST /guilds/{guildID}/users/{userID}/items`\n\t */\n\tpublic async add(body: AddItemsBody): Promise<NoctalyResponse<{ quantity: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/items`, { method: \"POST\", body }, this.#config);\n\t}\n\n\t/**\n\t * Removes a quantity of an item from the member's inventory. If the\n\t * resulting quantity reaches `0` or below the item is removed entirely.\n\t *\n\t * `DELETE /guilds/{guildID}/users/{userID}/items`\n\t */\n\tpublic async remove(body: RemoveItemsBody): Promise<NoctalyResponse<{ quantity: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/items`, { method: \"DELETE\", body }, this.#config);\n\t}\n\n\t/**\n\t * Sets the exact quantity of an item in the member's inventory.\n\t * Passing `0` removes the item entirely.\n\t *\n\t * `PUT /guilds/{guildID}/users/{userID}/items`\n\t */\n\tpublic async set(body: SetItemQuantityBody): Promise<NoctalyResponse<{ quantity: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/items`, { method: \"PUT\", body }, this.#config);\n\t}\n\n\t/**\n\t * Triggers the item's configured actions (give/remove money, XP, roles,\n\t * other items…). Only works for items of type `CUSTOM` with at least one\n\t * action. The item is consumed unless it has the `KEEP_AFTER_USE` flag.\n\t *\n\t * `POST /guilds/{guildID}/users/{userID}/items/{itemID}/use`\n\t */\n\tpublic async use(itemID: string, body: UseItemBody = {}): Promise<NoctalyResponse<UseItemResult>> {\n\t\treturn request(\n\t\t\t`/guilds/${this.#guildID}/users/${this.#userID}/items/${itemID}/use`,\n\t\t\t{ method: \"POST\", body },\n\t\t\tthis.#config,\n\t\t);\n\t}\n}\n","import type { ClientConfig } from \"../config.js\";\nimport type { NoctalyResponse } from \"../request.js\";\nimport { request } from \"../request.js\";\nimport type { EcoProfileOptions, EcoProfileResult, LevelProfile } from \"../types.js\";\nimport { UserChestsResource } from \"./UserChestsResource.js\";\nimport { UserItemsResource } from \"./UserItemsResource.js\";\n\nexport interface UpdateXPBody {\n\t/**\n\t * When `true`, the server multiplier and the member's booster roles\n\t * affect the amount of XP.\n\t *\n\t * @default false\n\t */\n\tmultiply?: boolean;\n\t/**\n\t * XP to give (positive) or remove (negative).\n\t * Min: `-100,000,000`. Max: `100,000,000`.\n\t */\n\txp: number;\n}\n\nexport interface UpdateLevelBody {\n\t/**\n\t * Levels to give (positive) or remove (negative).\n\t * Min: `-1,000`. Max: `1,000`.\n\t */\n\tlevel: number;\n}\n\nexport interface UpdateMoneyBody {\n\t/**\n\t * Money to give (positive) or remove (negative).\n\t * Min: `-1,000,000,000`. Max: `1,000,000,000`.\n\t */\n\tmoney: number;\n\t/**\n\t * When `true`, the server multiplier and the member's booster roles\n\t * affect the amount of money.\n\t *\n\t * @default false\n\t */\n\tmultiply?: boolean;\n}\n\n/**\n * Operations scoped to a single guild member.\n */\nexport class UserResource {\n\t/**\n\t * Item inventory operations for this member.\n\t */\n\tpublic readonly items: UserItemsResource;\n\n\t/**\n\t * Chest inventory operations for this member.\n\t */\n\tpublic readonly chests: UserChestsResource;\n\n\treadonly #guildID: string;\n\n\treadonly #userID: string;\n\n\treadonly #config: ClientConfig;\n\n\tpublic constructor(guildID: string, userID: string, config: ClientConfig) {\n\t\tthis.#guildID = guildID;\n\t\tthis.#userID = userID;\n\t\tthis.#config = config;\n\t\tthis.items = new UserItemsResource(guildID, userID, config);\n\t\tthis.chests = new UserChestsResource(guildID, userID, config);\n\t}\n\n\t/**\n\t * Returns the member's economy profile.\n\t * Pass options to include optional relations (items, chests, daily streak).\n\t *\n\t * `GET /guilds/{guildID}/users/{userID}/eco-profile`\n\t */\n\tpublic async getEcoProfile(): Promise<NoctalyResponse<EcoProfileResult<Record<never, never>>>>;\n\tpublic async getEcoProfile<O extends EcoProfileOptions>(options: O): Promise<NoctalyResponse<EcoProfileResult<O>>>;\n\tpublic async getEcoProfile<O extends EcoProfileOptions>(options?: O): Promise<NoctalyResponse<EcoProfileResult<O>>> {\n\t\treturn request(\n\t\t\t`/guilds/${this.#guildID}/users/${this.#userID}/eco-profile`,\n\t\t\t{\n\t\t\t\tquery: {\n\t\t\t\t\titems: options?.items,\n\t\t\t\t\tchests: options?.chests,\n\t\t\t\t\tdailyStreak: options?.dailyStreak,\n\t\t\t\t},\n\t\t\t},\n\t\t\tthis.#config,\n\t\t) as Promise<NoctalyResponse<EcoProfileResult<O>>>;\n\t}\n\n\t/**\n\t * Returns the member's full levelling profile.\n\t *\n\t * `GET /guilds/{guildID}/users/{userID}/level-profile`\n\t */\n\tpublic async getLevelProfile(): Promise<NoctalyResponse<LevelProfile>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/level-profile`, {}, this.#config);\n\t}\n\n\t/**\n\t * Adds or removes XP from the member.\n\t *\n\t * `POST /guilds/{guildID}/users/{userID}/xp`\n\t */\n\tpublic async updateXP(body: UpdateXPBody): Promise<NoctalyResponse<{ xp: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/xp`, { method: \"POST\", body }, this.#config);\n\t}\n\n\t/**\n\t * Adds or removes levels from the member.\n\t *\n\t * `POST /guilds/{guildID}/users/{userID}/level`\n\t */\n\tpublic async updateLevel(body: UpdateLevelBody): Promise<NoctalyResponse<{ level: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/level`, { method: \"POST\", body }, this.#config);\n\t}\n\n\t/**\n\t * Adds or removes money from the member.\n\t *\n\t * `POST /guilds/{guildID}/users/{userID}/money`\n\t */\n\tpublic async updateMoney(body: UpdateMoneyBody): Promise<NoctalyResponse<{ money: number }>> {\n\t\treturn request(`/guilds/${this.#guildID}/users/${this.#userID}/money`, { method: \"POST\", body }, this.#config);\n\t}\n}\n","import type { ClientConfig } from \"../config.js\";\nimport { GuildChestsResource } from \"./GuildChestsResource.js\";\nimport { GuildItemsResource } from \"./GuildItemsResource.js\";\nimport { UserResource } from \"./UserResource.js\";\n\n/**\n * Operations scoped to a single guild.\n */\nexport class GuildResource {\n\treadonly #guildID: string;\n\n\treadonly #config: ClientConfig;\n\n\t/**\n\t * Guild-wide item catalogue operations.\n\t */\n\tpublic readonly items: GuildItemsResource;\n\n\t/**\n\t * Guild-wide chest catalogue operations.\n\t */\n\tpublic readonly chests: GuildChestsResource;\n\n\tpublic constructor(guildID: string, config: ClientConfig) {\n\t\tthis.#guildID = guildID;\n\t\tthis.#config = config;\n\t\tthis.items = new GuildItemsResource(guildID, config);\n\t\tthis.chests = new GuildChestsResource(guildID, config);\n\t}\n\n\t/**\n\t * Returns a {@link UserResource} scoped to the given guild member.\n\t *\n\t * @param userID - Discord user ID of the member.\n\t */\n\tpublic users(userID: string): UserResource {\n\t\treturn new UserResource(this.#guildID, userID, this.#config);\n\t}\n}\n","import type { ClientConfig } from \"./config.js\";\nimport { GuildResource } from \"./resources/GuildResource.js\";\n\nconst DEFAULT_BASE_URL = \"https://noctaly.com/api/v1\";\nconst DEFAULT_TIMEOUT = 30_000;\nconst DEFAULT_MAX_RETRIES = 3;\n\nexport interface NoctalyClientOptions {\n\t/**\n\t * Your Noctaly API key.\n\t */\n\tapiKey: string;\n\t/**\n\t * Override the base URL. Useful for self-hosted or staging environments.\n\t *\n\t * @default \"https://noctaly.com/api/v1\"\n\t */\n\tbaseURL?: string;\n\t/**\n\t * Maximum number of automatic retries before the error is thrown.\n\t *\n\t * @default 3\n\t */\n\tmaxRetries?: number;\n\t/**\n\t * Automatically retry requests that receive a `rate_limited` (429) response,\n\t * waiting `retryAfter` seconds between attempts.\n\t *\n\t * @default true\n\t */\n\tretry?: boolean;\n\t/**\n\t * Request timeout in milliseconds. Set to `0` to disable.\n\t *\n\t * @default 30_000\n\t */\n\ttimeout?: number;\n}\n\n/**\n * Entry point for the Noctaly SDK.\n *\n * @example\n * ```ts\n * import { NoctalyClient } from \"@noctaly/sdk\";\n *\n * const noctaly = new NoctalyClient({ apiKey: \"your-api-key\" });\n *\n * const { data } = await noctaly.guilds(\"GUILD_ID\").users(\"USER_ID\").getLevelProfile();\n * console.log(`Level ${data.level} — ${data.xp} XP`);\n * ```\n */\nexport class NoctalyClient {\n\treadonly #config: ClientConfig;\n\n\tpublic constructor({\n\t\tapiKey,\n\t\tbaseURL = DEFAULT_BASE_URL,\n\t\ttimeout = DEFAULT_TIMEOUT,\n\t\tretry = true,\n\t\tmaxRetries = DEFAULT_MAX_RETRIES,\n\t}: NoctalyClientOptions) {\n\t\tif (!apiKey) throw new Error(\"apiKey is required.\");\n\t\tthis.#config = {\n\t\t\tapiKey,\n\t\t\tbaseURL: baseURL.replace(/\\/$/, \"\"),\n\t\t\ttimeout,\n\t\t\tretry,\n\t\t\tmaxRetries,\n\t\t};\n\t}\n\n\t/**\n\t * Returns a {@link GuildResource} scoped to the given guild.\n\t *\n\t * @param guildID - Discord guild (server) ID.\n\t */\n\tpublic guilds(guildID: string): GuildResource {\n\t\treturn new GuildResource(guildID, this.#config);\n\t}\n}\n"]}