Adds htmlrewriter shim if it doesn't exist in the global context

.github/workflows/pr.yml

@@ -0,0 +1,30 @@
+name: Build & Test
+
+on:
+  pull_request:
+  push:
+    branches:
+      - main
+
+jobs:
+  build:
+    name: build & test
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.x"
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Run Node build (if present)
+        run: npm run build --if-present
+
+      - name: Run Tests (if present)
+        run: npm test --if-present

.github/workflows/release.yml

@@ -0,0 +1,35 @@
+name: Release
+on:
+  push:
+    tags:
+      - "v*"
+
+jobs:
+  release:
+    name: release
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v4
+
+      - name: Setup Node
+        uses: actions/setup-node@v4
+        with:
+          node-version: "20.x"
+          registry-url: 'https://registry.npmjs.org/'
+
+      - name: Install Node dependencies
+        run: npm ci
+
+      - name: Update version in package.json
+        run: |
+          TAG_VERSION=${GITHUB_REF#refs/tags/}
+          npm version $TAG_VERSION --no-git-tag-version
+
+      - name: Run Node build (if present)
+        run: npm run build --if-present
+
+      - name: Publish NPM package
+        run: npm publish --access=public
+        env:
+          NODE_AUTH_TOKEN: ${{secrets.NPM_TOKEN}}

.gitignore

@@ -0,0 +1,107 @@
+# Logs
+logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+lerna-debug.log*
+
+# Diagnostic reports (https://nodejs.org/api/report.html)
+report.[0-9]*.[0-9]*.[0-9]*.[0-9]*.json
+
+# Runtime data
+pids
+*.pid
+*.seed
+*.pid.lock
+
+# Directory for instrumented libs generated by jscoverage/JSCover
+lib-cov
+
+# Coverage directory used by tools like istanbul
+coverage
+*.lcov
+
+# nyc test coverage
+.nyc_output
+
+# Grunt intermediate storage (https://gruntjs.com/creating-plugins#storing-task-files)
+.grunt
+
+# Bower dependency directory (https://bower.io/)
+bower_components
+
+# node-waf configuration
+.lock-wscript
+
+# Compiled binary addons (https://nodejs.org/api/addons.html)
+build/Release
+
+# Dependency directories
+node_modules/
+jspm_packages/
+
+# TypeScript v1 declaration files
+typings/
+
+# TypeScript cache
+*.tsbuildinfo
+
+# Optional npm cache directory
+.npm
+
+# Optional eslint cache
+.eslintcache
+
+# Microbundle cache
+.rpt2_cache/
+.rts2_cache_cjs/
+.rts2_cache_es/
+.rts2_cache_umd/
+
+# Optional REPL history
+.node_repl_history
+
+# Output of 'npm pack'
+*.tgz
+
+# Yarn Integrity file
+.yarn-integrity
+
+# dotenv environment variables file
+.env
+.env.test
+
+# parcel-bundler cache (https://parceljs.org/)
+.cache
+
+# Next.js build output
+.next
+
+# Nuxt.js build / generate output
+.nuxt
+dist
+
+# Gatsby files
+.cache/
+# Comment in the public line in if your project uses Gatsby and *not* Next.js
+# https://nextjs.org/blog/next-9-1#public-directory-support
+# public
+
+# vuepress build output
+.vuepress/dist
+
+# Serverless directories
+.serverless/
+
+# FuseBox cache
+.fusebox/
+
+# DynamoDB Local files
+.dynamodb/
+
+# TernJS port file
+.tern-port
+
+# typescript build output
+lib

package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@qpoint/htmlrewriter",
+  "version": "0.0.1",
+  "description": "This shims htmlrewriter into the global context if it doesn't exist already.",
+  "homepage": "https://qpoint.io",
+  "author": "Jon Friesen <[email protected]>",
+  "license": "Apache-2.0",
+  "main": "lib/index.js",
+  "types": "lib/index.d.ts",
+  "directories": {
+    "lib": "lib"
+  },
+  "files": [
+    "lib"
+  ],
+  "scripts": {
+    "build": "tsc"
+  },
+  "dependencies": {
+    "htmlrewriter": "^0.0.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.3.3"
+  }
+}

src/index.ts

@@ -0,0 +1,11 @@
+// Ensure this runtime has an HTMLRewriter
+// Many environments that the Context is used inject
+// an htmlrewriter instance, in certain environemnts
+// (looking at you Node) it is not, this resolves that.
+if (!(globalThis as any).HTMLRewriter) {
+  await import('htmlrewriter').then(module => {
+    (globalThis as any).HTMLRewriter = module.HTMLRewriter;
+  });
+}
+
+export {};

tsconfig.json

@@ -0,0 +1,22 @@
+{
+  "compilerOptions": {
+    "outDir": "./lib",
+    "module": "ESNext",
+    "target": "esnext",
+    "lib": [
+      "esnext"
+    ],
+    "preserveConstEnums": true,
+    "moduleResolution": "node",
+    "sourceMap": true,
+    "esModuleInterop": true,
+    "declaration": true
+  },
+  "include": [
+    "./src"
+  ],
+  "exclude": [
+    "node_modules",
+    "**/*.test.ts"
+  ]
+}