forgeos 0.1.0-alpha.3 → 0.1.0-alpha.30

package/adapters/java/src/main/java/dev/forgeos/adapter/EntryKind.java

@@ -0,0 +1,16 @@
+package dev.forgeos.adapter;
+
+public enum EntryKind {
+  COMMAND("command"),
+  QUERY("query");
+
+  private final String value;
+
+  EntryKind(String value) {
+    this.value = value;
+  }
+
+  public String value() {
+    return value;
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ErrorInfo.java

@@ -0,0 +1,4 @@
+package dev.forgeos.adapter;
+
+public record ErrorInfo(String code, String message) {
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Forge.java

@@ -0,0 +1,94 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import java.util.Arrays;
+import java.util.List;
+
+public final class Forge {
+  private Forge() {
+  }
+
+  public static ForgeRegistry service(String serviceName, ForgeRegistry.RegistryOption... options) {
+    return new ForgeRegistry(serviceName, options);
+  }
+
+  public static ForgeRegistry.RegistryOption framework(String value) {
+    return registry -> registry.setFramework(value);
+  }
+
+  public static ForgeRegistry.RegistryOption baseUrl(String value) {
+    return registry -> registry.setBaseUrl(value);
+  }
+
+  public static ForgeRegistry.RegistryOption health(String path) {
+    return registry -> registry.setHealth(path);
+  }
+
+  public static ForgeRegistry.RegistryOption schemaRef(String name, Object schema) {
+    return registry -> registry.addSchema(name, schema);
+  }
+
+  public static ForgeRegistry.EntryOption description(String value) {
+    return entry -> entry.description = value;
+  }
+
+  public static ForgeRegistry.EntryOption path(String value) {
+    return entry -> entry.path = value;
+  }
+
+  public static ForgeRegistry.EntryOption method(String value) {
+    return entry -> entry.method = value;
+  }
+
+  public static ForgeRegistry.EntryOption inputSchema(Object schema) {
+    return entry -> entry.inputSchema = schema;
+  }
+
+  public static ForgeRegistry.EntryOption outputSchema(Object schema) {
+    return entry -> entry.outputSchema = schema;
+  }
+
+  public static ForgeRegistry.EntryOption policy(String value) {
+    return entry -> entry.policy = value;
+  }
+
+  public static ForgeRegistry.EntryOption tenantScoped(boolean value) {
+    return entry -> entry.tenantScoped = value;
+  }
+
+  public static ForgeRegistry.EntryOption transaction(TransactionMode value) {
+    return entry -> entry.transaction = value.value();
+  }
+
+  public static ForgeRegistry.EntryOption risk(Risk value) {
+    return entry -> entry.risk = value.value();
+  }
+
+  public static ForgeRegistry.EntryOption needsApproval(boolean value) {
+    return entry -> entry.needsApproval = value;
+  }
+
+  public static ForgeRegistry.EntryOption effects(String... values) {
+    return entry -> entry.effects = List.copyOf(Arrays.asList(values));
+  }
+
+  public static ForgeRegistry.EntryOption readOnly() {
+    return entry -> {
+      entry.transaction = TransactionMode.READ_ONLY.value();
+      entry.risk = Risk.READ.value();
+    };
+  }
+
+  public static <In, Out> ForgeHandler handle(
+      Class<In> inputClass,
+      TypedForgeHandler<In, Out> handler
+  ) {
+    return (context, rawArgs) -> {
+      JsonNode args = rawArgs == null || rawArgs.isNull()
+          ? Json.MAPPER.createObjectNode()
+          : rawArgs;
+      In input = Json.MAPPER.treeToValue(args, inputClass);
+      return handler.handle(context, input);
+    };
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeCall.java

@@ -0,0 +1,12 @@
+package dev.forgeos.adapter;
+
+public record ForgeCall(String service, String entry, String kind, String traceId) {
+  public ForgeCall withDefaults(String serviceName, String entryName, String entryKind, String fallbackTraceId) {
+    return new ForgeCall(
+        service == null || service.isBlank() ? serviceName : service,
+        entry == null || entry.isBlank() ? entryName : entry,
+        kind == null || kind.isBlank() ? entryKind : kind,
+        traceId == null || traceId.isBlank() ? fallbackTraceId : traceId
+    );
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeContext.java

@@ -0,0 +1,11 @@
+package dev.forgeos.adapter;
+
+import java.util.List;
+import java.util.Map;
+
+public record ForgeContext(
+    Auth auth,
+    ForgeCall forge,
+    Map<String, List<String>> headers
+) {
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHandler.java

@@ -0,0 +1,8 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.databind.JsonNode;
+
+@FunctionalInterface
+public interface ForgeHandler {
+  Object handle(ForgeContext context, JsonNode args) throws Exception;
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeHttpHandler.java

@@ -0,0 +1,179 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.databind.JsonNode;
+import com.sun.net.httpserver.Headers;
+import com.sun.net.httpserver.HttpExchange;
+import com.sun.net.httpserver.HttpHandler;
+import com.sun.net.httpserver.HttpServer;
+import java.io.IOException;
+import java.io.InputStream;
+import java.io.OutputStream;
+import java.net.InetSocketAddress;
+import java.net.URI;
+import java.net.URLDecoder;
+import java.nio.charset.StandardCharsets;
+import java.util.HashMap;
+import java.util.List;
+import java.util.Map;
+
+public final class ForgeHttpHandler implements HttpHandler {
+  private final ForgeRegistry registry;
+
+  public ForgeHttpHandler(ForgeRegistry registry) {
+    this.registry = registry;
+  }
+
+  public static HttpServer listen(ForgeRegistry registry, String host, int port) throws IOException {
+    HttpServer server = HttpServer.create(new InetSocketAddress(host, port), 0);
+    ForgeHttpHandler handler = new ForgeHttpHandler(registry);
+    server.createContext("/", handler);
+    server.start();
+    return server;
+  }
+
+  @Override
+  public void handle(HttpExchange exchange) throws IOException {
+    String path = exchange.getRequestURI().getPath();
+    try {
+      if (registry.healthPath().equals(path)) {
+        writeJson(exchange, 200, Map.of("ok", true, "service", registry.serviceName()));
+        return;
+      }
+      if ("/manifest".equals(path)) {
+        String baseUrl = queryParams(exchange.getRequestURI()).getOrDefault("baseUrl", registry.baseUrl());
+        writeJson(exchange, 200, registry.manifest(baseUrl));
+        return;
+      }
+      if (path.startsWith("/commands/")) {
+        handleRuntime(exchange, EntryKind.COMMAND, path.substring("/commands/".length()));
+        return;
+      }
+      if (path.startsWith("/queries/")) {
+        handleRuntime(exchange, EntryKind.QUERY, path.substring("/queries/".length()));
+        return;
+      }
+      writeError(exchange, 404, traceIdFrom(exchange, null), "FORGE_JAVA_ROUTE_NOT_FOUND", "route not found");
+    } catch (Exception error) {
+      writeError(exchange, 500, traceIdFrom(exchange, null), "FORGE_JAVA_HANDLER_FAILED", error.getMessage());
+    }
+  }
+
+  private void handleRuntime(HttpExchange exchange, EntryKind kind, String rawName) throws IOException {
+    String name = decode(rawName);
+    if (!"POST".equals(exchange.getRequestMethod()) && !"GET".equals(exchange.getRequestMethod())) {
+      writeError(exchange, 405, traceIdFrom(exchange, null), "FORGE_JAVA_METHOD_NOT_ALLOWED", "external entry only accepts GET or POST");
+      return;
+    }
+
+    ForgeRegistry.RegisteredEntry registered = registry.lookup(kind, name);
+    if (registered == null) {
+      writeError(exchange, 404, traceIdFrom(exchange, null), "FORGE_JAVA_ENTRY_NOT_FOUND", "external entry not found");
+      return;
+    }
+
+    RequestEnvelope envelope;
+    try {
+      envelope = readEnvelope(exchange);
+    } catch (Exception error) {
+      writeError(exchange, 400, traceIdFrom(exchange, null), "FORGE_JAVA_BAD_REQUEST", error.getMessage());
+      return;
+    }
+
+    String traceId = traceIdFrom(exchange, envelope);
+    ForgeCall forge = envelope.forge() == null
+        ? new ForgeCall(registry.serviceName(), name, kind.value(), traceId)
+        : envelope.forge().withDefaults(registry.serviceName(), name, kind.value(), traceId);
+    Auth auth = envelope.auth() == null || envelope.auth().kind() == null
+        ? authFromHeaders(exchange.getRequestHeaders())
+        : envelope.auth();
+
+    ForgeContext context = new ForgeContext(auth, forge, exchange.getRequestHeaders());
+    try {
+      Object result = registered.handler().handle(context, envelope.args());
+      writeJson(exchange, 200, ResponseEnvelope.ok(result, forge.traceId()));
+    } catch (Exception error) {
+      writeError(exchange, 500, forge.traceId(), "FORGE_JAVA_HANDLER_FAILED", error.getMessage());
+    }
+  }
+
+  private RequestEnvelope readEnvelope(HttpExchange exchange) throws IOException {
+    if ("GET".equals(exchange.getRequestMethod())) {
+      String args = queryParams(exchange.getRequestURI()).getOrDefault("args", "{}");
+      JsonNode argsNode = Json.MAPPER.readTree(args);
+      return new RequestEnvelope(argsNode, null, null);
+    }
+
+    try (InputStream body = exchange.getRequestBody()) {
+      byte[] bytes = body.readAllBytes();
+      if (bytes.length == 0) {
+        return new RequestEnvelope(Json.MAPPER.createObjectNode(), null, null);
+      }
+      RequestEnvelope envelope = Json.MAPPER.readValue(bytes, RequestEnvelope.class);
+      JsonNode args = envelope.args() == null ? Json.MAPPER.createObjectNode() : envelope.args();
+      return new RequestEnvelope(args, envelope.auth(), envelope.forge());
+    }
+  }
+
+  private static Auth authFromHeaders(Headers headers) {
+    String kind = firstHeader(headers, "x-forge-auth-kind");
+    if (kind == null || kind.isBlank()) {
+      kind = "anonymous";
+    }
+    return new Auth(
+        kind,
+        firstHeader(headers, "x-forge-user-id"),
+        firstHeader(headers, "x-forge-tenant-id"),
+        firstHeader(headers, "x-forge-role"),
+        null,
+        null,
+        null,
+        null,
+        null
+    );
+  }
+
+  private static String traceIdFrom(HttpExchange exchange, RequestEnvelope envelope) {
+    if (envelope != null && envelope.forge() != null && envelope.forge().traceId() != null) {
+      return envelope.forge().traceId();
+    }
+    return firstHeader(exchange.getRequestHeaders(), "x-forge-trace-id");
+  }
+
+  private static String firstHeader(Headers headers, String name) {
+    List<String> values = headers.get(name);
+    if (values == null || values.isEmpty()) {
+      values = headers.get(name.toLowerCase());
+    }
+    return values == null || values.isEmpty() ? null : values.get(0);
+  }
+
+  private static Map<String, String> queryParams(URI uri) {
+    Map<String, String> params = new HashMap<>();
+    String query = uri.getRawQuery();
+    if (query == null || query.isBlank()) {
+      return params;
+    }
+    for (String part : query.split("&")) {
+      String[] pieces = part.split("=", 2);
+      params.put(decode(pieces[0]), pieces.length > 1 ? decode(pieces[1]) : "");
+    }
+    return params;
+  }
+
+  private static String decode(String value) {
+    return URLDecoder.decode(value, StandardCharsets.UTF_8);
+  }
+
+  private static void writeError(HttpExchange exchange, int status, String traceId, String code, String message) throws IOException {
+    writeJson(exchange, status, ResponseEnvelope.error(code, message, traceId));
+  }
+
+  private static void writeJson(HttpExchange exchange, int status, Object body) throws IOException {
+    byte[] bytes = Json.MAPPER.writeValueAsBytes(body);
+    exchange.getResponseHeaders().set("content-type", "application/json");
+    exchange.sendResponseHeaders(status, bytes.length);
+    try (OutputStream response = exchange.getResponseBody()) {
+      response.write(bytes);
+    }
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ForgeRegistry.java

@@ -0,0 +1,121 @@
+package dev.forgeos.adapter;
+
+import java.io.IOException;
+import java.io.OutputStream;
+import java.util.ArrayList;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public final class ForgeRegistry {
+  private final Service service;
+  private final Map<String, Object> schemas = new LinkedHashMap<>();
+  private final List<RegisteredEntry> entries = new ArrayList<>();
+  private final Map<String, RegisteredEntry> lookup = new LinkedHashMap<>();
+  private String framework = "java/jdk-http";
+
+  public ForgeRegistry(String serviceName, RegistryOption... options) {
+    this.service = new Service(serviceName, "http", null, null, "/health");
+    for (RegistryOption option : options) {
+      option.apply(this);
+    }
+  }
+
+  public String serviceName() {
+    return service.name();
+  }
+
+  public String baseUrl() {
+    return service.baseUrl();
+  }
+
+  public String healthPath() {
+    return service.health() == null ? "/health" : service.health();
+  }
+
+  public void command(String name, ForgeHandler handler, EntryOption... options) {
+    Entry entry = new Entry();
+    entry.name = name;
+    entry.kind = EntryKind.COMMAND.value();
+    entry.path = "/commands/" + name;
+    entry.method = "POST";
+    entry.transaction = TransactionMode.EXTERNAL_MANAGED.value();
+    entry.risk = Risk.WRITE.value();
+    add(entry, handler, options);
+  }
+
+  public void query(String name, ForgeHandler handler, EntryOption... options) {
+    Entry entry = new Entry();
+    entry.name = name;
+    entry.kind = EntryKind.QUERY.value();
+    entry.path = "/queries/" + name;
+    entry.method = "POST";
+    entry.transaction = TransactionMode.READ_ONLY.value();
+    entry.risk = Risk.READ.value();
+    add(entry, handler, options);
+  }
+
+  public Manifest manifest(String baseUrl) {
+    Service manifestService = service;
+    if (baseUrl != null && !baseUrl.isBlank()) {
+      manifestService = new Service(service.name(), service.transport(), baseUrl, service.command(), service.health());
+    }
+    List<Entry> manifestEntries = entries.stream().map(registered -> registered.entry().copy()).toList();
+    return new Manifest("1.0", "java", framework, manifestService, manifestEntries, schemas.isEmpty() ? null : schemas);
+  }
+
+  public byte[] marshalManifest(String baseUrl) throws IOException {
+    return Json.MAPPER.writerWithDefaultPrettyPrinter().writeValueAsBytes(manifest(baseUrl));
+  }
+
+  public void writeManifest(OutputStream output, String baseUrl) throws IOException {
+    output.write(marshalManifest(baseUrl));
+    output.write('\n');
+  }
+
+  RegisteredEntry lookup(EntryKind kind, String name) {
+    return lookup.get(key(kind, name));
+  }
+
+  void setFramework(String framework) {
+    this.framework = framework;
+  }
+
+  void setBaseUrl(String baseUrl) {
+    this.service.setBaseUrl(baseUrl);
+  }
+
+  void setHealth(String health) {
+    this.service.setHealth(health);
+  }
+
+  void addSchema(String name, Object schema) {
+    this.schemas.put(name, schema);
+  }
+
+  private void add(Entry entry, ForgeHandler handler, EntryOption... options) {
+    for (EntryOption option : options) {
+      option.apply(entry);
+    }
+    RegisteredEntry registered = new RegisteredEntry(entry, handler);
+    entries.add(registered);
+    lookup.put(key(EntryKind.valueOf(entry.kind.toUpperCase()), entry.name), registered);
+  }
+
+  private static String key(EntryKind kind, String name) {
+    return kind.value() + ":" + name;
+  }
+
+  @FunctionalInterface
+  public interface RegistryOption {
+    void apply(ForgeRegistry registry);
+  }
+
+  @FunctionalInterface
+  public interface EntryOption {
+    void apply(Entry entry);
+  }
+
+  record RegisteredEntry(Entry entry, ForgeHandler handler) {
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Json.java

@@ -0,0 +1,14 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.annotation.JsonInclude;
+import com.fasterxml.jackson.databind.DeserializationFeature;
+import com.fasterxml.jackson.databind.ObjectMapper;
+
+public final class Json {
+  public static final ObjectMapper MAPPER = new ObjectMapper()
+      .setSerializationInclusion(JsonInclude.Include.NON_NULL)
+      .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
+
+  private Json() {
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Manifest.java

@@ -0,0 +1,14 @@
+package dev.forgeos.adapter;
+
+import java.util.List;
+import java.util.Map;
+
+public record Manifest(
+    String forgeProtocol,
+    String language,
+    String framework,
+    Service service,
+    List<Entry> entries,
+    Map<String, Object> schemas
+) {
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/RequestEnvelope.java

@@ -0,0 +1,6 @@
+package dev.forgeos.adapter;
+
+import com.fasterxml.jackson.databind.JsonNode;
+
+public record RequestEnvelope(JsonNode args, Auth auth, ForgeCall forge) {
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/ResponseEnvelope.java

@@ -0,0 +1,25 @@
+package dev.forgeos.adapter;
+
+import java.util.List;
+
+public record ResponseEnvelope(
+    boolean ok,
+    Object result,
+    List<Diagnostic> diagnostics,
+    ErrorInfo error,
+    String traceId
+) {
+  public static ResponseEnvelope ok(Object result, String traceId) {
+    return new ResponseEnvelope(true, result, null, null, traceId);
+  }
+
+  public static ResponseEnvelope error(String code, String message, String traceId) {
+    return new ResponseEnvelope(
+        false,
+        null,
+        List.of(Diagnostic.error(code, message == null || message.isBlank() ? code : message)),
+        new ErrorInfo(code, message == null || message.isBlank() ? code : message),
+        traceId
+    );
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Risk.java

@@ -0,0 +1,18 @@
+package dev.forgeos.adapter;
+
+public enum Risk {
+  READ("read"),
+  WRITE("write"),
+  DESTRUCTIVE("destructive"),
+  EXTERNAL("external");
+
+  private final String value;
+
+  Risk(String value) {
+    this.value = value;
+  }
+
+  public String value() {
+    return value;
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Schemas.java

@@ -0,0 +1,36 @@
+package dev.forgeos.adapter;
+
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+
+public final class Schemas {
+  private Schemas() {
+  }
+
+  public static Map<String, Object> object(Map<String, Object> properties, String... required) {
+    Map<String, Object> schema = new LinkedHashMap<>();
+    schema.put("type", "object");
+    schema.put("properties", properties);
+    if (required.length > 0) {
+      schema.put("required", List.of(required));
+    }
+    return schema;
+  }
+
+  public static Map<String, Object> string() {
+    return Map.of("type", "string");
+  }
+
+  public static Map<String, Object> bool() {
+    return Map.of("type", "boolean");
+  }
+
+  public static Map<String, Object> number() {
+    return Map.of("type", "number");
+  }
+
+  public static Map<String, Object> array(Object items) {
+    return Map.of("type", "array", "items", items);
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/Service.java

@@ -0,0 +1,65 @@
+package dev.forgeos.adapter;
+
+public final class Service {
+  private final String name;
+  private final String transport;
+  private String baseUrl;
+  private String command;
+  private String health;
+
+  public Service(String name, String transport, String baseUrl, String command, String health) {
+    this.name = name;
+    this.transport = transport;
+    this.baseUrl = baseUrl;
+    this.command = command;
+    this.health = health;
+  }
+
+  public String name() {
+    return name;
+  }
+
+  public String getName() {
+    return name;
+  }
+
+  public String transport() {
+    return transport;
+  }
+
+  public String getTransport() {
+    return transport;
+  }
+
+  public String baseUrl() {
+    return baseUrl;
+  }
+
+  public String getBaseUrl() {
+    return baseUrl;
+  }
+
+  public String command() {
+    return command;
+  }
+
+  public String getCommand() {
+    return command;
+  }
+
+  public String health() {
+    return health;
+  }
+
+  public String getHealth() {
+    return health;
+  }
+
+  void setBaseUrl(String baseUrl) {
+    this.baseUrl = baseUrl;
+  }
+
+  void setHealth(String health) {
+    this.health = health;
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/TransactionMode.java

@@ -0,0 +1,18 @@
+package dev.forgeos.adapter;
+
+public enum TransactionMode {
+  READ_ONLY("read-only"),
+  EXTERNAL_MANAGED("external-managed"),
+  FORGE_MANAGED("forge-managed"),
+  SAGA("saga");
+
+  private final String value;
+
+  TransactionMode(String value) {
+    this.value = value;
+  }
+
+  public String value() {
+    return value;
+  }
+}

package/adapters/java/src/main/java/dev/forgeos/adapter/TypedForgeHandler.java

@@ -0,0 +1,6 @@
+package dev.forgeos.adapter;
+
+@FunctionalInterface
+public interface TypedForgeHandler<In, Out> {
+  Out handle(ForgeContext context, In input) throws Exception;
+}