@geekmidas/constructs 9.0.2 → 10.0.0-alpha.1

package/src/endpoints/__tests__/Authorizer.spec.ts

@@ -1,286 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import {
-	type Authorizer,
-	BUILT_IN_SECURITY_SCHEMES,
-	createAuthorizer,
-	getSecurityScheme,
-	isBuiltInSecurityScheme,
-	type SecurityScheme,
-} from '../Authorizer';
-
-describe('Authorizer', () => {
-	describe('BUILT_IN_SECURITY_SCHEMES', () => {
-		it('should have jwt scheme configured correctly', () => {
-			const jwt = BUILT_IN_SECURITY_SCHEMES.jwt;
-			expect(jwt.type).toBe('http');
-			expect(jwt.scheme).toBe('bearer');
-			expect(jwt.bearerFormat).toBe('JWT');
-			expect(jwt.description).toBeDefined();
-		});
-
-		it('should have bearer scheme configured correctly', () => {
-			const bearer = BUILT_IN_SECURITY_SCHEMES.bearer;
-			expect(bearer.type).toBe('http');
-			expect(bearer.scheme).toBe('bearer');
-			expect(bearer.description).toBeDefined();
-		});
-
-		it('should have apiKey scheme configured correctly', () => {
-			const apiKey = BUILT_IN_SECURITY_SCHEMES.apiKey;
-			expect(apiKey.type).toBe('apiKey');
-			expect(apiKey.in).toBe('header');
-			expect(apiKey.name).toBe('X-API-Key');
-			expect(apiKey.description).toBeDefined();
-		});
-
-		it('should have oauth2 scheme configured correctly', () => {
-			const oauth2 = BUILT_IN_SECURITY_SCHEMES.oauth2;
-			expect(oauth2.type).toBe('oauth2');
-			expect(oauth2.flows).toBeDefined();
-			expect(oauth2.description).toBeDefined();
-		});
-
-		it('should have oidc scheme configured correctly', () => {
-			const oidc = BUILT_IN_SECURITY_SCHEMES.oidc;
-			expect(oidc.type).toBe('openIdConnect');
-			expect(oidc.openIdConnectUrl).toBeDefined();
-			expect(oidc.description).toBeDefined();
-		});
-
-		it('should have iam scheme configured correctly', () => {
-			const iam = BUILT_IN_SECURITY_SCHEMES.iam;
-			expect(iam.type).toBe('apiKey');
-			expect(iam.in).toBe('header');
-			expect(iam.name).toBe('Authorization');
-			expect(iam['x-amazon-apigateway-authtype']).toBe('awsSigv4');
-			expect(iam.description).toBeDefined();
-		});
-	});
-
-	describe('isBuiltInSecurityScheme', () => {
-		it('should return true for built-in scheme names', () => {
-			expect(isBuiltInSecurityScheme('jwt')).toBe(true);
-			expect(isBuiltInSecurityScheme('bearer')).toBe(true);
-			expect(isBuiltInSecurityScheme('apiKey')).toBe(true);
-			expect(isBuiltInSecurityScheme('oauth2')).toBe(true);
-			expect(isBuiltInSecurityScheme('oidc')).toBe(true);
-			expect(isBuiltInSecurityScheme('iam')).toBe(true);
-		});
-
-		it('should return false for non-built-in scheme names', () => {
-			expect(isBuiltInSecurityScheme('custom')).toBe(false);
-			expect(isBuiltInSecurityScheme('myAuth')).toBe(false);
-			expect(isBuiltInSecurityScheme('')).toBe(false);
-			expect(isBuiltInSecurityScheme('JWT')).toBe(false); // Case sensitive
-		});
-	});
-
-	describe('createAuthorizer', () => {
-		it('should create an authorizer with just a name', () => {
-			const authorizer = createAuthorizer('myAuth');
-			expect(authorizer.name).toBe('myAuth');
-			expect(authorizer.securityScheme).toBeUndefined();
-			expect(authorizer.type).toBeUndefined();
-		});
-
-		it('should create an authorizer with security scheme', () => {
-			const securityScheme: SecurityScheme = {
-				type: 'http',
-				scheme: 'bearer',
-				bearerFormat: 'JWT',
-				description: 'Custom JWT auth',
-			};
-
-			const authorizer = createAuthorizer('customJwt', { securityScheme });
-
-			expect(authorizer.name).toBe('customJwt');
-			expect(authorizer.securityScheme).toEqual(securityScheme);
-		});
-
-		it('should create an authorizer with legacy type and description', () => {
-			const authorizer = createAuthorizer('legacyAuth', {
-				type: 'custom',
-				description: 'A legacy authorizer',
-				metadata: { key: 'value' },
-			});
-
-			expect(authorizer.name).toBe('legacyAuth');
-			expect(authorizer.type).toBe('custom');
-			expect(authorizer.description).toBe('A legacy authorizer');
-			expect(authorizer.metadata).toEqual({ key: 'value' });
-		});
-
-		it('should create an authorizer with all options', () => {
-			const authorizer: Authorizer = createAuthorizer('fullAuth', {
-				securityScheme: {
-					type: 'apiKey',
-					in: 'header',
-					name: 'X-Custom-Auth',
-					description: 'Custom API key auth',
-				},
-				type: 'apiKey',
-				description: 'Full authorizer config',
-				metadata: { custom: true },
-			});
-
-			expect(authorizer.name).toBe('fullAuth');
-			expect(authorizer.securityScheme?.type).toBe('apiKey');
-			expect(authorizer.securityScheme?.name).toBe('X-Custom-Auth');
-			expect(authorizer.type).toBe('apiKey');
-			expect(authorizer.description).toBe('Full authorizer config');
-			expect(authorizer.metadata).toEqual({ custom: true });
-		});
-	});
-
-	describe('getSecurityScheme', () => {
-		it('should return built-in scheme when no custom schemes provided', () => {
-			const jwt = getSecurityScheme('jwt');
-			expect(jwt).toEqual(BUILT_IN_SECURITY_SCHEMES.jwt);
-
-			const bearer = getSecurityScheme('bearer');
-			expect(bearer).toEqual(BUILT_IN_SECURITY_SCHEMES.bearer);
-
-			const apiKey = getSecurityScheme('apiKey');
-			expect(apiKey).toEqual(BUILT_IN_SECURITY_SCHEMES.apiKey);
-		});
-
-		it('should return undefined for unknown scheme with no custom schemes', () => {
-			const result = getSecurityScheme('unknown');
-			expect(result).toBeUndefined();
-		});
-
-		it('should return custom scheme when provided', () => {
-			const customSchemes: Record<string, SecurityScheme> = {
-				myAuth: {
-					type: 'http',
-					scheme: 'bearer',
-					bearerFormat: 'opaque',
-					description: 'My custom auth',
-				},
-			};
-
-			const result = getSecurityScheme('myAuth', customSchemes);
-			expect(result).toEqual(customSchemes.myAuth);
-		});
-
-		it('should prefer custom scheme over built-in with same name', () => {
-			const customSchemes: Record<string, SecurityScheme> = {
-				jwt: {
-					type: 'http',
-					scheme: 'bearer',
-					bearerFormat: 'CustomJWT',
-					description: 'Overridden JWT',
-				},
-			};
-
-			const result = getSecurityScheme('jwt', customSchemes);
-			expect(result?.bearerFormat).toBe('CustomJWT');
-			expect(result?.description).toBe('Overridden JWT');
-		});
-
-		it('should fall back to built-in when custom scheme not found', () => {
-			const customSchemes: Record<string, SecurityScheme> = {
-				myAuth: {
-					type: 'apiKey',
-					in: 'header',
-					name: 'X-My-Key',
-				},
-			};
-
-			const result = getSecurityScheme('jwt', customSchemes);
-			expect(result).toEqual(BUILT_IN_SECURITY_SCHEMES.jwt);
-		});
-
-		it('should return undefined when scheme not in custom or built-in', () => {
-			const customSchemes: Record<string, SecurityScheme> = {
-				myAuth: {
-					type: 'apiKey',
-					in: 'header',
-					name: 'X-My-Key',
-				},
-			};
-
-			const result = getSecurityScheme('nonexistent', customSchemes);
-			expect(result).toBeUndefined();
-		});
-
-		it('should handle empty custom schemes object', () => {
-			const result = getSecurityScheme('jwt', {});
-			expect(result).toEqual(BUILT_IN_SECURITY_SCHEMES.jwt);
-		});
-	});
-
-	describe('SecurityScheme types', () => {
-		it('should support apiKey in query', () => {
-			const scheme: SecurityScheme = {
-				type: 'apiKey',
-				in: 'query',
-				name: 'api_key',
-			};
-			expect(scheme.in).toBe('query');
-		});
-
-		it('should support apiKey in cookie', () => {
-			const scheme: SecurityScheme = {
-				type: 'apiKey',
-				in: 'cookie',
-				name: 'session',
-			};
-			expect(scheme.in).toBe('cookie');
-		});
-
-		it('should support oauth2 with all flow types', () => {
-			const scheme: SecurityScheme = {
-				type: 'oauth2',
-				flows: {
-					implicit: {
-						authorizationUrl: 'https://auth.example.com/authorize',
-						scopes: { read: 'Read access', write: 'Write access' },
-					},
-					password: {
-						tokenUrl: 'https://auth.example.com/token',
-						scopes: { admin: 'Admin access' },
-					},
-					clientCredentials: {
-						tokenUrl: 'https://auth.example.com/token',
-						scopes: { api: 'API access' },
-					},
-					authorizationCode: {
-						authorizationUrl: 'https://auth.example.com/authorize',
-						tokenUrl: 'https://auth.example.com/token',
-						refreshUrl: 'https://auth.example.com/refresh',
-						scopes: { openid: 'OpenID', profile: 'Profile' },
-					},
-				},
-			};
-
-			expect(scheme.flows?.implicit?.authorizationUrl).toBe(
-				'https://auth.example.com/authorize',
-			);
-			expect(scheme.flows?.authorizationCode?.refreshUrl).toBe(
-				'https://auth.example.com/refresh',
-			);
-		});
-
-		it('should support mutualTLS type', () => {
-			const scheme: SecurityScheme = {
-				type: 'mutualTLS',
-				description: 'Mutual TLS authentication',
-			};
-			expect(scheme.type).toBe('mutualTLS');
-		});
-
-		it('should support vendor extensions', () => {
-			const scheme: SecurityScheme = {
-				type: 'apiKey',
-				in: 'header',
-				name: 'Authorization',
-				'x-amazon-apigateway-authtype': 'custom',
-				'x-custom-extension': { nested: 'value' },
-			};
-
-			expect(scheme['x-amazon-apigateway-authtype']).toBe('custom');
-			expect(scheme['x-custom-extension']).toEqual({ nested: 'value' });
-		});
-	});
-});

