feat(url-store): add sorting and fix linting issues

API Enhancements:
- Add sortBy and sortOrder query parameters to all listing endpoints
- Support sorting by: rank, traffic, url, createdAt, updatedAt
- Add rank and traffic fields to add/update operations
- Update OpenAPI documentation with new parameters and fields

Performance Improvements:
- Refactor bulk operations to use Promise.allSettled for parallel processing
- Replace sequential for-loops with parallel map operations
- Improve response time for bulk add/update/delete operations

Code Quality:
- Fix all 15 pre-existing linting errors
- Remove unused encodeUrlToBase64 function
- Eliminate no-continue statements (7 instances)
- Eliminate no-await-in-loop violations (7 instances)
- Fix trailing spaces and OpenAPI YAML syntax errors
- All linting now passing (0 errors)

Author: HollywoodTonight

docs/openapi/schemas.yaml

@@ -1665,6 +1665,16 @@ AuditUrl:
       items:
         type: string
       example: ['accessibility', 'broken-backlinks']
+    rank:
+      description: Rank or position of the URL (e.g., for sorting high-value pages)
+      type: number
+      nullable: true
+      example: 1
+    traffic:
+      description: Traffic metric for the URL (e.g., page views, visitors)
+      type: number
+      nullable: true
+      example: 50000
     createdAt:
       description: ISO 8601 timestamp when created
       $ref: '#/DateTime'
@@ -1684,6 +1694,8 @@ AuditUrl:
     url: 'https://example.com/documents/report.pdf'
     source: 'manual'
     audits: ['accessibility', 'broken-backlinks']
+    rank: 1
+    traffic: 50000
     createdAt: '2025-10-10T12:00:00Z'
     updatedAt: '2025-10-10T15:30:00Z'
     createdBy: 'user-alice'
@@ -1707,10 +1719,22 @@ AuditUrlInput:
       items:
         type: string
       example: ['accessibility', 'broken-backlinks']
+    rank:
+      description: Rank or position of the URL (optional, for sorting high-value pages)
+      type: number
+      nullable: true
+      example: 1
+    traffic:
+      description: Traffic metric for the URL (optional, e.g., page views, visitors)
+      type: number
+      nullable: true
+      example: 50000
   example:
     url: 'https://example.com/page1.html'
     source: 'manual'
     audits: ['accessibility', 'broken-backlinks']
+    rank: 1
+    traffic: 50000
 AuditUrlUpdate:
   type: object
   required:
@@ -1726,9 +1750,21 @@ AuditUrlUpdate:
       items:
         type: string
       example: ['accessibility']
+    rank:
+      description: Rank or position of the URL (optional, updates if provided)
+      type: number
+      nullable: true
+      example: 2
+    traffic:
+      description: Traffic metric for the URL (optional, updates if provided)
+      type: number
+      nullable: true
+      example: 75000
   example:
     url: 'https://example.com/page1.html'
     audits: ['accessibility']
+    rank: 2
+    traffic: 75000
 AuditUrlListResponse:
   type: object
   required:

docs/openapi/url-store-api.yaml

@@ -18,6 +18,21 @@ url-store-list:
         schema:
           type: string
         description: Pagination cursor from previous response
+      - name: sortBy
+        in: query
+        required: false
+        schema:
+          type: string
+          enum: [rank, traffic, url, createdAt, updatedAt]
+        description: Field to sort by
+      - name: sortOrder
+        in: query
+        required: false
+        schema:
+          type: string
+          enum: [asc, desc]
+          default: asc
+        description: Sort order (ascending or descending)
     tags:
       - site
       - url store
@@ -70,6 +85,21 @@ url-store-by-source:
       schema:
         type: string
       description: Pagination cursor from previous response
+    - name: sortBy
+      in: query
+      required: false
+      schema:
+        type: string
+        enum: [rank, traffic, url, createdAt, updatedAt]
+      description: Field to sort by
+    - name: sortOrder
+      in: query
+      required: false
+      schema:
+        type: string
+        enum: [asc, desc]
+        default: asc
+      description: Sort order (ascending or descending)
   get:
     tags:
       - site
@@ -123,6 +153,21 @@ url-store-by-audit:
       schema:
         type: string
       description: Pagination cursor from previous response
+    - name: sortBy
+      in: query
+      required: false
+      schema:
+        type: string
+        enum: [rank, traffic, url, createdAt, updatedAt]
+      description: Field to sort by
+    - name: sortOrder
+      in: query
+      required: false
+      schema:
+        type: string
+        enum: [asc, desc]
+        default: asc
+      description: Sort order (ascending or descending)
   get:
     tags:
       - site