wehub-resource-sync
84 lines
2.8 KiB
JavaScript
84 lines
2.8 KiB
JavaScript
// @ts-check
|
|
/** @typedef {import('./_types.js').Provider} Provider */
|
|
|
|
// Jobicy provider — board-wide remote-jobs aggregator feed
|
|
// (https://jobicy.com/api/v2/remote-jobs?count=50). Returns { jobs: [...] }.
|
|
//
|
|
// Wire in via a `job_boards:` entry with `provider: jobicy`.
|
|
|
|
const FEED_URL = 'https://jobicy.com/api/v2/remote-jobs?count=50';
|
|
|
|
/** @type {Provider} */
|
|
export default {
|
|
id: 'jobicy',
|
|
|
|
detect(entry) {
|
|
return entry?.provider === 'jobicy' ? { url: FEED_URL } : null;
|
|
},
|
|
|
|
/**
|
|
* Fetches and normalizes postings from the Jobicy public feed.
|
|
* @param {{ name?: string }} entry - The job_boards entry being processed.
|
|
* @param {{ fetchJson: (url: string, opts?: { redirect?: 'error'|'follow'|'manual' }) => Promise<any> }} ctx - HTTP context.
|
|
* @returns {Promise<Array<{title: string, url: string, company: string, location: string, postedAt?: number}>>}
|
|
*/
|
|
async fetch(entry, ctx) {
|
|
// redirect:'error' prevents SSRF via server-side redirects
|
|
const json = await ctx.fetchJson(FEED_URL, { redirect: 'error' });
|
|
if (!json || !Array.isArray(json.jobs)) {
|
|
throw new Error(`jobicy: unexpected API response — expected { jobs: [...] }, got keys: [${json ? Object.keys(json).join(', ') : 'null'}]`);
|
|
}
|
|
|
|
return parseJobicyResponse(json, entry.name || 'Jobicy');
|
|
},
|
|
};
|
|
|
|
/**
|
|
* Parse a Jobicy API response. Exported for unit tests.
|
|
*
|
|
* @param {any} json - Raw response payload.
|
|
* @param {string} defaultCompany - Fallback company name.
|
|
* @returns {Array<{title: string, url: string, company: string, location: string}>}
|
|
*/
|
|
export function parseJobicyResponse(json, defaultCompany = 'Jobicy') {
|
|
if (!json || !Array.isArray(json.jobs)) return [];
|
|
|
|
const toEpochMs = (value) => {
|
|
if (!value) return undefined;
|
|
const parsed = Date.parse(value);
|
|
return Number.isNaN(parsed) ? undefined : parsed;
|
|
};
|
|
|
|
return json.jobs
|
|
.map(j => {
|
|
if (!j || typeof j !== 'object') return null;
|
|
|
|
const title = typeof j.jobTitle === 'string' ? j.jobTitle.trim() : '';
|
|
if (!title) return null;
|
|
|
|
const rawUrl = typeof j.url === 'string' ? j.url.trim() : '';
|
|
let url = null;
|
|
try {
|
|
const parsed = new URL(rawUrl);
|
|
if (parsed.protocol === 'https:' && (parsed.hostname === 'jobicy.com' || parsed.hostname === 'www.jobicy.com')) {
|
|
url = parsed.href;
|
|
}
|
|
} catch {
|
|
// Invalid or malformed URL
|
|
}
|
|
if (!url) return null;
|
|
|
|
const company = typeof j.companyName === 'string' && j.companyName.trim() ? j.companyName.trim() : defaultCompany;
|
|
const location = typeof j.jobGeo === 'string' ? j.jobGeo.trim() : '';
|
|
const postedAt = toEpochMs(j.pubDate);
|
|
|
|
return {
|
|
title,
|
|
url,
|
|
company,
|
|
location,
|
|
postedAt,
|
|
};
|
|
})
|
|
.filter(j => j !== null);
|
|
} |