initial commit

stbf-api/pom.xml

@@ -0,0 +1,30 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<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 https://maven.apache.org/xsd/maven-4.0.0.xsd">
+	<modelVersion>4.0.0</modelVersion>
+
+	<parent>
+		<groupId>ru.penkrat.stbf</groupId>
+		<artifactId>stbf-parent</artifactId>
+		<version>0.0.1-SNAPSHOT</version>
+  	</parent>
+
+	<artifactId>stbf-api</artifactId>
+	<name>stbf-api</name>
+	<description>Simple Telegram Bot Facade API Module</description>
+
+	<build>
+		<plugins>
+			<plugin>
+				<groupId>org.apache.maven.plugins</groupId>
+				<artifactId>maven-compiler-plugin</artifactId>
+				<configuration>
+					<source>${java.version}</source>
+					<target>${java.version}</target>
+				</configuration>
+			</plugin>
+		</plugins>
+	</build>
+
+</project>

stbf-api/src/main/java/ru/penkrat/stbf/api/Action.java

@@ -0,0 +1,57 @@
+package ru.penkrat.stbf.api;
+
+import lombok.Builder;
+import lombok.Getter;
+import lombok.NonNull;
+import lombok.ToString;
+
+@Getter
+@Builder
+@ToString(of = "text")
+public class Action {
+
+	public static Action simple(String text) {
+		return builder().text(text).build();
+	}
+
+	public static Action simple(String text, String cmd) {
+		validateCmd(cmd);
+		return builder().text(text).cmd(cmd).build();
+	}
+
+	public static Action callback(String text, String callbackData) {
+		return builder().inline(true).text(text).callbackData(callbackData).build();
+	}
+
+	public static Action requestContact(String text) {
+		return builder().text(text).requestContact(true).build();
+	}
+
+	private boolean inline;
+
+	private String text;
+
+	private String cmd;
+
+	// in-line
+	private String callbackData;
+	private String url;
+
+	// keyboard
+	private boolean requestContact;
+	private boolean requestLocation;
+
+	/**
+	 * Text of the command, 1-32 characters. Can contain only lowercase English
+	 * letters, digits and underscores.
+	 */
+	private static void validateCmd(@NonNull String cmd) {
+		if (cmd.length() > 32) {
+			throw new IllegalArgumentException("Max length - 32 characters");
+		}
+		if (!cmd.startsWith("/")) {
+			throw new IllegalArgumentException("Command must start / character");
+		}
+		// TODO validate lowercase etc
+	}
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/BotCommandChain.java

@@ -0,0 +1,39 @@
+package ru.penkrat.stbf.api;
+
+import java.util.ArrayList;
+import java.util.List;
+
+import lombok.AccessLevel;
+import lombok.RequiredArgsConstructor;
+import lombok.extern.slf4j.Slf4j;
+
+@Slf4j
+@RequiredArgsConstructor(access = AccessLevel.PRIVATE)
+public class BotCommandChain implements CommandChain {
+
+	private final List<Command> commands;
+
+	public BotCommandChain() {
+		this(new ArrayList<>());
+	}
+
+	@Override
+	public void processCommand(BotRequest botRequest, BotResponse botResponse) {
+		if (!commands.isEmpty()) {
+			try {
+				Command command = commands.get(0);
+				log.debug("Run command {}", command.getClass().getSimpleName());
+				command.process(botRequest, botResponse,
+						new BotCommandChain(commands.subList(1, commands.size())));
+			} catch (Exception e) {
+				log.error("Error in command:", e);
+			}
+		}
+	}
+
+	public BotCommandChain add(Command cmd) {
+		commands.add(cmd);
+		return this;
+	}
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/BotRequest.java

@@ -0,0 +1,17 @@
+package ru.penkrat.stbf.api;
+
+import java.util.Optional;
+
+public interface BotRequest {
+
+	Optional<String> getMessageText();
+
+	Optional<String> getPhoneNumber();
+
+	Optional<String> getCallbackData();
+	
+	Optional<String> getCallbackMessageText();
+
+	Long getChatId();
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/BotResponse.java

@@ -0,0 +1,15 @@
+package ru.penkrat.stbf.api;
+
+public interface BotResponse {
+
+	void send(Screen screen);
+
+	void sendFile(String filename, byte[] data);
+
+	void editMessage(String text);
+
+	void deleteMessage();
+
+	void edit(Screen screen);
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/Command.java

@@ -0,0 +1,7 @@
+package ru.penkrat.stbf.api;
+
+public interface Command {
+
+	void process(BotRequest botRequest, BotResponse botResponse, CommandChain chain);
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/CommandChain.java

@@ -0,0 +1,7 @@
+package ru.penkrat.stbf.api;
+
+public interface CommandChain {
+
+	void processCommand(BotRequest botRequest, BotResponse botResponse);
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/Keyboard.java

@@ -0,0 +1,5 @@
+package ru.penkrat.stbf.api;
+
+public interface Keyboard {
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/KeyboardBuilder.java

@@ -0,0 +1,33 @@
+package ru.penkrat.stbf.api;
+
+import java.util.ServiceLoader;
+
+public interface KeyboardBuilder {
+
+	ServiceLoader<KeyboardBuilder> keyboardBuilderLoader = ServiceLoader.load(KeyboardBuilder.class);
+
+	public static KeyboardBuilder newKeyboard() {
+		for (KeyboardBuilder kb : keyboardBuilderLoader) {
+			return kb.newInstance();
+		}
+		throw new IllegalStateException("No service KeyboardBuilder found");
+	}
+
+	KeyboardBuilder newInstance();
+
+	public static Keyboard singleKey(Action action) {
+		return newKeyboard().add(action).build();
+	}
+
+	default KeyboardBuilder add(String text, String callbackData) {
+		return add(Action.callback(text, callbackData));
+	}
+
+	KeyboardBuilder add(Action action);
+
+	KeyboardBuilder row(Action... buttons);
+
+	KeyboardBuilder column(Action... buttons);
+
+	Keyboard build();
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/RequestMatcher.java

@@ -0,0 +1,8 @@
+package ru.penkrat.stbf.api;
+
+@FunctionalInterface
+public interface RequestMatcher {
+
+	boolean match(BotRequest botRequest);
+
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/Screen.java

@@ -0,0 +1,14 @@
+package ru.penkrat.stbf.api;
+
+public interface Screen {
+
+	String getText();
+
+	default Keyboard getKeyboard() {
+		return null;
+	}
+
+	default ScreenProperties getScreenProperties() {
+		return ScreenProperties.DEFAULT;
+	}
+}

stbf-api/src/main/java/ru/penkrat/stbf/api/ScreenProperties.java

@@ -0,0 +1,23 @@
+package ru.penkrat.stbf.api;
+
+import lombok.Getter;
+import lombok.Setter;
+import lombok.experimental.Accessors;
+
+@Getter
+@Setter
+@Accessors(chain = true)
+public class ScreenProperties {
+
+	public static final ScreenProperties DEFAULT = new ScreenProperties()
+			.setDisableWebPagePreview(true)
+			.setDisableNotification(true)
+			.setParseModeHtml(true);
+
+	private boolean disableWebPagePreview;
+
+	private boolean disableNotification;
+
+	private boolean parseModeHtml;
+
+}

stbf-api/src/main/resources/META-INF/services/ru.penkrat.stbf.api.KeyboardBuilder

@@ -0,0 +1 @@
+ru.penkrat.stbf.impl.pengrad.PengradKeyboardBuilder