feat(app-deployments): add server-side sorting by created, activated, and last used

.changeset/long-lions-love.md

@@ -0,0 +1,5 @@
+---
+'hive': patch
+---
+
+Add server-side sorting to app deployments table (Created, Activated, Last Used).

packages/services/api/src/modules/app-deployments/module.graphql.ts

@@ -40,6 +40,23 @@ export default gql`
     retired
   }
 
+  """
+  Fields available for sorting app deployments.
+  """
+  enum AppDeploymentsSortField {
+    CREATED_AT
+    ACTIVATED_AT
+    LAST_USED
+  }
+
+  """
+  Sort configuration for app deployments.
+  """
+  input AppDeploymentsSortInput {
+    field: AppDeploymentsSortField!
+    direction: SortDirectionType!
+  }
+
   type GraphQLDocumentConnection {
     pageInfo: PageInfo!
     edges: [GraphQLDocumentEdge!]!
@@ -63,6 +80,10 @@ export default gql`
   type AppDeploymentConnection {
     pageInfo: PageInfo! @tag(name: "public")
     edges: [AppDeploymentEdge!]! @tag(name: "public")
+    """
+    The total number of app deployments for this target.
+    """
+    total: Int! @tag(name: "public")
   }
 
   type AppDeploymentEdge {
@@ -108,7 +129,11 @@ export default gql`
     """
     The app deployments for this target.
     """
-    appDeployments(first: Int, after: String): AppDeploymentConnection
+    appDeployments(
+      first: Int
+      after: String
+      sort: AppDeploymentsSortInput
+    ): AppDeploymentConnection
     appDeployment(appName: String!, appVersion: String!): AppDeployment
     """
     Whether the viewer can access the app deployments within a target.

packages/services/api/src/modules/app-deployments/providers/app-deployments-manager.ts

@@ -222,13 +222,38 @@ export class AppDeploymentsManager {
 
   async getPaginatedAppDeploymentsForTarget(
     target: Target,
-    args: { cursor: string | null; first: number | null },
+    args: {
+      cursor: string | null;
+      first: number | null;
+      sort: {
+        field: GraphQLSchema.AppDeploymentsSortField;
+        direction: GraphQLSchema.SortDirectionType;
+      } | null;
+    },
   ) {
-    return await this.appDeployments.getPaginatedAppDeployments({
-      targetId: target.id,
-      cursor: args.cursor,
-      first: args.first,
-    });
+    const { sort, cursor, first } = args;
+
+    const pagePromise =
+      sort?.field === 'LAST_USED'
+        ? this.appDeployments.getPaginatedAppDeploymentsSortedByLastUsed({
+            targetId: target.id,
+            cursor,
+            first,
+            direction: sort.direction,
+          })
+        : this.appDeployments.getPaginatedAppDeployments({
+            targetId: target.id,
+            cursor,
+            first,
+            sort: sort ? { field: sort.field, direction: sort.direction } : null,
+          });
+
+    const [page, total] = await Promise.all([
+      pagePromise,
+      this.appDeployments.countAppDeployments(target.id),
+    ]);
+
+    return { ...page, total };
   }
 
   async getActiveAppDeploymentsForTarget(
@@ -243,12 +268,17 @@ export class AppDeploymentsManager {
       };
     },
   ) {
-    return await this.appDeployments.getActiveAppDeployments({
-      targetId: target.id,
-      cursor: args.cursor,
-      first: args.first,
-      filter: args.filter,
-    });
+    const [page, total] = await Promise.all([
+      this.appDeployments.getActiveAppDeployments({
+        targetId: target.id,
+        cursor: args.cursor,
+        first: args.first,
+        filter: args.filter,
+      }),
+      this.appDeployments.countAppDeployments(target.id),
+    ]);
+
+    return { ...page, total };
   }
 
   getDocumentCountForAppDeployment = batch<AppDeploymentRecord, number>(async args => {