Add AgentGuard v1.2.2 - AI cost protection library

Author: dipampaul17

.github/workflows/ci.yml

@@ -0,0 +1,38 @@
+name: CI
+
+on:
+  push:
+    branches: [ main ]
+  pull_request:
+    branches: [ main ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [16.x, 18.x, 20.x]
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Use Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v3
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run tests
+      run: npm run test:ci
+    
+    - name: Upload coverage to Codecov
+      if: matrix.node-version == '18.x'
+      uses: codecov/codecov-action@v3
+      with:
+        file: ./coverage/lcov.info
+        flags: unittests
+        name: codecov-umbrella

.github/workflows/publish.yml

@@ -0,0 +1,84 @@
+name: Publish to NPM
+
+on:
+  release:
+    types: [published]
+  workflow_dispatch:
+    inputs:
+      version:
+        description: 'Version to publish (e.g., 1.2.0)'
+        required: true
+        type: string
+
+jobs:
+  publish:
+    runs-on: ubuntu-latest
+    
+    steps:
+    - uses: actions/checkout@v4
+    
+    - name: Setup Node.js
+      uses: actions/setup-node@v3
+      with:
+        node-version: '18.x'
+        registry-url: 'https://registry.npmjs.org'
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run tests
+      run: npm run test:ci
+    
+    - name: Build distribution files
+      run: npm run build
+    
+    - name: Update version (manual trigger)
+      if: github.event_name == 'workflow_dispatch'
+      run: |
+        npm version ${{ github.event.inputs.version }} --no-git-tag-version
+        echo "VERSION=${{ github.event.inputs.version }}" >> $GITHUB_ENV
+    
+    - name: Extract version (release trigger)
+      if: github.event_name == 'release'
+      run: |
+        VERSION=${GITHUB_REF#refs/tags/v}
+        echo "VERSION=$VERSION" >> $GITHUB_ENV
+        npm version $VERSION --no-git-tag-version
+    
+    - name: Verify package
+      run: |
+        npm pack --dry-run
+        echo "📦 Package contents:"
+        npm pack --dry-run 2>&1 | grep -E "^npm notice"
+    
+    - name: Publish to NPM
+      run: npm publish
+      env:
+        NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
+    
+    - name: Create GitHub Release Assets
+      if: github.event_name == 'release'
+      run: |
+        # Create tarball
+        npm pack
+        
+        # Upload to release
+        gh release upload ${{ github.event.release.tag_name }} \
+          agent-guard-${VERSION}.tgz \
+          dist/agent-guard.min.js \
+          dist/agent-guard-${VERSION}.min.js \
+          --clobber
+      env:
+        GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
+    
+    - name: Update CDN Documentation
+      run: |
+        echo "✅ Published version ${VERSION} to NPM"
+        echo ""
+        echo "📦 Installation:"
+        echo "  npm install agent-guard@${VERSION}"
+        echo ""
+        echo "🌐 CDN URLs:"
+        echo "  https://unpkg.com/agent-guard@${VERSION}/dist/agent-guard.min.js"
+        echo "  https://cdn.jsdelivr.net/npm/agent-guard@${VERSION}/dist/agent-guard.min.js"

.gitignore

@@ -0,0 +1,50 @@
+# Dependencies
+node_modules/
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Runtime & Logs
+*.log
+.env*
+
+# IDE & Editor
+.vscode/
+.idea/
+.cursor/
+*.swp
+*.swo
+*.sublime-*
+
+# OS Generated
+.DS_Store
+.DS_Store?
+._*
+.Spotlight-V100
+.Trashes
+ehthumbs.db
+Thumbs.db
+
+# Development & Internal
+PRODUCTION_REALITY.md
+DEMO_RESULTS.md
+production-test.js
+*-test.js
+test-*.js
+test-npm-package.js
+
+# Build artifacts
+build/
+*.tgz
+*.tar.gz
+
+# Testing & Coverage
+coverage/
+.nyc_output/
+
+# Cache files
+.agentguard-cache.json
+*.cache
+
+# IDE & Editor (additional)
+.cursor/