Philosophy

experiments/
├── ai-website-summary/     # Independent
│   ├── package.json
│   ├── wrangler.json
│   ├── src/
│   └── README.md
├── screenshot-api/         # Independent
│   ├── package.json
│   ├── wrangler.json
│   ├── src/
│   └── README.md
└── is-it-down/            # Independent
    ├── package.json
    ├── wrangler.json
    ├── src/
    └── README.md

// src/index.ts - Always the entry point
import { Hono } from "hono";
import type { Env } from "./types/env";
import whereamiRoutes from "./routes/whereami";

const app = new Hono<{ Bindings: Env }>();

app.route("/", whereamiRoutes);

// Always include a GET / for experiment info
app.get("/", (c) => {
  return c.json({
    name: "whereami",
    description: "Request metadata from Cloudflare's edge (request.cf)",
    usage: "GET /whereami",
  });
});

// Always include global error handling
app.onError((err, c) => {
  return c.json({ error: err.message, code: "INTERNAL_ERROR" }, 500);
});

export default {
  fetch: app.fetch,
};

[![Deploy to Cloudflare Workers](https://deploy.workers.cloudflare.com/button)](
  https://deploy.workers.cloudflare.com/?url=https://github.com/shrinathsnayak/cloudflare-experiments/tree/main/experiments/is-it-down
)

// Traditional approach (single server)
const response = await fetch(url);
return response.ok ? "up" : "down";

// Edge approach (Cloudflare)
const cf = c.req.raw.cf;
const result = await fetchWithTiming(url);
return {
  status: result.ok ? "reachable" : "unreachable",
  responseTime: result.responseTimeMs,
  colo: cf?.colo, // Which edge location served this
};

// experiments/ai-website-summary/src/lib/ai.ts
const ai = c.env.AI;
const response = await ai.run('@cf/meta/llama-2-7b-chat-int8', {
  messages: [{
    role: 'user',
    content: `Summarize this webpage: ${text}`
  }]
});

// experiments/screenshot-api/src/lib/screenshot.ts
const browser = await puppeteer.launch(c.env.BROWSER);
const page = await browser.newPage();
await page.goto(url);
const screenshot = await page.screenshot();

// experiments/website-to-api/src/lib/parser.ts
new HTMLRewriter()
  .on('h1', {
    element(element) {
      headings.push(element.getAttribute('textContent'));
    }
  })
  .transform(response);

// src/utils/response.ts (duplicated in each experiment)
export function jsonError(
  c: Context,
  message: string,
  code: string,
  status = 400
) {
  return c.json({ error: message, code }, status);
}

export function jsonSuccess(c: Context, data: unknown) {
  return c.json(data);
}

// src/lib/url.ts (duplicated in each experiment)
export function validateUrl(input: string | undefined): string | null {
  if (!input) return null;
  try {
    const url = new URL(input);
    if (url.protocol !== 'http:' && url.protocol !== 'https:') {
      return null;
    }
    return url.href;
  } catch {
    return null;
  }
}

// src/types/env.d.ts
export interface Env {
  AI?: Ai;                    // Workers AI binding
  BROWSER?: Fetcher;          // Browser Rendering binding
  DB?: D1Database;            // D1 binding
  LINKS_CACHE?: KVNamespace;  // KV binding
}

// src/types/check.ts
export type CheckResponse =
  | {
      status: 'reachable';
      responseTime: number;
      statusCode: number;
      colo?: string;
    }
  | {
      status: 'unreachable';
      responseTime: number;
      statusCode?: number;
      colo?: string;
      error?: string;
    };