Function finalizePortrait

server/src/services/portrait-generator.ts:158–195

(
  rawBuffer: Buffer,
  meta: { vibe: string; palette: string; promptUsed: string },
)

 * fires a throttled notifySystemError alert.
 */
export async function finalizePortrait(
  rawBuffer: Buffer,
  meta: { vibe: string; palette: string; promptUsed: string },
): Promise<GeneratePortraitResult> {
  const badgedBuffer = await compositeAIBadge(rawBuffer);

  if (!isC2PASigningEnabled()) {
    return { imageBuffer: badgedBuffer, promptUsed: meta.promptUsed };
  }
  try {
    const signed = signC2PA(badgedBuffer, {
      claimGenerator: 'AAO Portrait Generator',
      title: 'AAO Member Portrait',
      softwareAgent: { name: GEMINI_IMAGE_MODEL, version: GEMINI_IMAGE_VERSION },
      attributes: {
        vibe: meta.vibe,
        palette: meta.palette,
        prompt_sha256: createHash('sha256').update(meta.promptUsed).digest('hex'),
      },
    });
    return {
      imageBuffer: signed.signedBuffer,
      promptUsed: meta.promptUsed,
      c2pa: { signedAt: new Date(), manifestDigest: signed.manifestDigest },
    };
  } catch (err) {
    const errorMessage = err instanceof Error ? err.message : String(err);
    logger.error({ err, vibe: meta.vibe, palette: meta.palette }, 'C2PA signing failed for portrait');
    notifySystemError({
      source: 'c2pa-portrait-signing',
      errorMessage: `Portrait signing failed (vibe=${meta.vibe}, palette=${meta.palette}): ${errorMessage}`,
    });
    if (process.env.C2PA_STRICT === 'true') {
      throw err;
    }
    return { imageBuffer: badgedBuffer, promptUsed: meta.promptUsed };
  }
}

/**
 * Composite a small "AI" badge in the bottom-right corner of the portrait.