feat(cli): add cli command to setup custom ui local debugging proxy

[charIeszhao]

Summary

Add new CLI command to setup a proxy server for custom UI local developing & debugging purposes. This proxy tool will establish a proxy tunnel and connect the following 3 entities together: your Logto cloud auth services, your application, and your custom sign-in UI.

Assuming your Cloud tenant ID is foobar, and you have a custom sign-in page running on dev server at http://localhost:4000.

Then you can execute the command this way:

npm cli proxy -p 9000 --experience-uri http://localhost:4000/ --endpoint https://foobar.logto.app/

It also works well if you have custom domain configured in Logto:

npm cli proxy -p 9000 --experience-uri http://localhost:4000/ --endpoint https://your.custom.domain/

Alternatively, the command also supports static html assets without needing to run it first on a dev server. Just make sure there's a index.html in the path you specified.

npm cli proxy -p 9000 --experience-path /path/to/your/static/files --endpoint https://foobar.logto.app/

After this, run your application and set the endpoint to http://localhost:9000/.

Testing

Locally tested with React sample and a custom sign-in page

Checklist

• .changeset
• unit tests
• integration tests
• necessary TSDoc comments

[github-actions]

COMPARE TO master

Total Size Diff ⚠️ 📈 +11.58 KB

Diff by File

Name	Diff
.changeset/slow-buses-rhyme.md	📈 +1.46 KB
packages/cli/package.json	📈 +61 Bytes
packages/cli/src/commands/proxy/index.ts	📈 +3.08 KB
packages/cli/src/commands/proxy/types.ts	📈 +401 Bytes
packages/cli/src/commands/proxy/utils.ts	📈 +5.74 KB
packages/cli/src/index.ts	📈 +65 Bytes
pnpm-lock.yaml	📈 +806 Bytes

[gao-sun]

no blocking though