@delopay/sdk 0.64.0 → 0.65.0

package/dist/index.cjs

@@ -1745,13 +1745,26 @@ var Projects = class {
   /**
    * Get aggregate payment statistics across all projects for a merchant.
    *
+   * The response's flat `shops[]` array holds every shop, including shops that
+   * belong to no project — those are absent from `projects[].shops[]`, so look
+   * a single shop up in `shops[]`. Requires `MerchantAccountRead`; a
+   * shop-scoped user should call {@link Shops.stats} instead.
+   *
    * @param merchantId - The merchant account ID.
+   * @param period - Window in days, or `'all'` for an all-time total.
+   *   Omitted means the server default of 30 days.
    * @returns Project statistics.
+   *
+   * @example
+   * ```typescript
+   * const stats = await delopay.projects.stats('merch_123', 'all');
+   * const shop = stats.shops.find((s) => s.shop_id === 'pro_1');
+   * ```
    */
-  async stats(merchantId) {
-    return this.request("GET", "/projects/stats", {
-      query: { merchant_id: merchantId }
-    });
+  async stats(merchantId, period) {
+    const query = { merchant_id: merchantId };
+    if (period !== void 0) query["period"] = String(period);
+    return this.request("GET", "/projects/stats", { query });
   }
   /**
    * Get a high-level overview (volume, counts, top connectors) for a merchant.
@@ -2235,6 +2248,34 @@ var Shops = class {
   async list(merchantId) {
     return this.request("GET", `/shops/${encodeURIComponent(merchantId)}`);
   }
+  /**
+   * Successful-order count and revenue for one shop.
+   *
+   * Unlike `projects.stats()` this needs only `ProfileAccountRead`, so a
+   * shop-scoped user can load it for their own shop; merchant-level users can
+   * load any shop of their merchant.
+   *
+   * Revenue comes back FX-converted as `revenue_usd` (USD major units) plus a
+   * `revenue_by_currency` breakdown. The legacy `revenue` field is a raw
+   * cross-currency minor-unit sum and should not be displayed.
+   *
+   * @param merchantId - The merchant account ID.
+   * @param shopId - The shop (business profile) ID.
+   * @param period - Window in days, or `'all'` for an all-time total.
+   *   Omitted means the server default of 30 days.
+   * @returns The shop's stats over the requested window.
+   *
+   * @example
+   * ```typescript
+   * const stats = await delopay.shops.stats('merch_123', 'pro_1', 'all');
+   * console.log(stats.orders, stats.revenue_usd);
+   * ```
+   */
+  async stats(merchantId, shopId, period) {
+    const path = `/shops/${encodeURIComponent(merchantId)}/${encodeURIComponent(shopId)}/stats`;
+    if (period === void 0) return this.request("GET", path);
+    return this.request("GET", path, { query: { period: String(period) } });
+  }
   /**
    * Upload a logo file for a shop. The file is stored in Delopay's configured
    * object store and a public HTTPS URL is returned. This method does NOT write