// This file is auto-generated by alef — DO NOT EDIT.
// alef:hash:4e15143f4af1ae8bafbdb1506ef057da924484c66a19483966333558ad437e75
// To regenerate: alef generate
// To verify freshness: alef verify --exit-code
// Issues & docs: https://github.com/kreuzberg-dev/alef
package dev.kreuzberg;

import com.fasterxml.jackson.annotation.JsonProperty;
import com.fasterxml.jackson.annotation.JsonInclude;
import com.fasterxml.jackson.databind.annotation.JsonDeserialize;
import com.fasterxml.jackson.databind.annotation.JsonPOJOBuilder;

/**
 * A non-fatal warning from a processing pipeline stage.
 *
 * Captures errors from optional features that don't prevent extraction
 * but may indicate degraded results.
 */
@JsonInclude(JsonInclude.Include.NON_ABSENT)
@JsonDeserialize(builder = ProcessingWarning.Builder.class)
public record ProcessingWarning(
    /**
     * The pipeline stage or feature that produced this warning
     * (e.g., "embedding", "chunking", "language_detection", "output_format").
     */
    @JsonProperty("source") String source,
    /**
     * Human-readable description of what went wrong.
     */
    @JsonProperty("message") String message
) {
    public static Builder builder() {
        return new Builder();
    }

    // CPD-OFF
    @JsonPOJOBuilder(withPrefix = "with", buildMethodName = "build")
    public static final class Builder {

private String source = "";
private String message = "";

        /** Sets the source field. */
        @JsonProperty("source")
        public Builder withSource(final String value) {
            this.source = value;
            return this;
        }

        /** Sets the message field. */
        @JsonProperty("message")
        public Builder withMessage(final String value) {
            this.message = value;
            return this;
        }

        /** Builds the ProcessingWarning instance. */
        public ProcessingWarning build() {
            return new ProcessingWarning(
                source,
                message
            );
        }
    }
    // CPD-ON
}
