@coherent.js/fastify 1.0.0-beta.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Thomas Drouvin
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,70 @@
+# @coherent.js/fastify
+
+[![npm version](https://img.shields.io/npm/v/@coherent.js/fastify.svg)](https://www.npmjs.com/package/@coherent.js/fastify)
+[![license: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](../../LICENSE)
+[![Node >= 20](https://img.shields.io/badge/node-%3E%3D20-brightgreen)](https://nodejs.org)
+
+Fastify adapter for Coherent.js.
+
+- ESM-only, Node 20+
+- Works with `fastify@4.x`
+- Designed to pair with `@coherent.js/core`
+
+For a high-level overview and repository-wide instructions, see the root README: ../../README.md
+
+## Installation
+
+```bash
+pnpm add @coherent.js/fastify fastify @coherent.js/core
+```
+
+Peer dependencies:
+- `fastify` >= 4 < 6
+- `@coherent.js/core`
+
+## Quick start
+
+You can use `@coherent.js/core` rendering inside Fastify route handlers.
+
+JavaScript (ESM):
+```js
+import Fastify from 'fastify';
+import { renderToString } from '@coherent.js/core';
+
+const app = Fastify();
+
+app.get('/', async (_req, reply) => {
+  const html = await renderToString({ div: { text: 'Hello from Fastify + Coherent' } });
+  reply.type('text/html').send(html);
+});
+
+app.listen({ port: 3000 });
+```
+
+TypeScript:
+```ts
+import Fastify, { FastifyRequest, FastifyReply } from 'fastify';
+import { renderToString } from '@coherent.js/core';
+
+const app = Fastify();
+
+app.get('/', async (_req: FastifyRequest, reply: FastifyReply) => {
+  const html = await renderToString({ div: { text: 'Hello TS' } });
+  reply.type('text/html').send(html);
+});
+
+app.listen({ port: 3000 });
+```
+
+## Development
+
+```bash
+pnpm --filter @coherent.js/fastify run test
+pnpm --filter @coherent.js/fastify run test:watch
+pnpm --filter @coherent.js/fastify run typecheck
+pnpm --filter @coherent.js/fastify run build
+```
+
+## License
+
+MIT © Coherent.js Team

package/dist/fastify/coherent-fastify.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Fastify plugin for Coherent.js
+ * Automatically renders Coherent.js components and handles errors
+ *
+ * @param {Object} fastify - Fastify instance
+ * @param {Object} options - Plugin options
+ * @param {boolean} options.enablePerformanceMonitoring - Enable performance monitoring
+ * @param {string} options.template - HTML template with {{content}} placeholder
+ * @param {Function} done - Callback to signal plugin registration completion
+ */
+export function coherentFastify(fastify: Object, options: {
+    enablePerformanceMonitoring: boolean;
+    template: string;
+}, done: Function): void;
+/**
+ * Create a Fastify route handler for Coherent.js components
+ *
+ * @param {Function} componentFactory - Function that returns a Coherent.js component
+ * @param {Object} options - Handler options
+ * @returns {Function} Fastify route handler
+ */
+export function createCoherentFastifyHandler(componentFactory: Function, options?: Object): Function;
+/**
+ * Setup Coherent.js with Fastify instance
+ *
+ * @param {Object} fastify - Fastify instance
+ * @param {Object} options - Setup options
+ */
+export function setupCoherentFastify(fastify: Object, options?: Object): void;
+export default coherentFastify;
+//# sourceMappingURL=coherent-fastify.d.ts.map

package/dist/fastify/coherent-fastify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"coherent-fastify.d.ts","sourceRoot":"","sources":["../../../../src/fastify/coherent-fastify.js"],"names":[],"mappings":"AAQA;;;;;;;;;GASG;AACH,yCANW,MAAM,WAEd;IAAyB,2BAA2B,EAA5C,OAAO;IACS,QAAQ,EAAxB,MAAM;CACd,wBAmFF;AAED;;;;;;GAMG;AACH,mFAHW,MAAM,YAyChB;AAED;;;;;GAKG;AACH,8CAHW,MAAM,YACN,MAAM,QAIhB"}

package/dist/fastify/coherent-fastify.js

@@ -0,0 +1,133 @@
+/**
+ * Fastify integration for Coherent.js
+ * Provides plugins and utilities for using Coherent.js with Fastify
+ */
+import { renderToString } from '../rendering/html-renderer.js';
+import { performanceMonitor } from '../performance/monitor.js';
+/**
+ * Fastify plugin for Coherent.js
+ * Automatically renders Coherent.js components and handles errors
+ *
+ * @param {Object} fastify - Fastify instance
+ * @param {Object} options - Plugin options
+ * @param {boolean} options.enablePerformanceMonitoring - Enable performance monitoring
+ * @param {string} options.template - HTML template with {{content}} placeholder
+ * @param {Function} done - Callback to signal plugin registration completion
+ */
+export function coherentFastify(fastify, options, done) {
+    const { enablePerformanceMonitoring = false, template = '<!DOCTYPE html>\n{{content}}' } = options;
+    // Add decorator to check if an object is a Coherent.js component
+    fastify.decorateReply('isCoherentObject', (obj) => {
+        if (!obj || typeof obj !== 'object' || Array.isArray(obj)) {
+            return false;
+        }
+        const keys = Object.keys(obj);
+        return keys.length === 1;
+    });
+    // Add decorator for rendering Coherent.js components
+    fastify.decorateReply('coherent', function (component, renderOptions = {}) {
+        const { enablePerformanceMonitoring: renderPerformanceMonitoring = enablePerformanceMonitoring, template: renderTemplate = template } = renderOptions;
+        try {
+            let html;
+            if (renderPerformanceMonitoring) {
+                const renderId = performanceMonitor.startRender();
+                html = renderToString(component);
+                performanceMonitor.endRender(renderId);
+            }
+            else {
+                html = renderToString(component);
+            }
+            // Apply template
+            const finalHtml = renderTemplate.replace('{{content}}', html);
+            // Set content type and send HTML
+            this.header('Content-Type', 'text/html; charset=utf-8');
+            this.send(finalHtml);
+        }
+        catch (error) {
+            console.error('Coherent.js rendering error:', error);
+            this.status(500).send({
+                error: 'Internal Server Error',
+                message: error.message
+            });
+        }
+    });
+    // Hook to automatically render Coherent.js objects
+    fastify.addHook('onSend', async (request, reply, payload) => {
+        // If payload is a Coherent.js object, render it
+        if (reply.isCoherentObject(payload)) {
+            try {
+                let html;
+                if (enablePerformanceMonitoring) {
+                    const renderId = performanceMonitor.startRender();
+                    html = renderToString(payload);
+                    performanceMonitor.endRender(renderId);
+                }
+                else {
+                    html = renderToString(payload);
+                }
+                // Apply template
+                const finalHtml = template.replace('{{content}}', html);
+                // Set content type and return HTML
+                reply.header('Content-Type', 'text/html; charset=utf-8');
+                return finalHtml;
+            }
+            catch (error) {
+                console.error('Coherent.js rendering error:', error);
+                throw error;
+            }
+        }
+        // For non-Coherent.js data, return as-is
+        return payload;
+    });
+    done();
+}
+/**
+ * Create a Fastify route handler for Coherent.js components
+ *
+ * @param {Function} componentFactory - Function that returns a Coherent.js component
+ * @param {Object} options - Handler options
+ * @returns {Function} Fastify route handler
+ */
+export function createCoherentFastifyHandler(componentFactory, options = {}) {
+    const { enablePerformanceMonitoring = false, template = '<!DOCTYPE html>\n{{content}}' } = options;
+    return async (request, reply) => {
+        try {
+            // Create component with request data
+            const component = await Promise.resolve(componentFactory(request, reply));
+            if (!component) {
+                throw new Error('Component factory returned null/undefined');
+            }
+            // Render component
+            let html;
+            if (enablePerformanceMonitoring) {
+                const renderId = performanceMonitor.startRender();
+                html = renderToString(component);
+                performanceMonitor.endRender(renderId);
+            }
+            else {
+                html = renderToString(component);
+            }
+            // Apply template
+            const finalHtml = template.replace('{{content}}', html);
+            // Send HTML response
+            reply.header('Content-Type', 'text/html; charset=utf-8');
+            return finalHtml;
+        }
+        catch (error) {
+            console.error('Coherent.js handler error:', error);
+            throw error;
+        }
+    };
+}
+/**
+ * Setup Coherent.js with Fastify instance
+ *
+ * @param {Object} fastify - Fastify instance
+ * @param {Object} options - Setup options
+ */
+export function setupCoherentFastify(fastify, options = {}) {
+    fastify.register(coherentFastify, options);
+}
+// Export plugin as default for Fastify's plugin system
+export default coherentFastify;
+//# sourceMappingURL=coherent-fastify.js.map

package/dist/fastify/coherent-fastify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"coherent-fastify.js","sourceRoot":"","sources":["../../../../src/fastify/coherent-fastify.js"],"names":[],"mappings":"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"}