This val automates IndexNow submission by:

1. Crawling sitemap URLs.
2. Tracking submission history in project-scoped SQLite.
3. Submitting only changed URLs.

0. Read the IndexNow docs (indexnow.org/documentation) and make sure your key file is already hosted on your domain at a public URL like https://www.example.org/<key>.txt.
1. Add at least one site file in config/sites/*.json (see below for details).
2. Set required env vars (see below for details).
3. Open / to confirm the dashboard loads.
4. Run a safe dry run first: POST /run?dryRun=1 with x-indexnow-token.
5. After dry run looks correct, enable cron via indexnow.cron.ts for ongoing automation.

• indexnow.http.ts: primary HTTP entrypoint.
• indexnow.cron.ts: scheduled trigger that POSTs to the HTTP handler at /run.

• INDEXNOW_RUN_TOKEN (required): auth token required for /run (manual and cron).
• INDEXNOW_FORCE_TOKEN (optional but recommended): separate auth token required when using force=1.
• INDEXNOW_ENDPOINT (optional): defaults to https://api.indexnow.org/indexnow.
• INDEXNOW_PER_SITE_RUN_URL_LIMIT (optional): defaults to 5000; per-site queue cap per run before batching into IndexNow POSTs.
• INDEXNOW_ALERTS_ENABLED (optional): defaults to enabled; set to 0/false to disable alert emails.
• INDEXNOW_ALERT_TO_<SITE> (optional): per-site alert recipient email (e.g. INDEXNOW_ALERT_TO_HANAYOU).

Site configs live in config/sites/*.json with one site per file. At least one file must exist or the val will throw on startup.

Example: config/sites/hanayou.studio.json

{
  "host": "www.hanayou.studio",
  "sitemapUrl": "https://www.hanayou.studio/sitemap.xml",
  "keyLocation": "https://www.hanayou.studio/2dc12b205bfe46d19a75077e3991f7ce.txt",
  "alertToEnvVar": "INDEXNOW_ALERT_TO_HANAYOU",
  "includePrefixes": ["/journal/", "/guides/"],
  "excludePrefixes": ["/tag/", "/author/"]
}

Notes:

• Keep raw email addresses out of config/sites/*.json; set as an env var instead.
• If alertToEnvVar is omitted (or env var is empty), the val sends alerts to the default owner email.

• Dashboard: /
• Run endpoint: /run
• /run is POST only and requires auth:
  • Authorization: Bearer <INDEXNOW_RUN_TOKEN> or x-indexnow-token: <INDEXNOW_RUN_TOKEN>
• /run defaults run reason to manual_run_endpoint.
• x-indexnow-reason: cron_entrypoint is reserved for the cron entrypoint.
• Dry run: POST /run?dryRun=1
• Force resubmit currently eligible URLs: POST /run?force=1
  • also requires x-indexnow-force-token: <INDEXNOW_FORCE_TOKEN>
• On non-dry runs, the val emails per-site recipients when configured (otherwise owner) when:
  • any URLs are successfully submitted, or
  • there are attention conditions (errors, pending, or deferred).
• Target a single configured site: POST /run?site=www.hanayou.studio
• Response includes stage-specific URL arrays:
• siteRuns[].filteredUrls for URLs that passed filters.
• siteRuns[].changedUrls for URLs detected as changed.
• siteRuns[].queuedUrls for changed URLs after run URL-limit capping.
• siteRuns[].submittedCount counts only HTTP 200 responses.
• HTTP 202 responses are tracked as pending in siteRuns[].pendingCount.

Example:

curl -X POST "https://<your-val>.web.val.run/run?dryRun=1&site=www.hanayou.studio" \
  -H "x-indexnow-token: <INDEXNOW_RUN_TOKEN>"

Force example:

curl -X POST "https://<your-val>.web.val.run/run?force=1&site=www.hanayou.studio" \
  -H "x-indexnow-token: <INDEXNOW_RUN_TOKEN>" \
  -H "x-indexnow-force-token: <INDEXNOW_FORCE_TOKEN>"

• Path: /monitor on indexnow.http.ts (JSON default)
• Purpose: IndexNow health snapshot from config + SQLite state
• Query params:
• site (optional): limit report to one configured host.
• runs (optional): recent run-history records per site (default 50, max 500; this is not a URL count).
• view (optional): dashboard for HTML UI, otherwise JSON.

Response highlights:

• totals.everSubmitted200Urls: URLs that have ever had a confirmed HTTP 200 submission.
• totals.upToDateUrls: URLs whose latest sitemap lastmod is already covered by the last successful submission.
• totals.needsSubmissionUrls: URLs never successfully submitted, or changed since last successful submission.
• totals.retryPendingUrls: URLs that need submission and whose latest attempt was a non-200/202 failure.
• sites[].latestRun: latest run summary per site.
• sites[].recentRuns: recent run history per site.

Dashboard example:

https://<your-val>.web.val.run/?site=www.hanayou.studio&runs=50

SQLite tables:

• indexnow_url_state_v1: per-URL state (seen/submitted timestamps, lastmod, status).
• indexnow_run_log_v1: per-run summaries for observability and debugging.

This val uses https://esm.town/v/std/sqlite/main.ts so data is scoped to this val project.

• INDEXNOW_PER_SITE_RUN_URL_LIMIT is applied per site for each run.
• If more changed URLs are discovered than the limit, the remainder is deferred to future runs.
• To intentionally resubmit unchanged URLs (still within limit), use force=1 with x-indexnow-force-token.

1. Daily/incident check:
   • Open / dashboard and confirm site health cards are green.
   • Review recent runs for pending, deferred, or Error statuses.
2. Manual safe run flow:
   • Run dry run first: POST /run?dryRun=1.
   • Review changedCount and queuedCount.
   • If expected, run real submission: POST /run.
3. If deferred URLs accumulate:
   • Confirm this is expected (large content release, migration, etc.).
   • Tune INDEXNOW_PER_SITE_RUN_URL_LIMIT and/or schedule frequency.
   • Use force=1 only when you intentionally want to resubmit unchanged URLs.
4. Alert triage:
   • Alert with pending: retry/watch next run; investigate endpoint throttling.
   • Alert with deferred: consider run URL-limit tuning or additional runs.
   • Alert with errors: requires action before trusting indexing progress.
5. External verification:
   • Use Bing Webmaster Tools to verify ingestion trends.