diff --git a/src/types.ts b/src/types.ts
index 7f056f3..da3e616 100644
--- a/src/types.ts
+++ b/src/types.ts
@@ -1,11 +1,26 @@
+// Type alias for repository categories
+export type Repository = 'core' | 'extra' | 'community' | 'multilib';
+
+// Interface representing a single package
 export interface Package {
+  /** The name of the package */
   name: string;
+
+  /** The version of the package */
   version: string;
+
+  /** A brief description of the package */
   description: string;
-  repository: 'core' | 'extra' | 'community' | 'multilib';
+
+  /** The repository where the package is located */
+  repository: Repository;
 }
 
+// Interface representing the response containing a list of packages
 export interface PackageResponse {
+  /** Array of packages */
   packages: Package[];
+
+  /** Total number of packages available */
   total: number;
-}
\ No newline at end of file
+}