datastar-ssegen 0.0.2 → 0.1.0

package/.github/workflows/publish.yml

@@ -1,4 +1,3 @@
-# publish to npm
 name: Publish Package
 on:
   push:
@@ -8,12 +7,12 @@ on:
     types:
       - created
 jobs:
-  publish:
+  publish-npm:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout code
         uses: actions/checkout@v3
-      - name: Setup Node.js environment
+      - name: Setup Node.js environment for npm
         uses: actions/setup-node@v3
         with:
           node-version: '18'

package/README.md

@@ -34,7 +34,7 @@ const app = express();
 app.use(express.json());
 
 app.get('/qoute', (req,res)=> {
-const sse = ServerSentEventGenerator.init(req, res);
+  const sse = ServerSentEventGenerator(req, res);
   const qoutes = [
     "Any app that can be written in JavaScript, will eventually be written in JavaScript. - Jeff Atwood",
     "JavaScript is the world's most misunderstood programming language. - Douglas Crockford",
@@ -46,7 +46,7 @@ const sse = ServerSentEventGenerator.init(req, res);
   res.end();
 });
 app.get('/clock', (req, res)=> {
-  const sse = ServerSentEventGenerator.init(req, res);
+  const sse = ServerSentEventGenerator(req, res);
   setInterval(async () => {
     await sse.MergeFragments(`<div id="clock">Current Time: ${new Date()}</div>`);
   }, 1000);
@@ -84,7 +84,7 @@ Here's a simple HTML page to interact with the server:
 
 The `ServerSentEventGenerator` provides several functions to facilitate communication with connected Datastar clients using Server-Sent Events:
 
-- **`init(request, response)`**: Initializes SSE communication with the specified request and response.
+- **`ServerSentEventGenerator(request, response)`**: Initializes SSE communication with the specified request and response.
 
 - **`_send(eventType, dataLines, sendOptions)`**: Sends a server-sent event (SSE) to the client. Options include setting an `eventId` and defining `retryDuration`.
 

package/examples/commonHandlers.js

@@ -45,7 +45,7 @@ export const homepage = (name = "") => {
 };
 
 export const handleQuote = async (req, res) => {
-  const sse = ServerSentEventGenerator.init(req, res);
+  const sse = ServerSentEventGenerator(req, res);
   const qoutes = [
     "Any app that can be written in JavaScript, will eventually be written in JavaScript. - Jeff Atwood",
     "JavaScript is the world's most misunderstood programming language. - Douglas Crockford",
@@ -58,34 +58,37 @@ export const handleQuote = async (req, res) => {
 };
 
 export const handleReadSignals = async (req, res) => {
-  const sse = ServerSentEventGenerator.init(req, res);
+  console.log(req.method, "readSignals?");
+  const sse = ServerSentEventGenerator(req, res);
   backendStore = await sse.ReadSignals(backendStore);
   console.log("backendStore updated", backendStore);
   res.end();
 };
 
 export const handleRemoveTrash = async (req, res) => {
-  const sse = ServerSentEventGenerator.init(req, res);
+  const sse = ServerSentEventGenerator(req, res);
   await sse.RemoveFragments("#trash");
   await sse.MergeSignals({ lastUpdate: Date.now() });
   res.end();
 };
 
 export const handleExecuteScript = async (req, res) => {
-  const sse = ServerSentEventGenerator.init(req, res);
-  await sse.ExecuteScript(`console.log("Hello from the backend!")`);
+  const sse = ServerSentEventGenerator(req, res);
+  await sse.ExecuteScript(`console.log("Hello from the backend!"); //My comment
+  //What avbout this?
+  console.log('second consolelog on new line');`);
   await sse.MergeSignals({ lastUpdate: Date.now() });
   res.end();
 };
 
 export const handleClock = async function (req, res) {
-  const sse = ServerSentEventGenerator.init(req, res);
+  const sse = ServerSentEventGenerator(req, res);
   setInterval(async () => {
     await sse.MergeFragments(`<div id="clock">${new Date()}</div>`);
   }, 1000);
 };
 
 export const handleRemoveSignal = async (req, res) => {
-  const sse = ServerSentEventGenerator.init(req, res);
+  const sse = ServerSentEventGenerator(req, res);
   await sse.RemoveSignals(["xyz"]);
 };

package/examples/express.example.js

@@ -24,6 +24,7 @@ app.get("/", (req, res) => {
 app.get("/quote", handleQuote);
 
 app.get("/readSignals", handleReadSignals);
+app.post("/readSignals", handleReadSignals);
 
 app.get("/removeTrash", handleRemoveTrash);
 

package/examples/hyper-express.example.js

@@ -22,6 +22,7 @@ server.get("/", (req, res) => {
 server.get("/quote", handleQuote);
 
 server.get("/readSignals", handleReadSignals);
+server.post("/readSignals", handleReadSignals);
 
 server.get("/removeTrash", handleRemoveTrash);
 

package/index.js

@@ -1,273 +1,366 @@
+// @ts-check
 import url from "url";
 import querystring from "querystring";
 
 /**
- * ServerSentEventGenerator is responsible for initializing and handling
- * server-sent events (SSE) for different web frameworks.
+ * @typedef {object} ServerSentEventMethods
+ * @property {Function} _send - Sends a server-sent event.
+ * @property {Function} ReadSignals - Reads signals based on HTTP methods and merges them with predefined signals.
+ * @property {Function} MergeFragments - Sends a merge fragments event with specified options.
+ * @property {Function} RemoveFragments - Sends a remove fragments event.
+ * @property {Function} MergeSignals - Sends a merge signals event, with merging options.
+ * @property {Function} RemoveSignals - Sends a remove signals event, requires signal paths.
+ * @property {Function} ExecuteScript - Executes a defined script on the client-side.
  */
-export const ServerSentEventGenerator = {
-  /**
-   * Initializes the server-sent event generator.
-   *
-   * @param {object} res - The response object from the framework.
-   * @returns {Object} Methods for manipulating server-sent events.
-   */
-  init: function (request, response) {
-    return {
-      headersSent: false,
-      req: request,
-      res: response,
-      /**
-       * @typedef {Object} SendOptions
-       * @property {?string} [eventId=null] - Event ID to attach.
-       * @property {number} [retryDuration=1000] - Retry duration in milliseconds.
-       */
 
-      /**
-       * Sends a server-sent event (SSE) to the client.
-       *
-       * @param {string} eventType - The type of the event.
-       * @param {string[]} dataLines - Lines of data to send.
-       * @param {SendOptions} [sendOptions] - Additional options for sending events.
-       */
-      _send: function (
-        eventType,
-        dataLines,
-        sendOptions = {
-          eventId: null,
-          retryDuration: 1000,
-        }
-      ) {
-        //Prepare the message for sending.
-        let data = dataLines.map((line) => `data: ${line}\n`).join("") + "\n";
-        let eventString = "";
-        if (sendOptions.eventId != null) {
-          eventString += `id: ${sendOptions.eventId}\n`;
-        }
-        if (eventType) {
-          eventString += `event: ${eventType}\n`;
-        }
-        eventString += `retry: ${sendOptions.retryDuration}\n`;
-        eventString += data;
+/**
+ * @typedef {object} SendOptions
+ * @property {number|null} [eventId] - The ID of the event.
+ * @property {number|null} [retryDuration] - Duration in milliseconds to wait before attempting a retry.
+ */
 
-        //Send Event
-        if (!this.headersSent) {
-          this.res.setHeader("Cache-Control", "nocache");
-          this.res.setHeader("Connection", "keep-alive");
-          this.res.setHeader("Content-Type", "text/event-stream");
-          this.headersSent = true;
-        }
-        this.res.write(eventString);
+/**
+ * @typedef {object} MergeFragmentsOptions
+ * @property {string|null} [selector] - CSS selector to scope the merge action.
+ * @property {string} [mergeMode=morph] - Mode to use for merging fragments.
+ * @property {number} [settleDuration=300] - Duration for settling the merge.
+ * @property {boolean|null} [useViewTransition] - Use CSS view transitions if supported.
+ * @property {number|null} [eventId] - Event ID for the merge fragments event.
+ * @property {number|null} [retryDuration] - Retry duration for the event.
+ */
 
-        return eventString;
-      },
+/**
+ * @typedef {object} RemoveFragmentsOptions
+ * @property {number} [settleDuration] - Duration for settling the removal.
+ * @property {boolean|null} [useViewTransition] - Use CSS view transitions if supported.
+ * @property {number|null} [eventId] - Event ID for the remove fragments event.
+ * @property {number|null} [retryDuration] - Retry duration for the event.
+ */
 
-      /**
-       * Reads signals based on HTTP methods and merges them with provided signals.
-       *
-       * @param {object} signals - Predefined signals to merge with.
-       * @returns {Promise<object>} Merged signals object.
-       */
-      ReadSignals: async function (signals) {
-        if (this.req.method === "GET") {
-          // Parse the URL
-          const parsedUrl = url.parse(this.req.url);
-          const parsedQuery = querystring.parse(parsedUrl.query);
-          const datastarParam = parsedQuery.datastar;
+/**
+ * @typedef {object} MergeSignalsOptions
+ * @property {boolean} [onlyIfMissing=false] - Merge only if the signal is missing.
+ * @property {number|null} [eventId] - Event ID for the merge signals event.
+ * @property {number|null} [retryDuration] - Retry duration for the event.
+ */
 
-          const query = JSON.parse(datastarParam);
-          return {
-            ...signals,
-            ...query,
-          };
-        } else {
-          const body = await new Promise((resolve, reject) => {
+/**
+ * @typedef {object} ExecuteScriptOptions
+ * @property {boolean|null} [autoRemove] - Automatically remove the script after execution.
+ * @property {number|null} [eventId] - Event ID for the execute script event.
+ * @property {number|null} [retryDuration] - Retry duration for the event.
+ */
+
+/**
+ * @typedef {Object} HttpRequest
+ * @property {string} method - The HTTP method, e.g., 'GET', 'POST', etc.
+ * @property {string} url - The URL of the request.
+ * @property {Object.<string, string>} headers - The HTTP headers.
+ * @property {Object} [body] - The payload of the request.
+ * @property {Function} [json] - Parses the request body
+ * @property {Function} [on] - Adds event handlers to the request
+ */
+
+/**
+ * @typedef {Object} HttpResponse
+ * @property {number} statusCode - The HTTP status code, e.g., 200, 404, etc.
+ * @property {Object.<string, string>} headers - The HTTP headers.
+ * @property {Object|string} [body] - The response body.
+ * @property {Function} setHeader - Sets a header on the response
+ * @property {Function} write - Writes to the response body
+ */
+
+/**
+ * Initializes the server-sent event generator.
+ *
+ * @param {HttpRequest} request - The request object.
+ * @param {HttpResponse} response - The response object.
+ * @returns {ServerSentEventMethods} Methods for manipulating server-sent events.
+ */
+export function ServerSentEventGenerator(request, response) {
+  const generatorMethods = {
+    headersSent: false,
+    req: request,
+    res: response,
+    /**
+     * Sends a server-sent event (SSE) to the client.
+     *
+     * @param {string} eventType - The type of the event.
+     * @param {string[]} dataLines - Lines of data to send.
+     * @param {SendOptions} [sendOptions] - Additional options for sending events.
+     */
+    _send: function (
+      eventType,
+      dataLines,
+      sendOptions = {
+        eventId: null,
+        retryDuration: 1000,
+      }
+    ) {
+      //Prepare the message for sending.
+      let data = dataLines.map((line) => `data: ${line}\n`).join("") + "\n";
+      let eventString = "";
+      eventString += `comment: "dev"\n`;
+      if (sendOptions.eventId != null) {
+        eventString += `id: ${sendOptions.eventId}\n`;
+      }
+      if (eventType) {
+        eventString += `event: ${eventType}\n`;
+      }
+      eventString += `retry: ${sendOptions.retryDuration}\n`;
+      eventString += data;
+
+      //Send Event
+      if (!this.headersSent) {
+        this.res?.setHeader("Cache-Control", "nocache");
+        this.res?.setHeader("Connection", "keep-alive");
+        this.res?.setHeader("Content-Type", "text/event-stream");
+        this.headersSent = true;
+      }
+      this.res.write(eventString);
+
+      return eventString;
+    },
+
+    /**
+     * Reads signals based on HTTP methods and merges them with provided signals.
+     *
+     * @param {object} signals - Predefined signals to merge with.
+     * @returns {Promise<object>} Merged signals object.
+     */
+    ReadSignals: async function (signals) {
+      if (this.req.method === "GET") {
+        // Parse the URL
+        const parsedUrl = url.parse(this.req.url);
+        const parsedQuery = querystring.parse(parsedUrl.query);
+        const datastarParam = parsedQuery.datastar;
+
+        const query = JSON.parse(datastarParam);
+        return {
+          ...signals,
+          ...query,
+        };
+      } else {
+        let body = this.req?.body;
+        if (this.req?.json) {
+          body = await this.req.json();
+        }
+
+        if (!body) {
+          body = await new Promise((resolve, reject) => {
             let chunks = "";
             this.req.on("data", (chunk) => {
               chunks += chunk;
             });
             this.req.on("end", () => {
-              console.log("No more data in response.");
-              resolve(chunks);
+              resolve(JSON.parse(chunks));
             });
           });
-          let parsedBody = {};
-          try {
-            parsedBody = JSON.parse(body);
-          } catch (err) {
-            console.error(
-              "Problem reading signals, could not parse body as JSON."
-            );
-          }
-          console.log("parsed Body", parsedBody);
-          return { ...signals, ...parsedBody };
         }
-      },
-      /**
-       * @typedef {Object} MergeFragmentsOptions
-       * @property {string} [selector] - CSS selector affected.
-       * @property {string} [mergeMode="morph"] - Mode for merging.
-       * @property {number} [settleDuration=300] - Duration to settle.
-       * @property {?boolean} [useViewTransition=null] - Use view transition.
-       * @property {?string} [eventId=null] - Event ID to attach.
-       * @property {?number} [retryDuration=null] - Retry duration in milliseconds.
-       */
 
-      /**
-       * Sends a merge fragments event.
-       *
-       * @param {string[]} fragments - Array of fragment identifiers.
-       * @param {MergeFragmentsOptions} options - Additional options for merging.
-       * @throws Will throw an error if fragments are missing.
-       */
-      MergeFragments: function (
-        fragments,
-        options = {
-          selector: null,
-          mergeMode: "morph",
-          settleDuration: 300,
-          useViewTransition: null,
-          eventId: null,
-          retryDuration: null,
-        }
-      ) {
-        let dataLines = [];
-        if (options?.selector != null)
-          dataLines.push(`selector ${options.selector}`);
-        if (options?.settleDuration != null)
-          dataLines.push(`settleDuration ${options.settleDuration}`);
-        if (options?.useViewTransition != null)
-          dataLines.push(`useViewTransition ${options.useViewTransition}`);
-        if (fragments) {
-          if (typeof fragments === "string") {
-            // Handle case where 'fragments' is a string
-            dataLines.push(`fragments ${fragments.replace(/[\r\n]+/g, "")}`);
-          } else if (Array.isArray(fragments)) {
-            // Handle case where 'fragments' is an array
-            fragments.forEach((frag) => {
-              dataLines.push(`fragments ${frag.replace(/[\r\n]+/g, "")}`);
-            });
-          } else {
-            throw Error(
-              "Invalid type for fragments. Expected string or array."
-            );
-          }
-        } else {
-          throw Error("MergeFragments missing fragment(s).");
-        }
-        return this._send("datastar-merge-fragments", dataLines, {
-          eventId: options?.eventId,
-          retryDuration: options?.retryDuration,
-        });
-      },
-      /**
-       * @typedef {Object} RemoveFragmentsOptions
-       * @property {number} [settleDuration] - Duration to settle.
-       * @property {?boolean} [useViewTransition=null] - Use view transition.
-       * @property {?string} [eventId=null] - Event ID to attach.
-       * @property {?number} [retryDuration=null] - Retry duration in milliseconds.
-       */
+        return { ...signals, ...body };
+      }
+    },
 
-      /**
-       * Sends a remove fragments event.
-       *
-       * @param {string} selector - CSS selector of fragments to remove.
-       * @param {RemoveFragmentsOptions} options - Additional options for removing.
-       * @throws Will throw an error if selector is missing.
-       */
-      RemoveFragments: function (selector, options) {
-        let dataLines = [];
-        if (selector) {
-          dataLines.push(`selector ${selector}`);
+    /**
+     * Sends a merge fragments event.
+     *
+     * @param {string[]|string} fragments - Array of fragment identifiers.
+     * @param {MergeFragmentsOptions} options - Additional options for merging.
+     * @throws Will throw an error if fragments are missing.
+     */
+    MergeFragments: function (
+      fragments,
+      options = {
+        selector: null,
+        mergeMode: "morph",
+        settleDuration: 300,
+        useViewTransition: null,
+        eventId: null,
+        retryDuration: null,
+      }
+    ) {
+      let dataLines = [];
+      if (options?.selector != null)
+        dataLines.push(`selector ${options.selector}`);
+      if (options?.settleDuration != null)
+        dataLines.push(`settleDuration ${options.settleDuration}`);
+      if (options?.useViewTransition != null)
+        dataLines.push(`useViewTransition ${options.useViewTransition}`);
+      if (fragments) {
+        if (typeof fragments === "string") {
+          // Handle case where 'fragments' is a string
+          dataLines.push(`fragments ${fragments.replace(/[\r\n]+/g, "")}`);
+        } else if (Array.isArray(fragments)) {
+          // Handle case where 'fragments' is an array
+          fragments.forEach((frag) => {
+            dataLines.push(`fragments ${frag.replace(/[\r\n]+/g, "")}`);
+          });
         } else {
-          throw Error("RemoveFragments missing selector.");
+          throw Error("Invalid type for fragments. Expected string or array.");
         }
-        if (options?.settleDuration != null)
-          dataLines.push(`settleDuration ${options.settleDuration}`);
-        if (options?.useViewTransition != null)
-          dataLines.push(`useViewTransition ${options.useViewTransition}`);
-        return this._send(`datastar-remove-fragments`, dataLines, {
-          eventId: options?.eventId,
-          retryDuration: options?.retryDuration,
-        });
-      },
-      /**
-       * @typedef {Object} MergeSignalsOptions
-       * @property {boolean} [onlyIfMissing] - Merge only if signals are missing.
-       * @property {?string} [eventId=null] - Event ID to attach.
-       * @property {?number} [retryDuration=null] - Retry duration in milliseconds.
-       */
+      } else {
+        throw Error("MergeFragments missing fragment(s).");
+      }
+      return this._send("datastar-merge-fragments", dataLines, {
+        eventId: options?.eventId,
+        retryDuration: options?.retryDuration,
+      });
+    },
+    /**
+     * Sends a remove fragments event.
+     *
+     * @param {string} selector - CSS selector of fragments to remove.
+     * @param {RemoveFragmentsOptions} options - Additional options for removing.
+     * @throws Will throw an error if selector is missing.
+     */
+    RemoveFragments: function (selector, options) {
+      let dataLines = [];
+      if (selector) {
+        dataLines.push(`selector ${selector}`);
+      } else {
+        throw Error("RemoveFragments missing selector.");
+      }
+      if (options?.settleDuration != null)
+        dataLines.push(`settleDuration ${options.settleDuration}`);
+      if (options?.useViewTransition != null)
+        dataLines.push(`useViewTransition ${options.useViewTransition}`);
+      return this._send(`datastar-remove-fragments`, dataLines, {
+        eventId: options?.eventId,
+        retryDuration: options?.retryDuration,
+      });
+    },
 
-      /**
-       * Sends a merge signals event.
-       *
-       * @param {object} signals - Signals to merge.
-       * @param {MergeSignalsOptions} options - Additional options for merging.
-       * @throws Will throw an error if signals are missing.
-       */
-      MergeSignals: function (signals, options) {
-        let dataLines = [];
-        if (options?.onlyIfMissing === true) {
-          dataLines.push(`onlyIfMissing true`);
-        }
-        if (signals) {
-          dataLines.push(`signals ${JSON.stringify(signals)}`);
-        } else {
-          throw Error("MergeSignals missing signals.");
-        }
-        return this._send(`datastar-merge-signals`, dataLines, {
-          eventId: options?.eventId,
-          retryDuration: options?.retryDuration,
-        });
-      },
-      /**
-       * Sends a remove signals event.
-       *
-       * @param {string[]} paths - Paths of signals to remove.
-       * @param {SendOptions} options - Additional options for removing signals.
-       * @throws Will throw an error if paths are missing.
-       */
-      RemoveSignals: function (paths, options) {
-        let dataLines = [];
-        if (paths) {
-          paths
-            .map((path) => {
-              dataLines.push(`paths ${path}`);
-            })
-            .join("");
-        } else {
-          throw Error("RemoveSignals missing paths");
-        }
-        return this._send(`datastar-remove-signals`, dataLines, {
-          eventId: options?.eventId,
-          retryDuration: options?.retryDuration,
-        });
-      },
-      /**
-       * @typedef {Object} ExecuteScriptOptions
-       * @property {boolean} [autoRemove] - Automatically remove the script after execution.
-       * @property {?string} [eventId=null] - Event ID to attach.
-       * @property {?number} [retryDuration=null] - Retry duration in milliseconds.
-       */
+    /**
+     * Sends a merge signals event.
+     *
+     * @param {object} signals - Signals to merge.
+     * @param {MergeSignalsOptions} options - Additional options for merging.
+     * @throws Will throw an error if signals are missing.
+     */
+    MergeSignals: function (signals, options) {
+      let dataLines = [];
+      if (options?.onlyIfMissing === true) {
+        dataLines.push(`onlyIfMissing true`);
+      }
+      if (signals) {
+        dataLines.push(`signals ${JSON.stringify(signals)}`);
+      } else {
+        throw Error("MergeSignals missing signals.");
+      }
+      return this._send(`datastar-merge-signals`, dataLines, {
+        eventId: options?.eventId,
+        retryDuration: options?.retryDuration,
+      });
+    },
+    /**
+     * Sends a remove signals event.
+     *
+     * @param {string[]} paths - Paths of signals to remove.
+     * @param {SendOptions} options - Additional options for removing signals.
+     * @throws Will throw an error if paths are missing.
+     */
+    RemoveSignals: function (paths, options) {
+      /** @type {Array<string>} */
+      let dataLines = [];
+      if (paths) {
+        paths
+          .map((path) => {
+            dataLines.push(`paths ${path}`);
+          })
+          .join("");
+      } else {
+        throw Error("RemoveSignals missing paths");
+      }
+      return this._send(`datastar-remove-signals`, dataLines, {
+        eventId: options?.eventId,
+        retryDuration: options?.retryDuration,
+      });
+    },
 
-      /**
-       * Executes a script on the client-side.
-       *
-       * @param {string} script - Script code to execute.
-       * @param {ExecuteScriptOptions} options - Additional options for execution.
-       */
-      ExecuteScript: function (script, options) {
-        let dataLines = [];
-        if (options?.autoRemove != null)
-          dataLines.push(`autoRemove ${options.autoRemove}`);
-        if (script) {
-          dataLines.push(`script ${script}`);
-        }
-        return this._send(`datastar-execute-script`, dataLines, {
-          eventId: options?.eventId,
-          retryDuration: options?.retryDuration,
-        });
-      },
-    };
-  },
-};
+    /**
+     * Executes a script on the client-side.
+     *
+     * @param {string} script - Script code to execute.
+     * @param {ExecuteScriptOptions} options - Additional options for execution.
+     */
+    ExecuteScript: function (script, options) {
+      let dataLines = [];
+      if (options?.autoRemove != null) {
+        dataLines.push(`autoRemove ${options.autoRemove}`);
+      }
+
+      if (script) {
+        const lines = script.split("\n");
+        let insideBlockComment = false;
+        const processedLines = lines
+          .map((line) => {
+            line = line.trim();
+            let result = [];
+            let isInString = false;
+            let isEscape = false;
+
+            for (let i = 0; i < line.length; i++) {
+              const char = line[i];
+
+              if (insideBlockComment) {
+                // Check for end of block comment
+                if (char === "*" && line[i + 1] === "/") {
+                  insideBlockComment = false;
+                  i++; // Skip the '/'
+                }
+                continue;
+              }
+
+              if (isInString) {
+                result.push(char);
+                if (char === "\\" && !isEscape) {
+                  isEscape = true; // Detect escaping
+                } else if ((char === '"' || char === "'") && !isEscape) {
+                  isInString = false; // End of the string literal
+                } else {
+                  isEscape = false;
+                }
+              } else {
+                // Not inside any string
+                if (char === '"' || char === "'") {
+                  isInString = true;
+                  result.push(char);
+                } else if (char === "/" && line[i + 1] === "/") {
+                  break; // Start of single-line comment, ignore rest
+                } else if (char === "/" && line[i + 1] === "*") {
+                  insideBlockComment = true; // Begin block comment
+                  i++; // Skip the '*'
+                } else {
+                  result.push(char);
+                }
+              }
+            }
+
+            // Join the result and ensure it ends with a semicolon if not empty
+            const codePart = result.join("").trim();
+            return codePart && !codePart.endsWith(";")
+              ? `${codePart};`
+              : codePart;
+          })
+          .filter((line) => line.length > 0);
+
+        const singleLineScript = processedLines.join(" ");
+        dataLines.push(`script ${singleLineScript}`);
+      }
+
+      return this._send(`datastar-execute-script`, dataLines, {
+        eventId: options?.eventId,
+        retryDuration: options?.retryDuration,
+      });
+    },
+  };
+  return Object.assign(
+    {
+      headersSent: false,
+      req: request,
+      res: response,
+    },
+    generatorMethods
+  );
+}

package/jsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "strict": true,
+    "noImplicitAny": true,
+    "strictFunctionTypes": true,
+    "strictPropertyInitialization": true,
+    "strictBindCallApply": true,
+    "noImplicitThis": true,
+    "noImplicitReturns": true,
+    "alwaysStrict": true,
+    "esModuleInterop": true,
+    "checkJs": true,
+    "allowJs": true,
+    "declaration": true,
+    "target": "ES2016",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "outDir": "dist"
+  },
+  "include": ["*.js"],
+  "verbose": true
+}

package/package.json

@@ -1,15 +1,17 @@
 {
   "name": "datastar-ssegen",
-  "version": "0.0.2",
+  "version": "0.1.0",
   "description": "Datastar Server-Sent Event generator",
   "author": "John Cudd",
   "type": "module",
   "main": "index.js",
+  "types": "index.d.ts",
   "scripts": {
     "dev": "concurrently -c \"red,green,blue\" -n \"node,express,hyper-express\" \"npm run node\" \"npm run express\" \"npm run hyper-express\"",
     "node": "nodemon examples/node.example.js",
     "express": "nodemon examples/express.example.js",
-    "hyper-express": "nodemon examples/hyper-express.example.js"
+    "hyper-express": "nodemon examples/hyper-express.example.js",
+    "check-types": "tsc --project ./jsconfig.json"
   },
   "keywords": [
     "datastar",
@@ -31,5 +33,13 @@
     "hyper-express": "^6.17.3",
     "nodemon": "^3.1.9",
     "npm-run-all": "^4.1.5"
+  },
+  "devDependencies": {
+    "concurrently": "^9.1.0",
+    "typescript": "^5.7.2"
+  },
+  "dependencies": {
+    "express": "^4.21.2",
+    "hyper-express": "^6.17.3"
   }
 }