@event-driven-io/emmett-fastify 0.43.0-beta.12 → 0.43.0-beta.14

package/README.md

@@ -0,0 +1,413 @@
+# @event-driven-io/emmett-fastify
+
+Fastify web framework integration for building event-sourced HTTP APIs with Emmett.
+
+## Purpose
+
+This package provides seamless integration between the Emmett event sourcing library and Fastify, enabling you to build high-performance, event-sourced HTTP APIs. It includes sensible defaults for common plugins (ETag, compression, form body parsing) and automatic graceful shutdown handling.
+
+## Key Concepts
+
+- **Application Factory**: Create pre-configured Fastify instances with essential plugins
+- **Graceful Shutdown**: Automatic cleanup via `close-with-grace` when the server stops
+- **Plugin System**: Extensible architecture using Fastify's plugin ecosystem
+- **Decider Pattern**: Works seamlessly with Emmett's decider-based command handling
+
+## Installation
+
+```bash
+npm install @event-driven-io/emmett-fastify
+```
+
+Since this package uses peer dependencies, you also need to install:
+
+```bash
+npm install @event-driven-io/emmett fastify @fastify/compress @fastify/etag @fastify/formbody close-with-grace
+```
+
+## Quick Start
+
+### Basic Application Setup
+
+```typescript
+import { getApplication, startAPI } from '@event-driven-io/emmett-fastify';
+import { getInMemoryEventStore } from '@event-driven-io/emmett';
+import type { FastifyInstance } from 'fastify';
+
+// Create your event store
+const eventStore = getInMemoryEventStore();
+
+// Define your routes
+const registerRoutes = (app: FastifyInstance) => {
+  app.get('/health', async () => ({ status: 'ok' }));
+
+  app.post('/carts/:cartId/items', async (request, reply) => {
+    // Handle command with event store
+    return reply.code(201).send();
+  });
+};
+
+// Create and start the application
+const app = await getApplication({ registerRoutes });
+await startAPI(app, { port: 3000 });
+```
+
+### Shopping Cart API Example
+
+Here is a complete example demonstrating the decider pattern with Fastify routes:
+
+```typescript
+import {
+  DeciderCommandHandler,
+  getInMemoryEventStore,
+  type EventStore,
+  type Decider,
+} from '@event-driven-io/emmett';
+import { getApplication, startAPI } from '@event-driven-io/emmett-fastify';
+import type { FastifyInstance, FastifyRequest, FastifyReply } from 'fastify';
+
+// Define events
+type ShoppingCartEvent =
+  | {
+      type: 'ShoppingCartOpened';
+      data: { cartId: string; clientId: string; openedAt: Date };
+    }
+  | {
+      type: 'ProductItemAdded';
+      data: { cartId: string; productId: string; quantity: number };
+    }
+  | {
+      type: 'ShoppingCartConfirmed';
+      data: { cartId: string; confirmedAt: Date };
+    };
+
+// Define commands
+type ShoppingCartCommand =
+  | {
+      type: 'OpenShoppingCart';
+      data: { cartId: string; clientId: string; now: Date };
+    }
+  | {
+      type: 'AddProductItem';
+      data: { cartId: string; productId: string; quantity: number };
+    }
+  | { type: 'ConfirmShoppingCart'; data: { cartId: string; now: Date } };
+
+// Define state
+type ShoppingCart =
+  | { status: 'Empty' }
+  | {
+      status: 'Pending';
+      id: string;
+      clientId: string;
+      items: Array<{ productId: string; quantity: number }>;
+    }
+  | { status: 'Confirmed'; id: string; confirmedAt: Date };
+
+// Implement the decider
+const decider: Decider<ShoppingCart, ShoppingCartCommand, ShoppingCartEvent> = {
+  decide: (command, state) => {
+    switch (command.type) {
+      case 'OpenShoppingCart':
+        return {
+          type: 'ShoppingCartOpened',
+          data: {
+            cartId: command.data.cartId,
+            clientId: command.data.clientId,
+            openedAt: command.data.now,
+          },
+        };
+      case 'AddProductItem':
+        return {
+          type: 'ProductItemAdded',
+          data: {
+            cartId: command.data.cartId,
+            productId: command.data.productId,
+            quantity: command.data.quantity,
+          },
+        };
+      case 'ConfirmShoppingCart':
+        return {
+          type: 'ShoppingCartConfirmed',
+          data: { cartId: command.data.cartId, confirmedAt: command.data.now },
+        };
+    }
+  },
+  evolve: (state, event) => {
+    switch (event.type) {
+      case 'ShoppingCartOpened':
+        return {
+          status: 'Pending',
+          id: event.data.cartId,
+          clientId: event.data.clientId,
+          items: [],
+        };
+      case 'ProductItemAdded':
+        if (state.status !== 'Pending') return state;
+        return {
+          ...state,
+          items: [
+            ...state.items,
+            { productId: event.data.productId, quantity: event.data.quantity },
+          ],
+        };
+      case 'ShoppingCartConfirmed':
+        if (state.status !== 'Pending') return state;
+        return {
+          status: 'Confirmed',
+          id: state.id,
+          confirmedAt: event.data.confirmedAt,
+        };
+    }
+  },
+  initialState: () => ({ status: 'Empty' }),
+};
+
+// Create command handler
+const handle = DeciderCommandHandler(decider);
+
+// Register routes
+const registerRoutes = (eventStore: EventStore) => (app: FastifyInstance) => {
+  app.post(
+    '/clients/:clientId/shopping-carts',
+    async (request: FastifyRequest, reply: FastifyReply) => {
+      const { clientId } = request.params as { clientId: string };
+      const cartId = clientId;
+
+      await handle(eventStore, cartId, {
+        type: 'OpenShoppingCart',
+        data: { cartId, clientId, now: new Date() },
+      });
+
+      return reply.code(201).send({ id: cartId });
+    },
+  );
+
+  app.post(
+    '/clients/:clientId/shopping-carts/:cartId/items',
+    async (request: FastifyRequest, reply: FastifyReply) => {
+      const { cartId } = request.params as { cartId: string };
+      const { productId, quantity } = request.body as {
+        productId: string;
+        quantity: number;
+      };
+
+      await handle(eventStore, cartId, {
+        type: 'AddProductItem',
+        data: { cartId, productId, quantity },
+      });
+
+      return reply.code(204).send();
+    },
+  );
+
+  app.post(
+    '/clients/:clientId/shopping-carts/:cartId/confirm',
+    async (request: FastifyRequest, reply: FastifyReply) => {
+      const { cartId } = request.params as { cartId: string };
+
+      await handle(eventStore, cartId, {
+        type: 'ConfirmShoppingCart',
+        data: { cartId, now: new Date() },
+      });
+
+      return reply.code(204).send();
+    },
+  );
+};
+
+// Start the server
+const eventStore = getInMemoryEventStore();
+const app = await getApplication({
+  registerRoutes: registerRoutes(eventStore),
+});
+await startAPI(app, { port: 3000 });
+```
+
+## How-to Guides
+
+### Custom Server Options
+
+Configure Fastify server options, including logging:
+
+```typescript
+const app = await getApplication({
+  registerRoutes,
+  serverOptions: {
+    logger: true, // Enable Fastify logging
+  },
+});
+```
+
+### Custom Plugins
+
+Override or extend the default plugins:
+
+```typescript
+import Cors from '@fastify/cors';
+
+const app = await getApplication({
+  registerRoutes,
+  activeDefaultPlugins: [
+    { plugin: Cors, options: { origin: '*' } },
+    // Add your custom plugins here
+  ],
+});
+```
+
+### Disable Default Plugins
+
+Start with no default plugins:
+
+```typescript
+const app = await getApplication({
+  registerRoutes,
+  activeDefaultPlugins: [],
+});
+```
+
+### Testing with Fastify Inject
+
+Use Fastify's built-in `inject` method for testing without starting a server:
+
+```typescript
+import { getApplication } from '@event-driven-io/emmett-fastify';
+import { getInMemoryEventStore } from '@event-driven-io/emmett';
+
+const eventStore = getInMemoryEventStore();
+const app = await getApplication({
+  registerRoutes: registerRoutes(eventStore),
+});
+
+// Test a route
+const response = await app.inject({
+  method: 'POST',
+  url: '/clients/client-123/shopping-carts',
+});
+
+console.log(response.statusCode); // 201
+console.log(response.json()); // { id: 'client-123' }
+```
+
+### Using with Different Event Stores
+
+The package works with any Emmett event store implementation:
+
+```typescript
+// With PostgreSQL
+import { getPostgreSQLEventStore } from '@event-driven-io/emmett-postgresql';
+
+const eventStore = getPostgreSQLEventStore(connectionPool);
+const app = await getApplication({
+  registerRoutes: registerRoutes(eventStore),
+});
+
+// With EventStoreDB
+import { getEventStoreDBEventStore } from '@event-driven-io/emmett-esdb';
+
+const eventStore = getEventStoreDBEventStore(client);
+const app = await getApplication({
+  registerRoutes: registerRoutes(eventStore),
+});
+```
+
+## API Reference
+
+### `getApplication(options: ApplicationOptions): Promise<FastifyInstance>`
+
+Creates a configured Fastify application instance.
+
+**Parameters:**
+
+| Option                 | Type                             | Default                      | Description                      |
+| ---------------------- | -------------------------------- | ---------------------------- | -------------------------------- |
+| `registerRoutes`       | `(app: FastifyInstance) => void` | `undefined`                  | Function to register your routes |
+| `serverOptions`        | `{ logger: boolean }`            | `{ logger: true }`           | Fastify server configuration     |
+| `activeDefaultPlugins` | `Plugin[]`                       | `[ETag, Compress, FormBody]` | Plugins to register              |
+
+**Returns:** A Promise that resolves to a configured `FastifyInstance`.
+
+### `startAPI(app: FastifyInstance, options?: StartApiOptions): Promise<void>`
+
+Starts the Fastify server.
+
+**Parameters:**
+
+| Option         | Type              | Default  | Description                      |
+| -------------- | ----------------- | -------- | -------------------------------- |
+| `app`          | `FastifyInstance` | required | The Fastify application instance |
+| `options.port` | `number`          | `5000`   | Port number to listen on         |
+
+### `ApplicationOptions`
+
+```typescript
+interface ApplicationOptions {
+  serverOptions?: { logger: boolean };
+  registerRoutes?: (app: FastifyInstance) => void;
+  activeDefaultPlugins?: Plugin[];
+}
+```
+
+### `StartApiOptions`
+
+```typescript
+type StartApiOptions = {
+  port?: number;
+};
+```
+
+### `Plugin`
+
+```typescript
+type Plugin = {
+  plugin: FastifyPluginAsync | FastifyPluginCallback;
+  options: FastifyPluginOptions;
+};
+```
+
+## Architecture
+
+### Default Plugins
+
+The package registers these plugins by default:
+
+| Plugin              | Purpose                                             |
+| ------------------- | --------------------------------------------------- |
+| `@fastify/etag`     | Automatic ETag header generation for caching        |
+| `@fastify/compress` | Response compression (disabled globally by default) |
+| `@fastify/formbody` | Form body parsing support                           |
+
+### Graceful Shutdown
+
+The application automatically handles graceful shutdown using `close-with-grace`:
+
+- Waits 500ms before forcing shutdown
+- Logs any errors during shutdown
+- Cleans up listeners when the application closes
+
+### Integration with Emmett Core
+
+This package is designed to work with Emmett's core patterns:
+
+```
+Fastify Route -> Command -> DeciderCommandHandler -> EventStore -> Events
+```
+
+1. HTTP requests arrive at Fastify routes
+2. Routes construct commands from request data
+3. `DeciderCommandHandler` processes commands using the decider pattern
+4. Events are appended to the event store
+5. Responses are sent back to the client
+
+## Dependencies
+
+### Peer Dependencies
+
+| Package                   | Version   | Purpose                     |
+| ------------------------- | --------- | --------------------------- |
+| `@event-driven-io/emmett` | `0.38.3`  | Core event sourcing library |
+| `fastify`                 | `^4.28.1` | Web framework               |
+| `@fastify/compress`       | `^7.0.3`  | Response compression        |
+| `@fastify/etag`           | `^5.2.0`  | ETag support                |
+| `@fastify/formbody`       | `^7.4.0`  | Form body parsing           |
+| `close-with-grace`        | `^2.1.0`  | Graceful shutdown           |

