mirror of https://github.com/stack-auth/stack.git synced 2026-06-13 21:01:21 +08:00

History

BilalG1 c6b00e1a8b dashboard payment customers, grant product routes and sdk (#939 ) https://www.loom.com/share/2767f799df9d48519c737a1d082fc3f4?sid=967802e9-5bfb-438d-96cd-2f6fcbd2f69b <!-- Make sure you've read the CONTRIBUTING.md guidelines: https://github.com/stack-auth/stack-auth/blob/dev/CONTRIBUTING.md --> <!-- RECURSEML_SUMMARY:START --> ## High-level PR Summary This PR adds a "Grant Product" feature to the dashboard's customer page, allowing administrators to manually grant products to users, teams, or custom customers. The UI has been updated to rename "Items" to "Customers" in the navigation, and the page now includes a dialog for selecting a product and quantity (for stackable products) to grant. Additionally, the backend payment logic has been enhanced to properly set `currentPeriodEnd` and `cancelAtPeriodEnd` when canceling conflicting subscriptions during product grants. ⏱️ Estimated Review Time: 15-30 minutes <details> <summary>💡 Review Order Suggestion</summary> \| Order \| File Path \| \|-------\|-----------\| \| 1 \| `apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/sidebar-layout.tsx` \| \| 2 \| `apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/payments/customers/page.tsx` \| \| 3 \| `apps/dashboard/src/app/(main)/(protected)/projects/[projectId]/payments/customers/page-client.tsx` \| \| 4 \| `apps/backend/src/lib/payments.tsx` \| \| 5 \| `packages/template/src/lib/stack-app/apps/implementations/server-app-impl.ts` \| </details> <details> <summary>⚠️ Inconsistent Changes Detected</summary> \| File Path \| Warning \| \|-----------\|---------\| \| `packages/template/src/lib/stack-app/apps/implementations/server-app-impl.ts` \| This appears to be a simple variable rename (cache to itemsCache) that seems unrelated to adding grant product functionality to the dashboard \| </details> [![Need help? Join our Discord](https://img.shields.io/badge/Need%20help%3F%20Join%20our%20Discord-5865F2?style=plastic&logo=discord&logoColor=white)](https://discord.gg/n3SsVDAW6U) [![Analyze latest changes](`12eeb03aeb`/?repo_owner=stack-auth&repo_name=stack-auth&pr_number=939) <!-- RECURSEML_SUMMARY:END --> <!-- ELLIPSIS_HIDDEN --> ---- > [!IMPORTANT] > Adds "Grant Product" feature to dashboard, enabling admins to grant products to customers, with new API endpoints, UI updates, and backend logic enhancements. > > - Behavior: > - Adds "Grant Product" feature to dashboard's customer page, allowing admins to grant products to users, teams, or custom customers. > - Updates UI to rename "Items" to "Customers" in navigation and adds dialogs for product selection and quantity. > - Enhances backend payment logic to set `currentPeriodEnd` and `cancelAtPeriodEnd` when canceling conflicting subscriptions. > - API: > - New endpoints in `route.ts` for listing customer products and granting products. > - Implements `grantProductToCustomer()` in `payments.tsx` to handle product grants. > - SDK: > - Adds `grantProduct` (server) and `listProducts` (client/server) methods. > - Updates `client-app-impl.ts` and `server-app-impl.ts` to support new product functionalities. > - Models: > - Adds `CustomerProduct` and `CustomerProductsList` types in `customers/index.ts`. > - Misc: > - Introduces `PRODUCT_ALREADY_GRANTED` error in `known-errors.tsx`. > - Updates tests in `products.test.ts` and other test files to cover new product grant scenarios. > > <sup>This description was created by </sup>[<img alt="Ellipsis" src="https://img.shields.io/badge/Ellipsis-blue?color=175173">](https://www.ellipsis.dev?ref=stack-auth%2Fstack-auth&utm_source=github&utm_medium=referral)<sup> for `f0d112f578`. You can [customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this summary. It will automatically update as commits are pushed.</sup> ---- <!-- ELLIPSIS_HIDDEN --> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit - New Features - Dashboard: New "Customers" page to view customers, grant products, and manage items with dialogs and selectors for users, teams, or custom IDs. - API/SDK: Endpoints and client/server SDK methods to list a customer’s products (paginated) and to grant products. - Improvements - Error responses for already-owned non-stackable products are now structured with clear codes and headers. - Product payloads include server_only, included_items, and new stackable support. - UI - Team search table and clickable team rows for faster navigation. <!-- end of auto-generated comment: release notes by coderabbit.ai --> --------- Co-authored-by: Konsti Wohlwend <n2d4xc@gmail.com>		2025-10-10 14:20:40 -07:00
..
scripts	Widget playground mobile mode	2025-07-14 20:04:43 -07:00
src	dashboard payment customers, grant product routes and sdk (#939 )	2025-10-10 14:20:40 -07:00
.env	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
.eslintrc.cjs	tsup for stack-shared (#647 )	2025-04-28 21:26:52 -07:00
.gitignore	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
CHANGELOG.md	chore: update package versions	2025-09-26 23:16:39 -05:00
components.json	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
LICENSE	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
next-env.d.ts	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
package-template.json	Convex README	2025-10-10 04:27:05 -07:00
package.json	Convex README	2025-10-10 04:27:05 -07:00
postcss.config.js	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
quetzal.config.json	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
README.md	Update branding from Stack to Stack Auth in documentation (#504 )	2025-03-04 04:07:54 +01:00
tailwind.config.js	Vanilla JS client library (#408 )	2025-02-08 02:31:03 +01:00
tsconfig.json	In-source unit tests (#429 )	2025-02-14 11:47:52 -08:00
tsup.config.ts	Convex README	2025-10-10 04:27:05 -07:00
vitest.config.ts	In-source unit tests (#429 )	2025-02-14 11:47:52 -08:00

README.md

Stack Auth: Open-source Clerk/Auth0 alternative

📘 Docs | ☁️ Hosted Version | ✨ Demo | 🎮 Discord | GitHub

Stack Auth is a managed user authentication solution. It is developer-friendly and fully open-source (licensed under MIT and AGPL).

Stack Auth gets you started in just five minutes, after which you'll be ready to use all of its features as you grow your project. Our managed service is completely optional and you can export your user data and self-host, for free, at any time.

We support Next.js frontends, along with any backend that can use our REST API. Check out our setup guide to get started.

📦 Installation & Setup

Run Stack Auth's installation wizard with the following command:
```
npx @stackframe/init-stack@latest
```
Then, create an account on the Stack Auth dashboard, create a new project with an API key, and copy its environment variables into the .env.local file of your Next.js project:
```
NEXT_PUBLIC_STACK_PROJECT_ID=<your-project-id>
NEXT_PUBLIC_STACK_PUBLISHABLE_CLIENT_KEY=<your-publishable-client-key>
STACK_SECRET_SERVER_KEY=<your-secret-server-key>
```
That's it! You can run your app with npm run dev and go to http://localhost:3000/handler/signup to see the sign-up page. You can also check out the account settings page at http://localhost:3000/handler/account-settings.

Check out the documentation for a more detailed guide.