-
Notifications
You must be signed in to change notification settings - Fork 5.5k
Zoho Desk - Help Center & Knowledge Base Actions #18837
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Conversation
|
The latest updates on your projects. Learn more about Vercel for GitHub. 2 Skipped Deployments
|
WalkthroughThis PR updates the Zoho Desk component with version bumps across 16 action modules and 10 source modules, increments the package version from 0.2.3 to 0.3.0, updates action descriptions, and adds async options functions to dynamically load article and category lists based on portal context. Changes
Estimated code review effort🎯 2 (Simple) | ⏱️ ~12 minutes The diff consists predominantly of homogeneous version bumps repeated across 26+ files (actions and sources), which are trivial and low-risk. While there are some heterogeneous changes—specifically, propDefinition enhancements and async options functions in knowledge base actions and the app definitions—these follow consistent patterns and are localized to a small subset of files. The mixed complexity is offset by the repetitive nature of the bulk changes. Possibly related PRs
Suggested reviewers
Poem
Pre-merge checks and finishing touches❌ Failed checks (1 warning)
✅ Passed checks (4 passed)
✨ Finishing touches
🧪 Generate unit tests (beta)
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 |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Actionable comments posted: 1
🧹 Nitpick comments (13)
components/zoho_desk/actions/create-account/create-account.mjs (1)
55-65: Align with action patterns: pass$to client and guard$summary.
- Pass
$tocreateAccountfor consistent logging/metrics (other actions do this).- Use optional chaining in
$summaryto avoid errors ifresponseis unexpected.Apply:
- const response = await this.zohoDesk.createAccount({ + const response = await this.zohoDesk.createAccount({ + $, headers: { orgId, }, data: { accountName, email, website, phone, }, }); - $.export("$summary", `Successfully created a new account with ID ${response.id}`); + $.export("$summary", `Successfully created a new account with ID ${response?.id}`);Also applies to: 67-67
components/zoho_desk/sources/changed-ticket-status/changed-ticket-status.mjs (2)
7-7: Tiny copy edit.
Consider “Emit an event when a ticket’s status changes.” for clarity.- description: "Emit new event when a status ticket is changed. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Tickets#Tickets_Listalltickets)", + description: "Emit an event when a ticket’s status changes. [See the docs here](https://desk.zoho.com/DeskAPIDocument#Tickets#Tickets_Listalltickets)",
37-39: Optional: stabilize ordering.
If the API supports it, add a sort order to pair withsortBy: "modifiedTime"to reduce edge cases around identical timestamps.params: { sortBy: "modifiedTime", // relevance | modifiedTime | createdTime | customerResponseTime status: this.status, + order: "desc", },components/zoho_desk/package.json (1)
3-3: Package version bump OK.
0.2.3 → 0.3.0 aligns with new features. Consider adding a CHANGELOG entry summarizing the new Help Center/KB actions and dynamic options.components/zoho_desk/actions/create-contact/create-contact.mjs (1)
62-73: Match client-call pattern and harden summary.
- Pass
$tocreateContact(consistent with other actions like add-ticket-attachment).- Use
response?.idin$summary.- const response = await this.zohoDesk.createContact({ + const response = await this.zohoDesk.createContact({ + $, headers: { orgId, }, data: { lastName, firstName, email, phone, mobile, }, }); - $.export("$summary", `Successfully created a new contact with ID ${response.id}`); + $.export("$summary", `Successfully created a new contact with ID ${response?.id}`);Also applies to: 75-75
components/zoho_desk/actions/find-or-create-contact/find-or-create-contact.mjs (1)
8-8: Consider whether version bump is necessary without functional changes.This file increments the version from "0.0.5" to "0.0.6" with no functional, behavioral, or API changes. Per semantic versioning principles, versions should typically only increment when the module itself changes. If this is part of a coordinated release policy to keep all component versions aligned with the package version bump (0.2.3 → 0.3.0), that's fine, but otherwise this version bump may be unnecessary.
components/zoho_desk/sources/new-ticket-comment/new-ticket-comment.mjs (1)
9-9: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.6" to "0.0.7" with no code changes. Same consideration as other files in this PR—this may be unnecessary unless part of an intentional release coordination policy.
components/zoho_desk/sources/deleted-article-instant/deleted-article-instant.mjs (1)
10-10: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.2" to "0.0.3" with no code changes. Same consideration applies regarding semantic versioning principles.
components/zoho_desk/actions/update-ticket/update-ticket.mjs (1)
8-8: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.5" to "0.0.6" with no code changes. Same consideration applies.
components/zoho_desk/sources/updated-article-instant/updated-article-instant.mjs (1)
10-10: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.2" to "0.0.3" with no code changes. Same consideration applies.
components/zoho_desk/sources/updated-ticket/updated-ticket.mjs (1)
9-9: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.6" to "0.0.7" with no code changes. Same consideration applies.
components/zoho_desk/actions/find-contact/find-contact.mjs (1)
8-8: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.5" to "0.0.6" with no code changes. Same consideration applies.
components/zoho_desk/actions/search-ticket/search-ticket.mjs (1)
8-8: Consider whether version bump is necessary without functional changes.Version incremented from "0.0.5" to "0.0.6" with no code changes. Same consideration applies regarding semantic versioning principles.
📜 Review details
Configuration used: CodeRabbit UI
Review profile: CHILL
Plan: Pro
📒 Files selected for processing (30)
components/zoho_desk/actions/add-ticket-attachment/add-ticket-attachment.mjs(1 hunks)components/zoho_desk/actions/add-ticket-comment/add-ticket-comment.mjs(1 hunks)components/zoho_desk/actions/create-account/create-account.mjs(1 hunks)components/zoho_desk/actions/create-contact/create-contact.mjs(1 hunks)components/zoho_desk/actions/create-ticket/create-ticket.mjs(1 hunks)components/zoho_desk/actions/find-contact/find-contact.mjs(1 hunks)components/zoho_desk/actions/find-or-create-contact/find-or-create-contact.mjs(1 hunks)components/zoho_desk/actions/get-article/get-article.mjs(2 hunks)components/zoho_desk/actions/list-articles/list-articles.mjs(3 hunks)components/zoho_desk/actions/list-help-centers/list-help-centers.mjs(1 hunks)components/zoho_desk/actions/list-root-categories/list-root-categories.mjs(2 hunks)components/zoho_desk/actions/search-articles/search-articles.mjs(2 hunks)components/zoho_desk/actions/search-ticket/search-ticket.mjs(1 hunks)components/zoho_desk/actions/send-email-reply/send-email-reply.mjs(1 hunks)components/zoho_desk/actions/update-contact/update-contact.mjs(1 hunks)components/zoho_desk/actions/update-ticket/update-ticket.mjs(1 hunks)components/zoho_desk/package.json(1 hunks)components/zoho_desk/sources/changed-ticket-status/changed-ticket-status.mjs(1 hunks)components/zoho_desk/sources/deleted-article-instant/deleted-article-instant.mjs(1 hunks)components/zoho_desk/sources/new-account/new-account.mjs(1 hunks)components/zoho_desk/sources/new-agent/new-agent.mjs(1 hunks)components/zoho_desk/sources/new-article-instant/new-article-instant.mjs(1 hunks)components/zoho_desk/sources/new-contact/new-contact.mjs(1 hunks)components/zoho_desk/sources/new-ticket-attachment/new-ticket-attachment.mjs(1 hunks)components/zoho_desk/sources/new-ticket-comment/new-ticket-comment.mjs(1 hunks)components/zoho_desk/sources/new-ticket-message/new-ticket-message.mjs(1 hunks)components/zoho_desk/sources/new-ticket/new-ticket.mjs(1 hunks)components/zoho_desk/sources/updated-article-instant/updated-article-instant.mjs(1 hunks)components/zoho_desk/sources/updated-ticket/updated-ticket.mjs(1 hunks)components/zoho_desk/zoho_desk.app.mjs(1 hunks)
⏰ 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). (3)
- GitHub Check: Publish TypeScript components
- GitHub Check: Lint Code Base
- GitHub Check: Verify TypeScript components
🔇 Additional comments (29)
components/zoho_desk/actions/update-contact/update-contact.mjs (1)
8-8: LGTM! Routine version bump.The version increment is part of the coordinated release for Zoho Desk Help Center & Knowledge Base enhancements.
components/zoho_desk/actions/send-email-reply/send-email-reply.mjs (1)
8-8: LGTM! Routine version bump.The version increment aligns with the broader release.
components/zoho_desk/sources/new-ticket-attachment/new-ticket-attachment.mjs (1)
11-11: LGTM! Routine version bump.The version increment is consistent with the release pattern.
components/zoho_desk/actions/add-ticket-comment/add-ticket-comment.mjs (1)
8-8: LGTM! Routine version bump.The version increment is part of the coordinated release.
components/zoho_desk/sources/new-ticket/new-ticket.mjs (1)
9-9: LGTM! Routine version bump.The version increment aligns with the release pattern.
components/zoho_desk/actions/list-root-categories/list-root-categories.mjs (3)
5-5: LGTM! Documentation text standardization.The description text update improves consistency across the codebase.
7-7: LGTM! Version bump reflects changes in this action.The version increment appropriately reflects the description and propDefinition updates.
52-59: Excellent refactor to use propDefinition!Converting
departmentIdto usepropDefinitionimproves consistency with other props and adheres to the DRY principle. The description and optional status are properly preserved.components/zoho_desk/actions/create-ticket/create-ticket.mjs (1)
8-8: LGTM! Routine version bump.The version increment is part of the coordinated release.
components/zoho_desk/sources/new-agent/new-agent.mjs (1)
9-9: LGTM! Routine version bump.The version increment aligns with the release pattern.
components/zoho_desk/actions/create-account/create-account.mjs (1)
8-8: Version bump looks good.
No functional changes detected.components/zoho_desk/sources/changed-ticket-status/changed-ticket-status.mjs (1)
9-9: Version bump acknowledged.
No behavioral diffs observed.components/zoho_desk/actions/add-ticket-attachment/add-ticket-attachment.mjs (1)
10-10: LGTM on version bump.
No logic changes; upload flow remains consistent with platform helpers.components/zoho_desk/actions/create-contact/create-contact.mjs (1)
8-8: Version bump looks good.
No functional changes detected.components/zoho_desk/sources/new-article-instant/new-article-instant.mjs (1)
10-10: LGTM: Version bumpStandard version increment with no functional changes.
components/zoho_desk/sources/new-account/new-account.mjs (1)
9-9: LGTM: Version bumpStandard version increment with no functional changes.
components/zoho_desk/sources/new-ticket-message/new-ticket-message.mjs (1)
9-9: LGTM: Version bumpStandard version increment with no functional changes.
components/zoho_desk/sources/new-contact/new-contact.mjs (1)
9-9: LGTM: Version bumpStandard version increment with no functional changes.
components/zoho_desk/actions/list-help-centers/list-help-centers.mjs (1)
6-8: LGTM: Description standardization and version bumpThe description update standardizes the documentation link phrasing across actions. Version increment is appropriate for this metadata change.
components/zoho_desk/actions/get-article/get-article.mjs (2)
6-8: LGTM: Description standardization and version bumpThe description update standardizes the documentation link phrasing. Version increment is appropriate.
35-37: LGTM: Portal-scoped article selectionAdding the portalId mapper enables dynamic article options filtered by the selected portal, which improves UX by showing only relevant articles.
components/zoho_desk/zoho_desk.app.mjs (2)
129-129: LGTM: Description cleanupRemoving the trailing period standardizes the description format.
155-183: Verify pagination cursor type for categoriesSame pagination concern as articleId: the async options use ID-based cursoring (
from: data[data.length - 1].id), but this should be verified against the API's expected pagination mechanism for/kbRootCategories.components/zoho_desk/actions/search-articles/search-articles.mjs (2)
5-7: LGTM: Description standardization and version bumpThe description update aligns with other actions in the PR. Version increment is appropriate.
35-42: LGTM: Enhanced category selection with dynamic optionsConverting categoryId from a plain string to a propDefinition enables portal-scoped dynamic options, improving UX by showing only relevant categories. The portalId mapper correctly filters categories by the selected portal.
components/zoho_desk/actions/list-articles/list-articles.mjs (4)
5-5: LGTM! Description text improved.The updated description is more polished and professional.
7-7: Version bump is appropriate.The patch-level version increment aligns with the changes made.
42-42: LGTM! Improved description consistency.Removing trailing periods from prop descriptions improves consistency across the action's interface.
Also applies to: 56-56
30-37: categoryId propDefinition implementation verified and correct.The propDefinition exists in
zoho_desk.app.mjs(lines 155-180) with proper async options that depend onportalId. The field is correctly marked as optional and implements pagination support. The refactor from a primitive field to this dynamic propDefinition pattern is implemented correctly and consistently acrosslist-articles.mjsandsearch-articles.mjs.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Hi @michelle0927, LGTM! Ready for QA!
Resolves #18644
Summary by CodeRabbit
Chores
Documentation
New Features