Function createProduct

server/src/billing/stripe-client.ts:1574–1648

(input: CreateProductInput)

 * Creates both the product and an associated price with lookup key
 */
export async function createProduct(input: CreateProductInput): Promise<BillingProduct | null> {
  if (!stripe) {
    logger.warn('Stripe not initialized - cannot create product');
    return null;
  }

  // Validate lookup key format
  if (!input.lookupKey.startsWith('aao_')) {
    throw new Error('Lookup key must start with "aao_"');
  }

  try {
    // Build metadata
    const metadata: Record<string, string> = {
      category: input.category,
    };
    if (input.displayName) metadata.display_name = input.displayName;
    if (input.customerTypes?.length) metadata.customer_types = input.customerTypes.join(',');
    if (input.revenueTiers?.length) 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);

    // Create the product
    const product = await stripe.products.create({
      name: input.name,
      description: input.description,
      metadata,
    });

    // Create the price with lookup key
    const price = await stripe.prices.create({
      product: product.id,
      unit_amount: input.amountCents,
      currency: input.currency || 'usd',
      lookup_key: input.lookupKey,
      transfer_lookup_key: true,
      ...(input.billingType === 'subscription' ? {
        recurring: { interval: input.billingInterval || 'year' },
      } : {}),
    });

    logger.info({
      productId: product.id,
      priceId: price.id,
      lookupKey: input.lookupKey,
    }, 'Created product and price in Stripe');

    // Clear cache so new product appears
    clearProductsCache();

    // Return the billing product
    return {
      lookup_key: input.lookupKey,
      price_id: price.id,
      product_id: product.id,
      product_name: product.name,
      display_name: input.displayName || product.name,
      description: product.description,