[GH-ISSUE #207] [Map Local] #3 Map Local Service Logic #205

New issue

Open

opened 2026-03-03 19:49:10 +03:00 by kerem · 0 comments

kerem commented

2026-03-03 19:49:10 +03:00

Owner

Originally created by @NghiaTranUIT on GitHub (Mar 5, 2023).
Original GitHub issue: https://github.com/ProxymanApp/proxyman-windows-linux/issues/207

Originally assigned to: @kics223w1 on GitHub.

Description

⚠️ Ping @NghiaTranUIT for the MapLocalService and RuleStorageService as a code reference 👍

Acceptance Criteria

Save a MapLocalEntry as an Array. We don't need to support Tree View (Folder Mode) like the macOS.
Implement the MapLocalService and RuleStorageService
MapLocalService must be subclassed from RuleStorageService
RuleStorageService can be reused for other debugging tools, such as BlockListService, BreakpointService because they are sharing the same logic
The data is saved under App Data Directory. Don't save it in AppConfig.

RuleStorageService

RuleStorageService class will have matching fun, which accepts a Request.


    func matching(_ url: String, request: Request) -> T? {
        guard isEnabled,
            !entries.isEmpty else { return nil }
        return entries.first(where: { $0.matching(url, request: request) })
    }

It passes the logic to check which rule is matching to each Entry (In this case, it's the Map Local Entry)

Mapping Logic: ToolService class

Implement the ToolService class.
As soon as the Request in the Flow is created -> We pass it through the ToolService to determine which Tool is executed.
ToolService would check all available debugging tools, e.g. Block List, White List, Breakpoint, Map Local

Mapping Logic: Change the Response

✅ Important Logic: If a flow is matched with Map Local (check by the ToolService) -> Make sure the Flow never goes to the real Server -> The Server will return a Response (which is built by the MapLocalServer)
It enables the Mock API feature from the Map Local Tool -> Read ticket for further information.

✅ How to test (Happy case on macOS)

Use Insomnia: Make a real API call to httpbin.org
The new request appears on the main view
Right Click -> Tools -> Map Local
Automatically create a Map Local Rule -> Open the Editor -> The Editor must show the body of the httpbin.org
Go back to the Insomnia app -> Make an API again -> At this point: The API is a success and we can see the body.
Back Proxyman app -> Map Local Editor -> Try to edit the Status Code, Header, Body -> Save -> Go to Insomnia -> New Response data is displayed.

✅ How to test (Happy case on iPhone)

Set up Proxyman with your iPhone properly. Download the Product Hunt iOS app.
Use the Product Hunt iOS app -> Load the Home View
The new request appears on the main view
Right Click -> Tools -> Map Local
Automatically create a Map Local Rule -> The Editor must show the real Response Raw Message
Try to edit the Name Product on the Response Body.
Go back to the Product Hunt iOS app -> Pull to request on the Home Screen -> Make sure the UI is changed with the new Name Product.

Originally created by @NghiaTranUIT on GitHub (Mar 5, 2023). Original GitHub issue: https://github.com/ProxymanApp/proxyman-windows-linux/issues/207 Originally assigned to: @kics223w1 on GitHub. ## Description ⚠️ Ping @NghiaTranUIT for the MapLocalService and RuleStorageService as a code reference 👍 ## Acceptance Criteria - Save a MapLocalEntry as an Array. We don't need to support Tree View (Folder Mode) like the macOS. - Implement the MapLocalService and RuleStorageService - MapLocalService must be subclassed from RuleStorageService - RuleStorageService can be reused for other debugging tools, such as BlockListService, BreakpointService because they are sharing the same logic - The data is saved under App Data Directory. Don't save it in AppConfig. ### RuleStorageService RuleStorageService class will have matching fun, which accepts a Request. ```swift func matching(_ url: String, request: Request) -> T? { guard isEnabled, !entries.isEmpty else { return nil } return entries.first(where: { $0.matching(url, request: request) }) } ``` - It passes the logic to check which rule is matching to each Entry (In this case, it's the Map Local Entry) ### Mapping Logic: ToolService class - Implement the ToolService class. - As soon as the Request in the Flow is created -> We pass it through the ToolService to determine which Tool is executed. - ToolService would check all available debugging tools, e.g. Block List, White List, Breakpoint, Map Local ### Mapping Logic: Change the Response - ✅ Important Logic: If a flow is matched with Map Local (check by the ToolService) -> Make sure the Flow never goes to the real Server -> The Server will return a Response (which is built by the MapLocalServer) - It enables the Mock API feature from the Map Local Tool -> Read ticket for further information. ### ✅ How to test (Happy case on macOS) 1. Use Insomnia: Make a real API call to `httpbin.org` 2. The new request appears on the main view 3. Right Click -> Tools -> Map Local 4. Automatically create a Map Local Rule -> Open the Editor -> The Editor must show the body of the `httpbin.org` 5. Go back to the Insomnia app -> Make an API again -> At this point: The API is a success and we can see the body. 6. Back Proxyman app -> Map Local Editor -> Try to edit the Status Code, Header, Body -> Save -> Go to Insomnia -> New Response data is displayed. ### ✅ How to test (Happy case on iPhone) 1. Set up Proxyman with your iPhone properly. Download the Product Hunt iOS app. 2. Use the Product Hunt iOS app -> Load the Home View 3. The new request appears on the main view 4. Right Click -> Tools -> Map Local 5. Automatically create a Map Local Rule -> The Editor must show the real Response Raw Message 6. Try to edit the Name Product on the Response Body. 7. Go back to the Product Hunt iOS app -> Pull to request on the Home Screen -> Make sure the UI is changed with the new Name Product.