feeef 0.8.2 → 0.8.3

package/build/index.js

@@ -791,6 +791,52 @@ var UserRepository = class extends ModelRepository {
   }
 };
 
+// src/feeef/repositories/apps.ts
+var AppRepository = class extends ModelRepository {
+  constructor(client) {
+    super("apps", client);
+  }
+  /**
+   * Regenerates the client secret for the app. Returns the app with
+   * clientSecret set once; store it securely.
+   *
+   * @param id - The app id.
+   * @returns The app including clientSecret.
+   */
+  async regenerateSecret(id) {
+    const res = await this.client.post(`/${this.resource}/${id}/regenerate-secret`);
+    return res.data;
+  }
+  /**
+   * Builds the OAuth authorize URL to which the user should be redirected.
+   *
+   * @param params - Parameters for the authorize URL.
+   * @param params.baseUrl - API base URL (e.g. https://api.feeef.org/api/v1).
+   * @param params.clientId - The app client id.
+   * @param params.redirectUri - Redirect URI registered for the app.
+   * @param params.responseType - Must be 'code' for authorization code flow.
+   * @param params.scope - Optional list of scopes (space-separated in URL).
+   * @param params.state - Optional state for CSRF protection.
+   * @param params.codeChallenge - Optional PKCE code challenge.
+   * @param params.codeChallengeMethod - Optional 'S256' or 'plain'.
+   * @returns The full authorize URL.
+   */
+  static buildAuthorizeUrl(params) {
+    const base = params.baseUrl.endsWith("/") ? params.baseUrl : `${params.baseUrl}/`;
+    const url = new URL("oauth/authorize", base);
+    url.searchParams.set("client_id", params.clientId);
+    url.searchParams.set("redirect_uri", params.redirectUri);
+    url.searchParams.set("response_type", params.responseType);
+    if (params.scope?.length) url.searchParams.set("scope", params.scope.join(" "));
+    if (params.state) url.searchParams.set("state", params.state);
+    if (params.codeChallenge) url.searchParams.set("code_challenge", params.codeChallenge);
+    if (params.codeChallengeMethod) {
+      url.searchParams.set("code_challenge_method", params.codeChallengeMethod);
+    }
+    return url.toString();
+  }
+};
+
 // src/feeef/repositories/deposits.ts
 var DepositRepository = class extends ModelRepository {
   /**
@@ -3396,6 +3442,10 @@ var FeeeF = class {
    * The repository for managing users.
    */
   users;
+  /**
+   * The repository for managing developer-registered apps (OAuth clients).
+   */
+  apps;
   /**
    * The repository for managing orders.
    */
@@ -3482,6 +3532,7 @@ var FeeeF = class {
     this.imagePromptTemplates = new ImagePromptTemplatesRepository(this.client);
     this.imageGenerations = new ImageGenerationsRepository(this.client);
     this.users = new UserRepository(this.client);
+    this.apps = new AppRepository(this.client);
     this.orders = new OrderRepository(this.client);
     this.deposits = new DepositRepository(this.client);
     this.transfers = new TransferRepository(this.client);
@@ -3920,6 +3971,7 @@ function validatePhoneNumber(phone) {
 export {
   ATTACHMENT_TYPES,
   ActionsService,
+  AppRepository,
   CartService,
   CategoryRepository,
   CityRepository,