sni-cli 1.2.1__tar.gz → 1.2.3__tar.gz

{sni_cli-1.2.1 → sni_cli-1.2.3}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: sni-cli
-Version: 1.2.1
+Version: 1.2.3
 Summary: Stream Ninja Interface — terminal-based anime streaming CLI + TUI
 Project-URL: Homepage, https://github.com/sundeepyt2/SNI
 Project-URL: Source, https://github.com/sundeepyt2/SNI
@@ -380,26 +380,30 @@ echo 'cf_clearance=...;' > ~/.config/sni/allanime_cookies.txt
 sni play "one piece" --cookie 'cf_clearance=...;'
 ```
 
-### Option 2 — Cloudflare Worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
+### Option 2 — Self-hosted proxy worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
 
-This is the most powerful bypass — it proxies AllAnime API requests through Cloudflare's own IPs, which AllAnime rarely challenges. Only set this up if Option 1 fails AND SNI's built-in proxy fallback doesn't work for you.
+SNI ships with ready-to-deploy proxy worker code in the [`worker/`](worker/) directory. The worker proxies AllAnime API requests through a clean IP (the platform's IP), which AllAnime's edge doesn't flag. **Three deployment platforms are supported — all have free tiers, none require a credit card:**
 
-**Deploy via Cloudflare** (free, requires a Cloudflare account):
+| Platform | Difficulty | Setup time | Why pick this |
+|---|---|---|---|
+| **Deno Deploy** | Easiest | ~2 min | Most reliable as of 2026; playground = no GitHub repo needed |
+| **Vercel Edge Functions** | Easy | ~3 min | Good if you already use Vercel |
+| **Cloudflare Workers** | Hard right now | ~5 min | Known dashboard deploy bugs; use only if others fail |
 
-1. Go to https://dash.cloudflare.com → Workers & Pages → Create
-2. Paste the contents of [`cf-worker/worker.js`](https://github.com/smithmx20/XAN/blob/main/cf-worker/worker.js) from the XAN repo
-3. Deploy, copy the worker URL (e.g. `https://xan-proxy.you.workers.dev`)
-4. Save it to SNI:
+**Full step-by-step instructions for all three platforms are in [`worker/README.md`](worker/README.md).**
+
+Quick Deno Deploy setup (recommended):
+
+1. Go to https://dash.deno.com → sign in with GitHub → "New Project" → "Playground"
+2. Paste the contents of [`worker/proxy.deno.js`](worker/proxy.deno.js) → click "Save & Deploy"
+3. Copy the URL (e.g. `https://your-project.deno.dev`)
+4. Save to SNI:
 
    ```bash
-   sni config --update allanime_cf_worker_url='https://xan-proxy.you.workers.dev'
+   sni config --update allanime_cf_worker_url='https://your-project.deno.dev'
    ```
 
