berget 0.1.0 → 1.0.0

package/src/services/auth-service.ts

@@ -4,13 +4,24 @@ import {
   clearAuthToken,
   apiClient,
 } from '../client'
-import open from 'open'
+// We'll use dynamic import for 'open' to support ESM modules in CommonJS
 import chalk from 'chalk'
 import { handleError } from '../utils/error-handler'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
+/**
+ * Service for authentication operations
+ * Command group: auth
+ */
 export class AuthService {
   private static instance: AuthService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.AUTH
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.AUTH
 
   private constructor() {}
 
@@ -60,7 +71,9 @@ export class AuthService {
       // Try to open browser automatically
       try {
         if (deviceData.verification_url) {
-          await open(deviceData.verification_url)
+          // Use dynamic import for the 'open' package
+          const open = await import('open').then(m => m.default);
+          await open(deviceData.verification_url);
           console.log(
             chalk.dim(
               "Browser opened automatically. If it didn't open, please use the URL above."
@@ -193,7 +206,11 @@ export class AuthService {
     }
   }
 
-  public async getUserProfile() {
+  /**
+   * Get current user profile
+   * Command: berget auth whoami
+   */
+  public async whoami() {
     try {
       const { data, error } = await this.client.GET('/v1/users/me')
       if (error) throw new Error(JSON.stringify(error))

package/src/services/cluster-service.ts

@@ -1,4 +1,5 @@
 import { createAuthenticatedClient } from '../client'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
 export interface Cluster {
   id: string
@@ -8,9 +9,19 @@ export interface Cluster {
   created: string
 }
 
+/**
+ * Service for managing Kubernetes clusters
+ * Command group: clusters
+ */
 export class ClusterService {
   private static instance: ClusterService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.CLUSTERS
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.CLUSTERS
 
   private constructor() {}
 
@@ -21,7 +32,11 @@ export class ClusterService {
     return ClusterService.instance
   }
 
-  public async getClusterUsage(clusterId: string): Promise<any> {
+  /**
+   * Get resource usage for a cluster
+   * Command: berget clusters get-usage
+   */
+  public async getUsage(clusterId: string): Promise<any> {
     try {
       const { data, error } = await this.client.GET(
         '/v1/clusters/{clusterId}/usage',
@@ -37,7 +52,11 @@ export class ClusterService {
     }
   }
 
-  public async listClusters(): Promise<Cluster[]> {
+  /**
+   * List all clusters
+   * Command: berget clusters list
+   */
+  public async list(): Promise<Cluster[]> {
     try {
       const { data, error } = await this.client.GET('/v1/clusters')
       if (error) throw new Error(JSON.stringify(error))
@@ -47,4 +66,20 @@ export class ClusterService {
       throw error
     }
   }
+  
+  /**
+   * Get detailed information about a cluster
+   * Command: berget clusters describe
+   */
+  public async describe(clusterId: string): Promise<Cluster | null> {
+    try {
+      // This is a placeholder since the API doesn't have a specific endpoint
+      // In a real implementation, this would call a specific endpoint
+      const clusters = await this.list()
+      return clusters.find(cluster => cluster.id === clusterId) || null
+    } catch (error) {
+      console.error('Failed to describe cluster:', error)
+      throw error
+    }
+  }
 }

package/src/services/collaborator-service.ts

@@ -1,4 +1,5 @@
 import { createAuthenticatedClient } from '../client'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
 export interface Collaborator {
   username: string
@@ -6,9 +7,19 @@ export interface Collaborator {
   status: string
 }
 
+/**
+ * Service for managing collaborators
+ * Command group: users
+ */
 export class CollaboratorService {
   private static instance: CollaboratorService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.USERS
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.USERS
 
   private constructor() {}
 
@@ -19,16 +30,24 @@ export class CollaboratorService {
     return CollaboratorService.instance
   }
 
-  // This endpoint is not available in the API
-  public async addCollaborator(
+  /**
+   * Invite a new collaborator
+   * Command: berget users invite
+   * This endpoint is not available in the API
+   */
+  public async invite(
     clusterId: string,
     githubUsername: string
   ): Promise<Collaborator[]> {
     throw new Error('This functionality is not available in the API')
   }
 
-  // This endpoint is not available in the API
-  public async listCollaborators(clusterId: string): Promise<Collaborator[]> {
+  /**
+   * List all collaborators
+   * Command: berget users list
+   * This endpoint is not available in the API
+   */
+  public async list(clusterId: string): Promise<Collaborator[]> {
     throw new Error('This functionality is not available in the API')
   }
 }

package/src/services/flux-service.ts

@@ -1,4 +1,5 @@
 import { createAuthenticatedClient } from '../client'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
 export interface FluxInstallOptions {
   cluster: string
@@ -12,9 +13,19 @@ export interface FluxBootstrapOptions {
   personal?: boolean
 }
 
+/**
+ * Service for managing Flux CD
+ * Command group: flux
+ */
 export class FluxService {
   private static instance: FluxService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.FLUX
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.FLUX
 
   private constructor() {}
 
@@ -25,13 +36,21 @@ export class FluxService {
     return FluxService.instance
   }
 
-  // This endpoint is not available in the API
-  public async installFlux(options: FluxInstallOptions): Promise<boolean> {
+  /**
+   * Install Flux CD
+   * Command: berget flux install
+   * This endpoint is not available in the API
+   */
+  public async install(options: FluxInstallOptions): Promise<boolean> {
     throw new Error('This functionality is not available in the API')
   }
 
-  // This endpoint is not available in the API
-  public async bootstrapFlux(options: FluxBootstrapOptions): Promise<boolean> {
+  /**
+   * Bootstrap Flux CD
+   * Command: berget flux bootstrap
+   * This endpoint is not available in the API
+   */
+  public async bootstrap(options: FluxBootstrapOptions): Promise<boolean> {
     throw new Error('This functionality is not available in the API')
   }
 }

package/src/services/helm-service.ts

@@ -1,4 +1,5 @@
 import { createAuthenticatedClient } from '../client'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
 export interface HelmRepoAddOptions {
   name: string
@@ -12,9 +13,19 @@ export interface HelmInstallOptions {
   values?: Record<string, string>
 }
 
+/**
+ * Service for managing Helm charts
+ * Command group: helm
+ */
 export class HelmService {
   private static instance: HelmService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.HELM
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.HELM
 
   private constructor() {}
 
@@ -25,13 +36,21 @@ export class HelmService {
     return HelmService.instance
   }
 
-  // This endpoint is not available in the API
+  /**
+   * Add a Helm repository
+   * Command: berget helm add-repo
+   * This endpoint is not available in the API
+   */
   public async addRepo(options: HelmRepoAddOptions): Promise<boolean> {
     throw new Error('This functionality is not available in the API')
   }
 
-  // This endpoint is not available in the API
-  public async installChart(options: HelmInstallOptions): Promise<any> {
+  /**
+   * Install a Helm chart
+   * Command: berget helm install
+   * This endpoint is not available in the API
+   */
+  public async install(options: HelmInstallOptions): Promise<any> {
     throw new Error('This functionality is not available in the API')
   }
 }

package/src/services/kubectl-service.ts

@@ -1,8 +1,19 @@
 import { createAuthenticatedClient } from '../client'
+import { COMMAND_GROUPS, SUBCOMMANDS } from '../constants/command-structure'
 
+/**
+ * Service for managing Kubernetes resources
+ * Command group: kubectl
+ */
 export class KubectlService {
   private static instance: KubectlService
   private client = createAuthenticatedClient()
+  
+  // Command group name for this service
+  public static readonly COMMAND_GROUP = COMMAND_GROUPS.KUBECTL
+  
+  // Subcommands for this service
+  public static readonly COMMANDS = SUBCOMMANDS.KUBECTL
 
   private constructor() {}
 
@@ -13,18 +24,30 @@ export class KubectlService {
     return KubectlService.instance
   }
 
-  // This endpoint is not available in the API
+  /**
+   * Create a Kubernetes namespace
+   * Command: berget kubectl create-namespace
+   * This endpoint is not available in the API
+   */
   public async createNamespace(name: string): Promise<boolean> {
     throw new Error('This functionality is not available in the API')
   }
 
-  // This endpoint is not available in the API
-  public async applyConfiguration(filename: string): Promise<boolean> {
+  /**
+   * Apply a Kubernetes configuration
+   * Command: berget kubectl apply
+   * This endpoint is not available in the API
+   */
+  public async apply(filename: string): Promise<boolean> {
     throw new Error('This functionality is not available in the API')
   }
 
-  // This endpoint is not available in the API
-  public async getResources(
+  /**
+   * Get Kubernetes resources
+   * Command: berget kubectl get
+   * This endpoint is not available in the API
+   */
+  public async get(
     resource: string,
     namespace?: string
   ): Promise<any[]> {