@geekmidas/constructs 9.0.2 → 10.0.0-alpha.1

package/src/crons/__tests__/Cron.spec.ts

@@ -1,464 +0,0 @@
-import { ConsoleLogger } from '@geekmidas/logger/console';
-import type { Service } from '@geekmidas/services';
-import { describe, expect, it, vi } from 'vitest';
-import { z } from 'zod';
-import { ConstructType } from '../../Construct';
-import { Cron, type CronExpression, type RateExpression } from '../Cron';
-import { CronBuilder } from '../CronBuilder';
-
-// Mock service for testing
-class MockService implements Service<'MockService', MockService> {
-	serviceName = 'MockService' as const;
-
-	async register() {
-		return this;
-	}
-
-	getValue() {
-		return 'mock-value';
-	}
-}
-
-describe('Cron', () => {
-	describe('Cron class', () => {
-		it('should create a Cron instance with basic handler', () => {
-			const handler = vi.fn().mockResolvedValue({ success: true });
-			const cron = new Cron(handler);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.type).toBe(ConstructType.Cron);
-			expect(cron.timeout).toBe(30000); // Default timeout
-			// The handler is stored in the protected fn property
-		});
-
-		it('should create a Cron instance with timeout', () => {
-			const handler = vi.fn().mockResolvedValue({ data: 'test' });
-			const timeout = 60000;
-			const cron = new Cron(handler, timeout);
-
-			expect(cron.timeout).toBe(timeout);
-		});
-
-		it('should create a Cron instance with schedule expression', () => {
-			const handler = vi.fn();
-			const schedule: CronExpression = 'cron(0 12 * * MON)';
-			const cron = new Cron(handler, undefined, schedule);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.type).toBe(ConstructType.Cron);
-			// Schedule is protected, so we can't directly test it, but it should be set
-		});
-
-		it('should create a Cron instance with input schema', () => {
-			const inputSchema = z.object({
-				id: z.string(),
-				count: z.number(),
-			});
-
-			const handler = vi.fn().mockImplementation(async ({ input }) => {
-				return { processed: input.id };
-			});
-
-			const cron = new Cron(handler, undefined, undefined, inputSchema);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.input).toBe(inputSchema);
-		});
-
-		it('should create a Cron instance with output schema', () => {
-			const outputSchema = z.object({
-				result: z.string(),
-				timestamp: z.number(),
-			});
-
-			const handler = vi.fn().mockResolvedValue({
-				result: 'success',
-				timestamp: Date.now(),
-			});
-
-			const cron = new Cron(
-				handler,
-				undefined,
-				undefined,
-				undefined,
-				outputSchema,
-			);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.outputSchema).toBe(outputSchema);
-		});
-
-		it('should create a Cron instance with services', () => {
-			const mockService = new MockService();
-			const services = [mockService];
-
-			const handler = vi.fn().mockImplementation(async ({ services }) => {
-				return { value: services.MockService.getValue() };
-			});
-
-			const cron = new Cron(
-				handler,
-				undefined,
-				undefined,
-				undefined,
-				undefined,
-				services,
-			);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.services).toEqual(services);
-		});
-
-		it('should create a Cron instance with custom logger', () => {
-			const customLogger = new ConsoleLogger();
-
-			const handler = vi.fn().mockImplementation(async ({ logger }) => {
-				logger.info('Cron executed');
-				return { logged: true };
-			});
-
-			const cron = new Cron(
-				handler,
-				undefined,
-				undefined,
-				undefined,
-				undefined,
-				[],
-				customLogger,
-			);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.logger).toBe(customLogger);
-		});
-
-		it('should create a Cron with all parameters', () => {
-			const inputSchema = z.object({ name: z.string() });
-			const outputSchema = z.object({ greeting: z.string() });
-			const schedule: RateExpression = 'rate(5 minutes)';
-			const timeout = 60000;
-			const service = new MockService();
-			const logger = new ConsoleLogger();
-
-			const handler = vi
-				.fn()
-				.mockImplementation(async ({ input, services }) => {
-					return {
-						greeting: `Hello ${input.name} from ${services.MockService.getValue()}`,
-					};
-				});
-
-			const cron = new Cron(
-				handler,
-				timeout,
-				schedule,
-				inputSchema,
-				outputSchema,
-				[service],
-				logger,
-			);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.type).toBe(ConstructType.Cron);
-			expect(cron.timeout).toBe(timeout);
-			expect(cron.input).toBe(inputSchema);
-			expect(cron.outputSchema).toBe(outputSchema);
-			expect(cron.services).toEqual([service]);
-			expect(cron.logger).toBe(logger);
-		});
-	});
-
-	describe('Cron.isCron', () => {
-		it('should return true for Cron instances', () => {
-			const cron = new Cron(vi.fn());
-			expect(Cron.isCron(cron)).toBe(true);
-		});
-
-		it('should return false for non-Cron objects', () => {
-			expect(Cron.isCron({})).toBe(false);
-			expect(Cron.isCron(null)).toBeFalsy();
-			expect(Cron.isCron(undefined)).toBeFalsy();
-			expect(Cron.isCron('string')).toBe(false);
-			expect(Cron.isCron(123)).toBe(false);
-			expect(Cron.isCron([])).toBe(false);
-		});
-
-		it('should return false for objects with similar structure', () => {
-			const fakeCron = {
-				__IS_FUNCTION__: true,
-				type: 'SomethingElse',
-			};
-			expect(Cron.isCron(fakeCron)).toBe(false);
-		});
-
-		it('should return false for objects with __IS_FUNCTION__ but wrong type', () => {
-			const fakeFunction = {
-				__IS_FUNCTION__: true,
-				type: ConstructType.Function,
-			};
-			expect(Cron.isCron(fakeFunction)).toBe(false);
-		});
-	});
-
-	describe('CronBuilder', () => {
-		it('should create a CronBuilder instance', () => {
-			const builder = new CronBuilder();
-			expect(builder).toBeInstanceOf(CronBuilder);
-		});
-
-		it('should set schedule with schedule() method', () => {
-			const builder = new CronBuilder();
-			const schedule: CronExpression = 'cron(0 0 * * SUN)';
-
-			const result = builder.schedule(schedule);
-			expect(result).toBe(builder); // Should return self for chaining
-		});
-
-		it('should build Cron with handle() method', () => {
-			const builder = new CronBuilder();
-			const handler = vi.fn().mockResolvedValue({ done: true });
-
-			const cron = builder.handle(handler);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.type).toBe(ConstructType.Cron);
-		});
-
-		it('should build Cron with full builder chain', () => {
-			const inputSchema = z.object({ task: z.string() });
-			const outputSchema = z.object({ completed: z.boolean() });
-			const schedule: RateExpression = 'rate(1 hour)';
-			const service = new MockService();
-			const logger = new ConsoleLogger();
-
-			const handler = vi.fn().mockImplementation(async ({ input }) => {
-				return { completed: input.task === 'test' };
-			});
-
-			const cron = new CronBuilder()
-				.input(inputSchema)
-				.output(outputSchema)
-				.services([service])
-				.logger(logger)
-				.timeout(45000)
-				.schedule(schedule)
-				.handle(handler);
-
-			expect(cron).toBeInstanceOf(Cron);
-			expect(cron.type).toBe(ConstructType.Cron);
-			expect(cron.timeout).toBe(45000);
-			expect(cron.input).toBe(inputSchema);
-			expect(cron.outputSchema).toBe(outputSchema);
-			expect(cron.services).toEqual([service]);
-			expect(cron.logger).toBe(logger);
-		});
-
-		it('should support method chaining in any order', () => {
-			const builder = new CronBuilder();
-			const schedule: CronExpression = 'cron(30 2 * * TUE)';
-
-			const chained = builder
-				.timeout(30000)
-				.schedule(schedule)
-				.input(z.object({ data: z.string() }));
-
-			expect(chained).toBe(builder);
-		});
-	});
-
-	describe('Schedule Expression Types', () => {
-		it('should accept valid rate expressions', () => {
-			const validRates: RateExpression[] = [
-				'rate(5 minutes)',
-				'rate(1 hour)',
-				'rate(7 days)',
-				'rate(30 seconds)',
-				'rate(2 weeks)',
-			];
-
-			validRates.forEach((rate) => {
-				const builder = new CronBuilder();
-				expect(() => builder.schedule(rate)).not.toThrow();
-			});
-		});
-
-		it('should accept valid cron expressions', () => {
-			const validCrons: CronExpression[] = [
-				'cron(0 12 * * MON)',
-				'cron(15 10 * * FRI)',
-				'cron(0 0 1 JAN SUN)',
-				'cron(*/5 * * * *)',
-				'cron(0 0-23/2 * * *)',
-				'cron(30 4 1,15 * *)',
-				'cron(0 12 * DEC MON)',
-			];
-
-			validCrons.forEach((cron) => {
-				const builder = new CronBuilder();
-				expect(() => builder.schedule(cron)).not.toThrow();
-			});
-		});
-
-		it('should work with complex cron patterns', () => {
-			const complexPatterns: CronExpression[] = [
-				'cron(*/15 * * * *)', // Every 15 minutes
-				'cron(0 */4 * * *)', // Every 4 hours
-				'cron(0 9-17 * * MON-FRI)', // Every hour 9-5 on weekdays
-				'cron(0 0 1-7 * SUN)', // First Sunday of month
-				'cron(*/30 8-18 * * *)', // Every 30 min during business hours
-			];
-
-			complexPatterns.forEach((pattern) => {
-				const builder = new CronBuilder();
-				expect(() => builder.schedule(pattern)).not.toThrow();
-			});
-		});
-
-		it('should handle all month names', () => {
-			const months: CronExpression[] = [
-				'cron(0 0 1 JAN *)',
-				'cron(0 0 1 FEB *)',
-				'cron(0 0 1 MAR *)',
-				'cron(0 0 1 APR *)',
-				'cron(0 0 1 MAY *)',
-				'cron(0 0 1 JUN *)',
-				'cron(0 0 1 JUL *)',
-				'cron(0 0 1 AUG *)',
-				'cron(0 0 1 SEP *)',
-				'cron(0 0 1 OCT *)',
-				'cron(0 0 1 NOV *)',
-				'cron(0 0 1 DEC *)',
-			];
-
-			months.forEach((expression) => {
-				const builder = new CronBuilder();
-				expect(() => builder.schedule(expression)).not.toThrow();
-			});
-		});
-
-		it('should handle all weekday names', () => {
-			const weekdays: CronExpression[] = [
-				'cron(0 0 * * SUN)',
-				'cron(0 0 * * MON)',
-				'cron(0 0 * * TUE)',
-				'cron(0 0 * * WED)',
-				'cron(0 0 * * THU)',
-				'cron(0 0 * * FRI)',
-				'cron(0 0 * * SAT)',
-			];
-
-			weekdays.forEach((expression) => {
-				const builder = new CronBuilder();
-				expect(() => builder.schedule(expression)).not.toThrow();
-			});
-		});
-	});
-
-	describe('Cron configuration', () => {
-		it('should store handler with error handling capability', () => {
-			const error = new Error('Cron execution failed');
-			const handler = vi.fn().mockRejectedValue(error);
-
-			const cron = new Cron(handler);
-
-			expect(cron).toBeInstanceOf(Cron);
-			// Handler is stored but not directly accessible (protected)
-		});
-
-		it('should store input schema for validation', () => {
-			const inputSchema = z.object({
-				id: z.string().uuid(),
-				amount: z.number().positive(),
-			});
-
-			const handler = vi.fn();
-			const cron = new Cron(handler, undefined, undefined, inputSchema);
-
-			expect(cron.input).toBe(inputSchema);
-		});
-
-		it('should store output schema for validation', () => {
-			const outputSchema = z.object({
-				status: z.enum(['success', 'failure']),
-				count: z.number().int(),
-			});
-
-			const handler = vi.fn().mockResolvedValue({
-				status: 'invalid',
-				count: 3.14,
-			});
-
-			const cron = new Cron(
-				handler,
-				undefined,
-				undefined,
-				undefined,
-				outputSchema,
-			);
-
-			expect(cron.outputSchema).toBe(outputSchema);
-		});
-
-		it('should work with multiple services', () => {
-			class ServiceA implements Service<'ServiceA', ServiceA> {
-				serviceName = 'ServiceA' as const;
-				async register() {
-					return this;
-				}
-				getA() {
-					return 'A';
-				}
-			}
-
-			class ServiceB implements Service<'ServiceB', ServiceB> {
-				serviceName = 'ServiceB' as const;
-				async register() {
-					return this;
-				}
-				getB() {
-					return 'B';
-				}
-			}
-
-			const services = [new ServiceA(), new ServiceB()];
-
-			const handler = vi.fn().mockImplementation(async ({ services }) => {
-				return {
-					a: services.ServiceA.getA(),
-					b: services.ServiceB.getB(),
-				};
-			});
-
-			const cron = new Cron(
-				handler,
-				undefined,
-				undefined,
-				undefined,
-				undefined,
-				services,
-			);
-
-			expect(cron.services).toEqual(services);
-		});
-
-		it('should maintain separate instances with different configurations', () => {
-			const handler1 = vi.fn().mockResolvedValue({ cron: 1 });
-			const handler2 = vi.fn().mockResolvedValue({ cron: 2 });
-
-			const cron1 = new CronBuilder()
-				.timeout(1000)
-				.schedule('rate(5 minutes)')
-				.handle(handler1);
-
-			const cron2 = new CronBuilder()
-				.timeout(2000)
-				.schedule('cron(0 0 * * *)')
-				.handle(handler2);
-
-			expect(cron1).toBeInstanceOf(Cron);
-			expect(cron2).toBeInstanceOf(Cron);
-			expect(cron1.timeout).toBe(1000);
-			expect(cron2.timeout).toBe(2000);
-			expect(cron1).not.toBe(cron2);
-		});
-	});
-});

