Method UploadAndAttach

internal/attachments/attach.go:23–55

UploadAndAttach uploads assets in order and stops at the first failure. It points existing references at the URLs of successful uploads and appends only successful uploads the markdown did not reference. Assets after a failure are not attempted. The returned count reports how many assets reached th

(ctx context.Context, md string, assets []UserAsset)

// The markdown is returned unchanged when it could not be rewritten, so a
// caller that assigns the result in place never destroys what it was given.
func (u *Uploader) UploadAndAttach(ctx context.Context, md string, assets []UserAsset) (string, int, error) {
	args := make([]attachmentArg, len(assets))
	for i, a := range assets {
		f := a.getAsset()
		args[i] = attachmentArg{Path: f.path, Alt: f.alt, RendersAsPlayer: a.rendersAsPlayer()}
	}

	attachableMD, err := newAttachableMarkdown(md, args)
	if err != nil {
		return md, 0, err
	}

	var failures []error
	uploaded := 0
	for i, a := range assets {
		assetURL, err := u.upload(ctx, a)
		if err != nil {
			// Stopping at the first failure. It makes recovery much simpler.
			failures = append(failures, err)
			break
		}
		args[i].URL = assetURL
		uploaded++
	}

	attachedMD, err := attachAssetsToMarkdown(attachableMD)
	if err != nil {
		failures = append(failures, err)
		return md, uploaded, errors.Join(failures...)
	}

	return appendUnreferenced(attachedMD, assets), uploaded, errors.Join(failures...)
}

// appendUnreferenced adds a paragraph for every attachment the author never
// referenced, in the order they were attached. Each one renders itself, since