package/src/endpoints/__tests__/Endpoint.cookies.spec.ts

@@ -1,207 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { Endpoint } from '../Endpoint';
-
-describe('Endpoint.createCookies', () => {
-	it('should parse single cookie', () => {
-		const cookieFn = Endpoint.createCookies('session=abc123');
-
-		expect(cookieFn('session')).toBe('abc123');
-	});
-
-	it('should parse multiple cookies', () => {
-		const cookieFn = Endpoint.createCookies(
-			'session=abc123; theme=dark; lang=en',
-		);
-
-		expect(cookieFn('session')).toBe('abc123');
-		expect(cookieFn('theme')).toBe('dark');
-		expect(cookieFn('lang')).toBe('en');
-	});
-
-	it('should handle cookies with spaces', () => {
-		const cookieFn = Endpoint.createCookies('session=abc123 ; theme=dark');
-
-		expect(cookieFn('session')).toBe('abc123');
-		expect(cookieFn('theme')).toBe('dark');
-	});
-
-	it('should handle URL encoded values', () => {
-		const cookieFn = Endpoint.createCookies(
-			'user=John%20Doe; email=john%40example.com',
-		);
-
-		expect(cookieFn('user')).toBe('John Doe');
-		expect(cookieFn('email')).toBe('john@example.com');
-	});
-
-	it('should handle cookies with equals sign in value', () => {
-		const cookieFn = Endpoint.createCookies(
-			'data=key=value; token=abc=123=xyz',
-		);
-
-		expect(cookieFn('data')).toBe('key=value');
-		expect(cookieFn('token')).toBe('abc=123=xyz');
-	});
-
-	it('should return undefined for non-existent cookie', () => {
-		const cookieFn = Endpoint.createCookies('session=abc123');
-
-		expect(cookieFn('nonexistent')).toBeUndefined();
-	});
-
-	it('should handle empty cookie string', () => {
-		const cookieFn = Endpoint.createCookies('');
-
-		expect(cookieFn('session')).toBeUndefined();
-	});
-
-	it('should handle undefined cookie string', () => {
-		const cookieFn = Endpoint.createCookies(undefined);
-
-		expect(cookieFn('session')).toBeUndefined();
-	});
-
-	it('should handle malformed cookies gracefully', () => {
-		const cookieFn = Endpoint.createCookies('session=; =value; valid=okay');
-
-		expect(cookieFn('session')).toBe('');
-		expect(cookieFn('valid')).toBe('okay');
-	});
-
-	it('should handle cookies with special characters', () => {
-		const cookieFn = Endpoint.createCookies(
-			'token=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0',
-		);
-
-		expect(cookieFn('token')).toBe(
-			'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJzdWIiOiIxMjM0NTY3ODkwIn0',
-		);
-	});
-
-	it('should handle cookies with numeric values', () => {
-		const cookieFn = Endpoint.createCookies('count=42; price=19.99');
-
-		expect(cookieFn('count')).toBe('42');
-		expect(cookieFn('price')).toBe('19.99');
-	});
-
-	it('should handle empty cookie value', () => {
-		const cookieFn = Endpoint.createCookies('empty=; session=abc123');
-
-		expect(cookieFn('empty')).toBe('');
-		expect(cookieFn('session')).toBe('abc123');
-	});
-
-	it('should preserve case sensitivity in cookie names', () => {
-		const cookieFn = Endpoint.createCookies('Session=abc; session=xyz');
-
-		expect(cookieFn('Session')).toBe('abc');
-		expect(cookieFn('session')).toBe('xyz');
-	});
-
-	it('should handle cookies with trailing semicolon', () => {
-		const cookieFn = Endpoint.createCookies('session=abc123; theme=dark;');
-
-		expect(cookieFn('session')).toBe('abc123');
-		expect(cookieFn('theme')).toBe('dark');
-	});
-
-	it('should handle complex real-world cookie string', () => {
-		const cookieFn = Endpoint.createCookies(
-			'session=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9; user_id=12345; preferences=%7B%22theme%22%3A%22dark%22%7D; _ga=GA1.2.123456789.1234567890; authenticated=true',
-		);
-
-		expect(cookieFn('session')).toBe('eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9');
-		expect(cookieFn('user_id')).toBe('12345');
-		expect(cookieFn('preferences')).toBe('{"theme":"dark"}');
-		expect(cookieFn('_ga')).toBe('GA1.2.123456789.1234567890');
-		expect(cookieFn('authenticated')).toBe('true');
-	});
-
-	describe('cookie() - get all cookies', () => {
-		it('should return all cookies as object when called without arguments', () => {
-			const cookieFn = Endpoint.createCookies(
-				'session=abc123; theme=dark; lang=en',
-			);
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({
-				session: 'abc123',
-				theme: 'dark',
-				lang: 'en',
-			});
-		});
-
-		it('should return empty object when no cookies exist', () => {
-			const cookieFn = Endpoint.createCookies(undefined);
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({});
-		});
-
-		it('should return empty object for empty cookie string', () => {
-			const cookieFn = Endpoint.createCookies('');
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({});
-		});
-
-		it('should decode URL-encoded values in all cookies', () => {
-			const cookieFn = Endpoint.createCookies(
-				'user=John%20Doe; email=john%40example.com',
-			);
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({
-				user: 'John Doe',
-				email: 'john@example.com',
-			});
-		});
-
-		it('should preserve case in cookie names when getting all', () => {
-			const cookieFn = Endpoint.createCookies(
-				'Session=abc; session=xyz; TOKEN=123',
-			);
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({
-				Session: 'abc',
-				session: 'xyz',
-				TOKEN: '123',
-			});
-		});
-
-		it('should handle cookies with equals sign in values', () => {
-			const cookieFn = Endpoint.createCookies(
-				'data=key=value; token=abc=123=xyz',
-			);
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({
-				data: 'key=value',
-				token: 'abc=123=xyz',
-			});
-		});
-
-		it('should work with complex real-world cookie string', () => {
-			const cookieFn = Endpoint.createCookies(
-				'session=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9; user_id=12345; preferences=%7B%22theme%22%3A%22dark%22%7D; authenticated=true',
-			);
-
-			const allCookies = cookieFn();
-
-			expect(allCookies).toEqual({
-				session: 'eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9',
-				user_id: '12345',
-				preferences: '{"theme":"dark"}',
-				authenticated: 'true',
-			});
-		});
-	});
-});