-**Can't create a Cloudflare account?** Deploy the same `worker.js` code to any of these alternative platforms (all have free tiers, none require a credit card):
-
-- **Deno Deploy** (https://dash.deno.com) — free, no card required, fastest setup. Wrap the worker's `fetch` handler in a `Deno.serve()` call.
-- **Vercel Edge Functions** (https://vercel.com) — free tier. Adapt the handler to Vercel's `export default function handler(req: Request)` signature.
-- **Netlify Functions** (https://netlify.com) — free tier. Convert to Netlify's `exports.handler` format.
+5. Try: `sni play "one piece"`
 
 The worker code is platform-agnostic — it's just a `fetch` handler that proxies a request. The only thing that changes between platforms is the entry-point wrapper.
 

{sni_cli-1.2.1 → sni_cli-1.2.3}/README.md

@@ -327,26 +327,30 @@ echo 'cf_clearance=...;' > ~/.config/sni/allanime_cookies.txt
 sni play "one piece" --cookie 'cf_clearance=...;'
 ```
 
-### Option 2 — Cloudflare Worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
+### Option 2 — Self-hosted proxy worker (last resort for VPN/shared IPs that are permanently captcha-walled AND cookies + public proxies don't work)
 
-This is the most powerful bypass — it proxies AllAnime API requests through Cloudflare's own IPs, which AllAnime rarely challenges. Only set this up if Option 1 fails AND SNI's built-in proxy fallback doesn't work for you.
+SNI ships with ready-to-deploy proxy worker code in the [`worker/`](worker/) directory. The worker proxies AllAnime API requests through a clean IP (the platform's IP), which AllAnime's edge doesn't flag. **Three deployment platforms are supported — all have free tiers, none require a credit card:**
 
-**Deploy via Cloudflare** (free, requires a Cloudflare account):
+| Platform | Difficulty | Setup time | Why pick this |
+|---|---|---|---|
+| **Deno Deploy** | Easiest | ~2 min | Most reliable as of 2026; playground = no GitHub repo needed |
+| **Vercel Edge Functions** | Easy | ~3 min | Good if you already use Vercel |
+| **Cloudflare Workers** | Hard right now | ~5 min | Known dashboard deploy bugs; use only if others fail |
 
-1. Go to https://dash.cloudflare.com → Workers & Pages → Create
-2. Paste the contents of [`cf-worker/worker.js`](https://github.com/smithmx20/XAN/blob/main/cf-worker/worker.js) from the XAN repo
-3. Deploy, copy the worker URL (e.g. `https://xan-proxy.you.workers.dev`)
-4. Save it to SNI:
+**Full step-by-step instructions for all three platforms are in [`worker/README.md`](worker/README.md).**
+
+Quick Deno Deploy setup (recommended):
+
+1. Go to https://dash.deno.com → sign in with GitHub → "New Project" → "Playground"
+2. Paste the contents of [`worker/proxy.deno.js`](worker/proxy.deno.js) → click "Save & Deploy"
+3. Copy the URL (e.g. `https://your-project.deno.dev`)
+4. Save to SNI:
 
    ```bash
-   sni config --update allanime_cf_worker_url='https://xan-proxy.you.workers.dev'
+   sni config --update allanime_cf_worker_url='https://your-project.deno.dev'
    ```
 
-**Can't create a Cloudflare account?** Deploy the same `worker.js` code to any of these alternative platforms (all have free tiers, none require a credit card):
-
-- **Deno Deploy** (https://dash.deno.com) — free, no card required, fastest setup. Wrap the worker's `fetch` handler in a `Deno.serve()` call.
-- **Vercel Edge Functions** (https://vercel.com) — free tier. Adapt the handler to Vercel's `export default function handler(req: Request)` signature.
-- **Netlify Functions** (https://netlify.com) — free tier. Convert to Netlify's `exports.handler` format.
+5. Try: `sni play "one piece"`
 
 The worker code is platform-agnostic — it's just a `fetch` handler that proxies a request. The only thing that changes between platforms is the entry-point wrapper.
 

{sni_cli-1.2.1 → sni_cli-1.2.3}/pyproject.toml

@@ -9,7 +9,7 @@ build-backend = "hatchling.build"
 # just `sni` (defined below in [project.scripts]), so users run `sni play`,
 # `sni tui`, etc. — only `pip install sni-cli` differs from the bare name.
 name = "sni-cli"
-version = "1.2.1"
+version = "1.2.3"
 description = "Stream Ninja Interface — terminal-based anime streaming CLI + TUI"
 readme = "README.md"
 requires-python = ">=3.10"

sni_cli-1.2.3/sni/__init__.py

@@ -0,0 +1 @@
+__version__ = "1.2.3"

{sni_cli-1.2.1 → sni_cli-1.2.3}/sni/cli.py

@@ -142,6 +142,8 @@ async def _search(
             results.append((provider_name, hits))
         except CaptchaRequiredError:
             raise  # let the caller print the helpful panel
+        except ProviderError:
+            raise  # let the caller print the error
         except Exception as e:
             logger.exception(f"Search failed for '{query}' with provider '{provider_name}'")
             typer.echo(f"Search failed: {type(e).__name__}: {e}")
@@ -192,6 +194,9 @@ async def _play(
     except CaptchaRequiredError as e:
         _print_captcha_help(e)
         return
+    except ProviderError as e:
+        typer.echo(f"Error: {e}")
+        return
     if not results:
         typer.echo("No results found.")
         return
@@ -257,6 +262,9 @@ async def _watch(
     except CaptchaRequiredError as e:
         _print_captcha_help(e)
         return
+    except ProviderError as e:
+        typer.echo(f"Error: {e}")
+        return
     if not results:
         typer.echo("No results found.")
         return
@@ -305,6 +313,9 @@ async def _search_cmd(
         except CaptchaRequiredError as e:
             _print_captcha_help(e)
             raise typer.Exit(code=1)
+        except ProviderError as e:
+            typer.echo(f"Error: {e}")
+            raise typer.Exit(code=1)
 
     if not results:
         typer.echo("No results found.")
@@ -518,17 +529,16 @@ def config(
             "    sni config --update allanime_cookies='cf_clearance=...;'\n"
             "  Or write to file (easier to refresh):\n"
             f"    echo 'cf_clearance=...;' > {DEFAULT_COOKIES_PATH}\n\n"
-            "[bold yellow]Option 2 - Cloudflare Worker[/bold yellow]\n"
+            "[bold yellow]Option 2 - Self-hosted proxy worker[/bold yellow]\n"
             "[bold yellow](last resort for VPN/shared IPs):[/bold yellow]\n"
-            "  Deploy the XAN CF Worker (free, requires Cloudflare account):\n"
-            "    1. https://dash.cloudflare.com -> Workers & Pages -> Create\n"
-            "    2. Paste XAN/cf-worker/worker.js from the XAN repo\n"
-            "    3. Deploy, copy the worker URL\n"
-            "    4. sni config --update allanime_cf_worker_url='https://your-worker.workers.dev'\n"
-            "  Can't create a Cloudflare account? Deploy the same worker.js to:\n"
-            "    - Deno Deploy (https://dash.deno.com) - free, no card required\n"
-            "    - Vercel Edge Functions (https://vercel.com) - free tier\n"
-            "    - Netlify Functions (https://netlify.com) - free tier\n",
+            "  SNI ships worker code in the worker/ directory. Deploy to ANY of:\n"
+            "    - Deno Deploy (recommended): https://dash.deno.com -> Playground\n"
+            "      Paste worker/proxy.deno.js -> Save & Deploy. ~2 min, no card.\n"
+            "    - Vercel Edge Functions: https://vercel.com (3 min)\n"
+            "    - Cloudflare Workers: https://dash.cloudflare.com (5 min, flaky)\n"
+            "  See worker/README.md in the repo for full step-by-step.\n"
+            "  Then save the URL:\n"
+            "    sni config --update allanime_cf_worker_url='https://your-deployment'\n",
             title="AllAnime captcha bypass",
             border_style="cyan",
         ))

{sni_cli-1.2.1 → sni_cli-1.2.3}/sni/providers/allanime.py

@@ -58,8 +58,8 @@ USER_AGENT = (
 REFERER = "https://youtu-chan.com"
 ORIGIN = "https://youtu-chan.com"
 
-REQUEST_TIMEOUT = 15.0
-CLOCK_TIMEOUT = 20.0
+REQUEST_TIMEOUT = 30.0  # increased from 15s — proxy connections can be slow
+CLOCK_TIMEOUT = 30.0
 
 # Regex used by the embed scraper to pull HLS / MP4 URLs out of HTML pages.
 # Mirrors XAN's scrapeEmbedPage regexes.
@@ -146,6 +146,44 @@ def _is_captcha_response(resp: httpx.Response) -> bool:
     return "just a moment" in body_start or "cf-mitigated" in resp.headers
 
 
+def _wrap_fallback_error(last_error: Optional[Exception], endpoint: str) -> Exception:
+    """Wrap a network/captcha error in a user-friendly ProviderError.
+
+    If the last error was already a CaptchaRequiredError, return it as-is
+    (it already has a helpful hint). If it was a network error (ConnectTimeout,
+    ReadTimeout, etc.), wrap it in a ProviderError with a clear message
+    explaining that SNI couldn't reach AllAnime and suggesting fixes.
+    """
+    if last_error is None:
+        return CaptchaRequiredError(f"AllAnime {endpoint} failed with no specific error")
+
+    if isinstance(last_error, CaptchaRequiredError):
+        return last_error
+
+    # Network errors (ConnectTimeout, ReadTimeout, ConnectError, etc.)
+    if isinstance(last_error, (httpx.TimeoutException, httpx.HTTPError)):
+        err_name = type(last_error).__name__
+        return ProviderError(
+            f"SNI could not connect to AllAnime ({err_name} on {endpoint}).\n\n"
+            f"This is a NETWORK issue, not a captcha. SNI tried direct + proxy.cors.sh "
+            f"but couldn't reach any of them.\n\n"
+            f"Possible causes:\n"
+            f"  1. Your internet is down or unstable\n"
+            f"  2. Your ISP/firewall blocks api.allanime.day or proxy.cors.sh\n"
+            f"  3. Your DNS can't resolve these hosts\n"
+            f"  4. You're on a restrictive network (school/work/country firewall)\n\n"
+            f"Try:\n"
+            f"  - Check your internet: curl -I https://api.allanime.day\n"
+            f"  - Try a different network (mobile hotspot, VPN)\n"
+            f"  - If on a VPN, try WITHOUT it (some VPNs are blocked)\n"
+            f"  - Check DNS: nslookup api.allanime.day\n"
+            f"  - Try again in a few minutes (temporary outage)"
+        )
+
+    # Any other exception — wrap it
+    return ProviderError(f"AllAnime {endpoint} failed: {type(last_error).__name__}: {last_error}")
+
+
 class AllAnimeProvider(Provider):
     name = "allanime"
     domain = "allanime.day"
@@ -161,12 +199,11 @@ class AllAnimeProvider(Provider):
 
     # Free public CORS proxies that support POST + JSON bodies. SNI tries
     # each one in order when the direct request to api.allanime.day is
-    # captcha-walled. proxy.cors.sh is the most reliable as of 2026; the
-    # others are kept as backup in case cors.sh ever rate-limits or goes
-    # down. Format: a format string with a single {url} placeholder.
+    # captcha-walled. As of 2026, most public CORS proxies have shut down
+    # or block POST. proxy.cors.sh is the only reliable one left.
+    # Format: a format string with a single {url} placeholder.
     PUBLIC_PROXIES = [
         "https://proxy.cors.sh/{url}",
-        "https://thingproxy.freeboard.io/fetch/{url}",
     ]
 
     def __init__(self, cookies: str = "", cf_worker_url: str = ""):
@@ -205,8 +242,8 @@ class AllAnimeProvider(Provider):
         Fallback order:
           1. Direct request to api.allanime.day (fastest when not captcha-walled)
           2. Each public CORS proxy in PUBLIC_PROXIES (no user config needed)
-          3. CF Worker (only if user configured allanime_cf_worker_url — but
-             CF Workers are GET-only, so this raises a clear error instead)
+          3. CF Worker (if user configured allanime_cf_worker_url — the v3
+             worker in worker/proxy.js supports POST)
 
         CaptchaRequiredError is raised only when ALL fallbacks fail.
         """
@@ -218,6 +255,12 @@ class AllAnimeProvider(Provider):
         fallbacks: List[tuple] = [("direct", self.GRAPHQL_URL)]
         for i in range(len(self.PUBLIC_PROXIES)):
             fallbacks.append(("proxy", self._proxy_url(i, self.GRAPHQL_URL)))
+        if self.cf_worker_url:
+            # CF Worker v3 supports POST — body is forwarded as-is
+            fallbacks.append(("worker", _build_cf_worker_url(
+                self.cf_worker_url, self.GRAPHQL_URL,
+                extra_headers={"Referer": self.REFERER, "Origin": self.ORIGIN},
+            )))
 
         # If a proxy previously worked, try it first (skip the dead direct)
         if self._working_proxy_idx is not None:
@@ -269,10 +312,8 @@ class AllAnimeProvider(Provider):
                     )
                 return raw
 
-        # All fallbacks failed
-        raise last_error or CaptchaRequiredError(
-            "All AllAnime API fallbacks failed for /api/graphql",
-        )
+        # All fallbacks failed — wrap the error in a user-friendly message
+        raise _wrap_fallback_error(last_error, "/api/graphql")
 
     async def _get_persisted(self, variables: dict) -> dict:
         """GET /api?variables=...&extensions=persistedQuery...
@@ -349,9 +390,7 @@ class AllAnimeProvider(Provider):
                     )
                 return raw
 
-        raise last_error or CaptchaRequiredError(
-            "All AllAnime API fallbacks failed for /api persisted query",
-        )
+        raise _wrap_fallback_error(last_error, "/api persisted query")
 
     def _check_graphql_errors(self, raw: dict) -> None:
         """Inspect a parsed GraphQL response for errors, raising the right

sni_cli-1.2.3/worker/README.md

@@ -0,0 +1,133 @@
+# SNI Stream Proxy — Self-Hostable Captcha Bypass
+
+This directory contains the proxy worker code that SNI uses as a fallback when your IP is captcha-walled on `api.allanime.day`. The worker is a simple JavaScript `fetch` handler that proxies requests through a clean IP (the platform's IP, not yours), which AllAnime's Cloudflare edge doesn't flag.
+
+## When you need this
+
+You need this **only** if ALL of these are true:
+
+1. `sni play "one piece"` fails with `NEED_CAPTCHA` or `ConnectTimeout`
+2. `curl -I https://api.allanime.day` times out or returns 403 from your machine
+3. `curl -I https://proxy.cors.sh` also times out (SNI's built-in public proxy fallback doesn't work for you)
+
+If any of those work, you don't need this — SNI's built-in fallbacks already cover you.
+
+## Three deployment options (all free, no credit card required)
+
+Pick **one**. All three run the same JavaScript code (slightly different entry-point wrappers).
+
+| Platform | Free tier | Signup difficulty | Setup time |
+|---|---|---|---|
+| **Deno Deploy** | 1M req/month | Easy (GitHub login) | ~2 min |
+| **Vercel Edge Functions** | 1M req/month | Easy (GitHub login) | ~3 min |
+| **Cloudflare Workers** | 100K req/day | Hard right now (deploy bugs) | ~5 min |
+
+**If you can't create a Cloudflare Worker (the Hello World project won't deploy), use Deno Deploy instead — it's the most reliable as of 2026.**
+
+---
+
+## Option 1: Deno Deploy (recommended — most reliable)
+
+1. Go to https://dash.deno.com → Sign in with GitHub
+2. Click **"New Project"**
+3. Click **"Playground"** (top-right, lets you paste code directly — no GitHub repo needed)
+4. Delete the default code, paste the entire contents of [`proxy.deno.js`](./proxy.deno.js) from this directory
+5. Click **"Save & Deploy"**
+6. You'll get a URL like `https://your-project.deno.dev` — copy it
+7. Test it in your browser: visit `https://your-project.deno.dev/` — you should see `{"ok":true,"service":"sni-stream-proxy",...}`
+8. Save it to SNI:
+
+   ```bash
+   sni config --update allanime_cf_worker_url='https://your-project.deno.dev'
+   ```
+
+9. Try SNI: `sni play "one piece"`
+
+---
+
+## Option 2: Vercel Edge Functions
+
+1. Go to https://vercel.com → Sign in with GitHub
+2. Click **"Add New"** → **"Project"**
+3. Click **"Create New Project"** → under "No Framework", click **"Browse all templates"** → pick **"Blank"**
+4. Name your project, click **"Deploy"** (this creates an empty project)
+5. Once deployed, click **"Continue to Dashboard"** → **"Code"** tab → **"Files"** tab
+6. Create a new folder called `api` and a file inside it called `proxy.js`
+7. Paste the entire contents of [`api/proxy.js`](./api/proxy.js) into that file
+8. Click **"Commit"** → **"Commit & Deploy"**
+9. Once redeployed, your URL will be `https://your-project.vercel.app/api/proxy` — copy it
+10. Test it in your browser: visit `https://your-project.vercel.app/api/proxy` — you should see `{"ok":true,...}`
+11. Save it to SNI:
+
+    ```bash
+    sni config --update allanime_cf_worker_url='https://your-project.vercel.app/api/proxy'
+    ```
+
+12. Try SNI: `sni play "one piece"`
+
+---
+
+## Option 3: Cloudflare Workers
+
+Use this only if Deno Deploy and Vercel both fail for you.
+
+1. Go to https://dash.cloudflare.com → sign up / sign in
+2. Left sidebar → **"Workers & Pages"** → **"Create"** → **"Create Worker"**
+3. Give it a name (e.g. `sni-proxy`) → click **"Deploy"**
+4. Click **"Edit code"** (top-right)
+5. Delete the default code, paste the entire contents of [`proxy.js`](./proxy.js) from this directory
+6. Click **"Deploy"** (top-right)
+7. Your URL will be `https://sni-proxy.<your-subdomain>.workers.dev` — copy it
+8. Test it in your browser: visit the URL — you should see `{"ok":true,...}`
+9. Save it to SNI:
+
+   ```bash
+   sni config --update allanime_cf_worker_url='https://sni-proxy.your-subdomain.workers.dev'
+   ```
+
+10. Try SNI: `sni play "one piece"`
+
+**If the "Hello World" project won't deploy:** This is a known Cloudflare dashboard bug. Try:
+- Use a different browser (Chrome instead of Firefox, or vice versa)
+- Disable ad-blockers / privacy extensions
+- Try incognito mode
+- Wait 30 minutes and retry (sometimes it's a transient outage)
+- **Or just use Deno Deploy instead** (Option 1) — it's more reliable right now
+
+---
+
+## How it works
+
+SNI's `AllAnimeProvider` tries these in order when fetching anime data:
+
+1. **Direct request** to `api.allanime.day` — fastest, works for most users
+2. **proxy.cors.sh** (built-in public proxy) — automatic fallback, no setup needed
+3. **Your self-hosted worker** (this directory) — last resort, only used if you configured `allanime_cf_worker_url`
+4. **CF Worker** (Cloudflare's own IPs) — same as #3, just deployed on Cloudflare specifically
+
+The worker:
+- Accepts GET and POST requests
+- Proxies them to the target URL with proper headers (Referer, Origin, User-Agent)
+- Only allows requests to a hardcoded list of AllAnime-related hosts (security: prevents abuse)
+- Streams the response body back (supports large video files)
+
+## Security
+
+The worker has a hardcoded allowlist of hosts it will proxy (`ALLOWED_HOSTS` in the code). It will refuse to proxy requests to any other host. This prevents someone from using your worker as an open proxy for arbitrary traffic.
+
+## Verification
+
+After configuring your worker URL, verify SNI can use it:
+
+```bash
+# Should print the version
+sni --version
+
+# Should search successfully (using your worker if direct fails)
+sni search "one piece"
+
+# Should play successfully
+sni play "one piece"
+```
+
+If you still get `NEED_CAPTCHA` or `ConnectTimeout`, run `sni config --cookie-info` for more options or open an issue at https://github.com/sundeepyt2/SNI/issues

sni_cli-1.2.1/sni/__init__.py

@@ -1 +0,0 @@
-__version__ = "1.2.1"