1
0

3 Commits

Author SHA1 Message Date
1b2956b437 add more tests 2024-01-20 02:14:39 +01:00
64458ca755 even more tests 2024-01-19 21:04:54 +01:00
eeea1102af working on testing 2024-01-19 00:37:29 +01:00
13 changed files with 3801 additions and 1281 deletions

View File

@@ -11,7 +11,3 @@ indent_style = tab
[README.md]
indent_style = space
indent_size = 4
[{package,package-lock}.json]
indent_style = space
indent_size = 2

View File

@@ -1,5 +1,4 @@
name: Publish
run-name: Publish ${{ github.ref_name }}
name: Publish (main)
on:
release:
@@ -14,27 +13,19 @@ jobs:
with:
node-version: latest
registry-url: https://registry.npmjs.org/
- name: Install dependencies
run: npm ci
- name: Run tests
run: npm test
- name: Build
run: npm run build
- name: Publish to npmjs
env:
NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}
run: npm publish --tag ${{ contains(github.ref_name, '-') && 'pre' || 'latest' }} --access public
run: npm publish --tag latest --access public
- uses: actions/setup-node@v3
with:
node-version: latest
registry-url: https://npm.pkg.github.com/
- name: Publish to GPR
env:
NODE_AUTH_TOKEN: ${{secrets.GITHUB_TOKEN}}
run: npm publish --tag ${{ contains(github.ref_name, '-') && 'pre' || 'latest' }} --access public
run: npm publish --tag latest --access public

View File

@@ -1,31 +0,0 @@
name: Release
run-name: Release ${{ github.ref_name }}
on:
push:
tags:
- 'v*'
jobs:
release:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: latest
registry-url: https://registry.npmjs.org/
- name: Install dependencies
run: npm ci
- name: Run tests
run: npm test
- name: Build
run: npm run build
- name: Create release
run: gh release create ${{ github.ref_name }} --draft --generate-notes ${{ contains(github.ref_name, '-') && '--prerelease --latest=false' || '--latest' }}
env:
GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}

View File

@@ -1,26 +0,0 @@
name: Test
on:
push:
branches: [ main ]
pull_request:
branches: [ main ]
jobs:
run:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v3
- uses: actions/setup-node@v3
with:
node-version: latest
registry-url: https://registry.npmjs.org/
- name: Install dependencies
run: npm ci
- name: Run tests
run: npm test
- name: Build
run: npm run build

View File

@@ -1,10 +1,7 @@
.editorconfig
.github/
.gitignore
.nvmrc
coverage/
jest.config.ts
MIGRATION.md
src/
tests/
test/
.nvmrc
MIGRATION.md
tsconfig.json
.editorconfig

View File

@@ -4,6 +4,8 @@ Cloudflare Workers Router is a super lightweight router (1.0K gzipped) with midd
When I was trying out Cloudflare Workers I almost immediately noticed how fast it was compared to other serverless offerings. So I wanted to build a full-fledged API to see how it performs doing real work, but since I wasn't able to find a router that suited my needs I created my own.
I worked a lot with [Express.js](https://expressjs.com/) in the past and really enjoyed their middleware approach, but since none of the available Cloudflare Worker routers offered middleware support at the time, I felt the need to create this router.
## Contents
@@ -18,9 +20,8 @@ When I was trying out Cloudflare Workers I almost immediately noticed how fast i
- ZERO dependencies
- Lightweight (1.0K gzipped)
- Fully written in TypeScript
- Integrated Debug-Mode & CORS helper
- Built specifically around Middlewares
- Debug-Mode, CORS and Bearer helpers
- Allows accessing request body multiple times
## Usage
@@ -239,6 +240,7 @@ Key | Type | Default Value
### Supported Methods
- `router.any(url, [...handlers])`
- `router.connect(url, [...handlers])`
- `router.delete(url, [...handlers])`
- `router.get(url, [...handlers])`
- `router.head(url, [...handlers])`
@@ -246,6 +248,7 @@ Key | Type | Default Value
- `router.patch(url, [...handlers])`
- `router.post(url, [...handlers])`
- `router.put(url, [...handlers])`
- `router.trace(url, [...handlers])`
#### `url` (string)
@@ -293,7 +296,7 @@ wrangler init <name>
Use of TypeScript is strongly encouraged :)
```bash
npm i @tsndr/cloudflare-worker-router
npm i -D @tsndr/cloudflare-worker-router
```

9
jest.config.ts Normal file
View File

@@ -0,0 +1,9 @@
import type { Config } from 'jest'
const config: Config = {
preset: 'ts-jest',
testEnvironment: 'node',
verbose: true
}
export default config

4852
package-lock.json generated

File diff suppressed because it is too large Load Diff

View File

@@ -1,23 +1,22 @@
{
"name": "@tsndr/cloudflare-worker-router",
"version": "3.3.0",
"version": "3.1.3",
"description": "",
"type": "module",
"exports": "./index.js",
"main": "index.js",
"types": "index.d.ts",
"scripts": {
"build": "tsc",
"test": "vitest"
"build": "tsc"
},
"repository": {
"type": "git",
"url": "git+https://github.com/tsndr/cloudflare-worker-router.git"
},
"keywords": [
"api",
"cloudflare",
"cloudflare-worker",
"cloudflare-workers",
"express",
"expressjs",
"framework",
"middleware",
"router",
@@ -32,9 +31,12 @@
},
"homepage": "https://github.com/tsndr/cloudflare-worker-router#readme",
"devDependencies": {
"@cloudflare/workers-types": "^4.20241022.0",
"@edge-runtime/vm": "^4.0.3",
"typescript": "^5.6.3",
"vitest": "^2.1.3"
"@cloudflare/workers-types": "^4.20231025.0",
"@jest/globals": "^29.7.0",
"@types/jest": "^29.5.11",
"jest": "^29.7.0",
"ts-jest": "^29.1.1",
"ts-node": "^10.9.2",
"typescript": "^5.2.2"
}
}

