Emit events for all known types

api/src/main/kotlin/io/spine/protodata/AstExtensions.kt

@@ -49,32 +49,10 @@ import io.spine.protodata.CallCardinality.UNARY
  */
 public fun MessageType.qualifiedName(): String = name.qualifiedName()
 
-/**
- * Obtains the type URl of the type.
- *
- * A type URL contains the type URL prefix and the qualified name of the type separated by
- * the slash (`/`) symbol. See the docs of `google.protobuf.Any.type_url` for more info.
- *
- * @see MessageType.qualifiedName
- * @see TypeName.typeUrl
- */
-public fun MessageType.typeUrl(): String = name.typeUrl()
-
-/**
- * Obtains the type URl of the type.
- *
- * A type URL contains the type URL prefix and the qualified name of the type separated by
- * the slash (`/`) symbol. See the docs of `google.protobuf.Any.type_url` for more info.
- *
- * @see MessageType.qualifiedName
- * @see TypeName.typeUrl
- */
-public fun EnumType.typeUrl(): String = name.typeUrl()
-
 /**
  * Obtains the fully qualified name from this `TypeName`.
  */
-public fun TypeName.qualifiedName(): String {
+public fun TypeNameOrBuilder.qualifiedName(): String {
     val names = buildList<String> {
         add(packageName)
         addAll(nestingTypeNameList)
@@ -83,32 +61,6 @@ public fun TypeName.qualifiedName(): String {
     return names.filter { it.isNotEmpty() }.joinToString(separator = ".")
 }
 
-/**
- * Obtains the type URL from this `TypeName`.
- *
- * A type URL contains the type URL prefix and the qualified name of the type separated by
- * the slash (`/`) symbol. See the docs of `google.protobuf.Any.type_url` for more info.
- *
- * @see TypeName.qualifiedName
- * @see MessageType.typeUrl
- */
-public fun TypeName.typeUrl(): String = "${typeUrlPrefix}/${qualifiedName()}"
-
-/**
- * Obtains the type URl from this `ServiceName`.
- *
- * A type URL contains the type URL prefix and the qualified name of the type separated by
- * the slash (`/`) symbol. See the docs of `google.protobuf.Any.type_url` for more info.
- */
-public fun ServiceName.typeUrl(): String = "$typeUrlPrefix/$packageName.$simpleName"
-
-/**
- * Obtains the type URl of this service.
- *
- * @see ServiceName.typeUrl
- */
-public fun Service.typeUrl(): String = name.typeUrl()
-
 /**
  * Shows if this field is a `map`.
  *
@@ -195,12 +147,12 @@ private val FileDescriptor.typeUrlPrefix: String
 /**
  * Obtains the name of this `oneof` as a [OneofName].
  */
-internal fun OneofDescriptor.name(): OneofName = oneofName { value = name }
+public fun OneofDescriptor.name(): OneofName = oneofName { value = name }
 
 /**
  * Obtains the name of this field as a [FieldName].
  */
-internal fun FieldDescriptor.name(): FieldName = fieldName { value = name }
+public fun FieldDescriptor.name(): FieldName = fieldName { value = name }
 
 /**
  * Obtains the relative path to this file as a [FilePath].
@@ -219,7 +171,7 @@ public fun ServiceDescriptor.name(): ServiceName = serviceName {
 /**
  * Obtains the name of this RPC method as an [RpcName].
  */
-internal fun MethodDescriptor.name(): RpcName = rpcName { value = name }
+public fun MethodDescriptor.name(): RpcName = rpcName { value = name }
 
 /**
  * Obtains a [Type] wrapping this `PrimitiveType`.

api/src/main/kotlin/io/spine/protodata/ProtoDeclaration.kt

@@ -0,0 +1,53 @@
+/*
+ * Copyright 2023, TeamDev. All rights reserved.
+ *
+ * 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
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package io.spine.protodata
+
+import com.google.protobuf.Message
+import io.spine.annotation.GeneratedMixin
+import io.spine.annotation.Internal
+
+/**
+ * A high-level Protobuf declaration, such as a message, an enum, or a service.
+ */
+@Internal
+@GeneratedMixin
+public interface ProtoDeclaration : Message {
+
+    /**
+     * Obtains the name of this Protobuf declaration.
+     */
+    public val name: ProtoDeclarationName
+
+    /**
+     * Obtains the type URl of the type.
+     *
+     * A type URL contains the type URL prefix and the qualified name of the type separated by
+     * the slash (`/`) symbol. See the docs of `google.protobuf.Any.type_url` for more info.
+     */
+    public fun typeUrl(): String? {
+        return name.typeUrl()
+    }
+}

api/src/main/kotlin/io/spine/protodata/ProtoDeclarationName.kt

@@ -0,0 +1,46 @@
+/*
+ * Copyright 2023, TeamDev. All rights reserved.
+ *
+ * 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
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package io.spine.protodata
+
+import com.google.protobuf.Message
+import io.spine.annotation.GeneratedMixin
+import io.spine.annotation.Internal
+
+/**
+ * Name of a high-level Protobuf declaration.
+ */
+@Internal
+@GeneratedMixin
+public interface ProtoDeclarationName : Message {
+
+    /**
+     * Prints this name as a type URL.
+     *
+     * A type URL contains the type URL prefix and the qualified name of the type separated by
+     * the slash (`/`) symbol. See the docs of `google.protobuf.Any.type_url` for more info.
+     */
+    public fun typeUrl(): String
+}

api/src/main/kotlin/io/spine/protodata/ServiceNameMixin.kt

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2023, TeamDev. All rights reserved.
+ *
+ * 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
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package io.spine.protodata
+
+import io.spine.annotation.GeneratedMixin
+import io.spine.annotation.Internal
+
+/**
+ * Name of a service declared in Protobuf.
+ */
+@Internal
+@GeneratedMixin
+public interface ServiceNameMixin : ProtoDeclarationName, ServiceNameOrBuilder {
+
+    override fun typeUrl(): String {
+        return "$typeUrlPrefix/$packageName.$simpleName"
+    }
+}

api/src/main/kotlin/io/spine/protodata/TypeNameMixin.kt

@@ -0,0 +1,41 @@
+/*
+ * Copyright 2023, TeamDev. All rights reserved.
+ *
+ * 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
+ *
+ * http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Redistribution and use in source and/or binary forms, with or without
+ * modification, must retain the above copyright notice and the following
+ * disclaimer.
+ *
+ * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+ * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+ * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
+ * A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
+ * OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
+ * SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
+ * LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
+ * DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
+ * THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
+ * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
+ * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
+ */
+package io.spine.protodata
+
+import io.spine.annotation.GeneratedMixin
+import io.spine.annotation.Internal
+
+/**
+ * Name of a message or enum type.
+ */
+@Internal
+@GeneratedMixin
+public interface TypeNameMixin : ProtoDeclarationName, TypeNameOrBuilder {
+
+    override fun typeUrl(): String {
+        return "$typeUrlPrefix/${qualifiedName()}"
+    }
+}

api/src/main/kotlin/io/spine/protodata/plugin/Plugin.kt

@@ -68,7 +68,7 @@ public interface Plugin {
  */
 public fun BoundedContextBuilder.apply(plugin: Plugin) {
     val repos = plugin.viewRepositories().toMutableList()
-    val defaultRepos = plugin.views().map { io.spine.protodata.plugin.ViewRepository.default(it) }
+    val defaultRepos = plugin.views().map { ViewRepository.default(it) }
     repos.addAll(defaultRepos)
     val repeatedView = repos.map { it.entityClass() }
                             .groupingBy { it }

api/src/main/proto/spine/protodata/ast.proto

@@ -81,6 +81,7 @@ message File {
 // Applicable to message and enum types.
 //
 message TypeName {
+    option (is).java_type = "TypeNameMixin";
 
     // The short name of the type.
     string simple_name = 1;
@@ -115,6 +116,7 @@ message TypeName {
 
 // A Protobuf message type.
 message MessageType {
+    option (is).java_type = "ProtoDeclaration";
 
     TypeName name = 1;
 
@@ -159,6 +161,7 @@ message MessageType {
 
 // A Protobuf enum type.
 message EnumType {
+    option (is).java_type = "ProtoDeclaration";
 
     TypeName name = 1;
 
@@ -372,6 +375,7 @@ message OneofGroup {
 
 // A name of a Protobuf service type.
 message ServiceName {
+    option (is).java_type = "ServiceNameMixin";
 
     // The short name of the service type.
     string simple_name = 1;
@@ -391,6 +395,7 @@ message ServiceName {
 
 // A Protobuf service type.
 message Service {
+    option (is).java_type = "ProtoDeclaration";
 
     ServiceName name = 1;
 
@@ -405,6 +410,9 @@ message Service {
 
     // Documentation of this service.
     Doc doc = 4;
+
+    // Path to the file which declares this service.
+    FilePath file = 5;
 }
 
 // A name of an RPC method.

api/src/main/proto/spine/protodata/events.proto

@@ -36,6 +36,7 @@ option java_outer_classname = "EventsProto";
 option java_multiple_files = true;
 
 import "spine/protodata/ast.proto";
+import "spine/protodata/source.proto";
 
 // Emitted when processing of a file begins.
 message FileEntered {
@@ -264,3 +265,23 @@ message RpcExited {
 
     RpcName rpc = 3;
 }
+
+// Emitted when the Protobuf compiler discovers a dependency file.
+//
+// The order of files reported by events of this type is unspecified. Users should not rely on any
+// particular order.
+//
+// Each file is only reported by one event, even if the file is imported into
+//
+// `DependencyDiscovered` events always precede all other Protobuf compiler events, i.e.
+// the first `FileEntered` will always be emitted after the last `DependencyDiscovered`.
+//
+// Normally, no code should be generated for dependencies. However, they can be used for additional
+// info when generating code for the module's own types.
+//
+message DependencyDiscovered {
+
+    FilePath path = 1;
+
+    ProtobufSourceFile file = 2;
+}