Files
jobboard/app/static/companies.js
T

518 lines
21 KiB
JavaScript

/* The Company boards section of Sources: every company, its board, its open
* roles, its affinity, and following a new one.
*
* The list is app.js's shared company list (`/api/companies`), already
* joined with each company's board subscription — its id and whether it is
* on — so nothing here fetches `/api/sources` as well. The affinity buttons
* are `affinityControl`, the same ones the Roles tab and the read page draw,
* and beside them `overridesControl`, the two fetch overrides All locations
* and All roles, which are global and drawn with or without an agent.
*
* Liked and hidden are per search agent, so the `#c-agent` select above the
* list says whose the list shows and whose the buttons set. It opens on the
* server's default, the enabled agent with the lowest id; with no agent at
* all there is nothing to like, and the section says so instead of drawing
* the buttons.
*
* Each row's "Set board" (no board yet) or "Change" (a board) opens a small
* editor in the row: the host select, with the options the server rendered
* into the Follow form's `#b-host`, and a slug. Saving posts to
* `/api/companies/{key}/board`, which reads the board once before keeping
* it; Detach stops reading it and keeps the company.
*
* A row with a board says what a pull asks it for, countries first and role
* types second ("reads follows agents: DK, SE, remote · all roles", `reach`
* from app/jobs/reach.py), so the row shows whether the company follows the
* agents' filters or overrides them. Its editor has a second line that sets
* the board's own reach: the agents', or its own countries and remote,
* posted to `/api/sources/{id}/reach`. Fetching from the whole world gate (All
* locations) and no fetch terms or titles to leave out (All roles) are the
* company's two overrides instead, and the board's own countries win over
* All locations.
*
* Beside that line stands the board's size, set when it was added and
* changed only by a Recheck ("999 roles · checked 30 Sep"). Recheck, beside
* Change, sizes the board again (`/api/sources/{id}/size`) and queues a
* pull, since the size decides whether the board is filtered.
*
* After the size stand the board's limits, words for what its read cannot do
* ("read incomplete · no pay · without text: 12", `limits` from
* app/jobs/limits.py), and the Limits group of the filter picks the companies
* that have one. "N on this board" beside the open roles says the company
* has roles from a search too.
*/
(function () {
"use strict";
const {
api, count, debounce, safeUrl, companies, loadCompanies, affinityControl, overridesControl,
} = window;
const $ = (sel, root = document) => root.querySelector(sel);
/** @type {object[]} the search agents, by id */
let agents = [];
/** The key of the row whose board editor is open, or null. One at a time. */
let editing = null;
/** The id in `#c-agent`, or null while there is no agent to pick. */
function agentId() {
const value = $("#c-agent").value;
return value ? Number(value) : null;
}
async function loadAgents() {
agents = (await api("/api/agents")).sort((a, b) => a.id - b.id);
const select = $("#c-agent");
select.replaceChildren();
for (const a of agents) {
const option = document.createElement("option");
option.value = String(a.id);
option.textContent = a.name;
select.appendChild(option);
}
const first = agents.find((a) => a.enabled) || agents[0];
if (first) select.value = String(first.id);
select.closest("label").hidden = !first;
$("#c-no-agent").hidden = Boolean(first);
}
// ---------------------------------------------------------------- the list
/** "30 Sep", or "30 Sep 2025" when it is not this year. A day alone
("2026-09-30") is read as local midnight, not UTC's. */
function checkedOn(iso) {
const text = String(iso || "");
const at = new Date(text.length === 10 ? `${text}T00:00` : text);
if (Number.isNaN(at.getTime())) return "";
const options = { day: "numeric", month: "short" };
if (at.getFullYear() !== new Date().getFullYear()) options.year = "numeric";
return at.toLocaleDateString("en-GB", options);
}
/** The row's Recheck: size the board again, which may change what it is
asked for, and read it with the pull that follows. */
function recheckButton(company, rerender) {
const button = document.createElement("button");
button.type = "button";
button.className = "linky";
button.textContent = "Recheck";
button.title = "Count the board's roles again";
button.addEventListener("click", async () => {
button.disabled = true;
try {
const result = await api(`/api/sources/${company.subscription_id}/size`,
{ method: "POST" });
window.toast.info(`${company.name}: ${count(result.size, "role")}, `
+ `reads ${result.reach}. Reading now, or with the pull right after.`);
await loadCompanies(agentId());
rerender();
} catch (err) {
button.disabled = false;
}
});
return button;
}
/** What a limit word means, from the title of its option in the filter
select ("without text: 12" is looked up as "without text"). */
function limitMeaning(word) {
const phrase = word.split(":")[0];
const option = [...$("#c-filter").options].find((o) => o.value === phrase);
return option && option.title ? `${word}: ${option.title}` : "";
}
function subLine(company, rerender) {
const sub = document.createElement("span");
sub.className = "sub";
if (company.board) {
const badge = document.createElement("span");
badge.className = "badge";
badge.textContent = company.board;
sub.appendChild(badge);
} else if (company.ats || company.careers_url) {
// Followed, but its careers site runs on nothing the app reads yet.
const badge = document.createElement("span");
badge.className = "badge";
badge.textContent = company.ats
? (company.ats_slug ? `${company.ats}:${company.ats_slug}` : company.ats)
: "own site";
sub.appendChild(badge);
sub.append(" · not readable yet");
} else if (company.from_search) {
// Nobody followed it: its roles came from a search, and it was judged.
sub.append("from job boards");
} else {
// Followed by the seed, Follow or discover, and none of them found
// where this company posts its roles.
sub.append("board not found");
}
const careersUrl = safeUrl(company.careers_url);
if (careersUrl && !company.board) {
const link = document.createElement("a");
link.href = careersUrl;
link.target = "_blank";
link.rel = "noopener";
link.textContent = "careers page";
sub.append(" · ");
sub.appendChild(link);
}
sub.append(` · ${count(company.open_roles, "open role")}`);
// open_roles also counts what a search listed; say so when the board's own differ.
if (company.board_open != null && company.board_open !== company.open_roles) {
sub.append(` (${company.board_open} on this board)`);
}
if (company.reach) sub.append(` · reads ${company.reach}`);
if (company.size != null) {
const checked = checkedOn(company.size_checked);
sub.append(` · ${count(company.size, "role")}${checked ? ` · checked ${checked}` : ""}`);
}
const words = (company.limits || []).filter((w) => w !== "failing");
if (words.length) {
// What limits the read (app/jobs/limits.py). The failing word is the
// line after this one; only the filter needs it as a word.
const limits = document.createElement("span");
limits.className = "limits";
limits.append(words.join(" · "));
limits.title = words.map(limitMeaning).filter(Boolean).join("\n");
sub.append(" · ");
sub.appendChild(limits);
}
if (company.failing_since) {
// The board has failed on every pull since then; after 21 days its
// roles close.
const failing = document.createElement("span");
failing.className = "failing";
failing.textContent = `not answering since ${company.failing_since.slice(0, 10)}`
+ (company.failing_reason ? `: ${company.failing_reason}` : "");
sub.append(" · ");
sub.appendChild(failing);
}
sub.append(" ");
if (company.subscription_id != null) {
sub.appendChild(recheckButton(company, rerender));
sub.append(" ");
}
const edit = document.createElement("button");
edit.type = "button";
edit.className = "linky";
edit.textContent = company.subscription_id == null ? "Set board" : "Change";
edit.setAttribute("aria-expanded", String(editing === company.key));
edit.addEventListener("click", () => {
editing = editing === company.key ? null : company.key;
rerender();
});
sub.appendChild(edit);
return sub;
}
/** The open row's board editor: host and slug, Save, Cancel, and Detach
for a row that has a board. */
function boardEditor(company, rerender) {
const form = document.createElement("form");
form.className = "board-edit";
form.autocomplete = "off";
const host = document.createElement("select");
host.setAttribute("aria-label", `${company.name}'s board host`);
for (const option of $("#b-host").options) host.appendChild(option.cloneNode(true));
const known = [...host.options].map((o) => o.value);
const current = company.board || company.ats;
if (known.includes(current)) host.value = current;
const slug = document.createElement("input");
slug.type = "text";
slug.required = true;
slug.spellcheck = false;
slug.placeholder = "slug";
slug.value = company.ats_slug || "";
slug.setAttribute("aria-label", `${company.name}'s slug on that host`);
const save = document.createElement("button");
save.type = "submit";
save.textContent = company.subscription_id == null ? "Set board" : "Change board";
const cancel = document.createElement("button");
cancel.type = "button";
cancel.className = "linky";
cancel.textContent = "Cancel";
cancel.addEventListener("click", () => { editing = null; rerender(); });
form.append(host, slug, save, cancel);
async function done() {
editing = null;
await loadCompanies(agentId());
rerender();
}
form.addEventListener("submit", async (event) => {
event.preventDefault();
const board = `${host.value}:${slug.value.trim()}`;
// Replacing a different board closes its roles (see set_board in
// app/jobs/sources.py); ask first, naming both boards and the count,
// the same as Detach and a removed search already do.
if (company.target && company.target !== board
&& !window.confirm(`Replace ${company.name}'s board (${company.target}) `
+ `with ${board}? Its ${count(company.open_roles, "open role")} close.`)) {
return;
}
save.disabled = true;
try {
const result = await api(`/api/companies/${encodeURIComponent(company.key)}/board`,
{ method: "POST", body: { board } });
const closed = result.closed ? `, ${count(result.closed, "old role")} closed` : "";
window.toast.info(`${company.name}: ${result.source.target} listed `
+ `${count(result.found, "role")}${closed}. Reading now, or with the pull right after.`);
await done();
} catch (err) {
save.disabled = false;
}
});
if (company.subscription_id != null) {
const detach = document.createElement("button");
detach.type = "button";
detach.className = "linky";
detach.textContent = "Detach";
detach.addEventListener("click", async () => {
if (company.open_roles
&& !window.confirm(`Detach ${company.name}'s board (${company.board})? `
+ `Its ${count(company.open_roles, "open role")} close.`)) {
return;
}
detach.disabled = true;
try {
const result = await api(`/api/companies/${encodeURIComponent(company.key)}/board`,
{ method: "DELETE" });
window.toast.info(`${company.name}: board detached, `
+ `${count(result.closed, "open role")} closed.`);
await done();
} catch (err) {
detach.disabled = false;
}
});
form.append(detach);
}
return form;
}
/** The open row's reach editor, for a row with a board: the agents' reach
or the board's own countries and remote. The editor points to the
company's two overrides, which are set beside the stars. */
function reachEditor(company, rerender) {
if (company.subscription_id == null) return null;
const own = company.reach_params || {};
const form = document.createElement("form");
form.className = "board-edit";
form.autocomplete = "off";
const mode = document.createElement("select");
mode.setAttribute("aria-label", `What ${company.name}'s board is asked for`);
for (const [value, label] of [["agents", "Agents' reach"], ["own", "These countries"]]) {
mode.appendChild(new Option(label, value));
}
mode.value = own.countries || own.remote != null ? "own" : "agents";
const codes = document.createElement("input");
codes.type = "text";
codes.spellcheck = false;
codes.placeholder = "DK SE";
codes.value = (own.countries || []).join(" ");
codes.setAttribute("aria-label", "Country codes");
const remote = document.createElement("select");
remote.setAttribute("aria-label", "Remote roles");
remote.append(new Option("and remote", "yes"), new Option("no remote", "no"));
remote.value = own.remote ? "yes" : "no";
const save = document.createElement("button");
save.type = "submit";
save.textContent = "Set reach";
const shown = () => { codes.hidden = remote.hidden = mode.value !== "own"; };
mode.addEventListener("change", shown);
shown();
const note = document.createElement("span");
note.className = "muted small";
note.textContent = [
company.all_countries
? "All locations is on: roles are fetched and kept from the whole world gate, and countries set here win over it."
: "All locations, beside the stars, fetches and keeps this company's roles from the whole world gate (Europe, say), not only the agents' locations.",
company.all_roles
? "All roles is on: no fetch terms and no titles to leave out."
: "All roles drops the fetch terms and the titles to leave out.",
"Turning either on or off rescores.",
].join(" ");
form.append(mode, codes, remote, save, note);
form.addEventListener("submit", async (event) => {
event.preventDefault();
save.disabled = true;
try {
const result = await api(`/api/sources/${company.subscription_id}/reach`, {
method: "POST",
body: { mode: mode.value, countries: codes.value.split(/[\s,]+/).filter(Boolean),
remote: remote.value === "yes" },
});
window.toast.info(`${company.name}: reads ${result.reach} from the next pull.`);
editing = null;
await loadCompanies(agentId());
rerender();
} catch (err) {
save.disabled = false;
}
});
return form;
}
/** The board switch, or nothing for a company with no board:
there is no subscription to switch. */
function onSwitch(company, rerender) {
if (company.subscription_id == null) return null;
const box = document.createElement("input");
box.type = "checkbox";
box.checked = Boolean(company.on);
box.setAttribute("aria-label", `Read ${company.name}'s board`);
box.addEventListener("change", async () => {
// Switching off closes every open role in one tap; ask first, naming
// the count, as removing a search and deleting an agent already do.
if (!box.checked && company.open_roles
&& !window.confirm(`Switch off ${company.name}'s board? `
+ `Its ${count(company.open_roles, "open role")} close.`)) {
box.checked = true;
return;
}
box.disabled = true;
try {
const result = await api(`/api/sources/${company.subscription_id}/switch`,
{ method: "POST", body: { on: box.checked } });
company.on = result.source.on;
if (!box.checked && result.closed) {
window.toast.info(`${company.name}: ${count(result.closed, "open role")} closed.`);
} else if (box.checked) {
window.toast.info(`${company.name}: reading now, or with the pull right after.`);
}
} catch (err) {
box.checked = !box.checked;
}
box.disabled = false;
rerender();
});
return box;
}
function matchesFilter(company, filter) {
switch (filter) {
case "favourite": return company.affinity === 2;
case "liked": return company.affinity === 1;
case "hidden": return company.affinity === -1;
case "all_countries": return company.all_countries === true;
case "all_roles": return company.all_roles === true;
case "on": return company.on === true;
case "off": return company.on === false;
case "unreadable": return company.subscription_id == null && !company.from_search;
case "": return true;
// A limit (app/jobs/limits.py): the word up to its colon, which may carry a number.
default: return (company.limits || []).some((word) => word.startsWith(filter));
}
}
function render() {
const q = $("#c-q").value.trim().toLowerCase();
const filter = $("#c-filter").value;
const rows = [...companies.values()]
.filter((c) => !q || c.name.toLowerCase().includes(q) || c.board.includes(q)
|| (c.ats || "").includes(q) || (c.country || "").toLowerCase() === q)
.filter((c) => matchesFilter(c, filter))
.sort((a, b) => b.open_roles - a.open_roles || a.name.localeCompare(b.name));
const body = $("#companies-list");
body.replaceChildren();
for (const company of rows) {
const row = document.createElement("div");
row.className = "crow";
if (company.affinity === -1) row.dataset.hidden = "true";
// By key, as the feed's own company links are, so the Roles page opens
// the company view with its strip and gate note. A name would be a
// substring there, which also lists other companies whose names hold it
// and misses roles spelt otherwise.
const link = document.createElement("a");
link.className = "name";
link.href = `/?company_keys=${encodeURIComponent(company.key)}`;
link.title = "This company's open roles";
link.textContent = company.name;
row.appendChild(link);
const switchBox = onSwitch(company, render);
if (switchBox) row.appendChild(switchBox);
const agent = agentId();
if (agent != null) {
row.appendChild(affinityControl(company.key, company.affinity, async () => render(), agent));
}
row.appendChild(overridesControl(company.key, company, async () => {
await loadCompanies(agentId());
render();
}));
row.appendChild(subLine(company, render));
if (editing === company.key) {
row.appendChild(boardEditor(company, render));
const reach = reachEditor(company, render);
if (reach) row.appendChild(reach);
}
body.appendChild(row);
}
const open = rows.reduce((sum, c) => sum + c.open_roles, 0);
$("#companies-count").textContent =
`${count(rows.length, "company", "companies")}, ${count(open, "open role")}`;
}
// -------------------------------------------------------------------- follow
async function addBoard(event) {
event.preventDefault();
const status = $("#board-status");
const button = $("#board-form button[type=submit]");
const name = $("#b-name").value.trim();
const board = `${$("#b-host").value}:${$("#b-slug").value.trim()}`;
// This name may already be a company with a different board: `set_board`
// would replace it and close its roles, the same as the row's own
// editor does, so it asks first too.
const existing = [...companies.values()]
.find((c) => c.name.toLowerCase() === name.toLowerCase());
if (existing && existing.target && existing.target !== board
&& !window.confirm(`Replace ${existing.name}'s board (${existing.target}) `
+ `with ${board}? Its ${count(existing.open_roles, "open role")} close.`)) {
return;
}
button.disabled = true;
status.textContent = "Reading the board once before following it…";
try {
const result = await api("/api/boards", {
method: "POST",
body: { board, name },
});
await loadCompanies(agentId());
render();
$("#board-form").reset();
status.textContent = `Following ${result.source.label}: `
+ `${count(result.found, "role")} listed. Reading now, or with the pull right after.`;
} catch (err) {
status.textContent = "";
}
button.disabled = false;
}
// -------------------------------------------------------------------- init
async function switchAgent() {
try {
await loadCompanies(agentId());
} catch (err) {
return;
}
render();
}
document.addEventListener("DOMContentLoaded", async () => {
if (!$("#companies-list")) return;
try {
await loadAgents();
await loadCompanies(agentId());
} catch (err) {
return;
}
render();
$("#c-q").addEventListener("input", debounce(render, 150));
$("#c-filter").addEventListener("change", render);
$("#c-agent").addEventListener("change", switchAgent);
$("#board-form").addEventListener("submit", addBoard);
});
})();