pterodactyl-api-client 3.4.1 → 4.1.0

package/README.md

@@ -1,9 +1,7 @@
 # pterodactyl‑api‑client
 
-Client API TypeScript pour l’**API client de Pterodactyl**.
-Fournit une interface typée, modulaire et orientée classes pour consommer l’API du panel Pterodactyl (comptes, serveurs, websockets, etc.).
-
-**API client** = endpoints disponibles avec une _Client API Key_ générée dans le panel utilisateur.
+Client API TypeScript pour l’**API Client & Application de Pterodactyl**.
+Fournit une interface typée, modulaire et orientée classes pour consommer l’API du panel Pterodactyl (comptes, serveurs, localisations, nodes, nests, eggs, bases de données, websockets, etc.).
 
 ---
 
@@ -23,8 +21,14 @@ npm install pterodactyl-api-client
 import { PterodactylAPIClient } from 'pterodactyl-api-client';
 
 const client = new PterodactylAPIClient({
-  baseUrl: 'https://panel.example.com',
+  panelUrl: 'https://panel.example.com',
   apiKey: 'VOTRE_CLE_API',
+  role: 'admin', // 'admin' ou 'user'
+  cache: {
+    users: 300000, // TTL cache pour les utilisateurs en ms
+    servers: 60000, // TTL cache pour les serveurs
+    // optionnel pour d'autres entités : nodes, locations, nests, eggs, etc.
+  },
 });
 ```
 
@@ -34,20 +38,23 @@ const client = new PterodactylAPIClient({
 const { PterodactylAPIClient } = require('pterodactyl-api-client');
 
 const client = new PterodactylAPIClient({
-  baseUrl: 'https://panel.example.com',
+  panelUrl: 'https://panel.example.com',
   apiKey: 'VOTRE_CLE_API',
+  role: 'admin',
 });
 ```
 
 ---
 
-## Utilisation basique
+## Utilisation : API Client (`role: 'user'` ou `'admin'`)
+
+Disponible via la propriété `client.user`.
 
 ### Compte utilisateur
 
 ```js
-const info = await client.user.account.info();
-console.log(info.attributes.username);
+const info = await client.user.account.fetch();
+console.log(info.username);
 ```
 
 ### Gestion des clés API
@@ -61,28 +68,66 @@ const created = await client.user.account.apiKey.create({
 });
 ```
 
-### Serveurs
+### Serveurs Client
+
+L'API client pour les serveurs est accessible via le gestionnaire `client.user.servers` (ClientServerManager).
 
 ```js
+// Liste les serveurs
 const servers = await client.user.servers.list();
 const srv = servers.data[0];
 
-// Récupère les détails
-const detail = await client.user.servers.info(srv.attributes.identifier);
+// Récupère les détails d'un serveur
+const detail = await client.user.servers.fetch(srv.identifier);
+console.log(detail.name);
 ```
 
-### Activité d’un serveur
+---
+
+## Utilisation : API Application/Admin (`role: 'admin'`)
+
+Disponible via la propriété `client.admin`. Cette API bénéficie d'un cache local personnalisable et de gestionnaires orientés classes.
+
+### Gestionnaires disponibles
+
+- `client.admin.users` (UserManager)
+- `client.admin.servers` (ApplicationServerManager)
+- `client.admin.locations` (LocationManager)
+- `client.admin.nodes` (NodeManager)
+- `client.admin.nests` (NestManager)
+
+### Exemple d'utilisation
 
 ```js
