Routing

Create your routes in src/routes. xink is a directory-based router where endpoint files are named route. They can have a .js, .ts, or .tsx extension.

src/
└── routes/
    ├── auth/
    │   └── route.ts creates an /auth route
    └── route.ts creates a / route

HTTP exports

Within your route endpoint files, you define handler functions that are named after the HTTP methods they will serve. You can also define a default handler.

src/routes/route.ts

export const GET = () => {
  return 'Welcome to xink!'
}

/* handle any other supported http methods */
export default ({ request }) => {
  return { message: `Hello ${request.method}!` }

xink supports GET, POST, PUT, PATCH, DELETE, HEAD, OPTIONS

Route Types

Listed in order of match priority.

Static

All route segments are statically defined.

/hello/there/world

Specific

At least one segment is a combination of static and dynamic types.

/hello/miss-[name]

Matcher

Dynamic segments (params) are validated. In the example, ‘word’ references a function which tests if the value of the name parameter matches.

/hello/[name=word]

xink comes with three built-in matcher functions, but you can override them or define your own in the src/params directory.

/* word */
(param) => /^\w+$/.test(param)

/* letter */
(param) => /^[a-z]+$/i.test(param)

/* number */
(param) => /^\d+$/.test(param)

Each file in src/params needs to export a match function that takes in a string and returns a boolean. When true is returned, the param matches and the router either continues to try and match the rest of the route or returns the route if this is the last segment. Returning false indicates the param does not match, and the router keeps searching for a route.

src/params/fruits.ts

export const match = (param: string) => {
  return new Set(['apple', 'orange', 'grape']).has(param)
}

The above would be used in your route segment like so: /src/routes/[fruit=fruits]/route.ts; where the label on the right side of the = character should be the same as the filename in src/params - minus the extension.

So, for the fruits example, if a request was made to /apple, it would match, but a request to /banana would not.

Unlike validators and schemas, matchers do not populate event.valid

Dynamic

Route segments can be params, and are available in event.params.

/hello/[name]

src/routes/hello/[name]/route.ts

export const GET = ({ params }) => {
  return `Hello, ${params.name}!`
}

Rest

Essentially a wildcard, but must be at the end of a route.

/hello/[...rest]

Because of the way the xin URL router works, the rest segment’s param is accessed with '*'.

src/routes/hello/[...rest]/route.js

export const GET = ({ params }) => {
  return `Hello ${params['*']}!` // not `params.rest`
}