@geekmidas/constructs 9.0.2 → 10.0.0-alpha.1

package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts

@@ -1,317 +0,0 @@
-import type { EnvironmentParser } from '@geekmidas/envkit';
-import type { Logger } from '@geekmidas/logger';
-import { Hono } from 'hono';
-import { describe, expect, it } from 'vitest';
-import { z } from 'zod/v4';
-import { Endpoint, e } from '../';
-
-import { HonoEndpoint } from '../HonoEndpointAdaptor';
-
-describe('HonoEndpoint OpenAPI Documentation', () => {
-	const logger = {
-		child: () => logger,
-		info: () => {},
-		error: () => {},
-		warn: () => {},
-		debug: () => {},
-	} as unknown as Logger;
-	const _mockEnvParser = {} as EnvironmentParser<{}>;
-
-	it('should generate OpenAPI documentation at /docs by default', async () => {
-		// Create test endpoints
-		const getUserEndpoint = new Endpoint({
-			route: '/users/:id',
-			method: 'GET',
-			fn: async ({ params }) => ({ id: params.id, name: 'John Doe' }),
-			input: {
-				params: z.object({
-					id: z.string().describe('User ID'),
-				}),
-			},
-			output: z.object({
-				id: z.string(),
-				name: z.string(),
-			}),
-			description: 'Get user by ID',
-			services: [],
-			logger,
-			timeout: undefined,
-			memorySize: undefined,
-			authorize: undefined,
-			getSession: undefined,
-			status: undefined,
-		});
-
-		const createUserEndpoint = e
-			.post('/users')
-			.description('Create a new user')
-			.body(
-				z.object({
-					name: z.string().describe('User name'),
-				}),
-			)
-			.output(
-				z.object({
-					id: z.string(),
-					name: z.string(),
-				}),
-			)
-			.handle(({ body }) => ({ id: '123', name: body.name }));
-
-		const endpoints = [getUserEndpoint, createUserEndpoint] as Endpoint<
-			any,
-			any,
-			any,
-			any,
-			any,
-			any,
-			any
-		>[];
-
-		const app = new Hono();
-
-		// Manually add routes for testing
-		HonoEndpoint.addRoutes(
-			endpoints,
-			{ register: async () => ({}) } as any,
-			app,
-		);
-
-		// Test the docs endpoint
-		const response = await app.request('/docs');
-		expect(response.status).toBe(200);
-
-		const openApiSchema = await response.json();
-		expect(openApiSchema).toMatchObject({
-			openapi: '3.0.0',
-			info: {
-				title: 'API',
-				version: '1.0.0',
-			},
-			paths: {
-				'/users/{id}': {
-					parameters: [
-						{
-							name: 'id',
-							in: 'path',
-							required: true,
-							schema: expect.objectContaining({
-								type: 'string',
-								description: 'User ID',
-							}),
-						},
-					],
-					get: {
-						description: 'Get user by ID',
-						responses: {
-							'200': expect.objectContaining({
-								description: 'Successful response',
-							}),
-						},
-					},
-				},
-				'/users': {
-					post: {
-						description: 'Create a new user',
-						requestBody: {
-							required: true,
-							content: {
-								'application/json': {
-									schema: expect.any(Object),
-								},
-							},
-						},
-						responses: {
-							'200': expect.objectContaining({
-								description: 'Successful response',
-							}),
-						},
-					},
-				},
-			},
-		});
-	});
-
-	it('should allow custom docs path', async () => {
-		const endpoint = new Endpoint({
-			route: '/test',
-			method: 'GET',
-			fn: async () => ({ message: 'test' }),
-			output: z.object({ message: z.string() }),
-			services: [],
-			logger,
-			timeout: undefined,
-			memorySize: undefined,
-			authorize: undefined,
-			getSession: undefined,
-			status: undefined,
-			description: undefined,
-			input: undefined,
-		});
-
-		const endpoints = [endpoint] as Endpoint<
-			any,
-			any,
-			any,
-			any,
-			any,
-			any,
-			any
-		>[];
-
-		const app = new Hono();
-		HonoEndpoint.addRoutes(
-			endpoints,
-			{ register: async () => ({}) } as any,
-			app,
-			{ docsPath: '/api-docs' },
-		);
-
-		const response = await app.request('/api-docs');
-		expect(response.status).toBe(200);
-
-		const openApiSchema = await response.json();
-		expect(openApiSchema.paths).toHaveProperty('/test');
-	});
-
-	it('should disable docs route when docsPath is false', async () => {
-		const endpoint = new Endpoint({
-			route: '/test',
-			method: 'GET',
-			fn: async () => ({ message: 'test' }),
-			services: [],
-			logger,
-			timeout: undefined,
-			memorySize: undefined,
-			authorize: undefined,
-			getSession: undefined,
-			status: undefined,
-			description: undefined,
-			input: undefined,
-			output: undefined,
-		});
-
-		const endpoints = [endpoint] as Endpoint<
-			any,
-			any,
-			any,
-			any,
-			any,
-			any,
-			any
-		>[];
-
-		const app = new Hono();
-		HonoEndpoint.addRoutes(
-			endpoints,
-			{ register: async () => ({}) } as any,
-			app,
-			{ docsPath: false },
-		);
-
-		const response = await app.request('/docs');
-		expect(response.status).toBe(404);
-	});
-
-	it('should include custom OpenAPI options', async () => {
-		const endpoint = new Endpoint({
-			route: '/test',
-			method: 'GET',
-			fn: async () => ({ message: 'test' }),
-			services: [],
-			logger,
-			timeout: undefined,
-			memorySize: undefined,
-			authorize: undefined,
-			getSession: undefined,
-			status: undefined,
-			description: undefined,
-			input: undefined,
-			output: undefined,
-		});
-		const endpoints = [endpoint] as Endpoint<
-			any,
-			any,
-			any,
-			any,
-			any,
-			any,
-			any
-		>[];
-
-		const app = new Hono();
-		HonoEndpoint.addRoutes(
-			endpoints,
-			{ register: async () => ({}) } as any,
-			app,
-			{
-				openApiOptions: {
-					title: 'My Custom API',
-					version: '2.0.0',
-					description: 'This is a custom API description',
-				},
-			},
-		);
-
-		const response = await app.request('/docs');
-		const openApiSchema = await response.json();
-
-		expect(openApiSchema.info).toEqual({
-			title: 'My Custom API',
-			version: '2.0.0',
-			description: 'This is a custom API description',
-		});
-	});
-
-	it('should include tags in OpenAPI documentation', async () => {
-		const userEndpoint = e
-			.get('/users/:id')
-			.description('Get user by ID')
-			.tags(['users', 'profile'])
-			.params(z.object({ id: z.string().describe('User ID') }))
-			.output(z.object({ id: z.string(), name: z.string() }))
-			.handle(({ params }) => ({ id: params.id, name: 'John Doe' }));
-
-		const adminEndpoint = e
-			.post('/admin/settings')
-			.description('Update admin settings')
-			.tags(['admin', 'settings'])
-			.body(z.object({ setting: z.string() }))
-			.output(z.object({ success: z.boolean() }))
-			.handle(() => ({ success: true }));
-
-		const endpoints = [userEndpoint, adminEndpoint] as Endpoint<
-			any,
-			any,
-			any,
-			any,
-			any,
-			any,
-			any
-		>[];
-
-		const app = new Hono();
-		HonoEndpoint.addRoutes(
-			endpoints,
-			{ register: async () => ({}) } as any,
-			app,
-		);
-
-		const response = await app.request('/docs');
-		expect(response.status).toBe(200);
-
-		const openApiSchema = await response.json();
-
-		// Check that the user endpoint has the correct tags
-		expect(openApiSchema.paths['/users/{id}'].get.tags).toEqual([
-			'users',
-			'profile',
-		]);
-
-		// Check that the admin endpoint has the correct tags
-		expect(openApiSchema.paths['/admin/settings'].post.tags).toEqual([
-			'admin',
-			'settings',
-		]);
-	});
-});

