chore: add pkg-pr-new workflow for automated publishing

[hugomrdias]

Summary

• Publish preview builds of @filoz/synapse-sdk, @filoz/synapse-core, and @filoz/synapse-react on every push and pull request via pkg.pr.new, so unreleased changes can be installed without waiting for npm.
• The workflow builds the workspace, then runs pnpm exec pkg-pr-new publish --pnpm './packages/*'. The pkg.pr.new bot comments on PRs with install commands.
• Document the setup and install URLs in Developer Guides, covering PRs (@123), commits (@a832a55), and master (@master).

Example:

npm i https://pkg.pr.new/@filoz/synapse-sdk@937
npm i https://pkg.pr.new/@filoz/synapse-sdk@master
npm i https://pkg.pr.new/@filoz/synapse-sdk@a832a55

Test plan

• Confirm the pkg.pr.new bot commented install URLs on this PR
• Install a preview package from the PR number, a commit SHA, and (after merge) @master
• Check the Preview Packages page renders under Developer Guides and that Getting Started / Core / React links resolve

[socket-security]

Review the following changes in direct dependencies. Learn more about Socket for GitHub.

Diff	Package	Supply Chain Security	Vulnerability	Quality	Maintenance	License
	npm/​pkg-pr-new@​0.0.88

View full report

[pkg-pr-new]

Open in StackBlitz

npm i https://pkg.pr.new/@filoz/synapse-core@937

npm i https://pkg.pr.new/@filoz/synapse-react@937

npm i https://pkg.pr.new/@filoz/synapse-sdk@937

commit: 47c1d32

[SgtPooki]

lgtm. makes me want a focified version honestly..

[Copilot]

Pull request overview

Adds automated preview-package publishing via pkg.pr.new so contributors can install unreleased builds of Synapse packages directly from PRs/commits/master, and documents how to use these previews across the docs site.

Changes:

• Add pkg-pr-new as a dev dependency for running the publish CLI in CI.
• Introduce a new GitHub Actions workflow to build and publish previews on push and pull_request.
• Add documentation and links/redirects for “Preview Packages” across Getting Started and Developer Guides.

Reviewed changes

Copilot reviewed 7 out of 7 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
package.json	Adds pkg-pr-new CLI dependency used by the new publishing workflow.
.github/workflows/pkg-pr-new.yml	New workflow to build the workspace and publish preview packages via pkg.pr.new.
docs/src/content/docs/developer-guides/preview-packages.mdx	New guide explaining preview package setup and install URL formats.
docs/src/content/docs/getting-started/index.mdx	Adds a tip and guide link pointing readers to Preview Packages.
docs/src/content/docs/developer-guides/synapse-react.mdx	Adds a tip linking to Preview Packages for unreleased React builds.
docs/src/content/docs/developer-guides/synapse-core.mdx	Adds a tip linking to Preview Packages for unreleased Core builds.
docs/astro.config.mjs	Adds a redirect to the new Preview Packages doc route.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.