13377 components encharge #19148
13377 components encharge #19148
Conversation
- Added actions for adding/updating a person, archiving a person, and removing tags. - Introduced new sources for detecting new and updated persons, as well as when tags are removed. - Updated prop definitions to include user ID and tags for better integration. - Implemented utility functions for parsing objects and managing API requests. - Bumped version to 0.1.0 and added dependencies for improved functionality.
|
The latest updates on your projects. Learn more about Vercel for GitHub. 2 Skipped Deployments
|
WalkthroughAdds a full Encharge integration: API app wrapper, utilities/constants, webhook lifecycle base, three instant webhook sources with test events, three actions (add/update, archive, remove-tags), package metadata bump, and minor trailing-newline fixes across unrelated components. Changes
Sequence Diagram(s)sequenceDiagram
participant User
participant Source
participant Base
participant App
participant Encharge
participant DB
User->>Source: Activate source
Source->>Base: activate()
Base->>App: createHook(endpoint, eventType)
App->>Encharge: POST /hooks
Encharge-->>App: { subscriptionId }
Base->>DB: _setWebhookId(subscriptionId)
Encharge->>Base: Webhook POST (body)
Base->>Source: run({ body })
Source->>Source: generateMeta(body)
Source-->>User: emit(body + metadata)
User->>Source: Deactivate source
Source->>Base: deactivate()
Base->>DB: _getWebhookId()
Base->>App: deleteHook(subscriptionId)
App->>Encharge: DELETE /hooks/{id}
sequenceDiagram
participant Caller
participant Action
participant App
participant Encharge
Caller->>Action: Invoke action with props
Action->>Action: Parse & validate inputs
alt add-or-update-person
Action->>App: addOrUpdatePerson({ data })
else archive-person
Action->>Action: require XOR(userId, email)
Action->>App: archivePerson({ params })
else remove-tags
Action->>Action: parse tags → CSV
Action->>App: removeTag({ data })
end
App->>Encharge: API request
Encharge-->>App: response
Action-->>Caller: return response + summary
Estimated code review effort🎯 3 (Moderate) | ⏱️ ~25 minutes
Suggested labels
Suggested reviewers
Pre-merge checks and finishing touches❌ Failed checks (2 warnings, 1 inconclusive)
✅ Passed checks (2 passed)
✨ Finishing touches
🧪 Generate unit tests (beta)
📜 Recent review detailsConfiguration used: CodeRabbit UI Review profile: ASSERTIVE Plan: Pro ⛔ Files ignored due to path filters (1)
📒 Files selected for processing (15)
🧰 Additional context used🧠 Learnings (1)📚 Learning: 2025-10-20T01:01:02.970ZApplied to files:
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
🔇 Additional comments (14)
Tip 📝 Customizable high-level summaries are now available in beta!You can now customize how CodeRabbit generates the high-level summary in your pull requests — including its content, structure, tone, and formatting.
Example instruction:
Note: This feature is currently in beta for Pro-tier users, and pricing will be announced later. Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out. Comment |
![coderabbitai[bot]](https://avatars.githubusercontent.com/in/347564?s=60&v=4){kind=small}
There was a problem hiding this comment.
Actionable comments posted: 7
📜 Review details
Configuration used: CodeRabbit UI
Review profile: ASSERTIVE
Plan: Pro
⛔ Files ignored due to path filters (1)
pnpm-lock.yamlis excluded by!**/pnpm-lock.yaml
📒 Files selected for processing (14)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs(1 hunks)components/encharge/actions/archive-person/archive-person.mjs(1 hunks)components/encharge/actions/remove-tags/remove-tags.mjs(1 hunks)components/encharge/common/constants.mjs(1 hunks)components/encharge/common/utils.mjs(1 hunks)components/encharge/encharge.app.mjs(1 hunks)components/encharge/package.json(2 hunks)components/encharge/sources/common/base.mjs(1 hunks)components/encharge/sources/new-person-instant/new-person-instant.mjs(1 hunks)components/encharge/sources/new-person-instant/test-event.mjs(1 hunks)components/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs(1 hunks)components/encharge/sources/tag-removed-from-person-instant/test-event.mjs(1 hunks)components/encharge/sources/updated-person-instant/test-event.mjs(1 hunks)components/encharge/sources/updated-person-instant/updated-person-instant.mjs(1 hunks)
🧰 Additional context used
🧠 Learnings (6)
📚 Learning: 2024-10-10T19:18:27.998Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 14265
File: components/the_magic_drip/sources/common.mjs:35-43
Timestamp: 2024-10-10T19:18:27.998Z
Learning: In `components/the_magic_drip/sources/common.mjs`, when processing items in `getAndProcessData`, `savedIds` is intentionally updated with IDs of both emitted and non-emitted items to avoid emitting retroactive events upon first deployment and ensure only new events are emitted as they occur.
Applied to files:
components/encharge/sources/updated-person-instant/updated-person-instant.mjscomponents/encharge/sources/new-person-instant/new-person-instant.mjscomponents/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs
📚 Learning: 2025-10-20T01:01:02.970Z
Learnt from: js07
Repo: PipedreamHQ/pipedream PR: 18744
File: components/slack_v2/actions/send-large-message/send-large-message.mjs:49-64
Timestamp: 2025-10-20T01:01:02.970Z
Learning: In components/slack_v2/actions/send-large-message/send-large-message.mjs, the metadata_event_payload prop is typed as string, so the code only needs to handle string-to-JSON parsing and does not need to handle object inputs.
Applied to files:
components/encharge/sources/updated-person-instant/test-event.mjs
📚 Learning: 2025-06-04T17:52:05.780Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 16954
File: components/salesloft/salesloft.app.mjs:14-23
Timestamp: 2025-06-04T17:52:05.780Z
Learning: In the Salesloft API integration (components/salesloft/salesloft.app.mjs), the _makeRequest method returns response.data which directly contains arrays for list endpoints like listPeople, listCadences, listUsers, and listAccounts. The propDefinitions correctly call .map() directly on these responses without needing to destructure a nested data property.
Applied to files:
components/encharge/encharge.app.mjs
📚 Learning: 2025-09-15T22:01:11.472Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 18362
File: components/leonardo_ai/actions/generate-image/generate-image.mjs:103-105
Timestamp: 2025-09-15T22:01:11.472Z
Learning: In Pipedream components, pipedream/platform's axios implementation automatically excludes undefined values from HTTP requests, so there's no need to manually check for truthiness before including properties in request payloads.
Applied to files:
components/encharge/encharge.app.mjs
📚 Learning: 2024-12-12T19:23:09.039Z
Learnt from: jcortes
Repo: PipedreamHQ/pipedream PR: 14935
File: components/sailpoint/package.json:15-18
Timestamp: 2024-12-12T19:23:09.039Z
Learning: When developing Pipedream components, do not add built-in Node.js modules like `fs` to `package.json` dependencies, as they are native modules provided by the Node.js runtime.
Applied to files:
components/encharge/package.json
📚 Learning: 2024-07-24T02:06:47.016Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 12697
File: components/salesforce_rest_api/sources/common-webhook-methods.mjs:1-71
Timestamp: 2024-07-24T02:06:47.016Z
Learning: The `common-webhook-methods.mjs` object is designed to be extended, similar to an abstract class, and intentionally does not implement certain methods like `generateWebhookMeta` and `getEventType` to enforce implementation in subclasses.
Applied to files:
components/encharge/sources/common/base.mjs
🧬 Code graph analysis (8)
components/encharge/common/constants.mjs (1)
components/encharge/encharge.app.mjs (1)
LIMIT(13-18)
components/encharge/common/utils.mjs (1)
components/plentyone/common/utils.mjs (1)
obj(1-24)
components/encharge/sources/updated-person-instant/updated-person-instant.mjs (1)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
data(51-61)
components/encharge/actions/remove-tags/remove-tags.mjs (3)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
response(63-66)components/encharge/actions/archive-person/archive-person.mjs (1)
response(42-53)components/encharge/common/utils.mjs (2)
parseObject(1-24)parseObject(1-24)
components/encharge/sources/new-person-instant/new-person-instant.mjs (1)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
data(51-61)
components/encharge/encharge.app.mjs (1)
components/encharge/common/constants.mjs (2)
LIMIT(1-1)LIMIT(1-1)
components/encharge/actions/archive-person/archive-person.mjs (2)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
response(63-66)components/encharge/actions/remove-tags/remove-tags.mjs (1)
response(35-41)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (3)
components/encharge/common/utils.mjs (2)
parseObject(1-24)parseObject(1-24)components/encharge/actions/archive-person/archive-person.mjs (1)
response(42-53)components/encharge/actions/remove-tags/remove-tags.mjs (1)
response(35-41)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
- GitHub Check: Publish TypeScript components
- GitHub Check: Verify TypeScript components
- GitHub Check: Lint Code Base
- GitHub Check: pnpm publish
🔇 Additional comments (15)
components/encharge/common/constants.mjs (1)
1-1: LGTM!Clean constant definition for pagination limit.
components/encharge/package.json (2)
3-3: LGTM!Appropriate version bump from 0.0.2 to 0.1.0 for new feature additions.
15-16: LGTM!Correct addition of @pipedream/platform dependency needed for axios integration.
components/encharge/sources/new-person-instant/test-event.mjs (1)
1-23: LGTM!Well-structured test event payload with representative data for the new person webhook.
components/encharge/sources/tag-removed-from-person-instant/test-event.mjs (1)
1-11: LGTM!Appropriate minimal test event structure for tag removal webhook.
components/encharge/encharge.app.mjs (4)
1-2: LGTM!Correct imports for axios and the LIMIT constant.
7-29: LGTM!Well-structured userId propDefinition with pagination and proper label formatting.
53-69: LGTM!Clean API request wrapper implementation with proper URL construction and header injection.
70-115: LGTM!Comprehensive set of API methods covering person management, tagging, and webhook lifecycle operations.
components/encharge/actions/archive-person/archive-person.mjs (1)
1-36: LGTM!Clean action metadata and prop definitions with appropriate annotations including
destructiveHint: true.components/encharge/common/utils.mjs (1)
1-24: LGTM!Robust parseObject utility with proper error handling and fallback logic. The implementation is identical to the pattern used in other Pipedream components (e.g., plentyone), which is acceptable for component-scoped utilities.
components/encharge/sources/updated-person-instant/updated-person-instant.mjs (1)
1-30: LGTM!The source structure is clean and follows the established instant-source pattern correctly. The event type, metadata generation, and destructuring are all consistent with sibling sources.
components/encharge/sources/common/base.mjs (1)
1-35: LGTM!The webhook lifecycle management is implemented correctly. The base module properly abstracts common behavior while leaving
getEvent()andgenerateMeta()for subclasses to implement—this follows the established abstract base pattern for Pipedream sources.Based on learnings
components/encharge/sources/new-person-instant/new-person-instant.mjs (1)
1-30: LGTM!The implementation correctly follows the instant-source pattern and is consistent with the sibling sources in this PR.
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
56-56: Remove undefined property reference.Line 56 references
this.phone, but there is nophoneprop defined in the props section (lines 15-48). This will includephone: undefinedin the API request payload, which may cause unexpected behavior or errors.Remove the undefined property:
const data = [ { firstName: this.firstName, lastName: this.lastName, email: this.email, - phone: this.phone, id: this.userId, - additionalFields: this.additionalFields, ...parsedAdditionalFields, }, ];⛔ Skipped due to learnings
Learnt from: GTFalcao Repo: PipedreamHQ/pipedream PR: 18362 File: components/leonardo_ai/actions/generate-image/generate-image.mjs:103-105 Timestamp: 2025-09-15T22:01:11.472Z Learning: In Pipedream components, pipedream/platform's axios implementation automatically excludes undefined values from HTTP requests, so there's no need to manually check for truthiness before including properties in request payloads.Learnt from: GTFalcao Repo: PipedreamHQ/pipedream PR: 16954 File: components/salesloft/salesloft.app.mjs:14-23 Timestamp: 2025-06-04T17:52:05.780Z Learning: In the Salesloft API integration (components/salesloft/salesloft.app.mjs), the _makeRequest method returns response.data which directly contains arrays for list endpoints like listPeople, listCadences, listUsers, and listAccounts. The propDefinitions correctly call .map() directly on these responses without needing to destructure a nested data property.
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
Outdated
Show resolved
Hide resolved
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
Outdated
Show resolved
Hide resolved
components/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs
Show resolved
Hide resolved
…utput formatting - Updated the return statement in the tags processing to use a ternary operator for clarity. - Removed unused additionalFields from the add-or-update-person action. - Enhanced the summary message in the add-or-update-person action to conditionally include the email. - Added validation in the archive-person action to ensure either user ID or email is provided. - Modified the remove-tags action to handle tags as an array for consistent processing.
There was a problem hiding this comment.
Actionable comments posted: 1
♻️ Duplicate comments (1)
components/encharge/encharge.app.mjs (1)
48-50: Consider applying the readability improvement for tags parsing.The tags parsing logic still uses the chained logical expression
tags && tags.split(",") || []which is less readable than a ternary operator. This was suggested in a previous review.Apply this diff for improved readability:
- return tags && tags.split(",") || []; + return tags ? tags.split(",") : [];
📜 Review details
Configuration used: CodeRabbit UI
Review profile: ASSERTIVE
Plan: Pro
📒 Files selected for processing (5)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs(1 hunks)components/encharge/actions/archive-person/archive-person.mjs(1 hunks)components/encharge/actions/remove-tags/remove-tags.mjs(1 hunks)components/encharge/encharge.app.mjs(1 hunks)components/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs(1 hunks)
🧰 Additional context used
🧠 Learnings (5)
📚 Learning: 2024-10-08T15:33:38.240Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 12731
File: components/hackerone/actions/get-members/get-members.mjs:3-28
Timestamp: 2024-10-08T15:33:38.240Z
Learning: When exporting a summary message in the `run` method of an action, ensure the message is correctly formatted. For example, in the `hackerone-get-members` action, the correct format is `Successfully retrieved ${response.data.length} members`.
Applied to files:
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
📚 Learning: 2024-10-10T19:18:27.998Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 14265
File: components/the_magic_drip/sources/common.mjs:35-43
Timestamp: 2024-10-10T19:18:27.998Z
Learning: In `components/the_magic_drip/sources/common.mjs`, when processing items in `getAndProcessData`, `savedIds` is intentionally updated with IDs of both emitted and non-emitted items to avoid emitting retroactive events upon first deployment and ensure only new events are emitted as they occur.
Applied to files:
components/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs
📚 Learning: 2025-10-20T01:01:02.970Z
Learnt from: js07
Repo: PipedreamHQ/pipedream PR: 18744
File: components/slack_v2/actions/send-large-message/send-large-message.mjs:49-64
Timestamp: 2025-10-20T01:01:02.970Z
Learning: In components/slack_v2/actions/send-large-message/send-large-message.mjs, the metadata_event_payload prop is typed as string, so the code only needs to handle string-to-JSON parsing and does not need to handle object inputs.
Applied to files:
components/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs
📚 Learning: 2025-06-04T17:52:05.780Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 16954
File: components/salesloft/salesloft.app.mjs:14-23
Timestamp: 2025-06-04T17:52:05.780Z
Learning: In the Salesloft API integration (components/salesloft/salesloft.app.mjs), the _makeRequest method returns response.data which directly contains arrays for list endpoints like listPeople, listCadences, listUsers, and listAccounts. The propDefinitions correctly call .map() directly on these responses without needing to destructure a nested data property.
Applied to files:
components/encharge/encharge.app.mjs
📚 Learning: 2025-09-15T22:01:11.472Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 18362
File: components/leonardo_ai/actions/generate-image/generate-image.mjs:103-105
Timestamp: 2025-09-15T22:01:11.472Z
Learning: In Pipedream components, pipedream/platform's axios implementation automatically excludes undefined values from HTTP requests, so there's no need to manually check for truthiness before including properties in request payloads.
Applied to files:
components/encharge/encharge.app.mjs
🧬 Code graph analysis (4)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (2)
components/encharge/common/utils.mjs (2)
parseObject(1-24)parseObject(1-24)components/encharge/actions/archive-person/archive-person.mjs (1)
response(45-56)
components/encharge/actions/remove-tags/remove-tags.mjs (1)
components/encharge/common/utils.mjs (2)
parseObject(1-24)parseObject(1-24)
components/encharge/actions/archive-person/archive-person.mjs (2)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
response(62-65)components/encharge/actions/remove-tags/remove-tags.mjs (1)
response(41-47)
components/encharge/encharge.app.mjs (1)
components/encharge/common/constants.mjs (2)
LIMIT(1-1)LIMIT(1-1)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
- GitHub Check: pnpm publish
- GitHub Check: Verify TypeScript components
- GitHub Check: Publish TypeScript components
- GitHub Check: Lint Code Base
🔇 Additional comments (3)
components/encharge/sources/tag-removed-from-person-instant/tag-removed-from-person-instant.mjs (1)
25-35: LGTM! Destructuring pattern correctly fixed.The destructuring pattern on line 27 now correctly extracts the
idproperty from the object ({ id }), resolving the previous issue whereidwould have been bound to the entire object. The metadata generation logic properly uses the extractedidvalue.components/encharge/actions/archive-person/archive-person.mjs (1)
38-43: LGTM! Validation logic correctly handles all cases.The validation now properly checks for both edge cases:
- Lines 38-40: Ensures at least one identifier (userId or email) is provided
- Lines 41-43: Ensures they are mutually exclusive
This resolves the previous critical validation gap.
components/encharge/actions/remove-tags/remove-tags.mjs (1)
35-40: LGTM! Type safety correctly implemented.The code now properly handles the output of
parseObjectby normalizing it to an array (lines 36-40), ensuring that array methods like.join()and.lengthwill work correctly regardless of the input type. This resolves the previous type safety concern.
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
Outdated
Show resolved
Hide resolved
There was a problem hiding this comment.
Actionable comments posted: 1
📜 Review details
Configuration used: CodeRabbit UI
Review profile: ASSERTIVE
Plan: Pro
📒 Files selected for processing (1)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs(1 hunks)
🧰 Additional context used
🧠 Learnings (2)
📚 Learning: 2024-10-08T15:33:38.240Z
Learnt from: GTFalcao
Repo: PipedreamHQ/pipedream PR: 12731
File: components/hackerone/actions/get-members/get-members.mjs:3-28
Timestamp: 2024-10-08T15:33:38.240Z
Learning: When exporting a summary message in the `run` method of an action, ensure the message is correctly formatted. For example, in the `hackerone-get-members` action, the correct format is `Successfully retrieved ${response.data.length} members`.
Applied to files:
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
📚 Learning: 2025-10-20T01:01:02.970Z
Learnt from: js07
Repo: PipedreamHQ/pipedream PR: 18744
File: components/slack_v2/actions/send-large-message/send-large-message.mjs:49-64
Timestamp: 2025-10-20T01:01:02.970Z
Learning: In components/slack_v2/actions/send-large-message/send-large-message.mjs, the metadata_event_payload prop is typed as string, so the code only needs to handle string-to-JSON parsing and does not need to handle object inputs.
Applied to files:
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
🧬 Code graph analysis (1)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (3)
components/encharge/common/utils.mjs (2)
parseObject(1-24)parseObject(1-24)components/encharge/actions/archive-person/archive-person.mjs (1)
response(45-56)components/encharge/actions/remove-tags/remove-tags.mjs (1)
response(41-47)
⏰ Context from checks skipped due to timeout of 90000ms. You can increase the timeout in your CodeRabbit configuration to a maximum of 15 minutes (900000ms). (4)
- GitHub Check: pnpm publish
- GitHub Check: Publish TypeScript components
- GitHub Check: Lint Code Base
- GitHub Check: Verify TypeScript components
🔇 Additional comments (1)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs (1)
49-72: LGTM! The run method implementation is correct.The implementation properly:
- Parses
additionalFieldswith appropriate fallback- Constructs the data payload correctly
- Uses the userId to determine add vs. update in the summary
- Handles the optional email in the summary message (previously flagged issue is now resolved)
components/encharge/actions/add-or-update-person/add-or-update-person.mjs
Show resolved
Hide resolved
For Integration QA: |
|
Hi everyone, all test cases are passed! Ready for release! Test reports
|
|
/approve |
Resolves #13377
Summary by CodeRabbit
New Features
Chores
✏️ Tip: You can customize this high-level summary in your review settings.