verify-phone-sms 0.9.4

package/test/utils.test.ts

@@ -0,0 +1,186 @@
+import { describe, it, expect } from 'vitest';
+
+// Import utility functions from the main file
+// We'll need to extract these functions or test them indirectly
+// For now, let's test the phone number validation logic
+
+describe('Utility Functions', () => {
+  describe('Phone Number Validation', () => {
+    const isValidPhoneNumber = (phone) => {
+      const phoneRegex = /^\+[1-9]\d{1,14}$/;
+      return phoneRegex.test(phone) && phone.length >= 7 && phone.length <= 16;
+    };
+
+    const formatPhoneNumber = (phone) => {
+      // Remove all non-digit characters
+      const cleaned = phone.replace(/\D/g, '');
+      
+      // Add country code if not present (assuming US)
+      if (cleaned.length === 10) {
+        return `+1${cleaned}`;
+      } else if (cleaned.length === 11 && cleaned.startsWith('1')) {
+        return `+${cleaned}`;
+      }
+      
+      // Return as is if it already looks like E.164
+      return phone.startsWith('+') ? phone : `+${cleaned}`;
+    };
+
+    describe('isValidPhoneNumber', () => {
+      it('should validate correct E.164 phone numbers', () => {
+        const validNumbers = [
+          '+1234567890',
+          '+11234567890',
+          '+44123456789',
+          '+61412345678',
+          '+123456789012345'
+        ];
+
+        validNumbers.forEach(number => {
+          expect(isValidPhoneNumber(number)).toBe(true);
+        });
+      });
+
+      it('should reject invalid phone numbers', () => {
+        const invalidNumbers = [
+          '1234567890', // Missing +
+          '+', // Just plus sign
+          '+123', // Too short
+          '+12345678901234567890', // Too long
+          '+01234567890', // Starts with 0
+          'not-a-number',
+          '+abc123def'
+        ];
+
+        invalidNumbers.forEach(number => {
+          expect(isValidPhoneNumber(number)).toBe(false);
+        });
+      });
+    });
+
+    describe('formatPhoneNumber', () => {
+      it('should format 10-digit US numbers correctly', () => {
+        const testCases = [
+          { input: '1234567890', expected: '+11234567890' },
+          { input: '(123) 456-7890', expected: '+11234567890' },
+          { input: '123-456-7890', expected: '+11234567890' },
+          { input: '123.456.7890', expected: '+11234567890' },
+          { input: '123 456 7890', expected: '+11234567890' }
+        ];
+
+        testCases.forEach(({ input, expected }) => {
+          expect(formatPhoneNumber(input)).toBe(expected);
+        });
+      });
+
+      it('should format 11-digit US numbers correctly', () => {
+        const testCases = [
+          { input: '11234567890', expected: '+11234567890' },
+          { input: '1-123-456-7890', expected: '+11234567890' },
+          { input: '1 (123) 456-7890', expected: '+11234567890' }
+        ];
+
+        testCases.forEach(({ input, expected }) => {
+          expect(formatPhoneNumber(input)).toBe(expected);
+        });
+      });
+
+      it('should preserve already formatted E.164 numbers', () => {
+        const testCases = [
+          '+11234567890', // Already formatted correctly
+          '+44123456789',
+          '+61412345678'
+        ];
+
+        testCases.forEach(number => {
+          expect(formatPhoneNumber(number)).toBe(number);
+        });
+      });
+
+      it('should handle edge cases', () => {
+        const testCases = [
+          { input: '', expected: '+' },
+          { input: 'abc', expected: '+' },
+          { input: '123abc456', expected: '+123456' }
+        ];
+
+        testCases.forEach(({ input, expected }) => {
+          expect(formatPhoneNumber(input)).toBe(expected);
+        });
+      });
+    });
+
+    describe('Combined Validation and Formatting', () => {
+      it('should format and validate phone numbers correctly', () => {
+        const testCases = [
+          { input: '1234567890', formatted: '+11234567890', valid: true },
+          { input: '(123) 456-7890', formatted: '+11234567890', valid: true },
+          { input: '123-456-7890', formatted: '+11234567890', valid: true },
+          { input: '+11234567890', formatted: '+11234567890', valid: true },
+          { input: 'not-a-number', formatted: '+', valid: false },
+          { input: '123', formatted: '+123', valid: false },
+          { input: '12345678901234567890', formatted: '+12345678901234567890', valid: false }
+        ];
+
+        testCases.forEach(({ input, formatted, valid }) => {
+          const formattedResult = formatPhoneNumber(input);
+          expect(formattedResult).toBe(formatted);
+          expect(isValidPhoneNumber(formattedResult)).toBe(valid);
+        });
+      });
+    });
+  });
+
+  describe('Verification Code Generation', () => {
+    const generateVerificationCode = () => {
+      const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789';
+      let result = '';
+      for (let i = 0; i < 6; i++) {
+        result += chars.charAt(Math.floor(Math.random() * chars.length));
+      }
+      return result;
+    };
+
+    it('should generate 6-character alphanumeric codes', () => {
+      for (let i = 0; i < 100; i++) {
+        const code = generateVerificationCode();
+        expect(code).toMatch(/^[A-Z0-9]{6}$/);
+        expect(code.length).toBe(6);
+      }
+    });
+
+    it('should generate codes with only uppercase letters and digits', () => {
+      for (let i = 0; i < 100; i++) {
+        const code = generateVerificationCode();
+        expect(code).toMatch(/^[A-Z0-9]+$/);
+        expect(code).not.toMatch(/[a-z]/); // No lowercase letters
+      }
+    });
+
+    it('should generate different codes on multiple calls', () => {
+      const codes = new Set();
+      for (let i = 0; i < 100; i++) {
+        codes.add(generateVerificationCode());
+      }
+      // With 100 calls, we should have at least 90 unique codes
+      // (allowing for some randomness overlap)
+      expect(codes.size).toBeGreaterThan(90);
+    });
+  });
+
+  describe('UUID Generation', () => {
+    it('should generate valid UUIDs', () => {
+      const uuid = crypto.randomUUID();
+      const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+      expect(uuid).toMatch(uuidRegex);
+    });
+
+    it('should generate unique UUIDs', () => {
+      const uuids = new Set();
+      for (let i = 0; i < 100; i++) {
+        uuids.add(crypto.randomUUID());
+      }
+      expect(uuids.size).toBe(100);
+    });
+  });
+}); 

