@drmhse/sso-sdk 0.1.1 → 0.2.1

package/dist/index.js

@@ -348,6 +348,25 @@ var AuthModule = class {
         const response = await this.http.post("/auth/device/code", payload);
         return response.data;
       },
+      /**
+       * Verify a user code and get the context (org_slug, service_slug)
+       * needed for the UI to initiate the appropriate OAuth flow.
+       *
+       * @param userCode The user-friendly code displayed on the device
+       * @returns Context with organization and service information
+       *
+       * @example
+       * ```typescript
+       * const context = await sso.auth.deviceCode.verify('ABCD-1234');
+       * // Use context.org_slug and context.service_slug to determine which OAuth flow to initiate
+       * ```
+       */
+      verify: async (userCode) => {
+        const response = await this.http.post("/auth/device/verify", {
+          user_code: userCode
+        });
+        return response.data;
+      },
       /**
        * Exchange a device code for a JWT token.
        * This should be polled by the device/CLI after displaying the user code.
@@ -410,6 +429,9 @@ var AuthModule = class {
     if (params.redirect_uri) {
       searchParams.append("redirect_uri", params.redirect_uri);
     }
+    if (params.user_code) {
+      searchParams.append("user_code", params.user_code);
+    }
     return `${baseURL}/auth/${provider}?${searchParams.toString()}`;
   }
   /**
@@ -434,6 +456,9 @@ var AuthModule = class {
     if (params?.org_slug) {
       searchParams.append("org_slug", params.org_slug);
     }
+    if (params?.user_code) {
+      searchParams.append("user_code", params.user_code);
+    }
     const queryString = searchParams.toString();
     return `${baseURL}/auth/admin/${provider}${queryString ? `?${queryString}` : ""}`;
   }
@@ -452,6 +477,37 @@ var AuthModule = class {
   async logout() {
     await this.http.post("/api/auth/logout");
   }
+  /**
+   * Refresh an expired JWT access token using a refresh token.
+   * This implements token rotation - both the access token and refresh token
+   * will be renewed with each call.
+   *
+   * The refresh token must be stored securely on the client side.
+   * After a successful refresh, update both tokens in storage and call
+   * `sso.setAuthToken(newAccessToken)`.
+   *
+   * @param refreshToken The refresh token obtained during login
+   * @returns New access token and refresh token pair
+   *
+   * @example
+   * ```typescript
+   * try {
+   *   const tokens = await sso.auth.refreshToken(storedRefreshToken);
+   *   sso.setAuthToken(tokens.access_token);
+   *   localStorage.setItem('access_token', tokens.access_token);
+   *   localStorage.setItem('refresh_token', tokens.refresh_token);
+   * } catch (error) {
+   *   // Refresh failed - redirect to login
+   *   window.location.href = '/login';
+   * }
+   * ```
+   */
+  async refreshToken(refreshToken) {
+    const response = await this.http.post("/api/auth/refresh", {
+      refresh_token: refreshToken
+    });
+    return response.data;
+  }
   /**
    * Get a fresh provider access token for the authenticated user.
    * This will automatically refresh the token if it's expired.
@@ -1264,6 +1320,122 @@ var PlatformModule = class {
         return response.data;
       }
     };
+    /**
+     * Platform analytics methods
+     */
+    this.analytics = {
+      /**
+       * Get platform overview metrics.
+       *
+       * @returns Platform overview metrics
+       *
+       * @example
+       * ```typescript
+       * const metrics = await sso.platform.analytics.getOverview();
+       * console.log(metrics.total_organizations, metrics.total_users);
+       * ```
+       */
+      getOverview: async () => {
+        const response = await this.http.get("/api/platform/analytics/overview");
+        return response.data;
+      },
+      /**
+       * Get organization status breakdown.
+       *
+       * @returns Organization count by status
+       *
+       * @example
+       * ```typescript
+       * const breakdown = await sso.platform.analytics.getOrganizationStatus();
+       * console.log(breakdown.pending, breakdown.active);
+       * ```
+       */
+      getOrganizationStatus: async () => {
+        const response = await this.http.get(
+          "/api/platform/analytics/organization-status"
+        );
+        return response.data;
+      },
+      /**
+       * Get platform growth trends over time.
+       *
+       * @param params Optional date range parameters
+       * @returns Array of growth trend data points
+       *
+       * @example
+       * ```typescript
+       * const trends = await sso.platform.analytics.getGrowthTrends({
+       *   start_date: '2024-01-01',
+       *   end_date: '2024-01-31'
+       * });
+       * ```
+       */
+      getGrowthTrends: async (params) => {
+        const response = await this.http.get(
+          "/api/platform/analytics/growth-trends",
+          { params }
+        );
+        return response.data;
+      },
+      /**
+       * Get platform-wide login activity trends.
+       *
+       * @param params Optional date range parameters
+       * @returns Array of login activity data points
+       *
+       * @example
+       * ```typescript
+       * const activity = await sso.platform.analytics.getLoginActivity({
+       *   start_date: '2024-01-01',
+       *   end_date: '2024-01-31'
+       * });
+       * ```
+       */
+      getLoginActivity: async (params) => {
+        const response = await this.http.get(
+          "/api/platform/analytics/login-activity",
+          { params }
+        );
+        return response.data;
+      },
+      /**
+       * Get top organizations by activity.
+       *
+       * @returns Array of top organizations
+       *
+       * @example
+       * ```typescript
+       * const topOrgs = await sso.platform.analytics.getTopOrganizations();
+       * console.log(topOrgs[0].login_count_30d);
+       * ```
+       */
+      getTopOrganizations: async () => {
+        const response = await this.http.get(
+          "/api/platform/analytics/top-organizations"
+        );
+        return response.data;
+      },
+      /**
+       * Get recently created organizations.
+       *
+       * @param params Optional query parameters
+       * @returns Array of recent organizations
+       *
+       * @example
+       * ```typescript
+       * const recent = await sso.platform.analytics.getRecentOrganizations({
+       *   limit: 10
+       * });
+       * ```
+       */
+      getRecentOrganizations: async (params) => {
+        const response = await this.http.get(
+          "/api/platform/analytics/recent-organizations",
+          { params }
+        );
+        return response.data;
+      }
+    };
   }
   /**
    * List all available organization tiers.

package/dist/index.mjs

@@ -315,6 +315,25 @@ var AuthModule = class {
         const response = await this.http.post("/auth/device/code", payload);
         return response.data;
       },
+      /**
+       * Verify a user code and get the context (org_slug, service_slug)
+       * needed for the UI to initiate the appropriate OAuth flow.
+       *
+       * @param userCode The user-friendly code displayed on the device
+       * @returns Context with organization and service information
+       *
+       * @example
+       * ```typescript
+       * const context = await sso.auth.deviceCode.verify('ABCD-1234');
+       * // Use context.org_slug and context.service_slug to determine which OAuth flow to initiate
+       * ```
+       */
+      verify: async (userCode) => {
+        const response = await this.http.post("/auth/device/verify", {
+          user_code: userCode
+        });
+        return response.data;
+      },
       /**
        * Exchange a device code for a JWT token.
        * This should be polled by the device/CLI after displaying the user code.
@@ -377,6 +396,9 @@ var AuthModule = class {
     if (params.redirect_uri) {
       searchParams.append("redirect_uri", params.redirect_uri);
     }
+    if (params.user_code) {
+      searchParams.append("user_code", params.user_code);
+    }
     return `${baseURL}/auth/${provider}?${searchParams.toString()}`;
   }
   /**
@@ -401,6 +423,9 @@ var AuthModule = class {
     if (params?.org_slug) {
       searchParams.append("org_slug", params.org_slug);
     }
+    if (params?.user_code) {
+      searchParams.append("user_code", params.user_code);
+    }
     const queryString = searchParams.toString();
     return `${baseURL}/auth/admin/${provider}${queryString ? `?${queryString}` : ""}`;
   }
@@ -419,6 +444,37 @@ var AuthModule = class {
   async logout() {
     await this.http.post("/api/auth/logout");
   }
+  /**
+   * Refresh an expired JWT access token using a refresh token.
+   * This implements token rotation - both the access token and refresh token
+   * will be renewed with each call.
+   *
+   * The refresh token must be stored securely on the client side.
+   * After a successful refresh, update both tokens in storage and call
+   * `sso.setAuthToken(newAccessToken)`.
+   *
+   * @param refreshToken The refresh token obtained during login
+   * @returns New access token and refresh token pair
+   *
+   * @example
+   * ```typescript
+   * try {
+   *   const tokens = await sso.auth.refreshToken(storedRefreshToken);
+   *   sso.setAuthToken(tokens.access_token);
+   *   localStorage.setItem('access_token', tokens.access_token);
+   *   localStorage.setItem('refresh_token', tokens.refresh_token);
+   * } catch (error) {
+   *   // Refresh failed - redirect to login
+   *   window.location.href = '/login';
+   * }
+   * ```
+   */
+  async refreshToken(refreshToken) {
+    const response = await this.http.post("/api/auth/refresh", {
+      refresh_token: refreshToken
+    });
+    return response.data;
+  }
   /**
    * Get a fresh provider access token for the authenticated user.
    * This will automatically refresh the token if it's expired.
@@ -1231,6 +1287,122 @@ var PlatformModule = class {
         return response.data;
       }
     };
+    /**
+     * Platform analytics methods
+     */
+    this.analytics = {
+      /**
+       * Get platform overview metrics.
+       *
+       * @returns Platform overview metrics
+       *
+       * @example
+       * ```typescript
+       * const metrics = await sso.platform.analytics.getOverview();
+       * console.log(metrics.total_organizations, metrics.total_users);
+       * ```
+       */
+      getOverview: async () => {
+        const response = await this.http.get("/api/platform/analytics/overview");
+        return response.data;
+      },
+      /**
+       * Get organization status breakdown.
+       *
+       * @returns Organization count by status
+       *
+       * @example
+       * ```typescript
+       * const breakdown = await sso.platform.analytics.getOrganizationStatus();
+       * console.log(breakdown.pending, breakdown.active);
+       * ```
+       */
+      getOrganizationStatus: async () => {
+        const response = await this.http.get(
+          "/api/platform/analytics/organization-status"
+        );
+        return response.data;
+      },
+      /**
+       * Get platform growth trends over time.
+       *
+       * @param params Optional date range parameters
+       * @returns Array of growth trend data points
+       *
+       * @example
+       * ```typescript
+       * const trends = await sso.platform.analytics.getGrowthTrends({
+       *   start_date: '2024-01-01',
+       *   end_date: '2024-01-31'
+       * });
+       * ```
+       */
+      getGrowthTrends: async (params) => {
+        const response = await this.http.get(
+          "/api/platform/analytics/growth-trends",
+          { params }
+        );
+        return response.data;
+      },
+      /**
+       * Get platform-wide login activity trends.
+       *
+       * @param params Optional date range parameters
+       * @returns Array of login activity data points
+       *
+       * @example
+       * ```typescript
+       * const activity = await sso.platform.analytics.getLoginActivity({
+       *   start_date: '2024-01-01',
+       *   end_date: '2024-01-31'
+       * });
+       * ```
+       */
+      getLoginActivity: async (params) => {
+        const response = await this.http.get(
+          "/api/platform/analytics/login-activity",
+          { params }
+        );
+        return response.data;
+      },
+      /**
+       * Get top organizations by activity.
+       *
+       * @returns Array of top organizations
+       *
+       * @example
+       * ```typescript
+       * const topOrgs = await sso.platform.analytics.getTopOrganizations();
+       * console.log(topOrgs[0].login_count_30d);
+       * ```
+       */
+      getTopOrganizations: async () => {
+        const response = await this.http.get(
+          "/api/platform/analytics/top-organizations"
+        );
+        return response.data;
+      },
+      /**
+       * Get recently created organizations.
+       *
+       * @param params Optional query parameters
+       * @returns Array of recent organizations
+       *
+       * @example
+       * ```typescript
+       * const recent = await sso.platform.analytics.getRecentOrganizations({
+       *   limit: 10
+       * });
+       * ```
+       */
+      getRecentOrganizations: async (params) => {
+        const response = await this.http.get(
+          "/api/platform/analytics/recent-organizations",
+          { params }
+        );
+        return response.data;
+      }
+    };
   }
   /**
    * List all available organization tiers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drmhse/sso-sdk",
-  "version": "0.1.1",
+  "version": "0.2.1",
   "description": "Zero-dependency TypeScript SDK for the multi-tenant SSO Platform API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",