Deno TypeScript con Claude Code

Optimizando el desarrollo con Deno y Claude Code

Deno es un runtime moderno con seguridad como prioridad. Soporta TypeScript de forma nativa y proporciona un entorno de ejecucion seguro mediante un modelo de permisos. Combinandolo con Claude Code, puedes aprovechar rapidamente las funcionalidades unicas de Deno.

Configuracion inicial del proyecto

> Crea una aplicacion web con Deno.
> Usa el framework Fresh y configura tambien deno.json.

// deno.json
{
  "lock": false,
  "tasks": {
    "dev": "deno run -A --watch=static/,routes/ dev.ts",
    "build": "deno run -A dev.ts build",
    "start": "deno run -A main.ts",
    "test": "deno test -A --coverage=coverage",
    "lint": "deno lint",
    "fmt": "deno fmt"
  },
  "imports": {
    "$fresh/": "https://deno.land/x/[email protected]/",
    "$std/": "https://deno.land/[email protected]/",
    "preact": "https://esm.sh/[email protected]",
    "preact/": "https://esm.sh/[email protected]/"
  },
  "compilerOptions": {
    "jsx": "react-jsx",
    "jsxImportSource": "preact"
  }
}

Uso del modelo de permisos

Deno deniega todos los accesos por defecto.

> Crea un servidor API que solo permita lectura de archivos y acceso a red.
> Configura siguiendo el principio de minimo privilegio.

// server.ts
// Ejecucion: deno run --allow-net=:8000 --allow-read=./data server.ts

import { serve } from "$std/http/server.ts";

const handler = async (req: Request): Promise<Response> => {
  const url = new URL(req.url);

  if (url.pathname === "/api/config") {
    const data = await Deno.readTextFile("./data/config.json");
    return new Response(data, {
      headers: { "content-type": "application/json" },
    });
  }

  if (url.pathname === "/api/items") {
    const dir = Deno.readDir("./data/items");
    const items = [];
    for await (const entry of dir) {
      if (entry.isFile && entry.name.endsWith(".json")) {
        const content = await Deno.readTextFile(
          `./data/items/${entry.name}`
        );
        items.push(JSON.parse(content));
      }
    }
    return Response.json(items);
  }

  return new Response("Not Found", { status: 404 });
};

serve(handler, { port: 8000 });

Arquitectura de islas con Fresh

> Crea un componente de contador usando islas de Fresh.
> Siendo consciente de la separacion entre servidor y cliente.

// routes/index.tsx
import Counter from "../islands/Counter.tsx";

export default function Home() {
  return (
    <div class="max-w-screen-md mx-auto p-4">
      <h1 class="text-4xl font-bold">Deno Fresh App</h1>
      <Counter start={0} />
    </div>
  );
}

// islands/Counter.tsx
import { useSignal } from "@preact/signals";

interface CounterProps {
  start: number;
}

export default function Counter({ start }: CounterProps) {
  const count = useSignal(start);
  return (
    <div class="flex gap-4 items-center">
      <button onClick={() => count.value--}>-</button>
      <span class="text-2xl">{count}</span>
      <button onClick={() => count.value++}>+</button>
    </div>
  );
}

Tests y cobertura

// server_test.ts
import { assertEquals } from "$std/assert/assert_equals.ts";

Deno.test("Verificacion de salud del API", async () => {
  const res = await fetch("http://localhost:8000/api/config");
  assertEquals(res.status, 200);
  const data = await res.json();
  assertEquals(typeof data, "object");
});

Deno.test("Operaciones de archivo con permisos", async () => {
  const content = await Deno.readTextFile("./data/config.json");
  const config = JSON.parse(content);
  assertEquals(config.version !== undefined, true);
});

Despliegue en Deno Deploy

# CLI de Deno Deploy
deno install -A jsr:@deno/deployctl

# Despliegue
deployctl deploy --project=my-app --entrypoint=main.ts

Resumen

El modelo de seguridad de Deno y el soporte nativo de TypeScript proporcionan una experiencia de desarrollo segura y comoda. Con Claude Code, puedes aprender eficientemente la configuracion de permisos y los patrones unicos de Fresh. Consulta tambien los consejos de desarrollo TypeScript y la guia de auditoria de seguridad.

Para mas detalles sobre Deno, consulta la documentacion oficial de Deno.