View File

@@ -1,5 +1,5 @@
import { describe, expect, test } from 'vitest'
import { Router } from '../src/index'
import { describe, expect, test } from '@jest/globals'
import { Router } from '.'
describe('Router', () => {
test('use', async () => {
@@ -261,21 +261,6 @@ describe('Router', () => {
expect(await response.text()).toBe(testToken)
})
test('basic', async () => {
const router = new Router()
const testCredentials = ['user', 'password']
const testBasicAuth = btoa(testCredentials.join(':'))
const testRequest = new Request('https://example.com/', { headers: { 'Authorization': `Basic ${testBasicAuth}` }})
router.get('/', ({ req }) => Response.json(req.basic()))
const response = await router.handle(testRequest, {})
expect(response.status).toEqual(200)
expect(await response.json()).toMatchObject(testCredentials)
})
})
describe('Middleware', () => {

View File

@@ -52,7 +52,6 @@ export type RouterRequest<ReqExt> = ReqExt & {
formData(): Promise<FormData>
blob(): Promise<Blob>
bearer(): string | undefined
basic(): [string, string]
cf?: IncomingRequestCfProperties
}
@@ -176,6 +175,17 @@ export class Router<Env = any, CtxExt = {}, ReqExt = {}> {
return this
}
/**
* Register CONNECT route
*
* @param {string} url
* @param {RouterHandler[]} handlers
* @returns {Router}
*/
public connect(url: string, ...handlers: RouterHandler<Env, CtxExt, ReqExt>[]): Router<Env, CtxExt, ReqExt> {
return this.register('CONNECT', url, handlers)
}
/**
* Register DELETE route
*
@@ -253,6 +263,17 @@ export class Router<Env = any, CtxExt = {}, ReqExt = {}> {
return this.register('PUT', url, handlers)
}
/**
* Register TRACE route
*
* @param {string} url
* @param {RouterHandler[]} handlers
* @returns {Router}
*/
public trace(url: string, ...handlers: RouterHandler<Env, CtxExt, ReqExt>[]): Router<Env, CtxExt, ReqExt> {
return this.register('TRACE', url, handlers)
}
/**
* Register route, ignoring method
*
@@ -396,8 +417,7 @@ export class Router<Env = any, CtxExt = {}, ReqExt = {}> {
json: async <T>(): Promise<T> => buffer.json ? buffer.json : buffer.json = await request.clone().json<T>(),
formData: async (): Promise<FormData> => buffer.formData ? buffer.formData : buffer.formData = await request.clone().formData(),
blob: async (): Promise<Blob> => buffer.blob ? buffer.blob : buffer.blob = await request.clone().blob(),
bearer: () => request.headers.get('Authorization')?.replace(/^[Bb]earer\s/, '').trim(),
basic: () => (atob(request.headers.get('Authorization')?.replace(/^[Bb]asic\s/, '').trim() ?? '') || undefined)?.split(':')
bearer: () => request.headers.get('Authorization')?.replace(/^(B|b)earer /, '').trim()
} as RouterRequest<ReqExt>
if (this.corsEnabled && req.method === 'OPTIONS') {
@@ -408,23 +428,21 @@ export class Router<Env = any, CtxExt = {}, ReqExt = {}> {
}
const route = this.getRoute(req)
let response: Response | undefined
if (!route)
response = new Response(this.debugMode ? 'Route not found!' : null, { status: 404 })
return new Response(this.debugMode ? 'Route not found!' : null, { status: 404 })
if (!response) {
const handlers = [
...this.globalHandlers,
...(route?.handlers ?? [])
]
const handlers = [...this.globalHandlers, ...route.handlers]
const dbg = this.debugMode
let response: Response | undefined
for (const handler of handlers) {
const context = {
...(ctxExt ?? {}),
env,
req,
dbg: this.debugMode,
dbg,
ctx
} as RouterContext<Env, CtxExt, ReqExt>
@@ -435,10 +453,9 @@ export class Router<Env = any, CtxExt = {}, ReqExt = {}> {
break
}
}
}
if (!response)
response = new Response(this.debugMode ? 'Handler did not return a Response!' : null, { status: 404 })
return new Response(this.debugMode ? 'Handler did not return a Response!' : null, { status: 404 })
if (this.corsEnabled) {
response = new Response(response.body, response)

View File

@@ -1,7 +1,7 @@
{
"compilerOptions": {
"outDir": ".",
"module": "esnext",
"module": "commonjs",
"target": "esnext",
"lib": ["esnext"],
"declaration": true,

View File

@@ -1,9 +0,0 @@
import { defineConfig } from 'vitest/config'
export default defineConfig({
test: {
environment: 'edge-runtime',
reporters: ['verbose'],
watch: false
}
})