Skip to content

Mobile-130: Add operationsDomain#699

Closed
justSmK wants to merge 10 commits into
developfrom
feature/MOBILE-130-operationsDomain
Closed

Mobile-130: Add operationsDomain#699
justSmK wants to merge 10 commits into
developfrom
feature/MOBILE-130-operationsDomain

Conversation

@justSmK
Copy link
Copy Markdown
Collaborator

@justSmK justSmK commented Apr 27, 2026

ticket

Основная фича без fastlane (8 коммитов): changes/BASE..6337f8f8
Реордер operationsDomain: commits/90a8456c
Fastlane bump 2.233.0 (2578fd5) — чисто инфра, нужен для CI на Xcode 26.4, можно проскипать.

@justSmK justSmK changed the title Feature/mobile 130 operations domain Mobile-130: add operationsDomain Apr 27, 2026
@justSmK justSmK changed the title Mobile-130: add operationsDomain Mobile-130: Add operationsDomain Apr 27, 2026
@justSmK justSmK requested review from Vailence and enotniy April 27, 2026 17:13
@justSmK justSmK marked this pull request as draft April 28, 2026 10:57
justSmK added 10 commits April 28, 2026 14:01
Adds optional `operationsDomain` to `MBConfiguration` so projects served
via a CDP anonymizer can route operations and track-visit requests to
a separate host, avoiding personal-data leaks to `api.mindbox.ru`.

Affected routes (now resolve to `operationsDomain` when configured):
  - `/v3/operations/{async,sync,async-custom}`
  - `/v1.1/customer/mobile-track-visit`
  - SDK logs upload
Config-fetch (`/mobile/byendpoint/*.json`) and `/geo` keep using `domain`.

Priority of resolution:
  1. `settings.baseAddresses.operations` from the mobile JSON config
  2. `operationsDomain` passed to `Mindbox.initialization(...)`
  3. `nil` → fall back to `MBConfiguration.domain` (existing behavior)

The JSON-sourced value is persisted in `UserDefaults` so operations stay
pinned to the anonymizer across restarts. An explicit `null` / empty
value in a fresh config clears the cache (rollback channel); a
format-broken value preserves the previous good one.

Backwards compatibility:
  - `operationsDomain` has a default value of `nil`
  - `softReset()` preserves `operationsDomainFromConfig` (PD safety on
    migration resets)
  - Legacy `MBConfiguration` JSON without the new key decodes fine

Tests cover `URLRequestBuilder` host resolution, `MBConfiguration`
validation, `Settings` JSON decoding (incl. `null`/empty rollback),
`ConfigValidation` behavior, `MBNetworkFetcher` priority resolution,
`OperationsDomainConfigPolicy` decision matrix, persistence lifecycle,
and legacy-config decoding.

Follow-ups (separate commits):
  - Drop dead `SDKLogsRoute`
  - Rewrite `URLValidator` (hardcoded TLD list, `&` bug)
  - Allow optional `https://` scheme in `domain` / `operationsDomain` inputs
Extends `SettingsConfigParsingTests` with `baseAddresses` cases from
the Pkl error stubs (`Error`, `TypeError`, `OperationsError`,
`OperationsTypeError`) and a positive assertion in
`test_SettingsConfig_shouldParseSuccessfully`. Updates JSON fixtures
under `SettingsJsonStubs/` to carry the new `baseAddresses` block
(sourced from `pkl-mobile-config`); adds `BaseAddressesError/` with
four fixtures and wires them into the test bundle via
`Mindbox.xcodeproj/project.pbxproj`.

Switches `Settings.BaseAddresses` to a custom `init(from:)` with
per-field `try?` so a type error on `operations` nils only that
field — matching `FeatureToggles`/`SlidingExpiration`/`InAppSettings`.

Drops two parsing tests from `OperationsURLRoutingTests` whose
coverage is now duplicated (positive parse, missing `baseAddresses`).
Rollback-channel cases (`null` and empty string) stay there — they
exercise feature behavior, not schema parsing.
Adds `MindboxTests/Configuration/MBConfigurationTests.swift` (Swift
Testing, `.mbConfiguration` tag) — a single suite covering the full
behavior of `MBConfiguration`: programmatic init validation
(`domain`, `endpoint`, `operationsDomain`, UUID handling for
`previousInstallationId`/`previousDeviceUUID`), defaults, plist init,
Codable (legacy / new / decoder validation), and
`ConfigValidation.compare` across the whole input space (identity,
`nil` handling, `.rest`-affecting fields, `.shouldCreateCustomer`
priority, fields that must not trigger any change).

Consolidates from two sources:
  - Plist init coverage from `MBConfigurationTestCase.swift` (XCTest,
    deleted) — folded into a single parametrised section.
  - Seven `MBConfiguration`-shaped tests previously living in
    `OperationsURLRoutingTests.swift` (init validation, two
    `ConfigValidation.compare` cases, legacy JSON decoding).

Adds `Tag.mbConfiguration` and registers the new file under a new
`Configuration/` group in `Mindbox.xcodeproj/project.pbxproj`.
`SDKLogsRoute` had no references in production code: SDK logs flow
through `SDKLogsManager.sendLogs` → `EventRepository.send` →
`EventRoute.asyncEvent` (`MBEventRepository.makeRoute` for
`.sdkLogs`).

Removes the type from `SDKLogsRequest.swift`. `SDKLogsRequest` (the
Codable body) stays — it is the request payload encoded into
`Event.body`.

