chore: add package.json for URL Endpoint Function template with Jest configuration

Author: manu4543

.github/workflows/test.yml

@@ -0,0 +1,43 @@
+name: Test URL Endpoint Function
+
+on:
+  push:
+    branches: [ main, develop ]
+  pull_request:
+    branches: [ main, develop ]
+
+jobs:
+  test:
+    runs-on: ubuntu-latest
+    
+    strategy:
+      matrix:
+        node-version: [18.x, 20.x]
+    
+    steps:
+    - name: Checkout code
+      uses: actions/checkout@v4
+    
+    - name: Setup Node.js ${{ matrix.node-version }}
+      uses: actions/setup-node@v4
+      with:
+        node-version: ${{ matrix.node-version }}
+        cache: 'npm'
+    
+    - name: Install dependencies
+      run: npm ci
+    
+    - name: Run tests
+      run: npm test
+    
+    - name: Run tests with coverage
+      run: npm run test:coverage
+    
+    - name: Upload coverage reports
+      uses: codecov/codecov-action@v3
+      if: matrix.node-version == '20.x'
+      with:
+        file: ./coverage/coverage-final.json
+        flags: unittests
+        name: codecov-umbrella
+      continue-on-error: true

.gitignore

@@ -0,0 +1,31 @@
+# Dependencies
+node_modules/
+
+# Test coverage
+coverage/
+*.lcov
+.nyc_output/
+
+# IDE
+.vscode/
+.idea/
+*.swp
+*.swo
+*~
+.DS_Store
+
+# Logs
+logs/
+*.log
+npm-debug.log*
+yarn-debug.log*
+yarn-error.log*
+
+# Environment variables
+.env
+.env.local
+.env.*.local
+
+# Build output
+dist/
+build/

README.md

@@ -0,0 +1,118 @@
+# URL Endpoint Function Template
+
+Template for creating and testing ImageKit URL Endpoint Functions with unit tests and GitHub Actions CI.
+
+## Quick Start
+
+```bash
+npm install
+npm test
+```
+
+## Handler Signature
+
+```javascript
+function handler(url, urlPrefix, context) {
+  // Your logic here
+  return { url: modifiedUrl }
+}
+```
+
+### Parameters
+
+- **`url`** - Full request URL including protocol, hostname, path, and query string
+- **`urlPrefix`** - Pattern identifier from client configuration
+- **`context`** - Request context object:
+  - `host` - Request hostname
+  - `clientNumber` - Client identifier
+  - `isDebug` - Debug mode flag
+  - `logger` - Request logger (`.info()`, `.warn()`, `.error()`, `.debug()`)
+
+### Return Types
+
+**Normal Result** (continue processing):
+```javascript
+{
+  url: string,      // Required: Full URL with protocol + hostname
+  signURL: boolean  // Optional: Should server sign this URL? (default: false)
+}
+```
+
+**Early Response** (stop processing):
+```javascript
+{
+  status: number,                    // Required: HTTP status code
+  body: string | object,             // Required: Response body
+  headers: Record<string, string>    // Optional: Response headers
+}
+```
+
+## Examples
+
+### 1. Simple URL Rewrite
+
+```javascript
+function handler(url, urlPrefix, context) {
+  return {
+    url: url.replace('/v1/', '/v2/')
+  };
+}
+```
+
+### 2. Extract Path Parameters
+
+```javascript
+function handler(url, urlPrefix, context) {
+  // Convert: /w_100/h_200/image.jpg → /image.jpg?tr=w-100,h-200
+  const parsedUrl = new URL(url);
+  const params = [];
+  
+  parsedUrl.pathname = parsedUrl.pathname.replace(
+    /\/(w|h)_(\d+)/g,
+    (match, key, value) => {
+      params.push(`${key}-${value}`);
+      return '';
+    }
+  );
+  
+  if (params.length > 0) {
+    parsedUrl.search = `?tr=${params.join(',')}`;
+  }
+  
+  return {
+    url: parsedUrl.toString(),
+    signURL: true
+  };
+}
+```
+
+### 3. Block Private Paths
+
+```javascript
+function handler(url, urlPrefix, context) {
+  const parsedUrl = new URL(url);
+  
+  if (parsedUrl.pathname.includes('/private/')) {
+    return {
+      status: 403,
+      body: { error: 'Access denied' }
+    };
+  }
+  
+  return { url };
+}
+```
+
+**See [examples.js](./examples.js) for 12+ more examples** including hostname changes, routing, query transformations, and more.
+
+## Testing
+
+```bash
+npm test              # Run tests
+npm run test:watch    # Watch mode
+npm run test:coverage # With coverage
+```
+
+## CI/CD
+
+GitHub Actions automatically runs tests on push/PR to `main` or `develop` branches. Tests run on Node.js 18.x and 20.x.