perspectapi-ts-sdk 3.4.0 → 3.5.0

package/dist/index.d.mts

@@ -2506,6 +2506,61 @@ declare class SiteUsersClient extends BaseClient {
     }): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    /**
+     * Get a user's orders (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param params - Pagination params
+     */
+    getUserOrders(siteName: string, userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ApiResponse<{
+        orders: SiteUserOrder[];
+    }>>;
+    /**
+     * Get a user's subscriptions (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserSubscriptions(siteName: string, userId: string): Promise<ApiResponse<{
+        subscriptions: SiteUserSubscription[];
+    }>>;
+    /**
+     * Pause a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     * @param resumesAt - Optional ISO date string when subscription should auto-resume
+     */
+    pauseUserSubscription(siteName: string, userId: string, subscriptionId: string, resumesAt?: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Resume a user's paused subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    resumeUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Cancel a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    cancelUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Get a user's credit balance (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserCreditBalance(siteName: string, userId: string): Promise<ApiResponse<CreditBalance>>;
 }
 
 /**

package/dist/index.d.ts

@@ -2506,6 +2506,61 @@ declare class SiteUsersClient extends BaseClient {
     }): Promise<ApiResponse<{
         success: boolean;
     }>>;
+    /**
+     * Get a user's orders (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param params - Pagination params
+     */
+    getUserOrders(siteName: string, userId: string, params?: {
+        limit?: number;
+        offset?: number;
+    }): Promise<ApiResponse<{
+        orders: SiteUserOrder[];
+    }>>;
+    /**
+     * Get a user's subscriptions (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserSubscriptions(siteName: string, userId: string): Promise<ApiResponse<{
+        subscriptions: SiteUserSubscription[];
+    }>>;
+    /**
+     * Pause a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     * @param resumesAt - Optional ISO date string when subscription should auto-resume
+     */
+    pauseUserSubscription(siteName: string, userId: string, subscriptionId: string, resumesAt?: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Resume a user's paused subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    resumeUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+    }>>;
+    /**
+     * Cancel a user's subscription (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     * @param subscriptionId - Subscription ID
+     */
+    cancelUserSubscription(siteName: string, userId: string, subscriptionId: string): Promise<ApiResponse<{
+        success: boolean;
+        message: string;
+    }>>;
+    /**
+     * Get a user's credit balance (admin only)
+     * @param siteName - The site name
+     * @param userId - User ID
+     */
+    getUserCreditBalance(siteName: string, userId: string): Promise<ApiResponse<CreditBalance>>;
 }
 
 /**

package/dist/index.js

@@ -2637,6 +2637,83 @@ var SiteUsersClient = class extends BaseClient {
       data
     );
   }
+  // ============================================================================
+  // ADMIN USER-SCOPED ENDPOINTS (API key auth required)
+  // These mirror /me/* endpoints but target a specific user by ID.
+  // ============================================================================
+  /**
+   * Get a user's orders (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param params - Pagination params
+   */
+  async getUserOrders(siteName, userId, params) {
+    return this.http.get(
+      this.buildPath(this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/orders`)),
+      params
+    );
+  }
+  /**
+   * Get a user's subscriptions (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserSubscriptions(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions`)
+    );
+  }
+  /**
+   * Pause a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseUserSubscription(siteName, userId, subscriptionId, resumesAt) {
+    const body = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body
+    );
+  }
+  /**
+   * Resume a user's paused subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async resumeUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {}
+    );
+  }
+  /**
+   * Cancel a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async cancelUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+      {}
+    );
+  }
+  /**
+   * Get a user's credit balance (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserCreditBalance(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/balance`)
+    );
+  }
 };
 
 // src/client/bundles-client.ts

package/dist/index.mjs

@@ -2574,6 +2574,83 @@ var SiteUsersClient = class extends BaseClient {
       data
     );
   }
+  // ============================================================================
+  // ADMIN USER-SCOPED ENDPOINTS (API key auth required)
+  // These mirror /me/* endpoints but target a specific user by ID.
+  // ============================================================================
+  /**
+   * Get a user's orders (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param params - Pagination params
+   */
+  async getUserOrders(siteName, userId, params) {
+    return this.http.get(
+      this.buildPath(this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/orders`)),
+      params
+    );
+  }
+  /**
+   * Get a user's subscriptions (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserSubscriptions(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions`)
+    );
+  }
+  /**
+   * Pause a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseUserSubscription(siteName, userId, subscriptionId, resumesAt) {
+    const body = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body
+    );
+  }
+  /**
+   * Resume a user's paused subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async resumeUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {}
+    );
+  }
+  /**
+   * Cancel a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async cancelUserSubscription(siteName, userId, subscriptionId) {
+    return this.create(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+      {}
+    );
+  }
+  /**
+   * Get a user's credit balance (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserCreditBalance(siteName, userId) {
+    return this.getSingle(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/balance`)
+    );
+  }
 };
 
 // src/client/bundles-client.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "perspectapi-ts-sdk",
-  "version": "3.4.0",
+  "version": "3.5.0",
   "description": "TypeScript SDK for PerspectAPI - Cloudflare Workers compatible",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/client/site-users-client.ts

@@ -496,4 +496,111 @@ export class SiteUsersClient extends BaseClient {
       data
     );
   }
+
+  // ============================================================================
+  // ADMIN USER-SCOPED ENDPOINTS (API key auth required)
+  // These mirror /me/* endpoints but target a specific user by ID.
+  // ============================================================================
+
+  /**
+   * Get a user's orders (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param params - Pagination params
+   */
+  async getUserOrders(
+    siteName: string,
+    userId: string,
+    params?: { limit?: number; offset?: number }
+  ): Promise<ApiResponse<{ orders: SiteUserOrder[] }>> {
+    return this.http.get<{ orders: SiteUserOrder[] }>(
+      this.buildPath(this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/orders`)),
+      params
+    );
+  }
+
+  /**
+   * Get a user's subscriptions (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserSubscriptions(
+    siteName: string,
+    userId: string
+  ): Promise<ApiResponse<{ subscriptions: SiteUserSubscription[] }>> {
+    return this.getSingle<{ subscriptions: SiteUserSubscription[] }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions`)
+    );
+  }
+
+  /**
+   * Pause a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   * @param resumesAt - Optional ISO date string when subscription should auto-resume
+   */
+  async pauseUserSubscription(
+    siteName: string,
+    userId: string,
+    subscriptionId: string,
+    resumesAt?: string
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    const body: Record<string, string> = {};
+    if (resumesAt) {
+      body.resumes_at = resumesAt;
+    }
+    return this.create<Record<string, string>, { success: boolean }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/pause`),
+      body
+    );
+  }
+
+  /**
+   * Resume a user's paused subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async resumeUserSubscription(
+    siteName: string,
+    userId: string,
+    subscriptionId: string
+  ): Promise<ApiResponse<{ success: boolean }>> {
+    return this.create<Record<string, never>, { success: boolean }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/resume`),
+      {}
+    );
+  }
+
+  /**
+   * Cancel a user's subscription (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   * @param subscriptionId - Subscription ID
+   */
+  async cancelUserSubscription(
+    siteName: string,
+    userId: string,
+    subscriptionId: string
+  ): Promise<ApiResponse<{ success: boolean; message: string }>> {
+    return this.create<Record<string, never>, { success: boolean; message: string }>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/subscriptions/${encodeURIComponent(subscriptionId)}/cancel`),
+      {}
+    );
+  }
+
+  /**
+   * Get a user's credit balance (admin only)
+   * @param siteName - The site name
+   * @param userId - User ID
+   */
+  async getUserCreditBalance(
+    siteName: string,
+    userId: string
+  ): Promise<ApiResponse<CreditBalance>> {
+    return this.getSingle<CreditBalance>(
+      this.siteUserEndpoint(siteName, `/users/${encodeURIComponent(userId)}/credits/balance`)
+    );
+  }
 }