Initial Commit

.gitignore

@@ -0,0 +1,44 @@
+.gradle
+build/
+!gradle/wrapper/gradle-wrapper.jar
+!**/src/main/**/build/
+!**/src/test/**/build/
+
+### IntelliJ IDEA ###
+.idea/modules.xml
+.idea/jarRepositories.xml
+.idea/compiler.xml
+.idea/libraries/
+*.iws
+*.iml
+*.ipr
+out/
+!**/src/main/**/out/
+!**/src/test/**/out/
+
+### Eclipse ###
+.apt_generated
+.classpath
+.factorypath
+.project
+.settings
+.springBeans
+.sts4-cache
+bin/
+!**/src/main/**/bin/
+!**/src/test/**/bin/
+
+### NetBeans ###
+/nbproject/private/
+/nbbuild/
+/dist/
+/nbdist/
+/.nb-gradle/
+
+### VS Code ###
+.vscode/
+
+### Mac OS ###
+.DS_Store
+
+.idea

LICENSE

@@ -0,0 +1,8 @@
+Copyright 2023 First Dark Development
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+

build.gradle

@@ -0,0 +1,28 @@
+plugins {
+    id 'java'
+}
+
+group = 'com.hypherionmc.nightbloom'
+version = '1.0.0'
+
+repositories {
+    mavenCentral()
+}
+
+dependencies {
+    implementation("com.google.code.gson:gson:2.10.1")
+    implementation("com.squareup.okhttp3:okhttp:4.12.0")
+
+    compileOnly("org.projectlombok:lombok:1.18.30")
+    annotationProcessor("org.projectlombok:lombok:1.18.30")
+
+    testCompileOnly("org.projectlombok:lombok:1.18.30")
+    testAnnotationProcessor("org.projectlombok:lombok:1.18.30")
+
+    testImplementation platform('org.junit:junit-bom:5.9.1')
+    testImplementation 'org.junit.jupiter:junit-jupiter'
+}
+
+test {
+    useJUnitPlatform()
+}

gradle/wrapper/gradle-wrapper.properties

@@ -0,0 +1,6 @@
+#Sun Dec 10 23:57:41 SAST 2023
+distributionBase=GRADLE_USER_HOME
+distributionPath=wrapper/dists
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.0-bin.zip
+zipStoreBase=GRADLE_USER_HOME
+zipStorePath=wrapper/dists

gradlew

