Function updateProductMetadata

server/src/billing/stripe-client.ts:1653–1709

(input: UpdateProductInput)

 * Update product metadata (cannot change price amount - need to create new price)
 */
export async function updateProductMetadata(input: UpdateProductInput): Promise<BillingProduct | null> {
  if (!stripe) {
    logger.warn('Stripe not initialized - cannot update product');
    return null;
  }

  try {
    // Build updated metadata
    const metadata: Record<string, string> = {};
    if (input.category) metadata.category = input.category;
    if (input.displayName) metadata.display_name = input.displayName;
    if (input.customerTypes !== undefined) metadata.customer_types = input.customerTypes.join(',');
    if (input.revenueTiers !== undefined) metadata.revenue_tiers = input.revenueTiers.join(',');
    if (input.invoiceable !== undefined) metadata.invoiceable = String(input.invoiceable);
    if (input.sortOrder !== undefined) metadata.sort_order = String(input.sortOrder);

    // Update product
    const product = await stripe.products.update(input.productId, {
      metadata,
      ...(input.name ? { name: input.name } : {}),
      ...(input.description !== undefined ? { description: input.description } : {}),
    });

    // Get the price to return full billing product
    const price = await stripe.prices.retrieve(input.priceId);

    logger.info({
      productId: product.id,
      priceId: input.priceId,
    }, 'Updated product metadata in Stripe');

    // Clear cache
    clearProductsCache();

    return {
      lookup_key: price.lookup_key || '',
      price_id: price.id,
      product_id: product.id,
      product_name: product.name,
      display_name: product.metadata?.display_name || product.name,
      description: product.description,
      amount_cents: price.unit_amount || 0,
      currency: price.currency,
      category: product.metadata?.category || 'other',
      billing_type: price.recurring ? 'subscription' : 'one_time',
      billing_interval: price.recurring?.interval || null,
      customer_types: parseMetadataArray(product.metadata?.customer_types),
      revenue_tiers: parseMetadataArray(product.metadata?.revenue_tiers),
      is_invoiceable: product.metadata?.invoiceable === 'true' || !price.recurring,
      sort_order: parseInt(product.metadata?.sort_order || '0', 10),
      metadata: product.metadata || {},
    };
  } catch (error) {
    logger.error({ err: error, input }, 'Error updating product');
    throw error;
  }
}