package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts

@@ -1,227 +0,0 @@
-import { ConsoleLogger } from '@geekmidas/logger/console';
-import type { Service } from '@geekmidas/services';
-import { describe, expect, it } from 'vitest';
-import { CronBuilder } from '../CronBuilder';
-
-const ServiceA = {
-	serviceName: 'a' as const,
-	async register() {
-		return { test: () => 'a' };
-	},
-} satisfies Service<'a', any>;
-
-const ServiceB = {
-	serviceName: 'b' as const,
-	async register() {
-		return { test: () => 'b' };
-	},
-} satisfies Service<'b', any>;
-
-describe('CronBuilder - State Isolation', () => {
-	describe('singleton instance state reset', () => {
-		it('should reset services after handle() is called', () => {
-			const c = new CronBuilder();
-
-			// First cron with ServiceA and ServiceB
-			const cron1 = c
-				.schedule('rate(5 minutes)')
-				.services([ServiceA, ServiceB])
-				.handle(async () => ({}));
-
-			// Second cron should not have any services from first
-			const cron2 = c.schedule('rate(10 minutes)').handle(async () => ({}));
-
-			expect(cron1.services.map((s) => s.serviceName)).toEqual(['a', 'b']);
-			expect(cron2.services.map((s) => s.serviceName)).toEqual([]);
-		});
-
-		it('should reset logger after handle() is called', () => {
-			const c = new CronBuilder();
-			const customLogger = new ConsoleLogger({ app: 'custom' });
-
-			// First cron with custom logger
-			const cron1 = c
-				.schedule('rate(5 minutes)')
-				.logger(customLogger)
-				.handle(async () => ({}));
-
-			// Second cron should have default logger (not the custom one)
-			const cron2 = c.schedule('rate(10 minutes)').handle(async () => ({}));
-
-			expect(cron1.logger).toBe(customLogger);
-			expect(cron2.logger).not.toBe(customLogger);
-			expect(cron2.logger).toBeInstanceOf(ConsoleLogger);
-		});
-
-		it('should reset schedule after handle() is called', () => {
-			const c = new CronBuilder();
-
-			// First cron with schedule
-			const cron1 = c.schedule('rate(5 minutes)').handle(async () => ({}));
-
-			// Second cron should not have schedule from first
-			const cron2 = c.schedule('rate(10 minutes)').handle(async () => ({}));
-
-			expect(cron1.schedule).toBe('rate(5 minutes)');
-			expect(cron2.schedule).toBe('rate(10 minutes)');
-
-			// Check internal state is reset
-			expect((c as any)._schedule).toBeUndefined();
-		});
-
-		it('should reset events after handle() is called', () => {
-			const c = new CronBuilder();
-
-			// Create first cron (events array should be empty initially)
-			const _cron1 = c.schedule('rate(5 minutes)').handle(async () => ({}));
-
-			// Verify state was reset
-			expect((c as any)._events).toEqual([]);
-			expect((c as any)._services).toEqual([]);
-			expect((c as any)._schedule).toBeUndefined();
-		});
-
-		it('should reset input/output schemas after handle() is called', () => {
-			const c = new CronBuilder();
-			const inputSchema: any = { '~standard': { validate: () => ({}) } };
-			const outputSchema: any = { '~standard': { validate: () => ({}) } };
-
-			// First cron with schemas
-			const cron1 = c
-				.schedule('rate(5 minutes)')
-				.input(inputSchema)
-				.output(outputSchema)
-				.handle(async () => ({}));
-
-			// Second cron should not have schemas
-			const cron2 = c.schedule('rate(10 minutes)').handle(async () => ({}));
-
-			expect(cron1.input).toBe(inputSchema);
-			expect(cron1.outputSchema).toBe(outputSchema);
-			expect(cron2.input).toBeUndefined();
-			expect(cron2.outputSchema).toBeUndefined();
-		});
-
-		it('should reset timeout after handle() is called', () => {
-			const c = new CronBuilder();
-
-			// First cron with custom timeout
-			const cron1 = c
-				.schedule('rate(5 minutes)')
-				.timeout(5000)
-				.handle(async () => ({}));
-
-			// Second cron should have default timeout (30000)
-			const cron2 = c.schedule('rate(10 minutes)').handle(async () => ({}));
-
-			expect(cron1.timeout).toBe(5000);
-			expect(cron2.timeout).toBe(30000); // Default timeout
-		});
-	});
-
-	describe('method chaining before handle()', () => {
-		it('should accumulate services when chaining', () => {
-			const c = new CronBuilder();
-
-			const cron = c
-				.schedule('rate(5 minutes)')
-				.services([ServiceA])
-				.services([ServiceB])
-				.handle(async () => ({}));
-
-			expect(cron.services.map((s) => s.serviceName)).toEqual(['a', 'b']);
-		});
-
-		it('should not share references between different builder chains', () => {
-			const c = new CronBuilder();
-
-			// Start two separate chains
-			const builder1 = c.schedule('rate(5 minutes)').services([ServiceA]);
-			const builder2 = c.schedule('rate(10 minutes)').services([ServiceB]);
-
-			// They should be the same instance (singleton)
-			expect(builder1).toBe(builder2);
-			expect(builder1).toBe(c);
-
-			// But after handle, state is reset
-			const cron1 = builder1.handle(async () => ({}));
-
-			// Now builder2 should have reset state
-			expect((builder2 as any)._services).toEqual([]);
-
-			// Add services again
-			const cron2 = builder2
-				.schedule('rate(15 minutes)')
-				.services([ServiceB])
-				.handle(async () => ({}));
-
-			expect(cron1.services.map((s) => s.serviceName)).toEqual(['a', 'b']);
-			expect(cron2.services.map((s) => s.serviceName)).toEqual(['b']);
-		});
-	});
-
-	describe('sequential cron creation', () => {
-		it('should create independent crons sequentially', () => {
-			const c = new CronBuilder();
-
-			const cron1 = c
-				.schedule('rate(5 minutes)')
-				.services([ServiceA, ServiceB])
-				.handle(async () => ({ result: 1 }));
-
-			const cron2 = c
-				.schedule('rate(10 minutes)')
-				.services([ServiceA])
-				.handle(async () => ({ result: 2 }));
-
-			const cron3 = c
-				.schedule('rate(15 minutes)')
-				.handle(async () => ({ result: 3 }));
-
-			expect(cron1.services.map((s) => s.serviceName)).toEqual(['a', 'b']);
-			expect(cron1.schedule).toBe('rate(5 minutes)');
-
-			expect(cron2.services.map((s) => s.serviceName)).toEqual(['a']);
-			expect(cron2.schedule).toBe('rate(10 minutes)');
-
-			expect(cron3.services.map((s) => s.serviceName)).toEqual([]);
-			expect(cron3.schedule).toBe('rate(15 minutes)');
-		});
-	});
-
-	describe('publisher isolation', () => {
-		it('should reset publisher after handle() is called', () => {
-			const c = new CronBuilder();
-			const mockPublisher: any = {
-				serviceName: 'publisher',
-				async register() {
-					return { publish: () => {} };
-				},
-			};
-
-			const cron1 = c
-				.schedule('rate(5 minutes)')
-				.publisher(mockPublisher)
-				.handle(async () => ({}));
-
-			const cron2 = c.schedule('rate(10 minutes)').handle(async () => ({}));
-
-			expect((cron1 as any).publisherService).toBe(mockPublisher);
-			expect((cron2 as any).publisherService).toBeUndefined();
-		});
-	});
-
-	describe('cron expression types', () => {
-		it('should handle different schedule expression formats', () => {
-			const c = new CronBuilder();
-
-			const cron1 = c.schedule('rate(5 minutes)').handle(async () => ({}));
-			const cron2 = c.schedule('cron(0 12 * * ? *)').handle(async () => ({}));
-			const cron3 = c.schedule('rate(1 hour)').handle(async () => ({}));
-
-			expect(cron1.schedule).toBe('rate(5 minutes)');
-			expect(cron2.schedule).toBe('cron(0 12 * * ? *)');
-			expect(cron3.schedule).toBe('rate(1 hour)');
-		});
-	});
-});

package/src/crons/index.ts

@@ -1,12 +0,0 @@
-export { AWSScheduledFunction } from './AWSScheduledFunction';
-export {
-	Cron,
-	type CronExpression,
-	type RateExpression,
-	type ScheduleExpression,
-} from './Cron';
-export { CronBuilder } from './CronBuilder';
-
-import { CronBuilder } from './CronBuilder';
-
-export const c = new CronBuilder();