eclesiar-sdk 1.0.0

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "eclesiar-sdk",
+  "version": "1.0.0",
+  "description": "",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "require": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "license": "ISC",
+  "type": "module",
+  "scripts": {
+    "build": "tsc --declaration --outDir dist --moduleResolution node && tsc-alias"
+  },
+  "devDependencies": {
+    "@types/node": "^24.0.15",
+    "tsc-alias": "^1.8.16",
+    "typescript": "^5.8.3"
+  }
+}

package/src/api/accounts/getAccount.ts

@@ -0,0 +1,9 @@
+import { apiFetch } from "@/client";
+import { AccountData } from "@/types/accounts";
+
+export async function getAccount({
+   account_id
+}: { account_id: number }): Promise<AccountData>{
+    const params = new URLSearchParams({ account_id: String(account_id) });
+    return apiFetch<AccountData>(`/account?${params.toString()}`)
+}   

package/src/api/accounts/getMyEquipment.ts

@@ -0,0 +1,9 @@
+import { apiFetch } from "@/client";
+import { EquipmentItem } from "@/types/accounts";
+
+export async function getMyEquipment({
+   page = 1
+}: { page?: number } = {}): Promise<EquipmentItem[]>{
+    const params = new URLSearchParams({ page: String(page) });
+    return apiFetch<EquipmentItem[]>(`/account/mine/equipments?${params.toString()}`)
+}

package/src/api/accounts/index.ts

@@ -0,0 +1,14 @@
+import { getAccount } from './getAccount';
+import { getMyEquipment } from './getMyEquipment';
+
+import type { AccountsApi } from './types';
+
+export const accountsApi: AccountsApi = {
+    getAccount,
+    getMyEquipment,
+}
+export type { AccountsApi };
+export {
+    getAccount,
+    getMyEquipment,
+}

package/src/api/accounts/types.ts

@@ -0,0 +1,6 @@
+import { AccountData, EquipmentItem } from "@/types";
+
+export interface AccountsApi {
+    getAccount({ account_id }: { account_id: number }): Promise<AccountData>
+    getMyEquipment(): Promise<EquipmentItem[]>;
+}

package/src/api/countries/getCountries.ts

@@ -0,0 +1,7 @@
+import { apiFetch } from "@/client";
+import { Nation } from "@/types/country";
+
+export async function getCountries(
+): Promise<Nation[]>{
+    return apiFetch<Nation[]>(`/countries`)
+}

package/src/api/countries/getCountryRegions.ts

@@ -0,0 +1,13 @@
+import { apiFetch } from "@/client";
+import { Region } from "@/types/country";
+
+type GetCountryRegionsParams = {
+    country_id: number;
+};
+
+export async function getCountryRegions({
+    country_id
+}: GetCountryRegionsParams): Promise<Region[]>{
+    const params = new URLSearchParams({ country_id: String(country_id) });
+    return apiFetch<Region[]>(`/country/regions?${params.toString()}`)
+}   

package/src/api/countries/index.ts

@@ -0,0 +1,14 @@
+import { getCountries } from './getCountries';
+import { getCountryRegions } from './getCountryRegions';
+
+import type { CountriesApi } from './types';
+
+export const countriesApi: CountriesApi = {
+    getCountries,
+    getCountryRegions,
+}
+export type { CountriesApi };
+export {
+    getCountries,
+    getCountryRegions,
+}

package/src/api/countries/types.ts

@@ -0,0 +1,6 @@
+import { Nation, Region } from "@/types";
+
+export interface CountriesApi {
+    getCountries(): Promise<Nation[]>;
+    getCountryRegions({ country_id }: { country_id: number }): Promise<Region[]>;
+}

package/src/api/index.ts

