feat: mjml library

Author: jpoehnelt

packages/.gitkeep

@@ -0,0 +1,15 @@
+{
+  "scriptId": "1kBr89ap-MoQQceIyuxjVwh8dudCkhR-2k6_TopZOMe4nw5IJGNbHL5tt",
+  "rootDir": "dist",
+  "scriptExtensions": [
+    ".js",
+    ".gs"
+  ],
+  "htmlExtensions": [
+    ".html"
+  ],
+  "jsonExtensions": [
+    ".json"
+  ],
+  "filePushOrder": []
+}

packages/mjml-apps-script/.clasp.json

@@ -0,0 +1,19 @@
+# MJMLApp for Apps Script
+
+A library for using [MJML](https://mjml.io/) in Google Apps Script.
+
+## Installation
+
+Use the following script ID to [add this library](https://script.google.com/macros/library/d/1kBr89ap-MoQQceIyuxjVwh8dudCkhR-2k6_TopZOMe4nw5IJGNbHL5tt/3) to your project:
+
+~~~
+1kBr89ap-MoQQceIyuxjVwh8dudCkhR-2k6_TopZOMe4nw5IJGNbHL5tt
+~~~
+
+## Usage
+
+```javascript
+const { html } = mjml.mjml2html('...');
+```
+
+See [mjml](https://documentation.mjml.io) for more information and the full interface for `mjml2html`.

packages/mjml-apps-script/README.md

@@ -0,0 +1,29 @@
+import fs from "fs";
+import esbuild from "esbuild";
+import path from "path";
+
+const outdir = "dist";
+const sourceRoot = "src";
+
+await esbuild.build({
+  entryPoints: ["./src/index.ts"],
+  bundle: true,
+  outdir,
+  sourceRoot,
+  platform: "node",
+  format: "iife",
+  plugins: [],
+  inject: ["polyfill.js"],
+  minify: true,
+  banner: { js: "// Generated code DO NOT EDIT\n" },
+  entryNames: "zzz_bundle_[name]",
+  chunkNames: "zzz_chunk_[name]",
+});
+
+const passThroughFiles = ["main.js", "appsscript.json"];
+
+await Promise.all(
+  passThroughFiles.map(async (file) =>
+    fs.promises.copyFile(path.join(sourceRoot, file), path.join(outdir, file))
+  )
+);

packages/mjml-apps-script/build.js

@@ -0,0 +1,23 @@
+{
+  "name": "@jpoehnelt/apps-script-mjml",
+  "version": "0.1.0",
+  "description": "A library for using MJML in Google Apps Script.",
+  "scripts": {
+    "build": "node build.js",
+    "check": "tsc --noEmit",
+    "push": "clasp push -f"
+  },
+  "author": "Justin Poehnelt <justin.poehnelt@gmail.com>",
+  "license": "Apache-2.0",
+  "devDependencies": {
+    "@google/clasp": "^3.0.2-alpha",
+    "@types/google-apps-script": "^1.0.97",
+    "@types/mjml-browser": "^4.15.0",
+    "esbuild": "^0.25.0"
+  },
+  "type": "module",
+  "dependencies": {
+    "mjml-browser": "^4.15.3"
+  },
+  "private": true
+}

packages/mjml-apps-script/package.json

@@ -0,0 +1 @@
+globalThis.window = globalThis;

packages/mjml-apps-script/polyfill.js

@@ -0,0 +1,7 @@
+{
+  "timeZone": "America/Denver",
+  "dependencies": {},
+  "exceptionLogging": "STACKDRIVER",
+  "runtimeVersion": "V8",
+  "oauthScopes": []
+}

packages/mjml-apps-script/src/appsscript.json

@@ -0,0 +1,5 @@
+import mjml2html from 'mjml-browser';
+
+// @ts-ignore
+globalThis.mjml2html_ = mjml2html;
+

packages/mjml-apps-script/src/index.ts

@@ -0,0 +1,12 @@
+
+/**
+ * ### Description
+ * Convert MJML to HTML for use in email.
+ * 
+ * @param {string} str MJML string
+ * @param {object} [options] Options object
+ * @returns {object} result object.
+ */
+function mjml2html(str, options) {
+    return globalThis.mjml2html_(str, options);
+}

packages/mjml-apps-script/src/main.js

@@ -0,0 +1,23 @@
+{
+    "compilerOptions": {
+        "module": "NodeNext",
+        "target": "ES2022",
+        "lib": [
+            "esnext"
+        ],
+        "strict": true,
+        "esModuleInterop": true,
+        "skipLibCheck": true,
+        "types": [
+            "@types/google-apps-script"
+        ],
+        "experimentalDecorators": true
+    },
+    "include": [
+        "src/**/*.ts"
+    ],
+    "exclude": [
+        "node_modules",
+        "dist"
+    ]
+}