Skip to content

Kv/improve upgrade envio docs#722

Closed
keenbeen32 wants to merge 6 commits intomainfrom
kv/improve-upgrade-envio-docs
Closed

Kv/improve upgrade envio docs#722
keenbeen32 wants to merge 6 commits intomainfrom
kv/improve-upgrade-envio-docs

Conversation

@keenbeen32
Copy link
Collaborator

@keenbeen32 keenbeen32 commented Oct 20, 2025

Added upgrade envio version section and reccomended file structure for block handlers.

Summary by CodeRabbit

  • Documentation

    • Added guidance clarifying that block handlers must be declared in or imported by a handler file referenced in config.yaml. Recommends using a single index handler that imports other handler files, with before/after config examples and implementation patterns to ensure handlers register and run correctly.
  • Chores

    • Reformatted supported networks configuration.

@vercel
Copy link

vercel bot commented Oct 20, 2025

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Preview Comments Updated (UTC)
envio-docs Ready Ready Preview Comment Nov 10, 2025 8:43am

@coderabbitai
Copy link
Contributor

coderabbitai bot commented Oct 20, 2025

Walkthrough

Clarifies that block handlers must be declared in or imported by a handler file referenced in config.yaml and recommends an index handler pattern; also reformats supported-networks.json (non-functional JSON reflow).

Changes

Cohort / File(s) Summary
Documentation
docs/HyperIndex/Guides/block-handlers.md
Adds guidance that standalone block handler files won't run unless declared in or imported by a handler file referenced in config.yaml. Shows a recommended index pattern (EventHandlers.ts) with Before/After config.yaml examples and sample imports.
JSON Reformatting
supported-networks.json
Reflowed and reordered entries for readability; no functional changes to content.

Sequence Diagram(s)

sequenceDiagram
  autonumber
  participant Config as config.yaml
  participant Index as EventHandlers.ts
  participant ImportA as BlockHandlerA.ts
  participant Runtime as Runtime/Registration

  rect rgba(200,230,255,0.3)
    Config->>Index: reference handler file
    Note right of Index: Index imports block handlers
    Index->>ImportA: import BlockHandlerA
  end

  rect rgba(200,255,200,0.2)
    Index->>Runtime: register handlers (on startup)
    Runtime->>ImportA: invoke block handler when event occurs
  end
Loading

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

  • Focus review on accuracy of the documented pattern in docs/HyperIndex/Guides/block-handlers.md.
  • Confirm supported-networks.json reflow did not alter content (ordering only).

Possibly related issues

Possibly related PRs

Suggested reviewers

  • DenhamPreen

Poem

🐰
I hop through code and tidy lairs,
Indexing handlers with careful cares,
Imported friends all lined in file,
Config nods and runs with style,
A happy warren, neat and fair!

Pre-merge checks and finishing touches

❌ Failed checks (1 inconclusive)
Check name Status Explanation Resolution
Title check ❓ Inconclusive The title 'Kv/improve upgrade envio docs' is overly generic and uses a branch name prefix, failing to clearly communicate the specific documentation improvements made regarding block handler setup. Consider a more descriptive title like 'Document block handler registration and recommended EventHandlers.ts structure' to clearly convey the main documentation change.
✅ Passed checks (2 passed)
Check name Status Explanation
Description Check ✅ Passed Check skipped - CodeRabbit’s high-level summary is enabled.
Docstring Coverage ✅ Passed No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
✨ Finishing touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Post copyable unit tests in a comment
  • Commit unit tests in branch kv/improve-upgrade-envio-docs

📜 Recent review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between f7ebef8 and d94f358.

📒 Files selected for processing (1)
  • supported-networks.json (1 hunks)
🚧 Files skipped from review as they are similar to previous changes (1)
  • supported-networks.json

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.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@keenbeen32 keenbeen32 requested a review from DZakh October 20, 2025 13:15
Copy link
Contributor

@coderabbitai coderabbitai bot left a 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

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between dafce63 and ab7f2a9.

📒 Files selected for processing (3)
  • docs/HyperIndex/Guides/block-handlers.md (1 hunks)
  • docs/HyperIndex/Guides/upgrading-envio.md (1 hunks)
  • sidebarsHyperIndex.js (1 hunks)
🧰 Additional context used
🪛 markdownlint-cli2 (0.18.1)
docs/HyperIndex/Guides/block-handlers.md

198-198: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)


210-210: Emphasis used instead of a heading

(MD036, no-emphasis-as-heading)

🔇 Additional comments (8)
docs/HyperIndex/Guides/block-handlers.md (2)

192-193: LGTM! Clear documentation of the handler registration requirement.

The limitation is well-stated and will help users understand the registration behavior.


222-227: LGTM! Clear example of the recommended centralized handler approach.

The EventHandlers.ts example clearly demonstrates how to import and centralize all handlers in one place.

sidebarsHyperIndex.js (1)

60-60: LGTM! Sidebar navigation updated correctly.

The new upgrading guide is appropriately placed in the Guides section.

docs/HyperIndex/Guides/upgrading-envio.md (5)

1-11: LGTM! Clear introduction and frontmatter.

The document metadata and introduction are well-structured and set clear expectations.


12-18: LGTM! Method 1 is clear and concise.

The recommended upgrade method using pnpm install envio@latest is straightforward and well-documented.


20-36: LGTM! Method 2 provides excellent guidance for version-specific installations.

The explanation of viewing available versions and identifying stable releases is particularly helpful for users who need more control over their upgrade process.


38-55: LGTM! Method 3 offers a valid alternative approach.

The manual package.json update method is clearly documented with step-by-step instructions.


57-71: LGTM! Verification and troubleshooting steps are helpful.

Including the version verification command and fallback uninstall/reinstall steps enhances the user experience when encountering upgrade issues.

Copy link
Contributor

@coderabbitai coderabbitai bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Actionable comments posted: 0

🧹 Nitpick comments (1)
sidebarsHyperIndex.js (1)

59-59: LGTM - Minor formatting change.

The trailing comma removal is harmless. Note that line 86 still has a trailing comma after the last item in the Hosting items array, creating a minor inconsistency in comma usage across the file.

📜 Review details

Configuration used: CodeRabbit UI

Review profile: CHILL

Plan: Pro

📥 Commits

Reviewing files that changed from the base of the PR and between ab7f2a9 and 5b90408.

📒 Files selected for processing (2)
  • sidebarsHyperIndex.js (1 hunks)
  • supported-networks.json (1 hunks)
✅ Files skipped from review due to trivial changes (1)
  • supported-networks.json

Comment on lines +192 to +196
- **Block handlers must be in or imported by a handler file referenced in `config.yaml`**. Standalone block handler files won't execute. See recommended approach below.

### Recommended Approach

To ensure your block handlers run properly, create an index handler file (e.g., `EventHandlers.ts`) and have all contracts point to this file in your `config.yaml`. Then import your other handler files, including block handler files, in this index file.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The PR should fix it, so I'm not sure whether we want to add this documentation section

enviodev/hyperindex#808

Copy link
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@DZakh ok sweet can delete this then

@keenbeen32 keenbeen32 closed this Nov 10, 2025
@keenbeen32
Copy link
Collaborator Author

Latest hyperindex PR solves the issue this section was going to explain.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants