dbeaver/pro#11220 datadam refactor tracking service (#18)

* dbeaver/pro#11220: moved server-side impl

* dbeaver/pro#11220: fix tracking times

Author: SolovevAnton

apis/com.dbeaver.datadam.share.api/META-INF/MANIFEST.MF

@@ -7,7 +7,8 @@ Bundle-Version: 0.0.17.qualifier
 Bundle-RequiredExecutionEnvironment: JavaSE-21
 Export-Package: com.dbeaver.datadam.share.api.exception,
  com.dbeaver.datadam.share.api.model,
- com.dbeaver.datadam.share.api.service,
+  com.dbeaver.datadam.share.api.service,
+  com.dbeaver.datadam.share.api.tracking,
  com.dbeaver.datadam.share.api.utils
 Bundle-ActivationPolicy: lazy
 Require-Bundle: org.jkiss.utils

apis/com.dbeaver.datadam.share.api/src/main/java/com/dbeaver/datadam/share/api/tracking/DDClientInfo.java

@@ -0,0 +1,32 @@
+/*
+ * DBeaver - Universal Database Manager
+ * Copyright (C) 2010-2026 DBeaver Corp
+ *
+ * All Rights Reserved.
+ *
+ * NOTICE:  All information contained herein is, and remains
+ * the property of DBeaver Corp and its suppliers, if any.
+ * The intellectual and technical concepts contained
+ * herein are proprietary to DBeaver Corp and its suppliers
+ * and may be covered by U.S. and Foreign Patents,
+ * patents in process, and are protected by trade secret or copyright law.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from DBeaver Corp.
+ */
+package com.dbeaver.datadam.share.api.tracking;
+
+import org.jkiss.code.NotNull;
+import org.jkiss.code.Nullable;
+
+public record DDClientInfo(
+    @NotNull String clientId,
+    @Nullable String workspaceId,
+    @Nullable String product,
+    @Nullable String version,
+    @Nullable String os,
+    @Nullable String osVersion,
+    @Nullable String macAddress,
+    @Nullable String ipAddress
+) {
+}

apis/com.dbeaver.datadam.share.api/src/main/java/com/dbeaver/datadam/share/api/tracking/DDTracking.java

@@ -0,0 +1,28 @@
+/*
+ * DBeaver - Universal Database Manager
+ * Copyright (C) 2010-2026 DBeaver Corp
+ *
+ * All Rights Reserved.
+ *
+ * NOTICE:  All information contained herein is, and remains
+ * the property of DBeaver Corp and its suppliers, if any.
+ * The intellectual and technical concepts contained
+ * herein are proprietary to DBeaver Corp and its suppliers
+ * and may be covered by U.S. and Foreign Patents,
+ * patents in process, and are protected by trade secret or copyright law.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from DBeaver Corp.
+ */
+package com.dbeaver.datadam.share.api.tracking;
+
+import org.jkiss.code.NotNull;
+import org.jkiss.code.Nullable;
+
+public record DDTracking(
+    @NotNull String trackingId,
+    boolean online,
+    @NotNull String startTime,
+    @Nullable String stopTime
+) {
+}

apis/com.dbeaver.datadam.share.api/src/main/java/com/dbeaver/datadam/share/api/tracking/DDTrackingEndpoints.java

@@ -0,0 +1,27 @@
+/*
+ * DBeaver - Universal Database Manager
+ * Copyright (C) 2010-2026 DBeaver Corp
+ *
+ * All Rights Reserved.
+ *
+ * NOTICE:  All information contained herein is, and remains
+ * the property of DBeaver Corp and its suppliers, if any.
+ * The intellectual and technical concepts contained
+ * herein are proprietary to DBeaver Corp and its suppliers
+ * and may be covered by U.S. and Foreign Patents,
+ * patents in process, and are protected by trade secret or copyright law.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from DBeaver Corp.
+ */
+package com.dbeaver.datadam.share.api.tracking;
+
+public final class DDTrackingEndpoints {
+    public static final String TRACKING = "/tracking/track";
+    public static final String METERING = "/metering/track";
+    public static final String START = "/start";
+    public static final String STOP = "/{trackingId}/stop";
+
+    private DDTrackingEndpoints() {
+    }
+}

apis/com.dbeaver.datadam.share.api/src/main/java/com/dbeaver/datadam/share/api/tracking/DDTrackingNotFoundException.java

@@ -0,0 +1,26 @@
+/*
+ * DBeaver - Universal Database Manager
+ * Copyright (C) 2010-2026 DBeaver Corp
+ *
+ * All Rights Reserved.
+ *
+ * NOTICE:  All information contained herein is, and remains
+ * the property of DBeaver Corp and its suppliers, if any.
+ * The intellectual and technical concepts contained
+ * herein are proprietary to DBeaver Corp and its suppliers
+ * and may be covered by U.S. and Foreign Patents,
+ * patents in process, and are protected by trade secret or copyright law.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from DBeaver Corp.
+ */
+package com.dbeaver.datadam.share.api.tracking;
+
+import org.jkiss.dbeaver.DBException;
+
+public class DDTrackingNotFoundException extends DBException {
+
+    public DDTrackingNotFoundException() {
+        super("Tracking session not found");
+    }
+}

apis/com.dbeaver.datadam.share.api/src/main/java/com/dbeaver/datadam/share/api/tracking/DDTrackingService.java

@@ -0,0 +1,32 @@
+/*
+ * DBeaver - Universal Database Manager
+ * Copyright (C) 2010-2026 DBeaver Corp
+ *
+ * All Rights Reserved.
+ *
+ * NOTICE:  All information contained herein is, and remains
+ * the property of DBeaver Corp and its suppliers, if any.
+ * The intellectual and technical concepts contained
+ * herein are proprietary to DBeaver Corp and its suppliers
+ * and may be covered by U.S. and Foreign Patents,
+ * patents in process, and are protected by trade secret or copyright law.
+ * Dissemination of this information or reproduction of this material
+ * is strictly forbidden unless prior written permission is obtained
+ * from DBeaver Corp.
+ */
+package com.dbeaver.datadam.share.api.tracking;
+
+import org.jkiss.code.NotNull;
+import org.jkiss.dbeaver.DBException;
+
+/**
+ * Client tracking operations.
+ */
+public interface DDTrackingService {
+
+    @NotNull
+    DDTracking start(@NotNull DDClientInfo client) throws DBException;
+
+    @NotNull
+    DDTracking stop(@NotNull String trackingId) throws DBException;
+}