Release v1.1.0: Add Topics support and improve reliability

## New Features
- Add Topics resource with three operations:
  - Get Topic: Retrieve a specific topic by ID
  - Get Many Topics: List all available topics
  - Get Topic Sessions: Get all sessions associated with a topic
- Implement client-side pagination for endpoints without server-side support

## Improvements
- Remove console.log statements for production readiness
- Clean up internal documentation and test files
- Simplify credential display name from "Hedy API" to "Hedy"
- Add Hedy logo to both action and trigger nodes
- Remove HTTP Request node option to avoid confusion

## Bug Fixes
- Fix webhook signature verification to handle missing secrets gracefully
- Fix authentication test success/error message confusion
- Relax HTTPS requirement for localhost webhook URLs (development)
- Fix limit parameter for all resources with client-side slicing when needed:
  - /topics endpoint
  - /todos endpoint
  - /topics/{id}/sessions endpoint
  - /sessions/{id}/todos endpoint

## Technical Changes
- Update package version to 1.1.0
- Remove all debugging console statements
- Clean up codebase for public repository release

Ready for npm publication.

🤖 Generated with Claude Code

Co-Authored-By: Claude <noreply@anthropic.com>

Author: JulianPscheid

CHANGELOG.md

@@ -7,6 +7,32 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [1.1.0] - 2025-01-09
+
+### Added
+- Topics resource with three operations:
+  - Get Topic: Retrieve a specific topic by ID
+  - Get Many Topics: List all available topics  
+  - Get Topic Sessions: Get all sessions associated with a specific topic
+- Client-side pagination for endpoints that don't support server-side limits:
+  - `/topics` endpoint
+  - `/todos` endpoint
+  - `/topics/{id}/sessions` endpoint
+  - `/sessions/{id}/todos` endpoint
+
+### Fixed
+- Webhook signature verification now handles missing signing secrets gracefully
+- Improved error messages for webhook registration failures
+- Signature verification defaults to disabled for easier testing
+- HTTPS requirement relaxed for localhost webhook URLs
+- Fixed confusing authentication test success/error message
+- Limit parameter now works correctly for all resources (client-side when API doesn't support it)
+
+### Changed
+- Removed HTTP Request node option to avoid confusion (users should use dedicated Hedy nodes)
+- Credential display name simplified from "Hedy API" to "Hedy"
+- Added Hedy logo to both action and trigger nodes
+
 ## [1.0.0] - 2025-01-09
 
 ### Added
@@ -60,6 +86,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Upgrade Notes
 When upgrading between major versions, please review the migration guide in the documentation.
 
-[Unreleased]: https://github.com/HedyAI/n8n-nodes-hedy/compare/v1.0.0...HEAD
+[Unreleased]: https://github.com/HedyAI/n8n-nodes-hedy/compare/v1.1.0...HEAD
+[1.1.0]: https://github.com/HedyAI/n8n-nodes-hedy/compare/v1.0.0...v1.1.0
 [1.0.0]: https://github.com/HedyAI/n8n-nodes-hedy/releases/tag/v1.0.0
 [0.1.0]: https://github.com/HedyAI/n8n-nodes-hedy/releases/tag/v0.1.0

credentials/HedyApi.credentials.ts

@@ -7,13 +7,10 @@ import {
 
 export class HedyApi implements ICredentialType {
 	name = 'hedyApi';
-	displayName = 'Hedy API';
+	displayName = 'Hedy';
 	documentationUrl = 'https://api.hedy.bot/docs';
-	httpRequestNode = {
-		name: 'Hedy',
-		docsUrl: 'https://api.hedy.bot/docs',
-		apiBaseUrl: 'https://api.hedy.bot/',
-	};
+	// Removed httpRequestNode to prevent generic HTTP Request node from appearing
+	// Users should use the dedicated Hedy node for all operations
 	properties: INodeProperties[] = [
 		{
 			displayName: 'API Key',
@@ -45,9 +42,9 @@ export class HedyApi implements ICredentialType {
 			{
 				type: 'responseSuccessBody',
 				properties: {
+					message: 'Connected successfully!',
 					key: 'success',
 					value: true,
-					message: 'Authentication successful!',
 				},
 			},
 		],

nodes/Hedy/GenericFunctions.ts

@@ -68,6 +68,7 @@ export async function hedyApiRequest(
 			const apiError = error as any;
 			const errorCode = apiError.error?.code || 'unknown_error';
 			const errorMessage = apiError.error?.message || 'An unknown error occurred';
+			
 
 			// Provide user-friendly error messages
 			switch (errorCode) {
@@ -86,6 +87,16 @@ export async function hedyApiRequest(
 						this.getNode(),
 						'Invalid event type. Valid events: session.created, session.ended, highlight.created, todo.exported',
 					);
+				case ErrorCode.InvalidWebhookUrl:
+					throw new NodeOperationError(
+						this.getNode(),
+						'The Hedy API requires a publicly accessible webhook URL. For local testing, use a tunneling service like ngrok (https://ngrok.com) to expose your local n8n instance. Example: ngrok http 5678',
+					);
+				case ErrorCode.InvalidParameter:
+					throw new NodeOperationError(
+						this.getNode(),
+						`Invalid parameter: ${errorMessage}. Please check your webhook configuration.`,
+					);
 				default:
 					throw new NodeOperationError(this.getNode(), errorMessage);
 			}
@@ -140,7 +151,7 @@ export async function hedyApiRequestAllItems(
 
 		// Safety check to prevent infinite loops
 		if (returnData.length >= 1000) {
-			console.warn('Reached maximum item limit of 1000');
+			// Reached maximum item limit of 1000
 			break;
 		}
 	}
@@ -202,7 +213,7 @@ export async function unregisterWebhook(
 		);
 	} catch (error) {
 		// Ignore errors when deleting webhooks (webhook might already be deleted)
-		console.warn(`Failed to delete webhook ${webhookId}:`, error);
+		// Failed to delete webhook - this is expected if webhook was already deleted
 	}
 }
 

nodes/Hedy/Hedy.node.ts

@@ -19,7 +19,7 @@ export class Hedy implements INodeType {
 	description: INodeTypeDescription = {
 		displayName: 'Hedy',
 		name: 'hedy',
-		icon: 'file:hedy.svg',
+		icon: 'file:hedy.png',
 		group: ['output'],
 		version: 1,
 		subtitle: '={{$parameter["resource"] + ": " + $parameter["operation"]}}',
@@ -60,6 +60,11 @@ export class Hedy implements INodeType {
 						value: 'todo',
 						description: 'Todo item operations',
 					},
+					{
+						name: 'Topic',
+						value: 'topic',
+						description: 'Topic operations for organizing sessions',
+					},
 				],
 			},
 
@@ -150,6 +155,41 @@ export class Hedy implements INodeType {
 				],
 			},
 
+			// Topic operations
+			{
+				displayName: 'Operation',
+				name: 'operation',
+				type: 'options',
+				noDataExpression: true,
+				displayOptions: {
+					show: {
+						resource: ['topic'],
+					},
+				},
+				default: 'get',
+				required: true,
+				options: [
+					{
+						name: 'Get',
+						value: 'get',
+						description: 'Get a specific topic by ID',
+						action: 'Get a topic',
+					},
+					{
+						name: 'Get Many',
+						value: 'getAll',
+						description: 'Get all topics',
+						action: 'Get many topics',
+					},
+					{
+						name: 'Get Topic Sessions',
+						value: 'getSessions',
+						description: 'Get all sessions for a specific topic',
+						action: 'Get sessions by topic',
+					},
+				],
+			},
+
 			// Session ID parameter
 			{
 				displayName: 'Session ID',
@@ -201,15 +241,32 @@ export class Hedy implements INodeType {
 				placeholder: 'high_xyz789',
 			},
 
+			// Topic ID parameter for get operation
+			{
+				displayName: 'Topic ID',
+				name: 'topicId',
+				type: 'string',
+				required: true,
+				displayOptions: {
+					show: {
+						resource: ['topic'],
+						operation: ['get', 'getSessions'],
+					},
+				},
+				default: '',
+				description: 'The ID of the topic',
+				placeholder: 'topic_abc123',
+			},
+
 			// Return All parameter
 			{
 				displayName: 'Return All',
 				name: 'returnAll',
 				type: 'boolean',
 				displayOptions: {
 					show: {
-						resource: ['session', 'highlight', 'todo'],
-						operation: ['getAll', 'getBySession'],
+						resource: ['session', 'highlight', 'todo', 'topic'],
+						operation: ['getAll', 'getBySession', 'getSessions'],
 					},
 				},
 				default: false,
@@ -223,8 +280,8 @@ export class Hedy implements INodeType {
 				type: 'number',
 				displayOptions: {
 					show: {
-						resource: ['session', 'highlight', 'todo'],
-						operation: ['getAll', 'getBySession'],
+						resource: ['session', 'highlight', 'todo', 'topic'],
+						operation: ['getAll', 'getBySession', 'getSessions'],
 						returnAll: [false],
 					},
 				},
@@ -406,28 +463,19 @@ export class Hedy implements INodeType {
 						// Get all todos
 						const returnAll = this.getNodeParameter('returnAll', i) as boolean;
 
-						if (returnAll) {
-							responseData = await hedyApiRequestAllItems.call(
-								this,
-								'/todos',
-							);
-						} else {
-							const limit = this.getNodeParameter('limit', i) as number;
-							const qs: IDataObject = {
-								limit,
-							};
-
-							responseData = await hedyApiRequest.call(
-								this,
-								'GET',
-								'/todos',
-								undefined,
-								qs,
-							);
+						// Note: The todos endpoint returns all todos as a flat array
+						// and doesn't support server-side pagination
+						responseData = await hedyApiRequest.call(
+							this,
+							'GET',
+							'/todos',
+						);
 
-							// Handle pagination response
-							if (responseData && typeof responseData === 'object' && 'data' in responseData) {
-								responseData = responseData.data;
+						// Apply client-side limit if not returning all
+						if (!returnAll) {
+							const limit = this.getNodeParameter('limit', i) as number;
+							if (Array.isArray(responseData) && responseData.length > limit) {
+								responseData = responseData.slice(0, limit);
 							}
 						}
 					} else if (operation === 'getBySession') {
@@ -440,28 +488,94 @@ export class Hedy implements INodeType {
 
 						const returnAll = this.getNodeParameter('returnAll', i) as boolean;
 
-						if (returnAll) {
-							responseData = await hedyApiRequestAllItems.call(
-								this,
-								`/sessions/${sessionId}/todos`,
-							);
-						} else {
+						// Note: The session todos endpoint doesn't support server-side pagination
+						// We always fetch all todos for the session and slice client-side if needed
+						responseData = await hedyApiRequest.call(
+							this,
+							'GET',
+							`/sessions/${sessionId}/todos`,
+						);
+
+						// Handle response format
+						if (responseData && typeof responseData === 'object' && 'data' in responseData) {
+							responseData = responseData.data;
+						}
+
+						// Apply client-side limit if not returning all
+						if (!returnAll) {
 							const limit = this.getNodeParameter('limit', i) as number;
-							const qs: IDataObject = {
-								limit,
-							};
+							if (Array.isArray(responseData) && responseData.length > limit) {
+								responseData = responseData.slice(0, limit);
+							}
+						}
+					}
+				} else if (resource === 'topic') {
+					// Topic operations
+					if (operation === 'get') {
+						// Get a specific topic
+						const topicId = this.getNodeParameter('topicId', i) as string;
+						
+						if (!topicId) {
+							throw new NodeOperationError(this.getNode(), 'Topic ID is required');
+						}
 
-							responseData = await hedyApiRequest.call(
-								this,
-								'GET',
-								`/sessions/${sessionId}/todos`,
-								undefined,
-								qs,
-							);
+						responseData = await hedyApiRequest.call(
+							this,
+							'GET',
+							`/topics/${topicId}`,
+						);
+					} else if (operation === 'getAll') {
+						// Get all topics
+						const returnAll = this.getNodeParameter('returnAll', i) as boolean;
 
-							// Handle pagination response
-							if (responseData && typeof responseData === 'object' && 'data' in responseData) {
-								responseData = responseData.data;
+						// Note: The topics endpoint doesn't support server-side pagination
+						// We always fetch all topics and then slice client-side if needed
+						responseData = await hedyApiRequest.call(
+							this,
+							'GET',
+							'/topics',
+						);
+
+						// Handle response format
+						if (responseData && typeof responseData === 'object' && 'data' in responseData) {
+							responseData = responseData.data;
+						}
+
+						// Apply client-side limit if not returning all
+						if (!returnAll) {
+							const limit = this.getNodeParameter('limit', i) as number;
+							if (Array.isArray(responseData) && responseData.length > limit) {
+								responseData = responseData.slice(0, limit);
+							}
+						}
+					} else if (operation === 'getSessions') {
+						// Get sessions for a specific topic
+						const topicId = this.getNodeParameter('topicId', i) as string;
+						
+						if (!topicId) {
+							throw new NodeOperationError(this.getNode(), 'Topic ID is required');
+						}
+
+						const returnAll = this.getNodeParameter('returnAll', i) as boolean;
+
+						// Note: The topic sessions endpoint doesn't support server-side pagination
+						// We always fetch all sessions for the topic and slice client-side if needed
+						responseData = await hedyApiRequest.call(
+							this,
+							'GET',
+							`/topics/${topicId}/sessions`,
+						);
+
+						// Handle response format
+						if (responseData && typeof responseData === 'object' && 'data' in responseData) {
+							responseData = responseData.data;
+						}
+
+						// Apply client-side limit if not returning all
+						if (!returnAll) {
+							const limit = this.getNodeParameter('limit', i) as number;
+							if (Array.isArray(responseData) && responseData.length > limit) {
+								responseData = responseData.slice(0, limit);
 							}
 						}
 					}