-const activity = await client.user.servers.activity.list({
+// Récupérer et lister les utilisateurs côté admin
+const paginatedUsers = await client.admin.users.list({
   page: 1,
-  per_page: 50,
+  per_page: 10,
 });
+
+// Récupérer un serveur par son ID avec cache
+const server = await client.admin.servers.fetch(1);
+console.log(server.name);
+```
+
+### Utilisation de `resolve()`
+
+La méthode synchrone `resolve` permet de récupérer instantanément une ressource à partir du cache local si elle est présente, ou de retourner une instance partielle (contenant uniquement l'ID) si elle n'est pas en cache. Cela évite des requêtes réseau inutiles.
+
+```js
+// Récupère le serveur depuis le cache ou crée une instance légère (côté client)
+const server = client.user.servers.resolve('e1a2b3c4');
+
+// Ou côté admin/application
+const adminServer = client.admin.servers.resolve(12);
+
+// Vous pouvez ensuite chaîner directement des appels d'API associés à cette instance
+await server.databases.list();
 ```
 
 ---
 
-## WebSockets (serveur)
+## WebSockets (serveur client)
 
 Pterodactyl offre un endpoint WebSocket pour recevoir :
 
@@ -94,7 +139,7 @@ Pterodactyl offre un endpoint WebSocket pour recevoir :
 Pour se connecter :
 
 ```js
-await client.user.servers.websocket.connect(serverId, {
+await client.user.servers.resolve(serverId).console.websocket.connect({
   onStats: (stats) => {
     console.log(stats);
   },
@@ -104,28 +149,19 @@ await client.user.servers.websocket.connect(serverId, {
 });
 ```
 
-Les tokens WS sont temporaires (≈ 10 min), il faut gérer les reconnexions.
-
 ---
 
 ## Erreurs & exceptions
 
-Les erreurs retournées par l’API sont encapsulées dans une classe d’erreur dédiée, permettant de distinguer :
-
-- erreurs réseau
-- erreurs de validation
-- erreurs API avec statut HTTP
+Les erreurs retournées par l’API sont encapsulées dans une classe d’erreur dédiée, `ApiError`.
 
 ```js
-import { PterodactylAPIError } from 'pterodactyl-api-client';
+import { ApiError } from 'pterodactyl-api-client';
 
 try {
-  const activity = await client.user.servers.activity.list({
-    page: 1,
-    per_page: 50,
-  });
+  const info = await client.user.account.fetch();
 } catch (e) {
-  if (e instanceof PterodactylAPIError) {
+  if (e instanceof ApiError) {
     console.error('HTTP Status :', e.status);
     console.error('Message :', e.message);
     console.error('Endpoint :', e.path);

package/dist/application/application.client.d.ts

@@ -1,31 +1,21 @@
-import LocationClient from './location/location.client.js';
-import LocationsClient from './locations/locations.client.js';
-import NestClient from './nest/nest.client.js';
-import NestsClient from './nests/nests.client.js';
-import NodeClient from './node/node.client.js';
-import NodesClient from './nodes/nodes.client.js';
-import ServerClient from './server/server.client.js';
-import UserClient from './user/user.client.js';
-import UsersClient from './users/users.client.js';
-import ServersClient from './servers/servers.client.js';
-import type { UserId } from './user/user.types.js';
-import type { ApplicationServerId } from './server/server.types.js';
-export default class ApplicationAPI {
+import { LocationManager } from './location/location.manager.js';
+import { NestManager } from './nest/nest.manager.js';
+import { NodeManager } from './node/node.manager.js';
+import { ApplicationServerManager } from './server/server.manager.js';
+import { UserManager } from './user/user.manager.js';
+import type { CacheTtlOptions } from '../types.js';
+export declare class ApplicationAPI {
     private httpClient;
     readonly panelUrl: URL;
-    users: UsersClient;
-    servers: ServersClient;
-    locations: LocationsClient;
-    nodes: NodesClient;
-    nests: NestsClient;
-    constructor({ apiKey, panelUrl }: {
+    users: UserManager;
+    servers: ApplicationServerManager;
+    locations: LocationManager;
+    nodes: NodeManager;
+    nests: NestManager;
+    constructor({ apiKey, panelUrl, cache, }: {
         apiKey: string;
         panelUrl: URL;
+        cache?: CacheTtlOptions;
     });
-    location(id: number): LocationClient;
-    nest(id: number): NestClient;
-    node(id: number): NodeClient;
-    server(id: ApplicationServerId): ServerClient;
-    user(id: UserId): UserClient;
 }
 //# sourceMappingURL=application.client.d.ts.map

package/dist/application/application.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.client.d.ts","sourceRoot":"","sources":["../../src/application/application.client.ts"],"names":[],"mappings":"AACA,OAAO,cAAc,MAAM,+BAA+B,CAAC;AAC3D,OAAO,eAAe,MAAM,iCAAiC,CAAC;AAC9D,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAClD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAClD,OAAO,YAAY,MAAM,2BAA2B,CAAC;AACrD,OAAO,UAAU,MAAM,uBAAuB,CAAC;AAC/C,OAAO,WAAW,MAAM,yBAAyB,CAAC;AAClD,OAAO,aAAa,MAAM,6BAA6B,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,CAAC,OAAO,OAAO,cAAc;IACjC,OAAO,CAAC,UAAU,CAAa;IAC/B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,aAAa,CAAC;IACvB,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;gBAEd,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,GAAG,CAAA;KAAE;IAUnE,QAAQ,CAAC,EAAE,EAAE,MAAM;IAInB,IAAI,CAAC,EAAE,EAAE,MAAM;IAIf,IAAI,CAAC,EAAE,EAAE,MAAM;IAIf,MAAM,CAAC,EAAE,EAAE,mBAAmB;IAI9B,IAAI,CAAC,EAAE,EAAE,MAAM;CAGhB"}
+{"version":3,"file":"application.client.d.ts","sourceRoot":"","sources":["../../src/application/application.client.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACjE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AACtE,OAAO,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAC;AACrD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,qBAAa,cAAc;IACzB,OAAO,CAAC,UAAU,CAAa;IAC/B,QAAQ,CAAC,QAAQ,EAAE,GAAG,CAAC;IAChB,KAAK,EAAE,WAAW,CAAC;IACnB,OAAO,EAAE,wBAAwB,CAAC;IAClC,SAAS,EAAE,eAAe,CAAC;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,WAAW,CAAC;gBAEd,EACV,MAAM,EACN,QAAQ,EACR,KAAK,GACN,EAAE;QACD,MAAM,EAAE,MAAM,CAAC;QACf,QAAQ,EAAE,GAAG,CAAC;QACd,KAAK,CAAC,EAAE,eAAe,CAAC;KACzB;CAiBF"}

package/dist/application/application.client.js

@@ -1,15 +1,10 @@
-import HttpClient from '../class/HttpClient.js';
-import LocationClient from './location/location.client.js';
-import LocationsClient from './locations/locations.client.js';
-import NestClient from './nest/nest.client.js';
-import NestsClient from './nests/nests.client.js';
-import NodeClient from './node/node.client.js';
-import NodesClient from './nodes/nodes.client.js';
-import ServerClient from './server/server.client.js';
-import UserClient from './user/user.client.js';
-import UsersClient from './users/users.client.js';
-import ServersClient from './servers/servers.client.js';
-export default class ApplicationAPI {
+import { HttpClient } from '../class/HttpClient.js';
+import { LocationManager } from './location/location.manager.js';
+import { NestManager } from './nest/nest.manager.js';
+import { NodeManager } from './node/node.manager.js';
+import { ApplicationServerManager } from './server/server.manager.js';
+import { UserManager } from './user/user.manager.js';
+export class ApplicationAPI {
     httpClient;
     panelUrl;
     users;
@@ -17,28 +12,13 @@ export default class ApplicationAPI {
     locations;
     nodes;
     nests;
-    constructor({ apiKey, panelUrl }) {
+    constructor({ apiKey, panelUrl, cache, }) {
         this.panelUrl = panelUrl;
         this.httpClient = new HttpClient(panelUrl, apiKey);
-        this.users = new UsersClient(this.httpClient);
-        this.servers = new ServersClient(this.httpClient);
-        this.locations = new LocationsClient(this.httpClient);
-        this.nodes = new NodesClient(this.httpClient);
-        this.nests = new NestsClient(this.httpClient);
-    }
-    location(id) {
-        return new LocationClient(this.httpClient, id);
-    }
-    nest(id) {
-        return new NestClient(this.httpClient, id);
-    }
-    node(id) {
-        return new NodeClient(this.httpClient, id);
-    }
-    server(id) {
-        return new ServerClient(this.httpClient, id);
-    }
-    user(id) {
-        return new UserClient(this.httpClient, id);
+        this.servers = new ApplicationServerManager(this.httpClient, cache?.servers, cache?.databases);
+        this.users = new UserManager(this.httpClient, this.servers, cache?.users);
+        this.locations = new LocationManager(this.httpClient, cache?.locations);
+        this.nodes = new NodeManager(this.httpClient, cache?.nodes, cache?.allocations);
+        this.nests = new NestManager(this.httpClient, cache?.nests, cache?.eggs);
     }
 }

package/dist/application/index.d.ts

@@ -1,3 +1,7 @@
-export { default as ApplicationAPI } from './application.client.js';
-export * from './user/user.types.js';
+export * from './location/index.js';
+export * from './nest/index.js';
+export * from './node/index.js';
+export * from './server/index.js';
+export * from './user/index.js';
+export * from './application.client.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/application/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEpE,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/application/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,iBAAiB,CAAC;AAChC,cAAc,mBAAmB,CAAC;AAClC,cAAc,iBAAiB,CAAC;AAEhC,cAAc,yBAAyB,CAAC"}

package/dist/application/index.js

@@ -1,2 +1,6 @@
-export { default as ApplicationAPI } from './application.client.js';
-export * from './user/user.types.js';
+export * from './location/index.js';
+export * from './nest/index.js';
+export * from './node/index.js';
+export * from './server/index.js';
+export * from './user/index.js';
+export * from './application.client.js';

package/dist/application/location/index.d.ts

@@ -1,4 +1,5 @@
-export { default as Location } from './location.client.js';
-export * from './location.types.js';
+export * from './location.class.js';
+export * from './location.manager.js';
 export * from './location.schemas.js';
+export * from './location.types.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/application/location/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/application/location/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,QAAQ,EAAE,MAAM,sBAAsB,CAAC;AAE3D,cAAc,qBAAqB,CAAC;AAEpC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/application/location/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC"}

package/dist/application/location/index.js

@@ -1,3 +1,4 @@
-export { default as Location } from './location.client.js';
-export * from './location.types.js';
+export * from './location.class.js';
+export * from './location.manager.js';
 export * from './location.schemas.js';
+export * from './location.types.js';

package/dist/application/location/location.class.d.ts

@@ -0,0 +1,18 @@
+import type { HttpClient } from '../../class/HttpClient.js';
+import type { LocationManager } from './location.manager.js';
+import type { BaseLocation, UpdateLocationPayload } from './location.types.js';
+import type { BaseFetchOptions } from '../../types.js';
+export declare class Location {
+    private httpClient;
+    private locationManager;
+    id: number;
+    short: string;
+    long: string;
+    createdAt: Date;
+    updatedAt: Date;
+    constructor(httpClient: HttpClient, locationManager: LocationManager, data: Partial<BaseLocation> & Pick<BaseLocation, 'id'>);
+    fetch(options?: BaseFetchOptions): Promise<this>;
+    update(payload: UpdateLocationPayload, options?: Omit<BaseFetchOptions, 'force'>): Promise<this>;
+    delete(): Promise<void>;
+}
+//# sourceMappingURL=location.class.d.ts.map

package/dist/application/location/location.class.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.class.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.class.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAM7D,OAAO,KAAK,EACV,YAAY,EAEZ,qBAAqB,EACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,gBAAgB,CAAC;AAEvD,qBAAa,QAAQ;IAQjB,OAAO,CAAC,UAAU;IAClB,OAAO,CAAC,eAAe;IARlB,EAAE,EAAG,MAAM,CAAC;IACZ,KAAK,EAAG,MAAM,CAAC;IACf,IAAI,EAAG,MAAM,CAAC;IACd,SAAS,EAAG,IAAI,CAAC;IACjB,SAAS,EAAG,IAAI,CAAC;gBAGd,UAAU,EAAE,UAAU,EACtB,eAAe,EAAE,eAAe,EACxC,IAAI,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,IAAI,CAAC;IAKlD,KAAK,CAAC,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBhD,MAAM,CACV,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GACxC,OAAO,CAAC,IAAI,CAAC;IAqBV,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;CAO9B"}

package/dist/application/location/location.class.js

@@ -0,0 +1,30 @@
+import { removeManagerCacheSymbol, setManagerCacheSymbol, } from '../../symbols.js';
+import { updateLocationSchema } from './location.schemas.js';
+export class Location {
+    httpClient;
+    locationManager;
+    id;
+    short;
+    long;
+    createdAt;
+    updatedAt;
+    constructor(httpClient, locationManager, data) {
+        this.httpClient = httpClient;
+        this.locationManager = locationManager;
+        Object.assign(this, data);
+    }
+    async fetch(options) {
+        Object.assign(this, (await this.httpClient.request('GET', `/application/locations/${this.id}`, { parseDates: true })).attributes);
+        this.locationManager[setManagerCacheSymbol](this, options?.cache);
+        return this;
+    }
+    async update(payload, options) {
+        Object.assign(this, (await this.httpClient.request('PATCH', `/application/locations/${this.id}`, updateLocationSchema.parse(payload), { parseDates: true })).attributes);
+        this.locationManager[setManagerCacheSymbol](this, options?.cache);
+        return this;
+    }
+    async delete() {
+        this.locationManager[removeManagerCacheSymbol](this.id);
+        await this.httpClient.request('DELETE', `/application/locations/${this.id}`);
+    }
+}

package/dist/application/location/location.client.d.ts

@@ -1,29 +1,12 @@
-import type HttpClient from '../../class/HttpClient.js';
-import type { EditLocationArgs } from './location.types.js';
-export default class LocationClient {
+import type { HttpClient } from '../../class/HttpClient.js';
+import type { UpdateLocationPayload } from './location.types.js';
+import type { Location } from '../locations/locations.types.js';
+export declare class LocationClient {
     private httpClient;
     readonly id: number;
     constructor(httpClient: HttpClient, id: number);
-    info(): Promise<{
-        attributes: {
-            created_at: Date;
-            updated_at: Date;
-            id: number;
-            short: string;
-            long: string;
-        };
-        object: "location";
-    }>;
-    edit(options: EditLocationArgs): Promise<{
-        attributes: {
-            created_at: Date;
-            updated_at: Date;
-            id: number;
-            short: string;
-            long: string;
-        };
-        object: "location";
-    }>;
+    fetch(): Promise<Location>;
+    update(payload: UpdateLocationPayload): Promise<Location>;
     delete(): Promise<void>;
 }
 //# sourceMappingURL=location.client.d.ts.map

package/dist/application/location/location.client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.client.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,UAAU,MAAM,2BAA2B,CAAC;AAExD,OAAO,KAAK,EAAE,gBAAgB,EAAY,MAAM,qBAAqB,CAAC;AAEtE,MAAM,CAAC,OAAO,OAAO,cAAc;IAI/B,OAAO,CAAC,UAAU;IAHpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAGV,UAAU,EAAE,UAAU,EAC9B,EAAE,EAAE,MAAM;IAKN,IAAI;;;;;;;;;;IAeJ,IAAI,CAAC,OAAO,EAAE,gBAAgB;;;;;;;;;;IAmBpC,MAAM;CAMP"}
+{"version":3,"file":"location.client.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,KAAK,EAAE,QAAQ,EAAkB,MAAM,iCAAiC,CAAC;AAGhF,qBAAa,cAAc;IAIvB,OAAO,CAAC,UAAU;IAHpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;gBAGV,UAAU,EAAE,UAAU,EAC9B,EAAE,EAAE,MAAM;IAKN,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC;IAS1B,MAAM,CAAC,OAAO,EAAE,qBAAqB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAa/D,MAAM;CAMP"}

package/dist/application/location/location.client.js

@@ -1,33 +1,18 @@
-import z from 'zod';
-import { editLocationSchema, locationId } from './location.schemas.js';
-export default class LocationClient {
+import { updateLocationSchema, locationId } from './location.schemas.js';
+export class LocationClient {
     httpClient;
     id;
     constructor(httpClient, id) {
         this.httpClient = httpClient;
         this.id = locationId.parse(id);
     }
-    async info() {
-        const res = await this.httpClient.request('GET', `/application/locations/${this.id}`);
-        return {
-            ...res,
-            attributes: {
-                ...res.attributes,
-                created_at: new Date(res.attributes.created_at),
-                updated_at: new Date(res.attributes.updated_at),
-            },
-        };
+    async fetch() {
+        const locationObject = await this.httpClient.request('GET', `/application/locations/${this.id}`, { parseDates: true });
+        return locationObject.attributes;
     }
-    async edit(options) {
-        const res = await this.httpClient.request('PATCH', `/application/locations/${this.id}`, editLocationSchema.parse(options));
-        return {
-            ...res,
-            attributes: {
-                ...res.attributes,
-                created_at: new Date(res.attributes.created_at),
-                updated_at: new Date(res.attributes.updated_at),
-            },
-        };
+    async update(payload) {
+        const locationObject = await this.httpClient.request('PATCH', `/application/locations/${this.id}`, updateLocationSchema.parse(payload), { parseDates: true });
+        return locationObject.attributes;
     }
     delete() {
         return this.httpClient.request('DELETE', `/application/locations/${this.id}`);

package/dist/application/location/location.manager.d.ts

@@ -0,0 +1,14 @@
+import type { BaseFetchOptions, Paginated } from '../../types.js';
+import type { CreateLocationPayload, ListLocationsOptions, LocationId } from './location.types.js';
+import { Location } from './location.class.js';
+import type { HttpClient } from '../../class/HttpClient.js';
+import { BaseCacheManager } from '../../class/BaseCacheManager.js';
+export declare class LocationManager extends BaseCacheManager<LocationId, Location> {
+    private httpClient;
+    constructor(httpClient: HttpClient, cacheTtl?: number);
+    list(options?: ListLocationsOptions): Promise<Paginated<Location>>;
+    fetch(id: LocationId, options?: BaseFetchOptions): Promise<Location>;
+    resolve(id: LocationId): Location;
+    create(payload: CreateLocationPayload, options?: Pick<BaseFetchOptions, 'cache'>): Promise<Location>;
+}
+//# sourceMappingURL=location.manager.d.ts.map

package/dist/application/location/location.manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"location.manager.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.manager.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,gBAAgB,EAEhB,SAAS,EACV,MAAM,gBAAgB,CAAC;AAExB,OAAO,KAAK,EACV,qBAAqB,EACrB,oBAAoB,EACpB,UAAU,EAEX,MAAM,qBAAqB,CAAC;AAM7B,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAEnE,qBAAa,eAAgB,SAAQ,gBAAgB,CAAC,UAAU,EAAE,QAAQ,CAAC;IAEvE,OAAO,CAAC,UAAU;gBAAV,UAAU,EAAE,UAAU,EAC9B,QAAQ,GAAE,MAAuC;IAK7C,IAAI,CAAC,OAAO,CAAC,EAAE,oBAAoB,GAAG,OAAO,CAAC,SAAS,CAAC,QAAQ,CAAC,CAAC;IAqBlE,KAAK,CAAC,EAAE,EAAE,UAAU,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,QAAQ,CAAC;IAoB1E,OAAO,CAAC,EAAE,EAAE,UAAU,GAAG,QAAQ;IAU3B,MAAM,CACV,OAAO,EAAE,qBAAqB,EAC9B,OAAO,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC,GACxC,OAAO,CAAC,QAAQ,CAAC;CAsBrB"}

package/dist/application/location/location.manager.js

@@ -0,0 +1,39 @@
+import { buildQueryParams } from '../../utils/buildQueryParams.js';
+import { createLocationSchema, listLocationsFilterSchema, locationId, } from './location.schemas.js';
+import { Location } from './location.class.js';
+import { ONE_MINUTE_IN_MILLISECONDS } from '../../utils/vars.js';
+import { BaseCacheManager } from '../../class/BaseCacheManager.js';
+export class LocationManager extends BaseCacheManager {
+    httpClient;
+    constructor(httpClient, cacheTtl = ONE_MINUTE_IN_MILLISECONDS * 5) {
+        super(cacheTtl, 'id');
+        this.httpClient = httpClient;
+    }
+    async list(options) {
+        const queries = buildQueryParams({
+            ...options,
+            filter: listLocationsFilterSchema.optional().parse(options?.filter),
+        });
+        const locationObjectList = await this.httpClient.request('GET', `/application/locations?${queries}`, { parseDates: true });
+        return {
+            data: locationObjectList.data.map((locationObject) => this.setCache(new Location(this.httpClient, this, locationObject.attributes), options?.cache)),
+            pagination: locationObjectList.meta.pagination,
+        };
+    }
+    async fetch(id, options) {
+        const cacheLocation = this.getCache(id);
+        if (cacheLocation && !options?.force)
+            return cacheLocation;
+        return this.setCache(new Location(this.httpClient, this, (await this.httpClient.request('GET', `/application/locations/${locationId.parse(id)}`, { parseDates: true })).attributes), options?.cache);
+    }
+    resolve(id) {
+        return super.resolve(id, () => new Location(this.httpClient, this, {
+            id: locationId.parse(id),
+        }));
+    }
+    async create(payload, options) {
+        return this.setCache(new Location(this.httpClient, this, (await this.httpClient.request('POST', '/application/locations', createLocationSchema.parse(payload), {
+            parseDates: true,
+        })).attributes), options?.cache);
+    }
+}

package/dist/application/location/location.schemas.d.ts

@@ -1,7 +1,14 @@
-import z from 'zod';
-export declare const locationId: z.ZodInt;
-export declare const editLocationSchema: z.ZodObject<{
-    short: z.ZodOptional<z.ZodString>;
-    long: z.ZodOptional<z.ZodString>;
-}, z.z.core.$strip>;
+export declare const locationId: import("zod").ZodInt;
+export declare const createLocationSchema: import("zod").ZodObject<{
+    short: import("zod").ZodString;
+    long: import("zod").ZodString;
+}, import("zod/v4/core").$strip>;
+export declare const updateLocationSchema: import("zod").ZodObject<{
+    short: import("zod").ZodOptional<import("zod").ZodString>;
+    long: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
+export declare const listLocationsFilterSchema: import("zod").ZodObject<{
+    short: import("zod").ZodOptional<import("zod").ZodString>;
+    long: import("zod").ZodOptional<import("zod").ZodString>;
+}, import("zod/v4/core").$strip>;
 //# sourceMappingURL=location.schemas.d.ts.map

package/dist/application/location/location.schemas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.schemas.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.schemas.ts"],"names":[],"mappings":"AAAA,OAAO,CAAC,MAAM,KAAK,CAAC;AAGpB,eAAO,MAAM,UAAU,UAAW,CAAC;AAEnC,eAAO,MAAM,kBAAkB;;;mBAQ3B,CAAC"}
+{"version":3,"file":"location.schemas.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.schemas.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,UAAU,sBAAW,CAAC;AAEnC,eAAO,MAAM,oBAAoB;;;gCAG/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;gCAM/B,CAAC;AAEH,eAAO,MAAM,yBAAyB;;;gCAGpC,CAAC"}

package/dist/application/location/location.schemas.js

@@ -1,12 +1,18 @@
-import z from 'zod';
+import { object, string } from 'zod';
 import { idSchema } from '../../schemas.js';
 export const locationId = idSchema;
-export const editLocationSchema = z
-    .object({
-    short: z.string().min(3).max(60).optional(),
-    long: z.string().min(3).max(191).optional(),
-})
-    .refine((data) => data.short || data.long, {
+export const createLocationSchema = object({
+    short: string().min(3).max(60),
+    long: string().min(3).max(191),
+});
+export const updateLocationSchema = object({
+    short: string().min(3).max(60).optional(),
+    long: string().min(3).max(191).optional(),
+}).refine((data) => data.short || data.long, {
     message: 'Either short or long must be provided',
     path: ['short'],
 });
+export const listLocationsFilterSchema = object({
+    short: string().optional(),
+    long: string().optional(),
+});

package/dist/application/location/location.types.d.ts

@@ -1,16 +1,32 @@
-import type { BaseArgs } from '../../types.js';
-export interface Location<T extends Date | string> {
+import type { BaseFetchOptions, BasePayload, Filters, PaginationFetchOptions, Sorts } from '../../types.js';
+export type LocationId = number;
+export interface ListLocationsOptions extends PaginationFetchOptions, Omit<BaseFetchOptions, 'force'> {
+    filter?: Filters<'short' | 'long'>;
+    sort?: Sorts<'id'>;
+}
+export interface CreateLocationPayload extends BasePayload {
+    short: string;
+    long: string;
+}
+export interface UpdateLocationPayload extends BasePayload {
+    short?: string | undefined;
+    long?: string | undefined;
+}
+export interface LocationObject {
     object: 'location';
     attributes: {
         id: number;
         short: string;
         long: string;
-        updated_at: T;
-        created_at: T;
+        updated_at: Date;
+        created_at: Date;
     };
 }
-export interface EditLocationArgs extends BaseArgs {
-    short?: string | undefined;
-    long?: string | undefined;
+export interface BaseLocation {
+    id: number;
+    short: string;
+    long: string;
+    updatedAt: Date;
+    createdAt: Date;
 }
 //# sourceMappingURL=location.types.d.ts.map

package/dist/application/location/location.types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"location.types.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAE/C,MAAM,WAAW,QAAQ,CAAC,CAAC,SAAS,IAAI,GAAG,MAAM;IAC/C,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,CAAC,CAAC;QACd,UAAU,EAAE,CAAC,CAAC;KACf,CAAC;CACH;AAED,MAAM,WAAW,gBAAiB,SAAQ,QAAQ;IAChD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B"}
+{"version":3,"file":"location.types.d.ts","sourceRoot":"","sources":["../../../src/application/location/location.types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,gBAAgB,EAChB,WAAW,EACX,OAAO,EACP,sBAAsB,EACtB,KAAK,EACN,MAAM,gBAAgB,CAAC;AAExB,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,oBACf,SAAQ,sBAAsB,EAAE,IAAI,CAAC,gBAAgB,EAAE,OAAO,CAAC;IAC/D,MAAM,CAAC,EAAE,OAAO,CAAC,OAAO,GAAG,MAAM,CAAC,CAAC;IACnC,IAAI,CAAC,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;CACpB;AAED,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,qBAAsB,SAAQ,WAAW;IACxD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC3B;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,UAAU,CAAC;IACnB,UAAU,EAAE;QACV,EAAE,EAAE,MAAM,CAAC;QACX,KAAK,EAAE,MAAM,CAAC;QACd,IAAI,EAAE,MAAM,CAAC;QACb,UAAU,EAAE,IAAI,CAAC;QACjB,UAAU,EAAE,IAAI,CAAC;KAClB,CAAC;CACH;AAED,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,IAAI,CAAC;IAChB,SAAS,EAAE,IAAI,CAAC;CACjB"}