package/dist/index.cjs

@@ -1,56 +1,87 @@
-"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }// src/index.ts
-var _compress = require('@fastify/compress'); var _compress2 = _interopRequireDefault(_compress);
-var _etag = require('@fastify/etag'); var _etag2 = _interopRequireDefault(_etag);
-var _formbody = require('@fastify/formbody'); var _formbody2 = _interopRequireDefault(_formbody);
-var _closewithgrace = require('close-with-grace'); var _closewithgrace2 = _interopRequireDefault(_closewithgrace);
-var _fastify = require('fastify'); var _fastify2 = _interopRequireDefault(_fastify);
-var defaultPlugins = [
-  { plugin: _etag2.default, options: {} },
-  { plugin: _compress2.default, options: { global: false } },
-  { plugin: _formbody2.default, options: {} }
-];
-var getApplication = async (options) => {
-  const {
-    registerRoutes,
-    activeDefaultPlugins = defaultPlugins,
-    serverOptions = {
-      logger: true
-    }
-  } = options;
-  const app = _fastify2.default.call(void 0, serverOptions);
-  await Promise.all(
-    activeDefaultPlugins.map(async ({ plugin, options: options2 }) => {
-      await app.register(plugin, options2);
-    })
-  );
-  if (registerRoutes) {
-    registerRoutes(app);
-  }
-  const closeListeners = _closewithgrace2.default.call(void 0, { delay: 500 }, async (opts) => {
-    if (opts.err) {
-      app.log.error(opts.err);
-    }
-    await app.close();
-  });
-  app.addHook("onClose", (instance, done) => {
-    closeListeners.uninstall();
-    done();
-  });
-  return app;
-};
-var startAPI = async (app, options = { port: 5e3 }) => {
-  const { port } = options;
-  try {
-    await app.listen({ port });
-    const address = app.server.address();
-    console.log(`Server listening on ${_optionalChain([address, 'optionalAccess', _ => _.address])}:${_optionalChain([address, 'optionalAccess', _2 => _2.port])}`);
-  } catch (err) {
-    app.log.error(err);
-    process.exit(1);
-  }
+Object.defineProperty(exports, Symbol.toStringTag, { value: 'Module' });
+//#region \0rolldown/runtime.js
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") {
+		for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+			key = keys[i];
+			if (!__hasOwnProp.call(to, key) && key !== except) {
+				__defProp(to, key, {
+					get: ((k) => from[k]).bind(null, key),
+					enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+				});
+			}
+		}
+	}
+	return to;
 };
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 
+//#endregion
+let _fastify_compress = require("@fastify/compress");
+_fastify_compress = __toESM(_fastify_compress, 1);
+let _fastify_etag = require("@fastify/etag");
+_fastify_etag = __toESM(_fastify_etag, 1);
+let _fastify_formbody = require("@fastify/formbody");
+_fastify_formbody = __toESM(_fastify_formbody, 1);
+let close_with_grace = require("close-with-grace");
+close_with_grace = __toESM(close_with_grace, 1);
+let fastify = require("fastify");
+fastify = __toESM(fastify, 1);
 
