Val Town Code SearchReturn to Val Town

framer-gradientsREADME.md9 matches

@triozer•Updated 6 days ago

1**Example Hono-Zod-OpenAPI app with a Fiberplane API explorer.**
2
3> For an example with regular-old Hono, see: https://www.val.town/v/fiberplane/fiberplaneHonoStarter
8  ```
9
102. Expose your OpenAPI spec
11  ```ts
12  app.doc("/doc", {
13    openapi: "3.0.0",
14    info: {
15      title: "User Management API",
16      version: "v1.0.0",
17    },
19  ```
20
213. Mount the api explorer
22
23  This will mount it at the root `/*`, but you can mount it to another route, like `/fp/*` if you 
24  are using `/` for your main app. We recommend `/` if your Hono app is an API without a frontend.
25
26  ```ts  
28    "/*",
29    createFiberplane({
30      openapi: { url: "/doc" },
31    }),
32  );
33  ```
34
354. Visit your Val's root route to play with the API explorer!
36
37## How it Works
38
39`createFiberplane` mounts Fiberpalne at the root route (`/`), which can be used to explore the api's routes and make requests.
40Think of it like an embedded, lightweight postman.

framer-gradientslist-users.ts1 match

@triozer•Updated 6 days ago

1import { createRoute, z } from "https://esm.sh/@hono/zod-openapi@0.18.4";
2import { UserSchema } from "../schema.ts";
3

framer-gradientsindex.ts17 matches

@triozer•Updated 6 days ago

1import { createFiberplane } from "https://esm.sh/@fiberplane/hono@0.4.4";
2import { swaggerUI } from "https://esm.sh/@hono/swagger-ui@0.2.0";
3import { OpenAPIHono } from "https://esm.sh/@hono/zod-openapi@0.18.4";
4import { HTTPException } from "https://esm.sh/hono@4.7.0/http-exception";
5
6import { createUser, deleteUser, filterUsersByName, findUserById, updateUser } from "./helpers.ts";
7import { superProtectedApi } from "./protected/api.ts";
8import { createUserRoute } from "./routes/create-user.ts";
9import { deleteUserRoute } from "./routes/delete-user.ts";
14import type { AppType } from "./types.ts";
15
16const app = new OpenAPIHono<AppType>();
17
18app.openapi(getUserRoute, (c) => {
19  // This id is coerced to a number by the Zod schema for path parameters
20  // See: `UserIdPathParamSchema` in `schema.ts`
30});
31
32app.openapi(listUsersRoute, (c) => {
33  const { name } = c.req.valid("query");
34
38});
39
40app.openapi(createUserRoute, (c) => {
41  const { name, email, age } = c.req.valid("json");
42
46});
47
48app.openapi(updateUserRoute, (c) => {
49  const { id } = c.req.valid("param");
50  const { name, age } = c.req.valid("json");
59});
60
61app.openapi(deleteUserRoute, (c) => {
62  const { id } = c.req.valid("param");
63
73});
74
75// Mount an API with bearer auth
76app.route("/protected", superProtectedApi);
77
78// Create OpenAPI documentation
79app.doc("/openapi.json", {
80  openapi: "3.0.0",
81  info: {
82    title: "User Management API",
83    version: "v1.0.0",
84  },
86
87// Swagger UI
88app.get("/docs", swaggerUI({ url: "/openapi.json" }));
89
90// Mount the Fiberplane UI at the root to be able to test api endpoints
91app.use(
92  "/*",
93  createFiberplane({
94    openapi: { url: "/openapi.json" },
95  }),
96);

framer-gradientshelpers.ts1 match

@triozer•Updated 6 days ago

1import { z } from "https://esm.sh/@hono/zod-openapi@0.18.4";
2import { UserSchema } from "./schema.ts";
3

framer-gradientsget-user.ts1 match

@triozer•Updated 6 days ago

1import { createRoute } from "https://esm.sh/@hono/zod-openapi@0.18.4";
2import { ErrorSchema, UserIdPathParamSchema, UserSchema } from "../schema.ts";
3

framer-gradientsdelete-user.ts1 match

@triozer•Updated 6 days ago

1import { createRoute } from "https://esm.sh/@hono/zod-openapi@0.18.4";
2import { ErrorSchema, UserIdPathParamSchema } from "../schema.ts";
3

framer-gradientscreate-user.ts1 match

@triozer•Updated 6 days ago

1import { createRoute } from "https://esm.sh/@hono/zod-openapi@0.18.4";
2import { ErrorSchema, NewUserSchema, UserIdPathParamSchema, UserSchema } from "../schema.ts";
3

framer-gradientsapi.ts7 matches

@triozer•Updated 6 days ago

1import { OpenAPIHono } from "https://esm.sh/@hono/zod-openapi@0.18.4";
2import { createRoute } from "https://esm.sh/@hono/zod-openapi@0.18.4";
3import { z } from "https://esm.sh/@hono/zod-openapi@0.18.4";
4import { HTTPException } from "https://esm.sh/hono@4.7.0/http-exception";
5import { ErrorSchema } from "../schema.ts";
6import type { AppType } from "../types.ts";
7
8export const superProtectedApi = new OpenAPIHono<AppType>();
9
10// Define a mock route that is protected with bearer auth
34
35// Mock middleware that just returns 401 if there's no authorization header for the request
36superProtectedApi.use(async (c, next) => {
37  if (!c.req.header("authorization")) {
38    return c.json({ error: "Unauthorized" }, 401);
41});
42
43superProtectedApi.openapi(superSecretSecretsRoute, c => {
44  return c.json({ secrets: ["cold harbor", "other secret idk"] }, 200);
45});
46
47superProtectedApi.openAPIRegistry.registerComponent("securitySchemes", "Bearer", {
48  type: "http",
49  scheme: "bearer",

1import { Hono } from "npm:hono@3";
2// import { cors } from "npm:hono@3/cors";
3
4// Import route modules
5import auth from "./routes/auth.ts";

9
10  const content = {
11    headline: "👋 Welcome to the root API endpoint of this Hono app, running on val.town",
12    message: "Find more detail in the README.",
13    url: notionURL,