@drmhse/sso-sdk 0.2.3 → 0.2.4

package/README.md

@@ -307,16 +307,27 @@ await sso.organizations.oauthCredentials.set('acme-corp', 'github', {
 
 #### End-User Management (`sso.organizations.endUsers`)
 
-Manage your organization's customers (end-users with subscriptions).
+Manage your organization's customers (end-users who have logged in or have subscriptions).
 
 ```typescript
-// List all end-users for an organization
-const endUsers = await sso.organizations.endUsers.list('acme-corp', {
+// List all end-users across all services
+const allUsers = await sso.organizations.endUsers.list('acme-corp', {
   page: 1,
   limit: 20
 });
 
-// Revoke all active sessions for a specific end-user
+// Filter end-users by a specific service
+const serviceUsers = await sso.organizations.endUsers.list('acme-corp', {
+  service_slug: 'main-app',
+  page: 1,
+  limit: 20
+});
+
+// Get detailed information about a specific end-user
+const user = await sso.organizations.endUsers.get('acme-corp', 'user-id-123');
+console.log(`Active sessions: ${user.session_count}`);
+
+// Revoke all active sessions for a specific end-user (force logout)
 await sso.organizations.endUsers.revokeSessions('acme-corp', 'user-id-123');
 ```
 

package/dist/index.d.mts

@@ -802,6 +802,10 @@ interface EndUserDetailResponse {
  * List end-users query params
  */
 interface ListEndUsersParams extends PaginationParams {
+    /**
+     * Optional service slug to filter users by a specific service
+     */
+    service_slug?: string;
 }
 /**
  * Revoke sessions response
@@ -1314,19 +1318,28 @@ declare class OrganizationsModule {
     endUsers: {
         /**
          * List all end-users for an organization.
-         * End-users are customers who have subscriptions to the organization's services.
+         * Returns users who have identities (logged in) or subscriptions for the organization's services.
          *
          * @param orgSlug Organization slug
-         * @param params Optional query parameters for pagination
-         * @returns Paginated list of end-users with their subscriptions
+         * @param params Optional query parameters for pagination and filtering
+         * @param params.service_slug Optional service slug to filter users by a specific service
+         * @returns Paginated list of end-users with their subscriptions and identities
          *
          * @example
          * ```typescript
-         * const endUsers = await sso.organizations.endUsers.list('acme-corp', {
+         * // List all end-users across all services
+         * const allUsers = await sso.organizations.endUsers.list('acme-corp', {
+         *   page: 1,
+         *   limit: 20
+         * });
+         *
+         * // Filter by specific service
+         * const serviceUsers = await sso.organizations.endUsers.list('acme-corp', {
+         *   service_slug: 'my-app',
          *   page: 1,
          *   limit: 20
          * });
-         * console.log(`Total end-users: ${endUsers.total}`);
+         * console.log(`Total end-users: ${allUsers.total}`);
          * ```
          */
         list: (orgSlug: string, params?: ListEndUsersParams) => Promise<EndUserListResponse>;

package/dist/index.d.ts

@@ -802,6 +802,10 @@ interface EndUserDetailResponse {
  * List end-users query params
  */
 interface ListEndUsersParams extends PaginationParams {
+    /**
+     * Optional service slug to filter users by a specific service
+     */
+    service_slug?: string;
 }
 /**
  * Revoke sessions response
@@ -1314,19 +1318,28 @@ declare class OrganizationsModule {
     endUsers: {
         /**
          * List all end-users for an organization.
-         * End-users are customers who have subscriptions to the organization's services.
+         * Returns users who have identities (logged in) or subscriptions for the organization's services.
          *
          * @param orgSlug Organization slug
-         * @param params Optional query parameters for pagination
-         * @returns Paginated list of end-users with their subscriptions
+         * @param params Optional query parameters for pagination and filtering
+         * @param params.service_slug Optional service slug to filter users by a specific service
+         * @returns Paginated list of end-users with their subscriptions and identities
          *
          * @example
          * ```typescript
-         * const endUsers = await sso.organizations.endUsers.list('acme-corp', {
+         * // List all end-users across all services
+         * const allUsers = await sso.organizations.endUsers.list('acme-corp', {
+         *   page: 1,
+         *   limit: 20
+         * });
+         *
+         * // Filter by specific service
+         * const serviceUsers = await sso.organizations.endUsers.list('acme-corp', {
+         *   service_slug: 'my-app',
          *   page: 1,
          *   limit: 20
          * });
-         * console.log(`Total end-users: ${endUsers.total}`);
+         * console.log(`Total end-users: ${allUsers.total}`);
          * ```
          */
         list: (orgSlug: string, params?: ListEndUsersParams) => Promise<EndUserListResponse>;

package/dist/index.js

@@ -724,19 +724,28 @@ var OrganizationsModule = class {
     this.endUsers = {
       /**
        * List all end-users for an organization.
-       * End-users are customers who have subscriptions to the organization's services.
+       * Returns users who have identities (logged in) or subscriptions for the organization's services.
        *
        * @param orgSlug Organization slug
-       * @param params Optional query parameters for pagination
-       * @returns Paginated list of end-users with their subscriptions
+       * @param params Optional query parameters for pagination and filtering
+       * @param params.service_slug Optional service slug to filter users by a specific service
+       * @returns Paginated list of end-users with their subscriptions and identities
        *
        * @example
        * ```typescript
-       * const endUsers = await sso.organizations.endUsers.list('acme-corp', {
+       * // List all end-users across all services
+       * const allUsers = await sso.organizations.endUsers.list('acme-corp', {
        *   page: 1,
        *   limit: 20
        * });
-       * console.log(`Total end-users: ${endUsers.total}`);
+       * 
+       * // Filter by specific service
+       * const serviceUsers = await sso.organizations.endUsers.list('acme-corp', {
+       *   service_slug: 'my-app',
+       *   page: 1,
+       *   limit: 20
+       * });
+       * console.log(`Total end-users: ${allUsers.total}`);
        * ```
        */
       list: async (orgSlug, params) => {

package/dist/index.mjs

@@ -691,19 +691,28 @@ var OrganizationsModule = class {
     this.endUsers = {
       /**
        * List all end-users for an organization.
-       * End-users are customers who have subscriptions to the organization's services.
+       * Returns users who have identities (logged in) or subscriptions for the organization's services.
        *
        * @param orgSlug Organization slug
-       * @param params Optional query parameters for pagination
-       * @returns Paginated list of end-users with their subscriptions
+       * @param params Optional query parameters for pagination and filtering
+       * @param params.service_slug Optional service slug to filter users by a specific service
+       * @returns Paginated list of end-users with their subscriptions and identities
        *
        * @example
        * ```typescript
-       * const endUsers = await sso.organizations.endUsers.list('acme-corp', {
+       * // List all end-users across all services
+       * const allUsers = await sso.organizations.endUsers.list('acme-corp', {
        *   page: 1,
        *   limit: 20
        * });
-       * console.log(`Total end-users: ${endUsers.total}`);
+       * 
+       * // Filter by specific service
+       * const serviceUsers = await sso.organizations.endUsers.list('acme-corp', {
+       *   service_slug: 'my-app',
+       *   page: 1,
+       *   limit: 20
+       * });
+       * console.log(`Total end-users: ${allUsers.total}`);
        * ```
        */
       list: async (orgSlug, params) => {

package/package.json

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