@@ -0,0 +1,234 @@
+#!/bin/sh
+
+#
+# Copyright © 2015-2021 the original authors.
+#
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
+#
+#      https://www.apache.org/licenses/LICENSE-2.0
+#
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
+#
+
+##############################################################################
+#
+#   Gradle start up script for POSIX generated by Gradle.
+#
+#   Important for running:
+#
+#   (1) You need a POSIX-compliant shell to run this script. If your /bin/sh is
+#       noncompliant, but you have some other compliant shell such as ksh or
+#       bash, then to run this script, type that shell name before the whole
+#       command line, like:
+#
+#           ksh Gradle
+#
+#       Busybox and similar reduced shells will NOT work, because this script
+#       requires all of these POSIX shell features:
+#         * functions;
+#         * expansions «$var», «${var}», «${var:-default}», «${var+SET}»,
+#           «${var#prefix}», «${var%suffix}», and «$( cmd )»;
+#         * compound commands having a testable exit status, especially «case»;
+#         * various built-in commands including «command», «set», and «ulimit».
+#
+#   Important for patching:
+#
+#   (2) This script targets any POSIX shell, so it avoids extensions provided
+#       by Bash, Ksh, etc; in particular arrays are avoided.
+#
+#       The "traditional" practice of packing multiple parameters into a
+#       space-separated string is a well documented source of bugs and security
+#       problems, so this is (mostly) avoided, by progressively accumulating
+#       options in "$@", and eventually passing that to Java.
+#
+#       Where the inherited environment variables (DEFAULT_JVM_OPTS, JAVA_OPTS,
+#       and GRADLE_OPTS) rely on word-splitting, this is performed explicitly;
+#       see the in-line comments for details.
+#
+#       There are tweaks for specific operating systems such as AIX, CygWin,
+#       Darwin, MinGW, and NonStop.
+#
+#   (3) This script is generated from the Groovy template
+#       https://github.com/gradle/gradle/blob/master/subprojects/plugins/src/main/resources/org/gradle/api/internal/plugins/unixStartScript.txt
+#       within the Gradle project.
+#
+#       You can find Gradle at https://github.com/gradle/gradle/.
+#
+##############################################################################
+
+# Attempt to set APP_HOME
+
+# Resolve links: $0 may be a link
+app_path=$0
+
+# Need this for daisy-chained symlinks.
+while
+    APP_HOME=${app_path%"${app_path##*/}"}  # leaves a trailing /; empty if no leading path
+    [ -h "$app_path" ]
+do
+    ls=$( ls -ld "$app_path" )
+    link=${ls#*' -> '}
+    case $link in             #(
+      /*)   app_path=$link ;; #(
+      *)    app_path=$APP_HOME$link ;;
+    esac
+done
+
+APP_HOME=$( cd "${APP_HOME:-./}" && pwd -P ) || exit
+
+APP_NAME="Gradle"
+APP_BASE_NAME=${0##*/}
+
+# Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+DEFAULT_JVM_OPTS='"-Xmx64m" "-Xms64m"'
+
+# Use the maximum available, or set MAX_FD != -1 to use that value.
+MAX_FD=maximum
+
+warn () {
+    echo "$*"
+} >&2
+
+die () {
+    echo
+    echo "$*"
+    echo
+    exit 1
+} >&2
+
+# OS specific support (must be 'true' or 'false').
+cygwin=false
+msys=false
+darwin=false
+nonstop=false
+case "$( uname )" in                #(
+  CYGWIN* )         cygwin=true  ;; #(
+  Darwin* )         darwin=true  ;; #(
+  MSYS* | MINGW* )  msys=true    ;; #(
+  NONSTOP* )        nonstop=true ;;
+esac
+
+CLASSPATH=$APP_HOME/gradle/wrapper/gradle-wrapper.jar
+
+
+# Determine the Java command to use to start the JVM.
+if [ -n "$JAVA_HOME" ] ; then
+    if [ -x "$JAVA_HOME/jre/sh/java" ] ; then
+        # IBM's JDK on AIX uses strange locations for the executables
+        JAVACMD=$JAVA_HOME/jre/sh/java
+    else
+        JAVACMD=$JAVA_HOME/bin/java
+    fi
+    if [ ! -x "$JAVACMD" ] ; then
+        die "ERROR: JAVA_HOME is set to an invalid directory: $JAVA_HOME
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+    fi
+else
+    JAVACMD=java
+    which java >/dev/null 2>&1 || die "ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+
+Please set the JAVA_HOME variable in your environment to match the
+location of your Java installation."
+fi
+
+# Increase the maximum file descriptors if we can.
+if ! "$cygwin" && ! "$darwin" && ! "$nonstop" ; then
+    case $MAX_FD in #(
+      max*)
+        MAX_FD=$( ulimit -H -n ) ||
+            warn "Could not query maximum file descriptor limit"
+    esac
+    case $MAX_FD in  #(
+      '' | soft) :;; #(
+      *)
+        ulimit -n "$MAX_FD" ||
+            warn "Could not set maximum file descriptor limit to $MAX_FD"
+    esac
+fi
+
+# Collect all arguments for the java command, stacking in reverse order:
+#   * args from the command line
+#   * the main class name
+#   * -classpath
+#   * -D...appname settings
+#   * --module-path (only if needed)
+#   * DEFAULT_JVM_OPTS, JAVA_OPTS, and GRADLE_OPTS environment variables.
+
+# For Cygwin or MSYS, switch paths to Windows format before running java
+if "$cygwin" || "$msys" ; then
+    APP_HOME=$( cygpath --path --mixed "$APP_HOME" )
+    CLASSPATH=$( cygpath --path --mixed "$CLASSPATH" )
+
+    JAVACMD=$( cygpath --unix "$JAVACMD" )
+
+    # Now convert the arguments - kludge to limit ourselves to /bin/sh
+    for arg do
+        if
+            case $arg in                                #(
+              -*)   false ;;                            # don't mess with options #(
+              /?*)  t=${arg#/} t=/${t%%/*}              # looks like a POSIX filepath
+                    [ -e "$t" ] ;;                      #(
+              *)    false ;;
+            esac
+        then
+            arg=$( cygpath --path --ignore --mixed "$arg" )
+        fi
+        # Roll the args list around exactly as many times as the number of
+        # args, so each arg winds up back in the position where it started, but
+        # possibly modified.
+        #
+        # NB: a `for` loop captures its iteration list before it begins, so
+        # changing the positional parameters here affects neither the number of
+        # iterations, nor the values presented in `arg`.
+        shift                   # remove old arg
+        set -- "$@" "$arg"      # push replacement arg
+    done
+fi
+
+# Collect all arguments for the java command;
+#   * $DEFAULT_JVM_OPTS, $JAVA_OPTS, and $GRADLE_OPTS can contain fragments of
+#     shell script including quotes and variable substitutions, so put them in
+#     double quotes to make sure that they get re-expanded; and
+#   * put everything else in single quotes, so that it's not re-expanded.
+
+set -- \
+        "-Dorg.gradle.appname=$APP_BASE_NAME" \
+        -classpath "$CLASSPATH" \
+        org.gradle.wrapper.GradleWrapperMain \
+        "$@"
+
+# Use "xargs" to parse quoted args.
+#
+# With -n1 it outputs one arg per line, with the quotes and backslashes removed.
+#
+# In Bash we could simply go:
+#
+#   readarray ARGS < <( xargs -n1 <<<"$var" ) &&
+#   set -- "${ARGS[@]}" "$@"
+#
+# but POSIX shell has neither arrays nor command substitution, so instead we
+# post-process each arg (as a line of input to sed) to backslash-escape any
+# character that might be a shell metacharacter, then use eval to reverse
+# that process (while maintaining the separation between arguments), and wrap
+# the whole thing up as a single "set" statement.
+#
+# This will of course break if any of these variables contains a newline or
+# an unmatched quote.
+#
+
+eval "set -- $(
+        printf '%s\n' "$DEFAULT_JVM_OPTS $JAVA_OPTS $GRADLE_OPTS" |
+        xargs -n1 |
+        sed ' s~[^-[:alnum:]+,./:=@_]~\\&~g; ' |
+        tr '\n' ' '
+    )" '"$@"'
+
+exec "$JAVACMD" "$@"

