BilalG1 6d9c2b1fea inline product metadata (#963) ... <!-- 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 support for custom `metadata` to inline products in the payments system. The change allows developers to attach arbitrary metadata to products created inline (without pre-configuration), which Stack Auth will store and return with the product. This enables applications to associate custom data such as feature flags, reference IDs, or other application-specific attributes with products. The implementation adds a new `productSchemaWithMetadata` schema, updates the product type handling in the backend, and includes comprehensive e2e tests verifying metadata is persisted and returned correctly through purchase creation, validation, and listing endpoints. ⏱️ Estimated Review Time: 15-30 minutes <details> <summary>💡 Review Order Suggestion</summary> | Order | File Path | |-------|-----------| | 1 | `packages/stack-shared/src/schema-fields.ts` | | 2 | `apps/backend/src/lib/payments.tsx` | | 3 | `apps/e2e/tests/backend/endpoints/api/v1/payments/purchase-session.test.ts` | | 4 | `apps/e2e/tests/backend/endpoints/api/v1/payments/create-purchase-url.test.ts` | | 5 | `apps/e2e/tests/backend/endpoints/api/v1/payments/products.test.ts` | </details> [](https://discord.gg/n3SsVDAW6U) [ <!-- RECURSEML_SUMMARY:END --> <!-- This is an auto-generated comment: release notes by coderabbit.ai --> ## Summary by CodeRabbit * **New Features** * Products now support custom metadata (client, client read-only, and server) and expose these fields in inline product representations. * Metadata is preserved and propagated through purchase creation, validation, grants, and owned-product listings so it’s available after purchase. * **Tests** * Added end-to-end tests verifying metadata is accepted, persisted, and returned in purchase creation, validation, grant, and listing flows. <!-- end of auto-generated comment: release notes by coderabbit.ai --> <!-- ELLIPSIS_HIDDEN --> ---- > [!IMPORTANT] > Adds support for custom metadata in inline products, updating schemas and functions to handle metadata, with comprehensive tests verifying the changes. > > - **Behavior**: > - Adds support for custom metadata in inline products, allowing arbitrary metadata attachment. > - Updates `ensureProductIdOrInlineProduct()` and `productToInlineProduct()` in `payments.tsx` to handle metadata. > - Metadata is preserved and returned in purchase creation, validation, and listing endpoints. > - **Schemas**: > - Adds `productSchemaWithMetadata` in `schema-fields.ts` to include `clientMetadata`, `clientReadOnlyMetadata`, and `serverMetadata`. > - Updates `inlineProductSchema` to support metadata fields. > - **Tests**: > - Adds e2e tests in `purchase-session.test.ts`, `create-purchase-url.test.ts`, and `products.test.ts` to verify metadata handling. > > <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 1b5601c991. You can [customize](https://app.ellipsis.dev/stack-auth/settings/summaries) this summary. It will automatically update as commits are pushed.</sup> <!-- ELLIPSIS_HIDDEN --> --------- Co-authored-by: Konsti Wohlwend <n2d4xc@gmail.com>		2025-10-27 10:03:44 -07:00
..
app	Make most pages static	2025-10-21 01:41:41 -07:00
auto-migrations	payment test mode fixes (#957)	2025-10-15 19:14:45 -07:00
lib	inline product metadata (#963)	2025-10-27 10:03:44 -07:00
oauth	Page transition prefetching	2025-10-16 12:02:46 -07:00
route-handlers	Fix JWKS endpoint headers	2025-09-12 18:13:57 -07:00
utils	Workflows (#873)	2025-09-03 01:22:08 -07:00
analytics.tsx	Fix event capture	2024-08-14 12:49:35 -07:00
globals.d.ts	Split backend and dashboard (#83)	2024-06-18 15:49:31 +02:00
instrumentation.ts	Customizable ports (#962)	2025-10-20 15:24:47 -07:00
middleware.tsx	Make tests less flakey	2025-10-20 12:06:46 -07:00
polyfills.tsx	Customizable ports (#962)	2025-10-20 15:24:47 -07:00
prisma-client.tsx	Customizable ports (#962)	2025-10-20 15:24:47 -07:00
s3.tsx	Project logo upload (#817)	2025-08-19 04:45:16 +02:00
smart-router.tsx	Move /api/v1 to /api/latest	2025-02-05 17:24:43 -08:00
stack.tsx	encrypt neon connection strings, update connections route (#879)	2025-09-09 21:35:07 +00:00