Astro Core

Shared JavaScript utilities for the Info Evry Astro ecosystem.

Features

• Router - Lightweight request router for Cloudflare Workers with type checking and error handling
• Response Helpers - Standardized JSON responses, CORS handling, and error formatting

Installation

This package is included as a git submodule in astro-ndi and astro-join projects.

# From parent project
git submodule add https://github.com/info-evry/astro-core.git core

Usage

Router

import { Router, json, error } from './core/src/lib/router.js';

const router = new Router();

// Add routes with type-safe parameters
router.get('/api/items', async ({ request, env }) => {
  const items = await env.DB.prepare('SELECT * FROM items').all();
  return json(items.results);
});

router.get('/api/items/:id', async ({ request, env, params }) => {
  const { id } = params;
  const item = await env.DB.prepare('SELECT * FROM items WHERE id = ?')
    .bind(id)
    .first();

  if (!item) {
    return error('Item not found', 404);
  }
  return json(item);
});

router.post('/api/items', async ({ request, env }) => {
  const body = await request.json();
  // ... create item
  return json({ id: newId }, 201);
});

// Handle requests
export async function handleRequest(request, env) {
  return router.handle(request, env);
}

Response Helpers

import { json, error, success, corsHeaders, handleCors } from './core/src/lib/router.js';

// JSON response with custom status
json({ data: 'value' }, 201);

// Error response
error('Something went wrong', 500);

// Success message
success('Operation completed');

// CORS headers for allowed origin
corsHeaders('https://example.com');

// Handle preflight requests
handleCors(request, 'https://example.com');

Router Features

• Type Checking: Validates route patterns and parameter types
• Error Handling: Automatic try-catch wrapper with 500 error responses
• Method Matching: Supports GET, POST, PUT, DELETE, PATCH, OPTIONS, HEAD
• URL Parameters: Extract named parameters from route patterns (:id, :slug)
• Query Parameters: Access URL search params via request.url

API Reference

Router Class

Method	Description
get(pattern, handler)	Register GET route
post(pattern, handler)	Register POST route
put(pattern, handler)	Register PUT route
delete(pattern, handler)	Register DELETE route
patch(pattern, handler)	Register PATCH route
options(pattern, handler)	Register OPTIONS route
head(pattern, handler)	Register HEAD route
all(pattern, handler)	Register route for all methods
handle(request, env)	Route request to matching handler

Handler Context

Handlers receive a context object with:

{
  request,  // Original Request object
  env,      // Cloudflare Worker environment bindings
  params    // Extracted URL parameters
}

Response Helpers

Function	Description
json(data, status?)	JSON response (default 200)
error(message, status?)	Error JSON response (default 500)
success(message, status?)	Success JSON response (default 200)
corsHeaders(origin)	Generate CORS headers object
handleCors(request, origin)	Handle OPTIONS preflight

Testing

bun test

License

AGPL-3.0-only