feat(media-hosting): add multi-provider configurable upload with fallback

Add Random/Preferred/None modes, preferred provider selection, and provider-order fallback. Catbox/Imgur/PostImages on Android via WebView; Electron CDP automation for Imgur/PostImages. Hide upload controls on web runtime.
2026-08-03 07:41:04 +02:00 · 2026-02-18 18:51:02 +08:00
parent 72b70915fd
commit 96a4aaec0e
63 changed files with 1991 additions and 201 deletions
@@ -0,0 +1,52 @@
+/**
+ * Provider-specific recipes for automated media upload via hidden BrowserWindow.
+ * Each recipe defines selectors and behavior for DOM-based upload flows.
+ * Selectors are candidate-based: try each until one matches. Fail fast on blocked indicators.
+ *
+ * @typedef {Object} ProviderRecipe
+ * @property {string} uploadUrl - Full URL of the provider's upload page
+ * @property {readonly string[]} fileInputSelectorCandidates - CSS selectors for file input (first match wins)
+ * @property {readonly string[]} submitSelectorCandidates - CSS selectors for submit/upload button
+ * @property {Object} successExtractor - How to extract the result URL from the page
+ * @property {readonly string[]} successExtractor.selectorCandidates - Selectors for element containing result URL
+ * @property {'href'|'src'|'value'|'text'} successExtractor.attribute - Attribute or 'text' for textContent
+ * @property {readonly string[]} blockedIndicators - Selectors that indicate captcha/login/challenge (fail immediately if present)
+ * @property {number} timeoutMs - Max time to wait for upload completion
+ */
+
+/** @type {Readonly<Record<string, ProviderRecipe>>} */
+export const MEDIA_UPLOAD_RECIPES = Object.freeze({
+  catbox: Object.freeze({
+    uploadUrl: 'https://catbox.moe',
+    fileInputSelectorCandidates: Object.freeze(['input[type="file"]', 'input[type=file]']),
+    submitSelectorCandidates: Object.freeze(['button[type="submit"]', 'input[type="submit"]', '[type="submit"]']),
+    successExtractor: Object.freeze({
+      selectorCandidates: Object.freeze(['a[href*="files.catbox.moe"]', 'input[value*="files.catbox.moe"]', '[class*="result"] a', 'textarea']),
+      attribute: 'href',
+    }),
+    blockedIndicators: Object.freeze(['#challenge', '.captcha', '[data-captcha]', '.g-recaptcha', '.login-form', '#recaptcha']),
+    timeoutMs: 30_000,
+  }),
+  imgur: Object.freeze({
+    uploadUrl: 'https://imgur.com/upload',
+    fileInputSelectorCandidates: Object.freeze(['input[type="file"]', 'input[type=file]', '[data-file-input]']),
+    submitSelectorCandidates: Object.freeze(['button[type="submit"]', '[data-action="upload"]', '.upload-btn', '[type="submit"]']),
+    successExtractor: Object.freeze({
+      selectorCandidates: Object.freeze(['a[href*="i.imgur.com"]', 'input[value*="i.imgur.com"]', '[class*="copy-link"] input', '[data-link]']),
+      attribute: 'href',
+    }),
+    blockedIndicators: Object.freeze(['#challenge', '.captcha', '.g-recaptcha', '#recaptcha', '.signin', '.login']),
+    timeoutMs: 45_000,
+  }),
+  postimages: Object.freeze({
+    uploadUrl: 'https://postimages.org',
+    fileInputSelectorCandidates: Object.freeze(['input[type="file"]', 'input[type=file]', '#uploadFile', '.fileinput']),
+    submitSelectorCandidates: Object.freeze(['button[type="submit"]', '[type="submit"]', '.btn-upload']),
+    successExtractor: Object.freeze({
+      selectorCandidates: Object.freeze(['input[readonly][value*="postimg"]', 'a[href*="i.postimg.cc"]', '[class*="direct-link"]', 'textarea']),
+      attribute: 'value',
+    }),
+    blockedIndicators: Object.freeze(['#challenge', '.captcha', '.g-recaptcha', '#recaptcha']),
+    timeoutMs: 45_000,
+  }),
+});