Updates `OperationsURLRoutingTests` to assert routing for
`.sdkLogs` through the actual `EventRoute.asyncEvent` path. The
dedicated `sdkLogsRouteUsesOperationsDomain` test is removed
(subsumed by the extended `eventRoutesUseOperationsDomain` and
`noOperationsDomainFallsBackToDomain` cases).
`MBConfiguration.domain` and `MBConfiguration.operationsDomain` now
accept `host`, `https://host`, and `http://host` (with or without
trailing slash). When a scheme is present in the input, requests are
built with that scheme; otherwise `https://` is used as before.
Mirrors the Android SDK's `SdkValidation.extractHost` / `toBaseUrl`
pair, so both platforms accept the same inputs (e.g. a value pasted
straight from the dashboard URL).

Adds `Mindbox/Network/Helpers/HostNormalizer.swift`:
  - `extractHost` — strips scheme (case-insensitive), whitespace, and
    trailing slashes.
  - `toBaseURLString` — preserves an existing scheme or prepends
    `https://`.
  - `isValidHost` — runs the extracted host through `URLValidator`.
    Encapsulates the awkward `URL(string: "https://" + host)` +
    `URLValidator` pattern previously duplicated across three call
    sites.

`URLRequestBuilder` builds the base URL via
`HostNormalizer.toBaseURLString(...)` before adding `path` / `queryItems`,
so the resolved scheme propagates to every route. Same value also
flows through `OperationsDomainConfigPolicy` when validating the
operations host coming from the JSON config.

Tests:
  - `HostNormalizerTests` (Swift Testing) — extract / base-URL /
    validation across scheme, case, trailing slash, whitespace.
  - `MBConfigurationTests` — accepts `domain` / `operationsDomain`
    with `https://`, `http://`, trailing slash. Replaces the previous
    "scheme throws" invariant.
  - `OperationsURLRoutingTests` — bare host → https default,
    `https://` / `http://` preserved end-to-end, trailing slash
    stripped before path append.

Backwards compatible: integrators who pass a bare host get exactly
the same URLs as before.
Replaces the old full-URL regex (hardcoded TLD list missing
`.app`/`.dev`/`.io`, `&` HTML-escape bug, per-call regex compile
via `try!`) with an RFC 1123-style host validator. New TLDs are
accepted automatically by structure — analogous to Android's
`PatternsCompat.DOMAIN_NAME`.

API: `URLValidator.isValidHost(_ host: String) -> Bool` (static, no
instance). Drops the previous `URLValidator(url:).evaluate()` shape;
callers (`MBConfiguration`, `OperationsDomainConfigPolicy`) are
updated.

Implementation is plain Swift (no regex, no `try!`):
  - Each label: 1..63 chars, alnum + hyphen, hyphen not at edges.
  - Hosts joined by `.`; single-label (`localhost`) and IPv4 literals
    accepted (digits-only labels are valid alnum).
  - Total length capped at 253 (RFC 1035), constants explicit.
  - ASCII-only contract: punycode (`xn--…`) passes, Unicode literals
    don't (callers must convert IDN to ACE).

Removes the thin `HostNormalizer.isValidHost` wrapper — it was a
trivial composition of `extractHost` + validation that didn't belong
in a normalizer. Call sites now spell out the chain explicitly:
`URLValidator.isValidHost(HostNormalizer.extractHost(value))`.

Tests:
  - New `URLValidatorTests` (Swift Testing) with 22 cases covering
    passing inputs (modern TLDs, localhost, IPv4, hyphenated and
    single-char labels, mixed case, punycode, max label/host
    length boundaries) and failing inputs (empty, whitespace,
    underscore, edge-hyphen, empty labels, embedded scheme,
    path/query, special characters, Unicode literals, length
    overflow).
  - Removed `testURLValidator` from `ValidatorsTestCase` — the
    full-URL contract no longer applies.
  - Removed redundant `isValidHost` tests from `HostNormalizerTests`
    (covered by `URLValidatorTests` now).
…clusion

Extract `applyDownloadedConfig(_:rawData:)` and `sendMonitoringLogsIfNeeded(_:)`
so the .data branch reads as decode → assign → apply.

Group the three `SessionTemporaryStorage` writes inside `setupSettingsFromConfig`
into `applySessionStorageSettings(_:)` so the dispatcher reads as four steps.

Move the rationale for excluding `operationsDomainFromConfig` from `softReset()`
to the property's docstring, where it belongs.
The new parameter now sits right after `domain` instead of at the end —
they're conceptually paired (main host vs its anonymizer override).
Source-compatible: callers that don't pass `operationsDomain` are
unaffected; the few that do (tests, ios-app) already listed it adjacent
to `domain` and only need a follow-up reorder of their own.
…me://host form

Backend may send `http://` for some anonymizer setups; previous logic stored
the raw string verbatim, so trailing slashes / scheme-vs-host mismatches caused
spurious re-saves. Normalize via HostNormalizer.toBaseURLString on save: scheme
preserved (http/https), trailing slash stripped, missing scheme defaults to
https. Idempotent — first config fetch after upgrade rewrites legacy values
once, then `.keep` stably.

Adapts existing Policy tests to the canonical form and adds coverage for the
trailing-slash case from JSON config, http preservation, canonical-equality
keep, and the legacy-value upgrade path.
@justSmK justSmK force-pushed the feature/MOBILE-130-operationsDomain branch from abd53fb to 119b3aa Compare April 28, 2026 11:01
@justSmK justSmK closed this Apr 28, 2026
@justSmK
Copy link
Copy Markdown
Collaborator Author

justSmK commented Apr 28, 2026

Мусорно вышло, решил переделать нормально. fastlane fix уехал в develop самостоятельно, фича отдельно с rebase поверх develop ветки, чтобы тесты заработали. Хочу все коммиты без сквоша чтобы попали в develop

@justSmK justSmK deleted the feature/MOBILE-130-operationsDomain branch April 29, 2026 16:23
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant