npm - @scalar/fastify-api-reference - Versions diffs - 0.4.0 → 0.4.2 - Mend

@scalar/fastify-api-reference 0.4.0 → 0.4.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/README.md +5 -0
package/dist/fastifyApiReference.d.ts +7 -7
package/dist/fastifyApiReference.d.ts.map +1 -1
package/dist/index.js +14 -10
package/dist/index.umd.cjs +2 -2
package/package.json +21 -5
package/src/esm.test.ts +0 -27
package/src/fastifyApiReference.test.ts +0 -148
package/src/fastifyApiReference.ts +0 -63
package/src/index.ts +0 -1

package/README.md CHANGED Viewed

@@ -1,5 +1,10 @@
 # Scalar Fastify API Reference Plugin
+![Version](https://img.shields.io/npm/v/%40scalar/fastify-api-reference)
+![Downloads](https://img.shields.io/npm/dm/%40scalar/fastify-api-reference)
+![License](https://img.shields.io/npm/l/%40scalar%2Ffastify-api-reference)
+[![Discord](https://img.shields.io/discord/1135330207960678410?style=flat&color=5865F2)](https://discord.gg/mw6FQRPh)
 This plugin provides an easy way to render a beautiful API reference based on a OpenAPI/Swagger file with Fastify.
 ## Installation

package/dist/fastifyApiReference.d.ts CHANGED Viewed

@@ -1,12 +1,12 @@
-import { type FastifyPluginCallback, type RegisterOptions } from 'fastify';
-type ApiReferenceOptions = {
+import { type FastifyPluginAsync } from 'fastify';
+export type ApiReferencePlugin = {
+    apiReference: ApiReferenceOptions;
+};
+export type ApiReferenceOptions = {
     title?: string;
     specUrl?: string;
     spec?: Record<string, any>;
 };
-export type FastifyApiReferenceOptions = {
-    apiReference: ApiReferenceOptions;
-} & RegisterOptions;
-declare const fastifyApiReference: FastifyPluginCallback<FastifyApiReferenceOptions>;
-export default fastifyApiReference;
+declare const fastifyApiReferencePlugin: FastifyPluginAsync<ApiReferencePlugin>;
+export default fastifyApiReferencePlugin;
 //# sourceMappingURL=fastifyApiReference.d.ts.map

package/dist/fastifyApiReference.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"fastifyApiReference.d.ts","sourceRoot":"","sources":["../src/fastifyApiReference.ts"],"names":[],"mappings":"~~AAAA~~,OAAO,EAAE,KAAK,~~qBAAqB~~,~~EAAE~~,~~KAAK~~,~~eAAe~~,~~EAAE~~,MAAM,~~SAAS~~,CAAA;~~AAE1E~~,~~KAAK~~,mBAAmB,GAAG;~~IACzB~~,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC3B,CAAA;~~AAED~~,~~MAAM,MAAM,0BAA0B,GAAG;IACvC,YAAY,EAAE,mBAAmB,CAAA;CAClC,GAAG,eAAe,CAAA;AA0BnB,~~QAAA,MAAM,~~mBAAmB~~,EAAE,~~qBAAqB~~,~~CAAC~~,~~0BAA0B~~,~~CAwB1E~~,CAAA;AAED,eAAe,~~mBAAmB~~,CAAA"}
1	+ {"version":3,"file":"fastifyApiReference.d.ts","sourceRoot":"","sources":["../src/fastifyApiReference.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,kBAAkB,EAA6B,MAAM,SAAS,CAAA;AAE5E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,YAAY,EAAE,mBAAmB,CAAA;CAClC,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;CAC3B,CAAA;AA0BD,QAAA,MAAM,yBAAyB,EAAE,kBAAkB,CACjD,kBAAkB,CAoBnB,CAAA;AAED,eAAe,yBAAyB,CAAA"}

package/dist/index.js CHANGED Viewed

@@ -1,4 +1,4 @@
-const s = (e) => {
+const l = (e) => {
   const t = e.specUrl ? `<div data-spec-url="${e.specUrl}" />` : `<div data-spec='${JSON.stringify(e.spec)}' />`;
   return `
 <!DOCTYPE html>
@@ -17,15 +17,19 @@ const s = (e) => {
   </body>
 </html>
 `;
-}, n = (e, t, r) => {
-  !t.apiReference.spec && !t.apiReference.specUrl && (console.warn(
-    "[@scalar/fastify-api-reference] You didn’t provide a spec or specUrl. Please provide one of these options."
-  ), r()), e.addHook("onSend", (d, a, c, l) => {
-    a.header("Content-Type", "text/html; charset=utf-8"), l();
-  }), e.get("/", (d, a) => {
-    const c = s(t == null ? void 0 : t.apiReference);
-    a.send(c);
-  }), r();
+}, n = async (e, t) => {
+  if (!t.apiReference.spec && !t.apiReference.specUrl) {
+    console.warn(
+      "[@scalar/fastify-api-reference] You didn’t provide a spec or specUrl. Please provide one of these options."
+    );
+    return;
+  }
+  e.addHook("onSend", (c, a, r, d) => {
+    a.header("Content-Type", "text/html; charset=utf-8"), d();
+  }), e.get("/", (c, a) => {
+    const r = l(t == null ? void 0 : t.apiReference);
+    a.send(r);
+  });
 };
 export {
   n as default

package/dist/index.umd.cjs CHANGED Viewed

@@ -1,4 +1,4 @@
-(function(r,c){typeof exports=="object"&&typeof module<"u"?module.exports=c():typeof define=="function"&&define.amd?define(c):(r=typeof globalThis<"u"?globalThis:r||self,r["@scalar/fastify-api-reference"]=c())})(this,function(){"use strict";const r=e=>{const t=e.specUrl?`<div data-spec-url="${e.specUrl}" />`:`<div data-spec='${JSON.stringify(e.spec)}' />`;return`
+(function(r,n){typeof exports=="object"&&typeof module<"u"?module.exports=n():typeof define=="function"&&define.amd?define(n):(r=typeof globalThis<"u"?globalThis:r||self,r["@scalar/fastify-api-reference"]=n())})(this,function(){"use strict";const r=e=>{const t=e.specUrl?`<div data-spec-url="${e.specUrl}" />`:`<div data-spec='${JSON.stringify(e.spec)}' />`;return`
 <!DOCTYPE html>
 <html>
   <head>
@@ -14,4 +14,4 @@
     <script src="https://cdn.scalar.com/api-reference.standalone.js"><\/script>
   </body>
 </html>
-`};return(e,t,n)=>{!t.apiReference.spec&&!t.apiReference.specUrl&&(console.warn("[@scalar/fastify-api-reference] You didn’t provide a spec or specUrl. Please provide one of these options."),n()),e.addHook("onSend",(s,a,i,d)=>{a.header("Content-Type","text/html; charset=utf-8"),d()}),e.get("/",(s,a)=>{const i=r(t==null?void 0:t.apiReference);a.send(i)}),n()}});
+`};return async(e,t)=>{if(!t.apiReference.spec&&!t.apiReference.specUrl){console.warn("[@scalar/fastify-api-reference] You didn’t provide a spec or specUrl. Please provide one of these options.");return}e.addHook("onSend",(i,c,a,s)=>{c.header("Content-Type","text/html; charset=utf-8"),s()}),e.get("/",(i,c)=>{const a=r(t==null?void 0:t.apiReference);c.send(a)})}});

package/package.json CHANGED Viewed

@@ -1,20 +1,35 @@
 {
   "name": "@scalar/fastify-api-reference",
-  "version": "0.4.0",
-  "author": "Scalar",
+  "description": "a fastify plugin to render an API reference from an automatically generated OpenAPI spec",
+  "keywords": [
+    "fastify",
+    "openapi",
+    "swagger",
+    "api",
+    "documentation"
+  ],
+  "version": "0.4.2",
+  "author": "Scalar (https://github.com/scalar)",
+  "homepage": "https://github.com/scalar/scalar",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/scalar/scalar.git",
+    "directory": "packages/fastify-api-reference"
+  },
+  "bugs": {
+    "url": "https://github.com/scalar/scalar/issues/new"
+  },
   "license": "MIT",
   "engines": {
     "node": ">=18"
   },
   "type": "module",
   "files": [
-    "src",
     "dist"
   ],
   "main": "./dist/index.umd.cjs",
   "module": "./dist/index.js",
   "exports": {
-    "development": "./src/index.ts",
     "require": "./dist/index.umd.cjs",
     "import": "./dist/index.js"
   },
@@ -28,7 +43,8 @@
     "typescript": "^5.2.2",
     "vite": "4.4.8",
     "vite-node": "^0.34.3",
-    "vitest": "0.34.1"
+    "vitest": "0.34.1",
+    "@vitest/coverage-v8": "^0.34.4"
   },
   "scripts": {
     "build": "vite build && pnpm types:build && tsc-alias -p tsconfig.build.json",

package/src/esm.test.ts DELETED Viewed

@@ -1,27 +0,0 @@
-import Fastify from 'fastify'
-import { describe, expect, it } from 'vitest'
-import fastifyApiReference from '../dist/index'
-describe('esm base support', () => {
-  it('returns 200 OK', () =>
-    new Promise((resolve) => {
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          specUrl: '/scalar.json',
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then((response) => {
-          expect(response.status).toBe(200)
-          resolve(null)
-        })
-      })
-    }))
-})

package/src/fastifyApiReference.test.ts DELETED Viewed

@@ -1,148 +0,0 @@
-import Fastify from 'fastify'
-import { describe, expect, it } from 'vitest'
-import fastifyApiReference from './fastifyApiReference'
-describe('fastifyApiReference', () => {
-  it('returns 200 OK', () =>
-    new Promise((resolve) => {
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          specUrl: '/scalar.json',
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then((response) => {
-          expect(response.status).toBe(200)
-          resolve(null)
-        })
-      })
-    }))
-  it('has the spec URL', () =>
-    new Promise((resolve) => {
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          specUrl: '/scalar.json',
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then(async (response) => {
-          expect(await response.text()).toContain(
-            'data-spec-url="/scalar.json"',
-          )
-          resolve(null)
-        })
-      })
-    }))
-  it('has the spec', () =>
-    new Promise((resolve) => {
-      const spec = {
-        openapi: '3.1.0',
-        info: {
-          title: 'Example',
-        },
-        paths: {},
-      }
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          spec,
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then(async (response) => {
-          expect(await response.text()).toContain(
-            `data-spec='${JSON.stringify(spec)}'`,
-          )
-          resolve(null)
-        })
-      })
-    }))
-  it('has the default title', () =>
-    new Promise((resolve) => {
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          specUrl: '/scalar.json',
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then(async (response) => {
-          expect(await response.text()).toContain(
-            '<title>API Reference</title>',
-          )
-          resolve(null)
-        })
-      })
-    }))
-  it('has the custom title', () =>
-    new Promise((resolve) => {
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          title: 'Foobar',
-          specUrl: '/scalar.json',
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then(async (response) => {
-          expect(await response.text()).toContain('<title>Foobar</title>')
-          resolve(null)
-        })
-      })
-    }))
-  it('has the correct content type', () =>
-    new Promise((resolve) => {
-      const fastify = Fastify({
-        logger: false,
-      })
-      fastify.register(fastifyApiReference, {
-        prefix: '/api-reference',
-        apiReference: {
-          specUrl: '/scalar.json',
-        },
-      })
-      fastify.listen({ port: 0 }, function (err, address) {
-        fetch(`${address}/api-reference`).then(async (response) => {
-          expect(response.headers.has('content-type')).toBe(true)
-          expect(response.headers.get('content-type')).toContain('text/html')
-          resolve(null)
-        })
-      })
-    }))
-})

