@ahmttyydn/java-integration 1.0.1

package/scalar-core/src/main/java/com/scalar/maven/core/authentication/schemes/ScalarSecurityScheme.java

@@ -0,0 +1,45 @@
+package com.scalar.maven.core.authentication.schemes;
+
+import com.fasterxml.jackson.annotation.JsonSubTypes;
+import com.fasterxml.jackson.annotation.JsonTypeInfo;
+
+/**
+ * Represents the base class for security schemes in Scalar.
+ */
+@JsonTypeInfo(use = JsonTypeInfo.Id.DEDUCTION)
+@JsonSubTypes({
+        @JsonSubTypes.Type(value = ScalarHttpSecurityScheme.class),
+        @JsonSubTypes.Type(value = ScalarApiKeySecurityScheme.class),
+        @JsonSubTypes.Type(value = ScalarOAuth2SecurityScheme.class)
+})
+public abstract class ScalarSecurityScheme {
+
+    /**
+     * Gets or sets the description of this security scheme.
+     */
+    private String description;
+
+    /**
+     * Creates a new ScalarSecurityScheme.
+     */
+    protected ScalarSecurityScheme() {
+    }
+
+    /**
+     * Gets the description of this security scheme.
+     *
+     * @return the description
+     */
+    public String getDescription() {
+        return description;
+    }
+
+    /**
+     * Sets the description of this security scheme.
+     *
+     * @param description the description
+     */
+    public void setDescription(String description) {
+        this.description = description;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/config/DefaultHttpClient.java

@@ -0,0 +1,77 @@
+package com.scalar.maven.core.config;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.scalar.maven.core.enums.ScalarClient;
+import com.scalar.maven.core.enums.ScalarTarget;
+
+/**
+ * Represents the default HTTP client configuration for the Scalar API
+ * reference.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class DefaultHttpClient {
+
+    /**
+     * Gets or sets the target key for the HTTP client.
+     */
+    private ScalarTarget targetKey;
+
+    /**
+     * Gets or sets the client key for the HTTP client.
+     */
+    private ScalarClient clientKey;
+
+
+    /**
+     * Creates a new DefaultHttpClient with the default target and client keys.
+     */
+    public DefaultHttpClient() {
+    }
+
+    /**
+     * Creates a new DefaultHttpClient with the specified target and client keys.
+     *
+     * @param targetKey the target key
+     * @param clientKey the client key
+     */
+    public DefaultHttpClient(ScalarTarget targetKey, ScalarClient clientKey) {
+        this.targetKey = targetKey;
+        this.clientKey = clientKey;
+    }
+
+    /**
+     * Gets the target key.
+     *
+     * @return the target key
+     */
+    public ScalarTarget getTargetKey() {
+        return targetKey;
+    }
+
+    /**
+     * Sets the target key.
+     *
+     * @param targetKey the target key
+     */
+    public void setTargetKey(ScalarTarget targetKey) {
+        this.targetKey = targetKey;
+    }
+
+    /**
+     * Gets the client key.
+     *
+     * @return the client key
+     */
+    public ScalarClient getClientKey() {
+        return clientKey;
+    }
+
+    /**
+     * Sets the client key.
+     *
+     * @param clientKey the client key
+     */
+    public void setClientKey(ScalarClient clientKey) {
+        this.clientKey = clientKey;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/config/ScalarAgentOptions.java

@@ -0,0 +1,68 @@
+package com.scalar.maven.core.config;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * Agent Scalar configuration options.
+ * Enables the AI chat interface in the API Reference or disables it entirely.
+ *
+ * @see <a href="https://github.com/scalar/scalar/blob/main/documentation/configuration.md">Configuration</a>
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class ScalarAgentOptions {
+
+    /**
+     * Agent Scalar key for production deployments. Required for Agent Scalar to
+     * appear in production; when omitted, the agent is enabled only on localhost
+     * with limited free messages.
+     */
+    private String key;
+
+    /**
+     * When true, disables the Agent Scalar chat interface for this source or
+     * for the entire reference (when set at top level).
+     */
+    private Boolean disabled;
+
+    /**
+     * Creates agent options with no key and not disabled.
+     */
+    public ScalarAgentOptions() {
+    }
+
+    /**
+     * Gets the Agent Scalar key.
+     *
+     * @return the key or null
+     */
+    public String getKey() {
+        return key;
+    }
+
+    /**
+     * Sets the Agent Scalar key.
+     *
+     * @param key the key
+     */
+    public void setKey(String key) {
+        this.key = key;
+    }
+
+    /**
+     * Gets whether the agent is disabled.
+     *
+     * @return true if disabled, false if enabled, null if not set
+     */
+    public Boolean getDisabled() {
+        return disabled;
+    }
+
+    /**
+     * Sets whether the agent is disabled.
+     *
+     * @param disabled true to disable, false or null to use default behavior
+     */
+    public void setDisabled(Boolean disabled) {
+        this.disabled = disabled;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/config/ScalarServer.java

@@ -0,0 +1,197 @@
+package com.scalar.maven.core.config;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+import java.util.Map;
+
+/**
+ * Represents a server configuration for the Scalar API Reference.
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class ScalarServer {
+
+    /**
+     * The URL of the server.
+     */
+    private String url;
+
+    /**
+     * A description of the server.
+     */
+    private String description;
+
+    /**
+     * A map of server variables.
+     */
+    private Map<String, ServerVariable> variables;
+
+    /**
+     * Creates a new ScalarServer.
+     */
+    public ScalarServer() {
+    }
+
+    /**
+     * Creates a new ScalarServer with the specified URL.
+     *
+     * @param url the server URL
+     */
+    public ScalarServer(String url) {
+        this.url = url;
+    }
+
+    /**
+     * Creates a new ScalarServer with the specified URL and description.
+     *
+     * @param url         the server URL
+     * @param description the server description
+     */
+    public ScalarServer(String url, String description) {
+        this.url = url;
+        this.description = description;
+    }
+
+    /**
+     * Gets the server URL.
+     *
+     * @return the server URL
+     */
+    public String getUrl() {
+        return url;
+    }
+
+    /**
+     * Sets the server URL.
+     *
+     * @param url the server URL
+     */
+    public void setUrl(String url) {
+        this.url = url;
+    }
+
+    /**
+     * Gets the server description.
+     *
+     * @return the server description
+     */
+    public String getDescription() {
+        return description;
+    }
+
+    /**
+     * Sets the server description.
+     *
+     * @param description the server description
+     */
+    public void setDescription(String description) {
+        this.description = description;
+    }
+
+    /**
+     * Gets the server variables.
+     *
+     * @return the server variables
+     */
+    public Map<String, ServerVariable> getVariables() {
+        return variables;
+    }
+
+    /**
+     * Sets the server variables.
+     *
+     * @param variables the server variables
+     */
+    public void setVariables(Map<String, ServerVariable> variables) {
+        this.variables = variables;
+    }
+
+    /**
+     * Represents a server variable.
+     */
+    @JsonInclude(JsonInclude.Include.NON_NULL)
+    public static class ServerVariable {
+        /**
+         * The default value for the variable.
+         */
+        private String defaultValue;
+
+        /**
+         * A description of the variable.
+         */
+        private String description;
+
+        /**
+         * An array of possible values for the variable.
+         */
+        private String[] enumValues;
+
+        /**
+         * Creates a new ServerVariable.
+         */
+        public ServerVariable() {
+        }
+
+        /**
+         * Creates a new ServerVariable with the specified default value.
+         *
+         * @param defaultValue the default value
+         */
+        public ServerVariable(String defaultValue) {
+            this.defaultValue = defaultValue;
+        }
+
+        /**
+         * Gets the default value.
+         *
+         * @return the default value
+         */
+        public String getDefaultValue() {
+            return defaultValue;
+        }
+
+        /**
+         * Sets the default value.
+         *
+         * @param defaultValue the default value
+         */
+        public void setDefaultValue(String defaultValue) {
+            this.defaultValue = defaultValue;
+        }
+
+        /**
+         * Gets the description.
+         *
+         * @return the description
+         */
+        public String getDescription() {
+            return description;
+        }
+
+        /**
+         * Sets the description.
+         *
+         * @param description the description
+         */
+        public void setDescription(String description) {
+            this.description = description;
+        }
+
+        /**
+         * Gets the enum values.
+         *
+         * @return the enum values
+         */
+        public String[] getEnumValues() {
+            return enumValues;
+        }
+
+        /**
+         * Sets the enum values.
+         *
+         * @param enumValues the enum values
+         */
+        public void setEnumValues(String[] enumValues) {
+            this.enumValues = enumValues;
+        }
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/config/ScalarSource.java

@@ -0,0 +1,151 @@
+package com.scalar.maven.core.config;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+
+/**
+ * Defines an OpenAPI Reference source
+ */
+@JsonInclude(JsonInclude.Include.NON_NULL)
+public class ScalarSource {
+
+    /**
+     * The URL of the OpenAPI specification to display in the API Reference.
+     */
+    private String url;
+
+    /**
+     * The display title of the OpenAPI specification
+     * optional
+     */
+    private String title;
+
+    /**
+     * The url slug of the OpenAPI specification
+     * optional, would be auto-generated from the title or the index
+     */
+    private String slug;
+
+    /**
+     * Whether this is the default source
+     * optional
+     */
+    private Boolean isDefault;
+
+    /**
+     * Agent Scalar options for this source (key for production, or disabled to
+     * turn off the agent for this document).
+     */
+    private ScalarAgentOptions agent;
+
+    /**
+     * Creates an OpenAPI Reference source
+     * {@link #url} must be set
+     */
+    public ScalarSource() {
+    }
+
+    /**
+     * Creates an OpenAPI Reference source
+     *
+     * @param url       the url of the OpenAPI specification
+     * @param title     the display title of the OpenAPI specification
+     * @param slug      the url slug of the OpenAPI specification
+     * @param isDefault whether this is the default source
+     */
+    public ScalarSource(String url, String title, String slug, Boolean isDefault) {
+        this.url = url;
+        this.title = title;
+        this.slug = slug;
+        this.isDefault = isDefault;
+    }
+
+    /**
+     * Gets the URL of the OpenAPI specification
+     *
+     * @return the url
+     */
+    public String getUrl() {
+        return url;
+    }
+
+    /**
+     * Sets the URL of the OpenAPI specification
+     *
+     * @param url the url
+     */
+    public void setUrl(String url) {
+        this.url = url;
+    }
+
+    /**
+     * Gets the display title of the OpenAPI specification
+     *
+     * @return the display title or null
+     */
+    public String getTitle() {
+        return title;
+    }
+
+    /**
+     * Sets the display title of the OpenAPI specification
+     *
+     * @param title the display title
+     */
+    public void setTitle(String title) {
+        this.title = title;
+    }
+
+    /**
+     * Gets the url slug of the OpenAPI specification
+     *
+     * @return the url slug or null
+     */
+    public String getSlug() {
+        return slug;
+    }
+
+    /**
+     * Sets the url slug of the OpenAPI specification
+     *
+     * @param slug the url slug
+     */
+    public void setSlug(String slug) {
+        this.slug = slug;
+    }
+
+    /**
+     * Gets whether this is the default source
+     *
+     * @return whether this is the default source or null
+     */
+    public Boolean isDefault() {
+        return isDefault;
+    }
+
+    /**
+     * Sets whether this is the default source
+     *
+     * @param isDefault whether this is the default source
+     */
+    public void setDefault(Boolean isDefault) {
+        this.isDefault = isDefault;
+    }
+
+    /**
+     * Gets the Agent Scalar options for this source.
+     *
+     * @return the agent options or null
+     */
+    public ScalarAgentOptions getAgent() {
+        return agent;
+    }
+
+    /**
+     * Sets the Agent Scalar options for this source.
+     *
+     * @param agent the agent options
+     */
+    public void setAgent(ScalarAgentOptions agent) {
+        this.agent = agent;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/enums/CredentialsLocation.java

@@ -0,0 +1,52 @@
+package com.scalar.maven.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * Represents where OAuth2 credentials should be sent in HTTP requests.
+ */
+public enum CredentialsLocation {
+    /**
+     * Send credentials in the HTTP header.
+     */
+    HEADER("header"),
+
+    /**
+     * Send credentials in the HTTP body.
+     */
+    BODY("body");
+
+    private final String value;
+
+    CredentialsLocation(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Creates a CredentialsLocation from a string value.
+     *
+     * @param value the string value
+     * @return the corresponding CredentialsLocation
+     * @throws IllegalArgumentException if the value is not recognized
+     */
+    @JsonCreator
+    public static CredentialsLocation fromValue(String value) {
+        for (CredentialsLocation location : values()) {
+            if (location.value.equals(value)) {
+                return location;
+            }
+        }
+        throw new IllegalArgumentException("Unknown credentials location: " + value);
+    }
+
+    /**
+     * Gets the string value for JSON serialization.
+     *
+     * @return the string value
+     */
+    @JsonValue
+    public String getValue() {
+        return value;
+    }
+}

package/scalar-core/src/main/java/com/scalar/maven/core/enums/DeveloperToolsVisibility.java

@@ -0,0 +1,58 @@
+package com.scalar.maven.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * Represents the visibility of the developer tools toolbar for the Scalar API Reference.
+ */
+public enum DeveloperToolsVisibility {
+    /**
+     * Always show the toolbar.
+     */
+    ALWAYS("always"),
+
+    /**
+     * Only show the toolbar on localhost or similar hosts.
+     */
+    LOCALHOST("localhost"),
+
+    /**
+     * Never show the toolbar.
+     */
+    NEVER("never");
+
+    private final String value;
+
+    DeveloperToolsVisibility(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Creates a DeveloperToolsVisibility from a string value.
+     *
+     * @param value the string value
+     * @return the corresponding DeveloperToolsVisibility
+     * @throws IllegalArgumentException if the value is not recognized
+     */
+    @JsonCreator
+    public static DeveloperToolsVisibility fromValue(String value) {
+        for (DeveloperToolsVisibility visibility : values()) {
+            if (visibility.value.equals(value)) {
+                return visibility;
+            }
+        }
+        throw new IllegalArgumentException("Unknown developer tools visibility: " + value);
+    }
+
+    /**
+     * Gets the string value for JSON serialization.
+     *
+     * @return the string value
+     */
+    @JsonValue
+    public String getValue() {
+        return value;
+    }
+}
+

package/scalar-core/src/main/java/com/scalar/maven/core/enums/DocumentDownloadType.java

@@ -0,0 +1,67 @@
+package com.scalar.maven.core.enums;
+
+import com.fasterxml.jackson.annotation.JsonCreator;
+import com.fasterxml.jackson.annotation.JsonValue;
+
+/**
+ * Specifies the available download formats for API documentation.
+ */
+public enum DocumentDownloadType {
+    /**
+     * Download documentation in JSON format.
+     */
+    JSON("json"),
+
+    /**
+     * Download documentation in YAML format.
+     */
+    YAML("yaml"),
+
+    /**
+     * Download documentation in both JSON and YAML formats.
+     */
+    BOTH("both"),
+
+    /**
+     * Show the regular link to the OpenAPI document.
+     */
+    DIRECT("direct"),
+
+    /**
+     * Do not allow documentation downloads.
+     */
+    NONE("none");
+
+    private final String value;
+
+    DocumentDownloadType(String value) {
+        this.value = value;
+    }
+
+    /**
+     * Creates a DocumentDownloadType from a string value.
+     *
+     * @param value the string value
+     * @return the corresponding DocumentDownloadType
+     * @throws IllegalArgumentException if the value is not recognized
+     */
+    @JsonCreator
+    public static DocumentDownloadType fromValue(String value) {
+        for (DocumentDownloadType type : values()) {
+            if (type.value.equals(value)) {
+                return type;
+            }
+        }
+        throw new IllegalArgumentException("Unknown document download type: " + value);
+    }
+
+    /**
+     * Gets the string value for JSON serialization.
+     *
+     * @return the string value
+     */
+    @JsonValue
+    public String getValue() {
+        return value;
+    }
+}