Something went wrong. Try again.
* monkey userscripts for throwing bananas around the web — {violentmonkey,greasemonkey,tampermonkey}
Something went wrong. Try again.
123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481// ==UserScript==// @name userscripts loader// @namespace https://github.com/mcint/userscripts// @version 0.1.0// @description Load other userscripts from GitHub: curated registry + freeform, per-domain auto-load, SRI integrity.// @match *://*/*// @run-at document-start// @grant GM_xmlhttpRequest// @grant GM_setValue// @grant GM_getValue// @grant GM_registerMenuCommand// @grant unsafeWindow// @connect cdn.jsdelivr.net// @connect raw.githubusercontent.com// @downloadURL https://cdn.jsdelivr.net/gh/mcint/userscripts@main/tampermonkey/loader.user.js// @updateURL https://cdn.jsdelivr.net/gh/mcint/userscripts@main/tampermonkey/build/loader.meta.js// ==/UserScript=='use strict';
// ---- config statics (edit in place) -------------------------------------const REQUIRE_SRI = false;const DEFAULT_OWNER = 'mcint';const CDN_BASE = 'https://cdn.jsdelivr.net/gh';const REGISTRY_URL = 'https://cdn.jsdelivr.net/gh/mcint/userscripts@main/tampermonkey/registry.json';const REGISTRY_TTL_MS = 12 * 60 * 60 * 1000;
// ---- pure helpers -------------------------------------------------------
function effectiveActive(scopes) { return !!(scopes && (scopes.tab || scopes.session || scopes.site));}
function activationKey(id) { return 'us-loader:act:' + id; }
function readScopes(id, stores) { const key = activationKey(id); const on = (s) => !!(s && s.getItem(key) === '1'); return { tab: on(stores.tab), session: false, site: on(stores.site) };}
function writeScope(id, scope, on, stores) { if (scope === 'session') { return; } // v0: lever stubbed (see decision D6) const store = scope === 'tab' ? stores.tab : scope === 'site' ? stores.site : null; if (!store) { return; } const key = activationKey(id); if (on) { store.setItem(key, '1'); } else { store.removeItem(key); }}
function deriveStatus(rt) { if (rt && rt.error) { return 'error'; } if (rt && rt.warning) { return 'warning'; } if (rt && rt.loaded) { return 'active'; } return 'inactive';}
function statusGlyph(status) { switch (status) { case 'active': return { symbol: '●', cls: 'us-st-active' }; case 'error': return { symbol: '●', cls: 'us-st-error' }; case 'warning': return { symbol: '●', cls: 'us-st-warning' }; default: return { symbol: '○', cls: 'us-st-inactive' }; }}
// ---- legacy section label -----------------------------------------------
function buildCdnUrl({ repo, ref, path }) { const p = String(path).replace(/^\/+/, ''); return `${CDN_BASE}/${repo}@${ref}/${p}`;}
function entryCdnUrl(entry) { return buildCdnUrl({ repo: entry.repo, ref: entry.ref || 'main', path: entry.path });}
function parseFreeform(input, defaults) { const d = defaults || { owner: DEFAULT_OWNER, ref: 'main' }; const raw = String(input).trim();
// URL form if (/^https?:\/\//i.test(raw)) { const hashIdx = raw.indexOf('#'); const url = hashIdx >= 0 ? raw.slice(0, hashIdx) : raw; const integrity = hashIdx >= 0 ? normalizeIntegrity(raw.slice(hashIdx + 1)) : null; return { kind: 'url', url, integrity }; }
// shorthand: owner/repo/path[@ref] or repo/path[@ref] — must look path-like, single line const oneLine = !/[\r\n]/.test(raw); const slashParts = raw.split('/'); if (oneLine && slashParts.length >= 2 && !/[(){};=]/.test(slashParts[0])) { let ref = d.ref; let body = raw; const at = raw.lastIndexOf('@'); if (at > 0) { ref = raw.slice(at + 1); body = raw.slice(0, at); } const parts = body.split('/'); let owner, rest; // heuristic: if first segment looks like a known owner repo pair, keep 2 as repo // need >= 4 parts (owner/repo/dir/file) to confidently infer the owner from input if (parts.length >= 4 && !/\./.test(parts[0]) && !/\./.test(parts[1])) { owner = parts[0]; rest = parts.slice(1); } else { owner = d.owner; rest = parts; } const repoName = rest.shift(); const path = rest.join('/'); if (repoName && path) { return { kind: 'ref', repo: `${owner}/${repoName}`, path, ref, integrity: null }; } }
// otherwise: a pasted snippet return { kind: 'snippet', snippet: raw };}
function _subtle() { if (typeof globalThis !== 'undefined' && globalThis.crypto && globalThis.crypto.subtle) { return globalThis.crypto.subtle; } if (typeof require !== 'undefined') { return require('crypto').webcrypto.subtle; } throw new Error('WebCrypto unavailable');}
function _toB64(buf) { const a = new Uint8Array(buf); if (typeof Buffer !== 'undefined') { return Buffer.from(a).toString('base64'); } let s = ''; for (let i = 0; i < a.length; i++) { s += String.fromCharCode(a[i]); } return btoa(s);}
function _toHex(buf) { const a = new Uint8Array(buf); let s = ''; for (let i = 0; i < a.length; i++) { s += a[i].toString(16).padStart(2, '0'); } return s;}
const _ALGO = { sha256: 'SHA-256', sha384: 'SHA-384', sha512: 'SHA-512' };
async function computeSriToken(bytes, algo) { const buf = await _subtle().digest(_ALGO[algo], bytes); return `${algo}-${_toB64(buf)}`;}
async function verifyIntegrity(bytes, token) { const norm = normalizeIntegrity(token); if (!norm) { return false; } const hex = norm.endsWith('-hex'); const core = hex ? norm.slice(0, -4) : norm; const algo = core.slice(0, core.indexOf('-')); const expected = core.slice(algo.length + 1); const buf = await _subtle().digest(_ALGO[algo], bytes); const actual = hex ? _toHex(buf) : _toB64(buf); return actual === expected;}
function normalizeIntegrity(s) { if (!s) { return null; } const v = String(s).trim().replace(/^#/, ''); let m = v.match(/^(sha256|sha384|sha512)-(.+)$/); if (m) { return `${m[1]}-${m[2]}`; } m = v.match(/^(sha256|sha384|sha512)=([0-9a-fA-F]+)$/); if (m) { return `${m[1]}-${m[2].toLowerCase()}-hex`; } return null;}
function _matchOne(pattern, url) { const m = pattern.match(/^([^:]+):\/\/([^/]*)(\/.*)$/); if (!m) { return false; } const [, scheme, host, path] = m; const u = url.match(/^([^:]+):\/\/([^/]*)(\/.*)?$/); if (!u) { return false; } const [, uScheme, uHost, uPath = '/'] = u;
if (scheme === '*') { if (uScheme !== 'http' && uScheme !== 'https') { return false; } } else if (scheme !== uScheme) { return false; }
const hostRe = new RegExp('^' + host.split('*').map(_esc).join('.*') + '$'); if (!hostRe.test(uHost)) { return false; }
const pathRe = new RegExp('^' + path.split('*').map(_esc).join('.*') + '$'); return pathRe.test(uPath);}
function _esc(s) { return s.replace(/[.+?^${}()|[\]\\]/g, '\\$&'); }
function matchUrl(patterns, url) { if (!Array.isArray(patterns)) { return false; } return patterns.some((p) => _matchOne(p, url));}
function parseRegistry(text) { const data = JSON.parse(text); if (!Array.isArray(data)) { throw new Error('registry must be a JSON array'); } return data;}
function validateEntry(entry) { const errors = []; if (!entry.id) { errors.push('missing id'); } if (!entry.name) { errors.push('missing name'); } if (!entry.repo || !/^[^/]+\/[^/]+$/.test(entry.repo)) { errors.push('repo must be owner/name'); } if (!entry.path) { errors.push('missing path'); } if (entry.integrity != null && normalizeIntegrity(entry.integrity) == null) { errors.push('integrity must be an SRI token'); } return { ok: errors.length === 0, errors };}
// ---- persistence: pure state fns ----------------------------------------
function emptyState() { return { enabled: {}, recents: [] }; }
function applyEnabled(state, id, on) { return { ...state, enabled: { ...state.enabled, [id]: !!on } };}
function isEnabled(state, entry, defaultOn) { return Object.prototype.hasOwnProperty.call(state.enabled, entry.id) ? state.enabled[entry.id] : !!defaultOn;}
function pushRecent(state, item, cap) { const recents = [item, ...state.recents.filter((x) => x !== item)].slice(0, cap); return { ...state, recents };}
// ---- impure helpers (GM/DOM — only called from main) --------------------
const STATE_KEY = 'loaderState';function loadState() { try { return Object.assign(emptyState(), JSON.parse(GM_getValue(STATE_KEY, '{}'))); } catch (_e) { return emptyState(); }}function saveState(state) { GM_setValue(STATE_KEY, JSON.stringify(state)); }
function gmFetchText(url) { return new Promise((resolve, reject) => { GM_xmlhttpRequest({ method: 'GET', url, onload: (r) => (r.status >= 200 && r.status < 300) ? resolve(r.responseText) : reject(new Error(`HTTP ${r.status} for ${url}`)), onerror: () => reject(new Error(`network error for ${url}`)), }); });}
function executeText(text, label) { const el = document.createElement('script'); el.textContent = `// userscripts-loader: ${label}\n${text}`; (document.head || document.documentElement).appendChild(el); el.remove();}
// source: {kind, ...} from parseFreeform OR a registry entry coerced to {kind:'ref',...}async function loadSource(source, opts) { const requireSri = REQUIRE_SRI || (opts && opts.requireSri); let text, integrity, label; if (source.kind === 'snippet') { text = source.snippet; integrity = null; label = 'snippet'; } else { const url = source.kind === 'url' ? source.url : buildCdnUrl({ repo: source.repo, ref: source.ref || 'main', path: source.path }); label = url; text = await gmFetchText(url); integrity = source.integrity || (source.entry && source.entry.integrity) || null; } if (integrity) { const ok = await verifyIntegrity(new TextEncoder().encode(text), integrity); if (!ok) { throw new Error(`integrity mismatch: ${label}`); } } else if (requireSri) { throw new Error(`integrity required but absent: ${label}`); } executeText(text, label);}
// ---- registry + auto-load ------------------------------------------------
function entriesToAutoLoad(entries, state, url) { return entries.filter((e) => { const defaultOn = matchUrl(e.match || [], url); return defaultOn && isEnabled(state, e, true); });}
// embedded registry: present when build.sh has run (Task 15); else null.const EMBEDDED_REGISTRY = (typeof EMBEDDED_REGISTRY_JSON !== 'undefined') ? EMBEDDED_REGISTRY_JSON : null;
async function getRegistry() { const state = loadState(); const cache = state.registryCache; const fresh = cache && (Date.now() - cache.fetchedAt) < REGISTRY_TTL_MS; if (fresh) { return cache.entries; } try { const text = await gmFetchText(REGISTRY_URL); const entries = parseRegistry(text); saveState({ ...state, registryCache: { fetchedAt: Date.now(), entries } }); return entries; } catch (_e) { if (cache) { return cache.entries; } return EMBEDDED_REGISTRY || []; }}
async function hashInput(input) { const src = parseFreeform(input, { owner: DEFAULT_OWNER, ref: 'main' }); const text = src.kind === 'snippet' ? src.snippet : await gmFetchText(src.kind === 'url' ? src.url : buildCdnUrl({ repo: src.repo, ref: src.ref || 'main', path: src.path })); return computeSriToken(new TextEncoder().encode(text), 'sha384');}
// ---- storage binding + activation API (browser-only; called from main) --
function browserStores() { return { tab: (typeof sessionStorage !== 'undefined' ? sessionStorage : null), site: (typeof localStorage !== 'undefined' ? localStorage : null) };}
// runtime status of loaded scripts this page (id -> {loaded,error,warning})const _runtime = {};
function scriptStatus(id) { return deriveStatus(_runtime[id] || {}); }
async function activateScript(id, scope, entries) { writeScope(id, scope || 'site', true, browserStores()); const e = entries.find((x) => x.id === id); if (!e) { _runtime[id] = { error: true }; return; } try { await loadSource({ kind: 'ref', repo: e.repo, ref: e.ref || 'main', path: e.path, entry: e }); _runtime[id] = { loaded: true }; } catch (err) { _runtime[id] = { error: true }; throw err; }}
function deactivateScript(id) { const stores = browserStores(); writeScope(id, 'tab', false, stores); writeScope(id, 'site', false, stores); _runtime[id] = { loaded: false };}
// ---- dock DOM + styles (browser-only; called from main after DOM ready) -
function injectDockStyles() { if (document.getElementById('us-dock-style')) { return; } const css = ` #us-dock{position:fixed;right:14px;bottom:14px;z-index:2147483647;font:13px/1.4 sans-serif} #us-dock .us-orb{width:26px;height:26px;border-radius:50%;background:#222;color:#fff;display:flex; align-items:center;justify-content:center;cursor:pointer;box-shadow:0 1px 6px rgba(0,0,0,.4)} #us-dock .us-panel{display:none;background:#fff;color:#111;border:1px solid #999;border-radius:6px; padding:8px;min-width:240px;box-shadow:0 2px 12px rgba(0,0,0,.3)} #us-dock:hover .us-panel{display:block} #us-dock:hover .us-orb{display:none} #us-dock.us-collapsed:hover .us-panel{display:none} #us-dock.us-collapsed:hover .us-orb{display:flex} #us-dock .us-row{display:flex;align-items:center;gap:6px;margin:3px 0} #us-dock button{font:12px sans-serif;cursor:pointer} #us-dock button[disabled]{opacity:.45;cursor:default} .us-st-inactive{color:#999}.us-st-active{color:#1a7f37}.us-st-error{color:#cf222e}.us-st-warning{color:#bf8700}`; const el = document.createElement('style'); el.id = 'us-dock-style'; el.textContent = css; (document.head || document.documentElement).appendChild(el);}
function renderDock(entries) { injectDockStyles(); let dock = document.getElementById('us-dock'); if (dock) { dock.remove(); } dock = document.createElement('div'); dock.id = 'us-dock';
const orb = document.createElement('div'); orb.className = 'us-orb'; orb.textContent = '⚙'; // ⚙ orb.title = 'userscripts'; const panel = document.createElement('div'); panel.className = 'us-panel';
const head = document.createElement('div'); head.style.cssText = 'display:flex;justify-content:space-between;align-items:center;margin-bottom:4px'; const title = document.createElement('strong'); title.textContent = 'userscripts'; const close = document.createElement('button'); close.textContent = '×'; // × // Collapse via a class (not inline display) so the CSS :hover affordance still // re-expands later; clear the class on mouseleave so the next hover works. close.title = 'collapse'; close.onclick = () => { dock.classList.add('us-collapsed'); dock.addEventListener('mouseleave', () => dock.classList.remove('us-collapsed'), { once: true }); }; head.append(title, close); panel.append(head);
const stores = browserStores(); for (const e of entries) { const scopes = readScopes(e.id, stores); const st = deriveStatus(_runtime[e.id] || (effectiveActive(scopes) ? { loaded: true } : {})); const g = statusGlyph(st); const row = document.createElement('div'); row.className = 'us-row'; const dot = document.createElement('span'); dot.className = g.cls; dot.textContent = g.symbol; const name = document.createElement('span'); name.textContent = e.name; name.style.flex = '1'; row.append(dot, name); for (const scope of ['tab', 'session', 'site']) { const b = document.createElement('button'); b.textContent = scope; if (scope === 'session') { b.disabled = true; b.title = 'soon'; } else { if (scopes[scope]) { b.style.fontWeight = 'bold'; } b.onclick = () => { const cur = readScopes(e.id, stores)[scope]; if (cur) { writeScope(e.id, scope, false, stores); } else { activateScript(e.id, scope, entries).catch((err) => console.error('[loader]', err)); } renderDock(entries); }; } row.append(b); } panel.append(row); } dock.append(orb, panel); document.body.appendChild(dock);}
// ---- main (browser only) ------------------------------------------------function main() { const PUBLIC = (typeof unsafeWindow !== 'undefined' ? unsafeWindow : window); // hydrate early (document-start): object exists + is detectable; costs deferred let _entries = null; const ensure = () => getRegistry().then((e) => (_entries = e)); PUBLIC.usLoader = { list: () => (_entries ? _entries.map((e) => ({ id: e.id, name: e.name, repo: e.repo, path: e.path })) : ensure().then(() => PUBLIC.usLoader.list())), load: (input, opts) => loadSource(parseFreeform(input, { owner: DEFAULT_OWNER, ref: 'main' }), opts), loadEntry: (id) => ensure().then((e) => activateScript(id, 'tab', e)), activate: (id, opts) => ensure().then((e) => activateScript(id, (opts && opts.scope) || 'site', e)), deactivate: (id) => { deactivateScript(id); return true; }, status: (id) => scriptStatus(id), hashIt: (input) => hashInput(input), };
const start = async () => { const entries = await ensure(); const stores = browserStores(); // auto-load: URL match OR a saved activation (tab/site) for (const e of entries) { const saved = effectiveActive(readScopes(e.id, stores)); if (saved || (matchUrl(e.match || [], location.href) && isEnabled(loadState(), e, true))) { activateScript(e.id, saved ? 'tab' : 'site', entries).catch((err) => console.error('[loader]', e.id, err)); } } renderDock(entries); GM_registerMenuCommand('usLoader: open dock', () => { const p = document.querySelector('#us-dock .us-panel'); if (p) { p.style.display = 'block'; } }); GM_registerMenuCommand('usLoader: list in console', () => console.table(PUBLIC.usLoader.list())); GM_registerMenuCommand('usLoader: hash input', async () => { const v = prompt('owner/repo/path@ref or URL to hash'); if (v) { prompt('SRI token:', await PUBLIC.usLoader.hashIt(v)); } }); }; if (document.readyState === 'complete' || document.readyState === 'interactive') { start(); } else { window.addEventListener('DOMContentLoaded', start); }}
// ---- export tail: Node tests require() this; browser runs main() --------if (typeof module !== 'undefined' && module.exports) { module.exports = { REQUIRE_SRI, DEFAULT_OWNER, CDN_BASE, buildCdnUrl, entryCdnUrl, parseFreeform, normalizeIntegrity, computeSriToken, verifyIntegrity, parseRegistry, validateEntry, matchUrl, emptyState, applyEnabled, isEnabled, pushRecent, entriesToAutoLoad, effectiveActive, activationKey, readScopes, writeScope, deriveStatus, statusGlyph, };} else { main();}