feat: add installation verification tests for CommonJS and ESM

- Introduced a new script to run installation verification tests for both CommonJS and ESM modules.
- Created test directories with corresponding package.json files for CommonJS and ESM installations.
- Each test logs the results of the installation verification process, ensuring that the README install instructions are accurate.

Author: DavidWells

scripts/build/tests/cjs-test/index.js

@@ -0,0 +1,3 @@
+const analytics = require('analytics')
+
+console.log(analytics)

scripts/build/tests/cjs-test/package.json

@@ -0,0 +1,15 @@
+{
+  "name": "cjs-install-test",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "scripts": {
+    "test": "node index.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "analytics": "file:../../../../packages/analytics"
+  }
+}

scripts/build/tests/esm-test/index.js

@@ -0,0 +1,16 @@
+import Analytics from 'analytics'
+
+console.log('Analytics:', Analytics)
+console.log('Analytics type:', typeof Analytics)
+console.log('Analytics keys:', Object.keys(Analytics))
+
+// Try the workaround
+try {
+  const analytics = Analytics.default({
+    app: 'awesome-app', 
+    plugins: []
+  })
+  console.log('Success with Analytics.default!')
+} catch (error) {
+  console.error('Failed with Analytics.default:', error.message)
+}

scripts/build/tests/esm-test/package.json

@@ -0,0 +1,16 @@
+{
+  "name": "esm-install-test",
+  "version": "1.0.0",
+  "description": "",
+  "main": "index.js",
+  "type": "module",
+  "scripts": {
+    "test": "node index.js"
+  },
+  "keywords": [],
+  "author": "",
+  "license": "ISC",
+  "dependencies": {
+    "analytics": "file:../../../../packages/analytics"
+  }
+}

scripts/build/tests/run-install-tests.js

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+const { execSync } = require('child_process')
+const path = require('path')
+
+console.log('🧪 Running installation verification tests...\n')
+
+// Test CommonJS installation
+console.log('📦 Testing CommonJS installation...')
+try {
+  const cjsOutput = execSync('npm test', { 
+    cwd: path.join(__dirname, 'cjs-test'), 
+    encoding: 'utf8' 
+  })
+  console.log('✅ CommonJS test passed')
+  // console.log(cjsOutput)
+} catch (error) {
+  console.log('❌ CommonJS test failed')
+  console.log(error.stdout || error.message)
+  process.exit(1)
+}
+
+// Test ESM installation  
+console.log('\n📦 Testing ESM installation...')
+try {
+  const esmOutput = execSync('npm test', {
+    cwd: path.join(__dirname, 'esm-test'),
+    encoding: 'utf8'
+  })
+  console.log('✅ ESM test passed')
+  // console.log(esmOutput)
+} catch (error) {
+  console.log('❌ ESM test failed')
+  console.log(error.stdout || error.message)
+  process.exit(1)
+}
+
+console.log('\n🎉 All installation tests passed!')
+console.log('📝 README install instructions are verified as correct.')