e621-client 1.0.7 → 1.1.0

package/dist/types/e621/E621User.d.ts

@@ -28,13 +28,13 @@ export interface UserResponse {
 }
 export interface E621User {
     id: number;
+    name: string;
+    createdAt: Date;
     profile: {
-        name: string;
         level: number;
         about: string;
         artInfo: string;
         avatarId: number | null;
-        createdAt: Date;
         levelString: string;
     };
     counts: {

package/dist/types/e621/E621User.js

@@ -4,13 +4,13 @@ exports.parseUser = void 0;
 function parseUser(user) {
     return {
         id: user.id,
+        name: user.name,
+        createdAt: new Date(user.created_at),
         profile: {
-            name: user.name,
             level: user.level,
             about: user.profile_about,
             artInfo: user.profile_artinfo,
             avatarId: user.avatar_id,
-            createdAt: new Date(user.created_at),
             levelString: user.level_string,
         },
         counts: {

package/package.json

@@ -1,10 +1,11 @@
 {
   "name": "e621-client",
-  "version": "1.0.7",
+  "version": "1.1.0",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "scripts": {
-    "build": "tsc"
+    "build": "tsc",
+    "publish": "npm run build & npm publish"
   },
   "keywords": [],
   "author": "Tommus",

package/src/client/E621ApiClient.ts

@@ -1,140 +1,169 @@
-import { E621Post, parsePost } from "../types/e621/E621Post";
-import { E621User, UserResponse, parseUser } from "../types/e621/E621User";
-import {
-  GetFavoritesResponse,
-  GetPostResponse,
-  GetPostsResponse,
-} from "../types/responses";
-import { ensureArray, translateOptions } from "../utils";
-import { E621ApiHeaders } from "./E621ApiHeaders";
-
-export interface E621ApiOptions {
-  client: string;
-  isBrowser: boolean;
-  credentials?: Credentials;
-}
-
-export type GetOptions = {
-  route: Route;
-  params?: Params;
-  headers?: E621ApiHeaders;
-};
-
-export interface Credentials {
-  username: string;
-  apiKey: string;
-}
-
-export type EntityId = string | number;
-export type Route = string | number | (string | number)[];
-export type Params = Record<string, string>;
-export type Pagination = { limit?: string; page?: string };
-
-export type GetUsersOptions = { nameMatches?: string } & Params & Pagination;
-export type GetPostsOptions = { tags?: string } & Pagination;
-export type GetFavoritesOptions = { userId?: string } & Pagination;
-
-export class E621ApiClient {
-  protected static readonly BASE_URL = "https://e621.net/";
-
-  private readonly client: string;
-  private readonly isBrowser: boolean;
-  private credentials: Credentials | null = null;
-
-  constructor(options: E621ApiOptions) {
-    this.client = options.client;
-    this.isBrowser = options.isBrowser;
-    this.credentials = options.credentials || null;
-  }
-
-  // Users
-  public async getUsers(options: GetUsersOptions = {}): Promise<E621User[]> {
-    const users = await this.get<UserResponse[]>({
-      route: "users",
-      params: translateOptions(options, {
-        nameMatches: "search[name_matches]",
-      }),
-    });
-    return users?.map(parseUser) || [];
-  }
-
-  public async getUserById(id: EntityId): Promise<E621User | null> {
-    const user = await this.get<UserResponse>({ route: ["users", id] });
-    return user ? parseUser(user) : null;
-  }
-
-  // Posts
-  public async getPosts(options: GetPostsOptions = {}): Promise<E621Post[]> {
-    const response = await this.get<GetPostsResponse>({
-      route: "posts",
-      params: options,
-    });
-    return response?.posts.map(parsePost) || [];
-  }
-
-  public async getPostById(id: EntityId): Promise<E621Post | null> {
-    const response = await this.get<GetPostResponse>({ route: ["posts", id] });
-    return response?.post ? parsePost(response.post) : null;
-  }
-
-  // Favorites
-  public async getFavorites(
-    options: GetFavoritesOptions = {}
-  ): Promise<E621Post[]> {
-    const response = await this.get<GetFavoritesResponse>({
-      route: "favorites",
-      params: translateOptions(options, { userId: "user_id" }),
-    });
-    return response?.posts?.map(parsePost) || [];
-  }
-
-  // Account
-  public setCredentials(credentials: Credentials | null): E621ApiClient {
-    this.credentials = credentials;
-    return this;
-  }
-
-  public async checkCredentials(credentials?: Credentials): Promise<boolean> {
-    if (credentials) {
-      this.setCredentials(credentials);
-    }
-
-    const headers = new E621ApiHeaders();
-    if (!this.isBrowser) {
-      headers.addUserAgent(this.client);
-    }
-
-    return await fetch(this.buildUrl("favorites"), {
-      headers: headers.addAuthorization(this.credentials).build(),
-    })
-      .then((res) => res.ok)
-      .catch(() => false);
-  }
-
-  public async get<E>({
-    route,
-    params,
-    headers = new E621ApiHeaders(),
-  }: GetOptions): Promise<E | null> {
-    if (!this.isBrowser) {
-      headers.addUserAgent(this.client);
-    }
-
-    const response = await fetch(this.buildUrl(route, params), {
-      method: "GET",
-      headers: headers.addAuthorization(this.credentials).build(),
-    });
-    return response.json().catch(() => null);
-  }
-
-  private buildUrl(route: Route, params: Params = {}): string {
-    const queryParams = new URLSearchParams(params);
-    const url = E621ApiClient.BASE_URL + ensureArray(route).join("/") + ".json";
-
-    if (this.isBrowser) {
-      queryParams.set("_client", this.client);
-    }
-
-    return queryParams.size > 0 ? `${url}?${queryParams}` : url;
-  }
-}
+import { E621Post, parsePost } from "../types/e621/E621Post";
+import { E621User, UserResponse, parseUser } from "../types/e621/E621User";
+import {
+  GetFavoritesResponse,
+  GetPostResponse,
+  GetPostsResponse,
+} from "../types/responses";
+import { ensureArray, translateOptions } from "../utils";
+import { E621ApiHeaders } from "./E621ApiHeaders";
+
+export interface E621ApiOptions {
+  client: string;
+  isBrowser: boolean;
+  credentials?: Credentials;
+}
+
+export type GetOptions = {
+  route: Route;
+  params?: Params;
+  headers?: E621ApiHeaders;
+};
+
+export interface Credentials {
+  username: string;
+  apiKey: string;
+}
+
+export type EntityId = string | number;
+export type Route = string | number | (string | number)[];
+export type Params = Record<string, string>;
+export type Pagination = { limit?: string; page?: string };
+
+export type GetUsersOptions = { nameMatches?: string } & Params & Pagination;
+export type GetPostsOptions = { tags?: string } & Pagination;
+export type GetFavoritesOptions = { userId?: string } & Pagination;
+export type GetAllFavoritesOptions = { userId?: string };
+
+export class E621ApiClient {
+  protected static readonly BASE_URL = "https://e621.net/";
+
+  private readonly client: string;
+  private readonly isBrowser: boolean;
+  private credentials: Credentials | null = null;
+
+  constructor(options: E621ApiOptions) {
+    this.client = options.client;
+    this.isBrowser = options.isBrowser;
+    this.credentials = options.credentials || null;
+  }
+
+  // Users
+  public async getUsers(options: GetUsersOptions = {}): Promise<E621User[]> {
+    const users = await this.get<UserResponse[]>({
+      route: "users",
+      params: translateOptions(options, {
+        nameMatches: "search[name_matches]",
+      }),
+    });
+    return users?.map(parseUser) || [];
+  }
+
+  public async getUserById(id: EntityId): Promise<E621User | null> {
+    const user = await this.get<UserResponse>({ route: ["users", id] });
+    return user ? parseUser(user) : null;
+  }
+
+  // Posts
+  public async getPosts(options: GetPostsOptions = {}): Promise<E621Post[]> {
+    const response = await this.get<GetPostsResponse>({
+      route: "posts",
+      params: options,
+    });
+    return response?.posts.map(parsePost) || [];
+  }
+
+  public async getPostById(id: EntityId): Promise<E621Post | null> {
+    const response = await this.get<GetPostResponse>({ route: ["posts", id] });
+    return response?.post ? parsePost(response.post) : null;
+  }
+
+  // Favorites
+  public async getFavorites(
+    options: GetFavoritesOptions = {},
+  ): Promise<E621Post[]> {
+    const response = await this.get<GetFavoritesResponse>({
+      route: "favorites",
+      params: translateOptions(options, { userId: "user_id" }),
+    });
+    return response?.posts?.map(parsePost) || [];
+  }
+
+  public async getAllFavorites(
+    options: GetAllFavoritesOptions = {},
+    debugLogs = false,
+  ): Promise<E621Post[]> {
+    // max page size on e621 api
+    const favorites: E621Post[] = [];
+    const limit = 300;
+    let page = 1;
+
+    while (true) {
+      if (debugLogs) {
+        const user = options.userId ?? this.credentials?.username;
+        console.info(`page ${page} for user ${user}`);
+      }
+
+      const posts = await this.getFavorites({
+        ...options,
+        page: String(page++),
+        limit: String(limit),
+      });
+
+      if (posts.length === 0) break;
+      favorites.push(...posts);
+    }
+
+    return favorites;
+  }
+
+  // Account
+  public setCredentials(credentials: Credentials | null): E621ApiClient {
+    this.credentials = credentials;
+    return this;
+  }
+
+  public async checkCredentials(credentials?: Credentials): Promise<boolean> {
+    if (credentials) {
+      this.setCredentials(credentials);
+    }
+
+    const headers = new E621ApiHeaders();
+    if (!this.isBrowser) {
+      headers.addUserAgent(this.client);
+    }
+
+    return await fetch(this.buildUrl("favorites"), {
+      headers: headers.addAuthorization(this.credentials).build(),
+    })
+      .then((res) => res.ok)
+      .catch(() => false);
+  }
+
+  public async get<E>({
+    route,
+    params,
+    headers = new E621ApiHeaders(),
+  }: GetOptions): Promise<E | null> {
+    if (!this.isBrowser) {
+      headers.addUserAgent(this.client);
+    }
+
+    const response = await fetch(this.buildUrl(route, params), {
+      method: "GET",
+      headers: headers.addAuthorization(this.credentials).build(),
+    });
+    return response.json().catch(() => null);
+  }
+
+  private buildUrl(route: Route, params: Params = {}): string {
+    const queryParams = new URLSearchParams(params);
+    const url = E621ApiClient.BASE_URL + ensureArray(route).join("/") + ".json";
+
+    if (this.isBrowser) {
+      queryParams.set("_client", this.client);
+    }
+
+    return queryParams.size > 0 ? `${url}?${queryParams}` : url;
+  }
+}

package/src/client/E621ApiHeaders.ts

@@ -1,51 +1,51 @@
-import { Credentials } from "./E621ApiClient";
-
-export class E621ApiHeaders {
-  private readonly value: Record<string, string>;
-
-  constructor(value: Record<string, string> = {}) {
-    this.value = value;
-  }
-
-  public addAuthorization(credentials: Credentials | null): E621ApiHeaders {
-    if (credentials) {
-      this.value.Authorization = E621ApiHeaders.buildAuthorization(credentials);
-    }
-    return this;
-  }
-
-  public addFormContentType(): E621ApiHeaders {
-    this.value["Content-Type"] =
-      "application/x-www-form-urlencoded; charset=UTF-8";
-    return this;
-  }
-
-  public addUserAgent(userAgent: string): E621ApiHeaders {
-    this.value["User-Agent"] = userAgent;
-    return this;
-  }
-
-  public build(): Record<string, string> {
-    return this.value;
-  }
-
-  protected static buildAuthorization({ username, apiKey }: Credentials) {
-    const creds = `${username}:${apiKey}`;
-
-    if (canUseWindow()) {
-      return `Basic ${window.btoa(creds)}`;
-    } else if (canUseBuffer()) {
-      return `Basic ${Buffer.from(creds).toString("base64")}`;
-    } else {
-      throw new Error("Environment does not support base64 encoding");
-    }
-  }
-}
-
-function canUseWindow() {
-  return typeof window !== "undefined";
-}
-
-function canUseBuffer() {
-  return typeof Buffer !== "undefined" && typeof Buffer.from === "function";
-}
+import { Credentials } from "./E621ApiClient";
+
+export class E621ApiHeaders {
+  private readonly value: Record<string, string>;
+
+  constructor(value: Record<string, string> = {}) {
+    this.value = value;
+  }
+
+  public addAuthorization(credentials: Credentials | null): E621ApiHeaders {
+    if (credentials) {
+      this.value.Authorization = E621ApiHeaders.buildAuthorization(credentials);
+    }
+    return this;
+  }
+
+  public addFormContentType(): E621ApiHeaders {
+    this.value["Content-Type"] =
+      "application/x-www-form-urlencoded; charset=UTF-8";
+    return this;
+  }
+
+  public addUserAgent(userAgent: string): E621ApiHeaders {
+    this.value["User-Agent"] = userAgent;
+    return this;
+  }
+
+  public build(): Record<string, string> {
+    return this.value;
+  }
+
+  protected static buildAuthorization({ username, apiKey }: Credentials) {
+    const creds = `${username}:${apiKey}`;
+
+    if (canUseWindow()) {
+      return `Basic ${window.btoa(creds)}`;
+    } else if (canUseBuffer()) {
+      return `Basic ${Buffer.from(creds).toString("base64")}`;
+    } else {
+      throw new Error("Environment does not support base64 encoding");
+    }
+  }
+}
+
+function canUseWindow() {
+  return typeof window !== "undefined";
+}
+
+function canUseBuffer() {
+  return typeof Buffer !== "undefined" && typeof Buffer.from === "function";
+}

package/src/index.ts

@@ -1,3 +1,3 @@
-export * from "./client/E621ApiClient";
-export * from "./types/e621/E621User";
-export * from "./types/e621/E621Post";
+export * from "./client/E621ApiClient";
+export * from "./types/e621/E621User";
+export * from "./types/e621/E621Post";

package/src/types/e621/E621Post.ts

@@ -1,173 +1,173 @@
-export interface PostResponse {
-  id: number;
-  created_at: string;
-  updated_at: string;
-  file: {
-    width: number;
-    height: number;
-    ext: string;
-    size: number;
-    md5: string;
-    url: string;
-  };
-  preview: {
-    width: number;
-    height: number;
-    url: string | null;
-  };
-  sample: {
-    has: boolean;
-    width: number;
-    height: number;
-    url: string | null;
-  };
-  score: {
-    up: number;
-    down: number;
-    total: number;
-  };
-  tags: {
-    general: string[];
-    artist: string[];
-    copyright: string[];
-    character: string[];
-    species: string[];
-    invalid: string[];
-    meta: string[];
-    lore: string[];
-  };
-  locked_tags: string[];
-  change_seq: number;
-  flags: {
-    pending: boolean;
-    flagged: boolean;
-    note_locked: boolean;
-    status_locked: boolean;
-    rating_locked: boolean;
-    deleted: boolean;
-  };
-  rating: string;
-  fav_count: number;
-  sources: string[];
-  pools: number[];
-  relationships: {
-    parent_id: number | null;
-    has_children: boolean;
-    has_active_children: boolean;
-    children: number[];
-  };
-  approver_id: number | null;
-  uploader_id: number;
-  description: string;
-  comment_count: number;
-  is_favorited: boolean;
-  has_notes: boolean;
-  duration: number | null;
-}
-
-export interface E621Post {
-  id: number;
-  createdAt: Date;
-  updatedAt: Date;
-  file: {
-    width: number;
-    height: number;
-    ext: string;
-    size: number;
-    md5: string;
-    url: string;
-  };
-  preview: {
-    width: number;
-    height: number;
-    url: string | null;
-  };
-  sample: {
-    has: boolean;
-    width: number;
-    height: number;
-    url: string | null;
-  };
-  score: {
-    up: number;
-    down: number;
-    total: number;
-  };
-  tags: {
-    general: string[];
-    artist: string[];
-    copyright: string[];
-    character: string[];
-    species: string[];
-    invalid: string[];
-    meta: string[];
-    lore: string[];
-  };
-  lockedTags: string[];
-  changeSeq: number;
-  flags: {
-    pending: boolean;
-    flagged: boolean;
-    noteLocked: boolean;
-    statusLocked: boolean;
-    ratingLocked: boolean;
-    deleted: boolean;
-  };
-  rating: string;
-  favCount: number;
-  sources: string[];
-  pools: number[];
-  relationships: {
-    parentId: number | null;
-    hasChildren: boolean;
-    hasActiveChildren: boolean;
-    children: number[];
-  };
-  approverId: number | null;
-  uploaderId: number;
-  description: string;
-  commentCount: number;
-  isFavorited: boolean;
-  hasNotes: boolean;
-  duration: number | null;
-}
-
-export function parsePost(post: PostResponse): E621Post {
-  return {
-    id: post.id,
-    createdAt: new Date(post.created_at),
-    updatedAt: new Date(post.updated_at),
-    file: post.file,
-    preview: post.preview,
-    sample: post.sample,
-    score: post.score,
-    tags: post.tags,
-    lockedTags: post.locked_tags,
-    changeSeq: post.change_seq,
-    flags: {
-      pending: post.flags.pending,
-      flagged: post.flags.flagged,
-      noteLocked: post.flags.note_locked,
-      statusLocked: post.flags.status_locked,
-      ratingLocked: post.flags.rating_locked,
-      deleted: post.flags.deleted,
-    },
-    rating: post.rating,
-    favCount: post.fav_count,
-    sources: post.sources,
-    pools: post.pools,
-    relationships: {
-      parentId: post.relationships.parent_id,
-      hasChildren: post.relationships.has_children,
-      hasActiveChildren: post.relationships.has_active_children,
-      children: post.relationships.children,
-    },
-    approverId: post.approver_id,
-    uploaderId: post.uploader_id,
-    description: post.description,
-    commentCount: post.comment_count,
-    isFavorited: post.is_favorited,
-    hasNotes: post.has_notes,
-    duration: post.duration,
-  };
-}
+export interface PostResponse {
+  id: number;
+  created_at: string;
+  updated_at: string;
+  file: {
+    width: number;
+    height: number;
+    ext: string;
+    size: number;
+    md5: string;
+    url: string;
+  };
+  preview: {
+    width: number;
+    height: number;
+    url: string | null;
+  };
+  sample: {
+    has: boolean;
+    width: number;
+    height: number;
+    url: string | null;
+  };
+  score: {
+    up: number;
+    down: number;
+    total: number;
+  };
+  tags: {
+    general: string[];
+    artist: string[];
+    copyright: string[];
+    character: string[];
+    species: string[];
+    invalid: string[];
+    meta: string[];
+    lore: string[];
+  };
+  locked_tags: string[];
+  change_seq: number;
+  flags: {
+    pending: boolean;
+    flagged: boolean;
+    note_locked: boolean;
+    status_locked: boolean;
+    rating_locked: boolean;
+    deleted: boolean;
+  };
+  rating: string;
+  fav_count: number;
+  sources: string[];
+  pools: number[];
+  relationships: {
+    parent_id: number | null;
+    has_children: boolean;
+    has_active_children: boolean;
+    children: number[];
+  };
+  approver_id: number | null;
+  uploader_id: number;
+  description: string;
+  comment_count: number;
+  is_favorited: boolean;
+  has_notes: boolean;
+  duration: number | null;
+}
+
+export interface E621Post {
+  id: number;
+  createdAt: Date;
+  updatedAt: Date;
+  file: {
+    width: number;
+    height: number;
+    ext: string;
+    size: number;
+    md5: string;
+    url: string;
+  };
+  preview: {
+    width: number;
+    height: number;
+    url: string | null;
+  };
+  sample: {
+    has: boolean;
+    width: number;
+    height: number;
+    url: string | null;
+  };
+  score: {
+    up: number;
+    down: number;
+    total: number;
+  };
+  tags: {
+    general: string[];
+    artist: string[];
+    copyright: string[];
+    character: string[];
+    species: string[];
+    invalid: string[];
+    meta: string[];
+    lore: string[];
+  };
+  lockedTags: string[];
+  changeSeq: number;
+  flags: {
+    pending: boolean;
+    flagged: boolean;
+    noteLocked: boolean;
+    statusLocked: boolean;
+    ratingLocked: boolean;
+    deleted: boolean;
+  };
+  rating: string;
+  favCount: number;
+  sources: string[];
+  pools: number[];
+  relationships: {
+    parentId: number | null;
+    hasChildren: boolean;
+    hasActiveChildren: boolean;
+    children: number[];
+  };
+  approverId: number | null;
+  uploaderId: number;
+  description: string;
+  commentCount: number;
+  isFavorited: boolean;
+  hasNotes: boolean;
+  duration: number | null;
+}
+
+export function parsePost(post: PostResponse): E621Post {
+  return {
+    id: post.id,
+    createdAt: new Date(post.created_at),
+    updatedAt: new Date(post.updated_at),
+    file: post.file,
+    preview: post.preview,
+    sample: post.sample,
+    score: post.score,
+    tags: post.tags,
+    lockedTags: post.locked_tags,
+    changeSeq: post.change_seq,
+    flags: {
+      pending: post.flags.pending,
+      flagged: post.flags.flagged,
+      noteLocked: post.flags.note_locked,
+      statusLocked: post.flags.status_locked,
+      ratingLocked: post.flags.rating_locked,
+      deleted: post.flags.deleted,
+    },
+    rating: post.rating,
+    favCount: post.fav_count,
+    sources: post.sources,
+    pools: post.pools,
+    relationships: {
+      parentId: post.relationships.parent_id,
+      hasChildren: post.relationships.has_children,
+      hasActiveChildren: post.relationships.has_active_children,
+      children: post.relationships.children,
+    },
+    approverId: post.approver_id,
+    uploaderId: post.uploader_id,
+    description: post.description,
+    commentCount: post.comment_count,
+    isFavorited: post.is_favorited,
+    hasNotes: post.has_notes,
+    duration: post.duration,
+  };
+}

package/src/types/e621/E621User.ts

@@ -1,108 +1,108 @@
-export interface UserResponse {
-  wiki_page_version_count: number;
-  artist_version_count: number;
-  pool_version_count: number;
-  forum_post_count: number;
-  comment_count: number;
-  flag_count: number;
-  favorite_count: number;
-  positive_feedback_count: number;
-  neutral_feedback_count: number;
-  negative_feedback_count: number;
-  upload_limit: number;
-  profile_about: string;
-  profile_artinfo: string;
-  id: number;
-  created_at: string;
-  name: string;
-  level: number;
-  base_upload_limit: number;
-  post_upload_count: number;
-  post_update_count: number;
-  note_update_count: number;
-  is_banned: boolean;
-  can_approve_posts: boolean;
-  can_upload_free: boolean;
-  level_string: string;
-  avatar_id: number | null;
-}
-
-export interface E621User {
-  id: number;
-  name: string;
-  createdAt: Date;
-
-  profile: {
-    level: number;
-    about: string;
-    artInfo: string;
-    avatarId: number | null;
-    levelString: string;
-  };
-
-  counts: {
-    wikiPageVersion: number;
-    artistVersion: number;
-    poolVersion: number;
-    forumPost: number;
-    comment: number;
-    flag: number;
-    favorite: number;
-    positiveFeedback: number;
-    neutralFeedback: number;
-    negativeFeedback: number;
-  };
-
-  limits: {
-    upload: number;
-    baseUpload: number;
-    postUpload: number;
-    postUpdate: number;
-    noteUpdate: number;
-  };
-
-  isBanned: boolean;
-  canApprovePosts: boolean;
-  canUploadFree: boolean;
-}
-
-export function parseUser(user: UserResponse): E621User {
-  return {
-    id: user.id,
-    name: user.name,
-    createdAt: new Date(user.created_at),
-
-    profile: {
-      level: user.level,
-      about: user.profile_about,
-      artInfo: user.profile_artinfo,
-      avatarId: user.avatar_id,
-      levelString: user.level_string,
-    },
-
-    counts: {
-      wikiPageVersion: user.wiki_page_version_count,
-      artistVersion: user.artist_version_count,
-      poolVersion: user.pool_version_count,
-      forumPost: user.forum_post_count,
-      comment: user.comment_count,
-      flag: user.flag_count,
-      favorite: user.favorite_count,
-      positiveFeedback: user.positive_feedback_count,
-      neutralFeedback: user.neutral_feedback_count,
-      negativeFeedback: user.negative_feedback_count,
-    },
-
-    limits: {
-      upload: user.upload_limit,
-      baseUpload: user.base_upload_limit,
-      postUpload: user.post_upload_count,
-      postUpdate: user.post_update_count,
-      noteUpdate: user.note_update_count,
-    },
-
-    isBanned: user.is_banned,
-    canApprovePosts: user.can_approve_posts,
-    canUploadFree: user.can_upload_free,
-  };
-}
+export interface UserResponse {
+  wiki_page_version_count: number;
+  artist_version_count: number;
+  pool_version_count: number;
+  forum_post_count: number;
+  comment_count: number;
+  flag_count: number;
+  favorite_count: number;
+  positive_feedback_count: number;
+  neutral_feedback_count: number;
+  negative_feedback_count: number;
+  upload_limit: number;
+  profile_about: string;
+  profile_artinfo: string;
+  id: number;
+  created_at: string;
+  name: string;
+  level: number;
+  base_upload_limit: number;
+  post_upload_count: number;
+  post_update_count: number;
+  note_update_count: number;
+  is_banned: boolean;
+  can_approve_posts: boolean;
+  can_upload_free: boolean;
+  level_string: string;
+  avatar_id: number | null;
+}
+
+export interface E621User {
+  id: number;
+  name: string;
+  createdAt: Date;
+
+  profile: {
+    level: number;
+    about: string;
+    artInfo: string;
+    avatarId: number | null;
+    levelString: string;
+  };
+
+  counts: {
+    wikiPageVersion: number;
+    artistVersion: number;
+    poolVersion: number;
+    forumPost: number;
+    comment: number;
+    flag: number;
+    favorite: number;
+    positiveFeedback: number;
+    neutralFeedback: number;
+    negativeFeedback: number;
+  };
+
+  limits: {
+    upload: number;
+    baseUpload: number;
+    postUpload: number;
+    postUpdate: number;
+    noteUpdate: number;
+  };
+
+  isBanned: boolean;
+  canApprovePosts: boolean;
+  canUploadFree: boolean;
+}
+
+export function parseUser(user: UserResponse): E621User {
+  return {
+    id: user.id,
+    name: user.name,
+    createdAt: new Date(user.created_at),
+
+    profile: {
+      level: user.level,
+      about: user.profile_about,
+      artInfo: user.profile_artinfo,
+      avatarId: user.avatar_id,
+      levelString: user.level_string,
+    },
+
+    counts: {
+      wikiPageVersion: user.wiki_page_version_count,
+      artistVersion: user.artist_version_count,
+      poolVersion: user.pool_version_count,
+      forumPost: user.forum_post_count,
+      comment: user.comment_count,
+      flag: user.flag_count,
+      favorite: user.favorite_count,
+      positiveFeedback: user.positive_feedback_count,
+      neutralFeedback: user.neutral_feedback_count,
+      negativeFeedback: user.negative_feedback_count,
+    },
+
+    limits: {
+      upload: user.upload_limit,
+      baseUpload: user.base_upload_limit,
+      postUpload: user.post_upload_count,
+      postUpdate: user.post_update_count,
+      noteUpdate: user.note_update_count,
+    },
+
+    isBanned: user.is_banned,
+    canApprovePosts: user.can_approve_posts,
+    canUploadFree: user.can_upload_free,
+  };
+}

package/src/types/responses.ts

@@ -1,13 +1,13 @@
-import { PostResponse } from "./e621/E621Post";
-
-export type GetFavoritesResponse = {
-  posts: PostResponse[] | null;
-};
-
-export type GetPostResponse = {
-  post: PostResponse | null;
-};
-
-export type GetPostsResponse = {
-  posts: PostResponse[];
-};
+import { PostResponse } from "./e621/E621Post";
+
+export type GetFavoritesResponse = {
+  posts: PostResponse[] | null;
+};
+
+export type GetPostResponse = {
+  post: PostResponse | null;
+};
+
+export type GetPostsResponse = {
+  posts: PostResponse[];
+};

package/src/utils.ts

@@ -1,19 +1,19 @@
-export function ensureArray<T>(value: T | T[]): T[] {
-  if (Array.isArray(value)) {
-    return value;
-  }
-  return [value];
-}
-
-export function translateOptions<Options extends Record<string, string>>(
-  options: Options,
-  table: Partial<Options>
-): Record<string, string> {
-  const params: Record<string, string> = {};
-
-  for (const [key, value] of Object.entries(options)) {
-    params[table[key] ?? key] = value;
-  }
-
-  return params;
-}
+export function ensureArray<T>(value: T | T[]): T[] {
+  if (Array.isArray(value)) {
+    return value;
+  }
+  return [value];
+}
+
+export function translateOptions<Options extends Record<string, string>>(
+  options: Options,
+  table: Partial<Options>,
+): Record<string, string> {
+  const params: Record<string, string> = {};
+
+  for (const [key, value] of Object.entries(options)) {
+    params[table[key] ?? key] = value;
+  }
+
+  return params;
+}