package/src/endpoints/__tests__/Endpoint.headers.spec.ts

@@ -1,187 +0,0 @@
-import { describe, expect, it } from 'vitest';
-import { Endpoint } from '../Endpoint';
-
-describe('Endpoint.createHeaders', () => {
-	it('should get single header value', () => {
-		const headerFn = Endpoint.createHeaders({
-			'Content-Type': 'application/json',
-			Host: 'example.com',
-		});
-
-		expect(headerFn('content-type')).toBe('application/json');
-		expect(headerFn('host')).toBe('example.com');
-	});
-
-	it('should be case-insensitive for header names', () => {
-		const headerFn = Endpoint.createHeaders({
-			'Content-Type': 'application/json',
-		});
-
-		expect(headerFn('content-type')).toBe('application/json');
-		expect(headerFn('Content-Type')).toBe('application/json');
-		expect(headerFn('CONTENT-TYPE')).toBe('application/json');
-		expect(headerFn('CoNtEnT-tYpE')).toBe('application/json');
-	});
-
-	it('should return undefined for non-existent header', () => {
-		const headerFn = Endpoint.createHeaders({
-			'Content-Type': 'application/json',
-		});
-
-		expect(headerFn('Authorization')).toBeUndefined();
-	});
-
-	it('should handle empty headers object', () => {
-		const headerFn = Endpoint.createHeaders({});
-
-		expect(headerFn('Content-Type')).toBeUndefined();
-	});
-
-	it('should handle headers with special characters', () => {
-		const headerFn = Endpoint.createHeaders({
-			'X-Custom-Header': 'value-with-dashes',
-			'X-Request-ID': '12345-67890-abcdef',
-		});
-
-		expect(headerFn('x-custom-header')).toBe('value-with-dashes');
-		expect(headerFn('X-REQUEST-ID')).toBe('12345-67890-abcdef');
-	});
-
-	it('should handle standard HTTP headers', () => {
-		const headerFn = Endpoint.createHeaders({
-			'Content-Type': 'application/json',
-			'Content-Length': '1234',
-			Authorization: 'Bearer token123',
-			'User-Agent': 'Mozilla/5.0',
-			Accept: 'application/json',
-			'Accept-Language': 'en-US,en;q=0.9',
-			'Cache-Control': 'no-cache',
-		});
-
-		expect(headerFn('content-type')).toBe('application/json');
-		expect(headerFn('content-length')).toBe('1234');
-		expect(headerFn('authorization')).toBe('Bearer token123');
-		expect(headerFn('user-agent')).toBe('Mozilla/5.0');
-		expect(headerFn('accept')).toBe('application/json');
-		expect(headerFn('accept-language')).toBe('en-US,en;q=0.9');
-		expect(headerFn('cache-control')).toBe('no-cache');
-	});
-
-	it('should handle forwarded headers', () => {
-		const headerFn = Endpoint.createHeaders({
-			'X-Forwarded-For': '203.0.113.1',
-			'X-Forwarded-Proto': 'https',
-			'X-Real-IP': '203.0.113.1',
-		});
-
-		expect(headerFn('x-forwarded-for')).toBe('203.0.113.1');
-		expect(headerFn('x-forwarded-proto')).toBe('https');
-		expect(headerFn('x-real-ip')).toBe('203.0.113.1');
-	});
-
-	describe('header() - get all headers', () => {
-		it('should return all headers as object when called without arguments', () => {
-			const headerFn = Endpoint.createHeaders({
-				'Content-Type': 'application/json',
-				Host: 'example.com',
-				Authorization: 'Bearer token123',
-			});
-
-			const allHeaders = headerFn();
-
-			expect(allHeaders).toEqual({
-				'content-type': 'application/json',
-				host: 'example.com',
-				authorization: 'Bearer token123',
-			});
-		});
-
-		it('should return empty object when no headers exist', () => {
-			const headerFn = Endpoint.createHeaders({});
-
-			const allHeaders = headerFn();
-
-			expect(allHeaders).toEqual({});
-		});
-
-		it('should normalize all header names to lowercase', () => {
-			const headerFn = Endpoint.createHeaders({
-				'Content-Type': 'application/json',
-				HOST: 'example.com',
-				'X-Custom-Header': 'value',
-			});
-
-			const allHeaders = headerFn();
-
-			expect(allHeaders).toEqual({
-				'content-type': 'application/json',
-				host: 'example.com',
-				'x-custom-header': 'value',
-			});
-		});
-
-		it('should work with standard HTTP headers', () => {
-			const headerFn = Endpoint.createHeaders({
-				'Content-Type': 'application/json',
-				'Content-Length': '1234',
-				Authorization: 'Bearer token123',
-				'User-Agent': 'Mozilla/5.0',
-				Accept: 'application/json',
-			});
-
-			const allHeaders = headerFn();
-
-			expect(allHeaders).toEqual({
-				'content-type': 'application/json',
-				'content-length': '1234',
-				authorization: 'Bearer token123',
-				'user-agent': 'Mozilla/5.0',
-				accept: 'application/json',
-			});
-		});
-
-		it('should work with custom and forwarded headers', () => {
-			const headerFn = Endpoint.createHeaders({
-				'X-Forwarded-For': '203.0.113.1',
-				'X-Forwarded-Proto': 'https',
-				'X-Request-ID': 'req-123',
-				'X-Custom-Header': 'custom-value',
-			});
-
-			const allHeaders = headerFn();
-
-			expect(allHeaders).toEqual({
-				'x-forwarded-for': '203.0.113.1',
-				'x-forwarded-proto': 'https',
-				'x-request-id': 'req-123',
-				'x-custom-header': 'custom-value',
-			});
-		});
-
-		it('should handle complex real-world headers', () => {
-			const headerFn = Endpoint.createHeaders({
-				'Content-Type': 'application/json; charset=utf-8',
-				Host: 'api.example.com',
-				Connection: 'keep-alive',
-				'User-Agent':
-					'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
-				Accept: '*/*',
-				'Accept-Encoding': 'gzip, deflate, br',
-				'Accept-Language': 'en-US,en;q=0.9',
-				Authorization: 'Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9',
-				'Cache-Control': 'no-cache',
-				Origin: 'https://example.com',
-				Referer: 'https://example.com/dashboard',
-				'X-Requested-With': 'XMLHttpRequest',
-			});
-
-			const allHeaders = headerFn();
-
-			expect(allHeaders).toHaveProperty('content-type');
-			expect(allHeaders).toHaveProperty('host');
-			expect(allHeaders).toHaveProperty('authorization');
-			expect(allHeaders).toHaveProperty('user-agent');
-			expect(Object.keys(allHeaders).length).toBe(12);
-		});
-	});
-});