atsfill 0.0.4.dev127__tar.gz → 0.0.4.dev129__tar.gz

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: atsfill
-Version: 0.0.4.dev127
+Version: 0.0.4.dev129
 Summary: Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle.
 Keywords: job-applications,ats,ashby,greenhouse,teamtailor,ai-agents,cli
 Author: shbernal

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/pyproject.toml

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev127"
+version = "0.0.4.dev129"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/pyproject.toml.orig

@@ -1,6 +1,6 @@
 [project]
 name = "atsfill"
-version = "0.0.4.dev127"
+version = "0.0.4.dev129"
 description = "Read, dry-run and submit job application forms on hiring systems: Ashby, Greenhouse, Teamtailor, Welcome to the Jungle."
 readme = "README.md"
 license = "MIT"

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/src/atsfill/adapters/hrmdirect.py

@@ -97,7 +97,7 @@ class HRMDirect:
     name = "hrmdirect"
     per_employer = True
     asks = {"name"}
-    known_gaps = {"screening_first": Gap.FLOW, "sign_up_phone": Gap.FLOW}
+    known_gaps = {"screening_first": Gap.FLOW}
     side_effects = [
         SideEffect(
             "sign_up", "employer", "the account is the employer's candidate, emailed a link"
@@ -184,17 +184,18 @@ class HRMDirect:
 
     def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
         """Fills the apply page's first step, which creates the account signed in and sets no
-        password: the email that follows holds a link to set one, `blocked: email_link`."""
+        password: the email that follows holds a link to set one, `blocked: email_link`. The
+        mobile phone is given only where the org requires it; a missing one is refused before
+        anything is sent."""
         _to_apply(page)
         if not page.locator(IDENTITY).is_visible():
             raise Unsupported(
                 known_gap(self, "screening_first", "the form's first page comes before sign-up")
             )
         phone = page.locator(f"{IDENTITY} .form-group:has(input.mobile-number)")
-        if phone.count() and not phone.locator(".common-option-label").count():
-            raise Unsupported(
-                known_gap(self, "sign_up_phone", "the sign-up step requires a mobile phone")
-            )
+        phone_asked = phone.count() and not phone.locator(".common-option-label").count()
+        if phone_asked and not details.phone:
+            raise Refused("sign_up_details: no phone")
         if page.locator(RECAPTCHA).count():
             raise Blocked("captcha: a reCAPTCHA box keeps the sign-up's Continue disabled")
         first, _, last = (details.name or "").strip().partition(" ")
@@ -203,6 +204,8 @@ class HRMDirect:
         form.locator("input.last-name").fill(last or first)
         form.locator("input.email").fill(email)
         form.locator("input.email-confirm").fill(email)
+        if phone_asked:
+            form.locator("input.mobile-number").fill(details.phone or "")
         for group in form.locator(".radio-group:has(input[required])").all():
             group.locator("label:has(input[value=false])").click()  # declines, the least given
         form.locator("button.submit-button").click()

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/src/atsfill/adapters/successfactors.py

@@ -34,6 +34,8 @@ SIGNED_IN = re.compile(r"\bsignOut|\blogout\b|_logout", re.IGNORECASE)
 FIELDS = (Path(__file__).with_suffix(".js")).read_text()
 # What the candidate pages show once loaded
 SIGN_IN = "#username"
+COUNTRY = "fbclc_country"  # its options' values are ISO 3166 alpha-2 codes
+PHONE, CALLING_CODE = "#fbclc_phoneNumber", "#fbclc_ituCode"  # `CA`: `Canada (+1)`
 SIGN_UP = "#fbclc_userName"
 QUICK_APPLY = "#fbqa_apply"
 FORM = ".RCMFormField"
@@ -86,6 +88,22 @@ def _company(request: Request) -> list[tuple[str, str]]:
     )
 
 
+def _calling_code(select: Locator, details: SignUpDetails) -> tuple[str, str]:
+    """The calling code's option for the E.164 phone, the one of `country` among the countries
+    sharing it, and the national number that follows the code."""
+    options = select.evaluate("s => [...s.options].map(o => [o.value, o.textContent])")
+    phone = (details.phone or "").removeprefix("+")
+    codes = [
+        (len(m[1]), value == details.country, value)
+        for value, text in options
+        if (m := re.search(r"\(\+(\d+)\)", text)) and phone.startswith(m[1])
+    ]
+    if not codes:
+        raise Unsupported(f"unhandled_rendering: the sign-up offers no calling code for {phone}")
+    length, _, value = max(codes, key=lambda c: c[:2])  # the first of the best
+    return value, phone[length:]
+
+
 class SuccessFactors:
     name = "successfactors"
     per_employer = True
@@ -146,6 +164,10 @@ class SuccessFactors:
             raise Refused(f"wrong_password: {message}") from None
 
     def sign_up(self, page: Page, email: str, password: str, details: SignUpDetails) -> None:
+        """Creates the account from the career site's sign-up: the name, the country of
+        residence from `country` (the list's first without it), and the phone where the site
+        requires one, its calling code picked from the number; a missing phone is refused
+        before anything is sent."""
         self._candidate(page)
         if page.locator(SIGN_IN).count():
             page.locator(REGISTER).first.click()
@@ -160,6 +182,9 @@ class SuccessFactors:
                 ) from None
             register.first.click()
         page.locator(SIGN_UP).wait_for(timeout=LANDING_TIMEOUT_MS)
+        phone_asked = page.locator(f"{PHONE}[aria-required=true]:visible").count() > 0
+        if phone_asked and not details.phone:
+            raise Refused("sign_up_details: no phone")
         first, _, last = (details.name or "").strip().partition(" ")
         for selector, value in [
             (SIGN_UP, email),
@@ -170,10 +195,17 @@ class SuccessFactors:
             ("#fbclc_lName", last or first),
         ]:
             page.fill(selector, value)
-        for select in page.locator("select:visible").all():  # the country, a phone code
+        if phone_asked and details.phone:
+            code, national = _calling_code(page.locator(CALLING_CODE), details)
+            page.locator(CALLING_CODE).select_option(code)
+            page.fill(PHONE, national)
+        for select in page.locator("select:visible").all():  # the country, any other
             if not select.input_value():
                 values = select.evaluate("s => [...s.options].map(o => o.value).filter(v => v)")
-                select.select_option(values[0])
+                wanted = details.country if select.get_attribute("id") == COUNTRY else None
+                if wanted and wanted not in values:
+                    raise Unsupported(f"unhandled_rendering: the sign-up's countries lack {wanted}")
+                select.select_option(wanted or values[0])
         if page.locator(PRIVACY).count():
             page.locator(PRIVACY).click()
             dialog = page.locator("[role=dialog]:visible").last
@@ -201,6 +233,8 @@ class SuccessFactors:
         if page.locator(f"{SIGN_IN}:visible").count():  # created, signed out
             self.sign_in(page, email, password)
             return
+        if self.signed_in(page.request, None):  # created, back on the career site
+            return
         raise Unsupported(f"unhandled_rendering: the sign-up led to {urlsplit(page.url).path}")
 
     def browser_read(self, page: Page) -> list[Field]:

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/src/atsfill/adapters/ukg.py

@@ -36,7 +36,6 @@ YES_NO = ["Yes", "No"]
 DATE_SHOWN = re.compile(r"(\d\d)/(\d\d)/(\d{4})")
 COUNTRY, STATE = "Country", "State"
 DAYS, DOCUMENTS = "availability_days", "documents"
-PHONE_GAP = "sign_up_phone"
 
 # Auth0's error codes on the sign-in and sign-up pages, by what atsfill raises
 ERRORS = [
@@ -218,8 +217,8 @@ def board(url: str) -> Board | None:
 class UKG:
     name = "ukg"
     per_employer = True
-    asks = {"name"}
-    known_gaps = {PHONE_GAP: Gap.FLOW}
+    asks = {"name", "phone"}  # the phone only some tenants require, asked before the sign-up
+    known_gaps: dict[str, Gap] = {}
     side_effects = [
         SideEffect("sign_up", "employer", "the account is created in the employer's tenant"),
         SideEffect("upload", "hiring_system", "a document is stored in the account's documents"),
@@ -284,7 +283,7 @@ class UKG:
         _left_sign_in(page)
         if "/AuthCode/Register" not in page.url:
             return
-        _register(page, details.name or "")
+        _register(page, details)
 
     def browser_read(self, page: Page) -> list[Field]:
         found = board(page.url)
@@ -397,26 +396,33 @@ def _left_sign_in(page: Page) -> None:
     raise Unsupported("unhandled_rendering: the sign-in page answered nothing")
 
 
-def _register(page: Page, name: str) -> None:
-    """The tenant's own step after the sign-up: the name, and the privacy policy's box on some
-    tenants; the box for text messages is left. Its inputs take typed keys only: a filled value
+def _register(page: Page, details: SignUpDetails) -> None:
+    """The tenant's own step after the sign-up: the name, the phone where the tenant requires
+    it, and the privacy policy's box on some tenants; the optional consents (text messages, AI
+    scoring, ticked by default) are declined. Its inputs take typed keys only: a filled value
     leaves Create account disabled."""
     page.locator("input[name=firstName]").wait_for(timeout=FORM_TIMEOUT_MS)
     page.wait_for_load_state("networkidle")
+    first, _, last = (details.name or "").strip().partition(" ")
+    values = [("firstName", first), ("lastName", last or first)]
     if page.locator("ukg-input[name=phoneNumber][required=true]").count():
-        raise Unsupported(f"{Gap.FLOW}: {PHONE_GAP}: the tenant's sign-up asks a phone number")
-    first, _, last = name.strip().partition(" ")
-    for field, value in (("firstName", first), ("lastName", last or first)):
+        values.append(("phoneNumber", details.phone or ""))
+    for field, value in values:
         page.locator(f"input[name={field}]").click()
         page.locator(f"input[name={field}]").press_sequentially(value)
-    privacy = page.locator("ukg-checkbox[data-automation*=privacy]:visible")
-    for box in privacy.all():
-        if box.get_attribute("aria-checked") != "true":
+    for box in page.locator("ukg-checkbox[data-automation*=-checkbox]:visible").all():
+        wanted = "privacy" in (box.get_attribute("data-automation") or "")
+        if _ticked(box) != wanted:
             box.click()
     page.get_by_role("button", name="Create account").click()
     page.wait_for_url(lambda u: "/AuthCode/Register" not in u, timeout=FORM_TIMEOUT_MS)
 
 
+def _ticked(box: Locator) -> bool:
+    """A `ukg-checkbox`'s state: `aria-checked` once clicked, `checked` as the page set it."""
+    return "true" in (box.get_attribute("aria-checked"), box.get_attribute("checked"))
+
+
 def _field(raw: dict[str, Any], states: dict[str, list[str]] | None) -> Field:
     kind, field_id = raw["kind"], raw["id"]
     label = raw["label"] or field_id

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/src/atsfill/core/commands.py

@@ -63,7 +63,7 @@ def _login_required(url: str, adapter: NeedsAccount, user: str) -> Result:
 
 type Credentials = tuple[str, str]  # email, password
 # Refusals the page states before any account exists: the generated password goes.
-NO_ACCOUNT = {"email_in_use", "email_domain_rejected", "password_rule"}
+NO_ACCOUNT = {"email_in_use", "email_domain_rejected", "password_rule", "sign_up_details"}
 
 
 def _email_link(reason: str | None, email: str, command: str) -> str | None:

{atsfill-0.0.4.dev127 → atsfill-0.0.4.dev129}/src/atsfill/registry.toml

@@ -96,7 +96,7 @@ share = 0.0350
 account = "to_read"
 hosting = ["hosted"]
 adapter = "successfactors"
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "0d8baea", by = "agent", reason = "quick_apply_sign_up: a Quick Apply page creates the account and sends the application in one submit, its sign-in offering no sign-up; sign_up_fields: a sign-up asking a phone number" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "0d8baea", by = "agent", reason = "quick_apply_sign_up: a Quick Apply page creates the account and sends the application in one submit, its sign-in offering no sign-up; sign_up_fields: a sign-up asking who may see the profile" }
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
 
 [ukg]
@@ -106,7 +106,7 @@ account = "to_read"
 hosting = ["hosted"]
 adapter = "ukg"
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "a60a17d", by = "agent", reason = "unsupported_flow: sign_up_phone: the tenant's details step after the sign-up requires a phone number, which login does not take (10 of 17 tenants)" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "a60a17d", by = "agent", reason = "unhandled on the forms the sign-up now reaches, 3 of 8 tenants ready: no gender decline box to tick (3), a State whose condition names no Country (1), a numeric answer read back differently (1)" }
 
 [paycom]
 kind = "ats"
@@ -260,10 +260,10 @@ dry_run_verified = { date = 2026-10-22, version = "0.0.3", by = "adapter_gate",
 [ukgready]
 kind = "ats"
 share = 0.0085
-account = "to_read"  # the first step's Continue creates a password-less account and the job application; a sign-up with a password asks a zip code
+account = "to_read"  # the sign-in's Create a new account sets a password, asking the name, country and zip code
 hosting = ["hosted"]
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "95f2522", by = "agent", reason = "unsupported_flow: sign_up_zip: the sign-up that sets a password requires a zip code, which login does not take; the first step's account has none, so it cannot be signed in to again (14 of 14 tenants)" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "b0cb322", by = "agent", reason = "unsupported_flow: profile_wizard: signed in, the form is the applicant portal's profile wizard, items of a dozen types edited in cards, entry lists, a security question and an electronic signature; not built within the round (1 tenant walked)" }
 
 [adpmyjobs]
 kind = "ats"
@@ -306,7 +306,7 @@ share = 0.0059
 account = "to_read"
 hosting = ["hosted"]
 mapped = { date = 2026-10-20, version = "0.0.2", by = "agent", commit = "7934b25" }
-unsupported = { date = 2026-10-26, version = "0.0.3", commit = "211fe03", by = "agent", reason = "unsupported_flow: screening_first: the form's first page comes before the sign-up step (4 of 14 orgs); sign_up_phone: the sign-up step requires a mobile phone, which login does not take (1 of 17); a reCAPTCHA box on the sign-up step (1 of 17); 3 orgs signed in, under the 5 dry runs the gate needs" }
+unsupported = { date = 2026-10-26, version = "0.0.3", commit = "211fe03", by = "agent", reason = "unsupported_flow: screening_first: the form's first page comes before the sign-up step (4 of 14 orgs); a reCAPTCHA box on the sign-up step (1 of 17); 3 orgs signed in, under the 5 dry runs the gate needs" }
 
 [applicantpro]
 kind = "ats"