loops-java-sdk
Used in:
components
- OverviewOverview
- VersionsVersions
- DependentsDependents
- DependenciesDependencies
<dependency>
<groupId>io.github.telos-tech</groupId>
<artifactId>loops-java-sdk</artifactId>
<version>1.0.0</version>
</dependency><project xmlns="http://maven.apache.org/POM/4.0.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd">
<modelVersion>4.0.0</modelVersion>
<groupId>io.github.telos-tech</groupId>
<artifactId>loops-java-sdk</artifactId>
<version>1.0.0</version>
<packaging>jar</packaging>
<name>Loops Java SDK</name>
<description>Java SDK for Loops.so</description>
<url>https://github.com/telos-tech/loops-java-sdk</url>
<licenses>
<license>
<name>MIT License</name>
<url>https://opensource.org/licenses/MIT</url>
<distribution>repo</distribution>
</license>
</licenses>
<developers>
<developer>
<id>telos</id>
<name>Telos Technologies</name>
<email>admin@telos-technologies.com</email>
</developer>
</developers>
<scm>
<connection>scm:git:git://github.com/telos-tech/loops-java-sdk.git</connection>
<developerConnection>scm:git:ssh://github.com:telos-tech/loops-java-sdk.git</developerConnection>
<url>https://github.com/telos-tech/loops-java-sdk/tree/main</url>
</scm>
<properties>
<java.version>21</java.version>
<maven.compiler.release>21</maven.compiler.release>
<project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
<!-- Dependencies -->
<okhttp.version>4.12.0</okhttp.version>
<jackson.version>2.21.0</jackson.version>
<slf4j.version>2.1.0-alpha1</slf4j.version>
<!-- OpenAPI Generator -->
<openapi.generator.version>7.6.0</openapi.generator.version>
<!-- Testing -->
<junit.version>5.10.2</junit.version>
<assertj.version>3.27.7</assertj.version>
<mockito.version>5.11.0</mockito.version>
<wiremock.version>3.13.2</wiremock.version>
<awaitility.version>4.2.0</awaitility.version>
<!-- Tools -->
<spotbugs.version>4.9.8</spotbugs.version>
<spotbugs.plugin.version>4.9.8.2</spotbugs.plugin.version>
<spotless.version>2.43.0</spotless.version>
<jacoco.version>0.8.11</jacoco.version>
<dependency-check.version>12.2.0</dependency-check.version>
<cyclonedx.version>2.7.11</cyclonedx.version>
</properties>
<dependencies>
<!-- OkHttp (HTTP client) -->
<dependency>
<groupId>com.squareup.okhttp3</groupId>
<artifactId>okhttp</artifactId>
<version>${okhttp.version}</version>
</dependency>
<!-- Jackson (JSON) -->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>${jackson.version}</version>
</dependency>
<!-- Jakarta (Validation) -->
<dependency>
<groupId>jakarta.annotation</groupId>
<artifactId>jakarta.annotation-api</artifactId>
<version>3.0.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.datatype</groupId>
<artifactId>jackson-datatype-jsr310</artifactId>
<version>2.21.0</version>
</dependency>
<dependency>
<groupId>org.openapitools</groupId>
<artifactId>jackson-databind-nullable</artifactId>
<version>0.2.9</version>
</dependency>
<!-- SLF4J (Logging) -->
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-api</artifactId>
<version>${slf4j.version}</version>
</dependency>
<!-- Tests -->
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.junit.jupiter</groupId>
<artifactId>junit-jupiter-params</artifactId>
<version>${junit.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.assertj</groupId>
<artifactId>assertj-core</artifactId>
<version>${assertj.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-core</artifactId>
<version>${mockito.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.mockito</groupId>
<artifactId>mockito-junit-jupiter</artifactId>
<version>${mockito.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.wiremock</groupId>
<artifactId>wiremock</artifactId>
<version>${wiremock.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.awaitility</groupId>
<artifactId>awaitility</artifactId>
<version>${awaitility.version}</version>
<scope>test</scope>
</dependency>
<dependency>
<groupId>org.slf4j</groupId>
<artifactId>slf4j-simple</artifactId>
<version>${slf4j.version}</version>
<scope>test</scope>
</dependency>
</dependencies>
<!-- ===================== -->
<!-- Build -->
<!-- ===================== -->
<build>
<plugins>
<!-- Compiler -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-compiler-plugin</artifactId>
<version>3.13.0</version>
<configuration>
<release>${java.version}</release>
</configuration>
</plugin>
<!-- OpenAPI Generator -->
<plugin>
<groupId>org.openapitools</groupId>
<artifactId>openapi-generator-maven-plugin</artifactId>
<version>${openapi.generator.version}</version>
<executions>
<execution>
<id>generate-openapi-sources</id>
<phase>generate-sources</phase>
<goals>
<goal>generate</goal>
</goals>
<configuration>
<!-- Input spec -->
<inputSpec>${project.basedir}/openapi/openapi.yaml</inputSpec>
<!-- Generator -->
<generatorName>java</generatorName>
<library>native</library>
<!-- Where generated code goes -->
<output>${project.build.directory}/generated-sources/openapi</output>
<!-- Package structure -->
<apiPackage>com.telos.loops.internal.openapi.api</apiPackage>
<modelPackage>com.telos.loops.internal.openapi.model</modelPackage>
<invokerPackage>com.telos.loops.internal.openapi.invoker</invokerPackage>
<!-- Keep it minimal -->
<generateApiTests>false</generateApiTests>
<generateModelTests>false</generateModelTests>
<generateApiDocumentation>false</generateApiDocumentation>
<generateModelDocumentation>false</generateModelDocumentation>
<!-- Java options -->
<configOptions>
<serializationLibrary>jackson</serializationLibrary>
<dateLibrary>java8</dateLibrary>
<useJakartaEe>true</useJakartaEe>
<hideGenerationTimestamp>true</hideGenerationTimestamp>
</configOptions>
</configuration>
</execution>
</executions>
</plugin>
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>build-helper-maven-plugin</artifactId>
<version>3.6.1</version>
<executions>
<execution>
<id>add-openapi-generated-sources</id>
<phase>generate-sources</phase>
<goals>
<goal>add-source</goal>
</goals>
<configuration>
<sources>
<source>${project.build.directory}/generated-sources/openapi/src/main/java</source>
</sources>
</configuration>
</execution>
</executions>
</plugin>
<!-- Surefire (unit tests) -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-surefire-plugin</artifactId>
<version>3.2.5</version>
<configuration>
<useModulePath>false</useModulePath>
</configuration>
</plugin>
<!-- Failsafe (integration tests) -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-failsafe-plugin</artifactId>
<version>3.2.5</version>
<executions>
<execution>
<goals>
<goal>integration-test</goal>
<goal>verify</goal>
</goals>
</execution>
</executions>
</plugin>
<!-- JaCoCo (code coverage) -->
<plugin>
<groupId>org.jacoco</groupId>
<artifactId>jacoco-maven-plugin</artifactId>
<version>${jacoco.version}</version>
<executions>
<execution>
<id>prepare-agent</id>
<goals>
<goal>prepare-agent</goal>
</goals>
</execution>
<execution>
<id>report</id>
<phase>verify</phase>
<goals>
<goal>report</goal>
</goals>
</execution>
<execution>
<id>check</id>
<goals>
<goal>check</goal>
</goals>
<configuration>
<rules>
<rule>
<element>BUNDLE</element>
<limits>
<limit>
<counter>LINE</counter>
<value>COVEREDRATIO</value>
<minimum>0.70</minimum>
</limit>
</limits>
</rule>
</rules>
</configuration>
</execution>
</executions>
<configuration>
<excludes>
<!-- Exclude OpenAPI generated code -->
<exclude>com/telos/loops/internal/openapi/**</exclude>
</excludes>
</configuration>
</plugin>
<!-- Maven Enforcer (dependency and build requirements) -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-enforcer-plugin</artifactId>
<version>3.4.1</version>
<executions>
<execution>
<id>enforce-maven</id>
<goals>
<goal>enforce</goal>
</goals>
<configuration>
<rules>
<requireMavenVersion>
<version>3.8.0</version>
</requireMavenVersion>
<requireJavaVersion>
<version>21</version>
</requireJavaVersion>
</rules>
</configuration>
</execution>
</executions>
</plugin>
<!-- Versions (dependency updates check) -->
<plugin>
<groupId>org.codehaus.mojo</groupId>
<artifactId>versions-maven-plugin</artifactId>
<version>2.16.2</version>
<configuration>
<generateBackupPoms>false</generateBackupPoms>
</configuration>
</plugin>
<!-- CycloneDX (SBOM generation) -->
<plugin>
<groupId>org.cyclonedx</groupId>
<artifactId>cyclonedx-maven-plugin</artifactId>
<version>${cyclonedx.version}</version>
<executions>
<execution>
<phase>package</phase>
<goals>
<goal>makeAggregateBom</goal>
</goals>
</execution>
</executions>
<configuration>
<outputFormat>all</outputFormat>
<outputName>bom</outputName>
</configuration>
</plugin>
<!-- Code Formatting (Spotless) -->
<plugin>
<groupId>com.diffplug.spotless</groupId>
<artifactId>spotless-maven-plugin</artifactId>
<version>${spotless.version}</version>
<configuration>
<java>
<googleJavaFormat>
<version>1.28.0</version>
<style>GOOGLE</style>
</googleJavaFormat>
<!-- Java-specific steps -->
<removeUnusedImports/>
<!-- Only format handwritten sources (do NOT touch target/) -->
<includes>
<include>src/main/java/**/*.java</include>
<include>src/test/java/**/*.java</include>
</includes>
</java>
<!-- Generic whitespace fixes for the same sources -->
<formats>
<format>
<includes>
<include>src/main/java/**/*.java</include>
<include>src/test/java/**/*.java</include>
</includes>
<trimTrailingWhitespace/>
<endWithNewline/>
</format>
</formats>
</configuration>
<executions>
<!-- Fail build if formatting drifts -->
<execution>
<id>spotless-check</id>
<phase>verify</phase>
<goals>
<goal>check</goal>
</goals>
</execution>
</executions>
</plugin>
<!-- Static Analysis (SpotBugs) -->
<plugin>
<groupId>com.github.spotbugs</groupId>
<artifactId>spotbugs-maven-plugin</artifactId>
<version>${spotbugs.plugin.version}</version>
<dependencies>
<dependency>
<groupId>com.github.spotbugs</groupId>
<artifactId>spotbugs</artifactId>
<version>${spotbugs.version}</version>
</dependency>
</dependencies>
<configuration>
<effort>Max</effort>
<threshold>High</threshold>
<xmlOutput>true</xmlOutput>
<excludeFilterFile>${project.basedir}/spotbugs-exclude.xml</excludeFilterFile>
</configuration>
<executions>
<execution>
<goals>
<goal>check</goal>
</goals>
</execution>
</executions>
</plugin>
<!-- SonarQube (on-demand; do not bind to lifecycle) -->
<plugin>
<groupId>org.sonarsource.scanner.maven</groupId>
<artifactId>sonar-maven-plugin</artifactId>
<version>3.10.0.2594</version>
</plugin>
<!-- Javadoc -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-javadoc-plugin</artifactId>
<version>3.6.3</version>
<executions>
<!-- Standard JavaDoc JAR for releases -->
<execution>
<id>attach-javadocs</id>
<goals>
<goal>jar</goal>
</goals>
</execution>
</executions>
<configuration>
<doclint>none</doclint>
<!-- Exclude internal packages from public Javadoc -->
<excludePackageNames>com.telos.loops.internal:com.telos.loops.internal.*</excludePackageNames>
<!-- Show only public APIs -->
<show>public</show>
<!-- Link to Java 21 standard library docs -->
<links>
<link>https://docs.oracle.com/en/java/javase/21/docs/api/</link>
</links>
<!-- Include source links in Javadoc pages -->
<linksource>true</linksource>
<!-- Stable output (no timestamp) -->
<notimestamp>true</notimestamp>
<!-- Titles and footer -->
<windowtitle>Loops Java SDK ${project.version} API</windowtitle>
<doctitle>Loops Java SDK ${project.version}</doctitle>
<bottom>
<![CDATA[Copyright © 2026 Telos Technologies. Licensed under the <a href="https://opensource.org/licenses/MIT">MIT License</a>.]]>
</bottom>
<!-- Group packages for better nav organization -->
<groups>
<group>
<title>Core Client</title>
<packages>com.telos.loops</packages>
</group>
<group>
<title>API Clients</title>
<packages>
com.telos.loops.contacts:com.telos.loops.events:com.telos.loops.transactional:com.telos.loops.lists:com.telos.loops.properties:com.telos.loops.ips:com.telos.loops.apikey
</packages>
</group>
<group>
<title>Models</title>
<packages>com.telos.loops.model</packages>
</group>
<group>
<title>Error Handling</title>
<packages>com.telos.loops.error</packages>
</group>
<group>
<title>Transport</title>
<packages>com.telos.loops.transport</packages>
</group>
</groups>
</configuration>
</plugin>
<!-- Source -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-source-plugin</artifactId>
<version>3.3.0</version>
<executions>
<execution>
<id>attach-sources</id>
<goals>
<goal>jar-no-fork</goal>
</goals>
</execution>
</executions>
</plugin>
<!-- Git build hooks (pre-commit) -->
<plugin>
<groupId>com.rudikershaw.gitbuildhook</groupId>
<artifactId>git-build-hook-maven-plugin</artifactId>
<version>3.1.0</version>
<configuration>
<installHooks>
<pre-commit>hooks/pre-commit</pre-commit>
</installHooks>
</configuration>
<executions>
<execution>
<goals>
<goal>install</goal>
</goals>
</execution>
</executions>
</plugin>
</plugins>
</build>
<!-- ===================== -->
<!-- Profiles -->
<!-- ===================== -->
<profiles>
<!-- Release profile for Maven Central deployment -->
<profile>
<id>release</id>
<build>
<plugins>
<!-- GPG Signing -->
<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-gpg-plugin</artifactId>
<version>3.2.7</version>
<executions>
<execution>
<id>sign-artifacts</id>
<phase>verify</phase>
<goals>
<goal>sign</goal>
</goals>
<configuration>
<gpgArguments>
<arg>--pinentry-mode</arg>
<arg>loopback</arg>
</gpgArguments>
</configuration>
</execution>
</executions>
</plugin>
<!-- Maven Central deployment -->
<plugin>
<groupId>org.sonatype.central</groupId>
<artifactId>central-publishing-maven-plugin</artifactId>
<version>0.10.0</version>
<extensions>true</extensions>
<configuration>
<publishingServerId>central</publishingServerId>
<waitForPublishCompletion>true</waitForPublishCompletion>
</configuration>
</plugin>
</plugins>
</build>
</profile>
<!-- Security profile for dependency vulnerability scanning -->
<profile>
<id>security</id>
<build>
<plugins>
<!-- OWASP Dependency Check -->
<plugin>
<groupId>org.owasp</groupId>
<artifactId>dependency-check-maven</artifactId>
<version>${dependency-check.version}</version>
<executions>
<execution>
<goals>
<goal>check</goal>
</goals>
</execution>
</executions>
<configuration>
<failBuildOnCVSS>7.0</failBuildOnCVSS>
<formats>
<format>HTML</format>
<format>JSON</format>
</formats>
</configuration>
</plugin>
</plugins>
</build>
</profile>
</profiles>
</project>