@gasket/plugin-fastify 7.0.0-next.8 → 7.0.1-canary.0

package/lib/create-servers.js

@@ -0,0 +1,94 @@
+/// <reference types="@gasket/plugin-https" />
+/// <reference types="@gasket/plugin-logger" />
+
+const fastify = require('fastify');
+const middie = require('middie');
+const cookieParser = require('cookie-parser');
+const compression = require('compression');
+const debug = require('diagnostics')('gasket:fastify');
+
+/**
+ * Create the Fastify instance and setup the lifecycle hooks.
+ * Fastify is compatible with express middleware out of the box, so we can
+ * use the same middleware lifecycles.
+ * @type {import('@gasket/core').HookHandler<'createServers'>}
+ */
+// eslint-disable-next-line max-statements
+module.exports = async function createServers(gasket, serverOpts) {
+  const { logger, config } = gasket;
+  const { middleware: middlewareConfig } = config;
+  const trustProxy = config.fastify?.trustProxy ?? false;
+  const excludedRoutesRegex =
+    config.fastify && config.fastify.excludedRoutesRegex;
+  // @ts-ignore
+  const app = fastify({ logger, trustProxy });
+
+  // Enable middleware for fastify@3
+  await app.register(middie);
+
+  // Add express-like `res.locals` object attaching data
+  app.use(function attachLocals(req, res, next) {
+    res.locals = {};
+    next();
+  });
+
+  if (excludedRoutesRegex) {
+    app.use(excludedRoutesRegex, cookieParser());
+  } else {
+    app.use(cookieParser());
+  }
+
+  const { compression: compressionConfig = true } = config.fastify || {};
+  if (compressionConfig) {
+    app.use(compression());
+  }
+
+  const middlewares = [];
+
+  await gasket.execApply('middleware', async (plugin, handler) => {
+    const middleware = await handler(app);
+    if (middleware) {
+      if (middlewareConfig) {
+        const pluginName = plugin && plugin.name ? plugin.name : '';
+        const mwConfig = middlewareConfig.find(
+          (mw) => mw.plugin === pluginName
+        );
+        if (mwConfig) {
+          middleware.paths = mwConfig.paths;
+          if (excludedRoutesRegex) {
+            middleware.paths.push(excludedRoutesRegex);
+          }
+        }
+      }
+      middlewares.push(middleware);
+    }
+  });
+
+  debug('applied %s middleware layers to fastify', middlewares.length);
+  middlewares.forEach((layer) => {
+    const { paths } = layer;
+    if (paths) {
+      app.use(paths, layer);
+    } else if (excludedRoutesRegex) {
+      app.use(excludedRoutesRegex, layer);
+    } else {
+      app.use(layer);
+    }
+  });
+
+  // allow consuming apps to directly append options to their server
+  await gasket.exec('fastify', app);
+
+  const postRenderingStacks = (await gasket.exec('errorMiddleware')).filter(
+    Boolean
+  );
+  postRenderingStacks.forEach((stack) => app.use(stack));
+
+  return {
+    ...serverOpts,
+    handler: async function handler(...args) {
+      await app.ready();
+      app.server.emit('request', ...args);
+    }
+  };
+};

package/lib/index.d.ts

@@ -1,18 +1,39 @@
-import type { MaybeAsync, MaybeMultiple } from '@gasket/engine';
-import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+import type { MaybeAsync, MaybeMultiple } from '@gasket/core';
+import type {
+  Fastify,
+  FastifyRequest,
+  FastifyReply,
+  FastifyServerOptions
+} from 'fastify';
 