@@ -0,0 +1,13 @@
+export { accountsApi as accounts } from './accounts';
+export { countriesApi as countries } from './countries';
+export { marketApi as market } from './market';
+export { serverApi as server } from './server';
+export { statisticsApi as statistics } from './statistics';
+export { warsApi as wars } from './wars';
+
+export type { AccountsApi } from './accounts/types';
+export type { CountriesApi } from './countries/types';
+export type { MarketApi } from './market/types';
+export type { ServerApi } from './server/types';
+export type { StatisticsApi } from './statistics/types';
+export type { WarsApi } from './wars/types';

package/src/api/market/getAuctionBid.ts

@@ -0,0 +1,14 @@
+import { apiFetch } from "@/client";
+import { MarketAuctionBid } from "@/types/market";
+
+export async function getAuctionBid({
+  auction_id,
+  page = 1,
+}: { auction_id: number; page?: number }): Promise<MarketAuctionBid[]> {
+  const params = new URLSearchParams({
+    auction_id: String(auction_id),
+    page: String(page),
+  });
+
+  return apiFetch<MarketAuctionBid[]>(`/market/auction/bids/get?${params.toString()}`);
+}

package/src/api/market/getAuctions.ts

@@ -0,0 +1,13 @@
+import { apiFetch } from "@/client";
+import { MarketAuction } from "@/types/market";
+
+export async function getAuctions({
+  finished = 0,
+  page = 1,
+}: { finished?: 0 | 1; page?: number } = {}): Promise<MarketAuction[]> {
+  const params = new URLSearchParams({
+    finished: finished.toString(),
+    page: page.toString(),
+  });
+  return apiFetch<MarketAuction[]>(`/market/auctions/get?${params.toString()}`);
+}

package/src/api/market/getCoinOffers.ts

@@ -0,0 +1,20 @@
+import { apiFetch } from '@/client';
+import { MarketCoinOffer } from '@/types/market';
+
+export async function getCoinOffers({
+  currency_id,
+  transaction = 'BUY',
+  page = 1,
+}: {
+  currency_id: number;
+  transaction?: 'BUY' | 'SELL';
+  page?: number;
+}): Promise<MarketCoinOffer[]> {
+  const query = new URLSearchParams({
+    currency_id: String(currency_id),
+    transaction: String(transaction),
+    page: String(page),
+  });
+
+  return apiFetch<MarketCoinOffer[]>(`/market/coin/get?${query}`);
+}

package/src/api/market/getItemOffers.ts

@@ -0,0 +1,20 @@
+import { apiFetch } from '@/client';
+import { MarketItemOffer } from '@/types/market';
+
+export async function getItemOffers({
+  country_id,
+  item_id,
+  page = 1,
+}: {
+  country_id: number;
+  item_id: number;
+  page?: number;
+}): Promise<MarketItemOffer[]> {
+  const query = new URLSearchParams({
+    country_id: String(country_id),
+    item_id: String(item_id),
+    page: String(page),
+  });
+
+  return apiFetch<MarketItemOffer[]>(`/market/items/get?${query}`);
+}

package/src/api/market/getJobs.ts

@@ -0,0 +1,19 @@
+import { apiFetch } from "@/client";
+import { MarketJobOffer } from "@/types/market";
+
+type GetJobsParams = {
+  country_id: number;
+  page?: number;
+};
+
+export async function getJobs({
+  country_id,
+  page = 1,
+}: GetJobsParams): Promise<MarketJobOffer[]> {
+  const query = new URLSearchParams({
+    country_id: String(country_id),
+    page: String(page),
+  });
+
+  return apiFetch<MarketJobOffer[]>(`/market/jobs/get?${query}`);
+}   

package/src/api/market/index.ts

@@ -0,0 +1,23 @@
+import { getCoinOffers } from './getCoinOffers';
+import { getItemOffers } from './getItemOffers';
+import { getJobs } from './getJobs';
+import { getAuctions } from './getAuctions';
+import { getAuctionBid } from './getAuctionBid';
+
+import type { MarketApi } from './types';
+
+export const marketApi: MarketApi = {
+    getCoinOffers,
+    getItemOffers,
+    getJobs,
+    getAuctions,
+    getAuctionBid,
+}
+export type { MarketApi };
+export {
+    getCoinOffers,
+    getItemOffers,
+    getJobs,
+    getAuctions,
+    getAuctionBid,
+}

