feat(plugin-history-sync): add encode interface for route

[orionmiz]

Summary

• Add encode option to Route interface in plugin-history-sync
• The encode function converts activity params to URL string params (reverse of decode)

Example

const routes = {
  SearchActivity: {
    path: "/search",
    decode: (params) => ({
      filter: JSON.parse(params.filter),
    }),
    encode: (params) => ({
      filter: JSON.stringify(params.filter),
    }),
  },
};

Test plan

• Added test for encode function with JSON.stringify
• All existing tests pass

[changeset-bot]

🦋 Changeset detected

Latest commit: 324c6cb

The changes in this PR will be included in the next version bump.

This PR includes changesets to release 1 package

Name	Type
@stackflow/plugin-history-sync	Minor

Not sure what this means? Click here to learn what changesets are.

Click here if you're a maintainer who wants to add another changeset to this PR

[coderabbitai]

Caution

Review failed

The pull request is closed.

📝 Walkthrough

Summary by CodeRabbit

• New Features
  • Added encode configuration option for routes to customize how activity parameters are converted to URL-encoded format, providing symmetrical encoding alongside existing decode functionality.

_{✏️ Tip: You can customize this high-level summary in your review settings.}

Walkthrough

This pull request introduces encoding support to the route configuration system by adding an optional encode function to the Route interface. The encode function transforms activity parameters into URL-safe string parameters, complementing the existing decode function. Implementation changes apply encoding during path construction when configured.

Changes

Cohort / File(s)	Summary
Changeset Documentation .changeset/purple-chefs-greet.md	Changeset entry documenting minor version bump for @stackflow/plugin-history-sync with encode option addition.
Route Interface Enhancement extensions/plugin-history-sync/src/RouteLike.ts	Added optional encode method to Route type that transforms params into URL-safe string mappings, mirroring the existing decode function.
Template Implementation extensions/plugin-history-sync/src/makeTemplate.ts	Expanded makeTemplate to destructure encode from Route config; modified fill method signature to accept any object type and apply encoding transformation before path/search params construction.
Test Coverage extensions/plugin-history-sync/src/makeTemplate.spec.ts	New test case verifying encode function can transform complex objects (like nested filter params) into JSON-stringified and URL-encoded query strings.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~10 minutes

✨ Finishing touches

• 📝 Generate docstrings

---

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

• X
• Mastodon
• Reddit
• LinkedIn

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

[pkg-pr-new]

• @stackflow/demo

  yarn add https://pkg.pr.new/@stackflow/[email protected]
  

commit: 324c6cb

[cloudflare-workers-and-pages]

Deploying with    Cloudflare Workers

The latest updates on your project. Learn more about integrating Git with Workers.

Status	Name	Latest Commit	Preview URL	Updated (UTC)
✅ Deployment successful! View logs	stackflow-docs	324c6cb	Commit Preview URL	Jan 29 2026, 07:58 AM

[cloudflare-workers-and-pages]

Deploying stackflow-demo with    Cloudflare Pages

Latest commit:	324c6cb
Status:	✅  Deploy successful!
Preview URL:	https://1ebb95f5.stackflow-demo.pages.dev
Branch Preview URL:	https://vk-b077-history-sync-rou.stackflow-demo.pages.dev

View logs