gradlew.bat

@@ -0,0 +1,89 @@
+@rem
+@rem Copyright 2015 the original author or authors.
+@rem
+@rem Licensed under the Apache License, Version 2.0 (the "License");
+@rem you may not use this file except in compliance with the License.
+@rem You may obtain a copy of the License at
+@rem
+@rem      https://www.apache.org/licenses/LICENSE-2.0
+@rem
+@rem Unless required by applicable law or agreed to in writing, software
+@rem distributed under the License is distributed on an "AS IS" BASIS,
+@rem WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+@rem See the License for the specific language governing permissions and
+@rem limitations under the License.
+@rem
+
+@if "%DEBUG%" == "" @echo off
+@rem ##########################################################################
+@rem
+@rem  Gradle startup script for Windows
+@rem
+@rem ##########################################################################
+
+@rem Set local scope for the variables with windows NT shell
+if "%OS%"=="Windows_NT" setlocal
+
+set DIRNAME=%~dp0
+if "%DIRNAME%" == "" set DIRNAME=.
+set APP_BASE_NAME=%~n0
+set APP_HOME=%DIRNAME%
+
+@rem Resolve any "." and ".." in APP_HOME to make it shorter.
+for %%i in ("%APP_HOME%") do set APP_HOME=%%~fi
+
+@rem Add default JVM options here. You can also use JAVA_OPTS and GRADLE_OPTS to pass JVM options to this script.
+set DEFAULT_JVM_OPTS="-Xmx64m" "-Xms64m"
+
+@rem Find java.exe
+if defined JAVA_HOME goto findJavaFromJavaHome
+
+set JAVA_EXE=java.exe
+%JAVA_EXE% -version >NUL 2>&1
+if "%ERRORLEVEL%" == "0" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is not set and no 'java' command could be found in your PATH.
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:findJavaFromJavaHome
+set JAVA_HOME=%JAVA_HOME:"=%
+set JAVA_EXE=%JAVA_HOME%/bin/java.exe
+
+if exist "%JAVA_EXE%" goto execute
+
+echo.
+echo ERROR: JAVA_HOME is set to an invalid directory: %JAVA_HOME%
+echo.
+echo Please set the JAVA_HOME variable in your environment to match the
+echo location of your Java installation.
+
+goto fail
+
+:execute
+@rem Setup the command line
+
+set CLASSPATH=%APP_HOME%\gradle\wrapper\gradle-wrapper.jar
+
+
+@rem Execute Gradle
+"%JAVA_EXE%" %DEFAULT_JVM_OPTS% %JAVA_OPTS% %GRADLE_OPTS% "-Dorg.gradle.appname=%APP_BASE_NAME%" -classpath "%CLASSPATH%" org.gradle.wrapper.GradleWrapperMain %*
+
+:end
+@rem End local scope for the variables with windows NT shell
+if "%ERRORLEVEL%"=="0" goto mainEnd
+
+:fail
+rem Set variable GRADLE_EXIT_CONSOLE if you need the _script_ return code instead of
+rem the _cmd.exe /c_ return code!
+if  not "" == "%GRADLE_EXIT_CONSOLE%" exit 1
+exit /b 1
+
+:mainEnd
+if "%OS%"=="Windows_NT" endlocal
+
+:omega