package/src/api/market/types.ts

@@ -0,0 +1,9 @@
+import { MarketAuction, MarketAuctionBid, MarketCoinOffer, MarketItemOffer, MarketJobOffer } from "@/types";
+
+export interface MarketApi {
+    getCoinOffers({ currency_id, transaction, page }: { currency_id: number, transaction: 'BUY' | 'SELL', page?: number }): Promise<MarketCoinOffer[]>;
+    getItemOffers({ country_id, item_id, page }: { country_id: number, item_id: number, page?: number }): Promise<MarketItemOffer[]>;
+    getJobs({ country_id, page }: { country_id: number, page?: number }): Promise<MarketJobOffer[]>;
+    getAuctions({ finished, page }: { finished?: 0 | 1, page?: number }): Promise<MarketAuction[]>;
+    getAuctionBid({ auction_id, page }: { auction_id: number, page?: number }): Promise<MarketAuctionBid[]>;
+}

package/src/api/server/getEquipments.ts

@@ -0,0 +1,9 @@
+import { apiFetch } from "@/client";
+import { ServerEquipment } from "@/types/server";
+
+export async function getServerEquipments(
+  { page = 1 }: { page?: number } = {}
+): Promise<ServerEquipment[]> {
+  const params = new URLSearchParams({ page: String(page) });
+return apiFetch<ServerEquipment[]>(`/server/equipments?${params}`);
+} 

package/src/api/server/getItems.ts

@@ -0,0 +1,9 @@
+import { apiFetch } from "@/client";
+import { ServerItem } from "@/types/server";
+
+export async function getServerItems(
+  { page = 1 }: { page?: number } = {}
+): Promise<ServerItem[]> {
+  const params = new URLSearchParams({ page: String(page) });
+return apiFetch<ServerItem[]>(`/server/items?${params}`);
+}

package/src/api/server/getStatus.ts

@@ -0,0 +1,6 @@
+import { apiFetch } from "@/client";
+import { ServerStatus } from "@/types/server";
+
+export async function getServerStatus(): Promise<ServerStatus[]> {
+  return apiFetch<ServerStatus[]>("/server/status");
+}

package/src/api/server/index.ts

@@ -0,0 +1,17 @@
+import { getServerStatus } from './getStatus';
+import { getServerItems } from './getItems';
+import { getServerEquipments } from './getEquipments';
+
+import type { ServerApi } from './types';
+
+export const serverApi: ServerApi = {
+  getServerStatus,
+  getServerItems,
+  getServerEquipments,
+};
+export type { ServerApi };
+export {
+  getServerStatus,
+  getServerItems,
+  getServerEquipments,
+};

package/src/api/server/types.ts

@@ -0,0 +1,6 @@
+import { ServerEquipment, ServerItem, ServerStatus } from "@/types/server";
+export interface ServerApi {
+    getServerStatus(): Promise<ServerStatus[]>;
+    getServerItems({ page }: { page?: number }): Promise<ServerItem[]>;
+    getServerEquipments({ page }: { page?: number }): Promise<ServerEquipment[]>;
+}

package/src/api/statistics/getStatistics.ts

@@ -0,0 +1,14 @@
+import { apiFetch } from "@/client";
+import { CountryStatisticType, RankingItem } from "@/types/statistics";
+
+type GetStatisticsParams = {
+  statistic: CountryStatisticType;
+};
+
+export async function getStatistics({
+  statistic,
+}: GetStatisticsParams): Promise<RankingItem[]> {
+  const query = new URLSearchParams({ statistic });
+
+  return apiFetch<RankingItem[]>(`/statistics/country?${query}`);
+}