package/src/fastifyApiReference.ts DELETED Viewed

@@ -1,63 +0,0 @@
-import { type FastifyPluginCallback, type RegisterOptions } from 'fastify'
-type ApiReferenceOptions = {
-  title?: string
-  specUrl?: string
-  spec?: Record<string, any>
-}
-export type FastifyApiReferenceOptions = {
-  apiReference: ApiReferenceOptions
-} & RegisterOptions
-const getHtmlMarkup = (options: ApiReferenceOptions) => {
-  const htmlTag = options.specUrl
-    ? `<div data-spec-url="${options.specUrl}" />`
-    : `<div data-spec='${JSON.stringify(options.spec)}' />`
-  return `
-<!DOCTYPE html>
-<html>
-  <head>
-    <title>${options.title || 'API Reference'}</title>
-    <meta charset="utf-8" />
-    <meta
-      name="viewport"
-      content="width=device-width, initial-scale=1" />
-  </head>
-  <body>
-    <!-- Add your own OpenAPI/Swagger spec file URL here: -->
-    ${htmlTag}
-    <script src="https://cdn.scalar.com/api-reference.standalone.js"></script>
-  </body>
-</html>
-`
-}
-const fastifyApiReference: FastifyPluginCallback<FastifyApiReferenceOptions> = (
-  fastify,
-  options,
-  done,
-) => {
-  if (!options.apiReference.spec && !options.apiReference.specUrl) {
-    console.warn(
-      '[@scalar/fastify-api-reference] You didn’t provide a spec or specUrl. Please provide one of these options.',
-    )
-    done()
-  }
-  fastify.addHook('onSend', (request, reply, payload, next) => {
-    reply.header('Content-Type', 'text/html; charset=utf-8')
-    next()
-  })
-  fastify.get('/', (_, reply) => {
-    const html = getHtmlMarkup(options?.apiReference)
-    reply.send(html)
-  })
-  done()
-}
-export default fastifyApiReference

package/src/index.ts DELETED Viewed

	@@ -1 +0,0 @@
1	- export { default } from './fastifyApiReference'