-declare module '@gasket/engine' {
+declare module '@gasket/core' {
   export interface GasketConfig {
-    compression?: boolean,
-    excludedRoutesRegex?: RegExp
+    fastify?: {
+      /** Enable compression */
+      compression?: boolean;
+      /** Regular expression for excluded routes */
+      excludedRoutesRegex?: RegExp;
+      /** Trust proxy configuration */
+      trustProxy?: FastifyServerOptions['trustProxy'];
+      /** Glob pattern for source files setting up fastify routes */
+      routes?: string;
+    };
+    /** Middleware configuration */
+    middleware?: {
+      /** Plugin name */
+      plugin: string;
+      /** Paths for middleware */
+      paths?: (string | RegExp)[];
+    }[];
   }
 
-  // The middie middleware is added for express compatibility
-  type Handler = (
-    req: FastifyRequest,
-    res: FastifyReply,
-    next: (error?: Error) => void
-  ) => void;
+  /**
+   * Handler function type - The middie middleware is added for express
+   * compatibility
+   */
+  type Handler = (req: any, res: any, next: (error?: Error) => void) => void;
+
+  /** Error handler function type */
   type ErrorHandler = (
     error: Error,
     req: FastifyRequest,
@@ -21,8 +42,22 @@ declare module '@gasket/engine' {
   ) => void;
 
   export interface HookExecTypes {
-    middleware(fastify: FastifyInstance): MaybeAsync<MaybeMultiple<Handler>>,
-    fastify(fastify: FastifyInstance): MaybeAsync<void>,
-    errorMiddleware(fastify: FastifyInstance): MaybeAsync<MaybeMultiple<ErrorHandler>>
+    middleware(
+      fastify: Fastify
+    ): MaybeAsync<MaybeMultiple<Handler> & { paths?: (string | RegExp)[] }>;
+    fastify(fastify: Fastify): MaybeAsync<void>;
+    errorMiddleware(): MaybeAsync<MaybeMultiple<ErrorHandler>>;
   }
 }
+
+declare module 'create-gasket-app' {
+  export interface CreateContext {
+    /** Flag indicating if API app is enabled */
+    apiApp?: boolean;
+  }
+}
+
+export default {
+  name: '@gasket/plugin-fastify',
+  hooks: {}
+};

package/lib/index.js

@@ -1,161 +1,82 @@
-const debug = require('diagnostics')('gasket:fastify');
+/// <reference types="@gasket/core" />
+/// <reference types="@gasket/plugin-metadata" />
+
 const { peerDependencies, name } = require('../package.json');
+const createServers = require('./create-servers');
 
-module.exports = {
+/** @type {import('@gasket/core').Plugin} */
+const plugin = {
   name,
   hooks: {
-    /**
-    * Add files & extend package.json for new apps.
-    *
-    * @param {Gasket} gasket - The gasket API.
-    * @param {CreateContext} context - Create context
-    * @param {PackageJson} context.pkg - The Gasket PackageJson API.
-    * @public
-    */
     create: async function create(gasket, context) {
-      const generatorDir = `${ __dirname }/../generator`;
+      const generatorDir = `${__dirname}/../generator`;
 
       context.pkg.add('dependencies', {
         fastify: peerDependencies.fastify
       });
 
-      if (context.apiApp) {
-        context.files.add(`${ generatorDir }/**/*`);
+      if ('apiApp' in context && context.apiApp) {
+        context.files.add(`${generatorDir}/**/*`);
 
         context.gasketConfig.add('fastify', {
           routes: './routes/*'
         });
       }
     },
-    /**
-    * Create the Fastify instance and setup the lifecycle hooks.
-    * Fastify is compatible with express middleware out of the box, so we can
-    * use the same middleware lifecycles.
-    *
-    * @param {Gasket} gasket Gasket API.
-    * @param {Object} serverOpts Server options.
-    * @returns {Express} The web server.
-    * @public
-    */
-    // eslint-disable-next-line max-statements
-    createServers: async function createServers(gasket, serverOpts) {
-      const fastify = require('fastify');
-      const middie = require('middie');
-      const cookieParser = require('cookie-parser');
-      const compression = require('compression');
-
-      const { logger, config } = gasket;
-      const { middleware: middlewareConfig } = config;
-      const trustProxy = config.fastify?.trustProxy ?? false;
-      const excludedRoutesRegex = config.fastify && config.fastify.excludedRoutesRegex;
-      const app = fastify({ logger, trustProxy });
-
-      // Enable middleware for fastify@3
-      await app.register(middie);
-
-      // Add express-like `res.locals` object attaching data
-      app.use(function attachLocals(req, res, next) {
-        res.locals = {};
-        next();
-      });
-
-      if (excludedRoutesRegex) {
-        app.use(excludedRoutesRegex, cookieParser());
-      } else {
-        app.use(cookieParser());
-      }
-
-      const { compression: compressionConfig = true } = config.fastify || {};
-      if (compressionConfig) {
-        app.use(compression());
-      }
-
-      const middlewares = [];
-      await gasket.execApply('middleware', async (plugin, handler) => {
-        const middleware = await handler(app);
-        if (middleware) {
-          if (middlewareConfig) {
-            const pluginName = plugin && plugin.name ? plugin.name : '';
-            const mwConfig = middlewareConfig.find(mw => mw.plugin === pluginName);
-            if (mwConfig) {
-              middleware.paths = mwConfig.paths;
-              if (excludedRoutesRegex) {
-                middleware.paths.push(excludedRoutesRegex);
-              }
-            }
-          }
-          middlewares.push(middleware);
-        }
-      });
-
-      debug('applied %s middleware layers to fastify', middlewares.length);
-      middlewares.forEach(layer => {
-        const { paths } = layer;
-        if (paths) {
-          app.use(paths, layer);
-        } else if (excludedRoutesRegex) {
-          app.use(excludedRoutesRegex, layer);
-        } else {
-          app.use(layer);
-        }
-      });
-
-      // allow consuming apps to directly append options to their server
-      await gasket.exec('fastify', app);
-
-      const postRenderingStacks = (await gasket.exec('errorMiddleware')).filter(Boolean);
-      postRenderingStacks.forEach(stack => app.use(stack));
-
-      return {
-        ...serverOpts,
-        handler: async function handler(...args) {
-          await app.ready();
-          app.server.emit('request', ...args);
-        }
-      };
-    },
+    createServers,
     metadata(gasket, meta) {
       return {
         ...meta,
-        lifecycles: [{
-          name: 'middleware',
-          method: 'exec',
-          description: 'Add Express style middleware for Fastify',
-          link: 'README.md#middleware',
-          parent: 'createServers'
-        }, {
-          name: 'fastify',
-          method: 'exec',
-          description: 'Modify the Fastify instance to for adding endpoints',
-          link: 'README.md#express',
-          parent: 'createServers',
-          after: 'middleware'
-        }, {
-          name: 'errorMiddleware',
-          method: 'exec',
-          description: 'Add Express style middleware for handling errors with Fastify',
-          link: 'README.md#errorMiddleware',
-          parent: 'createServers',
-          after: 'express'
-        }],
-        configurations: [{
-          name: 'fastify',
-          link: 'README.md#configuration',
-          description: 'Fastify configuration object',
-          type: 'object'
-        }, {
-          name: 'fastify.compression',
-          link: 'README.md#configuration',
-          description: 'Automatic compression',
-          type: 'boolean',
-          default: true
-        }, {
-          name: 'fastify.excludedRoutesRegex',
-          link: 'README.md#configuration',
-          description: 'Routes to be excluded based on a regex',
-          type: 'RegExp'
-        }]
+        lifecycles: [
+          {
+            name: 'middleware',
+            method: 'exec',
+            description: 'Add Express style middleware for Fastify',
+            link: 'README.md#middleware',
+            parent: 'createServers'
+          },
+          {
+            name: 'fastify',
+            method: 'exec',
+            description: 'Modify the Fastify instance to for adding endpoints',
+            link: 'README.md#express',
+            parent: 'createServers',
+            after: 'middleware'
+          },
+          {
+            name: 'errorMiddleware',
+            method: 'exec',
+            description:
+              'Add Express style middleware for handling errors with Fastify',
+            link: 'README.md#errorMiddleware',
+            parent: 'createServers',
+            after: 'express'
+          }
+        ],
+        configurations: [
+          {
+            name: 'fastify',
+            link: 'README.md#configuration',
+            description: 'Fastify configuration object',
+            type: 'object'
+          },
+          {
+            name: 'fastify.compression',
+            link: 'README.md#configuration',
+            description: 'Automatic compression',
+            type: 'boolean',
+            default: true
+          },
+          {
+            name: 'fastify.excludedRoutesRegex',
+            link: 'README.md#configuration',
+            description: 'Routes to be excluded based on a regex',
+            type: 'RegExp'
+          }
+        ]
       };
     }
   }
 };
+
+module.exports = plugin;

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@gasket/plugin-fastify",
-  "version": "7.0.0-next.8",
+  "version": "7.0.1-canary.0",
   "description": "Adds fastify support to your application",
-  "main": "lib",
+  "main": "lib/index.js",
   "types": "lib/index.d.ts",
   "files": [
     "lib"
@@ -13,7 +13,9 @@
     "test": "cross-env NODE_OPTIONS='--unhandled-rejections=strict' jest",
     "test:watch": "jest --watch",
     "test:coverage": "jest --coverage",
-    "posttest": "npm run lint"
+    "posttest": "npm run lint && npm run typecheck",
+    "typecheck": "tsc",
+    "typecheck:watch": "tsc --watch"
   },
   "repository": {
     "type": "git",
@@ -43,15 +45,16 @@
     "middie": "^5.4.0"
   },
   "devDependencies": {
-    "@gasket/engine": "^7.0.0-next.8",
+    "@gasket/core": "^7.0.1-canary.0",
     "cross-env": "^7.0.3",
     "eslint": "^8.56.0",
-    "eslint-config-godaddy": "^7.0.2",
+    "eslint-config-godaddy": "^7.1.0",
     "eslint-plugin-jest": "^27.6.3",
     "eslint-plugin-json": "^3.1.0",
     "eslint-plugin-unicorn": "^44.0.0",
     "fastify": "^3.3.0",
-    "jest": "^29.7.0"
+    "jest": "^29.7.0",
+    "typescript": "^5.4.5"
   },
   "peerDependencies": {
     "fastify": "^3.0.0"
@@ -59,10 +62,12 @@
   "eslintConfig": {
     "extends": [
       "godaddy",
-      "plugin:jest/recommended"
+      "plugin:jest/recommended",
+      "plugin:jsdoc/recommended-typescript-flavor"
     ],
     "plugins": [
-      "unicorn"
+      "unicorn",
+      "jsdoc"
     ],
     "rules": {
       "unicorn/filename-case": "error"
@@ -71,5 +76,5 @@
   "eslintIgnore": [
     "generator"
   ],
-  "gitHead": "99e0acffa8b51393ede3dc6b9bf5cd5e0391216d"
+  "gitHead": "82d8ce71df54c36ded252083181a0cba034c82d7"
 }