package/src/api/statistics/index.ts

@@ -0,0 +1,12 @@
+import { getStatistics } from './getStatistics';
+
+import type { StatisticsApi } from './types';
+
+export const statisticsApi: StatisticsApi = {
+    getStatistics,
+}
+
+export type { StatisticsApi };
+export {
+    getStatistics,
+}

package/src/api/statistics/types.ts

@@ -0,0 +1,5 @@
+import { CountryStatisticType, RankingItem } from "@/types";
+
+export interface StatisticsApi {
+    getStatistics({ statistic }: { statistic: CountryStatisticType }): Promise<RankingItem[]>;
+}

package/src/api/wars/getWarRoundHits.ts

@@ -0,0 +1,19 @@
+import { apiFetch } from "@/client";
+import { WarHit } from "@/types/wars";
+
+type GetWarRoundHitsParams = {
+  war_round_id: number;
+  page?: number;
+};
+
+export async function getWarRoundHits({
+  war_round_id,
+  page = 1,
+}: GetWarRoundHitsParams): Promise<WarHit[]> {
+  const query = new URLSearchParams({
+    war_round_id: String(war_round_id),
+    page: String(page),
+  });
+
+  return apiFetch<WarHit[]>(`/war/round/hits?${query}`);
+}

package/src/api/wars/getWarRounds.ts

@@ -0,0 +1,11 @@
+import { apiFetch } from "@/client";
+import { WarRound } from "@/types/wars";
+
+type GetWarRoundsParams = {
+  war_id: number;
+};
+
+export async function getWarRounds({ war_id }: GetWarRoundsParams): Promise<WarRound[]> {
+  const query = new URLSearchParams({ war_id: String(war_id) });
+  return apiFetch<WarRound[]>(`/war/rounds?${query}`);
+} 

package/src/api/wars/getWars.ts

@@ -0,0 +1,22 @@
+import { apiFetch } from "@/client";
+import { War } from "@/types/wars";
+
+type GetWarsParams = {
+  event_wars?: 0 | 1;
+  extra_details?: 0 | 1;
+  war_id?: number;
+};
+
+export async function getWars({
+  event_wars = 0,
+  extra_details = 0,
+  war_id = 0,
+}: GetWarsParams = {}): Promise<War[]> {
+  const query = new URLSearchParams({
+    event_wars: String(event_wars),
+    extra_details: String(extra_details),
+    war_id: String(war_id),
+  });
+
+  return apiFetch<War[]>(`/wars?${query}`);
+}

package/src/api/wars/index.ts

@@ -0,0 +1,18 @@
+import { getWars } from './getWars';
+import { getWarRounds } from './getWarRounds';
+import { getWarRoundHits } from './getWarRoundHits';
+
+import type { WarsApi } from './types';
+
+export const warsApi: WarsApi = {
+    getWars,
+    getWarRounds,
+    getWarRoundHits,
+}
+
+export type { WarsApi };
+export {
+    getWars,
+    getWarRounds,
+    getWarRoundHits,
+}

package/src/api/wars/types.ts

@@ -0,0 +1,7 @@
+import { WarRound, WarHit, War } from "@/types";
+
+export interface WarsApi {
+    getWars(): Promise<War[]>;
+    getWarRounds({ war_id }: { war_id: number }): Promise<WarRound[]>;
+    getWarRoundHits({ war_round_id }: { war_round_id: number }): Promise<WarHit[]>;
+}

package/src/client.ts

