Update product schema

[lfades]

The product schema defined in framework/commerce/types/product.ts doesn't have any docs yet, also any updates on fields that might be missing for current or future features are welcome!

Every field defined needs to have docs, we do that using comments, e.g:

/**
 * The product's id.
 */
id: string