+//#region src/index.ts
+const defaultPlugins = [
+	{
+		plugin: _fastify_etag.default,
+		options: {}
+	},
+	{
+		plugin: _fastify_compress.default,
+		options: { global: false }
+	},
+	{
+		plugin: _fastify_formbody.default,
+		options: {}
+	}
+];
+const getApplication = async (options) => {
+	const { registerRoutes, activeDefaultPlugins = defaultPlugins, serverOptions = { logger: true } } = options;
+	const app = (0, fastify.default)(serverOptions);
+	await Promise.all(activeDefaultPlugins.map(async ({ plugin, options }) => {
+		await app.register(plugin, options);
+	}));
+	if (registerRoutes) registerRoutes(app);
+	const closeListeners = (0, close_with_grace.default)({ delay: 500 }, async (opts) => {
+		if (opts.err) app.log.error(opts.err);
+		await app.close();
+	});
+	app.addHook("onClose", (instance, done) => {
+		closeListeners.uninstall();
+		done();
+	});
+	return app;
+};
+const startAPI = async (app, options = { port: 5e3 }) => {
+	const { port } = options;
+	try {
+		await app.listen({ port });
+		const address = app.server.address();
+		console.log(`Server listening on ${address?.address}:${address?.port}`);
+	} catch (err) {
+		app.log.error(err);
+		process.exit(1);
+	}
+};
 