@@ -0,0 +1,68 @@
+import { accountsApi } from './api/accounts';
+import { countriesApi } from './api/countries';
+import { marketApi } from './api/market';
+import { serverApi } from './api/server';
+import { statisticsApi } from './api/statistics';
+import { warsApi } from './api/wars';
+
+import type { AccountsApi } from './api/accounts/types';
+import type { CountriesApi } from './api/countries/types';
+import type { MarketApi } from './api/market/types';
+import type { ServerApi } from './api/server/types';
+import type { StatisticsApi } from './api/statistics/types';
+import type { WarsApi } from './api/wars/types';
+
+type ApiResponse<T> = {
+  code: number;
+  description: string;
+  data: T;
+};
+
+const BASE_URL = 'https://api.eclesiar.com';
+
+let token = '';
+
+export function setToken(newToken: string) {
+  token = newToken;
+}
+
+export async function apiFetch<T>(
+  endpoint: string,
+  options: RequestInit = {}
+): Promise<T> {
+  const res = await fetch(`${BASE_URL}${endpoint}`, {
+    ...options,
+    headers: {
+      Authorization: `Bearer ${token}`,
+      ...(options.headers || {}),
+    },
+  });
+
+  if (!res.ok) {
+    throw new Error(
+      `API Error: ${res.status} ${res.statusText} ${endpoint}`
+    );
+  }
+
+  const json: ApiResponse<T> = await res.json();
+
+  return json.data;
+}
+
+export interface SdkClient {
+  accounts: AccountsApi;
+  countries: CountriesApi;
+  market: MarketApi;
+  server: ServerApi;
+  statistics: StatisticsApi;
+  wars: WarsApi;
+}
+
+export const apiClient: SdkClient = {
+  accounts: accountsApi,
+  countries: countriesApi,
+  market: marketApi,
+  server: serverApi,
+  statistics: statisticsApi,
+  wars: warsApi,
+};

package/src/index.ts

@@ -0,0 +1,10 @@
+export { apiClient, setToken } from './client';
+export type {
+  AccountsApi,
+  CountriesApi,
+  MarketApi,
+  ServerApi,
+  StatisticsApi,
+  WarsApi,
+} from './api';
+export type { SdkClient } from './client'; 

package/src/types/accounts.ts

@@ -0,0 +1,17 @@
+export type AccountData = {
+    id: number;
+    username: string;
+    avatar: string;
+    region_id: number;
+    nationality_id: number;
+    total_damage: number;
+    total_mined_gold: number;
+    total_builder_progress: number;
+    day_of_birth: number;
+  }
+
+  export type EquipmentItem = {
+    id: number;
+    equipment_id: number;
+    is_equipped: boolean;
+  }

package/src/types/country.ts

@@ -0,0 +1,41 @@
+export type Currency = {
+    id: number;
+    name: string;
+    symbol: string; 
+  }
+  
+  export type Nation = {
+    id: number;
+    name: string;
+    avatar: string;
+    currency: Currency;
+  }
+
+  export interface RegionBonus {
+    type: string; 
+    value: number;
+  }
+  
+  export type RegionFactories = {
+    food: number;
+    weapon: number;
+    oil: number;
+    grain: number;
+    iron: number;
+    aircraft: number;
+    titanium: number;
+    tickets: number;
+  }
+  
+  export type Region = {
+    id: number;
+    name: string;
+    type: number;
+    population: number;
+    original_country_id: number;
+    country_id: number;
+    nb_npcs: number;
+    pollution: number;
+    factories: RegionFactories;
+    bonus: RegionBonus[];
+  }

package/src/types/index.ts

@@ -0,0 +1,6 @@
+export * from './market';
+export * from './server';
+export * from './accounts'
+export * from './country'
+export * from './statistics'
+export * from './wars'

package/src/types/market.ts