package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts

@@ -1,289 +0,0 @@
-import { EnvironmentParser } from '@geekmidas/envkit';
-import type { EventPublisher, PublishableMessage } from '@geekmidas/events';
-import {
-	PgBossConnection,
-	PgBossPublisher,
-	PgBossSubscriber,
-} from '@geekmidas/events/pgboss';
-import type { Service } from '@geekmidas/services';
-import { ServiceDiscovery } from '@geekmidas/services';
-import { Hono } from 'hono';
-import { Client } from 'pg';
-import { afterAll, beforeAll, describe, expect, it } from 'vitest';
-import { z } from 'zod';
-import { e } from '../EndpointFactory';
-import { HonoEndpoint } from '../HonoEndpointAdaptor';
-
-type OrderEvent =
-	| PublishableMessage<'order.created', { orderId: string; total: number }>
-	| PublishableMessage<'notification.sent', { orderId: string; type: string }>;
-
-const POSTGRES_URL = 'postgres://geekmidas:geekmidas@localhost:5432/geekmidas';
-const TEST_SCHEMA = 'pgboss_hono_publisher_test';
-
-const uniqueQueue = () =>
-	`test-${Date.now()}-${Math.random().toString(36).substring(7)}`;
-
-// Drop the test schema before pg-boss runs. Without this, a stale schema left
-// behind by an older pg-boss version trips v12's migrator because it sees the
-// `version` table but not the new `job_common` table.
-async function dropTestSchema() {
-	const client = new Client({ connectionString: POSTGRES_URL });
-	await client.connect();
-	try {
-		await client.query(`DROP SCHEMA IF EXISTS "${TEST_SCHEMA}" CASCADE`);
-	} finally {
-		await client.end();
-	}
-}
-
-describe('HonoEndpoint with PgBoss Publisher', () => {
-	let connection: PgBossConnection;
-	let envParser: EnvironmentParser<{}>;
-
-	beforeAll(async () => {
-		await dropTestSchema();
-		connection = new PgBossConnection({
-			connectionString: POSTGRES_URL,
-			schema: TEST_SCHEMA,
-		});
-		await connection.connect();
-		envParser = new EnvironmentParser({});
-	});
-
-	afterAll(async () => {
-		await connection.close();
-	});
-
-	it('should publish events to pg-boss after successful endpoint execution', async () => {
-		const eventType = uniqueQueue();
-		const received: any[] = [];
-
-		const publisher = new PgBossPublisher<OrderEvent>(connection);
-
-		const PgBossPublisherService: Service<
-			'eventPublisher',
-			EventPublisher<OrderEvent>
-		> = {
-			serviceName: 'eventPublisher' as const,
-			register: () => publisher,
-		};
-
-		const outputSchema = z.object({
-			orderId: z.string(),
-			total: z.number(),
-		});
-
-		const endpoint = e
-			.publisher(PgBossPublisherService)
-			.post('/orders')
-			.output(outputSchema)
-			.event({
-				type: eventType as any,
-				payload: (response) => ({
-					orderId: response.orderId,
-					total: response.total,
-				}),
-			})
-			.handle(async () => ({
-				orderId: 'order-42',
-				total: 99.99,
-			}));
-
-		const serviceDiscovery = ServiceDiscovery.getInstance(envParser);
-		const app = new Hono();
-		HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
-
-		const adaptor = new HonoEndpoint(endpoint);
-		adaptor.addRoute(serviceDiscovery, app);
-
-		// Subscribe to events via pg-boss before making the request
-		const subscriber = new PgBossSubscriber<OrderEvent>(connection, {
-			pollingIntervalSeconds: 1,
-		});
-		await subscriber.subscribe([eventType as any], async (event) => {
-			received.push(event);
-		});
-
-		// Fire the endpoint
-		const response = await app.request('/orders', {
-			method: 'POST',
-			body: JSON.stringify({}),
-			headers: { 'Content-Type': 'application/json' },
-		});
-
-		expect(response.status).toBe(200);
-		expect(await response.json()).toEqual({
-			orderId: 'order-42',
-			total: 99.99,
-		});
-
-		// Wait for pg-boss to poll and deliver the event
-		await new Promise((resolve) => setTimeout(resolve, 3000));
-
-		expect(received.length).toBe(1);
-		expect(received[0]).toEqual({
-			type: eventType,
-			payload: { orderId: 'order-42', total: 99.99 },
-		});
-	});
-
-	it('should publish multiple events and respect when conditions', async () => {
-		const createdType = uniqueQueue();
-		const notificationType = uniqueQueue();
-		const received: any[] = [];
-
-		const publisher = new PgBossPublisher<OrderEvent>(connection);
-
-		const PgBossPublisherService: Service<
-			'eventPublisher',
-			EventPublisher<OrderEvent>
-		> = {
-			serviceName: 'eventPublisher' as const,
-			register: () => publisher,
-		};
-
-		const outputSchema = z.object({
-			orderId: z.string(),
-			total: z.number(),
-			isHighValue: z.boolean(),
-		});
-
-		const endpoint = e
-			.publisher(PgBossPublisherService)
-			.post('/orders')
-			.output(outputSchema)
-			.event({
-				type: createdType as any,
-				payload: (response) => ({
-					orderId: response.orderId,
-					total: response.total,
-				}),
-			})
-			.event({
-				type: notificationType as any,
-				payload: (response) => ({
-					orderId: response.orderId,
-					type: 'high-value-alert',
-				}),
-				when: (response) => response.isHighValue === true,
-			})
-			.handle(async () => ({
-				orderId: 'order-99',
-				total: 5000,
-				isHighValue: true,
-			}));
-
-		const serviceDiscovery = ServiceDiscovery.getInstance(envParser);
-		const app = new Hono();
-		HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
-
-		const adaptor = new HonoEndpoint(endpoint);
-		adaptor.addRoute(serviceDiscovery, app);
-
-		// Subscribe to both event types
-		const subscriber = new PgBossSubscriber<OrderEvent>(connection, {
-			pollingIntervalSeconds: 1,
-		});
-		await subscriber.subscribe(
-			[createdType as any, notificationType as any],
-			async (event) => {
-				received.push(event);
-			},
-		);
-
-		// Fire the endpoint
-		const response = await app.request('/orders', {
-			method: 'POST',
-			body: JSON.stringify({}),
-			headers: { 'Content-Type': 'application/json' },
-		});
-
-		expect(response.status).toBe(200);
-
-		// Wait for pg-boss to poll and deliver events
-		await new Promise((resolve) => setTimeout(resolve, 3000));
-
-		expect(received.length).toBe(2);
-		expect(received).toEqual(
-			expect.arrayContaining([
-				{
-					type: createdType,
-					payload: { orderId: 'order-99', total: 5000 },
-				},
-				{
-					type: notificationType,
-					payload: { orderId: 'order-99', type: 'high-value-alert' },
-				},
-			]),
-		);
-	});
-
-	it('should not publish events when when condition is false', async () => {
-		const eventType = uniqueQueue();
-		const received: any[] = [];
-
-		const publisher = new PgBossPublisher<OrderEvent>(connection);
-
-		const PgBossPublisherService: Service<
-			'eventPublisher',
-			EventPublisher<OrderEvent>
-		> = {
-			serviceName: 'eventPublisher' as const,
-			register: () => publisher,
-		};
-
-		const outputSchema = z.object({
-			orderId: z.string(),
-			total: z.number(),
-			isHighValue: z.boolean(),
-		});
-
-		const endpoint = e
-			.publisher(PgBossPublisherService)
-			.post('/orders')
-			.output(outputSchema)
-			.event({
-				type: eventType as any,
-				payload: (response) => ({
-					orderId: response.orderId,
-					type: 'high-value-alert',
-				}),
-				when: (response) => response.isHighValue === true,
-			})
-			.handle(async () => ({
-				orderId: 'order-small',
-				total: 5,
-				isHighValue: false,
-			}));
-
-		const serviceDiscovery = ServiceDiscovery.getInstance(envParser);
-		const app = new Hono();
-		HonoEndpoint.applyEventMiddleware(app, serviceDiscovery);
-
-		const adaptor = new HonoEndpoint(endpoint);
-		adaptor.addRoute(serviceDiscovery, app);
-
-		// Subscribe
-		const subscriber = new PgBossSubscriber<OrderEvent>(connection, {
-			pollingIntervalSeconds: 1,
-		});
-		await subscriber.subscribe([eventType as any], async (event) => {
-			received.push(event);
-		});
-
-		// Fire the endpoint
-		const response = await app.request('/orders', {
-			method: 'POST',
-			body: JSON.stringify({}),
-			headers: { 'Content-Type': 'application/json' },
-		});
-
-		expect(response.status).toBe(200);
-
-		// Wait to confirm no events arrive
-		await new Promise((resolve) => setTimeout(resolve, 3000));
-
-		expect(received.length).toBe(0);
-	});
-});