⭐ Star on GitHub — it motivates us a lot!

senden

Use your TS server definition, to write typesafe client code. Yes - like tRPC but RESTfull. We have custamizable paths and familiar HTTP methods.

import { server, RouteClient } from "senden";

const routes = {
  warehouse: {
    order: {

      $post: async (order: Order) => { ... }),

      list: {
        $get: async (data: {$page: number}) => { ... }),
      },

      $id: {
        $get: async (data: {$id: number}) => { ... }),
        $delete: async (data: {$id: number}) => { ... }),
      },
    },
  },
};

export const appRouter = server.build(routes);

export type WarehouseApi = RouteClient<typeof routes>;

This api will now accept the following requests:

| Method | Route | Description | | -------- | ----------------------------- | ---------------------------- | | POST | warehouse/order | Create a new order | | GET | warehouse/order/123 | Get the order with id 123 | | DELETE | warehouse/order/123 | Delete it | | GET | warehouse/order/list?page=0 | Get the first page of orders |

And finally, in the frontend code we have auto-completion and type-safety for the REST API.

import { client } from "senden";
import type { WarehouseApi } from "../server/routes";

const api = client<WarehouseApi>();

const result = await api.warehouse.order.$post({
  name: "My Order",
  ...
});

Getting started

npx degit github:fru/senden/examples/express senden-example-express

https://stackblitz.com/github/fru/senden/tree/main/examples/express?file=package.json

npx degit github:fru/senden/examples/hono-on-cloudflare senden-example-hono-on-cf

Documentation

You might also want to check out

https://github.com/ecyrbe/zodios