-exports.getApplication = getApplication; exports.startAPI = startAPI;
+//#endregion
+exports.getApplication = getApplication;
+exports.startAPI = startAPI;
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["/home/runner/work/emmett/emmett/src/packages/emmett-fastify/dist/index.cjs","../src/index.ts"],"names":["options"],"mappings":"AAAA;ACAA,iGAAsD;AACtD,iFAA8C;AAC9C,iGAAkD;AAClD,kHAA2B;AAC3B,oFAKO;AAQP,IAAM,eAAA,EAA2B;AAAA,EAC/B,EAAE,MAAA,EAAQ,cAAA,EAAM,OAAA,EAAS,CAAC,EAAwB,CAAA;AAAA,EAClD,EAAE,MAAA,EAAQ,kBAAA,EAAU,OAAA,EAAS,EAAE,MAAA,EAAQ,MAAM,EAA4B,CAAA;AAAA,EACzE,EAAE,MAAA,EAAQ,kBAAA,EAAM,OAAA,EAAS,CAAC,EAA4B;AACxD,CAAA;AAQO,IAAM,eAAA,EAAiB,MAAA,CAAO,OAAA,EAAA,GAAgC;AACnE,EAAA,MAAM;AAAA,IACJ,cAAA;AAAA,IACA,qBAAA,EAAuB,cAAA;AAAA,IACvB,cAAA,EAAgB;AAAA,MACd,MAAA,EAAQ;AAAA,IACV;AAAA,EACF,EAAA,EAAI,OAAA;AAEJ,EAAA,MAAM,IAAA,EAAuB,+BAAA,aAAqB,CAAA;AAElD,EAAA,MAAM,OAAA,CAAQ,GAAA;AAAA,IACZ,oBAAA,CAAqB,GAAA,CAAI,MAAA,CAAO,EAAE,MAAA,EAAQ,OAAA,EAAAA,SAAQ,CAAA,EAAA,GAAM;AACtD,MAAA,MAAM,GAAA,CAAI,QAAA,CAAS,MAAA,EAAQA,QAAO,CAAA;AAAA,IACpC,CAAC;AAAA,EACH,CAAA;AAEA,EAAA,GAAA,CAAI,cAAA,EAAgB;AAClB,IAAA,cAAA,CAAe,GAAG,CAAA;AAAA,EACpB;AAEA,EAAA,MAAM,eAAA,EAAiB,sCAAA,EAAiB,KAAA,EAAO,IAAI,CAAA,EAAG,MAAA,CAAO,IAAA,EAAA,GAAS;AACpE,IAAA,GAAA,CAAI,IAAA,CAAK,GAAA,EAAK;AACZ,MAAA,GAAA,CAAI,GAAA,CAAI,KAAA,CAAM,IAAA,CAAK,GAAG,CAAA;AAAA,IACxB;AAEA,IAAA,MAAM,GAAA,CAAI,KAAA,CAAM,CAAA;AAAA,EAClB,CAAC,CAAA;AAED,EAAA,GAAA,CAAI,OAAA,CAAQ,SAAA,EAAW,CAAC,QAAA,EAAU,IAAA,EAAA,GAAS;AACzC,IAAA,cAAA,CAAe,SAAA,CAAU,CAAA;AACzB,IAAA,IAAA,CAAK,CAAA;AAAA,EACP,CAAC,CAAA;AAED,EAAA,OAAO,GAAA;AACT,CAAA;AAMO,IAAM,SAAA,EAAW,MAAA,CACtB,GAAA,EACA,QAAA,EAA2B,EAAE,IAAA,EAAM,IAAK,CAAA,EAAA,GACrC;AACH,EAAA,MAAM,EAAE,KAAK,EAAA,EAAI,OAAA;AACjB,EAAA,IAAI;AACF,IAAA,MAAM,GAAA,CAAI,MAAA,CAAO,EAAE,KAAK,CAAC,CAAA;AACzB,IAAA,MAAM,QAAA,EAAU,GAAA,CAAI,MAAA,CAAO,OAAA,CAAQ,CAAA;AAEnC,IAAA,OAAA,CAAQ,GAAA,CAAI,CAAA,oBAAA,kBAAuB,OAAA,2BAAS,SAAO,CAAA,CAAA,kBAAI,OAAA,6BAAS,MAAI,CAAA,CAAA;AACxD,EAAA;AACK,IAAA;AACH,IAAA;AAChB,EAAA;AACF;ADjCyE;AACA;AACA;AACA","file":"/home/runner/work/emmett/emmett/src/packages/emmett-fastify/dist/index.cjs","sourcesContent":[null,"import Compress, { type FastifyCompressOptions } from '@fastify/compress';\nimport Etag, { type FastifyEtagOptions } from '@fastify/etag';\nimport Form, { type FastifyFormbodyOptions } from '@fastify/formbody';\nimport closeWithGrace from 'close-with-grace';\nimport Fastify, {\n  type FastifyInstance,\n  type FastifyPluginAsync,\n  type FastifyPluginCallback,\n  type FastifyPluginOptions,\n} from 'fastify';\n\n// TODO: THIS WILL NEED TO BE BETTER TYPED\ntype Plugin = {\n  plugin: FastifyPluginAsync | FastifyPluginCallback;\n  options: FastifyPluginOptions;\n};\n\nconst defaultPlugins: Plugin[] = [\n  { plugin: Etag, options: {} as FastifyEtagOptions },\n  { plugin: Compress, options: { global: false } as FastifyCompressOptions },\n  { plugin: Form, options: {} as FastifyFormbodyOptions },\n];\n\nexport interface ApplicationOptions {\n  serverOptions?: { logger: boolean };\n  registerRoutes?: (app: FastifyInstance) => void;\n  activeDefaultPlugins?: Plugin[];\n}\n\nexport const getApplication = async (options: ApplicationOptions) => {\n  const {\n    registerRoutes,\n    activeDefaultPlugins = defaultPlugins,\n    serverOptions = {\n      logger: true,\n    },\n  } = options;\n\n  const app: FastifyInstance = Fastify(serverOptions);\n\n  await Promise.all(\n    activeDefaultPlugins.map(async ({ plugin, options }) => {\n      await app.register(plugin, options);\n    }),\n  );\n\n  if (registerRoutes) {\n    registerRoutes(app);\n  }\n\n  const closeListeners = closeWithGrace({ delay: 500 }, async (opts) => {\n    if (opts.err) {\n      app.log.error(opts.err);\n    }\n\n    await app.close();\n  });\n\n  app.addHook('onClose', (instance, done) => {\n    closeListeners.uninstall();\n    done();\n  });\n\n  return app;\n};\n\nexport type StartApiOptions = {\n  port?: number;\n};\n\nexport const startAPI = async (\n  app: FastifyInstance,\n  options: StartApiOptions = { port: 5000 },\n) => {\n  const { port } = options;\n  try {\n    await app.listen({ port });\n    const address = app.server.address() as { address: string; port: number };\n\n    console.log(`Server listening on ${address?.address}:${address?.port}`);\n  } catch (err) {\n    app.log.error(err);\n    process.exit(1);\n  }\n};\n"]}
+{"version":3,"file":"index.cjs","names":["Etag","Compress","Form"],"sources":["../src/index.ts"],"sourcesContent":["import Compress from '@fastify/compress';\nimport Etag from '@fastify/etag';\nimport Form from '@fastify/formbody';\nimport closeWithGrace from 'close-with-grace';\nimport Fastify, {\n  type FastifyInstance,\n  type FastifyPluginAsync,\n  type FastifyPluginCallback,\n  type FastifyPluginOptions,\n} from 'fastify';\n\n// TODO: THIS WILL NEED TO BE BETTER TYPED\ntype Plugin = {\n  plugin: FastifyPluginAsync | FastifyPluginCallback;\n  options: FastifyPluginOptions;\n};\n\nconst defaultPlugins: Plugin[] = [\n  { plugin: Etag, options: {} },\n  { plugin: Compress, options: { global: false } },\n  { plugin: Form, options: {} },\n];\n\nexport interface ApplicationOptions {\n  serverOptions?: { logger: boolean };\n  registerRoutes?: (app: FastifyInstance) => void;\n  activeDefaultPlugins?: Plugin[];\n}\n\nexport const getApplication = async (options: ApplicationOptions) => {\n  const {\n    registerRoutes,\n    activeDefaultPlugins = defaultPlugins,\n    serverOptions = {\n      logger: true,\n    },\n  } = options;\n\n  const app: FastifyInstance = Fastify(serverOptions);\n\n  await Promise.all(\n    activeDefaultPlugins.map(async ({ plugin, options }) => {\n      await app.register(plugin, options);\n    }),\n  );\n\n  if (registerRoutes) {\n    registerRoutes(app);\n  }\n\n  const closeListeners = closeWithGrace({ delay: 500 }, async (opts) => {\n    if (opts.err) {\n      app.log.error(opts.err);\n    }\n\n    await app.close();\n  });\n\n  app.addHook('onClose', (instance, done) => {\n    closeListeners.uninstall();\n    done();\n  });\n\n  return app;\n};\n\nexport type StartApiOptions = {\n  port?: number;\n};\n\nexport const startAPI = async (\n  app: FastifyInstance,\n  options: StartApiOptions = { port: 5000 },\n) => {\n  const { port } = options;\n  try {\n    await app.listen({ port });\n    const address = app.server.address() as { address: string; port: number };\n\n    console.log(`Server listening on ${address?.address}:${address?.port}`);\n  } catch (err) {\n    app.log.error(err);\n    process.exit(1);\n  }\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBA,MAAM,iBAA2B;CAC/B;EAAE,QAAQA;EAAM,SAAS,EAAE;EAAE;CAC7B;EAAE,QAAQC;EAAU,SAAS,EAAE,QAAQ,OAAO;EAAE;CAChD;EAAE,QAAQC;EAAM,SAAS,EAAE;EAAE;CAC9B;AAQD,MAAa,iBAAiB,OAAO,YAAgC;CACnE,MAAM,EACJ,gBACA,uBAAuB,gBACvB,gBAAgB,EACd,QAAQ,MACT,KACC;CAEJ,MAAM,2BAA+B,cAAc;AAEnD,OAAM,QAAQ,IACZ,qBAAqB,IAAI,OAAO,EAAE,QAAQ,cAAc;AACtD,QAAM,IAAI,SAAS,QAAQ,QAAQ;GACnC,CACH;AAED,KAAI,eACF,gBAAe,IAAI;CAGrB,MAAM,+CAAgC,EAAE,OAAO,KAAK,EAAE,OAAO,SAAS;AACpE,MAAI,KAAK,IACP,KAAI,IAAI,MAAM,KAAK,IAAI;AAGzB,QAAM,IAAI,OAAO;GACjB;AAEF,KAAI,QAAQ,YAAY,UAAU,SAAS;AACzC,iBAAe,WAAW;AAC1B,QAAM;GACN;AAEF,QAAO;;AAOT,MAAa,WAAW,OACtB,KACA,UAA2B,EAAE,MAAM,KAAM,KACtC;CACH,MAAM,EAAE,SAAS;AACjB,KAAI;AACF,QAAM,IAAI,OAAO,EAAE,MAAM,CAAC;EAC1B,MAAM,UAAU,IAAI,OAAO,SAAS;AAEpC,UAAQ,IAAI,uBAAuB,SAAS,QAAQ,GAAG,SAAS,OAAO;UAChE,KAAK;AACZ,MAAI,IAAI,MAAM,IAAI;AAClB,UAAQ,KAAK,EAAE"}

package/dist/index.d.cts

@@ -1,22 +1,24 @@
-import * as node_http from 'node:http';
-import * as fastify from 'fastify';
-import { FastifyInstance, FastifyPluginAsync, FastifyPluginCallback, FastifyPluginOptions } from 'fastify';
+import * as _$fastify from "fastify";
+import { FastifyInstance, FastifyPluginAsync, FastifyPluginCallback, FastifyPluginOptions } from "fastify";
+import * as _$node_http0 from "node:http";
 
+//#region src/index.d.ts
 type Plugin = {
-    plugin: FastifyPluginAsync | FastifyPluginCallback;
-    options: FastifyPluginOptions;
+  plugin: FastifyPluginAsync | FastifyPluginCallback;
+  options: FastifyPluginOptions;
 };
 interface ApplicationOptions {
-    serverOptions?: {
-        logger: boolean;
-    };
-    registerRoutes?: (app: FastifyInstance) => void;
-    activeDefaultPlugins?: Plugin[];
+  serverOptions?: {
+    logger: boolean;
+  };
+  registerRoutes?: (app: FastifyInstance) => void;
+  activeDefaultPlugins?: Plugin[];
 }
-declare const getApplication: (options: ApplicationOptions) => Promise<FastifyInstance<fastify.RawServerDefault, node_http.IncomingMessage, node_http.ServerResponse<node_http.IncomingMessage>, fastify.FastifyBaseLogger, fastify.FastifyTypeProviderDefault>>;
+declare const getApplication: (options: ApplicationOptions) => Promise<FastifyInstance<_$fastify.RawServerDefault, _$node_http0.IncomingMessage, _$node_http0.ServerResponse<_$node_http0.IncomingMessage>, _$fastify.FastifyBaseLogger, _$fastify.FastifyTypeProviderDefault>>;
 type StartApiOptions = {
-    port?: number;
+  port?: number;
 };
 declare const startAPI: (app: FastifyInstance, options?: StartApiOptions) => Promise<void>;
-
-export { type ApplicationOptions, type StartApiOptions, getApplication, startAPI };
+//#endregion
+export { ApplicationOptions, StartApiOptions, getApplication, startAPI };
+//# sourceMappingURL=index.d.cts.map

package/dist/index.d.ts

@@ -1,22 +1,24 @@
-import * as node_http from 'node:http';
-import * as fastify from 'fastify';
-import { FastifyInstance, FastifyPluginAsync, FastifyPluginCallback, FastifyPluginOptions } from 'fastify';
+import * as _$fastify from "fastify";
+import { FastifyInstance, FastifyPluginAsync, FastifyPluginCallback, FastifyPluginOptions } from "fastify";
+import * as _$node_http0 from "node:http";
 
+//#region src/index.d.ts
 type Plugin = {
-    plugin: FastifyPluginAsync | FastifyPluginCallback;
-    options: FastifyPluginOptions;
+  plugin: FastifyPluginAsync | FastifyPluginCallback;
+  options: FastifyPluginOptions;
 };
 interface ApplicationOptions {
-    serverOptions?: {
-        logger: boolean;
-    };
-    registerRoutes?: (app: FastifyInstance) => void;
-    activeDefaultPlugins?: Plugin[];
+  serverOptions?: {
+    logger: boolean;
+  };
+  registerRoutes?: (app: FastifyInstance) => void;
+  activeDefaultPlugins?: Plugin[];
 }
-declare const getApplication: (options: ApplicationOptions) => Promise<FastifyInstance<fastify.RawServerDefault, node_http.IncomingMessage, node_http.ServerResponse<node_http.IncomingMessage>, fastify.FastifyBaseLogger, fastify.FastifyTypeProviderDefault>>;
+declare const getApplication: (options: ApplicationOptions) => Promise<FastifyInstance<_$fastify.RawServerDefault, _$node_http0.IncomingMessage, _$node_http0.ServerResponse<_$node_http0.IncomingMessage>, _$fastify.FastifyBaseLogger, _$fastify.FastifyTypeProviderDefault>>;
 type StartApiOptions = {
-    port?: number;
+  port?: number;
 };
 declare const startAPI: (app: FastifyInstance, options?: StartApiOptions) => Promise<void>;
-
-export { type ApplicationOptions, type StartApiOptions, getApplication, startAPI };
+//#endregion
+export { ApplicationOptions, StartApiOptions, getApplication, startAPI };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,56 +1,53 @@
-// src/index.ts
 import Compress from "@fastify/compress";
 import Etag from "@fastify/etag";
 import Form from "@fastify/formbody";
 import closeWithGrace from "close-with-grace";
 import Fastify from "fastify";
-var defaultPlugins = [
-  { plugin: Etag, options: {} },
-  { plugin: Compress, options: { global: false } },
-  { plugin: Form, options: {} }
+
+//#region src/index.ts
+const defaultPlugins = [
+	{
+		plugin: Etag,
+		options: {}
+	},
+	{
+		plugin: Compress,
+		options: { global: false }
+	},
+	{
+		plugin: Form,
+		options: {}
+	}
 ];
-var getApplication = async (options) => {
-  const {
-    registerRoutes,
-    activeDefaultPlugins = defaultPlugins,
-    serverOptions = {
-      logger: true
-    }
-  } = options;
-  const app = Fastify(serverOptions);
-  await Promise.all(
-    activeDefaultPlugins.map(async ({ plugin, options: options2 }) => {
-      await app.register(plugin, options2);
-    })
-  );
-  if (registerRoutes) {
-    registerRoutes(app);
-  }
-  const closeListeners = closeWithGrace({ delay: 500 }, async (opts) => {
-    if (opts.err) {
-      app.log.error(opts.err);
-    }
-    await app.close();
-  });
-  app.addHook("onClose", (instance, done) => {
-    closeListeners.uninstall();
-    done();
-  });
-  return app;
+const getApplication = async (options) => {
+	const { registerRoutes, activeDefaultPlugins = defaultPlugins, serverOptions = { logger: true } } = options;
+	const app = Fastify(serverOptions);
+	await Promise.all(activeDefaultPlugins.map(async ({ plugin, options }) => {
+		await app.register(plugin, options);
+	}));
+	if (registerRoutes) registerRoutes(app);
+	const closeListeners = closeWithGrace({ delay: 500 }, async (opts) => {
+		if (opts.err) app.log.error(opts.err);
+		await app.close();
+	});
+	app.addHook("onClose", (instance, done) => {
+		closeListeners.uninstall();
+		done();
+	});
+	return app;
 };
-var startAPI = async (app, options = { port: 5e3 }) => {
-  const { port } = options;
-  try {
-    await app.listen({ port });
-    const address = app.server.address();
-    console.log(`Server listening on ${address?.address}:${address?.port}`);
-  } catch (err) {
-    app.log.error(err);
-    process.exit(1);
-  }
-};
-export {
-  getApplication,
-  startAPI
+const startAPI = async (app, options = { port: 5e3 }) => {
+	const { port } = options;
+	try {
+		await app.listen({ port });
+		const address = app.server.address();
+		console.log(`Server listening on ${address?.address}:${address?.port}`);
+	} catch (err) {
+		app.log.error(err);
+		process.exit(1);
+	}
 };
+
+//#endregion
+export { getApplication, startAPI };
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts"],"sourcesContent":["import Compress, { type FastifyCompressOptions } from '@fastify/compress';\nimport Etag, { type FastifyEtagOptions } from '@fastify/etag';\nimport Form, { type FastifyFormbodyOptions } from '@fastify/formbody';\nimport closeWithGrace from 'close-with-grace';\nimport Fastify, {\n  type FastifyInstance,\n  type FastifyPluginAsync,\n  type FastifyPluginCallback,\n  type FastifyPluginOptions,\n} from 'fastify';\n\n// TODO: THIS WILL NEED TO BE BETTER TYPED\ntype Plugin = {\n  plugin: FastifyPluginAsync | FastifyPluginCallback;\n  options: FastifyPluginOptions;\n};\n\nconst defaultPlugins: Plugin[] = [\n  { plugin: Etag, options: {} as FastifyEtagOptions },\n  { plugin: Compress, options: { global: false } as FastifyCompressOptions },\n  { plugin: Form, options: {} as FastifyFormbodyOptions },\n];\n\nexport interface ApplicationOptions {\n  serverOptions?: { logger: boolean };\n  registerRoutes?: (app: FastifyInstance) => void;\n  activeDefaultPlugins?: Plugin[];\n}\n\nexport const getApplication = async (options: ApplicationOptions) => {\n  const {\n    registerRoutes,\n    activeDefaultPlugins = defaultPlugins,\n    serverOptions = {\n      logger: true,\n    },\n  } = options;\n\n  const app: FastifyInstance = Fastify(serverOptions);\n\n  await Promise.all(\n    activeDefaultPlugins.map(async ({ plugin, options }) => {\n      await app.register(plugin, options);\n    }),\n  );\n\n  if (registerRoutes) {\n    registerRoutes(app);\n  }\n\n  const closeListeners = closeWithGrace({ delay: 500 }, async (opts) => {\n    if (opts.err) {\n      app.log.error(opts.err);\n    }\n\n    await app.close();\n  });\n\n  app.addHook('onClose', (instance, done) => {\n    closeListeners.uninstall();\n    done();\n  });\n\n  return app;\n};\n\nexport type StartApiOptions = {\n  port?: number;\n};\n\nexport const startAPI = async (\n  app: FastifyInstance,\n  options: StartApiOptions = { port: 5000 },\n) => {\n  const { port } = options;\n  try {\n    await app.listen({ port });\n    const address = app.server.address() as { address: string; port: number };\n\n    console.log(`Server listening on ${address?.address}:${address?.port}`);\n  } catch (err) {\n    app.log.error(err);\n    process.exit(1);\n  }\n};\n"],"mappings":";AAAA,OAAO,cAA+C;AACtD,OAAO,UAAuC;AAC9C,OAAO,UAA2C;AAClD,OAAO,oBAAoB;AAC3B,OAAO,aAKA;AAQP,IAAM,iBAA2B;AAAA,EAC/B,EAAE,QAAQ,MAAM,SAAS,CAAC,EAAwB;AAAA,EAClD,EAAE,QAAQ,UAAU,SAAS,EAAE,QAAQ,MAAM,EAA4B;AAAA,EACzE,EAAE,QAAQ,MAAM,SAAS,CAAC,EAA4B;AACxD;AAQO,IAAM,iBAAiB,OAAO,YAAgC;AACnE,QAAM;AAAA,IACJ;AAAA,IACA,uBAAuB;AAAA,IACvB,gBAAgB;AAAA,MACd,QAAQ;AAAA,IACV;AAAA,EACF,IAAI;AAEJ,QAAM,MAAuB,QAAQ,aAAa;AAElD,QAAM,QAAQ;AAAA,IACZ,qBAAqB,IAAI,OAAO,EAAE,QAAQ,SAAAA,SAAQ,MAAM;AACtD,YAAM,IAAI,SAAS,QAAQA,QAAO;AAAA,IACpC,CAAC;AAAA,EACH;AAEA,MAAI,gBAAgB;AAClB,mBAAe,GAAG;AAAA,EACpB;AAEA,QAAM,iBAAiB,eAAe,EAAE,OAAO,IAAI,GAAG,OAAO,SAAS;AACpE,QAAI,KAAK,KAAK;AACZ,UAAI,IAAI,MAAM,KAAK,GAAG;AAAA,IACxB;AAEA,UAAM,IAAI,MAAM;AAAA,EAClB,CAAC;AAED,MAAI,QAAQ,WAAW,CAAC,UAAU,SAAS;AACzC,mBAAe,UAAU;AACzB,SAAK;AAAA,EACP,CAAC;AAED,SAAO;AACT;AAMO,IAAM,WAAW,OACtB,KACA,UAA2B,EAAE,MAAM,IAAK,MACrC;AACH,QAAM,EAAE,KAAK,IAAI;AACjB,MAAI;AACF,UAAM,IAAI,OAAO,EAAE,KAAK,CAAC;AACzB,UAAM,UAAU,IAAI,OAAO,QAAQ;AAEnC,YAAQ,IAAI,uBAAuB,SAAS,OAAO,IAAI,SAAS,IAAI,EAAE;AAAA,EACxE,SAAS,KAAK;AACZ,QAAI,IAAI,MAAM,GAAG;AACjB,YAAQ,KAAK,CAAC;AAAA,EAChB;AACF;","names":["options"]}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import Compress from '@fastify/compress';\nimport Etag from '@fastify/etag';\nimport Form from '@fastify/formbody';\nimport closeWithGrace from 'close-with-grace';\nimport Fastify, {\n  type FastifyInstance,\n  type FastifyPluginAsync,\n  type FastifyPluginCallback,\n  type FastifyPluginOptions,\n} from 'fastify';\n\n// TODO: THIS WILL NEED TO BE BETTER TYPED\ntype Plugin = {\n  plugin: FastifyPluginAsync | FastifyPluginCallback;\n  options: FastifyPluginOptions;\n};\n\nconst defaultPlugins: Plugin[] = [\n  { plugin: Etag, options: {} },\n  { plugin: Compress, options: { global: false } },\n  { plugin: Form, options: {} },\n];\n\nexport interface ApplicationOptions {\n  serverOptions?: { logger: boolean };\n  registerRoutes?: (app: FastifyInstance) => void;\n  activeDefaultPlugins?: Plugin[];\n}\n\nexport const getApplication = async (options: ApplicationOptions) => {\n  const {\n    registerRoutes,\n    activeDefaultPlugins = defaultPlugins,\n    serverOptions = {\n      logger: true,\n    },\n  } = options;\n\n  const app: FastifyInstance = Fastify(serverOptions);\n\n  await Promise.all(\n    activeDefaultPlugins.map(async ({ plugin, options }) => {\n      await app.register(plugin, options);\n    }),\n  );\n\n  if (registerRoutes) {\n    registerRoutes(app);\n  }\n\n  const closeListeners = closeWithGrace({ delay: 500 }, async (opts) => {\n    if (opts.err) {\n      app.log.error(opts.err);\n    }\n\n    await app.close();\n  });\n\n  app.addHook('onClose', (instance, done) => {\n    closeListeners.uninstall();\n    done();\n  });\n\n  return app;\n};\n\nexport type StartApiOptions = {\n  port?: number;\n};\n\nexport const startAPI = async (\n  app: FastifyInstance,\n  options: StartApiOptions = { port: 5000 },\n) => {\n  const { port } = options;\n  try {\n    await app.listen({ port });\n    const address = app.server.address() as { address: string; port: number };\n\n    console.log(`Server listening on ${address?.address}:${address?.port}`);\n  } catch (err) {\n    app.log.error(err);\n    process.exit(1);\n  }\n};\n"],"mappings":";;;;;;;AAiBA,MAAM,iBAA2B;CAC/B;EAAE,QAAQ;EAAM,SAAS,EAAE;EAAE;CAC7B;EAAE,QAAQ;EAAU,SAAS,EAAE,QAAQ,OAAO;EAAE;CAChD;EAAE,QAAQ;EAAM,SAAS,EAAE;EAAE;CAC9B;AAQD,MAAa,iBAAiB,OAAO,YAAgC;CACnE,MAAM,EACJ,gBACA,uBAAuB,gBACvB,gBAAgB,EACd,QAAQ,MACT,KACC;CAEJ,MAAM,MAAuB,QAAQ,cAAc;AAEnD,OAAM,QAAQ,IACZ,qBAAqB,IAAI,OAAO,EAAE,QAAQ,cAAc;AACtD,QAAM,IAAI,SAAS,QAAQ,QAAQ;GACnC,CACH;AAED,KAAI,eACF,gBAAe,IAAI;CAGrB,MAAM,iBAAiB,eAAe,EAAE,OAAO,KAAK,EAAE,OAAO,SAAS;AACpE,MAAI,KAAK,IACP,KAAI,IAAI,MAAM,KAAK,IAAI;AAGzB,QAAM,IAAI,OAAO;GACjB;AAEF,KAAI,QAAQ,YAAY,UAAU,SAAS;AACzC,iBAAe,WAAW;AAC1B,QAAM;GACN;AAEF,QAAO;;AAOT,MAAa,WAAW,OACtB,KACA,UAA2B,EAAE,MAAM,KAAM,KACtC;CACH,MAAM,EAAE,SAAS;AACjB,KAAI;AACF,QAAM,IAAI,OAAO,EAAE,MAAM,CAAC;EAC1B,MAAM,UAAU,IAAI,OAAO,SAAS;AAEpC,UAAQ,IAAI,uBAAuB,SAAS,QAAQ,GAAG,SAAS,OAAO;UAChE,KAAK;AACZ,MAAI,IAAI,MAAM,IAAI;AAClB,UAAQ,KAAK,EAAE"}

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@event-driven-io/emmett-fastify",
-  "version": "0.43.0-beta.12",
+  "version": "0.43.0-beta.14",
   "type": "module",
   "description": "Emmett - Event Sourcing development made simple",
   "scripts": {
-    "build": "tsup",
+    "build": "tsdown",
     "build:ts": "tsc",
     "build:ts:watch": "tsc -b --watch",
     "test": "run-s test:unit test:int test:e2e",
@@ -53,11 +53,11 @@
   "dependencies": {},
   "devDependencies": {},
   "peerDependencies": {
-    "@event-driven-io/emmett": "0.43.0-beta.12",
-    "fastify": "^5.7.2",
+    "@event-driven-io/emmett": "0.43.0-beta.14",
+    "fastify": "^5.8.5",
     "@fastify/compress": "^8.3.1",
     "@fastify/etag": "^6.1.0",
     "@fastify/formbody": "^8.0.2",
-    "close-with-grace": "^2.4.0"
+    "close-with-grace": "^2.5.0"
   }
 }