feeef 0.8.2 → 0.8.4

package/build/index.js

@@ -318,6 +318,65 @@ var ProductRepository = class extends ModelRepository {
   }
 };
 
+// src/feeef/repositories/store_invites_repository.ts
+var StoreInvitesRepository = class {
+  constructor(client, resource) {
+    this.client = client;
+    this.resource = resource;
+  }
+  /**
+   * Lists invites for a store.
+   * @param storeId - The store ID.
+   * @param params - Optional filters (e.g. status).
+   * @returns A Promise that resolves to the list of invites.
+   */
+  async list(storeId, params) {
+    const res = await this.client.get(`/${this.resource}/${storeId}/invites`, { params });
+    return res.data;
+  }
+  /**
+   * Creates a store invite (sends email to invitee).
+   * @param storeId - The store ID.
+   * @param data - The invite data.
+   * @returns A Promise that resolves to the created invite.
+   */
+  async create(storeId, data) {
+    const res = await this.client.post(`/${this.resource}/${storeId}/invites`, data);
+    return res.data;
+  }
+  /**
+   * Gets invite details (public or full if authorized).
+   * @param storeId - The store ID.
+   * @param inviteId - The invite ID.
+   * @returns A Promise that resolves to the invite.
+   */
+  async get(storeId, inviteId) {
+    const res = await this.client.get(`/${this.resource}/${storeId}/invites/${inviteId}`);
+    return res.data;
+  }
+  /**
+   * Revokes a pending invite.
+   * @param storeId - The store ID.
+   * @param inviteId - The invite ID.
+   */
+  async revoke(storeId, inviteId) {
+    await this.client.delete(`/${this.resource}/${storeId}/invites/${inviteId}`);
+  }
+  /**
+   * Accepts an invite (authenticated user's email must match invite email).
+   * @param storeId - The store ID.
+   * @param inviteId - The invite ID.
+   * @param token - The invite token from the email link.
+   * @returns A Promise that resolves to the created store member.
+   */
+  async accept(storeId, inviteId, token) {
+    const res = await this.client.post(`/${this.resource}/${storeId}/invites/${inviteId}/accept`, {
+      token
+    });
+    return res.data;
+  }
+};
+
 // src/feeef/repositories/stores.ts
 var StoreRepository = class extends ModelRepository {
   /**
@@ -410,67 +469,24 @@ var StoreRepository = class extends ModelRepository {
     await this.client.delete(`/${this.resource}/${storeId}/members/${memberId}`);
   }
   /**
-   * Creates a store invite (sends email to invitee).
-   * @param storeId - The store ID.
-   * @param data - The invite data.
-   * @returns A Promise that resolves to the created invite.
-   */
-  async createInvite(storeId, data) {
-    const res = await this.client.post(`/${this.resource}/${storeId}/invites`, data);
-    return res.data;
-  }
-  /**
-   * Lists invites for a store.
-   * @param storeId - The store ID.
-   * @param params - Optional filters (e.g. status).
-   * @returns A Promise that resolves to the list of invites.
-   */
-  async listInvites(storeId, params) {
-    const res = await this.client.get(`/${this.resource}/${storeId}/invites`, { params });
-    return res.data;
-  }
-  /**
-   * Revokes a pending invite.
-   * @param storeId - The store ID.
-   * @param inviteId - The invite ID.
-   */
-  async revokeInvite(storeId, inviteId) {
-    await this.client.delete(`/${this.resource}/${storeId}/invites/${inviteId}`);
-  }
-  /**
-   * Gets invite details (public or full if authorized).
-   * @param storeId - The store ID.
-   * @param inviteId - The invite ID.
-   * @returns A Promise that resolves to the invite.
-   */
-  async getInvite(storeId, inviteId) {
-    const res = await this.client.get(`/${this.resource}/${storeId}/invites/${inviteId}`);
-    return res.data;
-  }
-  /**
-   * Accepts an invite (authenticated user's email must match invite email).
-   * @param storeId - The store ID.
-   * @param inviteId - The invite ID.
-   * @param token - The invite token from the email link.
-   * @returns A Promise that resolves to the created store member.
+   * Repository for store invites. Use e.g. `ff.stores.invites.list(storeId)`, `ff.stores.invites.create(storeId, data)`.
    */
-  async acceptInvite(storeId, inviteId, token) {
-    const res = await this.client.post(`/${this.resource}/${storeId}/invites/${inviteId}/accept`, {
-      token
-    });
-    return res.data;
+  get invites() {
+    return new StoreInvitesRepository(this.client, this.resource);
   }
   /**
    * Upgrades or renews a store's subscription plan.
    * @param id - The store ID.
    * @param plan - The plan type to upgrade to.
    * @param months - The number of months (1-12).
-   * @returns A Promise that resolves when the upgrade is complete.
+   * @param code - Optional promo code.
    */
-  async upgrade(id, plan, months) {
+  async upgrade(id, plan, months, options) {
     await this.client.post(`/${this.resource}/${id}/subscription/upgrade`, {
       plan,
-      months
+      months,
+      // eslint-disable-next-line eqeqeq
+      ...options?.code != null && options.code !== "" && { code: options.code }
     });
   }
   /**
@@ -791,6 +807,68 @@ var UserRepository = class extends ModelRepository {
   }
 };
 
+// src/feeef/repositories/apps.ts
+var AppRepository = class extends ModelRepository {
+  constructor(client) {
+    super("apps", client);
+  }
+  /**
+   * Lists apps with optional pagination and filterator.
+   * @param options - Page, limit, filterator, q, and extra params forwarded to the API.
+   */
+  async list(options) {
+    const params = { ...options?.params };
+    if (options) {
+      if (options.page !== void 0) params.page = options.page;
+      if (options.limit !== void 0) params.limit = options.limit;
+      if (options.q !== void 0) params.q = options.q;
+      if (options.filterator !== void 0) params.filterator = options.filterator;
+      if (options.userId !== void 0) params.userId = options.userId;
+      if (options.active !== void 0) params.active = options.active;
+    }
+    return super.list({ page: options?.page, limit: options?.limit, params });
+  }
+  /**
+   * 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 {
   /**
@@ -926,6 +1004,41 @@ var DepositRepository = class extends ModelRepository {
   }
 };
 
+// src/feeef/repositories/promos.ts
+var PromoRepository = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Lists promos with optional pagination and validNow filter.
+   */
+  async list(params) {
+    const query = {};
+    if (params?.page != null) query.page = params.page;
+    if (params?.limit != null) query.limit = params.limit;
+    if (params?.validNow === true) query.validNow = "1";
+    const res = await this.client.get("/promos", { params: query });
+    return res.data;
+  }
+  /**
+   * Validates a promo code. Returns validation result with discount info or reason.
+   */
+  async validate(params) {
+    const res = await this.client.post("/promos/validate", {
+      code: params.code,
+      storeId: params.storeId
+    });
+    return res.data;
+  }
+  /**
+   * Creates a promo (admin). Returns the created promo.
+   */
+  async create(data) {
+    const res = await this.client.post("/promos", data);
+    return res.data;
+  }
+};
+
 // src/feeef/repositories/transfers.ts
 var TransferRepository = class extends ModelRepository {
   /**
@@ -3396,6 +3509,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.
    */
@@ -3408,6 +3525,10 @@ var FeeeF = class {
    * The repository for managing transfers.
    */
   transfers;
+  /**
+   * The repository for managing promo codes (list, validate, create).
+   */
+  promos;
   /**
    * The repository for managing categories.
    */
@@ -3482,9 +3603,11 @@ 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);
+    this.promos = new PromoRepository(this.client);
     this.categories = new CategoryRepository(this.client);
     this.countries = new CountryRepository(this.client);
     this.states = new StateRepository(this.client);
@@ -3920,6 +4043,7 @@ function validatePhoneNumber(phone) {
 export {
   ATTACHMENT_TYPES,
   ActionsService,
+  AppRepository,
   CartService,
   CategoryRepository,
   CityRepository,
@@ -3952,6 +4076,7 @@ export {
   ProductStatus,
   ProductType,
   ProductVariantView,
+  PromoRepository,
   ShippingMethodPolicy,
   ShippingMethodRepository,
   ShippingMethodStatus,
@@ -3962,6 +4087,7 @@ export {
   StorageService,
   StoreActionType,
   StoreInviteStatus,
+  StoreInvitesRepository,
   StoreMemberRole,
   StoreRepository,
   StoreSubscriptionStatus,