readme.md

@@ -0,0 +1,9 @@
+### Nightbloom4j
+
+***
+
+A java library to interact with our Snapshots platform, [Nightbloom](https://nightbloom.cc)
+
+***
+
+License: MIT

settings.gradle

@@ -0,0 +1,2 @@
+rootProject.name = 'nightbloom4j'
+

src/main/java/com/hypherionmc/nightbloom/NightBloom4J.java

@@ -0,0 +1,50 @@
+package com.hypherionmc.nightbloom;
+
+import com.hypherionmc.nightbloom.client.HttpClient;
+import com.hypherionmc.nightbloom.client.agent.UserAgent;
+import com.hypherionmc.nightbloom.client.requests.ProjectsEndpoint;
+import com.hypherionmc.nightbloom.client.versions.V1HttpClient;
+import lombok.AccessLevel;
+import lombok.Getter;
+import lombok.NonNull;
+import lombok.RequiredArgsConstructor;
+import org.jetbrains.annotations.NotNull;
+
+/**
+ * @author HypherionSA
+ * Main API Client Class
+ */
+@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+public class NightBloom4J {
+
+    @NonNull @Getter
+    private HttpClient client;
+
+    /**
+     * Create a new V1 api Client
+     * @param agent The constructed {@link UserAgent} to use for API Requests
+     * @return A V1 api Client
+     */
+    public static NightBloom4J v1(@NotNull UserAgent agent) {
+        return v1(agent, "");
+    }
+
+    /**
+     * Create a new V1 api Client with uploads enabled
+     * @param agent The constructed {@link UserAgent} to use for API Requests
+     * @param apiKey The API key to use for uploads
+     * @return A V1 api Client with uploads enabled
+     */
+    public static NightBloom4J v1(@NotNull UserAgent agent, String apiKey) {
+        HttpClient httpClient = new V1HttpClient(agent, apiKey);
+        return new NightBloom4J(httpClient);
+    }
+
+    /**
+     * API Endpoints for interacting with Projects
+     * @return A {@link ProjectsEndpoint} endpoint client for executing project requests
+     */
+    public ProjectsEndpoint projects() {
+        return new ProjectsEndpoint(this);
+    }
+}

src/main/java/com/hypherionmc/nightbloom/client/HttpClient.java

@@ -0,0 +1,140 @@
+package com.hypherionmc.nightbloom.client;
+
+import com.google.gson.Gson;
+import com.google.gson.JsonObject;
+import com.hypherionmc.nightbloom.client.agent.UserAgent;
+import com.hypherionmc.nightbloom.model.ProjectMeta;
+import com.hypherionmc.nightbloom.model.StandardResponse;
+import okhttp3.*;
+
+import java.io.File;
+import java.io.IOException;
+
+/**
+ * @author HypherionSA
+ * HTTP Client Wrapper with simple Post and Get Methods
+ */
+public abstract class HttpClient {
+
+    // Private variables, mostly for internal use
+    private final String API_BASE = "https://api.nightbloom.cc";
+
+    private final String baseUrl;
+    private final UserAgent agent;
+    private final String apiKey;
+    private final OkHttpClient client;
+
+    private final Gson gson = new Gson();
+
+    /**
+     * Create a new HTTP Client Instance
+     * @param agent Constructed {@link UserAgent} to be added to Request Headers
+     * @param version The API version to use. For example 1, 2, 3 etc
+     * @param apiKey Optional API key. Required for POST methods
+     */
+    public HttpClient(UserAgent agent, String version, String apiKey) {
+        this.agent = agent;
+        this.baseUrl = API_BASE + "/v" + version;
+        this.apiKey = apiKey;
+        this.client = new OkHttpClient();
+    }
+
+    /**
+     * Build a new GET request
+     * @param endPoint The endpoint the request will be executed on
+     * @return The constructed Request
+     */
+    private Request buildRequest(String endPoint) {
+        return new Request.Builder()
+                .url(baseUrl + "/" + endPoint)
+                .addHeader("User-Agent", agent.toString())
+                .build();
+    }
+
+    /**
+     * Build a new POST request
+     * @param endpoint The endpoint the request will be executed on
+     * @param body The Request Body that will be sent to the executed request
+     * @return The constructed Request
+     */
+    private Request buildRequest(String endpoint, RequestBody body) {
+        return new Request.Builder()
+                .url(baseUrl + "/" + endpoint)
+                .post(body)
+                .header("access-key", this.apiKey)
+                .build();
+    }
+
+    /**
+     * Execute a GET request
+     * @param endpoint The endpoint to execute the request on
+     * @param returnType The Java Class (Model) that the request data will be returned as
+     * @return The Java Class (Model) that the request data will be returned as
+     * @param <T> The Java Class (Model) that the request data will be returned as
+     * @throws IOException Thrown when an API error occurs
+     */
+    public <T> T get(String endpoint, Class<T> returnType) throws IOException {
+        try (Response response = client.newCall(buildRequest(endpoint)).execute()) {
+            if (!response.isSuccessful()) {
+                throw new IOException("Unexpected code " + response);
+            }
+
+            ResponseBody body = response.body();
+            if (body != null) {
+                StandardResponse responseType = gson.fromJson(body.charStream(), StandardResponse.class);
+
+                if (responseType.isError()) {
+                    throw new IOException(responseType.getMessage());
+                }
+
+                return responseType.getDataAs(returnType);
+            } else {
+                throw new IOException("Response body is null");
+            }
+        }
+    }
+
+    /**
+     * Execute a POST request
+     * @param endpoint The endpoint to execute the request on
+     * @param data The JSON data that will be sent to the request
+     * @param f The file to be uploaded
+     * @return A {@link StandardResponse} as sent by the API
+     * @throws IOException Thrown when an API error occurs
+     */
+    public StandardResponse post(String endpoint, ProjectMeta data, File f) throws IOException {
+        if (this.apiKey == null || this.apiKey.isEmpty()) {
+            throw new IOException("apiKey not set");
+        }
+
+        JsonObject bodyObject = new JsonObject();
+        bodyObject.addProperty("version", data.getVersion());
+        bodyObject.addProperty("loader", String.join("|", data.getModloaders()));
+        bodyObject.addProperty("minecraft", String.join("|", data.getMinecraftVersions()));
+        bodyObject.addProperty("changelog", data.getChangelog());
+
+        RequestBody requestBody = new MultipartBody.Builder()
+                .setType(MultipartBody.FORM)
+                .addFormDataPart("meta", null, RequestBody.create(new Gson().toJson(bodyObject), MediaType.parse("application/json")))
+                .addFormDataPart("uploadfile", f.getName(), RequestBody.create(f, MediaType.parse("application/java-archive")))
+                .build();
+
+        try (Response response = client.newCall(buildRequest(endpoint, requestBody)).execute()) {
+            if (!response.isSuccessful()) {
+                throw new IOException("Unexpected code " + response);
+            }
+
+            ResponseBody body = response.body();
+            if (body != null) {
+                StandardResponse responseType = gson.fromJson(body.charStream(), StandardResponse.class);
+
+                if (responseType.isError()) {
+                    throw new IOException(responseType.getMessage());
+                }
+                return responseType;
+            } else {
+                throw new IOException("Response body is null");
+            }
+        }
+    }
+}

src/main/java/com/hypherionmc/nightbloom/client/agent/UserAgent.java

@@ -0,0 +1,52 @@
+package com.hypherionmc.nightbloom.client.agent;
+
+import lombok.Builder;
+
+/**
+ * @author HypherionSA
+ * User Agent constructor helper.
+ * Based on https://github.com/masecla22/Modrinth4J/blob/master/src/main/java/masecla/modrinth4j/client/agent/UserAgent.java
+ */
+@Builder
+public class UserAgent {
+
+    // User Agent variables
+    private String projectName;
+    private String authorName;
+    private String projectVersion;
+    private String contact;
+
+    /**
+     * Override the toString method to return the constructed User Agent string
+     * @return The User Agent String to be added as a header
+     */
+    @Override
+    public String toString() {
+        if (projectName == null && authorName == null && contact == null)
+            return "Nightbloom4j / No User Agent";
+
+        StringBuilder result = new StringBuilder();
+
+        if (projectName != null) {
+            if (authorName != null) {
+                result.append(authorName).append("/").append(projectName);
+            } else {
+                result.append(projectName);
+            }
+        } else {
+            if (authorName != null) {
+                result.append(authorName);
+            }
+        }
+
+        if (projectVersion != null) {
+            result.append("/").append(projectVersion);
+        }
+
+        if (contact != null) {
+            result.append(" (").append(contact).append(")");
+        }
+
+        return result.toString().trim();
+    }
+}

src/main/java/com/hypherionmc/nightbloom/client/requests/ProjectsEndpoint.java

@@ -0,0 +1,86 @@
+package com.hypherionmc.nightbloom.client.requests;
+
+import com.hypherionmc.nightbloom.NightBloom4J;
+import com.hypherionmc.nightbloom.client.HttpClient;
+import com.hypherionmc.nightbloom.model.ProjectFile;
+import com.hypherionmc.nightbloom.model.ProjectMeta;
+import com.hypherionmc.nightbloom.model.ProjectResponse;
+import com.hypherionmc.nightbloom.model.StandardResponse;
+import lombok.RequiredArgsConstructor;
+
+import java.io.File;
+import java.io.IOException;
+import java.util.Arrays;
+import java.util.List;
+import java.util.stream.Collectors;
+
+/**
+ * @author HypherionSA
+ * An Endpoint Client to interact with the /projects api endpoint
+ */
+@RequiredArgsConstructor
+public class ProjectsEndpoint {
+
+    private final NightBloom4J bloom4J;
+
+    /**
+     * Get a list of all Project listed on Nightbloom
+     * @return A List of Projects from the Platform
+     * @throws IOException Thrown when an API error occurs
+     */
+    public List<ProjectResponse> getAll() throws IOException {
+        HttpClient client = bloom4J.getClient();
+        return Arrays.stream(client.get("projects", ProjectResponse[].class)).collect(Collectors.toList());
+    }
+
+    /**
+     * Get a single project listed on Nightbloom
+     * @param slug The project slug. For example 'craterlib'
+     * @return A single project from the Platform
+     * @throws IOException Thrown when an API error occurs
+     */
+    public ProjectResponse get(String slug) throws IOException {
+        HttpClient client = bloom4J.getClient();
+        return client.get("projects/" + slug, ProjectResponse.class);
+    }
+
+    /**
+     * Get all files for a single project
+     * @param slug The project slug. For example 'craterlib'
+     * @return A list of files uploaded to the project
+     * @throws IOException Thrown when an API error occurs
+     */
+    public List<ProjectFile> getFiles(String slug) throws IOException {
+        HttpClient client = bloom4J.getClient();
+        return Arrays.stream(client.get("projects/" + slug + "/files", ProjectFile[].class)).collect(Collectors.toList());
+    }
+
+    /**
+     * Get a single file from a project
+     * @param slug The project slug. For example 'craterlib'
+     * @param fileId The file ID. For example, 46
+     * @return The single file from the project
+     * @throws IOException Thrown when an API error occurs
+     */
+    public ProjectFile getFile(String slug, int fileId) throws IOException {
+        HttpClient client = bloom4J.getClient();
+        return client.get("projects/" + slug + "/files/" + fileId, ProjectFile.class);
+    }
+
+    /**
+     * Upload a file to a project. Requires an API Key
+     * @param slug The project slug to add the files to
+     * @param meta The file metadata
+     * @param file The file
+     * @return The result of the upload
+     * @throws IOException Thrown when an API error occurs
+     */
+    public StandardResponse uploadFile(String slug, ProjectMeta meta, File file) throws IOException {
+        if (!file.getName().endsWith(".jar")) {
+            throw new IOException("You can only upload JAR files to projects");
+        }
+
+        HttpClient client = bloom4J.getClient();
+        return client.post("projects/" + slug + "/files", meta, file);
+    }
+}

src/main/java/com/hypherionmc/nightbloom/client/versions/V1HttpClient.java

@@ -0,0 +1,21 @@
+package com.hypherionmc.nightbloom.client.versions;
+
+import com.hypherionmc.nightbloom.NightBloom4J;
+import com.hypherionmc.nightbloom.client.HttpClient;
+import com.hypherionmc.nightbloom.client.agent.UserAgent;
+
+/**
+ * @author HypherionSA
+ * Helper class to construct a V1 API endpoint client
+ */
+public class V1HttpClient extends HttpClient {
+
+    /**
+     * Create a new V1 API Client. This shouldn't be called directly. Use {@link NightBloom4J#v1(UserAgent)} instead
+     * @param agent The constructed {@link UserAgent} to use for the requests
+     * @param apiKey Optional API key. Required for file uploads
+     */
+    public V1HttpClient(UserAgent agent, String apiKey) {
+        super(agent, "1", apiKey);
+    }
+}

src/main/java/com/hypherionmc/nightbloom/model/FileSummary.java

@@ -0,0 +1,25 @@
+package com.hypherionmc.nightbloom.model;
+
+import lombok.Getter;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @author HypherionSA
+ */
+@Getter
+public class FileSummary {
+
+    private int id;
+    private List<String> modLoaders;
+    private List<String> minecraftVersions;
+    private int downloads;
+    private String version;
+    private int filesize;
+    private String filename;
+    private String downloadUrl;
+    private Date createdAt;
+    private Date updatedAt;
+
+}

src/main/java/com/hypherionmc/nightbloom/model/ProjectFile.java

@@ -0,0 +1,24 @@
+package com.hypherionmc.nightbloom.model;
+
+import lombok.Getter;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @author HypherionSA
+ */
+@Getter
+public class ProjectFile {
+    private int id;
+    private List<String> modLoaders;
+    private List<String> minecraftVersions;
+    private int downloads;
+    private String version;
+    private String changelog;
+    private int filesize;
+    private String filename;
+    private String downloadUrl;
+    private Date createdAt;
+    private Date updatedAt;
+}

src/main/java/com/hypherionmc/nightbloom/model/ProjectLinks.java

@@ -0,0 +1,18 @@
+package com.hypherionmc.nightbloom.model;
+
+import lombok.Getter;
+
+/**
+ * @author HypherionSA
+ */
+@Getter
+public class ProjectLinks {
+
+    private String websiteUrl;
+    private String wikiUrl;
+    private String issuesUrl;
+    private String sourceUrl;
+    private String modrinthUrl;
+    private String curseforgeUrl;
+
+}

src/main/java/com/hypherionmc/nightbloom/model/ProjectMeta.java

@@ -0,0 +1,30 @@
+package com.hypherionmc.nightbloom.model;
+
+import lombok.Builder;
+import lombok.Getter;
+
+import java.util.ArrayList;
+import java.util.List;
+
+/**
+ * @author HypherionSA
+ */
+@Builder
+@Getter
+public class ProjectMeta {
+
+    private final String version;
+    private final List<String> modloaders = new ArrayList<>();
+    private final List<String> minecraftVersions = new ArrayList<>();
+    private final String changelog;
+
+    public void addModloader(String loader) {
+        if (!modloaders.contains(loader))
+            this.modloaders.add(loader);
+    }
+
+    public void addMinecraft(String mc) {
+        if (!minecraftVersions.contains(mc))
+            minecraftVersions.add(mc);
+    }
+}

src/main/java/com/hypherionmc/nightbloom/model/ProjectResponse.java

@@ -0,0 +1,25 @@
+package com.hypherionmc.nightbloom.model;
+
+import lombok.Getter;
+
+import java.util.Date;
+import java.util.List;
+
+/**
+ * @author HypherionSA
+ */
+@Getter
+public class ProjectResponse {
+
+    private int id;
+    private String name;
+    private String slug;
+    private String description;
+    private String logo;
+    private ProjectLinks links;
+    private int downloads;
+    private List<FileSummary> files;
+    private Date createdAt;
+    private Date updatedAt;
+
+}

src/main/java/com/hypherionmc/nightbloom/model/StandardResponse.java

@@ -0,0 +1,27 @@
+package com.hypherionmc.nightbloom.model;
+
+import com.google.gson.Gson;
+import lombok.Getter;
+
+/**
+ * @author HypherionSA
+ */
+@Getter
+public class StandardResponse {
+
+    private boolean error;
+    private String message;
+    private Object data;
+
+    /**
+     * Cast the data variable into a Java Class representing the data returned
+     * @param clazz The class to cast to
+     * @return The class to cast to
+     * @param <T> The class to cast to
+     */
+    public <T> T getDataAs(Class<T> clazz) {
+        Gson gson = new Gson();
+        String jsonData = gson.toJson(data);
+        return gson.fromJson(jsonData, clazz);
+    }
+}