@@ -0,0 +1,61 @@
+export interface ApiResponse<T> {
+  code: number;
+  description: string;
+  data: T;
+}
+
+export interface MarketCoinOffer {
+  id: number;
+  currency_id: number;
+  amount: number;
+  price: number;
+  owner: {
+    id: number;
+    type: string;
+  };
+}
+
+export interface MarketItemOffer {
+  id: number;
+  item_id: number;
+  amount: number;
+  price: number;
+  owner: {
+    id: number;
+    type: string;
+  };
+}
+
+export interface MarketJobOffer {
+  value: number;
+  amount: number;
+  economic_skill: number;
+  currency_id: number;
+  business_id: number;
+}
+
+export interface MarketAuction {
+  id: number;
+  item: {
+    id: number;
+    type: string;
+  };
+  owner: {
+    id: number;
+    type: string;
+  };
+  initial_bid: number;
+  created_at: string;
+  end_at: string;
+  status: number;
+}
+
+export interface MarketAuctionBid {
+  id: number;
+  bid: number;
+  created_at: string;
+  owner: {
+    id: number;
+    type: string;
+  };
+}

package/src/types/server.ts

@@ -0,0 +1,41 @@
+export type ServerStatus = {
+    status: string;
+    version: string;
+    server_name: string;
+    server_time: string;
+    server_day: number;
+  };
+  
+  export type ServerItem = {
+    id: number;
+    name: string;
+    quality: number;
+    type: string;
+    avatar: string;
+  };
+  
+  export type ServerEquipment = {
+    id: number;
+    slot: number;
+    grade: number;
+    critical_chance: number;
+    critical_hit: number;
+    damage_percentage: number;
+    true_damage: number;
+    flatland_damage_percentage: number;
+    mountains_damage_percentage: number;
+    forest_damage_percentage: number;
+    desert_damage_percentage: number;
+    accuracy: number;
+    drop_chance: number;
+    construction_percentage: number;
+    hospital_construction_percentage: number;
+    militarybase_construction_percentage: number;
+    productionfields_construction_percentage: number;
+    industrialzone_construction_percentage: number;
+    construction_item_donation_percentage: number;
+    mining_gold_percentage: number;
+    construction_energy_reduction_percentage: number;
+    avatar: string;
+    drop_category: string;
+  };

package/src/types/statistics.ts

@@ -0,0 +1,25 @@
+export type CountryStatisticType =
+  | "development"
+  | "citizens"
+  | "builders"
+  | "buildings"
+  | "miners"
+  | "todaycitizens"
+  | "productivity"
+  | "activecitizens"
+  | "damagetoday"
+  | "damage"
+  | "strength"
+  | "regions"
+  | "npcwage";
+
+  export type RankedEntity = {
+    id: number;
+    name: string;
+    avatar: string;
+  }
+  
+  export type RankingItem = {
+    entity: RankedEntity;
+    value: number;
+  }

package/src/types/wars.ts

@@ -0,0 +1,51 @@
+export type WarNation = {
+  id: number;
+  name: string;
+  avatar: string;
+};
+
+export type WarRegion = {
+  id: number;
+  name: string;
+};
+
+export type WarFlags = {
+  is_revolution: 0 | 1;
+};
+
+export type War = {
+  id: number;
+  attackers: WarNation;
+  defenders: WarNation;
+  region: WarRegion;
+  attackers_score: number;
+  defenders_score: number;
+  current_round_number: number;
+  current_round_id: number;
+  flags: WarFlags;
+};
+
+export type WarRound = {
+  id: number;
+  end_date: string;
+  attackers_score: number;
+  defenders_score: number;
+  attackers_points: number;
+  defenders_points: number;
+  attackers_hero: number | null;
+  defenders_hero: number | null;
+};
+
+export type HitFighter = {
+  id: number;
+  type: "account";
+};
+
+export type WarHit = {
+  id: number;
+  fighter: HitFighter;
+  damage: number;
+  side: "ATTACKER" | "DEFENDER";
+  item_id: number | null;
+  created_at: string;
+};

package/tsconfig.json

@@ -0,0 +1,18 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "node",
+    "outDir": "dist",
+    "declaration": true,
+    "emitDeclarationOnly": false,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "baseUrl": "./src",
+    "paths": {
+      "@/*": ["*"]
+    }
+  },
+  "include": ["src"]
+}