package/test/verify.test.ts

@@ -0,0 +1,20 @@
+import verifyPhone from '../src/verify-phone';
+
+// Basic usage with custom code
+const result = await verifyPhone({
+    phoneNumber: '+1234567890',
+    code: 'ABC123',
+    accessKeyId: process.env.AWS_ACCESS_KEY_ID,
+    secretAccessKey: process.env.AWS_SECRET_ACCESS_KEY,
+    awsRegion: 'us-east-1',
+    blockVoip: true,
+    senderId: 'MyApp',
+    messageTemplate: 'MyApp: Your code is {code}. Valid for 10 minutes.'
+});
+
+if (result.success) {
+    console.log('SMS sent successfully:', result.messageId);
+    console.log('Code sent:', result.code);
+} else {
+    console.error('Failed to send SMS:', result.error);
+}

package/test/voip.test.ts

@@ -0,0 +1,113 @@
+import { describe, it, expect, beforeEach } from 'vitest';
+import { createApp } from '../src/verify-phone-server';
+
+describe('VoIP Blocking Functionality', () => {
+  let app: ReturnType<typeof createApp>;
+
+  beforeEach(() => {
+    app = createApp(globalThis.env);
+  });
+
+  describe('blockVoip parameter', () => {
+    it('should allow requests when blockVoip is not specified', async () => {
+      const req = new Request('http://localhost/api/send-verification?phoneNumber=%2B1234567890', {
+        headers: {
+          'X-API-Key': 'test-api-key'
+        }
+      });
+      const res = await app.request(req, globalThis.env);
+      const data: any = await res.json();
+
+      expect(res.status).toBe(200);
+      expect(data.success).toBe(true);
+    });
+
+    it('should allow requests when blockVoip is false', async () => {
+      const req = new Request('http://localhost/api/send-verification?phoneNumber=%2B1234567890&blockVoip=false', {
+        headers: {
+          'X-API-Key': 'test-api-key'
+        }
+      });
+      const res = await app.request(req, globalThis.env);
+      const data: any = await res.json();
+
+      expect(res.status).toBe(200);
+      expect(data.success).toBe(true);
+    });
+
+    it('should accept blockVoip=true parameter', async () => {
+      const req = new Request('http://localhost/api/send-verification?phoneNumber=%2B1234567890&blockVoip=true', {
+        headers: {
+          'X-API-Key': 'test-api-key'
+        }
+      });
+      const res = await app.request(req, globalThis.env);
+      const data: any = await res.json();
+
+      expect(res.status).toBe(200);
+      expect(data.success).toBe(true);
+    });
+  });
+
+  describe('VoIP detection logic', () => {
+    it('should correctly identify VoIP numbers', async () => {
+      // Import the function from the module
+      const module = await import('../src/verify-phone-server');
+      const { isPhoneNumberVoip } = module;
+
+      // Mock the grab function to return VoIP data
+      const g = globalThis as any;
+      const originalGrab = g.grab;
+      g.grab = {
+        instance: () => ({
+          "phone-lookup": async () => ({
+            carrier: {
+              name: 'Bandwidth',
+              type: 'voip'
+            },
+            portability: {
+              line_type: 'landline'
+            }
+          })
+        })
+      };
+      
+      // Test VoIP number
+      const isVoip = await isPhoneNumberVoip('+1234567890');
+      expect(isVoip).toBe(true);
+      
+      // Mock the grab function to return mobile data
+      g.grab = {
+        instance: () => ({
+          "phone-lookup": async () => ({
+            carrier: {
+              name: 'Verizon Wireless',
+              type: 'mobile'
+            },
+            portability: {
+              line_type: 'mobile'
+            }
+          })
+        })
+      };
+      
+      // Test mobile number
+      const isMobile = await isPhoneNumberVoip('+1234567890');
+      expect(isMobile).toBe(false);
+      
+      // Mock the grab function to return null data
+      g.grab = {
+        instance: () => ({
+          "phone-lookup": async () => null
+        })
+      };
+      
+      // Test null data
+      const isNull = await isPhoneNumberVoip('+1234567890');
+      expect(isNull).toBe(false);
+      
+      // Restore original grab function
+      g.grab = originalGrab;
+    });
+  });
+}); 

