feat: add multiple handler support with example handlers and tests, update README

Author: manu4543

README.md

@@ -91,6 +91,27 @@ npm run test:watch    # Watch mode
 npm run test:coverage # With coverage
 ```
 
+### Multiple Handlers
+
+This template supports multiple handlers in the same repository. Each handler should follow the naming convention `handler*.js` with a corresponding test file `handler*.test.js`.
+
+**Current structure:**
+```
+handler1.js          # Handler implementation 1
+handler1.test.js     # Tests for handler 1
+handler2.js          # Handler implementation 2
+handler2.test.js     # Tests for handler 2
+```
+
+All test files matching `**/*.test.js` will be automatically discovered and executed by Jest. The CI pipeline will run all tests for all handlers.
+
+**To add a new handler:**
+1. Create `handlerN.js` with your handler implementation
+2. Create `handlerN.test.js` with corresponding tests
+3. Run `npm test` to verify all handlers pass their tests
+
+Coverage is collected for all `handler*.js` files automatically.
+
 ## CI/CD
 
-GitHub Actions automatically runs tests on push/PR to `main` or `develop` branches.
+GitHub Actions automatically runs tests on push/PR to `main` or `develop` branches. All test files will be executed and coverage will be reported for all handlers.

handler.js handler1.jshandler.js renamed to handler1.js

@@ -1,4 +1,4 @@
-const { handler } = require('./handler');
+const { handler } = require('./handler1');
 
 describe('URL Endpoint Function Handler', () => {
   // Mock context object for testing
@@ -16,7 +16,7 @@ describe('URL Endpoint Function Handler', () => {
 
   it('should return the original URL unchanged', () => {
     const url = 'https://ik.imagekit.io/demo/image.jpg';
-    const urlPrefix = 'demo';
+    const urlPrefix = '/';
 
     const result = handler(url, urlPrefix, mockContext);
 

handler.test.js handler1.test.jshandler.test.js renamed to handler1.test.js

@@ -0,0 +1,25 @@
+/**
+ * URL Endpoint Function Handler 2
+ * 
+ * This is a default no-op handler that returns the URL unchanged.
+ * Modify this function to implement your custom URL transformation logic.
+ * 
+ * @param {string} url - Full request URL including protocol, hostname, path, and query string
+ * @param {string} urlPrefix - Pattern identifier from client configuration
+ * @param {object} context - Read-only request context
+ * @param {string} context.host - Request hostname
+ * @param {string} context.clientNumber - Client identifier
+ * @param {boolean} context.isDebug - Debug mode flag
+ * @param {object} context.logger - Request logger
+ * 
+ * @returns {object} Result object with url and optional signURL flag
+ */
+function handler(url, urlPrefix, context) {
+  // Default behavior: return URL unchanged without signing
+  return {
+    url: url,
+    signURL: false
+  };
+}
+
+module.exports.handler = handler;

handler2.js

@@ -0,0 +1,26 @@
+const { handler } = require('./handler2');
+
+describe('URL Endpoint Function Handler 2', () => {
+  // Mock context object for testing
+  const mockContext = {
+    host: 'ik.imagekit.io',
+    clientNumber: 'test-client-123',
+    isDebug: false,
+    logger: {
+      info: jest.fn(),
+      error: jest.fn(),
+      warn: jest.fn(),
+      debug: jest.fn()
+    }
+  };
+
+  it('should return the original URL unchanged', () => {
+    const url = 'https://ik.imagekit.io/demo/image.jpg';
+    const urlPrefix = '/';
+    
+    const result = handler(url, urlPrefix, mockContext);
+    
+    expect(result.url).toBe(url);
+    expect(result.signURL).toBe(false);
+  });
+});

handler2.test.js

@@ -23,7 +23,7 @@
     "testEnvironment": "node",
     "coverageDirectory": "coverage",
     "collectCoverageFrom": [
-      "handler.js"
+      "handler*.js"
     ],
     "testMatch": [
       "**/*.test.js"