package/tsconfig.json

@@ -0,0 +1,24 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "Bundler",
+    "lib": ["ES2022"],
+    "types": ["@cloudflare/workers-types", "node"],
+    "strict": false,
+    "noImplicitAny": false,
+    "strictNullChecks": false,
+    "esModuleInterop": true,
+    "allowSyntheticDefaultImports": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "skipLibCheck": true,
+    "noEmit": true,
+    "allowJs": false,
+    "jsx": "react-jsx",
+    "forceConsistentCasingInFileNames": true,
+    "verbatimModuleSyntax": false
+  },
+  "include": ["src/**/*.ts", "test/**/*.ts", "examples/**/*.ts", "vitest.config.ts"],
+  "exclude": ["node_modules", "docs", ".wrangler", "dist"]
+}

package/vitest.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from 'vitest/config';
+
+export default defineConfig({
+  test: {
+    globals: true,
+    environment: 'node',
+    setupFiles: ['./test/setup.ts'],
+    mockReset: true,
+  },
+}); 

package/wrangler.toml

@@ -0,0 +1,24 @@
+name = "sms-verification-api"
+main = "src/index.ts"
+compatibility_date = "2024-01-01"
+compatibility_flags = ["nodejs_compat"]
+
+# Environment variables
+[vars]
+AWS_REGION = "us-east-1"
+SMS_SENDER_ID = "Verify"
+
+# Staging environment
+[env.staging]
+name = "sms-verification-api-staging"
+vars = { ENVIRONMENT = "staging" }
+
+# Production environment
+[env.production]
+name = "sms-verification-api-production"
+vars = { ENVIRONMENT = "production" }
+
+# Build configuration
+[build]
+command = "bun run build"
+watch_dir = "src"